Skip to content

Update dependencies, security overrides, and documentation site - #114

Merged
x42en merged 4 commits into
mainfrom
develop
Nov 4, 2026
Merged

x42en merged 4 commits into
mainfrom
develop

Conversation

@x42en

@x42en x42en commented Nov 4, 2026

Copy link
Copy Markdown
Owner

This pull request introduces IOServer version 2.3.0, focusing on modernizing the tech stack, tightening security and dependency management, and formalizing development standards. The most significant updates include raising the minimum Node.js and TypeScript versions, updating major dependencies, adding a comprehensive technical standards document (AGENTS.md), and improving documentation and contribution guidelines.

Platform and Dependency Updates:

  • Node.js and TypeScript: The minimum Node.js version is now 22, and TypeScript is updated to 6.0+. The build now uses module/moduleResolution: node16 and enables isolatedModules for stricter type safety. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L10-R43), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055L27-R29), [[3]](https://github.com/x42en/IOServer/pull/114/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L69-R70), [[4]](https://github.com/x42en/IOServer/pull/114/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L6-R6))
  • Dependency Upgrades: Major dependencies are updated, including Fastify 5.12.8, Socket.IO 4.8.4, Jest 30.5.2, ESLint 10.14.0, TypeDoc 0.28.20, and Prettier 3.9.10. Documentation site dependencies are also modernized. ([CHANGELOG.mdR10-R47](https://github.com/x42en/IOServer/pull/114/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edR10-R47))

Security and Dependency Management:

  • Advisory Handling: All high and moderate advisories are resolved or overridden with explicit documentation. Only one low-severity advisory remains, with its risk and removal condition documented. ESM-only dependencies are handled to maintain CommonJS compatibility. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edR10-R47), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L104-R189), [[3]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9R277-R279))
  • Security Standards: AGENTS.md enforces security by design, least privilege, and strict secrets handling. Security overrides and dependency pinning are now documented and required for exceptions. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L1-R33), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L104-R189))

Development Standards and Documentation:

  • Technical Standards Document: Introduces AGENTS.md, detailing offensive development doctrine, component separation, dependency policies, and testing requirements, aligning with the broader auth-service/auth-ai contract. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L1-R33), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9R55-R86), [[3]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L104-R189))
  • Contribution and Workflow Improvements: Updates to CONTRIBUTING.md clarify the use of the develop branch, update prerequisites, standardize commands, and reinforce code style and review requirements. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055L27-R29), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055L191-R199), [[3]](https://github.com/x42en/IOServer/pull/114/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055R155-R161))
  • Documentation Updates: The README.md and other docs now reflect updated requirements, dependency versions, and improved code formatting for clarity. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L69-R70), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L89-R105))

Changelog and Versioning:

  • Changelog Entries: CHANGELOG.md documents all major, minor, and security changes for 2.3.0, including explicit links for version diffs and historical context. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edR10-R47), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edL96-R135))

Project Structure and Tooling:

  • Project Structure: Documentation clarifies the purpose of each directory and config file, including new ESLint and Prettier configurations, and separate documentation site tooling. ([AGENTS.mdL172-R264](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L172-R264))

Platform and Dependency Modernization:

  • Node.js minimum version raised to 22; TypeScript updated to 6.0+ with stricter build settings and CommonJS output. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L10-R43), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055L27-R29), [[3]](https://github.com/x42en/IOServer/pull/114/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L69-R70), [[4]](https://github.com/x42en/IOServer/pull/114/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L6-R6))
  • Major dependency upgrades across Fastify, Socket.IO, Jest, ESLint, TypeDoc, Prettier, and documentation site stack. ([CHANGELOG.mdR10-R47](https://github.com/x42en/IOServer/pull/114/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edR10-R47))

Security and Dependency Management:

  • All high/moderate dependency advisories resolved or explicitly overridden; ESM-only dependencies handled to maintain CJS/Jest compatibility. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edR10-R47), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L104-R189), [[3]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9R277-R279))
  • Security by design and dependency override/documentation requirements formalized in AGENTS.md. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L1-R33), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L104-R189))

Development Standards and Documentation:

  • Adds AGENTS.md defining technical standards, component separation, dependency, and testing policies. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L1-R33), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9R55-R86), [[3]](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L104-R189))
  • Updates CONTRIBUTING.md for new branch workflow, prerequisites, commands, and code style enforcement. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055L27-R29), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055L191-R199), [[3]](https://github.com/x42en/IOServer/pull/114/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055R155-R161))
  • Improves documentation and code samples for clarity and consistency. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L69-R70), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L89-R105))

Changelog and Versioning:

  • CHANGELOG.md updated for 2.3.0 with detailed change and security notes; version diff links added. ([[1]](https://github.com/x42en/IOServer/pull/114/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edR10-R47), [[2]](https://github.com/x42en/IOServer/pull/114/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edL96-R135))

Project Structure and Tooling:

  • Documentation and config files updated for new ESLint/Prettier setup and documentation site tooling. ([AGENTS.mdL172-R264](https://github.com/x42en/IOServer/pull/114/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9L172-R264))

x42en added 4 commits November 4, 2026 21:28
- Node.js >= 22, TypeScript 6.0.3, module/moduleResolution node16 with
  isolatedModules, and explicit Jest globals for ts-jest.
- Fastify 5.12.8, @fastify/static 10.1.10, Socket.IO 4.8.4, Jest 30.5.2,
  ts-jest 29.4.15, ESLint 10.14.0, @typescript-eslint 8.72.1, TypeDoc 0.28.20.
- pnpm security overrides clear every high and moderate advisory; the
  content-disposition 3.x ESM-only dependency is pinned to the CommonJS 2.0.1
  release so the CJS build and Jest path keep working.
- Prettier scripts and formatting for src, tests, root config and Markdown.
- Documentation site moved to Docus 5.15, Nuxt 4.6.4 and better-sqlite3
  12.11.1, with npm overrides and an origin-only site URL.
- AGENTS.md gains the Offensive Development Doctrine, evidence rules,
  dependency policy and the Node 22 / TypeScript 6 contract.
Override markdown-it to 14.3.3 to clear the quadratic-time rendering advisory reachable from TypeDoc, and document the remaining low advisories. Docus 5.15 requires an origin-only site URL, so the docs image defaults now match nuxt.config.ts and the deploy workflow.
Node.js 22 and TypeScript 6 are the supported baseline, the Fastify plugin majors are current, and contribution gates and pull-request target match AGENTS.md.
Raise the package, runtime VERSION constant, documentation headers and example health payloads to 2.3.0, and promote the dependency and security work to the 2.3.0 changelog entry.
@x42en x42en self-assigned this Nov 4, 2026
@x42en
x42en merged commit 60d4151 into main Nov 4, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant