@10et/cli 1.0.0

package/dist/lib/replay-buffer.js

@@ -0,0 +1,302 @@
+/**
+ * Shared Replay Buffer
+ *
+ * Cross-agent learning via append-only JSONL file.
+ * Enables agents to learn from each other's experiences.
+ * 80% from own agent, 20% from others by default.
+ *
+ * @purpose Shared replay buffer for cross-agent reinforcement learning
+ */
+import { existsSync, readFileSync, appendFileSync, mkdirSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { createHash } from "crypto";
+// ============================================================================
+// Implementation
+// ============================================================================
+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();
+}
+function generateEntryId(agent, stateHash, timestamp) {
+    const hash = createHash("sha256")
+        .update(`${agent}-${stateHash}-${timestamp}`)
+        .digest("hex")
+        .slice(0, 12);
+    return `rb_${hash}`;
+}
+export class ReplayBuffer {
+    bufferPath;
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot || findProjectRoot();
+        this.bufferPath = join(this.projectRoot, ".jfl", "replay-buffer.jsonl");
+    }
+    /**
+     * Append a new entry to the replay buffer
+     */
+    write(entry) {
+        const id = generateEntryId(entry.agent, entry.state_hash, entry.timestamp);
+        const full = { id, ...entry };
+        const dir = dirname(this.bufferPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        appendFileSync(this.bufferPath, JSON.stringify(full) + "\n");
+        return full;
+    }
+    /**
+     * Read all entries from the replay buffer
+     */
+    readAll() {
+        if (!existsSync(this.bufferPath))
+            return [];
+        const entries = [];
+        const lines = readFileSync(this.bufferPath, "utf-8").split("\n");
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                entries.push(JSON.parse(line));
+            }
+            catch { }
+        }
+        return entries;
+    }
+    /**
+     * Sample entries for training
+     * By default: 80% from target agent, 20% from others
+     */
+    sample(agent, options) {
+        const { batchSize, crossAgentRatio, minReward, maxAge } = options;
+        const entries = this.readAll();
+        const now = Date.now();
+        // Filter entries
+        let filtered = entries.filter(e => {
+            if (minReward !== undefined && e.reward < minReward)
+                return false;
+            if (maxAge !== undefined) {
+                const entryTime = new Date(e.timestamp).getTime();
+                if (now - entryTime > maxAge)
+                    return false;
+            }
+            return true;
+        });
+        // Split by agent
+        const ownEntries = filtered.filter(e => e.agent === agent);
+        const otherEntries = filtered.filter(e => e.agent !== agent);
+        // Calculate how many from each pool
+        const crossAgentCount = Math.floor(batchSize * crossAgentRatio);
+        const ownCount = batchSize - crossAgentCount;
+        // Randomly sample from each pool
+        const sampled = [];
+        // Sample from own agent
+        const shuffledOwn = this.shuffle(ownEntries);
+        sampled.push(...shuffledOwn.slice(0, ownCount));
+        // Sample from other agents
+        const shuffledOthers = this.shuffle(otherEntries);
+        sampled.push(...shuffledOthers.slice(0, crossAgentCount));
+        // Shuffle final result
+        return this.shuffle(sampled);
+    }
+    /**
+     * Sample with prioritized experience replay
+     * Prioritizes entries with higher absolute reward (more informative)
+     */
+    samplePrioritized(agent, options) {
+        const { batchSize, crossAgentRatio, minReward, maxAge } = options;
+        const entries = this.readAll();
+        const now = Date.now();
+        // Filter entries
+        let filtered = entries.filter(e => {
+            if (minReward !== undefined && e.reward < minReward)
+                return false;
+            if (maxAge !== undefined) {
+                const entryTime = new Date(e.timestamp).getTime();
+                if (now - entryTime > maxAge)
+                    return false;
+            }
+            return true;
+        });
+        // Calculate priority based on |reward| (higher = more informative)
+        const withPriority = filtered.map(e => ({
+            entry: e,
+            priority: Math.abs(e.reward) + 0.001, // Small epsilon to avoid zero
+        }));
+        // Split by agent
+        const ownEntries = withPriority.filter(ep => ep.entry.agent === agent);
+        const otherEntries = withPriority.filter(ep => ep.entry.agent !== agent);
+        // Calculate how many from each pool
+        const crossAgentCount = Math.floor(batchSize * crossAgentRatio);
+        const ownCount = batchSize - crossAgentCount;
+        const sampled = [];
+        // Prioritized sampling from own agent
+        sampled.push(...this.prioritizedSample(ownEntries, ownCount));
+        // Prioritized sampling from other agents
+        sampled.push(...this.prioritizedSample(otherEntries, crossAgentCount));
+        return this.shuffle(sampled);
+    }
+    prioritizedSample(entries, count) {
+        if (entries.length === 0)
+            return [];
+        if (entries.length <= count)
+            return entries.map(e => e.entry);
+        // Compute sampling probabilities
+        const totalPriority = entries.reduce((sum, e) => sum + e.priority, 0);
+        const probs = entries.map(e => e.priority / totalPriority);
+        // Sample without replacement using priority weights
+        const sampled = [];
+        const remaining = [...entries];
+        const remainingProbs = [...probs];
+        for (let i = 0; i < count && remaining.length > 0; i++) {
+            // Normalize remaining probs
+            const total = remainingProbs.reduce((a, b) => a + b, 0);
+            const normalized = remainingProbs.map(p => p / total);
+            // Sample
+            const r = Math.random();
+            let cumulative = 0;
+            for (let j = 0; j < remaining.length; j++) {
+                cumulative += normalized[j];
+                if (r <= cumulative) {
+                    sampled.push(remaining[j].entry);
+                    remaining.splice(j, 1);
+                    remainingProbs.splice(j, 1);
+                    break;
+                }
+            }
+        }
+        return sampled;
+    }
+    /**
+     * Get statistics about the replay buffer
+     */
+    stats() {
+        const entries = this.readAll();
+        if (entries.length === 0) {
+            return {
+                totalEntries: 0,
+                perAgent: {},
+                avgReward: 0,
+                positiveRate: 0,
+            };
+        }
+        const perAgent = {};
+        let rewardSum = 0;
+        let positiveCount = 0;
+        let oldestTs = entries[0].timestamp;
+        let newestTs = entries[0].timestamp;
+        for (const e of entries) {
+            perAgent[e.agent] = (perAgent[e.agent] || 0) + 1;
+            rewardSum += e.reward;
+            if (e.reward > 0)
+                positiveCount++;
+            if (e.timestamp < oldestTs)
+                oldestTs = e.timestamp;
+            if (e.timestamp > newestTs)
+                newestTs = e.timestamp;
+        }
+        return {
+            totalEntries: entries.length,
+            perAgent,
+            avgReward: rewardSum / entries.length,
+            positiveRate: positiveCount / entries.length,
+            oldestEntry: oldestTs,
+            newestEntry: newestTs,
+        };
+    }
+    /**
+     * Get entries for a specific agent
+     */
+    getForAgent(agent) {
+        return this.readAll().filter(e => e.agent === agent);
+    }
+    /**
+     * Get recent entries
+     */
+    getRecent(count = 20) {
+        const entries = this.readAll();
+        return entries
+            .sort((a, b) => b.timestamp.localeCompare(a.timestamp))
+            .slice(0, count);
+    }
+    /**
+     * Export for policy head training
+     */
+    exportForTraining() {
+        const entries = this.readAll();
+        return entries.map(e => ({
+            state_text: this.formatStateText(e.state),
+            action_text: this.formatActionText(e.action, e.hypothesis),
+            reward: e.reward,
+            agent: e.agent,
+            ts: e.timestamp,
+        }));
+    }
+    formatStateText(state) {
+        const dims = Object.entries(state.dimension_scores)
+            .map(([k, v]) => `${k}=${v.toFixed(4)}`).join(", ");
+        const deltas = state.recent_deltas
+            .map(d => `${d >= 0 ? "+" : ""}${d.toFixed(4)}`).join(", ");
+        return [
+            `Agent: ${state.agent}`,
+            `Composite: ${state.composite_score.toFixed(4)}`,
+            `Tests: ${state.tests_passing}/${state.tests_total}`,
+            `Trajectory: ${state.trajectory_length}`,
+            `Dimensions: ${dims || "none"}`,
+            `Recent deltas: ${deltas || "none"}`,
+        ].join("\n");
+    }
+    formatActionText(action, hypothesis) {
+        const files = action.files_affected.slice(0, 5).join(", ");
+        return [
+            `Type: ${action.type}`,
+            `Description: ${action.description.slice(0, 150)}`,
+            `Hypothesis: ${hypothesis.slice(0, 100)}`,
+            `Scope: ${action.scope}`,
+            `Files: ${files || "none"}`,
+        ].join("\n");
+    }
+    shuffle(array) {
+        const result = [...array];
+        for (let i = result.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [result[i], result[j]] = [result[j], result[i]];
+        }
+        return result;
+    }
+    /**
+     * Clear old entries (keep last N or by age)
+     */
+    prune(options) {
+        const entries = this.readAll();
+        const now = Date.now();
+        let filtered = entries;
+        // Filter by age
+        if (options.maxAge) {
+            filtered = filtered.filter(e => {
+                const entryTime = new Date(e.timestamp).getTime();
+                return now - entryTime <= options.maxAge;
+            });
+        }
+        // Keep only most recent N
+        if (options.maxEntries && filtered.length > options.maxEntries) {
+            filtered = filtered
+                .sort((a, b) => b.timestamp.localeCompare(a.timestamp))
+                .slice(0, options.maxEntries);
+        }
+        const pruned = entries.length - filtered.length;
+        if (pruned > 0) {
+            // Rewrite buffer with filtered entries
+            const content = filtered.map(e => JSON.stringify(e)).join("\n") + "\n";
+            writeFileSync(this.bufferPath, content);
+        }
+        return pruned;
+    }
+}
+//# sourceMappingURL=replay-buffer.js.map

