@nerviq/cli 1.12.0 → 1.13.0

package/src/codex/freshness.js

@@ -8,10 +8,10 @@
 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 = [
+ * 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',
@@ -19,18 +19,53 @@ const P0_SOURCES = [
     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,
+  {
+    key: 'codex-config-reference',
+    label: 'Codex Config Reference',
+    url: 'https://developers.openai.com/codex/config-reference',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'codex-agent-approvals-security',
+    label: 'Codex Agent Approvals & Security',
+    url: 'https://developers.openai.com/codex/agent-approvals-security',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'codex-subagents',
+    label: 'Codex Subagents Documentation',
+    url: 'https://developers.openai.com/codex/subagents',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'codex-automations',
+    label: 'Codex Automations / App Workflows',
+    url: 'https://developers.openai.com/codex/app/automations',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'codex-local-environments',
+    label: 'Codex Local Environments / Worktrees',
+    url: 'https://developers.openai.com/codex/app/local-environments',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'codex-feature-maturity',
+    label: 'Codex Feature Maturity',
+    url: 'https://developers.openai.com/codex/feature-maturity',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'codex-github-action',
+    label: 'Codex GitHub Action',
+    url: 'https://github.com/openai/codex-action',
+    stalenessThresholdDays: 30,
     verifiedAt: '2026-04-07',
   },
   {
@@ -77,15 +112,39 @@ const PROPAGATION_CHECKLIST = [
       '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',
-    ],
-  },
-];
+  {
+    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',
+    ],
+  },
+  {
+    trigger: 'Codex approvals/security model change (approval classes, sandboxing, unattended safety behavior)',
+    targets: [
+      'src/codex/governance.js — update permission profiles and caveats',
+      'src/codex/techniques.js — update trust/security checks tied to approval behavior',
+      'src/source-urls.js — refresh Codex trust/authentication source mappings if docs move',
+    ],
+  },
+  {
+    trigger: 'Codex subagent or local-environment change (subagents, worktrees, workspace lifecycle, handoff expectations)',
+    targets: [
+      'src/codex/setup.js — update subagent/worktree starter templates',
+      'src/codex/techniques.js — update subagent and worktree governance checks',
+      'src/codex/governance.js — update multi-agent policy guidance',
+    ],
+  },
+  {
+    trigger: 'Codex automation or feature-maturity change (automations, background workflows, capability maturity guidance)',
+    targets: [
+      'src/codex/techniques.js — update automation and maturity-sensitive checks',
+      'src/codex/interactive.js — update automation/setup wizard copy if platform behavior changes',
+      'src/source-urls.js — refresh Codex automation and maturity source mappings',
+    ],
+  },
+];
 
 /**
  * Release gate: check if all P0 sources are within staleness threshold.

package/src/copilot/freshness.js

@@ -27,18 +27,39 @@ const P0_SOURCES = [
     stalenessThresholdDays: 30,
     verifiedAt: '2026-04-07',
   },
-  {
-    key: 'copilot-cloud-agent-docs',
-    label: 'Copilot Coding Agent',
-    url: 'https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent',
-    stalenessThresholdDays: 14,
-    verifiedAt: '2026-04-07',
-  },
-  {
-    key: 'copilot-prompt-files-docs',
-    label: 'Copilot Prompt Files Documentation',
-    url: 'https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot#creating-prompt-files',
-    stalenessThresholdDays: 30,
+  {
+    key: 'copilot-cloud-agent-docs',
+    label: 'Copilot Coding Agent',
+    url: 'https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'copilot-cli-docs',
+    label: 'Copilot CLI Documentation',
+    url: 'https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'copilot-model-lts-docs',
+    label: 'Copilot Base & LTS Models',
+    url: 'https://docs.github.com/en/copilot/concepts/fallback-and-lts-models',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'copilot-cli-custom-agents-docs',
+    label: 'Copilot CLI Custom Agents',
+    url: 'https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'copilot-prompt-files-docs',
+    label: 'Copilot Prompt Files Documentation',
+    url: 'https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot#creating-prompt-files',
+    stalenessThresholdDays: 30,
     verifiedAt: '2026-04-07',
   },
   {
@@ -123,14 +144,30 @@ const PROPAGATION_CHECKLIST = [
       'src/copilot/setup.js — update content exclusions guide',
     ],
   },
-  {
-    trigger: 'Organization policy change or new policy type',
-    targets: [
-      'src/copilot/techniques.js — update organization checks (CP-F01..CP-F05)',
-      'src/copilot/governance.js — update enterprise-managed profile',
-    ],
-  },
-];
+  {
+    trigger: 'Organization policy change or new policy type',
+    targets: [
+      'src/copilot/techniques.js — update organization checks (CP-F01..CP-F05)',
+      'src/copilot/governance.js — update enterprise-managed profile',
+    ],
+  },
+  {
+    trigger: 'Copilot CLI behavior change (CLI custom agents, hooks, memory, prompt layering)',
+    targets: [
+      'src/copilot/techniques.js — update CLI-agent and instruction-surface checks',
+      'src/copilot/setup.js — update starter guidance when CLI agent or hook behavior changes',
+      'src/source-urls.js — refresh Copilot source mappings for CLI-specific surfaces',
+    ],
+  },
+  {
+    trigger: 'Copilot model / fallback / LTS policy change',
+    targets: [
+      'src/copilot/governance.js — update model-selection and enterprise policy caveats',
+      'src/copilot/techniques.js — update trust/availability assumptions tied to model fallback behavior',
+      'src/source-urls.js — refresh Copilot model and maturity source mappings',
+    ],
+  },
+];
 
 /**
  * Release gate: check if all P0 sources are within staleness threshold.

package/src/cursor/freshness.js

@@ -41,18 +41,39 @@ const P0_SOURCES = [
     stalenessThresholdDays: 14,
     verifiedAt: '2026-04-07',
   },
-  {
-    key: 'cursor-automations',
-    label: 'Automations Documentation',
-    url: 'https://cursor.com/docs/cloud-agent/automations',
-    stalenessThresholdDays: 14,
-    verifiedAt: '2026-04-07',
-  },
-  {
-    key: 'cursor-bugbot',
-    label: 'BugBot Documentation',
-    url: 'https://cursor.com/docs/bugbot',
-    stalenessThresholdDays: 30,
+  {
+    key: 'cursor-automations',
+    label: 'Automations Documentation',
+    url: 'https://cursor.com/docs/cloud-agent/automations',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'cursor-agent-modes',
+    label: 'Cursor Agent Modes',
+    url: 'https://docs.cursor.com/en/chat/agent',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'cursor-models-docs',
+    label: 'Cursor Models & Auto Selection',
+    url: 'https://docs.cursor.com/models',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'cursor-cli-docs',
+    label: 'Cursor CLI Usage',
+    url: 'https://docs.cursor.com/en/cli/using',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'cursor-bugbot',
+    label: 'BugBot Documentation',
+    url: 'https://cursor.com/docs/bugbot',
+    stalenessThresholdDays: 30,
     verifiedAt: '2026-04-07',
   },
   {
@@ -140,14 +161,38 @@ const PROPAGATION_CHECKLIST = [
       'src/cursor/deep-review.js — update trust class detection',
     ],
   },
-  {
-    trigger: 'Design Mode feature update',
-    targets: [
-      'src/cursor/setup.js — update Design Mode guide template',
-      'src/cursor/techniques.js — update CU-L01 modern features check',
-    ],
-  },
-];
+  {
+    trigger: 'Design Mode feature update',
+    targets: [
+      'src/cursor/setup.js — update Design Mode guide template',
+      'src/cursor/techniques.js — update CU-L01 modern features check',
+    ],
+  },
+  {
+    trigger: 'Cursor mode behavior change (Agent/Ask/Custom, auto-run, auto-fix, tool scopes)',
+    targets: [
+      'src/cursor/techniques.js — update agent-mode and autonomy checks',
+      'src/cursor/governance.js — update mode-related permission caveats',
+      'src/source-urls.js — refresh Cursor mode source mappings',
+    ],
+  },
+  {
+    trigger: 'Cursor model catalog or auto-selection change',
+    targets: [
+      'src/cursor/techniques.js — update model-awareness and cost/trust assumptions',
+      'src/cursor/governance.js — update privacy and model-selection caveats',
+      'src/source-urls.js — refresh Cursor model source mappings',
+    ],
+  },
+  {
+    trigger: 'Cursor CLI behavior change',
+    targets: [
+      'src/cursor/setup.js — update CLI-oriented starter guidance',
+      'src/cursor/techniques.js — update CLI/rules expectations where relevant',
+      'src/source-urls.js — refresh Cursor CLI source mappings',
+    ],
+  },
+];
 
 /**
  * Release gate: check if all P0 sources are within staleness threshold.

package/src/freshness.js

@@ -4,7 +4,8 @@
  * Release gates, recurring probes, propagation checklists,
  * and staleness blocking for Claude Code surfaces.
  *
- * P0 sources from code.claude.com/docs, propagation for CLAUDE.md format changes.
+ * P0 sources from code.claude.com/docs and official Anthropic launch posts,
+ * with propagation for CLAUDE.md, output style, and agent harness changes.
  */
 
 const { version } = require('../package.json');
