@indigoai-us/hq-cli 5.281.0 → 5.283.0

package/dist/commands/core.js

@@ -32,6 +32,8 @@ import { Option } from "commander";
 import { registerCoreCheckpointCommand } from "./core-checkpoint.js";
 import { registerCoreDelegateCommand } from "./core-delegate.js";
 import { registerCoreOntologyCommand } from "./core-ontology.js";
+import { registerCoreKnowledgePrefsCommand } from "./core-knowledge-prefs.js";
+import { registerCorePolicyCommand } from "./core-policy.js";
 import { registerCoreCheckpointGateSettingCommand } from "./core-checkpoint-gate-setting.js";
 import { resolveLiveRoot } from "../utils/hq-roots.js";
 import { interpreterFor, runBundledScript } from "../utils/run-bundled-script.js";
@@ -230,7 +232,16 @@ export const SCAFFOLD_ONLY_ASSETS = [
     { asset: "core/scripts/ontology-garden.mjs", root: "live", summary: "Rollback companion for native ontology garden" },
     { asset: "core/scripts/ontology-source-worklist.sh", root: "live", summary: "Rollback companion for native ontology source worklist" },
     { asset: "core/scripts/source-yaml-validate.sh", root: "cwd", summary: "Rollback companion for native source YAML validation" },
-    { asset: "core/scripts/knowledge-prefs.sh", root: "live", summary: "Sibling dependency for ontology candidate rollback companion" },
+    // Shared by native knowledge-prefs and the ontology candidate shell fallback.
+    { asset: "core/scripts/knowledge-prefs.sh", root: "live", summary: "Rollback companion for native knowledge-prefs and ontology candidate" },
+    // Rollback companions for the default-off native knowledge and policy routes.
+    // policy-retire also runs the scaffold validator in-process when native, but
+    // its bundled shell fallback needs both helper assets at these exact paths.
+    { asset: "core/scripts/policy-age-report.sh", root: "live", summary: "Rollback companion for native policy age-report" },
+    { asset: "core/scripts/policy-retire.sh", root: "live", summary: "Rollback companion for native policy retire" },
+    { asset: "core/scripts/read-policy-frontmatter.sh", root: "cwd", summary: "Rollback companion for native policy frontmatter" },
+    { asset: "core/scripts/eval-trigger.sh", root: "live", summary: "Trigger grammar helper used by the policy validator companion" },
+    { asset: ".claude/hooks/validate-policy-frontmatter.sh", root: "live", summary: "Policy validator companion used by policy-retire rollback" },
     ...NATIVE_UTILITY_COMMANDS.map(({ asset, root, summary }) => ({
         asset,
         root,
@@ -307,6 +318,8 @@ export function registerCoreCommands(program) {
     registerCoreOntologyCommand(core);
     registerCoreCheckpointGateSettingCommand(core);
     registerCoreDelegateCommand(core);
+    registerCoreKnowledgePrefsCommand(core);
+    registerCorePolicyCommand(core);
     // These command names intentionally own native implementations. Their
     // similarly named scaffold assets are forwarders, so sending them through
     // runEntry would recurse back into this command forever.

package/dist/commands/lanes-message.js

@@ -507,6 +507,7 @@ export function createLaneMessageHandlers(deps) {
                                             ...current,
                                             state: "queued",
                                             queued_reason: admission.reason ?? "throttle",
+                                            queued_details: undefined,
                                             queued_at: at,
                                             pending_resume: {
                                                 session_id: sessionId,

package/dist/commands/lanes-move.js

@@ -156,6 +156,7 @@ export function createLaneMoveHandlers(deps) {
                 host: target,
                 account,
                 queued_reason: undefined,
+                queued_details: undefined,
                 admission_reserved_at: undefined,
             }));
         }, ctx.sleep);
@@ -218,6 +219,7 @@ export function createLaneMoveHandlers(deps) {
                         host: before.host,
                         account: before.account,
                         queued_reason: before.queued_reason,
+                        queued_details: before.queued_details,
                         admission_reserved_at: before.admission_reserved_at,
                     }));
                     return true;

package/dist/commands/lanes-resume.js

@@ -317,6 +317,7 @@ export function createLaneResumeHandlers(deps) {
                                 ...current,
                                 state: "queued",
                                 queued_reason: admission.reason ?? "throttle",
+                                queued_details: undefined,
                                 queued_at: at,
                                 pending_resume: {
                                     session_id: sessionId,

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

@@ -1,6 +1,7 @@
 import type { LaneCompanyRef, LanePlacementPolicy, LaneRecord, LanesConfig, QuestionAnswer, QuestionBody, QuestionRecord, SeniorRef, AccountHistoryEntry, LaneAccountSelection, PendingResume, QueuedReason, ResolvedLaneWorker, LivenessDeps, MachineIdentity, MonitorEvidenceReader, ReconcileHost, RunCommand, ThrottleDeps, withLaneHireLocks } from "../lib/lanes/index.js";
 import type { OutpostIdentity } from "../lib/lanes/admission-host.js";
 import type { OutpostDispatchResult } from "../lib/lanes/outpost-dispatch.js";
+import type { CpuBusySource } from "../lib/lanes/throttle.js";
 import type { ProbeCommand } from "../lib/lanes/models.js";
 import type { KillProcessFn, ProveDetachedFn, SpawnProcessFn } from "../lib/lanes/spawn.js";
 import type { WatcherLoopDeps } from "../lib/lanes/watcher.js";
@@ -8,6 +9,7 @@ import type { RunCompactionFn } from "../lib/lanes/compaction.js";
 import type { LaneMesh, LaneMeshEvent } from "../lib/lanes/mesh-events.js";
 import type { BalanceHostGap, BalanceHostSnapshot } from "../lib/lanes/claude-balance.js";
 import type { HostCapacitySnapshot } from "../lib/lanes/host-capacity.js";
+import { LANE_OUTPOST_LOAD_BALANCING_FLAG } from "../lib/lanes/flag-keys.js";
 import { type ResolvedEffort } from "../lib/lanes/effort.js";
 import type { SessionCopyResult } from "../lib/lanes/move-account.js";
 import type { WorkerProfile } from "../lib/lanes/profile.js";
@@ -81,6 +83,11 @@ export interface AdmissionResult {
     action: "start" | "queue" | "refuse";
     reason?: QueuedReason;
     error?: LanesError;
+    throttle?: {
+        last_busy: number | null;
+        busy_source: CpuBusySource | undefined;
+        sampled_at: string | undefined;
+    };
 }
 export interface PrepareAccountMoveInput {
     account: string;
@@ -239,6 +246,8 @@ export interface Ctx {
     backfillOutpostIdentity: (expectedId: string) => "created" | "unchanged";
     fetchText: (url: string) => Promise<string>;
     lanePlacementEnabled: (company: LaneCompanyRef | undefined) => Promise<boolean>;
+    outpostSnapshotCacheEnabled: () => Promise<boolean>;
+    startOutpostLaneSnapshotRefresh: (hqRoot: string) => void;
     storyLedgerEnabled: () => boolean;
     isSsmOwnerDispatch: () => boolean;
     withGrantHireLocks: typeof withLaneHireLocks;
@@ -249,7 +258,7 @@ export interface OutpostRouteIdentity {
     outpostId: string;
     instanceName?: string;
 }
-export declare const LANE_OUTPOST_LOAD_BALANCING_FLAG = "lanes.outpost-load-balancing";
+export { LANE_OUTPOST_LOAD_BALANCING_FLAG };
 export declare const CLAUDE_ACCOUNT_BALANCE_SIGNALS_FLAG = "lanes.claude-account-balance-signals";
 export declare function defaultLanePlacementEnabled(company: LaneCompanyRef | undefined): Promise<boolean>;
 export declare function readLanePlacementEnabled(ctx: Ctx, company: LaneCompanyRef | undefined): Promise<boolean>;

package/dist/commands/lanes-shared.js

@@ -1,5 +1,6 @@
 import { resolveProcessFlagCompanyContext } from "../lib/flag-registry.js";
 import { readLanesRegistryFlag } from "../lib/lanes/registry-flag.js";
+import { LANE_OUTPOST_LOAD_BALANCING_FLAG } from "../lib/lanes/flag-keys.js";
 import { resolveLaneEffort } from "../lib/lanes/effort.js";
 import { LanesError } from "../lib/lanes/errors.js";
 import { AccountResolutionError, accountStatus, loadLanesConfig } from "../lib/lanes/index.js";
@@ -98,7 +99,7 @@ export function recordedResumeEffort(lane) {
         source: lane.effort_source ?? "none",
     };
 }
-export const LANE_OUTPOST_LOAD_BALANCING_FLAG = "lanes.outpost-load-balancing";
+export { LANE_OUTPOST_LOAD_BALANCING_FLAG };
 export const CLAUDE_ACCOUNT_BALANCE_SIGNALS_FLAG = "lanes.claude-account-balance-signals";
 function lanePlacementFlagErrorCode(error) {
     if (error && typeof error === "object") {

package/dist/commands/lanes.d.ts

@@ -14,6 +14,7 @@ import type { OutpostIdentity } from "../lib/lanes/admission-host.js";
 export { OUTPOST_DIR, OUTPOST_ID_PATH, readOutpostIdentity } from "../lib/lanes/admission-host.js";
 export type { OutpostIdentity } from "../lib/lanes/admission-host.js";
 import { type OutpostDispatchResult } from "../lib/lanes/outpost-dispatch.js";
+import { LANE_OUTPOST_SNAPSHOT_CACHE_FLAG } from "../lib/lanes/outpost-hire-cache.js";
 import { emitLaneDecisionEvents } from "../lib/lanes/mesh-events.js";
 import { MAX_LANE_DEPTH, withLaneHireLocks, type LaneCompanyRef, type QuestionBody, type LaneRecord, type QuestionRecord, type ResolvedLaneWorker, type SeniorRef, type LivenessDeps, type MachineIdentity, type MonitorEvidenceReader, type RunCommand, type ThrottleDeps } from "../lib/lanes/index.js";
 import { questionBodyAbsPath } from "../lib/lanes/questions.js";
@@ -87,6 +88,10 @@ export interface LanesCommandDeps {
     monitorEvidence?: MonitorEvidenceReader;
     /** Test seam for the default-off outpost placement rollout flag. */
     lanePlacementEnabled?: (company: LaneCompanyRef | undefined) => Promise<boolean>;
+    /** Test seam for the default-off shared Outpost snapshot cache. */
+    outpostSnapshotCacheEnabled?: () => Promise<boolean>;
+    /** Test seam for the detached refresh started by the cache-first lane list. */
+    startOutpostLaneSnapshotRefresh?: (hqRoot: string) => void;
     /** Test seam for the default-off story ledger flag. */
     storyLedgerEnabled?: () => boolean;
     /** Test seam for the SSM-only Outpost owner grant path. */
@@ -98,6 +103,7 @@ export interface LanesCommandDeps {
     /** Test seam for the repository-merge-hold registry flag. */
     mergeHoldEnabled?: (company: LaneCompanyRef) => boolean | Promise<boolean>;
 }
+export { LANE_OUTPOST_SNAPSHOT_CACHE_FLAG };
 export declare function parseSeniorRef(raw: string): SeniorRef;
 export declare function parseQuestionBody(raw: unknown): QuestionBody | null;
 /**
@@ -140,6 +146,8 @@ export declare function pickupFailureUpdater(reasonRaw: string, details: Record<
  */
 export declare function applyOutpostAccountPickup(hqRoot: string, laneId: string, modelDeps?: KnownModelsDeps): LaneRecord;
 export declare function cancelPendingQuestionsForLane(hqRoot: string, laneId: string, nowIso: string, operatorReason?: string): QuestionRecord[];
+/** Keeps the placement-enabled cache-first path on the full lane command graph. */
+export declare function runFastCachedLanesListFromEntrypoint(): Promise<void>;
 export declare function stopCommittedState(state: LaneRecord["state"]): "cancelled" | "killed";
 /** Stderr notice that `stop` ends a lane for good, naming the resumable path. */
 export declare function stopTerminalWarning(laneId: string): string;