@indigoai-us/hq-cli 5.292.0 → 5.294.0

package/dist/commands/lanes.js

@@ -17,11 +17,13 @@ import { createLaneMoveHandlers } from "./lanes-move.js";
 import { createLaneQuestionsHandlers } from "./lanes-questions.js";
 import { createLaneResumeHandlers } from "./lanes-resume.js";
 import { createLaneWatchHandlers } from "./lanes-watch.js";
+import { createLaneStoryHandlers } from "./lanes-stories.js";
 import { callerMatchesSessionSenior, assertPlacementEnabled, defaultLanePlacementEnabled, parsePlacementPolicy, processLanePlacementCompany, readClaudeAccountBalanceSignalsEnabled, readLanePlacementEnabled, } from "./lanes-shared.js";
 export { CLAUDE_ACCOUNT_BALANCE_SIGNALS_FLAG, LANE_OUTPOST_LOAD_BALANCING_FLAG } from "./lanes-shared.js";
 export { resolveAnswerChoice } from "./lanes-questions.js";
 import { registerOutpostPrunerCommand } from "./outpost-pruner.js";
 import { registerLaneKpisCommand } from "./lanes-kpis.js";
+import { registerLaneAutopilotReportCommand } from "./lanes-autopilot.js";
 import { registerLaneChecksCommand } from "./lanes-checks.js";
 import { registerLaneReportCommands } from "./lanes-report.js";
 import { registerLaneRepoMergeHoldCommand } from "./lanes-hold.js";
@@ -55,7 +57,7 @@ import { sessionIdFromEnv } from "../lib/mesh/live/session-identity.js";
 import { listLaneReviews } from "../lib/lanes/reviews.js";
 import { effectiveAccountHome } from "../lib/lanes/account-home.js";
 import { AccountResolutionError, compareLaneQueueOrder, LANE_PROVIDERS, LANE_STATES, QUESTION_STATUSES, SENIOR_KINDS, accountStatus, appendCappedHistory, canonicalizeHome, createLane, decideAdmission, defaultLivenessDeps, defaultSystemdUserDir, defaultThrottleDeps, installReconcileTimer, providerPathEnv, probeDrainHookRegistration, isLanesError, isLaneVersionConflict, isTerminalLaneState, aliveDirectChildren, assignedChildHireGrants, hireGrantCapacityError, planHireGrantBackfill, terminalChildResumeHireGrantError, withHireGrantAdmission, laneStoryLedgerEnabled, validateProjectStories, buildLaneStatusSnapshot, formatLaneStatusHuman, listLaneIds, listQuestionIds, loadLanesConfig, laneRunsHere, MAX_LANE_DEPTH, MONITOR_ERROR_EXIT_CODE, readLiveMonitorEvidence, resolveMachineIdentity as lookupMachineIdentity, loadLivenessIndex, parseLaneProvider, parseLaneRecord, parseLaneState, parseQuestionRecord, parseSeniorKind, readAllLanes, readLane, sanitizeHostComponent, retryUpdateLane, syncLaneRecordFromOwner, readQuestion, resolveAccount, resolveLaneWorker, ignoredWorkerProfileFields, loadWorkerProfile, loadWorkerProfileWithRegistry, registryWorkerRecord, runReconcilePass, sessionLiveness, tryReadLane, uninstallReconcileTimer, updateLane, updateQuestion, dropboxDir, laneDeliveryMechanism, hasActiveAdmissionReservation, hasActivePendingResume, hasRecordedSessionId, hasEarlierEligibleQueuedLane, laneAdmissionCapReason, providerSupportsSessionResume, providerSessionPortable, sessionNotPortableMessage, withLaneAdmissionLock, withAllLaneAdmissionLocks, readWorkerRunResult, resumeCommandRefusal, withLaneHireLocks, raiseLaneQuestion, sha256Text, } from "../lib/lanes/index.js";
-import { activeLaneStories, laneStories, laneStory, storyWarning, } from "../lib/lanes/stories.js";
+import { laneStories, storyWarning, } from "../lib/lanes/stories.js";
 import { resolveLaneKeepAlive } from "../lib/lanes/profile.js";
 import { resolveLaneCompany } from "../lib/lanes/lane-company.js";
 import { doneKeepAliveVerdict, hasPendingKeepAliveWork, keepAliveExclusion, LANE_SUPERSESSION_LINEAGE_AWARE_FLAG, loadRetiredLaneIds, } from "../lib/lanes/keep-alive.js";
@@ -490,6 +492,67 @@ function mergeOwnerLaneHierarchy(supplied, ownerLanes) {
         byId.set(lane.lane_id, lane);
     return [...byId.values()];
 }