package/dist/lib/replay-buffer.js.map

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

package/dist/lib/resource-optimizer-middleware.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @purpose CLI middleware that wires ResourceOptimizer into every command
+ *
+ * preAction: Capture state, run RO.decide(), apply guidance (delay/throttle)
+ * postAction: Capture post-state, call RO.recordTransition(), flush to disk
+ *
+ * Performance budget: <5ms for preAction (uses fast os module, not execSync)
+ * Background: Full physical-world capture runs on 5s timer for cache refresh
+ *
+ * @invariant RO can DELAY but never CANCEL commands
+ * @spec knowledge/CASH-REVIEW-RESPONSES.md
+ */
+import type { ResourceGuidance } from "./resource-optimizer.js";
+/**
+ * preAction hook — runs before every CLI command.
+ * Budget: <5ms. Uses fast os module capture + cached state.
+ *
+ * @returns true if command should proceed, false to skip (never happens — RO can only DELAY)
+ */
+export declare function resourceOptimizerPreAction(commandName: string): Promise<ResourceGuidance>;
+/**
+ * postAction hook — runs after every CLI command.
+ * Records the transition and flushes to disk.
+ */
+export declare function resourceOptimizerPostAction(commandName: string, projectRoot: string): Promise<void>;
+/**
+ * Apply guidance — delay if needed.
+ * Returns immediately for passthrough/monitor/boost.
+ */
+export declare function applyGuidance(guidance: ResourceGuidance): Promise<void>;
+/**
+ * Get RO stats for dashboard/status display
+ */
+export declare function getResourceOptimizerStats(projectRoot: string): {
+    transitions: number;
+    trainingReady: boolean;
+    lastAction: string | null;
+};
+//# sourceMappingURL=resource-optimizer-middleware.d.ts.map

