@iowarp/clio-coder 0.4.2 → 0.4.4

package/dist/{chunk-O3YUNJZ2.js → chunk-2ZSONWVL.js}

@@ -8,29 +8,29 @@ import {
   readRootEntries,
   splitYamlFrontmatter,
   stringField
-} from "./chunk-XGDPUNND.js";
+} from "./chunk-YECAMM3D.js";
 import {
   enabledExtensionResourceRoots
-} from "./chunk-HLAFFSEK.js";
+} from "./chunk-TQAHXW6Y.js";
 import {
   ToolNames
-} from "./chunk-K6BSR66V.js";
+} from "./chunk-4NSRCOYP.js";
 import {
   INTEROP_AGENT_KINDS,
   interopSourceRank
-} from "./chunk-IHXBNWMM.js";
+} from "./chunk-KXDSS5WJ.js";
 import {
   warnLegacyNaming
 } from "./chunk-D7E7WCDF.js";
 import {
   resolvePackageRoot
 } from "./chunk-IWHMRKLL.js";
-import {
-  clioConfigDir
-} from "./chunk-BYP5D4HI.js";
 import {
   fsyncDirectory
 } from "./chunk-WEPFGWHJ.js";
+import {
+  clioConfigDir
+} from "./chunk-BYP5D4HI.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -123,6 +123,12 @@ function parseMarketplaceIndex(indexPath, diagnostics = []) {
       }
       const kind = record.kind === "agent" || record.kind === "prompt" || record.kind === "fleet" ? record.kind : "skill";
       const requires = Array.isArray(record.requires) ? record.requires.filter((entry) => typeof entry === "string") : void 0;
