@joelbonito/mcp-server 5.2.1 → 5.4.0

package/dist/core/resources.js

@@ -89,18 +89,20 @@ ${agentList}
 
 When the user says "implement Epic X" or "implement Story Y.Z":
 
-1. Read backlog: \`docs/BACKLOG.md\`
-2. If \`docs/stories/\` doesn't exist, suggest running \`shard_epic.py shard\`
-3. Detect domain → Activate appropriate agent
-4. Implement following agent rules
-5. After completion, update progress
+1. Read \`docs/PROJECT_STATUS.md\` — know which story to open
+2. Open story file in \`docs/stories/STORY-*.md\` — full implementation context
+3. Validate dependencies (depends_on field must all be done)
+4. Activate agent indicated in story file's \`agent\` field
+5. Implement following agent rules
+6. Run finish_task.py to update backlog + story + PROJECT_STATUS
+
+> Backlog is just an index of checkboxes. Never read it for implementation context.
 
 ## Post-Define Flow
 
-After \`/define\` or \`/readiness\`:
-1. \`/track\` — Initialize tracking
-2. \`shard_epic.py shard\` — Split backlog into story files
-3. Start implementing Story 1.1
+After \`/define\`:
+1. \`/track\` — Verify progress
+2. Start implementing (PROJECT_STATUS tells you which story is next)
 `;
         return { contents: [{ uri: "inove://system-prompt", text: prompt, mimeType: "text/markdown" }] };
     });

package/dist/init.d.ts

@@ -1,13 +1,12 @@
 #!/usr/bin/env node
 /**
- * Bootstrap generator for Inove AI Framework (MCP Mode).
+ * CLI entry point for Inove AI Framework.
  *
- * Creates minimal instruction files that bridge /slash and @agent
- * patterns to the MCP tools (execute_workflow, activate_agent).
+ * Dispatches commands:
+ *   npx @joelbonito/mcp-server install   # Full framework install
+ *   npx @joelbonito/mcp-server update    # Update framework (preserves instruction files)
+ *   npx @joelbonito/mcp-server init      # MCP-only mode (lightweight bootstrap)
  *
- * Usage:
- *   npx @joelbonito/mcp-server init          # generates CLAUDE.md + AGENTS.md
- *   npx @joelbonito/mcp-server init --claude  # only CLAUDE.md
- *   npx @joelbonito/mcp-server init --codex   # only AGENTS.md
+ * The MCP server itself runs via `inove-mcp` (dist/index.js).
  */
 export {};

package/dist/init.js

@@ -1,17 +1,19 @@
 #!/usr/bin/env node
 /**
- * Bootstrap generator for Inove AI Framework (MCP Mode).
+ * CLI entry point for Inove AI Framework.
  *
- * Creates minimal instruction files that bridge /slash and @agent
- * patterns to the MCP tools (execute_workflow, activate_agent).
+ * Dispatches commands:
+ *   npx @joelbonito/mcp-server install   # Full framework install
+ *   npx @joelbonito/mcp-server update    # Update framework (preserves instruction files)
+ *   npx @joelbonito/mcp-server init      # MCP-only mode (lightweight bootstrap)
  *
- * Usage:
- *   npx @joelbonito/mcp-server init          # generates CLAUDE.md + AGENTS.md
- *   npx @joelbonito/mcp-server init --claude  # only CLAUDE.md
- *   npx @joelbonito/mcp-server init --codex   # only AGENTS.md
+ * The MCP server itself runs via `inove-mcp` (dist/index.js).
  */
 import { writeFileSync, existsSync } from "node:fs";
 import { resolve } from "node:path";
