@skaile/workspaces 5.13.0 → 5.15.0

package/dist/{chunk-FB3NREF7.js → chunk-AXNX2SKZ.js}

@@ -1,21 +1,417 @@
-import { openLibrary } from './chunk-VLBIME5L.js';
-import { S, logErr, logWarn, logOk, logInfo } from './chunk-PYTTF754.js';
-import { getKindRegistry } from './chunk-4NJ3QQHZ.js';
-import { stampManifestPublisher, upsertManifestAsset, resolveIndexPath, LocalIndex } from './chunk-DKGEV6SQ.js';
-import { requiresSyntaxErrors } from './chunk-NVO6WECE.js';
-import { matchPin } from './chunk-L3ZGYSWY.js';
+import { openLibrary } from './chunk-2LTF2ZHH.js';
+import { S, logErr, logWarn, logOk, logInfo } from './chunk-PIDMOE7R.js';
+import { getKindRegistry } from './chunk-YUURCZWY.js';
+import { resolveBinding, UnknownCompositionKindError } from './chunk-SRKU7QUG.js';
+import { parseFlowDefinition } from './chunk-X3RMRJNR.js';
+import { assetRootProblem, stampManifestPublisher, upsertManifestAsset, resolveIndexPath, LocalIndex } from './chunk-OOQ5Q75W.js';
+import { SEMVER_RE, parseManifestFile, requiresSyntaxErrors } from './chunk-NKDSU4Q7.js';
+import { composeRefTarget, SKILL_DESCRIPTION_PLACEHOLDER_PREFIX, PRESET_DESCRIPTION_PLACEHOLDER, PRESET_ITEM_PLACEHOLDER_REF, composeSlotDiagnostics, agentDeprecationDiagnostics, SKILL_BODY_PLACEHOLDER, CONTRACT_BODY_PLACEHOLDER, PROMPT_BODY_PLACEHOLDER, AGENT_BODY_PLACEHOLDER } from './chunk-MGM5EJQQ.js';
+import { checkAgentSkillConformance } from './chunk-4QINFQ27.js';
+import { matchPin } from './chunk-J76LDUDS.js';
 import { globalSkaileDir } from './chunk-L5VSIPQD.js';
-import { SKAILE_MANIFEST_FILENAME, listLibrarySymlinks, librarySymlinkMessage, loadSkPublishManifest } from './chunk-IY5E7Y5W.js';
-import { parseFrontmatter } from './chunk-M3P4BYRK.js';
-import { parseDep, isValidPublisher, slugifyAssetName, PUBLISHER_HINT } from './chunk-J4OYIYFQ.js';
-import * as fs from 'fs';
+import { SKAILE_MANIFEST_FILENAME, loadSkPublishManifest, listLibrarySymlinks, librarySymlinkMessage } from './chunk-ANSZULXH.js';
+import { parseFrontmatter } from './chunk-SP5NGNBV.js';
+import { parseDep, isValidPublisher, slugifyAssetName, parseAssetRef, isValidAssetName, ASSET_NAME_HINT, PUBLISHER_HINT } from './chunk-VY6NTFE7.js';
+import * as fs3 from 'fs';
 import { rmSync, readFileSync, mkdirSync, writeFileSync, chmodSync } from 'fs';
-import * as path from 'path';
+import * as path3 from 'path';
 import { join, dirname } from 'path';
 import { Option } from 'commander';
 import { parse, stringify } from 'yaml';
 import { randomBytes, createHash } from 'crypto';
 
