jfl 0.2.3 → 0.2.5

package/dist/lib/flow-engine.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Flow Engine
+ *
+ * Reactive automation for the MAP event bus. Loads declarative flow
+ * definitions and executes actions when trigger patterns match.
+ *
+ * @purpose Execute declarative flows: event trigger → action sequence
+ */
+import type { MAPEventBus } from "./map-event-bus.js";
+import type { FlowDefinition, FlowExecution } from "../types/flows.js";
+export declare class FlowEngine {
+    private flows;
+    private eventBus;
+    private projectRoot;
+    private subscriptionIds;
+    private executions;
+    private maxExecutions;
+    constructor(eventBus: MAPEventBus, projectRoot: string);
+    start(): Promise<number>;
+    stop(): void;
+    getFlows(): FlowDefinition[];
+    getExecutions(): FlowExecution[];
+    private loadFlows;
+    private handleEvent;
+    private executeAction;
+    private interpolate;
+    private evaluateGate;
+    private evaluateCondition;
+    static validateCondition(condition: string): {
+        valid: boolean;
+        error?: string;
+    };
+}
+//# sourceMappingURL=flow-engine.d.ts.map

package/dist/lib/flow-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-engine.d.ts","sourceRoot":"","sources":["../../src/lib/flow-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAA2B,aAAa,EAAY,MAAM,mBAAmB,CAAA;AAGzG,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,aAAa,CAAM;gBAEf,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM;IAKhD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAiB9B,IAAI,IAAI,IAAI;IAOZ,QAAQ,IAAI,cAAc,EAAE;IAI5B,aAAa,IAAI,aAAa,EAAE;IAIhC,OAAO,CAAC,SAAS;YAkEH,WAAW;YA6GX,aAAa;IA6F3B,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,iBAAiB;IA0BzB,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAOhF"}

package/dist/lib/flow-engine.js

