openplanr 0.1.0 → 0.3.0

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

@@ -0,0 +1,8 @@
+/**
+ * `planr config` command group.
+ *
+ * Manage AI provider settings, API keys, and coding agent preferences.
+ */
+import { Command } from 'commander';
+export declare function registerConfigCommand(program: Command): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAoHrD"}

package/dist/cli/commands/config.js

@@ -0,0 +1,112 @@
+/**
+ * `planr config` command group.
+ *
+ * Manage AI provider settings, API keys, and coding agent preferences.
+ */
+import { loadConfig, saveConfig } from '../../services/config-service.js';
+import { saveCredential, resolveApiKey } from '../../services/credentials-service.js';
+import { promptSelect, promptSecret } from '../../services/prompt-service.js';
+import { logger } from '../../utils/logger.js';
+export function registerConfigCommand(program) {
+    const config = program.command('config').description('Manage Planr configuration');
+    config
+        .command('show')
+        .description('Display current configuration')
+        .action(async () => {
+        const projectDir = program.opts().projectDir;
+        const cfg = await loadConfig(projectDir);
+        logger.heading('Planr Configuration');
+        console.log(`  Project:    ${cfg.projectName}`);
+        console.log(`  Targets:    ${cfg.targets.join(', ')}`);
+        console.log(`  Artifacts:  ${cfg.outputPaths.agile}/`);
+        if (cfg.ai) {
+            console.log('');
+            console.log(`  AI Provider:  ${cfg.ai.provider}`);
+            console.log(`  AI Model:     ${cfg.ai.model || '(default)'}`);
+            const key = await resolveApiKey(cfg.ai.provider);
+            if (key) {
+                const masked = key.slice(0, 8) + '...' + key.slice(-4);
+                console.log(`  API Key:      ${masked}`);
+            }
+            else {
+                console.log(`  API Key:      (not set)`);
+            }
+        }
+        else {
+            console.log('');
+            console.log('  AI:           Not configured');
+            logger.dim('  Run `planr config set-provider <name>` to enable AI.');
+        }
+        if (cfg.defaultAgent) {
+            console.log(`  Agent:        ${cfg.defaultAgent}`);
+        }
+    });
+    config
+        .command('set-provider')
+        .description('Set the AI provider')
+        .argument('[provider]', 'anthropic, openai, or ollama')
+        .action(async (provider) => {
+        const projectDir = program.opts().projectDir;
+        const cfg = await loadConfig(projectDir);
+        const selected = provider ||
+            (await promptSelect('AI provider:', [
+                { name: 'Anthropic (Claude)', value: 'anthropic' },
+                { name: 'OpenAI (GPT-4o)', value: 'openai' },
+                { name: 'Ollama (Local)', value: 'ollama' },
+            ]));
+        cfg.ai = { ...cfg.ai, provider: selected };
+        await saveConfig(projectDir, cfg);
+        logger.success(`AI provider set to: ${selected}`);
+    });
+    config
+        .command('set-key')
+        .description('Store an API key securely')
+        .argument('[provider]', 'anthropic or openai')
+        .action(async (provider) => {
+        const selected = provider ||
+            (await promptSelect('Provider:', [
+                { name: 'Anthropic', value: 'anthropic' },
+                { name: 'OpenAI', value: 'openai' },
+            ]));
+        const key = await promptSecret(`API key for ${selected}:`);
+        if (!key.trim()) {
+            logger.error('API key cannot be empty.');
+            return;
+        }
+        await saveCredential(selected, key.trim());
+        logger.success(`API key for ${selected} saved to ~/.planr/credentials.json`);
+    });
+    config
+        .command('set-model')
+        .description('Set the AI model')
+        .argument('<model>', 'model name (e.g., claude-sonnet-4-20250514, gpt-4o, llama3.1)')
+        .action(async (model) => {
+        const projectDir = program.opts().projectDir;
+        const cfg = await loadConfig(projectDir);
+        if (!cfg.ai) {
+            logger.error('AI not configured. Run `planr config set-provider` first.');
+            return;
+        }
+        cfg.ai.model = model;
+        await saveConfig(projectDir, cfg);
+        logger.success(`AI model set to: ${model}`);
+    });
+    config
+        .command('set-agent')
+        .description('Set the default coding agent for task implementation')
+        .argument('[agent]', 'claude, cursor, or codex')
+        .action(async (agent) => {
+        const projectDir = program.opts().projectDir;
+        const cfg = await loadConfig(projectDir);
+        const selected = agent ||
+            (await promptSelect('Default coding agent:', [
+                { name: 'Claude Code CLI', value: 'claude' },
+                { name: 'Cursor', value: 'cursor' },
+                { name: 'Codex', value: 'codex' },
+            ]));
+        cfg.defaultAgent = selected;
+        await saveConfig(projectDir, cfg);
+        logger.success(`Default coding agent set to: ${selected}`);
+    });
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG/C,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAEnF,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAEzC,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC;QAEvD,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,WAAW,EAAE,CAAC,CAAC;YAE9D,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;YAC9C,MAAM,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,qBAAqB,CAAC;SAClC,QAAQ,CAAC,YAAY,EAAE,8BAA8B,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,QAAiB,EAAE,EAAE;QAClC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAEzC,MAAM,QAAQ,GAAI,QAA2B;YAC3C,CAAC,MAAM,YAAY,CAAiB,cAAc,EAAE;gBAClD,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,WAAW,EAAE;gBAClD,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE;gBAC5C,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE;aAC5C,CAAC,CAAC,CAAC;QAEN,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC3C,MAAM,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2BAA2B,CAAC;SACxC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,QAAiB,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,QAAQ;YACvB,CAAC,MAAM,YAAY,CAAC,WAAW,EAAE;gBAC/B,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;gBACzC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;aACpC,CAAC,CAAC,CAAC;QAEN,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,eAAe,QAAQ,GAAG,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QAED,MAAM,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,eAAe,QAAQ,qCAAqC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,kBAAkB,CAAC;SAC/B,QAAQ,CAAC,SAAS,EAAE,+DAA+D,CAAC;SACpF,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAEzC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QAED,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,sDAAsD,CAAC;SACnE,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAEzC,MAAM,QAAQ,GAAI,KAAyB;YACzC,CAAC,MAAM,YAAY,CAAkB,uBAAuB,EAAE;gBAC5D,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE;gBAC5C,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACnC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;aAClC,CAAC,CAAC,CAAC;QAEN,GAAG,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC5B,MAAM,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -1,3 +1,10 @@
+/**
+ * `planr epic` command group.
+ *
+ * AI-powered by default: user provides a brief description,
+ * AI expands into a full epic. Use --manual for the legacy
+ * interactive prompt flow.
+ */
 import { Command } from 'commander';
 export declare function registerEpicCommand(program: Command): void;
 //# sourceMappingURL=epic.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"epic.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/epic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAqEnD"}
+{"version":3,"file":"epic.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/epic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA0CnD"}

package/dist/cli/commands/epic.js

@@ -1,7 +1,18 @@
+/**
+ * `planr epic` command group.
+ *
+ * AI-powered by default: user provides a brief description,
+ * AI expands into a full epic. Use --manual for the legacy
+ * interactive prompt flow.
+ */
 import { loadConfig } from '../../services/config-service.js';
 import { createArtifact, listArtifacts } from '../../services/artifact-service.js';
-import { promptText, promptMultiText } from '../../services/prompt-service.js';
+import { isAIConfigured, getAIProvider, generateStreamingJSON } from '../../services/ai-service.js';
+import { promptText, promptMultiText, promptSelect, promptEditor } from '../../services/prompt-service.js';
+import { buildEpicPrompt } from '../../ai/prompts/prompt-builder.js';
+import { aiEpicResponseSchema } from '../../ai/schemas/ai-response-schemas.js';
 import { logger } from '../../utils/logger.js';
+import chalk from 'chalk';
 export function registerEpicCommand(program) {
     const epic = program.command('epic').description('Manage epics');
     epic
@@ -9,37 +20,20 @@ export function registerEpicCommand(program) {
         .description('Create a new epic')
         .option('--title <title>', 'epic title')
         .option('--owner <owner>', 'epic owner')
+        .option('--manual', 'use manual interactive prompts instead of AI')
         .action(async (opts) => {
         const projectDir = program.opts().projectDir;
         const config = await loadConfig(projectDir);
-        logger.heading('Create Epic');
-        const title = opts.title || (await promptText('Epic title:'));
-        const owner = opts.owner || (await promptText('Owner:', config.author));
-        const businessValue = await promptText('Business value:');
-        const targetUsers = await promptText('Target users:');
-        const problemStatement = await promptText('Problem statement:');
-        const solutionOverview = await promptText('Solution overview:');
-        const successCriteria = await promptText('Success criteria:');
-        const keyFeatures = await promptMultiText('Key features', 'comma-separated');
-        const dependencies = await promptText('Dependencies:', 'None');
-        const risks = await promptText('Risks:', 'None');
-        const { id, filePath } = await createArtifact(projectDir, config, 'epic', 'epics/epic.md.hbs', {
-            title,
-            owner,
-            businessValue,
-            targetUsers,
-            problemStatement,
-            solutionOverview,
-            successCriteria,
-            keyFeatures,
-            dependencies,
-            risks,
-            featureIds: [],
-        });
-        logger.success(`Created epic ${id}: ${title}`);
-        logger.dim(`  ${filePath}`);
-        logger.dim('');
-        logger.dim(`Next: planr feature create --epic ${id}`);
+        const useAI = !opts.manual && isAIConfigured(config);
+        if (useAI) {
+            await createEpicWithAI(projectDir, config, opts);
+        }
+        else {
+            if (!opts.manual && !isAIConfigured(config)) {
+                logger.warn('AI not configured. Using manual mode. Run `planr config set-provider` to enable AI.');
+            }
+            await createEpicManually(projectDir, config, opts);
+        }
     });
     epic
         .command('list')
@@ -53,9 +47,145 @@ export function registerEpicCommand(program) {
             return;
         }
         logger.heading('Epics');
-        for (const epic of epics) {
-            console.log(`  ${epic.id}  ${epic.title}`);
+        for (const e of epics) {
+            console.log(`  ${e.id}  ${e.title}`);
+        }
+    });
+}
+function displayEpic(epicData) {
+    console.log(chalk.dim('━'.repeat(50)));
+    console.log(chalk.bold(`  Title:            ${epicData.title}`));
+    console.log(`  Owner:            ${epicData.owner}`);
+    console.log(`  Business Value:   ${epicData.businessValue}`);
+    console.log(`  Target Users:     ${epicData.targetUsers}`);
+    console.log(`  Problem:          ${epicData.problemStatement}`);
+    console.log(`  Solution:         ${epicData.solutionOverview}`);
+    console.log(`  Success Criteria:`);
+    const criteria = Array.isArray(epicData.successCriteria) ? epicData.successCriteria : [epicData.successCriteria];
+    for (const c of criteria) {
+        console.log(`    • ${c}`);
+    }
+    console.log(`  Key Features:`);
+    for (const f of epicData.keyFeatures) {
+        console.log(`    • ${f}`);
+    }
+    console.log(`  Dependencies:     ${epicData.dependencies || 'None'}`);
+    console.log(`  Risks:            ${epicData.risks || 'None'}`);
+    console.log(chalk.dim('━'.repeat(50)));
+}
+async function createEpicWithAI(projectDir, config, opts) {
+    logger.heading('Create Epic (AI-powered)');
+    const brief = opts.title || await promptText('Describe your epic in a sentence or two:');
+    // Get existing epics for deduplication
+    const existingEpics = await listArtifacts(projectDir, config, 'epic');
+    const existingTitles = existingEpics.map((e) => `${e.id}: ${e.title}`);
+    logger.dim('AI is generating your epic...');
+    try {
+        const provider = await getAIProvider(config);
+        const messages = buildEpicPrompt(brief, existingTitles);
+        let epicData = await generateStreamingJSON(provider, messages, aiEpicResponseSchema);
+        displayEpic(epicData);
+        // Action loop: save, edit, regenerate, cancel
+        let saved = false;
+        while (!saved) {
+            const action = await promptSelect('Action:', [
+                { name: 'Save this epic', value: 'save' },
+                { name: 'Edit before saving', value: 'edit' },
+                { name: 'Regenerate', value: 'regenerate' },
+                { name: 'Cancel', value: 'cancel' },
+            ]);
+            if (action === 'cancel') {
+                logger.info('Epic creation cancelled.');
+                return;
+            }
+            if (action === 'regenerate') {
+                logger.dim('Regenerating...');
+                epicData = await generateStreamingJSON(provider, messages, aiEpicResponseSchema);
+                displayEpic(epicData);
+                continue;
+            }
+            if (action === 'edit') {
+                const editContent = JSON.stringify(epicData, null, 2);
+                const edited = await promptEditor('Edit the epic JSON (save & close to apply):', editContent);
+                try {
+                    const parsed = JSON.parse(edited);
+                    const validated = aiEpicResponseSchema.parse(parsed);
+                    epicData = validated;
+                    displayEpic(epicData);
+                    continue;
+                }
+                catch (err) {
+                    logger.error('Invalid JSON after edit. Please try again.');
+                    continue;
+                }
+            }
+            // Save
+            saved = true;
+        }
+        const criteriaArray = Array.isArray(epicData.successCriteria)
+            ? epicData.successCriteria
+            : [epicData.successCriteria];
+        const templateData = {
+            ...epicData,
+            successCriteria: criteriaArray.join('; '),
+            successCriteriaList: criteriaArray,
+            featureIds: [],
+        };
+        const { id, filePath } = await createArtifact(projectDir, config, 'epic', 'epics/epic.md.hbs', templateData);
+        logger.success(`Created epic ${id}: ${epicData.title}`);
+        logger.dim(`  ${filePath}`);
+        logger.dim('');
+        logger.heading('Next steps:');
+        logger.dim(`  1. planr feature create --epic ${id}    — Break epic into features`);
+        logger.dim(`  2. planr story create --feature FEAT-*   — Create user stories per feature`);
+        logger.dim(`  3. planr task create --story US-*        — Generate implementation tasks`);
+        logger.dim(`  4. planr task implement TASK-*           — Implement with your coding agent`);
+        logger.dim('');
+        logger.dim(`  Or run the full flow at once:`);
+        logger.dim(`  planr plan --epic ${id}                  — Auto-generate features → stories → tasks`);
+    }
+    catch (err) {
+        const { AIError } = await import('../../ai/errors.js');
+        if (err instanceof AIError) {
+            logger.error(err.userMessage);
         }
+        else {
+            throw err;
+        }
+    }
+}
+async function createEpicManually(projectDir, config, opts) {
+    logger.heading('Create Epic');
+    const title = opts.title || (await promptText('Epic title:'));
+    const owner = opts.owner || (await promptText('Owner:', config.author));
+    const businessValue = await promptText('Business value:');
+    const targetUsers = await promptText('Target users:');
+    const problemStatement = await promptText('Problem statement:');
+    const solutionOverview = await promptText('Solution overview:');
+    const successCriteria = await promptText('Success criteria:');
+    const keyFeatures = await promptMultiText('Key features', 'comma-separated');
+    const dependencies = await promptText('Dependencies:', 'None');
+    const risks = await promptText('Risks:', 'None');
+    const { id, filePath } = await createArtifact(projectDir, config, 'epic', 'epics/epic.md.hbs', {
+        title,
+        owner,
+        businessValue,
+        targetUsers,
+        problemStatement,
+        solutionOverview,
+        successCriteria,
+        keyFeatures,
+        dependencies,
+        risks,
+        featureIds: [],
     });
+    logger.success(`Created epic ${id}: ${title}`);
+    logger.dim(`  ${filePath}`);
+    logger.dim('');
+    logger.heading('Next steps:');
+    logger.dim(`  1. planr feature create --epic ${id}    — Break epic into features`);
+    logger.dim(`  2. planr story create --feature FEAT-*   — Create user stories per feature`);
+    logger.dim(`  3. planr task create --story US-*        — Generate implementation tasks`);
+    logger.dim(`  4. planr task implement TASK-*           — Implement with your coding agent`);
 }
 //# sourceMappingURL=epic.js.map

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

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

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

@@ -1,3 +1,9 @@
+/**
+ * `planr feature` command group.
+ *
+ * AI-powered by default: reads the parent epic and generates
+ * multiple features automatically. Use --manual for legacy mode.
+ */
 import { Command } from 'commander';
 export declare function registerFeatureCommand(program: Command): void;
 //# sourceMappingURL=feature.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QA6EtD"}
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/feature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAmDtD"}

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