openplanr 0.1.0 → 0.3.0

package/dist/ai/codebase/stack-detector.js

@@ -0,0 +1,147 @@
+/**
+ * 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.
+ */
+import path from 'node:path';
+import { fileExists, readFile } from '../../utils/fs.js';
+const DETECTORS = [
+    {
+        file: 'package.json',
+        detect: async (content) => {
+            const pkg = JSON.parse(content);
+            const deps = Object.keys(pkg.dependencies || {});
+            const devDeps = Object.keys(pkg.devDependencies || {});
+            const allDeps = [...deps, ...devDeps];
+            let framework;
+            if (allDeps.includes('next'))
+                framework = 'Next.js';
+            else if (allDeps.includes('nuxt'))
+                framework = 'Nuxt';
+            else if (allDeps.includes('react'))
+                framework = 'React';
+            else if (allDeps.includes('vue'))
+                framework = 'Vue';
+            else if (allDeps.includes('svelte'))
+                framework = 'Svelte';
+            else if (allDeps.includes('@angular/core'))
+                framework = 'Angular';
+            else if (allDeps.includes('express'))
+                framework = 'Express';
+            else if (allDeps.includes('fastify'))
+                framework = 'Fastify';
+            else if (allDeps.includes('hono'))
+                framework = 'Hono';
+            else if (allDeps.includes('nestjs'))
+                framework = 'NestJS';
+            const hasTS = allDeps.includes('typescript');
+            const language = hasTS ? 'TypeScript' : 'JavaScript';
+            let packageManager = 'npm';
+            if (pkg.packageManager?.startsWith('pnpm'))
+                packageManager = 'pnpm';
+            else if (pkg.packageManager?.startsWith('yarn'))
+                packageManager = 'yarn';
+            else if (pkg.packageManager?.startsWith('bun'))
+                packageManager = 'bun';
+            return {
+                language,
+                framework,
+                packageManager,
+                dependencies: deps.slice(0, 20),
+                devDependencies: devDeps.slice(0, 10),
+            };
+        },
+    },
+    {
+        file: 'go.mod',
+        detect: async (content) => {
+            const moduleMatch = content.match(/^module\s+(.+)$/m);
+            const deps = [...content.matchAll(/^\t(\S+)\s/gm)].map((m) => m[1]).slice(0, 20);
+            return {
+                language: 'Go',
+                framework: deps.find((d) => d.includes('gin')) ? 'Gin' :
+                    deps.find((d) => d.includes('fiber')) ? 'Fiber' :
+                        deps.find((d) => d.includes('echo')) ? 'Echo' : undefined,
+                packageManager: 'go modules',
+                dependencies: deps,
+                devDependencies: [],
+            };
+        },
+    },
+    {
+        file: 'requirements.txt',
+        detect: async (content) => {
+            const deps = content.split('\n').filter((l) => l.trim() && !l.startsWith('#')).map((l) => l.split('==')[0].split('>=')[0].trim()).slice(0, 20);
+            return {
+                language: 'Python',
+                framework: deps.find((d) => d === 'django') ? 'Django' :
+                    deps.find((d) => d === 'flask') ? 'Flask' :
+                        deps.find((d) => d === 'fastapi') ? 'FastAPI' : undefined,
+                packageManager: 'pip',
+                dependencies: deps,
+                devDependencies: [],
+            };
+        },
+    },
+    {
+        file: 'pyproject.toml',
+        detect: async (content) => {
+            const deps = [...content.matchAll(/"([a-zA-Z][\w-]*)(?:[><=!]|")/g)].map((m) => m[1]).slice(0, 20);
+            return {
+                language: 'Python',
+                framework: deps.find((d) => d === 'django') ? 'Django' :
+                    deps.find((d) => d === 'flask') ? 'Flask' :
+                        deps.find((d) => d === 'fastapi') ? 'FastAPI' : undefined,
+                packageManager: content.includes('[tool.poetry]') ? 'poetry' : 'pip',
+                dependencies: deps,
+                devDependencies: [],
+            };
+        },
+    },
+    {
+        file: 'Cargo.toml',
+        detect: async (content) => {
+            const deps = [...content.matchAll(/^(\w[\w-]*)\s*=/gm)].map((m) => m[1]).filter((d) => d !== 'name' && d !== 'version' && d !== 'edition').slice(0, 20);
+            return {
+                language: 'Rust',
+                framework: deps.find((d) => d === 'actix-web') ? 'Actix' :
+                    deps.find((d) => d === 'axum') ? 'Axum' :
+                        deps.find((d) => d === 'rocket') ? 'Rocket' : undefined,
+                packageManager: 'cargo',
+                dependencies: deps,
+                devDependencies: [],
+            };
+        },
+    },
+];
+export async function detectTechStack(projectDir) {
+    for (const detector of DETECTORS) {
+        const filePath = path.join(projectDir, detector.file);
+        if (await fileExists(filePath)) {
+            try {
+                const content = await readFile(filePath);
+                return await detector.detect(content, projectDir);
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}
+/** Format tech stack as a human-readable string for prompt injection. */
+export function formatTechStack(stack) {
+    const parts = [];
+    parts.push(`Language: ${stack.language}`);
+    if (stack.framework)
+        parts.push(`Framework: ${stack.framework}`);
+    if (stack.packageManager)
+        parts.push(`Package Manager: ${stack.packageManager}`);
+    if (stack.dependencies.length > 0) {
+        parts.push(`Key Dependencies: ${stack.dependencies.join(', ')}`);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=stack-detector.js.map

package/dist/ai/codebase/stack-detector.js.map

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

package/dist/ai/codebase/tree-generator.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates an ASCII folder tree of a project.
+ *
+ * Used to give the AI a quick overview of the project structure
+ * without reading every file. Ignores common non-source directories.
+ */
+export declare function generateFolderTree(projectDir: string, maxDepth?: number): Promise<string>;
+//# sourceMappingURL=tree-generator.d.ts.map

package/dist/ai/codebase/tree-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-generator.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/tree-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmCH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/ai/codebase/tree-generator.js

@@ -0,0 +1,85 @@
+/**
+ * Generates an ASCII folder tree of a project.
+ *
+ * Used to give the AI a quick overview of the project structure
+ * without reading every file. Ignores common non-source directories.
+ */
+import path from 'node:path';
+import fse from 'fs-extra';
+const IGNORED_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.nuxt',
+    '.svelte-kit',
+    '__pycache__',
+    '.pytest_cache',
+    'vendor',
+    'target',
+    '.venv',
+    'venv',
+    '.tox',
+    'coverage',
+    '.nyc_output',
+    '.cache',
+    '.turbo',
+    '.vercel',
+    '.output',
+]);
+const IGNORED_FILES = new Set([
+    '.DS_Store',
+    'Thumbs.db',
+    '.gitkeep',
+]);
+export async function generateFolderTree(projectDir, maxDepth = 3) {
+    const lines = [];
+    const rootName = path.basename(projectDir);
+    lines.push(rootName + '/');
+    await walkDir(projectDir, '', maxDepth, 0, lines);
+    return lines.join('\n');
+}
+async function walkDir(dirPath, prefix, maxDepth, currentDepth, lines) {
+    if (currentDepth >= maxDepth)
+        return;
+    let entries;
+    try {
+        entries = await fse.readdir(dirPath);
+    }
+    catch {
+        return;
+    }
+    // Filter and sort: directories first, then files
+    const filtered = entries.filter((e) => !IGNORED_DIRS.has(e) && !IGNORED_FILES.has(e) && !e.startsWith('.'));
+    const dirs = [];
+    const files = [];
+    for (const entry of filtered) {
+        const fullPath = path.join(dirPath, entry);
+        try {
+            const stat = await fse.stat(fullPath);
+            if (stat.isDirectory())
+                dirs.push(entry);
+            else
+                files.push(entry);
+        }
+        catch {
+            // Skip inaccessible entries
+        }
+    }
+    const sorted = [...dirs.sort(), ...files.sort()];
+    const total = sorted.length;
+    for (let i = 0; i < total; i++) {
+        const entry = sorted[i];
+        const isLast = i === total - 1;
+        const connector = isLast ? '└── ' : '├── ';
+        const childPrefix = isLast ? '    ' : '│   ';
+        const isDir = dirs.includes(entry);
+        lines.push(`${prefix}${connector}${entry}${isDir ? '/' : ''}`);
+        if (isDir) {
+            await walkDir(path.join(dirPath, entry), prefix + childPrefix, maxDepth, currentDepth + 1, lines);
+        }
+    }
+}
+//# sourceMappingURL=tree-generator.js.map

package/dist/ai/codebase/tree-generator.js.map

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

package/dist/ai/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Unified error class for AI provider failures.
+ *
+ * Normalizes provider-specific errors (Anthropic 429, OpenAI 401, Ollama ECONNREFUSED)
+ * into a consistent format the rest of the application can handle.
+ */
+export type AIErrorCode = 'auth' | 'rate_limit' | 'overloaded' | 'connection' | 'invalid_response' | 'unknown';
+export declare class AIError extends Error {
+    readonly code: AIErrorCode;
+    readonly retryable: boolean;
+    readonly retryAfterMs?: number | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, code: AIErrorCode, retryable?: boolean, retryAfterMs?: number | undefined, cause?: unknown | undefined);
+    /** User-friendly description with actionable guidance. */
+    get userMessage(): string;
+}
+/**
+ * Wrap any provider-specific error into a normalized AIError.
+ * Each provider adapter calls this to unify error handling.
+ */
+export declare function wrapProviderError(err: unknown, provider: string): AIError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/ai/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ai/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,kBAAkB,GAClB,SAAS,CAAC;AAEd,qBAAa,OAAQ,SAAQ,KAAK;aAGd,IAAI,EAAE,WAAW;aACjB,SAAS,EAAE,OAAO;aAClB,YAAY,CAAC,EAAE,MAAM;aACrB,KAAK,CAAC,EAAE,OAAO;gBAJ/B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,WAAW,EACjB,SAAS,GAAE,OAAe,EAC1B,YAAY,CAAC,EAAE,MAAM,YAAA,EACrB,KAAK,CAAC,EAAE,OAAO,YAAA;IAMjC,0DAA0D;IAC1D,IAAI,WAAW,IAAI,MAAM,CAexB;CACF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA8BzE"}

package/dist/ai/errors.js

@@ -0,0 +1,70 @@
+/**
+ * Unified error class for AI provider failures.
+ *
+ * Normalizes provider-specific errors (Anthropic 429, OpenAI 401, Ollama ECONNREFUSED)
+ * into a consistent format the rest of the application can handle.
+ */
+export class AIError extends Error {
+    code;
+    retryable;
+    retryAfterMs;
+    cause;
+    constructor(message, code, retryable = false, retryAfterMs, cause) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.retryAfterMs = retryAfterMs;
+        this.cause = cause;
+        this.name = 'AIError';
+    }
+    /** User-friendly description with actionable guidance. */
+    get userMessage() {
+        switch (this.code) {
+            case 'auth':
+                return 'Invalid API key. Run `planr config set-key <provider>` to update.';
+            case 'rate_limit':
+                return 'Rate limited. Please wait a moment and try again.';
+            case 'overloaded':
+                return 'AI provider is overloaded. Please try again in a few seconds.';
+            case 'connection':
+                return 'Cannot connect to AI provider. Check your network or if Ollama is running.';
+            case 'invalid_response':
+                return 'AI returned an invalid response. Try again or use --manual mode.';
+            default:
+                return this.message;
+        }
+    }
+}
+/**
+ * Wrap any provider-specific error into a normalized AIError.
+ * Each provider adapter calls this to unify error handling.
+ */
+export function wrapProviderError(err, provider) {
+    if (err instanceof AIError)
+        return err;
+    const error = err;
+    const status = error?.status;
+    const code = error?.code;
+    const message = error?.message || String(err);
+    // Connection errors (Ollama not running, network down)
+    if (code === 'ECONNREFUSED' || code === 'ENOTFOUND' || code === 'ETIMEDOUT') {
+        const hint = provider === 'ollama'
+            ? 'Is Ollama running? Start with `ollama serve`.'
+            : 'Check your internet connection.';
+        return new AIError(`Connection failed: ${hint}`, 'connection', true, 5000, err);
+    }
+    // HTTP status-based errors
+    if (status === 401 || status === 403) {
+        return new AIError(`Authentication failed for ${provider}.`, 'auth', false, undefined, err);
+    }
+    if (status === 429) {
+        const retryAfter = error?.headers?.['retry-after'];
+        const retryMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : 2000;
+        return new AIError('Rate limited by AI provider.', 'rate_limit', true, retryMs, err);
+    }
+    if (status === 529 || status === 503) {
+        return new AIError('AI provider is overloaded.', 'overloaded', true, 3000, err);
+    }
+    return new AIError(message, 'unknown', false, undefined, err);
+}
+//# sourceMappingURL=errors.js.map

package/dist/ai/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/ai/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAGd;IACA;IACA;IACA;IALlB,YACE,OAAe,EACC,IAAiB,EACjB,YAAqB,KAAK,EAC1B,YAAqB,EACrB,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAa;QACjB,cAAS,GAAT,SAAS,CAAiB;QAC1B,iBAAY,GAAZ,YAAY,CAAS;QACrB,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;IAED,0DAA0D;IAC1D,IAAI,WAAW;QACb,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,MAAM;gBACT,OAAO,mEAAmE,CAAC;YAC7E,KAAK,YAAY;gBACf,OAAO,mDAAmD,CAAC;YAC7D,KAAK,YAAY;gBACf,OAAO,+DAA+D,CAAC;YACzE,KAAK,YAAY;gBACf,OAAO,4EAA4E,CAAC;YACtF,KAAK,kBAAkB;gBACrB,OAAO,kEAAkE,CAAC;YAC5E;gBACE,OAAO,IAAI,CAAC,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY,EAAE,QAAgB;IAC9D,IAAI,GAAG,YAAY,OAAO;QAAE,OAAO,GAAG,CAAC;IAEvC,MAAM,KAAK,GAAG,GAA8B,CAAC;IAC7C,MAAM,MAAM,GAAG,KAAK,EAAE,MAA4B,CAAC;IACnD,MAAM,IAAI,GAAG,KAAK,EAAE,IAA0B,CAAC;IAC/C,MAAM,OAAO,GAAG,KAAK,EAAE,OAAiB,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IAExD,uDAAuD;IACvD,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QAC5E,MAAM,IAAI,GAAG,QAAQ,KAAK,QAAQ;YAChC,CAAC,CAAC,+CAA+C;YACjD,CAAC,CAAC,iCAAiC,CAAC;QACtC,OAAO,IAAI,OAAO,CAAC,sBAAsB,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,2BAA2B;IAC3B,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,OAAO,CAAC,6BAA6B,QAAQ,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,MAAM,UAAU,GAAI,KAAK,EAAE,OAAkC,EAAE,CAAC,aAAa,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACpE,OAAO,IAAI,OAAO,CAAC,8BAA8B,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,OAAO,CAAC,4BAA4B,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;AAChE,CAAC"}

package/dist/ai/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AI module public API.
+ *
+ * Re-exports the provider abstraction, factory, and error types.
+ * All AI functionality is accessed through this barrel export.
+ */
+export type { AIProvider, AIMessage, AIRequestOptions, AIProviderConfig, AIProviderName, CodingAgentName, } from './types.js';
+export { DEFAULT_MODELS, ENV_KEY_MAP } from './types.js';
+export { AIError, wrapProviderError } from './errors.js';
+export { createAIProvider } from './provider-factory.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,10 @@
+/**
+ * AI module public API.
+ *
+ * Re-exports the provider abstraction, factory, and error types.
+ * All AI functionality is accessed through this barrel export.
+ */
+export { DEFAULT_MODELS, ENV_KEY_MAP } from './types.js';
+export { AIError, wrapProviderError } from './errors.js';
+export { createAIProvider } from './provider-factory.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/ai/prompts/prompt-builder.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Prompt composition for each artifact type.
+ *
+ * Each builder assembles a message array with:
+ * 1. Expert system prompt
+ * 2. User context (brief, parent artifacts, existing siblings, codebase)
+ *
+ * Existing sibling titles are injected to prevent the AI from
+ * generating duplicate artifacts.
+ */
+import type { AIMessage } from '../types.js';
+export declare function buildEpicPrompt(brief: string, existingEpics?: string[]): AIMessage[];
+export declare function buildFeaturesPrompt(epicContent: string, existingFeatures?: string[], featureCount?: number): AIMessage[];
+export declare function buildStoriesPrompt(featureContent: string, epicContext: string, existingStories?: string[]): AIMessage[];
+export interface TasksPromptInput {
+    stories: Array<{
+        id: string;
+        raw: string;
+    }>;
+    gherkinScenarios?: Array<{
+        storyId: string;
+        content: string;
+    }>;
+    featureRaw?: string;
+    epicRaw?: string;
+    adrs?: Array<{
+        id: string;
+        content: string;
+    }>;
+    codebaseContext?: string;
+    /** When set, tells the AI the creation scope for naming the task list title. */
+    scope?: {
+        type: 'feature';
+        id: string;
+    } | {
+        type: 'story';
+        id: string;
+    };
+}
+export declare function buildTasksPrompt(ctx: TasksPromptInput): AIMessage[];
+export declare function buildRefinePrompt(artifactContent: string, artifactType: string): AIMessage[];
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/ai/prompts/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/ai/prompts/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,MAAM,EAAO,GAC3B,SAAS,EAAE,CAWb;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,GAAE,MAAM,EAAO,EAC/B,YAAY,CAAC,EAAE,MAAM,GACpB,SAAS,EAAE,CAeb;AAED,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,eAAe,GAAE,MAAM,EAAO,GAC7B,SAAS,EAAE,CAYb;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,EAAE,CAqDnE;AAED,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,SAAS,EAAE,CAOb"}

package/dist/ai/prompts/prompt-builder.js

@@ -0,0 +1,96 @@
+/**
+ * Prompt composition for each artifact type.
+ *
+ * Each builder assembles a message array with:
+ * 1. Expert system prompt
+ * 2. User context (brief, parent artifacts, existing siblings, codebase)
+ *
+ * Existing sibling titles are injected to prevent the AI from
+ * generating duplicate artifacts.
+ */
+import { EPIC_SYSTEM_PROMPT, FEATURES_SYSTEM_PROMPT, STORIES_SYSTEM_PROMPT, TASKS_SYSTEM_PROMPT, REFINE_SYSTEM_PROMPT, } from './system-prompts.js';
+export function buildEpicPrompt(brief, existingEpics = []) {
+    let userContent = `Create an epic from this brief:\n\n"${brief}"`;
+    if (existingEpics.length > 0) {
+        userContent += `\n\nExisting epics in this project (do NOT duplicate):\n${existingEpics.map((e) => `- ${e}`).join('\n')}`;
+    }
+    return [
+        { role: 'system', content: EPIC_SYSTEM_PROMPT },
+        { role: 'user', content: userContent },
+    ];
+}
+export function buildFeaturesPrompt(epicContent, existingFeatures = [], featureCount) {
+    let userContent = `Decompose this epic into features:\n\n${epicContent}`;
+    if (featureCount) {
+        userContent += `\n\nGenerate approximately ${featureCount} features.`;
+    }
+    if (existingFeatures.length > 0) {
+        userContent += `\n\nExisting features for this epic (do NOT duplicate):\n${existingFeatures.map((f) => `- ${f}`).join('\n')}`;
+    }
+    return [
+        { role: 'system', content: FEATURES_SYSTEM_PROMPT },
+        { role: 'user', content: userContent },
+    ];
+}
+export function buildStoriesPrompt(featureContent, epicContext, existingStories = []) {
+    let userContent = `Generate user stories for this feature:\n\n${featureContent}`;
+    userContent += `\n\n--- Parent Epic Context ---\n${epicContext}`;
+    if (existingStories.length > 0) {
+        userContent += `\n\nExisting stories for this feature (do NOT duplicate):\n${existingStories.map((s) => `- ${s}`).join('\n')}`;
+    }
+    return [
+        { role: 'system', content: STORIES_SYSTEM_PROMPT },
+        { role: 'user', content: userContent },
+    ];
+}
+export function buildTasksPrompt(ctx) {
+    const sections = [];
+    // User stories
+    sections.push('--- User Stories ---');
+    for (const story of ctx.stories) {
+        sections.push(`\n[${story.id}]\n${story.raw}`);
+    }
+    // Gherkin acceptance criteria
+    if (ctx.gherkinScenarios && ctx.gherkinScenarios.length > 0) {
+        sections.push('\n--- Gherkin Acceptance Criteria ---');
+        for (const g of ctx.gherkinScenarios) {
+            sections.push(`\n[Gherkin for ${g.storyId}]\n${g.content}`);
+        }
+    }
+    // Parent feature context
+    if (ctx.featureRaw) {
+        sections.push(`\n--- Parent Feature Context ---\n${ctx.featureRaw}`);
+    }
+    // Parent epic context
+    if (ctx.epicRaw) {
+        sections.push(`\n--- Parent Epic Context ---\n${ctx.epicRaw}`);
+    }
+    // Architecture decision records
+    if (ctx.adrs && ctx.adrs.length > 0) {
+        sections.push('\n--- Architecture Decision Records ---');
+        for (const adr of ctx.adrs) {
+            sections.push(`\n[${adr.id}]\n${adr.content}`);
+        }
+    }
+    // Codebase context
+    if (ctx.codebaseContext) {
+        sections.push(`\n--- Codebase Context ---\n${ctx.codebaseContext}`);
+    }
+    // Add scope hint so the AI titles the task list correctly
+    if (ctx.scope) {
+        sections.push(`\n--- Scope ---\nThis task list is being generated at ${ctx.scope.type} level for ${ctx.scope.id}. Title the task list as "Tasks for ${ctx.scope.id}: <descriptive name>".`);
+    }
+    const userContent = `Generate implementation tasks from the following agile artifacts:\n\n${sections.join('\n')}`;
+    return [
+        { role: 'system', content: TASKS_SYSTEM_PROMPT },
+        { role: 'user', content: userContent },
+    ];
+}
+export function buildRefinePrompt(artifactContent, artifactType) {
+    const userContent = `Review and improve this ${artifactType} artifact. The "improvedMarkdown" in your response must preserve the same file format (YAML frontmatter + markdown body) as shown below:\n\n${artifactContent}`;
+    return [
+        { role: 'system', content: REFINE_SYSTEM_PROMPT },
+        { role: 'user', content: userContent },
+    ];
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/ai/prompts/prompt-builder.js.map

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

package/dist/ai/prompts/system-prompts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Expert system prompts for AI-powered agile planning.
+ *
+ * Each prompt establishes the AI as a specialized agile consultant
+ * and instructs it to produce structured JSON output matching our
+ * artifact schemas.
+ */
+export declare const EPIC_SYSTEM_PROMPT = "You are an expert agile planning consultant with deep experience in software development, product management, and technical architecture. You help teams create clear, actionable, and well-structured planning artifacts.\n\nYour task is to expand a brief description into a complete, detailed epic document.\n\nYou MUST respond with a valid JSON object containing these fields:\n- \"title\": A concise, descriptive epic title (max 80 chars)\n- \"owner\": The responsible team or role (e.g., \"Engineering\", \"Product\", \"Platform Team\")\n- \"businessValue\": Why this matters to the business (2-3 sentences)\n- \"targetUsers\": Who benefits from this (specific user personas)\n- \"problemStatement\": The problem being solved (2-3 sentences)\n- \"solutionOverview\": High-level approach to solving it (2-3 sentences)\n- \"successCriteria\": Array of 3-5 measurable definition-of-done bullet points (e.g., [\"Users can X within Y seconds\", \"System supports Z\"])\n- \"keyFeatures\": Array of 3-7 high-level feature names that compose this epic\n- \"dependencies\": Known dependencies or \"None\"\n- \"risks\": Known risks or \"None\"\n\nBe specific, avoid generic filler. Ground the epic in the user's brief.\nRespond with JSON only, no markdown or explanation.";
+export declare const FEATURES_SYSTEM_PROMPT = "You are an expert agile planning consultant with deep experience in software development, product management, and technical architecture. You help teams create clear, actionable, and well-structured planning artifacts.\n\nYour task is to decompose an epic into individual features. Read the epic carefully and generate features that fully cover its scope.\n\nYou MUST respond with a valid JSON object containing:\n- \"features\": An array of feature objects, each with:\n  - \"title\": A clear feature title (max 80 chars)\n  - \"overview\": What this feature does (2-3 sentences)\n  - \"functionalRequirements\": Array of 3-6 specific functional requirements\n  - \"dependencies\": Dependencies on other features or systems, or \"None\"\n  - \"technicalConsiderations\": Technical notes for implementation, or \"None\"\n  - \"risks\": Feature-specific risks, or \"None\"\n  - \"successMetrics\": How to measure success of this feature\n\nGenerate features that are:\n- Independently deliverable where possible\n- Roughly equal in scope\n- Non-overlapping (no duplicate functionality)\n\nRespond with JSON only, no markdown or explanation.";
+export declare const STORIES_SYSTEM_PROMPT = "You are an expert agile planning consultant with deep experience in software development, product management, and technical architecture. You help teams create clear, actionable, and well-structured planning artifacts.\n\nYour task is to break a feature into user stories. Read the feature and its parent epic context carefully.\n\nYou MUST respond with a valid JSON object containing:\n- \"stories\": An array of story objects, each with:\n  - \"title\": Concise story title (max 80 chars)\n  - \"role\": The user role (\"As a <role>\")\n  - \"goal\": What they want to do (\"I want to <goal>\")\n  - \"benefit\": Why (\"So that <benefit>\")\n  - \"additionalNotes\": Implementation notes or edge cases (optional, can be empty string)\n  - \"gherkinScenarios\": Array of scenario objects, each with:\n    - \"name\": Scenario name\n    - \"given\": Given precondition\n    - \"when\": When action\n    - \"then\": Then expected outcome\n\nEach story should:\n- Follow INVEST principles (Independent, Negotiable, Valuable, Estimable, Small, Testable)\n- Include 1-3 Gherkin scenarios (happy path + edge cases)\n- Be specific enough for a developer to implement\n\nRespond with JSON only, no markdown or explanation.";
+export declare const TASKS_SYSTEM_PROMPT = "You are an expert agile planning consultant with deep experience in software development, product management, and technical architecture. You help teams create clear, actionable, and well-structured planning artifacts.\n\nYour task is to generate a comprehensive implementation task list from agile artifacts (user stories, gherkin acceptance criteria, feature specs, epic context, ADRs, and codebase context).\n\nYou MUST respond with a valid JSON object containing:\n- \"title\": A task list title \u2014 use the scope ID if provided (e.g., \"Tasks for FEAT-001: Feature Name\" when scope is a feature, or \"Tasks for US-001: Story Name\" when scope is a story)\n- \"tasks\": An array of task group objects, each with:\n  - \"id\": Numbering like \"1.0\", \"2.0\", \"3.0\"\n  - \"title\": Task group title\n  - \"subtasks\": Array of subtask objects, each with:\n    - \"id\": Numbering like \"1.1\", \"1.2\", \"2.1\"\n    - \"title\": Specific, actionable subtask description\n- \"acceptanceCriteriaMapping\": Array of objects mapping acceptance criteria to tasks:\n  - \"criterion\": The acceptance criterion text (from gherkin scenarios or story requirements)\n  - \"sourceStoryId\": Which user story this criterion comes from (e.g., \"US-001\")\n  - \"taskIds\": Array of task/subtask IDs that satisfy this criterion (e.g., [\"1.1\", \"2.3\"])\n- \"relevantFiles\": Array of files to create or modify:\n  - \"path\": File path relative to project root (e.g., \"src/auth/login.ts\")\n  - \"reason\": Brief explanation of why this file needs changes\n\nTasks should:\n- Reference actual files/paths from the codebase when possible\n- Follow existing code patterns and conventions\n- Include setup, implementation, testing, and cleanup steps\n- Be ordered logically (dependencies first)\n- Address specific acceptance criteria from gherkin scenarios\n- Respect architectural decisions from ADRs when provided\n- Align with component structure and system architecture\n\nWhen multiple user stories and gherkin scenarios are provided, ensure every acceptance criterion is covered by at least one task. When codebase context is available, identify specific files to modify in relevantFiles.\n\nRespond with JSON only, no markdown or explanation.";
+export declare const REFINE_SYSTEM_PROMPT = "You are an expert agile planning consultant with deep experience in software development, product management, and technical architecture. You help teams create clear, actionable, and well-structured planning artifacts.\n\nYour task is to review and improve an existing agile artifact. Analyze the content and suggest improvements for:\n- Clarity and specificity\n- Missing details or edge cases\n- Consistency with agile best practices\n- Technical accuracy\n\nYou MUST respond with a valid JSON object containing:\n- \"suggestions\": Array of improvement suggestions (strings)\n- \"improved\": The improved artifact data as a JSON object with the same fields as the original frontmatter\n- \"improvedMarkdown\": A raw markdown string that will be written directly to a .md file. It MUST preserve the original file format: YAML frontmatter between --- delimiters followed by the markdown body. Do NOT put JSON in this field.\n\nCRITICAL: The \"improvedMarkdown\" field must be a plain markdown string, NOT a JSON object. It should look exactly like the original artifact the user provided, but with improvements applied. For example, if the original starts with:\n---\nid: \"EPIC-001\"\ntitle: \"My Epic\"\n---\n# EPIC-001: My Epic\n...then \"improvedMarkdown\" must also start with --- frontmatter and contain markdown content. Keep the same structure and sections as the original.\n\nRespond with JSON only, no markdown or explanation.";
+//# sourceMappingURL=system-prompts.d.ts.map

package/dist/ai/prompts/system-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompts.d.ts","sourceRoot":"","sources":["../../../src/ai/prompts/system-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,kBAAkB,ovCAiBqB,CAAC;AAErD,eAAO,MAAM,sBAAsB,wnCAmBiB,CAAC;AAErD,eAAO,MAAM,qBAAqB,osCAsBkB,CAAC;AAErD,eAAO,MAAM,mBAAmB,0sEA+BoB,CAAC;AAErD,eAAO,MAAM,oBAAoB,k6CAqBmB,CAAC"}