@autodevjapan/godd-mcp-alpha 2.15.1 → 2.16.0

package/docs/adapter-contracts.md

@@ -110,3 +110,73 @@ Reconciliation ownership is fixed, not negotiated:
 `deriveCompileCacheReconcilePolicy({ age_ms, idle_ms, reservation_ttl_ms })`
 returns that owner plus `interval_ms` = the minimum of the three budgets, so the
 sweep can never run less often than the shortest deadline it must enforce.
+
+## Compile cache runtime
+
+The contract above decides; it does not act. `compile-cache-runtime` is the
+caller that applies it — it drives the compile path, owns the single reconcile
+timer, and holds the compiled modules whose lifetime the receipts govern.
+Without it the declared `age_ms` / `idle_ms` / `reservation_ttl_ms` budgets
+never fire, because nothing calls `reconcile`.
+
+```ts
+import {
+  CompileCacheRuntime,
+  spawnCompileCacheEvaluator,
+} from "@autodevjapan/godd-mcp-alpha/compile-cache-runtime";
+
+const runtime = new CompileCacheRuntime({
+  evaluator: spawnCompileCacheEvaluator({ command: goddNativeBinaryPath }),
+  budget,                       // all ten scopes; none may be omitted
+  now: () => Number(process.hrtime.bigint() / 1_000_000n),
+  compile: async ({ canonical_source, manifest }) => {
+    const compiled = await compileMdx(canonical_source, manifest);
+    return { module: compiled, compiled_bytes: Buffer.byteLength(compiled.code) };
+  },
+});
+
+runtime.startReconcileTimer();  // the Next.js server, once, per process
+const { module } = await runtime.compile({
+  manifest,                     // seven fields; the digest is derived for you
+  canonical_source,
+  declared_max_compiled_bytes,
+});
+```
+
+- **The compiler stays yours.** `compile` is injected. The runtime never starts
+  a Next.js runtime or an MDX compiler, and the compiled module is opaque to it.
+- **One timer owner.** `startReconcileTimer()` throws if called twice on the
+  same runtime, because two sweepers would race each other. The interval comes
+  from `deriveCompileCacheReconcilePolicy`, never from a hand-picked number.
+- **Lifecycle events do not wait for the timer.** `onDeckRemoved`,
+  `onPreviewLeaseExpired`, and `onGenerationUpdated` mark the affected entries
+  and immediately drive a reconcile, because marking alone frees nothing.
+- **`RETRY` is bounded to one attempt.** A `BUDGET_UNRECLAIMABLE` register
+  reconciles once and retries once; a second refusal throws
+  `CompileCacheRejectedError` with `retriesExhausted: true`.
+- **Clock regressions are not smoothed over.** A `RECONCILE_CLOCK_REGRESSION`
+  reaches `onReconcileError` unchanged rather than being retried or ignored.
+- **Modules are held per entry, released per receipt.** A module is stored under
+  the full eight-field manifest, because `compile` receives that manifest and
+  two decks with identical source can still produce different output. Receipts
+  carry no deck identity, so a reclamation names a *set* of entries; the runtime
+  releases all of them, and a later `CACHE_HIT` with no retained module
+  recompiles. One wasted compile, never a budget that fails to free memory and
+  never one deck's module served to another. Release is idempotent, because the
+  evaluator re-reports a marked entry on every reconcile until its pins drop.
+- **Every path releases its lease.** A stranded pin makes an entry permanently
+  unreclaimable and every later request for it `BUDGET_UNRECLAIMABLE`, so the
+  lease is released even when a compile throws, a commit is refused, or the
+  response itself is rejected as drifted. A commit the evaluator no longer
+  accepts — a reservation swept past `reservation_ttl_ms` mid-compile — rejects
+  with `COMMIT_NOT_ACCEPTED` after the lease is returned, and publishes nothing.
+- **The session dying drops the cache.** Nothing can reconcile once the
+  evaluator is gone, so an `EVALUATOR_CLOSED` send clears every retained module
+  rather than leaving the host holding memory no budget can reach.
+
+The evaluator itself runs in the `godd-native` binary as
+`godd-native compile-cache session`: a long-lived NDJSON session over stdio
+holding exactly one cache. Only manifests, byte counts, and monotonic
+timestamps cross that boundary; every command is parsed with
+`deny_unknown_fields`, and any violation ends the session with a bare error
+code rather than echoing the command back.

package/native-assets.json

