openplanr 0.1.0 → 0.2.0

package/dist/cli/commands/feature.js

@@ -1,54 +1,50 @@
+/**
+ * `planr feature` command group.
+ *
+ * AI-powered by default: reads the parent epic and generates
+ * multiple features automatically. Use --manual for legacy mode.
+ */
 import { loadConfig } from '../../services/config-service.js';
-import { createArtifact, listArtifacts, readArtifact } from '../../services/artifact-service.js';
-import { promptText, promptMultiText } from '../../services/prompt-service.js';
+import { createArtifact, listArtifacts, readArtifact, readArtifactRaw, resolveArtifactFilename, addChildReference, } from '../../services/artifact-service.js';
+import { isAIConfigured, getAIProvider, generateStreamingJSON } from '../../services/ai-service.js';
+import { promptText, promptMultiText, promptConfirm } from '../../services/prompt-service.js';
+import { buildFeaturesPrompt } from '../../ai/prompts/prompt-builder.js';
+import { aiFeaturesResponseSchema } from '../../ai/schemas/ai-response-schemas.js';
 import { logger } from '../../utils/logger.js';
+import chalk from 'chalk';
 export function registerFeatureCommand(program) {
     const feature = program.command('feature').description('Manage features');
     feature
         .command('create')
-        .description('Create a new feature from an epic')
+        .description('Create features from an epic')
         .requiredOption('--epic <epicId>', 'parent epic ID (e.g., EPIC-001)')
         .option('--title <title>', 'feature title')
+        .option('--count <n>', 'number of features to generate', parseInt)
+        .option('--manual', 'use manual interactive prompts instead of AI')
         .action(async (opts) => {
         const projectDir = program.opts().projectDir;
         const config = await loadConfig(projectDir);
-        // Verify epic exists
         const epicData = await readArtifact(projectDir, config, 'epic', opts.epic);
         if (!epicData) {
             logger.error(`Epic ${opts.epic} not found.`);
             process.exit(1);
         }
-        logger.heading(`Create Feature (from ${opts.epic})`);
-        const title = opts.title || (await promptText('Feature title:'));
-        const owner = await promptText('Owner:', config.author);
-        const overview = await promptText('Overview:');
-        const functionalRequirements = await promptMultiText('Functional requirements', 'comma-separated');
-        const dependencies = await promptText('Dependencies:', 'None');
-        const technicalConsiderations = await promptText('Technical considerations:', 'None');
-        const risks = await promptText('Risks:', 'None');
-        const successMetrics = await promptText('Success metrics:');
-        const { id, filePath } = await createArtifact(projectDir, config, 'feature', 'features/feature.md.hbs', {
-            title,
-            epicId: opts.epic,
-            owner,
-            overview,
-            functionalRequirements,
-            dependencies,
-            technicalConsiderations,
-            risks,
-            successMetrics,
-            storyIds: [],
-        });
-        logger.success(`Created feature ${id}: ${title}`);
-        logger.dim(`  ${filePath}`);
-        logger.dim('');
-        logger.dim(`Next: planr story create --feature ${id}`);
+        const useAI = !opts.manual && isAIConfigured(config);
+        if (useAI) {
+            await createFeaturesWithAI(projectDir, config, opts.epic, opts.count);
+        }
+        else {
+            if (!opts.manual && !isAIConfigured(config)) {
+                logger.warn('AI not configured. Using manual mode.');
+            }
+            await createFeatureManually(projectDir, config, opts);
+        }
     });
     feature
         .command('list')
         .description('List features')
         .option('--epic <epicId>', 'filter by epic ID')
-        .action(async (opts) => {
+        .action(async () => {
         const projectDir = program.opts().projectDir;
         const config = await loadConfig(projectDir);
         const features = await listArtifacts(projectDir, config, 'feature');
@@ -62,4 +58,121 @@ export function registerFeatureCommand(program) {
         }
     });
 }
+async function createFeaturesWithAI(projectDir, config, epicId, featureCount) {
+    logger.heading(`Create Features (AI-powered from ${epicId})`);
+    const epicRaw = await readArtifactRaw(projectDir, config, 'epic', epicId);
+    if (!epicRaw) {
+        logger.error(`Could not read epic ${epicId}.`);
+        return;
+    }
+    // Find existing features for THIS epic (for dedup + warning)
+    const allFeatures = await listArtifacts(projectDir, config, 'feature');
+    const epicFeatures = [];
+    for (const f of allFeatures) {
+        const data = await readArtifact(projectDir, config, 'feature', f.id);
+        if (data && data.data.epicId === epicId) {
+            epicFeatures.push({ id: f.id, title: data.data.title || f.title });
+        }
+    }
+    if (epicFeatures.length > 0) {
+        logger.warn(`${epicId} already has ${epicFeatures.length} feature(s):`);
+        for (const f of epicFeatures) {
+            console.log(chalk.dim(`  ${f.id}: ${f.title}`));
+        }
+        const continueCreate = await promptConfirm('Generate additional features? (AI will avoid duplicates)', false);
+        if (!continueCreate) {
+            logger.info('Feature creation cancelled.');
+            return;
+        }
+    }
+    const existingTitles = epicFeatures.map((f) => `${f.id}: ${f.title}`);
+    logger.dim('AI is generating features from the epic...');
+    try {
+        const provider = await getAIProvider(config);
+        const messages = buildFeaturesPrompt(epicRaw, existingTitles, featureCount);
+        const result = await generateStreamingJSON(provider, messages, aiFeaturesResponseSchema);
+        // Display generated features
+        console.log(chalk.dim('━'.repeat(50)));
+        result.features.forEach((feat, i) => {
+            console.log(chalk.bold(`  ${i + 1}. ${feat.title}`));
+            console.log(chalk.dim(`     ${feat.overview}`));
+            console.log(`     Requirements: ${feat.functionalRequirements.length} items`);
+        });
+        console.log(chalk.dim('━'.repeat(50)));
+        const confirmAll = await promptConfirm(`Create all ${result.features.length} features?`, true);
+        if (!confirmAll) {
+            logger.info('Feature creation cancelled.');
+            return;
+        }
+        // Create each feature
+        const createdIds = [];
+        const epicFilename = await resolveArtifactFilename(projectDir, config, 'epic', epicId);
+        for (const feat of result.features) {
+            const { id, filePath } = await createArtifact(projectDir, config, 'feature', 'features/feature.md.hbs', {
+                title: feat.title,
+                epicId,
+                epicFilename,
+                owner: config.author || 'Engineering',
+                overview: feat.overview,
+                functionalRequirements: feat.functionalRequirements,
+                dependencies: feat.dependencies,
+                technicalConsiderations: feat.technicalConsiderations,
+                risks: feat.risks,
+                successMetrics: feat.successMetrics,
+                storyIds: [],
+            });
+            createdIds.push(id);
+            await addChildReference(projectDir, config, 'epic', epicId, 'feature', id, feat.title);
+            logger.success(`Created ${id}: ${feat.title}`);
+            logger.dim(`  ${filePath}`);
+        }
+        logger.dim('');
+        logger.heading('Next steps:');
+        logger.dim(`  1. planr story create --feature ${createdIds[0]}   — Create user stories`);
+        logger.dim(`  2. planr task create --story US-*            — Generate implementation tasks`);
+        logger.dim(`  3. planr task implement TASK-*               — Implement with your coding agent`);
+        logger.dim('');
+        logger.dim(`  Or generate stories for all features at once:`);
+        logger.dim(`  planr plan --epic ${epicId}                   — Auto-generate stories → tasks`);
+    }
+    catch (err) {
+        const { AIError } = await import('../../ai/errors.js');
+        if (err instanceof AIError) {
+            logger.error(err.userMessage);
+        }
+        else {
+            throw err;
+        }
+    }
+}
+async function createFeatureManually(projectDir, config, opts) {
+    logger.heading(`Create Feature (from ${opts.epic})`);
+    const title = opts.title || (await promptText('Feature title:'));
+    const owner = await promptText('Owner:', config.author);
+    const overview = await promptText('Overview:');
+    const functionalRequirements = await promptMultiText('Functional requirements', 'comma-separated');
+    const dependencies = await promptText('Dependencies:', 'None');
+    const technicalConsiderations = await promptText('Technical considerations:', 'None');
+    const risks = await promptText('Risks:', 'None');
+    const successMetrics = await promptText('Success metrics:');
+    const epicFilename = await resolveArtifactFilename(projectDir, config, 'epic', opts.epic);
+    const { id, filePath } = await createArtifact(projectDir, config, 'feature', 'features/feature.md.hbs', {
+        title,
+        epicId: opts.epic,
+        epicFilename,
+        owner,
+        overview,
+        functionalRequirements,
+        dependencies,
+        technicalConsiderations,
+        risks,
+        successMetrics,
+        storyIds: [],
+    });
+    await addChildReference(projectDir, config, 'epic', opts.epic, 'feature', id, title);
+    logger.success(`Created feature ${id}: ${title}`);
+    logger.dim(`  ${filePath}`);
+    logger.dim('');
+    logger.dim(`Next: planr story create --feature ${id}`);
+}
 //# sourceMappingURL=feature.js.map

package/dist/cli/commands/feature.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../src/cli/commands/feature.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../src/cli/commands/feature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAE1E,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,cAAc,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;SACpE,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC1C,MAAM,CAAC,aAAa,EAAE,gCAAgC,EAAE,QAAQ,CAAC;SACjE,MAAM,CAAC,UAAU,EAAE,8CAA8C,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,aAAa,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAErD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;SAC9C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAEpE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;YACxF,OAAO;QACT,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,UAAkB,EAClB,MAAuD,EACvD,MAAc,EACd,YAAqB;IAErB,MAAM,CAAC,OAAO,CAAC,oCAAoC,MAAM,GAAG,CAAC,CAAC;IAE9D,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,uBAAuB,MAAM,GAAG,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,6DAA6D;IAC7D,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACvE,MAAM,YAAY,GAAyC,EAAE,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACxC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAG,IAAI,CAAC,IAAI,CAAC,KAAgB,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,gBAAgB,YAAY,CAAC,MAAM,cAAc,CAAC,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,aAAa,CACxC,0DAA0D,EAC1D,KAAK,CACN,CAAC;QACF,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAEtE,MAAM,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAC;QAEzF,6BAA6B;QAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,sBAAsB,CAAC,MAAM,QAAQ,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAEvC,MAAM,UAAU,GAAG,MAAM,aAAa,CACpC,cAAc,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY,EAChD,IAAI,CACL,CAAC;QAEF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACvF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,cAAc,CAC3C,UAAU,EACV,MAAM,EACN,SAAS,EACT,yBAAyB,EACzB;gBACE,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM;gBACN,YAAY;gBACZ,KAAK,EAAE,MAAM,CAAC,MAAM,IAAI,aAAa;gBACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;gBACnD,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;gBACrD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,QAAQ,EAAE,EAAE;aACb,CACF,CAAC;YACF,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpB,MAAM,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACvF,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,qCAAqC,UAAU,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;QAC7F,MAAM,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;QAChG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,uBAAuB,MAAM,oDAAoD,CAAC,CAAC;IAChG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACvD,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,UAAkB,EAClB,MAAuD,EACvD,IAA4B;IAE5B,MAAM,CAAC,OAAO,CAAC,wBAAwB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,sBAAsB,GAAG,MAAM,eAAe,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;IACnG,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,uBAAuB,GAAG,MAAM,UAAU,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1F,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,yBAAyB,EAAE;QACtG,KAAK;QACL,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,YAAY;QACZ,KAAK;QACL,QAAQ;QACR,sBAAsB;QACtB,YAAY;QACZ,uBAAuB;QACvB,KAAK;QACL,cAAc;QACd,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC;IAEH,MAAM,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACrF,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,CAAC,GAAG,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -1,3 +1,9 @@
+/**
+ * `planr init` command.
+ *
+ * Initializes a new Planr project with directory structure, config,
+ * and optional AI provider setup.
+ */
 import { Command } from 'commander';
 export declare function registerInitCommand(program: Command): void;
 //# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAkDnD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA8FnD"}

package/dist/cli/commands/init.js

@@ -1,16 +1,23 @@
+/**
+ * `planr init` command.
+ *
+ * Initializes a new Planr project with directory structure, config,
+ * and optional AI provider setup.
+ */
 import path from 'node:path';
 import { createDefaultConfig, saveConfig } from '../../services/config-service.js';
 import { createChecklist } from '../../services/checklist-service.js';
-import { ensureDir } from '../../utils/fs.js';
-import { fileExists } from '../../utils/fs.js';
+import { saveCredential } from '../../services/credentials-service.js';
+import { ensureDir, fileExists } from '../../utils/fs.js';
 import { CONFIG_FILENAME, ARTIFACT_DIRS } from '../../utils/constants.js';
 import { logger } from '../../utils/logger.js';
-import { promptText, promptConfirm } from '../../services/prompt-service.js';
+import { promptText, promptConfirm, promptSelect, promptSecret } from '../../services/prompt-service.js';
 export function registerInitCommand(program) {
     program
         .command('init')
         .description('Initialize Planr in the current project')
         .option('--name <name>', 'project name')
+        .option('--no-ai', 'skip AI setup')
         .action(async (opts) => {
         const projectDir = program.opts().projectDir;
         const configPath = path.join(projectDir, CONFIG_FILENAME);
@@ -23,27 +30,62 @@ export function registerInitCommand(program) {
         }
         const projectName = opts.name || (await promptText('Project name:', path.basename(projectDir)));
         const config = createDefaultConfig(projectName);
+        // --- AI Provider Setup ---
+        if (opts.ai !== false) {
+            const enableAI = await promptConfirm('Enable AI-powered planning?', true);
+            if (enableAI) {
+                const provider = await promptSelect('AI provider:', [
+                    { name: 'Anthropic (Claude)', value: 'anthropic' },
+                    { name: 'OpenAI (GPT-4o)', value: 'openai' },
+                    { name: 'Ollama (Local — free, no API key)', value: 'ollama' },
+                ]);
+                config.ai = { provider };
+                // Collect API key for cloud providers
+                if (provider === 'anthropic' || provider === 'openai') {
+                    const keyHint = provider === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY';
+                    const apiKey = await promptSecret(`API key (or press Enter to set ${keyHint} env var later):`);
+                    if (apiKey.trim()) {
+                        await saveCredential(provider, apiKey.trim());
+                        logger.success(`API key saved to ~/.planr/credentials.json`);
+                    }
+                    else {
+                        logger.dim(`  No key provided. Set ${keyHint} env var or run \`planr config set-key ${provider}\`.`);
+                    }
+                }
+                // Coding agent preference
+                const agent = await promptSelect('Default coding agent:', [
+                    { name: 'Claude Code CLI', value: 'claude' },
+                    { name: 'Cursor', value: 'cursor' },
+                    { name: 'Codex', value: 'codex' },
+                ]);
+                config.defaultAgent = agent;
+            }
+        }
         // Create directory structure
         const agileDir = path.join(projectDir, config.outputPaths.agile);
         for (const dir of Object.values(ARTIFACT_DIRS)) {
             await ensureDir(path.join(agileDir, dir));
         }
-        // Also create diagrams dir
         await ensureDir(path.join(agileDir, 'diagrams'));
         // Save config
         await saveConfig(projectDir, config);
         logger.success(`Created ${CONFIG_FILENAME}`);
         // Create checklist
-        const checklistPath = await createChecklist(projectDir, config);
+        await createChecklist(projectDir, config);
         logger.success(`Created agile development checklist`);
+        // Summary
         logger.heading('Planr initialized!');
         logger.info(`Project: ${projectName}`);
         logger.info(`Artifacts: ${config.outputPaths.agile}/`);
+        if (config.ai) {
+            logger.info(`AI: ${config.ai.provider} (every command is AI-powered)`);
+            logger.info(`Agent: ${config.defaultAgent || 'claude'}`);
+        }
         logger.dim('');
         logger.dim('Next steps:');
         logger.dim('  planr epic create        — Create your first epic');
         logger.dim('  planr rules generate     — Generate AI agent rules');
-        logger.dim('  planr checklist show      — View the agile checklist');
+        logger.dim('  planr config show        — View configuration');
     });
 }
 //# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAE7E,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;SACvC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAE1D,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,MAAM,aAAa,CACnC,GAAG,eAAe,6BAA6B,EAC/C,KAAK,CACN,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GACf,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,UAAU,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAE9E,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAEhD,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/C,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,2BAA2B;QAC3B,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QAEjD,cAAc;QACd,MAAM,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,WAAW,eAAe,EAAE,CAAC,CAAC;QAE7C,mBAAmB;QACnB,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;QAEtD,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACnE,MAAM,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/plan.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `planr plan` command.
+ *
+ * Full agile planning flow in a single command:
+ *   Epic → Features → User Stories → Tasks
+ *
+ * Can start from any level:
+ *   --epic EPIC-001    → generates features → stories → tasks
+ *   --feature FEAT-001 → generates stories → tasks
+ *   --story US-001     → generates tasks
+ *   (no flag)          → creates epic first, then cascades
+ */
+import { Command } from 'commander';
+export declare function registerPlanCommand(program: Command): void;
+//# sourceMappingURL=plan.d.ts.map

package/dist/cli/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAyCnD"}

package/dist/cli/commands/plan.js

@@ -0,0 +1,259 @@
+/**
+ * `planr plan` command.
+ *
+ * Full agile planning flow in a single command:
+ *   Epic → Features → User Stories → Tasks
+ *
+ * Can start from any level:
+ *   --epic EPIC-001    → generates features → stories → tasks
+ *   --feature FEAT-001 → generates stories → tasks
+ *   --story US-001     → generates tasks
+ *   (no flag)          → creates epic first, then cascades
+ */
+import path from 'node:path';
+import { loadConfig } from '../../services/config-service.js';
+import { createArtifact, listArtifacts, readArtifact, readArtifactRaw, getArtifactDir, resolveArtifactFilename, addChildReference, } from '../../services/artifact-service.js';
+import { isAIConfigured, getAIProvider, generateStreamingJSON } from '../../services/ai-service.js';
+import { promptText, promptConfirm } from '../../services/prompt-service.js';
+import { renderTemplate } from '../../services/template-service.js';
+import { writeFile } from '../../utils/fs.js';
+import { buildEpicPrompt, buildFeaturesPrompt, buildStoriesPrompt, buildTasksPrompt } from '../../ai/prompts/prompt-builder.js';
+import { aiEpicResponseSchema, aiFeaturesResponseSchema, aiStoriesResponseSchema, aiTasksResponseSchema, } from '../../ai/schemas/ai-response-schemas.js';
+import { logger } from '../../utils/logger.js';
+import chalk from 'chalk';
+export function registerPlanCommand(program) {
+    program
+        .command('plan')
+        .description('Full agile planning flow: Epic → Features → Stories → Tasks')
+        .option('--epic <epicId>', 'start from an existing epic')
+        .option('--feature <featureId>', 'start from an existing feature')
+        .option('--story <storyId>', 'start from an existing story (generates tasks only)')
+        .action(async (opts) => {
+        const projectDir = program.opts().projectDir;
+        const config = await loadConfig(projectDir);
+        if (!isAIConfigured(config)) {
+            logger.error('AI must be configured for the plan command. Run `planr config set-provider`.');
+            process.exit(1);
+        }
+        const provider = await getAIProvider(config);
+        try {
+            if (opts.story) {
+                // Start from story → generate tasks
+                await generateTasksForStory(projectDir, config, provider, opts.story);
+            }
+            else if (opts.feature) {
+                // Start from feature → stories → tasks
+                await planFromFeature(projectDir, config, provider, opts.feature);
+            }
+            else if (opts.epic) {
+                // Start from epic → features → stories → tasks
+                await planFromEpic(projectDir, config, provider, opts.epic);
+            }
+            else {
+                // Full flow: create epic first
+                await planFromScratch(projectDir, config, provider);
+            }
+        }
+        catch (err) {
+            const { AIError } = await import('../../ai/errors.js');
+            if (err instanceof AIError) {
+                logger.error(err.userMessage);
+            }
+            else {
+                throw err;
+            }
+        }
+    });
+}
+async function planFromScratch(projectDir, config, provider) {
+    logger.heading('Full Agile Planning Flow');
+    logger.dim('Epic → Features → User Stories → Tasks\n');
+    // Step 1: Create Epic
+    const brief = await promptText('Describe your epic in a sentence or two:');
+    const existingEpics = await listArtifacts(projectDir, config, 'epic');
+    const existingTitles = existingEpics.map((e) => `${e.id}: ${e.title}`);
+    logger.dim('\n[1/4] Generating epic...');
+    const epicMessages = buildEpicPrompt(brief, existingTitles);
+    const epicData = await generateStreamingJSON(provider, epicMessages, aiEpicResponseSchema);
+    console.log(chalk.bold(`\n  Epic: ${epicData.title}`));
+    console.log(chalk.dim(`  ${epicData.solutionOverview}`));
+    const continueFlow = await promptConfirm('Save epic and continue planning?', true);
+    if (!continueFlow) {
+        logger.info('Planning cancelled.');
+        return;
+    }
+    const epicCriteriaArray = Array.isArray(epicData.successCriteria)
+        ? epicData.successCriteria
+        : [epicData.successCriteria];
+    const { id: epicId } = await createArtifact(projectDir, config, 'epic', 'epics/epic.md.hbs', {
+        ...epicData,
+        successCriteria: epicCriteriaArray.join('; '),
+        successCriteriaList: epicCriteriaArray,
+        featureIds: [],
+    });
+    logger.success(`Created ${epicId}: ${epicData.title}`);
+    await planFromEpic(projectDir, config, provider, epicId);
+}
+async function planFromEpic(projectDir, config, provider, epicId) {
+    // Step 2: Generate Features
+    const epicRaw = await readArtifactRaw(projectDir, config, 'epic', epicId);
+    if (!epicRaw) {
+        logger.error(`Epic ${epicId} not found.`);
+        return;
+    }
+    const existingFeatures = await listArtifacts(projectDir, config, 'feature');
+    const existingFeatureTitles = existingFeatures.map((f) => `${f.id}: ${f.title}`);
+    logger.dim('\n[2/4] Generating features...');
+    const featureMessages = buildFeaturesPrompt(epicRaw, existingFeatureTitles);
+    const featureResult = await generateStreamingJSON(provider, featureMessages, aiFeaturesResponseSchema);
+    console.log(chalk.bold(`\n  Generated ${featureResult.features.length} features:`));
+    featureResult.features.forEach((f, i) => {
+        console.log(chalk.dim(`    ${i + 1}. ${f.title}`));
+    });
+    const continueFeatures = await promptConfirm(`Create all ${featureResult.features.length} features and continue?`, true);
+    if (!continueFeatures) {
+        logger.info('Planning paused after epic.');
+        return;
+    }
+    const featureIds = [];
+    const epicFilename = await resolveArtifactFilename(projectDir, config, 'epic', epicId);
+    for (const feat of featureResult.features) {
+        const { id } = await createArtifact(projectDir, config, 'feature', 'features/feature.md.hbs', {
+            title: feat.title,
+            epicId,
+            epicFilename,
+            owner: config.author || 'Engineering',
+            overview: feat.overview,
+            functionalRequirements: feat.functionalRequirements,
+            dependencies: feat.dependencies,
+            technicalConsiderations: feat.technicalConsiderations,
+            risks: feat.risks,
+            successMetrics: feat.successMetrics,
+            storyIds: [],
+        });
+        featureIds.push(id);
+        await addChildReference(projectDir, config, 'epic', epicId, 'feature', id, feat.title);
+        logger.success(`Created ${id}: ${feat.title}`);
+    }
+    // Step 3+4: Stories and tasks for each feature
+    for (const featureId of featureIds) {
+        await planFromFeature(projectDir, config, provider, featureId);
+    }
+    // Final summary
+    logger.heading('\nPlanning Complete!');
+    const allFeatures = await listArtifacts(projectDir, config, 'feature');
+    const allStories = await listArtifacts(projectDir, config, 'story');
+    const allTasks = await listArtifacts(projectDir, config, 'task');
+    console.log(`  Epic:     ${epicId}`);
+    console.log(`  Features: ${allFeatures.length}`);
+    console.log(`  Stories:  ${allStories.length}`);
+    console.log(`  Tasks:    ${allTasks.length}`);
+    logger.dim('');
+    logger.dim('Start implementing:');
+    logger.dim('  planr task implement TASK-001 --next');
+    logger.dim('  planr status');
+}
+async function planFromFeature(projectDir, config, provider, featureId) {
+    // Step 3: Generate Stories
+    const featureRaw = await readArtifactRaw(projectDir, config, 'feature', featureId);
+    if (!featureRaw) {
+        logger.error(`Feature ${featureId} not found.`);
+        return;
+    }
+    const featureData = await readArtifact(projectDir, config, 'feature', featureId);
+    const epicId = featureData?.data.epicId;
+    let epicRaw = '';
+    if (epicId) {
+        epicRaw = (await readArtifactRaw(projectDir, config, 'epic', epicId)) || '';
+    }
+    const existingStories = await listArtifacts(projectDir, config, 'story');
+    const existingStoryTitles = existingStories.map((s) => `${s.id}: ${s.title}`);
+    logger.dim(`\n[3/4] Generating stories for ${featureId}...`);
+    const storyMessages = buildStoriesPrompt(featureRaw, epicRaw, existingStoryTitles);
+    const storyResult = await generateStreamingJSON(provider, storyMessages, aiStoriesResponseSchema);
+    console.log(chalk.dim(`  Generated ${storyResult.stories.length} stories for ${featureId}`));
+    const storyDir = path.join(projectDir, getArtifactDir(config, 'story'));
+    const storyIds = [];
+    const featureFilename = await resolveArtifactFilename(projectDir, config, 'feature', featureId);
+    for (const story of storyResult.stories) {
+        const { id, filePath } = await createArtifact(projectDir, config, 'story', 'stories/user-story.md.hbs', {
+            title: story.title,
+            featureId,
+            featureFilename,
+            role: story.role,
+            goal: story.goal,
+            benefit: story.benefit,
+            additionalNotes: story.additionalNotes || undefined,
+        });
+        // Gherkin file
+        const gherkinContent = await renderTemplate('stories/gherkin.feature.hbs', {
+            id,
+            title: story.title,
+            role: story.role,
+            goal: story.goal,
+            benefit: story.benefit,
+            scenarios: story.gherkinScenarios.map((s) => ({
+                name: s.name, given: s.given, when: s.when, then: s.then,
+            })),
+        }, config.templateOverrides);
+        await writeFile(path.join(storyDir, `${id}-gherkin.feature`), gherkinContent);
+        storyIds.push(id);
+        await addChildReference(projectDir, config, 'feature', featureId, 'story', id, story.title);
+        logger.success(`Created ${id}: ${story.title}`);
+    }
+    // Step 4: Generate tasks for each story
+    for (const storyId of storyIds) {
+        await generateTasksForStory(projectDir, config, provider, storyId);
+    }
+}
+async function generateTasksForStory(projectDir, config, provider, storyId) {
+    const { gatherStoryArtifacts } = await import('../../services/artifact-gathering.js');
+    let ctx;
+    try {
+        ctx = await gatherStoryArtifacts(projectDir, config, storyId);
+    }
+    catch {
+        logger.error(`Story ${storyId} not found.`);
+        return;
+    }
+    logger.dim(`\n[4/4] Generating tasks for ${storyId}...`);
+    ctx.scope = { type: 'story', id: storyId };
+    const taskMessages = buildTasksPrompt(ctx);
+    const result = await generateStreamingJSON(provider, taskMessages, aiTasksResponseSchema);
+    const tasks = result.tasks.map((tg) => ({
+        id: tg.id,
+        title: tg.title,
+        status: 'pending',
+        subtasks: (tg.subtasks || []).map((st) => ({
+            id: st.id,
+            title: st.title,
+            status: 'pending',
+            subtasks: [],
+        })),
+    }));
+    const storyFilename = await resolveArtifactFilename(projectDir, config, 'story', storyId);
+    // Build artifact sources for traceability
+    const artifactSources = [];
+    for (const s of ctx.stories) {
+        artifactSources.push({ type: 'User Story', path: `${config.outputPaths.agile}/stories/${s.id}` });
+    }
+    for (const g of ctx.gherkinScenarios) {
+        artifactSources.push({ type: 'Gherkin', path: `${config.outputPaths.agile}/stories/${g.storyId}-gherkin.feature` });
+    }
+    for (const a of ctx.adrs) {
+        artifactSources.push({ type: 'ADR', path: `${config.outputPaths.agile}/adrs/${a.id}` });
+    }
+    const { id } = await createArtifact(projectDir, config, 'task', 'tasks/task-list.md.hbs', {
+        title: result.title,
+        storyId,
+        storyFilename,
+        tasks,
+        artifactSources,
+        acceptanceCriteriaMapping: result.acceptanceCriteriaMapping,
+        relevantFiles: result.relevantFiles,
+    });
+    const total = tasks.reduce((sum, t) => sum + t.subtasks.length + 1, 0);
+    await addChildReference(projectDir, config, 'story', storyId, 'task', id, result.title);
+    logger.success(`Created ${id}: ${result.title} (${total} tasks)`);
+}
+//# sourceMappingURL=plan.js.map