@dedesfr/prompter 0.9.0 → 1.0.0

package/src/commands/change.ts

@@ -1,292 +0,0 @@
-import { promises as fs } from 'fs';
-import path from 'path';
-import { JsonConverter } from '../core/converters/json-converter.js';
-import { Validator } from '../core/validation/validator.js';
-import { ChangeParser } from '../core/parsers/change-parser.js';
-import { Change } from '../core/schemas/index.js';
-import { isInteractive } from '../utils/interactive.js';
-import { getActiveChangeIds } from '../utils/item-discovery.js';
-
-// Constants for better maintainability
-const ARCHIVE_DIR = 'archive';
-const TASK_PATTERN = /^[-*]\s+\[[\sx]\]/i;
-const COMPLETED_TASK_PATTERN = /^[-*]\s+\[x\]/i;
-
-export class ChangeCommand {
-  private converter: JsonConverter;
-
-  constructor() {
-    this.converter = new JsonConverter();
-  }
-
-  /**
-   * Show a change proposal.
-   * - Text mode: raw markdown passthrough (no filters)
-   * - JSON mode: minimal object with deltas; --deltas-only returns same object with filtered deltas
-   *   Note: --requirements-only is deprecated alias for --deltas-only
-   */
-  async show(changeName?: string, options?: { json?: boolean; requirementsOnly?: boolean; deltasOnly?: boolean; noInteractive?: boolean }): Promise<void> {
-    const changesPath = path.join(process.cwd(), 'prompter', 'changes');
-
-    if (!changeName) {
-      const canPrompt = isInteractive(options);
-      const changes = await this.getActiveChanges(changesPath);
-      if (canPrompt && changes.length > 0) {
-        const { select } = await import('@inquirer/prompts');
-        const selected = await select({
-          message: 'Select a change to show',
-          choices: changes.map(id => ({ name: id, value: id })),
-        });
-        changeName = selected;
-      } else {
-        if (changes.length === 0) {
-          console.error('No change specified. No active changes found.');
-        } else {
-          console.error(`No change specified. Available IDs: ${changes.join(', ')}`);
-        }
-        console.error('Hint: use "prompter change list" to view available changes.');
-        process.exitCode = 1;
-        return;
-      }
-    }
-
-    const proposalPath = path.join(changesPath, changeName, 'proposal.md');
-
-    try {
-      await fs.access(proposalPath);
-    } catch {
-      throw new Error(`Change "${changeName}" not found at ${proposalPath}`);
-    }
-
-    if (options?.json) {
-      const jsonOutput = await this.converter.convertChangeToJson(proposalPath);
-
-      if (options.requirementsOnly) {
-        console.error('Flag --requirements-only is deprecated; use --deltas-only instead.');
-      }
-
-      const parsed: Change = JSON.parse(jsonOutput);
-      const contentForTitle = await fs.readFile(proposalPath, 'utf-8');
-      const title = this.extractTitle(contentForTitle, changeName);
-      const id = parsed.name;
-      const deltas = parsed.deltas || [];
-
-      if (options.requirementsOnly || options.deltasOnly) {
-        const output = { id, title, deltaCount: deltas.length, deltas };
-        console.log(JSON.stringify(output, null, 2));
-      } else {
-        const output = {
-          id,
-          title,
-          deltaCount: deltas.length,
-          deltas,
-        };
-        console.log(JSON.stringify(output, null, 2));
-      }
-    } else {
-      const content = await fs.readFile(proposalPath, 'utf-8');
-      console.log(content);
-    }
-  }
-
-  /**
-   * List active changes.
-   * - Text default: IDs only; --long prints minimal details (title, counts)
-   * - JSON: array of { id, title, deltaCount, taskStatus }, sorted by id
-   */
-  async list(options?: { json?: boolean; long?: boolean }): Promise<void> {
-    const changesPath = path.join(process.cwd(), 'prompter', 'changes');
-    
-    const changes = await this.getActiveChanges(changesPath);
-    
-    if (options?.json) {
-      const changeDetails = await Promise.all(
-        changes.map(async (changeName) => {
-          const proposalPath = path.join(changesPath, changeName, 'proposal.md');
-          const tasksPath = path.join(changesPath, changeName, 'tasks.md');
-          
-          try {
-            const content = await fs.readFile(proposalPath, 'utf-8');
-            const changeDir = path.join(changesPath, changeName);
-            const parser = new ChangeParser(content, changeDir);
-            const change = await parser.parseChangeWithDeltas(changeName);
-            
-            let taskStatus = { total: 0, completed: 0 };
-            try {
-              const tasksContent = await fs.readFile(tasksPath, 'utf-8');
-              taskStatus = this.countTasks(tasksContent);
-            } catch (error) {
-              // Tasks file may not exist, which is okay
-              if (process.env.DEBUG) {
-                console.error(`Failed to read tasks file at ${tasksPath}:`, error);
-              }
-            }
-            
-            return {
-              id: changeName,
-              title: this.extractTitle(content, changeName),
-              deltaCount: change.deltas.length,
-              taskStatus,
-            };
-          } catch (error) {
-            return {
-              id: changeName,
-              title: 'Unknown',
-              deltaCount: 0,
-              taskStatus: { total: 0, completed: 0 },
-            };
-          }
-        })
-      );
-      
-      const sorted = changeDetails.sort((a, b) => a.id.localeCompare(b.id));
-      console.log(JSON.stringify(sorted, null, 2));
-    } else {
-      if (changes.length === 0) {
-        console.log('No items found');
-        return;
-      }
-      const sorted = [...changes].sort();
-      if (!options?.long) {
-        // IDs only
-        sorted.forEach(id => console.log(id));
-        return;
-      }
-
-      // Long format: id: title and minimal counts
-      for (const changeName of sorted) {
-        const proposalPath = path.join(changesPath, changeName, 'proposal.md');
-        const tasksPath = path.join(changesPath, changeName, 'tasks.md');
-        try {
-          const content = await fs.readFile(proposalPath, 'utf-8');
-          const title = this.extractTitle(content, changeName);
-          let taskStatusText = '';
-          try {
-            const tasksContent = await fs.readFile(tasksPath, 'utf-8');
-            const { total, completed } = this.countTasks(tasksContent);
-            taskStatusText = ` [tasks ${completed}/${total}]`;
-          } catch (error) {
-            if (process.env.DEBUG) {
-              console.error(`Failed to read tasks file at ${tasksPath}:`, error);
-            }
-          }
-          const changeDir = path.join(changesPath, changeName);
-          const parser = new ChangeParser(await fs.readFile(proposalPath, 'utf-8'), changeDir);
-          const change = await parser.parseChangeWithDeltas(changeName);
-          const deltaCountText = ` [deltas ${change.deltas.length}]`;
-          console.log(`${changeName}: ${title}${deltaCountText}${taskStatusText}`);
-        } catch {
-          console.log(`${changeName}: (unable to read)`);
-        }
-      }
-    }
-  }
-
-  async validate(changeName?: string, options?: { strict?: boolean; json?: boolean; noInteractive?: boolean }): Promise<void> {
-    const changesPath = path.join(process.cwd(), 'prompter', 'changes');
-    
-    if (!changeName) {
-      const canPrompt = isInteractive(options);
-      const changes = await getActiveChangeIds();
-      if (canPrompt && changes.length > 0) {
-        const { select } = await import('@inquirer/prompts');
-        const selected = await select({
-          message: 'Select a change to validate',
-          choices: changes.map(id => ({ name: id, value: id })),
-        });
-        changeName = selected;
-      } else {
-        if (changes.length === 0) {
-          console.error('No change specified. No active changes found.');
-        } else {
-          console.error(`No change specified. Available IDs: ${changes.join(', ')}`);
-        }
-        console.error('Hint: use "prompter change list" to view available changes.');
-        process.exitCode = 1;
-        return;
-      }
-    }
-    
-    const changeDir = path.join(changesPath, changeName);
-    
-    try {
-      await fs.access(changeDir);
-    } catch {
-      throw new Error(`Change "${changeName}" not found at ${changeDir}`);
-    }
-    
-    const validator = new Validator(options?.strict || false);
-    const report = await validator.validateChangeDeltaSpecs(changeDir);
-    
-    if (options?.json) {
-      console.log(JSON.stringify(report, null, 2));
-    } else {
-      if (report.valid) {
-        console.log(`Change "${changeName}" is valid`);
-      } else {
-        console.error(`Change "${changeName}" has issues`);
-        report.issues.forEach(issue => {
-          const label = issue.level === 'ERROR' ? 'ERROR' : 'WARNING';
-          const prefix = issue.level === 'ERROR' ? '✗' : '⚠';
-          console.error(`${prefix} [${label}] ${issue.path}: ${issue.message}`);
-        });
-        // Next steps footer to guide fixing issues
-        this.printNextSteps();
-        if (!options?.json) {
-          process.exitCode = 1;
-        }
-      }
-    }
-  }
-
-  private async getActiveChanges(changesPath: string): Promise<string[]> {
-    try {
-      const entries = await fs.readdir(changesPath, { withFileTypes: true });
-      const result: string[] = [];
-      for (const entry of entries) {
-        if (!entry.isDirectory() || entry.name.startsWith('.') || entry.name === ARCHIVE_DIR) continue;
-        const proposalPath = path.join(changesPath, entry.name, 'proposal.md');
-        try {
-          await fs.access(proposalPath);
-          result.push(entry.name);
-        } catch {
-          // skip directories without proposal.md
-        }
-      }
-      return result.sort();
-    } catch {
-      return [];
-    }
-  }
-
-  private extractTitle(content: string, changeName: string): string {
-    const match = content.match(/^#\s+(?:Change:\s+)?(.+)$/im);
-    return match ? match[1].trim() : changeName;
-  }
-
-  private countTasks(content: string): { total: number; completed: number } {
-    const lines = content.split('\n');
-    let total = 0;
-    let completed = 0;
-    
-    for (const line of lines) {
-      if (line.match(TASK_PATTERN)) {
-        total++;
-        if (line.match(COMPLETED_TASK_PATTERN)) {
-          completed++;
-        }
-      }
-    }
-    
-    return { total, completed };
-  }
-
-  private printNextSteps(): void {
-    const bullets: string[] = [];
-    bullets.push('- Ensure change has deltas in specs/: use headers ## ADDED/MODIFIED/REMOVED/RENAMED Requirements');
-    bullets.push('- Each requirement MUST include at least one #### Scenario: block');
-    bullets.push('- Debug parsed deltas: prompter change show <id> --json --deltas-only');
-    console.error('Next steps:');
-    bullets.forEach(b => console.error(`  ${b}`));
-  }
-}

package/src/commands/config.ts

@@ -1,233 +0,0 @@
-import { Command } from 'commander';
-import { spawn } from 'node:child_process';
-import * as fs from 'node:fs';
-import {
-  getGlobalConfigPath,
-  getGlobalConfig,
-  saveGlobalConfig,
-  GlobalConfig,
-} from '../core/global-config.js';
-import {
-  getNestedValue,
-  setNestedValue,
-  deleteNestedValue,
-  coerceValue,
-  formatValueYaml,
-  validateConfigKeyPath,
-  validateConfig,
-  DEFAULT_CONFIG,
-} from '../core/config-schema.js';
-
-/**
- * Register the config command and all its subcommands.
- *
- * @param program - The Commander program instance
- */
-export function registerConfigCommand(program: Command): void {
-  const configCmd = program
-    .command('config')
-    .description('View and modify global Prompter configuration')
-    .option('--scope <scope>', 'Config scope (only "global" supported currently)')
-    .hook('preAction', (thisCommand) => {
-      const opts = thisCommand.opts();
-      if (opts.scope && opts.scope !== 'global') {
-        console.error('Error: Project-local config is not yet implemented');
-        process.exit(1);
-      }
-    });
-
-  // config path
-  configCmd
-    .command('path')
-    .description('Show config file location')
-    .action(() => {
-      console.log(getGlobalConfigPath());
-    });
-
-  // config list
-  configCmd
-    .command('list')
-    .description('Show all current settings')
-    .option('--json', 'Output as JSON')
-    .action((options: { json?: boolean }) => {
-      const config = getGlobalConfig();
-
-      if (options.json) {
-        console.log(JSON.stringify(config, null, 2));
-      } else {
-        console.log(formatValueYaml(config));
-      }
-    });
-
-  // config get
-  configCmd
-    .command('get <key>')
-    .description('Get a specific value (raw, scriptable)')
-    .action((key: string) => {
-      const config = getGlobalConfig();
-      const value = getNestedValue(config as Record<string, unknown>, key);
-
-      if (value === undefined) {
-        process.exitCode = 1;
-        return;
-      }
-
-      if (typeof value === 'object' && value !== null) {
-        console.log(JSON.stringify(value));
-      } else {
-        console.log(String(value));
-      }
-    });
-
-  // config set
-  configCmd
-    .command('set <key> <value>')
-    .description('Set a value (auto-coerce types)')
-    .option('--string', 'Force value to be stored as string')
-    .option('--allow-unknown', 'Allow setting unknown keys')
-    .action((key: string, value: string, options: { string?: boolean; allowUnknown?: boolean }) => {
-      const allowUnknown = Boolean(options.allowUnknown);
-      const keyValidation = validateConfigKeyPath(key);
-      if (!keyValidation.valid && !allowUnknown) {
-        const reason = keyValidation.reason ? ` ${keyValidation.reason}.` : '';
-        console.error(`Error: Invalid configuration key "${key}".${reason}`);
-        console.error('Use "prompter config list" to see available keys.');
-        console.error('Pass --allow-unknown to bypass this check.');
-        process.exitCode = 1;
-        return;
-      }
-
-      const config = getGlobalConfig() as Record<string, unknown>;
-      const coercedValue = coerceValue(value, options.string || false);
-
-      // Create a copy to validate before saving
-      const newConfig = JSON.parse(JSON.stringify(config));
-      setNestedValue(newConfig, key, coercedValue);
-
-      // Validate the new config
-      const validation = validateConfig(newConfig);
-      if (!validation.success) {
-        console.error(`Error: Invalid configuration - ${validation.error}`);
-        process.exitCode = 1;
-        return;
-      }
-
-      // Apply changes and save
-      setNestedValue(config, key, coercedValue);
-      saveGlobalConfig(config as GlobalConfig);
-
-      const displayValue =
-        typeof coercedValue === 'string' ? `"${coercedValue}"` : String(coercedValue);
-      console.log(`Set ${key} = ${displayValue}`);
-    });
-
-  // config unset
-  configCmd
-    .command('unset <key>')
-    .description('Remove a key (revert to default)')
-    .action((key: string) => {
-      const config = getGlobalConfig() as Record<string, unknown>;
-      const existed = deleteNestedValue(config, key);
-
-      if (existed) {
-        saveGlobalConfig(config as GlobalConfig);
-        console.log(`Unset ${key} (reverted to default)`);
-      } else {
-        console.log(`Key "${key}" was not set`);
-      }
-    });
-
-  // config reset
-  configCmd
-    .command('reset')
-    .description('Reset configuration to defaults')
-    .option('--all', 'Reset all configuration (required)')
-    .option('-y, --yes', 'Skip confirmation prompts')
-    .action(async (options: { all?: boolean; yes?: boolean }) => {
-      if (!options.all) {
-        console.error('Error: --all flag is required for reset');
-        console.error('Usage: prompter config reset --all [-y]');
-        process.exitCode = 1;
-        return;
-      }
-
-      if (!options.yes) {
-        const { confirm } = await import('@inquirer/prompts');
-        const confirmed = await confirm({
-          message: 'Reset all configuration to defaults?',
-          default: false,
-        });
-
-        if (!confirmed) {
-          console.log('Reset cancelled.');
-          return;
-        }
-      }
-
-      saveGlobalConfig({ ...DEFAULT_CONFIG });
-      console.log('Configuration reset to defaults');
-    });
-
-  // config edit
-  configCmd
-    .command('edit')
-    .description('Open config in $EDITOR')
-    .action(async () => {
-      const editor = process.env.EDITOR || process.env.VISUAL;
-
-      if (!editor) {
-        console.error('Error: No editor configured');
-        console.error('Set the EDITOR or VISUAL environment variable to your preferred editor');
-        console.error('Example: export EDITOR=vim');
-        process.exitCode = 1;
-        return;
-      }
-
-      const configPath = getGlobalConfigPath();
-
-      // Ensure config file exists with defaults
-      if (!fs.existsSync(configPath)) {
-        saveGlobalConfig({ ...DEFAULT_CONFIG });
-      }
-
-      // Spawn editor and wait for it to close
-      // Avoid shell parsing to correctly handle paths with spaces in both
-      // the editor path and config path
-      const child = spawn(editor, [configPath], {
-        stdio: 'inherit',
-        shell: false,
-      });
-
-      await new Promise<void>((resolve, reject) => {
-        child.on('close', (code) => {
-          if (code === 0) {
-            resolve();
-          } else {
-            reject(new Error(`Editor exited with code ${code}`));
-          }
-        });
-        child.on('error', reject);
-      });
-
-      try {
-        const rawConfig = fs.readFileSync(configPath, 'utf-8');
-        const parsedConfig = JSON.parse(rawConfig);
-        const validation = validateConfig(parsedConfig);
-
-        if (!validation.success) {
-          console.error(`Error: Invalid configuration - ${validation.error}`);
-          process.exitCode = 1;
-        }
-      } catch (error) {
-        if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
-          console.error(`Error: Config file not found at ${configPath}`);
-        } else if (error instanceof SyntaxError) {
-          console.error(`Error: Invalid JSON in ${configPath}`);
-          console.error(error.message);
-        } else {
-          console.error(`Error: Unable to validate configuration - ${error instanceof Error ? error.message : String(error)}`);
-        }
-        process.exitCode = 1;
-      }
-    });
-}

