openspecui 0.0.0 → 0.2.0

package/references/openspec/src/commands/show.ts

@@ -1,139 +0,0 @@
-import { select } from '@inquirer/prompts';
-import path from 'path';
-import { isInteractive } from '../utils/interactive.js';
-import { getActiveChangeIds, getSpecIds } from '../utils/item-discovery.js';
-import { ChangeCommand } from './change.js';
-import { SpecCommand } from './spec.js';
-import { nearestMatches } from '../utils/match.js';
-
-type ItemType = 'change' | 'spec';
-
-const CHANGE_FLAG_KEYS = new Set(['deltasOnly', 'requirementsOnly']);
-const SPEC_FLAG_KEYS = new Set(['requirements', 'scenarios', 'requirement']);
-
-export class ShowCommand {
-  async execute(itemName?: string, options: { json?: boolean; type?: string; noInteractive?: boolean; [k: string]: any } = {}): Promise<void> {
-    const interactive = isInteractive(options.noInteractive);
-    const typeOverride = this.normalizeType(options.type);
-
-    if (!itemName) {
-      if (interactive) {
-        const type = await select<ItemType>({
-          message: 'What would you like to show?',
-          choices: [
-            { name: 'Change', value: 'change' as const },
-            { name: 'Spec', value: 'spec' as const },
-          ],
-        });
-        await this.runInteractiveByType(type, options);
-        return;
-      }
-      this.printNonInteractiveHint();
-      process.exitCode = 1;
-      return;
-    }
-
-    await this.showDirect(itemName, { typeOverride, options });
-  }
-
-  private normalizeType(value?: string): ItemType | undefined {
-    if (!value) return undefined;
-    const v = value.toLowerCase();
-    if (v === 'change' || v === 'spec') return v;
-    return undefined;
-  }
-
-  private async runInteractiveByType(type: ItemType, options: { json?: boolean; noInteractive?: boolean; [k: string]: any }): Promise<void> {
-    if (type === 'change') {
-      const changes = await getActiveChangeIds();
-      if (changes.length === 0) {
-        console.error('No changes found.');
-        process.exitCode = 1;
-        return;
-      }
-      const picked = await select<string>({ message: 'Pick a change', choices: changes.map(id => ({ name: id, value: id })) });
-      const cmd = new ChangeCommand();
-      await cmd.show(picked, options as any);
-      return;
-    }
-
-    const specs = await getSpecIds();
-    if (specs.length === 0) {
-      console.error('No specs found.');
-      process.exitCode = 1;
-      return;
-    }
-    const picked = await select<string>({ message: 'Pick a spec', choices: specs.map(id => ({ name: id, value: id })) });
-    const cmd = new SpecCommand();
-    await cmd.show(picked, options as any);
-  }
-
-  private async showDirect(itemName: string, params: { typeOverride?: ItemType; options: { json?: boolean; [k: string]: any } }): Promise<void> {
-    // Optimize lookups when type is pre-specified
-    let isChange = false;
-    let isSpec = false;
-    let changes: string[] = [];
-    let specs: string[] = [];
-    if (params.typeOverride === 'change') {
-      changes = await getActiveChangeIds();
-      isChange = changes.includes(itemName);
-    } else if (params.typeOverride === 'spec') {
-      specs = await getSpecIds();
-      isSpec = specs.includes(itemName);
-    } else {
-      [changes, specs] = await Promise.all([getActiveChangeIds(), getSpecIds()]);
-      isChange = changes.includes(itemName);
-      isSpec = specs.includes(itemName);
-    }
-
-    const resolvedType = params.typeOverride ?? (isChange ? 'change' : isSpec ? 'spec' : undefined);
-
-    if (!resolvedType) {
-      console.error(`Unknown item '${itemName}'`);
-      const suggestions = nearestMatches(itemName, [...changes, ...specs]);
-      if (suggestions.length) console.error(`Did you mean: ${suggestions.join(', ')}?`);
-      process.exitCode = 1;
-      return;
-    }
-
-    if (!params.typeOverride && isChange && isSpec) {
-      console.error(`Ambiguous item '${itemName}' matches both a change and a spec.`);
-      console.error('Pass --type change|spec, or use: openspec change show / openspec spec show');
-      process.exitCode = 1;
-      return;
-    }
-
-    this.warnIrrelevantFlags(resolvedType, params.options);
-    if (resolvedType === 'change') {
-      const cmd = new ChangeCommand();
-      await cmd.show(itemName, params.options as any);
-      return;
-    }
-    const cmd = new SpecCommand();
-    await cmd.show(itemName, params.options as any);
-  }
-
-  private printNonInteractiveHint(): void {
-    console.error('Nothing to show. Try one of:');
-    console.error('  openspec show <item>');
-    console.error('  openspec change show');
-    console.error('  openspec spec show');
-    console.error('Or run in an interactive terminal.');
-  }
-
-  private warnIrrelevantFlags(type: ItemType, options: { [k: string]: any }): boolean {
-    const irrelevant: string[] = [];
-    if (type === 'change') {
-      for (const k of SPEC_FLAG_KEYS) if (k in options) irrelevant.push(k);
-    } else {
-      for (const k of CHANGE_FLAG_KEYS) if (k in options) irrelevant.push(k);
-    }
-    if (irrelevant.length > 0) {
-      console.error(`Warning: Ignoring flags not applicable to ${type}: ${irrelevant.join(', ')}`);
-      return true;
-    }
-    return false;
-  }
-}
-
-

