reskill 0.13.1 → 0.15.0

package/dist/cli/index.js

@@ -4,10 +4,10 @@ import * as __WEBPACK_EXTERNAL_MODULE_node_path__ from "node:path";
 import * as __WEBPACK_EXTERNAL_MODULE_node_url__ from "node:url";
 import * as __WEBPACK_EXTERNAL_MODULE_commander__ from "commander";
 import * as __WEBPACK_EXTERNAL_MODULE_chalk__ from "chalk";
+import * as __WEBPACK_EXTERNAL_MODULE_semver__ from "semver";
 import * as __WEBPACK_EXTERNAL_MODULE_node_os__ from "node:os";
 import * as __WEBPACK_EXTERNAL_MODULE_node_child_process__ from "node:child_process";
 import * as __WEBPACK_EXTERNAL_MODULE_node_util__ from "node:util";
-import * as __WEBPACK_EXTERNAL_MODULE_semver__ from "semver";
 import * as __WEBPACK_EXTERNAL_MODULE__clack_prompts__ from "@clack/prompts";
 import * as __WEBPACK_EXTERNAL_MODULE_ora__ from "ora";
 var __webpack_modules__ = {
@@ -26,6 +26,81 @@ function __webpack_require__(moduleId) {
     return module.exports;
 }
 var external_node_fs_ = __webpack_require__("node:fs");
+const logger_logger = {
+    info (message) {
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].blue('ℹ'), message);
+    },
+    success (message) {
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].green('✅'), message);
+    },
+    warn (message) {
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].yellow('⚠️'), message);
+    },
+    error (message) {
+        console.error(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].red('❌'), message);
+    },
+    debug (message) {
+        if (process.env.DEBUG || process.env.VERBOSE) console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].gray('🔍'), __WEBPACK_EXTERNAL_MODULE_chalk__["default"].gray(message));
+    },
+    package (message) {
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('📦'), message);
+    },
+    log (message) {
+        console.log(message);
+    },
+    newline () {
+        console.log();
+    },
+    table (headers, rows) {
+        const widths = headers.map((h, i)=>{
+            const colValues = [
+                h,
+                ...rows.map((r)=>r[i] || '')
+            ];
+            return Math.max(...colValues.map((v)=>v.length));
+        });
+        const headerRow = headers.map((h, i)=>h.padEnd(widths[i])).join('  ');
+        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].bold(headerRow));
+        for (const row of rows){
+            const rowStr = row.map((cell, i)=>(cell || '').padEnd(widths[i])).join('  ');
+            console.log(rowStr);
+        }
+    }
+};
+async function checkForUpdate(packageName, currentVersion, options = {}) {
+    const timeout = options.timeout ?? 3000;
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(()=>controller.abort(), timeout);
+        const response = await fetch(`https://registry.npmjs.org/${packageName}`, {
+            signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) return null;
+        const data = await response.json();
+        const latest = data['dist-tags']?.latest;
+        if (!latest) return null;
+        const hasUpdate = __WEBPACK_EXTERNAL_MODULE_semver__["default"].gt(latest, currentVersion);
+        return {
+            current: currentVersion,
+            latest,
+            hasUpdate
+        };
+    } catch  {
+        return null;
+    }
+}
+function formatUpdateMessage(result) {
+    if (!result.hasUpdate) return '';
+    return `
+┌────────────────────────────────────────────────────┐
+│                                                    │
+│   Update available: ${result.current} → ${result.latest.padEnd(10)}          │
+│   Run: npm install -g reskill@latest               │
+│                                                    │
+└────────────────────────────────────────────────────┘
+`;
+}
 function exists(filePath) {
     return external_node_fs_.existsSync(filePath);
 }
@@ -112,47 +187,6 @@ function shortenPath(fullPath, cwd) {
     if (fullPath.startsWith(currentDir)) return `.${fullPath.slice(currentDir.length)}`;
     return fullPath;
 }
