jfl 0.7.2 → 0.8.0

package/dist/lib/world-model-store.d.ts

@@ -0,0 +1,172 @@
+/**
+ * World Model Storage Layer
+ *
+ * File-based JSONL storage for state transitions, predictions, invariant violations,
+ * and state snapshots. Follows the eval-store.ts pattern for consistency.
+ *
+ * Storage structure:
+ *   world-model-data/
+ *   ├── transitions/
+ *   │   ├── YYYY-MM-DD.jsonl      # Daily transition logs
+ *   │   └── index.json             # Fast lookup index
+ *   ├── states/
+ *   │   ├── snapshots-hourly.jsonl
+ *   │   └── current-state.json
+ *   ├── predictions/
+ *   │   ├── dynamics-cache.jsonl
+ *   │   └── counterfactuals.jsonl
+ *   └── invariants/
+ *       ├── violations.jsonl
+ *       └── recovery-log.jsonl
+ *
+ * @purpose JSONL storage layer for world model data — transitions, predictions, invariants
+ * @spec world-model-roadmap.md#storage
+ */
+import type { StateTransition, WorldState, InvariantViolation, PredictionResult, CounterfactualScenario, AgentAction, CachedPrediction, StateSnapshot, WorldModelStorageConfig } from "../types/world-model.js";
+/**
+ * WorldModelStore manages all persistent storage for the world model.
+ * Uses JSONL files for append-only logs and JSON for indexes/state.
+ */
+export declare class WorldModelStore {
+    private projectRoot;
+    private dataDir;
+    private config;
+    /**
+     * Create a new WorldModelStore
+     * @param projectRoot - Project root directory (auto-detected if not provided)
+     * @param config - Optional configuration overrides
+     */
+    constructor(projectRoot?: string, config?: Partial<WorldModelStorageConfig>);
+    /**
+     * Record a new state transition
+     * @param transition - The transition to record (id will be generated if not provided)
+     * @returns The recorded transition with generated ID
+     */
+    recordTransition(transition: Omit<StateTransition, "id"> & {
+        id?: string;
+    }): StateTransition;
+    /**
+     * Get transitions with optional filtering
+     * @param options - Filter options
+     * @returns Array of matching transitions
+     */
+    getTransitions(options?: {
+        agentId?: string;
+        startTime?: number;
+        endTime?: number;
+        actionType?: string;
+        limit?: number;
+        dateRange?: {
+            start: string;
+            end: string;
+        };
+    }): StateTransition[];
+    /**
+     * Get a specific transition by ID
+     */
+    getTransitionById(id: string): StateTransition | null;
+    /**
+     * Update transition index for fast lookups
+     */
+    private updateTransitionIndex;
+    /**
+     * Read the transition index
+     */
+    private readTransitionIndex;
+    /**
+     * Save a state snapshot
+     * @param state - The world state to snapshot
+     * @param trigger - What triggered this snapshot
+     * @returns The saved snapshot with ID
+     */
+    snapshotState(state: WorldState, trigger?: "hourly" | "event" | "manual"): StateSnapshot;
+    /**
+     * Get the most recent state snapshot
+     */
+    getCurrentState(): WorldState | null;
+    /**
+     * Get recent state snapshots
+     */
+    getRecentSnapshots(limit?: number): StateSnapshot[];
+    /**
+     * Cache a prediction result
+     * @param state - The input state
+     * @param action - The input action
+     * @param prediction - The prediction result
+     */
+    cachePrediction(state: WorldState, action: AgentAction, prediction: PredictionResult): void;
+    /**
+     * Look up a cached prediction
+     * @param state - The input state
+     * @param action - The input action
+     * @returns Cached prediction if found and not expired
+     */
+    getCachedPrediction(state: WorldState, action: AgentAction): PredictionResult | null;
+    /**
+     * Get all cached predictions (for analysis/debugging)
+     */
+    getAllCachedPredictions(): CachedPrediction[];
+    /**
+     * Record an invariant violation
+     * @param violation - The violation to record
+     * @param transitionId - Optional transition ID that caused the violation
+     */
+    recordInvariantViolation(violation: InvariantViolation, transitionId?: string): void;
+    /**
+     * Get recent invariant violations
+     */
+    getRecentViolations(options?: {
+        invariantId?: string;
+        severity?: string;
+        since?: number;
+        limit?: number;
+    }): Array<InvariantViolation & {
+        transitionId?: string;
+    }>;
+    /**
+     * Record a recovery action taken after a violation
+     */
+    recordRecovery(violation: InvariantViolation, recoveryAction: string, success: boolean): void;
+    /**
+     * Store a counterfactual scenario
+     */
+    recordCounterfactual(scenario: CounterfactualScenario): void;
+    /**
+     * Get counterfactuals for a transition
+     */
+    getCounterfactuals(baseTransitionId: string): CounterfactualScenario[];
+    /**
+     * Get all counterfactuals (for analysis)
+     */
+    getAllCounterfactuals(): CounterfactualScenario[];
+    /**
+     * Get storage statistics
+     */
+    getStats(): {
+        transitionCount: number;
+        snapshotCount: number;
+        cachedPredictions: number;
+        violationCount: number;
+        counterfactualCount: number;
+        oldestTransition?: number;
+        newestTransition?: number;
+    };
+    /**
+     * Prune old data to keep storage bounded
+     */
+    pruneOldData(options?: {
+        maxAgeDays?: number;
+        maxTransitions?: number;
+    }): {
+        pruned: number;
+    };
+    /**
+     * Get the data directory path
+     */
+    getDataDir(): string;
+    /**
+     * Check if the store has any data
+     */
+    hasData(): boolean;
+}
+//# sourceMappingURL=world-model-store.d.ts.map

