sigmap 7.16.0 → 7.17.0

package/CHANGELOG.md

@@ -10,6 +10,15 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [7.17.0] — 2026-06-18
+
+Minor release — `sigmap conventions --fix` (grounded codegen, Layer 3 — completes the conventions flags).
+
+### Added
+- **`sigmap conventions --fix` — exhaustive rename/move checklist (#328):** the complete, actionable list of every source file whose name doesn't match the dominant convention, with full from→to paths, ready to paste into a task or PR. Distinct from `--conflicts` (a diagnostic summary with up to 3 example basenames) — `--fix` lists *every* offending file with its real path. New zero-dependency, bundle-safe `src/conventions/fix.js` (`buildFixList`) reuses `classifyNaming` + `toNamingStyle`; the command prints a checkbox checklist + count (or "no fixes needed") and is read-only (it never performs renames). `--json` for machine output. This completes the `conventions` flag set (`--conflicts`, `--inject`, `--report`, `--ci`, `--fix`).
+
+---
+
 ## [7.16.0] — 2026-06-18
 
 Minor release — LLM A/B hallucination ablation harness (grounded codegen, IMPL §9).

package/gen-context.js

@@ -32,6 +32,68 @@ function __require(key) {
 // ── ./src/conventions/report ──
 // ── ./src/conventions/ci ──
 // ── ./src/eval/llm-ablation ──
+// ── ./src/conventions/fix ──
+__factories["./src/conventions/fix"] = function(module, exports) {
+  
+  /**
+   * Convention fix list (IMPL.md §4 — `conventions --fix`).
+   *
+   * The complete, actionable rename checklist: every scoped source file whose
+   * name doesn't match the dominant file-naming convention, with full from→to
+   * paths. Distinct from `--conflicts` (a diagnostic summary with up to 3 example
+   * basenames) — `--fix` lists *every* offending file with its real path, ready
+   * to paste into a task or PR. Pure, zero-dependency, bundle-safe.
+   */
+
+  const path = require('path');
+  const { classifyNaming } = __require('./src/conventions/extract');
+  const { toNamingStyle } = __require('./src/conventions/conflicts');
+
+  const JS_TS_EXTS = new Set(['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs']);
+  const PY_EXTS = new Set(['.py']);
+  const SCOPED_EXTS = new Set([...JS_TS_EXTS, ...PY_EXTS]);
+
+  const TEST_RE = /\.(test|spec)\.[jt]sx?$|(^|\/)test_|_test\.py$/;
+
+  /** Rename a file path's basename to the target naming style (keep dir + ext). */
+  function _renamePath(relPath, style) {
+    const dir = relPath.includes('/') ? relPath.slice(0, relPath.lastIndexOf('/') + 1) : '';
+    const base = relPath.includes('/') ? relPath.slice(relPath.lastIndexOf('/') + 1) : relPath;
+    const dot = base.indexOf('.');
+    const stem = dot > 0 ? base.slice(0, dot) : base;
+    const ext = dot > 0 ? base.slice(dot) : '';
+    return `${dir}${toNamingStyle(stem, style)}${ext}`;
+  }
+
+  /**
+   * Build the exhaustive rename checklist for the dominant file-naming convention.
+   * @param {string} cwd repo root (for relative paths)
+   * @param {string[]} files absolute source paths (e.g. from buildFileList)
+   * @param {object} conventions an `extractConventions` result (for the dominant style)
+   * @returns {{ dominant: string|null, renames: Array<{from:string,to:string,fromStyle:string}>, count: number }}
+   */
+  function buildFixList(cwd, files, conventions) {
+    const dominant = conventions && conventions.fileNaming && conventions.fileNaming.dominant;
+    if (!dominant) return { dominant: null, renames: [], count: 0 };
+
+    const renames = [];
+    for (const f of files || []) {
+      if (!SCOPED_EXTS.has(path.extname(f).toLowerCase())) continue;
+      if (TEST_RE.test(f)) continue;
+      const base = path.basename(f);
+      const style = classifyNaming(base);
+      if (style === 'other' || style === dominant) continue;
+      const rel = path.relative(cwd, f).replace(/\\/g, '/');
+      renames.push({ from: rel, to: _renamePath(rel, dominant), fromStyle: style });
+    }
+    renames.sort((a, b) => a.from.localeCompare(b.from));
+    return { dominant, renames, count: renames.length };
+  }
+
+  module.exports = { buildFixList };
+  
+};
+
 __factories["./src/eval/llm-ablation"] = function(module, exports) {
   
   /**
@@ -7707,7 +7769,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
 
   const SERVER_INFO = {
     name: 'sigmap',
-    version: '7.16.0',
+    version: '7.17.0',
     description: 'SigMap MCP server — code signatures on demand',
   };
 
@@ -13385,7 +13447,7 @@ function __tryGit(args, opts = {}) {
   catch (_) { return ''; }
 }
 
-const VERSION = '7.16.0';
+const VERSION = '7.17.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -16580,6 +16642,28 @@ function main() {
       process.exit(0);
     }
 
+    // `--fix`: exhaustive rename checklist — every file not matching the dominant style.
+    if (args.includes('--fix')) {
+      const { buildFixList } = requireSourceOrBundled('./src/conventions/fix');
+      const fixList = buildFixList(cwd, files, result);
+      if (jsonOut) {
+        process.stdout.write(JSON.stringify(fixList) + '\n');
+        process.exit(0);
+      }
+      console.log('[sigmap] conventions --fix  (TS/JS/Python)');
+      if (!fixList.dominant) {
+        console.log('  no dominant file-naming convention — nothing to fix');
+        process.exit(0);
+      }
+      if (fixList.count === 0) {
+        console.log(`  ✓ no fixes needed — every file matches ${fixList.dominant}`);
+        process.exit(0);
+      }
+      console.log(`  ${fixList.count} file${fixList.count === 1 ? '' : 's'} to rename to ${fixList.dominant}:`);
+      for (const r of fixList.renames) console.log(`  - [ ] ${r.from}  →  ${r.to}`);
+      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');

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

package/src/conventions/fix.js

@@ -0,0 +1,58 @@
+'use strict';
+
+/**
+ * Convention fix list (IMPL.md §4 — `conventions --fix`).
+ *
+ * The complete, actionable rename checklist: every scoped source file whose
+ * name doesn't match the dominant file-naming convention, with full from→to
+ * paths. Distinct from `--conflicts` (a diagnostic summary with up to 3 example
+ * basenames) — `--fix` lists *every* offending file with its real path, ready
+ * to paste into a task or PR. Pure, zero-dependency, bundle-safe.
+ */
+
+const path = require('path');
+const { classifyNaming } = require('./extract');
+const { toNamingStyle } = require('./conflicts');
+
+const JS_TS_EXTS = new Set(['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs']);
+const PY_EXTS = new Set(['.py']);
+const SCOPED_EXTS = new Set([...JS_TS_EXTS, ...PY_EXTS]);
+
+const TEST_RE = /\.(test|spec)\.[jt]sx?$|(^|\/)test_|_test\.py$/;
+
+/** Rename a file path's basename to the target naming style (keep dir + ext). */
+function _renamePath(relPath, style) {
+  const dir = relPath.includes('/') ? relPath.slice(0, relPath.lastIndexOf('/') + 1) : '';
+  const base = relPath.includes('/') ? relPath.slice(relPath.lastIndexOf('/') + 1) : relPath;
+  const dot = base.indexOf('.');
+  const stem = dot > 0 ? base.slice(0, dot) : base;
+  const ext = dot > 0 ? base.slice(dot) : '';
+  return `${dir}${toNamingStyle(stem, style)}${ext}`;
+}
+
+/**
+ * Build the exhaustive rename checklist for the dominant file-naming convention.
+ * @param {string} cwd repo root (for relative paths)
+ * @param {string[]} files absolute source paths (e.g. from buildFileList)
+ * @param {object} conventions an `extractConventions` result (for the dominant style)
+ * @returns {{ dominant: string|null, renames: Array<{from:string,to:string,fromStyle:string}>, count: number }}
+ */
+function buildFixList(cwd, files, conventions) {
+  const dominant = conventions && conventions.fileNaming && conventions.fileNaming.dominant;
+  if (!dominant) return { dominant: null, renames: [], count: 0 };
+
+  const renames = [];
+  for (const f of files || []) {
+    if (!SCOPED_EXTS.has(path.extname(f).toLowerCase())) continue;
+    if (TEST_RE.test(f)) continue;
+    const base = path.basename(f);
+    const style = classifyNaming(base);
+    if (style === 'other' || style === dominant) continue;
+    const rel = path.relative(cwd, f).replace(/\\/g, '/');
+    renames.push({ from: rel, to: _renamePath(rel, dominant), fromStyle: style });
+  }
+  renames.sort((a, b) => a.from.localeCompare(b.from));
+  return { dominant, renames, count: renames.length };
+}
+
+module.exports = { buildFixList };

package/src/mcp/server.js

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