@telora/daemon 0.21.98 → 0.21.134

package/dist/directive/close-loop-stage.d.ts

@@ -1,50 +0,0 @@
-/**
- * Close-loop stage dispatcher.
- *
- * Drives the `close_loop` lifecycle stage for a focus: classify anchored
- * injections by terminal state, then short-circuit to done, spawn the
- * one-shot bookkeeper team, advance with an injection sweep, or hold.
- * The pure decision logic lives in close-loop-dispatcher.ts; this module
- * is the impure dispatch around it. Extracted from directive-executor.ts;
- * the executor re-exports the public surface so existing importers are
- * unaffected.
- */
-import type { DaemonConfig, StageDirective } from '../types/index.js';
-import { type CloseLoopDecision } from './close-loop-dispatcher.js';
-/** Test helper: clear the bookkeeper-spawned set. */
-export declare function __resetCloseLoopStateForTesting(): void;
-/**
- * Inspect open escalations and return the set of injection ids that have
- * an active `injection_unverified` escalation (status pending or
- * in_review). Used by the close_loop dispatcher to classify "escalated"
- * injections as terminal.
- *
- * The `metadata.injection_id` field is set by the bookkeeper persona when
- * filing the escalation -- see the close_loop directive prompt.
- */
-export declare function getOpenInjectionUnverifiedEscalationIds(): Promise<Set<string>>;
-/**
- * Dispatch the close_loop stage for one focus.
- *
- * Reads the focus's anchored deliveries + injection statuses + open
- * escalations, then runs the pure `decideCloseLoop` to determine whether
- * to short-circuit, spawn a bookkeeper, advance to done, or hold.
- *
- * Returns the decision so the caller (or a test) can log/assert.
- *
- * Idempotent across poll cycles -- the `closeLoopBookkeeperSpawned` set
- * ensures the bookkeeper is spawned at most once per focus visit to
- * close_loop. Tests reset this via `__resetCloseLoopStateForTesting`.
- */
-export declare function dispatchCloseLoopStage(config: DaemonConfig, focus: {
-    focus_id: string;
-    focus_name: string;
-}): Promise<CloseLoopDecision>;
-/**
- * Pure helper exported for tests: build the close_loop directive and verify
- * it carries the expected assembly + model. The buildCloseLoopDirective
- * function in close-loop-dispatcher.ts already does this; this is a
- * dispatcher-side smoke export so the tests can grep through it.
- */
-export declare function getCloseLoopDirectiveForTesting(): StageDirective;
-//# sourceMappingURL=close-loop-stage.d.ts.map

package/dist/directive/close-loop-stage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"close-loop-stage.d.ts","sourceRoot":"","sources":["../../src/directive/close-loop-stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EAML,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAC;AA2BpC,qDAAqD;AACrD,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAsB,uCAAuC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAWpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,iBAAiB,CAAC,CAsK5B;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,cAAc,CAEhE"}

package/dist/directive/close-loop-stage.js

