@ai-coders/context 0.6.0 → 0.6.1

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

@@ -5,6 +5,7 @@ export declare const scaffoldPlanTool: import("ai").Tool<{
     title?: string | undefined;
     summary?: string | undefined;
     semantic?: boolean | undefined;
+    autoFill?: boolean | undefined;
 }, {
     success: boolean;
     planPath: string;
@@ -14,6 +15,8 @@ export declare const scaffoldPlanTool: import("ai").Tool<{
         confidence: "high" | "medium" | "low";
         reasoning: string[];
     };
+    fillInstructions: string | undefined;
+    instructions: string;
     error?: undefined;
 } | {
     success: boolean;
@@ -21,5 +24,7 @@ export declare const scaffoldPlanTool: import("ai").Tool<{
     planPath?: undefined;
     planContent?: undefined;
     classification?: undefined;
+    fillInstructions?: undefined;
+    instructions?: undefined;
 }>;
 //# sourceMappingURL=scaffoldPlanTool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scaffoldPlanTool.d.ts","sourceRoot":"","sources":["../../../../src/services/ai/tools/scaffoldPlanTool.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;EA+D3B,CAAC"}
+{"version":3,"file":"scaffoldPlanTool.d.ts","sourceRoot":"","sources":["../../../../src/services/ai/tools/scaffoldPlanTool.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4E3B,CAAC"}

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

@@ -41,10 +41,12 @@ 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/',
+    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 } = input;
+        const { planName, repoPath: customRepoPath, outputDir: customOutputDir, title, summary, semantic = true, autoFill = true, } = input;
         const repoPath = customRepoPath ? path.resolve(customRepoPath) : process.cwd();
         const outputDir = customOutputDir
             ? path.resolve(customOutputDir)
@@ -58,6 +60,8 @@ exports.scaffoldPlanTool = (0, ai_1.tool)({
             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,
@@ -65,13 +69,15 @@ exports.scaffoldPlanTool = (0, ai_1.tool)({
                 summary,
                 force: true, // MCP calls should always overwrite (non-interactive)
                 verbose: false,
-                semantic,
-                projectPath: semantic ? repoPath : undefined,
+                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;
             return {
                 success: true,
                 planPath: result.planPath,
@@ -81,6 +87,10 @@ exports.scaffoldPlanTool = (0, ai_1.tool)({
                     confidence: classification.confidence,
                     reasoning: classification.reasoning,
                 },
+                fillInstructions,
+                instructions: autoFill
+                    ? 'IMPORTANT: Review the generated plan and fill in the specific implementation details. The plan template has been created with codebase context - you must now customize it with the actual tasks, phases, and deliverables for this feature/project.'
+                    : 'The plan template has been created. You can customize it manually or use fillScaffolding to get suggested content.',
             };
         }
         catch (error) {
@@ -91,4 +101,53 @@ exports.scaffoldPlanTool = (0, ai_1.tool)({
         }
     }
 });
+/**
+ * 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

@@ -1 +1 @@
-{"version":3,"file":"scaffoldPlanTool.js","sourceRoot":"","sources":["../../../../src/services/ai/tools/scaffoldPlanTool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2BAA0B;AAC1B,2CAA6B;AAC7B,6CAA+B;AAC/B,wCAA6E;AAC7E,2EAAwE;AACxE,uCAKqB;AAER,QAAA,gBAAgB,GAAG,IAAA,SAAI,EAAC;IACnC,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE,iCAAuB;IACpC,OAAO,EAAE,KAAK,EAAE,KAAwB,EAAE,EAAE;QAC1C,MAAM,EACJ,QAAQ,EACR,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,eAAe,EAC1B,KAAK,EACL,OAAO,EACP,QAAQ,GAAG,IAAI,EAChB,GAAG,KAAK,CAAC;QAEV,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/E,MAAM,SAAS,GAAG,eAAe;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,0DAA0D;YAC1D,MAAM,aAAa,GAAG,IAAI,qBAAa,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvD,MAAM,cAAc,GAAG,IAAA,uBAAe,EAAC,SAAS,CAAC,CAAC;YAElD,qDAAqD;YACrD,MAAM,cAAc,GAAG,IAAA,+BAAuB,EAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAC3E,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAEvE,MAAM,aAAa,GAAG,IAAI,6BAAa,EAAE,CAAC;YAE1C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC;gBAC9C,QAAQ;gBACR,SAAS;gBACT,KAAK;gBACL,OAAO;gBACP,KAAK,EAAE,IAAI,EAAE,sDAAsD;gBACnE,OAAO,EAAE,KAAK;gBACd,QAAQ;gBACR,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAC5C,kBAAkB,EAAE,cAAc;gBAClC,eAAe,EAAE,YAAY;aAC9B,CAAC,CAAC;YAEH,uCAAuC;YACvC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEhE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW;gBACX,cAAc,EAAE;oBACd,WAAW,EAAE,cAAc,CAAC,WAAW;oBACvC,UAAU,EAAE,cAAc,CAAC,UAAU;oBACrC,SAAS,EAAE,cAAc,CAAC,SAAS;iBACpC;aACF,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;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"scaffoldPlanTool.js","sourceRoot":"","sources":["../../../../src/services/ai/tools/scaffoldPlanTool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2BAA0B;AAC1B,2CAA6B;AAC7B,6CAA+B;AAC/B,wCAA6E;AAC7E,2EAAwE;AACxE,uCAKqB;AAER,QAAA,gBAAgB,GAAG,IAAA,SAAI,EAAC;IACnC,WAAW,EAAE;;2EAE4D;IACzE,WAAW,EAAE,iCAAuB;IACpC,OAAO,EAAE,KAAK,EAAE,KAAwB,EAAE,EAAE;QAC1C,MAAM,EACJ,QAAQ,EACR,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,eAAe,EAC1B,KAAK,EACL,OAAO,EACP,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,GAChB,GAAG,KAAK,CAAC;QAEV,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/E,MAAM,SAAS,GAAG,eAAe;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,0DAA0D;YAC1D,MAAM,aAAa,GAAG,IAAI,qBAAa,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvD,MAAM,cAAc,GAAG,IAAA,uBAAe,EAAC,SAAS,CAAC,CAAC;YAElD,qDAAqD;YACrD,MAAM,cAAc,GAAG,IAAA,+BAAuB,EAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAC3E,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAEvE,MAAM,aAAa,GAAG,IAAI,6BAAa,EAAE,CAAC;YAE1C,qEAAqE;YACrE,MAAM,cAAc,GAAG,QAAQ,IAAI,QAAQ,CAAC;YAE5C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC;gBAC9C,QAAQ;gBACR,SAAS;gBACT,KAAK;gBACL,OAAO;gBACP,KAAK,EAAE,IAAI,EAAE,sDAAsD;gBACnE,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,cAAc;gBACxB,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAClD,kBAAkB,EAAE,cAAc;gBAClC,eAAe,EAAE,YAAY;aAC9B,CAAC,CAAC;YAEH,uCAAuC;YACvC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEhE,uCAAuC;YACvC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE9G,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW;gBACX,cAAc,EAAE;oBACd,WAAW,EAAE,cAAc,CAAC,WAAW;oBACvC,UAAU,EAAE,cAAc,CAAC,UAAU;oBACrC,SAAS,EAAE,cAAc,CAAC,SAAS;iBACpC;gBACD,gBAAgB;gBAChB,YAAY,EAAE,QAAQ;oBACpB,CAAC,CAAC,sPAAsP;oBACxP,CAAC,CAAC,oHAAoH;aACzH,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;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,yBAAyB,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAgB;IACrF,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,0CAA0C,QAAQ,IAAI,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;IAChG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC9D,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,gCAAgC,OAAO,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+FAA+F,CAAC,CAAC;IAE5G,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/services/mcp/mcpServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/mcpServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+CH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAqC;gBAE1C,OAAO,GAAE,gBAAqB;IAkB1C;;OAEG;IACH,OAAO,CAAC,aAAa;IAiYrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmU7B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA0NrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwUzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiFzB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA4DjC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAwNlC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8T1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIhG"}
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/mcpServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiDH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAqC;gBAE1C,OAAO,GAAE,gBAAqB;IAkB1C;;OAEG;IACH,OAAO,CAAC,aAAa;IAuYrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8U7B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA0NrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwUzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiFzB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA4DjC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAwNlC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqW1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AA0ID;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIhG"}

package/dist/services/mcp/mcpServer.js

@@ -4,12 +4,46 @@
  *
  * Exposes code analysis tools and semantic context as MCP resources.
  */
+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.AIContextMCPServer = void 0;
 exports.startMCPServer = startMCPServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const zod_1 = require("zod");
+const path = __importStar(require("path"));
 const tools_1 = require("../ai/tools");
 const toolRegistry_1 = require("../ai/toolRegistry");
 const contextBuilder_1 = require("../semantic/contextBuilder");
@@ -212,16 +246,19 @@ class AIContextMCPServer {
                 semantic: zod_1.z.boolean().default(true).optional()
                     .describe('Enable semantic analysis for richer templates'),
                 include: zod_1.z.array(zod_1.z.string()).optional().describe('Include patterns'),
-                exclude: zod_1.z.array(zod_1.z.string()).optional().describe('Exclude patterns')
+                exclude: zod_1.z.array(zod_1.z.string()).optional().describe('Exclude patterns'),
+                autoFill: zod_1.z.boolean().default(true).optional()
+                    .describe('Automatically fill scaffolding with codebase-aware content (default: true)')
             }
-        }, async ({ repoPath, type, outputDir, semantic, include, exclude }) => {
+        }, async ({ repoPath, type, outputDir, semantic, include, exclude, autoFill }) => {
             const result = await tools_1.initializeContextTool.execute({
                 repoPath: repoPath || this.options.repoPath || process.cwd(),
                 type,
                 outputDir,
                 semantic,
                 include,
-                exclude
+                exclude,
+                autoFill
             }, { toolCallId: '', messages: [] });
             return {
                 content: [{
@@ -239,16 +276,19 @@ class AIContextMCPServer {
                 outputDir: zod_1.z.string().optional().describe('Output directory'),
                 title: zod_1.z.string().optional().describe('Plan title (defaults to formatted planName)'),
                 summary: zod_1.z.string().optional().describe('Plan summary/goal'),
-                semantic: zod_1.z.boolean().default(true).optional().describe('Enable semantic analysis')
+                semantic: zod_1.z.boolean().default(true).optional().describe('Enable semantic analysis'),
+                autoFill: zod_1.z.boolean().default(true).optional()
+                    .describe('Automatically fill plan with codebase-aware content (default: true)')
             }
-        }, async ({ planName, repoPath, outputDir, title, summary, semantic }) => {
+        }, async ({ planName, repoPath, outputDir, title, summary, semantic, autoFill }) => {
             const result = await tools_1.scaffoldPlanTool.execute({
                 planName,
                 repoPath: repoPath || this.options.repoPath || process.cwd(),
                 outputDir,
                 title,
                 summary,
-                semantic
+                semantic,
+                autoFill
             }, { toolCallId: '', messages: [] });
             return {
                 content: [{
@@ -378,12 +418,16 @@ class AIContextMCPServer {
             }
         }, async ({ name, description, scale }) => {
             try {
-                const service = new workflow_1.WorkflowService(repoPath);
+                const resolvedRepoPath = path.resolve(repoPath);
+                const service = new workflow_1.WorkflowService(resolvedRepoPath);
                 const status = await service.init({
                     name,
                     description,
                     scale: scale,
                 });
+                // Include file paths for visibility
+                const contextPath = path.join(resolvedRepoPath, '.context');
+                const statusFilePath = path.join(contextPath, 'workflow', 'status.yaml');
                 return {
                     content: [{
                             type: 'text',
@@ -393,6 +437,8 @@ class AIContextMCPServer {
                                 scale: (0, workflow_2.getScaleName)(status.project.scale),
                                 currentPhase: status.project.current_phase,
                                 phases: Object.keys(status.phases).filter((p) => status.phases[p].status !== 'skipped'),
+                                statusFilePath,
+                                contextPath,
                             }, null, 2)
                         }]
                 };
@@ -415,20 +461,23 @@ class AIContextMCPServer {
             inputSchema: {}
         }, async () => {
             try {
-                const service = new workflow_1.WorkflowService(repoPath);
+                const resolvedRepoPath = path.resolve(repoPath);
+                const service = new workflow_1.WorkflowService(resolvedRepoPath);
                 if (!(await service.hasWorkflow())) {
                     return {
                         content: [{
                                 type: 'text',
                                 text: JSON.stringify({
                                     success: false,
-                                    error: 'No workflow found. Run workflowInit first.'
+                                    error: 'No workflow found. Run workflowInit first.',
+                                    statusFilePath: path.join(resolvedRepoPath, '.context', 'workflow', 'status.yaml')
                                 }, null, 2)
                             }]
                     };
                 }
                 const summary = await service.getSummary();
                 const status = await service.getStatus();
+                const statusFilePath = path.join(resolvedRepoPath, '.context', 'workflow', 'status.yaml');
                 return {
                     content: [{
                             type: 'text',
@@ -444,6 +493,7 @@ class AIContextMCPServer {
                                 isComplete: summary.isComplete,
                                 phases: status.phases,
                                 roles: status.roles,
+                                statusFilePath,
                             }, null, 2)
                         }]
                 };
@@ -1755,57 +1805,92 @@ class AIContextMCPServer {
                 };
             }
         });
-        // fillSkills - Fill/personalize skill files with AI
+        // fillSkills - Return fill instructions for skill files (NO API key required)
         this.server.registerTool('fillSkills', {
-            description: 'Fill/personalize skill files using AI analysis of the codebase. Reads docs and agents for context.',
+            description: `Fill/personalize skill files with codebase-aware content.
+Returns semantic context and fill instructions for the AI agent to process.
+The AI agent MUST then fill each skill file using the provided context and instructions.`,
             inputSchema: {
                 skills: zod_1.z.array(zod_1.z.string()).optional().describe('Specific skills to fill (default: all scaffolded)'),
-                force: zod_1.z.boolean().optional().describe('Overwrite existing content'),
-                useSemanticContext: zod_1.z.boolean().default(true).optional().describe('Use semantic context mode (more token efficient)'),
-                useLsp: zod_1.z.boolean().optional().describe('Enable LSP for deeper analysis'),
+                force: zod_1.z.boolean().optional().describe('Include already-filled skills'),
             }
-        }, async ({ skills, force, useSemanticContext, useLsp }) => {
+        }, async ({ skills, force }) => {
             try {
-                const { SkillFillService } = require('../fill/skillFillService');
-                const skillFillService = new SkillFillService({
-                    ui: {
-                        displayWelcome: () => { },
-                        displayProjectInfo: () => { },
-                        displayStep: () => { },
-                        displaySuccess: () => { },
-                        displayError: () => { },
-                        displayWarning: () => { },
-                        displayInfo: () => { },
-                        startSpinner: () => { },
-                        stopSpinner: () => { },
-                        updateSpinner: () => { },
-                        createAgentCallbacks: () => ({
-                            onAgentStart: () => { },
-                            onAgentStep: () => { },
-                            onAgentComplete: () => { },
-                            onToolCall: () => { },
-                            onToolResult: () => { },
-                        }),
-                    },
-                    t: (key) => key,
-                    version: version_1.VERSION,
-                    defaultModel: DEFAULT_MODEL,
-                });
-                const result = await skillFillService.run(repoPath, {
-                    skills,
-                    force,
-                    semantic: useSemanticContext ?? true,
-                    useLsp,
-                });
+                const fs = require('fs-extra');
+                const registry = createSkillRegistry(repoPath);
+                const skillsDir = path.join(repoPath, '.context', 'skills');
+                // Check if skills directory exists
+                if (!await fs.pathExists(skillsDir)) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: 'Skills directory does not exist. Run scaffoldSkills first.',
+                                    skillsDir,
+                                }, null, 2)
+                            }]
+                    };
+                }
+                // Discover skills to fill
+                const discovered = await registry.discoverAll();
+                let skillsToFill = discovered.all;
+                // Filter by specific skills if provided
+                if (skills && skills.length > 0) {
+                    skillsToFill = skillsToFill.filter((s) => skills.includes(s.slug));
+                }
+                // Filter out already-filled skills unless force is set
+                if (!force) {
+                    skillsToFill = skillsToFill.filter((s) => {
+                        // Check if skill file exists and has minimal content (likely a template)
+                        if (!fs.existsSync(s.path))
+                            return true;
+                        const content = fs.readFileSync(s.path, 'utf-8');
+                        // Consider it unfilled if it's a template (has placeholder markers)
+                        return content.includes('<!-- TODO') || content.includes('[PLACEHOLDER]') || content.length < 500;
+                    });
+                }
+                if (skillsToFill.length === 0) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: true,
+                                    message: 'No skills need filling. Use force=true to refill existing skills.',
+                                    skillsDir,
+                                }, null, 2)
+                            }]
+                    };
+                }
+                // Build semantic context
+                let semanticContext;
+                try {
+                    semanticContext = await (0, tools_1.getOrBuildContext)(repoPath);
+                }
+                catch (contextError) {
+                    // Continue without semantic context
+                    semanticContext = undefined;
+                }
+                // Build fill instructions for each skill
+                const fillInstructions = skillsToFill.map((skill) => ({
+                    skillPath: skill.path,
+                    skillSlug: skill.slug,
+                    skillName: skill.metadata.name || skill.slug,
+                    description: skill.metadata.description || '',
+                    isBuiltIn: skill.isBuiltIn,
+                    instructions: getSkillFillInstructions(skill.slug),
+                }));
+                // Build comprehensive fill prompt
+                const fillPrompt = buildSkillFillPrompt(fillInstructions, semanticContext);
                 return {
                     content: [{
                             type: 'text',
                             text: JSON.stringify({
                                 success: true,
-                                filled: result.filled,
-                                skipped: result.skipped,
-                                failed: result.failed,
-                                model: result.model,
+                                skillsToFill: fillInstructions,
+                                semanticContext,
+                                fillPrompt,
+                                instructions: 'IMPORTANT: You MUST now fill each skill file using the semantic context and fill instructions provided. Write the content to each skillPath.',
                             }, null, 2)
                         }]
                 };
