@medicine-wheel/app 0.5.4 → 0.5.6

package/dist/cli/mw.js

@@ -101,6 +101,25 @@ const C = {
     bold: '\x1b[1m',
     reset: '\x1b[0m',
 };
+// ── Exit codes ────────────────────────────────────────────────────
+// A command that did not do what it was asked must never exit 0.
+//   0  the command did what it said
+//   1  the command ran and failed
+//   2  usage error — unknown command / sub-command, or a missing argument
+//   3  the sub-command is recognised but has no implementation yet
+const EXIT_USAGE = 2;
+const EXIT_UNIMPLEMENTED = 3;
+/**
+ * Report an unknown sub-command and mark the process as failed.
+ *
+ * Uses `process.exitCode` rather than `process.exit()` so buffered stderr is
+ * flushed before the process leaves.
+ */
+function unknownSub(group, sub, available) {
+    console.error(`${C.south}Unknown ${group} sub-command: ${sub}${C.reset}`);
+    console.error(`  Available: ${available.join(', ')}`);
+    process.exitCode = EXIT_USAGE;
+}
 function parseArgs(argv) {
     const args = argv.slice(2);
     const flags = {};
@@ -276,6 +295,8 @@ ${C.bold}🌿 mw — Medicine Wheel CLI${C.reset}
   SKILLS
     mw skill view                          List available CLI skills
     mw skill install [name]                Install a skill (or all)
+    mw skill run <name>                    NOT AVAILABLE — skills are definitions,
+                                           not programs. Exits ${EXIT_UNIMPLEMENTED}.
 
   MEMORY
     mw memory store <key> <value> [dir]   Store relational memory
@@ -385,7 +406,7 @@ async function cmdCeremony(positional, flags) {
             break;
         }
         default:
-            console.error(`Unknown ceremony sub-command: ${sub}`);
+            unknownSub('ceremony', sub, ['open', 'close', 'get', 'list']);
     }
 }
 // ── Direction ─────────────────────────────────────────────────────
@@ -484,7 +505,7 @@ async function cmdCycle(positional) {
             mcpCall('get_narrative_arc', { cycle_id: positional[1] ?? '' });
             break;
         default:
-            console.error(`Unknown cycle sub-command: ${sub}`);
+            unknownSub('cycle', sub, ['create', 'list', 'advance', 'get', 'arc']);
     }
 }
 // ── Node ──────────────────────────────────────────────────────────
@@ -539,7 +560,7 @@ async function cmdNode(positional, flags) {
             mcpCall('search_nodes', { query: positional.slice(1).join(' ') });
             break;
         default:
-            console.error(`Unknown node sub-command: ${sub}`);
+            unknownSub('node', sub, ['create', 'list', 'get', 'search']);
     }
 }
 // ── Beat ──────────────────────────────────────────────────────────
@@ -605,7 +626,7 @@ async function cmdBeat(positional, flags = {}) {
             break;
         }
         default:
-            console.error(`Unknown beat sub-command: ${sub}`);
+            unknownSub('beat', sub, ['register', 'create', 'list']);
     }
 }
 // ── Edge ──────────────────────────────────────────────────────────
@@ -625,7 +646,7 @@ function cmdEdge(positional, flags) {
             break;
         }
         default:
-            console.error(`Unknown edge sub-command: ${sub}`);
+            unknownSub('edge', sub, ['create', 'list']);
     }
 }
 // ── Web ───────────────────────────────────────────────────────────
@@ -652,7 +673,7 @@ function cmdChart(positional) {
             mcpCall('get_chart_progress', { chart_id: positional[1] ?? '' });
             break;
         default:
-            console.error(`Unknown chart sub-command: ${sub}`);
+            unknownSub('chart', sub, ['create', 'list', 'progress']);
     }
 }
 // ── MMOT ──────────────────────────────────────────────────────────
@@ -692,7 +713,7 @@ function cmdValidate(positional) {
             });
             break;
         default:
-            console.error(`Unknown validate sub-command: ${sub}`);
+            unknownSub('validate', sub, ['wilson', 'ocap', 'accountability', 'bridge']);
     }
 }
 // ── Skill ─────────────────────────────────────────────────────────
