@made-by-moonlight/athene-core 0.9.1

package/dist/lifecycle-status-decisions.js

@@ -0,0 +1,262 @@
+import { createHash } from 'node:crypto';
+import { SESSION_STATUS, CI_STATUS, PR_STATE } from './types.js';
+import { supportsRecentLiveness } from './activity-signal.js';
+
+const DETECTING_MAX_ATTEMPTS = 3;
+/** Hard time cap for detecting state — escalate after this regardless of attempts. */
+const DETECTING_MAX_DURATION_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Create a short hash of evidence string for detecting unchanged evidence.
+ * Used to prevent counter reset when the same weak evidence re-presents.
+ */
+function normalizeEvidenceForHash(evidence) {
+    return evidence
+        .replace(/\sactivity=[^\s]+/g, "")
+        .replace(/\sat=[^\s]+/g, "")
+        .trim();
+}
+function hashEvidence(evidence) {
+    return createHash("sha256")
+        .update(normalizeEvidenceForHash(evidence))
+        .digest("hex")
+        .slice(0, 12);
+}
+function createLifecycleDecision(decision) {
+    return decision;
+}
+/**
+ * Check if detecting has exceeded its time budget.
+ */
+function isDetectingTimedOut(detectingStartedAt, now = new Date()) {
+    if (!detectingStartedAt)
+        return false;
+    const startedAt = Date.parse(detectingStartedAt);
+    if (Number.isNaN(startedAt))
+        return false;
+    return now.getTime() - startedAt > DETECTING_MAX_DURATION_MS;
+}
+function createDetectingDecision(input) {
+    const now = "now" in input && input.now ? input.now : new Date();
+    const nowIso = now.toISOString();
+    const evidenceHash = hashEvidence(input.evidence);
+    // Determine the starting time for detecting
+    // If we have a previous startedAt AND evidence is unchanged, preserve it
+    // Otherwise, start fresh
+    const previousEvidenceHash = "previousEvidenceHash" in input ? input.previousEvidenceHash : undefined;
+    const previousStartedAt = "detectingStartedAt" in input ? input.detectingStartedAt : undefined;
+    // Evidence is considered unchanged if:
+    // 1. We have a previous hash AND it matches, OR
+    // 2. We have no previous hash (first time entering detecting)
+    const evidenceChanged = previousEvidenceHash !== undefined && previousEvidenceHash !== evidenceHash;
+    const detectingStartedAt = evidenceChanged ? nowIso : (previousStartedAt ?? nowIso);
+    // Calculate attempts: reset if evidence changed, otherwise increment
+    const attempts = evidenceChanged ? 1 : input.currentAttempts + 1;
+    // Check escalation conditions: attempt limit OR time limit
+    const attemptLimitExceeded = attempts > DETECTING_MAX_ATTEMPTS;
+    const timeLimitExceeded = isDetectingTimedOut(detectingStartedAt, now);
+    if (attemptLimitExceeded || timeLimitExceeded) {
+        return createLifecycleDecision({
+            status: SESSION_STATUS.STUCK,
+            evidence: input.evidence,
+            detecting: { attempts, startedAt: detectingStartedAt, evidenceHash },
+            sessionState: "stuck",
+            sessionReason: input.idleWasBlocked ? "error_in_process" : "probe_failure",
+        });
+    }
+    return createLifecycleDecision({
+        status: SESSION_STATUS.DETECTING,
+        evidence: input.evidence,
+        detecting: { attempts, startedAt: detectingStartedAt, evidenceHash },
+        sessionState: "detecting",
+        sessionReason: input.reason ?? "probe_failure",
+    });
+}
+function resolveTerminalPRStateDecision(prState) {
+    if (prState === PR_STATE.MERGED) {
+        return createLifecycleDecision({
+            status: SESSION_STATUS.MERGED,
+            evidence: "pr_merged",
+            detecting: { attempts: 0 },
+            prState: "merged",
+            prReason: "merged",
+            sessionState: "idle",
+            sessionReason: "merged_waiting_decision",
+        });
+    }
+    if (prState === PR_STATE.CLOSED) {
+        return createLifecycleDecision({
+            status: SESSION_STATUS.IDLE,
+            evidence: "pr_closed",
+            detecting: { attempts: 0 },
+            prState: "closed",
+            prReason: "closed_unmerged",
+            sessionState: "idle",
+            sessionReason: "pr_closed_waiting_decision",
+        });
+    }
+    return null;
+}
+function resolveOpenPRDecision(input) {
+    if (input.ciFailing) {
+        return createLifecycleDecision({
+            status: SESSION_STATUS.CI_FAILED,
+            evidence: "ci_failing",
+            detecting: { attempts: 0 },
+            prState: "open",
+            prReason: "ci_failing",
+            sessionState: "working",
+            sessionReason: "fixing_ci",
+        });
+    }
+    if (input.reviewDecision === "changes_requested") {
+        return createLifecycleDecision({
+            status: SESSION_STATUS.CHANGES_REQUESTED,
+            evidence: "review_changes_requested",
+            detecting: { attempts: 0 },
+            prState: "open",
+            prReason: "changes_requested",
+            sessionState: "working",
+            sessionReason: "resolving_review_comments",
+        });
+    }
+    if (input.reviewDecision === "approved" || input.reviewDecision === "none") {
+        if (input.mergeable) {
+            return createLifecycleDecision({
+                status: SESSION_STATUS.MERGEABLE,
+                evidence: "merge_ready",
+                detecting: { attempts: 0 },
+                prState: "open",
+                prReason: "merge_ready",
+                sessionState: "idle",
+                sessionReason: "awaiting_external_review",
+            });
+        }
+        if (input.reviewDecision === "approved") {
+            return createLifecycleDecision({
+                status: SESSION_STATUS.APPROVED,
+                evidence: "review_approved",
+                detecting: { attempts: 0 },
+                prState: "open",
+                prReason: "approved",
+                sessionState: "idle",
+                sessionReason: "awaiting_external_review",
+            });
+        }
+    }
+    if (input.reviewDecision === "pending") {
+        return createLifecycleDecision({
+            status: SESSION_STATUS.REVIEW_PENDING,
+            evidence: "review_pending",
+            detecting: { attempts: 0 },
+            prState: "open",
+            prReason: "review_pending",
+            sessionState: "idle",
+            sessionReason: "awaiting_external_review",
+        });
+    }
+    if (input.shouldEscalateIdleToStuck) {
+        return createLifecycleDecision({
+            status: SESSION_STATUS.STUCK,
+            evidence: `idle_beyond_threshold ${input.activityEvidence}`,
+            detecting: { attempts: 0 },
+            prState: "open",
+            prReason: "in_progress",
+            sessionState: "stuck",
+            sessionReason: input.idleWasBlocked ? "error_in_process" : "probe_failure",
+        });
+    }
+    return createLifecycleDecision({
+        status: SESSION_STATUS.PR_OPEN,
+        evidence: "pr_open",
+        detecting: { attempts: 0 },
+        prState: "open",
+        prReason: "in_progress",
+        sessionState: "idle",
+        sessionReason: "pr_created",
+    });
+}
+function parseAttemptCount(raw) {
+    if (!raw)
+        return 0;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+}
+function resolveProbeDecision(input) {
+    const recentActivitySupportsLiveness = supportsRecentLiveness(input.activitySignal);
+    if (input.runtimeProbe.failed || input.processProbe.failed) {
+        return createDetectingDecision({
+            currentAttempts: input.currentAttempts,
+            idleWasBlocked: input.idleWasBlocked,
+            evidence: `probe_failed runtime=${input.runtimeProbe.state} process=${input.processProbe.state} ${input.activityEvidence}`,
+            detectingStartedAt: input.detectingStartedAt,
+            previousEvidenceHash: input.previousEvidenceHash,
+        });
+    }
+    if ((input.runtimeProbe.state === "dead" && input.processProbe.state === "alive") ||
+        (input.runtimeProbe.state === "alive" && input.processProbe.state === "dead") ||
+        (input.runtimeProbe.state === "dead" && recentActivitySupportsLiveness)) {
+        return createDetectingDecision({
+            currentAttempts: input.currentAttempts,
+            idleWasBlocked: input.idleWasBlocked,
+            evidence: `signal_disagreement runtime=${input.runtimeProbe.state} process=${input.processProbe.state} ${input.activityEvidence}`,
+            reason: input.runtimeProbe.state === "dead" ? "runtime_lost" : "agent_process_exited",
+            detectingStartedAt: input.detectingStartedAt,
+            previousEvidenceHash: input.previousEvidenceHash,
+        });
+    }
+    if (input.runtimeProbe.state === "dead" &&
+        input.processProbe.state === "unknown" &&
+        input.canProbeRuntimeIdentity) {
+        return createDetectingDecision({
+            currentAttempts: input.currentAttempts,
+            idleWasBlocked: input.idleWasBlocked,
+            evidence: `runtime_dead process_unknown ${input.activityEvidence}`,
+            reason: "runtime_lost",
+            detectingStartedAt: input.detectingStartedAt,
+            previousEvidenceHash: input.previousEvidenceHash,
+        });
+    }
+    if (input.runtimeProbe.state === "dead" &&
+        input.processProbe.state === "dead" &&
+        !recentActivitySupportsLiveness) {
+        return createLifecycleDecision({
+            status: SESSION_STATUS.KILLED,
+            evidence: `runtime_dead process_dead ${input.activityEvidence}`,
+            detecting: { attempts: 0 },
+            sessionState: "terminated",
+            sessionReason: "runtime_lost",
+        });
+    }
+    return null;
+}
+function resolvePREnrichmentDecision(cachedData, options) {
+    const terminalDecision = resolveTerminalPRStateDecision(cachedData.state);
+    if (terminalDecision) {
+        return terminalDecision;
+    }
+    return resolveOpenPRDecision({
+        reviewDecision: cachedData.reviewDecision,
+        ciFailing: cachedData.ciStatus === CI_STATUS.FAILING,
+        mergeable: cachedData.mergeable,
+        shouldEscalateIdleToStuck: options.shouldEscalateIdleToStuck,
+        idleWasBlocked: options.idleWasBlocked,
+        activityEvidence: options.activityEvidence,
+    });
+}
+function resolvePRLiveDecision(input) {
+    const terminalDecision = resolveTerminalPRStateDecision(input.prState);
+    if (terminalDecision) {
+        return terminalDecision;
+    }
+    return resolveOpenPRDecision({
+        reviewDecision: input.reviewDecision,
+        ciFailing: input.ciStatus === CI_STATUS.FAILING,
+        mergeable: input.mergeable,
+        shouldEscalateIdleToStuck: input.shouldEscalateIdleToStuck,
+        idleWasBlocked: input.idleWasBlocked,
+        activityEvidence: input.activityEvidence,
+    });
+}
+
+export { DETECTING_MAX_ATTEMPTS, DETECTING_MAX_DURATION_MS, createDetectingDecision, hashEvidence, isDetectingTimedOut, parseAttemptCount, resolvePREnrichmentDecision, resolvePRLiveDecision, resolveProbeDecision };
+//# sourceMappingURL=lifecycle-status-decisions.js.map