@@ -1850,6 +1935,115 @@ class AIContextMCPServer {
     }
 }
 exports.AIContextMCPServer = AIContextMCPServer;
+/**
+ * Get fill instructions for a skill based on its type
+ */
+function getSkillFillInstructions(skillSlug) {
+    const instructions = {
+        'commit-message': `Fill this skill with:
+- Commit message format conventions for this project
+- Examples of good commit messages from the codebase
+- Branch naming conventions if applicable
+- Semantic versioning guidelines`,
+        'pr-review': `Fill this skill with:
+- PR review checklist specific to this codebase
+- Code quality standards to check
+- Testing requirements before merge
+- Documentation expectations`,
+        'code-review': `Fill this skill with:
+- Code review guidelines for this project
+- Common patterns to look for
+- Security and performance considerations
+- Style and convention checks`,
+        'test-generation': `Fill this skill with:
+- Testing framework and conventions used
+- Test file organization patterns
+- Mocking strategies for this codebase
+- Coverage requirements`,
+        'documentation': `Fill this skill with:
+- Documentation standards for this project
+- JSDoc/TSDoc conventions
+- README structure expectations
+- API documentation guidelines`,
+        'refactoring': `Fill this skill with:
+- Refactoring patterns common in this codebase
+- Code smell detection guidelines
+- Safe refactoring procedures
+- Testing requirements after refactoring`,
+        'bug-investigation': `Fill this skill with:
+- Debugging workflow for this codebase
+- Common bug patterns and their fixes
+- Logging and error handling conventions
+- Test verification steps`,
+        'feature-breakdown': `Fill this skill with:
+- Feature decomposition approach
+- Task estimation guidelines
+- Dependency identification process
+- Integration points to consider`,
+        'api-design': `Fill this skill with:
+- API design patterns used in this project
+- Endpoint naming conventions
+- Request/response format standards
+- Versioning and deprecation policies`,
+        'security-audit': `Fill this skill with:
+- Security checklist for this codebase
+- Common vulnerabilities to check
+- Authentication/authorization patterns
+- Data validation requirements`,
+    };
+    return instructions[skillSlug] || `Fill this skill with project-specific content for ${skillSlug}:
+- Identify relevant patterns from the codebase
+- Include specific examples from the project
+- Add conventions and best practices
+- Reference important files and components`;
+}
+/**
+ * Build comprehensive fill prompt for skills
+ */
+function buildSkillFillPrompt(skills, semanticContext) {
+    const lines = [];
+    lines.push('# Skill Fill Instructions');
+    lines.push('');
+    lines.push('You MUST fill each of the following skill files with codebase-specific content.');
+    lines.push('');
+    if (semanticContext) {
+        lines.push('## Codebase Context');
+        lines.push('');
+        lines.push('Use this semantic context to understand the codebase:');
+        lines.push('');
+        lines.push('```');
+        lines.push(semanticContext.length > 6000 ? semanticContext.substring(0, 6000) + '\n...(truncated)' : semanticContext);
+        lines.push('```');
+        lines.push('');
+    }
+    lines.push('## Skills to Fill');
+    lines.push('');
+    for (const skill of skills) {
+        lines.push(`### ${skill.skillName} (${skill.skillSlug})`);
+        lines.push(`**Path:** \`${skill.skillPath}\``);
+        if (skill.description) {
+            lines.push(`**Description:** ${skill.description}`);
+        }
+        lines.push('');
+        lines.push('**Fill Instructions:**');
+        lines.push(skill.instructions);
+        lines.push('');
+    }
+    lines.push('## Action Required');
+    lines.push('');
+    lines.push('For each skill listed above:');
+    lines.push('1. Read the current skill template');
+    lines.push('2. Generate codebase-specific content based on the instructions and context');
+    lines.push('3. Write the filled content to the skill file');
+    lines.push('');
+    lines.push('Each skill should be personalized with:');
+    lines.push('- Specific examples from this codebase');
+    lines.push('- Project-specific conventions and patterns');
+    lines.push('- References to relevant files and components');
+    lines.push('');
+    lines.push('DO NOT leave placeholder text. Each skill must have meaningful, project-specific content.');
+    return lines.join('\n');
+}
 /**
  * Create and start an MCP server
  */