@superinstance/live-canon 0.1.0 → 0.3.0

package/index.js

@@ -1,168 +1,66 @@
-// index.js — Live Canon for Node.js
-//
-// Live Canon: read the AI-Writings canon as a navigable cell fabric.
-// 5 novel operations:
-//   1. NAVIGATE  - BFS through citations
-//   2. CONFLUENCE - join 2+ papers, suggest synthesis
-//   3. LINEAGE   - trace F-number through time
-//   4. GHOST     - find paper that should exist by shape proximity
-//   5. TICK      - re-balance the canon
-//
-// Polyformal: byte-exact with Python, C99, Rust, Verilog, VHDL.
-// State hash = 0xbf27a3631cdee337 for the 9 bundled papers.
-//
-// Phase 251 of the polyformalism canon.
-
-'use strict';
-
-// ===== FNV-1a 64-bit hash (UTF-8 byte-exact with Python) =====
+// index.js — Live Canon: AI-Writings as a navigable cell fabric
+// 14 papers, byte-exact with Python, C, Rust, Verilog, VHDL, JavaScript
+
+const FNV_OFFSET = 0xCBF29CE484222325n;
+const FNV_PRIME  = 0x00000100000001B3n;
+const MASK       = 0xFFFFFFFFFFFFFFFFn;
+
 function fnv1a_64(s) {
-  let h = 0xCBF29CE484222325n;
-  const bytes = new TextEncoder().encode(s);
-  for (let i = 0; i < bytes.length; i++) {
-    h ^= BigInt(bytes[i]);
-    h = (h * 0x00000100000001B3n) & 0xFFFFFFFFFFFFFFFFn;
+  let h = FNV_OFFSET;
+  const enc = new TextEncoder();
+  const bytes = enc.encode(s);
+  for (const b of bytes) {
+    h ^= BigInt(b);
+    h = (h * FNV_PRIME) & MASK;
   }
   return h;
 }
 
-// ===== Cell encoding (16 x Q1.15 dials) =====
-function cellToDials(paper) {
-  const year = parseInt(paper.date.substring(0, 4)) || 1970;
-  const year_q = (year - 1970) * 546;
-  const phase_q = paper.phase * 218;
-  const f_q = paper.f_number * 218;
-  const n_refs = (paper.ref_papers?.length || 0) + (paper.ref_f_numbers?.length || 0);
-  const n_refs_q = Math.min(0x7FFF, n_refs * 256);
-  const th = fnv1a_64(paper.title);
-  const title_lo = Number(th & 0xFFFFn);
-  const title_hi = Number((th >> 16n) & 0xFFFFn);
-  const num = Math.min(paper.number, 500);
-  const num_q = num * 131;
-  return [num_q, title_lo, f_q, phase_q, year_q, n_refs_q, title_hi, 0,
-          0, 0, 0, 0, 0, 0, 0, 0];
+function cellToDials(p) {
+  const year = parseInt((p.date || '1970-01-01').slice(0, 4)) || 1970;
+  const yearQ = (year - 1970) * 546;
+  const phaseQ = (p.phase || 0) * 218;
+  const fQ = (p.f_number || 0) * 218;
+  const nRefs = (p.ref_papers || []).length + (p.ref_f_numbers || []).length;
+  const nRefsQ = Math.min(0x7FFF, nRefs * 256);
+  const th = fnv1a_64(p.title || '');
+  const titleLo = Number(th & 0xFFFFn);
+  const titleHi = Number((th >> 16n) & 0xFFFFn);
+  const num = Math.min(p.number || 0, 500);
+  const numQ = num * 131;
+  return [numQ, titleLo, fQ, phaseQ, yearQ, nRefsQ, titleHi, 0, 0, 0, 0, 0, 0, 0, 0, 0];
 }
 
-// ===== Cosine similarity =====
-function cosineSim(a, b) {
-  let dot = 0, na = 0, nb = 0;
-  for (let i = 0; i < 16; i++) {
-    dot += a[i] * b[i];
-    na += a[i] * a[i];
-    nb += b[i] * b[i];
-  }
-  na = Math.sqrt(na);
-  nb = Math.sqrt(nb);
-  if (na === 0 || nb === 0) return 0;
-  return dot / (na * nb);
-}
-
-// ===== State hash (FNV-1a over sorted dials) =====
 function stateHash(papers) {
-  const allDials = Object.values(papers).map(p => cellToDials(p));
-  allDials.sort((a, b) => a[0] - b[0]);
-  let h = 0xCBF29CE484222325n;
-  for (const d of allDials) {
+  const dials = Object.values(papers).map(cellToDials);
+  dials.sort((a, b) => a[0] - b[0]);
+  let h = FNV_OFFSET;
+  for (const d of dials) {
     for (const v of d) {
       const lo = v & 0xFF;
       const hi = (v >> 8) & 0xFF;
       h ^= BigInt(lo);
-      h = (h * 0x00000100000001B3n) & 0xFFFFFFFFFFFFFFFFn;
+      h = (h * FNV_PRIME) & MASK;
       h ^= BigInt(hi);
-      h = (h * 0x00000100000001B3n) & 0xFFFFFFFFFFFFFFFFn;
+      h = (h * FNV_PRIME) & MASK;
     }
   }
   return h;
 }
 
-// ===== The 5 Operations =====
-function navigate(canon, start, depth) {
-  const visited = new Set([start]);
-  const result = [];
-  const queue = [[start, 0]];
-  while (queue.length > 0) {
-    const [num, d] = queue.shift();
-    const paper = canon[num];
-    if (paper) {
-      result.push({ depth: d, paper });
-      if (d < depth) {
-        for (const ref of (paper.ref_papers || [])) {
-          if (canon[ref] && !visited.has(ref)) {
-            visited.add(ref);
-            queue.push([ref, d + 1]);
-          }
-        }
-      }
-    }
-  }
-  return result;
-}
-
-function confluence(canon, paper_nums) {
-  if (!paper_nums || paper_nums.length === 0) return { error: "no papers" };
-  let sharedRefs = null, sharedF = null;
-  const titles = [];
-  for (const num of paper_nums) {
-    const p = canon[num];
-    if (!p) continue;
-    titles.push(p.title);
-    const refs = new Set(p.ref_papers || []);
-    sharedRefs = sharedRefs === null
-      ? new Set(refs)
-      : new Set([...sharedRefs].filter(x => refs.has(x)));
-    const fs = new Set(p.ref_f_numbers || []);
-    sharedF = sharedF === null
-      ? new Set(fs)
-      : new Set([...sharedF].filter(x => fs.has(x)));
-  }
-  let suggested = `Composition of ${paper_nums.length} papers`;
-  if (sharedF && sharedF.size > 0) {
-    const first = [...sharedF].sort((a, b) => a - b)[0];
-    suggested = `F${first} Synthesis: ${titles.join(", ")}`;
-  }
-  const maxN = Math.max(...Object.keys(canon).map(Number));
-  return {
-    input_papers: paper_nums,
-    input_titles: titles,
-    shared_refs: sharedRefs ? [...sharedRefs].sort((a, b) => a - b) : [],
-    shared_f_numbers: sharedF ? [...sharedF].sort((a, b) => a - b) : [],
-    suggested_title: suggested,
-    ghost_paper: `paper-${maxN + 1}.md`,
-  };
-}
-
-function lineage(canon, f_number) {
-  const result = [];
-  for (const p of Object.values(canon)) {
-    if ((p.ref_f_numbers || []).includes(f_number)) result.push(p);
-  }
-  result.sort((a, b) => (a.phase - b.phase) || (a.number - b.number));
-  return result;
-}
-
-function ghost(canon, paper_num, k) {
-  const target = canon[paper_num];
-  if (!target) return { error: "missing paper" };
-  const targetDials = cellToDials(target);
-  const scored = [];
-  for (const [n, p] of Object.entries(canon)) {
-    if (Number(n) === paper_num) continue;
-    const score = cosineSim(targetDials, cellToDials(p));
-    scored.push({ id: `p${String(n).padStart(4, "0")}`, score: Math.round(score * 10000) / 10000 });
+function cosine(a, b) {
+  let dot = 0, na = 0, nb = 0;
+  for (let i = 0; i < 16; i++) {
+    dot += a[i] * b[i];
+    na += a[i] * a[i];
+    nb += b[i] * b[i];
   }
-  scored.sort((a, b) => b.score - a.score);
-  return {
-    source_paper: `paper-${paper_num}.md`,
-    neighbors: scored.slice(0, k),
-    suggested_title: `A Bridge between F${target.f_number} and its neighbors`,
-  };
-}
-
-function tick(canon) {
-  return { ticked_cells: Object.keys(canon).length };
+  na = Math.sqrt(na);
+  nb = Math.sqrt(nb);
+  return na && nb ? dot / (na * nb) : 0;
 }
 
-// ===== Bundled canon (9 papers from the polyformalism cascade) =====
+// Default 14-paper canon (F115-F135)
 const DEFAULT_CANON = {
   425: { number: 425, title: "F115 — The Logical Routes: VHDL × Verilog × the QUF bit-exactness", f_number: 115, phase: 237, date: "2026-09-03", ref_papers: [426, 427], ref_f_numbers: [] },
   426: { number: 426, title: "F116 — The 5+1+1+1+1+1+1+1+1+1+1 Opcodes in 5 Substrates: A Polyformalism Atlas", f_number: 116, phase: 238, date: "2026-09-03", ref_papers: [], ref_f_numbers: [115] },
@@ -173,54 +71,110 @@ const DEFAULT_CANON = {
   433: { number: 433, title: "F123 — The Composer Agent: 5 Cells, 80 Parameters", f_number: 123, phase: 245, date: "2026-09-03", ref_papers: [], ref_f_numbers: [120, 122] },
   439: { number: 439, title: "F129 — The Live Canon: Papers as Cells, Reading as Navigation", f_number: 129, phase: 251, date: "2026-09-03", ref_papers: [], ref_f_numbers: [115, 120, 122, 125] },
   440: { number: 440, title: "F130 — The Polyformal Live Canon: One Cell, Five Substrates", f_number: 130, phase: 251, date: "2026-09-03", ref_papers: [], ref_f_numbers: [115, 129] },
+  441: { number: 441, title: "F131 — The 3-Package Polyformalism: One Cell, Three Registries", f_number: 131, phase: 252, date: "2026-09-03", ref_papers: [], ref_f_numbers: [115, 130] },
+  442: { number: 442, title: "F132 — Operational Fictions as Concrete System-Prompt Noun-Phrases", f_number: 132, phase: 253, date: "2026-09-03", ref_papers: [], ref_f_numbers: [] },
+  443: { number: 443, title: "F133 — Operational Fictions as Falsifiable Claims (avg divergence 0.861)", f_number: 133, phase: 254, date: "2026-09-03", ref_papers: [], ref_f_numbers: [132] },
+  444: { number: 444, title: "F134 — The Quilt Cowboy: Orchestrator Over 12 Cheap Voices", f_number: 134, phase: 254, date: "2026-09-03", ref_papers: [], ref_f_numbers: [132, 133] },
+  445: { number: 445, title: "F135 — The Wheelhouse Test: Scoring Fictions for 0300-in-a-Gale Tolerability", f_number: 135, phase: 254, date: "2026-09-03", ref_papers: [], ref_f_numbers: [132, 133] },
 };
 
-// ===== LiveCanon class =====
 class LiveCanon {
-  constructor(canon = DEFAULT_CANON) {
-    this.canon = canon;
+  constructor(canon = null) {
+    this.canon = canon || { ...DEFAULT_CANON };
+  }
+
+  get stateHashBigInt() {
+    return stateHash(this.canon);
   }
-  navigate(start, depth = 2) { return navigate(this.canon, start, depth); }
-  confluence(paper_nums) { return confluence(this.canon, paper_nums); }
-  lineage(f_number) { return lineage(this.canon, f_number); }
-  ghost(paper_num, k = 5) { return ghost(this.canon, paper_num, k); }
-  tick() { return tick(this.canon); }
-  get stateHash() { return stateHash(this.canon); }
-  get stateHashString() { return "0x" + this.stateHash.toString(16).padStart(16, "0"); }
-  get paperCount() { return Object.keys(this.canon).length; }
+
+  get stateHashString() {
+    return '0x' + this.stateHashBigInt.toString(16).padStart(16, '0');
+  }
+
+  get paperCount() {
+    return Object.keys(this.canon).length;
+  }
+
   papers() { return Object.values(this.canon); }
-  dials(paper_num) { return cellToDials(this.canon[paper_num]); }
-  // Fetch the canon from the live URL
-  static async fromUrl(url = "https://live-canon.superinstance.dev/api/canon") {
-    const fetchFn = globalThis.fetch || (await import("node-fetch")).default;
-    const res = await fetchFn(url);
-    const data = await res.json();
-    const canon = {};
-    for (const p of data.papers) {
-      canon[p.number] = {
-        number: p.number,
-        title: p.title,
-        f_number: p.f_number,
-        phase: p.phase,
-        date: p.date || "2026-09-03",
-        ref_papers: [],
-        ref_f_numbers: [],
-      };
+
+  navigate(start, depth = 2) {
+    const visited = new Set([start]);
+    const result = [];
+    const queue = [[start, 0]];
+    while (queue.length) {
+      const [num, d] = queue.shift();
+      const paper = this.canon[num];
+      if (paper) {
+        result.push({ depth: d, paper });
+        if (d < depth) {
+          for (const ref of paper.ref_papers || []) {
+            if (this.canon[ref] && !visited.has(ref)) {
+              visited.add(ref);
+              queue.push([ref, d + 1]);
+            }
+          }
+        }
+      }
+    }
+    return result;
+  }
+
+  confluence(paperNums) {
+    if (!paperNums || !paperNums.length) return { error: "no papers" };
+    let sharedRefs = null, sharedF = null;
+    const titles = [];
+    for (const num of paperNums) {
+      const p = this.canon[num];
+      if (!p) continue;
+      titles.push(p.title);
+      const refs = new Set(p.ref_papers || []);
+      sharedRefs = sharedRefs === null ? new Set(refs) : new Set([...sharedRefs].filter(x => refs.has(x)));
+      const fs = new Set(p.ref_f_numbers || []);
+      sharedF = sharedF === null ? new Set(fs) : new Set([...sharedF].filter(x => fs.has(x)));
+    }
+    let suggested = `Composition of ${paperNums.length} papers`;
+    if (sharedF && sharedF.size) {
+      const first = Math.min(...sharedF);
+      suggested = `F${first} Synthesis: ${titles.join(', ')}`;
+    }
+    const maxN = Math.max(...Object.keys(this.canon).map(Number));
+    return {
+      input_papers: paperNums,
+      input_titles: titles,
+      shared_refs: sharedRefs ? [...sharedRefs].sort() : [],
+      shared_f_numbers: sharedF ? [...sharedF].sort() : [],
+      suggested_title: suggested,
+      ghost_paper: `paper-${maxN + 1}.md`,
+    };
+  }
+
+  lineage(fNumber) {
+    return this.papers()
+      .filter(p => (p.ref_f_numbers || []).includes(fNumber))
+      .sort((a, b) => (a.phase || 0) - (b.phase || 0));
+  }
+
+  ghost(paperNum, k = 5) {
+    const target = this.canon[paperNum];
+    if (!target) return { error: "missing paper" };
+    const targetDials = cellToDials(target);
+    const scored = [];
+    for (const [n, p] of Object.entries(this.canon)) {
+      if (n == paperNum) continue;
+      const score = cosine(targetDials, cellToDials(p));
+      scored.push({ id: `p${String(n).padStart(4, '0')}`, score: Math.round(score * 10000) / 10000 });
     }
-    return new LiveCanon(canon);
+    scored.sort((a, b) => b.score - a.score);
+    return {
+      source_paper: `paper-${paperNum}.md`,
+      neighbors: scored.slice(0, k),
+      suggested_title: `A Bridge between F${target.f_number || 0} and its neighbors`,
+    };
+  }
+
+  tick() {
+    return { ticked_cells: this.paperCount };
   }
 }
 
-module.exports = {
-  LiveCanon,
-  DEFAULT_CANON,
-  fnv1a_64,
-  cellToDials,
-  cosineSim,
-  stateHash,
-  navigate,
-  confluence,
-  lineage,
-  ghost,
-  tick,
-};
+module.exports = { LiveCanon, fnv1a_64, stateHash, cellToDials, DEFAULT_CANON };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superinstance/live-canon",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Live Canon — read the AI-Writings canon as a navigable cell fabric, with 5 novel operations: NAVIGATE, CONFLUENCE, LINEAGE, GHOST, TICK.",
   "main": "index.js",
   "scripts": {