devchain-cli 0.8.5 → 0.9.1

package/dist/server/modules/skills/services/skill-sync.service.d.ts

@@ -0,0 +1,38 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { SettingsService } from '../../settings/services/settings.service';
+import { SkillCategoryService } from './skill-category.service';
+import { SkillSourceRegistryService } from './skill-source-registry.service';
+import { SkillsService } from './skills.service';
+export interface SyncError {
+    sourceName: string;
+    skillSlug?: string;
+    message: string;
+}
+export interface SyncResult {
+    status: 'completed' | 'already_running';
+    added: number;
+    updated: number;
+    failed: number;
+    unchanged: number;
+    errors: SyncError[];
+}
+export declare class SkillSyncService implements OnApplicationBootstrap {
+    private readonly skillSourceRegistry;
+    private readonly skillsService;
+    private readonly skillCategoryService;
+    private readonly settingsService;
+    private syncInProgress;
+    constructor(skillSourceRegistry: SkillSourceRegistryService, skillsService: SkillsService, skillCategoryService: SkillCategoryService, settingsService: SettingsService);
+    onApplicationBootstrap(): void;
+    syncAll(): Promise<SyncResult>;
+    syncSource(sourceName: string): Promise<SyncResult>;
+    private withMutex;
+    private syncAdapter;
+    private markSkillSyncError;
+    private buildSkillSlug;
+    private getExistingSkill;
+    private createEmptyResult;
+    private createAlreadyRunningResult;
+    private mergeSyncResults;
+    private isSourceEnabled;
+}

package/dist/server/modules/skills/services/skill-sync.service.js

