pulseed 0.0.1 → 0.1.1

package/dist/llm/provider-factory.js

@@ -0,0 +1,135 @@
+// ─── Provider Factory ───
+//
+// Shared factory helpers for building LLM clients and adapter registries.
+// Used by both CLIRunner and TUI entry to avoid duplicating wiring logic.
+import { LLMClient } from "./llm-client.js";
+import { LLMError } from "../utils/errors.js";
+import { OllamaLLMClient } from "./ollama-client.js";
+import { OpenAILLMClient } from "./openai-client.js";
+import { CodexLLMClient } from "./codex-llm-client.js";
+import { loadProviderConfig } from "./provider-config.js";
+import { AdapterRegistry } from "../execution/adapter-layer.js";
+import { ClaudeCodeCLIAdapter } from "../adapters/claude-code-cli.js";
+import { ClaudeAPIAdapter } from "../adapters/claude-api.js";
+import { OpenAICodexCLIAdapter } from "../adapters/openai-codex.js";
+import { GitHubIssueAdapter } from "../adapters/github-issue.js";
+import { A2AAdapter } from "../adapters/a2a-adapter.js";
+import { BrowserUseCLIAdapter } from "../adapters/browser-use-cli.js";
+import { OpenClawACPAdapter } from "../adapters/openclaw-acp.js";
+/**
+ * Build an LLM client based on provider configuration.
+ *
+ * Configuration priority (highest to lowest):
+ *   1. PULSEED_PROVIDER environment variable
+ *   2. ~/.pulseed/provider.json provider field
+ *   3. Default: OpenAI
+ *
+ * Providers:
+ *   - "anthropic" → LLMClient (api_key required)
+ *   - "openai"    → OpenAILLMClient or CodexLLMClient depending on adapter
+ *   - "ollama"    → OllamaLLMClient
+ */
+export async function buildLLMClient() {
+    const config = await loadProviderConfig();
+    switch (config.provider) {
+        case "openai": {
+            // Use CodexLLMClient when adapter is openai_codex_cli
+            if (config.adapter === "openai_codex_cli") {
+                if (!config.api_key) {
+                    throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+                }
+                return new CodexLLMClient({
+                    cliPath: config.codex_cli_path,
+                    model: config.model,
+                    lightModel: config.light_model,
+                });
+            }
+            // Otherwise use OpenAILLMClient
+            if (!config.api_key) {
+                throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+            }
+            return new OpenAILLMClient({
+                apiKey: config.api_key,
+                model: config.model,
+                baseURL: config.base_url,
+                lightModel: config.light_model,
+            });
+        }
+        case "ollama":
+            return new OllamaLLMClient({
+                baseUrl: config.base_url ?? "http://localhost:11434",
+                model: config.model ?? "qwen3:4b",
+                lightModel: config.light_model,
+            });
+        case "anthropic":
+            if (!config.api_key) {
+                throw new LLMError("ANTHROPIC_API_KEY is not set.\nSet it via: export ANTHROPIC_API_KEY=sk-ant-...");
+            }
+            return new LLMClient(config.api_key, undefined, config.light_model);
+        default:
+            // Unknown provider falls back to OpenAI
+            if (!config.api_key) {
+                throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+            }
+            return new OpenAILLMClient({
+                apiKey: config.api_key,
+                model: config.model,
+                baseURL: config.base_url,
+                lightModel: config.light_model,
+            });
+    }
+}
+/**
+ * Build an AdapterRegistry pre-populated with the standard adapters.
+ * Registers ClaudeCodeCLIAdapter, ClaudeAPIAdapter, OpenAICodexCLIAdapter, GitHubIssueAdapter,
+ * and any A2A agents configured in provider config or environment variables.
+ */
+export async function buildAdapterRegistry(llmClient, providerConfig) {
+    const registry = new AdapterRegistry();
+    registry.register(new ClaudeCodeCLIAdapter());
+    registry.register(new ClaudeAPIAdapter(llmClient));
+    registry.register(new OpenAICodexCLIAdapter());
+    registry.register(new GitHubIssueAdapter());
+    registry.register(new BrowserUseCLIAdapter());
+    // Register A2A agents from config
+    const config = providerConfig ?? await loadProviderConfig();
+    if (config.a2a?.agents) {
+        for (const [name, agentConfig] of Object.entries(config.a2a.agents)) {
+            registry.register(new A2AAdapter({
+                adapterType: name.startsWith("a2a") ? name : `a2a_${name}`,
+                baseUrl: agentConfig.base_url,
+                authToken: agentConfig.auth_token,
+                capabilities: agentConfig.capabilities,
+                preferStreaming: agentConfig.prefer_streaming,
+                pollIntervalMs: agentConfig.poll_interval_ms,
+                maxWaitMs: agentConfig.max_wait_ms,
+            }));
+        }
+    }
+    // Single-agent env var shortcut
+    const envBaseUrl = process.env["PULSEED_A2A_BASE_URL"];
+    if (envBaseUrl && !config.a2a?.agents) {
+        registry.register(new A2AAdapter({
+            baseUrl: envBaseUrl,
+            authToken: process.env["PULSEED_A2A_AUTH_TOKEN"],
+        }));
+    }
+    // OpenClaw from provider config
+    if (config.openclaw) {
+        registry.register(new OpenClawACPAdapter({
+            cliPath: config.openclaw.cli_path,
+            profile: config.openclaw.profile,
+            model: config.openclaw.model,
+            workDir: config.openclaw.work_dir,
+        }));
+    }
+    // Environment variable shortcut
+    if (process.env["PULSEED_OPENCLAW_CLI_PATH"] && !config.openclaw) {
+        registry.register(new OpenClawACPAdapter({
+            cliPath: process.env["PULSEED_OPENCLAW_CLI_PATH"],
+            profile: process.env["PULSEED_OPENCLAW_PROFILE"],
+        }));
+    }
+    return registry;
+}
+//# sourceMappingURL=provider-factory.js.map

