@ouro.bot/cli 0.1.0-alpha.55 → 0.1.0-alpha.551

package/dist/heart/background-operations.js

@@ -0,0 +1,281 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readBackgroundOperation = readBackgroundOperation;
+exports.listBackgroundOperations = listBackgroundOperations;
+exports.startBackgroundOperation = startBackgroundOperation;
+exports.markBackgroundOperationRunning = markBackgroundOperationRunning;
+exports.updateBackgroundOperation = updateBackgroundOperation;
+exports.completeBackgroundOperation = completeBackgroundOperation;
+exports.failBackgroundOperation = failBackgroundOperation;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const runtime_1 = require("../nerves/runtime");
+const identity_1 = require("./identity");
+function operationsDir(agentName, agentRoot = (0, identity_1.getAgentRoot)(agentName)) {
+    return path.join(agentRoot, "state", "background-operations");
+}
+function operationPath(locator) {
+    return path.join(operationsDir(locator.agentName, locator.agentRoot), `${locator.id}.json`);
+}
+function normalizeProgress(progress) {
+    if (!progress)
+        return undefined;
+    const normalized = {};
+    if (typeof progress.current === "number" && Number.isFinite(progress.current))
+        normalized.current = progress.current;
+    if (typeof progress.total === "number" && Number.isFinite(progress.total))
+        normalized.total = progress.total;
+    if (typeof progress.unit === "string" && progress.unit.trim().length > 0)
+        normalized.unit = progress.unit.trim();
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function normalizeRecord(record) {
+    if (record.schemaVersion !== 1)
+        return null;
+    if (typeof record.id !== "string" || record.id.trim().length === 0)
+        return null;
+    if (typeof record.agentName !== "string" || record.agentName.trim().length === 0)
+        return null;
+    if (typeof record.kind !== "string" || record.kind.trim().length === 0)
+        return null;
+    if (typeof record.title !== "string" || record.title.trim().length === 0)
+        return null;
+    if (typeof record.summary !== "string" || record.summary.trim().length === 0)
+        return null;
+    if (typeof record.createdAt !== "string" || record.createdAt.trim().length === 0)
+        return null;
+    if (typeof record.updatedAt !== "string" || record.updatedAt.trim().length === 0)
+        return null;
+    if (record.status !== "queued"
+        && record.status !== "running"
+        && record.status !== "succeeded"
+        && record.status !== "failed") {
+        return null;
+    }
+    const normalized = {
+        schemaVersion: 1,
+        id: record.id,
+        agentName: record.agentName,
+        kind: record.kind,
+        title: record.title,
+        status: record.status,
+        summary: record.summary,
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt,
+    };
+    if (typeof record.detail === "string" && record.detail.trim().length > 0)
+        normalized.detail = record.detail.trim();
+    if (typeof record.startedAt === "string" && record.startedAt.trim().length > 0)
+        normalized.startedAt = record.startedAt;
+    if (typeof record.finishedAt === "string" && record.finishedAt.trim().length > 0)
+        normalized.finishedAt = record.finishedAt;
+    const progress = normalizeProgress(record.progress);
+    if (progress)
+        normalized.progress = progress;
+    if (record.spec && typeof record.spec === "object" && !Array.isArray(record.spec))
+        normalized.spec = { ...record.spec };
+    if (record.result && typeof record.result === "object" && !Array.isArray(record.result))
+        normalized.result = { ...record.result };
+    if (record.error && typeof record.error.message === "string" && record.error.message.trim().length > 0) {
+        normalized.error = { message: record.error.message.trim() };
+    }
+    if (record.failure && typeof record.failure === "object" && !Array.isArray(record.failure)) {
+        const failureClass = typeof record.failure.class === "string" ? record.failure.class.trim() : "";
+        const retryDisposition = record.failure.retryDisposition;
+        const hint = typeof record.failure.hint === "string" ? record.failure.hint.trim() : "";
+        if (failureClass) {
+            normalized.failure = {
+                class: failureClass,
+                ...(retryDisposition === "retry-safe" || retryDisposition === "fix-before-retry" || retryDisposition === "investigate-first"
+                    ? { retryDisposition }
+                    : {}),
+                ...(hint ? { hint } : {}),
+            };
+        }
+    }
+    if (Array.isArray(record.remediation)) {
+        const remediation = record.remediation.filter((entry) => typeof entry === "string" && entry.trim().length > 0);
+        if (remediation.length > 0)
+            normalized.remediation = remediation;
+    }
+    return normalized;
+}
+function readRecord(filePath) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        return normalizeRecord(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+function specText(spec, key) {
+    const value = spec?.[key];
+    return typeof value === "string" ? value.trim() : "";
+}
+function visibleOperationKey(record) {
+    if (record.kind !== "mail.import-mbox")
+        return null;
+    const filePath = specText(record.spec, "filePath");
+    if (!filePath)
+        return null;
+    const ownerEmail = specText(record.spec, "ownerEmail").toLowerCase();
+    const source = specText(record.spec, "source").toLowerCase();
+    return `${record.agentName.toLowerCase()}|${record.kind}|${filePath}|${ownerEmail}|${source}`;
+}
+function writeRecord(locator, record) {
+    const normalized = normalizeRecord(record);
+    if (!normalized) {
+        throw new Error(`invalid background operation record: ${locator.id}`);
+    }
+    fs.mkdirSync(operationsDir(locator.agentName, locator.agentRoot), { recursive: true });
+    fs.writeFileSync(operationPath(locator), `${JSON.stringify(normalized, null, 2)}\n`, "utf-8");
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.background_operation_written",
+        message: "background operation state written",
+        meta: { agentName: locator.agentName, id: locator.id, kind: normalized.kind, status: normalized.status },
+    });
+    return normalized;
+}
+function requireRecord(locator) {
+    const record = readBackgroundOperation(locator);
+    if (!record) {
+        throw new Error(`background operation not found: ${locator.id}`);
+    }
+    return record;
+}
+function readBackgroundOperation(locator) {
+    return readRecord(operationPath(locator));
+}
+function listBackgroundOperations(input) {
+    const dir = operationsDir(input.agentName, input.agentRoot);
+    if (!fs.existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const records = entries
+        .filter((entry) => entry.endsWith(".json"))
+        .map((entry) => readRecord(path.join(dir, entry)))
+        .filter((entry) => entry !== null)
+        .sort((left, right) => Date.parse(right.updatedAt) - Date.parse(left.updatedAt));
+    const visibleKeys = new Set();
+    const visible = records.filter((record) => {
+        const key = visibleOperationKey(record);
+        if (!key)
+            return true;
+        if (visibleKeys.has(key))
+            return false;
+        visibleKeys.add(key);
+        return true;
+    });
+    return visible.slice(0, input.limit ?? 10);
+}
+function startBackgroundOperation(input) {
+    return writeRecord(input, {
+        schemaVersion: 1,
+        id: input.id,
+        agentName: input.agentName,
+        kind: input.kind,
+        title: input.title,
+        status: "queued",
+        summary: input.summary,
+        createdAt: input.createdAt,
+        updatedAt: input.createdAt,
+        ...(input.spec ? { spec: input.spec } : {}),
+    });
+}
+function markBackgroundOperationRunning(input) {
+    const current = requireRecord(input);
+    const updatedAt = input.updatedAt ?? input.startedAt;
+    return writeRecord(input, {
+        ...current,
+        status: "running",
+        summary: input.summary ?? current.summary,
+        ...(input.detail ? { detail: input.detail } : {}),
+        ...(normalizeProgress(input.progress) ? { progress: normalizeProgress(input.progress) } : {}),
+        startedAt: input.startedAt,
+        updatedAt,
+        ...(current.finishedAt ? { finishedAt: current.finishedAt } : {}),
+    });
+}
+function updateBackgroundOperation(input) {
+    const current = requireRecord(input);
+    return writeRecord(input, {
+        ...current,
+        summary: input.summary ?? current.summary,
+        ...(input.detail ? { detail: input.detail } : {}),
+        ...(normalizeProgress(input.progress) ? { progress: normalizeProgress(input.progress) } : {}),
+        ...(input.spec ? { spec: input.spec } : {}),
+        updatedAt: input.updatedAt ?? current.updatedAt,
+    });
+}
+function completeBackgroundOperation(input) {
+    const current = requireRecord(input);
+    return writeRecord(input, {
+        ...current,
+        status: "succeeded",
+        summary: input.summary ?? current.summary,
+        ...(input.detail ? { detail: input.detail } : {}),
+        ...(normalizeProgress(input.progress) ? { progress: normalizeProgress(input.progress) } : {}),
+        ...(input.result ? { result: input.result } : {}),
+        error: undefined,
+        remediation: undefined,
+        failure: undefined,
+        finishedAt: input.finishedAt,
+        updatedAt: input.updatedAt ?? input.finishedAt,
+    });
+}
+function failBackgroundOperation(input) {
+    const current = requireRecord(input);
+    return writeRecord(input, {
+        ...current,
+        status: "failed",
+        summary: input.summary ?? current.summary,
+        ...(input.detail ? { detail: input.detail } : {}),
+        ...(normalizeProgress(input.progress) ? { progress: normalizeProgress(input.progress) } : {}),
+        error: { message: input.error },
+        ...(input.failure ? { failure: input.failure } : {}),
+        ...(input.remediation && input.remediation.length > 0 ? { remediation: input.remediation } : {}),
+        finishedAt: input.finishedAt,
+        updatedAt: input.updatedAt ?? input.finishedAt,
+    });
+}

package/dist/heart/bundle-state.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectBundleState = detectBundleState;
+exports.renderBundleStateHint = renderBundleStateHint;
+/**
+ * Bundle state detection: inspects an agent bundle's git + pending-sync
+ * state and returns a structured list of issues the agent needs to remediate
+ * via its `bundle_*` tools.
+ *
+ * Previously the sync pipeline surfaced a single free-form `syncFailure`
+ * string that was good for humans but hard for the agent to act on. The
+ * new `BundleStateIssue` enum lets the agent pattern-match on discrete
+ * cases and pick the correct remediation tool (shipping in PR 6).
+ *
+ * Detection never throws: every git call is wrapped in try/catch so a
+ * broken bundle or a missing git binary degrades to an empty array or a
+ * `not_a_git_repo` signal rather than exploding the turn pipeline.
+ *
+ * The classification returned here is detected from bundle state +
+ * the `classification` field of `state/pending-sync.json` (written by
+ * `postTurnPush` in sync.ts when it writes the pending-sync record).
+ *
+ *   - `not_a_git_repo`: `.git` directory missing.
+ *   - `no_remote_configured`: `git remote` returns empty.
+ *   - `first_commit_never_happened`: `.git` exists but `git rev-parse HEAD`
+ *     fails (fresh `git init` with nothing committed).
+ *   - `pending_sync_exists`: `state/pending-sync.json` exists — the agent
+ *     should inspect it and clear the pending state.
+ *   - `remote_push_failed`: pending-sync classified as `push_rejected` —
+ *     the remote advanced and a simple retry won't work.
+ *   - `pull_rebase_conflict`: pending-sync classified as
+ *     `pull_rebase_conflict` — the rebase left conflicted files the agent
+ *     has to walk the user through resolving.
+ */
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+function detectBundleState(agentRoot, deps = {}) {
+    const exec = deps.execFileSync ?? child_process_1.execFileSync;
+    const exists = deps.existsSync ?? fs.existsSync;
+    const readFile = deps.readFileSync ?? ((p, enc) => fs.readFileSync(p, enc));
+    const issues = [];
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.bundle_state_detect_start",
+        message: "detecting bundle state",
+        meta: { agentRoot },
+    });
+    const gitDir = path.join(agentRoot, ".git");
+    const isGitRepo = exists(gitDir);
+    if (!isGitRepo) {
+        issues.push("not_a_git_repo");
+    }
+    else {
+        // Check remote presence
+        try {
+            const remoteOutput = exec("git", ["remote"], {
+                cwd: agentRoot,
+                stdio: "pipe",
+                timeout: 5000,
+            }).toString().trim();
+            if (remoteOutput.length === 0) {
+                issues.push("no_remote_configured");
+            }
+        }
+        catch {
+            // Git missing or broken — treat as no_remote_configured so the
+            // agent surfaces a "fix git" signal rather than a silent pass.
+            issues.push("no_remote_configured");
+        }
+        // Check for initial commit
+        try {
+            exec("git", ["rev-parse", "HEAD"], {
+                cwd: agentRoot,
+                stdio: "pipe",
+                timeout: 5000,
+            });
+        }
+        catch {
+            issues.push("first_commit_never_happened");
+        }
+    }
+    // Pending-sync file — independent of git state (could exist on a bundle
+    // that was a repo and then had its .git deleted). When present, also
+    // inspect the classification field to surface the specific failure
+    // mode as an additional issue.
+    const pendingSyncPath = path.join(agentRoot, "state", "pending-sync.json");
+    if (exists(pendingSyncPath)) {
+        issues.push("pending_sync_exists");
+        try {
+            const raw = readFile(pendingSyncPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (parsed.classification === "push_rejected") {
+                issues.push("remote_push_failed");
+            }
+            else if (parsed.classification === "pull_rebase_conflict") {
+                issues.push("pull_rebase_conflict");
+            }
+        }
+        catch {
+            // Malformed or unreadable pending-sync.json — pending_sync_exists
+            // alone is enough signal for the agent to investigate.
+        }
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.bundle_state_detect_end",
+        message: `bundle state detected: ${issues.length} issue(s)`,
+        meta: { agentRoot, issues },
+    });
+    return issues;
+}
+/**
+ * First-person remediation hint text for the start-of-turn packet. Reads
+ * as the agent's own voice per the declarative first-person note rule.
+ * Returns empty string when there are no issues (so the packet renderer
+ * can skip the section entirely).
+ */
+function renderBundleStateHint(issues) {
+    if (issues.length === 0)
+        return "";
+    const labels = {
+        not_a_git_repo: "not a git repo",
+        no_remote_configured: "no remote configured",
+        first_commit_never_happened: "first commit never happened",
+        pending_sync_exists: "pending sync from a prior turn",
+        remote_push_failed: "remote push rejected (remote advanced)",
+        pull_rebase_conflict: "pull-rebase left conflicts i need to walk the user through",
+    };
+    const list = issues.map((issue) => labels[issue]).join(", ");
+    return (`my bundle has unresolved git state: ${list}. ` +
+        `i have the bundle_* tools available to fix this — i should run ` +
+        `bundle_check_sync_status first, then use the appropriate remediation tool.`);
+}