@@ -705,12 +726,18 @@ function cmdSkill(positional) {
             break;
         case 'install': {
             const name = positional[1]; // undefined means install all
-            (0, skills_1.installSkill)('cli', name, C);
+            // installSkill returns -1 when `name` matched no skill for this target.
+            if ((0, skills_1.installSkill)('cli', name, C) < 0)
+                process.exitCode = EXIT_USAGE;
             break;
         }
+        case 'run':
+            // Recognised, deliberately unimplemented. See explainSkillRunUnavailable.
+            (0, skills_1.explainSkillRunUnavailable)('mw', C);
+            process.exitCode = EXIT_UNIMPLEMENTED;
+            break;
         default:
-            console.error(`Unknown skill sub-command: ${sub}`);
-            console.error("Available: view, install");
+            unknownSub('skill', sub, ['view', 'list', 'install']);
     }
 }
 // ── Memory ────────────────────────────────────────────────────────
@@ -728,7 +755,7 @@ function cmdMemory(positional) {
             break;
         }
         default:
-            console.error(`Unknown memory sub-command: ${sub}`);
+            unknownSub('memory', sub, ['store']);
     }
 }
 // ── Main dispatch ─────────────────────────────────────────────────
@@ -811,7 +838,7 @@ async function main() {
         default:
             console.error(`${C.south}Unknown command: ${cmd}${C.reset}`);
             console.error("Run 'mw help' for usage.");
-            process.exit(1);
+            process.exitCode = EXIT_USAGE;
     }
 }
 main().catch((err) => {

package/dist/cli/mwsrv.js

@@ -65,6 +65,14 @@ const C = {
 };
 const DEFAULT_PORT = 8040;
 const CONTAINER_PORT = 8040;
+// ── Exit codes ────────────────────────────────────────────────────
+// A command that did not do what it was asked must never exit 0.
+//   0  the command did what it said
+//   1  the command ran and failed
+//   2  usage error — unknown command / sub-command, or a missing argument
+//   3  the sub-command is recognised but has no implementation yet
+const EXIT_USAGE = 2;
+const EXIT_UNIMPLEMENTED = 3;
 function parseArgs(argv) {
     const args = argv.slice(2);
     const flags = {};
@@ -213,12 +221,20 @@ function cmdSkill(positional) {
             break;
         case 'install': {
             const name = positional[1]; // undefined means install all
-            (0, skills_1.installSkill)('srv', name, C);
+            // installSkill returns -1 when `name` matched no skill for this target.
+            if ((0, skills_1.installSkill)('srv', name, C) < 0)
+                process.exitCode = EXIT_USAGE;
             break;
         }
+        case 'run':
+            // Recognised, deliberately unimplemented. See explainSkillRunUnavailable.
+            (0, skills_1.explainSkillRunUnavailable)('mwsrv', C);
+            process.exitCode = EXIT_UNIMPLEMENTED;
+            break;
         default:
-            console.error(`Unknown skill sub-command: ${sub}`);
-            console.error("Available: view, install");
+            console.error(`${C.south}Unknown skill sub-command: ${sub}${C.reset}`);
+            console.error('  Available: view, list, install');
+            process.exitCode = EXIT_USAGE;
     }
 }
 // ── Help ──────────────────────────────────────────────────────────
@@ -244,6 +260,8 @@ OPTIONS
 SKILLS
   mwsrv skill view                List available server skills
   mwsrv skill install [name]      Install a skill (or all)
+  mwsrv skill run <name>          NOT AVAILABLE — skills are definitions, not
+                                  programs. Exits ${EXIT_UNIMPLEMENTED}.
 
 EXAMPLES
   # Start locally (uses current directory's .mw/store)
@@ -278,6 +296,15 @@ async function main() {
         cmdSkill(positional.slice(1));
         return;
     }
+    // Anything else positional is a typo, not a server invocation. Starting the
+    // server anyway reported success for a command that was never understood.
+    if (positional.length > 0) {
+        console.error(`${C.south}Unknown command: ${positional[0]}${C.reset}`);
+        console.error("  The only sub-command is 'skill'. Run 'mwsrv --help' for usage.");
+        console.error("  To start the server, run 'mwsrv' with no positional arguments.");
+        process.exitCode = EXIT_USAGE;
+        return;
+    }
     const port = Number(flags['port'] ?? flags['p'] ?? DEFAULT_PORT);
     const directory = String(flags['directory'] ?? flags['D'] ?? process.cwd());
     const useDocker = Boolean(flags['docker']);

package/dist/cli/skills.js

@@ -43,6 +43,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.listSkills = listSkills;
 exports.getSkill = getSkill;
 exports.getComplement = getComplement;
+exports.explainSkillRunUnavailable = explainSkillRunUnavailable;
 exports.viewSkills = viewSkills;
 exports.installSkill = installSkill;
 const fs = __importStar(require("fs"));
@@ -73,6 +74,15 @@ Analyze an engineering task using the Four Directions framework.
 - Ceremony recommendation if balance is poor
 
 ## Usage
+
+> **Not available yet.** \`mw skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mw skill install direction-inquiry\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
 \`\`\`
 mw skill run direction-inquiry "Refactor auth module"
 \`\`\`
@@ -102,6 +112,15 @@ Evaluate a proposed action against permission tiers and relational gates.
 - Suggested next move
 
 ## Usage
+
+> **Not available yet.** \`mw skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mw skill install fire-keeper-check\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
 \`\`\`
 mw skill run fire-keeper-check "Deploy to production"
 \`\`\`
@@ -129,6 +148,15 @@ Create a proposal-grade wave bundle matching current .pde practice.
 - artifacts/ checklist
 
 ## Usage
+
+> **Not available yet.** \`mw skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mw skill install wave-spec-generator\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
 \`\`\`
 mw skill run wave-spec-generator "Add caching layer"
 \`\`\`
@@ -156,9 +184,135 @@ Provide step-by-step guidance through the ceremony lifecycle.
 - Completion criteria
 
 ## Usage
+
+> **Not available yet.** \`mw skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mw skill install ceremony-guide\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
 \`\`\`
 mw skill run ceremony-guide "Community data review"
 \`\`\`
+`,
+    },
+    {
+        name: 'infrastructure-audit',
+        title: 'Infrastructure Audit',
+        description: 'Audit hosts, services, and port bindings across the Medicine Wheel estate',
+        target: 'cli',
+        complement: 'infra-monitor',
+        body: `# Skill: Infrastructure Audit
+
+## Purpose
+Analyze infrastructure facets (hosts, tenants, services) and surface relationships, conflicts, and métis.
+
+## Input
+- Target host (optional — audit all if omitted)
+- Facet type filter (host / tenant / service, optional)
+- Conflict scope (declared / observed / union)
+
+## Output
+- Graph: hosts → tenants → services with port bindings
+- Port conflicts (distinct services colliding on same host|proto|port)
+- Métis surface (invisible work, exceptions, heldBy accountability)
+- Reachability status (lan / tailnet / cloudflare / ngrok)
+
+## Usage
+
+> **Not available yet.** \`mw skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mw skill install infrastructure-audit\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
+\`\`\`
+mw skill run infrastructure-audit --host eury
+mw skill run infrastructure-audit --type service --conflicts
+\`\`\`
+`,
+    },
+    {
+        name: 'service-provisioning',
+        title: 'Service Provisioning',
+        description: 'Propose and gate service deployment through ceremony-aware preconditions',
+        target: 'cli',
+        complement: 'infra-monitor',
+        body: `# Skill: Service Provisioning
+
+## Purpose
+Propose a new service and check preconditions (port availability, consent, linger-state alignment) via ceremony gates.
+
+## Input
+- Service name and unit (e.g., assembly-mux.service)
+- Port binding claims (host, port, proto)
+- Owner (tenant nodeId)
+- Optional: working directory, execStop, métis exceptions
+
+## Output
+- Precondition checks: port conflicts, tenant consent, linger alignment
+- Fire Keeper gate assessment (hold / proceed)
+- Community review recommendation
+- Deployment ceremony phase to enter
+- Diff against observed state
+
+## Usage
+
+> **Not available yet.** \`mw skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mw skill install service-provisioning\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
+\`\`\`
+mw skill run service-provisioning \
+  --unit zulip.service \
+  --port 3000:tcp@eury \
+  --owner "node:human:ava"
+\`\`\`
+`,
+    },
+    {
+        name: 'drift-reconciliation',
+        title: 'Drift Reconciliation',
+        description: 'Compare declared vs observed infrastructure state and propose healing steps',
+        target: 'cli',
+        complement: 'infra-monitor',
+        body: `# Skill: Drift Reconciliation
+
+## Purpose
+Detect infrastructure drift (declared state vs systemd observed reality) and recommend ceremony-gated remediation.
+
+## Input
+- Drift scope: specific host, all hosts, or facet type
+- Healing mode: audit-only / propose-fix / execute-with-gates
+
+## Output
+- Drift report: satisfied / diverged / unobserved facets per host
+- Healing candidates: services to restart, ports to release, linger to reconcile
+- Ceremony phase recommendation (emergency / standard)
+- Accountability notes (who holds métis on each remediation)
+
+## Usage
+
+> **Not available yet.** \`mw skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mw skill install drift-reconciliation\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
+\`\`\`
+mw skill run drift-reconciliation --host gaia --propose
+mw skill run drift-reconciliation --type service --audit-only
+\`\`\`
 `,
     },
     // ── Server skills (mwsrv) ─────────────────────────────────────
@@ -180,6 +334,15 @@ Configure the Docker environment for running the Medicine Wheel server.
 - Port availability
 
 ## Usage
+
+> **Not available yet.** \`mwsrv skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mwsrv skill install docker-setup\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
 \`\`\`
 mwsrv skill run docker-setup
 \`\`\`
@@ -207,6 +370,15 @@ Configure the storage backend for the Medicine Wheel server.
 - Migration status
 
 ## Usage
+
+> **Not available yet.** \`mwsrv skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mwsrv skill install storage-config\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
 \`\`\`
 mwsrv skill run storage-config
 \`\`\`
@@ -230,6 +402,15 @@ Check the health and connectivity of Medicine Wheel API endpoints.
 - Storage layer connectivity
 
 ## Usage
+
+> **Not available yet.** \`mwsrv skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mwsrv skill install api-health\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
 \`\`\`
 mwsrv skill run api-health
 \`\`\`
@@ -253,9 +434,96 @@ Inspect and manage active sessions on the Medicine Wheel server.
 - Cleanup stale session data
 
 ## Usage
+
+> **Not available yet.** \`mwsrv skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mwsrv skill install session-manager\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
 \`\`\`
 mwsrv skill run session-manager
 \`\`\`
+`,
+    },
+    {
+        name: 'infra-monitor',
+        title: 'Infrastructure Monitor',
+        description: 'Live monitoring and drift detection for infrastructure facets via MCP',
+        target: 'srv',
+        complement: 'infrastructure-audit',
+        body: `# Skill: Infrastructure Monitor
+
+## Purpose
+Monitor live infrastructure state (observed via systemd) and track drift against declared facets.
+
+## Capabilities
+- Poll systemd for active units, ports, linger-state across tenants
+- Maintain observed state cache (RelationalNode facets)
+- Detect port collisions in declared ∪ observed bindings
+- Track métis holders and accountability chains
+- Stream drift events to active CLI sessions
+- Gate reconciliation requests through ceremony protocol
+
+## Integration
+- **Backend:** @medicine-wheel/infra (HostFacet, TenantFacet, ServiceFacet, detectPortConflicts)
+- **MCP tools (planned, none registered yet):** infrastructure-audit, service-preconditions, drift-reconciliation, métis-surface
+- **Data store:** Postgres/JSONL via @medicine-wheel/storage-provider
+
+## Usage
+
+> **Not available yet.** \`mwsrv skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mwsrv skill install infra-monitor\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
+\`\`\`
+mwsrv skill run infra-monitor --poll-interval 30s
+mwsrv skill run infra-monitor --host gaia --linger-report
+\`\`\`
+`,
+    },
+    {
+        name: 'precondition-guard',
+        title: 'Precondition Guard',
+        description: 'Evaluate infrastructure preconditions (linger, consent, port, reachability)',
+        target: 'srv',
+        complement: 'service-provisioning',
+        body: `# Skill: Precondition Guard
+
+## Purpose
+Enforce precondition gates before service provisioning or relational state changes. (Roadmap: @medicine-wheel/infra@0.2.0)
+
+## Precondition Types
+- **Port availability** — detectPortConflicts over declared + observed
+- **Tenant linger** — required for user.slice services; consent record must authorize root step
+- **Consent accountability** — ConsentRecord.id must be present and active
+- **Reachability** — host must be reachable via declared transport (lan, tailnet, cloudflare, ngrok)
+
+## Output
+- Unsatisfied precondition report
+- Fire Keeper hold / proceed recommendation
+- Next ceremony gate to enter (if held)
+- Accountability chain (who can unlock the hold)
+
+## Usage
+
+> **Not available yet.** \`mwsrv skill run\` has no implementation.
+> It prints this explanation and exits 3 — nothing is executed. Planned, not shipped.
+>
+> **What works today:** \`mwsrv skill install precondition-guard\` writes this
+> SKILL.md into \`.mw/skills/\`. Follow the steps above yourself, or hand this
+> file to an agent.
+
+Planned invocation (does not run yet):
+\`\`\`
+mwsrv skill run precondition-guard --facet-id "node:knowledge:zulip:..." --intent provision
+\`\`\`
 `,
     },
 ];