+var error = (text) => ({ tag: "agent", text, conformance: false });
+var PSEUDO_COMPOSE_KINDS = /* @__PURE__ */ new Set(["soul"]);
+function checkComposeKinds(parsed, registry) {
+  if (parsed === null || typeof parsed !== "object") return [];
+  const composes = parsed.composes;
+  if (!Array.isArray(composes)) return [];
+  const diagnostics = [];
+  composes.forEach((item, i) => {
+    if (item === null || typeof item !== "object") return;
+    const fields = item;
+    const kind = fields.kind;
+    if (typeof kind !== "string") return;
+    if (!PSEUDO_COMPOSE_KINDS.has(kind) && !registry.getProvider(kind)) {
+      diagnostics.push({
+        code: "unknown_asset_kind",
+        severity: "error",
+        message: `composes item kind "${kind}" is not a registered asset kind (registered: ${registry.getAllKinds().join(", ")})`,
+        path: `composes[${i}].kind`
+      });
+      return;
+    }
+    if (fields.binding !== void 0 || typeof fields.ref !== "string") return;
+    try {
+      resolveBinding({ kind, ref: fields.ref });
+    } catch (err) {
+      if (!(err instanceof UnknownCompositionKindError)) throw err;
+      diagnostics.push({
+        code: "unknown_asset_kind",
+        severity: "error",
+        message: `composes item "${fields.ref}" of kind "${kind}" has no default binding; set \`binding:\` (the session build fails without it)`,
+        path: `composes[${i}].binding`
+      });
+    }
+  });
+  return diagnostics;
+}
+function checkAgentDefinition(parsed, registry) {
+  const errors = [];
+  const advisories = [];
+  for (const d of [
+    ...checkComposeKinds(parsed, registry),
+    ...composeSlotDiagnostics(parsed),
+    ...agentDeprecationDiagnostics(parsed)
+  ]) {
+    (d.severity === "error" ? errors : advisories).push({
+      tag: "agent",
+      text: `${d.code}: ${d.path}: ${d.message}`,
+      conformance: false
+    });
+  }
+  return { errors, advisories };
+}
+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;
+}
+
+// cli/src/skill-checks.ts
+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 flowFileNameError(parsed, fileName) {
+  const id = parsed.id;
+  if (fileName === void 0 || typeof id !== "string" || id.length === 0) return void 0;
+  const stem = fileName.replace(/\.flow\.(yaml|yml|json)$/, "");
+  if (stem === fileName || stem === id) return void 0;
+  return `flow id "${id}" does not match the file name "${fileName}"; a flow asset is named by its id and the flow engine loads it only from "${id}.flow.yaml". Rename the file to "${id}.flow.yaml" or set id: ${stem}`;
+}
+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, fileName, agentFiles) {
+  const errors = [];
+  const error2 = (text) => {
+    errors.push({ tag: kind, text, conformance: false });
+  };
+  const identity = manifestIdentityError(kind, parsed);
+  if (identity) error2(identity);
+  const flowFileError = kind === "flow" ? flowFileNameError(parsed, fileName) : void 0;
+  if (flowFileError) error2(flowFileError);
+  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}`);
+      }
+    }
+  }
+  const advisories = checkAssetManifest(kind, parsed, body, dirName);
+  if (kind === "agent") {
+    if (fileName === "agent.yaml") {
+      const definition = checkAgentDefinition(parsed, registry);
+      errors.push(...definition.errors);
+      advisories.push(...definition.advisories);
+    }
+    if (agentFiles) errors.push(...checkAgentFiles(parsed, agentFiles.dir, agentFiles.libraryRoot));
+  }
+  return { errors, advisories };
+}
+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, onScaffoldBody) {
+  let text;
+  try {
+    text = fs3.readFileSync(file, "utf8");
+  } catch {
+    return [];
+  }
+  const res = parseManifestFile(file, text);
+  if (!res.ok) return [];
+  const checked = checkAsset(
+    kind,
+    res.data,
+    readAssetBody(file, text),
+    path3.basename(path3.dirname(file)),
+    registry,
+    text,
+    path3.basename(file),
+    libraryRoot === void 0 ? void 0 : { dir: path3.dirname(file), libraryRoot }
+  );
+  if (onScaffoldBody) {
+    for (const f of checked.advisories) if (f.scaffoldBody) onScaffoldBody(f);
+  }
+  return checked.errors;
+}
+
 // cli/src/commands/publish-core.ts
 function formatNamespaceAvailability(a) {
   switch (a.status) {
@@ -348,10 +744,10 @@ async function getAccessToken(config, deps = {}) {
 
 // cli/src/commands/library-index.ts
 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 [];
   }
@@ -389,13 +785,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);
       }
     }
@@ -408,7 +804,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 [];
   }
@@ -460,7 +856,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 [];
   }
@@ -492,13 +888,68 @@ function exitOnManifestPublisherProblems(dir, libName) {
   );
   process.exit(1);
 }
+function manifestEntryNameProblems(dir) {
+  const manifest = loadSkPublishManifest(dir);
+  if (!manifest || manifest.source) return [];
+  const problems = [];
+  for (const entry of manifest.assets ?? []) {
+    if (!entry.root || entry.source) continue;
+    if (assetRootProblem(dir, entry.root)) continue;
+    const file = findAssetManifestFile(path3.join(dir, entry.root), entry.kind, entry.name);
+    if (!file) continue;
+    let parsedName;
+    try {
+      const res = parseManifestFile(file, fs3.readFileSync(file, "utf-8"));
+      if (!res.ok) continue;
+      parsedName = entry.kind === "flow" ? res.data.id : res.data.name;
+    } catch {
+      continue;
+    }
+    if (typeof parsedName !== "string" || parsedName === "" || parsedName === entry.name) continue;
+    problems.push(
+      `${SKAILE_MANIFEST_FILENAME} [assets] ${entry.kind}:${entry.name} \u2014 ${path3.relative(dir, file)} now names "${parsedName}": the entry is a ref \`add\` cannot resolve. Run \`skaile library index <library>\` to rename it, or restore the name.`
+    );
+  }
+  return problems;
+}
+function manifestRootProblems(dir) {
+  let doc;
+  try {
+    doc = parse(fs3.readFileSync(path3.join(dir, SKAILE_MANIFEST_FILENAME), "utf-8"));
+  } catch {
+    return [];
+  }
+  if (!doc || typeof doc !== "object") return [];
+  const { assets } = doc;
+  if (!Array.isArray(assets)) return [];
+  const problems = [];
+  for (const a of assets) {
+    if (!a || typeof a !== "object") continue;
+    const { kind, name, root, source } = a;
+    if (typeof root !== "string" || source !== void 0) continue;
+    const problem = assetRootProblem(dir, root);
+    if (problem) {
+      problems.push(
+        `${SKAILE_MANIFEST_FILENAME} [assets] ${String(kind)}:${String(name)} \u2014 ${problem}`
+      );
+    }
+  }
+  return problems;
+}
+function exitOnManifestRootProblems(dir, verb) {
+  const problems = manifestRootProblems(dir);
+  if (problems.length === 0) return;
+  for (const message of problems) logErr(message);
+  logErr(`Fix or remove the entry in ${SKAILE_MANIFEST_FILENAME}, then re-run \`${verb}\`.`);
+  process.exit(1);
+}
 function reportLibrarySymlinks(dir, opts) {
   const links = listLibrarySymlinks(dir, opts);
   for (const link of links) logErr(librarySymlinkMessage(link));
   return links.length;
 }
 function exitOnLibrarySymlinks(dir, verb) {
-  const count = reportLibrarySymlinks(dir);
+  const count = reportLibrarySymlinks(dir, { wholeTree: true });
   if (count === 0) return;
   logErr(`${count} symlink(s) in ${dir}: remove them, then re-run \`${verb}\`.`);
   process.exit(1);
@@ -513,7 +964,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
         });
