devchain-cli 0.4.6 → 0.5.1

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,13 +239,16 @@ 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 manifestVersion = payload._manifest?.version ?? null;
+        const installedVersion = templateResult.version ?? manifestVersion;
         const registryConfig = this.settings.getRegistryConfig();
         await this.settings.setProjectTemplateMetadata(result.project.id, {
             templateSlug: input.slug,
             source: templateResult.source,
-            installedVersion: templateResult.version,
+            installedVersion,
             registryUrl: templateResult.source === 'registry' ? registryConfig.url : null,
             installedAt: new Date().toISOString(),
         });
@@ -235,7 +256,7 @@ let ProjectsService = class ProjectsService {
             projectId: result.project.id,
             slug: input.slug,
             source: templateResult.source,
-            version: templateResult.version,
+            version: installedVersion,
         }, 'Template metadata set for project');
         return {
             success: true,
@@ -324,6 +345,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 +474,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 +504,7 @@ let ProjectsService = class ProjectsService {
             }
         }
         if (isDryRun) {
-            return {
+            const dryRunResponse = {
                 dryRun: true,
                 missingProviders,
                 unmatchedStatuses,
@@ -490,7 +515,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 +531,37 @@ let ProjectsService = class ProjectsService {
                     },
                 },
             };
+            if (needsMapping && !input.familyProviderMappings) {
+                dryRunResponse.providerMappingRequired = {
+                    missingProviders: familyResult.missingProviders,
+                    familyAlternatives: familyResult.alternatives,
+                    canImport: familyResult.canImport,
+                };
+            }
+            return dryRunResponse;
         }
-        if (missingProviders.length > 0) {
+        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 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 +667,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 +676,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 +687,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 +709,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 +719,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 +778,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 +851,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 +1071,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 +1261,102 @@ 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;
+        }
+    }
+    getBundledUpgradeVersion(templateSlug, installedVersion) {
+        if (!installedVersion) {
+            return null;
+        }
+        try {
+            const bundled = this.unifiedTemplateService.getBundledTemplate(templateSlug);
+            const manifest = bundled.content._manifest;
+            const bundledVersion = manifest?.version;
+            if (!bundledVersion) {
+                return null;
+            }
+            if (!(0, shared_1.isValidSemVer)(installedVersion) || !(0, shared_1.isValidSemVer)(bundledVersion)) {
+                logger.warn({ templateSlug, installedVersion, bundledVersion }, 'Invalid semver version detected, skipping upgrade check');
+                return null;
+            }
+            if ((0, shared_1.isLessThan)(installedVersion, bundledVersion)) {
+                return bundledVersion;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getBundledUpgradesForProjects(projects) {
+        const result = new Map();
+        const bundledVersionCache = new Map();
+        for (const project of projects) {
+            if (project.source !== 'bundled' || !project.templateSlug) {
+                result.set(project.projectId, null);
+                continue;
+            }
+            if (!bundledVersionCache.has(project.templateSlug)) {
+                try {
+                    const bundled = this.unifiedTemplateService.getBundledTemplate(project.templateSlug);
+                    const manifest = bundled.content._manifest;
+                    bundledVersionCache.set(project.templateSlug, manifest?.version ?? null);
+                }
+                catch {
+                    bundledVersionCache.set(project.templateSlug, null);
+                }
+            }
+            const bundledVersion = bundledVersionCache.get(project.templateSlug);
+            if (!bundledVersion || !project.installedVersion) {
+                result.set(project.projectId, null);
+                continue;
+            }
+            if (!(0, shared_1.isValidSemVer)(project.installedVersion) || !(0, shared_1.isValidSemVer)(bundledVersion)) {
+                logger.warn({
+                    projectId: project.projectId,
+                    templateSlug: project.templateSlug,
+                    installedVersion: project.installedVersion,
+                    bundledVersion,
+                }, 'Invalid semver version detected, skipping upgrade check');
+                result.set(project.projectId, null);
+                continue;
+            }
+            if ((0, shared_1.isLessThan)(project.installedVersion, bundledVersion)) {
+                result.set(project.projectId, bundledVersion);
+            }
+            else {
+                result.set(project.projectId, null);
+            }
+        }
+        return result;
+    }
 };
 exports.ProjectsService = ProjectsService;
 exports.ProjectsService = ProjectsService = __decorate([