@nerviq/cli 1.8.9 → 1.10.0

package/src/audit.js

@@ -33,6 +33,7 @@ const { loadPlugins, mergePluginChecks } = require('./plugins');
 const { hasWorkspaceConfig, detectWorkspaceGlobs, detectWorkspaces } = require('./workspace');
 const { detectDeprecationWarnings } = require('./deprecation');
 const { version: packageVersion } = require('../package.json');
+const { t } = require('./i18n');
 
 const COLORS = {
   reset: '\x1b[0m',
@@ -872,27 +873,27 @@ function getCodexDomainPackSignals(ctx) {
 
 function printLiteAudit(result, dir) {
   console.log('');
-  const productLabel = result.platform === 'codex' ? 'nerviq codex quick scan' : 'nerviq quick scan';
+  const productLabel = result.platform === 'codex' ? t('audit.codexQuickScan') : t('audit.quickScan');
   console.log(colorize(`  ${productLabel}`, 'bold'));
   console.log(colorize('  ═══════════════════════════════════════', 'dim'));
-  console.log(colorize(`  Scanning: ${dir}`, 'dim'));
+  console.log(colorize(`  ${t('audit.scanning', { dir })}`, 'dim'));
   console.log('');
   if (result.detectedConfigFiles && result.detectedConfigFiles.length > 0) {
     console.log(colorize(`  Found: ${result.detectedConfigFiles.join(', ')}`, 'dim'));
   }
   console.log('');
-  console.log(`  Score: ${colorize(`${result.score}/100`, 'bold')}  (${result.passed}/${result.passed + result.failed} checks passing)`);
+  console.log(`  ${t('audit.score', { score: colorize(`${result.score}/100`, 'bold'), passed: result.passed, total: result.passed + result.failed })}`);
 
   // Score explanation line (lite mode only)
   const _critCount = (result.results || []).filter(r => r.passed === false && r.impact === 'critical').length;
   const _highCount = (result.results || []).filter(r => r.passed === false && r.impact === 'high').length;
   let scoreExplanation;
   if (result.score >= 90) {
-    scoreExplanation = 'Excellent setup — production-ready governance';
+    scoreExplanation = t('audit.excellent');
   } else if (result.score >= 70) {
-    scoreExplanation = `Strong setup — ${_critCount} critical items to address`;
+    scoreExplanation = t('audit.strong', { count: _critCount });
   } else if (result.score >= 50) {
-    scoreExplanation = `Good foundation — ${_critCount + _highCount} items need attention`;
+    scoreExplanation = t('audit.good', { count: _critCount + _highCount });
   } else if (result.score >= 30) {
     // Find weakest category (most failures)
     const catFailures = {};
@@ -901,13 +902,14 @@ function printLiteAudit(result, dir) {
       catFailures[cat] = (catFailures[cat] || 0) + 1;
     });
     const weakestCategory = Object.keys(catFailures).sort((a, b) => catFailures[b] - catFailures[a])[0] || 'config';
-    scoreExplanation = `Basic setup — significant gaps in ${weakestCategory}`;
+    scoreExplanation = t('audit.basic', { category: weakestCategory });
   } else {
-    scoreExplanation = 'Early stage — run `nerviq setup` to bootstrap your config';
-  }
-  console.log(colorize(`  ${scoreExplanation}`, 'dim'));
-
-  if (result.platformScopeNote) {
+    scoreExplanation = t('audit.early');
+  }
+  console.log(colorize(`  ${scoreExplanation}`, 'dim'));
+  console.log(colorize('  Score type: live repo audit (current files only, not snapshot history or benchmark projection).', 'dim'));
+
+  if (result.platformScopeNote) {
     console.log(colorize(`  Scope: ${result.platformScopeNote.message}`, 'dim'));
   }
   if (result.workspaceHint && result.workspaceHint.workspaces.length > 0) {
@@ -1233,10 +1235,10 @@ async function audit(options) {
 
   // Display results
   console.log('');
-  const auditTitle = spec.platform === 'codex' ? 'nerviq codex audit' : 'nerviq audit';
+  const auditTitle = spec.platform === 'codex' ? t('audit.codexTitle') : t('audit.title');
   console.log(colorize(`  ${auditTitle}`, 'bold'));
   console.log(colorize('  ═══════════════════════════════════════', 'dim'));
-  console.log(colorize(`  Scanning: ${options.dir}`, 'dim'));
+  console.log(colorize(`  ${t('audit.scanning', { dir: options.dir })}`, 'dim'));
   if (spec.platformVersion) {
     console.log(colorize(`  Platform: ${spec.platformLabel} (${spec.platformVersion})`, 'blue'));
   }

package/src/auto-suggest.js

@@ -52,23 +52,72 @@ function analyzeSuggestions(dir) {
     .sort((a, b) => b[1] - a[1])
     .map(([key, count]) => ({ key, failCount: count, auditCount: auditSnapshots.length }));
 
-  return { totalEvents, auditCount: auditSnapshots.length, suggestedRules, suggestedSuppressions, suggestedPriorities };
+  const hasSuggestions = suggestedRules.length > 0 || suggestedSuppressions.length > 0 || suggestedPriorities.length > 0;
+  let bootstrap = { ready: true, state: 'ready', message: null, steps: [] };
+
+  if (totalEvents === 0 && auditSnapshots.length === 0) {
+    bootstrap = {
+      ready: false,
+      state: 'empty',
+      message: 'No local usage or snapshot history exists yet.',
+      steps: [
+        'Run `nerviq audit --snapshot` to save the baseline.',
+        'Use `nerviq fix`, `nerviq fix --all-critical`, or `nerviq feedback` to record recommendation outcomes.',
+        'Run `nerviq audit --snapshot` again after a meaningful repo change.',
+        'Re-run `nerviq suggest-rules`.',
+      ],
+    };
+  } else if (!hasSuggestions && totalEvents === 0 && auditSnapshots.length > 0) {
+    bootstrap = {
+      ready: false,
+      state: 'snapshots-only',
+      message: `${auditSnapshots.length} audit snapshot(s) exist, but no recommendation outcomes have been recorded yet.`,
+      steps: [
+        'Run `nerviq fix` or `nerviq feedback` so Nerviq can learn which recommendations you accept or reject.',
+        'Re-run `nerviq suggest-rules` after another fix cycle.',
+      ],
+    };
+  } else if (!hasSuggestions && totalEvents > 0 && auditSnapshots.length === 0) {
+    bootstrap = {
+      ready: false,
+      state: 'patterns-only',
+      message: `${totalEvents} usage event(s) exist, but no audit snapshots have been saved yet.`,
+      steps: [
+        'Run `nerviq audit --snapshot` to save the baseline.',
+        'Run it again after changes so repeated failures can be prioritized.',
+        'Re-run `nerviq suggest-rules`.',
+      ],
+    };
+  } else if (!hasSuggestions) {
+    bootstrap = {
+      ready: false,
+      state: 'warming-up',
+      message: `Nerviq has some local history (${totalEvents} pattern events, ${auditSnapshots.length} audit snapshots), but not enough repeated signals yet.`,
+      steps: [
+        'Keep saving snapshots with `nerviq audit --snapshot`.',
+        'Keep recording outcomes with `nerviq fix` or `nerviq feedback`.',
+        'Re-run `nerviq suggest-rules` after another change cycle.',
+      ],
+    };
+  }
+
+  return { totalEvents, auditCount: auditSnapshots.length, suggestedRules, suggestedSuppressions, suggestedPriorities, bootstrap };
 }
 
 /**
  * Format suggestions for CLI output.
  */
 function formatSuggestions(suggestions) {
-  const { totalEvents, auditCount, suggestedRules, suggestedSuppressions, suggestedPriorities } = suggestions;
-
-  if (totalEvents === 0 && auditCount === 0) {
-    return '  No usage data yet. Run nerviq fix or nerviq audit to build pattern history.';
-  }
+  const { totalEvents, auditCount, suggestedRules, suggestedSuppressions, suggestedPriorities, bootstrap } = suggestions;
 
   const sources = [];
   if (totalEvents > 0) sources.push(`${totalEvents} pattern events`);
   if (auditCount > 0) sources.push(`${auditCount} audit snapshots`);
-  const lines = [`  Auto-Suggested Rules (based on ${sources.join(', ')}):`];
+  const lines = [
+    sources.length > 0
+      ? `  Auto-Suggested Rules (based on ${sources.join(', ')}):`
+      : '  Auto-Suggested Rules:',
+  ];
 
   if (suggestedRules.length > 0) {
     lines.push('', '  Suggested as required (always accepted):');
@@ -91,8 +140,12 @@ function formatSuggestions(suggestions) {
     }
   }
 
-  if (suggestedRules.length === 0 && suggestedSuppressions.length === 0 && suggestedPriorities.length === 0) {
-    lines.push('', '  No strong patterns detected yet. Keep using nerviq fix and audit to build history.');
+  if (suggestedRules.length === 0 && suggestedSuppressions.length === 0 && suggestedPriorities.length === 0 && bootstrap && !bootstrap.ready) {
+    lines.push('', `  ${bootstrap.message}`);
+    lines.push('  Bootstrap it with:');
+    for (let i = 0; i < bootstrap.steps.length; i++) {
+      lines.push(`  ${i + 1}. ${bootstrap.steps[i]}`);
+    }
   }
 
   return lines.join('\n');

package/src/benchmark.js

@@ -201,31 +201,36 @@ function buildCaseStudy(before, after, applyResult) {
   };
 }
 
-function renderBenchmarkMarkdown(report) {
-  return [
-    '# NERVIQ CLI Benchmark Report',
-    '',
-    `- Generated by: ${report.generatedBy}`,
-    `- Created at: ${report.createdAt}`,
-    `- Source repo: ${report.directory}`,
-    '',
-    '## Methodology',
-    ...report.methodology.map(item => `- ${item}`),
-    '',
-    '## Before',
-    `- Score: ${report.before.score}/100`,
-    `- Organic score: ${report.before.organicScore}/100`,
-    `- Passing checks: ${report.before.passed}/${report.before.checkCount}`,
-    '',
-    '## After',
-    `- Score: ${report.after.score}/100`,
-    `- Organic score: ${report.after.organicScore}/100`,
-    `- Passing checks: ${report.after.passed}/${report.after.checkCount}`,
-    '',
-    '## Delta',
-    `- Score delta: ${report.delta.score}`,
-    `- Organic score delta: ${report.delta.organicScore}`,
-    `- Passed checks delta: ${report.delta.passed}`,
+function renderBenchmarkMarkdown(report) {
+  return [
+    '# NERVIQ CLI Benchmark Report',
+    '',
+    `- Generated by: ${report.generatedBy}`,
+    `- Created at: ${report.createdAt}`,
+    `- Source repo: ${report.directory}`,
+    '',
+    '## Score Semantics',
+    `- Baseline live audit score: ${report.scoreSemantics.baseline}`,
+    `- Projected benchmark score: ${report.scoreSemantics.projected}`,
+    `- Organic score: ${report.scoreSemantics.organic}`,
+    '',
+    '## Methodology',
+    ...report.methodology.map(item => `- ${item}`),
+    '',
+    '## Baseline (Live Repo)',
+    `- Live audit score: ${report.before.score}/100`,
+    `- Organic live score: ${report.before.organicScore}/100`,
+    `- Passing checks: ${report.before.passed}/${report.before.checkCount}`,
+    '',
+    '## Projected (Isolated Benchmark Copy)',
+    `- Projected benchmark score: ${report.after.score}/100`,
+    `- Projected organic score: ${report.after.organicScore}/100`,
+    `- Passing checks: ${report.after.passed}/${report.after.checkCount}`,
+    '',
+    '## Delta',
+    `- Projected score delta: ${report.delta.score}`,
+    `- Projected organic score delta: ${report.delta.organicScore}`,
+    `- Passed checks delta: ${report.delta.passed}`,
     '',
     '## Executive Summary',
     `- ${report.executiveSummary.headline}`,
@@ -285,9 +290,14 @@ async function runBenchmark(options) {
       schemaVersion: 1,
       generatedBy: `nerviq@${version}`,
       createdAt: new Date().toISOString(),
-      directory: sourceDir,
-      platform,
-      methodology: [
+      directory: sourceDir,
+      platform,
+      scoreSemantics: {
+        baseline: 'current repo state before benchmark runs',
+        projected: 'starter-safe post-setup score measured on an isolated temp copy',
+        organic: 'repo-owned config quality excluding starter-generated Nerviq assets',
+      },
+      methodology: [
         'Run a baseline audit on the source repo.',
         'Copy the repo into a temporary isolated workspace.',
         `Apply starter-safe ${platform === 'codex' ? 'Codex' : 'Claude'} artifacts only on the isolated copy.`,
@@ -316,19 +326,20 @@ function printBenchmark(report, options = {}) {
     return;
   }
 
-  console.log('');
-  console.log('  nerviq benchmark');
-  console.log('  ═══════════════════════════════════════');
-  console.log('  Runs in an isolated temp copy. Your current repo is not modified.');
-  console.log('');
-  const orgDeltaSign = report.delta.organicScore >= 0 ? '+' : '';
-  const totalDeltaSign = report.delta.score >= 0 ? '+' : '';
-  console.log(`  Organic improvement: \x1b[1m${orgDeltaSign}${report.delta.organicScore} points\x1b[0m (your actual config quality)`);
-  console.log(`  Total with nerviq setup: ${totalDeltaSign}${report.delta.score} points`);
-  console.log('');
-  console.log(`  Before:  organic ${report.before.organicScore}/100, total ${report.before.score}/100`);
-  console.log(`  After:   organic ${report.after.organicScore}/100, total ${report.after.score}/100`);
-  console.log('');
+  console.log('');
+  console.log('  nerviq benchmark');
+  console.log('  ═══════════════════════════════════════');
+  console.log('  Runs in an isolated temp copy. Your current repo is not modified.');
+  console.log('  Score type: baseline = live repo audit, projected = isolated post-setup benchmark.');
+  console.log('');
+  const orgDeltaSign = report.delta.organicScore >= 0 ? '+' : '';
+  const totalDeltaSign = report.delta.score >= 0 ? '+' : '';
+  console.log(`  Projected organic delta: \x1b[1m${orgDeltaSign}${report.delta.organicScore} points\x1b[0m (repo-owned config quality)`);
+  console.log(`  Projected total delta with nerviq setup: ${totalDeltaSign}${report.delta.score} points`);
+  console.log('');
+  console.log(`  Baseline live audit:      organic ${report.before.organicScore}/100, total ${report.before.score}/100`);
+  console.log(`  Projected after setup:    organic ${report.after.organicScore}/100, total ${report.after.score}/100`);
+  console.log('');
   console.log(`  ${report.executiveSummary.headline}`);
   console.log(`  Recommendation: ${report.executiveSummary.decisionGuidance}`);
   console.log(`  Workflow evidence: ${report.workflowEvidence.summary.passed}/${report.workflowEvidence.summary.total} tasks (${report.workflowEvidence.summary.coverageScore}%)`);

package/src/codex/freshness.js

@@ -1,167 +1,167 @@
-/**
- * Codex Freshness Operationalization — CP-12
- *
- * Release gates, recurring probes, propagation checklists,
- * and staleness blocking for Codex surfaces.
- */
-
-const { version } = require('../../package.json');
-
-/**
- * P0 sources that must be fresh before any Codex release claim.
- * Each source has a staleness threshold in days.
- */
-const P0_SOURCES = [
-  {
-    key: 'codex-cli-docs',
-    label: 'Codex CLI Official Docs',
-    url: 'https://docs.codex.ai',
-    stalenessThresholdDays: 30,
-    verifiedAt: null, // Set during release gate check
-  },
-  {
-    key: 'codex-config-reference',
-    label: 'Codex Config Reference',
-    url: 'https://docs.codex.ai/config',
-    stalenessThresholdDays: 30,
-    verifiedAt: null,
-  },
-  {
-    key: 'codex-github-action',
-    label: 'Codex GitHub Action',
-    url: 'https://github.com/openai/codex-action',
-    stalenessThresholdDays: 30,
-    verifiedAt: null,
-  },
-  {
-    key: 'codex-changelog',
-    label: 'Codex CLI Changelog',
-    url: 'https://github.com/openai/codex-cli/releases',
-    stalenessThresholdDays: 14,
-    verifiedAt: null,
-  },
-];
-
-/**
- * Propagation checklist: when a Codex source changes, these must update.
- */
-const PROPAGATION_CHECKLIST = [
-  {
-    trigger: 'Codex CLI release with config changes',
-    targets: [
-      'src/codex/techniques.js — update LEGACY_CONFIG_PATTERNS if keys renamed/removed',
-      'src/codex/config-parser.js — update validation rules',
-      'src/codex/governance.js — update caveats if behavior changes',
-      'test/codex-check-matrix.js — update check expectations',
-    ],
-  },
-  {
-    trigger: 'New Codex hook event type added',
-    targets: [
-      'src/codex/techniques.js — add to SUPPORTED_HOOK_EVENTS',
-      'src/codex/governance.js — add to CODEX_HOOK_REGISTRY',
-      'src/codex/setup.js — update hooks starter template',
-    ],
-  },
-  {
-    trigger: 'New Codex MCP transport or field',
-    targets: [
-      'src/codex/mcp-packs.js — update pack TOML projections',
-      'src/codex/techniques.js — update MCP checks',
-    ],
-  },
-  {
-    trigger: 'Codex domain pack definitions change',
-    targets: [
-      'src/codex/domain-packs.js — update pack registry',
-      'src/codex/governance.js — governance export picks up changes',
-    ],
-  },
-  {
-    trigger: 'New check category added',
-    targets: [
-      'src/codex/techniques.js — add check implementations',
-      'test/codex-check-matrix.js — add pass/fail scenarios',
-      'test/codex-golden-matrix.js — update golden scores',
-    ],
-  },
-];
-
-/**
- * Release gate: check if all P0 sources are within staleness threshold.
- * Returns { ready, stale, fresh } arrays.
- */
-function checkReleaseGate(sourceVerifications = {}) {
-  const now = new Date();
-  const results = P0_SOURCES.map(source => {
-    const verifiedAt = sourceVerifications[source.key]
-      ? new Date(sourceVerifications[source.key])
-      : source.verifiedAt ? new Date(source.verifiedAt) : null;
-
-    if (!verifiedAt) {
-      return { ...source, status: 'unverified', daysStale: null };
-    }
-
-    const daysSince = Math.floor((now - verifiedAt) / (1000 * 60 * 60 * 24));
-    const isStale = daysSince > source.stalenessThresholdDays;
-
-    return {
-      ...source,
-      verifiedAt: verifiedAt.toISOString(),
-      daysStale: daysSince,
-      status: isStale ? 'stale' : 'fresh',
-    };
-  });
-
-  return {
-    ready: results.every(r => r.status === 'fresh'),
-    stale: results.filter(r => r.status === 'stale' || r.status === 'unverified'),
-    fresh: results.filter(r => r.status === 'fresh'),
-    results,
-  };
-}
-
-/**
- * Format the release gate results for display.
- */
-function formatReleaseGate(gateResult) {
-  const lines = [
-    `Codex Freshness Gate (nerviq v${version})`,
-    '═══════════════════════════════════════',
-    '',
-    `Status: ${gateResult.ready ? 'READY' : 'BLOCKED'}`,
-    `Fresh: ${gateResult.fresh.length}/${gateResult.results.length}`,
-    '',
-  ];
-
-  for (const result of gateResult.results) {
-    const icon = result.status === 'fresh' ? '✓' : result.status === 'stale' ? '✗' : '?';
-    const age = result.daysStale !== null ? ` (${result.daysStale}d ago)` : ' (unverified)';
-    lines.push(`  ${icon} ${result.label}${age} — threshold: ${result.stalenessThresholdDays}d`);
-  }
-
-  if (!gateResult.ready) {
-    lines.push('');
-    lines.push('Action required: verify stale/unverified sources before claiming release freshness.');
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * Get the propagation checklist for a given trigger.
- */
-function getPropagationTargets(triggerKeyword) {
-  const keyword = triggerKeyword.toLowerCase();
-  return PROPAGATION_CHECKLIST.filter(item =>
-    item.trigger.toLowerCase().includes(keyword)
-  );
-}
-
-module.exports = {
-  P0_SOURCES,
-  PROPAGATION_CHECKLIST,
-  checkReleaseGate,
-  formatReleaseGate,
-  getPropagationTargets,
-};
+/**
+ * Codex Freshness Operationalization — CP-12
+ *
+ * Release gates, recurring probes, propagation checklists,
+ * and staleness blocking for Codex surfaces.
+ */
+
+const { version } = require('../../package.json');
+
+/**
+ * P0 sources that must be fresh before any Codex release claim.
+ * Each source has a staleness threshold in days.
+ */
+const P0_SOURCES = [
+  {
+    key: 'codex-cli-docs',
+    label: 'Codex CLI Official Docs',
+    url: 'https://developers.openai.com/codex/cli',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'codex-config-reference',
+    label: 'Codex Config Reference',
+    url: 'https://developers.openai.com/codex/config-reference',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'codex-github-action',
+    label: 'Codex GitHub Action',
+    url: 'https://github.com/openai/codex-action',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'codex-changelog',
+    label: 'Codex CLI Changelog',
+    url: 'https://github.com/openai/codex/releases',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-07',
+  },
+];
+
+/**
+ * Propagation checklist: when a Codex source changes, these must update.
+ */
+const PROPAGATION_CHECKLIST = [
+  {
+    trigger: 'Codex CLI release with config changes',
+    targets: [
+      'src/codex/techniques.js — update LEGACY_CONFIG_PATTERNS if keys renamed/removed',
+      'src/codex/config-parser.js — update validation rules',
+      'src/codex/governance.js — update caveats if behavior changes',
+      'test/codex-check-matrix.js — update check expectations',
+    ],
+  },
+  {
+    trigger: 'New Codex hook event type added',
+    targets: [
+      'src/codex/techniques.js — add to SUPPORTED_HOOK_EVENTS',
+      'src/codex/governance.js — add to CODEX_HOOK_REGISTRY',
+      'src/codex/setup.js — update hooks starter template',
+    ],
+  },
+  {
+    trigger: 'New Codex MCP transport or field',
+    targets: [
+      'src/codex/mcp-packs.js — update pack TOML projections',
+      'src/codex/techniques.js — update MCP checks',
+    ],
+  },
+  {
+    trigger: 'Codex domain pack definitions change',
+    targets: [
+      'src/codex/domain-packs.js — update pack registry',
+      'src/codex/governance.js — governance export picks up changes',
+    ],
+  },
+  {
+    trigger: 'New check category added',
+    targets: [
+      'src/codex/techniques.js — add check implementations',
+      'test/codex-check-matrix.js — add pass/fail scenarios',
+      'test/codex-golden-matrix.js — update golden scores',
+    ],
+  },
+];
+
+/**
+ * Release gate: check if all P0 sources are within staleness threshold.
+ * Returns { ready, stale, fresh } arrays.
+ */
+function checkReleaseGate(sourceVerifications = {}) {
+  const now = new Date();
+  const results = P0_SOURCES.map(source => {
+    const verifiedAt = sourceVerifications[source.key]
+      ? new Date(sourceVerifications[source.key])
+      : source.verifiedAt ? new Date(source.verifiedAt) : null;
+
+    if (!verifiedAt) {
+      return { ...source, status: 'unverified', daysStale: null };
+    }
+
+    const daysSince = Math.floor((now - verifiedAt) / (1000 * 60 * 60 * 24));
+    const isStale = daysSince > source.stalenessThresholdDays;
+
+    return {
+      ...source,
+      verifiedAt: verifiedAt.toISOString(),
+      daysStale: daysSince,
+      status: isStale ? 'stale' : 'fresh',
+    };
+  });
+
+  return {
+    ready: results.every(r => r.status === 'fresh'),
+    stale: results.filter(r => r.status === 'stale' || r.status === 'unverified'),
+    fresh: results.filter(r => r.status === 'fresh'),
+    results,
+  };
+}
+
+/**
+ * Format the release gate results for display.
+ */
+function formatReleaseGate(gateResult) {
+  const lines = [
+    `Codex Freshness Gate (nerviq v${version})`,
+    '═══════════════════════════════════════',
+    '',
+    `Status: ${gateResult.ready ? 'READY' : 'BLOCKED'}`,
+    `Fresh: ${gateResult.fresh.length}/${gateResult.results.length}`,
+    '',
+  ];
+
+  for (const result of gateResult.results) {
+    const icon = result.status === 'fresh' ? '✓' : result.status === 'stale' ? '✗' : '?';
+    const age = result.daysStale !== null ? ` (${result.daysStale}d ago)` : ' (unverified)';
+    lines.push(`  ${icon} ${result.label}${age} — threshold: ${result.stalenessThresholdDays}d`);
+  }
+
+  if (!gateResult.ready) {
+    lines.push('');
+    lines.push('Action required: verify stale/unverified sources before claiming release freshness.');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Get the propagation checklist for a given trigger.
+ */
+function getPropagationTargets(triggerKeyword) {
+  const keyword = triggerKeyword.toLowerCase();
+  return PROPAGATION_CHECKLIST.filter(item =>
+    item.trigger.toLowerCase().includes(keyword)
+  );
+}
+
+module.exports = {
+  P0_SOURCES,
+  PROPAGATION_CHECKLIST,
+  checkReleaseGate,
+  formatReleaseGate,
+  getPropagationTargets,
+};