glirastes 0.1.0

package/dist/codegen/validator.js

@@ -0,0 +1,256 @@
+import { join, dirname } from 'node:path';
+import { findFiles, findRouteFiles, isDirAiIgnored, readFileSafe, extractBalancedBlocks, } from './fs-utils.js';
+import { resolveDefaults } from './types.js';
+import { colors, header } from './format.js';
+/**
+ * Validate AI tool configuration across the project.
+ *
+ * Checks:
+ * 1. All API routes have an ai-tool.ts file (unless @ai-ignore)
+ * 2. All component directories with UI have ai-ui-tool.ts (unless @ai-ignore)
+ * 3. No orphaned ai-tool.ts files without corresponding route.ts
+ * 4. Tool files have required exports
+ * 5. Path consistency between file location and defined endpoint path
+ * 6. Module field is present in tool definitions
+ * 7. NestJS controllers have @AiTool decorators (unless @ai-ignore)
+ */
+export async function validateAiTools(options) {
+    const opts = resolveDefaults(options);
+    const issues = [];
+    // 1. Check routes have ai-tool.ts
+    const apiDir = join(opts.rootDir, opts.apiDir);
+    const routeFiles = await findRouteFiles(apiDir);
+    for (const routeFile of routeFiles) {
+        const routeContent = await readFileSafe(routeFile);
+        if (routeContent.includes('@ai-ignore'))
+            continue;
+        const routeDir = dirname(routeFile);
+        if (await isDirAiIgnored(routeDir))
+            continue;
+        const toolFile = join(routeDir, opts.endpointToolFileName);
+        const toolContent = await readFileSafe(toolFile);
+        const relFile = routeFile.replace(opts.rootDir + '/', '');
+        if (!toolContent && !routeContent.includes('withAiTool(')) {
+            issues.push({
+                severity: 'warning',
+                file: relFile,
+                message: `Route without ${opts.endpointToolFileName}`,
+                suggestion: `glirastes scaffold --route "${relFile}"`,
+            });
+        }
+    }
+    // 2. Check ai-tool.ts files have corresponding route.ts
+    const toolFiles = await findFiles(apiDir, opts.endpointToolFileName);
+    for (const toolFile of toolFiles) {
+        const toolDir = dirname(toolFile);
+        const routeFile = join(toolDir, 'route.ts');
+        const routeContent = await readFileSafe(routeFile);
+        const relFile = toolFile.replace(opts.rootDir + '/', '');
+        if (!routeContent) {
+            const routeRelFile = routeFile.replace(opts.rootDir + '/', '');
+            issues.push({
+                severity: 'error',
+                file: relFile,
+                message: `${opts.endpointToolFileName} has no corresponding route.ts`,
+                suggestion: `Create ${routeRelFile} or remove ${relFile}`,
+            });
+        }
+    }
+    // 3. Check tool files have required exports
+    for (const toolFile of toolFiles) {
+        const content = await readFileSafe(toolFile);
+        if (content.includes('@ai-ignore'))
+            continue;
+        const relFile = toolFile.replace(opts.rootDir + '/', '');
+        const hasArrayExport = /export\s+const\s+aiTools\s*[=:]/m.test(content);
+        const hasSingleExport = /export\s+const\s+aiTool\s*[=:]/m.test(content);
+        if (!hasArrayExport && !hasSingleExport) {
+            issues.push({
+                severity: 'error',
+                file: relFile,
+                message: `Missing export: expected 'export const aiTools' or 'export const aiTool'`,
+                suggestion: `Add 'export const aiTool = defineEndpointTool({...})'`,
+            });
+        }
+        // Check for description
+        if (!content.includes('description')) {
+            issues.push({
+                severity: 'warning',
+                file: relFile,
+                message: 'Tool definition is missing a description',
+                suggestion: `Add description with usage hints for the AI`,
+            });
+        }
+    }
+    // 4. Check path consistency and module field
+    for (const toolFile of toolFiles) {
+        const content = await readFileSafe(toolFile);
+        if (content.includes('@ai-ignore'))
+            continue;
+        const relPath = toolFile.replace(opts.rootDir + '/', '');
+        // Extract path values from tool definitions
+        const pathMatches = content.matchAll(/path\s*:\s*['"`]([^'"`]+)['"`]/g);
+        for (const match of pathMatches) {
+            const definedPath = match[1];
+            // Derive expected path from file location: src/app/api/tasks/[id]/subtasks/ai-tool.ts → /api/tasks/:id/subtasks
+            const expectedPath = '/' + dirname(relPath)
+                .replace(/^src\/app\//, '')
+                .replace(/\[([^\]]+)\]/g, ':$1'); // convert [param] to :param
+            // Check that the defined path starts with the expected base
+            if (!definedPath.startsWith(expectedPath.replace(/\/+$/, ''))) {
+                issues.push({
+                    severity: 'warning',
+                    file: relPath,
+                    message: `Path '${definedPath}' doesn't match file location '${expectedPath}'`,
+                    suggestion: `Update path to '${expectedPath}'`,
+                });
+            }
+        }
+        // Check for module field presence (brace-balanced)
+        const toolBlocksArr = extractBalancedBlocks(content, /define(?:Ai)?EndpointTool\(\s*/);
+        for (const block of toolBlocksArr) {
+            const hasModule = /module\s*:/.test(block);
+            if (!hasModule) {
+                const toolNameMatch = block.match(/toolName\s*:\s*['"`]([^'"`]+)['"`]/);
+                const toolName = toolNameMatch?.[1] ?? 'unknown';
+                issues.push({
+                    severity: 'info',
+                    file: relPath,
+                    message: `Tool '${toolName}' has no module field`,
+                    suggestion: `Add module: 'task_query' | 'task_mutation' | 'navigation' | ...`,
+                });
+            }
+        }
+    }
+    // 5. Check UI tool files have required exports
+    const componentsDir = join(opts.rootDir, opts.componentsDir);
+    const uiToolFiles = await findFiles(componentsDir, opts.uiToolFileName);
+    for (const uiToolFile of uiToolFiles) {
+        const content = await readFileSafe(uiToolFile);
+        if (content.includes('@ai-ignore'))
+            continue;
+        const relFile = uiToolFile.replace(opts.rootDir + '/', '');
+        const hasExport = /export\s+const\s+aiUiTools\s*[=:]/m.test(content);
+        if (!hasExport) {
+            issues.push({
+                severity: 'error',
+                file: relFile,
+                message: `Missing export: expected 'export const aiUiTools'`,
+                suggestion: `Add 'export const aiUiTools = [defineUiTool({...})]'`,
+            });
+        }
+        // Check module field in UI tool definitions (brace-balanced)
+        const uiToolBlocksArr = extractBalancedBlocks(content, /define(?:Ai)?UiTool\(\s*/);
+        for (const block of uiToolBlocksArr) {
+            const hasModule = /module\s*:/.test(block);
+            if (!hasModule) {
+                const toolNameMatch = block.match(/toolName\s*:\s*['"`]([^'"`]+)['"`]/);
+                const toolName = toolNameMatch?.[1] ?? 'unknown';
+                issues.push({
+                    severity: 'info',
+                    file: relFile,
+                    message: `UI tool '${toolName}' has no module field`,
+                    suggestion: `Add module field for intent-based routing`,
+                });
+            }
+        }
+    }
+    // 6. Check NestJS controllers have @AiTool decorators
+    if (opts.nestjsDirs.length > 0) {
+        const { scanNestControllers } = await import('./nestjs-scanner.js');
+        const nestResult = await scanNestControllers(opts.nestjsDirs, opts.nestjsApiPrefix);
+        for (const ctrl of nestResult.uncoveredControllers) {
+            const relFile = ctrl.controllerFile.replace(opts.rootDir + '/', '');
+            issues.push({
+                severity: 'warning',
+                file: relFile,
+                message: `${ctrl.controllerName} has ${ctrl.httpMethodCount} HTTP endpoint(s) but no @AiTool decorators`,
+                suggestion: `Add @AiModule + @AiTool decorators, or add // @ai-ignore to exclude`,
+            });
+        }
+    }
+    // Tally results
+    const errorCount = issues.filter((i) => i.severity === 'error').length;
+    const warningCount = issues.filter((i) => i.severity === 'warning').length;
+    const infoCount = issues.filter((i) => i.severity === 'info').length;
+    return {
+        issues,
+        errorCount,
+        warningCount,
+        infoCount,
+        passed: errorCount === 0,
+    };
+}
+/**
+ * Format a validation result as a rich, color-coded human-readable string.
+ */
+export function formatValidationReport(result, options) {
+    if (options?.quiet && result.issues.length === 0) {
+        return `${colors.green}\u2713${colors.reset} AI tools validation passed`;
+    }
+    const lines = [];
+    // Header
+    lines.push(header('AI Tools Validation'));
+    // No issues
+    if (result.issues.length === 0) {
+        lines.push(`${colors.green}\u2705 All AI tools are properly configured!${colors.reset}`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    const errors = result.issues.filter((i) => i.severity === 'error');
+    const warnings = result.issues.filter((i) => i.severity === 'warning');
+    const infos = result.issues.filter((i) => i.severity === 'info');
+    // Errors
+    if (errors.length > 0) {
+        lines.push(`${colors.red}${colors.bold}\u274C ${errors.length} Error(s):${colors.reset}\n`);
+        for (const issue of errors) {
+            lines.push(`  ${colors.red}\u274C${colors.reset} ${colors.bold}${issue.file}${colors.reset}`);
+            lines.push(`     ${issue.message}`);
+            if (issue.suggestion) {
+                lines.push(`     ${colors.cyan}\u2192 ${issue.suggestion}${colors.reset}`);
+            }
+            lines.push('');
+        }
+    }
+    // Warnings
+    if (warnings.length > 0) {
+        lines.push(`${colors.yellow}${colors.bold}\u26A0\uFE0F  ${warnings.length} Warning(s):${colors.reset}\n`);
+        for (const issue of warnings) {
+            lines.push(`  ${colors.yellow}\u26A0\uFE0F${colors.reset}  ${colors.bold}${issue.file}${colors.reset}`);
+            lines.push(`     ${issue.message}`);
+            if (issue.suggestion) {
+                lines.push(`     ${colors.cyan}\u2192 ${issue.suggestion}${colors.reset}`);
+            }
+            lines.push('');
+        }
+    }
+    // Info (only when not quiet)
+    if (infos.length > 0 && !options?.quiet) {
+        lines.push(`${colors.blue}${colors.bold}\u2139\uFE0F  ${infos.length} Info(s):${colors.reset}\n`);
+        for (const issue of infos) {
+            lines.push(`  ${colors.blue}\u2139\uFE0F${colors.reset}  ${colors.bold}${issue.file}${colors.reset}`);
+            lines.push(`     ${issue.message}`);
+            if (issue.suggestion) {
+                lines.push(`     ${colors.cyan}\u2192 ${issue.suggestion}${colors.reset}`);
+            }
+            lines.push('');
+        }
+    }
+    // Quick fix section
+    if (options?.showFix) {
+        const missingAiTools = result.issues.filter((i) => i.severity === 'warning' && i.suggestion?.startsWith('glirastes scaffold'));
+        if (missingAiTools.length > 0) {
+            lines.push(`${colors.cyan}${colors.bold}Quick Fix:${colors.reset}`);
+            lines.push(`${colors.dim}Run scaffold command for missing ai-tool.ts files:${colors.reset}\n`);
+            for (const issue of missingAiTools) {
+                lines.push(`  ${colors.cyan}${issue.suggestion}${colors.reset}`);
+            }
+            lines.push('');
+        }
+    }
+    // Summary line
+    lines.push(`${colors.dim}Summary: ${result.errorCount} errors, ${result.warningCount} warnings, ${result.infoCount} infos${colors.reset}`);
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=validator.js.map

package/dist/codegen/validator.js.map

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

package/dist/openapi/demo-generate.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/openapi/demo-generate.js

@@ -0,0 +1,15 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { generateFromOpenApiFile } from './index.js';
+const currentFile = fileURLToPath(import.meta.url);
+const currentDir = path.dirname(currentFile);
+const repoRoot = path.resolve(currentDir, '../../../');
+const inputPath = path.join(repoRoot, 'examples/openapi.todo.json');
+const outputPath = path.join(repoRoot, 'examples/generated/endpoint-tools.generated.ts');
+const validation = await generateFromOpenApiFile({ inputPath, outputPath });
+for (const warning of validation.warnings) {
+    console.warn(warning);
+}
+console.log(`Generated: ${outputPath}`);
+console.log(`Enabled AI tools: ${validation.enabledTools}. Warnings: ${validation.warnings.length}.`);
+//# sourceMappingURL=demo-generate.js.map

package/dist/openapi/demo-generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-generate.js","sourceRoot":"","sources":["../../src/openapi/demo-generate.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAEvD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAC;AACpE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gDAAgD,CAAC,CAAC;AAEzF,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;AAE5E,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,GAAG,CAAC,qBAAqB,UAAU,CAAC,YAAY,eAAe,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC"}

package/dist/openapi/index.d.ts

@@ -0,0 +1,78 @@
+import type { EndpointMethod, OpenApiAiExtension } from '../types.js';
+type ParameterLocation = 'path' | 'query' | 'header' | 'cookie';
+interface OpenApiReference {
+    $ref: string;
+}
+interface OpenApiSchema {
+    type?: string;
+    format?: string;
+    enum?: unknown[];
+    items?: OpenApiSchema | OpenApiReference;
+    properties?: Record<string, OpenApiSchema | OpenApiReference>;
+    required?: string[];
+    additionalProperties?: boolean | OpenApiSchema | OpenApiReference;
+}
+interface OpenApiMediaType {
+    schema?: OpenApiSchema | OpenApiReference;
+}
+interface OpenApiRequestBody {
+    required?: boolean;
+    content?: Record<string, OpenApiMediaType>;
+}
+interface OpenApiParameter {
+    name: string;
+    in: ParameterLocation;
+    required?: boolean;
+    schema?: OpenApiSchema | OpenApiReference;
+}
+interface OpenApiOperation {
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    parameters?: Array<OpenApiParameter | OpenApiReference>;
+    requestBody?: OpenApiRequestBody | OpenApiReference;
+    'x-ai'?: OpenApiAiExtension;
+}
+interface OpenApiPathItem {
+    parameters?: Array<OpenApiParameter | OpenApiReference>;
+    get?: OpenApiOperation;
+    post?: OpenApiOperation;
+    patch?: OpenApiOperation;
+    put?: OpenApiOperation;
+    delete?: OpenApiOperation;
+}
+interface OpenApiComponents {
+    schemas?: Record<string, OpenApiSchema>;
+    parameters?: Record<string, OpenApiParameter>;
+    requestBodies?: Record<string, OpenApiRequestBody>;
+}
+interface OpenApiDocument {
+    paths?: Record<string, OpenApiPathItem>;
+    components?: OpenApiComponents;
+}
+interface ValidationResult {
+    enabledTools: number;
+    errors: string[];
+    warnings: string[];
+}
+export interface GeneratedToolSpec {
+    id: string;
+    toolName: string;
+    description: string;
+    method: EndpointMethod;
+    path: string;
+    needsApproval: boolean;
+    inputSchemaCode: string;
+    uiActionOnSuccess?: Record<string, unknown> | Record<string, unknown>[];
+}
+export declare function validateOpenApiDocument(document: OpenApiDocument): ValidationResult;
+export declare function extractGeneratedToolSpecs(document: OpenApiDocument): GeneratedToolSpec[];
+export declare function renderTypeScriptFromSpecs(specs: GeneratedToolSpec[]): string;
+export declare function validateOpenApiFile(options: {
+    inputPath: string;
+}): Promise<ValidationResult>;
+export declare function generateFromOpenApiFile(options: {
+    inputPath: string;
+    outputPath: string;
+}): Promise<ValidationResult>;
+export {};