@pmelab/gtd 59.0.1 → 60.0.0

package/dist/web/main.js

@@ -30764,6 +30764,238 @@ const blockRunInline = (content, nodes, options) => {
 	return joinInlineRuns(visibleNodes(content, nodes, options).map((node) => nodeInline(content, node, options)));
 };
 //#endregion
+//#region src/steering/findings.ts
+/** The `# ` heading the findings a judge called noise sit under. */
+const NOISE_HEADING = "Dropped as noise";
+const OPEN_GROUP = "Open";
+const MARKER = /\[\^[^\]\s]+\]/g;
+const isBox = (item, content) => {
+	if (typeof item.checked !== "boolean") return false;
+	const first = item.children[0];
+	if (first?.type !== "paragraph" || first.position === void 0) return false;
+	const text = content.slice(first.position.start.offset, first.position.end.offset);
+	return new RegExp(`^fix(?![\\w-])`).test(text);
+};
+const slice = (content, node) => content.slice(node.position.start.offset, node.position.end.offset);
+const lineOf = (node, end = false) => toLspPosition(end ? node.position.end : node.position.start).line;
+/** The box item's own text past its label: a formatter may fold a guidance line into it. */
+const inlineGuidance = (content, item) => {
+	const first = item.children[0];
+	return content.slice(first.position.start.offset, item.position.end.offset).slice(3).replace(/^[\s:—–-]+/, "").trim();
+};
+const guidanceOf = (parts) => parts.map((p) => p.replace(MARKER, "").trim()).filter((p) => p !== "").join("\n\n");
+/** `nodes` split at `box`: the body before it, the guidance after it. */
+const splitAtBox = (content, nodes, box) => {
+	const at = nodes.findIndex((n) => n.type === "list" && n.children.includes(box));
+	const list = nodes[at];
+	const boxAt = list.children.indexOf(box);
+	const bodyNodes = nodes.slice(0, boxAt > 0 ? at + 1 : at);
+	const trailing = list.children.slice(boxAt + 1);
+	const after = nodes.slice(at + 1);
+	return {
+		bodyNodes,
+		body: bodyNodes.map((n) => n === list ? content.slice(n.position.start.offset, box.position.start.offset).trimEnd() : slice(content, n)).join("\n\n"),
+		notBody: list.children.slice(boxAt),
+		guidance: guidanceOf([inlineGuidance(content, box), ...[...trailing, ...after].map((n) => slice(content, n))]),
+		last: after.at(-1) ?? trailing.at(-1) ?? box
+	};
+};
+const entryOf = (content, title, noise, headingLine, nodes, endLine) => {
+	const notes = nodes.filter((n) => n.type !== "footnoteDefinition");
+	const boxes = notes.flatMap((n) => n.type === "list" ? n.children.filter((i) => isBox(i, content)) : []);
+	const box = boxes[0];
+	const split = box === void 0 ? {
+		bodyNodes: notes,
+		body: notes.map((n) => slice(content, n)).join("\n\n"),
+		notBody: [],
+		guidance: ""
+	} : splitAtBox(content, notes, box);
+	return {
+		title,
+		body: split.body,
+		noise,
+		fix: box?.checked === true,
+		guidance: split.guidance,
+		boxes: boxes.length,
+		headingLine,
+		bodyNodes: split.bodyNodes,
+		...box === void 0 ? {} : { box },
+		notBody: new Set(split.notBody),
+		lastLine: split.last === void 0 ? headingLine : lineOf(split.last, true),
+		endLine
+	};
+};
+const parse = (content) => {
+	const tree = parseMarkdown(content);
+	const entries = [];
+	let noise = false;
+	let open;
+	const close = (endLine) => {
+		if (open !== void 0) entries.push(entryOf(content, open.title, noise, open.line, open.nodes, endLine));
+		open = void 0;
+	};
+	for (const node of tree.children) {
+		if (node.type === "heading" && node.depth <= 2) {
+			close(lineOf(node) - 1);
+			const text = headingText$1(content, node, (t) => t.replace(MARKER, ""));
+			if (node.depth === 1) noise = text === NOISE_HEADING;
+			else open = {
+				title: text,
+				line: lineOf(node),
+				nodes: []
+			};
+			continue;
+		}
+		open?.nodes.push(node);
+	}
+	close(content.split(/\r?\n/).length - 1);
+	return entries;
+};
+const entryFindings = (content) => parse(content).flatMap((e) => {
+	if (e.boxes === 0) return [{
+		message: `"${e.title}" has no \`- [ ] fix\` box — restore it, ticked to fix the finding or unticked to drop it`,
+		line: e.headingLine
+	}];
+	if (e.boxes > 1) return [{
+		message: `"${e.title}" has ${e.boxes} \`fix\` boxes — keep exactly one`,
+		line: e.headingLine
+	}];
+	if (!e.fix && e.guidance !== "") return [{
+		message: `"${e.title}" has guidance under an unticked box — tick it to fix the finding, or delete the text to drop it`,
+		line: lineOf(e.box)
+	}];
+	return [];
+});
+const findingsView = (content) => {
+	const noteAt = noteLookup(content);
+	return { nodes: parse(content).map((e, index) => {
+		const note = noteAt(e.headingLine);
+		return {
+			title: e.title,
+			anchor: {
+				kind: "chunk",
+				index
+			},
+			group: e.noise ? NOISE_HEADING : OPEN_GROUP,
+			...e.boxes === 1 ? { checked: e.fix } : {},
+			...e.guidance === "" ? {} : { note: e.guidance },
+			...note?.thread !== void 0 ? { thread: note.thread } : {},
+			body: blockNodesOfRun(content, e.bodyNodes, { skipListItem: (i) => e.notBody.has(i) })
+		};
+	}) };
+};
+const findingsOutline = (content) => {
+	const lines = content.split(/\r?\n/);
+	return [...parse(content).map((e) => ({
+		name: e.title,
+		detail: e.noise ? "noise" : e.fix ? "fix" : "drop",
+		range: spanRange(lines, e.headingLine, Math.max(e.headingLine, e.endLine)),
+		selectionRange: lineRange(lines, e.headingLine)
+	})), ...threadOutlineNodes(content).map((t) => t.node)];
+};
+const findingsAnnotate = (content, anchor, text) => {
+	const entries = parse(content);
+	const lines = content.split(/\r?\n/);
+	const resolved = (() => {
+		if (anchor.kind === "chunk") {
+			const e = entries[anchor.index];
+			return e && {
+				line: e.headingLine,
+				blockEndLine: e.headingLine,
+				key: `chunk:${anchor.index}`
+			};
+		}
+		if (anchor.kind !== "paragraph") return void 0;
+		const block = entries.flatMap((e) => e.bodyNodes).find((n) => anchor.line >= lineOf(n) && anchor.line <= lineOf(n, true));
+		return block && {
+			line: anchor.line,
+			blockEndLine: lineOf(block, true),
+			key: `paragraph:${anchor.line}`
+		};
+	})();
+	if (resolved === void 0) return {
+		ok: false,
+		reason: "anchor-not-found"
+	};
+	const result = footnoteAttachEdits(content, {
+		...resolved,
+		endCharacter: (lines[resolved.line] ?? "").length
+	}, text);
+	return result.ok ? {
+		ok: true,
+		edits: result.edits
+	} : result;
+};
+/** Ticks or unticks a finding's box; `text` replaces its guidance, and unticking drops it. */
+const findingsApply = (content, anchor, opts) => {
+	if (anchor.kind !== "chunk") return {
+		ok: false,
+		reason: "anchor-not-found"
+	};
+	const e = parse(content)[anchor.index];
+	if (e?.box === void 0 || e.boxes !== 1) return {
+		ok: false,
+		reason: "anchor-not-found"
+	};
+	const fix = opts.checked ?? e.fix;
+	const guidance = fix ? (opts.text ?? e.guidance).trim() : "";
+	if (fix === e.fix && guidance === e.guidance) return {
+		ok: true,
+		edits: []
+	};
+	const lines = content.split(/\r?\n/);
+	const eol = eolOf(content);
+	const start = lineOf(e.box);
+	const box = `${lines[start].match(/^\s*[-*+]\s+/)[0]}[${fix ? "x" : " "}] fix`;
+	const text = guidance === "" ? box : `${box}${eol}${eol}${guidance.split(/\r?\n/).join(eol)}`;
+	return {
+		ok: true,
+		edits: [{
+			range: {
+				start: {
+					line: start,
+					character: 0
+				},
+				end: lineRange(lines, e.lastLine).end
+			},
+			newText: text
+		}]
+	};
+};
+/** The finding gate's file: one `## ` finding each, with one `fix` box and optional guidance below it. */
+const findingsDescriptor = {
+	sample: `# Quality
+
+## A finding a lens wrote[^nafind1]
+
+[^nafind1]:
+    Attached via the phone UI, this note shows a comment on a finding with a
+    \`multi word code span\` that runs past eighty characters in total length.
+
+What the lens found, and where.
+
+- [x] fix
+
+Fix it the simple way.
+
+# Dropped as noise
+
+## A finding the judge called noise
+
+Why the judge dropped it.
+
+- [ ] fix
+`,
+	validate: (content) => [...entryFindings(content), ...threadFindings(content)],
+	outline: findingsOutline,
+	actions: (content, range) => threadReplyActions(content, range.start),
+	view: findingsView,
+	annotate: findingsAnnotate,
+	apply: findingsApply,
+	clearTicks: (content) => content,
+	openThreads: openThreadsOf
+};
+//#endregion
 //#region src/steering/qa.ts
 /**
 * A marker as plain text. Local to this module because `headingText`/
@@ -32566,242 +32798,12 @@ const decisionOf$1 = (chunk) => {
 	};
 };
 //#endregion
-//#region src/steering/findings.ts
-/** The `# ` heading the findings a judge called noise sit under. */
-const NOISE_HEADING = "Dropped as noise";
-const OPEN_GROUP = "Open";
-const MARKER = /\[\^[^\]\s]+\]/g;
-const isBox = (item, content) => {
-	if (typeof item.checked !== "boolean") return false;
-	const first = item.children[0];
-	if (first?.type !== "paragraph" || first.position === void 0) return false;
-	const text = content.slice(first.position.start.offset, first.position.end.offset);
-	return new RegExp(`^fix(?![\\w-])`).test(text);
-};
-const slice = (content, node) => content.slice(node.position.start.offset, node.position.end.offset);
-const lineOf = (node, end = false) => toLspPosition(end ? node.position.end : node.position.start).line;
-/** The box item's own text past its label: a formatter may fold a guidance line into it. */
-const inlineGuidance = (content, item) => {
-	const first = item.children[0];
-	return content.slice(first.position.start.offset, item.position.end.offset).slice(3).replace(/^[\s:—–-]+/, "").trim();
-};
-const guidanceOf = (parts) => parts.map((p) => p.replace(MARKER, "").trim()).filter((p) => p !== "").join("\n\n");
-/** `nodes` split at `box`: the body before it, the guidance after it. */
-const splitAtBox = (content, nodes, box) => {
-	const at = nodes.findIndex((n) => n.type === "list" && n.children.includes(box));
-	const list = nodes[at];
-	const boxAt = list.children.indexOf(box);
-	const bodyNodes = nodes.slice(0, boxAt > 0 ? at + 1 : at);
-	const trailing = list.children.slice(boxAt + 1);
-	const after = nodes.slice(at + 1);
-	return {
-		bodyNodes,
-		body: bodyNodes.map((n) => n === list ? content.slice(n.position.start.offset, box.position.start.offset).trimEnd() : slice(content, n)).join("\n\n"),
-		notBody: list.children.slice(boxAt),
-		guidance: guidanceOf([inlineGuidance(content, box), ...[...trailing, ...after].map((n) => slice(content, n))]),
-		last: after.at(-1) ?? trailing.at(-1) ?? box
-	};
-};
-const entryOf = (content, title, noise, headingLine, nodes, endLine) => {
-	const notes = nodes.filter((n) => n.type !== "footnoteDefinition");
-	const boxes = notes.flatMap((n) => n.type === "list" ? n.children.filter((i) => isBox(i, content)) : []);
-	const box = boxes[0];
-	const split = box === void 0 ? {
-		bodyNodes: notes,
-		body: notes.map((n) => slice(content, n)).join("\n\n"),
-		notBody: [],
-		guidance: ""
-	} : splitAtBox(content, notes, box);
-	return {
-		title,
-		body: split.body,
-		noise,
-		fix: box?.checked === true,
-		guidance: split.guidance,
-		boxes: boxes.length,
-		headingLine,
-		bodyNodes: split.bodyNodes,
-		...box === void 0 ? {} : { box },
-		notBody: new Set(split.notBody),
-		lastLine: split.last === void 0 ? headingLine : lineOf(split.last, true),
-		endLine
-	};
-};
-const parse = (content) => {
-	const tree = parseMarkdown(content);
-	const entries = [];
-	let noise = false;
-	let open;
-	const close = (endLine) => {
-		if (open !== void 0) entries.push(entryOf(content, open.title, noise, open.line, open.nodes, endLine));
-		open = void 0;
-	};
-	for (const node of tree.children) {
-		if (node.type === "heading" && node.depth <= 2) {
-			close(lineOf(node) - 1);
-			const text = headingText$1(content, node, (t) => t.replace(MARKER, ""));
-			if (node.depth === 1) noise = text === NOISE_HEADING;
-			else open = {
-				title: text,
-				line: lineOf(node),
-				nodes: []
-			};
-			continue;
-		}
-		open?.nodes.push(node);
-	}
-	close(content.split(/\r?\n/).length - 1);
-	return entries;
-};
-const entryFindings = (content) => parse(content).flatMap((e) => {
-	if (e.boxes === 0) return [{
-		message: `"${e.title}" has no \`- [ ] fix\` box — restore it, ticked to fix the finding or unticked to drop it`,
-		line: e.headingLine
-	}];
-	if (e.boxes > 1) return [{
-		message: `"${e.title}" has ${e.boxes} \`fix\` boxes — keep exactly one`,
-		line: e.headingLine
-	}];
-	if (!e.fix && e.guidance !== "") return [{
-		message: `"${e.title}" has guidance under an unticked box — tick it to fix the finding, or delete the text to drop it`,
-		line: lineOf(e.box)
-	}];
-	return [];
-});
-const findingsView = (content) => {
-	const noteAt = noteLookup(content);
-	return { nodes: parse(content).map((e, index) => {
-		const note = noteAt(e.headingLine);
-		return {
-			title: e.title,
-			anchor: {
-				kind: "chunk",
-				index
-			},
-			group: e.noise ? NOISE_HEADING : OPEN_GROUP,
-			...e.boxes === 1 ? { checked: e.fix } : {},
-			...e.guidance === "" ? {} : { note: e.guidance },
-			...note?.thread !== void 0 ? { thread: note.thread } : {},
-			body: blockNodesOfRun(content, e.bodyNodes, { skipListItem: (i) => e.notBody.has(i) })
-		};
-	}) };
-};
-const findingsOutline = (content) => {
-	const lines = content.split(/\r?\n/);
-	return [...parse(content).map((e) => ({
-		name: e.title,
-		detail: e.noise ? "noise" : e.fix ? "fix" : "drop",
-		range: spanRange(lines, e.headingLine, Math.max(e.headingLine, e.endLine)),
-		selectionRange: lineRange(lines, e.headingLine)
-	})), ...threadOutlineNodes(content).map((t) => t.node)];
-};
-const findingsAnnotate = (content, anchor, text) => {
-	const entries = parse(content);
-	const lines = content.split(/\r?\n/);
-	const resolved = (() => {
-		if (anchor.kind === "chunk") {
-			const e = entries[anchor.index];
-			return e && {
-				line: e.headingLine,
-				blockEndLine: e.headingLine,
-				key: `chunk:${anchor.index}`
-			};
-		}
-		if (anchor.kind !== "paragraph") return void 0;
-		const block = entries.flatMap((e) => e.bodyNodes).find((n) => anchor.line >= lineOf(n) && anchor.line <= lineOf(n, true));
-		return block && {
-			line: anchor.line,
-			blockEndLine: lineOf(block, true),
-			key: `paragraph:${anchor.line}`
-		};
-	})();
-	if (resolved === void 0) return {
-		ok: false,
-		reason: "anchor-not-found"
-	};
-	const result = footnoteAttachEdits(content, {
-		...resolved,
-		endCharacter: (lines[resolved.line] ?? "").length
-	}, text);
-	return result.ok ? {
-		ok: true,
-		edits: result.edits
-	} : result;
-};
-/** Ticks or unticks a finding's box; `text` replaces its guidance, and unticking drops it. */
-const findingsApply = (content, anchor, opts) => {
-	if (anchor.kind !== "chunk") return {
-		ok: false,
-		reason: "anchor-not-found"
-	};
-	const e = parse(content)[anchor.index];
-	if (e?.box === void 0 || e.boxes !== 1) return {
-		ok: false,
-		reason: "anchor-not-found"
-	};
-	const fix = opts.checked ?? e.fix;
-	const guidance = fix ? (opts.text ?? e.guidance).trim() : "";
-	if (fix === e.fix && guidance === e.guidance) return {
-		ok: true,
-		edits: []
-	};
-	const lines = content.split(/\r?\n/);
-	const eol = eolOf(content);
-	const start = lineOf(e.box);
-	const box = `${lines[start].match(/^\s*[-*+]\s+/)[0]}[${fix ? "x" : " "}] fix`;
-	const text = guidance === "" ? box : `${box}${eol}${eol}${guidance.split(/\r?\n/).join(eol)}`;
-	return {
-		ok: true,
-		edits: [{
-			range: {
-				start: {
-					line: start,
-					character: 0
-				},
-				end: lineRange(lines, e.lastLine).end
-			},
-			newText: text
-		}]
-	};
-};
-//#endregion
-//#region src/steering/index.ts
+//#region src/steering/registry.ts
 /** The built-in registry: mode name → its format, in registry order. The single place the built-in formats are wired into names — everything else in this module dispatches over a resolved `SteeringFormat`, never a mode-name string. */
 const REGISTRY = /* @__PURE__ */ new Map([
 	["qa", qaDescriptor],
 	["review", reviewDescriptor],
-	["findings", {
-		sample: `# Quality
-
-## A finding a lens wrote[^nafind1]
-
-[^nafind1]:
-    Attached via the phone UI, this note shows a comment on a finding with a
-    \`multi word code span\` that runs past eighty characters in total length.
-
-What the lens found, and where.
-
-- [x] fix
-
-Fix it the simple way.
-
-# Dropped as noise
-
-## A finding the judge called noise
-
-Why the judge dropped it.
-
-- [ ] fix
-`,
-		validate: (content) => [...entryFindings(content), ...threadFindings(content)],
-		outline: findingsOutline,
-		actions: (content, range) => threadReplyActions(content, range.start),
-		view: findingsView,
-		annotate: findingsAnnotate,
-		apply: findingsApply,
-		clearTicks: (content) => content,
-		openThreads: openThreadsOf
-	}]
+	["findings", findingsDescriptor]
 ]);
 [...REGISTRY.keys()];
 /** The built-in `SteeringFormat` registered under `mode`'s name, or `undefined` when it isn't a built-in mode at all. The one place a bare mode-name string is ever looked up — every consumer takes the RESOLVED value this returns, never a name, so "mode is required, never inferred from a file's basename" is a type, not a rule to remember. */

