trellis 3.1.6 → 3.1.7

package/README.md

@@ -81,6 +81,7 @@ off();
 ```
 
 - **Collections**: `cms.collections()` returns explicit `TypeSchema` collections and inferred collections from existing entity types.
+- **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.

package/bin/trellis.mjs

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

package/dist/better-sqlite-backend-ahx5p0br.js

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

package/dist/cli/index.js

@@ -12,13 +12,13 @@ import {
   updateProfile,
   writeAgentScaffold,
   writeIdeScaffold
-} from "../index-q31hfjja.js";
+} from "../index-jgda3xyv.js";
 import {
   OntologyRegistry,
   builtinOntologies,
   validateStore
 } from "../index-w7ng765c.js";
-import"../index-0q7wbasy.js";
+import"../index-a2a394zz.js";
 import {
   VectorStore,
   buildRAGContext,
@@ -28,7 +28,7 @@ import {
   init_embeddings,
   init_model,
   init_store
-} from "../index-2917tjd8.js";
+} from "../index-hr9qvv77.js";
 import {
   buildRefIndex,
   createResolverContext,
@@ -45,13 +45,12 @@ import {
   parseSimple
 } from "../index-n9f2qyh5.js";
 import {
-  SqliteKernelBackend,
   TrellisKernel
-} from "../index-0zk3fx2s.js";
-import"../index-yhwjgfvj.js";
+} from "../index-4wxa8xz4.js";
 import {
   QueryEngine
 } from "../index-yp88he8n.js";
+import"../index-yhwjgfvj.js";
 import {
   __commonJS,
   __esm,
@@ -7336,9 +7335,10 @@ Server stopped.`));
     process.exit(1);
   }
 });
