@iowarp/clio-coder 0.3.6 → 0.3.7

package/dist/{chunk-MFFY33HR.js → chunk-THKY7CD7.js}

@@ -1,10 +1,16 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
+  parseAgentRecipeSchema
+} from "./chunk-UVDSQ6LW.js";
+import {
+  discoverMarketplaceSkills,
   expandSkillInvocationInput,
+  installSkill,
   loadSkills,
+  normalizedSkillHash,
   parsePendingSkillRequests,
   projectCompatTrusted
-} from "./chunk-4BPJXDWC.js";
+} from "./chunk-C4JBQ5SR.js";
 import {
   COMPAT_RESOURCE_PRECEDENCE,
   defaultScopedResourceRoots,
@@ -13,223 +19,53 @@ import {
   splitYamlFrontmatter,
   stringField
 } from "./chunk-2SFS6XQE.js";
+import {
+  parseFleetContract,
+  parseFrontmatter
+} from "./chunk-KCMKRQX4.js";
+import {
+  assertAgentSpecPolicy,
+  normalizeAgentSpec
+} from "./chunk-AOCYTWAV.js";
 import {
   INTEROP_AGENT_KINDS
 } from "./chunk-IHXBNWMM.js";
+import {
+  readSettings,
+  updateSettings
+} from "./chunk-UHXRNZ2J.js";
 import {
   expandConfigPath
 } from "./chunk-SST6Z5JA.js";
+import {
+  runCommandVector
+} from "./chunk-D4MDIG46.js";
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
+import {
+  clioConfigDir
+} from "./chunk-BNAZZHFG.js";
+import {
+  safeResourceWrite
+} from "./chunk-WEPFGWHJ.js";
 import {
   __toESM,
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
 
-// src/domains/resources/skills/evals.ts
-init_esm_shims();
-var SCENARIO_HEADING = /^##\s+([A-Z])(\d+)\s*[-:–—]\s*(.+?)\s*$/;
-function parseSkillEvals(markdown) {
-  const lines = markdown.split("\n");
-  const scenarios = [];
-  const diagnostics = [];
-  let index = 0;
-  while (index < lines.length) {
-    const heading = SCENARIO_HEADING.exec(lines[index] ?? "");
-    if (heading === null) {
-      index += 1;
-      continue;
-    }
-    const blockStart = index + 1;
-    let blockEnd = blockStart;
-    while (blockEnd < lines.length && !/^##\s+/.test(lines[blockEnd] ?? "")) blockEnd += 1;
-    const block = lines.slice(blockStart, blockEnd);
-    const number = Number.parseInt(heading[2] ?? "", 10);
-    const id = `${heading[1] ?? "S"}${number}`;
-    const title = heading[3] ?? "";
-    const setup = extractSetup(block);
-    const fixtureCommands = extractFixtureCommands(block);
-    const expected = extractExpected(block);
-    if (setup === null) diagnostics.push(`${id} (${title}): no "Setup:" or "Prompt:" paragraph found; scenario skipped`);
-    else if (expected.length === 0) diagnostics.push(`${id} (${title}): no "Expected:" bullets found; scenario skipped`);
-    else scenarios.push({ id, number, title, setup, ...fixtureCommands ? { fixtureCommands } : {}, expected });
-    index = blockEnd;
-  }
-  return { scenarios, diagnostics };
-}
-function extractSetup(block) {
-  return extractLabeledParagraph(block, /^Setup:\s*(.*)$/i) ?? extractLabeledParagraph(block, /^(Prompt:.*)$/i);
-}
-function isScenarioLabel(line) {
-  const trimmed = line.trim();
-  return /^(Expected|Fixture|Setup commands):/i.test(trimmed) || /^Expected$/i.test(trimmed);
-}
-function extractLabeledParagraph(block, label) {
-  for (let i = 0; i < block.length; i += 1) {
-    const line = block[i] ?? "";
-    const match = label.exec(line.trim());
-    if (match === null) continue;
-    const parts = [];
-    if ((match[1] ?? "").length > 0) parts.push(match[1] ?? "");
-    for (let j = i + 1; j < block.length; j += 1) {
-      const next = (block[j] ?? "").trim();
-      if (next.length === 0) break;
-      if (isScenarioLabel(next)) break;
-      parts.push(next);
-    }
-    const setup = parts.join(" ").trim();
-    return setup.length > 0 ? setup : null;
-  }
-  return null;
-}
-function extractFixtureCommands(block) {
-  for (let i = 0; i < block.length; i += 1) {
-    const line = (block[i] ?? "").trim();
-    const match = /^(?:Fixture|Setup commands):\s*(.*)$/i.exec(line);
-    if (match === null) continue;
-    const inline = (match[1] ?? "").trim();
-    let cursor = i + 1;
-    while (cursor < block.length && (block[cursor] ?? "").trim().length === 0) cursor += 1;
-    const first = block[cursor] ?? "";
-    const fence = /^```\w*\s*$/.test(first.trim());
-    if (fence) {
-      const commands2 = [];
-      for (let j = cursor + 1; j < block.length; j += 1) {
-        const current = block[j] ?? "";
-        if (/^```\s*$/.test(current.trim())) {
-          const script2 = commands2.join("\n").trim();
-          return script2.length > 0 ? script2 : null;
-        }
-        commands2.push(current);
-      }
-      return null;
-    }
-    const commands = [];
-    if (inline.length > 0) commands.push(inline);
-    for (let j = cursor; j < block.length; j += 1) {
-      const current = block[j] ?? "";
-      const trimmed = current.trim();
-      if (trimmed.length === 0) break;
-      if (isScenarioLabel(trimmed)) break;
-      commands.push(current);
-    }
-    const script = commands.join("\n").trim();
-    return script.length > 0 ? script : null;
-  }
-  return null;
-}
-function extractExpected(block) {
-  let start = -1;
-  for (let i = 0; i < block.length; i += 1) {
-    if (/^Expected:?\s*$/i.test((block[i] ?? "").trim())) {
-      start = i + 1;
-      break;
-    }
-  }
-  if (start < 0) return [];
-  const bullets = [];
-  let current = null;
-  for (let i = start; i < block.length; i += 1) {
-    const raw = block[i] ?? "";
-    const trimmed = raw.trim();
-    if (trimmed.length === 0) {
-      if (current !== null) {
-        bullets.push(current.join(" "));
-        current = null;
-      }
-      continue;
-    }
-    const bullet = /^[-*]\s+(.*)$/.exec(raw);
-    if (bullet !== null) {
-      if (current !== null) bullets.push(current.join(" "));
-      current = [bullet[1] ?? ""];
-      continue;
-    }
-    if (current !== null && /^\s+\S/.test(raw)) {
-      current.push(trimmed);
-      continue;
-    }
-    break;
-  }
-  if (current !== null) bullets.push(current.join(" "));
-  return bullets.map((bullet) => bullet.trim()).filter((bullet) => bullet.length > 0);
-}
-
-// src/domains/resources/skills/provenance-pin.ts
+// src/domains/resources/library.ts
 init_esm_shims();
 var import_yaml = __toESM(require_dist(), 1);
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
-var SKILL_PIN_MANIFEST_FILENAME = "registry.yaml";
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function resolveSkillPinManifestPath(cwd) {
-  const fromEnv = process.env.CLIO_CODER_SKILL_CATALOG_DIR;
-  const catalogDir = fromEnv && fromEnv.trim().length > 0 ? path.resolve(fromEnv.trim()) : path.join(cwd, "skills");
-  const manifestPath = path.join(catalogDir, SKILL_PIN_MANIFEST_FILENAME);
-  return existsSync(manifestPath) ? manifestPath : null;
-}
-function loadSkillPinManifest(manifestPath) {
-  let parsed;
-  try {
-    parsed = import_yaml.default.parse(readFileSync(manifestPath, "utf8"));
-  } catch {
-    return null;
-  }
-  if (!isPlainObject(parsed) || !Array.isArray(parsed.skills)) return null;
-  const entries = /* @__PURE__ */ new Map();
-  for (const raw of parsed.skills) {
-    if (!isPlainObject(raw)) continue;
-    const name = typeof raw.name === "string" ? raw.name.trim() : "";
-    const sha256 = typeof raw.sha256 === "string" ? raw.sha256.trim().toLowerCase() : "";
-    if (name.length === 0 || !/^[0-9a-f]{64}$/.test(sha256)) continue;
-    entries.set(name, {
-      name,
-      version: typeof raw.version === "string" && raw.version.trim().length > 0 ? raw.version.trim() : null,
-      sha256
-    });
-  }
-  return entries;
-}
-function checkSkillDrift(skill, cwd) {
-  const actual = skill.normalizedHash.toLowerCase();
-  const manifestPath = resolveSkillPinManifestPath(cwd);
-  const manifest = manifestPath === null ? null : loadSkillPinManifest(manifestPath);
-  const pinned = manifest?.get(skill.name);
-  if (pinned !== void 0) {
-    return {
-      verdict: pinned.sha256 === actual ? "match" : "mismatch",
-      authority: "pinned-manifest",
-      expected: pinned.sha256
-    };
-  }
-  const recorded = skill.provenance?.installedHash?.trim().toLowerCase();
-  if (recorded !== void 0 && /^[0-9a-f]{64}$/.test(recorded)) {
-    return {
-      verdict: recorded === actual ? "match" : "mismatch",
-      authority: "install-record",
-      expected: recorded
-    };
-  }
-  return null;
-}
-
-// src/domains/resources/index.ts
-init_esm_shims();
-
-// src/domains/resources/extension.ts
-init_esm_shims();
-
-// src/domains/resources/loader.ts
-init_esm_shims();
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync as readFileSync2, statSync } from "node:fs";
+import path2 from "node:path";
 
 // src/domains/resources/prompts/loader.ts
 init_esm_shims();
