tldr-experts 0.3.0 → 0.4.0

package/dist/hooks/{chunk-p274ckxv.js → chunk-sq44k6g2.js}

@@ -7284,6 +7284,93 @@ var runtime = onBun ? bunRuntime : nodeRuntime;
 function parseYaml(text) {
   return runtime.parseYaml(text);
 }
+function parseYamlRepairing(text) {
+  try {
+    return { doc: parseYaml(text), repaired: false };
+  } catch (original) {
+    const mended = rejoinBrokenQuotedScalars(text);
+    if (mended === null)
+      throw original;
+    try {
+      return { doc: parseYaml(mended), repaired: true };
+    } catch {
+      throw original;
+    }
+  }
+}
+function rejoinBrokenQuotedScalars(text) {
+  const out = [];
+  let changed = false;
+  let inDouble = false;
+  let inSingle = false;
+  for (let i = 0;i < text.length; i++) {
+    const ch = text[i];
+    if (inDouble) {
+      if (ch === "\\") {
+        out.push(ch, text[i + 1] ?? "");
+        i++;
+        continue;
+      }
+      if (ch === '"') {
+        inDouble = false;
+        out.push(ch);
+        continue;
+      }
+      const escaped = CONTROL_ESCAPES[ch];
+      if (escaped !== undefined) {
+        out.push(escaped);
+        changed = true;
+        continue;
+      }
+      out.push(ch);
+      continue;
+    }
+    if (inSingle) {
+      if (ch === "'") {
+        if (text[i + 1] === "'") {
+          out.push(ch, ch);
+          i++;
+        } else {
+          inSingle = false;
+          out.push(ch);
+        }
+        continue;
+      }
+      out.push(ch);
+      continue;
+    }
+    if (ch === '"')
+      inDouble = true;
+    else if (ch === "'")
+      inSingle = true;
+    else if (ch === "#" && (i === 0 || text[i - 1] === " " || text[i - 1] === `
+`)) {
+      const end = text.indexOf(`
+`, i);
+      const stop = end === -1 ? text.length : end;
+      out.push(text.slice(i, stop));
+      i = stop - 1;
+      continue;
+    }
+    out.push(ch);
+  }
+  if (inDouble)
+    return null;
+  return changed ? out.join("") : null;
+}
+var CONTROL_ESCAPES = {
+  "\n": "\\n",
+  "\r": "\\r",
+  "\v": "\\v",
+  "\f": "\\f",
+  "\x00": "\\0",
+  "\x07": "\\a",
+  "\b": "\\b",
+  "\x1B": "\\e",
+  "…": "\\N",
+  "\u2028": "\\L",
+  "\u2029": "\\P"
+};
 
 // src/core/paths.ts
 import { dirname as dirname2, join } from "node:path";
@@ -7313,10 +7400,15 @@ var TEMPLATES_DIR = join(FRAMEWORK_ROOT, "templates");
 var PLUGIN_DIR = join(FRAMEWORK_ROOT, "plugin");
 var PROJECT_FRAMEWORK_DIR = ".tldrx";
 var PROJECT_WORK_DIR = "tldrx-work";
+var PROJECT_WORKTREES_DIR = "worktrees";
+var EPIC_WORKTREE_PREFIX = "_epic-";
+function isEpicWorktreeOf(name, runId) {
+  return name.startsWith(`${EPIC_WORKTREE_PREFIX}${runId}-`);
+}
 
 // src/hooks/lib/workspace.ts
 import { existsSync as existsSync2, readdirSync, readFileSync, statSync as statSync2 } from "node:fs";
