synabun 1.3.0 → 2.0.0

package/neural-interface/skins/default/skin.css

@@ -0,0 +1,90 @@
+/* ═══════════════════════════════════════════
+   SynaBun Default Skin — Reference Template
+   ═══════════════════════════════════════════
+
+   Copy this file to create your own skin.
+   Override any :root variable to change the Neural Interface appearance.
+
+   Glass/blur/scale variables are controlled by the Interface tab sliders
+   and will override skin values (inline styles > stylesheet).
+
+   Skin structure:
+     your-skin/
+       skin.json    — manifest (id, name, version, author, description, css)
+       skin.css     — this file (CSS variable overrides)
+       preview.png  — optional screenshot (400x240)
+       assets/      — optional (fonts, images, patterns)
+
+   Package as ZIP and upload via Settings > Skins.
+   ═══════════════════════════════════════════ */
+
+:root {
+  /* ── Text tones ──
+     Control text opacity/brightness across the interface.
+     Faint → Bright = least visible → most visible. */
+  --t-faint: rgba(255,255,255,0.2);
+  --t-muted: rgba(255,255,255,0.3);
+  --t-secondary: rgba(255,255,255,0.5);
+  --t-primary: rgba(255,255,255,0.7);
+  --t-bright: rgba(255,255,255,0.9);
+
+  /* ── Surfaces ──
+     Panel backgrounds, hover states, active states.
+     Subtle → Active = barely visible → clearly highlighted. */
+  --s-transparent: transparent;
+  --s-subtle: rgba(255,255,255,0.04);
+  --s-light: rgba(255,255,255,0.06);
+  --s-medium: rgba(255,255,255,0.10);
+  --s-hover: rgba(255,255,255,0.08);
+  --s-active: rgba(255,255,255,0.14);
+  --s-panel: rgba(28,28,30,0.85);
+
+  /* ── Borders ──
+     Dividers, card edges, input outlines.
+     Subtle → Visible = ghost line → clearly drawn. */
+  --b-subtle: rgba(255,255,255,0.06);
+  --b-light: rgba(255,255,255,0.10);
+  --b-hover: rgba(255,255,255,0.16);
+  --b-visible: rgba(255,255,255,0.22);
+
+  /* ── Accent colors ──
+     Primary accent is derived from hue/saturation/lightness.
+     Gold, red, orange are fixed semantic colors. */
+  --accent-hue: 199;
+  --accent-saturation: 92%;
+  --accent-lightness: 64%;
+
+  --accent-blue: hsl(var(--accent-hue), var(--accent-saturation), var(--accent-lightness));
+  --accent-blue-bg: hsla(var(--accent-hue), var(--accent-saturation), var(--accent-lightness), 0.10);
+  --accent-blue-border: hsla(var(--accent-hue), var(--accent-saturation), var(--accent-lightness), 0.25);
+
+  --accent-gold: rgba(255,215,0,0.85);
+  --accent-gold-bg: rgba(255,215,0,0.10);
+  --accent-gold-border: rgba(255,215,0,0.22);
+
+  --accent-red: #FF5252;
+  --accent-red-bg: rgba(255,82,82,0.15);
+  --accent-red-hover: rgba(255,82,82,0.30);
+
+  --accent-orange: #FFB74D;
+  --accent-orange-bg: rgba(255,183,77,0.10);
+
+  /* ── Border radii ──
+     Shape language for the interface. */
+  --r-pill: 20px;
+  --r-button: 10px;
+  --r-card: 8px;
+  --r-circle: 50%;
+  --r-small: 6px;
+}
+
+/* ── Body ──
+   Background color and default text. */
+body {
+  background: #050505;
+  color: #e0e0e0;
+}
+
+/* ── Scrollbar ── */
+::-webkit-scrollbar-track { background: rgba(255,255,255,0.03); }
+::-webkit-scrollbar-thumb { background: rgba(255,255,255,0.15); }

package/neural-interface/skins/default/skin.json

@@ -0,0 +1,8 @@
+{
+  "id": "default",
+  "name": "SynaBun Default",
+  "version": "1.0.0",
+  "author": "SynaBun",
+  "description": "The original Neural Interface look — dark glass with cool blue accents",
+  "css": "skin.css"
+}

