@hawkeyexl/manni 4.5.0 → 4.6.0

package/dist/{chunk-NGK3N6F2.js → chunk-T6SYGLWR.js}

@@ -6,10 +6,10 @@ import {
   shortPin,
   shortSrc,
   spellAt
-} from "./chunk-TA42STP7.js";
+} from "./chunk-UAKNZVCD.js";
 import {
   parseSrc
-} from "./chunk-UK2I3ACY.js";
+} from "./chunk-MHM4QEBV.js";
 import {
   palette
 } from "./chunk-RNVYGWIC.js";
@@ -452,4 +452,4 @@ export {
   removalLine,
   renderRemovePretty
 };
-//# sourceMappingURL=chunk-NGK3N6F2.js.map
+//# sourceMappingURL=chunk-T6SYGLWR.js.map

package/dist/chunk-TH4JVQPF.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+import {
+  palette
+} from "./chunk-RNVYGWIC.js";
+
+// src/tracevals/rules/local.ts
+import {
+  ensureModel,
+  fits,
+  modelState,
+  nodeLlamaCppStatus
+} from "@hawkeyexl/inference";
+function libraryLocalModels(connections) {
+  const modelsDir = connections["llama-cpp"]?.modelsDir;
+  const options = modelsDir === void 0 ? {} : { modelsDirectory: modelsDir };
+  return {
+    runtimePresent: async () => (await nodeLlamaCppStatus()).state === "present",
+    state: (model) => modelState(model, options),
+    fits: (model) => fits(model, options),
+    ensure: (model) => ensureModel(model, options)
+  };
+}
+var GB = 1024 ** 3;
+
+// src/tracevals/reporters/conformance.ts
+var count = (n, one, many) => `${String(n)} ${n === 1 ? one : many}`;
+function renderCheck(report, opts = {}) {
+  const pc = palette(opts.color === true);
+  const lines = [];
+  for (const source of report.sources) {
+    const findings = report.findings.filter((f) => f.source === source.path);
+    if (findings.length === 0) continue;
+    lines.push(source.path);
+    for (const f of findings) {
+      const mark = f.outcome === "fail" ? pc.red("\u2716") : pc.yellow("?");
+      lines.push(`  ${mark} ${f.rule}  ${f.text}`);
+      lines.push(`      ${pc.dim(`${f.observed} (${f.confidence.toFixed(2)})`)}`);
+    }
+  }
+  lines.push(...sessionSoFar(report));
+  for (const warning of report.warnings) lines.push(`${pc.yellow("!")} ${warning}`);
+  if (lines.length > 0) lines.push("");
+  lines.push(closing(report));
+  return lines.join("\n");
+}
+function sessionSoFar(report) {
+  const rules = report.session?.rules ?? [];
+  if (rules.length === 0) return [];
+  const flagged = rules.filter((r) => r.broken > 0 || r.needsReview > 0);
+  const lines = flagged.map((r) => {
+    const counts = [
+      ["broken", r.broken],
+      ["repaired", r.repaired],
+      ["needs review", r.needsReview],
+      ["followed", r.followed]
+    ];
+    const said = counts.filter(([, n]) => n > 0).map(([word, n]) => `${word} ${String(n)}`);
+    return `  ${r.source}#${r.rule}  ${said.join(", ")}`;
+  });
+  const held = rules.length - flagged.length;
+  if (held > 0) {
+    lines.push(`  ${count(held, "rule", "rules")} held every turn ${held === 1 ? "it" : "they"} applied to.`);
+  }
+  return ["Session so far", ...lines];
+}
+function closing(report) {
+  const head = `Last turn of ${report.sessionId.slice(0, 8)}:`;
+  const { summary } = report;
+  const scope = `${count(summary.rules, "rule", "rules")} from ${count(summary.sources, "source", "sources")}`;
+  switch (report.skipped) {
+    case "empty-turn":
+      return `${head} nothing happened after the last prompt.`;
+    case "no-sources":
+      return `${head} no rule sources governed it.`;
+    case "not-applicable":
+      return `${head} ${scope}, none apply to this turn.`;
+    case null: {
+      const broken = summary.fail > 0 ? `${String(summary.fail)} broken` : "None broken";
+      const review = summary.needsReview > 0 ? `, ${String(summary.needsReview)} needs review` : "";
+      return `${head} ${scope}. ${broken}${review}.`;
+    }
+  }
+}
+var NOT_SET_UP = "tracevals conformance is not set up; nothing to prepare.";
+function renderPrepare(report) {
+  const lines = [];
+  const said = /* @__PURE__ */ new Set();
+  for (const m of report.models) {
+    if (m.state === "hosted" || said.has(m.model)) continue;
+    said.add(m.model);
+    const name = `${m.model} (${m.provider})`;
+    lines.push(
+      m.state === "downloaded" ? `${name} downloaded, ${((m.bytes ?? 0) / GB).toFixed(2)} GB.` : `${name} is ${m.state}.`
+    );
+  }
+  const ex = report.extraction;
+  if (ex !== null) {
+    const files = (n) => `${count(n, "file", "files")} that ${n === 1 ? "applies" : "apply"} to every session`;
+    if (ex.extracted > 0) {
+      lines.push(
+        `Extracted ${count(ex.rules, "rule", "rules")} from ${files(ex.extracted)}.` + (ex.cached > 0 ? ` ${String(ex.cached)} more ${ex.cached === 1 ? "was" : "were"} cached.` : "")
+      );
+    } else if (ex.cached > 0) {
+      lines.push(`${files(ex.cached)} ${ex.cached === 1 ? "is" : "are"} cached. Nothing to extract.`);
+    } else {
+      lines.push("No file applies to every session. Nothing to extract.");
+    }
+  }
+  for (const warning of report.warnings) lines.push(warning);
+  return lines.join("\n");
+}
+var NO_HOST = "No model host is running.";
+function renderRelease(report) {
+  if (!report.hostStopped && report.released.length === 0 && report.unloaded.length === 0) {
+    return NO_HOST;
+  }
+  const unloaded = report.unloaded.length > 0 ? `Unloaded ${report.unloaded.join(", ")}` : "";
+  const stopped = report.hostStopped ? "stopped the model host" : "";
+  const action = [unloaded, stopped].filter((s) => s !== "").join(" and ");
+  const held = count(report.released.length, "session", "sessions");
+  return `${action === "" ? "Released the lease" : action}. ${held} held it.`;
+}
+
+export {
+  libraryLocalModels,
+  GB,
+  renderCheck,
+  NOT_SET_UP,
+  renderPrepare,
+  NO_HOST,
+  renderRelease
+};
+//# sourceMappingURL=chunk-TH4JVQPF.js.map

