Changelog

Notable changes by release date and version. Unless noted, versions are npm package releases.

Dates for published npm versions come from the registry. Unpublished workspace-only bumps use the date that version landed in kernel/ or studio/. Studio detail: Features, What's new.

trellis 4.0.0 2026-08-04

Git is sole authority over file bytes (ADR 0038)

Breaking: the op-log can no longer write file state. Git owns bytes on disk; the causal stream holds provenance — milestones, decisions, lane lifecycle, and non-materializing vcs:gitSync annotations.

• trellis git sync commits the working tree as-is. Sync no longer reconstructs files from op-log blobs, which fixes silent reverts where stale op-log state overwrote newer disk content.
• Lane promote delivers bytes via git merge (lane branch → integration), then rechains annotation ops onto integration. Real merge conflicts abort before replay.
• Lane worktrees are git checkouts. Entering a lane auto-commits agent bytes onto the lane branch; re-entry loads files from git. With lanes.worktreeBind, one agent's revert/reset cannot touch another agent's files.

Breaking changes

• GitSyncResult.refused and reason removed — sync never refuses.
• trellis git sync does not journal previously-unjournaled disk edits — tracked file changes flow through git commits, not file-materializing ops.

Fixes

• trellis lane list -p <dir> resolved from the shell cwd instead of the target path, so -p now matches every other lane subcommand.

Docs: Git Bridge, Agent coordination.

trellis 3.5.0 2026-08-02

Headless UI layer (ADR 0034)

• Behavior cores + thin adapters. UI affordances ship as framework-free, Node-testable state machines with React/Vue/Svelte/vanilla adapters. Public surface: trellis/palette, dialog, combobox, kanban, table, editor, forms, upload, colorpicker, undo-history, timeline (each with /react|vue|svelte|vanilla subpaths) + trellis/headless bridge.
• Component registry + admin Components panel.trellis/admin now renders any headless component in isolation — live state, actions, reset — in the inspector rail's Components tab.
• Dynamic kanban. The admin's static board is now a createKanbanCore projection: group by any attribute, first-class column operations, and one-op card moves (undoable).
• TrellisDb local mode on Node (no server, no Bun required).
• Schema resolved types no longer widen one-vs-many relations.

Docs: Headless UI components, Studio what's new.

trellis 3.4.0 2026-07-24

Lane hash verification (breaking)

• Lane ops failed hash verification — fixed.laneId was stamped into the hashed vcs payload after the hash was computed, so lane journal ops could not verify or sync. VcsOp.laneId is now envelope data (outside the preimage). Existing lane journals are migrated in place when opened.
• Criterion removal:trellis issue ac-rm <id> <index> retracts acceptance criteria by tombstone (not delete — ids must not be reused).
• Promote gate:promote.require now includes check (pnpm run check) in addition to smoke tests.

Docs: Issue tracking, CLI commands.

Promote, lanes, and safety

• Lane promote reliability: snapshot-head invariant and coordination hard-conflict skip reduce spurious "Integration head moved during promote" failures on issue-branch closes.
• trellis lane split: open a domain lane without requiring an issue.
• trellis milestone --commit: auto-commit to git on integration after milestone create (integration branch only).
• trellis doctor: probe mutation safety before contested writes.
• Op log: append-only JSONL mirror and destructive-write guards.

TML runtime

• Attribute projection on /tml-lanes; PeerDriver materializes ops and queries with TQL; Phase 4 vantage shell resolution; slimmer browser bundles.

Theme

• Unified theme contract Phase C — fractal vantage + shell morph; runtime theme scrubber hardening.

In development

• trellis admin operator console — active on main in the kernel repo; not yet prebundled for global npm install. Use a repo checkout for the admin UI. Kernel/VCS/TML CLI improvements are the 3.4.0 npm story.

trellis 3.3.0 2026-07-14

Canonical op hashing + provenance (ADR 0021)

• One serializer for mint and persist (core/persist/canonical-op.ts); op hashes are recomputable content addresses.
• verifyOpHash(op) returns { valid, legacy } — v1 ops grandfathered.
• Op provenance (actorType, origin) and Fact.meta ride inside hashed payloads.
• CLI graph writes carry provenance on VcsPayload (no kernel migration).
• VcsMiddleware removed — was never wired; decomposition runs inline in engine.ts.

