@skillctl/core 0.2.0 → 0.3.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 skillctl contributors
+Copyright (c) 2026 xFurti, Gabry848
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.d.ts

@@ -6,4 +6,7 @@ export * from './cache.js';
 export * from './names.js';
 export * from './paths.js';
 export * from './operations.js';
+export * from './specifiers.js';
+export * from './normalize-specifier.js';
+export * from './portable-lock.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -6,4 +6,7 @@ export * from './cache.js';
 export * from './names.js';
 export * from './paths.js';
 export * from './operations.js';
+export * from './specifiers.js';
+export * from './normalize-specifier.js';
+export * from './portable-lock.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

package/dist/normalize-specifier.d.ts

@@ -0,0 +1,17 @@
+import type { ResolvedSource } from './types.js';
+export interface NormalizeLocalSpecifierResult {
+    /** Portable specifier for manifest/lock */
+    portable: string;
+    /** Absolute path on disk for fetch/materialize */
+    absPath: string;
+    /** Skill name derived from the path */
+    name: string;
+    /** True when the path lies outside the project cwd */
+    outsideProject: boolean;
+}
+export declare function parseLocalSpecifierPath(spec: string): string;
+/** Normalize a local/file specifier to a portable form for manifest + lock. */
+export declare function normalizeLocalSpecifier(spec: string, cwd: string): NormalizeLocalSpecifierResult;
+/** Manifest/lock specifier after resolution (never stores machine-local absolute paths). */
+export declare function portableSpecifierForResolved(spec: string, resolved: Pick<ResolvedSource, 'sourceType' | 'resolved'>, cwd: string): string;
+//# sourceMappingURL=normalize-specifier.d.ts.map

package/dist/normalize-specifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-specifier.d.ts","sourceRoot":"","sources":["../src/normalize-specifier.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,6BAA6B;IAC5C,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,6BAA6B,CA4BhG;AAED,4FAA4F;AAC5F,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,UAAU,CAAC,EACzD,GAAG,EAAE,MAAM,GACV,MAAM,CASR"}

package/dist/normalize-specifier.js

@@ -0,0 +1,52 @@
+import { basename, isAbsolute, relative, resolve } from 'node:path';
+import { canonicalizeName } from './names.js';
+import { importedSpecifier, parseImportedSpecifier } from './specifiers.js';
+export function parseLocalSpecifierPath(spec) {
+    let localPath = spec;
+    if (spec.startsWith('file:'))
+        localPath = spec.slice(5);
+    else if (spec.startsWith('local:'))
+        localPath = spec.slice(6);
+    return localPath;
+}
+/** Normalize a local/file specifier to a portable form for manifest + lock. */
+export function normalizeLocalSpecifier(spec, cwd) {
+    const importedName = parseImportedSpecifier(spec);
+    if (importedName) {
+        return {
+            portable: importedSpecifier(importedName),
+            absPath: '',
+            name: importedName,
+            outsideProject: false,
+        };
+    }
+    const localPath = parseLocalSpecifierPath(spec);
+    const absPath = resolve(cwd, localPath);
+    const name = canonicalizeName(basename(absPath));
+    const rel = relative(cwd, absPath);
+    if (rel && !rel.startsWith('..') && !isAbsolute(rel)) {
+        const normalized = rel.replace(/\\/g, '/');
+        const portable = normalized.startsWith('.') ? `file:${normalized}` : `file:./${normalized}`;
+        return { portable, absPath, name, outsideProject: false };
+    }
+    return {
+        portable: importedSpecifier(name),
+        absPath,
+        name,
+        outsideProject: true,
+    };
+}
+/** Manifest/lock specifier after resolution (never stores machine-local absolute paths). */
+export function portableSpecifierForResolved(spec, resolved, cwd) {
+    if (resolved.sourceType === 'local') {
+        return normalizeLocalSpecifier(spec, cwd).portable;
+    }
+    if (!/^(github:|npm:|skills\.sh\/|file:|local:imported\/)/.test(spec)) {
+        if (resolved.sourceType === 'github')
+            return `github:${spec}`;
+        if (resolved.sourceType === 'npm')
+            return `npm:${spec}`;
+    }
+    return spec;
+}
+//# sourceMappingURL=normalize-specifier.js.map

