trellis 2.1.6 → 2.1.9

package/dist/server/tenancy.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Trellis Server — Multi-Tenant Kernel Pool
+ *
+ * Manages a pool of `TrellisKernel` instances, one per tenant.
+ * Each tenant gets an isolated SQLite database file in `<dbPath>/tenants/<tenantId>.sqlite`.
+ *
+ * The default tenant uses `<dbPath>/default.sqlite`.
+ *
+ * @module trellis/server
+ */
+import { TrellisKernel } from '../core/kernel/trellis-kernel.js';
+export declare const DEFAULT_TENANT = "default";
+/**
+ * A pool of `TrellisKernel` instances keyed by tenant ID.
+ *
+ * - Kernels are lazily created on first access.
+ * - Each tenant's data lives in `<dbPath>/tenants/<tenantId>.sqlite`.
+ * - The default tenant lives at `<dbPath>/default.sqlite`.
+ */
+export declare class TenantPool {
+    private pool;
+    private dbPath;
+    private agentId;
+    constructor(dbPath: string, agentId?: string);
+    /**
+     * Get (or create) the kernel for a tenant.
+     * Pass `null` or `undefined` to get the default tenant.
+     */
+    get(tenantId?: string | null): TrellisKernel;
+    /**
+     * Check whether a tenant has been initialized (kernel created).
+     */
+    has(tenantId: string): boolean;
+    /**
+     * List all active tenant IDs (those with open kernels).
+     */
+    activeTenants(): string[];
+    /**
+     * Close a specific tenant's kernel and remove it from the pool.
+     */
+    close(tenantId: string): void;
+    /**
+     * Close all kernels and clear the pool.
+     */
+    closeAll(): void;
+    /**
+     * Return the SQLite file path for a given tenant.
+     */
+    dbFilePath(tenantId?: string | null): string;
+    private _createKernel;
+    private _ensureDirs;
+}
+//# sourceMappingURL=tenancy.d.ts.map

package/dist/server/tenancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenancy.d.ts","sourceRoot":"","sources":["../../src/server/tenancy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAOjE,eAAO,MAAM,cAAc,YAAY,CAAC;AAOxC;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAyC;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,SAAe;IAUlD;;;OAGG;IACH,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa;IAQ5C;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAY5C,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CASpB"}

package/dist/server-3vkpnpbz.js

@@ -0,0 +1,11 @@
+// @bun
+import {
+  startServer
+} from "./index-xr7rx360.js";
+import"./index-n9f2qyh5.js";
+import"./index-5bhe57y9.js";
+import"./index-yp88he8n.js";
+import"./index-a76rekgs.js";
+export {
+  startServer
+};

package/dist/sync/http-transport.d.ts

@@ -0,0 +1,47 @@
+/**
+ * HTTP Sync Transport
+ *
+ * Implements SyncTransport over HTTP for network-based peer sync.
+ * Uses a simple JSON REST protocol:
+ *   POST /sync/message — send a sync message
+ *   GET  /sync/peers   — list connected peers
+ *
+ * The server side is a lightweight Bun HTTP server.
+ * The client side uses fetch() for outbound messages.
+ *
+ * @module trellis/sync
+ */
+import type { SyncTransport, SyncMessage, PeerId } from './types.js';
+export declare class HttpSyncTransport implements SyncTransport {
+    private localPeerId;
+    private peerUrls;
+    private messageHandler;
+    private knownPeers;
+    constructor(localPeerId: string);
+    /**
+     * Add a remote peer by URL (e.g. "http://192.168.1.10:4200").
+     */
+    addPeer(peerId: string, url: string, name?: string): void;
+    /**
+     * Remove a remote peer.
+     */
+    removePeer(peerId: string): void;
+    send(peerId: string, message: SyncMessage): Promise<void>;
+    onMessage(handler: (message: SyncMessage) => void): void;
+    /**
+     * Receive a message (called by the HTTP server handler).
+     */
+    receiveMessage(message: SyncMessage): void;
+    peers(): PeerId[];
+    getLocalPeerId(): string;
+}
+export interface HttpSyncServerConfig {
+    port: number;
+    transport: HttpSyncTransport;
+}
+/**
+ * Create a Bun-compatible HTTP request handler for sync messages.
+ * Can be used with Bun.serve() or as middleware.
+ */
+export declare function createSyncHandler(transport: HttpSyncTransport): (req: Request) => Response | null;
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/sync/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../src/sync/http-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMrE,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,UAAU,CAAkC;gBAExC,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IASzD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/D,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIxD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAa1C,KAAK,IAAI,MAAM,EAAE;IAIjB,cAAc,IAAI,MAAM;CAGzB;AAMD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,iBAAiB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,IAAI,CA2BjG"}