-const logger = {
-    info (message) {
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].blue('ℹ'), message);
-    },
-    success (message) {
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].green('✅'), message);
-    },
-    warn (message) {
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].yellow('⚠️'), message);
-    },
-    error (message) {
-        console.error(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].red('❌'), message);
-    },
-    debug (message) {
-        if (process.env.DEBUG || process.env.VERBOSE) console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].gray('🔍'), __WEBPACK_EXTERNAL_MODULE_chalk__["default"].gray(message));
-    },
-    package (message) {
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('📦'), message);
-    },
-    log (message) {
-        console.log(message);
-    },
-    newline () {
-        console.log();
-    },
-    table (headers, rows) {
-        const widths = headers.map((h, i)=>{
-            const colValues = [
-                h,
-                ...rows.map((r)=>r[i] || '')
-            ];
-            return Math.max(...colValues.map((v)=>v.length));
-        });
-        const headerRow = headers.map((h, i)=>h.padEnd(widths[i])).join('  ');
-        console.log(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].bold(headerRow));
-        for (const row of rows){
-            const rowStr = row.map((cell, i)=>(cell || '').padEnd(widths[i])).join('  ');
-            console.log(rowStr);
-        }
-    }
-};
 const agent_registry_home = (0, __WEBPACK_EXTERNAL_MODULE_node_os__.homedir)();
 const agents = {
     amp: {
@@ -736,6 +770,22 @@ class GitResolver {
         let gitUrl = ref;
         let version;
         let subPath;
+        const webUrlMatch = ref.match(/^(https?:\/\/[^/]+)\/([^/]+)\/([^/]+)\/(tree|blob|raw)\/([^/]+)(?:\/(.+))?$/);
+        if (webUrlMatch) {
+            const [, baseUrl, owner, repo, , branch, path] = webUrlMatch;
+            gitUrl = `${baseUrl}/${owner}/${repo}.git`;
+            version = `branch:${branch}`;
+            subPath = path;
+            return {
+                registry: new URL(baseUrl).hostname,
+                owner,
+                repo,
+                subPath,
+                version,
+                raw,
+                gitUrl
+            };
+        }
         const gitSuffixIndex = ref.indexOf('.git');
         if (-1 !== gitSuffixIndex) {
             const afterGit = ref.slice(gitSuffixIndex + 4);
@@ -1125,6 +1175,7 @@ class LockManager {
         const lockedSkill = {
             source: options.source,
             version: options.version,
+            ref: options.ref,
             resolved: options.resolved,
             commit: options.commit,
             installedAt: new Date().toISOString()
@@ -1204,35 +1255,43 @@ class SkillManager {
         const { force = false, save = true } = options;
         const resolved = await this.resolver.resolve(ref);
         const { parsed, repoUrl } = resolved;
-        const version = resolved.ref;
+        const gitRef = resolved.ref;
         const skillName = parsed.subPath ? __WEBPACK_EXTERNAL_MODULE_node_path__.basename(parsed.subPath) : parsed.repo;
         const skillPath = this.getSkillPath(skillName);
         if (exists(skillPath) && !force) {
             const locked = this.lockManager.get(skillName);
-            if (locked && locked.version === version) {
-                logger.info(`${skillName}@${version} is already installed`);
+            const lockedRef = locked?.ref || locked?.version;
+            if (locked && lockedRef === gitRef) {
+                logger_logger.info(`${skillName}@${gitRef} is already installed`);
                 const installed = this.getInstalledSkill(skillName);
                 if (installed) return installed;
             }
             if (!force) {
-                logger.warn(`${skillName} is already installed. Use --force to reinstall.`);
+                logger_logger.warn(`${skillName} is already installed. Use --force to reinstall.`);
                 const installed = this.getInstalledSkill(skillName);
                 if (installed) return installed;
             }
         }
-        logger["package"](`Installing ${skillName}@${version}...`);
-        let cacheResult = await this.cache.get(parsed, version);
-        if (cacheResult) logger.debug(`Using cached ${skillName}@${version}`);
+        logger_logger["package"](`Installing ${skillName}@${gitRef}...`);
+        let cacheResult = await this.cache.get(parsed, gitRef);
+        if (cacheResult) logger_logger.debug(`Using cached ${skillName}@${gitRef}`);
         else {
-            logger.debug(`Caching ${skillName}@${version} from ${repoUrl}`);
-            cacheResult = await this.cache.cache(repoUrl, parsed, version, version);
+            logger_logger.debug(`Caching ${skillName}@${gitRef} from ${repoUrl}`);
+            cacheResult = await this.cache.cache(repoUrl, parsed, gitRef, gitRef);
         }
         ensureDir(this.getInstallDir());
         if (exists(skillPath)) remove(skillPath);
-        await this.cache.copyTo(parsed, version, skillPath);
+        await this.cache.copyTo(parsed, gitRef, skillPath);
+        let semanticVersion = gitRef;
+        const skillJsonPath = __WEBPACK_EXTERNAL_MODULE_node_path__.join(skillPath, 'skill.json');
+        if (exists(skillJsonPath)) try {
+            const skillJson = readJson(skillJsonPath);
+            if (skillJson.version) semanticVersion = skillJson.version;
+        } catch  {}
         if (!this.isGlobal) this.lockManager.lockSkill(skillName, {
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`,
-            version,
+            version: semanticVersion,
+            ref: gitRef,
             resolved: repoUrl,
             commit: cacheResult.commit
         });
@@ -1240,8 +1299,9 @@ class SkillManager {
             this.config.ensureExists();
             this.config.addSkill(skillName, ref);
         }
+        const displayVersion = semanticVersion !== gitRef ? `${semanticVersion} (${gitRef})` : gitRef;
         const locationHint = this.isGlobal ? '(global)' : '';
-        logger.success(`Installed ${skillName}@${version} to ${skillPath} ${locationHint}`.trim());
+        logger_logger.success(`Installed ${skillName}@${displayVersion} to ${skillPath} ${locationHint}`.trim());
         const installed = this.getInstalledSkill(skillName);
         if (!installed) throw new Error(`Failed to get installed skill info for ${skillName}`);
         return installed;
@@ -1256,7 +1316,7 @@ class SkillManager {
             });
             installed.push(skill);
         } catch (error) {
-            logger.error(`Failed to install ${name}: ${error.message}`);
+            logger_logger.error(`Failed to install ${name}: ${error.message}`);
         }
         return installed;
     }
@@ -1264,14 +1324,14 @@ class SkillManager {
         const skillPath = this.getSkillPath(name);
         if (!exists(skillPath)) {
             const location = this.isGlobal ? '(global)' : '';
-            logger.warn(`Skill ${name} is not installed ${location}`.trim());
+            logger_logger.warn(`Skill ${name} is not installed ${location}`.trim());
             return false;
         }
         remove(skillPath);
         if (!this.isGlobal) this.lockManager.remove(name);
         if (!this.isGlobal && this.config.exists()) this.config.removeSkill(name);
         const locationHint = this.isGlobal ? '(global)' : '';
-        logger.success(`Uninstalled ${name} ${locationHint}`.trim());
+        logger_logger.success(`Uninstalled ${name} ${locationHint}`.trim());
         return true;
     }
     async update(name) {
@@ -1279,7 +1339,7 @@ class SkillManager {
         if (name) {
             const ref = this.config.getSkillRef(name);
             if (!ref) {
-                logger.error(`Skill ${name} not found in skills.json`);
+                logger_logger.error(`Skill ${name} not found in skills.json`);
                 return [];
             }
             const skill = await this.install(ref, {
@@ -1296,7 +1356,7 @@ class SkillManager {
                 });
                 updated.push(skill);
             } catch (error) {
-                logger.error(`Failed to update ${skillName}: ${error.message}`);
+                logger_logger.error(`Failed to update ${skillName}: ${error.message}`);
             }
         }
         return updated;
@@ -1313,7 +1373,7 @@ class SkillManager {
         const linkPath = this.getSkillPath(skillName);
         ensureDir(__WEBPACK_EXTERNAL_MODULE_node_path__.dirname(linkPath));
         createSymlink(absolutePath, linkPath);
-        logger.success(`Linked ${skillName} → ${absolutePath}`);
+        logger_logger.success(`Linked ${skillName} → ${absolutePath}`);
         return {
             name: skillName,
             path: linkPath,
@@ -1325,15 +1385,15 @@ class SkillManager {
     unlink(name) {
         const skillPath = this.getSkillPath(name);
         if (!exists(skillPath)) {
-            logger.warn(`Skill ${name} is not installed`);
+            logger_logger.warn(`Skill ${name} is not installed`);
             return false;
         }
         if (!isSymlink(skillPath)) {
-            logger.warn(`Skill ${name} is not a linked skill`);
+            logger_logger.warn(`Skill ${name} is not a linked skill`);
             return false;
         }
         remove(skillPath);
-        logger.success(`Unlinked ${name}`);
+        logger_logger.success(`Unlinked ${name}`);
         return true;
     }
     list() {
@@ -1403,7 +1463,8 @@ class SkillManager {
         const skills = this.config.getSkills();
         for (const [name, ref] of Object.entries(skills))try {
             const locked = this.lockManager.get(name);
-            const current = locked?.version || 'unknown';
+            const currentRef = locked?.ref || locked?.version || 'unknown';
+            const currentVersion = locked?.version || 'unknown';
             const parsed = this.resolver.parseRef(ref);
             const repoUrl = this.resolver.buildRepoUrl(parsed);
             const latestResolved = await this.resolver.resolveVersion(repoUrl, {
@@ -1412,15 +1473,15 @@ class SkillManager {
                 raw: 'latest'
             });
             const latest = latestResolved.ref;
-            const updateAvailable = current !== latest && 'unknown' !== current;
+            const updateAvailable = currentRef !== latest && 'unknown' !== currentRef;
             results.push({
                 name,
-                current,
+                current: currentVersion !== currentRef ? `${currentVersion} (${currentRef})` : currentRef,
                 latest,
                 updateAvailable
             });
         } catch (error) {
-            logger.debug(`Failed to check ${name}: ${error.message}`);
+            logger_logger.debug(`Failed to check ${name}: ${error.message}`);
             results.push({
                 name,
                 current: 'unknown',
@@ -1434,16 +1495,22 @@ class SkillManager {
         const { save = true, mode = 'symlink' } = options;
         const resolved = await this.resolver.resolve(ref);
         const { parsed, repoUrl } = resolved;
-        const version = resolved.ref;
+        const gitRef = resolved.ref;
         const skillName = parsed.subPath ? __WEBPACK_EXTERNAL_MODULE_node_path__.basename(parsed.subPath) : parsed.repo;
-        logger["package"](`Installing ${skillName}@${version} to ${targetAgents.length} agent(s)...`);
-        let cacheResult = await this.cache.get(parsed, version);
-        if (cacheResult) logger.debug(`Using cached ${skillName}@${version}`);
+        logger_logger["package"](`Installing ${skillName}@${gitRef} to ${targetAgents.length} agent(s)...`);
+        let cacheResult = await this.cache.get(parsed, gitRef);
+        if (cacheResult) logger_logger.debug(`Using cached ${skillName}@${gitRef}`);
         else {
-            logger.debug(`Caching ${skillName}@${version} from ${repoUrl}`);
-            cacheResult = await this.cache.cache(repoUrl, parsed, version, version);
+            logger_logger.debug(`Caching ${skillName}@${gitRef} from ${repoUrl}`);
+            cacheResult = await this.cache.cache(repoUrl, parsed, gitRef, gitRef);
         }
-        const sourcePath = this.cache.getCachePath(parsed, version);
+        const sourcePath = this.cache.getCachePath(parsed, gitRef);
+        let semanticVersion = gitRef;
+        const skillJsonPath = __WEBPACK_EXTERNAL_MODULE_node_path__.join(sourcePath, 'skill.json');
+        if (exists(skillJsonPath)) try {
+            const skillJson = readJson(skillJsonPath);
+            if (skillJson.version) semanticVersion = skillJson.version;
+        } catch  {}
         const installer = new Installer({
             cwd: this.projectRoot,
             global: this.isGlobal
@@ -1453,7 +1520,8 @@ class SkillManager {
         });
         if (!this.isGlobal) this.lockManager.lockSkill(skillName, {
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`,
-            version,
+            version: semanticVersion,
+            ref: gitRef,
             resolved: repoUrl,
             commit: cacheResult.commit
         });
@@ -1463,12 +1531,13 @@ class SkillManager {
         }
         const successCount = Array.from(results.values()).filter((r)=>r.success).length;
         const failCount = results.size - successCount;
-        if (0 === failCount) logger.success(`Installed ${skillName}@${version} to ${successCount} agent(s)`);
-        else logger.warn(`Installed ${skillName}@${version} to ${successCount} agent(s), ${failCount} failed`);
+        const displayVersion = semanticVersion !== gitRef ? `${semanticVersion} (${gitRef})` : gitRef;
+        if (0 === failCount) logger_logger.success(`Installed ${skillName}@${displayVersion} to ${successCount} agent(s)`);
+        else logger_logger.warn(`Installed ${skillName}@${displayVersion} to ${successCount} agent(s), ${failCount} failed`);
         const skill = {
             name: skillName,
             path: sourcePath,
-            version,
+            version: semanticVersion,
             source: `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`
         };
         return {
@@ -1508,7 +1577,7 @@ class SkillManager {
         if (!this.isGlobal) this.lockManager.remove(name);
         if (!this.isGlobal && this.config.exists()) this.config.removeSkill(name);
         const successCount = Array.from(results.values()).filter((r)=>r).length;
-        logger.success(`Uninstalled ${name} from ${successCount} agent(s)`);
+        logger_logger.success(`Uninstalled ${name} from ${successCount} agent(s)`);
         return results;
     }
 }
@@ -1520,41 +1589,41 @@ const infoCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('info').de
         return;
     }
     if (!info.installed && !info.config) {
-        logger.error(`Skill ${skillName} not found`);
+        logger_logger.error(`Skill ${skillName} not found`);
         process.exit(1);
     }
-    logger.log(`Skill: ${skillName}`);
-    logger.newline();
+    logger_logger.log(`Skill: ${skillName}`);
+    logger_logger.newline();
     if (info.config) {
-        logger.log("Configuration (skills.json):");
-        logger.log(`  Reference: ${info.config}`);
+        logger_logger.log("Configuration (skills.json):");
+        logger_logger.log(`  Reference: ${info.config}`);
     }
     if (info.locked) {
-        logger.log("Locked Version (skills.lock):");
-        logger.log(`  Version: ${info.locked.version}`);
-        logger.log(`  Source: ${info.locked.source}`);
-        logger.log(`  Commit: ${info.locked.commit}`);
-        logger.log(`  Installed: ${info.locked.installedAt}`);
+        logger_logger.log("Locked Version (skills.lock):");
+        logger_logger.log(`  Version: ${info.locked.version}`);
+        logger_logger.log(`  Source: ${info.locked.source}`);
+        logger_logger.log(`  Commit: ${info.locked.commit}`);
+        logger_logger.log(`  Installed: ${info.locked.installedAt}`);
     }
     if (info.installed) {
-        logger.log("Installed:");
-        logger.log(`  Path: ${info.installed.path}`);
-        logger.log(`  Version: ${info.installed.version}`);
-        logger.log(`  Linked: ${info.installed.isLinked ? 'Yes' : 'No'}`);
+        logger_logger.log("Installed:");
+        logger_logger.log(`  Path: ${info.installed.path}`);
+        logger_logger.log(`  Version: ${info.installed.version}`);
+        logger_logger.log(`  Linked: ${info.installed.isLinked ? 'Yes' : 'No'}`);
         if (info.installed.metadata) {
             const meta = info.installed.metadata;
-            logger.log("Metadata (skill.json):");
-            if (meta.description) logger.log(`  Description: ${meta.description}`);
-            if (meta.author) logger.log(`  Author: ${meta.author}`);
-            if (meta.license) logger.log(`  License: ${meta.license}`);
-            if (meta.keywords?.length) logger.log(`  Keywords: ${meta.keywords.join(', ')}`);
+            logger_logger.log("Metadata (skill.json):");
+            if (meta.description) logger_logger.log(`  Description: ${meta.description}`);
+            if (meta.author) logger_logger.log(`  Author: ${meta.author}`);
+            if (meta.license) logger_logger.log(`  License: ${meta.license}`);
+            if (meta.keywords?.length) logger_logger.log(`  Keywords: ${meta.keywords.join(', ')}`);
         }
-    } else logger.warn(`Skill ${skillName} is not installed`);
+    } else logger_logger.warn(`Skill ${skillName} is not installed`);
 });
 const initCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('init').description('Initialize a new skills.json configuration').option('-n, --name <name>', 'Project name').option('-r, --registry <registry>', 'Default registry', 'github').option('-d, --install-dir <dir>', 'Skills installation directory', '.skills').option('-y, --yes', 'Skip prompts and use defaults').action(async (options)=>{
     const configLoader = new ConfigLoader();
     if (configLoader.exists()) {
-        logger.warn('skills.json already exists');
+        logger_logger.warn('skills.json already exists');
         return;
     }
     const config = configLoader.create({
@@ -1564,16 +1633,16 @@ const initCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('init').de
             installDir: options.installDir
         }
     });
-    logger.success('Created skills.json');
-    logger.newline();
-    logger.log('Configuration:');
-    logger.log(`  Name: ${config.name || '(not set)'}`);
-    logger.log(`  Default registry: ${config.defaults?.registry}`);
-    logger.log(`  Install directory: ${config.defaults?.installDir}`);
-    logger.newline();
-    logger.log('Next steps:');
-    logger.log('  reskill install <skill>  Install a skill');
-    logger.log('  reskill list             List installed skills');
+    logger_logger.success('Created skills.json');
+    logger_logger.newline();
+    logger_logger.log('Configuration:');
+    logger_logger.log(`  Name: ${config.name || '(not set)'}`);
+    logger_logger.log(`  Default registry: ${config.defaults?.registry}`);
+    logger_logger.log(`  Install directory: ${config.defaults?.installDir}`);
+    logger_logger.newline();
+    logger_logger.log('Next steps:');
+    logger_logger.log('  reskill install <skill>  Install a skill');
+    logger_logger.log('  reskill list             List installed skills');
 });
 function formatAgentNames(agentTypes, maxShow = 5) {
     const names = agentTypes.map((a)=>agents[a].displayName);
@@ -1826,9 +1895,9 @@ const linkCmd = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('link').descri
     const skillManager = new SkillManager();
     try {
         const linked = skillManager.link(localPath, options.name);
-        logger.log(`Linked skill available at: ${linked.path}`);
+        logger_logger.log(`Linked skill available at: ${linked.path}`);
     } catch (error) {
-        logger.error(error.message);
+        logger_logger.error(error.message);
         process.exit(1);
     }
 });
@@ -1847,7 +1916,7 @@ const listCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('list').al
     const skills = skillManager.list();
     if (0 === skills.length) {
         const location = isGlobal ? 'globally' : 'in this project';
-        logger.info(`No skills installed ${location}`);
+        logger_logger.info(`No skills installed ${location}`);
         return;
     }
     if (options.json) {
@@ -1855,8 +1924,8 @@ const listCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('list').al
         return;
     }
     const locationLabel = isGlobal ? __WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim(' (global)') : '';
-    logger.log(`Installed Skills (${skillManager.getInstallDir()})${locationLabel}:`);
-    logger.newline();
+    logger_logger.log(`Installed Skills (${skillManager.getInstallDir()})${locationLabel}:`);
+    logger_logger.newline();
     const headers = [
         'Name',
         'Version',
@@ -1867,19 +1936,19 @@ const listCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('list').al
             skill.isLinked ? `${skill.version} (linked)` : skill.version,
             skill.source || '-'
         ]);
-    logger.table(headers, rows);
-    logger.newline();
-    logger.log(`Total: ${skills.length} skill(s)`);
+    logger_logger.table(headers, rows);
+    logger_logger.newline();
+    logger_logger.log(`Total: ${skills.length} skill(s)`);
 });
 const outdatedCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('outdated').description('Check for outdated skills').option('-j, --json', 'Output as JSON').action(async (options)=>{
     const configLoader = new ConfigLoader();
     if (!configLoader.exists()) {
-        logger.error("skills.json not found. Run 'reskill init' first.");
+        logger_logger.error("skills.json not found. Run 'reskill init' first.");
         process.exit(1);
     }
     const skills = configLoader.getSkills();
     if (0 === Object.keys(skills).length) {
-        logger.info('No skills defined in skills.json');
+        logger_logger.info('No skills defined in skills.json');
         return;
     }
     const skillManager = new SkillManager();
@@ -1893,11 +1962,11 @@ const outdatedCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('outda
         }
         const outdated = results.filter((r)=>r.updateAvailable);
         if (0 === outdated.length) {
-            logger.success('All skills are up to date!');
+            logger_logger.success('All skills are up to date!');
             return;
         }
-        logger["package"]('Checking for updates...');
-        logger.newline();
+        logger_logger["package"]('Checking for updates...');
+        logger_logger.newline();
         const headers = [
             'Skill',
             'Current',
@@ -1910,15 +1979,15 @@ const outdatedCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('outda
                 r.latest,
                 r.updateAvailable ? __WEBPACK_EXTERNAL_MODULE_chalk__["default"].yellow('⬆️ Update available') : __WEBPACK_EXTERNAL_MODULE_chalk__["default"].green('✅ Up to date')
             ]);
-        logger.table(headers, rows);
-        logger.newline();
+        logger_logger.table(headers, rows);
+        logger_logger.newline();
         if (outdated.length > 0) {
-            logger.log(`Run ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('reskill update')} to update all skills`);
-            logger.log(`Or ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('reskill update <skill>')} to update a specific skill`);
+            logger_logger.log(`Run ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('reskill update')} to update all skills`);
+            logger_logger.log(`Or ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan('reskill update <skill>')} to update a specific skill`);
         }
     } catch (error) {
         spinner.fail('Check failed');
-        logger.error(error.message);
+        logger_logger.error(error.message);
         process.exit(1);
     }
 });
