@marcopeg/hal 1.0.23 → 1.0.26

package/dist/config.d.ts

@@ -7,6 +7,38 @@ declare const EngineNameSchema: z.ZodEnum<{
     cursor: "cursor";
     antigravity: "antigravity";
 }>;
+declare const ProvidersConfigSchema: z.ZodOptional<z.ZodObject<{
+    claude: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    copilot: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    codex: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    opencode: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    cursor: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    antigravity: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>>;
 declare const GlobalsFileSchema: z.ZodOptional<z.ZodObject<{
     access: z.ZodOptional<z.ZodObject<{
         allowedUserIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
@@ -39,32 +71,6 @@ declare const GlobalsFileSchema: z.ZodOptional<z.ZodObject<{
             sandbox: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
-    providers: z.ZodOptional<z.ZodObject<{
-        claude: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-        copilot: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-        codex: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-        opencode: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-        cursor: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-        antigravity: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
     logging: z.ZodOptional<z.ZodObject<{
         level: z.ZodOptional<z.ZodEnum<{
             debug: "debug";
@@ -138,12 +144,15 @@ declare const GlobalsFileSchema: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        engine: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>>;
 declare const ProjectFileSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     active: z.ZodOptional<z.ZodBoolean>;
-    cwd: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
     telegram: z.ZodObject<{
         botToken: z.ZodString;
     }, z.core.$strip>;
@@ -182,26 +191,32 @@ declare const ProjectFileSchema: z.ZodObject<{
         claude: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         copilot: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         codex: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         opencode: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         cursor: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         antigravity: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     logging: z.ZodOptional<z.ZodObject<{
@@ -278,6 +293,9 @@ declare const ProjectFileSchema: z.ZodObject<{
         model: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        engine: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const MultiConfigFileSchema: z.ZodObject<{
@@ -313,32 +331,6 @@ declare const MultiConfigFileSchema: z.ZodObject<{
                 sandbox: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
         }, z.core.$strip>>;
-        providers: z.ZodOptional<z.ZodObject<{
-            claude: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            copilot: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            codex: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            opencode: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            cursor: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            antigravity: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
         logging: z.ZodOptional<z.ZodObject<{
             level: z.ZodOptional<z.ZodEnum<{
                 debug: "debug";
@@ -412,13 +404,48 @@ declare const MultiConfigFileSchema: z.ZodObject<{
             model: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
+            engine: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    providers: z.ZodOptional<z.ZodObject<{
+        claude: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        copilot: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        codex: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        opencode: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        cursor: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        antigravity: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
     context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    projects: z.ZodArray<z.ZodObject<{
+    projects: z.ZodRecord<z.ZodString, z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         active: z.ZodOptional<z.ZodBoolean>;
-        cwd: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
         telegram: z.ZodObject<{
             botToken: z.ZodString;
         }, z.core.$strip>;
@@ -457,26 +484,32 @@ declare const MultiConfigFileSchema: z.ZodObject<{
             claude: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             copilot: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             codex: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             opencode: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             cursor: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             antigravity: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
         }, z.core.$strip>>;
         logging: z.ZodOptional<z.ZodObject<{
@@ -553,6 +586,9 @@ declare const MultiConfigFileSchema: z.ZodObject<{
             model: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
+            engine: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -563,6 +599,7 @@ export type EngineName = z.infer<typeof EngineNameSchema>;
 export interface ProviderModel {
     name: string;
     description?: string;
+    default?: boolean;
 }
 export interface ResolvedProjectConfig {
     slug: string;
@@ -607,6 +644,8 @@ export interface ResolvedProjectConfig {
     } | undefined;
     context: Record<string, string> | undefined;
     providerModels: ProviderModel[];
+    providerDefaultModel: string | undefined;
+    availableEngines: EngineName[];
     commands: {
         start: {
             enabled: boolean;
@@ -636,6 +675,9 @@ export interface ResolvedProjectConfig {
         model: {
             enabled: boolean;
         };
+        engine: {
+            enabled: boolean;
+        };
     };
 }
 export declare class ConfigLoadError extends Error {
@@ -646,9 +688,14 @@ export interface LoadedConfigResult {
     loadedFiles: string[];
 }
 export declare function deriveSlug(name: string | undefined, cwd: string): string;
-export declare function resolveProjectConfig(project: ProjectFileEntry, globals: GlobalsFile, configDir: string, rootContext?: Record<string, string>): ResolvedProjectConfig;
+export declare function resolveProjectConfig(key: string, project: ProjectFileEntry, globals: GlobalsFile, configDir: string, rootContext?: Record<string, string>, providers?: z.infer<typeof ProvidersConfigSchema>): ResolvedProjectConfig;
 export declare function validateProjects(projects: ResolvedProjectConfig[]): void;
 export declare function validateAccessPolicies(projects: ResolvedProjectConfig[]): void;
+/**
+ * Validates that at most one model per providers.<engine> list has default: true.
+ * Call after config load and env substitution, before resolving project configs.
+ */
+export declare function validateProviderDefaultUniqueness(config: MultiConfigFile): void;
 export type ConfigFormat = "json" | "jsonc" | "yaml";
 interface ResolvedConfigFile {
     path: string;

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -4,6 +4,7 @@ import { parse as parseEnv } from "dotenv";
 import stripJsonComments from "strip-json-comments";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+import { isCliAvailable } from "./engine/cli-available.js";
 // ─── Zod helpers ──────────────────────────────────────────────────────────────
 const TranscriptionModelSchema = z.enum([
     "tiny",
@@ -102,11 +103,13 @@ const CommandsConfigSchema = z
     clean: SimpleCommandConfigSchema,
     git: GitConfigSchema,
     model: GitConfigSchema,
+    engine: GitConfigSchema,
 })
     .optional();
 const ProviderModelSchema = z.object({
     name: z.string().min(1),
     description: z.string().optional(),
+    default: z.boolean().optional(),
 });
 const ProvidersConfigSchema = z
     .object({
@@ -130,7 +133,6 @@ const GlobalsFileSchema = z
     .object({
     access: AccessSchema,
     engine: EngineConfigSchema,
-    providers: ProvidersConfigSchema,
     logging: z
         .object({
         level: LogLevelSchema,
@@ -154,11 +156,17 @@ const GlobalsFileSchema = z
     commands: CommandsConfigSchema,
 })
     .optional();
+// ─── Project map key (slug-like: safe for default cwd path segment) ─────────────
+const PROJECT_KEY_REGEX = /^[a-zA-Z0-9_-]+$/;
+/** Project map keys must be slug-like so default cwd is a safe path segment. */
+const ProjectKeySchema = z
+    .string()
+    .regex(PROJECT_KEY_REGEX, "project key must be slug-like (letters, numbers, dashes, underscores only)");
 // ─── Per-project schema ────────────────────────────────────────────────────────
 const ProjectFileSchema = z.object({
     name: z.string().optional(),
     active: z.boolean().optional(),
-    cwd: z.string().min(1, "project.cwd is required"),
+    cwd: z.string().min(1, "project.cwd must be non-empty when set").optional(),
     telegram: z.object({
         botToken: z.string().min(1, "project.telegram.botToken is required"),
     }),
@@ -189,12 +197,16 @@ const ProjectFileSchema = z.object({
     commands: CommandsConfigSchema,
 });
 // ─── Multi-project config file schema ─────────────────────────────────────────
+const ProjectsMapSchema = z
+    .record(ProjectKeySchema, ProjectFileSchema)
+    .refine((rec) => Object.keys(rec).length >= 1, {
+    message: "At least one project is required",
+});
 const MultiConfigFileSchema = z.object({
     globals: GlobalsFileSchema,
+    providers: ProvidersConfigSchema,
     context: z.record(z.string(), z.string()).optional(),
-    projects: z
-        .array(ProjectFileSchema)
-        .min(1, "At least one project is required"),
+    projects: ProjectsMapSchema,
 });
 // ─── Local config partial schema ──────────────────────────────────────────────
 const LocalProjectSchema = ProjectFileSchema.partial().extend({
@@ -204,8 +216,9 @@ const LocalProjectSchema = ProjectFileSchema.partial().extend({
 const LocalConfigFileSchema = z
     .object({
     globals: GlobalsFileSchema,
+    providers: ProvidersConfigSchema,
     context: z.record(z.string(), z.string()).optional(),
-    projects: z.array(LocalProjectSchema).optional(),
+    projects: z.record(ProjectKeySchema, LocalProjectSchema).optional(),
 })
     .optional();
 // ─── Config load result & errors ───────────────────────────────────────────────
@@ -231,6 +244,13 @@ function parseTelegramUserId(value, path) {
     }
     return num;
 }
+/** Set name/cwd from map key when omitted. Mutates entries in place. */
+function normalizeProjectMap(projects) {
+    for (const [key, entry] of Object.entries(projects)) {
+        entry.name = entry.name ?? key;
+        entry.cwd = entry.cwd ?? key;
+    }
+}
 function normalizeAllowedUserIdsInConfig(config) {
     const globalsAccess = config.globals?.access;
     if (globalsAccess?.allowedUserIds != null) {
@@ -241,15 +261,14 @@ function normalizeAllowedUserIdsInConfig(config) {
         }
         globalsAccess.allowedUserIds = normalized;
     }
-    for (let j = 0; j < config.projects.length; j++) {
-        const project = config.projects[j];
+    for (const [key, project] of Object.entries(config.projects)) {
         const access = project.access;
         if (access?.allowedUserIds == null)
             continue;
         const raw = access.allowedUserIds;
         const normalized = [];
         for (let i = 0; i < raw.length; i++) {
-            normalized.push(parseTelegramUserId(raw[i], `projects[${j}].access.allowedUserIds[${i}]`));
+            normalized.push(parseTelegramUserId(raw[i], `projects.${key}.access.allowedUserIds[${i}]`));
         }
         access.allowedUserIds = normalized;
     }
@@ -280,11 +299,11 @@ function resolveDataDir(dataDirRaw, projectCwd, configDir, slug) {
     return resolve(projectCwd, dataDirRaw);
 }
 // ─── Merge: project over globals over defaults ─────────────────────────────────
-export function resolveProjectConfig(project, globals, configDir, rootContext) {
-    const resolvedCwd = isAbsolute(project.cwd)
-        ? project.cwd
-        : resolve(configDir, project.cwd);
-    const slug = deriveSlug(project.name, project.cwd);
+export function resolveProjectConfig(key, project, globals, configDir, rootContext, providers) {
+    const slug = key;
+    const name = project.name ?? key;
+    const cwd = project.cwd ?? key;
+    const resolvedCwd = isAbsolute(cwd) ? cwd : resolve(configDir, cwd);
     const logDir = resolve(configDir, ".hal", "logs", slug);
     const dataDir = resolveDataDir(project.dataDir ?? globals.dataDir, resolvedCwd, configDir, slug);
     const hasTranscription = project.transcription !== undefined || globals.transcription !== undefined;
@@ -304,11 +323,54 @@ export function resolveProjectConfig(project, globals, configDir, rootContext) {
         }
         return msg.text;
     }
+    // Resolve engine and provider models early (needed for command enabled flags)
+    const rawEngineName = project.engine?.name ?? globals.engine?.name;
+    if (!rawEngineName) {
+        throw new ConfigLoadError(`Configuration error: project "${key}" has no engine configured. ` +
+            "Set engine.name in the project or in globals.");
+    }
+    const engineName = rawEngineName;
+    const mergedProviders = {
+        ...(providers ?? {}),
+        ...(project.providers ?? {}),
+    };
+    const availableEngines = Object.keys(mergedProviders).filter((k) => {
+        const list = mergedProviders[k];
+        return Array.isArray(list) && list.length > 0;
+    });
+    const rawProviderModels = project.providers?.[engineName] ?? providers?.[engineName] ?? [];
+    const providerModels = rawProviderModels.map((m) => ({
+        name: m.name,
+        description: m.description,
+        default: m.default,
+    }));
+    const defaultEntries = providerModels.filter((m) => m.default === true);
+    const providerDefaultModel = defaultEntries.length === 1 ? defaultEntries[0].name : undefined;
     // Resolve command enabled flags (project > globals > default)
     const rawStart = project.commands?.start ?? globals.commands?.start;
     const rawHelp = project.commands?.help ?? globals.commands?.help;
     const rawReset = project.commands?.reset ?? globals.commands?.reset;
     const rawClean = project.commands?.clean ?? globals.commands?.clean;
+    // Enable /model when we have a config list, or when the engine supports self-discovery and its CLI is available
+    const effectiveEngineCommand = project.engine?.command ?? globals.engine?.command ?? undefined;
+    const defaultCommandForEngine = engineName === "opencode"
+        ? "opencode"
+        : engineName === "cursor"
+            ? "agent"
+            : null;
+    const modelCliCommand = effectiveEngineCommand ?? defaultCommandForEngine;
+    const selfDiscoveryEnabled = rawProviderModels.length === 0 &&
+        (engineName === "opencode" || engineName === "cursor") &&
+        modelCliCommand !== null &&
+        isCliAvailable(modelCliCommand);
+    const modelEnabled = (project.commands?.model?.enabled ??
+        globals.commands?.model?.enabled ??
+        true) &&
+        (providerModels.length > 1 || selfDiscoveryEnabled);
+    const engineEnabled = (project.commands?.engine?.enabled ??
+        globals.commands?.engine?.enabled ??
+        true) &&
+        availableEngines.length > 1;
     const resolvedCommands = {
         start: {
             enabled: project.commands?.start?.enabled ??
@@ -351,23 +413,12 @@ export function resolveProjectConfig(project, globals, configDir, rootContext) {
                 globals.commands?.git?.enabled ??
                 false,
         },
-        model: {
-            enabled: project.commands?.model?.enabled ??
-                globals.commands?.model?.enabled ??
-                true,
-        },
+        model: { enabled: modelEnabled },
+        engine: { enabled: engineEnabled },
     };
-    const engineName = (project.engine?.name ??
-        globals.engine?.name ??
-        "claude");
-    const rawProviderModels = project.providers?.[engineName] ?? globals.providers?.[engineName] ?? [];
-    const providerModels = rawProviderModels.map((m) => ({
-        name: m.name,
-        description: m.description,
-    }));
     return {
         slug,
-        name: project.name,
+        name,
         cwd: resolvedCwd,
         configDir,
         dataDir,
@@ -425,6 +476,8 @@ export function resolveProjectConfig(project, globals, configDir, rootContext) {
             }
             : undefined,
         providerModels,
+        providerDefaultModel,
+        availableEngines,
         context: hasContext ? { ...rootContext, ...project.context } : undefined,
         commands: resolvedCommands,
     };
@@ -467,6 +520,49 @@ export function validateAccessPolicies(projects) {
         throw new ConfigLoadError(`Configuration error: invalid access policy\n${errors.map((e) => `  - ${e}`).join("\n")}`);
     }
 }
+// ─── Boot-time provider default uniqueness ────────────────────────────────────
+const PROVIDER_ENGINE_KEYS = [
+    "claude",
+    "copilot",
+    "codex",
+    "opencode",
+    "cursor",
+    "antigravity",
+];
+function countProviderDefaults(list) {
+    if (!Array.isArray(list))
+        return 0;
+    return list.filter((m) => m.default === true).length;
+}
+/**
+ * Validates that at most one model per providers.<engine> list has default: true.
+ * Call after config load and env substitution, before resolving project configs.
+ */
+export function validateProviderDefaultUniqueness(config) {
+    const topProviders = config.providers;
+    if (topProviders) {
+        for (const engine of PROVIDER_ENGINE_KEYS) {
+            const list = topProviders[engine];
+            const n = countProviderDefaults(list);
+            if (n > 1) {
+                throw new ConfigLoadError(`Configuration error: at most one model in providers.${engine} may have default: true (found ${n}).`);
+            }
+        }
+    }
+    for (const [key, project] of Object.entries(config.projects)) {
+        const projectProviders = project.providers;
+        if (!projectProviders)
+            continue;
+        const projectLabel = project.name ?? key;
+        for (const engine of PROVIDER_ENGINE_KEYS) {
+            const list = projectProviders[engine];
+            const n = countProviderDefaults(list);
+            if (n > 1) {
+                throw new ConfigLoadError(`Configuration error: at most one model in projects["${key}"].providers.${engine} may have default: true (found ${n}). Project: ${projectLabel}.`);
+            }
+        }
+    }
+}
 function loadEnvFiles(configDir, projectCwds) {
     const loadedFiles = [];
     const vars = {};
@@ -619,32 +715,36 @@ function mergeLocalIntoBase(base, local, baseFileName, localFileName) {
     const mergedGlobals = local.globals !== undefined
         ? deepMerge(base.globals ?? {}, local.globals)
         : base.globals;
+    const mergedProviders = local.providers !== undefined
+        ? base.providers
+            ? deepMerge(base.providers, local.providers)
+            : local.providers
+        : base.providers;
     const mergedContext = local.context !== undefined
         ? base.context
             ? { ...base.context, ...local.context }
             : local.context
         : base.context;
-    if (!local.projects || local.projects.length === 0) {
-        return { ...base, globals: mergedGlobals, context: mergedContext };
-    }
-    const mergedProjects = [...base.projects];
-    for (const localProject of local.projects) {
-        const matchKey = localProject.name ?? localProject.cwd;
-        const idx = mergedProjects.findIndex((bp) => {
-            if (localProject.name)
-                return bp.name === localProject.name;
-            if (localProject.cwd)
-                return bp.cwd === localProject.cwd;
-            return false;
-        });
-        if (idx === -1) {
-            throw new ConfigLoadError(`Configuration error: local project "${matchKey}" not found in ${baseFileName}.\n` +
-                `  Every entry in ${localFileName} projects must match a base project by name or cwd.`);
+    if (!local.projects || Object.keys(local.projects).length === 0) {
+        return {
+            ...base,
+            globals: mergedGlobals,
+            providers: mergedProviders,
+            context: mergedContext,
+        };
+    }
+    const mergedProjects = { ...base.projects };
+    for (const [localKey, localProject] of Object.entries(local.projects)) {
+        if (!(localKey in mergedProjects)) {
+            throw new ConfigLoadError(`Configuration error: local project key "${localKey}" not found in ${baseFileName}.\n` +
+                `  Every key in ${localFileName} projects must exist in the base config.`);
         }
-        mergedProjects[idx] = deepMerge(mergedProjects[idx], localProject);
+        mergedProjects[localKey] = deepMerge(mergedProjects[localKey], localProject);
     }
+    normalizeProjectMap(mergedProjects);
     return {
         globals: mergedGlobals,
+        providers: mergedProviders,
         context: mergedContext,
         projects: mergedProjects,
     };
@@ -681,6 +781,7 @@ function loadMultiConfigInternal(configDir) {
         throw new ConfigLoadError(`Configuration error in ${baseFileName}:\n${issues}`);
     }
     let merged = baseResult.data;
+    normalizeProjectMap(merged.projects);
     // 3. Load and merge local config
     const localResult = loadLocalConfig(configDir);
     if (localResult !== null) {
@@ -689,7 +790,13 @@ function loadMultiConfigInternal(configDir) {
         merged = mergeLocalIntoBase(merged, localResult.config, baseFileName, localFileName);
     }
     // 4. Load .env files (using raw cwds from merged config for path resolution)
-    const rawCwds = merged.projects.map((p) => isAbsolute(p.cwd) ? p.cwd : resolve(configDir, p.cwd));
+    // Stable order: sort project keys so iteration is deterministic.
+    const projectKeys = Object.keys(merged.projects).sort();
+    const rawCwds = projectKeys.map((key) => {
+        const p = merged.projects[key];
+        const cwd = p.cwd ?? key;
+        return isAbsolute(cwd) ? cwd : resolve(configDir, cwd);
+    });
     const envSources = loadEnvFiles(configDir, rawCwds);
     // 5. Substitute env vars in the merged raw object (before final Zod pass)
     const substituted = substituteEnvVars(merged, envSources.vars);
@@ -701,6 +808,7 @@ function loadMultiConfigInternal(configDir) {
             .join("\n");
         throw new ConfigLoadError(`Configuration error after environment variable substitution:\n${issues}`);
     }
+    normalizeProjectMap(finalResult.data.projects);
     // 7. Normalize allowedUserIds (string | number)[] → number[] with validation
     normalizeAllowedUserIdsInConfig(finalResult.data);
     return {