@manifesto-ai/compiler 1.0.0

package/README.md

@@ -0,0 +1,313 @@
+# @manifesto-ai/compiler
+
+> **Compiler** compiles natural language specifications into Manifesto DomainSchemas using LLM-powered pipelines.
+
+---
+
+## What is Compiler?
+
+Compiler takes natural language descriptions and produces valid DomainSchemas. It uses LLM adapters for parsing and proposal, then validates the output using Builder.
+
+Importantly, Compiler is itself a Manifesto application (dogfooding).
+
+In the Manifesto architecture:
+
+```
+Natural Language ──→ COMPILER ──→ DomainSchema
+                        │
+    LLM-powered pipeline (segment → normalize → propose)
+    Builder validation as authority
+```
+
+---
+
+## What Compiler Does
+
+| Responsibility | Description |
+|----------------|-------------|
+| Parse natural language | Segment text into semantic units |
+| Normalize intents | Convert segments to structured requirements |
+| Propose schema | Generate DomainSchema draft via LLM |
+| Validate output | Use Builder to validate generated schema |
+| Handle ambiguity | Request user resolution for unclear requirements |
+
+---
+
+## What Compiler Does NOT Do
+
+| NOT Responsible For | Who Is |
+|--------------------|--------|
+| Execute domains | Host |
+| Provide LLM infrastructure | Your LLM provider (Anthropic, OpenAI, etc.) |
+| Run the domain | Host, World, Bridge |
+
+---
+
+## Installation
+
+```bash
+npm install @manifesto-ai/compiler @manifesto-ai/builder
+# or
+pnpm add @manifesto-ai/compiler @manifesto-ai/builder
+```
+
+### LLM Provider (choose one)
+
+```bash
+npm install @anthropic-ai/sdk  # For Anthropic
+# or
+npm install openai             # For OpenAI
+```
+
+---
+
+## Quick Example
+
+### Using Anthropic (Built-in)
+
+```typescript
+import { createCompiler } from "@manifesto-ai/compiler";
+
+const compiler = createCompiler({
+  anthropic: { apiKey: process.env.ANTHROPIC_API_KEY },
+});
+
+// Subscribe to state changes
+compiler.subscribe((state) => {
+  console.log("Status:", state.status);
+
+  if (state.status === "success") {
+    console.log("Generated schema:", state.result);
+  }
+
+  if (state.status === "discarded") {
+    console.log("Discarded:", state.discardReason);
+  }
+});
+
+// Start compilation
+await compiler.start({
+  text: `
+    Track a list of todos with title and completion status.
+    Users can add new todos, toggle completion, and delete todos.
+    Show a count of remaining incomplete todos.
+  `,
+  context: {
+    domainName: "todo",
+  },
+});
+```
+
+### Using OpenAI
+
+```typescript
+import { createCompiler, createOpenAIAdapter } from "@manifesto-ai/compiler";
+import OpenAI from "openai";
+
+const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+const adapter = createOpenAIAdapter({ client: openai, model: "gpt-4" });
+
+const compiler = createCompiler({
+  llmAdapter: adapter,
+});
+
+await compiler.start({ text: "Track user profiles with name and email..." });
+```
+
+> See [GUIDE.md](../../docs/packages/compiler/GUIDE.md) for the full tutorial.
+
+---
+
+## CLI Usage
+
+The compiler includes an interactive CLI tool:
+
+```bash
+# Direct input
+manifesto-compile "Track user name and email"
+
+# From file
+manifesto-compile --file requirements.txt
+
+# Output to file
+manifesto-compile "Track todos" -o schema.json
+
+# Use Anthropic provider
+manifesto-compile --provider anthropic "Create a counter"
+
+# Show progress
+manifesto-compile --verbose "Complex requirements..."
+```
+
+### CLI Options
+
+| Option | Description |
+|--------|-------------|
+| `--provider` | LLM provider: `openai` (default) or `anthropic` |
+| `--model` | Model name |
+| `--file` | Read input from file |
+| `--stdin` | Read input from stdin |
+| `-o, --output` | Write result to file |
+| `--verbose` | Show phase progress |
+| `--full` | Show full metrics |
+
+> See [GUIDE.md](../../docs/packages/compiler/GUIDE.md#cli-usage) for detailed CLI documentation.
+
+---
+
+## Compiler API
+
+### Main Exports
+
+```typescript
+// Factory
+function createCompiler(options: CompilerOptions): Compiler;
+
+// Compiler interface
+interface Compiler {
+  start(input: CompileInput): Promise<void>;
+  subscribe(callback: (state: CompilerState) => void): Unsubscribe;
+  requestResolution(optionId: string): Promise<void>;
+  getState(): CompilerState;
+}
+
+// LLM Adapters
+function createAnthropicAdapter(options: AnthropicAdapterOptions): LLMAdapter;
+function createOpenAIAdapter(options: OpenAIAdapterOptions): LLMAdapter;
+
+// Types
+type CompilerStatus =
+  | "idle"
+  | "segmenting"
+  | "normalizing"
+  | "proposing"
+  | "validating"
+  | "awaiting_resolution"
+  | "success"
+  | "discarded";
+
+type CompilerState = {
+  status: CompilerStatus;
+  segments?: string[];
+  intents?: NormalizedIntent[];
+  draft?: DomainSchema;
+  result?: DomainSchema;
+  diagnostics?: CompilerDiagnostics;
+  resolutionOptions?: ResolutionOption[];
+  discardReason?: DiscardReason;
+};
+
+interface LLMAdapter {
+  segment(input: SegmentInput): Promise<LLMResult<SegmentResult>>;
+  normalize(input: NormalizeInput): Promise<LLMResult<NormalizeResult>>;
+  propose(input: ProposeInput): Promise<LLMResult<ProposeResult>>;
+}
+```
+
+> See [SPEC.md](../../docs/packages/compiler/SPEC.md) for complete API reference.
+
+---
+
+## Core Concepts
+
+### Pipeline Stages
+
+```
+idle → segmenting → normalizing → proposing → validating → success
+                                      ↓              ↓
+                              awaiting_resolution  discarded
+```
+
+1. **Segmenting**: Parse NL text into semantic segments
+2. **Normalizing**: Convert segments to structured NormalizedIntents
+3. **Proposing**: Generate DomainSchema draft via LLM
+4. **Validating**: Validate draft using Builder (the "judge")
+5. **Resolution**: Handle ambiguities (user choice or auto-discard)
+6. **Success/Discarded**: Terminal states
+
+### LLM as Untrusted Proposer
+
+The LLM generates schema proposals, but Builder validates them. This ensures type safety and structural correctness regardless of LLM output quality.
+
+```
+LLM (untrusted proposer) → Draft Schema
+                              ↓
+                    Builder (judge) → Validation
+                              ↓
+                    Valid? → Success
+                    Invalid? → Retry or Discard
+```
+
+### Custom LLM Adapters
+
+Implement `LLMAdapter` interface for any LLM provider:
+
+```typescript
+const myAdapter: LLMAdapter = {
+  async segment({ text }) {
+    // Call your LLM
+    return { ok: true, data: { segments: [...] } };
+  },
+  async normalize({ segments, schema, context }) {
+    return { ok: true, data: { intents: [...] } };
+  },
+  async propose({ schema, intents, history, context }) {
+    return { ok: true, data: { draft: {...} } };
+  },
+};
+```
+
+---
+
+## Relationship with Other Packages
+
+```
+┌─────────────┐
+│    Your     │ ← Uses Compiler for NL→Schema
+│    Tool     │
+└──────┬──────┘
+       │
+       ▼
+┌─────────────┐
+│  COMPILER   │
+└──────┬──────┘
+       │
+       ▼
+┌─────────────┐
+│   Builder   │ ← Validates generated schemas
+└─────────────┘
+```
+
+| Relationship | Package | How |
+|--------------|---------|-----|
+| Depends on | `@manifesto-ai/builder` | Validates generated schemas |
+| Depends on | `@manifesto-ai/core` | Uses Core types |
+| Used by | Developer tools | For AI-assisted domain creation |
+
+---
+
+## When to Use Compiler
+
+Use Compiler when:
+- Building AI-assisted domain definition tools
+- Creating no-code/low-code domain builders
+- Prototyping domains from natural language specs
+- Building developer productivity tools
+
+For manual domain definition, use [`@manifesto-ai/builder`](../builder/) directly.
+
+---
+
+## Documentation
+
+| Document | Purpose |
+|----------|---------|
+| [GUIDE.md](../../docs/packages/compiler/GUIDE.md) | Step-by-step usage guide |
+| [SPEC.md](../../docs/packages/compiler/SPEC.md) | Complete specification |
+| [FDR.md](../../docs/packages/compiler/FDR.md) | Design rationale |
+
+---
+
+## License
+
+[MIT](../../LICENSE)

package/dist/__tests__/domain.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain.test.d.ts.map

package/dist/__tests__/domain.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/domain.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/domain.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect } from "vitest";
+import { CompilerDomain, INITIAL_STATE } from "../domain/domain.js";
+import { CompilerStateSchema } from "../domain/schema.js";
+describe("CompilerDomain", () => {
+    describe("schema", () => {
+        it("should have valid schema structure", () => {
+            expect(CompilerDomain.schema).toBeDefined();
+            expect(CompilerDomain.schema.id).toBe("manifesto:compiler");
+            expect(CompilerDomain.schema.version).toBe("1.0.0");
+        });
+        it("should have all required actions", () => {
+            const actionNames = Object.keys(CompilerDomain.schema.actions);
+            expect(actionNames).toContain("start");
+            expect(actionNames).toContain("receiveSegments");
+            expect(actionNames).toContain("receiveIntents");
+            expect(actionNames).toContain("receiveDraft");
+            expect(actionNames).toContain("receiveValidation");
+            expect(actionNames).toContain("requestResolution");
+            expect(actionNames).toContain("resolve");
+            expect(actionNames).toContain("discard");
+            expect(actionNames).toContain("reset");
+        });
+        it("should have all required computed values", () => {
+            const computedNames = Object.keys(CompilerDomain.schema.computed.fields);
+            expect(computedNames).toContain("computed.isIdle");
+            expect(computedNames).toContain("computed.isSegmenting");
+            expect(computedNames).toContain("computed.isNormalizing");
+            expect(computedNames).toContain("computed.isProposing");
+            expect(computedNames).toContain("computed.isValidating");
+            expect(computedNames).toContain("computed.isAwaitingResolution");
+            expect(computedNames).toContain("computed.isTerminal");
+            expect(computedNames).toContain("computed.canRetry");
+        });
+    });
+    describe("initial state", () => {
+        it("should validate against schema", () => {
+            const result = CompilerStateSchema.safeParse(INITIAL_STATE);
+            expect(result.success).toBe(true);
+        });
+        it("should have correct default values", () => {
+            expect(INITIAL_STATE.status).toBe("idle");
+            expect(INITIAL_STATE.maxRetries).toBe(5);
+            expect(INITIAL_STATE.traceDrafts).toBe(false);
+            expect(INITIAL_STATE.attemptCount).toBe(0);
+            expect(INITIAL_STATE.input).toBeNull();
+            expect(INITIAL_STATE.result).toBeNull();
+        });
+    });
+    describe("diagnostics", () => {
+        it("should have valid diagnostics", () => {
+            expect(CompilerDomain.diagnostics).toBeDefined();
+            expect(CompilerDomain.diagnostics.valid).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=domain.test.js.map

package/dist/__tests__/domain.test.js.map

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

package/dist/__tests__/effects.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=effects.test.d.ts.map

package/dist/__tests__/effects.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/effects.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/effects.test.js

@@ -0,0 +1,145 @@
+import { describe, it, expect, vi } from "vitest";
+import { createSegmentHandler, createNormalizeHandler, createProposeHandler, } from "../effects/llm/handlers.js";
+import { createBuilderValidateHandler } from "../effects/builder/validate-handler.js";
+describe("Effect Handlers", () => {
+    describe("createSegmentHandler", () => {
+        it("should return receiveSegments action on success", async () => {
+            const mockAdapter = {
+                segment: vi.fn().mockResolvedValue({
+                    ok: true,
+                    data: { segments: ["seg1", "seg2"] },
+                }),
+                normalize: vi.fn(),
+                propose: vi.fn(),
+            };
+            const handler = createSegmentHandler(mockAdapter);
+            const result = await handler({ text: "test input" });
+            expect(result.action).toBe("receiveSegments");
+            expect(result.input.segments).toEqual(["seg1", "seg2"]);
+        });
+        it("should return requestResolution action on resolution", async () => {
+            const mockAdapter = {
+                segment: vi.fn().mockResolvedValue({
+                    ok: "resolution",
+                    reason: "Ambiguous",
+                    options: [{ id: "opt1", description: "Option 1" }],
+                }),
+                normalize: vi.fn(),
+                propose: vi.fn(),
+            };
+            const handler = createSegmentHandler(mockAdapter);
+            const result = await handler({ text: "test input" });
+            expect(result.action).toBe("requestResolution");
+            expect(result.input.reason).toBe("Ambiguous");
+        });
+        it("should return discard action on error", async () => {
+            const mockAdapter = {
+                segment: vi.fn().mockResolvedValue({
+                    ok: false,
+                    error: "Failed",
+                }),
+                normalize: vi.fn(),
+                propose: vi.fn(),
+            };
+            const handler = createSegmentHandler(mockAdapter);
+            const result = await handler({ text: "test input" });
+            expect(result.action).toBe("discard");
+            expect(result.input.reason).toBe("SEGMENTATION_FAILED");
+        });
+    });
+    describe("createNormalizeHandler", () => {
+        it("should return receiveIntents action on success", async () => {
+            const mockAdapter = {
+                segment: vi.fn(),
+                normalize: vi.fn().mockResolvedValue({
+                    ok: true,
+                    data: {
+                        intents: [{ kind: "state", description: "test", confidence: 0.9 }],
+                    },
+                }),
+                propose: vi.fn(),
+            };
+            const handler = createNormalizeHandler(mockAdapter, { onResolutionRequired: "await" });
+            const result = await handler({ segments: ["seg1"], schema: null });
+            expect(result.action).toBe("receiveIntents");
+            expect(result.input.intents).toHaveLength(1);
+        });
+        it("should respect discard policy on resolution", async () => {
+            const mockAdapter = {
+                segment: vi.fn(),
+                normalize: vi.fn().mockResolvedValue({
+                    ok: "resolution",
+                    reason: "Ambiguous",
+                    options: [],
+                }),
+                propose: vi.fn(),
+            };
+            const handler = createNormalizeHandler(mockAdapter, { onResolutionRequired: "discard" });
+            const result = await handler({ segments: ["seg1"], schema: null });
+            expect(result.action).toBe("discard");
+            expect(result.input.reason).toBe("RESOLUTION_REQUIRED_BUT_DISABLED");
+        });
+    });
+    describe("createProposeHandler", () => {
+        it("should return receiveDraft action on success", async () => {
+            const mockAdapter = {
+                segment: vi.fn(),
+                normalize: vi.fn(),
+                propose: vi.fn().mockResolvedValue({
+                    ok: true,
+                    data: { draft: { id: "test" } },
+                }),
+            };
+            const handler = createProposeHandler(mockAdapter, { onResolutionRequired: "await" });
+            const result = await handler({
+                schema: null,
+                intents: [],
+                history: [],
+            });
+            expect(result.action).toBe("receiveDraft");
+            expect(result.input.draft).toEqual({ id: "test" });
+        });
+    });
+    describe("createBuilderValidateHandler", () => {
+        it("should return receiveValidation with valid result", async () => {
+            const handler = createBuilderValidateHandler();
+            const result = await handler({
+                draft: {
+                    id: "test",
+                    version: "1.0.0",
+                    hash: "",
+                    state: { fields: {} },
+                    computed: { fields: {} },
+                    actions: {},
+                },
+            });
+            expect(result.action).toBe("receiveValidation");
+            expect(result.input.valid).toBe(true);
+            expect(result.input.schemaHash).toBeDefined();
+        });
+        it("should return receiveValidation with invalid result for missing fields", async () => {
+            const handler = createBuilderValidateHandler();
+            const result = await handler({
+                draft: { id: "test" },
+            });
+            expect(result.action).toBe("receiveValidation");
+            expect(result.input.valid).toBe(false);
+            expect(result.input.diagnostics).toBeDefined();
+        });
+        it("should handle custom validation function", async () => {
+            const customValidate = vi.fn().mockReturnValue({
+                valid: false,
+                diagnostics: {
+                    valid: false,
+                    errors: [{ code: "CUSTOM_ERROR", message: "Custom error" }],
+                    warnings: [],
+                },
+            });
+            const handler = createBuilderValidateHandler(customValidate);
+            const result = await handler({ draft: {} });
+            expect(customValidate).toHaveBeenCalled();
+            expect(result.input.valid).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=effects.test.js.map

package/dist/__tests__/effects.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.test.js","sourceRoot":"","sources":["../../src/__tests__/effects.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAGtF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YAC/D,MAAM,WAAW,GAAe;gBAC9B,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;oBACjC,EAAE,EAAE,IAAI;oBACR,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;iBACrC,CAAC;gBACF,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;gBAClB,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;aACjB,CAAC;YAEF,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YAErD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,MAAM,WAAW,GAAe;gBAC9B,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;oBACjC,EAAE,EAAE,YAAY;oBAChB,MAAM,EAAE,WAAW;oBACnB,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;iBACnD,CAAC;gBACF,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;gBAClB,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;aACjB,CAAC;YAEF,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YAErD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,WAAW,GAAe;gBAC9B,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;oBACjC,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,QAAQ;iBAChB,CAAC;gBACF,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;gBAClB,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;aACjB,CAAC;YAEF,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YAErD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,WAAW,GAAe;gBAC9B,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;gBAChB,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;oBACnC,EAAE,EAAE,IAAI;oBACR,IAAI,EAAE;wBACJ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;qBACnE;iBACF,CAAC;gBACF,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;aACjB,CAAC;YAEF,MAAM,OAAO,GAAG,sBAAsB,CAAC,WAAW,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,CAAC;YACvF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAEnE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,WAAW,GAAe;gBAC9B,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;gBAChB,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;oBACnC,EAAE,EAAE,YAAY;oBAChB,MAAM,EAAE,WAAW;oBACnB,OAAO,EAAE,EAAE;iBACZ,CAAC;gBACF,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;aACjB,CAAC;YAEF,MAAM,OAAO,GAAG,sBAAsB,CAAC,WAAW,EAAE,EAAE,oBAAoB,EAAE,SAAS,EAAE,CAAC,CAAC;YACzF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAEnE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,WAAW,GAAe;gBAC9B,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;gBAChB,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;gBAClB,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;oBACjC,EAAE,EAAE,IAAI;oBACR,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;iBAChC,CAAC;aACH,CAAC;YAEF,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;gBAC3B,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;QAC5C,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YACjE,MAAM,OAAO,GAAG,4BAA4B,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;gBAC3B,KAAK,EAAE;oBACL,EAAE,EAAE,MAAM;oBACV,OAAO,EAAE,OAAO;oBAChB,IAAI,EAAE,EAAE;oBACR,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;oBACrB,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;oBACxB,OAAO,EAAE,EAAE;iBACZ;aACF,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;YACtF,MAAM,OAAO,GAAG,4BAA4B,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;gBAC3B,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;aACtB,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;gBAC7C,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE;oBACX,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;oBAC3D,QAAQ,EAAE,EAAE;iBACb;aACF,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,4BAA4B,CAAC,cAAc,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAE5C,MAAM,CAAC,cAAc,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/helpers/mock-adapter.d.ts

@@ -0,0 +1,47 @@
+import type { LLMAdapter, SegmentResult, NormalizeResult, ProposeResult, NormalizedIntent } from "../../domain/types.js";
+/**
+ * Default successful segment response
+ */
+export declare const DEFAULT_SEGMENT_RESPONSE: SegmentResult;
+/**
+ * Default successful normalize response
+ */
+export declare const DEFAULT_NORMALIZE_RESPONSE: NormalizeResult;
+/**
+ * Default successful propose response (minimal valid DomainDraft)
+ */
+export declare const DEFAULT_PROPOSE_RESPONSE: ProposeResult;
+/**
+ * Mock adapter options
+ */
+export interface MockAdapterOptions {
+    segmentResponse?: SegmentResult | (() => SegmentResult);
+    normalizeResponse?: NormalizeResult | (() => NormalizeResult);
+    proposeResponse?: ProposeResult | (() => ProposeResult);
+    proposeResponses?: ProposeResult[];
+}
+/**
+ * Create a mock LLM adapter for testing
+ */
+export declare function createMockAdapter(options?: MockAdapterOptions): LLMAdapter;
+/**
+ * Create a mock adapter that always succeeds
+ */
+export declare function createSuccessMockAdapter(): LLMAdapter;
+/**
+ * Create a mock adapter that fails at segmentation
+ */
+export declare function createSegmentFailMockAdapter(error?: string): LLMAdapter;
+/**
+ * Create a mock adapter that requires resolution
+ */
+export declare function createResolutionMockAdapter(reason?: string): LLMAdapter;
+/**
+ * Create a mock adapter that produces invalid drafts (for retry testing)
+ */
+export declare function createInvalidDraftMockAdapter(failCount?: number, eventualResponse?: ProposeResult): LLMAdapter;
+/**
+ * Create custom intents for testing
+ */
+export declare function createIntents(intents: Partial<NormalizedIntent>[]): NormalizedIntent[];
+//# sourceMappingURL=mock-adapter.d.ts.map

package/dist/__tests__/helpers/mock-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-adapter.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/mock-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAKtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,eAQxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAiBtC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;IACxD,iBAAiB,CAAC,EAAE,eAAe,GAAG,CAAC,MAAM,eAAe,CAAC,CAAC;IAC9D,eAAe,CAAC,EAAE,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;IACxD,gBAAgB,CAAC,EAAE,aAAa,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,UAAU,CAoC9E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,UAAU,CAErD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,GAAE,MAA8B,GAAG,UAAU,CAI9F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,GAAE,MAAgC,GAAG,UAAU,CAWhG;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,GAAE,MAAU,EACrB,gBAAgB,GAAE,aAAwC,GACzD,UAAU,CAeZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAAE,GAAG,gBAAgB,EAAE,CAMtF"}