package/dist/normalize-specifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-specifier.js","sourceRoot":"","sources":["../src/normalize-specifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAc5E,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACnD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,GAAW;IAC/D,MAAM,YAAY,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,QAAQ,EAAE,iBAAiB,CAAC,YAAY,CAAC;YACzC,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,YAAY;YAClB,cAAc,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAEnC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,UAAU,EAAE,CAAC;QAC5F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC;QACjC,OAAO;QACP,IAAI;QACJ,cAAc,EAAE,IAAI;KACrB,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,4BAA4B,CAC1C,IAAY,EACZ,QAAyD,EACzD,GAAW;IAEX,IAAI,QAAQ,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;QACpC,OAAO,uBAAuB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtE,IAAI,QAAQ,CAAC,UAAU,KAAK,QAAQ;YAAE,OAAO,UAAU,IAAI,EAAE,CAAC;QAC9D,IAAI,QAAQ,CAAC,UAAU,KAAK,KAAK;YAAE,OAAO,OAAO,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/operations.d.ts

@@ -4,11 +4,21 @@ export interface InstallResult {
     skipped: number;
     lock: SkillLockfile;
 }
-export declare function needsInstall(entry: LockfileEntry): Promise<boolean>;
-export declare function verifyLockIntegrity(lock: SkillLockfile): Promise<string[]>;
-export declare function lockToSkillTargets(lock: SkillLockfile): Array<{
+/** Resolve a lock entry canonicalPath to a real filesystem path (tilde, legacy absolute, or store fallback). */
+export declare function resolveEntryCanonicalPath(entry: LockfileEntry, options?: {
+    store?: string;
+}): Promise<string>;
+export declare function needsInstall(entry: LockfileEntry, options?: {
+    store?: string;
+}): Promise<boolean>;
+export declare function verifyLockIntegrity(lock: SkillLockfile, options?: {
+    store?: string;
+}): Promise<string[]>;
+export declare function lockToSkillTargets(lock: SkillLockfile, options?: {
+    store?: string;
+}): Promise<Array<{
     name: string;
     canonicalPath: string;
-}>;
+}>>;
 export declare function purgeCanonical(name: string): Promise<void>;
 //# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI/D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAYzE;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAchF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAEtG;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE"}
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM/D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;CACrB;AAOD,gHAAgH;AAChH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAavG;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAUzD;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE"}

package/dist/operations.js

@@ -1,30 +1,57 @@
 import { stat } from 'node:fs/promises';
 import { join } from 'node:path';
-import { homedir } from 'node:os';
 import { rm } from 'node:fs/promises';
+import { loadConfig } from './config.js';
 import { computeDirIntegrity } from './fs.js';
 import { canonicalizeName } from './names.js';
