@indigoai-us/hq-cloud 6.14.17 → 6.14.18

package/dist/active-company.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Seed `activeCompany` in `.hq/config.json` for a joiner who has exactly one
+ * cloud company.
+ *
+ * A newly invited member arrives with no local company routing at all. The
+ * manifest reconciler restores their `companies/manifest.yaml` entry, but
+ * nothing tells HQ which company is *current*, so they stay unrouted even
+ * though membership resolved fine. When the answer is unambiguous — one company
+ * and no existing choice — recording it is strictly better than leaving the
+ * user to guess.
+ *
+ * Everything here is deliberately conservative. This runs unattended on every
+ * sync, against a file the user also edits by hand, so the bar for writing is
+ * "the answer cannot be wrong": never overwrite an existing choice, never guess
+ * between two companies, and never clobber a file we could not parse.
+ */
+export interface SeedActiveCompanyOptions {
+    hqRoot: string;
+    /** Slugs of companies that reconciled successfully this run. */
+    companySlugs: readonly string[];
+    reportDiagnostic?: (diagnostic: {
+        event: string;
+        message: string;
+        err: unknown;
+        context: Record<string, unknown>;
+    }) => void;
+}
+export interface SeedActiveCompanyResult {
+    /** True only when `.hq/config.json` was actually written. */
+    written: boolean;
+    /** The slug that was seeded, when one was. */
+    activeCompany?: string;
+    /** Why nothing was written. Absent when `written` is true. */
+    skippedReason?: "ambiguous" | "no-companies" | "already-set" | "unreadable-config" | "write-failed";
+}
+/**
+ * Seed `activeCompany` when — and only when — the answer is unambiguous.
+ *
+ * Never throws: the caller is a sync run whose exit code must not depend on
+ * local routing convenience.
+ */
+export declare function seedActiveCompany(options: SeedActiveCompanyOptions): SeedActiveCompanyResult;
+//# sourceMappingURL=active-company.d.ts.map

package/dist/active-company.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-company.d.ts","sourceRoot":"","sources":["../src/active-company.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE;QAC9B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,OAAO,CAAC;QACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,aAAa,CAAC,EACV,WAAW,GACX,cAAc,GACd,aAAa,GACb,mBAAmB,GACnB,cAAc,CAAC;CACpB;AAwCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,uBAAuB,CA0EzB"}

package/dist/active-company.js

