pulseed 0.0.1 → 0.1.0

package/dist/tui/seedy-art.js

@@ -0,0 +1,141 @@
+/**
+ * Seedy — PulSeed mascot pixel art
+ *
+ * A cute round cream/white seed with a green sprout on top and two black oval eyes.
+ * Uses Unicode box-drawing / block characters and ANSI 24-bit color escape codes.
+ *
+ * Sizes:
+ *   small  — ~7 terminal lines, suitable for status bars and inline use
+ *   medium — ~12 terminal lines, suitable for splash screens and help views
+ *
+ * States (small size only; medium falls back to default):
+ *   default  — neutral ● eyes, small ▾ mouth
+ *   thinking — upward-tilted ◝◞ eyes, dot trail
+ *   success  — closed ^ ^ eyes, ‿ smile
+ *   error    — > < stressed eyes, ︵ frown
+ *   active   — ★ sparkle eyes, tilted stem
+ */
+// ---------------------------------------------------------------------------
+// ANSI color helpers
+// ---------------------------------------------------------------------------
+const R = "\x1b[0m"; // reset all attributes
+const CREAM = "\x1b[38;2;245;240;232m"; // #F5F0E8 — body
+const GREEN = "\x1b[38;2;76;175;80m"; // #4CAF50 — leaves
+const STEM = "\x1b[38;2;102;187;106m"; // #66BB6A — stem
+const BLACK = "\x1b[38;2;30;30;30m"; // near-black — eyes
+const BLUSH = "\x1b[38;2;255;182;193m"; // pink — cheek blush
+// Colorizer shortcuts
+const c = (s) => CREAM + s + R;
+const g = (s) => GREEN + s + R;
+const s = (s) => STEM + s + R;
+const e = (s) => BLACK + s + R;
+const b = (s) => BLUSH + s + R;
+// ---------------------------------------------------------------------------
+// SEEDY_SMALL  (~7 lines)
+// ---------------------------------------------------------------------------
+export const SEEDY_SMALL = `    ${s("│")}    \n` +
+    `  ${g("╭╩╮")}   \n` +
+    ` ${c("╭─────╮")}  \n` +
+    ` ${c("│")} ${e("●")} ${c("●")} ${c("│")}  \n` +
+    ` ${c("│  ▾  │")}  \n` +
+    ` ${c("╰─────╯")}  \n` +
+    `  ${c("╰───╯")}   `;
+// ---------------------------------------------------------------------------
+// SEEDY_MEDIUM  (~12 lines)
+// ---------------------------------------------------------------------------
+export const SEEDY_MEDIUM = `      ${s("│")}      \n` +
+    `    ${g("╭╩─╮")}    \n` +
+    `  ${g("╭─╯")}  ${g("╰─╮")}  \n` +
+    `   ${g("╰──┬──╯")}   \n` +
+    `  ${c("╭───────╮")}  \n` +
+    ` ${c("╭─────────╮")} \n` +
+    ` ${c("│")} ${e("◉")} ${c("   ")} ${e("◉")} ${c("│")} \n` +
+    ` ${c("│  ")}${b("·")}${c("     ")}${b("·")}${c("  │")} \n` +
+    ` ${c("│    ‿    │")} \n` +
+    ` ${c("╰─────────╯")} \n` +
+    `  ${c("╰───────╯")}  `;
+// ---------------------------------------------------------------------------
+// State variants  (SMALL size)
+// ---------------------------------------------------------------------------
+/** Eyes tilted up-right — Seedy is thinking */
+export const SEEDY_THINKING = `    ${s("│")}    \n` +
+    `  ${g("╭╩╮")}   \n` +
+    ` ${c("╭─────╮")}  \n` +
+    ` ${c("│")} ${e("◝")} ${c("◞")} ${c("│")}  \n` +
+    ` ${c("│  ···│")}  \n` +
+    ` ${c("╰─────╯")}  \n` +
+    `  ${c("╰───╯")}   `;
+/** Closed ^ ^ eyes with ‿ smile — success */
+export const SEEDY_SUCCESS = `    ${s("│")}    \n` +
+    `  ${g("╭╩╮")}   \n` +
+    ` ${c("╭─────╮")}  \n` +
+    ` ${c("│")} ${e("^")} ${c("^")} ${c("│")}  \n` +
+    ` ${c("│")}  ${c("‿")}  ${c("│")}  \n` +
+    ` ${c("╰─────╯")}  \n` +
+    `  ${c("╰───╯")}   `;
+/** Stressed > < eyes with ︵ frown — error */
+export const SEEDY_ERROR = `    ${s("│")}    \n` +
+    `  ${g("╭╩╮")}   \n` +
+    ` ${c("╭─────╮")}  \n` +
+    ` ${c("│")} ${e(">")} ${c("<")} ${c("│")}  \n` +
+    ` ${c("│")}  ${c("︵")}  ${c("│")}  \n` +
+    ` ${c("╰─────╯")}  \n` +
+    `  ${c("╰───╯")}   `;
+/** Tilted stem, ★ sparkle eyes — actively running */
+export const SEEDY_ACTIVE = `   ${s("╱")}${g("❧")}    \n` +
+    `  ${g("╭╩╮")}   \n` +
+    ` ${c("╭─────╮")}  \n` +
+    ` ${c("│")} ${e("★")} ${c("★")} ${c("│")}  \n` +
+    ` ${c("│  ‿  │")}  \n` +
+    ` ${c("╰─────╯")}  \n` +
+    `  ${c("╰───╯")}   `;
+// ---------------------------------------------------------------------------
+// Plain ASCII  (no ANSI — for logs, markdown, non-color terminals)
+// ---------------------------------------------------------------------------
+/** Full ASCII Seedy, 8 lines, no color codes */
+export const SEEDY_ASCII = [
+    "    |    ",
+    "  (╚╦╗)  ",
+    " /       \\",
+    "|  o   o  |",
+    "|    ‿    |",
+    " \\       /",
+    "  \\_____/ ",
+].join("\n");
+/** Compact 5-line ASCII Seedy */
+export const SEEDY_ASCII_COMPACT = [
+    "  |  ",
+    "(╚╗) ",
+    "(o o)",
+    "( ‿ )",
+    "\\___/",
+].join("\n");
+/**
+ * Returns the ANSI-colored Seedy art string for a given state and size.
+ *
+ * @param state  - Emotional/activity state of Seedy (default: 'default')
+ * @param size   - 'small' (~7 lines) or 'medium' (~12 lines) (default: 'small')
+ * @returns Multi-line string with embedded ANSI escape codes
+ *
+ * @example
+ * console.log(getSeedyArt('success', 'small'));
+ * console.log(getSeedyArt('default', 'medium'));
+ */
+export function getSeedyArt(state = "default", size = "small") {
+    if (size === "medium") {
+        return SEEDY_MEDIUM; // medium only has a default variant
+    }
+    switch (state) {
+        case "thinking":
+            return SEEDY_THINKING;
+        case "success":
+            return SEEDY_SUCCESS;
+        case "error":
+            return SEEDY_ERROR;
+        case "active":
+            return SEEDY_ACTIVE;
+        default:
+            return SEEDY_SMALL;
+    }
+}
+//# sourceMappingURL=seedy-art.js.map

