@indigoai-us/hq-cli 5.345.56 → 5.345.57

package/dist/lib/lanes/flag-keys.d.ts

@@ -16,6 +16,8 @@ export declare const LANE_HIRE_GRANT_FINISHED_LANES_FLAG = "lanes.hire-grant-cou
 export declare const LANE_LIST_SKIP_REMOTE_REFRESH_FLAG = "lanes.list-skip-remote-refresh";
 /** Enables missed-deadline lead nudges and second-miss operator escalation. */
 export declare const LANE_AUTOPILOT_MISSED_DEADLINE_ESCALATION_FLAG = "lanes.autopilot-missed-deadline-escalation";
+/** Enables durable six-hour escalation for lanes that remain blocked. */
+export declare const LANE_BLOCKED_ESCALATION_FLAG = "lanes.blocked-escalation-6h";
 /** Enables company-scoped lookup of a hostless lane ULID across Outpost indexes. */
 export declare const LANE_MESSAGE_ROUTE_OWNER_HOST_FLAG = "lanes.message-route-owner-host";
 /** Enables stale manager-status KPI reporting and one-time lead nudges. */
@@ -40,4 +42,6 @@ export declare const LANE_CONDUCT_SESSION_START_FLAG = "lanes.conduct-session-st
 export declare const LANE_REAP_STOP_FLAG = "lanes.reap-stop";
 /** Enables same-senior worker lane continuity on create; keep ON as the kill switch default. */
 export declare const LANE_WORKER_CONTINUITY_FLAG = "lanes.worker-continuity";
+/** Kill switch for conduct loop lanes; absence or read failure keeps it enabled. */
+export declare const LANE_CONDUCT_LOOP_FLAG = "lanes.conduct-loop";
 //# sourceMappingURL=flag-keys.d.ts.map

package/dist/lib/lanes/flag-keys.js

@@ -16,6 +16,8 @@ export const LANE_HIRE_GRANT_FINISHED_LANES_FLAG = "lanes.hire-grant-count-live-
 export const LANE_LIST_SKIP_REMOTE_REFRESH_FLAG = "lanes.list-skip-remote-refresh";
 /** Enables missed-deadline lead nudges and second-miss operator escalation. */
 export const LANE_AUTOPILOT_MISSED_DEADLINE_ESCALATION_FLAG = "lanes.autopilot-missed-deadline-escalation";
+/** Enables durable six-hour escalation for lanes that remain blocked. */
+export const LANE_BLOCKED_ESCALATION_FLAG = "lanes.blocked-escalation-6h";
 /** Enables company-scoped lookup of a hostless lane ULID across Outpost indexes. */
 export const LANE_MESSAGE_ROUTE_OWNER_HOST_FLAG = "lanes.message-route-owner-host";
 /** Enables stale manager-status KPI reporting and one-time lead nudges. */
@@ -40,4 +42,6 @@ export const LANE_CONDUCT_SESSION_START_FLAG = "lanes.conduct-session-start";
 export const LANE_REAP_STOP_FLAG = "lanes.reap-stop";
 /** Enables same-senior worker lane continuity on create; keep ON as the kill switch default. */
 export const LANE_WORKER_CONTINUITY_FLAG = "lanes.worker-continuity";
+/** Kill switch for conduct loop lanes; absence or read failure keeps it enabled. */
+export const LANE_CONDUCT_LOOP_FLAG = "lanes.conduct-loop";
 //# sourceMappingURL=flag-keys.js.map

package/dist/lib/lanes/loop.d.ts

