@indigoai-us/hq-cli 5.345.43 → 5.345.45

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## [Unreleased]
 
+## [5.345.45] — 2026-10-07
+- A failed automatic CLI update now pauses automatic updates for 24 hours, including for newer releases, instead of retrying on every command. `hq rescue` still updates on request. Processes started by an update can no longer start another install, and update package-manager processes run with Corepack settings that cannot change your default pnpm version.
+
+- Hosted agents can run `hq access`, `hq secrets --personal`, and the `hq db destroy` role check under their own `agt_*` identity instead of failing with "No person entity found". Person-only commands (`hq meetings import`, `hq bot create`) now tell an agent identity that the command is not available to agents.
+- Add a default-off focus guard to lane creation and story-switch resume, with logged, auditable overrides.
+- `hq lanes set <lane> --company <slug>` binds missing company attribution, including on legacy and terminal lane records.
+- Use the per-user local application cache when Windows denies the configured flag snapshot cache.
+
+## [5.345.44] — 2026-10-07
+- Long-running CLI processes now refresh their package-use lease so desktop updates only reclaim holders whose liveness heartbeat has expired.
+- Quota-exhausted lanes can fail over within their provider, hold with per-account eligibility reasons when none is available, and retry when the earliest quota reset arrives. The default-off `lanes.quota-account-failover` gate controls the new recovery path.
+
+- When a company's plan does not include remote databases, `hq db provision`, `usage`, `sql`, `dump` and `destroy` now show which plan includes them, the $10 per database app price and the upgrade link.
+- `hq lanes report` can show a gated focus list, focus-guard override reasons, and per-team 24-hour focus share.
+- Return a child's hire grant to its senior when the lane becomes terminal, let the senior adjust or clear the saved grant, report grant updates correctly, and reject over-cap increases while allowing reductions that repair oversubscription.
+- Recover CLI startup when a package update temporarily removes a module from the installed command graph.
+
+
 ## [5.345.43] — 2026-10-07
 - The published core-command E2E workflow now retries the exact npm release install for up to 10 minutes while registry propagation completes.
 

package/dist/command-catalog.generated.d.ts

@@ -11469,6 +11469,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--story <id>";
             readonly description: "Story id from the project's prd.json";
             readonly hidden: false;
