glirastes 0.1.0

package/dist/codegen/fs-utils.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Recursively find all files matching a given name in a directory.
+ */
+export declare function findFiles(dir: string, fileName: string): Promise<string[]>;
+/**
+ * Check if a file contains the @ai-ignore marker.
+ */
+export declare function hasAiIgnore(filePath: string): Promise<boolean>;
+/**
+ * Check if a directory should be ignored for AI tool coverage.
+ * Checks for @ai-ignore in index.ts/index.tsx or .ai-ignore marker file.
+ */
+export declare function isDirAiIgnored(dirPath: string): Promise<boolean>;
+/**
+ * Convert an absolute file path to a module import path.
+ * e.g., /project/src/app/api/tasks/ai-tool.ts → @/app/api/tasks/ai-tool
+ */
+export declare function toImportPath(absolutePath: string, rootDir: string, srcPrefix?: string, alias?: string): string;
+/**
+ * Convert an absolute file path to a relative import path from a given output directory.
+ * Used when source and output are in different parts of a monorepo where @/ aliases don't work.
+ */
+export declare function toRelativeImportPath(absolutePath: string, outputDir: string): string;
+/**
+ * Read file contents, returns empty string if file doesn't exist.
+ */
+export declare function readFileSafe(filePath: string): Promise<string>;
+/**
+ * Find all route.ts files in a directory.
+ */
+export declare function findRouteFiles(dir: string): Promise<string[]>;
+/**
+ * Extract all top-level brace-balanced blocks for a given function call.
+ * Handles nested braces correctly (e.g., z.object({...}), uiAction: { payload: {...} }).
+ *
+ * @param content    Source file content
+ * @param fnPattern  Regex that matches the function call prefix up to (but not including) the opening `{`.
+ *                   Must NOT have the `g` flag — it is added internally.
+ * @returns Array of the inner content of each matched block (between the outermost `{` and `}`).
+ */
+export declare function extractBalancedBlocks(content: string, fnPattern: RegExp): string[];
+/**
+ * Get all immediate subdirectories of a directory.
+ */
+export declare function getSubdirectories(dir: string): Promise<string[]>;

package/dist/codegen/fs-utils.js