package/dist/lifecycle-status-decisions.js.map

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

package/dist/lifecycle-transition.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Lifecycle Transition Service
+ *
+ * Centralizes all lifecycle state mutations behind a single boundary.
+ * This module ensures:
+ * - Consistent timestamp handling
+ * - Before/after state capture for observability
+ * - Atomic metadata persistence
+ * - Validation before mutation
+ *
+ * All lifecycle changes (from polling, agent reports, spawn, kill) should
+ * flow through this module.
+ */
+import type { CanonicalSessionLifecycle, CanonicalSessionReason, CanonicalSessionState, SessionId, SessionStatus } from "./types.js";
+import type { LifecycleDecision } from "./lifecycle-status-decisions.js";
+/**
+ * Source of the lifecycle transition — used for audit and observability.
+ */
+export type TransitionSource = "poll" | "agent_report" | "spawn" | "restore" | "kill" | "cleanup" | "claim_pr";
+/**
+ * Result of a lifecycle transition attempt.
+ */
+export interface TransitionResult {
+    success: boolean;
+    /** The previous lifecycle state (before mutation). */
+    previousLifecycle: CanonicalSessionLifecycle;
+    /** The new lifecycle state (after mutation). */
+    nextLifecycle: CanonicalSessionLifecycle;
+    /** The previous legacy status. */
+    previousStatus: SessionStatus;
+    /** The new legacy status. */
+    nextStatus: SessionStatus;
+    /** ISO timestamp when the transition occurred. */
+    transitionedAt: string;
+    /** Whether the status actually changed. */
+    statusChanged: boolean;
+    /** Reason if transition was rejected. */
+    rejectionReason?: string;
+}
+/**
+ * Input for applying a lifecycle decision.
+ */
+export interface ApplyDecisionInput {
+    dataDir: string;
+    sessionId: SessionId;
+    decision: LifecycleDecision;
+    /** Additional metadata to persist alongside the lifecycle. */
+    additionalMetadata?: Record<string, string>;
+    /** Source of the transition for observability. */
+    source: TransitionSource;
+    /** Override the current time (for testing). */
+    now?: Date;
+}
+/**
+ * Apply a lifecycle decision to the in-memory lifecycle object.
+ * This mutates the lifecycle in place.
+ */
+export declare function applyDecisionToLifecycle(lifecycle: CanonicalSessionLifecycle, decision: LifecycleDecision, nowIso: string): void;
+/**
+ * Build the full metadata patch for a lifecycle poll transition.
+ * Unlike buildLifecycleMetadataPatch(), this includes detecting metadata
+ * (attempts, startedAt, evidenceHash) and lifecycle evidence from the decision.
+ * Used exclusively by the lifecycle manager polling loop.
+ */
+export declare function buildTransitionMetadataPatch(lifecycle: CanonicalSessionLifecycle, decision: LifecycleDecision): Record<string, string>;
+/**
+ * Apply a lifecycle decision and persist to metadata.
+ *
+ * This is the primary entry point for lifecycle mutations. It:
+ * 1. Reads the current lifecycle state
+ * 2. Validates the transition (if applicable)
+ * 3. Applies the decision to the lifecycle
+ * 4. Persists the updated lifecycle and metadata
+ * 5. Returns before/after state for observability
+ */
+export declare function applyLifecycleDecision(input: ApplyDecisionInput): TransitionResult;
+/**
+ * Helper to create a minimal lifecycle decision for direct state updates.
+ */
+export declare function createStateTransitionDecision(status: SessionStatus, state: CanonicalSessionState, reason: CanonicalSessionReason, evidence: string): LifecycleDecision;
+//# sourceMappingURL=lifecycle-transition.d.ts.map

