flowscript-core 1.0.0

package/dist/linter.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Linter = exports.BaseLintRule = void 0;
+/**
+ * Base class for lint rules - provides helper methods
+ */
+class BaseLintRule {
+    createResult(message, location, suggestion) {
+        return {
+            severity: this.severity,
+            rule: this.code,
+            message,
+            location,
+            suggestion
+        };
+    }
+}
+exports.BaseLintRule = BaseLintRule;
+/**
+ * Main linter class - orchestrates all validation rules
+ */
+class Linter {
+    constructor() {
+        this.rules = [];
+        this.registerRules();
+    }
+    registerRules() {
+        // Import all rules
+        const { UnlabeledTensionRule, MissingRequiredFieldsRule, InvalidSyntaxRule, OrphanedNodesRule, CausalCyclesRule, AlternativesWithoutDecisionRule, MissingRecommendedFieldsRule, DeepNestingRule, LongCausalChainsRule } = require('./rules');
+        // ERROR rules (6 total)
+        this.rules.push(new UnlabeledTensionRule());
+        this.rules.push(new MissingRequiredFieldsRule());
+        this.rules.push(new InvalidSyntaxRule());
+        this.rules.push(new OrphanedNodesRule());
+        this.rules.push(new CausalCyclesRule());
+        this.rules.push(new AlternativesWithoutDecisionRule());
+        // WARNING rules (3 total)
+        this.rules.push(new MissingRecommendedFieldsRule());
+        this.rules.push(new DeepNestingRule());
+        this.rules.push(new LongCausalChainsRule());
+    }
+    /**
+     * Register a single rule (for testing or custom rules)
+     */
+    addRule(rule) {
+        this.rules.push(rule);
+    }
+    /**
+     * Main linting entry point
+     */
+    lint(ir) {
+        const results = [];
+        for (const rule of this.rules) {
+            try {
+                const ruleResults = rule.check(ir);
+                results.push(...ruleResults);
+            }
+            catch (error) {
+                // Rule execution failed - log but continue with other rules
+                console.error(`Rule ${rule.code} failed:`, error);
+            }
+        }
+        // Sort: ERRORs first, then by line number
+        results.sort((a, b) => {
+            if (a.severity !== b.severity) {
+                return a.severity === 'ERROR' ? -1 : 1;
+            }
+            const aLine = a.location?.line || 0;
+            const bLine = b.location?.line || 0;
+            return aLine - bLine;
+        });
+        return results;
+    }
+    /**
+     * Filter results by severity
+     */
+    getErrors(results) {
+        return results.filter(r => r.severity === 'ERROR');
+    }
+    getWarnings(results) {
+        return results.filter(r => r.severity === 'WARNING');
+    }
+    /**
+     * Check if linting passed (no errors)
+     */
+    hasErrors(results) {
+        return this.getErrors(results).length > 0;
+    }
+    /**
+     * Format results for display
+     */
+    formatResults(results) {
+        if (results.length === 0) {
+            return 'No issues found ✓';
+        }
+        const lines = [];
+        for (const result of results) {
+            const location = result.location
+                ? `${result.location.file}:${result.location.line}`
+                : 'unknown';
+            lines.push(`${result.severity}: ${result.rule} - ${result.message}`);
+            lines.push(`  at ${location}`);
+            if (result.suggestion) {
+                lines.push(`  Suggestion: ${result.suggestion}`);
+            }
+            lines.push(''); // blank line between results
+        }
+        return lines.join('\n');
+    }
+}
+exports.Linter = Linter;
+//# sourceMappingURL=linter.js.map

