trellis 3.0.3 → 3.1.3

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## 3.1.2
+
+- 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.
+- Added `status` fact fallback when `cms_status` is absent, preserving content created by agents or lower-level store tools.
+- Added shared polling for CMS subscriptions so duplicate subscribers to the same collection or entry reuse one poll stream.
+- Added `onError` and custom `equals` subscription options.
+- Fixed CMS entity pagination to respect the opencode store route's 1000-entity page limit.
+- 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
+
+- Published the first `trellis/cms` SDK package update after adding scaffold helpers.
+
+## 3.1.0
+
+- 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,8 +1,6 @@
 # Trellis
 
-https://trellis.computer
-
-> **The Agentic Framework** — A structured runtime for building agents that understand code, remember everything, and explain themselves.
+> **The Agentic Framework**
 
 | Use Case                       | How                                                                                                       |
 | :----------------------------- | :-------------------------------------------------------------------------------------------------------- |
@@ -46,10 +44,49 @@ trellis milestone "Initial Release"
 trellis code
 ```
 
+![Trellis Demo](./trellis-opencode.gif)
+
 See the [CLI guide](https://trellis.computer/docs/cli) for complete documentation.
 
 ---
 
+## CMS Client SDK
+
+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',
+});
+
+const posts = await cms.collection('blogpost').list({
+  status: 'all',
+  expand: ['author'],
+});
+
+const off = cms.collection('blogpost').subscribe(
+  (entries) => {
+    console.log(entries);
+  },
+  {
+    status: 'published',
+    onError: console.error,
+  },
+);
+
+off();
+```
+
+- **Collections**: `cms.collections()` returns explicit `TypeSchema` collections and inferred collections from existing entity types.
+- **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?
 
 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:
@@ -80,7 +117,11 @@ Ops are written to `.trellis/ops.json` and **never rewritten or deleted**.
 
 ## Documentation
 
