@nerviq/cli 1.29.0 → 1.30.0

package/src/aider/context.js

@@ -1,162 +1,162 @@
-/**
- * Aider Project Context
- *
- * Aider is a git-first CLI tool. Key surfaces:
- * - .aider.conf.yml (project-level YAML config)
- * - .aider.model.settings.yml (model role configuration)
- * - .env (API keys, model overrides)
- * - Convention files (passed explicitly via --read or --convention)
- * - .gitignore (must include .aider* artifacts)
- * - Git repo (Aider's ONLY safety mechanism — commits before changes)
- *
- * 4-level config precedence: env vars > CLI args > .aider.conf.yml > defaults
- */
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const { ProjectContext } = require('../context');
-const { tryParseYaml, getValueByKey, parseDotEnv } = require('./config-parser');
-
-let aiderVersionCache = null;
-
-function detectAiderVersion() {
-  if (aiderVersionCache !== null) {
-    return aiderVersionCache;
-  }
-
-  try {
-    const result = spawnSync('aider', ['--version'], { encoding: 'utf8' });
-    const output = `${result.stdout || ''} ${result.stderr || ''}`.trim();
-    const match = output.match(/aider\s+v?([^\s]+)/i);
-    aiderVersionCache = match ? match[1] : (output || null);
-    return aiderVersionCache;
-  } catch {
-    aiderVersionCache = null;
-    return null;
-  }
-}
-
-class AiderProjectContext extends ProjectContext {
-  configContent() {
-    // Aider accepts both .yml and .yaml extensions for the project config
-    return this.fileContent('.aider.conf.yml') || this.fileContent('.aider.conf.yaml');
-  }
-
-  modelSettingsContent() {
-    return this.fileContent('.aider.model.settings.yml');
-  }
-
-  envContent() {
-    return this.fileContent('.env');
-  }
-
-  parsedConfig() {
-    const content = this.configContent();
-    if (!content) {
-      return { ok: false, data: null, error: 'missing .aider.conf.yml', source: '.aider.conf.yml' };
-    }
-    const parsed = tryParseYaml(content);
-    return { ...parsed, source: '.aider.conf.yml' };
-  }
-
-  parsedModelSettings() {
-    const content = this.modelSettingsContent();
-    if (!content) {
-      return { ok: false, data: null, error: 'missing .aider.model.settings.yml', source: '.aider.model.settings.yml' };
-    }
-    const parsed = tryParseYaml(content);
-    return { ...parsed, source: '.aider.model.settings.yml' };
-  }
-
-  parsedEnv() {
-    const content = this.envContent();
-    if (!content) return {};
-    return parseDotEnv(content);
-  }
-
-  configValue(key) {
-    const parsed = this.parsedConfig();
-    if (parsed.ok) {
-      const value = getValueByKey(parsed.data, key);
-      if (value !== undefined) return value;
-    }
-    return undefined;
-  }
-
-  conventionFiles() {
-    // Aider convention files are explicitly listed in config or CLI
-    const readFiles = this.configValue('read') || [];
-    const conventionFiles = Array.isArray(readFiles) ? readFiles : [readFiles];
-
-    // Also check for common convention file names
-    const commonNames = ['CONVENTIONS.md', 'CODING_CONVENTIONS.md', '.aider.conventions.md', 'STYLE.md'];
-    for (const name of commonNames) {
-      if (this.fileContent(name) && !conventionFiles.includes(name)) {
-        conventionFiles.push(name);
-      }
-    }
-
-    return conventionFiles.filter(Boolean);
-  }
-
-  gitignoreContent() {
-    return this.fileContent('.gitignore');
-  }
-
-  hasGitRepo() {
-    try {
-      return fs.existsSync(path.join(this.dir, '.git'));
-    } catch {
-      return false;
-    }
-  }
-
-  gitStatus() {
-    try {
-      const result = spawnSync('git', ['status', '--porcelain'], {
-        cwd: this.dir,
-        encoding: 'utf8',
-      });
-      return (result.stdout || '').trim();
-    } catch {
-      return null;
-    }
-  }
-
-  workflowFiles() {
-    return this.dirFiles('.github/workflows')
-      .filter(file => /\.ya?ml$/i.test(file))
-      .map(file => path.join('.github', 'workflows', file).replace(/\\/g, '/'));
-  }
-
-  /** Aider model roles: main (coding), editor (applying), weak (commit messages) */
-  modelRoles() {
-    const config = this.parsedConfig();
-    const data = config.ok ? config.data : {};
-    return {
-      main: data.model || data['main-model'] || null,
-      editor: data['editor-model'] || null,
-      weak: data['weak-model'] || null,
-      architect: data.architect || false,
-    };
-  }
-
-  static isAiderRepo(dir) {
-    try {
-      return fs.existsSync(path.join(dir, '.aider.conf.yml')) ||
-        fs.existsSync(path.join(dir, '.aider.conf.yaml')) ||
-        fs.existsSync(path.join(dir, '.aider.model.settings.yml')) ||
-        fs.existsSync(path.join(dir, '.aider.model.settings.yaml')) ||
-        fs.existsSync(path.join(dir, '.aider.tags.cache.v3')) ||
-        fs.existsSync(path.join(dir, '.aiderignore'));
-    } catch {
-      return false;
-    }
-  }
-}
-
-module.exports = {
-  AiderProjectContext,
-  detectAiderVersion,
-};
+/**
+ * Aider Project Context
+ *
+ * Aider is a git-first CLI tool. Key surfaces:
+ * - .aider.conf.yml (project-level YAML config)
+ * - .aider.model.settings.yml (model role configuration)
+ * - .env (API keys, model overrides)
+ * - Convention files (passed explicitly via --read or --convention)
+ * - .gitignore (must include .aider* artifacts)
+ * - Git repo (Aider's ONLY safety mechanism — commits before changes)
+ *
+ * 4-level config precedence: env vars > CLI args > .aider.conf.yml > defaults
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { ProjectContext } = require('../context');
+const { tryParseYaml, getValueByKey, parseDotEnv } = require('./config-parser');
+
+let aiderVersionCache = null;
+
+function detectAiderVersion() {
+  if (aiderVersionCache !== null) {
+    return aiderVersionCache;
+  }
+
+  try {
+    const result = spawnSync('aider', ['--version'], { encoding: 'utf8' });
+    const output = `${result.stdout || ''} ${result.stderr || ''}`.trim();
+    const match = output.match(/aider\s+v?([^\s]+)/i);
+    aiderVersionCache = match ? match[1] : (output || null);
+    return aiderVersionCache;
+  } catch {
+    aiderVersionCache = null;
+    return null;
+  }
+}
+
+class AiderProjectContext extends ProjectContext {
+  configContent() {
+    // Aider accepts both .yml and .yaml extensions for the project config
+    return this.fileContent('.aider.conf.yml') || this.fileContent('.aider.conf.yaml');
+  }
+
+  modelSettingsContent() {
+    return this.fileContent('.aider.model.settings.yml');
+  }
+
+  envContent() {
+    return this.fileContent('.env');
+  }
+
+  parsedConfig() {
+    const content = this.configContent();
+    if (!content) {
+      return { ok: false, data: null, error: 'missing .aider.conf.yml', source: '.aider.conf.yml' };
+    }
+    const parsed = tryParseYaml(content);
+    return { ...parsed, source: '.aider.conf.yml' };
+  }
+
+  parsedModelSettings() {
+    const content = this.modelSettingsContent();
+    if (!content) {
+      return { ok: false, data: null, error: 'missing .aider.model.settings.yml', source: '.aider.model.settings.yml' };
+    }
+    const parsed = tryParseYaml(content);
+    return { ...parsed, source: '.aider.model.settings.yml' };
+  }
+
+  parsedEnv() {
+    const content = this.envContent();
+    if (!content) return {};
+    return parseDotEnv(content);
+  }
+
+  configValue(key) {
+    const parsed = this.parsedConfig();
+    if (parsed.ok) {
+      const value = getValueByKey(parsed.data, key);
+      if (value !== undefined) return value;
+    }
+    return undefined;
+  }
+
+  conventionFiles() {
+    // Aider convention files are explicitly listed in config or CLI
+    const readFiles = this.configValue('read') || [];
+    const conventionFiles = Array.isArray(readFiles) ? readFiles : [readFiles];
+
+    // Also check for common convention file names
+    const commonNames = ['CONVENTIONS.md', 'CODING_CONVENTIONS.md', '.aider.conventions.md', 'STYLE.md'];
+    for (const name of commonNames) {
+      if (this.fileContent(name) && !conventionFiles.includes(name)) {
+        conventionFiles.push(name);
+      }
+    }
+
+    return conventionFiles.filter(Boolean);
+  }
+
+  gitignoreContent() {
+    return this.fileContent('.gitignore');
+  }
+
+  hasGitRepo() {
+    try {
+      return fs.existsSync(path.join(this.dir, '.git'));
+    } catch {
+      return false;
+    }
+  }
+
+  gitStatus() {
+    try {
+      const result = spawnSync('git', ['status', '--porcelain'], {
+        cwd: this.dir,
+        encoding: 'utf8',
+      });
+      return (result.stdout || '').trim();
+    } catch {
+      return null;
+    }
+  }
+
+  workflowFiles() {
+    return this.dirFiles('.github/workflows')
+      .filter(file => /\.ya?ml$/i.test(file))
+      .map(file => path.join('.github', 'workflows', file).replace(/\\/g, '/'));
+  }
+
+  /** Aider model roles: main (coding), editor (applying), weak (commit messages) */
+  modelRoles() {
+    const config = this.parsedConfig();
+    const data = config.ok ? config.data : {};
+    return {
+      main: data.model || data['main-model'] || null,
+      editor: data['editor-model'] || null,
+      weak: data['weak-model'] || null,
+      architect: data.architect || false,
+    };
+  }
+
+  static isAiderRepo(dir) {
+    try {
+      return fs.existsSync(path.join(dir, '.aider.conf.yml')) ||
+        fs.existsSync(path.join(dir, '.aider.conf.yaml')) ||
+        fs.existsSync(path.join(dir, '.aider.model.settings.yml')) ||
+        fs.existsSync(path.join(dir, '.aider.model.settings.yaml')) ||
+        fs.existsSync(path.join(dir, '.aider.tags.cache.v3')) ||
+        fs.existsSync(path.join(dir, '.aiderignore'));
+    } catch {
+      return false;
+    }
+  }
+}
+
+module.exports = {
+  AiderProjectContext,
+  detectAiderVersion,
+};

