@indigoai-us/hq-cli 5.345.175 → 5.345.177

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

@@ -1,5 +1,7 @@
 import type { Command } from "commander";
 import { type SyncCoreReconcileResult } from "../lib/sync-core/reconcile.js";
+import { type EngineManifestScope } from "../lib/sync-core/manifest-scopes.js";
+import type { RunSyncManifestOptions, RunSyncManifestOutcome, SyncManifestDeps } from "./sync-manifest.js";
 export interface SyncCoreReconcileCommandOptions {
     hqRoot?: string;
     companiesOnly?: boolean;
@@ -15,6 +17,21 @@ export interface SyncCoreCommandDeps {
     err: (line: string) => void;
 }
 export declare function runSyncCoreReconcile(opts: SyncCoreReconcileCommandOptions, d?: SyncCoreCommandDeps): Promise<SyncCoreReconcileResult>;
+export interface SyncCoreManifestCommandOptions {
+    hqRoot?: string;
+    json?: boolean;
+}
+export interface SyncCoreManifestDeps extends SyncCoreCommandDeps {
+    runManifest?: (options: RunSyncManifestOptions, deps: SyncManifestDeps) => Promise<RunSyncManifestOutcome>;
+    manifestDeps?: () => SyncManifestDeps;
+}
+export interface SyncCoreManifestResult {
+    scope: EngineManifestScope;
+    status: string;
+    mode?: string;
+    errorKind?: string;
+}
+export declare function runSyncCoreManifest(opts: SyncCoreManifestCommandOptions, d?: SyncCoreManifestDeps): Promise<SyncCoreManifestResult[]>;
 export declare function runSyncCoreStatus(opts: {
     json?: boolean;
 }, d?: SyncCoreCommandDeps): void;

package/dist/commands/sync-core.js

@@ -4,6 +4,7 @@ import * as path from "node:path";
 import { ensureSyncCoreBinary } from "../lib/sync-core/release.js";
 import { readCompanyRolloutFlag } from "../lib/sync-core/flag.js";
 import { reconcileSyncCore } from "../lib/sync-core/reconcile.js";
+import { engineOwnedManifestScopes, manifestScopeArg } from "../lib/sync-core/manifest-scopes.js";
 import { readSyncCoreRolloutState, syncCoreRolloutStatePath } from "../lib/sync-core/rollout-state.js";
 import { readVaultSyncSwitches } from "../lib/vault-sync-switches.js";
 function defaultDeps() {
@@ -66,6 +67,45 @@ export async function runSyncCoreReconcile(opts, d = defaultDeps()) {
         d.out("no vault on this machine is switched to the new sync engine");
     return result;
 }
+export async function runSyncCoreManifest(opts, d = defaultDeps()) {
+    const hqRoot = await resolveHqRoot(opts.hqRoot, d.env);
+    const scopes = engineOwnedManifestScopes(readVaultSyncSwitches(d.home), readSyncCoreRolloutState(d.home)?.vaults);
+    if (scopes.length === 0) {
+        if (opts.json)
+            d.out("[]");
+        else
+            d.out("no vault on this machine is owned by the new sync engine; the current sync uploads its own manifests");
+        return [];
+    }
+    const manifest = await import("./sync-manifest.js");
+    const runManifest = d.runManifest ?? manifest.runSyncManifest;
+    const manifestDeps = d.manifestDeps ?? manifest.createDefaultDeps;
+    const results = [];
+    for (const scope of scopes) {
+        const label = manifestScopeArg(scope);
+        try {
+            const outcome = await runManifest({ scopeArg: manifestScopeArg(scope), hqRoot, respectThrottle: true, json: true, engineOwned: true }, { ...manifestDeps(), log: () => { } });
+            const { status, mode, error } = outcome.result;
+            results.push({
+                scope,
+                status,
+                ...(mode ? { mode } : {}),
+                ...(error?.kind ? { errorKind: error.kind } : {}),
+            });
+            if (!opts.json)
+                d.out(`${label}: ${status}${mode ? ` (${mode})` : ""}${error?.kind ? ` ${error.kind}` : ""}`);
+        }
+        catch (err) {
+            results.push({ scope, status: "failed", errorKind: "command_error" });
+            d.err(`${label}: manifest pass failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (opts.json)
+        d.out(JSON.stringify(results, null, 2));
+    if (results.some((r) => r.status === "failed"))
+        process.exitCode = 1;
+    return results;
+}
 export function runSyncCoreStatus(opts, d = defaultDeps()) {
     const state = readSyncCoreRolloutState(d.home);
     if (opts.json) {
@@ -83,15 +123,16 @@ export function runSyncCoreStatus(opts, d = defaultDeps()) {
     for (const vault of state.vaults) {
         const legacyOff = vault.kind === "personal" ? switches.personalOff : switches.offCompanies.has(vault.slug ?? "");
         d.out(`  ${vault.uid}  ${vault.kind}${vault.slug ? ` ${vault.slug}` : ""}  ${vault.phase === "full" ? "full" : "read-only"}  legacy sync ${legacyOff ? "off" : "still on"}  home ${vault.engineHome}`);
-        if (vault.plan) {
-            const p = vault.plan;
-            d.out(`    plan ${p.at}: ${p.remoteRows} server rows, ${p.localFiles} local files; would upload ${p.uploads}, download ${p.downloads}, delete ${p.deletes}, write ${p.conflicts} conflict or merge copies`);
+        if (vault.firstCycle) {
+            const c = vault.firstCycle;
+            d.out(`    first full cycle ${c.at}: ${c.planned} planned, ${c.completed} completed, ${c.pending} pending, ${c.held} held, ${c.notApplied} not applied`);
+            d.out(`    listed work${c.truncated ? ` (first ${c.listed} items only)` : ""}: ${c.uploads} uploads, ${c.downloads} downloads, ${c.deletes} deletes, ${c.conflicts} conflict or merge copies, ${c.deferred} deferred`);
         }
-        if (vault.hold)
-            d.out(`    held read-only: ${vault.hold}`);
     }
     for (const skip of state.skipped ?? [])
         d.out(`  ${skip.uid}  skipped on this machine: ${skip.reason}`);
+    for (const hold of state.held ?? [])
+        d.out(`  ${hold.uid}  held: ${hold.reason}`);
     if (state.vaults.length === 0)
         d.out("  no vault is switched to the new sync engine");
 }

package/dist/commands/sync-manifest.d.ts

@@ -110,7 +110,13 @@ export interface RunSyncManifestOptions {
      * `resend_full_scheduled` too, and none of those uploaded anything.
      */
     json?: boolean;
+    engineOwned?: boolean;
 }
+export declare const SYNC_CORE_OWNS_SCOPE_LEDGER_CLASS = "SyncCoreOwnsScope";
+export declare class SyncCoreOwnsScope extends Error {
+    constructor();
+}
+export declare function engineOwnedLedger(): never;
 /** The machine-readable outcome `--json` prints. Fixed tokens only, no paths. */
 export interface ManifestOutcomeLine {
     status: string;

package/dist/commands/sync-manifest.js

@@ -64,6 +64,16 @@ export const MANIFEST_UPLOAD_PATH = "/v1/sync-manifest/upload";
 export { MANIFEST_DISABLED_ENV, manifestUploadsDisabled };
 /** The literal `--scope` value that selects the personal (non-company) tree. */
 export const PERSONAL_SCOPE = "personal";
+export const SYNC_CORE_OWNS_SCOPE_LEDGER_CLASS = "SyncCoreOwnsScope";
+export class SyncCoreOwnsScope extends Error {
+    constructor() {
+        super("the new sync engine owns this scope; the legacy journal is not its ledger");
+        this.name = SYNC_CORE_OWNS_SCOPE_LEDGER_CLASS;
+    }
+}
+export function engineOwnedLedger() {
+    throw new SyncCoreOwnsScope();
+}
 /** Build the `--json` line for one pass. The free-text error detail is left out. */
 export function manifestOutcomeLine(result) {
     return {
@@ -333,6 +343,7 @@ export async function runSyncManifest(options, deps) {
         dryRun: print,
         forceFull: options.full === true,
         ignoreThrottle: options.respectThrottle !== true,
+        ...(options.engineOwned === true ? { listJournalsImpl: engineOwnedLedger } : {}),
     });
     if (print) {
         deps.log(JSON.stringify(result.chunks ?? [], null, 2));
@@ -358,6 +369,7 @@ export function registerSyncManifestCommand(syncCmd) {
         .option("--print", "Build and print the chunks as JSON; upload nothing")
         .option("--json", "Print the pass outcome as one JSON line instead of a summary")
         .option("--respect-throttle", "Honour the 24h per-scope upload throttle instead of forcing a pass (for scheduled callers)")
+        .option("--engine-owned", "The new sync engine owns this scope here: build the manifest from disk alone and mark the legacy journal as not its ledger")
         .option("--hq-root <path>", `Local HQ tree root (default: ${DEFAULT_HQ_ROOT})`, DEFAULT_HQ_ROOT)
         .action(async (options) => {
         // Capability gate BEFORE anything else: on a published hq-cloud that
@@ -376,6 +388,7 @@ export function registerSyncManifestCommand(syncCmd) {
                 print: options.print,
                 respectThrottle: options.respectThrottle,
                 json: options.json,
+                engineOwned: options.engineOwned,
             }, createDefaultDeps());
             if (outcome.exitCode !== 0)
                 process.exit(outcome.exitCode);