tldr-experts 0.6.0 → 0.7.0

package/dist/hooks/{chunk-17gv74sr.js → chunk-ecfqpeyj.js}

@@ -3,7 +3,7 @@ import {
   withWorkspaceLock,
   workspaceRootOfFactsPath,
   writeAtomic
-} from "./chunk-v4ay50nq.js";
+} from "./chunk-6405vkzk.js";
 import {
   FACT_CONFIDENCES,
   FACT_KINDS,
@@ -14,7 +14,7 @@ import {
   isLive,
   isRetired,
   noteDeprecations
-} from "./chunk-97ncnegd.js";
+} from "./chunk-37fwvg3x.js";
 import {
   asDocument,
   isRecord,
@@ -29,7 +29,7 @@ import {
   SRC_PATTERNS,
   parseYaml,
   readableSource
-} from "./chunk-9w64mxdh.js";
+} from "./chunk-y3cxqvnx.js";
 
 // src/core/facts/FactsStore.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/{chunk-7eqhfddw.js → chunk-md1c7z7q.js}

@@ -1,7 +1,7 @@
 import {
   EVIDENCE_FILE,
   gateEvidenceRelPath
-} from "./chunk-h7151g8w.js";
+} from "./chunk-b9rjx4qc.js";
 import {
   MAX_PLAN_STORIES,
   MAX_STORIES_PER_WAVE,
@@ -11,7 +11,7 @@ import {
   requirePattern,
   requireStringList,
   requireVersion1
-} from "./chunk-g4db8rbs.js";
+} from "./chunk-5w5eg00k.js";
 import {
   asDocument,
   isRecord,
@@ -31,7 +31,7 @@ import {
   listRunDirs,
   parseYaml,
   readableSource
-} from "./chunk-9w64mxdh.js";
+} from "./chunk-y3cxqvnx.js";
 
 // src/hooks/lib/runFile.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/{chunk-5k4dggq0.js → chunk-pf9d8ag8.js}

@@ -7,7 +7,7 @@ import {
   nowRfc3339,
   openRunViews,
   validateRunBudget
-} from "./chunk-7eqhfddw.js";
+} from "./chunk-md1c7z7q.js";
 import {
   EventLog,
   asRunFile,
@@ -19,7 +19,7 @@ import {
   isTerminal,
   stageAt,
   validateRunFile
-} from "./chunk-h7151g8w.js";
+} from "./chunk-b9rjx4qc.js";
 import {
   backupPathFor,
   isAlive,
@@ -28,17 +28,17 @@ import {
   workspaceRootOfRunDir,
   writeAtomic,
   yamlScalar
-} from "./chunk-v4ay50nq.js";
+} from "./chunk-6405vkzk.js";
 import {
   noteDeprecations,
   openBlocks,
   parseQuestions
-} from "./chunk-97ncnegd.js";
+} from "./chunk-37fwvg3x.js";
 import {
   listRunDirs,
   parseYaml,
   parseYamlRepairing
-} from "./chunk-9w64mxdh.js";
+} from "./chunk-y3cxqvnx.js";
 
 // src/core/statusline/runSnapshot.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";

package/dist/hooks/{chunk-ka6bkb64.js → chunk-rk1nm39z.js}

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

package/dist/hooks/{chunk-vrhczzxs.js → chunk-x3zy7zrn.js}

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

package/dist/hooks/{chunk-9w64mxdh.js → chunk-y3cxqvnx.js}