@@ -1,11 +1,13 @@
 {
   "schemaVersion": 2,
-  "releaseTag": "godd-native-v0.2.27",
-  "expectedVersion": "godd-native 0.2.27",
-  "sourceCommit": "313e1c76395d0fcbdd071c695f1d405aa71d67c3",
+  "releaseTag": "godd-native-v0.2.31",
+  "expectedVersion": "godd-native 0.2.31",
+  "sourceCommit": "1e7f4ce462dced681f0920e5bb36e080f7195a61",
   "capabilities": [
     "cobol-evidence",
     "codec-capability",
+    "compile-cache",
+    "content-generation",
     "gateway-operations",
     "mcp-stdio",
     "operate",
@@ -13,30 +15,30 @@
     "plan-audit",
     "research"
   ],
-  "baselineBytes": 36863916,
+  "baselineBytes": 39439764,
   "maximumAssetBytes": 50000000,
   "maximumTarballBytes": 25000000,
   "maximumUnpackedBytes": 55000000,
   "targets": {
     "darwin-x64": {
       "artifact": "godd-native-x86_64-apple-darwin",
-      "bytes": 8704856,
-      "sha256": "450bfd9030682b2755d17e45efa2f2a6808a990cf246036cb9a9e703383eb4c7"
+      "bytes": 9316256,
+      "sha256": "3546b2504c1f8f7897e1ca0693d2da3ca3cddc97ecfdb47f7964a41d4511e7b0"
     },
     "darwin-arm64": {
       "artifact": "godd-native-aarch64-apple-darwin",
-      "bytes": 7905536,
-      "sha256": "43bacbb81e170e3a821a8aadb7aba33cea0b7871f5a3232bb7e598f347f90c80"
+      "bytes": 8418464,
+      "sha256": "31e2f38fd12481a373fa29470e12870991f56f0e934bf6e8af897d90fec2e21a"
     },
     "linux-x64": {
       "artifact": "godd-native-x86_64-unknown-linux-musl",
-      "bytes": 9651280,
-      "sha256": "6a2f7c8a7b3cace0b3b41f7f73f5bbae05fd42e9d52a5bcd19f338d7302022df"
+      "bytes": 10298960,
+      "sha256": "73a803147de665ca9e89715da1a1491f112f4d6f3fd3f31ce2aca5abad67a40a"
     },
     "win32-x64": {
       "artifact": "godd-native-x86_64-pc-windows-msvc.exe",
-      "bytes": 10601984,
-      "sha256": "5b945c654547e8652ed42e410f9be8ba54e20c0d078838fa3342fdfd1918697a"
+      "bytes": 11405824,
+      "sha256": "a5aca66a29cda82852d756a46e9707caa449cc9b285c9a974fb800e2c2b31870"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autodevjapan/godd-mcp-alpha",
-  "version": "2.15.1",
+  "version": "2.16.0",
   "type": "module",
   "description": "Governed AI development workflows that turn natural-language intent into specifications, tested code, reviews, documentation, and shippable pull requests.",
   "license": "UNLICENSED",
@@ -23,6 +23,11 @@
       "require": "./dist/compile-cache-adapter-contract.cjs",
       "default": "./dist/compile-cache-adapter-contract.cjs"
     },
+    "./compile-cache-runtime": {
+      "types": "./dist/compile-cache-runtime.d.ts",
+      "require": "./dist/compile-cache-runtime.cjs",
+      "default": "./dist/compile-cache-runtime.cjs"
+    },
     "./*": "./*"
   },
   "bin": {
@@ -41,6 +46,8 @@
     "dist/media-interval-adapter-contract.d.ts",
     "dist/compile-cache-adapter-contract.cjs",
     "dist/compile-cache-adapter-contract.d.ts",
+    "dist/compile-cache-runtime.cjs",
+    "dist/compile-cache-runtime.d.ts",
     "scripts/postinstall.js",
     "scripts/atomic-binary-install.js",
     "scripts/postinstall-godd-native.js",
@@ -66,9 +73,10 @@
     "godd"
   ],
   "scripts": {
-    "build": "pnpm generate:native-catalog && node esbuild.config.js && tsc --ignoreConfig src/audio-length-adapter-contract.ts src/media-interval-adapter-contract.ts src/compile-cache-adapter-contract.ts --declaration --emitDeclarationOnly --declarationMap false --outDir dist --module ES2022 --target ES2022 --moduleResolution bundler --resolveJsonModule --types node --skipLibCheck",
-    "build:release": "pnpm generate:native-catalog && GODD_BUILD_MODE=release node esbuild.config.js && tsc --ignoreConfig src/audio-length-adapter-contract.ts src/media-interval-adapter-contract.ts src/compile-cache-adapter-contract.ts --declaration --emitDeclarationOnly --declarationMap false --outDir dist --module ES2022 --target ES2022 --moduleResolution bundler --resolveJsonModule --types node --skipLibCheck",
+    "build": "pnpm generate:native-catalog && node esbuild.config.js && tsc --ignoreConfig src/audio-length-adapter-contract.ts src/media-interval-adapter-contract.ts src/compile-cache-adapter-contract.ts src/compile-cache-runtime.ts --declaration --emitDeclarationOnly --declarationMap false --outDir dist --module ES2022 --target ES2022 --moduleResolution bundler --resolveJsonModule --types node --skipLibCheck",
+    "build:release": "pnpm generate:native-catalog && GODD_BUILD_MODE=release node esbuild.config.js && tsc --ignoreConfig src/audio-length-adapter-contract.ts src/media-interval-adapter-contract.ts src/compile-cache-adapter-contract.ts src/compile-cache-runtime.ts --declaration --emitDeclarationOnly --declarationMap false --outDir dist --module ES2022 --target ES2022 --moduleResolution bundler --resolveJsonModule --types node --skipLibCheck",
     "generate:native-catalog": "tsx scripts/generate-native-catalog.ts",
+    "anchor:keyring": "tsx scripts/registry-anchor-keyring.ts",
     "catalog:generate": "tsx scripts/generate-command-catalog.ts",
     "catalog:check": "tsx scripts/generate-command-catalog.ts --check",
     "catalog:check:full": "tsx scripts/generate-command-catalog.ts --check --require-site",
@@ -85,23 +93,25 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
+    "koffi": "3.1.6",
     "yaml": "^2.9.0",
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@types/node": "26.1.2",
-    "esbuild": "0.28.1",
-    "tsx": "4.23.1",
+    "@types/node": "26.4.0",
+    "esbuild": "0.28.2",
+    "tsx": "4.23.12",
     "typescript": "7.0.2",
-    "vite": "8.2.0",
-    "vitest": "4.1.10"
+    "vite": "8.2.2",
+    "vitest": "4.1.11"
   },
   "pnpm": {
     "onlyBuiltDependencies": [
-      "esbuild"
+      "esbuild",
+      "koffi"
     ],
     "overrides": {
-      "esbuild": "0.28.1",
+      "esbuild": "0.28.2",
       "rollup": ">=4.59.0",
       "hono": ">=4.12.34",
       "@hono/node-server": ">=2.0.5",

package/scripts/native-assets.js

@@ -173,12 +173,14 @@ export const EXPECTED_NATIVE_ASSET_FILES = Object.freeze(
 // 気づけない）。到達前に検知するため、警告用の閾値と ratchet 上限を定義する。
 export const NATIVE_ASSET_HEADROOM_WARNING_BYTES = 2_000_000;
 
-// `godd-native-v0.2.27` の exact baseline を、意味のある追加増加を止める
+// `godd-native-v0.2.31` の exact baseline を、意味のある追加増加を止める
 // non-cumulative ratchet として固定する。absolute ceiling は別途50MBで維持する。
-// v0.2.25 (36,857,772) からの +18,432 bytes は registry anchor (#1493) と
-// compile cache (#1463) の実装分。昇格ごとに実測値へ再固定するため、
-// 小さな増加が誰にも気づかれずに累積することはない。
-export const NATIVE_ASSET_BASELINE_CEILING_BYTES = 36_863_916;
+// v0.2.27 (36,863,916) からの +2,575,848 bytes は、v0.2.28〜v0.2.31 昇格に
+// まとめて含まれる content-generation verifier / compile-cache runtime /
+// provider gateway (fail-closed化) / download broker (Stage 1b/1c) /
+// learn skill store 等、複数のnative機能追加分。昇格ごとに実測値へ再固定する
+// ため、小さな増加が誰にも気づかれずに累積することはない。
+export const NATIVE_ASSET_BASELINE_CEILING_BYTES = 39_439_764;
 
 /**
  * 現在の昇格済みreleaseを上限とし、1 byteでも追加増加すれば拒否するratchet。