@autodevjapan/godd-mcp-alpha 2.14.1 → 2.15.1

package/README.md

@@ -6,7 +6,7 @@
 
 <p align="center"><strong>Govern AI development from intent to verified, shippable code.</strong></p>
 
-<p align="center"><a href="https://www.getgodd.dev/">Official site</a> · <a href="https://www.getgodd.dev/pricing">Plans</a> · <a href="https://www.getgodd.dev/godd-admin/register">Get started</a></p>
+<p align="center"><a href="https://www.getgodd.dev/">Official site</a> · <a href="https://www.getgodd.dev/en/docs">Docs</a> · <a href="https://www.getgodd.dev/en/pricing">Plans</a> · <a href="https://www.getgodd.dev/godd-admin/register">Get started</a></p>
 
 [🇺🇸 English](#english) | [🇯🇵 日本語](#日本語) | [🇷🇺 Русский](#русский)
 
@@ -14,669 +14,118 @@
 
 ## English
 
-**GoDD turns natural-language intent into specifications, tested code, reviews, documentation, and shippable pull requests.** Its governed workflows run inside Cursor IDE, Claude Code CLI, Codex, Kimi CLI, and Google Antigravity IDE over the Model Context Protocol (MCP).
+**Say what you want in plain language. GoDD runs the whole cycle — plan → implement → test → review → document → ship.** It works inside Cursor, Claude Code, Codex, Kimi CLI, and Antigravity over the Model Context Protocol.
 
-### Why use GoDD
+### Why GoDD
 
-- **Ship higher-quality code faster.** Every prompt is built on seven proven xDD methodologies (Spec / Acceptance-Test / Test / Domain / Neo-Model / Docs / Issue-Driven Development), so the AI plans, tests, and documents like a senior engineer instead of guessing.
-- **One command per task.** Call `/dev`, `/review`, `/ship`, and more — the AI runs the full plan → implement → test → quality → docs cycle for you.
-- **Fewer tokens, lower cost.** Prompts are delivered **on demand** — only the one you invoke enters the AI's context. That is typically ~2,000–5,000 tokens per call versus ~80,000+ for always-on rule files.
-- **Works with the clients you already use.** The same server registers with every supported client; project settings are auto-detected.
-- **Stays in sync with your stack.** `godd-a init` generates a project profile so delivered prompts match your language, framework, and tooling.
+- **~2,000–5,000 tokens per call instead of ~80,000+.** Prompts are delivered **on demand** — only the one you invoke enters context. Always-on rule files burn your context window before you even type.
+- **Your AI stops guessing.** Every prompt is built on seven proven xDD methodologies (Spec / Acceptance-Test / Test / Domain / Neo-Model / Docs / Issue-Driven Development), so it plans, tests, and documents like a senior engineer.
+- **One command does the whole job.** `/dev`, `/review`, `/ship` each run a complete cycle — not a single step you have to babysit.
+- **It knows your stack.** `godd-a init` profiles your language, framework, and tooling, and delivered prompts adapt to it.
+- **No migration.** One server registers with every client you already use.
 
-### Requirements
-
-- **A GoDD license key** (required — see [Getting a license key](#getting-a-license-key))
-- Node.js 22+
-- An MCP-compatible client: Cursor IDE, Claude Code CLI, Codex, Kimi CLI, or Antigravity IDE
-
-### Getting a license key
-
-A valid license key is required to use GoDD MCP.
-
-1. Review plans on the [GoDD official site](https://www.getgodd.dev/pricing)
-2. [Create an account](https://www.getgodd.dev/godd-admin/register) and choose a subscription
-3. Issue a license key from your [dashboard](https://www.getgodd.dev/godd-admin/dashboard)
-
-### Startup and offline behavior
-
-GoDD validates the license online every time the MCP server starts. There is no offline
-license grace period: a timeout, connection failure, server error, or rejected license stops
-startup. After that online validation succeeds, a temporary lexicon outage can use a
-digest- and MAC-verified last-known-good generation within
-`GODD_REGISTRY_CACHE_MAX_AGE_DAYS` (30 days by default). Fallback is limited to endpoint
-unavailability. Any successful but invalid/oversize response, source mismatch, revision
-rollback, bounded HTTP 409 `LEXICON_INTEGRITY_FAILURE`, 401/403, expired or modified
-cache, or missing cache stops startup. A mid-stream disconnect is unavailable and may
-use LKG; an oversized stream is fatal. The same 15-second deadline covers headers and
-the complete bounded body. Revisions are canonical nonzero u64 decimals.
-The cache has no independent trusted high-water anchor: CAS rejects concurrent stale
-writes, but cannot detect restoration of an older wholly authentic cache file. The
-max-age ceiling only bounds that residual replay window.
-
-### Installation
+### Install
 
 ```bash
 npm install -g @autodevjapan/godd-mcp-alpha
+godd-a install   # auto-detect your MCP clients and register with each
+godd-a init      # generate a project profile
 ```
 
-### Setup
-
-```bash
-# Auto-detect installed MCP clients and register with each of them
-godd-a install --license-key=YOUR_LICENSE_KEY
-
-# Or target one client: cursor / claude-code / codex / kimi / antigravity / all
-godd-a install --client=cursor --license-key=YOUR_LICENSE_KEY
-
-# Generate a project config (interactive; add --auto for CI/CD)
-godd-a init
-```
-
-`godd-a init` and the MCP `config` tool also use the Rust native anchored filesystem boundary to atomically synchronize a marker-scoped block in the project-root `.gitignore` for GoDD's local artifacts. Existing rules outside that block are preserved. If the markers are malformed, the target is a symlink/non-regular file, the lock is busy, I/O fails, or the native process exceeds its 15-second timeout, GoDD leaves the file untouched and fails init/config with a stable error code. Only already tracked files produce a non-fatal `GODD_GITIGNORE_TRACKED_FILES` warning; GoDD never runs `git rm` automatically.
-
-If `GODD_GITIGNORE_LOCKED` persists, first confirm that no init/config process is running, then remove only `.godd/managed-gitignore.lock` and retry. Do not remove the entire `.godd` directory or change the Git index.
-
-> Use `godd-a install` — it configures the startup command, PATH, and license key for you. Restart your client afterward and the GoDD tools appear automatically.
-
-`godd_files.docs_dir` in `config.godd` selects the single repository-relative root for specs, ADRs, diagrams, and guides (default: `documents`). Always write it as a YAML double-quoted scalar (for example, `docs_dir: "docs"`) so valid names such as `true`, `null`, and `123` remain strings. Use `/` separators; each segment accepts only Unicode letters/numbers and `._-`. Empty values, absolute paths, backslashes, shell-expansion characters, trailing dots, `.` / `..` segments, and Windows reserved device names (including extensions and NFKC-compatible forms such as `COM¹`) are rejected. The configured value is also supplied to Registry-rendered prompts, so GoDD does not create a second documentation root.
-
-### Usage
-
-Invoke GoDD in whichever way your client supports:
-
-- **Native UI** — type `/` in the chat and pick a GoDD prompt (e.g. `/dev`, `/review`), or in Agent mode just ask ("run dev", "do a review").
-- **Slash commands** — `godd-a install` writes `/godd-a-<tool>` command files for clients that support them (Cursor, Claude Code, Codex, Antigravity).
-- **Text dispatch** — type `/godd-a/dev <args>` as plain text; the AI routes it to the matching tool.
-
-### Audio adapter contract
-
-Adapter implementers can import the side-effect-free, typed npm subpath:
-
-```ts
-import { validateAudioLengthAdapterContract } from "@autodevjapan/godd-mcp-alpha/audio-length-adapter-contract";
-```
-
-The contract preserves waveform/mel inputs and PCM16 WAV output. Padding, frame, and trim arithmetic remain Rust-owned and are rejected if duplicated in the Node payload. This validates the adapter boundary only; it does not expose a production inference route.
+Then type `/` in your client and pick a GoDD prompt — or just ask ("run dev", "do a review").
 
-### Media interval adapter contract
+### Requirements
 
-Use the typed npm subpath to validate an untrusted adapter envelope, forward its transformation specification unchanged, and verify the calibration snapshot before using its default tolerance:
+Node.js 22+ · an MCP client (Cursor / Claude Code / Codex / Kimi CLI / Antigravity) · a license key.
 
-```ts
-import {
-  forwardMediaIntervalTransformation,
-  loadMediaIntervalCalibrationSnapshot,
-  validateMediaIntervalAdapterContract,
-} from "@autodevjapan/godd-mcp-alpha/media-interval-adapter-contract";
+The server validates your license online at every startup — there is no offline grace period.
 
-const contract = validateMediaIntervalAdapterContract(adapterPayload);
-const transformation = forwardMediaIntervalTransformation(contract);
-const calibration = loadMediaIntervalCalibrationSnapshot();
-if (calibration.status === "INCONCLUSIVE") {
-  throw new Error("Media interval calibration could not be verified");
-}
-```
+### Everything else
 
-The loader verifies the official content-addressed snapshot embedded in this subpath; consumers do not need to locate a separate JSON asset. Node validates and forwards the envelope only. Interval arithmetic, canonical union coverage, coverage decisions, and source-buffer application remain Rust-owned and must not be duplicated in the adapter payload. An unsupported schema, unknown nested field, insufficient sample count, invalid metadata, or digest mismatch returns `INCONCLUSIVE` with no numeric fallback; callers must stop instead of inventing a default tolerance. This subpath does not expose a production media-processing route.
-
-### GoDD prompts
-
-| Prompt | Description |
-|---|---|
-| `run` | Unified entry point — parses a text command like "/godd-a/<tool> <args>" and runs the matching tool |
-| `dev` | Development (plan → implement → test → quality → docs in stages) |
-| `check` | Quality gate (verify Spec alignment, tests, types, lint, security) |
-| `docs` | Generate/update documentation |
-| `ship` | Ship (commit at proper granularity → quality check → push → create PR) |
-| `setup` | Environment setup (with recommended stack presets, confirms missing info) |
-| `review` | Review (CTO-level review + quality gate) |
-| `test` | Run/create tests |
-| `impact` | Impact analysis |
-| `commit` | Commit changes |
-| `push` | Push to remote |
-| `pr` | Create PR (template-compliant) |
-| `deploy` | Deploy (with verification & rollback plan) |
-| `adr` | Create ADR (Architecture Decision Record) |
-| `release` | Generate release notes (SemVer-compliant) |
-| `github` | GitHub configuration (repository/branch protection, etc.) |
-| `config` | Generate/repair config.godd (auto-detect stack + validation) |
-| `questions` | Interactive Q&A from question list (質問リスト.md) |
-| `e2e` | Browser-based E2E testing (execute & verify critical user flows) |
-| `map` | Project knowledge graph (visualize architecture & dependencies with Mermaid) |
-| `learn` | Save/recall project-specific patterns, conventions, and pitfalls |
-| `scratchpad` | Persistent conversation memory — save/recall/search/list/forget with BM25 vector search (Qdrant or local JSON fallback) |
-| `diagram` | Auto-update architecture diagrams (maintain living Mermaid docs in sync with code) |
-| `slide` | Generate presentation slides from project docs (Marp Markdown format) |
-| `design` | Generate/update visual designs from codebase (Pencil.dev sync) |
-| `metrics` | Token efficiency and optional evidence-based quality, budget, learning outcome, and guardrail preflight report |
-| `plan` | Run bounded approved plans with durable lifecycle, observable persisted deadlines, two-phase cancellation, and deterministic review |
-
-The machine-readable version of this table is published at
-[getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json); the agent
-onboarding guide lives at [getgodd.dev/connect.md](https://getgodd.dev/connect.md).
-
-### CLI commands
-
-| Command | Description |
-|---|---|
-| `godd-a install [--license-key=KEY] [--client=...]` | Register with MCP clients (auto-detects installed clients when `--client` is omitted) |
-| `godd-a init [--force] [--lang=LANG] [--auto]` | Generate the project config |
-| `godd-a uninstall [--client=...]` | Remove from MCP clients |
-| `godd-a version` (or `--version` / `-v`) | Show the installed version and check for updates |
-| `godd-a serve` | Start the MCP stdio server (auto-invoked by the client) |
-| `godd-a shard partition <plan|lease|report|expire|abandon|status>` | Manage a Rust-native shard plan that prevents missing or duplicate sequences |
-| `godd-a realtime admission --evaluated-at-ms <u64>` | Evaluate one bounded event envelope from stdin with fail-closed ALLOW/DENY/INCONCLUSIVE receipts |
-| `godd-a dataset coverage --ledger <path>` | Persist CAS-issued sample attempts and bounded coverage from one strict JSON stdin action using the trusted system clock |
-
-Start a shard workflow with
-`plan --state-dir <dir> --source-root <dir> --selector 1/M`; it creates an immutable
-plan for every shard and a fully pre-seeded ledger. A worker calls
-`lease --state-dir <dir> --selector N/M --ttl-ms <ms>` and uses the returned
-`assigned_ids` and digest instead of enumerating the source root again. Send the worker's
-completion report as one JSON document on stdin to `report --state-dir <dir>`. Use
-`expire --state-dir <dir>` to sweep expired leases,
-`abandon --state-dir <dir> --selector N/M` to abandon one explicitly,
-`lease ... --takeover` to reassign it, and `status --state-dir <dir>` to read aggregate state.
-The npm CLI only forwards this wire protocol to the packaged Rust command. Each successful
-action writes exactly one JSON document to stdout and exits 0; invalid input or state,
-persistence failure, and conflicts write only a stable `PARTITION_*` reason code to stderr
-and exit 2.
-
-Plaintext `assigned_ids` appear only in a lease response. Diagnostics never include sequence
-IDs or host paths. Lease responses and `status` return the current `ledger_revision`; an
-accepted report receipt returns the next revision. Copy `plan_generation`,
-`reporting_shard_index`, and `lease_generation` from the lease response into the report JSON,
-and set `expected_ledger_revision` from the latest receipt or `status`. Do not convert
-`PARTITION_CAS_MISMATCH` into success: fetch `status` again and reevaluate the report.
-The strict report body has this shape; `expected_state` is one of `assigned`, `completed`,
-`rejected`, or `missing`, while `outcome` is `completed` or `rejected`:
-
-```json
-{
-  "plan_generation": {
-    "source_generation": "<64 lowercase hex>",
-    "expected_set_digest": "<64 lowercase hex>"
-  },
-  "sequence_id": "<one assigned_ids value>",
-  "reporting_shard_index": 1,
-  "lease_generation": 1,
-  "expected_state": "assigned",
-  "expected_ledger_revision": 0,
-  "outcome": "completed"
-}
-```
+The full tool list, CLI reference, and troubleshooting live on the **[documentation site](https://www.getgodd.dev/en/docs)**.
 
-Realtime envelopes accept identifiers only as field-specific lowercase digests:
-`principal:sha256:<hex64>`, `resource:sha256:<hex64>`, and `evidence:sha256:<hex64>`.
-Raw tokens, cookies, user names, and socket IDs are rejected without being echoed.
-
-Dataset coverage accepts exactly one strict JSON action: `initialize`, `issue`, `report`,
-`sweep`, or `finalize`. `initialize` preregisters the generation, assigned/expected sample
-sets, retry policy, coverage thresholds and both declared digests, plus the replacement policy
-(`forbidden`; `within_assigned_set` is reserved and rejected in Stage 2). `issue` takes `canonical_sample_id` and
-`requested_position`; `report` adds an issued `attempt` and a typed outcome (`Accepted`,
-`Rejected`, `TimedOut`, `Cancelled`, or `InfrastructureFailed`); `sweep` has no payload;
-`finalize` must repeat the preregistered thresholds, digests, and replacement policy exactly.
-Retry exhaustion atomically appends a `TerminalDecision`; load rejects any missing, duplicate, or
-tampered terminal-event projection.
-The usual flow is initialize → issue → report (repeat) → sweep/finalize. Success writes one JSON
-receipt and exits 0. Invalid JSON/state, persistence failure, or a conflict writes only a stable
-reason-code envelope to stderr and exits 2. Coverage receipts bind the generation source,
-threshold/expected-set, ledger/event-head, and full durable-snapshot digests, finalized event sequence,
-failure-attempt counts by class, and at most 32 stable opaque terminal-failure fingerprints;
-raw sample IDs are never returned.
-The parent directory of `--ledger` must already exist; the command never creates path components.
-
-### Troubleshooting
-
-**"0 tools available" in your client** — this means the server was started without the required `serve` argument. Re-run `godd-a install` to regenerate the client config correctly, then restart the client.
+Writing an adapter? All three subpath contracts (media interval / audio length / compile cache) ship with the package at `docs/adapter-contracts.md`.
 
 ### License
 
-Proprietary. Use requires a valid GoDD license key. See the [official site](https://www.getgodd.dev/) for terms and support.
+Proprietary. A valid license key is required — [see plans](https://www.getgodd.dev/en/pricing).
 
 ---
 
 ## 日本語
 
-**GoDD は自然言語の依頼を、仕様・テスト済みコード・レビュー・ドキュメント・出荷可能な Pull Request へ変換します。** 統制されたワークフローを Cursor IDE / Claude Code CLI / Codex / Kimi CLI / Google Antigravity IDE へ、MCP（Model Context Protocol）経由で届けます。
-
-### GoDD を使うメリット
-
-- **より高品質なコードを、より速く。** すべてのプロンプトは実証済みの 7 つの xDD 手法（Spec / 受入テスト / テスト / ドメイン / Neo-Model / ドキュメント / Issue 駆動開発）に基づいており、AI が推測ではなくシニアエンジニアのように計画・テスト・文書化します。
-- **1 タスク = 1 コマンド。** `/dev` `/review` `/ship` などを呼ぶだけで、計画 → 実装 → テスト → 品質 → ドキュメントの一連のサイクルを AI が実行します。
-- **トークン削減でコストも低減。** プロンプトは**オンデマンド配信** — 呼び出したものだけが AI のコンテキストに入ります。常時読み込み型のルールファイルが 1 タスク ~80,000 トークン以上かかるのに対し、GoDD は 1 呼び出しあたり ~2,000〜5,000 トークン程度です。
-- **今お使いのクライアントでそのまま。** 同じサーバーが対応クライアントすべてに登録でき、プロジェクト設定は自動検出されます。
-- **スタックに追従。** `godd-a init` がプロジェクトプロファイルを生成し、配信されるプロンプトが言語・フレームワーク・ツールに合わせて最適化されます。
-
-### 動作要件
+**やりたいことを自然言語で言うだけ。GoDD が 設計 → 実装 → テスト → レビュー → ドキュメント → 出荷 まで一気通貫で回します。** Cursor / Claude Code / Codex / Kimi CLI / Antigravity の中で、MCP 経由で動きます。
 
-- **GoDD ライセンスキー**（必須 — [ライセンスキーの取得](#ライセンスキーの取得)を参照）
-- Node.js 22 以上
-- MCP 対応クライアント: Cursor IDE / Claude Code CLI / Codex / Kimi CLI / Antigravity IDE のいずれか
+### GoDD の強み
 
-### ライセンスキーの取得
-
-GoDD MCP の利用には有効なライセンスキーが必要です。
-
-1. [GoDD 公式サイト](https://www.getgodd.dev/pricing)でプランを確認
-2. [アカウント登録](https://www.getgodd.dev/godd-admin/register)してサブスクリプションを選択
-3. [ダッシュボード](https://www.getgodd.dev/godd-admin/dashboard)からライセンスキーを発行
-
-### 起動とオフライン時の動作
-
-MCP server は起動のたびに license をオンライン検証します。offline の猶予期間はなく、
-timeout、接続失敗、server error、license 拒否では起動しません。今回のオンライン検証が
-成功した後に限り、lexicon の一時障害では digest/MAC 検証済みの最終正常世代を
-`GODD_REGISTRY_CACHE_MAX_AGE_DAYS`（既定30日）以内で利用します。縮退はendpoint
-unavailable時だけです。成功応答の不正・oversize、source不一致、revision rollback、
-HTTP 409 `LEXICON_INTEGRITY_FAILURE`、401/403、期限切れ・改ざんcache、cache不在では
-起動を拒否します。stream途中切断はunavailable、上限超過はfatalです。revisionは
-nonzero u64 decimalに限定し、同じ15秒deadlineをheadersからbody完読まで強制します。
-独立したtrusted high-water anchorはないため、CASは
-同時stale writeを拒否しても過去の正規cache file全体の復元を検出できません。
-max-age ceilingはこの残存replay windowを上限化するだけです。
+- **1 回あたり約 2,000〜5,000 トークン。常時読み込み型なら約 80,000 以上。** プロンプトは**オンデマンド配信**で、呼び出したものだけがコンテキストに入ります。常時適用のルールファイルは、入力する前からコンテキストを食い潰します。
+- **AI が「当てずっぽう」をやめます。** すべてのプロンプトが 7 つの xDD（Spec / ATDD / Test / DDD / Neo-MDD / Docs / Issue Driven Development）を土台にしており、シニアエンジニアと同じ順序で設計・テスト・文書化します。
+- **1 コマンドで一通り終わります。** `/dev`・`/review`・`/ship` はそれぞれが完結したサイクルで、逐一面倒を見る必要がありません。
+- **あなたのスタックを理解します。** `godd-a init` が言語・フレームワーク・ツールチェーンを判定し、配信されるプロンプトがそれに合わせて変わります。
+- **乗り換え不要。** 1 つのサーバーが、今使っているクライアント全てに登録されます。
 
 ### インストール
 
 ```bash
 npm install -g @autodevjapan/godd-mcp-alpha
+godd-a install   # インストール済みの MCP クライアントを自動検出して登録
+godd-a init      # プロジェクト設定を生成
 ```
 
-### セットアップ
-
-```bash
-# インストール済みの MCP クライアントを自動検出し、全てに登録
-godd-a install --license-key=YOUR_LICENSE_KEY
-
-# 特定のクライアントを指定: cursor / claude-code / codex / kimi / antigravity / all
-godd-a install --client=cursor --license-key=YOUR_LICENSE_KEY
-
-# プロジェクト設定を生成（インタラクティブ。CI/CD 用は --auto）
-godd-a init
-```
-
-`godd-a init` と MCP の `config` ツールは、Rust native の anchored filesystem 境界を使って、プロジェクトルートの `.gitignore` に GoDD のローカル成果物用マーカーブロックも atomic に同期します。ブロック外の既存ルールは保持されます。マーカー不正、symlink/非通常ファイル、lock競合、I/O 失敗、native process の15秒 timeout時はファイルを変更せず、安定したエラーコードで init/config を失敗させます。すでに追跡済みのファイルだけは非致命的な `GODD_GITIGNORE_TRACKED_FILES` 警告となり、GoDD が自動で `git rm` を実行することはありません。
+あとはクライアントで `/` を打って GoDD のプロンプトを選ぶだけ。「dev して」「レビューして」と話しかけても動きます。
 
-`GODD_GITIGNORE_LOCKED` が継続する場合は、実行中の init/config がないことを確認してから `.godd/managed-gitignore.lock` だけを削除して再実行してください。`.godd` 全体や Git index は変更しないでください。
-
-> `godd-a install` を使ってください — 起動コマンド・PATH・ライセンスキーを自動で設定します。実行後にクライアントを再起動すると、GoDD ツールが自動的に表示されます。
-
-`config.godd` の `godd_files.docs_dir` で、仕様・ADR・図・ガイドを置く単一のリポジトリ相対ルートを選択できます（既定: `documents`）。`true`、`null`、`123`のような合法名も文字列のまま保持するため、必ずYAMLの二重引用符で囲んでください（例: `docs_dir: "docs"`）。`/` 区切りで指定し、各セグメントには Unicode の文字・数字と `._-` だけを使用します。空値、絶対パス、バックスラッシュ、shell 展開文字、末尾の`.`、`.` / `..` セグメント、Windows予約device名（拡張子付きや`COM¹`のようなNFKC互換形も含む）は拒否されます。この設定は Registry で描画されるプロンプトにも渡るため、GoDD が別のドキュメントルートを作ることはありません。
-
-### 使い方
-
-クライアントが対応している方法で GoDD を呼び出せます。
-
-- **ネイティブ UI** — チャットで `/` を入力して GoDD プロンプト（`/dev`, `/review` など）を選択、または Agent モードで自然文で依頼（「dev を実行」「レビューして」）。
-- **スラッシュコマンド** — `godd-a install` が対応クライアント（Cursor / Claude Code / Codex / Antigravity）に `/godd-a-<tool>` コマンドファイルを生成します。
-- **テキストディスパッチ** — チャットに `/godd-a/dev <args>` と入力すると、AI が対応ツールに振り分けます。
-
-### Audio adapter contract
-
-adapter実装者は、副作用のない型付きnpm subpathを利用できます。
-
-```ts
-import { validateAudioLengthAdapterContract } from "@autodevjapan/godd-mcp-alpha/audio-length-adapter-contract";
-```
-
-このcontractはwaveform/mel入力とPCM16 WAV出力を固定します。padding・frame・trimの算術はRustだけが所有し、Node payloadへの複製を拒否します。これはadapter境界の検証用であり、production inference routeを公開するものではありません。
-
-### Media interval adapter contract
+### 動作要件
 
-型付きnpm subpathで未信頼のadapter envelopeを検証し、変換指定を変更せず転送します。既定の許容値を使う前にcalibration snapshotも検証してください。
+Node.js 22+ ・ MCP クライアント（Cursor / Claude Code / Codex / Kimi CLI / Antigravity）・ライセンスキー。
 
-```ts
-import {
-  forwardMediaIntervalTransformation,
-  loadMediaIntervalCalibrationSnapshot,
-  validateMediaIntervalAdapterContract,
-} from "@autodevjapan/godd-mcp-alpha/media-interval-adapter-contract";
+ライセンスは MCP サーバー起動のたびにオンラインで検証します。オフライン猶予期間はありません。
 
-const contract = validateMediaIntervalAdapterContract(adapterPayload);
-const transformation = forwardMediaIntervalTransformation(contract);
-const calibration = loadMediaIntervalCalibrationSnapshot();
-if (calibration.status === "INCONCLUSIVE") {
-  throw new Error("Media interval calibrationを検証できませんでした");
-}
-```
+### その他
 
-loaderはこのsubpathへ埋め込まれた公式content-addressed snapshotを検証するため、consumerが別のJSON assetを探す必要はありません。Nodeが所有するのはenvelopeの検証と透過転送だけです。区間算術、canonical union coverage、coverage判定、source bufferへの適用はRustだけが所有し、adapter payloadへ複製してはいけません。未対応schema、未知のnested field、標本数不足、不正なmetadata、digest不一致では数値へfallbackせず`INCONCLUSIVE`を返すため、callerは既定値を推測せず処理を停止してください。このsubpathはproduction media-processing routeを公開しません。
-
-### GoDD プロンプト
-
-| プロンプト | 説明 |
-|---|---|
-| `run` | 統一エントリポイント — "/godd-a/<tool> <args>" 形式のテキストコマンドをパースして対応ツールを実行 |
-| `dev` | 開発（段階的に計画→実装→テスト→品質→ドキュメントを実行） |
-| `check` | 品質ゲート（Spec整合・テスト・型・Lint・セキュリティを検証） |
-| `docs` | ドキュメント生成/更新 |
-| `ship` | 提出（適切な粒度でコミット → 品質チェック → プッシュ → PR 作成） |
-| `setup` | 環境構築（推奨スタックプリセット付き・不足情報は確認） |
-| `review` | レビュー（CTO レベルのレビュー + 品質ゲート） |
-| `test` | テスト実行/作成 |
-| `impact` | 影響分析 |
-| `commit` | 変更をコミット |
-| `push` | リモートにプッシュ |
-| `pr` | PR 作成（テンプレート準拠） |
-| `deploy` | デプロイ（検証・ロールバック計画付き） |
-| `adr` | ADR（Architecture Decision Record）作成 |
-| `release` | リリースノート生成（SemVer 準拠） |
-| `github` | GitHub 設定（リポジトリ/ブランチ保護等） |
-| `config` | config.godd を正確に生成・修正する（スタック自動検出 + バリデーション） |
-| `questions` | 質問リスト（質問リスト.md）からインタラクティブに質問を管理 |
-| `e2e` | ブラウザベース E2E テスト（重要ユーザーフローの実行・検証） |
-| `map` | プロジェクトナレッジグラフ（Mermaid でアーキテクチャ・依存関係を可視化） |
-| `learn` | プロジェクト固有のパターン・慣例・落とし穴を保存/参照 |
-| `scratchpad` | 会話記憶の永続化 — BM25 ベクター検索で save/recall/search/list/forget（Qdrant またはローカル JSON フォールバック） |
-| `diagram` | アーキテクチャ図の自動更新（コードと同期した Mermaid ドキュメントを維持） |
-| `slide` | プロジェクトドキュメントからプレゼンスライドを生成（Marp Markdown 形式） |
-| `design` | コードベースからビジュアルデザインを生成/更新（Pencil.dev 同期） |
-| `metrics` | トークン効率と、任意の証拠に基づく品質・予算・学習成果・guardrail preflightレポート |
-| `plan` | 承認済み計画を有界な永続 lifecycle、観測可能な永続 deadline、二相 cancel、決定的 review 付きで実行する |
-
-この表の機械可読版は
-[getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json) に公開しています。
-エージェント向けの接続手順は [getgodd.dev/connect.md](https://getgodd.dev/connect.md) を参照してください。
-
-### CLI コマンド
-
-| コマンド | 説明 |
-|---|---|
-| `godd-a install [--license-key=KEY] [--client=...]` | MCP クライアントに登録（`--client` 省略時はインストール済みを自動検出） |
-| `godd-a init [--force] [--lang=LANG] [--auto]` | プロジェクト設定を生成 |
-| `godd-a uninstall [--client=...]` | MCP クライアントから削除 |
-| `godd-a version`（または `--version` / `-v`） | インストール済みバージョンの表示と更新確認 |
-| `godd-a serve` | MCP stdio サーバーを起動（クライアントが自動呼び出し） |
-| `godd-a shard partition <plan|lease|report|expire|abandon|status>` | sequence集合の欠落・重複を防ぐRust native shard planを管理 |
-| `godd-a realtime admission --evaluated-at-ms <u64>` | stdinのbounded event envelopeをfail-closedな3値receiptとして評価 |
-| `godd-a dataset coverage --ledger <path>` | trusted system clockとstrict JSON action 1件からCAS払い出しsample attemptとbounded coverageを永続化 |
-
-Shard plan は、最初に `plan --state-dir <dir> --source-root <dir> --selector 1/M`
-で全 shard の immutable plan と全件 pre-seed ledger を作成します。worker は
-`lease --state-dir <dir> --selector N/M --ttl-ms <ms>` の応答に含まれる
-`assigned_ids` と digest を使用し、source root を再列挙しません。worker の完了報告は
-`report --state-dir <dir>` の stdin に JSON で渡します。期限監視は
-`expire --state-dir <dir>`、明示的放棄は
-`abandon --state-dir <dir> --selector N/M`、再割当は `lease ... --takeover`、集約状態は
-`status --state-dir <dir>` で確認します。npm CLI はこの wire protocol を packaged Rust
-command へ中継するだけです。成功した各 action は stdout へ JSON 1件を出して exit 0、
-不正な入力・状態、永続化失敗、競合は stderr へ安定した `PARTITION_*` reason codeだけを
-出して exit 2 です。
-
-平文の `assigned_ids` は lease response だけに含まれます。診断には sequence ID や
-host path は出力されません。
-lease応答と`status`は現在の`ledger_revision`を返し、accepted report receiptは次の
-revisionを返します。report JSONの`plan_generation`、`reporting_shard_index`、
-`lease_generation`はlease応答から、`expected_ledger_revision`は直前のreceiptまたは
-`status`から渡します。競合時は`PARTITION_CAS_MISMATCH`を成功へ変換せず、statusを
-再取得して再評価してください。
-strict report body は次の形です。`expected_state` は `assigned` / `completed` /
-`rejected` / `missing`、`outcome` は `completed` / `rejected` のいずれかです。
-
-```json
-{
-  "plan_generation": {
-    "source_generation": "<64 lowercase hex>",
-    "expected_set_digest": "<64 lowercase hex>"
-  },
-  "sequence_id": "<one assigned_ids value>",
-  "reporting_shard_index": 1,
-  "lease_generation": 1,
-  "expected_state": "assigned",
-  "expected_ledger_revision": 0,
-  "outcome": "completed"
-}
-```
+ツール一覧・CLI リファレンス・トラブルシューティングは **[ドキュメントサイト](https://www.getgodd.dev/docs)** にまとまっています。
 
-Realtime envelopeの識別子はfield別lowercase digest
-（`principal:sha256:<hex64>`、`resource:sha256:<hex64>`、`evidence:sha256:<hex64>`）
-だけを受理します。生token、cookie、ユーザー名、socket IDは表示せず拒否します。
-
-Dataset coverage は strict JSON の `initialize` / `issue` / `report` / `sweep` /
-`finalize` のいずれか1 actionだけを受理します。`initialize` で generation、割当/期待sample集合、
-retry policy、coverage thresholds、両declared digest、replacement policy
-（Stage 2は`forbidden`のみ。`within_assigned_set`は予約済みで拒否）を事前固定します。`issue` は
-`canonical_sample_id` と `requested_position`、`report` は発行済み `attempt` と型付きoutcome
-（`Accepted` / `Rejected` / `TimedOut` / `Cancelled` / `InfrastructureFailed`）を受け取り、
-`sweep` はpayloadなし、`finalize` は事前固定したthresholds・digests・policyとの完全一致を要求します。
-retry exhaustion時は`TerminalDecision`を原子的にappendし、欠落・重複・改変されたterminal projectionはloadで拒否します。
-典型フローは initialize → issue → report（反復）→ sweep/finalize です。成功はJSON receiptを
-stdoutへ1件出してexit 0、不正JSON/state・永続化失敗・conflictは秘密値を含まない安定reason codeを
-stderrへ出してexit 2です。Coverage receiptはgeneration source、threshold/expected-set digest、
-ledger/event-head/full durable-snapshot digest、finalized event sequence、failure class別attempt件数、最大32件の安定した
-終局failure fingerprintを束縛し、raw sample IDは返しません。
-`--ledger`の親directoryは事前作成が必要で、command自身はpath componentを作成しません。
-
-### トラブルシューティング
-
-**クライアントに「0 tools available」と表示される** — サーバーが必須の `serve` 引数なしで起動されています。`godd-a install` を再実行してクライアント設定を正しく再生成し、クライアントを再起動してください。
+アダプターを実装する場合、3 つの subpath 契約（media interval / audio length / compile cache）はパッケージ同梱の `docs/adapter-contracts.md` にあります。
 
 ### ライセンス
 
-商用（プロプライエタリ）。利用には有効な GoDD ライセンスキーが必要です。利用条件・サポートは[公式サイト](https://www.getgodd.dev/)をご覧ください。
+商用ライセンス。利用にはライセンスキーが必要です — [プランを見る](https://www.getgodd.dev/pricing)。
 
 ---
 
 ## Русский
 
-**GoDD превращает запрос на естественном языке в спецификации, протестированный код, ревью, документацию и готовые к выпуску pull request.** Управляемые рабочие процессы доступны в Cursor IDE, Claude Code CLI, Codex, Kimi CLI и Google Antigravity IDE через MCP (Model Context Protocol).
-
-### Зачем использовать GoDD
-
-- **Более качественный код быстрее.** Каждый промпт построен на семи проверенных методологиях xDD (Spec / Acceptance-Test / Test / Domain / Neo-Model / Docs / Issue-Driven Development), поэтому AI планирует, тестирует и документирует как senior-инженер, а не гадает.
-- **Одна команда на задачу.** Вызовите `/dev`, `/review`, `/ship` и другие — AI выполнит полный цикл: план → реализация → тесты → качество → документация.
-- **Меньше токенов, ниже стоимость.** Промпты доставляются **по требованию** — в контекст AI попадает только вызванный. Обычно это ~2 000–5 000 токенов на вызов против ~80 000+ у постоянно загружаемых файлов правил.
-- **Работает с вашими клиентами.** Один и тот же сервер регистрируется во всех поддерживаемых клиентах; настройки проекта определяются автоматически.
-- **Синхронизирован с вашим стеком.** `godd-a init` создаёт профиль проекта, чтобы доставляемые промпты соответствовали вашему языку, фреймворку и инструментам.
-
-### Требования
-
-- **Лицензионный ключ GoDD** (обязателен — см. [Получение лицензионного ключа](#получение-лицензионного-ключа))
-- Node.js 22+
-- MCP-совместимый клиент: Cursor IDE, Claude Code CLI, Codex, Kimi CLI или Antigravity IDE
-
-### Получение лицензионного ключа
-
-Для использования GoDD MCP требуется действующий лицензионный ключ.
+**Скажите, что нужно, обычными словами. GoDD проходит весь цикл — план → реализация → тесты → ревью → документация → поставка.** Работает внутри Cursor, Claude Code, Codex, Kimi CLI и Antigravity по протоколу MCP.
 
-1. Ознакомьтесь с тарифами на [официальном сайте GoDD](https://www.getgodd.dev/pricing)
-2. [Создайте аккаунт](https://www.getgodd.dev/godd-admin/register) и выберите подписку
-3. Выпустите лицензионный ключ в [панели управления](https://www.getgodd.dev/godd-admin/dashboard)
+### Почему GoDD
 
-### Запуск и работа без сети
-
-При каждом запуске MCP-сервера лицензия проверяется онлайн. Периода автономной
-отсрочки нет: тайм-аут, ошибка подключения или сервера, а также отклонённая лицензия
-останавливают запуск. Только после успешной онлайн-проверки временный сбой словаря
-может использовать проверенное последнее исправное поколение в пределах
-`GODD_REGISTRY_CACHE_MAX_AGE_DAYS` (по умолчанию 30 дней), но только при недоступности
-endpoint. Некорректный успешный ответ, подмена источника, откат revision, ответ 401/403,
-HTTP 409 `LEXICON_INTEGRITY_FAILURE`, просроченный или изменённый кэш и отсутствие кэша
-останавливают запуск. Обрыв потока считается недоступностью, а превышение лимита —
-фатальной ошибкой; revision — каноническое ненулевое десятичное u64.
-15-секундный deadline охватывает заголовки и полное bounded body. Независимого
-доверенного high-water anchor нет: CAS отклоняет одновременную устаревшую запись, но не
-обнаруживает восстановление старого целиком подлинного файла кэша. Max-age лишь
-ограничивает это остаточное окно replay.
+- **~2 000–5 000 токенов на вызов вместо ~80 000+.** Промпты доставляются **по требованию** — в контекст попадает только вызванный. Постоянно загруженные файлы правил съедают контекст ещё до первого сообщения.
+- **ИИ перестаёт угадывать.** Каждый промпт построен на семи методологиях xDD (Spec / Acceptance-Test / Test / Domain / Neo-Model / Docs / Issue-Driven Development), поэтому он планирует, тестирует и документирует как старший инженер.
+- **Одна команда делает всю работу.** `/dev`, `/review`, `/ship` — каждая запускает полный цикл, а не отдельный шаг.
+- **Он знает ваш стек.** `godd-a init` определяет язык, фреймворк и инструменты, и промпты подстраиваются под них.
+- **Ничего не нужно менять.** Один сервер регистрируется во всех клиентах, которыми вы уже пользуетесь.
 
 ### Установка
 
 ```bash
 npm install -g @autodevjapan/godd-mcp-alpha
+godd-a install   # автообнаружение MCP-клиентов и регистрация в каждом
+godd-a init      # создать профиль проекта
 ```
 
-### Настройка
-
-```bash
-# Автообнаружение установленных MCP-клиентов и регистрация в каждом
-godd-a install --license-key=YOUR_LICENSE_KEY
-
-# Или конкретный клиент: cursor / claude-code / codex / kimi / antigravity / all
-godd-a install --client=cursor --license-key=YOUR_LICENSE_KEY
-
-# Сгенерировать конфигурацию проекта (интерактивно; для CI/CD добавьте --auto)
-godd-a init
-```
-
-`godd-a init` и MCP-инструмент `config` используют закреплённую границу файловой системы Rust native и атомарно синхронизируют ограниченный маркерами блок в корневом `.gitignore` для локальных артефактов GoDD. Правила вне блока сохраняются. При повреждённых маркерах, symlink/необычном файле, занятой блокировке, ошибке ввода-вывода или 15-секундном тайм-ауте native-процесса файл не изменяется, а init/config завершается ошибкой со стабильным кодом. Только уже отслеживаемые файлы дают некритичное предупреждение `GODD_GITIGNORE_TRACKED_FILES`; GoDD никогда не запускает `git rm` автоматически.
-
-Если `GODD_GITIGNORE_LOCKED` повторяется, сначала убедитесь, что init/config не запущен, затем удалите только `.godd/managed-gitignore.lock` и повторите команду. Не удаляйте весь каталог `.godd` и не изменяйте индекс Git.
-
-> Используйте `godd-a install` — он настроит команду запуска, PATH и лицензионный ключ. После этого перезапустите клиент, и инструменты GoDD появятся автоматически.
-
-Параметр `godd_files.docs_dir` в `config.godd` задаёт единый относительный к репозиторию корень для спецификаций, ADR, диаграмм и руководств (по умолчанию `documents`). Всегда записывайте его как строку YAML в двойных кавычках (например, `docs_dir: "docs"`), чтобы допустимые имена `true`, `null` и `123` оставались строками. Используйте разделитель `/`; каждый сегмент допускает только буквы/цифры Unicode и `._-`. Пустые значения, абсолютные пути, обратная косая черта, символы раскрытия shell, завершающие точки, сегменты `.` / `..` и зарезервированные имена устройств Windows (включая расширения и NFKC-совместимые формы вроде `COM¹`) отклоняются. Это значение также передаётся шаблонам Registry, поэтому GoDD не создаёт второй корень документации.
-
-### Использование
+Затем введите `/` в клиенте и выберите промпт GoDD — или просто попросите словами.
 
-Вызывайте GoDD тем способом, который поддерживает ваш клиент:
-
-- **Нативный UI** — введите `/` в чате и выберите промпт GoDD (`/dev`, `/review`), либо в режиме Agent просто попросите («запусти dev», «сделай ревью»).
-- **Slash-команды** — `godd-a install` создаёт файлы команд `/godd-a-<tool>` для клиентов, которые их поддерживают (Cursor, Claude Code, Codex, Antigravity).
-- **Текстовый диспетчер** — введите `/godd-a/dev <args>` как обычный текст; AI направит запрос нужному инструменту.
-
-### Контракт audio adapter
-
-Разработчики адаптеров могут импортировать типизированный npm subpath без побочных эффектов:
-
-```ts
-import { validateAudioLengthAdapterContract } from "@autodevjapan/godd-mcp-alpha/audio-length-adapter-contract";
-```
-
-Контракт фиксирует входы waveform/mel и выход PCM16 WAV. Расчёты padding, frame и trim остаются только в Rust; их дублирование в Node payload отклоняется. Это проверка границы адаптера, а не production inference route.
+### Требования
 
-### Контракт media interval adapter
+Node.js 22+ · MCP-клиент (Cursor / Claude Code / Codex / Kimi CLI / Antigravity) · лицензионный ключ.
 
-Используйте типизированный npm subpath, чтобы проверить недоверенный envelope адаптера, передать спецификацию преобразования без изменений и проверить calibration snapshot до применения допуска по умолчанию:
+Сервер проверяет лицензию онлайн при каждом запуске; офлайн-периода нет.
 
-```ts
-import {
-  forwardMediaIntervalTransformation,
-  loadMediaIntervalCalibrationSnapshot,
-  validateMediaIntervalAdapterContract,
-} from "@autodevjapan/godd-mcp-alpha/media-interval-adapter-contract";
+### Остальное
 
-const contract = validateMediaIntervalAdapterContract(adapterPayload);
-const transformation = forwardMediaIntervalTransformation(contract);
-const calibration = loadMediaIntervalCalibrationSnapshot();
-if (calibration.status === "INCONCLUSIVE") {
-  throw new Error("Не удалось проверить calibration media interval");
-}
-```
-
-Loader проверяет официальный content-addressed snapshot, встроенный в этот subpath, поэтому consumer не требуется искать отдельный JSON asset. Node только проверяет envelope и передаёт его дальше. Расчёт интервалов, canonical union coverage, решение по coverage и применение к source buffer остаются исключительно в Rust и не должны дублироваться в payload адаптера. Неподдерживаемая schema, неизвестное вложенное поле, недостаточный размер выборки, некорректные metadata или несовпадение digest возвращают `INCONCLUSIVE` без числового fallback; вызывающая сторона должна остановиться, а не придумывать допуск по умолчанию. Этот subpath не открывает production route обработки media.
-
-### Промпты GoDD
-
-| Промпт | Описание |
-|---|---|
-| `run` | Единая точка входа — разбирает текстовую команду "/godd-a/<tool> <args>" и запускает соответствующий инструмент |
-| `dev` | Разработка (план → реализация → тесты → качество → документация поэтапно) |
-| `check` | Контроль качества (Spec, тесты, типы, линтер, безопасность) |
-| `docs` | Генерация/обновление документации |
-| `ship` | Отправка (коммит → проверка качества → пуш → создание PR) |
-| `setup` | Настройка среды (с рекомендуемыми пресетами стека) |
-| `review` | Ревью (CTO-уровень + контроль качества) |
-| `test` | Запуск/создание тестов |
-| `impact` | Анализ влияния |
-| `commit` | Зафиксировать изменения |
-| `push` | Отправить в удалённый репозиторий |
-| `pr` | Создать PR (по шаблону) |
-| `deploy` | Развернуть (с проверкой и планом отката) |
-| `adr` | Создать ADR (запись архитектурного решения) |
-| `release` | Сгенерировать заметки к релизу (SemVer) |
-| `github` | Настройка GitHub (репозиторий/защита веток и т.д.) |
-| `config` | Генерация/исправление config.godd (автодетект стека + валидация) |
-| `questions` | Интерактивный Q&A из списка вопросов (質問リスト.md) |
-| `e2e` | E2E-тестирование в браузере (выполнение и проверка критических пользовательских потоков) |
-| `map` | Граф знаний проекта (визуализация архитектуры и зависимостей через Mermaid) |
-| `learn` | Сохранение/вызов специфичных для проекта паттернов, соглашений и подводных камней |
-| `scratchpad` | Постоянная память диалога — save/recall/search/list/forget с BM25 векторным поиском (Qdrant или локальный JSON фоллбэк) |
-| `diagram` | Автообновление архитектурных диаграмм (поддержка актуальных Mermaid-документов) |
-| `slide` | Генерация слайдов из документов проекта (формат Marp Markdown) |
-| `design` | Генерация/обновление визуального дизайна из кодовой базы (синхронизация Pencil.dev) |
-| `metrics` | Эффективность токенов и необязательная оценка качества, бюджета, обучения и предварительной проверки guardrail по доказательствам |
-| `plan` | Ограниченное выполнение утверждённых планов с устойчивым жизненным циклом, наблюдаемыми сохранёнными сроками, двухфазной отменой и детерминированным обзором |
-
-Машиночитаемая версия этой таблицы опубликована по адресу
-[getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json); руководство
-по подключению агента — [getgodd.dev/connect.md](https://getgodd.dev/connect.md).
-
-### Команды CLI
-
-| Команда | Описание |
-|---|---|
-| `godd-a install [--license-key=KEY] [--client=...]` | Регистрация в MCP-клиентах (без `--client` — автообнаружение установленных) |
-| `godd-a init [--force] [--lang=LANG] [--auto]` | Генерация конфигурации проекта |
-| `godd-a uninstall [--client=...]` | Удаление из MCP-клиентов |
-| `godd-a version` (или `--version` / `-v`) | Показать установленную версию и проверить обновления |
-| `godd-a serve` | Запустить MCP stdio-сервер (вызывается клиентом автоматически) |
-| `godd-a shard partition <plan|lease|report|expire|abandon|status>` | Управлять Rust-native планом shard без пропусков и дубликатов sequence |
-| `godd-a realtime admission --evaluated-at-ms <u64>` | Проверить bounded event envelope из stdin и вернуть fail-closed решение из трёх состояний |
-| `godd-a dataset coverage --ledger <path>` | Сохранить CAS-выданные попытки sample и bounded coverage из одного strict JSON action с доверенными системными часами |
-
-Рабочий процесс shard начинается с
-`plan --state-dir <dir> --source-root <dir> --selector 1/M`: команда создаёт immutable plan
-для всех shard и полностью предварительно заполненный ledger. Worker вызывает
-`lease --state-dir <dir> --selector N/M --ttl-ms <ms>` и использует возвращённые
-`assigned_ids` и digest, не перечисляя source root повторно. Отчёт worker о завершении
-передаётся как один JSON-документ через stdin в `report --state-dir <dir>`. Для просроченных
-lease используется `expire --state-dir <dir>`, для явного отказа —
-`abandon --state-dir <dir> --selector N/M`, для повторного назначения —
-`lease ... --takeover`, а агрегированное состояние возвращает `status --state-dir <dir>`.
-Npm CLI только передаёт этот wire protocol упакованной Rust-команде. Каждое успешное действие
-выводит ровно один JSON-документ в stdout и завершается с кодом 0; неверные входные данные или
-состояние, ошибка сохранения и конфликт выводят в stderr только стабильный reason code
-`PARTITION_*` и завершаются с кодом 2.
-
-Открытые `assigned_ids` присутствуют только в ответе lease. Диагностика никогда не содержит
-sequence ID или host path. Ответы lease и `status` возвращают текущий `ledger_revision`, а
-receipt принятого report — следующую revision. Поля `plan_generation`,
-`reporting_shard_index` и `lease_generation` для report JSON берутся из ответа lease, а
-`expected_ledger_revision` — из последнего receipt или `status`. Не преобразуйте
-`PARTITION_CAS_MISMATCH` в успех: повторно получите `status` и переоцените report.
-Strict body отчёта имеет следующую форму. `expected_state` принимает `assigned`, `completed`,
-`rejected` или `missing`, а `outcome` — `completed` или `rejected`:
-
-```json
-{
-  "plan_generation": {
-    "source_generation": "<64 lowercase hex>",
-    "expected_set_digest": "<64 lowercase hex>"
-  },
-  "sequence_id": "<one assigned_ids value>",
-  "reporting_shard_index": 1,
-  "lease_generation": 1,
-  "expected_state": "assigned",
-  "expected_ledger_revision": 0,
-  "outcome": "completed"
-}
-```
+Полный список инструментов, справочник CLI и устранение неполадок — на **[сайте документации](https://www.getgodd.dev/ru/docs)**.
 
-Идентификаторы realtime envelope принимаются только как lowercase digest с доменом поля:
-`principal:sha256:<hex64>`, `resource:sha256:<hex64>` и `evidence:sha256:<hex64>`.
-Необработанные токены, cookie, имена пользователей и socket ID отклоняются без вывода значения.
-
-Dataset coverage принимает ровно одно strict JSON-действие: `initialize`, `issue`, `report`,
-`sweep` или `finalize`. `initialize` заранее фиксирует generation, assigned/expected sample sets,
-retry policy, coverage thresholds, оба declared digest и replacement policy (`forbidden`;
-`within_assigned_set` зарезервирован и отклоняется в Stage 2). `issue` принимает `canonical_sample_id` и `requested_position`, `report` —
-выданный `attempt` и типизированный outcome (`Accepted`, `Rejected`, `TimedOut`, `Cancelled` или
-`InfrastructureFailed`), `sweep` не имеет payload, а `finalize` требует точного совпадения с
-заранее зарегистрированными thresholds, digest и policy. Обычный поток: initialize → issue →
-report (повтор) → sweep/finalize. Успех возвращает один JSON receipt и код 0; invalid JSON/state,
-ошибка сохранения или conflict возвращает в stderr только стабильный reason code и код 2.
-При исчерпании retry атомарно добавляется `TerminalDecision`; отсутствующая, повторная или изменённая terminal projection отклоняется при load.
-Coverage receipt связывает generation source, threshold/expected-set digest, ledger/event-head
-и full durable-snapshot digest, finalized event sequence, число failure-attempt по классам и не более 32 стабильных
-opaque fingerprint терминальных failures; raw sample ID не возвращаются.
-Родительский каталог `--ledger` должен существовать заранее; команда не создаёт компоненты пути.
-
-### Устранение неполадок
-
-**«0 tools available» в клиенте** — сервер запущен без обязательного аргумента `serve`. Повторно выполните `godd-a install`, чтобы корректно пересоздать конфигурацию клиента, затем перезапустите клиент.
+Пишете адаптер? Все три контракта subpath (media interval / audio length / compile cache) поставляются вместе с пакетом: `docs/adapter-contracts.md`.
 
 ### Лицензия
 
-Проприетарное ПО. Для использования требуется действующий лицензионный ключ GoDD. Условия и поддержка — на [официальном сайте](https://www.getgodd.dev/).
+Проприетарная. Требуется действующий лицензионный ключ — [посмотреть тарифы](https://www.getgodd.dev/ru/pricing).