@manifesto-ai/compiler 1.0.0

package/dist/domain/types.d.ts

@@ -0,0 +1,360 @@
+import type { DomainSchema as CoreDomainSchema } from "@manifesto-ai/core";
+/**
+ * Compiler context for additional information
+ */
+export interface CompilerContext {
+    /**
+     * Name of the domain being compiled
+     */
+    domainName?: string;
+    /**
+     * List of existing action names (for context)
+     */
+    existingActions?: string[];
+    /**
+     * Glossary of domain-specific terms
+     */
+    glossary?: Record<string, string>;
+}
+/**
+ * Normalized intent - structured representation of a requirement
+ */
+export interface NormalizedIntent {
+    /**
+     * Intent kind
+     */
+    kind: "state" | "computed" | "action" | "constraint";
+    /**
+     * Human-readable description
+     */
+    description: string;
+    /**
+     * Confidence level (0.0 - 1.0)
+     */
+    confidence: number;
+}
+/**
+ * Attempt record - tracks validation attempts
+ */
+export interface AttemptRecord {
+    /**
+     * Attempt number (0-indexed)
+     */
+    attemptNumber: number;
+    /**
+     * Hash of the draft for correlation
+     */
+    draftHash: string;
+    /**
+     * Validation diagnostics from this attempt
+     */
+    diagnostics: CompilerDiagnostics | null;
+    /**
+     * Timestamp of the attempt (from effect handler)
+     */
+    timestamp: number;
+}
+/**
+ * Resolution option - choice for ambiguity resolution
+ */
+export interface ResolutionOption {
+    /**
+     * Unique identifier
+     */
+    id: string;
+    /**
+     * Human-readable description
+     */
+    description: string;
+    /**
+     * Optional preview of what this option produces
+     */
+    preview?: string;
+}
+/**
+ * Discard reason codes
+ */
+export type DiscardReason = "RESOLUTION_REQUIRED_BUT_DISABLED" | "MAX_RETRIES_EXCEEDED" | "EMPTY_INPUT" | "SEGMENTATION_FAILED" | "USER_CANCELLED";
+/**
+ * Compilation status
+ */
+export type CompilerStatus = "idle" | "segmenting" | "normalizing" | "proposing" | "validating" | "awaiting_resolution" | "success" | "discarded";
+/**
+ * Resolution policy
+ */
+export interface CompilerResolutionPolicy {
+    /**
+     * What to do when resolution is required
+     */
+    onResolutionRequired: "await" | "discard";
+}
+/**
+ * Simplified diagnostics for compiler use
+ */
+export interface CompilerDiagnostics {
+    valid: boolean;
+    errors: CompilerDiagnostic[];
+    warnings: CompilerDiagnostic[];
+}
+export interface CompilerDiagnostic {
+    code: string;
+    message: string;
+    path?: string;
+    suggestion?: string;
+}
+/**
+ * Compiler state - full state of the compiler domain
+ */
+export interface CompilerState {
+    input: string | null;
+    targetSchema: unknown | null;
+    context: CompilerContext | null;
+    maxRetries: number;
+    traceDrafts: boolean;
+    segments: string[];
+    intents: NormalizedIntent[];
+    currentDraft: unknown | null;
+    diagnostics: CompilerDiagnostics | null;
+    attemptCount: number;
+    attempts: AttemptRecord[];
+    resolutionOptions: ResolutionOption[];
+    resolutionReason: string | null;
+    status: CompilerStatus;
+    result: CoreDomainSchema | null;
+    resultHash: string | null;
+    discardReason: DiscardReason | null;
+}
+/**
+ * Compiler snapshot - exposed state with computed values
+ */
+export interface CompilerSnapshot extends CompilerState {
+    isIdle: boolean;
+    isSegmenting: boolean;
+    isNormalizing: boolean;
+    isProposing: boolean;
+    isValidating: boolean;
+    isAwaitingResolution: boolean;
+    isTerminal: boolean;
+    canRetry: boolean;
+}
+/**
+ * Compiler options
+ */
+export interface CompilerOptions {
+    /**
+     * LLM adapter for text processing.
+     * If provided, takes precedence over anthropic/openai options.
+     */
+    llmAdapter?: LLMAdapter;
+    /**
+     * Anthropic adapter options.
+     * Used if llmAdapter is not provided and openai is not specified.
+     */
+    anthropic?: {
+        apiKey?: string;
+        model?: string;
+        maxTokens?: number;
+        temperature?: number;
+        timeout?: number;
+    };
+    /**
+     * OpenAI adapter options.
+     * Used if llmAdapter is not provided. Takes precedence over anthropic.
+     */
+    openai?: {
+        apiKey?: string;
+        baseURL?: string;
+        organization?: string;
+        model?: string;
+        maxTokens?: number;
+        temperature?: number;
+        timeout?: number;
+    };
+    /**
+     * Resolution policy (default: 'discard')
+     */
+    resolutionPolicy?: CompilerResolutionPolicy;
+    /**
+     * Maximum retries (default: 5)
+     */
+    maxRetries?: number;
+    /**
+     * Whether to trace drafts (default: false)
+     */
+    traceDrafts?: boolean;
+    /**
+     * Telemetry hook for monitoring compilation (optional)
+     * Per SPEC §15.2
+     */
+    telemetry?: CompilerTelemetry;
+}
+/**
+ * Compile input
+ */
+export interface CompileInput {
+    /**
+     * Natural language text to compile
+     */
+    text: string;
+    /**
+     * Target schema (optional)
+     */
+    schema?: unknown;
+    /**
+     * Additional context
+     */
+    context?: CompilerContext;
+    /**
+     * Override max retries
+     */
+    maxRetries?: number;
+    /**
+     * Override trace drafts
+     */
+    traceDrafts?: boolean;
+}
+/**
+ * LLM Result types
+ */
+export type LLMResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: "resolution";
+    reason: string;
+    options: ResolutionOption[];
+} | {
+    ok: false;
+    error: string;
+};
+export type SegmentResult = LLMResult<{
+    segments: string[];
+}>;
+export type NormalizeResult = LLMResult<{
+    intents: NormalizedIntent[];
+}>;
+export type ProposeResult = LLMResult<{
+    draft: unknown;
+}>;
+/**
+ * LLM Adapter interface
+ */
+export interface LLMAdapter {
+    /**
+     * Segment natural language text into requirement segments
+     */
+    segment(params: {
+        text: string;
+    }): Promise<SegmentResult>;
+    /**
+     * Normalize segments into structured intents
+     */
+    normalize(params: {
+        segments: string[];
+        schema: unknown;
+        context?: CompilerContext;
+    }): Promise<NormalizeResult>;
+    /**
+     * Propose a DomainDraft from intents
+     */
+    propose(params: {
+        schema: unknown;
+        intents: NormalizedIntent[];
+        history: AttemptRecord[];
+        context?: CompilerContext;
+        resolution?: string;
+    }): Promise<ProposeResult>;
+}
+/**
+ * Unsubscribe function
+ */
+export type Unsubscribe = () => void;
+/**
+ * Compiler interface
+ */
+export interface Compiler {
+    /**
+     * Start compilation
+     */
+    start(input: CompileInput): Promise<void>;
+    /**
+     * Get current state
+     */
+    getSnapshot(): Promise<CompilerSnapshot>;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(callback: (state: CompilerSnapshot) => void): Unsubscribe;
+    /**
+     * Dispatch an action
+     */
+    dispatch(action: string, input?: unknown): Promise<void>;
+    /**
+     * Resolve ambiguity
+     */
+    resolve(selectedOptionId: string): Promise<void>;
+    /**
+     * Discard compilation
+     */
+    discard(reason?: DiscardReason): Promise<void>;
+    /**
+     * Reset to idle
+     */
+    reset(): Promise<void>;
+}
+/**
+ * Effect handler result - returned by effect handlers
+ */
+export interface EffectHandlerResult {
+    action: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Telemetry hook for monitoring compiler execution
+ *
+ * Per SPEC §15.2: Allows external systems to observe compilation progress
+ * for debugging, monitoring, and analytics purposes.
+ */
+export interface CompilerTelemetry {
+    /**
+     * Called when compilation phase changes
+     * @param from - Previous status
+     * @param to - New status
+     */
+    onPhaseChange?(from: CompilerStatus, to: CompilerStatus): void;
+    /**
+     * Called when a validation attempt is recorded (when traceDrafts is true)
+     * @param attempt - The recorded attempt
+     */
+    onAttempt?(attempt: AttemptRecord): void;
+    /**
+     * Called when resolution is requested from external system
+     * @param reason - Why resolution is needed
+     * @param options - Available resolution options
+     */
+    onResolutionRequested?(reason: string, options: ResolutionOption[]): void;
+    /**
+     * Called when compilation completes (success or discarded)
+     * @param result - Final compiler snapshot
+     */
+    onComplete?(result: CompilerSnapshot): void;
+    /**
+     * Called when an effect is about to be executed
+     * @param effectType - Type of effect (e.g., 'llm:segment')
+     * @param params - Effect parameters
+     */
+    onEffectStart?(effectType: string, params: Record<string, unknown>): void;
+    /**
+     * Called when an effect completes
+     * @param effectType - Type of effect
+     * @param result - Effect handler result
+     */
+    onEffectEnd?(effectType: string, result: EffectHandlerResult): void;
+    /**
+     * Called on any error during compilation
+     * @param error - The error that occurred
+     * @param context - Context where error occurred (e.g., 'effect:llm:segment')
+     */
+    onError?(error: Error, context: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/domain/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domain/types.js.map

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

package/dist/effects/builder/index.d.ts

@@ -0,0 +1,2 @@
+export { createBuilderValidateHandler, type BuilderValidateHandler, type ValidateResult, } from "./validate-handler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/effects/builder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/effects/builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/effects/builder/index.js

@@ -0,0 +1,2 @@
+export { createBuilderValidateHandler, } from "./validate-handler.js";
+//# sourceMappingURL=index.js.map

package/dist/effects/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/effects/builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAG7B,MAAM,uBAAuB,CAAC"}

package/dist/effects/builder/validate-handler.d.ts

@@ -0,0 +1,27 @@
+import type { EffectHandlerResult } from "../llm/handlers.js";
+import type { CompilerDiagnostics } from "../../domain/types.js";
+/**
+ * Builder validate effect handler type
+ */
+export type BuilderValidateHandler = (params: Record<string, unknown>) => Promise<EffectHandlerResult>;
+/**
+ * Create builder:validate effect handler
+ *
+ * Per FDR-C010: Builder.validateDomain() MUST be the sole judge of DomainDraft validity.
+ * Compiler MUST NOT implement validation logic.
+ *
+ * This handler wraps the Builder validation and returns the result as an action.
+ *
+ * @param validateFn - Optional custom validation function (for testing)
+ */
+export declare function createBuilderValidateHandler(validateFn?: (draft: unknown) => ValidateResult): BuilderValidateHandler;
+/**
+ * Validation result from Builder
+ */
+export interface ValidateResult {
+    valid: boolean;
+    schema?: unknown;
+    schemaHash?: string;
+    diagnostics: CompilerDiagnostics;
+}
+//# sourceMappingURL=validate-handler.d.ts.map

package/dist/effects/builder/validate-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-handler.d.ts","sourceRoot":"","sources":["../../../src/effects/builder/validate-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,cAAc,GAC9C,sBAAsB,CA+CxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,mBAAmB,CAAC;CAClC"}

package/dist/effects/builder/validate-handler.js

@@ -0,0 +1,153 @@
+/**
+ * Create builder:validate effect handler
+ *
+ * Per FDR-C010: Builder.validateDomain() MUST be the sole judge of DomainDraft validity.
+ * Compiler MUST NOT implement validation logic.
+ *
+ * This handler wraps the Builder validation and returns the result as an action.
+ *
+ * @param validateFn - Optional custom validation function (for testing)
+ */
+export function createBuilderValidateHandler(validateFn) {
+    const validate = validateFn ?? defaultValidate;
+    return async (params) => {
+        const draft = params.draft;
+        const timestamp = Date.now();
+        try {
+            const result = validate(draft);
+            return {
+                action: "receiveValidation",
+                input: {
+                    valid: result.valid,
+                    schema: result.valid ? result.schema : null,
+                    diagnostics: result.diagnostics,
+                    schemaHash: result.valid ? result.schemaHash : null,
+                    timestamp,
+                },
+            };
+        }
+        catch (error) {
+            // Validation threw an error - treat as invalid
+            const message = error instanceof Error ? error.message : String(error);
+            const diagnostics = {
+                valid: false,
+                errors: [
+                    {
+                        code: "VALIDATION_ERROR",
+                        message: `Builder validation threw: ${message}`,
+                    },
+                ],
+                warnings: [],
+            };
+            return {
+                action: "receiveValidation",
+                input: {
+                    valid: false,
+                    schema: null,
+                    diagnostics,
+                    schemaHash: null,
+                    timestamp,
+                },
+            };
+        }
+    };
+}
+/**
+ * Default validation function
+ *
+ * This is a placeholder that performs basic structural validation.
+ * In production, this would call the actual Builder.validateDomain().
+ *
+ * TODO: Integrate with actual @manifesto-ai/builder validateDomain
+ */
+function defaultValidate(draft) {
+    // Basic structural validation
+    if (!draft || typeof draft !== "object") {
+        return {
+            valid: false,
+            diagnostics: {
+                valid: false,
+                errors: [{ code: "INVALID_DRAFT", message: "Draft must be an object" }],
+                warnings: [],
+            },
+        };
+    }
+    const d = draft;
+    // Check required fields
+    const requiredFields = ["id", "version", "state", "computed", "actions"];
+    const missingFields = requiredFields.filter((f) => !(f in d));
+    if (missingFields.length > 0) {
+        return {
+            valid: false,
+            diagnostics: {
+                valid: false,
+                errors: [
+                    {
+                        code: "MISSING_FIELDS",
+                        message: `Draft missing required fields: ${missingFields.join(", ")}`,
+                    },
+                ],
+                warnings: [],
+            },
+        };
+    }
+    // Check state structure
+    if (!d.state || typeof d.state !== "object") {
+        return {
+            valid: false,
+            diagnostics: {
+                valid: false,
+                errors: [{ code: "INVALID_STATE", message: "state must be an object" }],
+                warnings: [],
+            },
+        };
+    }
+    // Check computed structure
+    if (!d.computed || typeof d.computed !== "object") {
+        return {
+            valid: false,
+            diagnostics: {
+                valid: false,
+                errors: [{ code: "INVALID_COMPUTED", message: "computed must be an object" }],
+                warnings: [],
+            },
+        };
+    }
+    // Check actions structure
+    if (!d.actions || typeof d.actions !== "object") {
+        return {
+            valid: false,
+            diagnostics: {
+                valid: false,
+                errors: [{ code: "INVALID_ACTIONS", message: "actions must be an object" }],
+                warnings: [],
+            },
+        };
+    }
+    // Generate a simple hash
+    const schemaHash = generateSimpleHash(JSON.stringify(draft));
+    // Valid draft
+    return {
+        valid: true,
+        schema: draft,
+        schemaHash,
+        diagnostics: {
+            valid: true,
+            errors: [],
+            warnings: [],
+        },
+    };
+}
+/**
+ * Generate a simple hash for identification
+ */
+function generateSimpleHash(content) {
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const char = content.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash;
+    }
+    return Math.abs(hash).toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=validate-handler.js.map

package/dist/effects/builder/validate-handler.js.map

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

package/dist/effects/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./llm/index.js";
+export * from "./builder/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effects/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC"}

package/dist/effects/index.js

@@ -0,0 +1,5 @@
+// LLM effects
+export * from "./llm/index.js";
+// Builder effects
+export * from "./builder/index.js";
+//# sourceMappingURL=index.js.map

package/dist/effects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/effects/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,cAAc,gBAAgB,CAAC;AAE/B,kBAAkB;AAClB,cAAc,oBAAoB,CAAC"}