@@ -0,0 +1,132 @@
+/**
+ * Seed `activeCompany` in `.hq/config.json` for a joiner who has exactly one
+ * cloud company.
+ *
+ * A newly invited member arrives with no local company routing at all. The
+ * manifest reconciler restores their `companies/manifest.yaml` entry, but
+ * nothing tells HQ which company is *current*, so they stay unrouted even
+ * though membership resolved fine. When the answer is unambiguous — one company
+ * and no existing choice — recording it is strictly better than leaving the
+ * user to guess.
+ *
+ * Everything here is deliberately conservative. This runs unattended on every
+ * sync, against a file the user also edits by hand, so the bar for writing is
+ * "the answer cannot be wrong": never overwrite an existing choice, never guess
+ * between two companies, and never clobber a file we could not parse.
+ */
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+function isPlainObject(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/**
+ * Write `config` to `configPath` via temp-file + rename, so a reader never
+ * observes a half-written config and a crash cannot truncate the original.
+ */
+function writeConfigAtomically(configPath, config) {
+    const dir = path.dirname(configPath);
+    fs.mkdirSync(dir, { recursive: true });
+    const temporaryPath = path.join(dir, `.config-${process.pid}-${randomUUID()}.json`);
+    try {
+        fs.writeFileSync(temporaryPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+        fs.renameSync(temporaryPath, configPath);
+    }
+    finally {
+        // The rename consumed the temp file on the success path; this only fires
+        // when writing or renaming threw, and must not mask the original error.
+        try {
+            fs.rmSync(temporaryPath, { force: true });
+        }
+        catch {
+            // Best effort — a stray temp file is not worth failing a sync over.
+        }
+    }
+}
+/**
+ * Seed `activeCompany` when — and only when — the answer is unambiguous.
+ *
+ * Never throws: the caller is a sync run whose exit code must not depend on
+ * local routing convenience.
+ */
+export function seedActiveCompany(options) {
+    const slugs = Array.from(new Set(options.companySlugs.filter(isNonEmptyString)));
+    if (slugs.length === 0)
+        return { written: false, skippedReason: "no-companies" };
+    // Two or more companies is a genuine choice and belongs to the user. Picking
+    // one would route them somewhere arbitrary and look like a bug.
+    if (slugs.length > 1)
+        return { written: false, skippedReason: "ambiguous" };
+    const activeCompany = slugs[0];
+    const configPath = path.join(options.hqRoot, ".hq", "config.json");
+    let config = {};
+    let raw;
+    try {
+        raw = fs.readFileSync(configPath, "utf8");
+    }
+    catch (err) {
+        if (err.code !== "ENOENT") {
+            // An unreadable config is user state we cannot reason about. Leave it.
+            options.reportDiagnostic?.({
+                event: "runner.active_company.config_unreadable",
+                message: "could not read .hq/config.json; activeCompany not seeded",
+                err,
+                context: { configPath },
+            });
+            return { written: false, skippedReason: "unreadable-config" };
+        }
+    }
+    if (raw !== undefined) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            // Malformed JSON is almost always a half-finished hand edit. Overwriting
+            // it would destroy whatever the user was in the middle of doing.
+            options.reportDiagnostic?.({
+                event: "runner.active_company.config_malformed",
+                message: ".hq/config.json is not valid JSON; left untouched",
+                err,
+                context: { configPath },
+            });
+            return { written: false, skippedReason: "unreadable-config" };
+        }
+        if (!isPlainObject(parsed)) {
+            options.reportDiagnostic?.({
+                event: "runner.active_company.config_malformed",
+                message: ".hq/config.json is not a JSON object; left untouched",
+                err: undefined,
+                context: { configPath },
+            });
+            return { written: false, skippedReason: "unreadable-config" };
+        }
+        config = parsed;
+    }
+    // `companySlug` counts as already-set: sync-core resolves it as the active
+    // company when `activeCompany` is absent, so writing `activeCompany` here
+    // would silently re-route a user who already had an effective answer.
+    if (isNonEmptyString(config.activeCompany) || isNonEmptyString(config.companySlug)) {
+        return { written: false, skippedReason: "already-set" };
+    }
+    try {
+        writeConfigAtomically(configPath, { ...config, activeCompany });
+    }
+    catch (err) {
+        options.reportDiagnostic?.({
+            event: "runner.active_company.write_failed",
+            message: "failed to seed activeCompany in .hq/config.json",
+            err,
+            context: { configPath, activeCompany },
+        });
+        return { written: false, skippedReason: "write-failed" };
+    }
+    return { written: true, activeCompany };
+}
+//# sourceMappingURL=active-company.js.map

package/dist/active-company.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-company.js","sourceRoot":"","sources":["../src/active-company.ts"],"names":[],"mappings":"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"}

package/dist/active-company.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=active-company.test.d.ts.map

package/dist/active-company.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-company.test.d.ts","sourceRoot":"","sources":["../src/active-company.test.ts"],"names":[],"mappings":""}

package/dist/active-company.test.js

