@joelbonito/mcp-server 5.2.0 → 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

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for Inove AI Framework.
+ *
+ * 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)
+ *
+ * The MCP server itself runs via `inove-mcp` (dist/index.js).
+ */
+export {};

package/dist/init.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for Inove AI Framework.
+ *
+ * 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)
+ *
+ * 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",
+    "preview", "ui-ux-pro-max", "review", "test-book", "release",
+    "squad", "context", "readiness", "journeys",
+];
+const AGENTS = [
+    "orchestrator", "project-planner", "product-manager",
+    "frontend-specialist", "backend-specialist", "database-architect",
+    "mobile-developer", "security-auditor", "debugger", "devops-engineer",
+    "test-engineer", "qa-automation-engineer", "documentation-writer",
+    "code-archaeologist", "performance-optimizer", "seo-specialist",
+    "penetration-tester", "game-developer", "product-owner",
+    "ux-researcher", "explorer-agent", "n8n-specialist",
+];
+const SHARED_RULES = `
+## Slash Commands — Workflow Invocation
+
+When the user types \`/<command>\` (e.g. \`/define\`, \`/debug\`), use the MCP tool \`execute_workflow\` with the command name (without the slash) and any arguments.
+
+Example: \`/define App de gestao de tarefas\` → call \`execute_workflow(name="define", arguments="App de gestao de tarefas")\`
+
+Available workflows: ${WORKFLOWS.map((w) => `\`/${w}\``).join(", ")}
+
+## Agent Activation — @ Mentions
+
+When the user mentions \`@agent-name\` (e.g. \`@frontend-specialist\`), use the MCP tool \`activate_agent\` with the agent name. This loads the agent's full persona, rules and all referenced skills.
+
+Example: \`@security-auditor\` → call \`activate_agent(name="security-auditor")\`
+
+Available agents: ${AGENTS.map((a) => `\`@${a}\``).join(", ")}
+
+## Intelligent Routing
+
+When unsure which agent to use, call \`route_task\` with the user's request. It returns the best-matching agents based on keyword analysis.
+
+## Operational Rules
+
+For full framework behavior (Socratic Gate, Clean Code, Routing Protocol), read the MCP resource \`inove://system-prompt\`.
+
+## Socratic Gate (MANDATORY)
+
+For ALL requests involving code, STOP and ASK first:
+
+| Request Type | Strategy | Action |
+|---|---|---|
+| New Feature / Build | Deep Discovery | ASK minimum 3 strategic questions |
+| Edit / Bug Fix | Diagnosis | Present DIAGNOSIS + PROPOSAL → wait for approval |
+| Vague / Simple | Clarification | Ask Purpose, Users and Scope |
+
+## Clean Code (Global)
+
+- Concise, self-documenting code — no over-engineering
+- Tests mandatory (Unit > Integration > E2E)
+- Code comments and variables in English
+- Respond in the user's language
+`;
+function mcpInit(args) {
+    const claudeOnly = args.includes("--claude");
+    const codexOnly = args.includes("--codex");
+    const both = !claudeOnly && !codexOnly;
+    const cwd = process.cwd();
+    let created = 0;
+    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(`  ${name} already exists — skipping`);
+        }
+        else {
+            writeFileSync(path, header + SHARED_RULES, "utf-8");
+            console.log(`  Created ${name}`);
+            created++;
+        }
+    }
+    if (created > 0) {
+        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 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>;