tldr-experts 0.3.0 → 0.3.1

package/dist/hooks/{chunk-kw4tffzf.js → chunk-458wgg9j.js}

@@ -2,7 +2,7 @@ import {
   hasSrcMarker,
   parseSrcToken,
   resolveSrc
-} from "./chunk-g395gk7e.js";
+} from "./chunk-sznsenee.js";
 
 // src/core/text/handoff.ts
 var HANDOFF_SECTIONS = ["Findings", "Decisions", "Unknowns", "Evidence ledger"];
@@ -64,56 +64,55 @@ function parseHandoff(text) {
 function isHandoff(text) {
   return missingSections(parseHandoff(text)).length === 0;
 }
-function missingSections(handoff) {
+function missingSections(handoff, required = HANDOFF_SECTIONS) {
   const present = handoff.headings;
   const missing = [];
   let cursor = 0;
-  for (const required of HANDOFF_SECTIONS) {
-    const at = present.indexOf(required, cursor);
+  for (const name of required) {
+    const at = present.indexOf(name, cursor);
     if (at === -1)
-      missing.push(required);
+      missing.push(name);
     else
       cursor = at + 1;
   }
   return missing;
 }
 var MAX_BULLETS = 200;
-function validateHandoff(text, ctx) {
-  const handoff = parseHandoff(text);
-  const missing = missingSections(handoff);
+function validateSections(handoff, required, ctx, lineOffset = 0) {
   const emptySections = [];
   const unsourced = [];
   const malformed = [];
   const unresolved = [];
   const unverified = [];
   let bulletCount = 0;
-  const required = new Set(HANDOFF_SECTIONS);
+  const wanted = new Set(required);
   for (const section of handoff.sections) {
-    if (!required.has(section.name))
+    if (!wanted.has(section.name))
       continue;
     if (section.bullets.length === 0) {
-      emptySections.push({ name: section.name, line: section.headingLine });
+      emptySections.push({ name: section.name, line: section.headingLine + lineOffset });
     }
     for (const bullet of section.bullets) {
       bulletCount++;
+      const line = bullet.line + lineOffset;
       if (bullet.token === null) {
         if (hasSrcMarker(bullet.text)) {
           malformed.push({
-            line: bullet.line,
+            line,
             message: "malformed citation — the `[src: …]` token must be the last thing on the line " + "(closing quotes, brackets and a final `.` are allowed after it, words are not)"
           });
         } else {
-          unsourced.push(bullet.line);
+          unsourced.push(line);
         }
         continue;
       }
       for (const error of bullet.token.errors) {
-        unresolved.push({ line: bullet.line, message: `[src: ${error.raw}] — ${error.message}` });
+        unresolved.push({ line, message: `[src: ${error.raw}] — ${error.message}` });
       }
       const claim = bullet.text.replace(bullet.token.raw, " ").trim();
       for (const ref of bullet.token.refs) {
         const resolution = resolveSrc(ref, ctx, section.name, claim);
-        const issue = { line: bullet.line, message: `[src: ${ref.raw}] — ${resolution.message ?? "unresolvable"}` };
+        const issue = { line, message: `[src: ${ref.raw}] — ${resolution.message ?? "unresolvable"}` };
         if (resolution.outcome === "refused")
           unresolved.push(issue);
         else if (resolution.outcome === "unverified")
@@ -121,19 +120,26 @@ function validateHandoff(text, ctx) {
       }
     }
   }
-  if (bulletCount > MAX_BULLETS) {
-    unresolved.push({ line: 0, message: `${bulletCount} bullets exceeds the ${MAX_BULLETS} cap` });
+  return { emptySections, unsourced, malformed, unresolved, unverified, bulletCount };
+}
+function validateHandoff(text, ctx) {
+  const handoff = parseHandoff(text);
+  const missing = missingSections(handoff);
+  const report = validateSections(handoff, HANDOFF_SECTIONS, ctx);
+  const unresolved = [...report.unresolved];
+  if (report.bulletCount > MAX_BULLETS) {
+    unresolved.push({ line: 0, message: `${report.bulletCount} bullets exceeds the ${MAX_BULLETS} cap` });
   }
   return {
-    ok: missing.length === 0 && emptySections.length === 0 && unsourced.length === 0 && malformed.length === 0 && unresolved.length === 0,
+    ok: missing.length === 0 && report.emptySections.length === 0 && report.unsourced.length === 0 && report.malformed.length === 0 && unresolved.length === 0,
     missingSections: missing,
-    emptySections,
-    unsourced,
-    malformed,
+    emptySections: report.emptySections,
+    unsourced: report.unsourced,
+    malformed: report.malformed,
     unresolved,
-    unverified,
-    bulletCount
+    unverified: report.unverified,
+    bulletCount: report.bulletCount
   };
 }
 
-export { isHandoff, validateHandoff };
+export { parseHandoff, isHandoff, validateHandoff };

package/dist/hooks/{chunk-j234zf0t.js → chunk-9kkm6q0t.js}

@@ -1,170 +1,7 @@
-import {
-  parseSrcToken
-} from "./chunk-g395gk7e.js";
 import {
   PROJECT_FRAMEWORK_DIR,
   PROJECT_WORK_DIR
-} from "./chunk-p274ckxv.js";
-
-// src/core/text/questions.ts
-var REQUIRED_METADATA_KEYS = ["id", "status", "area", "asked_by", "asked_at"];
-var HEADING_RE = /^##\s+(Q\d{1,6})\s+·\s+(.+?)\s*$/;
-var METADATA_RE = /^<!--\s*(.*?)\s*-->$/;
-var WHY_RE = /^Why asked:\s*(.*)$/;
-var OPTION_RE = /^-\s+([A-E])\)\s*(.*)$/;
-var ANSWER_RE = /^\[Answer\]:[ \t]*(\S.*)$/;
-var ANSWER_SLOT_RE = /^\[Answer\]:/;
-var FOOTER_KEYS = ["answered_by", "answered_at", "fact"];
-function parseQuestions(text) {
-  const trailingNewline = text.endsWith(`
-`);
-  const body = trailingNewline ? text.slice(0, -1) : text;
-  const lines = body === "" ? [] : body.split(`
-`);
-  const preamble = [];
-  const blocks = [];
-  let pending = null;
-  const close = () => {
-    if (pending === null)
-      return;
-    blocks.push(buildBlock(pending.start + 1, pending.lines));
-    pending = null;
-  };
-  for (let i = 0;i < lines.length; i++) {
-    const line = lines[i] ?? "";
-    if (HEADING_RE.test(line)) {
-      close();
-      pending = { start: i, lines: [line] };
-      continue;
-    }
-    if (pending === null)
-      preamble.push(line);
-    else
-      pending.lines.push(line);
-  }
-  close();
-  return { preamble, blocks, trailingNewline };
-}
-function buildBlock(startLine, lines) {
-  const heading = HEADING_RE.exec(lines[0] ?? "");
-  const id = heading?.[1] ?? "";
-  const title = heading?.[2] ?? "";
-  let metadata = null;
-  let metadataIndex = -1;
-  let whyAsked = null;
-  let whySrc = null;
-  const options = [];
-  let answer = "";
-  let answerIndex = -1;
-  let footer = null;
-  for (let i = 1;i < lines.length; i++) {
-    const line = lines[i] ?? "";
-    const comment = METADATA_RE.exec(line);
-    if (comment !== null && comment[1] !== undefined) {
-      const pairs = parsePipeComment(comment[1]);
-      if (metadata === null && pairs.some(([k]) => k === "id")) {
-        metadata = toMetadata(pairs);
-        metadataIndex = i;
-      } else if (footer === null && pairs.some(([k]) => k === "answered_by")) {
-        footer = toFooter(pairs);
-      }
-      continue;
-    }
-    const why = WHY_RE.exec(line);
-    if (why !== null && whyAsked === null) {
-      whyAsked = why[1] ?? "";
-      whySrc = parseSrcToken(line);
-      continue;
-    }
-    const option = OPTION_RE.exec(line);
-    if (option !== null && option[1] !== undefined && option[2] !== undefined) {
-      options.push({ letter: option[1], text: option[2] });
-      continue;
-    }
-    if (ANSWER_SLOT_RE.test(line) && answerIndex === -1) {
-      answerIndex = i;
-      const captured = ANSWER_RE.exec(line);
-      answer = (captured?.[1] ?? "").trim();
-    }
-  }
-  return {
-    id,
-    title,
-    metadata,
-    metadataIndex,
-    whyAsked,
-    whySrc,
-    options,
-    answer,
-    answerIndex,
-    footer,
-    startLine,
-    lines: [...lines]
-  };
-}
-function parsePipeComment(inner) {
-  const pairs = [];
-  for (const part of inner.split("|")) {
-    const colon = part.indexOf(":");
-    if (colon === -1)
-      continue;
-    pairs.push([part.slice(0, colon).trim(), part.slice(colon + 1).trim()]);
-  }
-  return pairs;
-}
-function toMetadata(pairs) {
-  const map = new Map(pairs);
-  const extra = pairs.filter(([k]) => !REQUIRED_METADATA_KEYS.includes(k));
-  return {
-    id: map.get("id") ?? "",
-    status: map.get("status") ?? "",
-    area: map.get("area") ?? "",
-    asked_by: map.get("asked_by") ?? "",
-    asked_at: map.get("asked_at") ?? "",
-    extra
-  };
-}
-function toFooter(pairs) {
-  const map = new Map(pairs);
-  return {
-    answered_by: map.get("answered_by") ?? "",
-    answered_at: map.get("answered_at") ?? "",
-    fact: map.get("fact") ?? ""
-  };
-}
-function serializeQuestions(doc) {
-  const out = [...doc.preamble];
-  for (const block of doc.blocks)
-    out.push(...block.lines);
-  const text = out.join(`
-`);
-  return doc.trailingNewline ? `${text}
-` : text;
-}
-function detectAnswered(blocks) {
-  return blocks.filter((b) => b.metadata?.status === "open" && b.answer !== "");
-}
-function openBlocks(blocks) {
-  return blocks.filter((b) => b.metadata?.status === "open");
-}
-function recordAnswer(block, footer) {
-  const lines = [...block.lines];
-  if (block.metadataIndex >= 0) {
-    const line = lines[block.metadataIndex] ?? "";
-    lines[block.metadataIndex] = line.replace(/(\|\s*status:\s*)open(\s*\|)/, "$1answered$2");
-  }
-  const footerLine = `<!-- ${FOOTER_KEYS.map((k) => `${k}: ${footer[k]}`).join(" | ")} -->`;
-  const insertAt = block.answerIndex >= 0 ? block.answerIndex + 1 : lines.length;
-  lines.splice(insertAt, 0, footerLine);
-  const metadata = block.metadata === null ? null : { ...block.metadata, status: "answered" };
-  return { ...block, lines, metadata, footer };
-}
-function replaceBlock(doc, block) {
-  return {
-    ...doc,
-    blocks: doc.blocks.map((b) => b.id === block.id ? block : b)
-  };
-}
+} from "./chunk-ztczwtj0.js";
 
 // src/core/lock/workspaceLock.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, openSync, readFileSync as readFileSync2, rmSync as rmSync2, writeSync, closeSync } from "node:fs";
@@ -315,6 +152,8 @@ function emitFact(fact, indent = "  ") {
     `${inner}supersedes: ${yamlScalar(fact.supersedes)}`,
     `${inner}superseded_by: ${yamlScalar(fact.superseded_by)}`
   ];
+  if (fact.truncated === true)
+    lines.push(`${inner}truncated: true`);
   if (fact.retired === null) {
     lines.push(`${inner}retired: null`);
   } else {
@@ -336,4 +175,4 @@ function emitFactsYaml(file, header) {
 `;
 }
 
-export { readLock, isAlive, workspaceRootOfRunDir, workspaceRootOfFactsPath, withWorkspaceLock, yamlScalar, emitFactsYaml, parseQuestions, serializeQuestions, detectAnswered, openBlocks, recordAnswer, replaceBlock };
+export { readLock, isAlive, workspaceRootOfRunDir, workspaceRootOfFactsPath, withWorkspaceLock, yamlScalar, emitFactsYaml };

package/dist/hooks/{chunk-t8tdv11p.js → chunk-afamdvyn.js}

@@ -1,6 +1,6 @@
 import {
   toolInput
-} from "./chunk-1zwcxd3f.js";
+} from "./chunk-3g61yg59.js";
 
 // src/hooks/lib/wouldBe.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/{chunk-a8p2rc94.js → chunk-s5qsb4k6.js}

@@ -1,6 +1,6 @@
 import {
   runtime
-} from "./chunk-p274ckxv.js";
+} from "./chunk-ztczwtj0.js";
 
 // src/core/hooks/passthrough.ts
 async function readStdin() {

package/dist/hooks/{chunk-g395gk7e.js → chunk-sznsenee.js}

@@ -1,7 +1,7 @@
 import {
   PROJECT_FRAMEWORK_DIR,
   parseYaml
-} from "./chunk-p274ckxv.js";
+} from "./chunk-ztczwtj0.js";
 
 // src/core/text/srcToken.ts
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";

package/dist/hooks/{chunk-y0jdr3et.js → chunk-xpxe94qe.js}

@@ -1,10 +1,12 @@
 import {
+  DEFAULT_ECONOMY,
   asRunBudget,
   asRunFile,
   cursorStage,
   derivePhaseStatus,
   deriveRunStatus,
   flatten,
+  isAttendedByHost,
   isFinished,
   isTerminal,
   nowRfc3339,
@@ -12,26 +14,26 @@ import {
   stageAt,
   validateRunBudget,
   validateRunFile
-} from "./chunk-sdjnnmzz.js";
+} from "./chunk-zdxgragg.js";
 import {
   EventLog
-} from "./chunk-azctppjh.js";
+} from "./chunk-ybacnpxd.js";
 import {
   isAlive,
-  openBlocks,
-  parseQuestions,
   readLock,
   withWorkspaceLock,
   workspaceRootOfRunDir,
   yamlScalar
-} from "./chunk-j234zf0t.js";
+} from "./chunk-9kkm6q0t.js";
 import {
-  noteDeprecations
-} from "./chunk-t56k6146.js";
+  noteDeprecations,
+  openBlocks,
+  parseQuestions
+} from "./chunk-3t91gvpp.js";
 import {
   listRunDirs,
   parseYaml
-} from "./chunk-p274ckxv.js";
+} from "./chunk-ztczwtj0.js";
 
 // src/core/statusline/runSnapshot.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
@@ -52,8 +54,12 @@ function gatesPolicy(policy) {
   const entries = Object.entries(policy).map(([id, value]) => `${yamlScalar(id)}: ${yamlScalar(value)}`);
   return `{${entries.join(", ")}}`;
 }
+function gateEvidence(e) {
+  return `{path: ${yamlScalar(e.path)}, role: ${yamlScalar(e.role)}, verdict: ${yamlScalar(e.verdict)}, ` + `sampled: ${String(e.sampled)}, of: ${String(e.of)}, resolved: ${String(e.resolved)}, ` + `refuted: ${String(e.refuted)}, outside_surface: ${String(e.outside_surface)}}`;
+}
 function gate(g) {
-  return `{type: ${yamlScalar(g.type)}, status: ${yamlScalar(g.status)}, by: ${yamlScalar(g.by)}, ` + `at: ${yamlScalar(g.at)}, note: ${yamlScalar(g.note)}}`;
+  const evidence = g.evidence === undefined ? "" : `, evidence: ${gateEvidence(g.evidence)}`;
+  return `{type: ${yamlScalar(g.type)}, status: ${yamlScalar(g.status)}, by: ${yamlScalar(g.by)}, ` + `at: ${yamlScalar(g.at)}, note: ${yamlScalar(g.note)}${evidence}}`;
 }
 function task(t, indent) {
   const inner = `${indent}   `;
@@ -120,6 +126,9 @@ function emitRunYaml(run) {
   if (run.cancelled !== undefined) {
     lines.push(`cancelled: {by: ${yamlScalar(run.cancelled.by)}, at: ${yamlScalar(run.cancelled.at)}, ` + `note: ${yamlScalar(run.cancelled.note)}}`);
   }
+  if (run.attended_by !== undefined) {
+    lines.push(`attended_by: ${yamlScalar(run.attended_by)}`);
+  }
   if (run.gates_policy !== undefined && Object.keys(run.gates_policy).length > 0) {
     lines.push(`gates_policy: ${gatesPolicy(run.gates_policy)}`);
   }
@@ -149,10 +158,12 @@ function emitBudgetYaml(budget) {
     `per_agent_max_usd: ${money(budget.per_agent_max_usd)}`,
     `warn_at_pct: ${budget.warn_at_pct}`,
     `on_exceed: ${yamlScalar(budget.on_exceed)}`,
+    ...budget.economy === DEFAULT_ECONOMY ? [] : [`economy: ${yamlScalar(budget.economy)}`],
     "phases:"
   ];
   for (const phase of budget.phases) {
-    lines.push(`  - {id: ${yamlScalar(phase.id)}, ceiling_usd: ${money(phase.ceiling_usd)}, ` + `spent_usd: ${money(phase.spent_usd)}}`);
+    const economy = phase.economy === null ? "" : `, economy: ${yamlScalar(phase.economy)}`;
+    lines.push(`  - {id: ${yamlScalar(phase.id)}, ceiling_usd: ${money(phase.ceiling_usd)}, ` + `spent_usd: ${money(phase.spent_usd)}${economy}}`);
   }
   return `${lines.join(`
 `)}
@@ -418,6 +429,7 @@ function fromStore(root) {
     openCount: open.length,
     autoGates: stages.filter((s) => s.gate.status === "approved" && s.gate.by === AUTO).length,
     staleStages: stages.filter((s) => s.stale === true).length,
+    attendedByHost: isAttendedByHost(run),
     source: "run-store"
   };
 }
@@ -446,6 +458,7 @@ function fromTolerantRead(root) {
     openCount: open.length,
     autoGates: 0,
     staleStages: 0,
+    attendedByHost: false,
     source: "tolerant"
   };
 }

package/dist/hooks/{chunk-azctppjh.js → chunk-ybacnpxd.js}

@@ -5,7 +5,7 @@ import {
   requireNumber,
   requireString,
   result
-} from "./chunk-0bt6yb2q.js";
+} from "./chunk-39zh2e44.js";
 
 // src/core/events/EventLog.ts
 import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
@@ -17,6 +17,7 @@ var EVENT_TYPES = [
   "run.closed",
   "run.unlocked",
   "run.cancelled",
+  "run.attended",
   "phase.started",
   "phase.done",
   "stage.started",
@@ -33,6 +34,8 @@ var EVENT_TYPES = [
   "gate.approved",
   "gate.rejected",
   "gate.revoked",
+  "story.reopened",
+  "story.base_fastforwarded",
   "check.passed",
   "check.failed",
   "budget.warned",

package/dist/hooks/{chunk-x98qs959.js → chunk-ytvmc5ns.js}

@@ -2,10 +2,17 @@ import {
   emitFactsYaml,
   withWorkspaceLock,
   workspaceRootOfFactsPath
-} from "./chunk-j234zf0t.js";
+} from "./chunk-9kkm6q0t.js";
 import {
+  FACT_CONFIDENCES,
+  FACT_KINDS,
+  MAX_FACTS,
+  MAX_FACT_CHARS,
+  factNumber,
+  formatFactId,
+  isRetired,
   noteDeprecations
-} from "./chunk-t56k6146.js";
+} from "./chunk-3t91gvpp.js";
 import {
   asDocument,
   isRecord,
@@ -15,30 +22,15 @@ import {
   requireString,
   requireVersion,
   result
-} from "./chunk-0bt6yb2q.js";
+} from "./chunk-39zh2e44.js";
 import {
   parseYaml
-} from "./chunk-p274ckxv.js";
+} from "./chunk-ztczwtj0.js";
 
 // src/core/facts/FactsStore.ts
 import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 
-// src/core/facts/Fact.ts
-var FACT_KINDS = ["answer", "observed", "derived"];
-var FACT_CONFIDENCES = ["measured", "inferred", "stated"];
-var MAX_FACTS = 5000;
-var MAX_FACT_CHARS = 300;
-function isRetired(fact) {
-  return fact.retired !== null && fact.retired.at !== null;
-}
-function factNumber(id) {
-  return Number.parseInt(id.slice(1), 10);
-}
-function formatFactId(n) {
-  return `F${String(n).padStart(3, "0")}`;
-}
-
 // src/core/facts/validateFactsFile.ts
 var ID_RE = /^F\d{3,6}$/;
 var Q_RE = /^Q\d{1,6}$/;
@@ -94,6 +86,9 @@ function validateFactsFile(input) {
     } else if (row.source !== undefined) {
       issues.push({ path: `${path}.source`, message: "expected a mapping" });
     }
+    if (row.truncated !== undefined && typeof row.truncated !== "boolean") {
+      issues.push({ path: `${path}.truncated`, message: "expected true, false or absent" });
+    }
     const superseded = typeof row.superseded_by === "string";
     const retired = isRecord(row.retired) && row.retired.at !== null && row.retired.at !== undefined;
     if (superseded && retired) {
@@ -214,9 +209,10 @@ class FactsStore {
     return formatFactId(highest + 1);
   }
   append(input) {
+    const cut = input.fact.length > MAX_FACT_CHARS;
     const fact = {
       id: this.nextId(),
-      fact: input.fact.length > MAX_FACT_CHARS ? `${input.fact.slice(0, MAX_FACT_CHARS - 1)}…` : input.fact,
+      fact: cut ? `${input.fact.slice(0, MAX_FACT_CHARS - 1)}…` : input.fact,
       area: input.area,
       repos: [...input.repos],
       kind: input.kind,
@@ -224,7 +220,8 @@ class FactsStore {
       source: { ...input.source },
       supersedes: input.supersedes ?? null,
       superseded_by: null,
-      retired: input.retired ?? null
+      retired: input.retired ?? null,
+      ...cut || input.truncated === true ? { truncated: true } : {}
     };
     this.rows.push(fact);
     return fact;
@@ -299,4 +296,4 @@ function writeFactsAtomic(path, text) {
   }
 }
 
-export { MAX_FACT_CHARS, FactsStore };
+export { FactsStore };