package/dist/lifecycle-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-transition.d.ts","sourceRoot":"","sources":["../src/lifecycle-transition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,SAAS,EACT,aAAa,EACd,MAAM,YAAY,CAAC;AAOpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,cAAc,GACd,OAAO,GACP,SAAS,GACT,MAAM,GACN,SAAS,GACT,UAAU,CAAC;AAGf;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,gDAAgD;IAChD,aAAa,EAAE,yBAAyB,CAAC;IACzC,kCAAkC;IAClC,cAAc,EAAE,aAAa,CAAC;IAC9B,6BAA6B;IAC7B,UAAU,EAAE,aAAa,CAAC;IAC1B,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,kDAAkD;IAClD,MAAM,EAAE,gBAAgB,CAAC;IACzB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,yBAAyB,EACpC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,GACb,IAAI,CA6BN;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,yBAAyB,EACpC,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsCxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,GACxB,gBAAgB,CA4ElB;AAkCD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAQnB"}

package/dist/lifecycle-transition.js

@@ -0,0 +1,207 @@
+import { clearTerminalMarkersForNonTerminalState, cloneLifecycle, deriveLegacyStatus } from './lifecycle-state.js';
+import { readMetadataRaw, readCanonicalLifecycle, updateMetadata } from './metadata.js';
+
+/**
+ * Lifecycle Transition Service
+ *
+ * Centralizes all lifecycle state mutations behind a single boundary.
+ * This module ensures:
+ * - Consistent timestamp handling
+ * - Before/after state capture for observability
+ * - Atomic metadata persistence
+ * - Validation before mutation
+ *
+ * All lifecycle changes (from polling, agent reports, spawn, kill) should
+ * flow through this module.
+ */
+/**
+ * Apply a lifecycle decision to the in-memory lifecycle object.
+ * This mutates the lifecycle in place.
+ */
+function applyDecisionToLifecycle(lifecycle, decision, nowIso) {
+    // Apply PR state if present
+    if (decision.prState) {
+        lifecycle.pr.state = decision.prState;
+        lifecycle.pr.lastObservedAt = nowIso;
+    }
+    if (decision.prReason) {
+        lifecycle.pr.reason = decision.prReason;
+    }
+    // Apply session state if present
+    if (decision.sessionState && decision.sessionReason) {
+        lifecycle.session.state = decision.sessionState;
+        lifecycle.session.reason = decision.sessionReason;
+        lifecycle.session.lastTransitionAt = nowIso;
+        // Handle special timestamp fields (only set if not already set)
+        if (decision.sessionState === "working" && lifecycle.session.startedAt === null) {
+            lifecycle.session.startedAt = nowIso;
+        }
+        if (decision.sessionState === "done" && lifecycle.session.completedAt === null) {
+            lifecycle.session.completedAt = nowIso;
+        }
+        if (decision.sessionState === "terminated" && lifecycle.session.terminatedAt === null) {
+            lifecycle.session.terminatedAt = nowIso;
+        }
+    }
+    clearTerminalMarkersForNonTerminalState(lifecycle);
+}
+/**
+ * Build the full metadata patch for a lifecycle poll transition.
+ * Unlike buildLifecycleMetadataPatch(), this includes detecting metadata
+ * (attempts, startedAt, evidenceHash) and lifecycle evidence from the decision.
+ * Used exclusively by the lifecycle manager polling loop.
+ */
+function buildTransitionMetadataPatch(lifecycle, decision) {
+    const patch = {
+        lifecycle: JSON.stringify(lifecycle),
+        // status is NOT persisted — computed on read via deriveLegacyStatus()
+    };
+    // Include lifecycle evidence
+    if (decision.evidence) {
+        patch["lifecycleEvidence"] = decision.evidence;
+    }
+    // Include detecting metadata
+    if (decision.detecting.attempts > 0) {
+        patch["detectingAttempts"] = String(decision.detecting.attempts);
+    }
+    else {
+        patch["detectingAttempts"] = "";
+    }
+    if (decision.detecting.startedAt) {
+        patch["detectingStartedAt"] = decision.detecting.startedAt;
+    }
+    else {
+        patch["detectingStartedAt"] = "";
+    }
+    if (decision.detecting.evidenceHash) {
+        patch["detectingEvidenceHash"] = decision.detecting.evidenceHash;
+    }
+    else {
+        patch["detectingEvidenceHash"] = "";
+    }
+    patch["pr"] = lifecycle.pr.url ?? "";
+    patch["runtimeHandle"] = lifecycle.runtime.handle ? JSON.stringify(lifecycle.runtime.handle) : "";
+    patch["tmuxName"] = lifecycle.runtime.tmuxName ?? "";
+    patch["role"] = lifecycle.session.kind === "orchestrator" ? "orchestrator" : "";
+    return patch;
+}
+/**
+ * Apply a lifecycle decision and persist to metadata.
+ *
+ * This is the primary entry point for lifecycle mutations. It:
+ * 1. Reads the current lifecycle state
+ * 2. Validates the transition (if applicable)
+ * 3. Applies the decision to the lifecycle
+ * 4. Persists the updated lifecycle and metadata
+ * 5. Returns before/after state for observability
+ */
+function applyLifecycleDecision(input) {
+    const now = input.now ?? new Date();
+    const nowIso = now.toISOString();
+    // Read current state
+    const rawMeta = readMetadataRaw(input.dataDir, input.sessionId);
+    if (!rawMeta) {
+        const emptyLifecycle = createEmptyLifecycle();
+        return {
+            success: false,
+            previousLifecycle: emptyLifecycle,
+            nextLifecycle: emptyLifecycle,
+            previousStatus: "working",
+            nextStatus: "working",
+            transitionedAt: nowIso,
+            statusChanged: false,
+            rejectionReason: `Session not found: ${input.sessionId}`,
+        };
+    }
+    const currentLifecycle = readCanonicalLifecycle(input.dataDir, input.sessionId);
+    if (!currentLifecycle) {
+        const emptyLifecycle = createEmptyLifecycle();
+        return {
+            success: false,
+            previousLifecycle: emptyLifecycle,
+            nextLifecycle: emptyLifecycle,
+            previousStatus: "working",
+            nextStatus: "working",
+            transitionedAt: nowIso,
+            statusChanged: false,
+            rejectionReason: `Failed to read lifecycle for session: ${input.sessionId}`,
+        };
+    }
+    const previousLifecycle = cloneLifecycle(currentLifecycle);
+    const previousStatus = deriveLegacyStatus(previousLifecycle);
+    // Apply the decision to the lifecycle
+    const nextLifecycle = cloneLifecycle(currentLifecycle);
+    applyDecisionToLifecycle(nextLifecycle, input.decision, nowIso);
+    const nextStatus = deriveLegacyStatus(nextLifecycle);
+    const statusChanged = nextStatus !== previousStatus;
+    // Build metadata patch, starting with additional metadata (so lifecycle keys take precedence)
+    const metadataPatch = {};
+    // Apply additional metadata first
+    if (input.additionalMetadata) {
+        for (const [key, value] of Object.entries(input.additionalMetadata)) {
+            metadataPatch[key] = value;
+        }
+    }
+    // Apply lifecycle patch second (overwrites any conflicting keys from additionalMetadata)
+    const lifecyclePatch = buildTransitionMetadataPatch(nextLifecycle, input.decision);
+    for (const [key, value] of Object.entries(lifecyclePatch)) {
+        metadataPatch[key] = value;
+    }
+    // Persist
+    updateMetadata(input.dataDir, input.sessionId, metadataPatch);
+    return {
+        success: true,
+        previousLifecycle,
+        nextLifecycle,
+        previousStatus,
+        nextStatus,
+        transitionedAt: nowIso,
+        statusChanged,
+    };
+}
+/**
+ * Create an empty lifecycle for error cases.
+ */
+function createEmptyLifecycle() {
+    return {
+        version: 2,
+        session: {
+            kind: "worker",
+            state: "not_started",
+            reason: "spawn_requested",
+            startedAt: null,
+            completedAt: null,
+            terminatedAt: null,
+            lastTransitionAt: new Date().toISOString(),
+        },
+        pr: {
+            state: "none",
+            reason: "not_created",
+            number: null,
+            url: null,
+            lastObservedAt: null,
+        },
+        runtime: {
+            state: "unknown",
+            reason: "spawn_incomplete",
+            lastObservedAt: null,
+            handle: null,
+            tmuxName: null,
+        },
+    };
+}
+/**
+ * Helper to create a minimal lifecycle decision for direct state updates.
+ */
+function createStateTransitionDecision(status, state, reason, evidence) {
+    return {
+        status,
+        evidence,
+        detecting: { attempts: 0 },
+        sessionState: state,
+        sessionReason: reason,
+    };
+}
+
+export { applyDecisionToLifecycle, applyLifecycleDecision, buildTransitionMetadataPatch, createStateTransitionDecision };
+//# sourceMappingURL=lifecycle-transition.js.map

