@ggailabs/cli-context 0.5.0

package/dist/prompts/defaults.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPDATE_PLAN_PROMPT_FALLBACK = exports.UPDATE_SCAFFOLD_PROMPT_FALLBACK = void 0;
+exports.UPDATE_SCAFFOLD_PROMPT_FALLBACK = `# Prompt: Update Repository Documentation and Agent Playbooks
+
+## Purpose
+You are an AI assistant responsible for refreshing the documentation (\`docs/\`) and agent playbooks (\`agents/\`) generated by the ai-context scaffolding tool. Your goal is to bring every guide up to date with the latest repository state, fill in placeholder sections, and maintain cross-references between docs and agent instructions.
+
+## Context Gathering Checklist
+1. Run \`git status -sb\` to understand pending changes.
+2. Review the latest merged commits or PRs related to documentation, architecture, workflow, or testing.
+3. Inspect \`package.json\`, CI configuration, and any release or roadmap notes stored in the repository.
+4. Check \`docs/README.md\` for the current document map and update AI markers (\`agent-update:*\`).
+5. Identify unresolved placeholders marked as \`<!-- agent-fill:* -->\`.
+
+## Update Procedure
+1. **Select a Guide**
+   - Navigate to \`docs/<guide>.md\`.
+   - Read the YAML front matter (\`ai_update_goal\`, \`required_inputs\`, \`success_criteria\`) and ensure you collect the listed inputs before editing.
+
+2. **Edit Within Update Wrappers**
+   - Update content strictly inside the matching \`<!-- agent-update:start:... -->\` block and keep the closing \`<!-- agent-update:end -->\` tag.
+   - Remove or replace any \`TODO\` text with accurate, current information.
+   - When you complete a placeholder slot (\`<!-- agent-fill:... -->\`), remove the wrapper and provide the finalized description.
+
+3. **Cross-Link Updates**
+   - Verify that links between docs remain valid.
+   - If you add new guides or sections, update \`docs/README.md\` and the document map table.
+
+4. **Agent Playbook Alignment**
+   - For each change in \`docs/\`, adjust the related \`agents/*.md\` playbooks.
+   - Ensure the "Documentation Touchpoints" list references the correct \`agent-update\` markers.
+   - Update collaboration checklists and evidence sections to reflect the latest workflows.
+
+5. **Evidence & Traceability**
+   - Note key sources (commit hashes, issues, ADRs) in the "Evidence to Capture" or "AI Update Checklist" summary lines.
+   - If anything is ambiguous or requires human follow-up, leave a concise note clearly labelled for maintainers.
+
+## Acceptance Criteria
+- Every guide’s \`success_criteria\` field is satisfied.
+- No unresolved \`TODO\` or \`agent-fill\` blocks remain unless they require explicit human input; in such cases, add a comment explaining the dependency.
+- Agent playbooks list accurate responsibilities, best practices, and pointer links to the refreshed docs.
+- Changes are self-contained, well-formatted Markdown, and reference any new external resources introduced.
+
+## Deliverables
+- Updated Markdown files committed to the repository.
+- A short changelog or PR description summarizing:
+  - Guides touched
+  - Key decisions or facts added
+  - Evidence links and any pending follow-ups
+`;
+exports.UPDATE_PLAN_PROMPT_FALLBACK = `# Prompt: Update Collaboration Plans
+
+## Purpose
+You are an AI assistant responsible for refining collaboration plans that live in the \`.context/plans/\` directory. Each plan orchestrates work across documentation guides (\`docs/\`) and agent playbooks (\`agents/\`). Your goal is to replace placeholders with actionable guidance that keeps the plan aligned with the referenced docs, agents, and repository context.
+
+## Preparation Checklist
+1. Review the plan’s YAML front matter to understand the stated \`ai_update_goal\`, \`required_inputs\`, and \`success_criteria\`.
+2. Inspect the provided documentation excerpts (from \`docs/\`) and agent playbooks to ensure the plan reflects their current guidance.
+3. Confirm that the “Agent Lineup” and “Documentation Touchpoints” tables link to real files and reference the correct \`agent-update\` markers.
+4. Note any TODOs, \`agent-fill\` placeholders, or missing evidence sections that must be resolved.
+
+## Update Procedure
+1. **Task Snapshot**
+   - Summarize the primary goal and success signal in concrete terms.
+   - List authoritative references (docs, issues, specs) that contributors should consult.
+
+2. **Agent Alignment**
+   - For each agent in the lineup, describe why they are involved and call out the first responsibility they should focus on.
+   - Ensure playbook links and responsibility summaries match the referenced agent files.
+
+3. **Documentation Touchpoints**
+   - Map each plan stage to the docs excerpts provided, highlighting which sections need to be updated during execution.
+   - Keep the table sorted and ensure the listed \`agent-update\` markers exist.
+
+4. **Working Phases**
+   - Break the work into sequential phases that each include a numbered list of steps, accountable owners, deliverables, and evidence expectations.
+   - Close every phase with an explicit Git commit checkpoint (for example, \`git commit -m "chore(plan): complete phase 1"\`) so progress is recorded in version control.
+   - Reference documentation and agent resources that the team should consult while executing each phase.
+
+5. **Evidence & Follow-up**
+   - Specify the artefacts that must be captured (PR links, test runs, change logs) before the plan is considered complete.
+   - Record any follow-up actions or decisions that require human confirmation.
+
+## Acceptance Criteria
+- Every TODO or placeholder inside the plan’s \`agent-update\` block is resolved or accompanied by a clear escalation note.
+- Tables reference existing files and stay in sync with the docs/agent indices.
+- Phases provide actionable guidance, include numbered steps, and end with an explicit Git commit checkpoint.
+- The plan remains fully self-contained and ready for contributors to execute.
+
+## Deliverables
+- Updated plan Markdown returned verbatim.
+- No additional commentary outside the Markdown output.
+`;
+//# sourceMappingURL=defaults.js.map

