openplanr 0.1.0 → 0.3.0

package/dist/agents/prompt-composer.js

@@ -0,0 +1,81 @@
+/**
+ * Composes rich implementation prompts for coding agents.
+ *
+ * Assembles a structured prompt from:
+ * 1. Target subtask details
+ * 2. Full task list context (what's done, what's next)
+ * 3. Parent story and feature context
+ * 4. Codebase context (tech stack, folder tree, related files)
+ *
+ * The output is a detailed markdown prompt that any coding agent
+ * (Claude, Cursor, Codex) can understand and act on.
+ */
+import { formatSubtaskList } from './task-parser.js';
+/**
+ * Compose a complete implementation prompt from gathered context.
+ * Returns a markdown string ready to be sent to a coding agent.
+ */
+export function composeImplementationPrompt(ctx) {
+    const sections = [];
+    // Header
+    sections.push(`# Implementation Task: ${ctx.taskId}`);
+    // Target subtask(s)
+    if (ctx.targetSubtasks.length > 0) {
+        sections.push('## Target Subtask(s)\n');
+        sections.push('Implement ONLY the following subtask(s):');
+        sections.push('');
+        for (const st of ctx.targetSubtasks) {
+            sections.push(`- **${st.id}**: ${st.title}`);
+        }
+        // Parent group context
+        const parentId = ctx.targetSubtasks[0]?.parentId;
+        if (parentId) {
+            const parentGroup = ctx.allSubtasks.find((t) => t.id === parentId);
+            if (parentGroup) {
+                sections.push(`\nParent task group: **${parentGroup.id}** ${parentGroup.title}`);
+            }
+        }
+    }
+    // Full task list (shows what's done and what's pending)
+    sections.push('\n## Full Task List\n');
+    sections.push('```');
+    const targetIds = new Set(ctx.targetSubtasks.map((t) => t.id));
+    const firstTargetId = ctx.targetSubtasks[0]?.id;
+    sections.push(formatSubtaskList(ctx.allSubtasks, firstTargetId));
+    sections.push('```');
+    // Parent story context
+    if (ctx.storyContent) {
+        sections.push('\n## User Story Context\n');
+        sections.push(truncate(ctx.storyContent, 3000));
+    }
+    // Parent feature context
+    if (ctx.featureContent) {
+        sections.push('\n## Feature Context\n');
+        sections.push(truncate(ctx.featureContent, 2000));
+    }
+    // Parent epic context (brief)
+    if (ctx.epicContent) {
+        sections.push('\n## Epic Context (summary)\n');
+        sections.push(truncate(ctx.epicContent, 1000));
+    }
+    // Codebase context
+    if (ctx.codebaseContext) {
+        sections.push('\n## Codebase Context\n');
+        sections.push(ctx.codebaseContext);
+    }
+    // Instructions
+    sections.push('\n## Instructions\n');
+    sections.push('1. Implement ONLY the target subtask(s) listed above.');
+    sections.push('2. Follow existing code patterns and conventions in the codebase.');
+    sections.push('3. Write clean, well-documented code.');
+    sections.push('4. Include appropriate error handling.');
+    sections.push('5. Add or update tests for the changes.');
+    sections.push('6. Do NOT modify code unrelated to the target subtask(s).');
+    return sections.join('\n');
+}
+function truncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars) + '\n\n... (truncated)';
+}
+//# sourceMappingURL=prompt-composer.js.map

package/dist/agents/prompt-composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-composer.js","sourceRoot":"","sources":["../../src/agents/prompt-composer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAcrD;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAA0B;IACpE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,SAAS;IACT,QAAQ,CAAC,IAAI,CAAC,0BAA0B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAEtD,oBAAoB;IACpB,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,uBAAuB;QACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;YACnE,IAAI,WAAW,EAAE,CAAC;gBAChB,QAAQ,CAAC,IAAI,CAAC,0BAA0B,WAAW,CAAC,EAAE,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,aAAa,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAErB,uBAAuB;IACvB,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,yBAAyB;IACzB,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,8BAA8B;IAC9B,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,mBAAmB;IACnB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,eAAe;IACf,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IACvE,QAAQ,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IACnF,QAAQ,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACvD,QAAQ,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACzD,QAAQ,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAE3E,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,qBAAqB,CAAC;AACzD,CAAC"}

