@ai-coders/context 0.6.0 → 0.7.0

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

@@ -41,16 +41,18 @@ const schemas_1 = require("../schemas");
 const fileMapper_1 = require("../../../utils/fileMapper");
 const documentationGenerator_1 = require("../../../generators/documentation/documentationGenerator");
 const agentGenerator_1 = require("../../../generators/agents/agentGenerator");
+const skillGenerator_1 = require("../../../generators/skills/skillGenerator");
 const stack_1 = require("../../stack");
+const defaults_1 = require("../../../prompts/defaults");
+const qa_1 = require("../../qa");
 exports.initializeContextTool = (0, ai_1.tool)({
     description: `Initialize .context scaffolding and create template files.
-IMPORTANT: After scaffolding, you MUST fill the generated files with actual content by:
-1. Use buildSemanticContext to understand the codebase
-2. Read each generated template file
-3. Write filled content to each file based on the codebase analysis`,
+When autoFill is true (default), returns semantic context and detailed fill instructions for each file.
+The AI agent MUST then fill each generated file using the provided context and instructions.`,
     inputSchema: schemas_1.InitializeContextInputSchema,
     execute: async (input) => {
-        const { repoPath, type = 'both', outputDir: customOutputDir, semantic = true, include, exclude = [], projectType: overrideProjectType, disableFiltering = false, } = input;
+        const { repoPath, type = 'both', outputDir: customOutputDir, semantic = true, include, exclude = [], projectType: overrideProjectType, disableFiltering = false, autoFill = true, skipContentGeneration = true, // Default true to reduce response size
+        generateQA = true, generateSkills = true, } = input;
         const resolvedRepoPath = path.resolve(repoPath);
         const outputDir = customOutputDir
             ? path.resolve(customOutputDir)
@@ -61,7 +63,7 @@ IMPORTANT: After scaffolding, you MUST fill the generated files with actual cont
             // Validate repo path exists
             if (!await fs.pathExists(resolvedRepoPath)) {
                 return {
-                    success: false,
+                    status: 'error',
                     outputDir,
                     error: `Repository path does not exist: ${resolvedRepoPath}`
                 };
@@ -109,43 +111,306 @@ IMPORTANT: After scaffolding, you MUST fill the generated files with actual cont
                 agentsGenerated = await agentGenerator.generateAgentPrompts(repoStructure, outputDir, { semantic, filteredAgents }, false // verbose
                 );
             }
-            // Build list of generated files for the agent to fill
+            // Generate skills scaffolding
+            let skillsGenerated = 0;
+            if (generateSkills) {
+                try {
+                    const skillGenerator = new skillGenerator_1.SkillGenerator({
+                        repoPath: resolvedRepoPath,
+                        outputDir: path.relative(resolvedRepoPath, outputDir),
+                    });
+                    const skillResult = await skillGenerator.generate({ force: false });
+                    skillsGenerated = skillResult.generatedSkills.length;
+                }
+                catch {
+                    // Skills generation is optional, continue if it fails
+                }
+            }
+            // Generate Q&A files
+            let qaGenerated = 0;
+            if (generateQA) {
+                try {
+                    const qaService = new qa_1.QAService();
+                    const qaResult = await qaService.generateFromCodebase(resolvedRepoPath);
+                    qaGenerated = qaResult.generated.length;
+                    await qaService.shutdown();
+                }
+                catch {
+                    // Q&A generation is optional, continue if it fails
+                }
+            }
             const generatedFiles = [];
             if (scaffoldDocs) {
                 const docsDir = path.join(outputDir, 'docs');
                 const docFiles = await fs.readdir(docsDir);
-                generatedFiles.push(...docFiles.map(f => path.join(docsDir, f)));
+                for (const f of docFiles.filter(f => f.endsWith('.md') && f.toLowerCase() !== 'readme.md')) {
+                    generatedFiles.push({
+                        path: path.join(docsDir, f),
+                        relativePath: `docs/${f}`,
+                        type: 'doc',
+                        fillInstructions: getDocFillInstructions(f),
+                    });
+                }
             }
             if (scaffoldAgents) {
                 const agentsDir = path.join(outputDir, 'agents');
                 const agentFiles = await fs.readdir(agentsDir);
-                generatedFiles.push(...agentFiles.map(f => path.join(agentsDir, f)));
+                for (const f of agentFiles.filter(f => f.endsWith('.md') && f.toLowerCase() !== 'readme.md')) {
+                    const agentType = path.basename(f, '.md');
+                    generatedFiles.push({
+                        path: path.join(agentsDir, f),
+                        relativePath: `agents/${f}`,
+                        type: 'agent',
+                        fillInstructions: getAgentFillInstructions(agentType),
+                    });
+                }
+            }
+            // Build requiredActions - always return lightweight info, LLM will use fillSingleFile for context
+            const requiredActions = [];
+            if (autoFill && generatedFiles.length > 0) {
+                for (let i = 0; i < generatedFiles.length; i++) {
+                    const file = generatedFiles[i];
+                    requiredActions.push({
+                        order: i + 1,
+                        actionType: 'WRITE_FILE',
+                        filePath: file.path,
+                        fileType: file.type,
+                        instructions: file.fillInstructions,
+                        status: 'pending',
+                    });
+                }
+            }
+            // When skipContentGeneration is true, return response with clear incomplete signal
+            if (skipContentGeneration) {
+                const hasFilesToFill = generatedFiles.length > 0;
+                // Build pendingWrites array (lightweight, without content)
+                const pendingWrites = generatedFiles.map((f, i) => ({
+                    order: i + 1,
+                    actionType: 'WRITE_FILE',
+                    filePath: f.path,
+                    fileType: f.type,
+                    instructions: f.fillInstructions,
+                    status: 'pending',
+                }));
+                // Build human-readable checklist
+                const checklist = generatedFiles.map(f => `[ ] Fill ${f.relativePath}`);
+                // Build instruction message
+                const instruction = hasFilesToFill
+                    ? `IMPORTANT ACTION REQUIRED: Scaffolding created but ${generatedFiles.length} files need content.
+
+You MUST fill each file with appropriate content based on the codebase.
+
+DO THIS NOW:
+${generatedFiles.slice(0, 5).map((f, i) => `${i + 1}. Read and fill: ${f.relativePath}`).join('\n')}${generatedFiles.length > 5 ? `\n... and ${generatedFiles.length - 5} more files` : ''}
+
+Use fillSingleFile tool for each file to get AI-generated content suggestions.
+After getting suggestions, write the content using the Write tool.
+
+DO NOT say "initialization complete" until ALL files are filled.`
+                    : undefined;
+                return {
+                    // Immediate action signals (appear first in JSON)
+                    instruction,
+                    _warning: hasFilesToFill ? 'INCOMPLETE - ACTION REQUIRED' : undefined,
+                    // Status signals
+                    status: hasFilesToFill ? 'incomplete' : 'success',
+                    complete: !hasFilesToFill,
+                    operationType: 'scaffold_only',
+                    // Fill instructions (the standard prompt for HOW to fill)
+                    fillInstructions: hasFilesToFill ? defaults_1.UPDATE_SCAFFOLD_PROMPT_FALLBACK : undefined,
+                    // Pending writes (files that need content)
+                    pendingWrites: hasFilesToFill ? pendingWrites : undefined,
+                    // Human-readable checklist
+                    checklist: hasFilesToFill ? checklist : undefined,
+                    // Next step guidance
+                    nextStep: hasFilesToFill ? {
+                        action: 'Call fillSingleFile for each file to get content, then Write to save',
+                        example: `fillSingleFile({ repoPath: "${resolvedRepoPath}", filePath: "${pendingWrites[0]?.filePath || ''}" })`,
+                    } : undefined,
+                    // Metadata
+                    _metadata: {
+                        docsGenerated,
+                        agentsGenerated,
+                        skillsGenerated,
+                        qaGenerated,
+                        outputDir,
+                        classification: classification ? {
+                            projectType: classification.primaryType,
+                            confidence: classification.confidence,
+                            reasoning: classification.reasoning,
+                        } : undefined,
+                    },
+                    // Legacy fields for backwards compatibility
+                    docsGenerated,
+                    agentsGenerated,
+                    skillsGenerated,
+                    qaGenerated,
+                    outputDir,
+                    classification: classification ? {
+                        projectType: classification.primaryType,
+                        confidence: classification.confidence,
+                        reasoning: classification.reasoning,
+                    } : undefined,
+                };
             }
+            // Full response (when skipContentGeneration is false - still directs to fillSingleFile)
+            const hasActionsRequired = requiredActions.length > 0;
+            // Build human-readable checklist
+            const checklist = requiredActions.map(a => `[ ] Fill ${a.filePath}`);
+            // Build instruction message
+            const instruction = hasActionsRequired
+                ? `IMPORTANT ACTION REQUIRED: Scaffolding created with ${requiredActions.length} files that need content.
+
+You MUST fill each file with appropriate content based on the codebase.
+
+DO THIS NOW:
+${requiredActions.slice(0, 5).map((a, i) => `${i + 1}. Call fillSingleFile for: ${a.filePath}`).join('\n')}${requiredActions.length > 5 ? `\n... and ${requiredActions.length - 5} more files` : ''}
+
+fillSingleFile returns semantic context and scaffold structure for intelligent content generation.
+After generating content, write it using the Write tool.
+
+DO NOT say "initialization complete" until ALL files are filled.`
+                : undefined;
             return {
-                success: true,
+                // Immediate action signals (appear first in JSON)
+                instruction,
+                _warning: hasActionsRequired ? 'INCOMPLETE - ACTION REQUIRED' : undefined,
+                // Status signals
+                status: hasActionsRequired ? 'incomplete' : 'success',
+                complete: !hasActionsRequired,
+                operationType: 'initialize_and_fill',
+                completionCriteria: hasActionsRequired
+                    ? 'Call fillSingleFile for each file, generate content using the returned context, then write to file'
+                    : undefined,
+                // Fill instructions (the standard prompt for HOW to fill)
+                fillInstructions: hasActionsRequired ? defaults_1.UPDATE_SCAFFOLD_PROMPT_FALLBACK : undefined,
+                // Pending writes (files that need content)
+                pendingWrites: hasActionsRequired ? requiredActions : undefined,
+                // Legacy: requiredActions (kept for backwards compatibility)
+                requiredActions: hasActionsRequired ? requiredActions : undefined,
+                // Human-readable checklist
+                checklist: hasActionsRequired ? checklist : undefined,
+                // Explicit next step with example
+                nextStep: hasActionsRequired ? {
+                    action: 'Call fillSingleFile for each file to get context, generate content, then Write to save',
+                    example: `fillSingleFile({ repoPath: "${resolvedRepoPath}", filePath: "${requiredActions[0]?.filePath || ''}" })`,
+                } : undefined,
+                // Metadata
+                _metadata: {
+                    docsGenerated,
+                    agentsGenerated,
+                    skillsGenerated,
+                    qaGenerated,
+                    outputDir,
+                    classification: classification ? {
+                        projectType: classification.primaryType,
+                        confidence: classification.confidence,
+                        reasoning: classification.reasoning,
+                    } : undefined,
+                },
+                // Legacy fields for backwards compatibility
                 docsGenerated,
                 agentsGenerated,
+                skillsGenerated,
+                qaGenerated,
                 outputDir,
-                generatedFiles,
                 classification: classification ? {
                     projectType: classification.primaryType,
                     confidence: classification.confidence,
                     reasoning: classification.reasoning,
                 } : undefined,
-                nextSteps: [
-                    'Call fillScaffolding tool to get codebase-aware content for each file',
-                    'Write the suggestedContent to each file path returned',
-                    'Focus on architecture.md, project-overview.md, and agent playbooks first'
-                ]
             };
         }
         catch (error) {
             return {
-                success: false,
+                status: 'error',
                 outputDir,
                 error: error instanceof Error ? error.message : String(error)
             };
         }
     }
 });
+/**
+ * Get fill instructions for a documentation file based on its name
+ */
+function getDocFillInstructions(fileName) {
+    const name = fileName.toLowerCase();
+    if (name === 'architecture.md') {
+        return `Fill this file with:
+- High-level architecture overview
+- Key components and their responsibilities
+- Data flow between components
+- Design patterns used
+- Technology stack decisions and rationale`;
+    }
+    if (name === 'project-overview.md') {
+        return `Fill this file with:
+- Project purpose and goals
+- Main features and capabilities
+- Target users/audience
+- Key dependencies and integrations
+- Getting started guide`;
+    }
+    if (name === 'data-flow.md') {
+        return `Fill this file with:
+- Data models and schemas
+- API endpoints and their purposes
+- Data transformation pipelines
+- State management approach
+- External data sources and sinks`;
+    }
+    if (name === 'conventions.md') {
+        return `Fill this file with:
+- Code style and formatting rules
+- Naming conventions
+- File and folder organization
+- Commit message format
+- PR and review guidelines`;
+    }
+    return `Fill this documentation file with relevant content based on the codebase analysis. Focus on accuracy and usefulness for developers.`;
+}
+/**
+ * Get fill instructions for an agent playbook based on agent type
+ */
+function getAgentFillInstructions(agentType) {
+    const type = agentType.toLowerCase();
+    if (type.includes('code-reviewer')) {
+        return `Fill this agent playbook with:
+- Code review checklist specific to this codebase
+- Common patterns to look for
+- Security considerations
+- Performance best practices
+- Testing requirements`;
+    }
+    if (type.includes('bug-fixer')) {
+        return `Fill this agent playbook with:
+- Debugging workflow for this codebase
+- Common bug patterns and fixes
+- Logging and error handling conventions
+- Test verification steps
+- Rollback procedures`;
+    }
+    if (type.includes('feature-developer')) {
+        return `Fill this agent playbook with:
+- Feature development workflow
+- Code organization patterns
+- Integration points for new features
+- Testing requirements for new code
+- Documentation expectations`;
+    }
+    if (type.includes('test-writer')) {
+        return `Fill this agent playbook with:
+- Testing framework and conventions
+- Test file organization
+- Mocking strategies
+- Coverage requirements
+- CI/CD integration`;
+    }
+    return `Fill this agent playbook with:
+- Role and responsibilities specific to this codebase
+- Key files and components to understand
+- Workflow steps for common tasks
+- Best practices and conventions to follow
+- Common pitfalls to avoid`;
+}
 //# sourceMappingURL=initializeContextTool.js.map

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

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

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

@@ -5,21 +5,37 @@ export declare const scaffoldPlanTool: import("ai").Tool<{
     title?: string | undefined;
     summary?: string | undefined;
     semantic?: boolean | undefined;
+    autoFill?: boolean | undefined;
 }, {
+    instruction: string;
+    _warning: string | undefined;
+    status: string;
+    complete: boolean;
     success: boolean;
     planPath: string;
     planContent: string;
     classification: {
         projectType: "unknown" | "cli" | "web-frontend" | "web-backend" | "full-stack" | "mobile" | "library" | "monorepo" | "desktop";
-        confidence: "high" | "medium" | "low";
+        confidence: "low" | "medium" | "high";
         reasoning: string[];
     };
+    fillInstructions: string | undefined;
+    nextStep: {
+        action: string;
+        example: string;
+    } | undefined;
     error?: undefined;
 } | {
     success: boolean;
     error: string;
+    instruction?: undefined;
+    _warning?: undefined;
+    status?: undefined;
+    complete?: undefined;
     planPath?: undefined;
     planContent?: undefined;
     classification?: undefined;
+    fillInstructions?: undefined;
+    nextStep?: 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgH3B,CAAC"}

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

@@ -41,11 +41,16 @@ 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 repoPath = customRepoPath ? path.resolve(customRepoPath) : process.cwd();
+        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');
@@ -58,6 +63,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,22 +72,55 @@ 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;
+            // 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) {
@@ -91,4 +131,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":"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"}

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

@@ -0,0 +1,35 @@
+/**
+ * Tool Factory - Local implementation of tool definition utility
+ *
+ * This replaces the 'tool' function from 'ai' package to avoid
+ * pulling in unnecessary AI provider dependencies.
+ */
+import type { z } from 'zod';
+/**
+ * Tool definition interface
+ */
+export interface ToolDefinition<TInput, TOutput> {
+    description: string;
+    inputSchema: z.ZodSchema<TInput>;
+    execute?: (input: TInput, context: ToolContext) => Promise<TOutput>;
+}
+/**
+ * Context passed to tool execution
+ */
+export interface ToolContext {
+    toolCallId: string;
+    messages: unknown[];
+}
+/**
+ * Type for a tool set (collection of tools)
+ */
+export type ToolSet = Record<string, ToolDefinition<any, any>>;
+/**
+ * Create a tool definition with type safety
+ *
+ * This is a simple factory function that returns the tool config
+ * with proper typing. It's functionally equivalent to the 'tool'
+ * function from the 'ai' package but without any AI provider deps.
+ */
+export declare function tool<TInput, TOutput = unknown>(config: ToolDefinition<TInput, TOutput>): ToolDefinition<TInput, TOutput>;
+//# sourceMappingURL=toolFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolFactory.d.ts","sourceRoot":"","sources":["../../../../src/services/ai/tools/toolFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,EAAE,OAAO;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAC5C,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjC"}

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

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Tool Factory - Local implementation of tool definition utility
+ *
+ * This replaces the 'tool' function from 'ai' package to avoid
+ * pulling in unnecessary AI provider dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tool = tool;
+/**
+ * Create a tool definition with type safety
+ *
+ * This is a simple factory function that returns the tool config
+ * with proper typing. It's functionally equivalent to the 'tool'
+ * function from the 'ai' package but without any AI provider deps.
+ */
+function tool(config) {
+    return config;
+}
+//# sourceMappingURL=toolFactory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolFactory.js","sourceRoot":"","sources":["../../../../src/services/ai/tools/toolFactory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiCH,oBAIC;AAXD;;;;;;GAMG;AACH,SAAgB,IAAI,CAClB,MAAuC;IAEvC,OAAO,MAAM,CAAC;AAChB,CAAC"}