package/dist/linter.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,506 @@
+/**
+ * FlowScript Memory Class + NodeRef
+ *
+ * Programmatic builder for FlowScript IR graphs with temporal intelligence.
+ * The developer-facing API for "decision intelligence that gets smarter over time."
+ *
+ * Memory = the graph owner. Creates nodes, relationships, states.
+ * NodeRef = fluent reference handle. Enables chaining: mem.thought("X").causes(mem.thought("Y"))
+ *
+ * Design:
+ * - IR is the internal representation (same as parser produces)
+ * - Temporal metadata (tiers, frequency, garden) stored separately from IR
+ * - Content-hash deduplication drives frequency tracking
+ * - Query engine lazy-refreshes when IR changes
+ * - JSON is canonical persistence (.fs is human-readable projection)
+ */
+import { SerializeOptions } from './serializer';
+import { FlowScriptQueryEngine } from './query-engine';
+import type { IR, Node, NodeType, Relationship, RelationType, State, StateType } from './types';
+export interface TemporalTierConfig {
+    maxAge: string | null;
+    graduationThreshold?: number;
+}
+export interface DormancyConfig {
+    resting: string;
+    dormant: string;
+    archive: string;
+}
+export interface TemporalConfig {
+    tiers?: {
+        current?: TemporalTierConfig;
+        developing?: TemporalTierConfig;
+        proven?: TemporalTierConfig;
+        foundation?: TemporalTierConfig;
+    };
+    dormancy?: Partial<DormancyConfig>;
+}
+export interface MemoryOptions {
+    temporal?: TemporalConfig;
+    sourceFile?: string;
+    author?: {
+        agent: string;
+        role: 'human' | 'ai';
+    };
+    autoSnapshot?: boolean;
+}
+export type TemporalTier = 'current' | 'developing' | 'proven' | 'foundation';
+export interface TemporalMeta {
+    createdAt: string;
+    lastTouched: string;
+    frequency: number;
+    tier: TemporalTier;
+}
+export interface GardenReport {
+    growing: NodeRef[];
+    resting: NodeRef[];
+    dormant: NodeRef[];
+    stats: {
+        total: number;
+        growing: number;
+        resting: number;
+        dormant: number;
+    };
+}
+export interface PruneReport {
+    archived: NodeRef[];
+    count: number;
+}
+/** A single entry in the append-only audit log. Captures full objects including provenance. */
+export interface AuditEntry {
+    timestamp: string;
+    event: 'prune';
+    nodes: Node[];
+    relationships: Relationship[];
+    states: State[];
+    temporal: Record<string, TemporalMeta>;
+    reason: string;
+}
+export interface SnapshotEntry {
+    id: string;
+    reason: string;
+    timestamp: string;
+    ir: IR;
+    temporal: Record<string, TemporalMeta>;
+}
+export interface SnapshotInfo {
+    id: string;
+    reason: string;
+    timestamp: string;
+    nodeCount: number;
+}
+export interface GraduationCandidate {
+    node: NodeRef;
+    frequency: number;
+    tier: TemporalTier;
+    relatedNodes: NodeRef[];
+}
+export interface GraduationResult {
+    graduate: boolean;
+    destination?: TemporalTier;
+    compressed?: string;
+    reason?: string;
+}
+/** Graduation event handler. Must return synchronously (async not yet supported). */
+export type GraduationHandler = (candidate: GraduationCandidate) => GraduationResult | void;
+type EventHandler = (...args: any[]) => void;
+export interface MemoryJSON {
+    flowscript_memory: '1.0.0';
+    ir: IR;
+    temporal: Record<string, TemporalMeta>;
+    snapshots: SnapshotEntry[];
+    config: MemoryOptions;
+}
+export interface BudgetedSerializeOptions extends SerializeOptions {
+    /** Maximum token budget. When set, enables intelligent node selection. */
+    maxTokens?: number;
+    /**
+     * Priority strategy for selecting nodes within budget.
+     * - 'tier-priority' (default): foundation → proven → developing → current, frequency tiebreaker
+     * - 'recency': newest lastTouched first
+     * - 'frequency': most-touched first
+     * - 'relevance': word-overlap scoring against relevanceQuery
+     */
+    strategy?: 'tier-priority' | 'recency' | 'frequency' | 'relevance';
+    /** Tiers that are always included regardless of budget. Default: ['proven', 'foundation'] */
+    preserveTiers?: TemporalTier[];
+    /** Exclude dormant nodes from budget consideration. Default: true */
+    excludeDormant?: boolean;
+    /** Query string for 'relevance' strategy (word-overlap matching). */
+    relevanceQuery?: string;
+    /** Custom token estimator. Default: Math.ceil(text.length / 4) */
+    tokenEstimator?: (text: string) => number;
+}
+export interface ToolSchema {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, unknown>;
+            required?: string[];
+        };
+    };
+}
+export type ToolResult = {
+    success: true;
+    data: Record<string, any>;
+} | {
+    success: false;
+    error: string;
+};
+export interface MemoryTool extends ToolSchema {
+    /** Execute this tool with the given arguments. Returns structured JSON result. */
+    handler: (args: Record<string, any>) => ToolResult;
+}
+export interface AsToolsOptions {
+    /** Which tool categories to include. Default: all categories. */
+    include?: Array<'core' | 'query' | 'memory'>;
+    /** Prefix for tool names (e.g., 'memory_' → 'memory_add_node'). Default: '' */
+    prefix?: string;
+}
+/** Function that sends a prompt to any LLM and returns the response text. */
+export type ExtractFn = (prompt: string) => Promise<string>;
+/** Options for Memory.fromTranscript() */
+export interface FromTranscriptOptions {
+    /** Function that sends a prompt to any LLM and returns the text response. Required. */
+    extract: ExtractFn;
+    /** Memory options applied to the created Memory instance. */
+    memoryOptions?: MemoryOptions;
+}
+/** Shape of the JSON the LLM is asked to produce. Exported for testing custom extract functions. */
+export interface TranscriptExtraction {
+    nodes: Array<{
+        id: string;
+        type: 'statement' | 'thought' | 'question' | 'action' | 'insight' | 'completion';
+        content: string;
+        modifiers?: Array<'urgent' | 'positive' | 'confident' | 'uncertain'>;
+    }>;
+    relationships: Array<{
+        source: string;
+        target: string;
+        type: 'causes' | 'temporal' | 'derives_from' | 'bidirectional' | 'tension' | 'equivalent' | 'different';
+        axis?: string;
+    }>;
+    states: Array<{
+        node: string;
+        type: 'decided' | 'exploring' | 'blocked' | 'parking';
+        fields: Record<string, string>;
+    }>;
+}
+/**
+ * Lightweight reference to a node in a Memory graph.
+ * All mutation methods delegate to the owning Memory instance.
+ * Returns NodeRef for fluent chaining.
+ */
+export declare class NodeRef {
+    private readonly memory;
+    private readonly _id;
+    constructor(memory: Memory, _id: string);
+    /** Node ID (content-hash) */
+    get id(): string;
+    /** The underlying Node object */
+    get node(): Node;
+    /** Node type */
+    get type(): NodeType;
+    /** Node content text */
+    get content(): string;
+    /** Create a thought node as a child of this node */
+    thought(content: string): NodeRef;
+    /** Create a statement node as a child of this node */
+    statement(content: string): NodeRef;
+    /** Create an action node as a child of this node */
+    action(content: string): NodeRef;
+    /** Create a question node as a child of this node */
+    question(content: string): NodeRef;
+    /** Create an insight node as a child of this node */
+    insight(content: string): NodeRef;
+    /** This node causes the target. Returns target for chaining. */
+    causes(target: NodeRef | string): NodeRef;
+    /** This node is temporally followed by target. Returns target. */
+    then(target: NodeRef | string): NodeRef;
+    /** This node derives from source. Returns this for chaining. */
+    derivesFrom(source: NodeRef | string): NodeRef;
+    /** Create a tension between this node and target. Returns this. */
+    vs(target: NodeRef | string, axis: string): NodeRef;
+    /** Bidirectional relationship with target. Returns this. */
+    bidirectional(target: NodeRef | string): NodeRef;
+    /** Mark this node as decided. Returns this. */
+    decide(fields: {
+        rationale: string;
+        on?: string;
+    }): NodeRef;
+    /** Mark this node as blocked. Returns this. */
+    block(fields: {
+        reason: string;
+        since?: string;
+    }): NodeRef;
+    /** Mark this node as parked. Returns this. */
+    park(fields: {
+        why: string;
+        until?: string;
+    }): NodeRef;
+    /** Mark this node as exploring. Returns this. */
+    explore(): NodeRef;
+    /** Remove a specific state type from this node. Returns this. */
+    unblock(): NodeRef;
+    /** Remove all states from this node. Returns this. */
+    clearStates(): NodeRef;
+    /** Add ! (urgent) modifier. Returns this. */
+    urgent(): NodeRef;
+    /** Add ++ (strong positive) modifier. Returns this. */
+    positive(): NodeRef;
+    /** Add * (high confidence) modifier. Returns this. */
+    confident(): NodeRef;
+    /** Add ~ (low confidence / uncertain) modifier. Returns this. */
+    uncertain(): NodeRef;
+}
+/**
+ * Programmatic builder for FlowScript IR graphs with temporal intelligence.
+ *
+ * Usage:
+ *   const mem = new Memory();
+ *   const q = mem.question("Which database?");
+ *   const redis = mem.alternative(q, "Redis");
+ *   redis.decide({ rationale: "speed critical" });
+ *   mem.query.blocked();
+ *   mem.save("./memory.json");
+ */
+export declare class Memory {
+    private ir;
+    private nodeMap;
+    private temporalMap;
+    private _snapshots;
+    private _queryEngine;
+    private _dirty;
+    private _lineCounter;
+    private _handlers;
+    private _config;
+    private _defaultDormancy;
+    private _filePath;
+    constructor(options?: MemoryOptions);
+    /** Create Memory from an existing IR. filePath will be null — save() requires an explicit path. */
+    static fromIR(ir: IR, options?: MemoryOptions): Memory;
+    /** Parse .fs text into Memory. filePath will be null — save() requires an explicit path. */
+    static parse(text: string, filename?: string): Memory;
+    /** Load from JSON persistence format (accepts string or pre-parsed object). filePath will be null — save() requires an explicit path. */
+    static fromJSON(json: string | MemoryJSON): Memory;
+    /** Load from file (.fs or .json, detected by extension) */
+    static load(filePath: string): Memory;
+    /**
+     * Load from file if it exists, otherwise create empty Memory.
+     * Stores the path for no-arg save().
+     *
+     * @param filePath - Path to load from or save to. Parent directories are created on save() if needed.
+     * @param options - Applied only when creating a new Memory. Ignored when loading from existing file
+     *   (the persisted config from the file takes precedence).
+     *
+     * Note: `.fs` format is lossy — temporal metadata, snapshots, and config are not preserved.
+     * Use `.json` extension for the full operational loop (loadOrCreate → modify → save → loadOrCreate).
+     */
+    static loadOrCreate(filePath: string, options?: MemoryOptions): Memory;
+    /**
+     * Extract structured reasoning memory from a conversation transcript.
+     *
+     * LLM-agnostic: you provide any function that takes a prompt string and returns the LLM's
+     * response string. FlowScript provides the extraction prompt and parses the result.
+     *
+     * @param transcript - The conversation text to analyze (any format: chat logs, meeting notes, etc.)
+     * @param options - Must include `extract`: an async function `(prompt: string) => Promise<string>`
+     * @returns A Memory populated with the extracted nodes, relationships, and states (flat graph, no parent-child nesting)
+     *
+     * Note: The transcript is embedded in the extraction prompt with XML delimiters for basic injection
+     * mitigation, but this is not a structural guarantee. If processing untrusted user-submitted content,
+     * consider sanitizing the transcript before passing it. Invalid extraction results (bad types,
+     * dangling references) are filtered with a console.warn diagnostic — not thrown.
+     *
+     * @example
+     * ```typescript
+     * const mem = await Memory.fromTranscript(chatLog, {
+     *   extract: async (prompt) => {
+     *     const res = await openai.chat.completions.create({
+     *       model: 'gpt-4o',
+     *       messages: [{ role: 'user', content: prompt }],
+     *       response_format: { type: 'json_object' }
+     *     });
+     *     return res.choices[0].message.content!;
+     *   }
+     * });
+     * ```
+     */
+    static fromTranscript(transcript: string, options: FromTranscriptOptions): Promise<Memory>;
+    /** @internal Build the extraction prompt for the LLM */
+    static _buildExtractionPrompt(transcript: string): string;
+    /** @internal Parse and validate the LLM's extraction response */
+    static _parseExtractionResponse(response: string): TranscriptExtraction;
+    /** @internal Build a Memory instance from validated extraction data */
+    static _buildFromExtraction(extraction: TranscriptExtraction, memoryOptions?: MemoryOptions): Memory;
+    /**
+     * Read the audit log for a memory file. Returns all audit entries (pruned nodes, relationships, states).
+     * The audit log is an append-only .jsonl file created automatically when prune() is called.
+     *
+     * @param auditPath - Path to the .audit.jsonl file. If a .json memory path is passed, derives the audit path.
+     * @returns Array of AuditEntry objects, oldest first
+     */
+    static readAuditLog(auditPath: string): AuditEntry[];
+    /** Create a statement node */
+    statement(content: string): NodeRef;
+    /** Create a thought node */
+    thought(content: string): NodeRef;
+    /** Create a question node */
+    question(content: string): NodeRef;
+    /** Create an action node */
+    action(content: string): NodeRef;
+    /** Create an insight node */
+    insight(content: string): NodeRef;
+    /** Create a completion node */
+    completion(content: string): NodeRef;
+    /** Create a block node (structural container) */
+    block(content: string): NodeRef;
+    /**
+     * Create an alternative node linked to a question.
+     * Automatically creates the alternative relationship and adds as child.
+     */
+    alternative(question: NodeRef | string, content: string): NodeRef;
+    /** Create a tension between two nodes */
+    tension(a: NodeRef | string, b: NodeRef | string, axis: string): void;
+    /** Create a typed relationship between two nodes */
+    relate(source: NodeRef | string, target: NodeRef | string, type: RelationType, options?: {
+        axis?: string;
+        feedback?: boolean;
+    }): void;
+    /** Access the query engine. Lazy-refreshes when IR has changed. */
+    get query(): {
+        why: FlowScriptQueryEngine['why'];
+        whatIf: FlowScriptQueryEngine['whatIf'];
+        tensions: FlowScriptQueryEngine['tensions'];
+        blocked: FlowScriptQueryEngine['blocked'];
+        alternatives: FlowScriptQueryEngine['alternatives'];
+    };
+    /** Get the raw IR graph */
+    toIR(): IR;
+    /**
+     * Serialize to FlowScript .fs text, optionally within a token budget.
+     *
+     * Without maxTokens: serializes the full graph.
+     * With maxTokens: intelligently selects nodes by strategy to fit within budget.
+     * Preserved tiers (default: proven + foundation) are always included.
+     */
+    toFlowScript(options?: BudgetedSerializeOptions): string;
+    /**
+     * Get the lossless JSON representation (object form).
+     * Includes IR + temporal metadata + snapshots + config.
+     * Use toJSONString() for a serialized string.
+     *
+     * Note: This is intentionally NOT named to conflict with JSON.stringify's
+     * automatic toJSON() call. Use toJSONString() for string output.
+     */
+    toMemoryJSON(): MemoryJSON;
+    /** Serialize to JSON string (lossless, includes temporal + snapshots) */
+    toJSONString(): string;
+    /** Save to file (.fs or .json, detected by extension). Creates parent directories if needed.
+     *  Note: not atomic. For multi-agent scenarios (v1.2+), use temp+rename pattern. */
+    save(filePath?: string): void;
+    /**
+     * Auto-generate function calling tool definitions from the Memory API.
+     *
+     * Returns tool schemas (OpenAI function calling format) paired with
+     * handler functions. Compatible with Claude, GPT, LangChain, AutoGen,
+     * CrewAI, and any framework using standard function calling.
+     *
+     * Categories:
+     * - 'core': add_node, add_alternative, relate_nodes, set_state
+     * - 'query': query_why, query_what_if, query_tensions, query_blocked, query_alternatives
+     * - 'memory': get_memory, search_nodes
+     */
+    asTools(options?: AsToolsOptions): MemoryTool[];
+    /** Get a raw Node by ID */
+    getNode(id: string): Node | undefined;
+    /** Create a NodeRef for an existing node ID */
+    ref(id: string): NodeRef;
+    /** Find nodes matching a predicate */
+    findNodes(predicate: (node: Node) => boolean): NodeRef[];
+    /** All nodes as NodeRefs */
+    get nodes(): NodeRef[];
+    /** Number of nodes in the graph */
+    get size(): number;
+    /** The file path associated with this Memory (set by load/loadOrCreate/save) */
+    get filePath(): string | null;
+    /** The audit log path derived from filePath (e.g., memory.json → memory.audit.jsonl). Null if no filePath. */
+    get auditPath(): string | null;
+    /** @internal Derive audit path from any file path. Handles extensionless files. */
+    static _deriveAuditPath(filePath: string): string;
+    /** Get temporal metadata for a node */
+    getTemporalMeta(id: string): TemporalMeta | undefined;
+    /**
+     * Garden report: classify nodes by activity level.
+     * Growing = touched recently, has momentum.
+     * Resting = a few days quiet, might need revisiting.
+     * Dormant = untouched long enough to consider archiving.
+     */
+    garden(): GardenReport;
+    /**
+     * Prune dormant nodes: remove them from the active graph.
+     * Automatically appends pruned data to the audit log (.audit.jsonl) if a filePath is set.
+     * Returns the pruned nodes for archival.
+     */
+    prune(): PruneReport;
+    /** Create an immutable snapshot of current state. Returns snapshot ID. */
+    snapshot(reason?: string): string;
+    /** List all snapshots (metadata only) */
+    snapshots(): SnapshotInfo[];
+    /** Restore to a previous snapshot (time-travel) */
+    restore(snapshotId: string): void;
+    /** Register a graduation event handler */
+    on(event: 'graduation-candidate', handler: GraduationHandler): void;
+    /** Register a generic event handler */
+    on(event: string, handler: EventHandler): void;
+    /** Remove an event handler */
+    off(event: string, handler: EventHandler | GraduationHandler): void;
+    /** @internal Add a node to the graph. Handles dedup + temporal tracking. */
+    _addNode(type: NodeType, content: string, parentId?: string): NodeRef;
+    /** @internal Add a relationship to the graph */
+    _addRelationship(sourceId: string, targetId: string, type: RelationType, options?: {
+        axis?: string;
+        feedback?: boolean;
+    }): void;
+    /** @internal Add a state to a node */
+    _addState(nodeId: string, type: StateType, fields: Record<string, string>): void;
+    /**
+     * Remove states from a node. If type is specified, only removes states of that type.
+     * Without type, removes ALL states from the node.
+     * Returns the number of states removed.
+     */
+    removeStates(nodeId: string, type?: StateType): number;
+    /** @internal Add a modifier to a node */
+    _addModifier(nodeId: string, modifier: string): void;
+    /**
+     * Estimate token cost for a single node's serialized output.
+     * Rough but fast — accounts for type prefix, modifiers, states, and content.
+     */
+    private _estimateNodeTokenCost;
+    /**
+     * Sort node IDs in-place by the given strategy.
+     */
+    private _sortByStrategy;
+    /**
+     * Build a pruned IR containing only the specified nodes and their
+     * inter-relationships and states.
+     */
+    private _buildPrunedIR;
+    /** Touch a node: update lastTouched, increment frequency, check graduation */
+    private _touchNode;
+    /** Add a child ID to a parent node's children array */
+    private _addChild;
+    /** Create provenance for a programmatically created entity */
+    private _createProvenance;
+    /** Get graduation threshold for a tier */
+    private _getGraduationThreshold;
+    /** Emit graduation-candidate event */
+    private _emitGraduation;
+    /** Get the next tier up from current */
+    private _nextTier;
+}
+export {};
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

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