@substrate-ai/factory 0.19.54

package/dist/scenarios/store.js

@@ -0,0 +1,92 @@
+/**
+ * ScenarioStore — discovers scenario files and verifies their integrity via SHA-256 checksums.
+ */
+import { createHash } from 'crypto';
+import { readFile, stat } from 'fs/promises';
+import { basename, join } from 'path';
+import { glob } from 'glob';
+/** Glob pattern matching valid scenario files */
+const SCENARIO_GLOB = 'scenario-*.{sh,py,js,ts}';
+/**
+ * Computes the SHA-256 hex digest of a Buffer.
+ */
+function sha256(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * ScenarioStore — discovers scenario files in `.substrate/scenarios/` and verifies integrity.
+ */
+export class ScenarioStore {
+    /**
+     * Discovers scenario files in `<projectRoot>/.substrate/scenarios/`.
+     * Returns an empty manifest if the directory does not exist or contains no matching files.
+     *
+     * @param projectRoot Defaults to `process.cwd()` when omitted.
+     */
+    async discover(projectRoot) {
+        const root = projectRoot ?? process.cwd();
+        const scenariosDir = join(root, '.substrate', 'scenarios');
+        // Check if directory exists — return empty manifest if not
+        try {
+            const dirStat = await stat(scenariosDir);
+            if (!dirStat.isDirectory()) {
+                return { scenarios: [], capturedAt: Date.now() };
+            }
+        }
+        catch {
+            return { scenarios: [], capturedAt: Date.now() };
+        }
+        // Discover matching files
+        const absolutePaths = await glob(SCENARIO_GLOB, {
+            cwd: scenariosDir,
+            absolute: true,
+        });
+        // Sort alphabetically by filename (basename)
+        absolutePaths.sort((a, b) => {
+            return basename(a).localeCompare(basename(b));
+        });
+        // Compute SHA-256 checksum per file
+        const scenarios = await Promise.all(absolutePaths.map(async (filePath) => {
+            const name = basename(filePath);
+            const content = await readFile(filePath);
+            const checksum = sha256(content);
+            return { name, path: filePath, checksum };
+        }));
+        return { scenarios, capturedAt: Date.now() };
+    }
+    /**
+     * Pipeline-facing integrity check. Delegates to `verify()`.
+     * Call this before dispatching a scenario validation node to confirm no files were tampered
+     * with since manifest capture.
+     *
+     * @param manifest Previously captured manifest from `discover()`.
+     */
+    async verifyIntegrity(manifest) {
+        return this.verify(manifest);
+    }
+    /**
+     * Verifies the integrity of scenario files against a previously captured manifest.
+     * Files that are missing or have changed checksums are listed in `tampered`.
+     *
+     * @param manifest Previously captured manifest from `discover()`.
+     * @param _projectRoot Accepted for API consistency but unused — `ScenarioEntry.path` is already absolute.
+     */
+    async verify(manifest, _projectRoot) {
+        const tampered = [];
+        await Promise.all(manifest.scenarios.map(async (entry) => {
+            try {
+                const content = await readFile(entry.path);
+                const currentChecksum = sha256(content);
+                if (currentChecksum !== entry.checksum) {
+                    tampered.push(entry.name);
+                }
+            }
+            catch {
+                // File no longer exists or cannot be read — treat as tampered
+                tampered.push(entry.name);
+            }
+        }));
+        return { valid: tampered.length === 0, tampered };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/scenarios/store.js.map

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

package/dist/scenarios/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Types for the ScenarioStore — scenario file discovery and integrity verification.
+ */
+/**
+ * Represents a single discovered scenario file with its checksum.
+ */
+export interface ScenarioEntry {
+    /** Filename without directory (e.g., 'scenario-login.sh') */
+    name: string;
+    /** Absolute path to the scenario file on disk */
+    path: string;
+    /** Hex-encoded SHA-256 digest of the file's content at discovery time */
+    checksum: string;
+}
+/**
+ * Manifest produced by `ScenarioStore.discover()`.
+ * Contains the list of discovered scenario files and the time of discovery.
+ */
+export interface ScenarioManifest {
+    /** Discovered scenario entries, sorted alphabetically by name */
+    scenarios: ScenarioEntry[];
+    /** Unix timestamp in milliseconds (Date.now()) when the manifest was captured */
+    capturedAt: number;
+    /**
+     * Names of digital twins required for scenario execution.
+     * Populated from the .substrate/twins/ registry.
+     * Omit or leave empty when no twins are needed.
+     */
+    twins?: string[];
+}
+/**
+ * Result of `ScenarioStore.verify()` — integrity check against a previously captured manifest.
+ */
+export interface ScenarioStoreVerifyResult {
+    /** True if all files match their recorded checksums; false if any are tampered or missing */
+    valid: boolean;
+    /** List of file names (not full paths) whose checksum differs from the manifest or that are missing */
+    tampered: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scenarios/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,6FAA6F;IAC7F,KAAK,EAAE,OAAO,CAAA;IACd,uGAAuG;IACvG,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB"}

package/dist/scenarios/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the ScenarioStore — scenario file discovery and integrity verification.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scenarios/types.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * Unit tests for `parseStylesheet` (parser.ts) and `resolveNodeStyles` (resolver.ts).
+ *
+ * Covers:
+ *  AC1 — universal selector applies to all nodes
+ *  AC2 — shape selector matches by shape
+ *  AC3 — class selector matches nodes with a matching class token
+ *  AC4 — ID selector matches exactly one node by id
+ *  AC5 — higher-specificity rule wins; equal-specificity later rule wins
+ *  AC6 — resolver returns stylesheet values only (caller must prefer explicit attrs)
+ *  AC7 — parseStylesheet throws StylesheetParseError on invalid syntax
+ *  AC8 — stylesheet_syntax validator rule uses real parser
+ *
+ * Story 42-7.
+ */
+export {};
+//# sourceMappingURL=stylesheet.test.d.ts.map

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

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

package/dist/stylesheet/__tests__/stylesheet.test.js

@@ -0,0 +1,368 @@
+/**
+ * Unit tests for `parseStylesheet` (parser.ts) and `resolveNodeStyles` (resolver.ts).
+ *
+ * Covers:
+ *  AC1 — universal selector applies to all nodes
+ *  AC2 — shape selector matches by shape
+ *  AC3 — class selector matches nodes with a matching class token
+ *  AC4 — ID selector matches exactly one node by id
+ *  AC5 — higher-specificity rule wins; equal-specificity later rule wins
+ *  AC6 — resolver returns stylesheet values only (caller must prefer explicit attrs)
+ *  AC7 — parseStylesheet throws StylesheetParseError on invalid syntax
+ *  AC8 — stylesheet_syntax validator rule uses real parser
+ *
+ * Story 42-7.
+ */
+import { describe, it, expect } from 'vitest';
+import { parseStylesheet, StylesheetParseError } from '../parser.js';
+import { resolveNodeStyles } from '../resolver.js';
+import { createValidator } from '../../graph/validator.js';
+// ---------------------------------------------------------------------------
+// Test helpers
+// ---------------------------------------------------------------------------
+/** Build a minimal GraphNode with defaults for all required fields. */
+function makeNode(overrides) {
+    return {
+        id: 'test_node',
+        label: 'Test Node',
+        shape: 'box',
+        type: '',
+        prompt: '',
+        maxRetries: 0,
+        goalGate: false,
+        retryTarget: '',
+        fallbackRetryTarget: '',
+        fidelity: '',
+        threadId: '',
+        class: '',
+        timeout: 0,
+        llmModel: '',
+        llmProvider: '',
+        reasoningEffort: '',
+        autoStatus: false,
+        allowPartial: false,
+        toolCommand: '',
+        backend: '',
+        ...overrides,
+    };
+}
+/** Build a minimal Graph for the stylesheet_syntax validator tests. */
+function makeGraph(modelStylesheet) {
+    const nodeMap = new Map();
+    nodeMap.set('start', makeNode({ id: 'start', shape: 'Mdiamond' }));
+    nodeMap.set('exit', makeNode({ id: 'exit', shape: 'Msquare' }));
+    const edges = [
+        {
+            fromNode: 'start',
+            toNode: 'exit',
+            label: '',
+            condition: '',
+            weight: 1,
+            fidelity: '',
+            threadId: '',
+            loopRestart: false,
+        },
+    ];
+    return {
+        id: 'test',
+        goal: '',
+        label: '',
+        modelStylesheet,
+        defaultMaxRetries: 0,
+        retryTarget: '',
+        fallbackRetryTarget: '',
+        defaultFidelity: '',
+        nodes: nodeMap,
+        edges,
+        outgoingEdges(nodeId) {
+            return edges.filter((e) => e.fromNode === nodeId);
+        },
+        startNode() {
+            return nodeMap.get('start');
+        },
+        exitNode() {
+            return nodeMap.get('exit');
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// parseStylesheet tests
+// ---------------------------------------------------------------------------
+describe('parseStylesheet', () => {
+    // AC1 — universal selector
+    it('single universal rule with two properties → correct ParsedStylesheet', () => {
+        const result = parseStylesheet('* { llm_model: claude-sonnet-4-5; llm_provider: anthropic; }');
+        expect(result).toHaveLength(1);
+        const rule = result[0];
+        expect(rule.selector.type).toBe('universal');
+        expect(rule.selector.value).toBe('*');
+        expect(rule.selector.specificity).toBe(0);
+        expect(rule.declarations).toHaveLength(2);
+        expect(rule.declarations[0]).toEqual({ property: 'llm_model', value: 'claude-sonnet-4-5' });
+        expect(rule.declarations[1]).toEqual({ property: 'llm_provider', value: 'anthropic' });
+    });
+    // AC2 — shape selector
+    it('shape selector → type: shape, specificity: 1', () => {
+        const result = parseStylesheet('box { llm_model: gpt-4o; }');
+        expect(result).toHaveLength(1);
+        const rule = result[0];
+        expect(rule.selector.type).toBe('shape');
+        expect(rule.selector.value).toBe('box');
+        expect(rule.selector.specificity).toBe(1);
+        expect(rule.declarations[0]).toEqual({ property: 'llm_model', value: 'gpt-4o' });
+    });
+    // AC3 — class selector
+    it('class selector → type: class, specificity: 2', () => {
+        const result = parseStylesheet('.code { llm_model: claude-opus-4; }');
+        expect(result).toHaveLength(1);
+        const rule = result[0];
+        expect(rule.selector.type).toBe('class');
+        expect(rule.selector.value).toBe('code');
+        expect(rule.selector.specificity).toBe(2);
+        expect(rule.declarations[0]).toEqual({ property: 'llm_model', value: 'claude-opus-4' });
+    });
+    // AC4 — ID selector
+    it('ID selector → type: id, specificity: 3', () => {
+        const result = parseStylesheet('#review_node { reasoning_effort: high; }');
+        expect(result).toHaveLength(1);
+        const rule = result[0];
+        expect(rule.selector.type).toBe('id');
+        expect(rule.selector.value).toBe('review_node');
+        expect(rule.selector.specificity).toBe(3);
+        expect(rule.declarations[0]).toEqual({ property: 'reasoning_effort', value: 'high' });
+    });
+    it('multiple rules → all returned in source order', () => {
+        const stylesheet = `
+      * { llm_model: base; }
+      .code { llm_model: class-model; }
+      #target { llm_model: id-model; }
+    `;
+        const result = parseStylesheet(stylesheet);
+        expect(result).toHaveLength(3);
+        expect(result[0].selector.type).toBe('universal');
+        expect(result[1].selector.type).toBe('class');
+        expect(result[2].selector.type).toBe('id');
+    });
+    it('unquoted values parsed correctly', () => {
+        const result = parseStylesheet('box { llm_model: gpt-4o; }');
+        expect(result[0].declarations[0].value).toBe('gpt-4o');
+    });
+    it('double-quoted values parsed correctly (quotes stripped)', () => {
+        const result = parseStylesheet('box { llm_model: "claude-sonnet-4-5"; }');
+        expect(result[0].declarations[0].value).toBe('claude-sonnet-4-5');
+    });
+    it('single-quoted values parsed correctly (quotes stripped)', () => {
+        const result = parseStylesheet("box { llm_model: 'claude-opus-4'; }");
+        expect(result[0].declarations[0].value).toBe('claude-opus-4');
+    });
+    it('multiple declarations in one rule parsed correctly', () => {
+        const result = parseStylesheet('* { llm_model: claude-sonnet-4-5; llm_provider: anthropic; reasoning_effort: high; }');
+        expect(result[0].declarations).toHaveLength(3);
+    });
+    it('trailing semicolon is accepted', () => {
+        const result = parseStylesheet('box { llm_model: gpt-4o; }');
+        expect(result).toHaveLength(1);
+    });
+    // AC7 — error cases
+    it('missing closing brace → StylesheetParseError thrown', () => {
+        expect(() => parseStylesheet('box { llm_model: gpt-4o;')).toThrow(StylesheetParseError);
+    });
+    it('missing closing brace → error message mentions missing brace', () => {
+        expect(() => parseStylesheet('box { llm_model: gpt-4o;')).toThrow(/Missing closing brace/);
+    });
+    it('unknown property (font-size) → StylesheetParseError thrown', () => {
+        expect(() => parseStylesheet('box { font-size: 12px; }')).toThrow(StylesheetParseError);
+    });
+    it('unknown property → error message mentions the property name', () => {
+        expect(() => parseStylesheet('box { font-size: 12px; }')).toThrow(/font-size/);
+    });
+    it('content without opening brace → StylesheetParseError thrown', () => {
+        expect(() => parseStylesheet('box llm_model: gpt-4o;')).toThrow(StylesheetParseError);
+    });
+    it('empty stylesheet → returns empty array (no error)', () => {
+        expect(parseStylesheet('')).toEqual([]);
+    });
+    it('whitespace-only stylesheet → returns empty array (no error)', () => {
+        expect(parseStylesheet('   \n  ')).toEqual([]);
+    });
+    it('block comments stripped before parsing', () => {
+        const result = parseStylesheet('/* global defaults */ * { llm_model: base; }');
+        expect(result).toHaveLength(1);
+        expect(result[0].selector.type).toBe('universal');
+    });
+    it('line comments stripped before parsing', () => {
+        const result = parseStylesheet('// shape rule\nbox { llm_model: gpt-4o; }');
+        expect(result).toHaveLength(1);
+        expect(result[0].selector.type).toBe('shape');
+    });
+});
+// ---------------------------------------------------------------------------
+// resolveNodeStyles tests
+// ---------------------------------------------------------------------------
+describe('resolveNodeStyles', () => {
+    // AC1 — universal rule
+    it('universal rule → all three properties resolved from the rule', () => {
+        const stylesheet = parseStylesheet('* { llm_model: claude-sonnet-4-5; llm_provider: anthropic; reasoning_effort: high; }');
+        const node = makeNode({ id: 'any_node', shape: 'box' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('claude-sonnet-4-5');
+        expect(resolved.llmProvider).toBe('anthropic');
+        expect(resolved.reasoningEffort).toBe('high');
+    });
+    it('universal rule applies to every node regardless of shape', () => {
+        const stylesheet = parseStylesheet('* { llm_model: claude-sonnet-4-5; }');
+        const nodeA = makeNode({ id: 'a', shape: 'box' });
+        const nodeB = makeNode({ id: 'b', shape: 'diamond' });
+        expect(resolveNodeStyles(nodeA, stylesheet).llmModel).toBe('claude-sonnet-4-5');
+        expect(resolveNodeStyles(nodeB, stylesheet).llmModel).toBe('claude-sonnet-4-5');
+    });
+    // AC2 — shape rule
+    it('shape rule: matching node gets property', () => {
+        const stylesheet = parseStylesheet('box { llm_model: gpt-4o; }');
+        const node = makeNode({ id: 'n1', shape: 'box' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('gpt-4o');
+    });
+    it('shape rule: non-matching node gets empty ResolvedNodeStyles', () => {
+        const stylesheet = parseStylesheet('box { llm_model: gpt-4o; }');
+        const node = makeNode({ id: 'n2', shape: 'diamond' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBeUndefined();
+        expect(resolved.llmProvider).toBeUndefined();
+        expect(resolved.reasoningEffort).toBeUndefined();
+    });
+    // AC3 — class rule
+    it('class rule: node with matching class token gets properties', () => {
+        const stylesheet = parseStylesheet('.code { llm_model: claude-opus-4; }');
+        const node = makeNode({ id: 'n1', class: 'code,critical' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('claude-opus-4');
+    });
+    it('class rule: node without the class token gets nothing', () => {
+        const stylesheet = parseStylesheet('.code { llm_model: claude-opus-4; }');
+        const node = makeNode({ id: 'n2', class: 'critical' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBeUndefined();
+    });
+    it('class rule: node with empty class field does not match', () => {
+        const stylesheet = parseStylesheet('.code { llm_model: claude-opus-4; }');
+        const node = makeNode({ id: 'n3', class: '' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBeUndefined();
+    });
+    it('class rule: class="a,b,c" and rule .b → matches (space-trimmed token)', () => {
+        const stylesheet = parseStylesheet('.b { llm_model: matched; }');
+        const node = makeNode({ id: 'n4', class: 'a,b,c' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('matched');
+    });
+    it('class rule: class=" a , b , c " with spaces → trimmed tokens match', () => {
+        const stylesheet = parseStylesheet('.b { llm_model: matched; }');
+        const node = makeNode({ id: 'n5', class: ' a , b , c ' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('matched');
+    });
+    // AC4 — ID rule
+    it('ID rule: node with matching id gets properties', () => {
+        const stylesheet = parseStylesheet('#review_node { reasoning_effort: high; }');
+        const node = makeNode({ id: 'review_node', shape: 'box' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.reasoningEffort).toBe('high');
+    });
+    it('ID rule: all other nodes do not get properties', () => {
+        const stylesheet = parseStylesheet('#review_node { reasoning_effort: high; }');
+        const otherNode = makeNode({ id: 'other_node', shape: 'box' });
+        const resolved = resolveNodeStyles(otherNode, stylesheet);
+        expect(resolved.reasoningEffort).toBeUndefined();
+    });
+    // AC5 — specificity
+    it('ID rule + class rule on same node → ID property value wins (specificity 3 > 2)', () => {
+        const stylesheet = parseStylesheet('.code { llm_model: class-model; }\n#target { llm_model: id-model; }');
+        const node = makeNode({ id: 'target', class: 'code' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('id-model');
+    });
+    it('universal + class + ID → ID wins for all three specificity levels', () => {
+        const stylesheet = parseStylesheet(`
+      * { llm_model: base; }
+      .code { llm_model: class-model; }
+      #target { llm_model: id-model; }
+    `);
+        const node = makeNode({ id: 'target', class: 'code' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('id-model');
+    });
+    it('two universal rules → later rule property value wins for overlapping properties', () => {
+        const stylesheet = parseStylesheet('* { llm_model: first; }\n* { llm_model: second; }');
+        const node = makeNode({ id: 'any' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('second');
+    });
+    it('two equal-specificity shape rules → later rule wins for same property', () => {
+        const stylesheet = parseStylesheet('box { llm_model: first; }\nbox { llm_model: second; }');
+        const node = makeNode({ id: 'n', shape: 'box' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('second');
+    });
+    it('non-overlapping rules accumulate all properties', () => {
+        const stylesheet = parseStylesheet('* { llm_model: base-model; }\n.code { llm_provider: anthropic; }');
+        const node = makeNode({ id: 'n', class: 'code' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved.llmModel).toBe('base-model');
+        expect(resolved.llmProvider).toBe('anthropic');
+    });
+    // AC6 — resolver does not enforce explicit node attribute priority
+    it('resolver returns stylesheet value regardless of node.llmModel being set', () => {
+        const stylesheet = parseStylesheet('* { llm_model: from-stylesheet; }');
+        // Node has its own llmModel — but resolver ignores it
+        const node = makeNode({ id: 'n', llmModel: 'from-node' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        // Resolver simply returns what the stylesheet says
+        expect(resolved.llmModel).toBe('from-stylesheet');
+    });
+    it('empty stylesheet → empty ResolvedNodeStyles returned', () => {
+        const stylesheet = parseStylesheet('');
+        const node = makeNode({ id: 'n' });
+        const resolved = resolveNodeStyles(node, stylesheet);
+        expect(resolved).toEqual({});
+    });
+});
+// ---------------------------------------------------------------------------
+// AC8: stylesheet_syntax validator rule uses real parser
+// ---------------------------------------------------------------------------
+describe('stylesheet_syntax validator rule (uses real parser)', () => {
+    it('explicitly invalid stylesheet → emits ruleId: stylesheet_syntax error diagnostic', () => {
+        const graph = makeGraph('box { font-color: red; }'); // unknown property
+        const validator = createValidator();
+        const diags = validator.validate(graph).filter((d) => d.ruleId === 'stylesheet_syntax');
+        expect(diags).toHaveLength(1);
+        expect(diags[0].severity).toBe('error');
+        expect(diags[0].ruleId).toBe('stylesheet_syntax');
+    });
+    it('valid stylesheet with known properties → no stylesheet_syntax diagnostic', () => {
+        const graph = makeGraph('box { llm_model: claude-sonnet-4-5; }');
+        const validator = createValidator();
+        const diags = validator.validate(graph).filter((d) => d.ruleId === 'stylesheet_syntax');
+        expect(diags).toHaveLength(0);
+    });
+    it('stylesheet with missing closing brace → emits stylesheet_syntax error', () => {
+        const graph = makeGraph('box { llm_model: gpt-4o;'); // no closing brace
+        const validator = createValidator();
+        const diags = validator.validate(graph).filter((d) => d.ruleId === 'stylesheet_syntax');
+        expect(diags).toHaveLength(1);
+        expect(diags[0].severity).toBe('error');
+    });
+    it('stylesheet with class and ID selectors → no stylesheet_syntax diagnostic', () => {
+        const graph = makeGraph('.code { llm_model: claude-opus-4; }\n#review { reasoning_effort: high; }');
+        const validator = createValidator();
+        const diags = validator.validate(graph).filter((d) => d.ruleId === 'stylesheet_syntax');
+        expect(diags).toHaveLength(0);
+    });
+    it('universal selector stylesheet → no stylesheet_syntax diagnostic', () => {
+        const graph = makeGraph('* { llm_model: claude-sonnet-4-5; llm_provider: anthropic; }');
+        const validator = createValidator();
+        const diags = validator.validate(graph).filter((d) => d.ruleId === 'stylesheet_syntax');
+        expect(diags).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=stylesheet.test.js.map

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

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

package/dist/stylesheet/parser.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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.
+ */
+import type { ParsedStylesheet } from '../graph/types.js';
+/**
+ * Thrown by `parseStylesheet` when the stylesheet source does not conform
+ * to the supported grammar.
+ */
+export declare class StylesheetParseError extends Error {
+    constructor(message: string);
+}
+/**
+ * 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 declare function parseStylesheet(source: string): ParsedStylesheet;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/stylesheet/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,mBAAmB,CAAA;AAM1B;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAoID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAyDhE"}