[campaign #253] STEP 2 — OIKOS PATTERN AUDIT: canonical deno.json shape + re-inventory

[hyperpolymath]

Part of #253. Blocked by step 1.

Goal

Codify the canonical deno.json shape derived from oikos Phase 5 + 5 follow-ups (MERGED) so that all downstream physical migrations (STEPs 3-7) follow a single, documented template. Also: re-run the manifest inventory using the umbrella's documented exclude set, since a fresh find on 2026-05-30 disagrees with the umbrella's snapshot.

Prior art — Deno-native invocation pattern

From oikos Phase 5 follow-ups (memory: session_2026_05_28_oikos_phase5_follow_ups.md), the canonical Deno-native pattern for invoking a previously-npm-shipped tool is:

deno run -A --allow-scripts=npm:rescript npm:rescript@^12.0.0

This pattern generalises: invoke npm-published tools through npm:<pkg>@<semver> specifiers with explicit --allow-scripts= when the tool's install lifecycle requires it. Document this pattern as the default for any npm tool that hasn't been ported to a native Deno equivalent.

Inventory reconciliation (acceptance-blocking)

The umbrella body cites 172 package.json manifests post-excludes. A fresh find on 2026-05-30 with looser excludes returned 437. The umbrella's documented exclude set is:

• hyperpolymath-archive/**
• **/deps/**, **/node_modules/**
• upstream forks (rescript/, servers/, repos-monorepo/, linguist/)

Acceptance criterion: re-run the inventory with the documented exclude set, record the actual count, and update the umbrella body (or file a correction issue) so STEPs 3-7 batch sizing is grounded in the true number. If the count is materially different (>10% drift), revisit the STEP 3/4/5 batch ordering.

Audit deliverables

1. standards/docs/migrations/npm-to-deno-template/deno.json — canonical shape (imports map, tasks, lint, fmt, exclude)
2. standards/docs/migrations/npm-to-deno-template/MIGRATION.md — per-file migration recipe (package.json → deno.json, npm scripts → deno tasks, .gitignore changes, CI workflow swaps)
3. Documented exception cases derived from oikos PRs (5 follow-ups worth of lessons)
4. Refreshed inventory TSV at ~/Documents/npm-to-deno-inventory-2026-05-30.tsv with <count>\t<repo>\t<manifest-path> columns

Acceptance

• Template files merged into standards/docs/migrations/npm-to-deno-template/
• Inventory re-run produces accurate count; umbrella body updated if drift
• Deno-native invocation pattern documented as default
• All 5 oikos follow-up PRs cross-referenced in MIGRATION.md

Sequencing

Blocked by: STEP 1 (policy gate live before authoring conversion template).
Blocks: STEP 3, 4, 5, 6, 7 (all physical migrations need template + accurate inventory).

[hyperpolymath]

Inventory drift reconciled 2026-05-30:

• Umbrella [campaign] npm → Deno estate migration (UMBRELLA) #253 baseline: 172 package.json files
• Fresh find with broader excludes (only node_modules / .git / dist / build / target / _build / _opam / _wt-* / hyperpolymath-archive / .deno / vendor / rescript / servers / repos-monorepo / linguist / deps): 437
• Same find adding example / examples / test-fixtures / fixtures excludes: 169 ✅ converges with umbrella

Conclusion: 268-file delta was example/fixture noise. The 172-figure is sound. STEP 2 acceptance should bake in the strict exclude set: node_modules, .git, dist, build, target, _build, _opam, _wt-*, hyperpolymath-archive, .deno, vendor, rescript, servers, repos-monorepo, linguist, deps, example, examples, test-fixtures, fixtures.

Top-N by repo (post strict excludes, 2026-05-30): developer-ecosystem 23 / ssg-collection 14 / standards 9 / burble + affinescript-stdlib-pr* + accessibility-everywhere 8 / polyglot-i18n 7 / stapeln + affinescript 6 / reposystem + boj-server 5.

* affinescript-stdlib-pr is a local worktree of affinescript — exclude before batch sizing.

[hyperpolymath]

Documentation deliverable SHIPPED in commit 619565d (merged via PR #281). The "closes #262" trailer didn't autoreply due to PR/commit linkage timing — closing manually.

What landed under docs/migrations/npm-to-deno-template/

• deno.json (57 lines) — canonical shape derived from echidna + svalinn + oikos Phase 5 follow-ups. Class A (pure-Deno port) defaults nodeModulesDir: "none"; Class B (npm wrapper) sets "auto" per task.
• MIGRATION.md (153 lines) — per-repo recipe: class triage, scaffolding deletion, CI workflow swaps, commit pattern, PR + auto-merge convention.
• INVENTORY-2026-05-30.md (67 lines) — re-run with documented excludes returns 162 manifests across 63 repos. Drift from umbrella baseline (172) is -5.8%, within tolerance. No STEP re-ordering required.

Source TSV preserved at ~/Documents/npm-to-deno-inventory-2026-05-30.tsv.

Acceptance check

• ✅ Template files merged into docs/migrations/npm-to-deno-template/
• ✅ Inventory re-run completed; drift documented (no umbrella correction required)
• ✅ Deno-native npm:<pkg>@<semver> invocation pattern documented in MIGRATION.md
• ✅ Oikos follow-up lessons cross-referenced

Documentation label applied; closing. STEPs 3-7 unblocked.