-export async function needsInstall(entry) {
+import { resolveCanonicalPath } from './paths.js';
+async function resolveStoreRoot(store) {
+    if (store)
+        return store;
+    return (await loadConfig()).store;
+}
+/** Resolve a lock entry canonicalPath to a real filesystem path (tilde, legacy absolute, or store fallback). */
+export async function resolveEntryCanonicalPath(entry, options) {
+    const store = await resolveStoreRoot(options?.store);
+    const primary = resolveCanonicalPath(entry.canonicalPath, store);
     try {
-        await stat(entry.canonicalPath);
+        await stat(primary);
+        return primary;
+    }
+    catch {
+        const fallback = join(store, canonicalizeName(entry.name));
+        try {
+            await stat(fallback);
+            return fallback;
+        }
+        catch {
+            return primary;
+        }
+    }
+}
+export async function needsInstall(entry, options) {
+    const path = await resolveEntryCanonicalPath(entry, options);
+    try {
+        await stat(path);
     }
     catch {
         return true;
     }
     try {
-        const integrity = await computeDirIntegrity(entry.canonicalPath);
+        const integrity = await computeDirIntegrity(path);
         return integrity !== entry.integrity;
     }
     catch {
         return true;
     }
 }
-export async function verifyLockIntegrity(lock) {
+export async function verifyLockIntegrity(lock, options) {
     const errors = [];
     for (const [name, entry] of Object.entries(lock.skills)) {
+        const path = await resolveEntryCanonicalPath(entry, options);
         try {
-            await stat(entry.canonicalPath);
-            const integrity = await computeDirIntegrity(entry.canonicalPath);
+            await stat(path);
+            const integrity = await computeDirIntegrity(path);
             if (integrity !== entry.integrity) {
                 errors.push(`${name}: integrity mismatch (expected ${entry.integrity.slice(0, 20)}...)`);
             }
@@ -35,12 +62,20 @@ export async function verifyLockIntegrity(lock) {
     }
     return errors;
 }
-export function lockToSkillTargets(lock) {
-    return Object.values(lock.skills).map((e) => ({ name: e.name, canonicalPath: e.canonicalPath }));
+export async function lockToSkillTargets(lock, options) {
+    const store = await resolveStoreRoot(options?.store);
+    const targets = [];
+    for (const entry of Object.values(lock.skills)) {
+        targets.push({
+            name: entry.name,
+            canonicalPath: await resolveEntryCanonicalPath(entry, { store }),
+        });
+    }
+    return targets;
 }
 export async function purgeCanonical(name) {
-    const canonicalName = canonicalizeName(name);
-    const p = join(homedir(), '.skillctl', 'skills', canonicalName);
+    const config = await loadConfig();
+    const p = join(config.store, canonicalizeName(name));
     await rm(p, { recursive: true, force: true }).catch(() => { });
 }
 //# sourceMappingURL=operations.js.map

package/dist/operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAQ9C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAoB;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjE,OAAO,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAmB;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAChC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACjE,IAAI,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,kCAAkC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,6BAA6B,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAChE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"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"}

package/dist/paths.d.ts

@@ -1,3 +1,9 @@
 /** Resolve adapter target base + skill name (project-relative or absolute global). */
 export declare function resolveAdapterTarget(basePath: string, skillName: string, cwd?: string): string;
+/** Expand a leading tilde to the user home directory. */
+export declare function expandTilde(path: string): string;
+/** Portable canonical store path for committable lockfiles. */
+export declare function formatCanonicalPathForLock(skillName: string): string;
+/** Resolve lock canonicalPath (tilde, legacy absolute, or store-relative) to a filesystem path. */
+export declare function resolveCanonicalPath(canonicalPath: string, store?: string): string;
 //# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,MAAM,CAGrG"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAIA,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,MAAM,CAGrG;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAID,+DAA+D;AAC/D,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAclF"}

package/dist/paths.js

@@ -1,7 +1,36 @@
-import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { isAbsolute, join, normalize as pathNormalize } from 'node:path';
+import { canonicalizeName } from './names.js';
 /** Resolve adapter target base + skill name (project-relative or absolute global). */
 export function resolveAdapterTarget(basePath, skillName, cwd = process.cwd()) {
     const resolvedBase = basePath.startsWith('.') ? join(cwd, basePath) : basePath;
     return join(resolvedBase, skillName);
 }
+/** Expand a leading tilde to the user home directory. */
+export function expandTilde(path) {
+    if (path === '~')
+        return homedir();
+    if (path.startsWith('~/') || path.startsWith('~\\')) {
+        return join(homedir(), path.slice(2));
+    }
+    return path;
+}
+const PORTABLE_STORE_PREFIX = '~/.skillctl/skills/';
+/** Portable canonical store path for committable lockfiles. */
+export function formatCanonicalPathForLock(skillName) {
+    return `${PORTABLE_STORE_PREFIX}${canonicalizeName(skillName)}`;
+}
+/** Resolve lock canonicalPath (tilde, legacy absolute, or store-relative) to a filesystem path. */
+export function resolveCanonicalPath(canonicalPath, store) {
+    const storeRoot = store ?? join(homedir(), '.skillctl', 'skills');
+    if (canonicalPath.startsWith(PORTABLE_STORE_PREFIX)) {
+        const name = canonicalPath.slice(PORTABLE_STORE_PREFIX.length);
+        return join(storeRoot, name);
+    }
+    const expanded = expandTilde(canonicalPath);
+    if (isAbsolute(expanded)) {
+        return pathNormalize(expanded);
+    }
+    return join(storeRoot, canonicalPath);
+}
 //# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,SAAiB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC3F,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/E,OAAO,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,SAAiB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC3F,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/E,OAAO,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AAEpD,+DAA+D;AAC/D,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,OAAO,GAAG,qBAAqB,GAAG,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,oBAAoB,CAAC,aAAqB,EAAE,KAAc;IACxE,MAAM,SAAS,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAElE,IAAI,aAAa,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACxC,CAAC"}

package/dist/portable-lock.d.ts

@@ -0,0 +1,6 @@
+import type { SkillLockfile, SkillManifest } from './types.js';
+export declare function isPortableCanonicalPath(path: string): boolean;
+export declare function isPortableSpecifier(spec: string): boolean;
+/** Detect machine-local paths in manifest/lock that should be rewritten for git portability. */
+export declare function findPortablePathWarnings(lock: SkillLockfile, manifest?: SkillManifest | null): string[];
+//# sourceMappingURL=portable-lock.d.ts.map

package/dist/portable-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-lock.d.ts","sourceRoot":"","sources":["../src/portable-lock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI9E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAcD,gGAAgG;AAChG,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,aAAa,EACnB,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,GAC9B,MAAM,EAAE,CAiBV"}

package/dist/portable-lock.js

@@ -0,0 +1,41 @@
+const PORTABLE_CANONICAL_PREFIX = '~/.skillctl/skills/';
+export function isPortableCanonicalPath(path) {
+    return path.startsWith(PORTABLE_CANONICAL_PREFIX);
+}
+export function isPortableSpecifier(spec) {
+    if (/^(github:|skills\.sh\/|npm:)/.test(spec))
+        return true;
+    if (spec.startsWith('local:imported/'))
+        return true;
+    if (spec.startsWith('file:./') || spec.startsWith('file:../'))
+        return true;
+    return false;
+}
+function checkEntry(name, field, value, warnings) {
+    if (field === 'canonicalPath') {
+        if (!isPortableCanonicalPath(value)) {
+            warnings.push(`${name}: lock ${field} is not portable (${value}) — run skillctl install to rewrite`);
+        }
+        return;
+    }
+    if (!isPortableSpecifier(value)) {
+        warnings.push(`${name}: lock ${field} is not portable (${value}) — run skillctl install to rewrite`);
+    }
+}
+/** Detect machine-local paths in manifest/lock that should be rewritten for git portability. */
+export function findPortablePathWarnings(lock, manifest) {
+    const warnings = [];
+    for (const [name, entry] of Object.entries(lock.skills)) {
+        checkEntry(name, 'specifier', entry.specifier, warnings);
+        checkEntry(name, 'resolved', entry.resolved, warnings);
+        checkEntry(name, 'canonicalPath', entry.canonicalPath, warnings);
+    }
+    const deps = manifest?.agentSkills?.dependencies || {};
+    for (const [name, spec] of Object.entries(deps)) {
+        if (!isPortableSpecifier(spec)) {
+            warnings.push(`${name}: manifest specifier is not portable (${spec}) — run skillctl add/install to rewrite`);
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=portable-lock.js.map

package/dist/portable-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-lock.js","sourceRoot":"","sources":["../src/portable-lock.ts"],"names":[],"mappings":"AAEA,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAExD,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,KAAa,EAAE,KAAa,EAAE,QAAkB;IAChF,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;QAC9B,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,UAAU,KAAK,qBAAqB,KAAK,qCAAqC,CAAC,CAAC;QACvG,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,UAAU,KAAK,qBAAqB,KAAK,qCAAqC,CAAC,CAAC;IACvG,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,wBAAwB,CACtC,IAAmB,EACnB,QAA+B;IAE/B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACzD,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvD,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,EAAE,WAAW,EAAE,YAAY,IAAI,EAAE,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,yCAAyC,IAAI,yCAAyC,CAAC,CAAC;QAC/G,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/specifiers.d.ts

@@ -0,0 +1,5 @@
+/** Manifest specifier for skills migrated into the canonical store. */
+export declare function importedSpecifier(name: string): string;
+export declare function isImportedSpecifier(spec: string): boolean;
+export declare function parseImportedSpecifier(spec: string): string | null;
+//# sourceMappingURL=specifiers.d.ts.map

package/dist/specifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specifiers.d.ts","sourceRoot":"","sources":["../src/specifiers.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIlE"}

package/dist/specifiers.js

@@ -0,0 +1,16 @@
+import { canonicalizeName } from './names.js';
+/** Manifest specifier for skills migrated into the canonical store. */
+export function importedSpecifier(name) {
+    return `local:imported/${canonicalizeName(name)}`;
+}
+const IMPORTED_PREFIX = 'local:imported/';
+export function isImportedSpecifier(spec) {
+    return spec.startsWith(IMPORTED_PREFIX);
+}
+export function parseImportedSpecifier(spec) {
+    if (!isImportedSpecifier(spec))
+        return null;
+    const name = spec.slice(IMPORTED_PREFIX.length);
+    return name ? canonicalizeName(name) : null;
+}
+//# sourceMappingURL=specifiers.js.map

package/dist/specifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specifiers.js","sourceRoot":"","sources":["../src/specifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,kBAAkB,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC"}

package/dist/test/normalize-specifier.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=normalize-specifier.test.d.ts.map

package/dist/test/normalize-specifier.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-specifier.test.d.ts","sourceRoot":"","sources":["../../src/test/normalize-specifier.test.ts"],"names":[],"mappings":""}

package/dist/test/normalize-specifier.test.js

@@ -0,0 +1,64 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { normalizeLocalSpecifier, portableSpecifierForResolved, formatCanonicalPathForLock, expandTilde, } from '../index.js';
+test('normalizeLocalSpecifier keeps file:./ in project', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'norm-spec-'));
+    try {
+        const skillDir = join(root, 'some-skill');
+        await mkdir(skillDir, { recursive: true });
+        await writeFile(join(skillDir, 'SKILL.md'), '---\nname: some-skill\n---\n');
+        const rel = normalizeLocalSpecifier('file:./some-skill', root);
+        assert.equal(rel.portable, 'file:./some-skill');
+        assert.equal(rel.outsideProject, false);
+        assert.ok(rel.absPath.endsWith('some-skill'));
+    }
+    finally {
+        await rm(root, { recursive: true, force: true });
+    }
+});
+test('normalizeLocalSpecifier rewrites abs-in-project to file:./', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'norm-spec-'));
+    try {
+        const skillDir = join(root, 'some-skill');
+        await mkdir(skillDir, { recursive: true });
+        await writeFile(join(skillDir, 'SKILL.md'), '---\nname: some-skill\n---\n');
+        const absInProject = normalizeLocalSpecifier(`file:${skillDir}`, root);
+        assert.equal(absInProject.portable, 'file:./some-skill');
+        assert.equal(absInProject.outsideProject, false);
+    }
+    finally {
+        await rm(root, { recursive: true, force: true });
+    }
+});
+test('normalizeLocalSpecifier maps outside-project to local:imported', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'norm-spec-'));
+    const outsideParent = await mkdtemp(join(tmpdir(), 'outside-parent-'));
+    const outside = join(outsideParent, 'outside');
+    try {
+        await mkdir(outside, { recursive: true });
+        await writeFile(join(outside, 'SKILL.md'), '---\nname: outside\n---\n');
+        const out = normalizeLocalSpecifier(`file:${outside}`, root);
+        assert.equal(out.portable, 'local:imported/outside');
+        assert.equal(out.outsideProject, true);
+    }
+    finally {
+        await rm(root, { recursive: true, force: true });
+        await rm(outsideParent, { recursive: true, force: true });
+    }
+});
+test('normalizeLocalSpecifier preserves local:imported', () => {
+    const imported = normalizeLocalSpecifier('local:imported/my-skill', '/tmp');
+    assert.equal(imported.portable, 'local:imported/my-skill');
+});
+test('portableSpecifierForResolved adds github: prefix', () => {
+    const remote = portableSpecifierForResolved('acme/demo', { sourceType: 'github', resolved: 'github:acme/demo@HEAD' }, '/tmp');
+    assert.equal(remote, 'github:acme/demo');
+});
+test('formatCanonicalPathForLock and expandTilde', () => {
+    assert.equal(formatCanonicalPathForLock('My Skill'), '~/.skillctl/skills/my-skill');
+    assert.ok(expandTilde('~/.skillctl/skills/foo').includes('.skillctl'));
+});
+//# sourceMappingURL=normalize-specifier.test.js.map

