devchain-cli 0.9.1 → 0.10.0

package/dist/server/modules/skills/adapters/local-skill-source.adapter.js

@@ -0,0 +1,265 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalSkillSourceAdapter = void 0;
+const node_crypto_1 = require("node:crypto");
+const fs = __importStar(require("node:fs/promises"));
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const error_types_1 = require("../../../common/errors/error-types");
+const logger_1 = require("../../../common/logging/logger");
+const skill_parsing_utils_1 = require("./skill-parsing.utils");
+const logger = (0, logger_1.createLogger)('LocalSkillSourceAdapter');
+const SKILLS_DIRECTORY = 'skills';
+const DEFAULT_SKILLS_ROOT = (0, node_path_1.join)((0, node_os_1.homedir)(), '.devchain', 'skills');
+class LocalSkillSourceAdapter {
+    constructor(source) {
+        this.sourceName = source.name.trim().toLowerCase();
+        this.folderPath = (0, node_path_1.resolve)(source.folderPath);
+        this.repoUrl = (0, node_url_1.pathToFileURL)(this.folderPath).toString();
+    }
+    async listSkills() {
+        const context = await this.createSyncContext();
+        try {
+            return new Map(context.manifests);
+        }
+        finally {
+            await context.dispose();
+        }
+    }
+    async createSyncContext() {
+        const manifests = new Map();
+        const skillNames = await this.listSkillNamesFromLocalFolder();
+        for (const skillName of skillNames) {
+            try {
+                const skillDirectory = await this.resolveStrictLocalSkillDirectory(skillName);
+                const parsedSkill = await (0, skill_parsing_utils_1.parseSkillMarkdown)(skillDirectory, {
+                    onMissingFile: ({ skillMdPath }) => {
+                        logger.warn({ sourceName: this.sourceName, skillMdPath }, 'SKILL.md not found for skill');
+                    },
+                    onParseError: ({ skillMdPath, error }) => {
+                        logger.warn({
+                            sourceName: this.sourceName,
+                            skillMdPath,
+                            error: error instanceof Error ? error.message : String(error),
+                        }, 'Failed to parse SKILL.md frontmatter for skill. Skipping malformed file.');
+                    },
+                });
+                if (!parsedSkill) {
+                    continue;
+                }
+                manifests.set(skillName, this.toSkillManifest(skillName, parsedSkill));
+            }
+            catch (error) {
+                logger.warn({
+                    sourceName: this.sourceName,
+                    skillName,
+                    error: error instanceof Error ? error.message : String(error),
+                }, 'Failed processing local skill. Skipping.');
+            }
+        }
+        return {
+            manifests,
+            downloadSkill: (skillName, targetPath) => this.downloadSkill(skillName, targetPath),
+            dispose: async () => undefined,
+        };
+    }
+    async downloadSkill(skillName, targetPath) {
+        const safeSourceName = (0, skill_parsing_utils_1.validatePathSegment)(this.sourceName, 'sourceName');
+        const safeSkillName = (0, skill_parsing_utils_1.validatePathSegment)(skillName, 'skillName');
+        const storageRoot = typeof targetPath === 'string' && targetPath.trim().length > 0
+            ? (0, node_path_1.resolve)(targetPath)
+            : DEFAULT_SKILLS_ROOT;
+        const sourceRoot = (0, node_path_1.resolve)(storageRoot, safeSourceName);
+        const destinationPath = (0, node_path_1.resolve)(sourceRoot, safeSkillName);
+        if (!destinationPath.startsWith(`${sourceRoot}${node_path_1.sep}`)) {
+            throw new error_types_1.ValidationError('Resolved skill destination path is outside the source directory.', { sourceRoot, destinationPath });
+        }
+        try {
+            const resolvedSkillPath = await this.resolveStrictLocalSkillDirectory(safeSkillName);
+            await fs.mkdir(sourceRoot, { recursive: true });
+            await fs.rm(destinationPath, { recursive: true, force: true });
+            await fs.cp(resolvedSkillPath, destinationPath, { recursive: true, force: true });
+            return destinationPath;
+        }
+        catch (error) {
+            throw this.wrapStorageError('Failed to copy skill from local source.', error, {
+                sourceName: safeSourceName,
+                skillName: safeSkillName,
+            });
+        }
+    }
+    async getLatestCommit() {
+        const skillsRoot = (0, node_path_1.join)(this.folderPath, SKILLS_DIRECTORY);
+        let rootStats;
+        try {
+            rootStats = await fs.stat(skillsRoot);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new error_types_1.StorageError('Local skills directory not found in source folder.', {
+                    sourceName: this.sourceName,
+                    folderPath: this.folderPath,
+                    skillsRoot,
+                });
+            }
+            throw this.wrapStorageError('Failed to read local skills directory metadata.', error, {
+                sourceName: this.sourceName,
+                skillsRoot,
+            });
+        }
+        if (!rootStats.isDirectory()) {
+            throw new error_types_1.StorageError('Local skills path is not a directory.', {
+                sourceName: this.sourceName,
+                folderPath: this.folderPath,
+                skillsRoot,
+            });
+        }
+        const hashParts = [`root:${skillsRoot}`];
+        const skillNames = await this.listSkillNamesFromLocalFolder();
+        for (const skillName of skillNames) {
+            hashParts.push(`dir:${skillName}`);
+            const skillMdPath = (0, node_path_1.join)(skillsRoot, skillName, 'SKILL.md');
+            try {
+                const skillMdStats = await fs.stat(skillMdPath);
+                hashParts.push(`skill:${skillName}:${skillMdStats.mtimeMs}`);
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    hashParts.push(`skill:${skillName}:missing`);
+                    continue;
+                }
+                throw this.wrapStorageError('Failed to read local skill metadata for commit hash.', error, {
+                    sourceName: this.sourceName,
+                    skillsRoot,
+                    skillName,
+                    skillMdPath,
+                });
+            }
+        }
+        return (0, node_crypto_1.createHash)('sha1').update(hashParts.join('|')).digest('hex');
+    }
+    async listSkillNamesFromLocalFolder() {
+        const skillsRoot = (0, node_path_1.join)(this.folderPath, SKILLS_DIRECTORY);
+        let entries;
+        try {
+            entries = await fs.readdir(skillsRoot, { withFileTypes: true });
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new error_types_1.StorageError('Local skills directory not found in source folder.', {
+                    sourceName: this.sourceName,
+                    folderPath: this.folderPath,
+                    skillsRoot,
+                });
+            }
+            throw this.wrapStorageError('Failed reading local skills directory.', error, {
+                sourceName: this.sourceName,
+                skillsRoot,
+            });
+        }
+        return entries
+            .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
+            .map((entry) => entry.name)
+            .sort((left, right) => left.localeCompare(right));
+    }
+    async resolveStrictLocalSkillDirectory(skillName) {
+        try {
+            return await (0, skill_parsing_utils_1.resolveSkillDirectory)(this.folderPath, skillName, {
+                candidates: [SKILLS_DIRECTORY],
+                onCandidateError: ({ candidate, error }) => {
+                    throw this.wrapStorageError('Failed checking local skill directory.', error, {
+                        sourceName: this.sourceName,
+                        skillName,
+                        candidate,
+                    });
+                },
+            });
+        }
+        catch (error) {
+            if (error instanceof skill_parsing_utils_1.SkillDirectoryNotFoundError) {
+                throw new error_types_1.StorageError('Skill directory was not found in local source folder.', {
+                    sourceName: this.sourceName,
+                    skillName,
+                    folderPath: this.folderPath,
+                    skillsRoot: (0, node_path_1.join)(this.folderPath, SKILLS_DIRECTORY),
+                });
+            }
+            throw error;
+        }
+    }
+    toSkillManifest(skillName, parsedSkill) {
+        const frontmatter = parsedSkill.frontmatter;
+        const manifestName = (0, skill_parsing_utils_1.pickString)(frontmatter, ['name']) ?? skillName;
+        const displayName = (0, skill_parsing_utils_1.pickString)(frontmatter, ['displayName', 'display_name', 'title']);
+        const description = (0, skill_parsing_utils_1.pickString)(frontmatter, ['description', 'summary', 'shortDescription']) ??
+            `Skill instructions for ${skillName}`;
+        const shortDescription = (0, skill_parsing_utils_1.pickString)(frontmatter, [
+            'shortDescription',
+            'short_description',
+            'summary',
+        ]);
+        const license = (0, skill_parsing_utils_1.pickString)(frontmatter, ['license']);
+        const compatibility = (0, skill_parsing_utils_1.pickString)(frontmatter, ['compatibility']);
+        const resources = (0, skill_parsing_utils_1.pickStringArray)(frontmatter, ['resources', 'references']);
+        return {
+            name: manifestName,
+            displayName,
+            description,
+            shortDescription,
+            license,
+            compatibility,
+            frontmatter,
+            instructionContent: parsedSkill.instructionContent,
+            resources,
+            sourceUrl: (0, node_url_1.pathToFileURL)((0, node_path_1.join)(this.folderPath, SKILLS_DIRECTORY, skillName)).toString(),
+        };
+    }
+    wrapStorageError(message, error, details) {
+        if (error instanceof error_types_1.StorageError) {
+            return error;
+        }
+        if (error instanceof error_types_1.ValidationError) {
+            throw error;
+        }
+        return new error_types_1.StorageError(message, {
+            ...details,
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+exports.LocalSkillSourceAdapter = LocalSkillSourceAdapter;
+//# sourceMappingURL=local-skill-source.adapter.js.map

package/dist/server/modules/skills/adapters/local-skill-source.adapter.js.map

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

package/dist/server/modules/skills/adapters/skill-parsing.utils.d.ts

@@ -0,0 +1,32 @@
+export interface ParsedSkillMarkdown {
+    frontmatter: Record<string, unknown>;
+    instructionContent: string;
+}
+export interface ParseSkillMarkdownOptions {
+    skillMarkdownFileName?: string;
+    onMissingFile?: (context: {
+        skillMdPath: string;
+    }) => void;
+    onParseError?: (context: {
+        skillMdPath: string;
+        error: unknown;
+    }) => void;
+}
+export interface ResolveSkillDirectoryOptions {
+    candidates?: readonly string[];
+    onCandidateError?: (context: {
+        candidate: string;
+        error: unknown;
+    }) => void;
+}
+export declare class SkillDirectoryNotFoundError extends Error {
+    readonly skillName: string;
+    readonly extractedRepoRoot: string;
+    readonly candidates: readonly string[];
+    constructor(skillName: string, extractedRepoRoot: string, candidates: readonly string[], message?: string);
+}
+export declare function parseSkillMarkdown(skillDirectory: string, options?: ParseSkillMarkdownOptions): Promise<ParsedSkillMarkdown | null>;
+export declare function resolveSkillDirectory(extractedRepoRoot: string, skillName: string, options?: ResolveSkillDirectoryOptions): Promise<string>;
+export declare function validatePathSegment(segment: string, fieldName: string): string;
+export declare function pickString(frontmatter: Record<string, unknown>, keys: readonly string[]): string | undefined;
+export declare function pickStringArray(frontmatter: Record<string, unknown>, keys: readonly string[]): string[];

package/dist/server/modules/skills/adapters/skill-parsing.utils.js

@@ -0,0 +1,169 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillDirectoryNotFoundError = void 0;
+exports.parseSkillMarkdown = parseSkillMarkdown;
+exports.resolveSkillDirectory = resolveSkillDirectory;
+exports.validatePathSegment = validatePathSegment;
+exports.pickString = pickString;
+exports.pickStringArray = pickStringArray;
+const fs = __importStar(require("node:fs/promises"));
+const node_path_1 = require("node:path");
+const gray_matter_1 = __importDefault(require("gray-matter"));
+const error_types_1 = require("../../../common/errors/error-types");
+const CONTROL_CHAR_REGEX = /[\u0000-\u001f\u007f]/;
+const SAFE_SKILL_SEGMENT_REGEX = /^[A-Za-z0-9_-]+$/;
+const DEFAULT_SKILL_MARKDOWN_FILE = 'SKILL.md';
+const DEFAULT_SKILL_DIRECTORY_CANDIDATES = ['', 'skills', 'library'];
+class SkillDirectoryNotFoundError extends Error {
+    constructor(skillName, extractedRepoRoot, candidates, message = 'Skill directory was not found in extracted repository tarball.') {
+        super(message);
+        this.name = 'SkillDirectoryNotFoundError';
+        this.skillName = skillName;
+        this.extractedRepoRoot = extractedRepoRoot;
+        this.candidates = candidates;
+    }
+}
+exports.SkillDirectoryNotFoundError = SkillDirectoryNotFoundError;
+async function parseSkillMarkdown(skillDirectory, options = {}) {
+    const safeSkillDirectory = (0, node_path_1.resolve)(skillDirectory);
+    const skillMdPath = (0, node_path_1.join)(safeSkillDirectory, options.skillMarkdownFileName ?? DEFAULT_SKILL_MARKDOWN_FILE);
+    let markdown;
+    try {
+        markdown = await fs.readFile(skillMdPath, 'utf-8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            options.onMissingFile?.({ skillMdPath });
+            return null;
+        }
+        throw error;
+    }
+    try {
+        const parsed = (0, gray_matter_1.default)(markdown);
+        const frontmatter = parsed.data && typeof parsed.data === 'object'
+            ? parsed.data
+            : {};
+        return {
+            frontmatter,
+            instructionContent: parsed.content,
+        };
+    }
+    catch (error) {
+        options.onParseError?.({ skillMdPath, error });
+        return null;
+    }
+}
+async function resolveSkillDirectory(extractedRepoRoot, skillName, options = {}) {
+    const safeExtractedRepoRoot = (0, node_path_1.resolve)(extractedRepoRoot);
+    const candidates = (options.candidates ?? DEFAULT_SKILL_DIRECTORY_CANDIDATES).map((candidate) => candidate
+        ? (0, node_path_1.join)(safeExtractedRepoRoot, candidate, skillName)
+        : (0, node_path_1.join)(safeExtractedRepoRoot, skillName));
+    for (const candidate of candidates) {
+        try {
+            const stats = await fs.stat(candidate);
+            if (stats.isDirectory()) {
+                return candidate;
+            }
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                options.onCandidateError?.({ candidate, error });
+                throw error;
+            }
+        }
+    }
+    throw new SkillDirectoryNotFoundError(skillName, safeExtractedRepoRoot, candidates);
+}
+function validatePathSegment(segment, fieldName) {
+    const trimmed = segment.trim();
+    if (!trimmed) {
+        throw new error_types_1.ValidationError(`Invalid ${fieldName}: value cannot be empty.`, { fieldName });
+    }
+    if (trimmed.includes('..') ||
+        trimmed.includes('/') ||
+        trimmed.includes('\\') ||
+        CONTROL_CHAR_REGEX.test(trimmed)) {
+        throw new error_types_1.ValidationError(`Invalid ${fieldName}: path traversal or control characters are not allowed.`, { fieldName, segment: trimmed });
+    }
+    if (!SAFE_SKILL_SEGMENT_REGEX.test(trimmed)) {
+        throw new error_types_1.ValidationError(`Invalid ${fieldName}: only alphanumeric characters, underscores, and hyphens are allowed.`, { fieldName, segment: trimmed });
+    }
+    return trimmed;
+}
+function pickString(frontmatter, keys) {
+    for (const key of keys) {
+        const value = toStringValue(frontmatter[key]);
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function pickStringArray(frontmatter, keys) {
+    for (const key of keys) {
+        const value = frontmatter[key];
+        if (!Array.isArray(value)) {
+            continue;
+        }
+        const items = value
+            .filter((item) => typeof item === 'string')
+            .map((item) => item.trim())
+            .filter((item) => item.length > 0);
+        if (items.length > 0) {
+            return items;
+        }
+    }
+    return [];
+}
+function toStringValue(value) {
+    if (typeof value === 'string' && value.trim().length > 0) {
+        return value.trim();
+    }
+    if (Array.isArray(value)) {
+        const items = value
+            .filter((item) => typeof item === 'string')
+            .map((item) => item.trim())
+            .filter((item) => item.length > 0);
+        if (items.length > 0) {
+            return items.join(', ');
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=skill-parsing.utils.js.map

package/dist/server/modules/skills/adapters/skill-parsing.utils.js.map

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

package/dist/server/modules/skills/controllers/local-sources.controller.d.ts

@@ -0,0 +1,12 @@
+import { type LocalSourceResponseDto } from '../dtos/local-sources.dto';
+import { LocalSourcesService } from '../services/local-sources.service';
+export declare class LocalSourcesController {
+    private readonly localSourcesService;
+    constructor(localSourcesService: LocalSourcesService);
+    listLocalSources(): Promise<LocalSourceResponseDto[]>;
+    createLocalSource(body: unknown): Promise<LocalSourceResponseDto>;
+    deleteLocalSource(params: unknown): Promise<{
+        success: true;
+    }>;
+    private toResponse;
+}

package/dist/server/modules/skills/controllers/local-sources.controller.js

@@ -0,0 +1,71 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalSourcesController = void 0;
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../../../common/logging/logger");
+const local_sources_dto_1 = require("../dtos/local-sources.dto");
+const local_sources_service_1 = require("../services/local-sources.service");
+const logger = (0, logger_1.createLogger)('LocalSourcesController');
+let LocalSourcesController = class LocalSourcesController {
+    constructor(localSourcesService) {
+        this.localSourcesService = localSourcesService;
+    }
+    async listLocalSources() {
+        logger.info('GET /api/skills/local-sources');
+        const sources = await this.localSourcesService.listLocalSources();
+        return sources.map((source) => this.toResponse(source));
+    }
+    async createLocalSource(body) {
+        logger.info('POST /api/skills/local-sources');
+        const parsed = local_sources_dto_1.CreateLocalSourceSchema.parse(body);
+        const created = await this.localSourcesService.createLocalSource(parsed);
+        return this.toResponse(created);
+    }
+    async deleteLocalSource(params) {
+        logger.info('DELETE /api/skills/local-sources/:id');
+        const parsed = local_sources_dto_1.LocalSourceDeleteParamsSchema.parse(params);
+        await this.localSourcesService.deleteLocalSource(parsed.id);
+        return { success: true };
+    }
+    toResponse(source) {
+        return local_sources_dto_1.LocalSourceResponseSchema.parse(source);
+    }
+};
+exports.LocalSourcesController = LocalSourcesController;
+__decorate([
+    (0, common_1.Get)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], LocalSourcesController.prototype, "listLocalSources", null);
+__decorate([
+    (0, common_1.Post)(),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], LocalSourcesController.prototype, "createLocalSource", null);
+__decorate([
+    (0, common_1.Delete)(':id'),
+    __param(0, (0, common_1.Param)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], LocalSourcesController.prototype, "deleteLocalSource", null);
+exports.LocalSourcesController = LocalSourcesController = __decorate([
+    (0, common_1.Controller)('api/skills/local-sources'),
+    __metadata("design:paramtypes", [local_sources_service_1.LocalSourcesService])
+], LocalSourcesController);
+//# sourceMappingURL=local-sources.controller.js.map

package/dist/server/modules/skills/controllers/local-sources.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-sources.controller.js","sourceRoot":"","sources":["../../../../src/modules/skills/controllers/local-sources.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA4E;AAC5E,2DAA8D;AAE9D,iEAKmC;AACnC,6EAAwE;AAExE,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,wBAAwB,CAAC,CAAC;AAG/C,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YAA6B,mBAAwC;QAAxC,wBAAmB,GAAnB,mBAAmB,CAAqB;IAAG,CAAC;IAGnE,AAAN,KAAK,CAAC,gBAAgB;QACpB,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,CAAC;QAClE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IAGK,AAAN,KAAK,CAAC,iBAAiB,CAAS,IAAa;QAC3C,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,2CAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAGK,AAAN,KAAK,CAAC,iBAAiB,CAAU,MAAe;QAC9C,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,iDAA6B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAEO,UAAU,CAAC,MAAwB;QACzC,OAAO,6CAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;CACF,CAAA;AA7BY,wDAAsB;AAI3B;IADL,IAAA,YAAG,GAAE;;;;8DAKL;AAGK;IADL,IAAA,aAAI,GAAE;IACkB,WAAA,IAAA,aAAI,GAAE,CAAA;;;;+DAK9B;AAGK;IADL,IAAA,eAAM,EAAC,KAAK,CAAC;IACW,WAAA,IAAA,cAAK,GAAE,CAAA;;;;+DAK/B;iCAxBU,sBAAsB;IADlC,IAAA,mBAAU,EAAC,0BAA0B,CAAC;qCAEa,2CAAmB;GAD1D,sBAAsB,CA6BlC"}

package/dist/server/modules/skills/controllers/skills.controller.d.ts

@@ -7,7 +7,7 @@ export declare class SkillsController {
     private readonly skillSyncService;
     constructor(skillsService: SkillsService, skillSyncService: SkillSyncService);
     syncSkills(body: unknown): Promise<SyncResult>;
-    listSources(): Promise<SkillSourceMetadata[]>;
+    listSources(query: unknown): Promise<SkillSourceMetadata[]>;
     enableSource(params: unknown): Promise<{
         name: string;
         enabled: boolean;
@@ -16,6 +16,16 @@ export declare class SkillsController {
         name: string;
         enabled: boolean;
     }>;
+    enableSourceForProject(params: unknown, body: unknown): Promise<{
+        name: string;
+        projectId: string;
+        projectEnabled: boolean;
+    }>;
+    disableSourceForProject(params: unknown, body: unknown): Promise<{
+        name: string;
+        projectId: string;
+        projectEnabled: boolean;
+    }>;
     listDisabled(query: unknown): Promise<string[]>;
     disableAll(body: unknown): Promise<{
         projectId: string;