@pmelab/gtd 17.2.0 → 17.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmelab/gtd",
-  "version": "17.2.0",
+  "version": "17.3.0",
   "private": false,
   "description": "Git-aware CLI that emits the next prompt for an autonomous coding agent based on the current repository state",
   "bin": {

package/src/workflows/prose.ts

@@ -180,13 +180,20 @@ export const questionBarReturn = `- This lap continues the same goal as the firs
   checkboxes
 - \`## Answered Questions\` is always the last \`##\` section — a moved
   question lands there, never wherever \`## Open Questions\` used to sit
-- Never re-raise a deleted question, and never re-open a settled
-  \`## Answered Questions\` entry
+- Never re-raise a deleted question. A settled \`## Answered Questions\`
+  entry stays settled, except one carrying a human footnote on its
+  \`### \` heading: that is the only entry that may change. Fold the note
+  in, then either rewrite the recorded answer in place (still under
+  \`## Answered Questions\`) or, when the note leaves the point genuinely
+  open, move it back to \`## Open Questions\` as a fresh fork with
+  options and the \`_your answer_\` slot. A note that only asks a
+  question follows the footnote rule: one \`- A:\` reply, answer unchanged
 - An answer may earn a follow-up: if it opens a genuinely new fork above
   the bar — one the answer itself created — raise it as a fresh \`##
   Open Questions\` entry on this same lap. Never restate a question
   already asked, and never treat this as licence to re-open a question
-  already settled under \`## Answered Questions\`
+  already settled under \`## Answered Questions\` that carries no
+  footnote on its heading
 - Recognise a silent lap from \`## Open Questions\` still present with
   nothing ticked and nothing else changed — the human's way of saying
   the gap is already closed. That lap ends the questions, whatever the

package/src/workflows/text.test.ts

@@ -103,6 +103,25 @@ describe("the shared open-question instruction", () => {
   })
 })
 
+describe("answered-entry footnote exception", () => {
+  const exception = "carrying a human footnote on its"
+  it("is in the design return lap and loop-back, keeping the deleted-question rule", () => {
+    const prompt = renderText(() => designTriagePrompt("base"))
+    expect(prompt).toContain("Never re-raise a deleted question")
+    expect(prompt).toContain(`entry stays settled, except one ${exception}`)
+    expect(prompt).toContain(`stays settled, except\n  one ${exception}`)
+    expect(prompt).not.toContain("never re-open a settled")
+    expect(prompt).not.toContain("never re-open one")
+  })
+
+  it("is in the architecture return lap and keeps the first-lap settled line", () => {
+    const prompt = renderText(() => architectureAuthorPrompt())
+    expect(prompt).toContain(`entry stays settled, except one ${exception}`)
+    expect(prompt).not.toContain("never re-open a settled")
+    expect(prompt).toMatch(/treat every decision[\s\S]*as settled — never re-open it/)
+  })
+})
+
 describe("architectureAuthorPrompt", () => {
   it("qualifies the PERMISSIVE default with a settled-requirements exception", () => {
     const prompt = renderText(() => architectureAuthorPrompt())

package/src/workflows/text.ts

@@ -191,8 +191,10 @@ ${questionBarReturn}
   \`git show ${base}\`. (On the first lap that hash
   is the process's own diff base, \`${start()}\` — this
   branch doesn't apply)
-- Every decision under \`## Answered Questions\` stays settled —
-  never re-open one. A genuinely open PRODUCT point may still
+- Every decision under \`## Answered Questions\` stays settled, except
+  one carrying a human footnote on its \`### \` heading — the human's
+  review-round edit is where such notes arrive; fold the note in and
+  rewrite the answer or move it back to \`## Open Questions\`. A genuinely open PRODUCT point may still
   raise a fresh \`## Open Questions\` entry: the product gate sits
   on this path exactly as on the first lap
 - Before grouping anything, run \`${env.testCommand}\`