package/neural-interface/templates/rulesets/README.md

@@ -0,0 +1,9 @@
+# SynaBun rulesets
+
+One source, rendered per host by `neural-interface/lib/rulesets/render.js`.
+
+- `core.md` is the text every host gets. A line ending in `<!-- except: codex -->` is dropped for the hosts it names; the line `<!-- host -->` is where the host's own file goes.
+- `claude.md`, `codex.md`, `opencode.md`, `gemini.md`, `cursor.md` hold at most two bullets each.
+- `coexistence.md` is a snippet people copy by hand. It is never installed.
+- `manifest.json` carries the version and one hash per host. A text change without a new version and new hashes fails `tests/rulesets-render.test.mjs`, which prints the hashes to paste.
+- `legacy-hashes.json` lists every ruleset SynaBun ever served, so the installer can recognise a copy someone pasted. `node scripts/gen-ruleset-legacy-hashes.mjs` adds to it and never drops an entry.

package/neural-interface/templates/rulesets/claude.md

@@ -0,0 +1,3 @@
+### Questions and plans
+- Ask clarifying questions with `AskUserQuestion`, never as plain text; set `multiSelect` when the options are not exclusive.
+- Get plan approval with `ExitPlanMode`.

package/neural-interface/templates/rulesets/codex.md

@@ -0,0 +1,2 @@
+### Plans
+- Store an approved plan in the matching `plans-*` category.

package/neural-interface/templates/rulesets/coexistence.md

@@ -0,0 +1,6 @@
+## SynaBun next to other memory or code-intelligence tools
+
+- SynaBun owns every memory operation. Store, search, update and delete long-term context with SynaBun tools only: `remember`, `recall`, `reflect`, `forget`, `restore`, `memories`, `sync`, `category`.
+- [OtherTool] is restricted to [its non-memory use, for example code search or impact analysis]. Never use it to remember, recall or reflect on past work.
+- SynaBun owns page access too: for every page, public-web and localhost alike, use only the configured SynaBun browser, and open a new tab for browser work.
+- Do not switch to WebSearch, WebFetch, Playwright MCP, Chrome DevTools MCP, a shell-launched or headless browser, or another web tool without an explicit user request. Playwright and Chrome DevTools belong only inside a project's automated test suite.

package/neural-interface/templates/rulesets/core.md

@@ -0,0 +1,26 @@
+## SynaBun
+
+### Memory
+- Recall before substantial work: at session start, before decisions or debugging, and when the user refers to earlier work.
+- After each substantive task call `remember`: what changed, why and how. Skip plain Q&A, reads with no findings and typos.
+- Call `remember` before your final summary; the summary comes last.
+- Every `remember` needs `category` and `project`. Add 3-5 tags, `related_files` and a deliberate importance: 5 routine, 6-7 significant, 8+ architecture or hard bugs.
+- Use an existing child category; if none fits, create one with `category` (action `create`). Never file under a parent.
+- `reflect` updates a memory and needs its full UUID.
+- Call SynaBun tools one at a time.
+- SynaBun is the only long-term memory; do not use another tool's memory features.
+
+### Tools
+- Use the exact tool names in your tool list (the host adds a prefix). Never invent one.
+- If a SynaBun tool you need is missing, call `profile` (`get`, then `set` the narrowest profile that has it) and restore the previous one afterwards. <!-- except: codex -->
+
+### Browser
+- For every page, public-web and localhost alike (browsing, search, page retrieval, screenshots, visual checks), use only the configured SynaBun browser tools, and open a new tab instead of reusing an existing one.
+- Never switch to WebSearch, WebFetch, Playwright MCP, Chrome DevTools MCP, a shell-launched or headless browser, or your own Playwright, Puppeteer or Selenium code without an explicit user request for that alternative. Playwright and Chrome DevTools belong only inside a project's automated test suite.
+- If the SynaBun browser is unavailable or cannot do what you need, say so instead of substituting another tool.
+
+### Design
+- Before UI, design, marketing, copy or image work in a project, read its `DESIGN.md` (or call `style_guide` with the project path) and use its tokens; never invent colors or fonts the project already defines.
+- Suggest changes with `style_guide` (action `propose`); never edit `DESIGN.md` or the generated token files by hand.
+
+<!-- host -->

