@indigoai-us/hq-cli 5.273.0-alpha.0 → 5.274.0

package/dist/command-registration-plan.d.ts

@@ -432,6 +432,18 @@ export declare const REGISTRATION_PLAN: readonly [{
     readonly parent: "program";
     readonly module: "./commands/report.js";
     readonly exportName: "registerReportCommand";
+}, {
+    readonly type: "group";
+    readonly root: "deploy";
+    readonly id: "deploy";
+    readonly name: "deploy";
+    readonly description: "Manage deployments in hq-deploy";
+}, {
+    readonly type: "registrar";
+    readonly root: "deploy";
+    readonly parent: "deploy";
+    readonly module: "./commands/deploy-comments.js";
+    readonly exportName: "registerDeployCommentsCommand";
 }, {
     readonly type: "group";
     readonly root: "staff";

package/dist/command-registration-plan.js

@@ -74,6 +74,8 @@ export const REGISTRATION_PLAN = [
     { type: "registrar", root: "daemon", parent: "program", module: "./commands/daemon.js", exportName: "registerDaemonCommand", hidden: true },
     { type: "registrar", root: "bot", parent: "program", module: "./commands/bot.js", exportName: "registerBotCommand" },
     { type: "registrar", root: "report", parent: "program", module: "./commands/report.js", exportName: "registerReportCommand" },
+    { type: "group", root: "deploy", id: "deploy", name: "deploy", description: "Manage deployments in hq-deploy" },
+    { type: "registrar", root: "deploy", parent: "deploy", module: "./commands/deploy-comments.js", exportName: "registerDeployCommentsCommand" },
     // onboarding-test-accounts US-007 — super-admin staff CLI wrappers over the
     // hq-pro admin surface. New wrappers land under this group; the reset
     // command mirrors POST /v1/admin/test-account/reset.

package/dist/commands/cloud.js

@@ -21,6 +21,7 @@ import { DEFAULT_HQ_ROOT, ensureCognitoToken, buildVaultConfig, } from "../utils
 import { resolveUploadAuthor } from "../utils/upload-author.js";
 import { companyFolderExceedsThreshold, emitNarrowHint, isStrictRefusal, resolveBannerLevel, resolveNarrowHintPresentationLevel, resolveNarrowHintMinBytes, } from "../lib/narrow-hint-banner.js";
 import { beginSyncHealthReport, } from "../utils/client-health.js";
+import { recordFirstWorkBearingSync } from "../lib/first-sync-next-step.js";
 /**
  * Terminal-failure signal for the sync fanout runners. The runners
  * (`runPushAll` / `runPullAll` / `runPullPersonal` / `runNowSingle` /
@@ -882,6 +883,11 @@ export function registerCloudCommands(program) {
                 await syncHealth.failed();
                 process.exit(1);
             }
+            recordFirstWorkBearingSync({
+                filesUploaded: result.filesUploaded,
+                filesDeleted: result.filesDeleted,
+                aborted: result.aborted,
+            });
             if (result.filesExcludedByScope > 0) {
                 log(chalk.yellow(`\n⚠ Pushed ${result.filesUploaded} file(s) (${formatBytes(result.bytesUploaded)}, ` +
                     `${result.filesSkipped} skipped, ${result.filesExcludedByScope} scope-excluded)`));
@@ -1026,6 +1032,10 @@ export function registerCloudCommands(program) {
                 await syncHealth.failed();
                 process.exit(1);
             }
+            recordFirstWorkBearingSync({
+                filesDownloaded: result.filesDownloaded,
+                aborted: result.aborted,
+            });
             console.log(chalk.green(`\n✓ Pulled ${result.filesDownloaded} file(s) (${formatBytes(result.bytesDownloaded)}, ${result.filesSkipped} skipped, ${result.conflicts} conflicts)`));
             // Emit the hint banner after success so it appears alongside the
             // summary line. Mirrors the wiring in runPullAll and runNowSingle.
@@ -1325,6 +1335,14 @@ async function runPullAll(hqRoot, onConflict, modeAllOverride, skipPersonal, for
         `(${formatBytes(result.bytesDownloaded)}) across ${result.attempted} ` +
         `target(s); ${result.conflicts} conflict(s); ${errored} error(s)`;
     console.log(errored > 0 ? chalk.yellow(summary) : chalk.green(summary));
+    for (const row of result.perCompany) {
+        if (row.result && !row.error) {
+            recordFirstWorkBearingSync({
+                filesDownloaded: row.result.filesDownloaded,
+                aborted: row.result.aborted,
+            });
+        }
+    }
     if (errored > 0)
         throw new SyncExitError(1);
 }
@@ -1355,6 +1373,10 @@ export async function runPullPersonal(hqRoot, onConflict) {
             throw new SyncExitError(1);
         }
         console.log(chalk.green(`\n✓ Pulled ${result.filesDownloaded} file(s) (${formatBytes(result.bytesDownloaded)}, ${result.filesSkipped} skipped, ${result.conflicts} conflicts)`));
+        recordFirstWorkBearingSync({
+            filesDownloaded: result.filesDownloaded,
+            aborted: result.aborted,
+        });
     }
     catch (err) {
         if (err instanceof SyncExitError)
@@ -1454,6 +1476,15 @@ async function runPushAll(hqRoot, message, onConflict, skipPersonal) {
     console.log(errored > 0 || result.filesExcludedByScope > 0
         ? chalk.yellow(summary)
         : chalk.green(summary));
+    for (const row of result.perCompany) {
+        if (row.result && !row.error) {
+            recordFirstWorkBearingSync({
+                filesUploaded: row.result.filesUploaded,
+                filesDeleted: row.result.filesDeleted,
+                aborted: row.result.aborted,
+            });
+        }
+    }
     for (const row of result.perCompany) {
         const excluded = row.result?.filesExcludedByScope ?? 0;
         for (const line of scopeExcludedLines(excluded, row.prefixSet)) {
@@ -1544,6 +1575,11 @@ async function runNowSingle(hqRoot, company, personal, message, onConflict, mode
             console.log(chalk.yellow("\n⚠ Sync now aborted on push leg; pull skipped."));
             throw new SyncExitError(1);
         }
+        recordFirstWorkBearingSync({
+            filesUploaded: pushResult.filesUploaded,
+            filesDeleted: pushResult.filesDeleted,
+            aborted: pushResult.aborted,
+        });
         // US-011: resolve membership sync-config so we can either nudge an
         // all-mode owner or refuse the pull when strict-mode is on. Skipped
         // for personal targets (personal vault has no membership row) and
@@ -1635,6 +1671,10 @@ async function runNowSingle(hqRoot, company, personal, message, onConflict, mode
             console.log(chalk.yellow("\n⚠ Sync now finished with pull leg aborted."));
             throw new SyncExitError(1);
         }
+        recordFirstWorkBearingSync({
+            filesDownloaded: pullResult.filesDownloaded,
+            aborted: pullResult.aborted,
+        });
         // Emit the hint banner after a successful pull so it appears at the
         // bottom of the summary rather than mid-stream. Size-gated: only a large
         // local folder is nudged.

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 { describeCoreCommand } from "./core-command-catalog.js";
 const DEFAULT_TRIGGER = "stop-gate";
 const BACKENDS = new Set(["auto", "claude", "codex", "grok", "none"]);
 // Pinned by operator directive 2026-09-15; change defaults here deliberately.
@@ -1175,7 +1176,7 @@ function reportUsage(error) {
 }
 /** Attach the native checkpoint command to the hidden `hq core` group. */
 export function registerCoreCheckpointCommand(core) {
-    core
+    const checkpoint = core
         .command("checkpoint")
         .description("Record an end-of-turn checkpoint and start HQ maintenance")
         .option("--summary <text>", "1–2 sentence outcome summary")
@@ -1211,5 +1212,6 @@ export function registerCoreCheckpointCommand(core) {
             throw error;
         }
     });
+    describeCoreCommand(checkpoint, { execution: "native", root: "live" });
 }
 //# sourceMappingURL=core-checkpoint.js.map

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

@@ -0,0 +1,32 @@
+import type { Command } from "commander";
+export type CoreCommandExecution = "native" | "bundled-shell" | "bundled-node";
+export type CoreCommandRoot = "live" | "source" | "cwd";
+export type CoreCommandListingEntry = {
+    name: string;
+    execution: CoreCommandExecution;
+    asset?: string;
+    root: CoreCommandRoot;
+};
+type CoreCommandMetadata = (Omit<CoreCommandListingEntry, "name"> & {
+    entries?: never;
+}) | {
+    entries: readonly CoreCommandListingEntry[];
+};
+/** Mark the exact Commander registration that supplies a catalog row. */
+export declare function describeCoreCommand(command: Command, metadata: CoreCommandMetadata): Command;
+/**
+ * Reflect executable leaf commands from the Commander tree. Asset-backed rows
+ * are attached at the point where core.ts registers each table entry, so the
+ * JSON output cannot drift into a second, hand-maintained command list.
+ */
+export declare function registeredCoreCommandListing(core: Command): CoreCommandListingEntry[];
+export declare function fastScaffoldListingMismatches(listing: readonly CoreCommandListingEntry[], fastScripts: readonly {
+    name: string;
+    asset: string;
+}[]): string[];
+export declare function assertFastScaffoldListingParity(listing: readonly CoreCommandListingEntry[], fastScripts: readonly {
+    name: string;
+    asset: string;
+}[]): void;
+export {};
+//# sourceMappingURL=core-command-catalog.d.ts.map

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

@@ -0,0 +1,58 @@
+const metadataByCommand = new WeakMap();
+/** Mark the exact Commander registration that supplies a catalog row. */
+export function describeCoreCommand(command, metadata) {
+    metadataByCommand.set(command, metadata);
+    return command;
+}
+/**
+ * Reflect executable leaf commands from the Commander tree. Asset-backed rows
+ * are attached at the point where core.ts registers each table entry, so the
+ * JSON output cannot drift into a second, hand-maintained command list.
+ */
+export function registeredCoreCommandListing(core) {
+    const entries = [];
+    const visit = (parent, parents) => {
+        for (const command of parent.commands) {
+            const path = [...parents, command.name()].join(" ");
+            if (command.commands.length > 0) {
+                visit(command, [...parents, command.name()]);
+                continue;
+            }
+            const metadata = metadataByCommand.get(command);
+            if (!metadata) {
+                throw new Error(`hq core command ${path} has no listing metadata`);
+            }
+            const described = metadata.entries
+                ? metadata.entries
+                : [{
+                        name: path,
+                        execution: metadata.execution,
+                        ...(metadata.asset ? { asset: metadata.asset } : {}),
+                        root: metadata.root,
+                    }];
+            entries.push(...described);
+        }
+    };
+    visit(core, []);
+    return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+export function fastScaffoldListingMismatches(listing, fastScripts) {
+    const mismatches = [];
+    for (const fast of fastScripts) {
+        const listed = listing.find((entry) => entry.name === fast.name);
+        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}`);
+        }
+    }
+    return mismatches;
+}
+export function assertFastScaffoldListingParity(listing, fastScripts) {
+    const mismatches = fastScaffoldListingMismatches(listing, fastScripts);
+    if (mismatches.length > 0) {
+        throw new Error(mismatches.join("\n"));
+    }
+}
+//# sourceMappingURL=core-command-catalog.js.map

package/dist/commands/core-ontology.js

@@ -10,6 +10,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { resolveLiveRoot } from "../utils/hq-roots.js";
+import { describeCoreCommand } from "./core-command-catalog.js";
 import { readLanesRegistryFlag } from "../lib/lanes/registry-flag.js";
 import { MULTI_WRITER_FLAG, planOntologyRun, } from "../lib/checkpoint-ontology/plan.js";
 import { applyOntologyRun, ApplyError } from "../lib/checkpoint-ontology/apply.js";
@@ -205,7 +206,7 @@ export function registerCoreOntologyCommand(core) {
         .command("ontology")
         .description("Checkpoint ontology steps run by the checkpoint sibling (gated by checkpoint.ontology)");
     const rootFor = (options) => resolveLiveRoot({ hqRoot: options.hqRoot ?? core.opts().hqRoot });
-    ontology
+    const plan = ontology
         .command("plan")
         .description("Check the flag and list the changed company files for this checkpoint run")
         .option("--run-dir <path>", "checkpoint sibling run directory holding payload.json")
@@ -218,7 +219,8 @@ export function registerCoreOntologyCommand(core) {
             fail(error);
         }
     });
-    ontology
+    describeCoreCommand(plan, { execution: "native", root: "live" });
+    const duplicates = ontology
         .command("duplicates")
         .description("List same-type entities whose names collide, with a proposed survivor (read-only)")
         .requiredOption("--company <slug>", "company to scan")
@@ -232,7 +234,8 @@ export function registerCoreOntologyCommand(core) {
             fail(error);
         }
     });
-    ontology
+    describeCoreCommand(duplicates, { execution: "native", root: "live" });
+    const mergeCopies = ontology
         .command("merge-copies")
         .description("Merge '<name> N.md' entity copies into their original, then delete them from the vault (dry run by default)")
         .requiredOption("--company <slug>", "company to change")
@@ -249,7 +252,8 @@ export function registerCoreOntologyCommand(core) {
             fail(error);
         }
     });
-    ontology
+    describeCoreCommand(mergeCopies, { execution: "native", root: "live" });
+    const apply = ontology
         .command("apply")
         .description("Validate the run's entity candidates and write them to the payload company")
         .option("--run-dir <path>", "checkpoint sibling run directory holding the plan and candidates")
@@ -262,5 +266,6 @@ export function registerCoreOntologyCommand(core) {
             fail(error);
         }
     });
+    describeCoreCommand(apply, { execution: "native", root: "live" });
 }
 //# sourceMappingURL=core-ontology.js.map

package/dist/commands/core.d.ts

@@ -68,6 +68,8 @@ export type ScaffoldCommand = ScaffoldAsset & {
 export type RebuildIndexTarget = {
     /** Rebuild target — `hq core rebuild-index <target>`. */
     target: string;
+    /** Legacy scaffold companion, retained for compatibility and packaging. */
+    asset: string;
     /** Native renderer identifier. */
     renderer: IndexTarget;
     /** One-line summary, shown in `hq core --help`. */
@@ -87,6 +89,8 @@ export type NativeScaffoldCommand = ScaffoldAsset & {
 };
 type NativeUtilityCommand = {
     name: string;
+    /** Retained loose-file companion for old scaffold callers. */
+    asset: string;
     root: ScaffoldRoot;
     summary: string;
     run: (args: string[], context: {

package/dist/commands/core.js

@@ -32,7 +32,7 @@ import { Option } from "commander";
 import { registerCoreCheckpointCommand } from "./core-checkpoint.js";
 import { registerCoreOntologyCommand } from "./core-ontology.js";
 import { resolveLiveRoot } from "../utils/hq-roots.js";
-import { runBundledScript } from "../utils/run-bundled-script.js";
+import { interpreterFor, runBundledScript } from "../utils/run-bundled-script.js";
 import { renderIndexTarget } from "../lib/index-render/index.js";
 import { generateWorkersRegistry } from "../lib/workers-registry/index.js";
 import { scanPackages } from "../lib/scan-packages/index.js";
@@ -48,21 +48,22 @@ import { qmdReindexAfterSync } from "../lib/core-utils/qmd-reindex-after-sync.js
 import { softTimeoutCommand } from "../lib/core-utils/soft-timeout.js";
 import { timeoutGuardCommand } from "../lib/core-utils/timeout-guard.js";
 import { readSentryReportStdin, reportSentryEvent } from "../lib/core-utils/sentry-report.js";
+import { describeCoreCommand, registeredCoreCommandListing, } from "./core-command-catalog.js";
 /**
  * These commands are now native implementations. Their retained shell assets
  * are deliberately claimed in SCAFFOLD_ONLY_ASSETS: loose HQ trees still ship
  * them for legacy callers, but `hq core` never dispatches through them again.
  */
 export const NATIVE_UTILITY_COMMANDS = [
-    { name: "detect-stale-core-policy-mirror", root: "live", summary: "Find (and prune) stale personal-policy mirrors in core", run: (args, context) => detectStaleCorePolicyMirror(args, { root: context.hqRoot }) },
-    { name: "hq-status-summary", root: "cwd", summary: "Summarize working-tree status across the HQ tree", run: (args, context) => summarizeHqStatus(args, { cwd: context.cwd, root: context.hqRoot }) },
-    { name: "ontology-readme-drift", root: "live", summary: "Check a company's ontology README for drift", run: (args, context) => ontologyReadmeDrift(args, { root: context.hqRoot }) },
-    { name: "resize-screenshot", root: "cwd", summary: "Downscale a screenshot for context efficiency", run: (args) => resizeScreenshot(args) },
-    { name: "token-usage-report", root: "cwd", summary: "Report session token usage", run: (args) => tokenUsageReport(args) },
-    { name: "worktree", root: "live", summary: "Create a git worktree under workspace/worktrees/", run: (args, context) => createWorktree(args, { cwd: context.cwd, hqRoot: context.hqRoot }) },
-    { name: "codex-skill-bridge", root: "live", summary: "Install/inspect the Codex skill bridge", run: (args, context) => runCodexSkillBridgeCommand(args, { root: context.hqRoot ?? context.cwd }) },
-    { name: "archive-old-threads", root: "live", summary: "Archive aged session-thread files", run: (args, context) => archiveOldThreads(args, { hqRoot: context.hqRoot ?? context.cwd }) },
-    { name: "qmd-reindex-after-sync", root: "cwd", summary: "Refresh qmd collections after a sync", run: (args, context) => qmdReindexAfterSync(args, { cwd: context.cwd }) },
+    { name: "detect-stale-core-policy-mirror", asset: "core/scripts/detect-stale-core-policy-mirror.sh", root: "live", summary: "Find (and prune) stale personal-policy mirrors in core", run: (args, context) => detectStaleCorePolicyMirror(args, { root: context.hqRoot }) },
+    { name: "hq-status-summary", asset: "core/scripts/hq-status-summary.sh", root: "cwd", summary: "Summarize working-tree status across the HQ tree", run: (args, context) => summarizeHqStatus(args, { cwd: context.cwd, root: context.hqRoot }) },
+    { name: "ontology-readme-drift", asset: "core/scripts/ontology-readme-drift.sh", root: "live", summary: "Check a company's ontology README for drift", run: (args, context) => ontologyReadmeDrift(args, { root: context.hqRoot }) },
+    { name: "resize-screenshot", asset: "core/scripts/resize-screenshot.sh", root: "cwd", summary: "Downscale a screenshot for context efficiency", run: (args) => resizeScreenshot(args) },
+    { name: "token-usage-report", asset: "core/scripts/token-usage-report.sh", root: "cwd", summary: "Report session token usage", run: (args) => tokenUsageReport(args) },
+    { name: "worktree", asset: "core/scripts/worktree.sh", root: "live", summary: "Create a git worktree under workspace/worktrees/", run: (args, context) => createWorktree(args, { cwd: context.cwd, hqRoot: context.hqRoot }) },
+    { name: "codex-skill-bridge", asset: "core/scripts/codex-skill-bridge.sh", root: "live", summary: "Install/inspect the Codex skill bridge", run: (args, context) => runCodexSkillBridgeCommand(args, { root: context.hqRoot ?? context.cwd }) },
+    { name: "archive-old-threads", asset: "core/scripts/archive-old-threads.sh", root: "live", summary: "Archive aged session-thread files", run: (args, context) => archiveOldThreads(args, { hqRoot: context.hqRoot ?? context.cwd }) },
+    { name: "qmd-reindex-after-sync", asset: "core/scripts/qmd-reindex-after-sync.sh", root: "cwd", summary: "Refresh qmd collections after a sync", run: (args, context) => qmdReindexAfterSync(args, { cwd: context.cwd }) },
 ];
 export const NATIVE_SCAFFOLD_COMMANDS = [
     {
@@ -110,51 +111,61 @@ export const WORKER_SUBCOMMANDS = [
 export const REBUILD_INDEX_TARGETS = [
     {
         target: "all",
+        asset: "core/scripts/rebuild-all-indexes.sh",
         renderer: "all",
         summary: "Regenerate every INDEX.md across the HQ tree",
     },
     {
         target: "companies",
+        asset: "core/scripts/rebuild-companies-index.sh",
         renderer: "companies",
         summary: "Regenerate companies/INDEX.md",
     },
     {
         target: "company-knowledge",
+        asset: "core/scripts/rebuild-company-knowledge-index.sh",
         renderer: "company-knowledge",
         summary: "Regenerate a company's knowledge INDEX.md",
     },
     {
         target: "orchestrator",
+        asset: "core/scripts/rebuild-orchestrator-index.sh",
         renderer: "orchestrator",
         summary: "Regenerate the orchestrator workspace INDEX.md",
     },
     {
         target: "projects",
+        asset: "core/scripts/rebuild-projects-index.sh",
         renderer: "projects",
         summary: "Regenerate the projects INDEX.md",
     },
     {
         target: "public-knowledge",
+        asset: "core/scripts/rebuild-public-knowledge-index.sh",
         renderer: "public-knowledge",
         summary: "Regenerate core/knowledge/public/INDEX.md",
     },
     {
         target: "reports",
+        asset: "core/scripts/rebuild-reports-index.sh",
         renderer: "reports",
         summary: "Regenerate the reports INDEX.md",
     },
     {
         target: "social-drafts",
+        asset: "core/scripts/rebuild-social-drafts-index.sh",
         renderer: "social-drafts",
         summary: "Regenerate workspace/social-drafts/INDEX.md",
     },
     {
         target: "threads",
+        asset: "core/scripts/rebuild-threads-index.sh",
         renderer: "threads",
         summary: "Regenerate the session-threads INDEX.md",
     },
     {
         target: "workers",
+        asset: "core/scripts/rebuild-workers-index.sh",
         renderer: "workers",
         summary: "Regenerate the workers INDEX.md",
     },
@@ -201,65 +212,16 @@ export const SCAFFOLD_ONLY_ASSETS = [
     { asset: "core/scripts/lib/session-scope-capability.sh", root: "live", summary: "Session scope-capability lib sourced by hq-session" },
     { asset: "core/scripts/lib/session-id.sh", root: "live", summary: "Session-id resolver lib sourced by hq-session" },
     { asset: "core/scripts/lib/work-mesh-enqueue.sh", root: "live", summary: "Work Mesh Live spool enqueue lib sourced by hooks" },
-    { asset: "core/scripts/archive-old-threads.sh", root: "live", summary: "Scaffold-only native utility companion" },
-    { asset: "core/scripts/codex-skill-bridge.sh", root: "live", summary: "Scaffold-only native utility companion" },
-    { asset: "core/scripts/qmd-reindex-after-sync.sh", root: "cwd", summary: "Scaffold-only native utility companion" },
-    { asset: "core/scripts/detect-stale-core-policy-mirror.sh", root: "live", summary: "Scaffold-only native utility companion" },
-    { asset: "core/scripts/hq-status-summary.sh", root: "cwd", summary: "Scaffold-only native utility companion" },
-    { asset: "core/scripts/ontology-readme-drift.sh", root: "live", summary: "Scaffold-only native utility companion" },
-    { asset: "core/scripts/resize-screenshot.sh", root: "cwd", summary: "Scaffold-only native utility companion" },
-    { asset: "core/scripts/token-usage-report.sh", root: "cwd", summary: "Scaffold-only native utility companion" },
-    { asset: "core/scripts/worktree.sh", root: "live", summary: "Scaffold-only native utility companion" },
-    {
-        asset: "core/scripts/rebuild-all-indexes.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-companies-index.sh",
+    ...NATIVE_UTILITY_COMMANDS.map(({ asset, root, summary }) => ({
+        asset,
+        root,
+        summary: `Scaffold-only native utility companion: ${summary}`,
+    })),
+    ...REBUILD_INDEX_TARGETS.map(({ asset }) => ({
+        asset,
         root: "cwd",
         summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-company-knowledge-index.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-orchestrator-index.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-projects-index.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-public-knowledge-index.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-reports-index.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-social-drafts-index.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-threads-index.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
-    {
-        asset: "core/scripts/rebuild-workers-index.sh",
-        root: "cwd",
-        summary: "Scaffold-only native rebuild-index companion",
-    },
+    })),
 ];
 /** Every claimed bundled asset, used by packaging and interpreter tests. */
 export const SCAFFOLD_ASSETS = [
@@ -328,7 +290,7 @@ export function registerCoreCommands(program) {
     // similarly named scaffold assets are forwarders, so sending them through
     // runEntry would recurse back into this command forever.
     for (const entry of NATIVE_SCAFFOLD_COMMANDS) {
-        core
+        const command = core
             .command(entry.name)
             .description(entry.summary)
             .allowUnknownOption()
@@ -344,9 +306,14 @@ export function registerCoreCommands(program) {
             if (result.status !== 0)
                 process.exit(result.status);
         });
+        describeCoreCommand(command, {
+            execution: "native",
+            asset: entry.asset,
+            root: entry.root,
+        });
     }
     for (const entry of NATIVE_UTILITY_COMMANDS) {
-        core
+        const command = core
             .command(entry.name)
             .description(entry.summary)
             .allowUnknownOption()
@@ -361,6 +328,11 @@ export function registerCoreCommands(program) {
             if (code !== 0)
                 process.exit(code);
         });
+        describeCoreCommand(command, {
+            execution: "native",
+            asset: entry.asset,
+            root: entry.root,
+        });
     }
     // `hq core worker <name>` — a nested subgroup for worker-scoped skill
     // maintenance. Nested (rather than flat `hq core worker-<name>`) so the two
@@ -369,7 +341,7 @@ export function registerCoreCommands(program) {
         .command("worker")
         .description("Worker-scoped skill maintenance (lint, share)");
     for (const entry of WORKER_SUBCOMMANDS) {
-        worker
+        const command = worker
             .command(entry.name)
             .description(entry.summary)
             // Pure passthrough: the wrapped script owns its own argument grammar.
@@ -382,6 +354,11 @@ export function registerCoreCommands(program) {
             const operands = cmd.args.length > 0 ? cmd.args : args;
             runEntry(entry, scope, operands);
         });
+        describeCoreCommand(command, {
+            execution: interpreterFor(entry.asset) === "node" ? "bundled-node" : "bundled-shell",
+            asset: entry.asset,
+            root: entry.root,
+        });
     }
     const runCommand = (entry, args = [], cmd, target) => {
         const scope = core.opts();
@@ -393,7 +370,7 @@ export function registerCoreCommands(program) {
         runEntry(entry, scope, passthrough);
     };
     const validTargets = REBUILD_INDEX_TARGETS.map((entry) => entry.target);
-    core
+    const rebuildCommand = core
         .command("rebuild-index <target> [args...]")
         .description(`Regenerate one index (target: ${validTargets.join(", ")})`)
         // Pure passthrough: the wrapped script owns its own argument grammar, so
@@ -424,8 +401,16 @@ export function registerCoreCommands(program) {
             throw expectedUserError(`rebuild-index: refused to overwrite ${refused.length} hand-edited INDEX.md file(s). Re-run with --accept to overwrite.`);
         }
     });
+    describeCoreCommand(rebuildCommand, {
+        entries: REBUILD_INDEX_TARGETS.map((entry) => ({
+            name: `rebuild-index ${entry.target}`,
+            execution: "native",
+            asset: entry.asset,
+            root: "live",
+        })),
+    });
     for (const entry of SCAFFOLD_COMMANDS) {
-        core
+        const command = core
             .command(entry.name)
             .description(entry.summary)
             // Pure passthrough: the wrapped script owns its own argument grammar, so
@@ -438,12 +423,17 @@ export function registerCoreCommands(program) {
             .action((args = [], _opts, cmd) => {
             runCommand(entry, args, cmd);
         });
+        describeCoreCommand(command, {
+            execution: interpreterFor(entry.asset) === "node" ? "bundled-node" : "bundled-shell",
+            asset: entry.asset,
+            root: entry.root,
+        });
     }
     // `hq core soft-timeout <interval> [--hard-cap <spec>] [--label <name>] -- <cmd…>`
     // Async and bespoke (the NATIVE_UTILITY_COMMANDS table is synchronous), since
     // it spawns a child and warns over time. Warn-don't-kill primitive for
     // finding 2.1 — the CLI-hosted twin of core/scripts/lib/soft-timeout.sh.
-    core
+    const softTimeout = core
         .command("soft-timeout")
         .description("Run a command under a soft (warn, don't kill) timeout")
         // Passthrough: the wrapped command owns everything after `--`.
@@ -457,10 +447,11 @@ export function registerCoreCommands(program) {
         if (code !== 0)
             process.exit(code);
     });
+    describeCoreCommand(softTimeout, { execution: "native", root: "cwd" });
     // `hq core timeout-guard` — PreToolUse decision for the foreground-timeout
     // guard (finding 2.1). Reads the hook JSON on stdin and exits 2 to block, 0
     // to allow. The shipped .claude hook is a thin shim over this.
-    core
+    const timeoutGuard = core
         .command("timeout-guard")
         .description("PreToolUse guard: block over-ceiling foreground timeouts (reads hook JSON on stdin)")
         .helpOption(false)
@@ -472,10 +463,11 @@ export function registerCoreCommands(program) {
         if (code !== 0)
             process.exit(code);
     });
+    describeCoreCommand(timeoutGuard, { execution: "native", root: "cwd" });
     // `hq core sentry report` — constrained, stderr-diagnostic-only transport
     // for hook health events. Event data is accepted only on stdin so it never
     // appears in the process list shared by the fleet.
-    core
+    const sentryReport = core
         .command("sentry")
         .description("Constrained diagnostics transport for HQ hooks")
         .command("report")
@@ -495,6 +487,18 @@ export function registerCoreCommands(program) {
         if (result.code !== 0)
             process.exitCode = result.code;
     });
+    describeCoreCommand(sentryReport, { execution: "native", root: "live" });
+    const commands = core
+        .command("commands", { hidden: true })
+        .description("List registered hq core commands as JSON")
+        .option("--json", "Print the command catalog as JSON")
+        .action((options) => {
+        if (!options.json) {
+            throw expectedUserError("Usage: hq core commands --json");
+        }
+        process.stdout.write(`${JSON.stringify(registeredCoreCommandListing(core))}\n`);
+    });
+    describeCoreCommand(commands, { execution: "native", root: "cwd" });
     return core;
 }
 //# sourceMappingURL=core.js.map

package/dist/commands/daemon.d.ts

@@ -16,7 +16,6 @@
 import type { Command } from "commander";
 import { type LegacyUnit } from "../lib/daemon/legacy.js";
 import type { HostApp } from "../lib/daemon/supervisor.js";
-import { type SyncModeVaultClient } from "./sync-mode.js";
 import type { RunCommand } from "../lib/service-manager/launchd.js";
 export interface DaemonCommandDeps {
     env: NodeJS.ProcessEnv;
@@ -39,8 +38,6 @@ export interface DaemonCommandDeps {
     userHome: (user: string) => string;
     /** The pid is a live `hq daemon run`. */
     daemonAlive: (pid: number) => boolean;
-    /** Test seam for the company sync-mode commands. */
-    syncModeClient?: () => Promise<SyncModeVaultClient>;
     windowsUser?: string;
     windowsHeadlessLauncher?: string;
     systemUnitDir?: string;