mia-code 0.2.0 → 0.3.0

package/dist/sessionStore.js

@@ -3,6 +3,10 @@ import path from "path";
 import os from "os";
 const SESSIONS_FILE = path.join(os.homedir(), ".mia-code-sessions.json");
 const HISTORY_DIR = path.join(os.homedir(), ".mia-code-history");
+/** Build the engine-qualified key for byProjectRoot lookup. */
+function projectKey(projectRoot, engine) {
+    return engine ? `${engine}:${projectRoot}` : projectRoot;
+}
 function loadIndex() {
     if (!fs.existsSync(SESSIONS_FILE)) {
         return { byProjectRoot: {}, byId: {} };
@@ -25,7 +29,15 @@ function saveIndex(index) {
 export function rememberSession(meta) {
     const idx = loadIndex();
     if (meta.projectRoot) {
-        idx.byProjectRoot[meta.projectRoot] = meta;
+        // Store under engine-qualified key so each engine has its own "last session"
+        idx.byProjectRoot[projectKey(meta.projectRoot, meta.engine)] = meta;
+        // Clean up stale legacy (unqualified) entry if it points to this same session,
+        // preventing a different engine from claiming it via fallback.
+        const legacyKey = meta.projectRoot; // bare, no engine prefix
+        const legacy = idx.byProjectRoot[legacyKey];
+        if (legacy && legacy.id === meta.id && meta.engine) {
+            delete idx.byProjectRoot[legacyKey];
+        }
     }
     idx.byId[meta.id] = meta;
     saveIndex(idx);
@@ -36,7 +48,7 @@ export function markSessionInitialized(id) {
     if (session) {
         session.initialized = true;
         if (session.projectRoot) {
-            idx.byProjectRoot[session.projectRoot] = session;
+            idx.byProjectRoot[projectKey(session.projectRoot, session.engine)] = session;
         }
         saveIndex(idx);
     }
@@ -45,8 +57,32 @@ export function isSessionInitialized(id) {
     const idx = loadIndex();
     return idx.byId[id]?.initialized ?? false;
 }
-export function getLastSessionForProject(projectRoot) {
+/**
+ * Get the last session for a project, optionally filtered by engine.
+ * When engine is provided, only returns a session owned by that engine.
+ * Falls back to legacy unqualified key if no engine-specific entry exists
+ * (for backward compatibility with pre-engine sessions).
+ */
+export function getLastSessionForProject(projectRoot, engine) {
     const idx = loadIndex();
+    // Try engine-qualified key first
+    if (engine) {
+        const qualified = idx.byProjectRoot[projectKey(projectRoot, engine)];
+        if (qualified)
+            return qualified;
+        // Fallback: check unqualified key for legacy sessions that match engine
+        const legacy = idx.byProjectRoot[projectRoot];
+        if (legacy && (legacy.engine === engine || !legacy.engine)) {
+            // Migrate: promote to engine-qualified key and remove stale legacy entry
+            // so no other engine can claim it via the same fallback path.
+            idx.byProjectRoot[projectKey(projectRoot, engine)] = { ...legacy, engine };
+            delete idx.byProjectRoot[projectRoot];
+            saveIndex(idx);
+            return { ...legacy, engine };
+        }
+        return null;
+    }
+    // No engine filter — return whatever is there (unqualified key)
     return idx.byProjectRoot[projectRoot] ?? null;
 }
 export function getSessionById(id) {

package/dist/types.d.ts

@@ -15,6 +15,7 @@ export interface MiaCodeSessionMeta {
     id: string;
     startedAt: string;
     model: string;
+    engine?: Engine;
     projectRoot: string | null;
     initialized?: boolean;
 }

package/miaco/README.md

@@ -0,0 +1,124 @@
+# 🔧 miaco - Engineering World Terminal Agent
+
+**miaco** (pronounced mee-AH-koh) is the **Engineering World CLI Agent** within the mia-code ecosystem. While `miatel` handles story world and `miawa` handles ceremony, miaco is the terminal interface for **schema design, validation, and system architecture**.
+
+## 🗺️ Kinship Map
+
+```
+/src/mia-code/                              ← Parent Package
+├── miaco/                                  ← Engineering World CLI (this one)
+├── miatel/                                 ← Story World CLI
+└── miawa/                                  ← Ceremony World CLI
+
+CONNECTS TO:
+├── /workspace/langchain/.../narrative-tracing/    ← Tracing adapters
+├── /workspace/langgraph/.../narrative-intelligence/ ← Analysis toolkit
+└── /src/coaia-planning/                           ← Structural tension
+```
+
+## What miaco Does
+
+### Schema Operations
+```bash
+miaco schema design --name 'HeroJourney' --type story
+miaco schema list --type character
+miaco schema export --name hero_journey --output ./schema.json
+miaco schema migrate --from v1 --to v2
+```
+
+### Validation Operations
+```bash
+miaco validate ncp --file ./story.ncp.json --strict
+miaco validate beat --file ./beat.json
+miaco validate coherence --session session_123
+miaco validate types --project ./tsconfig.json
+```
+
+### Tracing Operations
+```bash
+miaco trace start --session my-session --story hero-journey --langfuse
+miaco trace log --event BEAT_GENERATED --data '{"beat_id": "beat_001"}'
+miaco trace end --export ./trace.json
+miaco trace list --limit 10
+miaco trace view trace_abc123 --format timeline
+miaco trace correlation --session my-session --story hero-journey
+```
+
+### Structural Tension Chart Operations
+```bash
+miaco chart create --outcome 'Working CLI' --reality 'Scaffolding exists'
+miaco chart list
+miaco chart add-step --chart chart_123 --title 'Build commands' --reality 'Started'
+miaco chart complete --step 'Build commands'
+miaco chart review --chart chart_123
+```
+
+## Installation
+
+```bash
+cd /src/mia-code/miaco
+npm install
+npm run build
+npm link  # optional, for global install
+```
+
+## The Three Universes Lens
+
+miaco primarily represents **Engineering World (Mia)**:
+
+| Universe | Lens | Key Question |
+|----------|------|--------------|
+| 🔧 ENGINEER | Mia (this one) | Is the schema valid? Are types correct? |
+| 🙏 CEREMONY | Ava8 | Is K'é honored? Is there sacred pause? |
+| 📖 STORY_ENGINE | Miette | Is the arc coherent? Do themes thread? |
+
+## Structural Tension Charts
+
+Based on Robert Fritz's creative process:
+
+```
+┌─────────────────────────────────────────┐
+│ DESIRED OUTCOME                         │
+│ What you want to CREATE (not fix)       │
+│                                         │
+│         ↑  STRUCTURAL TENSION  ↑        │
+│                                         │
+│ CURRENT REALITY                         │
+│ Honest factual assessment               │
+└─────────────────────────────────────────┘
+```
+
+The tension between outcome and reality drives creative advancement.
+
+## Cross-System Tracing
+
+miaco provides correlation headers for unified traces across:
+- LangChain narrative-tracing
+- LangGraph narrative-intelligence
+- Miadi webhooks
+- Storytelling package
+
+```bash
+miaco trace correlation --session my-session --story hero-journey
+# Outputs:
+#   X-Narrative-Trace-Id: trace_abc123
+#   X-Session-Id: my-session
+#   X-Story-Id: hero-journey
+```
+
+## Development
+
+```bash
+# Run in development mode
+npm run dev
+
+# Build TypeScript
+npm run build
+
+# Run built version
+npm start
+```
+
+---
+
+*miaco: Where architecture becomes observable.*

package/miaco/dist/commands/chart.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Chart command - Structural tension chart operations
+ */
+import { Command } from "commander";
+export declare const chartCommand: Command;
+//# sourceMappingURL=chart.d.ts.map

package/miaco/dist/commands/chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../src/commands/chart.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,YAAY,SACoC,CAAC"}

package/miaco/dist/commands/chart.js

@@ -0,0 +1,222 @@
+/**
+ * Chart command - Structural tension chart operations
+ */
+import { Command } from "commander";
+import chalk from "chalk";
+import { SessionStorage } from "../storage.js";
+const CHARTS_FILE = "charts.jsonl";
+export const chartCommand = new Command("chart")
+    .description("Structural tension chart operations (COAIA)");
+chartCommand
+    .command("create")
+    .description("Create a new structural tension chart")
+    .requiredOption("--outcome <text>", "Desired outcome (what you want to CREATE)")
+    .requiredOption("--reality <text>", "Current reality (factual assessment)")
+    .option("--due <date>", "Due date (ISO format)")
+    .option("--session <id>", "Session ID")
+    .option("--json", "Output JSON for programmatic parsing")
+    .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const chartId = `chart_${Date.now().toString(36)}`;
+    const chart = {
+        id: chartId,
+        outcome: opts.outcome,
+        reality: opts.reality,
+        dueDate: opts.due,
+        steps: [],
+        createdAt: Date.now(),
+        updatedAt: Date.now()
+    };
+    storage.append(CHARTS_FILE, chart);
+    if (opts.json) {
+        console.log(JSON.stringify({ success: true, chart }));
+    }
+    else {
+        console.log(chalk.bold("🔧 Creating Structural Tension Chart"));
+        console.log();
+        console.log(chalk.dim("  ┌─────────────────────────────────────────┐"));
+        console.log(chalk.dim("  │ DESIRED OUTCOME                         │"));
+        console.log(chalk.dim(`  │ ${opts.outcome.substring(0, 39).padEnd(39)} │`));
+        console.log(chalk.dim("  │                                         │"));
+        console.log(chalk.dim("  │         ↑  STRUCTURAL TENSION  ↑        │"));
+        console.log(chalk.dim("  │                                         │"));
+        console.log(chalk.dim("  │ CURRENT REALITY                         │"));
+        console.log(chalk.dim(`  │ ${opts.reality.substring(0, 39).padEnd(39)} │`));
+        console.log(chalk.dim("  └─────────────────────────────────────────┘"));
+        console.log();
+        console.log(chalk.green(`  ✓ Chart created: ${chartId}`));
+        console.log(chalk.dim(`  Session: ${storage.getSessionId()}`));
+        console.log(chalk.dim("  Add action steps with: miaco chart add-step --chart " + chartId));
+    }
+});
+chartCommand
+    .command("list")
+    .description("List active structural tension charts")
+    .option("--session <id>", "Session ID")
+    .option("--json", "Output JSON for programmatic parsing")
+    .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const charts = storage.readAll(CHARTS_FILE);
+    if (opts.json) {
+        console.log(JSON.stringify({ charts }));
+    }
+    else {
+        console.log(chalk.bold("🔧 Active Charts"));
+        console.log(chalk.dim(`  Session: ${storage.getSessionId()}`));
+        console.log();
+        if (charts.length === 0) {
+            console.log(chalk.dim("  No charts created yet. Use `miaco chart create` to begin."));
+        }
+        else {
+            charts.forEach((chart, i) => {
+                const completedSteps = chart.steps.filter(s => s.completed).length;
+                const totalSteps = chart.steps.length;
+                const progress = totalSteps > 0 ? `${completedSteps}/${totalSteps} steps` : "no steps";
+                console.log(chalk.bold(`  ${i + 1}. ${chart.id}`));
+                console.log(chalk.dim(`     Outcome: ${chart.outcome.substring(0, 50)}...`));
+                console.log(chalk.dim(`     Reality: ${chart.reality.substring(0, 50)}...`));
+                console.log(chalk.dim(`     Progress: ${progress}`));
+                if (chart.dueDate) {
+                    console.log(chalk.dim(`     Due: ${chart.dueDate}`));
+                }
+                console.log();
+            });
+        }
+    }
+});
+chartCommand
+    .command("add-step")
+    .description("Add an action step to a chart")
+    .requiredOption("--chart <id>", "Chart ID")
+    .requiredOption("--title <text>", "Action step title")
+    .requiredOption("--reality <text>", "Current reality for this step")
+    .option("--session <id>", "Session ID")
+    .option("--json", "Output JSON for programmatic parsing")
+    .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const chart = storage.findById(CHARTS_FILE, opts.chart);
+    if (!chart) {
+        if (opts.json) {
+            console.log(JSON.stringify({ success: false, error: "Chart not found" }));
+        }
+        else {
+            console.log(chalk.yellow(`  ⚠ Chart not found: ${opts.chart}`));
+        }
+        return;
+    }
+    const stepId = `step_${Date.now().toString(36)}`;
+    const step = {
+        id: stepId,
+        title: opts.title,
+        reality: opts.reality,
+        completed: false
+    };
+    const updated = storage.update(CHARTS_FILE, opts.chart, (c) => ({
+        ...c,
+        steps: [...c.steps, step],
+        updatedAt: Date.now()
+    }));
+    if (opts.json) {
+        console.log(JSON.stringify({ success: updated, step }));
+    }
+    else {
+        console.log(chalk.bold("🔧 Adding Action Step"));
+        console.log(chalk.dim(`  Chart: ${opts.chart}`));
+        console.log(chalk.dim(`  Step: ${opts.title}`));
+        console.log(chalk.dim(`  Reality: ${opts.reality}`));
+        console.log();
+        console.log(chalk.green(`  ✓ Step added: ${stepId}`));
+    }
+});
+chartCommand
+    .command("complete")
+    .description("Mark an action step as complete")
+    .requiredOption("--step <name>", "Action step name or ID")
+    .option("--session <id>", "Session ID")
+    .option("--json", "Output JSON for programmatic parsing")
+    .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const charts = storage.readAll(CHARTS_FILE);
+    let found = false;
+    for (const chart of charts) {
+        const stepIndex = chart.steps.findIndex(s => s.id === opts.step || s.title.toLowerCase() === opts.step.toLowerCase());
+        if (stepIndex !== -1) {
+            storage.update(CHARTS_FILE, chart.id, (c) => {
+                c.steps[stepIndex].completed = true;
+                c.steps[stepIndex].completedAt = Date.now();
+                c.updatedAt = Date.now();
+                return c;
+            });
+            found = true;
+            if (opts.json) {
+                console.log(JSON.stringify({ success: true, chartId: chart.id, step: chart.steps[stepIndex] }));
+            }
+            else {
+                console.log(chalk.bold("🔧 Completing Action Step"));
+                console.log(chalk.dim(`  Step: ${opts.step}`));
+                console.log(chalk.green(`  ✓ Step marked complete`));
+            }
+            break;
+        }
+    }
+    if (!found) {
+        if (opts.json) {
+            console.log(JSON.stringify({ success: false, error: "Step not found" }));
+        }
+        else {
+            console.log(chalk.yellow(`  ⚠ Step not found: ${opts.step}`));
+        }
+    }
+});
+chartCommand
+    .command("review")
+    .description("Creator Moment of Truth - review chart progress")
+    .requiredOption("--chart <id>", "Chart ID to review")
+    .option("--session <id>", "Session ID")
+    .option("--json", "Output JSON for programmatic parsing")
+    .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const chart = storage.findById(CHARTS_FILE, opts.chart);
+    if (!chart) {
+        if (opts.json) {
+            console.log(JSON.stringify({ success: false, error: "Chart not found" }));
+        }
+        else {
+            console.log(chalk.yellow(`  ⚠ Chart not found: ${opts.chart}`));
+        }
+        return;
+    }
+    const completedSteps = chart.steps.filter(s => s.completed);
+    const pendingSteps = chart.steps.filter(s => !s.completed);
+    if (opts.json) {
+        console.log(JSON.stringify({
+            chart,
+            completedSteps: completedSteps.length,
+            pendingSteps: pendingSteps.length,
+            progress: chart.steps.length > 0
+                ? Math.round((completedSteps.length / chart.steps.length) * 100)
+                : 0
+        }));
+    }
+    else {
+        console.log(chalk.bold("🔧 Creator Moment of Truth"));
+        console.log(chalk.dim(`  Chart: ${opts.chart}`));
+        console.log();
+        console.log(chalk.bold("  OUTCOME:"));
+        console.log(chalk.dim(`    ${chart.outcome}`));
+        console.log();
+        console.log(chalk.bold("  CURRENT REALITY:"));
+        console.log(chalk.dim(`    ${chart.reality}`));
+        console.log();
+        console.log(chalk.bold("  PROGRESS:"));
+        console.log(chalk.dim(`    Completed: ${completedSteps.length} steps`));
+        console.log(chalk.dim(`    Pending: ${pendingSteps.length} steps`));
+        console.log();
+        console.log(chalk.dim("  Four-step review process:"));
+        console.log(chalk.dim("    1. Acknowledge - What did we expect vs deliver?"));
+        console.log(chalk.dim("    2. Analyze - What caused the discrepancy?"));
+        console.log(chalk.dim("    3. Plan - What adjustments are needed?"));
+        console.log(chalk.dim("    4. Feedback - What did we learn?"));
+    }
+});
+//# sourceMappingURL=chart.js.map

