skills-console 0.4.0

package/dist/application/backup-manager.js

@@ -0,0 +1,164 @@
+import { randomUUID } from 'node:crypto';
+import { cp, lstat, mkdir, readFile, readlink, realpath, rename, rm, stat, symlink, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { backupsDirectory } from '../platform/data-paths.js';
+function isContained(root, target, allowRoot = false) {
+    const relativePath = relative(resolve(root), resolve(target));
+    if (!relativePath) {
+        return allowRoot;
+    }
+    return !relativePath.startsWith('..') && !isAbsolute(relativePath);
+}
+async function pathExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function matchesPlan(installation, plan) {
+    return (installation.mutable &&
+        plan.skillNames.includes(installation.skillName) &&
+        (!plan.scope || installation.scope === plan.scope) &&
+        (plan.agentIds.length === 0 ||
+            installation.agentIds.some((agentId) => plan.agentIds.includes(agentId))));
+}
+function allowedRootsForPlan(inventory, plan) {
+    return [
+        ...new Set(inventory.roots
+            .filter((root) => root.mutable)
+            .filter((root) => !plan.scope || root.scope === plan.scope)
+            .filter((root) => plan.agentIds.length === 0 ||
+            root.agentIds.some((agentId) => plan.agentIds.includes(agentId)))
+            .map((root) => resolve(root.path))),
+    ];
+}
+async function writeSnapshot(snapshot) {
+    const finalPath = join(snapshot.directory, 'snapshot.json');
+    const temporaryPath = `${finalPath}.tmp`;
+    await writeFile(temporaryPath, `${JSON.stringify(snapshot, null, 2)}\n`, 'utf8');
+    await rename(temporaryPath, finalPath);
+}
+export async function createOperationSnapshot(plan, inventory, dataRoot) {
+    if (plan.kind === 'preview') {
+        throw new Error('Cannot snapshot a preview command.');
+    }
+    const id = randomUUID();
+    const directory = join(backupsDirectory(dataRoot), id);
+    const contentDirectory = join(directory, 'content');
+    await mkdir(contentDirectory, { recursive: true });
+    const allowedRoots = allowedRootsForPlan(inventory, plan);
+    const existing = inventory.installations.filter((installation) => matchesPlan(installation, plan));
+    const entries = [];
+    for (const installation of existing) {
+        const containingRoot = allowedRoots.find((root) => isContained(root, installation.path));
+        if (!containingRoot) {
+            throw new Error(`Refusing to back up a path outside approved Skill roots: ${installation.path}`);
+        }
+        const entryId = randomUUID();
+        const backupRelativePath = join('content', entryId);
+        const backupPath = join(directory, backupRelativePath);
+        let linkTarget;
+        if (installation.linkKind === 'symlink') {
+            linkTarget = await readlink(installation.path);
+        }
+        await cp(installation.realPath, backupPath, {
+            recursive: true,
+            force: false,
+            errorOnExist: true,
+            preserveTimestamps: true,
+        });
+        entries.push({
+            id: entryId,
+            skillName: installation.skillName,
+            originalPath: resolve(installation.path),
+            realPath: resolve(installation.realPath),
+            backupRelativePath,
+            linkKind: installation.linkKind,
+            linkTarget,
+            scope: installation.scope,
+        });
+    }
+    const snapshot = {
+        schemaVersion: 1,
+        id,
+        operationKind: plan.kind,
+        createdAt: new Date().toISOString(),
+        restoredAt: undefined,
+        directory,
+        allowedRoots,
+        entries,
+        createdPaths: [],
+    };
+    await writeSnapshot(snapshot);
+    return snapshot;
+}
+export async function finalizeOperationSnapshot(snapshot, plan, before, after) {
+    const beforePaths = new Set(before.installations.filter((installation) => matchesPlan(installation, plan)).map((item) => resolve(item.path)));
+    snapshot.createdPaths = after.installations
+        .filter((installation) => matchesPlan(installation, plan))
+        .map((item) => resolve(item.path))
+        .filter((path) => !beforePaths.has(path));
+    await writeSnapshot(snapshot);
+    return snapshot;
+}
+export async function loadOperationSnapshot(snapshotId, dataRoot) {
+    const directory = join(backupsDirectory(dataRoot), snapshotId);
+    const parsed = JSON.parse(await readFile(join(directory, 'snapshot.json'), 'utf8'));
+    if (parsed.schemaVersion !== 1 || parsed.id !== snapshotId) {
+        throw new Error('Unsupported or mismatched snapshot manifest.');
+    }
+    parsed.directory = directory;
+    return parsed;
+}
+function assertRestorablePath(snapshot, path) {
+    if (!snapshot.allowedRoots.some((root) => isContained(root, path))) {
+        throw new Error(`Refusing to restore a path outside recorded Skill roots: ${path}`);
+    }
+}
+export async function restoreOperationSnapshot(snapshot) {
+    const fallbacks = [];
+    let removedCreatedPaths = 0;
+    let restoredEntries = 0;
+    for (const createdPath of snapshot.createdPaths) {
+        assertRestorablePath(snapshot, createdPath);
+        if (await pathExists(createdPath)) {
+            await rm(createdPath, { recursive: true, force: true });
+            removedCreatedPaths += 1;
+        }
+    }
+    for (const entry of snapshot.entries) {
+        assertRestorablePath(snapshot, entry.originalPath);
+        const backupPath = join(snapshot.directory, entry.backupRelativePath);
+        if (!isContained(snapshot.directory, backupPath)) {
+            throw new Error('Snapshot content path escapes its backup directory.');
+        }
+        await stat(backupPath);
+        if (await pathExists(entry.originalPath)) {
+            await rm(entry.originalPath, { recursive: true, force: true });
+        }
+        await mkdir(dirname(entry.originalPath), { recursive: true });
+        if (entry.linkKind === 'symlink' && entry.linkTarget) {
+            const target = isAbsolute(entry.linkTarget)
+                ? entry.linkTarget
+                : resolve(dirname(entry.originalPath), entry.linkTarget);
+            if (await pathExists(target)) {
+                await symlink(entry.linkTarget, entry.originalPath, 'dir');
+            }
+            else {
+                await cp(backupPath, entry.originalPath, { recursive: true, preserveTimestamps: true });
+                fallbacks.push(`${entry.skillName}: restored as a directory because its link target is missing.`);
+            }
+        }
+        else {
+            await cp(backupPath, entry.originalPath, { recursive: true, preserveTimestamps: true });
+        }
+        restoredEntries += 1;
+    }
+    snapshot.restoredAt = new Date().toISOString();
+    await writeSnapshot(snapshot);
+    return { snapshotId: snapshot.id, restoredEntries, removedCreatedPaths, fallbacks };
+}
+//# sourceMappingURL=backup-manager.js.map

package/dist/application/backup-manager.js.map

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

package/dist/application/build-inventory.d.ts

@@ -0,0 +1,5 @@
+import type { Inventory } from '../domain/types.js';
+export declare function buildInventory(options?: {
+    cwd?: string;
+    homeDir?: string;
+}): Promise<Inventory>;

package/dist/application/build-inventory.js

@@ -0,0 +1,103 @@
+import { createHash } from 'node:crypto';
+import { resolveAgentRegistry } from '../adapters/filesystem/agent-registry.js';
+import { scanSkillRoots } from '../adapters/filesystem/skill-scanner.js';
+import { enrichInstallationsFromSkillsLocks } from '../adapters/filesystem/skills-lock.js';
+import { detectEnvironment } from '../platform/environment.js';
+function stableId(...parts) {
+    return createHash('sha1').update(parts.join('\0')).digest('hex').slice(0, 16);
+}
+function diagnostic(input) {
+    return { id: stableId(input.code, input.path ?? '', input.message), ...input };
+}
+function markEffectiveInstallations(installations) {
+    const diagnostics = [];
+    const byAgentAndName = new Map();
+    for (const installation of installations) {
+        for (const agentId of installation.agentIds) {
+            const key = `${agentId}:${installation.skillName}`;
+            byAgentAndName.set(key, [...(byAgentAndName.get(key) ?? []), installation]);
+        }
+    }
+    for (const [key, matches] of byAgentAndName) {
+        const projectMatches = matches.filter((item) => item.scope === 'project');
+        const effective = projectMatches.length > 0 ? projectMatches : matches;
+        for (const installation of matches) {
+            installation.isEffective = effective.includes(installation);
+        }
+        const uniqueEffectivePaths = new Set(effective.map((item) => item.realPath));
+        if (uniqueEffectivePaths.size > 1) {
+            const skillName = matches[0]?.skillName;
+            diagnostics.push(diagnostic({
+                code: 'duplicate-effective-skill',
+                severity: 'warning',
+                message: `${key} resolves to ${uniqueEffectivePaths.size} different physical copies.`,
+                path: undefined,
+                skillName,
+            }));
+        }
+        if (projectMatches.length > 0 && matches.some((item) => item.scope === 'user')) {
+            const skillName = matches[0]?.skillName;
+            diagnostics.push(diagnostic({
+                code: 'project-shadows-user',
+                severity: 'info',
+                message: `${key} uses the project installation instead of the user installation.`,
+                path: projectMatches[0]?.path,
+                skillName,
+            }));
+        }
+    }
+    return diagnostics;
+}
+function groupSkills(installations) {
+    const grouped = new Map();
+    for (const installation of installations) {
+        grouped.set(installation.skillName, [
+            ...(grouped.get(installation.skillName) ?? []),
+            installation,
+        ]);
+    }
+    return [...grouped.entries()]
+        .map(([name, matches]) => {
+        const diagnostics = matches.flatMap((item) => item.diagnostics);
+        return {
+            name,
+            description: matches.find((item) => item.description)?.description ?? 'No description available.',
+            installations: matches.sort((a, b) => a.path.localeCompare(b.path)),
+            agentIds: [...new Set(matches.flatMap((item) => item.agentIds))].sort(),
+            scopes: [...new Set(matches.map((item) => item.scope))].sort(),
+            errorCount: diagnostics.filter((item) => item.severity === 'error').length,
+            warningCount: diagnostics.filter((item) => item.severity === 'warning').length,
+        };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+export async function buildInventory(options = {}) {
+    const environment = await detectEnvironment(options);
+    const { agents, roots } = await resolveAgentRegistry(environment);
+    const scanResult = await scanSkillRoots(roots);
+    await enrichInstallationsFromSkillsLocks(scanResult.installations, environment);
+    const relationshipDiagnostics = markEffectiveInstallations(scanResult.installations);
+    const diagnostics = [...scanResult.diagnostics, ...relationshipDiagnostics].sort((a, b) => {
+        const rank = { error: 0, warning: 1, info: 2 };
+        return rank[a.severity] - rank[b.severity] || a.message.localeCompare(b.message);
+    });
+    const skills = groupSkills(scanResult.installations);
+    return {
+        environment,
+        agents,
+        roots,
+        installations: scanResult.installations,
+        skills,
+        diagnostics,
+        stats: {
+            skillCount: skills.length,
+            installationCount: scanResult.installations.length,
+            detectedAgentCount: agents.filter((agent) => agent.detected).length,
+            scannedRootCount: roots.filter((root) => root.exists && root.readable).length,
+            errorCount: diagnostics.filter((item) => item.severity === 'error').length,
+            warningCount: diagnostics.filter((item) => item.severity === 'warning').length,
+        },
+        scannedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=build-inventory.js.map

package/dist/application/build-inventory.js.map

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

package/dist/application/doctor-fixes.d.ts

@@ -0,0 +1,21 @@
+import type { OperationRecord, OperationSnapshot } from '../domain/operations.js';
+import type { Diagnostic, Inventory, SkillInstallation, SkillRoot } from '../domain/types.js';
+export interface DoctorFixPlan {
+    kind: 'rename-skill-directory';
+    diagnosticId: string;
+    description: string;
+    sourcePath: string;
+    targetPath: string;
+    skillName: string;
+    agentIds: string[];
+    root: SkillRoot;
+    installation: SkillInstallation;
+}
+export interface DoctorFixResult {
+    inventory: Inventory;
+    record: OperationRecord;
+    snapshot: OperationSnapshot;
+    message: string;
+}
+export declare function buildDoctorFixPlan(diagnostic: Diagnostic, inventory: Inventory): Promise<DoctorFixPlan | undefined>;
+export declare function executeDoctorFix(fix: DoctorFixPlan, inventory: Inventory, dataRoot: string): Promise<DoctorFixResult>;

package/dist/application/doctor-fixes.js

@@ -0,0 +1,103 @@
+import { lstat, rename, stat } from 'node:fs/promises';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { createOperationSnapshot, finalizeOperationSnapshot, } from './backup-manager.js';
+import { buildInventory } from './build-inventory.js';
+import { createHistoryRecord, saveHistoryRecord, } from './history-store.js';
+function isContained(root, target) {
+    const relativePath = relative(resolve(root), resolve(target));
+    return Boolean(relativePath) && !relativePath.startsWith('..') && !isAbsolute(relativePath);
+}
+async function pathExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function buildDoctorFixPlan(diagnostic, inventory) {
+    if (diagnostic.code !== 'name-directory-mismatch') {
+        return undefined;
+    }
+    const installation = inventory.installations.find((item) => item.diagnostics.some((itemDiagnostic) => itemDiagnostic.id === diagnostic.id));
+    if (!installation?.mutable) {
+        return undefined;
+    }
+    const root = inventory.roots.find((candidate) => candidate.mutable && isContained(candidate.path, installation.path));
+    if (!root) {
+        return undefined;
+    }
+    const targetPath = join(dirname(installation.path), installation.skillName);
+    if (!isContained(root.path, targetPath) || (await pathExists(targetPath))) {
+        return undefined;
+    }
+    return {
+        kind: 'rename-skill-directory',
+        diagnosticId: diagnostic.id,
+        description: `Rename ${installation.directoryName} to ${installation.skillName}`,
+        sourcePath: installation.path,
+        targetPath,
+        skillName: installation.skillName,
+        agentIds: installation.agentIds,
+        root,
+        installation,
+    };
+}
+function commandPlan(fix, inventory) {
+    return {
+        kind: 'repair',
+        executable: 'internal-doctor-fix',
+        args: [],
+        cwd: inventory.environment.projectRoot,
+        environment: {},
+        displayCommand: `skills-console doctor rename '${fix.sourcePath}' '${fix.targetPath}'`,
+        mutatesFilesystem: true,
+        skillNames: [fix.skillName],
+        agentIds: fix.agentIds,
+        scope: fix.installation.scope,
+        source: undefined,
+    };
+}
+export async function executeDoctorFix(fix, inventory, dataRoot) {
+    const plan = commandPlan(fix, inventory);
+    const snapshot = await createOperationSnapshot(plan, inventory, dataRoot);
+    const record = await createHistoryRecord(plan, snapshot.id, dataRoot);
+    try {
+        await stat(fix.sourcePath);
+        if (await pathExists(fix.targetPath)) {
+            throw new Error(`Repair target already exists: ${fix.targetPath}`);
+        }
+        await rename(fix.sourcePath, fix.targetPath);
+        const updatedInventory = await buildInventory({
+            cwd: inventory.environment.projectRoot,
+            homeDir: inventory.environment.homeDir,
+        });
+        await finalizeOperationSnapshot(snapshot, plan, inventory, updatedInventory);
+        const stillBroken = updatedInventory.diagnostics.some((diagnostic) => diagnostic.code === 'name-directory-mismatch' && diagnostic.skillName === fix.skillName);
+        record.status = stillBroken ? 'failed' : 'succeeded';
+        record.finishedAt = new Date().toISOString();
+        record.exitCode = 0;
+        record.verificationStatus = stillBroken ? 'failed' : 'verified';
+        record.verificationMessages = [
+            stillBroken
+                ? 'Directory rename completed but the mismatch diagnostic remains.'
+                : `Renamed Skill directory to ${fix.skillName}.`,
+        ];
+        await saveHistoryRecord(record, dataRoot);
+        return {
+            inventory: updatedInventory,
+            record,
+            snapshot,
+            message: record.verificationMessages[0] ?? 'Repair complete.',
+        };
+    }
+    catch (caught) {
+        record.status = 'failed';
+        record.finishedAt = new Date().toISOString();
+        record.error = caught instanceof Error ? caught.message : 'Unknown Doctor repair failure.';
+        await saveHistoryRecord(record, dataRoot);
+        throw caught;
+    }
+}
+//# sourceMappingURL=doctor-fixes.js.map

package/dist/application/doctor-fixes.js.map

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

package/dist/application/history-store.d.ts

@@ -0,0 +1,5 @@
+import type { SkillsCommandPlan } from '../adapters/skills-cli/types.js';
+import { type OperationRecord } from '../domain/operations.js';
+export declare function createHistoryRecord(plan: SkillsCommandPlan, snapshotId: string, dataRoot: string): Promise<OperationRecord>;
+export declare function saveHistoryRecord(record: OperationRecord, dataRoot: string): Promise<void>;
+export declare function listHistoryRecords(dataRoot: string): Promise<OperationRecord[]>;

package/dist/application/history-store.js

@@ -0,0 +1,42 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { operationRecordFromPlan, } from '../domain/operations.js';
+import { historyDirectory } from '../platform/data-paths.js';
+export async function createHistoryRecord(plan, snapshotId, dataRoot) {
+    const record = operationRecordFromPlan(randomUUID(), snapshotId, plan);
+    await saveHistoryRecord(record, dataRoot);
+    return record;
+}
+export async function saveHistoryRecord(record, dataRoot) {
+    const directory = historyDirectory(dataRoot);
+    await mkdir(directory, { recursive: true });
+    const finalPath = join(directory, `${record.id}.json`);
+    const temporaryPath = `${finalPath}.tmp`;
+    await writeFile(temporaryPath, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
+    await rename(temporaryPath, finalPath);
+}
+export async function listHistoryRecords(dataRoot) {
+    const directory = historyDirectory(dataRoot);
+    let names;
+    try {
+        names = await readdir(directory);
+    }
+    catch {
+        return [];
+    }
+    const records = [];
+    for (const name of names.filter((value) => value.endsWith('.json'))) {
+        try {
+            const record = JSON.parse(await readFile(join(directory, name), 'utf8'));
+            if (record.schemaVersion === 1) {
+                records.push(record);
+            }
+        }
+        catch {
+            // Ignore malformed records and keep the remaining history available.
+        }
+    }
+    return records.sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+}
+//# sourceMappingURL=history-store.js.map

package/dist/application/history-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-store.js","sourceRoot":"","sources":["../../src/application/history-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AACvC,OAAO,EAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAG/B,OAAO,EACL,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAuB,EACvB,UAAkB,EAClB,QAAgB;IAEhB,MAAM,MAAM,GAAG,uBAAuB,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACvE,MAAM,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAuB,EACvB,QAAgB;IAEhB,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,GAAG,SAAS,MAAM,CAAC;IACzC,MAAM,SAAS,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/E,MAAM,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAoB,CAAC;YAC5F,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/application/profile-apply.d.ts

@@ -0,0 +1,22 @@
+import type { SpawnProcess } from '../adapters/skills-cli/executor.js';
+import type { SkillsCommandPlan } from '../adapters/skills-cli/types.js';
+import type { OperationResult } from './skill-operations.js';
+import type { ProfileDiff, ProfileDiffEntry } from '../domain/profile.js';
+import type { Inventory } from '../domain/types.js';
+export interface ProfileApplyPlanItem {
+    entry: ProfileDiffEntry;
+    action: 'install' | 'remove' | 'skip';
+    command?: SkillsCommandPlan;
+    reason?: string;
+}
+export interface ProfileApplyResult {
+    inventory: Inventory;
+    operations: OperationResult[];
+    skipped: ProfileApplyPlanItem[];
+}
+export declare function buildProfileApplyPlan(diff: ProfileDiff, inventory: Inventory): ProfileApplyPlanItem[];
+export declare function applyProfilePlan(plan: ProfileApplyPlanItem[], inventory: Inventory, options?: {
+    dataRoot?: string;
+    spawnProcess?: SpawnProcess;
+    onProgress?: (item: ProfileApplyPlanItem, index: number, total: number) => void;
+}): Promise<ProfileApplyResult>;

package/dist/application/profile-apply.js

@@ -0,0 +1,69 @@
+import { buildInstallPlan, buildRemovePlan, } from '../adapters/skills-cli/command-builder.js';
+import { executeOperation } from './skill-operations.js';
+export function buildProfileApplyPlan(diff, inventory) {
+    return diff.entries.flatMap((entry) => {
+        if (entry.status === 'missing' || entry.status === 'source-mismatch') {
+            if (!entry.expected?.source) {
+                return [{ entry, action: 'skip', reason: 'Missing source; cannot install reproducibly.' }];
+            }
+            return [
+                {
+                    entry,
+                    action: 'install',
+                    command: buildInstallPlan({
+                        source: entry.expected.source,
+                        skillNames: [entry.expected.name],
+                        agentIds: entry.status === 'missing' && entry.missingAgentIds.length > 0
+                            ? entry.missingAgentIds
+                            : entry.expected.agentIds,
+                        scope: entry.expected.scope,
+                        mode: entry.expected.mode,
+                        cwd: inventory.environment.projectRoot,
+                    }),
+                },
+            ];
+        }
+        if (entry.status === 'extra' && diff.profile.policy.removeExtras) {
+            const agentIds = [...new Set(entry.actual.flatMap((item) => item.agentIds))];
+            return [
+                {
+                    entry,
+                    action: 'remove',
+                    command: buildRemovePlan({
+                        skillNames: [entry.skillName],
+                        agentIds,
+                        scope: entry.scope,
+                        cwd: inventory.environment.projectRoot,
+                    }),
+                },
+            ];
+        }
+        if (entry.status === 'source-unknown') {
+            return [{ entry, action: 'skip', reason: 'Source is unknown; refusing to overwrite.' }];
+        }
+        return [];
+    });
+}
+export async function applyProfilePlan(plan, inventory, options = {}) {
+    let currentInventory = inventory;
+    const operations = [];
+    const skipped = plan.filter((item) => item.action === 'skip' || !item.command);
+    const executable = plan.filter((item) => item.command && item.action !== 'skip');
+    for (let index = 0; index < executable.length; index += 1) {
+        const item = executable[index];
+        options.onProgress?.(item, index, executable.length);
+        const result = await executeOperation(item.command, {
+            homeDir: currentInventory.environment.homeDir,
+            inventoryBefore: currentInventory,
+            ...(options.dataRoot ? { dataRoot: options.dataRoot } : {}),
+            ...(options.spawnProcess ? { spawnProcess: options.spawnProcess } : {}),
+        });
+        operations.push(result);
+        currentInventory = result.inventory;
+        if (result.verification.status === 'failed') {
+            break;
+        }
+    }
+    return { inventory: currentInventory, operations, skipped };
+}
+//# sourceMappingURL=profile-apply.js.map

package/dist/application/profile-apply.js.map

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

package/dist/application/profile-diff.d.ts

@@ -0,0 +1,3 @@
+import type { ProfileDiff, SkillsProfile } from '../domain/profile.js';
+import type { Inventory } from '../domain/types.js';
+export declare function diffProfile(profile: SkillsProfile, inventory: Inventory): ProfileDiff;