package/src/commands/guide.ts

@@ -1,50 +0,0 @@
-import chalk from 'chalk';
-
-export class GuideCommand {
-    async execute(): Promise<void> {
-        console.log(chalk.blue('\nGuides:'));
-        console.log(chalk.gray('  1. Provide a detailed and filled-out version of the "prompter/project.md"'));
-        console.log(chalk.gray('     document based on the project\'s specifics, including a clear description'));
-        console.log(chalk.gray('     of the project, its purpose, the technologies used (tech stack), and any'));
-        console.log(chalk.gray('     conventions or standards being followed.'));
-        
-        console.log(chalk.blue('\nDocument Workflow & Dependencies:'));
-        console.log(chalk.gray('  This table shows the recommended order for document generation:\n'));
-        
-        // Print table header
-        console.log(chalk.cyan('  Document         │ Required Inputs                       │ Extra Inputs                      │ Recommended Model'));
-        console.log(chalk.cyan('  ─────────────────┼───────────────────────────────────────┼───────────────────────────────────┼──────────────────────────'));
-        
-        // Table rows
-        const rows = [
-            ['Product Brief   ', '—                                    ', '—                                ', 'Opus'],
-            ['PRD             ', 'Product Brief                        ', '—                                ', 'Sonnet'],
-            ['FSD             ', 'PRD                                  ', 'Product Brief                    ', 'Sonnet'],
-            ['ERD             ', 'FSD                                  ', '—                                ', 'Sonnet'],
-            ['API Contract    ', 'FSD + ERD                            ', '—                                ', 'Sonnet / GPT 5.2 Codex'],
-            ['UI Wireframes   ', 'FSD + ERD + API Contract             ', '—                                ', 'Gemini 3 Pro / Sonnet'],
-            ['Design System   ', 'UI Wireframes (new) / FSD (existing) ', 'Brand guide / existing UI        ', 'Sonnet'],
-            ['TDD             ', 'FSD                                  ', 'ERD + API + UI + Design System   ', 'Sonnet'],
-            ['Epics           ', 'FSD + TDD-Lite                       ', 'UI Wireframes + Design System    ', 'Sonnet'],
-            ['Stories         ', 'Epics                                ', 'FSD + UI Wireframes + API        ', 'Sonnet'],
-            ['Proposal        ', 'Specs (FSD/TDD/etc)                  ', '—                                ', 'Opus'],
-            ['Apply           ', 'Approved Proposal                    ', '—                                ', 'Sonnet / Gemini 3 / GPT 5.2 / GLM / Haiku']
-        ];
-        
-        rows.forEach(row => {
-            console.log(chalk.gray(`  ${row[0]} │ ${row[1]} │ ${row[2]} │ ${row[3]}`));
-        });
-
-        console.log(chalk.blue('\n Complexity-Based Workflows:'));
-        console.log(chalk.gray('  Small    → Brief → FSD → Design System → Stories'));
-        console.log(chalk.gray('  Medium   → Brief → PRD → FSD → UI → Design System → Stories'));
-        console.log(chalk.gray('  High     → Brief → PRD → FSD → ERD → API → UI → Design System → TDD → Epics → Stories'));
-
-        console.log(chalk.blue('\n Prompter Solo Dev 🤓 Workflow:'));
-        console.log(chalk.green.bold(' Step 1 📄: Brief → PRD → Epic (Foundation)'));
-        console.log(chalk.green.bold(' Step 2 🚀: [ Proposal ⇄ Apply ⇄ Archive ] ↺ (Development Loop)'));
-        console.log(chalk.gray('     • Initial setup: Create Brief, PRD and Epic to establish context.'));
-        console.log(chalk.gray('     • Active Dev: Repeat Step 2 for every feature, bugfix, or improvement.'));
-        console.log(chalk.gray('     • Archive step automatically updates your specs to keep them current.'));
-    }
-}