@planu/cli 0.72.0 → 0.74.0

package/dist/engine/rules-generator/index.js

@@ -0,0 +1,313 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { detectAiTools, getPrimaryAiTool } from '../ai-tool-detector/index.js';
+// Stack-specific architecture rules catalog
+export const ARCHITECTURE_RULES = {
+    nextjs: {
+        title: 'Next.js API Architecture',
+        description: 'Clean separation for Next.js API routes',
+        layers: [
+            {
+                name: 'Route Handler',
+                path: 'app/api/',
+                responsibility: 'Parse request, validate input, call service, format response',
+            },
+            {
+                name: 'Service',
+                path: 'lib/services/',
+                responsibility: 'Business logic, orchestration, transaction boundaries',
+            },
+            {
+                name: 'Repository',
+                path: 'lib/repositories/',
+                responsibility: 'Data access (DB queries, external APIs)',
+            },
+        ],
+        conventions: [
+            'Never put business logic in route handlers',
+            'Route handlers should be under 30 lines',
+            'Services are framework-agnostic (no NextRequest/NextResponse)',
+            'Repositories return plain objects, never ORM entities',
+        ],
+        maxLinesPerHandler: 30,
+    },
+    express: {
+        title: 'Express Architecture',
+        description: 'Clean separation for Express.js APIs',
+        layers: [
+            {
+                name: 'Controller',
+                path: 'src/controllers/',
+                responsibility: 'Parse request, validate, respond',
+            },
+            {
+                name: 'Service',
+                path: 'src/services/',
+                responsibility: 'Business logic and orchestration',
+            },
+            {
+                name: 'Repository',
+                path: 'src/repositories/',
+                responsibility: 'Data access layer',
+            },
+        ],
+        conventions: [
+            'Controllers call services, never repositories directly',
+            'Services are stateless',
+            'One file per resource',
+        ],
+        maxLinesPerHandler: 40,
+    },
+    fastapi: {
+        title: 'FastAPI Architecture',
+        description: 'Clean separation for Python FastAPI',
+        layers: [
+            {
+                name: 'Router',
+                path: 'app/routers/',
+                responsibility: 'Endpoint definitions, input validation',
+            },
+            {
+                name: 'Service',
+                path: 'app/services/',
+                responsibility: 'Business logic',
+            },
+            {
+                name: 'Repository',
+                path: 'app/repositories/',
+                responsibility: 'Database access (SQLAlchemy/Prisma)',
+            },
+        ],
+        conventions: [
+            'Use dependency injection via Depends()',
+            'Pydantic models for all I/O',
+            'Async by default',
+        ],
+        maxLinesPerHandler: 30,
+    },
+    default: {
+        title: 'Clean Architecture',
+        description: 'Generic clean architecture rules',
+        layers: [
+            {
+                name: 'Handler',
+                path: 'src/handlers/',
+                responsibility: 'Input/output boundary',
+            },
+            {
+                name: 'Service',
+                path: 'src/services/',
+                responsibility: 'Business logic',
+            },
+            {
+                name: 'Repository',
+                path: 'src/repositories/',
+                responsibility: 'Data access',
+            },
+        ],
+        conventions: [
+            'Separate concerns by layer',
+            'Dependencies point inward',
+            'No framework code in business logic',
+        ],
+        maxLinesPerHandler: 50,
+    },
+};
+/** Detect stack from project files. Returns a key into ARCHITECTURE_RULES. */
+export function detectArchitectureStack(projectPath) {
+    // Next.js detection
+    if (existsSync(join(projectPath, 'next.config.js')) ||
+        existsSync(join(projectPath, 'next.config.ts')) ||
+        existsSync(join(projectPath, 'next.config.mjs'))) {
+        return 'nextjs';
+    }
+    // FastAPI detection
+    const requirementsTxt = join(projectPath, 'requirements.txt');
+    if (existsSync(requirementsTxt)) {
+        try {
+            const content = readFileSync(requirementsTxt, 'utf-8');
+            if (content.toLowerCase().includes('fastapi')) {
+                return 'fastapi';
+            }
+        }
+        catch {
+            // best-effort
+        }
+    }
+    // Express detection via package.json
+    const packageJsonPath = join(projectPath, 'package.json');
+    if (existsSync(packageJsonPath)) {
+        try {
+            const raw = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            if (typeof raw === 'object' && raw !== null) {
+                const pkg = raw;
+                const deps = {
+                    ...(typeof pkg.dependencies === 'object'
+                        ? pkg.dependencies
+                        : {}),
+                    ...(typeof pkg.devDependencies === 'object'
+                        ? pkg.devDependencies
+                        : {}),
+                };
+                if ('express' in deps) {
+                    return 'express';
+                }
+            }
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return 'default';
+}
+/** Format layers table as markdown. */
+function formatLayersTable(layers) {
+    const rows = layers.map((l) => `| ${l.name} | \`${l.path}\` | ${l.responsibility} |`);
+    return ['| Layer | Path | Responsibility |', '|-------|------|----------------|', ...rows].join('\n');
+}
+/** Generate rules content formatted for a specific AI tool. */
+export function generateRulesContent(rule, tool) {
+    const conventions = rule.conventions.map((c) => `- ${c}`).join('\n');
+    const layersTable = formatLayersTable(rule.layers);
+    // All tools use markdown; formatting varies slightly per tool
+    switch (tool.toolId) {
+        case 'cursor':
+        case 'windsurf': {
+            // Flat markdown without deep nesting — cursor/windsurf prefer concise rules
+            return [
+                `# ${rule.title}`,
+                '',
+                rule.description,
+                '',
+                '## Layers',
+                layersTable,
+                '',
+                '## Conventions',
+                conventions,
+                '',
+                `## Handler Size Limit`,
+                `Max ${rule.maxLinesPerHandler} lines per handler/controller.`,
+                '',
+            ].join('\n');
+        }
+        case 'copilot': {
+            // GitHub Copilot instructions format
+            return [
+                `# Architecture Rules: ${rule.title}`,
+                '',
+                `> ${rule.description}`,
+                '',
+                '## Layer Structure',
+                layersTable,
+                '',
+                '## Coding Conventions',
+                conventions,
+                '',
+                `## Size Constraints`,
+                `- Max ${rule.maxLinesPerHandler} lines per handler`,
+                '',
+            ].join('\n');
+        }
+        case 'aider': {
+            // Aider CONVENTIONS.md style
+            return [
+                `# ${rule.title}`,
+                '',
+                rule.description,
+                '',
+                '## Architecture Layers',
+                layersTable,
+                '',
+                '## Conventions',
+                conventions,
+                '',
+                `## Constraints`,
+                `- Handlers/controllers: max ${rule.maxLinesPerHandler} lines`,
+                '',
+            ].join('\n');
+        }
+        case 'claude':
+        default: {
+            // Standard markdown with full headers — Claude Code format
+            return [
+                `# ${rule.title}`,
+                '',
+                `> ${rule.description}`,
+                '',
+                '## Layer Separation (MANDATORY)',
+                '',
+                layersTable,
+                '',
+                '## Conventions (MANDATORY)',
+                '',
+                conventions,
+                '',
+                '## Size Budget',
+                '',
+                `- Max **${rule.maxLinesPerHandler} lines** per handler/controller`,
+                '- Extract helpers when exceeding this limit',
+                '',
+            ].join('\n');
+        }
+    }
+}
+/** Resolve the file path where rules should be written for a given tool. */
+function resolveRulesFilePath(projectPath, tool, stackKey) {
+    switch (tool.toolId) {
+        case 'claude':
+            return join(projectPath, tool.rulesPath, `architecture-${stackKey}.md`);
+        case 'cursor':
+            return join(projectPath, '.cursorrules');
+        case 'copilot':
+            return join(projectPath, '.github', 'copilot-instructions.md');
+        case 'windsurf':
+            return join(projectPath, '.windsurfrules');
+        case 'aider':
+            return join(projectPath, 'CONVENTIONS.md');
+        default:
+            return join(projectPath, tool.rulesPath, `architecture-${stackKey}.md`);
+    }
+}
+/** Main entry: detect stack + tools, generate all rules objects. */
+export function generateProjectRules(projectPath) {
+    const stackKey = detectArchitectureStack(projectPath);
+    const defaultRule = ARCHITECTURE_RULES.default;
+    const rule = ARCHITECTURE_RULES[stackKey] ?? defaultRule;
+    if (!rule) {
+        return [];
+    }
+    const tools = detectAiTools(projectPath);
+    // If no tools detected, generate for claude (default)
+    const effectiveTools = tools.length > 0 ? tools : [getPrimaryAiTool(projectPath)];
+    return effectiveTools.map((tool) => {
+        const filePath = resolveRulesFilePath(projectPath, tool, stackKey);
+        const alreadyExists = existsSync(filePath);
+        const content = generateRulesContent(rule, tool);
+        return { tool, content, filePath, alreadyExists };
+    });
+}
+/** Write rules to disk, skipping files that already exist. */
+export function writeRules(rules) {
+    const written = [];
+    const skipped = [];
+    for (const rule of rules) {
+        if (rule.alreadyExists) {
+            skipped.push(rule.filePath);
+            continue;
+        }
+        try {
+            const dir = rule.filePath.substring(0, rule.filePath.lastIndexOf('/'));
+            if (dir) {
+                mkdirSync(dir, { recursive: true });
+            }
+            writeFileSync(rule.filePath, rule.content, 'utf-8');
+            written.push(rule.filePath);
+        }
+        catch {
+            // best-effort — skip on error
+            skipped.push(rule.filePath);
+        }
+    }
+    return { written, skipped };
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/rules-generator/index.js.map

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

package/dist/engine/rules-reconciler.d.ts

@@ -0,0 +1,13 @@
+import type { RulesReconciliation } from '../types/index.js';
+export type { RulesReconciliation };
+declare function readFileSafe(path: string): string;
+/**
+ * Compare CLAUDE.md conventions against existing .claude/rules/ files.
+ * Auto-patches missing convention categories by generating new rules files.
+ * Never overwrites existing rules files.
+ *
+ * Never throws — returns a zero-score reconciliation on unexpected errors.
+ */
+export declare function reconcileRules(projectPath: string): RulesReconciliation;
+export { readFileSafe };
+//# sourceMappingURL=rules-reconciler.d.ts.map

package/dist/engine/rules-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-reconciler.d.ts","sourceRoot":"","sources":["../../src/engine/rules-reconciler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAepC,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1C;AA6HD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CA6DvE;AAGD,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/engine/rules-reconciler.js

@@ -0,0 +1,193 @@
+// engine/rules-reconciler.ts — Compare CLAUDE.md conventions against .claude/rules/ and auto-patch drift (SPEC-189)
+import { readFileSync, readdirSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { parseConventions } from './convention-scanner/convention-parser.js';
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function listRulesFiles(projectPath) {
+    const rulesDir = join(projectPath, '.claude', 'rules');
+    try {
+        return readdirSync(rulesDir)
+            .filter((f) => f.endsWith('.md'))
+            .map((f) => join(rulesDir, f));
+    }
+    catch {
+        return [];
+    }
+}
+function readFileSafe(path) {
+    try {
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+/** Unique convention categories detected in CLAUDE.md (source: 'claude-md' only). */
+function categoriesInClaudeMd(rules) {
+    const categories = new Set();
+    for (const r of rules) {
+        if (r.source === 'claude-md') {
+            categories.add(r.category);
+        }
+    }
+    return categories;
+}
+/**
+ * Build a map: category → rules files that mention it (via keyword matching).
+ * A rules file "covers" a category if it contains any line that would parse
+ * as that category using the same keywords as convention-parser.
+ */
+function buildCoverageMap(rulesFiles, allRules) {
+    const coverageMap = new Map();
+    // Build per-file category sets from already-parsed rules
+    for (const r of allRules) {
+        if (r.source !== 'rules-file') {
+            continue;
+        }
+        const existing = coverageMap.get(r.category) ?? [];
+        if (!existing.includes(r.sourceFile)) {
+            existing.push(r.sourceFile);
+        }
+        coverageMap.set(r.category, existing);
+    }
+    // Ensure every rules file appears in the map even with no matches
+    for (const filePath of rulesFiles) {
+        for (const [, files] of coverageMap) {
+            if (!files.includes(filePath)) {
+                // already handled above; this loop is a no-op but makes intent clear
+            }
+        }
+    }
+    return coverageMap;
+}
+/**
+ * Find rules files whose content does NOT match any category still present
+ * in CLAUDE.md — meaning they may be stale.
+ *
+ * A file is "stale" when it has NO categories in common with CLAUDE.md categories.
+ */
+function detectStaleRules(rulesFiles, allRules, claudeCategories) {
+    // Build per-file category sets
+    const fileCategories = new Map();
+    for (const r of allRules) {
+        if (r.source !== 'rules-file') {
+            continue;
+        }
+        const cats = fileCategories.get(r.sourceFile) ?? new Set();
+        cats.add(r.category);
+        fileCategories.set(r.sourceFile, cats);
+    }
+    const stale = [];
+    for (const filePath of rulesFiles) {
+        const cats = fileCategories.get(filePath);
+        if (!cats || cats.size === 0) {
+            // No parseable conventions found — candidate for stale
+            stale.push(basename(filePath));
+            continue;
+        }
+        // Stale if none of its categories overlap with CLAUDE.md categories
+        const hasOverlap = [...cats].some((c) => claudeCategories.has(c));
+        if (!hasOverlap) {
+            stale.push(basename(filePath));
+        }
+    }
+    return stale;
+}
+/** Generate minimal markdown content for a new rules file covering a category. */
+function generateRuleFileContent(category, conventions) {
+    const relevant = conventions.filter((r) => r.source === 'claude-md' && r.category === category);
+    const lines = [
+        `# ${category.charAt(0).toUpperCase() + category.slice(1)} Conventions (auto-generated by reconcile_rules)`,
+        '',
+        `Rules for the **${category}** category extracted from CLAUDE.md.`,
+        '',
+        '## Conventions',
+        '',
+    ];
+    for (const r of relevant) {
+        const prefix = r.severity === 'critical'
+            ? '**[MANDATORY]**'
+            : r.severity === 'warning'
+                ? '**[SHOULD]**'
+                : '';
+        lines.push(`- ${prefix} ${r.description}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/** Write a new rules file to .claude/rules/ for the given category. */
+function writeNewRulesFile(projectPath, category, conventions) {
+    const rulesDir = join(projectPath, '.claude', 'rules');
+    mkdirSync(rulesDir, { recursive: true });
+    const fileName = `${category}.md`;
+    const filePath = join(rulesDir, fileName);
+    const content = generateRuleFileContent(category, conventions);
+    writeFileSync(filePath, content, 'utf-8');
+    return fileName;
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+/**
+ * Compare CLAUDE.md conventions against existing .claude/rules/ files.
+ * Auto-patches missing convention categories by generating new rules files.
+ * Never overwrites existing rules files.
+ *
+ * Never throws — returns a zero-score reconciliation on unexpected errors.
+ */
+export function reconcileRules(projectPath) {
+    try {
+        // 1. Parse all conventions (CLAUDE.md + rules files)
+        const allRules = parseConventions(projectPath);
+        const rulesFiles = listRulesFiles(projectPath);
+        // 2. Determine which categories are defined in CLAUDE.md
+        const claudeCategories = categoriesInClaudeMd(allRules);
+        if (claudeCategories.size === 0) {
+            return {
+                rulesInSync: rulesFiles.length === 0,
+                newRulesNeeded: [],
+                staleRules: rulesFiles.map((f) => basename(f)),
+                updatedRules: [],
+                healthScore: rulesFiles.length === 0 ? 100 : 0,
+            };
+        }
+        // 3. Build coverage map: which categories are covered by rules files
+        const coverageMap = buildCoverageMap(rulesFiles, allRules);
+        // 4. Find categories in CLAUDE.md with no rules file coverage
+        const newRulesNeeded = [];
+        for (const category of claudeCategories) {
+            const coveredBy = coverageMap.get(category) ?? [];
+            if (coveredBy.length === 0) {
+                newRulesNeeded.push(category);
+            }
+        }
+        // 5. Detect stale rules files
+        const staleRules = detectStaleRules(rulesFiles, allRules, claudeCategories);
+        // 6. Auto-patch: generate new rules files for uncovered categories
+        const updatedRules = [];
+        for (const category of newRulesNeeded) {
+            const fileName = writeNewRulesFile(projectPath, category, allRules);
+            updatedRules.push(fileName);
+        }
+        // 7. Calculate health score
+        const covered = claudeCategories.size - newRulesNeeded.length + updatedRules.length;
+        const healthScore = Math.round((covered / claudeCategories.size) * 100);
+        return {
+            rulesInSync: newRulesNeeded.length === 0 && staleRules.length === 0,
+            newRulesNeeded,
+            staleRules,
+            updatedRules,
+            healthScore,
+        };
+    }
+    catch {
+        return {
+            rulesInSync: false,
+            newRulesNeeded: [],
+            staleRules: [],
+            updatedRules: [],
+            healthScore: 0,
+        };
+    }
+}
+// Re-export for external use
+export { readFileSafe };
+//# sourceMappingURL=rules-reconciler.js.map

package/dist/engine/rules-reconciler.js.map

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

package/dist/engine/skill-generator/detect.d.ts

@@ -15,6 +15,7 @@ export declare function detectAgentPlatform(projectConventions: Record<string, s
 /**
  * Detect which AI agent platform is being used by scanning actual config files on disk.
  * More reliable than convention-based detection.
+ * Merges built-in platforms with any custom platforms defined in planu.json.
  */
 export declare function detectAgentPlatformFromFiles(projectPath: string): Promise<{
     platform: AgentPlatform;

package/dist/engine/skill-generator/detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-generator/detect.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMxF,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAa9D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBlF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgClF;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAsClF"}
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-generator/detect.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOxF,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAa9D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBlF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgClF;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6ClF"}

package/dist/engine/skill-generator/detect.js

@@ -1,6 +1,7 @@
 // Agent platform detection functions
 import { readFile, access } from 'node:fs/promises';
 import { join } from 'node:path';
+import { loadPlatforms as loadExtendedPlatforms } from '../platform-registry.js';
 // === Agent Platform Config ===
 let platformsCache = null;
 export async function loadPlatforms() {
@@ -75,16 +76,22 @@ export async function detectAgentPlatform(projectConventions) {
 /**
  * Detect which AI agent platform is being used by scanning actual config files on disk.
  * More reliable than convention-based detection.
+ * Merges built-in platforms with any custom platforms defined in planu.json.
  */
 export async function detectAgentPlatformFromFiles(projectPath) {
-    const platforms = await loadPlatforms();
+    // Use extended registry so custom platforms defined in planu.json are included
+    const allPlatforms = await loadExtendedPlatforms(projectPath);
     const detectedFrom = [];
     let bestPlatform = 'claude-code';
     let bestScore = 0;
-    for (const [key, config] of Object.entries(platforms.platforms)) {
+    for (const platformDef of allPlatforms) {
         let score = 0;
         const foundFiles = [];
-        const configFiles = config.configFiles ?? [config.rulesFile];
+        const configFiles = platformDef.configFiles.length > 0
+            ? platformDef.configFiles
+            : platformDef.rulesFile
+                ? [platformDef.rulesFile]
+                : [];
         for (const cfgFile of configFiles) {
             if (!cfgFile) {
                 continue;
@@ -100,11 +107,12 @@ export async function detectAgentPlatformFromFiles(projectPath) {
             }
         }
         if (foundFiles.length > 0) {
-            detectedFrom.push(...foundFiles.map((f) => `${key}: ${f}`));
+            detectedFrom.push(...foundFiles.map((f) => `${platformDef.id}: ${f}`));
         }
         if (score > bestScore) {
             bestScore = score;
-            bestPlatform = key;
+            // Custom platform ids fall back to 'custom' if not in the AgentPlatform union
+            bestPlatform = platformDef.id;
         }
     }
     const confidence = bestScore > 0 ? Math.min(1, bestScore / 6) : 0;

package/dist/engine/skill-generator/detect.js.map

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

package/dist/engine/skills/skills-fetcher.d.ts

@@ -0,0 +1,4 @@
+import type { ProjectKnowledge, RecommendedSkill } from '../../types/index.js';
+export declare function isMcpServer(knowledge: ProjectKnowledge): boolean;
+export declare function fetchRecommendedSkills(knowledge: ProjectKnowledge): Promise<RecommendedSkill[]>;
+//# sourceMappingURL=skills-fetcher.d.ts.map

package/dist/engine/skills/skills-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-fetcher.d.ts","sourceRoot":"","sources":["../../../src/engine/skills/skills-fetcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,wBAAgB,WAAW,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAQhE;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgC7B"}