ctx7 0.2.3 → 0.2.4-canary.0

package/dist/index.js

@@ -8,8 +8,8 @@ import figlet from "figlet";
 // src/commands/skill.ts
 import pc7 from "picocolors";
 import ora3 from "ora";
-import { readdir, rm as rm2 } from "fs/promises";
-import { join as join6 } from "path";
+import { readdir as readdir2, rm as rm3 } from "fs/promises";
+import { join as join7 } from "path";
 
 // src/utils/parse-input.ts
 function parseSkillInput(input2) {
@@ -1495,7 +1495,7 @@ async function generateCommand(options) {
 import { homedir as homedir4 } from "os";
 
 // src/utils/deps.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile2, readdir } from "fs/promises";
 import { join as join5 } from "path";
 async function readFileOrNull(path2) {
   try {
@@ -1513,11 +1513,16 @@ async function parsePackageJson(cwd) {
   try {
     const pkg2 = JSON.parse(content);
     const names = /* @__PURE__ */ new Set();
-    for (const key of Object.keys(pkg2.dependencies || {})) {
-      if (!isSkippedLocally(key)) names.add(key);
-    }
-    for (const key of Object.keys(pkg2.devDependencies || {})) {
-      if (!isSkippedLocally(key)) names.add(key);
+    const depTypes = [
+      "dependencies",
+      "devDependencies",
+      "optionalDependencies",
+      "peerDependencies"
+    ];
+    for (const type of depTypes) {
+      for (const key of Object.keys(pkg2[type] || {})) {
+        if (!isSkippedLocally(key)) names.add(key);
+      }
     }
     return [...names];
   } catch {
@@ -1532,9 +1537,7 @@ async function parseRequirementsTxt(cwd) {
     const trimmed = line.trim();
     if (!trimmed || trimmed.startsWith("#") || trimmed.startsWith("-")) continue;
     const name = trimmed.split(/[=<>!~;@\s\[]/)[0].trim();
-    if (name && !isSkippedLocally(name)) {
-      deps.push(name);
-    }
+    if (name && !isSkippedLocally(name)) deps.push(name);
   }
   return deps;
 }
@@ -1556,8 +1559,7 @@ async function parsePyprojectToml(cwd) {
   }
   const poetryMatch = content.match(/\[tool\.poetry\.dependencies\]([\s\S]*?)(?:\n\[|$)/);
   if (poetryMatch) {
-    const lines = poetryMatch[1].split("\n");
-    for (const line of lines) {
+    for (const line of poetryMatch[1].split("\n")) {
       const match = line.match(/^(\S+)\s*=/);
       if (match) {
         const name = match[1].trim();
@@ -1578,6 +1580,109 @@ async function detectProjectDependencies(cwd) {
   ]);
   return [...new Set(results.flat())];
 }
+async function parseLockfileDeps(cwd) {
+  const content = await readFileOrNull(join5(cwd, "package-lock.json"));
+  if (!content) return null;
+  try {
+    const lock = JSON.parse(content);
+    const rootPkg = lock.packages?.[""];
+    if (rootPkg) {
+      const deps = [
+        ...Object.keys(rootPkg.dependencies || {}),
+        ...Object.keys(rootPkg.devDependencies || {}),
+        ...Object.keys(rootPkg.optionalDependencies || {})
+      ];
+      return deps.filter((d) => !isSkippedLocally(d));
+    }
+  } catch {
+  }
+  return null;
+}
+async function detectNewlyInstalledPackages(cwd) {
+  const declaredDeps = await parsePackageJson(cwd);
+  const declaredSet = new Set(declaredDeps);
+  const nodeModulesPath = join5(cwd, "node_modules");
+  try {
+    const entries = await readdir(nodeModulesPath);
+    const isPnpm = entries.includes(".pnpm");
+    if (isPnpm) {
+      const regularPackages = entries.filter((e) => !e.startsWith(".") && !e.startsWith("@"));
+      const scopedPackages = [];
+      for (const scope of entries.filter((e) => e.startsWith("@"))) {
+        try {
+          const packages = await readdir(join5(nodeModulesPath, scope));
+          for (const pkg2 of packages) {
+            if (!pkg2.startsWith(".")) scopedPackages.push(`${scope}/${pkg2}`);
+          }
+        } catch {
+        }
+      }
+      const installed = [...regularPackages, ...scopedPackages];
+      return installed.filter((pkg2) => !declaredSet.has(pkg2) && !isSkippedLocally(pkg2));
+    } else {
+      const lockfileDeps = await parseLockfileDeps(cwd);
+      return lockfileDeps ? lockfileDeps.filter((pkg2) => !declaredSet.has(pkg2)) : [];
+    }
+  } catch {
+    return [];
+  }
+}
+
+// src/utils/cache.ts
+import { readFile as readFile3, writeFile as writeFile3, mkdir as mkdir3, rm as rm2 } from "fs/promises";
+import { join as join6 } from "path";
+var CACHE_DIR = join6("node_modules", ".cache", "context7");
+var PENDING_FILE = "pending.json";
+var PENDING_TTL_MS = 20 * 60 * 1e3;
+async function getCachePath(cwd) {
+  const dir = join6(cwd, CACHE_DIR);
+  await mkdir3(dir, { recursive: true });
+  return join6(dir, PENDING_FILE);
+}
+async function loadPendingPackages(cwd) {
+  try {
+    const cachePath = await getCachePath(cwd);
+    const content = await readFile3(cachePath, "utf-8");
+    const cache = JSON.parse(content);
+    const now = Date.now();
+    const valid = cache.packages.filter((p) => now - p.detectedAt < PENDING_TTL_MS);
+    return valid.map((p) => p.name);
+  } catch {
+    return [];
+  }
+}
+async function savePendingPackages(cwd, packages) {
+  const cachePath = await getCachePath(cwd);
+  const cache = {
+    packages: packages.map((name) => ({
+      name,
+      detectedAt: Date.now()
+    }))
+  };
+  await writeFile3(cachePath, JSON.stringify(cache, null, 2));
+}
+async function clearPendingPackages(cwd) {
+  try {
+    const cachePath = await getCachePath(cwd);
+    await rm2(cachePath, { force: true });
+  } catch {
+  }
+}
+async function appendPendingPackages(cwd, newPackages) {
+  const existing = await loadPendingPackages(cwd);
+  const merged = [.../* @__PURE__ */ new Set([...existing, ...newPackages])];
+  await savePendingPackages(cwd, merged);
+}
+
+// src/utils/ansi.ts
+var ansi = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  cyan: "\x1B[36m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m"
+};
 
 // src/commands/skill.ts
 function logInstallSummary(targets, targetDirs, skillNames) {
@@ -1612,9 +1717,12 @@ function registerSkillCommands(program2) {
   skill.command("info").argument("<repository>", "GitHub repository (/owner/repo)").description("Show skills in a repository").action(async (project) => {
     await infoCommand(project);
   });
-  skill.command("suggest").option("--global", "Install globally instead of current directory").option("--claude", "Claude Code (.claude/skills/)").option("--cursor", "Cursor (.cursor/skills/)").option("--codex", "Codex (.codex/skills/)").option("--opencode", "OpenCode (.opencode/skills/)").option("--amp", "Amp (.agents/skills/)").option("--antigravity", "Antigravity (.agent/skills/)").description("Suggest skills based on your project dependencies").action(async (options) => {
+  skill.command("suggest").option("--global", "Install globally instead of current directory").option("--claude", "Claude Code (.claude/skills/)").option("--cursor", "Cursor (.cursor/skills/)").option("--codex", "Codex (.codex/skills/)").option("--opencode", "OpenCode (.opencode/skills/)").option("--amp", "Amp (.agents/skills/)").option("--antigravity", "Antigravity (.agent/skills/)").description("Suggest and install skills based on your project dependencies").action(async (options) => {
     await suggestCommand(options);
   });
+  skill.command("detect").description("Detect newly installed packages (for postinstall hooks)").action(async () => {
+    await detectCommand();
+  });
 }
 function registerSkillAliases(program2) {
   program2.command("si", { hidden: true }).argument("<repository>", "GitHub repository (/owner/repo)").argument("[skill]", "Specific skill name to install").option("--all", "Install all skills without prompting").option("--global", "Install globally instead of current directory").option("--claude", "Claude Code (.claude/skills/)").option("--cursor", "Cursor (.cursor/skills/)").option("--codex", "Codex (.codex/skills/)").option("--opencode", "OpenCode (.opencode/skills/)").option("--amp", "Amp (.agents/skills/)").option("--antigravity", "Antigravity (.agent/skills/)").description("Install skills (alias for: skills install)").action(async (project, skillName, options) => {
@@ -1757,7 +1865,7 @@ async function installCommand(input2, skillName, options) {
         }
         throw dirErr;
       }
-      const primarySkillDir = join6(primaryDir, skill.name);
+      const primarySkillDir = join7(primaryDir, skill.name);
       for (const targetDir of symlinkDirs) {
         try {
           await symlinkSkill(skill.name, primarySkillDir, targetDir);
@@ -1785,7 +1893,7 @@ async function installCommand(input2, skillName, options) {
     log.blank();
     log.warn("Fix permissions with:");
     for (const dir of failedDirs) {
-      const parentDir = join6(dir, "..");
+      const parentDir = join7(dir, "..");
       log.dim(`  sudo chown -R $(whoami) "${parentDir}"`);
     }
     log.blank();
@@ -1898,7 +2006,7 @@ async function searchCommand(query) {
         }
         throw dirErr;
       }
-      const primarySkillDir = join6(primaryDir, skill.name);
+      const primarySkillDir = join7(primaryDir, skill.name);
       for (const targetDir of symlinkDirs) {
         try {
           await symlinkSkill(skill.name, primarySkillDir, targetDir);
@@ -1926,7 +2034,7 @@ async function searchCommand(query) {
     log.blank();
     log.warn("Fix permissions with:");
     for (const dir of failedDirs) {
-      const parentDir = join6(dir, "..");
+      const parentDir = join7(dir, "..");
       log.dim(`  sudo chown -R $(whoami) "${parentDir}"`);
     }
     log.blank();
@@ -1945,9 +2053,9 @@ async function listCommand(options) {
   const idesToCheck = hasExplicitIdeOption(options) ? getSelectedIdes(options) : Object.keys(IDE_NAMES);
   const results = [];
   for (const ide of idesToCheck) {
-    const skillsDir = join6(baseDir, pathMap[ide]);
+    const skillsDir = join7(baseDir, pathMap[ide]);
     try {
-      const entries = await readdir(skillsDir, { withFileTypes: true });
+      const entries = await readdir2(skillsDir, { withFileTypes: true });
       const skillFolders = entries.filter((e) => e.isDirectory() || e.isSymbolicLink()).map((e) => e.name);
       if (skillFolders.length > 0) {
         results.push({ ide, skills: skillFolders });
@@ -1978,9 +2086,9 @@ async function removeCommand(name, options) {
     return;
   }
   const skillsDir = getTargetDirFromSelection(target.ide, target.scope);
-  const skillPath = join6(skillsDir, name);
+  const skillPath = join7(skillsDir, name);
   try {
-    await rm2(skillPath, { recursive: true });
+    await rm3(skillPath, { recursive: true });
     log.success(`Removed skill: ${name}`);
   } catch (err) {
     const error = err;
@@ -2030,11 +2138,225 @@ async function infoCommand(input2) {
 `
   );
 }
+async function detectCommand() {
+  if (process.env.CI || process.env.NODE_ENV === "production") {
+    return;
+  }
+  trackEvent("command", { name: "detect" });
+  const cwd = process.cwd();
+  const isInteractive = process.stdout.isTTY;
+  let deps;
+  if (isInteractive) {
+    const pendingPackages = await loadPendingPackages(cwd);
+    if (pendingPackages.length > 0) {
+      deps = pendingPackages;
+      log.blank();
+      log.info(
+        `Found ${pc7.bold(String(deps.length))} pending package(s) from recent installs: ${pc7.cyan(deps.join(", "))}`
+      );
+    } else {
+      const scanSpinner = ora3("Detecting newly installed packages...").start();
+      deps = await detectNewlyInstalledPackages(cwd);
+      if (deps.length === 0) {
+        scanSpinner.stop();
+        scanSpinner.clear();
+        log.blank();
+        log.warn("No new packages detected");
+        return;
+      }
+      await appendPendingPackages(cwd, deps);
+      scanSpinner.succeed(
+        `Detected ${deps.length} new package(s): ${ansi.yellow}${deps.join(", ")}${ansi.reset}`
+      );
+    }
+  } else {
+    const scanSpinner = ora3("Detecting newly installed packages...").start();
+    deps = await detectNewlyInstalledPackages(cwd);
+    if (deps.length === 0) {
+      scanSpinner.stop();
+      scanSpinner.clear();
+      return;
+    }
+    await appendPendingPackages(cwd, deps);
+    scanSpinner.succeed(
+      `Detected ${deps.length} new package(s): ${ansi.yellow}${deps.join(", ")}${ansi.reset}`
+    );
+  }
+  const searchSpinner = ora3("Finding matching skills...").start();
+  const tokens = loadTokens();
+  const accessToken = tokens && !isTokenExpired(tokens) ? tokens.access_token : void 0;
+  let data;
+  try {
+    data = await suggestSkills(deps, accessToken);
+  } catch {
+    searchSpinner.fail(pc7.red("Failed to connect to Context7"));
+    return;
+  }
+  if (data.error) {
+    searchSpinner.fail(pc7.red(`Error: ${data.message || data.error}`));
+    return;
+  }
+  const skills = data.skills;
+  if (skills.length === 0) {
+    searchSpinner.stop();
+    searchSpinner.clear();
+    return;
+  }
+  searchSpinner.succeed(`Found ${skills.length} relevant skill(s)`);
+  if (!isInteractive) {
+    console.log();
+    console.log(
+      `${ansi.cyan}${ansi.bold}${skills.length}${ansi.reset} skill(s) available for new packages:`
+    );
+    for (const skill of skills.slice(0, 5)) {
+      console.log(
+        `${ansi.dim}\u2502${ansi.reset} ${ansi.green}+${ansi.reset} ${ansi.bold}${ansi.green}${skill.name}${ansi.reset} ${ansi.dim}for${ansi.reset} ${ansi.yellow}${skill.matchedDep}${ansi.reset}`
+      );
+      if (skill.description) {
+        const desc = skill.description.length > 55 ? skill.description.slice(0, 52) + "..." : skill.description;
+        console.log(`${ansi.dim}\u2502   ${desc}${ansi.reset}`);
+      }
+    }
+    if (skills.length > 5) {
+      console.log(`${ansi.dim}\u2502 ... and ${skills.length - 5} more${ansi.reset}`);
+    }
+    console.log(
+      `${ansi.dim}\u2514${ansi.reset} Run ${ansi.cyan}${ansi.bold}ctx7 skills detect${ansi.reset} to install`
+    );
+    console.log();
+    return;
+  }
+  log.blank();
+  const maxNameLen = Math.max(...skills.map((s) => s.name.length));
+  const installsColWidth = 10;
+  const trustColWidth = 12;
+  const maxMatchedLen = Math.max(...skills.map((s) => s.matchedDep.length));
+  const indexWidth = skills.length.toString().length;
+  const choices = skills.map((s, index) => {
+    const indexStr = pc7.dim(`${(index + 1).toString().padStart(indexWidth)}.`);
+    const paddedName = s.name.padEnd(maxNameLen);
+    const installsRaw = s.installCount ? String(s.installCount) : "-";
+    const paddedInstalls = formatInstallCount(s.installCount, pc7.dim("-")) + " ".repeat(installsColWidth - installsRaw.length);
+    const trustRaw = s.trustScore !== void 0 && s.trustScore >= 0 ? s.trustScore.toFixed(1) : "-";
+    const trust = formatTrustScore(s.trustScore) + " ".repeat(trustColWidth - trustRaw.length);
+    const matched = pc7.yellow(s.matchedDep.padEnd(maxMatchedLen));
+    const skillLink = terminalLink(
+      s.name,
+      `https://context7.com/skills${s.project}/${s.name}`,
+      pc7.white
+    );
+    const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc7.white);
+    const metadataLines = [
+      pc7.dim("\u2500".repeat(50)),
+      "",
+      `${pc7.yellow("Skill:")}       ${skillLink}`,
+      `${pc7.yellow("Repo:")}        ${repoLink}`,
+      `${pc7.yellow("Relevant:")}    ${pc7.white(s.matchedDep)}`,
+      `${pc7.yellow("Description:")}`,
+      pc7.white(s.description || "No description")
+    ];
+    return {
+      name: `${indexStr} ${paddedName} ${paddedInstalls}${trust}${matched}`,
+      value: s,
+      description: metadataLines.join("\n")
+    };
+  });
+  const checkboxPrefixWidth = 3;
+  const headerPad = " ".repeat(checkboxPrefixWidth + indexWidth + 1 + 1 + maxNameLen + 1);
+  const headerLine = headerPad + pc7.dim("Installs".padEnd(installsColWidth)) + pc7.dim("Trust(0-10)".padEnd(trustColWidth)) + pc7.dim("Relevant");
+  const message = "Select skills to install:\n" + headerLine;
+  let selectedSkills;
+  try {
+    selectedSkills = await checkboxWithHover({
+      message,
+      choices,
+      pageSize: 15,
+      loop: false
+    });
+  } catch {
+    log.warn("Installation cancelled");
+    return;
+  }
+  if (selectedSkills.length === 0) {
+    log.warn("No skills selected");
+    return;
+  }
+  const targets = await promptForInstallTargets({});
+  if (!targets) {
+    log.warn("Installation cancelled");
+    return;
+  }
+  const targetDirs = getTargetDirs(targets);
+  const installSpinner = ora3("Installing skills...").start();
+  let permissionError = false;
+  const failedDirs = /* @__PURE__ */ new Set();
+  const installedSkills = [];
+  for (const skill of selectedSkills) {
+    try {
+      installSpinner.text = `Downloading ${skill.name}...`;
+      const downloadData = await downloadSkill(skill.project, skill.name);
+      if (downloadData.error) {
+        log.warn(`Failed to download ${skill.name}: ${downloadData.error}`);
+        continue;
+      }
+      installSpinner.text = `Installing ${skill.name}...`;
+      const [primaryDir, ...symlinkDirs] = targetDirs;
+      try {
+        await installSkillFiles(skill.name, downloadData.files, primaryDir);
+      } catch (dirErr) {
+        const error = dirErr;
+        if (error.code === "EACCES" || error.code === "EPERM") {
+          permissionError = true;
+          failedDirs.add(primaryDir);
+        }
+        throw dirErr;
+      }
+      const primarySkillDir = join7(primaryDir, skill.name);
+      for (const targetDir of symlinkDirs) {
+        try {
+          await symlinkSkill(skill.name, primarySkillDir, targetDir);
+        } catch (dirErr) {
+          const error = dirErr;
+          if (error.code === "EACCES" || error.code === "EPERM") {
+            permissionError = true;
+            failedDirs.add(targetDir);
+          }
+          throw dirErr;
+        }
+      }
+      installedSkills.push(`${skill.project}/${skill.name}`);
+    } catch (err) {
+      const error = err;
+      if (error.code === "EACCES" || error.code === "EPERM") {
+        continue;
+      }
+      const errMsg = err instanceof Error ? err.message : String(err);
+      log.warn(`Failed to install ${skill.name}: ${errMsg}`);
+    }
+  }
+  if (permissionError) {
+    installSpinner.fail("Permission denied");
+    log.blank();
+    log.warn("Fix permissions with:");
+    for (const dir of failedDirs) {
+      const parentDir = join7(dir, "..");
+      log.dim(`  sudo chown -R $(whoami) "${parentDir}"`);
+    }
+    log.blank();
+    return;
+  }
+  installSpinner.succeed(`Installed ${installedSkills.length} skill(s)`);
+  trackEvent("detect_install", { skills: installedSkills, ides: targets.ides });
+  await clearPendingPackages(cwd);
+  const installedNames = selectedSkills.map((s) => s.name);
+  logInstallSummary(targets, targetDirs, installedNames);
+}
 async function suggestCommand(options) {
   trackEvent("command", { name: "suggest" });
   log.blank();
+  const cwd = process.cwd();
   const scanSpinner = ora3("Scanning project dependencies...").start();
-  const deps = await detectProjectDependencies(process.cwd());
+  const deps = await detectProjectDependencies(cwd);
   if (deps.length === 0) {
     scanSpinner.warn(pc7.yellow("No dependencies detected"));
     log.info(`Try ${pc7.cyan("ctx7 skills search <keyword>")} to search manually`);
@@ -2147,7 +2469,7 @@ async function suggestCommand(options) {
         }
         throw dirErr;
       }
-      const primarySkillDir = join6(primaryDir, skill.name);
+      const primarySkillDir = join7(primaryDir, skill.name);
       for (const targetDir of symlinkDirs) {
         try {
           await symlinkSkill(skill.name, primarySkillDir, targetDir);
@@ -2175,7 +2497,7 @@ async function suggestCommand(options) {
     log.blank();
     log.warn("Fix permissions with:");
     for (const dir of failedDirs) {
-      const parentDir = join6(dir, "..");
+      const parentDir = join7(dir, "..");
       log.dim(`  sudo chown -R $(whoami) "${parentDir}"`);
     }
     log.blank();
@@ -2190,9 +2512,9 @@ async function suggestCommand(options) {
 // src/constants.ts
 import { readFileSync as readFileSync2 } from "fs";
 import { fileURLToPath } from "url";
-import { dirname as dirname2, join as join7 } from "path";
+import { dirname as dirname2, join as join8 } from "path";
 var __dirname = dirname2(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync2(join7(__dirname, "../package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync2(join8(__dirname, "../package.json"), "utf-8"));
 var VERSION = pkg.version;
 var NAME = pkg.name;