-function bootKernel(rootPath) {
+async function bootKernel(rootPath) {
   const dbPath = join6(rootPath, ".trellis", "kernel.db");
-  const backend = new SqliteKernelBackend(dbPath);
+  const { createKernelBackend } = await import("../core/persist/factory.js");
+  const backend = await createKernelBackend(dbPath);
   const kernel = new TrellisKernel({
     backend,
     agentId: `agent:${process.env.USER ?? "unknown"}`
@@ -7350,7 +7350,7 @@ var entityCmd = program2.command("entity").description("Manage graph entities (g
 entityCmd.command("create").description("Create a new entity in the graph").requiredOption("-i, --id <id>", 'Entity ID (e.g. "project:my-app")').requiredOption("-t, --type <type>", 'Entity type (e.g. "Project", "User")').option("-a, --attr <attrs...>", "Attributes as key=value pairs").option("-p, --path <path>", "Repository path", ".").action(async (opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     const attrs = {};
     if (opts.attr) {
@@ -7378,10 +7378,10 @@ entityCmd.command("create").description("Create a new entity in the graph").requ
     kernel.close();
   }
 });
-entityCmd.command("get").description("Get an entity by ID").argument("<id>", "Entity ID").option("-p, --path <path>", "Repository path", ".").option("--json", "Output as JSON").action((id, opts) => {
+entityCmd.command("get").description("Get an entity by ID").argument("<id>", "Entity ID").option("-p, --path <path>", "Repository path", ".").option("--json", "Output as JSON").action(async (id, opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     const entity = kernel.getEntity(id);
     if (!entity) {
@@ -7423,7 +7423,7 @@ entityCmd.command("get").description("Get an entity by ID").argument("<id>", "En
 entityCmd.command("update").description("Update attributes on an existing entity").argument("<id>", "Entity ID").requiredOption("-a, --attr <attrs...>", "Attributes as key=value pairs").option("-p, --path <path>", "Repository path", ".").action(async (id, opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     const updates = {};
     for (const pair of opts.attr) {
@@ -7452,7 +7452,7 @@ entityCmd.command("update").description("Update attributes on an existing entity
 entityCmd.command("delete").description("Delete an entity and all its facts/links").argument("<id>", "Entity ID").option("-p, --path <path>", "Repository path", ".").action(async (id, opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     const entity = kernel.getEntity(id);
     if (!entity) {
@@ -7465,10 +7465,10 @@ entityCmd.command("delete").description("Delete an entity and all its facts/link
     kernel.close();
   }
 });
-entityCmd.command("list").description("List entities, optionally filtered by type").option("-t, --type <type>", "Filter by entity type").option("-f, --filter <filters...>", "Attribute filters as key=value").option("--json", "Output as JSON").option("-p, --path <path>", "Repository path", ".").action((opts) => {
+entityCmd.command("list").description("List entities, optionally filtered by type").option("-t, --type <type>", "Filter by entity type").option("-f, --filter <filters...>", "Attribute filters as key=value").option("--json", "Output as JSON").option("-p, --path <path>", "Repository path", ".").action(async (opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     let filters;
     if (opts.filter) {
@@ -7521,7 +7521,7 @@ var factCmd = program2.command("fact").description("Add or remove individual fac
 factCmd.command("add").description("Add a fact to an entity").argument("<entity>", "Entity ID").argument("<attribute>", "Attribute name").argument("<value>", "Value").option("-p, --path <path>", "Repository path", ".").action(async (entity, attribute, value, opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     let val = value;
     if (val === "true")
@@ -7539,7 +7539,7 @@ factCmd.command("add").description("Add a fact to an entity").argument("<entity>
 factCmd.command("remove").description("Remove a fact from an entity").argument("<entity>", "Entity ID").argument("<attribute>", "Attribute name").argument("<value>", "Value to remove").option("-p, --path <path>", "Repository path", ".").action(async (entity, attribute, value, opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     let val = value;
     if (val === "true")
@@ -7554,10 +7554,10 @@ factCmd.command("remove").description("Remove a fact from an entity").argument("
     kernel.close();
   }
 });
-factCmd.command("query").description("Query facts by entity or attribute").option("-e, --entity <id>", "Filter by entity ID").option("-a, --attribute <attr>", "Filter by attribute").option("--json", "Output as JSON").option("-p, --path <path>", "Repository path", ".").action((opts) => {
+factCmd.command("query").description("Query facts by entity or attribute").option("-e, --entity <id>", "Filter by entity ID").option("-a, --attribute <attr>", "Filter by attribute").option("--json", "Output as JSON").option("-p, --path <path>", "Repository path", ".").action(async (opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     const store = kernel.getStore();
     let facts;
@@ -7592,7 +7592,7 @@ var linkCmd = program2.command("link").description("Add or remove links between
 linkCmd.command("add").description("Add a link between two entities").argument("<source>", "Source entity ID").argument("<attribute>", "Relationship attribute").argument("<target>", "Target entity ID").option("-p, --path <path>", "Repository path", ".").action(async (source, attribute, target, opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     await kernel.addLink(source, attribute, target);
     console.log(source_default.green(`\u2713 Link: ${source_default.bold(source)} \u2014[${attribute}]\u2192 ${source_default.bold(target)}`));
@@ -7603,7 +7603,7 @@ linkCmd.command("add").description("Add a link between two entities").argument("
 linkCmd.command("remove").description("Remove a link between two entities").argument("<source>", "Source entity ID").argument("<attribute>", "Relationship attribute").argument("<target>", "Target entity ID").option("-p, --path <path>", "Repository path", ".").action(async (source, attribute, target, opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     await kernel.removeLink(source, attribute, target);
     console.log(source_default.green(`\u2713 Removed: ${source_default.bold(source)} \u2014[${attribute}]\u2192 ${source_default.bold(target)}`));
@@ -7611,10 +7611,10 @@ linkCmd.command("remove").description("Remove a link between two entities").argu
     kernel.close();
   }
 });
-linkCmd.command("query").description("Query links for an entity").option("-e, --entity <id>", "Entity ID").option("-a, --attribute <attr>", "Relationship attribute").option("--json", "Output as JSON").option("-p, --path <path>", "Repository path", ".").action((opts) => {
+linkCmd.command("query").description("Query links for an entity").option("-e, --entity <id>", "Entity ID").option("-a, --attribute <attr>", "Relationship attribute").option("--json", "Output as JSON").option("-p, --path <path>", "Repository path", ".").action(async (opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     const store = kernel.getStore();
     let links;
@@ -7647,10 +7647,10 @@ linkCmd.command("query").description("Query links for an entity").option("-e, --
     kernel.close();
   }
 });
-program2.command("query").description("Execute an EQL-S query against the graph").argument("<query>", 'EQL-S query string (or "find ?e where attr = value" shorthand)').option("-p, --path <path>", "Repository path", ".").option("--json", "Output as JSON").action((queryStr, opts) => {
+program2.command("query").description("Execute an EQL-S query against the graph").argument("<query>", 'EQL-S query string (or "find ?e where attr = value" shorthand)').option("-p, --path <path>", "Repository path", ".").option("--json", "Output as JSON").action(async (queryStr, opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     const store = kernel.getStore();
     const engine = new QueryEngine(store);
@@ -7690,7 +7690,7 @@ ${result.count} result(s) in ${result.executionTime.toFixed(1)}ms`));
 program2.command("repl").description("Interactive EQL-S query shell").option("-p, --path <path>", "Repository path", ".").action(async (opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   const store = kernel.getStore();
   const engine = new QueryEngine(store);
   console.log(source_default.cyan.bold("Trellis EQL-S REPL"));
@@ -7866,10 +7866,10 @@ Relations:`));
   console.log(source_default.dim("Available ontologies: " + registry.list().map((s) => s.id).join(", ")));
   console.log(source_default.dim("Available types: " + registry.listEntityTypes().join(", ")));
 });
-ontologyCmd.command("validate").description("Validate all entities in the graph against registered ontologies").option("-p, --path <path>", "Repository path", ".").option("--strict", "Treat unknown types as errors").action((opts) => {
+ontologyCmd.command("validate").description("Validate all entities in the graph against registered ontologies").option("-p, --path <path>", "Repository path", ".").option("--strict", "Treat unknown types as errors").action(async (opts) => {
   const rootPath = resolve(opts.path);
   requireRepo(rootPath);
-  const kernel = bootKernel(rootPath);
+  const kernel = await bootKernel(rootPath);
   try {
     const registry = new OntologyRegistry;
     for (const o of builtinOntologies)
@@ -8021,8 +8021,8 @@ db.command("init").description("Initialize a new Trellis DB in the current direc
 });
 db.command("serve").description("Start the Trellis DB HTTP + WebSocket server").option("-p, --port <port>", "Override port from config").option("--config-dir <dir>", "Directory containing .trellis-db.json", ".").action(async (opts) => {
   const { readConfig } = await import("../config-8hczw0rs.js");
-  const { TenantPool } = await import("../tenancy-7d1g4ayp.js");
-  const { startServer } = await import("../server-mrctdwzr.js");
+  const { TenantPool } = await import("../tenancy-pjm32b4v.js");
+  const { startServer } = await import("../server-szdjx0nt.js");
   const config = readConfig(opts.configDir);
   if (!config) {
     console.error(source_default.red("No .trellis-db.json found. Run `trellis db init` first."));
@@ -8034,7 +8034,8 @@ db.command("serve").description("Start the Trellis DB HTTP + WebSocket server").
   }
   const port = opts.port ? parseInt(opts.port) : config.port ?? 3000;
   const pool = new TenantPool(config.dbPath);
-  const server = startServer({ port, config, pool });
+  const { startServerCrossRuntime } = await import("../server-szdjx0nt.js");
+  const server = await startServerCrossRuntime({ port, config, pool });
   console.log(source_default.green(`\u2713 Trellis DB running`));
   console.log(source_default.dim(`  URL:  http://localhost:${port}`));
   console.log(source_default.dim(`  Docs: GET http://localhost:${port}/health`));
@@ -8043,7 +8044,7 @@ db.command("serve").description("Start the Trellis DB HTTP + WebSocket server").
   }
 });
 db.command("create <type> [json]").description("Create an entity (json can be a JSON string or @file.json)").option("--config-dir <dir>", "Config directory", ".").option("--tenant <id>", "Tenant ID").action(async (type, jsonArg, opts) => {
-  const { TrellisDb } = await import("../sdk-snn5gad3.js");
+  const { TrellisDb } = await import("../sdk-bepky0xs.js");
   const db2 = TrellisDb.fromConfig(opts.configDir);
   let attributes = {};
   if (jsonArg) {
@@ -8056,7 +8057,7 @@ db.command("create <type> [json]").description("Create an entity (json can be a
   db2.close();
 });
 db.command("read <id>").description("Read an entity by ID").option("--config-dir <dir>", "Config directory", ".").action(async (id, opts) => {
-  const { TrellisDb } = await import("../sdk-snn5gad3.js");
+  const { TrellisDb } = await import("../sdk-bepky0xs.js");
   const db2 = TrellisDb.fromConfig(opts.configDir);
   const entity = await db2.read(id);
   if (!entity) {
@@ -8067,7 +8068,7 @@ db.command("read <id>").description("Read an entity by ID").option("--config-dir
   db2.close();
 });
 db.command("update <id> <json>").description("Update entity attributes (JSON string or @file.json)").option("--config-dir <dir>", "Config directory", ".").action(async (id, jsonArg, opts) => {
-  const { TrellisDb } = await import("../sdk-snn5gad3.js");
+  const { TrellisDb } = await import("../sdk-bepky0xs.js");
   const db2 = TrellisDb.fromConfig(opts.configDir);
   const { readFileSync: readFileSync4 } = await import("fs");
   const raw = jsonArg.startsWith("@") ? readFileSync4(jsonArg.slice(1), "utf8") : jsonArg;
@@ -8076,14 +8077,14 @@ db.command("update <id> <json>").description("Update entity attributes (JSON str
   db2.close();
 });
 db.command("delete <id>").description("Delete an entity by ID").option("--config-dir <dir>", "Config directory", ".").action(async (id, opts) => {
-  const { TrellisDb } = await import("../sdk-snn5gad3.js");
+  const { TrellisDb } = await import("../sdk-bepky0xs.js");
   const db2 = TrellisDb.fromConfig(opts.configDir);
   await db2.delete(id);
   console.log(source_default.green(`\u2713 Deleted: ${source_default.bold(id)}`));
   db2.close();
 });
 db.command("list").description("List entities").option("--type <type>", "Filter by entity type").option("--limit <n>", "Max results", "50").option("--offset <n>", "Offset", "0").option("--config-dir <dir>", "Config directory", ".").action(async (opts) => {
-  const { TrellisDb } = await import("../sdk-snn5gad3.js");
+  const { TrellisDb } = await import("../sdk-bepky0xs.js");
   const db2 = TrellisDb.fromConfig(opts.configDir);
   const result = await db2.list(opts.type, {
     limit: parseInt(opts.limit),
@@ -8093,7 +8094,7 @@ db.command("list").description("List entities").option("--type <type>", "Filter
   db2.close();
 });
 db.command("query <eql>").description("Run an EQL-S query").option("--config-dir <dir>", "Config directory", ".").action(async (eql, opts) => {
-  const { TrellisDb } = await import("../sdk-snn5gad3.js");
+  const { TrellisDb } = await import("../sdk-bepky0xs.js");
   const db2 = TrellisDb.fromConfig(opts.configDir);
   const result = await db2.query(eql);
   console.log(JSON.stringify(result.bindings, null, 2));
@@ -8103,7 +8104,7 @@ db.command("query <eql>").description("Run an EQL-S query").option("--config-dir
 db.command("upload <file>").description("Upload a file to the blob store").option("--config-dir <dir>", "Config directory", ".").option("--type <mime>", "MIME type (auto-detected if omitted)").action(async (filePath, opts) => {
   const { readFileSync: readFileSync4 } = await import("fs");
   const { extname } = await import("path");
-  const { TrellisDb } = await import("../sdk-snn5gad3.js");
+  const { TrellisDb } = await import("../sdk-bepky0xs.js");
   const mimeMap = {
     ".png": "image/png",
     ".jpg": "image/jpeg",
@@ -8124,7 +8125,7 @@ db.command("upload <file>").description("Upload a file to the blob store").optio
 });
 db.command("import <file>").description("Import data from CSV, JSON, NDJSON, or Parquet").requiredOption("--type <type>", "Entity type to assign to each record").option("--id-field <field>", "Field to use as entity ID").option("--limit <n>", "Max rows to import").option("--config-dir <dir>", "Config directory", ".").option("--tenant <id>", "Tenant ID").action(async (filePath, opts) => {
   const { readConfig } = await import("../config-8hczw0rs.js");
-  const { TenantPool } = await import("../tenancy-7d1g4ayp.js");
+  const { TenantPool } = await import("../tenancy-pjm32b4v.js");
   const { importFile } = await import("../import-s2b8e0ft.js");
   const config = readConfig(opts.configDir);
   if (!config?.dbPath) {
@@ -8132,7 +8133,7 @@ db.command("import <file>").description("Import data from CSV, JSON, NDJSON, or
     process.exit(1);
   }
   const pool = new TenantPool(config.dbPath);
-  const kernel = pool.get(opts.tenant ?? null);
+  const kernel = await pool.preload(opts.tenant ?? null);
   const result = await importFile(kernel, filePath, {
     type: opts.type,
     idField: opts.idField,
@@ -8482,12 +8483,16 @@ vmProgram.command("code [name]").description("Create Sprite, deploy Trellis, ope
   const { loadVmConfig, trackSprite, getActiveSprite } = await import("../vm-config-6xhsj6b3.js");
   const { deploy } = await import("../deploy-999q207z.js");
   const openUrl = (url) => {
-    if (process.platform === "darwin") {
-      Bun.spawn(["open", url], { stdio: "ignore" });
-    } else if (process.platform === "linux") {
-      Bun.spawn(["xdg-open", url], { stdio: "ignore" });
-    } else {
+    const cmd = process.platform === "darwin" ? "open" : process.platform === "linux" ? "xdg-open" : null;
+    if (!cmd) {
       console.log(url);
+      return;
+    }
+    if (typeof globalThis.Bun !== "undefined") {
+      globalThis.Bun.spawn([cmd, url], { stdio: "ignore" });
+    } else {
+      const { spawn } = __require("child_process");
+      spawn(cmd, [url], { stdio: "ignore", detached: true }).unref();
     }
   };
   try {
@@ -8717,6 +8722,72 @@ program2.command("code").alias("ide").description('Launch OpenCode in "Harness"
     process.exit(code ?? 0);
   });
 });
+program2.command("studio").alias("web").description("Launch Trellis Studio in your browser, bridged to this repo").option("-p, --path <path>", "Repository path", ".").option("--port <port>", "Studio HTTP port (defaults to turtlecode default)").option("--new", "Open the new-project prompt instead of the current directory").option("--no-open", "Do not auto-open the browser").option("--no-init", "Skip initialization even if not a Trellis workspace").option("--quiet-backend", "Suppress backend stdout/stderr").allowUnknownOption(true).action(async (opts, command) => {
+  const { resolve: resolve2 } = await import("path");
+  const { existsSync: existsSync6, readFileSync: readFileSync4 } = await import("fs");
+  const { spawn } = await import("child_process");
+  const { createRequire } = await import("module");
+  const path = await import("path");
+  const rootPath = resolve2(opts.path);
+  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"));
+    }
+  }
+  const requireFn = createRequire(import.meta.url);
+  let turtlecodeBin = null;
+  try {
+    const pkgPath = requireFn.resolve("turtlecode/package.json");
+    const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
+    const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.turtlecode;
+    if (binRel) {
+      const candidate = path.join(path.dirname(pkgPath), binRel);
+      if (existsSync6(candidate))
+        turtlecodeBin = candidate;
+    }
+  } catch {}
+  const passthrough = [];
+  if (opts.port)
+    passthrough.push("--port", String(opts.port));
+  if (opts.new)
+    passthrough.push("--new");
+  if (!opts.open)
+    passthrough.push("--no-open");
+  if (opts.quietBackend)
+    passthrough.push("--quiet-backend");
+  const extra = command.args ?? [];
+  passthrough.push(...extra);
+  const spawnArgs = turtlecodeBin ? [turtlecodeBin, ...passthrough] : ["turtlecode", ...passthrough];
+  const spawnCmd = turtlecodeBin ? process.execPath : "npx";
+  console.log(source_default.green("\u26A1 Launching Trellis Studio..."));
+  console.log(source_default.dim(`   Project: ${rootPath}`));
+  console.log("");
+  const child = spawn(spawnCmd, spawnArgs, {
+    stdio: "inherit",
+    cwd: rootPath,
+    env: process.env
+  });
+  child.on("error", (err) => {
+    if (err.code === "ENOENT" && !turtlecodeBin) {
+      console.error(source_default.red("\nCould not find `turtlecode`. Reinstall trellis, or install turtlecode globally: `npm i -g turtlecode`\n"));
+    } else {
+      console.error(source_default.red(`
+Failed to launch Studio: ${err.message}`));
+    }
+    process.exit(1);
+  });
+  const shutdown = () => {
+    if (!child.killed)
+      child.kill();
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+  child.on("exit", (code) => {
+    process.exit(code ?? 0);
+  });
+});
 async function waitForMcpReady(url, timeoutMs) {
   const { get } = await import("http");
   const start = Date.now();

package/dist/client/index.js

@@ -3,7 +3,7 @@ import"../index-k5b0xskw.js";
 import {
   FetchError,
   TrellisDb
-} from "../index-7e27kvvj.js";
+} from "../index-wncptktd.js";
 import {
   CONFIG_FILE,
   configPath,
@@ -13,10 +13,11 @@ import {
   updateConfig,
   writeConfig
 } from "../index-xzym9w0m.js";
-import"../index-y3d71wzd.js";
-import"../index-0zk3fx2s.js";
-import"../index-yhwjgfvj.js";
+import"../index-7pjz3tsy.js";
+import"../index-4wxa8xz4.js";
 import"../index-yp88he8n.js";
+import"../index-yhwjgfvj.js";
+import"../index-h7zxhhhh.js";
 import"../index-a76rekgs.js";
 export {
   writeConfig,

package/dist/cms/client.d.ts

@@ -23,7 +23,7 @@
  *
  * @module trellis/cms
  */
-import type { CmsClientOptions, Collection, Entry, EntrySubscribeOptions, EntrySubscriber, GetOptions, ListOptions, ListSubscribeOptions, ListSubscriber, Unsubscribe } from './types.js';
+import type { CmsClientOptions, Collection, Entry, EntrySubscribeOptions, EntrySubscriber, GetOptions, ListOptions, ListSubscribeOptions, ListSubscriber, Unsubscribe, FieldDefinition } from './types.js';
 import { type RawEntity, type RawFact } from './internal.js';
 export declare class CmsClient {
     private readonly url;
@@ -71,6 +71,7 @@ export declare class CollectionRef<T extends Record<string, unknown> = Record<st
      * and one HTTP request per cycle.
      */
     subscribe(callback: ListSubscriber<T>, opts?: ListSubscribeOptions): Unsubscribe;
+    schema(): Promise<FieldDefinition[]>;
 }
 export declare class EntryRef<T extends Record<string, unknown> = Record<string, unknown>> {
     private readonly client;