vgxness 1.17.2 → 1.19.0

package/dist/skills/repositories/skills.js

@@ -152,8 +152,8 @@ export class SkillRepository {
             const now = new Date().toISOString();
             this.db.connection
                 .prepare(`
-        INSERT INTO skill_usage_records(id, skill_id, version_id, run_id, target_type, target_key, outcome, notes, created_at)
-        VALUES (@id, @skillId, @versionId, @runId, @targetType, @targetKey, @outcome, @notes, @createdAt)
+        INSERT INTO skill_usage_records(id, skill_id, version_id, run_id, target_type, target_key, outcome, notes, created_at, workflow, phase, provider_adapter, agent_id, intent_json, evidence_json)
+        VALUES (@id, @skillId, @versionId, @runId, @targetType, @targetKey, @outcome, @notes, @createdAt, @workflow, @phase, @providerAdapter, @agentId, @intentJson, @evidenceJson)
       `)
                 .run({
                 id,
@@ -165,6 +165,12 @@ export class SkillRepository {
                 outcome: input.outcome,
                 notes: input.notes ?? null,
                 createdAt: now,
+                workflow: input.workflow ?? null,
+                phase: input.phase ?? null,
+                providerAdapter: input.providerAdapter ?? null,
+                agentId: input.agentId ?? null,
+                intentJson: input.intent === undefined ? null : JSON.stringify(input.intent),
+                evidenceJson: input.evidence === undefined ? null : JSON.stringify(input.evidence),
             });
             const read = this.getUsage(id);
             if (!read.ok)
@@ -176,6 +182,218 @@ export class SkillRepository {
         }
         return result;
     }
+    recordActivation(input) {
+        const validation = validateActivation(input);
+        if (!validation.ok)
+            return validation;
+        const result = this.db.transaction(() => {
+            const skill = this.getById(input.skillId);
+            if (!skill.ok)
+                throw new SkillRegistryValidationError(skill.error.message);
+            if (input.versionId !== undefined)
+                assertVersionBelongsToSkill(this.db, input.versionId, input.skillId);
+            if (skill.value.project !== input.project || skill.value.scope !== input.scope)
+                throw new SkillRegistryValidationError('Skill does not belong to the requested project/scope');
+            const id = randomUUID();
+            const now = new Date().toISOString();
+            this.db.connection
+                .prepare(`
+        INSERT INTO skill_activation_records(id, project, scope, skill_id, version_id, run_id, agent_id, workflow, phase, provider_adapter, intent_json, reason, payload_metadata_json, created_at)
+        VALUES (@id, @project, @scope, @skillId, @versionId, @runId, @agentId, @workflow, @phase, @providerAdapter, @intentJson, @reason, @payloadMetadataJson, @createdAt)
+      `)
+                .run({
+                id,
+                project: input.project,
+                scope: input.scope,
+                skillId: input.skillId,
+                versionId: input.versionId ?? null,
+                runId: input.runId ?? null,
+                agentId: input.agentId ?? null,
+                workflow: input.workflow ?? null,
+                phase: input.phase ?? null,
+                providerAdapter: input.providerAdapter ?? null,
+                intentJson: input.intent === undefined ? null : JSON.stringify(input.intent),
+                reason: input.reason ?? null,
+                payloadMetadataJson: JSON.stringify(input.payloadMetadata ?? {}),
+                createdAt: now,
+            });
+            const read = this.getActivation(id);
+            if (!read.ok)
+                throw new Error(read.error.message);
+            return read.value;
+        });
+        if (!result.ok && result.error.cause instanceof SkillRegistryValidationError) {
+            return validationFailure(result.error.cause.message);
+        }
+        return result;
+    }
+    createDraft(input) {
+        const validation = validateCreateDraft(input);
+        if (!validation.ok)
+            return validation;
+        const result = this.db.transaction(() => {
+            const existing = this.findByNaturalKey(input.project, input.scope ?? 'project', input.name);
+            const skill = existing === undefined ? this.register({ project: input.project, scope: input.scope ?? 'project', name: input.name, description: input.description }) : ok(mapSkill(existing));
+            if (!skill.ok)
+                throw new SkillRegistryValidationError(skill.error.message);
+            if (input.draftParentVersionId !== undefined)
+                assertVersionBelongsToSkill(this.db, input.draftParentVersionId, skill.value.id);
+            if (this.findVersion(skill.value.id, input.version) !== undefined)
+                throw new SkillRegistryValidationError(`Skill version already exists: ${input.version}`);
+            const now = new Date().toISOString();
+            const id = randomUUID();
+            this.db.connection
+                .prepare(`
+        INSERT INTO skill_versions(id, skill_id, version, source_kind, source_path, source_url, source_inline_metadata_json, compatibility_json, status, created_at, lifecycle_label, draft_parent_version_id, draft_revision, governance_json)
+        VALUES (@id, @skillId, @version, @sourceKind, @sourcePath, @sourceUrl, @sourceInlineMetadataJson, @compatibilityJson, 'draft', @createdAt, 'draft', @draftParentVersionId, 1, @governanceJson)
+      `)
+                .run({
+                id,
+                skillId: skill.value.id,
+                version: input.version,
+                sourceKind: input.source.kind,
+                sourcePath: input.source.path ?? null,
+                sourceUrl: input.source.url ?? null,
+                sourceInlineMetadataJson: JSON.stringify(input.source.inlineMetadata ?? {}),
+                compatibilityJson: JSON.stringify(input.compatibility ?? {}),
+                createdAt: now,
+                draftParentVersionId: input.draftParentVersionId ?? null,
+                governanceJson: JSON.stringify(input.governance ?? {}),
+            });
+            const version = this.getVersion(id);
+            if (!version.ok)
+                throw new Error(version.error.message);
+            const after = versionSnapshot(version.value);
+            const event = this.recordLifecycleEvent({
+                project: skill.value.project,
+                scope: skill.value.scope,
+                skillId: skill.value.id,
+                versionId: version.value.id,
+                eventType: 'draft-created',
+                actor: input.actor,
+                ...(input.runId === undefined ? {} : { runId: input.runId }),
+                ...(input.agentId === undefined ? {} : { agentId: input.agentId }),
+                ...(input.reason === undefined ? {} : { reason: input.reason }),
+                before: existing === undefined ? {} : { skillExisted: true, currentVersionId: existing.current_version_id ?? null },
+                after,
+                ...(input.evidence === undefined ? {} : { evidence: input.evidence }),
+            });
+            if (!event.ok)
+                throw new Error(event.error.message);
+            return { skill: skill.value, version: version.value, event: event.value };
+        });
+        if (!result.ok && result.error.cause instanceof SkillRegistryValidationError)
+            return validationFailure(result.error.cause.message);
+        return result;
+    }
+    updateDraft(input) {
+        const validation = validateUpdateDraft(input);
+        if (!validation.ok)
+            return validation;
+        const result = this.db.transaction(() => {
+            const skill = resolveSkillForMutation(this, input.project, input.scope ?? 'project', input.skillId, input.name);
+            const version = resolveVersionForMutation(this, skill.id, input.versionId, input.version);
+            if (version.status !== 'draft')
+                throw new SkillRegistryValidationError(`Cannot update ${version.status} skill versions; only draft versions can be updated`);
+            if (input.expectedDraftRevision !== undefined && (version.draftRevision ?? 0) !== input.expectedDraftRevision) {
+                throw new SkillRegistryValidationError(`Draft revision conflict: expected ${input.expectedDraftRevision}, found ${version.draftRevision ?? 0}`);
+            }
+            const before = versionSnapshot(version);
+            const nextRevision = (version.draftRevision ?? 0) + 1;
+            this.db.connection
+                .prepare(`
+        UPDATE skill_versions SET
+          source_kind=COALESCE(@sourceKind, source_kind),
+          source_path=@sourcePath,
+          source_url=@sourceUrl,
+          source_inline_metadata_json=COALESCE(@sourceInlineMetadataJson, source_inline_metadata_json),
+          compatibility_json=COALESCE(@compatibilityJson, compatibility_json),
+          draft_revision=@draftRevision,
+          governance_json=COALESCE(@governanceJson, governance_json)
+        WHERE id=@id
+      `)
+                .run({
+                id: version.id,
+                sourceKind: input.source?.kind ?? null,
+                sourcePath: input.source === undefined ? (version.source.path ?? null) : (input.source.path ?? null),
+                sourceUrl: input.source === undefined ? (version.source.url ?? null) : (input.source.url ?? null),
+                sourceInlineMetadataJson: input.source === undefined ? null : JSON.stringify(input.source.inlineMetadata ?? {}),
+                compatibilityJson: input.compatibility === undefined ? null : JSON.stringify(input.compatibility),
+                draftRevision: nextRevision,
+                governanceJson: input.governance === undefined ? null : JSON.stringify(input.governance),
+            });
+            const updated = this.getVersion(version.id);
+            if (!updated.ok)
+                throw new Error(updated.error.message);
+            const event = this.recordLifecycleEvent({
+                project: skill.project,
+                scope: skill.scope,
+                skillId: skill.id,
+                versionId: updated.value.id,
+                eventType: 'draft-updated',
+                actor: input.actor,
+                ...(input.runId === undefined ? {} : { runId: input.runId }),
+                ...(input.agentId === undefined ? {} : { agentId: input.agentId }),
+                ...(input.reason === undefined ? {} : { reason: input.reason }),
+                before,
+                after: versionSnapshot(updated.value),
+                ...(input.evidence === undefined ? {} : { evidence: input.evidence }),
+            });
+            if (!event.ok)
+                throw new Error(event.error.message);
+            return { skill, version: updated.value, event: event.value };
+        });
+        if (!result.ok && result.error.cause instanceof SkillRegistryValidationError)
+            return validationFailure(result.error.cause.message);
+        return result;
+    }
+    publishVersion(input) {
+        const validation = validatePublishVersion(input);
+        if (!validation.ok)
+            return validation;
+        const result = this.db.transaction(() => {
+            const skill = resolveSkillForMutation(this, input.project, input.scope ?? 'project', input.skillId, input.name);
+            const version = resolveVersionForMutation(this, skill.id, input.versionId, input.version);
+            if (version.status !== 'draft')
+                throw new SkillRegistryValidationError(`Cannot publish ${version.status} skill versions; only draft versions can be published`);
+            const before = { skill: { currentVersionId: skill.currentVersionId ?? null }, version: versionSnapshot(version) };
+            const previousCurrentVersionId = skill.currentVersionId ?? null;
+            const now = new Date().toISOString();
+            this.db.connection
+                .prepare(`
+        UPDATE skill_versions SET status='active', lifecycle_label='published', published_at=@publishedAt, published_by=@publishedBy, governance_json=COALESCE(@governanceJson, governance_json)
+        WHERE id=@id
+      `)
+                .run({ id: version.id, publishedAt: now, publishedBy: input.actor.id, governanceJson: input.governance === undefined ? null : JSON.stringify(input.governance) });
+            this.db.connection.prepare('UPDATE skills SET current_version_id=?, updated_at=? WHERE id=?').run(version.id, now, skill.id);
+            const updatedSkill = this.getById(skill.id);
+            if (!updatedSkill.ok)
+                throw new Error(updatedSkill.error.message);
+            const updated = this.getVersion(version.id);
+            if (!updated.ok)
+                throw new Error(updated.error.message);
+            const event = this.recordLifecycleEvent({
+                project: updatedSkill.value.project,
+                scope: updatedSkill.value.scope,
+                skillId: updatedSkill.value.id,
+                versionId: updated.value.id,
+                eventType: 'version-published',
+                actor: input.actor,
+                ...(input.runId === undefined ? {} : { runId: input.runId }),
+                ...(input.agentId === undefined ? {} : { agentId: input.agentId }),
+                reason: input.reason,
+                before,
+                after: { skill: { currentVersionId: updated.value.id }, version: versionSnapshot(updated.value) },
+                ...(input.evidence === undefined ? {} : { evidence: input.evidence }),
+            });
+            if (!event.ok)
+                throw new Error(event.error.message);
+            return { skill: updatedSkill.value, version: updated.value, event: event.value, previousCurrentVersionId };
+        });
+        if (!result.ok && result.error.cause instanceof SkillRegistryValidationError)
+            return validationFailure(result.error.cause.message);
+        return result;
+    }
     getById(id) {
         try {
             const row = this.db.connection.prepare('SELECT * FROM skills WHERE id=?').get(id);
@@ -246,6 +464,118 @@ export class SkillRepository {
             return fail('Failed to list skills', cause);
         }
     }
+    search(input) {
+        try {
+            const limit = normalizeLimit(input.limit);
+            const where = ['s.project=@project', 's.scope=@scope'];
+            const parameters = { project: input.project, scope: input.scope ?? 'project', limit };
+            if (input.query !== undefined && input.query.trim().length > 0) {
+                where.push('(s.name LIKE @query OR s.description LIKE @query OR cv.version LIKE @query)');
+                parameters.query = `%${input.query.trim()}%`;
+            }
+            if (input.status !== undefined) {
+                where.push('cv.status=@status');
+                parameters.status = input.status;
+            }
+            if (input.sourceKind !== undefined) {
+                where.push('cv.source_kind=@sourceKind');
+                parameters.sourceKind = input.sourceKind;
+            }
+            const rows = this.db.connection
+                .prepare(`
+        SELECT
+          s.*,
+          cv.id AS current_version_row_id,
+          cv.version AS current_version,
+          cv.source_kind AS current_source_kind,
+          cv.source_path AS current_source_path,
+          cv.source_url AS current_source_url,
+          cv.source_inline_metadata_json AS current_source_inline_metadata_json,
+          cv.status AS current_status,
+          (SELECT COUNT(*) FROM skill_versions sv WHERE sv.skill_id=s.id) AS version_count,
+          (SELECT COUNT(*) FROM skill_attachments sa WHERE sa.skill_id=s.id) AS attachment_count
+        FROM skills s
+        LEFT JOIN skill_versions cv ON cv.id=s.current_version_id
+        WHERE ${where.join(' AND ')}
+        ORDER BY s.name ASC, s.id ASC
+        LIMIT @limit
+      `)
+                .all(parameters);
+            return ok(rows.map(mapSearchItem));
+        }
+        catch (cause) {
+            return fail('Failed to search skills', cause);
+        }
+    }
+    countSearchMatches(input) {
+        try {
+            const where = ['s.project=@project', 's.scope=@scope'];
+            const parameters = { project: input.project, scope: input.scope ?? 'project' };
+            if (input.query !== undefined && input.query.trim().length > 0) {
+                where.push('(s.name LIKE @query OR s.description LIKE @query OR cv.version LIKE @query)');
+                parameters.query = `%${input.query.trim()}%`;
+            }
+            if (input.status !== undefined) {
+                where.push('cv.status=@status');
+                parameters.status = input.status;
+            }
+            if (input.sourceKind !== undefined) {
+                where.push('cv.source_kind=@sourceKind');
+                parameters.sourceKind = input.sourceKind;
+            }
+            const row = this.db.connection
+                .prepare(`SELECT COUNT(*) AS count FROM skills s LEFT JOIN skill_versions cv ON cv.id=s.current_version_id WHERE ${where.join(' AND ')}`)
+                .get(parameters);
+            return ok(row.count);
+        }
+        catch (cause) {
+            return fail('Failed to count skill search matches', cause);
+        }
+    }
+    getV2Counts(project, scope) {
+        try {
+            const versions = zeroVersionCounts();
+            for (const row of this.db.connection
+                .prepare(`SELECT sv.status AS status, COUNT(*) AS count FROM skill_versions sv JOIN skills s ON s.id=sv.skill_id WHERE s.project=? AND s.scope=? GROUP BY sv.status`)
+                .all(project, scope)) {
+                versions[row.status] = row.count;
+            }
+            const proposals = zeroProposalCounts();
+            for (const row of this.db.connection
+                .prepare(`SELECT p.status AS status, COUNT(*) AS count FROM skill_improvement_proposals p JOIN skills s ON s.id=p.skill_id WHERE s.project=? AND s.scope=? GROUP BY p.status`)
+                .all(project, scope)) {
+                proposals[row.status] = row.count;
+            }
+            const evaluationRequests = zeroEvaluationRequestCounts();
+            for (const row of this.db.connection
+                .prepare('SELECT status, COUNT(*) AS count FROM skill_evaluation_requests WHERE project=? AND scope=? GROUP BY status')
+                .all(project, scope)) {
+                evaluationRequests[row.status] = row.count;
+            }
+            const evaluationResults = zeroEvaluationResultCounts();
+            for (const row of this.db.connection
+                .prepare(`SELECT r.status AS status, COUNT(*) AS count FROM skill_evaluation_results r JOIN skill_evaluation_scenarios e ON e.id=r.scenario_id JOIN skills s ON s.id=e.skill_id WHERE s.project=? AND s.scope=? GROUP BY r.status`)
+                .all(project, scope)) {
+                evaluationResults[row.status] = row.count;
+            }
+            return ok({
+                versions,
+                attachments: countScoped(this.db, 'skill_attachments', project, scope),
+                usageRecords: countScoped(this.db, 'skill_usage_records', project, scope),
+                activationRecords: countDirectScoped(this.db, 'skill_activation_records', project, scope),
+                improvementProposals: proposals,
+                evaluationScenarios: countScoped(this.db, 'skill_evaluation_scenarios', project, scope),
+                evaluationRequests,
+                evaluationResults,
+                drafts: versions.draft,
+                deprecated: versions.deprecated,
+                archived: versions.archived,
+            });
+        }
+        catch (cause) {
+            return fail('Failed to count skill registry v2 records', cause);
+        }
+    }
     listVersions(skillId) {
         try {
             const rows = this.db.connection.prepare('SELECT * FROM skill_versions WHERE skill_id=? ORDER BY created_at DESC, version DESC').all(skillId);
@@ -296,6 +626,15 @@ export class SkillRepository {
             return fail('Failed to read skill version', cause);
         }
     }
+    getVersionBySkillVersion(skillId, version) {
+        try {
+            const row = this.findVersion(skillId, version);
+            return row ? ok(mapVersion(row)) : missing(`Skill version not found: ${version}`);
+        }
+        catch (cause) {
+            return fail('Failed to read skill version', cause);
+        }
+    }
     getAttachment(id) {
         try {
             const row = this.db.connection.prepare('SELECT * FROM skill_attachments WHERE id=?').get(id);
@@ -314,6 +653,48 @@ export class SkillRepository {
             return fail('Failed to read skill usage record', cause);
         }
     }
+    getActivation(id) {
+        try {
+            const row = this.db.connection.prepare('SELECT * FROM skill_activation_records WHERE id=?').get(id);
+            return row ? ok(mapActivation(row)) : missing(`Skill activation record not found: ${id}`);
+        }
+        catch (cause) {
+            return fail('Failed to read skill activation record', cause);
+        }
+    }
+    recordLifecycleEvent(input) {
+        try {
+            const id = randomUUID();
+            const now = new Date().toISOString();
+            this.db.connection
+                .prepare(`
+        INSERT INTO skill_lifecycle_events(id, project, scope, skill_id, version_id, event_type, actor_type, actor_id, run_id, agent_id, reason, before_json, after_json, evidence_json, created_at)
+        VALUES (@id, @project, @scope, @skillId, @versionId, @eventType, @actorType, @actorId, @runId, @agentId, @reason, @beforeJson, @afterJson, @evidenceJson, @createdAt)
+      `)
+                .run({
+                id,
+                project: input.project,
+                scope: input.scope,
+                skillId: input.skillId,
+                versionId: input.versionId ?? null,
+                eventType: input.eventType,
+                actorType: input.actor?.type ?? null,
+                actorId: input.actor?.id ?? null,
+                runId: input.runId ?? null,
+                agentId: input.agentId ?? null,
+                reason: input.reason ?? null,
+                beforeJson: input.before === undefined ? null : JSON.stringify(input.before),
+                afterJson: input.after === undefined ? null : JSON.stringify(input.after),
+                evidenceJson: input.evidence === undefined ? null : JSON.stringify(input.evidence),
+                createdAt: now,
+            });
+            const row = this.db.connection.prepare('SELECT * FROM skill_lifecycle_events WHERE id=?').get(id);
+            return row ? ok(mapLifecycleEvent(row)) : missing(`Skill lifecycle event not found: ${id}`);
+        }
+        catch (cause) {
+            return fail('Failed to record skill lifecycle event', cause);
+        }
+    }
     findByNaturalKey(project, scope, name) {
         return this.db.connection.prepare('SELECT * FROM skills WHERE project=? AND scope=? AND name=?').get(project, scope, name);
     }
@@ -357,6 +738,81 @@ function validateUsage(input) {
         return validationFailure('Skill usage target key is required when target type is set');
     if (input.targetType === undefined && input.targetKey !== undefined)
         return validationFailure('Skill usage target type is required when target key is set');
+    if (input.versionId !== undefined && !input.versionId.trim())
+        return validationFailure('Skill version id must not be empty');
+    return ok(undefined);
+}
+function validateActivation(input) {
+    if (!input.project.trim())
+        return validationFailure('Skill activation project is required');
+    if (!input.skillId.trim())
+        return validationFailure('Skill id is required');
+    if (input.versionId !== undefined && !input.versionId.trim())
+        return validationFailure('Skill version id must not be empty');
+    return ok(undefined);
+}
+function validateCreateDraft(input) {
+    if (!input.project.trim())
+        return validationFailure('Skill draft project is required');
+    if (!input.name.trim())
+        return validationFailure('Skill draft name is required');
+    if (!input.description.trim())
+        return validationFailure('Skill draft description is required');
+    if (!input.version.trim())
+        return validationFailure('Skill draft version is required');
+    const source = validateSource(input.source);
+    if (!source.ok)
+        return source;
+    return validateLifecycleActor(input.actor);
+}
+function validateUpdateDraft(input) {
+    if (!input.project.trim())
+        return validationFailure('Skill draft project is required');
+    if ((input.skillId === undefined || !input.skillId.trim()) && (input.name === undefined || !input.name.trim()))
+        return validationFailure('Either skillId or name is required');
+    if ((input.versionId === undefined || !input.versionId.trim()) && (input.version === undefined || !input.version.trim()))
+        return validationFailure('Either versionId or version is required');
+    if (input.versionId !== undefined && input.version !== undefined)
+        return validationFailure('Use either versionId or version, not both');
+    if (input.source === undefined && input.compatibility === undefined && input.governance === undefined)
+        return validationFailure('At least one draft update field is required');
+    if (input.expectedDraftRevision !== undefined && (!Number.isSafeInteger(input.expectedDraftRevision) || input.expectedDraftRevision < 1)) {
+        return validationFailure('expectedDraftRevision must be a positive safe integer');
+    }
+    if (input.source !== undefined) {
+        const source = validateSource(input.source);
+        if (!source.ok)
+            return source;
+    }
+    return validateLifecycleActor(input.actor);
+}
+function validatePublishVersion(input) {
+    if (!input.project.trim())
+        return validationFailure('Skill publish project is required');
+    if ((input.skillId === undefined || !input.skillId.trim()) && (input.name === undefined || !input.name.trim()))
+        return validationFailure('Either skillId or name is required');
+    if ((input.versionId === undefined || !input.versionId.trim()) && (input.version === undefined || !input.version.trim()))
+        return validationFailure('Either versionId or version is required');
+    if (input.versionId !== undefined && input.version !== undefined)
+        return validationFailure('Use either versionId or version, not both');
+    if (!input.reason.trim())
+        return validationFailure('Publish reason is required');
+    return validateLifecycleActor(input.actor);
+}
+function validateLifecycleActor(actor) {
+    if (!['human', 'agent', 'system'].includes(actor.type))
+        return validationFailure('Lifecycle actor type must be human, agent, or system');
+    if (!actor.id.trim())
+        return validationFailure('Lifecycle actor id is required');
+    return ok(undefined);
+}
+function validateSource(source) {
+    if (source.kind === 'path' && !source.path?.trim())
+        return validationFailure('Path skill sources require source.path');
+    if (source.kind === 'url' && !source.url?.trim())
+        return validationFailure('URL skill sources require source.url');
+    if (source.kind === 'inline' && (source.path !== undefined || source.url !== undefined))
+        return validationFailure('Inline skill sources cannot include source.path or source.url');
     return ok(undefined);
 }
 function assertVersionBelongsToSkill(db, versionId, skillId) {
@@ -380,6 +836,36 @@ function mapSkill(row) {
         skill.currentVersionId = row.current_version_id;
     return skill;
 }
+function mapSearchItem(row) {
+    const source = mapNullableSource(row.current_source_kind, row.current_source_path, row.current_source_url, row.current_source_inline_metadata_json);
+    const currentVersionId = row.current_version_row_id ?? null;
+    return {
+        id: row.id,
+        project: row.project,
+        scope: row.scope,
+        name: row.name,
+        description: row.description,
+        currentVersionId,
+        currentVersion: row.current_version ?? null,
+        status: row.current_status ?? (row.current_version_id === null ? 'missing-current-version' : 'missing-current-version-record'),
+        source,
+        attachments: Number(row.attachment_count ?? 0),
+        versions: Number(row.version_count ?? 0),
+    };
+}
+function mapNullableSource(kind, path, url, inlineMetadataJson) {
+    if (kind === null)
+        return null;
+    const source = { kind: kind };
+    if (path !== null)
+        source.path = path;
+    if (url !== null)
+        source.url = url;
+    const inlineMetadata = JSON.parse(inlineMetadataJson ?? '{}');
+    if (Object.keys(inlineMetadata).length > 0)
+        source.inlineMetadata = inlineMetadata;
+    return source;
+}
 function mapVersion(row) {
     const source = { kind: row.source_kind };
     if (row.source_path !== null)
@@ -389,7 +875,7 @@ function mapVersion(row) {
     const inlineMetadata = JSON.parse(row.source_inline_metadata_json ?? '{}');
     if (Object.keys(inlineMetadata).length > 0)
         source.inlineMetadata = inlineMetadata;
-    return {
+    const version = {
         id: row.id,
         skillId: row.skill_id,
         version: row.version,
@@ -398,6 +884,78 @@ function mapVersion(row) {
         status: row.status,
         createdAt: row.created_at,
     };
+    if (row.lifecycle_label !== null && row.lifecycle_label !== undefined)
+        version.lifecycleLabel = row.lifecycle_label;
+    if (row.draft_parent_version_id !== null && row.draft_parent_version_id !== undefined)
+        version.draftParentVersionId = row.draft_parent_version_id;
+    if (row.draft_revision !== null && row.draft_revision !== undefined)
+        version.draftRevision = row.draft_revision;
+    if (row.governance_json !== null && row.governance_json !== undefined)
+        version.governance = JSON.parse(row.governance_json);
+    if (row.published_at !== null && row.published_at !== undefined)
+        version.publishedAt = row.published_at;
+    if (row.published_by !== null && row.published_by !== undefined)
+        version.publishedBy = row.published_by;
+    if (row.deprecated_at !== null && row.deprecated_at !== undefined)
+        version.deprecatedAt = row.deprecated_at;
+    if (row.archived_at !== null && row.archived_at !== undefined)
+        version.archivedAt = row.archived_at;
+    return version;
+}
+function mapLifecycleEvent(row) {
+    const event = {
+        id: row.id,
+        project: row.project,
+        scope: row.scope,
+        skillId: row.skill_id,
+        eventType: row.event_type,
+        createdAt: row.created_at,
+    };
+    if (row.version_id !== null)
+        event.versionId = row.version_id;
+    if (row.actor_type !== null && row.actor_id !== null)
+        event.actor = { type: row.actor_type, id: row.actor_id };
+    if (row.run_id !== null)
+        event.runId = row.run_id;
+    if (row.agent_id !== null)
+        event.agentId = row.agent_id;
+    if (row.reason !== null)
+        event.reason = row.reason;
+    if (row.before_json !== null)
+        event.before = JSON.parse(row.before_json);
+    if (row.after_json !== null)
+        event.after = JSON.parse(row.after_json);
+    if (row.evidence_json !== null)
+        event.evidence = JSON.parse(row.evidence_json);
+    return event;
+}
+function resolveSkillForMutation(repository, project, scope, skillId, name) {
+    const result = skillId !== undefined ? repository.getById(skillId) : repository.getByName(project, scope, name ?? '');
+    if (!result.ok)
+        throw new SkillRegistryValidationError(result.error.message);
+    if (result.value.project !== project || result.value.scope !== scope)
+        throw new SkillRegistryValidationError('Skill does not belong to the requested project/scope');
+    return result.value;
+}
+function resolveVersionForMutation(repository, skillId, versionId, version) {
+    const result = versionId !== undefined ? repository.getVersion(versionId) : repository.getVersionBySkillVersion(skillId, version ?? '');
+    if (!result.ok)
+        throw new SkillRegistryValidationError(result.error.message);
+    if (result.value.skillId !== skillId)
+        throw new SkillRegistryValidationError('Skill version must belong to the requested skill');
+    return result.value;
+}
+function versionSnapshot(version) {
+    return {
+        id: version.id,
+        skillId: version.skillId,
+        version: version.version,
+        status: version.status,
+        draftRevision: version.draftRevision ?? null,
+        lifecycleLabel: version.lifecycleLabel ?? null,
+        publishedAt: version.publishedAt ?? null,
+        publishedBy: version.publishedBy ?? null,
+    };
 }
 function mapAttachment(row) {
     const attachment = {
@@ -429,8 +987,48 @@ function mapUsage(row) {
         usage.targetKey = row.target_key;
     if (row.notes !== null)
         usage.notes = row.notes;
+    if (row.workflow !== null)
+        usage.workflow = row.workflow;
+    if (row.phase !== null)
+        usage.phase = row.phase;
+    if (row.provider_adapter !== null)
+        usage.providerAdapter = row.provider_adapter;
+    if (row.agent_id !== null)
+        usage.agentId = row.agent_id;
+    if (row.intent_json !== null)
+        usage.intent = JSON.parse(row.intent_json);
+    if (row.evidence_json !== null)
+        usage.evidence = JSON.parse(row.evidence_json);
     return usage;
 }
+function mapActivation(row) {
+    const activation = {
+        id: row.id,
+        project: row.project,
+        scope: row.scope,
+        skillId: row.skill_id,
+        createdAt: row.created_at,
+    };
+    if (row.version_id !== null)
+        activation.versionId = row.version_id;
+    if (row.run_id !== null)
+        activation.runId = row.run_id;
+    if (row.agent_id !== null)
+        activation.agentId = row.agent_id;
+    if (row.workflow !== null)
+        activation.workflow = row.workflow;
+    if (row.phase !== null)
+        activation.phase = row.phase;
+    if (row.provider_adapter !== null)
+        activation.providerAdapter = row.provider_adapter;
+    if (row.intent_json !== null)
+        activation.intent = JSON.parse(row.intent_json);
+    if (row.reason !== null)
+        activation.reason = row.reason;
+    if (row.payload_metadata_json !== null)
+        activation.payloadMetadata = JSON.parse(row.payload_metadata_json);
+    return activation;
+}
 function ok(value) {
     return { ok: true, value };
 }
@@ -448,3 +1046,32 @@ function fail(message, cause) {
 }
 class SkillRegistryValidationError extends Error {
 }
+function normalizeLimit(limit) {
+    if (limit === undefined)
+        return 25;
+    if (!Number.isSafeInteger(limit) || limit < 1)
+        return 25;
+    return Math.min(limit, 100);
+}
+function zeroVersionCounts() {
+    return { draft: 0, active: 0, deprecated: 0, archived: 0 };
+}
+function zeroProposalCounts() {
+    return { draft: 0, 'pending-approval': 0, approved: 0, rejected: 0, cancelled: 0, applied: 0 };
+}
+function zeroEvaluationResultCounts() {
+    return { passed: 0, failed: 0, 'needs-review': 0, 'not-applicable': 0 };
+}
+function zeroEvaluationRequestCounts() {
+    return { requested: 0, planned: 0, running: 0, completed: 0, failed: 0, cancelled: 0, skipped: 0 };
+}
+function countScoped(db, table, project, scope) {
+    const row = db.connection
+        .prepare(`SELECT COUNT(*) AS count FROM ${table} t JOIN skills s ON s.id=t.skill_id WHERE s.project=? AND s.scope=?`)
+        .get(project, scope);
+    return row.count;
+}
+function countDirectScoped(db, table, project, scope) {
+    const row = db.connection.prepare(`SELECT COUNT(*) AS count FROM ${table} WHERE project=? AND scope=?`).get(project, scope);
+    return row.count;
+}