package/dist/llm/provider-factory.js.map

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

package/dist/llm-client.d.ts

@@ -0,0 +1,65 @@
+import type { ZodSchema } from "zod";
+export interface LLMMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export interface LLMRequestOptions {
+    model?: string;
+    max_tokens?: number;
+    system?: string;
+    temperature?: number;
+}
+export interface LLMResponse {
+    content: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    stop_reason: string;
+}
+export interface ILLMClient {
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+}
+/**
+ * Extract JSON from a string that may contain markdown code blocks.
+ * Tries ```json ... ``` first, then ``` ... ```, then bare JSON.
+ */
+export declare function extractJSON(text: string): string;
+/**
+ * Thin wrapper around the Anthropic SDK.
+ * Provides retry logic and JSON extraction/validation.
+ *
+ * Constructor throws if no API key is available (no param, no env var).
+ */
+export declare class LLMClient implements ILLMClient {
+    private readonly client;
+    constructor(apiKey?: string);
+    /**
+     * Send a message to the Anthropic API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    /**
+     * Extract JSON from LLM response text (handles markdown code blocks)
+     * and validate against the given Zod schema.
+     * Throws on parse failure or schema validation failure.
+     */
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+}
+/**
+ * Mock implementation for testing.
+ * Returns provided responses in order, tracking call count.
+ */
+export declare class MockLLMClient implements ILLMClient {
+    private readonly responses;
+    private _callCount;
+    constructor(responses: string[]);
+    get callCount(): number;
+    sendMessage(_messages: LLMMessage[], _options?: LLMRequestOptions): Promise<LLMResponse>;
+    /**
+     * Delegates to real JSON extraction and Zod validation.
+     */
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+}
+//# sourceMappingURL=llm-client.d.ts.map

