sigmap 7.14.0 → 7.15.0

package/CHANGELOG.md

@@ -10,6 +10,15 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [7.15.0] — 2026-06-18
+
+Minor release — `sigmap conventions --ci` (grounded codegen, Layer 3 polish).
+
+### Added
+- **`sigmap conventions --ci` — gate CI on convention consistency (#322):** completes the consistency-tracking story started by `--report` (v7.14.0). A CI gate that fails when a repo's overall convention consistency falls below a threshold (`--min`, default 0.70), and — with `--no-regress` — also fails when the score dropped vs the last recorded snapshot (best-effort). New zero-dependency, bundle-safe `src/conventions/ci.js` (`ciGate`) reuses `overallScore`; the command is read-only (reads the last `.context/conventions-history.ndjson` snapshot for `--no-regress`, never appends) and exits non-zero on failure, so it drops straight into CI. `--json` for machine output. The remaining `conventions` flags (`--fix`, `--update`) and the §9 LLM A/B benchmark are follow-ups.
+
+---
+
 ## [7.14.0] — 2026-06-17
 
 Minor release — `sigmap conventions --report` (grounded codegen, Layer 3 polish).

package/gen-context.js

@@ -30,6 +30,58 @@ function __require(key) {
 // ── ./src/review/review-pr ──
 // ── ./src/create/orchestrate ──
 // ── ./src/conventions/report ──
+// ── ./src/conventions/ci ──
+__factories["./src/conventions/ci"] = function(module, exports) {
+  
+  /**
+   * Convention CI gate (IMPL.md §4 — `conventions --ci`).
+   *
+   * Fails CI when a repo's overall convention consistency is below a threshold,
+   * and optionally when it regresses vs the last recorded run. Builds on the
+   * `--report` score. Pure, zero-dependency, bundle-safe.
+   */
+
+  const { overallScore } = __require('./src/conventions/report');
+
+  const DEFAULT_MIN = 0.7;
+  const EPS = 1e-9;
+
+  /**
+   * Evaluate the consistency gate.
+   * @param {object} result an `extractConventions` result
+   * @param {object} [opts]
+   * @param {number} [opts.min=0.7] minimum overall consistency (0–1)
+   * @param {boolean} [opts.noRegress=false] also fail if the score dropped vs prior
+   * @param {object|null} [prior] the previous snapshot (from `report.snapshot`)
+   * @returns {{ score:number, min:number, ok:boolean, regressed:boolean, reasons:string[] }}
+   */
+  function ciGate(result, opts = {}, prior = null) {
+    const min = opts.min != null ? opts.min : DEFAULT_MIN;
+    const score = overallScore(result);
+    const reasons = [];
+    let ok = true;
+
+    if (score < min) {
+      ok = false;
+      reasons.push(`consistency ${(score * 100).toFixed(0)}% below min ${(min * 100).toFixed(0)}%`);
+    }
+
+    let regressed = false;
+    if (opts.noRegress && prior && typeof prior.score === 'number') {
+      if (score < prior.score - EPS) {
+        regressed = true;
+        ok = false;
+        reasons.push(`consistency dropped ${(prior.score * 100).toFixed(0)}% → ${(score * 100).toFixed(0)}%`);
+      }
+    }
+
+    return { score, min, ok, regressed, reasons };
+  }
+
+  module.exports = { ciGate, DEFAULT_MIN };
+  
+};
+
 __factories["./src/conventions/report"] = function(module, exports) {
   
   /**
@@ -7538,7 +7590,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
 
   const SERVER_INFO = {
     name: 'sigmap',
-    version: '7.14.0',
+    version: '7.15.0',
     description: 'SigMap MCP server — code signatures on demand',
   };
 
@@ -13216,7 +13268,7 @@ function __tryGit(args, opts = {}) {
   catch (_) { return ''; }
 }
 
-const VERSION = '7.14.0';
+const VERSION = '7.15.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -16411,6 +16463,34 @@ function main() {
       process.exit(0);
     }
 
+    // `--ci`: gate — fail when overall consistency is below a threshold (or regresses).
+    if (args.includes('--ci')) {
+      const { ciGate } = requireSourceOrBundled('./src/conventions/ci');
+      const minIdx = args.indexOf('--min');
+      const min = minIdx !== -1 && args[minIdx + 1] ? parseFloat(args[minIdx + 1]) : undefined;
+      const noRegress = args.includes('--no-regress');
+      let prior = null;
+      if (noRegress) {
+        try {
+          const lines = fs.readFileSync(path.join(cwd, '.context', 'conventions-history.ndjson'), 'utf8').split('\n').filter(Boolean);
+          if (lines.length) prior = JSON.parse(lines[lines.length - 1]);
+        } catch (_) {}
+      }
+      const gate = ciGate(result, { min, noRegress }, prior);
+      if (jsonOut) {
+        process.stdout.write(JSON.stringify(gate) + '\n');
+        process.exit(gate.ok ? 0 : 1);
+      }
+      const pctC = (n) => `${(n * 100).toFixed(0)}%`;
+      if (gate.ok) {
+        console.log(`[sigmap] conventions --ci  ✓ PASS — consistency ${pctC(gate.score)} (min ${pctC(gate.min)})`);
+        process.exit(0);
+      }
+      console.log(`[sigmap] conventions --ci  ✗ FAIL — consistency ${pctC(gate.score)} (min ${pctC(gate.min)})`);
+      for (const r of gate.reasons) console.log(`  • ${r}`);
+      process.exit(1);
+    }
+
     // `--report`: consistency audit + score + trend vs the last run.
     if (args.includes('--report')) {
       const { scoreReport, snapshot } = requireSourceOrBundled('./src/conventions/report');

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.14.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
+# Version: 7.15.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.14.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
+# Version: 7.15.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.14.0",
+  "version": "7.15.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.14.0",
+  "version": "7.15.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.14.0",
+  "version": "7.15.0",
   "description": "SigMap core library — zero-dependency code signature extraction, retrieval, and security scanning",
   "main": "index.js",
   "keywords": [

package/src/conventions/ci.js

@@ -0,0 +1,48 @@
+'use strict';
+
+/**
+ * Convention CI gate (IMPL.md §4 — `conventions --ci`).
+ *
+ * Fails CI when a repo's overall convention consistency is below a threshold,
+ * and optionally when it regresses vs the last recorded run. Builds on the
+ * `--report` score. Pure, zero-dependency, bundle-safe.
+ */
+
+const { overallScore } = require('./report');
+
+const DEFAULT_MIN = 0.7;
+const EPS = 1e-9;
+
+/**
+ * Evaluate the consistency gate.
+ * @param {object} result an `extractConventions` result
+ * @param {object} [opts]
+ * @param {number} [opts.min=0.7] minimum overall consistency (0–1)
+ * @param {boolean} [opts.noRegress=false] also fail if the score dropped vs prior
+ * @param {object|null} [prior] the previous snapshot (from `report.snapshot`)
+ * @returns {{ score:number, min:number, ok:boolean, regressed:boolean, reasons:string[] }}
+ */
+function ciGate(result, opts = {}, prior = null) {
+  const min = opts.min != null ? opts.min : DEFAULT_MIN;
+  const score = overallScore(result);
+  const reasons = [];
+  let ok = true;
+
+  if (score < min) {
+    ok = false;
+    reasons.push(`consistency ${(score * 100).toFixed(0)}% below min ${(min * 100).toFixed(0)}%`);
+  }
+
+  let regressed = false;
+  if (opts.noRegress && prior && typeof prior.score === 'number') {
+    if (score < prior.score - EPS) {
+      regressed = true;
+      ok = false;
+      reasons.push(`consistency dropped ${(prior.score * 100).toFixed(0)}% → ${(score * 100).toFixed(0)}%`);
+    }
+  }
+
+  return { score, min, ok, regressed, reasons };
+}
+
+module.exports = { ciGate, DEFAULT_MIN };

package/src/mcp/server.js

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