@bradheitmann/odin-sentinel 0.4.6 → 0.4.7

package/README.md

@@ -1,6 +1,6 @@
 # ODIN Sentinel
 
-**Visible multi-agent team coordination over MCP.**
+**Portable MCP governance protocol for visible multi-agent teams: 23 tools, 9 resources, role topology, readiness gates, ODIN watchers, receipts, delegation, and closeout over stdio.**
 
 ODIN Sentinel is a local stdio MCP server plus a portable coordination protocol
 for visible agent teams. It gives agents a shared roster, startup packet,
@@ -17,6 +17,11 @@ For the fastest path, read [docs/guides/quick-start.md](docs/guides/quick-start.
 For copy-paste prompts, read [docs/guides/quickstart-prompts.md](docs/guides/quickstart-prompts.md).
 For a starter team shape, read [docs/guides/recommended-starter-team.md](docs/guides/recommended-starter-team.md).
 
+## Contributor Setup
+- Required: Node.js 22.13+ and pnpm 11.0.3, pinned by `packageManager`.
+- Recommended: `corepack enable && pnpm install`.
+- Corepack fetches pnpm 11.0.3 automatically; mismatched global pnpm versions may warn or fail.
+
 ## Terms In Plain Language
 
 - MCP server: a local tool bridge that lets an agent ask ODIN Sentinel for
@@ -66,7 +71,7 @@ printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion
   | npx -y -p @bradheitmann/odin-sentinel odin-sentinel-mcp
 ```
 
-A successful response includes `"serverInfo":{"name":"odin-sentinel","version":"0.4.6"}`.
+A successful response includes `"serverInfo":{"name":"odin-sentinel","version":"0.4.7"}`.
 Minimum compatible child MCP version for governed-team docs is `0.4.5`.
 
 ## MCP Host Examples
@@ -85,7 +90,7 @@ command = "npx"
 args = ["-y", "-p", "@bradheitmann/odin-sentinel", "odin-sentinel-mcp"]
 ```
 
-Generic `mcpServers` JSON:
+Cursor / VS Code / Droid / Crush (`mcpServers` JSON):
 
 ```json
 {
@@ -98,6 +103,49 @@ Generic `mcpServers` JSON:
 }
 ```
 
+Zed (`~/.config/zed/settings.json`):
+
+```json
+"odin-sentinel": {
+  "source": "custom",
+  "command": "npx",
+  "args": ["-y", "-p", "@bradheitmann/odin-sentinel", "odin-sentinel-mcp"]
+}
+```
+
+Goose (`~/.config/goose/config.yaml`):
+
+```yaml
+odin-sentinel:
+  type: stdio
+  cmd: npx
+  args: ["-y", "-p", "@bradheitmann/odin-sentinel", "odin-sentinel-mcp"]
+  enabled: true
+```
+
+OpenCode (`~/.config/opencode/opencode.json`):
+
+```json
+{
+  "mcp": {
+    "odin-sentinel": {
+      "type": "local",
+      "command": ["npx", "-y", "-p", "@bradheitmann/odin-sentinel", "odin-sentinel-mcp"],
+      "enabled": true
+    }
+  }
+}
+```
+
+OpenHands (`~/.openhands/config.toml`):
+
+```toml
+[mcp.stdio_servers.odin-sentinel]
+name = "odin-sentinel"
+command = "npx"
+args = ["-y", "-p", "@bradheitmann/odin-sentinel", "odin-sentinel-mcp"]
+```
+
 ## MCP, Skill, Plugin, Prompt Fallback
 
 - MCP server: supplies protocol resources and validation tools.
@@ -130,7 +178,7 @@ using them for real work.
 Local operator planning folders may be useful private workspaces, but they are
 not shipped product internals and are not required for public users.
 
-## Provided MCP Resources
+## Provided MCP Resources (9)
 
 - `odin://protocol/main`
 - `odin://protocol/roles`
@@ -142,7 +190,7 @@ not shipped product internals and are not required for public users.
 - `odin://protocol/receipts/team-manifest`
 - `odin://protocol/bootstrap-skill`
 
-## Provided MCP Tools
+## Provided MCP Tools (23)
 
 - `odin.get_version`
 - `odin.get_startup_packet`

package/dist/src/protocol/version.d.ts

@@ -1,4 +1,4 @@
 export declare const VERSION: string;
-export declare const PROTOCOL_SCHEMA_VERSION = "0.4.6";
+export declare const PROTOCOL_SCHEMA_VERSION = "0.4.7";
 export declare const MINIMUM_COMPATIBLE_MCP_VERSION = "0.4.5";
-export declare const PUBLIC_LATEST_VERSION = "0.4.6";
+export declare const PUBLIC_LATEST_VERSION = "0.4.7";

package/dist/src/protocol/version.js

@@ -23,7 +23,7 @@ function readPackageVersion() {
     throw new Error("Could not locate odin-sentinel package version");
 }
 export const VERSION = readPackageVersion();
-export const PROTOCOL_SCHEMA_VERSION = "0.4.6";
+export const PROTOCOL_SCHEMA_VERSION = "0.4.7";
 export const MINIMUM_COMPATIBLE_MCP_VERSION = "0.4.5";
-export const PUBLIC_LATEST_VERSION = "0.4.6";
+export const PUBLIC_LATEST_VERSION = "0.4.7";
 //# sourceMappingURL=version.js.map

package/docs/guides/quick-start.md

@@ -85,7 +85,7 @@ printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion
   | npx -y -p @bradheitmann/odin-sentinel odin-sentinel-mcp
 ```
 
-Expect `serverInfo.name = odin-sentinel` and `serverInfo.version = 0.4.6`.
+Expect `serverInfo.name = odin-sentinel` and `serverInfo.version = 0.4.7`.
 Minimum compatible child MCP version: `0.4.5`.
 
 ## 6. Auth And Provider Readiness
@@ -134,7 +134,7 @@ occupants until readiness passes or EXEC PM records a waiver/substitution.
 | Skill missing | Install the native skill where supported or use `odin.get_bootstrap_skill` as full prompt fallback. |
 | Auth/login required | Ask the user to provision the provider; verify status without printing secrets. |
 | Permission prompt | Stop and route to PM/user; do not bypass silently. |
-| Stale MCP version | Reinstall with `@latest`, restart host, and confirm `0.4.6`. |
+| Stale MCP version | Reinstall with `@latest`, restart host, and confirm `0.4.7`. |
 | Local inference stall | Require visible content within timeout; endpoint-only success is insufficient. |
 | Role refusal | Mark the role `NON_GOVERNED_ONE_SHOT_ONLY` unless MCP/skill/full protocol proof is established. |
 

package/docs/guides/quickstart-prompts.md

@@ -24,7 +24,7 @@ Rules:
 Smoke test:
 printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}\n' | odin-sentinel-mcp
 
-Expected version: 0.4.6.
+Expected version: 0.4.7.
 ```
 
 Restart any host whose MCP config changed.
@@ -37,7 +37,7 @@ Open CMUX first. Paste into the agent that will act as EXEC PM.
 You are A/EXEC-PM. Bootstrap a Sentinel Coordination Protocol governed team in this CMUX workspace.
 
 Procedure:
-1. Call odin.get_version and confirm version 0.4.6 or newer.
+1. Call odin.get_version and confirm version 0.4.7 or newer.
 2. Call odin.get_bootstrap_skill and read the public SCP contract.
 3. Confirm CMUX is active and you are in the same workspace as the team slots.
 4. Compute the target layout with odin.compute_surface_layout using profile=human_cmux_quad.

package/docs/reference/distribution.md

@@ -6,7 +6,7 @@ public protocol semantics change, update them together.
 
 ## Current Public Versions
 
-- npm package/server: `0.4.6`
+- npm package/server: `0.4.7`
 - minimum compatible child MCP version: `0.4.5`
 
 Private local skill copies may differ for personal workflow reasons. Release

package/docs/reference/public-surface-audit.md

@@ -41,7 +41,7 @@ languages, or harnesses.
 
 ## Current Public Surface
 
-- Public package/server version: `0.4.6`
+- Public package/server version: `0.4.7`
 - Minimum compatible child MCP version: `0.4.5`
 - MCP resources: 9
 - MCP tools: 23

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@bradheitmann/odin-sentinel",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "publishConfig": {
     "access": "public"
   },
