@skaile/workspaces 5.10.0 → 5.12.0

package/dist/{chunk-YBQONMH2.js → chunk-ID745F3R.js}

@@ -1,26 +1,344 @@
-import { getStoreIdentity, refFor } from './chunk-V7PQZOBR.js';
-import { openLibrary } from './chunk-CLTHEKHR.js';
-import { logErr, logWarn } from './chunk-TRSQP3JD.js';
-import { getKindRegistry } from './chunk-SBFW3CJH.js';
-import { parseFlowDefinition } from './chunk-MGGFBZWA.js';
-import { stampManifestPublisher, upsertManifestAsset, resolveIndexPath, LocalIndex } from './chunk-3BEY4WK3.js';
-import { requiresSyntaxErrors, SEMVER_RE, parseManifestFile } from './chunk-GEWAIQZ5.js';
-import { SKILL_DESCRIPTION_PLACEHOLDER_PREFIX, PRESET_DESCRIPTION_PLACEHOLDER, PRESET_ITEM_PLACEHOLDER_REF, SKILL_BODY_PLACEHOLDER, CONTRACT_BODY_PLACEHOLDER, PROMPT_BODY_PLACEHOLDER, AGENT_BODY_PLACEHOLDER } from './chunk-32XKCNCL.js';
-import { checkAgentSkillConformance } from './chunk-2FMEGSBN.js';
-import { matchPin } from './chunk-JZCSNEHK.js';
-import { SKAILE_MANIFEST_FILENAME, loadSkPublishManifest } from './chunk-IXWODEED.js';
-import { parseFrontmatter } from './chunk-Y34MSWEZ.js';
-import { parseDep, isValidPublisher, slugifyAssetName, PUBLISHER_HINT } from './chunk-4OV5DSBB.js';
-import * as fs from 'fs';
-import * as path from 'path';
+import { getStoreIdentity, refFor } from './chunk-NR7H7ZJP.js';
+import { openLibrary } from './chunk-JQ3DXNQV.js';
+import { logErr, logWarn } from './chunk-POQ6PGNE.js';
+import { getKindRegistry } from './chunk-GWD3QNVS.js';
+import { parseFlowDefinition } from './chunk-X3RMRJNR.js';
+import { stampManifestPublisher, upsertManifestAsset, resolveIndexPath, LocalIndex } from './chunk-C3BMXXTN.js';
+import { SEMVER_RE, parseManifestFile, requiresSyntaxErrors } from './chunk-7CR2OZPA.js';
+import { composeRefTarget, SKILL_DESCRIPTION_PLACEHOLDER_PREFIX, PRESET_DESCRIPTION_PLACEHOLDER, PRESET_ITEM_PLACEHOLDER_REF, SKILL_BODY_PLACEHOLDER, CONTRACT_BODY_PLACEHOLDER, PROMPT_BODY_PLACEHOLDER, AGENT_BODY_PLACEHOLDER } from './chunk-6VLHITAM.js';
+import { checkAgentSkillConformance } from './chunk-T5TSLSRO.js';
+import { matchPin } from './chunk-PNOGX36L.js';
+import { SKAILE_MANIFEST_FILENAME, loadSkPublishManifest } from './chunk-CTP3XBMF.js';
+import { parseFrontmatter } from './chunk-XTVSNWLL.js';
+import { parseDep, isValidPublisher, slugifyAssetName, parseAssetRef, isValidAssetName, ASSET_NAME_HINT, PUBLISHER_HINT } from './chunk-PNTXHTBC.js';
+import * as fs3 from 'fs';
+import * as path3 from 'path';
 import { Option } from 'commander';
 import { parse, stringify } from 'yaml';
 