+function hierarchyWithRemoteSenior(hierarchy, remoteSenior) {
+    return [
+        ...hierarchy.filter((lane) => lane.lane_id !== remoteSenior.lane_id),
+        remoteSenior,
+    ];
+}
+async function readRemoteHireGrantSenior(ctx, hqRoot, seniorLaneId) {
+    if (!listLaneIds(hqRoot).includes(seniorLaneId))
+        return undefined;
+    const mirror = readLane(hqRoot, seniorLaneId);
+    if (mirror.host.kind !== "outpost" ||
+        laneRunsHere(mirror, reconcileHostFromCtx(ctx))) {
+        return undefined;
+    }
+    const outpostId = mirror.host.id;
+    const unavailable = (reason) => new LanesError("hire_grant_senior_unavailable", `Cannot verify senior lane ${seniorLaneId} from owning Outpost ${outpostId}; refusing hire-grant admission (${reason})`, { senior_lane_id: seniorLaneId, outpost_id: outpostId, reason });
+    let ownerRecords;
+    try {
+        ownerRecords = await readOutpostLaneRecords(ctx, outpostId, {
+            laneIds: [seniorLaneId],
+            snapshot: true,
+            strictSnapshot: true,
+        }, {}, { bypassCache: true });
+    }
+    catch (error) {
+        throw unavailable(isLanesError(error) ? error.error : "outpost_lane_list_unavailable");
+    }
+    const matches = ownerRecords.filter((lane) => lane.lane_id === seniorLaneId);
+    const owner = matches[0];
+    const ownerIsHostedByOutpost = owner !== undefined && ((owner.host.kind === "outpost" && owner.host.id === outpostId) ||
+        (owner.host.kind === "local" && owner.host.id.trim() !== ""));
+    if (matches.length !== 1 || owner === undefined || !ownerIsHostedByOutpost) {
+        throw unavailable(matches.length === 0
+            ? "owner_did_not_return_senior"
+            : matches.length > 1
+                ? "owner_returned_duplicate_seniors"
+                : "owner_senior_identity_mismatch");
+    }
+    try {
+        const mirrorCompany = resolveLaneCompany(hqRoot, mirror).company;
+        const ownerCompany = resolveLaneCompany(hqRoot, owner).company;
+        if ((ownerCompany?.uid ?? null) !== (mirrorCompany?.uid ?? null) ||
+            (ownerCompany?.slug ?? null) !== (mirrorCompany?.slug ?? null)) {
+            throw unavailable("owner_company_did_not_match_mirror");
+        }
+    }
+    catch (error) {
+        if (isLanesError(error) && error.error === "hire_grant_senior_unavailable")
+            throw error;
+        throw unavailable("owner_company_identity_unavailable");
+    }
+    return owner;
+}
+async function hierarchyWithVerifiedRemoteSenior(ctx, hqRoot, lane, hierarchy) {
+    if (lane.senior.kind !== "lane" || !lane.senior.id)
+        return [...hierarchy];
+    const remoteSenior = await readRemoteHireGrantSenior(ctx, hqRoot, lane.senior.id);
+    return remoteSenior === undefined
+        ? [...hierarchy]
+        : mergeOwnerLaneRecords(hierarchy, [remoteSenior]);
+}
 function mergeOwnerLaneRecords(supplied, ownerLanes) {
     const byId = new Map(supplied.map((lane) => [lane.lane_id, lane]));
     for (const lane of ownerLanes)
@@ -911,8 +974,18 @@ async function withResumeHireAdmission(ctx, lane, fn, grantContext) {
         throw new LanesError("hire_grant_context_required", `Resume of Outpost lane ${lane.lane_id} requires the primary senior's hire-grant context`, { lane_id: lane.lane_id, senior_lane_id: lane.senior.id });
     }
     await refreshRemoteLaneMirrors(ctx, hqRoot, loadAllLanes(hqRoot), new Set([lane.senior.id]));
+    const remoteSenior = grantContext === undefined
+        ? await readRemoteHireGrantSenior(ctx, hqRoot, lane.senior.id)
+        : undefined;
+    const suppliedHierarchy = grantContext?.hierarchy ?? (remoteSenior === undefined
+        ? undefined
+        : hierarchyWithRemoteSenior(loadAllLanes(hqRoot), remoteSenior));
     return withHireGrantAdmission(hqRoot, lane.senior.id, (snapshot) => {
         const current = readLane(hqRoot, lane.lane_id);
+        if (remoteSenior !== undefined &&
+            (current.senior.kind !== "lane" || current.senior.id !== remoteSenior.lane_id)) {
+            throw new LanesError("hire_grant_senior_changed", `Lane ${current.lane_id}'s senior changed while its owning Outpost was being checked`, { lane_id: current.lane_id, expected_senior_lane_id: remoteSenior.lane_id, current_senior: current.senior });
+        }
         if (grantContext !== undefined &&
             !sameHireGrantSenior(current.senior, grantContext.expected_senior)) {
             throw new LanesError("hire_grant_senior_changed", `Lane ${current.lane_id}'s senior changed before the Outpost resumed it`, {
@@ -929,7 +1002,7 @@ async function withResumeHireAdmission(ctx, lane, fn, grantContext) {
         if (refusal !== null)
             throw refusal;
         return fn();
-    }, grantContext?.hierarchy);
+    }, suppliedHierarchy, remoteSenior === undefined ? undefined : new Set([remoteSenior.lane_id]));
 }
 const CAPACITY_PROBE_TIMEOUT_MS = 15_000;
 const MAX_PLACEMENT_OUTPOSTS = 16;
@@ -1205,8 +1278,11 @@ async function readOutpostLaneRecordsUncached(ctx, outpostId, query, dispatchOpt
     }
     return lanes;
 }
-async function readOutpostLaneRecords(ctx, outpostId, requestedQuery = {}, dispatchOptions = {}) {
+async function readOutpostLaneRecords(ctx, outpostId, requestedQuery = {}, dispatchOptions = {}, options = {}) {
     const query = normalizedLaneListQuery(requestedQuery);
+    if (options.bypassCache === true) {
+        return readOutpostLaneRecordsUncached(ctx, outpostId, query, dispatchOptions);
+    }
     let invocationMemo = outpostLaneListMemo.get(ctx);
     if (!invocationMemo) {
         invocationMemo = new OutpostSnapshotInvocationMemo();
@@ -2144,6 +2220,10 @@ function assertKnownOutpost(requested, known) {
  */
 export const ASK_BACKOFF_MS = [5_000, 15_000];
 export const ASK_ATTEMPTS = ASK_BACKOFF_MS.length + 1;
+/** Flip to true in the next release to make --priority mandatory. */
+export const ASK_PRIORITY_REQUIRED = false;
+const ASK_PRIORITY_WARNING = "--priority will be required in the next release.";
+const QUESTION_PRIORITIES = ["P0", "P1", "P2"];
 function withCasRetry(fn, attempts = 5) {
     let last;
     for (let i = 0; i < attempts; i += 1) {
@@ -3980,19 +4060,21 @@ async function dispatchOutpostLaneCommand(ctx, lane, action, options, behavior =
     let grantContext;
     let grantHierarchy;
     if (action === "grant") {
-        const hierarchy = mergeOwnerLaneRecords(loadAllLanes(ctx.hqRoot()), await readOutpostLaneRecords(ctx, outpostId, {
+        const ownerHierarchy = mergeOwnerLaneRecords(loadAllLanes(ctx.hqRoot()), await readOutpostLaneRecords(ctx, outpostId, {
             hierarchy: [lane.lane_id],
             snapshot: true,
         }));
+        const hierarchy = await hierarchyWithVerifiedRemoteSenior(ctx, ctx.hqRoot(), lane, ownerHierarchy);
         grantHierarchy = hierarchy;
         grantContext = createOutpostHireGrantContext(lane, hierarchy);
     }
     else if ((action === "resume" && lane.senior.kind === "lane") ||
         (action === "message" && (lane.senior.kind === "lane" || lane.senior.kind === "session"))) {
-        const hierarchy = mergeOwnerLaneRecords(loadAllLanes(ctx.hqRoot()), await readOutpostLaneRecords(ctx, outpostId, {
+        const ownerHierarchy = mergeOwnerLaneRecords(loadAllLanes(ctx.hqRoot()), await readOutpostLaneRecords(ctx, outpostId, {
             hierarchy: [lane.lane_id],
             snapshot: true,
         }));
+        const hierarchy = await hierarchyWithVerifiedRemoteSenior(ctx, ctx.hqRoot(), lane, ownerHierarchy);
         grantContext = createOutpostHireGrantContext(lane, hierarchy, action === "message" ? options.supersededMessageCallerId : undefined, action === "message" ? options.supersededMessageSessionId : undefined);
     }
     let dispatched;
@@ -5215,6 +5297,13 @@ function appendCallerSeniorReason(message, authorization) {
         ? message
         : `${message}; authorization refused: ${callerSeniorReason(authorization)}`;
 }
+function assertQuestionAnswerAuthorized(ctx, lane) {
+    const authorization = callerSeniorAuthorization(ctx, lane.senior);
+    if (authorization.authorized)
+        return;
+    const reason = callerSeniorReason(authorization);
+    throw new LanesError("question_answer_unauthorized", appendCallerSeniorReason(`Only senior ${seniorKey(lane.senior)} may answer lane ${lane.lane_id}'s Outpost question`, authorization), { lane_id: lane.lane_id, senior: lane.senior, reason });
+}
 function laneGrantTargetHostedHere(ctx, lane) {
     if (lane.host.kind === "local") {
         return laneRunsHere(lane, reconcileHostFromCtx(ctx));
@@ -5254,6 +5343,10 @@ async function applyHireGrant(ctx, laneId, hireGrant, authorization, grantContex
         }
         await refreshRemoteLaneMirrors(ctx, hqRoot, loadAllLanes(hqRoot), parentLaneIds);
     }
+    const remoteSenior = authorization === "senior" &&
+        initial.senior.kind === "lane" && initial.senior.id
+        ? await readRemoteHireGrantSenior(ctx, hqRoot, initial.senior.id)
+        : undefined;
     const updated = ctx.withGrantHireLocks(hqRoot, lockedLaneIds, () => {
         const current = readLane(hqRoot, laneId);
         const currentCallerAuthorization = authorization === "senior"
@@ -5270,11 +5363,18 @@ async function applyHireGrant(ctx, laneId, hireGrant, authorization, grantContex
             (!grantContext || !sameHireGrantSenior(current.senior, grantContext.expected_senior))) {
             throw new LanesError("hire_grant_senior_changed", `Lane ${laneId}'s senior changed before the Outpost applied the grant update`, { lane_id: laneId, current_senior: current.senior });
         }
-        const hierarchy = grantContext
+        if (remoteSenior !== undefined &&
+            (current.senior.kind !== "lane" || current.senior.id !== remoteSenior.lane_id)) {
+            throw new LanesError("hire_grant_senior_changed", `Lane ${current.lane_id}'s senior changed while its owning Outpost was being checked`, { lane_id: current.lane_id, expected_senior_lane_id: remoteSenior.lane_id, current_senior: current.senior });
+        }
+        const currentHierarchy = grantContext
             ? authorization === "ssm-owner-dispatch"
                 ? mergeOwnerLaneHierarchy(grantContext.hierarchy, loadAllLanes(hqRoot))
                 : grantContext.hierarchy
             : loadAllLanes(hqRoot);
+        const hierarchy = remoteSenior === undefined
+            ? currentHierarchy
+            : hierarchyWithRemoteSenior(currentHierarchy, remoteSenior);
         if (current.senior.kind === "lane") {
             if (!current.senior.id) {
                 throw new LanesError("hire_grant_senior_invalid", `Lane ${laneId} has a lane senior without an id`, {
@@ -6356,84 +6456,6 @@ function laneWithRecoveredProviderSession(hqRoot, lane) {
             : {}),
     };
 }
-function storyCommandTarget(lane, storyId, project) {
-    const projectId = project?.trim() || lane.project_id;
-    const normalizedStoryId = storyId.trim();
-    if (!projectId) {
-        throw new LanesError("missing_project", "--project is required", {});
-    }
-    if (!normalizedStoryId) {
-        throw new LanesError("missing_story", "<story-id> is required", {});
-    }
-    const story = laneStory(lane, projectId, normalizedStoryId);
-    if (!story) {
-        throw new LanesError("story_not_on_lane", `Story ${projectId}/${normalizedStoryId} is not carried by lane ${lane.lane_id}`, { lane_id: lane.lane_id, project_id: projectId, story_id: normalizedStoryId });
-    }
-    return { projectId, storyId: normalizedStoryId, story };
-}
-function updateCarriedStory(lane, projectId, storyId, status, at, extras = {}) {
-    const stories = laneStories(lane).map((story) => story.project_id === projectId && story.story_id === storyId
-        ? {
-            ...story,
-            status,
-            updated_at: at,
-            blocked_reason: extras.blocked_reason,
-            verified_at: extras.verified_at,
-            verified_by: extras.verified_by,
-        }
-        : story);
-    return {
-        ...lane,
-        project_id: projectId,
-        story_id: storyId,
-        stories,
-    };
-}
-function addCarriedStory(lane, projectId, storyId, at) {
-    if (laneStory(lane, projectId, storyId)) {
-        throw new LanesError("story_already_on_lane", `Story ${projectId}/${storyId} is already carried by lane ${lane.lane_id}`, {
-            lane_id: lane.lane_id,
-            project_id: projectId,
-            story_id: storyId,
-        });
-    }
-    return {
-        ...lane,
-        ...(lane.story_id.trim() ? {} : { project_id: projectId, story_id: storyId }),
-        stories: [
-            ...laneStories(lane),
-            { project_id: projectId, story_id: storyId, status: "in_progress", added_at: at, updated_at: at },
-        ],
-    };
-}
-function callerMayVerifyStory(ctx, lane) {
-    const callerLaneId = ctx.env.HQ_LANE_ID?.trim();
-    if (callerLaneId) {
-        return lane.senior.kind === "lane" && lane.senior.id === callerLaneId;
-    }
-    if (lane.senior.kind === "user")
-        return true;
-    if (lane.senior.kind === "lane")
-        return false;
-    return sessionIdFromEnv(ctx.env) === lane.senior.id;
-}
-async function ensureStoryThread(ctx, lane, projectId, storyId = lane.story_id) {
-    const company = lane.mesh_company ?? lane.company;
-    if (!company)
-        return lane;
-    return ensureLaneThreadRecord(ctx, lane, projectId, storyId);
-}
-async function ensureStoryThreadForTransition(ctx, lane, projectId, storyId) {
-    try {
-        return { lane: await ensureStoryThread(ctx, lane, projectId, storyId) };
-    }
-    catch (err) {
-        const warning = storyNotOnBoardWarning(err);
-        if (warning === undefined)
-            throw err;
-        return { lane, warning };
-    }
-}
 async function ensureLaneThreadRecord(ctx, lane, projectId = lane.project_id, storyId = lane.story_id, laneStatus = lane.state) {
     const company = lane.mesh_company ?? lane.company;
     if (!company)
@@ -6455,228 +6477,6 @@ async function ensureLaneThreadRecord(ctx, lane, projectId = lane.project_id, st
     }
     return updated;
 }
-async function emitStoryTransition(ctx, lane, projectId, storyId, event, status, payload = {}, skipStoryStatusPatch = false) {
-    const company = lane.mesh_company ?? lane.company;
-    if (!company)
-        return;
-    const ready = await ensureStoryThread(ctx, lane, projectId, storyId);
-    if (!ready.thread_id)
-        return;
-    await emitLaneMeshEvent(ctx, company, ready.thread_id, event, {
-        lane_id: ready.lane_id,
-        project_id: projectId,
-        story_id: storyId,
-        ...payload,
-        lane_status: lane.state,
-    });
-    if (!skipStoryStatusPatch && projectId?.trim() && storyId?.trim()) {
-        await ctx.mesh.patchStoryStatus(company, projectId, storyId, status === "blocked" ? "in_progress" : status);
-    }
-}
-function sameCommittedStory(current, expected, projectId, storyId) {
-    const currentStory = laneStory(current, projectId, storyId);
-    const expectedStory = laneStory(expected, projectId, storyId);
-    return (current.project_id === expected.project_id &&
-        current.story_id === expected.story_id &&
-        JSON.stringify(currentStory) === JSON.stringify(expectedStory));
-}
-async function commitStoryTransition(ctx, before, next, projectId, storyId, event, status, payload = {}, skipStoryStatusPatch = false) {
-    try {
-        await emitStoryTransition(ctx, next, projectId, storyId, event, status, payload, skipStoryStatusPatch);
-        return undefined;
-    }
-    catch (err) {
-        const warning = storyNotOnBoardWarning(err);
-        if (warning !== undefined)
-            return warning;
-        try {
-            const current = readLane(ctx.hqRoot(), next.lane_id);
-            if (!sameCommittedStory(current, next, projectId, storyId)) {
-                throw new LanesError("story_transition_rollback_conflict", `Story ${projectId}/${storyId} changed while mesh publication failed`, { lane_id: next.lane_id, project_id: projectId, story_id: storyId });
-            }
-            updateLane(ctx.hqRoot(), next.lane_id, current.version, "command", (latest) => {
-                if (!sameCommittedStory(latest, next, projectId, storyId)) {
-                    throw new LanesError("story_transition_rollback_conflict", `Story ${projectId}/${storyId} changed before rollback`, { lane_id: next.lane_id, project_id: projectId, story_id: storyId });
-                }
-                return {
-                    ...latest,
-                    project_id: before.project_id,
-                    story_id: before.story_id,
-                    stories: before.stories,
-                };
-            });
-        }
-        catch (rollbackErr) {
-            process.stderr.write(`hq lanes: story transition rollback failed for ${next.lane_id}/${projectId}/${storyId}: ${rollbackErr instanceof Error ? rollbackErr.message : String(rollbackErr)}\n`);
-        }
-        throw err;
-    }
-}
-async function runStoryList(ctx, laneId) {
-    const lane = readLane(ctx.hqRoot(), laneId);
-    printJson({
-        ok: true,
-        action: "story.list",
-        lane_id: laneId,
-        stories: laneStories(lane),
-        active_stories: activeLaneStories(lane),
-        story_warning: storyWarning(lane) ?? null,
-    });
-}
-async function runStoryAdd(ctx, laneId, storyId, opts) {
-    const hqRoot = ctx.hqRoot();
-    let lane = readLane(hqRoot, laneId);
-    assertLaneRunsHereForOperatorMutation(ctx, lane, "update story status for");
-    const projectId = opts.project?.trim() || lane.project_id;
-    if (!projectId)
-        throw new LanesError("missing_project", "--project is required", {});
-    const normalizedStoryId = storyId.trim();
-    if (!normalizedStoryId)
-        throw new LanesError("missing_story", "<story-id> is required", {});
-    if (ctx.storyLedgerEnabled()) {
-        validateProjectStories(hqRoot, projectId, [normalizedStoryId], lane.company?.slug);
-    }
-    const company = lane.mesh_company ?? lane.company;
-    const warnings = [];
-    let storyKnownAbsent = false;
-    if (company) {
-        const boardCheck = await storyBoardCheck(ctx, company, projectId, [normalizedStoryId]);
-        if (boardCheck.warning !== undefined)
-            warnings.push(boardCheck.warning);
-        storyKnownAbsent = boardCheck.absentStoryIds.has(normalizedStoryId);
-    }
-    const at = ctx.now().toISOString();
-    const thread = await ensureStoryThreadForTransition(ctx, lane, projectId, normalizedStoryId);
-    lane = thread.lane;
-    if (thread.warning !== undefined)
-        warnings.push(thread.warning);
-    const before = lane;
-    const next = casUpdateLane(hqRoot, laneId, (current) => {
-        assertLaneRunsHereForOperatorMutation(ctx, current, "update story status for");
-        const added = addCarriedStory(current, projectId, normalizedStoryId, at);
-        return {
-            ...added,
-            no_story_reason: undefined,
-        };
-    });
-    const transitionWarning = await commitStoryTransition(ctx, before, next, projectId, normalizedStoryId, "lane_started", "in_progress", {}, storyKnownAbsent);
-    if (transitionWarning !== undefined)
-        warnings.push(transitionWarning);
-    const finalLane = readLane(hqRoot, laneId);
-    printJson({
-        ok: true,
-        action: "story.add",
-        lane_id: laneId,
-        project_id: projectId,
-        story_id: normalizedStoryId,
-        status: "in_progress",
-        story_warning: combinedStoryWarning(finalLane, warnings),
-        lane: finalLane,
-    });
-}
-async function runStoryStart(ctx, laneId, storyId, opts) {
-    const hqRoot = ctx.hqRoot();
-    let lane = readLane(hqRoot, laneId);
-    assertLaneRunsHereForOperatorMutation(ctx, lane, "update story status for");
-    const target = storyCommandTarget(lane, storyId, opts.project);
-    if (target.story.status === "done") {
-        throw new LanesError("story_already_done", `Story ${target.projectId}/${target.storyId} is done and cannot be started again`, {
-            lane_id: laneId,
-            project_id: target.projectId,
-            story_id: target.storyId,
-        });
-    }
-    const at = ctx.now().toISOString();
-    const warnings = [];
-    const thread = await ensureStoryThreadForTransition(ctx, lane, target.projectId, target.storyId);
-    lane = thread.lane;
-    if (thread.warning !== undefined)
-        warnings.push(thread.warning);
-    const before = lane;
-    const next = casUpdateLane(hqRoot, laneId, (current) => {
-        assertLaneRunsHereForOperatorMutation(ctx, current, "update story status for");
-        return updateCarriedStory(current, target.projectId, target.storyId, "in_progress", at);
-    });
-    const transitionWarning = await commitStoryTransition(ctx, before, next, target.projectId, target.storyId, "lane_started", "in_progress");
-    if (transitionWarning !== undefined)
-        warnings.push(transitionWarning);
-    const finalLane = readLane(hqRoot, laneId);
-    printJson({ ok: true, action: "story.start", lane_id: laneId, project_id: target.projectId, story_id: target.storyId, status: "in_progress", story_warning: combinedStoryWarning(finalLane, warnings), lane: finalLane });
-}
-async function runStoryBlock(ctx, laneId, storyId, opts) {
-    const hqRoot = ctx.hqRoot();
-    let lane = readLane(hqRoot, laneId);
-    assertLaneRunsHereForOperatorMutation(ctx, lane, "update story status for");
-    const target = storyCommandTarget(lane, storyId, opts.project);
-    if (target.story.status === "done") {
-        throw new LanesError("story_already_done", `Story ${target.projectId}/${target.storyId} is done and cannot be blocked again`, {
-            lane_id: laneId,
-            project_id: target.projectId,
-            story_id: target.storyId,
-        });
-    }
-    const reason = opts.reason?.trim();
-    if (!reason)
-        throw new LanesError("missing_block_reason", "--reason is required", {});
-    const at = ctx.now().toISOString();
-    const warnings = [];
-    const thread = await ensureStoryThreadForTransition(ctx, lane, target.projectId, target.storyId);
-    lane = thread.lane;
-    if (thread.warning !== undefined)
-        warnings.push(thread.warning);
-    const before = lane;
-    const next = casUpdateLane(hqRoot, laneId, (current) => {
-        assertLaneRunsHereForOperatorMutation(ctx, current, "update story status for");
-        return updateCarriedStory(current, target.projectId, target.storyId, "blocked", at, { blocked_reason: reason });
-    });
-    const transitionWarning = await commitStoryTransition(ctx, before, next, target.projectId, target.storyId, "lane_blocked", "blocked", { blocked_reason: reason });
-    if (transitionWarning !== undefined)
-        warnings.push(transitionWarning);
-    const finalLane = readLane(hqRoot, laneId);
-    printJson({ ok: true, action: "story.block", lane_id: laneId, project_id: target.projectId, story_id: target.storyId, status: "blocked", blocked_reason: reason, story_warning: combinedStoryWarning(finalLane, warnings), lane: finalLane });
-}
-async function runStoryDone(ctx, laneId, storyId, opts) {
-    const hqRoot = ctx.hqRoot();
-    let lane = readLane(hqRoot, laneId);
-    assertLaneRunsHereForOperatorMutation(ctx, lane, "update story status for");
-    if (!opts.verified) {
-        throw new LanesError("senior_verification_required", "Only a senior may mark a story done; pass --verified after reviewing or merging it", { lane_id: laneId });
-    }
-    if (!callerMayVerifyStory(ctx, lane)) {
-        throw new LanesError("senior_verification_required", `Caller is not the senior for lane ${laneId}`, {
-            lane_id: laneId,
-            senior: lane.senior,
-        });
-    }
-    const target = storyCommandTarget(lane, storyId, opts.project);
-    if (target.story.status !== "review") {
-        throw new LanesError("story_not_ready_for_verification", `Story ${target.projectId}/${target.storyId} must be in review before senior verification`, {
-            lane_id: laneId,
-            project_id: target.projectId,
-            story_id: target.storyId,
-            status: target.story.status,
-        });
-    }
-    const at = ctx.now().toISOString();
-    const warnings = [];
-    const thread = await ensureStoryThreadForTransition(ctx, lane, target.projectId, target.storyId);
-    lane = thread.lane;
-    if (thread.warning !== undefined)
-        warnings.push(thread.warning);
-    const before = lane;
-    const next = casUpdateLane(hqRoot, laneId, (current) => {
-        assertLaneRunsHereForOperatorMutation(ctx, current, "update story status for");
-        return updateCarriedStory(current, target.projectId, target.storyId, "done", at, {
-            verified_at: at,
-            verified_by: current.senior,
-        });
-    });
-    const transitionWarning = await commitStoryTransition(ctx, before, next, target.projectId, target.storyId, "lane_done", "done", { summary: "Senior verification complete" });
-    if (transitionWarning !== undefined)
-        warnings.push(transitionWarning);
-    const finalLane = readLane(hqRoot, laneId);
-    printJson({ ok: true, action: "story.done", lane_id: laneId, project_id: target.projectId, story_id: target.storyId, status: "done", verified: true, story_warning: combinedStoryWarning(finalLane, warnings), lane: finalLane });
-}
 /**
  * Registration state of the drain hook in the lane's account home, read the
  * way the provider reads it. Null when the lane has no bound account yet
@@ -7443,7 +7243,23 @@ export function interruptNotResumableWarning(laneId) {
     return `hq lanes: warning: lane ${laneId} was interrupted before its provider reported a session id, ` +
         `so hq lanes resume cannot continue it. Start a new lane for the remaining work.\n`;
 }
+function parseQuestionPriority(value) {
+    if (value === undefined) {
+        if (ASK_PRIORITY_REQUIRED) {
+            throw new LanesError("ask_priority_required", "--priority is required; choose P0, P1, or P2", {
+                allowed: [...QUESTION_PRIORITIES],
+            });
+        }
+        return undefined;
+    }
+    const normalized = value.toUpperCase();
+    if (!QUESTION_PRIORITIES.includes(normalized)) {
+        throw new LanesError("ask_priority_invalid", `Invalid --priority ${JSON.stringify(value)}. Allowed values: P0, P1, P2`, { allowed: [...QUESTION_PRIORITIES], value });
+    }
+    return normalized;
+}
 async function runAsk(ctx, opts) {
+    const priority = parseQuestionPriority(opts.priority);
     const hqRoot = ctx.hqRoot();
     const laneId = ctx.env.HQ_LANE_ID?.trim();
     if (!laneId) {
@@ -7482,6 +7298,7 @@ async function runAsk(ctx, opts) {
                 at,
                 activeCompany: questionCompany,
                 questionId,
+                priority,
             });
             questionId = withBody.question_id;
             await emitLaneMeshEvent(ctx, lane.mesh_company ?? lane.company, lane.thread_id, "lane_question", {
@@ -7496,12 +7313,16 @@ async function runAsk(ctx, opts) {
                     question_id: withBody.question_id,
                 });
             }
+            if (priority === undefined) {
+                process.stderr.write(`hq lanes ask: warning: ${ASK_PRIORITY_WARNING}\n`);
+            }
             printJson({
                 ok: true,
                 action: "ask",
                 question: withBody,
                 lane_id: lane.lane_id,
                 lane_state: lane.state,
+                ...(priority === undefined ? { warnings: [ASK_PRIORITY_WARNING] } : {}),
             });
             return;
         }
@@ -7940,6 +7761,19 @@ function attachJsonNoop(cmd) {
 }
 export function registerLanesCommand(parent, deps = {}) {
     const ctx = resolveDeps(deps);
+    const storyHandlers = createLaneStoryHandlers({
+        assertLaneRunsHereForOperatorMutation,
+        casUpdateLane,
+        combinedStoryWarning,
+        emitLaneMeshEvent,
+        ensureLaneThreadRecord,
+        printJson,
+        readLane,
+        storyBoardCheck,
+        storyNotOnBoardWarning,
+        updateLane,
+        validateProjectStories,
+    });
     const accountHandlers = createLaneAccountsHandlers({
         automaticBalanceMoveHistoryReason,
         ensureDir,
@@ -7957,6 +7791,7 @@ export function registerLanesCommand(parent, deps = {}) {
         MAX_PLACEMENT_OUTPOSTS,
         OUTPOST_QUESTION_LOOKUP_CONCURRENCY,
         assertLaneRunsHereForOperatorMutation,
+        assertQuestionAnswerAuthorized,
         assertQuestionCompanyMatchesLane,
         casUpdateQuestion,
         effectiveLaneQuestionCompany,
@@ -8095,6 +7930,11 @@ export function registerLanesCommand(parent, deps = {}) {
     }, wrap);
     registerOutpostPrunerCommand(lanes);
     registerLaneKpisCommand(lanes, { hqRoot: ctx.hqRoot, now: ctx.now, wrap });
+    registerLaneAutopilotReportCommand(lanes, {
+        hqRoot: ctx.hqRoot,
+        now: ctx.now,
+        currentHost: () => resolveAdmissionHost({ hostname: ctx.hostname, readOutpostIdentity: ctx.readOutpostIdentity }),
+    }, wrap);
     const noStoryOption = new Option("--no-story <reason>", "Create a lane without a story and record why");
     noStoryOption.attributeName = () => "noStory";
     lanes
@@ -8306,7 +8146,7 @@ export function registerLanesCommand(parent, deps = {}) {
         .description("List the stories carried by a lane")
         .argument("<lane-id>", "Lane id")
         .action(wrap(async (laneId) => {
-        await runStoryList(ctx, laneId);
+        await storyHandlers.runStoryList(ctx, laneId);
     }));
     stories
         .command("add")
@@ -8315,7 +8155,7 @@ export function registerLanesCommand(parent, deps = {}) {
         .argument("<story-id>", "Story id")
         .option("--project <slug>", "Project id; defaults to the lane's current project")
         .action(wrap(async (laneId, storyId, opts) => {
-        await runStoryAdd(ctx, laneId, storyId, opts);
+        await storyHandlers.runStoryAdd(ctx, laneId, storyId, opts);
     }));
     stories
         .command("start")
@@ -8324,7 +8164,7 @@ export function registerLanesCommand(parent, deps = {}) {
         .argument("<story-id>", "Story id")
         .option("--project <slug>", "Project id; defaults to the lane's current project")
         .action(wrap(async (laneId, storyId, opts) => {
-        await runStoryStart(ctx, laneId, storyId, opts);
+        await storyHandlers.runStoryStart(ctx, laneId, storyId, opts);
     }));
     stories
         .command("block")
@@ -8334,7 +8174,7 @@ export function registerLanesCommand(parent, deps = {}) {
         .requiredOption("--reason <text>", "Why the story is blocked")
         .option("--project <slug>", "Project id; defaults to the lane's current project")
         .action(wrap(async (laneId, storyId, opts) => {
-        await runStoryBlock(ctx, laneId, storyId, opts);
+        await storyHandlers.runStoryBlock(ctx, laneId, storyId, opts);
     }));
     stories
         .command("done")
@@ -8344,7 +8184,7 @@ export function registerLanesCommand(parent, deps = {}) {
         .requiredOption("--verified", "Confirm senior review or merge")
         .option("--project <slug>", "Project id; defaults to the lane's current project")
         .action(wrap(async (laneId, storyId, opts) => {
-        await runStoryDone(ctx, laneId, storyId, opts);
+        await storyHandlers.runStoryDone(ctx, laneId, storyId, opts);
     }));
     lanes
         .command("message")
@@ -8493,6 +8333,8 @@ export function registerLanesCommand(parent, deps = {}) {
         .option("--context <text>", "Context for the audience")
         .option("--option <text>", "Answer choice (repeatable)", collectRepeatable)
         .option("--recommended <text>", "Recommended option")
+        .option("--priority <P0|P1|P2>", "Urgency: P0 blocks now, P1 needed today, P2 can wait")
+        .addHelpText("after", "\nThe audience may take up to 24 hours to answer; keep working meanwhile.\n")
         .action(wrap(async (opts) => {
         await runAsk(ctx, opts);
     }));
@@ -8631,9 +8473,11 @@ export function registerLanesCommand(parent, deps = {}) {
         .action(wrap(async (opts) => {
         await runPickup(ctx, opts);
     }));
-    lanes
-        .command("autopilot")
-        .description("Check registered team leads and wake them for ready work")
+    const autopilot = lanes.commands.find((command) => command.name() === "autopilot");
+    if (!autopilot)
+        throw new Error("Lanes autopilot command group was not registered");
+    autopilot
+        .description("Run lead autopilot checks and report follow-through metrics")
         .command("run")
         .description("Run one lead autopilot check pass")
         .option("--dry-run", "Report proposed wakes without writing them")