package/neural-interface/templates/rulesets/cursor.md

@@ -0,0 +1,2 @@
+### Plans
+- Store an approved plan in the matching `plans-*` category.

package/neural-interface/templates/rulesets/gemini.md

@@ -0,0 +1,2 @@
+### Plans
+- Store an approved plan in the matching `plans-*` category.

package/neural-interface/templates/rulesets/legacy-hashes.json

@@ -0,0 +1,227 @@
+{
+  "_comment": "Generated by scripts/gen-ruleset-legacy-hashes.mjs. Every pre-2.0 ruleset text SynaBun served: sha = first 12 hex of SHA-256 over the normalised text, lines = its line count. Entries are never dropped.",
+  "entries": [
+    {
+      "sha": "83442f0e7edf",
+      "lines": 51,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "23114dd3d2f0",
+      "lines": 77,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "d46e5e1fa5d4",
+      "lines": 87,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "fc4cb4715e2e",
+      "lines": 100,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "88061e18030c",
+      "lines": 102,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "664f822c76bd",
+      "lines": 106,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "3e4b00745341",
+      "lines": 115,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "1e77ea56e385",
+      "lines": 125,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "45d42310ed3d",
+      "lines": 125,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "e79f83d43aad",
+      "lines": 125,
+      "firstLine": "## Memory Ruleset",
+      "host": "claude"
+    },
+    {
+      "sha": "1dc59082f1b7",
+      "lines": 15,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "codex"
+    },
+    {
+      "sha": "4a9d1e2662a2",
+      "lines": 18,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "codex"
+    },
+    {
+      "sha": "17dbbccc3ca0",
+      "lines": 19,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "codex"
+    },
+    {
+      "sha": "93a1dd0f7586",
+      "lines": 19,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "codex"
+    },
+    {
+      "sha": "a64e6fa337c8",
+      "lines": 19,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "codex"
+    },
+    {
+      "sha": "facbe9cf23c9",
+      "lines": 19,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "codex"
+    },
+    {
+      "sha": "bc012a38f95a",
+      "lines": 9,
+      "firstLine": "# Memory: SynaBun MCP (SQLite + local embeddings)",
+      "host": "cursor"
+    },
+    {
+      "sha": "d69a6f3583ba",
+      "lines": 10,
+      "firstLine": "# Memory: SynaBun MCP (SQLite + local embeddings)",
+      "host": "cursor"
+    },
+    {
+      "sha": "d4f2d47228af",
+      "lines": 12,
+      "firstLine": "# Memory: SynaBun MCP (SQLite + local embeddings)",
+      "host": "cursor"
+    },
+    {
+      "sha": "4462de0b40a3",
+      "lines": 14,
+      "firstLine": "# Memory: SynaBun MCP (SQLite + local embeddings)",
+      "host": "cursor"
+    },
+    {
+      "sha": "5e448d342874",
+      "lines": 15,
+      "firstLine": "# Memory: SynaBun MCP (SQLite + local embeddings)",
+      "host": "cursor"
+    },
+    {
+      "sha": "5f4857ee7f28",
+      "lines": 15,
+      "firstLine": "# Memory: SynaBun MCP (SQLite + local embeddings)",
+      "host": "cursor"
+    },
+    {
+      "sha": "644ad0783101",
+      "lines": 15,
+      "firstLine": "# Memory: SynaBun MCP (SQLite + local embeddings)",
+      "host": "cursor"
+    },
+    {
+      "sha": "fb405776ac0e",
+      "lines": 15,
+      "firstLine": "# Memory: SynaBun MCP (SQLite + local embeddings)",
+      "host": "cursor"
+    },
+    {
+      "sha": "6901d9d2aaea",
+      "lines": 10,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "gemini"
+    },
+    {
+      "sha": "54adb64daa5c",
+      "lines": 11,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "gemini"
+    },
+    {
+      "sha": "5e8b59742b75",
+      "lines": 11,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "gemini"
+    },
+    {
+      "sha": "a7ce31c83f7c",
+      "lines": 11,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "gemini"
+    },
+    {
+      "sha": "df31e2d4e642",
+      "lines": 11,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "gemini"
+    },
+    {
+      "sha": "81ca1c3cd1de",
+      "lines": 5,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "opencode"
+    },
+    {
+      "sha": "ebee7c91337c",
+      "lines": 6,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "opencode"
+    },
+    {
+      "sha": "9da97979b9db",
+      "lines": 8,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "opencode"
+    },
+    {
+      "sha": "50503e3058ac",
+      "lines": 11,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "opencode"
+    },
+    {
+      "sha": "4a75bfb3e1da",
+      "lines": 12,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "opencode"
+    },
+    {
+      "sha": "bbf91eaa2a3c",
+      "lines": 12,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "opencode"
+    },
+    {
+      "sha": "d76720b7a0b4",
+      "lines": 12,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "opencode"
+    },
+    {
+      "sha": "fef407cb375d",
+      "lines": 12,
+      "firstLine": "## Memory: SynaBun MCP",
+      "host": "opencode"
+    }
+  ]
+}

