scrumrun 2.7.10 → 2.7.11

package/README.md

@@ -4,7 +4,7 @@
 
 ScrumRun gives an agent a small command surface and a precise project memory: what should be done, how each attempt happened, which decisions constrain the code, and why the architecture exists in its current form.
 
-**Package:** `2.7.10` · **Method target:** `2.0.0` · **Runtime:** Node.js `>=22.13.0` · **License:** MIT
+**Package:** `2.7.11` · **Method target:** `2.0.0` · **Runtime:** Node.js `>=22.13.0` · **License:** MIT
 
 **New here?** Read the [Quickstart](docs/QUICKSTART.md) — first Run in under 10 minutes, no `SPEC.md` reading required. Full docs map in [`docs/INDEX.md`](docs/INDEX.md).
 

package/lib/commands/repair.js

@@ -12,6 +12,8 @@
 //      complete→completed, in_progress→executing.
 //   3. frontmatter method field: any value that isn't "2.0.0" → "2.0.0".
 //   4. run.attempt missing → 1 (documented default).
+//   5. Sprint task projections: add Task.sprint references absent from the
+//      Sprint's `## Tasks` list. Extra entries remain for human review.
 //
 // Categories intentionally NOT touched (need human judgment):
 //   - Secret-like content (SECRET_CANONICAL)
@@ -132,6 +134,48 @@ function scanTaskIds(scrumDir) {
   return ids;
 }
 
+function planSprintMembership(scrumDir) {
+  const tasksBySprint = new Map();
+  for (const file of listDir(path.join(scrumDir, "tasks"), TASK_FILE)) {
+    const parsed = splitFrontmatter(readIf(file));
+    if (!parsed) continue;
+    const sprint = extractField(parsed.header, "sprint");
+    const id = extractField(parsed.header, "id") || path.basename(file, ".md");
+    if (!/^SPRINT-\d{3,}$/.test(sprint || "") || !TASK_REF.test(id)) continue;
+    if (!tasksBySprint.has(sprint)) tasksBySprint.set(sprint, []);
+    tasksBySprint.get(sprint).push(id);
+  }
+  const entries = [];
+  for (const file of listDir(path.join(scrumDir, "sprints"), SPRINT_FILE)) {
+    const original = readIf(file);
+    const parsed = splitFrontmatter(original);
+    if (!parsed) continue;
+    const sprintId = extractField(parsed.header, "id") || path.basename(file, ".md");
+    const expected = tasksBySprint.get(sprintId) || [];
+    if (!expected.length) continue;
+    const heading = /^## Tasks[ \t]*$/m.exec(parsed.body);
+    if (!heading) continue;
+    const tail = parsed.body.slice(heading.index + heading[0].length);
+    const nextHeading = /^## [^\r\n]+$/m.exec(tail);
+    const sectionEnd = nextHeading ? heading.index + heading[0].length + nextHeading.index : parsed.body.length;
+    const section = parsed.body.slice(heading.index + heading[0].length, sectionEnd);
+    const listed = new Set([...section.matchAll(/^-\s+(TASK-\d{3,})\s*$/gm)].map((match) => match[1]));
+    const missing = expected.filter((id) => !listed.has(id));
+    if (!missing.length) continue;
+    const before = parsed.body.slice(0, sectionEnd).replace(/\s*$/, "\n");
+    const after = parsed.body.slice(sectionEnd).replace(/^\n/, "");
+    const body = `${before}${missing.map((id) => `- ${id}`).join("\n")}\n${after}`;
+    entries.push({
+      file,
+      kind: "sprint-membership",
+      changes: [{ field: "sprint.tasks", from: "missing projection", to: missing.join(", ") }],
+      nextText: `---\n${parsed.header}\n---${parsed.sep}${body}`,
+      originalText: original
+    });
+  }
+  return entries;
+}
+
 function legacyMetadata(body) {
   const metadata = {};
   const section = String(body || "").match(/^## Metadata\s*$([\s\S]*?)(?=^##\s+|(?![\s\S]))/im);
@@ -629,6 +673,7 @@ function analyze(scrumDir) {
   const missingFrontmatter = new Set(entries.filter((entry) => entry.kind === "legacy-frontmatter").map((entry) => entry.file));
   entries.push(...planAcceptanceCriteria(scrumDir).filter((entry) => !missingFrontmatter.has(entry.file)));
   entries.push(...planSecretRedaction(scrumDir));
+  entries.push(...planSprintMembership(scrumDir));
 
   for (const file of listDir(path.join(scrumDir, "tasks"), TASK_FILE)) {
     const plan = planFile(file, "task", ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrumrun",
-  "version": "2.7.10",
+  "version": "2.7.11",
   "description": "Evidence-driven Agile runtime and semantic project memory for AI coding agents.",
   "bin": {
     "scrumrun": "bin/scrumrun.js",