@open-tomato/rafa 0.44.0 → 0.45.0

package/dist/{index-57mmzkcn.js → index-r28fzsvc.js}

@@ -5,16 +5,17 @@ import {
   messageOf,
   parseTaskDeclaration,
   readRafaBlocks
-} from "./index-cknayrpc.js";
+} from "./index-mgh2s9bj.js";
 // src/preflight/prerequisites-md.ts
 import { basename, dirname, join } from "path";
 var SECTION_AUTO_RE = /\[auto\]/i;
 var SECTION_START_RE = /\[start\]/i;
 var SECTION_HUMAN_RE = /\[human\]|manual|human|sign.?off|team/i;
+var TASKS_MARKER_RE = /\[tasks\]/i;
+var WRAP_UP_MARKER_RE = /\[wrap-up\]/i;
 var ITEM_RE = /^-\s+\[\s*\]\s+/;
-var INLINE_AUTO_RE = /^-\s+\[\s*\]\s+\[auto\]\s+/i;
-var INLINE_HUMAN_RE = /^-\s+\[\s*\]\s+\[human\]\s+/i;
-var INLINE_START_RE = /^-\s+\[\s*\]\s+\[start\]\s+/i;
+var SCOPE_MARKERS = String.raw`((?:\[(?:tasks|wrap-up)\]\s+)*)`;
+var ITEM_OPENING_RE = new RegExp(String.raw`^-\s+\[\s*\]\s+${SCOPE_MARKERS}(?:\[(auto|human|start)\]\s+)?${SCOPE_MARKERS}`, "i");
 var PROBE_RE = /:\s+`([^`]+)`\s*$/;
 var HEADING_MARKS_RE = /^#+/;
 var FENCE_RE = /^ {0,3}(`{3,}|~{3,})/;
@@ -29,18 +30,29 @@ function inferSectionTag(header) {
     return "human";
   return null;
 }
+function markedScope(text) {
+  const isForTasks = TASKS_MARKER_RE.test(text);
+  const isForWrapUp = WRAP_UP_MARKER_RE.test(text);
+  if (isForTasks && isForWrapUp)
+    return "both";
+  if (isForTasks)
+    return "tasks";
+  if (isForWrapUp)
+    return "wrap-up";
+  return null;
+}
 function enterHeading(scope, header) {
   const level = HEADING_MARKS_RE.exec(header)?.[0].length ?? 1;
   const above = Array.from({ length: level - 1 }, (_, index) => scope[index] ?? null);
-  return [...above, inferSectionTag(header)];
+  return [...above, { tag: inferSectionTag(header), scope: markedScope(header) }];
 }