package/dist/tui/seedy-art.js.map

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

package/dist/tui/use-loop.d.ts

@@ -0,0 +1,54 @@
+import type { CoreLoop, LoopResult } from "../core-loop.js";
+import type { StateManager } from "../state-manager.js";
+import type { TrustManager } from "../traits/trust-manager.js";
+import type { Threshold } from "../types/core.js";
+export interface LoopState {
+    running: boolean;
+    goalId: string | null;
+    iteration: number;
+    /** "idle" | "running" | "completed" | "stalled" | "error" | "stopped" | "max_iterations" */
+    status: string;
+    dimensions: DimensionProgress[];
+    trustScore: number;
+    startedAt: string | null;
+    lastResult: LoopResult | null;
+    lastError?: string;
+}
+export interface DimensionProgress {
+    name: string;
+    displayName: string;
+    currentValue: unknown;
+    threshold: unknown;
+    progress: number;
+}
+/**
+ * Calculate 0-100 progress for a single dimension based on its threshold type
+ * and current_value.
+ */
+export declare function calcDimensionProgress(currentValue: unknown, threshold: Threshold): number;
+export declare class LoopController {
+    private coreLoop;
+    private stateManager;
+    private trustManager;
+    private state;
+    private onUpdate;
+    private pollInterval;
+    constructor(coreLoop: CoreLoop, stateManager: StateManager, trustManager: TrustManager);
+    getState(): LoopState;
+    setOnUpdate(cb: ((state: LoopState) => void) | null): void;
+    start(goalId: string): Promise<void>;
+    stop(): void;
+    refreshState(goalId: string): Promise<void>;
+    private setState;
+    private clearPoll;
+}
+export interface UseLoopResult {
+    loopState: LoopState;
+    start: (goalId: string) => void;
+    stop: () => void;
+    /** Register a callback that will be invoked whenever a LoopController
+     *  onUpdate notification would have fired (used by entry.ts approval wiring). */
+    getController: () => LoopController;
+}
+export declare function useLoop(coreLoop: CoreLoop, stateManager: StateManager, trustManager: TrustManager): UseLoopResult;
+//# sourceMappingURL=use-loop.d.ts.map

