@dedesfr/prompter 0.8.23 → 1.0.0

package/skills/ui-ux-pro/references/design-principles.md

@@ -1,167 +0,0 @@
-# Design Principles — Anti-AI Aesthetic & Authentic Design Craft
-
-Reference for producing designs that feel human-crafted, intentional, and unique. Load this when implementing designs or reviewing design quality.
-
----
-
-## Anti-AI-Look Patterns
-
-AI-generated designs share recognizable traits. Avoid these to produce authentic work.
-
-### Layout Anti-Patterns
-
-| AI Trap | Why It Feels Generic | Do Instead |
-|---|---|---|
-| Perfect 3-column symmetry for everything | Real content isn't symmetric | Vary column widths, use 2-col or asymmetric grids |
-| Every section is full-width hero + centered text | Repetitive rhythm, no visual variety | Mix layout types: sidebar, offset, editorial, split |
-| Giant hero with headline + subtitle + CTA on every page | Cookie-cutter template feel | Match the hero to content importance — some pages don't need one |
-| Everything centered on the page | Monotonous visual flow | Use left-aligned text with intentional center/right accents |
-| Equal spacing everywhere | Flat, robotic rhythm | Vary spacing to create grouping and breathing room |
-| Card grids with identical card sizes | Catalog/stock feel | Vary card sizes, feature one, use masonry or editorial layouts |
-
-### Color Anti-Patterns
-
-| AI Trap | Why It Feels Generic | Do Instead |
-|---|---|---|
-| Blue-to-purple gradient as primary | Overused AI default | Choose a palette rooted in the brand or project's personality |
-| Neon accent on dark background | "Tech startup template" look | Use muted, sophisticated accents — or bold ones with restraint |
-| Using 6+ colors with equal prominence | Visual noise, no hierarchy | 1-2 primary colors, 1 accent, rest neutrals |
-| Gradient backgrounds on every section | Decorative without purpose | Use solid colors; reserve gradients for specific emphasis |
-| Pure black (#000) text on pure white (#fff) | Harsh contrast, screen glare | Use near-black (#1a1a1a–#2d2d2d) on off-white (#f8f8f8–#fafafa) |
-| Colored shadows (purple/blue box-shadows) | Trendy but rarely appropriate | Neutral shadows unless the brand specifically calls for it |
-
-### Typography Anti-Patterns
-
-| AI Trap | Why It Feels Generic | Do Instead |
-|---|---|---|
-| Using Inter/Poppins/Montserrat for everything | Ubiquitous AI defaults | Consider the project's personality — serif for editorial, geometric sans for tech, humanist for approachable |
-| Only 2 sizes: heading and body | Flat hierarchy | Use a proper type scale (e.g., 12/14/16/20/24/32/48) |
-| All text in the same weight | No emphasis, everything competes | Use 2-3 weights (regular, medium, bold) with clear purpose |
-| ALL CAPS EVERYWHERE | Aggressive, hard to read | Reserve caps for small labels, buttons, or overlines |
-| Giant display text with no supporting content | Empty visual calories | Size should match content importance |
-
-### Component Anti-Patterns
-
-| AI Trap | Why It Feels Generic | Do Instead |
-|---|---|---|
-| border-radius: 9999px on everything | Bubbly, toy-like | Choose 1-2 radius values that match the design's tone (4-8px for sharp, 12-16px for soft) |
-| Glassmorphism / frosted glass everywhere | Trend over function | Use glass effects sparingly where depth communication is needed |
-| Drop shadows on everything | Visual heaviness, everything "floats" | Shadow only elements that conceptually need elevation (modals, dropdowns, cards on hover) |
-| Outlined icon + outlined button + outlined card | Everything is a border, nothing has weight | Mix filled and outlined treatments for hierarchy |
-| Decorative blob SVGs or wave dividers | Instant AI template identifier | Use geometric shapes with purpose, or no decoration at all |
-| Stock illustration people with purple skin | Unmistakable AI/startup template | Use photography, custom illustration, or no illustration |
-
-### Interaction Anti-Patterns
-
-| AI Trap | Why It Feels Generic | Do Instead |
-|---|---|---|
-| Everything has a hover scale(1.05) | Bouncy, distracting | Reserve scale for interactive cards; use color/shadow changes for most hover states |
-| 0.3s ease on everything | Sluggish, indiscriminate | Use faster transitions (150-200ms) for small elements, slower (300-400ms) for layout changes |
-| Fade-in-up on scroll for every element | Scroll-jacking, animation fatigue | Animate only key content on first appearance; let secondary content be static |
-| Loading spinners as the only loading state | No context about what's loading | Use skeleton screens, progressive content reveal, or inline loading indicators |
-
----
-
-## Authentic Design Principles
-
-### 1. Content-First Hierarchy
-
-Design serves content, not the other way around.
-
-- Read the actual content before choosing layout
-- Size elements proportional to their importance
-- Use whitespace to group related content and separate sections
-- Ask: "What should the user see first, second, third?"
-
-### 2. Intentional Contrast
-
-Every visual difference should communicate something.
-
-- **Size contrast** — Headings vs. body, featured vs. standard items
-- **Weight contrast** — Bold labels vs. regular values, strong CTAs vs. subtle links
-- **Color contrast** — Primary actions vs. secondary, active states vs. default
-- **Space contrast** — Tight groups of related items, generous gaps between sections
-- **Density contrast** — Dense data areas vs. breathing hero/summary areas
-
-### 3. Systematic but Not Robotic
-
-Use systems (type scale, spacing scale, color tokens) but break them intentionally.
-
-- Establish a base grid (4px or 8px) but don't snap everything mechanically
-- Use your type scale but occasionally break it for display/hero moments
-- Maintain consistent component patterns but allow contextual variations
-
-### 4. Typography Does the Heavy Lifting
-
-Most visual hierarchy comes from type, not decoration.
-
-- Establish a clear scale: body → subhead → section head → page title → display
-- Use weight and size together: a 14px bold label and a 16px regular body text create clear hierarchy without needing different colors
-- Line-height matters: tighter for headings (1.1-1.3), looser for body (1.5-1.7)
-- Letter-spacing: slightly positive for small caps/labels, zero or negative for large display text
-
-### 5. Color as Communication
-
-Color should mean something, not just decorate.
-
-- **Brand color** — Primary actions, key elements, brand identity
-- **Semantic color** — Success (green), warning (amber), error (red), info (blue)
-- **Neutral palette** — Background, text, borders, dividers (this is 80% of your palette)
-- **Accent** — Sparingly, to draw attention to one thing
-
-### 6. Space Creates Meaning
-
-Proximity and spacing communicate relationships.
-
-- Items close together = related
-- Items far apart = separate concepts
-- Consistent internal padding = belonging to the same container
-- Asymmetric margins = visual rhythm and movement
-
----
-
-## Design Quality Checklist
-
-Use this to evaluate designs before presenting to the user:
-
-### Visual Hierarchy
-- [ ] The most important element is visually dominant
-- [ ] There is a clear reading order (F-pattern or Z-pattern where appropriate)
-- [ ] Headings form a logical scale (not random sizes)
-- [ ] CTAs are visually distinct from surrounding content
-
-### Typography
-- [ ] Body text is 16px+ for readability
-- [ ] Line length is 45-75 characters for body text
-- [ ] Heading/body font pairing is intentional
-- [ ] No more than 3 font weights in active use
-
-### Color
-- [ ] Palette has 2 or fewer primary/accent colors
-- [ ] Text:background contrast meets WCAG AA (4.5:1 for body, 3:1 for large text)
-- [ ] Color is not the only indicator of state (icons, text, or shape also signal)
-- [ ] Neutral palette has enough range (light bg, medium borders, dark text)
-
-### Spacing & Layout
-- [ ] Spacing follows a consistent scale (4px, 8px, 12px, 16px, 24px, 32px, 48px, 64px)
-- [ ] Related elements are grouped with tighter spacing
-- [ ] Sections have comfortable breathing room
-- [ ] Layout works at mobile, tablet, and desktop widths
-
-### Components
-- [ ] Interactive elements have visible hover/focus states
-- [ ] Buttons have clear hierarchy (primary, secondary, tertiary/ghost)
-- [ ] Form inputs have labels, placeholders are not used as labels
-- [ ] Empty states, loading states, and error states are designed
-
-### Interaction
-- [ ] Transitions are fast (150-200ms) and purposeful
-- [ ] Hover states indicate interactivity without being distracting
-- [ ] Focus indicators are visible for keyboard navigation
-- [ ] Animations don't block user interaction
-
-### Authenticity
-- [ ] Design doesn't match common template/AI patterns listed above
-- [ ] Layout has visual variety (not repeating the same section format)
-- [ ] Decoration (if any) serves a purpose
-- [ ] The design reflects the project's unique personality

package/src/cli/index.ts

@@ -1,223 +0,0 @@
-import ora from 'ora';
-import { Command } from 'commander';
-import { InitCommand } from '../commands/init.js';
-import { UpdateCommand } from '../commands/update.js';
-import { ListCommand } from '../commands/list.js';
-import { GuideCommand } from '../commands/guide.js';
-import { UpgradeCommand } from '../commands/upgrade.js';
-import { ViewCommand } from '../core/view.js';
-import { ChangeCommand } from '../commands/change.js';
-import { registerSpecCommand } from '../commands/spec.js';
-import { registerConfigCommand } from '../commands/config.js';
-import { ValidateCommand } from '../commands/validate.js';
-import { ShowCommand } from '../commands/show.js';
-import { ArchiveCommand } from '../commands/archive.js';
-
-const program = new Command();
-
-program
-  .name('prompter')
-  .description('Enhance prompts directly in your AI coding workflow')
-  .version('0.8.23');
-
-program
-  .command('init')
-  .description('Initialize Prompter in your project')
-  .option('--tools <tools...>', 'Specify AI tools to configure (antigravity, claude, codex, github-copilot, opencode, kilocode)')
-  .option('--prompts <prompts...>', 'Specify prompts to install (ai-humanizer, api-contract-generator, apply, archive, design-system, document-explainer, epic-single, epic-generator, erd-generator, fsd-generator, prd-agent-generator, prd-generator, product-brief, proposal, qa-test-scenario, skill-creator, story-single, story-generator, tdd-generator, tdd-lite-generator, wireframe-generator)')
-  .option('--skills <skills...>', 'Specify skills to install by name (e.g. laravel-code-review design-system-generator)')
-  .option('--no-interactive', 'Run without interactive prompts')
-  .action(async (options) => {
-    const initCommand = new InitCommand();
-    await initCommand.execute(options);
-  });
-
-program
-  .command('update')
-  .description('Update Prompter workflow files to latest version')
-  .action(async () => {
-    const updateCommand = new UpdateCommand();
-    await updateCommand.execute();
-  });
-
-program
-  .command('list')
-  .description('List items (changes by default). Use --specs to list specs.')
-  .option('--specs', 'List specs instead of changes')
-  .option('--changes', 'List changes explicitly (default)')
-  .option('--sort <order>', 'Sort order: "recent" (default) or "name"', 'recent')
-  .option('--json', 'Output as JSON (for programmatic use)')
-  .action(async (options?: { specs?: boolean; changes?: boolean; sort?: string; json?: boolean }) => {
-    try {
-      const listCommand = new ListCommand();
-      const mode: 'changes' | 'specs' = options?.specs ? 'specs' : 'changes';
-      const sort = options?.sort === 'name' ? 'name' : 'recent';
-      await listCommand.execute('.', mode, { sort, json: options?.json });
-    } catch (error) {
-      console.log(); // Empty line for spacing
-      process.exit(1);
-    }
-  });
-
-program
-  .command('view')
-  .description('Display an interactive dashboard of specs and changes')
-  .action(async () => {
-    try {
-      const viewCommand = new ViewCommand();
-      await viewCommand.execute('.');
-    } catch (error) {
-      console.log(); // Empty line for spacing
-      process.exit(1);
-    }
-  });
-
-program
-  .command('guide')
-  .description('Show setup guide for Prompter')
-  .action(async () => {
-    const guideCommand = new GuideCommand();
-    await guideCommand.execute();
-  });
-
-program
-  .command('upgrade')
-  .description('Upgrade Prompter to the latest version')
-  .action(async () => {
-    const upgradeCommand = new UpgradeCommand();
-    await upgradeCommand.execute();
-  });
-
-// Change command with subcommands
-const changeCmd = program
-  .command('change')
-  .description('Manage Prompter change proposals');
-
-// Deprecation notice for noun-based commands
-changeCmd.hook('preAction', () => {
-  console.error('Warning: The "prompter change ..." commands are deprecated. Prefer verb-first commands (e.g., "prompter list", "prompter validate --changes").');
-});
-
-changeCmd
-  .command('show [change-name]')
-  .description('Show a change proposal in JSON or markdown format')
-  .option('--json', 'Output as JSON')
-  .option('--deltas-only', 'Show only deltas (JSON only)')
-  .option('--requirements-only', 'Alias for --deltas-only (deprecated)')
-  .option('--no-interactive', 'Disable interactive prompts')
-  .action(async (changeName?: string, options?: { json?: boolean; requirementsOnly?: boolean; deltasOnly?: boolean; noInteractive?: boolean }) => {
-    try {
-      const changeCommand = new ChangeCommand();
-      await changeCommand.show(changeName, options);
-    } catch (error) {
-      console.error(`Error: ${(error as Error).message}`);
-      process.exitCode = 1;
-    }
-  });
-
-changeCmd
-  .command('list')
-  .description('List all active changes (DEPRECATED: use "prompter list" instead)')
-  .option('--json', 'Output as JSON')
-  .option('--long', 'Show id and title with counts')
-  .action(async (options?: { json?: boolean; long?: boolean }) => {
-    try {
-      console.error('Warning: "prompter change list" is deprecated. Use "prompter list".');
-      const changeCommand = new ChangeCommand();
-      await changeCommand.list(options);
-    } catch (error) {
-      console.error(`Error: ${(error as Error).message}`);
-      process.exitCode = 1;
-    }
-  });
-
-changeCmd
-  .command('validate [change-name]')
-  .description('Validate a change proposal')
-  .option('--strict', 'Enable strict validation mode')
-  .option('--json', 'Output validation report as JSON')
-  .option('--no-interactive', 'Disable interactive prompts')
-  .action(async (changeName?: string, options?: { strict?: boolean; json?: boolean; noInteractive?: boolean }) => {
-    try {
-      const changeCommand = new ChangeCommand();
-      await changeCommand.validate(changeName, options);
-      if (typeof process.exitCode === 'number' && process.exitCode !== 0) {
-        process.exit(process.exitCode);
-      }
-    } catch (error) {
-      console.error(`Error: ${(error as Error).message}`);
-      process.exitCode = 1;
-    }
-  });
-
-program
-  .command('archive [change-name]')
-  .description('Archive a completed change and update main specs')
-  .option('-y, --yes', 'Skip confirmation prompts')
-  .option('--skip-specs', 'Skip spec update operations (useful for infrastructure, tooling, or doc-only changes)')
-  .option('--no-validate', 'Skip validation (not recommended, requires confirmation)')
-  .action(async (changeName?: string, options?: { yes?: boolean; skipSpecs?: boolean; noValidate?: boolean; validate?: boolean }) => {
-    try {
-      const archiveCommand = new ArchiveCommand();
-      await archiveCommand.execute(changeName, options);
-    } catch (error) {
-      console.log(); // Empty line for spacing
-      ora().fail(`Error: ${(error as Error).message}`);
-      process.exit(1);
-    }
-  });
-
-registerSpecCommand(program);
-registerConfigCommand(program);
-
-// Top-level validate command
-program
-  .command('validate [item-name]')
-  .description('Validate changes and specs')
-  .option('--all', 'Validate all changes and specs')
-  .option('--changes', 'Validate all changes')
-  .option('--specs', 'Validate all specs')
-  .option('--type <type>', 'Specify item type when ambiguous: change|spec')
-  .option('--strict', 'Enable strict validation mode')
-  .option('--json', 'Output validation results as JSON')
-  .option('--concurrency <n>', 'Max concurrent validations (defaults to env PROMPTER_CONCURRENCY or 6)')
-  .option('--no-interactive', 'Disable interactive prompts')
-  .action(async (itemName?: string, options?: { all?: boolean; changes?: boolean; specs?: boolean; type?: string; strict?: boolean; json?: boolean; noInteractive?: boolean; concurrency?: string }) => {
-    try {
-      const validateCommand = new ValidateCommand();
-      await validateCommand.execute(itemName, options);
-    } catch (error) {
-      console.log();
-      process.exit(1);
-    }
-  });
-
-// Top-level show command
-program
-  .command('show [item-name]')
-  .description('Show a change or spec')
-  .option('--json', 'Output as JSON')
-  .option('--type <type>', 'Specify item type when ambiguous: change|spec')
-  .option('--no-interactive', 'Disable interactive prompts')
-  // change-only flags
-  .option('--deltas-only', 'Show only deltas (JSON only, change)')
-  .option('--requirements-only', 'Alias for --deltas-only (deprecated, change)')
-  // spec-only flags
-  .option('--requirements', 'JSON only: Show only requirements (exclude scenarios)')
-  .option('--no-scenarios', 'JSON only: Exclude scenario content')
-  .option('-r, --requirement <id>', 'JSON only: Show specific requirement by ID (1-based)')
-  // allow unknown options to pass-through to underlying command implementation
-  .allowUnknownOption(true)
-  .action(async (itemName?: string, options?: { json?: boolean; type?: string; noInteractive?: boolean;[k: string]: any }) => {
-    try {
-      const showCommand = new ShowCommand();
-      await showCommand.execute(itemName, options ?? {});
-    } catch (error) {
-      console.log();
-      process.exit(1);
-    }
-  });
-
-
-
-program.parse();

package/src/commands/archive.ts

@@ -1,302 +0,0 @@
-import { promises as fs } from 'fs';
-import path from 'path';
-import { getTaskProgressForChange, formatTaskStatus } from '../utils/task-progress.js';
-import { Validator } from '../core/validation/validator.js';
-import chalk from 'chalk';
-import {
-  findSpecUpdates,
-  buildUpdatedSpec,
-  writeUpdatedSpec,
-  type SpecUpdate,
-} from '../core/specs-apply.js';
-
-export class ArchiveCommand {
-  async execute(
-    changeName?: string,
-    options: { yes?: boolean; skipSpecs?: boolean; noValidate?: boolean; validate?: boolean } = {}
-  ): Promise<void> {
-    const targetPath = '.';
-    const changesDir = path.join(targetPath, 'prompter', 'changes');
-    const archiveDir = path.join(changesDir, 'archive');
-    const mainSpecsDir = path.join(targetPath, 'prompter', 'specs');
-
-    // Check if changes directory exists
-    try {
-      await fs.access(changesDir);
-    } catch {
-      throw new Error("No Prompter changes directory found. Run 'prompter init' first.");
-    }
-
-    // Get change name interactively if not provided
-    if (!changeName) {
-      const selectedChange = await this.selectChange(changesDir);
-      if (!selectedChange) {
-        console.log('No change selected. Aborting.');
-        return;
-      }
-      changeName = selectedChange;
-    }
-
-    const changeDir = path.join(changesDir, changeName);
-
-    // Verify change exists
-    try {
-      const stat = await fs.stat(changeDir);
-      if (!stat.isDirectory()) {
-        throw new Error(`Change '${changeName}' not found.`);
-      }
-    } catch {
-      throw new Error(`Change '${changeName}' not found.`);
-    }
-
-    const skipValidation = options.validate === false || options.noValidate === true;
-
-    // Validate specs and change before archiving
-    if (!skipValidation) {
-      const validator = new Validator();
-      let hasValidationErrors = false;
-
-      // Validate proposal.md (non-blocking unless strict mode desired in future)
-      const changeFile = path.join(changeDir, 'proposal.md');
-      try {
-        await fs.access(changeFile);
-        const changeReport = await validator.validateChange(changeFile);
-        // Proposal validation is informative only (do not block archive)
-        if (!changeReport.valid) {
-          console.log(chalk.yellow(`\nProposal warnings in proposal.md (non-blocking):`));
-          for (const issue of changeReport.issues) {
-            const symbol = issue.level === 'ERROR' ? '⚠' : (issue.level === 'WARNING' ? '⚠' : 'ℹ');
-            console.log(chalk.yellow(`  ${symbol} ${issue.message}`));
-          }
-        }
-      } catch {
-        // Change file doesn't exist, skip validation
-      }
-
-      // Validate delta-formatted spec files under the change directory if present
-      const changeSpecsDir = path.join(changeDir, 'specs');
-      let hasDeltaSpecs = false;
-      try {
-        const candidates = await fs.readdir(changeSpecsDir, { withFileTypes: true });
-        for (const c of candidates) {
-          if (c.isDirectory()) {
-            try {
-              const candidatePath = path.join(changeSpecsDir, c.name, 'spec.md');
-              await fs.access(candidatePath);
-              const content = await fs.readFile(candidatePath, 'utf-8');
-              if (/^##\s+(ADDED|MODIFIED|REMOVED|RENAMED)\s+Requirements/m.test(content)) {
-                hasDeltaSpecs = true;
-                break;
-              }
-            } catch {}
-          }
-        }
-      } catch {}
-      if (hasDeltaSpecs) {
-        const deltaReport = await validator.validateChangeDeltaSpecs(changeDir);
-        if (!deltaReport.valid) {
-          hasValidationErrors = true;
-          console.log(chalk.red(`\nValidation errors in change delta specs:`));
-          for (const issue of deltaReport.issues) {
-            if (issue.level === 'ERROR') {
-              console.log(chalk.red(`  ✗ ${issue.message}`));
-            } else if (issue.level === 'WARNING') {
-              console.log(chalk.yellow(`  ⚠ ${issue.message}`));
-            }
-          }
-        }
-      }
-
-      if (hasValidationErrors) {
-        console.log(chalk.red('\nValidation failed. Please fix the errors before archiving.'));
-        console.log(chalk.yellow('To skip validation (not recommended), use --no-validate flag.'));
-        return;
-      }
-    } else {
-      // Log warning when validation is skipped
-      const timestamp = new Date().toISOString();
-      
-      if (!options.yes) {
-        const { confirm } = await import('@inquirer/prompts');
-        const proceed = await confirm({
-          message: chalk.yellow('⚠️  WARNING: Skipping validation may archive invalid specs. Continue? (y/N)'),
-          default: false
-        });
-        if (!proceed) {
-          console.log('Archive cancelled.');
-          return;
-        }
-      } else {
-        console.log(chalk.yellow(`\n⚠️  WARNING: Skipping validation may archive invalid specs.`));
-      }
-      
-      console.log(chalk.yellow(`[${timestamp}] Validation skipped for change: ${changeName}`));
-      console.log(chalk.yellow(`Affected files: ${changeDir}`));
-    }
-
-    // Show progress and check for incomplete tasks
-    const progress = await getTaskProgressForChange(changesDir, changeName);
-    const status = formatTaskStatus(progress);
-    console.log(`Task status: ${status}`);
-
-    const incompleteTasks = Math.max(progress.total - progress.completed, 0);
-    if (incompleteTasks > 0) {
-      if (!options.yes) {
-        const { confirm } = await import('@inquirer/prompts');
-        const proceed = await confirm({
-          message: `Warning: ${incompleteTasks} incomplete task(s) found. Continue?`,
-          default: false
-        });
-        if (!proceed) {
-          console.log('Archive cancelled.');
-          return;
-        }
-      } else {
-        console.log(`Warning: ${incompleteTasks} incomplete task(s) found. Continuing due to --yes flag.`);
-      }
-    }
-
-    // Handle spec updates unless skipSpecs flag is set
-    if (options.skipSpecs) {
-      console.log('Skipping spec updates (--skip-specs flag provided).');
-    } else {
-      // Find specs to update
-      const specUpdates = await findSpecUpdates(changeDir, mainSpecsDir);
-      
-      if (specUpdates.length > 0) {
-        console.log('\nSpecs to update:');
-        for (const update of specUpdates) {
-          const status = update.exists ? 'update' : 'create';
-          const capability = path.basename(path.dirname(update.target));
-          console.log(`  ${capability}: ${status}`);
-        }
-
-        let shouldUpdateSpecs = true;
-        if (!options.yes) {
-          const { confirm } = await import('@inquirer/prompts');
-          shouldUpdateSpecs = await confirm({
-            message: 'Proceed with spec updates?',
-            default: true
-          });
-          if (!shouldUpdateSpecs) {
-            console.log('Skipping spec updates. Proceeding with archive.');
-          }
-        }
-
-        if (shouldUpdateSpecs) {
-          // Prepare all updates first (validation pass, no writes)
-          const prepared: Array<{ update: SpecUpdate; rebuilt: string; counts: { added: number; modified: number; removed: number; renamed: number } }> = [];
-          try {
-            for (const update of specUpdates) {
-              const built = await buildUpdatedSpec(update, changeName!);
-              prepared.push({ update, rebuilt: built.rebuilt, counts: built.counts });
-            }
-          } catch (err: any) {
-            console.log(String(err.message || err));
-            console.log('Aborted. No files were changed.');
-            return;
-          }
-
-          // All validations passed; pre-validate rebuilt full spec and then write files and display counts
-          let totals = { added: 0, modified: 0, removed: 0, renamed: 0 };
-          for (const p of prepared) {
-            const specName = path.basename(path.dirname(p.update.target));
-            if (!skipValidation) {
-              const report = await new Validator().validateSpecContent(specName, p.rebuilt);
-              if (!report.valid) {
-                console.log(chalk.red(`\nValidation errors in rebuilt spec for ${specName} (will not write changes):`));
-                for (const issue of report.issues) {
-                  if (issue.level === 'ERROR') console.log(chalk.red(`  ✗ ${issue.message}`));
-                  else if (issue.level === 'WARNING') console.log(chalk.yellow(`  ⚠ ${issue.message}`));
-                }
-                console.log('Aborted. No files were changed.');
-                return;
-              }
-            }
-            await writeUpdatedSpec(p.update, p.rebuilt, p.counts);
-            totals.added += p.counts.added;
-            totals.modified += p.counts.modified;
-            totals.removed += p.counts.removed;
-            totals.renamed += p.counts.renamed;
-          }
-          console.log(
-            `Totals: + ${totals.added}, ~ ${totals.modified}, - ${totals.removed}, → ${totals.renamed}`
-          );
-          console.log('Specs updated successfully.');
-        }
-      }
-    }
-
-    // Create archive directory with date prefix
-    const archiveName = `${this.getArchiveDate()}-${changeName}`;
-    const archivePath = path.join(archiveDir, archiveName);
-
-    // Check if archive already exists
-    try {
-      await fs.access(archivePath);
-      throw new Error(`Archive '${archiveName}' already exists.`);
-    } catch (error: any) {
-      if (error.code !== 'ENOENT') {
-        throw error;
-      }
-    }
-
-    // Create archive directory if needed
-    await fs.mkdir(archiveDir, { recursive: true });
-
-    // Move change to archive
-    await fs.rename(changeDir, archivePath);
-    
-    console.log(`Change '${changeName}' archived as '${archiveName}'.`);
-  }
-
-  private async selectChange(changesDir: string): Promise<string | null> {
-    const { select } = await import('@inquirer/prompts');
-    // Get all directories in changes (excluding archive)
-    const entries = await fs.readdir(changesDir, { withFileTypes: true });
-    const changeDirs = entries
-      .filter(entry => entry.isDirectory() && entry.name !== 'archive')
-      .map(entry => entry.name)
-      .sort();
-
-    if (changeDirs.length === 0) {
-      console.log('No active changes found.');
-      return null;
-    }
-
-    // Build choices with progress inline to avoid duplicate lists
-    let choices: Array<{ name: string; value: string }> = changeDirs.map(name => ({ name, value: name }));
-    try {
-      const progressList: Array<{ id: string; status: string }> = [];
-      for (const id of changeDirs) {
-        const progress = await getTaskProgressForChange(changesDir, id);
-        const status = formatTaskStatus(progress);
-        progressList.push({ id, status });
-      }
-      const nameWidth = Math.max(...progressList.map(p => p.id.length));
-      choices = progressList.map(p => ({
-        name: `${p.id.padEnd(nameWidth)}     ${p.status}`,
-        value: p.id
-      }));
-    } catch {
-      // If anything fails, fall back to simple names
-      choices = changeDirs.map(name => ({ name, value: name }));
-    }
-
-    try {
-      const answer = await select({
-        message: 'Select a change to archive',
-        choices
-      });
-      return answer;
-    } catch (error) {
-      // User cancelled (Ctrl+C)
-      return null;
-    }
-  }
-
-  private getArchiveDate(): string {
-    // Returns date in YYYY-MM-DD format
-    return new Date().toISOString().split('T')[0];
-  }
-}