@lightdash/cli 0.2638.1 → 0.2639.1

package/dist/handlers/installSkills.d.ts

@@ -5,6 +5,7 @@ type InstallSkillsOptions = {
     global: boolean;
     path?: string;
 };
+export declare function getVersionWithSkills(): string;
 export declare const installSkillsHandler: (options: InstallSkillsOptions) => Promise<void>;
 export {};
 //# sourceMappingURL=installSkills.d.ts.map

package/dist/handlers/installSkills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installSkills.d.ts","sourceRoot":"","sources":["../../src/handlers/installSkills.ts"],"names":[],"mappings":"AAaA,KAAK,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/C,KAAK,oBAAoB,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuMF,eAAO,MAAM,oBAAoB,GAC7B,SAAS,oBAAoB,KAC9B,OAAO,CAAC,IAAI,CA0Ed,CAAC"}
+{"version":3,"file":"installSkills.d.ts","sourceRoot":"","sources":["../../src/handlers/installSkills.ts"],"names":[],"mappings":"AAgBA,KAAK,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/C,KAAK,oBAAoB,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA8SF,wBAAgB,oBAAoB,IAAI,MAAM,CA8B7C;AAED,eAAO,MAAM,oBAAoB,GAC7B,SAAS,oBAAoB,KAC9B,OAAO,CAAC,IAAI,CA8Ed,CAAC"}

package/dist/handlers/installSkills.js

@@ -1,16 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.installSkillsHandler = void 0;
+exports.getVersionWithSkills = getVersionWithSkills;
 const tslib_1 = require("tslib");
 const fs = tslib_1.__importStar(require("fs"));
 const node_fetch_1 = tslib_1.__importDefault(require("node-fetch"));
 const os = tslib_1.__importStar(require("os"));
 const path = tslib_1.__importStar(require("path"));
 const analytics_1 = require("../analytics/analytics");
+const env_1 = require("../env");
 const globalState_1 = tslib_1.__importDefault(require("../globalState"));
 const styles = tslib_1.__importStar(require("../styles"));
+const SKILL_MANIFEST_FILENAME = '.lightdash-skill-manifest.json';
 const GITHUB_API_BASE = 'https://api.github.com/repos/lightdash/lightdash/contents';
