flowscript-core 1.0.0

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAa7C"}

package/dist/hash.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * FlowScript Content Hashing
+ *
+ * Generates deterministic SHA-256 content hashes for nodes, relationships, and states.
+ * Enables automatic deduplication: same semantic content = same ID.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashContent = hashContent;
+const crypto = __importStar(require("crypto"));
+/**
+ * Generate a SHA-256 content hash for any data object.
+ *
+ * The hash is deterministic - same input always produces same hash.
+ * This enables automatic deduplication in the IR graph.
+ *
+ * @param data - Any object to hash
+ * @returns 64-character lowercase hex string (SHA-256 hash)
+ *
+ * @example
+ * hashContent({ type: 'statement', content: 'Test' })
+ * // => 'a7f2c8d1b4e9f6a3c5d8e2b7f1a4c9d6e3b8a2f7c1d5e9b4a8f2c6d1e5a9b3f7'
+ */
+function hashContent(data) {
+    // Normalize: recursively sort object keys for deterministic JSON
+    // Note: the previous implementation used an array replacer which
+    // only whitelists top-level keys — nested object fields were silently
+    // dropped. This recursive sort handles all nesting depths correctly.
+    const normalized = JSON.stringify(sortKeys(data));
+    // Generate SHA-256 hash
+    const hash = crypto.createHash('sha256');
+    hash.update(normalized);
+    // Return lowercase hex (64 chars)
+    return hash.digest('hex');
+}
+/** Recursively sort object keys for deterministic serialization */
+function sortKeys(obj) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(sortKeys);
+    if (typeof obj !== 'object')
+        return obj;
+    return Object.keys(obj).sort().reduce((acc, key) => {
+        acc[key] = sortKeys(obj[key]);
+        return acc;
+    }, {});
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBH,kCAaC;AA5BD,+CAAiC;AAEjC;;;;;;;;;;;;GAYG;AACH,SAAgB,WAAW,CAAC,IAAS;IACnC,iEAAiE;IACjE,iEAAiE;IACjE,sEAAsE;IACtE,qEAAqE;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAElD,wBAAwB;IACxB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAExB,kCAAkC;IAClC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,mEAAmE;AACnE,SAAS,QAAQ,CAAC,GAAQ;IACxB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,GAAwB,EAAE,GAAG,EAAE,EAAE;QACtE,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/dist/indentation-scanner.d.ts

@@ -0,0 +1,81 @@
+/**
+ * IndentationScanner - Python-style indentation preprocessor for FlowScript
+ *
+ * Transforms indentation-based syntax into explicit block syntax by inserting
+ * implicit { } around indented sections. Uses stack-based INDENT/DEDENT algorithm
+ * proven in Python, Haskell, and F# implementations.
+ *
+ * Example transformation:
+ *   INPUT:          TRANSFORMED:
+ *   A               A
+ *     B               {B
+ *     C               C
+ *                     }
+ *
+ * Specification: See /spec/indentation.md
+ * Session: 4a-continued-2 (Preprocessor Core Implementation)
+ */
+export interface IndentationScannerOptions {
+    /** Number of spaces per indentation level (default: 2) */
+    indentSize?: number;
+}
+/**
+ * Result of indentation preprocessing
+ */
+export interface IndentationScannerResult {
+    /** Transformed source with explicit { } blocks */
+    transformed: string;
+    /** Maps transformed line number → original line number */
+    lineMap: Map<number, number>;
+}
+/**
+ * IndentationScanner preprocessor
+ *
+ * Transforms indentation-based FlowScript syntax into explicit block syntax
+ * by inserting { } around indented sections. This allows the existing parser
+ * to handle indented code without grammar changes.
+ */
+export declare class IndentationScanner {
+    private indentStack;
+    private readonly indentSize;
+    private explicitBlockDepth;
+    private blockBaseIndent;
+    private savedIndentStack;
+    /**
+     * Create a new IndentationScanner
+     * @param options - Configuration options
+     */
+    constructor(options?: IndentationScannerOptions);
+    /**
+     * Process FlowScript input and transform indentation to explicit blocks
+     *
+     * @param input - FlowScript source code with indentation
+     * @returns Transformed source with explicit { } blocks and line mapping
+     */
+    process(input: string): IndentationScannerResult;
+    /**
+     * Process a single line of input
+     *
+     * @param line - Line of FlowScript source
+     * @param lineNum - Line number (1-indexed) in original source
+     * @returns Array of output lines with original line numbers (may include inserted { or })
+     */
+    private processLine;
+    /**
+     * Finalize processing by closing all remaining indentation levels
+     *
+     * Called at end of file to emit closing braces for any open indentation.
+     * @param lastOriginalLine - The last non-blank original line number (for provenance)
+     * @returns Array of closing braces with original line mapping
+     */
+    private finalize;
+    /**
+     * Count leading spaces in a line
+     *
+     * Stops at first non-space character or tab.
+     * @param line - Line to count spaces in
+     * @returns Number of leading spaces
+     */
+    private countLeadingSpaces;
+}
+//# sourceMappingURL=indentation-scanner.d.ts.map

