@agent-relay/factory 0.0.0 → 0.1.2

package/dist/linear/state-resolver.js

@@ -0,0 +1,285 @@
+import { FACTORY_STATE_ROLES } from '../config/schema.js';
+// Roles the factory cannot operate without; humanReview is optional (the
+// terminalState falls back to `done` when it is unset).
+const REQUIRED_ROLES = [
+    'readyForAgent',
+    'agentImplementing',
+    'inPlanning',
+    'done',
+];
+const STATES_INDEX_PATH = '/linear/states/_index.json';
+const stateCanonicalPath = (id) => `/linear/states/${id}.json`;
+// Cap concurrent canonical-record reads so a large states catalog can't flood a
+// remote/cloud mount (rate limits, timeouts, fd exhaustion).
+const CATALOG_READ_CONCURRENCY = 10;
+// Build a resolution from explicit, already-known UUIDs (no mount reads). Used
+// as the back-compat / test path when names aren't configured: the global ids
+// apply to every team. Lenient — unresolved roles only throw when used.
+export function stateResolutionFromIds(stateIds, stateNames = {}) {
+    const roleById = new Map();
+    const idByName = new Map();
+    for (const role of FACTORY_STATE_ROLES) {
+        const id = stateIds[role];
+        if (id)
+            roleById.set(id, role);
+        const name = stateNames[role];
+        if (id && name)
+            idByName.set(norm(name), id);
+    }
+    return {
+        idFor(_teamToken, role) {
+            const id = stateIds[role];
+            if (!id)
+                throw new Error(`No resolved Linear state for role "${role}".`);
+            return id;
+        },
+        optionalIdFor(_teamToken, role) {
+            return stateIds[role];
+        },
+        roleOf(stateId) {
+            return stateId ? roleById.get(stateId) : undefined;
+        },
+        isRole(stateId, role) {
+            return Boolean(stateId) && roleById.get(stateId) === role;
+        },
+        idForName(stateName) {
+            return stateName ? idByName.get(norm(stateName)) : undefined;
+        },
+        hasHumanReview() {
+            return Boolean(stateIds.humanReview);
+        },
+    };
+}
+const norm = (value) => (value ?? '').trim().toLowerCase();
+const asArray = (value) => {
+    if (Array.isArray(value))
+        return value;
+    if (value && typeof value === 'object') {
+        const record = value;
+        for (const key of ['entries', 'rows', 'items', 'payload']) {
+            if (Array.isArray(record[key]))
+                return record[key];
+        }
+    }
+    return [];
+};
+const unwrap = (value) => {
+    if (!value || typeof value !== 'object')
+        return {};
+    const record = value;
+    return record.payload && typeof record.payload === 'object'
+        ? record.payload
+        : record;
+};
+const str = (value) => (typeof value === 'string' && value ? value : undefined);
+// Lazily load and cache the /linear/states catalog. Only invoked when at least
+// one role is configured by name, so explicit-UUID setups never read it.
+// The states catalog could not be read at all (e.g. /linear/states unreadable
+// under the mount token). Distinct from a *resolution* failure (ambiguous name,
+// cross-team, no match) so optional roles can tolerate an absent catalog without
+// also swallowing genuine misconfiguration.
+class CatalogUnavailableError extends Error {
+}
+const isCatalogUnavailable = (error) => error instanceof CatalogUnavailableError;
+class StateCatalog {
+    reader;
+    #records;
+    constructor(reader) {
+        this.reader = reader;
+    }
+    async records() {
+        if (this.#records)
+            return this.#records;
+        let index;
+        try {
+            index = (await this.reader.readFile(STATES_INDEX_PATH)).content;
+        }
+        catch (error) {
+            throw new CatalogUnavailableError(`Cannot resolve Linear state names: ${STATES_INDEX_PATH} is unavailable ` +
+                `(${error instanceof Error ? error.message : String(error)}). ` +
+                `Deploy the workflow-states resource or pin stateIds (UUIDs) in config.`);
+        }
+        const ids = asArray(index)
+            .map((row) => str(row?.id))
+            .filter((id) => Boolean(id));
+        // Read canonical records in bounded batches — a workspace can have many
+        // states, and an unbounded Promise.all would flood a remote/cloud mount.
+        const records = [];
+        for (let i = 0; i < ids.length; i += CATALOG_READ_CONCURRENCY) {
+            const batch = await Promise.all(ids.slice(i, i + CATALOG_READ_CONCURRENCY).map(async (id) => {
+                try {
+                    const rec = unwrap((await this.reader.readFile(stateCanonicalPath(id))).content);
+                    return { id, name: str(rec.name), teamKey: str(rec.team_key), teamName: str(rec.team_name) };
+                }
+                catch {
+                    return { id };
+                }
+            }));
+            records.push(...batch);
+        }
+        this.#records = records;
+        return records;
+    }
+    // Resolve a state NAME to a UUID, optionally scoped to a team token (matched
+    // against team_key or team_name). Throws on no match or ambiguity.
+    async resolve(name, teamToken) {
+        const records = await this.records();
+        let matches = records.filter((rec) => norm(rec.name) === norm(name));
+        if (teamToken) {
+            // Restrict to states that belong to this team (or are team-less). Never
+            // fall back to another team's state of the same name — that would silently
+            // mis-route issues across teams. If nothing remains, it's a hard no-match.
+            const teamless = (rec) => !rec.teamKey && !rec.teamName;
+            const inTeam = (rec) => norm(rec.teamKey) === norm(teamToken) || norm(rec.teamName) === norm(teamToken);
+            matches = matches.filter((rec) => inTeam(rec) || teamless(rec));
+            const scoped = matches.filter(inTeam);
+            if (scoped.length > 0)
+                matches = scoped;
+        }
+        if (matches.length === 0) {
+            throw new Error(`No Linear workflow state named "${name}"${teamToken ? ` for team "${teamToken}"` : ''}.`);
+        }
+        if (matches.length > 1) {
+            throw new Error(`Linear workflow state "${name}" is ambiguous (${matches.length} matches)` +
+                `${teamToken ? ` for team "${teamToken}"` : ''}; scope it with linear.statesByTeam.`);
+        }
+        return matches[0].id;
+    }
+}
+// Resolve every configured role for every known team to concrete UUIDs, building
+// the forward (team,role)->id map and the reverse id->role map. Throws if a
+// required role cannot be resolved for any team.
+export async function resolveFactoryStates(reader, input) {
+    const catalog = new StateCatalog(reader);
+    const globalNames = input.states ?? {};
+    const explicitIds = input.stateIds ?? {};
+    // Normalize statesByTeam keys up front so per-team lookups are case-insensitive
+    // and consistent with how byTeam/teamTokens are keyed (avoids a lowercase
+    // team token silently missing an uppercase override, then overwriting it).
+    const byTeamNames = {};
+    for (const [team, names] of Object.entries(input.statesByTeam ?? {})) {
+        byTeamNames[norm(team)] = names;
+    }
+    // Resolve one role for one team token, applying precedence:
+    // per-team name > global name > explicit UUID. When a name is configured but
+    // the states catalog is unavailable (e.g. /linear/states unreadable under the
+    // mount token), fall back to the pinned UUID rather than failing startup — the
+    // name still feeds the reverse name->id map below for read-side backfill.
+    // `tolerant` is for the team-less default pass when subscribed teams exist:
+    // each team is resolved authoritatively below, so a team-less ambiguity must
+    // not abort startup (addresses the global-default-forces-teamless-lookup P1).
+    const resolveRole = async (teamToken, role, tolerant) => {
+        const perTeamName = teamToken ? byTeamNames[norm(teamToken)]?.[role] : undefined;
+        const name = perTeamName ?? globalNames[role];
+        if (name) {
+            try {
+                return await catalog.resolve(name, teamToken);
+            }
+            catch (error) {
+                // Fall back to the pinned UUID when the catalog can't resolve the name.
+                if (explicitIds[role])
+                    return explicitIds[role];
+                // Best-effort team-less default pass: another team will fill this role.
+                if (tolerant)
+                    return undefined;
+                // An OPTIONAL role (e.g. humanReview) tolerates an *absent* catalog
+                // (no /linear/states under the mount token) — but a real resolution
+                // failure (ambiguous name, cross-team, no match) must still surface, even
+                // for optional roles, rather than silently disabling the role.
+                if (!REQUIRED_ROLES.includes(role) && isCatalogUnavailable(error))
+                    return undefined;
+                throw error;
+            }
+        }
+        return explicitIds[role];
+    };
+    // Dedupe team tokens by normalized form while keeping the first original
+    // casing for resolution + error messages.
+    const teamTokenByNorm = new Map();
+    for (const team of [...Object.keys(input.statesByTeam ?? {}), ...(input.teams ?? [])]) {
+        const key = norm(team);
+        if (key && !teamTokenByNorm.has(key))
+            teamTokenByNorm.set(key, team);
+    }
+    const byTeam = new Map();
+    const resolveAllRoles = async (teamToken, enforce, tolerant = false) => {
+        const resolved = {};
+        for (const role of FACTORY_STATE_ROLES) {
+            const id = await resolveRole(teamToken, role, tolerant);
+            if (id)
+                resolved[role] = id;
+        }
+        const missing = REQUIRED_ROLES.filter((role) => !resolved[role]);
+        if (enforce && missing.length > 0) {
+            throw new Error(`Linear state resolution incomplete${teamToken ? ` for team "${teamToken}"` : ''}: ` +
+                `missing [${missing.join(', ')}]. Set linear.states / linear.statesByTeam (by name) or stateIds (UUIDs).`);
+        }
+        return resolved;
+    };
+    // The team-less default only needs to satisfy required roles when there's
+    // global config meant to fill it; a per-team-only setup leaves it best-effort
+    // (each subscribed team is enforced below, and idFor() throws at use if an
+    // unconfigured team's issue ever appears).
+    //
+    // When teams ARE configured, the team-less default pass is tolerant: the
+    // factory's default `linear.states` names are global, so resolving them
+    // team-lessly would be ambiguous in a multi-team workspace and wrongly fail
+    // startup — even though each subscribed team resolves cleanly. Per-team passes
+    // (below) are authoritative; the team-less default is only a fallback.
+    const hasGlobalConfig = Object.keys(globalNames).length > 0 || Object.keys(explicitIds).length > 0;
+    const hasTeamScopes = teamTokenByNorm.size > 0;
+    const defaultIds = await resolveAllRoles(undefined, hasGlobalConfig && !hasTeamScopes, hasTeamScopes);
+    for (const [key, team] of teamTokenByNorm) {
+        byTeam.set(key, await resolveAllRoles(team, true));
+    }
+    const idsFor = (teamToken) => (teamToken ? byTeam.get(norm(teamToken)) : undefined) ?? defaultIds;
+    // Reverse map across the default + every team mapping.
+    const roleById = new Map();
+    for (const ids of [defaultIds, ...byTeam.values()]) {
+        for (const role of FACTORY_STATE_ROLES) {
+            const id = ids[role];
+            if (id)
+                roleById.set(id, role);
+        }
+    }
+    // Reverse name->id map: lets a read path backfill the state UUID for issues
+    // whose synced payload only carries `state.name` (relayfile-adapters#205).
+    // Built from configured names paired with their resolved UUID (global + team).
+    const idByName = new Map();
+    const recordNames = (names, ids) => {
+        for (const role of FACTORY_STATE_ROLES) {
+            const name = names[role];
+            const id = ids[role];
+            if (name && id)
+                idByName.set(norm(name), id);
+        }
+    };
+    recordNames(globalNames, defaultIds);
+    for (const [key, team] of teamTokenByNorm) {
+        recordNames(byTeamNames[key] ?? {}, byTeam.get(key) ?? {});
+    }
+    return {
+        idFor(teamToken, role) {
+            const id = idsFor(teamToken)[role];
+            if (!id)
+                throw new Error(`No resolved Linear state for role "${role}"${teamToken ? ` (team "${teamToken}")` : ''}.`);
+            return id;
+        },
+        optionalIdFor(teamToken, role) {
+            return idsFor(teamToken)[role];
+        },
+        roleOf(stateId) {
+            return stateId ? roleById.get(stateId) : undefined;
+        },
+        isRole(stateId, role) {
+            return Boolean(stateId) && roleById.get(stateId) === role;
+        },
+        idForName(stateName) {
+            return stateName ? idByName.get(norm(stateName)) : undefined;
+        },
+        hasHumanReview(teamToken) {
+            return Boolean(idsFor(teamToken).humanReview);
+        },
+    };
+}
+//# sourceMappingURL=state-resolver.js.map

package/dist/linear/state-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-resolver.js","sourceRoot":"","sources":["../../src/linear/state-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAyB,MAAM,kBAAkB,CAAA;AAE7E,yEAAyE;AACzE,wDAAwD;AACxD,MAAM,cAAc,GAAgC;IAClD,eAAe;IACf,mBAAmB;IACnB,YAAY;IACZ,MAAM;CACP,CAAA;AAED,MAAM,iBAAiB,GAAG,4BAA4B,CAAA;AACtD,MAAM,kBAAkB,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,kBAAkB,EAAE,OAAO,CAAA;AAE9E,gFAAgF;AAChF,6DAA6D;AAC7D,MAAM,wBAAwB,GAAG,EAAE,CAAA;AAyCnC,+EAA+E;AAC/E,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,UAAU,sBAAsB,CAAC,QAAiB,EAAE,aAAwB,EAAE;IAClF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAA;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC1C,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QACzB,IAAI,EAAE;YAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAC7B,IAAI,EAAE,IAAI,IAAI;YAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO;QACL,KAAK,CAAC,UAAU,EAAE,IAAI;YACpB,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YACzB,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,IAAI,CAAC,CAAA;YACxE,OAAO,EAAE,CAAA;QACX,CAAC;QACD,aAAa,CAAC,UAAU,EAAE,IAAI;YAC5B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;QACD,MAAM,CAAC,OAAO;YACZ,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACpD,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,IAAI;YAClB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAiB,CAAC,KAAK,IAAI,CAAA;QACrE,CAAC;QACD,SAAS,CAAC,SAAS;YACjB,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC9D,CAAC;QACD,cAAc;YACZ,OAAO,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;QACtC,CAAC;KACF,CAAA;AACH,CAAC;AASD,MAAM,IAAI,GAAG,CAAC,KAAyB,EAAU,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AAEtF,MAAM,OAAO,GAAG,CAAC,KAAc,EAAa,EAAE;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;YAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,MAAM,CAAC,GAAG,CAAc,CAAA;QACjE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AAED,MAAM,MAAM,GAAG,CAAC,KAAc,EAA2B,EAAE;IACzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IAClD,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,OAAO,MAAM,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QACzD,CAAC,CAAE,MAAM,CAAC,OAAmC;QAC7C,CAAC,CAAC,MAAM,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,GAAG,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AAE5G,+EAA+E;AAC/E,yEAAyE;AACzE,8EAA8E;AAC9E,gFAAgF;AAChF,iFAAiF;AACjF,4CAA4C;AAC5C,MAAM,uBAAwB,SAAQ,KAAK;CAAG;AAE9C,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK,YAAY,uBAAuB,CAAA;AAElG,MAAM,YAAY;IAEa;IAD7B,QAAQ,CAA2B;IACnC,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1D,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAA;QACvC,IAAI,KAAc,CAAA;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAA;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAC/B,sCAAsC,iBAAiB,kBAAkB;gBACzE,IAAI,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK;gBAC/D,wEAAwE,CACzE,CAAA;QACH,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC;aACvB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAE,GAA+B,EAAE,EAAE,CAAC,CAAC;aACvD,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5C,wEAAwE;QACxE,yEAAyE;QACzE,MAAM,OAAO,GAAkB,EAAE,CAAA;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,wBAAwB,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,wBAAwB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAwB,EAAE;gBAChF,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;oBAChF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAA;gBAC9F,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,EAAE,EAAE,EAAE,CAAA;gBACf,CAAC;YACH,CAAC,CAAC,CACH,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;QACxB,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,6EAA6E;IAC7E,mEAAmE;IACnE,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,SAA6B;QACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACpC,IAAI,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACpE,IAAI,SAAS,EAAE,CAAC;YACd,wEAAwE;YACxE,2EAA2E;YAC3E,2EAA2E;YAC3E,MAAM,QAAQ,GAAG,CAAC,GAAgB,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAA;YACpE,MAAM,MAAM,GAAG,CAAC,GAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAA;YACpH,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;YAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACrC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,GAAG,MAAM,CAAA;QACzC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,cAAc,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAC5G,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,mBAAmB,OAAO,CAAC,MAAM,WAAW;gBAC1E,GAAG,SAAS,CAAC,CAAC,CAAC,cAAc,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,sCAAsC,CACrF,CAAA;QACH,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACtB,CAAC;CACF;AAED,iFAAiF;AACjF,4EAA4E;AAC5E,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAyB,EACzB,KAAgC;IAEhC,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAA;IACxC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAA;IACxC,gFAAgF;IAChF,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,WAAW,GAA8B,EAAE,CAAA;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAA;IACjC,CAAC;IAED,4DAA4D;IAC5D,6EAA6E;IAC7E,8EAA8E;IAC9E,+EAA+E;IAC/E,0EAA0E;IAC1E,4EAA4E;IAC5E,6EAA6E;IAC7E,8EAA8E;IAC9E,MAAM,WAAW,GAAG,KAAK,EACvB,SAA6B,EAC7B,IAAsB,EACtB,QAAiB,EACY,EAAE;QAC/B,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAChF,MAAM,IAAI,GAAG,WAAW,IAAI,WAAW,CAAC,IAAI,CAAC,CAAA;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;YAC/C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,wEAAwE;gBACxE,IAAI,WAAW,CAAC,IAAI,CAAC;oBAAE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAA;gBAC/C,wEAAwE;gBACxE,IAAI,QAAQ;oBAAE,OAAO,SAAS,CAAA;gBAC9B,oEAAoE;gBACpE,oEAAoE;gBACpE,0EAA0E;gBAC1E,+DAA+D;gBAC/D,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,KAAK,CAAC;oBAAE,OAAO,SAAS,CAAA;gBACnF,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC,CAAA;IAED,yEAAyE;IACzE,0CAA0C;IAC1C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAA;IACjD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QACtB,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACtE,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAA;IAEzC,MAAM,eAAe,GAAG,KAAK,EAC3B,SAA6B,EAC7B,OAAgB,EAChB,QAAQ,GAAG,KAAK,EACE,EAAE;QACpB,MAAM,QAAQ,GAAY,EAAE,CAAA;QAC5B,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;YACvC,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;YACvD,IAAI,EAAE;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;QAC7B,CAAC;QACD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;QAChE,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,qCAAqC,SAAS,CAAC,CAAC,CAAC,cAAc,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;gBACpF,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,2EAA2E,CAC1G,CAAA;QACH,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAA;IAED,0EAA0E;IAC1E,8EAA8E;IAC9E,2EAA2E;IAC3E,2CAA2C;IAC3C,EAAE;IACF,yEAAyE;IACzE,wEAAwE;IACxE,4EAA4E;IAC5E,+EAA+E;IAC/E,uEAAuE;IACvE,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAClG,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,GAAG,CAAC,CAAA;IAC9C,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,eAAe,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;IACrG,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,SAA6B,EAAW,EAAE,CACxD,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,UAAU,CAAA;IAErE,uDAAuD;IACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAA;IACpD,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;YACvC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;YACpB,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,+EAA+E;IAC/E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC1C,MAAM,WAAW,GAAG,CAAC,KAAgB,EAAE,GAAY,EAAQ,EAAE;QAC3D,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;YACxB,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;YACpB,IAAI,IAAI,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC,CAAA;IACD,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5D,CAAC;IAED,OAAO;QACL,KAAK,CAAC,SAAS,EAAE,IAAI;YACnB,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAA;YAClC,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,WAAW,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YACpH,OAAO,EAAE,CAAA;QACX,CAAC;QACD,aAAa,CAAC,SAAS,EAAE,IAAI;YAC3B,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAA;QAChC,CAAC;QACD,MAAM,CAAC,OAAO;YACZ,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACpD,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,IAAI;YAClB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAiB,CAAC,KAAK,IAAI,CAAA;QACrE,CAAC;QACD,SAAS,CAAC,SAAS;YACjB,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC9D,CAAC;QACD,cAAc,CAAC,SAAS;YACtB,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAA;QAC/C,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/mount/local-mount-preflight.d.ts

@@ -0,0 +1,9 @@
+interface EnsureLocalMountOptions {
+    stateWaitTimeoutMs?: number;
+    stateWaitPollMs?: number;
+    acceptableWorkspaceIds?: readonly string[];
+    refreshStaleMount?: boolean;
+}
+export declare function ensureLocalMount(workspaceId: string, startDir: string, options?: EnsureLocalMountOptions): Promise<void>;
+export {};
+//# sourceMappingURL=local-mount-preflight.d.ts.map

package/dist/mount/local-mount-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-mount-preflight.d.ts","sourceRoot":"","sources":["../../src/mount/local-mount-preflight.ts"],"names":[],"mappings":"AAiBA,UAAU,uBAAuB;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;IAIxB,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAM1C,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/mount/local-mount-preflight.js

@@ -0,0 +1,149 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { spawn } from 'node:child_process';
+import { checkMountStaleness, coercePid, resolveRelayfileCli, resolveRelayfileMountBinary } from './relayfile-binary.js';
+const STATE_FILE = '.integrations/.relay/state.json';
+// How long to wait for a freshly-spawned mount to write a valid state.json
+// (workspace match + a live pid). A CLI mount over a large `.integrations` tree
+// can take well over 10s to complete its FIRST reconcile (early cycles hit
+// `context deadline exceeded` while it materializes the tree), so a 10s wait
+// reported a spurious "did not become ready" on a mount that was simply still
+// bootstrapping. 60s covers that without blocking startup indefinitely. Callers
+// can still override via `stateWaitTimeoutMs`.
+const DEFAULT_STATE_READY_TIMEOUT_MS = 60_000;
+export async function ensureLocalMount(workspaceId, startDir, options = {}) {
+    const stateFilePath = join(startDir, STATE_FILE);
+    if (!(await isMountStatePresent(stateFilePath))) {
+        await spawnMount(workspaceId, startDir);
+        await waitForStateFile(stateFilePath, workspaceId, options.stateWaitTimeoutMs, options.stateWaitPollMs, options.acceptableWorkspaceIds);
+        return;
+    }
+    const staleness = checkMountStaleness(stateFilePath, workspaceId, options.acceptableWorkspaceIds);
+    if (!staleness.stale)
+        return;
+    const suffix = staleness.reason !== undefined ? ` (${staleness.reason})` : '';
+    const manualHint = `Run: relayfile stop && relayfile start ${workspaceId} .integrations --background`;
+    if (options.refreshStaleMount === false) {
+        process.stderr.write(`[factory] local mount is stale${suffix}; writeback may not propagate. ${manualHint}\n`);
+        return;
+    }
+    // Self-heal: re-spawn the mount so writebacks propagate, rather than silently
+    // shipping them into a stale mirror. spawnMount runs the relayfile-mount
+    // binary with --rehome, which re-establishes the mount in place.
+    process.stderr.write(`[factory] local mount is stale${suffix}; refreshing\n`);
+    try {
+        await spawnMount(workspaceId, startDir);
+        await waitForStateFile(stateFilePath, workspaceId, options.stateWaitTimeoutMs, options.stateWaitPollMs, options.acceptableWorkspaceIds);
+        process.stderr.write('[factory] local mount refreshed\n');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[factory] local mount is stale${suffix} and auto-refresh failed (${reason}); writeback may not propagate. ${manualHint}\n`);
+    }
+}
+async function isMountStatePresent(stateFilePath) {
+    try {
+        const raw = await readFile(stateFilePath, 'utf8');
+        JSON.parse(raw);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function spawnMount(workspaceId, startDir) {
+    // Prefer the relayfile CLI: it resolves workspace credentials itself (the raw
+    // relayfile-mount binary requires a --token the factory has no clean way to
+    // supply) and bundles an up-to-date mount, so the factory can self-start the
+    // writeback mount unattended. Fall back to the raw binary only when no CLI is
+    // available.
+    const cli = resolveRelayfileCli();
+    if (cli) {
+        await spawnMountViaCli(cli, workspaceId, startDir);
+        return;
+    }
+    await spawnMountViaRawBinary(workspaceId, startDir);
+}
+async function spawnMountViaCli(cli, workspaceId, startDir) {
+    // Best-effort stop first so a stale/dead mount registration does not make
+    // `start` reject (matches the documented `relayfile stop && relayfile start`
+    // recovery). A no-op when nothing is mounted here.
+    await runRelayfile(cli, ['stop'], startDir, workspaceId).catch(() => { });
+    await runRelayfile(cli, ['start', workspaceId, '.integrations', '--background'], startDir, workspaceId);
+}
+async function spawnMountViaRawBinary(workspaceId, startDir) {
+    // Search from the deployment dir (where factory.config.json + the bundled
+    // @relayfile/mount live), not this module's install location.
+    const binaryPath = resolveRelayfileMountBinary(startDir);
+    await runRelayfile(binaryPath, ['start', workspaceId, '.integrations', '--background', '--rehome'], startDir, workspaceId);
+}
+function runRelayfile(command, args, startDir, workspaceId) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: startDir,
+            stdio: ['ignore', 'ignore', 'pipe'],
+        });
+        const stderrChunks = [];
+        if (child.stderr) {
+            child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+        }
+        child.on('close', (code) => {
+            const stderr = Buffer.concat(stderrChunks).toString('utf8');
+            if (isAuthError(stderr)) {
+                reject(new Error(`[factory] relayfile mount not authorized — run: relayfile workspace join ${workspaceId} --write`));
+                return;
+            }
+            if (code !== 0) {
+                reject(new Error(`[factory] relayfile mount ${args[0]} failed (exit ${code ?? 'null'}): ${stderr.trim()}`));
+                return;
+            }
+            resolve();
+        });
+        child.on('error', (err) => {
+            reject(new Error(`[factory] relayfile mount ${args[0]} error: ${err.message}`));
+        });
+    });
+}
+async function waitForStateFile(stateFilePath, workspaceId, timeoutMs = DEFAULT_STATE_READY_TIMEOUT_MS, pollMs = 200, acceptableWorkspaceIds = []) {
+    const deadline = Date.now() + timeoutMs;
+    let lastInvalidReason = 'state file was not created';
+    while (Date.now() < deadline) {
+        try {
+            const raw = await readFile(stateFilePath, 'utf8');
+            const state = JSON.parse(raw);
+            if (isValidMountState(state, workspaceId, acceptableWorkspaceIds))
+                return;
+            lastInvalidReason = `state file is malformed or for another workspace: ${stateFilePath}`;
+        }
+        catch (error) {
+            if (typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT') {
+                lastInvalidReason = 'state file was not created';
+            }
+            else {
+                lastInvalidReason = error instanceof Error ? error.message : String(error);
+            }
+            // not yet present
+        }
+        await sleep(pollMs);
+    }
+    throw new Error(`[factory] relayfile mount did not become ready within ${timeoutMs}ms (${lastInvalidReason})`);
+}
+function isValidMountState(value, workspaceId, acceptableWorkspaceIds = []) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const state = value;
+    const accepted = new Set([workspaceId, ...acceptableWorkspaceIds]);
+    // A CLI-daemonized mount (`relayfile start --background`) records its pid under
+    // `daemon.pid`, not the top-level `pid` — accept either, matching
+    // checkMountStaleness (else a freshly-started CLI mount is never confirmed ready).
+    const pid = coercePid(state.pid) ?? coercePid(state.daemon?.pid);
+    return typeof state.workspaceId === 'string' && accepted.has(state.workspaceId) &&
+        typeof state.lastReconcileAt === 'string' &&
+        Number.isFinite(Date.parse(state.lastReconcileAt)) &&
+        pid !== undefined;
+}
+const isAuthError = (stderr) => stderr.includes('workspace join') ||
+    stderr.includes('unauthorized') ||
+    stderr.includes('no credentials');
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//# sourceMappingURL=local-mount-preflight.js.map

package/dist/mount/local-mount-preflight.js.map

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

package/dist/mount/relayfile-binary.d.ts

@@ -0,0 +1,9 @@
+export declare function coercePid(value: unknown): number | undefined;
+export declare function resolveRelayfileMountBinary(startDir?: string): string;
+export declare function resolveRelayfileCli(): string | undefined;
+export declare function checkMountStaleness(stateFilePath: string, workspaceId: string, acceptableWorkspaceIds?: readonly string[]): {
+    stale: boolean;
+    reason?: string;
+    pid?: number;
+};
+//# sourceMappingURL=relayfile-binary.d.ts.map

package/dist/mount/relayfile-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayfile-binary.d.ts","sourceRoot":"","sources":["../../src/mount/relayfile-binary.ts"],"names":[],"mappings":"AAqBA,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE5D;AAgED,wBAAgB,2BAA2B,CAAC,QAAQ,SAAa,GAAG,MAAM,CAqBzE;AAWD,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAYxD;AAED,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAKnB,sBAAsB,GAAE,SAAS,MAAM,EAAO,GAC7C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CA8DnD"}