package/dist/prompts/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/prompts/defaults.ts"],"names":[],"mappings":";;;AAAa,QAAA,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+C9C,CAAC;AAEW,QAAA,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C1C,CAAC"}

package/dist/services/baseLLMClient.d.ts

@@ -0,0 +1,12 @@
+import { UsageStats } from '../types';
+export declare abstract class BaseLLMClient {
+    protected usageStats: UsageStats;
+    constructor(model: string);
+    abstract generateText(prompt: string, systemPrompt?: string): Promise<string>;
+    generateDocumentation(codeContent: string, filePath: string, context: string): Promise<string>;
+    generateAgentPrompt(repoStructure: string, fileContext: string, agentType: string): Promise<string>;
+    getUsageStats(): UsageStats;
+    resetUsageStats(): void;
+    protected trackUsage(usage: any): void;
+}
+//# sourceMappingURL=baseLLMClient.d.ts.map

package/dist/services/baseLLMClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseLLMClient.d.ts","sourceRoot":"","sources":["../../src/services/baseLLMClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,8BAAsB,aAAa;IACjC,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;gBAErB,KAAK,EAAE,MAAM;IAUzB,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAEvE,qBAAqB,CACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAwBZ,mBAAmB,CACvB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAyBlB,aAAa,IAAI,UAAU;IAI3B,eAAe,IAAI,IAAI;IAWvB,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;CAQvC"}

