create-quiver 0.15.4 → 0.16.0

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/EXECUTION_BRIEF.md

@@ -0,0 +1,75 @@
+# EXECUTION_BRIEF - slice-03 changelog, package, and release smoke hygiene
+
+## Context
+
+Release confidence requires validating the actual npm tarball and installed CLI, not only local source. New schema/docs/scripts must be included or excluded deliberately.
+
+## Objective
+
+Formalize changelog handling and validate actual npm package installation behavior.
+
+## Scope
+
+- `[Unreleased]` changelog handling.
+- `.npmignore`.
+- Package safety.
+- Tarball contents.
+- Installed tarball smoke.
+- Release script dry-run gates.
+
+## Acceptance Criteria
+
+- Package smoke validates required public files.
+- Package smoke rejects forbidden local artifacts.
+- Tarball installs in a temporary project.
+- Installed CLI runs `--version`, `--help`, and one safe dry-run command.
+- Changelog process is documented.
+- npm publish automation remains out of scope unless prerequisites are explicit.
+
+## Expected Files To Modify
+
+- `CHANGELOG.md`
+- `.npmignore`
+- `scripts/package-quiver.sh`
+- `scripts/release-quiver.sh`
+- `scripts/ci/**`
+- `package.json`
+- `package-lock.json`
+- `.github/workflows/ci.yml`
+- `CONTRIBUTING.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md`
+
+## Validations Required
+
+- `npm ci`
+- `node --test`
+- `npm run package:quiver`
+- installed tarball smoke
+- `git diff --check`
+
+## Risks
+
+- Publishing local audit artifacts or PDFs.
+- Excluding required public schema/docs.
+- Release script relying on local-only files.
+
+## Dependencies
+
+- Depends on `slice-01-json-schema-for-slice-json`.
+- Depends on `slice-02-generated-cli-reference`.
+
+## Instructions For Executor
+
+1. Update package checks after schema/docs decisions are known.
+2. Validate the installed tarball, not only source checkout.
+3. Keep publish steps manual unless prerequisites are explicitly present.
+
+## Completion Checklist
+
+- [ ] Acceptance criteria satisfied.
+- [ ] Required validations run or blockers documented.
+- [ ] Closure brief updated.
+
+## Conditions Of Closure
+
+- Release/package checks catch missing required files and forbidden local artifacts before publish.

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/pr.md