@@ -7415,6 +7415,7 @@ function isEpicWorktreeOf(name, runId) {
 // src/hooks/lib/workspace.ts
 import { existsSync as existsSync2, readdirSync, readFileSync, statSync as statSync2 } from "node:fs";
 import { basename, dirname as dirname3, isAbsolute, join as join2, resolve, sep } from "node:path";
+var RUN_YML = "run.yml";
 function locateWork(filePath) {
   if (filePath === "")
     return null;
@@ -7520,15 +7521,46 @@ function loadWorkspace(root) {
   }
   return empty();
 }
-function toSrcContext(workspace, runDir) {
+function toSrcContext(workspace, runDir, options = {}) {
   return {
     root: workspace.root,
     repos: workspace.repos,
     commands: workspace.commands,
     runDir: runDir ?? null,
-    epicWorktrees: epicWorktreesOf(workspace, runDir ?? null)
+    epicWorktrees: epicWorktreesOf(workspace, runDir ?? null),
+    epicRefs: options.epicRefs === true ? epicRefsOf(workspace, runDir ?? null) : []
   };
 }
+function epicRefsOf(workspace, runDir) {
+  if (runDir === null || runDir === "")
+    return [];
+  const path = join2(runDir, RUN_YML);
+  if (!existsSync2(path))
+    return [];
+  let doc;
+  try {
+    doc = parseYaml(readFileSync(path, "utf8"));
+  } catch {
+    return [];
+  }
+  const recorded = doc?.build?.epic_branch;
+  if (!Array.isArray(recorded))
+    return [];
+  const branches = [];
+  for (const entry of recorded) {
+    if (typeof entry === "string" && entry !== "" && !branches.includes(entry))
+      branches.push(entry);
+  }
+  if (branches.length === 0)
+    return [];
+  const refs = [];
+  for (const [repo, rel] of workspace.repos) {
+    const dir = join2(workspace.root, rel);
+    for (const ref of branches)
+      refs.push({ repo, dir, ref });
+  }
+  return refs;
+}
 function epicWorktreesOf(workspace, runDir) {
   if (runDir === null || runDir === "")
     return [];
@@ -7575,13 +7607,14 @@ function listRunDirs(root) {
   const dirs = [];
   for (const entry of readdirSync(work)) {
     const dir = join2(work, entry);
-    if (existsSync2(join2(dir, "run.yml")) && statSync2(dir).isDirectory())
+    if (existsSync2(join2(dir, RUN_YML)) && statSync2(dir).isDirectory())
       dirs.push(dir);
   }
   return dirs.sort().reverse();
 }
 
 // src/core/text/srcToken.ts
+import { spawnSync } from "node:child_process";
 import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync3 } from "node:fs";
 import { isAbsolute as isAbsolute2, join as join3, normalize, relative, sep as sep2 } from "node:path";
 var LINE_RE = /^\d{1,9}$/;
@@ -7926,11 +7959,22 @@ function resolveSrc(ref, ctx, section, claim = "") {
           short ??= refused(`${ref.path} has ${lines} line(s); cited line ${highest}`, base.abs);
           continue;
         }
-        return { ok: true, outcome: "ok", resolved: base.abs };
+        if (base.unmerged === undefined)
+          return { ok: true, outcome: "ok", resolved: base.abs };
+        return {
+          ok: true,
+          outcome: "ok",
+          resolved: base.abs,
+          unmerged: base.unmerged,
+          message: `resolves in ${base.label} — unmerged`
+        };
       }
+      const onRef = resolveOnEpicRefs(ref, ctx);
+      if (onRef !== null)
+        return onRef;
       if (short !== null)
         return short;
-      const tried = bases.map((b) => b.label).join(", ");
+      const tried = [...bases.map((b) => b.label), ...epicRefLabels(ref, ctx)].join(", ");
       return refused(`no such file: ${ref.path} — tried ${tried}`, bases[0]?.abs);
     }
     case "cmd": {
@@ -8148,7 +8192,8 @@ function epicBases(ctx, repo, path) {
       continue;
     bases.push({
       label: `epic worktree ${displayPath(ctx.root, tree.dir)}`,
-      abs: normalize(join3(tree.dir, path))
+      abs: normalize(join3(tree.dir, path)),
+      unmerged: `the epic worktree ${displayPath(ctx.root, tree.dir)}`
     });
   }
   return bases;
@@ -8165,13 +8210,103 @@ function countLines(path) {
   const cached = lineCountCache.get(path);
   if (cached !== undefined)
     return cached;
-  const text = readFileSync2(path, "utf8");
-  const count = text === "" ? 0 : text.split(`
-`).length - (text.endsWith(`
-`) ? 1 : 0);
+  const count = countTextLines(readFileSync2(path, "utf8"));
   lineCountCache.set(path, count);
   return count;
 }
+function countTextLines(text) {
+  return text === "" ? 0 : text.split(`
+`).length - (text.endsWith(`
+`) ? 1 : 0);
+}
+var GIT_BIN = "git";
+var EPIC_BLOB_TIMEOUT_MS = 5000;
+var EPIC_BLOB_MAX_BYTES = 4 * 1024 * 1024;
+var MAX_EPIC_BLOB_READS = 256;
+var epicBlobCache = new Map;
+var epicBlobReads = 0;
+function epicBlobLines(target) {
+  const key = `${target.dir}\x00${target.ref}\x00${target.path}`;
+  const cached = epicBlobCache.get(key);
+  if (cached !== undefined)
+    return cached;
+  if (epicBlobReads >= MAX_EPIC_BLOB_READS)
+    return null;
+  epicBlobReads += 1;
+  let lines = null;
+  try {
+    const out = spawnSync(GIT_BIN, ["--no-pager", "cat-file", "blob", `${target.ref}:${target.path}`], {
+      cwd: target.dir,
+      encoding: "utf8",
+      timeout: EPIC_BLOB_TIMEOUT_MS,
+      maxBuffer: EPIC_BLOB_MAX_BYTES,
+      stdio: ["ignore", "pipe", "ignore"],
+      windowsHide: true
+    });
+    if (out.status === 0 && typeof out.stdout === "string")
+      lines = countTextLines(out.stdout);
+  } catch {
+    lines = null;
+  }
+  epicBlobCache.set(key, lines);
+  return lines;
+}
+function resolveOnEpicRefs(ref, ctx) {
+  const targets = epicTargets(ref, ctx);
+  if (targets.length === 0)
+    return null;
+  let short = null;
+  for (const target of targets) {
+    const lines = epicBlobLines(target);
+    if (lines === null)
+      continue;
+    const highest = ref.endLine ?? ref.startLine;
+    if (highest > lines) {
+      short ??= refused(`${target.path} has ${lines} line(s) on \`${target.ref}\` (unmerged, in ${target.repo}); ` + `cited line ${highest}`);
+      continue;
+    }
+    return {
+      ok: true,
+      outcome: "ok",
+      unmerged: target.ref,
+      message: `resolves on \`${target.ref}\` — unmerged`
+    };
+  }
+  return short;
+}
+function epicTargets(ref, ctx) {
+  const refs = ctx.epicRefs ?? [];
+  if (refs.length === 0 || isAbsolute2(ref.path))
+    return [];
+  const out = [];
+  const push = (repo, path) => {
+    for (const candidate of refs) {
+      if (candidate.repo === repo)
+        out.push({ ...candidate, path });
+    }
+  };
+  if (ref.repo !== null) {
+    push(ref.repo, ref.path);
+    return out;
+  }
+  for (const candidate of refs) {
+    const rel = ctx.repos.get(candidate.repo) ?? "";
+    if (rel === "" || rel === ".")
+      out.push({ ...candidate, path: ref.path });
+  }
+  const slash = ref.path.indexOf("/");
+  const named = slash > 0 ? ref.path.slice(0, slash) : "";
+  if (named !== "" && ctx.repos.has(named))
+    push(named, ref.path.slice(slash + 1));
+  return out;
+}
+function epicRefLabels(ref, ctx) {
+  const seen = new Set;
+  for (const target of epicTargets(ref, ctx)) {
+    seen.add(`\`${target.ref}\` in ${target.repo} (recorded epic branch)`);
+  }
+  return [...seen];
+}
 var factsCache = new Map;
 var questionsCache = new Map;
 var graphCache = new Map;
@@ -8487,6 +8622,7 @@ function validateSections(handoff, required, ctx, lineOffset = 0) {
   const unresolved = [];
   const unverified2 = [];
   const noted2 = [];
+  const epicOnly = [];
   let bulletCount = 0;
   const wanted = new Set(required);
   for (const section of handoff.sections) {
@@ -8518,10 +8654,12 @@ function validateSections(handoff, required, ctx, lineOffset = 0) {
           unverified2.push(issue);
         else if (resolution.outcome === "noted")
           noted2.push({ ...issue, src: ref.raw });
+        else if (resolution.unmerged !== undefined)
+          epicOnly.push({ ...issue, src: resolution.unmerged });
       }
     }
   }
-  return { emptySections, unsourced, malformed, unresolved, unverified: unverified2, noted: noted2, bulletCount };
+  return { emptySections, unsourced, malformed, unresolved, unverified: unverified2, noted: noted2, epicOnly, bulletCount };
 }
 function validateHandoff(text, ctx) {
   const handoff = parseHandoff(text);
@@ -8540,6 +8678,7 @@ function validateHandoff(text, ctx) {
     unresolved,
     unverified: report.unverified,
     noted: report.noted,
+    epicOnly: report.epicOnly,
     bulletCount: report.bulletCount
   };
 }