-import { dirname as dirname3, isAbsolute, join as join2, resolve, sep } from "node:path";
+import { basename, dirname as dirname3, isAbsolute, join as join2, resolve, sep } from "node:path";
 function locateWork(filePath) {
   if (filePath === "")
     return null;
@@ -7348,10 +7440,32 @@ function findWorkspaceRoot(start) {
   return null;
 }
 var FALLBACK_DEFAULT_BRANCH = "main";
+function commandRolesOf(doc) {
+  const out = new Map;
+  const list = doc?.repos;
+  if (!Array.isArray(list))
+    return out;
+  for (const entry of list) {
+    if (typeof entry?.name !== "string")
+      continue;
+    const roles = new Map;
+    const cmds = entry.commands;
+    if (cmds !== null && typeof cmds === "object") {
+      for (const [role, value] of Object.entries(cmds)) {
+        if (typeof value !== "string" || value.trim() === "")
+          continue;
+        roles.set(role, value);
+      }
+    }
+    out.set(entry.name, roles);
+  }
+  return out;
+}
 function loadWorkspace(root) {
   const repos = new Map;
   const commands = new Set;
   const repoCommands = new Map;
+  const commandRoles = new Map;
   const defaultBranches = new Map;
   let seedTriageThresholdTokens = null;
   const empty = () => ({
@@ -7359,6 +7473,7 @@ function loadWorkspace(root) {
     repos,
     commands,
     repoCommands,
+    commandRoles,
     defaultBranches,
     seedTriageThresholdTokens
   });
@@ -7381,23 +7496,21 @@ function loadWorkspace(root) {
   const list = doc?.repos;
   if (!Array.isArray(list))
     return empty();
+  const declared = commandRolesOf(doc);
   for (const entry of list) {
     if (typeof entry?.name !== "string")
       continue;
     repos.set(entry.name, typeof entry.path === "string" ? entry.path : ".");
     defaultBranches.set(entry.name, typeof entry.default_branch === "string" && entry.default_branch !== "" ? entry.default_branch : FALLBACK_DEFAULT_BRANCH);
     const own = [];
-    const cmds = entry.commands;
-    if (cmds !== null && typeof cmds === "object") {
-      for (const value of Object.values(cmds)) {
-        if (typeof value !== "string" || value.trim() === "")
-          continue;
-        commands.add(value);
-        if (!own.includes(value))
-          own.push(value);
-      }
+    const roles = declared.get(entry.name) ?? new Map;
+    for (const value of roles.values()) {
+      commands.add(value);
+      if (!own.includes(value))
+        own.push(value);
     }
     repoCommands.set(entry.name, own);
+    commandRoles.set(entry.name, roles);
   }
   return empty();
 }
@@ -7406,9 +7519,39 @@ function toSrcContext(workspace, runDir) {
     root: workspace.root,
     repos: workspace.repos,
     commands: workspace.commands,
-    runDir: runDir ?? null
+    runDir: runDir ?? null,
+    epicWorktrees: epicWorktreesOf(workspace, runDir ?? null)
   };
 }
+function epicWorktreesOf(workspace, runDir) {
+  if (runDir === null || runDir === "")
+    return [];
+  const runId = basename(runDir);
+  if (runId === "")
+    return [];
+  const trees = [];
+  for (const repo of workspace.repos.keys()) {
+    const dir = join2(workspace.root, PROJECT_FRAMEWORK_DIR, PROJECT_WORKTREES_DIR, repo);
+    if (!existsSync2(dir))
+      continue;
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      continue;
+    }
+    for (const name of entries.slice().sort()) {
+      if (!isEpicWorktreeOf(name, runId))
+        continue;
+      const abs = join2(dir, name);
+      try {
+        if (statSync2(abs).isDirectory())
+          trees.push({ repo, dir: abs });
+      } catch {}
+    }
+  }
+  return trees;
+}
 function repoPath(workspace, name) {
   const rel = workspace.repos.get(name);
   return rel === undefined ? null : join2(workspace.root, rel);
@@ -7432,4 +7575,4 @@ function listRunDirs(root) {
   return dirs.sort().reverse();
 }
 
-export { runtime, parseYaml, STAGES_DIR, TEMPLATES_DIR, PROJECT_FRAMEWORK_DIR, PROJECT_WORK_DIR, locateWork, findWorkspaceRoot, loadWorkspace, toSrcContext, repoPath, factsPath, stageYamlPath, listRunDirs };
+export { runtime, parseYaml, parseYamlRepairing, STAGES_DIR, TEMPLATES_DIR, PROJECT_FRAMEWORK_DIR, PROJECT_WORK_DIR, locateWork, findWorkspaceRoot, loadWorkspace, toSrcContext, repoPath, factsPath, stageYamlPath, listRunDirs };

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

@@ -1,11 +1,20 @@
 import {
   emitFactsYaml,
   withWorkspaceLock,
-  workspaceRootOfFactsPath
-} from "./chunk-j234zf0t.js";
+  workspaceRootOfFactsPath,
+  writeAtomic
+} from "./chunk-c6t5nx0r.js";
 import {
+  FACT_CONFIDENCES,
+  FACT_KINDS,
+  MAX_FACTS,
+  MAX_FACT_CHARS,
+  factNumber,
+  formatFactId,
+  isLive,
+  isRetired,
   noteDeprecations
-} from "./chunk-t56k6146.js";
+} from "./chunk-rpcxsqh3.js";
 import {
   asDocument,
   isRecord,
@@ -15,29 +24,13 @@ import {
   requireString,
   requireVersion,
   result
-} from "./chunk-0bt6yb2q.js";
+} from "./chunk-39zh2e44.js";
 import {
   parseYaml
-} from "./chunk-p274ckxv.js";
+} from "./chunk-sq44k6g2.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")}`;
-}
+import { existsSync, readFileSync } from "node:fs";
 
 // src/core/facts/validateFactsFile.ts
 var ID_RE = /^F\d{3,6}$/;
@@ -94,6 +87,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) {
@@ -158,7 +154,7 @@ function findDuplicate(question, area, facts, threshold = DEFAULT_JACCARD_THRESH
   for (const fact of facts) {
     if (fact.area !== area)
       continue;
-    if (isRetired(fact))
+    if (!isLive(fact))
       continue;
     const score = jaccard(asked, tokenize(fact.fact));
     if (score < threshold)
@@ -204,7 +200,7 @@ class FactsStore {
     return this.rows;
   }
   get active() {
-    return this.rows.filter((f) => !isRetired(f));
+    return this.rows.filter(isLive);
   }
   get(id) {
     return this.rows.find((f) => f.id === id);
@@ -214,9 +210,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,11 +221,21 @@ 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;
   }
+  headOf(id) {
+    let fact = this.get(id);
+    for (let step = 0;fact !== undefined && fact.superseded_by !== null; step++) {
+      if (step >= this.rows.length)
+        return;
+      fact = this.get(fact.superseded_by);
+    }
+    return fact;
+  }
   supersede(oldId, input) {
     const index = this.rows.findIndex((f) => f.id === oldId);
     if (index === -1)
@@ -272,7 +279,7 @@ class FactsStore {
       throw new Error(`refusing to write an invalid facts.yml: ${first?.path ?? ""} ${first?.message ?? ""}`);
     }
     withWorkspaceLock(workspaceRootOfFactsPath(path), () => {
-      writeFactsAtomic(path, text);
+      writeAtomic(path, text);
     });
   }
   static update(path, fn) {
@@ -284,19 +291,5 @@ class FactsStore {
     });
   }
 }
-function writeFactsAtomic(path, text) {
-  const temp = `${path}.tmp-${String(process.pid)}`;
-  mkdirSync(dirname(path), { recursive: true });
-  try {
-    writeFileSync(temp, text, "utf8");
-    renameSync(temp, path);
-  } catch (error) {
-    try {
-      if (existsSync(temp))
-        rmSync(temp, { force: true });
-    } catch {}
-    throw error;
-  }
-}
 
-export { MAX_FACT_CHARS, FactsStore };
+export { FactsStore };

package/dist/hooks/{chunk-1zwcxd3f.js → chunk-tzzwddct.js}

@@ -1,7 +1,7 @@
 import {
   parseHookInput,
   readStdin
-} from "./chunk-a8p2rc94.js";
+} from "./chunk-b8kxzna2.js";
 
 // src/hooks/lib/decide.ts
 function deny(reason) {

package/dist/hooks/claim-sources.js

@@ -1,17 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-t8tdv11p.js";
+} from "./chunk-7y2dq0pj.js";
 import {
   claimSourcesDeny,
   claimSourcesEmptySectionDeny,
   claimSourcesMalformedDeny,
   claimSourcesUnresolvedDeny
 } from "./chunk-9gb21660.js";
-import {
-  isHandoff,
-  validateHandoff
-} from "./chunk-kw4tffzf.js";
 import {
   allow,
   deny,
@@ -20,14 +16,19 @@ import {
   postContext,
   readPayload,
   runHook
-} from "./chunk-1zwcxd3f.js";
-import"./chunk-a8p2rc94.js";
-import"./chunk-g395gk7e.js";
+} from "./chunk-tzzwddct.js";
+import"./chunk-b8kxzna2.js";
+import {
+  isHandoff,
+  validateCitations,
+  validateHandoff
+} from "./chunk-9zsqxr6y.js";
+import"./chunk-m3mewgnw.js";
 import {
   loadWorkspace,
   locateWork,
   toSrcContext
-} from "./chunk-p274ckxv.js";
+} from "./chunk-sq44k6g2.js";
 
 // src/hooks/claim-sources.ts
 await runHook("claim-sources", async () => {
@@ -43,24 +44,31 @@ await runHook("claim-sources", async () => {
   const wouldBe = wouldBeContent(payload, filePath);
   if (wouldBe.kind !== "content")
     return;
-  const looksLikeHandoff = filePath.endsWith("handoff.md") || isHandoff(wouldBe.text);
-  if (!looksLikeHandoff)
-    return;
   const workspace = loadWorkspace(location.root);
-  const report = validateHandoff(wouldBe.text, toSrcContext(workspace, location.runDir));
-  if (report.ok)
-    return;
+  const srcCtx = toSrcContext(workspace, location.runDir);
   const relPath = `tldrx-work/${location.run}/${location.relative}`;
   const parts = [];
-  if (report.unsourced.length > 0)
-    parts.push(claimSourcesDeny(relPath, report.unsourced));
-  if (report.malformed.length > 0)
-    parts.push(claimSourcesMalformedDeny(relPath, report.malformed));
-  if (report.emptySections.length > 0) {
-    parts.push(claimSourcesEmptySectionDeny(relPath, [...report.emptySections]));
+  const looksLikeHandoff = filePath.endsWith("handoff.md") || isHandoff(wouldBe.text);
+  if (looksLikeHandoff) {
+    const report = validateHandoff(wouldBe.text, srcCtx);
+    if (report.ok)
+      return;
+    if (report.unsourced.length > 0)
+      parts.push(claimSourcesDeny(relPath, report.unsourced));
+    if (report.malformed.length > 0)
+      parts.push(claimSourcesMalformedDeny(relPath, report.malformed));
+    if (report.emptySections.length > 0) {
+      parts.push(claimSourcesEmptySectionDeny(relPath, [...report.emptySections]));
+    }
+    if (report.unresolved.length > 0)
+      parts.push(claimSourcesUnresolvedDeny(relPath, report.unresolved));
+  } else {
+    const report = validateCitations(wouldBe.text, srcCtx);
+    if (report.malformed.length > 0)
+      parts.push(claimSourcesMalformedDeny(relPath, report.malformed));
+    if (report.unresolved.length > 0)
+      parts.push(claimSourcesUnresolvedDeny(relPath, report.unresolved));
   }
-  if (report.unresolved.length > 0)
-    parts.push(claimSourcesUnresolvedDeny(relPath, report.unresolved));
   if (parts.length === 0)
     return;
   const message = parts.join(`