@@ -0,0 +1,159 @@
+# PR - QUIVER-52-03 - Changelog, package, and release smoke hygiene
+
+## Title
+
+QUIVER-52-03 Changelog, package, and release smoke hygiene
+
+## Summary
+
+Formalizes changelog handling and hardens release/package validation. The package smoke now validates required public files, rejects local audit/tool/secret artifacts, installs the generated tarball, and verifies the installed CLI with `--version`, `--help`, and `init --dry-run`. Release dry-run gates now include changelog, docs, schema, installer, package, and installed CLI checks, while publish flags remain explicitly guarded.
+
+## PR Policy
+
+- [x] One slice only.
+- [ ] Grouped PR exception: at most 2-3 slices, all docs-only, research-only, or low-risk mechanical cleanup.
+- [x] No behavior changes in a grouped PR.
+- [x] No mixed docs with UI, backend, refactor, or performance work.
+- [x] Separate evidence for this slice is recorded in `EVIDENCE_REPORT.md`.
+- [x] Whole PR is revertible without leaving partial state.
+
+Individual PR required classification: release/package gates, CI docs gate, tests affecting validation gates, docs, and slice metadata.
+
+### Merge Policy
+
+- [x] Human merge expected.
+- [ ] Assisted auto-merge explicitly authorized for this PR or documented category.
+- [ ] Assisted auto-merge conditions met: docs-only or chore-only, low risk, no runtime changes, no production configuration changes, green checks, and no pending comments.
+
+Assisted auto-merge is not requested.
+
+## Scope
+
+- Add `npm run changelog:check`.
+- Add `scripts/ci/check-changelog.js` and focused tests.
+- Update `[Unreleased]` changelog entries.
+- Harden `.npmignore` for local audit, PDF, SSH/key, and local-noise artifacts.
+- Extend `npm run package:quiver` to validate required public files, forbidden local artifacts, installed tarball, installed `--version`, installed `--help`, and installed `init --dry-run`.
+- Wire CI docs job to `npm run docs:check`.
+- Add changelog/docs/schema gates to `scripts/release-quiver.sh`.
+- Require `QUIVER_ALLOW_NPM_PUBLISH=1` for release publish flags.
+- Document changelog/package/release expectations in `CONTRIBUTING.md` and release validation docs.
+- Update v52 status, evidence, closure, slice metadata, and PR body.
+
+## Files
+
+- `.github/workflows/ci.yml`
+- `.npmignore`
+- `CHANGELOG.md`
+- `CONTRIBUTING.md`
+- `README.md`
+- `package.json`
+- `scripts/ci/check-changelog.js`
+- `scripts/package-quiver.sh`
+- `scripts/release-quiver.sh`
+- `tests/ci/changelog.test.js`
+- `specs/quiver-v52-schema-docs-release-hygiene/SPEC.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/STATUS.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/CLOSURE_BRIEF.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/slice.json`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/pr.md`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js supported by the repo.
+- npm.
+- Git.
+- ShellCheck for local shell lint validation.
+
+### Worktree Access
+
+```bash
+cd /Users/fabrijk/Documents/Work/Proyectos\ Personales/nika/frameworks/quiver
+git switch feature/QUIVER-52-03-v52-release-package-hygiene
+```
+
+### Run the Project
+
+No runtime server is required. This is release/package automation, docs, CI gate, tests, and spec evidence.
+
+### Use Cases
+
+#### Case 1: validate changelog hygiene
+
+1. Run `npm run changelog:check`.
+2. Inspect the report.
+
+**Expected result:** the checker finds `CHANGELOG.md`, detects `[Unreleased]`, and reports categorized entries.
+
+#### Case 2: validate package boundary and installed CLI
+
+1. Run `npm run package:quiver`.
+2. Inspect the output.
+
+**Expected result:** the package smoke requires public files, rejects forbidden local artifacts, installs the tarball, and verifies installed `--version`, `--help`, and `init --dry-run`.
+
+#### Case 3: validate release dry-run gates
+
+1. Run `npm run release:quiver`.
+2. Inspect the gate sequence.
+
+**Expected result:** release dry-run requires a clean worktree, then runs changelog, docs, schema, installer smoke, package smoke, and installed CLI checks before printing publish guidance.
+
+#### Case 4: verify publish remains guarded
+
+1. Run `bash scripts/release-quiver.sh --help`.
+2. Review the publish text.
+
+**Expected result:** publish flags are documented as requiring `QUIVER_ALLOW_NPM_PUBLISH=1`; publish remains opt-in and human-authorized.
+
+### Technical Verification
+
+```bash
+npm ci
+npm run changelog:check
+node --test tests/ci/changelog.test.js
+bash -n scripts/package-quiver.sh scripts/release-quiver.sh
+shellcheck scripts/package-quiver.sh scripts/release-quiver.sh
+npm run docs:check
+npm run schema:slice:check
+npm run package:quiver
+npm run release:quiver
+node --test
+git diff --check
+node bin/create-quiver.js spec validate specs/quiver-v52-schema-docs-release-hygiene
+node bin/create-quiver.js check-slice specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/slice.json --local --gate validation
+node bin/create-quiver.js check-scope specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/slice.json --base main --strict
+node bin/create-quiver.js check-pr specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/slice.json --base main
+```
+
+## Evidence
+
+- `npm run changelog:check`: passed; 22 `[Unreleased]` entries detected.
+- `node --test tests/ci/changelog.test.js`: passed, 3 tests.
+- `bash -n scripts/package-quiver.sh scripts/release-quiver.sh`: passed.
+- `shellcheck scripts/package-quiver.sh scripts/release-quiver.sh`: passed.
+- `npm run package:quiver`: passed; generated `create-quiver-0.15.3.tgz` and installed CLI smoke passed.
+- `npm run docs:check`: passed, including generated CLI reference drift check.
+- `npm run schema:slice:check`: passed; 266 runtime-valid fixtures validated, 1 historical/non-runtime fixture skipped, 4 invalid fixtures rejected.
+- `npm ci`: passed; 165 packages installed/audited, 0 vulnerabilities reported.
+- `node --test`: passed, 654 tests.
+- `git diff --check`: passed.
+- `node bin/create-quiver.js spec validate specs/quiver-v52-schema-docs-release-hygiene`: passed.
+- `node bin/create-quiver.js check-slice specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/slice.json --local --gate validation`: passed.
+- `npm run release:quiver`: passed; changelog, docs, schema, installer smoke, package smoke, and installed CLI smoke passed before printing manual publish guidance.
+
+## Rollback
+
+1. Revert this slice commit with `git revert <commit-sha>`.
+2. Run the technical verification commands above.
+3. Confirm changelog check, installed package smoke, release dry-run gates, CI docs gate change, package exclusions, docs updates, and focused tests are removed.
+
+## Risks / Notes
+
+- `npm run package:quiver` now performs an npm install from the generated tarball, so package smoke is intentionally stricter and slightly slower.
+- `scripts/release-quiver.sh --publish` and `--publish-current` now require `QUIVER_ALLOW_NPM_PUBLISH=1` to avoid accidental publish automation.
+- CI docs job now uses `npm run docs:check`, so generated CLI reference drift can fail the docs gate.
+- No package dependency or lockfile update is required.

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/slice.json

@@ -0,0 +1,105 @@
+{
+  "slice_id": "slice-03-changelog-package-release-smoke-hygiene",
+  "ticket": "QUIVER-52-03",
+  "type": "automation",
+  "title": "Changelog, package, and release smoke hygiene",
+  "objective": "Formalize changelog handling and validate actual npm package installation behavior.",
+  "description": "Updates release/package smoke gates so new docs/schema/scripts are included or excluded intentionally and installed CLI behavior is verified.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v52-release-package-hygiene",
+    "branch_name": "feature/QUIVER-52-03-v52-release-package-hygiene"
+  },
+  "files": [
+    ".github/workflows/ci.yml",
+    ".npmignore",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "README.md",
+    "package.json",
+    "scripts/package-quiver.sh",
+    "scripts/release-quiver.sh",
+    "scripts/ci/check-changelog.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "tests/ci/changelog.test.js",
+    "specs/quiver-v52-schema-docs-release-hygiene/SPEC.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/STATUS.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/CLOSURE_BRIEF.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/slice.json",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/pr.md"
+  ],
+  "expected_read_paths": [
+    "CHANGELOG.md",
+    ".npmignore",
+    "scripts/package-quiver.sh",
+    "scripts/release-quiver.sh",
+    "package.json",
+    "package-lock.json"
+  ],
+  "allowed_write_paths": [
+    ".github/workflows/ci.yml",
+    ".npmignore",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "README.md",
+    "package.json",
+    "scripts/package-quiver.sh",
+    "scripts/release-quiver.sh",
+    "scripts/ci/check-changelog.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "tests/ci/changelog.test.js",
+    "specs/quiver-v52-schema-docs-release-hygiene/SPEC.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/STATUS.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/CLOSURE_BRIEF.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/slice.json",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/pr.md"
+  ],
+  "depends_on": [
+    "slice-01-json-schema-for-slice-json",
+    "slice-02-generated-cli-reference"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Release/package hygiene must include outputs from schema and docs generation slices.",
+  "must": [
+    "Formalize [Unreleased] changelog handling.",
+    "Validate npm pack tarball contents.",
+    "Install tarball in a temp project and execute installed CLI.",
+    "Update package safety for new public/repo-only files.",
+    "Keep npm publish automation out of scope unless prerequisites are explicit."
+  ],
+  "not_included": [
+    "Publishing to npm.",
+    "Adding secrets to CI.",
+    "Removing manual release safeguards."
+  ],
+  "acceptance": [
+    "Package smoke fails for forbidden local artifacts.",
+    "Package smoke fails if required public files are missing.",
+    "Installed tarball smoke runs --version, --help, and a safe dry-run command.",
+    "Changelog process is documented and coherent."
+  ],
+  "tests": [
+    "npm ci",
+    "npm run changelog:check",
+    "node --test tests/ci/changelog.test.js",
+    "bash -n scripts/package-quiver.sh scripts/release-quiver.sh",
+    "shellcheck scripts/package-quiver.sh scripts/release-quiver.sh",
+    "npm run docs:check",
+    "node --test",
+    "npm run package:quiver",
+    "npm run release:quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Explicitly reject audit files, PDFs, tests, worktrees, secrets, .DS_Store, and tool state from the package."
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 5,
+  "started_at": "2026-06-03T01:05:00-0300",
+  "completed_at": "2026-06-03T01:13:00-0300"
+}

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

@@ -0,0 +1,93 @@
+const fs = require('fs');
+const path = require('path');
+
+function parseChangelog(content) {
+  const lines = String(content || '').split(/\r?\n/);
+  const entries = [];
+  let current = null;
+
+  for (const line of lines) {
+    const heading = line.match(/^##\s+\[?([^\]\n]+)\]?(?:\s+-\s+(.+))?$/);
+    if (heading) {
+      if (current) {
+        current.body = current.body.trim();
+        entries.push(current);
+      }
+      current = {
+        version: heading[1].trim(),
+        date: heading[2]?.trim() || null,
+        body: '',
+      };
+      continue;
+    }
+
+    if (current) {
+      current.body += `${line}\n`;
+    }
+  }
+
+  if (current) {
+    current.body = current.body.trim();
+    entries.push(current);
+  }
+
+  return entries;
+}
+
+function readChangelog(packageRoot) {
+  const changelogPath = path.join(packageRoot, 'CHANGELOG.md');
+  if (!fs.existsSync(changelogPath)) {
+    return { path: changelogPath, entries: [], missing: true };
+  }
+
+  const content = fs.readFileSync(changelogPath, 'utf8');
+  return { path: changelogPath, entries: parseChangelog(content), missing: false };
+}
+
+function formatHumanChangelog(report) {
+  if (report.missing) {
+    return 'Quiver changelog\n\nNo local CHANGELOG.md was found in the installed package.\n';
+  }
+
+  const entries = report.entries.slice(0, 3);
+  if (entries.length === 0) {
+    return 'Quiver changelog\n\nLocal CHANGELOG.md did not contain parseable release entries.\n';
+  }
+
+  const lines = ['Quiver changelog', ''];
+  for (const entry of entries) {
+    lines.push(`## ${entry.version}${entry.date ? ` - ${entry.date}` : ''}`);
+    if (entry.body) {
+      lines.push(entry.body);
+    }
+    lines.push('');
+  }
+
+  return `${lines.join('\n').trimEnd()}\n`;
+}
+
+function runChangelog(options = {}) {
+  const packageRoot = options.packageRoot || path.resolve(__dirname, '../..', '..');
+  const report = readChangelog(packageRoot);
+  const payload = {
+    schema_version: 1,
+    source: report.path,
+    missing: report.missing,
+    entries: report.entries.slice(0, 10),
+  };
+
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+    return payload;
+  }
+
+  process.stdout.write(formatHumanChangelog(report));
+  return payload;
+}
+
+module.exports = {
+  formatHumanChangelog,
+  parseChangelog,
+  readChangelog,
+  runChangelog,
+};

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`;
 }