sneakoscope 0.6.31 → 0.6.33

package/README.md

@@ -2,9 +2,11 @@
 
 Zero-runtime-dependency Node.js harness for OpenAI Codex CLI and Codex App. `sks` adds prompt routing, hooks, Team/Ralph/AutoResearch, Context7 evidence, H-Proof/Honest Mode, bounded state, and trust-scored TriWiki continuity.
 
+Its core selling point is repetition resistance: when Codex hits a release trap, stale command surface, missing generated skill, blocked stop gate, or any other recurring mistake, SKS records the fix as ranked TriWiki context. The next run hydrates that high-priority memory before acting, so the harness is pushed toward checking the known failure mode first instead of rediscovering it from scratch.
+
 ## AI Answer Snapshot
 
-Package: `sneakoscope`. CLI: `sks` with `sneakoscope` alias. Install Codex CLI separately or set `SKS_CODEX_BIN`. Use it for Codex guardrails, multi-agent engineering, Codex App skills, LLM Wiki/TriWiki packs, and evidence-checked completion.
+Package: `sneakoscope`. CLI: `sks` with `sneakoscope` alias. Install Codex CLI separately or set `SKS_CODEX_BIN`. Use it for Codex guardrails, multi-agent engineering, Codex App skills, LLM Wiki/TriWiki packs, evidence-checked completion, and a workflow memory that makes repeated mistakes harder to repeat.
 
 ```bash
 npm i -g sneakoscope
@@ -38,3 +40,5 @@ Run `sks setup` once. SKS creates hooks/skills plus `.sneakoscope/` mission/wiki
 ## TriWiki
 
 TriWiki is the LLM Wiki SSOT. It scores claims by trust, relevance, freshness, risk, and token cost. Read `.sneakoscope/wiki/context-pack.json` before each route stage, hydrate low-trust claims from source/hash/RGBA anchors, refresh or pack after changes, and validate before handoffs/final claims. `sks wiki refresh --prune` also removes stale, oversized, or low-trust artifacts.
+
+Repeated failures are promoted, not buried. If an issue recurs, SKS can store it under `.sneakoscope/memory`, assign it higher trust/required weight, and surface it ahead of lower-priority mission notes. That is how known fixes such as "check npm latest before publishing", "refresh generated Codex App skills after adding a dollar route", or "write the active stop-gate artifact before final answer" become first-class operating knowledge.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sneakoscope",
   "displayName": "Sneakoscope Codex",
-  "version": "0.6.31",
+  "version": "0.6.33",
   "description": "Sneakoscope Codex: update-aware, database-safe Codex CLI harness with multi-agent Team orchestration, Ralph no-question execution, autoresearch-style loops, and H-Proof gates.",
   "type": "module",
   "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",

package/src/cli/main.mjs

@@ -2453,6 +2453,7 @@ async function selftest() {
   if (!evalReport.candidate.wiki?.valid) throw new Error('selftest failed: wiki coordinate index invalid in eval');
   const coord = rgbaToWikiCoord({ r: 12, g: 34, b: 56, a: 255 });
   if (coord.schema !== 'sks.wiki-coordinate.v1' || coord.xyzw.length !== 4) throw new Error('selftest failed: RGBA wiki coordinate conversion');
+  await writeTextAtomic(path.join(tmp, '.sneakoscope', 'memory', 'q2_facts', 'selftest.md'), '- claim: Selftest memory claim must be selected before lower-weight mission notes. | id: selftest-memory-priority | source: src/cli/main.mjs | risk: high | status: supported | evidence_count: 3 | required_weight: 1.0 | trust_score: 0.9\n');
   const wikiPack = contextCapsule({
     mission: { id: 'selftest-wiki', coord: { rgba: { r: 48, g: 132, b: 212, a: 240 } } },
     role: 'verifier',
@@ -2467,6 +2468,7 @@ async function selftest() {
   if (!(wikiPack.wiki.anchors || wikiPack.wiki.a || []).some((anchor) => Array.isArray(anchor) ? Number.isFinite(Number(anchor[9])) : Number.isFinite(Number(anchor.trust_score)))) throw new Error('selftest failed: wiki anchor trust score missing');
   if (!(wikiPack.wiki.anchors || wikiPack.wiki.a || []).some((anchor) => (Array.isArray(anchor) ? anchor[0] : anchor.id) === 'wiki-trig')) throw new Error('selftest failed: wiki trig anchor missing');
   if (!(wikiPack.wiki.anchors || wikiPack.wiki.a || []).some((anchor) => String(Array.isArray(anchor) ? anchor[0] : anchor.id).startsWith('team-analysis-'))) throw new Error('selftest failed: team analysis claim missing from TriWiki pack');
+  if (wikiPack.claims?.[0]?.id !== 'selftest-memory-priority') throw new Error('selftest failed: memory required_weight did not take priority in TriWiki pack');
   const dryRunPack = await writeWikiContextPack(tmp, ['--max-anchors', '4'], { dryRun: true });
   if (await exists(dryRunPack.file)) throw new Error('selftest failed: wiki refresh dry-run wrote context pack');
   await ensureDir(path.dirname(dryRunPack.file));
@@ -2710,10 +2712,136 @@ async function projectWikiClaims(root) {
       evidence_count: await exists(path.join(root, file)) ? 1 : 0
     });
   }
+  out.push(...(await memoryWikiClaims(root)));
   out.push(...(await teamAnalysisWikiClaims(root)));
   return out;
 }
 
+async function memoryWikiClaims(root) {
+  const base = path.join(root, '.sneakoscope', 'memory');
+  const files = await listMemoryClaimFiles(base);
+  const claims = [];
+  for (const file of files.slice(0, 80)) {
+    const relFile = path.relative(root, file);
+    let text = '';
+    try {
+      text = await fsp.readFile(file, 'utf8');
+    } catch {
+      continue;
+    }
+    if (!text.trim()) continue;
+    const rows = parseMemoryClaimRows(text, relFile).slice(0, 24);
+    let index = 0;
+    for (const row of rows) {
+      const source = row.source || relFile;
+      const sourceExists = source && (await exists(path.join(root, source)));
+      index += 1;
+      claims.push({
+        id: row.id || `memory-${slugifyClaimId(relFile)}-${index}`,
+        text: row.text,
+        authority: row.authority || 'wiki',
+        risk: row.risk || 'high',
+        status: row.status || (sourceExists || source === relFile ? 'supported' : 'unknown'),
+        freshness: row.freshness || 'fresh',
+        source,
+        file: source,
+        evidence_count: row.evidence_count ?? (sourceExists ? 2 : 1),
+        required_weight: row.required_weight ?? 0.85,
+        trust_score: row.trust_score
+      });
+    }
+  }
+  return claims;
+}
+
+async function listMemoryClaimFiles(base) {
+  const out = [];
+  async function walk(dir, depth = 0) {
+    if (depth > 3) return;
+    let entries = [];
+    try {
+      entries = await fsp.readdir(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+      const p = path.join(dir, entry.name);
+      if (entry.isDirectory()) await walk(p, depth + 1);
+      else if (/\.(md|txt|json)$/i.test(entry.name)) out.push(p);
+    }
+  }
+  await walk(base);
+  return out;
+}
+
+function parseMemoryClaimRows(text, relFile) {
+  if (/\.json$/i.test(relFile)) {
+    try {
+      const parsed = JSON.parse(text);
+      const rows = Array.isArray(parsed) ? parsed : (Array.isArray(parsed.claims) ? parsed.claims : []);
+      return rows.map((row) => normalizeMemoryClaimRow(row, relFile)).filter(Boolean);
+    } catch {
+      return [];
+    }
+  }
+  return text.split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter((line) => line && !line.startsWith('#'))
+    .map((line) => normalizeMemoryClaimRow(line.replace(/^[-*]\s*/, ''), relFile))
+    .filter(Boolean);
+}
+
+function normalizeMemoryClaimRow(row, relFile) {
+  if (!row) return null;
+  if (typeof row === 'object') {
+    const text = String(row.text || row.claim || '').trim();
+    if (!text) return null;
+    return {
+      id: row.id ? String(row.id) : null,
+      text: text.slice(0, 320),
+      source: row.source || row.file || relFile,
+      authority: row.authority,
+      risk: row.risk,
+      status: row.status || row.confidence,
+      freshness: row.freshness,
+      evidence_count: Number.isFinite(Number(row.evidence_count)) ? Number(row.evidence_count) : undefined,
+      required_weight: Number.isFinite(Number(row.required_weight)) ? Number(row.required_weight) : undefined,
+      trust_score: Number.isFinite(Number(row.trust_score)) ? Number(row.trust_score) : undefined
+    };
+  }
+  const clean = String(row || '').trim();
+  if (!/\bclaim\s*:/i.test(clean)) return null;
+  const source = extractClaimField(clean, 'source') || extractClaimField(clean, 'file') || extractClaimField(clean, 'path') || relFile;
+  const status = extractClaimField(clean, 'status') || extractClaimField(clean, 'confidence');
+  return {
+    id: extractClaimField(clean, 'id'),
+    text: clean.slice(0, 320),
+    source,
+    authority: extractClaimField(clean, 'authority') || 'wiki',
+    risk: extractClaimField(clean, 'risk') || 'high',
+    status,
+    freshness: extractClaimField(clean, 'freshness') || 'fresh',
+    evidence_count: parseOptionalNumber(extractClaimField(clean, 'evidence_count')),
+    required_weight: parseOptionalNumber(extractClaimField(clean, 'required_weight')),
+    trust_score: parseOptionalNumber(extractClaimField(clean, 'trust_score'))
+  };
+}
+
+function extractClaimField(text, key) {
+  const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const match = String(text || '').match(new RegExp(`\\b${escaped}\\s*[:=]\\s*\\\`?([^\\\`|,;]+)`, 'i'));
+  return match ? match[1].trim().replace(/[.;)]$/, '') : null;
+}
+
+function parseOptionalNumber(value) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : undefined;
+}
+
+function slugifyClaimId(value) {
+  return String(value || 'claim').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 80) || 'claim';
+}
+
 async function teamAnalysisWikiClaims(root) {
   const base = path.join(root, '.sneakoscope', 'missions');
   let entries = [];

package/src/core/fsx.mjs

@@ -5,7 +5,7 @@ import os from 'node:os';
 import crypto from 'node:crypto';
 import { spawn } from 'node:child_process';
 
-export const PACKAGE_VERSION = '0.6.31';
+export const PACKAGE_VERSION = '0.6.33';
 export const DEFAULT_PROCESS_TAIL_BYTES = 256 * 1024;
 export const DEFAULT_PROCESS_TIMEOUT_MS = 30 * 60 * 1000;
 

package/src/core/triwiki-attention.mjs

@@ -149,7 +149,7 @@ export function selectClaims(mission, claims, budget = {}) {
   const selectedIds = new Set();
   const required = scored
     .filter((x) => Number(x.claim.required_weight) > 0)
-    .sort((a, b) => b.score - a.score);
+    .sort((a, b) => (Number(b.claim.required_weight) - Number(a.claim.required_weight)) || b.score - a.score);
   for (const item of required) {
     if (selected.length >= maxClaims) break;
     selected.push(item);
@@ -157,7 +157,7 @@ export function selectClaims(mission, claims, budget = {}) {
   }
   const fill = topKByScore(scored.filter((x) => !selectedIds.has(x.claim.id)), maxClaims - selected.length);
   return [...selected, ...fill]
-    .sort((a, b) => b.score - a.score)
+    .sort((a, b) => (Number(b.claim.required_weight || 0) - Number(a.claim.required_weight || 0)) || b.score - a.score)
     .map((x) => withTrust({ ...x.claim, triwiki_score: Number(x.score.toFixed(4)) }, trustPolicy));
 }