@@ -8548,6 +8687,7 @@ function validateCitations(text, ctx) {
   const unresolved = [];
   const unverified2 = [];
   const noted2 = [];
+  const epicOnly = [];
   let cited = 0;
   for (const item of parseItems(text)) {
     if (item.token === null) {
@@ -8571,9 +8711,11 @@ function validateCitations(text, ctx) {
         unverified2.push(issue);
       else if (resolution.outcome === "noted")
         noted2.push({ ...issue, src: ref.raw });
+      else if (resolution.unmerged !== undefined)
+        epicOnly.push({ ...issue, src: resolution.unmerged });
     }
   }
-  return { malformed, unresolved, unverified: unverified2, noted: noted2, cited };
+  return { malformed, unresolved, unverified: unverified2, noted: noted2, epicOnly, cited };
 }
 function noneBullet(lookedAt) {
   return `- none [src: absent:${lookedAt}]`;

package/dist/hooks/claim-sources.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-ka6bkb64.js";
+} from "./chunk-rk1nm39z.js";
 import {
   claimSourcesDeny,
   claimSourcesEmptySectionDeny,
   claimSourcesMalformedDeny,
   claimSourcesUnresolvedDeny
-} from "./chunk-dhbxzjfs.js";
+} from "./chunk-cf4az0j5.js";
 import {
   allow,
   deny,
@@ -16,8 +16,8 @@ import {
   postContext,
   readPayload,
   runHook
-} from "./chunk-x6n8b5fp.js";
-import"./chunk-vrhczzxs.js";
+} from "./chunk-2y3kwfrx.js";
+import"./chunk-x3zy7zrn.js";
 import {
   isHandoff,
   loadWorkspace,
@@ -25,7 +25,7 @@ import {
   toSrcContext,
   validateCitations,
   validateHandoff
-} from "./chunk-9w64mxdh.js";
+} from "./chunk-y3cxqvnx.js";
 
 // src/hooks/claim-sources.ts
 await runHook("claim-sources", async () => {

package/dist/hooks/dod-gate.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-ka6bkb64.js";
+} from "./chunk-rk1nm39z.js";
 import {
   dodGateDeny,
   dodGateInternalErrorDeny,
   dodGateMissingBlockDeny,
   dodGateRefusedCommandDeny
-} from "./chunk-dhbxzjfs.js";
+} from "./chunk-cf4az0j5.js";
 import {
   allow,
   deny,
@@ -15,19 +15,19 @@ import {
   filePathOf,
   isWriteOrEdit,
   readPayload
-} from "./chunk-x6n8b5fp.js";
-import"./chunk-vrhczzxs.js";
+} from "./chunk-2y3kwfrx.js";
+import"./chunk-x3zy7zrn.js";
 import {
   parseDodBlock
 } from "./chunk-rrkdfk7s.js";
