@cleocode/caamp 1.0.4 → 1.1.0

package/dist/cli.js

@@ -65,7 +65,7 @@ import {
   tokenizeCriteriaValue,
   updateInstructionsSingleOperation,
   validateSkill
-} from "./chunk-HUMRYJPE.js";
+} from "./chunk-KAJJ6L6H.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -120,7 +120,7 @@ function baseMeta(operation, mvi) {
     contextVersion: 0
   };
 }
-function emitSuccess(operation, result, mvi = true) {
+function emitSuccess(operation, result, mvi = "standard") {
   const envelope = {
     $schema: "https://lafs.dev/schemas/v1/envelope.schema.json",
     _meta: {
@@ -133,7 +133,7 @@ function emitSuccess(operation, result, mvi = true) {
   };
   console.log(JSON.stringify(envelope, null, 2));
 }
-function emitError(operation, error, mvi = true) {
+function emitError(operation, error, mvi = "standard") {
   let envelope;
   if (error instanceof LAFSCommandError) {
     envelope = {
@@ -362,7 +362,7 @@ async function readTextInput(inlineContent, filePath) {
 
 // src/commands/advanced/providers.ts
 function registerAdvancedProviders(parent) {
-  parent.command("providers").description("Select providers by priority using advanced wrapper logic").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--details", "Include full provider objects").action(async (opts) => runLafsCommand("advanced.providers", !opts.details, async () => {
+  parent.command("providers").description("Select providers by priority using advanced wrapper logic").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--details", "Include full provider objects").action(async (opts) => runLafsCommand("advanced.providers", opts.details ? "full" : "standard", async () => {
     const providers = resolveProviders({ all: opts.all, agent: opts.agent });
     const minTier = parsePriority(opts.minTier);
     const selected = selectProvidersByMinimumPriority(providers, minTier);
@@ -388,7 +388,7 @@ function registerAdvancedProviders(parent) {
 
 // src/commands/advanced/batch.ts
 function registerAdvancedBatch(parent) {
-  parent.command("batch").description("Run rollback-capable batch install for MCP + skills").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--mcp-file <path>", "JSON file containing McpBatchOperation[]").option("--skills-file <path>", "JSON file containing SkillBatchOperation[]").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include detailed operation result").action(async (opts) => runLafsCommand("advanced.batch", !opts.details, async () => {
+  parent.command("batch").description("Run rollback-capable batch install for MCP + skills").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--mcp-file <path>", "JSON file containing McpBatchOperation[]").option("--skills-file <path>", "JSON file containing SkillBatchOperation[]").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include detailed operation result").action(async (opts) => runLafsCommand("advanced.batch", opts.details ? "full" : "standard", async () => {
     const baseProviders = resolveProviders({ all: opts.all, agent: opts.agent });
     const minimumPriority = parsePriority(opts.minTier);
     const providers = selectProvidersByMinimumPriority(baseProviders, minimumPriority);
@@ -448,7 +448,7 @@ function registerAdvancedBatch(parent) {
 
 // src/commands/advanced/conflicts.ts
 function registerAdvancedConflicts(parent) {
-  parent.command("conflicts").description("Preflight MCP conflict detection across providers").requiredOption("--mcp-file <path>", "JSON file containing McpBatchOperation[]").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include full conflict list").action(async (opts) => runLafsCommand("advanced.conflicts", !opts.details, async () => {
+  parent.command("conflicts").description("Preflight MCP conflict detection across providers").requiredOption("--mcp-file <path>", "JSON file containing McpBatchOperation[]").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include full conflict list").action(async (opts) => runLafsCommand("advanced.conflicts", opts.details ? "full" : "standard", async () => {
     const baseProviders = resolveProviders({ all: opts.all, agent: opts.agent });
     const minimumPriority = parsePriority(opts.minTier);
     const providers = selectProvidersByMinimumPriority(baseProviders, minimumPriority);
@@ -501,7 +501,7 @@ function parsePolicy(value) {
   return value;
 }
 function registerAdvancedApply(parent) {
-  parent.command("apply").description("Apply MCP operations with configurable conflict policy").requiredOption("--mcp-file <path>", "JSON file containing McpBatchOperation[]").option("--policy <policy>", "Conflict policy: fail|skip|overwrite", "fail").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include detailed apply result").action(async (opts) => runLafsCommand("advanced.apply", !opts.details, async () => {
+  parent.command("apply").description("Apply MCP operations with configurable conflict policy").requiredOption("--mcp-file <path>", "JSON file containing McpBatchOperation[]").option("--policy <policy>", "Conflict policy: fail|skip|overwrite", "fail").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include detailed apply result").action(async (opts) => runLafsCommand("advanced.apply", opts.details ? "full" : "standard", async () => {
     const baseProviders = resolveProviders({ all: opts.all, agent: opts.agent });
     const minimumPriority = parsePriority(opts.minTier);
     const providers = selectProvidersByMinimumPriority(baseProviders, minimumPriority);
@@ -562,7 +562,7 @@ function registerAdvancedApply(parent) {
 
 // src/commands/advanced/instructions.ts
 function registerAdvancedInstructions(parent) {
-  parent.command("instructions").description("Single-operation instruction update across providers").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--scope <scope>", "Instruction scope: project|global", "project").option("--content <text>", "Inline content to inject").option("--content-file <path>", "File containing content to inject").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include detailed per-file actions").action(async (opts) => runLafsCommand("advanced.instructions", !opts.details, async () => {
+  parent.command("instructions").description("Single-operation instruction update across providers").option("-a, --agent <name>", "Target specific provider(s)", (v, prev) => [...prev, v], []).option("--all", "Use all registry providers (not only detected)").option("--min-tier <tier>", "Minimum priority tier: high|medium|low", "low").option("--scope <scope>", "Instruction scope: project|global", "project").option("--content <text>", "Inline content to inject").option("--content-file <path>", "File containing content to inject").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include detailed per-file actions").action(async (opts) => runLafsCommand("advanced.instructions", opts.details ? "full" : "standard", async () => {
     const minimumPriority = parsePriority(opts.minTier);
     const baseProviders = resolveProviders({ all: opts.all, agent: opts.agent });
     const providers = selectProvidersByMinimumPriority(baseProviders, minimumPriority);
@@ -618,7 +618,7 @@ function registerAdvancedInstructions(parent) {
 
 // src/commands/advanced/configure.ts
 function registerAdvancedConfigure(parent) {
-  parent.command("configure").description("Configure global + project scope for one provider in one operation").requiredOption("-a, --agent <name>", "Target provider ID or alias").option("--global-mcp-file <path>", "JSON file for global MCP operations").option("--project-mcp-file <path>", "JSON file for project MCP operations").option("--instruction <text>", "Instruction content for both scopes").option("--instruction-file <path>", "Instruction content file for both scopes").option("--instruction-global <text>", "Instruction content for global scope").option("--instruction-global-file <path>", "Instruction content file for global scope").option("--instruction-project <text>", "Instruction content for project scope").option("--instruction-project-file <path>", "Instruction content file for project scope").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include detailed write results").action(async (opts) => runLafsCommand("advanced.configure", !opts.details, async () => {
+  parent.command("configure").description("Configure global + project scope for one provider in one operation").requiredOption("-a, --agent <name>", "Target provider ID or alias").option("--global-mcp-file <path>", "JSON file for global MCP operations").option("--project-mcp-file <path>", "JSON file for project MCP operations").option("--instruction <text>", "Instruction content for both scopes").option("--instruction-file <path>", "Instruction content file for both scopes").option("--instruction-global <text>", "Instruction content for global scope").option("--instruction-global-file <path>", "Instruction content file for global scope").option("--instruction-project <text>", "Instruction content for project scope").option("--instruction-project-file <path>", "Instruction content file for project scope").option("--project-dir <path>", "Project directory to resolve project-scope paths").option("--details", "Include detailed write results").action(async (opts) => runLafsCommand("advanced.configure", opts.details ? "full" : "standard", async () => {
     const provider = getProvider(opts.agent);
     if (!provider) {
       throw new LAFSCommandError(
@@ -2183,7 +2183,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, 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)").option("--json", "Output as JSON (default)").option("--human", "Output in human-readable format").action(async (source, opts) => {
+  parent.command("install").description("Install a skill from GitHub, URL, marketplace, or registered skill library").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 skill library profile (minimal, core, recommended, full)").option("--json", "Output as JSON (default)").option("--human", "Output in human-readable format").action(async (source, opts) => {
     const operation = "skills.install";
     const mvi = "standard";
     let format;
@@ -2292,7 +2292,7 @@ function registerSkillsInstall(parent) {
         }
       } else if (parsed.type === "package") {
         if (!isCatalogAvailable()) {
-          const message = "@cleocode/ct-skills is not installed. Run: npm install @cleocode/ct-skills";
+          const message = "No skill library registered. Register one with registerSkillLibraryFromPath() or set CAAMP_SKILL_LIBRARY env var.";
           if (format === "json") {
             emitJsonError(operation, mvi, ErrorCodes.INVALID_INPUT, message, ErrorCategories.VALIDATION);
           }
@@ -2303,8 +2303,8 @@ function registerSkillsInstall(parent) {
         if (catalogSkill) {
           localPath = getSkillDir(catalogSkill.name);
           skillName = catalogSkill.name;
-          sourceValue = `@cleocode/ct-skills:${catalogSkill.name}`;
-          sourceType = "package";
+          sourceValue = `library:${catalogSkill.name}`;
+          sourceType = "library";
           if (format === "human") {
             console.log(`  Found in catalog: ${pc11.bold(catalogSkill.name)} v${catalogSkill.version} (${pc11.dim(catalogSkill.category)})`);
           }
@@ -2344,7 +2344,7 @@ function registerSkillsInstall(parent) {
         opts.global ?? false
       );
       if (result.success) {
-        const isGlobal = sourceType === "package" ? true : opts.global ?? false;
+        const isGlobal = sourceType === "library" || sourceType === "package" ? true : opts.global ?? false;
         await recordSkillInstall(
           skillName,
           sourceValue,
@@ -2423,7 +2423,7 @@ function registerSkillsInstall(parent) {
 }
 async function handleProfileInstall(profileName, providers, isGlobal, format, operation, mvi) {
   if (!isCatalogAvailable()) {
-    const message = "@cleocode/ct-skills is not installed. Run: npm install @cleocode/ct-skills";
+    const message = "No skill library registered. Register one with registerSkillLibraryFromPath() or set CAAMP_SKILL_LIBRARY env var.";
     if (format === "json") {
       emitError2(operation, mvi, ErrorCodes.INVALID_INPUT, message, ErrorCategories.VALIDATION);
     }
@@ -2466,16 +2466,16 @@ async function handleProfileInstall(profileName, providers, isGlobal, format, op
         }
         await recordSkillInstall(
           name,
-          `@cleocode/ct-skills:${name}`,
-          `@cleocode/ct-skills:${name}`,
-          "package",
+          `library:${name}`,
+          `library:${name}`,
+          "library",
           result.linkedAgents,
           result.canonicalPath,
           true
         );
         installed.push({
           name,
-          scopedName: `@cleocode/ct-skills:${name}`,
+          scopedName: `library:${name}`,
           canonicalPath: result.canonicalPath,
           providers: result.linkedAgents
         });
@@ -2814,7 +2814,7 @@ function registerSkillsFind(parent) {
   parent.command("find").description("Search marketplace for skills").argument("[query]", "Search query").option("--recommend", "Recommend skills from constraints").option("--top <n>", "Number of recommendation candidates", "3").option("--must-have <term>", "Required criteria term", (value, previous) => [...previous, value], []).option("--prefer <term>", "Preferred criteria term", (value, previous) => [...previous, value], []).option("--exclude <term>", "Excluded criteria term", (value, previous) => [...previous, value], []).option("--details", "Include expanded machine output").option("--human", "Force human-readable output").option("--json", "Output as JSON").option("--select <indexes>", "Pre-select recommendation ranks (comma-separated)").option("-l, --limit <n>", "Max results", "20").action(async (query, opts) => {
     const operation = opts.recommend ? "skills.find.recommend" : "skills.find.search";
     const details = Boolean(opts.details);
-    const mvi = !details;
+    const mvi = details ? "full" : "standard";
     let format;
     try {
       format = resolveOutputFormat4({