@@ -0,0 +1,149 @@
+import { afterEach, describe, expect, it } from "vitest";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { seedActiveCompany } from "./active-company.js";
+let hqRoot;
+afterEach(() => {
+    if (hqRoot) {
+        fs.rmSync(hqRoot, { recursive: true, force: true });
+        hqRoot = undefined;
+    }
+});
+function makeHqRoot() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), "hq-active-company-"));
+}
+function configPath(root) {
+    return path.join(root, ".hq", "config.json");
+}
+function writeConfig(root, contents) {
+    const p = configPath(root);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.writeFileSync(p, contents, "utf8");
+    return p;
+}
+function readConfig(root) {
+    return JSON.parse(fs.readFileSync(configPath(root), "utf8"));
+}
+describe("seedActiveCompany", () => {
+    it("seeds the single company when activeCompany is unset", () => {
+        hqRoot = makeHqRoot();
+        writeConfig(hqRoot, JSON.stringify({ someOtherSetting: true }));
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom"] })).toEqual({
+            written: true,
+            activeCompany: "boring-ecom",
+        });
+        expect(readConfig(hqRoot)).toEqual({
+            someOtherSetting: true,
+            activeCompany: "boring-ecom",
+        });
+    });
+    it("creates a missing config file", () => {
+        hqRoot = makeHqRoot();
+        expect(fs.existsSync(configPath(hqRoot))).toBe(false);
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom"] })).toEqual({
+            written: true,
+            activeCompany: "boring-ecom",
+        });
+        expect(readConfig(hqRoot)).toEqual({ activeCompany: "boring-ecom" });
+    });
+    it("no-ops on zero companies", () => {
+        hqRoot = makeHqRoot();
+        const before = writeConfig(hqRoot, JSON.stringify({ keep: 1 }));
+        const raw = fs.readFileSync(before, "utf8");
+        expect(seedActiveCompany({ hqRoot, companySlugs: [] })).toEqual({
+            written: false,
+            skippedReason: "no-companies",
+        });
+        expect(fs.readFileSync(before, "utf8")).toBe(raw);
+    });
+    // Two companies is a real choice. Guessing would route the user somewhere
+    // arbitrary, which is indistinguishable from a bug to the person it happens to.
+    it("no-ops on two or more companies rather than guessing", () => {
+        hqRoot = makeHqRoot();
+        const p = writeConfig(hqRoot, JSON.stringify({ keep: 1 }));
+        const raw = fs.readFileSync(p, "utf8");
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom", "acme"] })).toEqual({ written: false, skippedReason: "ambiguous" });
+        expect(fs.readFileSync(p, "utf8")).toBe(raw);
+    });
+    it("never overwrites an existing activeCompany", () => {
+        hqRoot = makeHqRoot();
+        const p = writeConfig(hqRoot, JSON.stringify({ activeCompany: "chosen-by-user" }));
+        const raw = fs.readFileSync(p, "utf8");
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom"] })).toEqual({
+            written: false,
+            skippedReason: "already-set",
+        });
+        expect(fs.readFileSync(p, "utf8")).toBe(raw);
+    });
+    // Even when the existing value names a company they have since left. Repairing
+    // that is a separate, user-visible decision — not something a sync should do
+    // silently underneath them.
+    it("never overwrites activeCompany even for a company the user has left", () => {
+        hqRoot = makeHqRoot();
+        writeConfig(hqRoot, JSON.stringify({ activeCompany: "former-employer" }));
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom"] })).toEqual({
+            written: false,
+            skippedReason: "already-set",
+        });
+        expect(readConfig(hqRoot).activeCompany).toBe("former-employer");
+    });
+    // sync-core's resolveActiveCompany falls back to `companySlug`, so a config
+    // carrying only that already HAS an effective answer. Writing activeCompany
+    // would silently re-route the user.
+    it("treats a legacy companySlug as already-set", () => {
+        hqRoot = makeHqRoot();
+        const p = writeConfig(hqRoot, JSON.stringify({ companySlug: "legacy-choice" }));
+        const raw = fs.readFileSync(p, "utf8");
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom"] })).toEqual({
+            written: false,
+            skippedReason: "already-set",
+        });
+        expect(fs.readFileSync(p, "utf8")).toBe(raw);
+    });
+    it("leaves malformed JSON untouched and reports a diagnostic", () => {
+        hqRoot = makeHqRoot();
+        const p = writeConfig(hqRoot, '{"activeCompany": "half-edited"');
+        const raw = fs.readFileSync(p, "utf8");
+        const diagnostics = [];
+        expect(seedActiveCompany({
+            hqRoot,
+            companySlugs: ["boring-ecom"],
+            reportDiagnostic: (d) => diagnostics.push(d),
+        })).toEqual({ written: false, skippedReason: "unreadable-config" });
+        expect(fs.readFileSync(p, "utf8")).toBe(raw);
+        expect(diagnostics).toHaveLength(1);
+        expect(diagnostics[0].event).toBe("runner.active_company.config_malformed");
+    });
+    it("leaves a non-object config untouched", () => {
+        hqRoot = makeHqRoot();
+        const p = writeConfig(hqRoot, "[1, 2, 3]");
+        const raw = fs.readFileSync(p, "utf8");
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom"] })).toEqual({
+            written: false,
+            skippedReason: "unreadable-config",
+        });
+        expect(fs.readFileSync(p, "utf8")).toBe(raw);
+    });
+    it("preserves unknown keys and leaves no temp files behind", () => {
+        hqRoot = makeHqRoot();
+        writeConfig(hqRoot, JSON.stringify({ nested: { a: 1 }, list: [1, 2], flag: false }));
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom"] }).written).toBe(true);
+        expect(readConfig(hqRoot)).toEqual({
+            nested: { a: 1 },
+            list: [1, 2],
+            flag: false,
+            activeCompany: "boring-ecom",
+        });
+        const strays = fs
+            .readdirSync(path.join(hqRoot, ".hq"))
+            .filter((f) => f.startsWith(".config-"));
+        expect(strays).toEqual([]);
+    });
+    it("collapses duplicate slugs — one company named twice is not ambiguous", () => {
+        hqRoot = makeHqRoot();
+        expect(seedActiveCompany({ hqRoot, companySlugs: ["boring-ecom", "boring-ecom"] })).toEqual({ written: true, activeCompany: "boring-ecom" });
+        expect(readConfig(hqRoot).activeCompany).toBe("boring-ecom");
+    });
+});
+//# sourceMappingURL=active-company.test.js.map