package/dist/chunk-TH4JVQPF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tracevals/rules/local.ts","../src/tracevals/reporters/conformance.ts"],"sourcesContent":["/**\n * What tracevals asks of a local model without loading it (proposal 0079,\n * gates 5, 8 and 9, and `prepare`). The inference library owns every answer;\n * this is the one seam, so a test can say \"downloading\" without a runtime.\n */\nimport {\n  ensureModel,\n  fits,\n  modelState,\n  nodeLlamaCppStatus,\n  type EnsureModelResult,\n  type FitsResult,\n  type LlamaModelState,\n} from \"@hawkeyexl/inference\";\nimport type { ProviderConnections } from \"../../shared/providers.js\";\n\nexport interface LocalModels {\n  /** Whether the llama.cpp binding is importable now, installing nothing. */\n  runtimePresent(): Promise<boolean>;\n  /** `ready`, `downloading` or `missing`, read without loading or fetching. */\n  state(model: string): Promise<LlamaModelState>;\n  /** The memory probe `auto` tiering uses. */\n  fits(model: string): Promise<FitsResult>;\n  /** Fetch the runtime and the weights, without loading either. */\n  ensure(model: string): Promise<EnsureModelResult>;\n}\n\n/** The library's lifecycle calls, pointed at the family's models directory. */\nexport function libraryLocalModels(connections: ProviderConnections): LocalModels {\n  const modelsDir = connections[\"llama-cpp\"]?.modelsDir;\n  const options = modelsDir === undefined ? {} : { modelsDirectory: modelsDir };\n  return {\n    runtimePresent: async () => (await nodeLlamaCppStatus()).state === \"present\",\n    state: (model) => modelState(model, options),\n    fits: (model) => fits(model, options),\n    ensure: (model) => ensureModel(model, options),\n  };\n}\n\n/** Bytes in a gigabyte as the messages count them. */\nexport const GB = 1024 ** 3;\n","/**\n * Pretty output for `check`, `prepare` and `release` (proposal 0079). JSON is\n * each report as it stands, so only prose lives here. Colour is the caller's\n * decision, made once by `colorFor`.\n */\nimport { palette } from \"../../shared/color.js\";\nimport type { CheckReport } from \"../commands/check.js\";\nimport type { PrepareReport } from \"../commands/prepare.js\";\nimport type { ReleaseReport } from \"../commands/release.js\";\nimport { GB } from \"../rules/local.js\";\n\nconst count = (n: number, one: string, many: string): string =>\n  `${String(n)} ${n === 1 ? one : many}`;\n\n/** Findings grouped under their source, then the closing line. */\nexport function renderCheck(report: CheckReport, opts: { color?: boolean } = {}): string {\n  const pc = palette(opts.color === true);\n  const lines: string[] = [];\n  for (const source of report.sources) {\n    const findings = report.findings.filter((f) => f.source === source.path);\n    if (findings.length === 0) continue;\n    lines.push(source.path);\n    for (const f of findings) {\n      const mark = f.outcome === \"fail\" ? pc.red(\"✖\") : pc.yellow(\"?\");\n      lines.push(`  ${mark} ${f.rule}  ${f.text}`);\n      lines.push(`      ${pc.dim(`${f.observed} (${f.confidence.toFixed(2)})`)}`);\n    }\n  }\n  lines.push(...sessionSoFar(report));\n  for (const warning of report.warnings) lines.push(`${pc.yellow(\"!\")} ${warning}`);\n  if (lines.length > 0) lines.push(\"\");\n  lines.push(closing(report));\n  return lines.join(\"\\n\");\n}\n\n/** The ledger's rules that were ever broken or sent to review, and a count of the rest. */\nfunction sessionSoFar(report: CheckReport): string[] {\n  const rules = report.session?.rules ?? [];\n  if (rules.length === 0) return [];\n  const flagged = rules.filter((r) => r.broken > 0 || r.needsReview > 0);\n  const lines = flagged.map((r) => {\n    const counts = [\n      [\"broken\", r.broken],\n      [\"repaired\", r.repaired],\n      [\"needs review\", r.needsReview],\n      [\"followed\", r.followed],\n    ] as const;\n    const said = counts.filter(([, n]) => n > 0).map(([word, n]) => `${word} ${String(n)}`);\n    return `  ${r.source}#${r.rule}  ${said.join(\", \")}`;\n  });\n  const held = rules.length - flagged.length;\n  if (held > 0) {\n    lines.push(`  ${count(held, \"rule\", \"rules\")} held every turn ${held === 1 ? \"it\" : \"they\"} applied to.`);\n  }\n  return [\"Session so far\", ...lines];\n}\n\nfunction closing(report: CheckReport): string {\n  const head = `Last turn of ${report.sessionId.slice(0, 8)}:`;\n  const { summary } = report;\n  // \"sources\", because a typed prompt is not a file (proposal 0080).\n  const scope = `${count(summary.rules, \"rule\", \"rules\")} from ${count(summary.sources, \"source\", \"sources\")}`;\n  switch (report.skipped) {\n    case \"empty-turn\":\n      return `${head} nothing happened after the last prompt.`;\n    case \"no-sources\":\n      return `${head} no rule sources governed it.`;\n    case \"not-applicable\":\n      return `${head} ${scope}, none apply to this turn.`;\n    case null: {\n      const broken = summary.fail > 0 ? `${String(summary.fail)} broken` : \"None broken\";\n      const review = summary.needsReview > 0 ? `, ${String(summary.needsReview)} needs review` : \"\";\n      return `${head} ${scope}. ${broken}${review}.`;\n    }\n  }\n}\n\nexport const NOT_SET_UP = \"tracevals conformance is not set up; nothing to prepare.\";\n\nexport function renderPrepare(report: PrepareReport): string {\n  const lines: string[] = [];\n  const said = new Set<string>();\n  for (const m of report.models) {\n    if (m.state === \"hosted\" || said.has(m.model)) continue;\n    said.add(m.model);\n    const name = `${m.model} (${m.provider})`;\n    lines.push(\n      m.state === \"downloaded\"\n        ? `${name} downloaded, ${((m.bytes ?? 0) / GB).toFixed(2)} GB.`\n        : `${name} is ${m.state}.`,\n    );\n  }\n  const ex = report.extraction;\n  if (ex !== null) {\n    const files = (n: number): string =>\n      `${count(n, \"file\", \"files\")} that ${n === 1 ? \"applies\" : \"apply\"} to every session`;\n    if (ex.extracted > 0) {\n      lines.push(\n        `Extracted ${count(ex.rules, \"rule\", \"rules\")} from ${files(ex.extracted)}.` +\n          (ex.cached > 0 ? ` ${String(ex.cached)} more ${ex.cached === 1 ? \"was\" : \"were\"} cached.` : \"\"),\n      );\n    } else if (ex.cached > 0) {\n      lines.push(`${files(ex.cached)} ${ex.cached === 1 ? \"is\" : \"are\"} cached. Nothing to extract.`);\n    } else {\n      lines.push(\"No file applies to every session. Nothing to extract.\");\n    }\n  }\n  for (const warning of report.warnings) lines.push(warning);\n  return lines.join(\"\\n\");\n}\n\nexport const NO_HOST = \"No model host is running.\";\n\nexport function renderRelease(report: ReleaseReport): string {\n  if (!report.hostStopped && report.released.length === 0 && report.unloaded.length === 0) {\n    return NO_HOST;\n  }\n  const unloaded = report.unloaded.length > 0 ? `Unloaded ${report.unloaded.join(\", \")}` : \"\";\n  const stopped = report.hostStopped ? \"stopped the model host\" : \"\";\n  const action = [unloaded, stopped].filter((s) => s !== \"\").join(\" and \");\n  const held = count(report.released.length, \"session\", \"sessions\");\n  return `${action === \"\" ? \"Released the lease\" : action}. ${held} held it.`;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-TVIX653Q.js → chunk-TLXE7LYK.js}

@@ -10,7 +10,7 @@ import {
   pageMarks,
   pageSchemaSet,
   withValueAt
-} from "./chunk-HVFR66GQ.js";
+} from "./chunk-TUAAR3MM.js";
 import {
   DocmetaError,
   escapePointerSegment,
@@ -20,12 +20,12 @@ import {
   rebaseConfigSchemaRefs,
   schemaTrustRoot,
   supportedExtensions
-} from "./chunk-527HHQPS.js";
+} from "./chunk-KCOFEWV5.js";
 import {
   decryptValue,
   encryptValue,
   isEncryptedValue
-} from "./chunk-Q35YIDBV.js";
+} from "./chunk-XKBEHKWO.js";
 import {
   errorMessage
 } from "./chunk-G3T47CFV.js";
@@ -195,4 +195,4 @@ export {
   metaPageView,
   declaredAt
 };
-//# sourceMappingURL=chunk-TVIX653Q.js.map
+//# sourceMappingURL=chunk-TLXE7LYK.js.map