@indigoai-us/hq-cli 5.314.0 → 5.315.0

package/dist/lib/work-context/config.js

@@ -1,21 +1,122 @@
 /**
  * Device-local default company preference (~/.hq/work-context/config.json).
  * Preference only — never authority. activeCompany is never treated as default.
- * Default-company mode ships dark until migrationCapability (US-017A).
  */
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { atomicWriteJson, ensureOwnerDir, resolveRealTarget } from "./atomic.js";
-import { DefaultCompanyLockedError, DefaultCompanyUnavailableError, UnsafeConfigPathError, WorkContextError, } from "./errors.js";
-import { workContextConfigPath, workContextRoot } from "./paths.js";
-import { WORK_CONTEXT_CONTRACT_VERSION } from "./contract.js";
-export const DEVICE_CONFIG_SCHEMA_VERSION = 1;
+import { DefaultCompanyUnavailableError, UnsafeConfigPathError, WorkContextError, } from "./errors.js";
+import { workContextConfigPath } from "./paths.js";
+import { assertWindowsOwnerOnlyAcl } from "./windows-acl.js";
+const DEVICE_CONFIG_SCHEMA_VERSION = 1;
+const CONFIG_LOCK_TIMEOUT_MS = 5_000;
+const CONFIG_LOCK_RETRY_MS = 10;
+function waitForConfigLock(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function readConfigLockRecord(lockPath) {
+    try {
+        const stat = fs.statSync(lockPath);
+        const raw = JSON.parse(fs.readFileSync(lockPath, "utf8"));
+        const pid = typeof raw.pid === "number" && Number.isInteger(raw.pid) ? raw.pid : 0;
+        const createdAt = typeof raw.createdAt === "string" ? raw.createdAt : "";
+        const token = typeof raw.token === "string" && raw.token ? raw.token : undefined;
+        const parsedAt = Date.parse(createdAt);
+        return {
+            record: pid > 0 && createdAt ? { pid, createdAt, token } : null,
+            ageMs: Date.now() - (Number.isFinite(parsedAt) ? parsedAt : stat.mtimeMs),
+        };
+    }
+    catch {
+        return { record: null, ageMs: Number.POSITIVE_INFINITY };
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function reclaimStaleConfigLock(lockPath) {
+    const claim = `${lockPath}.reclaim.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}`;
+    try {
+        fs.renameSync(lockPath, claim);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return false;
+        throw err;
+    }
+    try {
+        return true;
+    }
+    finally {
+        try {
+            fs.unlinkSync(claim);
+        }
+        catch { /* private claim cannot block writers */ }
+    }
+}
+/** Acquire an interprocess config lock; exported for direct lock regression tests. */
+export function acquireDeviceConfigLock(root, options = {}) {
+    ensureOwnerDir(root);
+    const configPath = resolveRealTarget(workContextConfigPath(root));
+    assertSafeConfigPath(configPath);
+    const lockPath = `${configPath}.lock`;
+    const deadline = Date.now() + (options.timeoutMs ?? CONFIG_LOCK_TIMEOUT_MS);
+    const token = `${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}`;
+    let fd;
+    while (fd === undefined) {
+        try {
+            fd = fs.openSync(lockPath, "wx", 0o600);
+            fs.writeSync(fd, JSON.stringify({ pid: process.pid, createdAt: new Date().toISOString(), token }));
+        }
+        catch (err) {
+            if (err.code !== "EEXIST")
+                throw err;
+            const { record, ageMs } = readConfigLockRecord(lockPath);
+            // Age alone is not authority to steal a lock: a live writer may simply
+            // be slow. Only a missing/malformed or dead owner can be reclaimed.
+            if (!record || !isProcessAlive(record.pid)) {
+                reclaimStaleConfigLock(lockPath);
+                continue;
+            }
+            if (Date.now() >= deadline) {
+                throw new WorkContextError("ConfigLockTimeout", "Timed out waiting for the work-context config lock");
+            }
+            waitForConfigLock(CONFIG_LOCK_RETRY_MS);
+        }
+    }
+    return () => {
+        fs.closeSync(fd);
+        try {
+            const current = readConfigLockRecord(lockPath).record;
+            if (current?.token === token)
+                fs.unlinkSync(lockPath);
+        }
+        catch { /* stale reclaimer already retired or replaced this lock */ }
+    };
+}
+function withDeviceConfigLock(root, fn) {
+    const release = acquireDeviceConfigLock(root);
+    try {
+        return fn();
+    }
+    finally {
+        release();
+    }
+}
 function emptyConfig(now) {
     return {
         schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
         defaultCompany: null,
         migrationCapability: null,
         repoCompanyMap: null,
+        defaultCompanyMemberships: null,
+        repairHeldWithDefault: false,
         updatedAt: now().toISOString(),
     };
 }
@@ -45,20 +146,40 @@ function sanitizeRepoCompanyMap(raw) {
     }
     return Object.keys(out).length > 0 ? out : null;
 }
-function assertSafeConfigPath(configPath) {
+/**
+ * Refuse a config path that is a symlink (every platform) or writable by
+ * anyone other than the owner.
+ *
+ * - POSIX (darwin/linux/...): `mode & 0o022` must be clear. Unchanged.
+ * - win32: NTFS has no POSIX mode bits; Node reports 0666 for every regular
+ *   file, so the mode test would reject every config (US-018). We read the
+ *   real DACL instead (see windows-acl.ts). Unreadable DACL → documented
+ *   reduced-guarantee path: one diagnostic line, no throw.
+ */
+export function assertSafeConfigPath(configPath, io = {}) {
+    const platform = io.platform ?? process.platform;
+    const existsSync = io.existsSync ?? fs.existsSync;
+    const lstatSync = io.lstatSync ?? fs.lstatSync;
     const dir = path.dirname(configPath);
     try {
-        if (fs.existsSync(dir)) {
-            const lst = fs.lstatSync(dir);
+        if (existsSync(dir)) {
+            const lst = lstatSync(dir);
             if (lst.isSymbolicLink()) {
                 throw new UnsafeConfigPathError(`Config directory is a symlink: ${dir}`);
             }
+            if (platform === "win32") {
+                assertWindowsOwnerOnlyAcl(dir, "directory", io.windowsAcl);
+            }
         }
-        if (fs.existsSync(configPath)) {
-            const lst = fs.lstatSync(configPath);
+        if (existsSync(configPath)) {
+            const lst = lstatSync(configPath);
             if (lst.isSymbolicLink()) {
                 throw new UnsafeConfigPathError(`Config file is a symlink: ${configPath}`);
             }
+            if (platform === "win32") {
+                assertWindowsOwnerOnlyAcl(configPath, "file", io.windowsAcl);
+                return;
+            }
             const mode = lst.mode & 0o777;
             // Warn-level only for world-writable; refuse group/other write bits on read for safety.
             if (mode & 0o022) {
@@ -83,11 +204,22 @@ export function readDeviceConfig(deps) {
             throw new WorkContextError("ConfigCorruptionError", `Unsupported config schemaVersion ${String(raw.schemaVersion)}`);
         }
         // Never treat a stray activeCompany field as the default.
+        // Older `clear` commands persisted `defaultCompany: null`. A config file
+        // is durable user history, so preserving a null as "unconfigured" would
+        // re-enable automatic selection after an upgrade. Treat every persisted
+        // legacy null as the explicit opt-out tombstone instead.
+        const legacyNullDefault = Object.prototype.hasOwnProperty.call(raw, "defaultCompany") &&
+            raw.defaultCompany === null &&
+            raw.defaultCompanyAutomaticEligible !== true;
         const cleaned = {
             schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
-            defaultCompany: raw.defaultCompany ?? null,
+            defaultCompany: legacyNullDefault
+                ? { slug: "", enabled: false, source: "disabled" }
+                : raw.defaultCompany ?? null,
             migrationCapability: raw.migrationCapability ?? null,
             repoCompanyMap: sanitizeRepoCompanyMap(raw.repoCompanyMap),
+            defaultCompanyMemberships: sanitizeMembershipSnapshot(raw.defaultCompanyMemberships),
+            repairHeldWithDefault: raw.repairHeldWithDefault === true,
             updatedAt: typeof raw.updatedAt === "string" ? raw.updatedAt : new Date(0).toISOString(),
         };
         return cleaned;
@@ -102,7 +234,12 @@ function writeDeviceConfig(deps, config) {
     ensureOwnerDir(deps.root);
     const configPath = resolveRealTarget(workContextConfigPath(deps.root));
     assertSafeConfigPath(configPath);
-    atomicWriteJson(configPath, config);
+    // New blank configuration is intentionally distinct from the legacy null
+    // that the previous `clear` command wrote. Preserve that distinction on
+    // disk so a membership-cache write cannot turn into a durable opt-out.
+    atomicWriteJson(configPath, config.defaultCompany === null
+        ? { ...config, defaultCompanyAutomaticEligible: true }
+        : config);
 }
 export function getDefaultCompany(deps) {
     const cfg = readDeviceConfig(deps);
@@ -111,14 +248,16 @@ export function getDefaultCompany(deps) {
         return null;
     return d;
 }
+/** A clear is a durable opt-out, not an invitation for automatic reactivation. */
+export function isDefaultCompanyDisabled(deps) {
+    const configured = readDeviceConfig(deps).defaultCompany;
+    return configured?.source === "disabled";
+}
 export async function setDefaultCompany(slug, deps) {
     const trimmed = slug.trim();
     if (!trimmed || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(trimmed)) {
         throw new WorkContextError("InvalidCompanySlug", `Invalid company slug: ${slug}`);
     }
-    if (!deps.migrationCapability && !deps.allowWithoutMigration) {
-        throw new DefaultCompanyLockedError();
-    }
     if (!deps.validateMembership) {
         throw new DefaultCompanyUnavailableError(`Cannot verify membership for company "${trimmed}" (no membership validator)`);
     }
@@ -139,35 +278,44 @@ export async function setDefaultCompany(slug, deps) {
         resolvedUid = result.uid.trim() || undefined;
     }
     const now = deps.now ?? (() => new Date());
-    const prior = readDeviceConfig(deps);
-    const defaultCompany = {
-        slug: trimmed,
-        enabled: true,
-    };
-    if (resolvedUid)
-        defaultCompany.uid = resolvedUid;
-    const next = {
-        schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
-        defaultCompany,
-        migrationCapability: prior.migrationCapability ?? null,
-        repoCompanyMap: prior.repoCompanyMap ?? null,
-        updatedAt: now().toISOString(),
-    };
-    writeDeviceConfig(deps, next);
-    return next;
+    return withDeviceConfigLock(deps.root, () => {
+        const prior = readDeviceConfig(deps);
+        const defaultCompany = {
+            slug: trimmed,
+            enabled: true,
+            source: "chosen",
+        };
+        if (resolvedUid)
+            defaultCompany.uid = resolvedUid;
+        const next = {
+            schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
+            defaultCompany,
+            migrationCapability: prior.migrationCapability ?? null,
+            repoCompanyMap: prior.repoCompanyMap ?? null,
+            defaultCompanyMemberships: prior.defaultCompanyMemberships ?? null,
+            repairHeldWithDefault: prior.repairHeldWithDefault === true,
+            updatedAt: now().toISOString(),
+        };
+        writeDeviceConfig(deps, next);
+        return next;
+    });
 }
 export function clearDefaultCompany(deps) {
     const now = deps.now ?? (() => new Date());
-    const prior = readDeviceConfig(deps);
-    const next = {
-        schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
-        defaultCompany: null,
-        migrationCapability: prior.migrationCapability ?? null,
-        repoCompanyMap: prior.repoCompanyMap ?? null,
-        updatedAt: now().toISOString(),
-    };
-    writeDeviceConfig(deps, next);
-    return next;
+    return withDeviceConfigLock(deps.root, () => {
+        const prior = readDeviceConfig(deps);
+        const next = {
+            schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
+            defaultCompany: { slug: "", enabled: false, source: "disabled" },
+            migrationCapability: prior.migrationCapability ?? null,
+            repoCompanyMap: prior.repoCompanyMap ?? null,
+            defaultCompanyMemberships: prior.defaultCompanyMemberships ?? null,
+            repairHeldWithDefault: prior.repairHeldWithDefault === true,
+            updatedAt: now().toISOString(),
+        };
+        writeDeviceConfig(deps, next);
+        return next;
+    });
 }
 /**
  * Read the persisted company mapping for a repo identity key (gap 4).
@@ -197,51 +345,154 @@ export function setRepoCompany(key, mapping, deps) {
         throw new WorkContextError("InvalidCompanySlug", `Invalid company slug: ${mapping.slug}`);
     }
     const now = deps.now ?? (() => new Date());
-    const prior = readDeviceConfig({ root: deps.root });
-    const entry = { slug, updatedAt: now().toISOString() };
-    const uid = mapping.uid?.trim();
-    if (uid)
-        entry.uid = uid;
-    const nextMap = { ...(prior.repoCompanyMap ?? {}), [trimmed]: entry };
-    const next = {
-        schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
-        defaultCompany: prior.defaultCompany ?? null,
-        migrationCapability: prior.migrationCapability ?? null,
-        repoCompanyMap: nextMap,
-        updatedAt: now().toISOString(),
-    };
-    writeDeviceConfig({ root: deps.root }, next);
-    return next;
+    return withDeviceConfigLock(deps.root, () => {
+        const prior = readDeviceConfig({ root: deps.root });
+        const entry = { slug, updatedAt: now().toISOString() };
+        const uid = mapping.uid?.trim();
+        if (uid)
+            entry.uid = uid;
+        const nextMap = { ...(prior.repoCompanyMap ?? {}), [trimmed]: entry };
+        const next = {
+            schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
+            defaultCompany: prior.defaultCompany ?? null,
+            migrationCapability: prior.migrationCapability ?? null,
+            repoCompanyMap: nextMap,
+            defaultCompanyMemberships: prior.defaultCompanyMemberships ?? null,
+            repairHeldWithDefault: prior.repairHeldWithDefault === true,
+            updatedAt: now().toISOString(),
+        };
+        writeDeviceConfig({ root: deps.root }, next);
+        return next;
+    });
 }
 /** Persist the last memberships-wide migration capability probe (US-017B). */
 export function recordMigrationCapabilitySnapshot(snapshot, deps) {
-    const prior = readDeviceConfig(deps);
-    const now = deps.now ?? (() => new Date());
-    const next = {
-        schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
-        defaultCompany: prior.defaultCompany ?? null,
-        migrationCapability: {
-            unlocked: snapshot.unlocked,
-            offline: snapshot.offline,
-            checkedAt: snapshot.checkedAt,
-            companies: snapshot.companies.map((c) => ({
-                companyUid: c.companyUid,
-                migration: c.migration,
-            })),
-        },
-        repoCompanyMap: prior.repoCompanyMap ?? null,
-        updatedAt: now().toISOString(),
-    };
-    writeDeviceConfig({ root: deps.root }, next);
-    return next;
+    return withDeviceConfigLock(deps.root, () => {
+        const prior = readDeviceConfig(deps);
+        const now = deps.now ?? (() => new Date());
+        const next = {
+            schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
+            defaultCompany: prior.defaultCompany ?? null,
+            migrationCapability: {
+                unlocked: snapshot.unlocked,
+                offline: snapshot.offline,
+                checkedAt: snapshot.checkedAt,
+                companies: snapshot.companies.map((c) => ({
+                    companyUid: c.companyUid,
+                    migration: c.migration,
+                })),
+            },
+            repoCompanyMap: prior.repoCompanyMap ?? null,
+            defaultCompanyMemberships: prior.defaultCompanyMemberships ?? null,
+            repairHeldWithDefault: prior.repairHeldWithDefault === true,
+            updatedAt: now().toISOString(),
+        };
+        writeDeviceConfig({ root: deps.root }, next);
+        return next;
+    });
 }
-/** Convenience: build deps from HOME / injectable root. */
-export function deviceConfigDepsFromHome(home, extras = {}) {
-    return {
-        root: extras.root ?? workContextRoot(home),
-        ...extras,
-    };
+function sanitizeMembershipSnapshot(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const value = raw;
+    if (typeof value.checkedAt !== "string" || !Array.isArray(value.memberships))
+        return null;
+    const memberships = value.memberships.flatMap((entry) => {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry))
+            return [];
+        const member = entry;
+        const slug = typeof member.slug === "string" ? member.slug.trim() : "";
+        const uid = typeof member.uid === "string" ? member.uid.trim() : "";
+        return slug && uid ? [{ slug, uid }] : [];
+    });
+    return { checkedAt: value.checkedAt, memberships };
+}
+export function recordDefaultCompanyMemberships(snapshot, deps) {
+    return withDeviceConfigLock(deps.root, () => {
+        const prior = readDeviceConfig(deps);
+        const now = deps.now ?? (() => new Date());
+        const next = {
+            schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
+            defaultCompany: prior.defaultCompany ?? null,
+            migrationCapability: prior.migrationCapability ?? null,
+            repoCompanyMap: prior.repoCompanyMap ?? null,
+            defaultCompanyMemberships: {
+                checkedAt: snapshot.checkedAt,
+                memberships: snapshot.memberships.map((membership) => ({ ...membership })),
+            },
+            repairHeldWithDefault: prior.repairHeldWithDefault === true,
+            updatedAt: now().toISOString(),
+        };
+        writeDeviceConfig({ root: deps.root }, next);
+        return next;
+    });
+}
+/** Drop cached membership evidence immediately after an authoritative denial. */
+export function invalidateDefaultCompanyMemberships(deps) {
+    return withDeviceConfigLock(deps.root, () => {
+        const prior = readDeviceConfig(deps);
+        const now = deps.now ?? (() => new Date());
+        const next = {
+            schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
+            defaultCompany: prior.defaultCompany ?? null,
+            migrationCapability: prior.migrationCapability ?? null,
+            repoCompanyMap: prior.repoCompanyMap ?? null,
+            defaultCompanyMemberships: null,
+            repairHeldWithDefault: prior.repairHeldWithDefault === true,
+            updatedAt: now().toISOString(),
+        };
+        writeDeviceConfig({ root: deps.root }, next);
+        return next;
+    });
+}
+/** Persist a default only after the complete active-membership list verified it. */
+export function setAutoDefaultCompany(membership, deps) {
+    return withDeviceConfigLock(deps.root, () => {
+        const prior = readDeviceConfig(deps);
+        // Activation may have fetched memberships while another process cleared or
+        // changed this preference. Do not let that stale discovery overwrite the
+        // newer durable choice.
+        if (prior.defaultCompany?.source === "disabled" ||
+            prior.defaultCompany?.enabled ||
+            (deps.expectedUpdatedAt !== undefined &&
+                prior.updatedAt !== deps.expectedUpdatedAt)) {
+            return prior;
+        }
+        deps.afterCompareAndSwap?.();
+        const now = deps.now ?? (() => new Date());
+        const next = {
+            schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
+            defaultCompany: {
+                slug: membership.slug,
+                uid: membership.uid,
+                enabled: true,
+                source: "auto_single",
+            },
+            migrationCapability: prior.migrationCapability ?? null,
+            repoCompanyMap: prior.repoCompanyMap ?? null,
+            defaultCompanyMemberships: prior.defaultCompanyMemberships ?? null,
+            repairHeldWithDefault: prior.repairHeldWithDefault === true,
+            updatedAt: now().toISOString(),
+        };
+        writeDeviceConfig({ root: deps.root }, next);
+        return next;
+    });
+}
+export function setRepairHeldWithDefault(enabled, deps) {
+    return withDeviceConfigLock(deps.root, () => {
+        const prior = readDeviceConfig(deps);
+        const now = deps.now ?? (() => new Date());
+        const next = {
+            schemaVersion: DEVICE_CONFIG_SCHEMA_VERSION,
+            defaultCompany: prior.defaultCompany ?? null,
+            migrationCapability: prior.migrationCapability ?? null,
+            repoCompanyMap: prior.repoCompanyMap ?? null,
+            defaultCompanyMemberships: prior.defaultCompanyMemberships ?? null,
+            repairHeldWithDefault: enabled,
+            updatedAt: now().toISOString(),
+        };
+        writeDeviceConfig({ root: deps.root }, next);
+        return next;
+    });
 }
-/** Re-export for callers that stamp contractVersion on related state. */
-export { WORK_CONTEXT_CONTRACT_VERSION };
 //# sourceMappingURL=config.js.map

package/dist/lib/work-context/contract.d.ts

@@ -54,11 +54,24 @@ export interface ContextResult {
     lifecycle: LifecycleState;
     sessionId: string;
     companyUid?: string;
+    /** Resolved company slug; paired with companyUid for local hook consumers. */
+    companySlug?: string;
     projectId?: string;
     taskId?: string;
     bindingEpisodeId?: string;
     clientOperationId: string;
     errorCode?: string;
+    /** Sanitized HTTP denial details; raw response bodies are never included. */
+    httpStatus?: number;
+    serverCode?: string;
+    /** Why a project was chosen, or why the session is asking. Local consumers only. */
+    projectBindReason?: string;
+    /** Ranked alternatives when classification is needs_project. */
+    projectCandidates?: Array<{
+        projectId: string;
+        title?: string;
+        score?: number;
+    }>;
 }
 export type NormalizeTaskIdResult = {
     ok: true;

package/dist/lib/work-context/contract.schema.json

@@ -100,7 +100,9 @@
         "taskId": { "type": "string", "maxLength": 128 },
         "bindingEpisodeId": { "type": "string", "maxLength": 128 },
         "clientOperationId": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "errorCode": { "type": "string", "maxLength": 64 }
+        "errorCode": { "type": "string", "maxLength": 64 },
+        "httpStatus": { "type": "number" },
+        "serverCode": { "type": "string", "maxLength": 64 }
       }
     }
   }

package/dist/lib/work-context/default-company.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Device-default activation. A device may infer a default only from the caller's
+ * complete, verified active-membership list; it never infers a tenant from cwd.
+ */
+import { type DefaultCompanyMembership } from "./config.js";
+export declare const DEFAULT_COMPANY_MEMBERSHIP_TTL_MS: number;
+export interface ActiveMembership {
+    companySlug: string;
+    companyUid: string;
+}
+export type DefaultCompanyActivation = {
+    status: "existing";
+    memberships: DefaultCompanyMembership[];
+} | {
+    status: "auto_single";
+    memberships: DefaultCompanyMembership[];
+} | {
+    status: "needs_choice";
+    memberships: DefaultCompanyMembership[];
+} | {
+    status: "disabled";
+    memberships: DefaultCompanyMembership[];
+} | {
+    status: "identity_file";
+    memberships: [];
+} | {
+    status: "unavailable";
+    memberships: [];
+};
+export interface EnsureDefaultCompanyDeps {
+    root: string;
+    env?: NodeJS.ProcessEnv;
+    listMemberships: () => Promise<ActiveMembership[]>;
+    now?: () => Date;
+    log?: (message: string) => void;
+}
+/**
+ * Populate a blank device from one active membership, or expose the choices for
+ * an interactive caller. Identity-file boxes and explicitly disabled devices do
+ * not query memberships because a user/default must never override either.
+ */
+export declare function ensureDefaultCompany(deps: EnsureDefaultCompanyDeps): Promise<DefaultCompanyActivation>;
+//# sourceMappingURL=default-company.d.ts.map

package/dist/lib/work-context/default-company.js

@@ -0,0 +1,83 @@
+/**
+ * Device-default activation. A device may infer a default only from the caller's
+ * complete, verified active-membership list; it never infers a tenant from cwd.
+ */
+import { hasAgentIdentityFile } from "./company.js";
+import { isDefaultCompanyDisabled, readDeviceConfig, recordDefaultCompanyMemberships, setAutoDefaultCompany, } from "./config.js";
+export const DEFAULT_COMPANY_MEMBERSHIP_TTL_MS = 24 * 60 * 60 * 1000;
+function normalizeMemberships(rows) {
+    const seen = new Set();
+    return rows.flatMap((row) => {
+        const slug = row.companySlug?.trim();
+        const uid = row.companyUid?.trim();
+        if (!slug || !uid || seen.has(uid))
+            return [];
+        seen.add(uid);
+        return [{ slug, uid }];
+    });
+}
+function cachedMemberships(root, now) {
+    const snapshot = readDeviceConfig({ root }).defaultCompanyMemberships;
+    if (!snapshot)
+        return null;
+    const checkedAt = Date.parse(snapshot.checkedAt);
+    if (!Number.isFinite(checkedAt) || now.getTime() - checkedAt > DEFAULT_COMPANY_MEMBERSHIP_TTL_MS) {
+        return null;
+    }
+    return snapshot.memberships;
+}
+/**
+ * Populate a blank device from one active membership, or expose the choices for
+ * an interactive caller. Identity-file boxes and explicitly disabled devices do
+ * not query memberships because a user/default must never override either.
+ */
+export async function ensureDefaultCompany(deps) {
+    const env = deps.env ?? process.env;
+    if (hasAgentIdentityFile(env))
+        return { status: "identity_file", memberships: [] };
+    const now = (deps.now ?? (() => new Date()))();
+    const configBeforeDiscovery = readDeviceConfig({ root: deps.root });
+    const cached = cachedMemberships(deps.root, now) ?? [];
+    if (isDefaultCompanyDisabled({ root: deps.root })) {
+        return { status: "disabled", memberships: cached };
+    }
+    let memberships = cachedMemberships(deps.root, now);
+    if (!memberships) {
+        try {
+            memberships = normalizeMemberships(await deps.listMemberships());
+        }
+        catch {
+            return { status: "unavailable", memberships: [] };
+        }
+        // Detect a clear or selection made while the network request was pending.
+        // A stale discovery may update the cache, but must not make a default.
+        const recorded = recordDefaultCompanyMemberships({ checkedAt: now.toISOString(), memberships }, { root: deps.root, now: deps.now });
+        if (recorded.defaultCompany?.source === "disabled") {
+            return { status: "disabled", memberships };
+        }
+        if (recorded.defaultCompany?.enabled) {
+            return { status: "existing", memberships };
+        }
+        configBeforeDiscovery.updatedAt = recorded.updatedAt;
+    }
+    if (memberships.length === 1) {
+        const selected = memberships[0];
+        const next = setAutoDefaultCompany(selected, {
+            root: deps.root,
+            now: deps.now,
+            expectedUpdatedAt: configBeforeDiscovery.updatedAt,
+        });
+        if (next.defaultCompany?.source === "disabled") {
+            return { status: "disabled", memberships };
+        }
+        if (next.defaultCompany?.source !== "auto_single") {
+            return { status: "existing", memberships };
+        }
+        deps.log?.(`Default company set automatically to ${selected.slug}.`);
+        return { status: "auto_single", memberships };
+    }
+    if (memberships.length > 1)
+        return { status: "needs_choice", memberships };
+    return { status: "unavailable", memberships: [] };
+}
+//# sourceMappingURL=default-company.js.map

package/dist/lib/work-context/outbox-quarantine-status-flag.d.ts

@@ -0,0 +1,4 @@
+export declare const OUTBOX_QUARANTINE_STATUS_FLAG = "agents.work-context-outbox-quarantine-status";
+export declare const OUTBOX_QUARANTINE_STATUS_FALLBACK = false;
+export declare function outboxQuarantineStatusEnabled(): boolean;
+//# sourceMappingURL=outbox-quarantine-status-flag.d.ts.map