@claude-collective/cli 0.25.1 → 0.26.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.26.0] - 2026-02-13
+
+### Added
+
+- **Plugin-aware agent compilation** — `compileAgentForPlugin()` accepts `installMode` parameter. When `"plugin"`, emits fully-qualified `PluginSkillRef` format (`skill-id:skill-id`) in both preloaded frontmatter and dynamic skill invocations. New `PluginSkillRef` template literal type enforces the format at compile time.
+- **Stacks from source** — Source loader loads `config/stacks.yaml` from the marketplace source repository before falling back to the CLI's built-in stacks. Private marketplaces can now define custom stack configurations visible to consumers.
+- **Individual skill plugin installation** — New `installIndividualPlugins()` in `cc init` installs each selected skill as a native Claude Code plugin via `claude plugin install {id}@{marketplace}` when Plugin Mode is used without a stack.
+- **Plugin-aware edit flow** — `cc edit` installs new skill plugins and uninstalls removed ones when in Plugin Mode with a marketplace. Uses non-fatal warnings for individual install failures.
+- **Agent plugin compiler** — New `agent-plugin-compiler.ts` compiles agent partials into standalone Claude Code plugins. `cc build plugins --agents-dir` flag enables building agent plugins alongside skill plugins.
+- **Shared plugin versioning** — Content-hash version bumping utilities extracted to `versioning.ts` and shared across skill, agent, and stack plugin compilers.
+- **Marketplace creation guide** — `docs/creating-a-marketplace.md` covers manual and automated marketplace creation, consumer installation flow, and private repo authentication.
+- **Marketplace migration guide** — `docs/migrate-to-marketplace.md` with step-by-step instructions for converting an existing CC repo into a publishable marketplace.
+
+### Changed
+
+- **Plugin names match skill IDs** — `SKILL_PLUGIN_PREFIX` changed from `"skill-"` to `""`. Plugin names are now bare skill IDs (e.g., `web-framework-react` instead of `skill-web-framework-react`). Marketplace generator category patterns updated to match unprefixed names.
+- **`installMode` threaded through compilation** — `installMode` flows from `wizardResult.installMode` through `local-installer.ts` and from `projectConfig.installMode` through `agent-recompiler.ts` to `compileAgentForPlugin()`.
+
 ## [0.25.1] - 2026-02-13
 
 ### Changed

package/dist/{chunk-MH66WDFV.js → chunk-4357L7VK.js}

@@ -12,7 +12,7 @@ import {
   resolveAlias,
   resolveAllSources,
   searchExtraSources
-} from "./chunk-YDBSSAJ6.js";
+} from "./chunk-ETQ3BPGU.js";
 import {
   warn
 } from "./chunk-ZDREFYD2.js";