+// ---------------------------------------------------------------------------
+// MCP-only init (lightweight bootstrap)
+// ---------------------------------------------------------------------------
 const WORKFLOWS = [
     "define", "debug", "create", "brainstorm", "enhance", "deploy",
     "test", "track", "status", "log", "finish", "orchestrate", "plan",
@@ -69,61 +71,76 @@ For ALL requests involving code, STOP and ASK first:
 - Code comments and variables in English
 - Respond in the user's language
 `;
-const CLAUDE_MD = `# Inove AI Framework (MCP Mode)
-
-> This project uses the Inove AI Framework via MCP server (\`@joelbonito/mcp-server\`).
-> No local framework files needed — all agents, skills and workflows are served via MCP.
-
-${SHARED_RULES}`;
-const AGENTS_MD = `# Inove AI Framework (MCP Mode)
-
-> This project uses the Inove AI Framework via MCP server (\`@joelbonito/mcp-server\`).
-> No local framework files needed — all agents, skills and workflows are served via MCP.
-
-${SHARED_RULES}`;
-function main() {
-    const args = process.argv.slice(2);
-    // Remove "init" if passed as first arg (from bin dispatch)
-    if (args[0] === "init")
-        args.shift();
+function mcpInit(args) {
     const claudeOnly = args.includes("--claude");
     const codexOnly = args.includes("--codex");
     const both = !claudeOnly && !codexOnly;
     const cwd = process.cwd();
     let created = 0;
-    if (both || claudeOnly) {
-        const path = resolve(cwd, "CLAUDE.md");
-        if (existsSync(path)) {
-            console.log(`⚠️  CLAUDE.md already exists — skipping (use --force to overwrite is not supported, merge manually)`);
-        }
-        else {
-            writeFileSync(path, CLAUDE_MD, "utf-8");
-            console.log(`✅ Created CLAUDE.md`);
-            created++;
-        }
-    }
-    if (both || codexOnly) {
-        const path = resolve(cwd, "AGENTS.md");
+    const header = `# Inove AI Framework (MCP Mode)
+
+> This project uses the Inove AI Framework via MCP server (\`@joelbonito/mcp-server\`).
+> No local framework files needed — all agents, skills and workflows are served via MCP.
+`;
+    const files = [
+        { name: "CLAUDE.md", condition: both || claudeOnly },
+        { name: "AGENTS.md", condition: both || codexOnly },
+        { name: "GEMINI.md", condition: both },
+    ];
+    for (const { name, condition } of files) {
+        if (!condition)
+            continue;
+        const path = resolve(cwd, name);
         if (existsSync(path)) {
-            console.log(`⚠️  AGENTS.md already exists — skipping`);
+            console.log(`  ${name} already exists — skipping`);
         }
         else {
-            writeFileSync(path, AGENTS_MD, "utf-8");
-            console.log(`✅ Created AGENTS.md`);
+            writeFileSync(path, header + SHARED_RULES, "utf-8");
+            console.log(`  Created ${name}`);
             created++;
         }
     }
     if (created > 0) {
-        console.log(`\n🚀 Inove AI Framework (MCP Mode) initialized!`);
-        console.log(`   Now you can use /slash commands and @agent mentions.`);
-        console.log(`\n   Make sure the MCP server is configured:`);
-        console.log(`   • Claude Code: claude mcp add inove-ai -- npx -y @joelbonito/mcp-server`);
-        console.log(`   • Codex CLI:   codex mcp add inove-ai -- npx -y @joelbonito/mcp-server`);
-        console.log(`   • Cursor:      .cursor/mcp.json`);
+        console.log(`\nInove AI Framework (MCP Mode) initialized!`);
+        console.log(`Now you can use /slash commands and @agent mentions.\n`);
+        console.log(`Make sure the MCP server is configured:`);
+        console.log(`  claude mcp add inove-ai -- npx -y @joelbonito/mcp-server`);
+        console.log(`  codex mcp add inove-ai -- npx -y @joelbonito/mcp-server`);
     }
     else {
         console.log(`\nNothing to create — files already exist.`);
     }
 }
-main();
+// ---------------------------------------------------------------------------
+// Main dispatcher
+// ---------------------------------------------------------------------------
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    switch (command) {
+        case "install":
+        case "update": {
+            // Dynamic import to avoid loading registry.ts for non-install commands
+            const { installFramework } = await import("./install.js");
+            installFramework(process.cwd(), command === "update");
+            break;
+        }
+        case "init":
+            mcpInit(args.slice(1));
+            break;
+        default:
+            console.log(`Inove AI Framework CLI\n`);
+            console.log(`Usage:`);
+            console.log(`  npx @joelbonito/mcp-server install   Full framework install (agents, skills, workflows, scripts)`);
+            console.log(`  npx @joelbonito/mcp-server update    Update framework (preserves CLAUDE.md, AGENTS.md, GEMINI.md)`);
+            console.log(`  npx @joelbonito/mcp-server init      MCP-only mode (lightweight bootstrap files)`);
+            console.log(``);
+            console.log(`The MCP server runs automatically when configured in your AI tool.`);
+            process.exit(command ? 1 : 0);
+    }
+}
+main().catch((err) => {
+    console.error("Error:", err.message);
+    process.exit(1);
+});
 //# sourceMappingURL=init.js.map

package/dist/install.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Full framework installer for Inove AI Framework.
+ *
+ * Extracts the embedded content from registry.ts and writes it to disk,
+ * creating the full .agents/ structure, instruction files, and symlinks.
+ *
+ * Usage:
+ *   npx @joelbonito/mcp-server install   # Full install
+ *   npx @joelbonito/mcp-server update    # Update (preserves CLAUDE.md, AGENTS.md, GEMINI.md)
+ */
+export declare function installFramework(cwd: string, isUpdate: boolean): void;

package/dist/install.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+/**
+ * Full framework installer for Inove AI Framework.
+ *
+ * Extracts the embedded content from registry.ts and writes it to disk,
+ * creating the full .agents/ structure, instruction files, and symlinks.
+ *
+ * Usage:
+ *   npx @joelbonito/mcp-server install   # Full install
+ *   npx @joelbonito/mcp-server update    # Update (preserves CLAUDE.md, AGENTS.md, GEMINI.md)
+ */
+import { writeFileSync, mkdirSync, existsSync, symlinkSync, readlinkSync, unlinkSync, lstatSync } from "node:fs";
+import { resolve, join, dirname } from "node:path";
+import { EMBEDDED_AGENTS, EMBEDDED_SKILLS, EMBEDDED_WORKFLOWS, EMBEDDED_ARCHITECTURE, EMBEDDED_INSTRUCTIONS, EMBEDDED_SCRIPTS, EMBEDDED_CONFIG, EMBEDDED_ROOT_FILES, EMBEDDED_SQUAD_TEMPLATES, } from "./registry.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function ensureDir(dir) {
+    mkdirSync(dir, { recursive: true });
+}
+function writeFile(path, content) {
+    ensureDir(dirname(path));
+    writeFileSync(path, content, "utf-8");
+}
+function ensureSymlink(target, linkPath) {
+    ensureDir(dirname(linkPath));
+    if (lstatSync(linkPath, { throwIfNoEntry: false })?.isSymbolicLink()) {
+        const current = readlinkSync(linkPath);
+        if (current === target)
+            return; // already correct
+        unlinkSync(linkPath);
+    }
+    else if (existsSync(linkPath)) {
+        return; // real directory exists, don't replace
+    }
+    symlinkSync(target, linkPath);
+}
+// ---------------------------------------------------------------------------
+// Install logic
+// ---------------------------------------------------------------------------
+export function installFramework(cwd, isUpdate) {
+    const agentsDir = resolve(cwd, ".agents");
+    let created = 0;
+    let updated = 0;
+    let skipped = 0;
+    function writeIfNeeded(path, content, preserve) {
+        if (preserve && existsSync(path)) {
+            skipped++;
+            return;
+        }
+        const existed = existsSync(path);
+        writeFile(path, content);
+        if (existed)
+            updated++;
+        else
+            created++;
+    }
+    console.log(`\n${isUpdate ? "Updating" : "Installing"} Inove AI Framework...`);
+    console.log(`Target: ${cwd}\n`);
+    // --- 1. Agents ---
+    console.log("[1/8] Agents");
+    for (const [name, content] of Object.entries(EMBEDDED_AGENTS)) {
+        writeIfNeeded(join(agentsDir, "agents", `${name}.md`), content, false);
+    }
+    console.log(`  ${Object.keys(EMBEDDED_AGENTS).length} agents`);
+    // --- 2. Skills (SKILL.md + sub-files + scripts) ---
+    console.log("[2/8] Skills");
+    for (const [name, data] of Object.entries(EMBEDDED_SKILLS)) {
+        const skillDir = join(agentsDir, "skills", name);
+        writeIfNeeded(join(skillDir, "SKILL.md"), data.skill, false);
+        for (const [subName, subContent] of Object.entries(data.subFiles)) {
+            writeIfNeeded(join(skillDir, subName), subContent, false);
+        }
+        if (data.scripts && Object.keys(data.scripts).length > 0) {
+            for (const [scriptName, scriptContent] of Object.entries(data.scripts)) {
+                writeIfNeeded(join(skillDir, "scripts", scriptName), scriptContent, false);
+            }
+        }
+    }
+    console.log(`  ${Object.keys(EMBEDDED_SKILLS).length} skills`);
+    // --- 3. Workflows ---
+    console.log("[3/8] Workflows");
+    for (const [name, content] of Object.entries(EMBEDDED_WORKFLOWS)) {
+        writeIfNeeded(join(agentsDir, "workflows", `${name}.md`), content, false);
+    }
+    console.log(`  ${Object.keys(EMBEDDED_WORKFLOWS).length} workflows`);
+    // --- 4. Scripts ---
+    console.log("[4/8] Scripts");
+    for (const [name, content] of Object.entries(EMBEDDED_SCRIPTS)) {
+        writeIfNeeded(join(agentsDir, "scripts", name), content, false);
+    }
+    console.log(`  ${Object.keys(EMBEDDED_SCRIPTS).length} scripts`);
+    // --- 5. Core docs ---
+    console.log("[5/8] Core docs");
+    writeIfNeeded(join(agentsDir, "ARCHITECTURE.md"), EMBEDDED_ARCHITECTURE, false);
+    writeIfNeeded(join(agentsDir, "INSTRUCTIONS.md"), EMBEDDED_INSTRUCTIONS, false);
+    console.log("  ARCHITECTURE.md, INSTRUCTIONS.md");
+    // --- 6. Config ---
+    console.log("[6/8] Config");
+    for (const [name, content] of Object.entries(EMBEDDED_CONFIG)) {
+        writeIfNeeded(join(agentsDir, "config", name), content, false);
+    }
+    console.log(`  ${Object.keys(EMBEDDED_CONFIG).length} config files`);
+    // --- 7. Root instruction files (preserve on update) ---
+    console.log("[7/8] Instruction files");
+    for (const [name, content] of Object.entries(EMBEDDED_ROOT_FILES)) {
+        const preserve = isUpdate; // on update, don't overwrite user's custom files
+        writeIfNeeded(resolve(cwd, name), content, preserve);
+        if (preserve && existsSync(resolve(cwd, name))) {
+            console.log(`  ${name} — preserved (user custom)`);
+        }
+        else {
+            console.log(`  ${name}`);
+        }
+    }
+    // --- 8. Symlinks + Squad templates ---
+    console.log("[8/8] Symlinks & squad templates");
+    // .claude/ symlinks
+    ensureSymlink(join("..", ".agents", "agents"), resolve(cwd, ".claude", "agents"));
+    ensureSymlink(join("..", ".agents", "skills"), resolve(cwd, ".claude", "skills"));
+    console.log("  .claude/agents -> .agents/agents");
+    console.log("  .claude/skills -> .agents/skills");
+    // .claude/project_instructions.md (pointer file)
+    const pointerContent = `# Claude Code Project Instructions\n\n> This file points Claude Code to the master instructions.\n> Do NOT duplicate content here.\n\nSee [CLAUDE.md](../CLAUDE.md) for all project instructions.\n`;
+    writeIfNeeded(resolve(cwd, ".claude", "project_instructions.md"), pointerContent, isUpdate);
+    // .codex/ symlinks (optional)
+    ensureSymlink(join("..", ".agents", "agents"), resolve(cwd, ".codex", "agents"));
+    ensureSymlink(join("..", ".agents", "skills"), resolve(cwd, ".codex", "skills"));
+    ensureSymlink(join("..", ".agents", "workflows"), resolve(cwd, ".codex", "prompts"));
+    console.log("  .codex/agents -> .agents/agents");
+    console.log("  .codex/skills -> .agents/skills");
+    console.log("  .codex/prompts -> .agents/workflows");
+    // Squad templates
+    ensureDir(resolve(cwd, "squads", ".templates"));
+    for (const [relPath, content] of Object.entries(EMBEDDED_SQUAD_TEMPLATES)) {
+        writeIfNeeded(resolve(cwd, "squads", ".templates", relPath), content, false);
+    }
+    // squads/README.md
+    const squadsReadme = `# Squads\n\nSquads are reusable packages of agents + skills + workflows for specific domains.\n\nUse \`/squad create <name>\` to create a new squad from templates in \`.templates/\`.\n`;
+    writeIfNeeded(resolve(cwd, "squads", "README.md"), squadsReadme, isUpdate);
+    console.log(`  ${Object.keys(EMBEDDED_SQUAD_TEMPLATES).length} squad template files`);
+    // --- Summary ---
+    console.log("\n" + "=".repeat(50));
+    console.log(`Inove AI Framework ${isUpdate ? "updated" : "installed"}!`);
+    console.log(`  Created:   ${created}`);
+    console.log(`  Updated:   ${updated}`);
+    console.log(`  Preserved: ${skipped}`);
+    console.log("=".repeat(50));
+    console.log(`
+Next steps:
+  1. Configure MCP server (for enhanced AI integration):
+     claude mcp add inove-ai -- npx -y @joelbonito/mcp-server
+     codex mcp add inove-ai -- npx -y @joelbonito/mcp-server
+
+  2. Validate installation:
+     python3 .agents/scripts/validate_installation.py
+
+  3. Start working:
+     /define <your project description>
+`);
+}
+// ---------------------------------------------------------------------------
+// CLI
+// ---------------------------------------------------------------------------
+function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (command === "install") {
+        installFramework(process.cwd(), false);
+    }
+    else if (command === "update") {
+        if (!existsSync(resolve(process.cwd(), ".agents"))) {
+            console.error("No .agents/ directory found. Use 'install' first.");
+            process.exit(1);
+        }
+        installFramework(process.cwd(), true);
+    }
+    else {
+        console.log("Usage:");
+        console.log("  npx @joelbonito/mcp-server install   # Full install");
+        console.log("  npx @joelbonito/mcp-server update    # Update (preserves instruction files)");
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=install.js.map

package/dist/registry.d.ts

@@ -3,7 +3,12 @@ export declare const EMBEDDED_SKILLS: Record<string, {
     skill: string;
     subFiles: Record<string, string>;
     hasScripts: boolean;
+    scripts: Record<string, string>;
 }>;
 export declare const EMBEDDED_WORKFLOWS: Record<string, string>;
 export declare const EMBEDDED_ARCHITECTURE: string;
 export declare const EMBEDDED_INSTRUCTIONS: string;
+export declare const EMBEDDED_SCRIPTS: Record<string, string>;
+export declare const EMBEDDED_CONFIG: Record<string, string>;
+export declare const EMBEDDED_ROOT_FILES: Record<string, string>;
+export declare const EMBEDDED_SQUAD_TEMPLATES: Record<string, string>;