package/dist/wire.mjs

@@ -1,2 +1,2 @@
-import { C as EXIT_SIGTERM, D as UNATTRIBUTED_MODEL, E as ACCESS_REFUSAL, O as WIRE_SCHEMA, S as EXIT_SIGINT, T as EXIT_USAGE_ERROR, _ as demandOf, a as landFields, b as EXIT_OK, c as renderLandJson, d as renderBeatPlain, f as beatDocument, g as beatKindOf, h as BEAT_KINDS, i as judgeJson, k as renderFormat, l as renderLandPlain, m as statusOf, n as resolveSession, o as landProseText, p as renderBeatJson, r as selectPath, s as noopText, t as globMatches, u as DEMAND_BRIEFING, v as stallDiagnosis, w as EXIT_STRAYS_FOUND, x as EXIT_RUNTIME_ERROR, y as EXIT_CODES } from "./chunks/wire-BTUhRGXj.mjs";
-export { ACCESS_REFUSAL, BEAT_KINDS, DEMAND_BRIEFING, EXIT_CODES, EXIT_OK, EXIT_RUNTIME_ERROR, EXIT_SIGINT, EXIT_SIGTERM, EXIT_STRAYS_FOUND, EXIT_USAGE_ERROR, UNATTRIBUTED_MODEL, WIRE_SCHEMA, beatDocument, beatKindOf, demandOf, globMatches, judgeJson, landFields, landProseText, noopText, renderBeatJson, renderBeatPlain, renderFormat, renderLandJson, renderLandPlain, resolveSession, selectPath, stallDiagnosis, statusOf };
+import { A as WIRE_SCHEMA, C as EXIT_RUNTIME_ERROR, D as EXIT_USAGE_ERROR, E as EXIT_STRAYS_FOUND, O as ACCESS_REFUSAL, S as EXIT_OK, T as EXIT_SIGTERM, _ as BEAT_KINDS, a as renderScriptJson, b as stallDiagnosis, c as landProseText, d as renderLandPlain, f as DEMAND_BRIEFING, g as statusOf, h as renderBeatJson, i as judgeJson, j as renderFormat, k as UNATTRIBUTED_MODEL, l as noopText, m as beatDocument, n as resolveSession, o as scriptFields, p as renderBeatPlain, r as selectPath, s as landFields, t as globMatches, u as renderLandJson, v as beatKindOf, w as EXIT_SIGINT, x as EXIT_CODES, y as demandOf } from "./chunks/wire-DZ8R1RU9.mjs";
+export { ACCESS_REFUSAL, BEAT_KINDS, DEMAND_BRIEFING, EXIT_CODES, EXIT_OK, EXIT_RUNTIME_ERROR, EXIT_SIGINT, EXIT_SIGTERM, EXIT_STRAYS_FOUND, EXIT_USAGE_ERROR, UNATTRIBUTED_MODEL, WIRE_SCHEMA, beatDocument, beatKindOf, demandOf, globMatches, judgeJson, landFields, landProseText, noopText, renderBeatJson, renderBeatPlain, renderFormat, renderLandJson, renderLandPlain, renderScriptJson, resolveSession, scriptFields, selectPath, stallDiagnosis, statusOf };

