trellis 3.2.0 → 3.2.2

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Notable changes by release date and version. See [trellis.computer/changelog](https://trellis.computer/changelog) for the public site copy.
 
+## trellis [3.2.2] — 2026-06-10
+
+- **`trellis db serve` on Node:** preloads the default tenant with sql.js / better-sqlite3 before accepting traffic — fixes `create-trellis` scaffolds and any `npx trellis db serve` flow that hit `SqliteKernelBackend requires the Bun runtime`.
+- **`TenantPool.get()` on Node:** fails fast with a preload hint instead of attempting `bun:sqlite`.
+- **`TRELLIS_BACKEND`:** `sqljs` or `better-sqlite` env override for `db serve` and custom hosts (`resolvePoolBackendFromEnv`).
+- **Gitignore:** `.trellis-db/`, `.trellis-db.json`, `.trellis-deploy/` at repo root.
+
 ## trellis [3.2.0] — 2026-06-08
 
 - **Typed realtime SDK:** `trellis/schema` — `defineType`, `entityQuery`, `WhereFilter` operators, nested `InferResolvedType`, server `hydrateAndResolve` on subscription push.

package/README.md

@@ -1,209 +1,99 @@
----
-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**
-
-| Use Case                       | How                                                                                                       |
-| :----------------------------- | :-------------------------------------------------------------------------------------------------------- |
-| **Agentic State Engine**       | Tool registry + decision traces + branching — agents operate on state they can fork, audit, and roll back |
-| **Building Agents End-to-End** | Unified LLM abstraction + context management + RAG + orchestration                                        |
-| **Autonomous Code Editing**    | Semantic patching + AST-aware tools + causal history                                                      |
-| **Auditable Reasoning**        | Immutable op log + decision traces + precedent search                                                     |
+<div align="center">
+  <img src="./logo.svg" alt="Trellis" width="88" height="88" />
+  <h1>Trellis</h1>
+  <p><strong>The Agentic Framework</strong> — a local-first, event-sourced graph engine for code, agents, and decisions.</p>
+  <p>
+    <a href="https://trellis.computer">Docs</a> ·
+    <a href="https://studio.trellis.computer">Studio</a> ·
+    <a href="https://github.com/trentbrew/trellis">GitHub</a>
+  </p>
+</div>
 
 ---
 
-## Why Trellis?
-
-Most agent frameworks focus on the _reasoning engine_ (the LLM) but treat _state_ as an afterthought. Trellis reverses this. It is the **System of Record for Decisions**, providing agents with a persistent, queryable, and auditable memory that compounds over time.
+Most agent frameworks pour everything into the reasoning engine and treat state as an afterthought. Trellis inverts that. It is the **system of record for decisions**: a persistent, queryable, auditable memory where every thought, tool call, and file change is an immutable operation in a causal graph. It runs fully offline — servers may relay, accelerate, or back up, but never own your state.
 
-**[Read the story →](./docs/THE-STORY.md)**
+- **Durable memory** — every op is content-addressed and never rewritten or deleted.
+- **Explainable by default** — decision traces record not just *what* happened, but *why*.
+- **Safe to explore** — branch state to try multiple paths, then merge or discard.
+- **Realtime** — one write updates current state, durable history, and every live subscriber.
 
-- **Durable Memory**: Every thought, tool call, and file change is an immutable operation in a causal graph
-- **Explainability by Default**: Decision traces don't just store _what_ happened, but _why_
-- **Safe Exploration**: Agents can "fork" state to explore multiple paths
-
----
-
-## Quick Start
+## Install
 
 ```bash
-# 1. Install
 npm install -g trellis
-
-# 2. Initialize a repository
-mkdir my-project && cd my-project
-trellis init
-
-# The init command now offers two paths:
-# ⚡ Minimal Setup: One-shot setup with auto-detected defaults
-# 🔧 Custom Guided Setup: Full control over framework, IDEs, and features
-
-# 3. Create content (tracked automatically)
-echo "# My Project" > README.md
-
-# 4. Add structured entities
-trellis issue create -t "Bootstrap Visualization"
-trellis milestone create -m "Initial Release"
-
-# 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
 ```
 
-After running `trellis init`, you'll see a progressive disclosure success screen:
-
-**Next steps (VCS):**
-
-- `trellis status` — Check repository status
-- `trellis log` — View recent history
-- `trellis branch` — List or create branches
-- `trellis milestone` — Create narrative checkpoints
-- `trellis garden` — Discover abandoned work
-- `trellis issue` — Create and track issues
-
-**Semantic Substrate (Live local services):**
-
-- `trellis web` — Launch local web client / graph visualizer
-- `trellis query` — Run EQL-S semantic queries against your code graph
-- Agent Rules — Active for your IDE. Agents will auto-detect the graph.
-
-![Trellis Demo](./trellis-opencode.gif)
-
-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).
+## Quick start
 
 ```bash
-just graph-nav           # typed live nav — examples/graph-nav
-just universal-presence  # presence, chat, text — examples/universal-presence
+mkdir my-project && cd my-project
+trellis init      # guided or one-shot setup
+trellis ui        # live graph explorer
+trellis code      # start an agent coding session
 ```
 