package/dist/lib/resource-optimizer-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-optimizer-middleware.d.ts","sourceRoot":"","sources":["../../src/lib/resource-optimizer-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAoJ/E;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsC/F;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG;IAC9D,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAOA"}

package/dist/lib/resource-optimizer-middleware.js

@@ -0,0 +1,228 @@
+/**
+ * @purpose CLI middleware that wires ResourceOptimizer into every command
+ *
+ * preAction: Capture state, run RO.decide(), apply guidance (delay/throttle)
+ * postAction: Capture post-state, call RO.recordTransition(), flush to disk
+ *
+ * Performance budget: <5ms for preAction (uses fast os module, not execSync)
+ * Background: Full physical-world capture runs on 5s timer for cache refresh
+ *
+ * @invariant RO can DELAY but never CANCEL commands
+ * @spec knowledge/CASH-REVIEW-RESPONSES.md
+ */
+import { cpus, totalmem, freemem, loadavg } from "os";
+import { existsSync, appendFileSync, mkdirSync, readFileSync } from "fs";
+import { join } from "path";
+// ============================================================================
+// Fast State Capture (0ms — no execSync, no subprocess)
+// ============================================================================
+/**
+ * Ultra-fast state capture using Node's os module.
+ * Missing fields (thermal, battery, git) are filled from cache or defaults.
+ */
+function captureFastState(cache) {
+    const totalMem = totalmem() / (1024 * 1024);
+    const freeMemMb = freemem() / (1024 * 1024);
+    const usedMemMb = totalMem - freeMemMb;
+    const load = loadavg();
+    return {
+        cpu_usage_percent: cache?.cpu_usage_percent ?? estimateCpuFromLoad(load[0]),
+        memory_usage_mb: usedMemMb,
+        memory_available_mb: freeMemMb,
+        thermal_state: cache?.thermal_state ?? "nominal",
+        system_load_1m: load[0],
+        disk_free_gb: cache?.disk_free_gb ?? 50,
+        battery_level: cache?.battery_level,
+        battery_charging: cache?.battery_charging,
+        git_branch: cache?.git_branch ?? "main",
+        git_dirty_files: cache?.git_dirty_files ?? 0,
+        concurrent_terminals: cache?.concurrent_terminals ?? 1,
+        active_ide: cache?.active_ide ?? false,
+        recent_build_time_ms: cache?.recent_build_time_ms,
+        recent_test_time_ms: cache?.recent_test_time_ms,
+        avg_command_duration_ms: cache?.avg_command_duration_ms ?? 800,
+        network_latency_ms: cache?.network_latency_ms,
+        internet_connectivity: cache?.internet_connectivity ?? true,
+        localhost_ports_active: cache?.localhost_ports_active ?? [],
+    };
+}
+/** Estimate CPU% from load average (rough — load/cores * 100) */
+function estimateCpuFromLoad(load1m) {
+    const cores = cpus().length;
+    return Math.min(100, (load1m / cores) * 100);
+}
+function getTransitionPath(projectRoot) {
+    const dir = join(projectRoot, ".jfl", "telemetry");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return join(dir, "resource-transitions.jsonl");
+}
+function flushTransition(projectRoot, record) {
+    try {
+        const path = getTransitionPath(projectRoot);
+        appendFileSync(path, JSON.stringify(record) + "\n");
+    }
+    catch {
+        // Non-blocking — don't crash CLI for telemetry
+    }
+}
+function countTransitions(projectRoot) {
+    try {
+        const path = getTransitionPath(projectRoot);
+        if (!existsSync(path))
+            return 0;
+        const content = readFileSync(path, "utf-8");
+        return content.split("\n").filter(Boolean).length;
+    }
+    catch {
+        return 0;
+    }
+}
+// ============================================================================
+// Background State Refresh
+// ============================================================================
+let _fullStateCache = null;
+let _bgTimer = null;
+let _roInstance = null;
+async function refreshFullState() {
+    try {
+        const { PhysicalWorldModel } = await import("./physical-world-model.js");
+        const model = new PhysicalWorldModel();
+        _fullStateCache = await model.captureCurrentState();
+    }
+    catch {
+        // If full capture fails, fast capture is still available
+    }
+}
+function ensureBackgroundRefresh() {
+    if (_bgTimer)
+        return;
+    // Refresh full state every 5s in background
+    _bgTimer = setInterval(() => {
+        refreshFullState().catch(() => { });
+    }, 5000);
+    // Don't keep process alive for background timer
+    if (_bgTimer.unref)
+        _bgTimer.unref();
+    // Defer initial refresh: use setTimeout with unref so it doesn't block process exit.
+    // captureCurrentState() uses execSync which blocks the event loop — delaying it
+    // prevents contention with command module loading and doesn't block fast CLI exit.
+    const initTimer = setTimeout(() => {
+        refreshFullState().catch(() => { });
+    }, 2000);
+    if (initTimer.unref)
+        initTimer.unref();
+}
+async function getOrCreateRO() {
+    if (!_roInstance) {
+        const { getResourceOptimizer } = await import("./resource-optimizer.js");
+        _roInstance = getResourceOptimizer();
+    }
+    return _roInstance;
+}
+// ============================================================================
+// Middleware Hooks (wired into Commander preAction/postAction)
+// ============================================================================
+/** Per-command state stored between pre and post action */
+const commandState = new Map();
+/**
+ * preAction hook — runs before every CLI command.
+ * Budget: <5ms. Uses fast os module capture + cached state.
+ *
+ * @returns true if command should proceed, false to skip (never happens — RO can only DELAY)
+ */
+export async function resourceOptimizerPreAction(commandName) {
+    const start = Date.now();
+    try {
+        // Start background refresh if not running
+        ensureBackgroundRefresh();
+        // Fast capture (<1ms)
+        const state = captureFastState(_fullStateCache);
+        // Get RO decision (<1ms for rules, <5ms with model)
+        const ro = await getOrCreateRO();
+        const guidance = ro.decide(state, commandName);
+        // Store for postAction
+        commandState.set(commandName, {
+            beforeState: state,
+            guidance,
+            startTime: Date.now(),
+        });
+        const elapsed = Date.now() - start;
+        if (elapsed > 10) {
+            // Log if we exceeded budget (shouldn't happen)
+            console.error(`  [ro-middleware] preAction took ${elapsed}ms (budget: 5ms)`);
+        }
+        return guidance;
+    }
+    catch {
+        // Never fail the command for RO issues
+        return {
+            action: "passthrough",
+            delay_ms: 0,
+            reason: "RO middleware error — passthrough",
+            confidence: 1.0,
+            source: "passthrough",
+        };
+    }
+}
+/**
+ * postAction hook — runs after every CLI command.
+ * Records the transition and flushes to disk.
+ */
+export async function resourceOptimizerPostAction(commandName, projectRoot) {
+    try {
+        const cmdState = commandState.get(commandName);
+        if (!cmdState)
+            return;
+        commandState.delete(commandName);
+        // Fast capture of post-state
+        const afterState = captureFastState(_fullStateCache);
+        // Record transition in RO
+        const ro = await getOrCreateRO();
+        ro.recordTransition(cmdState.beforeState, commandName, afterState, cmdState.guidance.action);
+        // Flush to disk (non-blocking)
+        const record = {
+            ts: new Date().toISOString(),
+            command: commandName,
+            action: cmdState.guidance.action,
+            delay_ms: cmdState.guidance.delay_ms,
+            confidence: cmdState.guidance.confidence,
+            source: cmdState.guidance.source,
+            reason: cmdState.guidance.reason,
+            duration_ms: Date.now() - cmdState.startTime,
+            cpu_before: cmdState.beforeState.cpu_usage_percent,
+            mem_before_mb: cmdState.beforeState.memory_usage_mb,
+            load_before: cmdState.beforeState.system_load_1m,
+            cpu_after: afterState.cpu_usage_percent,
+            mem_after_mb: afterState.memory_usage_mb,
+            load_after: afterState.system_load_1m,
+            thermal: afterState.thermal_state,
+        };
+        flushTransition(projectRoot, record);
+    }
+    catch {
+        // Never fail — this is telemetry
+    }
+}
+/**
+ * Apply guidance — delay if needed.
+ * Returns immediately for passthrough/monitor/boost.
+ */
+export async function applyGuidance(guidance) {
+    if (guidance.delay_ms > 0) {
+        await new Promise(resolve => setTimeout(resolve, guidance.delay_ms));
+    }
+}
+/**
+ * Get RO stats for dashboard/status display
+ */
+export function getResourceOptimizerStats(projectRoot) {
+    const transitions = countTransitions(projectRoot);
+    return {
+        transitions,
+        trainingReady: transitions >= 5000,
+        lastAction: null, // Could parse last line of JSONL
+    };
+}
+//# sourceMappingURL=resource-optimizer-middleware.js.map