package/miaco/dist/commands/chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.js","sourceRoot":"","sources":["../../src/commands/chart.ts"],"names":[],"mappings":"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"}

package/miaco/dist/commands/decompose.d.ts

@@ -0,0 +1,6 @@
+/**
+ * miaco decompose — CLI command for multi-engine prompt decomposition
+ */
+import { Command } from "commander";
+export declare const decomposeCommand: Command;
+//# sourceMappingURL=decompose.d.ts.map

package/miaco/dist/commands/decompose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompose.d.ts","sourceRoot":"","sources":["../../src/commands/decompose.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,eAAO,MAAM,gBAAgB,SAkG1B,CAAC"}

package/miaco/dist/commands/decompose.js

@@ -0,0 +1,98 @@
+/**
+ * miaco decompose — CLI command for multi-engine prompt decomposition
+ */
+import { Command } from "commander";
+import chalk from "chalk";
+import { decomposeAndStore, listDecompositions, loadDecomposition, } from "../decompose.js";
+export const decomposeCommand = new Command("decompose")
+    .description("🔧 Prompt decomposition via Four Directions (multi-engine)")
+    .addCommand(new Command("run")
+    .description("Decompose a prompt using the specified engine")
+    .requiredOption("-p, --prompt <text>", "Prompt to decompose")
+    .option("-e, --engine <engine>", "Engine: copilot | claude | gemini", "copilot")
+    .option("-m, --model <model>", "Model override")
+    .option("--parent <uuid>", "Parent PDE UUID for nesting")
+    .option("-w, --workdir <path>", "Working directory for .pde/ storage")
+    .option("--json", "Output raw JSON")
+    .action(async (opts) => {
+    // 🧠 MIAC-18: Prevent premium model usage for decompose with copilot engine
+    if (opts.engine === "copilot" && opts.model) {
+        const modelLower = opts.model.toLowerCase();
+        if (modelLower.includes("opus") || modelLower.includes("sonnet")) {
+            console.error(chalk.red("🧠: Error: Using 'opus' or 'sonnet' models with the 'copilot' engine for 'decompose' is not permitted as it consumes premium tokens unnecessarily. Please use a cost-effective alternative. Optimal choices are `copilot -m haiku` or `copilot -m gpt-5-mini`."));
+            process.exit(1);
+        }
+    }
+    try {
+        const stored = await decomposeAndStore({
+            prompt: opts.prompt,
+            engine: opts.engine,
+            model: opts.model,
+            workdir: opts.workdir,
+            parentPdeId: opts.parent,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(stored, null, 2));
+        }
+        else {
+            console.log(chalk.bold(`🔧 Decomposition complete`));
+            console.log(chalk.dim(`  Engine: ${stored.engine}${stored.model ? ` (${stored.model})` : ""}`));
+            console.log(chalk.dim(`  ID: ${stored.id}`));
+            console.log(chalk.dim(`  Stored: .pde/${stored.folder_name || stored.id}/`));
+            if (stored.parent_pde_id) {
+                console.log(chalk.dim(`  Parent: ${stored.parent_pde_id}`));
+            }
+            console.log();
+            console.log(chalk.bold("  Primary:"), `${stored.result.primary.action} → ${stored.result.primary.target}`);
+            console.log(chalk.bold("  Secondary:"), `${stored.result.secondary.length} intents`);
+            console.log(chalk.bold("  Actions:"), `${stored.result.actionStack.length} items`);
+            console.log(chalk.bold("  Ambiguities:"), `${stored.result.ambiguities.length} flags`);
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+}))
+    .addCommand(new Command("list")
+    .description("List stored decompositions")
+    .option("-w, --workdir <path>", "Working directory")
+    .option("-l, --limit <n>", "Limit results", "10")
+    .option("--json", "Output raw JSON")
+    .action((opts) => {
+    const items = listDecompositions(opts.workdir || process.cwd(), parseInt(opts.limit));
+    if (opts.json) {
+        console.log(JSON.stringify(items.map(i => ({
+            id: i.id, timestamp: i.timestamp, engine: i.engine,
+            primary: `${i.result.primary.action} → ${i.result.primary.target}`,
+        })), null, 2));
+    }
+    else {
+        if (items.length === 0) {
+            console.log(chalk.dim("  No decompositions stored in .pde/"));
+            return;
+        }
+        for (const item of items) {
+            console.log(`  ${chalk.dim(item.timestamp)} ${chalk.bold(item.id.substring(0, 8))} [${item.engine}] ${item.result.primary.action} → ${item.result.primary.target}`);
+        }
+    }
+}))
+    .addCommand(new Command("get")
+    .description("Get a stored decomposition by ID")
+    .argument("<id>", "Decomposition ID")
+    .option("-w, --workdir <path>", "Working directory")
+    .option("--json", "Output raw JSON")
+    .action((id, opts) => {
+    const item = loadDecomposition(opts.workdir || process.cwd(), id);
+    if (!item) {
+        console.error(chalk.red(`Not found: ${id}`));
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(item, null, 2));
+    }
+    else {
+        console.log(JSON.stringify(item, null, 2));
+    }
+}));
+//# sourceMappingURL=decompose.js.map

package/miaco/dist/commands/decompose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompose.js","sourceRoot":"","sources":["../../src/commands/decompose.ts"],"names":[],"mappings":"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"}

package/miaco/dist/commands/schema.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Schema command - NCP schema design and management
+ */
+import { Command } from "commander";
+export declare const schemaCommand: Command;
+//# sourceMappingURL=schema.d.ts.map

package/miaco/dist/commands/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,aAAa,SACwB,CAAC"}

package/miaco/dist/commands/schema.js

@@ -0,0 +1,66 @@
+/**
+ * Schema command - NCP schema design and management
+ */
+import { Command } from "commander";
+import chalk from "chalk";
+export const schemaCommand = new Command("schema")
+    .description("NCP schema design and management");
+schemaCommand
+    .command("design")
+    .description("Design a new NCP schema")
+    .requiredOption("-n, --name <name>", "Schema name")
+    .option("--type <type>", "Schema type: story, character, beat, theme")
+    .option("--extends <base>", "Base schema to extend")
+    .action(async (opts) => {
+    console.log(chalk.bold("🔧 Designing NCP Schema"));
+    console.log(chalk.dim(`  Name: ${opts.name}`));
+    console.log(chalk.dim(`  Type: ${opts.type || "custom"}`));
+    if (opts.extends)
+        console.log(chalk.dim(`  Extends: ${opts.extends}`));
+    console.log();
+    const schemaId = opts.name.toLowerCase().replace(/\s+/g, '_');
+    console.log(chalk.green(`  ✓ Schema designed: ${schemaId}`));
+    console.log(chalk.dim("  Export with: miaco schema export --name " + schemaId));
+});
+schemaCommand
+    .command("list")
+    .description("List available schemas")
+    .option("--type <type>", "Filter by type")
+    .action(async (opts) => {
+    console.log(chalk.bold("🔧 Available Schemas"));
+    console.log(chalk.dim(`  Type: ${opts.type || "all"}`));
+    console.log();
+    console.log(chalk.dim("  Built-in NCP schemas:"));
+    console.log(chalk.dim("    - StoryBeat (beat)"));
+    console.log(chalk.dim("    - CharacterArcState (character)"));
+    console.log(chalk.dim("    - NCPState (story)"));
+    console.log(chalk.dim("    - ThematicThread (theme)"));
+    console.log();
+    console.log(chalk.dim("  Custom schemas: 0"));
+});
+schemaCommand
+    .command("export")
+    .description("Export schema to JSON Schema format")
+    .requiredOption("-n, --name <name>", "Schema name")
+    .option("-o, --output <path>", "Output file path")
+    .action(async (opts) => {
+    console.log(chalk.bold("🔧 Exporting Schema"));
+    console.log(chalk.dim(`  Schema: ${opts.name}`));
+    console.log(chalk.dim(`  Output: ${opts.output || "stdout"}`));
+    console.log();
+    console.log(chalk.yellow("  ⚠ Schema not found. Use `miaco schema list` to see available."));
+});
+schemaCommand
+    .command("migrate")
+    .description("Generate migration between schema versions")
+    .requiredOption("--from <version>", "Source version")
+    .requiredOption("--to <version>", "Target version")
+    .option("-n, --name <name>", "Schema name")
+    .action(async (opts) => {
+    console.log(chalk.bold("🔧 Schema Migration"));
+    console.log(chalk.dim(`  Schema: ${opts.name || "all"}`));
+    console.log(chalk.dim(`  From: ${opts.from} → To: ${opts.to}`));
+    console.log();
+    console.log(chalk.dim("  No migrations needed (or no schemas to migrate)."));
+});
+//# sourceMappingURL=schema.js.map