-- **[Full documentation](https://trellis.computer)** — Complete guides and API reference
+- **[Local documentation](./docs/README.md)** — Canonical docs for the active codebase
+- **[Vision](./docs/VISION.md)** — Local-first agentic OS framing
+- **[Architecture](./docs/ARCHITECTURE.md)** — Current package layout and target runtime shape
+- **[Roadmap](./ROADMAP.md)** — Active Trellis issue and milestone sequence
+- **[Full documentation](https://trellis.computer)** — Published docs site
 - **[CLI reference](./README-ARCHIVED.md#cli-overview)** — Command details (archived)
 - **[API modules](./README-ARCHIVED.md#module--subpath-guide)** — Subpath imports (archived)
 - **[DESIGN.md](./DESIGN.md)** — Architecture specification

package/dist/cli/index.js

@@ -2886,7 +2886,7 @@ var {
   Help
 } = import__.default;
 
-// ../trellis-client/node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/vendor/ansi-styles/index.js
+// node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
 var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
 var wrapAnsi256 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
@@ -3063,7 +3063,7 @@ function assembleStyles() {
 var ansiStyles = assembleStyles();
 var ansi_styles_default = ansiStyles;
 
-// ../trellis-client/node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/vendor/supports-color/index.js
+// node_modules/chalk/source/vendor/supports-color/index.js
 import process2 from "process";
 import os from "os";
 import tty from "tty";
@@ -3195,7 +3195,7 @@ var supportsColor = {
 };
 var supports_color_default = supportsColor;
 
-// ../trellis-client/node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/utilities.js
+// node_modules/chalk/source/utilities.js
 function stringReplaceAll(string, substring, replacer) {
   let index = string.indexOf(substring);
   if (index === -1) {
@@ -3228,7 +3228,7 @@ function stringEncaseCRLFWithFirstIndex(string, prefix, postfix, index) {
   return returnValue;
 }
 
-// ../trellis-client/node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/index.js
+// node_modules/chalk/source/index.js
 var { stdout: stdoutColor, stderr: stderrColor } = supports_color_default;
 var GENERATOR = Symbol("GENERATOR");
 var STYLER = Symbol("STYLER");
@@ -5716,16 +5716,13 @@ function requireRepo(rootPath) {
     process.exit(1);
   }
 }
-program2.command("init").description("Initialize a new TrellisVCS repository in the current directory").option("-p, --path <path>", "Path to initialize", ".").option("--ides <ides...>", "IDEs to scaffold for (cursor, windsurf, claude, copilot, codex, gemini)").option("--framework <framework>", "Project framework (react, vue, svelte, next, nuxt, remotion, expo, bun, node, cli, library, animation, games, none)", "none").option("--footprint <footprint>", "Workspace footprint (minimal, standard, full)", "standard").option("--no-interactive", "Skip interactive prompts").action(async (opts) => {
-  const rootPath = resolve(opts.path);
-  const isInteractive = process.stdout.isTTY && !process.argv.includes("--no-interactive");
+async function runInit(rootPath, opts = {}) {
+  const isInteractive = opts.interactive !== false && process.stdout.isTTY && !process.argv.includes("--no-interactive");
   if (TrellisVcsEngine.isRepo(rootPath)) {
-    console.log(source_default.yellow("Already a Trellis workspace."));
     return;
   }
   if (!hasProfile()) {
-    const trellisDir = join6(rootPath, ".trellis");
-    const identity = hasIdentity(trellisDir) ? loadIdentity(trellisDir) : null;
+    const identity = hasIdentity(rootPath) ? loadIdentity(join6(rootPath, ".trellis")) : null;
     if (isInteractive) {
       console.log(source_default.cyan(`
   Welcome to Trellis! Let's get you set up.`));
@@ -5884,7 +5881,6 @@ program2.command("init").description("Initialize a new TrellisVCS repository in
   }
   if (selectedIdes && selectedIdes.length > 0) {
     for (const selectedIde of selectedIdes) {
-      console.log(source_default.dim(`  Scaffolding ${selectedIde} dotfolder...`));
       writeIdeScaffold(rootPath, {
         ide: selectedIde,
         footprint,
@@ -5896,25 +5892,34 @@ program2.command("init").description("Initialize a new TrellisVCS repository in
       });
     }
   }
+}
+program2.command("init").description("Initialize a new TrellisVCS repository in the current directory").option("-p, --path <path>", "Path to initialize", ".").option("--ides <ides...>", "IDEs to scaffold for (cursor, windsurf, claude, copilot, codex, gemini)").option("--framework <framework>", "Project framework (react, vue, svelte, next, nuxt, remotion, expo, bun, node, cli, library, animation, games, none)", "none").option("--footprint <footprint>", "Workspace footprint (minimal, standard, full)", "standard").option("--no-interactive", "Skip interactive prompts").action(async (opts) => {
+  const rootPath = resolve(opts.path);
+  if (TrellisVcsEngine.isRepo(rootPath)) {
+    console.log(source_default.yellow("Already a Trellis workspace."));
+    return;
+  }
+  await runInit(rootPath, {
+    interactive: process.stdout.isTTY && !process.argv.includes("--no-interactive"),
+    ides: opts.ides,
+    framework: opts.framework,
+    footprint: opts.footprint
+  });
   console.log(source_default.green("\u2713 Initialized Trellis repository"));
+  const engine = new TrellisVcsEngine({ rootPath });
+  const opsCount = (await engine.log()).length;
   console.log(`  ${source_default.dim("Path:")}           ${rootPath}`);
-  console.log(`  ${source_default.dim("Ops:")}            ${result.opsCreated} initial operations scanned`);
+  console.log(`  ${source_default.dim("Ops:")}            ${opsCount} initial operations scanned`);
   console.log(`  ${source_default.dim("Config:")}         .trellis/config.json`);
   console.log(`  ${source_default.dim("Op log:")}         .trellis/ops.json`);
   console.log(`  ${source_default.dim("Graph DB:")}       .trellis/graph.db`);
   console.log(`  ${source_default.dim("Agent context:")}  .trellis/agents/AGENTS.md`);
-  if (selectedIdes.length > 0) {
-    const ideFolders = selectedIdes.map((id) => {
-      const ide = id;
-      return ide === "cursor" ? ".cursor" : ide === "windsurf" ? ".windsurf" : ide === "claude" ? ".claude" : ide === "codex" ? ".codex" : ide === "gemini" ? ".gemini" : ".github/copilot";
-    });
-    console.log(`  ${source_default.dim("IDE rules:")}        ${ideFolders.join(", ")}`);
-  }
-  if (result.context.domain) {
-    console.log(`  ${source_default.dim("Domain:")}         ${source_default.cyan(result.context.domain)} ${source_default.dim("(inferred)")}`);
+  const preInfer = await inferProjectContext(rootPath);
+  if (preInfer.domain) {
+    console.log(`  ${source_default.dim("Domain:")}         ${source_default.cyan(preInfer.domain)} ${source_default.dim("(inferred)")}`);
   }
-  if (result.context.ecosystem && result.context.ecosystem !== "unknown") {
-    console.log(`  ${source_default.dim("Ecosystem:")}      ${result.context.ecosystem}`);
+  if (preInfer.ecosystem && preInfer.ecosystem !== "unknown") {
+    console.log(`  ${source_default.dim("Ecosystem:")}      ${preInfer.ecosystem}`);
   }
   console.log();
   console.log(source_default.bold("Next steps:"));
@@ -5925,7 +5930,7 @@ program2.command("init").description("Initialize a new TrellisVCS repository in
   console.log(`  ${source_default.cyan("trellis milestone")}  Create narrative checkpoints`);
   console.log(`  ${source_default.cyan("trellis garden")}     Discover abandoned work`);
   console.log(`  ${source_default.cyan("trellis issue")}      Create and track issues`);
-  if (result.context.confidence !== "high") {
+  if (preInfer.confidence !== "high") {
     console.log(`  ${source_default.cyan("trellis season")}     Enrich project context for agents`);
   }
   console.log();
@@ -8573,16 +8578,21 @@ program2.command("season").description("Enrich project context for agents \u2014
   }
   console.log();
 });
-program2.command("code").alias("ide").description('Launch OpenCode in "Harness" mode, bridged to this Trellis repository').option("-p, --path <path>", "Repository path", ".").option("-m, --model <model>", "OpenCode model to use").option("-w, --web", "Launch MCP server in HTTP mode for web client access").option("--mcp-port <port>", "MCP HTTP server port (default: 3333)", "3333").action(async (opts) => {
+program2.command("code").alias("ide").description('Launch OpenCode in "Harness" mode, bridged to this Trellis repository').option("-p, --path <path>", "Repository path", ".").option("-m, --model <model>", "OpenCode model to use").option("-w, --web", "Launch MCP server in HTTP mode for web client access").option("--mcp-port <port>", "MCP HTTP server port (default: 3333)", "3333").option("--no-init", "Skip initialization even if not a Trellis workspace").action(async (opts) => {
   const { resolve: resolve2, dirname: dirname6, join: join7 } = await import("path");
   const { existsSync: existsSync6 } = await import("fs");
   const { spawn } = await import("child_process");
+  const { readFileSync: readFileSync4 } = await import("fs");
+  const { createServer: createHttpServer } = await import("http");
   const rootPath = resolve2(opts.path);
-  if (!TrellisVcsEngine.isRepo(rootPath)) {
-    console.log(source_default.dim("Not a Trellis workspace \u2014 initializing\u2026"));
-    const engine = new TrellisVcsEngine({ rootPath });
-    await engine.initRepo();
-    console.log(source_default.green("\u2713 Initialized Trellis repository"));
+  if (!opts.noInit) {
+    if (!TrellisVcsEngine.isRepo(rootPath)) {
+      console.log(source_default.dim("Not a Trellis workspace \u2014 initializing\u2026"));
+      await runInit(rootPath, {
+        interactive: false
+      });
+      console.log(source_default.green("\u2713 Initialized Trellis repository"));
+    }
   }
   function findOpencode() {
     const here = dirname6(process.argv[1]);
@@ -8639,24 +8649,46 @@ program2.command("code").alias("ide").description('Launch OpenCode in "Harness"
     console.log(source_default.dim(`   Web:     ${mcpUrl}`));
   }
   console.log("");
+  let mcpProcess = null;
+  if (opts.web) {
+    console.log(source_default.dim(`   Starting MCP server on port ${mcpPort}\u2026`));
+    mcpProcess = spawn("bun", ["run", mcp, "--quiet", "--path", rootPath, "--http", "--port", String(mcpPort)], {
+      stdio: ["pipe", "pipe", "pipe"],
+      detached: false
+    });
+    mcpProcess.stderr?.on("data", (data) => {
+      const msg = data.toString();
+      if (!msg.includes("TrellisVCS MCP Server")) {
+        process.stderr.write(source_default.dim(`   [mcp] ${msg}`));
+      }
+    });
+    mcpProcess.on("error", (err) => {
+      console.error(source_default.red(`
+\u2717 MCP server failed to start: ${err.message}`));
+      process.exit(1);
+    });
+    const ready = await waitForMcpReady(mcpUrl, 1e4);
+    if (!ready) {
+      console.error(source_default.red(`
+\u2717 MCP server did not become ready in time`));
+      if (mcpProcess) {
+        mcpProcess.kill();
+      }
+      process.exit(1);
+    }
+    console.log(source_default.green(`\u2713 MCP server ready at ${mcpUrl}`));
+  }
   const args = [rootPath];
   if (opts.model) {
     args.push("--model", opts.model);
   }
   const mcpServers = {
     mcpServers: {
-      "trellis-vcs": {
+      "trellis-vcs": opts.web ? {
+        url: `${mcpUrl}/sse`
+      } : {
         command: "bun",
-        args: opts.web ? [
-          "run",
-          mcp,
-          "--quiet",
-          "--path",
-          rootPath,
-          "--http",
-          "--port",
-          String(mcpPort)
-        ] : ["run", mcp, "--quiet", "--path", rootPath]
+        args: ["run", mcp, "--quiet", "--path", rootPath]
       }
     }
   };
@@ -8672,6 +8704,9 @@ program2.command("code").alias("ide").description('Launch OpenCode in "Harness"
     }
   });
   child.on("exit", (code) => {
+    if (mcpProcess) {
+      mcpProcess.kill();
+    }
     if (code === 0) {
       console.log(source_default.green(`
 \u2713 Agentic session complete.`));
@@ -8682,4 +8717,22 @@ program2.command("code").alias("ide").description('Launch OpenCode in "Harness"
     process.exit(code ?? 0);
   });
 });
+async function waitForMcpReady(url, timeoutMs) {
+  const { get } = await import("http");
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    await new Promise((resolve2) => setTimeout(resolve2, 500));
+    try {
+      const res = await new Promise((resolve2, reject) => {
+        const req = get(`${url}/health`, resolve2);
+        req.on("error", reject);
+        req.setTimeout(2000);
+      });
+      if (res.statusCode === 200) {
+        return true;
+      }
+    } catch {}
+  }
+  return false;
+}
 program2.parse();

package/dist/cms/client.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Trellis CMS Client
+ *
+ * Thin HTTP client for reading content collections from a Trellis-compatible store
+ * (currently opencode's /store/* routes). Reads only; writes happen through the
+ * IDE's CMS panel or the agent's `cms` tool.
+ *
+ * @example
+ *   import { createCmsClient } from "trellis/cms";
+ *
+ *   const cms = createCmsClient({ url: "http://localhost:4096" });
+ *
+ *   // List published blog posts with author resolved
+ *   const posts = await cms.collection("blog_post").list({
+ *     status: "published",
+ *     expand: ["author"],
+ *   });
+ *
+ *   // Subscribe to live updates (polling for now, SSE later)
+ *   const off = cms.collection("blog_post").subscribe((entries) => {
+ *     console.log(entries);
+ *   });
+ *
+ * @module trellis/cms
+ */
+import type { CmsClientOptions, Collection, Entry, EntrySubscribeOptions, EntrySubscriber, GetOptions, ListOptions, ListSubscribeOptions, ListSubscriber, Unsubscribe } from './types.js';
+import { type RawEntity } from './internal.js';
+export declare class CmsClient {
+    private readonly url;
+    private readonly basePath;
+    private readonly directory?;
+    readonly pollIntervalMs: number;
+    private readonly fetchFn;
+    private readonly apiKey?;
+    private readonly subscriptions;
+    constructor(opts: CmsClientOptions);
+    collection<T extends Record<string, unknown> = Record<string, unknown>>(key: string): CollectionRef<T>;
+    entry<T extends Record<string, unknown> = Record<string, unknown>>(id: string): EntryRef<T>;
+    /** List all CMS collections (explicit + inferred). */
+    collections(): Promise<Collection[]>;
+    close(): void;
+    /**
+     * Shared polling subscription. Multiple subscribers to the same key share a
+     * single timer and one HTTP request per poll cycle. New subscribers receive
+     * the most recently fetched value immediately if one is cached.
+     *
+     * @internal
+     */
+    _share<T>(key: string, fetcher: () => Promise<T>, callback: (value: T) => void, extras?: {
+        equals?: (prev: unknown, next: unknown) => boolean;
+        onError?: (err: unknown) => void;
+    }): Unsubscribe;
+    /** @internal */
+    _get<T>(path: string): Promise<T | undefined>;
+    /** @internal */
+    _entities(): Promise<RawEntity[]>;
+    /** @internal */
+    _entryById(id: string): Promise<Entry | null>;
+}
+export declare class CollectionRef<T extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly client;
+    readonly key: string;
+    constructor(client: CmsClient, key: string);
+    list(opts?: ListOptions): Promise<Entry<T>[]>;
+    get(id: string, opts?: GetOptions): Promise<Entry<T> | null>;
+    /**
+     * Subscribe to changes. Currently implemented as polling; a future SSE-backed
+     * upgrade will replace the transport without changing this API.
+     *
+     * Multiple subscribers to the same collection + opts share one polling timer
+     * and one HTTP request per cycle.
+     */
+    subscribe(callback: ListSubscriber<T>, opts?: ListSubscribeOptions): Unsubscribe;
+}
+export declare class EntryRef<T extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly client;
+    readonly id: string;
+    constructor(client: CmsClient, id: string);
+    get(opts?: GetOptions): Promise<Entry<T> | null>;
+    subscribe(callback: EntrySubscriber<T>, opts?: EntrySubscribeOptions): Unsubscribe;
+}
+export declare function createCmsClient(opts: CmsClientOptions): CmsClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/cms/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cms/client.ts"],"names":[],"mappings":"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"}

package/dist/cms/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Trellis CMS — client-side SDK for reading content collections.
+ *
+ * @module trellis/cms
+ */
+export { CmsClient, CollectionRef, EntryRef, createCmsClient } from './client.js';
+export type { CmsClientOptions, Collection, Entry, EntryStatus, EntrySubscribeOptions, EntrySubscriber, Framework, GetOptions, ListOptions, ListSubscribeOptions, ListSubscriber, SubscribeExtras, Unsubscribe, } from './types.js';
+export { scaffoldConsumer, scaffoldFilename } from './scaffold.js';
+export type { ScaffoldOptions } from './scaffold.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cms/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAElF,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,KAAK,EACL,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/cms/index.js

@@ -0,0 +1,492 @@
+// @bun
+import"../index-a76rekgs.js";
+
+// src/cms/internal.ts
+var SYSTEM_TYPES = new Set([
+  "issue",
+  "agent",
+  "project",
+  "memory",
+  "mcp",
+  "sprite",
+  "workunit",
+  "cycle",
+  "epic",
+  "roadmap",
+  "suggestion",
+  "file",
+  "directory",
+  "op",
+  "branch",
+  "decision",
+  "session",
+  "typeschema",
+  "field"
+]);
+function isSystemType(type) {
+  return SYSTEM_TYPES.has(type.trim().toLowerCase());
+}
+function typeKey(type) {
+  return type.trim().toLowerCase();
+}
+function entryFromFacts(entity, facts, links) {
+  const fields = {};
+  let status = "draft";
+  let cmsStatusSeen = false;
+  for (const f of facts) {
+    if (f.a === "type")
+      continue;
+    if (f.a === "cms_status") {
+      status = f.v === "published" ? "published" : "draft";
+      cmsStatusSeen = true;
+      continue;
+    }
+    fields[f.a] = f.v;
+  }
+  if (!cmsStatusSeen) {
+    if (fields.status === "published")
+      status = "published";
+    else if (fields.status === "draft")
+      status = "draft";
+  }
+  if (links) {
+    for (const link of links) {
+      if (link.e1 !== entity.id)
+        continue;
+      if (!(link.a in fields))
+        fields[link.a] = link.e2;
+    }
+  }
+  return { id: entity.id, type: entity.type, status, fields };
+}
+function groupFactsByEntity(facts) {
+  const map = new Map;
+  for (const f of facts) {
+    const list = map.get(f.e);
+    if (list)
+      list.push(f);
+    else
+      map.set(f.e, [f]);
+  }
+  return map;
+}
+function groupLinksBySource(links) {
+  const map = new Map;
+  for (const l of links) {
+    const list = map.get(l.e1);
+    if (list)
+      list.push(l);
+    else
+      map.set(l.e1, [l]);
+  }
+  return map;
+}
+async function expandReferences(entries, expandKeys, fetchEntity) {
+  const ids = new Set;
+  for (const entry of entries) {
+    for (const key of expandKeys) {
+      const v = entry.fields[key];
+      if (typeof v === "string")
+        ids.add(v);
+    }
+  }
+  if (ids.size === 0)
+    return entries;
+  const resolved = new Map;
+  await Promise.all([...ids].map(async (id) => {
+    try {
+      resolved.set(id, await fetchEntity(id));
+    } catch {
+      resolved.set(id, null);
+    }
+  }));
+  return entries.map((entry) => {
+    const next = { ...entry.fields };
+    for (const key of expandKeys) {
+      const v = next[key];
+      if (typeof v === "string" && resolved.has(v)) {
+        next[key] = resolved.get(v);
+      }
+    }
+    return { ...entry, fields: next };
+  });
+}
+function fingerprint(value) {
+  return JSON.stringify(value);
+}
+
+// src/cms/client.ts
+var DEFAULT_BASE_PATH = "/trellis/store";
+var DEFAULT_POLL_MS = 2000;
+var MIN_POLL_MS = 500;
+var MAX_FACTS_PER_FETCH = 5000;
+var MAX_ENTITIES_PER_FETCH = 1000;
+var defaultEquals = (prev, next) => fingerprint(prev) === fingerprint(next);
+
+class CmsClient {
+  url;
+  basePath;
+  directory;
+  pollIntervalMs;
+  fetchFn;
+  apiKey;
+  subscriptions = new Map;
+  constructor(opts) {
+    this.url = opts.url.replace(/\/+$/, "");
+    this.basePath = (opts.basePath ?? DEFAULT_BASE_PATH).replace(/\/+$/, "");
+    this.directory = opts.directory;
+    this.pollIntervalMs = Math.max(MIN_POLL_MS, opts.pollIntervalMs ?? DEFAULT_POLL_MS);
+    this.fetchFn = opts.fetch ?? globalThis.fetch.bind(globalThis);
+    this.apiKey = opts.apiKey;
+  }
+  collection(key) {
+    return new CollectionRef(this, key);
+  }
+  entry(id) {
+    return new EntryRef(this, id);
+  }
+  async collections() {
+    const [entities, facts] = await Promise.all([
+      this._entities(),
+      this._get(`/facts?limit=${MAX_FACTS_PER_FETCH}`)
+    ]);
+    const factsByEntity = groupFactsByEntity(facts ?? []);
+    const counts = new Map;
+    const canonical = new Map;
+    for (const e of entities ?? []) {
+      const k = typeKey(e.type);
+      counts.set(k, (counts.get(k) ?? 0) + 1);
+      if (!canonical.has(k))
+        canonical.set(k, e.type);
+    }
+    const out = new Map;
+    for (const e of entities ?? []) {
+      if (e.type !== "TypeSchema")
+        continue;
+      const efacts = factsByEntity.get(e.id) ?? [];
+      const isCms = efacts.some((f) => f.a === "cms" && f.v === true);
+      if (!isCms)
+        continue;
+      const name = e.id.replace(/^schema:/, "");
+      const k = typeKey(name);
+      const labelFact = efacts.find((f) => f.a === "label");
+      const label = typeof labelFact?.v === "string" ? labelFact.v : name;
+      out.set(k, {
+        key: k,
+        label,
+        inferred: false,
+        count: counts.get(k) ?? 0
+      });
+    }
+    for (const [k, count] of counts) {
+      if (isSystemType(k) || out.has(k))
+        continue;
+      out.set(k, {
+        key: k,
+        label: canonical.get(k) ?? k,
+        inferred: true,
+        count
+      });
+    }
+    return [...out.values()].sort((a, b) => a.label.localeCompare(b.label));
+  }
+  close() {
+    for (const sub of this.subscriptions.values()) {
+      clearInterval(sub.interval);
+      sub.subscribers.clear();
+    }
+    this.subscriptions.clear();
+  }
+  _share(key, fetcher, callback, extras = {}) {
+    let sub = this.subscriptions.get(key);
+    if (!sub) {
+      const fresh = {
+        subscribers: new Set,
+        interval: undefined,
+        hasLast: false,
+        fetcher
+      };
+      const tick = async () => {
+        try {
+          const next = await fresh.fetcher();
+          fresh.last = next;
+          fresh.hasLast = true;
+          for (const item2 of fresh.subscribers) {
+            if (!item2.hasLast || !item2.equals(item2.last, next)) {
+              item2.last = next;
+              item2.hasLast = true;
+              item2.callback(next);
+            }
+          }
+        } catch (err) {
+          for (const item2 of fresh.subscribers)
+            item2.onError?.(err);
+        }
+      };
+      fresh.interval = setInterval(tick, this.pollIntervalMs);
+      this.subscriptions.set(key, fresh);
+      sub = fresh;
+      tick();
+    }
+    const item = {
+      callback,
+      equals: extras.equals ?? defaultEquals,
+      onError: extras.onError,
+      hasLast: false
+    };
+    sub.subscribers.add(item);
+    if (sub.hasLast) {
+      item.last = sub.last;
+      item.hasLast = true;
+      callback(sub.last);
+    }
+    return () => {
+      sub.subscribers.delete(item);
+      if (sub.subscribers.size === 0) {
+        clearInterval(sub.interval);
+        this.subscriptions.delete(key);
+      }
+    };
+  }
+  async _get(path) {
+    const u = new URL(`${this.basePath}${path}`, this.url);
+    if (this.directory && !u.searchParams.has("directory")) {
+      u.searchParams.set("directory", this.directory);
+    }
+    const res = await this.fetchFn(u.toString(), {
+      headers: this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
+    });
+    if (res.status === 404)
+      return;
+    if (!res.ok)
+      throw new Error(`Trellis CMS request failed (${res.status}) ${u.pathname}`);
+    return await res.json();
+  }
+  async _entities() {
+    const out = [];
+    let offset = 0;
+    while (true) {
+      const page = await this._get(`/entities?limit=${MAX_ENTITIES_PER_FETCH}&offset=${offset}`) ?? [];
+      out.push(...page);
+      if (page.length < MAX_ENTITIES_PER_FETCH)
+        return out;
+      offset += MAX_ENTITIES_PER_FETCH;
+    }
+  }
+  async _entryById(id) {
+    const detail = await this._get(`/entity/${encodeURIComponent(id)}`);
+    if (!detail)
+      return null;
+    const typeFact = detail.facts.find((f) => f.a === "type");
+    const type = typeof typeFact?.v === "string" ? typeFact.v : "unknown";
+    return entryFromFacts({ id: detail.id, type }, detail.facts, detail.links);
+  }
+}
+
+class CollectionRef {
+  client;
+  key;
+  constructor(client, key) {
+    this.client = client;
+    this.key = key;
+  }
+  async list(opts = {}) {
+    const status = opts.status ?? "published";
+    const limit = opts.limit ?? 100;
+    const wantsExpand = opts.expand && opts.expand.length > 0;
+    const [allEntities, facts, links] = await Promise.all([
+      this.client._entities(),
+      this.client._get(`/facts?limit=${MAX_FACTS_PER_FETCH}`),
+      this.client._get(`/links`)
+    ]);
+    if (!allEntities)
+      return [];
+    const wantedKey = typeKey(this.key);
+    const matching = allEntities.filter((e) => typeKey(e.type) === wantedKey);
+    if (matching.length === 0)
+      return [];
+    const factsByEntity = groupFactsByEntity(facts ?? []);
+    const linksBySource = groupLinksBySource(links ?? []);
+    let entries = matching.map((e) => entryFromFacts(e, factsByEntity.get(e.id) ?? [], linksBySource.get(e.id) ?? []));
+    if (status !== "all") {
+      entries = entries.filter((e) => e.status === status);
+    }
+    entries = entries.slice(0, limit);
+    if (wantsExpand) {
+      entries = await expandReferences(entries, opts.expand, (id) => this.client._entryById(id));
+    }
+    return entries;
+  }
+  async get(id, opts = {}) {
+    const entry = await this.client._entryById(id);
+    if (!entry)
+      return null;
+    if (opts.expand && opts.expand.length > 0) {
+      const [expanded] = await expandReferences([entry], opts.expand, (eid) => this.client._entryById(eid));
+      return expanded;
+    }
+    return entry;
+  }
+  subscribe(callback, opts = {}) {
+    const { onError, equals, ...listOpts } = opts;
+    const key = `coll:${typeKey(this.key)}:${JSON.stringify(listOpts)}`;
+    return this.client._share(key, () => this.list(listOpts), callback, { onError, equals });
+  }
+}
+
+class EntryRef {
+  client;
+  id;
+  constructor(client, id) {
+    this.client = client;
+    this.id = id;
+  }
+  async get(opts = {}) {
+    const entry = await this.client._entryById(this.id);
+    if (!entry)
+      return null;
+    if (opts.expand && opts.expand.length > 0) {
+      const [expanded] = await expandReferences([entry], opts.expand, (eid) => this.client._entryById(eid));
+      return expanded;
+    }
+    return entry;
+  }
+  subscribe(callback, opts = {}) {
+    const { onError, equals, ...getOpts } = opts;
+    const key = `entry:${this.id}:${JSON.stringify(getOpts)}`;
+    return this.client._share(key, () => this.get(getOpts), callback, { onError, equals });
+  }
+}
+function createCmsClient(opts) {
+  return new CmsClient(opts);
+}
+// src/cms/scaffold.ts
+var DEFAULT_URL = "http://localhost:4096";
+function expandLiteral(expand) {
+  if (!expand || expand.length === 0)
+    return "";
+  return ` expand: ${JSON.stringify(expand)},`;
+}
+function clientLiteral(url, directory) {
+  if (!directory)
+    return `createCmsClient({ url: "${url}" })`;
+  return `createCmsClient({ url: "${url}", directory: ${JSON.stringify(directory)} })`;
+}
+function vanilla(opts) {
+  const url = opts.url ?? DEFAULT_URL;
+  const exp = expandLiteral(opts.expand);
+  return `import { createCmsClient } from "trellis/cms";
+
+const cms = ${clientLiteral(url, opts.directory)};
+
+const collection = cms.collection("${opts.collection}");
+
+// One-shot fetch (defaults to status: "published")
+const entries = await collection.list({${exp}});
+console.log(entries);
+
+// Live updates \u2014 re-fires whenever the collection changes
+const off = collection.subscribe(
+  (entries) => {
+    console.log("Updated:", entries);
+  },
+  {${exp}},
+);
+// off();  // call to stop receiving updates
+`;
+}
+function react(opts) {
+  const url = opts.url ?? DEFAULT_URL;
+  const exp = expandLiteral(opts.expand);
+  return `import { useEffect, useState } from "react";
+import { createCmsClient, type Entry } from "trellis/cms";
+
+const cms = ${clientLiteral(url, opts.directory)};
+
+export function use${pascal(opts.collection)}() {
+  const [entries, setEntries] = useState<Entry[]>([]);
+  useEffect(() => {
+    const off = cms.collection("${opts.collection}").subscribe(setEntries, {${exp}});
+    return off;
+  }, []);
+  return entries;
+}
+
+// Usage:
+//   const posts = use${pascal(opts.collection)}();
+//   return posts.map(p => <article key={p.id}>...</article>);
+`;
+}
+function solid(opts) {
+  const url = opts.url ?? DEFAULT_URL;
+  const exp = expandLiteral(opts.expand);
+  return `import { createSignal, onCleanup } from "solid-js";
+import { createCmsClient, type Entry } from "trellis/cms";
+
+const cms = ${clientLiteral(url, opts.directory)};
+
+export function create${pascal(opts.collection)}() {
+  const [entries, setEntries] = createSignal<Entry[]>([]);
+  const off = cms.collection("${opts.collection}").subscribe(setEntries, {${exp}});
+  onCleanup(off);
+  return entries;
+}
+
+// Usage in a component:
+//   const posts = create${pascal(opts.collection)}();
+//   return <For each={posts()}>{(p) => <article>...</article>}</For>;
+`;
+}
+function vue(opts) {
+  const url = opts.url ?? DEFAULT_URL;
+  const exp = expandLiteral(opts.expand);
+  return `import { ref, onUnmounted } from "vue";
+import { createCmsClient, type Entry } from "trellis/cms";
+
+const cms = ${clientLiteral(url, opts.directory)};
+
+export function use${pascal(opts.collection)}() {
+  const entries = ref<Entry[]>([]);
+  const off = cms.collection("${opts.collection}").subscribe((next) => {
+    entries.value = next;
+  }, {${exp}});
+  onUnmounted(off);
+  return entries;
+}
+`;
+}
+function pascal(s) {
+  return s.split(/[_\-\s]+/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join("");
+}
+function scaffoldConsumer(opts) {
+  switch (opts.framework ?? "vanilla") {
+    case "react":
+      return react(opts);
+    case "solid":
+      return solid(opts);
+    case "vue":
+      return vue(opts);
+    default:
+      return vanilla(opts);
+  }
+}
+function scaffoldFilename(opts) {
+  const base = `cms-${opts.collection.replace(/[^a-z0-9]+/gi, "-").toLowerCase()}`;
+  switch (opts.framework ?? "vanilla") {
+    case "react":
+    case "solid":
+      return `${base}.ts`;
+    case "vue":
+      return `${base}.ts`;
+    default:
+      return `${base}.js`;
+  }
+}
+export {
+  scaffoldFilename,
+  scaffoldConsumer,
+  createCmsClient,
+  EntryRef,
+  CollectionRef,
+  CmsClient
+};

package/dist/cms/internal.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Trellis CMS — internal helpers (fact join, status detection, reference expansion).
+ */
+import type { Entry } from './types.js';
+export type RawFact = {
+    e: string;
+    a: string;
+    v: string | number | boolean;
+};
+export type RawEntity = {
+    id: string;
+    type: string;
+};
+export type RawLink = {
+    e1: string;
+    a: string;
+    e2: string;
+};
+export declare function isSystemType(type: string): boolean;
+export declare function typeKey(type: string): string;
+export declare function entryFromFacts(entity: RawEntity, facts: RawFact[], links?: RawLink[]): Entry;
+export declare function groupFactsByEntity(facts: RawFact[]): Map<string, RawFact[]>;
+export declare function groupLinksBySource(links: RawLink[]): Map<string, RawLink[]>;
+/**
+ * For each entry, replace string ids in `expand` field keys with the resolved Entry.
+ * Lookups are batched in parallel.
+ */
+export declare function expandReferences(entries: Entry[], expandKeys: string[], fetchEntity: (id: string) => Promise<Entry | null>): Promise<Entry[]>;
+/**
+ * Cheap deep-equality fingerprint for change detection in subscriptions.
+ */
+export declare function fingerprint(value: unknown): string;
+//# sourceMappingURL=internal.d.ts.map

package/dist/cms/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/cms/internal.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACrD,MAAM,MAAM,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAwB5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,CA+B5F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAQ3E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAQ3E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,KAAK,EAAE,EAChB,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GACjD,OAAO,CAAC,KAAK,EAAE,CAAC,CA+BlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD"}

package/dist/cms/scaffold.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Scaffold generators for CMS consumer code.
+ *
+ * Used by the agent's `cms` tool (scaffold_consumer action) to write
+ * starter integration files instead of generating static data dumps.
+ */
+import type { Framework } from './types.js';
+export type ScaffoldOptions = {
+    collection: string;
+    framework?: Framework;
+    /** Field keys to expand as references (e.g. ["author"]). */
+    expand?: string[];
+    /** Override the CMS server URL. Default: http://localhost:4096 */
+    url?: string;
+    /**
+     * Project directory for multi-instance backends (e.g. opencode requires this).
+     * Baked into the generated client literal so requests route to the correct project.
+     */
+    directory?: string;
+};
+export declare function scaffoldConsumer(opts: ScaffoldOptions): string;
+export declare function scaffoldFilename(opts: ScaffoldOptions): string;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/cms/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/cms/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA6GF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAW9D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAW9D"}

package/dist/cms/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Trellis CMS Client — public types
+ *
+ * @module trellis/cms
+ */
+export type EntryStatus = 'draft' | 'published';
+export type Entry<T extends Record<string, unknown> = Record<string, unknown>> = {
+    /** Stable entity id (e.g. "blog_post:abc123" or "BlogPost:abc"). */
+    id: string;
+    /** Original type string as stored on the entity (e.g. "BlogPost"). */
+    type: string;
+    /** "draft" or "published". Missing cms_status fact is treated as "draft". */
+    status: EntryStatus;
+    /** All other facts as a flat field bag. Reference fields hold entity ids until expanded. */
+    fields: T;
+};
+export type ListOptions = {
+    /** Filter by status. Default: "published". Use "all" to include drafts. */
+    status?: 'all' | EntryStatus;
+    /** Field keys to resolve as references — string ids become nested Entry objects. */
+    expand?: string[];
+    /** Max results. Default: 100. */
+    limit?: number;
+};
+export type GetOptions = {
+    expand?: string[];
+};
+export type SubscribeExtras = {
+    /** Called when a poll fails. If absent, errors are silently swallowed. */
+    onError?: (err: unknown) => void;
+    /**
+     * Custom equality check between consecutive results. Default: deep JSON
+     * comparison. Override with a faster check (e.g. id/version-based) for
+     * very large payloads.
+     */
+    equals?: (prev: unknown, next: unknown) => boolean;
+};
+export type ListSubscribeOptions = ListOptions & SubscribeExtras;
+export type EntrySubscribeOptions = GetOptions & SubscribeExtras;
+export type Unsubscribe = () => void;
+export type ListSubscriber<T extends Record<string, unknown> = Record<string, unknown>> = (entries: Entry<T>[]) => void;
+export type EntrySubscriber<T extends Record<string, unknown> = Record<string, unknown>> = (entry: Entry<T> | null) => void;
+export type Collection = {
+    /** Normalized lowercase key (e.g. "blog_post"). */
+    key: string;
+    /** Human-readable label. */
+    label: string;
+    /** True if no explicit TypeSchema exists — schema is inferred from existing entries. */
+    inferred: boolean;
+    /** Total entry count (all statuses). */
+    count: number;
+};
+export type CmsClientOptions = {
+    /** Base URL of the Trellis-compatible HTTP server (e.g. opencode at "http://localhost:4096"). */
+    url: string;
+    /**
+     * Path prefix for store routes. Default: "/trellis/store" (matches opencode).
+     * Override only if pointing at a different server layout.
+     */
+    basePath?: string;
+    /**
+     * Project directory for multi-instance backends (opencode requires this).
+     * If omitted, the request goes to the default instance.
+     */
+    directory?: string;
+    /** Polling interval in ms for subscribe(). Minimum 500ms. Default: 2000. */
+    pollIntervalMs?: number;
+    /** Custom fetch implementation (for SSR / Node environments without global fetch). */
+    fetch?: typeof fetch;
+    /** Optional bearer token for authenticated routes. */
+    apiKey?: string;
+};
+export type Framework = 'vanilla' | 'react' | 'solid' | 'vue';
+//# sourceMappingURL=types.d.ts.map

package/dist/cms/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cms/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAEhD,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC/E,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,MAAM,EAAE,WAAW,CAAC;IACpB,4FAA4F;IAC5F,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC;IAC7B,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,eAAe,CAAC;AACjE,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,eAAe,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AACrC,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACxF,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAChB,IAAI,CAAC;AACV,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACzF,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,KACnB,IAAI,CAAC;AAEV,MAAM,MAAM,UAAU,GAAG;IACvB,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC"}

package/dist/db/index.js

@@ -1,14 +1,5 @@
 // @bun
 import"../index-c9h37r6h.js";
-import {
-  importFile,
-  importRecords
-} from "../index-skhn0agf.js";
-import {
-  deploy
-} from "../index-wt8rz4gn.js";
-import"../index-bmyt7k8n.js";
-import"../index-y6a4kj0p.js";
 import {
   ADMIN_ONLY,
   ANONYMOUS,
@@ -27,6 +18,15 @@ import {
   startServer,
   verifyJwt
 } from "../index-6n5dcebj.js";
+import {
+  importFile,
+  importRecords
+} from "../index-skhn0agf.js";
+import {
+  deploy
+} from "../index-wt8rz4gn.js";
+import"../index-bmyt7k8n.js";
+import"../index-y6a4kj0p.js";
 import"../index-n9f2qyh5.js";
 import"../index-k5b0xskw.js";
 import {

package/dist/server/index.js

@@ -1,5 +1,23 @@
 // @bun
 import"../index-c9h37r6h.js";
+import {
+  ADMIN_ONLY,
+  ANONYMOUS,
+  FULLY_PUBLIC,
+  GITHUB_PROVIDER,
+  GOOGLE_PROVIDER,
+  OWNER_ONLY,
+  PUBLIC_READ,
+  PermissionError,
+  PermissionRegistry,
+  SubscriptionManager,
+  buildOAuthUrl,
+  exchangeOAuthCode,
+  resolveAuth,
+  signJwt,
+  startServer,
+  verifyJwt
+} from "../index-6n5dcebj.js";
 import {
   importFile,
   importRecords
@@ -24,24 +42,6 @@ import {
   runSpriteCopy,
   runSpriteInteractive
 } from "../index-y6a4kj0p.js";
-import {
-  ADMIN_ONLY,
-  ANONYMOUS,
-  FULLY_PUBLIC,
-  GITHUB_PROVIDER,
-  GOOGLE_PROVIDER,
-  OWNER_ONLY,
-  PUBLIC_READ,
-  PermissionError,
-  PermissionRegistry,
-  SubscriptionManager,
-  buildOAuthUrl,
-  exchangeOAuthCode,
-  resolveAuth,
-  signJwt,
-  startServer,
-  verifyJwt
-} from "../index-6n5dcebj.js";
 import"../index-n9f2qyh5.js";
 import"../index-xzym9w0m.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trellis",
-  "version": "3.0.3",
+  "version": "3.1.3",
   "description": "Agentic State Engine — event-sourced causal graph with branching, decision traces, and realtime sync for AI-native applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -59,6 +59,11 @@
       "bun": "./dist/links/index.js",
       "import": "./dist/links/index.js"
     },
+    "./cms": {
+      "types": "./dist/cms/index.d.ts",
+      "bun": "./dist/cms/index.js",
+      "import": "./dist/cms/index.js"
+    },
     "./decisions": {
       "types": "./dist/decisions/index.d.ts",
       "bun": "./dist/decisions/index.js",
@@ -94,6 +99,7 @@
     "logo.png",
     "logo.svg",
     "LICENSE",
+    "CHANGELOG.md",
     "README.md"
   ],
   "scripts": {
@@ -101,9 +107,9 @@
     "cli": "bun run src/cli/index.ts",
     "mcp": "bun run src/mcp/index.ts",
     "mcp:docs": "bun run src/mcp/docs.ts",
-    "build": "bun build src/index.ts src/core/index.ts src/vcs/index.ts src/embeddings/index.ts src/links/index.ts src/decisions/index.ts src/server/index.ts src/client/index.ts src/react/index.ts src/db/index.ts src/cli/index.ts --outdir dist --target bun --splitting --format esm --root src --external @xenova/transformers --external @huggingface/transformers --external react && mkdir -p dist/ui && cp src/ui/client.html dist/ui/client.html && tsc -p tsconfig.build.json --emitDeclarationOnly --noEmit false --noEmitOnError false && bun run build:inspector",
+    "build": "bun build src/index.ts src/core/index.ts src/vcs/index.ts src/embeddings/index.ts src/links/index.ts src/decisions/index.ts src/server/index.ts src/client/index.ts src/react/index.ts src/db/index.ts src/cli/index.ts src/cms/index.ts --outdir dist --target bun --splitting --format esm --root src --external @xenova/transformers --external @huggingface/transformers --external react && mkdir -p dist/ui && cp src/ui/client.html dist/ui/client.html && tsc -p tsconfig.build.json --emitDeclarationOnly --noEmit false --noEmitOnError false && bun run build:inspector",
     "build:inspector": "vite build --config vite.inspector.config.ts",
-    "test": "bun test test/core test/vcs test/git test/p2 test/p3 test/p4 test/p5 test/p6 test/p7 test/engine.test.ts",
+    "test": "bun test test/core test/cms test/vcs test/git test/p2 test/p3 test/p4 test/p5 test/p6 test/p7 test/engine.test.ts",
     "test:all": "bun test",
     "prepublishOnly": "npm run test && npm run build"
   },