package/dist/services/baseLLMClient.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseLLMClient = void 0;
+class BaseLLMClient {
+    constructor(model) {
+        this.usageStats = {
+            totalCalls: 0,
+            totalPromptTokens: 0,
+            totalCompletionTokens: 0,
+            totalTokens: 0,
+            model
+        };
+    }
+    async generateDocumentation(codeContent, filePath, context) {
+        const systemPrompt = `You are a technical documentation expert. Generate clear, comprehensive documentation for the provided code file. Include:
+    1. Purpose and overview
+    2. Key components/functions
+    3. Dependencies and relationships
+    4. Usage examples where applicable
+    5. Important notes or gotchas
+    
+    Focus on being practical and helpful for developers working with this codebase.`;
+        const prompt = `File: ${filePath}
+    
+Context: ${context}
+
+Code:
+\`\`\`
+${codeContent}
+\`\`\`
+
+Generate comprehensive documentation for this file.`;
+        return this.generateText(prompt, systemPrompt);
+    }
+    async generateAgentPrompt(repoStructure, fileContext, agentType) {
+        const systemPrompt = `You are an expert at creating AI agent prompts for software development. Create a specialized prompt that would help an AI assistant understand and work effectively with this specific codebase.
+
+The prompt should include:
+1. Clear understanding of the codebase structure and patterns
+2. Key conventions and best practices used in this project  
+3. Important files and their purposes
+4. Common tasks and workflows
+5. Specific guidance for the agent type requested
+
+Make the prompt practical and actionable.`;
+        const prompt = `Codebase Structure:
+${repoStructure}
+
+File Context:
+${fileContext}
+
+Agent Type: ${agentType}
+
+Generate a comprehensive agent prompt that would help an AI assistant work effectively with this codebase for ${agentType} tasks.`;
+        return this.generateText(prompt, systemPrompt);
+    }
+    getUsageStats() {
+        return { ...this.usageStats };
+    }
+    resetUsageStats() {
+        const model = this.usageStats.model;
+        this.usageStats = {
+            totalCalls: 0,
+            totalPromptTokens: 0,
+            totalCompletionTokens: 0,
+            totalTokens: 0,
+            model
+        };
+    }
+    trackUsage(usage) {
+        if (usage) {
+            this.usageStats.totalCalls++;
+            this.usageStats.totalPromptTokens += usage.prompt_tokens || usage.input_tokens || 0;
+            this.usageStats.totalCompletionTokens += usage.completion_tokens || usage.output_tokens || 0;
+            this.usageStats.totalTokens += usage.total_tokens || (usage.prompt_tokens + usage.completion_tokens) || 0;
+        }
+    }
+}
+exports.BaseLLMClient = BaseLLMClient;
+//# sourceMappingURL=baseLLMClient.js.map

package/dist/services/baseLLMClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseLLMClient.js","sourceRoot":"","sources":["../../src/services/baseLLMClient.ts"],"names":[],"mappings":";;;AAEA,MAAsB,aAAa;IAGjC,YAAY,KAAa;QACvB,IAAI,CAAC,UAAU,GAAG;YAChB,UAAU,EAAE,CAAC;YACb,iBAAiB,EAAE,CAAC;YACpB,qBAAqB,EAAE,CAAC;YACxB,WAAW,EAAE,CAAC;YACd,KAAK;SACN,CAAC;IACJ,CAAC;IAID,KAAK,CAAC,qBAAqB,CACzB,WAAmB,EACnB,QAAgB,EAChB,OAAe;QAEf,MAAM,YAAY,GAAG;;;;;;;oFAO2D,CAAC;QAEjF,MAAM,MAAM,GAAG,SAAS,QAAQ;;WAEzB,OAAO;;;;EAIhB,WAAW;;;oDAGuC,CAAC;QAEjD,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,aAAqB,EACrB,WAAmB,EACnB,SAAiB;QAEjB,MAAM,YAAY,GAAG;;;;;;;;;0CASiB,CAAC;QAEvC,MAAM,MAAM,GAAG;EACjB,aAAa;;;EAGb,WAAW;;cAEC,SAAS;;gHAEyF,SAAS,SAAS,CAAC;QAE/H,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,aAAa;QACX,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,eAAe;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG;YAChB,UAAU,EAAE,CAAC;YACb,iBAAiB,EAAE,CAAC;YACpB,qBAAqB,EAAE,CAAC;YACxB,WAAW,EAAE,CAAC;YACd,KAAK;SACN,CAAC;IACJ,CAAC;IAES,UAAU,CAAC,KAAU;QAC7B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,iBAAiB,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;YACpF,IAAI,CAAC,UAAU,CAAC,qBAAqB,IAAI,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;YAC7F,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5G,CAAC;IACH,CAAC;CACF;AA/FD,sCA+FC"}

