conatus 0.1.0

package/dist/tree-loop-orchestrator.js

@@ -0,0 +1,225 @@
+/**
+ * TreeLoopOrchestrator manages the execution of independent loops across
+ * all nodes in a goal tree.
+ *
+ * Responsibilities:
+ *   - Selecting the next node to execute (leaf-first priority)
+ *   - Enforcing parallel_loop_limit for concurrent execution
+ *   - Tracking loop_status transitions (idle → running → idle/paused)
+ *   - Triggering state aggregation on node completion
+ *   - Detecting and cascading completion up the tree
+ *
+ * Design ref: docs/design/goal-tree.md §14C
+ */
+export class TreeLoopOrchestrator {
+    stateManager;
+    goalTreeManager;
+    stateAggregator;
+    satisficingJudge;
+    /**
+     * GoalDecompositionConfig used to control parallel execution limits.
+     * Updated by startTreeExecution(); defaults applied until first call.
+     */
+    config = {
+        max_depth: 5,
+        min_specificity: 0.7,
+        auto_prune_threshold: 0.3,
+        parallel_loop_limit: 3,
+    };
+    constructor(stateManager, goalTreeManager, stateAggregator, satisficingJudge) {
+        this.stateManager = stateManager;
+        this.goalTreeManager = goalTreeManager;
+        this.stateAggregator = stateAggregator;
+        this.satisficingJudge = satisficingJudge;
+    }
+    // ─── Tree Execution Initialization ───
+    /**
+     * Initialize tree execution.
+     * Saves the config and optionally resets all node loop_status to "idle".
+     * The actual per-node loops are driven by CoreLoop calling selectNextNode()
+     * in a tree-mode iteration.
+     */
+    async startTreeExecution(rootId, config) {
+        this.config = config;
+        // Reset all nodes in the tree to loop_status: "idle" to ensure clean state
+        const root = this.stateManager.loadGoal(rootId);
+        if (!root)
+            return;
+        const now = new Date().toISOString();
+        const allIds = [rootId, ...this._collectAllDescendantIds(rootId)];
+        for (const id of allIds) {
+            const goal = this.stateManager.loadGoal(id);
+            if (goal && goal.loop_status !== "idle") {
+                this.stateManager.saveGoal({
+                    ...goal,
+                    loop_status: "idle",
+                    updated_at: now,
+                });
+            }
+        }
+    }
+    // ─── Node Selection ───
+    /**
+     * Select the next node to execute from the tree rooted at rootId.
+     *
+     * Algorithm (MVP: leaf-first):
+     *   1. Get tree state — if active_loops.length >= parallel_loop_limit, return null.
+     *   2. Collect all goal IDs in the tree (root + descendants).
+     *   3. Filter to active + idle nodes (not running, not paused).
+     *   4. Prefer leaf nodes (node_type === "leaf") over non-leaf nodes.
+     *   5. Return the first candidate's ID and set its loop_status to "running".
+     *
+     * Returns null when:
+     *   - parallel_loop_limit is already reached
+     *   - No eligible (active + idle) nodes remain
+     */
+    selectNextNode(rootId) {
+        // Step 1: Check parallel limit
+        const treeState = this.goalTreeManager.getTreeState(rootId);
+        if (treeState.active_loops.length >= this.config.parallel_loop_limit) {
+            return null;
+        }
+        // Step 2: Collect all IDs (root + all descendants)
+        const allIds = [rootId, ...this._collectAllDescendantIds(rootId)];
+        // Step 3 & 4: Filter eligible nodes — active + idle, leaf first
+        const eligibleLeaves = [];
+        const eligibleNonLeaves = [];
+        for (const id of allIds) {
+            const goal = this.stateManager.loadGoal(id);
+            if (!goal)
+                continue;
+            if (goal.status !== "active")
+                continue;
+            if (goal.loop_status === "running" || goal.loop_status === "paused")
+                continue;
+            if (goal.node_type === "leaf") {
+                eligibleLeaves.push(id);
+            }
+            else {
+                eligibleNonLeaves.push(id);
+            }
+        }
+        // Step 5: Pick best candidate (leaf-first, then non-leaf)
+        let selectedId = null;
+        if (eligibleLeaves.length > 0) {
+            // Among leaves, prefer deeper ones (higher decomposition_depth)
+            eligibleLeaves.sort((a, b) => {
+                const ga = this.stateManager.loadGoal(a);
+                const gb = this.stateManager.loadGoal(b);
+                const depthA = ga?.decomposition_depth ?? 0;
+                const depthB = gb?.decomposition_depth ?? 0;
+                return depthB - depthA; // descending: deeper first
+            });
+            selectedId = eligibleLeaves[0] ?? null;
+        }
+        else if (eligibleNonLeaves.length > 0) {
+            selectedId = eligibleNonLeaves[0] ?? null;
+        }
+        if (selectedId === null)
+            return null;
+        // Mark selected node as running
+        const selected = this.stateManager.loadGoal(selectedId);
+        if (selected) {
+            this.stateManager.saveGoal({
+                ...selected,
+                loop_status: "running",
+                updated_at: new Date().toISOString(),
+            });
+        }
+        return selectedId;
+    }
+    // ─── Node Loop Control ───
+    /**
+     * Pause the loop for a specific node.
+     * Sets loop_status to "paused".
+     * No-op if the goal is not found.
+     */
+    pauseNodeLoop(goalId) {
+        const goal = this.stateManager.loadGoal(goalId);
+        if (!goal)
+            return;
+        this.stateManager.saveGoal({
+            ...goal,
+            loop_status: "paused",
+            updated_at: new Date().toISOString(),
+        });
+    }
+    /**
+     * Resume the loop for a specific node.
+     * Sets loop_status to "running".
+     * No-op if the goal is not found.
+     */
+    resumeNodeLoop(goalId) {
+        const goal = this.stateManager.loadGoal(goalId);
+        if (!goal)
+            return;
+        this.stateManager.saveGoal({
+            ...goal,
+            loop_status: "running",
+            updated_at: new Date().toISOString(),
+        });
+    }
+    // ─── Node Completion Callback ───
+    /**
+     * Called when a node's execution cycle completes.
+     *
+     * Actions:
+     *   1. Reset loop_status to "idle" (release the execution slot).
+     *   2. Aggregate state bottom-up to the root.
+     *   3. Run completion cascade to auto-complete ancestor nodes whose
+     *      children are all done.
+     */
+    onNodeCompleted(goalId) {
+        const now = new Date().toISOString();
+        // Step 1: Reset loop_status to "idle"
+        const goal = this.stateManager.loadGoal(goalId);
+        if (goal) {
+            this.stateManager.saveGoal({
+                ...goal,
+                loop_status: "idle",
+                updated_at: now,
+            });
+        }
+        // Step 2: Aggregate parent chain bottom-up
+        let parentId = goal?.parent_id ?? null;
+        while (parentId !== null) {
+            try {
+                this.stateAggregator.aggregateChildStates(parentId);
+            }
+            catch {
+                // Non-fatal: parent may be missing or have no children
+                break;
+            }
+            const parent = this.stateManager.loadGoal(parentId);
+            parentId = parent?.parent_id ?? null;
+        }
+        // Step 3: Completion cascade
+        const cascadeIds = this.stateAggregator.checkCompletionCascade(goalId);
+        for (const ancestorId of cascadeIds) {
+            const ancestor = this.stateManager.loadGoal(ancestorId);
+            if (ancestor && ancestor.status !== "completed") {
+                this.stateManager.saveGoal({
+                    ...ancestor,
+                    status: "completed",
+                    updated_at: now,
+                });
+            }
+        }
+    }
+    // ─── Private Helpers ───
+    /**
+     * Collect all descendant IDs (not including rootId itself).
+     */
+    _collectAllDescendantIds(goalId) {
+        const goal = this.stateManager.loadGoal(goalId);
+        if (!goal)
+            return [];
+        const result = [];
+        for (const childId of goal.children_ids) {
+            result.push(childId);
+            result.push(...this._collectAllDescendantIds(childId));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=tree-loop-orchestrator.js.map

package/dist/tree-loop-orchestrator.js.map

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

package/dist/trust-manager.d.ts

@@ -0,0 +1,67 @@
+import type { StateManager } from "./state-manager.js";
+import type { TrustBalance, ActionQuadrant } from "./types/trust.js";
+/**
+ * TrustManager handles per-domain trust balances, action quadrant determination,
+ * irreversibility-based approval requirements, and user overrides.
+ *
+ * Persistence: `trust/trust-store.json` via StateManager readRaw/writeRaw.
+ * The store is loaded lazily on first access and cached in memory.
+ * Every mutation persists immediately.
+ */
+export declare class TrustManager {
+    private readonly stateManager;
+    private cache;
+    constructor(stateManager: StateManager);
+    private loadStore;
+    private saveStore;
+    /**
+     * Get the trust balance for a domain.
+     * Returns a default balance (score=0) if the domain is not yet tracked.
+     */
+    getBalance(domain: string): TrustBalance;
+    /**
+     * Record a successful task for a domain.
+     * Adds TRUST_SUCCESS_DELTA (+3), clamps to [-100, +100], and persists.
+     */
+    recordSuccess(domain: string): TrustBalance;
+    /**
+     * Record a failed task for a domain.
+     * Adds TRUST_FAILURE_DELTA (-10), clamps to [-100, +100], and persists.
+     */
+    recordFailure(domain: string): TrustBalance;
+    /**
+     * Determine the action quadrant based on trust balance and confidence.
+     *
+     * Matrix:
+     *   trust >= 20 AND confidence >= 0.50 → "autonomous"
+     *   trust >= 20 AND confidence < 0.50  → "execute_with_confirm"
+     *   trust <  20 AND confidence >= 0.50 → "execute_with_confirm"
+     *   trust <  20 AND confidence < 0.50  → "observe_and_propose"
+     */
+    getActionQuadrant(domain: string, confidence: number): ActionQuadrant;
+    /**
+     * Determine whether an action requires human approval.
+     *
+     * Returns true if:
+     *   - reversibility is "irreversible" or "unknown" (always requires approval), OR
+     *   - a permanent gate exists for the given domain and category, OR
+     *   - the action quadrant is not "autonomous"
+     */
+    requiresApproval(reversibility: string, domain: string, confidence: number, category?: string): boolean;
+    /**
+     * Override the trust balance for a domain to a specific value.
+     * Logs the override with a reason and persists.
+     */
+    setOverride(domain: string, balance: number, reason: string): void;
+    /**
+     * Add a permanent gate for a category within a domain.
+     * Actions with this category will always require approval regardless of trust/confidence.
+     * Logs the gate addition and persists.
+     */
+    addPermanentGate(domain: string, category: string): void;
+    /**
+     * Check whether a permanent gate exists for the given domain and category.
+     */
+    hasPermanentGate(domain: string, category: string): boolean;
+}
+//# sourceMappingURL=trust-manager.d.ts.map

package/dist/trust-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-manager.d.ts","sourceRoot":"","sources":["../src/trust-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYvD,OAAO,KAAK,EAAE,YAAY,EAAc,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA6BjF;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,KAAK,CAA2B;gBAE5B,YAAY,EAAE,YAAY;IAMtC,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,SAAS;IAQjB;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IASxC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAY3C;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAY3C;;;;;;;;OAQG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc;IAcrE;;;;;;;OAOG;IACH,gBAAgB,CACd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAWV;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAyBlE;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwBxD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;CAM5D"}

package/dist/trust-manager.js

@@ -0,0 +1,201 @@
+import { TrustBalanceSchema, TrustStoreSchema, TrustOverrideLogEntrySchema, } from "./types/trust.js";
+import { HIGH_TRUST_THRESHOLD, HIGH_CONFIDENCE_THRESHOLD, TRUST_SUCCESS_DELTA, TRUST_FAILURE_DELTA, } from "./types/trust.js";
+/** Path relative to StateManager base dir for the trust store */
+const TRUST_STORE_PATH = "trust/trust-store.json";
+/** Default empty TrustStore */
+function emptyStore() {
+    return TrustStoreSchema.parse({
+        balances: {},
+        permanent_gates: {},
+        override_log: [],
+    });
+}
+/** Default TrustBalance for a new domain */
+function defaultBalance(domain) {
+    return TrustBalanceSchema.parse({
+        domain,
+        balance: 0,
+        success_delta: TRUST_SUCCESS_DELTA,
+        failure_delta: TRUST_FAILURE_DELTA,
+    });
+}
+/** Clamp a value to [-100, 100] */
+function clamp(value) {
+    return Math.max(-100, Math.min(100, value));
+}
+/**
+ * TrustManager handles per-domain trust balances, action quadrant determination,
+ * irreversibility-based approval requirements, and user overrides.
+ *
+ * Persistence: `trust/trust-store.json` via StateManager readRaw/writeRaw.
+ * The store is loaded lazily on first access and cached in memory.
+ * Every mutation persists immediately.
+ */
+export class TrustManager {
+    stateManager;
+    cache = null;
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    // ─── Private: Store I/O ───
+    loadStore() {
+        if (this.cache !== null) {
+            return this.cache;
+        }
+        const raw = this.stateManager.readRaw(TRUST_STORE_PATH);
+        if (raw === null) {
+            this.cache = emptyStore();
+        }
+        else {
+            this.cache = TrustStoreSchema.parse(raw);
+        }
+        return this.cache;
+    }
+    saveStore(store) {
+        const parsed = TrustStoreSchema.parse(store);
+        this.cache = parsed;
+        this.stateManager.writeRaw(TRUST_STORE_PATH, parsed);
+    }
+    // ─── Public API ───
+    /**
+     * Get the trust balance for a domain.
+     * Returns a default balance (score=0) if the domain is not yet tracked.
+     */
+    getBalance(domain) {
+        const store = this.loadStore();
+        const existing = store.balances[domain];
+        if (existing === undefined) {
+            return defaultBalance(domain);
+        }
+        return TrustBalanceSchema.parse(existing);
+    }
+    /**
+     * Record a successful task for a domain.
+     * Adds TRUST_SUCCESS_DELTA (+3), clamps to [-100, +100], and persists.
+     */
+    recordSuccess(domain) {
+        const store = this.loadStore();
+        const current = store.balances[domain] ?? defaultBalance(domain);
+        const updated = TrustBalanceSchema.parse({
+            ...current,
+            balance: clamp(current.balance + TRUST_SUCCESS_DELTA),
+        });
+        store.balances[domain] = updated;
+        this.saveStore(store);
+        return updated;
+    }
+    /**
+     * Record a failed task for a domain.
+     * Adds TRUST_FAILURE_DELTA (-10), clamps to [-100, +100], and persists.
+     */
+    recordFailure(domain) {
+        const store = this.loadStore();
+        const current = store.balances[domain] ?? defaultBalance(domain);
+        const updated = TrustBalanceSchema.parse({
+            ...current,
+            balance: clamp(current.balance + TRUST_FAILURE_DELTA),
+        });
+        store.balances[domain] = updated;
+        this.saveStore(store);
+        return updated;
+    }
+    /**
+     * Determine the action quadrant based on trust balance and confidence.
+     *
+     * Matrix:
+     *   trust >= 20 AND confidence >= 0.50 → "autonomous"
+     *   trust >= 20 AND confidence < 0.50  → "execute_with_confirm"
+     *   trust <  20 AND confidence >= 0.50 → "execute_with_confirm"
+     *   trust <  20 AND confidence < 0.50  → "observe_and_propose"
+     */
+    getActionQuadrant(domain, confidence) {
+        const { balance } = this.getBalance(domain);
+        const highTrust = balance >= HIGH_TRUST_THRESHOLD;
+        const highConfidence = confidence >= HIGH_CONFIDENCE_THRESHOLD;
+        if (highTrust && highConfidence) {
+            return "autonomous";
+        }
+        if (!highTrust && !highConfidence) {
+            return "observe_and_propose";
+        }
+        return "execute_with_confirm";
+    }
+    /**
+     * Determine whether an action requires human approval.
+     *
+     * Returns true if:
+     *   - reversibility is "irreversible" or "unknown" (always requires approval), OR
+     *   - a permanent gate exists for the given domain and category, OR
+     *   - the action quadrant is not "autonomous"
+     */
+    requiresApproval(reversibility, domain, confidence, category) {
+        if (reversibility === "irreversible" || reversibility === "unknown") {
+            return true;
+        }
+        if (category && this.hasPermanentGate(domain, category)) {
+            return true;
+        }
+        const quadrant = this.getActionQuadrant(domain, confidence);
+        return quadrant === "observe_and_propose";
+    }
+    /**
+     * Override the trust balance for a domain to a specific value.
+     * Logs the override with a reason and persists.
+     */
+    setOverride(domain, balance, reason) {
+        const store = this.loadStore();
+        const current = store.balances[domain] ?? defaultBalance(domain);
+        const balanceBefore = current.balance;
+        const balanceAfter = clamp(balance);
+        const updated = TrustBalanceSchema.parse({
+            ...current,
+            balance: balanceAfter,
+        });
+        store.balances[domain] = updated;
+        const logEntry = TrustOverrideLogEntrySchema.parse({
+            timestamp: new Date().toISOString(),
+            override_type: "trust_grant",
+            domain,
+            target_category: null,
+            balance_before: balanceBefore,
+            balance_after: balanceAfter,
+        });
+        store.override_log.push(logEntry);
+        this.saveStore(store);
+    }
+    /**
+     * Add a permanent gate for a category within a domain.
+     * Actions with this category will always require approval regardless of trust/confidence.
+     * Logs the gate addition and persists.
+     */
+    addPermanentGate(domain, category) {
+        const store = this.loadStore();
+        if (!store.permanent_gates[domain]) {
+            store.permanent_gates[domain] = [];
+        }
+        if (!store.permanent_gates[domain].includes(category)) {
+            store.permanent_gates[domain].push(category);
+        }
+        const logEntry = TrustOverrideLogEntrySchema.parse({
+            timestamp: new Date().toISOString(),
+            override_type: "permanent_gate",
+            domain,
+            target_category: category,
+            balance_before: null,
+            balance_after: null,
+        });
+        store.override_log.push(logEntry);
+        this.saveStore(store);
+    }
+    /**
+     * Check whether a permanent gate exists for the given domain and category.
+     */
+    hasPermanentGate(domain, category) {
+        const store = this.loadStore();
+        const gates = store.permanent_gates[domain];
+        if (!gates)
+            return false;
+        return gates.includes(category);
+    }
+}
+//# sourceMappingURL=trust-manager.js.map

package/dist/trust-manager.js.map

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

package/dist/tui/actions.d.ts

@@ -0,0 +1,38 @@
+import type { RecognizedIntent } from "./intent-recognizer.js";
+import type { StateManager } from "../state-manager.js";
+import type { GoalNegotiator } from "../goal/goal-negotiator.js";
+import type { ReportingEngine } from "../reporting-engine.js";
+import type { Report } from "../types/report.js";
+export interface ActionDeps {
+    stateManager: StateManager;
+    goalNegotiator: GoalNegotiator;
+    reportingEngine: ReportingEngine;
+}
+export interface ActionResult {
+    messages: string[];
+    messageType?: "info" | "error" | "warning" | "success";
+    startLoop?: {
+        goalId: string;
+    };
+    stopLoop?: boolean;
+    showHelp?: boolean;
+    showReport?: Report;
+}
+/**
+ * Executes recognized intents against Conatus modules.
+ * Each handler maps an IntentType to a concrete operation.
+ */
+export declare class ActionHandler {
+    private deps;
+    constructor(deps: ActionDeps);
+    handle(intent: RecognizedIntent): Promise<ActionResult>;
+    private handleStart;
+    private handleStop;
+    private handleStatus;
+    private handleReport;
+    private handleGoalList;
+    private handleGoalCreate;
+    private handleHelp;
+    private handleChat;
+}
+//# sourceMappingURL=actions.d.ts.map

package/dist/tui/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/tui/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAIjD,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;GAGG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE9B,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;YA6B/C,WAAW;IAyEzB,OAAO,CAAC,UAAU;YAOJ,YAAY;YAyCZ,YAAY;YAuBZ,cAAc;YAyBd,gBAAgB;IA6C9B,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,UAAU;CAOnB"}