@dotcontext/cli 0.8.0

package/dist/services/ai/tools/scaffoldPlanTool.js

@@ -0,0 +1,183 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffoldPlanTool = void 0;
+const ai_1 = require("ai");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const schemas_1 = require("../schemas");
+const planGenerator_1 = require("../../../generators/plans/planGenerator");
+const stack_1 = require("../../stack");
+exports.scaffoldPlanTool = (0, ai_1.tool)({
+    description: `Create a plan template in .context/plans/.
+When autoFill is true (default), returns semantic context and fill instructions.
+The AI agent MUST then fill the plan with specific implementation details.`,
+    inputSchema: schemas_1.ScaffoldPlanInputSchema,
+    execute: async (input) => {
+        const { planName, repoPath: customRepoPath, outputDir: customOutputDir, title, summary, semantic = true, autoFill = true, } = input;
+        if (!customRepoPath) {
+            throw new Error('repoPath is required for scaffoldPlan');
+        }
+        const repoPath = path.resolve(customRepoPath);
+        const outputDir = customOutputDir
+            ? path.resolve(customOutputDir)
+            : path.resolve(repoPath, '.context');
+        try {
+            // Detect project type for intelligent agent/doc filtering
+            const stackDetector = new stack_1.StackDetector();
+            const stackInfo = await stackDetector.detect(repoPath);
+            const classification = (0, stack_1.classifyProject)(stackInfo);
+            // Get filtered agents and docs based on project type
+            const filteredAgents = (0, stack_1.getAgentsForProjectType)(classification.primaryType);
+            const filteredDocs = (0, stack_1.getDocsForProjectType)(classification.primaryType);
+            const planGenerator = new planGenerator_1.PlanGenerator();
+            // When autoFill is true, enable semantic analysis for richer content
+            const enableSemantic = autoFill && semantic;
+            const result = await planGenerator.generatePlan({
+                planName,
+                outputDir,
+                title,
+                summary,
+                force: true, // MCP calls should always overwrite (non-interactive)
+                verbose: false,
+                semantic: enableSemantic,
+                projectPath: enableSemantic ? repoPath : undefined,
+                selectedAgentTypes: filteredAgents,
+                selectedDocKeys: filteredDocs,
+            });
+            // Read the generated content to return
+            const planContent = await fs.readFile(result.planPath, 'utf-8');
+            // Build fill instructions for the plan
+            const fillInstructions = autoFill ? buildPlanFillInstructions(planName, result.planPath, summary) : undefined;
+            // Build response with consistent status signals (matching initializeContextTool pattern)
+            const instruction = autoFill
+                ? `IMPORTANT ACTION REQUIRED: Plan template created but needs specific implementation details.
+
+You MUST fill in the plan with:
+1. Specific goals and scope for "${planName}"
+2. Detailed phases with concrete steps
+3. Agent assignments and focus areas
+4. Documentation touchpoints
+5. Success criteria
+
+Use context({ action: "fillSingle", filePath: "${result.planPath}" }) to get semantic context,
+then write the enhanced plan.
+
+DO NOT report completion until the plan has specific, actionable content.`
+                : 'The plan template has been created. You can customize it manually or use fillScaffolding to get suggested content.';
+            return {
+                // Action signals (appear first for visibility)
+                instruction,
+                _warning: autoFill ? 'INCOMPLETE - ACTION REQUIRED' : undefined,
+                // Status signals
+                status: autoFill ? 'incomplete' : 'success',
+                complete: !autoFill,
+                success: true,
+                // Plan details
+                planPath: result.planPath,
+                planContent,
+                // Classification
+                classification: {
+                    projectType: classification.primaryType,
+                    confidence: classification.confidence,
+                    reasoning: classification.reasoning,
+                },
+                // Fill instructions
+                fillInstructions,
+                // Next step guidance
+                nextStep: autoFill ? {
+                    action: 'Call fillSingle to get context, then write enhanced plan',
+                    example: `context({ action: "fillSingle", filePath: "${result.planPath}" })`,
+                } : undefined,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+});
+/**
+ * Build fill instructions for a plan file
+ */
+function buildPlanFillInstructions(planName, planPath, summary) {
+    const lines = [];
+    lines.push('# Plan Fill Instructions');
+    lines.push('');
+    lines.push(`A plan template has been created at: \`${planPath}\``);
+    lines.push('');
+    lines.push('You MUST now fill in the following sections with specific implementation details:');
+    lines.push('');
+    lines.push('## Required Sections to Fill');
+    lines.push('');
+    lines.push('### 1. Goal & Scope');
+    lines.push('- Define the specific objective of this plan');
+    lines.push('- List what is included and excluded from scope');
+    if (summary) {
+        lines.push(`- Initial summary provided: "${summary}"`);
+    }
+    lines.push('');
+    lines.push('### 2. Phases');
+    lines.push('- Break down the implementation into logical phases');
+    lines.push('- Each phase should have:');
+    lines.push('  - Clear objective');
+    lines.push('  - Specific steps with owners (agent types)');
+    lines.push('  - Deliverables and evidence of completion');
+    lines.push('  - Git commit checkpoint message');
+    lines.push('');
+    lines.push('### 3. Agent Lineup');
+    lines.push('- Assign specific agents to phases');
+    lines.push('- Define focus areas for each agent');
+    lines.push('');
+    lines.push('### 4. Documentation Touchpoints');
+    lines.push('- List which docs need to be updated');
+    lines.push('- Specify which sections and why');
+    lines.push('');
+    lines.push('### 5. Success Criteria');
+    lines.push('- Define measurable success criteria');
+    lines.push('- Include testing and validation requirements');
+    lines.push('');
+    lines.push('## Action Required');
+    lines.push('');
+    lines.push('1. Read the generated plan template');
+    lines.push('2. Fill in each section with specific, actionable content');
+    lines.push('3. Write the completed plan back to the file');
+    lines.push('');
+    lines.push('DO NOT leave placeholder text. Each section must have concrete, implementation-ready content.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=scaffoldPlanTool.js.map

package/dist/services/ai/tools/scaffoldPlanTool.js.map

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

package/dist/services/ai/tools/searchCodeTool.d.ts

@@ -0,0 +1,25 @@
+export declare const searchCodeTool: import("ai").Tool<{
+    pattern: string;
+    maxResults: number;
+    fileGlob?: string | undefined;
+}, {
+    success: boolean;
+    pattern: string;
+    matches: {
+        file: string;
+        line: number;
+        match: string;
+        context: string;
+    }[];
+    totalMatches: number;
+    truncated: boolean;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    pattern: string;
+    matches?: undefined;
+    totalMatches?: undefined;
+    truncated?: undefined;
+}>;
+//# sourceMappingURL=searchCodeTool.d.ts.map

package/dist/services/ai/tools/searchCodeTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCodeTool.d.ts","sourceRoot":"","sources":["../../../../src/services/ai/tools/searchCodeTool.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc;;;;;;;;cAab,MAAM;cACN,MAAM;eACL,MAAM;iBACJ,MAAM;;;;;;;;;;;;EA4CrB,CAAC"}

package/dist/services/ai/tools/searchCodeTool.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchCodeTool = void 0;
+const ai_1 = require("ai");
+const glob_1 = require("glob");
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const schemas_1 = require("../schemas");
+exports.searchCodeTool = (0, ai_1.tool)({
+    description: 'Search for code patterns across files in the repository',
+    inputSchema: schemas_1.SearchCodeInputSchema,
+    execute: async (input) => {
+        const { pattern, fileGlob, maxResults = 50 } = input;
+        try {
+            const files = await (0, glob_1.glob)(fileGlob || '**/*.{ts,tsx,js,jsx,py,go,rs,java}', {
+                ignore: ['node_modules/**', '.git/**', 'dist/**', 'build/**'],
+                absolute: true
+            });
+            const regex = new RegExp(pattern, 'gm');
+            const matches = [];
+            for (const file of files) {
+                if (matches.length >= maxResults)
+                    break;
+                try {
+                    const content = await fs.readFile(file, 'utf-8');
+                    const lines = content.split('\n');
+                    for (let i = 0; i < lines.length && matches.length < maxResults; i++) {
+                        if (regex.test(lines[i])) {
+                            matches.push({
+                                file: path.relative(process.cwd(), file),
+                                line: i + 1,
+                                match: lines[i].trim().slice(0, 200),
+                                context: lines
+                                    .slice(Math.max(0, i - 1), i + 2)
+                                    .join('\n')
+                                    .slice(0, 500)
+                            });
+                        }
+                        regex.lastIndex = 0; // Reset regex state
+                    }
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+            return {
+                success: true,
+                pattern,
+                matches,
+                totalMatches: matches.length,
+                truncated: matches.length >= maxResults
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                pattern
+            };
+        }
+    }
+});
+//# sourceMappingURL=searchCodeTool.js.map

package/dist/services/ai/tools/searchCodeTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCodeTool.js","sourceRoot":"","sources":["../../../../src/services/ai/tools/searchCodeTool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2BAA0B;AAC1B,+BAA4B;AAC5B,6CAA+B;AAC/B,2CAA6B;AAC7B,wCAAyE;AAE5D,QAAA,cAAc,GAAG,IAAA,SAAI,EAAC;IACjC,WAAW,EAAE,yDAAyD;IACtE,WAAW,EAAE,+BAAqB;IAClC,OAAO,EAAE,KAAK,EAAE,KAAsB,EAAE,EAAE;QACxC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAA,WAAI,EAAC,QAAQ,IAAI,oCAAoC,EAAE;gBACzE,MAAM,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;gBAC7D,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACxC,MAAM,OAAO,GAKR,EAAE,CAAC;YAER,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;oBAAE,MAAM;gBAExC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;oBACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;wBACrE,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;4BACzB,OAAO,CAAC,IAAI,CAAC;gCACX,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC;gCACxC,IAAI,EAAE,CAAC,GAAG,CAAC;gCACX,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gCACpC,OAAO,EAAE,KAAK;qCACX,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;qCAChC,IAAI,CAAC,IAAI,CAAC;qCACV,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;6BACjB,CAAC,CAAC;wBACL,CAAC;wBACD,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,oBAAoB;oBAC3C,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO;gBACP,OAAO;gBACP,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,SAAS,EAAE,OAAO,CAAC,MAAM,IAAI,UAAU;aACxC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,OAAO;aACR,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/services/autoFill/autoFillService.d.ts

@@ -0,0 +1,52 @@
+/**
+ * AutoFillService - Generates documentation content from semantic analysis
+ *
+ * This service fills scaffold templates with actual codebase data without
+ * requiring an LLM API key. It maps semantic analysis results to scaffold
+ * sections, providing useful starter content based on code structure.
+ */
+import { SemanticContext } from '../semantic/types';
+import { StackInfo } from '../stack/stackDetector';
+import { ScaffoldStructure } from '../../generators/shared/structures/types';
+export interface AutoFillContext {
+    semantics?: SemanticContext;
+    stackInfo?: StackInfo;
+    repoPath: string;
+    topLevelDirectories?: string[];
+}
+export declare class AutoFillService {
+    /**
+     * Fill a documentation scaffold with semantic data
+     */
+    fillDocumentation(docName: string, structure: ScaffoldStructure, ctx: AutoFillContext): string;
+    /**
+     * Fill an agent playbook scaffold with semantic data
+     */
+    fillAgent(agentType: string, structure: ScaffoldStructure, ctx: AutoFillContext): string;
+    private fillSection;
+    private fillAgentSection;
+    private generateDocContent;
+    private generateAgentContent;
+    private fillProjectOverviewSection;
+    private fillArchitectureSection;
+    private fillToolingSection;
+    private generateProjectOverview;
+    private generateQuickFacts;
+    private formatEntryPoints;
+    private formatPublicAPI;
+    private formatPublicAPITable;
+    private formatDirectoryStructure;
+    private formatTechStack;
+    private formatFrameworks;
+    private formatBuildTools;
+    private formatTestFrameworks;
+    private formatPackageManager;
+    private formatLayers;
+    private formatPatterns;
+    private generateGettingStarted;
+    private generateKeyFilesForAgent;
+    private generateRelevantSymbolsForAgent;
+    private getFilePatternForAgent;
+    private getRelevantSymbolsForAgent;
+}
+//# sourceMappingURL=autoFillService.d.ts.map

package/dist/services/autoFill/autoFillService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoFillService.d.ts","sourceRoot":"","sources":["../../../src/services/autoFill/autoFillService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAuD,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAmB,MAAM,0CAA0C,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAOD,qBAAa,eAAe;IAC1B;;OAEG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,eAAe,GACnB,MAAM;IAoBT;;OAEG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,eAAe,GACnB,MAAM;IAWT,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,0BAA0B;IAsClC,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,sBAAsB;IA6C9B,OAAO,CAAC,wBAAwB;IA6BhC,OAAO,CAAC,+BAA+B;IAmBvC,OAAO,CAAC,sBAAsB;IAgC9B,OAAO,CAAC,0BAA0B;CA4DnC"}