@@ -0,0 +1,366 @@
+/**
+ * Flow Engine
+ *
+ * Reactive automation for the MAP event bus. Loads declarative flow
+ * definitions and executes actions when trigger patterns match.
+ *
+ * @purpose Execute declarative flows: event trigger → action sequence
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { parse as parseYaml } from "yaml";
+import { telemetry } from "./telemetry.js";
+export class FlowEngine {
+    flows = [];
+    eventBus;
+    projectRoot;
+    subscriptionIds = [];
+    executions = [];
+    maxExecutions = 200;
+    constructor(eventBus, projectRoot) {
+        this.eventBus = eventBus;
+        this.projectRoot = projectRoot;
+    }
+    async start() {
+        this.flows = this.loadFlows();
+        const enabled = this.flows.filter(f => f.enabled);
+        for (const flow of enabled) {
+            const sub = this.eventBus.subscribe({
+                clientId: `flow:${flow.name}`,
+                patterns: [flow.trigger.pattern],
+                transport: "poll",
+                callback: (event) => this.handleEvent(flow, event),
+            });
+            this.subscriptionIds.push(sub.id);
+        }
+        return enabled.length;
+    }
+    stop() {
+        for (const id of this.subscriptionIds) {
+            this.eventBus.unsubscribe(id);
+        }
+        this.subscriptionIds = [];
+    }
+    getFlows() {
+        return [...this.flows];
+    }
+    getExecutions() {
+        return [...this.executions];
+    }
+    loadFlows() {
+        const yamlPath = path.join(this.projectRoot, ".jfl", "flows.yaml");
+        const jsonPath = path.join(this.projectRoot, ".jfl", "flows.json");
+        let config = null;
+        if (fs.existsSync(yamlPath)) {
+            try {
+                const content = fs.readFileSync(yamlPath, "utf-8");
+                config = parseYaml(content);
+            }
+            catch (err) {
+                console.error(`[FlowEngine] Failed to parse ${yamlPath}: ${err.message}`);
+            }
+        }
+        else if (fs.existsSync(jsonPath)) {
+            try {
+                const content = fs.readFileSync(jsonPath, "utf-8");
+                config = JSON.parse(content);
+            }
+            catch (err) {
+                console.error(`[FlowEngine] Failed to parse ${jsonPath}: ${err.message}`);
+            }
+        }
+        const allFlows = [];
+        if (config?.flows && Array.isArray(config.flows)) {
+            const valid = config.flows.filter(f => f.name && f.trigger?.pattern && Array.isArray(f.actions));
+            allFlows.push(...valid);
+        }
+        const flowsDir = path.join(this.projectRoot, ".jfl", "flows");
+        if (fs.existsSync(flowsDir)) {
+            const yamlFiles = fs.readdirSync(flowsDir).filter(f => f.endsWith(".yaml") || f.endsWith(".yml"));
+            for (const file of yamlFiles) {
+                try {
+                    const content = fs.readFileSync(path.join(flowsDir, file), "utf-8");
+                    const extra = parseYaml(content);
+                    if (extra?.flows && Array.isArray(extra.flows)) {
+                        const valid = extra.flows.filter(f => f.name && f.trigger?.pattern && Array.isArray(f.actions));
+                        allFlows.push(...valid);
+                    }
+                }
+                catch (err) {
+                    console.error(`[FlowEngine] Failed to parse ${file}: ${err.message}`);
+                }
+            }
+        }
+        if (allFlows.length === 0) {
+            return [];
+        }
+        const valid = allFlows;
+        for (const flow of valid) {
+            if (flow.trigger.condition) {
+                const check = FlowEngine.validateCondition(flow.trigger.condition);
+                if (!check.valid) {
+                    console.warn(`[FlowEngine] Flow "${flow.name}": ${check.error}`);
+                }
+            }
+        }
+        return valid;
+    }
+    async handleEvent(flow, event) {
+        if (event.type.startsWith("flow:"))
+            return;
+        if (flow.trigger.source && event.source !== flow.trigger.source)
+            return;
+        if (flow.trigger.condition && !this.evaluateCondition(flow.trigger.condition, event))
+            return;
+        const gateResult = this.evaluateGate(flow.gate);
+        if (gateResult) {
+            const gatedExecution = {
+                flow: flow.name,
+                trigger_event_id: event.id,
+                trigger_event_type: event.type,
+                started_at: new Date().toISOString(),
+                completed_at: new Date().toISOString(),
+                actions_executed: 0,
+                actions_failed: 0,
+                gated: gateResult,
+            };
+            this.executions.push(gatedExecution);
+            if (this.executions.length > this.maxExecutions) {
+                this.executions = this.executions.slice(-this.maxExecutions);
+            }
+            this.eventBus.emit({
+                type: "flow:triggered",
+                source: `flow:${flow.name}`,
+                session: event.session,
+                data: {
+                    flow_name: flow.name,
+                    trigger_event_id: event.id,
+                    gated: gateResult,
+                },
+            });
+            telemetry.track({
+                category: 'hooks',
+                event: 'flow:triggered',
+                flow_name: flow.name,
+                hook_event_name: event.type,
+                actions_failed: 0,
+            });
+            return;
+        }
+        const execution = {
+            flow: flow.name,
+            trigger_event_id: event.id,
+            trigger_event_type: event.type,
+            started_at: new Date().toISOString(),
+            actions_executed: 0,
+            actions_failed: 0,
+        };
+        this.eventBus.emit({
+            type: "flow:triggered",
+            source: `flow:${flow.name}`,
+            session: event.session,
+            data: {
+                flow_name: flow.name,
+                trigger_event_id: event.id,
+                trigger_event_type: event.type,
+            },
+        });
+        telemetry.track({
+            category: 'hooks',
+            event: 'flow:triggered',
+            flow_name: flow.name,
+            hook_event_name: event.type,
+        });
+        for (const action of flow.actions) {
+            try {
+                await this.executeAction(action, event, flow);
+                execution.actions_executed++;
+            }
+            catch (err) {
+                execution.actions_failed++;
+                execution.error = err.message;
+                console.error(`[FlowEngine] Action failed in flow "${flow.name}": ${err.message}`);
+            }
+        }
+        execution.completed_at = new Date().toISOString();
+        this.executions.push(execution);
+        if (this.executions.length > this.maxExecutions) {
+            this.executions = this.executions.slice(-this.maxExecutions);
+        }
+        this.eventBus.emit({
+            type: "flow:completed",
+            source: `flow:${flow.name}`,
+            session: event.session,
+            data: {
+                flow_name: flow.name,
+                trigger_event_id: event.id,
+                actions_executed: execution.actions_executed,
+                actions_failed: execution.actions_failed,
+                duration_ms: new Date(execution.completed_at).getTime() - new Date(execution.started_at).getTime(),
+            },
+        });
+        telemetry.track({
+            category: 'hooks',
+            event: 'flow:completed',
+            flow_name: flow.name,
+            hook_event_name: event.type,
+            actions_failed: execution.actions_failed,
+            duration_ms: new Date(execution.completed_at).getTime() - new Date(execution.started_at).getTime(),
+        });
+    }
+    async executeAction(action, event, flow) {
+        switch (action.type) {
+            case "log": {
+                const message = this.interpolate(action.message, event);
+                const ts = new Date().toISOString();
+                console.log(`[${ts}] [Flow:${flow.name}] ${message}`);
+                break;
+            }
+            case "emit": {
+                const data = {};
+                if (action.data) {
+                    for (const [key, value] of Object.entries(action.data)) {
+                        data[key] = typeof value === "string" ? this.interpolate(value, event) : value;
+                    }
+                }
+                this.eventBus.emit({
+                    type: action.event_type,
+                    source: `flow:${flow.name}`,
+                    session: event.session,
+                    data,
+                });
+                break;
+            }
+            case "journal": {
+                const journalDir = path.join(this.projectRoot, ".jfl", "journal");
+                if (!fs.existsSync(journalDir)) {
+                    fs.mkdirSync(journalDir, { recursive: true });
+                }
+                const entry = {
+                    v: 1,
+                    ts: new Date().toISOString(),
+                    session: event.session || "flow-engine",
+                    type: this.interpolate(action.entry_type, event),
+                    title: this.interpolate(action.title, event),
+                    summary: this.interpolate(action.summary, event),
+                    status: "complete",
+                };
+                const journalFile = path.join(journalDir, "flow-engine.jsonl");
+                fs.appendFileSync(journalFile, JSON.stringify(entry) + "\n");
+                break;
+            }
+            case "webhook": {
+                const url = this.interpolate(action.url, event);
+                const body = action.body ? JSON.stringify(action.body) : JSON.stringify(event.data);
+                await fetch(url, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body,
+                    signal: AbortSignal.timeout(10000),
+                });
+                break;
+            }
+            case "command": {
+                const { execSync } = await import("child_process");
+                const cmd = this.interpolate(action.command, event);
+                const args = (action.args || []).map(a => this.interpolate(a, event));
+                execSync([cmd, ...args].join(" "), {
+                    cwd: this.projectRoot,
+                    timeout: 30000,
+                    stdio: "pipe",
+                });
+                break;
+            }
+            case "spawn": {
+                const { spawn: nodeSpawn } = await import("child_process");
+                const cmd = this.interpolate(action.command, event);
+                const args = (action.args || []).map(a => this.interpolate(a, event));
+                const cwd = action.cwd ? this.interpolate(action.cwd, event) : this.projectRoot;
+                const env = { ...process.env };
+                delete env.CLAUDECODE;
+                delete env.CLAUDE_CODE;
+                if (action.env) {
+                    for (const [k, v] of Object.entries(action.env)) {
+                        env[k] = this.interpolate(v, event);
+                    }
+                }
+                const child = nodeSpawn(cmd, args, {
+                    cwd,
+                    env,
+                    stdio: "ignore",
+                    detached: action.detach ?? true,
+                });
+                if (action.detach !== false)
+                    child.unref();
+                break;
+            }
+        }
+    }
+    interpolate(template, event) {
+        return template.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (_match, path) => {
+            const parts = path.split(".");
+            let value = event;
+            for (const part of parts) {
+                if (value == null)
+                    return "";
+                value = value[part];
+            }
+            if (value == null)
+                return "";
+            if (typeof value === "object")
+                return JSON.stringify(value);
+            return String(value);
+        });
+    }
+    evaluateGate(gate) {
+        if (!gate)
+            return null;
+        const now = new Date();
+        if (gate.after) {
+            const afterDate = new Date(gate.after);
+            if (now < afterDate)
+                return "time";
+        }
+        if (gate.before) {
+            const beforeDate = new Date(gate.before);
+            if (now > beforeDate)
+                return "time";
+        }
+        if (gate.requires_approval)
+            return "approval";
+        return null;
+    }
+    evaluateCondition(condition, event) {
+        try {
+            const match = condition.match(/^(\w+(?:\.\w+)*)\s*(==|!=|contains)\s*"([^"]*)"$/);
+            if (!match)
+                return false;
+            const [, fieldPath, operator, expected] = match;
+            const parts = fieldPath.split(".");
+            let value = event;
+            for (const part of parts) {
+                if (value == null)
+                    return false;
+                value = value[part];
+            }
+            const strValue = value == null ? "" : String(value);
+            switch (operator) {
+                case "==": return strValue === expected;
+                case "!=": return strValue !== expected;
+                case "contains": return strValue.includes(expected);
+                default: return true;
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    static validateCondition(condition) {
+        const match = condition.match(/^(\w+(?:\.\w+)*)\s*(==|!=|contains)\s*"([^"]*)"$/);
+        if (!match) {
+            return { valid: false, error: `Invalid condition format: "${condition}". Expected: field operator "value" (operators: ==, !=, contains)` };
+        }
+        return { valid: true };
+    }
+}
+//# sourceMappingURL=flow-engine.js.map

package/dist/lib/flow-engine.js.map

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

package/dist/lib/hook-transformer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Hook Payload Transformer
+ *
+ * Transforms Claude Code HTTP hook payloads into MAPEvents.
+ * Strips sensitive content (file bodies, tool output) — keeps only identifiers.
+ *
+ * @purpose Transform Claude Code hook POST payloads into MAP event bus events
+ */
+import type { MAPEvent, HookPayload } from "../types/map.js";
+export declare function transformHookPayload(payload: HookPayload): Omit<MAPEvent, "id" | "ts">;
+//# sourceMappingURL=hook-transformer.d.ts.map

