@indigoai-us/hq-cli 5.345.99 → 5.345.101

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## [Unreleased]
 
+## [5.345.101] — 2026-10-12
+- Doctor JSON no longer counts an ordinary HQ Core upgrade warning in its
+  summary after omitting it from results. Session-start health that only saw
+  that leftover warning after `hq doctor --fix` stops treating it as an
+  unrepaired failure. `hq doctor` still prints the upgrade.
+
+## [5.345.100] — 2026-10-12
+- `hq storage status` no longer runs the big-file scan, so it returns the
+  local backup and cloud history figures without waiting minutes on a big HQ.
+  Its JSON adds `big_files_included: false` and leaves out `offload`.
+- New `hq storage big-files [--json]` runs only the big-file scan and returns
+  `{ offload, generated_at }`. Read-only; a failed scan reports
+  `offload.available: false` instead of failing.
+- `hq storage status --big-files` keeps the old single call: the scan runs and
+  `offload` is included as before (`big_files_included: true`).
+
 ## [5.345.99] — 2026-10-12
 - Session-start health no longer files an ordinary HQ Core upgrade warning as
   a failed doctor repair, including older hooks that only read `hq doctor --json`.

package/dist/command-catalog.generated.d.ts

@@ -2935,6 +2935,26 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--no-cache";
             readonly description: "List cloud file history live instead of using figures from the last 15 minutes";
             readonly hidden: false;
+        }, {
+            readonly flags: "--big-files";
+            readonly description: "Also scan for big files (slow on a big HQ); same as `hq storage big-files`";
+            readonly hidden: false;
+        }];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "big-files";
+        readonly description: "Show big files that could move to HQ cloud (the slow scan `status` skips; read-only)";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: true;
+        readonly helpCommand: false;
+        readonly usage: "[options]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [];
+        readonly options: readonly [{
+            readonly flags: "--json";
+            readonly description: "Print JSON";
+            readonly hidden: false;
         }];
         readonly subcommands: readonly [];
     }, {

package/dist/command-catalog.generated.js

@@ -3538,6 +3538,30 @@ export const COMMAND_CATALOG = [
                         "flags": "--no-cache",
                         "description": "List cloud file history live instead of using figures from the last 15 minutes",
                         "hidden": false
+                    },
+                    {
+                        "flags": "--big-files",
+                        "description": "Also scan for big files (slow on a big HQ); same as `hq storage big-files`",
+                        "hidden": false
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "big-files",
+                "description": "Show big files that could move to HQ cloud (the slow scan `status` skips; read-only)",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": false,
+                "usage": "[options]",
+                "helpText": [],
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--json",
+                        "description": "Print JSON",
+                        "hidden": false
                     }
                 ],
                 "subcommands": []

package/dist/commands/storage.d.ts

@@ -16,8 +16,22 @@
  * before vending, and `status` marks each company with `can_delete`.
  *
  * `offload` and `fetch` (big files to the personal vault) live in
- * `storage-offload.ts`; this file registers them and adds the offload section
- * to `status`.
+ * `storage-offload.ts`; this file registers them and the big-files read.
+ *
+ * The big-file scan (`hq-storage.sh large`, minutes on a big HQ) is not part
+ * of a default `status`. JSON shapes:
+ *
+ *   `hq storage status --json`
+ *     { local, cloud, cloud_error?, big_files_included: false, generated_at }
+ *   `hq storage status --big-files --json` (one call, as older CLIs did)
+ *     { local, cloud, cloud_error?, offload, big_files_included: true, generated_at }
+ *   `hq storage big-files --json`
+ *     { offload, generated_at }
+ *
+ * `offload` is the OffloadStatus from `storage-offload.ts`; its fields are
+ * unchanged. A failed scan reports `offload.available: false` with a
+ * `reason` instead of failing the command. Older CLIs have no
+ * `big_files_included` and always included `offload` in status.
  */
 import { Command } from "commander";
 import { type ReclaimReport } from "./storage-core.js";