Breaking: kernel.mutate uses payload.provenance (not meta); VcsMiddleware no longer exported from trellis/vcs.

trellis 3.2.6 2026-07-11

Pairing and sprite relay

• QR pairing (ADR 0020):trellis pair start|join|approve with terminal QR (via uqr).
• Sprite relay blobs (ADR 0016): deploy entrypoints can mount presenceRelay with blobStore so /blob is available on *.sprites.app alongside /rt.
• BlobStore export from trellis/server for deploy embedders.

Docs: Cloud hosting.

trellis 3.2.5 2026-07-11

Agent coordination

• Session lanes:trellis lane ensure --session <id>; Cursor hooks for tab isolation.
• Issue claims + promote lock: one session per in-progress issue; repo-wide promote mutex.
• Git adapter:trellis git sync [--push]; auto-sync on promote when git.syncOnPromote (default on init).
• Init defaults:lanes.worktreeBind and git.syncOnPromote written on every trellis init.
• Lane watch:trellis lane watch — SSE dashboard at :3939.
• Test manifest:.trellis/tests.json, trellis test, lane promote --require-test.
• Issue close: auto-promote by default; --no-promote, --push.

Docs: Agent coordination, CLI commands, Git Bridge.

trellis 3.2.3 2026-06-29

Agent lane worktree bind (W5)

• lanes.worktreeBind: optional per-lane git worktree at .trellis/worktrees/<shortId>/ on lane create.
• enterLane: materializes lane file blobs to the bound worktree; file watcher rebinds.
• dropLane: removes provisioned worktrees.
• ADR 0014: git materialization + lane worktrees (kernel/docs/adr/0014-git-materialization-and-lane-worktrees.md).

Docs: VCS API, CLI commands.

trellis 3.2.0 2026-06-08

Typed realtime SDK

• trellis/schema:defineType, entityQuery, WhereFilter operators, nested InferResolvedType, entityMutations.
• Live reads:liveEntities / liveEntity in trellis/client with id-scoped subscriptions and server-side hydrateAndResolve.
• Framework hooks:trellis/vue/typed, trellis/react/typed, trellis/svelte/typed.
• Ontology: idempotent registerType (duplicate schema registration is quiet).
• Studio npm exports:trellis/plugins/plan-approval, proactive-watcher, idea-garden, agent-memory in dist/.

Docs: Typed SDK guide, Schema API, Typed bindings.

Docs (trellis.computer)

• Typed SDK guide and API pages for schema + typed framework bindings.
• Changelog and version table updated for 3.2.0 / turtlecode 0.3.61.

trellis 3.1.35 2026-05-30

Kernel / CLI

• Issue parent links:trellis issue create --parent, issue list --parent, issue update --parent / --clear-parent. See Issue tracking.

turtlecode 0.3.61 2026-06-08 · Trellis Studio

Engine integration

• Pins trellis@^3.4.0 (typed SDK, plugin dist exports, dist-only npm consumption).
• Opencode imports use package exports (trellis, trellis/core, trellis/vcs) instead of src/ paths.
• Release validation: bun script/sync-trellis-core.ts with integration smoke (104 tests).

turtlecode 0.3.58 2026-05-30 · Trellis Studio

Agents and composer

• Ambient focus: composer focus chip for the active surface (whiteboard, file, rail view, agent lane). Pin, exclude, or let stale focus expire after five minutes.
• Turn actions: shortcut buttons after each agent turn (open file, view whiteboard, CMS entry, calendar event, preview, diffs).
• Read aloud: synthesize assistant replies and markdown; saves speech assets under .trellis/media/ for replay from Assets / Design.
• Agent memory: injected <project-memory>, memory tool, and automatic capture (links, explicit phrases, research sources, calendar personal events).
• CMS: explicit collections only register with create_collection before entries; ghost entries and formula-only creates blocked.
• Cloud models: hosted default MiniMax M3 Free (OpenCode Zen) while metered gateway path stabilizes; ChatGPT Pro/Plus (Codex) via device code on cloud; streaming assistant text on studio.trellis.computer.
• Composer reliability: focus and pointer-events fixes after agent turns; session working state reconciles when cloud events drop.