package/dist/heart/commitments.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveCommitments = deriveCommitments;
+exports.formatCommitments = formatCommitments;
+const obligations_1 = require("../arc/obligations");
+const runtime_1 = require("../nerves/runtime");
+function describeActiveObligation(obligation) {
+    if (obligation.status === "pending") {
+        return `i owe ${obligation.origin.friendId}: ${obligation.content}`;
+    }
+    const surface = obligation.currentSurface?.label;
+    const statusText = obligation.status.replaceAll("_", " ");
+    if (surface) {
+        return `i owe ${obligation.origin.friendId}: ${obligation.content} (${statusText} in ${surface})`;
+    }
+    return `i owe ${obligation.origin.friendId}: ${obligation.content} (${statusText})`;
+}
+function deriveCommitments(activeWorkFrame, innerJob, pendingObligations) {
+    const committedTo = [];
+    const completionCriteria = [];
+    const safeToIgnore = [];
+    // Persistent obligations from the obligation store
+    // Sort by status priority: investigating/waiting/updating before pending
+    if (pendingObligations && pendingObligations.length > 0) {
+        const sorted = [...pendingObligations].sort((a, b) => {
+            const advancedA = a.status !== "pending" && a.status !== "fulfilled" ? 0 : 1;
+            const advancedB = b.status !== "pending" && b.status !== "fulfilled" ? 0 : 1;
+            return advancedA - advancedB;
+        });
+        let hasAdvancedObligation = false;
+        for (const ob of sorted) {
+            if (!(0, obligations_1.isOpenObligationStatus)(ob.status))
+                continue;
+            committedTo.push(describeActiveObligation(ob));
+            if (ob.status !== "pending")
+                hasAdvancedObligation = true;
+        }
+        completionCriteria.push("fulfill my outstanding obligations");
+        if (hasAdvancedObligation) {
+            completionCriteria.push("close my active obligation loops");
+        }
+    }
+    // Inner job
+    if (innerJob.status === "queued" || innerJob.status === "running") {
+        const contentSuffix = innerJob.content ? ` -- ${innerJob.content.slice(0, 60)}` : "";
+        committedTo.push(`i'm thinking through something privately${contentSuffix}`);
+    }
+    else if (innerJob.status === "surfaced") {
+        committedTo.push("i finished thinking about something and need to bring it back");
+    }
+    // mustResolveBeforeHandoff
+    if (activeWorkFrame.mustResolveBeforeHandoff) {
+        committedTo.push("i need to finish what i started before moving on");
+        completionCriteria.push("resolve the current thread before moving on");
+    }
+    // Bridges
+    for (const bridge of activeWorkFrame.bridges) {
+        committedTo.push(`i have shared work: ${bridge.summary || bridge.objective}`);
+    }
+    if (activeWorkFrame.bridges.length > 0) {
+        completionCriteria.push("keep shared work aligned across sessions");
+    }
+    // Tasks
+    for (const taskName of activeWorkFrame.taskPressure?.liveTaskNames ?? []) {
+        committedTo.push(`i'm tracking: ${taskName}`);
+    }
+    // Obligation completion criteria
+    if (innerJob.obligationStatus === "pending") {
+        const name = innerJob.origin?.friendName ?? innerJob.origin?.friendId ?? "them";
+        completionCriteria.push(`bring my answer back to ${name}`);
+    }
+    // Default completion criteria
+    if (completionCriteria.length === 0) {
+        completionCriteria.push("just be present in this conversation");
+    }
+    // Safe to ignore
+    if (innerJob.status === "idle" && !(activeWorkFrame.inner?.hasPending)) {
+        safeToIgnore.push("no private thinking in progress");
+    }
+    if (activeWorkFrame.bridges.length === 0) {
+        safeToIgnore.push("no shared work to coordinate");
+    }
+    if ((activeWorkFrame.taskPressure?.liveTaskNames ?? []).length === 0) {
+        safeToIgnore.push("no active tasks to track");
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.commitments_derive",
+        message: "derived commitments frame",
+        meta: { committedCount: committedTo.length, criteriaCount: completionCriteria.length },
+    });
+    return { committedTo, completionCriteria, safeToIgnore };
+}
+function formatCommitments(commitments) {
+    const sections = [];
+    if (commitments.committedTo.length === 0) {
+        sections.push("i'm not holding anything specific right now. i'm free to be present.");
+    }
+    else {
+        sections.push("## what i'm holding right now");
+        sections.push("");
+        sections.push(commitments.committedTo.map((c) => `- ${c}`).join("\n"));
+    }
+    sections.push("");
+    sections.push("## what \"done\" looks like");
+    sections.push(commitments.completionCriteria.map((c) => `- ${c}`).join("\n"));
+    sections.push("");
+    sections.push("## what i can let go of");
+    sections.push(commitments.safeToIgnore.map((c) => `- ${c}`).join("\n"));
+    return sections.join("\n");
+}