@autodevjapan/godd-mcp-alpha 2.16.3 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -40,10 +40,33 @@ Node.js 22+ · an MCP client (Cursor / Claude Code / Codex / Kimi CLI / Antigrav
40
40
 
41
41
  The server validates your license online at every startup — there is no offline grace period.
42
42
 
43
+ ### Docker startup
44
+
45
+ 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.
46
+
47
+ **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.
48
+
43
49
  ### Everything else
44
50
 
45
51
  The full tool list, CLI reference, and troubleshooting live on the **[documentation site](https://www.getgodd.dev/en/docs)**.
46
52
 
53
+ The Stage 1 Rust archive admission reader is available for bounded OOXML
54
+ package diagnostics. `godd-native office-package-admission --path <file>`
55
+ returns a non-disclosing JSON receipt; `strict` is the default profile and
56
+ there is no disabled mode. Wiring this gate into the Office engine operation
57
+ and recursive expansion of embedded archives are later integration stages.
58
+ Every completed diagnostic admission attempt is appended to
59
+ `<resolved GoDD root>/state/office/package-admission-receipts.ndjson`; a
60
+ receipt-write failure makes the command fail closed. Use `--receipt <path>`
61
+ only when an additional nofollow audit destination is needed. A persistence
62
+ failure does not rewrite the admission verdict, but the CLI exits 2 and does
63
+ not forward an unaudited ALLOW receipt. Private staging is released before receipt
64
+ persistence, including failure paths. Input paths with parent traversal, symlinks,
65
+ reparse points, or hard links are rejected; reading uses the same opened file handle.
66
+ Relative OPC relationship targets may resolve `..` within the package root;
67
+ root escapes remain denied. Empty ZIP directory markers are validated and
68
+ discarded outside the OPC part graph, while non-empty markers are denied.
69
+
47
70
  Writing an adapter? All three subpath contracts (media interval / audio length / compile cache) ship with the package at `docs/adapter-contracts.md`.
48
71
 
49
72
  ### License
@@ -80,10 +103,31 @@ Node.js 22+ ・ MCP クライアント(Cursor / Claude Code / Codex / Kimi CLI
80
103
 
81
104
  ライセンスは MCP サーバー起動のたびにオンラインで検証します。オフライン猶予期間はありません。
82
105
 
106
+ ### Docker の起動
107
+
108
+ MCP サーバー起動時に Docker daemon の応答を確認します。Windows/macOS では応答しない場合に Docker Desktop process を確認し、すでに起動していれば二重起動しません。プロセス状態を確認できない場合も追加起動を見送ります。Linux では systemd/service 経由で Docker の起動を試みます。Docker が使えなくても MCP サーバー自体は起動を続けます。
109
+
110
+ **Registry の破壊的変更(#2986):** 応答の配信世代情報が必須になります。`CLIENT_GENERATION_MISSING` が出た場合は Registry 管理者にサーバー移行の完了を依頼してください。`CLIENT_GENERATION_MALFORMED` は世代情報の不正、`CLIENT_GENERATION_SPLIT` は応答内の世代混在を示し、いずれも配信を停止します。`GENERATION_DIGEST_ABSENT` は last-known-good キャッシュから配信した場合の非fatal診断です。失敗した MCP プロンプト要求はプロトコルエラーとなり、usage に計上しません。
111
+
83
112
  ### その他
84
113
 
85
114
  ツール一覧・CLI リファレンス・トラブルシューティングは **[ドキュメントサイト](https://www.getgodd.dev/docs)** にまとまっています。
86
115
 
116
+ Stage 1 の Rust archive admission reader で、ネイティブ OOXML package を
117
+ bounded に診断できます。`godd-native office-package-admission --path <file>`
118
+ は本文や entry 名を含まない JSON receipt を返し、既定 profile は `strict`
119
+ です(無効化モードはありません)。Office engine operation への配線と埋め込み
120
+ archive の再帰展開は後続 Stage の対象です。
121
+ 診断 admission が完了した全 attempt は
122
+ `<解決済み GoDD root>/state/office/package-admission-receipts.ndjson` へ追記され、
123
+ receipt を保存できない場合は fail-closed で終了します。追加の監査先が必要な場合だけ
124
+ `--receipt <path>` を指定します。保存失敗は admission verdict を書き換えませんが、
125
+ 監査されていない ALLOW receipt を渡さず CLI は exit 2 を返します。
126
+ private staging は receipt 保存前に解放され、保存失敗時も残しません。入力 path の
127
+ parent traversal・symlink/reparse point・hard link を拒否し、同一 file handle で読み取ります。
128
+ OPC relationship の相対 `..` は package root 内に限って解決し、root escape は拒否します。
129
+ 空の ZIP directory marker は検査後に OPC part graph の外で破棄し、非空 marker は拒否します。
130
+
87
131
  アダプターを実装する場合、3 つの subpath 契約(media interval / audio length / compile cache)はパッケージ同梱の `docs/adapter-contracts.md` にあります。
88
132
 
89
133
  ### ライセンス
@@ -120,6 +164,12 @@ Node.js 22+ · MCP-клиент (Cursor / Claude Code / Codex / Kimi CLI / Antig
120
164
 
121
165
  Сервер проверяет лицензию онлайн при каждом запуске; офлайн-периода нет.
122
166
 
167
+ ### Запуск Docker
168
+
169
+ При запуске MCP-сервера GoDD проверяет, отвечает ли Docker daemon. На Windows/macOS, если daemon не отвечает, сначала проверяется, запущен ли Docker Desktop; повторный запуск не выполняется. Если состояние процесса нельзя определить, запуск тоже пропускается. На Linux используется systemd/service. MCP-сервер продолжает работу, даже если Docker недоступен.
170
+
171
+ **Несовместимое изменение Registry (#2986):** ответ должен содержать данные о поколении контента. При `CLIENT_GENERATION_MISSING` попросите оператора Registry завершить миграцию. `CLIENT_GENERATION_MALFORMED` означает некорректные данные, `CLIENT_GENERATION_SPLIT` — смешанные поколения; доставка останавливается. `GENERATION_DIGEST_ABSENT` — отдельная нефатальная диагностика доставки из последнего проверенного кеша. Неудачные MCP-запросы промптов возвращают ошибку протокола и не учитываются как использование.
172
+
123
173
  ### Остальное
124
174
 
125
175
  Полный список инструментов, справочник CLI и устранение неполадок — на **[сайте документации](https://www.getgodd.dev/ru/docs)**.
@@ -1 +1 @@
1
- 31e2f38fd12481a373fa29470e12870991f56f0e934bf6e8af897d90fec2e21a
1
+ 5c51cd35892e50c135820048c49cdfa1379ed782d54561e7ab19ce3e1cc064cb
@@ -1 +1 @@
1
- 3546b2504c1f8f7897e1ca0693d2da3ca3cddc97ecfdb47f7964a41d4511e7b0
1
+ 359293a022bc2eec9a8e3321acb8f1f81e394402b79e3bf5603622b0b0c4aac1
@@ -1 +1 @@
1
- a5aca66a29cda82852d756a46e9707caa449cc9b285c9a974fb800e2c2b31870
1
+ 80d1ccaedb9bb59fe294b1e20bf1df6b4258b60cef985208a39b705fff189eb8
@@ -1 +1 @@
1
- 73a803147de665ca9e89715da1a1491f112f4d6f3fd3f31ce2aca5abad67a40a
1
+ fef272bcdee07f03ebf035c271567cfa1f3198fbace5512dedab6324052f308a
@@ -1 +1 @@
1
- {"schema_version":1,"minimum_key_generation":"1","keys":[]}
1
+ {"schema_version":1,"minimum_key_generation":"1","keys":[{"key_id":"godd-prod-2026-09","key_generation":"1","public_key_spki_base64":"MCowBQYDK2VwAyEAhG0VHOPOo2u21QT9enWD+ZeYEWPL5iPCC4evJNyfbSw="}]}