@indigoai-us/hq-cli 5.275.0 → 5.277.0

package/dist/command-catalog.generated.js

@@ -6755,6 +6755,97 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "delegate",
+                "description": "Delegation handover helpers",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] [command]",
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "resolve",
+                        "description": "Resolve a delegation recipient to a confirmed principal",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[args...]",
+                        "arguments": [
+                            {
+                                "name": "args",
+                                "required": false,
+                                "variadic": true
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "pickup",
+                        "description": "Record or check evidence that a recipient picked up a delegation",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[args...]",
+                        "arguments": [
+                            {
+                                "name": "args",
+                                "required": false,
+                                "variadic": true
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "repo",
+                        "description": "Prepare and record repository handover state",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[args...]",
+                        "arguments": [
+                            {
+                                "name": "args",
+                                "required": false,
+                                "variadic": true
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "secrets",
+                        "description": "Grant a recipient access to declared secret names",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[args...]",
+                        "arguments": [
+                            {
+                                "name": "args",
+                                "required": false,
+                                "variadic": true
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "transfer",
+                        "description": "Transfer local project ownership to a delegation recipient",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[args...]",
+                        "arguments": [
+                            {
+                                "name": "args",
+                                "required": false,
+                                "variadic": true
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    }
+                ]
+            },
             {
                 "name": "generate-workers-registry",
                 "description": "Regenerate the derived workers registry",
@@ -9627,6 +9718,39 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "set",
+                "description": "Change the model or effort a lane uses from its next resume",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--model <model>",
+                        "description": "Model for the lane's next and later turns"
+                    },
+                    {
+                        "flags": "--effort <level>",
+                        "description": "Effort for the lane's next and later turns"
+                    },
+                    {
+                        "flags": "--reason <text>",
+                        "description": "Why the settings changed; recorded in settings_history"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "Emit JSON on stdout (default)"
+                    }
+                ],
+                "subcommands": []
+            },
             {
                 "name": "grant",
                 "description": "Set a lane's alive child-lane grant as its senior",
@@ -9707,6 +9831,14 @@ export const COMMAND_CATALOG = [
                         "flags": "--senior <ref>",
                         "description": "Filter by senior ref"
                     },
+                    {
+                        "flags": "--lane <id>",
+                        "description": "Filter by lane id (repeatable)"
+                    },
+                    {
+                        "flags": "--active",
+                        "description": "Include only lanes that are not terminal"
+                    },
                     {
                         "flags": "--json",
                         "description": "Emit JSON on stdout (default)"
@@ -10428,7 +10560,7 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "stop",
-                "description": "Cancel a queued lane or kill a running one",
+                "description": "Cancel a queued lane or kill a running one (terminal; use interrupt to keep it resumable)",
                 "aliases": [],
                 "hidden": false,
                 "usage": "[options] <lane-id>",
@@ -10451,6 +10583,31 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "interrupt",
+                "description": "Stop a running lane's turn and keep it resumable with hq lanes resume",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--reason <text>",
+                        "description": "Record the reason in the lane's stop history"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
+                    }
+                ],
+                "subcommands": []
+            },
             {
                 "name": "approve",
                 "description": "Record senior approval for a registry worker checkpoint",
@@ -11291,6 +11448,150 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "sync",
+                "description": "Inspect and control the daemon's company sync runner",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] [command]",
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "status",
+                        "description": "Show sync ownership, heartbeat, last pass and log path",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Print machine-readable JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "now",
+                        "description": "Start a fresh sync pass immediately",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Print machine-readable JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "pause",
+                        "description": "Pause daemon sync until resumed",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Print machine-readable JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "resume",
+                        "description": "Resume daemon sync after a pause",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Print machine-readable JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "take-ownership",
+                        "description": "Persist daemon ownership of desktop sync and reconcile",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Print machine-readable JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "mode",
+                        "description": "Read or change a company's sync footprint",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] [command]",
+                        "arguments": [],
+                        "options": [],
+                        "subcommands": [
+                            {
+                                "name": "get",
+                                "description": "Read a company's current all/shared sync mode",
+                                "aliases": [],
+                                "hidden": false,
+                                "usage": "[options] <company>",
+                                "arguments": [
+                                    {
+                                        "name": "company",
+                                        "required": true,
+                                        "variadic": false
+                                    }
+                                ],
+                                "options": [
+                                    {
+                                        "flags": "--json",
+                                        "description": "Print machine-readable JSON"
+                                    }
+                                ],
+                                "subcommands": []
+                            },
+                            {
+                                "name": "set",
+                                "description": "Set a company's sync mode to all or shared",
+                                "aliases": [],
+                                "hidden": false,
+                                "usage": "[options] <company> <mode>",
+                                "arguments": [
+                                    {
+                                        "name": "company",
+                                        "required": true,
+                                        "variadic": false
+                                    },
+                                    {
+                                        "name": "mode",
+                                        "required": true,
+                                        "variadic": false
+                                    }
+                                ],
+                                "options": [
+                                    {
+                                        "flags": "--json",
+                                        "description": "Print machine-readable JSON"
+                                    }
+                                ],
+                                "subcommands": []
+                            }
+                        ]
+                    }
+                ]
+            },
             {
                 "name": "logs",
                 "description": "Print the supervisor log, or one service's log",

package/dist/commands/core-checkpoint.d.ts

@@ -45,8 +45,10 @@ export declare const SIBLING_PROMPT_TEMPLATE = "You are the HQ checkpoint siblin
  * Rendered into the sibling prompt only when the payload names a company. The
  * flag check happens inside `hq core ontology plan`, in the sibling, because
  * the checkpoint parent performs no network I/O. Only this run's own payload
- * gets the step; claimed queue payloads are covered by the next run, since the
- * plan works from file hashes rather than from the payload's file list.
+ * gets the step. A queued payload's company files are recorded as queued
+ * touches when it is queued (CO-59), and a later plan for that company takes
+ * them while checkpoint.ontology.queued-touches is on; a run with no company
+ * of its own gets the step for the company whose touches waited longest.
  */
 export declare const SIBLING_ONTOLOGY_STEP = "5b. ONTOLOGY (this run's own payload only; skip it for claimed queue payloads).\n   Run: hq core ontology plan --run-dir \"<runDir>\" --hq-root \"<hqRoot>\"\n   If it prints \"ontology: skipped\", do nothing more for this step. Otherwise\n   read <runDir>/ontology-plan.json, follow its \"instructions\" exactly, and\n   write <runDir>/ontology-candidates.json. Read only the files and line\n   ranges the plan lists. Then run:\n   hq core ontology apply --run-dir \"<runDir>\" --hq-root \"<hqRoot>\"\n   Never write under the company's ontology/ folder yourself, and never edit\n   payload.json or ontology-plan.json. Copy the command's one-line output into\n   the report. If either command fails, record the error and continue.\n";
 export declare function renderSiblingPrompt(runDir: string, payloadPath: string, options?: {

package/dist/commands/core-checkpoint.js

@@ -17,6 +17,7 @@ import { toHqStateWriteError } from "../utils/hq-state-write-error.js";
 import { checkpointStampWriteErrorFor, isCheckpointStampWriteError, } from "../utils/checkpoint-stamp-write-error.js";
 import { readBackendPreference } from "../lib/checkpoint-ontology/plan.js";
 import { resolveOntologyCompany } from "../lib/checkpoint-ontology/company.js";
+import { markBorrowed, oldestQueuedCompany, recordQueuedTouches } from "../lib/checkpoint-ontology/queued-touches.js";
 import { describeCoreCommand } from "./core-command-catalog.js";
 const DEFAULT_TRIGGER = "stop-gate";
 const BACKENDS = new Set(["auto", "claude", "codex", "grok", "none"]);
@@ -189,8 +190,10 @@ report instead of guessing.
  * Rendered into the sibling prompt only when the payload names a company. The
  * flag check happens inside `hq core ontology plan`, in the sibling, because
  * the checkpoint parent performs no network I/O. Only this run's own payload
- * gets the step; claimed queue payloads are covered by the next run, since the
- * plan works from file hashes rather than from the payload's file list.
+ * gets the step. A queued payload's company files are recorded as queued
+ * touches when it is queued (CO-59), and a later plan for that company takes
+ * them while checkpoint.ontology.queued-touches is on; a run with no company
+ * of its own gets the step for the company whose touches waited longest.
  */
 export const SIBLING_ONTOLOGY_STEP = `5b. ONTOLOGY (this run's own payload only; skip it for claimed queue payloads).
    Run: hq core ontology plan --run-dir "<runDir>" --hq-root "<hqRoot>"
@@ -1001,15 +1004,43 @@ function startSibling(liveRoot, input, threadPath, backend) {
     fs.mkdirSync(siblingRoot, { recursive: true });
     if (activePid !== null) {
         const depth = appendPending(pendingPath, payload);
+        try {
+            recordQueuedTouches(liveRoot, payload.company, payload.files, new Date());
+        }
+        catch {
+            // Queued touches only help a later ontology plan; they must never fail
+            // the checkpoint itself.
+        }
         printResult(`checkpoint: sibling busy — payload queued (${depth} pending)`);
         return;
     }
     const runDir = path.join(siblingRoot, `${formatTimestamp(new Date())}-${summarySlug(input.summary ?? "checkpoint")}`);
     fs.mkdirSync(runDir, { recursive: true });
     payload.pending_payloads = claimPending(pendingPath, path.join(runDir, "pending-claimed.jsonl"));
+    if (!payload.company) {
+        let queued;
+        try {
+            queued = oldestQueuedCompany(liveRoot);
+        }
+        catch {
+            queued = null;
+        }
+        if (queued) {
+            payload.ontology_company = queued;
+            try {
+                markBorrowed(liveRoot, queued, new Date());
+            }
+            catch {
+                // A borrowed-company marker must never fail the checkpoint.
+            }
+        }
+    }
     const payloadPath = path.join(runDir, "payload.json");
     fs.writeFileSync(payloadPath, `${JSON.stringify(payload, null, 2)}\n`);
-    const prompt = renderSiblingPrompt(runDir, payloadPath, { company: payload.company, hqRoot: liveRoot });
+    const prompt = renderSiblingPrompt(runDir, payloadPath, {
+        company: payload.company ?? payload.ontology_company ?? null,
+        hqRoot: liveRoot,
+    });
     fs.writeFileSync(path.join(runDir, "prompt.md"), prompt);
     const logPath = path.join(runDir, "run.log");
     const logFd = fs.openSync(logPath, "a");

package/dist/commands/core-command-catalog.d.ts

@@ -22,11 +22,13 @@ export declare function describeCoreCommand(command: Command, metadata: CoreComm
 export declare function registeredCoreCommandListing(core: Command): CoreCommandListingEntry[];
 export declare function fastScaffoldListingMismatches(listing: readonly CoreCommandListingEntry[], fastScripts: readonly {
     name: string;
-    asset: string;
+    kind: "shell" | "native";
+    asset?: string;
 }[]): string[];
 export declare function assertFastScaffoldListingParity(listing: readonly CoreCommandListingEntry[], fastScripts: readonly {
     name: string;
-    asset: string;
+    kind: "shell" | "native";
+    asset?: string;
 }[]): void;
 export {};
 //# sourceMappingURL=core-command-catalog.d.ts.map

package/dist/commands/core-command-catalog.js

@@ -43,8 +43,11 @@ export function fastScaffoldListingMismatches(listing, fastScripts) {
         if (!listed) {
             mismatches.push(`${fast.name} is missing from hq core commands`);
         }
-        else if (listed.asset !== fast.asset) {
-            mismatches.push(`${fast.name} lists ${listed.asset ?? "no asset"}, fast path uses ${fast.asset}`);
+        else if (fast.kind === "shell" && listed.asset !== fast.asset) {
+            mismatches.push(`${fast.name} lists ${listed.asset ?? "no asset"}, fast path uses ${fast.asset ?? "no asset"}`);
+        }
+        else if (fast.kind === "native" && (listed.execution !== "native" || listed.asset)) {
+            mismatches.push(`${fast.name} is native in the fast path but not in the command catalog`);
         }
     }
     return mismatches;

package/dist/commands/core-delegate.d.ts

@@ -0,0 +1,6 @@
+/** Native implementations of the five `hq core delegate` shell companions. */
+import { Command } from "commander";
+export declare const CORE_NATIVE_DELEGATE_FLAG = "core-native-delegate";
+/** Register the Wave 1a delegate commands and preserve the shell rollback path. */
+export declare function registerCoreDelegateCommand(core: Command): void;
+//# sourceMappingURL=core-delegate.d.ts.map