@autodevjapan/godd-mcp-alpha 2.9.4 → 2.10.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
@@ -34,6 +34,22 @@ A valid license key is required to use GoDD MCP.
34
34
  2. [Create an account](https://www.getgodd.dev/godd-admin/register) and choose a subscription
35
35
  3. Issue a license key from your [dashboard](https://www.getgodd.dev/godd-admin/dashboard)
36
36
 
37
+ ### Startup and offline behavior
38
+
39
+ GoDD validates the license online every time the MCP server starts. There is no offline
40
+ license grace period: a timeout, connection failure, server error, or rejected license stops
41
+ startup. After that online validation succeeds, a temporary lexicon outage can use a
42
+ digest- and MAC-verified last-known-good generation within
43
+ `GODD_REGISTRY_CACHE_MAX_AGE_DAYS` (30 days by default). Fallback is limited to endpoint
44
+ unavailability. Any successful but invalid/oversize response, source mismatch, revision
45
+ rollback, bounded HTTP 409 `LEXICON_INTEGRITY_FAILURE`, 401/403, expired or modified
46
+ cache, or missing cache stops startup. A mid-stream disconnect is unavailable and may
47
+ use LKG; an oversized stream is fatal. The same 15-second deadline covers headers and
48
+ the complete bounded body. Revisions are canonical nonzero u64 decimals.
49
+ The cache has no independent trusted high-water anchor: CAS rejects concurrent stale
50
+ writes, but cannot detect restoration of an older wholly authentic cache file. The
51
+ max-age ceiling only bounds that residual replay window.
52
+
37
53
  ### Installation
38
54
 
39
55
  ```bash
@@ -93,7 +109,7 @@ Invoke GoDD in whichever way your client supports:
93
109
  | `slide` | Generate presentation slides from project docs (Marp Markdown format) |
94
110
  | `design` | Generate/update visual designs from codebase (Pencil.dev sync) |
95
111
  | `metrics` | Token efficiency and optional evidence-based quality, budget, learning outcome, and guardrail preflight report |
96
- | `plan` | Advance one approved plan task at a time with durable state and a test-evidence gate |
112
+ | `plan` | Run bounded approved plans with durable lifecycle, observable persisted deadlines, two-phase cancellation, and deterministic review |
97
113
 
98
114
  The machine-readable version of this table is published at
99
115
  [getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json); the agent
@@ -145,6 +161,20 @@ GoDD MCP の利用には有効なライセンスキーが必要です。
145
161
  2. [アカウント登録](https://www.getgodd.dev/godd-admin/register)してサブスクリプションを選択
146
162
  3. [ダッシュボード](https://www.getgodd.dev/godd-admin/dashboard)からライセンスキーを発行
147
163
 
164
+ ### 起動とオフライン時の動作
165
+
166
+ MCP server は起動のたびに license をオンライン検証します。offline の猶予期間はなく、
167
+ timeout、接続失敗、server error、license 拒否では起動しません。今回のオンライン検証が
168
+ 成功した後に限り、lexicon の一時障害では digest/MAC 検証済みの最終正常世代を
169
+ `GODD_REGISTRY_CACHE_MAX_AGE_DAYS`(既定30日)以内で利用します。縮退はendpoint
170
+ unavailable時だけです。成功応答の不正・oversize、source不一致、revision rollback、
171
+ HTTP 409 `LEXICON_INTEGRITY_FAILURE`、401/403、期限切れ・改ざんcache、cache不在では
172
+ 起動を拒否します。stream途中切断はunavailable、上限超過はfatalです。revisionは
173
+ nonzero u64 decimalに限定し、同じ15秒deadlineをheadersからbody完読まで強制します。
174
+ 独立したtrusted high-water anchorはないため、CASは
175
+ 同時stale writeを拒否しても過去の正規cache file全体の復元を検出できません。
176
+ max-age ceilingはこの残存replay windowを上限化するだけです。
177
+
148
178
  ### インストール
149
179
 
150
180
  ```bash
@@ -204,7 +234,7 @@ godd-a init
204
234
  | `slide` | プロジェクトドキュメントからプレゼンスライドを生成(Marp Markdown 形式) |
205
235
  | `design` | コードベースからビジュアルデザインを生成/更新(Pencil.dev 同期) |
206
236
  | `metrics` | トークン効率と、任意の証拠に基づく品質・予算・学習成果・guardrail preflightレポート |
207
- | `plan` | 承認済み計画を永続状態とテスト証跡ゲート付きで一タスクずつ進める |
237
+ | `plan` | 承認済み計画を有界な永続 lifecycle、観測可能な永続 deadline、二相 cancel、決定的 review 付きで実行する |
208
238
 
209
239
  この表の機械可読版は
210
240
  [getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json) に公開しています。
@@ -256,6 +286,22 @@ godd-a init
256
286
  2. [Создайте аккаунт](https://www.getgodd.dev/godd-admin/register) и выберите подписку
257
287
  3. Выпустите лицензионный ключ в [панели управления](https://www.getgodd.dev/godd-admin/dashboard)
258
288
 
289
+ ### Запуск и работа без сети
290
+
291
+ При каждом запуске MCP-сервера лицензия проверяется онлайн. Периода автономной
292
+ отсрочки нет: тайм-аут, ошибка подключения или сервера, а также отклонённая лицензия
293
+ останавливают запуск. Только после успешной онлайн-проверки временный сбой словаря
294
+ может использовать проверенное последнее исправное поколение в пределах
295
+ `GODD_REGISTRY_CACHE_MAX_AGE_DAYS` (по умолчанию 30 дней), но только при недоступности
296
+ endpoint. Некорректный успешный ответ, подмена источника, откат revision, ответ 401/403,
297
+ HTTP 409 `LEXICON_INTEGRITY_FAILURE`, просроченный или изменённый кэш и отсутствие кэша
298
+ останавливают запуск. Обрыв потока считается недоступностью, а превышение лимита —
299
+ фатальной ошибкой; revision — каноническое ненулевое десятичное u64.
300
+ 15-секундный deadline охватывает заголовки и полное bounded body. Независимого
301
+ доверенного high-water anchor нет: CAS отклоняет одновременную устаревшую запись, но не
302
+ обнаруживает восстановление старого целиком подлинного файла кэша. Max-age лишь
303
+ ограничивает это остаточное окно replay.
304
+
259
305
  ### Установка
260
306
 
261
307
  ```bash
@@ -315,7 +361,7 @@ godd-a init
315
361
  | `slide` | Генерация слайдов из документов проекта (формат Marp Markdown) |
316
362
  | `design` | Генерация/обновление визуального дизайна из кодовой базы (синхронизация Pencil.dev) |
317
363
  | `metrics` | Эффективность токенов и необязательная оценка качества, бюджета, обучения и предварительной проверки guardrail по доказательствам |
318
- | `plan` | Пошаговое выполнение утверждённого плана с сохраняемым состоянием и проверкой тестов |
364
+ | `plan` | Ограниченное выполнение утверждённых планов с устойчивым жизненным циклом, наблюдаемыми сохранёнными сроками, двухфазной отменой и детерминированным обзором |
319
365
 
320
366
  Машиночитаемая версия этой таблицы опубликована по адресу
321
367
  [getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json); руководство
@@ -1 +1 @@
1
- 8aacfe997c596e748870a564bc48b293564725cddeebbe9609528e3fe5c4e757
1
+ 888314c83f683b046ffeb5d435fe4c5bf9dbd6e9ae99d195115819470ceb158f
@@ -1 +1 @@
1
- 0fd114374d43c712bcb67162d18baf5f0ac20b8800c9e10353c7425ffd8d5d42
1
+ 4d10c47b1d89453cc59b7f3fe1a0f9daaf37028c3fe0e439001683ebb1120e54
@@ -1 +1 @@
1
- 8acb6f141ca282c3198e6470679baf87778ec28922592884e3fe2398cfee1d83
1
+ 21981d8a64fab65ea417a25dac723023141cd7d7ef3451bc9185091962f0d444
@@ -1 +1 @@
1
- 9944a786643f1053483bcb18a4b1c79f6f05de01c61895460e9be592b29ee1d9
1
+ 1fa0134854121765257c8bf6ef419e23e6d575068f8bbb902fd79cf1418defa4