Changelog
Latest updates, features, and fixes in Trellis by version and release date.
Notable changes by release date and version. Unless noted, versions are npm package releases.
| Product | npm package | Current (desk) |
|---|---|---|
| Kernel / CLI | trellis | 4.1.2 |
| Trellis Studio | turtlecode | 0.3.71 |
| Docs site | trellis.computer | |
| Trellis Cloud | hosted | studio.trellis.computer |
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.1.2 2026-10-27
Formula parity: $round and $concat join the frozen core
$round(value, decimals = 0): coerces withNumber()and rounds half up at10^decimals, matching the kernelExprEvaluator.$concat(...values): stringifies each value, withnulland missing fields as'', matching the kernel.- Conformance: the formula matrix now covers rounding (including the default precision) and concatenation (including a missing field), both with canonical round-trip.
trellis 4.1.1 2026-10-27
Location is graph-native; an ADR, not a property type
- ADR 0063: a
Placeis an entity, not alocationproperty type. Coordinates live as numericlatitude/longitudefields; roles such aslocatedAt,origin, anddestinationare relations; optional GeoJSON geometry stays injson, validated by the consumer. - Text remains a label:
core:Event.locationis stillrich_textfor the human-entered place name and offline fallback. Geocoding is a cached adapter, never a silent write into graph truth. - No migration: existing flat
latitude/longitudeentities keep working; linking them to aPlaceis additive. - Read the full rationale in Location model and ADR 0063.
trellis 4.1.0 2026-10-15
Peer wire, forms, and formula core
- Iroh peer wire (ADR 0060):
trellis wirebrings pairwise peer sync over Iroh, the on-ramp to local-first graph replication that does not depend on the relay. - Formula core: the frozen kernel formula core plus dialect adapters
(ADR 0059) graduate to
src/formulaand atrellis/formulaexport. - Forms: the form ontology ships as
trellis/formswith React, Vue, Svelte, and vanilla adapters. - Device provisioning: devices mint their own keys, sprite authorizations are signed, and private keys are written owner-only.
- MCP decision capture: decision traces auto-capture again and honor
--path. - Release pipeline: publish runs from CI only, validates the tarball before it ships, and the gate runs on Node 22.
- Repo hygiene and guard: an enforceable sensitive-content scan (PII, secrets, denied paths) now runs on pre-commit, pre-push, and CI.
trellis 4.0.12 2026-10-12
Journal format frozen: a spec'd op envelope, DAG-ready journals, derived refs
- Journal format v0.1:
docs/spec/JOURNAL-FORMAT.mdpins the op envelope (preimage, hashing, signing, chain and signing policy) with an independent zero-dependency validator and reference-minted fixtures; the conformance corpus gates every envelope change. - Envelope v2 (
parents[]): journals carry DAG parents; hashing, signing, and verification dispatch on the op version, so v1 ops stay byte-compatible. Op provenance gainscommandId(ADR-0058). - Derived
rootPath(@self): config carries a reference instead of a literal path (ADR-0013 phase 3); renames and moves can no longer go stale. - Platform ontology:
Repo+ thinProject+Service;Integrationpromoted to a core type;trellis:projectretired. - Git bridges: forge-direct GitHub import (read-only P1); git-bug adapter
imports
refs/bugs/*. - Agent lanes and guard: lane-scoped ownership policy,
trellis guardcross-agent file checks, softer lane-promote conflicts. - Operator:
trellis cadence --lanes/--dispatch,builtin:clockscheduler fact, agent liveness census (ADR-0052).
trellis 4.0.10 2026-09-29
Operator surface: notes, cycles, cadence, mirrors, and report
trellis note: capture thoughts durably without committing to them (add/list/show/archive), andnote promoteto turn one into an issue/epic/cycle; the deliberate act that creates work (ADR 0050).trellis wip: one derived snapshot: active, queue, shipped, next, cycles, and notes awaiting triage.trellis cycle: time-boxed containers with a target date; the deadline lives on the container and membership is a link (ADR 0026).trellis telos: strategic roots; epics roll up viarootedIn.trellis cadence: derived due-check (overdue cycles, triage debt, stale mirrors); it now gatesissue close(--forceto override).trellis mirror: generates a deterministic graph index;--checkfails when it drifts from the graph.trellis report: derived worklog plus epic→telos rollup.
trellis 4.0.7 2026-09-26
Minted FileNode / DirectoryNode ids
- Fix: path-derived
file:<path>ids merged distinct files after a rename re-add.fileAddnow mints stable ids (file:f_*,dir:d_*); the path is a mutable indexed attribute. Legacyfile:<path>fallback on old graphs.
trellis 4.0.6 2026-09-26
Agent profile memory, plan capture, harness CLI, shared format layer
trellis profile: global user profile (~/.trellis/profile.json) withlearn/forget/set/show/seedand a budgetedprofile contextfor hooks.trellis plan: repo-canonical plan artifacts (origins,scaffold,capture,link) per ADR 0044, with IDE provenance.trellis agent: harness run/status over typed graph tools.trellis/format: shared terminal formatters for the CLI and embedded shells (turtleOStsh).
trellis 4.0.5 2026-09-17
Re-release of 4.0.4 from the tagged tree. The 4.0.4 tarball was published
from a stale working copy and shipped none of its changes; trellis@4.0.4 is
deprecated on npm.
trellis 4.0.4 2026-09-17
Owner-held device keys and a working CI
trellis pair provision --public-key <spki> …: register a device whose key pair was generated on the device; the private key never leaves it.- Private keys are written owner-only everywhere (TRL-455).
- Fix: CI installs again (admin UI vendored; stray
file:devDependency removed).
trellis 4.0.3 2026-09-17
Every op is signed, and installs get ~15× smaller
- Ops are signed at the engine's single apply path (ADR 0020 / 0032). With a
device key or identity on disk,
applyOpsigns every op minted on that machine, so peers attribute it byvcs.signedBy(a key check) instead of the self-assertedagentId(ADR 0022 §4 gap). Previously only capability ops (grant/zone) were signed;trellis entity createand friends wrote unsignedagent:$USERops even in repos with an identity. Ops arriving throughintegrateOpsare markedforeignand keep their own envelope; identity-less repos are unchanged. - Fix: lane/integration re-mints kept a stale signature. Re-minting an op
onto a new
previousHashpreservedvcs.signature, which coverspreviousHash, so the op no longer verified. The envelope is now dropped and the op re-signed. - Fix: signing threw
require is not definedoutside the esbuild bundle.createPrivateKeyFromDercalledrequire('crypto'), which only worked because the bundle injected a shim; tsx and native-ESM runs (the CLI test harness) failed as soon as an op was signed. It now uses a static import. opencode-ai,turtlecode,@huggingface/transformers, and@xenova/transformersare optional peer dependencies: npm never installs them automatically. Measured on ARM64 Linux: 1.3 GB → 85 MB, ~27 s → 7 s. All call sites degrade gracefully:trellis codeasks to install opencode, Studio falls back tonpx turtlecode, and semantic search asks for@huggingface/transformers.
Docs: Identity & op signing, Installation.
trellis 4.0.2 2026-08-30
WebContainer sandbox fixes
Follow-up to the 4.0.1 sandbox ship; fixes install-from-npm, payload size, and package-manager compatibility.
trellis sandbox packworks fromnpm install -g trellis. Asset resolution no longer depends on esbuild chunk paths, so packed sandboxes findindex.htmlin both repo checkouts and installed packages.- Sandbox bootstrap ~70% smaller (25.7 MB → 7.6 MB) by pruning unreachable
sql.js variants and excluding
distsourcemaps by default. Usetrellis sandbox pack --no-pruneor--sourcemapswhen you need the full payload. trellis --versioninside the sandbox reports the real Trellis release (was0.0.0).trellis@4.0.1installable with pnpm and bun: removed a file-linked UI dependency from runtimedependencies(admin UI is vendored at build time).- Clean
npm cibuilds and tests: declared missing runtime deps for headlesseditor/tablecores;better-sqlite3added for default test runs.
Docs: WebContainer sandbox, CLI commands.
trellis 4.0.1 2026-08-30
WebContainer sandbox
Browser-hosted Trellis CLI via StackBlitz WebContainer; no E2B VM, no cloud broker. Distinct from Trellis Cloud sandboxes.
trellis sandbox serve: local dev host on:4321with COOP/COEP headers and a bootstrap API. Opens a browser terminal running the Trellis CLI inside WebContainer afternpm run build.trellis sandbox pack -o public/bootstrap.json: writes vendoreddist/+ runtime deps for static deploy (Vercel prebuilt path inapps/wc-sandbox/).- No in-browser
npm install: the host pre-packs Trellisdist/and stubs native modules (sql.jsinstead ofbetter-sqlite3). - CI: opt-in Playwright e2e (
WC_E2E=1,npm run test:wc:e2e) verifies WebContainer boot in CI. - Legacy alias:
npm run test:wc.
Docs: WebContainer sandbox, CLI commands.
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 synccommits 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'srevert/resetcannot touch another agent's files.
Breaking changes
GitSyncResult.refusedandreasonremoved; sync never refuses.trellis git syncdoes 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-pnow matches every otherlanesubcommand.
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|vanillasubpaths) +trellis/headlessbridge. - Component registry + admin Components panel.
trellis/adminnow 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
createKanbanCoreprojection: 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.
laneIdwas stamped into the hashedvcspayload after the hash was computed, so lane journal ops could not verify or sync.VcsOp.laneIdis 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.requirenow includescheck(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 adminoperator console: active onmainin the kernel repo; not yet prebundled for globalnpm 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). VcsMiddlewareremoved: was never wired; decomposition runs inline inengine.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|approvewith terminal QR (viauqr). - Sprite relay blobs (ADR 0016): deploy entrypoints can mount
presenceRelaywithblobStoreso/blobis available on*.sprites.appalongside/rt. BlobStoreexport fromtrellis/serverfor 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 whengit.syncOnPromote(default on init). - Init defaults:
lanes.worktreeBindandgit.syncOnPromotewritten on everytrellis 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,WhereFilteroperators, nestedInferResolvedType,entityMutations.- Live reads:
liveEntities/liveEntityintrellis/clientwith id-scoped subscriptions and server-sidehydrateAndResolve. - 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-memoryindist/.
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 ofsrc/paths. - Release validation:
bun script/sync-trellis-core.tswith 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>,memorytool, and automaticcapture(links, explicit phrases, research sources, calendar personal events). - CMS: explicit collections only register with
create_collectionbefore 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=homeredirects 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
.whiteboardfiles, Plan-style sidebar lens, Studio-themed HUD (left tool rail, right inspector), dot grid, agentwhiteboardtool and templates. - Obsidian Bases:
.basevault views in Code with cached note index. - Custom projections: define lenses in
opencode.jsoncunderprojections.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
binonPATHsotrellis initworks 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/usagefor 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.computeredge 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 lanefor 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 --versionreports the real package version frompackage.json(was hardcoded0.1.0). - CLI
-p/ cwd resolution walks up to the nearest.trellisrepo root (monorepo subfolders work without passing the root path). - Clearer "not a repository" errors: show looked-from path, cwd, and
-phint. issue createaccepts--descriptionas an alias for--desc.bin/trellis.mjslauncher finds Homebrew Bun when Node'sPATHis 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/cmscollection reads for inferred collections whose normalized key differs from stored entity type casing (for exampleblogpost→BlogPost). - Added graph-link awareness to CMS entries so reference links appear in
fieldsand can be expanded. - Added
statusfact fallback whencms_statusis absent. - Added shared polling for CMS subscriptions so duplicate subscribers reuse one poll stream.
- Added
onErrorand customequalssubscription options. - Fixed CMS entity pagination to respect the 1000-entity page limit.
- Added CMS client/scaffold tests to the default test script.
- Added
directorysupport to CMS consumer scaffolds for multi-instance opencode routing.
trellis 3.1.1 2026-05-12
- Published the first
trellis/cmsSDK 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/cmssubpath withcreateCmsClient, collection reads, entry reads, polling subscriptions, reference expansion, collection discovery, and consumer scaffold helpers for vanilla, React, Solid, and Vue.