pulseed 0.0.1 → 0.1.0

package/dist/cli/ensure-api-key.d.ts

@@ -0,0 +1,17 @@
+import { type ProviderConfig } from "../llm/provider-config.js";
+/**
+ * Load provider config and verify that the required API key is present for
+ * the configured provider. Throws if a required key is missing.
+ *
+ * If no ~/.pulseed/provider.json exists and stdin is a TTY, automatically
+ * runs the interactive setup wizard. If not a TTY, uses defaults silently.
+ *
+ * Ollama provider is not checked here — it needs no API key.
+ * OpenAI provider is validated by buildLLMClient() when the client is constructed.
+ * Only the Anthropic provider requires an early check because historical
+ * CLI code read ANTHROPIC_API_KEY before constructing any client.
+ *
+ * Returns the loaded ProviderConfig so callers don't need to load it again.
+ */
+export declare function ensureProviderConfig(): Promise<ProviderConfig>;
+//# sourceMappingURL=ensure-api-key.d.ts.map

package/dist/cli/ensure-api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-api-key.d.ts","sourceRoot":"","sources":["../../src/cli/ensure-api-key.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGpF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,CAkCpE"}

package/dist/cli/ensure-api-key.js

@@ -0,0 +1,52 @@
+// ─── API Key Guard ───
+//
+// Shared helper used by CLI/TUI entry points to validate that the active
+// LLM provider has the required API key configured before starting work.
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import * as tty from "node:tty";
+import { loadProviderConfig } from "../llm/provider-config.js";
+import { getPulseedDirPath } from "../utils/paths.js";
+/**
+ * Load provider config and verify that the required API key is present for
+ * the configured provider. Throws if a required key is missing.
+ *
+ * If no ~/.pulseed/provider.json exists and stdin is a TTY, automatically
+ * runs the interactive setup wizard. If not a TTY, uses defaults silently.
+ *
+ * Ollama provider is not checked here — it needs no API key.
+ * OpenAI provider is validated by buildLLMClient() when the client is constructed.
+ * Only the Anthropic provider requires an early check because historical
+ * CLI code read ANTHROPIC_API_KEY before constructing any client.
+ *
+ * Returns the loaded ProviderConfig so callers don't need to load it again.
+ */
+export async function ensureProviderConfig() {
+    // Check if config file exists — if not and TTY, run setup wizard
+    const configPath = path.join(getPulseedDirPath(), "provider.json");
+    let configExists = false;
+    try {
+        await fsp.access(configPath);
+        configExists = true;
+    }
+    catch {
+        // File does not exist
+    }
+    if (!configExists && tty.isatty(0)) {
+        console.log("No provider configuration found. Starting setup wizard...\n");
+        const { cmdSetup } = await import("./commands/setup.js");
+        const result = await cmdSetup([]);
+        if (result !== 0) {
+            throw new Error("Setup wizard failed. Run `pulseed setup` manually to configure your provider.");
+        }
+    }
+    const config = await loadProviderConfig();
+    // For the anthropic provider, api_key must be set.
+    // Other providers handle their own key validation inside buildLLMClient().
+    if (config.provider === "anthropic" && !config.api_key) {
+        throw new Error("No API key configured. Set ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable, " +
+            "or run: pulseed setup");
+    }
+    return config;
+}
+//# sourceMappingURL=ensure-api-key.js.map

package/dist/cli/ensure-api-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-api-key.js","sourceRoot":"","sources":["../../src/cli/ensure-api-key.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AAEzE,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAuB,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,iEAAiE;IACjE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,eAAe,CAAC,CAAC;IACnE,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,IAAI,CAAC,YAAY,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC3E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAE1C,mDAAmD;IACnD,2EAA2E;IAC3E,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,uFAAuF;YACrF,uBAAuB,CAC1B,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/setup.d.ts

