@open-agent-toolkit/cli 0.1.74 → 0.2.0

package/dist/engine/compute-plan.js

@@ -1,8 +1,10 @@
-import { access, lstat, readFile, readlink } from 'node:fs/promises';
-import { basename, dirname, join, normalize, resolve } from 'node:path';
+import { createHash } from 'node:crypto';
+import { access, lstat, readdir, readFile, readlink, stat, } from 'node:fs/promises';
+import { basename, dirname, join, normalize, relative, resolve, } from 'node:path';
 import { computeContentHash, computeStringHash } from '../manifest/hash.js';
 import { findEntry } from '../manifest/manager.js';
 import { getSyncMappings } from '../providers/shared/adapter.utils.js';
+import { OAT_DIRECTORY_SENTINEL, OAT_MARKER_PREFIX } from './markers.js';
 function buildUpLevels(depth) {
     return Array.from({ length: depth }, () => '..');
 }
@@ -88,6 +90,145 @@ function createRemovalEntry(manifestEntry, scopeRoot) {
         reason: 'canonical entry no longer exists',
     };
 }
+function createRetirementEntry(manifestEntry, scopeRoot, operation, reason) {
+    return {
+        ...createRemovalEntry(manifestEntry, scopeRoot),
+        operation,
+        reason,
+    };
+}
+function manifestEntryInsideMapping(entry, mapping) {
+    if (entry.contentType !== mapping.contentType) {
+        return false;
+    }
+    const canonicalPath = normalize(entry.canonicalPath).replaceAll('\\', '/');
+    const canonicalDir = normalize(mapping.canonicalDir).replaceAll('\\', '/');
+    return (canonicalPath === canonicalDir ||
+        canonicalPath.startsWith(`${canonicalDir}/`));
+}
+async function computeManagedDirectoryCopyHash(providerPath, canonicalPath, contentType) {
+    const expectedMarker = `${OAT_MARKER_PREFIX} Source: ${canonicalPath} -->`;
+    const sentinelPath = join(providerPath, OAT_DIRECTORY_SENTINEL);
+    try {
+        const sentinel = await readFile(sentinelPath, 'utf8');
+        if (sentinel !== `${expectedMarker}\n`) {
+            return null;
+        }
+    }
+    catch {
+        return null;
+    }
+    const files = [];
+    async function collectFiles(current) {
+        const entries = await readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(current, entry.name);
+            if (fullPath === sentinelPath) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                if (!(await collectFiles(fullPath))) {
+                    return false;
+                }
+                continue;
+            }
+            if (!entry.isFile()) {
+                return false;
+            }
+            files.push(fullPath);
+        }
+        return true;
+    }
+    try {
+        if (!(await collectFiles(providerPath))) {
+            return null;
+        }
+        files.sort((left, right) => relative(providerPath, left).localeCompare(relative(providerPath, right)));
+        const markerFileName = contentType === 'skill'
+            ? 'SKILL.md'
+            : contentType === 'agent'
+                ? 'AGENT.md'
+                : null;
+        const markerPath = markerFileName
+            ? join(providerPath, markerFileName)
+            : null;
+        const hash = createHash('sha256');
+        for (const file of files) {
+            const relativePath = relative(providerPath, file);
+            let content = await readFile(file);
+            if (file === markerPath) {
+                const markerPrefix = Buffer.from(`${expectedMarker}\n`);
+                if (content.length < markerPrefix.length ||
+                    !content.subarray(0, markerPrefix.length).equals(markerPrefix)) {
+                    return null;
+                }
+                content = content.subarray(markerPrefix.length);
+            }
+            hash.update(relativePath);
+            hash.update('\0');
+            hash.update(content);
+            hash.update('\0');
+        }
+        return hash.digest('hex');
+    }
+    catch {
+        return null;
+    }
+}
+async function classifyObsoleteMappingRetirement(manifestEntry, scopeRoot) {
+    const providerPath = resolve(scopeRoot, manifestEntry.providerPath);
+    const canonicalPath = resolve(scopeRoot, manifestEntry.canonicalPath);
+    let providerStat;
+    try {
+        providerStat = await lstat(providerPath);
+    }
+    catch (error) {
+        if (typeof error === 'object' &&
+            error !== null &&
+            'code' in error &&
+            error.code === 'ENOENT') {
+            return createRetirementEntry(manifestEntry, scopeRoot, 'detach', 'obsolete mapping provider path is missing; detach manifest ownership');
+        }
+        return createRetirementEntry(manifestEntry, scopeRoot, 'detach', 'obsolete mapping provider path is unverified; preserve and detach manifest ownership');
+    }
+    if (manifestEntry.strategy === 'symlink') {
+        if (providerStat.isSymbolicLink()) {
+            try {
+                const linkTarget = await readlink(providerPath);
+                const resolvedTarget = resolve(dirname(providerPath), linkTarget);
+                await stat(resolvedTarget);
+                if (resolvedTarget === canonicalPath) {
+                    return createRetirementEntry(manifestEntry, scopeRoot, 'remove', 'obsolete mapping has verified clean managed symlink');
+                }
+            }
+            catch {
+                // Broken or unreadable links are preserved and detached below.
+            }
+        }
+        return createRetirementEntry(manifestEntry, scopeRoot, 'detach', 'obsolete mapping provider path is changed or unverified; preserve and detach manifest ownership');
+    }
+    const expectedTypeMatches = manifestEntry.isFile
+        ? providerStat.isFile()
+        : providerStat.isDirectory();
+    if (expectedTypeMatches && manifestEntry.contentHash) {
+        try {
+            const currentHash = await computeContentHash(providerPath, manifestEntry.isFile);
+            if (currentHash === manifestEntry.contentHash) {
+                return createRetirementEntry(manifestEntry, scopeRoot, 'remove', 'obsolete mapping has verified clean managed copy');
+            }
+        }
+        catch {
+            // Hash failures are unverified and therefore non-destructive.
+        }
+        if (!manifestEntry.isFile) {
+            const managedHash = await computeManagedDirectoryCopyHash(providerPath, canonicalPath, manifestEntry.contentType);
+            if (managedHash === manifestEntry.contentHash) {
+                return createRetirementEntry(manifestEntry, scopeRoot, 'remove', 'obsolete mapping has verified clean managed copy');
+            }
+        }
+    }
+    return createRetirementEntry(manifestEntry, scopeRoot, 'detach', 'obsolete mapping provider path is changed or unverified; preserve and detach manifest ownership');
+}
 async function classifyOperation(canonicalEntry, providerPath, strategy, renderedContent) {
     if (strategy === 'symlink') {
         let stat;
@@ -180,16 +321,22 @@ export async function computeSyncPlan({ canonical, adapters, manifest, scope, co
     const scopeRoot = resolveScopeRoot(canonical, explicitScopeRoot);
     const seenCanonicalKeys = new Set();
     const activeProviderNames = new Set();
+    const activeMappingsByProvider = new Map();
     const canonicalFilter = allowedCanonicalPaths
         ? new Set(allowedCanonicalPaths.map((canonicalPath) => normalize(canonicalPath)))
         : null;
     for (const adapter of adapters) {
+        if (resolveStrategy(adapter, config)) {
+            activeProviderNames.add(adapter.name);
+        }
         for (const mapping of getSyncMappings(adapter, scope)) {
             const mappingStrategy = resolveStrategy(adapter, config, Boolean(mapping.transformCanonical));
             if (!mappingStrategy) {
                 continue;
             }
-            activeProviderNames.add(adapter.name);
+            const activeMappings = activeMappingsByProvider.get(adapter.name) ?? [];
+            activeMappings.push(mapping);
+            activeMappingsByProvider.set(adapter.name, activeMappings);
             for (const canonicalEntry of canonical) {
                 if (!entryContentTypeMatches(canonicalEntry, mapping.contentType)) {
                     continue;
@@ -244,7 +391,10 @@ export async function computeSyncPlan({ canonical, adapters, manifest, scope, co
             !canonicalFilter.has(normalize(manifestEntry.canonicalPath))) {
             continue;
         }
-        removals.push(createRemovalEntry(manifestEntry, scopeRoot));
+        const mappingStillExists = (activeMappingsByProvider.get(manifestEntry.provider) ?? []).some((mapping) => manifestEntryInsideMapping(manifestEntry, mapping));
+        removals.push(mappingStillExists
+            ? createRemovalEntry(manifestEntry, scopeRoot)
+            : await classifyObsoleteMappingRetirement(manifestEntry, scopeRoot));
     }
     return { scope, entries, removals };
 }

package/dist/engine/engine.types.d.ts

@@ -1,7 +1,7 @@
 import type { Scope } from '../shared/types.js';
 import type { CanonicalEntry } from './scanner.js';
 export type EngineScope = Exclude<Scope, 'all'>;
-export declare const SYNC_OPERATION_TYPES: readonly ["create_symlink", "create_copy", "update_symlink", "update_copy", "remove", "skip"];
+export declare const SYNC_OPERATION_TYPES: readonly ["create_symlink", "create_copy", "update_symlink", "update_copy", "remove", "detach", "skip"];
 export type SyncOperationType = (typeof SYNC_OPERATION_TYPES)[number];
 export interface SyncPlanEntry {
     canonical: CanonicalEntry;
@@ -13,7 +13,7 @@ export interface SyncPlanEntry {
     renderedContent?: string;
 }
 export type RemovalSyncPlanEntry = SyncPlanEntry & {
-    operation: 'remove';
+    operation: 'remove' | 'detach';
 };
 export interface SyncPlan {
     scope: EngineScope;

package/dist/engine/engine.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.types.d.ts","sourceRoot":"","sources":["../../src/engine/engine.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAEhD,eAAO,MAAM,oBAAoB,+FAOvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IAAE,SAAS,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE3E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"engine.types.d.ts","sourceRoot":"","sources":["../../src/engine/engine.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAEhD,eAAO,MAAM,oBAAoB,yGAQvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/engine/engine.types.js

@@ -4,5 +4,6 @@ export const SYNC_OPERATION_TYPES = [
     'update_symlink',
     'update_copy',
     'remove',
+    'detach',
     'skip',
 ];

package/dist/engine/execute-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-plan.d.ts","sourceRoot":"","sources":["../../src/engine/execute-plan.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAiB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG1E,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAW5D;AAuJD,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,CAAC,CA0BrB"}
+{"version":3,"file":"execute-plan.d.ts","sourceRoot":"","sources":["../../src/engine/execute-plan.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAiB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG1E,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAW5D;AA2JD,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,CAAC,CA0BrB"}

package/dist/engine/execute-plan.js

@@ -98,6 +98,10 @@ async function applyEntry(planEntry, manifest) {
             const { canonicalPath } = resolveManifestPaths(planEntry);
             return removeEntry(manifest, canonicalPath, planEntry.provider);
         }
+        case 'detach': {
+            const { canonicalPath } = resolveManifestPaths(planEntry);
+            return removeEntry(manifest, canonicalPath, planEntry.provider);
+        }
         case 'skip': {
             return manifest;
         }

package/dist/fs/io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/fs/io.ts"],"names":[],"mappings":"AAYA,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9D;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9C,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5E;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACrC,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf"}
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/fs/io.ts"],"names":[],"mappings":"AAaA,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9D;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9C,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5E;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACrC,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/fs/io.js

@@ -1,4 +1,4 @@
-import { mkdir, readdir, readFile, rename, rm, stat, symlink, writeFile, } from 'node:fs/promises';
+import { chmod, mkdir, readdir, readFile, rename, rm, stat, symlink, writeFile, } from 'node:fs/promises';
 import { dirname, isAbsolute, join, relative } from 'node:path';
 export async function fileExists(path) {
     try {
@@ -32,8 +32,12 @@ export async function copyDirectory(src, dest) {
             continue;
         }
         if (entry.isFile()) {
+            const sourceStat = await stat(sourcePath);
             const content = await readFile(sourcePath);
-            await writeFile(destPath, content);
+            await writeFile(destPath, content, { mode: sourceStat.mode });
+            // writeFile's mode applies only on creation; chmod covers
+            // pre-existing destination files so modes stay in sync.
+            await chmod(destPath, sourceStat.mode);
         }
     }
 }

package/dist/manifest/manifest.types.d.ts

@@ -10,37 +10,37 @@ export declare const ManifestEntrySchema: z.ZodEffects<z.ZodObject<{
     lastSynced: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     provider: string;
+    strategy: "symlink" | "copy";
     canonicalPath: string;
     providerPath: string;
     contentType: "skill" | "agent" | "rule";
-    strategy: "symlink" | "copy";
     contentHash: string | null;
     isFile: boolean;
     lastSynced: string;
 }, {
     provider: string;
+    strategy: "symlink" | "copy";
     canonicalPath: string;
     providerPath: string;
     contentType: "skill" | "agent" | "rule";
-    strategy: "symlink" | "copy";
     contentHash: string | null;
     lastSynced: string;
     isFile?: boolean | undefined;
 }>, {
     provider: string;
+    strategy: "symlink" | "copy";
     canonicalPath: string;
     providerPath: string;
     contentType: "skill" | "agent" | "rule";
-    strategy: "symlink" | "copy";
     contentHash: string | null;
     isFile: boolean;
     lastSynced: string;
 }, {
     provider: string;
+    strategy: "symlink" | "copy";
     canonicalPath: string;
     providerPath: string;
     contentType: "skill" | "agent" | "rule";
-    strategy: "symlink" | "copy";
     contentHash: string | null;
     lastSynced: string;
     isFile?: boolean | undefined;
@@ -59,37 +59,37 @@ export declare const ManifestSchema: z.ZodEffects<z.ZodObject<{
         lastSynced: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         provider: string;
+        strategy: "symlink" | "copy";
         canonicalPath: string;
         providerPath: string;
         contentType: "skill" | "agent" | "rule";
-        strategy: "symlink" | "copy";
         contentHash: string | null;
         isFile: boolean;
         lastSynced: string;
     }, {
         provider: string;
+        strategy: "symlink" | "copy";
         canonicalPath: string;
         providerPath: string;
         contentType: "skill" | "agent" | "rule";
-        strategy: "symlink" | "copy";
         contentHash: string | null;
         lastSynced: string;
         isFile?: boolean | undefined;
     }>, {
         provider: string;
+        strategy: "symlink" | "copy";
         canonicalPath: string;
         providerPath: string;
         contentType: "skill" | "agent" | "rule";
-        strategy: "symlink" | "copy";
         contentHash: string | null;
         isFile: boolean;
         lastSynced: string;
     }, {
         provider: string;
+        strategy: "symlink" | "copy";
         canonicalPath: string;
         providerPath: string;
         contentType: "skill" | "agent" | "rule";
-        strategy: "symlink" | "copy";
         contentHash: string | null;
         lastSynced: string;
         isFile?: boolean | undefined;
@@ -98,10 +98,10 @@ export declare const ManifestSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     entries: {
         provider: string;
+        strategy: "symlink" | "copy";
         canonicalPath: string;
         providerPath: string;
         contentType: "skill" | "agent" | "rule";
-        strategy: "symlink" | "copy";
         contentHash: string | null;
         isFile: boolean;
         lastSynced: string;
@@ -112,10 +112,10 @@ export declare const ManifestSchema: z.ZodEffects<z.ZodObject<{
 }, {
     entries: {
         provider: string;
+        strategy: "symlink" | "copy";
         canonicalPath: string;
         providerPath: string;
         contentType: "skill" | "agent" | "rule";
-        strategy: "symlink" | "copy";
         contentHash: string | null;
         lastSynced: string;
         isFile?: boolean | undefined;
@@ -126,10 +126,10 @@ export declare const ManifestSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     entries: {
         provider: string;
+        strategy: "symlink" | "copy";
         canonicalPath: string;
         providerPath: string;
         contentType: "skill" | "agent" | "rule";
-        strategy: "symlink" | "copy";
         contentHash: string | null;
         isFile: boolean;
         lastSynced: string;
@@ -140,10 +140,10 @@ export declare const ManifestSchema: z.ZodEffects<z.ZodObject<{
 }, {
     entries: {
         provider: string;
+        strategy: "symlink" | "copy";
         canonicalPath: string;
         providerPath: string;
         contentType: "skill" | "agent" | "rule";
-        strategy: "symlink" | "copy";
         contentHash: string | null;
         lastSynced: string;
         isFile?: boolean | undefined;

package/dist/providers/cursor/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAOnE,eAAO,MAAM,uBAAuB,EAAE,WAAW,EAsBhD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,WAAW,EAa7C,CAAC"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAOnE,eAAO,MAAM,uBAAuB,EAAE,WAAW,EAuBhD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,WAAW,EAc7C,CAAC"}

package/dist/providers/cursor/paths.js

@@ -3,8 +3,9 @@ export const CURSOR_PROJECT_MAPPINGS = [
     {
         contentType: 'skill',
         canonicalDir: '.agents/skills',
-        providerDir: '.cursor/skills',
-        nativeRead: false,
+        providerDir: '.agents/skills',
+        nativeRead: true,
+        adoptionSourceDirs: ['.cursor/skills'],
     },
     {
         contentType: 'agent',
@@ -26,8 +27,9 @@ export const CURSOR_USER_MAPPINGS = [
     {
         contentType: 'skill',
         canonicalDir: '.agents/skills',
-        providerDir: '.cursor/skills',
-        nativeRead: false,
+        providerDir: '.agents/skills',
+        nativeRead: true,
+        adoptionSourceDirs: ['.cursor/skills'],
     },
     {
         contentType: 'agent',

package/dist/providers/shared/adapter.types.d.ts

@@ -4,10 +4,16 @@ export interface PathMapping {
     canonicalDir: string;
     providerDir: string;
     nativeRead: boolean;
+    adoptionSourceDirs?: string[];
     providerExtension?: string;
     transformCanonical?: (canonicalContent: string, canonicalPath?: string) => string;
     parseToCanonical?: (providerContent: string, providerPath?: string) => string;
 }
+export interface AdoptionSource {
+    contentType: ContentType;
+    directory: string;
+    mapping: PathMapping;
+}
 export interface ProviderAdapter {
     name: string;
     displayName: string;

package/dist/providers/shared/adapter.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.types.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/adapter.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,CACnB,gBAAgB,EAAE,MAAM,EACxB,aAAa,CAAC,EAAE,MAAM,KACnB,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/E;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,YAAY,CAAC;IAC9B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC"}
+{"version":3,"file":"adapter.types.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/adapter.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,CACnB,gBAAgB,EAAE,MAAM,EACxB,aAAa,CAAC,EAAE,MAAM,KACnB,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/E;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,YAAY,CAAC;IAC9B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC"}

package/dist/providers/shared/adapter.utils.d.ts

@@ -1,6 +1,6 @@
 import type { SyncConfig } from '../../config/sync-config.js';
 import type { Scope } from '../../shared/types.js';
-import type { PathMapping, ProviderAdapter } from './adapter.types.js';
+import type { AdoptionSource, PathMapping, ProviderAdapter } from './adapter.types.js';
 export declare function getActiveAdapters(adapters: ProviderAdapter[], scopeRoot: string): Promise<ProviderAdapter[]>;
 export interface ConfigAwareAdaptersResult {
     activeAdapters: ProviderAdapter[];
@@ -9,4 +9,5 @@ export interface ConfigAwareAdaptersResult {
 }
 export declare function getConfigAwareAdapters(adapters: ProviderAdapter[], scopeRoot: string, config: SyncConfig): Promise<ConfigAwareAdaptersResult>;
 export declare function getSyncMappings(adapter: ProviderAdapter, scope: Scope): PathMapping[];
+export declare function getAdoptionSources(adapter: ProviderAdapter, scope: Scope): AdoptionSource[];
 //# sourceMappingURL=adapter.utils.d.ts.map

package/dist/providers/shared/adapter.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.utils.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/adapter.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAW5B;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,yBAAyB,CAAC,CAqCpC;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,KAAK,GACX,WAAW,EAAE,CAmBf"}
+{"version":3,"file":"adapter.utils.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/adapter.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAazB,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAW5B;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,yBAAyB,CAAC,CAqCpC;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,KAAK,GACX,WAAW,EAAE,CAcf;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,KAAK,GACX,cAAc,EAAE,CAsBlB"}

package/dist/providers/shared/adapter.utils.js

@@ -1,3 +1,10 @@
+function getScopeMappings(adapter, scope) {
+    return scope === 'project'
+        ? adapter.projectMappings
+        : scope === 'user'
+            ? adapter.userMappings
+            : [...adapter.projectMappings, ...adapter.userMappings];
+}
 export async function getActiveAdapters(adapters, scopeRoot) {
     const detected = await Promise.all(adapters.map(async (adapter) => ({
         adapter,
@@ -39,12 +46,7 @@ export async function getConfigAwareAdapters(adapters, scopeRoot, config) {
     };
 }
 export function getSyncMappings(adapter, scope) {
-    const scopeMappings = scope === 'project'
-        ? adapter.projectMappings
-        : scope === 'user'
-            ? adapter.userMappings
-            : [...adapter.projectMappings, ...adapter.userMappings];
-    const syncMappings = scopeMappings.filter((mapping) => !mapping.nativeRead);
+    const syncMappings = getScopeMappings(adapter, scope).filter((mapping) => !mapping.nativeRead);
     const seen = new Set();
     return syncMappings.filter((mapping) => {
         const key = `${mapping.contentType}::${mapping.canonicalDir}::${mapping.providerDir}`;
@@ -55,3 +57,24 @@ export function getSyncMappings(adapter, scope) {
         return true;
     });
 }
+export function getAdoptionSources(adapter, scope) {
+    const sources = getScopeMappings(adapter, scope).flatMap((mapping) => {
+        const directories = mapping.nativeRead
+            ? (mapping.adoptionSourceDirs ?? [])
+            : [mapping.providerDir];
+        return directories.map((directory) => ({
+            contentType: mapping.contentType,
+            directory,
+            mapping,
+        }));
+    });
+    const seen = new Set();
+    return sources.filter((source) => {
+        const key = `${source.contentType}::${source.directory}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.1.74",
+  "version": "0.2.0",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.1.74"
+    "@open-agent-toolkit/control-plane": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",