@planu/cli 0.37.0 → 0.38.0

package/dist/config/license-plans.json

@@ -123,7 +123,8 @@
     "generate_changelog",
     "validate_team_results",
     "audit_claude_config",
-    "generate_docs_site"
+    "generate_docs_site",
+    "export_spec"
   ],
   "alwaysAllowed": [
     "activate_license",

package/dist/engine/reverse-engineer/api-detector.d.ts

@@ -0,0 +1,3 @@
+import type { ApiRoute } from '../../types/reverse-engineer.js';
+export declare function detectApiRoutes(rootDir: string): ApiRoute[];
+//# sourceMappingURL=api-detector.d.ts.map

package/dist/engine/reverse-engineer/api-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/reverse-engineer/api-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,iCAAiC,CAAC;AA4I9E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CA8C3D"}

package/dist/engine/reverse-engineer/api-detector.js

@@ -0,0 +1,170 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const ROUTE_PATTERNS = [
+    // Express/Koa/Hono: app.get('/path', handler) or router.post(...)
+    {
+        regex: /(?:app|router|server)\.(get|post|put|patch|delete|head|options|all)\s*\(\s*['"`]([^'"`]+)['"`](?:\s*,\s*(\w+))?/gi,
+        methodGroup: 1,
+        pathGroup: 2,
+        handlerGroup: 3,
+    },
+    // Fastify: fastify.get('/path', opts, handler)
+    {
+        regex: /fastify\.(get|post|put|patch|delete|head|options)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
+        methodGroup: 1,
+        pathGroup: 2,
+    },
+    // Next.js App Router: export async function GET/POST/PUT/DELETE
+    {
+        regex: /export\s+(?:async\s+)?function\s+(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s*\(/gi,
+        methodGroup: 1,
+        pathGroup: -1, // derived from file path
+    },
+    // Django: path('url/', view)
+    {
+        regex: /path\s*\(\s*['"]([^'"]+)['"](?:\s*,\s*(\w+))?/gi,
+        methodGroup: -1,
+        pathGroup: 1,
+        handlerGroup: 2,
+        defaultMethod: 'ALL',
+    },
+    // Flask: @app.route('/path', methods=['GET'])
+    {
+        regex: /@(?:app|bp|blueprint)\.route\s*\(\s*['"]([^'"]+)['"]\s*(?:,\s*methods\s*=\s*\[['"](\w+)['"])?/gi,
+        methodGroup: 2,
+        pathGroup: 1,
+    },
+    // Go net/http: http.HandleFunc("/path", handler)
+    {
+        regex: /http\.(?:HandleFunc|Handle)\s*\(\s*['"]([^'"]+)['"](?:\s*,\s*(\w+))?/gi,
+        methodGroup: -1,
+        pathGroup: 1,
+        handlerGroup: 2,
+        defaultMethod: 'ALL',
+    },
+    // Gin: r.GET("/path", handler)
+    {
+        regex: /(?:r|g|router|group)\.(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s*\(\s*['"]([^'"]+)['"](?:\s*,\s*(\w+))?/gi,
+        methodGroup: 1,
+        pathGroup: 2,
+        handlerGroup: 3,
+    },
+    // Spring Boot: @GetMapping("/path"), @RequestMapping
+    {
+        regex: /@(Get|Post|Put|Patch|Delete|Request)Mapping\s*\(\s*(?:value\s*=\s*)?['"]([^'"]+)['"]/gi,
+        methodGroup: 1,
+        pathGroup: 2,
+    },
+];
+const SOURCE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.py',
+    '.go',
+    '.java',
+    '.kt',
+    '.rb',
+]);
+const IGNORE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.nuxt',
+    'coverage',
+    'vendor',
+    '__pycache__',
+]);
+function collectSourceFiles(dir) {
+    const results = [];
+    const queue = [dir];
+    while (queue.length > 0) {
+        const current = queue.pop();
+        if (!current) {
+            continue;
+        }
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (IGNORE_DIRS.has(entry.name)) {
+                continue;
+            }
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                queue.push(full);
+            }
+            else if (entry.isFile() && SOURCE_EXTENSIONS.has(path.extname(entry.name))) {
+                results.push(full);
+            }
+        }
+    }
+    return results;
+}
+function extractResource(routePath) {
+    const segments = routePath.replace(/^\//, '').split('/');
+    const first = segments[0] ?? '';
+    // Strip params like :id or {id}
+    return first.replace(/[:{].*$/, '') || 'root';
+}
+function normalizeMethod(raw) {
+    const upper = raw.toUpperCase();
+    if (upper === 'REQUEST') {
+        return 'ALL';
+    }
+    return upper;
+}
+function derivePathFromFile(filePath, rootDir) {
+    // Next.js convention: app/api/users/route.ts -> /api/users
+    const rel = path.relative(rootDir, filePath);
+    const dir = path.dirname(rel);
+    return '/' + dir.replace(/\\/g, '/');
+}
+export function detectApiRoutes(rootDir) {
+    const files = collectSourceFiles(rootDir);
+    const routes = [];
+    for (const file of files) {
+        let content;
+        try {
+            content = fs.readFileSync(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        for (const pattern of ROUTE_PATTERNS) {
+            const regex = new RegExp(pattern.regex.source, pattern.regex.flags);
+            let match;
+            while ((match = regex.exec(content)) !== null) {
+                const methodRaw = pattern.methodGroup === -1
+                    ? (pattern.defaultMethod ?? 'ALL')
+                    : (match[pattern.methodGroup] ?? 'ALL');
+                const routePath = pattern.pathGroup === -1
+                    ? derivePathFromFile(file, rootDir)
+                    : (match[pattern.pathGroup] ?? '/');
+                const handler = pattern.handlerGroup
+                    ? (match[pattern.handlerGroup] ?? 'anonymous')
+                    : 'anonymous';
+                routes.push({
+                    method: normalizeMethod(methodRaw),
+                    path: routePath,
+                    handler,
+                    resource: extractResource(routePath),
+                });
+            }
+        }
+    }
+    return routes.sort((a, b) => a.resource.localeCompare(b.resource) ||
+        a.path.localeCompare(b.path) ||
+        a.method.localeCompare(b.method));
+}
+//# sourceMappingURL=api-detector.js.map

package/dist/engine/reverse-engineer/api-detector.js.map

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

package/dist/engine/reverse-engineer/complexity-analyzer.d.ts

@@ -0,0 +1,3 @@
+import type { ComplexityMetric } from '../../types/reverse-engineer.js';
+export declare function analyzeComplexity(rootDir: string): ComplexityMetric[];
+//# sourceMappingURL=complexity-analyzer.d.ts.map

package/dist/engine/reverse-engineer/complexity-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/reverse-engineer/complexity-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,iCAAiC,CAAC;AA+MzC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAyCrE"}

package/dist/engine/reverse-engineer/complexity-analyzer.js

@@ -0,0 +1,230 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const SOURCE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.py',
+    '.go',
+    '.java',
+    '.kt',
+    '.rs',
+    '.rb',
+]);
+const IGNORE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.nuxt',
+    'coverage',
+    'vendor',
+    '__pycache__',
+]);
+// Patterns that increase cyclomatic complexity
+const BRANCH_PATTERNS = [
+    /\bif\s*\(/g,
+    /\belse\s+if\s*\(/g,
+    /\belse\s*\{/g,
+    /\bswitch\s*\(/g,
+    /\bcase\s+/g,
+    /\bfor\s*\(/g,
+    /\bfor\s+\w+/g, // Go/Python for
+    /\bwhile\s*\(/g,
+    /\bcatch\s*\(/g,
+    /\?\?/g, // nullish coalescing
+    /&&/g,
+    /\|\|/g,
+    /\?\s*[^:?]/g, // ternary (approximate)
+];
+// Function declaration patterns
+const FUNCTION_PATTERNS = [
+    // JS/TS: function name(, async function name(, export function
+    /(?:export\s+)?(?:async\s+)?function\s+\w+\s*\(/g,
+    // Arrow functions assigned: const name = (...) =>
+    /(?:const|let|var)\s+\w+\s*=\s*(?:async\s+)?\([^)]*\)\s*=>/g,
+    // Method definitions: name( or async name(
+    /^\s+(?:async\s+)?(?:static\s+)?(?:get\s+|set\s+)?\w+\s*\([^)]*\)\s*(?::\s*\w[^{]*)?{/gm,
+    // Python: def name(
+    /\bdef\s+\w+\s*\(/g,
+    // Go: func name(
+    /\bfunc\s+(?:\([^)]*\)\s*)?\w+\s*\(/g,
+    // Java: public/private/protected ... name(
+    /(?:public|private|protected)\s+(?:static\s+)?[\w<>[\]]+\s+\w+\s*\(/g,
+];
+function collectSourceFiles(dir) {
+    const results = [];
+    const queue = [dir];
+    while (queue.length > 0) {
+        const current = queue.pop();
+        if (!current) {
+            continue;
+        }
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (IGNORE_DIRS.has(entry.name)) {
+                continue;
+            }
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                queue.push(full);
+            }
+            else if (entry.isFile() && SOURCE_EXTENSIONS.has(path.extname(entry.name))) {
+                results.push(full);
+            }
+        }
+    }
+    return results;
+}
+function countBranches(content) {
+    let count = 0;
+    for (const pattern of BRANCH_PATTERNS) {
+        const regex = new RegExp(pattern.source, pattern.flags);
+        while (regex.exec(content) !== null) {
+            count++;
+        }
+    }
+    return count + 1; // base complexity of 1
+}
+function extractFunctions(content) {
+    const lines = content.split('\n');
+    const functions = [];
+    for (const pattern of FUNCTION_PATTERNS) {
+        const regex = new RegExp(pattern.source, pattern.flags);
+        let match;
+        while ((match = regex.exec(content)) !== null) {
+            const startOffset = match.index;
+            const startLine = content.substring(0, startOffset).split('\n').length;
+            const name = extractFunctionName(match[0]);
+            // Estimate function end by counting braces
+            const endLine = findFunctionEnd(lines, startLine - 1);
+            const funcLines = endLine - startLine + 1;
+            const funcContent = lines.slice(startLine - 1, endLine).join('\n');
+            const complexity = countBranches(funcContent);
+            functions.push({
+                name,
+                startLine,
+                endLine,
+                lines: funcLines,
+                complexity,
+            });
+        }
+    }
+    // Deduplicate overlapping detections (keep longest)
+    return deduplicateFunctions(functions);
+}
+function extractFunctionName(declaration) {
+    const patterns = [
+        /function\s+(\w+)/,
+        /(?:const|let|var)\s+(\w+)/,
+        /def\s+(\w+)/,
+        /func\s+(?:\([^)]*\)\s*)?(\w+)/,
+        /\s(\w+)\s*\(/,
+    ];
+    for (const p of patterns) {
+        const m = declaration.match(p);
+        if (m?.[1]) {
+            return m[1];
+        }
+    }
+    return 'anonymous';
+}
+function findFunctionEnd(lines, startIdx) {
+    let braceCount = 0;
+    let foundOpen = false;
+    for (let i = startIdx; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        for (const ch of line) {
+            if (ch === '{') {
+                braceCount++;
+                foundOpen = true;
+            }
+            else if (ch === '}') {
+                braceCount--;
+            }
+        }
+        if (foundOpen && braceCount <= 0) {
+            return i + 1;
+        }
+    }
+    // For Python/other non-brace languages, estimate ~20 lines
+    return Math.min(startIdx + 20, lines.length);
+}
+function deduplicateFunctions(functions) {
+    if (functions.length === 0) {
+        return [];
+    }
+    // Sort by start line
+    const sorted = [...functions].sort((a, b) => a.startLine - b.startLine);
+    const first = sorted[0];
+    if (!first) {
+        return [];
+    }
+    const result = [first];
+    for (let i = 1; i < sorted.length; i++) {
+        const prev = result[result.length - 1];
+        const curr = sorted[i];
+        if (!prev || !curr) {
+            continue;
+        }
+        // If overlapping, keep the one with more lines
+        if (curr.startLine <= prev.endLine) {
+            if (curr.lines > prev.lines) {
+                result[result.length - 1] = curr;
+            }
+        }
+        else {
+            result.push(curr);
+        }
+    }
+    return result;
+}
+export function analyzeComplexity(rootDir) {
+    const files = collectSourceFiles(rootDir);
+    const metrics = [];
+    for (const file of files) {
+        let content;
+        try {
+            content = fs.readFileSync(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split('\n');
+        const lineCount = lines.length;
+        const functions = extractFunctions(content);
+        const functionCount = functions.length;
+        const maxFunctionLength = functions.reduce((max, f) => Math.max(max, f.lines), 0);
+        const avgComplexity = functionCount > 0
+            ? Math.round((functions.reduce((sum, f) => sum + f.complexity, 0) / functionCount) * 100) /
+                100
+            : 0;
+        // Flag hotspots: functions > 80 lines or > 15 complexity
+        const hotspots = functions
+            .filter((f) => f.lines > 80 || f.complexity > 15)
+            .map((f) => ({ name: f.name, complexity: f.complexity, lines: f.lines }))
+            .sort((a, b) => b.complexity - a.complexity);
+        metrics.push({
+            file: path.relative(rootDir, file),
+            lineCount,
+            functionCount,
+            maxFunctionLength,
+            avgComplexity,
+            hotspots,
+        });
+    }
+    // Return top 10 by complexity
+    return metrics.sort((a, b) => b.avgComplexity - a.avgComplexity).slice(0, 10);
+}
+//# sourceMappingURL=complexity-analyzer.js.map

package/dist/engine/reverse-engineer/complexity-analyzer.js.map

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

package/dist/engine/reverse-engineer/config-analyzer.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigReport } from '../../types/reverse-engineer.js';
+export declare function analyzeConfig(rootDir: string): ConfigReport;
+//# sourceMappingURL=config-analyzer.d.ts.map

package/dist/engine/reverse-engineer/config-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/reverse-engineer/config-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AA+NpE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CA4C3D"}