@indigoai-us/hq-cli 5.149.1 → 5.151.0

package/dist/lib/lanes/spawn.js

@@ -844,6 +844,8 @@ export function markSpawnFailure(hqRoot, laneId, reasonRaw, details) {
             ...current,
             state: "failed",
             queued_reason: undefined,
+            queued_at: undefined,
+            admission_reserved_at: undefined,
             terminal_reason: reason,
             terminal_details: details,
         };
@@ -1360,6 +1362,8 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
             ...current,
             state: "running",
             queued_reason: undefined,
+            queued_at: undefined,
+            admission_reserved_at: undefined,
             // An account move's reservation ends with the claim.
             pending_resume: undefined,
             account: resolved.id,

package/dist/lib/lanes/store.js

@@ -13,7 +13,7 @@ import * as path from "node:path";
 import { generateUlid } from "../mesh/live/ulid.js";
 import { resolveLanesHqRoot } from "./hq-root.js";
 import { LaneNotFoundError, LaneSchemaError, LaneVersionConflict, LanesError, isLaneVersionConflict, } from "./errors.js";
-import { HISTORY_CAP, HOST_KINDS, LANE_STORY_STATUSES, LANE_SCHEMA_VERSION, QUESTION_SCHEMA_VERSION, SENIOR_KINDS, isHostKind, isLaneProvider, isLaneState, isQuestionStatus, isSeniorKind, parseMajorSchema, REQUIRED_LANE_RECORD_FIELDS, LANE_FIELD_WRITERS, LANE_WRITERS, } from "./types.js";
+import { HISTORY_CAP, HOST_KINDS, LANE_STORY_STATUSES, LANE_SCHEMA_VERSION, QUESTION_SCHEMA_VERSION, SENIOR_KINDS, isHostKind, isLaneProvider, isQueuedReason, isLaneState, isQuestionStatus, isSeniorKind, parseMajorSchema, REQUIRED_LANE_RECORD_FIELDS, LANE_FIELD_WRITERS, LANE_WRITERS, } from "./types.js";
 import { laneStories } from "./stories.js";
 export const LANES_STORE_REL = path.join("workspace", "lanes");
 export const LANE_RECORDS_DIR = "lanes";
@@ -245,6 +245,25 @@ function requireString(value, field) {
     }
     return value;
 }
