@cleocode/caamp 1.0.0 → 1.0.2

package/README.md

@@ -8,6 +8,7 @@
   <img src="https://img.shields.io/node/v/@cleocode/caamp" alt="node version" />
   <img src="https://img.shields.io/badge/providers-44-green" alt="providers" />
   <img src="https://img.shields.io/badge/TypeScript-strict-blue" alt="typescript" />
+  <a href="https://codluv.gitbook.io/caamp/"><img src="https://img.shields.io/badge/docs-GitBook-blue?logo=gitbook" alt="docs" /></a>
 </p>
 
 # CAAMP - Central AI Agent Managed Packages
@@ -64,7 +65,7 @@ const installed = getInstalledProviders();
 const servers = await listAllMcpServers(installed, "global");
 ```
 
-See [API Reference](docs/API-REFERENCE.md) for full programmatic API documentation.
+See [API Reference](https://codluv.gitbook.io/caamp/api-and-reference/api-reference) for full programmatic API documentation.
 
 ## CLI Commands
 
@@ -209,23 +210,25 @@ Each provider uses a different key name for MCP server configuration:
 
 ## Documentation
 
+**[Read the full documentation on GitBook](https://codluv.gitbook.io/caamp/)**
+
 | Document | Description |
 |----------|-------------|
-| [API Reference](docs/API-REFERENCE.md) | Full library API (signatures and examples) |
-| [Advanced CLI](docs/ADVANCED-CLI.md) | LAFS-compliant advanced command wrappers and input/output schemas |
-| [Advanced Recipes](docs/ADVANCED-RECIPES.md) | Production TypeScript patterns for tier filtering, rollback, conflict handling, and dual-scope operations |
-| [Provider Configuration Guide](docs/PROVIDER-CONFIGURATION.md) | Config keys, formats, scopes, and provider mapping guidance |
-| [Migration Guide](docs/MIGRATION-v1.md) | Upgrade notes for moving to v1.0.0 |
-| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common failure modes and remediation steps |
-| [CLI Help Examples](docs/CLI-HELP-EXAMPLES.md) | `--help` command examples for every command group |
-| [Contributing](CONTRIBUTING.md) | Development workflow and PR expectations |
-| [Security Policy](SECURITY.md) | Private vulnerability disclosure process |
-| [Generated API Docs](docs/api/) | Auto-generated from TSDoc (run `npm run docs:api`) |
-| [Vision & Architecture](claudedocs/VISION.md) | Project vision, design philosophy, and architecture |
-| [Product Requirements](claudedocs/PRD.md) | Full PRD with user stories and feature requirements |
-| [Technical Specification](claudedocs/specs/CAAMP-SPEC.md) | RFC 2119 spec covering all subsystems |
+| [API Reference](https://codluv.gitbook.io/caamp/api-and-reference/api-reference) | Full library API (signatures and examples) |
+| [Advanced CLI](https://codluv.gitbook.io/caamp/advanced-usage/advanced-cli) | LAFS-compliant advanced command wrappers and input/output schemas |
+| [Advanced Recipes](https://codluv.gitbook.io/caamp/advanced-usage/advanced-recipes) | Production TypeScript patterns for tier filtering, rollback, conflict handling, and dual-scope operations |
+| [Provider Configuration Guide](https://codluv.gitbook.io/caamp/user-guides/provider-configuration) | Config keys, formats, scopes, and provider mapping guidance |
+| [Migration Guide](https://codluv.gitbook.io/caamp/getting-started/migration-v1) | Upgrade notes for moving to v1.0.0 |
+| [Troubleshooting](https://codluv.gitbook.io/caamp/user-guides/troubleshooting) | Common failure modes and remediation steps |
+| [CLI Help Examples](https://codluv.gitbook.io/caamp/user-guides/cli-help-examples) | `--help` command examples for every command group |
+| [Skills Recommendations](https://codluv.gitbook.io/caamp/advanced-usage/skills-recommendations) | Marketplace search and recommendation engine |
+| [Contributing](https://codluv.gitbook.io/caamp/contributing/contributing) | Development workflow and PR expectations |
+| [Security Policy](https://codluv.gitbook.io/caamp/contributing/security) | Private vulnerability disclosure process |
+| [LAFS Compliance Profile](https://codluv.gitbook.io/caamp/api-and-reference/lafs-compliance) | CAAMP-specific LAFS adoption scope and compliance mapping |
+| [Agents Directory Standard](https://codluv.gitbook.io/caamp/api-and-reference/agents-directory-standard) | `.agents/` standard directory structure |
 | [LAFS Specification](https://github.com/kryptobaseddev/lafs-protocol/blob/main/lafs.md) | Canonical cross-language LLM-agent-first protocol |
-| [LAFS Compliance Profile](docs/LAFS-COMPLIANCE.md) | CAAMP-specific LAFS adoption scope and compliance mapping |
+| [Technical Specification](claudedocs/specs/CAAMP-SPEC.md) | RFC 2119 spec covering all subsystems |
+| [Vision & Architecture](claudedocs/VISION.md) | Project vision, design philosophy, and architecture |
 | [Gap Analysis & Roadmap](claudedocs/GAP-ANALYSIS.md) | Current state vs plan, v0.2.0+ roadmap |
 
 ## Contributing

package/dist/{chunk-YCSZGZ5W.js → chunk-762HFAUU.js}

@@ -294,8 +294,8 @@ function isQuiet() {
 }
 
 // src/core/registry/detection.ts
-import { existsSync as existsSync2 } from "fs";
 import { execFileSync } from "child_process";
+import { existsSync as existsSync2 } from "fs";
 import { join as join2 } from "path";
 var DEFAULT_DETECTION_CACHE_TTL_MS = 3e4;
 var detectionCache = null;
@@ -377,6 +377,7 @@ function providerSignature(provider) {
   });
 }
 function buildProvidersSignature(providers) {
+  if (!providers || !Array.isArray(providers)) return "";
   return providers.map(providerSignature).join("|");
 }
 function cloneDetectionResults(results) {
@@ -407,7 +408,7 @@ function detectProjectProvider(provider, projectDir) {
   return existsSync2(resolveProviderProjectPath(provider, projectDir));
 }
 function detectAllProviders(options = {}) {
-  const providers = getAllProviders();
+  const providers = getAllProviders() ?? [];
   const signature = buildProvidersSignature(providers);
   const cached = getCachedResults(signature, options);
   if (cached) {
@@ -434,8 +435,8 @@ function resetDetectionCache() {
 
 // src/core/sources/parser.ts
 var GITHUB_SHORTHAND = /^([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+)(?:\/(.+))?$/;
-var GITHUB_URL = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+)(?:\/tree\/([^/]+)(?:\/(.+))?)?/;
-var GITLAB_URL = /^https?:\/\/(?:www\.)?gitlab\.com\/([^/]+)\/([^/]+)(?:\/-\/tree\/([^/]+)(?:\/(.+))?)?/;
+var GITHUB_URL = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+)(?:\/(?:tree|blob)\/([^/]+)(?:\/(.+))?)?/;
+var GITLAB_URL = /^https?:\/\/(?:www\.)?gitlab\.com\/([^/]+)\/([^/]+)(?:\/-\/(?:tree|blob)\/([^/]+)(?:\/(.+))?)?/;
 var HTTP_URL = /^https?:\/\//;
 var NPM_SCOPED = /^@[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/;
 var NPM_PACKAGE = /^[a-zA-Z0-9_.-]+$/;
@@ -487,34 +488,38 @@ function parseSource(input) {
   if (ghUrlMatch) {
     const owner = ghUrlMatch[1];
     const repo = ghUrlMatch[2];
+    const path = ghUrlMatch[4];
     if (!owner || !repo) {
       return { type: "command", value: input, inferredName: inferName(input, "command") };
     }
+    const inferredName = path ? path.split("/").pop() ?? repo : repo;
     return {
       type: "github",
       value: input,
-      inferredName: repo,
+      inferredName,
       owner,
       repo,
       ref: ghUrlMatch[3],
-      path: ghUrlMatch[4]
+      path
     };
   }
   const glUrlMatch = input.match(GITLAB_URL);
   if (glUrlMatch) {
     const owner = glUrlMatch[1];
     const repo = glUrlMatch[2];
+    const path = glUrlMatch[4];
     if (!owner || !repo) {
       return { type: "command", value: input, inferredName: inferName(input, "command") };
     }
+    const inferredName = path ? path.split("/").pop() ?? repo : repo;
     return {
       type: "gitlab",
       value: input,
-      inferredName: repo,
+      inferredName,
       owner,
       repo,
       ref: glUrlMatch[3],
-      path: glUrlMatch[4]
+      path
     };
   }
   if (HTTP_URL.test(input)) {
@@ -535,16 +540,18 @@ function parseSource(input) {
   if (ghShorthand && !NPM_SCOPED.test(input)) {
     const owner = ghShorthand[1];
     const repo = ghShorthand[2];
+    const path = ghShorthand[3];
     if (!owner || !repo) {
       return { type: "command", value: input, inferredName: inferName(input, "command") };
     }
+    const inferredName = path ? path.split("/").pop() ?? repo : repo;
     return {
       type: "github",
       value: `https://github.com/${owner}/${repo}`,