-import"./chunk-g4db8rbs.js";
+import"./chunk-5w5eg00k.js";
 import"./chunk-39zh2e44.js";
 import {
   loadWorkspace,
   locateWork,
   repoPath,
   runtime
-} from "./chunk-9w64mxdh.js";
+} from "./chunk-y3cxqvnx.js";
 
 // src/hooks/dod-gate.ts
 import { basename, join } from "node:path";

package/dist/hooks/no-reask.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-ka6bkb64.js";
+} from "./chunk-rk1nm39z.js";
 import {
   noReAskDeny
-} from "./chunk-dhbxzjfs.js";
+} from "./chunk-cf4az0j5.js";
 import {
   FactsStore
-} from "./chunk-17gv74sr.js";
+} from "./chunk-ecfqpeyj.js";
 import {
   allow,
   deny,
@@ -15,18 +15,18 @@ import {
   isWriteOrEdit,
   readPayload,
   runHook
-} from "./chunk-x6n8b5fp.js";
-import"./chunk-vrhczzxs.js";
-import"./chunk-v4ay50nq.js";
+} from "./chunk-2y3kwfrx.js";
+import"./chunk-x3zy7zrn.js";
+import"./chunk-6405vkzk.js";
 import {
   openBlocks,
   parseQuestions
-} from "./chunk-97ncnegd.js";
+} from "./chunk-37fwvg3x.js";
 import"./chunk-39zh2e44.js";
 import {
   factsPath,
   locateWork
-} from "./chunk-9w64mxdh.js";
+} from "./chunk-y3cxqvnx.js";
 
 // src/hooks/no-reask.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/session-start.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import"./chunk-17gv74sr.js";