package/dist/lib/hook-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-transformer.d.ts","sourceRoot":"","sources":["../../src/lib/hook-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAgB,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAc1E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC,CA2DtF"}

package/dist/lib/hook-transformer.js

@@ -0,0 +1,74 @@
+/**
+ * Hook Payload Transformer
+ *
+ * Transforms Claude Code HTTP hook payloads into MAPEvents.
+ * Strips sensitive content (file bodies, tool output) — keeps only identifiers.
+ *
+ * @purpose Transform Claude Code hook POST payloads into MAP event bus events
+ */
+import { telemetry } from "./telemetry.js";
+const HOOK_EVENT_MAP = {
+    SessionStart: "hook:session-start",
+    Stop: "hook:stop",
+    PreCompact: "hook:pre-compact",
+    PostToolUse: "hook:tool-use",
+    PreToolUse: "hook:tool-use",
+    TaskCompleted: "hook:task-completed",
+    SubagentStart: "hook:subagent-start",
+    SubagentStop: "hook:subagent-stop",
+};
+export function transformHookPayload(payload) {
+    const hookName = payload.hook_event_name || "unknown";
+    const eventType = HOOK_EVENT_MAP[hookName] || "custom";
+    const data = {
+        hook_event_name: hookName,
+    };
+    if (payload.session_id) {
+        data.session_id = payload.session_id;
+    }
+    if (payload.tool_name) {
+        data.tool_name = payload.tool_name;
+    }
+    if (payload.file_paths && Array.isArray(payload.file_paths)) {
+        data.file_paths = payload.file_paths;
+    }
+    if (hookName === "PreToolUse") {
+        data.phase = "pre";
+    }
+    if (payload.tool_input) {
+        const safe = {};
+        for (const [key, value] of Object.entries(payload.tool_input)) {
+            if (key === "content" || key === "new_source") {
+                safe[key] = `[${typeof value === "string" ? value.length : 0} chars]`;
+            }
+            else if (key === "old_string" || key === "new_string") {
+                safe[key] = `[${typeof value === "string" ? value.length : 0} chars]`;
+            }
+            else if (typeof value === "string" && value.length > 500) {
+                safe[key] = value.slice(0, 200) + `... [${value.length} chars]`;
+            }
+            else {
+                safe[key] = value;
+            }
+        }
+        data.tool_input = safe;
+    }
+    if (payload.tool_output) {
+        data.tool_output_length = payload.tool_output.length;
+    }
+    telemetry.track({
+        category: 'hooks',
+        event: 'hook:received',
+        hook_event_name: hookName,
+        tool_name: payload.tool_name || undefined,
+        has_file_paths: !!(payload.file_paths?.length),
+        file_paths: payload.file_paths?.slice(0, 5),
+    });
+    return {
+        type: eventType,
+        source: "claude-code",
+        session: payload.session_id,
+        data,
+    };
+}
+//# sourceMappingURL=hook-transformer.js.map