package/dist/indentation-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indentation-scanner.d.ts","sourceRoot":"","sources":["../src/indentation-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,gBAAgB,CAAkB;IAE1C;;;OAGG;gBACS,OAAO,GAAE,yBAA8B;IAInD;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB;IAsDhD;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IA2LnB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAehB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CAW3B"}

package/dist/indentation-scanner.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * IndentationScanner - Python-style indentation preprocessor for FlowScript
+ *
+ * Transforms indentation-based syntax into explicit block syntax by inserting
+ * implicit { } around indented sections. Uses stack-based INDENT/DEDENT algorithm
+ * proven in Python, Haskell, and F# implementations.
+ *
+ * Example transformation:
+ *   INPUT:          TRANSFORMED:
+ *   A               A
+ *     B               {B
+ *     C               C
+ *                     }
+ *
+ * Specification: See /spec/indentation.md
+ * Session: 4a-continued-2 (Preprocessor Core Implementation)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndentationScanner = void 0;
+const indentation_error_1 = require("./errors/indentation-error");
+/**
+ * IndentationScanner preprocessor
+ *
+ * Transforms indentation-based FlowScript syntax into explicit block syntax
+ * by inserting { } around indented sections. This allows the existing parser
+ * to handle indented code without grammar changes.
+ */
+class IndentationScanner {
+    /**
+     * Create a new IndentationScanner
+     * @param options - Configuration options
+     */
+    constructor(options = {}) {
+        this.indentStack = [0]; // Stack of active indentation levels
+        this.explicitBlockDepth = 0; // Track nesting depth of explicit {} blocks
+        this.blockBaseIndent = null; // Base indentation when inside explicit block
+        this.savedIndentStack = []; // Stack of indent stacks for nested explicit blocks
+        this.indentSize = options.indentSize ?? 2;
+    }
+    /**
+     * Process FlowScript input and transform indentation to explicit blocks
+     *
+     * @param input - FlowScript source code with indentation
+     * @returns Transformed source with explicit { } blocks and line mapping
+     */
+    process(input) {
+        // Handle empty input specially
+        if (input === '') {
+            return {
+                transformed: '',
+                lineMap: new Map()
+            };
+        }
+        const lines = input.split('\n');
+        const transformedLines = [];
+        const lineMap = new Map();
+        // Reset state for new processing
+        this.indentStack = [0];
+        this.explicitBlockDepth = 0;
+        this.blockBaseIndent = null;
+        this.savedIndentStack = [];
+        // Track the last non-blank original line for EOF closing
+        let lastOriginalLine = lines.length;
+        // Process each line
+        for (let i = 0; i < lines.length; i++) {
+            const originalLineNum = i + 1; // 1-indexed for user-facing errors
+            const processedLines = this.processLine(lines[i], originalLineNum);
+            // Track last non-blank line
+            if (lines[i].trim() !== '') {
+                lastOriginalLine = originalLineNum;
+            }
+            // Add each processed line with its original line mapping
+            for (const { line, originalLine } of processedLines) {
+                const outputLineNum = transformedLines.length + 1;
+                lineMap.set(outputLineNum, originalLine);
+                transformedLines.push(line);
+            }
+        }
+        // Close all remaining indentation levels at EOF
+        const finalLines = this.finalize(lastOriginalLine);
+        for (const { line, originalLine } of finalLines) {
+            const outputLineNum = transformedLines.length + 1;
+            lineMap.set(outputLineNum, originalLine);
+            transformedLines.push(line);
+        }
+        return {
+            transformed: transformedLines.join('\n'),
+            lineMap
+        };
+    }
+    /**
+     * Process a single line of input
+     *
+     * @param line - Line of FlowScript source
+     * @param lineNum - Line number (1-indexed) in original source
+     * @returns Array of output lines with original line numbers (may include inserted { or })
+     */
+    processLine(line, lineNum) {
+        // 1. Skip blank lines (whitespace-only or empty)
+        if (line.trim() === '') {
+            return [{ line, originalLine: lineNum }];
+        }
+        // 2. Track explicit block depth
+        const openBraces = (line.match(/\{/g) || []).length;
+        const closeBraces = (line.match(/\}/g) || []).length;
+        // Update depth and track transitions
+        const depthBeforeLine = this.explicitBlockDepth;
+        this.explicitBlockDepth += openBraces - closeBraces;
+        // 3. Handle lines with braces
+        if (openBraces > 0 || closeBraces > 0) {
+            const output = [];
+            // FIRST: Check if this line's indentation needs implicit blocks
+            // (before handling the explicit braces)
+            if (depthBeforeLine === 0) {
+                // We're not inside an explicit block, check for indentation change
+                const indent = this.countLeadingSpaces(line);
+                const prevIndent = this.indentStack[this.indentStack.length - 1];
+                if (indent > prevIndent) {
+                    // INDENT: Indentation increased - add implicit opening brace
+                    this.indentStack.push(indent);
+                    // PREFIX '{' to the current line (same line, not separate!)
+                    const currentIndent = this.countLeadingSpaces(line);
+                    const content = line.trimStart();
+                    output.push({ line: ' '.repeat(currentIndent) + '{' + content, originalLine: lineNum });
+                    // Now handle the explicit brace on this line
+                    if (openBraces > closeBraces) {
+                        // Save stack and reset for explicit block
+                        this.savedIndentStack.push([...this.indentStack]);
+                        this.indentStack = [0];
+                        this.blockBaseIndent = null;
+                    }
+                    return output;
+                }
+                else if (indent < prevIndent) {
+                    // DEDENT: Close implicit blocks before processing this line
+                    while (this.indentStack.length > 1 &&
+                        this.indentStack[this.indentStack.length - 1] > indent) {
+                        const closingIndent = this.indentStack[this.indentStack.length - 1];
+                        this.indentStack.pop();
+                        // Closing braces credit to the line that caused the dedent
+                        output.push({ line: ' '.repeat(closingIndent) + '}', originalLine: lineNum });
+                    }
+                    // Verify dedent to valid level
+                    if (this.indentStack[this.indentStack.length - 1] !== indent) {
+                        const validLevels = this.indentStack.join(', ');
+                        throw new indentation_error_1.IndentationError(`Invalid dedent to level ${indent}. Expected one of: [${validLevels}].`, lineNum);
+                    }
+                    // The line itself
+                    output.push({ line, originalLine: lineNum });
+                    // Now handle the explicit brace on this line
+                    if (openBraces > closeBraces) {
+                        // Save stack and reset for explicit block
+                        this.savedIndentStack.push([...this.indentStack]);
+                        this.indentStack = [0];
+                        this.blockBaseIndent = null;
+                    }
+                    return output;
+                }
+            }
+            // SECOND: Handle explicit block exits (close implicit blocks first)
+            if (closeBraces > openBraces && this.blockBaseIndent !== null) {
+                // Close all implicit blocks opened within this explicit block
+                while (this.indentStack.length > 1 &&
+                    this.indentStack[this.indentStack.length - 1] > this.blockBaseIndent) {
+                    const closingIndent = this.indentStack[this.indentStack.length - 1];
+                    this.indentStack.pop();
+                    // Credit to current line (the explicit close brace line)
+                    output.push({ line: ' '.repeat(closingIndent) + '}', originalLine: lineNum });
+                }
+                // Restore indent stack from before entering the explicit block
+                if (this.savedIndentStack.length > 0) {
+                    this.indentStack = this.savedIndentStack.pop();
+                }
+                else {
+                    this.indentStack = [0];
+                }
+                this.blockBaseIndent = null;
+            }
+            // THIRD: Handle explicit block entries
+            if (openBraces > closeBraces) {
+                // Save current indent stack before entering explicit block
+                this.savedIndentStack.push([...this.indentStack]);
+                this.indentStack = [0];
+                this.blockBaseIndent = null; // Will be set by next non-brace line
+            }
+            // Finally: The line with braces itself passes through
+            output.push({ line, originalLine: lineNum });
+            return output;
+        }
+        // 4. Inside explicit block: establish base indentation on first content line
+        if (this.explicitBlockDepth > 0 && this.blockBaseIndent === null) {
+            const indent = this.countLeadingSpaces(line);
+            this.blockBaseIndent = indent;
+            this.indentStack = [indent]; // Base level for this block
+            return [{ line, originalLine: lineNum }]; // First line in block passes through unchanged
+        }
+        // 5. Detect tabs (ERROR - not silent conversion)
+        if (line.includes('\t')) {
+            throw new indentation_error_1.IndentationError(`Tabs not allowed. Use ${this.indentSize} spaces for indentation.`, lineNum);
+        }
+        // 6. Calculate current indentation level
+        const indent = this.countLeadingSpaces(line);
+        // 7. First line must be at column 0
+        if (lineNum === 1 && indent > 0) {
+            throw new indentation_error_1.IndentationError('First line cannot be indented.', 1);
+        }
+        // Note: We don't enforce "multiple of indentSize" because Python-style indentation
+        // allows any indentation amount, as long as dedents return to valid levels.
+        // The spec examples (e.g., "Simple indentation") use 5 spaces which is not
+        // a multiple of 2, confirming this flexible approach.
+        const prevIndent = this.indentStack[this.indentStack.length - 1];
+        const output = [];
+        // 8. Compare current indent to previous level
+        if (indent > prevIndent) {
+            // INDENT: New nested level
+            // Push new level onto stack and prefix '{' to current line
+            this.indentStack.push(indent);
+            // PREFIX '{' to the current line (same line, not separate!)
+            // Spec Example 2: "  {B" not "  {\n  B"
+            const currentIndent = this.countLeadingSpaces(line);
+            const content = line.trimStart();
+            output.push({ line: ' '.repeat(currentIndent) + '{' + content, originalLine: lineNum });
+        }
+        else if (indent < prevIndent) {
+            // DEDENT: Closing one or more levels
+            // Pop stack until we reach the target level, emitting closing braces
+            while (this.indentStack.length > 1 &&
+                this.indentStack[this.indentStack.length - 1] > indent) {
+                const closingIndent = this.indentStack[this.indentStack.length - 1];
+                this.indentStack.pop();
+                // Emit '}' at the indentation level being closed
+                // Credit to the line that caused the dedent
+                output.push({ line: ' '.repeat(closingIndent) + '}', originalLine: lineNum });
+            }
+            // Verify we dedented to a valid level (must exist in stack history)
+            if (this.indentStack[this.indentStack.length - 1] !== indent) {
+                const validLevels = this.indentStack.join(', ');
+                throw new indentation_error_1.IndentationError(`Invalid dedent to level ${indent}. Expected one of: [${validLevels}].`, lineNum);
+            }
+            // The current line itself
+            output.push({ line, originalLine: lineNum });
+        }
+        else {
+            // EQUAL: Same indentation level, no change needed
+            output.push({ line, originalLine: lineNum });
+        }
+        return output;
+    }
+    /**
+     * Finalize processing by closing all remaining indentation levels
+     *
+     * Called at end of file to emit closing braces for any open indentation.
+     * @param lastOriginalLine - The last non-blank original line number (for provenance)
+     * @returns Array of closing braces with original line mapping
+     */
+    finalize(lastOriginalLine) {
+        const output = [];
+        // Close all levels except the base level (0)
+        while (this.indentStack.length > 1) {
+            const closingIndent = this.indentStack[this.indentStack.length - 1];
+            this.indentStack.pop();
+            // Emit '}' at the indentation level being closed
+            // Credit to the last non-blank line (EOF closing)
+            output.push({ line: ' '.repeat(closingIndent) + '}', originalLine: lastOriginalLine });
+        }
+        return output;
+    }
+    /**
+     * Count leading spaces in a line
+     *
+     * Stops at first non-space character or tab.
+     * @param line - Line to count spaces in
+     * @returns Number of leading spaces
+     */
+    countLeadingSpaces(line) {
+        let count = 0;
+        for (const char of line) {
+            if (char === ' ') {
+                count++;
+            }
+            else {
+                break; // Stop at first non-space (tab check happens separately)
+            }
+        }
+        return count;
+    }
+}
+exports.IndentationScanner = IndentationScanner;
+//# sourceMappingURL=indentation-scanner.js.map