@@ -0,0 +1,20 @@
+import { StateManager } from "../state-manager.js";
+import { DriveSystem } from "../drive/drive-system.js";
+import { GoalNegotiator } from "../goal/goal-negotiator.js";
+import { ReportingEngine } from "../reporting-engine.js";
+import { CoreLoop } from "../core-loop.js";
+import { GoalRefiner } from "../goal/goal-refiner.js";
+import { CharacterConfigManager } from "../traits/character-config.js";
+import type { LoopConfig } from "../core-loop.js";
+import type { Task } from "../types/task.js";
+import type { ProgressEvent } from "../core-loop.js";
+import { Logger } from "../runtime/logger.js";
+export declare function buildDeps(stateManager: StateManager, characterConfigManager: CharacterConfigManager, config?: LoopConfig, approvalFn?: (task: Task) => Promise<boolean>, logger?: Logger, onProgress?: (event: ProgressEvent) => void): Promise<{
+    coreLoop: CoreLoop;
+    goalNegotiator: GoalNegotiator;
+    goalRefiner: GoalRefiner;
+    reportingEngine: ReportingEngine;
+    stateManager: StateManager;
+    driveSystem: DriveSystem;
+}>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAOvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAK3C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,KAAK,EAA0C,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C,wBAAsB,SAAS,CAC7B,YAAY,EAAE,YAAY,EAC1B,sBAAsB,EAAE,sBAAsB,EAC9C,MAAM,CAAC,EAAE,UAAU,EACnB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,EAC7C,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI;;;;;;;GA4L5C"}

package/dist/cli/setup.js

