@attalabs/vinaya 0.18.0 → 0.19.0

package/dist/checks/bin/check-doc-coverage.js

@@ -274,6 +274,9 @@ function issueListByLabelArgs(owner, repo, label) {
     "200"
   ];
 }
+function ghIssueListByLabel(owner, repo, label) {
+  return JSON.parse(run(issueListByLabelArgs(owner, repo, label)));
+}
 async function ghIssueListByLabelAsync(owner, repo, label) {
   return JSON.parse(await runAsync(issueListByLabelArgs(owner, repo, label)));
 }
@@ -289,18 +292,6 @@ async function ghIssueListByAnyLabelAsync(owner, repo, labels) {
   return dedupeByNumber(perLabel.flat());
 }
 
-// ../../packages/aeg-forge-state/src/fetch-milestone.ts
-function findMilestoneForSlug(owner, repo, slug) {
-  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
-  const match = milestones.find((m) => m.title === slug);
-  if (!match)
-    return null;
-  return {
-    goal: match.description ?? "",
-    lifecycle: match.state === "closed" ? "complete" : "active"
-  };
-}
-
 // ../../packages/aeg-forge-state/src/labels.ts
 var LABELS = [
   {
@@ -543,6 +534,60 @@ function resolveTaskIssueRef(title, labels) {
   return { trancheSlug, taskId };
 }
 
+// ../../packages/aeg-forge-state/src/fetch-milestone.ts
+var INTENTS_HEADING = /^#{1,6}\s*Tranche intents\s*$/im;
+var NEXT_HEADING = /^#{1,6}\s+\S/m;
+var INTENT_BULLET = /^-\s+([a-z0-9][a-z0-9-]*)\s*:\s*(.+)$/i;
+function intentGoalForSlug(description, slug) {
+  const text = stripCode(description, { inlineSpans: "keep" });
+  const start = text.match(INTENTS_HEADING);
+  if (!start || start.index === undefined)
+    return "";
+  const rest = text.slice(start.index + start[0].length);
+  const next = rest.match(NEXT_HEADING);
+  const section = rest.slice(0, next && next.index !== undefined ? next.index : rest.length);
+  for (const line of section.split(`
+`)) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+      continue;
+    const m = trimmed.match(INTENT_BULLET);
+    if (m && (m[1] ?? "").toLowerCase() === slug.toLowerCase())
+      return (m[2] ?? "").trim();
+  }
+  return "";
+}
+function matchesLegacyMilestone(milestones, slug) {
+  return milestones.find((m) => m.title === slug) ?? null;
+}
+function factsFromLegacyMilestone(milestone) {
+  return {
+    goal: milestone.description ?? "",
+    lifecycle: milestone.state === "closed" ? "complete" : "active"
+  };
+}
+function lifecycleFromIssues(issues) {
+  if (issues.length === 0)
+    return "planned";
+  return issues.some((i) => i.state === "OPEN") ? "active" : "complete";
+}
+function goalFromMilestones(milestones, slug) {
+  for (const m of milestones) {
+    const goal = intentGoalForSlug(m.description ?? "", slug);
+    if (goal)
+      return goal;
+  }
+  return "";
+}
+function findMilestoneForSlug(owner, repo, slug) {
+  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
+  const legacy = matchesLegacyMilestone(milestones, slug);
+  if (legacy)
+    return factsFromLegacyMilestone(legacy);
+  const issues = ghIssueListByLabel(owner, repo, trancheLabel(slug));
+  return { goal: goalFromMilestones(milestones, slug), lifecycle: lifecycleFromIssues(issues) };
+}
+
 // ../../packages/aeg-forge-state/src/derive-from-forge.ts
 function trancheFromIssues(slug, issues, known) {
   return {
@@ -3196,7 +3241,8 @@ var BRIEF_BUILTINS = [
   "for",
   "closesN",
   "premiseCoverage",
-  "issueRationale"
+  "issueRationale",
+  "milestoneShape"
 ];
 var BriefSectionSchema = z.union([
   z.object({ builtin: z.enum(BRIEF_BUILTINS) }),
@@ -3207,6 +3253,7 @@ var BriefSectionSchema = z.union([
 var BriefSchemaSchema = z.object({
   pr: z.object({ sections: z.array(BriefSectionSchema) }).optional(),
   issue: z.object({ sections: z.array(BriefSectionSchema) }).optional(),
+  milestone: z.object({ sections: z.array(BriefSectionSchema) }).optional(),
   ack: z.array(z.enum(BRIEF_BUILTINS)).optional()
 });
 function isSafeRepoRelPath(p) {

package/dist/checks/bin/check-evidence-fresh.js

@@ -273,6 +273,9 @@ function issueListByLabelArgs(owner, repo, label) {
     "200"
   ];
 }
+function ghIssueListByLabel(owner, repo, label) {
+  return JSON.parse(run(issueListByLabelArgs(owner, repo, label)));
+}
 async function ghIssueListByLabelAsync(owner, repo, label) {
   return JSON.parse(await runAsync(issueListByLabelArgs(owner, repo, label)));
 }
@@ -288,18 +291,6 @@ async function ghIssueListByAnyLabelAsync(owner, repo, labels) {
   return dedupeByNumber(perLabel.flat());
 }
 
-// ../../packages/aeg-forge-state/src/fetch-milestone.ts
-function findMilestoneForSlug(owner, repo, slug) {
-  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
-  const match = milestones.find((m) => m.title === slug);
-  if (!match)
-    return null;
-  return {
-    goal: match.description ?? "",
-    lifecycle: match.state === "closed" ? "complete" : "active"
-  };
-}
-
 // ../../packages/aeg-forge-state/src/labels.ts
 var LABELS = [
   {
@@ -542,6 +533,60 @@ function resolveTaskIssueRef(title, labels) {
   return { trancheSlug, taskId };
 }
 
+// ../../packages/aeg-forge-state/src/fetch-milestone.ts
+var INTENTS_HEADING = /^#{1,6}\s*Tranche intents\s*$/im;
+var NEXT_HEADING = /^#{1,6}\s+\S/m;
+var INTENT_BULLET = /^-\s+([a-z0-9][a-z0-9-]*)\s*:\s*(.+)$/i;
+function intentGoalForSlug(description, slug) {
+  const text = stripCode(description, { inlineSpans: "keep" });
+  const start = text.match(INTENTS_HEADING);
+  if (!start || start.index === undefined)
+    return "";
+  const rest = text.slice(start.index + start[0].length);
+  const next = rest.match(NEXT_HEADING);
+  const section = rest.slice(0, next && next.index !== undefined ? next.index : rest.length);
+  for (const line of section.split(`
+`)) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+      continue;
+    const m = trimmed.match(INTENT_BULLET);
+    if (m && (m[1] ?? "").toLowerCase() === slug.toLowerCase())
+      return (m[2] ?? "").trim();
+  }
+  return "";
+}
+function matchesLegacyMilestone(milestones, slug) {
+  return milestones.find((m) => m.title === slug) ?? null;
+}
+function factsFromLegacyMilestone(milestone) {
+  return {
+    goal: milestone.description ?? "",
+    lifecycle: milestone.state === "closed" ? "complete" : "active"
+  };
+}
+function lifecycleFromIssues(issues) {
+  if (issues.length === 0)
+    return "planned";
+  return issues.some((i) => i.state === "OPEN") ? "active" : "complete";
+}
+function goalFromMilestones(milestones, slug) {
+  for (const m of milestones) {
+    const goal = intentGoalForSlug(m.description ?? "", slug);
+    if (goal)
+      return goal;
+  }
+  return "";
+}
+function findMilestoneForSlug(owner, repo, slug) {
+  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
+  const legacy = matchesLegacyMilestone(milestones, slug);
+  if (legacy)
+    return factsFromLegacyMilestone(legacy);
+  const issues = ghIssueListByLabel(owner, repo, trancheLabel(slug));
+  return { goal: goalFromMilestones(milestones, slug), lifecycle: lifecycleFromIssues(issues) };
+}
+
 // ../../packages/aeg-forge-state/src/derive-from-forge.ts
 function trancheFromIssues(slug, issues, known) {
   return {

package/dist/checks/bin/check-first-push-dispatch.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/checks/bin/check-first-push-dispatch.ts
-import { execFileSync as execFileSync3 } from "node:child_process";
+import { execFileSync as execFileSync4 } from "node:child_process";
 // ../../packages/aeg-forge-state/src/strip-code.ts
 function maskCode(body) {
   const fill = (line) => " ".repeat(line.length);
@@ -273,6 +273,9 @@ function issueListByLabelArgs(owner, repo, label) {
     "200"
   ];
 }
+function ghIssueListByLabel(owner, repo, label) {
+  return JSON.parse(run(issueListByLabelArgs(owner, repo, label)));
+}
 async function ghIssueListByLabelAsync(owner, repo, label) {
   return JSON.parse(await runAsync(issueListByLabelArgs(owner, repo, label)));
 }
@@ -288,18 +291,6 @@ async function ghIssueListByAnyLabelAsync(owner, repo, labels) {
   return dedupeByNumber(perLabel.flat());
 }
 
-// ../../packages/aeg-forge-state/src/fetch-milestone.ts
-function findMilestoneForSlug(owner, repo, slug) {
-  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
-  const match = milestones.find((m) => m.title === slug);
-  if (!match)
-    return null;
-  return {
-    goal: match.description ?? "",
-    lifecycle: match.state === "closed" ? "complete" : "active"
-  };
-}
-
 // ../../packages/aeg-forge-state/src/labels.ts
 var LABELS = [
   {
@@ -542,6 +533,60 @@ function resolveTaskIssueRef(title, labels) {
   return { trancheSlug, taskId };
 }
 
+// ../../packages/aeg-forge-state/src/fetch-milestone.ts
+var INTENTS_HEADING = /^#{1,6}\s*Tranche intents\s*$/im;
+var NEXT_HEADING = /^#{1,6}\s+\S/m;
+var INTENT_BULLET = /^-\s+([a-z0-9][a-z0-9-]*)\s*:\s*(.+)$/i;
+function intentGoalForSlug(description, slug) {
+  const text = stripCode(description, { inlineSpans: "keep" });
+  const start = text.match(INTENTS_HEADING);
+  if (!start || start.index === undefined)
+    return "";
+  const rest = text.slice(start.index + start[0].length);
+  const next = rest.match(NEXT_HEADING);
+  const section = rest.slice(0, next && next.index !== undefined ? next.index : rest.length);
+  for (const line of section.split(`
+`)) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+      continue;
+    const m = trimmed.match(INTENT_BULLET);
+    if (m && (m[1] ?? "").toLowerCase() === slug.toLowerCase())
+      return (m[2] ?? "").trim();
+  }
+  return "";
+}
+function matchesLegacyMilestone(milestones, slug) {
+  return milestones.find((m) => m.title === slug) ?? null;
+}
+function factsFromLegacyMilestone(milestone) {
+  return {
+    goal: milestone.description ?? "",
+    lifecycle: milestone.state === "closed" ? "complete" : "active"
+  };
+}
+function lifecycleFromIssues(issues) {
+  if (issues.length === 0)
+    return "planned";
+  return issues.some((i) => i.state === "OPEN") ? "active" : "complete";
+}
+function goalFromMilestones(milestones, slug) {
+  for (const m of milestones) {
+    const goal = intentGoalForSlug(m.description ?? "", slug);
+    if (goal)
+      return goal;
+  }
+  return "";
+}
+function findMilestoneForSlug(owner, repo, slug) {
+  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
+  const legacy = matchesLegacyMilestone(milestones, slug);
+  if (legacy)
+    return factsFromLegacyMilestone(legacy);
+  const issues = ghIssueListByLabel(owner, repo, trancheLabel(slug));
+  return { goal: goalFromMilestones(milestones, slug), lifecycle: lifecycleFromIssues(issues) };
+}
+
 // ../../packages/aeg-forge-state/src/derive-from-forge.ts
 function trancheFromIssues(slug, issues, known) {
   return {
@@ -3194,7 +3239,8 @@ var BRIEF_BUILTINS = [
   "for",
   "closesN",
   "premiseCoverage",
-  "issueRationale"
+  "issueRationale",
+  "milestoneShape"
 ];
 var BriefSectionSchema = z2.union([
   z2.object({ builtin: z2.enum(BRIEF_BUILTINS) }),
@@ -3205,6 +3251,7 @@ var BriefSectionSchema = z2.union([
 var BriefSchemaSchema = z2.object({
   pr: z2.object({ sections: z2.array(BriefSectionSchema) }).optional(),
   issue: z2.object({ sections: z2.array(BriefSectionSchema) }).optional(),
+  milestone: z2.object({ sections: z2.array(BriefSectionSchema) }).optional(),
   ack: z2.array(z2.enum(BRIEF_BUILTINS)).optional()
 });
 function isSafeRepoRelPath(p) {
@@ -3317,11 +3364,74 @@ function loadTrustAnchorConfig(fetcher = ghFetchTrustAnchorConfig) {
   }
 }
 
+// src/checks/edge-resolve.ts
+import { execFileSync as execFileSync3 } from "node:child_process";
+var DIRECT_ISSUE_REF = /#(\d+)/;
+var issueCache = new Map;
+function fetchIssueState(num, repo) {
+  const key = `${repo.owner}/${repo.repo}#${num}`;
+  if (issueCache.has(key))
+    return issueCache.get(key) ?? null;
+  let out = null;
+  try {
+    const raw = execFileSync3("gh", [
+      "issue",
+      "view",
+      String(num),
+      "-R",
+      `${repo.owner}/${repo.repo}`,
+      "--json",
+      "state,stateReason,closedByPullRequestsReferences"
+    ], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+    out = JSON.parse(raw);
+  } catch {
+    out = null;
+  }
+  issueCache.set(key, out);
+  return out;
+}
+function edgeFromIssueJson(num, json) {
+  if (json === null) {
+    return { issue: num, merged: false, open: false, issueState: null, stateReason: null, closedByActor: null };
+  }
+  const state = json.state === "CLOSED" ? "closed" : json.state === "OPEN" ? "open" : null;
+  const reason = json.stateReason === "COMPLETED" ? "completed" : json.stateReason === "NOT_PLANNED" ? "not_planned" : null;
+  const closedByMergedPr = (json.closedByPullRequestsReferences ?? []).length > 0;
+  return {
+    issue: num,
+    merged: state === "closed" && closedByMergedPr,
+    open: false,
+    issueState: state,
+    stateReason: reason,
+    closedByActor: null
+  };
+}
+function resolveEdge(id, taskById, factsByTaskId, repo) {
+  const target = taskById.get(id);
+  if (target) {
+    const facts = target.issue !== null ? factsByTaskId.get(target.id) : undefined;
+    return {
+      issue: target.issue,
+      merged: facts?.prState === "merged",
+      open: facts?.prState === "open",
+      issueState: facts?.issueState ?? null,
+      stateReason: facts?.stateReason ?? null,
+      closedByActor: facts?.closedByActor ?? null
+    };
+  }
+  const direct = id.match(DIRECT_ISSUE_REF);
+  if (direct) {
+    const num = Number(direct[1]);
+    return edgeFromIssueJson(num, fetchIssueState(num, repo));
+  }
+  return { issue: null, merged: false, open: false, issueState: null, stateReason: null, closedByActor: null };
+}
+
 // src/checks/bin/check-first-push-dispatch.ts
 var CHECK_NAME = "first-push-dispatch";
 function git(args) {
   try {
-    return execFileSync3("git", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+    return execFileSync4("git", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
   } catch {
     return "";
   }
@@ -3344,7 +3454,7 @@ function resolveRepo2() {
 }
 function prExistsFor(branch) {
   try {
-    const out = execFileSync3("gh", ["pr", "list", "--head", branch, "--state", "all", "--json", "number", "--limit", "1"], {
+    const out = execFileSync4("gh", ["pr", "list", "--head", branch, "--state", "all", "--json", "number", "--limit", "1"], {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"]
     });
@@ -3354,29 +3464,6 @@ function prExistsFor(branch) {
     return false;
   }
 }
-function resolveEdge(id, taskById, factsByTaskId) {
-  const target = taskById.get(id);
-  if (target) {
-    const facts = target.issue !== null ? factsByTaskId.get(target.id) : undefined;
-    return {
-      issue: target.issue,
-      merged: facts?.prState === "merged",
-      open: facts?.prState === "open",
-      issueState: facts?.issueState ?? null,
-      stateReason: facts?.stateReason ?? null,
-      closedByActor: facts?.closedByActor ?? null
-    };
-  }
-  const direct = id.match(/^#(\d+)$/);
-  return {
-    issue: direct ? Number(direct[1]) : null,
-    merged: false,
-    open: false,
-    issueState: null,
-    stateReason: null,
-    closedByActor: null
-  };
-}
 async function classifyReadiness(trancheSlug, taskId) {
   const repo = resolveRepo2();
   if (!repo)
@@ -3404,7 +3491,7 @@ async function classifyReadiness(trancheSlug, taskId) {
     const taskById = new Map(tranche.tasks.map((t) => [t.id, t]));
     const factsByTaskId = snapshot.facts;
     const dependsOn = task.dependsOn.map((dep) => {
-      const r = resolveEdge(dep, taskById, factsByTaskId);
+      const r = resolveEdge(dep, taskById, factsByTaskId, repo);
       return {
         id: dep,
         issue: r.issue,
@@ -3415,7 +3502,7 @@ async function classifyReadiness(trancheSlug, taskId) {
       };
     });
     const conflictsWith = task.conflictsWith.map((c) => {
-      const r = resolveEdge(c, taskById, factsByTaskId);
+      const r = resolveEdge(c, taskById, factsByTaskId, repo);
       return { id: c, issue: r.issue, openOrInFlight: r.open };
     });
     const input = {

package/dist/checks/bin/check-issue-assignment.js

@@ -273,6 +273,9 @@ function issueListByLabelArgs(owner, repo, label) {
     "200"
   ];
 }
+function ghIssueListByLabel(owner, repo, label) {
+  return JSON.parse(run(issueListByLabelArgs(owner, repo, label)));
+}
 async function ghIssueListByLabelAsync(owner, repo, label) {
   return JSON.parse(await runAsync(issueListByLabelArgs(owner, repo, label)));
 }
@@ -288,18 +291,6 @@ async function ghIssueListByAnyLabelAsync(owner, repo, labels) {
   return dedupeByNumber(perLabel.flat());
 }
 
-// ../../packages/aeg-forge-state/src/fetch-milestone.ts
-function findMilestoneForSlug(owner, repo, slug) {
-  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
-  const match = milestones.find((m) => m.title === slug);
-  if (!match)
-    return null;
-  return {
-    goal: match.description ?? "",
-    lifecycle: match.state === "closed" ? "complete" : "active"
-  };
-}
-
 // ../../packages/aeg-forge-state/src/labels.ts
 var LABELS = [
   {
@@ -542,6 +533,60 @@ function resolveTaskIssueRef(title, labels) {
   return { trancheSlug, taskId };
 }
 
+// ../../packages/aeg-forge-state/src/fetch-milestone.ts
+var INTENTS_HEADING = /^#{1,6}\s*Tranche intents\s*$/im;
+var NEXT_HEADING = /^#{1,6}\s+\S/m;
+var INTENT_BULLET = /^-\s+([a-z0-9][a-z0-9-]*)\s*:\s*(.+)$/i;
+function intentGoalForSlug(description, slug) {
+  const text = stripCode(description, { inlineSpans: "keep" });
+  const start = text.match(INTENTS_HEADING);
+  if (!start || start.index === undefined)
+    return "";
+  const rest = text.slice(start.index + start[0].length);
+  const next = rest.match(NEXT_HEADING);
+  const section = rest.slice(0, next && next.index !== undefined ? next.index : rest.length);
+  for (const line of section.split(`
+`)) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+      continue;
+    const m = trimmed.match(INTENT_BULLET);
+    if (m && (m[1] ?? "").toLowerCase() === slug.toLowerCase())
+      return (m[2] ?? "").trim();
+  }
+  return "";
+}
+function matchesLegacyMilestone(milestones, slug) {
+  return milestones.find((m) => m.title === slug) ?? null;
+}
+function factsFromLegacyMilestone(milestone) {
+  return {
+    goal: milestone.description ?? "",
+    lifecycle: milestone.state === "closed" ? "complete" : "active"
+  };
+}
+function lifecycleFromIssues(issues) {
+  if (issues.length === 0)
+    return "planned";
+  return issues.some((i) => i.state === "OPEN") ? "active" : "complete";
+}
+function goalFromMilestones(milestones, slug) {
+  for (const m of milestones) {
+    const goal = intentGoalForSlug(m.description ?? "", slug);
+    if (goal)
+      return goal;
+  }
+  return "";
+}
+function findMilestoneForSlug(owner, repo, slug) {
+  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
+  const legacy = matchesLegacyMilestone(milestones, slug);
+  if (legacy)
+    return factsFromLegacyMilestone(legacy);
+  const issues = ghIssueListByLabel(owner, repo, trancheLabel(slug));
+  return { goal: goalFromMilestones(milestones, slug), lifecycle: lifecycleFromIssues(issues) };
+}
+
 // ../../packages/aeg-forge-state/src/derive-from-forge.ts
 function trancheFromIssues(slug, issues, known) {
   return {

package/dist/checks/bin/check-no-disk-state.js

@@ -273,6 +273,9 @@ function issueListByLabelArgs(owner, repo, label) {
     "200"
   ];
 }
+function ghIssueListByLabel(owner, repo, label) {
+  return JSON.parse(run(issueListByLabelArgs(owner, repo, label)));
+}
 async function ghIssueListByLabelAsync(owner, repo, label) {
   return JSON.parse(await runAsync(issueListByLabelArgs(owner, repo, label)));
 }
@@ -288,18 +291,6 @@ async function ghIssueListByAnyLabelAsync(owner, repo, labels) {
   return dedupeByNumber(perLabel.flat());
 }
 
-// ../../packages/aeg-forge-state/src/fetch-milestone.ts
-function findMilestoneForSlug(owner, repo, slug) {
-  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
-  const match = milestones.find((m) => m.title === slug);
-  if (!match)
-    return null;
-  return {
-    goal: match.description ?? "",
-    lifecycle: match.state === "closed" ? "complete" : "active"
-  };
-}
-
 // ../../packages/aeg-forge-state/src/labels.ts
 var LABELS = [
   {
@@ -542,6 +533,60 @@ function resolveTaskIssueRef(title, labels) {
   return { trancheSlug, taskId };
 }
 
+// ../../packages/aeg-forge-state/src/fetch-milestone.ts
+var INTENTS_HEADING = /^#{1,6}\s*Tranche intents\s*$/im;
+var NEXT_HEADING = /^#{1,6}\s+\S/m;
+var INTENT_BULLET = /^-\s+([a-z0-9][a-z0-9-]*)\s*:\s*(.+)$/i;
+function intentGoalForSlug(description, slug) {
+  const text = stripCode(description, { inlineSpans: "keep" });
+  const start = text.match(INTENTS_HEADING);
+  if (!start || start.index === undefined)
+    return "";
+  const rest = text.slice(start.index + start[0].length);
+  const next = rest.match(NEXT_HEADING);
+  const section = rest.slice(0, next && next.index !== undefined ? next.index : rest.length);
+  for (const line of section.split(`
+`)) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+      continue;
+    const m = trimmed.match(INTENT_BULLET);
+    if (m && (m[1] ?? "").toLowerCase() === slug.toLowerCase())
+      return (m[2] ?? "").trim();
+  }
+  return "";
+}
+function matchesLegacyMilestone(milestones, slug) {
+  return milestones.find((m) => m.title === slug) ?? null;
+}
+function factsFromLegacyMilestone(milestone) {
+  return {
+    goal: milestone.description ?? "",
+    lifecycle: milestone.state === "closed" ? "complete" : "active"
+  };
+}
+function lifecycleFromIssues(issues) {
+  if (issues.length === 0)
+    return "planned";
+  return issues.some((i) => i.state === "OPEN") ? "active" : "complete";
+}
+function goalFromMilestones(milestones, slug) {
+  for (const m of milestones) {
+    const goal = intentGoalForSlug(m.description ?? "", slug);
+    if (goal)
+      return goal;
+  }
+  return "";
+}
+function findMilestoneForSlug(owner, repo, slug) {
+  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
+  const legacy = matchesLegacyMilestone(milestones, slug);
+  if (legacy)
+    return factsFromLegacyMilestone(legacy);
+  const issues = ghIssueListByLabel(owner, repo, trancheLabel(slug));
+  return { goal: goalFromMilestones(milestones, slug), lifecycle: lifecycleFromIssues(issues) };
+}
+
 // ../../packages/aeg-forge-state/src/derive-from-forge.ts
 function trancheFromIssues(slug, issues, known) {
   return {