@medicine-wheel/app 0.2.4 → 0.2.7

package/dist/cli/mw.js

@@ -45,6 +45,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
+const skills_1 = require("./skills");
 // ── Config ────────────────────────────────────────────────────────
 const MW_API_URL = process.env.MW_API_URL ?? 'http://localhost:3940';
 const MW_FORMAT = process.env.MW_FORMAT ?? 'pretty';
@@ -254,6 +255,10 @@ ${C.bold}🌿 mw — Medicine Wheel CLI${C.reset}
     mw validate accountability <plan_json> Accountability audit
     mw validate bridge <concept> [dir]     Two-Eyed Seeing bridge
 
+  SKILLS
+    mw skill view                          List available CLI skills
+    mw skill install [name]                Install a skill (or all)
+
   MEMORY
     mw memory store <key> <value> [dir]   Store relational memory
 
@@ -632,6 +637,24 @@ function cmdValidate(positional) {
             console.error(`Unknown validate sub-command: ${sub}`);
     }
 }
+// ── Skill ─────────────────────────────────────────────────────────
+function cmdSkill(positional) {
+    const sub = positional[0] ?? 'view';
+    switch (sub) {
+        case 'view':
+        case 'list':
+            (0, skills_1.viewSkills)('cli', C);
+            break;
+        case 'install': {
+            const name = positional[1]; // undefined means install all
+            (0, skills_1.installSkill)('cli', name, C);
+            break;
+        }
+        default:
+            console.error(`Unknown skill sub-command: ${sub}`);
+            console.error("Available: view, install");
+    }
+}
 // ── Memory ────────────────────────────────────────────────────────
 function cmdMemory(positional) {
     const sub = positional[0] ?? 'store';
@@ -716,6 +739,10 @@ async function main() {
         case 'mem':
             cmdMemory(rest);
             break;
+        case 'skill':
+        case 'sk':
+            cmdSkill(rest);
+            break;
         case 'arc':
             mcpCall('get_narrative_arc', { cycle_id: rest[0] ?? '' });
             break;

package/dist/cli/mwsrv.js

@@ -54,7 +54,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
+const skills_1 = require("./skills");
 const DOCKER_IMAGE = 'jgwill/medicine-wheel:app';
+const C = {
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    green: '\x1b[32m',
+    south: '\x1b[31m',
+    reset: '\x1b[0m',
+};
 const DEFAULT_PORT = 3940;
 const CONTAINER_PORT = 3940;
 function parseArgs(argv) {
@@ -195,6 +203,24 @@ function runLocal(opts) {
     process.on('SIGTERM', shutdown);
     proc.on('exit', (code) => process.exit(code ?? 0));
 }
+// ── Skill ─────────────────────────────────────────────────────────
+function cmdSkill(positional) {
+    const sub = positional[0] ?? 'view';
+    switch (sub) {
+        case 'view':
+        case 'list':
+            (0, skills_1.viewSkills)('srv', C);
+            break;
+        case 'install': {
+            const name = positional[1]; // undefined means install all
+            (0, skills_1.installSkill)('srv', name, C);
+            break;
+        }
+        default:
+            console.error(`Unknown skill sub-command: ${sub}`);
+            console.error("Available: view, install");
+    }
+}
 // ── Help ──────────────────────────────────────────────────────────
 function showHelp() {
     console.log(`
@@ -215,6 +241,10 @@ OPTIONS
   --no-open               Do not auto-open browser
   --help, -h              Show this help
 
+SKILLS
+  mwsrv skill view                List available server skills
+  mwsrv skill install [name]      Install a skill (or all)
+
 EXAMPLES
   # Start locally (uses current directory's .mw/store)
   mwsrv
@@ -239,11 +269,15 @@ ENVIRONMENT
 }
 // ── Main ──────────────────────────────────────────────────────────
 async function main() {
-    const { flags } = parseArgs(process.argv);
+    const { flags, positional } = parseArgs(process.argv);
     if (flags['help'] || flags['h']) {
         showHelp();
         return;
     }
+    if (positional[0] === 'skill' || positional[0] === 'sk') {
+        cmdSkill(positional.slice(1));
+        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

@@ -0,0 +1,356 @@
+"use strict";
+/**
+ * Shared skill registry and management for Medicine Wheel CLIs.
+ *
+ * Skills are curated capabilities that can be installed into a local
+ * `.mw/skills/` directory.  Each CLI (mw, mwsrv) exposes its own
+ * relevant subset via `skill view` and `skill install`.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSkills = listSkills;
+exports.getSkill = getSkill;
+exports.getComplement = getComplement;
+exports.viewSkills = viewSkills;
+exports.installSkill = installSkill;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ── Built-in skill catalog ───────────────────────────────────────
+const SKILLS = [
+    // ── CLI skills (mw) ────────────────────────────────────────────
+    {
+        name: 'direction-inquiry',
+        title: 'Direction Inquiry',
+        description: 'Analyze tasks through the Four Directions (East / South / West / North)',
+        target: 'cli',
+        complement: 'api-health',
+        body: `# Skill: Direction Inquiry
+
+## Purpose
+Analyze an engineering task using the Four Directions framework.
+
+## Input
+- Engineering task description
+- Optional: constraints, repo paths
+
+## Output
+- **East** — vision statement
+- **South** — analysis questions
+- **West** — validation checks
+- **North** — action stack
+- Ceremony recommendation if balance is poor
+
+## Usage
+\`\`\`
+mw skill run direction-inquiry "Refactor auth module"
+\`\`\`
+`,
+    },
+    {
+        name: 'fire-keeper-check',
+        title: 'Fire Keeper Check',
+        description: 'Run gating and stewardship checks on proposed actions',
+        target: 'cli',
+        complement: 'session-manager',
+        body: `# Skill: Fire Keeper Check
+
+## Purpose
+Evaluate a proposed action against permission tiers and relational gates.
+
+## Input
+- Proposed action description
+- Current permission tier
+- Current ceremony phase
+- Optional: Wilson / OCAP metadata
+
+## Output
+- accept / hold / human-needed assessment
+- Unsatisfied gates
+- Check-back step results
+- Suggested next move
+
+## Usage
+\`\`\`
+mw skill run fire-keeper-check "Deploy to production"
+\`\`\`
+`,
+    },
+    {
+        name: 'wave-spec-generator',
+        title: 'Wave Spec Generator',
+        description: 'Generate .pde wave specifications for development cycles',
+        target: 'cli',
+        complement: 'storage-config',
+        body: `# Skill: Wave Spec Generator
+
+## Purpose
+Create a proposal-grade wave bundle matching current .pde practice.
+
+## Input
+- Goal description
+- Relevant specs
+- Target paths and constraints
+
+## Output
+- ORCHESTRATION.md
+- PROMPT.txt
+- artifacts/ checklist
+
+## Usage
+\`\`\`
+mw skill run wave-spec-generator "Add caching layer"
+\`\`\`
+`,
+    },
+    {
+        name: 'ceremony-guide',
+        title: 'Ceremony Guide',
+        description: 'Guide through ceremony lifecycle phases with protocol awareness',
+        target: 'cli',
+        complement: 'docker-setup',
+        body: `# Skill: Ceremony Guide
+
+## Purpose
+Provide step-by-step guidance through the ceremony lifecycle.
+
+## Input
+- Current ceremony state (or new ceremony intention)
+- Phase: opening / council / integration / closure
+
+## Output
+- Current phase assessment
+- Protocol requirements for next transition
+- Relational checks and community review prompts
+- Completion criteria
+
+## Usage
+\`\`\`
+mw skill run ceremony-guide "Community data review"
+\`\`\`
+`,
+    },
+    // ── Server skills (mwsrv) ─────────────────────────────────────
+    {
+        name: 'docker-setup',
+        title: 'Docker Setup',
+        description: 'Configure and validate Docker environment for Medicine Wheel server',
+        target: 'srv',
+        complement: 'ceremony-guide',
+        body: `# Skill: Docker Setup
+
+## Purpose
+Configure the Docker environment for running the Medicine Wheel server.
+
+## Checks
+- Docker daemon availability
+- Image pull status (jgwill/medicine-wheel:app)
+- Volume mount configuration
+- Port availability
+
+## Usage
+\`\`\`
+mwsrv skill run docker-setup
+\`\`\`
+`,
+    },
+    {
+        name: 'storage-config',
+        title: 'Storage Configuration',
+        description: 'Configure and validate storage providers (JSONL / PostgreSQL)',
+        target: 'srv',
+        complement: 'wave-spec-generator',
+        body: `# Skill: Storage Configuration
+
+## Purpose
+Configure the storage backend for the Medicine Wheel server.
+
+## Supported Providers
+- **jsonl** — Local file-based storage (.mw/store/)
+- **postgres** — PostgreSQL via DATABASE_URL
+
+## Checks
+- Current MW_STORAGE_PROVIDER value
+- Data directory existence and permissions
+- PostgreSQL connectivity (if applicable)
+- Migration status
+
+## Usage
+\`\`\`
+mwsrv skill run storage-config
+\`\`\`
+`,
+    },
+    {
+        name: 'api-health',
+        title: 'API Health Monitor',
+        description: 'Monitor and diagnose API endpoint health and connectivity',
+        target: 'srv',
+        complement: 'direction-inquiry',
+        body: `# Skill: API Health Monitor
+
+## Purpose
+Check the health and connectivity of Medicine Wheel API endpoints.
+
+## Checks
+- Server reachability (MW_API_URL)
+- Core endpoint status (/api/directions, /api/ceremonies, /api/nodes)
+- Response time measurements
+- Storage layer connectivity
+
+## Usage
+\`\`\`
+mwsrv skill run api-health
+\`\`\`
+`,
+    },
+    {
+        name: 'session-manager',
+        title: 'Session Manager',
+        description: 'Manage and inspect active server sessions and connections',
+        target: 'srv',
+        complement: 'fire-keeper-check',
+        body: `# Skill: Session Manager
+
+## Purpose
+Inspect and manage active sessions on the Medicine Wheel server.
+
+## Capabilities
+- List active sessions
+- Inspect session state and ceremony context
+- View session data directory contents
+- Cleanup stale session data
+
+## Usage
+\`\`\`
+mwsrv skill run session-manager
+\`\`\`
+`,
+    },
+];
+// ── Helpers ───────────────────────────────────────────────────────
+function getSkillsDir() {
+    const dataDir = process.env.MW_DATA_DIR
+        ?? path.join(process.cwd(), '.mw');
+    return path.join(dataDir, 'skills');
+}
+function isInstalled(skill) {
+    const dir = getSkillsDir();
+    return fs.existsSync(path.join(dir, skill.name, 'SKILL.md'));
+}
+// ── Public API ────────────────────────────────────────────────────
+/** Return all skills for the given target binary. */
+function listSkills(target) {
+    return SKILLS.filter((s) => s.target === target);
+}
+/** Return a single skill by name. */
+function getSkill(name) {
+    return SKILLS.find((s) => s.name === name);
+}
+/** Return the complement skill for a given skill. */
+function getComplement(skill) {
+    return skill.complement ? getSkill(skill.complement) : undefined;
+}
+/**
+ * Print skill catalog for the given target.
+ *
+ * @param target  Which binary's skills to show ('cli' | 'srv')
+ * @param colors  ANSI colour map (must include bold, dim, green, reset)
+ */
+function viewSkills(target, colors) {
+    const skills = listSkills(target);
+    const label = target === 'cli' ? 'mw' : 'mwsrv';
+    console.log(`\n  ${colors.bold}🌿 ${label} skills (${skills.length} available)${colors.reset}\n`);
+    for (const s of skills) {
+        const installed = isInstalled(s);
+        const marker = installed
+            ? `${colors.green}✓${colors.reset}`
+            : `${colors.dim}○${colors.reset}`;
+        const comp = s.complement
+            ? `${colors.dim} ↔ ${s.complement}${colors.reset}`
+            : '';
+        console.log(`  ${marker} ${s.name.padEnd(24)} ${s.description}${comp}`);
+    }
+    console.log('');
+}
+/**
+ * Install a skill (or all skills) for the given target.
+ *
+ * @returns number of newly installed skills
+ */
+function installSkill(target, name, colors) {
+    const C = colors ?? { bold: '', dim: '', green: '', south: '', reset: '' };
+    const dir = getSkillsDir();
+    const toInstall = name
+        ? SKILLS.filter((s) => s.name === name && s.target === target)
+        : listSkills(target);
+    if (name && toInstall.length === 0) {
+        // Check if the skill exists for the other target
+        const other = SKILLS.find((s) => s.name === name);
+        if (other) {
+            const otherLabel = other.target === 'cli' ? 'mw' : 'mwsrv';
+            console.error(`${C.south}Skill "${name}" belongs to ${otherLabel}, not this CLI.${C.reset}`);
+        }
+        else {
+            console.error(`${C.south}Unknown skill: ${name}${C.reset}`);
+        }
+        return 0;
+    }
+    let installed = 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}`);
+            continue;
+        }
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.writeFileSync(skillFile, skill.body, 'utf8');
+        installed++;
+        console.log(`  ${C.green}✓${C.reset} Installed ${skill.name}`);
+        // Show complement relationship
+        const comp = getComplement(skill);
+        if (comp) {
+            const compLabel = comp.target === 'cli' ? 'mw' : 'mwsrv';
+            console.log(`    ${C.dim}↔ complement: ${comp.name} (${compLabel} skill install ${comp.name})${C.reset}`);
+        }
+    }
+    if (installed > 0) {
+        console.log(`\n  ${C.bold}${installed} skill(s) installed to ${dir}${C.reset}\n`);
+    }
+    else {
+        console.log(`\n  ${C.dim}All skills already installed.${C.reset}\n`);
+    }
+    return installed;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medicine-wheel/app",
-  "version": "0.2.4",
+  "version": "0.2.7",
   "description": "Medicine Wheel — Interactive visual layer for Indigenous relational research with Four Directions, ceremonies, and narrative arcs",
   "bin": {
     "mw": "dist/cli/mw.js",
@@ -81,23 +81,23 @@
     "clsx": "^2.1.1",
     "tailwind-merge": "^3.0.2",
     "recharts": "^2.15.4",
-    "@medicine-wheel/ontology-core": "^0.2.4",
-    "@medicine-wheel/ceremony-protocol": "^0.2.4",
-    "@medicine-wheel/narrative-engine": "^0.2.4",
-    "@medicine-wheel/graph-viz": "^0.2.4",
-    "@medicine-wheel/relational-query": "^0.2.4",
-    "@medicine-wheel/prompt-decomposition": "^0.2.4",
-    "@medicine-wheel/ui-components": "^0.2.4",
-    "@medicine-wheel/data-store": "^0.2.4",
-    "@medicine-wheel/session-reader": "^0.2.4",
-    "@medicine-wheel/fire-keeper": "^0.2.4",
-    "@medicine-wheel/importance-unit": "^0.2.4",
-    "@medicine-wheel/relational-index": "^0.2.4",
-    "@medicine-wheel/transformation-tracker": "^0.2.4",
-    "@medicine-wheel/storage-provider": "^0.2.4",
-    "@medicine-wheel/community-review": "^0.2.4",
-    "@medicine-wheel/consent-lifecycle": "^0.2.4",
-    "@medicine-wheel/data-store-postgres": "^0.2.4",
+    "@medicine-wheel/ontology-core": "^0.2.7",
+    "@medicine-wheel/ceremony-protocol": "^0.2.7",
+    "@medicine-wheel/narrative-engine": "^0.2.7",
+    "@medicine-wheel/graph-viz": "^0.2.7",
+    "@medicine-wheel/relational-query": "^0.2.7",
+    "@medicine-wheel/prompt-decomposition": "^0.2.7",
+    "@medicine-wheel/ui-components": "^0.2.7",
+    "@medicine-wheel/data-store": "^0.2.7",
+    "@medicine-wheel/session-reader": "^0.2.7",
+    "@medicine-wheel/fire-keeper": "^0.2.7",
+    "@medicine-wheel/importance-unit": "^0.2.7",
+    "@medicine-wheel/relational-index": "^0.2.7",
+    "@medicine-wheel/transformation-tracker": "^0.2.7",
+    "@medicine-wheel/storage-provider": "^0.2.7",
+    "@medicine-wheel/community-review": "^0.2.7",
+    "@medicine-wheel/consent-lifecycle": "^0.2.7",
+    "@medicine-wheel/data-store-postgres": "^0.2.7",
     "@neondatabase/serverless": "^0.10.0"
   },
   "devDependencies": {