@ratio-mcp/dev-server 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -1,3 +1,12 @@
 #!/usr/bin/env node
+/**
+ * Ratio Dev MCP Server — Entry Point
+ *
+ * This runs the ORCHESTRATED server by default, exposing a single `agent_chat`
+ * tool that manages the entire app development lifecycle via a state machine.
+ *
+ * To run the legacy server (24+ individual tools), use:
+ *   RATIO_LEGACY_MODE=true node dist/index.js
+ */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/dist/index.js

@@ -1,16 +1,48 @@
 #!/usr/bin/env node
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createDevServer } from './server.js';
-import { logger } from './utils/logger.js';
+/**
+ * Ratio Dev MCP Server — Entry Point
+ *
+ * This runs the ORCHESTRATED server by default, exposing a single `agent_chat`
+ * tool that manages the entire app development lifecycle via a state machine.
+ *
+ * To run the legacy server (24+ individual tools), use:
+ *   RATIO_LEGACY_MODE=true node dist/index.js
+ */
+// Load .env BEFORE any other imports so process.env is populated
+// Must use dynamic imports to ensure dotenv runs before constants.ts is evaluated
+import { config } from 'dotenv';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// __dirname = dist/ → go up to: dev-server/ → packages/ → ratio-mcp-v2/
+const envPath = resolve(__dirname, '..', '..', '..', '.env');
+config({ path: envPath });
 async function main() {
-    logger.info('Starting Ratio Dev MCP Server...');
-    const server = createDevServer();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    logger.info('Ratio Dev MCP Server is running on stdio');
+    // Dynamic imports — these run AFTER dotenv has loaded env vars
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const { createOrchestratedServer } = await import('./orchestrated-server.js');
+    const { createDevServer } = await import('./server.js');
+    const { logger } = await import('./utils/logger.js');
+    const legacyMode = process.env.RATIO_LEGACY_MODE === 'true';
+    logger.info(`Loaded .env from: ${envPath}`);
+    logger.info(`RATIO_API_BASE_URL = ${process.env.RATIO_API_BASE_URL || '(not set, using default)'}`);
+    if (legacyMode) {
+        logger.info('Starting Ratio Dev MCP Server (Legacy Mode — 24+ tools)...');
+        const server = createDevServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('Ratio Dev MCP Server (Legacy) is running on stdio');
+    }
+    else {
+        logger.info('Starting Ratio Dev MCP Server (Orchestrated — single agent_chat tool)...');
+        const server = createOrchestratedServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('Ratio Dev MCP Server (Orchestrated) is running on stdio');
+    }
 }
 main().catch((error) => {
-    logger.error('Fatal error:', error);
+    console.error('Fatal error:', error);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,wEAAwE;AACxE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC9E,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAErD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,CAAC;IAE5D,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,0BAA0B,EAAE,CAAC,CAAC;IAEpG,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/orchestrated-index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Orchestrated Ratio Dev MCP Server — Entry Point
+ *
+ * This is the production entry point that exposes a SINGLE `agent_chat` tool
+ * instead of 24+ individual tools. The internal state machine ensures the
+ * correct tool is called at the right time in the right order.
+ *
+ * Usage:
+ *   node dist/orchestrated-index.js
+ *
+ * Or via the bin alias:
+ *   ratio-dev-orchestrated
+ */
+export {};
+//# sourceMappingURL=orchestrated-index.d.ts.map

package/dist/orchestrated-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrated-index.d.ts","sourceRoot":"","sources":["../src/orchestrated-index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}

package/dist/orchestrated-index.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * Orchestrated Ratio Dev MCP Server — Entry Point
+ *
+ * This is the production entry point that exposes a SINGLE `agent_chat` tool
+ * instead of 24+ individual tools. The internal state machine ensures the
+ * correct tool is called at the right time in the right order.
+ *
+ * Usage:
+ *   node dist/orchestrated-index.js
+ *
+ * Or via the bin alias:
+ *   ratio-dev-orchestrated
+ */
+// Load .env BEFORE any other imports so process.env is populated
+// Must use dynamic imports to ensure dotenv runs before constants.ts is evaluated
+import { config } from 'dotenv';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// __dirname = dist/ → go up to: dev-server/ → packages/ → ratio-mcp-v2/
+const envPath = resolve(__dirname, '..', '..', '..', '.env');
+config({ path: envPath });
+async function main() {
+    // Dynamic imports — these run AFTER dotenv has loaded env vars
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const { createOrchestratedServer } = await import('./orchestrated-server.js');
+    const { logger } = await import('./utils/logger.js');
+    logger.info(`Loaded .env from: ${envPath}`);
+    logger.info(`RATIO_API_BASE_URL = ${process.env.RATIO_API_BASE_URL || '(not set, using default)'}`);
+    logger.info('Starting Ratio Dev MCP Server (Orchestrated Mode)...');
+    const server = createOrchestratedServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('Ratio Dev MCP Server (Orchestrated) is running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=orchestrated-index.js.map

package/dist/orchestrated-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrated-index.js","sourceRoot":"","sources":["../src/orchestrated-index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAEH,iEAAiE;AACjE,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,wEAAwE;AACxE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAErD,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,0BAA0B,EAAE,CAAC,CAAC;IACpG,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;AACzE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/orchestrated-server.d.ts

@@ -0,0 +1,16 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create the Orchestrated Ratio Dev MCP Server.
+ *
+ * Unlike the original server (which exposes 24+ individual tools),
+ * this server exposes a SINGLE `agent_chat` tool that orchestrates
+ * the entire app development lifecycle through a state machine.
+ *
+ * Benefits:
+ * - LLM doesn't need to decide tool ordering — the orchestrator handles it
+ * - Flow integrity is guaranteed — steps can't be skipped or called out of order
+ * - Simpler LLM integration — one tool to learn instead of 24
+ * - Production-grade reliability — deterministic state transitions
+ */
+export declare function createOrchestratedServer(): McpServer;
+//# sourceMappingURL=orchestrated-server.d.ts.map

package/dist/orchestrated-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrated-server.d.ts","sourceRoot":"","sources":["../src/orchestrated-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,CAsDpD"}

package/dist/orchestrated-server.js

@@ -0,0 +1,63 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { DEV_SERVER_NAME, DEV_SERVER_VERSION } from '@ratio-mcp/shared';
+import { agentChatTool } from './tools/agent-chat.js';
+import { logger } from './utils/logger.js';
+/**
+ * Create the Orchestrated Ratio Dev MCP Server.
+ *
+ * Unlike the original server (which exposes 24+ individual tools),
+ * this server exposes a SINGLE `agent_chat` tool that orchestrates
+ * the entire app development lifecycle through a state machine.
+ *
+ * Benefits:
+ * - LLM doesn't need to decide tool ordering — the orchestrator handles it
+ * - Flow integrity is guaranteed — steps can't be skipped or called out of order
+ * - Simpler LLM integration — one tool to learn instead of 24
+ * - Production-grade reliability — deterministic state transitions
+ */
+export function createOrchestratedServer() {
+    const server = new McpServer({
+        name: `${DEV_SERVER_NAME}-orchestrated`,
+        version: DEV_SERVER_VERSION,
+    });
+    // Register the single unified tool
+    const shape = agentChatTool.inputSchema.shape;
+    server.tool(agentChatTool.name, agentChatTool.description, shape, async (args) => {
+        logger.toolCall(agentChatTool.name, args);
+        const startTime = Date.now();
+        try {
+            const result = await agentChatTool.handler(args);
+            const duration = Date.now() - startTime;
+            logger.toolResult(agentChatTool.name, duration, result);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            logger.toolError(agentChatTool.name, duration, error);
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: true,
+                            message,
+                            tool: agentChatTool.name,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    logger.info(`${DEV_SERVER_NAME}-orchestrated initialized with single agent_chat tool`);
+    return server;
+}
+//# sourceMappingURL=orchestrated-server.js.map

package/dist/orchestrated-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrated-server.js","sourceRoot":"","sources":["../src/orchestrated-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,GAAG,eAAe,eAAe;QACvC,OAAO,EAAE,kBAAkB;KAC5B,CAAC,CAAC;IAEH,mCAAmC;IACnC,MAAM,KAAK,GAAI,aAAa,CAAC,WAA0C,CAAC,KAAK,CAAC;IAE9E,MAAM,CAAC,IAAI,CACT,aAAa,CAAC,IAAI,EAClB,aAAa,CAAC,WAAW,EACzB,KAAK,EACL,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAEtD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,IAAI;4BACX,OAAO;4BACP,IAAI,EAAE,aAAa,CAAC,IAAI;yBACzB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,uDAAuD,CAAC,CAAC;IACvF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CA2D3C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAsF3C"}

package/dist/server.js

@@ -2,6 +2,8 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { DEV_SERVER_NAME, DEV_SERVER_VERSION } from '@ratio-mcp/shared';
 import { allDevTools } from './tools/index.js';
 import { logger } from './utils/logger.js';
+import { checkToolPrerequisites } from './services/tool-guard.js';
+import { recordToolSuccess } from './services/session-state.js';
 /**
  * Create and configure the Ratio Dev MCP Server
  */
@@ -17,10 +19,34 @@ export function createDevServer() {
         server.tool(tool.name, tool.description, shape, async (args) => {
             logger.toolCall(tool.name, args);
             const startTime = Date.now();
+            // ── Guard: check prerequisites before executing ──────────────
+            const guard = checkToolPrerequisites(tool.name);
+            if (!guard.allowed) {
+                const duration = Date.now() - startTime;
+                logger.info(`BLOCKED ${tool.name} (${duration}ms): ${guard.message}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: true,
+                                blocked: true,
+                                message: guard.message,
+                                required_tools: guard.requiredTools,
+                                tool: tool.name,
+                                hint: `Please call ${guard.requiredTools?.join(' or ')} first, then retry ${tool.name}.`,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
             try {
                 const result = await tool.handler(args);
                 const duration = Date.now() - startTime;
                 logger.toolResult(tool.name, duration, result);
+                // ── Record success in session state ────────────────────────
+                recordToolSuccess(tool.name, result);
                 return {
                     content: [
                         {

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,kBAAkB;KAC5B,CAAC,CAAC;IAEH,qBAAqB;IACrB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,8EAA8E;QAC9E,MAAM,KAAK,GAAI,IAAI,CAAC,WAA0C,CAAC,KAAK,CAAC;QAErE,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,KAAK,EACL,KAAK,EAAE,IAA6B,EAAE,EAAE;YACtC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBACxC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAE/C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBACxC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAE7C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,IAAI;gCACX,OAAO;gCACP,IAAI,EAAE,IAAI,CAAC,IAAI;6BAChB,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,qBAAqB,WAAW,CAAC,MAAM,QAAQ,CAAC,CAAC;IAC/E,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/services/orchestrator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Phase definitions in the Ratio app development lifecycle.
+ * Each phase represents a logical group of activities that must be completed in order.
+ */
+export type Phase = 'auth' | 'app_setup' | 'requirements' | 'webhooks' | 'frontend_build' | 'review_wait' | 'publish_oauth' | 'backend_codegen' | 'complete';
+/**
+ * Result returned by the orchestrator showing exactly what to do next.
+ * The caller uses this to invoke the correct tool with the right arguments.
+ */
+export interface OrchestratorResult {
+    phase: Phase;
+    step: string;
+    toolToCall: string;
+    toolArgs: Record<string, unknown>;
+    needsInput: boolean;
+    inputPrompt?: string;
+    inputFields?: string[];
+    message: string;
+    phase_description: string;
+    progress: {
+        current: number;
+        total: number;
+        percentage: number;
+    };
+}
+/**
+ * Main orchestrator function: determines the exact next step based on session state.
+ *
+ * @param userInput - Optional user input (credentials, selections, configuration details)
+ * @returns OrchestratorResult describing what to do next
+ */
+export declare function getNextStep(userInput?: Record<string, unknown>): OrchestratorResult;
+/**
+ * Get the current phase without computing the next step details.
+ * Useful for status checks and phase-only queries.
+ */
+export declare function getCurrentPhase(): Phase;
+/**
+ * Get a human-friendly description of a phase.
+ */
+export declare function getPhaseDescription(phase: Phase): string;
+/**
+ * Check if a phase can be skipped by the user.
+ * Currently only webhooks is optional.
+ */
+export declare function canSkipPhase(phase: Phase): boolean;
+/**
+ * Get the total number of steps across all phases.
+ */
+export declare function getTotalSteps(): number;
+/**
+ * Get metadata about a specific phase (description, step count, skippable).
+ */
+export declare function getPhaseMetadata(phase: Phase): {
+    description: string;
+    skippable: boolean;
+    stepCount: number;
+};
+/**
+ * Helper: Get all phases in order.
+ */
+export declare function getAllPhases(): Phase[];
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/services/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/services/orchestrator.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,MAAM,KAAK,GACb,MAAM,GACN,WAAW,GACX,cAAc,GACd,UAAU,GACV,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,UAAU,CAAC;AAEf;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAEjC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAGb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGlC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAGvB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAgtBD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,CA2CnF;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAEvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK;iBA9xB9B,MAAM;eACR,OAAO;eACP,MAAM;EA8xBlB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,KAAK,EAAE,CAKtC"}