-const GITHUB_RAW_BASE = 'https://raw.githubusercontent.com/lightdash/lightdash/main';
+const GITHUB_RAW_BASE = `https://raw.githubusercontent.com/lightdash/lightdash/${env_1.CLI_VERSION}`;
 function getAgentSkillsDir(agent) {
     switch (agent) {
         case 'claude':
@@ -59,7 +62,7 @@ function getInstallPath(options) {
     return path.join(cwd, skillsDir);
 }
 async function fetchGitHubDirectory(repoPath) {
-    const url = `${GITHUB_API_BASE}/${repoPath}`;
+    const url = `${GITHUB_API_BASE}/${repoPath}?ref=${env_1.CLI_VERSION}`;
     globalState_1.default.debug(`> Fetching GitHub directory: ${url}`);
     const response = await (0, node_fetch_1.default)(url, {
         headers: {
@@ -88,6 +91,9 @@ function resolveSymlinkTarget(symlinkPath, target) {
     const symlinkDir = path.posix.dirname(symlinkPath);
     return path.posix.normalize(path.posix.join(symlinkDir, target.trim()));
 }
+function interpolateVersionPlaceholders(content) {
+    return content.replace(/\{\{CLI_VERSION\}\}/g, env_1.CLI_VERSION);
+}
 /* eslint-disable no-await-in-loop */
 // Sequential downloads are intentional to avoid GitHub rate limits and handle symlinks
 async function downloadSkillFiles(repoPath, localDir, visited = new Set()) {
@@ -121,7 +127,7 @@ async function downloadSkillFiles(repoPath, localDir, visited = new Set()) {
                     }
                     else if (targetItem.download_url) {
                         const content = await fetchFileContent(targetItem.download_url);
-                        fs.writeFileSync(targetLocalPath, content);
+                        fs.writeFileSync(targetLocalPath, interpolateVersionPlaceholders(content));
                     }
                 }
             }
@@ -131,7 +137,7 @@ async function downloadSkillFiles(repoPath, localDir, visited = new Set()) {
                 const content = await fetchFileContent(downloadUrl);
                 // Ensure parent directory exists
                 fs.mkdirSync(path.dirname(localPath), { recursive: true });
-                fs.writeFileSync(localPath, content);
+                fs.writeFileSync(localPath, interpolateVersionPlaceholders(content));
             }
         }
         else if (item.type === 'file' && item.download_url) {
@@ -143,7 +149,7 @@ async function downloadSkillFiles(repoPath, localDir, visited = new Set()) {
                 content = await fetchFileContent(`${GITHUB_RAW_BASE}/${resolvedPath}`);
             }
             fs.mkdirSync(path.dirname(localPath), { recursive: true });
-            fs.writeFileSync(localPath, content);
+            fs.writeFileSync(localPath, interpolateVersionPlaceholders(content));
         }
     }
 }
@@ -152,6 +158,95 @@ async function listAvailableSkills() {
     const items = await fetchGitHubDirectory('skills');
     return items.filter((item) => item.type === 'dir').map((item) => item.name);
 }
+function writeSkillManifest(skillDir) {
+    const manifest = {
+        version: env_1.CLI_VERSION,
+        installed_at: new Date().toISOString(),
+    };
+    fs.writeFileSync(path.join(skillDir, SKILL_MANIFEST_FILENAME), JSON.stringify(manifest, null, 2));
+}
+function readSkillManifest(skillDir) {
+    const manifestPath = path.join(skillDir, SKILL_MANIFEST_FILENAME);
+    if (!fs.existsSync(manifestPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function findInstalledSkills() {
+    const agents = ['claude', 'cursor', 'codex'];
+    const results = [];
+    const roots = [
+        { path: os.homedir(), scope: 'global' },
+    ];
+    const cwd = process.cwd();
+    const gitRoot = findGitRoot(cwd);
+    roots.push({ path: gitRoot || cwd, scope: 'project' });
+    for (const root of roots) {
+        for (const agent of agents) {
+            const skillsDir = path.join(root.path, getAgentSkillsDir(agent));
+            if (!fs.existsSync(skillsDir)) {
+                // eslint-disable-next-line no-continue
+                continue;
+            }
+            let entries;
+            try {
+                entries = fs.readdirSync(skillsDir);
+            }
+            catch {
+                // eslint-disable-next-line no-continue
+                continue;
+            }
+            entries
+                .filter((e) => fs.statSync(path.join(skillsDir, e)).isDirectory())
+                .forEach((entry) => {
+                const manifest = readSkillManifest(path.join(skillsDir, entry));
+                if (manifest) {
+                    results.push({
+                        name: entry,
+                        version: manifest.version,
+                        agent,
+                        scope: root.scope,
+                        isOutdated: manifest.version !== env_1.CLI_VERSION,
+                    });
+                }
+            });
+        }
+    }
+    return results;
+}
+function getVersionWithSkills() {
+    const lines = [env_1.CLI_VERSION];
+    const skills = findInstalledSkills();
+    if (skills.length > 0) {
+        lines.push('');
+        lines.push('Installed skills:');
+        for (const skill of skills) {
+            const line = `  ${skill.name} v${skill.version} [${skill.agent}, ${skill.scope}]`;
+            lines.push(skill.isOutdated ? styles.warning(line) : line);
+        }
+        const outdated = skills.filter((s) => s.isOutdated);
+        if (outdated.length > 0) {
+            lines.push('');
+            lines.push(styles.warning('Update with:'));
+            const seen = new Set();
+            for (const skill of outdated) {
+                const globalFlag = skill.scope === 'global' ? ' --global' : '';
+                const agentFlag = ` --agent ${skill.agent}`;
+                const cmd = `lightdash install-skills${globalFlag}${agentFlag}`;
+                if (!seen.has(cmd)) {
+                    seen.add(cmd);
+                    lines.push(styles.warning(`  ${cmd}`));
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
 const installSkillsHandler = async (options) => {
     const startTime = Date.now();
     let success = true;
@@ -160,6 +255,7 @@ const installSkillsHandler = async (options) => {
     console.error(styles.title('\n⚡ Lightdash Skills Installer\n'));
     console.error(`Agent: ${styles.bold(options.agent)}`);
     console.error(`Scope: ${styles.bold(options.global ? 'global' : 'project')}`);
+    console.error(`Version: ${styles.bold(env_1.CLI_VERSION)}`);
     console.error(`Install path: ${styles.bold(installPath)}\n`);
     const spinner = globalState_1.default.startSpinner('Fetching available skills...');
     try {
@@ -184,7 +280,8 @@ const installSkillsHandler = async (options) => {
                 }
                 fs.mkdirSync(skillLocalPath, { recursive: true });
                 await downloadSkillFiles(`skills/${skill}`, skillLocalPath);
-                skillSpinner.succeed(`Installed skill: ${skill}`);
+                writeSkillManifest(skillLocalPath);
+                skillSpinner.succeed(`Installed skill: ${skill} (v${env_1.CLI_VERSION})`);
             }
             catch (err) {
                 const errorMessage = err instanceof Error ? err.message : String(err);

package/dist/index.js

@@ -68,7 +68,7 @@ function parseProjectArgument(value) {
     return value;
 }
 commander_1.program
-    .version(env_1.CLI_VERSION)
+    .version((0, installSkills_1.getVersionWithSkills)())
     .name(styles.title('⚡️lightdash'))
     .description('Developer tools for dbt and Lightdash.\nSee https://docs.lightdash.com for more help and examples')
     .option('--non-interactive', 'Disable all interactive prompts. Commands fail with helpful error if required input is missing.')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightdash/cli",
-  "version": "0.2638.1",
+  "version": "0.2639.1",
   "description": "Lightdash CLI tool",
   "license": "MIT",
   "repository": {
@@ -40,8 +40,8 @@
     "unique-names-generator": "^4.7.1",
     "uuid": "^11.0.3",
     "yaml": "^2.7.0",
-    "@lightdash/common": "0.2638.1",
-    "@lightdash/warehouses": "0.2638.1"
+    "@lightdash/warehouses": "0.2639.1",
+    "@lightdash/common": "0.2639.1"
   },
   "devDependencies": {
     "@types/inquirer": "^8.2.1",