@@ -248,4 +248,4 @@ var StepSources = ({
 export {
   StepSources
 };
-//# sourceMappingURL=chunk-MH66WDFV.js.map
+//# sourceMappingURL=chunk-4357L7VK.js.map

package/dist/{chunk-4WGN6SUE.js → chunk-7UPXT32F.js}

@@ -7,7 +7,7 @@ import {
   addSource,
   getSourceSummary,
   removeSource
-} from "./chunk-YDBSSAJ6.js";
+} from "./chunk-ETQ3BPGU.js";
 import {
   init_esm_shims
 } from "./chunk-AWKZ5BDL.js";
@@ -194,4 +194,4 @@ var StepSettings = ({ projectDir, onClose }) => {
 export {
   StepSettings
 };
-//# sourceMappingURL=chunk-4WGN6SUE.js.map
+//# sourceMappingURL=chunk-7UPXT32F.js.map

package/dist/{chunk-YDBSSAJ6.js → chunk-ETQ3BPGU.js}

@@ -279,6 +279,59 @@ async function hashSkillFolder(skillPath) {
   const combined = contents.join("\n---\n");
   return hashString(combined);
 }
+var CONTENT_HASH_FILE = ".content-hash";
+function parseMajorVersion(version) {
+  const match = version.match(/^(\d+)\./);
+  return match ? parseInt(match[1], 10) : 1;
+}
+function bumpMajorVersion(version) {
+  const major = parseMajorVersion(version);
+  return `${major + 1}.0.0`;
+}
+async function readExistingPluginManifest(pluginDir, getManifestPath) {
+  const manifestPath = getManifestPath(pluginDir);
+  if (!await fileExists(manifestPath)) {
+    return null;
+  }
+  try {
+    const content = await readFile(manifestPath);
+    const manifest = pluginManifestSchema.parse(JSON.parse(content));
+    const hashFilePath = manifestPath.replace("plugin.json", CONTENT_HASH_FILE);
+    let contentHash;
+    if (await fileExists(hashFilePath)) {
+      contentHash = (await readFile(hashFilePath)).trim();
+    }
+    return {
+      version: manifest.version ?? DEFAULT_VERSION,
+      contentHash
+    };
+  } catch {
+    return null;
+  }
+}
+async function determinePluginVersion(newHash, pluginDir, getManifestPath) {
+  const existing = await readExistingPluginManifest(pluginDir, getManifestPath);
+  if (!existing) {
+    return {
+      version: DEFAULT_VERSION,
+      contentHash: newHash
+    };
+  }
+  if (existing.contentHash !== newHash) {
+    return {
+      version: bumpMajorVersion(existing.version),
+      contentHash: newHash
+    };
+  }
+  return {
+    version: existing.version,
+    contentHash: newHash
+  };
+}
+async function writeContentHash(pluginDir, contentHash, getManifestPath) {
+  const hashFilePath = getManifestPath(pluginDir).replace("plugin.json", CONTENT_HASH_FILE);
+  await writeFile(hashFilePath, contentHash);
+}
 
 // src/cli/lib/skills/skill-metadata.ts
 async function readForkedFromMetadata(skillDir) {
@@ -1422,7 +1475,8 @@ init_esm_shims();
 import path7 from "path";
 var PLUGIN_DIR_NAME = ".claude-plugin";
 var PLUGIN_MANIFEST_FILE2 = "plugin.json";
-var SKILL_PLUGIN_PREFIX = "skill-";
+var SKILL_PLUGIN_PREFIX = "";
+var AGENT_PLUGIN_PREFIX = "agent-";
 function buildAuthor(name, email) {
   if (!name) {
     return void 0;
@@ -1451,6 +1505,17 @@ function generateSkillPluginManifest(options) {
   }
   return manifest;
 }
+function generateAgentPluginManifest(options) {
+  const manifest = {
+    name: `${AGENT_PLUGIN_PREFIX}${options.agentName}`,
+    version: options.version ?? DEFAULT_VERSION,
+    agents: "./agents/"
+  };
+  if (options.description) {
+    manifest.description = options.description;
+  }
+  return manifest;
+}
 function generateStackPluginManifest(options) {
   const manifest = {
     name: options.stackName,
@@ -1870,36 +1935,6 @@ async function createLiquidEngine(projectDir) {
 
 // src/cli/lib/stacks/stack-plugin-compiler.ts
 import { unique as unique2 } from "remeda";
-var CONTENT_HASH_FILE = ".content-hash";
-function parseMajorVersion(version) {
-  const match = version.match(/^(\d+)\./);
-  return match ? parseInt(match[1], 10) : 1;
-}
-function bumpMajorVersion(version) {
-  const major = parseMajorVersion(version);
-  return `${major + 1}.0.0`;
-}
-async function readExistingManifest(pluginDir) {
-  const manifestPath = getPluginManifestPath(pluginDir);
-  if (!await fileExists(manifestPath)) {
-    return null;
-  }
-  try {
-    const content = await readFile(manifestPath);
-    const manifest = pluginManifestSchema.parse(JSON.parse(content));
-    const hashFilePath = manifestPath.replace("plugin.json", CONTENT_HASH_FILE);
-    let contentHash;
-    if (await fileExists(hashFilePath)) {
-      contentHash = (await readFile(hashFilePath)).trim();
-    }
-    return {
-      version: manifest.version ?? DEFAULT_VERSION,
-      contentHash
-    };
-  } catch {
-    return null;
-  }
-}
 function hashStackConfig(stack) {
   const stackSkillIds = stack.stack ? [...new Set(Object.values(stack.stack).flatMap((a) => Object.values(a)))].sort() : [];
   const parts = [
@@ -1910,27 +1945,7 @@ function hashStackConfig(stack) {
   ];
   return hashString(parts.join("\n"));
 }
-async function determineStackVersion(stack, pluginDir) {
-  const newHash = hashStackConfig(stack);
-  const existing = await readExistingManifest(pluginDir);
-  if (!existing) {
-    return {
-      version: DEFAULT_VERSION,
-      contentHash: newHash
-    };
-  }
-  if (existing.contentHash !== newHash) {
-    return {
-      version: bumpMajorVersion(existing.version),
-      contentHash: newHash
-    };
-  }
-  return {
-    version: existing.version,
-    contentHash: newHash
-  };
-}
-async function compileAgentForPlugin(name, agent, fallbackRoot, engine) {
+async function compileAgentForPlugin(name, agent, fallbackRoot, engine, installMode) {
   verbose(`Compiling agent: ${name}`);
   const agentSourceRoot = agent.sourceRoot || fallbackRoot;
   const agentBaseDir = agent.agentBaseDir || DIRS.agents;
@@ -1956,9 +1971,10 @@ async function compileAgentForPlugin(name, agent, fallbackRoot, engine) {
   if (!outputFormat) {
     outputFormat = await readFileOptional(path13.join(categoryDir, "output-format.md"), "");
   }
-  const preloadedSkills = agent.skills.filter((s) => s.preloaded);
-  const dynamicSkills = agent.skills.filter((s) => !s.preloaded);
-  const preloadedSkillIds = preloadedSkills.map((s) => s.id);
+  const skills = installMode === "plugin" ? agent.skills.map((s) => ({ ...s, pluginRef: `${s.id}:${s.id}` })) : agent.skills;
+  const preloadedSkills = skills.filter((s) => s.preloaded);
+  const dynamicSkills = skills.filter((s) => !s.preloaded);
+  const preloadedSkillIds = preloadedSkills.map((s) => s.pluginRef ?? s.id);
   verbose(
     `Skills for ${name}: ${preloadedSkills.length} preloaded, ${dynamicSkills.length} dynamic`
   );
@@ -1970,7 +1986,7 @@ async function compileAgentForPlugin(name, agent, fallbackRoot, engine) {
     criticalRequirementsTop,
     criticalReminders,
     outputFormat,
-    skills: agent.skills,
+    skills,
     preloadedSkills,
     dynamicSkills,
     preloadedSkillIds
@@ -2078,7 +2094,7 @@ async function compileStackPlugin(options) {
   const pluginSkillsDir = path13.join(pluginDir, "skills");
   await ensureDir(pluginSkillsDir);
   const copiedSourcePaths = /* @__PURE__ */ new Set();
-  for (const [, resolvedSkill] of Object.entries(skills)) {
+  for (const resolvedSkill of Object.values(skills)) {
     const sourceSkillDir = path13.join(projectRoot, resolvedSkill.path);
     if (copiedSourcePaths.has(resolvedSkill.path)) {
       continue;
@@ -2111,7 +2127,12 @@ async function compileStackPlugin(options) {
     await writeFile(path13.join(pluginDir, "CLAUDE.md"), claudeContent);
     verbose(`  Copied CLAUDE.md`);
   }
-  const { version, contentHash } = await determineStackVersion(stack, pluginDir);
+  const newHash = hashStackConfig(stack);
+  const { version, contentHash } = await determinePluginVersion(
+    newHash,
+    pluginDir,
+    getPluginManifestPath
+  );
   const uniqueSkillPlugins = unique2(allSkillPlugins);
   const manifest = generateStackPluginManifest({
     stackName: stackId,
@@ -2124,8 +2145,7 @@ async function compileStackPlugin(options) {
     hasSkills: true
   });
   await writePluginManifest(pluginDir, manifest);
-  const hashFilePath = getPluginManifestPath(pluginDir).replace("plugin.json", CONTENT_HASH_FILE);
-  await writeFile(hashFilePath, contentHash);
+  await writeContentHash(pluginDir, contentHash, getPluginManifestPath);
   verbose(`  Wrote plugin.json (v${version})`);
   const readme = generateStackReadme(stackId, stack, compiledAgentNames, uniqueSkillPlugins);
   await writeFile(path13.join(pluginDir, "README.md"), readme);
@@ -2340,7 +2360,13 @@ function buildLocalSkillsMap(copiedSkills, matrix) {
   return localSkillsForResolution;
 }
 async function buildLocalConfig(wizardResult, sourceResult) {
-  const loadedStack = wizardResult.selectedStackId ? await loadStackById(wizardResult.selectedStackId, PROJECT_ROOT) : null;
+  let loadedStack = null;
+  if (wizardResult.selectedStackId) {
+    loadedStack = await loadStackById(wizardResult.selectedStackId, sourceResult.sourcePath);
+    if (!loadedStack) {
+      loadedStack = await loadStackById(wizardResult.selectedStackId, PROJECT_ROOT);
+    }
+  }
   let localConfig;
   if (wizardResult.selectedStackId) {
     if (loadedStack) {
@@ -2392,7 +2418,7 @@ function buildCompileAgents(config, agents) {
   }
   return compileAgents;
 }
-async function compileAndWriteAgents(compileConfig, agents, localSkills, sourceResult, projectDir, agentsDir) {
+async function compileAndWriteAgents(compileConfig, agents, localSkills, sourceResult, projectDir, agentsDir, installMode) {
   const engine = await createLiquidEngine(projectDir);
   const resolvedAgents = await resolveAgents(
     agents,
@@ -2402,7 +2428,13 @@ async function compileAndWriteAgents(compileConfig, agents, localSkills, sourceR
   );
   const compiledAgentNames = [];
   for (const [name, agent] of typedEntries(resolvedAgents)) {
-    const output = await compileAgentForPlugin(name, agent, sourceResult.sourcePath, engine);
+    const output = await compileAgentForPlugin(
+      name,
+      agent,
+      sourceResult.sourcePath,
+      engine,
+      installMode
+    );
     await writeFile(path15.join(agentsDir, `${name}.md`), output);
     compiledAgentNames.push(name);
   }
@@ -2455,7 +2487,8 @@ async function installLocal(options) {
     localSkillsForResolution,
     sourceResult,
     projectDir,
-    localAgentsDir
+    localAgentsDir,
+    wizardResult.installMode
   );
   return {
     copiedSkills,
@@ -3112,12 +3145,14 @@ async function loadFromLocal(source, sourceConfig) {
   const matrix = await loadSkillsMatrix(matrixPath);
   const skills = await extractAllSkills(skillsDir);
   const mergedMatrix = await mergeMatrixWithSkills(matrix, skills);
-  const stacks = await loadStacks(PROJECT_ROOT);
+  const sourceStacks = await loadStacks(skillsPath);
+  const stacks = sourceStacks.length > 0 ? sourceStacks : await loadStacks(PROJECT_ROOT);
   if (stacks.length > 0) {
     mergedMatrix.suggestedStacks = stacks.map(
       (stack) => stackToResolvedStack(stack, mergedMatrix.displayNameToId)
     );
-    verbose(`Loaded ${stacks.length} stacks from config/stacks.yaml`);
+    const stackSource = sourceStacks.length > 0 ? "source" : "CLI";
+    verbose(`Loaded ${stacks.length} stacks from ${stackSource}`);
   }
   return {
     matrix: mergedMatrix,
@@ -3146,12 +3181,14 @@ async function loadFromRemote(source, sourceConfig, forceRefresh) {
   const matrix = await loadSkillsMatrix(matrixPath);
   const skills = await extractAllSkills(skillsDir);
   const mergedMatrix = await mergeMatrixWithSkills(matrix, skills);
-  const stacks = await loadStacks(PROJECT_ROOT);
+  const sourceStacks = await loadStacks(fetchResult.path);
+  const stacks = sourceStacks.length > 0 ? sourceStacks : await loadStacks(PROJECT_ROOT);
   if (stacks.length > 0) {
     mergedMatrix.suggestedStacks = stacks.map(
       (stack) => stackToResolvedStack(stack, mergedMatrix.displayNameToId)
     );
-    verbose(`Loaded ${stacks.length} stacks from config/stacks.yaml`);
+    const stackSource = sourceStacks.length > 0 ? "source" : "CLI";
+    verbose(`Loaded ${stacks.length} stacks from ${stackSource}`);
   }
   return {
     matrix: mergedMatrix,
@@ -3372,56 +3409,6 @@ var SKILL_DIRS = ["examples", "scripts"];
 function sanitizeSkillName(name) {
   return name.replace(/\+/g, "-");
 }
-function parseMajorVersion2(version) {
-  const match = version.match(/^(\d+)\./);
-  return match ? parseInt(match[1], 10) : 1;
-}
-function bumpMajorVersion2(version) {
-  const major = parseMajorVersion2(version);
-  return `${major + 1}.0.0`;
-}
-var CONTENT_HASH_FILE2 = ".content-hash";
-async function readExistingManifest2(pluginDir) {
-  const manifestPath = getPluginManifestPath(pluginDir);
-  if (!await fileExists(manifestPath)) {
-    return null;
-  }
-  try {
-    const content = await readFile(manifestPath);
-    const manifest = pluginManifestSchema.parse(JSON.parse(content));
-    const hashFilePath = manifestPath.replace("plugin.json", CONTENT_HASH_FILE2);
-    let contentHash;
-    if (await fileExists(hashFilePath)) {
-      contentHash = (await readFile(hashFilePath)).trim();
-    }
-    return {
-      version: manifest.version ?? DEFAULT_VERSION,
-      contentHash
-    };
-  } catch {
-    return null;
-  }
-}
-async function determineVersion(skillPath, pluginDir) {
-  const newHash = await hashSkillFolder(skillPath);
-  const existing = await readExistingManifest2(pluginDir);
-  if (!existing) {
-    return {
-      version: DEFAULT_VERSION,
-      contentHash: newHash
-    };
-  }
-  if (existing.contentHash !== newHash) {
-    return {
-      version: bumpMajorVersion2(existing.version),
-      contentHash: newHash
-    };
-  }
-  return {
-    version: existing.version,
-    contentHash: newHash
-  };
-}
 async function readSkillMetadata(skillPath) {
   const metadataPath = path20.join(skillPath, "metadata.yaml");
   if (!await fileExists(metadataPath)) {
@@ -3462,7 +3449,7 @@ function generateReadme(skillName, frontmatter, metadata) {
   lines.push("");
   lines.push("```json");
   lines.push(`{`);
-  lines.push(`  "plugins": ["skill-${skillName}"]`);
+  lines.push(`  "plugins": ["${skillName}"]`);
   lines.push(`}`);
   lines.push("```");
   lines.push("");
@@ -3499,11 +3486,16 @@ async function compileSkillPlugin(options) {
   const skillName = overrideName ?? sanitizeSkillName(frontmatter.name);
   verbose(`Compiling skill plugin: ${skillName} from ${skillPath}`);
   const metadata = await readSkillMetadata(skillPath);
-  const pluginDir = path20.join(outputDir, `skill-${skillName}`);
+  const pluginDir = path20.join(outputDir, skillName);
   const skillsDir = path20.join(pluginDir, "skills", skillName);
   await ensureDir(pluginDir);
   await ensureDir(skillsDir);
-  const { version, contentHash } = await determineVersion(skillPath, pluginDir);
+  const newHash = await hashSkillFolder(skillPath);
+  const { version, contentHash } = await determinePluginVersion(
+    newHash,
+    pluginDir,
+    getPluginManifestPath
+  );
   const manifest = generateSkillPluginManifest({
     skillName,
     description: frontmatter.description,
@@ -3512,8 +3504,7 @@ async function compileSkillPlugin(options) {
     keywords: metadata?.tags
   });
   await writePluginManifest(pluginDir, manifest);
-  const hashFilePath = getPluginManifestPath(pluginDir).replace("plugin.json", CONTENT_HASH_FILE2);
-  await writeFile(hashFilePath, contentHash);
+  await writeContentHash(pluginDir, contentHash, getPluginManifestPath);
   verbose(`  Wrote plugin.json for ${skillName} (v${version})`);
   await writeFile(path20.join(skillsDir, "SKILL.md"), skillMdContent);
   verbose(`  Copied SKILL.md`);
@@ -3553,7 +3544,7 @@ async function compileAllSkillPlugins(skillsDir, outputDir) {
         outputDir
       });
       results.push(result);
-      console.log(`  [OK] skill-${result.skillName}`);
+      console.log(`  [OK] ${result.skillName}`);
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       const dirBasename = path20.basename(skillPath);
@@ -3566,7 +3557,7 @@ function printCompilationSummary(results) {
   console.log(`
 Compiled ${results.length} skill plugins:`);
   for (const result of results) {
-    console.log(`  - skill-${result.skillName} (v${result.manifest.version})`);
+    console.log(`  - ${result.skillName} (v${result.manifest.version})`);
   }
 }
 
@@ -4135,6 +4126,8 @@ async function getSourceSummary(projectDir, matrix) {
 }
 
 export {
+  generateAgentPluginManifest,
+  writePluginManifest,
   findPluginManifest,
   getCollectivePluginDir,
   getProjectPluginsDir,
@@ -4153,7 +4146,10 @@ export {
   resolveAuthor,
   resolveAllSources,
   getCurrentDate,
+  hashString,
   hashFile,
+  determinePluginVersion,
+  writeContentHash,
   readForkedFromMetadata,
   compareSkills,
   injectForkedFromMetadata,
@@ -4176,6 +4172,7 @@ export {
   compileAgentForPlugin,
   compileStackPlugin,
   printStackCompilationSummary,
+  claudePluginInstall,
   isClaudeCLIAvailable,
   claudePluginMarketplaceExists,
   claudePluginMarketplaceAdd,
@@ -4204,4 +4201,4 @@ export {
   validateAllPlugins,
   printPluginValidationResult
 };
-//# sourceMappingURL=chunk-YDBSSAJ6.js.map
+//# sourceMappingURL=chunk-ETQ3BPGU.js.map