@@ -1,210 +0,0 @@
-/**
- * Close-loop stage dispatcher.
- *
- * Drives the `close_loop` lifecycle stage for a focus: classify anchored
- * injections by terminal state, then short-circuit to done, spawn the
- * one-shot bookkeeper team, advance with an injection sweep, or hold.
- * The pure decision logic lives in close-loop-dispatcher.ts; this module
- * is the impure dispatch around it. Extracted from directive-executor.ts;
- * the executor re-exports the public surface so existing importers are
- * unaffected.
- */
-import { getActiveTeams } from '../focus/focus-team-state.js';
-import { ESCALATION_KINDS } from '@telora/daemon-core';
-import { CLOSE_LOOP_MODEL, advanceFocusToDoneWithSweep, buildCloseLoopDirective, decideCloseLoop, getAnchoringDeliveries, } from './close-loop-dispatcher.js';
-import { buildWritebackVerify } from '../queries/verification.js';
-import { getFocusDeliveries, updateFocusStage } from '../queries/focuses.js';
-import { listPendingEscalations } from '../queries/issues.js';
-import { callApi } from '../queries/shared.js';
-import { terminateTeam, waitForTeamExit } from '../completion/index.js';
-import { pendingSpawnDirectives, computeDirectiveHash } from './directive-queue.js';
-import { assembleDirectiveContent } from './directive-assembly.js';
-import { createLogger } from '../shell/log.js';
-const log = createLogger({ module: 'close-loop-dispatcher' });
-/**
- * Per-focus tracker for whether the close_loop bookkeeper has been spawned
- * at least once. Used to avoid respawning the bookkeeper on every poll
- * cycle while non-terminal injections are still being worked.
- *
- * Cleared when the focus leaves close_loop (advances to done or is
- * manually reset). The set is in-process state -- on daemon restart it is
- * empty, which is fine because the dispatcher's decideCloseLoop function
- * will see the bookkeeper has not run, respawn it, and the new bookkeeper
- * will sweep idempotently (already-verified injections stay verified;
- * already-escalated ones still surface their open escalation).
- */
-const closeLoopBookkeeperSpawned = new Set();
-/** Test helper: clear the bookkeeper-spawned set. */
-export function __resetCloseLoopStateForTesting() {
-    closeLoopBookkeeperSpawned.clear();
-}
-/**
- * Inspect open escalations and return the set of injection ids that have
- * an active `injection_unverified` escalation (status pending or
- * in_review). Used by the close_loop dispatcher to classify "escalated"
- * injections as terminal.
- *
- * The `metadata.injection_id` field is set by the bookkeeper persona when
- * filing the escalation -- see the close_loop directive prompt.
- */
-export async function getOpenInjectionUnverifiedEscalationIds() {
-    const escalations = await listPendingEscalations();
-    const ids = new Set();
-    for (const e of escalations) {
-        if (e.escalationKind !== ESCALATION_KINDS.INJECTION_UNVERIFIED)
-            continue;
-        const injectionId = e.metadata?.injection_id;
-        if (typeof injectionId === 'string' && injectionId.length > 0) {
-            ids.add(injectionId);
-        }
-    }
-    return ids;
-}
-/**
- * Dispatch the close_loop stage for one focus.
- *
- * Reads the focus's anchored deliveries + injection statuses + open
- * escalations, then runs the pure `decideCloseLoop` to determine whether
- * to short-circuit, spawn a bookkeeper, advance to done, or hold.
- *
- * Returns the decision so the caller (or a test) can log/assert.
- *
- * Idempotent across poll cycles -- the `closeLoopBookkeeperSpawned` set
- * ensures the bookkeeper is spawned at most once per focus visit to
- * close_loop. Tests reset this via `__resetCloseLoopStateForTesting`.
- */
-export async function dispatchCloseLoopStage(config, focus) {
-    const deliveries = await getFocusDeliveries(focus.focus_id);
-    const anchored = getAnchoringDeliveries(deliveries);
-    // Build the per-injection terminal-state snapshot.
-    //
-    // `statusById` is hoisted to function scope so the close_loop sweep (in
-    // the advance_to_done branch below) can reuse the snapshot without a
-    // second round-trip to reality_tree_focus_injections.
-    const states = [];
-    const statusById = new Map();
-    // injectionId -> reality_tree id, captured from the focus-injections snapshot
-    // so the writeback step can resolve each injection's targeted UDE node ids
-    // (via reality_tree_edge_list) without a second injection round-trip.
-    const treeIdByInjection = new Map();
-    if (anchored.length > 0) {
-        let openEscalationIds;
-        try {
-            openEscalationIds = await getOpenInjectionUnverifiedEscalationIds();
-        }
-        catch (err) {
-            log.warn(`[close-loop-dispatcher] Failed to fetch open injection_unverified escalations ` +
-                `for focus ${focus.focus_id.slice(0, 8)}: ${err.message}`);
-            openEscalationIds = new Set();
-        }
-        let snapshots = [];
-        try {
-            const result = await callApi('reality_tree_focus_injections', { focusId: focus.focus_id });
-            snapshots = result.items ?? [];
-        }
-        catch (err) {
-            log.warn(`[close-loop-dispatcher] Failed to fetch focus injections for ${focus.focus_id.slice(0, 8)}: ` +
-                `${err.message}`);
-        }
-        for (const item of snapshots) {
-            statusById.set(item.injection.id, item.injection.injectionStatus);
-            const treeId = item.injection.realityTreeId;
-            if (typeof treeId === 'string' && treeId.length > 0) {
-                treeIdByInjection.set(item.injection.id, treeId);
-            }
-        }
-        for (const delivery of anchored) {
-            const injectionId = delivery.injectionId;
-            states.push({
-                injectionId,
-                injectionStatus: statusById.get(injectionId) ?? null,
-                hasOpenUnverifiedEscalation: openEscalationIds.has(injectionId),
-            });
-        }
-    }
-    const bookkeeperHasRun = closeLoopBookkeeperSpawned.has(focus.focus_id);
-    const decision = decideCloseLoop(deliveries, states, bookkeeperHasRun);
-    switch (decision.kind) {
-        case 'short_circuit_to_done': {
-            try {
-                await updateFocusStage(focus.focus_id, 'done');
-                log.info(`[close-loop-dispatcher] Focus "${focus.focus_name}" has no anchoring injections -- ` +
-                    `short-circuiting close_loop -> done`);
-            }
-            catch (err) {
-                log.warn(`[close-loop-dispatcher] Failed to short-circuit focus ${focus.focus_id.slice(0, 8)} to done: ` +
-                    `${err.message}`);
-            }
-            closeLoopBookkeeperSpawned.delete(focus.focus_id);
-            return decision;
-        }
-        case 'advance_to_done': {
-            // Focus-level injection sweep + stage advance. The helper realizes
-            // anchored injections whose anchoring deliveries closed successfully
-            // but whose status hasn't yet flipped to 'verified' (e.g. deliveries
-            // that exited via review instead of the per-delivery verify gate),
-            // then advances close_loop -> done. On sweep failure, the helper
-            // returns early WITHOUT calling updateFocusStage -- the focus stays
-            // at close_loop and the next poll cycle retries.
-            const outcome = await advanceFocusToDoneWithSweep(focus, anchored, statusById, { verify: buildWritebackVerify(treeIdByInjection), updateFocusStage });
-            // Clear the bookkeeper-spawned flag only when the focus has
-            // terminally exited close_loop -- either advanced, or attempted to
-            // advance and the stage-update itself failed. A sweep failure leaves
-            // the flag in place so the same bookkeeper context is reused on the
-            // next poll cycle's retry.
-            if (outcome.advanced || outcome.advanceError) {
-                closeLoopBookkeeperSpawned.delete(focus.focus_id);
-            }
-            return decision;
-        }
-        case 'spawn_bookkeeper': {
-            const team = getActiveTeams().get(focus.focus_id);
-            const worktreePath = team?.worktreePath ?? null;
-            try {
-                const message = await assembleDirectiveContent(config, focus.focus_id, decision.directive, worktreePath);
-                const contentHash = computeDirectiveHash(decision.directive);
-                pendingSpawnDirectives.set(focus.focus_id, {
-                    message,
-                    model: decision.directive.model ?? CLOSE_LOOP_MODEL,
-                    // The close_loop bookkeeper is a fixed-purpose one-shot session pinned
-                    // to CLOSE_LOOP_MODEL; the focus selector must NOT override it. Null
-                    // override leaves the model slot (CLOSE_LOOP_MODEL) winning.
-                    focusOverrideModel: null,
-                    sessionType: 'coding',
-                    // The close_loop bookkeeper is a distinct one-shot session: its own
-                    // lineage slot, always fresh -- it must not resume (or clobber) the
-                    // coder's context (INJ-B).
-                    lineage: 'close_loop',
-                    continuity: 'fresh',
-                    contentHash,
-                });
-                if (team) {
-                    terminateTeam(focus.focus_id, 'handoff');
-                    await waitForTeamExit(focus.focus_id, 30000);
-                }
-                closeLoopBookkeeperSpawned.add(focus.focus_id);
-                log.info(`[close-loop-dispatcher] Spawned bookkeeper team for focus "${focus.focus_name}" ` +
-                    `(${anchored.length} anchored injection(s), model: ${CLOSE_LOOP_MODEL})`);
-            }
-            catch (err) {
-                log.warn(`[close-loop-dispatcher] Failed to spawn bookkeeper for focus ${focus.focus_id.slice(0, 8)}: ` +
-                    `${err.message}`);
-            }
-            return decision;
-        }
-        case 'hold': {
-            log.info(`[close-loop-dispatcher] Focus "${focus.focus_name}" held at close_loop: ${decision.reason}`);
-            return decision;
-        }
-    }
-}
-/**
- * Pure helper exported for tests: build the close_loop directive and verify
- * it carries the expected assembly + model. The buildCloseLoopDirective
- * function in close-loop-dispatcher.ts already does this; this is a
- * dispatcher-side smoke export so the tests can grep through it.
- */
-export function getCloseLoopDirectiveForTesting() {
-    return buildCloseLoopDirective();
-}
-//# sourceMappingURL=close-loop-stage.js.map