package/references/openspec/src/commands/spec.ts

@@ -1,250 +0,0 @@
-import { program } from 'commander';
-import { existsSync, readdirSync, readFileSync } from 'fs';
-import { join } from 'path';
-import { MarkdownParser } from '../core/parsers/markdown-parser.js';
-import { Validator } from '../core/validation/validator.js';
-import type { Spec } from '../core/schemas/index.js';
-import { select } from '@inquirer/prompts';
-import { isInteractive } from '../utils/interactive.js';
-import { getSpecIds } from '../utils/item-discovery.js';
-
-const SPECS_DIR = 'openspec/specs';
-
-interface ShowOptions {
-  json?: boolean;
-  // JSON-only filters (raw-first text has no filters)
-  requirements?: boolean;
-  scenarios?: boolean; // --no-scenarios sets this to false (JSON only)
-  requirement?: string; // JSON only
-  noInteractive?: boolean;
-}
-
-function parseSpecFromFile(specPath: string, specId: string): Spec {
-  const content = readFileSync(specPath, 'utf-8');
-  const parser = new MarkdownParser(content);
-  return parser.parseSpec(specId);
-}
-
-function validateRequirementIndex(spec: Spec, requirementOpt?: string): number | undefined {
-  if (!requirementOpt) return undefined;
-  const index = Number.parseInt(requirementOpt, 10);
-  if (!Number.isInteger(index) || index < 1 || index > spec.requirements.length) {
-    throw new Error(`Requirement ${requirementOpt} not found`);
-  }
-  return index - 1; // convert to 0-based
-}
-
-function filterSpec(spec: Spec, options: ShowOptions): Spec {
-  const requirementIndex = validateRequirementIndex(spec, options.requirement);
-  const includeScenarios = options.scenarios !== false && !options.requirements;
-
-  const filteredRequirements = (requirementIndex !== undefined
-    ? [spec.requirements[requirementIndex]]
-    : spec.requirements
-  ).map(req => ({
-    text: req.text,
-    scenarios: includeScenarios ? req.scenarios : [],
-  }));
-
-  const metadata = spec.metadata ?? { version: '1.0.0', format: 'openspec' as const };
-
-  return {
-    name: spec.name,
-    overview: spec.overview,
-    requirements: filteredRequirements,
-    metadata,
-  };
-}
-
-/**
- * Print the raw markdown content for a spec file without any formatting.
- * Raw-first behavior ensures text mode is a passthrough for deterministic output.
- */
-function printSpecTextRaw(specPath: string): void {
-  const content = readFileSync(specPath, 'utf-8');
-  console.log(content);
-}
-
-export class SpecCommand {
-  private SPECS_DIR = 'openspec/specs';
-
-  async show(specId?: string, options: ShowOptions = {}): Promise<void> {
-    if (!specId) {
-      const canPrompt = isInteractive(options?.noInteractive);
-      const specIds = await getSpecIds();
-      if (canPrompt && specIds.length > 0) {
-        specId = await select({
-          message: 'Select a spec to show',
-          choices: specIds.map(id => ({ name: id, value: id })),
-        });
-      } else {
-        throw new Error('Missing required argument <spec-id>');
-      }
-    }
-
-    const specPath = join(this.SPECS_DIR, specId, 'spec.md');
-    if (!existsSync(specPath)) {
-      throw new Error(`Spec '${specId}' not found at openspec/specs/${specId}/spec.md`);
-    }
-
-    if (options.json) {
-      if (options.requirements && options.requirement) {
-        throw new Error('Options --requirements and --requirement cannot be used together');
-      }
-      const parsed = parseSpecFromFile(specPath, specId);
-      const filtered = filterSpec(parsed, options);
-      const output = {
-        id: specId,
-        title: parsed.name,
-        overview: parsed.overview,
-        requirementCount: filtered.requirements.length,
-        requirements: filtered.requirements,
-        metadata: parsed.metadata ?? { version: '1.0.0', format: 'openspec' as const },
-      };
-      console.log(JSON.stringify(output, null, 2));
-      return;
-    }
-    printSpecTextRaw(specPath);
-  }
-}
-
-export function registerSpecCommand(rootProgram: typeof program) {
-  const specCommand = rootProgram
-    .command('spec')
-    .description('Manage and view OpenSpec specifications');
-
-  // Deprecation notice for noun-based commands
-  specCommand.hook('preAction', () => {
-    console.error('Warning: The "openspec spec ..." commands are deprecated. Prefer verb-first commands (e.g., "openspec show", "openspec validate --specs").');
-  });
-
-  specCommand
-    .command('show [spec-id]')
-    .description('Display a specific specification')
-    .option('--json', 'Output as JSON')
-    .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)')
-    .option('--no-interactive', 'Disable interactive prompts')
-    .action(async (specId: string | undefined, options: ShowOptions & { noInteractive?: boolean }) => {
-      try {
-        const cmd = new SpecCommand();
-        await cmd.show(specId, options as any);
-      } catch (error) {
-        console.error(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        process.exitCode = 1;
-      }
-    });
-
-  specCommand
-    .command('list')
-    .description('List all available specifications')
-    .option('--json', 'Output as JSON')
-    .option('--long', 'Show id and title with counts')
-    .action((options: { json?: boolean; long?: boolean }) => {
-      try {
-        if (!existsSync(SPECS_DIR)) {
-          console.log('No items found');
-          return;
-        }
-
-        const specs = readdirSync(SPECS_DIR, { withFileTypes: true })
-          .filter(dirent => dirent.isDirectory())
-          .map(dirent => {
-            const specPath = join(SPECS_DIR, dirent.name, 'spec.md');
-            if (existsSync(specPath)) {
-              try {
-                const spec = parseSpecFromFile(specPath, dirent.name);
-                
-                return {
-                  id: dirent.name,
-                  title: spec.name,
-                  requirementCount: spec.requirements.length
-                };
-              } catch {
-                return {
-                  id: dirent.name,
-                  title: dirent.name,
-                  requirementCount: 0
-                };
-              }
-            }
-            return null;
-          })
-          .filter((spec): spec is { id: string; title: string; requirementCount: number } => spec !== null)
-          .sort((a, b) => a.id.localeCompare(b.id));
-
-        if (options.json) {
-          console.log(JSON.stringify(specs, null, 2));
-        } else {
-          if (specs.length === 0) {
-            console.log('No items found');
-            return;
-          }
-          if (!options.long) {
-            specs.forEach(spec => console.log(spec.id));
-            return;
-          }
-          specs.forEach(spec => {
-            console.log(`${spec.id}: ${spec.title} [requirements ${spec.requirementCount}]`);
-          });
-        }
-      } catch (error) {
-        console.error(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        process.exitCode = 1;
-      }
-    });
-
-  specCommand
-    .command('validate [spec-id]')
-    .description('Validate a specification structure')
-    .option('--strict', 'Enable strict validation mode')
-    .option('--json', 'Output validation report as JSON')
-    .option('--no-interactive', 'Disable interactive prompts')
-    .action(async (specId: string | undefined, options: { strict?: boolean; json?: boolean; noInteractive?: boolean }) => {
-      try {
-        if (!specId) {
-          const canPrompt = isInteractive(options?.noInteractive);
-          const specIds = await getSpecIds();
-          if (canPrompt && specIds.length > 0) {
-            specId = await select({
-              message: 'Select a spec to validate',
-              choices: specIds.map(id => ({ name: id, value: id })),
-            });
-          } else {
-            throw new Error('Missing required argument <spec-id>');
-          }
-        }
-
-        const specPath = join(SPECS_DIR, specId, 'spec.md');
-        
-        if (!existsSync(specPath)) {
-          throw new Error(`Spec '${specId}' not found at openspec/specs/${specId}/spec.md`);
-        }
-
-        const validator = new Validator(options.strict);
-        const report = await validator.validateSpec(specPath);
-
-        if (options.json) {
-          console.log(JSON.stringify(report, null, 2));
-        } else {
-          if (report.valid) {
-            console.log(`Specification '${specId}' is valid`);
-          } else {
-            console.error(`Specification '${specId}' has issues`);
-            report.issues.forEach(issue => {
-              const label = issue.level === 'ERROR' ? 'ERROR' : issue.level;
-              const prefix = issue.level === 'ERROR' ? '✗' : issue.level === 'WARNING' ? '⚠' : 'ℹ';
-              console.error(`${prefix} [${label}] ${issue.path}: ${issue.message}`);
-            });
-          }
-        }
-        process.exitCode = report.valid ? 0 : 1;
-      } catch (error) {
-        console.error(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        process.exitCode = 1;
-      }
-    });
-
-  return specCommand;
-}

package/references/openspec/src/commands/validate.ts

@@ -1,305 +0,0 @@
-import { select } from '@inquirer/prompts';
-import ora from 'ora';
-import path from 'path';
-import { Validator } from '../core/validation/validator.js';
-import { isInteractive } from '../utils/interactive.js';
-import { getActiveChangeIds, getSpecIds } from '../utils/item-discovery.js';
-import { nearestMatches } from '../utils/match.js';
-
-type ItemType = 'change' | 'spec';
-
-interface ExecuteOptions {
-  all?: boolean;
-  changes?: boolean;
-  specs?: boolean;
-  type?: string;
-  strict?: boolean;
-  json?: boolean;
-  noInteractive?: boolean;
-  concurrency?: string;
-}
-
-interface BulkItemResult {
-  id: string;
-  type: ItemType;
-  valid: boolean;
-  issues: { level: 'ERROR' | 'WARNING' | 'INFO'; path: string; message: string }[];
-  durationMs: number;
-}
-
-export class ValidateCommand {
-  async execute(itemName: string | undefined, options: ExecuteOptions = {}): Promise<void> {
-    const interactive = isInteractive(options.noInteractive);
-
-    // Handle bulk flags first
-    if (options.all || options.changes || options.specs) {
-      await this.runBulkValidation({
-        changes: !!options.all || !!options.changes,
-        specs: !!options.all || !!options.specs,
-      }, { strict: !!options.strict, json: !!options.json, concurrency: options.concurrency });
-      return;
-    }
-
-    // No item and no flags
-    if (!itemName) {
-      if (interactive) {
-        await this.runInteractiveSelector({ strict: !!options.strict, json: !!options.json, concurrency: options.concurrency });
-        return;
-      }
-      this.printNonInteractiveHint();
-      process.exitCode = 1;
-      return;
-    }
-
-    // Direct item validation with type detection or override
-    const typeOverride = this.normalizeType(options.type);
-    await this.validateDirectItem(itemName, { typeOverride, strict: !!options.strict, json: !!options.json });
-  }
-
-  private normalizeType(value?: string): ItemType | undefined {
-    if (!value) return undefined;
-    const v = value.toLowerCase();
-    if (v === 'change' || v === 'spec') return v;
-    return undefined;
-  }
-
-  private async runInteractiveSelector(opts: { strict: boolean; json: boolean; concurrency?: string }): Promise<void> {
-    const choice = await select({
-      message: 'What would you like to validate?',
-      choices: [
-        { name: 'All (changes + specs)', value: 'all' },
-        { name: 'All changes', value: 'changes' },
-        { name: 'All specs', value: 'specs' },
-        { name: 'Pick a specific change or spec', value: 'one' },
-      ],
-    });
-
-    if (choice === 'all') return this.runBulkValidation({ changes: true, specs: true }, opts);
-    if (choice === 'changes') return this.runBulkValidation({ changes: true, specs: false }, opts);
-    if (choice === 'specs') return this.runBulkValidation({ changes: false, specs: true }, opts);
-
-    // one
-    const [changes, specs] = await Promise.all([getActiveChangeIds(), getSpecIds()]);
-    const items: { name: string; value: { type: ItemType; id: string } }[] = [];
-    items.push(...changes.map(id => ({ name: `change/${id}`, value: { type: 'change' as const, id } })));
-    items.push(...specs.map(id => ({ name: `spec/${id}`, value: { type: 'spec' as const, id } })));
-    if (items.length === 0) {
-      console.error('No items found to validate.');
-      process.exitCode = 1;
-      return;
-    }
-    const picked = await select<{ type: ItemType; id: string }>({ message: 'Pick an item', choices: items });
-    await this.validateByType(picked.type, picked.id, opts);
-  }
-
-  private printNonInteractiveHint(): void {
-    console.error('Nothing to validate. Try one of:');
-    console.error('  openspec validate --all');
-    console.error('  openspec validate --changes');
-    console.error('  openspec validate --specs');
-    console.error('  openspec validate <item-name>');
-    console.error('Or run in an interactive terminal.');
-  }
-
-  private async validateDirectItem(itemName: string, opts: { typeOverride?: ItemType; strict: boolean; json: boolean }): Promise<void> {
-    const [changes, specs] = await Promise.all([getActiveChangeIds(), getSpecIds()]);
-    const isChange = changes.includes(itemName);
-    const isSpec = specs.includes(itemName);
-
-    const type = opts.typeOverride ?? (isChange ? 'change' : isSpec ? 'spec' : undefined);
-
-    if (!type) {
-      console.error(`Unknown item '${itemName}'`);
-      const suggestions = nearestMatches(itemName, [...changes, ...specs]);
-      if (suggestions.length) console.error(`Did you mean: ${suggestions.join(', ')}?`);
-      process.exitCode = 1;
-      return;
-    }
-
-    if (!opts.typeOverride && isChange && isSpec) {
-      console.error(`Ambiguous item '${itemName}' matches both a change and a spec.`);
-      console.error('Pass --type change|spec, or use: openspec change validate / openspec spec validate');
-      process.exitCode = 1;
-      return;
-    }
-
-    await this.validateByType(type, itemName, opts);
-  }
-
-  private async validateByType(type: ItemType, id: string, opts: { strict: boolean; json: boolean }): Promise<void> {
-    const validator = new Validator(opts.strict);
-    if (type === 'change') {
-      const changeDir = path.join(process.cwd(), 'openspec', 'changes', id);
-      const start = Date.now();
-      const report = await validator.validateChangeDeltaSpecs(changeDir);
-      const durationMs = Date.now() - start;
-      this.printReport('change', id, report, durationMs, opts.json);
-      // Non-zero exit if invalid (keeps enriched output test semantics)
-      process.exitCode = report.valid ? 0 : 1;
-      return;
-    }
-    const file = path.join(process.cwd(), 'openspec', 'specs', id, 'spec.md');
-    const start = Date.now();
-    const report = await validator.validateSpec(file);
-    const durationMs = Date.now() - start;
-    this.printReport('spec', id, report, durationMs, opts.json);
-    process.exitCode = report.valid ? 0 : 1;
-  }
-
-  private printReport(type: ItemType, id: string, report: { valid: boolean; issues: any[] }, durationMs: number, json: boolean): void {
-    if (json) {
-      const out = { items: [{ id, type, valid: report.valid, issues: report.issues, durationMs }], summary: { totals: { items: 1, passed: report.valid ? 1 : 0, failed: report.valid ? 0 : 1 }, byType: { [type]: { items: 1, passed: report.valid ? 1 : 0, failed: report.valid ? 0 : 1 } } }, version: '1.0' };
-      console.log(JSON.stringify(out, null, 2));
-      return;
-    }
-    if (report.valid) {
-      console.log(`${type === 'change' ? 'Change' : 'Specification'} '${id}' is valid`);
-    } else {
-      console.error(`${type === 'change' ? 'Change' : 'Specification'} '${id}' has issues`);
-      for (const issue of report.issues) {
-        const label = issue.level === 'ERROR' ? 'ERROR' : issue.level;
-        const prefix = issue.level === 'ERROR' ? '✗' : issue.level === 'WARNING' ? '⚠' : 'ℹ';
-        console.error(`${prefix} [${label}] ${issue.path}: ${issue.message}`);
-      }
-      this.printNextSteps(type);
-    }
-  }
-
-  private printNextSteps(type: ItemType): void {
-    const bullets: string[] = [];
-    if (type === 'change') {
-      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: openspec change show <id> --json --deltas-only');
-    } else {
-      bullets.push('- Ensure spec includes ## Purpose and ## Requirements sections');
-      bullets.push('- Each requirement MUST include at least one #### Scenario: block');
-      bullets.push('- Re-run with --json to see structured report');
-    }
-    console.error('Next steps:');
-    bullets.forEach(b => console.error(`  ${b}`));
-  }
-
-  private async runBulkValidation(scope: { changes: boolean; specs: boolean }, opts: { strict: boolean; json: boolean; concurrency?: string }): Promise<void> {
-    const spinner = !opts.json ? ora('Validating...').start() : undefined;
-    const [changeIds, specIds] = await Promise.all([
-      scope.changes ? getActiveChangeIds() : Promise.resolve<string[]>([]),
-      scope.specs ? getSpecIds() : Promise.resolve<string[]>([]),
-    ]);
-
-    const DEFAULT_CONCURRENCY = 6;
-    const maxSuggestions = 5; // used by nearestMatches
-    const concurrency = normalizeConcurrency(opts.concurrency) ?? normalizeConcurrency(process.env.OPENSPEC_CONCURRENCY) ?? DEFAULT_CONCURRENCY;
-    const validator = new Validator(opts.strict);
-    const queue: Array<() => Promise<BulkItemResult>> = [];
-
-    for (const id of changeIds) {
-      queue.push(async () => {
-        const start = Date.now();
-        const changeDir = path.join(process.cwd(), 'openspec', 'changes', id);
-        const report = await validator.validateChangeDeltaSpecs(changeDir);
-        const durationMs = Date.now() - start;
-        return { id, type: 'change' as const, valid: report.valid, issues: report.issues, durationMs };
-      });
-    }
-    for (const id of specIds) {
-      queue.push(async () => {
-        const start = Date.now();
-        const file = path.join(process.cwd(), 'openspec', 'specs', id, 'spec.md');
-        const report = await validator.validateSpec(file);
-        const durationMs = Date.now() - start;
-        return { id, type: 'spec' as const, valid: report.valid, issues: report.issues, durationMs };
-      });
-    }
-
-    const results: BulkItemResult[] = [];
-    let index = 0;
-    let running = 0;
-    let passed = 0;
-    let failed = 0;
-
-    await new Promise<void>((resolve) => {
-      const next = () => {
-        while (running < concurrency && index < queue.length) {
-          const currentIndex = index++;
-          const task = queue[currentIndex];
-          running++;
-          if (spinner) spinner.text = `Validating (${currentIndex + 1}/${queue.length})...`;
-          task()
-            .then(res => {
-              results.push(res);
-              if (res.valid) passed++; else failed++;
-            })
-            .catch((error: any) => {
-              const message = error?.message || 'Unknown error';
-              const res: BulkItemResult = { id: getPlannedId(currentIndex, changeIds, specIds) ?? 'unknown', type: getPlannedType(currentIndex, changeIds, specIds) ?? 'change', valid: false, issues: [{ level: 'ERROR', path: 'file', message }], durationMs: 0 };
-              results.push(res);
-              failed++;
-            })
-            .finally(() => {
-              running--;
-              if (index >= queue.length && running === 0) resolve();
-              else next();
-            });
-        }
-      };
-      next();
-    });
-
-    spinner?.stop();
-
-    results.sort((a, b) => a.id.localeCompare(b.id));
-    const summary = {
-      totals: { items: results.length, passed, failed },
-      byType: {
-        ...(scope.changes ? { change: summarizeType(results, 'change') } : {}),
-        ...(scope.specs ? { spec: summarizeType(results, 'spec') } : {}),
-      },
-    } as const;
-
-    if (opts.json) {
-      const out = { items: results, summary, version: '1.0' };
-      console.log(JSON.stringify(out, null, 2));
-    } else {
-      for (const res of results) {
-        if (res.valid) console.log(`✓ ${res.type}/${res.id}`);
-        else console.error(`✗ ${res.type}/${res.id}`);
-      }
-      console.log(`Totals: ${summary.totals.passed} passed, ${summary.totals.failed} failed (${summary.totals.items} items)`);
-    }
-
-    process.exitCode = failed > 0 ? 1 : 0;
-  }
-}
-
-function summarizeType(results: BulkItemResult[], type: ItemType) {
-  const filtered = results.filter(r => r.type === type);
-  const items = filtered.length;
-  const passed = filtered.filter(r => r.valid).length;
-  const failed = items - passed;
-  return { items, passed, failed };
-}
-
-function normalizeConcurrency(value?: string): number | undefined {
-  if (!value) return undefined;
-  const n = parseInt(value, 10);
-  if (Number.isNaN(n) || n <= 0) return undefined;
-  return n;
-}
-
-function getPlannedId(index: number, changeIds: string[], specIds: string[]): string | undefined {
-  const totalChanges = changeIds.length;
-  if (index < totalChanges) return changeIds[index];
-  const specIndex = index - totalChanges;
-  return specIds[specIndex];
-}
-
-function getPlannedType(index: number, changeIds: string[], specIds: string[]): ItemType | undefined {
-  const totalChanges = changeIds.length;
-  if (index < totalChanges) return 'change';
-  const specIndex = index - totalChanges;
-  if (specIndex >= 0 && specIndex < specIds.length) return 'spec';
-  return undefined;
-}
-
-