package/dist/agents/task-parser.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Parses task list markdown files to extract subtask structure.
+ *
+ * Supports addressing subtasks by:
+ * - ID (e.g., "2.1")
+ * - Group ID (e.g., "2.0" returns the group + all subtasks)
+ * - Keyword search (e.g., "auth" fuzzy-matches against titles)
+ * - Next pending (returns the first unchecked subtask)
+ */
+export interface ParsedSubtask {
+    id: string;
+    title: string;
+    done: boolean;
+    parentId: string | null;
+    depth: number;
+}
+/**
+ * Parse a task list markdown file into structured subtasks.
+ * Expected format: `- [x] 1.0 Task title` or `  - [ ] 1.1 Subtask title`
+ */
+export declare function parseTaskMarkdown(content: string): ParsedSubtask[];
+/**
+ * Find subtasks matching a query.
+ *
+ * - Exact ID match: "2.1" → single subtask
+ * - Group match: "2.0" → group + all its subtasks
+ * - Keyword search: "auth" → fuzzy match on titles
+ */
+export declare function findSubtasks(tasks: ParsedSubtask[], query: string): ParsedSubtask[];
+/**
+ * Get the next pending (unchecked) subtask.
+ */
+export declare function getNextPending(tasks: ParsedSubtask[]): ParsedSubtask | null;
+/**
+ * Format subtasks for display in the terminal.
+ */
+export declare function formatSubtaskList(tasks: ParsedSubtask[], highlightId?: string): string;
+//# sourceMappingURL=task-parser.d.ts.map

package/dist/agents/task-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../../src/agents/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CA+BlE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAgBnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,GAAG,IAAI,CAE3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAStF"}

package/dist/agents/task-parser.js