package/dist/tui/use-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-loop.d.ts","sourceRoot":"","sources":["../../src/tui/use-loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,SAAS,GACnB,MAAM,CAqCR;AAgBD,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IAPtB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,YAAY,CAA+C;gBAGzD,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY;IAcpC,QAAQ,IAAI,SAAS;IAIrB,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAIpD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6C1C,IAAI,IAAI,IAAI;IAMN,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjD,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,SAAS;CAMlB;AAWD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB;qFACiF;IACjF,aAAa,EAAE,MAAM,cAAc,CAAC;CACrC;AAED,wBAAgB,OAAO,CACrB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,GACzB,aAAa,CAgCf"}

package/dist/tui/use-loop.js

@@ -0,0 +1,185 @@
+import { useState, useEffect, useRef, useCallback } from "react";
+// ─── Progress Calculation ───
+/**
+ * Calculate 0-100 progress for a single dimension based on its threshold type
+ * and current_value.
+ */
+export function calcDimensionProgress(currentValue, threshold) {
+    if (currentValue === null || currentValue === undefined) {
+        return 0;
+    }
+    switch (threshold.type) {
+        case "present": {
+            const truthy = currentValue !== false &&
+                currentValue !== 0 &&
+                currentValue !== "" &&
+                currentValue !== null;
+            return truthy ? 100 : 0;
+        }
+        case "match": {
+            return currentValue === threshold.value ? 100 : 0;
+        }
+        case "min": {
+            const cur = toNum(currentValue);
+            if (threshold.value === 0)
+                return cur >= 0 ? 100 : 0;
+            return Math.min(100, Math.max(0, Math.round((cur / threshold.value) * 100)));
+        }
+        case "max": {
+            const cur = toNum(currentValue);
+            // For max thresholds: being at or below the target is 100%.
+            // Being over the target reduces progress.
+            if (cur <= threshold.value)
+                return 100;
+            if (threshold.value === 0)
+                return 0;
+            // Clamp: once current is 2x target, treat as 0%
+            const excess = cur - threshold.value;
+            return Math.max(0, Math.round((1 - excess / threshold.value) * 100));
+        }
+        case "range": {
+            const cur = toNum(currentValue);
+            return cur >= threshold.low && cur <= threshold.high ? 100 : 0;
+        }
+    }
+}
+function toNum(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "boolean")
+        return value ? 1 : 0;
+    if (typeof value === "string") {
+        const n = Number(value);
+        return isNaN(n) ? 0 : n;
+    }
+    return 0;
+}
+// ─── LoopController ───
+const POLL_INTERVAL_MS = 2000;
+export class LoopController {
+    coreLoop;
+    stateManager;
+    trustManager;
+    state;
+    onUpdate = null;
+    pollInterval = null;
+    constructor(coreLoop, stateManager, trustManager) {
+        this.coreLoop = coreLoop;
+        this.stateManager = stateManager;
+        this.trustManager = trustManager;
+        this.state = {
+            running: false,
+            goalId: null,
+            iteration: 0,
+            status: "idle",
+            dimensions: [],
+            trustScore: 0,
+            startedAt: null,
+            lastResult: null,
+        };
+    }
+    getState() {
+        return this.state;
+    }
+    setOnUpdate(cb) {
+        this.onUpdate = cb;
+    }
+    async start(goalId) {
+        if (this.state.running)
+            return;
+        this.setState({
+            running: true,
+            goalId,
+            iteration: 0,
+            status: "running",
+            startedAt: new Date().toISOString(),
+            lastResult: null,
+        });
+        // Initial dimension refresh (awaited so dimensions are populated before polling starts)
+        await this.refreshState(goalId);
+        // Start polling
+        this.pollInterval = setInterval(() => {
+            if (this.state.goalId) {
+                this.refreshState(this.state.goalId);
+            }
+        }, POLL_INTERVAL_MS);
+        // Fire-and-forget: capture result when loop completes
+        this.coreLoop.run(goalId).then((result) => {
+            this.clearPoll();
+            this.setState({
+                running: false,
+                status: result.finalStatus,
+                iteration: result.totalIterations,
+                lastResult: result,
+            });
+            // Final refresh to show end state
+            this.refreshState(goalId);
+        }).catch((err) => {
+            this.clearPoll();
+            const msg = err instanceof Error ? err.message : String(err);
+            this.setState({
+                running: false,
+                status: "error",
+                lastResult: null,
+                lastError: msg,
+            });
+        });
+    }
+    stop() {
+        this.coreLoop.stop();
+        this.clearPoll();
+        this.setState({ running: false, status: "stopped", goalId: null });
+    }
+    async refreshState(goalId) {
+        const goal = await this.stateManager.loadGoal(goalId);
+        if (!goal)
+            return;
+        const dimensions = goal.dimensions.map((dim) => ({
+            name: dim.name,
+            displayName: dim.label,
+            currentValue: dim.current_value,
+            threshold: dim.threshold,
+            progress: calcDimensionProgress(dim.current_value, dim.threshold),
+        }));
+        const trustScore = (await this.trustManager.getBalance(goalId)).balance;
+        this.setState({ dimensions, trustScore });
+    }
+    // ─── Private ───
+    setState(partial) {
+        this.state = { ...this.state, ...partial };
+        if (this.onUpdate) {
+            this.onUpdate(this.state);
+        }
+    }
+    clearPoll() {
+        if (this.pollInterval !== null) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = null;
+        }
+    }
+}
+export function useLoop(coreLoop, stateManager, trustManager) {
+    // Stable controller reference — created once per mount
+    const controllerRef = useRef(null);
+    if (controllerRef.current === null) {
+        controllerRef.current = new LoopController(coreLoop, stateManager, trustManager);
+    }
+    const controller = controllerRef.current;
+    const [loopState, setLoopState] = useState(() => controller.getState());
+    useEffect(() => {
+        controller.setOnUpdate(setLoopState);
+        return () => {
+            controller.setOnUpdate(null);
+            controller.stop();
+        };
+    }, [controller]);
+    const start = useCallback((goalId) => {
+        void controller.start(goalId);
+    }, [controller]);
+    const stop = useCallback(() => {
+        controller.stop();
+    }, [controller]);
+    const getController = useCallback(() => controller, [controller]);
+    return { loopState, start, stop, getController };
+}
+//# sourceMappingURL=use-loop.js.map

package/dist/tui/use-loop.js.map

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