package/dist/llm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../src/llm-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAIrC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,UAAU;IACzB,WAAW,CACT,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACxD;AAkBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAehD;AAID;;;;;GAKG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,MAAM,CAAC,EAAE,MAAM;IAU3B;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;IA2CvB;;;;OAIG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;CAYvD;AAID;;;GAGG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,UAAU,CAAa;gBAEnB,SAAS,EAAE,MAAM,EAAE;IAI/B,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,WAAW,CACf,SAAS,EAAE,UAAU,EAAE,EACvB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC;IAsBvB;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;CAYvD"}

package/dist/llm-client.js

@@ -0,0 +1,151 @@
+import Anthropic from "@anthropic-ai/sdk";
+// ─── Constants ───
+const DEFAULT_MODEL = "claude-sonnet-4-20250514";
+const DEFAULT_MAX_TOKENS = 4096;
+const DEFAULT_TEMPERATURE = 0;
+const MAX_RETRY_ATTEMPTS = 3;
+/** Exponential backoff delays in milliseconds: 1s, 2s, 4s */
+const RETRY_DELAYS_MS = [1000, 2000, 4000];
+// ─── Helpers ───
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Extract JSON from a string that may contain markdown code blocks.
+ * Tries ```json ... ``` first, then ``` ... ```, then bare JSON.
+ */
+export function extractJSON(text) {
+    // Try ```json ... ``` block
+    const jsonBlock = text.match(/```json\s*([\s\S]*?)```/);
+    if (jsonBlock) {
+        return jsonBlock[1].trim();
+    }
+    // Try generic ``` ... ``` block
+    const genericBlock = text.match(/```\s*([\s\S]*?)```/);
+    if (genericBlock) {
+        return genericBlock[1].trim();
+    }
+    // Return as-is (bare JSON)
+    return text.trim();
+}
+// ─── LLMClient ───
+/**
+ * Thin wrapper around the Anthropic SDK.
+ * Provides retry logic and JSON extraction/validation.
+ *
+ * Constructor throws if no API key is available (no param, no env var).
+ */
+export class LLMClient {
+    client;
+    constructor(apiKey) {
+        const key = apiKey ?? process.env["ANTHROPIC_API_KEY"];
+        if (!key) {
+            throw new Error("LLMClient: no API key provided. Pass apiKey to constructor or set ANTHROPIC_API_KEY env var.");
+        }
+        this.client = new Anthropic({ apiKey: key });
+    }
+    /**
+     * Send a message to the Anthropic API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff.
+     */
+    async sendMessage(messages, options) {
+        const model = options?.model ?? DEFAULT_MODEL;
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        const system = options?.system;
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRY_ATTEMPTS; attempt++) {
+            try {
+                const response = await this.client.messages.create({
+                    model,
+                    max_tokens,
+                    temperature,
+                    ...(system ? { system } : {}),
+                    messages: messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                });
+                const block = response.content[0];
+                const content = block && block.type === "text" ? block.text : "";
+                return {
+                    content,
+                    usage: {
+                        input_tokens: response.usage.input_tokens,
+                        output_tokens: response.usage.output_tokens,
+                    },
+                    stop_reason: response.stop_reason ?? "unknown",
+                };
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt < MAX_RETRY_ATTEMPTS - 1) {
+                    await sleep(RETRY_DELAYS_MS[attempt] ?? 1000);
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Extract JSON from LLM response text (handles markdown code blocks)
+     * and validate against the given Zod schema.
+     * Throws on parse failure or schema validation failure.
+     */
+    parseJSON(content, schema) {
+        const jsonText = extractJSON(content);
+        let raw;
+        try {
+            raw = JSON.parse(jsonText);
+        }
+        catch (err) {
+            throw new Error(`LLMClient.parseJSON: failed to parse JSON — ${String(err)}\nContent: ${content}`);
+        }
+        return schema.parse(raw);
+    }
+}
+// ─── MockLLMClient ───
+/**
+ * Mock implementation for testing.
+ * Returns provided responses in order, tracking call count.
+ */
+export class MockLLMClient {
+    responses;
+    _callCount = 0;
+    constructor(responses) {
+        this.responses = responses;
+    }
+    get callCount() {
+        return this._callCount;
+    }
+    async sendMessage(_messages, _options) {
+        const index = this._callCount;
+        this._callCount++;
+        if (index >= this.responses.length) {
+            throw new Error(`MockLLMClient: no response at index ${index} (only ${this.responses.length} responses configured)`);
+        }
+        const content = this.responses[index];
+        return {
+            content,
+            usage: {
+                input_tokens: 10,
+                output_tokens: content.length,
+            },
+            stop_reason: "end_turn",
+        };
+    }
+    /**
+     * Delegates to real JSON extraction and Zod validation.
+     */
+    parseJSON(content, schema) {
+        const jsonText = extractJSON(content);
+        let raw;
+        try {
+            raw = JSON.parse(jsonText);
+        }
+        catch (err) {
+            throw new Error(`MockLLMClient.parseJSON: failed to parse JSON — ${String(err)}\nContent: ${content}`);
+        }
+        return schema.parse(raw);
+    }
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/llm-client.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,30 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LoggerConfig {
+    dir: string;
+    maxSizeMB?: number;
+    maxFiles?: number;
+    level?: LogLevel;
+    consoleOutput?: boolean;
+    rotateByDate?: boolean;
+}
+export declare class Logger {
+    private dir;
+    private maxSizeBytes;
+    private maxFiles;
+    private level;
+    private consoleOutput;
+    private rotateByDate;
+    private currentFile;
+    private lastWriteDate;
+    constructor(config: LoggerConfig);
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    private log;
+    private writeToFile;
+    private getCurrentDate;
+    private rotateCurrent;
+    private rotateIfNeeded;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS3D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAuB;gBAEhC,MAAM,EAAE,YAAY;IAahC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,OAAO,CAAC,GAAG;IAmBX,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,cAAc;CA2CvB"}

package/dist/logger.js

@@ -0,0 +1,121 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+export class Logger {
+    dir;
+    maxSizeBytes;
+    maxFiles;
+    level;
+    consoleOutput;
+    rotateByDate;
+    currentFile;
+    lastWriteDate = null;
+    constructor(config) {
+        this.dir = config.dir;
+        this.maxSizeBytes = (config.maxSizeMB ?? 10) * 1024 * 1024;
+        this.maxFiles = config.maxFiles ?? 5;
+        this.level = LOG_LEVELS[config.level ?? "info"];
+        this.consoleOutput = config.consoleOutput ?? true;
+        this.rotateByDate = config.rotateByDate ?? true;
+        this.currentFile = path.join(this.dir, "motiva.log");
+        // Ensure log directory exists
+        fs.mkdirSync(this.dir, { recursive: true });
+    }
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(message, context) {
+        this.log("error", message, context);
+    }
+    log(level, message, context) {
+        if (LOG_LEVELS[level] < this.level)
+            return;
+        const timestamp = new Date().toISOString();
+        const contextStr = context ? " " + JSON.stringify(context) : "";
+        const line = `[${timestamp}] [${level.toUpperCase().padEnd(5)}] ${message}${contextStr}\n`;
+        // Console output
+        if (this.consoleOutput) {
+            const consoleFn = level === "error" ? console.error
+                : level === "warn" ? console.warn
+                    : console.log;
+            consoleFn(line.trimEnd());
+        }
+        // File output
+        this.writeToFile(line);
+    }
+    writeToFile(line) {
+        try {
+            // Check if rotation needed
+            this.rotateIfNeeded();
+            // Append to current log file
+            fs.appendFileSync(this.currentFile, line, "utf-8");
+        }
+        catch {
+            // Silently fail file writes (don't crash daemon for logging issues)
+        }
+    }
+    // Returns the current date as YYYY-MM-DD (overridable for testing via vi.setSystemTime)
+    getCurrentDate() {
+        return new Date().toISOString().slice(0, 10);
+    }
+    rotateCurrent(destName) {
+        // Rename the current motiva.log to destName (e.g. motiva.1.log or motiva.2026-03-16.log)
+        fs.renameSync(this.currentFile, path.join(this.dir, destName));
+    }
+    rotateIfNeeded() {
+        try {
+            // ── Date-based rotation ──────────────────────────────────────────────
+            // Run regardless of whether the current file exists yet (lastWriteDate
+            // must be initialized even before the first byte is written).
+            if (this.rotateByDate) {
+                const today = this.getCurrentDate();
+                if (this.lastWriteDate === null) {
+                    // First write: just record the date, no rotation
+                    this.lastWriteDate = today;
+                }
+                else if (this.lastWriteDate !== today) {
+                    // Date changed: rename existing file to motiva.YYYY-MM-DD.log
+                    if (fs.existsSync(this.currentFile)) {
+                        this.rotateCurrent(`motiva.${this.lastWriteDate}.log`);
+                    }
+                    this.lastWriteDate = today;
+                    return; // file was rotated (or didn't exist); fresh motiva.log created on append
+                }
+            }
+            // ── Size-based rotation ──────────────────────────────────────────────
+            if (!fs.existsSync(this.currentFile))
+                return;
+            const stat = fs.statSync(this.currentFile);
+            if (stat.size < this.maxSizeBytes)
+                return;
+            // Rotate: motiva.4.log -> delete, motiva.3.log -> motiva.4.log, etc.
+            for (let i = this.maxFiles - 1; i >= 1; i--) {
+                const older = path.join(this.dir, `motiva.${i + 1}.log`);
+                const newer = path.join(this.dir, `motiva.${i}.log`);
+                if (i === this.maxFiles - 1 && fs.existsSync(older)) {
+                    fs.unlinkSync(older);
+                }
+                if (fs.existsSync(newer)) {
+                    fs.renameSync(newer, older);
+                }
+            }
+            // Current -> motiva.1.log
+            fs.renameSync(this.currentFile, path.join(this.dir, "motiva.1.log"));
+        }
+        catch {
+            // Ignore rotation errors
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/loop/checkpoint-manager-loop.d.ts

@@ -0,0 +1,28 @@
+/**
+ * checkpoint-manager-loop.ts
+ *
+ * Loop-level checkpoint save/restore for crash recovery (§4.8).
+ *
+ * NOTE: This is distinct from CheckpointManager in src/execution/checkpoint-manager.ts,
+ * which handles multi-agent session transfer. This module handles dimension value and
+ * trust balance snapshots for crash recovery within a single run.
+ */
+import type { StateManager } from "../state-manager.js";
+import type { TrustManager } from "../traits/trust-manager.js";
+import type { LoopIterationResult } from "./core-loop-types.js";
+import type { Logger } from "../runtime/logger.js";
+/**
+ * Save a checkpoint after a successful verify step.
+ * Records dimension values, trust balance, and cycle number.
+ * Non-fatal: checkpoint save failures do not abort the run.
+ */
+export declare function saveLoopCheckpoint(stateManager: StateManager, goalId: string, loopIndex: number, iterationResult: LoopIterationResult, adapterType: string, trustManager: TrustManager | undefined, logger: Logger | undefined): Promise<void>;
+/**
+ * Restore dimension values and trust balance from a checkpoint if one exists.
+ * Delegates to StateManager.restoreFromCheckpoint which uses Zod validation.
+ * Returns the saved cycle_number so the caller can resume iteration counting,
+ * or 0 if no checkpoint exists or restore fails.
+ * Non-fatal: restore failures do not abort the run.
+ */
+export declare function restoreLoopCheckpoint(stateManager: StateManager, goalId: string, adapterType: string, trustManager: TrustManager | undefined): Promise<number>;
+//# sourceMappingURL=checkpoint-manager-loop.d.ts.map

package/dist/loop/checkpoint-manager-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager-loop.d.ts","sourceRoot":"","sources":["../../src/loop/checkpoint-manager-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,mBAAmB,EACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/loop/checkpoint-manager-loop.js

@@ -0,0 +1,62 @@
+/**
+ * checkpoint-manager-loop.ts
+ *
+ * Loop-level checkpoint save/restore for crash recovery (§4.8).
+ *
+ * NOTE: This is distinct from CheckpointManager in src/execution/checkpoint-manager.ts,
+ * which handles multi-agent session transfer. This module handles dimension value and
+ * trust balance snapshots for crash recovery within a single run.
+ */
+/**
+ * Save a checkpoint after a successful verify step.
+ * Records dimension values, trust balance, and cycle number.
+ * Non-fatal: checkpoint save failures do not abort the run.
+ */
+export async function saveLoopCheckpoint(stateManager, goalId, loopIndex, iterationResult, adapterType, trustManager, logger) {
+    try {
+        const currentGoalForCp = await stateManager.readRaw(`goals/${goalId}/goal.json`);
+        const dimensionSnapshot = {};
+        if (currentGoalForCp && typeof currentGoalForCp === "object") {
+            const dims = currentGoalForCp.dimensions;
+            if (dims) {
+                for (const dim of dims) {
+                    if (typeof dim.name === "string" && typeof dim.current_value === "number") {
+                        dimensionSnapshot[dim.name] = dim.current_value;
+                    }
+                }
+            }
+        }
+        let trustSnapshot;
+        if (trustManager) {
+            try {
+                const trustBalance = await trustManager.getBalance(adapterType);
+                trustSnapshot = trustBalance.balance;
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+        await stateManager.writeRaw(`goals/${goalId}/checkpoint.json`, {
+            cycle_number: loopIndex + 1,
+            last_verified_task_id: iterationResult.taskResult?.task.id,
+            dimension_snapshot: dimensionSnapshot,
+            trust_snapshot: trustSnapshot,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    catch {
+        // Checkpoint save failure is non-fatal
+        logger?.warn("saveLoopCheckpoint: failed to save checkpoint", { goalId });
+    }
+}
+/**
+ * Restore dimension values and trust balance from a checkpoint if one exists.
+ * Delegates to StateManager.restoreFromCheckpoint which uses Zod validation.
+ * Returns the saved cycle_number so the caller can resume iteration counting,
+ * or 0 if no checkpoint exists or restore fails.
+ * Non-fatal: restore failures do not abort the run.
+ */
+export async function restoreLoopCheckpoint(stateManager, goalId, adapterType, trustManager) {
+    return stateManager.restoreFromCheckpoint(goalId, adapterType, trustManager);
+}
+//# sourceMappingURL=checkpoint-manager-loop.js.map

package/dist/loop/checkpoint-manager-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager-loop.js","sourceRoot":"","sources":["../../src/loop/checkpoint-manager-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAA0B,EAC1B,MAAc,EACd,SAAiB,EACjB,eAAoC,EACpC,WAAmB,EACnB,YAAsC,EACtC,MAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,MAAM,YAAY,CAAC,CAAC;QACjF,MAAM,iBAAiB,GAA2B,EAAE,CAAC;QACrD,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAI,gBAA4C,CAAC,UAE9C,CAAC;YACd,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;wBAC1E,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC;oBAClD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,aAAiC,CAAC;QACtC,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;gBAChE,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QACD,MAAM,YAAY,CAAC,QAAQ,CAAC,SAAS,MAAM,kBAAkB,EAAE;YAC7D,YAAY,EAAE,SAAS,GAAG,CAAC;YAC3B,qBAAqB,EAAE,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;YAC1D,kBAAkB,EAAE,iBAAiB;YACrC,cAAc,EAAE,aAAa;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;QACvC,MAAM,EAAE,IAAI,CAAC,+CAA+C,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAA0B,EAC1B,MAAc,EACd,WAAmB,EACnB,YAAsC;IAEtC,OAAO,YAAY,CAAC,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAC/E,CAAC"}