@autodevjapan/godd-mcp-alpha 3.0.0 → 3.1.1

package/README.md

@@ -40,12 +40,33 @@ Node.js 22+ · an MCP client (Cursor / Claude Code / Codex / Kimi CLI / Antigrav
 
 The server validates your license online at every startup — there is no offline grace period.
 
+### Docker startup
+
+At server startup, GoDD checks whether the Docker daemon responds. On Windows and macOS, if it does not, GoDD checks whether Docker Desktop is already running before requesting a launch; it does not start a second instance. If process state cannot be confirmed, it skips the launch. Linux uses systemd/service to start Docker. The MCP server continues if Docker is unavailable. On Windows, Docker status-check helpers and MCP-managed child processes use hidden-console mode.
+
 **Breaking Registry change (#2986):** responses must declare a content generation. `CLIENT_GENERATION_MISSING` means the server migration is incomplete; ask the Registry operator to finish it. `CLIENT_GENERATION_MALFORMED` means the generation metadata is invalid; `CLIENT_GENERATION_SPLIT` means a response mixes generations. These errors stop delivery. `GENERATION_DIGEST_ABSENT` is a separate, nonfatal diagnostic for delivery from the last-known-good cache. Failed MCP prompt requests now return a protocol error, and are not counted as usage.
 
 ### Everything else
 
 The full tool list, CLI reference, and troubleshooting live on the **[documentation site](https://www.getgodd.dev/en/docs)**.
 
+The Stage 1 Rust archive admission reader is available for bounded OOXML
+package diagnostics. `godd-native office-package-admission --path <file>`
+returns a non-disclosing JSON receipt; `strict` is the default profile and
+there is no disabled mode. Wiring this gate into the Office engine operation
+and recursive expansion of embedded archives are later integration stages.
+Every completed diagnostic admission attempt is appended to
+`<resolved GoDD root>/state/office/package-admission-receipts.ndjson`; a
+receipt-write failure makes the command fail closed. Use `--receipt <path>`
+only when an additional nofollow audit destination is needed. A persistence
+failure does not rewrite the admission verdict, but the CLI exits 2 and does
+not forward an unaudited ALLOW receipt. Private staging is released before receipt
+persistence, including failure paths. Input paths with parent traversal, symlinks,
+reparse points, or hard links are rejected; reading uses the same opened file handle.
+Relative OPC relationship targets may resolve `..` within the package root;
+root escapes remain denied. Empty ZIP directory markers are validated and
+discarded outside the OPC part graph, while non-empty markers are denied.
+
 Writing an adapter? All three subpath contracts (media interval / audio length / compile cache) ship with the package at `docs/adapter-contracts.md`.
 
 ### License
@@ -82,12 +103,31 @@ Node.js 22+ ・ MCP クライアント（Cursor / Claude Code / Codex / Kimi CLI
 
 ライセンスは MCP サーバー起動のたびにオンラインで検証します。オフライン猶予期間はありません。
 
+### Docker の起動
+
+MCP サーバー起動時に Docker daemon の応答を確認します。Windows/macOS では応答しない場合に Docker Desktop process を確認し、すでに起動していれば二重起動しません。プロセス状態を確認できない場合も追加起動を見送ります。Linux では systemd/service 経由で Docker の起動を試みます。Docker が使えなくても MCP サーバー自体は起動を続けます。Windowsでは、Docker状態確認用の補助プロセスとMCP管理下の子プロセスをコンソール窓なしで起動します。
+
 **Registry の破壊的変更（#2986）:** 応答の配信世代情報が必須になります。`CLIENT_GENERATION_MISSING` が出た場合は Registry 管理者にサーバー移行の完了を依頼してください。`CLIENT_GENERATION_MALFORMED` は世代情報の不正、`CLIENT_GENERATION_SPLIT` は応答内の世代混在を示し、いずれも配信を停止します。`GENERATION_DIGEST_ABSENT` は last-known-good キャッシュから配信した場合の非fatal診断です。失敗した MCP プロンプト要求はプロトコルエラーとなり、usage に計上しません。
 
 ### その他
 
 ツール一覧・CLI リファレンス・トラブルシューティングは **[ドキュメントサイト](https://www.getgodd.dev/docs)** にまとまっています。
 
+Stage 1 の Rust archive admission reader で、ネイティブ OOXML package を
+bounded に診断できます。`godd-native office-package-admission --path <file>`
+は本文や entry 名を含まない JSON receipt を返し、既定 profile は `strict`
+です（無効化モードはありません）。Office engine operation への配線と埋め込み
+archive の再帰展開は後続 Stage の対象です。
+診断 admission が完了した全 attempt は
+`<解決済み GoDD root>/state/office/package-admission-receipts.ndjson` へ追記され、
+receipt を保存できない場合は fail-closed で終了します。追加の監査先が必要な場合だけ
+`--receipt <path>` を指定します。保存失敗は admission verdict を書き換えませんが、
+監査されていない ALLOW receipt を渡さず CLI は exit 2 を返します。
+private staging は receipt 保存前に解放され、保存失敗時も残しません。入力 path の
+parent traversal・symlink/reparse point・hard link を拒否し、同一 file handle で読み取ります。
+OPC relationship の相対 `..` は package root 内に限って解決し、root escape は拒否します。
+空の ZIP directory marker は検査後に OPC part graph の外で破棄し、非空 marker は拒否します。
+
 アダプターを実装する場合、3 つの subpath 契約（media interval / audio length / compile cache）はパッケージ同梱の `docs/adapter-contracts.md` にあります。
 
 ### ライセンス
@@ -124,6 +164,10 @@ Node.js 22+ · MCP-клиент (Cursor / Claude Code / Codex / Kimi CLI / Antig
 
 Сервер проверяет лицензию онлайн при каждом запуске; офлайн-периода нет.
 
+### Запуск Docker
+
+При запуске MCP-сервера GoDD проверяет, отвечает ли Docker daemon. На Windows/macOS, если daemon не отвечает, сначала проверяется, запущен ли Docker Desktop; повторный запуск не выполняется. Если состояние процесса нельзя определить, запуск тоже пропускается. На Linux используется systemd/service. MCP-сервер продолжает работу, даже если Docker недоступен. В Windows вспомогательные процессы проверки Docker и дочерние процессы MCP запускаются без отдельного окна консоли.
+
 **Несовместимое изменение Registry (#2986):** ответ должен содержать данные о поколении контента. При `CLIENT_GENERATION_MISSING` попросите оператора Registry завершить миграцию. `CLIENT_GENERATION_MALFORMED` означает некорректные данные, `CLIENT_GENERATION_SPLIT` — смешанные поколения; доставка останавливается. `GENERATION_DIGEST_ABSENT` — отдельная нефатальная диагностика доставки из последнего проверенного кеша. Неудачные MCP-запросы промптов возвращают ошибку протокола и не учитываются как использование.
 
 ### Остальное

package/assets/native/godd-native-aarch64-apple-darwin.sha256

@@ -1 +1 @@
-6f0159931fe29f0b308e000426a185ced514561f7ad340e0b280ae2735dbf8c5
+1c0b77639c39fc3a2de3bd5ba8257a65d0d86a208f7adb0a9f972254556b3426

package/assets/native/godd-native-x86_64-apple-darwin.sha256

@@ -1 +1 @@
-b919f66f447260d655856cc0df8c17cb06d37dcaade2eed0637ea99f3a0e31cd
+46b1fef386c8ab597c5cc37da17e37096f2ed0c982ef289adf7a17d68e9fe1a7

package/assets/native/godd-native-x86_64-pc-windows-msvc.exe.sha256

@@ -1 +1 @@
-cd544cb1e0764da640a8e726be7bce17c7bb40494c8dc169106c9bd2a6a7ffd6
+9b0c435ceae447c6e24917e871a1f2767ed49c79befed9936c16c0b75d312b24

package/assets/native/godd-native-x86_64-unknown-linux-musl.sha256

@@ -1 +1 @@
-a0b9f750c3eef15e62dd4b1ea793346036dcce4eb16480f9df16f9e5493567a5
+0f673febbb123bb4eed2876701f7d9a6b3fa67bc95d4bbc0544499dbe35aa98a