@agent-relay/factory 0.1.19 → 0.1.21

package/dist/config/local-clone-paths.js

@@ -0,0 +1,188 @@
+import { execFile } from 'node:child_process';
+import { realpath, stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { promisify } from 'node:util';
+import { loadFactoryConfig } from './schema.js';
+const execFileAsync = promisify(execFile);
+/**
+ * Parse a factory config, then apply the environment-dependent conveniences
+ * that are appropriate only for a local CLI run.
+ */
+export async function resolveLocalFactoryConfig(input, options = {}) {
+    const config = loadFactoryConfig(input).factoryConfig;
+    const git = options.git ?? runGit;
+    let resolved = config;
+    if (options.inferFromCwd !== false) {
+        const repoName = cwdInferenceRepoName(input);
+        if (repoName !== undefined) {
+            const repo = config.repos.byLabel[repoName];
+            if (!repo || !isQualifiedRepo(repo)) {
+                throw new Error(`[factory] cannot infer clonePath from cwd: resolved route for repos.names[0] must be owner/name (received ${JSON.stringify(repo ?? repoName)})`);
+            }
+            const checkoutRoot = await gitCheckoutRoot(options.cwd ?? process.cwd(), git, repo);
+            await assertMatchingGithubRemote(checkoutRoot, repo, git);
+            const clonePaths = { ...config.clonePaths, [repo]: checkoutRoot };
+            resolved = {
+                ...config,
+                clonePaths,
+                repos: { ...config.repos, clonePaths },
+            };
+            options.logger?.info?.(`[factory] clonePath inferred from cwd: ${checkoutRoot}`);
+        }
+    }
+    if (options.validateConfiguredCheckouts) {
+        await validateClonePaths(resolved.clonePaths, git);
+    }
+    return resolved;
+}
+async function gitCheckoutRoot(cwd, git, repo) {
+    let root;
+    try {
+        root = (await git(cwd, ['rev-parse', '--show-toplevel'])).trim();
+    }
+    catch {
+        throw new Error(`[factory] cannot infer clonePath for ${repo}: cwd is not inside a git checkout: ${resolve(cwd)}; configure cloneRoot or clonePaths explicitly`);
+    }
+    if (!root) {
+        throw new Error(`[factory] cannot infer clonePath for ${repo}: git returned no checkout root for cwd ${resolve(cwd)}; configure cloneRoot or clonePaths explicitly`);
+    }
+    return resolve(root);
+}
+async function assertMatchingGithubRemote(checkoutRoot, expectedRepo, git) {
+    const remoteNames = (await git(checkoutRoot, ['remote']))
+        .split(/\r?\n/u)
+        .map((name) => name.trim())
+        .filter(Boolean);
+    if (remoteNames.length === 0) {
+        throw new Error(`[factory] cannot infer clonePath for ${expectedRepo}: git checkout ${checkoutRoot} has no remotes; add a matching GitHub remote or configure cloneRoot/clonePaths explicitly`);
+    }
+    const remoteUrls = [];
+    for (const remote of remoteNames) {
+        try {
+            remoteUrls.push(...(await git(checkoutRoot, ['remote', 'get-url', '--all', remote]))
+                .split(/\r?\n/u)
+                .map((url) => url.trim())
+                .filter(Boolean));
+        }
+        catch {
+            // A concurrently removed/broken remote is treated like an unparseable
+            // remote below, yielding one actionable config error.
+        }
+    }
+    const parsedRepos = remoteUrls
+        .map(githubRepoFromRemoteUrl)
+        .filter((repo) => repo !== undefined);
+    if (parsedRepos.some((repo) => repo.toLowerCase() === expectedRepo.toLowerCase()))
+        return;
+    const found = [...new Set(parsedRepos)];
+    const detail = found.length > 0
+        ? `found GitHub remote${found.length === 1 ? '' : 's'} for ${found.join(', ')}`
+        : 'found no parseable GitHub remote URLs';
+    throw new Error(`[factory] cannot infer clonePath for ${expectedRepo}: ${detail} in ${checkoutRoot}; add a matching remote or configure cloneRoot/clonePaths explicitly`);
+}
+export function githubRepoFromRemoteUrl(remoteUrl) {
+    const value = remoteUrl.trim().replace(/^git\+/u, '');
+    let host;
+    let pathname;
+    try {
+        const url = new URL(value);
+        host = url.hostname;
+        pathname = url.pathname;
+    }
+    catch {
+        const scp = /^(?:[^@/\s]+@)?([^:/\s]+):(.+)$/u.exec(value);
+        if (scp) {
+            host = scp[1];
+            pathname = scp[2];
+        }
+        else {
+            const hostPath = /^([^/\s]+)\/(.+)$/u.exec(value);
+            if (!hostPath)
+                return undefined;
+            host = hostPath[1];
+            pathname = hostPath[2];
+        }
+    }
+    if (!['github.com', 'www.github.com'].includes(host.toLowerCase()))
+        return undefined;
+    const parts = pathname
+        .replace(/^\/+|\/+$/gu, '')
+        .replace(/\.git$/iu, '')
+        .split('/')
+        .filter(Boolean);
+    if (parts.length !== 2)
+        return undefined;
+    return `${parts[0]}/${parts[1]}`;
+}
+async function validateClonePaths(clonePaths, git) {
+    for (const [repo, clonePath] of Object.entries(clonePaths)) {
+        const path = resolve(clonePath);
+        let pathStat;
+        try {
+            pathStat = await stat(path);
+        }
+        catch {
+            throw new Error(`[factory] clonePath for ${repo} does not exist: ${path}`);
+        }
+        if (!pathStat.isDirectory()) {
+            throw new Error(`[factory] clonePath for ${repo} is not a directory: ${path}`);
+        }
+        let checkoutRoot;
+        try {
+            checkoutRoot = (await git(path, ['rev-parse', '--show-toplevel'])).trim();
+        }
+        catch {
+            throw new Error(`[factory] clonePath for ${repo} is not a git checkout: ${path}`);
+        }
+        if (!checkoutRoot) {
+            throw new Error(`[factory] clonePath for ${repo} is not a git checkout: ${path}`);
+        }
+        const [realPath, realRoot] = await Promise.all([realpath(path), realpath(resolve(checkoutRoot))]);
+        if (realPath !== realRoot) {
+            throw new Error(`[factory] clonePath for ${repo} points inside a git checkout (${path}); configure the checkout root ${resolve(checkoutRoot)}`);
+        }
+    }
+}
+async function runGit(cwd, args) {
+    const { stdout } = await execFileAsync('git', ['-C', cwd, ...args], {
+        encoding: 'utf8',
+        maxBuffer: 1024 * 1024,
+    });
+    return stdout;
+}
+function cwdInferenceRepoName(input) {
+    const inputRecord = record(input);
+    const factoryInput = record(inputRecord.factoryConfig ?? input);
+    if (hasOwn(factoryInput, 'workspaceConfig') || hasOwn(factoryInput, 'nodeConfig')) {
+        const workspace = record(factoryInput.workspaceConfig);
+        const node = record(factoryInput.nodeConfig);
+        const repos = record(workspace.repos);
+        if (hasClonePathConfig(workspace) || hasClonePathConfig(node) || hasClonePathConfig(repos))
+            return undefined;
+        return singleRepoName(repos.names);
+    }
+    const repos = record(factoryInput.repos);
+    if (hasClonePathConfig(factoryInput) || hasClonePathConfig(repos))
+        return undefined;
+    return singleRepoName(repos.names);
+}
+function hasClonePathConfig(value) {
+    return hasOwn(value, 'cloneRoot') || hasOwn(value, 'clonePaths');
+}
+function singleRepoName(value) {
+    return Array.isArray(value) && value.length === 1 && typeof value[0] === 'string'
+        ? value[0]
+        : undefined;
+}
+function isQualifiedRepo(repo) {
+    return /^[^/\s]+\/[^/\s]+$/u.test(repo);
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+//# sourceMappingURL=local-clone-paths.js.map

package/dist/config/local-clone-paths.js.map

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

package/dist/config/schema.d.ts

@@ -134,20 +134,36 @@ export declare const WorkspaceConfigSchema: z.ZodEffects<z.ZodObject<{
         triage?: string | undefined;
         babysitter?: string | undefined;
     }>>;
+    agentCapabilities: z.ZodDefault<z.ZodObject<{
+        implementer: z.ZodDefault<z.ZodEnum<["spawn:codex", "spawn:claude"]>>;
+        reviewer: z.ZodDefault<z.ZodEnum<["spawn:codex", "spawn:claude"]>>;
+        babysitter: z.ZodDefault<z.ZodEnum<["spawn:codex", "spawn:claude"]>>;
+    }, "strip", z.ZodTypeAny, {
+        implementer: "spawn:codex" | "spawn:claude";
+        reviewer: "spawn:codex" | "spawn:claude";
+        babysitter: "spawn:codex" | "spawn:claude";
+    }, {
+        implementer?: "spawn:codex" | "spawn:claude" | undefined;
+        reviewer?: "spawn:codex" | "spawn:claude" | undefined;
+        babysitter?: "spawn:codex" | "spawn:claude" | undefined;
+    }>>;
     slack: z.ZodOptional<z.ZodObject<{
         channel: z.ZodString;
         style: z.ZodDefault<z.ZodLiteral<"threaded-summarized">>;
         botUserId: z.ZodDefault<z.ZodString>;
+        stakeholderUserIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         staleAfterMs: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         channel: string;
         style: "threaded-summarized";
         botUserId: string;
+        stakeholderUserIds: string[];
         staleAfterMs: number;
     }, {
         channel: string;
         style?: "threaded-summarized" | undefined;
         botUserId?: string | undefined;
+        stakeholderUserIds?: string[] | undefined;
         staleAfterMs?: number | undefined;
     }>>;
     issueSource: z.ZodOptional<z.ZodEnum<["linear", "github"]>>;
@@ -316,6 +332,11 @@ export declare const WorkspaceConfigSchema: z.ZodEffects<z.ZodObject<{
         reviewer?: string | undefined;
         triage?: string | undefined;
     };
+    agentCapabilities: {
+        implementer: "spawn:codex" | "spawn:claude";
+        reviewer: "spawn:codex" | "spawn:claude";
+        babysitter: "spawn:codex" | "spawn:claude";
+    };
     linear: {
         states: {
             readyForAgent?: string | undefined;
@@ -352,6 +373,7 @@ export declare const WorkspaceConfigSchema: z.ZodEffects<z.ZodObject<{
         channel: string;
         style: "threaded-summarized";
         botUserId: string;
+        stakeholderUserIds: string[];
         staleAfterMs: number;
     } | undefined;
     issueSource?: "linear" | "github" | undefined;
@@ -407,10 +429,16 @@ export declare const WorkspaceConfigSchema: z.ZodEffects<z.ZodObject<{
         triage?: string | undefined;
         babysitter?: string | undefined;
     } | undefined;
+    agentCapabilities?: {
+        implementer?: "spawn:codex" | "spawn:claude" | undefined;
+        reviewer?: "spawn:codex" | "spawn:claude" | undefined;
+        babysitter?: "spawn:codex" | "spawn:claude" | undefined;
+    } | undefined;
     slack?: {
         channel: string;
         style?: "threaded-summarized" | undefined;
         botUserId?: string | undefined;
+        stakeholderUserIds?: string[] | undefined;
         staleAfterMs?: number | undefined;
     } | undefined;
     linear?: {
@@ -496,6 +524,11 @@ export declare const WorkspaceConfigSchema: z.ZodEffects<z.ZodObject<{
         reviewer?: string | undefined;
         triage?: string | undefined;
     };
+    agentCapabilities: {
+        implementer: "spawn:codex" | "spawn:claude";
+        reviewer: "spawn:codex" | "spawn:claude";
+        babysitter: "spawn:codex" | "spawn:claude";
+    };
     linear: {
         states: {
             readyForAgent?: string | undefined;
@@ -532,6 +565,7 @@ export declare const WorkspaceConfigSchema: z.ZodEffects<z.ZodObject<{
         channel: string;
         style: "threaded-summarized";
         botUserId: string;
+        stakeholderUserIds: string[];
         staleAfterMs: number;
     } | undefined;
     issueSource?: "linear" | "github" | undefined;
@@ -587,10 +621,16 @@ export declare const WorkspaceConfigSchema: z.ZodEffects<z.ZodObject<{
         triage?: string | undefined;
         babysitter?: string | undefined;
     } | undefined;
+    agentCapabilities?: {
+        implementer?: "spawn:codex" | "spawn:claude" | undefined;
+        reviewer?: "spawn:codex" | "spawn:claude" | undefined;
+        babysitter?: "spawn:codex" | "spawn:claude" | undefined;
+    } | undefined;
     slack?: {
         channel: string;
         style?: "threaded-summarized" | undefined;
         botUserId?: string | undefined;
+        stakeholderUserIds?: string[] | undefined;
         staleAfterMs?: number | undefined;
     } | undefined;
     linear?: {
@@ -651,12 +691,12 @@ export declare const NodeConfigSchema: z.ZodEffects<z.ZodObject<{
     factoryLoopHeartbeatPath?: string | undefined;
     factoryLoopRegistryPath?: string | undefined;
 }>, {
+    cloneRoot: string | undefined;
+    clonePaths: Record<string, string>;
     factoryLoopHeartbeatPath: string | undefined;
     factoryLoopRegistryPath: string | undefined;
-    clonePaths: Record<string, string>;
     capabilities: string[];
     dryRun: boolean;
-    cloneRoot?: string | undefined;
     workspaceId?: string | undefined;
 }, {
     cloneRoot?: string | undefined;
@@ -799,20 +839,36 @@ export declare const FactoryConfigSchema: z.ZodEffects<z.ZodObject<{
         triage?: string | undefined;
         babysitter?: string | undefined;
     }>>;
+    agentCapabilities: z.ZodDefault<z.ZodObject<{
+        implementer: z.ZodDefault<z.ZodEnum<["spawn:codex", "spawn:claude"]>>;
+        reviewer: z.ZodDefault<z.ZodEnum<["spawn:codex", "spawn:claude"]>>;
+        babysitter: z.ZodDefault<z.ZodEnum<["spawn:codex", "spawn:claude"]>>;
+    }, "strip", z.ZodTypeAny, {
+        implementer: "spawn:codex" | "spawn:claude";
+        reviewer: "spawn:codex" | "spawn:claude";
+        babysitter: "spawn:codex" | "spawn:claude";
+    }, {
+        implementer?: "spawn:codex" | "spawn:claude" | undefined;
+        reviewer?: "spawn:codex" | "spawn:claude" | undefined;
+        babysitter?: "spawn:codex" | "spawn:claude" | undefined;
+    }>>;
     slack: z.ZodOptional<z.ZodObject<{
         channel: z.ZodString;
         style: z.ZodDefault<z.ZodLiteral<"threaded-summarized">>;
         botUserId: z.ZodDefault<z.ZodString>;
+        stakeholderUserIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         staleAfterMs: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         channel: string;
         style: "threaded-summarized";
         botUserId: string;
+        stakeholderUserIds: string[];
         staleAfterMs: number;
     }, {
         channel: string;
         style?: "threaded-summarized" | undefined;
         botUserId?: string | undefined;
+        stakeholderUserIds?: string[] | undefined;
         staleAfterMs?: number | undefined;
     }>>;
     issueSource: z.ZodOptional<z.ZodEnum<["linear", "github"]>>;
@@ -990,6 +1046,11 @@ export declare const FactoryConfigSchema: z.ZodEffects<z.ZodObject<{
         reviewer?: string | undefined;
         triage?: string | undefined;
     };
+    agentCapabilities: {
+        implementer: "spawn:codex" | "spawn:claude";
+        reviewer: "spawn:codex" | "spawn:claude";
+        babysitter: "spawn:codex" | "spawn:claude";
+    };
     linear: {
         states: {
             readyForAgent?: string | undefined;
@@ -1029,6 +1090,7 @@ export declare const FactoryConfigSchema: z.ZodEffects<z.ZodObject<{
         channel: string;
         style: "threaded-summarized";
         botUserId: string;
+        stakeholderUserIds: string[];
         staleAfterMs: number;
     } | undefined;
     issueSource?: "linear" | "github" | undefined;
@@ -1088,10 +1150,16 @@ export declare const FactoryConfigSchema: z.ZodEffects<z.ZodObject<{
         triage?: string | undefined;
         babysitter?: string | undefined;
     } | undefined;
+    agentCapabilities?: {
+        implementer?: "spawn:codex" | "spawn:claude" | undefined;
+        reviewer?: "spawn:codex" | "spawn:claude" | undefined;
+        babysitter?: "spawn:codex" | "spawn:claude" | undefined;
+    } | undefined;
     slack?: {
         channel: string;
         style?: "threaded-summarized" | undefined;
         botUserId?: string | undefined;
+        stakeholderUserIds?: string[] | undefined;
         staleAfterMs?: number | undefined;
     } | undefined;
     linear?: {
@@ -1188,6 +1256,11 @@ export declare const FactoryConfigSchema: z.ZodEffects<z.ZodObject<{
         reviewer?: string | undefined;
         triage?: string | undefined;
     };
+    agentCapabilities: {
+        implementer: "spawn:codex" | "spawn:claude";
+        reviewer: "spawn:codex" | "spawn:claude";
+        babysitter: "spawn:codex" | "spawn:claude";
+    };
     linear: {
         states: {
             readyForAgent?: string | undefined;
@@ -1226,6 +1299,7 @@ export declare const FactoryConfigSchema: z.ZodEffects<z.ZodObject<{
         channel: string;
         style: "threaded-summarized";
         botUserId: string;
+        stakeholderUserIds: string[];
         staleAfterMs: number;
     } | undefined;
     issueSource?: "linear" | "github" | undefined;
@@ -1283,10 +1357,16 @@ export declare const FactoryConfigSchema: z.ZodEffects<z.ZodObject<{
         triage?: string | undefined;
         babysitter?: string | undefined;
     } | undefined;
+    agentCapabilities?: {
+        implementer?: "spawn:codex" | "spawn:claude" | undefined;
+        reviewer?: "spawn:codex" | "spawn:claude" | undefined;
+        babysitter?: "spawn:codex" | "spawn:claude" | undefined;
+    } | undefined;
     slack?: {
         channel: string;
         style?: "threaded-summarized" | undefined;
         botUserId?: string | undefined;
+        stakeholderUserIds?: string[] | undefined;
         staleAfterMs?: number | undefined;
     } | undefined;
     linear?: {
@@ -1326,6 +1406,8 @@ export declare const FactoryConfigSchema: z.ZodEffects<z.ZodObject<{
     factoryLoopHeartbeatPath?: string | undefined;
     factoryLoopRegistryPath?: string | undefined;
 }>;
+/** Expand the shell-like home shorthand that Node's filesystem APIs do not. */
+export declare function expandLeadingTilde(value: string, field?: string): string;
 export interface LoadedFactoryConfig {
     workspaceConfig: WorkspaceConfig;
     nodeConfig: NodeConfig;

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,mBAAmB,sFAMtB,CAAA;AACV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAqLnE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgF,CAAA;AAClH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsE,CAAA;AACnG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA4E,CAAA;AA6G5G,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,eAAe,CAAA;IAChC,UAAU,EAAE,UAAU,CAAA;IACtB,aAAa,EAAE,aAAa,CAAA;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAgBrE;AAuDD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AACzD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

package/dist/config/schema.js

@@ -1,3 +1,5 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 import { z } from 'zod';
 // The five workflow-state roles the factory drives an issue through. Each is
 // configured either by name (config.linear.states.<role>, resolved to a
@@ -76,10 +78,28 @@ const modelsSchema = z.object({
     // reviewer's unset (inherit) behavior.
     babysitter: z.string().default('sonnet'),
 }).default({});
+// Which agent CLI backs each spawn role. `models.*` picks the model; this picks
+// the CLI. Restricted to the two spawn capabilities actually wired into
+// capabilityCli (internal-fleet-client.ts) — spawn:opencode / spawn:gemini would
+// resolve to an undefined CLI and are intentionally excluded until mapped.
+// Defaults preserve today's behavior (codex implements, claude reviews/babysits)
+// so existing configs are unaffected unless a role is set explicitly. The map is
+// named agentCapabilities rather than `capabilities` because the node config
+// already owns a top-level `capabilities` (advertised node capability list).
+const spawnCapabilitySchema = z.enum(['spawn:codex', 'spawn:claude']);
+const agentCapabilitiesSchema = z.object({
+    implementer: spawnCapabilitySchema.default('spawn:codex'),
+    reviewer: spawnCapabilitySchema.default('spawn:claude'),
+    babysitter: spawnCapabilitySchema.default('spawn:claude'),
+}).default({});
 const slackSchema = z.object({
     channel: z.string(),
     style: z.literal('threaded-summarized').default('threaded-summarized'),
     botUserId: z.string().default('U0B2596R7EZ'),
+    // Slack user IDs to mention when an agent needs a human decision. Keeping
+    // this explicit avoids guessing that a Linear assignee name is also a Slack
+    // identity, while still making parked questions immediately actionable.
+    stakeholderUserIds: z.array(z.string().min(1)).default([]),
     staleAfterMs: z.number().int().min(1_000).default(10 * 60_000),
 }).optional();
 const babysitterSchema = z.object({
@@ -127,6 +147,7 @@ const WorkspaceConfigObjectSchema = z.object({
     repos: workspaceReposSchema,
     batchSize: z.number().int().min(1).max(5).default(5),
     models: modelsSchema,
+    agentCapabilities: agentCapabilitiesSchema,
     slack: slackSchema,
     // Linear remains the default whenever its issue sub-root is connected. When
     // omitted, the orchestrator probes that sub-root once and falls back to
@@ -191,17 +212,28 @@ function normalizeWorkspaceConfig(cfg) {
     };
 }
 function normalizeNodeConfig(cfg) {
+    const cloneRoot = cfg.cloneRoot === undefined
+        ? undefined
+        : expandLeadingTilde(cfg.cloneRoot, 'cloneRoot');
     return {
         ...cfg,
+        cloneRoot,
+        clonePaths: expandClonePaths(cfg.clonePaths),
         factoryLoopHeartbeatPath: cfg.factoryLoopHeartbeatPath,
         factoryLoopRegistryPath: cfg.factoryLoopRegistryPath,
     };
 }
 function normalizeFactoryConfig(cfg) {
-    const cloneRoot = cfg.cloneRoot ?? cfg.repos.cloneRoot;
+    const topLevelCloneRoot = cfg.cloneRoot === undefined
+        ? undefined
+        : expandLeadingTilde(cfg.cloneRoot, 'cloneRoot');
+    const legacyCloneRoot = cfg.repos.cloneRoot === undefined
+        ? undefined
+        : expandLeadingTilde(cfg.repos.cloneRoot, 'repos.cloneRoot');
+    const cloneRoot = topLevelCloneRoot ?? legacyCloneRoot;
     const explicitClonePaths = {
-        ...cfg.repos.clonePaths,
-        ...cfg.clonePaths,
+        ...expandClonePaths(cfg.repos.clonePaths, 'repos.clonePaths'),
+        ...expandClonePaths(cfg.clonePaths),
     };
     const resolved = resolveRepos(cfg.repos, cloneRoot, explicitClonePaths);
     const labels = resolveSubscriptionLabels(cfg.subscription.labels, cfg.repos.names ?? []);
@@ -244,13 +276,16 @@ function resolveRepos(repos, cloneRoot, explicitClonePaths = repos.clonePaths) {
     // Explicit clonePaths entries win.
     const derivedClonePaths = {};
     if (cloneRoot) {
-        const root = cloneRoot.replace(/\/+$/u, '');
+        const root = expandLeadingTilde(cloneRoot, 'cloneRoot').replace(/\/+$/u, '');
         for (const repo of Object.values(resolvedByLabel)) {
             const repoName = repo.includes('/') ? repo.slice(repo.lastIndexOf('/') + 1) : repo;
             derivedClonePaths[repo] = `${root}/${repoName}`;
         }
     }
-    const resolvedClonePaths = { ...derivedClonePaths, ...explicitClonePaths };
+    const resolvedClonePaths = {
+        ...derivedClonePaths,
+        ...expandClonePaths(explicitClonePaths),
+    };
     return {
         byLabel: resolvedByLabel,
         byProject,
@@ -259,6 +294,23 @@ function resolveRepos(repos, cloneRoot, explicitClonePaths = repos.clonePaths) {
         defaultRepo,
     };
 }
+function expandClonePaths(clonePaths, field = 'clonePaths') {
+    return Object.fromEntries(Object.entries(clonePaths).map(([repo, clonePath]) => [
+        repo,
+        expandLeadingTilde(clonePath, `${field}[${JSON.stringify(repo)}]`),
+    ]));
+}
+/** Expand the shell-like home shorthand that Node's filesystem APIs do not. */
+export function expandLeadingTilde(value, field = 'path') {
+    if (value === '~')
+        return homedir();
+    if (value.startsWith('~/'))
+        return join(homedir(), value.slice(2));
+    if (value.startsWith('~')) {
+        throw new Error(`${field} does not support ~user expansion; use ~ or ~/ instead`);
+    }
+    return value;
+}
 function resolveSubscriptionLabels(labels, repoNames) {
     return labels.length > 0 ? labels : repoNames;
 }
@@ -296,6 +348,10 @@ function combineSplitConfigInput(workspaceInput, nodeInput) {
     const node = asConfigRecord(nodeInput);
     const workspaceRepos = asOptionalConfigRecord(workspace.repos);
     assertCompatibleWorkspaceIds(workspace.workspaceId, node.workspaceId);
+    // Validate tilde syntax in both split halves before node-local values take
+    // precedence, so an overridden ~user path is never silently accepted.
+    validateClonePathSyntax(workspaceRepos, 'workspaceConfig.repos');
+    validateClonePathSyntax(node, 'nodeConfig');
     return {
         ...workspace,
         ...node,
@@ -306,6 +362,16 @@ function combineSplitConfigInput(workspaceInput, nodeInput) {
         },
     };
 }
+function validateClonePathSyntax(input, field) {
+    if (typeof input.cloneRoot === 'string')
+        expandLeadingTilde(input.cloneRoot, `${field}.cloneRoot`);
+    const clonePaths = asOptionalConfigRecord(input.clonePaths);
+    for (const [repo, clonePath] of Object.entries(clonePaths)) {
+        if (typeof clonePath === 'string') {
+            expandLeadingTilde(clonePath, `${field}.clonePaths[${JSON.stringify(repo)}]`);
+        }
+    }
+}
 function assertCompatibleWorkspaceIds(workspaceId, nodeWorkspaceId) {
     if (typeof workspaceId === 'string' &&
         typeof nodeWorkspaceId === 'string' &&