@@ -55,18 +56,46 @@ const P0_SOURCES = [
     stalenessThresholdDays: 14,
     verifiedAt: '2026-04-07',
   },
-  {
-    key: 'claude-settings-docs',
-    label: 'Claude Code Settings Documentation',
-    url: 'https://code.claude.com/docs/en/settings',
-    stalenessThresholdDays: 30,
-    verifiedAt: '2026-04-07',
-  },
-  {
-    key: 'anthropic-changelog',
-    label: 'Claude Code Changelog',
-    url: 'https://code.claude.com/docs/en/changelog',
-    stalenessThresholdDays: 14,
+  {
+    key: 'claude-settings-docs',
+    label: 'Claude Code Settings Documentation',
+    url: 'https://code.claude.com/docs/en/settings',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'claude-output-styles-docs',
+    label: 'Claude Code Output Styles / Insights',
+    url: 'https://code.claude.com/docs/en/output-styles',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'claude-best-practices-docs',
+    label: 'Claude Code Best Practices / Auto Mode',
+    url: 'https://code.claude.com/docs/en/best-practices',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'claude-agent-sdk-docs',
+    label: 'Claude Agent SDK Overview',
+    url: 'https://code.claude.com/docs/en/agent-sdk/overview',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'claude-xcode-agent-sdk',
+    label: 'Anthropic Xcode Agent SDK Launch',
+    url: 'https://www.anthropic.com/news/apple-xcode-claude-agent-sdk',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'anthropic-changelog',
+    label: 'Claude Code Changelog',
+    url: 'https://code.claude.com/docs/en/changelog',
+    stalenessThresholdDays: 14,
     verifiedAt: '2026-04-07',
   },
 ];
