devchain-cli 0.4.6 → 0.5.0

package/dist/server/modules/projects/services/projects.service.d.ts

@@ -15,12 +15,31 @@ export interface CreateFromTemplateInput {
     rootPath: string;
     slug: string;
     version?: string | null;
+    familyProviderMappings?: Record<string, string>;
+}
+export interface ProviderMappingRequired {
+    missingProviders: string[];
+    familyAlternatives: FamilyAlternative[];
+    canImport: boolean;
 }
 export interface ImportProjectInput {
     projectId: string;
     payload: unknown;
     dryRun?: boolean;
     statusMappings?: Record<string, string>;
+    familyProviderMappings?: Record<string, string>;
+}
+export interface FamilyAlternative {
+    familySlug: string;
+    defaultProvider: string;
+    defaultProviderAvailable: boolean;
+    availableProviders: string[];
+    hasAlternatives: boolean;
+}
+export interface FamilyAlternativesResult {
+    alternatives: FamilyAlternative[];
+    missingProviders: string[];
+    canImport: boolean;
 }
 export declare class ProjectsService {
     private readonly storage;
@@ -34,6 +53,18 @@ export declare class ProjectsService {
     listTemplates(): Promise<TemplateInfo[]>;
     getTemplateContent(templateId: string): Promise<unknown>;
     createFromTemplate(input: CreateFromTemplateInput): Promise<{
+        success: boolean;
+        providerMappingRequired: {
+            missingProviders: string[];
+            familyAlternatives: FamilyAlternative[];
+            canImport: boolean;
+        };
+        project?: undefined;
+        imported?: undefined;
+        mappings?: undefined;
+        initialPromptSet?: undefined;
+        message?: undefined;
+    } | {
         success: boolean;
         project: import("../../storage/models/domain.models").Project;
         imported: {
@@ -52,6 +83,7 @@ export declare class ProjectsService {
         };
         initialPromptSet: boolean;
         message: string;
+        providerMappingRequired?: undefined;
     }>;
     exportProject(projectId: string, opts?: {
         manifestOverrides?: Partial<ManifestData>;
@@ -128,6 +160,7 @@ export declare class ProjectsService {
                 id: string;
                 name: string;
             };
+            familySlug: string | null;
             options: string | null;
             instructions: string | null;
             temperature: number | null;
@@ -152,7 +185,7 @@ export declare class ProjectsService {
         } | null;
     }>;
     importProject(input: ImportProjectInput): Promise<{
-        dryRun: boolean;
+        dryRun: true;
         missingProviders: string[];
         unmatchedStatuses: {
             id: string;
@@ -164,6 +197,11 @@ export declare class ProjectsService {
             label: string;
             color: string;
         }[];
+        providerMappingRequired?: {
+            missingProviders: string[];
+            familyAlternatives: FamilyAlternative[];
+            canImport: boolean;
+        };
         counts: {
             toImport: {
                 prompts: number;
@@ -181,13 +219,18 @@ export declare class ProjectsService {
                 watchers: number;
                 subscribers: number;
             };
-            imported?: undefined;
-            deleted?: undefined;
-            epics?: undefined;
         };
-        success?: undefined;
+    } | {
+        success: boolean;
+        providerMappingRequired: {
+            missingProviders: string[];
+            familyAlternatives: FamilyAlternative[];
+            canImport: boolean;
+        };
         mode?: undefined;
         replaced?: undefined;
+        missingProviders?: undefined;
+        counts?: undefined;
         mappings?: undefined;
         initialPromptSet?: undefined;
         message?: undefined;
@@ -218,8 +261,6 @@ export declare class ProjectsService {
                 agentRemapped: number;
                 agentCleared: number;
             };
-            toImport?: undefined;
-            toDelete?: undefined;
         };
         mappings: {
             promptIdMap: Record<string, string>;
@@ -231,11 +272,22 @@ export declare class ProjectsService {
         };
         initialPromptSet: boolean;
         message: string;
-        dryRun?: undefined;
-        unmatchedStatuses?: undefined;
-        templateStatuses?: undefined;
+        providerMappingRequired?: undefined;
     }>;
     private resolveProviders;
+    computeFamilyAlternatives(templateProfiles: Array<{
+        id?: string;
+        name: string;
+        provider: {
+            name: string;
+        };
+        familySlug?: string | null;
+    }>, templateAgents: Array<{
+        id?: string;
+        name: string;
+        profileId?: string;
+    }>): Promise<FamilyAlternativesResult>;
+    private selectProfilesForFamilies;
     private buildNameToIdMaps;
     private createWatchersFromPayload;
     private createSubscribersFromPayload;
@@ -243,4 +295,5 @@ export declare class ProjectsService {
     private normalizeProfileOptions;
     private getImportErrorMessage;
     private slugify;
+    getTemplateManifestForProject(projectId: string): Promise<ManifestData | null>;
 }

package/dist/server/modules/projects/services/projects.service.js

@@ -128,14 +128,28 @@ let ProjectsService = class ProjectsService {
                 hint: 'Template file does not match expected export schema',
             });
         }
-        const providerNames = new Set((payload.profiles ?? []).map((p) => p.provider.name.trim().toLowerCase()));
-        const { available, missing: missingProviders } = await this.resolveProviders(providerNames);
-        if (missingProviders.length > 0) {
-            throw new error_types_1.ValidationError('Import aborted: missing providers', {
-                missingProviders,
-                hint: 'Install/configure providers by name before creating project from template.',
+        const familyResult = await this.computeFamilyAlternatives(payload.profiles, payload.agents);
+        const needsMapping = familyResult.alternatives.some((alt) => !alt.defaultProviderAvailable);
+        if (needsMapping && !input.familyProviderMappings) {
+            return {
+                success: false,
+                providerMappingRequired: {
+                    missingProviders: familyResult.missingProviders,
+                    familyAlternatives: familyResult.alternatives,
+                    canImport: familyResult.canImport,
+                },
+            };
+        }
+        if (!familyResult.canImport) {
+            throw new error_types_1.ValidationError('Cannot import: some profile families have no available providers', {
+                hint: 'Install the required providers or use a different template',
+                missingProviders: familyResult.missingProviders,
+                familyAlternatives: familyResult.alternatives,
             });
         }
+        const providerNames = new Set((payload.profiles ?? []).map((p) => p.provider.name.trim().toLowerCase()));
+        const { available } = await this.resolveProviders(providerNames);
+        const selectedProfilesByFamily = this.selectProfilesForFamilies(payload.profiles, payload.agents, input.familyProviderMappings, available);
         const templatePayload = {
             prompts: payload.prompts.map((p) => ({
                 id: p.id,
@@ -144,7 +158,7 @@ let ProjectsService = class ProjectsService {
                 version: p.version,
                 tags: p.tags,
             })),
-            profiles: payload.profiles.map((prof) => {
+            profiles: selectedProfilesByFamily.profilesToCreate.map((prof) => {
                 const providerId = available.get(prof.provider.name.trim().toLowerCase());
                 if (!providerId) {
                     throw new error_types_1.NotFoundError('Provider', prof.provider.name);
@@ -153,18 +167,22 @@ let ProjectsService = class ProjectsService {
                     id: prof.id,
                     name: prof.name,
                     providerId,
+                    familySlug: prof.familySlug ?? null,
                     options: this.normalizeProfileOptions(prof.options),
                     instructions: prof.instructions ?? null,
                     temperature: prof.temperature ?? null,
                     maxTokens: prof.maxTokens ?? null,
                 };
             }),
-            agents: payload.agents.map((a) => ({
-                id: a.id,
-                name: a.name,
-                profileId: a.profileId,
-                description: a.description,
-            })),
+            agents: payload.agents.map((a) => {
+                const remappedProfileId = selectedProfilesByFamily.agentProfileMap.get(a.id ?? '') ?? a.profileId;
+                return {
+                    id: a.id,
+                    name: a.name,
+                    profileId: remappedProfileId,
+                    description: a.description,
+                };
+            }),
             statuses: payload.statuses.map((s) => ({
                 id: s.id,
                 label: s.label,
@@ -221,6 +239,7 @@ let ProjectsService = class ProjectsService {
             agentNameToId: agentNameToNewId,
             profileNameToId: profileNameToNewId,
             providerNameToId: available,
+            profileNameRemapMap: selectedProfilesByFamily.profileNameRemapMap,
         });
         const { created: subscribersCreated } = await this.createSubscribersFromPayload(result.project.id, payload.subscribers);
         const registryConfig = this.settings.getRegistryConfig();
@@ -324,6 +343,7 @@ let ProjectsService = class ProjectsService {
                 id: prof.id,
                 name: prof.name,
                 provider: { id: provider.id, name: provider.name },
+                familySlug: prof.familySlug,
                 options: sanitizeOptionsString(prof.options),
                 instructions: prof.instructions,
                 temperature: prof.temperature,
@@ -452,8 +472,11 @@ let ProjectsService = class ProjectsService {
         logger.info({ projectId: input.projectId, dryRun: input.dryRun }, 'importProject');
         const isDryRun = input.dryRun ?? false;
         const payload = shared_1.ExportSchema.parse(input.payload ?? {});
+        const familyResult = await this.computeFamilyAlternatives(payload.profiles, payload.agents);
+        const needsMapping = familyResult.alternatives.some((alt) => !alt.defaultProviderAvailable);
         const providerNames = new Set((payload.profiles ?? []).map((p) => p.provider.name.trim().toLowerCase()));
         const { available, missing: missingProviders } = await this.resolveProviders(providerNames);
+        const selectedProfilesByFamily = this.selectProfilesForFamilies(payload.profiles, payload.agents, input.familyProviderMappings, available);
         const [existingPrompts, existingProfiles, existingAgents, existingStatuses, existingWatchers, existingSubscribers,] = await Promise.all([
             this.storage.listPrompts({ projectId: input.projectId, limit: 10000, offset: 0 }),
             this.storage.listAgentProfiles({ projectId: input.projectId, limit: 10000, offset: 0 }),
@@ -479,7 +502,7 @@ let ProjectsService = class ProjectsService {
             }
         }
         if (isDryRun) {
-            return {
+            const dryRunResponse = {
                 dryRun: true,
                 missingProviders,
                 unmatchedStatuses,
@@ -490,7 +513,7 @@ let ProjectsService = class ProjectsService {
                 counts: {
                     toImport: {
                         prompts: payload.prompts.length,
-                        profiles: payload.profiles.length,
+                        profiles: selectedProfilesByFamily.profilesToCreate.length,
                         agents: payload.agents.length,
                         statuses: payload.statuses.length,
                         watchers: payload.watchers.length,
@@ -506,10 +529,37 @@ let ProjectsService = class ProjectsService {
                     },
                 },
             };
+            if (needsMapping && !input.familyProviderMappings) {
+                dryRunResponse.providerMappingRequired = {
+                    missingProviders: familyResult.missingProviders,
+                    familyAlternatives: familyResult.alternatives,
+                    canImport: familyResult.canImport,
+                };
+            }
+            return dryRunResponse;
+        }
+        if (needsMapping && !input.familyProviderMappings) {
+            return {
+                success: false,
+                providerMappingRequired: {
+                    missingProviders: familyResult.missingProviders,
+                    familyAlternatives: familyResult.alternatives,
+                    canImport: familyResult.canImport,
+                },
+            };
         }
-        if (missingProviders.length > 0) {
+        if (!familyResult.canImport) {
+            throw new error_types_1.ValidationError('Cannot import: some profile families have no available providers', {
+                hint: 'Install the required providers or use a different template',
+                missingProviders: familyResult.missingProviders,
+                familyAlternatives: familyResult.alternatives,
+            });
+        }
+        const selectedProviderNames = new Set(selectedProfilesByFamily.profilesToCreate.map((p) => p.provider.name.trim().toLowerCase()));
+        const unavailableSelectedProviders = Array.from(selectedProviderNames).filter((name) => !available.has(name));
+        if (unavailableSelectedProviders.length > 0) {
             throw new error_types_1.ValidationError('Import aborted: missing providers', {
-                missingProviders,
+                missingProviders: unavailableSelectedProviders,
                 hint: 'Install/configure providers by name before importing profiles.',
             });
         }
@@ -615,7 +665,7 @@ let ProjectsService = class ProjectsService {
                     promptIdMap[p.id] = created.id;
                 createdPrompts.push({ id: created.id, title: created.title });
             }
-            for (const prof of payload.profiles) {
+            for (const prof of selectedProfilesByFamily.profilesToCreate) {
                 const providerId = available.get(prof.provider.name.trim().toLowerCase());
                 if (!providerId) {
                     throw new error_types_1.NotFoundError('Provider', prof.provider.name);
@@ -624,6 +674,7 @@ let ProjectsService = class ProjectsService {
                     projectId: input.projectId,
                     name: prof.name,
                     providerId,
+                    familySlug: prof.familySlug ?? null,
                     options: this.normalizeProfileOptions(prof.options),
                     systemPrompt: null,
                     instructions: prof.instructions ?? null,
@@ -634,7 +685,8 @@ let ProjectsService = class ProjectsService {
                 profileIdMap[profKey] = created.id;
             }
             for (const a of payload.agents) {
-                const oldProfileId = a.profileId ?? '';
+                const remappedProfileId = selectedProfilesByFamily.agentProfileMap.get(a.id ?? '');
+                const oldProfileId = remappedProfileId ?? a.profileId ?? '';
                 const newProfileId = oldProfileId && profileIdMap[oldProfileId] ? profileIdMap[oldProfileId] : undefined;
                 if (!newProfileId) {
                     throw new error_types_1.ValidationError(`Profile mapping missing for agent ${a.name}`, {
@@ -655,7 +707,7 @@ let ProjectsService = class ProjectsService {
                     ...a,
                     id: a.id || `name:${a.name.trim().toLowerCase()}`,
                 })),
-                profiles: payload.profiles.map((p) => ({
+                profiles: selectedProfilesByFamily.profilesToCreate.map((p) => ({
                     ...p,
                     id: p.id || `name:${p.name.trim().toLowerCase()}`,
                 })),
@@ -665,6 +717,7 @@ let ProjectsService = class ProjectsService {
                 agentNameToId: agentNameToNewId,
                 profileNameToId: profileNameToNewId,
                 providerNameToId: available,
+                profileNameRemapMap: selectedProfilesByFamily.profileNameRemapMap,
             });
             const { subscriberIdMap } = await this.createSubscribersFromPayload(input.projectId, payload.subscribers);
             logger.info({
@@ -723,6 +776,24 @@ let ProjectsService = class ProjectsService {
             const archiveStatusId = templateLabelToStatusId.get('archive') ?? null;
             const settingsResult = await this.applyProjectSettings(input.projectId, mergedSettings, { promptTitleToId, statusLabelToId: templateLabelToStatusId }, archiveStatusId);
             const initialPromptSet = settingsResult.initialPromptSet;
+            if (payload._manifest?.slug) {
+                let templateSource = 'registry';
+                try {
+                    this.unifiedTemplateService.getBundledTemplate(payload._manifest.slug);
+                    templateSource = 'bundled';
+                }
+                catch {
+                    templateSource = 'registry';
+                }
+                await this.settings.setProjectTemplateMetadata(input.projectId, {
+                    templateSlug: payload._manifest.slug,
+                    source: templateSource,
+                    installedVersion: payload._manifest.version ?? null,
+                    registryUrl: null,
+                    installedAt: new Date().toISOString(),
+                });
+                logger.info({ projectId: input.projectId, slug: payload._manifest.slug, source: templateSource }, 'Updated template metadata after import');
+            }
             return {
                 success: true,
                 mode: 'replace',
@@ -778,6 +849,181 @@ let ProjectsService = class ProjectsService {
         const missing = Array.from(providerNames).filter((n) => !available.has(n));
         return { available, missing };
     }
+    async computeFamilyAlternatives(templateProfiles, templateAgents) {
+        const localProviders = await this.storage.listProviders();
+        const availableProviderNames = new Set(localProviders.items.map((p) => p.name.trim().toLowerCase()));
+        const profileById = new Map();
+        for (const prof of templateProfiles) {
+            if (prof.id) {
+                profileById.set(prof.id, prof);
+            }
+        }
+        const usedFamilySlugs = new Set();
+        for (const agent of templateAgents) {
+            if (agent.profileId) {
+                const profile = profileById.get(agent.profileId);
+                if (profile?.familySlug) {
+                    usedFamilySlugs.add(profile.familySlug);
+                }
+            }
+        }
+        const familyProviders = new Map();
+        for (const prof of templateProfiles) {
+            const familySlug = prof.familySlug;
+            if (!familySlug)
+                continue;
+            if (!familyProviders.has(familySlug)) {
+                familyProviders.set(familySlug, new Map());
+            }
+            const providerName = prof.provider.name.trim().toLowerCase();
+            const familyMap = familyProviders.get(familySlug);
+            if (!familyMap.has(providerName)) {
+                familyMap.set(providerName, []);
+            }
+            familyMap.get(providerName).push(prof.name);
+        }
+        const alternatives = [];
+        const allMissingProviders = new Set();
+        let canImport = true;
+        for (const familySlug of usedFamilySlugs) {
+            const providersForFamily = familyProviders.get(familySlug);
+            if (!providersForFamily || providersForFamily.size === 0) {
+                logger.warn({ familySlug }, 'Family used by agent has no profiles');
+                continue;
+            }
+            const providerNamesForFamily = Array.from(providersForFamily.keys());
+            const defaultProvider = providerNamesForFamily[0];
+            const defaultProviderAvailable = availableProviderNames.has(defaultProvider);
+            const availableForFamily = providerNamesForFamily.filter((name) => availableProviderNames.has(name));
+            for (const provName of providerNamesForFamily) {
+                if (!availableProviderNames.has(provName)) {
+                    allMissingProviders.add(provName);
+                }
+            }
+            const hasAlternatives = availableForFamily.length > 0;
+            if (!hasAlternatives) {
+                canImport = false;
+            }
+            alternatives.push({
+                familySlug,
+                defaultProvider,
+                defaultProviderAvailable,
+                availableProviders: availableForFamily.sort(),
+                hasAlternatives,
+            });
+        }
+        return {
+            alternatives,
+            missingProviders: Array.from(allMissingProviders).sort(),
+            canImport,
+        };
+    }
+    selectProfilesForFamilies(templateProfiles, templateAgents, familyProviderMappings, availableProviders) {
+        const profileById = new Map();
+        for (const prof of templateProfiles) {
+            if (prof.id) {
+                profileById.set(prof.id, prof);
+            }
+        }
+        const profilesByFamilyAndProvider = new Map();
+        for (const prof of templateProfiles) {
+            if (!prof.familySlug)
+                continue;
+            const family = prof.familySlug;
+            const providerName = prof.provider.name.trim().toLowerCase();
+            if (!profilesByFamilyAndProvider.has(family)) {
+                profilesByFamilyAndProvider.set(family, new Map());
+            }
+            const familyMap = profilesByFamilyAndProvider.get(family);
+            if (!familyMap.has(providerName)) {
+                familyMap.set(providerName, prof);
+            }
+        }
+        const familyOriginalProviders = new Map();
+        for (const agent of templateAgents) {
+            if (!agent.profileId)
+                continue;
+            const profile = profileById.get(agent.profileId);
+            if (!profile?.familySlug)
+                continue;
+            const providerName = profile.provider.name.trim().toLowerCase();
+            familyOriginalProviders.set(profile.familySlug, providerName);
+        }
+        const selectedProfileIdsByFamily = new Map();
+        for (const [familySlug, providerMap] of profilesByFamilyAndProvider) {
+            let selectedProvider;
+            if (familyProviderMappings?.[familySlug]) {
+                selectedProvider = familyProviderMappings[familySlug].trim().toLowerCase();
+            }
+            else {
+                const originalProvider = familyOriginalProviders.get(familySlug);
+                if (originalProvider &&
+                    availableProviders.has(originalProvider) &&
+                    providerMap.has(originalProvider)) {
+                    selectedProvider = originalProvider;
+                }
+                else {
+                    for (const provName of providerMap.keys()) {
+                        if (availableProviders.has(provName)) {
+                            selectedProvider = provName;
+                            break;
+                        }
+                    }
+                }
+            }
+            if (selectedProvider && providerMap.has(selectedProvider)) {
+                const profile = providerMap.get(selectedProvider);
+                if (profile.id) {
+                    selectedProfileIdsByFamily.set(familySlug, profile.id);
+                }
+            }
+        }
+        const profilesToCreate = [];
+        const usedProfileIds = new Set();
+        for (const prof of templateProfiles) {
+            if (!prof.id || usedProfileIds.has(prof.id))
+                continue;
+            const providerName = prof.provider.name.trim().toLowerCase();
+            if (availableProviders.has(providerName)) {
+                usedProfileIds.add(prof.id);
+                profilesToCreate.push(prof);
+            }
+        }
+        const agentProfileMap = new Map();
+        for (const agent of templateAgents) {
+            if (!agent.id || !agent.profileId)
+                continue;
+            const originalProfile = profileById.get(agent.profileId);
+            if (!originalProfile) {
+                agentProfileMap.set(agent.id, agent.profileId);
+                continue;
+            }
+            if (originalProfile.familySlug) {
+                const selectedProfileId = selectedProfileIdsByFamily.get(originalProfile.familySlug);
+                agentProfileMap.set(agent.id, selectedProfileId ?? agent.profileId);
+            }
+            else {
+                agentProfileMap.set(agent.id, agent.profileId);
+            }
+        }
+        const profileNameRemapMap = new Map();
+        for (const [familySlug, providerMap] of profilesByFamilyAndProvider) {
+            const selectedProfileId = selectedProfileIdsByFamily.get(familySlug);
+            const selectedProfile = selectedProfileId
+                ? templateProfiles.find((p) => p.id === selectedProfileId)
+                : undefined;
+            if (selectedProfile) {
+                const selectedNameLower = selectedProfile.name.trim().toLowerCase();
+                for (const profile of providerMap.values()) {
+                    const profileNameLower = profile.name.trim().toLowerCase();
+                    if (profileNameLower !== selectedNameLower) {
+                        profileNameRemapMap.set(profileNameLower, selectedNameLower);
+                    }
+                }
+            }
+        }
+        return { profilesToCreate, agentProfileMap, profileNameRemapMap };
+    }
     buildNameToIdMaps(payload, mappings) {
         const agentNameToId = new Map();
         for (const a of payload.agents) {
@@ -823,6 +1069,20 @@ let ProjectsService = class ProjectsService {
                     }
                     case 'profile': {
                         scopeFilterId = maps.profileNameToId.get(scopeFilterNameLower) ?? null;
+                        if (!scopeFilterId && maps.profileNameRemapMap) {
+                            const remappedName = maps.profileNameRemapMap.get(scopeFilterNameLower);
+                            if (remappedName) {
+                                scopeFilterId = maps.profileNameToId.get(remappedName) ?? null;
+                                if (scopeFilterId) {
+                                    logger.info({
+                                        projectId,
+                                        watcherName: w.name,
+                                        originalProfile: w.scopeFilterName,
+                                        remappedProfile: remappedName,
+                                    }, 'Watcher profile scope remapped due to provider family selection');
+                                }
+                            }
+                        }
                         break;
                     }
                     case 'provider': {
@@ -999,6 +1259,36 @@ let ProjectsService = class ProjectsService {
             .replace(/[^a-z0-9]+/g, '-')
             .replace(/(^-|-$)/g, '');
     }
+    async getTemplateManifestForProject(projectId) {
+        const metadata = this.settings.getProjectTemplateMetadata(projectId);
+        if (!metadata?.templateSlug) {
+            logger.debug({ projectId }, 'No template metadata for project');
+            return null;
+        }
+        try {
+            if (metadata.source === 'bundled') {
+                const template = this.unifiedTemplateService.getBundledTemplate(metadata.templateSlug);
+                return template.content._manifest ?? null;
+            }
+            else {
+                const template = await this.unifiedTemplateService.getTemplate(metadata.templateSlug, metadata.installedVersion ?? undefined);
+                if (template.source !== 'registry') {
+                    logger.debug({
+                        projectId,
+                        templateSlug: metadata.templateSlug,
+                        expectedSource: 'registry',
+                        actualSource: template.source,
+                    }, 'Template source mismatch - registry template not available, rejecting bundled fallback');
+                    return null;
+                }
+                return template.content._manifest ?? null;
+            }
+        }
+        catch (error) {
+            logger.debug({ projectId, templateSlug: metadata.templateSlug, error }, 'Failed to fetch template manifest for project');
+            return null;
+        }
+    }
 };
 exports.ProjectsService = ProjectsService;
 exports.ProjectsService = ProjectsService = __decorate([