tldr-experts 0.3.1 → 0.4.0

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

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

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

@@ -1,7 +1,7 @@
 import {
   PROJECT_FRAMEWORK_DIR,
   PROJECT_WORK_DIR
-} from "./chunk-ztczwtj0.js";
+} from "./chunk-sq44k6g2.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";
@@ -127,6 +127,8 @@ function withWorkspaceLock(root, fn, timeoutMs = WORKSPACE_LOCK_TIMEOUT_MS) {
 // src/core/facts/emitFactsYaml.ts
 var PLAIN_SAFE = /^[A-Za-z][A-Za-z0-9_./-]*$/;
 var YAML_KEYWORDS = new Set(["true", "false", "null", "yes", "no", "on", "off", "~"]);
+var LONE_HIGH_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])/g;
+var LONE_LOW_SURROGATE = /(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g;
 function yamlScalar(value) {
   if (value === null)
     return "null";
@@ -134,7 +136,7 @@ function yamlScalar(value) {
     return String(value);
   if (PLAIN_SAFE.test(value) && !YAML_KEYWORDS.has(value.toLowerCase()))
     return value;
-  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
+  return JSON.stringify(value.replace(LONE_HIGH_SURROGATE, "�").replace(LONE_LOW_SURROGATE, "�"));
 }
 function inlineList(values) {
   return `[${values.map((v) => yamlScalar(v)).join(", ")}]`;
@@ -175,4 +177,34 @@ function emitFactsYaml(file, header) {
 `;
 }
 
-export { readLock, isAlive, workspaceRootOfRunDir, workspaceRootOfFactsPath, withWorkspaceLock, yamlScalar, emitFactsYaml };
+// src/core/fs/writeAtomic.ts
+import { copyFileSync, existsSync as existsSync3, mkdirSync as mkdirSync3, renameSync, rmSync as rmSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname as dirname3 } from "node:path";
+var BACKUP_SUFFIX = ".bak";
+function backupPathFor(path) {
+  return `${path}${BACKUP_SUFFIX}`;
+}
+function writeAtomic(path, content) {
+  const temp = `${path}.tmp-${String(process.pid)}`;
+  mkdirSync3(dirname3(path), { recursive: true });
+  try {
+    writeFileSync2(temp, content, "utf8");
+    keepPreviousVersion(path);
+    renameSync(temp, path);
+  } catch (error) {
+    try {
+      if (existsSync3(temp))
+        rmSync3(temp, { force: true });
+    } catch {}
+    throw error;
+  }
+}
+function keepPreviousVersion(path) {
+  if (!existsSync3(path))
+    return;
+  try {
+    copyFileSync(path, backupPathFor(path));
+  } catch {}
+}
+
+export { readLock, isAlive, workspaceRootOfRunDir, workspaceRootOfFactsPath, withWorkspaceLock, yamlScalar, emitFactsYaml, backupPathFor, writeAtomic };

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

@@ -1,7 +1,7 @@
 import {
   PROJECT_FRAMEWORK_DIR,
   parseYaml
-} from "./chunk-ztczwtj0.js";
+} from "./chunk-sq44k6g2.js";
 
 // src/core/text/srcToken.ts
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
@@ -164,16 +164,20 @@ function resolveSrc(ref, ctx, section, claim = "") {
         return refused(`unknown repo \`${ref.repo}\` (not in workspace.yml)`);
       }
       const bases = fileBases(ref, ctx);
+      let short = null;
       for (const base of bases) {
         if (!existsSync(base.abs) || !statSync(base.abs).isFile())
           continue;
         const lines = countLines(base.abs);
         const highest = ref.endLine ?? ref.startLine;
         if (highest > lines) {
-          return refused(`${ref.path} has ${lines} line(s); cited line ${highest}`, base.abs);
+          short ??= refused(`${ref.path} has ${lines} line(s); cited line ${highest}`, base.abs);
+          continue;
         }
         return { ok: true, outcome: "ok", resolved: base.abs };
       }
+      if (short !== null)
+        return short;
       const tried = bases.map((b) => b.label).join(", ");
       return refused(`no such file: ${ref.path} — tried ${tried}`, bases[0]?.abs);
     }
@@ -270,26 +274,41 @@ function fileBases(ref, ctx) {
     return [{ label: "the absolute path as written", abs: normalize(ref.path) }];
   }
   if (ref.repo !== null) {
-    const rel = ctx.repos.get(ref.repo) ?? "";
-    return [{ label: repoLabel(ref.repo, rel), abs: normalize(join(ctx.root, rel, ref.path)) }];
+    const rel2 = ctx.repos.get(ref.repo) ?? "";
+    return [
+      ...epicBases(ctx, ref.repo, ref.path),
+      { label: repoLabel(ref.repo, rel2), abs: normalize(join(ctx.root, rel2, ref.path)) }
+    ];
   }
-  const bases = [
-    { label: "workspace root", abs: normalize(join(ctx.root, ref.path)) }
-  ];
+  const bases = [];
+  const slash = ref.path.indexOf("/");
+  const named = slash > 0 ? ref.path.slice(0, slash) : "";
+  const rel = named === "" ? undefined : ctx.repos.get(named);
+  if (rel !== undefined)
+    bases.push(...epicBases(ctx, named, ref.path.slice(slash + 1)));
+  bases.push({ label: "workspace root", abs: normalize(join(ctx.root, ref.path)) });
   const runDir = ctx.runDir ?? null;
   if (runDir !== null && runDir !== "") {
     bases.push({ label: `run dir ${displayPath(ctx.root, runDir)}`, abs: normalize(join(runDir, ref.path)) });
   }
-  const slash = ref.path.indexOf("/");
-  if (slash > 0) {
-    const name = ref.path.slice(0, slash);
-    const rel = ctx.repos.get(name);
-    if (rel !== undefined) {
-      bases.push({
-        label: repoLabel(name, rel),
-        abs: normalize(join(ctx.root, rel, ref.path.slice(slash + 1)))
-      });
-    }
+  if (rel !== undefined) {
+    bases.push({
+      label: repoLabel(named, rel),
+      abs: normalize(join(ctx.root, rel, ref.path.slice(slash + 1)))
+    });
+  }
+  return bases;
+}
+function epicBases(ctx, repo, path) {
+  const trees = ctx.epicWorktrees ?? [];
+  const bases = [];
+  for (const tree of trees) {
+    if (tree.repo !== repo)
+      continue;
+    bases.push({
+      label: `epic worktree ${displayPath(ctx.root, tree.dir)}`,
+      abs: normalize(join(tree.dir, path))
+    });
   }
   return bases;
 }

package/dist/hooks/{chunk-0z27twdk.js → chunk-phmdk72a.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-39zh2e44.js";
 import {
   parseYaml
-} from "./chunk-ztczwtj0.js";
+} from "./chunk-sq44k6g2.js";
 
 // src/core/schemas/planCommon.ts
 var STORY_ID_RE = /^S\d{1,4}$/;
@@ -22,7 +22,7 @@ function requireStringList(value, path, issues, rules = {}) {
   }
   const max = rules.max ?? MAX_LIST_ITEMS;
   if (value.length > max) {
-    issues.push({ path, message: `${value.length} items exceeds the ${max} cap` });
+    issues.push({ path, message: `${value.length} items exceeds the ${max}-item cap` });
   }
   if (rules.nonEmpty === true && value.length === 0) {
     issues.push({ path, message: "must not be empty" });
@@ -40,7 +40,10 @@ function requireStringList(value, path, issues, rules = {}) {
       return;
     }
     if (item.length > MAX_ITEM_CHARS) {
-      issues.push({ path: at, message: `${item.length} characters exceeds the ${MAX_ITEM_CHARS} cap` });
+      issues.push({
+        path: at,
+        message: `${item.length} characters exceeds the ${MAX_ITEM_CHARS}-character cap on one list item ` + "— split it into several items"
+      });
     }
     if (rules.pattern !== undefined && !rules.pattern.test(item)) {
       issues.push({ path: at, message: `expected ${rules.patternName ?? String(rules.pattern)}, got \`${item}\`` });
@@ -130,8 +133,10 @@ function message(error) {
 `)[0] ?? "parse error" : String(error);
 }
 // src/core/schemas/story.ts
-var FENCE_OPEN_RE = /^\s*```+\s*dod\s*$/i;
-var FENCE_CLOSE_RE = /^\s*```+\s*$/;
+var DOD_FENCE_OPEN_RE = /^\s*```+\s*dod\s*$/i;
+var DOD_FENCE_CLOSE_RE = /^\s*```+\s*$/;
+var FENCE_OPEN_RE = DOD_FENCE_OPEN_RE;
+var FENCE_CLOSE_RE = DOD_FENCE_CLOSE_RE;
 function parseDodBlock(text) {
   const commands = [];
   let present = false;

package/dist/hooks/{chunk-3t91gvpp.js → chunk-rpcxsqh3.js}

@@ -1,6 +1,6 @@
 import {
   parseSrcToken
-} from "./chunk-sznsenee.js";
+} from "./chunk-m3mewgnw.js";
 
 // src/core/text/questions.ts
 var REQUIRED_METADATA_KEYS = ["id", "status", "area", "asked_by", "asked_at"];
@@ -170,6 +170,12 @@ var MAX_FACT_CHARS = 2000;
 function isRetired(fact) {
   return fact.retired !== null && fact.retired.at !== null;
 }
+function isSuperseded(fact) {
+  return fact.superseded_by !== null;
+}
+function isLive(fact) {
+  return !isRetired(fact) && !isSuperseded(fact);
+}
 function factNumber(id) {
   return Number.parseInt(id.slice(1), 10);
 }
@@ -190,4 +196,4 @@ function noteDeprecations(file, outcome) {
   }
 }
 
-export { FACT_KINDS, FACT_CONFIDENCES, MAX_FACTS, MAX_FACT_CHARS, isRetired, factNumber, formatFactId, noteDeprecations, parseQuestions, serializeQuestions, detectAnswered, openBlocks, recordAnswer, replaceBlock };
+export { FACT_KINDS, FACT_CONFIDENCES, MAX_FACTS, MAX_FACT_CHARS, isRetired, isLive, factNumber, formatFactId, noteDeprecations, parseQuestions, serializeQuestions, detectAnswered, openBlocks, recordAnswer, replaceBlock };

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

@@ -34,8 +34,10 @@ var EVENT_TYPES = [
   "gate.approved",
   "gate.rejected",
   "gate.revoked",
+  "gate.policy_changed",
   "story.reopened",
   "story.base_fastforwarded",
+  "operator_note",
   "check.passed",
   "check.failed",
   "budget.warned",
@@ -43,6 +45,7 @@ var EVENT_TYPES = [
   "budget.raised",
   "fact.added",
   "fact.retired",
+  "fact.superseded",
   "map.refreshed",
   "ticket.synced",
   "error"

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

@@ -1,5 +1,6 @@
 import {
   DEFAULT_ECONOMY,
+  DEFAULT_ON_HOST_TOKENS_EXCEED,
   asRunBudget,
   asRunFile,
   cursorStage,
@@ -7,6 +8,7 @@ import {
   deriveRunStatus,
   flatten,
   isAttendedByHost,
+  isAttendedByHostView,
   isFinished,
   isTerminal,
   nowRfc3339,
@@ -14,34 +16,37 @@ import {
   stageAt,
   validateRunBudget,
   validateRunFile
-} from "./chunk-zdxgragg.js";
+} from "./chunk-4cp363kv.js";
 import {
   EventLog
-} from "./chunk-ybacnpxd.js";
+} from "./chunk-rz541e2b.js";
 import {
+  backupPathFor,
   isAlive,
   readLock,
   withWorkspaceLock,
   workspaceRootOfRunDir,
+  writeAtomic,
   yamlScalar
-} from "./chunk-9kkm6q0t.js";
+} from "./chunk-c6t5nx0r.js";
 import {
   noteDeprecations,
   openBlocks,
   parseQuestions
-} from "./chunk-3t91gvpp.js";
+} from "./chunk-rpcxsqh3.js";
 import {
   listRunDirs,
-  parseYaml
-} from "./chunk-ztczwtj0.js";
+  parseYaml,
+  parseYamlRepairing
+} from "./chunk-sq44k6g2.js";
 
 // src/core/statusline/runSnapshot.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
 import { join as join2 } from "node:path";
 
 // src/core/run/RunStore.ts
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { basename, dirname, join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
 
 // src/core/run/emitRunYaml.ts
 function inlineList(values) {
@@ -121,7 +126,8 @@ function emitRunYaml(run) {
     lines.push(`triage: {split: ${yamlScalar(run.triage.split)}, depends_on: ${inlineList(run.triage.depends_on)}}`);
   }
   if (run.build !== undefined && run.build.epic_branch.length > 0) {
-    lines.push(`build: {epic_branch: ${inlineList(run.build.epic_branch)}}`);
+    const model = run.build.branch_model === undefined ? "" : `, branch_model: ${yamlScalar(run.build.branch_model)}`;
+    lines.push(`build: {epic_branch: ${inlineList(run.build.epic_branch)}${model}}`);
   }
   if (run.cancelled !== undefined) {
     lines.push(`cancelled: {by: ${yamlScalar(run.cancelled.by)}, at: ${yamlScalar(run.cancelled.at)}, ` + `note: ${yamlScalar(run.cancelled.note)}}`);
@@ -129,6 +135,9 @@ function emitRunYaml(run) {
   if (run.attended_by !== undefined) {
     lines.push(`attended_by: ${yamlScalar(run.attended_by)}`);
   }
+  if (run.keep_worktrees === true) {
+    lines.push("keep_worktrees: true");
+  }
   if (run.gates_policy !== undefined && Object.keys(run.gates_policy).length > 0) {
     lines.push(`gates_policy: ${gatesPolicy(run.gates_policy)}`);
   }
@@ -159,6 +168,7 @@ function emitBudgetYaml(budget) {
     `warn_at_pct: ${budget.warn_at_pct}`,
     `on_exceed: ${yamlScalar(budget.on_exceed)}`,
     ...budget.economy === DEFAULT_ECONOMY ? [] : [`economy: ${yamlScalar(budget.economy)}`],
+    ...budget.on_host_tokens_exceed === DEFAULT_ON_HOST_TOKENS_EXCEED ? [] : [`on_host_tokens_exceed: ${yamlScalar(budget.on_host_tokens_exceed)}`],
     "phases:"
   ];
   for (const phase of budget.phases) {
@@ -190,8 +200,8 @@ class RunStore {
     const runPath = join(runDir, "run.yml");
     if (!existsSync(runPath))
       throw new RunStoreError(`no run.yml in ${runDir}`);
-    const doc = parseYaml(readFileSync(runPath, "utf8"));
-    const validation = validateRunFile(doc);
+    const run = parseStateFile(runPath);
+    const validation = validateRunFile(run.doc);
     noteDeprecations(runPath, validation);
     if (!validation.ok) {
       const first = validation.issues[0];
@@ -200,14 +210,30 @@ class RunStore {
     const budgetPath = join(runDir, "budget.yml");
     if (!existsSync(budgetPath))
       throw new RunStoreError(`no budget.yml in ${runDir}`);
-    const budgetDoc = parseYaml(readFileSync(budgetPath, "utf8"));
-    const budgetValidation = validateRunBudget(budgetDoc);
+    const budget = parseStateFile(budgetPath);
+    const budgetValidation = validateRunBudget(budget.doc);
     noteDeprecations(budgetPath, budgetValidation);
     if (!budgetValidation.ok) {
       const first = budgetValidation.issues[0];
       throw new RunStoreError(`invalid budget.yml (${budgetPath}): ${first?.path ?? ""} ${first?.message ?? "schema error"}`);
     }
-    return new RunStore(runDir, asRunFile(doc), asRunBudget(budgetDoc), EventLog.forRun(runDir));
+    const store = new RunStore(runDir, asRunFile(run.doc), asRunBudget(budget.doc), EventLog.forRun(runDir));
+    if (run.repaired || budget.repaired)
+      store.healOnDisk(run.repaired, budget.repaired);
+    return store;
+  }
+  healOnDisk(runRepaired, budgetRepaired) {
+    try {
+      withWorkspaceLock(workspaceRootOfRunDir(this.runDir), () => {
+        if (runRepaired)
+          writeAtomic(join(this.runDir, "run.yml"), emitRunYaml(this.current));
+        if (budgetRepaired)
+          writeAtomic(join(this.runDir, "budget.yml"), emitBudgetYaml(this.currentBudget));
+      });
+      const which = [runRepaired ? "run.yml" : "", budgetRepaired ? "budget.yml" : ""].filter((name) => name !== "").join(" and ");
+      process.stderr.write(`tldrx: ${this.runDir}: ${which} held text broken across lines by an emitter bug ` + "since fixed. It was repaired in memory and rewritten correctly; the version that was " + `on disk is beside it as .bak. Nothing else about the run was changed.
+`);
+    } catch {}
   }
   static find(root, runId) {
     const dir = listRunDirs(root).find((d) => basename(d) === runId);
@@ -317,18 +343,21 @@ class RunStore {
     }
   }
 }
-function writeAtomic(path, content) {
-  const temp = `${path}.tmp-${String(process.pid)}`;
-  mkdirSync(dirname(path), { recursive: true });
+function parseStateFile(path) {
+  const text = readFileSync(path, "utf8");
   try {
-    writeFileSync(temp, content, "utf8");
-    renameSync(temp, path);
+    return parseYamlRepairing(text);
   } catch (error) {
-    try {
-      if (existsSync(temp))
-        rmSync(temp, { force: true });
-    } catch {}
-    throw error;
+    const backup = backupPathFor(path);
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new RunStoreError([
+      `${path} does not parse: ${detail}`,
+      "  every tldrx command on this run reads that file first, so all of them fail until it does",
+      existsSync(backup) ? `  the version the last save replaced is at ${backup} — recovery is MANUAL and tldrx ` + "will not do it for you:" + `
+    diff it, and if that version is the one you want, copy it back over ${basename(path)}` : `  there is no ${basename(backup)} beside it — this file has not been written since ` + "backups arrived, so there is no previous version to go back to",
+      "  a hand-edit is the other way out, and it is the only one that keeps work the backup predates"
+    ].join(`
+`));
   }
 }
 function rollUp(run) {
@@ -458,7 +487,7 @@ function fromTolerantRead(root) {
     openCount: open.length,
     autoGates: 0,
     staleStages: 0,
-    attendedByHost: false,
+    attendedByHost: isAttendedByHostView(view),
     source: "tolerant"
   };
 }

package/dist/hooks/{chunk-ztczwtj0.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,6 +7440,27 @@ 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;
@@ -7383,23 +7496,18 @@ 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 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;
-        commands.add(value);
-        roles.set(role, 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);
@@ -7411,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);
@@ -7437,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 };