package/dist/active-company.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-company.test.js","sourceRoot":"","sources":["../src/active-company.test.ts"],"names":[],"mappings":"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"}

package/dist/bin/sync-runner-planning.d.ts

@@ -22,11 +22,35 @@ export interface RunnerTarget {
     slug: string;
     name?: string;
     bucketName?: string;
+    /**
+     * Entity liveness as observed AT PLAN TIME, copied off the `entity.get`
+     * result this plan was built from. Carried so a downstream consumer can make
+     * a liveness decision without paying a second round trip.
+     *
+     * These deliberately do NOT gate SYNC. A suspended company still syncs — that
+     * is user-visible behavior and not ours to change here. They exist so the
+     * MANIFEST decision (see `manifest-reconcile.ts`) can be as strict as it was
+     * when it re-fetched the entity itself. Absent fields mean "unknown", and
+     * every consumer of them is required to fail closed.
+     */
+    entityType?: string;
+    entityStatus?: string;
     personalMode?: boolean;
     journalSlug?: string;
 }
+/**
+ * Why a run cannot proceed to a fanout.
+ *
+ * - `no-memberships` — the caller resolved fine but belongs to no company.
+ *   Usually a joiner whose invite is still pending acceptance.
+ * - `no-person-entity` — the caller is signed in but has no personal entity to
+ *   sync into, so even `--personal` has no target.
+ */
+export type SetupNeededReason = "no-memberships" | "no-person-entity";
 export type MembershipResolution = {
     status: "setup-needed";
+    reason: SetupNeededReason;
+    pendingInviteCount?: number;
 } | {
     status: "memberships";
     memberships: Pick<Membership, "companyUid">[];
@@ -40,9 +64,10 @@ export declare function resolveMembershipsForRun(options: {
     stderr: {
         write: (chunk: string) => boolean | void;
     };
+    /** Returns how many invites were still pending after the claim attempt. */
     runClaimDance: (client: VaultClientSurface, claims: IdentityClaims, stderr: {
         write: (chunk: string) => boolean | void;
-    }) => Promise<void>;
+    }) => Promise<number>;
     listMemberships: (client: VaultClientSurface) => Promise<Pick<Membership, "companyUid">[]>;
 }): Promise<MembershipResolution>;
 export declare function buildFanoutPlan(options: {
@@ -55,6 +80,7 @@ export declare function buildFanoutPlan(options: {
     resolveSkipPersonal: (flag: boolean) => boolean;
 }): Promise<{
     status: "setup-needed";
+    reason: SetupNeededReason;
 } | {
     status: "plan";
     plan: RunnerTarget[];

package/dist/bin/sync-runner-planning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-runner-planning.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner-planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAMlF,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAExE,UAAU,cAAc;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,GAC1B;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAA;CAAE,CAAC;AAE7E,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IACrD,aAAa,EAAE,CACb,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAA;KAAE,KACjD,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,eAAe,EAAE,CACf,MAAM,EAAE,kBAAkB,KACvB,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;CAChD,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyBhC;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CACjD,GAAG,OAAO,CACP;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,GAC1B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,EAAE,CAAA;CAAE,CAC3C,CAoEA;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EAClC,IAAI,EAAE,YAAY,EAAE,GACnB,IAAI,CAEN"}
+{"version":3,"file":"sync-runner-planning.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner-planning.ts"],"names":[],"mappings":"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"}

package/dist/bin/sync-runner-planning.js

@@ -6,12 +6,21 @@ export async function resolveMembershipsForRun(options) {
         return { status: "memberships", memberships: [] };
     }
     if (options.companies) {
+        let pendingInviteCount = 0;
         if (options.claims) {
-            await options.runClaimDance(options.client, options.claims, options.stderr);
+            pendingInviteCount = await options.runClaimDance(options.client, options.claims, options.stderr);
         }
         const memberships = await options.listMemberships(options.client);
         if (memberships.length === 0) {
-            return { status: "setup-needed" };
+            // Pending invites that did NOT become memberships are the single most
+            // useful thing we can tell this user: they are not "solo", they have an
+            // invite waiting to be accepted. Reported only on the empty path, where
+            // it explains the emptiness.
+            return {
+                status: "setup-needed",
+                reason: "no-memberships",
+                ...(pendingInviteCount > 0 ? { pendingInviteCount } : {}),
+            };
         }
         return { status: "memberships", memberships };
     }
@@ -25,12 +34,25 @@ export async function buildFanoutPlan(options) {
     for (const m of options.memberships) {
         let slug = m.companyUid;
         let name;
+        // Carried onto the target so downstream consumers (manifest reconciliation)
+        // can use the bucket, and judge liveness, without re-fetching the entity we
+        // already resolved here. On the degraded catch path below these stay
+        // undefined, which every consumer must read as "unknown" and reject.
+        let bucketName;
+        let entityType;
+        let entityStatus;
         try {
             const info = await options.client.entity.get(m.companyUid);
             if (!info)
                 continue;
             slug = info.slug || m.companyUid;
             name = info.name;
+            bucketName = info.bucketName;
+            // Recorded, never acted on here: a suspended or unexpectedly-typed
+            // company still gets a sync leg exactly as before. Only the manifest
+            // decision consumes these.
+            entityType = info.type;
+            entityStatus = info.status;
         }
         catch (err) {
             if (err instanceof VaultAuthError)
@@ -48,7 +70,14 @@ export async function buildFanoutPlan(options) {
             }
             // Best-effort — keep UID as the display identifier.
         }
-        plan.push({ uid: m.companyUid, slug, ...(name ? { name } : {}) });
+        plan.push({
+            uid: m.companyUid,
+            slug,
+            ...(name ? { name } : {}),
+            ...(bucketName ? { bucketName } : {}),
+            ...(entityType ? { entityType } : {}),
+            ...(entityStatus ? { entityStatus } : {}),
+        });
     }
     if ((options.companies || options.personal) &&
         !options.resolveSkipPersonal(options.skipPersonal)) {
@@ -81,7 +110,7 @@ export async function buildFanoutPlan(options) {
             });
         }
         else if (options.personal) {
-            return { status: "setup-needed" };
+            return { status: "setup-needed", reason: "no-person-entity" };
         }
     }
     return { status: "plan", plan };

package/dist/bin/sync-runner-planning.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-runner-planning.js","sourceRoot":"","sources":["../../src/bin/sync-runner-planning.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync-runner-planning.js","sourceRoot":"","sources":["../../src/bin/sync-runner-planning.ts"],"names":[],"mappings":"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"}

package/dist/bin/sync-runner-planning.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sync-runner-planning.test.d.ts.map

package/dist/bin/sync-runner-planning.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-runner-planning.test.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner-planning.test.ts"],"names":[],"mappings":""}

package/dist/bin/sync-runner-planning.test.js

@@ -0,0 +1,115 @@
+import { describe, expect, it, vi } from "vitest";
+import { buildFanoutPlan, resolveMembershipsForRun } from "./sync-runner-planning.js";
+const noopStderr = { write: () => true };
+function clientStub(overrides = {}) {
+    return {
+        entity: {
+            get: () => Promise.resolve(undefined),
+            listByType: () => Promise.resolve([]),
+        },
+        ...overrides,
+    };
+}
+describe("resolveMembershipsForRun — setup-needed reasons", () => {
+    // Each reason must come from its OWN trigger. Collapsing them back into a
+    // bare `setup-needed` is what left joiners unable to tell "you have no team"
+    // apart from "you have an invite waiting".
+    it("reports no-memberships when the membership list came back empty", async () => {
+        const result = await resolveMembershipsForRun({
+            personal: false,
+            companies: true,
+            client: clientStub(),
+            claims: null,
+            stderr: noopStderr,
+            runClaimDance: () => Promise.resolve(0),
+            listMemberships: () => Promise.resolve([]),
+        });
+        expect(result).toEqual({ status: "setup-needed", reason: "no-memberships" });
+    });
+    it("attaches pendingInviteCount when the claim dance left invites unconverted", async () => {
+        const result = await resolveMembershipsForRun({
+            personal: false,
+            companies: true,
+            client: clientStub(),
+            claims: { sub: "sub-1" },
+            stderr: noopStderr,
+            runClaimDance: () => Promise.resolve(3),
+            listMemberships: () => Promise.resolve([]),
+        });
+        expect(result).toEqual({
+            status: "setup-needed",
+            reason: "no-memberships",
+            pendingInviteCount: 3,
+        });
+    });
+    it("omits pendingInviteCount rather than reporting zero", async () => {
+        const result = await resolveMembershipsForRun({
+            personal: false,
+            companies: true,
+            client: clientStub(),
+            claims: { sub: "sub-1" },
+            stderr: noopStderr,
+            runClaimDance: () => Promise.resolve(0),
+            listMemberships: () => Promise.resolve([]),
+        });
+        expect(result).toEqual({ status: "setup-needed", reason: "no-memberships" });
+        expect("pendingInviteCount" in result).toBe(false);
+    });
+    it("does not report setup-needed at all when memberships exist", async () => {
+        const runClaimDance = vi.fn().mockResolvedValue(2);
+        const result = await resolveMembershipsForRun({
+            personal: false,
+            companies: true,
+            client: clientStub(),
+            claims: { sub: "sub-1" },
+            stderr: noopStderr,
+            runClaimDance,
+            listMemberships: () => Promise.resolve([{ companyUid: "cmp_a" }]),
+        });
+        // Pending invites are only meaningful as an explanation for emptiness.
+        expect(result).toEqual({
+            status: "memberships",
+            memberships: [{ companyUid: "cmp_a" }],
+        });
+    });
+});
+describe("buildFanoutPlan — setup-needed reasons", () => {
+    it("reports no-person-entity when --personal has no resolvable personal target", async () => {
+        const result = await buildFanoutPlan({
+            memberships: [],
+            companies: false,
+            personal: true,
+            skipPersonal: false,
+            client: clientStub(),
+            claims: null,
+            resolveSkipPersonal: () => false,
+        });
+        expect(result).toEqual({ status: "setup-needed", reason: "no-person-entity" });
+    });
+    // A --companies run does not need a personal target to be useful, so an
+    // unresolvable one must not abort the whole run.
+    it("does not report no-person-entity for a --companies run", async () => {
+        const result = await buildFanoutPlan({
+            memberships: [{ companyUid: "cmp_a" }],
+            companies: true,
+            personal: false,
+            skipPersonal: false,
+            client: clientStub({
+                entity: {
+                    get: () => Promise.resolve({
+                        uid: "cmp_a",
+                        slug: "acme",
+                        type: "company",
+                        status: "active",
+                        bucketName: "bucket-a",
+                    }),
+                    listByType: () => Promise.resolve([]),
+                },
+            }),
+            claims: null,
+            resolveSkipPersonal: () => false,
+        });
+        expect(result.status).toBe("plan");
+    });
+});
+//# sourceMappingURL=sync-runner-planning.test.js.map