-function sectionDefault(scope) {
+function sectionMark(scope, mark) {
   for (let index = scope.length - 1;index >= 0; index -= 1) {
-    const tag = scope[index];
-    if (tag)
-      return tag;
+    const named = scope[index]?.[mark];
+    if (named)
+      return named;
   }
-  return "human";
+  return null;
 }
 function fenceOf(line) {
   return FENCE_RE.exec(line)?.[1] ?? null;
@@ -61,17 +73,18 @@ function continuationOf(lines, start) {
   }
   return following;
 }
-function inlineTag(line) {
-  if (INLINE_AUTO_RE.test(line))
-    return "auto";
-  if (INLINE_START_RE.test(line))
-    return "start";
-  if (INLINE_HUMAN_RE.test(line))
-    return "human";
-  return null;
+function tagNamed(word) {
+  const tag = word?.toLowerCase();
+  return tag === "auto" || tag === "human" || tag === "start" ? tag : null;
 }
-function stripItemPrefix(line) {
-  return line.replace(INLINE_AUTO_RE, "").replace(INLINE_HUMAN_RE, "").replace(INLINE_START_RE, "").replace(ITEM_RE, "").trim();
+function readOpening(line) {
+  const opening = ITEM_OPENING_RE.exec(line);
+  const [matched = "", before = "", tag, after = ""] = opening ?? [];
+  return {
+    tag: tagNamed(tag),
+    scope: markedScope(`${before}${after}`),
+    rest: line.slice(matched.length).trim()
+  };
 }
 function isProbedTag(tag) {
   return tag === "auto" || tag === "start";
@@ -80,12 +93,14 @@ function extractProbe(description) {
   const probe = PROBE_RE.exec(description)?.[1]?.trim();
   return probe || null;
 }
-function readItem(lines, lineIndex, inherited) {
+function readItem(lines, lineIndex, headings) {
   const raw = lines[lineIndex] ?? "";
-  const tag = inlineTag(raw) ?? inherited;
-  const description = [stripItemPrefix(raw), ...continuationOf(lines, lineIndex + 1)].join(" ");
+  const opening = readOpening(raw);
+  const tag = opening.tag ?? sectionMark(headings, "tag") ?? "human";
+  const scope = opening.scope ?? sectionMark(headings, "scope") ?? "both";
+  const description = [opening.rest, ...continuationOf(lines, lineIndex + 1)].join(" ");
   const probe = isProbedTag(tag) ? extractProbe(description) : null;
-  return Object.freeze({ raw, description, tag, lineIndex, probe });
+  return Object.freeze({ raw, description, tag, scope, lineIndex, probe });
 }
 function parsePrerequisites(content) {
   const lines = content.split(`
@@ -110,7 +125,7 @@ function parsePrerequisites(content) {
       continue;
     }
     if (ITEM_RE.test(line))
-      items.push(readItem(lines, index, sectionDefault(scope)));
+      items.push(readItem(lines, index, scope));
   }
   return Object.freeze(items);
 }
@@ -118,7 +133,7 @@ function isProbed(item) {
   return isProbedTag(item.tag) && item.probe !== null;
 }
 function requiredItem(item) {
-  return Object.freeze({ kind: "tool", name: item.description, probe: item.probe });
+  return Object.freeze({ kind: "tool", name: item.description, probe: item.probe, scope: item.scope });
 }
 function requiredItemsTagged(items, tag) {
   const probed = items.filter(isProbed).filter((item) => item.tag === tag);
@@ -378,9 +393,10 @@ async function runPreflight(items, options) {
 // src/utils/tracker.ts
 import fs from "fs";
 var BLOCKER_OPEN = "<!-- blocked: ";
+var REPAIRS_OPEN = "<!-- repairs: ";
 var BLOCKER_CLOSE = " -->";
 var BLOCKER_GAP = "  ";
-var BLOCKER_COMMENT = /\s<!-- blocked: ((?:(?!<!--|-->).)*) -->$/;
+var TRAILING_COMMENT = /\s<!-- (blocked|repairs): ((?:(?!<!--|-->).)*) -->$/;
 var OPEN_TASK_PREFIX = /^- \[(?: |BLOCKED)\] /;
 var ESCAPE_SEQUENCE = /\\(u[0-9A-Fa-f]{4}|[\s\S])/g;
 var TAB = 9;
@@ -418,25 +434,44 @@ function unescapeBlockerText(escaped) {
 function blockerComment(blocker) {
   return `${BLOCKER_OPEN}${escapeBlockerText(blocker)}${BLOCKER_CLOSE}`;
 }
-function findBlockerComment(text) {
+function repairsComment(repaired) {
+  return `${REPAIRS_OPEN}${escapeBlockerText(repaired)}${BLOCKER_CLOSE}`;
+}
+function findTrailingComment(text) {
   const trimmed = text.trimEnd();
-  const match = BLOCKER_COMMENT.exec(trimmed);
-  const escaped = match?.[1];
-  if (match === null || escaped === undefined)
+  const match = TRAILING_COMMENT.exec(trimmed);
+  const kind = match?.[1];
+  const escaped = match?.[2];
+  if (match === null || escaped === undefined || kind !== "blocked" && kind !== "repairs")
     return null;
   const before = trimmed.slice(0, match.index).trimEnd();
-  return before.length === 0 ? null : { before, escaped };
-}
-function splitBlockerComment(taskText) {
-  const found = findBlockerComment(taskText);
-  if (found === null)
-    return { text: taskText, blocker: null };
-  const blocker = unescapeBlockerText(found.escaped);
+  return before.length === 0 ? null : { kind, before, escaped };
+}
+function splitTrailingComments(taskText) {
+  const last = findTrailingComment(taskText);
+  if (last === null)
+    return { text: taskText, blocked: null, repairs: null };
+  const earlier = findTrailingComment(last.before);
+  const found = earlier === null || earlier.kind === last.kind ? [last] : [last, earlier];
   return {
-    text: found.before,
-    blocker: blocker.trim().length === 0 ? null : blocker
+    text: found.at(-1)?.before ?? last.before,
+    blocked: found.find((comment) => comment.kind === "blocked")?.escaped ?? null,
+    repairs: found.find((comment) => comment.kind === "repairs")?.escaped ?? null
   };
 }
+function commentText(escaped) {
+  if (escaped === null)
+    return null;
+  const text = unescapeBlockerText(escaped);
+  return text.trim().length === 0 ? null : text;
+}
+function keptRepairs(escaped) {
+  return escaped === null ? "" : `${BLOCKER_GAP}${REPAIRS_OPEN}${escaped}${BLOCKER_CLOSE}`;
+}
+function splitBlockerComment(taskText) {
+  const { text, blocked } = splitTrailingComments(taskText);
+  return { text, blocker: commentText(blocked) };
+}
 function splitCarriageReturn(line) {
   return line.endsWith("\r") ? { body: line.slice(0, -1), cr: "\r" } : { body: line, cr: "" };
 }
@@ -445,8 +480,8 @@ function withoutBlockerComment(line) {
   const prefix = OPEN_TASK_PREFIX.exec(body)?.[0];
   if (prefix === undefined)
     return line;
-  const found = findBlockerComment(body.slice(prefix.length));
-  return found === null ? line : `${prefix}${found.before}${cr}`;
+  const found = splitTrailingComments(body.slice(prefix.length));
+  return found.blocked === null ? line : `${prefix}${found.text}${keptRepairs(found.repairs)}${cr}`;
 }
 function closedBlockLines(trackerContent) {
   const inside = new Set;
@@ -460,8 +495,16 @@ function closedBlockLines(trackerContent) {
   return inside;
 }
 function taskInfoOf(capture, lineNum, status) {
-  const { text, blocker } = splitBlockerComment(capture.trim());
-  return blocker === null ? { task: text, lineNum, status } : { task: text, lineNum, status, blocker };
+  const found = splitTrailingComments(capture.trim());
+  const blocker = commentText(found.blocked);
+  const repairs = commentText(found.repairs);
+  return {
+    task: found.text,
+    lineNum,
+    status,
+    ...blocker === null ? {} : { blocker },
+    ...repairs === null ? {} : { repairs }
+  };
 }
 var TASK_LINE_STATUSES = [
   [/^- \[BLOCKED\] (.+)/, "blocked"],
@@ -522,12 +565,12 @@ function writeTrackerBlocker(trackerPath, lineNum, blocker) {
   const prefix = OPEN_TASK_PREFIX.exec(body)?.[0];
   if (prefix === undefined)
     return false;
-  const rest = body.slice(prefix.length);
-  const text = (findBlockerComment(rest)?.before ?? rest).trimEnd();
+  const found = splitTrailingComments(body.slice(prefix.length));
+  const text = found.text.trimEnd();
   if (text.trim().length === 0)
     return false;
   const comment = blocker.trim().length === 0 ? "" : `${BLOCKER_GAP}${blockerComment(blocker)}`;
-  lines[lineNum] = `- [BLOCKED] ${text}${comment}${cr}`;
+  lines[lineNum] = `- [BLOCKED] ${text}${keptRepairs(found.repairs)}${comment}${cr}`;
   fs.writeFileSync(trackerPath, lines.join(`
 `), "utf8");
   return true;
@@ -564,7 +607,9 @@ function insertTrackerTask(trackerPath, entry, beforeLine) {
   }
   const at = beforeLine ?? endOfChecklist(lines, inBlock);
   const { cr } = splitCarriageReturn(lines[0] ?? "");
-  const line = `- [BLOCKED] ${entry.task.trim()}${BLOCKER_GAP}{${entry.declaration.trim()}}` + `${BLOCKER_GAP}${blockerComment(entry.blocker)}${cr}`;
+  const repaired = entry.repairs ?? "";
+  const repairs = repaired.trim().length === 0 ? "" : `${BLOCKER_GAP}${repairsComment(repaired)}`;
+  const line = `- [BLOCKED] ${entry.task.trim()}${BLOCKER_GAP}{${entry.declaration.trim()}}` + `${repairs}${BLOCKER_GAP}${blockerComment(entry.blocker)}${cr}`;
   const written = [...lines.slice(0, at), line, ...lines.slice(at)];
   fs.writeFileSync(trackerPath, written.join(`
 `), "utf8");
@@ -574,7 +619,7 @@ function trackerPathFor(planPath) {
   return planPath.replace(/PLAN(-[^/]*)?\.md$/, (_m, stub) => `PLAN_TRACKER${stub ?? ""}.md`);
 }
 
-// src/plan/parse.ts
+// src/core/plan/parse.ts
 var PLAN_BLOCK_KINDS = ["plan", "context", "stage-context"];
 var PLAN_HEADER_FIELDS = ["stub", "issue", "spec", "release"];
 var PLAN_RELEASE_LEVELS = ["patch", "minor", "major", "none"];
@@ -818,7 +863,38 @@ function parsePlan(markdown) {
     issues
   };
 }
-
+// src/core/plan/plan-files.ts
+import { statSync } from "fs";
+import { basename as basename2, dirname as dirname2, join as join2, resolve } from "path";
+function plansDirAt(root, planDir) {
+  return { label: planDir, path: resolve(root, planDir) };
+}
+function countTasks(tasks) {
+  const done = tasks.filter((task) => task.status === "done").length;
+  const blocked = tasks.filter((task) => task.status === "blocked").length;
+  return { total: tasks.length, done, blocked, open: tasks.length - done - blocked };
+}
+function planFileName(stub, tracker) {
+  return tracker ? `PLAN_TRACKER-${stub}.md` : `PLAN-${stub}.md`;
+}
+function stubOfPlanFile(name) {
+  const stub = /^PLAN-(.+)\.md$/.exec(name)?.[1];
+  return stub !== undefined && isStampableStub(stub) ? stub : null;
+}
+function isFile(path) {
+  return statSync(path, { throwIfNoEntry: false })?.isFile() ?? false;
+}
+var REJECTED_DIR = "rejected";
+function rejectedPath(path) {
+  const parent = dirname2(path);
+  return parent === "." ? join2(REJECTED_DIR, basename2(path)) : join2(parent, REJECTED_DIR, basename2(path));
+}
+function issueLine(file, issue) {
+  return `${file}:${issue.line}: ${issue.reason}: ${issue.text}`;
+}
+function plural(count, noun) {
+  return count === 1 ? `${count} ${noun}` : `${count} ${noun}s`;
+}
 // src/plan/inject.ts
 var PLAN_CONTEXT_HEADING = "## Plan context";
 var STAGE_HEADING_PREFIX = "## Stage: ";
@@ -830,19 +906,49 @@ var CHECKBOXES = {
   blocked: "- [BLOCKED]",
   done: "- [x]"
 };
-function fallbackFor(reason, lineNum) {
-  const line = lineNum + 1;
-  const found = reason === "no-task-at-line" ? "no task the plan model reads" : "a different task than the one dispatched";
-  const text = `line ${line} of the plan holds ${found}, so the whole plan is handed over; ` + "the plan may have changed since its tracker was copied, or the line sits inside a rafa:* block";
-  return { found: false, fallback: { reason, line, text } };
-}
-function locate(model, wanted) {
-  const task = model.tasks.find((candidate) => candidate.lineNum === wanted.lineNum);
-  if (task === undefined)
-    return fallbackFor("no-task-at-line", wanted.lineNum);
-  if (task.task !== wanted.task)
-    return fallbackFor("task-text-differs", wanted.lineNum);
-  return { found: true, task };
+var HANDED_OVER = ", so the whole plan is handed over";
+function placeOf(position) {
+  return position !== undefined && Number.isInteger(position) && position >= 0 ? position : null;
+}
+var DISPATCHED_TEXT = "the dispatched text";
+var REPAIRED_TEXT = "the text the dispatched repair names";
+function noTaskWithText(place) {
+  const beyond = place === null ? "" : ` and no task number ${place + 1}`;
+  const text = `the plan holds no task with ${DISPATCHED_TEXT}${beyond}${HANDED_OVER}; ` + "the plan may have changed since its tracker was copied, or the task line sits inside a rafa:* block";
+  return { found: false, fallback: { reason: "no-task-with-text", text } };
+}
+function severalTasksWithText(count, place, sought) {
+  const which = place === null ? "the dispatch gives no position among its tasks" : `task number ${place + 1} is none of them`;
+  const text = `the plan holds ${count} tasks with ${sought} and ${which}${HANDED_OVER}`;
+  return { found: false, fallback: { reason: "several-tasks-with-text", text } };
+}
+function noRepairedTask() {
+  const text = `the plan holds no task with ${REPAIRED_TEXT}${HANDED_OVER}; ` + "the plan may have changed since the repair was written";
+  return { found: false, fallback: { reason: "no-task-with-text", text } };
+}
+function locate(model, wanted, position) {
+  const place = placeOf(position);
+  const atPlace = place === null ? undefined : model.tasks[place];
+  const holders = model.tasks.filter((candidate) => candidate.task === wanted.task);
+  const [first] = holders;
+  if (first === undefined) {
+    return atPlace === undefined ? noTaskWithText(place) : { found: true, task: atPlace };
+  }
+  if (holders.length === 1)
+    return { found: true, task: first };
+  return atPlace !== undefined && holders.includes(atPlace) ? { found: true, task: atPlace } : severalTasksWithText(holders.length, place, DISPATCHED_TEXT);
+}
+function locateRepaired(model, named, position) {
+  const sentence = named.trim();
+  const holders = model.tasks.filter((candidate) => candidate.text.trim() === sentence);
+  const [first] = holders;
+  if (first === undefined)
+    return noRepairedTask();
+  if (holders.length === 1)
+    return { found: true, task: first };
+  const place = placeOf(position);
+  const atPlace = place === null ? undefined : model.tasks[place];
+  return atPlace !== undefined && holders.includes(atPlace) ? { found: true, task: atPlace } : severalTasksWithText(holders.length, place, REPAIRED_TEXT);
 }
 function contextBody(body) {
   if (body === null || body.trim().length === 0)
@@ -862,15 +968,22 @@ function renderDocument(sections) {
 `;
 }
 function shownStatus(task, dispatched) {
-  if (task.lineNum < dispatched.lineNum)
+  if (task.lineNum < dispatched.task.lineNum)
     return "done";
-  if (task.lineNum === dispatched.lineNum)
-    return "unchecked";
-  return task.status;
+  if (task.lineNum > dispatched.task.lineNum)
+    return task.status;
+  return dispatched.repair === null ? "unchecked" : "done";
 }
 function taskLine(status, task) {
   return `${CHECKBOXES[status]} ${task.text}`;
 }
+function openLine(dispatched) {
+  return taskLine("unchecked", { text: dispatched.repair ?? dispatched.task.text });
+}
+function checklistLines(task, dispatched) {
+  const line = taskLine(shownStatus(task, dispatched), task);
+  return task === dispatched.task && dispatched.repair !== null ? [line, openLine(dispatched)] : [line];
+}
 function planContextSection(model) {
   const body = contextBody(model.context);
   return body === null ? null : section(PLAN_CONTEXT_HEADING, body);
@@ -894,17 +1007,17 @@ function stageListSection(model, dispatched) {
 `));
 }
 function renderStage(model, dispatched) {
-  const checklist = model.tasks.filter((task) => task.stage === dispatched.stage).map((task) => taskLine(shownStatus(task, dispatched), task));
+  const checklist = model.tasks.filter((task) => task.stage === dispatched.task.stage).flatMap((task) => checklistLines(task, dispatched));
   return renderDocument([
     planContextSection(model),
-    stageSection(model, dispatched, checklist),
-    stageListSection(model, dispatched)
+    stageSection(model, dispatched.task, checklist),
+    stageListSection(model, dispatched.task)
   ]);
 }
 function renderTask(model, dispatched) {
   return renderDocument([
     planContextSection(model),
-    stageSection(model, dispatched, [taskLine("unchecked", dispatched)])
+    stageSection(model, dispatched.task, [openLine(dispatched)])
   ]);
 }
 var RENDERERS = {
@@ -912,14 +1025,15 @@ var RENDERERS = {
   task: renderTask
 };
 function renderInjection(request) {
-  const { mode, plan, task } = request;
-  if (mode === "full")
-    return { requested: mode, mode, text: plan, fallback: null };
+  const { mode, plan, task, position, repairs } = request;
+  if (mode === "full" || repairs === null)
+    return { requested: mode, mode: "full", text: plan, fallback: null };
   const model = parsePlan(plan);
-  const location = locate(model, task);
+  const location = repairs === undefined ? locate(model, task, position) : locateRepaired(model, repairs, position);
   if (!location.found) {
     return { requested: mode, mode: "full", text: plan, fallback: location.fallback };
   }
-  return { requested: mode, mode, text: RENDERERS[mode](model, location.task), fallback: null };
+  const repair = repairs === undefined ? null : parseTaskDeclaration(task.task).text.trim();
+  return { requested: mode, mode, text: RENDERERS[mode](model, { task: location.task, repair }), fallback: null };
 }
-export { escapeBlockerText, splitBlockerComment, findNextTask, listTrackerTasks, listOpenTasks, updateTrackerLine, writeTrackerBlocker, insertTrackerTask, trackerPathFor, PLAN_BLOCK_KINDS, PLAN_HEADER_FIELDS, PLAN_RELEASE_LEVELS, parsePlan, parsePrerequisites, planPrerequisites, malformedPrerequisiteLines, mergePlanPrerequisites, prerequisitesPathForPlan, loadPlanPrerequisites, PROBE_TIMEOUT_MS, runShellProbe, runPreflight, renderInjection };
+export { escapeBlockerText, splitBlockerComment, findNextTask, listTrackerTasks, listOpenTasks, updateTrackerLine, writeTrackerBlocker, insertTrackerTask, trackerPathFor, PLAN_BLOCK_KINDS, PLAN_HEADER_FIELDS, PLAN_RELEASE_LEVELS, parsePlan, plansDirAt, countTasks, planFileName, stubOfPlanFile, isFile, rejectedPath, issueLine, plural, parsePrerequisites, planPrerequisites, malformedPrerequisiteLines, mergePlanPrerequisites, prerequisitesPathForPlan, loadPlanPrerequisites, PROBE_TIMEOUT_MS, runShellProbe, runPreflight, renderInjection };