package/dist/test/normalize-specifier.test.js.map

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

package/dist/test/operations.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operations.test.d.ts.map

package/dist/test/operations.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.test.d.ts","sourceRoot":"","sources":["../../src/test/operations.test.ts"],"names":[],"mappings":""}

package/dist/test/operations.test.js

@@ -0,0 +1,72 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { tmpdir } from 'node:os';
+import { resolveCanonicalPath, formatCanonicalPathForLock, needsInstall, lockToSkillTargets, resolveEntryCanonicalPath, computeDirIntegrity, } from '../index.js';
+function makeEntry(overrides) {
+    return {
+        specifier: 'file:./skill',
+        resolved: 'file:./skill',
+        integrity: 'sha256:placeholder',
+        canonicalPath: formatCanonicalPathForLock(overrides.name),
+        fetchedAt: new Date().toISOString(),
+        provenance: { type: 'local' },
+        ...overrides,
+    };
+}
+test('resolveCanonicalPath expands portable tilde store paths', () => {
+    const customStore = join(homedir(), 'custom-skill-store');
+    const portable = formatCanonicalPathForLock('demo-skill');
+    const resolved = resolveCanonicalPath(portable, customStore);
+    assert.equal(resolved, join(customStore, 'demo-skill'));
+});
+test('resolveCanonicalPath keeps legacy absolute paths', () => {
+    const legacy = join(homedir(), '.skillctl', 'skills', 'legacy-skill');
+    assert.equal(resolveCanonicalPath(legacy), legacy);
+});
+test('resolveEntryCanonicalPath falls back to store/name for legacy absolute lock paths', async () => {
+    const store = await mkdtemp(join(tmpdir(), 'skillctl-store-'));
+    const skillName = 'legacy-fallback';
+    const skillDir = join(store, skillName);
+    try {
+        await mkdir(skillDir, { recursive: true });
+        await writeFile(join(skillDir, 'SKILL.md'), '---\nname: legacy-fallback\n---\n');
+        const otherMachinePath = join(homedir(), 'other-machine', '.skillctl', 'skills', skillName);
+        const entry = makeEntry({
+            name: skillName,
+            canonicalPath: otherMachinePath,
+            integrity: await computeDirIntegrity(skillDir),
+        });
+        const resolved = await resolveEntryCanonicalPath(entry, { store });
+        assert.equal(resolved, skillDir);
+        assert.equal(await needsInstall(entry, { store }), false);
+    }
+    finally {
+        await rm(store, { recursive: true, force: true });
+    }
+});
+test('lockToSkillTargets returns filesystem paths from portable lock entries', async () => {
+    const store = await mkdtemp(join(tmpdir(), 'skillctl-store-'));
+    const skillName = 'sync-target';
+    const skillDir = join(store, skillName);
+    try {
+        await mkdir(skillDir, { recursive: true });
+        await writeFile(join(skillDir, 'SKILL.md'), '---\nname: sync-target\n---\n');
+        const integrity = await computeDirIntegrity(skillDir);
+        const lock = {
+            lockfileVersion: '1.0',
+            skills: {
+                [skillName]: makeEntry({ name: skillName, integrity }),
+            },
+        };
+        const targets = await lockToSkillTargets(lock, { store });
+        assert.equal(targets.length, 1);
+        assert.equal(targets[0].canonicalPath, skillDir);
+    }
+    finally {
+        await rm(store, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=operations.test.js.map

package/dist/test/operations.test.js.map

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

package/dist/test/portable-lock.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=portable-lock.test.d.ts.map

package/dist/test/portable-lock.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-lock.test.d.ts","sourceRoot":"","sources":["../../src/test/portable-lock.test.ts"],"names":[],"mappings":""}

package/dist/test/portable-lock.test.js

@@ -0,0 +1,32 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { isPortableSpecifier, isPortableCanonicalPath, findPortablePathWarnings, formatCanonicalPathForLock, } from '../index.js';
+test('isPortableSpecifier accepts remote and project-relative forms', () => {
+    assert.equal(isPortableSpecifier('github:foo/bar'), true);
+    assert.equal(isPortableSpecifier('file:./skills/foo'), true);
+    assert.equal(isPortableSpecifier('local:imported/my-skill'), true);
+    assert.equal(isPortableSpecifier('file:/Users/me/skill'), false);
+    assert.equal(isPortableSpecifier('local:/Users/me/skill'), false);
+});
+test('isPortableCanonicalPath accepts tilde store paths only', () => {
+    assert.equal(isPortableCanonicalPath(formatCanonicalPathForLock('demo')), true);
+    assert.equal(isPortableCanonicalPath('/Users/me/.skillctl/skills/demo'), false);
+});
+test('findPortablePathWarnings flags legacy lock entries', () => {
+    const warnings = findPortablePathWarnings({
+        lockfileVersion: '1.0',
+        skills: {
+            demo: {
+                specifier: 'file:/Users/me/project/skill',
+                resolved: 'local:/Users/me/project/skill',
+                integrity: 'sha256:abc',
+                name: 'demo',
+                canonicalPath: '/Users/me/.skillctl/skills/demo',
+                fetchedAt: '2026-01-01T00:00:00.000Z',
+                provenance: { type: 'local' },
+            },
+        },
+    });
+    assert.equal(warnings.length, 3);
+});
+//# sourceMappingURL=portable-lock.test.js.map

package/dist/test/portable-lock.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-lock.test.js","sourceRoot":"","sources":["../../src/test/portable-lock.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,IAAI,CAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7D,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,EAAE,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,EAAE,KAAK,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wDAAwD,EAAE,GAAG,EAAE;IAClE,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAChF,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,iCAAiC,CAAC,EAAE,KAAK,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,QAAQ,GAAG,wBAAwB,CAAC;QACxC,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,SAAS,EAAE,8BAA8B;gBACzC,QAAQ,EAAE,+BAA+B;gBACzC,SAAS,EAAE,YAAY;gBACvB,IAAI,EAAE,MAAM;gBACZ,aAAa,EAAE,iCAAiC;gBAChD,SAAS,EAAE,0BAA0B;gBACrC,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;aAC9B;SACF;KACF,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -21,9 +21,11 @@ export interface Provenance {
     commit?: string;
     tarballHash?: string;
     subpath?: string;
-    migratedFrom?: 'npx' | 'python-skillctl';
+    migratedFrom?: 'npx' | 'python-skillctl' | 'project-scan';
     originalHash?: string;
     originalSource?: string;
+    originalPath?: string;
+    adapter?: string;
     signature?: string;
 }
 export interface AgentAdapter {
@@ -32,7 +34,9 @@ export interface AgentAdapter {
     readonly projectPaths: string[];
     readonly globalPaths: string[];
     detect(): Promise<boolean>;
-    ensureTarget(skillName: string, targetPath: string, canonical: string, mode: 'symlink' | 'copy' | 'junction'): Promise<void>;
+    ensureTarget(skillName: string, targetPath: string, canonical: string, mode?: 'symlink' | 'copy' | 'junction', options?: {
+        relative?: boolean;
+    }): Promise<void>;
     removeTarget(skillName: string, targetPath: string): Promise<void>;
 }
 export interface RegistrySource {
@@ -40,6 +44,7 @@ export interface RegistrySource {
     match(spec: string): boolean;
     resolve(spec: string, options?: {
         ref?: string;
+        cwd?: string;
     }): Promise<ResolvedSource>;
     fetch(resolved: ResolvedSource, dest: string): Promise<{
         integrity: string;

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;AA+GH,4EAA4E;AAC5E,mFAAmF;AACnF,wEAAwE"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;AAuHH,4EAA4E;AAC5E,mFAAmF;AACnF,wEAAwE"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@skillctl/core",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Core types, config, and FS utilities for skillctl",
   "license": "MIT",
-  "author": "skillctl contributors",
+  "author": "xFurti & Gabry848",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -34,6 +34,6 @@
     "dev": "tsc -b --watch",
     "clean": "rimraf dist",
     "lint": "tsc --noEmit",
-    "test": "echo \"no tests yet for core\" && exit 0"
+    "test": "node --test ./dist/test/*.test.js"
   }
 }