package/dist/lifecycle-transition.js.map

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

package/dist/metadata.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Session metadata read/write — JSON format.
+ *
+ * V2 storage layout:
+ * - Session metadata: ~/.agent-orchestrator/projects/{projectId}/sessions/{sessionId}.json
+ * - Orchestrator metadata: ~/.agent-orchestrator/projects/{projectId}/orchestrator.json
+ *
+ * Format: JSON (2-space indented), one object per file.
+ * Status: computed on read from lifecycle via deriveLegacyStatus().
+ * Pre-lifecycle sessions retain a stored status field; lifecycle sessions omit it on write.
+ */
+import type { CanonicalSessionLifecycle, SessionId, SessionMetadata } from "./types.js";
+import { type ActivityEventSource } from "./activity-events.js";
+/**
+ * Read metadata for a session. Returns null if the file doesn't exist.
+ */
+export declare function readMetadata(dataDir: string, sessionId: SessionId): SessionMetadata | null;
+/**
+ * Read raw metadata as a plain object (for arbitrary key access).
+ */
+export declare function readMetadataRaw(dataDir: string, sessionId: SessionId): Record<string, string> | null;
+/**
+ * Write full metadata for a session (overwrites existing file).
+ */
+export declare function writeMetadata(dataDir: string, sessionId: SessionId, metadata: SessionMetadata): void;
+/**
+ * Update specific fields in a session's metadata.
+ * Reads existing file, merges updates, writes back.
+ */
+export declare function updateMetadata(dataDir: string, sessionId: SessionId, updates: Partial<Record<string, string>>): void;
+export declare function applyMetadataUpdates(existing: Record<string, string>, updates: Partial<Record<string, string>>): Record<string, string>;
+export interface MutateMetadataOptions {
+    createIfMissing?: boolean;
+    activityEventSource?: ActivityEventSource;
+}
+export declare function mutateMetadata(dataDir: string, sessionId: SessionId, updater: (existing: Record<string, string>) => Record<string, string>, options?: MutateMetadataOptions): Record<string, string> | null;
+export declare function readCanonicalLifecycle(dataDir: string, sessionId: SessionId): CanonicalSessionLifecycle | null;
+export declare function writeCanonicalLifecycle(dataDir: string, sessionId: SessionId, lifecycle: CanonicalSessionLifecycle): void;
+export declare function updateCanonicalLifecycle(dataDir: string, sessionId: SessionId, updater: (current: CanonicalSessionLifecycle) => CanonicalSessionLifecycle): CanonicalSessionLifecycle | null;
+/**
+ * Delete a session's metadata file permanently.
+ */
+export declare function deleteMetadata(dataDir: string, sessionId: SessionId): void;
+/**
+ * List all session IDs that have metadata files.
+ * Reads .json files from the sessions directory.
+ */
+export declare function listMetadata(dataDir: string): SessionId[];
+/**
+ * Atomically reserve a session ID by creating its metadata file with O_EXCL.
+ * Returns true if the ID was successfully reserved, false if it already exists.
+ */
+export declare function reserveSessionId(dataDir: string, sessionId: SessionId): boolean;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,OAAO,KAAK,EACV,yBAAyB,EAEzB,SAAS,EACT,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AA8GrF;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,eAAe,GAAG,IAAI,CA4D1F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAuB/B;AA2CD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,eAAe,GACxB,IAAI,CAsCN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxB;AAQD,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrE,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA8E/B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,yBAAyB,GAAG,IAAI,CAIlC;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,yBAAyB,GACnC,IAAI,CAEN;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,yBAAyB,GACzE,yBAAyB,GAAG,IAAI,CAUlC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAS1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAkBzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAU/E"}