package/dist/sync/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Sync Module — Public Surface
+ *
+ * @module sync
+ *
+ * Re-exports the CRDT {@link reconcile|reconciler}, {@link SyncEngine} for
+ * the have→want→ops→ack protocol, and {@link MemoryTransport} for testing.
+ * Branch policies control whether sync uses linear (fast-forward) or
+ * CRDT (concurrent append) mode.
+ *
+ * @see DESIGN.md §3.5 for the branch concurrency model.
+ */
+export type { PeerId, SyncMessage, SyncHaveMessage, SyncWantMessage, SyncOpsMessage, SyncAckMessage, SyncState, BranchPolicy, SyncTransport, } from './types.js';
+export { reconcile, findForkPoint } from './reconciler.js';
+export type { ReconcileResult, ReconcileConflict } from './reconciler.js';
+export { SyncEngine } from './sync-engine.js';
+export { MemoryTransport } from './memory-transport.js';
+export { HttpSyncTransport, createSyncHandler } from './http-transport.js';
+export { WebSocketSyncTransport } from './ws-transport.js';
+export { MultiRepoManager, parseCrossRepoRef, formatCrossRepoRef, } from './multi-repo.js';
+export type { LinkedRepo, CrossRepoRef } from './multi-repo.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EACV,MAAM,EACN,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACT,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/sync/memory-transport.d.ts

@@ -0,0 +1,27 @@
+/**
+ * In-Memory Sync Transport
+ *
+ * A simple in-memory transport for testing and local multi-engine sync.
+ * Messages are delivered synchronously between connected peers.
+ */
+import type { SyncTransport, SyncMessage, PeerId } from './types.js';
+export declare class MemoryTransport implements SyncTransport {
+    private peerId;
+    private peerName;
+    private handlers;
+    private connectedPeers;
+    constructor(peerId: string, peerName?: string);
+    /**
+     * Connect two transports so they can exchange messages.
+     */
+    static connect(a: MemoryTransport, b: MemoryTransport): void;
+    /**
+     * Disconnect two transports.
+     */
+    static disconnect(a: MemoryTransport, b: MemoryTransport): void;
+    send(peerId: string, message: SyncMessage): Promise<void>;
+    onMessage(handler: (message: SyncMessage) => void): void;
+    peers(): PeerId[];
+    getPeerId(): string;
+}
+//# sourceMappingURL=memory-transport.d.ts.map

package/dist/sync/memory-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-transport.d.ts","sourceRoot":"","sources":["../../src/sync/memory-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMrE,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,cAAc,CAA2C;gBAErD,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAe;IAKrD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,IAAI;IAK5D;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,IAAI;IAKzD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIxD,KAAK,IAAI,MAAM,EAAE;IAOjB,SAAS,IAAI,MAAM;CAGpB"}