+        }, {
+            readonly flags: "--focus-override <reason>";
+            readonly description: "Human-approved reason to override the lane focus guard";
+            readonly hidden: false;
         }, {
             readonly flags: "--no-story <reason>";
             readonly description: "Create a lane without a story and record why";
@@ -11683,7 +11687,7 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly subcommands: readonly [];
     }, {
         readonly name: "set";
-        readonly description: "Change the model or effort a lane uses from its next resume";
+        readonly description: "Change lane settings or bind its missing company attribution";
         readonly aliases: readonly [];
         readonly hidden: false;
         readonly helpOption: true;
@@ -11697,6 +11701,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly description: "Lane id";
         }];
         readonly options: readonly [{
+            readonly flags: "--company <slug>";
+            readonly description: "Bind missing company attribution to this lane";
+            readonly hidden: false;
+        }, {
             readonly flags: "--model <model>";
             readonly description: "Model for the lane's next and later turns";
             readonly hidden: false;
@@ -12374,6 +12382,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--story <id>";
             readonly description: "Re-point story attribution; a changed story is named in the resumed prompt";
             readonly hidden: false;
+        }, {
+            readonly flags: "--focus-override <reason>";
+            readonly description: "Human-approved reason to override the lane focus guard";
+            readonly hidden: false;
         }, {
             readonly flags: "--account <id>";
             readonly description: "Move the lane's session to this account of its provider before the message resumes it";
@@ -12497,6 +12509,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--story <id>";
             readonly description: "Re-point story attribution; a changed story is named in the resumed prompt";
             readonly hidden: false;
+        }, {
+            readonly flags: "--focus-override <reason>";
+            readonly description: "Human-approved reason to override the lane focus guard";
+            readonly hidden: false;
         }, {
             readonly flags: "--account <id>";
             readonly description: "Move the lane's session to this account of its provider before resuming";

package/dist/command-catalog.generated.js

@@ -13932,6 +13932,11 @@ export const COMMAND_CATALOG = [
                         "description": "Story id from the project's prd.json",
                         "hidden": false
                     },
+                    {
+                        "flags": "--focus-override <reason>",
+                        "description": "Human-approved reason to override the lane focus guard",
+                        "hidden": false
+                    },
                     {
                         "flags": "--no-story <reason>",
                         "description": "Create a lane without a story and record why",
@@ -14198,7 +14203,7 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "set",
-                "description": "Change the model or effort a lane uses from its next resume",
+                "description": "Change lane settings or bind its missing company attribution",
                 "aliases": [],
                 "hidden": false,
                 "helpOption": true,
@@ -14214,6 +14219,11 @@ export const COMMAND_CATALOG = [
                     }
                 ],
                 "options": [
+                    {
+                        "flags": "--company <slug>",
+                        "description": "Bind missing company attribution to this lane",
+                        "hidden": false
+                    },
                     {
                         "flags": "--model <model>",
                         "description": "Model for the lane's next and later turns",
@@ -15045,6 +15055,11 @@ export const COMMAND_CATALOG = [
                         "description": "Re-point story attribution; a changed story is named in the resumed prompt",
                         "hidden": false
                     },
+                    {
+                        "flags": "--focus-override <reason>",
+                        "description": "Human-approved reason to override the lane focus guard",
+                        "hidden": false
+                    },
                     {
                         "flags": "--account <id>",
                         "description": "Move the lane's session to this account of its provider before the message resumes it",
@@ -15197,6 +15212,11 @@ export const COMMAND_CATALOG = [
                         "description": "Re-point story attribution; a changed story is named in the resumed prompt",
                         "hidden": false
                     },
+                    {
+                        "flags": "--focus-override <reason>",
+                        "description": "Human-approved reason to override the lane focus guard",
+                        "hidden": false
+                    },
                     {
                         "flags": "--account <id>",
                         "description": "Move the lane's session to this account of its provider before resuming",

package/dist/commands/access.js

@@ -19,7 +19,7 @@ import * as path from "node:path";
 import * as readline from "node:readline";
 import { ListObjectsV2Command, } from "@aws-sdk/client-s3";
 import { DEFAULT_HQ_ROOT } from "../utils/cognito-session.js";
-import { getCompanyUid, vaultApiFetch, resolveCallerPersonUid } from "../utils/vault-api.js";
+import { getCompanyUid, vaultApiFetch, resolveCallerUid } from "../utils/vault-api.js";
 import { parseCompanySlugFromPath, resolveBrowseSession, makeCompanyPresignFactory, runGet, } from "./files-browse.js";
 import { listJournals, syncDoctor, } from "@indigoai-us/hq-cloud";
 import { listActiveMembers } from "./members.js";
@@ -705,9 +705,11 @@ export async function runAccessForPath(path, opts) {
         }));
     };
     const members = await listMembers();
-    const callerUid = await resolveCallerPersonUid(token);
-    const me = members.find((m) => m.personUid === callerUid);
-    let requesterEmail = me?.personEmail;
+    const caller = await resolveCallerUid(token);
+    const me = members.find((m) => m.personUid === caller.uid);
+    // An agent has no mailbox and no person entity. `hq files share --with`
+    // accepts its agt_* uid, so the access request names the agent by uid.
+    let requesterEmail = caller.kind === "agent" ? caller.uid : me?.personEmail;
     const requesterName = me?.personName;
     if (!requesterEmail) {
         const claims = peekIdToken(token);

package/dist/commands/bot.js

@@ -504,7 +504,7 @@ export async function runBotCreate(nameArg, opts) {
         throw Object.assign(new Error(`The name ${RESERVED_SETUP_BOT_NAME} is reserved for HQ's setup bot; create it with --worker ${RESERVED_SETUP_BOT_NAME}.`), { expected: true });
     }
     const token = await ownerToken();
-    const owner = await resolveCallerPersonUid(token);
+    const owner = await resolveCallerPersonUid(token, undefined, { command: "hq bot create" });
     if (!owner)
         throw Object.assign(new Error("Your HQ login has no person entity yet; open the HQ desktop app once, then retry."), { expected: true });
     const api = new BotApi({ token: async () => token });

package/dist/commands/db-destroy.js

@@ -12,16 +12,17 @@ async function defaultCheckRole(deps, companyUid) {
     if (process.env.HQ_DB_MOCK_CONTROL_PLANE === "1")
         return "unknown";
     try {
-        const [{ listActiveMembers }, { resolveCallerPersonUid }] = await Promise.all([
+        const [{ listActiveMembers }, { resolveCallerUid }] = await Promise.all([
             import("./members.js"),
             import("../utils/vault-api.js"),
         ]);
         const token = await deps.getAccessToken();
-        const [personUid, members] = await Promise.all([
-            resolveCallerPersonUid(token),
+        // An agent's membership row carries its agt_* uid in the personUid slot.
+        const [caller, members] = await Promise.all([
+            resolveCallerUid(token),
             listActiveMembers(token, companyUid),
         ]);
-        const me = members.find((m) => m.personUid === personUid);
+        const me = members.find((m) => m.personUid === caller.uid);
         if (!me)
             return "unknown";
         return me.role === "owner" || me.role === "admin" ? "allowed" : "denied";

package/dist/commands/db-remote-deps.js

@@ -42,6 +42,10 @@ export function describeRemoteError(error) {
     const status = error.status;
     const code = error.code;
     if (code === "REMOTE_DB_NOT_AVAILABLE" || status === 501) {
+        const reason = error.reason;
+        const message = error.message;
+        if (reason === "plan" && typeof message === "string" && message)
+            return message;
         return "Remote databases are not available yet.";
     }
     if (status === 402 || code === "PLAN_REQUIRED") {

package/dist/commands/lanes-checks.d.ts

@@ -22,6 +22,7 @@ export declare function mappingIncludesStory(mapping: ProjectMapping, storyId: s
 export interface ProjectReadResult {
     stories: Array<Record<string, unknown>>;
     mtime: number;
+    focus_overrides?: unknown;
     errors?: Array<{
         path: string;
         field: string;

package/dist/commands/lanes-checks.js

@@ -272,7 +272,12 @@ export function readProject(root, company, prdPath, tolerantStories = false) {
         return [story];
     });
     try {
-        return { stories, mtime: fs.statSync(prdPath).mtimeMs, ...(tolerantStories ? { errors } : {}) };
+        return {
+            stories,
+            mtime: fs.statSync(prdPath).mtimeMs,
+            ...(parsed.focus_overrides === undefined ? {} : { focus_overrides: parsed.focus_overrides }),
+            ...(tolerantStories ? { errors } : {}),
+        };
     }
     catch (err) {
         return fail("tracker_checks_input_unreadable", `Project task list could not be stat'ed: ${err instanceof Error ? err.message : String(err)}`, { path: prdPath });

package/dist/commands/lanes-message.js

@@ -14,6 +14,8 @@ import { laneRunDir, probePidRecord, readPidRecord, readProcStarttime, spawnLane
 import { findRetiredLaneEntry, keepAliveExclusion, keepAliveSupersededBy, LANE_RUNNING_SUPERSEDED_MESSAGE_DELIVERY_FLAG, LANE_SUPERSESSION_LINEAGE_AWARE_FLAG, loadRetiredLaneIds } from "../lib/lanes/keep-alive.js";
 import { isTerminalLaneState } from "../lib/lanes/types.js";
 import { readLanesRegistryFlag } from "../lib/lanes/registry-flag.js";
+import { appendLaneFocusOverride, focusGuardRefusal, makeFocusOverride } from "../lib/lanes/focus-guard.js";
+import { appendProjectFocusOverride, removeProjectFocusOverride } from "../lib/lanes/story-ledger.js";
 import { resolveLaneCompany } from "../lib/lanes/lane-company.js";
 import { accountMoveSummary, accountRequestKeepsCurrentLane, assertCurrentResumeAccountAvailable, callerMatchesSessionSenior, recordedResumeEffort, resetKeepAliveProgress, resolveResumeEffort } from "./lanes-shared.js";
 export function parseMonitorLaneMessagePayload(input) {
@@ -381,6 +383,28 @@ export function createLaneMessageHandlers(deps) {
         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);
+        }
+        if (opts.focusOverride !== undefined && !storyId) {
+            throw new LanesError("focus_override_story_required", "--focus-override requires --story", { lane_id: laneId });
+        }
+        const attributionChanged = projectId !== lane.project_id || storyId !== lane.story_id;
+        const focusAssessment = opts.project !== undefined || opts.story !== undefined || opts.focusOverride !== undefined
+            ? await deps.focusGuardAssessment(ctx, {
+                projectId,
+                storyIds: storyId ? [storyId] : [],
+                company: lane.company,
+                checkTeamBlockers: attributionChanged,
+                overrideReason: opts.focusOverride,
+            })
+            : { enabled: false, reasons: [] };
+        if (focusAssessment.enabled && focusAssessment.reasons.length > 0 && opts.focusOverride === undefined) {
+            throw focusGuardRefusal(focusAssessment.reasons);
+        }
+        const focusOverride = focusAssessment.enabled && opts.focusOverride !== undefined
+            ? makeFocusOverride({ reason: opts.focusOverride, laneId, at: ctx.now().toISOString(), storyId: storyId })
+            : undefined;
         const refreshProfileSettings = lane.state === "done" &&
             (projectId !== lane.project_id || storyId !== lane.story_id) &&
             await deps.reuseProfileRefreshEnabled(ctx, lane);
@@ -567,12 +591,6 @@ export function createLaneMessageHandlers(deps) {
             });
             const messageId = mintMessageId();
             const at = ctx.now().toISOString();
-            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 notice = storySwitchNotice(lane.project_id, lane.story_id, projectId, storyId);
             const promptedText = notice === undefined ? text : `${notice}\n\n${text}`;
             const framedMonitorEvent = opts.monitorEvent === undefined
@@ -602,51 +620,66 @@ export function createLaneMessageHandlers(deps) {
                     sequence: opts.monitorEvent.sequence,
                 }),
             };
-            if (projectId !== lane.project_id || storyId !== lane.story_id) {
-                lane = casUpdateLane(hqRoot, laneId, (current) => {
-                    const already = current.attribution_history.some((entry) => entry.message_id === messageId);
-                    if (already)
-                        return current;
-                    const existingStory = laneStory(current, projectId, storyId);
-                    storySwitchRollback = {
-                        message_id: messageId,
-                        project_id: current.project_id,
-                        story_id: current.story_id,
-                        no_story_reason: current.no_story_reason,
-                        ...(!existingStory ? {
-                            added_story: { project_id: projectId, story_id: storyId, status: "in_progress", added_at: at, updated_at: at },
-                        } : {}),
-                        story_switch_unacknowledged: current.story_switch_unacknowledged,
-                    };
-                    return {
-                        ...current,
-                        project_id: projectId,
-                        story_id: storyId,
-                        no_story_reason: storyId ? undefined : current.no_story_reason,
-                        stories: laneStory(current, projectId, storyId)
-                            ? laneStories(current)
-                            : [
-                                ...laneStories(current),
-                                { project_id: projectId, story_id: storyId, status: "in_progress", added_at: at, updated_at: at },
-                            ],
-                        attribution_history: appendCappedHistory(current.attribution_history, {
-                            project_id: projectId,
-                            story_id: storyId,
-                            message_id: messageId,
-                            at,
-                        }),
-                        story_switch_pending: {
-                            previous_project_id: current.project_id,
-                            previous_story_id: current.story_id,
-                            project_id: projectId,
-                            story_id: storyId,
-                            message_id: messageId,
-                            at,
-                            previous_artifact_keys: artifactIdentityKeys(current.last_envelope?.artifacts),
-                        },
-                        story_switch_unacknowledged: undefined,
-                    };
-                });
+            if (attributionChanged || focusOverride !== undefined) {
+                if (focusOverride !== undefined) {
+                    appendProjectFocusOverride(hqRoot, projectId, lane.company?.slug, focusOverride);
+                }
+                try {
+                    lane = casUpdateLane(hqRoot, laneId, (current) => {
+                        let next = current;
+                        if (attributionChanged) {
+                            const already = current.attribution_history.some((entry) => entry.message_id === messageId);
+                            if (!already) {
+                                const existingStory = laneStory(current, projectId, storyId);
+                                storySwitchRollback = {
+                                    message_id: messageId,
+                                    project_id: current.project_id,
+                                    story_id: current.story_id,
+                                    no_story_reason: current.no_story_reason,
+                                    ...(!existingStory ? {
+                                        added_story: { project_id: projectId, story_id: storyId, status: "in_progress", added_at: at, updated_at: at },
+                                    } : {}),
+                                    story_switch_unacknowledged: current.story_switch_unacknowledged,
+                                };
+                                next = {
+                                    ...current,
+                                    project_id: projectId,
+                                    story_id: storyId,
+                                    no_story_reason: storyId ? undefined : current.no_story_reason,
+                                    stories: laneStory(current, projectId, storyId)
+                                        ? laneStories(current)
+                                        : [
+                                            ...laneStories(current),
+                                            { project_id: projectId, story_id: storyId, status: "in_progress", added_at: at, updated_at: at },
+                                        ],
+                                    attribution_history: appendCappedHistory(current.attribution_history, {
+                                        project_id: projectId,
+                                        story_id: storyId,
+                                        message_id: messageId,
+                                        at,
+                                    }),
+                                    story_switch_pending: {
+                                        previous_project_id: current.project_id,
+                                        previous_story_id: current.story_id,
+                                        project_id: projectId,
+                                        story_id: storyId,
+                                        message_id: messageId,
+                                        at,
+                                        previous_artifact_keys: artifactIdentityKeys(current.last_envelope?.artifacts),
+                                    },
+                                    story_switch_unacknowledged: undefined,
+                                };
+                            }
+                        }
+                        return focusOverride === undefined ? next : appendLaneFocusOverride(next, focusOverride);
+                    });
+                }
+                catch (error) {
+                    if (focusOverride !== undefined) {
+                        removeProjectFocusOverride(hqRoot, projectId, lane.company?.slug, focusOverride);
+                    }
+                    throw error;
+                }
             }
             let resumed = null;
             let move = null;

package/dist/commands/lanes-report.d.ts

@@ -1,10 +1,11 @@
 import type { Command } from "commander";
 import { type QuestionBody } from "../lib/lanes/questions.js";
-import type { QuestionRecord } from "../lib/lanes/types.js";
+import type { LaneCompanyRef, QuestionRecord } from "../lib/lanes/types.js";
 import { type LaneChecksDeps } from "./lanes-checks.js";
 type WrapHandler = <Args extends unknown[]>(action: (...args: Args) => Promise<void>) => (...args: Args) => Promise<void>;
 export interface LaneReportsDeps extends LaneChecksDeps {
     readQuestionBody: (root: string, question: QuestionRecord) => QuestionBody;
+    focusDashboardEnabled: (company: LaneCompanyRef) => Promise<boolean>;
 }
 export declare function registerLaneReportCommands(parent: Command, deps: LaneReportsDeps, wrap: WrapHandler): void;
 export {};

package/dist/commands/lanes-report.js

@@ -163,7 +163,7 @@ function issueFromError(err, fallbackPath, fallbackField, ids = {}) {
         ...(typeof details.question_id === "string" ? { question_id: details.question_id } : ids.question_id ? { question_id: ids.question_id } : {}),
     };
 }
-async function teamInput(root, company, project, questions, deps, errors = []) {
+async function teamInput(root, company, project, questions, deps, errors = [], includeFocusDashboard = false) {
     const projectDirectory = path.join(root, "companies", company.slug, "projects", project.projectId);
     const prdPath = path.join(projectDirectory, "prd.json");
     let prd = { stories: [], mtime: 0 };
@@ -213,10 +213,64 @@ async function teamInput(root, company, project, questions, deps, errors = []) {
             }
             normalizedUpdatedAt = normalized;
         }
+        const ownerValue = includeFocusDashboard ? story.owner ?? story.assignee : undefined;
+        let owner = null;
+        if (ownerValue !== undefined && ownerValue !== null) {
+            if (typeof ownerValue === "string" && ownerValue.trim())
+                owner = ownerValue.trim();
+            else
+                errors.push({ path: prdPath, field: "owner", story_id: id, message: "Story owner must be a non-empty string when present" });
+        }
+        const deadlineValue = includeFocusDashboard ? story.deadline ?? story.due_at ?? story.due_date : undefined;
+        let deadline = null;
+        if (deadlineValue !== undefined && deadlineValue !== null) {
+            if (typeof deadlineValue === "string" && deadlineValue.trim())
+                deadline = deadlineValue.trim();
+            else
+                errors.push({ path: prdPath, field: "deadline", story_id: id, message: "Story deadline must be a non-empty string when present" });
+        }
         const refs = storyReferences(story, prdPath, id, errors);
         pullRequests.push(...refs.pullRequests);
         releases.push(...refs.releases);
-        stories.push({ id, title, status, references: refs.references, ...(normalizedUpdatedAt ? { updated_at: normalizedUpdatedAt } : {}), source_path: prdPath });
+        stories.push({
+            id,
+            title,
+            status,
+            focus_id: story.focus_id,
+            kpi: story.kpi,
+            owner,
+            deadline,
+            references: refs.references,
+            ...(normalizedUpdatedAt ? { updated_at: normalizedUpdatedAt } : {}),
+            source_path: prdPath,
+        });
+    }
+    const focusOverrides = [];
+    if (includeFocusDashboard && prd.focus_overrides !== undefined) {
+        if (!Array.isArray(prd.focus_overrides)) {
+            errors.push({ path: prdPath, field: "focus_overrides", message: "Project focus_overrides must be an array" });
+        }
+        else {
+            for (const [index, raw] of prd.focus_overrides.entries()) {
+                if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+                    errors.push({ path: prdPath, field: `focus_overrides[${index}]`, message: "Focus override must be an object" });
+                    continue;
+                }
+                const record = raw;
+                if (["reason", "by_lane", "at", "story"].some((field) => typeof record[field] !== "string" || !record[field].trim())) {
+                    errors.push({ path: prdPath, field: `focus_overrides[${index}]`, message: "Focus override needs non-empty reason, by_lane, at, and story fields" });
+                    continue;
+                }
+                const at = normalizeIsoTimestamp(record.at);
+                if (at === null) {
+                    errors.push({ path: prdPath, field: `focus_overrides[${index}].at`, message: "Focus override at must be a valid timestamp" });
+                    continue;
+                }
+                const override = { reason: record.reason, by_lane: record.by_lane, at, story: record.story };
+                if (mappingIncludesStory(project, override.story))
+                    focusOverrides.push(override);
+            }
+        }
     }
     const teamQuestions = [];
     for (const record of questions.filter((question) => question.project_id === project.projectId
@@ -236,6 +290,7 @@ async function teamInput(root, company, project, questions, deps, errors = []) {
         team: project.team,
         project_id: project.projectId,
         stories,
+        focus_overrides: focusOverrides,
         pull_requests: pullRequests,
         releases,
         blockers: await trackerRecords(root, company, project, "blocker", errors),
@@ -246,7 +301,7 @@ async function teamInput(root, company, project, questions, deps, errors = []) {
         errors,
     };
 }
-async function allTeamInputs(root, company, deps) {
+async function allTeamInputs(root, company, deps, includeFocusDashboard) {
     const mappings = loadProjectMappings(root, company.slug);
     const teams = [];
     for (const project of [...mappings.values()].sort((a, b) => a.team.localeCompare(b.team) || a.projectId.localeCompare(b.projectId))) {
@@ -258,7 +313,7 @@ async function allTeamInputs(root, company, deps) {
         catch (err) {
             errors.push(issueFromError(err, path.join(root, "companies", company.slug, "projects", project.projectId), "questions"));
         }
-        teams.push(await teamInput(root, company, project, questions, deps, errors));
+        teams.push(await teamInput(root, company, project, questions, deps, errors, includeFocusDashboard));
     }
     return teams;
 }
@@ -282,6 +337,7 @@ export function registerLaneReportCommands(parent, deps, wrap) {
         const company = await resolveTrackerCompany(deps, options.company);
         const root = deps.hqRoot();
         const generatedAt = deps.now().toISOString();
+        const focusDashboardEnabled = await deps.focusDashboardEnabled(company);
         const previous = options.since === undefined ? readTrackerReportState(root, company.slug) : null;
         const since = options.since ?? previous?.last_report_at ?? FIRST_TRACKER_REPORT_SINCE;
         const input = {
@@ -289,7 +345,8 @@ export function registerLaneReportCommands(parent, deps, wrap) {
             generated_at: generatedAt,
             since,
             since_source: options.since !== undefined ? "explicit" : previous ? "previous_report" : "first_run",
-            teams: await allTeamInputs(root, company, deps),
+            focus_dashboard_enabled: focusDashboardEnabled,
+            teams: await allTeamInputs(root, company, deps, focusDashboardEnabled),
         };
         const report = buildTrackerOwnerReport(input);
         const hasErrors = report.teams.some((team) => team.errors.length > 0);
@@ -323,7 +380,7 @@ export function registerLaneReportCommands(parent, deps, wrap) {
         catch (err) {
             errors.push(issueFromError(err, path.join(root, "companies", company.slug, "projects", candidates[0].projectId), "questions"));
         }
-        const input = await teamInput(root, company, candidates[0], questions, deps, errors);
+        const input = await teamInput(root, company, candidates[0], questions, deps, errors, false);
         const page = buildTrackerTeamPage(input, company.slug, since, generatedAt);
         if (page.errors.length > 0)
             process.exitCode = 2;

package/dist/commands/lanes-resume.js

@@ -7,6 +7,8 @@ import { assertNoSecretText } from "../lib/lanes/text-scan.js";
 import { laneStories, laneStory, storyWarning } from "../lib/lanes/stories.js";
 import { artifactIdentityKeys, rollbackStorySwitchAttribution, storySwitchNotice } from "../lib/lanes/story-switch.js";
 import { markSpawnFailure, spawnLaneWorker } from "../lib/lanes/spawn.js";
+import { appendProjectFocusOverride, removeProjectFocusOverride } from "../lib/lanes/story-ledger.js";
+import { appendLaneFocusOverride, makeFocusOverride } from "../lib/lanes/focus-guard.js";
 import { accountMoveSummary, accountRequestKeepsCurrentLane, assertCurrentResumeAccountAvailable, hasKeepAliveProgress, recordedResumeEffort, resetKeepAliveProgress, resolveResumeEffort } from "./lanes-shared.js";
 export function createLaneResumeHandlers(deps) {
     const { archiveResumeMessage, assertLaneRunsHereForAdmission, assertLaneRunsHereForOperatorMutation, assessLaneAdmission, automaticBalanceMoveHistoryReason, authorizeFailedResume, authorizeResumeProfileRepin, casUpdateLane, dispatchOutpostLaneCommand, laneIsHostedHere, laneWithRecoveredProviderSession, mintMessageId, persistClaudeAccountSelection, prepareAccountMove, printJson, recordResumeSetup, resolveResumeProfile, selectAutomaticClaudeResumeAccount, validateResumeProfileModel, withResumeHireAdmission } = deps;
@@ -200,10 +202,22 @@ export function createLaneResumeHandlers(deps) {
         if (opts.story !== undefined && !opts.story.trim()) {
             throw new LanesError("missing_story", "--story must be non-empty", {});
         }
+        if (opts.focusOverride !== undefined && !storyId) {
+            throw new LanesError("focus_override_story_required", "--focus-override requires a target story", { lane_id: laneId });
+        }
         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 focusAssessment = opts.story !== undefined || opts.project !== undefined || opts.focusOverride !== undefined
+            ? await deps.focusGuardAssessment(ctx, {
+                projectId,
+                storyIds: storyId ? [storyId] : [],
+                company: lane.company,
+                checkTeamBlockers: attributionChanged,
+                overrideReason: opts.focusOverride,
+            })
+            : { enabled: false, reasons: [] };
         const refreshProfileSettings = lane.state === "done" && attributionChanged &&
             await deps.reuseProfileRefreshEnabled(ctx, lane);
         const refreshWorker = opts.worker ?? (refreshProfileSettings ? lane.worker_profile : undefined);
@@ -370,6 +384,36 @@ export function createLaneResumeHandlers(deps) {
             });
         }
         try {
+            if (focusAssessment.enabled && opts.focusOverride !== undefined) {
+                const focusOverride = makeFocusOverride({
+                    reason: opts.focusOverride,
+                    laneId: lane.lane_id,
+                    at,
+                    storyId,
+                });
+                try {
+                    appendProjectFocusOverride(hqRoot, projectId, lane.company?.slug, focusOverride);
+                    lane = casUpdateLane(hqRoot, laneId, (current) => ({
+                        ...appendLaneFocusOverride(current, focusOverride),
+                    }));
+                }
+                catch (error) {
+                    try {
+                        removeProjectFocusOverride(hqRoot, projectId, lane.company?.slug, focusOverride);
+                    }
+                    catch (cleanupError) {
+                        process.stderr.write(`${JSON.stringify({
+                            event: "lanes.focus_guard.override_rollback_failed",
+                            lane_id: lane.lane_id,
+                            error: cleanupError instanceof Error ? cleanupError.name : "UnknownError",
+                        })}\n`);
+                    }
+                    throw new LanesError("focus_override_persist_failed", "Could not persist the focus override; lane resume was refused", {
+                        lane_id: lane.lane_id,
+                        error: error instanceof Error ? error.name : "UnknownError",
+                    });
+                }
+            }
             let move = null;
             if (opts.account !== undefined && !keepCurrentAccount) {
                 move = await prepareAccountMove(ctx, lane, {