@joelbonito/mcp-server 5.1.7 → 5.2.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joelbonito/mcp-server",
-  "version": "5.1.7",
+  "version": "5.2.0",
   "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>",