Node Command

nc-protocol

Node Command の公開ワイヤー契約、Model Context Protocol（MCP）ツールスキーマ、およびエージェントプロトコルの定義です。

このリポジトリは、Node Command の公開契約に関する正式な信頼できる情報源です。宣言的なスキーマと契約のみを含み、独自のサーバーコード、データベーススキーマ、シークレットは含みません。

Node Command ハブ、 nc-agent ランタイム、クライアント統合などの利用者は、固定したコミットでこのリポジトリをベンダーとして取り込むため、ここでの契約変更は明示的で監査可能です。

---

名前空間

agent/     Hub ↔ Agent wire protocol (hello / welcome / request / reply / heartbeat)
mcp/       Model-facing MCP surface (tool schemas + canonical tool manifest)
policy/    Public host-policy projection + capability names
browser/   Public browser and egress policy schemas
bindings/  Generated language bindings (JavaScript ESM)

---

契約の利用

インストールが必要なランタイム依存関係はありません。利用者は固定したコミット SHA でこのリポジトリをベンダーとして取り込み、取り込んだツリーからインポートします。

git clone https://github.com/huseyincig/nc-protocol.git

JavaScript バインディングを直接インポートします。

import {
  MCP_TOOL_CONTRACT_VERSION,
  MCP_TOOL_MANIFEST_FINGERPRINT,
  MCP_TOOL_NAMES,
  HOST_POLICY_CAPABILITY_NAMES
} from './nc-protocol/bindings/javascript/contracts.mjs';

JSON スキーマはパスを指定してインポートできます。

import helloSchema from './nc-protocol/agent/hello.schema.json' with { type: 'json' };
import toolsIndex from './nc-protocol/mcp/tools/index.json' with { type: 'json' };

現在の契約バージョン、フィンガープリント、機能リストは mcp/contract-version、mcp/fingerprint、policy/capability-names に固定されています。現在の生成ルールとロールアウトルールについては COMPATIBILITY.md を参照してください。

---

テストと検証

nc-protocol にはランタイム依存関係がなく、Node.js の組み込みテストランナーを使用します。

# Clone the repository
git clone https://github.com/huseyincig/nc-protocol.git
cd nc-protocol

# Run test suite
npm test
# Or:
node --test tests/*.mjs

テストスイートでは、次の項目を検証します。

1. 必須の名前空間ファイルがすべて存在すること。
2. ツール定義、mcp/tools/index.json、ツール数が完全に一致すること。
3. 正規の sha256 マニフェストフィンガープリントの暗号学的整合性。
4. スキーマの解析が有効であり、スキーマドラフトに準拠していること。
5. 宣言的な契約ファイルとのバインディングの同等性。

---

貢献

新しいツールの提案、スキーマの更新、フィンガープリントの再計算、プルリクエストの送信方法に関する詳細なガイドラインは、CONTRIBUTING.md を参照してください。

---

バージョン管理と互換性

• VERSIONING.md — SemVer のライフサイクルと破壊的変更に関するポリシー。
• COMPATIBILITY.md — 現在の契約世代とロールアウトのゲート。

---

関連リポジトリ

• NodeCommand — 製品ドキュメント、クライアントの例、マニフェスト。
• nc-agent — これらの契約を実装するオープンソースのホストエージェントと CLI インストーラー。

---

ライセンス

Apache-2.0 — LICENSE を参照してください。