package/dist/hooks/dod-gate.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-t8tdv11p.js";
+} from "./chunk-7y2dq0pj.js";
 import {
   dodGateDeny,
   dodGateInternalErrorDeny,
@@ -15,54 +15,29 @@ import {
   filePathOf,
   isWriteOrEdit,
   readPayload
-} from "./chunk-1zwcxd3f.js";
-import"./chunk-a8p2rc94.js";
-import"./chunk-ae6bkfs5.js";
-import"./chunk-0bt6yb2q.js";
+} from "./chunk-tzzwddct.js";
+import"./chunk-b8kxzna2.js";
+import {
+  parseDodBlock
+} from "./chunk-phmdk72a.js";
+import"./chunk-39zh2e44.js";
 import {
   loadWorkspace,
   locateWork,
   repoPath,
   runtime
-} from "./chunk-p274ckxv.js";
+} from "./chunk-sq44k6g2.js";
 
 // src/hooks/dod-gate.ts
 import { basename, join } from "node:path";
 import { existsSync } from "node:fs";
 
-// src/core/schemas/story.ts
-var FENCE_OPEN_RE = /^\s*```+\s*dod\s*$/i;
-var FENCE_CLOSE_RE = /^\s*```+\s*$/;
-function parseDodBlock(text) {
-  const commands = [];
-  let present = false;
-  let inside = false;
-  for (const line of text.split(`
-`)) {
-    if (inside) {
-      if (FENCE_CLOSE_RE.test(line)) {
-        inside = false;
-        continue;
-      }
-      const command = line.trim();
-      if (command !== "" && !command.startsWith("#"))
-        commands.push(command);
-      continue;
-    }
-    if (FENCE_OPEN_RE.test(line)) {
-      present = true;
-      inside = true;
-    }
-  }
-  return { present, commands };
-}
-
 // src/hooks/lib/story.ts
 var DONE_RE = /^\s*(?:[-*]\s*)?(?:\*\*)?status(?:\*\*)?\s*:\s*["'`]?done["'`]?\.?\s*$/i;
 var REPO_RE = /^\s*(?:[-*]\s*)?(?:\*\*)?repo(?:\*\*)?\s*:\s*["'`]?([A-Za-z0-9._-]{1,64})["'`]?\s*$/i;
 var TIMEOUT_RE = /^\s*(?:[-*]\s*)?(?:\*\*)?timeout_s(?:\*\*)?\s*:\s*(\d{1,6})\s*$/i;
-var FENCE_OPEN_RE2 = /^\s*```+\s*dod\s*$/i;
-var FENCE_CLOSE_RE2 = /^\s*```+\s*$/;
+var FENCE_OPEN_RE = /^\s*```+\s*dod\s*$/i;
+var FENCE_CLOSE_RE = /^\s*```+\s*$/;
 function readStory(text) {
   const lines = text.split(`
 `);
@@ -73,11 +48,11 @@ function readStory(text) {
   let inDod = false;
   for (const line of lines) {
     if (inDod) {
-      if (FENCE_CLOSE_RE2.test(line))
+      if (FENCE_CLOSE_RE.test(line))
         inDod = false;
       continue;
     }
-    if (FENCE_OPEN_RE2.test(line)) {
+    if (FENCE_OPEN_RE.test(line)) {
       inDod = true;
       continue;
     }

package/dist/hooks/no-reask.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-t8tdv11p.js";
+} from "./chunk-7y2dq0pj.js";
 import {
   noReAskDeny
 } from "./chunk-9gb21660.js";
 import {
   FactsStore
-} from "./chunk-x98qs959.js";
+} from "./chunk-t1ywrfr4.js";
 import {
   allow,
   deny,
@@ -15,19 +15,19 @@ import {
   isWriteOrEdit,
   readPayload,
   runHook
-} from "./chunk-1zwcxd3f.js";
-import"./chunk-a8p2rc94.js";
+} from "./chunk-tzzwddct.js";
+import"./chunk-b8kxzna2.js";
+import"./chunk-c6t5nx0r.js";
 import {
   openBlocks,
   parseQuestions
-} from "./chunk-j234zf0t.js";
-import"./chunk-t56k6146.js";
-import"./chunk-g395gk7e.js";
-import"./chunk-0bt6yb2q.js";
+} from "./chunk-rpcxsqh3.js";
+import"./chunk-m3mewgnw.js";
+import"./chunk-39zh2e44.js";
 import {
   factsPath,
   locateWork
-} from "./chunk-p274ckxv.js";
+} from "./chunk-sq44k6g2.js";
 
 // src/hooks/no-reask.ts
 import { existsSync, readFileSync } from "node:fs";