package/dist/directive/close-loop-stage.js.map

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

package/dist/focus-stage-lifecycle/review-convergence.d.ts

@@ -1,133 +0,0 @@
-/**
- * Focus review-convergence transitions (extracted from focus-stage-lifecycle).
- *
- * Owns the two review-axis daemon-side transitions:
- *   verify  -> review     (Issue 4: auto-enter review on verify-stage entry)
- *   review  -> close_loop (Issue 2 + 3: state-based convergence / nonconvergent
- *                          escalation)
- *
- * Plus the pure helpers (`hasReviewConverged`, `getReviewIterationCap`,
- * `hasInFlightRemediations`) these transitions rely on.
- *
- * @module focus-stage-lifecycle/review-convergence
- */
-import type { PipelineConfig } from '../types/index.js';
-import { getLatestCompletedFocusReview as defaultGetLatestCompletedFocusReview, getInFlightRemediationCount as defaultGetInFlightRemediationCount, getFocusReviewIterationCount as defaultGetFocusReviewIterationCount, updateFocusStage as defaultUpdateFocusStage } from '../queries/focuses.js';
-import { createEscalation as defaultCreateEscalation } from '../queries/issues.js';
-import { emitLoopTrigger } from '../loops/index.js';
-/**
- * Default cap on review iterations before the daemon files a
- * `review_nonconvergent` escalation and pauses the focus.
- *
- * Configurable per focus via `pipeline_config.review.maxIterations`.
- */
-export declare const DEFAULT_REVIEW_MAX_ITERATIONS = 3;
-/**
- * Decide whether a focus has converged out of review. Convergence is
- * deterministic and state-based:
- *
- *   - If there are no in-flight remediation deliveries created during/after
- *     the latest review pass, the focus has converged.
- *
- * Pure function: takes the in-flight count and returns the decision.
- * Exported so tests can drive it with synthetic counts.
- */
-export declare function hasReviewConverged(inFlightRemediationCount: number): boolean;
-/**
- * Compute the configured review iteration cap for a focus. Pulls
- * `pipeline_config.review.maxIterations` and falls back to
- * `DEFAULT_REVIEW_MAX_ITERATIONS` when unset or non-positive.
- *
- * Exported for unit testing.
- */
-export declare function getReviewIterationCap(pipelineConfig: PipelineConfig | null | undefined): number;
-/**
- * Returns true when the focus has any in-flight remediation deliveries
- * created during/after the latest review pass.
- *
- * "Latest review pass" is the `started_at` of the most recent focus_reviews
- * row; when no review has run yet, this returns false (no remediation
- * deliveries can exist before a review pass).
- *
- * In-flight means execution_status is NOT one of done/cancelled/verify.
- *
- * Exported for unit testing the convergence query independently of the
- * surrounding transition logic.
- */
-export declare function hasInFlightRemediations(focusId: string, latestReviewPassTimestamp: string | null, deps?: {
-    getInFlightRemediationCount: typeof defaultGetInFlightRemediationCount;
-}): Promise<boolean>;
-/**
- * Dependencies for `advanceVerifyToReviewIfEnabled`. Defaults reach for the
- * real query module; tests can pass stub implementations.
- */
-export interface VerifyToReviewDeps {
-    updateFocusStage: typeof defaultUpdateFocusStage;
-    emitLoopTrigger: typeof emitLoopTrigger;
-}
-/**
- * When a focus's stage is `verify` and auto-review is enabled, advance it to
- * `review`. Auto-review is default-on (`isReviewEnabled`): only an explicit
- * `pipeline_config.review.enabled === false` keeps the focus at `verify` until
- * a human signals review. A focus with no stored review key auto-advances.
- *
- * Returns true when an advance was performed.
- */
-export declare function advanceVerifyToReviewIfEnabled(focus: {
-    focusId: string;
-    focusName: string;
-    stage: string;
-    pipelineConfig: PipelineConfig | null;
-}, deps?: VerifyToReviewDeps): Promise<boolean>;
-/**
- * Dependencies for `advanceReviewToCloseLoopIfConverged`. Defaults reach for
- * the real query modules; tests can pass stub implementations.
- */
-export interface ReviewConvergeDeps {
-    getLatestCompletedFocusReview: typeof defaultGetLatestCompletedFocusReview;
-    getInFlightRemediationCount: typeof defaultGetInFlightRemediationCount;
-    getFocusReviewIterationCount: typeof defaultGetFocusReviewIterationCount;
-    updateFocusStage: typeof defaultUpdateFocusStage;
-    createEscalation: typeof defaultCreateEscalation;
-    emitLoopTrigger: typeof emitLoopTrigger;
-}
-/**
- * Outcome of an attempt to advance a focus past the review stage.
- */
-export type ReviewTransitionOutcome = {
-    kind: 'no_action';
-    reason: string;
-} | {
-    kind: 'converged';
-    from: 'review';
-    to: 'close_loop';
-} | {
-    kind: 'nonconvergent';
-    iterations: number;
-    cap: number;
-};
-/**
- * Evaluate the review -> close_loop transition for a focus and apply the
- * appropriate action. Returns a structured outcome so callers can log /
- * test the decision path.
- *
- * Logic:
- *   1. If stage is not `review`, do nothing.
- *   2. If the review iteration count is >= the cap, file a
- *      `review_nonconvergent` escalation (idempotent best-effort) and
- *      LEAVE the focus stage at `review`. The focus is paused until a
- *      human intervenes.
- *   3. Otherwise, check in-flight remediations against the latest review
- *      pass. If zero, advance stage `review -> close_loop`.
- *   4. Otherwise, do nothing -- remediations are still in flight.
- *
- * Exported with injectable deps for unit testing.
- */
-export declare function advanceReviewToCloseLoopIfConverged(focus: {
-    focusId: string;
-    focusName: string;
-    organizationId: string;
-    stage: string;
-    pipelineConfig: PipelineConfig | null;
-}, deps?: ReviewConvergeDeps): Promise<ReviewTransitionOutcome>;
-//# sourceMappingURL=review-convergence.d.ts.map