package/dist/lib/world-model-store.d.ts.map

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

package/dist/lib/world-model-store.js

@@ -0,0 +1,487 @@
+/**
+ * World Model Storage Layer
+ *
+ * File-based JSONL storage for state transitions, predictions, invariant violations,
+ * and state snapshots. Follows the eval-store.ts pattern for consistency.
+ *
+ * Storage structure:
+ *   world-model-data/
+ *   ├── transitions/
+ *   │   ├── YYYY-MM-DD.jsonl      # Daily transition logs
+ *   │   └── index.json             # Fast lookup index
+ *   ├── states/
+ *   │   ├── snapshots-hourly.jsonl
+ *   │   └── current-state.json
+ *   ├── predictions/
+ *   │   ├── dynamics-cache.jsonl
+ *   │   └── counterfactuals.jsonl
+ *   └── invariants/
+ *       ├── violations.jsonl
+ *       └── recovery-log.jsonl
+ *
+ * @purpose JSONL storage layer for world model data — transitions, predictions, invariants
+ * @spec world-model-roadmap.md#storage
+ */
+import { existsSync, readFileSync, appendFileSync, writeFileSync, mkdirSync, readdirSync } from "fs";
+import { join, dirname } from "path";
+import { createHash } from "crypto";
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_CONFIG = {
+    dataDir: "world-model-data",
+    maxTransitionsPerFile: 10000,
+    predictionCacheTtl: 3600000, // 1 hour
+    maxBufferSize: 50000,
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Find project root by looking for .jfl directory
+ */
+function findProjectRoot() {
+    let dir = process.cwd();
+    while (dir !== dirname(dir)) {
+        if (existsSync(join(dir, ".jfl", "config.json")))
+            return dir;
+        if (existsSync(join(dir, ".jfl")))
+            return dir;
+        dir = dirname(dir);
+    }
+    return process.cwd();
+}
+/**
+ * Get today's date in YYYY-MM-DD format
+ */
+function getDateString(timestamp) {
+    const date = timestamp ? new Date(timestamp) : new Date();
+    return date.toISOString().split("T")[0];
+}
+/**
+ * Generate a unique ID from content hash
+ */
+function generateId(prefix, ...contents) {
+    const hash = createHash("sha256")
+        .update(JSON.stringify(contents))
+        .digest("hex")
+        .slice(0, 16);
+    return `${prefix}_${hash}`;
+}
+/**
+ * Safely parse a JSONL file, skipping malformed lines
+ */
+function parseJSONLFile(filePath) {
+    if (!existsSync(filePath))
+        return [];
+    const entries = [];
+    const lines = readFileSync(filePath, "utf-8").split("\n");
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        try {
+            entries.push(JSON.parse(line));
+        }
+        catch {
+            // Skip malformed lines silently
+        }
+    }
+    return entries;
+}
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+// ============================================================================
+// WorldModelStore Class
+// ============================================================================
+/**
+ * WorldModelStore manages all persistent storage for the world model.
+ * Uses JSONL files for append-only logs and JSON for indexes/state.
+ */
+export class WorldModelStore {
+    projectRoot;
+    dataDir;
+    config;
+    /**
+     * Create a new WorldModelStore
+     * @param projectRoot - Project root directory (auto-detected if not provided)
+     * @param config - Optional configuration overrides
+     */
+    constructor(projectRoot, config) {
+        this.projectRoot = projectRoot || findProjectRoot();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.dataDir = join(this.projectRoot, this.config.dataDir);
+    }
+    // ==========================================================================
+    // Transitions
+    // ==========================================================================
+    /**
+     * Record a new state transition
+     * @param transition - The transition to record (id will be generated if not provided)
+     * @returns The recorded transition with generated ID
+     */
+    recordTransition(transition) {
+        const id = transition.id || generateId("tr", transition.priorState.timestamp, transition.action.agentId, transition.action.actionType);
+        const full = { ...transition, id };
+        const transitionsDir = join(this.dataDir, "transitions");
+        ensureDir(transitionsDir);
+        const dateStr = getDateString(transition.posteriorState.timestamp);
+        const filePath = join(transitionsDir, `${dateStr}.jsonl`);
+        appendFileSync(filePath, JSON.stringify(full) + "\n");
+        // Update index
+        this.updateTransitionIndex(full);
+        return full;
+    }
+    /**
+     * Get transitions with optional filtering
+     * @param options - Filter options
+     * @returns Array of matching transitions
+     */
+    getTransitions(options = {}) {
+        const transitionsDir = join(this.dataDir, "transitions");
+        if (!existsSync(transitionsDir))
+            return [];
+        const files = readdirSync(transitionsDir)
+            .filter(f => f.endsWith(".jsonl"))
+            .sort();
+        // Filter files by date range if provided
+        let filteredFiles = files;
+        if (options.dateRange) {
+            filteredFiles = files.filter(f => {
+                const date = f.replace(".jsonl", "");
+                return date >= options.dateRange.start && date <= options.dateRange.end;
+            });
+        }
+        let transitions = [];
+        for (const file of filteredFiles) {
+            const filePath = join(transitionsDir, file);
+            const fileTransitions = parseJSONLFile(filePath);
+            transitions.push(...fileTransitions);
+        }
+        // Apply filters
+        if (options.agentId) {
+            transitions = transitions.filter(t => t.action.agentId === options.agentId);
+        }
+        if (options.startTime) {
+            transitions = transitions.filter(t => t.priorState.timestamp >= options.startTime);
+        }
+        if (options.endTime) {
+            transitions = transitions.filter(t => t.posteriorState.timestamp <= options.endTime);
+        }
+        if (options.actionType) {
+            transitions = transitions.filter(t => t.action.actionType === options.actionType);
+        }
+        // Sort by timestamp (newest first) and limit
+        transitions.sort((a, b) => b.posteriorState.timestamp - a.posteriorState.timestamp);
+        if (options.limit) {
+            transitions = transitions.slice(0, options.limit);
+        }
+        return transitions;
+    }
+    /**
+     * Get a specific transition by ID
+     */
+    getTransitionById(id) {
+        const index = this.readTransitionIndex();
+        const entry = index[id];
+        if (!entry)
+            return null;
+        const filePath = join(this.dataDir, "transitions", `${entry.date}.jsonl`);
+        const transitions = parseJSONLFile(filePath);
+        return transitions.find(t => t.id === id) || null;
+    }
+    /**
+     * Update transition index for fast lookups
+     */
+    updateTransitionIndex(transition) {
+        const indexPath = join(this.dataDir, "transitions", "index.json");
+        const index = this.readTransitionIndex();
+        index[transition.id] = {
+            date: getDateString(transition.posteriorState.timestamp),
+            agentId: transition.action.agentId,
+            actionType: transition.action.actionType,
+            timestamp: transition.posteriorState.timestamp,
+        };
+        writeFileSync(indexPath, JSON.stringify(index, null, 2));
+    }
+    /**
+     * Read the transition index
+     */
+    readTransitionIndex() {
+        const indexPath = join(this.dataDir, "transitions", "index.json");
+        if (!existsSync(indexPath))
+            return {};
+        try {
+            return JSON.parse(readFileSync(indexPath, "utf-8"));
+        }
+        catch {
+            return {};
+        }
+    }
+    // ==========================================================================
+    // State Snapshots
+    // ==========================================================================
+    /**
+     * Save a state snapshot
+     * @param state - The world state to snapshot
+     * @param trigger - What triggered this snapshot
+     * @returns The saved snapshot with ID
+     */
+    snapshotState(state, trigger = "manual") {
+        const snapshot = {
+            id: generateId("ss", state.timestamp, state.agentId),
+            timestamp: state.timestamp,
+            state,
+            trigger,
+        };
+        const statesDir = join(this.dataDir, "states");
+        ensureDir(statesDir);
+        // Append to hourly snapshots
+        const snapshotsPath = join(statesDir, "snapshots-hourly.jsonl");
+        appendFileSync(snapshotsPath, JSON.stringify(snapshot) + "\n");
+        // Update current state
+        const currentPath = join(statesDir, "current-state.json");
+        writeFileSync(currentPath, JSON.stringify(state, null, 2));
+        return snapshot;
+    }
+    /**
+     * Get the most recent state snapshot
+     */
+    getCurrentState() {
+        const currentPath = join(this.dataDir, "states", "current-state.json");
+        if (!existsSync(currentPath))
+            return null;
+        try {
+            return JSON.parse(readFileSync(currentPath, "utf-8"));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get recent state snapshots
+     */
+    getRecentSnapshots(limit = 24) {
+        const snapshotsPath = join(this.dataDir, "states", "snapshots-hourly.jsonl");
+        const snapshots = parseJSONLFile(snapshotsPath);
+        return snapshots
+            .sort((a, b) => b.timestamp - a.timestamp)
+            .slice(0, limit);
+    }
+    // ==========================================================================
+    // Predictions Cache
+    // ==========================================================================
+    /**
+     * Cache a prediction result
+     * @param state - The input state
+     * @param action - The input action
+     * @param prediction - The prediction result
+     */
+    cachePrediction(state, action, prediction) {
+        const key = generateId("pc", state.timestamp, state.agentId, action.actionType);
+        const cached = {
+            key,
+            prediction,
+            cachedAt: Date.now(),
+            hitCount: 0,
+        };
+        const predictionsDir = join(this.dataDir, "predictions");
+        ensureDir(predictionsDir);
+        const cachePath = join(predictionsDir, "dynamics-cache.jsonl");
+        appendFileSync(cachePath, JSON.stringify(cached) + "\n");
+    }
+    /**
+     * Look up a cached prediction
+     * @param state - The input state
+     * @param action - The input action
+     * @returns Cached prediction if found and not expired
+     */
+    getCachedPrediction(state, action) {
+        const cachePath = join(this.dataDir, "predictions", "dynamics-cache.jsonl");
+        if (!existsSync(cachePath))
+            return null;
+        const entries = parseJSONLFile(cachePath);
+        const now = Date.now();
+        // Find matching entry that hasn't expired
+        const key = generateId("pc", state.timestamp, state.agentId, action.actionType);
+        const entry = entries.find(e => e.key === key &&
+            (now - e.cachedAt) < this.config.predictionCacheTtl);
+        return entry?.prediction || null;
+    }
+    /**
+     * Get all cached predictions (for analysis/debugging)
+     */
+    getAllCachedPredictions() {
+        const cachePath = join(this.dataDir, "predictions", "dynamics-cache.jsonl");
+        return parseJSONLFile(cachePath);
+    }
+    // ==========================================================================
+    // Invariant Violations
+    // ==========================================================================
+    /**
+     * Record an invariant violation
+     * @param violation - The violation to record
+     * @param transitionId - Optional transition ID that caused the violation
+     */
+    recordInvariantViolation(violation, transitionId) {
+        const entry = {
+            ...violation,
+            detectedAt: violation.detectedAt || Date.now(),
+            transitionId,
+        };
+        const invariantsDir = join(this.dataDir, "invariants");
+        ensureDir(invariantsDir);
+        const violationsPath = join(invariantsDir, "violations.jsonl");
+        appendFileSync(violationsPath, JSON.stringify(entry) + "\n");
+    }
+    /**
+     * Get recent invariant violations
+     */
+    getRecentViolations(options = {}) {
+        const violationsPath = join(this.dataDir, "invariants", "violations.jsonl");
+        let violations = parseJSONLFile(violationsPath);
+        if (options.invariantId) {
+            violations = violations.filter(v => v.invariantId === options.invariantId);
+        }
+        if (options.severity) {
+            violations = violations.filter(v => v.severity === options.severity);
+        }
+        if (options.since) {
+            violations = violations.filter(v => (v.detectedAt || 0) >= options.since);
+        }
+        violations.sort((a, b) => (b.detectedAt || 0) - (a.detectedAt || 0));
+        if (options.limit) {
+            violations = violations.slice(0, options.limit);
+        }
+        return violations;
+    }
+    /**
+     * Record a recovery action taken after a violation
+     */
+    recordRecovery(violation, recoveryAction, success) {
+        const entry = {
+            violationId: generateId("vr", violation.invariantId, violation.detectedAt),
+            invariantId: violation.invariantId,
+            recoveryAction,
+            success,
+            timestamp: Date.now(),
+        };
+        const invariantsDir = join(this.dataDir, "invariants");
+        ensureDir(invariantsDir);
+        const recoveryPath = join(invariantsDir, "recovery-log.jsonl");
+        appendFileSync(recoveryPath, JSON.stringify(entry) + "\n");
+    }
+    // ==========================================================================
+    // Counterfactuals
+    // ==========================================================================
+    /**
+     * Store a counterfactual scenario
+     */
+    recordCounterfactual(scenario) {
+        const predictionsDir = join(this.dataDir, "predictions");
+        ensureDir(predictionsDir);
+        const counterfactualsPath = join(predictionsDir, "counterfactuals.jsonl");
+        appendFileSync(counterfactualsPath, JSON.stringify(scenario) + "\n");
+    }
+    /**
+     * Get counterfactuals for a transition
+     */
+    getCounterfactuals(baseTransitionId) {
+        const counterfactualsPath = join(this.dataDir, "predictions", "counterfactuals.jsonl");
+        const all = parseJSONLFile(counterfactualsPath);
+        return all.filter(c => c.baseTransitionId === baseTransitionId);
+    }
+    /**
+     * Get all counterfactuals (for analysis)
+     */
+    getAllCounterfactuals() {
+        const counterfactualsPath = join(this.dataDir, "predictions", "counterfactuals.jsonl");
+        return parseJSONLFile(counterfactualsPath);
+    }
+    // ==========================================================================
+    // Statistics and Maintenance
+    // ==========================================================================
+    /**
+     * Get storage statistics
+     */
+    getStats() {
+        const transitions = this.getTransitions({ limit: 100000 });
+        const snapshots = this.getRecentSnapshots(100000);
+        const predictions = this.getAllCachedPredictions();
+        const violations = this.getRecentViolations({ limit: 100000 });
+        const counterfactuals = this.getAllCounterfactuals();
+        return {
+            transitionCount: transitions.length,
+            snapshotCount: snapshots.length,
+            cachedPredictions: predictions.length,
+            violationCount: violations.length,
+            counterfactualCount: counterfactuals.length,
+            oldestTransition: transitions.length > 0
+                ? Math.min(...transitions.map(t => t.priorState.timestamp))
+                : undefined,
+            newestTransition: transitions.length > 0
+                ? Math.max(...transitions.map(t => t.posteriorState.timestamp))
+                : undefined,
+        };
+    }
+    /**
+     * Prune old data to keep storage bounded
+     */
+    pruneOldData(options = {}) {
+        const maxAgeDays = options.maxAgeDays || 30;
+        const cutoffTime = Date.now() - (maxAgeDays * 24 * 60 * 60 * 1000);
+        const cutoffDate = getDateString(cutoffTime);
+        // Prune old transition files
+        const transitionsDir = join(this.dataDir, "transitions");
+        if (existsSync(transitionsDir)) {
+            const files = readdirSync(transitionsDir)
+                .filter(f => f.endsWith(".jsonl"));
+            let pruned = 0;
+            for (const file of files) {
+                const date = file.replace(".jsonl", "");
+                if (date < cutoffDate) {
+                    const fs = require("fs");
+                    fs.unlinkSync(join(transitionsDir, file));
+                    pruned++;
+                }
+            }
+            // Rebuild index
+            if (pruned > 0) {
+                const remaining = this.getTransitions();
+                const index = {};
+                for (const t of remaining) {
+                    index[t.id] = {
+                        date: getDateString(t.posteriorState.timestamp),
+                        agentId: t.action.agentId,
+                        actionType: t.action.actionType,
+                        timestamp: t.posteriorState.timestamp,
+                    };
+                }
+                const indexPath = join(transitionsDir, "index.json");
+                writeFileSync(indexPath, JSON.stringify(index, null, 2));
+                return { pruned };
+            }
+        }
+        return { pruned: 0 };
+    }
+    /**
+     * Get the data directory path
+     */
+    getDataDir() {
+        return this.dataDir;
+    }
+    /**
+     * Check if the store has any data
+     */
+    hasData() {
+        return existsSync(this.dataDir) &&
+            (existsSync(join(this.dataDir, "transitions")) ||
+                existsSync(join(this.dataDir, "states")));
+    }
+}
+//# sourceMappingURL=world-model-store.js.map