-import { readFileSync as readFileSync2 } from "node:fs";
+import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
-import path2 from "node:path";
+import path from "node:path";
 
 // src/engine/prompt-templates.ts
 init_esm_shims();
@@ -294,7 +130,7 @@ function defaultPromptTemplateRoots(input = {}) {
   for (const kind of INTEROP_AGENT_KINDS) {
     if (kind.userPromptRoot !== void 0) {
       compat.push({
-        path: path2.join(home, kind.userPromptRoot),
+        path: path.join(home, kind.userPromptRoot),
         scope: "user",
         source: `${kind.id}-user`,
         precedence: COMPAT_RESOURCE_PRECEDENCE.userCompat,
@@ -303,7 +139,7 @@ function defaultPromptTemplateRoots(input = {}) {
     }
     if (kind.projectPromptRoot !== void 0) {
       compat.push({
-        path: path2.join(cwd, kind.projectPromptRoot),
+        path: path.join(cwd, kind.projectPromptRoot),
         scope: "project",
         source: `${kind.id}-project`,
         precedence: COMPAT_RESOURCE_PRECEDENCE.projectCompat,
@@ -328,17 +164,17 @@ function fallbackDescription(body) {
   return normalized.length > 60 ? `${normalized.slice(0, 57)}...` : normalized;
 }
 function loadPromptFile(filePath, root, diagnostics) {
-  const ext = path2.extname(filePath).toLowerCase();
+  const ext = path.extname(filePath).toLowerCase();
   if (ext !== ".md") return null;
   let raw;
   try {
-    raw = readFileSync2(filePath, "utf8");
+    raw = readFileSync(filePath, "utf8");
   } catch (err) {
     const reason = err instanceof Error ? err.message : String(err);
     diagnostics.push({ type: "warning", message: `prompt template could not be read: ${reason}`, path: filePath });
     return null;
   }
-  const name = path2.basename(filePath, ext);
+  const name = path.basename(filePath, ext);
   if (name.trim().length === 0) return null;
   const { frontmatter, body } = splitOptionalFrontmatter(raw, filePath, diagnostics);
   const description = stringField(frontmatter, "description") ?? fallbackDescription(body);
@@ -359,7 +195,7 @@ function loadPromptRoot(root, diagnostics) {
   const candidates = [];
   for (const entry of readRootEntries(root, "prompt template", diagnostics)) {
     if (!entry.isFile()) continue;
-    const candidate = loadPromptFile(path2.join(root.path, entry.name), root, diagnostics);
+    const candidate = loadPromptFile(path.join(root.path, entry.name), root, diagnostics);
     if (candidate) candidates.push(candidate);
   }
   return candidates;
@@ -421,7 +257,422 @@ function expandPromptTemplateInput(input, templates) {
   };
 }
 
+// src/domains/resources/library.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function catalogPath() {
+  const configured = readSettings().library.catalog;
+  return path2.resolve(configured ?? path2.join(clioConfigDir(), "library.yaml"));
+}
+function parseCatalog(filePath, diagnostics) {
+  if (!existsSync(filePath)) return [];
+  try {
+    const raw = readFileSync2(filePath, "utf8");
+    const parsed = filePath.endsWith(".json") ? JSON.parse(raw) : (0, import_yaml.parse)(raw);
+    const rows = Array.isArray(parsed) ? parsed : isRecord(parsed) && Array.isArray(parsed.skills) ? parsed.skills : [];
+    return rows.flatMap((value) => {
+      if (!isRecord(value) || typeof value.name !== "string" || typeof value.description !== "string" || typeof value.sourceUrl !== "string") {
+        diagnostics.push(`library catalog entry malformed: ${filePath}`);
+        return [];
+      }
+      const kind = value.kind === void 0 || value.kind === "skill" ? "skill" : value.kind === "agent" || value.kind === "prompt" || value.kind === "fleet" ? value.kind : "skill";
+      if (value.kind !== void 0 && !["skill", "agent", "prompt", "fleet"].includes(String(value.kind))) {
+        diagnostics.push(`library catalog entry has unsupported kind: ${value.name}`);
+        return [];
+      }
+      if (value.requires !== void 0 && (!Array.isArray(value.requires) || value.requires.some((item) => typeof item !== "string"))) {
+        diagnostics.push(`library_requirement_malformed: ${value.name}`);
+        return [];
+      }
+      const sourceUrl = /^(?:https?:\/\/|git@)/.test(value.sourceUrl) ? value.sourceUrl : path2.resolve(path2.dirname(filePath), value.sourceUrl);
+      const requires = Array.isArray(value.requires) ? value.requires.filter((item) => typeof item === "string") : void 0;
+      return [
+        {
+          kind,
+          name: value.name.trim(),
+          description: value.description.trim(),
+          sourceUrl,
+          origin: "index",
+          ...typeof value.version === "string" ? { version: value.version } : {},
+          ...requires ? { requires } : {}
+        }
+      ];
+    });
+  } catch (error) {
+    diagnostics.push(`library catalog unreadable: ${error instanceof Error ? error.message : String(error)}`);
+    return [];
+  }
+}
+function libraryEntryRef(entry) {
+  return `${entry.kind}:${entry.name}`;
+}
+function discoverLibrary(options = {}) {
+  const marketplace = discoverMarketplaceSkills({
+    ...options.marketplace ?? {},
+    ...options.cwd ? { cwd: options.cwd } : {}
+  });
+  const diagnostics = [...marketplace.diagnostics.filter((item) => !item.includes("no local skill marketplace"))];
+  const privatePath = catalogPath();
+  const primary = options.catalog ? parseCatalog(path2.resolve(options.catalog), diagnostics) : [];
+  const privateEntries = parseCatalog(privatePath, diagnostics);
+  const byRef = /* @__PURE__ */ new Map();
+  for (const entry of [...marketplace.skills, ...primary, ...privateEntries]) byRef.set(libraryEntryRef(entry), entry);
+  const refusals = {};
+  const entries = [...byRef.values()].filter((entry) => {
+    try {
+      resolveLibraryRequirements(entry, [...byRef.values()]);
+      return true;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      refusals[libraryEntryRef(entry)] = message;
+      if (!diagnostics.includes(message)) diagnostics.push(message);
+      return false;
+    }
+  });
+  return {
+    entries: entries.sort((a, b) => libraryEntryRef(a).localeCompare(libraryEntryRef(b))),
+    diagnostics,
+    refusals
+  };
+}
+var REQUIREMENT_PATTERN = /^(skill|agent|prompt|fleet):([A-Za-z0-9][A-Za-z0-9._-]*)$/;
+function resolveLibraryRequirements(entry, catalog) {
+  const byRef = new Map(catalog.map((item) => [libraryEntryRef(item), item]));
+  const ordered = [];
+  const visiting = [];
+  const visited = /* @__PURE__ */ new Set();
+  const visit = (current) => {
+    const currentRef = libraryEntryRef(current);
+    if (visited.has(currentRef)) return;
+    const cycleAt = visiting.indexOf(currentRef);
+    if (cycleAt >= 0)
+      throw new Error(`library_requirement_cycle: ${[...visiting.slice(cycleAt), currentRef].join(" -> ")}`);
+    visiting.push(currentRef);
+    for (const requirement of current.requires ?? []) {
+      if (!REQUIREMENT_PATTERN.test(requirement)) throw new Error("library_requirement_malformed");
+      const dependency = byRef.get(requirement);
+      if (!dependency) throw new Error(`library_requirement_missing: ${requirement}`);
+      visit(dependency);
+    }
+    visiting.pop();
+    visited.add(currentRef);
+    ordered.push(current);
+  };
+  visit(entry);
+  return ordered;
+}
+function sourceFile(entry) {
+  const source = path2.resolve(entry.sourceUrl);
+  if (entry.kind === "skill") return source;
+  if (!existsSync(source)) throw new Error(`library source path does not exist: ${source}`);
+  return source;
+}
+function validateEntry(entry, raw, filePath) {
+  if (entry.kind === "fleet") {
+    parseFleetContract(raw, filePath);
+    return;
+  }
+  if (entry.kind === "agent") {
+    const parsed = parseFrontmatter(raw, filePath);
+    const recipe = parseAgentRecipeSchema({ id: entry.name, source: "user", filepath: filePath, ...parsed });
+    assertAgentSpecPolicy(normalizeAgentSpec(recipe));
+    return;
+  }
+  if (entry.kind === "prompt") {
+    const loaded = loadPromptTemplates({ roots: [{ path: path2.dirname(filePath), scope: "user", source: "library" }] });
+    if (!loaded.items.some((item) => item.filePath === filePath))
+      throw new Error(`prompt template is malformed: ${filePath}`);
+  }
+}
+function libraryInstallPath(entry) {
+  if (entry.kind === "skill") return path2.join(clioConfigDir(), "skills", entry.name, "SKILL.md");
+  const root = entry.kind === "agent" ? "agents" : entry.kind === "fleet" ? "fleets" : "prompts";
+  return path2.join(clioConfigDir(), root, `${entry.name}.md`);
+}
+function readLibraryPins() {
+  const pinPath = path2.join(clioConfigDir(), "library-pins.yaml");
+  if (!existsSync(pinPath)) return {};
+  const parsed = (0, import_yaml.parse)(readFileSync2(pinPath, "utf8"));
+  return isRecord(parsed) ? parsed : {};
+}
+function libraryEntryInstalled(entry) {
+  return readLibraryPins()[libraryEntryRef(entry)] !== void 0 || existsSync(libraryInstallPath(entry));
+}
+function libraryEntryPin(entry) {
+  return readLibraryPins()[libraryEntryRef(entry)];
+}
+function classifyLibraryRequirements(entry, catalog) {
+  const ordered = resolveLibraryRequirements(entry, catalog).slice(0, -1);
+  const satisfied = ordered.filter((requirement) => libraryEntryInstalled(requirement));
+  const satisfiedRefs = new Set(satisfied.map(libraryEntryRef));
+  return {
+    ordered,
+    satisfied,
+    unsatisfied: ordered.filter((requirement) => !satisfiedRefs.has(libraryEntryRef(requirement)))
+  };
+}
+function planLibraryInstall(entry) {
+  if (entry.kind === "skill") {
+    const source2 = sourceFile(entry);
+    const file = statSync(source2).isDirectory() ? path2.join(source2, "SKILL.md") : source2;
+    const raw2 = readFileSync2(file);
+    return {
+      entry,
+      path: libraryInstallPath(entry),
+      sha256: normalizedSkillHash(raw2.toString("utf8"))
+    };
+  }
+  const source = sourceFile(entry);
+  const raw = readFileSync2(source, "utf8");
+  validateEntry(entry, raw, source);
+  return {
+    entry,
+    path: libraryInstallPath(entry),
+    sha256: createHash("sha256").update(raw).digest("hex")
+  };
+}
+function recordPin(plan) {
+  const pinPath = path2.join(clioConfigDir(), "library-pins.yaml");
+  const pins = readLibraryPins();
+  pins[libraryEntryRef(plan.entry)] = { sha256: plan.sha256, sourceUrl: plan.entry.sourceUrl };
+  safeResourceWrite(pinPath, (0, import_yaml.stringify)(Object.fromEntries(Object.entries(pins).sort())), { encoding: "utf8" });
+}
+function installLibraryPlan(plan) {
+  if (existsSync(plan.path)) throw new Error(`library destination already exists: ${plan.path}`);
+  if (plan.entry.kind === "skill") installSkill({ source: plan.entry.sourceUrl, scope: "user", name: plan.entry.name });
+  else safeResourceWrite(plan.path, readFileSync2(sourceFile(plan.entry)));
+  recordPin(plan);
+}
+function confirmedRemote() {
+  const settings = readSettings().library;
+  if (!settings.remote || settings.remote !== settings.confirmedRemote) throw new Error("library_remote_unconfirmed");
+  return settings.remote;
+}
+function confirmLibraryRemote(url) {
+  const current = readSettings().library.remote;
+  if (current !== null && current !== url) throw new Error("library_remote_mismatch");
+  updateSettings((settings) => {
+    if (settings.library.remote === null) settings.library.remote = url;
+    settings.library.confirmedRemote = url;
+  });
+}
+async function syncLibrary(direction, runner = runCommandVector) {
+  const settings = readSettings().library;
+  if (!settings.sync) throw new Error("library_sync_disabled");
+  const remote = confirmedRemote();
+  const cwd = path2.dirname(catalogPath());
+  const remoteResult = await runner("git", ["remote", "get-url", "library"], { cwd, workspaceRoot: cwd });
+  if (remoteResult.exitCode !== 0 || remoteResult.stdout.trim() !== remote)
+    throw new Error("library_remote_unconfirmed");
+  if (direction === "sync") {
+    const fetched = await runner("git", ["fetch", "library"], { cwd, workspaceRoot: cwd });
+    if (fetched.exitCode !== 0) throw new Error(fetched.stderr.trim() || "library sync failed");
+    const advanced = await runner("git", ["merge", "--ff-only", "FETCH_HEAD"], { cwd, workspaceRoot: cwd });
+    if (advanced.exitCode !== 0) throw new Error(advanced.stderr.trim() || "library sync failed");
+    return;
+  }
+  const result = await runner("git", ["push", "library"], { cwd, workspaceRoot: cwd });
+  if (result.exitCode !== 0) throw new Error(result.stderr.trim() || `library ${direction} failed`);
+}
+
+// src/domains/resources/skills/evals.ts
+init_esm_shims();
+var SCENARIO_HEADING = /^##\s+([A-Z])(\d+)\s*[-:–—]\s*(.+?)\s*$/;
+function parseSkillEvals(markdown) {
+  const lines = markdown.split("\n");
+  const scenarios = [];
+  const diagnostics = [];
+  let index = 0;
+  while (index < lines.length) {
+    const heading = SCENARIO_HEADING.exec(lines[index] ?? "");
+    if (heading === null) {
+      index += 1;
+      continue;
+    }
+    const blockStart = index + 1;
+    let blockEnd = blockStart;
+    while (blockEnd < lines.length && !/^##\s+/.test(lines[blockEnd] ?? "")) blockEnd += 1;
+    const block = lines.slice(blockStart, blockEnd);
+    const number = Number.parseInt(heading[2] ?? "", 10);
+    const id = `${heading[1] ?? "S"}${number}`;
+    const title = heading[3] ?? "";
+    const setup = extractSetup(block);
+    const fixtureCommands = extractFixtureCommands(block);
+    const expected = extractExpected(block);
+    if (setup === null) diagnostics.push(`${id} (${title}): no "Setup:" or "Prompt:" paragraph found; scenario skipped`);
+    else if (expected.length === 0) diagnostics.push(`${id} (${title}): no "Expected:" bullets found; scenario skipped`);
+    else scenarios.push({ id, number, title, setup, ...fixtureCommands ? { fixtureCommands } : {}, expected });
+    index = blockEnd;
+  }
+  return { scenarios, diagnostics };
+}
+function extractSetup(block) {
+  return extractLabeledParagraph(block, /^Setup:\s*(.*)$/i) ?? extractLabeledParagraph(block, /^(Prompt:.*)$/i);
+}
+function isScenarioLabel(line) {
+  const trimmed = line.trim();
+  return /^(Expected|Fixture|Setup commands):/i.test(trimmed) || /^Expected$/i.test(trimmed);
+}
+function extractLabeledParagraph(block, label) {
+  for (let i = 0; i < block.length; i += 1) {
+    const line = block[i] ?? "";
+    const match = label.exec(line.trim());
+    if (match === null) continue;
+    const parts = [];
+    if ((match[1] ?? "").length > 0) parts.push(match[1] ?? "");
+    for (let j = i + 1; j < block.length; j += 1) {
+      const next = (block[j] ?? "").trim();
+      if (next.length === 0) break;
+      if (isScenarioLabel(next)) break;
+      parts.push(next);
+    }
+    const setup = parts.join(" ").trim();
+    return setup.length > 0 ? setup : null;
+  }
+  return null;
+}
+function extractFixtureCommands(block) {
+  for (let i = 0; i < block.length; i += 1) {
+    const line = (block[i] ?? "").trim();
+    const match = /^(?:Fixture|Setup commands):\s*(.*)$/i.exec(line);
+    if (match === null) continue;
+    const inline = (match[1] ?? "").trim();
+    let cursor = i + 1;
+    while (cursor < block.length && (block[cursor] ?? "").trim().length === 0) cursor += 1;
+    const first = block[cursor] ?? "";
+    const fence = /^```\w*\s*$/.test(first.trim());
+    if (fence) {
+      const commands2 = [];
+      for (let j = cursor + 1; j < block.length; j += 1) {
+        const current = block[j] ?? "";
+        if (/^```\s*$/.test(current.trim())) {
+          const script2 = commands2.join("\n").trim();
+          return script2.length > 0 ? script2 : null;
+        }
+        commands2.push(current);
+      }
+      return null;
+    }
+    const commands = [];
+    if (inline.length > 0) commands.push(inline);
+    for (let j = cursor; j < block.length; j += 1) {
+      const current = block[j] ?? "";
+      const trimmed = current.trim();
+      if (trimmed.length === 0) break;
+      if (isScenarioLabel(trimmed)) break;
+      commands.push(current);
+    }
+    const script = commands.join("\n").trim();
+    return script.length > 0 ? script : null;
+  }
+  return null;
+}
+function extractExpected(block) {
+  let start = -1;
+  for (let i = 0; i < block.length; i += 1) {
+    if (/^Expected:?\s*$/i.test((block[i] ?? "").trim())) {
+      start = i + 1;
+      break;
+    }
+  }
+  if (start < 0) return [];
+  const bullets = [];
+  let current = null;
+  for (let i = start; i < block.length; i += 1) {
+    const raw = block[i] ?? "";
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+      if (current !== null) {
+        bullets.push(current.join(" "));
+        current = null;
+      }
+      continue;
+    }
+    const bullet = /^[-*]\s+(.*)$/.exec(raw);
+    if (bullet !== null) {
+      if (current !== null) bullets.push(current.join(" "));
+      current = [bullet[1] ?? ""];
+      continue;
+    }
+    if (current !== null && /^\s+\S/.test(raw)) {
+      current.push(trimmed);
+      continue;
+    }
+    break;
+  }
+  if (current !== null) bullets.push(current.join(" "));
+  return bullets.map((bullet) => bullet.trim()).filter((bullet) => bullet.length > 0);
+}
+
+// src/domains/resources/skills/provenance-pin.ts
+init_esm_shims();
+var import_yaml2 = __toESM(require_dist(), 1);
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "node:fs";
+import path3 from "node:path";
+var SKILL_PIN_MANIFEST_FILENAME = "registry.yaml";
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resolveSkillPinManifestPath(cwd) {
+  const fromEnv = process.env.CLIO_CODER_SKILL_CATALOG_DIR;
+  const catalogDir = fromEnv && fromEnv.trim().length > 0 ? path3.resolve(fromEnv.trim()) : path3.join(cwd, "skills");
+  const manifestPath = path3.join(catalogDir, SKILL_PIN_MANIFEST_FILENAME);
+  return existsSync2(manifestPath) ? manifestPath : null;
+}
+function loadSkillPinManifest(manifestPath) {
+  let parsed;
+  try {
+    parsed = import_yaml2.default.parse(readFileSync3(manifestPath, "utf8"));
+  } catch {
+    return null;
+  }
+  if (!isPlainObject(parsed) || !Array.isArray(parsed.skills)) return null;
+  const entries = /* @__PURE__ */ new Map();
+  for (const raw of parsed.skills) {
+    if (!isPlainObject(raw)) continue;
+    const name = typeof raw.name === "string" ? raw.name.trim() : "";
+    const sha256 = typeof raw.sha256 === "string" ? raw.sha256.trim().toLowerCase() : "";
+    if (name.length === 0 || !/^[0-9a-f]{64}$/.test(sha256)) continue;
+    entries.set(name, {
+      name,
+      version: typeof raw.version === "string" && raw.version.trim().length > 0 ? raw.version.trim() : null,
+      sha256
+    });
+  }
+  return entries;
+}
+function checkSkillDrift(skill, cwd) {
+  const actual = skill.normalizedHash.toLowerCase();
+  const manifestPath = resolveSkillPinManifestPath(cwd);
+  const manifest = manifestPath === null ? null : loadSkillPinManifest(manifestPath);
+  const pinned = manifest?.get(skill.name);
+  if (pinned !== void 0) {
+    return {
+      verdict: pinned.sha256 === actual ? "match" : "mismatch",
+      authority: "pinned-manifest",
+      expected: pinned.sha256
+    };
+  }
+  const recorded = skill.provenance?.installedHash?.trim().toLowerCase();
+  if (recorded !== void 0 && /^[0-9a-f]{64}$/.test(recorded)) {
+    return {
+      verdict: recorded === actual ? "match" : "mismatch",
+      authority: "install-record",
+      expected: recorded
+    };
+  }
+  return null;
+}
+
+// src/domains/resources/index.ts
+init_esm_shims();
+
+// src/domains/resources/extension.ts
+init_esm_shims();
+
 // src/domains/resources/loader.ts
+init_esm_shims();
 function createResourcesLoader(options = {}) {
   const defaultCwd = options.cwd ?? process.cwd();
   const skillOptions2 = () => options.skills?.() ?? {};
@@ -527,9 +778,19 @@ function createResourcesDomainModule(options = {}) {
 }
 
 export {
+  libraryEntryRef,
+  discoverLibrary,
+  libraryInstallPath,
+  libraryEntryInstalled,
+  libraryEntryPin,
+  classifyLibraryRequirements,
+  planLibraryInstall,
+  installLibraryPlan,
+  confirmLibraryRemote,
+  syncLibrary,
   parseSkillEvals,
   checkSkillDrift,
   ResourcesDomainModule,
   createResourcesDomainModule
 };
-//# sourceMappingURL=chunk-MFFY33HR.js.map
+//# sourceMappingURL=chunk-THKY7CD7.js.map