+import"./chunk-ecfqpeyj.js";
 import {
   allow,
   readPayload,
   runHook,
   sessionContext
-} from "./chunk-x6n8b5fp.js";
-import"./chunk-vrhczzxs.js";
+} from "./chunk-2y3kwfrx.js";
+import"./chunk-x3zy7zrn.js";
 import {
   RunStore,
   closedByMachine,
@@ -15,7 +15,7 @@ import {
   openQuestions,
   runSnapshot,
   whatIsWaiting
-} from "./chunk-5k4dggq0.js";
+} from "./chunk-pf9d8ag8.js";
 import {
   evidencePath,
   expertsDir,
@@ -25,17 +25,17 @@ import {
   pathsIntersect,
   readExpertDomain,
   stackExpertNames
-} from "./chunk-7eqhfddw.js";
+} from "./chunk-md1c7z7q.js";
 import {
   parseEvidence
-} from "./chunk-h7151g8w.js";
+} from "./chunk-b9rjx4qc.js";
 import"./chunk-rrkdfk7s.js";
-import"./chunk-g4db8rbs.js";
-import"./chunk-v4ay50nq.js";
+import"./chunk-5w5eg00k.js";
+import"./chunk-6405vkzk.js";
 import {
   openBlocks,
   parseQuestions
-} from "./chunk-97ncnegd.js";
+} from "./chunk-37fwvg3x.js";
 import {
   isRecord
 } from "./chunk-39zh2e44.js";
@@ -47,7 +47,7 @@ import {
   findWorkspaceRoot,
   listRunDirs,
   parseYaml
-} from "./chunk-9w64mxdh.js";
+} from "./chunk-y3cxqvnx.js";
 
 // src/core/status/PendingItem.ts
 function isPending(item) {

package/dist/hooks/statusline.js

@@ -2,18 +2,18 @@
 import {
   bar,
   runSnapshot
-} from "./chunk-5k4dggq0.js";
-import"./chunk-7eqhfddw.js";
-import"./chunk-h7151g8w.js";
+} from "./chunk-pf9d8ag8.js";
+import"./chunk-md1c7z7q.js";
+import"./chunk-b9rjx4qc.js";
 import"./chunk-rrkdfk7s.js";
-import"./chunk-g4db8rbs.js";
-import"./chunk-v4ay50nq.js";
-import"./chunk-97ncnegd.js";
+import"./chunk-5w5eg00k.js";
+import"./chunk-6405vkzk.js";
+import"./chunk-37fwvg3x.js";
 import"./chunk-39zh2e44.js";
 import {
   findWorkspaceRoot,
   runtime
-} from "./chunk-9w64mxdh.js";
+} from "./chunk-y3cxqvnx.js";
 
 // src/core/statusline/renderStatusLine.ts
 var NO_SESSION_DATA = "[tldrx] no session data";