trellis 2.1.7 → 3.0.2

package/dist/plugins/plan-approval/plugin.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Plan Approval Plugin — Trellis plugin for multi-turn planning with
+ * buffered mutations and user approval.
+ *
+ * Registers the plan approval ontology and provides agent tool definitions
+ * that the harness can register for plan-mode interactions.
+ *
+ * @module trellis/plugins/plan-approval
+ */
+import type { PluginDef } from '../../core/plugins/types.js';
+import type { ToolHandler } from '../../core/agents/types.js';
+import type { PlanManager } from './plan-manager.js';
+/**
+ * Create the plan approval plugin instance.
+ */
+export declare function createPlanApprovalPlugin(): PluginDef;
+/**
+ * Context required by plan approval tools.
+ */
+export interface PlanToolContext {
+    planManager: PlanManager;
+}
+/**
+ * Tool: enterPlanMode
+ *
+ * Agent calls this when it wants to plan a set of operations before
+ * executing them. Subsequent plan* tool calls buffer operations.
+ */
+export declare function createEnterPlanModeTool(ctx: PlanToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+/**
+ * Tool: planCreateEntity
+ *
+ * Buffer a createEntity operation in the active plan.
+ */
+export declare function createPlanCreateEntityTool(ctx: PlanToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+/**
+ * Tool: planUpdateEntity
+ */
+export declare function createPlanUpdateEntityTool(ctx: PlanToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+/**
+ * Tool: planAddLink
+ */
+export declare function createPlanAddLinkTool(ctx: PlanToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+/**
+ * Tool: submitPlan
+ *
+ * Submit the active plan for user review. This signals the harness to
+ * pause the agent loop and yield control to the caller.
+ *
+ * The tool result includes `_planPending: true` which the harness
+ * recognizes as a signal to set run status to `plan_pending`.
+ */
+export declare function createSubmitPlanTool(ctx: PlanToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+/**
+ * Tool: cancelPlan
+ */
+export declare function createCancelPlanTool(ctx: PlanToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+/**
+ * Register all plan approval tools with an AgentHarness.
+ */
+export declare function registerPlanTools(harness: {
+    registerTool: (def: {
+        name: string;
+        description: string;
+        schema?: string;
+    }, handler: ToolHandler) => Promise<string>;
+}, ctx: PlanToolContext): Promise<string[]>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/plan-approval/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/plan-approval/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,CA6BpD;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG;IAC7D,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CAwBA;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,GAAG;IAChE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CA2BA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,GAAG;IAChE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CAyBA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG;IAC3D,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CA2BA;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,GAAG;IAC1D,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CA+BA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,GAAG;IAC1D,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CAeA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE;IAAE,YAAY,EAAE,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,EACjI,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB"}

package/dist/plugins/proactive-watcher/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Proactive Watcher — Trellis plugin that monitors the graph and surfaces
+ * agent suggestions proactively.
+ *
+ * @module trellis/plugins/proactive-watcher
+ *
+ * @example
+ * ```typescript
+ * import { createProactiveWatcherPlugin } from 'trellis/plugins/proactive-watcher';
+ *
+ * const plugin = createProactiveWatcherPlugin(kernel, harness);
+ *
+ * // Add custom heuristic rules
+ * plugin.manager.addRule({
+ *   id: 'missing-docs',
+ *   description: 'Suggests docs when new feature flags are added',
+ *   condition: (op) => op.facts?.some(f => f.v === 'FeatureFlag') ?? false,
+ *   agentId: 'proactive-agent',
+ *   promptFactory: (op) => `A new feature flag was added: ${JSON.stringify(op)}. Suggest writing docs.`
+ * });
+ *
+ * pluginRegistry.register(plugin);
+ * ```
+ */
+export { proactiveWatcherOntology } from './ontology.js';
+export { createProactiveWatcherPlugin } from './plugin.js';
+export { WatcherManager, type WatcherRule, } from './watcher-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/proactive-watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/proactive-watcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC"}

package/dist/plugins/proactive-watcher/ontology.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Proactive Watcher Ontology
+ *
+ * Defines the schemas for proactive suggestions generated by the watcher.
+ */
+import type { OntologySchema } from '../../core/ontology/types.js';
+export declare const proactiveWatcherOntology: OntologySchema;
+//# sourceMappingURL=ontology.d.ts.map

package/dist/plugins/proactive-watcher/ontology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ontology.d.ts","sourceRoot":"","sources":["../../../src/plugins/proactive-watcher/ontology.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,eAAO,MAAM,wBAAwB,EAAE,cAoDtC,CAAC"}

package/dist/plugins/proactive-watcher/plugin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Proactive Watcher Plugin
+ *
+ * Subscribes to Kernel events (op:applied, entity:updated, etc.) via the
+ * Plugin EventBus. When specific patterns are detected, it invokes an agent
+ * to generate suggestions (e.g. creating tasks, documenting changes).
+ *
+ * Suggestions are currently "suggestion-only" (v1) and can be surfaced
+ * to the user without automatically executing.
+ *
+ * @module trellis/plugins/proactive-watcher
+ */
+import type { PluginDef } from '../../core/plugins/types.js';
+import type { TrellisKernel } from '../../core/kernel/trellis-kernel.js';
+import type { AgentHarness } from '../../core/agents/harness.js';
+import { WatcherManager } from './watcher-manager.js';
+export declare function createProactiveWatcherPlugin(kernel: TrellisKernel, harness: AgentHarness): PluginDef & {
+    manager: WatcherManager;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/proactive-watcher/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/proactive-watcher/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,YAAY,GACpB,SAAS,GAAG;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,CAgCzC"}

package/dist/plugins/proactive-watcher/watcher-manager.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Watcher Manager
+ *
+ * Processes kernel operations asynchronously, evaluates simple heuristics,
+ * and launches background agent tasks to generate Proactive Suggestions.
+ */
+import type { TrellisKernel } from '../../core/kernel/trellis-kernel.js';
+import type { AgentHarness } from '../../core/agents/harness.js';
+import type { KernelOp } from '../../core/persist/backend.js';
+import type { PluginContext } from '../../core/plugins/types.js';
+export interface WatcherRule {
+    id: string;
+    description: string;
+    /** Evaluate if the rule matches this operation */
+    condition: (op: KernelOp, kernel: TrellisKernel) => boolean;
+    /** Agent ID to invoke if condition matches */
+    agentId: string;
+    /** Generate the prompt for the agent based on the operation */
+    promptFactory: (op: KernelOp) => string;
+}
+export declare class WatcherManager {
+    private kernel;
+    private harness;
+    private ctx;
+    private rules;
+    private suggestionCounter;
+    constructor(kernel: TrellisKernel, harness: AgentHarness);
+    setContext(ctx: PluginContext | null): void;
+    addRule(rule: WatcherRule): void;
+    /**
+     * Called by the event handler on `op:applied`.
+     */
+    processOperation(data: unknown): Promise<void>;
+    private _evaluateRule;
+}
+//# sourceMappingURL=watcher-manager.d.ts.map

package/dist/plugins/proactive-watcher/watcher-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-manager.d.ts","sourceRoot":"","sources":["../../../src/plugins/proactive-watcher/watcher-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC;IAC5D,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,aAAa,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,MAAM,CAAC;CACzC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,GAAG,CAA8B;IACzC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,iBAAiB,CAAK;gBAElB,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY;IAKxD,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAI3C,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAIhC;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YA+BtC,aAAa;CAuE5B"}

package/dist/plugins/sprite-tools/checkpoint-middleware.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Checkpoint Middleware — Deterministic auto-checkpointing before large mutations.
+ *
+ * Counts facts + links in each mutation and triggers a kernel checkpoint when
+ * a batch exceeds a configurable threshold. This ensures safety-critical
+ * behavior is deterministic (middleware), not dependent on LLM prompt
+ * compliance.
+ *
+ * @module trellis/plugins/sprite-tools
+ */
+import type { KernelMiddleware } from '../../core/kernel/middleware.js';
+export interface CheckpointMiddlewareConfig {
+    /**
+     * Trigger a checkpoint when a single mutation batch contains this many
+     * or more combined facts + links (adds + deletes).
+     * Default: 50.
+     */
+    threshold?: number;
+    /**
+     * Callback invoked when a checkpoint is auto-triggered.
+     * Useful for logging or notification.
+     */
+    onCheckpoint?: (batchSize: number) => void;
+}
+/**
+ * Create a CheckpointMiddleware instance.
+ *
+ * The middleware hooks into `handleOp`. It inspects each op's payload size
+ * and if it exceeds the threshold, calls `checkpoint()` on the kernel
+ * *before* the op proceeds through the chain.
+ *
+ * Because the middleware only has access to the op and the `next` function
+ * (not the kernel directly), the actual checkpoint call is deferred to the
+ * caller via the `onCheckpoint` callback. The caller should wire this to
+ * `kernel.checkpoint()`.
+ */
+export declare function createCheckpointMiddleware(config?: CheckpointMiddlewareConfig): KernelMiddleware & {
+    getStats: () => {
+        checkpointsTriggered: number;
+        lastBatchSize: number;
+    };
+};
+//# sourceMappingURL=checkpoint-middleware.d.ts.map

package/dist/plugins/sprite-tools/checkpoint-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-middleware.d.ts","sourceRoot":"","sources":["../../../src/plugins/sprite-tools/checkpoint-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,iCAAiC,CAAC;AAGzC,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,CAAC,EAAE,0BAA0B,GAClC,gBAAgB,GAAG;IAAE,QAAQ,EAAE,MAAM;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAqChG"}

package/dist/plugins/sprite-tools/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Sprite Tools — Trellis plugin for agent-driven checkpoint, deploy,
+ * rollback, and infrastructure management.
+ *
+ * @module trellis/plugins/sprite-tools
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createSpriteToolsPlugin,
+ *   registerSpriteTools,
+ *   createCheckpointMiddleware,
+ * } from 'trellis/plugins/sprite-tools';
+ *
+ * // 1. Register the plugin
+ * const plugin = createSpriteToolsPlugin();
+ * pluginRegistry.register(plugin);
+ * await pluginRegistry.load('trellis:sprite-tools', kernel, ontologyRegistry);
+ *
+ * // 2. Add checkpoint middleware (auto-checkpoint before large mutations)
+ * const checkpointMw = createCheckpointMiddleware({
+ *   threshold: 50,
+ *   onCheckpoint: (batchSize) => {
+ *     console.log(`Auto-checkpoint triggered (batch: ${batchSize})`);
+ *     kernel.checkpoint();
+ *   },
+ * });
+ * // Wire into kernel config or add via addMiddleware()
+ *
+ * // 3. Register tools with the agent harness
+ * await registerSpriteTools(harness, { kernel });
+ *
+ * // Agent can now use: createCheckpoint, rollback, deployToSprite,
+ * // getDeployStatus, listOps
+ * ```
+ */
+export { createSpriteToolsPlugin } from './plugin.js';
+export { registerSpriteTools, createCheckpointTool, createRollbackTool, createGetDeployStatusTool, createDeployToSpriteTool, createListOpsTool, type SpriteToolContext, } from './plugin.js';
+export { createCheckpointMiddleware, type CheckpointMiddlewareConfig, } from './checkpoint-middleware.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/sprite-tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/sprite-tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,0BAA0B,EAC1B,KAAK,0BAA0B,GAChC,MAAM,4BAA4B,CAAC"}

package/dist/plugins/sprite-tools/plugin.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Sprite Tools Plugin — Agent tools for checkpoint, deploy, rollback,
+ * and deploy status.
+ *
+ * Thin wrappers around existing kernel primitives:
+ *   - checkpoint → kernel.checkpoint()
+ *   - deploy    → deploy() from src/server/deploy.ts
+ *   - rollback  → kernel.timeTravel(opHash)
+ *   - status    → readConfig() from src/client/config.ts
+ *
+ * @module trellis/plugins/sprite-tools
+ */
+import type { PluginDef } from '../../core/plugins/types.js';
+import type { ToolHandler } from '../../core/agents/types.js';
+import type { TrellisKernel } from '../../core/kernel/trellis-kernel.js';
+export declare function createSpriteToolsPlugin(): PluginDef;
+export interface SpriteToolContext {
+    kernel: TrellisKernel;
+    /** Directory containing .trellis-db.json (defaults to cwd). */
+    configDir?: string;
+}
+export declare function createCheckpointTool(ctx: SpriteToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+export declare function createRollbackTool(ctx: SpriteToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+export declare function createGetDeployStatusTool(ctx: SpriteToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+export declare function createDeployToSpriteTool(ctx: SpriteToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+export declare function createListOpsTool(ctx: SpriteToolContext): {
+    def: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    handler: ToolHandler;
+};
+export declare function registerSpriteTools(harness: {
+    registerTool: (def: {
+        name: string;
+        description: string;
+        schema?: string;
+    }, handler: ToolHandler) => Promise<string>;
+}, ctx: SpriteToolContext): Promise<string[]>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/sprite-tools/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/sprite-tools/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAMzE,wBAAgB,uBAAuB,IAAI,SAAS,CAenD;AAMD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG;IAC5D,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CAkCA;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG;IAC1D,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CA2CA;AAMD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,iBAAiB,GAAG;IACjE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CAgDA;AAMD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,iBAAiB,GAAG;IAChE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CAkEA;AAMD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG;IACzD,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC;CACtB,CAuCA;AAMD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE;IACP,YAAY,EAAE,CACZ,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3D,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB,EACD,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnB"}

package/dist/react/index.js

@@ -0,0 +1,189 @@
+// @bun
+import {
+  TrellisDb
+} from "../index-7e27kvvj.js";
+import"../index-xzym9w0m.js";
+import"../index-y3d71wzd.js";
+import"../index-0zk3fx2s.js";
+import"../index-yhwjgfvj.js";
+import"../index-yp88he8n.js";
+import"../index-a76rekgs.js";
+
+// src/react/provider.tsx
+import {
+  createContext,
+  useContext,
+  useMemo,
+  useEffect
+} from "react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+var TrellisContext = createContext(null);
+function TrellisProvider({
+  url,
+  apiKey,
+  tenantId,
+  children
+}) {
+  const client = useMemo(() => {
+    const opts = { url };
+    if (apiKey)
+      opts.apiKey = apiKey;
+    if (tenantId)
+      opts.tenantId = tenantId;
+    return new TrellisDb(opts);
+  }, [url, apiKey, tenantId]);
+  useEffect(() => {
+    return () => {
+      client.disconnect();
+    };
+  }, [client]);
+  return /* @__PURE__ */ jsxDEV(TrellisContext.Provider, {
+    value: client,
+    children
+  }, undefined, false, undefined, this);
+}
+function useTrellis() {
+  const client = useContext(TrellisContext);
+  if (!client) {
+    throw new Error("useTrellis() must be used within a <TrellisProvider>. " + 'Wrap your app with <TrellisProvider url="...">.');
+  }
+  return client;
+}
+// src/react/hooks.ts
+import { useState, useEffect as useEffect2, useCallback, useRef } from "react";
+function useEntity(id, options = {}) {
+  const client = useTrellis();
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const fetch = useCallback(async () => {
+    if (!id) {
+      setData(null);
+      setLoading(false);
+      return;
+    }
+    try {
+      setLoading(true);
+      const entity = await client.read(id);
+      setData(entity);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, id]);
+  useEffect2(() => {
+    fetch();
+  }, [fetch]);
+  useEffect2(() => {
+    if (!options.pollInterval || !id)
+      return;
+    const interval = setInterval(fetch, options.pollInterval);
+    return () => clearInterval(interval);
+  }, [fetch, options.pollInterval, id]);
+  return { data, loading, error, refetch: fetch };
+}
+function useEntities(options = {}) {
+  const client = useTrellis();
+  const [data, setData] = useState([]);
+  const [total, setTotal] = useState(0);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const optsRef = useRef(options);
+  optsRef.current = options;
+  const fetch = useCallback(async () => {
+    try {
+      setLoading(true);
+      const result = await client.list(optsRef.current.type, {
+        limit: optsRef.current.limit,
+        offset: optsRef.current.offset
+      });
+      setData(result.data);
+      setTotal(result.total);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, options.type, options.limit, options.offset]);
+  useEffect2(() => {
+    fetch();
+  }, [fetch]);
+  useEffect2(() => {
+    if (!options.pollInterval)
+      return;
+    const interval = setInterval(fetch, options.pollInterval);
+    return () => clearInterval(interval);
+  }, [fetch, options.pollInterval]);
+  return { data, total, loading, error, refetch: fetch };
+}
+function useQuery(eql, options = {}) {
+  const client = useTrellis();
+  const [data, setData] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const enabled = options.enabled !== false;
+  const refetch = useCallback(async () => {
+    if (!enabled || !eql.trim())
+      return;
+    try {
+      setLoading(true);
+      const result = await client.query(eql);
+      setData(result.bindings);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, eql, enabled]);
+  useEffect2(() => {
+    if (!enabled || !eql.trim()) {
+      setData([]);
+      setLoading(false);
+      return;
+    }
+    setLoading(true);
+    const sub = client.subscribe(eql, (result) => {
+      setData(result);
+      setLoading(false);
+      setError(null);
+    });
+    return () => {
+      sub.unsubscribe();
+    };
+  }, [client, eql, enabled]);
+  return { data, loading, error, refetch };
+}
+function useMutation() {
+  const client = useTrellis();
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  async function run(fn) {
+    setLoading(true);
+    setError(null);
+    try {
+      return await fn();
+    } catch (err) {
+      const e = err instanceof Error ? err : new Error(String(err));
+      setError(e);
+      throw e;
+    } finally {
+      setLoading(false);
+    }
+  }
+  const create = useCallback((type, attributes = {}) => run(() => client.create(type, attributes)), [client]);
+  const update = useCallback((id, attributes) => run(() => client.update(id, attributes)), [client]);
+  const remove = useCallback((id) => run(() => client.delete(id)), [client]);
+  return { create, update, remove, loading, error };
+}
+export {
+  useTrellis,
+  useQuery,
+  useMutation,
+  useEntity,
+  useEntities,
+  TrellisProvider
+};

package/dist/scaffold/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Scaffold module index
+ * @module trellis/scaffold
+ */
+export { inferProjectContext } from './infer.js';
+export type { ProjectContext, InferenceConfidence, InferOptions } from './infer.js';
+export { loadProfile, saveProfile, hasProfile, updateProfile, promptForProfile, } from './profile.js';
+export type { UserProfile } from './profile.js';
+export { writeAgentScaffold, writeIdeScaffold } from './write.js';
+export type { AgentScaffoldConfig, ScaffoldInput, IdeScaffoldInput, IdeType, WorkspaceFootprint, FrameworkType } from './write.js';
+export { seedContext } from './seed.js';
+export type { SeedResult } from './seed.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpF,OAAO,EACL,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnI,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/scaffold/infer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Project Context Inference
+ *
+ * Analyzes a repository root to infer domain, ecosystem, and description
+ * without requiring user input. Used during `trellis init` to seed the
+ * agent scaffold with meaningful context.
+ *
+ * @module trellis/scaffold/infer
+ */
+export type InferenceConfidence = 'high' | 'medium' | 'low';
+export type FrameworkType = 'react' | 'vue' | 'svelte' | 'next' | 'nuxt' | 'remotion' | 'expo' | 'bun' | 'node' | 'cli' | 'library' | 'animation' | 'games' | 'none';
+export interface ProjectContext {
+    /** Inferred domain (e.g. 'animation-studio', 'web-app', 'library', etc.) */
+    domain: string | null;
+    /** Short human-readable description (from README or package.json) */
+    description: string | null;
+    /** Primary ecosystem (e.g. 'bun', 'node', 'python', 'rust') */
+    ecosystem: string | null;
+    /** Project name (from package.json or directory name) */
+    name: string | null;
+    /** Inferred framework (e.g. 'react', 'next', 'cli', etc.) */
+    framework: FrameworkType | null;
+    /** Approximate file count */
+    fileCount: number;
+    /** How confident the inference is — determines whether prompts fire */
+    confidence: InferenceConfidence;
+    /** Key indicator files that were detected */
+    indicators: string[];
+}
+export interface InferOptions {
+    /** Pre-computed file count from an existing scan (avoids double walk) */
+    precomputedFileCount?: number;
+}
+/**
+ * Infer project context from the filesystem without user input.
+ *
+ * @param rootPath - Absolute path to the project root
+ * @param opts     - Optional pre-computed data to avoid duplicate work
+ * @returns A ProjectContext object to seed the agent scaffold
+ */
+export declare function inferProjectContext(rootPath: string, opts?: InferOptions): Promise<ProjectContext>;
+//# sourceMappingURL=infer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"infer.d.ts","sourceRoot":"","sources":["../../src/scaffold/infer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAErK,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,qEAAqE;IACrE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yDAAyD;IACzD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,UAAU,EAAE,mBAAmB,CAAC;IAChC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAoQD,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,cAAc,CAAC,CAkBzB"}