@@ -0,0 +1,173 @@
+// ─── CLI Dependency Setup ───
+//
+// buildDeps() wires all PulSeed dependencies for CLI subcommands.
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { getPulseedDirPath, getDatasourcesDir } from "../utils/paths.js";
+import { readJsonFile } from "../utils/json-io.js";
+import { FileDataSourceAdapter, HttpApiDataSourceAdapter } from "../observation/data-source-adapter.js";
+import { GitHubIssueDataSourceAdapter } from "../adapters/github-issue-datasource.js";
+import { FileExistenceDataSourceAdapter } from "../adapters/file-existence-datasource.js";
+import { ShellDataSourceAdapter } from "../adapters/shell-datasource.js";
+import { createWorkspaceContextProvider } from "../observation/workspace-context.js";
+import { buildLLMClient, buildAdapterRegistry } from "../llm/provider-factory.js";
+import { TrustManager } from "../traits/trust-manager.js";
+import { DriveSystem } from "../drive/drive-system.js";
+import { ObservationEngine } from "../observation/observation-engine.js";
+import { StallDetector } from "../drive/stall-detector.js";
+import { SatisficingJudge } from "../drive/satisficing-judge.js";
+import { EthicsGate } from "../traits/ethics-gate.js";
+import { SessionManager } from "../execution/session-manager.js";
+import { StrategyManager } from "../strategy/strategy-manager.js";
+import { GoalNegotiator } from "../goal/goal-negotiator.js";
+import { TaskLifecycle } from "../execution/task-lifecycle.js";
+import { ReportingEngine } from "../reporting-engine.js";
+import { CoreLoop } from "../core-loop.js";
+import { TreeLoopOrchestrator } from "../goal/tree-loop-orchestrator.js";
+import { GoalTreeManager } from "../goal/goal-tree-manager.js";
+import { StateAggregator } from "../goal/state-aggregator.js";
+import { GoalDependencyGraph } from "../goal/goal-dependency-graph.js";
+import { GoalRefiner } from "../goal/goal-refiner.js";
+import { MemoryLifecycleManager, DriveScoreAdapter } from "../knowledge/memory-lifecycle.js";
+import { KnowledgeManager } from "../knowledge/knowledge-manager.js";
+import { VectorIndex } from "../knowledge/vector-index.js";
+import { OpenAIEmbeddingClient, MockEmbeddingClient } from "../knowledge/embedding-client.js";
+import * as GapCalculator from "../drive/gap-calculator.js";
+import * as DriveScorer from "../drive/drive-scorer.js";
+import { getCliLogger } from "./cli-logger.js";
+import { formatOperationError } from "./utils.js";
+export async function buildDeps(stateManager, characterConfigManager, config, approvalFn, logger, onProgress) {
+    const characterConfig = await characterConfigManager.load();
+    const llmClient = await buildLLMClient();
+    const trustManager = new TrustManager(stateManager);
+    const driveSystem = new DriveSystem(stateManager);
+    // Read datasource configs from ~/.pulseed/datasources/
+    const dsDir = getDatasourcesDir();
+    const dataSources = [];
+    try {
+        let dsExists = false;
+        try {
+            await fsp.access(dsDir);
+            dsExists = true;
+        }
+        catch { /* not found */ }
+        if (dsExists) {
+            const files = (await fsp.readdir(dsDir)).filter(f => f.endsWith('.json'));
+            for (const file of files) {
+                const cfg = await readJsonFile(path.join(dsDir, file));
+                if (cfg.type === 'file') {
+                    dataSources.push(new FileDataSourceAdapter(cfg));
+                }
+                else if (cfg.type === 'http_api') {
+                    dataSources.push(new HttpApiDataSourceAdapter(cfg));
+                }
+                else if (cfg.type === 'github_issue' || cfg.type === 'custom' || cfg.type === 'database') {
+                    dataSources.push(new GitHubIssueDataSourceAdapter(cfg));
+                }
+                else if (cfg.type === 'file_existence') {
+                    dataSources.push(new FileExistenceDataSourceAdapter(cfg));
+                }
+                else if (cfg.type === 'shell') {
+                    const adapter = new ShellDataSourceAdapter(cfg.id, (cfg.connection.commands ?? {}), cfg.connection?.path ?? process.cwd());
+                    // Propagate scope_goal_id from datasource config for dimension matching
+                    if (cfg.scope_goal_id) {
+                        adapter.config.scope_goal_id = cfg.scope_goal_id;
+                    }
+                    dataSources.push(adapter);
+                }
+            }
+        }
+    }
+    catch (err) {
+        getCliLogger().error(formatOperationError(`load datasource configurations from "${dsDir}"`, err));
+    }
+    const contextProvider = createWorkspaceContextProvider({ workDir: process.cwd() }, async (goalId) => {
+        try {
+            const goal = await stateManager.loadGoal(goalId);
+            return goal?.description;
+        }
+        catch (err) {
+            getCliLogger().error(formatOperationError(`resolve workspace context goal description for "${goalId}"`, err));
+            return undefined;
+        }
+    });
+    const observationEngine = new ObservationEngine(stateManager, dataSources, llmClient, contextProvider);
+    const stallDetector = new StallDetector(stateManager, characterConfig);
+    const satisficingJudge = new SatisficingJudge(stateManager);
+    const ethicsGate = new EthicsGate(stateManager, llmClient);
+    // Stage 14 — tree mode dependencies
+    const goalDependencyGraph = new GoalDependencyGraph(stateManager, llmClient);
+    const sessionManager = new SessionManager(stateManager, goalDependencyGraph);
+    const strategyManager = new StrategyManager(stateManager, llmClient);
+    const adapterRegistry = await buildAdapterRegistry(llmClient);
+    const taskLifecycle = new TaskLifecycle(stateManager, llmClient, sessionManager, trustManager, strategyManager, stallDetector, { approvalFn, logger });
+    const reportingEngine = new ReportingEngine(stateManager, undefined, characterConfig);
+    const goalTreeManager = new GoalTreeManager(stateManager, llmClient, ethicsGate, goalDependencyGraph);
+    const stateAggregator = new StateAggregator(stateManager, satisficingJudge);
+    const treeLoopOrchestrator = new TreeLoopOrchestrator(stateManager, goalTreeManager, stateAggregator, satisficingJudge);
+    // MemoryLifecycleManager — wires 3-tier memory model into CoreLoop.
+    const pulseedBaseDir = getPulseedDirPath();
+    // --- Embedding + Vector infrastructure ---
+    const embeddingClient = process.env["OPENAI_API_KEY"]
+        ? new OpenAIEmbeddingClient(process.env["OPENAI_API_KEY"])
+        : new MockEmbeddingClient();
+    let vectorIndex;
+    try {
+        const vectorDir = path.join(pulseedBaseDir, "memory");
+        await fsp.mkdir(vectorDir, { recursive: true });
+        const vectorIndexPath = path.join(vectorDir, "vector-index.json");
+        vectorIndex = await VectorIndex.create(vectorIndexPath, embeddingClient);
+    }
+    catch (err) {
+        // Non-fatal: semantic search disabled if vector index init fails
+        console.warn(`[pulseed] VectorIndex init failed — semantic search disabled: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let memoryLifecycleManager;
+    let driveScoreAdapter;
+    try {
+        driveScoreAdapter = new DriveScoreAdapter();
+        memoryLifecycleManager = new MemoryLifecycleManager(pulseedBaseDir, llmClient, undefined, embeddingClient, vectorIndex, driveScoreAdapter);
+        memoryLifecycleManager.initializeDirectories();
+    }
+    catch (err) {
+        getCliLogger().warn(`[pulseed] MemoryLifecycleManager init failed — memory features disabled: ${err instanceof Error ? err.message : String(err)}`);
+        memoryLifecycleManager = undefined;
+        driveScoreAdapter = undefined;
+    }
+    const knowledgeManager = new KnowledgeManager(stateManager, llmClient, vectorIndex, embeddingClient);
+    const gapCalculator = {
+        calculateGapVector: GapCalculator.calculateGapVector,
+        aggregateGaps: GapCalculator.aggregateGaps,
+    };
+    const driveScorer = {
+        scoreAllDimensions: (gapVector, context, _cfg) => DriveScorer.scoreAllDimensions(gapVector, context),
+        rankDimensions: DriveScorer.rankDimensions,
+    };
+    const coreLoop = new CoreLoop({
+        stateManager,
+        observationEngine,
+        gapCalculator,
+        driveScorer,
+        taskLifecycle,
+        satisficingJudge,
+        stallDetector,
+        strategyManager,
+        reportingEngine,
+        driveSystem,
+        adapterRegistry,
+        goalTreeManager,
+        stateAggregator,
+        treeLoopOrchestrator,
+        goalDependencyGraph,
+        memoryLifecycleManager,
+        driveScoreAdapter,
+        knowledgeManager,
+        logger,
+        contextProvider,
+        onProgress,
+    }, config);
+    const goalNegotiator = new GoalNegotiator(stateManager, llmClient, ethicsGate, observationEngine, characterConfig, satisficingJudge, goalTreeManager, adapterRegistry.getAdapterCapabilities());
+    const goalRefiner = new GoalRefiner(stateManager, llmClient, observationEngine, goalNegotiator, goalTreeManager, ethicsGate);
+    return { coreLoop, goalNegotiator, goalRefiner, reportingEngine, stateManager, driveSystem };
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/cli/utils/loop-runner.d.ts

@@ -0,0 +1,8 @@
+import { Logger } from "../../runtime/logger.js";
+import type { CoreLoop, LoopResult, ProgressEvent } from "../../core-loop.js";
+import type { Task } from "../../types/task.js";
+export declare function buildAutoApprovalFn(): (task: Task) => Promise<boolean>;
+export declare function buildLoopLogger(): Logger;
+export declare function buildProgressHandler(): (event: ProgressEvent) => void;
+export declare function runLoopWithSignals(coreLoop: CoreLoop, goalId: string): Promise<LoopResult>;
+//# sourceMappingURL=loop-runner.d.ts.map

package/dist/cli/utils/loop-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-runner.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/loop-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,wBAAgB,mBAAmB,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAMtE;AAED,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED,wBAAgB,oBAAoB,IAAI,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAiCrE;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAcrB"}

package/dist/cli/utils/loop-runner.js

@@ -0,0 +1,74 @@
+// ─── Shared loop utilities for CLI commands ───
+import { getLogsDir } from "../../utils/paths.js";
+import { Logger } from "../../runtime/logger.js";
+export function buildAutoApprovalFn() {
+    return async (task) => {
+        console.log(`\n--- Auto-approved (--yes) ---`);
+        console.log(`Task: ${task.work_description.split("\n")[0]}`);
+        return true;
+    };
+}
+export function buildLoopLogger() {
+    return new Logger({
+        dir: getLogsDir(),
+        level: "debug",
+        consoleOutput: false,
+    });
+}
+export function buildProgressHandler() {
+    let lastIterationLogged = -1;
+    return (event) => {
+        const prefix = `[${event.iteration}/${event.maxIterations}]`;
+        if (event.phase === "Observing...") {
+            if (event.iteration !== lastIterationLogged) {
+                lastIterationLogged = event.iteration;
+                const gapStr = event.gap !== undefined ? ` gap=${event.gap.toFixed(2)}` : "";
+                process.stdout.write(`${prefix} Observing...${gapStr}\n`);
+            }
+        }
+        else if (event.phase === "Generating task...") {
+            const gapStr = event.gap !== undefined ? ` gap=${event.gap.toFixed(2)}` : "";
+            const confStr = event.confidence !== undefined ? ` confidence=${Math.round(event.confidence * 100)}%` : "";
+            process.stdout.write(`${prefix} Generating task...${gapStr}${confStr}\n`);
+        }
+        else if (event.phase === "Skipped") {
+            const reason = event.skipReason ?? "unknown";
+            process.stdout.write(`${prefix} Skipped — ${reason.replace(/_/g, " ")}\n`);
+        }
+        else if (event.phase === "Executing task...") {
+            if (event.taskDescription) {
+                process.stdout.write(`${prefix} Executing task: "${event.taskDescription}"\n`);
+            }
+            else {
+                process.stdout.write(`${prefix} Executing task...\n`);
+            }
+        }
+        else if (event.phase === "Verifying result...") {
+            if (event.taskDescription) {
+                process.stdout.write(`${prefix} Verifying: "${event.taskDescription}"\n`);
+            }
+            else {
+                process.stdout.write(`${prefix} Verifying result...\n`);
+            }
+        }
+        else if (event.phase === "Skipped (no state change)") {
+            process.stdout.write(`${prefix} Skipped (no state change detected)\n`);
+        }
+    };
+}
+export async function runLoopWithSignals(coreLoop, goalId) {
+    const shutdown = () => {
+        console.log("\nStopping loop...");
+        coreLoop.stop();
+    };
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
+    try {
+        return await coreLoop.run(goalId);
+    }
+    finally {
+        process.off("SIGINT", shutdown);
+        process.off("SIGTERM", shutdown);
+    }
+}
+//# sourceMappingURL=loop-runner.js.map

package/dist/cli/utils/loop-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-runner.js","sourceRoot":"","sources":["../../../src/cli/utils/loop-runner.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAIjD,MAAM,UAAU,mBAAmB;IACjC,OAAO,KAAK,EAAE,IAAU,EAAoB,EAAE;QAC5C,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,MAAM,CAAC;QAChB,GAAG,EAAE,UAAU,EAAE;QACjB,KAAK,EAAE,OAAO;QACd,aAAa,EAAE,KAAK;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,mBAAmB,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAoB,EAAQ,EAAE;QACpC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC;QAC7D,IAAI,KAAK,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,SAAS,KAAK,mBAAmB,EAAE,CAAC;gBAC5C,mBAAmB,GAAG,KAAK,CAAC,SAAS,CAAC;gBACtC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,gBAAgB,MAAM,IAAI,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,KAAK,KAAK,oBAAoB,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3G,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,sBAAsB,MAAM,GAAG,OAAO,IAAI,CAAC,CAAC;QAC5E,CAAC;aAAM,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC;YAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,cAAc,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC;aAAM,IAAI,KAAK,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;YAC/C,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;gBAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,qBAAqB,KAAK,CAAC,eAAe,KAAK,CAAC,CAAC;YACjF,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,sBAAsB,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,KAAK,KAAK,qBAAqB,EAAE,CAAC;YACjD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;gBAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,gBAAgB,KAAK,CAAC,eAAe,KAAK,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,wBAAwB,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,KAAK,KAAK,2BAA2B,EAAE,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,uCAAuC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAkB,EAClB,MAAc;IAEd,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAElC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/cli/utils.d.ts

@@ -0,0 +1,10 @@
+export declare function promptYesNo(question: string): Promise<boolean>;
+export declare function formatOperationError(operation: string, err: unknown): string;
+export declare function printUsage(): void;
+export declare function printCharacterConfig(config: {
+    caution_level: number;
+    stall_flexibility: number;
+    communication_directness: number;
+    proactivity_level: number;
+}): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/cli/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAEA,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAK5E;AAED,wBAAgB,UAAU,IAAI,IAAI,CAyGjC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,IAAI,CAKP"}

package/dist/cli/utils.js

@@ -0,0 +1,131 @@
+// ─── CLI Shared Utilities ───
+export async function promptYesNo(question) {
+    const readline = await import("node:readline");
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        process.stdout.write(question);
+        rl.once("line", (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === "y");
+        });
+    });
+}
+export function formatOperationError(operation, err) {
+    if (err instanceof Error) {
+        return `Operation "${operation}" failed. Original error: ${err.name}: ${err.message}`;
+    }
+    return `Operation "${operation}" failed. Original error: ${String(err)}`;
+}
+export function printUsage() {
+    console.log(`
+PulSeed — AI agent orchestrator
+
+Usage:
+  pulseed run --goal <id>              Run CoreLoop for a goal
+  pulseed improve [path]               Analyze path, suggest goals, and optionally run improvement loop
+  pulseed suggest "<context>"          Suggest improvement goals for a project context
+  pulseed goal add --title "<t>" --dim "name:type:val"  Register a goal (raw mode, no LLM)
+  pulseed goal add "<description>"                      Register a goal via GoalRefiner (default)
+  pulseed goal add "<description>" --no-refine          Register a goal via legacy LLM negotiation
+  pulseed goal list                    List all registered goals
+  pulseed goal list --archived         Also list archived goals
+  pulseed goal archive <id>            Archive a completed goal (moves state to ~/.pulseed/archive/)
+  pulseed goal remove <id>             Remove a goal by ID
+  pulseed goal show <id>               Show goal details (dimensions, constraints, deadline)
+  pulseed goal reset <id>              Reset goal state for re-running
+  pulseed cleanup                      Archive all completed goals and remove stale data
+  pulseed status --goal <id>           Show current status and progress
+  pulseed report --goal <id>           Show latest report
+  pulseed log --goal <id>              View observation and gap history log
+  pulseed tui                          Launch the interactive TUI
+  pulseed start --goal <id>            Start daemon mode for one or more goals
+  pulseed stop                         Stop the running daemon
+  pulseed cron --goal <id>             Print crontab entry for a goal
+  pulseed config character             Show or update character configuration
+  pulseed datasource add <type>        Register a new data source (file | http_api)
+  pulseed datasource list              List all registered data sources
+  pulseed datasource remove <id>       Remove a data source by ID
+  pulseed capability list              List all registered capabilities
+  pulseed capability remove <name>     Remove a capability by name
+  pulseed knowledge list               List all shared knowledge entries
+  pulseed knowledge search <query>     Search knowledge entries by keyword
+  pulseed knowledge stats              Show knowledge base statistics
+  pulseed plugin list                  List installed plugins
+  pulseed plugin install <path>        Install a plugin from a local directory
+  pulseed plugin remove <name>         Remove an installed plugin
+  pulseed setup                        Interactive setup wizard (first-time configuration)
+  pulseed provider show                Show current provider config
+  pulseed provider set                 Set LLM provider and/or default adapter
+
+Options (pulseed run):
+  --goal <id>                         Goal ID to run (required)
+  --max-iterations <n>               Override max iterations (default: 100)
+  --adapter <type>                    Adapter: claude_api | claude_code_cli | github_issue (default: claude_api)
+  --tree                              Enable tree mode (iterate across all tree nodes)
+  --yes, -y                           Auto-approve all tasks (skip approval prompts)
+
+Options (pulseed improve):
+  --auto                              Full auto mode (select best suggestion, run loop)
+  --yes                               Auto-approve (select first suggestion, run loop)
+  --max, -n <n>                       Max suggestions (default: 3)
+
+Options (pulseed suggest):
+  --max, -n <n>                       Max number of suggestions (default: 5)
+  --path, -p <dir>                    Repo path to scan for additional context
+
+Options (pulseed goal add):
+  --title <title>                     Goal title (raw mode)
+  --dim <name:type:value>             Dimension spec, repeatable (raw mode, e.g. "tsc_error_count:min:0")
+  --no-refine                         Skip GoalRefiner, use legacy negotiate() instead
+  --negotiate                         Alias: same as default (refine mode)
+  --deadline <ISO-date>               Optional deadline (e.g. 2026-06-01)
+  --constraint <text>                 Optional constraint (repeatable)
+
+Options (pulseed config character):
+  --show                              Show current character config
+  --reset                             Reset to defaults
+  --caution-level <1-5>               Feasibility threshold (1=conservative, 5=ambitious)
+  --stall-flexibility <1-5>           Stall tolerance (1=pivot fast, 5=persistent)
+  --communication-directness <1-5>    Output style (1=considerate, 5=direct)
+  --proactivity-level <1-5>           Report verbosity (1=events-only, 5=always-detailed)
+
+Options (pulseed datasource add):
+  --name <name>                       Human-readable name for the data source
+  --path <path>                       File path (required for type=file)
+  --url <url>                         HTTP URL (required for type=http_api)
+
+Options (pulseed provider set):
+  --llm <provider>                    LLM provider: anthropic | openai | ollama | codex
+  --adapter <type>                    Default adapter: claude_code_cli | claude_api | openai_codex_cli | openai_api | github_issue
+
+Environment:
+  ANTHROPIC_API_KEY                   Required for LLM-powered commands
+  PULSEED_LLM_PROVIDER                 Override LLM provider (anthropic|openai|ollama|codex)
+
+Examples:
+  pulseed goal add --title "tsc zero" --dim "tsc_error_count:min:0"
+  pulseed goal add --title "clean code" --dim "todo_count:max:0" --dim "fixme_count:max:0"
+  pulseed goal add "Increase test coverage to 90%"
+  pulseed goal add "Increase test coverage to 90%" --no-refine
+  pulseed goal list
+  pulseed goal show <id>
+  pulseed goal reset <id>
+  pulseed run --goal <id>
+  pulseed status --goal <id>
+  pulseed report --goal <id>
+  pulseed log --goal <id>
+  pulseed config character --show
+  pulseed config character --caution-level 3
+  pulseed datasource add file --path /path/to/metrics.json --name "My Metrics"
+  pulseed datasource add http_api --url https://api.example.com/metrics --name "API"
+  pulseed datasource list
+  pulseed datasource remove ds_1234567890
+`.trim());
+}
+export function printCharacterConfig(config) {
+    console.log(`  caution_level:              ${config.caution_level}  (1=conservative, 5=ambitious)`);
+    console.log(`  stall_flexibility:          ${config.stall_flexibility}  (1=pivot fast, 5=persistent)`);
+    console.log(`  communication_directness:   ${config.communication_directness}  (1=considerate, 5=direct)`);
+    console.log(`  proactivity_level:          ${config.proactivity_level}  (1=events-only, 5=always-detailed)`);
+}
+//# sourceMappingURL=utils.js.map

package/dist/cli/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/B,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YACzB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,GAAY;IAClE,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,cAAc,SAAS,6BAA6B,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;IACxF,CAAC;IACD,OAAO,cAAc,SAAS,6BAA6B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuGb,CAAC,IAAI,EAAE,CAAC,CAAC;AACV,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAKpC;IACC,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,aAAa,iCAAiC,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,iBAAiB,gCAAgC,CAAC,CAAC;IACvG,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,wBAAwB,6BAA6B,CAAC,CAAC;IAC3G,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,iBAAiB,sCAAsC,CAAC,CAAC;AAC/G,CAAC"}

package/dist/cli-runner.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * @description Coordinates CLI argument parsing, dependency wiring, and subcommand execution for the PulSeed command-line interface.
+ */
+export declare class CLIRunner {
+    private readonly stateManager;
+    private readonly characterConfigManager;
+    private activeCoreLoop;
+    /**
+     * @description Creates a CLI runner with state and character configuration managers rooted at the optional base directory.
+     * @param {string} [baseDir] Optional base directory for PulSeed state storage.
+     * @returns {void} Does not return a value.
+     */
+    constructor(baseDir?: string);
+    /**
+     * @description Initialises the state directory structure. Must be awaited before issuing any subcommands.
+     * @returns {Promise<void>}
+     */
+    init(): Promise<void>;
+    /**
+     * @description Stops the active core loop if one is currently running. Safe to call before `run()` or when no loop is active.
+     * @returns {void} Does not return a value.
+     */
+    stop(): void;
+    /**
+     * @description Parses CLI arguments, dispatches the matching PulSeed subcommand, and returns the resulting exit code.
+     * @param {string[]} argv Raw subcommand arguments, excluding the `node` executable and script path.
+     * @returns {Promise<number>} A promise that resolves to `0` for success, `1` for errors, or `2` for stall escalation.
+     */
+    run(argv: string[]): Promise<number>;
+}
+//# sourceMappingURL=cli-runner.d.ts.map

package/dist/cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":";AA4DA;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,cAAc,CAAyB;IAE/C;;;;OAIG;gBACS,OAAO,CAAC,EAAE,MAAM;IAK5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;OAGG;IACH,IAAI,IAAI,IAAI;IAQZ;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA6V3C"}