sigmap 7.17.0 → 7.18.0

package/CHANGELOG.md

@@ -10,6 +10,15 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [7.18.0] — 2026-06-18
+
+Minor release — `sigmap conventions --update` (grounded codegen, Layer 3 — completes the §4 flag set).
+
+### Added
+- **`sigmap conventions --update` — incremental rescan (#331):** refreshes `.context/conventions.json` only when source files have changed since the last scan; otherwise reports "up to date" and exits without recomputing. New zero-dependency, bundle-safe `src/conventions/update.js` (`changedSince`, `planUpdate`) compares source-file mtimes to the stored snapshot — `stale` when the snapshot is missing or any file is newer. The command re-extracts + rewrites when stale (reporting the changed count / "initial scan"), else skips the work. `--json` for machine output. This completes the IMPL §4 `conventions` flag set: `--conflicts`, `--inject`, `--report`, `--ci`, `--fix`, `--update`.
+
+---
+
 ## [7.17.0] — 2026-06-18
 
 Minor release — `sigmap conventions --fix` (grounded codegen, Layer 3 — completes the conventions flags).

package/gen-context.js

@@ -33,6 +33,56 @@ function __require(key) {
 // ── ./src/conventions/ci ──
 // ── ./src/eval/llm-ablation ──
 // ── ./src/conventions/fix ──
+// ── ./src/conventions/update ──
+__factories["./src/conventions/update"] = function(module, exports) {
+  
+  /**
+   * Convention incremental rescan (IMPL.md §4 — `conventions --update`).
+   *
+   * Avoids recomputing the conventions snapshot when nothing changed: compare the
+   * source files' mtimes to the stored `.context/conventions.json` and only flag a
+   * rescan when the snapshot is missing or some file is newer. Pure (fs reads
+   * only), zero-dependency, bundle-safe.
+   */
+
+  const fs = require('fs');
+
+  /**
+   * Source files modified after a reference time.
+   * @param {string[]} files absolute paths
+   * @param {number} sinceMs epoch ms threshold
+   * @returns {string[]}
+   */
+  function changedSince(files, sinceMs) {
+    const out = [];
+    for (const f of files || []) {
+      try { if (fs.statSync(f).mtimeMs > sinceMs) out.push(f); } catch (_) {}
+    }
+    return out;
+  }
+
+  /**
+   * Decide whether the conventions snapshot needs a rescan.
+   * @param {string} cwd repo root (unused but kept for signature symmetry)
+   * @param {string[]} files absolute source paths
+   * @param {string} snapshotPath path to the stored conventions.json
+   * @returns {{ snapshotExists: boolean, stale: boolean, changed: string[] }}
+   */
+  function planUpdate(cwd, files, snapshotPath) {
+    let snapshotMs = null;
+    try { snapshotMs = fs.statSync(snapshotPath).mtimeMs; } catch (_) {}
+    const snapshotExists = snapshotMs != null;
+    if (!snapshotExists) {
+      return { snapshotExists: false, stale: true, changed: [] };
+    }
+    const changed = changedSince(files, snapshotMs);
+    return { snapshotExists: true, stale: changed.length > 0, changed };
+  }
+
+  module.exports = { changedSince, planUpdate };
+  
+};
+
 __factories["./src/conventions/fix"] = function(module, exports) {
   
   /**
@@ -7769,7 +7819,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
 
   const SERVER_INFO = {
     name: 'sigmap',
-    version: '7.17.0',
+    version: '7.18.0',
     description: 'SigMap MCP server — code signatures on demand',
   };
 
@@ -13447,7 +13497,7 @@ function __tryGit(args, opts = {}) {
   catch (_) { return ''; }
 }
 
-const VERSION = '7.17.0';
+const VERSION = '7.18.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -16642,6 +16692,37 @@ function main() {
       process.exit(0);
     }
 
+    // `--update`: incremental rescan — refresh .context/conventions.json only when stale.
+    if (args.includes('--update')) {
+      const { planUpdate } = requireSourceOrBundled('./src/conventions/update');
+      const outDir = path.join(cwd, '.context');
+      const outPath = path.join(outDir, 'conventions.json');
+      const plan = planUpdate(cwd, files, outPath);
+      let wrote = false;
+      if (plan.stale) {
+        try {
+          fs.mkdirSync(outDir, { recursive: true });
+          fs.writeFileSync(outPath, JSON.stringify(result, null, 2) + '\n');
+          wrote = true;
+        } catch (e) {
+          console.error(`[sigmap] cannot write ${outPath}: ${e.message}`);
+          process.exit(1);
+        }
+      }
+      const payload = { stale: plan.stale, wrote, snapshotExists: plan.snapshotExists, changed: plan.changed.length, scanned: result.scannedFiles };
+      if (jsonOut) {
+        process.stdout.write(JSON.stringify(payload) + '\n');
+        process.exit(0);
+      }
+      if (!plan.stale) {
+        console.log(`[sigmap] conventions --update  ✓ up to date — ${result.scannedFiles} files, no changes since last scan`);
+        process.exit(0);
+      }
+      const how = plan.snapshotExists ? `${plan.changed.length} changed file${plan.changed.length === 1 ? '' : 's'}` : 'initial scan';
+      console.log(`[sigmap] conventions --update  rescanned (${how}) → wrote ${path.relative(cwd, outPath)}`);
+      process.exit(0);
+    }
+
     // `--fix`: exhaustive rename checklist — every file not matching the dominant style.
     if (args.includes('--fix')) {
       const { buildFixList } = requireSourceOrBundled('./src/conventions/fix');

package/llms-full.txt

@@ -9,7 +9,7 @@ the files relevant to the task — cutting tokens ~97% while keeping answers
 grounded. Deterministic, offline, no embeddings or vector database. Works with
 Claude, Cursor, GitHub Copilot, Aider, Windsurf, local LLMs, and MCP.
 
-# Version: 7.17.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
+# Version: 7.18.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
 # Source: auto-generated from package.json, version.json, src/mcp/tools.js, src/config/defaults.js
 # Regenerate: npm run generate:llms   |   Validate: npm run validate:llms
 

package/llms.txt

@@ -9,7 +9,7 @@ the files relevant to the task — cutting tokens ~97% while keeping answers
 grounded. Deterministic, offline, no embeddings or vector database. Works with
 Claude, Cursor, GitHub Copilot, Aider, Windsurf, local LLMs, and MCP.
 
-# Version: 7.17.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
+# Version: 7.18.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
 # Source: auto-generated from package.json, version.json, src/mcp/tools.js, src/config/defaults.js
 # Regenerate: npm run generate:llms   |   Validate: npm run validate:llms
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap",
-  "version": "7.17.0",
+  "version": "7.18.0",
   "description": "97% token reduction for AI coding. Extracts function & class signatures with TF-IDF ranking to feed only the right files to Claude, Cursor, Copilot, Aider, Windsurf, local LLMs & MCP. Zero dependencies, runs offline via npx.",
   "main": "packages/core/index.js",
   "exports": {

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-cli",
-  "version": "7.17.0",
+  "version": "7.18.0",
   "description": "SigMap CLI wrapper — thin adapter for programmatic CLI invocation",
   "main": "index.js",
   "keywords": [

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-core",
-  "version": "7.17.0",
+  "version": "7.18.0",
   "description": "SigMap core library — zero-dependency code signature extraction, retrieval, and security scanning",
   "main": "index.js",
   "keywords": [

package/src/conventions/update.js

@@ -0,0 +1,46 @@
+'use strict';
+
+/**
+ * Convention incremental rescan (IMPL.md §4 — `conventions --update`).
+ *
+ * Avoids recomputing the conventions snapshot when nothing changed: compare the
+ * source files' mtimes to the stored `.context/conventions.json` and only flag a
+ * rescan when the snapshot is missing or some file is newer. Pure (fs reads
+ * only), zero-dependency, bundle-safe.
+ */
+
+const fs = require('fs');
+
+/**
+ * Source files modified after a reference time.
+ * @param {string[]} files absolute paths
+ * @param {number} sinceMs epoch ms threshold
+ * @returns {string[]}
+ */
+function changedSince(files, sinceMs) {
+  const out = [];
+  for (const f of files || []) {
+    try { if (fs.statSync(f).mtimeMs > sinceMs) out.push(f); } catch (_) {}
+  }
+  return out;
+}
+
+/**
+ * Decide whether the conventions snapshot needs a rescan.
+ * @param {string} cwd repo root (unused but kept for signature symmetry)
+ * @param {string[]} files absolute source paths
+ * @param {string} snapshotPath path to the stored conventions.json
+ * @returns {{ snapshotExists: boolean, stale: boolean, changed: string[] }}
+ */
+function planUpdate(cwd, files, snapshotPath) {
+  let snapshotMs = null;
+  try { snapshotMs = fs.statSync(snapshotPath).mtimeMs; } catch (_) {}
+  const snapshotExists = snapshotMs != null;
+  if (!snapshotExists) {
+    return { snapshotExists: false, stale: true, changed: [] };
+  }
+  const changed = changedSince(files, snapshotMs);
+  return { snapshotExists: true, stale: changed.length > 0, changed };
+}
+
+module.exports = { changedSince, planUpdate };

package/src/mcp/server.js

@@ -18,7 +18,7 @@ const { readContext, searchSignatures, getMap, createCheckpoint, getRouting, exp
 
 const SERVER_INFO = {
   name: 'sigmap',
-  version: '7.17.0',
+  version: '7.18.0',
   description: 'SigMap MCP server — code signatures on demand',
 };