package/dist/lib/hook-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-transformer.js","sourceRoot":"","sources":["../../src/lib/hook-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,MAAM,cAAc,GAAiC;IACnD,YAAY,EAAE,oBAAoB;IAClC,IAAI,EAAE,WAAW;IACjB,UAAU,EAAE,kBAAkB;IAC9B,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,eAAe;IAC3B,aAAa,EAAE,qBAAqB;IACpC,aAAa,EAAE,qBAAqB;IACpC,YAAY,EAAE,oBAAoB;CACnC,CAAA;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAoB;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,IAAI,SAAS,CAAA;IACrD,MAAM,SAAS,GAAiB,cAAc,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAA;IAEpE,MAAM,IAAI,GAA4B;QACpC,eAAe,EAAE,QAAQ;KAC1B,CAAA;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;IACtC,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IACpC,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;IACtC,CAAC;IAED,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAA4B,EAAE,CAAA;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;gBAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACvE,CAAC;iBAAM,IAAI,GAAG,KAAK,YAAY,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;gBACxD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACvE,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBAC3D,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,QAAQ,KAAK,CAAC,MAAM,SAAS,CAAA;YACjE,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YACnB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;IACxB,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAA;IACtD,CAAC;IAED,SAAS,CAAC,KAAK,CAAC;QACd,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,eAAe;QACtB,eAAe,EAAE,QAAQ;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;QACzC,cAAc,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC;QAC9C,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;KAC5C,CAAC,CAAA;IAEF,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,OAAO,CAAC,UAAU;QAC3B,IAAI;KACL,CAAA;AACH,CAAC"}