@@ -98,14 +127,38 @@ const PROPAGATION_CHECKLIST = [
       'src/context.js — update mcpConfig parsing',
     ],
   },
-  {
-    trigger: 'Permissions model change (allow/deny lists, operator/user split)',
-    targets: [
-      'src/governance.js — update permissionProfiles',
-      'src/techniques.js — update permission checks',
-    ],
-  },
-];
+  {
+    trigger: 'Permissions model change (allow/deny lists, operator/user split)',
+    targets: [
+      'src/governance.js — update permissionProfiles',
+      'src/techniques.js — update permission checks',
+    ],
+  },
+  {
+    trigger: 'Output style / Insights change (system prompt layering, outputStyle storage, learning mode behavior)',
+    targets: [
+      'src/techniques.js — update Claude settings and instruction-surface checks that depend on system-prompt-adjacent behavior',
+      'src/setup.js — update Claude settings starter templates if outputStyle guidance changes',
+      'src/source-urls.js — refresh Claude feature source mappings when output style docs move or split',
+    ],
+  },
+  {
+    trigger: 'Best-practices or auto mode change (permission classifier, unattended mode, safety fallback behavior)',
+    targets: [
+      'src/governance.js — update permission mode caveats and policy guidance',
+      'src/techniques.js — update Claude trust/verification checks tied to auto mode or unattended workflows',
+      'src/source-urls.js — refresh Claude best-practice source mappings if guidance moves',
+    ],
+  },
+  {
+    trigger: 'Agent SDK / harness or native integration change (SDK surfaces, subagents, background tasks, Xcode bridge)',
+    targets: [
+      'src/techniques.js — update Claude modern-capability checks and cross-surface expectations',
+      'src/mcp-packs.js — revisit pack assumptions when native integrations change MCP usage',
+      'src/source-urls.js — refresh Claude source mappings for SDK and integration surfaces',
+    ],
+  },
+];
 
 /**
  * Release gate: check if all P0 sources are within staleness threshold.

package/src/gemini/freshness.js

@@ -27,18 +27,39 @@ const P0_SOURCES = [
     stalenessThresholdDays: 30,
     verifiedAt: '2026-04-07',
   },
-  {
-    key: 'gemini-md-guide',
-    label: 'GEMINI.md Guide',
-    url: 'https://google-gemini.github.io/gemini-cli/docs/cli/gemini-md.html',
-    stalenessThresholdDays: 30,
-    verifiedAt: '2026-04-07',
-  },
-  {
-    key: 'gemini-hooks-docs',
-    label: 'Gemini Hooks Documentation',
-    url: 'https://google-gemini.github.io/gemini-cli/docs/hooks/',
-    stalenessThresholdDays: 30,
+  {
+    key: 'gemini-md-guide',
+    label: 'GEMINI.md Guide',
+    url: 'https://google-gemini.github.io/gemini-cli/docs/cli/gemini-md.html',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'gemini-trusted-folders-docs',
+    label: 'Gemini Trusted Folders',
+    url: 'https://google-gemini.github.io/gemini-cli/docs/cli/trusted-folders.html',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'gemini-ide-integration-docs',
+    label: 'Gemini IDE Integration',
+    url: 'https://google-gemini.github.io/gemini-cli/docs/ide-integration.html',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'gemini-architecture-docs',
+    label: 'Gemini Architecture Overview',
+    url: 'https://google-gemini.github.io/gemini-cli/docs/architecture.html',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'gemini-hooks-docs',
+    label: 'Gemini Hooks Documentation',
+    url: 'https://google-gemini.github.io/gemini-cli/docs/hooks/',
+    stalenessThresholdDays: 30,
     verifiedAt: '2026-04-07',
   },
   {
@@ -114,15 +135,39 @@ const PROPAGATION_CHECKLIST = [
       'src/gemini/setup.js — update sandbox starter template',
     ],
   },
-  {
-    trigger: 'Policy engine syntax or rule format change',
-    targets: [
-      'src/gemini/techniques.js — update policy validation checks',
-      'src/gemini/governance.js — update policy templates and caveats',
-      'src/gemini/config-parser.js — update policy parsing rules',
-    ],
-  },
-];
+  {
+    trigger: 'Policy engine syntax or rule format change',
+    targets: [
+      'src/gemini/techniques.js — update policy validation checks',
+      'src/gemini/governance.js — update policy templates and caveats',
+      'src/gemini/config-parser.js — update policy parsing rules',
+    ],
+  },
+  {
+    trigger: 'Trusted-folder or safe-mode behavior change',
+    targets: [
+      'src/gemini/techniques.js — update trust/safe-mode checks',
+      'src/gemini/governance.js — update trusted-folder caveats and permission guidance',
+      'src/source-urls.js — refresh Gemini trust source mappings',
+    ],
+  },
+  {
+    trigger: 'IDE integration change (workspace context, diffing, companion extension behavior)',
+    targets: [
+      'src/gemini/techniques.js — update IDE-assist and context-surface checks',
+      'src/gemini/setup.js — update IDE integration starter guidance',
+      'src/source-urls.js — refresh Gemini IDE source mappings',
+    ],
+  },
+  {
+    trigger: 'Architecture or orchestration change (packages/core, tool flow, approval path)',
+    targets: [
+      'src/gemini/context.js — revisit assumptions tied to tool and session orchestration',
+      'src/gemini/techniques.js — update modern-feature and tool-flow checks',
+      'src/source-urls.js — refresh Gemini architecture source mappings',
+    ],
+  },
+];
 
 /**
  * Release gate: check if all P0 sources are within staleness threshold.