package/dist/sync/multi-repo.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Multi-Repo Linking — Cross-repo entity references.
+ *
+ * Enables entities in one Trellis repo to reference entities in another.
+ * Linked repos are registered with a local alias and remote path/URL.
+ * Cross-repo references use the format: `@alias:entityId`
+ *
+ * @module trellis/sync
+ */
+import type { TrellisKernel } from '../core/kernel/trellis-kernel.js';
+import type { Link } from '../core/store/eav-store.js';
+export interface LinkedRepo {
+    /** Local alias for the remote repo (e.g. "backend", "shared-lib"). */
+    alias: string;
+    /** Path or URL to the remote repo. */
+    location: string;
+    /** Optional human-readable description. */
+    description?: string;
+    /** When this link was established. */
+    linkedAt: string;
+    /** Last sync timestamp. */
+    lastSyncedAt?: string;
+}
+export interface CrossRepoRef {
+    /** The repo alias. */
+    repoAlias: string;
+    /** The entity ID in the remote repo. */
+    entityId: string;
+}
+export declare class MultiRepoManager {
+    private kernel;
+    constructor(kernel: TrellisKernel);
+    /**
+     * Link a remote repository.
+     */
+    linkRepo(alias: string, location: string, description?: string): Promise<void>;
+    /**
+     * Unlink a remote repository.
+     */
+    unlinkRepo(alias: string): Promise<void>;
+    /**
+     * List all linked repos.
+     */
+    listLinkedRepos(): LinkedRepo[];
+    /**
+     * Get a linked repo by alias.
+     */
+    getLinkedRepo(alias: string): LinkedRepo | null;
+    /**
+     * Create a cross-repo link: entity in this repo → entity in remote repo.
+     */
+    addCrossRepoLink(sourceEntityId: string, attribute: string, targetRepoAlias: string, targetEntityId: string): Promise<void>;
+    /**
+     * Remove a cross-repo link.
+     */
+    removeCrossRepoLink(sourceEntityId: string, attribute: string, targetRepoAlias: string, targetEntityId: string): Promise<void>;
+    /**
+     * Find all cross-repo references from a given entity.
+     */
+    getCrossRepoLinks(entityId: string): Array<{
+        attribute: string;
+        ref: CrossRepoRef;
+    }>;
+    /**
+     * Find all cross-repo references pointing to a specific remote entity.
+     */
+    findReferencesTo(repoAlias: string, entityId: string): Link[];
+    /**
+     * Update the lastSyncedAt timestamp for a linked repo.
+     */
+    markSynced(alias: string): Promise<void>;
+}
+/**
+ * Parse a cross-repo reference string.
+ * Format: `@alias:entityId`
+ */
+export declare function parseCrossRepoRef(ref: string): CrossRepoRef | null;
+/**
+ * Format a cross-repo reference string.
+ */
+export declare function formatCrossRepoRef(repoAlias: string, entityId: string): string;
+//# sourceMappingURL=multi-repo.d.ts.map

package/dist/sync/multi-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-repo.d.ts","sourceRoot":"","sources":["../../src/sync/multi-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAQ,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAM7D,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAIjC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepF;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C;;OAEG;IACH,eAAe,IAAI,UAAU,EAAE;IAc/B;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAa/C;;OAEG;IACG,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,YAAY,CAAA;KAAE,CAAC;IAgBpF;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IAM7D;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/C;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E"}

package/dist/sync/reconciler.d.ts

@@ -0,0 +1,48 @@
+/**
+ * CRDT Reconciler
+ *
+ * DESIGN.md §10.5 — Merges divergent op streams using causal ordering.
+ * Each device maintains its own causal chain. The reconciler merges
+ * divergent chains by:
+ *   1. Finding the common ancestor (fork point)
+ *   2. Collecting ops unique to each side
+ *   3. Topologically sorting the combined set by causal dependencies
+ *   4. Detecting conflicts using patch commutativity (§4.4)
+ */
+import type { VcsOp } from '../vcs/types.js';
+export interface ReconcileResult {
+    /** The merged op stream in causal order. */
+    merged: VcsOp[];
+    /** Ops that were only on side A. */
+    uniqueToA: VcsOp[];
+    /** Ops that were only on side B. */
+    uniqueToB: VcsOp[];
+    /** Common ancestor op hash (fork point). */
+    forkPoint: string | null;
+    /** Whether the merge was clean (no causal conflicts). */
+    clean: boolean;
+    /** Conflicting op pairs (both modify same file without commutativity). */
+    conflicts: ReconcileConflict[];
+}
+export interface ReconcileConflict {
+    opA: VcsOp;
+    opB: VcsOp;
+    filePath: string;
+    reason: string;
+}
+/**
+ * Find the common ancestor (fork point) of two op streams.
+ * Returns the hash of the last op that appears in both streams.
+ */
+export declare function findForkPoint(opsA: VcsOp[], opsB: VcsOp[]): string | null;
+/**
+ * Reconcile two divergent op streams into a single merged stream.
+ *
+ * Algorithm:
+ *   1. Find the fork point (last common op)
+ *   2. Split each stream into shared prefix + unique suffix
+ *   3. Check for conflicts in the unique portions
+ *   4. Interleave unique ops in causal (timestamp) order
+ */
+export declare function reconcile(opsA: VcsOp[], opsB: VcsOp[]): ReconcileResult;
+//# sourceMappingURL=reconciler.d.ts.map