@@ -0,0 +1,155 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+/**
+ * Recursively find all files matching a given name in a directory.
+ */
+export async function findFiles(dir, fileName) {
+    const results = [];
+    async function walk(currentDir) {
+        let entries;
+        try {
+            entries = await readdir(currentDir, { withFileTypes: true });
+        }
+        catch {
+            return; // Directory doesn't exist or is inaccessible
+        }
+        for (const entry of entries) {
+            const fullPath = join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === 'node_modules' || entry.name === '.git')
+                    continue;
+                await walk(fullPath);
+            }
+            else if (entry.name === fileName) {
+                results.push(fullPath);
+            }
+        }
+    }
+    await walk(dir);
+    return results.sort();
+}
+/**
+ * Check if a file contains the @ai-ignore marker.
+ */
+export async function hasAiIgnore(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return content.includes('@ai-ignore');
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a directory should be ignored for AI tool coverage.
+ * Checks for @ai-ignore in index.ts/index.tsx or .ai-ignore marker file.
+ */
+export async function isDirAiIgnored(dirPath) {
+    // Check for .ai-ignore marker file
+    try {
+        await stat(join(dirPath, '.ai-ignore'));
+        return true;
+    }
+    catch {
+        // Not found, continue
+    }
+    // Check for @ai-ignore in index.ts or index.tsx
+    for (const indexFile of ['index.ts', 'index.tsx']) {
+        const indexPath = join(dirPath, indexFile);
+        if (await hasAiIgnore(indexPath))
+            return true;
+    }
+    return false;
+}
+/**
+ * Convert an absolute file path to a module import path.
+ * e.g., /project/src/app/api/tasks/ai-tool.ts → @/app/api/tasks/ai-tool
+ */
+export function toImportPath(absolutePath, rootDir, srcPrefix = 'src', alias = '@') {
+    const rel = relative(rootDir, absolutePath);
+    // Remove src/ prefix and .ts extension
+    const withoutSrc = rel.startsWith(srcPrefix + sep)
+        ? rel.slice(srcPrefix.length + 1)
+        : rel;
+    const withoutExt = withoutSrc.replace(/\.tsx?$/, '');
+    return `${alias}/${withoutExt.split(sep).join('/')}`;
+}
+/**
+ * Convert an absolute file path to a relative import path from a given output directory.
+ * Used when source and output are in different parts of a monorepo where @/ aliases don't work.
+ */
+export function toRelativeImportPath(absolutePath, outputDir) {
+    const rel = relative(outputDir, absolutePath);
+    const withoutExt = rel.replace(/\.tsx?$/, '');
+    const normalized = withoutExt.split(sep).join('/');
+    return normalized.startsWith('.') ? normalized : `./${normalized}`;
+}
+/**
+ * Read file contents, returns empty string if file doesn't exist.
+ */
+export async function readFileSafe(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Find all route.ts files in a directory.
+ */
+export async function findRouteFiles(dir) {
+    return findFiles(dir, 'route.ts');
+}
+/**
+ * Extract all top-level brace-balanced blocks for a given function call.
+ * Handles nested braces correctly (e.g., z.object({...}), uiAction: { payload: {...} }).
+ *
+ * @param content    Source file content
+ * @param fnPattern  Regex that matches the function call prefix up to (but not including) the opening `{`.
+ *                   Must NOT have the `g` flag — it is added internally.
+ * @returns Array of the inner content of each matched block (between the outermost `{` and `}`).
+ */
+export function extractBalancedBlocks(content, fnPattern) {
+    const results = [];
+    const globalPattern = new RegExp(fnPattern.source, 'g');
+    let prefixMatch;
+    while ((prefixMatch = globalPattern.exec(content)) !== null) {
+        // Find the opening { after the function call prefix
+        const searchStart = prefixMatch.index + prefixMatch[0].length;
+        const braceStart = content.indexOf('{', searchStart);
+        if (braceStart === -1)
+            continue;
+        // Walk forward counting braces
+        let depth = 0;
+        let i = braceStart;
+        for (; i < content.length; i++) {
+            if (content[i] === '{')
+                depth++;
+            else if (content[i] === '}')
+                depth--;
+            if (depth === 0)
+                break;
+        }
+        if (depth === 0) {
+            // Extract inner content (between outermost braces)
+            results.push(content.slice(braceStart + 1, i));
+        }
+    }
+    return results;
+}
+/**
+ * Get all immediate subdirectories of a directory.
+ */
+export async function getSubdirectories(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory() && e.name !== 'node_modules' && e.name !== '.git')
+            .map((e) => join(dir, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/codegen/fs-utils.js.map

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

package/dist/codegen/index.d.ts

@@ -0,0 +1,13 @@
+export { scanEndpointTools, generateEndpointRegistry } from './endpoint-scanner.js';
+export { scanUiTools, generateUiRegistry, generateActionIdRegistry } from './ui-scanner.js';
+export { generateModuleRegistry } from './module-generator.js';
+export { validateAiTools, formatValidationReport, type ValidationResult, type ValidationIssue } from './validator.js';
+export { checkAiCoverage, formatCoverageReport, type CoverageReport } from './coverage.js';
+export { scaffoldAiTool, formatScaffoldResult, type ScaffoldResult } from './scaffolder.js';
+export { colors } from './format.js';
+export { generateAgentSkills, type GenerateSkillsOptions, type GenerateSkillsResult } from './skill-generator.js';
+export { generateMcpServer, type GenerateMcpOptions, type GenerateMcpResult } from './mcp-generator.js';
+export { recommendOutputFormat, type OutputFormat, type RecommendationInput } from './output-recommender.js';
+export { syncAssetToGlirastes, type AssetSyncOptions, type AssetSyncResult } from './asset-sync.js';
+export { scanNestControllers, type DiscoveredNestTool, type NestScanResult } from './nestjs-scanner.js';
+export type { ScanResult, GenerateOptions } from './types.js';

package/dist/codegen/index.js

@@ -0,0 +1,13 @@
+export { scanEndpointTools, generateEndpointRegistry } from './endpoint-scanner.js';
+export { scanUiTools, generateUiRegistry, generateActionIdRegistry } from './ui-scanner.js';
+export { generateModuleRegistry } from './module-generator.js';
+export { validateAiTools, formatValidationReport } from './validator.js';
+export { checkAiCoverage, formatCoverageReport } from './coverage.js';
+export { scaffoldAiTool, formatScaffoldResult } from './scaffolder.js';
+export { colors } from './format.js';
+export { generateAgentSkills } from './skill-generator.js';
+export { generateMcpServer } from './mcp-generator.js';
+export { recommendOutputFormat } from './output-recommender.js';
+export { syncAssetToGlirastes } from './asset-sync.js';
+export { scanNestControllers } from './nestjs-scanner.js';
+//# sourceMappingURL=index.js.map

package/dist/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAA+C,MAAM,gBAAgB,CAAC;AACtH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAuB,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAuB,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAyD,MAAM,sBAAsB,CAAC;AAClH,OAAO,EAAE,iBAAiB,EAAmD,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,qBAAqB,EAA+C,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAAE,oBAAoB,EAA+C,MAAM,iBAAiB,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAgD,MAAM,qBAAqB,CAAC"}

package/dist/codegen/mcp-generator.d.ts

@@ -0,0 +1,50 @@
+import type { GenerateOptions } from './types.js';
+import type { AgentSkillConfig } from '../types.js';
+export interface GenerateMcpOptions extends GenerateOptions {
+    /** Skill configuration (app name, base URL, auth) */
+    skillConfig: AgentSkillConfig;
+    /** Custom output directory for MCP server files (default: mcp-server/) */
+    mcpOutputDir?: string;
+}
+export interface GenerateMcpResult {
+    /** Generated files with their relative paths and content */
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** Number of MCP tools generated */
+    toolCount: number;
+    /** Module names that contain tools */
+    modulesUsed: string[];
+    /** Full extracted tool metadata for syncing to Glirastes */
+    tools: Array<{
+        toolName: string;
+        description: string;
+        method: string;
+        path: string;
+        module?: string;
+        allowedRoles?: string[];
+        needsApproval?: boolean;
+        inputFields: Array<{
+            name: string;
+            type: string;
+            required: boolean;
+            description?: string;
+        }>;
+        outputFields: Array<{
+            name: string;
+            type: string;
+        }>;
+    }>;
+}
+/**
+ * Generate an MCP server project from discovered tool definitions.
+ *
+ * Scans the project for endpoint and UI tool definitions and produces
+ * a complete MCP server project as in-memory file contents. The caller
+ * is responsible for writing the files to disk.
+ *
+ * The generated server uses stdio transport and registers one MCP tool
+ * per discovered endpoint/UI tool, grouped by module.
+ */
+export declare function generateMcpServer(options: GenerateMcpOptions): Promise<GenerateMcpResult>;