@@ -282,6 +550,31 @@ function getSkill(name) {
 function getComplement(skill) {
     return skill.complement ? getSkill(skill.complement) : undefined;
 }
+/**
+ * Print why `skill run` does nothing and what to reach for instead.
+ *
+ * A `SkillDefinition` is a name/title/description/body record — a document, not
+ * a program. Nothing in this repository executes one, so `skill run` has never
+ * had an implementation. Both CLIs call this and then exit non-zero rather than
+ * printing an error and returning 0, which is what they used to do.
+ *
+ * @param binary  Which CLI is speaking ('mw' | 'mwsrv') — shapes the examples.
+ * @param colors  ANSI colour map.
+ */
+function explainSkillRunUnavailable(binary, colors) {
+    const C = colors;
+    console.error(`${C.south}${binary} skill run is not implemented.${C.reset}`);
+    console.error('');
+    console.error('  Skills here are definitions, not programs: each one is a SKILL.md');
+    console.error('  describing inputs, outputs and steps. There is no runtime that');
+    console.error('  executes them, so nothing would have run.');
+    console.error('');
+    console.error(`  ${C.bold}What works today${C.reset}`);
+    console.error(`    ${binary} skill view              list the skills this CLI knows`);
+    console.error(`    ${binary} skill install <name>    write <name>/SKILL.md into .mw/skills/`);
+    console.error('');
+    console.error('  Then follow the installed SKILL.md yourself, or hand it to an agent.');
+}
 /**
  * Print skill catalog for the given target.
  *
@@ -307,7 +600,10 @@ function viewSkills(target, colors) {
 /**
  * Install a skill (or all skills) for the given target.
  *
- * @returns number of newly installed skills
+ * @returns number of newly installed skills, or **-1** when `name` matched no
+ *          skill for this target — callers must treat -1 as a failure and exit
+ *          non-zero. Returning 0 for both "nothing to do" and "you named a
+ *          skill that does not exist" is what let a bad name report success.
  */
 function installSkill(target, name, colors) {
     const C = colors ?? { bold: '', dim: '', green: '', south: '', reset: '' };
@@ -325,14 +621,30 @@ function installSkill(target, name, colors) {
         else {
             console.error(`${C.south}Unknown skill: ${name}${C.reset}`);
         }
-        return 0;
+        return -1;
     }
     let installed = 0;
+    let stale = 0;
     for (const skill of toInstall) {
         const skillDir = path.join(dir, skill.name);
         const skillFile = path.join(skillDir, 'SKILL.md');
         if (fs.existsSync(skillFile)) {
-            console.log(`  ${C.dim}⊘ ${skill.name} (already installed)${C.reset}`);
+            // An existing file is never overwritten. Say so honestly when the copy
+            // on disk no longer matches the catalog, otherwise "already installed"
+            // reads as "up to date" while the reader follows outdated instructions.
+            let onDisk = '';
+            try {
+                onDisk = fs.readFileSync(skillFile, 'utf8');
+            }
+            catch { /* unreadable → treat as drifted */ }
+            if (onDisk === skill.body) {
+                console.log(`  ${C.dim}⊘ ${skill.name} (already installed)${C.reset}`);
+            }
+            else {
+                stale++;
+                console.log(`  ${C.dim}⊘ ${skill.name} (already installed — copy on disk differs from the catalog)${C.reset}`);
+                console.log(`    ${C.dim}to update: rm ${skillFile} && ${target === 'cli' ? 'mw' : 'mwsrv'} skill install ${skill.name}${C.reset}`);
+            }
             continue;
         }
         fs.mkdirSync(skillDir, { recursive: true });
@@ -352,5 +664,8 @@ function installSkill(target, name, colors) {
     else {
         console.log(`\n  ${C.dim}All skills already installed.${C.reset}\n`);
     }
+    if (stale > 0) {
+        console.log(`  ${C.south}${stale} installed copy/copies differ from the catalog and were left untouched.${C.reset}\n`);
+    }
     return installed;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medicine-wheel/app",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "Medicine Wheel — Interactive visual layer for Indigenous relational research with Four Directions, ceremonies, and narrative arcs",
   "bin": {
     "mw": "dist/cli/mw.js",
@@ -26,6 +26,7 @@
   "//workspaces": "TOPOLOGICAL ORDER — do not alphabetize. `npm run <script> --workspaces` executes in THIS array's order, not in dependency order: a package listed before a package it imports builds first and fails TS2307 on any tree without a stale dist/. Roots first (ontology-core, creative-orientation, session-reader), then their dependents, mcp last. A new package goes after everything it imports.",
   "workspaces": [
     "src/ontology-core",
+    "src/infra",
     "src/creative-orientation",
     "src/session-reader",
     "src/ceremony-protocol",
@@ -84,28 +85,28 @@
     "release:major": "npm run version:major && npm run publish:all && npm run release:commit"
   },
   "dependencies": {
-    "@medicine-wheel/ceremonial-diary": "^0.5.4",
-    "@medicine-wheel/ceremony-protocol": "^0.5.4",
-    "@medicine-wheel/community-review": "^0.5.4",
-    "@medicine-wheel/consent-lifecycle": "^0.5.4",
-    "@medicine-wheel/data-store": "^0.5.4",
-    "@medicine-wheel/data-store-postgres": "^0.5.4",
-    "@medicine-wheel/fire-keeper": "^0.5.4",
-    "@medicine-wheel/github-ceremony": "^0.5.4",
-    "@medicine-wheel/graph-viz": "^0.5.4",
-    "@medicine-wheel/importance-unit": "^0.5.4",
-    "@medicine-wheel/mcp": "^4.5.4",
-    "@medicine-wheel/narrative-cluster": "^0.5.4",
-    "@medicine-wheel/narrative-engine": "^0.5.4",
-    "@medicine-wheel/ontology-core": "^0.5.4",
-    "@medicine-wheel/perception-layer": "^0.5.4",
-    "@medicine-wheel/prompt-decomposition": "^0.5.4",
-    "@medicine-wheel/relational-index": "^0.5.4",
-    "@medicine-wheel/relational-query": "^0.5.4",
-    "@medicine-wheel/session-reader": "^0.5.4",
-    "@medicine-wheel/storage-provider": "^0.5.4",
-    "@medicine-wheel/transformation-tracker": "^0.5.4",
-    "@medicine-wheel/ui-components": "^0.5.4",
+    "@medicine-wheel/ceremonial-diary": "^0.5.6",
+    "@medicine-wheel/ceremony-protocol": "^0.5.6",
+    "@medicine-wheel/community-review": "^0.5.6",
+    "@medicine-wheel/consent-lifecycle": "^0.5.6",
+    "@medicine-wheel/data-store": "^0.5.6",
+    "@medicine-wheel/data-store-postgres": "^0.5.6",
+    "@medicine-wheel/fire-keeper": "^0.5.6",
+    "@medicine-wheel/github-ceremony": "^0.5.6",
+    "@medicine-wheel/graph-viz": "^0.5.6",
+    "@medicine-wheel/importance-unit": "^0.5.6",
+    "@medicine-wheel/mcp": "^4.5.5",
+    "@medicine-wheel/narrative-cluster": "^0.5.6",
+    "@medicine-wheel/narrative-engine": "^0.5.6",
+    "@medicine-wheel/ontology-core": "^0.5.6",
+    "@medicine-wheel/perception-layer": "^0.5.6",
+    "@medicine-wheel/prompt-decomposition": "^0.5.6",
+    "@medicine-wheel/relational-index": "^0.5.6",
+    "@medicine-wheel/relational-query": "^0.5.6",
+    "@medicine-wheel/session-reader": "^0.5.6",
+    "@medicine-wheel/storage-provider": "^0.5.6",
+    "@medicine-wheel/transformation-tracker": "^0.5.6",
+    "@medicine-wheel/ui-components": "^0.5.6",
     "@neondatabase/serverless": "^0.10.0",
     "@xyflow/react": "^12.3.0",
     "clsx": "^2.1.1",