@joelbonito/mcp-server 5.1.7 → 5.2.1

package/dist/core/resources.js

@@ -33,6 +33,77 @@ export function registerResources(server, cache) {
         }
         return { contents: [{ uri: uri.href, text: skill.raw, mimeType: "text/markdown" }] };
     });
+    // Static: condensed system prompt with operational rules
+    server.resource("system-prompt", "inove://system-prompt", { mimeType: "text/markdown", description: "Condensed operational rules (Socratic Gate, routing, clean code). Inject into system prompt for full framework behavior." }, () => {
+        const agentList = [...cache.agents.values()]
+            .map((a) => `| \`${a.meta.name}\` | ${a.meta.description} | ${a.meta.skills.join(", ")} |`)
+            .join("\n");
+        const workflowList = [...cache.workflows.entries()]
+            .map(([name, w]) => `| \`/${name}\` | ${w.meta.description} |`)
+            .join("\n");
+        const prompt = `# Inove AI Framework — Operational Rules
+
+> Injected via MCP. These rules govern how you operate with the framework.
+
+## Routing Protocol
+
+When the user asks for help, detect the domain from their request and activate the appropriate agent using the \`activate_agent\` tool. Use \`route_task\` if unsure which agent to pick.
+
+## 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 → only then edit |
+| Vague / Simple | Clarification | Ask Purpose, Users and Scope |
+
+**Never assume.** If 1% is undefined, ASK.
+
+## Clean Code (Global)
+
+- Concise, self-documenting code
+- No over-engineering
+- Tests mandatory (Unit > Integration > E2E)
+- Comments in English, variables/functions in English
+- Respond in user's language
+
+## Workflow Invocation
+
+Use the \`execute_workflow\` tool to run slash commands. Available workflows:
+
+| Command | Description |
+|---|---|
+${workflowList}
+
+## Agent Activation
+
+Use the \`activate_agent\` tool to load an agent's persona, rules and skills. Available agents:
+
+| Agent | Description | Skills |
+|---|---|---|
+${agentList}
+
+## Backlog Integration
+
+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
+
+## 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
+`;
+        return { contents: [{ uri: "inove://system-prompt", text: prompt, mimeType: "text/markdown" }] };
+    });
     // Template: individual workflow
     server.resource("workflow", new ResourceTemplate("inove://workflows/{name}", { list: undefined }), { mimeType: "text/markdown", description: "Full content of a specific workflow" }, (uri, { name }) => {
         const workflow = cache.workflows.get(name);

package/dist/core/tools.js

@@ -56,6 +56,42 @@ export function registerTools(server, cache) {
         const result = routeTask(request, cache);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
+    // execute_workflow — simulates /slash invocation for MCP clients
+    server.tool("execute_workflow", "Execute a framework workflow (slash command). Returns the full workflow instructions for the AI to follow. Use this instead of typing /define, /debug, etc.", {
+        name: z.string().min(1).max(100).describe("Workflow name without slash (e.g. 'define', 'debug', 'create')"),
+        arguments: z.string().max(10000).optional().describe("Arguments to pass to the workflow (e.g. 'App de gestao de tarefas')"),
+    }, ({ name, arguments: args }) => {
+        const workflow = cache.workflows.get(name);
+        if (!workflow) {
+            const available = [...cache.workflows.keys()].join(", ");
+            return { content: [{ type: "text", text: `Workflow "${name}" not found. Available: ${available}` }], isError: true };
+        }
+        const header = `# Executing /${name}${args ? ` ${args}` : ""}\n\n> Follow the instructions below to execute this workflow.\n\n---\n\n`;
+        const footer = args ? `\n\n---\n\n## Arguments Provided\n\n\`\`\`\n${args}\n\`\`\`\n\nApply the workflow above using these arguments.` : "";
+        return { content: [{ type: "text", text: header + workflow.raw + footer }] };
+    });
+    // activate_agent — loads agent persona, rules and skills for MCP clients
+    server.tool("activate_agent", "Activate a specialist agent. Returns the agent's full persona, rules and loaded skills. Use this to adopt agent behavior (e.g. @frontend-specialist, @debugger).", {
+        name: z.string().min(1).max(100).describe("Agent name (e.g. 'frontend-specialist', 'debugger', 'security-auditor')"),
+    }, ({ name }) => {
+        const agent = cache.agents.get(name);
+        if (!agent) {
+            const available = [...cache.agents.keys()].join(", ");
+            return { content: [{ type: "text", text: `Agent "${name}" not found. Available: ${available}` }], isError: true };
+        }
+        // Load all skills referenced by the agent
+        const skillContents = agent.meta.skills
+            .map((skillName) => {
+            const skill = cache.skills.get(skillName);
+            if (!skill)
+                return null;
+            return `\n---\n\n## Skill: ${skillName}\n\n${skill.raw}`;
+        })
+            .filter(Boolean)
+            .join("\n");
+        const header = `# Agent Activated: @${name}\n\n> You are now operating as **${name}**. Follow the persona, rules and skills below.\n> Loaded ${agent.meta.skills.length} skill(s): ${agent.meta.skills.join(", ")}\n\n---\n\n`;
+        return { content: [{ type: "text", text: header + agent.raw + skillContents }] };
+    });
     // search_content
     server.tool("search_content", "Full-text search across all framework content (agents, skills, workflows)", {
         query: z.string().min(1).max(5000).describe("Search query"),

package/dist/init.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Bootstrap generator for Inove AI Framework (MCP Mode).
+ *
+ * Creates minimal instruction files that bridge /slash and @agent
+ * patterns to the MCP tools (execute_workflow, activate_agent).
+ *
+ * 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
+ */
+export {};

package/dist/init.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * Bootstrap generator for Inove AI Framework (MCP Mode).
+ *
+ * Creates minimal instruction files that bridge /slash and @agent
+ * patterns to the MCP tools (execute_workflow, activate_agent).
+ *
+ * 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
+ */
+import { writeFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+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
+`;
+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();
+    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");
+        if (existsSync(path)) {
+            console.log(`⚠️  AGENTS.md already exists — skipping`);
+        }
+        else {
+            writeFileSync(path, AGENTS_MD, "utf-8");
+            console.log(`✅ Created AGENTS.md`);
+            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`);
+    }
+    else {
+        console.log(`\nNothing to create — files already exist.`);
+    }
+}
+main();
+//# sourceMappingURL=init.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joelbonito/mcp-server",
-  "version": "5.1.7",
+  "version": "5.2.1",
   "description": "MCP server for Inove AI Framework — agents, skills, and workflows as MCP resources, tools and prompts",
   "license": "MIT",
   "author": "Inove AI <hello@inove.ai>",
@@ -22,12 +22,13 @@
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "inove-mcp": "dist/index.js"
+    "inove-mcp": "dist/index.js",
+    "inove-init": "dist/init.js"
   },
   "scripts": {
     "prebuild": "tsx scripts/bundle-content.ts",
     "build": "tsc",
-    "postbuild": "chmod +x dist/index.js",
+    "postbuild": "chmod +x dist/index.js dist/init.js",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "test": "vitest run",