@@ -550,16 +1001,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}
 ---
 
@@ -580,7 +1031,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
   });
@@ -603,17 +1054,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));
       }
     }
   };
@@ -635,7 +1086,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}`
@@ -644,6 +1095,6 @@ function warnLegacyBundleFiles(root) {
   return files.length;
 }
 
-export { DOMAIN_REMOVED_HINT, assetEntryRef, assetNamespace, bareName, deviceLogin, exitOnEmptyAsset, exitOnLibrarySymlinks, exitOnManifestPublisherProblems, formatNamespaceAvailability, getAccessToken, getStoreIdentity, hasStoredAuth, indexLibrary, loadStoreAuthConfig, logout, manifestNamespaces, manifestPublisherProblems, manifestRequiresProblems, manifestVersionMismatchMessage, plannedRefs, preflightNamespace, publishToStore, refFor, registerLibraryAsset, rejectRemovedDomainOption, removedDomainOption, reportLibrarySymlinks, requireValidPublisherOrExit, resolveLibraryPublisherDetailed, unresolvedManifestDependencies, warnIgnoredDomainFiles, warnLegacyBundleFiles, warnLibraryNameFallback };
-//# sourceMappingURL=chunk-FB3NREF7.js.map
-//# sourceMappingURL=chunk-FB3NREF7.js.map
+export { DOMAIN_REMOVED_HINT, agentComposeRefAdvisories, assetEntryRef, assetNamespace, bareName, checkAsset, checkAssetFile, checkComposeKinds, declaredVersion, deviceLogin, duplicateAssetMessage, exitOnEmptyAsset, exitOnLibrarySymlinks, exitOnManifestPublisherProblems, exitOnManifestRootProblems, findAssetManifestFile, formatNamespaceAvailability, getAccessToken, getStoreIdentity, hasStoredAuth, indexLibrary, invalidSemverText, loadStoreAuthConfig, logout, manifestEntryNameProblems, manifestNamespaces, manifestPublisherProblems, manifestRequiresProblems, manifestRootProblems, manifestVersionMismatchMessage, plannedRefs, preflightNamespace, publishToStore, readAssetBody, refFor, registerLibraryAsset, rejectRemovedDomainOption, removedDomainOption, reportLibrarySymlinks, requireValidPublisherOrExit, resolveLibraryPublisherDetailed, unresolvedManifestDependencies, warnIgnoredDomainFiles, warnLegacyBundleFiles, warnLibraryNameFallback };
+//# sourceMappingURL=chunk-AXNX2SKZ.js.map
+//# sourceMappingURL=chunk-AXNX2SKZ.js.map