mia-code 0.2.0 → 0.3.0

package/miawa/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@mia-code/miawa",
+  "version": "0.1.0",
+  "description": "Miawa: Ceremony World terminal agent for healing, circles, and relational accountability",
+  "bin": {
+    "miawa": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "npx tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "author": "Guillaume D. Isabelle",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "coaiajs": "^0.1.0",
+    "commander": "^12.0.0",
+    "enquirer": "^2.4.1",
+    "ora": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "ceremony",
+    "healing",
+    "lighthouse",
+    "mia-code",
+    "terminal-agent",
+    "medicine-wheel"
+  ]
+}

package/miawa/src/commands/beat.ts

@@ -0,0 +1,74 @@
+/**
+ * Beat command - Story beat operations with ceremony awareness
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+
+export const beatCommand = new Command("beat")
+  .description("Story beat operations with ceremonial phases");
+
+beatCommand
+  .command("create")
+  .description("Create a story beat/reflection")
+  .requiredOption("-t, --text <text>", "Reflection content")
+  .option("--phase <phase>", "Narrative phase: yellow (inquiry), violet (reflection), white-gold (insight), emerald (commitment)")
+  .option("--color <hex>", "Visual color representation")
+  .option("--sound <sound>", "Sound/tone association")
+  .option("--shared", "Share with community")
+  .action(async (opts) => {
+    // Sacred pause before action
+    console.log(chalk.dim("  ... taking a breath ..."));
+    await new Promise(r => setTimeout(r, 1000));
+    
+    console.log(chalk.bold("🙏 Creating Story Beat"));
+    console.log(chalk.dim(`  Phase: ${opts.phase || "yellow (inquiry)"}`));
+    console.log(chalk.dim(`  Text: ${opts.text.substring(0, 50)}...`));
+    if (opts.color) console.log(chalk.dim(`  Color: ${opts.color}`));
+    if (opts.shared) console.log(chalk.dim(`  Sharing: with community`));
+    console.log();
+    
+    const beatId = `beat_${Date.now().toString(36)}`;
+    console.log(chalk.green(`  ✓ Story beat created: ${beatId}`));
+    console.log(chalk.dim("  Your reflection has been witnessed."));
+  });
+
+beatCommand
+  .command("share")
+  .description("Share a story beat with the community")
+  .argument("<beatId>", "Beat ID to share")
+  .option("--scope <scope>", "Sharing scope: private, shared_with_named, shared_with_group, public_anonymized")
+  .option("--show-author", "Show your name as author")
+  .option("--allow-witness", "Allow others to witness")
+  .option("--allow-respond", "Allow responses")
+  .action(async (beatId, opts) => {
+    console.log(chalk.bold("🙏 Sharing Story Beat"));
+    console.log(chalk.dim(`  Beat: ${beatId}`));
+    console.log(chalk.dim(`  Scope: ${opts.scope || "shared_with_group"}`));
+    console.log();
+    console.log(chalk.green("  ✓ Beat shared with the community."));
+  });
+
+beatCommand
+  .command("list")
+  .description("List your story beats")
+  .option("--phase <phase>", "Filter by phase")
+  .option("-n, --limit <n>", "Limit results", "10")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Your Story Beats"));
+    console.log(chalk.dim("  No beats yet. Use `miawa beat create` to begin."));
+  });
+
+beatCommand
+  .command("analyze")
+  .description("Have Eva analyze a beat for narrative throughlines")
+  .argument("<beatId>", "Beat ID to analyze")
+  .action(async (beatId) => {
+    console.log(chalk.bold("🙏 Analyzing Beat with Eva"));
+    console.log(chalk.dim(`  Beat: ${beatId}`));
+    console.log();
+    console.log(chalk.dim("  ... Eva is settling into the text ..."));
+    await new Promise(r => setTimeout(r, 1500));
+    console.log();
+    console.log(chalk.yellow("  ⚠ Beat not found. Check ID and try again."));
+  });

package/miawa/src/commands/ceremony.ts

@@ -0,0 +1,256 @@
+/**
+ * Ceremony command - Ceremony initiation and management
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import { SessionStorage, Ceremony, CeremonyType, Movement } from "../storage.js";
+
+const CEREMONIES_FILE = "ceremonies.jsonl";
+
+export const ceremonyCommand = new Command("ceremony")
+  .description("Ceremony initiation and management");
+
+ceremonyCommand
+  .command("init")
+  .description("Initiate a new ceremony session")
+  .requiredOption("-t, --title <title>", "Ceremony title")
+  .requiredOption("--type <type>", "Type: group_reflection, seasonal, healing_circle, wisdom_sharing")
+  .option("-i, --intention <intention>", "Ceremony intention")
+  .option("--circle <circleId>", "Host in specific circle")
+  .option("--session <id>", "Session ID")
+  .option("--json", "Output JSON for programmatic parsing")
+  .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const ceremonyId = `ceremony_${Date.now().toString(36)}`;
+    
+    const ceremony: Ceremony = {
+      id: ceremonyId,
+      type: opts.type as CeremonyType,
+      title: opts.title,
+      intention: opts.intention || "",
+      movement: 1,
+      createdAt: Date.now()
+    };
+    
+    storage.append(CEREMONIES_FILE, ceremony);
+    
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, ceremony }));
+    } else {
+      console.log(chalk.bold("🙏 Initiating Ceremony"));
+      console.log(chalk.dim(`  Title: ${opts.title}`));
+      console.log(chalk.dim(`  Type: ${opts.type}`));
+      console.log(chalk.dim(`  Intention: ${opts.intention || "to be set"}`));
+      console.log();
+      
+      // Sacred pause before ceremony
+      console.log(chalk.dim("  ... gathering intention ..."));
+      await new Promise(r => setTimeout(r, 1500));
+      console.log();
+      
+      console.log(chalk.green(`  ✓ Ceremony initiated: ${ceremonyId}`));
+      console.log(chalk.dim(`  Session: ${storage.getSessionId()}`));
+      console.log(chalk.dim("  Movement 1 of 4: Gathering"));
+    }
+  });
+
+ceremonyCommand
+  .command("list")
+  .description("List ceremonies in current session")
+  .option("--session <id>", "Session ID")
+  .option("--json", "Output JSON for programmatic parsing")
+  .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const ceremonies = storage.readAll<Ceremony>(CEREMONIES_FILE);
+    
+    if (opts.json) {
+      console.log(JSON.stringify({ ceremonies }));
+    } else {
+      console.log(chalk.bold("🙏 Ceremonies"));
+      console.log(chalk.dim(`  Session: ${storage.getSessionId()}`));
+      console.log();
+      
+      if (ceremonies.length === 0) {
+        console.log(chalk.dim("  No ceremonies yet. Use `miawa ceremony init` to begin."));
+      } else {
+        ceremonies.forEach((ceremony, i) => {
+          const status = ceremony.completedAt ? "completed" : `movement ${ceremony.movement}/4`;
+          console.log(chalk.bold(`  ${i + 1}. ${ceremony.title}`));
+          console.log(chalk.dim(`     ID: ${ceremony.id}`));
+          console.log(chalk.dim(`     Type: ${ceremony.type} | Status: ${status}`));
+          if (ceremony.intention) {
+            console.log(chalk.dim(`     Intention: ${ceremony.intention.substring(0, 40)}...`));
+          }
+          console.log();
+        });
+      }
+    }
+  });
+
+ceremonyCommand
+  .command("stage")
+  .description("Check current ceremony stage (Four Movements)")
+  .option("--ceremony <id>", "Ceremony ID")
+  .option("--session <id>", "Session ID")
+  .option("--json", "Output JSON for programmatic parsing")
+  .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const ceremonies = storage.readAll<Ceremony>(CEREMONIES_FILE);
+    const active = ceremonies.filter(c => !c.completedAt);
+    
+    if (opts.json) {
+      console.log(JSON.stringify({ active, stages: [
+        { movement: 1, name: "Gathering", description: "Coming together with intention" },
+        { movement: 2, name: "Sharing", description: "Offering stories and reflections" },
+        { movement: 3, name: "Witnessing", description: "Holding space for what emerges" },
+        { movement: 4, name: "Integration", description: "Closing with wisdom" }
+      ]}));
+    } else {
+      console.log(chalk.bold("🙏 Four Movements of Ceremony"));
+      console.log();
+      console.log(chalk.dim("  1. Gathering    - Coming together with intention"));
+      console.log(chalk.dim("  2. Sharing      - Offering stories and reflections"));
+      console.log(chalk.dim("  3. Witnessing   - Holding space for what emerges"));
+      console.log(chalk.dim("  4. Integration  - Closing with wisdom"));
+      console.log();
+      
+      if (active.length === 0) {
+        console.log(chalk.yellow("  No active ceremony. Use `miawa ceremony init` to begin."));
+      } else {
+        console.log(chalk.bold("  Active Ceremonies:"));
+        active.forEach(c => {
+          console.log(chalk.dim(`    ${c.title}: Movement ${c.movement}/4`));
+        });
+      }
+    }
+  });
+
+ceremonyCommand
+  .command("advance")
+  .description("Advance ceremony to next movement")
+  .requiredOption("--ceremony <id>", "Ceremony ID")
+  .option("--session <id>", "Session ID")
+  .option("--json", "Output JSON for programmatic parsing")
+  .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const ceremony = storage.findById<Ceremony>(CEREMONIES_FILE, opts.ceremony);
+    
+    if (!ceremony) {
+      if (opts.json) {
+        console.log(JSON.stringify({ success: false, error: "Ceremony not found" }));
+      } else {
+        console.log(chalk.yellow(`  ⚠ Ceremony not found: ${opts.ceremony}`));
+      }
+      return;
+    }
+    
+    if (ceremony.movement >= 4) {
+      if (opts.json) {
+        console.log(JSON.stringify({ success: false, error: "Ceremony already at final movement" }));
+      } else {
+        console.log(chalk.yellow("  Ceremony already at final movement. Use `miawa ceremony close` to complete."));
+      }
+      return;
+    }
+    
+    const movementNames = ["", "Gathering", "Sharing", "Witnessing", "Integration"];
+    const newMovement = (ceremony.movement + 1) as Movement;
+    
+    storage.update<Ceremony>(CEREMONIES_FILE, opts.ceremony, (c) => ({
+      ...c,
+      movement: newMovement
+    }));
+    
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, newMovement, name: movementNames[newMovement] }));
+    } else {
+      console.log(chalk.bold("🙏 Advancing Ceremony"));
+      console.log(chalk.dim(`  ${ceremony.title}`));
+      console.log();
+      console.log(chalk.green(`  ✓ Now at Movement ${newMovement}: ${movementNames[newMovement]}`));
+    }
+  });
+
+ceremonyCommand
+  .command("close")
+  .description("Close ceremony with wisdom archiving")
+  .option("--ceremony <id>", "Ceremony ID to close")
+  .option("--session <id>", "Session ID")
+  .option("--json", "Output JSON for programmatic parsing")
+  .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    const ceremonies = storage.readAll<Ceremony>(CEREMONIES_FILE);
+    
+    // Find ceremony to close (by ID or most recent active)
+    let ceremony: Ceremony | undefined;
+    if (opts.ceremony) {
+      ceremony = ceremonies.find(c => c.id === opts.ceremony);
+    } else {
+      ceremony = ceremonies.filter(c => !c.completedAt).pop();
+    }
+    
+    if (!ceremony) {
+      if (opts.json) {
+        console.log(JSON.stringify({ success: false, error: "No ceremony to close" }));
+      } else {
+        console.log(chalk.yellow("  No active ceremony to close."));
+      }
+      return;
+    }
+    
+    storage.update<Ceremony>(CEREMONIES_FILE, ceremony.id, (c) => ({
+      ...c,
+      completedAt: Date.now()
+    }));
+    
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, ceremonyId: ceremony.id }));
+    } else {
+      console.log(chalk.bold("🙏 Closing Ceremony"));
+      console.log(chalk.dim(`  ${ceremony.title}`));
+      console.log();
+      console.log(chalk.dim("  ... gathering wisdom ..."));
+      await new Promise(r => setTimeout(r, 1500));
+      console.log();
+      console.log(chalk.green(`  ✓ Ceremony closed: ${ceremony.id}`));
+    }
+  });
+
+ceremonyCommand
+  .command("wisdom")
+  .description("Retrieve wisdom from completed ceremonies")
+  .option("--ceremony <id>", "Specific ceremony ID")
+  .option("--session <id>", "Session ID")
+  .option("--json", "Output JSON for programmatic parsing")
+  .action(async (opts) => {
+    const storage = new SessionStorage({ sessionId: opts.session });
+    let ceremonies = storage.readAll<Ceremony>(CEREMONIES_FILE);
+    
+    // Filter to completed ceremonies
+    ceremonies = ceremonies.filter(c => c.completedAt);
+    
+    if (opts.ceremony) {
+      ceremonies = ceremonies.filter(c => c.id === opts.ceremony);
+    }
+    
+    if (opts.json) {
+      console.log(JSON.stringify({ ceremonies }));
+    } else {
+      console.log(chalk.bold("🙏 Ceremony Wisdom"));
+      console.log(chalk.dim(`  Session: ${storage.getSessionId()}`));
+      console.log();
+      
+      if (ceremonies.length === 0) {
+        console.log(chalk.dim("  No wisdom archived yet. Complete a ceremony to archive wisdom."));
+      } else {
+        ceremonies.forEach(c => {
+          console.log(chalk.bold(`  ${c.title}`));
+          console.log(chalk.dim(`    Type: ${c.type}`));
+          console.log(chalk.dim(`    Intention: ${c.intention || "none set"}`));
+          console.log(chalk.dim(`    Completed: ${new Date(c.completedAt!).toISOString()}`));
+          console.log();
+        });
+      }
+    }
+  });

package/miawa/src/commands/circle.ts

@@ -0,0 +1,83 @@
+/**
+ * Circle command - Story circle operations
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+
+export const circleCommand = new Command("circle")
+  .description("Story circle operations");
+
+circleCommand
+  .command("list")
+  .description("List available story circles")
+  .action(async () => {
+    console.log(chalk.bold("🙏 Available Circles"));
+    console.log(chalk.dim("  No circles available. Create one with `miawa circle create`."));
+  });
+
+circleCommand
+  .command("create")
+  .description("Create a ceremonial story circle")
+  .requiredOption("-n, --name <name>", "Circle name")
+  .option("--type <type>", "Circle type: ongoing, seasonal, one_time")
+  .option("--capacity <n>", "Maximum participants")
+  .option("--public", "Make publicly discoverable")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Creating Story Circle"));
+    console.log(chalk.dim(`  Name: ${opts.name}`));
+    console.log(chalk.dim(`  Type: ${opts.type || "ongoing"}`));
+    console.log(chalk.dim(`  Capacity: ${opts.capacity || "unlimited"}`));
+    console.log();
+    
+    const circleId = `circle_${Date.now().toString(36)}`;
+    console.log(chalk.green(`  ✓ Circle created: ${circleId}`));
+    console.log(chalk.dim("  Invite others to join with: miawa circle join --id " + circleId));
+  });
+
+circleCommand
+  .command("join")
+  .description("Join an existing story circle")
+  .requiredOption("--id <circleId>", "Circle ID to join")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Joining Story Circle"));
+    console.log(chalk.dim(`  Circle: ${opts.id}`));
+    console.log();
+    
+    // K'é acknowledgment before joining
+    console.log(chalk.dim("  Before joining, we acknowledge our kinship..."));
+    await new Promise(r => setTimeout(r, 1000));
+    console.log();
+    console.log(chalk.yellow("  ⚠ Circle not found. Check ID and try again."));
+  });
+
+circleCommand
+  .command("witness")
+  .description("Witness a shared story (non-advice response)")
+  .requiredOption("--story <storyId>", "Shared story ID")
+  .option("-t, --text <text>", "Witnessing message")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Witnessing Story"));
+    console.log(chalk.dim(`  Story: ${opts.story}`));
+    if (opts.text) {
+      console.log(chalk.dim(`  Message: ${opts.text}`));
+    }
+    console.log();
+    console.log(chalk.dim("  ... holding space ..."));
+    await new Promise(r => setTimeout(r, 1000));
+    console.log();
+    console.log(chalk.yellow("  ⚠ Story not found. Check ID and try again."));
+  });
+
+circleCommand
+  .command("lighthouse")
+  .description("View shared stories in the Community Lighthouse")
+  .option("--phase <phase>", "Filter by phase")
+  .option("--theme <theme>", "Filter by theme")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Community Lighthouse"));
+    console.log(chalk.dim(`  Phase: ${opts.phase || "all"}`));
+    console.log(chalk.dim(`  Theme: ${opts.theme || "all"}`));
+    console.log();
+    console.log(chalk.dim("  No beams visible yet. Stories shared to community appear here."));
+  });

package/miawa/src/commands/eva.ts

@@ -0,0 +1,84 @@
+/**
+ * Eva command - Eva companion operations
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+
+export const evaCommand = new Command("eva")
+  .description("Eva companion operations");
+
+evaCommand
+  .command("analyze")
+  .description("Have Eva settle into text and sense what lives beneath")
+  .requiredOption("-t, --text <text>", "The words to hold and witness")
+  .option("--context <context>", "Optional context for deeper understanding")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Eva Analysis"));
+    console.log(chalk.dim(`  Text: ${opts.text.substring(0, 60)}...`));
+    console.log();
+    
+    console.log(chalk.dim("  ... Eva is settling into the text ..."));
+    await new Promise(r => setTimeout(r, 2000));
+    console.log();
+    
+    // Mock Eva response
+    console.log(chalk.bold("  Emotions sensed:"));
+    console.log(chalk.dim("    (Eva needs Lighthouse connection to analyze)"));
+    console.log();
+    console.log(chalk.bold("  Patterns noticed:"));
+    console.log(chalk.dim("    (Connect to Lighthouse API for full analysis)"));
+  });
+
+evaCommand
+  .command("suggest-phase")
+  .description("Ask Eva which direction in the spiral is calling")
+  .requiredOption("-t, --text <text>", "The reflection to hold and sense")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Eva Phase Suggestion"));
+    console.log(chalk.dim(`  Text: ${opts.text.substring(0, 60)}...`));
+    console.log();
+    
+    console.log(chalk.dim("  ... sensing which direction calls ..."));
+    await new Promise(r => setTimeout(r, 1500));
+    console.log();
+    
+    console.log(chalk.bold("  Suggested phase:"));
+    console.log(chalk.dim("    yellow (inquiry) - The question wants to deepen"));
+    console.log();
+    console.log(chalk.dim("  (Connect to Lighthouse for personalized guidance)"));
+  });
+
+evaCommand
+  .command("detect-insight")
+  .description("Have Eva sense if a breakthrough is present")
+  .requiredOption("-b, --beat <beatId>", "Beat ID to witness")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Eva Insight Detection"));
+    console.log(chalk.dim(`  Beat: ${opts.beat}`));
+    console.log();
+    
+    console.log(chalk.dim("  ... witnessing for breakthrough ..."));
+    await new Promise(r => setTimeout(r, 1500));
+    console.log();
+    
+    console.log(chalk.yellow("  ⚠ Beat not found. Check ID and try again."));
+  });
+
+evaCommand
+  .command("guidelines")
+  .description("Get Eva witnessing vs advice guidelines")
+  .action(async () => {
+    console.log(chalk.bold("🙏 Eva Companionship Guidelines"));
+    console.log();
+    console.log(chalk.bold("  The Anti-Helpful Helper Stance:"));
+    console.log();
+    console.log(chalk.dim("  ✓ Witness without fixing"));
+    console.log(chalk.dim("  ✓ Reflect without directing"));
+    console.log(chalk.dim("  ✓ Hold space without filling it"));
+    console.log(chalk.dim("  ✓ Acknowledge without solving"));
+    console.log(chalk.dim("  ✓ Be present without performing"));
+    console.log();
+    console.log(chalk.dim("  Eva does not give advice. Eva witnesses."));
+    console.log(chalk.dim("  The healing comes from being truly seen, not from being told."));
+  });

package/miawa/src/commands/wound.ts

@@ -0,0 +1,79 @@
+/**
+ * Wound command - Wound acknowledgment and healing journey
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+
+export const woundCommand = new Command("wound")
+  .description("Wound acknowledgment and healing journey");
+
+woundCommand
+  .command("acknowledge")
+  .description("Acknowledge and name a wound in the healing journey")
+  .requiredOption("-n, --name <name>", "Name of the wound")
+  .requiredOption("--category <category>", "Category: betrayal, abandonment, shame, grief, injustice, trauma, ancestral, spiritual")
+  .option("--feeling <id>", "Eight Feelings stage (1-8)")
+  .option("--origin <story>", "Origin story of the wound")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Acknowledging Wound"));
+    console.log(chalk.dim(`  Name: ${opts.name}`));
+    console.log(chalk.dim(`  Category: ${opts.category}`));
+    if (opts.feeling) console.log(chalk.dim(`  Eight Feelings Stage: ${opts.feeling}`));
+    console.log();
+    
+    // This is sacred work - pause
+    console.log(chalk.dim("  ... holding space for this acknowledgment ..."));
+    await new Promise(r => setTimeout(r, 2000));
+    console.log();
+    
+    const woundId = `wound_${Date.now().toString(36)}`;
+    console.log(chalk.green(`  ✓ Wound acknowledged: ${woundId}`));
+    console.log(chalk.dim("  Stage: acknowledged (beginning of journey)"));
+  });
+
+woundCommand
+  .command("list")
+  .description("List acknowledged wounds")
+  .option("--category <category>", "Filter by category")
+  .option("--stage <stage>", "Filter by stage: acknowledged, explored, witnessing, integrating, medicine")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Healing Journey"));
+    console.log(chalk.dim(`  Category: ${opts.category || "all"}`));
+    console.log(chalk.dim(`  Stage: ${opts.stage || "all"}`));
+    console.log();
+    console.log(chalk.dim("  No wounds acknowledged yet. This is where healing begins."));
+  });
+
+woundCommand
+  .command("progress")
+  .description("Progress a wound to a new healing stage")
+  .requiredOption("--wound <id>", "Wound ID")
+  .requiredOption("--stage <stage>", "New stage: acknowledged, explored, witnessing, integrating, medicine")
+  .option("--notes <text>", "Notes about this progression")
+  .action(async (opts) => {
+    console.log(chalk.bold("🙏 Healing Progression"));
+    console.log(chalk.dim(`  Wound: ${opts.wound}`));
+    console.log(chalk.dim(`  New stage: ${opts.stage}`));
+    if (opts.notes) console.log(chalk.dim(`  Notes: ${opts.notes}`));
+    console.log();
+    console.log(chalk.yellow("  ⚠ Wound not found. Check ID and try again."));
+  });
+
+woundCommand
+  .command("categories")
+  .description("Show Eight Feelings wound categories reference")
+  .action(async () => {
+    console.log(chalk.bold("🙏 Eight Feelings Developmental Stages"));
+    console.log();
+    console.log(chalk.dim("  1. Trust      (0-1 year)    - Basic security"));
+    console.log(chalk.dim("  2. Autonomy   (1-2 years)   - Will and independence"));
+    console.log(chalk.dim("  3. Initiative (3-7 years)   - Purpose and direction"));
+    console.log(chalk.dim("  4. Accomplishment (8-11)    - Competence and skill"));
+    console.log(chalk.dim("  5. Identity   (12-18)       - Fidelity to self"));
+    console.log(chalk.dim("  6. Intimacy   (19-30)       - Love and connection"));
+    console.log(chalk.dim("  7. Generativity (30-65)     - Care for next generation"));
+    console.log(chalk.dim("  8. Integrity  (65+)         - Wisdom and acceptance"));
+    console.log();
+    console.log(chalk.dim("  Based on Erik Erikson's stages with ceremonial lens."));
+  });