@substrate-ai/factory 0.19.54

package/dist/graph/types.d.ts

@@ -0,0 +1,320 @@
+/**
+ * Core type definitions for the factory graph engine.
+ * Sourced from architecture-software-factory.md and story 42-1.
+ */
+import type { StageStatus } from '../events.js';
+export type { StageStatus };
+/**
+ * Terminal status values returned by every node handler.
+ * Drives edge selection, checkpointing, and retry logic.
+ *
+ * - `SUCCESS` — the node completed all objectives fully.
+ * - `FAILURE` — the node failed and downstream work should not proceed.
+ * - `NEEDS_RETRY` — the handler requests another attempt (consumed by retry loop).
+ * - `ESCALATE` — the node requires human intervention or parent-pipeline escalation.
+ *
+ * `PARTIAL_SUCCESS` — the primary objective was met but secondary goals were missed.
+ * Examples: code was generated but not all tests pass; a report was produced but
+ * coverage targets were not hit. Use instead of `FAILURE` when the output has value
+ * and downstream nodes can act on it.
+ *
+ * Retry exhaustion behaviour: if `GraphNode.allowPartial === false` (default),
+ * the executor demotes `PARTIAL_SUCCESS` to `FAILURE`; if `allowPartial === true`,
+ * it is accepted as-is. Goal gates always accept `PARTIAL_SUCCESS` as satisfying.
+ */
+export type OutcomeStatus = 'SUCCESS' | 'PARTIAL_SUCCESS' | 'FAILURE' | 'NEEDS_RETRY' | 'ESCALATE';
+/**
+ * Structured result returned by every node handler.
+ * The executor reads contextUpdates and merges them into GraphContext after a
+ * successful node, uses preferredLabel and suggestedNextIds in edge selection
+ * (story 42-12), stores notes in the checkpoint (story 42-13), and uses the
+ * status to trigger retry / escalation logic.
+ */
+export interface Outcome {
+    status: OutcomeStatus;
+    preferredLabel?: string;
+    suggestedNextIds?: string[];
+    contextUpdates?: Record<string, unknown>;
+    notes?: string;
+    error?: unknown;
+    /** Human-readable reason for FAILURE outcomes (e.g., stderr from tool handler). */
+    failureReason?: string;
+}
+/**
+ * Fidelity mode for node or graph-level quality setting.
+ */
+export type FidelityMode = 'high' | 'medium' | 'low' | 'draft';
+/**
+ * A single node in the factory graph.
+ * All 17 attributes from the DOT Attribute Mapping table (story 42-2).
+ */
+export interface GraphNode {
+    id: string;
+    label: string;
+    shape: string;
+    type: string;
+    prompt: string;
+    maxRetries: number;
+    goalGate: boolean;
+    retryTarget: string;
+    fallbackRetryTarget: string;
+    fidelity: string;
+    threadId: string;
+    class: string;
+    timeout: number;
+    llmModel: string;
+    llmProvider: string;
+    reasoningEffort: string;
+    autoStatus: boolean;
+    /**
+     * Controls executor behaviour when a handler returns `PARTIAL_SUCCESS` and all
+     * retry attempts are exhausted.
+     *
+     * - `false` (default): the executor demotes `PARTIAL_SUCCESS` to `FAILURE`,
+     *   adding an explanatory `failureReason`. The node is treated as failed for
+     *   checkpointing, edge selection, and goal gate evaluation.
+     * - `true`: `PARTIAL_SUCCESS` is accepted as-is; execution continues to the
+     *   next node and goal gates treat it the same as `SUCCESS`.
+     */
+    allowPartial: boolean;
+    /** Shell command string for tool nodes (from `tool_command` DOT attribute). Story 42-11. */
+    toolCommand: string;
+    /** Backend selector for codergen nodes ('direct' → DirectCodergenBackend). Story 48-10. */
+    backend: string;
+    /** Maximum number of concurrent branch executions (0 = unlimited). Story 50-1. */
+    maxParallel?: number;
+    /** Join policy controlling when the parallel handler returns (e.g. 'wait_all'). Story 50-1. */
+    joinPolicy?: string;
+    /**
+     * Arbitrary DOT attributes that do not map to a named `GraphNode` field.
+     * Populated for node types that use domain-specific attributes not covered by
+     * the standard fields (e.g. `join_policy`, `quorum_size`, `cancel_drain_timeout_ms`
+     * for parallel nodes). Story 50-3.
+     */
+    attrs?: Record<string, string>;
+}
+/**
+ * A directed edge between two nodes in the factory graph.
+ * All 6 edge attributes from the DOT Attribute Mapping table (story 42-2).
+ */
+export interface GraphEdge {
+    id?: string;
+    fromNode: string;
+    toNode: string;
+    label: string;
+    condition: string;
+    weight: number;
+    fidelity: string;
+    threadId: string;
+    loopRestart: boolean;
+}
+/**
+ * The top-level factory graph model returned by `parseGraph()`.
+ *
+ * `outgoingEdges`, `startNode`, and `exitNode` are implemented as methods
+ * on the concrete `GraphImpl` class.
+ */
+export interface Graph {
+    /** DOT graph id (or empty string if unnamed) */
+    id: string;
+    /** High-level goal for this pipeline */
+    goal: string;
+    /** Human-readable label */
+    label: string;
+    /** Path to the model stylesheet YAML */
+    modelStylesheet: string;
+    /** Default maximum retry attempts for nodes that don't override */
+    defaultMaxRetries: number;
+    /** Default retry target node id */
+    retryTarget: string;
+    /** Default fallback retry target node id */
+    fallbackRetryTarget: string;
+    /** Default fidelity mode */
+    defaultFidelity: FidelityMode | '';
+    /** All nodes keyed by id */
+    nodes: Map<string, GraphNode>;
+    /** All edges */
+    edges: GraphEdge[];
+    /** Return all edges originating from the given node id */
+    outgoingEdges(nodeId: string): GraphEdge[];
+    /** Return the start node (shape=Mdiamond or type=start) */
+    startNode(): GraphNode;
+    /** Return the exit node (shape=Msquare or type=exit) */
+    exitNode(): GraphNode;
+}
+/**
+ * A single parsed clause of an edge condition expression.
+ *
+ * Grammar reference (Attractor Spec §10, extended in story 44-5):
+ *   condition  ::= clause ('&&' clause)*
+ *   clause     ::= key op value
+ *   key        ::= [a-zA-Z_][a-zA-Z0-9_]*
+ *   op         ::= '=' | '!=' | '>=' | '<=' | '>' | '<'
+ *   value      ::= quoted_string | unquoted_token
+ *
+ * Numeric comparison operators (>=, <=, >, <) compare context values as
+ * numbers via Number(). String operators (=, !=) retain string-equality
+ * semantics unchanged.
+ */
+export interface ConditionClause {
+    key: string;
+    op: '=' | '!=' | '>=' | '<=' | '>' | '<';
+    value: string;
+}
+/**
+ * A parsed condition expression — a conjunction of one or more clauses.
+ * All clauses must be satisfied for the condition to evaluate to true.
+ */
+export type ParsedCondition = ConditionClause[];
+/**
+ * Thread-safe key-value store for node handler execution state.
+ * Implemented by `GraphContext` in `context.ts`.
+ * "Thread-safety" in the JS single-threaded sense: each clone() produces an
+ * independent backing store so mutations do not propagate between instances.
+ */
+export interface IGraphContext {
+    /** Return stored value, or `undefined` if the key is absent. */
+    get(key: string): unknown;
+    /** Store value; overwrites if the key already exists. */
+    set(key: string, value: unknown): void;
+    /** Return String-coerced value, or `defaultValue` (default `""`) if absent. */
+    getString(key: string, defaultValue?: string): string;
+    /** Return Number-coerced value, or `defaultValue` (default `0`) if absent; NaN resolves to default. */
+    getNumber(key: string, defaultValue?: number): number;
+    /** Return Boolean-coerced value, or `defaultValue` (default `false`) if absent. */
+    getBoolean(key: string, defaultValue?: boolean): boolean;
+    /** Merge all entries from `updates` into the store; does not clear pre-existing keys. */
+    applyUpdates(updates: Record<string, unknown>): void;
+    /** Return a shallow-copied plain object of all current key-value pairs. */
+    snapshot(): Record<string, unknown>;
+    /** Return a completely independent copy backed by its own Map. */
+    clone(): IGraphContext;
+}
+/**
+ * The set of recognised CSS-like properties in a model stylesheet.
+ */
+export type StylesheetProperty = 'llm_model' | 'llm_provider' | 'reasoning_effort';
+/**
+ * A single `property: value` pair inside a stylesheet rule block.
+ */
+export interface StylesheetDeclaration {
+    property: StylesheetProperty;
+    value: string;
+}
+/**
+ * Discriminant for the four supported selector types.
+ * Determines how the selector is matched against a node and the specificity assigned.
+ */
+export type StylesheetSelectorType = 'universal' | 'shape' | 'class' | 'id';
+/**
+ * A parsed CSS-like selector with its type, match value, and specificity score.
+ *
+ * | Selector type | Example         | Specificity |
+ * |---------------|-----------------|-------------|
+ * | universal     | `*`             | 0           |
+ * | shape         | `box`           | 1           |
+ * | class         | `.code`         | 2           |
+ * | id            | `#review_node`  | 3           |
+ */
+export interface StylesheetSelector {
+    type: StylesheetSelectorType;
+    value: string;
+    specificity: 0 | 1 | 2 | 3;
+}
+/**
+ * A single parsed rule from a model stylesheet: one selector + zero or more declarations.
+ */
+export interface StylesheetRule {
+    selector: StylesheetSelector;
+    declarations: StylesheetDeclaration[];
+}
+/**
+ * A fully parsed model stylesheet — an ordered array of rules in source order.
+ */
+export type ParsedStylesheet = StylesheetRule[];
+/**
+ * The LLM routing properties resolved for a specific graph node after applying
+ * all matching stylesheet rules in specificity order.
+ *
+ * Only properties that appear in at least one matching rule are present;
+ * the caller is responsible for merging with explicit node attributes and graph defaults.
+ */
+export interface ResolvedNodeStyles {
+    llmModel?: string;
+    llmProvider?: string;
+    reasoningEffort?: string;
+}
+/**
+ * A persisted execution checkpoint for resuming a graph run.
+ * Spec-compliant shape from Attractor Spec §5.3 (story 42-13).
+ */
+export interface Checkpoint {
+    /** Unix timestamp (ms) when this checkpoint was created */
+    timestamp: number;
+    /** ID of the last completed node */
+    currentNode: string;
+    /** IDs of all completed nodes in traversal order */
+    completedNodes: string[];
+    /** Retry counters keyed by node ID */
+    nodeRetries: Record<string, number>;
+    /** Serialized snapshot of GraphContext at save time */
+    contextValues: Record<string, unknown>;
+    /** Execution log lines accumulated since run start */
+    logs: string[];
+}
+/**
+ * State returned by `CheckpointManager.resume()` for use by the graph executor.
+ * Story 42-13.
+ */
+export interface ResumeState {
+    /** GraphContext seeded from checkpoint.contextValues */
+    context: IGraphContext;
+    /** Set of node IDs that were already completed — executor skips these */
+    completedNodes: Set<string>;
+    /** Retry counters restored from checkpoint */
+    nodeRetries: Record<string, number>;
+    /**
+     * Fidelity override for the first resumed node.
+     * Set to 'summary:high' when the last-executed node used 'full' fidelity
+     * (in-memory LLM sessions cannot be serialized).
+     * Empty string means no degradation is needed.
+     */
+    firstResumedNodeFidelity: string;
+}
+/**
+ * Backend used for AI-assisted code generation within the graph engine.
+ * Stub — expanded in story 42-9.
+ */
+export interface CodergenBackend {
+    generate(prompt: string, context: IGraphContext): Promise<string>;
+}
+/**
+ * A single diagnostic produced by graph validation.
+ * Expanded in story 42-4.
+ */
+export interface ValidationDiagnostic {
+    ruleId: string;
+    severity: 'error' | 'warning';
+    message: string;
+    nodeId?: string;
+    edgeIndex?: number;
+}
+/**
+ * A single lint rule applied during graph validation.
+ * Expanded in story 42-4.
+ */
+export interface LintRule {
+    id: string;
+    severity: 'error' | 'warning';
+    check(graph: Graph): ValidationDiagnostic[];
+}
+/**
+ * Validates a parsed graph and returns diagnostics.
+ * Expanded in story 42-4.
+ */
+export interface GraphValidator {
+    validate(graph: Graph): ValidationDiagnostic[];
+    validateOrRaise(graph: Graph): void;
+    registerRule(rule: LintRule): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/C,YAAY,EAAE,WAAW,EAAE,CAAA;AAM3B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAA;AAElG;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,aAAa,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAMD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAA;AAM9D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB;;;;;;;;;OASG;IACH,YAAY,EAAE,OAAO,CAAA;IACrB,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAA;IACnB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAMD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,OAAO,CAAA;CACrB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAA;IACV,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAA;IACvB,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAA;IACzB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAA;IAC3B,4BAA4B;IAC5B,eAAe,EAAE,YAAY,GAAG,EAAE,CAAA;IAClC,4BAA4B;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC7B,gBAAgB;IAChB,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,0DAA0D;IAC1D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1C,2DAA2D;IAC3D,SAAS,IAAI,SAAS,CAAA;IACtB,wDAAwD;IACxD,QAAQ,IAAI,SAAS,CAAA;CACtB;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,CAAA;IACxC,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,EAAE,CAAA;AAM/C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,yDAAyD;IACzD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACtC,+EAA+E;IAC/E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrD,uGAAuG;IACvG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrD,mFAAmF;IACnF,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IACxD,yFAAyF;IACzF,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACpD,2EAA2E;IAC3E,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,kEAAkE;IAClE,KAAK,IAAI,aAAa,CAAA;CACvB;AAMD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,cAAc,GAAG,kBAAkB,CAAA;AAElF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;AAE3E;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,YAAY,EAAE,qBAAqB,EAAE,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,EAAE,CAAA;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAMD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,sDAAsD;IACtD,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,OAAO,EAAE,aAAa,CAAA;IACtB,yEAAyE;IACzE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC3B,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC;;;;;OAKG;IACH,wBAAwB,EAAE,MAAM,CAAA;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,oBAAoB,EAAE,CAAA;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,oBAAoB,EAAE,CAAA;IAC9C,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnC,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;CACnC"}

package/dist/graph/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core type definitions for the factory graph engine.
+ * Sourced from architecture-software-factory.md and story 42-1.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/graph/types.js.map

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

package/dist/graph/validator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Graph validator factory.
+ * Story 42-4: Graph Validator — Error Rules
+ *
+ * `createValidator()` returns a `GraphValidator` pre-loaded with all 8 error rules.
+ * Additional rules (e.g., warnings from story 42-5) can be added via `registerRule()`.
+ */
+import type { GraphValidator } from './types.js';
+export { isStartNode, isExitNode } from './rules/error-rules.js';
+/**
+ * Create a new `GraphValidator` pre-registered with all 8 error-severity rules
+ * and all 5 warning-severity rules.
+ * Additional rules can be registered via `registerRule()`.
+ */
+export declare function createValidator(): GraphValidator;
+//# sourceMappingURL=validator.d.ts.map

package/dist/graph/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/graph/validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAS,cAAc,EAAkC,MAAM,YAAY,CAAA;AAKvF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEhE;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,cAAc,CA2BhD"}

package/dist/graph/validator.js

@@ -0,0 +1,40 @@
+/**
+ * Graph validator factory.
+ * Story 42-4: Graph Validator — Error Rules
+ *
+ * `createValidator()` returns a `GraphValidator` pre-loaded with all 8 error rules.
+ * Additional rules (e.g., warnings from story 42-5) can be added via `registerRule()`.
+ */
+import { errorRules } from './rules/error-rules.js';
+import { warningRules } from './rules/warning-rules.js';
+// Re-export node detection helpers for consumers (stories 42-9, 42-14).
+export { isStartNode, isExitNode } from './rules/error-rules.js';
+/**
+ * Create a new `GraphValidator` pre-registered with all 8 error-severity rules
+ * and all 5 warning-severity rules.
+ * Additional rules can be registered via `registerRule()`.
+ */
+export function createValidator() {
+    const rules = [...errorRules, ...warningRules];
+    return {
+        registerRule(rule) {
+            rules.push(rule);
+        },
+        validate(graph) {
+            const diagnostics = [];
+            for (const rule of rules) {
+                diagnostics.push(...rule.check(graph));
+            }
+            return diagnostics;
+        },
+        validateOrRaise(graph) {
+            const diagnostics = this.validate(graph);
+            const errors = diagnostics.filter((d) => d.severity === 'error');
+            if (errors.length > 0) {
+                throw new Error('Graph validation failed:\n' +
+                    errors.map((d) => `[${d.ruleId}] ${d.message}`).join('\n'));
+            }
+        },
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/graph/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/graph/validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,wEAAwE;AACxE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEhE;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAe,CAAC,GAAG,UAAU,EAAE,GAAG,YAAY,CAAC,CAAA;IAE1D,OAAO;QACL,YAAY,CAAC,IAAc;YACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,CAAC;QAED,QAAQ,CAAC,KAAY;YACnB,MAAM,WAAW,GAA2B,EAAE,CAAA;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;YACxC,CAAC;YACD,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,eAAe,CAAC,KAAY;YAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YACxC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAA;YAChE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,4BAA4B;oBAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7D,CAAA;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/handlers/__tests__/codergen-handler.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Unit tests for the codergen handler (story 42-10).
+ *
+ * Covers:
+ *   AC1 – prompt template interpolation ({{variable}} substitution)
+ *   AC2 – model resolution via stylesheet
+ *   AC3 – LLM invocation with resolved parameters
+ *   AC4 – successful response mapped to SUCCESS outcome
+ *   AC5 – transient LLM errors (429, timeout, network reset) → NEEDS_RETRY
+ *   AC6 – non-transient errors → FAILURE
+ *   AC7 – codergen handler is the default in createDefaultRegistry()
+ */
+export {};
+//# sourceMappingURL=codergen-handler.test.d.ts.map

package/dist/handlers/__tests__/codergen-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codergen-handler.test.d.ts","sourceRoot":"","sources":["../../../src/handlers/__tests__/codergen-handler.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}