----
-
-## CMS Client SDK
+Track work as graph-native entities instead of text commits:
 
-Use `trellis/cms` from browser apps to read content from a Trellis-compatible HTTP server such as opencode at `http://localhost:4096`.
-
-```typescript
-import { createCmsClient } from 'trellis/cms';
-
-const cms = createCmsClient({
-  url: 'http://localhost:4096',
-  directory: '/path/to/project',
-});
+```bash
+trellis issue create -t "Bootstrap viz"
+trellis milestone create -m "Initial release"
+trellis garden                          # discover & revive abandoned work
+trellis query 'find ?e where type = "Task"'
+```
 
-const posts = await cms.collection('blogpost').list({
-  status: 'all',
-  expand: ['author'],
-});
+## Build a realtime app
 
-const off = cms.collection('blogpost').subscribe(
-  (entries) => {
-    console.log(entries);
-  },
-  {
-    status: 'published',
-    onError: console.error,
-  },
-);
+Scaffold a typed, live-graph app — React, Vue, or Svelte — backed by Trellis:
 
-off();
+```bash
+npm create trellis@latest
 ```
 
-- **Collections**: `cms.collections()` returns `TypeSchema` collections marked with `cms=true`.
-- **Schema**: `cms.collection('blogpost').schema()` returns field definitions including types, labels, requirements, formulas, and targets.
-- **Normalized keys**: `cms.collection('blogpost')` matches stored entity types like `BlogPost`.
-- **References**: `expand` resolves reference ids from facts and graph links into nested entries.
-- **Scaffolds**: `scaffoldConsumer({ collection, framework, directory })` generates starter consumer code for vanilla, React, Solid, or Vue.
-
----
-
-## What is Trellis?
+```ts
+import { defineType } from 'trellis/schema';
+import { z } from 'zod';
 
-Trellis is an **event-sourced causal graph engine** that unifies version control, knowledge management, and semantic analysis. Every action is an immutable operation in a causal stream:
+export const Task = defineType('Task', { title: z.string(), done: z.boolean() });
+```
 
-```typescript
-interface VcsOp {
-  hash: string; // content-addressed
-  kind: VcsOpKind; // e.g. 'vcs:fileModify'
-  timestamp: string; // ISO 8601
-  agentId: string; // Author identity
-  previousHash?: string; // Causal chain link
-  vcs: VcsPayload; // Op-specific data
-  signature?: string; // Ed25519 signature
-}
+```svelte
+<script>
+  import { entitiesStore, mutations } from 'trellis/svelte/typed';
+  const tasks = entitiesStore(client, Task);  // re-renders live, across every client
+  const task = mutations(client, Task);
+</script>
 ```
 
-Ops are written to `.trellis/ops.json` and **never rewritten or deleted**.
+A single mutation produces current state, durable history, and a realtime push to every subscriber — the same write path.
 
-### Platform Surfaces
+## API surface
 
-| Surface               | Purpose                                  |
-| :-------------------- | :--------------------------------------- |
-| `trellis` npm package | Core platform APIs via subpaths          |
-| `trellis` CLI         | Repository management and automation     |
-| VS Code extension     | Visual timeline and knowledge navigation |
+The `trellis` package exposes focused subpaths:
 