-      inferredName: repo,
+      inferredName,
       owner,
       repo,
-      path: ghShorthand[3]
+      path
     };
   }
   if (NPM_SCOPED.test(input)) {
@@ -572,29 +579,26 @@ function isMarketplaceScoped(input) {
 }
 
 // src/core/skills/installer.ts
-import { mkdir, symlink, rm, cp } from "fs/promises";
 import { existsSync as existsSync3, lstatSync } from "fs";
+import { cp, mkdir, rm, symlink } from "fs/promises";
 import { join as join3 } from "path";
-
-// src/core/paths/agents.ts
-var AGENTS_HOME = getAgentsHome();
-var LOCK_FILE_PATH = getLockFilePath();
-var CANONICAL_SKILLS_DIR = getCanonicalSkillsDir();
-var AGENTS_MCP_DIR = getAgentsMcpDir();
-var AGENTS_MCP_SERVERS_PATH = getAgentsMcpServersPath();
-var AGENTS_CONFIG_PATH = getAgentsConfigPath();
-
-// src/core/skills/installer.ts
 async function ensureCanonicalDir() {
-  await mkdir(CANONICAL_SKILLS_DIR, { recursive: true });
+  await mkdir(getCanonicalSkillsDir(), { recursive: true });
 }
 async function installToCanonical(sourcePath, skillName) {
   await ensureCanonicalDir();
-  const targetDir = join3(CANONICAL_SKILLS_DIR, skillName);
-  if (existsSync3(targetDir)) {
-    await rm(targetDir, { recursive: true });
+  const targetDir = join3(getCanonicalSkillsDir(), skillName);
+  await rm(targetDir, { recursive: true, force: true });
+  try {
+    await cp(sourcePath, targetDir, { recursive: true });
+  } catch (err) {
+    if (err && typeof err === "object" && "code" in err && err.code === "EEXIST") {
+      await rm(targetDir, { recursive: true, force: true });
+      await cp(sourcePath, targetDir, { recursive: true });
+    } else {
+      throw err;
+    }
   }
-  await cp(sourcePath, targetDir, { recursive: true });
   return targetDir;
 }
 async function linkToAgent(canonicalPath, provider, skillName, isGlobal, projectDir) {
@@ -671,7 +675,7 @@ async function removeSkill(skillName, providers, isGlobal, projectDir) {
       }
     }
   }
-  const canonicalPath = join3(CANONICAL_SKILLS_DIR, skillName);
+  const canonicalPath = join3(getCanonicalSkillsDir(), skillName);
   if (existsSync3(canonicalPath)) {
     try {
       await rm(canonicalPath, { recursive: true });
@@ -682,15 +686,25 @@ async function removeSkill(skillName, providers, isGlobal, projectDir) {
   return { removed, errors };
 }
 async function listCanonicalSkills() {
-  if (!existsSync3(CANONICAL_SKILLS_DIR)) return [];
+  if (!existsSync3(getCanonicalSkillsDir())) return [];
   const { readdir: readdir2 } = await import("fs/promises");
-  const entries = await readdir2(CANONICAL_SKILLS_DIR, { withFileTypes: true });
+  const entries = await readdir2(getCanonicalSkillsDir(), { withFileTypes: true });
   return entries.filter((e) => e.isDirectory() || e.isSymbolicLink()).map((e) => e.name);
 }
 
 // src/core/lock-utils.ts
 import { open, readFile, writeFile, mkdir as mkdir2, rm as rm2, rename } from "fs/promises";
 import { existsSync as existsSync4 } from "fs";
+
+// src/core/paths/agents.ts
+var AGENTS_HOME = getAgentsHome();
+var LOCK_FILE_PATH = getLockFilePath();
+var CANONICAL_SKILLS_DIR = getCanonicalSkillsDir();
+var AGENTS_MCP_DIR = getAgentsMcpDir();
+var AGENTS_MCP_SERVERS_PATH = getAgentsMcpServersPath();
+var AGENTS_CONFIG_PATH = getAgentsConfigPath();
+
+// src/core/lock-utils.ts
 var LOCK_GUARD_PATH = `${LOCK_FILE_PATH}.lock`;
 function sleep(ms) {
   return new Promise((resolve3) => setTimeout(resolve3, ms));
@@ -3238,10 +3252,10 @@ export {
   resetDetectionCache,
   parseSource,
   isMarketplaceScoped,
-  CANONICAL_SKILLS_DIR,
   installSkill,
   removeSkill,
   listCanonicalSkills,
+  CANONICAL_SKILLS_DIR,
   readLockFile,
   recordSkillInstall,
   removeSkillFromLock,
@@ -3307,4 +3321,4 @@ export {
   updateInstructionsSingleOperation,
   configureProviderGlobalAndProject
 };
-//# sourceMappingURL=chunk-YCSZGZ5W.js.map
+//# sourceMappingURL=chunk-762HFAUU.js.map