trellis 3.1.34 → 3.2.0

package/CHANGELOG.md

@@ -1,6 +1,17 @@
 # Changelog
 
-## 3.1.32
+Notable changes by release date and version. See [trellis.computer/changelog](https://trellis.computer/changelog) for the public site copy.
+
+## trellis [3.2.0] — 2026-06-08
+
+- **Typed realtime SDK:** `trellis/schema` — `defineType`, `entityQuery`, `WhereFilter` operators, nested `InferResolvedType`, server `hydrateAndResolve` on subscription push.
+- **Live client:** `liveEntities` / `liveEntity` in `trellis/client` with id-scoped subscriptions (`entityQuery`) instead of full-type scans.
+- **Framework hooks:** `trellis/svelte/typed`, `trellis/vue/typed`, `trellis/react/typed` — typed `useEntities` / `useEntity` adapters.
+- **Studio plugin exports:** `trellis/plugins/plan-approval`, `proactive-watcher`, `idea-garden`, `agent-memory` ship in `dist/` for npm consumers (Trellis Studio / opencode).
+- **Ontology:** idempotent `registerType` — duplicate schema registration returns quietly (409 swallowed client-side).
+- **Realtime:** explorer graph-nav + collections demos; collab presence session lifecycle hardening.
+
+## trellis [3.1.32] — 2026-05-29
 
 - **Agent Lanes (W1–W4):** `trellis lane` — isolated per-agent op journals under `.trellis/lanes/`, `create` / `enter` / `leave` / `status` / `diff` / `promote` / `drop`.
 - **`trellis lane promote`:** replay lane ops onto integration with `--dry-run`, `--explain`, and hard/soft/file conflict detection.
@@ -10,7 +21,7 @@
 - **`getBranchHeadOpHash`:** latest `headOpHash` fact wins (fixes stale head during promote).
 - **Op log lock:** configurable timeout via `TRELLIS_OPLOG_LOCK_MS`.
 
-## 3.1.14
+## trellis [3.1.14] — 2026-05-22
 
 - CLI `trellis --version` now reports the real package version from `package.json` (was hardcoded `0.1.0`).
 - CLI `-p` / cwd resolution walks up to the nearest `.trellis` repo root (monorepo subfolders work without passing the root path).
@@ -18,7 +29,7 @@
 - `issue create` accepts `--description` as an alias for `--desc`.
 - `bin/trellis.mjs` launcher finds Homebrew Bun when Node's `PATH` is minimal (`npx trellis` / agent shells).
 
-## 3.1.2
+## trellis [3.1.2] — 2026-05-12
 
 - Fixed `trellis/cms` collection reads for inferred collections whose normalized key differs from the stored entity type casing, such as `blogpost` reading `BlogPost` entities.
 - Added graph-link awareness to CMS entries so reference links such as `post --author--> author` appear in `fields` and can be expanded.
@@ -29,10 +40,10 @@
 - Added CMS client/scaffold tests and included them in the default test script.
 - Added `directory` support to CMS consumer scaffolds for multi-instance opencode routing.
 
-## 3.1.1
+## trellis [3.1.1] — 2026-05-12
 
 - Published the first `trellis/cms` SDK package update after adding scaffold helpers.
 
-## 3.1.0
+## trellis [3.1.0] — 2026-05-12
 
 - Added the `trellis/cms` subpath with `createCmsClient`, collection reads, entry reads, polling subscriptions, reference expansion, collection discovery, and consumer scaffold helpers for vanilla, React, Solid, and Vue.

package/README.md

@@ -1,3 +1,10 @@
+---
+title: Trellis
+description: The Agentic Framework — a local-first semantic graph OS for code, agents, and decisions.
+created: 2026-05-30
+updated: 2026-06-05
+---
+
 # Trellis
 
 > **The Agentic Framework**
@@ -44,8 +51,9 @@ echo "# My Project" > README.md
 trellis issue create -t "Bootstrap Visualization"
 trellis milestone create -m "Initial Release"
 
-# 5. Launch the local web client to explore your semantic graph
-trellis web
+# 5. Launch the live graph explorer (SvelteKit + realtime sidecar)
+trellis ui
+# Legacy VCS-only visualizer: trellis ui --legacy --port 3333
 
 # 6. Create coding session with trellis harness
 trellis code
@@ -72,6 +80,15 @@ After running `trellis init`, you'll see a progressive disclosure success screen
 
 See the [CLI guide](https://trellis.computer/docs/cli) for complete documentation.
 
+### Typed SDK + realtime (React, Vue, Svelte)
+
+Reference apps and stable entrypoints: [docs/sdk-typed-realtime.md](./docs/sdk-typed-realtime.md).
+
+```bash
+just graph-nav           # typed live nav — examples/graph-nav
+just universal-presence  # presence, chat, text — examples/universal-presence
+```
+
 ---
 
 ## CMS Client SDK

package/bin/trellis.mjs

@@ -1,76 +1,3 @@
 #!/usr/bin/env node
-// Trellis CLI launcher.
-//
-// The bundled CLI in dist/ is built with `--target bun` and uses Bun-specific
-// APIs at runtime. This launcher works under either runtime:
-//   - If invoked by bun, it imports the bundle directly.
-//   - If invoked by node (the default for `npx trellis`), it re-execs the same
-//     script under bun. If bun is missing, it prints actionable install hints.
-
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { dirname, join, delimiter } from 'node:path';
-import { existsSync } from 'node:fs';
-
-const isWindows = process.platform === 'win32';
-
-if (process.versions?.bun) {
-  await import('../dist/cli/index.js');
-} else {
-  const bun =
-    findOnPath('bun') ??
-    findUserBun() ??
-    (existsSync('/opt/homebrew/bin/bun') ? '/opt/homebrew/bin/bun' : null);
-  if (!bun) {
-    process.stderr.write(
-      [
-        '',
-        'Trellis requires Bun to run.',
-        '',
-        'Install Bun:',
-        '  macOS/Linux:  curl -fsSL https://bun.sh/install | bash',
-        '  Windows:      powershell -c "irm bun.sh/install.ps1 | iex"',
-        '',
-        'More info: https://bun.sh',
-        '',
-      ].join('\n'),
-    );
-    process.exit(1);
-  }
-
-  const here = fileURLToPath(import.meta.url);
-  const result = spawnSync(bun, [here, ...process.argv.slice(2)], {
-    stdio: 'inherit',
-    env: process.env,
-  });
-  const code = result.status ?? 1;
-  if (code !== 0 && result.error) {
-    process.stderr.write(`${result.error.message}\n`);
-  }
-  process.exit(code);
-}
-
-function findOnPath(cmd) {
-  const PATH = process.env.PATH || '';
-  const exts = isWindows ? ['.exe', '.cmd', '.bat', ''] : [''];
-  for (const dir of PATH.split(isWindows ? ';' : delimiter)) {
-    if (!dir) continue;
-    for (const ext of exts) {
-      const p = join(dir, cmd + ext);
-      if (existsSync(p)) return p;
-    }
-  }
-  return null;
-}
-
-function findUserBun() {
-  const home = process.env.HOME || process.env.USERPROFILE;
-  if (!home) return null;
-  const candidates = isWindows
-    ? [join(home, '.bun', 'bin', 'bun.exe')]
-    : [join(home, '.bun', 'bin', 'bun')];
-  for (const p of candidates) {
-    if (existsSync(p)) return p;
-  }
-  return null;
-}
+// Trellis CLI launcher — runs under Node.js (>=20) or any WebContainer.
+import '../dist/cli/index.js';

package/dist/better-sqlite-backend-2P4F6AOJ.js

@@ -0,0 +1,209 @@
+import {
+  __require
+} from "./chunk-KFQGP6VL.js";
+
+// src/core/persist/better-sqlite-backend.ts
+var SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS ops (
+  hash TEXT PRIMARY KEY,
+  kind TEXT NOT NULL,
+  timestamp TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  previous_hash TEXT,
+  payload TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS snapshots (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  last_op_hash TEXT NOT NULL,
+  data TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS blobs (
+  hash TEXT PRIMARY KEY,
+  content BLOB NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_ops_kind ON ops(kind);
+CREATE INDEX IF NOT EXISTS idx_ops_timestamp ON ops(timestamp);
+CREATE INDEX IF NOT EXISTS idx_ops_agent ON ops(agent_id);
+CREATE INDEX IF NOT EXISTS idx_ops_previous ON ops(previous_hash);
+CREATE INDEX IF NOT EXISTS idx_snapshots_op ON snapshots(last_op_hash);
+`;
+var BetterSqliteKernelBackend = class {
+  db;
+  _stmts;
+  _initialized = false;
+  constructor(dbPath) {
+    try {
+      const createRequire = __require("module").createRequire;
+      const req = createRequire(__filename);
+      const Database = req("better-sqlite3");
+      this.db = new Database(dbPath);
+    } catch (e) {
+      throw new Error(
+        `Failed to initialize SQLite backend: ${e instanceof Error ? e.message : "Unknown error"}. Ensure better-sqlite3 is installed: npm install better-sqlite3`
+      );
+    }
+  }
+  _prepareStatements() {
+    const db = this.db;
+    this._stmts = {
+      insert: db.prepare(
+        "INSERT OR REPLACE INTO ops (hash, kind, timestamp, agent_id, previous_hash, payload) VALUES (?, ?, ?, ?, ?, ?)"
+      ),
+      readAll: db.prepare("SELECT * FROM ops ORDER BY timestamp ASC"),
+      readUntil: db.prepare(
+        "SELECT * FROM ops WHERE rowid <= (SELECT rowid FROM ops WHERE hash = ?) ORDER BY rowid ASC"
+      ),
+      readAfter: db.prepare(
+        "SELECT * FROM ops WHERE rowid > (SELECT rowid FROM ops WHERE hash = ?) ORDER BY rowid ASC"
+      ),
+      getByHash: db.prepare("SELECT * FROM ops WHERE hash = ?"),
+      getLast: db.prepare("SELECT * FROM ops ORDER BY timestamp DESC LIMIT 1"),
+      count: db.prepare("SELECT COUNT(*) as count FROM ops"),
+      saveSnapshot: db.prepare(
+        "INSERT INTO snapshots (last_op_hash, data, created_at) VALUES (?, ?, ?)"
+      ),
+      loadLatestSnapshot: db.prepare(
+        "SELECT * FROM snapshots ORDER BY id DESC LIMIT 1"
+      ),
+      putBlob: db.prepare(
+        "INSERT OR REPLACE INTO blobs (hash, content) VALUES (?, ?)"
+      ),
+      getBlob: db.prepare("SELECT content FROM blobs WHERE hash = ?"),
+      hasBlob: db.prepare("SELECT 1 FROM blobs WHERE hash = ?")
+    };
+  }
+  init() {
+    if (this._initialized) return;
+    this.db.exec(SCHEMA_SQL);
+    this._prepareStatements();
+    this._initialized = true;
+  }
+  append(op) {
+    const payload = JSON.stringify({
+      facts: op.facts,
+      links: op.links,
+      deleteFacts: op.deleteFacts,
+      deleteLinks: op.deleteLinks
+    });
+    this._stmts.insert.run(
+      op.hash,
+      op.kind,
+      op.timestamp,
+      op.agentId,
+      op.previousHash ?? null,
+      payload
+    );
+  }
+  appendBatch(ops) {
+    for (const op of ops) {
+      this.append(op);
+    }
+  }
+  readAll() {
+    const rows = this._stmts.readAll.all();
+    return rows.map(this._rowToOp);
+  }
+  readUntil(opHash) {
+    const row = this._stmts.getByHash.get(opHash);
+    if (!row) return [];
+    const rows = this._stmts.readUntil.all(opHash);
+    return rows.map(this._rowToOp);
+  }
+  readUntilTimestamp(isoTimestamp) {
+    const rows = this.db.prepare("SELECT * FROM ops WHERE timestamp <= ? ORDER BY timestamp ASC").all(isoTimestamp);
+    return rows.map(this._rowToOp);
+  }
+  readAfter(opHash) {
+    const row = this._stmts.getByHash.get(opHash);
+    if (!row) return this.readAll();
+    const rows = this._stmts.readAfter.all(opHash);
+    return rows.map(this._rowToOp);
+  }
+  getByHash(hash) {
+    return this.getOpByHash(hash);
+  }
+  getOpByHash(hash) {
+    const row = this._stmts.getByHash.get(hash);
+    return row ? this._rowToOp(row) : void 0;
+  }
+  getLastOp() {
+    const row = this._stmts.getLast.get();
+    return row ? this._rowToOp(row) : void 0;
+  }
+  getOpCount() {
+    const row = this._stmts.count.get();
+    return row?.count ?? 0;
+  }
+  count() {
+    return this.getOpCount();
+  }
+  saveSnapshot(lastOpHash, data) {
+    this._stmts.saveSnapshot.run(
+      lastOpHash,
+      JSON.stringify(data),
+      (/* @__PURE__ */ new Date()).toISOString()
+    );
+  }
+  loadLatestSnapshot() {
+    const row = this._stmts.loadLatestSnapshot.get();
+    if (!row) return void 0;
+    return {
+      lastOpHash: row.last_op_hash,
+      data: JSON.parse(row.data)
+    };
+  }
+  putBlob(hash, content) {
+    this._stmts.putBlob.run(hash, Buffer.from(content));
+  }
+  getBlob(hash) {
+    const row = this._stmts.getBlob.get(hash);
+    if (!row) return void 0;
+    return new Uint8Array(row.content);
+  }
+  hasBlob(hash) {
+    const row = this._stmts.hasBlob.get(hash);
+    return !!row;
+  }
+  findCommonAncestor(hashA, hashB) {
+    const ancestorsA = /* @__PURE__ */ new Set();
+    let cursor = hashA;
+    while (cursor) {
+      ancestorsA.add(cursor);
+      const op = this.getOpByHash(cursor);
+      cursor = op?.previousHash;
+    }
+    cursor = hashB;
+    while (cursor) {
+      if (ancestorsA.has(cursor)) {
+        return this.getOpByHash(cursor);
+      }
+      const op = this.getOpByHash(cursor);
+      cursor = op?.previousHash;
+    }
+    return void 0;
+  }
+  close() {
+    this.db?.close();
+  }
+  _rowToOp(row) {
+    const payload = JSON.parse(row.payload);
+    return {
+      hash: row.hash,
+      kind: row.kind,
+      timestamp: row.timestamp,
+      agentId: row.agent_id,
+      previousHash: row.previous_hash ?? void 0,
+      facts: payload.facts,
+      links: payload.links,
+      deleteFacts: payload.deleteFacts,
+      deleteLinks: payload.deleteLinks
+    };
+  }
+};
+export {
+  BetterSqliteKernelBackend
+};

package/dist/{better-sqlite-backend-ahx5p0br.js → better-sqlite-backend-PII64VE6.js}

@@ -1,10 +1,8 @@
-// @bun
 import {
   __require
-} from "./index-a76rekgs.js";
+} from "./chunk-KFQGP6VL.js";
 
 // src/core/persist/better-sqlite-backend.ts
-var __filename = "/Users/trentbrew/TURTLE/Projects/Packages/trellis-package/src/core/persist/better-sqlite-backend.ts";
 var SCHEMA_SQL = `
 CREATE TABLE IF NOT EXISTS ops (
   hash TEXT PRIMARY KEY,
@@ -33,8 +31,7 @@ CREATE INDEX IF NOT EXISTS idx_ops_agent ON ops(agent_id);
 CREATE INDEX IF NOT EXISTS idx_ops_previous ON ops(previous_hash);
 CREATE INDEX IF NOT EXISTS idx_snapshots_op ON snapshots(last_op_hash);
 `;
-
-class BetterSqliteKernelBackend {
+var BetterSqliteKernelBackend = class {
   db;
   _stmts;
   _initialized = false;
@@ -45,27 +42,38 @@ class BetterSqliteKernelBackend {
       const Database = req("better-sqlite3");
       this.db = new Database(dbPath);
     } catch (e) {
-      throw new Error(`Failed to initialize SQLite backend: ${e instanceof Error ? e.message : "Unknown error"}. ` + "Ensure better-sqlite3 is installed: npm install better-sqlite3");
+      throw new Error(
+        `Failed to initialize SQLite backend: ${e instanceof Error ? e.message : "Unknown error"}. Ensure better-sqlite3 is installed: npm install better-sqlite3`
+      );
     }
     this._stmts = this._prepareStatements();
   }
   _prepareStatements() {
     const db = this.db;
     return {
-      insert: db.prepare("INSERT OR REPLACE INTO ops (hash, kind, timestamp, agent_id, previous_hash, payload) VALUES (?, ?, ?, ?, ?, ?)"),
+      insert: db.prepare(
+        "INSERT OR REPLACE INTO ops (hash, kind, timestamp, agent_id, previous_hash, payload) VALUES (?, ?, ?, ?, ?, ?)"
+      ),
       readAll: db.prepare("SELECT * FROM ops ORDER BY timestamp ASC"),
-      readUntil: db.prepare("SELECT * FROM ops WHERE timestamp <= (SELECT timestamp FROM ops WHERE hash = ?) ORDER BY timestamp ASC"),
-      readAfter: db.prepare("SELECT * FROM ops WHERE timestamp > (SELECT timestamp FROM ops WHERE hash = ?) ORDER BY timestamp ASC"),
+      readUntil: db.prepare(
+        "SELECT * FROM ops WHERE timestamp <= (SELECT timestamp FROM ops WHERE hash = ?) ORDER BY timestamp ASC"
+      ),
+      readAfter: db.prepare(
+        "SELECT * FROM ops WHERE timestamp > (SELECT timestamp FROM ops WHERE hash = ?) ORDER BY timestamp ASC"
+      ),
       getByHash: db.prepare("SELECT * FROM ops WHERE hash = ?"),
       getLast: db.prepare("SELECT * FROM ops ORDER BY timestamp DESC LIMIT 1"),
       count: db.prepare("SELECT COUNT(*) as count FROM ops"),
-      saveSnapshot: db.prepare("INSERT INTO snapshots (last_op_hash, data, created_at) VALUES (?, ?, ?)"),
-      loadLatestSnapshot: db.prepare("SELECT * FROM snapshots ORDER BY id DESC LIMIT 1")
+      saveSnapshot: db.prepare(
+        "INSERT INTO snapshots (last_op_hash, data, created_at) VALUES (?, ?, ?)"
+      ),
+      loadLatestSnapshot: db.prepare(
+        "SELECT * FROM snapshots ORDER BY id DESC LIMIT 1"
+      )
     };
   }
   init() {
-    if (this._initialized)
-      return;
+    if (this._initialized) return;
     this.db.exec(SCHEMA_SQL);
     this._initialized = true;
   }
@@ -76,7 +84,14 @@ class BetterSqliteKernelBackend {
       deleteFacts: op.deleteFacts,
       deleteLinks: op.deleteLinks
     });
-    this._stmts.insert.run(op.hash, op.kind, op.timestamp, op.agentId, op.previousHash ?? null, payload);
+    this._stmts.insert.run(
+      op.hash,
+      op.kind,
+      op.timestamp,
+      op.agentId,
+      op.previousHash ?? null,
+      payload
+    );
   }
   readAll() {
     const rows = this._stmts.readAll.all();
@@ -84,8 +99,7 @@ class BetterSqliteKernelBackend {
   }
   readUntil(opHash) {
     const row = this._stmts.getByHash.get(opHash);
-    if (!row)
-      return [];
+    if (!row) return [];
     const rows = this._stmts.readUntil.all(opHash);
     return rows.map(this._rowToOp);
   }
@@ -95,30 +109,28 @@ class BetterSqliteKernelBackend {
   }
   readAfter(opHash) {
     const row = this._stmts.getByHash.get(opHash);
-    if (!row)
-      return this.readAll();
+    if (!row) return this.readAll();
     const rows = this._stmts.readAfter.all(opHash);
     return rows.map(this._rowToOp);
   }
   getByHash(hash) {
     const row = this._stmts.getByHash.get(hash);
-    return row ? this._rowToOp(row) : undefined;
+    return row ? this._rowToOp(row) : void 0;
   }
   getLastOp() {
     const row = this._stmts.getLast.get();
-    return row ? this._rowToOp(row) : undefined;
+    return row ? this._rowToOp(row) : void 0;
   }
   getOpCount() {
     const row = this._stmts.count.get();
     return row?.count ?? 0;
   }
   saveSnapshot(hash, data) {
-    this._stmts.saveSnapshot.run(hash, data, new Date().toISOString());
+    this._stmts.saveSnapshot.run(hash, data, (/* @__PURE__ */ new Date()).toISOString());
   }
   loadLatestSnapshot() {
     const row = this._stmts.loadLatestSnapshot.get();
-    if (!row)
-      return;
+    if (!row) return void 0;
     return {
       lastOpHash: row.last_op_hash,
       data: row.data
@@ -134,14 +146,14 @@ class BetterSqliteKernelBackend {
       kind: row.kind,
       timestamp: row.timestamp,
       agentId: row.agent_id,
-      previousHash: row.previous_hash ?? undefined,
+      previousHash: row.previous_hash ?? void 0,
       facts: payload.facts,
       links: payload.links,
       deleteFacts: payload.deleteFacts,
       deleteLinks: payload.deleteLinks
     };
   }
-}
+};
 export {
   BetterSqliteKernelBackend
 };