@iowarp/clio-coder 0.3.8 → 0.4.0

package/dist/{chunk-IGWKHNIQ.js → chunk-UXMFQ54G.js}

@@ -1,4 +1,18 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  fingerprintNativeRuntime
+} from "./chunk-NEKRRTYW.js";
+import {
+  INHERITED_PROJECT_CONTEXT,
+  acceptInteropAgents,
+  declineInteropAgents,
+  detectInteropAgents,
+  interopProposals,
+  renderProposalEntry
+} from "./chunk-SP2RXXYO.js";
+import {
+  initializeClioHome
+} from "./chunk-2OQE55CK.js";
 import {
   createDelayedManualCodeInput,
   promptOAuthSelection
@@ -13,40 +27,30 @@ import {
 import {
   credentialWriteFailed,
   printPlaintextCredentialWarning
-} from "./chunk-IFBNV6H6.js";
-import {
-  INHERITED_PROJECT_CONTEXT,
-  acceptInteropAgents,
-  declineInteropAgents,
-  detectInteropAgents,
-  fingerprintNativeRuntime,
-  interopProposals,
-  renderProposalEntry
-} from "./chunk-GPIEI3LY.js";
-import {
-  initializeClioHome
-} from "./chunk-XWSF374K.js";
+} from "./chunk-2ANTL7MR.js";
 import {
   printError,
   printOk
-} from "./chunk-XK56QHLX.js";
+} from "./chunk-VPKWYKEY.js";
 import {
   isOrchestratorEligibleRuntime,
-  probeCapabilitiesForModel
-} from "./chunk-7RFXX52T.js";
+  probeCapabilitiesForModel,
+  readTargetModelSnapshot,
+  recordTargetModelSnapshot
+} from "./chunk-DQITNCXG.js";
 import {
   credentialsPresent
-} from "./chunk-LU7P4LHA.js";
+} from "./chunk-P3FOHJT4.js";
 import {
   readSettings,
   removeTargetFromSettings,
   settingsPath,
   updateSettings
-} from "./chunk-IJ7RPIYJ.js";
+} from "./chunk-VFA6GDY5.js";
 import {
   greetLmStudio,
   registerBuiltinRuntimes
-} from "./chunk-NMPKI6XL.js";
+} from "./chunk-6DB53AJS.js";
 import {
   buildProviderSupportEntry,
   configuredTargetsForRuntime,
@@ -54,20 +58,20 @@ import {
   listKnownModelsForRuntime,
   listProviderSupportEntries,
   supportGroupLabel
-} from "./chunk-IIZWH4XA.js";
+} from "./chunk-HI63TFOG.js";
 import {
   openAuthStorage,
   registerClioOAuthProviders,
   resolveAuthTarget,
   resolveRuntimeAuthTarget,
   targetRequiresAuth
-} from "./chunk-EQ63NRB7.js";
+} from "./chunk-BBVYXMFO.js";
 import {
   getRuntimeRegistry
 } from "./chunk-NUGM5KR6.js";
 import {
   getCatalogModelForRuntime
-} from "./chunk-PT7HYKEM.js";
+} from "./chunk-VO2LKSTM.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -358,7 +362,8 @@ var DEFAULT_PORTS = {
   "lemonade-anthropic": 8e3,
   lemonade: 8e3,
   "anthropic-compat": 8e3,