@@ -1933,7 +2002,7 @@ const uninstallCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('unin
 const updateCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('update').alias('up').description('Update installed skills').argument('[skill]', 'Skill name to update (updates all if not specified)').action(async (skill)=>{
     const configLoader = new ConfigLoader();
     if (!configLoader.exists()) {
-        logger.error("skills.json not found. Run 'reskill init' first.");
+        logger_logger.error("skills.json not found. Run 'reskill init' first.");
         process.exit(1);
     }
     const skillManager = new SkillManager();
@@ -1942,14 +2011,14 @@ const updateCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('update'
         const updated = await skillManager.update(skill);
         spinner.stop();
         if (0 === updated.length) {
-            logger.info('No skills to update');
+            logger_logger.info('No skills to update');
             return;
         }
-        logger.success(`Updated ${updated.length} skill(s):`);
-        for (const s of updated)logger.log(`  - ${s.name}@${s.version}`);
+        logger_logger.success(`Updated ${updated.length} skill(s):`);
+        for (const s of updated)logger_logger.log(`  - ${s.name}@${s.version}`);
     } catch (error) {
         spinner.fail('Update failed');
-        logger.error(error.message);
+        logger_logger.error(error.message);
         process.exit(1);
     }
 });
@@ -1966,4 +2035,8 @@ program.addCommand(outdatedCommand);
 program.addCommand(uninstallCommand);
 program.addCommand(linkCommand);
 program.addCommand(unlinkCommand);
-program.parse();
+const updateCheckPromise = checkForUpdate(packageJson.name, packageJson.version);
+program.parseAsync().then(async ()=>{
+    const result = await updateCheckPromise;
+    if (result?.hasUpdate) logger_logger.log(formatUpdateMessage(result));
+});

package/dist/core/git-resolver.d.ts

@@ -39,6 +39,7 @@ export declare class GitResolver {
      * - git@github.com:user/repo.git/subpath@v1.0.0
      * - https://github.com/user/repo.git
      * - https://github.com/user/repo.git@v1.0.0
+     * - https://github.com/user/repo/tree/branch/path (GitHub web URL)
      */
     private parseGitUrlRef;
     /**

package/dist/core/git-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-resolver.d.ts","sourceRoot":"","sources":["../../src/core/git-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUvE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,eAAe,CAAS;gBAEpB,eAAe,SAAW;IAItC;;;;;;;;;OASG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc;IAmDrC;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa;IA+BjD;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAQ5C;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAkD5C;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAClC,MAAM,EAAE,cAAc,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CAaH;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"git-resolver.d.ts","sourceRoot":"","sources":["../../src/core/git-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUvE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,eAAe,CAAS;gBAEpB,eAAe,SAAW;IAItC;;;;;;;;;OASG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc;IAmDrC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;IAmFtB;;OAEG;IACH,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa;IA+BjD;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAQ5C;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAkD5C;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAClC,MAAM,EAAE,cAAc,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CAaH;AAED,eAAe,WAAW,CAAC"}

package/dist/core/lock-manager.d.ts

@@ -47,6 +47,7 @@ export declare class LockManager {
     lockSkill(name: string, options: {
         source: string;
         version: string;
+        ref: string;
         resolved: string;
         commit: string;
     }): LockedSkill;

package/dist/core/lock-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/core/lock-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQjE;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAsBlB;;OAEG;IACH,MAAM,IAAI,UAAU;IAKpB;;OAEG;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IASnC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAK1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAM3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,WAAW;IAad;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAKrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,MAAM,IAAI,IAAI;CAOf;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/core/lock-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQjE;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAsBlB;;OAEG;IACH,MAAM,IAAI,UAAU;IAKpB;;OAEG;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IASnC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAK1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAM3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,WAAW;IAcd;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAKrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,MAAM,IAAI,IAAI;CAOf;AAED,eAAe,WAAW,CAAC"}