@mnemom/mnemom 0.17.35 → 0.17.37

package/node_modules/@mnemom/aip-verifier/dist/render-lines.cjs

@@ -0,0 +1,879 @@
+'use strict';
+
+var ed25519 = require('@noble/ed25519');
+var utils_js = require('@noble/hashes/utils.js');
+var sha2_js = require('@noble/hashes/sha2.js');
+
+// src/claim-table.ts
+var CLAIM_CLASSES = ["measured", "verdict", "estimate", "benchmark", "outcome"];
+var SURFACES = ["record_page", "check_summary", "pr_comment", "share_card", "period_card"];
+var CARD_SURFACES = ["share_card", "period_card"];
+var ESTIMATE_FORBIDDEN_SURFACES = ["pr_comment", "share_card", "period_card"];
+var MODES = ["off", "observe", "nudge", "enforce"];
+var MODE_VERBS = {
+  off: "not checked",
+  observe: "flagged",
+  nudge: "flagged, agent nudged",
+  enforce: "stopped"
+};
+var PROTECTION_VERDICTS = ["pass", "warn", "nudge", "quarantine", "block"];
+function protectionVerb(mode, verdict) {
+  if (mode === "off" || verdict === "pass") return null;
+  if (mode === "observe") return MODE_VERBS.observe;
+  if (mode === "nudge") return verdict === "nudge" ? MODE_VERBS.nudge : MODE_VERBS.observe;
+  return verdict === "block" || verdict === "quarantine" ? MODE_VERBS.enforce : MODE_VERBS.observe;
+}
+var CLAIM_TABLE = {
+  commits_recorded: { class: "measured", verb_by_mode: false, money_allowed: false },
+  messages_from_person: { class: "measured", verb_by_mode: false, money_allowed: false },
+  compactions: { class: "measured", verb_by_mode: false, money_allowed: false },
+  tokens_sent_vs_reaching: { class: "measured", verb_by_mode: false, money_allowed: false },
+  peak_context: { class: "measured", verb_by_mode: false, money_allowed: false },
+  model_cost: { class: "measured", verb_by_mode: false, money_allowed: true },
+  mu_cost: { class: "measured", verb_by_mode: false, money_allowed: true },
+  approval: { class: "measured", verb_by_mode: false, money_allowed: false },
+  /** How the goal was set: "sealed contract", "implicit goal" or "not checked" (M7: its own measured line). */
+  goal_mode: { class: "measured", verb_by_mode: false, money_allowed: false },
+  goal: { class: "verdict", verb_by_mode: true, money_allowed: false },
+  /** The protection area's mode when no act is shown: "not checked" under off. */
+  protection_mode: { class: "measured", verb_by_mode: false, money_allowed: false },
+  protection: { class: "verdict", verb_by_mode: true, money_allowed: false },
+  autonomy: { class: "measured", verb_by_mode: false, money_allowed: false },
+  savings_estimate: {
+    class: "estimate",
+    verb_by_mode: false,
+    money_allowed: true,
+    surfaces: ["record_page", "check_summary"]
+  },
+  benchmark: { class: "benchmark", verb_by_mode: false, money_allowed: false },
+  outcome: { class: "outcome", verb_by_mode: false, money_allowed: false }
+};
+function isClaimField(field) {
+  return typeof field === "string" && Object.prototype.hasOwnProperty.call(CLAIM_TABLE, field);
+}
+var LINE_KEY_FIELDS = {
+  "cost.model": "model_cost",
+  "cost.mu": "mu_cost",
+  "goal.mode": "goal_mode",
+  "goal.verdict": "goal",
+  "protection.mode": "protection_mode",
+  "people.messages": "messages_from_person",
+  "context.compactions": "compactions"
+};
+var PROTECTION_ACT_KEY = /^protection\.act\.\d+$/;
+function fieldForLineKey(key) {
+  if (typeof key !== "string") return void 0;
+  if (PROTECTION_ACT_KEY.test(key)) return "protection";
+  return Object.prototype.hasOwnProperty.call(LINE_KEY_FIELDS, key) ? LINE_KEY_FIELDS[key] : void 0;
+}
+
+// src/claim-lint.ts
+var LINT_RULES = {
+  one_class_per_line: "one_class_per_line",
+  forbidden_word: "forbidden_word",
+  money_on_goal_or_protection: "money_on_goal_or_protection",
+  implicit_goal_sealed: "implicit_goal_sealed",
+  goal_off_not_checked: "goal_off_not_checked",
+  estimate_on_forbidden_surface: "estimate_on_forbidden_surface",
+  verb_mismatch: "verb_mismatch",
+  enforce_without_tool_name: "enforce_without_tool_name",
+  tool_name_on_card: "tool_name_on_card",
+  tool_arguments_shown: "tool_arguments_shown",
+  trust_claim: "trust_claim",
+  savings_percentage: "savings_percentage",
+  benchmark_not_published: "benchmark_not_published",
+  verdict_without_coverage: "verdict_without_coverage",
+  card_class_not_allowed: "card_class_not_allowed",
+  period_card_without_revert: "period_card_without_revert",
+  field_not_on_surface: "field_not_on_surface",
+  provisional_mu_on_card: "provisional_mu_on_card",
+  provisional_mu_off_cost_line: "provisional_mu_off_cost_line",
+  unknown_surface: "unknown_surface"
+};
+function clauseHas(text, rule) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const m of text.matchAll(rule.tokens)) {
+    const kind = Object.entries(m.groups ?? {}).find(([, v]) => v !== void 0)?.[0];
+    if (kind === void 0) continue;
+    if (kind === "brk") {
+      seen.clear();
+      continue;
+    }
+    if (rule.alone?.includes(kind)) return true;
+    if (rule.pairs.some(([first, then]) => then === kind && seen.has(first))) return true;
+    seen.add(kind);
+  }
+  return false;
+}
+var FORBIDDEN_WORD = /\b(safe|safely|unsafe|correct|correctly|incorrect|prevent|prevents|prevented|preventing|prevention)\b/i;
+var MONEY = /(?:\$|€|£|¥)\s?\d|\b(?<!\d,+)\d[\d,]*(?:\.\d+)?\s?(?:USD|EUR|GBP|dollars?|cents?)\b/i;
+var SEALED = /\bsealed\b/i;
+var ESTIMATE_WORDS = /\b(estimate[ds]?|estimation|saving|savings|saved|would have cost|counterfactual)\b/i;
+var TRUST_CLAIM = /\b(minutes?|seconds?|hours?)\s+to\s+trust\b|\btrust(ed)?\s+in\s+(under\s+|about\s+)?\d+\s*(minutes?|seconds?|hours?|min|s|h)\b|\breview[- ]time\b|\btime\s+to\s+review\b|\bwithout\s+re-?check(ing)?\b|\bno\s+need\s+to\s+(re-?check|review)\b|\btrust(ed)?\s+without\b/i;
+var SAVINGS_PERCENTAGE = {
+  tokens: /\d+(?<percent>(?:\.\d+)?\s?%)?|\b(?<less>less)\b|\b(?<saving>sav(?:e[sd]?|ings?)|cheaper|reduction|reduced)\b|(?<brk>[.\n])/gi,
+  pairs: [
+    ["percent", "saving"],
+    ["percent", "less"],
+    ["saving", "percent"]
+  ]
+};
+var REVERT = /\brevert(s|ed)?\b/i;
+var PROVISIONAL_MU = {
+  tokens: /(?<approx>(?:≈|~|\bapprox(?:\.|imately)?\b|\babout\b)\s*\d[\d,]*(?:\.\d+)?\s*(?:mmu\b|mu\b|μ|µ))|\d[\d,]*(?<amount>(?:\.\d+)?\s*(?:mmu\b|mu\b|μ|µ))?|\b(?<pending>pending)\b|(?<brk>[.\n])/gi,
+  alone: ["approx"],
+  pairs: [
+    ["amount", "pending"],
+    ["pending", "amount"]
+  ]
+};
+var NOT_CHECKED = /^not checked$/i;
+var COVERAGE_IN_TEXT = /\b(\d+)\s+of\s+(\d+)\s+turns\s+judged\b/i;
+var MODE_VERB_REGEX = {
+  off: NOT_CHECKED,
+  observe: /\bflagged\b/i,
+  nudge: /\bflagged, agent nudged\b/i,
+  enforce: /\bstopped\b/i
+};
+var OTHER_MODE_VERBS = {
+  off: [/\bflagged\b/i, /\bnudged\b/i, /\bstopped\b/i],
+  observe: [/\bnudged\b/i, /\bstopped\b/i],
+  nudge: [/\bstopped\b/i],
+  enforce: [/\bflagged\b/i, /\bnudged\b/i]
+};
+function isObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function coverageObjectValid(cov) {
+  return isObject(cov) && Number.isInteger(cov.judged) && Number.isInteger(cov.total) && cov.judged >= 0 && cov.total >= cov.judged;
+}
+function coverageShown(line) {
+  const cov = line.coverage;
+  if (cov !== void 0) return coverageObjectValid(cov);
+  const m = COVERAGE_IN_TEXT.exec(line.text);
+  return m !== null && Number(m[2]) >= Number(m[1]);
+}
+function expectedVerb(mode, verdict) {
+  if (mode === "off") return "off";
+  if (verdict === void 0) return mode === "observe" ? "observe" : void 0;
+  if (!PROTECTION_VERDICTS.includes(verdict)) return void 0;
+  const verb = protectionVerb(mode, verdict);
+  return MODES.find((m) => MODE_VERBS[m] === verb);
+}
+function escapeRegExp(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function argumentsAppear(text, args) {
+  if (args === void 0 || args === null) return false;
+  const needles = [];
+  const walk = (v) => {
+    if (typeof v === "string") {
+      if (v.length >= 3) needles.push(v);
+    } else if (typeof v === "number" || typeof v === "boolean") {
+      needles.push(String(v));
+    } else if (Array.isArray(v)) {
+      v.forEach(walk);
+    } else if (isObject(v)) {
+      Object.values(v).forEach(walk);
+    }
+  };
+  walk(args);
+  if (needles.length === 0) return false;
+  try {
+    needles.push(JSON.stringify(args));
+  } catch {
+  }
+  return needles.some((n) => n.length > 0 && text.includes(n));
+}
+function lintLine(surface, line, index, out) {
+  const push = (rule) => {
+    out.push({ rule, line: index, text: isObject(line) && typeof line.text === "string" ? line.text : "" });
+  };
+  if (!isObject(line) || typeof line.text !== "string" || typeof line.class !== "string") {
+    push(LINT_RULES.one_class_per_line);
+    return;
+  }
+  const text = line.text;
+  const onCard = CARD_SURFACES.includes(surface);
+  const field = line.field !== void 0 ? line.field : fieldForLineKey(line.key);
+  const cls = line.class;
+  if (!CLAIM_CLASSES.includes(cls)) {
+    push(LINT_RULES.one_class_per_line);
+  } else if (field !== void 0) {
+    if (!isClaimField(field)) {
+      push(LINT_RULES.one_class_per_line);
+    } else {
+      const entry = CLAIM_TABLE[field];
+      if (entry.class !== cls) push(LINT_RULES.one_class_per_line);
+      if (entry.surfaces && !entry.surfaces.includes(surface)) {
+        push(LINT_RULES.field_not_on_surface);
+      }
+    }
+  }
+  if (cls !== "estimate" && ESTIMATE_WORDS.test(text)) push(LINT_RULES.one_class_per_line);
+  if (FORBIDDEN_WORD.test(text)) push(LINT_RULES.forbidden_word);
+  const isGoal = field === "goal" || field === "goal_mode";
+  const isProtection = field === "protection" || field === "protection_mode";
+  if ((isGoal || isProtection) && MONEY.test(text)) push(LINT_RULES.money_on_goal_or_protection);
+  if (field !== void 0 && isClaimField(field) && !CLAIM_TABLE[field].money_allowed) {
+    if (!isGoal && !isProtection && MONEY.test(text)) push(LINT_RULES.one_class_per_line);
+  }
+  if (isGoal) {
+    if (line.goal_mode === "implicit" && SEALED.test(text)) push(LINT_RULES.implicit_goal_sealed);
+    if (line.goal_mode === "off" && !NOT_CHECKED.test(text.trim())) push(LINT_RULES.goal_off_not_checked);
+  }
+  if (cls === "estimate" || ESTIMATE_WORDS.test(text)) {
+    if (ESTIMATE_FORBIDDEN_SURFACES.includes(surface)) push(LINT_RULES.estimate_on_forbidden_surface);
+  }
+  if (line.mode !== void 0) {
+    const verb = MODES.includes(line.mode) ? expectedVerb(line.mode, line.verdict) : void 0;
+    const name = typeof line.tool_name === "string" ? line.tool_name.trim() : "";
+    const nameShown = name.length > 0 && new RegExp(`(^|[^A-Za-z0-9_])${escapeRegExp(name)}([^A-Za-z0-9_]|$)`).test(text);
+    if (verb === void 0) {
+      push(LINT_RULES.verb_mismatch);
+    } else if (!MODE_VERB_REGEX[verb].test(verb === "off" ? text.trim() : text)) {
+      push(LINT_RULES.verb_mismatch);
+    } else if (OTHER_MODE_VERBS[verb].some((re) => re.test(text))) {
+      push(LINT_RULES.verb_mismatch);
+    } else if (verb !== "enforce" && nameShown && !onCard) {
+      push(LINT_RULES.verb_mismatch);
+    }
+    if (onCard) {
+      if (nameShown) push(LINT_RULES.tool_name_on_card);
+    } else if (verb === "enforce" && !nameShown) {
+      push(LINT_RULES.enforce_without_tool_name);
+    }
+  }
+  if (argumentsAppear(text, line.tool_arguments)) push(LINT_RULES.tool_arguments_shown);
+  if (clauseHas(text, PROVISIONAL_MU)) {
+    if (onCard) push(LINT_RULES.provisional_mu_on_card);
+    if (field !== "mu_cost") push(LINT_RULES.provisional_mu_off_cost_line);
+  }
+  if (TRUST_CLAIM.test(text)) push(LINT_RULES.trust_claim);
+  if (clauseHas(text, SAVINGS_PERCENTAGE)) push(LINT_RULES.savings_percentage);
+  if (cls === "benchmark") push(LINT_RULES.benchmark_not_published);
+  if (cls === "verdict") {
+    const covered = onCard ? coverageObjectValid(line.coverage) : field === "protection" || coverageShown(line);
+    if (!covered) push(LINT_RULES.verdict_without_coverage);
+  }
+  if (onCard && cls !== "measured" && cls !== "verdict" && cls !== "outcome") push(LINT_RULES.card_class_not_allowed);
+}
+function lintRendering(rendering) {
+  const violations = [];
+  if (!isObject(rendering) || !Array.isArray(rendering.lines)) {
+    return { ok: false, violations: [{ rule: LINT_RULES.unknown_surface, line: -1, text: "" }] };
+  }
+  const surface = rendering.surface;
+  if (!SURFACES.includes(surface)) {
+    return { ok: false, violations: [{ rule: LINT_RULES.unknown_surface, line: -1, text: String(surface) }] };
+  }
+  const lines = rendering.lines;
+  lines.forEach((line, i) => lintLine(surface, line, i, violations));
+  if (surface === "period_card") {
+    const hasRevert = lines.some(
+      (l) => isObject(l) && l.class === "outcome" && typeof l.text === "string" && REVERT.test(l.text)
+    );
+    if (!hasRevert) violations.push({ rule: LINT_RULES.period_card_without_revert, line: -1, text: "" });
+  }
+  return { ok: violations.length === 0, violations };
+}
+
+// src/render-estimate.ts
+var ESTIMATE_COUNTING_FLOOR_TOKENS = 2e5;
+var ESTIMATE_DISQUALIFIERS = {
+  not_an_object: "not_an_object",
+  method_not_lower_bound: "method_not_lower_bound",
+  counting_floor_below_200k: "counting_floor_below_200k",
+  not_net_of_mu: "not_net_of_mu",
+  never_shows_loss: "never_shows_loss",
+  value_not_finite: "value_not_finite"
+};
+function isObject2(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function estimateQualifies(estimate) {
+  if (!isObject2(estimate)) return { qualifies: false, reasons: [ESTIMATE_DISQUALIFIERS.not_an_object] };
+  const reasons = [];
+  if (estimate.method !== "lower_bound") reasons.push(ESTIMATE_DISQUALIFIERS.method_not_lower_bound);
+  const floor = estimate.counting_floor_tokens;
+  if (typeof floor !== "number" || !Number.isFinite(floor) || floor < ESTIMATE_COUNTING_FLOOR_TOKENS) {
+    reasons.push(ESTIMATE_DISQUALIFIERS.counting_floor_below_200k);
+  }
+  if (estimate.net_of_mu !== true) reasons.push(ESTIMATE_DISQUALIFIERS.not_net_of_mu);
+  if (estimate.reports_loss !== true) reasons.push(ESTIMATE_DISQUALIFIERS.never_shows_loss);
+  if (typeof estimate.net_lower_bound !== "number" || !Number.isFinite(estimate.net_lower_bound)) {
+    reasons.push(ESTIMATE_DISQUALIFIERS.value_not_finite);
+  }
+  return { qualifies: reasons.length === 0, reasons };
+}
+var RENDER_ESTIMATE_REASONS = {
+  unknown_surface: "unknown_surface",
+  surface_never_shows_estimate: "surface_never_shows_estimate",
+  estimate_does_not_qualify: "estimate_does_not_qualify"
+};
+function shouldRenderEstimate(estimate, surface) {
+  if (!SURFACES.includes(surface)) {
+    return { render: false, reasons: [RENDER_ESTIMATE_REASONS.unknown_surface] };
+  }
+  if (ESTIMATE_FORBIDDEN_SURFACES.includes(surface)) {
+    return { render: false, reasons: [RENDER_ESTIMATE_REASONS.surface_never_shows_estimate] };
+  }
+  const q = estimateQualifies(estimate);
+  if (!q.qualifies) {
+    return { render: false, reasons: [RENDER_ESTIMATE_REASONS.estimate_does_not_qualify, ...q.reasons] };
+  }
+  return { render: true, reasons: [] };
+}
+
+// src/canonical.ts
+function canonicalJson(value) {
+  if (value === null || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map(canonicalJson).join(",")}]`;
+  }
+  const record = value;
+  const entries = Object.keys(record).sort().map((k) => `${JSON.stringify(k)}:${canonicalJson(record[k])}`);
+  return `{${entries.join(",")}}`;
+}
+function base64urlToUint8(input) {
+  if (typeof input !== "string" || !/^[A-Za-z0-9_-]*={0,2}$/.test(input)) {
+    throw new Error("not base64url");
+  }
+  const b64 = input.replace(/-/g, "+").replace(/_/g, "/").replace(/=+$/, "");
+  const padded = b64 + "===".slice(0, (4 - b64.length % 4) % 4);
+  const binary = atob(padded);
+  const out = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) out[i] = binary.charCodeAt(i);
+  return out;
+}
+function hexToUint8(hex) {
+  return utils_js.hexToBytes(hex);
+}
+
+// src/sharecard.ts
+var SHARE_CARD_TYP = "AAP-ShareCard/v1";
+var IDENTIFYING_KEYS = /* @__PURE__ */ new Set([
+  "repo",
+  "repository",
+  "repo_name",
+  "branch",
+  "branch_name",
+  "ref",
+  "pr",
+  "pr_title",
+  "pull_request",
+  "title",
+  "commit",
+  "commit_message",
+  "commit_sha",
+  "message",
+  "author",
+  "email",
+  "url",
+  "path"
+]);
+var CARD_KEYS = ["typ", "card_id", "period", "issued_at", "signing_key_id", "statements", "lines", "signature"];
+var PERIOD_KEYS = ["start", "end"];
+var STATEMENT_KEYS = ["typ", "hash"];
+var LINE_KEYS = ["id", "kind", "label", "value", "statement_hash"];
+var HEX64 = /^[0-9a-f]{64}$/;
+var DATE = /^\d{4}-\d{2}-\d{2}$/;
+var OPAQUE_ID = /^[a-z0-9_-]{1,64}$/;
+var LABEL = /^[A-Za-z0-9 .,()+-]{1,40}$/;
+var LABEL_MAX = 40;
+var SHARE_CARD_STATEMENT_TYPES = [
+  "AAP-ConductRecord/v1",
+  "AAP-PRRecord/v1",
+  "AAP-Outcome/v1"
+];
+var SIGNATURE_LEN = 86;
+var RFC3339 = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:Z|([+-])(\d{2}):(\d{2}))$/;
+function isCalendarDate(y, m, d) {
+  if (m < 1 || m > 12 || d < 1) return false;
+  const dim = [31, y % 4 === 0 && (y % 100 !== 0 || y % 400 === 0) ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][m - 1];
+  return d <= dim;
+}
+function isRfc3339(v) {
+  const m = RFC3339.exec(v);
+  if (!m) return false;
+  const [y, mo, d, h, mi, se] = m.slice(1, 7).map(Number);
+  if (!isCalendarDate(y, mo, d) || h > 23 || mi > 59 || se > 59) return false;
+  if (m[7] !== void 0 && (Number(m[8]) > 23 || Number(m[9]) > 59)) return false;
+  return true;
+}
+function shareCardSigningInput(card) {
+  const { signature: _signature, ...rest } = card;
+  return canonicalJson(rest);
+}
+function bytesToBase64url(b) {
+  let bin = "";
+  for (const x of b) bin += String.fromCharCode(x);
+  return btoa(bin).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function base64urlToBytes(s) {
+  if (s.length !== SIGNATURE_LEN || !/^[A-Za-z0-9_-]+$/.test(s)) throw new Error("bad base64url");
+  const padded = s.replace(/-/g, "+").replace(/_/g, "/") + "===".slice(0, (4 - s.length % 4) % 4);
+  const bin = atob(padded);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  if (out.length !== 64 || bytesToBase64url(out) !== s) throw new Error("non-canonical base64url");
+  return out;
+}
+function isObj(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function exactKeys(obj, allowed, where, errors) {
+  for (const k of Object.keys(obj)) {
+    if (IDENTIFYING_KEYS.has(k.toLowerCase())) errors.push(`${where}: identifying field "${k}" is not allowed`);
+    else if (!allowed.includes(k)) errors.push(`${where}: unknown field "${k}"`);
+  }
+  for (const k of allowed) if (!(k in obj)) errors.push(`${where}: missing field "${k}"`);
+}
+function validateShareCardShape(card) {
+  const errors = [];
+  if (!isObj(card)) return ["card: not an object"];
+  exactKeys(card, CARD_KEYS, "card", errors);
+  if (card.typ !== SHARE_CARD_TYP) errors.push(`card: typ must be ${SHARE_CARD_TYP}`);
+  if (typeof card.card_id !== "string" || !OPAQUE_ID.test(card.card_id)) errors.push("card: card_id must be an opaque id matching ^[a-z0-9_-]{1,64}$");
+  if (typeof card.issued_at !== "string" || !isRfc3339(card.issued_at)) errors.push("card: issued_at must be an RFC 3339 date-time");
+  if (typeof card.signing_key_id !== "string" || !card.signing_key_id) errors.push("card: signing_key_id must be a non-empty string");
+  if (typeof card.signature !== "string") errors.push("card: signature must be a string");
+  else {
+    try {
+      base64urlToBytes(card.signature);
+    } catch {
+      errors.push("card: signature must be a canonical 86-char unpadded base64url Ed25519 signature");
+    }
+  }
+  if (!isObj(card.period)) errors.push("period: not an object");
+  else {
+    exactKeys(card.period, PERIOD_KEYS, "period", errors);
+    for (const k of PERIOD_KEYS) {
+      const v = card.period[k];
+      if (typeof v !== "string" || !DATE.test(v) || !isCalendarDate(Number(v.slice(0, 4)), Number(v.slice(5, 7)), Number(v.slice(8, 10)))) {
+        errors.push(`period.${k}: must be a real calendar date YYYY-MM-DD`);
+      }
+    }
+    const { start, end } = card.period;
+    if (typeof start === "string" && typeof end === "string" && DATE.test(start) && DATE.test(end) && start > end) {
+      errors.push("period: start must be <= end");
+    }
+  }
+  const hashes = /* @__PURE__ */ new Set();
+  const referenced = /* @__PURE__ */ new Set();
+  const lineIds = /* @__PURE__ */ new Set();
+  if (!Array.isArray(card.statements) || card.statements.length === 0) errors.push("statements: must be a non-empty array");
+  else
+    card.statements.forEach((s, i) => {
+      if (!isObj(s)) return void errors.push(`statements[${i}]: not an object`);
+      exactKeys(s, STATEMENT_KEYS, `statements[${i}]`, errors);
+      if (typeof s.typ !== "string" || !SHARE_CARD_STATEMENT_TYPES.includes(s.typ)) {
+        errors.push(`statements[${i}].typ: must be one of ${SHARE_CARD_STATEMENT_TYPES.join(", ")}`);
+      }
+      if (typeof s.hash !== "string" || !HEX64.test(s.hash)) errors.push(`statements[${i}].hash: must be 64 lowercase hex`);
+      else hashes.add(s.hash);
+    });
+  if (!Array.isArray(card.lines) || card.lines.length === 0) errors.push("lines: must be a non-empty array");
+  else
+    card.lines.forEach((l, i) => {
+      if (!isObj(l)) return void errors.push(`lines[${i}]: not an object`);
+      exactKeys(l, LINE_KEYS, `lines[${i}]`, errors);
+      if (typeof l.id !== "string" || !OPAQUE_ID.test(l.id)) errors.push(`lines[${i}].id: must be an opaque id matching ^[a-z0-9_-]{1,64}$`);
+      else if (lineIds.has(l.id)) errors.push(`lines[${i}].id: duplicate line id "${l.id}"`);
+      else lineIds.add(l.id);
+      if (l.kind !== "count" && l.kind !== "revert") errors.push(`lines[${i}].kind: must be "count" or "revert"`);
+      if (typeof l.label !== "string" || !l.label || l.label.length > LABEL_MAX || /[/#]|:\/\/|www\./i.test(l.label) || !LABEL.test(l.label)) {
+        errors.push(`lines[${i}].label: must be short plain text (max ${LABEL_MAX}), no "/", "#" or URLs`);
+      }
+      if (typeof l.value !== "number" || !Number.isSafeInteger(l.value) || l.value < 0) errors.push(`lines[${i}].value: must be a non-negative integer`);
+      if (typeof l.statement_hash !== "string" || !HEX64.test(l.statement_hash)) errors.push(`lines[${i}].statement_hash: must be 64 lowercase hex`);
+      else if (!hashes.has(l.statement_hash)) errors.push(`lines[${i}].statement_hash: not committed in statements`);
+      else referenced.add(l.statement_hash);
+    });
+  for (const h of hashes) if (!referenced.has(h)) errors.push(`statements: ${h} is not referenced by any line`);
+  return errors;
+}
+async function verifyShareCard(card, options) {
+  const fail2 = (errors) => ({ valid: false, lines: [], errors });
+  const shapeErrors = validateShareCardShape(card);
+  if (shapeErrors.length > 0) return fail2(shapeErrors);
+  const c = card;
+  let ok = false;
+  try {
+    const pk = typeof options.publicKey === "string" ? hexToUint8(options.publicKey) : options.publicKey;
+    ok = await ed25519.verifyAsync(base64urlToBytes(c.signature), utils_js.utf8ToBytes(shareCardSigningInput(c)), pk, { zip215: false });
+  } catch {
+    ok = false;
+  }
+  if (!ok) return fail2(["signature: verification failed"]);
+  return { valid: true, lines: c.lines.map((l) => ({ ...l })), errors: [] };
+}
+
+// src/statements.ts
+var STATEMENT_TYPES = [
+  "AAP-ConductRecord/v1",
+  "AAP-PRRecord/v1",
+  "AAP-Outcome/v1",
+  "AAP-ShareCard/v1"
+];
+var BUNDLE_TYP = "AAP-RecordBundle/v1";
+var CARD_LINE_CLASSES = ["measured", "verdict", "outcome"];
+var REASONS = {
+  not_an_object: "not_an_object",
+  unknown_typ: "unknown_typ",
+  unsupported_alg: "unsupported_alg",
+  signing_key_id_missing: "signing_key_id_missing",
+  signature_missing: "signature_missing",
+  signature_malformed: "signature_malformed",
+  key_not_found: "key_not_found",
+  key_not_ed25519: "key_not_ed25519",
+  signature_invalid: "signature_invalid",
+  bundle_not_an_object: "bundle_not_an_object",
+  bundle_unknown_typ: "bundle_unknown_typ",
+  bundle_statements_missing: "bundle_statements_missing",
+  digest_malformed: "digest_malformed",
+  linked_statement_wrong_typ: "linked_statement_wrong_typ",
+  card_line_class_not_allowed: "card_line_class_not_allowed",
+  card_verdict_without_coverage: "card_verdict_without_coverage"
+};
+var FLAGS = {
+  card_hash_not_recorded: "card hash not recorded",
+  card_not_bound: "card not bound",
+  linked_statement_not_in_bundle: "linked statement not in bundle"
+};
+
+// src/verify-record.ts
+var DIGEST_RE = /^[0-9a-f]{64}$/;
+function isObject3(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function statementCommitment(statement) {
+  const { signature: _signature, ...rest } = statement;
+  return canonicalJson(rest);
+}
+function statementDigest(statement) {
+  return utils_js.bytesToHex(sha2_js.sha256(utils_js.utf8ToBytes(statementCommitment(statement))));
+}
+function selectKey(jwks, kid) {
+  const keys = isObject3(jwks) && Array.isArray(jwks.keys) ? jwks.keys : [];
+  const jwk = keys.find((k) => isObject3(k) && k.kid === kid);
+  if (!jwk) return { reason: REASONS.key_not_found };
+  if (jwk.alg !== "EdDSA" || jwk.kty !== "OKP" || jwk.crv !== "Ed25519" || typeof jwk.x !== "string") {
+    return { reason: REASONS.key_not_ed25519 };
+  }
+  let key;
+  try {
+    key = base64urlToUint8(jwk.x);
+  } catch {
+    return { reason: REASONS.key_not_ed25519 };
+  }
+  if (key.length !== 32) return { reason: REASONS.key_not_ed25519 };
+  return { key };
+}
+function checkpointFlags(checkpoints) {
+  if (!Array.isArray(checkpoints)) return [];
+  const flags = [];
+  for (const c of checkpoints) {
+    if (!isObject3(c)) continue;
+    const subject = typeof c.checkpoint_id === "string" ? c.checkpoint_id : "<no checkpoint_id>";
+    if (typeof c.card_hash !== "string" || c.card_hash.length === 0) {
+      flags.push({ flag: FLAGS.card_hash_not_recorded, subject });
+    }
+    const bound = typeof c.combined_commitment === "string" && c.combined_commitment.length > 0 && typeof c.commitment_signature === "string" && c.commitment_signature.length > 0;
+    if (!bound) flags.push({ flag: FLAGS.card_not_bound, subject });
+  }
+  return flags;
+}
+function shareCardReasons(lines) {
+  if (!Array.isArray(lines)) return [];
+  const reasons = [];
+  for (const line of lines) {
+    if (!isObject3(line) || !CARD_LINE_CLASSES.includes(line.class)) {
+      reasons.push(REASONS.card_line_class_not_allowed);
+      continue;
+    }
+    if (line.class === "verdict") {
+      const cov = line.coverage;
+      const ok = isObject3(cov) && Number.isInteger(cov.judged) && Number.isInteger(cov.total) && cov.judged >= 0 && cov.total >= cov.judged;
+      if (!ok) reasons.push(REASONS.card_verdict_without_coverage);
+    }
+  }
+  return [...new Set(reasons)];
+}
+function digestFieldsOf(statement) {
+  const out = [];
+  if (statement.previous_digest !== void 0 && statement.previous_digest !== null) {
+    out.push(statement.previous_digest);
+  }
+  if (statement.pr_record_digest !== void 0) out.push(statement.pr_record_digest);
+  if (statement.source_digest !== void 0) out.push(statement.source_digest);
+  if (statement.conduct_digests !== void 0) {
+    if (Array.isArray(statement.conduct_digests)) out.push(...statement.conduct_digests);
+    else out.push(null);
+  }
+  return out;
+}
+async function verifyStatement(statement, jwks) {
+  const fail2 = (reasons2, partial = {}) => ({
+    valid: false,
+    typ: null,
+    digest: null,
+    signing_key_id: null,
+    flags: [],
+    ...partial,
+    reasons: reasons2
+  });
+  if (!isObject3(statement)) return fail2([REASONS.not_an_object]);
+  const typ = typeof statement.typ === "string" ? statement.typ : null;
+  const digest = statementDigest(statement);
+  const kid = typeof statement.signing_key_id === "string" ? statement.signing_key_id : null;
+  const base = { typ, digest, signing_key_id: kid };
+  if (!typ || !STATEMENT_TYPES.includes(typ)) {
+    return fail2([REASONS.unknown_typ], base);
+  }
+  if (statement.alg !== void 0 && statement.alg !== "EdDSA") {
+    return fail2([REASONS.unsupported_alg], base);
+  }
+  if (!kid) return fail2([REASONS.signing_key_id_missing], base);
+  if (typeof statement.signature !== "string" || statement.signature.length === 0) {
+    return fail2([REASONS.signature_missing], base);
+  }
+  let sig;
+  try {
+    sig = base64urlToUint8(statement.signature);
+  } catch {
+    return fail2([REASONS.signature_malformed], base);
+  }
+  if (sig.length !== 64) return fail2([REASONS.signature_malformed], base);
+  const selected = selectKey(jwks, kid);
+  if (!selected.key) return fail2([selected.reason], base);
+  let sigOk = false;
+  try {
+    sigOk = await ed25519.verifyAsync(sig, utils_js.utf8ToBytes(statementCommitment(statement)), selected.key);
+  } catch {
+    sigOk = false;
+  }
+  if (!sigOk) return fail2([REASONS.signature_invalid], base);
+  const reasons = [];
+  for (const d of digestFieldsOf(statement)) {
+    if (typeof d !== "string" || !DIGEST_RE.test(d)) {
+      reasons.push(REASONS.digest_malformed);
+      break;
+    }
+  }
+  if (typ === "AAP-ShareCard/v1") reasons.push(...shareCardReasons(statement.lines));
+  const flags = typ === "AAP-ConductRecord/v1" ? checkpointFlags(statement.checkpoints) : [];
+  return {
+    valid: reasons.length === 0,
+    typ,
+    digest,
+    signing_key_id: kid,
+    reasons,
+    flags
+  };
+}
+var LINK_TARGETS = {
+  previous_digest: "same",
+  conduct_digests: ["AAP-ConductRecord/v1"],
+  pr_record_digest: ["AAP-PRRecord/v1"],
+  source_digest: ["AAP-ConductRecord/v1", "AAP-PRRecord/v1", "AAP-Outcome/v1"]
+};
+async function verify(input, jwks) {
+  const verified_at = (/* @__PURE__ */ new Date()).toISOString();
+  const result = (valid, reasons2, flags2, statements2) => ({ valid, reasons: reasons2, flags: flags2, statements: statements2, verified_at });
+  if (!isObject3(input)) return result(false, [REASONS.bundle_not_an_object], [], []);
+  if (input.typ !== BUNDLE_TYP && Array.isArray(input.statements) && !STATEMENT_TYPES.includes(input.typ)) {
+    return result(false, [REASONS.bundle_unknown_typ], [], []);
+  }
+  if (input.typ !== BUNDLE_TYP) {
+    const one = await verifyStatement(input, jwks);
+    return result(one.valid, one.reasons.map((r) => `0:${r}`), one.flags, [one]);
+  }
+  const rawStatements = Array.isArray(input.statements) ? input.statements : null;
+  if (!rawStatements) {
+    return result(false, [REASONS.bundle_statements_missing], [], []);
+  }
+  const statements = [];
+  for (const s of rawStatements) statements.push(await verifyStatement(s, jwks));
+  const byDigest = /* @__PURE__ */ new Map();
+  statements.forEach((s) => {
+    if (s.digest) byDigest.set(s.digest, s);
+  });
+  const reasons = [];
+  const flags = [];
+  statements.forEach((s, i) => {
+    s.reasons.forEach((r) => reasons.push(`${i}:${r}`));
+    flags.push(...s.flags);
+    const raw = rawStatements[i];
+    if (!s.valid || !isObject3(raw)) return;
+    for (const [field, targets] of Object.entries(LINK_TARGETS)) {
+      const value = raw[field];
+      const digests = Array.isArray(value) ? value : [value];
+      for (const d of digests) {
+        if (typeof d !== "string") continue;
+        const linked = byDigest.get(d);
+        if (!linked) {
+          flags.push({ flag: FLAGS.linked_statement_not_in_bundle, subject: d });
+          continue;
+        }
+        const allowed = targets === "same" ? [s.typ] : targets;
+        if (!linked.typ || !allowed.includes(linked.typ)) {
+          reasons.push(`${i}:${REASONS.linked_statement_wrong_typ}`);
+        }
+      }
+    }
+  });
+  return result(reasons.length === 0, reasons, flags, statements);
+}
+
+// src/render-lines.ts
+var RENDER_LINES_REASONS = {
+  render_lines_disabled: "render_lines_disabled",
+  unknown_surface: "unknown_surface",
+  not_verifiable: "not_verifiable",
+  missing_key: "missing_key",
+  no_share_card_statement: "no_share_card_statement",
+  identifying_field: "identifying_field",
+  line_class_not_allowed: "line_class_not_allowed",
+  line_malformed: "line_malformed",
+  no_lines: "no_lines",
+  period_card_without_outcomes: "period_card_without_outcomes",
+  period_card_without_revert_line: "period_card_without_revert_line",
+  estimate_not_renderable: "estimate_not_renderable",
+  lint_failed: "lint_failed"
+};
+var R = RENDER_LINES_REASONS;
+function renderLinesEnabled(opts) {
+  if (opts?.enabled === true) return true;
+  const env = globalThis.process?.env;
+  return env?.AIP_RENDER_LINES === "1";
+}
+var fail = (reasons, violations) => ({
+  ok: false,
+  lines: [],
+  reasons,
+  ...violations ? { violations } : {}
+});
+function isObj2(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+var STATEMENT_KEYS2 = /* @__PURE__ */ new Set([
+  "typ",
+  "signing_key_id",
+  "signature",
+  "alg",
+  "built_at",
+  "previous_digest",
+  "commitment_key_id",
+  "unit_kind",
+  "source_digest",
+  "lines"
+]);
+var STATEMENT_LINE_KEYS = /* @__PURE__ */ new Set(["class", "text", "coverage"]);
+var COVERAGE_KEYS = /* @__PURE__ */ new Set(["judged", "total"]);
+function unknownKeys(o, allowed, where) {
+  return Object.keys(o).filter((k) => !allowed.has(k)).map((k) => `${R.identifying_field}:${where}.${k}`);
+}
+function outcomeKind(s) {
+  if (typeof s.outcome !== "string") return null;
+  if (s.outcome === "accepted_no_revert") return "accepted";
+  if (s.outcome === "reverted") return "reverted";
+  return null;
+}
+function finish(surface, lines) {
+  if (lines.length === 0) return fail([R.no_lines]);
+  if (surface === "period_card" && !lines.some((l) => l.revert === true)) {
+    return fail([R.period_card_without_revert_line]);
+  }
+  const lintLines = lines.map(({ revert: _revert, ...l }) => l);
+  const lint = lintRendering({ surface, lines: lintLines });
+  if (!lint.ok) return fail([R.lint_failed], lint.violations);
+  return { ok: true, lines, reasons: [] };
+}
+async function renderFromStatements(input, surface, jwks) {
+  const v = await verify(input, jwks);
+  if (!v.valid) return fail([R.not_verifiable, ...v.reasons]);
+  const statements = Array.isArray(input.statements) ? input.statements : [input];
+  const cards = statements.filter((s) => isObj2(s) && s.typ === "AAP-ShareCard/v1");
+  if (cards.length === 0) return fail([R.no_share_card_statement]);
+  const errors = [];
+  const lines = [];
+  cards.forEach((card, ci) => {
+    errors.push(...unknownKeys(card, STATEMENT_KEYS2, `card${ci}`));
+    const raw = Array.isArray(card.lines) ? card.lines : [];
+    raw.forEach((l, i) => {
+      const where = `card${ci}.lines[${i}]`;
+      if (!isObj2(l)) return void errors.push(`${R.line_malformed}:${where}`);
+      errors.push(...unknownKeys(l, STATEMENT_LINE_KEYS, where));
+      if (l.class !== "measured" && l.class !== "outcome" && l.class !== "verdict") {
+        return void errors.push(`${R.line_class_not_allowed}:${where}`);
+      }
+      if (typeof l.text !== "string" || l.text.length === 0) return void errors.push(`${R.line_malformed}:${where}`);
+      const out = { class: l.class, text: l.text };
+      if (l.class === "verdict") {
+        const c = l.coverage;
+        if (!isObj2(c)) return void errors.push(`${R.line_malformed}:${where}.coverage`);
+        errors.push(...unknownKeys(c, COVERAGE_KEYS, `${where}.coverage`));
+        out.coverage = { judged: c.judged, total: c.total };
+      } else if (l.coverage !== void 0 && l.coverage !== null) {
+        errors.push(`${R.identifying_field}:${where}.coverage`);
+      }
+      lines.push(out);
+    });
+  });
+  if (surface === "period_card") {
+    const outcomes = statements.filter((s) => isObj2(s) && s.typ === "AAP-Outcome/v1");
+    if (outcomes.length === 0) errors.push(R.period_card_without_outcomes);
+    else {
+      const kinds = outcomes.map(outcomeKind);
+      if (kinds.includes(null)) errors.push(`${R.line_malformed}:outcome`);
+      else {
+        const reverted = kinds.filter((k) => k === "reverted").length;
+        lines.push({ class: "outcome", text: `${reverted} of ${kinds.length} changes reverted`, revert: true });
+      }
+    }
+  }
+  if (errors.length > 0) return fail(errors);
+  return finish(surface, lines);
+}
+async function renderFromNumericCard(card, surface, publicKey) {
+  const shape = validateShareCardShape(card);
+  if (shape.length > 0) {
+    const ident = shape.some((e) => /identifying field/.test(e));
+    return fail([ident ? R.identifying_field : R.not_verifiable, ...shape]);
+  }
+  const v = await verifyShareCard(card, { publicKey });
+  if (!v.valid) return fail([R.not_verifiable, ...v.errors]);
+  const lines = v.lines.map(
+    (l) => l.kind === "revert" ? { class: "outcome", text: `${l.label}: ${l.value}`, revert: true } : { class: "measured", text: `${l.label}: ${l.value}` }
+  );
+  return finish(surface, lines);
+}
+async function renderLines(input, opts = {}) {
+  try {
+    if (!renderLinesEnabled(opts)) return fail([R.render_lines_disabled]);
+    const surface = opts.surface ?? "share_card";
+    if (surface !== "share_card" && surface !== "period_card") return fail([R.unknown_surface]);
+    if (!isObj2(input)) return fail([R.not_verifiable]);
+    if ("estimate" in input || "savings" in input) {
+      const d = shouldRenderEstimate(input.estimate ?? input.savings, surface);
+      return fail([R.estimate_not_renderable, ...d.reasons]);
+    }
+    if ("card_id" in input) {
+      if (opts.publicKey === void 0) return fail([R.missing_key]);
+      return await renderFromNumericCard(input, surface, opts.publicKey);
+    }
+    if (!opts.jwks) return fail([R.missing_key]);
+    return await renderFromStatements(input, surface, opts.jwks);
+  } catch {
+    return fail([R.not_verifiable]);
+  }
+}
+
+exports.RENDER_LINES_REASONS = RENDER_LINES_REASONS;
+exports.renderLines = renderLines;
+exports.renderLinesEnabled = renderLinesEnabled;
+//# sourceMappingURL=render-lines.cjs.map
+//# sourceMappingURL=render-lines.cjs.map