trellis 2.1.9 → 3.0.2

package/dist/plugins/brand/constraints.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Constraint Application — Narrows shadcn component Zod enums based on brand tokens.
+ *
+ * The core transformation: shadcn's Button accepts z.enum(["primary","secondary","danger"])
+ * → a brand-constrained catalog narrows it to z.enum(["primary","danger"]) based on
+ * which token roles exist in the graph.
+ *
+ * @module trellis/plugins/brand
+ */
+import { z } from 'zod';
+/**
+ * Maps component name → { propName: tokenType }.
+ * Only components/props listed here are narrowed; everything else passes through.
+ */
+export declare const CONSTRAINT_MAP: Record<string, Record<string, string>>;
+/**
+ * When token role names don't match shadcn enum values 1:1, this map provides
+ * the translation. A role of "destructive" maps to both "destructive" and "danger"
+ * (whichever the shadcn component actually uses).
+ */
+export declare const ROLE_ALIASES: Record<string, string[]>;
+/**
+ * Extract enum values from a Zod schema. Handles:
+ * - z.enum([...])
+ * - z.enum([...]).nullable()
+ * - z.enum([...]).optional()
+ * - z.enum([...]).nullable().optional()
+ *
+ * Returns null if the schema is not an enum type.
+ */
+export declare function extractEnumValues(schema: z.ZodType): string[] | null;
+/**
+ * Narrow an enum to only values that match available token roles.
+ *
+ * @param originalEnum - The full set of enum values from the shadcn component
+ * @param availableRoles - Token roles present in the brand guide
+ * @returns Narrowed enum values. Falls back to first original value if nothing matches.
+ */
+export declare function constrainEnum(originalEnum: string[], availableRoles: string[]): string[];
+/**
+ * Given a component definition and the available tokens grouped by type,
+ * return a new definition with narrowed Zod enum props.
+ *
+ * If the component has no constraints in CONSTRAINT_MAP, returns the original.
+ */
+export declare function constrainComponentDef(componentName: string, def: {
+    props: z.ZodType;
+    [key: string]: unknown;
+}, tokensByType: Record<string, Array<{
+    role: string;
+}>>): {
+    props: z.ZodType;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=constraints.d.ts.map

package/dist/plugins/brand/constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../../src/plugins/brand/constraints.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBjE,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAqBjD,CAAC;AAMF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAcpE;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAcxF;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE;IAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EACjD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GACpD;IAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAoC9C"}

package/dist/plugins/brand/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Brand Token System — Trellis plugin for design token governance
+ * and json-render catalog generation.
+ *
+ * @module trellis/plugins/brand
+ *
+ * @example
+ * ```typescript
+ * import { createBrandPlugin, brandOntology, generateBrandCatalog, brandTools } from 'trellis/plugins/brand';
+ *
+ * // 1. Register the plugin
+ * const { plugin, cache } = createBrandPlugin();
+ * pluginRegistry.register(plugin);
+ * await pluginRegistry.load('trellis:brand', kernel, ontologyRegistry);
+ *
+ * // 2. Create a brand guide + tokens
+ * await kernel.createEntity('guide-1', 'BrandGuide', { name: 'Acme Brand', complianceMode: 'strict' });
+ * await kernel.createEntity('token-primary', 'DesignToken', {
+ *   name: 'Primary Blue', tokenType: 'color', role: 'primary',
+ *   value: JSON.stringify({ hex: '#2563eb', oklch: 'oklch(0.55 0.22 264)' }),
+ * });
+ * await kernel.addLink('guide-1', 'hasToken', 'token-primary');
+ *
+ * // 3. Generate a constrained catalog
+ * import { defineCatalog } from '@json-render/core';
+ * import { schema } from '@json-render/react/schema';
+ * import { shadcnComponentDefinitions } from '@json-render/shadcn/catalog';
+ *
+ * const { catalog, voiceRules } = generateBrandCatalog(
+ *   kernel, 'guide-1', defineCatalog, schema, shadcnComponentDefinitions,
+ * );
+ *
+ * // 4. Get the AI prompt with brand constraints
+ * const prompt = catalog.prompt({ customRules: voiceRules, mode: 'inline' });
+ * ```
+ */
+export { brandOntology } from './ontology.js';
+export { createBrandPlugin } from './plugin.js';
+export { CatalogCache } from './cache.js';
+export { generateBrandCatalog, collectTokens, parseBrandGuide, type CollectedTokens, type BrandGuideData, type GenerateCatalogResult, type KernelReader, } from './catalog-generator.js';
+export { constrainEnum, constrainComponentDef, extractEnumValues, CONSTRAINT_MAP, ROLE_ALIASES, } from './constraints.js';
+export { buildVoiceToneRules, type VoiceToneConfig } from './voice-tone.js';
+export { brandTools, brandCreateGuide, brandUpsertToken, brandDeleteToken, brandListTokens, brandGenerateCatalog, brandGetPrompt, type BrandToolContext, } from './mcp-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/brand/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/brand/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG5E,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC"}

package/dist/plugins/brand/mcp-tools.d.ts

@@ -0,0 +1,101 @@
+/**
+ * MCP Tools — Brand token management and catalog generation tools
+ * for the Model Context Protocol.
+ *
+ * These are standalone tool definitions that can be registered on any MCP server.
+ * Each tool follows the pattern: { name, description, inputSchema, handler }.
+ *
+ * @module trellis/plugins/brand
+ */
+import { z } from 'zod';
+import type { TrellisKernel } from '../../core/kernel/trellis-kernel.js';
+import { CatalogCache } from './cache.js';
+interface McpToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+interface McpToolDef<T> {
+    name: string;
+    description: string;
+    inputSchema: Record<string, z.ZodType>;
+    handler: (input: T, ctx: BrandToolContext) => Promise<McpToolResult>;
+}
+export interface BrandToolContext {
+    kernel: TrellisKernel;
+    cache: CatalogCache;
+    /** The `defineCatalog` function from `@json-render/core` */
+    defineCatalog: (schema: unknown, input: {
+        components: Record<string, unknown>;
+        actions: Record<string, unknown>;
+    }) => unknown;
+    /** The schema instance from `@json-render/react/schema` (or other renderer) */
+    schema: unknown;
+    /** Base component definitions (e.g., shadcnComponentDefinitions) */
+    baseComponents: Record<string, {
+        props: unknown;
+        [key: string]: unknown;
+    }>;
+}
+export declare const brandCreateGuide: McpToolDef<{
+    guideId: string;
+    name: string;
+    complianceMode?: string;
+    voiceTone?: string;
+}>;
+export declare const brandUpsertToken: McpToolDef<{
+    tokenId: string;
+    guideId: string;
+    name: string;
+    tokenType: string;
+    role: string;
+    value: string;
+    description?: string;
+    lightMode?: string;
+    darkMode?: string;
+    wcagAA?: boolean;
+    wcagAAA?: boolean;
+}>;
+export declare const brandDeleteToken: McpToolDef<{
+    tokenId: string;
+}>;
+export declare const brandListTokens: McpToolDef<{
+    guideId: string;
+    tokenType?: string;
+}>;
+export declare const brandGenerateCatalog: McpToolDef<{
+    guideId: string;
+}>;
+export declare const brandGetPrompt: McpToolDef<{
+    guideId: string;
+}>;
+export declare const brandTools: readonly [McpToolDef<{
+    guideId: string;
+    name: string;
+    complianceMode?: string;
+    voiceTone?: string;
+}>, McpToolDef<{
+    tokenId: string;
+    guideId: string;
+    name: string;
+    tokenType: string;
+    role: string;
+    value: string;
+    description?: string;
+    lightMode?: string;
+    darkMode?: string;
+    wcagAA?: boolean;
+    wcagAAA?: boolean;
+}>, McpToolDef<{
+    tokenId: string;
+}>, McpToolDef<{
+    guideId: string;
+    tokenType?: string;
+}>, McpToolDef<{
+    guideId: string;
+}>, McpToolDef<{
+    guideId: string;
+}>];
+export {};
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/plugins/brand/mcp-tools.d.ts.map

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

package/dist/plugins/brand/ontology.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Brand Token Ontology — Schema definitions for BrandGuide and DesignToken entities.
+ *
+ * Two entity types, one relation. Deliberately flat:
+ * - BrandGuide: container for a set of tokens + brand rules
+ * - DesignToken: a single token discriminated by tokenType
+ * - hasToken: links a guide to its tokens
+ *
+ * @module trellis/plugins/brand
+ */
+import type { OntologySchema } from '../../core/ontology/types.js';
+export declare const brandOntology: OntologySchema;
+//# sourceMappingURL=ontology.d.ts.map

package/dist/plugins/brand/ontology.d.ts.map

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

package/dist/plugins/brand/plugin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Brand Plugin — Trellis plugin definition for the brand token system.
+ *
+ * Registers the brand ontology and subscribes to entity events to
+ * invalidate cached catalogs when tokens or guides change.
+ *
+ * @module trellis/plugins/brand
+ */
+import type { PluginDef } from '../../core/plugins/types.js';
+import { CatalogCache } from './cache.js';
+/**
+ * Create a brand token plugin instance.
+ *
+ * Returns a PluginDef and the shared CatalogCache so MCP tools
+ * and external consumers can access cached catalogs.
+ */
+export declare function createBrandPlugin(): {
+    plugin: PluginDef;
+    cache: CatalogCache;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/brand/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/brand/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAiD9E"}

package/dist/plugins/brand/voice-tone.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Voice & Tone — Converts brand voice/tone config into json-render catalog prompt rules.
+ *
+ * These rules are passed as `customRules` to `catalog.prompt()`, injecting
+ * communication constraints into the AI system prompt alongside component schemas.
+ *
+ * @module trellis/plugins/brand
+ */
+export interface VoiceToneConfig {
+    /** Personality traits: ["professional", "warm", "concise"] */
+    traits?: string[];
+    /** Vocabulary swaps: { "click": "select", "delete": "remove" } */
+    preferred?: Record<string, string>;
+    /** Words to never use: ["synergy", "leverage", "disrupt"] */
+    avoided?: string[];
+    /** Example phrases that embody the tone */
+    examples?: string[];
+}
+/**
+ * Build an array of rule strings from a voice/tone config.
+ * Returns empty array if config is undefined or empty.
+ */
+export declare function buildVoiceToneRules(config: VoiceToneConfig | undefined | null): string[];
+//# sourceMappingURL=voice-tone.d.ts.map

package/dist/plugins/brand/voice-tone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tone.d.ts","sourceRoot":"","sources":["../../../src/plugins/brand/voice-tone.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,EAAE,CAyBxF"}

package/dist/plugins/idea-garden/api.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Idea Garden API
+ *
+ * Provides functions to query the Trellis kernel for abandoned threads,
+ * rejected plans, and unexplored alternatives, surfacing them as RecoverableIdeas.
+ */
+import type { TrellisKernel } from '../../core/kernel/trellis-kernel.js';
+import type { RecoverableIdea } from './types.js';
+export declare class IdeaGarden {
+    private kernel;
+    constructor(kernel: TrellisKernel);
+    /**
+     * Harvests all recoverable ideas from the graph.
+     * Scans for:
+     * 1. Rejected/Cancelled PendingPlans
+     * 2. Archived Conversations
+     * 3. DecisionTraces with unexplored alternatives
+     */
+    harvestIdeas(): RecoverableIdea[];
+    /**
+     * Resurrects a rejected plan by creating a new active 'pending' replica of it.
+     * Returns the new PendingPlan ID.
+     */
+    resurrectPlan(ideaId: string): Promise<string>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/plugins/idea-garden/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/plugins/idea-garden/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,UAAU;IACT,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;;;;;OAMG;IACH,YAAY,IAAI,eAAe,EAAE;IAgFjC;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAuBrD"}

package/dist/plugins/idea-garden/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Idea Garden
+ *
+ * Surfaces abandoned threads, cancelled plans, and unexplored alternatives
+ * from the graph as "Recoverable Ideas".
+ *
+ * @module trellis/plugins/idea-garden
+ */
+export * from './types.js';
+export { IdeaGarden } from './api.js';
+export { createIdeaGardenPlugin } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/idea-garden/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/idea-garden/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugins/idea-garden/plugin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Idea Garden Plugin
+ *
+ * Registers the Idea Garden feature and exposes agent tools to traverse
+ * and resurrect ideas from the garden.
+ *
+ * @module trellis/plugins/idea-garden
+ */
+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 { IdeaGarden } from './api.js';
+export declare function createIdeaGardenPlugin(kernel: TrellisKernel, harness: AgentHarness): PluginDef & {
+    api: IdeaGarden;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/idea-garden/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/idea-garden/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,YAAY,GACpB,SAAS,GAAG;IAAE,GAAG,EAAE,UAAU,CAAA;CAAE,CAgEjC"}

package/dist/plugins/idea-garden/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Idea Garden Types
+ *
+ * Defines the structure for recovering abandoned threads, rejected plans,
+ * and unexplored alternatives as "Recoverable Ideas".
+ *
+ * @module trellis/plugins/idea-garden
+ */
+export type IdeaSource = 'rejected_plan' | 'archived_conversation' | 'unexplored_alternative';
+export interface RecoverableIdea {
+    /** Unique ID for this idea view (e.g. `idea:rejected_plan:plan_123`) */
+    id: string;
+    sourceType: IdeaSource;
+    /** The ID of the actual entity in the graph (PendingPlan, Conversation, or DecisionTrace) */
+    sourceEntityId: string;
+    title: string;
+    description: string;
+    createdAt: string;
+    /** Source-specific payload data (e.g. operations for a plan, alternate text for a decision) */
+    payload?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/idea-garden/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/idea-garden/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,6FAA6F;IAC7F,cAAc,EAAE,MAAM,CAAC;IAEvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Plan Approval — Trellis plugin for multi-turn planning with buffered
+ * mutations and user approval.
+ *
+ * @module trellis/plugins/plan-approval
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createPlanApprovalPlugin,
+ *   PlanManager,
+ *   registerPlanTools,
+ * } from 'trellis/plugins/plan-approval';
+ *
+ * // 1. Register the plugin
+ * const plugin = createPlanApprovalPlugin();
+ * pluginRegistry.register(plugin);
+ * await pluginRegistry.load('trellis:plan-approval', kernel, ontologyRegistry);
+ *
+ * // 2. Create a plan manager and register tools with the harness
+ * const planManager = new PlanManager(kernel);
+ * await registerPlanTools(harness, { planManager });
+ *
+ * // 3. Agent can now use enterPlanMode, planCreateEntity, submitPlan tools
+ * //    The harness will pause on submitPlan and set run status to plan_pending
+ *
+ * // 4. After user reviews:
+ * const result = await planManager.approvePlan('user:trent');
+ * // or: await planManager.rejectPlan('Not the right approach', 'user:trent');
+ * ```
+ */
+export { planApprovalOntology } from './ontology.js';
+export { createPlanApprovalPlugin } from './plugin.js';
+export { PlanManager, type PlannedOperation, type PendingPlan, type PlanStatus, type OperationKind, type ApprovalResult, } from './plan-manager.js';
+export { registerPlanTools, createEnterPlanModeTool, createPlanCreateEntityTool, createPlanUpdateEntityTool, createPlanAddLinkTool, createSubmitPlanTool, createCancelPlanTool, type PlanToolContext, } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/plan-approval/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Plan Approval Ontology — Schema definitions for PendingPlan and PlannedOperation entities.
+ *
+ * Plans are first-class graph entities so they can be queried, linked to runs,
+ * and preserved for the Idea Garden when rejected.
+ *
+ * @module trellis/plugins/plan-approval
+ */
+import type { OntologySchema } from '../../core/ontology/types.js';
+export declare const planApprovalOntology: OntologySchema;
+//# sourceMappingURL=ontology.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ontology.d.ts","sourceRoot":"","sources":["../../../src/plugins/plan-approval/ontology.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,eAAO,MAAM,oBAAoB,EAAE,cA8DlC,CAAC"}

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

@@ -0,0 +1,104 @@
+/**
+ * Plan Manager — Coordinates multi-turn planning with buffered mutations.
+ *
+ * When plan mode is active, the PlanManager buffers intended graph operations
+ * as structured data instead of executing them. On approval, it replays them
+ * as real kernel calls. On rejection, the plan is preserved as an entity for
+ * the Idea Garden.
+ *
+ * @module trellis/plugins/plan-approval
+ */
+import type { TrellisKernel, MutateResult } from '../../core/kernel/trellis-kernel.js';
+import type { Atom } from '../../core/store/eav-store.js';
+export type OperationKind = 'createEntity' | 'updateEntity' | 'deleteEntity' | 'addLink' | 'removeLink';
+export interface PlannedOperation {
+    id: string;
+    kind: OperationKind;
+    entityId?: string;
+    entityType?: string;
+    attributes?: Record<string, Atom>;
+    sourceId?: string;
+    targetId?: string;
+    linkAttribute?: string;
+    description?: string;
+    sequence: number;
+}
+export type PlanStatus = 'drafting' | 'submitted' | 'approved' | 'rejected';
+export interface PendingPlan {
+    id: string;
+    status: PlanStatus;
+    title: string;
+    description?: string;
+    operations: PlannedOperation[];
+    createdAt: string;
+    submittedAt?: string;
+    resolvedAt?: string;
+    resolvedBy?: string;
+    rejectionReason?: string;
+}
+export interface ApprovalResult {
+    planId: string;
+    operationsExecuted: number;
+    results: MutateResult[];
+}
+export declare class PlanManager {
+    private kernel;
+    private activePlan;
+    constructor(kernel: TrellisKernel);
+    /**
+     * Enter plan mode. Creates a PendingPlan entity in the graph and sets it
+     * as the active plan. All subsequent `addOperation()` calls buffer into it.
+     */
+    enterPlanMode(title: string, description?: string): Promise<string>;
+    /**
+     * Whether a plan is currently being drafted.
+     */
+    isInPlanMode(): boolean;
+    /**
+     * Get the active plan (if any).
+     */
+    getActivePlan(): PendingPlan | null;
+    /**
+     * Buffer a planned graph operation. Only valid in plan mode.
+     * Returns the operation ID.
+     */
+    addOperation(op: Omit<PlannedOperation, 'id' | 'sequence'>): Promise<string>;
+    planCreateEntity(entityId: string, entityType: string, attributes?: Record<string, Atom>, description?: string): Promise<string>;
+    planUpdateEntity(entityId: string, attributes: Record<string, Atom>, description?: string): Promise<string>;
+    planDeleteEntity(entityId: string, description?: string): Promise<string>;
+    planAddLink(sourceId: string, linkAttribute: string, targetId: string, description?: string): Promise<string>;
+    planRemoveLink(sourceId: string, linkAttribute: string, targetId: string, description?: string): Promise<string>;
+    /**
+     * Submit the active plan for review. Marks it as submitted and returns
+     * the plan for the caller to present to the user.
+     */
+    submitPlan(): Promise<PendingPlan>;
+    /**
+     * Approve a submitted plan. Replays all buffered operations against the
+     * real kernel in sequence order. Returns the results of each operation.
+     */
+    approvePlan(resolvedBy?: string): Promise<ApprovalResult>;
+    /**
+     * Reject a submitted plan. The plan and its operations remain in the graph
+     * as entities, preserving them as substrate for the Idea Garden (Phase 6).
+     */
+    rejectPlan(reason?: string, resolvedBy?: string): Promise<void>;
+    /**
+     * Cancel a drafting plan without submitting. Like rejection but for
+     * plans that were never submitted.
+     */
+    cancelPlan(): Promise<void>;
+    /**
+     * Load a plan from the graph by ID, including its operations.
+     */
+    loadPlan(planId: string): PendingPlan | null;
+    /**
+     * List all plans, optionally filtered by status.
+     */
+    listPlans(status?: PlanStatus): PendingPlan[];
+    /**
+     * Execute a single planned operation against the real kernel.
+     */
+    private _executeOperation;
+}
+//# sourceMappingURL=plan-manager.d.ts.map

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

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