----
+| Import | Purpose |
+| --- | --- |
+| `trellis/client` | Local + remote client SDK |
+| `trellis/schema` | `defineType`, typed entities, EQL-S queries |
+| `trellis/{react,vue,svelte}/typed` | Live, schema-typed reads + mutations |
+| `trellis/realtime` | Presence, chat, CRDT text |
+| `trellis/cms` | Read content collections over HTTP |
+| `trellis/server` | HTTP + WebSocket DB server |
 
 ## Documentation
 
-- **[Documentation hub](./docs/README.md)** — Canonical docs index for Trellis
-- **[The Story](./docs/THE-STORY.md)** — Why Trellis exists
-- **[Vision](./docs/VISION.md)** — Local-first agentic OS framing
-- **[Architecture](./docs/ARCHITECTURE.md)** — Current package layout and target runtime shape
-- **[Five Pillars](./docs/PILLARS.md)** — Core architectural principles
-- **[Design spec](./docs/DESIGN.md)** — Full architecture specification
-- **[Roadmap](./docs/ROADMAP.md)** — Active Trellis issue and milestone sequence
-- **[Agents guide](./docs/AGENTS.md)** — Building agents on Trellis
-- **[Full documentation](https://trellis.computer)** — Published docs site
-- **[CLI reference](./docs/README-ARCHIVED.md#cli-overview)** — Command details (archived)
-- **[API modules](./docs/README-ARCHIVED.md#module--subpath-guide)** — Subpath imports (archived)
-
----
+- **[trellis.computer](https://trellis.computer)** — full documentation
+- **[The Story](./docs/THE-STORY.md)** — why Trellis exists
+- **[Architecture](./docs/ARCHITECTURE.md)** · **[Design spec](./docs/DESIGN.md)** · **[Roadmap](./docs/ROADMAP.md)**
 
-## Development
+## Develop
 
 ```bash
-# Prerequisites
-# Requires Bun ≥ 1.0
-
-# Install dependencies
-bun install
-
-# Run tests
+bun install   # requires Bun ≥ 1.0
 bun test
-
-# Build for npm
 bun run build
 ```
 
----
-
-## Status
-
-| Phase | Deliverable                | Status |
-| :---- | :------------------------- | :----- |
-| P0    | Causal stream + CLI        | ✅     |
-| P0.5  | VS Code extension          | ✅     |
-| P1    | Git import bridge          | ✅     |
-| P2    | Branches, milestones       | ✅     |
-| P2.5  | Blob store, modularization | ✅     |
-| P3    | File-level diff + merge    | ✅     |
-| P4    | Identity + governance      | ✅     |
-| P5    | Idea Garden                | ✅     |
-
----
+## License
 
-_For comprehensive documentation including detailed CLI commands, API examples, and subsystem guides, see [docs/README-ARCHIVED.md](./docs/README-ARCHIVED.md)._
+[AGPL-3.0-or-later](./LICENSE) © Turtle Labs LLC

package/dist/browser/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Trellis Browser — remote DB, schema, realtime, and live-read primitives.
+ *
+ * Import from `trellis/browser` in browser applications to avoid Node/server
+ * modules such as filesystem config, embedded tenancy, or local SQLite.
+ *
+ * @module trellis/browser
+ */
+export { TrellisDb, FetchError } from '../client/sdk.browser.js';
+export type { AuthResult, EntityData, ListResult, QueryResult, Subscription, SubscriptionCallback, TrellisDbLocalOptions, TrellisDbOptions, TrellisDbRemoteOptions, UploadResult, } from '../client/sdk.browser.js';
+export { Signal, BatchSignal } from '../client/reactive.js';
+export { liveQuery, liveEntities, liveEntity } from '../client/live.js';
+export type { LiveEntitiesOptions, LiveEntityOptions, LiveResource, ReadState, } from '../client/live.js';
+export { defineType, rel, rollup, formula, entitiesQuery, entityQuery, escapeValue, formatEqlLiteral, isWhereFilter, whereCondition, entityMutations, resolveRelations, inverseForeignKey, bindingEntityId, bindingToEntity, entityRecordToPlain, hydrateBindings, isSparseBinding, } from '../schema/index.js';
+export type { AnyType, ComputedField, ComputedMap, DefineTypeOptions, EntityMutations, InferEntitiesRead, InferEntityRead, InferResolvedType, InferType, Ref, Relation, RelationMap, RelTarget, ResolveSpec, ResolveSpecFor, TrellisType, WhereFilter, WhereInput, WhereOp, WhereValue, } from '../schema/index.js';
+export { RealtimeRoom, MemoryHub, MemoryRealtimeTransport, BroadcastChannelTransport, WebSocketRelayTransport, DurableObjectRelayTransport, joinPresence, createPresenceTransport, PersistentChannel, localStorageChannelStore, DEFAULT_MAX_RECORDS, RealtimeText, REALTIME_PROTOCOL, } from '../realtime/index.js';
+export type { BroadcastChannelTransportOptions, BroadcastEvent, ChannelRecord, ChannelStore, DurableObjectRelayReconnect, DurableObjectRelayTransportOptions, PersistentChannelOptions, PresenceOptions, PresencePeer, PresenceState, RealtimeMessage, RealtimeRoomOptions, RealtimeTransport, RealtimeTextOptions, TextNode, TextOp, WebSocketRelayTransportOptions, } from '../realtime/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,EACV,GAAG,EACH,MAAM,EACN,OAAO,EACP,aAAa,EACb,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,OAAO,EACP,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,GAAG,EACH,QAAQ,EACR,WAAW,EACX,SAAS,EACT,WAAW,EACX,cAAc,EACd,WAAW,EACX,WAAW,EACX,UAAU,EACV,OAAO,EACP,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gCAAgC,EAChC,cAAc,EACd,aAAa,EACb,YAAY,EACZ,2BAA2B,EAC3B,kCAAkC,EAClC,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,MAAM,EACN,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,95 @@
+import {
+  liveEntities,
+  liveEntity,
+  liveQuery
+} from "../chunk-J3WYZO3Q.js";
+import "../chunk-WXSWA3MV.js";
+import {
+  entityMutations
+} from "../chunk-USEINYUL.js";
+import {
+  defineType,
+  formula,
+  rel,
+  rollup
+} from "../chunk-44FFQKQX.js";
+import {
+  bindingEntityId,
+  bindingToEntity,
+  entitiesQuery,
+  entityQuery,
+  entityRecordToPlain,
+  escapeValue,
+  formatEqlLiteral,
+  hydrateBindings,
+  inverseForeignKey,
+  isSparseBinding,
+  isWhereFilter,
+  resolveRelations,
+  whereCondition
+} from "../chunk-JUEMDWLU.js";
+import {
+  FetchError,
+  TrellisDb
+} from "../chunk-J2TXUFCZ.js";
+import {
+  BroadcastChannelTransport,
+  DEFAULT_MAX_RECORDS,
+  DurableObjectRelayTransport,
+  MemoryHub,
+  MemoryRealtimeTransport,
+  PersistentChannel,
+  REALTIME_PROTOCOL,
+  RealtimeRoom,
+  RealtimeText,
+  WebSocketRelayTransport,
+  createPresenceTransport,
+  joinPresence,
+  localStorageChannelStore
+} from "../chunk-KSU2GW22.js";
+import "../chunk-GFZCJ4EH.js";
+import {
+  BatchSignal,
+  Signal
+} from "../chunk-UBGUDMUV.js";
+import "../chunk-KFQGP6VL.js";
+export {
+  BatchSignal,
+  BroadcastChannelTransport,
+  DEFAULT_MAX_RECORDS,
+  DurableObjectRelayTransport,
+  FetchError,
+  MemoryHub,
+  MemoryRealtimeTransport,
+  PersistentChannel,
+  REALTIME_PROTOCOL,
+  RealtimeRoom,
+  RealtimeText,
+  Signal,
+  TrellisDb,
+  WebSocketRelayTransport,
+  bindingEntityId,
+  bindingToEntity,
+  createPresenceTransport,
+  defineType,
+  entitiesQuery,
+  entityMutations,
+  entityQuery,
+  entityRecordToPlain,
+  escapeValue,
+  formatEqlLiteral,
+  formula,
+  hydrateBindings,
+  inverseForeignKey,
+  isSparseBinding,
+  isWhereFilter,
+  joinPresence,
+  liveEntities,
+  liveEntity,
+  liveQuery,
+  localStorageChannelStore,
+  rel,
+  resolveRelations,
+  rollup,
+  whereCondition
+};