+      const overlay = optionalString(record.overlay);
+      if (overlay && (path.isAbsolute(overlay) || overlay.split("/").includes(".."))) {
+        diagnostics.push(`skill marketplace index entry has an overlay outside the package: ${skill.name}`);
+        return [];
+      }
+      const exclude = optionalTriggerList(record.exclude);
       return [
         {
           kind,
@@ -134,6 +140,8 @@ function parseMarketplaceIndex(indexPath, diagnostics = []) {
           ...category ? { category } : {},
           ...triggers ? { triggers } : {},
           ...requires ? { requires } : {},
+          ...overlay ? { overlay } : {},
+          ...exclude ? { exclude } : {},
           origin: "index"
         }
       ];
@@ -205,22 +213,22 @@ function discoverMarketplaceSkills(options = {}) {
   const diagnostics = [];
   const skills = [];
   const seen = /* @__PURE__ */ new Set();
+  const indexPath = options.indexPath === null ? null : options.indexPath ?? process.env.CLIO_CODER_SKILL_MARKETPLACE_INDEX ?? null;
+  const resolvedIndexPath = indexPath ?? defaultIndexPath();
+  const indexSkills = options.indexPath !== null && resolvedIndexPath && existsSync(resolvedIndexPath) ? parseMarketplaceIndex(resolvedIndexPath, diagnostics) : [];
+  const overlayNames = new Set(indexSkills.filter((skill) => skill.overlay).map((skill) => skill.name));
   const catalogDir = resolveCatalogDir(options);
   if (catalogDir) {
     for (const skill of catalogSkills(catalogDir, diagnostics)) {
-      if (seen.has(skill.name)) continue;
+      if (seen.has(skill.name) || overlayNames.has(skill.name)) continue;
       seen.add(skill.name);
       skills.push(skill);
     }
   }
-  const indexPath = options.indexPath === null ? null : options.indexPath ?? process.env.CLIO_CODER_SKILL_MARKETPLACE_INDEX ?? null;
-  const resolvedIndexPath = indexPath ?? defaultIndexPath();
-  if (options.indexPath !== null && resolvedIndexPath && existsSync(resolvedIndexPath)) {
-    for (const skill of parseMarketplaceIndex(resolvedIndexPath, diagnostics)) {
-      if (seen.has(skill.name)) continue;
-      seen.add(skill.name);
-      skills.push(skill);
-    }
+  for (const skill of indexSkills) {
+    if (seen.has(skill.name)) continue;
+    seen.add(skill.name);
+    skills.push(skill);
   }
   if (skills.length === 0 && diagnostics.length === 0) {
     diagnostics.push(MARKETPLACE_UNCONFIGURED);
@@ -230,6 +238,21 @@ function discoverMarketplaceSkills(options = {}) {
 function getMarketplaceSkills(options = {}) {
   return discoverMarketplaceSkills(options).skills;
 }
+function marketplaceInstallShaping(skill) {
+  const shaping = {};
+  if (skill.overlay) shaping.overlay = path.join(resolvePackageRoot(), skill.overlay);
+  if (skill.exclude && skill.exclude.length > 0) shaping.exclude = [...skill.exclude];
+  return shaping;
+}
+function resolveMarketplaceShaping(options = {}) {
+  return (installed) => {
+    const entry = getMarketplaceSkills(options).find(
+      (skill) => skill.name === installed.name && skill.sourceUrl === installed.sourceUrl
+    );
+    if (!entry || !entry.overlay && !entry.exclude) return void 0;
+    return marketplaceInstallShaping(entry);
+  };
+}
 function installSkill(input) {
   const requested = input.source.trim();
   const source = requested === "clio-dev" ? "clio-coder-dev" : requested === "clio-test" ? "clio-coder-test" : requested;
@@ -242,7 +265,7 @@ function installSkill(input) {
     if (!skill) {
       throw new Error(`"${source}" is neither an existing local path nor available in the local marketplace`);
     }
-    return installSkillFromSource({ ...input, source: skill.sourceUrl });
+    return installSkillFromSource({ ...input, ...marketplaceInstallShaping(skill), source: skill.sourceUrl });
   }
   return installSkillFromSource({ ...input, source });
 }
@@ -810,6 +833,7 @@ function skillCatalogValidity(list) {
   if (list.items.length === 0) return { ok: false, reason: "no-skills" };
   return { ok: true, reason: null };
 }
+var SKILL_SURFACE_CLEAR_ARG = "off";
 function parseSkillCommand(input) {
   const trimmed = input.trim();
   if (!trimmed.startsWith("/skill ")) return null;
@@ -1025,16 +1049,40 @@ function fetchSource(spec) {
     throw err instanceof Error ? err : new Error(String(err));
   }
 }
-function copySkillDir(from, to) {
+function copySkillDir(from, to, exclude = []) {
   mkdirSync(path3.dirname(to), { recursive: true });
+  const excluded = new Set(exclude);
   cpSync(from, to, {
     recursive: true,
     filter: (source) => {
       const base = path3.basename(source);
-      return base !== ".git" && base !== "node_modules";
+      if (base === ".git" || base === "node_modules") return false;
+      return !(excluded.size > 0 && path3.dirname(source) === from && excluded.has(base));
     }
   });
 }
+function shapeSource(fetched, shaping) {
+  const exclude = shaping.exclude ?? [];
+  if (!shaping.overlay && exclude.length === 0) return fetched;
+  if (shaping.overlay && !existsSync3(shaping.overlay)) {
+    fetched.cleanup();
+    throw new Error(`skill overlay directory does not exist: ${shaping.overlay}`);
+  }
+  const tmp = mkdtempSync(path3.join(tmpdir(), "clio-coder-skill-shape-"));
+  const shaped = path3.join(tmp, "skill");
+  const cleanup = () => {
+    rmSync(tmp, { recursive: true, force: true });
+    fetched.cleanup();
+  };
+  try {
+    copySkillDir(fetched.skillDir, shaped, exclude);
+    if (shaping.overlay) copySkillDir(shaping.overlay, shaped);
+    return { skillDir: resolveSkillDir(shaped), cleanup };
+  } catch (err) {
+    cleanup();
+    throw err instanceof Error ? err : new Error(String(err));
+  }
+}
 var skillSwapSequence = 0;
 function swapSkillDir(stage, dest) {
   const suffix = `${process.pid}-${++skillSwapSequence}`;
@@ -1079,7 +1127,7 @@ function installSkillFromSource(input) {
   if (!spec) throw new Error(`unsupported skill source: ${input.source}`);
   const cwd = input.cwd ?? process.cwd();
   const scope = input.scope ?? "project";
-  const fetched = fetchSource(spec);
+  const fetched = shapeSource(fetchSource(spec), input);
   try {
     const { skill, warnings } = validateSourceSkill(fetched.skillDir);
     const name = (input.name ?? skill.name).trim();
@@ -1126,12 +1174,17 @@ function managedSkills(cwd, configDir) {
     (skill) => skill.source === "clio-coder" && (skill.scope === "user" || skill.scope === "project")
   );
 }
-function updateOne(skill, force) {
+function updateOne(skill, force, shaping = {}) {
   const sourceUrl = skill.provenance?.installUrl;
   if (!sourceUrl) return { name: skill.name, status: "no-source", detail: "no source-url provenance recorded" };
   const spec = parseSkillSourceSpec(sourceUrl);
   if (!spec) return { name: skill.name, status: "error", detail: `unsupported source-url: ${sourceUrl}` };
-  const fetched = fetchSource(spec);
+  let fetched;
+  try {
+    fetched = shapeSource(fetchSource(spec), shaping);
+  } catch (err) {
+    return { name: skill.name, status: "error", detail: err instanceof Error ? err.message : String(err) };
+  }
   try {
     validateSourceSkill(fetched.skillDir);
     const remoteFile = path3.join(fetched.skillDir, "SKILL.md");
@@ -1172,13 +1225,14 @@ function updateOne(skill, force) {
 function updateSkills(input = {}) {
   const cwd = input.cwd ?? process.cwd();
   const skills = managedSkills(cwd, input.configDir);
+  const shapingFor = (skill) => skill.provenance?.installUrl && input.resolveShaping?.({ name: skill.name, sourceUrl: skill.provenance.installUrl }) || {};
   if (input.name) {
     const skill = skills.find((entry) => entry.name === input.name);
     if (!skill) return [{ name: input.name, status: "error", detail: "not found in Clio-managed skill roots" }];
-    return [updateOne(skill, input.force === true)];
+    return [updateOne(skill, input.force === true, shapingFor(skill))];
   }
   if (input.all !== true) throw new Error("updateSkills requires a name or all=true");
-  return skills.filter((skill) => skill.provenance?.installUrl).map((skill) => updateOne(skill, input.force === true));
+  return skills.filter((skill) => skill.provenance?.installUrl).map((skill) => updateOne(skill, input.force === true, shapingFor(skill)));
 }
 
 export {
@@ -1187,14 +1241,17 @@ export {
   MARKETPLACE_UNCONFIGURED,
   discoverMarketplaceSkills,
   getMarketplaceSkills,
+  marketplaceInstallShaping,
+  resolveMarketplaceShaping,
   installSkill,
   projectCompatTrusted,
   defaultSkillRoots,
   loadSkills,
   modelVisibleSkills,
   skillCatalogValidity,
+  SKILL_SURFACE_CLEAR_ARG,
   parseSkillCommand,
   expandSkillInvocationInput,
   parsePendingSkillRequests
 };
-//# sourceMappingURL=chunk-O3YUNJZ2.js.map
+//# sourceMappingURL=chunk-2ZSONWVL.js.map