@open-skills-hub/api 1.0.0

package/dist/controllers/feedback.js

@@ -0,0 +1,216 @@
+/**
+ * Open Skills Hub - Feedback Controller
+ */
+import { getStorage, generateUUID, now, hashIP, buildSkillFullName, parseSkillFullName, AppError, ErrorCodes, } from '@open-skills-hub/core';
+import { sendSuccess } from '../middleware/error.js';
+import { logger } from '../middleware/logger.js';
+/**
+ * Submit feedback for a skill
+ */
+export async function submitFeedback(request, reply) {
+    const storage = await getStorage();
+    const body = request.body;
+    // Parse name
+    const { scope, name: skillName } = parseSkillFullName(body.skillName);
+    const fullName = buildSkillFullName(skillName, scope);
+    const skill = await storage.getSkillByName(fullName);
+    if (!skill) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Skill '${fullName}' not found`, 404);
+    }
+    // Verify version exists
+    const version = await storage.getVersion(skill.id, body.skillVersion);
+    if (!version) {
+        throw new AppError(ErrorCodes.VERSION_NOT_FOUND, `Version '${body.skillVersion}' not found for skill '${fullName}'`, 404);
+    }
+    const feedbackId = generateUUID();
+    const timestamp = now();
+    const feedback = {
+        id: feedbackId,
+        skillId: skill.id,
+        skillVersion: body.skillVersion,
+        feedbackType: body.feedbackType,
+        rating: body.rating,
+        comment: body.comment,
+        context: body.context ?? {},
+        status: 'pending',
+        sourceIpHash: hashIP(request.ip),
+        createdAt: timestamp,
+    };
+    await storage.createFeedback(feedback);
+    // Update skill rating if this is a rating feedback
+    if (body.rating) {
+        const feedbacks = await storage.getFeedbacks(skill.id, { limit: 1000 });
+        const ratings = feedbacks.items.map(f => f.rating).filter((r) => r !== undefined);
+        const averageRating = ratings.length > 0
+            ? ratings.reduce((sum, r) => sum + r, 0) / ratings.length
+            : 0;
+        await storage.updateSkill(skill.id, {
+            rating: {
+                average: Math.round(averageRating * 10) / 10,
+                count: ratings.length,
+            },
+        });
+    }
+    // Create audit log
+    const auditLog = {
+        id: generateUUID(),
+        timestamp,
+        eventType: 'feedback.submitted',
+        actor: {
+            type: request.user?.type ?? 'user',
+            id: request.user?.id,
+            username: request.user?.username,
+            ip: request.ip,
+            userAgent: request.headers['user-agent'],
+        },
+        resource: {
+            type: 'feedback',
+            id: feedbackId,
+            name: fullName,
+            version: body.skillVersion,
+        },
+        action: 'create',
+        result: 'success',
+        details: {
+            feedbackType: body.feedbackType,
+            rating: body.rating,
+        },
+    };
+    await storage.createAuditLog(auditLog);
+    logger.info('Feedback submitted', {
+        feedbackId,
+        skillName: fullName,
+        feedbackType: body.feedbackType,
+        rating: body.rating,
+    });
+    sendSuccess(request, reply, {
+        id: feedbackId,
+        status: 'pending',
+        createdAt: timestamp,
+    }, 201);
+}
+/**
+ * Get feedbacks for a skill
+ */
+export async function getSkillFeedbacks(request, reply) {
+    const storage = await getStorage();
+    const { name } = request.params;
+    const { cursor, limit, feedbackType, status } = request.query;
+    // Parse name
+    const { scope, name: skillName } = parseSkillFullName(name);
+    const fullName = buildSkillFullName(skillName, scope);
+    const skill = await storage.getSkillByName(fullName);
+    if (!skill) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Skill '${fullName}' not found`, 404);
+    }
+    const result = await storage.getFeedbacks(skill.id, {
+        cursor,
+        limit,
+        feedbackType,
+        status,
+    });
+    // Remove sensitive data
+    const feedbacks = result.items.map(f => ({
+        id: f.id,
+        skillVersion: f.skillVersion,
+        feedbackType: f.feedbackType,
+        rating: f.rating,
+        comment: f.comment,
+        context: f.context,
+        status: f.status,
+        createdAt: f.createdAt,
+    }));
+    sendSuccess(request, reply, feedbacks, 200, result.pagination);
+}
+/**
+ * Get feedback by ID
+ */
+export async function getFeedbackById(request, reply) {
+    const storage = await getStorage();
+    const { id } = request.params;
+    const feedback = await storage.getFeedbackById(id);
+    if (!feedback) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, // Using generic not found
+        `Feedback '${id}' not found`, 404);
+    }
+    sendSuccess(request, reply, {
+        id: feedback.id,
+        skillId: feedback.skillId,
+        skillVersion: feedback.skillVersion,
+        feedbackType: feedback.feedbackType,
+        rating: feedback.rating,
+        comment: feedback.comment,
+        context: feedback.context,
+        status: feedback.status,
+        createdAt: feedback.createdAt,
+    });
+}
+/**
+ * Review feedback (admin)
+ */
+export async function reviewFeedback(request, reply) {
+    const storage = await getStorage();
+    const { id } = request.params;
+    const { status, notes } = request.body;
+    const userId = request.user?.id;
+    const feedback = await storage.getFeedbackById(id);
+    if (!feedback) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Feedback '${id}' not found`, 404);
+    }
+    const updated = await storage.updateFeedback(id, {
+        status,
+        reviewerNotes: notes,
+        reviewedAt: now(),
+        reviewedBy: userId,
+    });
+    logger.info('Feedback reviewed', {
+        feedbackId: id,
+        status,
+        reviewedBy: userId,
+    });
+    sendSuccess(request, reply, {
+        id: updated?.id,
+        status: updated?.status,
+        reviewerNotes: updated?.reviewerNotes,
+        reviewedAt: updated?.reviewedAt,
+    });
+}
+/**
+ * Get feedback statistics for a skill
+ */
+export async function getFeedbackStats(request, reply) {
+    const storage = await getStorage();
+    const { name } = request.params;
+    // Parse name
+    const { scope, name: skillName } = parseSkillFullName(name);
+    const fullName = buildSkillFullName(skillName, scope);
+    const skill = await storage.getSkillByName(fullName);
+    if (!skill) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Skill '${fullName}' not found`, 404);
+    }
+    // Get all feedbacks
+    const result = await storage.getFeedbacks(skill.id, { limit: 1000 });
+    const feedbacks = result.items;
+    // Calculate stats
+    const stats = {
+        total: feedbacks.length,
+        byType: {
+            success: feedbacks.filter(f => f.feedbackType === 'success').length,
+            failure: feedbacks.filter(f => f.feedbackType === 'failure').length,
+            suggestion: feedbacks.filter(f => f.feedbackType === 'suggestion').length,
+            bug: feedbacks.filter(f => f.feedbackType === 'bug').length,
+        },
+        byStatus: {
+            pending: feedbacks.filter(f => f.status === 'pending').length,
+            reviewed: feedbacks.filter(f => f.status === 'reviewed').length,
+            accepted: feedbacks.filter(f => f.status === 'accepted').length,
+            rejected: feedbacks.filter(f => f.status === 'rejected').length,
+        },
+        rating: skill.rating,
+        successRate: feedbacks.length > 0
+            ? feedbacks.filter(f => f.feedbackType === 'success').length / feedbacks.length
+            : 0,
+    };
+    sendSuccess(request, reply, stats);
+}
+//# sourceMappingURL=feedback.js.map