+var error = (text) => ({ tag: "agent", text, conformance: false });
+function isInside(parent, child) {
+  const rel = path3.relative(parent, child);
+  return rel === "" || !rel.startsWith("..") && !path3.isAbsolute(rel);
+}
+function records(value) {
+  return Array.isArray(value) ? value.filter((v) => v !== null && typeof v === "object") : [];
+}
+function checkAgentFiles(parsed, agentDir, libraryRoot) {
+  const out = [];
+  records(parsed.composes).forEach((item, i) => {
+    if (typeof item.kind !== "string" || typeof item.ref !== "string") return;
+    const target = composeRefTarget({ kind: item.kind, ref: item.ref });
+    if (target?.type !== "local") return;
+    const where = `composes[${i}].ref`;
+    const resolved = path3.resolve(agentDir, target.path);
+    if (!fs3.existsSync(resolved)) {
+      out.push(
+        error(`${where}: local path "${item.ref}" does not exist (resolved from ${agentDir})`)
+      );
+      return;
+    }
+    if (!isInside(libraryRoot, resolved)) {
+      out.push(
+        error(`${where}: local path "${item.ref}" leaves the library and cannot be published`)
+      );
+      return;
+    }
+    const ownManifests = [
+      agentDir,
+      path3.join(agentDir, "agent.yaml"),
+      path3.join(agentDir, "AGENT.md")
+    ];
+    if (item.kind === "agent" && ownManifests.includes(resolved)) {
+      out.push(
+        error(
+          `${where}: agent composes itself (${item.ref}); an agent cannot be its own sub-agent`
+        )
+      );
+    }
+  });
+  const blocks = records(
+    parsed.memory !== null && typeof parsed.memory === "object" ? parsed.memory.blocks : void 0
+  );
+  blocks.forEach((block, i) => {
+    if (typeof block.source !== "string" || block.source === "") return;
+    const where = `memory.blocks[${i}].source`;
+    const resolved = path3.resolve(agentDir, block.source);
+    if (!isInside(agentDir, resolved)) {
+      out.push(error(`${where}: "${block.source}" leaves the agent directory`));
+      return;
+    }
+    let stat;
+    try {
+      stat = fs3.statSync(resolved);
+    } catch {
+      out.push(error(`${where}: file "${block.source}" does not exist in ${agentDir}`));
+      return;
+    }
+    if (!stat.isFile()) {
+      out.push(error(`${where}: "${block.source}" is not a file`));
+      return;
+    }
+    const max = block.max_chars;
+    if (typeof max !== "number") return;
+    const length = [...fs3.readFileSync(resolved, "utf-8").trim()].length;
+    if (length > max) {
+      out.push(
+        error(
+          `${where}: "${block.source}" holds ${length} characters, more than memory block "${String(block.name)}" max_chars ${max}`
+        )
+      );
+    }
+  });
+  return out;
+}
+function agentComposeRefAdvisories(parsed, hasAsset, libraryPublisher) {
+  const out = [];
+  records(parsed.composes).forEach((item, i) => {
+    if (typeof item.kind !== "string" || typeof item.ref !== "string") return;
+    const target = composeRefTarget({ kind: item.kind, ref: item.ref });
+    if (target?.type !== "asset" || target.kind === "soul") return;
+    if (target.publisher !== void 0 && libraryPublisher !== void 0 && target.publisher !== libraryPublisher) {
+      return;
+    }
+    if (target.publisher !== void 0 && libraryPublisher === void 0) return;
+    if (hasAsset(target.kind, target.name)) return;
+    out.push({
+      tag: "agent",
+      text: `composes[${i}].ref: ${item.ref} is not in this library; \`skaile add\` fails with "requires \u2026 not found" unless the asset is published elsewhere`,
+      conformance: false
+    });
+  });
+  return out;
+}
+var BODY_PLACEHOLDER_BY_KIND = {
+  skill: SKILL_BODY_PLACEHOLDER,
+  agent: AGENT_BODY_PLACEHOLDER,
+  prompt: PROMPT_BODY_PLACEHOLDER,
+  contract: CONTRACT_BODY_PLACEHOLDER
+};
+var MARKDOWN_SCAFFOLD_KINDS = {
+  skill: true,
+  agent: true,
+  prompt: true,
+  contract: true
+};
+var FLOW_DESCRIPTION_PLACEHOLDER = "Flow description";
+function checkAssetManifest(kind, parsed, body, dirName) {
+  const out = [];
+  if (kind === "skill") {
+    for (const f of checkAgentSkillConformance(parsed, { dirName })) {
+      out.push({ tag: "skill conformance", text: `${f.field}: ${f.message}`, conformance: true });
+    }
+  }
+  if (MARKDOWN_SCAFFOLD_KINDS[kind]) {
+    const bodyText = body?.replace(/^#[^\n]*\n+/, "");
+    const isPlaceholder = bodyText === SKILL_BODY_PLACEHOLDER || bodyText === BODY_PLACEHOLDER_BY_KIND[kind];
+    if (isPlaceholder) {
+      const noun = kind === "skill" ? "skill prompt" : kind;
+      out.push({
+        tag: kind,
+        text: `body is still the scaffold placeholder; write the ${noun}`,
+        conformance: false,
+        scaffoldBody: true
+      });
+    }
+  }
+  return out;
+}
+function declaredVersion(parsed) {
+  const scalar = (v) => typeof v === "string" ? v : typeof v === "number" ? String(v) : void 0;
+  const meta = parsed.metadata;
+  const nested = meta !== null && typeof meta === "object" ? scalar(meta.version) : void 0;
+  return scalar(parsed.version) ?? nested;
+}
+function invalidSemverText(version) {
+  return SEMVER_RE.test(version) ? void 0 : `version "${version}" is not valid semver`;
+}
+function rawVersionScalar(text) {
+  const front = text.startsWith("---") ? text.split(/\n---/, 1)[0] ?? text : text;
+  const m = /^[ \t]*version:[ \t]*([^\s#][^#\n]*?)[ \t]*(?:#.*)?$/m.exec(front);
+  return m?.[1];
+}
+function versionProblemText(parsed, rawText) {
+  const version = declaredVersion(parsed);
+  const text = version === void 0 ? void 0 : invalidSemverText(version);
+  if (text === void 0) return void 0;
+  const meta = parsed.metadata;
+  const nested = meta !== null && typeof meta === "object" ? meta.version : void 0;
+  const key = parsed.version === void 0 || parsed.version === null ? "metadata.version" : "version";
+  const written = key === "version" ? parsed.version : nested;
+  if (typeof written !== "number") return text;
+  const raw = (rawText === void 0 ? void 0 : rawVersionScalar(rawText)) ?? String(written);
+  const fix = /^\d+(\.\d+)?$/.test(raw) ? `${raw}${raw.includes(".") ? "" : ".0"}.0` : DEFAULT_VERSION;
+  return `version ${raw} is not valid semver: yaml reads an unquoted number as a number, not a string. Write it quoted with three parts: ${key}: "${fix}"`;
+}
+function duplicateAssetMessage(kind, name, dir, detail, library) {
+  return `${kind}:${name} found in ${dir} but ${detail}. Rename or delete one of the two directories, then re-run \`skaile library index ${library}\`.`;
+}
+var DEFAULT_VERSION = "0.1.0";
+var SCAFFOLD_KINDS = {
+  skill: true,
+  agent: true,
+  prompt: true,
+  contract: true,
+  flow: true,
+  preset: true
+};
+function withManifestDefaults(kind, parsed) {
+  if (!SCAFFOLD_KINDS[kind]) return parsed;
+  const out = { ...parsed };
+  if (out.metadata === null) delete out.metadata;
+  const meta = out.metadata;
+  const nested = typeof meta === "object" && meta !== null && "version" in meta ? meta.version : void 0;
+  if (out.version == null && nested == null) out.version = DEFAULT_VERSION;
+  return out;
+}
+function manifestIdentityError(kind, parsed) {
+  const identity = kind === "flow" ? parsed.id : parsed.name;
+  if (typeof identity !== "string" || identity.length === 0) return void 0;
+  const publisher = typeof parsed.publisher === "string" ? parsed.publisher : void 0;
+  if (publisher !== void 0) {
+    try {
+      parseAssetRef(`${kind}:@${publisher}/${identity}`);
+      return void 0;
+    } catch (e) {
+      return e instanceof Error ? e.message : String(e);
+    }
+  }
+  if (!isValidAssetName(identity)) {
+    return `invalid asset ${kind === "flow" ? "id" : "name"} "${identity}" \u2014 ${ASSET_NAME_HINT}`;
+  }
+  return void 0;
+}
+function scaffoldDefinitionErrors(kind, parsed) {
+  const out = [];
+  if (kind === "flow") {
+    if (parsed.description === FLOW_DESCRIPTION_PLACEHOLDER) {
+      out.push("description is still the scaffold placeholder; say what the flow does");
+    }
+    if (parsed.nodes === void 0) {
+      out.push("nodes is missing; a flow needs at least one node");
+    } else if (Array.isArray(parsed.nodes) && parsed.nodes.length === 0) {
+      out.push("nodes is still the scaffold placeholder (nodes: []); add the flow's nodes");
+    }
+  }
+  if (kind === "preset") {
+    if (parsed.description === PRESET_DESCRIPTION_PLACEHOLDER) {
+      out.push(
+        `description is still the scaffold placeholder ("${PRESET_DESCRIPTION_PLACEHOLDER}"); say what the preset does`
+      );
+    }
+    const items = Array.isArray(parsed.items) ? parsed.items : [];
+    const placeholderItem = items.some((item) => {
+      const ref = typeof item === "string" ? item : item?.ref;
+      return typeof ref === "string" && ref.trim() === PRESET_ITEM_PLACEHOLDER_REF;
+    });
+    if (placeholderItem) {
+      out.push(
+        `item ${PRESET_ITEM_PLACEHOLDER_REF} is still the scaffold placeholder; replace it with the preset's real items`
+      );
+    }
+  }
+  return out;
+}
+function checkAsset(kind, parsed, body, dirName, registry, rawText) {
+  const errors = [];
+  const error2 = (text) => {
+    errors.push({ tag: kind, text, conformance: false });
+  };
+  const identity = manifestIdentityError(kind, parsed);
+  if (identity) error2(identity);
+  const semver = versionProblemText(parsed, rawText);
+  if (semver) error2(semver);
+  const effective = withManifestDefaults(kind, parsed);
+  const versionKey = ["skill", "prompt", "contract"].includes(kind) ? "metadata.version" : "version";
+  const provider = registry.getProvider(kind);
+  if (!provider) {
+    error2(`unknown_asset_kind: kind "${kind}" is not registered`);
+  } else {
+    const result = provider.validateManifest(effective);
+    if (!result.ok) {
+      for (const e of result.errors) {
+        if (e.path === "version" || e.path === "metadata.version") {
+          if (!semver) {
+            error2(`${e.path}: must be a semver string \u2014 set ${versionKey}: ${DEFAULT_VERSION}`);
+          }
+          continue;
+        }
+        error2(`${e.path ? `${e.path}: ` : ""}${e.message}`);
+      }
+    }
+  }
+  const description = parsed.description;
+  if (kind !== "skill" && typeof description === "string" && description.trim().startsWith(SKILL_DESCRIPTION_PLACEHOLDER_PREFIX)) {
+    error2(
+      `description: description is still the scaffold placeholder (${SKILL_DESCRIPTION_PLACEHOLDER_PREFIX} \u2026) \u2014 say what the ${kind} does and when to use it`
+    );
+  }
+  for (const text of scaffoldDefinitionErrors(kind, parsed)) error2(text);
+  if (kind === "flow") {
+    const flow = parseFlowDefinition(effective);
+    if (!flow.ok) {
+      for (const e of flow.errors) {
+        error2(`invalid flow definition: ${e.path || "<root>"}: ${e.message}`);
+      }
+    }
+  }
+  return { errors, advisories: checkAssetManifest(kind, parsed, body, dirName) };
+}
+function findAssetManifestFile(dir, kind, name) {
+  const candidates = [];
+  if (kind === "skill") candidates.push("SKILL.md");
+  else if (kind === "agent") candidates.push("agent.yaml", "AGENT.md");
+  else if (kind === "contract") candidates.push("CONTRACT.md");
+  else if (kind === "prompt") candidates.push(`${name}.prompt.md`);
+  else if (kind === "flow") candidates.push(`${name}.flow.yaml`, `${name}.flow.json`);
+  else if (kind === "preset") candidates.push(`${name}.preset.yaml`);
+  for (const c of candidates) {
+    const file = path3.join(dir, c);
+    if (fs3.existsSync(file)) return file;
+  }
+  const suffix = kind === "prompt" ? ".prompt.md" : kind === "flow" ? ".flow.yaml" : kind === "preset" ? ".preset.yaml" : null;
+  if (suffix && fs3.existsSync(dir)) {
+    const matches = fs3.readdirSync(dir).filter((f) => f.endsWith(suffix));
+    if (matches.length === 1) return path3.join(dir, matches[0]);
+  }
+  return null;
+}
+function readAssetBody(file, text) {
+  if (file.endsWith(".md")) return parseFrontmatter(text).body;
+  if (path3.basename(file) !== "agent.yaml") return void 0;
+  const soul = path3.join(path3.dirname(file), "SOUL.md");
+  return fs3.existsSync(soul) ? fs3.readFileSync(soul, "utf8").trim() : void 0;
+}
+function checkAssetFile(file, kind, registry, libraryRoot) {
+  let text;
+  try {
+    text = fs3.readFileSync(file, "utf8");
+  } catch {
+    return [];
+  }
+  const res = parseManifestFile(file, text);
+  if (!res.ok) return [];
+  const errors = checkAsset(
+    kind,
+    res.data,
+    readAssetBody(file, text),
+    path3.basename(path3.dirname(file)),
+    registry,
+    text
+  ).errors;
+  if (kind === "agent" && libraryRoot !== void 0) {
+    errors.push(...checkAgentFiles(res.data, path3.dirname(file), libraryRoot));
+  }
+  return errors;
+}
 function manifestRequiresProblems(dir) {
-  const file = path.join(dir, "skaile.manifest.yaml");
+  const file = path3.join(dir, "skaile.manifest.yaml");
   let doc;
   try {
-    doc = parse(fs.readFileSync(file, "utf-8"));
+    doc = parse(fs3.readFileSync(file, "utf-8"));
   } catch {
     return [];
   }
@@ -58,13 +376,13 @@ async function knownAssetVersions(dir) {
   };
   addManifest(dir);
   const indexPath = resolveIndexPath();
-  if (!fs.existsSync(indexPath)) return known;
+  if (!fs3.existsSync(indexPath)) return known;
   const index = new LocalIndex({ indexPath, kindRegistry: getKindRegistry() });
   try {
     for (const def of await index.listAssetDefs())
       add(def.publisher, def.kind, def.name, def.version);
     for (const lib of await index.listSources()) {
-      if (path.resolve(lib.path) !== path.resolve(dir) && fs.existsSync(lib.path)) {
+      if (path3.resolve(lib.path) !== path3.resolve(dir) && fs3.existsSync(lib.path)) {
         addManifest(lib.path);
       }
     }
@@ -77,7 +395,7 @@ async function knownAssetVersions(dir) {
 async function unresolvedManifestDependencies(dir) {
   let doc;
   try {
-    doc = parse(fs.readFileSync(path.join(dir, SKAILE_MANIFEST_FILENAME), "utf-8"));
+    doc = parse(fs3.readFileSync(path3.join(dir, SKAILE_MANIFEST_FILENAME), "utf-8"));
   } catch {
     return [];
   }
@@ -129,7 +447,7 @@ function requireValidPublisherOrExit(raw) {
 function manifestPublisherProblems(dir) {
   let doc;
   try {
-    doc = parse(fs.readFileSync(path.join(dir, SKAILE_MANIFEST_FILENAME), "utf-8"));
+    doc = parse(fs3.readFileSync(path3.join(dir, SKAILE_MANIFEST_FILENAME), "utf-8"));
   } catch {
     return [];
   }
@@ -171,7 +489,7 @@ async function indexLibrary(lib, index, opts = {}) {
       const lost = new Set(res.pruned);
       for (const other of await own.listSources()) {
         if (other.id === lib.id || other.backend !== "local" || !other.path) continue;
-        if (!fs.existsSync(other.path)) continue;
+        if (!fs3.existsSync(other.path)) continue;
         await new LocalCatalogSource(own, other.id, other.path, getKindRegistry()).sync({
           only: lost
         });
@@ -208,16 +526,16 @@ function warnLibraryNameFallback(libName, resolved, hasPublisherFlag = false) {
   );
 }
 function normalizeAssetFrontmatter(assetDir) {
-  let markerFile = ["SKILL.md", "AGENT.md", "CONTRACT.md"].map((m) => path.join(assetDir, m)).find((f) => fs.existsSync(f));
+  let markerFile = ["SKILL.md", "AGENT.md", "CONTRACT.md"].map((m) => path3.join(assetDir, m)).find((f) => fs3.existsSync(f));
   if (!markerFile) {
-    const promptMd = fs.readdirSync(assetDir).find((f) => f.endsWith(".prompt.md"));
-    if (promptMd) markerFile = path.join(assetDir, promptMd);
+    const promptMd = fs3.readdirSync(assetDir).find((f) => f.endsWith(".prompt.md"));
+    if (promptMd) markerFile = path3.join(assetDir, promptMd);
   }
   if (!markerFile) return;
   try {
-    const { data, body } = parseFrontmatter(fs.readFileSync(markerFile, "utf8"));
+    const { data, body } = parseFrontmatter(fs3.readFileSync(markerFile, "utf8"));
     const fm = stringify(data).trimEnd();
-    fs.writeFileSync(markerFile, `---
+    fs3.writeFileSync(markerFile, `---
 ${fm}
 ---
 
@@ -238,7 +556,7 @@ async function registerLibraryAsset(lib, index, input) {
   upsertManifestAsset(lib.path, {
     kind: input.kind,
     name: input.name,
-    root: path.relative(lib.path, input.assetDir) || input.name,
+    root: path3.relative(lib.path, input.assetDir) || input.name,
     version: input.version,
     publisher
   });
@@ -261,17 +579,17 @@ function findFiles(root, match) {
   const walk = (dir) => {
     let entries;
     try {
-      entries = fs.readdirSync(dir, { withFileTypes: true });
+      entries = fs3.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
     for (const entry of entries) {
       if (entry.isDirectory()) {
         if (!entry.name.startsWith(".") && entry.name !== "node_modules") {
-          walk(path.join(dir, entry.name));
+          walk(path3.join(dir, entry.name));
         }
       } else if (match(entry.name)) {
-        found.push(path.join(dir, entry.name));
+        found.push(path3.join(dir, entry.name));
       }
     }
   };
@@ -293,7 +611,7 @@ function warnIgnoredDomainFiles(root) {
 function warnLegacyBundleFiles(root) {
   const files = findFiles(root, (name) => name.endsWith(".bundle.yaml"));
   if (files.length > 0) {
-    const shown = files.slice(0, 5).map((f) => path.relative(root, f) || f);
+    const shown = files.slice(0, 5).map((f) => path3.relative(root, f) || f);
     const more = files.length > shown.length ? `, +${files.length - shown.length} more` : "";
     logWarn(
       `${files.length} *.bundle.yaml file(s) are not scanned (the bundle kind became preset): ${shown.join(", ")}${more}. Run \`skaile migrate assets ${root} --write\` to rename them to *.preset.yaml. See ${LIBRARY_UPGRADE_DOCS}`
@@ -301,165 +619,7 @@ function warnLegacyBundleFiles(root) {
   }
   return files.length;
 }
-var BODY_PLACEHOLDER_BY_KIND = {
-  skill: SKILL_BODY_PLACEHOLDER,
-  agent: AGENT_BODY_PLACEHOLDER,
-  prompt: PROMPT_BODY_PLACEHOLDER,
-  contract: CONTRACT_BODY_PLACEHOLDER
-};
-var MARKDOWN_SCAFFOLD_KINDS = {
-  skill: true,
-  agent: true,
-  prompt: true,
-  contract: true
-};
-var FLOW_DESCRIPTION_PLACEHOLDER = "Flow description";
-function checkAssetManifest(kind, parsed, body, dirName) {
-  const out = [];
-  if (kind === "skill") {
-    for (const f of checkAgentSkillConformance(parsed, { dirName })) {
-      out.push({ tag: "skill conformance", text: `${f.field}: ${f.message}`, conformance: true });
-    }
-  }
-  if (MARKDOWN_SCAFFOLD_KINDS[kind]) {
-    const bodyText = body?.replace(/^#[^\n]*\n+/, "");
-    const isPlaceholder = bodyText === SKILL_BODY_PLACEHOLDER || bodyText === BODY_PLACEHOLDER_BY_KIND[kind];
-    if (isPlaceholder) {
-      const noun = kind === "skill" ? "skill prompt" : kind;
-      out.push({
-        tag: kind,
-        text: `body is still the scaffold placeholder; write the ${noun}`,
-        conformance: false
-      });
-    }
-  }
-  if (kind === "flow") {
-    if (parsed.description === FLOW_DESCRIPTION_PLACEHOLDER) {
-      out.push({
-        tag: "flow",
-        text: "description is still the scaffold placeholder; say what the flow does",
-        conformance: false
-      });
-    }
-    if (Array.isArray(parsed.nodes) && parsed.nodes.length === 0) {
-      out.push({
-        tag: "flow",
-        text: "nodes is still the scaffold placeholder (nodes: []); add the flow's nodes",
-        conformance: false
-      });
-    }
-  }
-  if (kind === "preset") {
-    if (parsed.description === PRESET_DESCRIPTION_PLACEHOLDER) {
-      out.push({
-        tag: "preset",
-        text: `description is still the scaffold placeholder ("${PRESET_DESCRIPTION_PLACEHOLDER}"); say what the preset does`,
-        conformance: false
-      });
-    }
-    const items = Array.isArray(parsed.items) ? parsed.items : [];
-    const placeholderItem = items.some((item) => {
-      const ref = typeof item === "string" ? item : item?.ref;
-      return typeof ref === "string" && ref.trim() === PRESET_ITEM_PLACEHOLDER_REF;
-    });
-    if (placeholderItem) {
-      out.push({
-        tag: "preset",
-        text: `item ${PRESET_ITEM_PLACEHOLDER_REF} is still the scaffold placeholder; replace it with the preset's real items`,
-        conformance: false
-      });
-    }
-  }
-  return out;
-}
-function declaredVersion(parsed) {
-  const scalar = (v) => typeof v === "string" ? v : typeof v === "number" ? String(v) : void 0;
-  const meta = parsed.metadata;
-  const nested = meta !== null && typeof meta === "object" ? scalar(meta.version) : void 0;
-  return scalar(parsed.version) ?? nested;
-}
-function invalidSemverText(version) {
-  return SEMVER_RE.test(version) ? void 0 : `version "${version}" is not valid semver`;
-}
-function duplicateAssetMessage(kind, name, dir, detail, library) {
-  return `${kind}:${name} found in ${dir} but ${detail}. Rename or delete one of the two directories, then re-run \`skaile library index ${library}\`.`;
-}
-function checkAsset(kind, parsed, body, dirName, registry) {
-  const errors = [];
-  const error = (text) => {
-    errors.push({ tag: kind, text, conformance: false });
-  };
-  const version = declaredVersion(parsed);
-  const semver = version === void 0 ? void 0 : invalidSemverText(version);
-  if (semver) error(semver);
-  const provider = registry.getProvider(kind);
-  if (!provider) {
-    error(`unknown_asset_kind: kind "${kind}" is not registered`);
-  } else {
-    const result = provider.validateManifest(parsed);
-    if (!result.ok) {
-      for (const e of result.errors) error(`${e.path ? `${e.path}: ` : ""}${e.message}`);
-    }
-  }
-  const description = parsed.description;
-  if (kind !== "skill" && typeof description === "string" && description.trim().startsWith(SKILL_DESCRIPTION_PLACEHOLDER_PREFIX)) {
-    error(
-      `description: description is still the scaffold placeholder (${SKILL_DESCRIPTION_PLACEHOLDER_PREFIX} \u2026) \u2014 say what the ${kind} does and when to use it`
-    );
-  }
-  if (kind === "flow") {
-    const flow = parseFlowDefinition(parsed);
-    if (!flow.ok) {
-      for (const e of flow.errors) {
-        error(`invalid flow definition: ${e.path || "<root>"}: ${e.message}`);
-      }
-    }
-  }
-  return { errors, advisories: checkAssetManifest(kind, parsed, body, dirName) };
-}
-function findAssetManifestFile(dir, kind, name) {
-  const candidates = [];
-  if (kind === "skill") candidates.push("SKILL.md");
-  else if (kind === "agent") candidates.push("agent.yaml", "AGENT.md");
-  else if (kind === "contract") candidates.push("CONTRACT.md");
-  else if (kind === "prompt") candidates.push(`${name}.prompt.md`);
-  else if (kind === "flow") candidates.push(`${name}.flow.yaml`, `${name}.flow.json`);
-  else if (kind === "preset") candidates.push(`${name}.preset.yaml`);
-  for (const c of candidates) {
-    const file = path.join(dir, c);
-    if (fs.existsSync(file)) return file;
-  }
-  const suffix = kind === "prompt" ? ".prompt.md" : kind === "flow" ? ".flow.yaml" : kind === "preset" ? ".preset.yaml" : null;
-  if (suffix && fs.existsSync(dir)) {
-    const matches = fs.readdirSync(dir).filter((f) => f.endsWith(suffix));
-    if (matches.length === 1) return path.join(dir, matches[0]);
-  }
-  return null;
-}
-function readAssetBody(file, text) {
-  if (file.endsWith(".md")) return parseFrontmatter(text).body;
-  if (path.basename(file) !== "agent.yaml") return void 0;
-  const soul = path.join(path.dirname(file), "SOUL.md");
-  return fs.existsSync(soul) ? fs.readFileSync(soul, "utf8").trim() : void 0;
-}
-function checkAssetFile(file, kind, registry) {
-  let text;
-  try {
-    text = fs.readFileSync(file, "utf8");
-  } catch {
-    return [];
-  }
-  const res = parseManifestFile(file, text);
-  if (!res.ok) return [];
-  return checkAsset(
-    kind,
-    res.data,
-    readAssetBody(file, text),
-    path.basename(path.dirname(file)),
-    registry
-  ).errors;
-}
 
-export { DOMAIN_REMOVED_HINT, checkAsset, checkAssetFile, declaredVersion, duplicateAssetMessage, exitOnManifestPublisherProblems, findAssetManifestFile, indexLibrary, invalidSemverText, manifestPublisherProblems, manifestRequiresProblems, readAssetBody, registerLibraryAsset, rejectRemovedDomainOption, removedDomainOption, requireValidPublisherOrExit, resolveLibraryPublisherDetailed, unresolvedManifestDependencies, warnIgnoredDomainFiles, warnLegacyBundleFiles, warnLibraryNameFallback };
-//# sourceMappingURL=chunk-YBQONMH2.js.map
-//# sourceMappingURL=chunk-YBQONMH2.js.map
+export { DOMAIN_REMOVED_HINT, agentComposeRefAdvisories, checkAgentFiles, checkAsset, checkAssetFile, declaredVersion, duplicateAssetMessage, exitOnManifestPublisherProblems, findAssetManifestFile, indexLibrary, invalidSemverText, manifestPublisherProblems, manifestRequiresProblems, readAssetBody, registerLibraryAsset, rejectRemovedDomainOption, removedDomainOption, requireValidPublisherOrExit, resolveLibraryPublisherDetailed, unresolvedManifestDependencies, warnIgnoredDomainFiles, warnLegacyBundleFiles, warnLibraryNameFallback };
+//# sourceMappingURL=chunk-ID745F3R.js.map
+//# sourceMappingURL=chunk-ID745F3R.js.map