package/dist/sync/reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.d.ts","sourceRoot":"","sources":["../../src/sync/reconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAM7C,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,oCAAoC;IACpC,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,KAAK,CAAC;IACX,GAAG,EAAE,KAAK,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,IAAI,CAWzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,eAAe,CA8DvE"}

package/dist/sync/sync-engine.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Sync Engine
+ *
+ * DESIGN.md §10.5 — Peer sync protocol.
+ * Coordinates push/pull of ops between peers using a transport layer.
+ * Supports both linear (fast-forward only) and CRDT (concurrent append)
+ * branch modes.
+ */
+import type { VcsOp } from '../vcs/types.js';
+import type { SyncTransport, SyncState, PeerId, BranchPolicy } from './types.js';
+import { type ReconcileResult } from './reconciler.js';
+export declare class SyncEngine {
+    private localPeerId;
+    private state;
+    private transport;
+    private getLocalOps;
+    private onOpsReceived;
+    private branchPolicy;
+    constructor(opts: {
+        localPeerId: string;
+        transport: SyncTransport;
+        getLocalOps: () => VcsOp[];
+        onOpsReceived: (ops: VcsOp[]) => void;
+        branchPolicy?: BranchPolicy;
+    });
+    /**
+     * Initiate a sync with a specific peer.
+     * Sends a 'have' message advertising our heads.
+     */
+    pushTo(peerId: string): Promise<void>;
+    /**
+     * Request ops from a peer.
+     */
+    pullFrom(peerId: string): Promise<void>;
+    /**
+     * Send all our ops to a peer (full push).
+     */
+    sendOps(peerId: string, ops?: VcsOp[]): Promise<void>;
+    /**
+     * Reconcile our ops with a remote peer's ops.
+     */
+    reconcileWith(remoteOps: VcsOp[]): ReconcileResult;
+    /**
+     * Get current sync state.
+     */
+    getState(): SyncState;
+    /**
+     * Get branch policy.
+     */
+    getBranchPolicy(): BranchPolicy;
+    /**
+     * Set branch policy.
+     */
+    setBranchPolicy(policy: BranchPolicy): void;
+    /**
+     * List known peers.
+     */
+    listPeers(): PeerId[];
+    private handleMessage;
+    private handleHave;
+    private handleWant;
+    private handleOps;
+    private handleAck;
+}
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/sync/sync-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../src/sync/sync-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,aAAa,EAEb,SAAS,EACT,MAAM,EACN,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMjF,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,YAAY,CAAe;gBAEvB,IAAI,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,aAAa,CAAC;QACzB,WAAW,EAAE,MAAM,KAAK,EAAE,CAAC;QAC3B,aAAa,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC;QACtC,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IAsBD;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3C;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,eAAe;IAKlD;;OAEG;IACH,QAAQ,IAAI,SAAS;IAIrB;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAI3C;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAQrB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,UAAU;IAmClB,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,SAAS;IA+BjB,OAAO,CAAC,SAAS;CAMlB"}