package/dist/lib/kuva.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Kuva Terminal Plotting
+ *
+ * Pipes structured data to the kuva CLI for terminal-rendered plots.
+ * Kuva is a Rust scientific plotting tool (github.com/Psy-Fer/kuva).
+ *
+ * @purpose Bridge between JFL data (telemetry, arena, RL, events) and terminal visualization via kuva
+ */
+export interface BarEntry {
+    label: string;
+    value: number;
+}
+export interface ScatterPoint {
+    x: number;
+    y: number;
+    label?: string;
+}
+export interface TimeSeriesPoint {
+    ts: string;
+    value: number;
+    series?: string;
+}
+export declare function isKuvaInstalled(): boolean;
+export declare function barChart(entries: BarEntry[], title?: string): string | null;
+export declare function scatterPlot(points: ScatterPoint[], title?: string): string | null;
+export declare function linePlot(points: TimeSeriesPoint[], title?: string): string | null;
+/**
+ * Render a simple ASCII bar chart without kuva dependency.
+ * Fallback for when kuva isn't installed, and useful for agents
+ * that want zero-dependency terminal visualization.
+ */
+export declare function asciiBars(entries: BarEntry[], opts?: {
+    width?: number;
+    title?: string;
+}): string;
+/**
+ * Render a sparkline for time-series data.
+ * Single line of Unicode block characters showing trend.
+ */
+export declare function sparkline(values: number[]): string;
+/**
+ * Render data using kuva if available, fall back to ASCII.
+ */
+export declare function renderBars(entries: BarEntry[], title?: string): string;
+//# sourceMappingURL=kuva.d.ts.map

package/dist/lib/kuva.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kuva.d.ts","sourceRoot":"","sources":["../../src/lib/kuva.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAsBD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYjF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAejF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiBhG;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAOlD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAMtE"}