@@ -0,0 +1,158 @@
+import type { LaneRecord, LaneProvider } from "./types.js";
+export declare const LOOP_SCHEMA: "hq-lane-loop.v1";
+export declare const PHASE_ENVELOPE_SCHEMA: "hq-phase-envelope/v1";
+export declare const PHASE_HANDOFF_SCHEMA: "hq-phase-handoff/v1";
+export declare const LOOP_ENVELOPE_LIMIT: number;
+export type GenericPhaseEnvelope = {
+    schema_version?: string;
+    id?: string;
+    kind: "phase" | "stop";
+    story_id?: string;
+    phase?: string;
+    engine?: LaneProvider;
+    prompt?: string;
+    result_path?: string;
+    deadline_seconds?: number;
+    deadline?: string;
+    fresh?: boolean;
+    [key: string]: unknown;
+};
+export type Section8PhaseEnvelope = {
+    schema: typeof PHASE_ENVELOPE_SCHEMA;
+    id?: string;
+    story_id: string;
+    phase: string;
+    engine?: LaneProvider;
+    worktree: string;
+    fresh_call?: boolean;
+    result_path?: string;
+    deadline_seconds?: number;
+    deadline?: string;
+    [key: string]: unknown;
+};
+export type LoopEnvelope = GenericPhaseEnvelope | Section8PhaseEnvelope;
+export interface LoopQueuePosition {
+    lane_id: string;
+    envelope_id: string;
+    position: number;
+    queue_depth: number;
+    queued_at: string;
+}
+export interface LoopStatus {
+    mode: "loop";
+    lane_id: string;
+    state: "waiting" | "running" | "parked" | "stopped" | "failed";
+    queue_depth: number;
+    active_envelope_id: string | null;
+    active_phase: string | null;
+    stall_counts: Record<string, number>;
+    pid?: number;
+    updated_at: string;
+}
+export interface LoopResult {
+    schema_version: typeof LOOP_SCHEMA;
+    envelope_id: string;
+    status: "done" | "failed" | "stalled" | "stopped";
+    started_at: string;
+    finished_at: string;
+    output?: string;
+    error?: string;
+    session_id?: string;
+    resumed?: boolean;
+    fresh_fallback?: boolean;
+}
+export interface Section8Handoff {
+    schema: typeof PHASE_HANDOFF_SCHEMA;
+    story_id: string;
+    phase: string;
+    worker_id: string;
+    status: "passed" | "failed" | "blocked";
+    summary: string;
+    files_changed: string[];
+    commits: string[];
+    back_pressure: {
+        tests: "pass" | "fail" | "skip";
+        lint: "pass" | "fail" | "skip";
+        typecheck: "pass" | "fail" | "skip";
+        build: "pass" | "fail" | "skip";
+    };
+    context_for_next: string;
+    engine?: string;
+    notes?: string;
+    [key: string]: unknown;
+}
+export interface LoopExecutionContext {
+    lane: LaneRecord;
+    envelope: LoopEnvelope;
+    envelopeId: string;
+    signal: AbortSignal;
+    sessionId?: string;
+    fresh: boolean;
+}
+export interface LoopExecutionResult {
+    output: string;
+    sessionId?: string;
+}
+export interface LoopRunnerOptions {
+    lane: LaneRecord;
+    runDir: string;
+    execute(context: LoopExecutionContext): Promise<LoopExecutionResult>;
+    canResume?(provider: LaneProvider): boolean;
+    raiseQuestion?(input: {
+        envelope: LoopEnvelope;
+        envelopeId: string;
+        attempt: number;
+        error: string;
+    }): Promise<void> | void;
+    defaultDeadlineSeconds?: number;
+    now?: () => Date;
+    idlePollMs?: number;
+    signal?: AbortSignal;
+}
+export interface LoopRunSummary {
+    state: "stopped" | "parked" | "aborted";
+    completed: number;
+}
+export type LoopAdmissionPath = "initial" | "deferred" | "resume";
+export declare function loopAdmissionPath(state: string, hasPendingResume: boolean, initialAdmission: boolean): LoopAdmissionPath;
+interface StoredEnvelope {
+    schema_version: typeof LOOP_SCHEMA;
+    envelope_id: string;
+    queued_at: string;
+    deadline_budget_seconds?: number;
+    deadline_at_ms?: number;
+    envelope: LoopEnvelope;
+}
+/** Validate both hq-cli phase envelopes and the conduct protocol §8 shape. */
+export declare function validateLoopEnvelope(value: unknown): LoopEnvelope;
+export declare function validateSection8Handoff(value: unknown, envelope: Section8PhaseEnvelope): Section8Handoff;
+/** Queue depth and FIFO ordering are based on the timestamp-prefixed filename. */
+export declare function listLoopQueue(runDir: string): StoredEnvelope[];
+/**
+ * Copy and enqueue atomically. Unique timestamp/ULID-like names establish FIFO;
+ * temporary files are ignored by claimers until rename completes.
+ */
+export declare function enqueueLoopEnvelope(input: {
+    runDir: string;
+    laneId: string;
+    envelope: unknown;
+    now?: () => Date;
+}): LoopQueuePosition;
+/** Atomically claims exactly the FIFO head. The active rename is the claim. */
+export declare function claimNextLoopEnvelope(runDir: string): {
+    file: string;
+    record: StoredEnvelope;
+} | null;
+/** Withdraw all unclaimed envelopes; active work remains claimed by the worker. */
+export declare function interruptLoopQueue(runDir: string): {
+    withdrawn: string[];
+    already_picked_up: string[];
+};
+export declare function loopStatus(runDir: string, laneId: string): LoopStatus;
+export declare function setLoopControllerPid(runDir: string, laneId: string, pid: number | undefined): void;
+export declare function clearLoopControllerPid(runDir: string, laneId: string, pid: number): void;
+export declare function loopControllerIsAlive(runDir: string): boolean;
+/** Run queued phases serially. Sessions are isolated by story and provider. */
+export declare function runLoopLane(options: LoopRunnerOptions): Promise<LoopRunSummary>;
+export {};
+//# sourceMappingURL=loop.d.ts.map