@autodevjapan/godd-mcp-alpha 2.11.0 → 2.13.0

package/README.md

@@ -4,13 +4,17 @@
   <img src="https://unpkg.com/@autodevjapan/godd-mcp-alpha@latest/assets/godd-mcp-alpha-icon.png" alt="GoDD MCP α icon" width="240" />
 </p>
 
+<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>
+
 [🇺🇸 English](#english) | [🇯🇵 日本語](#日本語) | [🇷🇺 Русский](#русский)
 
 ---
 
 ## English
 
-**GoDD delivers battle-tested development prompts, mindsets, and agent workflows straight into your AI coding client** — Cursor IDE, Claude Code CLI, Codex, Kimi CLI, and Google Antigravity IDE — over the Model Context Protocol (MCP).
+**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).
 
 ### Why use GoDD
 
@@ -79,6 +83,16 @@ Invoke GoDD in whichever way your client supports:
 - **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.
+
 ### GoDD prompts
 
 | Prompt | Description |
@@ -124,6 +138,11 @@ onboarding guide lives at [getgodd.dev/connect.md](https://getgodd.dev/connect.m
 | `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 realtime admission --evaluated-at-ms <u64>` | Evaluate one bounded event envelope from stdin with fail-closed ALLOW/DENY/INCONCLUSIVE receipts |
+
+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.
 
 ### Troubleshooting
 
@@ -137,7 +156,7 @@ Proprietary. Use requires a valid GoDD license key. See the [official site](http
 
 ## 日本語
 
-**GoDD は、実戦で磨かれた開発プロンプト・マインドセット・エージェントワークフローを、お使いの AI コーディングクライアントに直接届けます** — Cursor IDE / Claude Code CLI / Codex / Kimi CLI / Google Antigravity IDE に、MCP（Model Context Protocol）経由で配信します。
+**GoDD は自然言語の依頼を、仕様・テスト済みコード・レビュー・ドキュメント・出荷可能な Pull Request へ変換します。** 統制されたワークフローを Cursor IDE / Claude Code CLI / Codex / Kimi CLI / Google Antigravity IDE へ、MCP（Model Context Protocol）経由で届けます。
 
 ### GoDD を使うメリット
 
@@ -204,6 +223,16 @@ godd-a init
 - **スラッシュコマンド** — `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を公開するものではありません。
+
 ### GoDD プロンプト
 
 | プロンプト | 説明 |
@@ -249,6 +278,11 @@ godd-a init
 | `godd-a uninstall [--client=...]` | MCP クライアントから削除 |
 | `godd-a version`（または `--version` / `-v`） | インストール済みバージョンの表示と更新確認 |
 | `godd-a serve` | MCP stdio サーバーを起動（クライアントが自動呼び出し） |
+| `godd-a realtime admission --evaluated-at-ms <u64>` | stdinのbounded event envelopeをfail-closedな3値receiptとして評価 |
+
+Realtime envelopeの識別子はfield別lowercase digest
+（`principal:sha256:<hex64>`、`resource:sha256:<hex64>`、`evidence:sha256:<hex64>`）
+だけを受理します。生token、cookie、ユーザー名、socket IDは表示せず拒否します。
 
 ### トラブルシューティング
 
@@ -262,7 +296,7 @@ godd-a init
 
 ## Русский
 
-**GoDD доставляет проверенные промпты для разработки, майндсеты и рабочие процессы агентов прямо в ваш AI-клиент для кодинга** — Cursor IDE, Claude Code CLI, Codex, Kimi CLI и Google Antigravity IDE — через протокол MCP (Model Context Protocol).
+**GoDD превращает запрос на естественном языке в спецификации, протестированный код, ревью, документацию и готовые к выпуску pull request.** Управляемые рабочие процессы доступны в Cursor IDE, Claude Code CLI, Codex, Kimi CLI и Google Antigravity IDE через MCP (Model Context Protocol).
 
 ### Зачем использовать GoDD
 
@@ -331,6 +365,16 @@ godd-a init
 - **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.
+
 ### Промпты GoDD
 
 | Промпт | Описание |
@@ -376,6 +420,11 @@ godd-a init
 | `godd-a uninstall [--client=...]` | Удаление из MCP-клиентов |
 | `godd-a version` (или `--version` / `-v`) | Показать установленную версию и проверить обновления |
 | `godd-a serve` | Запустить MCP stdio-сервер (вызывается клиентом автоматически) |
+| `godd-a realtime admission --evaluated-at-ms <u64>` | Проверить bounded event envelope из stdin и вернуть fail-closed решение из трёх состояний |
+
+Идентификаторы realtime envelope принимаются только как lowercase digest с доменом поля:
+`principal:sha256:<hex64>`, `resource:sha256:<hex64>` и `evidence:sha256:<hex64>`.
+Необработанные токены, cookie, имена пользователей и socket ID отклоняются без вывода значения.
 
 ### Устранение неполадок
 

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

@@ -1 +1 @@
-a27633879a645512d68818794a8291051ba177e859100bbe509fb92a5cd19f81
+74267762b6605f3ac67b08d8fd416b81053041d8ad2a3d88829dc3a4da4b32b2

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

@@ -1 +1 @@
-a28cbdf1cdae5b6e9fdb17e1bb7daf71ac8796714c26b6f9abc869beba86d162
+d2c9c72aecd613f4a89f88190ceab5369961f1197c72bdf7c9ac1f6a2699aa46

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

@@ -1 +1 @@
-03f1a513c8dc2777317d2975f116510f8521620ae74e2780897f4209714b2587
+e9ca9423897367fc03772f3747e6d7ea7f0c13eba58a2cf21f638d6a7f3b8f09

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

@@ -1 +1 @@
-49619c303b7672d20c65006e3530f79d761923fd3cbd02c70adcb1e47b9c48c4
+c686bc2dc7d9053a33ef56a80465e881260bf05bfca86df28f066ae9e684b756

package/assets/registry-anchor-keys.json

@@ -0,0 +1 @@
+{"schema_version":1,"minimum_key_generation":"1","keys":[]}

package/dist/audio-length-adapter-contract.cjs

@@ -0,0 +1 @@
+"use strict";var p=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var w=(e,n)=>{for(var r in n)p(e,r,{get:n[r],enumerable:!0})},f=(e,n,r,t)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of h(n))!y.call(e,o)&&o!==r&&p(e,o,{get:()=>n[o],enumerable:!(t=_(n,o))||t.enumerable});return e};var g=e=>f(p({},"__esModule",{value:!0}),e);var k={};w(k,{validateAudioLengthAdapterContract:()=>v});module.exports=g(k);var b=new Set(["padding_samples","processing_samples","expected_feature_frames","trimmed_samples"]);function s(e,n){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError(`${n} must be an object`);return e}function u(e,n,r){let t=Object.keys(e).sort(),o=[...n].sort();if(t.length!==o.length||t.some((i,a)=>i!==o[a]))throw new TypeError(`${r} has an invalid field set`)}function d(e,n,r){if(!Array.isArray(e)||e.length!==n||e.some(t=>!Number.isSafeInteger(t)||t<=0))throw new TypeError(`${r} must contain positive safe integers`);return e}function l(e,n){if(Object.keys(e).some(r=>b.has(r)))throw new TypeError(`${n} duplicates Rust-owned length arithmetic`)}function m(e){return Number.isSafeInteger(e)&&typeof e=="number"&&e>0}function v(e){let n=s(e,"adapter contract");if(u(n,["schema_version","length_arithmetic_owner","waveform_input","mel_input","audio_output"],"adapter contract"),n.schema_version!==1||n.length_arithmetic_owner!=="rust")throw new TypeError("adapter contract version or arithmetic owner is invalid");let r=s(n.waveform_input,"waveform_input");u(r,["kind","shape","channel_sample_lengths","dtype"],"waveform_input"),l(r,"waveform_input");let t=d(r.shape,2,"waveform_input.shape"),o=d(r.channel_sample_lengths,t[0],"waveform_input.channel_sample_lengths");if(r.kind!=="waveform"||r.dtype!=="f32"||o.some(c=>c!==t[1]))throw new TypeError("waveform_input is incompatible");let i=s(n.mel_input,"mel_input");if(u(i,["kind","shape","layout","dtype"],"mel_input"),l(i,"mel_input"),d(i.shape,3,"mel_input.shape"),i.kind!=="mel"||i.dtype!=="f32"||i.layout!=="BinsFirst"&&i.layout!=="FramesFirst")throw new TypeError("mel_input is incompatible");let a=s(n.audio_output,"audio_output");if(u(a,["kind","container","encoding","sample_rate","channels","samples_per_channel"],"audio_output"),l(a,"audio_output"),a.kind!=="audio"||a.container!=="wav"||a.encoding!=="pcm_s16le"||!m(a.sample_rate)||!m(a.channels)||!m(a.samples_per_channel))throw new TypeError("audio_output is incompatible");return n}0&&(module.exports={validateAudioLengthAdapterContract});

package/dist/audio-length-adapter-contract.d.ts

@@ -0,0 +1,25 @@
+export interface AudioLengthAdapterContract {
+    readonly schema_version: 1;
+    readonly length_arithmetic_owner: "rust";
+    readonly waveform_input: {
+        readonly kind: "waveform";
+        readonly shape: readonly [number, number];
+        readonly channel_sample_lengths: readonly number[];
+        readonly dtype: "f32";
+    };
+    readonly mel_input: {
+        readonly kind: "mel";
+        readonly shape: readonly [number, number, number];
+        readonly layout: "BinsFirst" | "FramesFirst";
+        readonly dtype: "f32";
+    };
+    readonly audio_output: {
+        readonly kind: "audio";
+        readonly container: "wav";
+        readonly encoding: "pcm_s16le";
+        readonly sample_rate: number;
+        readonly channels: number;
+        readonly samples_per_channel: number;
+    };
+}
+export declare function validateAudioLengthAdapterContract(value: unknown): AudioLengthAdapterContract;