package/dist/services/fill/fillService.d.ts

@@ -0,0 +1,46 @@
+import type { CLIInterface } from '../../utils/cliUI';
+import type { TranslateFn } from '../../utils/i18n';
+import { FileMapper } from '../../utils/fileMapper';
+import { LLMClientFactory } from '../llmClientFactory';
+import type { LLMConfig } from '../../types';
+export interface FillCommandFlags {
+    output?: string;
+    prompt?: string;
+    include?: string[];
+    exclude?: string[];
+    verbose?: boolean;
+    limit?: number;
+    model?: string;
+    provider?: LLMConfig['provider'];
+    apiKey?: string;
+    baseUrl?: string;
+}
+interface FillServiceDependencies {
+    ui: CLIInterface;
+    t: TranslateFn;
+    version: string;
+    defaultModel: string;
+    fileMapperFactory?: (exclude: string[] | undefined) => FileMapper;
+    llmClientFactory?: typeof LLMClientFactory;
+}
+export declare class FillService {
+    private readonly ui;
+    private readonly t;
+    private readonly version;
+    private readonly defaultModel;
+    private readonly fileMapperFactory;
+    private readonly llmClientFactory;
+    constructor(dependencies: FillServiceDependencies);
+    run(repoPath: string, rawOptions: FillCommandFlags): Promise<void>;
+    private processTarget;
+    private collectTargets;
+    private displayPromptSource;
+    private displayablePath;
+    private ensureDirectoryExists;
+    private buildContextSummary;
+    private buildUserPrompt;
+    private printLlmSummary;
+    private ensureTrailingNewline;
+}
+export {};
+//# sourceMappingURL=fillService.d.ts.map

package/dist/services/fill/fillService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fillService.d.ts","sourceRoot":"","sources":["../../../src/services/fill/fillService.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAA6B,MAAM,aAAa,CAAC;AAIxE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAyBD,UAAU,uBAAuB;IAC/B,EAAE,EAAE,YAAY,CAAC;IACjB,CAAC,EAAE,WAAW,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,KAAK,UAAU,CAAC;IAClE,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAC;CAC5C;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAc;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgD;IAClF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;gBAE/C,YAAY,EAAE,uBAAuB;IAS3C,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAuF1D,aAAa;YA8Bb,cAAc;IAqB5B,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,eAAe;YAKT,qBAAqB;IAOnC,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,qBAAqB;CAG9B"}

package/dist/services/fill/fillService.js

