@nerviq/cli 1.8.9 → 1.9.0

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@nerviq/cli)](https://www.npmjs.com/package/@nerviq/cli)
 [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
-[![Checks: 2431](https://img.shields.io/badge/checks-2431-brightgreen)](https://github.com/nerviq/nerviq)
+[![Checks: 2438](https://img.shields.io/badge/checks-2438-brightgreen)](https://github.com/nerviq/nerviq)
 
 ---
 
@@ -14,7 +14,7 @@ Nerviq audits, sets up, and governs AI coding agent configurations for **8 platf
 
 | Platform | Checks | Status |
 |----------|--------|--------|
-| Claude Code | 393 | Full |
+| Claude Code | 400 | Full |
 | Codex (OpenAI) | 272 | Full |
 | Gemini CLI (Google) | 300 | Full |
 | GitHub Copilot | 299 | Full |
@@ -85,7 +85,7 @@ No install required. Zero dependencies.
 | **Team lead / DevEx** | `nerviq governance` → `nerviq audit --json` | CI threshold + `nerviq watch` |
 | **Enterprise / Platform** | `nerviq harmony-audit` → `nerviq harmony-drift` | Policy packs + `nerviq certify` |
 
-## 2,431 Checks Across 96 Categories (8 Platforms × ~300 Governance Rules)
+## 2,438 Checks Across 96 Categories (8 Platforms × ~300 Governance Rules)
 
 | Category Group | Checks | Examples |
 |----------------|--------|---------|
@@ -290,7 +290,7 @@ Nerviq is built on the NERVIQ knowledge engine — the largest verified catalog
 
 - **448+ research documents** covering all 8 platforms
 - **332+ experiments** with tested, rated results
-- **2,431 checks** across 8 platforms (~300 unique governance rules × 8 platform adaptations), each with `sourceUrl` and `confidence` level (0.0-1.0)
+- **2,438 checks** across 8 platforms (~300 unique governance rules × 8 platform adaptations), each with `sourceUrl` and `confidence` level (0.0-1.0)
 - Every check is traceable to primary documentation or verified experiment
 - 90-day freshness cycle: stale findings are re-verified or pruned
 
@@ -347,3 +347,16 @@ If Nerviq helped you, consider giving it a ⭐ on [GitHub](https://github.com/ne
 | `BETA` | Works but has limited real-world testing. API may change |
 | `EXPERIMENTAL` | Early stage, static rules, results may vary |
 
+## Previously nerviq-cli
+
+Nerviq was previously published as `nerviq-cli`. If you were using it:
+
+```bash
+# Old
+npx nerviq-cli
+
+# New
+npx @nerviq/cli audit
+```
+
+All features are preserved and expanded.

package/bin/cli.js

@@ -14,6 +14,7 @@ const { auditWorkspaces } = require('../src/workspace');
 const { scanOrg } = require('../src/org');
 const { detectAntiPatterns, printAntiPatterns, printAntiPatternCatalog } = require('../src/anti-patterns');
 const { VERIFICATION_DATES, getVerificationDate, getVerificationStats } = require('../src/verification-metadata');
+const { init: initI18n, t } = require('../src/i18n');
 const { version } = require('../package.json');
 
 const args = process.argv.slice(2);
@@ -91,11 +92,12 @@ function parseArgs(rawArgs) {
   let external = null;
   let repos = [];
   let teamProfile = null;
+  let lang = null;
 
   for (let i = 0; i < rawArgs.length; i++) {
     const arg = rawArgs[i];
 
-    if (arg === '--threshold' || arg === '--out' || arg === '--plan' || arg === '--only' || arg === '--profile' || arg === '--mcp-pack' || arg === '--require' || arg === '--key' || arg === '--status' || arg === '--effect' || arg === '--notes' || arg === '--source' || arg === '--score-delta' || arg === '--platform' || arg === '--format' || arg === '--from' || arg === '--to' || arg === '--port' || arg === '--workspace' || arg === '--check-version' || arg === '--webhook' || arg === '--external' || arg === '--team-profile') {
+    if (arg === '--threshold' || arg === '--out' || arg === '--plan' || arg === '--only' || arg === '--profile' || arg === '--mcp-pack' || arg === '--require' || arg === '--key' || arg === '--status' || arg === '--effect' || arg === '--notes' || arg === '--source' || arg === '--score-delta' || arg === '--platform' || arg === '--format' || arg === '--from' || arg === '--to' || arg === '--port' || arg === '--workspace' || arg === '--check-version' || arg === '--webhook' || arg === '--external' || arg === '--team-profile' || arg === '--lang') {
       const value = rawArgs[i + 1];
       if (!value || value.startsWith('--')) {
         throw new Error(`${arg} requires a value`);
@@ -123,10 +125,16 @@ function parseArgs(rawArgs) {
       if (arg === '--webhook') webhookUrl = value.trim();
       if (arg === '--external') external = value.trim();
       if (arg === '--team-profile') teamProfile = value.trim();
+      if (arg === '--lang') lang = value.trim().toLowerCase();
       i++;
       continue;
     }
 
+    if (arg.startsWith('--lang=')) {
+      lang = arg.split('=').slice(1).join('=').trim().toLowerCase();
+      continue;
+    }
+
     if (arg.startsWith('--team-profile=')) {
       teamProfile = arg.split('=').slice(1).join('=').trim();
       continue;
@@ -258,7 +266,7 @@ function parseArgs(rawArgs) {
 
   const normalizedCommand = COMMAND_ALIASES[command] || command;
 
-  return { flags, command, normalizedCommand, threshold, out, planFile, only, profile, mcpPacks, requireChecks, feedbackKey, feedbackStatus, feedbackEffect, feedbackNotes, feedbackSource, feedbackScoreDelta, platform, format, port, workspace, extraArgs, convertFrom, convertTo, migrateFrom, migrateTo, checkVersion, webhookUrl, external, repos, teamProfile };
+  return { flags, command, normalizedCommand, threshold, out, planFile, only, profile, mcpPacks, requireChecks, feedbackKey, feedbackStatus, feedbackEffect, feedbackNotes, feedbackSource, feedbackScoreDelta, platform, format, port, workspace, extraArgs, convertFrom, convertTo, migrateFrom, migrateTo, checkVersion, webhookUrl, external, repos, teamProfile, lang };
 }
 
 function printWorkspaceSummary(summary, options) {
@@ -512,6 +520,11 @@ async function main() {
 
   const { flags, command, normalizedCommand } = parsed;
 
+  // Initialize i18n with --lang flag or NERVIQ_LANG env var
+  if (parsed.lang) {
+    initI18n(parsed.lang);
+  }
+
   if (flags.includes('--help') || command === 'help') {
     console.log(HELP);
     process.exit(0);
@@ -547,6 +560,7 @@ async function main() {
     port: parsed.port !== null ? Number(parsed.port) : null,
     workspace: parsed.workspace || null,
     webhookUrl: parsed.webhookUrl || null,
+    lang: parsed.lang || null,
     external: parsed.external || null,
     dir: process.cwd()
   };

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "@nerviq/cli",
-  "version": "1.8.9",
-  "description": "The intelligent nervous system for AI coding agents — 2,431 checks (8 platforms × ~300 governance rules), 10 languages, 62 domain packs. Audit, align, and amplify.",
-  "main": "src/index.js",
-  "bin": {
-    "nerviq": "bin/cli.js",
-    "@nerviq/cli": "bin/cli.js",
-    "nerviq-mcp": "src/mcp-server.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "README.md"
-  ],
-  "scripts": {
-    "start": "node bin/cli.js",
-    "build": "npm pack --dry-run",
-    "test": "node test/run.js",
-    "test:jest": "jest",
-    "test:coverage": "jest --coverage",
-    "test:all": "npm test && npx jest && node test/check-matrix.js && node test/codex-check-matrix.js && node test/gemini-check-matrix.js && node test/copilot-check-matrix.js && node test/cursor-check-matrix.js && node test/windsurf-check-matrix.js && node test/aider-check-matrix.js && node test/opencode-check-matrix.js && node test/golden-matrix.js && node test/codex-golden-matrix.js && node test/gemini-golden-matrix.js && node test/copilot-golden-matrix.js && node test/cursor-golden-matrix.js && node test/windsurf-golden-matrix.js && node test/aider-golden-matrix.js && node test/opencode-golden-matrix.js",
-    "benchmark:perf": "node tools/benchmark.js",
-    "catalog": "node -e \"const {generateCatalog}=require('./src/catalog');console.log(JSON.stringify(generateCatalog(),null,2))\""
-  },
-  "keywords": [
-    "nerviq",
-    "ai-agents",
-    "agent-governance",
-    "agent-config",
-    "harmony",
-    "synergy",
-    "audit",
-    "claude",
-    "codex",
-    "gemini",
-    "copilot",
-    "cursor",
-    "windsurf",
-    "aider",
-    "developer-tools",
-    "cli",
-    "mcp",
-    "multi-agent"
-  ],
-  "author": "Nerviq <hello@nerviq.net>",
-  "license": "AGPL-3.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/nerviq/nerviq.git"
-  },
-  "homepage": "https://nerviq.net",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "devDependencies": {
-    "jest": "^30.3.0"
-  }
-}
+{
+  "name": "@nerviq/cli",
+  "version": "1.9.0",
+  "description": "The intelligent nervous system for AI coding agents — 2,438 checks (8 platforms × ~300 governance rules), 10 languages, 62 domain packs. Audit, align, and amplify.",
+  "main": "src/index.js",
+  "bin": {
+    "nerviq": "bin/cli.js",
+    "@nerviq/cli": "bin/cli.js",
+    "nerviq-mcp": "src/mcp-server.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node bin/cli.js",
+    "build": "npm pack --dry-run",
+    "test": "node test/run.js",
+    "test:jest": "jest",
+    "test:coverage": "jest --coverage",
+    "test:all": "npm test && npx jest && node test/check-matrix.js && node test/codex-check-matrix.js && node test/gemini-check-matrix.js && node test/copilot-check-matrix.js && node test/cursor-check-matrix.js && node test/windsurf-check-matrix.js && node test/aider-check-matrix.js && node test/opencode-check-matrix.js && node test/golden-matrix.js && node test/codex-golden-matrix.js && node test/gemini-golden-matrix.js && node test/copilot-golden-matrix.js && node test/cursor-golden-matrix.js && node test/windsurf-golden-matrix.js && node test/aider-golden-matrix.js && node test/opencode-golden-matrix.js",
+    "benchmark:perf": "node tools/benchmark.js",
+    "catalog": "node -e \"const {generateCatalog}=require('./src/catalog');console.log(JSON.stringify(generateCatalog(),null,2))\""
+  },
+  "keywords": [
+    "nerviq",
+    "ai-agents",
+    "agent-governance",
+    "agent-config",
+    "harmony",
+    "synergy",
+    "audit",
+    "claude",
+    "codex",
+    "gemini",
+    "copilot",
+    "cursor",
+    "windsurf",
+    "aider",
+    "developer-tools",
+    "cli",
+    "mcp",
+    "multi-agent"
+  ],
+  "author": "Nerviq <hello@nerviq.net>",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nerviq/nerviq.git"
+  },
+  "homepage": "https://nerviq.net",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "jest": "^30.3.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,9 +902,9 @@ 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';
+    scoreExplanation = t('audit.early');
   }
   console.log(colorize(`  ${scoreExplanation}`, 'dim'));
 
@@ -1233,10 +1234,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/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,
+};