synabun 2.0.9 → 2.1.0

package/neural-interface/lib/skills/known-bridge-digests.json

@@ -0,0 +1,387 @@
+{
+  "schemaVersion": 1,
+  "about": "Bridge files earlier SynaBun versions wrote for Codex (~/.codex/prompts/<name>.md) and OpenCode (~/.config/opencode/command/<name>.md): the SHA-256 of each text with the bundled skill folder as `placeholder`, per runtime and skill name. A file whose bytes are one of these (with this install's folder) moves to a native skill folder by itself (lib/skills/migration.js proof generated-previous). Computed by scripts/skills/compute-bridge-digests.mjs from git history; do not edit by hand.",
+  "placeholder": "\u0000SYNABUN_SKILL_DIR\u0000",
+  "generators": [
+    {
+      "id": "g1",
+      "sha256": "9427c9c061eb411f3577b7606fe0cf7843dbe07fcb93fed3c3c84956dcf288a6",
+      "firstCommit": "0f9487a15761",
+      "firstDate": "2026-04-20"
+    },
+    {
+      "id": "g2",
+      "sha256": "5c6328c33cea7c8b8808d685e2de0ad2151b790562655a9b1c00d0106a308b43",
+      "firstCommit": "9331cbab34e3",
+      "firstDate": "2026-07-13"
+    },
+    {
+      "id": "g3",
+      "sha256": "c01fc125e147f693cc2fad080f6765f93ccaaa8afccb9b4661c08a5fbabd7f4c",
+      "firstCommit": "ae9acec31b71",
+      "firstDate": "2026-10-23"
+    }
+  ],
+  "bridges": {
+    "codex": {
+      "leonardo": [
+        {
+          "digest": "7865862f6cb04aba6b68641bfa5d308b16c9c78ac3bbc7f486a8d12d0094724b",
+          "sep": "any",
+          "generators": [
+            "g1"
+          ],
+          "skillMd": [
+            "be0428175b95"
+          ],
+          "firstCommit": "0f9487a15761",
+          "firstDate": "2026-04-20"
+        },
+        {
+          "digest": "e79b64d4abc7a114fedebfacce46bc824c18ac27d78dcd4bf67164d0061d8307",
+          "sep": "any",
+          "generators": [
+            "g1"
+          ],
+          "skillMd": [
+            "b2a0d731bf20"
+          ],
+          "firstCommit": "0374cf2ae6f2",
+          "firstDate": "2026-04-25"
+        },
+        {
+          "digest": "10d6b72ce424fafe8eb3b9b8a3c65eb8234892295cd88701f8f9c26a11a128b1",
+          "sep": "/",
+          "generators": [
+            "g2"
+          ],
+          "skillMd": [
+            "b2a0d731bf20"
+          ],
+          "firstCommit": "9331cbab34e3",
+          "firstDate": "2026-07-13"
+        },
+        {
+          "digest": "fc0eba6adf510ef478e18c7c57b335091ee02545ddb1a9552e35ea18ab5da140",
+          "sep": "\\",
+          "generators": [
+            "g2"
+          ],
+          "skillMd": [
+            "b2a0d731bf20"
+          ],
+          "firstCommit": "9331cbab34e3",
+          "firstDate": "2026-07-13"
+        }
+      ],
+      "skill-forge": [
+        {
+          "digest": "50b590fdd8749ed83381bbd0b5b1b8c718ab5e83475a76086dfad4110f4f8e55",
+          "sep": "\\",
+          "generators": [
+            "g3"
+          ],
+          "skillMd": [
+            "78ebb9f149ff",
+            "a28ce5188f4b"
+          ],
+          "firstCommit": "ae9acec31b71",
+          "firstDate": "2026-10-23"
+        },
+        {
+          "digest": "b253e5c435de87c156c535615cdc6256ee8f54e34bd3807d9e599b26cdee22f6",
+          "sep": "/",
+          "generators": [
+            "g3"
+          ],
+          "skillMd": [
+            "78ebb9f149ff",
+            "a28ce5188f4b"
+          ],
+          "firstCommit": "ae9acec31b71",
+          "firstDate": "2026-10-23"
+        }
+      ],
+      "synabun": [
+        {
+          "digest": "0c6fcf648dfdc159ea33740600b2db5dc8cffbca696ac111b2839e9803fbd32c",
+          "sep": "any",
+          "generators": [
+            "g1"
+          ],
+          "skillMd": [
+            "3dd1befbc19b"
+          ],
+          "firstCommit": "0f9487a15761",
+          "firstDate": "2026-04-20"
+        },
+        {
+          "digest": "dc270602a208eac8c84ba722473552bbbeadc6cdbd6968db9c4b3f31701c73c9",
+          "sep": "any",
+          "generators": [
+            "g1"
+          ],
+          "skillMd": [
+            "ec0c17ece213"
+          ],
+          "firstCommit": "0374cf2ae6f2",
+          "firstDate": "2026-04-25"
+        },
+        {
+          "digest": "cf4f4d22ab61219de00e33334f5023a28ed1a875b4850bea6e68fc0598f9b007",
+          "sep": "any",
+          "generators": [
+            "g1"
+          ],
+          "skillMd": [
+            "8d262753dd16"
+          ],
+          "firstCommit": "357e1723955c",
+          "firstDate": "2026-06-28"
+        },
+        {
+          "digest": "1514555510138fd42bc28d44d626105108773471e46c70f321691cfd91ac2b66",
+          "sep": "\\",
+          "generators": [
+            "g2",
+            "g3"
+          ],
+          "skillMd": [
+            "8d262753dd16",
+            "a9ac8e43510e",
+            "ea38ed171e73",
+            "f4fb172b9006"
+          ],
+          "firstCommit": "9331cbab34e3",
+          "firstDate": "2026-07-13"
+        },
+        {
+          "digest": "c95f4d4fc9216dde3cb39d8959ccc14be5aa01bf2d7a9d2997c692316e07659b",
+          "sep": "/",
+          "generators": [
+            "g2",
+            "g3"
+          ],
+          "skillMd": [
+            "8d262753dd16",
+            "a9ac8e43510e",
+            "ea38ed171e73",
+            "f4fb172b9006"
+          ],
+          "firstCommit": "9331cbab34e3",
+          "firstDate": "2026-07-13"
+        },
+        {
+          "digest": "0d154ea718f26cebe98413f5b5074b79f9e164235b1f230f9f9163ff1adbadb7",
+          "sep": "/",
+          "generators": [
+            "g2",
+            "g3"
+          ],
+          "skillMd": [
+            "1019fc5ef755",
+            "2a5ae45388b6",
+            "740fdb3985fd",
+            "b5380300a1f5"
+          ],
+          "firstCommit": "636f18afbe6b",
+          "firstDate": "2026-07-21"
+        },
+        {
+          "digest": "26937c83a9f8edc06d3354d1e649b7b5cf6ea2ba16e8c74c9eafde48fda210a5",
+          "sep": "\\",
+          "generators": [
+            "g2",
+            "g3"
+          ],
+          "skillMd": [
+            "1019fc5ef755",
+            "2a5ae45388b6",
+            "740fdb3985fd",
+            "b5380300a1f5"
+          ],
+          "firstCommit": "636f18afbe6b",
+          "firstDate": "2026-07-21"
+        }
+      ]
+    },
+    "opencode": {
+      "leonardo": [
+        {
+          "digest": "64b005834dd226dfc4287e2b27e8a6931a386268a5907494c30ccbaec4aeab32",
+          "sep": "any",
+          "generators": [
+            "g1"
+          ],
+          "skillMd": [
+            "be0428175b95"
+          ],
+          "firstCommit": "0f9487a15761",
+          "firstDate": "2026-04-20"
+        },
+        {
+          "digest": "6367df5db047344dc713916d5f194b200d77ff6e25b89c6a647fb533ee519263",
+          "sep": "any",
+          "generators": [
+            "g1",
+            "g2"
+          ],
+          "skillMd": [
+            "b2a0d731bf20"
+          ],
+          "firstCommit": "0374cf2ae6f2",
+          "firstDate": "2026-04-25"
+        }
+      ],
+      "skill-forge": [
+        {
+          "digest": "18dddd06a4c22d401ac651606c0740e477a780cceaf251f5f5bed1657a4733fb",
+          "sep": "any",
+          "generators": [
+            "g3"
+          ],
+          "skillMd": [
+            "78ebb9f149ff"
+          ],
+          "firstCommit": "ae9acec31b71",
+          "firstDate": "2026-10-23"
+        },
+        {
+          "digest": "4b619a432fc38e95310399f2d59a0f1501a3984b67007febd8ff92634afffa8f",
+          "sep": "any",
+          "generators": [
+            "g3"
+          ],
+          "skillMd": [
+            "a28ce5188f4b"
+          ],
+          "firstCommit": "worktree",
+          "firstDate": null
+        }
+      ],
+      "synabun": [
+        {
+          "digest": "3660306f72cbf653a6bbda770412b017ae33eb05e845370ee8982bc3bf449ef5",
+          "sep": "any",
+          "generators": [
+            "g1"
+          ],
+          "skillMd": [
+            "3dd1befbc19b"
+          ],
+          "firstCommit": "0f9487a15761",
+          "firstDate": "2026-04-20"
+        },
+        {
+          "digest": "3d36728bc4e1d48007a9822afc5c95742b447c0a691cfdcc4c0ee61397c6317f",
+          "sep": "any",
+          "generators": [
+            "g1"
+          ],
+          "skillMd": [
+            "ec0c17ece213"
+          ],
+          "firstCommit": "0374cf2ae6f2",
+          "firstDate": "2026-04-25"
+        },
+        {
+          "digest": "07f365336e58e40dd89eb801ca3407a0be6d8a6f2978031a13c41eae9c8694ba",
+          "sep": "any",
+          "generators": [
+            "g1",
+            "g2"
+          ],
+          "skillMd": [
+            "8d262753dd16"
+          ],
+          "firstCommit": "357e1723955c",
+          "firstDate": "2026-06-28"
+        },
+        {
+          "digest": "2437a359858367b341199d0a1ec2ed9c83c3aea1dfe9ae2eb3d5f1fd804391c2",
+          "sep": "any",
+          "generators": [
+            "g2"
+          ],
+          "skillMd": [
+            "ea38ed171e73"
+          ],
+          "firstCommit": "9331cbab34e3",
+          "firstDate": "2026-07-13"
+        },
+        {
+          "digest": "de80108812b6ac44adfdb17f0241d552a686ecc44320c6a442bf68902d4fdcd5",
+          "sep": "any",
+          "generators": [
+            "g2"
+          ],
+          "skillMd": [
+            "740fdb3985fd"
+          ],
+          "firstCommit": "636f18afbe6b",
+          "firstDate": "2026-07-21"
+        },
+        {
+          "digest": "3f585859c54e1b1765ef73016963e44d5ad042ed2770a5c50ed6e7140bf66923",
+          "sep": "any",
+          "generators": [
+            "g2"
+          ],
+          "skillMd": [
+            "1019fc5ef755"
+          ],
+          "firstCommit": "1e8d4a7b438c",
+          "firstDate": "2026-07-31"
+        },
+        {
+          "digest": "97c5b4024f224725f38c654ccaab1b508a2e0eee9d3b379fb2b8207537e18940",
+          "sep": "any",
+          "generators": [
+            "g2"
+          ],
+          "skillMd": [
+            "a9ac8e43510e"
+          ],
+          "firstCommit": "38b4830aeeea",
+          "firstDate": "2026-08-16"
+        },
+        {
+          "digest": "43e7f9f6735eb0dd5a1f3da91a091a934361a0ed343b7b6b6e0f0bf788a7a010",
+          "sep": "any",
+          "generators": [
+            "g2"
+          ],
+          "skillMd": [
+            "2a5ae45388b6"
+          ],
+          "firstCommit": "9bddbafa7715",
+          "firstDate": "2026-09-01"
+        },
+        {
+          "digest": "6521bff3e17b32e0c56fea1a7b32690aaebe8a9a384e23ee6a92ca90e9324f66",
+          "sep": "any",
+          "generators": [
+            "g3"
+          ],
+          "skillMd": [
+            "f4fb172b9006"
+          ],
+          "firstCommit": "ae9acec31b71",
+          "firstDate": "2026-10-23"
+        },
+        {
+          "digest": "b595148289a6c6761cc18a7966ccd974c86e035825e62d7463720ca9bcc5fd27",
+          "sep": "any",
+          "generators": [
+            "g3"
+          ],
+          "skillMd": [
+            "b5380300a1f5"
+          ],
+          "firstCommit": "6776e42b885c",
+          "firstDate": "2026-10-23"
+        }
+      ]
+    }
+  }
+}

