create-quiver 0.15.3 → 0.16.0

package/src/create-quiver/lib/ai/github.js

@@ -3,7 +3,8 @@ const os = require('node:os');
 const path = require('node:path');
 const { spawnSync } = require('node:child_process');
 
-const { currentBranch, hasRemote, isCleanWorktree } = require('../git');
+const { currentBranch, hasRemote, isCleanWorktree, resolveBaseBranchName } = require('../git');
+const { createTranslator } = require('../i18n/catalog');
 const { parseJsonWithComments } = require('../json');
 const { formatActionableError } = require('../actionable-error');
 
@@ -509,7 +510,10 @@ function buildPrCreateArgs(plan) {
 function buildPrCreatePlan(repoRoot, preflightReport, options = {}) {
   const prBody = readPrBody(repoRoot, options.prBodyPath || options.input);
   ensureNoOpenSlicesForPrBody(repoRoot, prBody.path);
-  const baseBranch = String(options.baseBranch || 'main').trim() || 'main';
+  const baseBranch = resolveBaseBranchName(repoRoot, {
+    explicitBaseBranch: options.baseBranch,
+    remote: preflightReport.remote || DEFAULT_REMOTE,
+  });
   const title = String(options.title || '').trim() || extractPrTitle(prBody.body, preflightReport.branchName);
   const plan = {
     baseBranch,
@@ -592,33 +596,34 @@ function preflightGitHubPr(repoRoot, options = {}) {
 }
 
 function formatPreflightReport(report, options = {}) {
+  const translator = createTranslator(options.language);
   const mode = options.mode || 'pr';
   const dryRun = options.dryRun === true;
   const lines = [
-    `GitHub ${mode} ${dryRun ? 'dry-run' : 'preflight'}`,
-    `Remote: ${report.remote}`,
-    `Branch: ${report.branchName}`,
-    `GitFlow guide: ${path.relative(report.repoRoot, report.guidePath).split(path.sep).join('/')}`,
+    translator.t('ai.github.preflight.title', { mode, state: dryRun ? 'dry-run' : 'preflight' }),
+    translator.t('ai.github.remote', { remote: report.remote }),
+    translator.t('ai.github.branch', { branch: report.branchName }),
+    translator.t('ai.github.gitflow_guide', { path: path.relative(report.repoRoot, report.guidePath).split(path.sep).join('/') }),
   ];
 
   if (report.sshHostAlias) {
-    lines.push(`SSH host alias: ${report.sshHostAlias}`);
+    lines.push(translator.t('ai.github.ssh_host_alias', { alias: report.sshHostAlias }));
   }
 
   if (report.identityFile) {
-    lines.push(`Identity file: ${report.identityFile}`);
+    lines.push(translator.t('ai.github.identity_file', { path: report.identityFile }));
   }
 
   if (hasShellSensitivePath(report.repoRoot, report.guidePath, report.identityFile)) {
     lines.push(formatShellPathGuidance('--identity-file', report.identityFile || '<path with spaces>'));
   }
 
-  lines.push('Checks: gh, gh auth status, git remote, worktree branch, GitFlow guide, SSH identity file');
+  lines.push(translator.t('ai.github.checks'));
 
   if (dryRun) {
-    lines.push('No PR will be created in dry-run mode.');
+    lines.push(translator.t('ai.github.no_pr_dry_run'));
   } else {
-    lines.push('PR creation is not performed in this slice.');
+    lines.push(translator.t('ai.github.pr_not_performed'));
   }
 
   return `${lines.join('\n')}\n`;
@@ -630,36 +635,37 @@ function quoteCommandArg(arg) {
 }
 
 function formatPrCreateReport({ preflight, plan, result }, options = {}) {
+  const translator = createTranslator(options.language);
   const dryRun = options.dryRun === true;
   const create = options.create === true;
   const lines = [
-    `GitHub pr ${dryRun ? 'dry-run' : create ? 'created' : 'preflight'}`,
-    `Remote: ${preflight.remote}`,
-    `Branch: ${preflight.branchName}`,
-    `Base: ${plan.baseBranch}`,
-    `PR body: ${plan.prBodyRelativePath}`,
-    `Title: ${plan.title}`,
-    `Command: ${plan.ghCommand} ${plan.args.map(quoteCommandArg).join(' ')}`,
+    translator.t('ai.github.pr.title', { state: dryRun ? 'dry-run' : create ? 'created' : 'preflight' }),
+    translator.t('ai.github.remote', { remote: preflight.remote }),
+    translator.t('ai.github.branch', { branch: preflight.branchName }),
+    translator.t('ai.github.base', { base: plan.baseBranch }),
+    translator.t('ai.github.pr_body', { path: plan.prBodyRelativePath }),
+    translator.t('ai.github.title', { title: plan.title }),
+    translator.t('ai.github.command', { command: `${plan.ghCommand} ${plan.args.map(quoteCommandArg).join(' ')}` }),
   ];
 
   if (preflight.sshHostAlias) {
-    lines.push(`SSH host alias: ${preflight.sshHostAlias}`);
+    lines.push(translator.t('ai.github.ssh_host_alias', { alias: preflight.sshHostAlias }));
   }
 
   if (preflight.identityFile) {
-    lines.push(`Identity file: ${preflight.identityFile}`);
+    lines.push(translator.t('ai.github.identity_file', { path: preflight.identityFile }));
   }
 
   if (hasShellSensitivePath(preflight.repoRoot, preflight.identityFile, plan.prBodyPath, ...plan.args)) {
-    lines.push('Shell-safe command examples:');
+    lines.push(`${translator.t('ai.github.shell_safe_examples')}:`);
     lines.push(`- macOS/Linux/Git Bash/WSL: ${formatCommandForShell(plan.ghCommand, plan.args, quotePosixArg)}`);
     lines.push(`- Windows PowerShell: ${formatCommandForShell(plan.ghCommand, plan.args, quotePowerShellArg)}`);
   }
 
   if (dryRun) {
-    lines.push('No PR will be created in dry-run mode.');
+    lines.push(translator.t('ai.github.no_pr_dry_run'));
   } else if (!create) {
-    lines.push('No PR was created. Re-run with --create after reviewing the plan.');
+    lines.push(translator.t('ai.github.no_pr_created'));
   } else if (result && result.stdout) {
     lines.push(result.stdout.trimEnd());
   }

package/src/create-quiver/lib/ai/run-state.js

@@ -3,6 +3,7 @@ const os = require('node:os');
 const path = require('node:path');
 
 const { buildApprovalCandidateReport } = require('./approval-candidates');
+const { formatStatus, translatorForHuman } = require('../i18n/read-only-format');
 const { quiverInternalPaths } = require('../init-layout');
 
 const AI_RUN_PHASES = Object.freeze([
@@ -364,12 +365,13 @@ function releaseAiRunLock(projectRoot, runId, options = {}) {
   return filePath;
 }
 
-function formatAiRunStatus(projectRoot, run) {
+function formatAiRunStatus(projectRoot, run, options = {}) {
+  const translator = translatorForHuman(options);
   if (!run) {
     return [
-      'AI run status',
-      'Status: no active run',
-      'Next safe command: npx create-quiver ai run create --input <requirements.md>',
+      translator.t('ai.run.status.title'),
+      `${translator.t('ai.run.status')}: ${translator.t('ai.run.status.no_active')}`,
+      `${translator.t('ai.label.next_safe_command')}: npx create-quiver ai run create --input <requirements.md>`,
       '',
     ].join('\n');
   }
@@ -377,48 +379,49 @@ function formatAiRunStatus(projectRoot, run) {
   const openRuns = listAiRuns(projectRoot).filter((item) => item.status !== 'closed');
   const otherOpenRuns = openRuns.filter((item) => item.run_id !== run.run_id);
   const lines = [
-    'AI run status',
-    `Run: ${run.run_id}`,
-    `Status: ${run.status}`,
-    `Phase: ${run.phase}`,
-    `Spec: ${run.spec_slug || '(not generated)'}`,
-    `Requirement: ${run.requirement?.path || '(missing)'}`,
-    `State: ${toRelativePosix(projectRoot, runStatePath(projectRoot, run.run_id))}`,
-    `Approvals: ${run.approvals_path}`,
-    `Open runs: ${openRuns.length}`,
+    translator.t('ai.run.status.title'),
+    `${translator.t('ai.run.run')}: ${run.run_id}`,
+    `${translator.t('ai.run.status')}: ${formatStatus(run.status, translator)}`,
+    `${translator.t('ai.run.phase')}: ${run.phase}`,
+    `${translator.t('ai.run.spec')}: ${run.spec_slug || translator.t('ai.run.spec.not_generated')}`,
+    `${translator.t('ai.run.requirement')}: ${run.requirement?.path || translator.t('ai.run.missing')}`,
+    `${translator.t('ai.run.state')}: ${toRelativePosix(projectRoot, runStatePath(projectRoot, run.run_id))}`,
+    `${translator.t('ai.run.approvals')}: ${run.approvals_path}`,
+    `${translator.t('ai.run.open_runs')}: ${openRuns.length}`,
   ];
 
   if (otherOpenRuns.length > 0) {
-    lines.push('Other open runs:');
+    lines.push(`${translator.t('ai.run.other_open_runs')}:`);
     for (const item of otherOpenRuns) {
-      lines.push(`- ${item.run_id}: ${item.phase} (${item.status}) -> ${nextCommandForPhase(item.phase, projectRoot)}`);
+      lines.push(`- ${item.run_id}: ${item.phase} (${formatStatus(item.status, translator)}) -> ${nextCommandForPhase(item.phase, projectRoot)}`);
     }
   }
 
   lines.push(
-    `Next safe command: ${nextCommandForPhase(run.phase, projectRoot)}`,
+    `${translator.t('ai.label.next_safe_command')}: ${nextCommandForPhase(run.phase, projectRoot)}`,
     '',
   );
 
   return lines.join('\n');
 }
 
-function formatAiRunResume(projectRoot, run) {
+function formatAiRunResume(projectRoot, run, options = {}) {
+  const translator = translatorForHuman(options);
   if (!run) {
     return [
-      'AI run resume',
-      'No active run found.',
-      'Next safe command: npx create-quiver ai run create --input <requirements.md>',
+      translator.t('ai.run.resume.title'),
+      translator.t('ai.run.resume.no_active'),
+      `${translator.t('ai.label.next_safe_command')}: npx create-quiver ai run create --input <requirements.md>`,
       '',
     ].join('\n');
   }
 
   return [
-    'AI run resume',
-    `Run: ${run.run_id}`,
-    `Current phase: ${run.phase}`,
-    `Next safe command: ${nextCommandForPhase(run.phase, projectRoot)}`,
-    `State: ${toRelativePosix(projectRoot, runStatePath(projectRoot, run.run_id))}`,
+    translator.t('ai.run.resume.title'),
+    `${translator.t('ai.run.run')}: ${run.run_id}`,
+    `${translator.t('ai.run.current_phase')}: ${run.phase}`,
+    `${translator.t('ai.label.next_safe_command')}: ${nextCommandForPhase(run.phase, projectRoot)}`,
+    `${translator.t('ai.run.state')}: ${toRelativePosix(projectRoot, runStatePath(projectRoot, run.run_id))}`,
     '',
   ].join('\n');
 }

package/src/create-quiver/lib/ai/spec-templates.js

@@ -289,6 +289,25 @@ function buildPrMarkdown(manifest) {
     '',
     'Generate the spec foundation, slice-00, implementation slices, execution plan, and PR body from the approved planning input.',
     '',
+    '## PR Policy',
+    '',
+    '- [ ] One slice only.',
+    '- [ ] Grouped PR exception: at most 2-3 slices, all docs-only, research-only, or low-risk mechanical cleanup.',
+    '- [ ] No behavior changes in a grouped PR.',
+    '- [ ] No mixed docs with UI, backend, refactor, or performance work.',
+    '- [ ] Separate evidence for each included slice.',
+    '- [ ] Whole PR is revertible without leaving partial state.',
+    '',
+    'Individual PR required when the slice includes functional code, UI/UX, Supabase, Edge Functions, auth, storage, preview, performance/code-splitting, refactors, or tests/CI changes that affect gates.',
+    '',
+    '### Merge Policy',
+    '',
+    '- [ ] 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 prohibited for UI, Supabase, Edge Functions, auth, storage, preview, performance, refactors, and changes with doubtful rollback.',
+    '',
     '## Scope',
     '',
     '- `SPEC.md`',

package/src/create-quiver/lib/cli/command-registry.js

@@ -0,0 +1,71 @@
+const SUPPORTED_COMMAND_MODES = new Set([
+  'init',
+  'version',
+  'changelog',
+  'flow',
+  'dashboard',
+  'plan',
+  'graph',
+  'next',
+  'doctor',
+  'prepare',
+  'analyze',
+  'migrate',
+  'slice',
+  'handoff',
+  'start-slice',
+  'check-slice',
+  'check-pr',
+  'check-handoff',
+  'new-handoff',
+  'cleanup-slice',
+  'check-scope',
+  'config',
+  'refresh-active-slices',
+  'spec',
+  'evidence',
+  'demo',
+  'ai',
+]);
+
+const SUPPORTED_AI_COMMANDS = new Set([
+  'active-slice',
+  'agent',
+  'approve',
+  'approval-status',
+  'approvals',
+  'doctor',
+  'execute-plan',
+  'execute-slice',
+  'executor-prompt',
+  'export',
+  'inspect',
+  'onboard',
+  'plan',
+  'prepare-context',
+  'pr',
+  'prompt-slice',
+  'repair-plan',
+  'review-plan',
+  'revise',
+  'resume',
+  'run',
+  'slices',
+  'specs',
+  'status',
+  'trace',
+]);
+
+const SUPPORTED_SPEC_COMMANDS = new Set(['close', 'create', 'start', 'status', 'validate']);
+const SUPPORTED_DEMO_COMMANDS = new Set(['create']);
+const SUPPORTED_CONFIG_SECTIONS = new Set(['language']);
+const SUPPORTED_CONFIG_LANGUAGE_COMMANDS = new Set(['show', 'set']);
+
+module.exports = {
+  SUPPORTED_AI_COMMANDS,
+  SUPPORTED_COMMAND_MODES,
+  SUPPORTED_CONFIG_LANGUAGE_COMMANDS,
+  SUPPORTED_CONFIG_SECTIONS,
+  SUPPORTED_DEMO_COMMANDS,
+  SUPPORTED_SPEC_COMMANDS,
+};

package/src/create-quiver/lib/cli/parser.js

@@ -0,0 +1,14 @@
+function parseCliArgs(argv, options = {}) {
+  const legacyParseArgs = options.legacyParseArgs;
+  if (typeof legacyParseArgs !== 'function') {
+    throw new TypeError('parseCliArgs requires a legacyParseArgs adapter');
+  }
+
+  return legacyParseArgs(argv, {
+    language: options.language,
+  });
+}
+
+module.exports = {
+  parseCliArgs,
+};