package/dist/focus-stage-lifecycle/review-convergence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"review-convergence.d.ts","sourceRoot":"","sources":["../../src/focus-stage-lifecycle/review-convergence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,6BAA6B,IAAI,oCAAoC,EACrE,2BAA2B,IAAI,kCAAkC,EACjE,4BAA4B,IAAI,mCAAmC,EACnE,gBAAgB,IAAI,uBAAuB,EAC5C,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,IAAI,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAOnF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASpD;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAI/C;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,wBAAwB,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,CAMR;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,yBAAyB,EAAE,MAAM,GAAG,IAAI,EACxC,IAAI,GAAE;IACJ,2BAA2B,EAAE,OAAO,kCAAkC,CAAC;CACF,GACtE,OAAO,CAAC,OAAO,CAAC,CASlB;AAID;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,OAAO,uBAAuB,CAAC;IACjD,eAAe,EAAE,OAAO,eAAe,CAAC;CACzC;AAOD;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC,EACD,IAAI,GAAE,kBAA8C,GACnD,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAID;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B,EAAE,OAAO,oCAAoC,CAAC;IAC3E,2BAA2B,EAAE,OAAO,kCAAkC,CAAC;IACvE,4BAA4B,EAAE,OAAO,mCAAmC,CAAC;IACzE,gBAAgB,EAAE,OAAO,uBAAuB,CAAC;IACjD,gBAAgB,EAAE,OAAO,uBAAuB,CAAC;IACjD,eAAe,EAAE,OAAO,eAAe,CAAC;CACzC;AAWD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,YAAY,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mCAAmC,CACvD,KAAK,EAAE;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC,EACD,IAAI,GAAE,kBAA8C,GACnD,OAAO,CAAC,uBAAuB,CAAC,CAqHlC"}