package/dist/workflow-kit.mjs

@@ -1,5 +1,5 @@
-import { changes, changesSince, hasThreadFor, head, mark, read, refuse, requireReplies, requireThreadsClosed, scope } from "./flows.mjs";
-import { A as parseThreads, C as unansweredNotes, b as reviewNotes, c as stripCodeThreads, x as reviewRisks, y as reviewDecisions } from "./chunks/steering-CCNvngSH.mjs";
+import { B as head, F as changesSince, G as mark, P as changes, X as read, Z as refuse, d as hasThreadFor, et as scope, g as requireReplies, v as requireThreadsClosed } from "./chunks/flows-DENt0uWV.mjs";
+import { A as parseThreads, S as unansweredNotes, b as reviewRisks, n as stripCodeThreads, v as reviewDecisions, y as reviewNotes } from "./chunks/steering-DF_BMadH.mjs";
 //#region src/workflow-kit/health.ts
 /** Hand a red suite that repeated attempts could not fix to a person, until `limit` rounds are spent. */
 const escalation = async (count, steps) => {
@@ -427,4 +427,4 @@ const reviewToHandOff = async (base, p) => {
 	}
 };
 //#endregion
-export { assertionLines, escalation, fixFindings, gate, healthy, lensEntriesOf, lensOf, lensScopes, lensesOf, qualityLap, removedAssertions, review, reviewToHandOff, routeNotes, untilSettled };
+export { assertionLines, escalation, fixFindings, gate, healthy, lensEntriesOf, lensOf, lensScopes, lensesOf, qualityLap, removedAssertions, review, reviewToHandOff, untilSettled };

package/package.json

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