conatus 0.1.0

package/dist/cli/setup.js

@@ -0,0 +1,147 @@
+// ─── CLI Dependency Setup ───
+//
+// buildDeps() wires all Conatus dependencies for CLI subcommands.
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { getMotivaDirPath, 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 { MemoryLifecycleManager, DriveScoreAdapter } from "../knowledge/memory-lifecycle.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 ~/.conatus/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());
+                    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 motivaBaseDir = getMotivaDirPath();
+    let memoryLifecycleManager;
+    let driveScoreAdapter;
+    try {
+        driveScoreAdapter = new DriveScoreAdapter();
+        memoryLifecycleManager = new MemoryLifecycleManager(motivaBaseDir, llmClient, undefined, undefined, undefined, driveScoreAdapter);
+        memoryLifecycleManager.initializeDirectories();
+    }
+    catch (err) {
+        getCliLogger().warn(`[conatus] MemoryLifecycleManager init failed — memory features disabled: ${err instanceof Error ? err.message : String(err)}`);
+        memoryLifecycleManager = undefined;
+        driveScoreAdapter = undefined;
+    }
+    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,
+        logger,
+        contextProvider,
+        onProgress,
+    }, config);
+    const goalNegotiator = new GoalNegotiator(stateManager, llmClient, ethicsGate, observationEngine, characterConfig, satisficingJudge, goalTreeManager, adapterRegistry.getAdapterCapabilities());
+    return { coreLoop, goalNegotiator, 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.d.ts

@@ -0,0 +1,9 @@
+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,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAK5E;AAED,wBAAgB,UAAU,IAAI,IAAI,CAkGjC;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,113 @@
+// ─── CLI Shared Utilities ───
+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(`
+Conatus — AI agent orchestrator
+
+Usage:
+  conatus run --goal <id>              Run CoreLoop for a goal
+  conatus improve [path]               Analyze path, suggest goals, and optionally run improvement loop
+  conatus suggest "<context>"          Suggest improvement goals for a project context
+  conatus goal add --title "<t>" --dim "name:type:val"  Register a goal (raw mode, no LLM)
+  conatus goal add "<description>" --negotiate          Register a goal via LLM negotiation
+  conatus goal list                    List all registered goals
+  conatus goal list --archived         Also list archived goals
+  conatus goal archive <id>            Archive a completed goal (moves state to ~/.conatus/archive/)
+  conatus goal remove <id>             Remove a goal by ID
+  conatus goal show <id>               Show goal details (dimensions, constraints, deadline)
+  conatus goal reset <id>              Reset goal state for re-running
+  conatus cleanup                      Archive all completed goals and remove stale data
+  conatus status --goal <id>           Show current status and progress
+  conatus report --goal <id>           Show latest report
+  conatus log --goal <id>              View observation and gap history log
+  conatus tui                          Launch the interactive TUI
+  conatus start --goal <id>            Start daemon mode for one or more goals
+  conatus stop                         Stop the running daemon
+  conatus cron --goal <id>             Print crontab entry for a goal
+  conatus config character             Show or update character configuration
+  conatus datasource add <type>        Register a new data source (file | http_api)
+  conatus datasource list              List all registered data sources
+  conatus datasource remove <id>       Remove a data source by ID
+  conatus capability list              List all registered capabilities
+  conatus capability remove <name>     Remove a capability by name
+  conatus plugin list                  List installed plugins
+  conatus plugin install <path>        Install a plugin from a local directory
+  conatus plugin remove <name>         Remove an installed plugin
+  conatus provider show                Show current provider config
+  conatus provider set                 Set LLM provider and/or default adapter
+
+Options (conatus 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 (conatus 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 (conatus suggest):
+  --max, -n <n>                       Max number of suggestions (default: 5)
+  --path, -p <dir>                    Repo path to scan for additional context
+
+Options (conatus goal add):
+  --title <title>                     Goal title (raw mode)
+  --dim <name:type:value>             Dimension spec, repeatable (raw mode, e.g. "tsc_error_count:min:0")
+  --negotiate                         Use LLM negotiation instead of raw mode
+  --deadline <ISO-date>               Optional deadline (e.g. 2026-06-01)
+  --constraint <text>                 Optional constraint (repeatable)
+
+Options (conatus 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 (conatus 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 (conatus 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
+  CONATUS_LLM_PROVIDER                 Override LLM provider (anthropic|openai|ollama|codex)
+
+Examples:
+  conatus goal add --title "tsc zero" --dim "tsc_error_count:min:0"
+  conatus goal add --title "clean code" --dim "todo_count:max:0" --dim "fixme_count:max:0"
+  conatus goal add "Increase test coverage to 90%" --negotiate
+  conatus goal list
+  conatus goal show <id>
+  conatus goal reset <id>
+  conatus run --goal <id>
+  conatus status --goal <id>
+  conatus report --goal <id>
+  conatus log --goal <id>
+  conatus config character --show
+  conatus config character --caution-level 3
+  conatus datasource add file --path /path/to/metrics.json --name "My Metrics"
+  conatus datasource add http_api --url https://api.example.com/metrics --name "API"
+  conatus datasource list
+  conatus 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,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgGb,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 Motiva 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 Motiva 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 Motiva 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":";AA8DA;;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;CA0a3C"}