package/dist/controllers/feedback.js.map

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

package/dist/controllers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Open Skills Hub - Controllers Exports
+ */
+export * from './skills.js';
+export * from './versions.js';
+export * from './feedback.js';
+export * from './audit.js';
+export * from './cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/controllers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/controllers/index.js

@@ -0,0 +1,9 @@
+/**
+ * Open Skills Hub - Controllers Exports
+ */
+export * from './skills.js';
+export * from './versions.js';
+export * from './feedback.js';
+export * from './audit.js';
+export * from './cache.js';
+//# sourceMappingURL=index.js.map

package/dist/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/controllers/skills.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Open Skills Hub - Skills Controller
+ */
+import type { FastifyRequest, FastifyReply } from 'fastify';
+import type { SkillNameParam, CreateSkillBody, UpdateSkillBody, PaginationQuery, SearchQuery } from '../middleware/validation.js';
+export type { SearchQuery };
+/**
+ * Search skills
+ */
+export declare function searchSkills(request: FastifyRequest<{
+    Querystring: SearchQuery;
+}>, reply: FastifyReply): Promise<void>;
+/**
+ * Get skill by name
+ */
+export declare function getSkillByName(request: FastifyRequest<{
+    Params: SkillNameParam;
+}>, reply: FastifyReply): Promise<void>;
+/**
+ * Get skill content (fetch-on-use)
+ */
+export declare function getSkillContent(request: FastifyRequest<{
+    Params: SkillNameParam;
+    Querystring: {
+        version?: string;
+    };
+}>, reply: FastifyReply): Promise<void>;
+/**
+ * Create/publish a new skill
+ */
+export declare function createSkill(request: FastifyRequest<{
+    Body: CreateSkillBody;
+}>, reply: FastifyReply): Promise<void>;
+/**
+ * Update skill metadata
+ */
+export declare function updateSkill(request: FastifyRequest<{
+    Params: SkillNameParam;
+    Body: UpdateSkillBody;
+}>, reply: FastifyReply): Promise<void>;
+/**
+ * Delete/deprecate a skill
+ */
+export declare function deleteSkill(request: FastifyRequest<{
+    Params: SkillNameParam;
+    Querystring: {
+        hard?: string;
+    };
+}>, reply: FastifyReply): Promise<void>;
+/**
+ * Get skills by owner
+ */
+export declare function getSkillsByOwner(request: FastifyRequest<{
+    Params: {
+        ownerId: string;
+    };
+    Querystring: PaginationQuery;
+}>, reply: FastifyReply): Promise<void>;
+/**
+ * Get derived skills
+ */
+export declare function getDerivedSkills(request: FastifyRequest<{
+    Params: SkillNameParam;
+    Querystring: PaginationQuery;
+}>, reply: FastifyReply): Promise<void>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/controllers/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/controllers/skills.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAc5D,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EACf,eAAe,EAEf,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,CAAC;IAAE,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC,EACrD,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,CAAC;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC,EACnD,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,CAAC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,EACtF,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Ef;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,CAAC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,EAClD,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Gf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,CAAC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,EAC1E,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA6Ef;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,CAAC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,EACnF,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA+Df;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,CAAC;IAAE,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,WAAW,EAAE,eAAe,CAAA;CAAE,CAAC,EACtF,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,CAAC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,eAAe,CAAA;CAAE,CAAC,EACjF,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/controllers/skills.js