-  "description": "Multi-harness terminal-pane team builder and orchestrator over MCP.",
+  "description": "Portable MCP governance protocol for multi-agent terminal teams: 23 tools, 9 resources, readiness gates, ODIN watchers, receipts, delegation, and closeout over stdio.",
   "type": "module",
   "main": "./dist/src/protocol/index.js",
   "types": "./dist/src/protocol/index.d.ts",
@@ -56,7 +56,8 @@
     "vitest": "4.1.5"
   },
   "engines": {
-    "node": ">=22.13.0"
+    "node": ">=22.13.0",
+    "pnpm": ">=11.0.0"
   },
   "repository": {
     "type": "git",
@@ -67,7 +68,7 @@
     "url": "https://github.com/bradheitmann/odin-sentinel/issues"
   },
   "odin": {
-    "publicVersion": "0.4.6",
+    "publicVersion": "0.4.7",
     "minimumCompatibleChildMcpVersion": "0.4.5"
   },
   "scripts": {

package/protocol/SCP.md

@@ -1,8 +1,8 @@
 # ODIN Sentinel Coordination Protocol
 
-Version: 0.4.6
+Version: 0.4.7
 
-SCP_PUBLIC_VERSION: 0.4.6
+SCP_PUBLIC_VERSION: 0.4.7
 MIN_COMPATIBLE_CHILD_MCP: 0.4.5
 
 ODIN Sentinel is a portable coordination layer for visible multi-agent teams.

package/protocol/bootstrap-skill.md

@@ -7,7 +7,7 @@ updated: 2026-05-11
 
 # Sentinel Coordination Protocol
 
-SCP_PUBLIC_VERSION: 0.4.6
+SCP_PUBLIC_VERSION: 0.4.7
 MIN_COMPATIBLE_CHILD_MCP: 0.4.5
 
 Public install readiness: configure the ODIN MCP server, install native skill context where supported or use full prompt fallback, keep governed team roles in CMUX, verify auth/account readiness without printing secrets, smoke-test local inference if used, and validate role compatibility before launch. Private local skill copies may differ intentionally; public release checks compare repo-internal public artifacts only.

package/protocol/closeout.yaml

@@ -1,4 +1,4 @@
-version: 0.4.6
+version: 0.4.7
 active_watch_terminal_states:
   - RELEASED_BY_OPERATOR
   - HANDED_OFF

package/protocol/delegation.yaml

@@ -1,4 +1,4 @@
-version: 0.4.6
+version: 0.4.7
 delegation_contract:
   required_fields:
     - receipt_type

package/protocol/model-profiles.yaml

@@ -1,4 +1,4 @@
-version: 0.4.6
+version: 0.4.7
 policy:
   semantics: Recommended starter profiles, not bundled dependencies or availability guarantees.
   runtime_requirement: Users must install and configure their own harnesses. Launchers must verify local harness/model availability before dispatch and apply fallbacks when unavailable.

package/protocol/roles.yaml

@@ -1,4 +1,4 @@
-version: 0.4.6
+version: 0.4.7
 roles:
   EXEC_PM:
     title: EXEC PM

package/protocol/topology.yaml

@@ -1,4 +1,4 @@
-version: 0.4.6
+version: 0.4.7
 default_topology:
   executive_office:
     team: A