package/dist/lib/resource-optimizer-middleware.js.map

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

package/dist/lib/resource-optimizer.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ResourceOptimizer — Lightweight RL agent for system resource management
+ *
+ * Runs in the hot path of every CLI command (<5ms budget).
+ * Uses cached physical state + tiny GRU model (18K params) for temporal patterns.
+ * Falls back to rule-based policy when no model is trained.
+ *
+ * Authority: Can DELAY/THROTTLE but never CANCEL or REDIRECT actions.
+ * The InvariantMonitor has veto power above this.
+ *
+ * Cold start: Rules-only for first 7 days while collecting telemetry.
+ * Model takes over for scenarios it's confident on after 5K+ tuples.
+ *
+ * @purpose Real-time system resource management agent
+ * @spec knowledge/CASH-REVIEW-RESPONSES.md
+ */
+import type { PhysicalWorldState } from "../types/physical-world-model.js";
+export type ResourceAction = "passthrough" | "throttle" | "defer_background" | "gc_hint" | "conservation" | "boost" | "monitor";
+export interface ResourceGuidance {
+    action: ResourceAction;
+    delay_ms: number;
+    reason: string;
+    confidence: number;
+    source: "model" | "rules" | "passthrough";
+}
+export interface ResourceOptimizerConfig {
+    /** Enable/disable the optimizer */
+    enabled: boolean;
+    /** Maximum decision latency in ms */
+    maxDecisionMs: number;
+    /** Minimum model confidence to override rules */
+    minModelConfidence: number;
+    /** Path to trained model weights (null = rules only) */
+    modelPath: string | null;
+    /** State cache refresh interval in ms */
+    stateCacheIntervalMs: number;
+}
+export declare class ResourceOptimizer {
+    private config;
+    private stateCache;
+    private stateCacheTimer;
+    private transitionBuffer;
+    private readonly MAX_BUFFER;
+    constructor(config?: Partial<ResourceOptimizerConfig>);
+    /**
+     * Make a resource management decision.
+     * Must complete in <5ms.
+     *
+     * @param state - Current physical world state (from cache)
+     * @param command - The command about to execute
+     * @returns Resource guidance (action + delay)
+     */
+    decide(state: PhysicalWorldState, command: string): ResourceGuidance;
+    /**
+     * Record a transition for training.
+     * Called AFTER command execution, non-blocking.
+     */
+    recordTransition(beforeState: PhysicalWorldState, command: string, afterState: PhysicalWorldState, actionTaken?: ResourceAction): void;
+    /** Get buffer size for training readiness check */
+    get bufferSize(): number;
+    /** Check if we have enough data to train */
+    get isTrainingReady(): boolean;
+    /** Export buffer for training pipeline */
+    exportBuffer(): typeof this.transitionBuffer;
+    /** Get current config */
+    getConfig(): ResourceOptimizerConfig;
+    /** Update config (e.g., enable/disable, change model path) */
+    updateConfig(updates: Partial<ResourceOptimizerConfig>): void;
+}
+export declare function getResourceOptimizer(config?: Partial<ResourceOptimizerConfig>): ResourceOptimizer;
+//# sourceMappingURL=resource-optimizer.d.ts.map