sigmap 7.18.0 → 7.19.0

package/CHANGELOG.md

@@ -10,6 +10,15 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [7.19.0] — 2026-06-18
+
+Minor release — scaffold persistence (grounded codegen, Gap 2 §6.2).
+
+### Added
+- **Scaffold persistence — `.context/scaffold/latest.md` (#334):** `sigmap scaffold` now writes an accepted proposal to `.context/scaffold/latest.md` so the `create` pipeline and agents can read back the convention-matched proposal instead of re-deriving it. New zero-dependency, bundle-safe `src/scaffold/persist.js` (`renderScaffoldMarkdown`, `scaffoldPath`); the record captures the filename + naming style, export style, test file + framework, and any force-warning. Persisted in both human and `--json` modes (the JSON output gains a `persistedTo` field); a refused scaffold writes nothing.
+
+---
+
 ## [7.18.0] — 2026-06-18
 
 Minor release — `sigmap conventions --update` (grounded codegen, Layer 3 — completes the §4 flag set).

package/gen-context.js

@@ -34,6 +34,55 @@ function __require(key) {
 // ── ./src/eval/llm-ablation ──
 // ── ./src/conventions/fix ──
 // ── ./src/conventions/update ──
+// ── ./src/scaffold/persist ──
+__factories["./src/scaffold/persist"] = function(module, exports) {
+  
+  /**
+   * Scaffold persistence (IMPL.md §6.2 — 2d).
+   *
+   * Renders an accepted scaffold proposal to markdown and locates the on-disk
+   * record (`.context/scaffold/latest.md`) so the `create` pipeline and agents can
+   * read back the convention-matched proposal. Pure render; zero-dependency,
+   * bundle-safe.
+   */
+
+  const path = require('path');
+
+  /** Path to the persisted scaffold record. */
+  function scaffoldPath(cwd) {
+    return path.join(cwd, '.context', 'scaffold', 'latest.md');
+  }
+
+  /**
+   * Render an accepted scaffold decision to a markdown record.
+   * @param {object} decision a `proposeScaffold` result with `ok: true`
+   * @param {object} [opts]
+   * @param {string} [opts.timestamp] ISO timestamp (caller supplies — keeps this pure)
+   * @returns {string}
+   */
+  function renderScaffoldMarkdown(decision, opts = {}) {
+    const d = decision || {};
+    const p = d.proposal || {};
+    const pct = (n) => `${Math.round((n || 0) * 100)}%`;
+    const lines = [
+      `# Scaffold — ${d.name || '(unnamed)'}`,
+      '',
+      `- **Conventions:** ${d.tier || 'unknown'} (${pct(d.confidence)})`,
+      `- **File:** \`${p.filename || ''}\` (${p.namingStyle || ''})`,
+      `- **Export style:** ${p.exportStyle || ''}`,
+      `- **Test file:** \`${p.testFile || ''}\`${p.testFramework ? ` (${p.testFramework})` : ''}`,
+    ];
+    if (d.warning) lines.push(`- **Warning:** ${d.warning}`);
+    lines.push('');
+    lines.push(`<sub>Generated by \`sigmap scaffold\`${opts.timestamp ? ` · ${opts.timestamp}` : ''}.</sub>`);
+    lines.push('');
+    return lines.join('\n');
+  }
+
+  module.exports = { scaffoldPath, renderScaffoldMarkdown };
+  
+};
+
 __factories["./src/conventions/update"] = function(module, exports) {
   
   /**
@@ -7819,7 +7868,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
 
   const SERVER_INFO = {
     name: 'sigmap',
-    version: '7.18.0',
+    version: '7.19.0',
     description: 'SigMap MCP server — code signatures on demand',
   };
 
@@ -13497,7 +13546,7 @@ function __tryGit(args, opts = {}) {
   catch (_) { return ''; }
 }
 
-const VERSION = '7.18.0';
+const VERSION = '7.19.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -16891,8 +16940,20 @@ function main() {
     const conventions = extractConventions(cwd, buildFileList(cwd, config));
     const decision = proposeScaffold(name, conventions, { threshold, ext, force });
 
+    // §6.2 (2d): persist an accepted proposal so `create`/agents can read it back.
+    let persistedTo = null;
+    if (decision.ok) {
+      const { scaffoldPath, renderScaffoldMarkdown } = requireSourceOrBundled('./src/scaffold/persist');
+      const outPath = scaffoldPath(cwd);
+      try {
+        fs.mkdirSync(path.dirname(outPath), { recursive: true });
+        fs.writeFileSync(outPath, renderScaffoldMarkdown(decision, { timestamp: new Date().toISOString() }));
+        persistedTo = path.relative(cwd, outPath) || outPath;
+      } catch (_) {}
+    }
+
     if (jsonOut) {
-      process.stdout.write(JSON.stringify(decision) + '\n');
+      process.stdout.write(JSON.stringify({ ...decision, persistedTo }) + '\n');
       process.exit(decision.ok ? 0 : 1);
     }
 
@@ -16904,6 +16965,7 @@ function main() {
       console.log(`  file:           ${p.filename}  (${p.namingStyle})`);
       console.log(`  export style:   ${p.exportStyle}`);
       console.log(`  test file:      ${p.testFile}${p.testFramework ? `  (${p.testFramework})` : ''}`);
+      if (persistedTo) console.log(`\n  → wrote ${persistedTo}`);
       process.exit(0);
     }
 

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

package/src/mcp/server.js

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

package/src/scaffold/persist.js

@@ -0,0 +1,45 @@
+'use strict';
+
+/**
+ * Scaffold persistence (IMPL.md §6.2 — 2d).
+ *
+ * Renders an accepted scaffold proposal to markdown and locates the on-disk
+ * record (`.context/scaffold/latest.md`) so the `create` pipeline and agents can
+ * read back the convention-matched proposal. Pure render; zero-dependency,
+ * bundle-safe.
+ */
+
+const path = require('path');
+
+/** Path to the persisted scaffold record. */
+function scaffoldPath(cwd) {
+  return path.join(cwd, '.context', 'scaffold', 'latest.md');
+}
+
+/**
+ * Render an accepted scaffold decision to a markdown record.
+ * @param {object} decision a `proposeScaffold` result with `ok: true`
+ * @param {object} [opts]
+ * @param {string} [opts.timestamp] ISO timestamp (caller supplies — keeps this pure)
+ * @returns {string}
+ */
+function renderScaffoldMarkdown(decision, opts = {}) {
+  const d = decision || {};
+  const p = d.proposal || {};
+  const pct = (n) => `${Math.round((n || 0) * 100)}%`;
+  const lines = [
+    `# Scaffold — ${d.name || '(unnamed)'}`,
+    '',
+    `- **Conventions:** ${d.tier || 'unknown'} (${pct(d.confidence)})`,
+    `- **File:** \`${p.filename || ''}\` (${p.namingStyle || ''})`,
+    `- **Export style:** ${p.exportStyle || ''}`,
+    `- **Test file:** \`${p.testFile || ''}\`${p.testFramework ? ` (${p.testFramework})` : ''}`,
+  ];
+  if (d.warning) lines.push(`- **Warning:** ${d.warning}`);
+  lines.push('');
+  lines.push(`<sub>Generated by \`sigmap scaffold\`${opts.timestamp ? ` · ${opts.timestamp}` : ''}.</sub>`);
+  lines.push('');
+  return lines.join('\n');
+}
+
+module.exports = { scaffoldPath, renderScaffoldMarkdown };