+function requireTimestamp(value, field, filePath) {
+    const parsedAt = typeof value === "string" ? Date.parse(value) : NaN;
+    const datePart = typeof value === "string" ? value.slice(0, 10) : "";
+    const datePartAt = /^\d{4}-\d{2}-\d{2}$/.test(datePart)
+        ? Date.parse(`${datePart}T00:00:00.000Z`)
+        : NaN;
+    if (typeof value !== "string" ||
+        !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(value) ||
+        !Number.isFinite(parsedAt) ||
+        !Number.isFinite(datePartAt) ||
+        new Date(datePartAt).toISOString().slice(0, 10) !== datePart) {
+        throw new LaneSchemaError(`Expected ISO timestamp for ${field}`, {
+            path: filePath,
+            field,
+            value,
+        });
+    }
+    return value;
+}
 function requireInt(value, field) {
     if (typeof value !== "number" || !Number.isInteger(value)) {
         throw new LaneSchemaError(`Expected integer for ${field}`, { field });
@@ -371,6 +390,31 @@ export function parseLaneRecord(raw, filePath) {
     requireInt(raw.priority, "priority");
     requireString(raw.project_id, "project_id");
     requireString(raw.story_id, "story_id");
+    requireTimestamp(raw.created_at, "created_at", filePath);
+    requireTimestamp(raw.updated_at, "updated_at", filePath);
+    if (raw.queued_reason !== undefined && !isQueuedReason(raw.queued_reason)) {
+        throw new LaneSchemaError(`Unknown queued reason ${JSON.stringify(raw.queued_reason)}`, {
+            path: filePath,
+            field: "queued_reason",
+            value: raw.queued_reason,
+        });
+    }
+    if (raw.queued_at !== undefined)
+        requireTimestamp(raw.queued_at, "queued_at", filePath);
+    if (raw.admission_reserved_at !== undefined) {
+        requireTimestamp(raw.admission_reserved_at, "admission_reserved_at", filePath);
+    }
+    if (raw.admission_accounts !== undefined) {
+        if (!Array.isArray(raw.admission_accounts) ||
+            raw.admission_accounts.length === 0 ||
+            raw.admission_accounts.some((account) => typeof account !== "string" || account.trim() === "") ||
+            new Set(raw.admission_accounts).size !== raw.admission_accounts.length) {
+            throw new LaneSchemaError("admission_accounts must be a non-empty array of unique account ids", { path: filePath, field: "admission_accounts" });
+        }
+        if (typeof raw.account !== "string" || !raw.admission_accounts.includes(raw.account)) {
+            throw new LaneSchemaError("account must be present in admission_accounts", { path: filePath, field: "admission_accounts", account: raw.account });
+        }
+    }
     if (!isLaneState(raw.state)) {
         throw new LaneSchemaError(`Unknown lane state ${JSON.stringify(raw.state)}`, { path: filePath, value: raw.state });
     }
@@ -704,6 +748,9 @@ export function createLane(hqRoot, init, deps = defaultStoreDeps()) {
         version: 1,
         created_at: init.created_at ?? now,
         updated_at: init.updated_at ?? now,
+        ...(init.state === "queued"
+            ? { queued_at: init.queued_at ?? init.created_at ?? now }
+            : {}),
         senior_history: init.senior_history ?? [],
         attribution_history: init.attribution_history ?? [],
     };

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

@@ -166,8 +166,9 @@ export declare const TERMINAL_LANE_STATES: readonly ["done", "failed", "interrup
 export type TerminalLaneState = (typeof TERMINAL_LANE_STATES)[number];
 export declare const LANE_PROVIDERS: readonly ["claude", "codex", "grok"];
 export type LaneProvider = (typeof LANE_PROVIDERS)[number];
-export declare const QUEUED_REASONS: readonly ["cap", "queue_position", "throttle", "provider_binary_missing"];
+export declare const QUEUED_REASONS: readonly ["cap", "provider_cap", "account_cap", "profile_cap", "queue_position", "throttle", "provider_binary_missing"];
 export type QueuedReason = (typeof QUEUED_REASONS)[number];
+export declare function isQueuedReason(value: unknown): value is QueuedReason;
 export declare const HOST_KINDS: readonly ["local", "outpost"];
 export type HostKind = (typeof HOST_KINDS)[number];
 export declare const SENIOR_KINDS: readonly ["session", "lane", "user"];
@@ -270,6 +271,10 @@ export interface LaneRecord {
     senior_history: SeniorHistoryEntry[];
     state: LaneState;
     queued_reason?: QueuedReason;
+    /** Time the current queue turn began; old records fall back to created_at. */
+    queued_at?: string;
+    /** Short-lived slot reservation between create persistence and worker spawn. */
+    admission_reserved_at?: string;
     /**
      * Set by `hq lanes pickup` when it stores an outpost lane and cleared by
      * the account bind once the model probe has finished. While set, the
@@ -293,6 +298,8 @@ export interface LaneRecord {
     worker_profile_ignored?: string[];
     provider: LaneProvider;
     account?: string;
+    /** Eligible accounts for a queue entry created without an explicit account. */
+    admission_accounts?: string[];
     /**
      * Every operator move of the lane's session to another account of the
      * same provider (`hq lanes resume|message --account`), newest last, capped

package/dist/lib/lanes/types.js

@@ -95,7 +95,18 @@ export const TERMINAL_LANE_STATES = [
     "killed",
 ];
 export const LANE_PROVIDERS = ["claude", "codex", "grok"];
-export const QUEUED_REASONS = ["cap", "queue_position", "throttle", "provider_binary_missing"];
+export const QUEUED_REASONS = [
+    "cap",
+    "provider_cap",
+    "account_cap",
+    "profile_cap",
+    "queue_position",
+    "throttle",
+    "provider_binary_missing",
+];
+export function isQueuedReason(value) {
+    return typeof value === "string" && QUEUED_REASONS.includes(value);
+}
 export const HOST_KINDS = ["local", "outpost"];
 export const SENIOR_KINDS = ["session", "lane", "user"];
 export const ENVELOPE_DECISIONS = ["done", "ask", "blocked"];
@@ -204,16 +215,16 @@ export const LANE_FIELD_WRITERS = {
     schema_version: ["creator"], lane_id: ["creator"], company: ["creator"],
     project_id: ["command"], story_id: ["command"], stories: ["creator", "command", "watcher", "reconcile", "spawn"], thread_id: ["creator", "command", "spawn"], mesh_company: ["creator"],
     depth: ["command"], senior: ["command"], senior_history: ["command"],
-    state: ["creator", "command", "watcher", "reconcile", "spawn"], queued_reason: ["creator", "command", "spawn", "reconcile"],
+    state: ["creator", "command", "watcher", "reconcile", "spawn"], queued_reason: ["creator", "command", "spawn", "reconcile"], queued_at: ["creator", "command", "spawn"], admission_reserved_at: ["creator", "command", "reconcile", "spawn"],
     pickup_validation_pending: ["creator", "command", "spawn", "reconcile"],
     pickup_validation_pending_since: ["creator", "command", "spawn", "reconcile"],
     priority: ["command"], worker: ["creator"], worker_path: ["creator"], worker_pack: ["creator"], worker_profile: ["creator"], worker_profile_hash: ["creator", "spawn"], worker_profile_ignored: ["creator", "spawn"],
-    provider: ["creator"], account: ["creator", "spawn", "command"], account_history: ["command"], pending_resume: ["command", "spawn"], host: ["creator"], origin_host: ["creator"], origin_host_source: ["creator"],
+    provider: ["creator"], account: ["creator", "spawn", "command", "reconcile"], admission_accounts: ["creator", "command"], account_history: ["command"], pending_resume: ["command", "spawn"], host: ["creator"], origin_host: ["creator"], origin_host_source: ["creator"],
     version: ["creator"], created_at: ["creator"], updated_at: ["creator"], attribution_history: ["command"],
     last_envelope: ["watcher", "reconcile"], model: ["creator", "spawn", "command"], model_source: ["creator", "spawn", "command"], effort: ["creator", "spawn"], effort_source: ["creator", "spawn"], fast_mode: ["spawn"],
     last_message_at: ["command"], last_compaction: ["spawn"], story_complete: ["watcher", "reconcile"], story_complete_reason: ["watcher", "reconcile"], story_status: ["watcher", "reconcile"],
     overdue: ["reconcile"], overdue_at: ["reconcile"], last_host_report_at: ["watcher", "spawn", "reconcile"], stalled: ["watcher"], stalled_at: ["watcher"], stalled_reason: ["watcher"],
-    admitted_reason: ["reconcile"], terminal_reason: ["command", "watcher", "spawn", "reconcile"], terminal_details: ["command", "spawn", "watcher", "reconcile"],
+    admitted_reason: ["command", "reconcile"], terminal_reason: ["command", "watcher", "spawn", "reconcile"], terminal_details: ["command", "spawn", "watcher", "reconcile"],
     quota_reset_at: ["watcher", "reconcile"], model_quota_marker: ["watcher", "reconcile"], outpost_command_id: ["command"],
     provider_session_id: ["watcher", "command", "spawn"], provider_session_id_absent: ["watcher", "command"], provider_home_at_spawn: ["spawn"], last_resume: ["spawn"], last_run_usage: ["watcher"], envelope_repair: ["watcher", "reconcile"], last_progress_event_at: ["watcher"],
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.149.1",
+  "version": "5.151.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {