@indigoai-us/hq-cli 5.188.1 → 5.190.0

package/dist/commands/lanes.js

@@ -1,7 +1,7 @@
 /**
  * `hq lanes` — worker lane management and decision queue (spec §5–§7, §10–§11).
  *
- * Existing commands print JSON on stdout and take no interactive input, except
+ * Existing commands print JSON on stdout by default and take no interactive input, except
  * `accounts login`, which hands the terminal to the vendor's own sign-in.
  * `watch` and the monitor reminder are the line-oriented text surfaces.
  */
@@ -10,6 +10,7 @@ import { randomBytes } from "node:crypto";
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
+import { Option } from "commander";
 import { registerOutpostPrunerCommand } from "./outpost-pruner.js";
 import { ensureCognitoToken } from "../utils/cognito-session.js";
 import { resolveLanesHqRoot } from "../lib/lanes/hq-root.js";
@@ -20,7 +21,7 @@ import { createOutpostHireGrantContext, parseOutpostHireGrantContext, sameHireGr
 import { OUTPOST_DIR, OUTPOST_ID_PATH, readOutpostIdentity, resolveAdmissionHost, } from "../lib/lanes/admission-host.js";
 export { OUTPOST_DIR, OUTPOST_ID_PATH, readOutpostIdentity } from "../lib/lanes/admission-host.js";
 export { LANE_HIRE_GRANTS_FLAG };
-import { buildOutpostCapacityCommand, buildOutpostBalanceMoveCommand, buildOutpostIdentityBackfillCommand, buildOutpostLaneCommand, buildOutpostMoveTargetCommand, buildOutpostPickupCommand, createOutpostsClient, dispatchErrorMessage, dispatchOutpostPickup, buildOutpostLaneListCommand, parseOutpostPickupPayload, stageOutpostPayload, } from "../lib/lanes/outpost-dispatch.js";
+import { buildOutpostCapacityCommand, buildOutpostBalanceMoveCommand, buildOutpostIdentityBackfillCommand, buildOutpostLaneCommand, buildOutpostMoveTargetCommand, buildOutpostPickupCommand, createOutpostsClient, dispatchErrorMessage, dispatchOutpostPickup, buildOutpostLaneListCommand, outpostRejectedEffortOption, parseOutpostPickupPayload, stageOutpostPayload, } from "../lib/lanes/outpost-dispatch.js";
 import { buildHostCapacitySnapshot, chooseHostForLane, parseHostCapacitySnapshot, } from "../lib/lanes/host-capacity.js";
 import { BALANCE_MOVABLE_STATES, CLAUDE_ACCOUNT_BALANCE_FLAG, accountLoadsForReport, assertBalanceApplyEnabled, planClaudeBalanceMoves, selectClaudeAccount, } from "../lib/lanes/claude-account-balance.js";
 import { parseUserYaml } from "../utils/user-yaml-error.js";
@@ -29,12 +30,12 @@ import { vaultApiFetch } from "../utils/vault-api.js";
 import { openMeshTransport } from "../lib/mesh/client.js";
 import { createLaneMesh, emitLaneDecisionEvents, emitLaneTerminalStateEvent, laneMeshEventIdentity, } from "../lib/lanes/mesh-events.js";
 import { sessionIdFromEnv } from "../lib/mesh/live/session-identity.js";
-import { AccountResolutionError, compareLaneQueueOrder, coveredLaneIds, DEFAULT_ACCOUNT_HOMES, LANE_PROVIDERS, LANE_STATES, PROVIDER_HOME_ENV, QUESTION_STATUSES, SENIOR_KINDS, accountStatus, appendCappedHistory, canonicalizeHome, createLane, decideAdmission, defaultLivenessDeps, defaultSystemdUserDir, defaultThrottleDeps, installDrainHook, installReconcileTimer, providerPathEnv, probeDrainHookRegistration, isLanesError, isLaneVersionConflict, isTerminalLaneState, aliveDirectChildren, assignedChildHireGrants, LANE_HIRE_GRANTS_FLAG, planHireGrantBackfill, withHireGrantAdmission, listAccountStatuses, listLaneIds, listQuestionIds, listSessionLiveness, loadLanesConfig, laneRunsHere, MAX_LANE_DEPTH, MONITOR_ERROR_EXIT_CODE, MONITOR_ENGINES, MONITOR_MAX_TIMEOUT_MS, MONITOR_UNCOVERED_EXIT_CODE, MAX_WATCHED_LANES, monitorReminderText, readLiveMonitorEvidence, resolveMachineIdentity as lookupMachineIdentity, loadLivenessIndex, parseLaneProvider, parseLaneRecord, parseLaneState, parseLivenessState, parseQuestionStatus, parseSeniorKind, readDaemonPresenceConnected, readLane, retryUpdateLane, syncLaneRecordFromOwner, readQuestion, resolveAccount, resolveLaneWorker, ignoredWorkerProfileFields, loadWorkerProfile, runReconcilePass, runLaneWatch, sessionLiveness, tryReadLane, uninstallReconcileTimer, updateLane, updateQuestion, writeLanesConfig, appendDropboxMessage, answerDropboxMessage, deliveryRefusalReason, resumeCommandRefusal, dropboxDir, dropboxInboxPath, laneAcceptsDropboxDelivery, laneAcceptsOperatorMessage, laneDeliveryMechanism, hasActiveAdmissionReservation, hasActivePendingResume, hasRecordedSessionId, hasEarlierEligibleQueuedLane, laneAdmissionCapReason, providerSupportsSessionResume, withLaneAdmissionLock, withLaneHireLocks, laneIdForAnswerDelivery, operatorMessageRefusalReason, raiseLaneQuestion, sha256Text, writeQuestionBody, } from "../lib/lanes/index.js";
+import { AccountResolutionError, compareLaneQueueOrder, coveredLaneIds, DEFAULT_ACCOUNT_HOMES, LANE_PROVIDERS, LANE_STATES, PROVIDER_HOME_ENV, QUESTION_STATUSES, SENIOR_KINDS, accountStatus, appendCappedHistory, canonicalizeHome, createLane, decideAdmission, defaultLivenessDeps, defaultSystemdUserDir, defaultThrottleDeps, installDrainHook, installReconcileTimer, providerPathEnv, probeDrainHookRegistration, isLanesError, isLaneVersionConflict, isTerminalLaneState, aliveDirectChildren, assignedChildHireGrants, LANE_HIRE_GRANTS_FLAG, planHireGrantBackfill, withHireGrantAdmission, laneStoryLedgerEnabled, validateProjectStories, buildLaneStatusSnapshot, formatLaneStatusHuman, listAccountStatuses, listLaneIds, listQuestionIds, listSessionLiveness, loadLanesConfig, laneRunsHere, MAX_LANE_DEPTH, MONITOR_ERROR_EXIT_CODE, MONITOR_ENGINES, MONITOR_MAX_TIMEOUT_MS, MONITOR_UNCOVERED_EXIT_CODE, MAX_WATCHED_LANES, monitorReminderText, readLiveMonitorEvidence, resolveMachineIdentity as lookupMachineIdentity, loadLivenessIndex, parseLaneProvider, parseLaneRecord, parseLaneState, parseLivenessState, parseQuestionStatus, parseSeniorKind, readDaemonPresenceConnected, readLane, retryUpdateLane, syncLaneRecordFromOwner, readQuestion, resolveAccount, resolveLaneWorker, ignoredWorkerProfileFields, loadWorkerProfile, runReconcilePass, runLaneWatch, sessionLiveness, tryReadLane, uninstallReconcileTimer, updateLane, updateQuestion, writeLanesConfig, appendDropboxMessage, answerDropboxMessage, deliveryRefusalReason, resumeCommandRefusal, dropboxDir, dropboxInboxPath, laneAcceptsDropboxDelivery, laneAcceptsOperatorMessage, laneDeliveryMechanism, hasActiveAdmissionReservation, hasActivePendingResume, hasRecordedSessionId, hasEarlierEligibleQueuedLane, laneAdmissionCapReason, providerSupportsSessionResume, withLaneAdmissionLock, withLaneHireLocks, laneIdForAnswerDelivery, operatorMessageRefusalReason, raiseLaneQuestion, sha256Text, writeQuestionBody, } from "../lib/lanes/index.js";
 import { activeLaneStories, laneStories, laneStory, storyWarning, } from "../lib/lanes/stories.js";
 import { questionBodyAbsPath } from "../lib/lanes/questions.js";
 import { compactionAfterUsage, } from "../lib/lanes/compaction.js";
 import { providerCompactAfterMs } from "../lib/lanes/config.js";
-import { parseCliEffort, resolveLaneEffort } from "../lib/lanes/effort.js";
+import { parseCliEffort, resolveLaneEffort, } from "../lib/lanes/effort.js";
 import { LanesError } from "../lib/lanes/errors.js";
 import { accountQuotaView, loadQuotaState, quotaBlockFor } from "../lib/lanes/quota.js";
 import { SESSION_MOVE_REASON } from "../lib/lanes/move-account.js";
@@ -257,6 +258,7 @@ function resolveDeps(deps = {}) {
         fetchText: deps.fetchText ?? defaultFetchText,
         lanePlacementEnabled: deps.lanePlacementEnabled ?? defaultLanePlacementEnabled,
         laneHireGrantsEnabled: deps.laneHireGrantsEnabled ?? defaultLaneHireGrantsEnabled,
+        storyLedgerEnabled: deps.storyLedgerEnabled ?? laneStoryLedgerEnabled,
         isSsmOwnerDispatch: deps.isSsmOwnerDispatch ?? (() => isSsmRunCommandProcess()),
         withGrantHireLocks: deps.withGrantHireLocks ?? withLaneHireLocks,
         laneClaudeAccountBalanceEnabled: deps.laneClaudeAccountBalanceEnabled ?? defaultLaneClaudeAccountBalanceEnabled,
@@ -2112,18 +2114,28 @@ async function runCreate(ctx, opts) {
     const meshCompanyFlag = opts.meshCompany?.trim();
     const project = opts.project?.trim();
     const story = opts.story?.trim();
+    const noStoryReason = opts.noStory?.trim();
     const additionalStories = (opts.additionalStory ?? []).map((value) => value.trim());
     const briefFile = opts.briefFile?.trim();
     if (!project) {
         throw new LanesError("missing_project", "--project is required", {});
     }
-    if (!story) {
+    if (opts.story !== undefined && opts.noStory !== undefined) {
+        throw new LanesError("story_selection_conflict", "Pass either --story or --no-story, not both", {});
+    }
+    if (opts.noStory !== undefined && !noStoryReason) {
+        throw new LanesError("missing_no_story_reason", "--no-story requires a non-empty reason", {});
+    }
+    if (!story && !noStoryReason) {
         throw new LanesError("missing_story", "--story is required", {});
     }
+    if (noStoryReason && additionalStories.length > 0) {
+        throw new LanesError("story_selection_conflict", "--additional-story requires --story and cannot be used with --no-story", {});
+    }
     if (additionalStories.some((value) => value.length === 0)) {
         throw new LanesError("missing_story", "--additional-story values must be non-empty", {});
     }
-    const storyIds = [story, ...additionalStories];
+    const storyIds = story ? [story, ...additionalStories] : [];
     if (new Set(storyIds).size !== storyIds.length) {
         throw new LanesError("duplicate_story", "A lane cannot carry the same project/story more than once", {
             project_id: project,
@@ -2174,6 +2186,9 @@ async function runCreate(ctx, opts) {
         throw new LanesError("max_lane_depth", `Lane depth ${laneDepth} exceeds cap ${MAX_LANE_DEPTH}`, { depth: laneDepth, max: MAX_LANE_DEPTH });
     }
     // A no-company lane must not call company resolution (openMeshTransport).
+    if (storyIds.length > 0 && ctx.storyLedgerEnabled()) {
+        validateProjectStories(hqRoot, project, storyIds, company?.slug);
+    }
     let meshCompany = company;
     if (meshCompanyFlag) {
         const resolvedMeshCompany = await ctx.resolveCompany(meshCompanyFlag);
@@ -2189,7 +2204,7 @@ async function runCreate(ctx, opts) {
     const seniorCompany = companyOfSenior(hqRoot, senior, ctx);
     assertSameTenant(company, senior, seniorCompany);
     const createStoryWarnings = [];
-    if (meshCompany) {
+    if (meshCompany && storyIds.length > 0) {
         const warning = await storyBoardWarning(ctx, meshCompany, project, storyIds);
         if (warning !== undefined)
             createStoryWarnings.push(warning);
@@ -2630,7 +2645,8 @@ async function runCreate(ctx, opts) {
                 ? { mesh_company: meshCompany }
                 : {}),
             project_id: project,
-            story_id: story,
+            story_id: story ?? "",
+            ...(noStoryReason ? { no_story_reason: noStoryReason } : {}),
             stories: storyIds.map((storyId) => ({
                 project_id: project,
                 story_id: storyId,
@@ -3100,6 +3116,8 @@ async function dispatchOutpostLaneCommand(ctx, lane, action, options) {
                 story: options.story,
                 account: options.account,
                 model: options.model,
+                effort: options.effort,
+                worker: options.worker,
                 hire: options.hire,
                 grantContext,
                 compact: options.compact,
@@ -3110,6 +3128,18 @@ async function dispatchOutpostLaneCommand(ctx, lane, action, options) {
         throw new LanesError("outpost_dispatch_failed", `Could not dispatch ${action} for lane ${lane.lane_id} to Outpost ${outpostId}: ${dispatchErrorMessage(err)}`, { lane_id: lane.lane_id, outpost_id: outpostId });
     }
     const ownerError = ownerErrorFromOutput(dispatched.stdout);
+    if (options.effort !== undefined && outpostRejectedEffortOption(dispatched)) {
+        throw new LanesError("outpost_effort_unsupported", `Outpost ${outpostId} rejected --effort; update hq-cli on that Outpost before changing a lane's effort remotely`, {
+            lane_id: lane.lane_id,
+            outpost_id: outpostId,
+            command_id: dispatched.commandId,
+            effort: options.effort,
+            status: dispatched.status,
+            done: dispatched.done ?? false,
+            exit_code: dispatched.exitCode,
+            owner_error: ownerError,
+        });
+    }
     if (ownerError) {
         throw new LanesError("outpost_dispatch_failed", `Outpost ${outpostId} rejected the ${action} command: ${ownerError.message}`, {
             lane_id: lane.lane_id,
@@ -3402,6 +3432,9 @@ async function runPickup(ctx, opts) {
     });
 }
 async function runList(ctx, opts) {
+    if (opts.json && opts.human) {
+        throw new LanesError("conflicting_output_format", "Use either --json or --human for hq lanes list", { json: true, human: true });
+    }
     const hqRoot = ctx.hqRoot();
     const state = opts.state ? parseLaneState(opts.state) : undefined;
     const senior = opts.senior ? parseSeniorRef(opts.senior) : undefined;
@@ -3416,9 +3449,11 @@ async function runList(ctx, opts) {
         .filter((lane) => {
         if (state && lane.state !== state)
             return false;
-        if ((opts.project || opts.story) &&
-            !laneStories(lane).some((story) => (!opts.project || story.project_id === opts.project) &&
-                (!opts.story || story.story_id === opts.story))) {
+        const carriesFilter = laneStories(lane).some((story) => (!opts.project || story.project_id === opts.project) &&
+            (!opts.story || story.story_id === opts.story));
+        const matchingNoStory = !opts.story && opts.project !== undefined &&
+            lane.no_story_reason !== undefined && lane.project_id === opts.project;
+        if ((opts.project || opts.story) && !carriesFilter && !matchingNoStory) {
             return false;
         }
         if (company && !recordMatchesCompany(lane, company)) {
@@ -3451,6 +3486,9 @@ async function runList(ctx, opts) {
         return {
             ...lane,
             ...hireByLane.get(lane.lane_id),
+            stories: laneStories(lane),
+            story_ids: laneStories(lane).map((story) => story.story_id),
+            no_story_reason: lane.no_story_reason ?? null,
             ...(remoteQueued
                 ? { state: "remote", remote_state: lane.state, queued_reason: undefined }
                 : {}),
@@ -3472,12 +3510,74 @@ async function runList(ctx, opts) {
     const host_capacity = ctx.lanePlacementEnabled()
         ? (await loadHostCapacitySnapshots(ctx, hqRoot)).entries
         : undefined;
-    printJson({
+    const result = {
         ok: true,
         action: "list",
         lanes,
         ...(host_capacity !== undefined ? { host_capacity } : {}),
+    };
+    if (opts.human)
+        console.log(formatLaneListHuman(lanes));
+    else
+        printJson(result);
+}
+function formatLaneListHuman(lanes) {
+    if (lanes.length === 0)
+        return "No lanes.";
+    return lanes.map((lane) => {
+        const ids = lane.story_ids;
+        const storyLabel = ids.length > 0
+            ? "stories: " + ids.join(", ")
+            : "no story: " + (lane.no_story_reason ?? "reason not recorded");
+        return lane.lane_id + "  " + lane.state + "  " + lane.provider + "  " + lane.project_id +
+            "  " + storyLabel;
+    }).join("\n");
+}
+async function runStatus(ctx, opts) {
+    if (!ctx.storyLedgerEnabled()) {
+        throw new LanesError("story_ledger_disabled", "hq lanes status requires the lanes.story-ledger flag", {
+            flag: "lanes.story-ledger",
+        });
+    }
+    const hqRoot = ctx.hqRoot();
+    const company = opts.company ? await ctx.resolveCompany(opts.company) : undefined;
+    const lanes = loadAllLanes(hqRoot).filter((lane) => lane.company?.slug === company?.slug);
+    const pending = new Map();
+    for (const lane of lanes) {
+        const refs = [];
+        for (const questionId of lane.pending_question_ids ?? []) {
+            const question = readQuestion(hqRoot, questionId);
+            const sameCompany = question.company === null
+                ? lane.company === null
+                : lane.company !== null &&
+                    question.company.uid === lane.company.uid &&
+                    question.company.slug === lane.company.slug;
+            if (question.lane_id !== lane.lane_id || !sameCompany) {
+                throw new LanesError("story_ledger_question_mismatch", `Pending question ${questionId} does not belong to lane ${lane.lane_id}`, { lane_id: lane.lane_id, question_id: questionId, question_lane_id: question.lane_id });
+            }
+            if (question.status === "pending") {
+                refs.push({
+                    question_id: question.question_id,
+                    project_id: question.project_id,
+                    story_id: question.story_id,
+                });
+            }
+        }
+        pending.set(lane.lane_id, refs);
+    }
+    const snapshot = buildLaneStatusSnapshot({
+        hqRoot,
+        projectId: opts.project,
+        ...(company ? { companySlug: company.slug } : {}),
+        ...(company ? { companyUid: company.uid } : {}),
+        lanes,
+        generatedAt: ctx.now().toISOString(),
+        pendingQuestions: pending,
     });
+    if (opts.json)
+        printJson(snapshot);
+    else
+        console.log(formatLaneStatusHuman(snapshot));
 }
 async function runCapacity(ctx) {
     const hqRoot = ctx.hqRoot();
@@ -4336,34 +4436,43 @@ function validateResumeProfileModel(ctx, lane, profile) {
         env: ctx.env,
     });
 }
+function applyResumeProfileAndEffort(current, next, input) {
+    if (input.profile !== undefined) {
+        const profile = input.profile.profile;
+        next.worker = input.profile.id;
+        next.worker_path = input.profile.path;
+        next.worker_pack = input.profile.pack;
+        next.worker_profile = profile.id;
+        next.worker_profile_hash = profile.contentHash;
+        next.worker_profile_ignored = ignoredWorkerProfileFields(current.provider);
+        next.worker_policy_delivery = undefined;
+        if (next.model_source !== "cli") {
+            if (profile.meta.provider === current.provider && profile.meta.model !== undefined) {
+                next.model = profile.meta.model;
+                next.model_source = "profile";
+            }
+            else if (profile.meta.provider === current.provider) {
+                next.model = undefined;
+                next.model_source = "none";
+            }
+        }
+    }
+    if (input.effort !== undefined) {
+        next.effort = input.effort.effort;
+        next.effort_source = input.effort.source;
+    }
+}
 function recordResumeSetup(ctx, lane, input) {
-    if (input.profile === undefined && input.meshCompany === undefined)
+    if (input.profile === undefined &&
+        input.effort === undefined &&
+        input.meshCompany === undefined)
         return lane;
     return casUpdateLane(ctx.hqRoot(), lane.lane_id, (current) => {
         if (current.version !== lane.version) {
             throw new LanesError("lane_resume_setup_conflict", `Lane ${lane.lane_id} changed while resume settings were prepared; run the resume again`, { lane_id: lane.lane_id, prepared_version: lane.version, version: current.version });
         }
         const next = { ...current };
-        if (input.profile !== undefined) {
-            const profile = input.profile.profile;
-            next.worker = input.profile.id;
-            next.worker_path = input.profile.path;
-            next.worker_pack = input.profile.pack;
-            next.worker_profile = profile.id;
-            next.worker_profile_hash = profile.contentHash;
-            next.worker_profile_ignored = ignoredWorkerProfileFields(current.provider);
-            next.worker_policy_delivery = undefined;
-            if (current.model_source !== "cli") {
-                if (profile.meta.provider === current.provider && profile.meta.model !== undefined) {
-                    next.model = profile.meta.model;
-                    next.model_source = "profile";
-                }
-                else if (profile.meta.provider === current.provider) {
-                    next.model = undefined;
-                    next.model_source = "none";
-                }
-            }
-        }
+        applyResumeProfileAndEffort(current, next, input);
         if (input.meshCompany !== undefined) {
             if (current.company === null)
                 next.mesh_company = input.meshCompany;
@@ -4373,6 +4482,40 @@ function recordResumeSetup(ctx, lane, input) {
         return next;
     });
 }
+/** Resolve an explicit resume override or newly attached profile like create does. */
+function resolveResumeEffort(ctx, lane, input) {
+    if (input.cliEffort === undefined && input.profile === undefined)
+        return undefined;
+    const config = loadLanesConfig(ctx.hqRoot());
+    const providerConfig = config.providers[lane.provider];
+    const accountId = input.account?.trim() || lane.account;
+    const accountConfig = accountId === undefined
+        ? undefined
+        : providerConfig.accounts[accountId];
+    const profileDefaultsApply = input.profile?.profile.meta.provider === lane.provider;
+    const pinnedModel = lane.model_source === undefined || lane.model_source === "cli"
+        ? lane.model
+        : undefined;
+    const model = resolveLaneModel({
+        cliModel: input.model?.trim() || pinnedModel,
+        profileModel: profileDefaultsApply ? input.profile?.profile.meta.model : undefined,
+        accountModel: accountConfig?.model,
+        providerModel: providerConfig.model,
+    });
+    return resolveLaneEffort({
+        cliEffort: input.cliEffort,
+        profileEffort: profileDefaultsApply ? input.profile?.profile.meta.effort : undefined,
+        accountEffort: accountConfig?.effort,
+        providerEffort: providerConfig.effort,
+        model,
+    });
+}
+function recordedResumeEffort(lane) {
+    return {
+        ...(lane.effort !== undefined ? { effort: lane.effort } : {}),
+        source: lane.effort_source ?? "none",
+    };
+}
 /**
  * US-023: move the lane's provider session to `--account` (same provider)
  * before a resume or a message resume. Every check runs before anything is
@@ -4440,7 +4583,7 @@ async function prepareAccountMove(ctx, lane, input) {
     }).logged_in !== true) {
         throw new LanesError("account_not_logged_in", `Account ${target} for ${lane.provider} is not logged in (no credential file)`, { provider: lane.provider, account: target, lane_id: laneId });
     }
-    const profile = input.workerProfile ?? (lane.worker_profile !== undefined
+    const profile = input.workerProfile?.profile ?? (lane.worker_profile !== undefined
         ? loadWorkerProfile(hqRoot, lane.worker_profile)
         : undefined);
     const profileDefaultsApply = profile !== undefined && profile.meta.provider === lane.provider;
@@ -4542,6 +4685,10 @@ async function prepareAccountMove(ctx, lane, input) {
                     ? undefined
                     : { session_id: sessionId, at, ...input.pending },
             };
+            applyResumeProfileAndEffort(current, next, {
+                ...(input.workerProfile !== undefined ? { profile: input.workerProfile } : {}),
+                ...(input.effort !== undefined ? { effort: input.effort } : {}),
+            });
             if (input.deferTurnStart) {
                 next.state = current.state;
             }
@@ -4618,6 +4765,10 @@ async function runMessage(ctx, laneId, opts) {
         return;
     }
     assertLaneRunsHereForOperatorMutation(ctx, lane, "message");
+    const cliEffort = parseCliEffort(lane.provider, opts.effort);
+    if (cliEffort !== undefined && !providerSupportsSessionResume(lane.provider)) {
+        throw new LanesError("effort_resume_unsupported", `Provider ${lane.provider} cannot change effort on a resumed session`, { lane_id: laneId, provider: lane.provider });
+    }
     // Check before transcript recovery, account probing, or message writes.
     // The final state transition repeats this check under the senior lock.
     await withResumeHireAdmission(ctx, lane, () => undefined);
@@ -4649,16 +4800,34 @@ async function runMessage(ctx, laneId, opts) {
     if (opts.worker !== undefined && mechanism === "dropbox") {
         throw new LanesError("worker_profile_requires_resume", `Lane ${laneId} is still running; --worker can only be applied when message starts a resumed provider turn`, { lane_id: laneId, state: lane.state });
     }
+    if (cliEffort !== undefined && mechanism === "dropbox") {
+        throw new LanesError("lane_effort_requires_resume", `Lane ${laneId} is still running; --effort can only be applied when message starts a resumed provider turn`, { lane_id: laneId, state: lane.state });
+    }
     const resumeProfile = opts.worker !== undefined
         ? resolveResumeProfile(ctx, lane, opts.worker)
         : undefined;
     if (opts.model !== undefined && opts.account === undefined) {
         throw new LanesError("model_requires_account", "--model on hq lanes message is only accepted together with --account", {});
     }
+    const automaticAccountSelection = opts.account === undefined && mechanism === "resume"
+        ? await selectAutomaticClaudeResumeAccount(ctx, lane)
+        : undefined;
+    const resumeEffort = resolveResumeEffort(ctx, lane, {
+        cliEffort,
+        profile: resumeProfile,
+        account: opts.account ?? automaticAccountSelection?.account,
+        model: opts.model,
+    });
     const messageId = mintMessageId();
     const at = ctx.now().toISOString();
     const projectId = opts.project?.trim() || lane.project_id;
     const storyId = opts.story?.trim() || lane.story_id;
+    if (opts.story !== undefined && !opts.story.trim()) {
+        throw new LanesError("missing_story", "--story must be non-empty", {});
+    }
+    if ((opts.project !== undefined || opts.story !== undefined) && ctx.storyLedgerEnabled()) {
+        validateProjectStories(hqRoot, projectId, [storyId], lane.company?.slug);
+    }
     const dropboxMessage = {
         at,
         message_id: messageId,
@@ -4675,7 +4844,8 @@ async function runMessage(ctx, laneId, opts) {
         move = await prepareAccountMove(ctx, lane, {
             account: opts.account,
             cliModel: opts.model?.trim() || undefined,
-            ...(resumeProfile !== undefined ? { workerProfile: resumeProfile.profile } : {}),
+            ...(resumeProfile !== undefined ? { workerProfile: resumeProfile } : {}),
+            ...(resumeEffort !== undefined ? { effort: resumeEffort } : {}),
             pending: { trigger: "message", text, message_id: messageId, compact: opts.compact !== false },
         });
         lane = move.lane;
@@ -4684,13 +4854,14 @@ async function runMessage(ctx, laneId, opts) {
         }
     }
     else if (mechanism === "resume") {
-        const selection = await selectAutomaticClaudeResumeAccount(ctx, lane);
+        const selection = automaticAccountSelection;
         if (selection !== undefined) {
             if (selection.account !== lane.account) {
                 move = await prepareAccountMove(ctx, lane, {
                     account: selection.account,
                     cliModel: undefined,
-                    ...(resumeProfile !== undefined ? { workerProfile: resumeProfile.profile } : {}),
+                    ...(resumeProfile !== undefined ? { workerProfile: resumeProfile } : {}),
+                    ...(resumeEffort !== undefined ? { effort: resumeEffort } : {}),
                     pending: {
                         trigger: "message",
                         text,
@@ -4708,10 +4879,14 @@ async function runMessage(ctx, laneId, opts) {
             }
         }
     }
-    if (resumeProfile !== undefined) {
-        if (opts.account === undefined)
-            validateResumeProfileModel(ctx, lane, resumeProfile.profile);
-        lane = recordResumeSetup(ctx, lane, { profile: resumeProfile });
+    if (resumeProfile !== undefined && opts.account === undefined) {
+        validateResumeProfileModel(ctx, lane, resumeProfile.profile);
+    }
+    if (move === null && (resumeProfile !== undefined || resumeEffort !== undefined)) {
+        lane = recordResumeSetup(ctx, lane, {
+            ...(resumeProfile !== undefined ? { profile: resumeProfile } : {}),
+            ...(resumeEffort !== undefined ? { effort: resumeEffort } : {}),
+        });
     }
     if (move?.queued) {
         // Parked at the target's cap: reconcile resumes the session there.
@@ -4785,6 +4960,7 @@ async function runMessage(ctx, laneId, opts) {
                 }, {
                     trigger: { kind: "message", text, message_id: messageId },
                     compact: opts.compact !== false,
+                    effort: resumeEffort ?? recordedResumeEffort(lane),
                 });
                 archiveResumeMessage(hqRoot, laneId, dropboxMessage);
                 return started;
@@ -4805,6 +4981,7 @@ async function runMessage(ctx, laneId, opts) {
                 ...current,
                 project_id: projectId,
                 story_id: storyId,
+                no_story_reason: storyId ? undefined : current.no_story_reason,
                 stories: laneStory(current, projectId, storyId)
                     ? laneStories(current)
                     : [
@@ -5071,6 +5248,10 @@ async function runResume(ctx, laneId, opts) {
     // slot that its senior has already assigned elsewhere.
     await withResumeHireAdmission(ctx, lane, () => undefined);
     assertLaneRunsHereForOperatorMutation(ctx, lane, "resume");
+    const cliEffort = parseCliEffort(lane.provider, opts.effort);
+    if (cliEffort !== undefined && !providerSupportsSessionResume(lane.provider)) {
+        throw new LanesError("effort_resume_unsupported", `Provider ${lane.provider} cannot change effort on a resumed session`, { lane_id: laneId, provider: lane.provider });
+    }
     lane = laneWithRecoveredProviderSession(hqRoot, lane);
     if (opts.model !== undefined && opts.account === undefined) {
         throw new LanesError("model_requires_account", "--model on hq lanes resume is only accepted together with --account", {});
@@ -5102,6 +5283,12 @@ async function runResume(ctx, laneId, opts) {
     const at = ctx.now().toISOString();
     const projectId = opts.project?.trim() || lane.project_id;
     const storyId = opts.story?.trim() || lane.story_id;
+    if (opts.story !== undefined && !opts.story.trim()) {
+        throw new LanesError("missing_story", "--story must be non-empty", {});
+    }
+    if ((opts.project !== undefined || opts.story !== undefined) && ctx.storyLedgerEnabled()) {
+        validateProjectStories(hqRoot, projectId, [storyId], lane.company?.slug);
+    }
     const attributionChanged = projectId !== lane.project_id || storyId !== lane.story_id;
     const messageId = text !== undefined || attributionChanged ? mintMessageId() : undefined;
     let requestedMeshCompany;
@@ -5127,12 +5314,19 @@ async function runResume(ctx, laneId, opts) {
     const automaticAccountSelection = opts.account === undefined
         ? await selectAutomaticClaudeResumeAccount(ctx, lane)
         : undefined;
+    const resumeEffort = resolveResumeEffort(ctx, lane, {
+        cliEffort,
+        profile: resumeProfile,
+        account: opts.account ?? automaticAccountSelection?.account,
+        model: opts.model,
+    });
     let move = null;
     if (opts.account !== undefined) {
         move = await prepareAccountMove(ctx, lane, {
             account: opts.account,
             cliModel: opts.model?.trim() || undefined,
-            ...(resumeProfile !== undefined ? { workerProfile: resumeProfile.profile } : {}),
+            ...(resumeProfile !== undefined ? { workerProfile: resumeProfile } : {}),
+            ...(resumeEffort !== undefined ? { effort: resumeEffort } : {}),
             pending: {
                 trigger: "resume",
                 resumed_from: resumedFrom,
@@ -5148,7 +5342,8 @@ async function runResume(ctx, laneId, opts) {
             move = await prepareAccountMove(ctx, lane, {
                 account: automaticAccountSelection.account,
                 cliModel: undefined,
-                ...(resumeProfile !== undefined ? { workerProfile: resumeProfile.profile } : {}),
+                ...(resumeProfile !== undefined ? { workerProfile: resumeProfile } : {}),
+                ...(resumeEffort !== undefined ? { effort: resumeEffort } : {}),
                 pending: {
                     trigger: "resume",
                     resumed_from: resumedFrom,
@@ -5165,7 +5360,8 @@ async function runResume(ctx, laneId, opts) {
         }
     }
     lane = recordResumeSetup(ctx, lane, {
-        ...(resumeProfile !== undefined ? { profile: resumeProfile } : {}),
+        ...(move === null && resumeProfile !== undefined ? { profile: resumeProfile } : {}),
+        ...(move === null && resumeEffort !== undefined ? { effort: resumeEffort } : {}),
         ...(requestedMeshCompany !== undefined
             ? { meshCompany: requestedMeshCompany, threadId: meshThreadId }
             : {}),
@@ -5239,6 +5435,7 @@ async function runResume(ctx, laneId, opts) {
                         ...(messageId !== undefined ? { message_id: messageId } : {}),
                     },
                     compact: opts.compact !== false,
+                    effort: resumeEffort ?? recordedResumeEffort(lane),
                 });
             });
         }, ctx.sleep);
@@ -5272,6 +5469,7 @@ async function runResume(ctx, laneId, opts) {
                 ...current,
                 project_id: projectId,
                 story_id: storyId,
+                no_story_reason: storyId ? undefined : current.no_story_reason,
                 stories: laneStory(current, projectId, storyId)
                     ? laneStories(current)
                     : [
@@ -5362,8 +5560,7 @@ function addCarriedStory(lane, projectId, storyId, at) {
     }
     return {
         ...lane,
-        project_id: projectId,
-        story_id: storyId,
+        ...(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 },
@@ -5423,7 +5620,7 @@ async function emitStoryTransition(ctx, lane, projectId, storyId, event, status,
     const company = lane.mesh_company ?? lane.company;
     if (!company)
         return;
-    const ready = await ensureStoryThread(ctx, lane, projectId);
+    const ready = await ensureStoryThread(ctx, lane, projectId, storyId);
     if (!ready.thread_id)
         return;
     await emitLaneMeshEvent(ctx, company, ready.thread_id, event, {
@@ -5495,6 +5692,9 @@ async function runStoryAdd(ctx, laneId, storyId, opts) {
     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 = [];
     if (company) {
@@ -5510,7 +5710,11 @@ async function runStoryAdd(ctx, laneId, storyId, opts) {
     const before = lane;
     const next = casUpdateLane(hqRoot, laneId, (current) => {
         assertLaneRunsHereForOperatorMutation(ctx, current, "update story status for");
-        return addCarriedStory(current, projectId, normalizedStoryId, at);
+        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");
     if (transitionWarning !== undefined)
@@ -6855,13 +7059,16 @@ export function registerLanesCommand(parent, deps = {}) {
         .command("lanes", { hidden: true })
         .description("Create, supervise, and steer worker lanes; routed decision queue");
     registerOutpostPrunerCommand(lanes);
+    const noStoryOption = new Option("--no-story <reason>", "Create a lane without a story and record why");
+    noStoryOption.attributeName = () => "noStory";
     lanes
         .command("create")
         .description("Register a lane, run admission, and return immediately")
         .option("--company <slug|uid>", "Company slug or cloud uid; omit for a core/personal lane")
         .option("--mesh-company <slug|uid>", "Explicit Work Mesh company for a personal lane; membership is verified")
         .requiredOption("--project <slug>", "HQ project slug")
-        .requiredOption("--story <id>", "Story id from the project's prd.json")
+        .option("--story <id>", "Story id from the project's prd.json")
+        .addOption(noStoryOption)
         .option("--additional-story <id>", "Additional story carried by this lane; repeatable and discouraged when active", collectRepeatable)
         .requiredOption("--brief-file <path>", "Path to the lane brief")
         .option("--worker <name>", "HQ worker or reusable profile id")
@@ -6911,10 +7118,20 @@ export function registerLanesCommand(parent, deps = {}) {
         .option("--story <id>", "Filter by story")
         .option("--state <state>", `Filter by state (${LANE_STATES.join("|")})`)
         .option("--senior <ref>", "Filter by senior ref")
-        .option("--json", "JSON on stdout (always)")
+        .option("--json", "Emit JSON on stdout (default)")
+        .option("--human", "Emit human-readable output")
         .action(wrap(async (opts) => {
         await runList(ctx, opts);
     }));
+    lanes
+        .command("status")
+        .description("Summarize project stories, lanes, PRs, blockers, and pending questions")
+        .requiredOption("--project <slug>", "HQ project slug")
+        .option("--company <slug|uid>", "Company project scope; omit for a personal project")
+        .option("--json", "Emit JSON on stdout")
+        .action(wrap(async (opts) => {
+        await runStatus(ctx, opts);
+    }));
     lanes
         .command("capacity")
         .description("Report this host's lane capacity by provider and account")
@@ -7049,6 +7266,7 @@ export function registerLanesCommand(parent, deps = {}) {
         .option("--story <id>", "Re-point story attribution from this message")
         .option("--account <id>", "Move the lane's session to this account of its provider before the message resumes it")
         .option("--model <id>", "Model for the moved lane (with --account only)")
+        .option("--effort <level>", "Reasoning effort for the resumed provider turn")
         .option("--worker <profile>", "Attach a personal worker profile when this message resumes the lane")
         .option("--no-compact", "Skip the resume-time compaction check for this message")
         .action(wrap(async (laneId, opts) => {
@@ -7063,6 +7281,7 @@ export function registerLanesCommand(parent, deps = {}) {
         .option("--story <id>", "Re-point story attribution from this resume")
         .option("--account <id>", "Move the lane's session to this account of its provider before resuming")
         .option("--model <id>", "Model for the moved lane (with --account only)")
+        .option("--effort <level>", "Reasoning effort for the resumed provider turn")
         .option("--worker <profile>", "Attach a personal worker profile for the resumed turn")
         .option("--mesh-company <slug>", "Attach Work Mesh attribution after verifying company membership")
         .option("--no-compact", "Skip the resume-time compaction check for this resume")