package/dist/focus-stage-lifecycle/review-convergence.js

@@ -1,237 +0,0 @@
-/**
- * Focus review-convergence transitions (extracted from focus-stage-lifecycle).
- *
- * Owns the two review-axis daemon-side transitions:
- *   verify  -> review     (Issue 4: auto-enter review on verify-stage entry)
- *   review  -> close_loop (Issue 2 + 3: state-based convergence / nonconvergent
- *                          escalation)
- *
- * Plus the pure helpers (`hasReviewConverged`, `getReviewIterationCap`,
- * `hasInFlightRemediations`) these transitions rely on.
- *
- * @module focus-stage-lifecycle/review-convergence
- */
-import { getLatestCompletedFocusReview as defaultGetLatestCompletedFocusReview, getInFlightRemediationCount as defaultGetInFlightRemediationCount, getFocusReviewIterationCount as defaultGetFocusReviewIterationCount, updateFocusStage as defaultUpdateFocusStage, } from '../queries/focuses.js';
-import { createEscalation as defaultCreateEscalation } from '../queries/issues.js';
-import { ESCALATION_REASONS, ESCALATION_KINDS, ESCALATION_DISPOSITIONS, FOCUS_STAGE, } from '@telora/daemon-core';
-import { emitLoopTrigger } from '../loops/index.js';
-import { isReviewEnabled } from '../workflow/pipeline-config.js';
-import { createLogger } from '../shell/log.js';
-const log = createLogger({ module: 'focus-stage-lifecycle' });
-// ── Constants ─────────────────────────────────────────────────────
-/**
- * Default cap on review iterations before the daemon files a
- * `review_nonconvergent` escalation and pauses the focus.
- *
- * Configurable per focus via `pipeline_config.review.maxIterations`.
- */
-export const DEFAULT_REVIEW_MAX_ITERATIONS = 3;
-// ── Pure helpers (Issue 2 + Issue 3) ──────────────────────────────
-/**
- * Decide whether a focus has converged out of review. Convergence is
- * deterministic and state-based:
- *
- *   - If there are no in-flight remediation deliveries created during/after
- *     the latest review pass, the focus has converged.
- *
- * Pure function: takes the in-flight count and returns the decision.
- * Exported so tests can drive it with synthetic counts.
- */
-export function hasReviewConverged(inFlightRemediationCount) {
-    return inFlightRemediationCount <= 0;
-}
-/**
- * Compute the configured review iteration cap for a focus. Pulls
- * `pipeline_config.review.maxIterations` and falls back to
- * `DEFAULT_REVIEW_MAX_ITERATIONS` when unset or non-positive.
- *
- * Exported for unit testing.
- */
-export function getReviewIterationCap(pipelineConfig) {
-    const raw = pipelineConfig?.review?.maxIterations;
-    if (typeof raw !== 'number' || !Number.isFinite(raw) || raw <= 0) {
-        return DEFAULT_REVIEW_MAX_ITERATIONS;
-    }
-    return Math.floor(raw);
-}
-// ── Convergence check (Issue 2) ───────────────────────────────────
-/**
- * Returns true when the focus has any in-flight remediation deliveries
- * created during/after the latest review pass.
- *
- * "Latest review pass" is the `started_at` of the most recent focus_reviews
- * row; when no review has run yet, this returns false (no remediation
- * deliveries can exist before a review pass).
- *
- * In-flight means execution_status is NOT one of done/cancelled/verify.
- *
- * Exported for unit testing the convergence query independently of the
- * surrounding transition logic.
- */
-export async function hasInFlightRemediations(focusId, latestReviewPassTimestamp, deps = { getInFlightRemediationCount: defaultGetInFlightRemediationCount }) {
-    if (!latestReviewPassTimestamp) {
-        return false;
-    }
-    const count = await deps.getInFlightRemediationCount(focusId, latestReviewPassTimestamp);
-    return count > 0;
-}
-const defaultVerifyToReviewDeps = {
-    updateFocusStage: defaultUpdateFocusStage,
-    emitLoopTrigger,
-};
-/**
- * When a focus's stage is `verify` and auto-review is enabled, advance it to
- * `review`. Auto-review is default-on (`isReviewEnabled`): only an explicit
- * `pipeline_config.review.enabled === false` keeps the focus at `verify` until
- * a human signals review. A focus with no stored review key auto-advances.
- *
- * Returns true when an advance was performed.
- */
-export async function advanceVerifyToReviewIfEnabled(focus, deps = defaultVerifyToReviewDeps) {
-    if (focus.stage !== FOCUS_STAGE.VERIFY)
-        return false;
-    // Default-on: only an explicit review.enabled === false keeps the focus at
-    // verify. Missing / undefined review reads as enabled (mirrors isCiEnabled).
-    if (!isReviewEnabled(focus.pipelineConfig))
-        return false;
-    try {
-        await deps.updateFocusStage(focus.focusId, 'review');
-        log.info(`[focus-stage-lifecycle] Focus "${focus.focusName}" stage verify -> review ` +
-            `(auto: pipeline_config.review.enabled)`);
-        deps.emitLoopTrigger({
-            type: 'focus_status_changed',
-            focusId: focus.focusId,
-            detail: 'stage:verify->review',
-        });
-        return true;
-    }
-    catch (err) {
-        log.warn(`[focus-stage-lifecycle] Failed to advance "${focus.focusName}" ` +
-            `verify -> review: ${err.message}`);
-        return false;
-    }
-}
-const defaultReviewConvergeDeps = {
-    getLatestCompletedFocusReview: defaultGetLatestCompletedFocusReview,
-    getInFlightRemediationCount: defaultGetInFlightRemediationCount,
-    getFocusReviewIterationCount: defaultGetFocusReviewIterationCount,
-    updateFocusStage: defaultUpdateFocusStage,
-    createEscalation: defaultCreateEscalation,
-    emitLoopTrigger,
-};
-/**
- * Evaluate the review -> close_loop transition for a focus and apply the
- * appropriate action. Returns a structured outcome so callers can log /
- * test the decision path.
- *
- * Logic:
- *   1. If stage is not `review`, do nothing.
- *   2. If the review iteration count is >= the cap, file a
- *      `review_nonconvergent` escalation (idempotent best-effort) and
- *      LEAVE the focus stage at `review`. The focus is paused until a
- *      human intervenes.
- *   3. Otherwise, check in-flight remediations against the latest review
- *      pass. If zero, advance stage `review -> close_loop`.
- *   4. Otherwise, do nothing -- remediations are still in flight.
- *
- * Exported with injectable deps for unit testing.
- */
-export async function advanceReviewToCloseLoopIfConverged(focus, deps = defaultReviewConvergeDeps) {
-    if (focus.stage !== FOCUS_STAGE.REVIEW) {
-        return { kind: 'no_action', reason: 'stage_not_review' };
-    }
-    const cap = getReviewIterationCap(focus.pipelineConfig);
-    let iterations = 0;
-    try {
-        iterations = await deps.getFocusReviewIterationCount(focus.focusId);
-    }
-    catch (err) {
-        log.warn(`[focus-stage-lifecycle] Failed to read review iteration count for ` +
-            `"${focus.focusName}": ${err.message}`);
-        // On read failure, fall through to the convergence check rather than
-        // false-escalating; if iterations were actually high the next tick
-        // will catch it.
-    }
-    if (iterations >= cap) {
-        // N-iteration cap exceeded -- file an escalation and leave the focus
-        // at review. The escalation is best-effort; downstream dedup keeps it
-        // from spamming via the agent_escalations idx_kind_status partial index
-        // (status in ('pending', 'in_review')).
-        try {
-            await deps.createEscalation({
-                organizationId: focus.organizationId,
-                sessionId: '',
-                issueId: null,
-                reasonType: ESCALATION_REASONS.DECISION_NEEDED,
-                // The intent owner must decide: descope, extend the cap, or close.
-                disposition: ESCALATION_DISPOSITIONS.NEEDS_INTENT,
-                anchor: { focusId: focus.focusId },
-                description: `Focus "${focus.focusName}" has not converged after ${iterations} ` +
-                    `review iteration(s) (cap: ${cap}). The review self-loop has been ` +
-                    `paused; a human must decide whether to descope remaining gaps, ` +
-                    `extend the cap via pipeline_config.review.maxIterations, or close ` +
-                    `the focus.`,
-                escalationKind: ESCALATION_KINDS.REVIEW_NONCONVERGENT,
-                // Evidence only -- focus provenance lives on the columns via the anchor.
-                metadata: {
-                    iterations,
-                    cap,
-                },
-            });
-            log.warn(`[focus-stage-lifecycle] review_nonconvergent escalation filed for ` +
-                `"${focus.focusName}" (iterations=${iterations}, cap=${cap}); focus ` +
-                `remains at stage=review.`);
-        }
-        catch (err) {
-            log.warn(`[focus-stage-lifecycle] Failed to file review_nonconvergent ` +
-                `escalation for "${focus.focusName}": ${err.message}`);
-        }
-        return { kind: 'nonconvergent', iterations, cap };
-    }
-    // Look up the latest completed review's started_at. If no review has
-    // completed yet, there are no remediations created against it; treat as
-    // "not yet converged" rather than "converged on zero" -- the agent must
-    // produce a review before we can claim convergence.
-    let latestReviewStartedAt = null;
-    try {
-        const latest = await deps.getLatestCompletedFocusReview(focus.focusId);
-        latestReviewStartedAt = latest?.startedAt ?? null;
-    }
-    catch (err) {
-        log.warn(`[focus-stage-lifecycle] Failed to read latest focus_review for ` +
-            `"${focus.focusName}": ${err.message}`);
-        return { kind: 'no_action', reason: 'review_read_failed' };
-    }
-    if (!latestReviewStartedAt) {
-        return { kind: 'no_action', reason: 'no_completed_review_yet' };
-    }
-    let inFlightCount = 0;
-    try {
-        inFlightCount = await deps.getInFlightRemediationCount(focus.focusId, latestReviewStartedAt);
-    }
-    catch (err) {
-        log.warn(`[focus-stage-lifecycle] Failed to count in-flight remediations for ` +
-            `"${focus.focusName}": ${err.message}`);
-        return { kind: 'no_action', reason: 'remediation_query_failed' };
-    }
-    if (!hasReviewConverged(inFlightCount)) {
-        return { kind: 'no_action', reason: 'remediations_in_flight' };
-    }
-    try {
-        await deps.updateFocusStage(focus.focusId, 'close_loop');
-        log.info(`[focus-stage-lifecycle] Focus "${focus.focusName}" stage review -> ` +
-            `close_loop (converged after ${iterations} iteration(s))`);
-        deps.emitLoopTrigger({
-            type: 'focus_status_changed',
-            focusId: focus.focusId,
-            detail: 'stage:review->close_loop',
-        });
-        return { kind: 'converged', from: 'review', to: 'close_loop' };
-    }
-    catch (err) {
-        log.warn(`[focus-stage-lifecycle] Failed to advance "${focus.focusName}" ` +
-            `review -> close_loop: ${err.message}`);
-        return { kind: 'no_action', reason: 'stage_write_failed' };
-    }
-}
-//# sourceMappingURL=review-convergence.js.map