create-quiver 0.15.4 → 0.17.0

package/src/create-quiver/commands/config.js

@@ -10,6 +10,7 @@ const {
   writeGlobalLanguageConfig,
   writeProjectLanguageConfig,
 } = require('../lib/i18n/language');
+const { createTranslator } = require('../lib/i18n/catalog');
 
 function formatError(message) {
   return `create-quiver: ${message}`;
@@ -29,10 +30,14 @@ function formatProjectRelativePath(repoRoot, filePath) {
   return path.relative(repoRoot, filePath).split(path.sep).join('/') || '.';
 }
 
-function validateLanguageForSet(language) {
+function validateLanguageForSet(language, translator = createTranslator()) {
   const normalized = normalizeLanguage(language);
   if (!normalized || normalized !== String(language || '').trim().toLowerCase()) {
-    throw new Error(formatError(`unsupported language: ${language || '<missing>'}. Supported languages: ${SUPPORTED_LANGUAGES.join(', ')}. Run: npx create-quiver config language set ${DEFAULT_LANGUAGE}`));
+    throw new Error(formatError(translator.t('config.error.unsupported_language', {
+      fallback: DEFAULT_LANGUAGE,
+      language: language || '<missing>',
+      supported: SUPPORTED_LANGUAGES.join(', '),
+    })));
   }
   return normalized;
 }
@@ -69,7 +74,8 @@ function runLanguageShow(repoRoot, options = {}) {
 }
 
 function runLanguageSet(repoRoot, options = {}) {
-  const language = validateLanguageForSet(options.value);
+  const translator = createTranslator(options.language);
+  const language = validateLanguageForSet(options.value, translator);
   const global = options.global === true;
   const configPath = global ? globalLanguageConfigPath() : projectLanguageConfigPath(repoRoot);
 
@@ -102,8 +108,11 @@ function runLanguageSet(repoRoot, options = {}) {
 }
 
 function runConfig(repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   if (options.section !== 'language') {
-    throw new Error(formatError(`unsupported config section: ${options.section || '(missing)'}. Supported sections: language`));
+    throw new Error(formatError(translator.t('config.error.unsupported_section', {
+      section: options.section || '(missing)',
+    })));
   }
 
   if (options.command === 'show') {
@@ -116,7 +125,9 @@ function runConfig(repoRoot, options = {}) {
     return;
   }
 
-  throw new Error(formatError(`unsupported config language command: ${options.command || '(missing)'}. Supported commands: show, set`));
+  throw new Error(formatError(translator.t('config.error.unsupported_language_command', {
+    command: options.command || '(missing)',
+  })));
 }
 
 module.exports = {

package/src/create-quiver/commands/evidence.js

@@ -1,5 +1,5 @@
 const path = require('path');
-const { runEvidenceCommand } = require('../lib/evidence');
+const { listEvidenceFiles, runEvidenceCommand, showEvidenceFile } = require('../lib/evidence');
 const { createTranslator } = require('../lib/i18n/catalog');
 
 function formatOutputPath(repoRoot, outputPath) {
@@ -14,11 +14,42 @@ function formatOutputPath(repoRoot, outputPath) {
 function runEvidence(repoRoot, options = {}) {
   const translator = createTranslator(options.language);
   const command = options.command || '';
+  if (options.subcommand === 'list') {
+    const evidence = listEvidenceFiles(repoRoot);
+    if (options.json) {
+      process.stdout.write(`${JSON.stringify({ evidence }, null, 2)}\n`);
+      return { evidence, exitCode: 0 };
+    }
+
+    console.log(translator.t('evidence.list.title'));
+    if (evidence.length === 0) {
+      console.log(translator.t('evidence.list.empty'));
+      return { evidence, exitCode: 0 };
+    }
+
+    for (const item of evidence) {
+      console.log(`- ${item.path} (${translator.t('evidence.exit_code', { code: item.exit_code ?? '-' })})`);
+    }
+    return { evidence, exitCode: 0 };
+  }
+
+  if (options.subcommand === 'show') {
+    const evidence = showEvidenceFile(repoRoot, options.target);
+    if (options.json) {
+      process.stdout.write(`${JSON.stringify(evidence, null, 2)}\n`);
+      return { evidence, exitCode: 0 };
+    }
+
+    process.stdout.write(evidence.content);
+    return { evidence, exitCode: 0 };
+  }
+
   if (options.subcommand !== 'run') {
-    throw new Error('create-quiver: missing evidence subcommand. Use: npx create-quiver evidence run -- <command>');
+    throw new Error(`create-quiver: ${translator.t('evidence.error.missing_subcommand')}`);
   }
 
   const result = runEvidenceCommand(repoRoot, command, {
+    missingCommandMessage: `create-quiver: ${translator.t('evidence.error.missing_command')}`,
     maxOutput: options.maxOutput,
     outputPath: options.output,
     spawnSync: options.spawnSync,

package/src/create-quiver/commands/flow.js

@@ -258,6 +258,7 @@ function baseReport({ stage, label, blockers = [], nextCommand, suggestedCommand
     label,
     blockers,
     nextCommand,
+    next_command: nextCommand,
     suggestedCommands,
     facts,
   };

package/src/create-quiver/commands/graph.js

@@ -3,6 +3,7 @@ const { computeLevels, detectFileConflicts } = require('../lib/slice-graph');
 const { renderDotGraph } = require('../lib/renderers/dot');
 const { renderMermaidGraph } = require('../lib/renderers/mermaid');
 const { renderTreeGraph, isUnicodeEnabled } = require('../lib/renderers/tree');
+const { createTranslator } = require('../lib/i18n/catalog');
 
 function toGraphNode(node) {
   return {
@@ -69,7 +70,11 @@ function collectGraph(repoRoot, options = {}) {
 }
 
 function formatHumanGraph(report, options = {}) {
+  const translator = createTranslator(options.language);
   const format = options.format || 'tree';
+  if (format === 'tree' && typeof options.level === 'number' && (!Array.isArray(report.levels) || report.levels.length === 0)) {
+    return `${translator.t('graph.empty.level', { level: options.level })}\n`;
+  }
   const sharedOptions = {
     showConflicts: options.showConflicts === true,
     language: options.language,
@@ -88,12 +93,13 @@ function formatHumanGraph(report, options = {}) {
     return renderDotGraph(report, sharedOptions);
   }
 
-  throw new Error(`create-quiver: unsupported graph format: ${format}`);
+  throw new Error(`create-quiver: ${translator.t('graph.error.unsupported_format', { format })}`);
 }
 
 function runGraph(repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   if (options.format && !['tree', 'mermaid', 'dot'].includes(options.format)) {
-    throw new Error(`create-quiver: unsupported graph format: ${options.format}`);
+    throw new Error(`create-quiver: ${translator.t('graph.error.unsupported_format', { format: options.format })}`);
   }
 
   const report = collectGraph(repoRoot, options);

package/src/create-quiver/commands/plan.js

@@ -195,6 +195,12 @@ function formatHumanPlan(report, options = {}) {
     lines.push(row.map((value, index) => value.padEnd(widths[index])).join('  '));
   }
 
+  const missingEstimateCount = report.plan.filter((item) => Number(item.hours) <= 0).length;
+  if (missingEstimateCount > 0) {
+    lines.push('');
+    lines.push(translator.t('plan.missing_estimates_note', { count: missingEstimateCount }));
+  }
+
   return `${lines.join('\n')}\n`;
 }
 

package/src/create-quiver/commands/spec.js

@@ -24,18 +24,22 @@ function toRelativePosix(root, filePath) {
   return path.relative(root, filePath).split(path.sep).join('/');
 }
 
-function readInputText(repoRoot, inputPath) {
+function readInputText(repoRoot, inputPath, options = {}) {
+  const translator = createTranslator(options.language);
   const resolved = path.resolve(repoRoot, inputPath || '');
   if (!inputPath || !fs.existsSync(resolved)) {
-    throw new Error(formatError(`missing reviewed and approved plan input: ${inputPath || '<default>'}`));
+    throw new Error(formatError(translator.t('spec.error.missing_approved_plan_input', {
+      path: inputPath || '<default>',
+    })));
   }
   return fs.readFileSync(resolved, 'utf8');
 }
 
-function resolveSpecDir(repoRoot, specInput) {
+function resolveSpecDir(repoRoot, specInput, options = {}) {
+  const translator = createTranslator(options.language);
   const value = String(specInput || '').trim();
   if (!value) {
-    throw new Error(formatError('missing spec directory. Use: npx create-quiver spec validate specs/<spec-slug>'));
+    throw new Error(formatError(translator.t('spec.error.missing_directory_validate')));
   }
 
   const candidates = [
@@ -51,7 +55,7 @@ function resolveSpecDir(repoRoot, specInput) {
     }
   }
 
-  throw new Error(formatError(`spec directory not found: ${value}`));
+  throw new Error(formatError(translator.t('spec.error.directory_not_found', { path: value })));
 }
 
 function findSliceJsonFiles(specDir) {
@@ -142,7 +146,7 @@ function missingGitFields(git) {
 
 function buildSpecValidationReport(repoRoot, specInput, options = {}) {
   const strict = options.strict === true;
-  const specDir = resolveSpecDir(repoRoot, specInput);
+  const specDir = resolveSpecDir(repoRoot, specInput, options);
   const relativeSpecDir = toRelativePosix(repoRoot, specDir);
   const specSlug = path.basename(specDir);
   const errors = [];
@@ -310,7 +314,10 @@ function runValidateSpec(repoRoot, specInput, options = {}) {
   process.stdout.write(formatSpecValidationReport(report, options));
 
   if (!report.ok) {
-    const error = new Error(formatError(`spec validate failed for ${report.specDir}`));
+    const translator = createTranslator(options.language);
+    const error = new Error(formatError(translator.t('spec.error.validate_failed', {
+      path: report.specDir,
+    })));
     error.code = 'SPEC_VALIDATE_FAILED';
     error.details = report;
     throw error;
@@ -322,7 +329,7 @@ function runValidateSpec(repoRoot, specInput, options = {}) {
 function buildSpecCreatePreview(repoRoot, options = {}) {
   const resolved = resolveReviewedTechnicalPlanInput(repoRoot, options.input || undefined);
   const inputPath = resolved.inputPath;
-  const inputText = readInputText(repoRoot, inputPath);
+  const inputText = readInputText(repoRoot, inputPath, options);
   const manifest = buildSpecGenerationManifest({
     inputPath,
     inputText,
@@ -333,7 +340,9 @@ function buildSpecCreatePreview(repoRoot, options = {}) {
   const relativeSpecDir = toRelativePosix(repoRoot, preview.specDir);
 
   if (fs.existsSync(preview.specDir)) {
-    throw new Error(formatError(`spec directory already exists: ${relativeSpecDir}`));
+    throw new Error(formatError(createTranslator(options.language).t('spec.error.directory_already_exists', {
+      path: relativeSpecDir,
+    })));
   }
 
   return {
@@ -433,7 +442,7 @@ async function resolveInteractiveSpecCreateOptions(repoRoot, preview, options =
   });
 
   if (!ux.mode.usePrompts) {
-    throw new Error(formatError('spec create --interactive requires an interactive TTY. Use --input, --spec, --review, and --dry-run for non-interactive automation.'));
+    throw new Error(formatError(translator.t('spec_create.error.interactive_tty_required')));
   }
 
   const selectorOptions = {
@@ -528,7 +537,7 @@ async function confirmSpecCreate(message, options = {}) {
   });
   const confirmed = await ux.promptConfirm(message, { initialValue: false });
   if (!confirmed) {
-    throw new Error(formatError('spec create interactive approval declined. No files were written.'));
+    throw new Error(formatError(createTranslator(options.language).t('spec_create.error.approval_declined')));
   }
 }
 
@@ -542,7 +551,9 @@ async function reviewSpecCreatePreview(repoRoot, preview, options = {}) {
   const canOpenEditor = hasEditorRunner || options.stdinIsTTY === true || (options.stdinIsTTY !== false && Boolean(process.stdin.isTTY));
 
   if (!canOpenEditor) {
-    throw new Error(formatError(`spec create --review requires an interactive terminal or an injected editor runner.\nReview artifact: ${reviewPath}`));
+    throw new Error(formatError(createTranslator(options.language).t('spec_create.error.review_tty_required', {
+      path: reviewPath,
+    })));
   }
 
   const editorResult = hasEditorRunner
@@ -550,7 +561,11 @@ async function reviewSpecCreatePreview(repoRoot, preview, options = {}) {
     : openEditor(reviewPath, { cwd: repoRoot, env: options.env || process.env });
 
   if (!editorResult || editorResult.ok !== true) {
-    throw new Error(formatError(`${editorResult?.reason || 'spec create review was canceled.'}\nReview artifact: ${reviewPath}`));
+    const translator = createTranslator(options.language);
+    throw new Error(formatError(translator.t('spec_create.error.review_canceled', {
+      path: reviewPath,
+      reason: editorResult?.reason || translator.t('spec_create.error.review_canceled.default_reason'),
+    })));
   }
 
   return reviewPath;