package/dist/indentation-scanner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * FlowScript Toolchain - Main Library Exports
+ *
+ * Exports all public APIs for programmatic use.
+ * For CLI usage, see bin/flowscript
+ */
+export { Parser } from './parser';
+export { Linter, LintResult, LintRule, Severity, BaseLintRule } from './linter';
+export { validateIR, ValidationResult } from './validate';
+export { FlowScriptQueryEngine, WhyOptions, WhatIfOptions, TensionOptions, BlockedOptions, AlternativesOptions, CausalAncestry, MinimalWhy, ImpactAnalysis, ImpactSummary, TensionsResult, TensionDetail, BlockedResult, BlockerDetail, AlternativesResult, AlternativesResultComparison, AlternativesResultTree, AlternativesResultSimple, TreeAlternative, AlternativeDetail, TensionInfo } from './query-engine';
+export { serialize, SerializeOptions } from './serializer';
+export { Memory, NodeRef, MemoryOptions, TemporalConfig, TemporalTierConfig, DormancyConfig, TemporalTier, TemporalMeta, GardenReport, PruneReport, SnapshotEntry, SnapshotInfo, GraduationCandidate, GraduationResult, GraduationHandler, MemoryJSON, BudgetedSerializeOptions, ToolSchema, ToolResult, MemoryTool, AsToolsOptions, ExtractFn, FromTranscriptOptions, TranscriptExtraction, AuditEntry } from './memory';
+export { hashContent } from './hash';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGhF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EACL,MAAM,EACN,OAAO,EACP,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,wBAAwB,EACxB,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,EACX,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGrC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * FlowScript Toolchain - Main Library Exports
+ *
+ * Exports all public APIs for programmatic use.
+ * For CLI usage, see bin/flowscript
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashContent = exports.NodeRef = exports.Memory = exports.serialize = exports.FlowScriptQueryEngine = exports.validateIR = exports.BaseLintRule = exports.Linter = exports.Parser = void 0;
+// Parser
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "Parser", { enumerable: true, get: function () { return parser_1.Parser; } });
+// Linter
+var linter_1 = require("./linter");
+Object.defineProperty(exports, "Linter", { enumerable: true, get: function () { return linter_1.Linter; } });
+Object.defineProperty(exports, "BaseLintRule", { enumerable: true, get: function () { return linter_1.BaseLintRule; } });
+// Validator
+var validate_1 = require("./validate");
+Object.defineProperty(exports, "validateIR", { enumerable: true, get: function () { return validate_1.validateIR; } });
+// Query Engine
+var query_engine_1 = require("./query-engine");
+Object.defineProperty(exports, "FlowScriptQueryEngine", { enumerable: true, get: function () { return query_engine_1.FlowScriptQueryEngine; } });
+// Serializer (IR → .fs)
+var serializer_1 = require("./serializer");
+Object.defineProperty(exports, "serialize", { enumerable: true, get: function () { return serializer_1.serialize; } });
+// Memory (programmatic builder + temporal intelligence)
+var memory_1 = require("./memory");
+Object.defineProperty(exports, "Memory", { enumerable: true, get: function () { return memory_1.Memory; } });
+Object.defineProperty(exports, "NodeRef", { enumerable: true, get: function () { return memory_1.NodeRef; } });
+// Hash utilities
+var hash_1 = require("./hash");
+Object.defineProperty(exports, "hashContent", { enumerable: true, get: function () { return hash_1.hashContent; } });
+// Type definitions
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,SAAS;AACT,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAEf,SAAS;AACT,mCAAgF;AAAvE,gGAAA,MAAM,OAAA;AAAkC,sGAAA,YAAY,OAAA;AAE7D,YAAY;AACZ,uCAA0D;AAAjD,sGAAA,UAAU,OAAA;AAEnB,eAAe;AACf,+CAsBwB;AArBtB,qHAAA,qBAAqB,OAAA;AAuBvB,wBAAwB;AACxB,2CAA2D;AAAlD,uGAAA,SAAS,OAAA;AAElB,wDAAwD;AACxD,mCA0BkB;AAzBhB,gGAAA,MAAM,OAAA;AACN,iGAAA,OAAO,OAAA;AA0BT,iBAAiB;AACjB,+BAAqC;AAA5B,mGAAA,WAAW,OAAA;AAEpB,mBAAmB;AACnB,0CAAwB"}