@@ -0,0 +1,83 @@
+/**
+ * Parses task list markdown files to extract subtask structure.
+ *
+ * Supports addressing subtasks by:
+ * - ID (e.g., "2.1")
+ * - Group ID (e.g., "2.0" returns the group + all subtasks)
+ * - Keyword search (e.g., "auth" fuzzy-matches against titles)
+ * - Next pending (returns the first unchecked subtask)
+ */
+/**
+ * Parse a task list markdown file into structured subtasks.
+ * Expected format: `- [x] 1.0 Task title` or `  - [ ] 1.1 Subtask title`
+ */
+export function parseTaskMarkdown(content) {
+    const tasks = [];
+    const lines = content.split('\n');
+    let currentGroupId = null;
+    for (const line of lines) {
+        // Match: - [x] 1.0 Task title  OR  - [ ] 1.1 Subtask title
+        const match = line.match(/^(\s*)- \[(x| )\]\s+(\d+\.\d+)\s+(.+)$/);
+        if (!match)
+            continue;
+        const indent = match[1].length;
+        const done = match[2] === 'x';
+        const id = match[3];
+        const title = match[4].trim();
+        const depth = indent > 0 ? 1 : 0;
+        if (depth === 0) {
+            currentGroupId = id;
+        }
+        tasks.push({
+            id,
+            title,
+            done,
+            parentId: depth === 0 ? null : currentGroupId,
+            depth,
+        });
+    }
+    return tasks;
+}
+/**
+ * Find subtasks matching a query.
+ *
+ * - Exact ID match: "2.1" → single subtask
+ * - Group match: "2.0" → group + all its subtasks
+ * - Keyword search: "auth" → fuzzy match on titles
+ */
+export function findSubtasks(tasks, query) {
+    // Try exact ID match
+    const exactMatch = tasks.filter((t) => t.id === query);
+    if (exactMatch.length > 0) {
+        // If it's a group (x.0), include its children
+        const isGroup = query.endsWith('.0');
+        if (isGroup) {
+            const groupNum = query.split('.')[0];
+            return tasks.filter((t) => t.id.startsWith(groupNum + '.'));
+        }
+        return exactMatch;
+    }
+    // Fuzzy keyword search
+    const lowerQuery = query.toLowerCase();
+    return tasks.filter((t) => t.title.toLowerCase().includes(lowerQuery));
+}
+/**
+ * Get the next pending (unchecked) subtask.
+ */
+export function getNextPending(tasks) {
+    return tasks.find((t) => !t.done && t.depth > 0) || tasks.find((t) => !t.done) || null;
+}
+/**
+ * Format subtasks for display in the terminal.
+ */
+export function formatSubtaskList(tasks, highlightId) {
+    return tasks
+        .map((t) => {
+        const checkbox = t.done ? '[x]' : '[ ]';
+        const indent = t.depth > 0 ? '  ' : '';
+        const marker = t.id === highlightId ? ' ← TARGET' : '';
+        return `${indent}- ${checkbox} ${t.id} ${t.title}${marker}`;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=task-parser.js.map

package/dist/agents/task-parser.js.map

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

package/dist/agents/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Coding agent abstraction types.
+ *
+ * Each supported coding agent (Claude CLI, Cursor, Codex) implements
+ * the CodingAgent interface for unified task implementation dispatch.
+ */
+export interface AgentOptions {
+    cwd: string;
+    stream: boolean;
+    dryRun: boolean;
+}
+export interface AgentResult {
+    output: string;
+    exitCode: number;
+}
+export interface CodingAgent {
+    readonly name: string;
+    /** Check if the coding agent CLI/tool is available on this machine. */
+    isAvailable(): Promise<boolean>;
+    /** Execute an implementation prompt via the coding agent. */
+    execute(prompt: string, options: AgentOptions): Promise<AgentResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,uEAAuE;IACvE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC,6DAA6D;IAC7D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACtE"}

package/dist/agents/types.js

@@ -0,0 +1,8 @@
+/**
+ * Coding agent abstraction types.
+ *
+ * Each supported coding agent (Claude CLI, Cursor, Codex) implements
+ * the CodingAgent interface for unified task implementation dispatch.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/agents/utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Utility functions for the agents module.
+ */
+/**
+ * Check if a command exists on the system PATH.
+ * Returns the path to the command or null.
+ */
+export declare function which(command: string): Promise<string | null>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/agents/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/agents/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;GAGG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQnE"}

package/dist/agents/utils.js

@@ -0,0 +1,21 @@
+/**
+ * Utility functions for the agents module.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Check if a command exists on the system PATH.
+ * Returns the path to the command or null.
+ */
+export async function which(command) {
+    try {
+        const cmd = process.platform === 'win32' ? 'where' : 'which';
+        const { stdout } = await execFileAsync(cmd, [command]);
+        return stdout.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/agents/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/agents/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAe;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/ai/codebase/context-builder.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Orchestrates codebase awareness into a single context string.
+ *
+ * Combines tech stack detection, folder tree, and related file snippets
+ * into a formatted block for inclusion in AI prompts. Respects a token
+ * budget (~8K tokens ≈ 32K chars) to avoid prompt overflow.
+ */
+import { type TechStack } from './stack-detector.js';
+export interface CodebaseContext {
+    techStack: TechStack | null;
+    folderTree: string;
+    relatedFiles: Map<string, string>;
+}
+/**
+ * Build a complete codebase context for AI prompt enrichment.
+ *
+ * @param projectDir - Project root directory
+ * @param keywords - Keywords to find related files (extracted from task/story)
+ */
+export declare function buildCodebaseContext(projectDir: string, keywords?: string[]): Promise<CodebaseContext>;
+/**
+ * Format the codebase context into a prompt-friendly string.
+ * Applies token budget by progressively dropping lower-priority sections.
+ */
+export declare function formatCodebaseContext(ctx: CodebaseContext): string;
+/**
+ * Extract keywords from artifact content for file searching.
+ * Looks for capitalized terms, technical words, and file paths.
+ */
+export declare function extractKeywords(content: string): string[];
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/ai/codebase/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMvF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAM,EAAO,GACtB,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAwClE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BzD"}

package/dist/ai/codebase/context-builder.js

@@ -0,0 +1,93 @@
+/**
+ * Orchestrates codebase awareness into a single context string.
+ *
+ * Combines tech stack detection, folder tree, and related file snippets
+ * into a formatted block for inclusion in AI prompts. Respects a token
+ * budget (~8K tokens ≈ 32K chars) to avoid prompt overflow.
+ */
+import { detectTechStack, formatTechStack } from './stack-detector.js';
+import { generateFolderTree } from './tree-generator.js';
+import { findRelatedFiles, readFileSnippets } from './file-reader.js';
+const MAX_CONTEXT_CHARS = 32_000; // ~8K tokens
+/**
+ * Build a complete codebase context for AI prompt enrichment.
+ *
+ * @param projectDir - Project root directory
+ * @param keywords - Keywords to find related files (extracted from task/story)
+ */
+export async function buildCodebaseContext(projectDir, keywords = []) {
+    const [techStack, folderTree, relatedPaths] = await Promise.all([
+        detectTechStack(projectDir),
+        generateFolderTree(projectDir, 3),
+        findRelatedFiles(projectDir, keywords, 8),
+    ]);
+    const relatedFiles = await readFileSnippets(projectDir, relatedPaths, 12_000);
+    return { techStack, folderTree, relatedFiles };
+}
+/**
+ * Format the codebase context into a prompt-friendly string.
+ * Applies token budget by progressively dropping lower-priority sections.
+ */
+export function formatCodebaseContext(ctx) {
+    const sections = [];
+    // Priority 1: Tech stack (always included, small)
+    if (ctx.techStack) {
+        sections.push(`## Tech Stack\n${formatTechStack(ctx.techStack)}`);
+    }
+    // Priority 2: Folder tree (truncated if needed)
+    if (ctx.folderTree) {
+        const treeLines = ctx.folderTree.split('\n');
+        const maxLines = 60;
+        const truncatedTree = treeLines.length > maxLines
+            ? treeLines.slice(0, maxLines).join('\n') + '\n... (truncated)'
+            : ctx.folderTree;
+        sections.push(`## Project Structure\n\`\`\`\n${truncatedTree}\n\`\`\``);
+    }
+    // Priority 3: Related file snippets (dropped if over budget)
+    if (ctx.relatedFiles.size > 0) {
+        const fileBlocks = [];
+        for (const [filePath, content] of ctx.relatedFiles) {
+            fileBlocks.push(`### ${filePath}\n\`\`\`\n${content}\n\`\`\``);
+        }
+        sections.push(`## Related Files\n${fileBlocks.join('\n\n')}`);
+    }
+    // Apply budget
+    let result = sections.join('\n\n');
+    if (result.length > MAX_CONTEXT_CHARS) {
+        // Drop file snippets first, keep stack + tree
+        result = sections.slice(0, 2).join('\n\n');
+    }
+    if (result.length > MAX_CONTEXT_CHARS) {
+        // Even tree is too large, truncate aggressively
+        result = result.slice(0, MAX_CONTEXT_CHARS) + '\n... (context truncated)';
+    }
+    return result;
+}
+/**
+ * Extract keywords from artifact content for file searching.
+ * Looks for capitalized terms, technical words, and file paths.
+ */
+export function extractKeywords(content) {
+    const keywords = new Set();
+    // Extract file paths
+    const pathMatches = content.match(/[\w/-]+\.\w+/g) || [];
+    for (const p of pathMatches) {
+        const parts = p.split('/');
+        keywords.add(parts[parts.length - 1].replace(/\.\w+$/, ''));
+    }
+    // Extract technical terms (CamelCase or hyphenated)
+    const termMatches = content.match(/[A-Z][a-z]+(?:[A-Z][a-z]+)+|[a-z]+-[a-z]+/g) || [];
+    for (const term of termMatches) {
+        keywords.add(term.toLowerCase());
+    }
+    // Extract quoted terms
+    const quotedMatches = content.match(/"([^"]+)"|'([^']+)'/g) || [];
+    for (const q of quotedMatches) {
+        const clean = q.replace(/['"]/g, '').trim();
+        if (clean.length > 2 && clean.length < 30) {
+            keywords.add(clean.toLowerCase());
+        }
+    }
+    return [...keywords].slice(0, 10);
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/ai/codebase/context-builder.js.map

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

package/dist/ai/codebase/file-reader.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Lightweight codebase file reading utilities.
+ *
+ * NOT a full indexer — just smart file reading for enriching AI prompts
+ * with relevant code context. Files larger than MAX_FILE_SIZE are skipped.
+ */
+/**
+ * Read a single project file with size guard.
+ * Returns null if file is too large or doesn't exist.
+ */
+export declare function readProjectFile(projectDir: string, relativePath: string): Promise<string | null>;
+/**
+ * Find files whose names or paths match any of the given keywords.
+ * Returns relative paths, limited to maxResults.
+ */
+export declare function findRelatedFiles(projectDir: string, keywords: string[], maxResults?: number): Promise<string[]>;
+/**
+ * Read multiple files and return a map of relative paths to truncated content.
+ * Respects a total character budget across all files.
+ */
+export declare function readFileSnippets(projectDir: string, relativePaths: string[], totalBudget?: number): Promise<Map<string, string>>;
+//# sourceMappingURL=file-reader.d.ts.map

package/dist/ai/codebase/file-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/file-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAqDD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,GAAE,MAAe,GAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgB9B"}

package/dist/ai/codebase/file-reader.js

@@ -0,0 +1,111 @@
+/**
+ * Lightweight codebase file reading utilities.
+ *
+ * NOT a full indexer — just smart file reading for enriching AI prompts
+ * with relevant code context. Files larger than MAX_FILE_SIZE are skipped.
+ */
+import path from 'node:path';
+import fse from 'fs-extra';
+const MAX_FILE_SIZE = 50_000; // 50KB per file
+const MAX_SNIPPET_CHARS = 3_000; // Truncate snippets to this length
+const SOURCE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.go', '.rs', '.java', '.kt', '.swift',
+    '.vue', '.svelte', '.astro',
+    '.sql', '.graphql', '.gql',
+    '.css', '.scss', '.less',
+    '.json', '.yaml', '.yml', '.toml',
+    '.md', '.mdx',
+]);
+const IGNORED_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', 'out', '.next',
+    '__pycache__', 'vendor', 'target', '.venv', 'coverage',
+]);
+/**
+ * Read a single project file with size guard.
+ * Returns null if file is too large or doesn't exist.
+ */
+export async function readProjectFile(projectDir, relativePath) {
+    const fullPath = path.join(projectDir, relativePath);
+    try {
+        const stat = await fse.stat(fullPath);
+        if (stat.size > MAX_FILE_SIZE)
+            return null;
+        return await fse.readFile(fullPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find files whose names or paths match any of the given keywords.
+ * Returns relative paths, limited to maxResults.
+ */
+export async function findRelatedFiles(projectDir, keywords, maxResults = 10) {
+    if (keywords.length === 0)
+        return [];
+    const lowerKeywords = keywords.map((k) => k.toLowerCase());
+    const matches = [];
+    await searchDir(projectDir, projectDir, lowerKeywords, matches, maxResults, 0);
+    return matches;
+}
+async function searchDir(rootDir, currentDir, keywords, matches, maxResults, depth) {
+    if (depth > 5 || matches.length >= maxResults)
+        return;
+    let entries;
+    try {
+        entries = await fse.readdir(currentDir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (matches.length >= maxResults)
+            return;
+        if (IGNORED_DIRS.has(entry) || entry.startsWith('.'))
+            continue;
+        const fullPath = path.join(currentDir, entry);
+        try {
+            const stat = await fse.stat(fullPath);
+            if (stat.isDirectory()) {
+                await searchDir(rootDir, fullPath, keywords, matches, maxResults, depth + 1);
+            }
+            else if (isSourceFile(entry)) {
+                const lowerEntry = entry.toLowerCase();
+                const relativePath = path.relative(rootDir, fullPath);
+                const lowerPath = relativePath.toLowerCase();
+                const isMatch = keywords.some((kw) => lowerEntry.includes(kw) || lowerPath.includes(kw));
+                if (isMatch) {
+                    matches.push(relativePath);
+                }
+            }
+        }
+        catch {
+            // Skip inaccessible entries
+        }
+    }
+}
+function isSourceFile(filename) {
+    const ext = path.extname(filename).toLowerCase();
+    return SOURCE_EXTENSIONS.has(ext);
+}
+/**
+ * Read multiple files and return a map of relative paths to truncated content.
+ * Respects a total character budget across all files.
+ */
+export async function readFileSnippets(projectDir, relativePaths, totalBudget = 12_000) {
+    const result = new Map();
+    let remaining = totalBudget;
+    for (const relPath of relativePaths) {
+        if (remaining <= 0)
+            break;
+        const content = await readProjectFile(projectDir, relPath);
+        if (!content)
+            continue;
+        const truncated = content.slice(0, Math.min(MAX_SNIPPET_CHARS, remaining));
+        result.set(relPath, truncated);
+        remaining -= truncated.length;
+    }
+    return result;
+}
+//# sourceMappingURL=file-reader.js.map

package/dist/ai/codebase/file-reader.js.map

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

package/dist/ai/codebase/index.d.ts

@@ -0,0 +1,5 @@
+export { detectTechStack, formatTechStack, type TechStack } from './stack-detector.js';
+export { generateFolderTree } from './tree-generator.js';
+export { readProjectFile, findRelatedFiles, readFileSnippets } from './file-reader.js';
+export { buildCodebaseContext, formatCodebaseContext, extractKeywords, type CodebaseContext, } from './context-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/codebase/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/ai/codebase/index.js

@@ -0,0 +1,5 @@
+export { detectTechStack, formatTechStack } from './stack-detector.js';
+export { generateFolderTree } from './tree-generator.js';
+export { readProjectFile, findRelatedFiles, readFileSnippets } from './file-reader.js';
+export { buildCodebaseContext, formatCodebaseContext, extractKeywords, } from './context-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/codebase/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/codebase/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,GAEhB,MAAM,sBAAsB,CAAC"}

package/dist/ai/codebase/stack-detector.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Detects the tech stack of a project by reading manifest files.
+ *
+ * Looks for package.json (Node.js), go.mod (Go), requirements.txt / pyproject.toml
+ * (Python), Cargo.toml (Rust), and more. Returns a structured TechStack object
+ * used to enrich AI prompts with codebase awareness.
+ */
+export interface TechStack {
+    language: string;
+    framework?: string;
+    packageManager?: string;
+    dependencies: string[];
+    devDependencies: string[];
+}
+export declare function detectTechStack(projectDir: string): Promise<TechStack | null>;
+/** Format tech stack as a human-readable string for prompt injection. */
+export declare function formatTechStack(stack: TechStack): string;
+//# sourceMappingURL=stack-detector.d.ts.map

package/dist/ai/codebase/stack-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-detector.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/stack-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA4GD,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAanF;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CASxD"}