@cleocode/caamp 0.4.1 → 0.5.1

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  CANONICAL_SKILLS_DIR,
   MarketplaceClient,
   RECOMMENDATION_ERROR_CODES,
   applyMcpInstallWithPolicy,
@@ -11,6 +12,7 @@ import {
   detectAllProviders,
   detectMcpConfigConflicts,
   detectProjectProviders,
+  discoverSkill,
   discoverSkillsMulti,
   formatNetworkError,
   formatSkillRecommendations,
@@ -21,15 +23,21 @@ import {
   getProviderCount,
   getProvidersByPriority,
   getRegistryVersion,
+  getSkill,
+  getSkillDir,
   getTrackedSkills,
   groupByInstructFile,
   injectAll,
   installBatchWithRollback,
   installMcpServerToAll,
   installSkill,
+  isCatalogAvailable,
   isMarketplaceScoped,
+  isVerbose,
   listCanonicalSkills,
   listMcpServers,
+  listProfiles,
+  listSkills,
   parseSource,
   readConfig,
   readLockFile,
@@ -42,6 +50,7 @@ import {
   removeSkillFromLock,
   resolveConfigPath,
   resolvePreferredConfigScope,
+  resolveProfile,
   resolveProviderConfigPath,
   resolveProviderSkillsDir,
   scanDirectory,
@@ -53,7 +62,7 @@ import {
   tokenizeCriteriaValue,
   updateInstructionsSingleOperation,
   validateSkill
-} from "./chunk-6HQDRJLS.js";
+} from "./chunk-YCSZGZ5W.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -209,7 +218,7 @@ async function cloneGitLabRepo(owner, repo, ref, subPath) {
 
 // src/commands/skills/install.ts
 function registerSkillsInstall(parent) {
-  parent.command("install").description("Install a skill from GitHub, URL, or marketplace").argument("<source>", "Skill source (GitHub URL, owner/repo, @author/name)").option("-a, --agent <name>", "Target specific agent(s)", (v, prev) => [...prev, v], []).option("-g, --global", "Install globally").option("-y, --yes", "Skip confirmation").option("--all", "Install to all detected agents").action(async (source, opts) => {
+  parent.command("install").description("Install a skill from GitHub, URL, marketplace, or ct-skills catalog").argument("[source]", "Skill source (GitHub URL, owner/repo, @author/name, skill-name)").option("-a, --agent <name>", "Target specific agent(s)", (v, prev) => [...prev, v], []).option("-g, --global", "Install globally").option("-y, --yes", "Skip confirmation").option("--all", "Install to all detected agents").option("--profile <name>", "Install a ct-skills profile (minimal, core, recommended, full)").action(async (source, opts) => {
     let providers;
     if (opts.all) {
       providers = getInstalledProviders();
@@ -222,6 +231,63 @@ function registerSkillsInstall(parent) {
       console.error(pc2.red("No target providers found. Use --agent or --all."));
       process.exit(1);
     }
+    if (opts.profile) {
+      if (!isCatalogAvailable()) {
+        console.error(pc2.red("@cleocode/ct-skills is not installed. Run: npm install @cleocode/ct-skills"));
+        process.exit(1);
+      }
+      const profileSkills = resolveProfile(opts.profile);
+      if (profileSkills.length === 0) {
+        const available = listProfiles();
+        console.error(pc2.red(`Profile not found: ${opts.profile}`));
+        if (available.length > 0) {
+          console.log(pc2.dim("Available profiles: " + available.join(", ")));
+        }
+        process.exit(1);
+      }
+      console.log(`Installing profile ${pc2.bold(opts.profile)} (${profileSkills.length} skill(s))...`);
+      console.log(pc2.dim(`Target: ${providers.length} provider(s)`));
+      let installed = 0;
+      let failed = 0;
+      for (const name of profileSkills) {
+        const skillDir = getSkillDir(name);
+        try {
+          const result = await installSkill(
+            skillDir,
+            name,
+            providers,
+            opts.global ?? false
+          );
+          if (result.success) {
+            console.log(pc2.green(`  + ${name}`));
+            await recordSkillInstall(
+              name,
+              `@cleocode/ct-skills:${name}`,
+              `@cleocode/ct-skills:${name}`,
+              "package",
+              result.linkedAgents,
+              result.canonicalPath,
+              true
+            );
+            installed++;
+          } else {
+            console.log(pc2.yellow(`  ! ${name}: ${result.errors.join(", ")}`));
+            failed++;
+          }
+        } catch (err) {
+          console.log(pc2.red(`  x ${name}: ${err instanceof Error ? err.message : String(err)}`));
+          failed++;
+        }
+      }
+      console.log(`
+${pc2.green(`${installed} installed`)}, ${failed > 0 ? pc2.yellow(`${failed} failed`) : "0 failed"}`);
+      return;
+    }
+    if (!source) {
+      console.error(pc2.red("Missing required argument: source"));
+      console.log(pc2.dim("Usage: caamp skills install <source> or caamp skills install --profile <name>"));
+      process.exit(1);
+    }
     console.log(pc2.dim(`Installing to ${providers.length} provider(s)...`));
     let localPath;
     let cleanup;
@@ -302,6 +368,27 @@ function registerSkillsInstall(parent) {
         }
       } else if (parsed.type === "local") {
         localPath = parsed.value;
+        const discovered = await discoverSkill(localPath);
+        if (discovered) {
+          skillName = discovered.name;
+        }
+      } else if (parsed.type === "package") {
+        if (!isCatalogAvailable()) {
+          console.error(pc2.red("@cleocode/ct-skills is not installed. Run: npm install @cleocode/ct-skills"));
+          process.exit(1);
+        }
+        const catalogSkill = getSkill(parsed.inferredName);
+        if (catalogSkill) {
+          localPath = getSkillDir(catalogSkill.name);
+          skillName = catalogSkill.name;
+          sourceValue = `@cleocode/ct-skills:${catalogSkill.name}`;
+          sourceType = "package";
+          console.log(`  Found in catalog: ${pc2.bold(catalogSkill.name)} v${catalogSkill.version} (${pc2.dim(catalogSkill.category)})`);
+        } else {
+          console.error(pc2.red(`Skill not found in catalog: ${parsed.inferredName}`));
+          console.log(pc2.dim("Available skills: " + listSkills().join(", ")));
+          process.exit(1);
+        }
       } else {
         console.error(pc2.red(`Unsupported source type: ${parsed.type}`));
         process.exit(1);
@@ -322,14 +409,15 @@ function registerSkillsInstall(parent) {
 \u2713 Installed ${pc2.bold(skillName)}`));
         console.log(`  Canonical: ${pc2.dim(result.canonicalPath)}`);
         console.log(`  Linked to: ${result.linkedAgents.join(", ")}`);
+        const isGlobal = sourceType === "package" ? true : opts.global ?? false;
         await recordSkillInstall(
           skillName,
-          source,
+          sourceValue,
           sourceValue,
           sourceType,
           result.linkedAgents,
           result.canonicalPath,
-          opts.global ?? false
+          isGlobal
         );
       }
       if (result.errors.length > 0) {
@@ -882,14 +970,14 @@ Show example inputs and expected outputs.
     console.log(pc8.green(`\u2713 Created skill template: ${skillDir}/SKILL.md`));
     console.log(pc8.dim("\nNext steps:"));
     console.log(pc8.dim("  1. Edit SKILL.md with your instructions"));
-    console.log(pc8.dim("  2. Validate: caamp skills validate " + join3(skillDir, "SKILL.md")));
-    console.log(pc8.dim("  3. Install: caamp skills install " + skillDir));
+    console.log(pc8.dim(`  2. Validate: caamp skills validate ${join3(skillDir, "SKILL.md")}`));
+    console.log(pc8.dim(`  3. Install: caamp skills install ${skillDir}`));
   });
 }
 
 // src/commands/skills/audit.ts
-import pc9 from "picocolors";
 import { existsSync as existsSync3, statSync } from "fs";
+import pc9 from "picocolors";
 function registerSkillsAudit(parent) {
   parent.command("audit").description("Security scan skill files (46+ rules, SARIF output)").argument("[path]", "Path to SKILL.md or directory", ".").option("--sarif", "Output in SARIF format").option("--json", "Output as JSON").action(async (path, opts) => {
     if (!existsSync3(path)) {
@@ -1338,10 +1426,29 @@ ${provider.toolName} config (${configPath}):
 // src/commands/doctor.ts
 import pc19 from "picocolors";
 import { execFileSync } from "child_process";
-import { existsSync as existsSync6, readdirSync, lstatSync } from "fs";
+import { existsSync as existsSync6, readdirSync, lstatSync, readlinkSync } from "fs";
 import { homedir } from "os";
-import { join as join4 } from "path";
-var CAAMP_VERSION = "0.2.0";
+import { join as join5 } from "path";
+
+// src/core/version.ts
+import { readFileSync } from "fs";
+import { dirname, join as join4 } from "path";
+import { fileURLToPath } from "url";
+var cachedVersion = null;
+function getCaampVersion() {
+  if (cachedVersion) return cachedVersion;
+  try {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    const packageJsonPath = join4(currentDir, "..", "..", "package.json");
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    cachedVersion = packageJson.version ?? "0.0.0";
+  } catch {
+    cachedVersion = "0.0.0";
+  }
+  return cachedVersion;
+}
+
+// src/commands/doctor.ts
 function getNodeVersion() {
   return process.version;
 }
@@ -1361,7 +1468,7 @@ function checkEnvironment() {
   } else {
     checks.push({ label: "npm not found", status: "warn" });
   }
-  checks.push({ label: `CAAMP v${CAAMP_VERSION}`, status: "pass" });
+  checks.push({ label: `CAAMP v${getCaampVersion()}`, status: "pass" });
   checks.push({ label: `${process.platform} ${process.arch}`, status: "pass" });
   return { name: "Environment", checks };
 }
@@ -1416,35 +1523,52 @@ function checkInstalledProviders() {
 }
 function checkSkillSymlinks() {
   const checks = [];
-  const canonicalDir = join4(homedir(), ".agents", "skills");
+  const canonicalDir = CANONICAL_SKILLS_DIR;
   if (!existsSync6(canonicalDir)) {
     checks.push({ label: "0 canonical skills", status: "pass" });
     checks.push({ label: "No broken symlinks", status: "pass" });
     return { name: "Skills", checks };
   }
   let canonicalCount = 0;
+  let canonicalNames = [];
   try {
-    const entries = readdirSync(canonicalDir);
-    canonicalCount = entries.length;
+    canonicalNames = readdirSync(canonicalDir).filter((name) => {
+      const full = join5(canonicalDir, name);
+      try {
+        const stat = lstatSync(full);
+        return stat.isDirectory() || stat.isSymbolicLink();
+      } catch {
+        return false;
+      }
+    });
+    canonicalCount = canonicalNames.length;
     checks.push({ label: `${canonicalCount} canonical skills`, status: "pass" });
   } catch {
     checks.push({ label: "Cannot read skills directory", status: "warn" });
     return { name: "Skills", checks };
   }
   const broken = [];
-  const providers = getAllProviders();
-  for (const provider of providers) {
+  const stale = [];
+  const results = detectAllProviders();
+  const installed = results.filter((r) => r.installed);
+  for (const r of installed) {
+    const provider = r.provider;
     const skillDir = provider.pathSkills;
     if (!existsSync6(skillDir)) continue;
     try {
       const entries = readdirSync(skillDir);
       for (const entry of entries) {
-        const fullPath = join4(skillDir, entry);
+        const fullPath = join5(skillDir, entry);
         try {
           const stat = lstatSync(fullPath);
-          if (stat.isSymbolicLink()) {
-            if (!existsSync6(fullPath)) {
-              broken.push(`${provider.id}/${entry}`);
+          if (!stat.isSymbolicLink()) continue;
+          if (!existsSync6(fullPath)) {
+            broken.push(`${provider.id}/${entry}`);
+          } else {
+            const target = readlinkSync(fullPath);
+            const isCanonical = target.includes("/.agents/skills/") || target.includes("\\.agents\\skills\\");
+            if (!isCanonical) {
+              stale.push(`${provider.id}/${entry}`);
             }
           }
         } catch {
@@ -1457,11 +1581,20 @@ function checkSkillSymlinks() {
     checks.push({ label: "No broken symlinks", status: "pass" });
   } else {
     checks.push({
-      label: `${broken.length} broken symlinks`,
+      label: `${broken.length} broken symlink${broken.length !== 1 ? "s" : ""}`,
       status: "warn",
       detail: broken.join(", ")
     });
   }
+  if (stale.length === 0) {
+    checks.push({ label: "No stale symlinks", status: "pass" });
+  } else {
+    checks.push({
+      label: `${stale.length} stale symlink${stale.length !== 1 ? "s" : ""} (not pointing to ~/.agents/skills/)`,
+      status: "warn",
+      detail: stale.join(", ")
+    });
+  }
   return { name: "Skills", checks };
 }
 async function checkLockFile() {
@@ -1469,19 +1602,65 @@ async function checkLockFile() {
   try {
     const lock = await readLockFile();
     checks.push({ label: "Lock file valid", status: "pass" });
-    let orphaned = 0;
+    const lockSkillNames = Object.keys(lock.skills);
+    checks.push({ label: `${lockSkillNames.length} skill entries`, status: "pass" });
+    const orphaned = [];
     for (const [name, entry] of Object.entries(lock.skills)) {
       if (entry.canonicalPath && !existsSync6(entry.canonicalPath)) {
-        orphaned++;
+        orphaned.push(name);
       }
     }
-    if (orphaned === 0) {
-      checks.push({ label: `0 orphaned entries`, status: "pass" });
+    if (orphaned.length === 0) {
+      checks.push({ label: "0 orphaned entries", status: "pass" });
     } else {
       checks.push({
-        label: `${orphaned} orphaned skill entries`,
+        label: `${orphaned.length} orphaned skill${orphaned.length !== 1 ? "s" : ""} (in lock, missing from disk)`,
         status: "warn",
-        detail: "Skills tracked in lock file but missing from disk"
+        detail: orphaned.join(", ")
+      });
+    }
+    const canonicalDir = CANONICAL_SKILLS_DIR;
+    if (existsSync6(canonicalDir)) {
+      const onDisk = readdirSync(canonicalDir).filter((name) => {
+        try {
+          const stat = lstatSync(join5(canonicalDir, name));
+          return stat.isDirectory() || stat.isSymbolicLink();
+        } catch {
+          return false;
+        }
+      });
+      const untracked = onDisk.filter((name) => !lock.skills[name]);
+      if (untracked.length === 0) {
+        checks.push({ label: "0 untracked skills", status: "pass" });
+      } else {
+        checks.push({
+          label: `${untracked.length} untracked skill${untracked.length !== 1 ? "s" : ""} (on disk, not in lock)`,
+          status: "warn",
+          detail: untracked.join(", ")
+        });
+      }
+    }
+    const results = detectAllProviders();
+    const installed = results.filter((r) => r.installed);
+    const mismatches = [];
+    for (const [name, entry] of Object.entries(lock.skills)) {
+      if (!entry.agents || entry.agents.length === 0) continue;
+      for (const agentId of entry.agents) {
+        const provider = installed.find((r) => r.provider.id === agentId);
+        if (!provider) continue;
+        const linkPath = join5(provider.provider.pathSkills, name);
+        if (!existsSync6(linkPath)) {
+          mismatches.push(`${name} missing from ${agentId}`);
+        }
+      }
+    }
+    if (mismatches.length === 0) {
+      checks.push({ label: "Lock agent-lists match symlinks", status: "pass" });
+    } else {
+      checks.push({
+        label: `${mismatches.length} agent-list mismatch${mismatches.length !== 1 ? "es" : ""}`,
+        status: "warn",
+        detail: mismatches.slice(0, 5).join(", ") + (mismatches.length > 5 ? ` (+${mismatches.length - 5} more)` : "")
       });
     }
   } catch (err) {
@@ -1561,7 +1740,7 @@ function registerDoctorCommand(program2) {
     }
     if (opts.json) {
       const output = {
-        version: CAAMP_VERSION,
+        version: getCaampVersion(),
         sections: sections.map((s) => ({
           name: s.name,
           checks: s.checks
@@ -1772,9 +1951,9 @@ async function readMcpOperations(path) {
       );
     }
     const obj = item;
-    const serverName = obj["serverName"];
-    const config = obj["config"];
-    const scope = obj["scope"];
+    const serverName = obj.serverName;
+    const config = obj.config;
+    const scope = obj.scope;
     if (typeof serverName !== "string" || serverName.length === 0) {
       throw new LAFSCommandError(
         "E_ADVANCED_VALIDATION_MCP_NAME",
@@ -1823,9 +2002,9 @@ async function readSkillOperations(path) {
       );
     }
     const obj = item;
-    const sourcePath = obj["sourcePath"];
-    const skillName = obj["skillName"];
-    const isGlobal = obj["isGlobal"];
+    const sourcePath = obj.sourcePath;
+    const skillName = obj.skillName;
+    const isGlobal = obj.isGlobal;
     if (typeof sourcePath !== "string" || sourcePath.length === 0) {
       throw new LAFSCommandError(
         "E_ADVANCED_VALIDATION_SKILL_SOURCE",
@@ -2234,7 +2413,7 @@ function registerAdvancedCommands(program2) {
 
 // src/cli.ts
 var program = new Command();
-program.name("caamp").description("Central AI Agent Managed Packages - unified provider registry and package manager").version("0.3.0").option("-v, --verbose", "Show debug output").option("-q, --quiet", "Suppress non-error output");
+program.name("caamp").description("Central AI Agent Managed Packages - unified provider registry and package manager").version(getCaampVersion()).option("-v, --verbose", "Show debug output").option("-q, --quiet", "Suppress non-error output");
 program.hook("preAction", (thisCommand) => {
   const opts = thisCommand.optsWithGlobals();
   if (opts.verbose) setVerbose(true);
@@ -2247,5 +2426,30 @@ registerInstructionsCommands(program);
 registerConfigCommand(program);
 registerDoctorCommand(program);
 registerAdvancedCommands(program);
-program.parse();
+function toError(error) {
+  if (error instanceof Error) return error;
+  return new Error(String(error));
+}
+function handleFatal(error, source) {
+  const normalized = toError(error);
+  console.error(`Fatal error (${source}): ${normalized.message}`);
+  if (isVerbose() && normalized.stack) {
+    console.error(normalized.stack);
+  }
+}
+process.on("uncaughtException", (error) => {
+  handleFatal(error, "uncaughtException");
+  process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+  handleFatal(reason, "unhandledRejection");
+  process.exit(1);
+});
+async function main() {
+  await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+  handleFatal(error, "cli");
+  process.exit(1);
+});
 //# sourceMappingURL=cli.js.map