package/neural-interface/templates/rulesets/manifest.json

@@ -0,0 +1,12 @@
+{
+  "version": "2.1.0",
+  "updatedAt": "2026-10-02",
+  "summary": "Adds a Design section: read the project's DESIGN.md (or call style_guide) before UI, copy and image work, and propose changes instead of editing it",
+  "hashes": {
+    "claude": "2206c97cf003",
+    "codex": "939571cf2095",
+    "opencode": "49865561dc6e",
+    "gemini": "49865561dc6e",
+    "cursor": "49865561dc6e"
+  }
+}

package/neural-interface/templates/rulesets/opencode.md

@@ -0,0 +1,2 @@
+### Plans
+- Store an approved plan in the matching `plans-*` category.

package/package.json

@@ -1,53 +1,131 @@
-{
-  "name": "synabun",
-  "version": "1.3.0",
-  "description": "Persistent vector memory for AI assistants",
-  "license": "Apache-2.0",
-  "author": "The SynaBun Authors",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/danilokhury/Synabun.git"
-  },
-  "homepage": "https://synabun.ai",
-  "type": "module",
-  "bin": {
-    "synabun": "setup.js"
-  },
-  "files": [
-    "setup.js",
-    "postinstall.js",
-    "mcp-server/package.json",
-    "mcp-server/tsconfig.json",
-    "mcp-server/src/",
-    "mcp-server/run.mjs",
-    "mcp-server/data/.gitkeep",
-    "neural-interface/package.json",
-    "neural-interface/server.js",
-    "neural-interface/public/",
-    "neural-interface/templates/",
-    "neural-interface/scripts/",
-    "hooks/",
-    "skills/",
-    "data/.gitkeep",
-    "CLAUDE.md",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "start": "node setup.js",
-    "postinstall": "node postinstall.js"
-  },
-  "keywords": [
-    "claude",
-    "memory",
-    "mcp",
-    "vector",
-    "embeddings",
-    "ai",
-    "persistent-memory",
-    "claude-code"
-  ],
-  "engines": {
-    "node": ">=22.0.0"
-  }
-}
+{
+  "name": "synabun",
+  "version": "2.0.0",
+  "description": "Local-first persistent vector memory, MCP tooling, and multi-agent workflows for AI assistants",
+  "license": "Apache-2.0",
+  "author": "The SynaBun Authors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/danilokhury/Synabun.git"
+  },
+  "homepage": "https://synabun.ai",
+  "type": "module",
+  "bin": {
+    "synabun": "bin/synabun.js"
+  },
+  "files": [
+    "bin/synabun.js",
+    "setup.js",
+    "postinstall.js",
+    "preuninstall.js",
+    "updater.mjs",
+    "launcher.mjs",
+    "updater.cmd",
+    "updater.sh",
+    "NOTICE",
+    "THIRD-PARTY-LICENSES.md",
+    "LICENSE-COMMERCIAL.md",
+    "mcp-server/package.json",
+    "mcp-server/package-lock.json",
+    "mcp-server/dist/",
+    "mcp-server/tsconfig.json",
+    "mcp-server/src/",
+    "mcp-server/run.mjs",
+    "neural-interface/package.json",
+    "neural-interface/package-lock.json",
+    "neural-interface/server.js",
+    "neural-interface/lib/",
+    "neural-interface/i18n/",
+    "neural-interface/skins/",
+    "neural-interface/games/",
+    "neural-interface/public/",
+    "neural-interface/templates/",
+    "neural-interface/scripts/",
+    "hooks/claude-code/post-plan.mjs",
+    "hooks/claude-code/post-remember.mjs",
+    "hooks/claude-code/pre-compact.mjs",
+    "hooks/claude-code/pre-task.mjs",
+    "hooks/claude-code/pre-websearch.mjs",
+    "hooks/claude-code/prompt-origin.mjs",
+    "hooks/claude-code/prompt-submit.mjs",
+    "hooks/claude-code/session-start.mjs",
+    "hooks/claude-code/shared.mjs",
+    "hooks/claude-code/state.mjs",
+    "hooks/claude-code/stop.mjs",
+    "hooks/claude-code/subagent-start.mjs",
+    "hooks/claude-code/subagent-stop.mjs",
+    "hooks/claude-code/task-gate.mjs",
+    "skills/",
+    "lib/paths.js",
+    "lib/start-launcher.js",
+    "lib/packaged-runtime.js",
+    "lib/desktop-pwa.js",
+    "lib/external-tools.js",
+    "lib/paths.d.ts",
+    "lib/data-home-migration.js",
+    "lib/first-launch-protection.js",
+    "lib/client-config-repair.js",
+    "lib/claude-hooks.js",
+    "lib/claude-usage-audit.js",
+    "scripts/recover-user-config.mjs",
+    "scripts/restore-data-home-from-backup.mjs",
+    "scripts/audit-claude-hook-usage.mjs",
+    "scripts/audit-memory-duplicates.mjs",
+    "scripts/measure-claude-hook-overhead.mjs",
+    "docs/browser-v2.md",
+    "docs/hook-integrity.md",
+    "docs/judgments.md",
+    "docs/style-guide.md",
+    "docs/whatsapp.md",
+    "benchmarks/browser-v2-results.json",
+    "benchmarks/browser-live-results.json",
+    "benchmarks/fixtures/browser/",
+    "benchmarks/fixtures/desktop/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "start": "node --disable-warning=ExperimentalWarning setup.js",
+    "server": "node --disable-warning=ExperimentalWarning neural-interface/server.js",
+    "mcp:build": "npm --prefix mcp-server run build",
+    "test": "npm run test:mcp && npm run test:neural",
+    "test:mcp": "npm --prefix mcp-server test",
+    "test:neural": "npm --prefix neural-interface test",
+    "pack:check": "npm pack --dry-run --json --ignore-scripts",
+    "build:targets": "node packaging/build.mjs targets",
+    "build:mac:arm": "node packaging/build.mjs build --target macos-arm64",
+    "build:mac:intel": "node packaging/build.mjs build --target macos-x64",
+    "build:linux:x64": "node packaging/build.mjs build --target linux-x64",
+    "build:windows:x64": "node packaging/build.mjs build --target windows-x64",
+    "build:windows:x86": "node packaging/build.mjs build --target windows-x86",
+    "test:packaging": "node --test packaging/tests/*.test.mjs",
+    "postinstall": "node postinstall.js",
+    "preuninstall": "node preuninstall.js",
+    "prepublishOnly": "npm --prefix mcp-server ci --ignore-scripts && npm --prefix neural-interface ci --ignore-scripts && npm run mcp:build && npm test && node -e \"const fs = require('node:fs'); for (const path of ['mcp-server/dist/index.js', 'NOTICE', 'THIRD-PARTY-LICENSES.md']) fs.accessSync(path)\" && npm run pack:check"
+  },
+  "keywords": [
+    "ai-agents",
+    "browser-automation",
+    "claude-code",
+    "codex",
+    "embeddings",
+    "gemini",
+    "local-first",
+    "mcp",
+    "model-context-protocol",
+    "opencode",
+    "persistent-memory",
+    "sqlite",
+    "vector-search"
+  ],
+  "bugs": {
+    "url": "https://github.com/danilokhury/Synabun/issues"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  }
+}