Graph and navigation

• Graph performance:: Canvas renderer at 800+ nodes; labels at zoom ≥ 0.65×; Return to graph nodes beacon when panned off-screen.
• Graph default:Graph replaces Home as the default session view; ?view=home redirects to Graph.
• Entity sidebar:Entities header with count; markdown Preview / Details split for frontmatter.
• Go to file:⌘P / Ctrl+P fuzzy path search with debounce and warmed index.
• Code view:: Explorer and editor side by side; workspace-scoped tabs persist across agent sessions.
• Desktop (Tauri): authenticated fetch for Trellis APIs fixes empty graph in the desktop app.

Projections and whiteboards

• Calendar: modal event editor, multi-day spans, shared view in Plan → Calendar and Calendar projection.
• Whiteboards:: Excalidraw .whiteboard files, Plan-style sidebar lens, Studio-themed HUD (left tool rail, right inspector), dot grid, agent whiteboard tool and templates.
• Obsidian Bases:.base vault views in Code with cached note index.
• Custom projections: define lenses in opencode.jsonc under projections.custom; pin up to eight affordances on the rail.
• Details: Projections and whiteboards.

Publish and cloud UI

• Publish control in preview and browser panels: slug pick, build plan, public/unlisted visibility, Republish from Live menu. Distinct from Share session. See Publish to the web.

Files and workspace

• Symlinks: file tree resolves symlink targets; open the repo root to search inside nested clones. .trellis/ excluded from search.
• Open by path: paste absolute or ~/ paths in the Open project dialog.

Trellis Cloud 2026-05-30

Hosted broker and dashboard (no npm package; deployed with cloud + Studio releases).

• Sandbox CLI: broker wraps E2B shells with npm global bin on PATH so trellis init works in sandboxes. Fixes Provisioning failed / trellis: command not found. See Cloud hosting.
• Studio stack restart: upgrades kill stale turtlecode (3333) and OpenCode (4096) before relaunch. Fixes Method Not Allowed on agent prompts.
• AI proxy: broker routes chat through Vercel AI Gateway with per-user daily token budget and GET /ai/usage for the status bar. BYOK still supported. See Cloud AI proxy.
• Projects grid: simplified cards (thumbnail, name, last opened, actions menu); three columns on large screens.
• Publish (backend): slug registry, R2 presigned uploads, and *.studio.trellis.computer edge routing. See Publish to the web.

trellis 3.1.32 2026-05-29

Workspace release (shipped in npm 3.1.33–3.1.35; no separate 3.1.32 publish).

• Agent lanes:trellis lane for per-lane journals under .trellis/lanes/, create / enter / leave / status / diff / promote / drop.
• trellis lane promote: replay lane ops with --dry-run, --explain, and conflict detection.
• trellis issue start: auto-creates and enters a lane (opt out with --no-lane).
• TRELLIS_LANE_ID: subprocess agents auto-enter the lane.
• Lazy replay: integration materialization cache on leaveLane.
• See CLI commands and trellis/vcs.

trellis 3.1.14 2026-05-22

Workspace release (consolidated into later npm publishes; no separate 3.1.14 on npm).

• CLI trellis --version 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).
• Clearer "not a repository" errors: show looked-from path, cwd, and -p hint.
• 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).

trellis 3.1.2 2026-05-12

Workspace release (consolidated into npm 3.1.3+; no separate 3.1.2 on npm).

• Fixed trellis/cms collection reads for inferred collections whose normalized key differs from stored entity type casing (for example blogpost → BlogPost).
• Added graph-link awareness to CMS entries so reference links appear in fields and can be expanded.
• Added status fact fallback when cms_status is absent.
• Added shared polling for CMS subscriptions so duplicate subscribers reuse one poll stream.
• Added onError and custom equals subscription options.
• Fixed CMS entity pagination to respect the 1000-entity page limit.
• Added CMS client/scaffold tests to the default test script.
• Added directory support to CMS consumer scaffolds for multi-instance opencode routing.

trellis 3.1.1 2026-05-12

• Published the first trellis/cms SDK package update after adding scaffold helpers.

trellis 3.1.0 2026-05-12

First trellis/cms release train (published to npm as 3.1.1 on the same date).

• 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.