Convert scripts to TypeScript, add @types/node

- Renamed `scripts/check-readme-version.mjs` to `.ts` and added TypeScript type annotation
- Updated `check:version-sync` npm script to use `node --experimental-strip-types` with the new `.ts` file
- Added `@types/node ^26.0.1` as a devDependency for proper Node.js type checking
- Updated AGENTS.md to document that all scripts must be TypeScript
- Updated dev dependencies (eslint, typescript-eslint, prettier, and others)

Author: bradpotts

AGENTS.md

@@ -45,6 +45,29 @@ is release-relevant.
 
 ---
 
+## Upstream Requests and Roadmap Self-Expansion
+
+Full directive: project-team [AGENTS.md](../AGENTS.md) "Upstream Requests and
+Roadmap Self-Expansion." Applied to this repo:
+
+- This repo is an independent peer package — it has no upstream dependency
+  within this workspace; do not invent one.
+- Downstream repos `spectre-shell` (composes this router) and `spectre-init`
+  (scaffolds against it) may append routing-contract requests (e.g. a new
+  `subscribe()` event, navigation helper, or `Route`/`Router` type) to this
+  repo's own `TODO.md` under `## Requested by Downstream`, dated and linked
+  back to the requesting repo's TODO.md/ROADMAP.md. Keep that section visible
+  and separate from self-planned routing work.
+- This repo's own [ROADMAP.md](ROADMAP.md) may be proactively expanded with new
+  or reordered phases by the agent's own analysis — but never mark a phase
+  delivered without `npm run check` passing, and never contradict the
+  deliberate app-layer router/signals separation documented in
+  `project-shell/CLAUDE.md` (router does not import
+  `spectre-shell-signals`, and vice versa).
+- Surface any new TODO request or roadmap expansion in the handoff for Bradley
+  Potts in the same change it was made, and reflect cross-repo-relevant
+  changes in the project-team's own ROADMAP.md/TODO.md.
+
 ## Shared Source Rules
 
 These rules apply to every agent without exception.
@@ -199,6 +222,8 @@ for Spectre applications. It maps URL paths to lazy page modules and enforces th
 4. **Async loaders** — dynamic `import()` pattern for page loading
 5. **Native History API** — `pushState` / `popstate`; no hash routing by default (hash mode is a planned opt-in)
 6. **Race-condition safe** — `currentNavId` monotonic counter guards stale renders
+7. **Scripts are TypeScript** — all `scripts/` tooling is `.ts`, run via
+   `node --experimental-strip-types`; never add a new `.js`/`.mjs` script.
 
 ## Verification Gate
 

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented here. The format follows
 
 ## [Unreleased]
 
+### Fixed
+
+- Added `@types/node` as a devDependency so `scripts/check-readme-version.ts`
+  resolves Node globals correctly (no functional impact — script already ran
+  fine via `node --experimental-strip-types`, this only affects editor/IDE
+  type-checking and any future widening of `tsconfig.json`'s `include`).
+
 ### Added
 
 - Added `@phcdevworks/spectre-manifest` as a devDependency. `spectre.manifest.json`