@indigoai-us/hq-cli 5.124.0 → 5.126.0

package/dist/commands/lanes.d.ts

@@ -0,0 +1,75 @@
+/**
+ * `hq lanes` — worker lane management and decision queue (spec §5–§7, §10–§11).
+ *
+ * Every command prints JSON on stdout and takes no interactive input, except
+ * `accounts login`, which hands the terminal to the vendor's own sign-in.
+ */
+import { Command } from "commander";
+import { type LaneCompanyRef, type LaneRecord, type QuestionRecord, type ResolvedLaneWorker, type SeniorRef, type ThrottleDeps } from "../lib/lanes/index.js";
+export declare const MAX_LANE_DEPTH = 2;
+export declare const OUTPOST_ID_PATH = "/etc/outpost/outpost-id";
+export declare const OUTPOST_DIR = "/etc/outpost";
+export declare const LANES_RUNS_REL: string;
+export type OutpostIdentity = {
+    kind: "id";
+    id: string;
+} | {
+    kind: "unknown";
+} | {
+    kind: "not_outpost";
+};
+export interface SpawnLoginResult {
+    status: number;
+}
+export interface LanesMesh {
+    ensureProjectThread: (company: LaneCompanyRef, projectId: string) => Promise<string>;
+    appendThreadEvent: (company: LaneCompanyRef, threadId: string, eventKind: string, payload: Record<string, unknown>) => Promise<void>;
+    patchStoryStatus: (company: LaneCompanyRef, projectId: string, storyId: string, status: string) => Promise<void>;
+}
+export interface LanesCommandDeps {
+    hqRoot?: () => string;
+    env?: NodeJS.ProcessEnv;
+    now?: () => Date;
+    hostname?: () => string;
+    resolveCompany?: (company?: string) => Promise<LaneCompanyRef>;
+    listOutpostIds?: () => Promise<string[]>;
+    readOutpostIdentity?: () => OutpostIdentity;
+    spawnLogin?: (opts: {
+        command: string;
+        args: string[];
+        env: NodeJS.ProcessEnv;
+        cwd?: string;
+    }) => Promise<SpawnLoginResult>;
+    throttleDeps?: ThrottleDeps;
+    existsSync?: (p: string) => boolean;
+    readFileSync?: (p: string, encoding: "utf8") => string;
+    homedir?: () => string;
+    mesh?: LanesMesh;
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Spawn seam for the worker process (spec §5). Process spawning and the
+ * reconcile daemon are out of scope for this command surface; calling this
+ * throws rather than faking a running lane.
+ */
+export declare function spawnLaneWorker(lane: LaneRecord): never;
+export declare function readOutpostIdentity(existsSync?: (p: string) => boolean, readFileSync?: (p: string) => string): OutpostIdentity;
+export declare function parseSeniorRef(raw: string): SeniorRef;
+export declare function resolveAnswerChoice(choice: string, options: string[], freeform: boolean): string;
+/** Tenant-store path for a question body (spec §6.2 / §10). Never the personal vault for company prose. */
+export declare function questionBodyAbsPath(hqRoot: string, question: Pick<QuestionRecord, "company" | "body" | "question_id">): string;
+export declare function casUpdateQuestion(hqRoot: string, questionId: string, updater: (current: QuestionRecord) => QuestionRecord): QuestionRecord;
+export declare function casUpdateLane(hqRoot: string, laneId: string, updater: (current: LaneRecord) => LaneRecord): LaneRecord;
+export declare function composeWorkerBrief(worker: ResolvedLaneWorker, taskBrief: string): string;
+export declare function parseMaxRuntimeSeconds(raw: unknown, workerId: string): number | undefined;
+export declare function emitLaneDecisionEvents(mesh: LanesMesh, lane: LaneRecord, decision: "blocked" | "done", extra?: Record<string, unknown>): Promise<void>;
+export declare const PICKUP_TERMINAL_REASONS: readonly ["account_not_logged_in", "unknown_account", "account_disabled"];
+export type PickupTerminalReason = (typeof PICKUP_TERMINAL_REASONS)[number];
+/**
+ * Outpost-side account bind (spec §5.2). Writes a named terminal reason,
+ * never a plain `failed`.
+ */
+export declare function applyOutpostAccountPickup(hqRoot: string, laneId: string): LaneRecord;
+export declare function cancelPendingQuestionsForLane(hqRoot: string, laneId: string, nowIso: string, operatorReason?: string): QuestionRecord[];
+export declare function registerLanesCommand(parent: Command, deps?: LanesCommandDeps): void;
+//# sourceMappingURL=lanes.d.ts.map