@event4u/agent-config 16.2.0 → 16.4.0

package/dist/cli-delegate/chunk-7IQE3D5S.js

@@ -0,0 +1,191 @@
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+
+// src/agent-src/scripts/deferral_carry.ts
+import * as fs from "node:fs";
+import * as path from "node:path";
+var DEFERRED_RESOLUTION_RE = /<!--\s*deferred-resolution:\s*(carried-to|merged-into)\s*=\s*([A-Za-z0-9._-]+)\s*-->/;
+var DEFERRED_STEP_RE = /^[ \t]*[-*][ \t]+\[~\][ \t]*(.*)$/;
+var BLOCK_END_RE = /^[ \t]*[-*][ \t]+\[[ xX~-]\]|^#{1,6}[ \t]/;
+var BLOCKED_BY_RE = /blocked-by:\s*([A-Za-z0-9._-]+)/g;
+var BLOCKER_HEAD_RE = /^###[ \t]+blocker:[ \t]*(.+?)[ \t]*$/i;
+var STATUS_LINE_RE = /^([ \t]*-[ \t]+\*\*Status:\*\*[ \t]*)(.*)$/;
+var AC_HEADING_RE = /^##[ \t]+acceptance/i;
+var OWNER_LINE_RE = /^[ \t]*-[ \t]+\*\*Owner:\*\*[ \t]*`?([A-Za-z]+)/;
+var AGENT_SIDE_OWNERS = /* @__PURE__ */ new Set(["implementer", "council", "agent", "ai"]);
+var LIGHTWEIGHT_LINE_BUDGET = 500;
+var DISPOSITION_DIRS = ["", "later", "archive", "skipped"];
+function _bareSteps(lines) {
+  const out = [];
+  let inAcceptance = false;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (/^##[ \t]/.test(line)) inAcceptance = AC_HEADING_RE.test(line);
+    const m = DEFERRED_STEP_RE.exec(line);
+    if (m === null) continue;
+    let end = i + 1;
+    while (end < lines.length && !BLOCK_END_RE.test(lines[end])) end++;
+    const raw = lines.slice(i, end);
+    if (DEFERRED_RESOLUTION_RE.test(raw.join("\n"))) continue;
+    while (raw.length > 1 && raw[raw.length - 1].trim() === "") raw.pop();
+    const indent = /^[ \t]*/.exec(line)[0].length;
+    const block = raw.map((l) => l.slice(0, indent).trim() === "" ? l.slice(indent) : l);
+    const ids = /* @__PURE__ */ new Set();
+    for (const b of raw) for (const hit of b.matchAll(BLOCKED_BY_RE)) ids.add(hit[1]);
+    out.push({ line: i, block, isAcceptance: inAcceptance, blockerIds: [...ids] });
+  }
+  return out;
+}
+function _blockerSpans(lines) {
+  const start = lines.findIndex((l) => /^##[ \t]+Blockers[ \t]*$/i.test(l));
+  if (start === -1) return [];
+  let sectionEnd = lines.length;
+  for (let i = start + 1; i < lines.length; i++) {
+    if (/^##[ \t]+\S/.test(lines[i])) {
+      sectionEnd = i;
+      break;
+    }
+  }
+  const spans = [];
+  for (let i = start + 1; i < sectionEnd; i++) {
+    const m = BLOCKER_HEAD_RE.exec(lines[i]);
+    if (m === null) continue;
+    let end = i + 1;
+    while (end < sectionEnd && !/^###?[ \t]/.test(lines[end])) end++;
+    const status = lines.slice(i, end).map((l) => STATUS_LINE_RE.exec(l)).find((s) => s !== null);
+    const value = (status?.[2] ?? "open").trim().toLowerCase();
+    const owner = lines.slice(i, end).map((l) => OWNER_LINE_RE.exec(l)).find((o) => o !== null);
+    spans.push({
+      id: m[1].trim(),
+      start: i,
+      end,
+      open: !/^resolved\b/.test(value),
+      ownerDependent: !AGENT_SIDE_OWNERS.has((owner?.[1] ?? "").toLowerCase())
+    });
+  }
+  return spans;
+}
+function _plusDays(date, days) {
+  const d = /* @__PURE__ */ new Date(`${date}T00:00:00Z`);
+  d.setUTCDate(d.getUTCDate() + days);
+  return d.toISOString().slice(0, 10);
+}
+function nextCarrySlug(root, sourceSlug) {
+  const base = sourceSlug.replace(/-carried(-\d+)?$/, "");
+  for (let n = 1; ; n++) {
+    const slug = n === 1 ? `${base}-carried` : `${base}-carried-${n}`;
+    const taken = DISPOSITION_DIRS.some(
+      (d) => fs.existsSync(path.join(root, "agents", "roadmaps", d, `${slug}.md`))
+    );
+    if (!taken) return slug;
+  }
+}
+function _title(sourceText, sourceSlug) {
+  const h1 = /^#[ \t]+(.+?)[ \t]*$/m.exec(sourceText.replace(/^---\n[\s\S]*?\n---\n/, ""));
+  return h1 !== null ? h1[1] : sourceSlug.replace(/-/g, " ");
+}
+function planCarry(root, rel, text, openBlockerIds, date, ownerDecision = "ask") {
+  const sourceSlug = rel.replace(/\.md$/, "");
+  const lines = text.split("\n");
+  const steps = _bareSteps(lines);
+  if (steps.length === 0) return { refused: "no bare `[~]` step to carry" };
+  const named = new Set(steps.flatMap((s) => s.blockerIds));
+  const stranded = openBlockerIds.filter((id) => !named.has(id));
+  if (stranded.length > 0) {
+    return {
+      refused: `open blocker(s) no deferred step names (${stranded.join(", ")}) \u2014 carrying around them would not let this roadmap archive`
+    };
+  }
+  const moved = _blockerSpans(lines).filter((b) => b.open && named.has(b.id));
+  const ownerBlockers = moved.filter((b) => b.ownerDependent).map((b) => b.id);
+  const parked = ownerBlockers.length > 0 && ownerDecision === "later";
+  const destSlug = nextCarrySlug(root, sourceSlug);
+  const annotation = `<!-- deferred-resolution: carried-to=${destSlug} -->`;
+  const out = [...lines];
+  for (const b of moved) {
+    for (let i = b.start; i < b.end; i++) {
+      const s = STATUS_LINE_RE.exec(out[i]);
+      if (s === null) continue;
+      out[i] = `${s[1]}resolved \u2014 carried, still open, to \`${destSlug}\` with the steps it blocks (was: ${s[2].trim()})`;
+      break;
+    }
+  }
+  for (const s of steps) out[s.line] = `${out[s.line]} ${annotation}`;
+  const toOpen = (block) => block.map((l, i) => i === 0 ? l.replace(/\[~\]/, "[ ]") : l).join("\n");
+  const phaseSteps = steps.filter((s) => !s.isAcceptance).map((s) => toOpen(s.block));
+  const acSteps = steps.filter((s) => s.isAcceptance).map((s) => toOpen(s.block));
+  const phaseName = `Deferred steps carried from ${sourceSlug}`;
+  const blockerText = moved.map((b) => lines.slice(b.start, b.end).join("\n").trimEnd());
+  const body = [
+    `# ${_title(text, sourceSlug)} \u2014 carried`,
+    "",
+    `> **Source:** carried by the archival sweep on ${date} from`,
+    `> [\`${sourceSlug}\`](${parked ? "../" : ""}archive/${sourceSlug}.md), which closed every other step.`,
+    "> Each step below was `[~]` there and is restated verbatim as open work, so",
+    "> archiving the parent buried nothing. Blockers the steps name moved with them.",
+    "",
+    "## Goal",
+    "",
+    `Every step ${sourceSlug} deferred is either done here or explicitly disposed`,
+    "of \u2014 a step that still cannot run is re-deferred with its reason, never",
+    "left to read as finished.",
+    "",
+    `## Phase 1 \u2014 ${phaseName}`,
+    "",
+    phaseSteps.length > 0 ? phaseSteps.join("\n") : "- [ ] **1.1 Close the carried acceptance criteria below.** The parent deferred\n      only acceptance criteria; this step is done when each is checked or disposed of.\n      verify: every criterion under `## Acceptance Criteria` is `[x]` or `[-]`",
+    "",
+    ...blockerText.length > 0 ? ["## Blockers", "", blockerText.join("\n\n"), ""] : [],
+    "## Risk Register",
+    `<!-- risk-review: v1 | reviewed: ${date} | reviewer: archive-sweep/auto-carry -->`,
+    "",
+    "| Rank | Item | Risk type | Description | Mitigation | Anchored under |",
+    "|------|------|-----------|-------------|------------|----------------|",
+    `| 1 | Carried steps stay blocked indefinitely | implementation | A step deferred once for elapsed time or a decision can sit here as long as it sat in the parent | It now counts as open work in the dashboard instead of as 100 %, and its blocker is listed where the estate gates count it | Phase 1 \u2014 ${phaseName} |`,
+    "",
+    "## Acceptance Criteria",
+    "",
+    acSteps.length > 0 ? acSteps.join("\n") : `- [ ] AC-1 \u2014 No step carried from \`${sourceSlug}\` is still \`[ ]\` without a recorded disposition.`,
+    ""
+  ].join("\n");
+  const complexity = body.split("\n").length > LIGHTWEIGHT_LINE_BUDGET ? "structural" : "lightweight";
+  const ids = ownerBlockers.join(", ");
+  const parkedKeys = parked ? `entry_condition:
+  what: the owner resolves blocker(s) ${ids}
+  when: whenever the owner takes the next step
+  who: owner
+review_by: ${_plusDays(date, 90)}
+estate_growth_exempt: >-
+  Owner-chosen archive of ${sourceSlug}: its deferred steps wait on owner
+  blocker(s) ${ids} and are parked here instead of left active. The parent
+  is archived in the same change, so the active count drops by one.
+` : "";
+  const destText = `---
+complexity: ${complexity}
+status: ${parked ? "later" : "ready"}
+execution:
+  mode: phase-checkpoints
+parent_roadmap: ${sourceSlug}
+${parkedKeys}---
+${body}`;
+  const destRel = parked ? `agents/roadmaps/later/${destSlug}.md` : `agents/roadmaps/${destSlug}.md`;
+  return {
+    plan: {
+      destSlug,
+      destRel,
+      destText,
+      sourceText: out.join("\n"),
+      carried: steps.length,
+      movedBlockers: moved.map((b) => b.id),
+      ownerBlockers,
+      firstStep: steps[0].block.join("\n"),
+      parked
+    }
+  };
+}
+
+export {
+  DEFERRED_RESOLUTION_RE,
+  DEFERRED_STEP_RE,
+  BLOCK_END_RE,
+  nextCarrySlug,
+  planCarry
+};