@ratio-mcp/dev-server 1.0.0

package/dist/tools/codegen.js

@@ -0,0 +1,315 @@
+import { z } from 'zod';
+import { existsSync } from 'fs';
+import { mkdir, writeFile, readFile } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+import { getRequirements } from '../store/requirements-store.js';
+import { logger } from '../utils/logger.js';
+import { ToolExecutionError } from '../utils/errors.js';
+// Import schemas directly — in a real setup these come from the docs-server
+// but for now we co-locate the schema reading logic
+import { readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Load resource schema from the docs-server schemas directory.
+ * In production, this would query the docs-server via MCP, but since both servers
+ * share the same machine, we read the schema files directly.
+ */
+function loadResourceSchema(resource) {
+    // Try to find schema in docs-server's schemas directory
+    const docsSchemaPath = resolve(__dirname, '..', '..', '..', 'docs-server', 'src', 'schemas', `${resource}.json`);
+    const distSchemaPath = resolve(__dirname, '..', '..', '..', 'docs-server', 'dist', 'schemas', `${resource}.json`);
+    for (const schemaPath of [docsSchemaPath, distSchemaPath]) {
+        if (existsSync(schemaPath)) {
+            try {
+                return JSON.parse(readFileSync(schemaPath, 'utf-8'));
+            }
+            catch {
+                logger.warn(`Failed to parse schema: ${schemaPath}`);
+            }
+        }
+    }
+    return null;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function generateServiceCode(resource, endpoints) {
+    const className = `${capitalize(resource)}Service`;
+    const lines = [];
+    lines.push(`import { Injectable, HttpException, HttpStatus } from '@nestjs/common';`);
+    lines.push(`import { ConfigService } from '@nestjs/config';`);
+    lines.push(`import axios from 'axios';`);
+    lines.push('');
+    lines.push(`@Injectable()`);
+    lines.push(`export class ${className} {`);
+    lines.push(`  private readonly apiBaseUrl: string;`);
+    lines.push(`  private readonly accessToken: string;`);
+    lines.push(`  private readonly merchantId: string;`);
+    lines.push('');
+    lines.push(`  constructor(private configService: ConfigService) {`);
+    lines.push(`    this.apiBaseUrl = this.configService.get<string>('RATIO_API_BASE_URL');`);
+    lines.push(`    this.accessToken = this.configService.get<string>('RATIO_ACCESS_TOKEN', '');`);
+    lines.push(`    this.merchantId = this.configService.get<string>('RATIO_MERCHANT_ID', '');`);
+    lines.push(`  }`);
+    lines.push('');
+    lines.push(`  private getHeaders(extra?: Record<string, string>) {`);
+    lines.push(`    return {`);
+    lines.push(`      Authorization: \`Bearer \${this.accessToken}\`,`);
+    lines.push(`      'Content-Type': 'application/json',`);
+    lines.push(`      ...extra,`);
+    lines.push(`    };`);
+    lines.push(`  }`);
+    for (const ep of endpoints) {
+        lines.push('');
+        lines.push(`  /** ${ep.summary} */`);
+        // Build method signature
+        const params = [];
+        if (ep.path_params) {
+            for (const p of ep.path_params) {
+                params.push(`${p.name}: string`);
+            }
+        }
+        if (ep.query_params && ep.query_params.length > 0 && ep.method === 'GET') {
+            params.push('query?: Record<string, unknown>');
+        }
+        if (ep.request_body && ['POST', 'PATCH', 'PUT'].includes(ep.method)) {
+            params.push('body?: Record<string, unknown>');
+        }
+        lines.push(`  async ${ep.handler_name}(${params.join(', ')}): Promise<any> {`);
+        lines.push(`    try {`);
+        // Build URL
+        let urlPath = ep.path;
+        if (ep.path_params) {
+            for (const p of ep.path_params) {
+                urlPath = urlPath.replace(`:${p.name}`, `\${${p.name}}`);
+            }
+        }
+        const extraHeaders = ep.extra_headers
+            ? `{ ${ep.extra_headers.map((h) => `'${h.name}': this.merchantId`).join(', ')} }`
+            : 'undefined';
+        if (ep.method === 'GET') {
+            lines.push(`      const response = await axios.get(\`\${this.apiBaseUrl}${urlPath}\`, {`);
+            lines.push(`        headers: this.getHeaders(${extraHeaders !== 'undefined' ? extraHeaders : ''}),`);
+            if (ep.query_params && ep.query_params.length > 0) {
+                lines.push(`        params: query,`);
+            }
+            lines.push(`      });`);
+        }
+        else if (ep.method === 'POST') {
+            lines.push(`      const response = await axios.post(\`\${this.apiBaseUrl}${urlPath}\`, body, {`);
+            lines.push(`        headers: this.getHeaders(${extraHeaders !== 'undefined' ? extraHeaders : ''}),`);
+            lines.push(`      });`);
+        }
+        else if (ep.method === 'PATCH') {
+            lines.push(`      const response = await axios.patch(\`\${this.apiBaseUrl}${urlPath}\`, body, {`);
+            lines.push(`        headers: this.getHeaders(${extraHeaders !== 'undefined' ? extraHeaders : ''}),`);
+            lines.push(`      });`);
+        }
+        else if (ep.method === 'PUT') {
+            lines.push(`      const response = await axios.put(\`\${this.apiBaseUrl}${urlPath}\`, body, {`);
+            lines.push(`        headers: this.getHeaders(${extraHeaders !== 'undefined' ? extraHeaders : ''}),`);
+            lines.push(`      });`);
+        }
+        else if (ep.method === 'DELETE') {
+            lines.push(`      const response = await axios.delete(\`\${this.apiBaseUrl}${urlPath}\`, {`);
+            lines.push(`        headers: this.getHeaders(${extraHeaders !== 'undefined' ? extraHeaders : ''}),`);
+            lines.push(`      });`);
+        }
+        lines.push(`      return response.data;`);
+        lines.push(`    } catch (error: any) {`);
+        lines.push(`      throw new HttpException(`);
+        lines.push(`        error.response?.data?.message || '${ep.handler_name} failed',`);
+        lines.push(`        error.response?.status || HttpStatus.INTERNAL_SERVER_ERROR,`);
+        lines.push(`      );`);
+        lines.push(`    }`);
+        lines.push(`  }`);
+    }
+    lines.push(`}`);
+    return lines.join('\n');
+}
+function generateControllerCode(resource, endpoints) {
+    const className = `${capitalize(resource)}Controller`;
+    const serviceName = `${capitalize(resource)}Service`;
+    const serviceVar = `${resource}Service`;
+    const lines = [];
+    // Collect decorators needed
+    const decorators = new Set(['Controller']);
+    for (const ep of endpoints) {
+        decorators.add(ep.method === 'DELETE' ? 'Delete' : capitalize(ep.method.toLowerCase()));
+        if (ep.path_params)
+            decorators.add('Param');
+        if (ep.query_params && ep.method === 'GET')
+            decorators.add('Query');
+        if (ep.request_body && ['POST', 'PATCH', 'PUT'].includes(ep.method))
+            decorators.add('Body');
+    }
+    lines.push(`import { ${[...decorators].join(', ')} } from '@nestjs/common';`);
+    lines.push(`import { ${serviceName} } from './${resource}.service';`);
+    lines.push('');
+    // Extract base path
+    const basePath = getCommonBasePath(endpoints.map((ep) => ep.path));
+    lines.push(`@Controller('${basePath}')`);
+    lines.push(`export class ${className} {`);
+    lines.push(`  constructor(private readonly ${serviceVar}: ${serviceName}) {}`);
+    for (const ep of endpoints) {
+        lines.push('');
+        lines.push(`  /** ${ep.summary} */`);
+        // Calculate relative path from base
+        let relativePath = ep.path.replace(basePath, '').replace(/^\//, '');
+        // Convert :param to NestJS :param format (same)
+        const decorator = ep.method === 'DELETE' ? 'Delete' : capitalize(ep.method.toLowerCase());
+        lines.push(`  @${decorator}('${relativePath || '/'}')`);
+        const params = [];
+        const callArgs = [];
+        if (ep.path_params) {
+            for (const p of ep.path_params) {
+                params.push(`@Param('${p.name}') ${p.name}: string`);
+                callArgs.push(p.name);
+            }
+        }
+        if (ep.query_params && ep.query_params.length > 0 && ep.method === 'GET') {
+            params.push(`@Query() query: Record<string, unknown>`);
+            callArgs.push('query');
+        }
+        if (ep.request_body && ['POST', 'PATCH', 'PUT'].includes(ep.method)) {
+            params.push(`@Body() body: Record<string, unknown>`);
+            callArgs.push('body');
+        }
+        lines.push(`  async ${ep.handler_name}(${params.join(', ')}) {`);
+        lines.push(`    return this.${serviceVar}.${ep.handler_name}(${callArgs.join(', ')});`);
+        lines.push(`  }`);
+    }
+    lines.push(`}`);
+    return lines.join('\n');
+}
+function generateModuleCode(resource) {
+    const className = `${capitalize(resource)}Module`;
+    const controllerName = `${capitalize(resource)}Controller`;
+    const serviceName = `${capitalize(resource)}Service`;
+    return [
+        `import { Module } from '@nestjs/common';`,
+        `import { ${controllerName} } from './${resource}.controller';`,
+        `import { ${serviceName} } from './${resource}.service';`,
+        '',
+        `@Module({`,
+        `  controllers: [${controllerName}],`,
+        `  providers: [${serviceName}],`,
+        `  exports: [${serviceName}],`,
+        `})`,
+        `export class ${className} {}`,
+    ].join('\n');
+}
+function getCommonBasePath(paths) {
+    if (paths.length === 0)
+        return '';
+    const parts = paths[0].split('/');
+    let common = '';
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        if (part.startsWith(':'))
+            break;
+        if (paths.every((p) => p.split('/')[i] === part)) {
+            common += (common ? '/' : '') + part;
+        }
+        else {
+            break;
+        }
+    }
+    return common.replace(/^\//, '');
+}
+export const codegenTools = [
+    {
+        name: 'generate_api_routes',
+        description: 'Generate NestJS backend code (controller, service, module) for each resource in the app requirements. ' +
+            'Reads scopes from requirements, loads API schemas, and generates endpoints in deterministic controller_order. ' +
+            'Only generates endpoints matching the developer\'s scopes. Updates app.module.ts with new imports. ' +
+            'PREREQUISITE: Call define_app_requirements and scaffold_backend first.',
+        inputSchema: z.object({
+            app_id: z.string().min(1).describe('App ID from create_app'),
+            project_path: z.string().min(1).describe('Absolute path to the project root'),
+        }),
+        handler: async (input) => {
+            const { app_id, project_path: rawPath } = input;
+            const projectPath = rawPath.startsWith('~') ? rawPath.replace('~', homedir()) : rawPath;
+            const backendSrcDir = join(projectPath, 'backend', 'src');
+            if (!existsSync(backendSrcDir)) {
+                throw new ToolExecutionError('generate_api_routes', `Backend src directory not found: ${backendSrcDir}. Call scaffold_backend first.`);
+            }
+            const requirements = getRequirements(app_id);
+            if (!requirements) {
+                throw new ToolExecutionError('generate_api_routes', `No requirements found for app_id: ${app_id}. Call define_app_requirements first.`);
+            }
+            const generatedModules = [];
+            const allErrors = [];
+            for (const dataNeed of requirements.data_needs) {
+                const schema = loadResourceSchema(dataNeed);
+                if (!schema) {
+                    allErrors.push(`No API schema found for resource: ${dataNeed}`);
+                    continue;
+                }
+                const endpoints = schema['endpoints']
+                    .filter((ep) => requirements.scopes.includes(ep.required_scope))
+                    .sort((a, b) => a.controller_order - b.controller_order);
+                if (endpoints.length === 0) {
+                    allErrors.push(`No endpoints match scopes [${requirements.scopes.join(', ')}] for resource: ${dataNeed}`);
+                    continue;
+                }
+                // Generate code
+                const serviceCode = generateServiceCode(dataNeed, endpoints);
+                const controllerCode = generateControllerCode(dataNeed, endpoints);
+                const moduleCode = generateModuleCode(dataNeed);
+                // Write files
+                const resourceDir = join(backendSrcDir, dataNeed);
+                if (!existsSync(resourceDir))
+                    await mkdir(resourceDir, { recursive: true });
+                await writeFile(join(resourceDir, `${dataNeed}.service.ts`), serviceCode);
+                await writeFile(join(resourceDir, `${dataNeed}.controller.ts`), controllerCode);
+                await writeFile(join(resourceDir, `${dataNeed}.module.ts`), moduleCode);
+                generatedModules.push(dataNeed);
+                logger.info(`Generated ${dataNeed} module with ${endpoints.length} endpoints`);
+            }
+            // Update app.module.ts
+            if (generatedModules.length > 0) {
+                const appModulePath = join(backendSrcDir, 'app.module.ts');
+                if (existsSync(appModulePath)) {
+                    let appModule = await readFile(appModulePath, 'utf-8');
+                    for (const mod of generatedModules) {
+                        const moduleName = `${capitalize(mod)}Module`;
+                        const importPath = `./${mod}/${mod}.module`;
+                        if (!appModule.includes(moduleName)) {
+                            // Add import statement
+                            appModule = `import { ${moduleName} } from '${importPath}';\n${appModule}`;
+                            // Add to imports array
+                            appModule = appModule.replace(/imports:\s*\[/, `imports: [\n    ${moduleName},`);
+                        }
+                    }
+                    await writeFile(appModulePath, appModule);
+                    logger.info('Updated app.module.ts with new module imports');
+                }
+            }
+            return {
+                success: true,
+                message: `Generated ${generatedModules.length} resource module(s)`,
+                generated_modules: generatedModules.map((mod) => ({
+                    resource: mod,
+                    files: [
+                        `${mod}/${mod}.service.ts`,
+                        `${mod}/${mod}.controller.ts`,
+                        `${mod}/${mod}.module.ts`,
+                    ],
+                })),
+                errors: allErrors.length > 0 ? allErrors : undefined,
+                next_steps: [
+                    `1. cd ${projectPath}/backend && npm install && npm run start:dev`,
+                    '2. Test endpoints with curl or Postman',
+                    '3. Use validate_api_code (docs-server) to verify the generated code',
+                ],
+            };
+        },
+    },
+];
+//# sourceMappingURL=codegen.js.map

package/dist/tools/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../src/tools/codegen.ts"],"names":[],"mappings":"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"}

package/dist/tools/developer-auth.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './index.js';
+export declare const developerAuthTools: ToolDefinition[];
+//# sourceMappingURL=developer-auth.d.ts.map

package/dist/tools/developer-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"developer-auth.d.ts","sourceRoot":"","sources":["../../src/tools/developer-auth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,kBAAkB,EAAE,cAAc,EA0G9C,CAAC"}

package/dist/tools/developer-auth.js

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import { developerApiRequest, setDeveloperCredentials } from '../api/developer.js';
+import { logger } from '../utils/logger.js';
+export const developerAuthTools = [
+    {
+        name: 'developer_signup',
+        description: 'Register a new developer account on the Ratio Developer Dashboard. A verification code will be sent to the provided email. Use developer_verify_otp to complete registration.',
+        inputSchema: z.object({
+            display_name: z.string().min(1).describe('Developer display name (required)'),
+            email: z.string().email().describe('Developer email address (required)'),
+            password: z.string().min(1).describe('Password for the developer account (required)'),
+        }),
+        handler: async (input) => {
+            const { display_name, email, password } = input;
+            logger.info(`Signing up developer: ${email}`);
+            const response = await developerApiRequest('POST', '/developers/signup', { displayName: display_name, email, password }, { skipAuth: true });
+            return {
+                success: true,
+                message: `Signup initiated. A verification code has been sent to ${email}.`,
+                email,
+                raw_response: response,
+                next_steps: [
+                    `1. Check email (${email}) for the verification code`,
+                    '2. Use developer_verify_otp to verify your account',
+                    '3. After verification, use developer_login to sign in',
+                ],
+            };
+        },
+    },
+    {
+        name: 'developer_verify_otp',
+        description: 'Verify the OTP code sent to the developer email during signup. Completes registration. After verification, use developer_login to sign in.',
+        inputSchema: z.object({
+            email: z.string().email().describe('Developer email address used during signup'),
+            code: z.string().min(1).describe('Verification code received via email'),
+        }),
+        handler: async (input) => {
+            const { email, code } = input;
+            logger.info(`Verifying OTP for: ${email}`);
+            const response = await developerApiRequest('POST', '/developers/verify-otp', { email, code, purpose: 'signup' }, { skipAuth: true });
+            return {
+                success: true,
+                message: `Email verified for ${email}. Account is now active.`,
+                raw_response: response,
+                next_steps: [`1. Use developer_login with email "${email}" and your password`],
+            };
+        },
+    },
+    {
+        name: 'developer_login',
+        description: 'Login to the Ratio Developer Dashboard. Returns and stores the developer token for subsequent API calls. Must be called before using app management tools.',
+        inputSchema: z.object({
+            email: z.string().email().describe('Developer email address'),
+            password: z.string().min(1).describe('Developer password'),
+        }),
+        handler: async (input) => {
+            const { email, password } = input;
+            logger.info(`Logging in developer: ${email}`);
+            const responseData = await developerApiRequest('POST', '/developers/signin', { email, password }, { skipAuth: true });
+            const token = responseData.data?.accessToken ?? responseData.data?.token ??
+                responseData.accessToken ?? responseData.token;
+            if (!token) {
+                return { success: false, message: 'Login succeeded but no token found in response.', raw_response: responseData };
+            }
+            let devId = responseData.data?.developerId ?? responseData.data?.id ?? responseData.data?.sub;
+            if (!devId && typeof token === 'string') {
+                try {
+                    const parts = token.split('.');
+                    if (parts.length === 3 && parts[1]) {
+                        const payload = JSON.parse(Buffer.from(parts[1], 'base64').toString());
+                        devId = payload.sub ?? payload.developerId ?? payload.id;
+                    }
+                }
+                catch { /* ignore */ }
+            }
+            setDeveloperCredentials(token, devId ?? '');
+            logger.info(`Developer logged in: ${email}`);
+            return {
+                success: true,
+                message: 'Login successful. Token stored for this session.',
+                developer_id: devId,
+                email,
+            };
+        },
+    },
+];
+//# sourceMappingURL=developer-auth.js.map

package/dist/tools/developer-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"developer-auth.js","sourceRoot":"","sources":["../../src/tools/developer-auth.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+/**
+ * Tool definition for MCP registration
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType;
+    handler: (input: Record<string, unknown>) => Promise<unknown>;
+}
+/**
+ * All dev-server tools in registration order
+ * NOTE: get_available_scopes is in docs-server (static data, no auth needed)
+ */
+export declare const allDevTools: ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAaD;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,cAAc,EAUvC,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,27 @@
+// Import all tool groups
+import { developerAuthTools } from './developer-auth.js';
+import { appManagementTools } from './app-management.js';
+import { requirementsTools } from './requirements.js';
+import { scaffoldTools } from './scaffold.js';
+import { authTools } from './auth.js';
+import { codegenTools } from './codegen.js';
+import { buildTools } from './build.js';
+import { submissionTools } from './submission.js';
+import { lifecycleTools } from './lifecycle.js';
+/**
+ * All dev-server tools in registration order
+ * NOTE: get_available_scopes is in docs-server (static data, no auth needed)
+ */
+export const allDevTools = [
+    ...developerAuthTools, // 3 tools
+    ...appManagementTools, // 5 tools
+    ...requirementsTools, // 1 tool
+    ...scaffoldTools, // 2 tools
+    ...authTools, // 4 tools (request_auth_code, get_access_token, refresh, check_status)
+    ...codegenTools, // 1 tool
+    ...buildTools, // 3 tools
+    ...submissionTools, // 4 tools
+    ...lifecycleTools, // 1 tool
+];
+// Total: 24 tools
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAYA,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,GAAG,kBAAkB,EAAK,UAAU;IACpC,GAAG,kBAAkB,EAAK,UAAU;IACpC,GAAG,iBAAiB,EAAM,SAAS;IACnC,GAAG,aAAa,EAAU,UAAU;IACpC,GAAG,SAAS,EAAc,uEAAuE;IACjG,GAAG,YAAY,EAAW,SAAS;IACnC,GAAG,UAAU,EAAa,UAAU;IACpC,GAAG,eAAe,EAAQ,UAAU;IACpC,GAAG,cAAc,EAAS,SAAS;CACpC,CAAC;AACF,kBAAkB"}

package/dist/tools/lifecycle.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './index.js';
+export declare const lifecycleTools: ToolDefinition[];
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/tools/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/tools/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA6EjD,eAAO,MAAM,cAAc,EAAE,cAAc,EAuB1C,CAAC"}

package/dist/tools/lifecycle.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+/**
+ * The complete Ratio app lifecycle phases
+ *
+ * Core focus: select the right scopes → scaffold frontend → build & submit →
+ * get approved → OAuth → inject correct backend code via codegen.
+ */
+const LIFECYCLE_PHASES = [
+    {
+        phase: 1,
+        name: 'Developer Authentication',
+        description: 'Sign up or login to the Ratio Developer Dashboard',
+        tools: ['developer_signup', 'developer_verify_otp', 'developer_login'],
+    },
+    {
+        phase: 2,
+        name: 'App Creation',
+        description: 'Create your app and get client credentials (client_id, client_secret)',
+        tools: ['create_app'],
+    },
+    {
+        phase: 3,
+        name: 'Define Scopes',
+        description: 'Select the right OAuth scopes for the app. The LLM suggests scopes based on what the developer ' +
+            'wants to build, then presents a preview for developer approval before confirming. ' +
+            'This is critical — scopes drive which backend API routes get generated later.',
+        tools: ['define_app_requirements'],
+        docs_server_tools: ['get_available_scopes'],
+    },
+    {
+        phase: 4,
+        name: 'Scaffold Frontend',
+        description: 'Scaffold a default React + Vite frontend project. This is a required submission artifact — ' +
+            'the admin needs a frontend build to approve the app. Not the focus of customization right now.',
+        tools: ['scaffold_frontend'],
+    },
+    {
+        phase: 5,
+        name: 'Build & Submit',
+        description: 'Build the frontend, package as zip, upload to dashboard, and submit for admin review',
+        tools: ['build_frontend', 'validate_build', 'create_submission_zip', 'upload_build', 'submit_for_review'],
+    },
+    {
+        phase: 6,
+        name: 'Admin Review',
+        description: 'Wait for admin approval. Check status periodically.',
+        tools: ['get_app_status'],
+    },
+    {
+        phase: 7,
+        name: 'Publish & OAuth',
+        description: 'Publish the approved app, then complete OAuth flow with a merchant to get access tokens. ' +
+            'These tokens are needed for the backend to make API calls on behalf of the merchant.',
+        tools: ['publish_app', 'request_auth_code', 'get_access_token'],
+    },
+    {
+        phase: 8,
+        name: 'Backend Code Generation',
+        description: 'Scaffold the NestJS backend (with OAuth tokens injected into .env), then auto-generate ' +
+            'API route code (controller, service, module) for each resource based on the confirmed scopes. ' +
+            'Only resources with codegen_ready=true will get generated code.',
+        tools: ['scaffold_backend', 'generate_api_routes'],
+        docs_server_tools: ['get_scope_endpoint_map', 'get_api_reference'],
+    },
+    {
+        phase: 9,
+        name: 'Code Validation',
+        description: 'Validate the generated backend code against API schemas to catch any issues',
+        docs_server_tools: ['validate_api_code'],
+    },
+];
+export const lifecycleTools = [
+    {
+        name: 'get_app_lifecycle',
+        description: 'Get the complete Ratio app development lifecycle. Shows all phases from authentication to validation, ' +
+            'including which tools to call at each step. Call this first before starting any app development.',
+        inputSchema: z.object({}),
+        handler: async () => {
+            return {
+                success: true,
+                total_phases: LIFECYCLE_PHASES.length,
+                phases: LIFECYCLE_PHASES,
+                note: 'Tools prefixed with docs_server are from the ratio-docs-server. All other tools are from ratio-dev-server.',
+                important: [
+                    'Scope selection is critical — it drives which backend code gets auto-generated',
+                    'Always call define_app_requirements with confirmed=false first to preview scopes with the developer',
+                    'Frontend scaffold + build + submit is required before OAuth (admin must approve first)',
+                    'Backend code generation only works for resources with codegen_ready=true (currently: orders, products)',
+                    'Always validate generated code using validate_api_code before finalizing',
+                ],
+            };
+        },
+    },
+];
+//# sourceMappingURL=lifecycle.js.map

package/dist/tools/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/tools/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;IACvB;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,mDAAmD;QAChE,KAAK,EAAE,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,iBAAiB,CAAC;KACvE;IACD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,uEAAuE;QACpF,KAAK,EAAE,CAAC,YAAY,CAAC;KACtB;IACD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,iGAAiG;YACjG,oFAAoF;YACpF,+EAA+E;QACjF,KAAK,EAAE,CAAC,yBAAyB,CAAC;QAClC,iBAAiB,EAAE,CAAC,sBAAsB,CAAC;KAC5C;IACD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,6FAA6F;YAC7F,gGAAgG;QAClG,KAAK,EAAE,CAAC,mBAAmB,CAAC;KAC7B;IACD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,sFAAsF;QACnG,KAAK,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,EAAE,mBAAmB,CAAC;KAC1G;IACD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,qDAAqD;QAClE,KAAK,EAAE,CAAC,gBAAgB,CAAC;KAC1B;IACD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,2FAA2F;YAC3F,sFAAsF;QACxF,KAAK,EAAE,CAAC,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,CAAC;KAChE;IACD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,yFAAyF;YACzF,gGAAgG;YAChG,iEAAiE;QACnE,KAAK,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;QAClD,iBAAiB,EAAE,CAAC,wBAAwB,EAAE,mBAAmB,CAAC;KACnE;IACD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,6EAA6E;QAC1F,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;KACzC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,wGAAwG;YACxG,kGAAkG;QACpG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,gBAAgB,CAAC,MAAM;gBACrC,MAAM,EAAE,gBAAgB;gBACxB,IAAI,EAAE,4GAA4G;gBAClH,SAAS,EAAE;oBACT,gFAAgF;oBAChF,qGAAqG;oBACrG,wFAAwF;oBACxF,wGAAwG;oBACxG,0EAA0E;iBAC3E;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/tools/requirements.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './index.js';
+export declare const requirementsTools: ToolDefinition[];
+//# sourceMappingURL=requirements.d.ts.map

package/dist/tools/requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/tools/requirements.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,iBAAiB,EAAE,cAAc,EA0L7C,CAAC"}