@@ -59,7 +73,19 @@ export interface StorageStatus {
     cloud: CloudCompanyStatus[];
     /** Set when cloud history could not be read at all, e.g. not signed in. */
     cloud_error?: string;
+    /** Big files. Present only when the scan ran (`--big-files`). */
     offload?: OffloadStatus;
+    /**
+     * Whether this status ran the big-file scan. False on a default status:
+     * get big files with `hq storage big-files`. Absent on older CLIs,
+     * which always ran it.
+     */
+    big_files_included: boolean;
+    generated_at: string;
+}
+/** `hq storage big-files --json`: the big-file scan on its own. */
+export interface StorageBigFiles {
+    offload: OffloadStatus;
     generated_at: string;
 }
 export interface CloudPruneResult {
@@ -192,7 +218,15 @@ export declare function pruneCloud(company: CompanyRef, cutoff: Date, dryRun: bo
 export declare function runStorageStatus(opts: {
     company?: string;
     noCache?: boolean;
+    bigFiles?: boolean;
 }, deps: StorageDeps): Promise<StorageStatus>;
+/**
+ * The big-file scan on its own (`hq storage big-files`): what a default
+ * `status` leaves out. Read-only like status: never drops backups, runs gc,
+ * prunes or touches the cloud. A failed scan is reported in the result
+ * (`offload.available: false`), not thrown.
+ */
+export declare function runStorageBigFiles(deps: StorageDeps): Promise<StorageBigFiles>;
 export declare function parseCutoff(value: string, flag: string): Date;
 export declare function runStoragePrune(opts: {
     localBefore?: string;

package/dist/commands/storage.js

@@ -16,8 +16,22 @@
  * before vending, and `status` marks each company with `can_delete`.
  *
  * `offload` and `fetch` (big files to the personal vault) live in
- * `storage-offload.ts`; this file registers them and adds the offload section
- * to `status`.
+ * `storage-offload.ts`; this file registers them and the big-files read.
+ *
+ * The big-file scan (`hq-storage.sh large`, minutes on a big HQ) is not part
+ * of a default `status`. JSON shapes:
+ *
+ *   `hq storage status --json`
+ *     { local, cloud, cloud_error?, big_files_included: false, generated_at }
+ *   `hq storage status --big-files --json` (one call, as older CLIs did)
+ *     { local, cloud, cloud_error?, offload, big_files_included: true, generated_at }
+ *   `hq storage big-files --json`
+ *     { offload, generated_at }
+ *
+ * `offload` is the OffloadStatus from `storage-offload.ts`; its fields are
+ * unchanged. A failed scan reports `offload.available: false` with a
+ * `reason` instead of failing the command. Older CLIs have no
+ * `big_files_included` and always included `offload` in status.
  */
 import chalk from "chalk";
 import * as fs from "node:fs";
@@ -527,10 +541,13 @@ export async function pruneCloud(company, cutoff, dryRun, deps) {
 // ── Orchestrators ───────────────────────────────────────────────────────────
 export async function runStorageStatus(opts, deps) {
     // Read-only: no backup drop, no gc. Pending backup bytes come from report.
-    // The local report, the offload scan and the cloud listing are independent,
-    // so they run at the same time: status takes as long as the slowest one.
+    // The big-file scan is the slow part on a big HQ, so it runs only when
+    // asked for (`--big-files`); `hq storage big-files` runs it on its own.
+    // The local report, that scan and the cloud listing are independent, so
+    // they run at the same time: status takes as long as the slowest one.
+    const bigFiles = opts.bigFiles === true;
     const localP = getLocalReport(deps);
-    const offloadP = deps.getOffload ? deps.getOffload().catch(offloadUnavailable) : Promise.resolve(undefined);
+    const offloadP = bigFiles && deps.getOffload ? deps.getOffload().catch(offloadUnavailable) : Promise.resolve(undefined);
     const cloudP = (async () => {
         let memberships;
         try {
@@ -564,9 +581,22 @@ export async function runStorageStatus(opts, deps) {
         cloud,
         ...(cloud_error !== undefined ? { cloud_error } : {}),
         ...(offload ? { offload } : {}),
+        big_files_included: bigFiles,
         generated_at: deps.now().toISOString(),
     };
 }
+/**
+ * The big-file scan on its own (`hq storage big-files`): what a default
+ * `status` leaves out. Read-only like status: never drops backups, runs gc,
+ * prunes or touches the cloud. A failed scan is reported in the result
+ * (`offload.available: false`), not thrown.
+ */
+export async function runStorageBigFiles(deps) {
+    const offload = deps.getOffload
+        ? await deps.getOffload().catch(offloadUnavailable)
+        : offloadUnavailable(new Error("big-file scan not available"));
+    return { offload, generated_at: deps.now().toISOString() };
+}
 const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 export function parseCutoff(value, flag) {
     const d = new Date(`${value}T00:00:00Z`);
@@ -710,6 +740,9 @@ export function formatStorageStatus(status) {
     }
     if (status.offload)
         lines.push("", ...formatOffloadStatus(status.offload));
+    else if (status.big_files_included === false) {
+        lines.push("", chalk.bold("Big files"), "  Not checked. Run `hq storage big-files` to scan for them.");
+    }
     return lines.join("\n");
 }
 function offloadUnavailable(err) {
@@ -1077,9 +1110,10 @@ export function registerStorageCommand(program) {
         .option("--json", "Print JSON")
         .option("--company <slug>", "Only this company (must be one of yours)")
         .option("--no-cache", "List cloud file history live instead of using figures from the last 15 minutes")
+        .option("--big-files", "Also scan for big files (slow on a big HQ); same as `hq storage big-files`")
         .action(async (opts) => {
         try {
-            const status = await runStorageStatus({ company: opts.company, noCache: opts.cache === false }, await buildDeps());
+            const status = await runStorageStatus({ company: opts.company, noCache: opts.cache === false, bigFiles: opts.bigFiles === true }, await buildDeps());
             console.log(opts.json ? JSON.stringify(status, null, 2) : formatStorageStatus(status));
         }
         catch (err) {
@@ -1087,6 +1121,20 @@ export function registerStorageCommand(program) {
             process.exitCode = 1;
         }
     });
+    storage
+        .command("big-files")
+        .description("Show big files that could move to HQ cloud (the slow scan `status` skips; read-only)")
+        .option("--json", "Print JSON")
+        .action(async (opts) => {
+        try {
+            const result = await runStorageBigFiles(await buildDeps());
+            console.log(opts.json ? JSON.stringify(result, null, 2) : formatOffloadStatus(result.offload).join("\n"));
+        }
+        catch (err) {
+            console.error(chalk.red(err.message));
+            process.exitCode = 1;
+        }
+    });
     storage
         .command("prune")
         .description("Delete local autosave history and old cloud file versions before a date")

package/dist/lib/doctor/json-output.d.ts

@@ -107,12 +107,12 @@ export interface BuildDoctorJsonInput {
     /**
      * JSON consumed by the SessionStart health hook (`--client-health-report`).
      * Ordinary hq-core upgrade WARNs are omitted from every JSON document
-     * (`--json` and `--client-health-report`): `--fix` cannot apply a release,
-     * and both current hooks and older ones that only call `hq doctor --json`
-     * treated the leftover WARN as an unrepaired failure. Human `hq doctor`
-     * still prints the upgrade. Company journals this `--fix` pass did not try
-     * to refresh are omitted only from `--client-health-report`: the repair cap
-     * leaves them for a later session.
+     * (`--json` and `--client-health-report`), including `summary` tallies:
+     * `--fix` cannot apply a release, and both current hooks and older ones
+     * that only call `hq doctor --json` treated the leftover WARN as an
+     * unrepaired failure. Human `hq doctor` still prints the upgrade. Company
+     * journals this `--fix` pass did not try to refresh are omitted only from
+     * `--client-health-report`: the repair cap leaves them for a later session.
      */
     clientHealthReport?: boolean;
     /** Clock for the leftover-journal freshness window. Default: `Date.now`. */
@@ -121,8 +121,9 @@ export interface BuildDoctorJsonInput {
 /**
  * True when a sync finding is an ordinary, non-repairable hq-core upgrade.
  * FAIL stays visible: that is a broken local core, not "a newer release exists".
- * JSON omits the WARN so SessionStart health (including core 15.x hooks that
- * only call `hq doctor --json`) does not file it as a failed repair.
+ * JSON omits the WARN (from `results` and `summary`) so SessionStart health
+ * (including core 15.x hooks that only call `hq doctor --json`) does not file
+ * it as a failed repair.
  */
 export declare function isOrdinaryCoreUpdateWarn(result: {
     checkId: string;

package/dist/lib/doctor/json-output.js

@@ -17,7 +17,7 @@
  * `target` and `remediation` are emitted only when present, matching the
  * per-item result shape where both are optional.
  */
-import { computeExitCode, summarize, UNKNOWN_PLATFORM, } from "./report.js";
+import { computeExitCode, emptyStatusCounts, UNKNOWN_PLATFORM, } from "./report.js";
 import { deriveRemediation } from "./fix/remediation.js";
 import { freshAttemptedCompanyJournalCheckIds, isUnreachedCompanyJournalForClientHealth, } from "./fix/refresh-sync-progress.js";
 /**
@@ -33,12 +33,20 @@ export const DOCTOR_JSON_SCHEMA_VERSION = 2;
 /**
  * True when a sync finding is an ordinary, non-repairable hq-core upgrade.
  * FAIL stays visible: that is a broken local core, not "a newer release exists".
- * JSON omits the WARN so SessionStart health (including core 15.x hooks that
- * only call `hq doctor --json`) does not file it as a failed repair.
+ * JSON omits the WARN (from `results` and `summary`) so SessionStart health
+ * (including core 15.x hooks that only call `hq doctor --json`) does not file
+ * it as a failed repair.
  */
 export function isOrdinaryCoreUpdateWarn(result) {
     return result.checkId === "sync.update.core" && result.status === "WARN";
 }
+/** Tally the results that actually ship in the JSON document. */
+function summarizeJsonResults(results) {
+    const counts = emptyStatusCounts();
+    for (const result of results)
+        counts[result.status] += 1;
+    return counts;
+}
 /** Assemble the machine-readable document from a completed run. */
 export function buildDoctorJson(input) {
     const attemptedRefreshSyncCheckIds = input.clientHealthReport === true
@@ -61,7 +69,7 @@ export function buildDoctorJson(input) {
         schemaVersion: DOCTOR_JSON_SCHEMA_VERSION,
         platform: input.platform ?? UNKNOWN_PLATFORM,
         hqRoot: input.hqRoot,
-        summary: summarize(input.families),
+        summary: summarizeJsonResults(results),
         exitCode: computeExitCode(input.families),
         ...(input.scope && input.scope.length > 0 ? { scope: [...input.scope] } : {}),
         results,

package/package.json

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