@s_s/harmonia 1.2.0 → 1.4.0

package/build/core/dispatch.js

@@ -1,7 +1,9 @@
 /**
  * Dispatch & Session tracking — manages:
- *   <data_dir>/<project_name>/iter-<n>/sessions.json
- *   <data_dir>/<project_name>/iter-<n>/dispatches.json
+ *   <context_dir>/sessions.json
+ *   <context_dir>/dispatches.json
+ *
+ * context_dir is typically iter-<n>/ or patch-<n>/ under the project data dir.
  *
  * Sessions represent agent instances (can be reused across dispatches).
  * Dispatches represent individual task assignments to a role.
@@ -9,27 +11,26 @@
  */
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
-import { getIterationDir } from './registry.js';
 const SESSIONS_FILE = 'sessions.json';
 const DISPATCHES_FILE = 'dispatches.json';
-function sessionsPath(projectName, iteration) {
-    return join(getIterationDir(projectName, iteration), SESSIONS_FILE);
+function sessionsPath(projectName, iteration, contextDir) {
+    return join(contextDir, SESSIONS_FILE);
 }
-function dispatchesPath(projectName, iteration) {
-    return join(getIterationDir(projectName, iteration), DISPATCHES_FILE);
+function dispatchesPath(projectName, iteration, contextDir) {
+    return join(contextDir, DISPATCHES_FILE);
 }
 // ─── Session CRUD ───
-export async function readSessions(projectName, iteration) {
+export async function readSessions(projectName, iteration, contextDir) {
     try {
-        const content = await readFile(sessionsPath(projectName, iteration), 'utf-8');
+        const content = await readFile(sessionsPath(projectName, iteration, contextDir), 'utf-8');
         return JSON.parse(content);
     }
     catch {
         return [];
     }
 }
-async function writeSessions(projectName, iteration, sessions) {
-    const filePath = sessionsPath(projectName, iteration);
+async function writeSessions(projectName, iteration, sessions, contextDir) {
+    const filePath = sessionsPath(projectName, iteration, contextDir);
     await mkdir(dirname(filePath), { recursive: true });
     await writeFile(filePath, JSON.stringify(sessions, null, 2) + '\n', 'utf-8');
 }
@@ -37,8 +38,8 @@ function nextSessionId(sessions) {
     const num = sessions.length + 1;
     return `ses-${String(num).padStart(3, '0')}`;
 }
-export async function createSession(projectName, iteration, role, agentType, label) {
-    const sessions = await readSessions(projectName, iteration);
+export async function createSession(projectName, iteration, role, agentType, label, contextDir) {
+    const sessions = await readSessions(projectName, iteration, contextDir);
     const now = new Date().toISOString();
     const session = {
         id: nextSessionId(sessions),
@@ -50,11 +51,11 @@ export async function createSession(projectName, iteration, role, agentType, lab
         lastActiveAt: now,
     };
     sessions.push(session);
-    await writeSessions(projectName, iteration, sessions);
+    await writeSessions(projectName, iteration, sessions, contextDir);
     return session;
 }
-export async function updateSession(projectName, iteration, sessionId, updates) {
-    const sessions = await readSessions(projectName, iteration);
+export async function updateSession(projectName, iteration, sessionId, updates, contextDir) {
+    const sessions = await readSessions(projectName, iteration, contextDir);
     const session = sessions.find((s) => s.id === sessionId);
     if (!session) {
         throw new Error(`Session "${sessionId}" not found in project "${projectName}"`);
@@ -68,15 +69,15 @@ export async function updateSession(projectName, iteration, sessionId, updates)
     if (updates.label !== undefined)
         session.label = updates.label;
     session.lastActiveAt = new Date().toISOString();
-    await writeSessions(projectName, iteration, sessions);
+    await writeSessions(projectName, iteration, sessions, contextDir);
     return session;
 }
 /**
  * Find an idle session for a given role (for session reuse).
  * Returns the most recently active idle session, or null if none found.
  */
-export async function findIdleSession(projectName, iteration, role) {
-    const sessions = await readSessions(projectName, iteration);
+export async function findIdleSession(projectName, iteration, role, contextDir) {
+    const sessions = await readSessions(projectName, iteration, contextDir);
     const idle = sessions
         .filter((s) => s.role === role && s.status === 'idle')
         .sort((a, b) => b.lastActiveAt.localeCompare(a.lastActiveAt));
@@ -85,22 +86,22 @@ export async function findIdleSession(projectName, iteration, role) {
 /**
  * Find a session by its agent session ID (for correlating external sessions).
  */
-export async function findSessionByAgentId(projectName, iteration, role, agentSessionId) {
-    const sessions = await readSessions(projectName, iteration);
+export async function findSessionByAgentId(projectName, iteration, role, agentSessionId, contextDir) {
+    const sessions = await readSessions(projectName, iteration, contextDir);
     return sessions.find((s) => s.role === role && s.agentSessionId === agentSessionId) ?? null;
 }
 // ─── Dispatch CRUD ───
-export async function readDispatches(projectName, iteration) {
+export async function readDispatches(projectName, iteration, contextDir) {
     try {
-        const content = await readFile(dispatchesPath(projectName, iteration), 'utf-8');
+        const content = await readFile(dispatchesPath(projectName, iteration, contextDir), 'utf-8');
         return JSON.parse(content);
     }
     catch {
         return [];
     }
 }
-async function writeDispatches(projectName, iteration, dispatches) {
-    const filePath = dispatchesPath(projectName, iteration);
+async function writeDispatches(projectName, iteration, dispatches, contextDir) {
+    const filePath = dispatchesPath(projectName, iteration, contextDir);
     await mkdir(dirname(filePath), { recursive: true });
     await writeFile(filePath, JSON.stringify(dispatches, null, 2) + '\n', 'utf-8');
 }
@@ -108,8 +109,8 @@ function nextDispatchId(dispatches) {
     const num = dispatches.length + 1;
     return `dispatch-${String(num).padStart(3, '0')}`;
 }
-export async function createDispatch(projectName, iteration, role, taskBrief, expectedOutputs, sessionId) {
-    const dispatches = await readDispatches(projectName, iteration);
+export async function createDispatch(projectName, iteration, role, taskBrief, expectedOutputs, sessionId, contextDir, nodeId) {
+    const dispatches = await readDispatches(projectName, iteration, contextDir);
     const now = new Date().toISOString();
     const dispatch = {
         id: nextDispatchId(dispatches),
@@ -120,13 +121,14 @@ export async function createDispatch(projectName, iteration, role, taskBrief, ex
         createdAt: now,
         updatedAt: now,
         ...(sessionId ? { sessionId } : {}),
+        ...(nodeId ? { nodeId } : {}),
     };
     dispatches.push(dispatch);
-    await writeDispatches(projectName, iteration, dispatches);
+    await writeDispatches(projectName, iteration, dispatches, contextDir);
     return dispatch;
 }
-export async function updateDispatch(projectName, iteration, dispatchId, updates) {
-    const dispatches = await readDispatches(projectName, iteration);
+export async function updateDispatch(projectName, iteration, dispatchId, updates, contextDir) {
+    const dispatches = await readDispatches(projectName, iteration, contextDir);
     const dispatch = dispatches.find((d) => d.id === dispatchId);
     if (!dispatch) {
         throw new Error(`Dispatch "${dispatchId}" not found in project "${projectName}"`);
@@ -143,14 +145,14 @@ export async function updateDispatch(projectName, iteration, dispatchId, updates
     if (updates.note !== undefined)
         dispatch.note = updates.note;
     dispatch.updatedAt = now;
-    await writeDispatches(projectName, iteration, dispatches);
+    await writeDispatches(projectName, iteration, dispatches, contextDir);
     return dispatch;
 }
 /**
  * Get a single dispatch record by ID.
  */
-export async function getDispatch(projectName, iteration, dispatchId) {
-    const dispatches = await readDispatches(projectName, iteration);
+export async function getDispatch(projectName, iteration, dispatchId, contextDir) {
+    const dispatches = await readDispatches(projectName, iteration, contextDir);
     return dispatches.find((d) => d.id === dispatchId) ?? null;
 }
 // ─── Dispatch State Machine ───
@@ -174,4 +176,12 @@ export function isValidTransition(from, to) {
 export function isTerminalStatus(status) {
     return DISPATCH_TRANSITIONS[status].length === 0;
 }
+/**
+ * Check if a role has any running dispatches (status: 'dispatched' or 'running').
+ * Used by parallel dispatch logic to decide whether to force a new session.
+ */
+export async function hasRunningDispatch(projectName, iteration, role, contextDir) {
+    const dispatches = await readDispatches(projectName, iteration, contextDir);
+    return dispatches.some((d) => d.role === role && (d.status === 'dispatched' || d.status === 'running'));
+}
 //# sourceMappingURL=dispatch.js.map

package/build/core/dispatch.js.map

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

package/build/core/issues.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Issue tracking — manages <data_dir>/<project_name>/issues.json
+ *
+ * Issues are project-level (not per-iteration/patch). They track problems
+ * discovered during testing or from user feedback, and can be linked to
+ * the patch or iteration that resolves them.
+ */
+import type { Issue, IssueResolvedBy, IssueSource, IssueStatus } from './types.js';
+/**
+ * Read all issues for a project. Returns empty array if file doesn't exist.
+ */
+export declare function readIssues(projectName: string): Promise<Issue[]>;
+/**
+ * Create a new issue. Auto-generates an incremental ID.
+ *
+ * @returns The created issue
+ */
+export declare function createIssue(projectName: string, title: string, description: string, source: IssueSource, iteration: number): Promise<Issue>;
+/**
+ * Update an existing issue.
+ * Supports partial updates: status, resolvedBy, closedAt.
+ *
+ * @returns The updated issue
+ */
+export declare function updateIssue(projectName: string, issueId: string, updates: {
+    status?: IssueStatus;
+    resolvedBy?: IssueResolvedBy;
+}): Promise<Issue>;
+export interface IssueFilters {
+    status?: IssueStatus;
+    source?: IssueSource;
+    iteration?: number;
+}
+/**
+ * List issues with optional filters.
+ */
+export declare function listIssues(projectName: string, filters?: IssueFilters): Promise<Issue[]>;

package/build/core/issues.js

@@ -0,0 +1,100 @@
+/**
+ * Issue tracking — manages <data_dir>/<project_name>/issues.json
+ *
+ * Issues are project-level (not per-iteration/patch). They track problems
+ * discovered during testing or from user feedback, and can be linked to
+ * the patch or iteration that resolves them.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getProjectDataDir } from './registry.js';
+const ISSUES_FILE = 'issues.json';
+function issuesPath(projectName) {
+    return join(getProjectDataDir(projectName), ISSUES_FILE);
+}
+/**
+ * Read all issues for a project. Returns empty array if file doesn't exist.
+ */
+export async function readIssues(projectName) {
+    try {
+        const content = await readFile(issuesPath(projectName), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Write issues array to disk.
+ */
+async function writeIssues(projectName, issues) {
+    await writeFile(issuesPath(projectName), JSON.stringify(issues, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Create a new issue. Auto-generates an incremental ID.
+ *
+ * @returns The created issue
+ */
+export async function createIssue(projectName, title, description, source, iteration) {
+    const issues = await readIssues(projectName);
+    // Generate next ID
+    const maxNum = issues.reduce((max, iss) => {
+        const match = iss.id.match(/^issue-(\d+)$/);
+        return match ? Math.max(max, parseInt(match[1], 10)) : max;
+    }, 0);
+    const issue = {
+        id: `issue-${maxNum + 1}`,
+        title,
+        description,
+        source,
+        iteration,
+        status: 'open',
+        createdAt: new Date().toISOString(),
+    };
+    issues.push(issue);
+    await writeIssues(projectName, issues);
+    return issue;
+}
+/**
+ * Update an existing issue.
+ * Supports partial updates: status, resolvedBy, closedAt.
+ *
+ * @returns The updated issue
+ */
+export async function updateIssue(projectName, issueId, updates) {
+    const issues = await readIssues(projectName);
+    const issue = issues.find((i) => i.id === issueId);
+    if (!issue) {
+        throw new Error(`Issue "${issueId}" not found.`);
+    }
+    if (updates.status !== undefined) {
+        issue.status = updates.status;
+        if (updates.status === 'closed') {
+            issue.closedAt = new Date().toISOString();
+        }
+    }
+    if (updates.resolvedBy !== undefined) {
+        issue.resolvedBy = updates.resolvedBy;
+    }
+    await writeIssues(projectName, issues);
+    return issue;
+}
+/**
+ * List issues with optional filters.
+ */
+export async function listIssues(projectName, filters) {
+    let issues = await readIssues(projectName);
+    if (filters) {
+        if (filters.status) {
+            issues = issues.filter((i) => i.status === filters.status);
+        }
+        if (filters.source) {
+            issues = issues.filter((i) => i.source === filters.source);
+        }
+        if (filters.iteration !== undefined) {
+            issues = issues.filter((i) => i.iteration === filters.iteration);
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=issues.js.map

package/build/core/issues.js.map

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

package/build/core/overrides.d.ts

@@ -1,62 +1,55 @@
 /**
- * Override configuration — three-layer merge system.
+ * Override configuration — two-layer system: project overrides > workflow defaults.
  *
- * Priority: project-level > global-level > workflow defaults
+ * Project-level overrides are stored in:
+ *   <data_dir>/<project_name>/overrides.json
  *
- * Files:
- *   <data_dir>/overrides.json                    (global)
- *   <data_dir>/<project_name>/overrides.json     (project)
+ * Workflow defaults come from the workflow definition (artifactDefinitions, roles).
+ * The override system lets users customize per-project settings without modifying
+ * the workflow definition itself.
  */
-import type { CapabilityOverride, DocDefinition, OverrideConfig } from './types.js';
-/**
- * Read global overrides (<data_dir>/overrides.json).
- */
-export declare function readGlobalOverrides(): Promise<OverrideConfig>;
+import type { CapabilityOverride, ArtifactDefinition, OverrideConfig } from './types.js';
 /**
  * Read project-level overrides (<data_dir>/<project_name>/overrides.json).
  */
 export declare function readProjectOverrides(projectName: string): Promise<OverrideConfig>;
-/**
- * Write global overrides.
- */
-export declare function writeGlobalOverrides(config: OverrideConfig): Promise<void>;
 /**
  * Write project-level overrides.
  */
 export declare function writeProjectOverrides(projectName: string, config: OverrideConfig): Promise<void>;
 /**
- * Get the fully merged override config for a project.
- * Priority: project > global
+ * Get the override config for a project.
+ * Returns the project-level overrides directly — no global merge.
  */
 export declare function getMergedOverrides(projectName: string): Promise<OverrideConfig>;
 /**
- * Resolve whether a specific doc requires review.
+ * Resolve whether a specific artifact requires review.
  *
- * Priority: project override > global override > workflow default
+ * Priority: project override > workflow default
  */
-export declare function resolveDocReview(docId: string, docDef: DocDefinition, overrides: OverrideConfig): boolean;
+export declare function resolveArtifactReview(artifactId: string, artifactDef: ArtifactDefinition, overrides: OverrideConfig): boolean;
 /**
  * Resolve the capability override for a specific role + capability.
  * Returns null if no override is configured.
  */
 export declare function resolveCapabilityOverride(roleId: string, capabilityId: string, overrides: OverrideConfig): CapabilityOverride | null;
 /**
- * Set a single role capability override at project or global level.
+ * Set a single role capability override at project level.
  */
-export declare function setCapabilityOverride(scope: 'global' | 'project', projectName: string | null, roleId: string, capabilityId: string, override: CapabilityOverride): Promise<void>;
+export declare function setCapabilityOverride(projectName: string, roleId: string, capabilityId: string, override: CapabilityOverride): Promise<void>;
 /**
- * Set review override for a specific doc at project or global level.
+ * Set review override for a specific artifact at project level.
  */
-export declare function setReviewOverride(scope: 'global' | 'project', projectName: string | null, docId: string, enabled: boolean): Promise<void>;
+export declare function setReviewOverride(projectName: string, artifactId: string, enabled: boolean): Promise<void>;
 /**
  * Resolve the agent/model configuration for a role.
- * Returns { agent, model } from the merged overrides, or undefined fields if not set.
+ * Returns { agent, model } from the overrides, or undefined fields if not set.
  */
 export declare function resolveRoleConfig(roleId: string, overrides: OverrideConfig): {
     agent?: string;
     model?: string;
 };
 /**
- * Set agent/model config for a role at project or global level.
+ * Set agent/model config for a role at project level.
  */
-export declare function setRoleAgentConfig(scope: 'global' | 'project', projectName: string | null, roleId: string, agent?: string, model?: string): Promise<void>;
+export declare function setRoleAgentConfig(projectName: string, roleId: string, agent?: string, model?: string): Promise<void>;

package/build/core/overrides.js

@@ -1,15 +1,16 @@
 /**
- * Override configuration — three-layer merge system.
+ * Override configuration — two-layer system: project overrides > workflow defaults.
  *
- * Priority: project-level > global-level > workflow defaults
+ * Project-level overrides are stored in:
+ *   <data_dir>/<project_name>/overrides.json
  *
- * Files:
- *   <data_dir>/overrides.json                    (global)
- *   <data_dir>/<project_name>/overrides.json     (project)
+ * Workflow defaults come from the workflow definition (artifactDefinitions, roles).
+ * The override system lets users customize per-project settings without modifying
+ * the workflow definition itself.
  */
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
-import { getGlobalDir, getProjectDataDir } from './registry.js';
+import { getProjectDataDir } from './registry.js';
 const OVERRIDES_FILE = 'overrides.json';
 /**
  * Read an override config file. Returns empty config if file doesn't exist.
@@ -23,12 +24,6 @@ async function readOverrideFile(filePath) {
         return {};
     }
 }
-/**
- * Read global overrides (<data_dir>/overrides.json).
- */
-export async function readGlobalOverrides() {
-    return readOverrideFile(join(getGlobalDir(), OVERRIDES_FILE));
-}
 /**
  * Read project-level overrides (<data_dir>/<project_name>/overrides.json).
  */
@@ -42,12 +37,6 @@ async function writeOverrideFile(filePath, config) {
     await mkdir(dirname(filePath), { recursive: true });
     await writeFile(filePath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
 }
-/**
- * Write global overrides.
- */
-export async function writeGlobalOverrides(config) {
-    await writeOverrideFile(join(getGlobalDir(), OVERRIDES_FILE), config);
-}
 /**
  * Write project-level overrides.
  */
@@ -55,63 +44,23 @@ export async function writeProjectOverrides(projectName, config) {
     await writeOverrideFile(join(getProjectDataDir(projectName), OVERRIDES_FILE), config);
 }
 /**
- * Merge two override configs. `higher` takes priority over `lower`.
- */
-function mergeConfigs(lower, higher) {
-    const merged = {};
-    // Merge review: higher wins entirely if present
-    if (higher.review !== undefined) {
-        merged.review = higher.review;
-    }
-    else if (lower.review !== undefined) {
-        merged.review = lower.review;
-    }
-    // Merge roles: deep merge per role (agent, model, capabilities)
-    const lowerRoles = lower.roles ?? {};
-    const higherRoles = higher.roles ?? {};
-    const allRoleIds = new Set([...Object.keys(lowerRoles), ...Object.keys(higherRoles)]);
-    if (allRoleIds.size > 0) {
-        merged.roles = {};
-        for (const roleId of allRoleIds) {
-            const lo = lowerRoles[roleId] ?? {};
-            const hi = higherRoles[roleId] ?? {};
-            merged.roles[roleId] = {
-                ...lo,
-                ...hi,
-                // Deep merge capabilities
-                capabilities: {
-                    ...(lo.capabilities ?? {}),
-                    ...(hi.capabilities ?? {}),
-                },
-            };
-            // Clean up empty capabilities
-            if (Object.keys(merged.roles[roleId].capabilities).length === 0) {
-                delete merged.roles[roleId].capabilities;
-            }
-        }
-    }
-    return merged;
-}
-/**
- * Get the fully merged override config for a project.
- * Priority: project > global
+ * Get the override config for a project.
+ * Returns the project-level overrides directly — no global merge.
  */
 export async function getMergedOverrides(projectName) {
-    const global = await readGlobalOverrides();
-    const project = await readProjectOverrides(projectName);
-    return mergeConfigs(global, project);
+    return readProjectOverrides(projectName);
 }
 /**
- * Resolve whether a specific doc requires review.
+ * Resolve whether a specific artifact requires review.
  *
- * Priority: project override > global override > workflow default
+ * Priority: project override > workflow default
  */
-export function resolveDocReview(docId, docDef, overrides) {
+export function resolveArtifactReview(artifactId, artifactDef, overrides) {
     const review = overrides.review;
-    // Override is a per-doc record
+    // Override is a per-artifact record
     if (typeof review === 'object' && review !== null) {
-        if (docId in review) {
-            return review[docId];
+        if (artifactId in review) {
+            return review[artifactId];
         }
         // Not mentioned in override, fall through to workflow default
     }
@@ -120,7 +69,7 @@ export function resolveDocReview(docId, docDef, overrides) {
         return review;
     }
     // No override — use workflow default
-    return docDef.review ?? false;
+    return artifactDef.review ?? false;
 }
 /**
  * Resolve the capability override for a specific role + capability.
@@ -130,10 +79,10 @@ export function resolveCapabilityOverride(roleId, capabilityId, overrides) {
     return overrides.roles?.[roleId]?.capabilities?.[capabilityId] ?? null;
 }
 /**
- * Set a single role capability override at project or global level.
+ * Set a single role capability override at project level.
  */
-export async function setCapabilityOverride(scope, projectName, roleId, capabilityId, override) {
-    const config = scope === 'global' ? await readGlobalOverrides() : await readProjectOverrides(projectName);
+export async function setCapabilityOverride(projectName, roleId, capabilityId, override) {
+    const config = await readProjectOverrides(projectName);
     if (!config.roles) {
         config.roles = {};
     }
@@ -144,33 +93,23 @@ export async function setCapabilityOverride(scope, projectName, roleId, capabili
         config.roles[roleId].capabilities = {};
     }
     config.roles[roleId].capabilities[capabilityId] = override;
-    if (scope === 'global') {
-        await writeGlobalOverrides(config);
-    }
-    else {
-        await writeProjectOverrides(projectName, config);
-    }
+    await writeProjectOverrides(projectName, config);
 }
 /**
- * Set review override for a specific doc at project or global level.
+ * Set review override for a specific artifact at project level.
  */
-export async function setReviewOverride(scope, projectName, docId, enabled) {
-    const config = scope === 'global' ? await readGlobalOverrides() : await readProjectOverrides(projectName);
-    // Ensure review is a per-doc record
+export async function setReviewOverride(projectName, artifactId, enabled) {
+    const config = await readProjectOverrides(projectName);
+    // Ensure review is a per-artifact record
     if (typeof config.review !== 'object' || config.review === null) {
         config.review = {};
     }
-    config.review[docId] = enabled;
-    if (scope === 'global') {
-        await writeGlobalOverrides(config);
-    }
-    else {
-        await writeProjectOverrides(projectName, config);
-    }
+    config.review[artifactId] = enabled;
+    await writeProjectOverrides(projectName, config);
 }
 /**
  * Resolve the agent/model configuration for a role.
- * Returns { agent, model } from the merged overrides, or undefined fields if not set.
+ * Returns { agent, model } from the overrides, or undefined fields if not set.
  */
 export function resolveRoleConfig(roleId, overrides) {
     const role = overrides.roles?.[roleId];
@@ -182,10 +121,10 @@ export function resolveRoleConfig(roleId, overrides) {
     };
 }
 /**
- * Set agent/model config for a role at project or global level.
+ * Set agent/model config for a role at project level.
  */
-export async function setRoleAgentConfig(scope, projectName, roleId, agent, model) {
-    const config = scope === 'global' ? await readGlobalOverrides() : await readProjectOverrides(projectName);
+export async function setRoleAgentConfig(projectName, roleId, agent, model) {
+    const config = await readProjectOverrides(projectName);
     if (!config.roles) {
         config.roles = {};
     }
@@ -196,11 +135,6 @@ export async function setRoleAgentConfig(scope, projectName, roleId, agent, mode
         config.roles[roleId].agent = agent;
     if (model)
         config.roles[roleId].model = model;
-    if (scope === 'global') {
-        await writeGlobalOverrides(config);
-    }
-    else {
-        await writeProjectOverrides(projectName, config);
-    }
+    await writeProjectOverrides(projectName, config);
 }
 //# sourceMappingURL=overrides.js.map