@@ -0,0 +1,254 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FillService = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const chalk_1 = __importDefault(require("chalk"));
+const glob_1 = require("glob");
+const promptLoader_1 = require("../../utils/promptLoader");
+const fileMapper_1 = require("../../utils/fileMapper");
+const llmClientFactory_1 = require("../llmClientFactory");
+const llmConfig_1 = require("../shared/llmConfig");
+class FillService {
+    constructor(dependencies) {
+        this.ui = dependencies.ui;
+        this.t = dependencies.t;
+        this.version = dependencies.version;
+        this.defaultModel = dependencies.defaultModel;
+        this.fileMapperFactory = dependencies.fileMapperFactory ?? ((exclude) => new fileMapper_1.FileMapper(exclude ?? []));
+        this.llmClientFactory = dependencies.llmClientFactory ?? llmClientFactory_1.LLMClientFactory;
+    }
+    async run(repoPath, rawOptions) {
+        const resolvedRepo = path.resolve(repoPath);
+        const outputDir = path.resolve(rawOptions.output || './.context');
+        const docsDir = path.join(outputDir, 'docs');
+        const agentsDir = path.join(outputDir, 'agents');
+        await this.ensureDirectoryExists(docsDir, this.t('errors.fill.missingDocsScaffold'));
+        await this.ensureDirectoryExists(agentsDir, this.t('errors.fill.missingAgentsScaffold'));
+        const llmConfig = await (0, llmConfig_1.resolveLlmConfig)({
+            rawOptions: {
+                provider: rawOptions.provider,
+                model: rawOptions.model,
+                apiKey: rawOptions.apiKey,
+                baseUrl: rawOptions.baseUrl
+            },
+            fallbackModel: this.defaultModel,
+            t: this.t,
+            factory: this.llmClientFactory
+        });
+        const scaffoldPrompt = await (0, promptLoader_1.resolveScaffoldPrompt)(rawOptions.prompt, missingPath => this.t('errors.fill.promptMissing', { path: missingPath }));
+        const options = {
+            repoPath: resolvedRepo,
+            outputDir,
+            docsDir,
+            agentsDir,
+            include: rawOptions.include,
+            exclude: rawOptions.exclude,
+            verbose: Boolean(rawOptions.verbose),
+            limit: rawOptions.limit,
+            provider: llmConfig.provider,
+            model: llmConfig.model,
+            apiKey: llmConfig.apiKey,
+            baseUrl: llmConfig.baseUrl,
+            systemPrompt: scaffoldPrompt.content
+        };
+        this.displayPromptSource(scaffoldPrompt.path, scaffoldPrompt.source);
+        this.ui.displayWelcome(this.version);
+        this.ui.displayProjectInfo(options.repoPath, options.outputDir, `fill:${options.provider}`);
+        const fileMapper = this.fileMapperFactory(options.exclude);
+        this.ui.displayStep(1, 3, this.t('steps.fill.analyze'));
+        this.ui.startSpinner(this.t('spinner.repo.scanning'));
+        const repoStructure = await fileMapper.mapRepository(options.repoPath, options.include);
+        this.ui.updateSpinner(this.t('spinner.repo.scanComplete', {
+            fileCount: repoStructure.totalFiles,
+            directoryCount: repoStructure.directories.length
+        }), 'success');
+        const targets = await this.collectTargets(options);
+        if (targets.length === 0) {
+            this.ui.displayWarning(this.t('warnings.fill.noTargets'));
+            return;
+        }
+        const llmClient = this.llmClientFactory.createClient({
+            apiKey: options.apiKey,
+            model: options.model,
+            provider: options.provider,
+            baseUrl: options.baseUrl
+        });
+        const contextSummary = this.buildContextSummary(repoStructure);
+        const results = [];
+        this.ui.displayStep(2, 3, this.t('steps.fill.processFiles', { count: targets.length, model: options.model }));
+        for (const target of targets) {
+            const result = await this.processTarget(target, llmClient, options, contextSummary);
+            results.push(result);
+        }
+        this.ui.displayStep(3, 3, this.t('steps.fill.summary'));
+        this.printLlmSummary(llmClient.getUsageStats(), results);
+        this.ui.displaySuccess(this.t('success.fill.completed'));
+    }
+    async processTarget(target, llmClient, options, contextSummary) {
+        this.ui.startSpinner(this.t('spinner.fill.processing', { path: target.relativePath }));
+        try {
+            const userPrompt = this.buildUserPrompt(target.relativePath, target.content, contextSummary, target.isAgent);
+            const updatedContent = await llmClient.generateText(userPrompt, options.systemPrompt);
+            if (!updatedContent || !updatedContent.trim()) {
+                this.ui.updateSpinner(this.t('spinner.fill.noContent', { path: target.relativePath }), 'warn');
+                return { file: target.relativePath, status: 'skipped', message: this.t('messages.fill.emptyResponse') };
+            }
+            await fs.writeFile(target.fullPath, this.ensureTrailingNewline(updatedContent));
+            this.ui.updateSpinner(this.t('spinner.fill.updated', { path: target.relativePath }), 'success');
+            return { file: target.relativePath, status: 'updated' };
+        }
+        catch (error) {
+            this.ui.updateSpinner(this.t('spinner.fill.failed', { path: target.relativePath }), 'fail');
+            return {
+                file: target.relativePath,
+                status: 'failed',
+                message: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    async collectTargets(options) {
+        const docFiles = await (0, glob_1.glob)('**/*.md', { cwd: options.docsDir, absolute: true });
+        const agentFiles = await (0, glob_1.glob)('**/*.md', { cwd: options.agentsDir, absolute: true });
+        const candidates = [...docFiles, ...agentFiles];
+        const targets = [];
+        for (const fullPath of candidates) {
+            const content = await fs.readFile(fullPath, 'utf-8');
+            const isAgent = fullPath.includes(`${path.sep}agents${path.sep}`);
+            const relativePath = path.relative(options.outputDir, fullPath);
+            targets.push({ fullPath, relativePath, isAgent, content });
+            if (options.limit && targets.length >= options.limit) {
+                break;
+            }
+        }
+        return targets;
+    }
+    displayPromptSource(promptPath, source) {
+        if (source === 'custom' && promptPath) {
+            this.ui.displayInfo(this.t('info.prompt.title'), this.t('info.prompt.usingCustom', { path: this.displayablePath(promptPath) }));
+            return;
+        }
+        if (source === 'package' && promptPath) {
+            this.ui.displayInfo(this.t('info.prompt.title'), this.t('info.prompt.usingPackage', { path: this.displayablePath(promptPath) }));
+            return;
+        }
+        this.ui.displayInfo(this.t('info.prompt.title'), this.t('info.prompt.usingBundled'));
+    }
+    displayablePath(promptPath) {
+        const relative = path.relative(process.cwd(), promptPath);
+        return relative || promptPath;
+    }
+    async ensureDirectoryExists(dir, message) {
+        const exists = await fs.pathExists(dir);
+        if (!exists) {
+            throw new Error(message);
+        }
+    }
+    buildContextSummary(repoStructure) {
+        const directories = new Set();
+        repoStructure.directories.forEach(dir => {
+            const [first] = dir.relativePath.split(/[\\/]/).filter(Boolean);
+            if (first) {
+                directories.add(first);
+            }
+        });
+        const topDirs = Array.from(directories).sort().slice(0, 12);
+        const totalSizeMb = (repoStructure.totalSize / (1024 * 1024)).toFixed(2);
+        return [
+            `Top-level directories: ${topDirs.length ? topDirs.join(', ') : 'n/a'}`,
+            `Total files scanned: ${repoStructure.totalFiles}`,
+            `Repository size (approx.): ${totalSizeMb} MB`
+        ].join('\n');
+    }
+    buildUserPrompt(relativePath, currentContent, contextSummary, isAgent) {
+        const guidance = [
+            '- Preserve YAML front matter and existing `agent-update` sections.',
+            '- Replace TODOs and resolve `agent-fill` placeholders with concrete information.',
+            '- Ensure success criteria in the front matter are satisfied.',
+            '- Return only the full updated Markdown for this file.'
+        ];
+        if (isAgent) {
+            guidance.push('- Keep agent responsibilities, best practices, and documentation touchpoints aligned with the latest docs.');
+        }
+        else {
+            guidance.push('- Maintain accurate cross-links between docs and referenced resources.');
+        }
+        return [
+            `Target file: ${relativePath}`,
+            'Repository summary:',
+            contextSummary,
+            '',
+            'Guidance:',
+            ...guidance,
+            '',
+            'Current content:',
+            '<file>',
+            currentContent,
+            '</file>'
+        ].join('\n');
+    }
+    printLlmSummary(usage, results) {
+        const updated = results.filter(result => result.status === 'updated').length;
+        const skipped = results.filter(result => result.status === 'skipped').length;
+        const failed = results.filter(result => result.status === 'failed');
+        console.log('\n' + chalk_1.default.bold('📄 LLM Fill Summary'));
+        console.log(chalk_1.default.gray('─'.repeat(50)));
+        console.log(`${chalk_1.default.blue('Updated files:')} ${chalk_1.default.white(updated.toString())}`);
+        console.log(`${chalk_1.default.blue('Skipped files:')} ${chalk_1.default.white(skipped.toString())}`);
+        console.log(`${chalk_1.default.blue('Failures:')} ${failed.length}`);
+        if (usage.totalCalls > 0) {
+            console.log(chalk_1.default.gray('─'.repeat(50)));
+            console.log(`${chalk_1.default.blue('LLM calls:')} ${usage.totalCalls}`);
+            console.log(`${chalk_1.default.blue('Prompt tokens:')} ${usage.totalPromptTokens}`);
+            console.log(`${chalk_1.default.blue('Completion tokens:')} ${usage.totalCompletionTokens}`);
+            console.log(`${chalk_1.default.blue('Model:')} ${usage.model}`);
+        }
+        if (failed.length > 0) {
+            console.log(chalk_1.default.gray('─'.repeat(50)));
+            failed.forEach(item => {
+                console.log(`${chalk_1.default.red('✖')} ${chalk_1.default.white(item.file)} — ${chalk_1.default.gray(item.message || 'Unknown error')}`);
+            });
+        }
+    }
+    ensureTrailingNewline(content) {
+        return content.endsWith('\n') ? content : `${content}\n`;
+    }
+}
+exports.FillService = FillService;
+//# sourceMappingURL=fillService.js.map

package/dist/services/fill/fillService.js.map

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

package/dist/services/init/initService.d.ts

@@ -0,0 +1,37 @@
+import { FileMapper } from '../../utils/fileMapper';
+import { DocumentationGenerator } from '../../generators/documentation/documentationGenerator';
+import { AgentGenerator } from '../../generators/agents/agentGenerator';
+import type { CLIInterface } from '../../utils/cliUI';
+import type { TranslateFn } from '../../utils/i18n';
+export interface InitCommandFlags {
+    output?: string;
+    include?: string[];
+    exclude?: string[];
+    verbose?: boolean;
+    docsOnly?: boolean;
+    agentsOnly?: boolean;
+}
+export interface InitServiceDependencies {
+    ui: CLIInterface;
+    t: TranslateFn;
+    version: string;
+    documentationGenerator?: DocumentationGenerator;
+    agentGenerator?: AgentGenerator;
+    fileMapperFactory?: (exclude: string[] | undefined) => FileMapper;
+}
+export declare class InitService {
+    private readonly ui;
+    private readonly t;
+    private readonly version;
+    private readonly documentationGenerator;
+    private readonly agentGenerator;
+    private readonly fileMapperFactory;
+    constructor(dependencies: InitServiceDependencies);
+    run(repoPath: string, type: string, rawOptions: InitCommandFlags): Promise<void>;
+    private confirmOverwriteIfNeeded;
+    private directoryHasContent;
+    private generateScaffolds;
+    private ensurePaths;
+}
+export declare function resolveScaffoldType(type: string, rawOptions: InitCommandFlags, t: TranslateFn): 'docs' | 'agents' | 'both';
+//# sourceMappingURL=initService.d.ts.map

package/dist/services/init/initService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initService.d.ts","sourceRoot":"","sources":["../../../src/services/init/initService.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAGpE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,YAAY,CAAC;IACjB,CAAC,EAAE,WAAW,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,KAAK,UAAU,CAAC;CACnE;AAYD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAc;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgD;gBAEtE,YAAY,EAAE,uBAAuB;IAS3C,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YA4CxE,wBAAwB;YAqCxB,mBAAmB;YAUnB,iBAAiB;YA+BjB,WAAW;CAQ1B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAgB1H"}