package/dist/linter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * FlowScript Semantic Linter
+ *
+ * Enforces semantic correctness beyond syntax validation.
+ * Implements 6 ERROR + 3 WARNING rules from spec/linter-rules.md
+ *
+ * Architecture: Two-pass validation
+ * - Pass 1: Syntax validation (handled by parser)
+ * - Pass 2: Semantic validation (this linter)
+ */
+import { IR } from './types';
+export type Severity = 'ERROR' | 'WARNING';
+export interface LintResult {
+    severity: Severity;
+    rule: string;
+    message: string;
+    location?: {
+        file: string;
+        line: number;
+    };
+    suggestion?: string;
+}
+export interface LintRule {
+    name: string;
+    code: string;
+    severity: Severity;
+    check(ir: IR): LintResult[];
+}
+/**
+ * Base class for lint rules - provides helper methods
+ */
+export declare abstract class BaseLintRule implements LintRule {
+    abstract name: string;
+    abstract code: string;
+    abstract severity: Severity;
+    abstract check(ir: IR): LintResult[];
+    protected createResult(message: string, location?: {
+        file: string;
+        line: number;
+    }, suggestion?: string): LintResult;
+}
+/**
+ * Main linter class - orchestrates all validation rules
+ */
+export declare class Linter {
+    private rules;
+    constructor();
+    private registerRules;
+    /**
+     * Register a single rule (for testing or custom rules)
+     */
+    addRule(rule: LintRule): void;
+    /**
+     * Main linting entry point
+     */
+    lint(ir: IR): LintResult[];
+    /**
+     * Filter results by severity
+     */
+    getErrors(results: LintResult[]): LintResult[];
+    getWarnings(results: LintResult[]): LintResult[];
+    /**
+     * Check if linting passed (no errors)
+     */
+    hasErrors(results: LintResult[]): boolean;
+    /**
+     * Format results for display
+     */
+    formatResults(results: LintResult[]): string;
+}
+//# sourceMappingURL=linter.d.ts.map

package/dist/linter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,8BAAsB,YAAa,YAAW,QAAQ;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,UAAU,EAAE;IAEpC,SAAS,CAAC,YAAY,CACpB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EACzC,UAAU,CAAC,EAAE,MAAM,GAClB,UAAU;CASd;AAED;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAkB;;IAM/B,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI7B;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,UAAU,EAAE;IA0B1B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE;IAI9C,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE;IAIhD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO;IAIzC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;CAwB7C"}