package/neural-interface/lib/skills/known-bridges.js

@@ -0,0 +1,96 @@
+// ── The bridge files earlier SynaBun versions wrote ──
+// Before native skill folders, SynaBun wrote a Codex prompt and an OpenCode command for each bundled skill
+// (server.js buildCliSkillPrompt, lib/skill-prompt-bridge.js). The text of a bridge is a function of the skill's
+// SKILL.md as that version shipped it, of the generator of that version, and of the folder the bundled skill was
+// in (each bridge names it). The migration (lib/skills/migration.js) moves a bridge by itself only on exact bytes:
+// today's generation (`generated-current`), the ledger's record, or (this file) the bytes an earlier version wrote
+// for that runtime and skill (`generated-previous`).
+//
+// known-bridge-digests.json is that list, reviewed and shipped: for each runtime and skill name, the SHA-256 of
+// every bridge text an earlier generator wrote from an earlier SKILL.md, in a path-neutral form (the bundled skill
+// folder replaced by BRIDGE_DIR_PLACEHOLDER), because the folder is the install's own. It is computed by replaying
+// every historical generator over every SKILL.md it shipped with in git history:
+// scripts/skills/compute-bridge-digests.mjs (`--write` rewrites it, `--check` says whether it is current).
+//
+// Why a match is exact, never fuzzy: a file F matches when sha256(F with every occurrence of this install's skill
+// folder D replaced by the placeholder P) is a listed digest of T = G(P), the generator's text with P as the folder.
+// The replacement is undone exactly (F holds no NUL, so no P, and P holds no part of D), so F = T with P replaced
+// by D, which is G(D) byte for byte: the generator only ever puts the folder in as a whole string, and a folder with
+// a `$` (which String.replace would read as a pattern) is refused. Only D, this install's folder, is tried: a
+// bridge that points at another folder (an old checkout, a moved install) is not proven and stays an offer. Codex's
+// pointer names D/SKILL.md with the platform's separator, so its digests are listed per separator.
+
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { sep as hostSep } from 'node:path';
+
+/** What stands for the bundled skill folder in a path-neutral bridge text (NUL never occurs in a bridge). */
+export const BRIDGE_DIR_PLACEHOLDER = '\u0000SYNABUN_SKILL_DIR\u0000';
+export const KNOWN_BRIDGES_SCHEMA = 1;
+export const KNOWN_BRIDGES_FILE = new URL('./known-bridge-digests.json', import.meta.url);
+
+const RUNTIMES = new Set(['codex', 'opencode']);
+const SEPS = new Set(['any', '/', '\\']);
+const DIGEST_RE = /^[0-9a-f]{64}$/;
+
+/** A bridge text in its path-neutral form: every occurrence of the skill folder replaced by the placeholder. */
+export function neutralBridgeText(text, skillDir) {
+  return String(text).split(String(skillDir)).join(BRIDGE_DIR_PLACEHOLDER);
+}
+
+/** The digest a path-neutral bridge text is listed under (hex SHA-256 of its UTF-8 bytes). */
+export function bridgeTemplateDigest(neutralText) {
+  return createHash('sha256').update(String(neutralText), 'utf8').digest('hex');
+}
+
+/**
+ * The list as a lookup: `${runtime}\n${name}` → its entries. A missing, unreadable or malformed file is an empty
+ * list (nothing is proven by it), never an exception: the migration then only moves what it proved otherwise.
+ * @param {object|string|URL} [source] the parsed list, or its file (default: the shipped one)
+ */
+export function readKnownBridges(source = KNOWN_BRIDGES_FILE) {
+  const out = new Map();
+  let doc = source;
+  try {
+    if (typeof source === 'string' || source instanceof URL) doc = JSON.parse(readFileSync(source, 'utf8'));
+  } catch { return out; }
+  if (!doc || typeof doc !== 'object' || doc.schemaVersion !== KNOWN_BRIDGES_SCHEMA || doc.placeholder !== BRIDGE_DIR_PLACEHOLDER) return out;
+  const bridges = doc.bridges && typeof doc.bridges === 'object' ? doc.bridges : {};
+  for (const [runtime, skills] of Object.entries(bridges)) {
+    if (!RUNTIMES.has(runtime) || !skills || typeof skills !== 'object') continue;
+    for (const [name, entries] of Object.entries(skills)) {
+      if (!Array.isArray(entries)) continue;
+      const ok = entries.filter((e) => e && typeof e === 'object' && DIGEST_RE.test(String(e.digest)) && SEPS.has(e.sep));
+      if (ok.length) out.set(`${runtime}\n${name}`, ok);
+    }
+  }
+  return out;
+}
+
+let shipped = null;
+/** The shipped list, read once per process (it changes only with a new SynaBun version, which is a restart). */
+export function knownBridges() {
+  if (!shipped) shipped = readKnownBridges();
+  return shipped;
+}
+
+/**
+ * Whether `bytes` are exactly a bridge an earlier SynaBun version wrote for `runtime` and skill `name` from the
+ * bundled skill folder `skillDir`. Returns the list's entry (`{ digest, sep, firstCommit, firstDate, … }`) or null.
+ * @param {Buffer|Uint8Array} bytes the file as it is on disk
+ * @param {{ runtime: string, name: string, skillDir: string, sep?: string, known?: Map<string, object[]> }} o
+ */
+export function matchPreviousBridge(bytes, { runtime, name, skillDir, sep = hostSep, known = knownBridges() } = {}) {
+  if (!RUNTIMES.has(runtime) || typeof name !== 'string' || !name) return null;
+  if (typeof skillDir !== 'string' || !skillDir || /[\u0000\r\n$]/.test(skillDir)) return null;
+  const entries = known.get(`${runtime}\n${name}`);
+  if (!entries) return null;
+  const buf = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes || []);
+  const text = buf.toString('utf8');
+  // Bytes that are not UTF-8 (they would not read back the same) or hold a NUL are no text SynaBun wrote.
+  if (!Buffer.from(text, 'utf8').equals(buf) || text.includes('\u0000')) return null;
+  // Every bridge SynaBun wrote names its skill folder.
+  if (!text.includes(skillDir)) return null;
+  const digest = bridgeTemplateDigest(neutralBridgeText(text, skillDir));
+  return entries.find((e) => e.digest === digest && (e.sep === 'any' || e.sep === sep)) || null;
+}