@corvus-tools/skill-manager-core 0.1.0

package/dist/git/skillpackSetup.js

@@ -0,0 +1,177 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { parseSkillpackConfig } from '../config/configSchema.js';
+import { upsertSkillpackLockEntry } from '../lock/lockStore.js';
+import { resolveUserPath } from '../paths.js';
+import { runGit } from './gitRunner.js';
+export async function inspectSkillpackCheckout(checkoutPath, options = {}) {
+    const git = options.git ?? runGit;
+    const resolvedCheckoutPath = resolveUserPath(checkoutPath, options.homeDir);
+    if (!(await pathExists(resolvedCheckoutPath))) {
+        return {
+            status: 'checkout-missing',
+            checkoutPath: resolvedCheckoutPath,
+            exists: false,
+            readable: false,
+            dirty: false,
+            dirtyFiles: [],
+            message: 'Checkout missing'
+        };
+    }
+    const checkoutStat = await fs.stat(resolvedCheckoutPath);
+    if (!checkoutStat.isDirectory()) {
+        return {
+            status: 'checkout-unreadable',
+            checkoutPath: resolvedCheckoutPath,
+            exists: true,
+            readable: false,
+            dirty: false,
+            dirtyFiles: [],
+            message: 'Checkout path exists but is not a directory'
+        };
+    }
+    try {
+        await git(['rev-parse', '--is-inside-work-tree'], { cwd: resolvedCheckoutPath });
+        const commitHash = (await git(['rev-parse', 'HEAD'], { cwd: resolvedCheckoutPath })).stdout.trim();
+        const statusOutput = (await git(['-c', 'core.optionalLocks=false', 'status', '--porcelain=v1', '--untracked-files=all'], { cwd: resolvedCheckoutPath })).stdout;
+        const dirtyFiles = statusOutput
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean);
+        const dirty = dirtyFiles.length > 0;
+        return {
+            status: dirty ? 'checkout-dirty' : 'checkout-readable',
+            checkoutPath: resolvedCheckoutPath,
+            exists: true,
+            readable: true,
+            commitHash,
+            dirty,
+            dirtyFiles,
+            message: dirty ? 'Checkout exists and is dirty' : 'Checkout exists and is readable'
+        };
+    }
+    catch (error) {
+        return {
+            status: 'checkout-unreadable',
+            checkoutPath: resolvedCheckoutPath,
+            exists: true,
+            readable: false,
+            dirty: false,
+            dirtyFiles: [],
+            message: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+export async function applyInitialSkillpackSetup(options) {
+    const parsedConfig = parseSkillpackConfig(options.config);
+    const checkoutPath = resolveUserPath(parsedConfig.checkoutPath, options.homeDir);
+    const config = {
+        ...parsedConfig,
+        checkoutPath
+    };
+    const git = options.git ?? runGit;
+    const inspectOptions = options.homeDir === undefined ? { git } : { homeDir: options.homeDir, git };
+    const initialInspection = await inspectSkillpackCheckout(checkoutPath, inspectOptions);
+    if (initialInspection.status === 'checkout-missing') {
+        try {
+            await fs.mkdir(path.dirname(checkoutPath), { recursive: true });
+            await git(['clone', '--branch', config.branch, '--single-branch', config.repositoryUrl, checkoutPath]);
+        }
+        catch (error) {
+            return {
+                status: 'clone-failed',
+                config,
+                checkoutPath,
+                dirty: false,
+                dirtyFiles: [],
+                message: error instanceof Error ? error.message : String(error)
+            };
+        }
+        const clonedInspection = await inspectSkillpackCheckout(checkoutPath, inspectOptions);
+        if (!clonedInspection.readable || clonedInspection.commitHash === undefined) {
+            return {
+                status: 'clone-failed',
+                config,
+                checkoutPath,
+                dirty: false,
+                dirtyFiles: [],
+                message: clonedInspection.message
+            };
+        }
+        const lockPath = await recordSkillpackLock({
+            config,
+            managerStateDir: options.managerStateDir,
+            commitHash: clonedInspection.commitHash,
+            dirty: clonedInspection.dirty,
+            ...(options.now === undefined ? {} : { now: options.now })
+        });
+        return {
+            status: 'clone-complete',
+            config,
+            checkoutPath,
+            lockPath,
+            commitHash: clonedInspection.commitHash,
+            dirty: clonedInspection.dirty,
+            dirtyFiles: clonedInspection.dirtyFiles,
+            message: 'Initial clone complete'
+        };
+    }
+    if (initialInspection.readable && initialInspection.commitHash !== undefined) {
+        const lockPath = await recordSkillpackLock({
+            config,
+            managerStateDir: options.managerStateDir,
+            commitHash: initialInspection.commitHash,
+            dirty: initialInspection.dirty,
+            ...(options.now === undefined ? {} : { now: options.now })
+        });
+        return {
+            status: initialInspection.status,
+            config,
+            checkoutPath,
+            lockPath,
+            commitHash: initialInspection.commitHash,
+            dirty: initialInspection.dirty,
+            dirtyFiles: initialInspection.dirtyFiles,
+            message: initialInspection.message
+        };
+    }
+    return {
+        status: initialInspection.status,
+        config,
+        checkoutPath,
+        dirty: initialInspection.dirty,
+        dirtyFiles: initialInspection.dirtyFiles,
+        message: initialInspection.message
+    };
+}
+async function recordSkillpackLock(options) {
+    const lockOptions = options.now === undefined ?
+        { managerStateDir: options.managerStateDir } :
+        { managerStateDir: options.managerStateDir, now: options.now };
+    const recordedAt = (options.now ?? new Date()).toISOString();
+    const result = await upsertSkillpackLockEntry({
+        id: options.config.id,
+        repositoryUrl: options.config.repositoryUrl,
+        branch: options.config.branch,
+        checkoutPath: options.config.checkoutPath,
+        commitHash: options.commitHash,
+        dirty: options.dirty,
+        recordedAt
+    }, lockOptions);
+    return result.lockPath;
+}
+async function pathExists(candidatePath) {
+    try {
+        await fs.access(candidatePath);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            'code' in error &&
+            error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=skillpackSetup.js.map

package/dist/git/skillpackSetup.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { type ConfigLoadResult, type ConfigStoreOptions, ensureDefaultConfig, loadConfig, saveConfig } from './config/configStore.js';
+export { type AgentConfig, type AgentIdConfig, type ManagerConfig, type SkillpackConfig, agentConfigSchema, agentIdSchema, createDefaultManagerConfig, managerConfigSchema, parseManagerConfig, parseSkillpackConfig, skillpackConfigSchema } from './config/configSchema.js';
+export { type AgentAdapter, type AgentId, type AgentSupportStatus } from './agents/AgentAdapter.js';
+export { agentAdapters, getAgentAdapter, getAgentAdapters } from './agents/adapters.js';
+export { type CheckoutStatus, type SkillpackInspection, type SkillpackSetupOptions, type SkillpackSetupResult, type SkillpackSetupStatus, applyInitialSkillpackSetup, inspectSkillpackCheckout } from './git/skillpackSetup.js';
+export { type GitRunner, type GitRunOptions, type GitRunResult, runGit } from './git/gitRunner.js';
+export { type ManagerLock, type SkillpackLockEntry, createEmptyManagerLock, managerLockSchema, parseManagerLock, skillpackLockEntrySchema } from './lock/lockSchema.js';
+export { type LockStoreOptions, getDefaultLockPath, loadLock, saveLock, upsertSkillpackLockEntry } from './lock/lockStore.js';
+export { type RegistrySkillEntry, type SkillRegistry, type SupportedAgent, registrySkillEntrySchema, skillRegistrySchema, supportedAgentSchema } from './registry/registrySchema.js';
+export { type DiscoveredSkill, type SkillDiscoveryIssue, type SkillDiscoveryResult, type SkillDiscoverySeverity, type SkillRiskWarning, discoverSkillsFromCheckout } from './skills/skillDiscovery.js';
+export { type AgentLinkSelection, type GenerateLinkPlanInput, type LinkCreateOperation, type LinkPlan, type LinkPlanIssue, type LinkPlanOperation, type LinkPlanSkill, type LinkRemoveOperation, type TargetState, generateLinkPlan } from './links/linkPlan.js';
+export { type ApplyActionResult, type ApplyActionStatus, type ApplyLinkPlanOptions, type ApplyLinkPlanResult, applyLinkPlan } from './links/applyEngine.js';
+export { type ManagedLinkManifestEntry, type ManagedLinkType, type ManagerManifest, createEmptyManagerManifest, managedLinkManifestEntrySchema, managedLinkTypeSchema, managerManifestSchema, parseManagerManifest } from './manifest/manifestSchema.js';
+export { type ManifestStoreOptions, loadManifest, loadManifestOrDefault, resolveManifestPaths, saveManifest } from './manifest/manifestStore.js';
+export { type DoctorIssue, type DoctorIssueSeverity, type DoctorReport, type StatusReport, type StatusReportAgent, type StatusReportSkillpack } from './reports/reportTypes.js';
+export { type BuildStatusReportOptions, buildStatusReport } from './reports/statusReport.js';
+export { type BuildDoctorReportOptions, buildDoctorReport } from './reports/doctorReport.js';
+export { assertPathInside, configFileName, defaultConfigPath, defaultLockPath, defaultManifestPath, defaultManagerStateDir, defaultSkillpackCheckoutPath, expandTilde, isPathInside, lockFileName, manifestFileName, managerStateDirSegments, resolveUserPath } from './paths.js';
+export { defaultSkillpackBranch, defaultSkillpackDisplayName, defaultSkillpackId, defaultSkillpackRepositoryUrl } from './skillpackDefaults.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,18 @@
+export { ensureDefaultConfig, loadConfig, saveConfig } from './config/configStore.js';
+export { agentConfigSchema, agentIdSchema, createDefaultManagerConfig, managerConfigSchema, parseManagerConfig, parseSkillpackConfig, skillpackConfigSchema } from './config/configSchema.js';
+export { agentAdapters, getAgentAdapter, getAgentAdapters } from './agents/adapters.js';
+export { applyInitialSkillpackSetup, inspectSkillpackCheckout } from './git/skillpackSetup.js';
+export { runGit } from './git/gitRunner.js';
+export { createEmptyManagerLock, managerLockSchema, parseManagerLock, skillpackLockEntrySchema } from './lock/lockSchema.js';
+export { getDefaultLockPath, loadLock, saveLock, upsertSkillpackLockEntry } from './lock/lockStore.js';
+export { registrySkillEntrySchema, skillRegistrySchema, supportedAgentSchema } from './registry/registrySchema.js';
+export { discoverSkillsFromCheckout } from './skills/skillDiscovery.js';
+export { generateLinkPlan } from './links/linkPlan.js';
+export { applyLinkPlan } from './links/applyEngine.js';
+export { createEmptyManagerManifest, managedLinkManifestEntrySchema, managedLinkTypeSchema, managerManifestSchema, parseManagerManifest } from './manifest/manifestSchema.js';
+export { loadManifest, loadManifestOrDefault, resolveManifestPaths, saveManifest } from './manifest/manifestStore.js';
+export { buildStatusReport } from './reports/statusReport.js';
+export { buildDoctorReport } from './reports/doctorReport.js';
+export { assertPathInside, configFileName, defaultConfigPath, defaultLockPath, defaultManifestPath, defaultManagerStateDir, defaultSkillpackCheckoutPath, expandTilde, isPathInside, lockFileName, manifestFileName, managerStateDirSegments, resolveUserPath } from './paths.js';
+export { defaultSkillpackBranch, defaultSkillpackDisplayName, defaultSkillpackId, defaultSkillpackRepositoryUrl } from './skillpackDefaults.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,mBAAmB,EACnB,UAAU,EACV,UAAU,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAKL,iBAAiB,EACjB,aAAa,EACb,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAC,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAML,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAwD,MAAM,EAAC,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAGL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAML,0BAA0B,EAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAUL,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAKL,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACb,MAAM,6BAA6B,CAAC;AASrC,OAAO,EAAgC,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAC3F,OAAO,EAAgC,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAC3F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,4BAA4B,EAC5B,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,6BAA6B,EAC9B,MAAM,wBAAwB,CAAC"}

package/dist/links/applyEngine.d.ts

@@ -0,0 +1,24 @@
+import { type ManifestStoreOptions } from '../manifest/manifestStore.js';
+import type { LinkPlan, LinkPlanOperation } from './linkPlan.js';
+export type ApplyActionStatus = 'applied' | 'skipped' | 'planned';
+export interface ApplyActionResult {
+    status: ApplyActionStatus;
+    code: string;
+    message: string;
+    operation: LinkPlanOperation;
+}
+export interface ApplyLinkPlanResult {
+    dryRun: boolean;
+    manifestPath: string;
+    applied: ApplyActionResult[];
+    skipped: ApplyActionResult[];
+    planned: ApplyActionResult[];
+}
+export interface ApplyLinkPlanOptions extends ManifestStoreOptions {
+    plan: LinkPlan;
+    skillpackCheckoutPath: string;
+    dryRun?: boolean;
+    confirmReplaceBrokenManagedLinks?: boolean;
+}
+export declare function applyLinkPlan(options: ApplyLinkPlanOptions): Promise<ApplyLinkPlanResult>;
+//# sourceMappingURL=applyEngine.d.ts.map

package/dist/links/applyEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyEngine.d.ts","sourceRoot":"","sources":["../../src/links/applyEngine.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAsB,QAAQ,EAAE,iBAAiB,EAAsB,MAAM,eAAe,CAAC;AAEzG,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,IAAI,EAAE,QAAQ,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8C/F"}

package/dist/links/applyEngine.js

@@ -0,0 +1,230 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { isPathInside, resolveUserPath } from '../paths.js';
+import { loadManifestOrDefault, saveManifest } from '../manifest/manifestStore.js';
+export async function applyLinkPlan(options) {
+    const dryRun = options.dryRun ?? false;
+    const loadedManifest = await loadManifestOrDefault(options);
+    const manifest = cloneManifest(loadedManifest.manifest);
+    const skillpackCheckoutPath = resolveUserPath(options.skillpackCheckoutPath, options.homeDir);
+    const applied = [];
+    const skipped = [];
+    const planned = [];
+    for (const operation of options.plan.operations) {
+        const nowOption = options.now === undefined ? {} : { now: options.now };
+        const result = operation.type === 'create-link' ?
+            await planOrApplyCreate(operation, {
+                manifest,
+                skillpackCheckoutPath,
+                dryRun,
+                confirmReplaceBrokenManagedLinks: options.confirmReplaceBrokenManagedLinks ?? false,
+                ...nowOption
+            }) :
+            await planOrApplyRemove(operation, {
+                manifest,
+                dryRun,
+                ...nowOption
+            });
+        if (result.status === 'applied') {
+            applied.push(result);
+        }
+        else if (result.status === 'planned') {
+            planned.push(result);
+        }
+        else {
+            skipped.push(result);
+        }
+    }
+    if (!dryRun) {
+        manifest.updatedAt = (options.now ?? new Date()).toISOString();
+        await saveManifest(manifest, options);
+    }
+    return {
+        dryRun,
+        manifestPath: loadedManifest.manifestPath,
+        applied,
+        skipped,
+        planned
+    };
+}
+async function planOrApplyCreate(operation, options) {
+    const sourcePath = resolveUserPath(operation.sourcePath);
+    const targetPath = resolveUserPath(operation.targetPath);
+    if (!isPathInside(options.skillpackCheckoutPath, sourcePath)) {
+        return skipped(operation, 'source-outside-skillpack', `Source is outside the configured skillpack checkout: ${sourcePath}`);
+    }
+    if (!(await pathExists(sourcePath))) {
+        return skipped(operation, 'missing-source', `Source does not exist: ${sourcePath}`);
+    }
+    const manifestEntry = options.manifest.links[targetPath];
+    const targetInspection = await inspectTarget(targetPath);
+    if (targetInspection.kind === 'missing') {
+        if (options.dryRun) {
+            return planned(operation, 'create-link', `Would create manager-owned link at ${targetPath}`);
+        }
+        const linkType = await createManagedLink({ sourcePath, targetPath });
+        const nowOption = options.now === undefined ? {} : { now: options.now };
+        upsertManifestEntry(options.manifest, {
+            agentId: operation.agentId,
+            skillId: operation.skillId,
+            sourcePath,
+            targetPath,
+            linkType,
+            ...nowOption
+        });
+        return applied(operation, 'created-link', `Created manager-owned link at ${targetPath}`);
+    }
+    if (targetInspection.kind === 'file') {
+        return skipped(operation, 'unmanaged-file-exists', `Refusing to overwrite real file: ${targetPath}`);
+    }
+    if (targetInspection.kind === 'directory') {
+        return skipped(operation, 'unmanaged-directory-exists', `Refusing to overwrite real directory: ${targetPath}`);
+    }
+    if (manifestEntry === undefined) {
+        return skipped(operation, 'unmanaged-symlink-exists', `Refusing to overwrite unmanaged symlink: ${targetPath}`);
+    }
+    if (!manifestMatchesOwnership(manifestEntry, operation, targetPath)) {
+        return skipped(operation, 'manifest-mismatch', `Manifest ownership does not match requested link: ${targetPath}`);
+    }
+    if (targetInspection.broken && !options.confirmReplaceBrokenManagedLinks) {
+        return skipped(operation, 'broken-managed-link-needs-confirmation', `Broken manager-owned link requires explicit confirmation before replacement: ${targetPath}`);
+    }
+    if (targetInspection.broken) {
+        if (options.dryRun) {
+            return planned(operation, 'replace-broken-managed-link', `Would replace broken manager-owned link at ${targetPath}`);
+        }
+        await fs.unlink(targetPath);
+        const linkType = await createManagedLink({ sourcePath, targetPath });
+        const nowOption = options.now === undefined ? {} : { now: options.now };
+        upsertManifestEntry(options.manifest, {
+            agentId: operation.agentId,
+            skillId: operation.skillId,
+            sourcePath,
+            targetPath,
+            linkType,
+            existingCreatedAt: manifestEntry.createdAt,
+            ...nowOption
+        });
+        return applied(operation, 'replaced-broken-managed-link', `Replaced broken manager-owned link at ${targetPath}`);
+    }
+    if (manifestEntry.sourcePath !== sourcePath || targetInspection.resolvedSourcePath !== sourcePath) {
+        return skipped(operation, 'link-target-mismatch', `Existing link target does not match expected source: ${targetPath}`);
+    }
+    return skipped(operation, 'managed-link-already-present', `Managed link already exists: ${targetPath}`);
+}
+async function planOrApplyRemove(operation, options) {
+    const targetPath = resolveUserPath(operation.targetPath);
+    const manifestEntry = options.manifest.links[targetPath];
+    const targetInspection = await inspectTarget(targetPath);
+    if (manifestEntry === undefined) {
+        return skipped(operation, 'not-manager-owned', `Refusing to remove target not owned by manifest: ${targetPath}`);
+    }
+    if (!manifestMatchesRemoveOperation(manifestEntry, operation, targetPath)) {
+        return skipped(operation, 'manifest-mismatch', `Manifest ownership does not match requested removal: ${targetPath}`);
+    }
+    if (targetInspection.kind === 'missing') {
+        if (options.dryRun) {
+            return planned(operation, 'remove-stale-manifest-entry', `Would remove stale manifest entry for ${targetPath}`);
+        }
+        delete options.manifest.links[targetPath];
+        return applied(operation, 'removed-stale-manifest-entry', `Removed stale manifest entry for ${targetPath}`);
+    }
+    if (targetInspection.kind !== 'symlink') {
+        return skipped(operation, 'target-is-not-link', `Refusing to remove non-link target: ${targetPath}`);
+    }
+    if (targetInspection.resolvedSourcePath !== manifestEntry.sourcePath) {
+        return skipped(operation, 'link-target-mismatch', `Refusing to remove link whose target differs from manifest: ${targetPath}`);
+    }
+    if (options.dryRun) {
+        return planned(operation, 'remove-managed-link', `Would remove manager-owned link at ${targetPath}`);
+    }
+    await fs.unlink(targetPath);
+    delete options.manifest.links[targetPath];
+    return applied(operation, 'removed-managed-link', `Removed manager-owned link at ${targetPath}`);
+}
+async function createManagedLink(options) {
+    await fs.mkdir(path.dirname(options.targetPath), { recursive: true });
+    const sourceStat = await fs.stat(options.sourcePath);
+    const linkType = process.platform === 'win32' && sourceStat.isDirectory() ? 'junction' : 'symlink';
+    await fs.symlink(options.sourcePath, options.targetPath, linkType === 'junction' ? 'junction' : 'dir');
+    return linkType;
+}
+async function inspectTarget(targetPath) {
+    let stat;
+    try {
+        stat = await fs.lstat(targetPath);
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return { kind: 'missing' };
+        }
+        throw error;
+    }
+    if (stat.isSymbolicLink()) {
+        const linkTarget = await fs.readlink(targetPath);
+        const resolvedSourcePath = path.resolve(path.dirname(targetPath), linkTarget);
+        const broken = !(await pathExists(resolvedSourcePath));
+        return {
+            kind: 'symlink',
+            resolvedSourcePath,
+            broken
+        };
+    }
+    if (stat.isDirectory()) {
+        return { kind: 'directory' };
+    }
+    return { kind: 'file' };
+}
+function upsertManifestEntry(manifest, options) {
+    const timestamp = (options.now ?? new Date()).toISOString();
+    manifest.links[options.targetPath] = {
+        agentId: options.agentId,
+        skillId: options.skillId,
+        targetPath: options.targetPath,
+        sourcePath: options.sourcePath,
+        linkType: options.linkType,
+        createdAt: options.existingCreatedAt ?? timestamp,
+        updatedAt: timestamp
+    };
+}
+function manifestMatchesOwnership(entry, operation, targetPath) {
+    return (entry.agentId === operation.agentId &&
+        entry.skillId === operation.skillId &&
+        entry.targetPath === targetPath);
+}
+function manifestMatchesRemoveOperation(entry, operation, targetPath) {
+    return entry.agentId === operation.agentId && entry.skillId === operation.skillId && entry.targetPath === targetPath;
+}
+function cloneManifest(manifest) {
+    return {
+        ...manifest,
+        links: Object.fromEntries(Object.entries(manifest.links).map(([targetPath, entry]) => [targetPath, { ...entry }]))
+    };
+}
+function planned(operation, code, message) {
+    return { status: 'planned', code, message, operation };
+}
+function applied(operation, code, message) {
+    return { status: 'applied', code, message, operation };
+}
+function skipped(operation, code, message) {
+    return { status: 'skipped', code, message, operation };
+}
+async function pathExists(candidatePath) {
+    try {
+        await fs.access(candidatePath);
+        return true;
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+function isMissingFileError(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+//# sourceMappingURL=applyEngine.js.map

package/dist/links/applyEngine.js.map

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

package/dist/links/linkPlan.d.ts

@@ -0,0 +1,54 @@
+import type { AgentAdapter, AgentId } from '../agents/AgentAdapter.js';
+export interface LinkPlanSkill {
+    id: string;
+    absolutePath: string;
+}
+export interface AgentLinkSelection {
+    agentId: AgentId;
+    enabled: boolean;
+    targetPath?: string;
+    selectedSkillIds: string[];
+    previousSelectedSkillIds?: string[];
+}
+export interface TargetState {
+    path: string;
+    exists: boolean;
+    managed: boolean;
+    sourcePath?: string;
+}
+export interface LinkCreateOperation {
+    type: 'create-link';
+    agentId: AgentId;
+    skillId: string;
+    sourcePath: string;
+    targetPath: string;
+}
+export interface LinkRemoveOperation {
+    type: 'remove-link';
+    agentId: AgentId;
+    skillId: string;
+    targetPath: string;
+}
+export type LinkPlanOperation = LinkCreateOperation | LinkRemoveOperation;
+export interface LinkPlanIssue {
+    severity: 'warning' | 'conflict';
+    code: string;
+    message: string;
+    agentId?: AgentId;
+    skillId?: string;
+    path?: string;
+}
+export interface LinkPlan {
+    operations: LinkPlanOperation[];
+    conflicts: LinkPlanIssue[];
+    warnings: LinkPlanIssue[];
+}
+export interface GenerateLinkPlanInput {
+    adapters: AgentAdapter[];
+    selections: AgentLinkSelection[];
+    skills: LinkPlanSkill[];
+    homeDir?: string;
+    targetStates?: TargetState[];
+}
+export declare function generateLinkPlan(input: GenerateLinkPlanInput): LinkPlan;
+//# sourceMappingURL=linkPlan.d.ts.map

package/dist/links/linkPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkPlan.d.ts","sourceRoot":"","sources":["../../src/links/linkPlan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAE,OAAO,EAAC,MAAM,2BAA2B,CAAC;AAGrE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,QAAQ,CA2HvE"}