@@ -0,0 +1,355 @@
+/**
+ * Open Skills Hub - Skills Controller
+ */
+import { getStorage, generateUUID, now, sha256, buildSkillFullName, parseSkillFullName, AppError, ErrorCodes, } from '@open-skills-hub/core';
+import { sendSuccess } from '../middleware/error.js';
+import { logger } from '../middleware/logger.js';
+/**
+ * Search skills
+ */
+export async function searchSkills(request, reply) {
+    const storage = await getStorage();
+    const { q, category, author, sort, order, cursor, limit } = request.query;
+    const result = await storage.searchSkills({
+        query: q,
+        category,
+        author,
+        sort,
+        order,
+        cursor,
+        limit,
+    });
+    sendSuccess(request, reply, result.items, 200, result.pagination);
+}
+/**
+ * Get skill by name
+ */
+export async function getSkillByName(request, reply) {
+    const storage = await getStorage();
+    const { name } = request.params;
+    // Parse name (might be scoped like @scope/name)
+    const { scope, name: skillName } = parseSkillFullName(name);
+    const fullName = buildSkillFullName(skillName, scope);
+    const skill = await storage.getSkillByName(fullName);
+    if (!skill) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Skill '${fullName}' not found`, 404);
+    }
+    // Get latest version info
+    const latestVersion = await storage.getLatestVersion(skill.id);
+    sendSuccess(request, reply, {
+        ...skill,
+        latestVersionDetails: latestVersion ? {
+            version: latestVersion.version,
+            publishedAt: latestVersion.publishedAt,
+            securityLevel: latestVersion.securityLevel,
+        } : undefined,
+    });
+}
+/**
+ * Get skill content (fetch-on-use)
+ */
+export async function getSkillContent(request, reply) {
+    const storage = await getStorage();
+    const { name } = request.params;
+    const { version: requestedVersion } = request.query;
+    // Parse name
+    const { scope, name: skillName } = parseSkillFullName(name);
+    const fullName = buildSkillFullName(skillName, scope);
+    const skill = await storage.getSkillByName(fullName);
+    if (!skill) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Skill '${fullName}' not found`, 404);
+    }
+    // Get version
+    let version;
+    if (requestedVersion) {
+        version = await storage.getVersion(skill.id, requestedVersion);
+        if (!version) {
+            throw new AppError(ErrorCodes.VERSION_NOT_FOUND, `Version '${requestedVersion}' not found for skill '${fullName}'`, 404);
+        }
+    }
+    else {
+        version = await storage.getLatestVersion(skill.id);
+        if (!version) {
+            throw new AppError(ErrorCodes.VERSION_NOT_FOUND, `No versions found for skill '${fullName}'`, 404);
+        }
+    }
+    // Increment use counters
+    await Promise.all([
+        storage.incrementSkillUses(skill.id),
+        storage.incrementVersionUses(version.id),
+    ]);
+    // Record use
+    const useRecord = {
+        id: generateUUID(),
+        skillId: skill.id,
+        versionId: version.id,
+        userId: request.user?.id,
+        source: 'api',
+        cacheHit: false,
+        clientVersion: request.headers['x-client-version'],
+        platform: request.headers['x-platform'],
+        arch: request.headers['x-arch'],
+        ip: request.ip,
+        userAgent: request.headers['user-agent'],
+        createdAt: now(),
+    };
+    await storage.createUseRecord(useRecord);
+    sendSuccess(request, reply, {
+        skill: {
+            name: skill.fullName,
+            displayName: skill.displayName,
+            description: skill.description,
+            securityLevel: skill.securityLevel,
+        },
+        version: version.version,
+        content: version.content,
+        packageHash: version.packageHash,
+        securityScore: version.securityScore,
+        securityLevel: version.securityLevel,
+    });
+}
+/**
+ * Create/publish a new skill
+ */
+export async function createSkill(request, reply) {
+    const storage = await getStorage();
+    const body = request.body;
+    const userId = request.user?.id;
+    // Build full name
+    const fullName = buildSkillFullName(body.name, body.scope);
+    // Check if skill already exists
+    const existing = await storage.getSkillByName(fullName);
+    if (existing) {
+        throw new AppError(ErrorCodes.SKILL_EXISTS, `Skill '${fullName}' already exists`, 409);
+    }
+    // Calculate content hash
+    const contentString = JSON.stringify(body.content);
+    const contentHash = sha256(contentString);
+    const skillId = generateUUID();
+    const versionId = generateUUID();
+    const timestamp = now();
+    // Extract author from frontmatter or use userId
+    const author = body.content.frontmatter.author || userId || 'anonymous';
+    const ownerType = (body.scope || author.startsWith('@')) ? 'organization' : 'user';
+    // Create skill
+    const skill = {
+        id: skillId,
+        name: body.name,
+        scope: body.scope,
+        fullName,
+        ownerId: author,
+        ownerType,
+        displayName: body.displayName,
+        description: body.description,
+        category: body.category,
+        keywords: body.keywords,
+        license: body.license,
+        repository: body.repository,
+        homepage: body.homepage,
+        latestVersion: body.version,
+        latestVersionId: versionId,
+        visibility: body.visibility,
+        status: 'active',
+        stats: { totalUses: 0, weeklyUses: 0, monthlyUses: 0, versionCount: 1, derivationCount: 0 },
+        rating: { average: 0, count: 0 },
+        createdAt: timestamp,
+        updatedAt: timestamp,
+        publishedAt: timestamp,
+    };
+    // Create version
+    const version = {
+        id: versionId,
+        skillId,
+        version: body.version,
+        tag: 'latest',
+        content: body.content,
+        packageUrl: `local://${fullName}/${body.version}`,
+        packageSize: contentString.length,
+        packageHash: contentHash,
+        changelog: body.changelog,
+        status: 'published',
+        publishedBy: author,
+        uses: 0,
+        createdAt: timestamp,
+        publishedAt: timestamp,
+    };
+    // Save to storage
+    await storage.createSkill(skill);
+    await storage.createVersion(version);
+    // Create audit log
+    const auditLog = {
+        id: generateUUID(),
+        timestamp,
+        eventType: 'skill.published',
+        actor: {
+            type: request.user?.type ?? 'user',
+            id: userId,
+            username: request.user?.username,
+            ip: request.ip,
+            userAgent: request.headers['user-agent'],
+        },
+        resource: {
+            type: 'skill',
+            id: skillId,
+            name: fullName,
+            version: body.version,
+        },
+        action: 'create',
+        result: 'success',
+        details: {
+            visibility: body.visibility,
+            category: body.category,
+        },
+    };
+    await storage.createAuditLog(auditLog);
+    logger.info('Skill published', { skillId, fullName, version: body.version });
+    sendSuccess(request, reply, { skill, version }, 201);
+}
+/**
+ * Update skill metadata
+ */
+export async function updateSkill(request, reply) {
+    const storage = await getStorage();
+    const { name } = request.params;
+    const updates = request.body;
+    const userId = request.user?.id;
+    // Parse name
+    const { scope, name: skillName } = parseSkillFullName(name);
+    const fullName = buildSkillFullName(skillName, scope);
+    const skill = await storage.getSkillByName(fullName);
+    if (!skill) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Skill '${fullName}' not found`, 404);
+    }
+    // Check ownership (simplified - in production, check more thoroughly)
+    if (skill.ownerId && skill.ownerId !== userId && request.user?.type !== 'system') {
+        throw new AppError(ErrorCodes.FORBIDDEN, 'You do not have permission to update this skill', 403);
+    }
+    // Build update object (remove null values to unset optional fields)
+    const updateData = {};
+    if (updates.displayName !== undefined)
+        updateData.displayName = updates.displayName;
+    if (updates.description !== undefined)
+        updateData.description = updates.description;
+    if (updates.category !== undefined)
+        updateData.category = updates.category;
+    if (updates.keywords !== undefined)
+        updateData.keywords = updates.keywords;
+    if (updates.repository !== undefined)
+        updateData.repository = updates.repository ?? undefined;
+    if (updates.homepage !== undefined)
+        updateData.homepage = updates.homepage ?? undefined;
+    if (updates.visibility !== undefined)
+        updateData.visibility = updates.visibility;
+    const updated = await storage.updateSkill(skill.id, updateData);
+    if (!updated) {
+        throw new AppError(ErrorCodes.INTERNAL_ERROR, 'Failed to update skill', 500);
+    }
+    // Create audit log
+    const auditLog = {
+        id: generateUUID(),
+        timestamp: now(),
+        eventType: 'skill.updated',
+        actor: {
+            type: request.user?.type ?? 'user',
+            id: userId,
+            username: request.user?.username,
+            ip: request.ip,
+            userAgent: request.headers['user-agent'],
+        },
+        resource: {
+            type: 'skill',
+            id: skill.id,
+            name: fullName,
+        },
+        action: 'update',
+        result: 'success',
+        changes: {
+            before: skill,
+            after: updated,
+        },
+    };
+    await storage.createAuditLog(auditLog);
+    logger.info('Skill updated', { skillId: skill.id, fullName });
+    sendSuccess(request, reply, updated);
+}
+/**
+ * Delete/deprecate a skill
+ */
+export async function deleteSkill(request, reply) {
+    const storage = await getStorage();
+    const { name } = request.params;
+    const { hard } = request.query;
+    const userId = request.user?.id;
+    // Parse name
+    const { scope, name: skillName } = parseSkillFullName(name);
+    const fullName = buildSkillFullName(skillName, scope);
+    const skill = await storage.getSkillByName(fullName);
+    if (!skill) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Skill '${fullName}' not found`, 404);
+    }
+    // Check ownership
+    if (skill.ownerId && skill.ownerId !== userId && request.user?.type !== 'system') {
+        throw new AppError(ErrorCodes.FORBIDDEN, 'You do not have permission to delete this skill', 403);
+    }
+    let result;
+    if (hard === 'true') {
+        // Hard delete
+        result = await storage.deleteSkill(skill.id);
+    }
+    else {
+        // Soft delete (mark as deleted)
+        const updated = await storage.updateSkill(skill.id, { status: 'deleted' });
+        result = !!updated;
+    }
+    // Create audit log
+    const auditLog = {
+        id: generateUUID(),
+        timestamp: now(),
+        eventType: 'skill.deleted',
+        actor: {
+            type: request.user?.type ?? 'user',
+            id: userId,
+            username: request.user?.username,
+            ip: request.ip,
+            userAgent: request.headers['user-agent'],
+        },
+        resource: {
+            type: 'skill',
+            id: skill.id,
+            name: fullName,
+        },
+        action: hard === 'true' ? 'hard_delete' : 'soft_delete',
+        result: result ? 'success' : 'failure',
+    };
+    await storage.createAuditLog(auditLog);
+    logger.info('Skill deleted', { skillId: skill.id, fullName, hard: hard === 'true' });
+    sendSuccess(request, reply, { deleted: result });
+}
+/**
+ * Get skills by owner
+ */
+export async function getSkillsByOwner(request, reply) {
+    const storage = await getStorage();
+    const { ownerId } = request.params;
+    const { cursor, limit } = request.query;
+    const result = await storage.getSkillsByOwner(ownerId, { cursor, limit });
+    sendSuccess(request, reply, result.items, 200, result.pagination);
+}
+/**
+ * Get derived skills
+ */
+export async function getDerivedSkills(request, reply) {
+    const storage = await getStorage();
+    const { name } = request.params;
+    const { cursor, limit } = request.query;
+    // Parse name
+    const { scope, name: skillName } = parseSkillFullName(name);
+    const fullName = buildSkillFullName(skillName, scope);
+    const skill = await storage.getSkillByName(fullName);
+    if (!skill) {
+        throw new AppError(ErrorCodes.SKILL_NOT_FOUND, `Skill '${fullName}' not found`, 404);
+    }
+    const result = await storage.getDerivedSkills(skill.id, { cursor, limit });
+    sendSuccess(request, reply, result.items, 200, result.pagination);
+}
+//# sourceMappingURL=skills.js.map