package/dist/sync/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Peer Sync — Type Definitions
+ *
+ * DESIGN.md §3.5, §10.5 — Peer sync + CRDTs.
+ * Types for peer identity, sync messages, causal DAG, and
+ * branch concurrency modes.
+ */
+import type { VcsOp } from '../vcs/types.js';
+export interface PeerId {
+    /** Unique peer identifier (typically derived from identity DID). */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Last seen timestamp. */
+    lastSeen?: string;
+}
+export type SyncMessage = SyncHaveMessage | SyncWantMessage | SyncOpsMessage | SyncAckMessage;
+/** Advertise which op hashes we have. */
+export interface SyncHaveMessage {
+    type: 'have';
+    peerId: string;
+    /** Our head op hashes (one per branch). */
+    heads: Record<string, string>;
+    /** Total op count for quick comparison. */
+    opCount: number;
+}
+/** Request ops we're missing. */
+export interface SyncWantMessage {
+    type: 'want';
+    peerId: string;
+    /** Op hashes we need (those the remote has but we don't). */
+    wantHashes: string[];
+    /** Alternatively: request all ops after a given hash. */
+    afterHash?: string;
+}
+/** Send a batch of ops. */
+export interface SyncOpsMessage {
+    type: 'ops';
+    peerId: string;
+    ops: VcsOp[];
+}
+/** Acknowledge receipt. */
+export interface SyncAckMessage {
+    type: 'ack';
+    peerId: string;
+    /** Hashes of ops we've integrated. */
+    integrated: string[];
+}
+export interface SyncState {
+    /** Our peer identity. */
+    localPeerId: string;
+    /** Known peers and their head hashes. */
+    peerHeads: Map<string, Record<string, string>>;
+    /** Ops we've sent but not yet acknowledged. */
+    pendingAcks: Set<string>;
+    /** Last sync timestamp per peer. */
+    lastSync: Map<string, string>;
+}
+export interface BranchPolicy {
+    /** If true, only fast-forward appends (one writer). Default. */
+    linear: boolean;
+}
+export interface SyncTransport {
+    /** Send a message to a specific peer. */
+    send(peerId: string, message: SyncMessage): Promise<void>;
+    /** Register a handler for incoming messages. */
+    onMessage(handler: (message: SyncMessage) => void): void;
+    /** List connected peers. */
+    peers(): PeerId[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAM7C,MAAM,WAAW,MAAM;IACrB,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,eAAe,GACf,cAAc,GACd,cAAc,CAAC;AAEnB,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,KAAK,EAAE,CAAC;CACd;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,+CAA+C;IAC/C,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,oCAAoC;IACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAMD,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,MAAM,EAAE,OAAO,CAAC;CACjB;AAMD,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,gDAAgD;IAChD,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;IACzD,4BAA4B;IAC5B,KAAK,IAAI,MAAM,EAAE,CAAC;CACnB"}

package/dist/sync/ws-transport.d.ts

@@ -0,0 +1,41 @@
+/**
+ * WebSocket Sync Transport
+ *
+ * Implements SyncTransport over WebSocket for real-time peer sync.
+ * Uses Bun's native WebSocket support for both server and client.
+ *
+ * @module trellis/sync
+ */
+import type { SyncTransport, SyncMessage, PeerId } from './types.js';
+export declare class WebSocketSyncTransport implements SyncTransport {
+    private localPeerId;
+    private connections;
+    private knownPeers;
+    private messageHandler;
+    constructor(localPeerId: string);
+    /**
+     * Connect to a remote peer's WebSocket endpoint.
+     */
+    connect(peerId: string, url: string, name?: string): Promise<void>;
+    /**
+     * Accept an incoming WebSocket connection (server side).
+     */
+    acceptConnection(peerId: string, ws: WebSocket): void;
+    send(peerId: string, message: SyncMessage): Promise<void>;
+    onMessage(handler: (message: SyncMessage) => void): void;
+    peers(): PeerId[];
+    /**
+     * Disconnect from a peer.
+     */
+    disconnect(peerId: string): void;
+    /**
+     * Disconnect from all peers.
+     */
+    disconnectAll(): void;
+    /**
+     * Check if connected to a specific peer.
+     */
+    isConnected(peerId: string): boolean;
+    getLocalPeerId(): string;
+}
+//# sourceMappingURL=ws-transport.d.ts.map

package/dist/sync/ws-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../../src/sync/ws-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMrE,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,cAAc,CAA6C;gBAEvD,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCxE;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI;IA2B/C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIxD,KAAK,IAAI,MAAM,EAAE;IAIjB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,aAAa,IAAI,IAAI;IAOrB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKpC,cAAc,IAAI,MAAM;CAGzB"}

package/dist/tenancy-tjr7kk2v.js

@@ -0,0 +1,13 @@
+// @bun
+import {
+  DEFAULT_TENANT,
+  TenantPool
+} from "./index-5p6zgspx.js";
+import"./index-7t92ej34.js";
+import"./index-5bhe57y9.js";
+import"./index-yp88he8n.js";
+import"./index-a76rekgs.js";
+export {
+  TenantPool,
+  DEFAULT_TENANT
+};

package/dist/ui/server.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Trellis UI Server
+ *
+ * Lightweight Bun HTTP server that exposes the TrellisVCS engine
+ * as a JSON API and serves a single-file force-graph visualization.
+ *
+ * Endpoints:
+ *   GET /              → client.html
+ *   GET /api/graph     → full graph (nodes + edges)
+ *   GET /api/search    → semantic search (?q=...&limit=10&type=...)
+ *   GET /api/node/:id  → node detail
+ */
+export interface GraphNode {
+    id: string;
+    label: string;
+    type: 'file' | 'milestone' | 'issue' | 'branch';
+    meta: Record<string, unknown>;
+}
+export interface GraphEdge {
+    source: string;
+    target: string;
+    type: 'milestone_file' | 'issue_branch' | 'wikilink' | 'causal';
+    label?: string;
+}
+export interface GraphData {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export interface UIServerOptions {
+    rootPath: string;
+    port?: number;
+    open?: boolean;
+}
+export declare function startUIServer(opts: UIServerOptions): Promise<{
+    port: number;
+    stop: () => void;
+}>;
+//# sourceMappingURL=server.d.ts.map

package/dist/ui/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ui/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,gBAAgB,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAoOD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC,CAwID"}

package/dist/vcs/blob-store.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Content-Addressable Blob Store
+ *
+ * Stores file content indexed by SHA-256 hash. Provides the source of truth
+ * for file reconstruction at any point in history. The EAV graph stores
+ * structural metadata; the blob store stores byte-exact content.
+ *
+ * Storage format: `.trellis/blobs/{hash}` files on disk.
+ * Future: migrate to SQLite `blobs(hash TEXT PRIMARY KEY, content BLOB)`.
+ */
+export declare class BlobStore {
+    private blobDir;
+    constructor(trellisDir: string);
+    /**
+     * Store content and return its SHA-256 hash.
+     * Idempotent — storing the same content twice is a no-op.
+     */
+    put(content: Buffer | Uint8Array): Promise<string>;
+    /**
+     * Synchronous put — uses Bun's sync crypto if available.
+     */
+    putSync(content: Buffer | Uint8Array): string;
+    /**
+     * Retrieve content by hash. Returns null if not found.
+     */
+    get(hash: string): Buffer | null;
+    /**
+     * Check if a blob exists.
+     */
+    has(hash: string): boolean;
+    /**
+     * Compute SHA-256 hash of content (async).
+     */
+    hash(content: Buffer | Uint8Array): Promise<string>;
+    /**
+     * Compute SHA-256 hash of content (sync, using Bun's CryptoHasher).
+     */
+    hashSync(content: Buffer | Uint8Array): string;
+    /**
+     * Returns the number of blobs stored.
+     */
+    count(): number;
+    /**
+     * Returns the total size of all blobs in bytes.
+     */
+    totalSize(): number;
+    private hexFromBuffer;
+}
+//# sourceMappingURL=blob-store.d.ts.map

package/dist/vcs/blob-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.d.ts","sourceRoot":"","sources":["../../src/vcs/blob-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;gBAEZ,UAAU,EAAE,MAAM;IAO9B;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IASxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM;IAS7C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM;IAM9C;;OAEG;IACH,KAAK,IAAI,MAAM;IASf;;OAEG;IACH,SAAS,IAAI,MAAM;IAgBnB,OAAO,CAAC,aAAa;CAKtB"}

package/dist/vcs/branch.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Branch Management Module
+ *
+ * Extracted from engine.ts per DESIGN.md §8.1.
+ * Handles create, switch, list, delete branch operations.
+ */
+import type { VcsOp } from './types.js';
+import type { EngineContext } from './engine-context.js';
+export interface BranchInfo {
+    name: string;
+    isCurrent: boolean;
+    createdAt?: string;
+}
+export interface BranchState {
+    currentBranch: string;
+}
+/**
+ * Create a new branch forked from the current branch.
+ */
+export declare function createBranch(ctx: EngineContext, name: string, currentBranch: string): Promise<VcsOp>;
+/**
+ * Switch to an existing branch.
+ */
+export declare function switchBranch(ctx: EngineContext, name: string): void;
+/**
+ * List all branches.
+ */
+export declare function listBranches(ctx: EngineContext, currentBranch: string): BranchInfo[];
+/**
+ * Delete a branch (cannot delete the current branch).
+ */
+export declare function deleteBranch(ctx: EngineContext, name: string, currentBranch: string): Promise<VcsOp>;
+export declare function saveBranchState(rootPath: string, state: BranchState): void;
+export declare function loadBranchState(rootPath: string): BranchState;
+//# sourceMappingURL=branch.d.ts.map