-  "openai-compat": 8e3
+  "openai-compat": 8e3,
+  litellm: 4e3
 };
 function parseSetupArgs(argv) {
   const out = {
@@ -523,7 +528,7 @@ function printRuntimeList(includeHidden) {
   for (const entry of listProviderSupportEntries(getRuntimeRegistry().list(), { includeHidden })) {
     const runtime = getRuntimeRegistry().get(entry.runtimeId);
     const status = runtime && entry.connectable ? auth.statusForTarget(resolveRuntimeAuthTarget(runtime), { includeFallback: false }) : null;
-    const authLabel = runtime?.auth === "oauth" ? status?.available ? "connected" : "login" : runtime?.auth === "api-key" ? status?.available ? "credential" : "needs-key" : runtime?.auth ?? "none";
+    const authLabel = runtime?.auth === "oauth" ? status?.available ? "connected" : "login" : runtime?.auth === "api-key" ? status?.available ? "credential" : targetRequiresAuth({ id: entry.runtimeId, runtime: entry.runtimeId }, runtime) ? "needs-key" : "key-optional" : runtime?.auth ?? "none";
     rows.push({
       group: supportGroupLabel(entry.group),
       runtimeId: entry.runtimeId,
@@ -764,18 +769,12 @@ settings written to ${settingsPath()}
 function buildDescriptor(runtime, id, parts) {
   const descriptor = { id, runtime: runtime.id };
   if (parts.url) descriptor.url = parts.url;
-  const wireModels = parts.wireModels?.filter((value, index, all) => value.trim().length > 0 && all.indexOf(value) === index) ?? [];
   if (parts.model) descriptor.defaultModel = parts.model;
-  else {
-    const firstWireModel = wireModels[0];
-    if (firstWireModel) descriptor.defaultModel = firstWireModel;
-  }
   const auth = {};
   if (parts.apiKeyEnv) auth.apiKeyEnvVar = parts.apiKeyEnv;
   if (parts.apiKeyRef) auth.apiKeyRef = parts.apiKeyRef;
   if (parts.oauthProfile) auth.oauthProfile = parts.oauthProfile;
   if (Object.keys(auth).length > 0) descriptor.auth = auth;
-  if (wireModels.length > 0) descriptor.wireModels = wireModels;
   if (parts.gateway) descriptor.gateway = true;
   if (parts.lifecycle) descriptor.lifecycle = parts.lifecycle;
   const caps = {};
@@ -862,13 +861,21 @@ async function resolveSupportedWireModels(runtime, target, existing, authToken)
   if (runtime.kind === "http") {
     const probe = await runtimeProbe(runtime, target, authToken);
     if (probe?.ok && probe.models && probe.models.length > 0) {
+      recordTargetModelSnapshot(target, probe.models);
       return { models: [...probe.models], source: "probe", modelStates: probe.modelStates };
     }
     const discovered = await runtimeProbeModels(runtime, target, authToken);
-    if (discovered.length > 0) return { models: discovered, source: "probe" };
+    if (discovered.length > 0) {
+      recordTargetModelSnapshot(target, discovered);
+      return { models: discovered, source: "probe" };
+    }
+  }
+  const cached = readTargetModelSnapshot(target);
+  if (cached && cached.models.length > 0) return { models: [...cached.models], source: "cache" };
+  if (existing?.wireModels && existing.wireModels.length > 0) {
+    recordTargetModelSnapshot(target, existing.wireModels);
+    return { models: [...existing.wireModels], source: "legacy" };
   }
-  if (existing?.wireModels && existing.wireModels.length > 0)
-    return { models: [...existing.wireModels], source: "existing" };
   return { models: [], source: "none" };
 }
 function resolveModelChoice(answer, wireModels, defaultValue) {
@@ -972,7 +979,6 @@ async function runNonInteractive(runtime, args) {
   const descriptor = buildDescriptor(runtime, args.id, {
     ...url !== void 0 ? { url } : {},
     ...model ? { model } : {},
-    ...wireModels.length > 0 ? { wireModels } : {},
     ...apiKeyEnv !== void 0 ? { apiKeyEnv } : {},
     ...apiKeyRef !== void 0 ? { apiKeyRef } : {},
     ...oauthProfile !== void 0 ? { oauthProfile } : {},
@@ -1023,6 +1029,7 @@ async function runNonInteractive(runtime, args) {
   applyConfiguration(settings);
   updateSettings(applyConfiguration);
   const probe = await runtimeProbe(runtime, descriptor);
+  if (probe?.ok && probe.models) recordTargetModelSnapshot(descriptor, probe.models);
   printSummary(settings, descriptor, probe);
   if (runtime.auth === "oauth" && !auth.statusForTarget(resolveRuntimeAuthTarget(runtime), { includeFallback: false }).available) {
     process.stdout.write(
@@ -1280,7 +1287,7 @@ Selected runtime: ${runtime.id} (${support.summary})
     oauthProfile = runtime.oauthProviderId ?? runtime.id;
   }
   let model = defaults.model;
-  let inventory = existing?.wireModels && existing.wireModels.length > 0 ? { models: [...existing.wireModels], source: "existing" } : { models: [], source: "none" };
+  let inventory = { models: [], source: "none" };
   const tentative = buildDescriptor(runtime, targetId, {
     ...url !== void 0 ? { url } : {},
     ...apiKeyEnv !== void 0 ? { apiKeyEnv } : {},
@@ -1360,7 +1367,6 @@ Selected runtime: ${runtime.id} (${support.summary})
     ...apiKeyEnv !== void 0 ? { apiKeyEnv } : {},
     ...apiKeyRef !== void 0 ? { apiKeyRef } : {},
     ...oauthProfile !== void 0 ? { oauthProfile } : {},
-    ...wireModels.length > 0 ? { wireModels } : {},
     gateway: gatewayAnswer,
     ...defaults.lifecycle !== void 0 ? { lifecycle: defaults.lifecycle } : existing?.lifecycle !== void 0 ? { lifecycle: existing.lifecycle } : {},
     ...contextWindowChoice !== void 0 ? { contextWindow: contextWindowChoice } : {},
@@ -1381,6 +1387,7 @@ Selected runtime: ${runtime.id} (${support.summary})
     printPlaintextCredentialWarning();
   }
   const probe = await runtimeProbe(runtime, descriptor);
+  if (probe?.ok && probe.models) recordTargetModelSnapshot(descriptor, probe.models);
   if (probe) {
     process.stdout.write("\n");
     for (const line of probeLines(descriptor, probe)) process.stdout.write(`${line}
@@ -1548,4 +1555,4 @@ export {
   runTargetRename,
   runConfigureCommand
 };
-//# sourceMappingURL=chunk-IGWKHNIQ.js.map
+//# sourceMappingURL=chunk-UXMFQ54G.js.map

package/dist/{chunk-HFSBBKSQ.js → chunk-V5DHCITQ.js}

@@ -14,7 +14,7 @@ import {
 // src/domains/observability/trace-store.ts
 init_esm_shims();
 import { createHash } from "node:crypto";
-import { mkdirSync } from "node:fs";
+import { mkdirSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
 import { hostname } from "node:os";
 import { dirname, join } from "node:path";
@@ -23,6 +23,14 @@ var TRACE_DATABASE_FILE = "trace.sqlite";
 var TRACE_EVENT_POLL_LIMIT = 500;
 var TRACE_PAYLOAD_LIMIT_BYTES = 16 * 1024;
 var TRACE_WRITE_QUEUE_LIMIT = 2048;
+var TRACE_RETENTION_DAYS_ENV = "CLIO_CODER_TRACE_RETENTION_DAYS";
+var TRACE_MAX_BYTES_ENV = "CLIO_CODER_TRACE_MAX_BYTES";
+var DEFAULT_TRACE_RETENTION_POLICY = Object.freeze({
+  maxAgeDays: 30,
+  maxBytes: 128 * 1024 * 1024
+});
+var MILLISECONDS_PER_DAY = 24 * 60 * 60 * 1e3;
+var VACUUM_RECLAIMABLE_FRACTION = 0.2;
 var sqliteConstructor = null;
 function warningTracingRequested() {
   const flagged = (argument) => argument === "--trace-warnings" || argument.startsWith("--trace-warnings=");
@@ -62,6 +70,27 @@ function databaseSyncConstructor() {
 function traceDatabasePath(stateDir) {
   return join(stateDir, TRACE_DATABASE_FILE);
 }
+function resolveTraceRetentionPolicy(overrides = {}, environment = process.env) {
+  const maxAgeDays = overrides.maxAgeDays ?? parsePositiveRetentionNumber(environment[TRACE_RETENTION_DAYS_ENV], TRACE_RETENTION_DAYS_ENV, 1);
+  const maxBytes = overrides.maxBytes ?? parsePositiveRetentionNumber(environment[TRACE_MAX_BYTES_ENV], TRACE_MAX_BYTES_ENV, 1024 * 1024);
+  return {
+    maxAgeDays: requirePositiveRetentionNumber(maxAgeDays, TRACE_RETENTION_DAYS_ENV, 1),
+    maxBytes: requirePositiveRetentionNumber(maxBytes, TRACE_MAX_BYTES_ENV, 1024 * 1024)
+  };
+}
+function parsePositiveRetentionNumber(raw, name, fallback) {
+  if (raw === void 0 || raw.trim().length === 0) {
+    return name === TRACE_RETENTION_DAYS_ENV ? DEFAULT_TRACE_RETENTION_POLICY.maxAgeDays : DEFAULT_TRACE_RETENTION_POLICY.maxBytes;
+  }
+  const value = Number(raw);
+  return requirePositiveRetentionNumber(value, name, fallback);
+}
+function requirePositiveRetentionNumber(value, name, minimum) {
+  if (!Number.isSafeInteger(value) || value < minimum) {
+    throw new Error(`${name} must be an integer of at least ${minimum}`);
+  }
+  return value;
+}
 var TraceSchemaVersionError = class extends Error {
   constructor(found) {
     super(
@@ -221,8 +250,9 @@ function reconcileAbandonedRuns(db) {
   }
 }
 var TraceStore = class {
-  constructor(path) {
+  constructor(path, options = {}) {
     this.path = path;
+    this.retention = resolveTraceRetentionPolicy(options.retention);
     mkdirSync(dirname(path), { recursive: true });
     this.db = new (databaseSyncConstructor())(path);
     applyConnectionPragmas(this.db);
@@ -236,6 +266,7 @@ var TraceStore = class {
   }
   path;
   db;
+  retention;
   close() {
     this.db.close();
   }
@@ -249,6 +280,72 @@ var TraceStore = class {
       throw error;
     }
   }
+  /**
+   * Remove whole terminal runs, including all of their dependent rows.
+   *
+   * Age pruning runs first. If the allocated database is still above the byte
+   * limit, the oldest remaining terminal runs are removed until the live page
+   * set fits or only queued/running runs remain. A live run is never a candidate.
+   */
+  prune(policy = this.retention, now = (/* @__PURE__ */ new Date()).toISOString()) {
+    const resolved = resolveTraceRetentionPolicy(policy);
+    const nowMs = Date.parse(now);
+    if (!Number.isFinite(nowMs)) throw new Error(`trace prune time is invalid: ${now}`);
+    const bytesBefore = traceDatabaseFootprintBytes(this.path);
+    let rowsRemoved = 0;
+    let runsRemoved = 0;
+    const removed = /* @__PURE__ */ new Set();
+    const cutoff = new Date(Math.max(0, nowMs - resolved.maxAgeDays * MILLISECONDS_PER_DAY)).toISOString();
+    const ageCandidates = this.db.prepare(
+      "SELECT run_id FROM runs WHERE status IN ('success','fail') AND ended_at IS NOT NULL AND ended_at < ? ORDER BY ended_at, started_at, run_id"
+    ).all(cutoff);
+    if (ageCandidates.length > 0) {
+      this.transaction(() => {
+        for (const candidate of ageCandidates) {
+          rowsRemoved += deleteTraceRun(this.db, candidate.run_id);
+          runsRemoved += 1;
+          removed.add(candidate.run_id);
+        }
+      });
+    }
+    let pages = tracePageStats(this.db);
+    if (pages.usedBytes > resolved.maxBytes) {
+      const sizeCandidates = this.db.prepare(
+        "SELECT run_id FROM runs WHERE status IN ('success','fail') AND ended_at IS NOT NULL ORDER BY ended_at, started_at, run_id"
+      ).all();
+      this.transaction(() => {
+        for (const candidate of sizeCandidates) {
+          if (pages.usedBytes <= resolved.maxBytes) break;
+          if (removed.has(candidate.run_id)) continue;
+          rowsRemoved += deleteTraceRun(this.db, candidate.run_id);
+          runsRemoved += 1;
+          removed.add(candidate.run_id);
+          pages = tracePageStats(this.db);
+        }
+      });
+    }
+    pages = tracePageStats(this.db);
+    const reclaimableFraction = pages.pageCount === 0 ? 0 : pages.freePages / pages.pageCount;
+    const sizeNeedsReclaim = pages.allocatedBytes > resolved.maxBytes && pages.freePages > 0;
+    const vacuumed = rowsRemoved > 0 && pages.freePages > 0 && (reclaimableFraction >= VACUUM_RECLAIMABLE_FRACTION || sizeNeedsReclaim);
+    if (vacuumed) {
+      this.db.exec("VACUUM");
+      this.db.prepare("PRAGMA wal_checkpoint(TRUNCATE)").get();
+    }
+    const protectedRuns = Number(
+      this.db.prepare("SELECT COUNT(*) AS count FROM runs WHERE status IN ('queued','running')").get().count
+    );
+    const bytesAfter = traceDatabaseFootprintBytes(this.path);
+    return {
+      runsRemoved,
+      rowsRemoved,
+      bytesBefore,
+      bytesAfter,
+      bytesRemoved: Math.max(0, bytesBefore - bytesAfter),
+      vacuumed,
+      protectedRuns
+    };
+  }
   upsertRun(input, at = (/* @__PURE__ */ new Date()).toISOString()) {
     this.transaction(() => {
       this.db.prepare(`INSERT INTO runs
@@ -533,6 +630,7 @@ var TraceStore = class {
         startedAt: at
       });
     });
+    this.prune(this.retention, at);
   }
   /**
    * Record one fact about a turn the operator ran in the chat loop.
@@ -634,8 +732,42 @@ var TraceStore = class {
         startedAt: input.at
       });
     });
+    this.prune(this.retention, input.at);
   }
 };
+function tracePageStats(db) {
+  const pageSize = Number(db.prepare("PRAGMA page_size").get().page_size);
+  const pageCount = Number(db.prepare("PRAGMA page_count").get().page_count);
+  const freePages = Number(
+    db.prepare("PRAGMA freelist_count").get().freelist_count
+  );
+  return {
+    pageCount,
+    freePages,
+    allocatedBytes: pageCount * pageSize,
+    usedBytes: Math.max(0, pageCount - freePages) * pageSize
+  };
+}
+function deleteTraceRun(db, runId) {
+  let rows = 0;
+  for (const table of ["events", "envelopes", "gate_results", "agent_sessions", "processes", "phases", "runs"]) {
+    const result = db.prepare(`DELETE FROM ${table} WHERE run_id=?`).run(runId);
+    rows += Number(result.changes);
+  }
+  return rows;
+}
+function traceDatabaseFootprintBytes(path) {
+  let total = 0;
+  for (const candidate of [path, `${path}-wal`, `${path}-shm`]) {
+    try {
+      total += statSync(candidate).size;
+    } catch (error) {
+      const code = typeof error === "object" && error !== null && "code" in error ? String(error.code) : "";
+      if (code !== "ENOENT") throw error;
+    }
+  }
+  return total;
+}
 var TraceReader = class {
   constructor(path) {
     this.path = path;
@@ -669,6 +801,39 @@ var TraceReader = class {
       clampInt(limit, 1, TRACE_EVENT_POLL_LIMIT)
     );
   }
+  /**
+   * Per-kind event tallies for one run.
+   *
+   * Aggregated in SQL rather than by reading rows, so `payload_json` and the
+   * free-form event name are never loaded at all. That is the point: a caller
+   * that only ever wants shapes should not be holding the payloads in memory
+   * on the way to counting them.
+   */
+  eventKindCounts(runId) {
+    return this.db.prepare("SELECT type, COUNT(*) AS count FROM events WHERE run_id=? GROUP BY type ORDER BY count DESC, type").all(runId);
+  }
+  /** Total events and the wall span they cover, without reading one of them. */
+  eventSpan(runId) {
+    const row = this.db.prepare(
+      `SELECT COUNT(*) AS total, MIN(started_at) AS firstAt,
+					MAX(COALESCE(ended_at, started_at)) AS lastAt FROM events WHERE run_id=?`
+    ).get(runId);
+    return row ?? { total: 0, firstAt: null, lastAt: null };
+  }
+  /**
+   * Per-kind process tallies for one run.
+   *
+   * Same reason as {@link eventKindCounts}, and more sharply: a process row
+   * carries the command line, the pid, and the host, none of which a shape
+   * count needs.
+   */
+  processKindCounts(runId) {
+    return this.db.prepare(
+      `SELECT kind, COUNT(*) AS total,
+					SUM(CASE WHEN ended_at IS NULL THEN 1 ELSE 0 END) AS running
+				 FROM processes WHERE run_id=? GROUP BY kind ORDER BY total DESC, kind`
+    ).all(runId);
+  }
   processes(runId) {
     return this.db.prepare("SELECT * FROM processes WHERE run_id=? ORDER BY ended_at IS NOT NULL, id").all(runId);
   }
@@ -991,8 +1156,11 @@ function finiteNonNegative(value) {
 
 export {
   TRACE_EVENT_POLL_LIMIT,
+  DEFAULT_TRACE_RETENTION_POLICY,
   traceDatabasePath,
+  resolveTraceRetentionPolicy,
+  TraceStore,
   TraceReader,
   createDispatchTraceMirror
 };
-//# sourceMappingURL=chunk-HFSBBKSQ.js.map
+//# sourceMappingURL=chunk-V5DHCITQ.js.map

package/dist/{chunk-5WIGXA4T.js → chunk-VAZSBTKF.js}

@@ -1,5 +1,15 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
+  sha256
+} from "./chunk-B7OBL7PK.js";
+import {
+  resolvePackageRoot
+} from "./chunk-IWHMRKLL.js";
+import {
+  require_dist
+} from "./chunk-APJ265NV.js";
+import {
+  __toESM,
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
 
@@ -8,8 +18,8 @@ init_esm_shims();
 function compareStrings(a, b) {
   return a.localeCompare(b);
 }
-function topTwoSegments(path) {
-  const parts = path.split("/").slice(0, -1);
+function topTwoSegments(path2) {
+  const parts = path2.split("/").slice(0, -1);
   if (parts.length === 0) return ".";
   return parts.slice(0, 2).join("/");
 }
@@ -115,7 +125,104 @@ function renderCodewikiDigest(codewiki, tokenBudget = 1200) {
   return fitLines(lines, tokenBudget);
 }
 
+// src/domains/prompts/fragment-loader.ts
+init_esm_shims();
+var import_yaml = __toESM(require_dist(), 1);
+import { readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+var frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+var fragmentIdRegex = /^[a-z0-9-]+(?:\.[a-z0-9-]+)+$/;
+function defaultRootDir() {
+  return path.join(resolvePackageRoot(), "src", "domains", "prompts", "fragments");
+}
+function walk(root) {
+  const out = [];
+  let entries;
+  try {
+    entries = readdirSync(root, { withFileTypes: true });
+  } catch {
+    return out;
+  }
+  for (const entry of entries) {
+    const full = path.join(root, entry.name);
+    if (entry.isDirectory()) {
+      out.push(...walk(full));
+      continue;
+    }
+    if (entry.isFile() && entry.name.endsWith(".md")) {
+      out.push(full);
+    }
+  }
+  return out.sort((left, right) => left.localeCompare(right));
+}
+function parseFragment(filePath, rootDir) {
+  const raw = readFileSync(filePath, "utf8");
+  const rawRel = path.relative(rootDir, filePath);
+  const relPath = rawRel.split(path.sep).join("/");
+  const match = raw.match(frontmatterRegex);
+  if (!match) {
+    throw new Error(`fragment-loader: ${relPath}: missing or malformed YAML frontmatter`);
+  }
+  const frontmatterText = match[1] ?? "";
+  const body = match[2] ?? "";
+  let parsed;
+  try {
+    parsed = import_yaml.default.parse(frontmatterText);
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    throw new Error(`fragment-loader: ${relPath}: invalid YAML frontmatter (${reason})`);
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`fragment-loader: ${relPath}: frontmatter must be a YAML object`);
+  }
+  const fm = parsed;
+  const id = fm.id;
+  if (typeof id !== "string" || !fragmentIdRegex.test(id)) {
+    throw new Error(`fragment-loader: ${relPath}: frontmatter.id must be a dot-separated namespace`);
+  }
+  const version = fm.version;
+  if (version !== 1) {
+    throw new Error(`fragment-loader: ${relPath}: frontmatter.version must be 1`);
+  }
+  const description = fm.description;
+  if (typeof description !== "string" || description.trim() === "") {
+    throw new Error(`fragment-loader: ${relPath}: frontmatter.description must be a non-empty string`);
+  }
+  const dynamicRaw = fm.dynamic;
+  if (dynamicRaw !== void 0 && typeof dynamicRaw !== "boolean") {
+    throw new Error(`fragment-loader: ${relPath}: frontmatter.dynamic must be a boolean when present`);
+  }
+  return {
+    path: filePath,
+    relPath,
+    id,
+    version,
+    description,
+    dynamic: dynamicRaw === true,
+    body,
+    contentHash: sha256(raw)
+  };
+}
+function loadFragments(options) {
+  const rootDir = typeof options === "string" ? options : options?.rootDir;
+  const resolvedRoot = rootDir ? path.resolve(rootDir) : defaultRootDir();
+  const files = walk(resolvedRoot);
+  const byId = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const fragment = parseFragment(file, resolvedRoot);
+    const existing = byId.get(fragment.id);
+    if (existing) {
+      throw new Error(
+        `fragment-loader: duplicate fragment id "${fragment.id}" in ${existing.relPath} and ${fragment.relPath}`
+      );
+    }
+    byId.set(fragment.id, fragment);
+  }
+  return { byId, rootDir: resolvedRoot };
+}
+
 export {
-  renderCodewikiDigest
+  renderCodewikiDigest,
+  loadFragments
 };
-//# sourceMappingURL=chunk-5WIGXA4T.js.map
+//# sourceMappingURL=chunk-VAZSBTKF.js.map

package/dist/{chunk-VHN4MY6O.js → chunk-VEO4AP2K.js}

@@ -25,7 +25,7 @@ import {
   ceilChars,
   contentChars,
   estimateAgentMessageTokens
-} from "./chunk-RWSI4YD7.js";
+} from "./chunk-UM7N4G5A.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -674,4 +674,4 @@ export {
   compactionCut,
   selectVisibleEntries
 };
-//# sourceMappingURL=chunk-VHN4MY6O.js.map
+//# sourceMappingURL=chunk-VEO4AP2K.js.map