package/src/aider/freshness.js

@@ -1,37 +1,37 @@
-/**
- * Aider Freshness Operationalization
- *
- * Release gates, recurring probes, propagation checklists,
- * and staleness blocking for Aider surfaces.
- */
-
-const { version } = require('../../package.json');
-
-/**
- * P0 sources that must be fresh before any Aider release claim.
- */
-const P0_SOURCES = [
-  {
-    key: 'aider-docs',
-    label: 'Aider Official Docs',
-    url: 'https://aider.chat',
-    stalenessThresholdDays: 30,
-    verifiedAt: '2026-04-08',
-  },
-  {
-    key: 'aider-config-reference',
-    label: 'Aider Config Reference',
-    url: 'https://aider.chat/docs/config/aider_conf.html',
-    stalenessThresholdDays: 30,
-    verifiedAt: '2026-04-08',
-  },
-  {
-    key: 'aider-github-releases',
-    label: 'Aider GitHub Releases',
-    url: 'https://github.com/Aider-AI/aider/releases',
-    stalenessThresholdDays: 14,
-    verifiedAt: '2026-04-08',
-  },
+/**
+ * Aider Freshness Operationalization
+ *
+ * Release gates, recurring probes, propagation checklists,
+ * and staleness blocking for Aider surfaces.
+ */
+
+const { version } = require('../../package.json');
+
+/**
+ * P0 sources that must be fresh before any Aider release claim.
+ */
+const P0_SOURCES = [
+  {
+    key: 'aider-docs',
+    label: 'Aider Official Docs',
+    url: 'https://aider.chat',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-08',
+  },
+  {
+    key: 'aider-config-reference',
+    label: 'Aider Config Reference',
+    url: 'https://aider.chat/docs/config/aider_conf.html',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-08',
+  },
+  {
+    key: 'aider-github-releases',
+    label: 'Aider GitHub Releases',
+    url: 'https://github.com/Aider-AI/aider/releases',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-08',
+  },
   {
     key: 'aider-model-docs',
     label: 'Aider Model Documentation',
@@ -65,45 +65,45 @@ const P0_SOURCES = [
     label: 'Aider PyPI Package',
     url: 'https://pypi.org/project/aider-chat/',
     stalenessThresholdDays: 14,
-    verifiedAt: '2026-04-08',
-  },
-];
-
-/**
- * Propagation checklist: when an Aider source changes, these must update.
- */
-const PROPAGATION_CHECKLIST = [
-  {
-    trigger: 'Aider release with new config keys',
-    targets: [
-      'src/aider/techniques.js — update checks for new keys',
-      'src/aider/config-parser.js — update if YAML handling changes',
-      'src/aider/setup.js — update generated .aider.conf.yml template',
-    ],
-  },
-  {
-    trigger: 'New Aider model support or role changes',
-    targets: [
-      'src/aider/techniques.js — update model config checks',
-      'src/aider/context.js — update modelRoles()',
-      'src/aider/governance.js — update policy packs if needed',
-    ],
-  },
-  {
-    trigger: 'New Aider edit format or architect changes',
-    targets: [
-      'src/aider/techniques.js — update edit format checks',
-      'src/aider/setup.js — update template comments',
-    ],
-  },
-  {
-    trigger: 'Aider CLI flag changes (renamed/removed)',
-    targets: [
-      'src/aider/techniques.js — update flag pattern matching',
-      'src/aider/setup.js — update generated config',
-      'src/aider/interactive.js — update wizard options',
-    ],
-  },
+    verifiedAt: '2026-04-08',
+  },
+];
+
+/**
+ * Propagation checklist: when an Aider source changes, these must update.
+ */
+const PROPAGATION_CHECKLIST = [
+  {
+    trigger: 'Aider release with new config keys',
+    targets: [
+      'src/aider/techniques.js — update checks for new keys',
+      'src/aider/config-parser.js — update if YAML handling changes',
+      'src/aider/setup.js — update generated .aider.conf.yml template',
+    ],
+  },
+  {
+    trigger: 'New Aider model support or role changes',
+    targets: [
+      'src/aider/techniques.js — update model config checks',
+      'src/aider/context.js — update modelRoles()',
+      'src/aider/governance.js — update policy packs if needed',
+    ],
+  },
+  {
+    trigger: 'New Aider edit format or architect changes',
+    targets: [
+      'src/aider/techniques.js — update edit format checks',
+      'src/aider/setup.js — update template comments',
+    ],
+  },
+  {
+    trigger: 'Aider CLI flag changes (renamed/removed)',
+    targets: [
+      'src/aider/techniques.js — update flag pattern matching',
+      'src/aider/setup.js — update generated config',
+      'src/aider/interactive.js — update wizard options',
+    ],
+  },
   {
     trigger: 'Aider domain pack definitions change',
     targets: [
@@ -136,29 +136,29 @@ const PROPAGATION_CHECKLIST = [
     ],
   },
 ];
-
-/**
+
+/**
  * Check release gate — are all P0 sources fresh?
  */
 function checkReleaseGate(overrides = {}) {
   const now = new Date();
   const results = P0_SOURCES.map(source => {
-    const verifiedAt = overrides[source.key] || source.verifiedAt;
-    if (!verifiedAt) {
-      return { ...source, status: 'unverified', daysStale: null };
-    }
-
-    const verifiedDate = new Date(verifiedAt);
-    const daysSince = Math.floor((now - verifiedDate) / (1000 * 60 * 60 * 24));
-
-    return {
-      ...source,
-      verifiedAt,
-      status: daysSince <= source.stalenessThresholdDays ? 'fresh' : 'stale',
-      daysStale: daysSince,
-    };
-  });
-
+    const verifiedAt = overrides[source.key] || source.verifiedAt;
+    if (!verifiedAt) {
+      return { ...source, status: 'unverified', daysStale: null };
+    }
+
+    const verifiedDate = new Date(verifiedAt);
+    const daysSince = Math.floor((now - verifiedDate) / (1000 * 60 * 60 * 24));
+
+    return {
+      ...source,
+      verifiedAt,
+      status: daysSince <= source.stalenessThresholdDays ? 'fresh' : 'stale',
+      daysStale: daysSince,
+    };
+  });
+
   const stale = results.filter((result) => result.status === 'stale' || result.status === 'unverified');
   const fresh = results.filter((result) => result.status === 'fresh');
   const allFresh = stale.length === 0;
@@ -182,35 +182,35 @@ function formatReleaseGate(gateResult) {
     `Status: ${gateResult.ready ? 'READY' : 'NOT READY'}`,
     '',
   ];
-
-  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 propagation targets 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,
-};
+
+  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 propagation targets 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,
+};