@substrate-ai/factory 0.19.54

package/dist/stylesheet/parser.js

@@ -0,0 +1,190 @@
+/**
+ * CSS-like stylesheet parser for the `model_stylesheet` graph attribute.
+ *
+ * Grammar (Attractor Spec §8.2):
+ *   Stylesheet    ::= Rule*
+ *   Rule          ::= Selector '{' Declaration ( ';' Declaration )* ';'? '}'
+ *   Selector      ::= '*' | ShapeName | '#' Identifier | '.' ClassName
+ *   ClassName     ::= [a-z0-9_-]+
+ *   ShapeName     ::= [a-zA-Z_][a-zA-Z0-9_]*
+ *   Identifier    ::= [a-zA-Z_][a-zA-Z0-9_]*
+ *   Declaration   ::= Property ':' PropertyValue
+ *   Property      ::= 'llm_model' | 'llm_provider' | 'reasoning_effort'
+ *   PropertyValue ::= QuotedString | BareValue
+ *   QuotedString  ::= '"' [^"]* '"' | "'" [^']* "'"
+ *   BareValue     ::= [^\s;{}]+
+ *
+ * Story 42-7.
+ */
+// ---------------------------------------------------------------------------
+// StylesheetParseError
+// ---------------------------------------------------------------------------
+/**
+ * Thrown by `parseStylesheet` when the stylesheet source does not conform
+ * to the supported grammar.
+ */
+export class StylesheetParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'StylesheetParseError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Valid properties
+// ---------------------------------------------------------------------------
+const VALID_PROPERTIES = new Set([
+    'llm_model',
+    'llm_provider',
+    'reasoning_effort',
+]);
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Strip C-style block comments (`/* ... *\/`) and line comments (`// ...`)
+ * from the source string before parsing.
+ */
+function stripComments(source) {
+    // Strip block comments: /* ... */  (non-greedy, dotall)
+    let result = source.replace(/\/\*[\s\S]*?\*\//g, '');
+    // Strip line comments: // ... (to end of line)
+    result = result.replace(/\/\/[^\n]*/g, '');
+    return result;
+}
+/**
+ * Strip surrounding single or double quotes from a property value string.
+ * Returns the original string if it is not quoted.
+ */
+function stripValueQuotes(value) {
+    if (value.length >= 2) {
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            return value.slice(1, -1);
+        }
+    }
+    return value;
+}
+/**
+ * Parse a selector token string into a `StylesheetSelector`.
+ * Throws `StylesheetParseError` for invalid selector syntax.
+ */
+function parseSelector(token) {
+    if (token === '*') {
+        return { type: 'universal', value: '*', specificity: 0 };
+    }
+    if (token.startsWith('#')) {
+        const name = token.slice(1);
+        if (!name || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {
+            throw new StylesheetParseError(`Invalid ID selector '${token}'; expected '#' followed by an identifier matching [a-zA-Z_][a-zA-Z0-9_]*`);
+        }
+        return { type: 'id', value: name, specificity: 3 };
+    }
+    if (token.startsWith('.')) {
+        const name = token.slice(1);
+        if (!name || !/^[a-z0-9_-]+$/.test(name)) {
+            throw new StylesheetParseError(`Invalid class selector '${token}'; expected '.' followed by a class name matching [a-z0-9_-]+`);
+        }
+        return { type: 'class', value: name, specificity: 2 };
+    }
+    // Shape selector — bare identifier
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(token)) {
+        throw new StylesheetParseError(`Invalid selector '${token}'; expected '*', a shape name ([a-zA-Z_][a-zA-Z0-9_]*), '#identifier', or '.classname'`);
+    }
+    return { type: 'shape', value: token, specificity: 1 };
+}
+/**
+ * Parse the declaration block content (text between `{` and `}`) for a rule.
+ *
+ * @param content   - Raw text between the opening and closing braces.
+ * @param selector  - Selector token string (used only for error messages).
+ * @returns An array of parsed `StylesheetDeclaration` objects.
+ * @throws `StylesheetParseError` on unknown property or malformed pair.
+ */
+function parseDeclarations(content, selector) {
+    const declarations = [];
+    const segments = content.split(';');
+    for (const segment of segments) {
+        const trimmed = segment.trim();
+        if (trimmed === '')
+            continue; // empty segment from trailing semicolon or whitespace
+        const colonPos = trimmed.indexOf(':');
+        if (colonPos === -1) {
+            throw new StylesheetParseError(`Invalid declaration in selector '${selector}': missing ':' in '${trimmed}'`);
+        }
+        const propRaw = trimmed.slice(0, colonPos).trim();
+        const valueRaw = trimmed.slice(colonPos + 1).trim();
+        if (!VALID_PROPERTIES.has(propRaw)) {
+            throw new StylesheetParseError(`Unknown property '${propRaw}' in selector '${selector}'; ` +
+                `expected one of: ${[...VALID_PROPERTIES].join(', ')}`);
+        }
+        const value = stripValueQuotes(valueRaw);
+        if (value === '') {
+            throw new StylesheetParseError(`Missing value for property '${propRaw}' in selector '${selector}'`);
+        }
+        declarations.push({ property: propRaw, value });
+    }
+    return declarations;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a CSS-like model stylesheet string into a `ParsedStylesheet`.
+ *
+ * The parser:
+ * - Strips C-style block comments (`/* ... * /`) and `//` line comments before parsing.
+ * - Recognises four selector types: universal (`*`), shape (bare identifier),
+ *   class (`.name`), and ID (`#name`).
+ * - Validates that every declared property is one of the three known routing
+ *   properties: `llm_model`, `llm_provider`, `reasoning_effort`.
+ * - Preserves source order in the returned array.
+ *
+ * @param source - The raw stylesheet string.
+ * @returns A `ParsedStylesheet` (array of `StylesheetRule`) in source order.
+ * @throws `StylesheetParseError` on syntax errors, unknown properties, or
+ *   unbalanced braces.
+ */
+export function parseStylesheet(source) {
+    const cleaned = stripComments(source);
+    const rules = [];
+    let pos = 0;
+    while (pos < cleaned.length) {
+        // Skip leading whitespace
+        while (pos < cleaned.length && /\s/.test(cleaned[pos]))
+            pos++;
+        if (pos >= cleaned.length)
+            break;
+        // Find the opening brace for this rule
+        const braceOpenPos = cleaned.indexOf('{', pos);
+        if (braceOpenPos === -1) {
+            // Remaining content has no opening brace — it's an error if non-empty
+            const remaining = cleaned.slice(pos).trim();
+            if (remaining !== '') {
+                throw new StylesheetParseError(`Unexpected content without opening brace '{': '${remaining}'`);
+            }
+            break;
+        }
+        // Extract and validate the selector token
+        const selectorToken = cleaned.slice(pos, braceOpenPos).trim();
+        if (selectorToken === '') {
+            throw new StylesheetParseError(`Empty selector before '{'`);
+        }
+        // Find the matching closing brace
+        const braceClosePos = cleaned.indexOf('}', braceOpenPos + 1);
+        if (braceClosePos === -1) {
+            throw new StylesheetParseError(`Missing closing brace '}' for selector '${selectorToken}'`);
+        }
+        // The block content between { and }
+        const blockContent = cleaned.slice(braceOpenPos + 1, braceClosePos);
+        // Reject nested braces (unbalanced — inner '{' inside block)
+        if (blockContent.includes('{')) {
+            throw new StylesheetParseError(`Unexpected '{' inside declaration block for selector '${selectorToken}'; nested rules are not supported`);
+        }
+        const selector = parseSelector(selectorToken);
+        const declarations = parseDeclarations(blockContent, selectorToken);
+        rules.push({ selector, declarations });
+        pos = braceClosePos + 1;
+    }
+    return rules;
+}
+//# sourceMappingURL=parser.js.map

package/dist/stylesheet/parser.js.map

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

package/dist/stylesheet/resolver.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Specificity-based resolver for the model stylesheet.
+ *
+ * Given a parsed stylesheet and a graph node, `resolveNodeStyles` determines
+ * which LLM routing properties apply to that node by:
+ *   1. Filtering rules to only those whose selector matches the node.
+ *   2. Sorting matching rules by specificity ascending (stable sort so that
+ *      equal-specificity rules preserve source order).
+ *   3. Iterating the sorted list and letting each rule overwrite properties
+ *      — the last rule at the highest specificity wins; for ties the rule
+ *      appearing later in the original stylesheet wins.
+ *
+ * **Caller contract**: `resolveNodeStyles` does NOT enforce the "explicit node
+ * attribute wins" rule.  The caller (executor / node preparation layer) is
+ * responsible for the final merge:
+ * ```typescript
+ * const resolved = resolveNodeStyles(node, stylesheet)
+ * const finalModel = node.llmModel || resolved.llmModel || graph.defaultLlmModel || ''
+ * ```
+ *
+ * Story 42-7.
+ */
+import type { GraphNode, ParsedStylesheet, ResolvedNodeStyles } from '../graph/types.js';
+/**
+ * Resolve LLM routing properties for a single graph node using the parsed stylesheet.
+ *
+ * @param node       - The graph node to resolve properties for.
+ * @param stylesheet - A parsed stylesheet (array of `StylesheetRule` in source order).
+ * @returns A `ResolvedNodeStyles` object containing only the properties that
+ *   were resolved from matching rules.  Properties absent from matching rules
+ *   are omitted (not set to `undefined` explicitly).
+ *
+ * **Important**: this function does NOT check the node's own attributes.
+ * Callers must give explicit node attributes (`node.llmModel`, etc.) priority
+ * over the values returned here.
+ */
+export declare function resolveNodeStyles(node: GraphNode, stylesheet: ParsedStylesheet): ResolvedNodeStyles;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/stylesheet/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/stylesheet/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAsB,MAAM,mBAAmB,CAAA;AA0C5G;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,GAAG,kBAAkB,CA4BnG"}

package/dist/stylesheet/resolver.js

@@ -0,0 +1,96 @@
+/**
+ * Specificity-based resolver for the model stylesheet.
+ *
+ * Given a parsed stylesheet and a graph node, `resolveNodeStyles` determines
+ * which LLM routing properties apply to that node by:
+ *   1. Filtering rules to only those whose selector matches the node.
+ *   2. Sorting matching rules by specificity ascending (stable sort so that
+ *      equal-specificity rules preserve source order).
+ *   3. Iterating the sorted list and letting each rule overwrite properties
+ *      — the last rule at the highest specificity wins; for ties the rule
+ *      appearing later in the original stylesheet wins.
+ *
+ * **Caller contract**: `resolveNodeStyles` does NOT enforce the "explicit node
+ * attribute wins" rule.  The caller (executor / node preparation layer) is
+ * responsible for the final merge:
+ * ```typescript
+ * const resolved = resolveNodeStyles(node, stylesheet)
+ * const finalModel = node.llmModel || resolved.llmModel || graph.defaultLlmModel || ''
+ * ```
+ *
+ * Story 42-7.
+ */
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Return `true` if the given `selector` matches the provided `node`.
+ *
+ * Matching rules:
+ * - `universal`: always matches every node.
+ * - `shape`: matches when `node.shape === selector.value`.
+ * - `class`: matches when the node's `class` field, split on commas and
+ *   trimmed, contains `selector.value` (case-sensitive).
+ * - `id`: matches when `node.id === selector.value`.
+ */
+function matchesNode(node, selector) {
+    switch (selector.type) {
+        case 'universal':
+            return true;
+        case 'shape':
+            return node.shape === selector.value;
+        case 'class': {
+            // node.class is a comma-separated list of class tokens (e.g. "code,critical,fast")
+            const tokens = node.class.split(',').map((t) => t.trim());
+            return tokens.includes(selector.value);
+        }
+        case 'id':
+            return node.id === selector.value;
+        default:
+            return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Resolve LLM routing properties for a single graph node using the parsed stylesheet.
+ *
+ * @param node       - The graph node to resolve properties for.
+ * @param stylesheet - A parsed stylesheet (array of `StylesheetRule` in source order).
+ * @returns A `ResolvedNodeStyles` object containing only the properties that
+ *   were resolved from matching rules.  Properties absent from matching rules
+ *   are omitted (not set to `undefined` explicitly).
+ *
+ * **Important**: this function does NOT check the node's own attributes.
+ * Callers must give explicit node attributes (`node.llmModel`, etc.) priority
+ * over the values returned here.
+ */
+export function resolveNodeStyles(node, stylesheet) {
+    // 1. Filter to rules whose selector matches this node
+    const matchingRules = stylesheet.filter((rule) => matchesNode(node, rule.selector));
+    // 2. Stable-sort by specificity ascending so higher-specificity rules come
+    //    last and can overwrite lower-specificity values during iteration.
+    //    Array.prototype.sort is stable (guaranteed since ES2019 / Node 12+),
+    //    so equal-specificity rules remain in their original source order,
+    //    meaning a later rule in the stylesheet will appear later in the sorted
+    //    array and will correctly win by overwriting.
+    matchingRules.sort((a, b) => a.selector.specificity - b.selector.specificity);
+    // 3. Accumulate resolved properties — each rule overwrites earlier ones
+    const resolved = {};
+    for (const rule of matchingRules) {
+        for (const decl of rule.declarations) {
+            if (decl.property === 'llm_model') {
+                resolved.llmModel = decl.value;
+            }
+            else if (decl.property === 'llm_provider') {
+                resolved.llmProvider = decl.value;
+            }
+            else if (decl.property === 'reasoning_effort') {
+                resolved.reasoningEffort = decl.value;
+            }
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/stylesheet/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/stylesheet/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,IAAe,EAAE,QAA4B;IAChE,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,WAAW;YACd,OAAO,IAAI,CAAA;QAEb,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAA;QAEtC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,mFAAmF;YACnF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YACzD,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACxC,CAAC;QAED,KAAK,IAAI;YACP,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,KAAK,CAAA;QAEnC;YACE,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,UAA4B;IAC7E,sDAAsD;IACtD,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEnF,2EAA2E;IAC3E,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,4EAA4E;IAC5E,kDAAkD;IAClD,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IAE7E,wEAAwE;IACxE,MAAM,QAAQ,GAAuB,EAAE,CAAA;IAEvC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAClC,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAA;YAChC,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC;gBAC5C,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAA;YACnC,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,kBAAkB,EAAE,CAAC;gBAChD,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,CAAA;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for the pipeline template registry.
+ *
+ * Story 50-10 AC7 — ≥10 test cases covering registry correctness and DOT validity.
+ */
+export {};
+//# sourceMappingURL=templates.test.d.ts.map

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

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

package/dist/templates/__tests__/templates.test.js

@@ -0,0 +1,92 @@
+/**
+ * Unit tests for the pipeline template registry.
+ *
+ * Story 50-10 AC7 — ≥10 test cases covering registry correctness and DOT validity.
+ */
+import { describe, it, expect } from 'vitest';
+import { listPipelineTemplates, getPipelineTemplate } from '../index.js';
+import { parseGraph } from '../../graph/parser.js';
+describe('listPipelineTemplates()', () => {
+    it('returns exactly 4 entries', () => {
+        const templates = listPipelineTemplates();
+        expect(templates).toHaveLength(4);
+    });
+    it('returns templates in insertion order (trycycle first, staged-validation last)', () => {
+        const templates = listPipelineTemplates();
+        expect(templates[0]?.name).toBe('trycycle');
+        expect(templates[3]?.name).toBe('staged-validation');
+    });
+});
+describe('getPipelineTemplate()', () => {
+    it("returns trycycle template with name === 'trycycle'", () => {
+        const t = getPipelineTemplate('trycycle');
+        expect(t).toBeDefined();
+        expect(t?.name).toBe('trycycle');
+    });
+    it("returns dual-review template with name === 'dual-review'", () => {
+        const t = getPipelineTemplate('dual-review');
+        expect(t).toBeDefined();
+        expect(t?.name).toBe('dual-review');
+    });
+    it("returns parallel-exploration template with name === 'parallel-exploration'", () => {
+        const t = getPipelineTemplate('parallel-exploration');
+        expect(t).toBeDefined();
+        expect(t?.name).toBe('parallel-exploration');
+    });
+    it("returns staged-validation template with name === 'staged-validation'", () => {
+        const t = getPipelineTemplate('staged-validation');
+        expect(t).toBeDefined();
+        expect(t?.name).toBe('staged-validation');
+    });
+    it("returns undefined for an unknown template name", () => {
+        const t = getPipelineTemplate('nonexistent');
+        expect(t).toBeUndefined();
+    });
+});
+describe('DOT content validity — trycycle', () => {
+    it('parseGraph(trycycle.dotContent) does not throw', () => {
+        const trycycle = getPipelineTemplate('trycycle');
+        expect(() => parseGraph(trycycle.dotContent)).not.toThrow();
+    });
+    it("parsed trycycle graph contains a node with id 'eval_plan'", () => {
+        const trycycle = getPipelineTemplate('trycycle');
+        const graph = parseGraph(trycycle.dotContent);
+        expect(graph.nodes.has('eval_plan')).toBe(true);
+    });
+});
+describe('DOT content validity — dual-review', () => {
+    it('parseGraph(dual_review.dotContent) does not throw', () => {
+        const dualReview = getPipelineTemplate('dual-review');
+        expect(() => parseGraph(dualReview.dotContent)).not.toThrow();
+    });
+    it("parsed dual-review graph has at least one node whose type is 'parallel' (fan-out handler)", () => {
+        const dualReview = getPipelineTemplate('dual-review');
+        const graph = parseGraph(dualReview.dotContent);
+        const parallelNodes = Array.from(graph.nodes.values()).filter((n) => n.type === 'parallel');
+        expect(parallelNodes.length).toBeGreaterThanOrEqual(1);
+    });
+});
+describe('DOT content validity — parallel-exploration', () => {
+    it('parseGraph(parallel_exploration.dotContent) does not throw', () => {
+        const parallelExploration = getPipelineTemplate('parallel-exploration');
+        expect(() => parseGraph(parallelExploration.dotContent)).not.toThrow();
+    });
+    it("parsed parallel-exploration graph has at least one node whose type is 'parallel.fan_in'", () => {
+        const parallelExploration = getPipelineTemplate('parallel-exploration');
+        const graph = parseGraph(parallelExploration.dotContent);
+        const fanInNodes = Array.from(graph.nodes.values()).filter((n) => n.type === 'parallel.fan_in');
+        expect(fanInNodes.length).toBeGreaterThanOrEqual(1);
+    });
+});
+describe('DOT content validity — staged-validation', () => {
+    it('parseGraph(staged_validation.dotContent) does not throw', () => {
+        const stagedValidation = getPipelineTemplate('staged-validation');
+        expect(() => parseGraph(stagedValidation.dotContent)).not.toThrow();
+    });
+    it("parsed staged-validation graph contains a node with id 'lint'", () => {
+        const stagedValidation = getPipelineTemplate('staged-validation');
+        const graph = parseGraph(stagedValidation.dotContent);
+        expect(graph.nodes.has('lint')).toBe(true);
+    });
+});
+//# sourceMappingURL=templates.test.js.map

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

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

package/dist/templates/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Pipeline Template Catalog — pre-built DOT graph pipeline templates for common patterns.
+ *
+ * Story 50-10.
+ *
+ * Node type strings used:
+ *   - `start`          — start node (registered by default registry)
+ *   - `exit`           — exit node (registered by default registry)
+ *   - `codergen`       — coding agent node (registered by default registry)
+ *   - `parallel`       — parallel fan-out node (story 50-1, shape=component)
+ *   - `parallel.fan_in`— fan-in/merge node (story 50-2, shape=tripleoctagon)
+ */
+/**
+ * A single entry in the pipeline template catalog.
+ */
+export interface PipelineTemplate {
+    /** Unique template name (used as the `--template` flag value) */
+    name: string;
+    /** One-line description displayed in `factory templates list` */
+    description: string;
+    /** DOT graph source string written to `pipeline.dot` on `factory templates init` */
+    dotContent: string;
+}
+/**
+ * Map of all built-in pipeline templates, keyed by template name.
+ * Insertion order determines display order in `factory templates list`.
+ */
+export declare const PIPELINE_TEMPLATES: Map<string, PipelineTemplate>;
+/**
+ * Returns all available pipeline template entries in insertion order.
+ */
+export declare function listPipelineTemplates(): PipelineTemplate[];
+/**
+ * Returns the pipeline template entry for the given name (case-sensitive),
+ * or `undefined` if not found.
+ */
+export declare function getPipelineTemplate(name: string): PipelineTemplate | undefined;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAA;CACnB;AA+HD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAK3D,CAAA;AAMF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAE1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE9E"}

package/dist/templates/index.js

@@ -0,0 +1,153 @@
+/**
+ * Pipeline Template Catalog — pre-built DOT graph pipeline templates for common patterns.
+ *
+ * Story 50-10.
+ *
+ * Node type strings used:
+ *   - `start`          — start node (registered by default registry)
+ *   - `exit`           — exit node (registered by default registry)
+ *   - `codergen`       — coding agent node (registered by default registry)
+ *   - `parallel`       — parallel fan-out node (story 50-1, shape=component)
+ *   - `parallel.fan_in`— fan-in/merge node (story 50-2, shape=tripleoctagon)
+ */
+// ---------------------------------------------------------------------------
+// Built-in template DOT content
+// ---------------------------------------------------------------------------
+const trycycleDotContent = `digraph trycycle {
+  // Trycycle Pattern: iterative refinement with eval gates
+  // Flow: define → plan → eval_plan ⇄ implement → eval_impl → exit
+  // eval nodes can loop back to their upstream node on revision_needed.
+
+  start      [type="start"];
+  define     [type="codergen", label="Define Requirements"];
+  plan       [type="codergen", label="Plan Implementation"];
+  eval_plan  [type="codergen", label="Evaluate Plan"];
+  implement  [type="codergen", label="Implement"];
+  eval_impl  [type="codergen", label="Evaluate Implementation"];
+  exit       [type="exit"];
+
+  start     -> define;
+  define    -> plan;
+  plan      -> eval_plan;
+  eval_plan -> implement     [label="approved"];
+  eval_plan -> plan          [label="revision_needed"];
+  implement -> eval_impl;
+  eval_impl -> exit          [label="approved"];
+  eval_impl -> implement     [label="revision_needed"];
+}
+`;
+const dualReviewDotContent = `digraph dual_review {
+  // Dual-Review Pattern: fan-out to two independent reviewers, then fan-in
+  // Flow: implement → (reviewer_a + reviewer_b) in parallel → merge → exit
+
+  start           [type="start"];
+  implement       [type="codergen",       label="Implement"];
+  review_parallel [type="parallel",       label="Fan-Out to Reviewers"];
+  reviewer_a      [type="codergen",       label="Reviewer A"];
+  reviewer_b      [type="codergen",       label="Reviewer B"];
+  review_merge    [type="parallel.fan_in",label="Merge Reviews"];
+  exit            [type="exit"];
+
+  start           -> implement;
+  implement       -> review_parallel;
+  review_parallel -> reviewer_a;
+  review_parallel -> reviewer_b;
+  reviewer_a      -> review_merge;
+  reviewer_b      -> review_merge;
+  review_merge    -> exit;
+}
+`;
+const parallelExplorationDotContent = `digraph parallel_exploration {
+  // Parallel-Exploration Pattern: dispatch multiple approaches concurrently,
+  // select the best-scoring result, then refine the winner.
+  // Flow: (approach_a + approach_b) in parallel → select best → refine → exit
+
+  start           [type="start"];
+  explore_parallel[type="parallel",        label="Fan-Out Exploration"];
+  approach_a      [type="codergen",        label="Approach A"];
+  approach_b      [type="codergen",        label="Approach B"];
+  select_best     [type="parallel.fan_in", label="Select Best Candidate", selection="best"];
+  refine          [type="codergen",        label="Refine Winner"];
+  exit            [type="exit"];
+
+  start            -> explore_parallel;
+  explore_parallel -> approach_a;
+  explore_parallel -> approach_b;
+  approach_a       -> select_best;
+  approach_b       -> select_best;
+  select_best      -> refine;
+  refine           -> exit;
+}
+`;
+const stagedValidationDotContent = `digraph staged_validation {
+  // Staged-Validation Pattern: sequential quality gates
+  // Flow: implement → lint → test → validate → exit
+  // Each stage is a separate codergen node; no parallel branches.
+
+  start    [type="start"];
+  implement[type="codergen", label="Implement"];
+  lint     [type="codergen", label="Lint"];
+  test     [type="codergen", label="Test"];
+  validate [type="codergen", label="Validate"];
+  exit     [type="exit"];
+
+  start     -> implement;
+  implement -> lint;
+  lint      -> test;
+  test      -> validate;
+  validate  -> exit;
+}
+`;
+// ---------------------------------------------------------------------------
+// Template objects
+// ---------------------------------------------------------------------------
+const trycycleTemplate = {
+    name: 'trycycle',
+    description: 'Iterative refinement loop with plan and implementation eval gates',
+    dotContent: trycycleDotContent,
+};
+const dualReviewTemplate = {
+    name: 'dual-review',
+    description: 'Fan-out to two independent reviewers, then fan-in to merge results',
+    dotContent: dualReviewDotContent,
+};
+const parallelExplorationTemplate = {
+    name: 'parallel-exploration',
+    description: 'Dispatch parallel implementation approaches and select the best candidate',
+    dotContent: parallelExplorationDotContent,
+};
+const stagedValidationTemplate = {
+    name: 'staged-validation',
+    description: 'Sequential quality gate stages: implement → lint → test → validate',
+    dotContent: stagedValidationDotContent,
+};
+// ---------------------------------------------------------------------------
+// Template catalog
+// ---------------------------------------------------------------------------
+/**
+ * Map of all built-in pipeline templates, keyed by template name.
+ * Insertion order determines display order in `factory templates list`.
+ */
+export const PIPELINE_TEMPLATES = new Map([
+    [trycycleTemplate.name, trycycleTemplate],
+    [dualReviewTemplate.name, dualReviewTemplate],
+    [parallelExplorationTemplate.name, parallelExplorationTemplate],
+    [stagedValidationTemplate.name, stagedValidationTemplate],
+]);
+// ---------------------------------------------------------------------------
+// Exported functions
+// ---------------------------------------------------------------------------
+/**
+ * Returns all available pipeline template entries in insertion order.
+ */
+export function listPipelineTemplates() {
+    return Array.from(PIPELINE_TEMPLATES.values());
+}
+/**
+ * Returns the pipeline template entry for the given name (case-sensitive),
+ * or `undefined` if not found.
+ */
+export function getPipelineTemplate(name) {
+    return PIPELINE_TEMPLATES.get(name);
+}
+//# sourceMappingURL=index.js.map