@@ -0,0 +1,281 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillSyncService = void 0;
+const common_1 = require("@nestjs/common");
+const error_types_1 = require("../../../common/errors/error-types");
+const logger_1 = require("../../../common/logging/logger");
+const settings_service_1 = require("../../settings/services/settings.service");
+const skill_category_service_1 = require("./skill-category.service");
+const skill_source_registry_service_1 = require("./skill-source-registry.service");
+const skills_service_1 = require("./skills.service");
+const logger = (0, logger_1.createLogger)('SkillSyncService');
+let SkillSyncService = class SkillSyncService {
+    constructor(skillSourceRegistry, skillsService, skillCategoryService, settingsService) {
+        this.skillSourceRegistry = skillSourceRegistry;
+        this.skillsService = skillsService;
+        this.skillCategoryService = skillCategoryService;
+        this.settingsService = settingsService;
+        this.syncInProgress = false;
+    }
+    onApplicationBootstrap() {
+        if (!this.settingsService.getSkillsSyncOnStartup()) {
+            logger.info('Startup skills sync disabled via settings');
+            return;
+        }
+        void this.syncAll().catch((error) => {
+            logger.error({ error: error instanceof Error ? error.message : String(error) }, 'Startup skills sync failed');
+        });
+    }
+    async syncAll() {
+        return this.withMutex(async () => {
+            const adapters = await this.skillSourceRegistry.getAdapters();
+            const sourceSettings = this.settingsService.getSkillSourcesEnabled();
+            const enabledAdapters = adapters.filter((adapter) => this.isSourceEnabled(adapter.sourceName, sourceSettings));
+            for (const adapter of adapters) {
+                if (!this.isSourceEnabled(adapter.sourceName, sourceSettings)) {
+                    logger.info({ sourceName: adapter.sourceName }, 'Skill sync skipped because source is disabled');
+                }
+            }
+            if (enabledAdapters.length === 0) {
+                return this.createEmptyResult();
+            }
+            const settledResults = await Promise.allSettled(enabledAdapters.map((adapter) => this.syncAdapter(adapter)));
+            return settledResults.reduce((acc, result, index) => {
+                if (result.status === 'fulfilled') {
+                    return this.mergeSyncResults(acc, result.value);
+                }
+                const adapterName = enabledAdapters[index]?.sourceName ?? 'unknown';
+                acc.failed += 1;
+                acc.errors.push({
+                    sourceName: adapterName,
+                    message: result.reason instanceof Error ? result.reason.message : String(result.reason),
+                });
+                return acc;
+            }, this.createEmptyResult());
+        });
+    }
+    async syncSource(sourceName) {
+        const normalizedSourceName = sourceName.trim().toLowerCase();
+        const adapter = await this.skillSourceRegistry.getAdapterBySourceName(normalizedSourceName);
+        if (!adapter) {
+            throw new error_types_1.ValidationError(`Unknown skill source: ${normalizedSourceName}`, {
+                sourceName: normalizedSourceName,
+            });
+        }
+        if (!this.isSourceEnabled(normalizedSourceName, this.settingsService.getSkillSourcesEnabled())) {
+            logger.info({ sourceName: normalizedSourceName }, 'Skill sync skipped because source is disabled');
+            return this.createEmptyResult();
+        }
+        return this.withMutex(() => this.syncAdapter(adapter));
+    }
+    async withMutex(run) {
+        if (this.syncInProgress) {
+            logger.info('Skill sync skipped because another sync is already running');
+            return this.createAlreadyRunningResult();
+        }
+        this.syncInProgress = true;
+        try {
+            return await run();
+        }
+        finally {
+            this.syncInProgress = false;
+        }
+    }
+    async syncAdapter(adapter) {
+        const result = this.createEmptyResult();
+        let sourceCommit = '';
+        let syncContext = null;
+        try {
+            sourceCommit = await adapter.getLatestCommit();
+            syncContext = await adapter.createSyncContext();
+        }
+        catch (error) {
+            if (syncContext) {
+                try {
+                    await syncContext.dispose();
+                }
+                catch (disposeError) {
+                    logger.warn({
+                        sourceName: adapter.sourceName,
+                        error: disposeError instanceof Error ? disposeError.message : String(disposeError),
+                    }, 'Failed to dispose skill sync context after setup failure');
+                }
+            }
+            result.failed += 1;
+            result.errors.push({
+                sourceName: adapter.sourceName,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            return result;
+        }
+        if (!syncContext) {
+            return result;
+        }
+        try {
+            for (const [skillName, manifest] of syncContext.manifests.entries()) {
+                const skillSlug = this.buildSkillSlug(adapter.sourceName, skillName);
+                const existingSkill = await this.getExistingSkill(skillSlug);
+                const isUnchanged = existingSkill &&
+                    existingSkill.sourceCommit === sourceCommit &&
+                    existingSkill.status !== 'sync_error';
+                if (isUnchanged) {
+                    result.unchanged += 1;
+                    continue;
+                }
+                try {
+                    const contentPath = await syncContext.downloadSkill(skillName, '');
+                    await this.skillsService.upsertSkill(skillSlug, {
+                        name: manifest.name || skillName,
+                        displayName: manifest.displayName ?? manifest.name ?? skillName,
+                        description: manifest.description,
+                        shortDescription: manifest.shortDescription ?? null,
+                        source: adapter.sourceName,
+                        sourceUrl: manifest.sourceUrl,
+                        sourceCommit,
+                        category: this.skillCategoryService.deriveCategory(manifest.name || skillName, manifest.description, manifest.compatibility),
+                        license: manifest.license ?? null,
+                        compatibility: manifest.compatibility ?? null,
+                        frontmatter: manifest.frontmatter ?? {},
+                        instructionContent: manifest.instructionContent,
+                        contentPath,
+                        resources: manifest.resources,
+                        status: 'available',
+                        lastSyncedAt: new Date().toISOString(),
+                    });
+                    if (existingSkill) {
+                        result.updated += 1;
+                    }
+                    else {
+                        result.added += 1;
+                    }
+                }
+                catch (error) {
+                    result.failed += 1;
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    result.errors.push({
+                        sourceName: adapter.sourceName,
+                        skillSlug,
+                        message: errorMessage,
+                    });
+                    await this.markSkillSyncError({
+                        adapter,
+                        skillName,
+                        skillSlug,
+                        sourceCommit,
+                        manifest,
+                    });
+                    if (error instanceof error_types_1.TimeoutError) {
+                        logger.warn({ sourceName: adapter.sourceName, skillSlug, error: error.message }, 'Skill download timed out; skill marked as sync_error');
+                    }
+                }
+            }
+        }
+        finally {
+            try {
+                await syncContext.dispose();
+            }
+            catch (error) {
+                logger.warn({
+                    sourceName: adapter.sourceName,
+                    error: error instanceof Error ? error.message : String(error),
+                }, 'Failed to dispose skill sync context');
+            }
+        }
+        return result;
+    }
+    async markSkillSyncError(params) {
+        try {
+            await this.skillsService.upsertSkill(params.skillSlug, {
+                name: params.manifest.name || params.skillName,
+                displayName: params.manifest.displayName ?? params.manifest.name ?? params.skillName,
+                description: params.manifest.description,
+                shortDescription: params.manifest.shortDescription ?? null,
+                source: params.adapter.sourceName,
+                sourceUrl: params.manifest.sourceUrl,
+                sourceCommit: params.sourceCommit,
+                category: this.skillCategoryService.deriveCategory(params.manifest.name || params.skillName, params.manifest.description, params.manifest.compatibility),
+                license: params.manifest.license ?? null,
+                compatibility: params.manifest.compatibility ?? null,
+                frontmatter: params.manifest.frontmatter ?? {},
+                instructionContent: params.manifest.instructionContent,
+                resources: params.manifest.resources,
+                status: 'sync_error',
+            });
+        }
+        catch (error) {
+            logger.error({
+                sourceName: params.adapter.sourceName,
+                skillSlug: params.skillSlug,
+                error: error instanceof Error ? error.message : String(error),
+            }, 'Failed to mark skill as sync_error after sync failure');
+        }
+    }
+    buildSkillSlug(sourceName, skillName) {
+        const normalizedSource = sourceName.trim().toLowerCase();
+        const normalizedSkill = skillName.trim().toLowerCase();
+        return `${normalizedSource}/${normalizedSkill}`;
+    }
+    async getExistingSkill(slug) {
+        try {
+            return await this.skillsService.getSkillBySlug(slug);
+        }
+        catch (error) {
+            if (error instanceof error_types_1.NotFoundError) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    createEmptyResult() {
+        return {
+            status: 'completed',
+            added: 0,
+            updated: 0,
+            failed: 0,
+            unchanged: 0,
+            errors: [],
+        };
+    }
+    createAlreadyRunningResult() {
+        return {
+            status: 'already_running',
+            added: 0,
+            updated: 0,
+            failed: 0,
+            unchanged: 0,
+            errors: [],
+        };
+    }
+    mergeSyncResults(left, right) {
+        return {
+            status: 'completed',
+            added: left.added + right.added,
+            updated: left.updated + right.updated,
+            failed: left.failed + right.failed,
+            unchanged: left.unchanged + right.unchanged,
+            errors: [...left.errors, ...right.errors],
+        };
+    }
+    isSourceEnabled(sourceName, sourceSettings) {
+        const normalizedSourceName = sourceName.trim().toLowerCase();
+        return sourceSettings[normalizedSourceName] !== false;
+    }
+};
+exports.SkillSyncService = SkillSyncService;
+exports.SkillSyncService = SkillSyncService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [skill_source_registry_service_1.SkillSourceRegistryService,
+        skills_service_1.SkillsService,
+        skill_category_service_1.SkillCategoryService,
+        settings_service_1.SettingsService])
+], SkillSyncService);
+//# sourceMappingURL=skill-sync.service.js.map

package/dist/server/modules/skills/services/skill-sync.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-sync.service.js","sourceRoot":"","sources":["../../../../src/modules/skills/services/skill-sync.service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,119 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import { SettingsService } from '../../settings/services/settings.service';
+import type { ResolvedSkillSummary } from '../dtos/skill.dto';
+import type { Skill, SkillStatus, SkillUsageLog as SkillUsageLogModel } from '../../storage/models/domain.models';
+import { SkillSourceRegistryService } from './skill-source-registry.service';
+export interface ListSkillsOptions {
+    source?: string;
+    category?: string;
+    status?: SkillStatus;
+    q?: string;
+}
+export interface ListProjectSkillsOptions {
+    q?: string;
+    source?: string;
+    category?: string;
+}
+export interface ProjectSkill extends Skill {
+    disabled: boolean;
+}
+export interface UpsertSkillData {
+    name?: string;
+    displayName?: string;
+    description?: string | null;
+    shortDescription?: string | null;
+    source?: string;
+    sourceUrl?: string | null;
+    sourceCommit?: string | null;
+    category?: string | null;
+    license?: string | null;
+    compatibility?: string | null;
+    frontmatter?: Record<string, unknown> | null;
+    instructionContent?: string | null;
+    contentPath?: string | null;
+    resources?: string[];
+    status?: SkillStatus;
+    lastSyncedAt?: string | null;
+}
+export interface SkillUsageStatsOptions {
+    projectId?: string | null;
+    from?: string;
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface SkillUsageStat {
+    skillId: string;
+    skillSlug: string;
+    usageCount: number;
+    firstAccessedAt: string | null;
+    lastAccessedAt: string | null;
+    skillName: string | null;
+    skillDisplayName: string | null;
+}
+export interface SkillUsageLogOptions {
+    projectId?: string;
+    skillId?: string;
+    agentId?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface SkillUsageLogListResult {
+    items: SkillUsageLogModel[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface SkillSourceMetadata {
+    name: string;
+    enabled: boolean;
+    repoUrl: string;
+    skillCount: number;
+}
+export declare class SkillsService {
+    private readonly db;
+    private readonly settingsService;
+    private readonly skillSourceRegistry;
+    constructor(db: BetterSQLite3Database, settingsService: SettingsService, skillSourceRegistry: SkillSourceRegistryService);
+    listSkills(options?: ListSkillsOptions): Promise<Skill[]>;
+    listAllForProject(projectId: string, options?: ListProjectSkillsOptions): Promise<ProjectSkill[]>;
+    listDiscoverable(projectId: string, options?: ListProjectSkillsOptions): Promise<Skill[]>;
+    getSkill(id: string): Promise<Skill>;
+    getSkillBySlug(slug: string): Promise<Skill>;
+    resolveSkillSummariesBySlugs(slugsToResolve: string[]): Promise<Record<string, ResolvedSkillSummary>>;
+    upsertSkill(slug: string, data: UpsertSkillData): Promise<Skill>;
+    disableSkill(projectId: string, skillId: string): Promise<void>;
+    enableSkill(projectId: string, skillId: string): Promise<void>;
+    listDisabled(projectId: string): Promise<string[]>;
+    disableAll(projectId: string): Promise<number>;
+    enableAll(projectId: string): Promise<number>;
+    listSources(): Promise<SkillSourceMetadata[]>;
+    setSourceEnabled(sourceName: string, enabled: boolean): Promise<{
+        name: string;
+        enabled: boolean;
+    }>;
+    logUsage(skillId: string, skillSlug: string, projectId?: string | null, agentId?: string | null, agentNameSnapshot?: string | null): Promise<SkillUsageLogModel>;
+    getUsageStats(options?: SkillUsageStatsOptions): Promise<SkillUsageStat[]>;
+    listUsageLog(options?: SkillUsageLogOptions): Promise<SkillUsageLogListResult>;
+    private appendProjectSkillFilterConditions;
+    private mapSkillRow;
+    private parseJsonObject;
+    private parseResources;
+    private serializeJsonObject;
+    private serializeResources;
+    private validateStatus;
+    private parseStatus;
+    private normalizeNullableString;
+    private requireNonEmpty;
+    private combineConditions;
+    private getRegisteredSources;
+    private getEnabledSources;
+    private isSourceEnabled;
+    private requireKnownSourceName;
+    private isUniqueConstraintError;
+    private isForeignKeyConstraintError;
+    private readErrorCode;
+    private readErrorMessage;
+}