pstack-claude-mirror 0.0.0-stage → 0.9.133

package/plugins/pstack/skills/poteto-mode/scripts/bun.lock

@@ -0,0 +1,67 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@cursor-skill/poteto-mode-tools",
+      "dependencies": {
+        "commander": "14.0.0",
+      },
+      "devDependencies": {
+        "bun-types": "latest",
+        "typescript": "latest",
+      },
+    },
+  },
+  "packages": {
+    "@types/node": ["@types/node@26.1.2", "", { "dependencies": { "undici-types": "~8.3.0" } }, "sha512-Vu4a5UFA9rIIFJ7rB/Vaafh9lrCQszopTCx6KjFboXTGQbPNasehVR5TEiithSDGyd1DEiUByggTZsg8jukeIg=="],
+
+    "@typescript/typescript-aix-ppc64": ["@typescript/typescript-aix-ppc64@7.0.2", "", { "os": "aix", "cpu": "ppc64" }, "sha512-MTKKkWB7p/0E9xi1d1tHtZ5PiLkGEMIq88pK2CubZjOsLtYTLqhgIgi6zepFa+9GHZ6h05NMCkQxGKiPXMxXtQ=="],
+
+    "@typescript/typescript-darwin-arm64": ["@typescript/typescript-darwin-arm64@7.0.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-gowzar9MwS/aRWp6f3a4KUqzRjAZjOsmGNCM6LcTgXum+dBfgsBVMN+AgvOCCbguXyick6LJhpBszxMebJ8syA=="],
+
+    "@typescript/typescript-darwin-x64": ["@typescript/typescript-darwin-x64@7.0.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-SZ9xZInqApNlNGc9s0W1VSsktYSOe9cFqNOIqmN1Gs8SmkjKZYFt017G4VwPxASInODuAdbTW7sXiFUf893RgA=="],
+
+    "@typescript/typescript-freebsd-arm64": ["@typescript/typescript-freebsd-arm64@7.0.2", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-W5NH4y/J0plIIS5b2xvTEkU7JFxyqdMAOgf+Ilhl0vHQXKO5dZoxd+C/jEtq56c4F3wk71RB4BMRQ2XdI+bwYQ=="],
+
+    "@typescript/typescript-freebsd-x64": ["@typescript/typescript-freebsd-x64@7.0.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-UMGDx5sTpzNw3WiPebH7l90IWfJggEd+egHt/q6p7/Cm3zqoV7VxkGXt+3DxPIw8CcmvAB0j3sVVfbhX+M4Tpw=="],
+
+    "@typescript/typescript-linux-arm": ["@typescript/typescript-linux-arm@7.0.2", "", { "os": "linux", "cpu": "arm" }, "sha512-gffT3xPz9sR7j/YJExkyPntrI0P2EP9XbOyWzth2/Gs0RstK+90RBcO0ncXoXy/beYll1SXw846Nf2zdnEz0QQ=="],
+
+    "@typescript/typescript-linux-arm64": ["@typescript/typescript-linux-arm64@7.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-Qh4eU4/y3yDjnfjjyPYihMj5/ODIlmt+Bzu17OI+fiSRDW57QmU5SiN63exPRNJPKUzcc1INa1NXdrJ+MqHjUQ=="],
+
+    "@typescript/typescript-linux-loong64": ["@typescript/typescript-linux-loong64@7.0.2", "", { "os": "linux", "cpu": "none" }, "sha512-uEHck9i8hoAzXPiYRib1O7miOnz23SxIeVl6F4LXox+qov1K35jHcEW6VHKvZI+pyvl7fZEP4MCU5LYvIq1GuQ=="],
+
+    "@typescript/typescript-linux-mips64el": ["@typescript/typescript-linux-mips64el@7.0.2", "", { "os": "linux", "cpu": "none" }, "sha512-R4KvAMnE43W5Qeqb0Ly56O3mWMWIAgsMyz36DCaycd5nbg/9kzm0liw3JocfRqyJY0KPmzFjbswozXyW0DnIYA=="],
+
+    "@typescript/typescript-linux-ppc64": ["@typescript/typescript-linux-ppc64@7.0.2", "", { "os": "linux", "cpu": "ppc64" }, "sha512-DORx5b3sd/4S7eayxm4FQv+A7CrkUIGRaHiwI8oiHTAI1fAPWhF4J0vAlkC8biAlHSVVwxMQ3tjZ2/DVbnQiiA=="],
+
+    "@typescript/typescript-linux-riscv64": ["@typescript/typescript-linux-riscv64@7.0.2", "", { "os": "linux", "cpu": "none" }, "sha512-wf0jqEDOjrPRnKwYRyyJDRo11KMbvMFrU+q4zqKyChODBzvlkbhNQfKvLxQCcwTpdDaXSHZTVuh0JoCrKCUMHQ=="],
+
+    "@typescript/typescript-linux-s390x": ["@typescript/typescript-linux-s390x@7.0.2", "", { "os": "linux", "cpu": "s390x" }, "sha512-IkwJc3L7yhytWd/ewjyxNDfOmswCm9GWMJT/ue/dU4aZNbwZeYAetq42VyLmsmSjvoX7z74X6ZaYCtzAr0EuGw=="],
+
+    "@typescript/typescript-linux-x64": ["@typescript/typescript-linux-x64@7.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-EYdf2cNg7rgCWJnxCdJ+F3V39O8ihb37eHAu1LK8oAFizgTQbPOK7zHHXbPt8rX24COqODXeI3sIf0fCXG7H/A=="],
+
+    "@typescript/typescript-netbsd-arm64": ["@typescript/typescript-netbsd-arm64@7.0.2", "", { "os": "none", "cpu": "arm64" }, "sha512-+polYF4MF04aPpO5FTkHran9yUQDSXqy5GiSDKpsll5jy3l3+g9QLhpf39T+ePtefhXLOGrLl0QIjkQP6VnelA=="],
+
+    "@typescript/typescript-netbsd-x64": ["@typescript/typescript-netbsd-x64@7.0.2", "", { "os": "none", "cpu": "x64" }, "sha512-8YIT0EHM/3dq10ZOVF/A7pc/YSMtbcecct4rWtexrnSCHOPcpC2KTLXfTCR6vDpnSiY12heNb1GiN/wu+T/FyA=="],
+
+    "@typescript/typescript-openbsd-arm64": ["@typescript/typescript-openbsd-arm64@7.0.2", "", { "os": "openbsd", "cpu": "arm64" }, "sha512-APT8+ClYnuYm1u9+kgGXoMj2VzWzcymwh2gNSQVySHfkRDGOTVkoWLjCmOQSaO+PoqQ57B0flRp9SA+7GnnkzQ=="],
+
+    "@typescript/typescript-openbsd-x64": ["@typescript/typescript-openbsd-x64@7.0.2", "", { "os": "openbsd", "cpu": "x64" }, "sha512-yX7s+Q0Dln0Dt9tEzZsAjXXR/+ytBM7AlglaqyeMPxQszJ1JhlJdZ6jLA+IzldHtflX81em7lDao1xXu+aRRkg=="],
+
+    "@typescript/typescript-sunos-x64": ["@typescript/typescript-sunos-x64@7.0.2", "", { "os": "sunos", "cpu": "x64" }, "sha512-dLJDGaLZ1D4HPQn62u1n8mBDkJREwMsAkCdkwd4Ieqw+x3TUyTsqY0YiBCtE6H6OzzgGk3iuZ3vFWRS+E8/d1g=="],
+
+    "@typescript/typescript-win32-arm64": ["@typescript/typescript-win32-arm64@7.0.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-Gyl1Vy6OsWesLzmq+EP0Fb7b4Nid5232AvcA2SFcdYreldpNtYFFofPjnt62y9hQy7VTaZp65ICJjuAQRaVcIQ=="],
+
+    "@typescript/typescript-win32-x64": ["@typescript/typescript-win32-x64@7.0.2", "", { "os": "win32", "cpu": "x64" }, "sha512-0BQ3HkAHHlKLSp1qRvf3SUhGpGsDuhB/jgFw75guyqbxJqEaS0Cw/VFO8i2nHglJUzQCRtMMR/IBAKE3ETMC4g=="],
+
+    "bun-types": ["bun-types@1.3.14", "", { "dependencies": { "@types/node": "*" } }, "sha512-4N0ig0fEomHt5R0KCFWjovxow98rIoRwKolrYdCcknNwMekCXRnWEUvgu5soYV8QXtVsrUD8B95MBOZGPvr6KQ=="],
+
+    "commander": ["commander@14.0.0", "", {}, "sha512-2uM9rYjPvyq39NwLRqaiLtWHyDC1FvryJDa2ATTVims5YAS4PupsEQsDvP14FqhFr0P49CYDugi59xaxJlTXRA=="],
+
+    "typescript": ["typescript@7.0.2", "", { "optionalDependencies": { "@typescript/typescript-aix-ppc64": "7.0.2", "@typescript/typescript-darwin-arm64": "7.0.2", "@typescript/typescript-darwin-x64": "7.0.2", "@typescript/typescript-freebsd-arm64": "7.0.2", "@typescript/typescript-freebsd-x64": "7.0.2", "@typescript/typescript-linux-arm": "7.0.2", "@typescript/typescript-linux-arm64": "7.0.2", "@typescript/typescript-linux-loong64": "7.0.2", "@typescript/typescript-linux-mips64el": "7.0.2", "@typescript/typescript-linux-ppc64": "7.0.2", "@typescript/typescript-linux-riscv64": "7.0.2", "@typescript/typescript-linux-s390x": "7.0.2", "@typescript/typescript-linux-x64": "7.0.2", "@typescript/typescript-netbsd-arm64": "7.0.2", "@typescript/typescript-netbsd-x64": "7.0.2", "@typescript/typescript-openbsd-arm64": "7.0.2", "@typescript/typescript-openbsd-x64": "7.0.2", "@typescript/typescript-sunos-x64": "7.0.2", "@typescript/typescript-win32-arm64": "7.0.2", "@typescript/typescript-win32-x64": "7.0.2" }, "bin": { "tsc": "bin/tsc" } }, "sha512-8FYau96o3NKOhbjKi/qNvG/W5jhzxkbdm5sj9AbZ/5T5sWqn3hJgLfGx27sRKZWTvyzCP8dLRBTf5tBTSRVUNA=="],
+
+    "undici-types": ["undici-types@8.3.0", "", {}, "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ=="],
+  }
+}

package/plugins/pstack/skills/poteto-mode/scripts/check-plan.mjs

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import process from "node:process";
+
+const RULE =
+	"Tests alone are not sufficient verification. A PR is verified only when its unit, live, and perf boxes are all checked.";
+const LANES = "Ten lanes on the configured `swarm workers` model at the PR head";
+const SUB_BLOCKS = [
+	"Depends on.",
+	"Files.",
+	"Build.",
+	"You see.",
+	"Verify, unit.",
+	"Verify, live.",
+	"Verify, perf.",
+	"Review gate.",
+	"Merge.",
+];
+const PROGRAM_H3 = ["Arm the program", "Spawn owners", "PR mechanics", "Verdict and merge", "Boot recipe"];
+const PROGRAM_MARKERS = [/into `?notes\.md`? in the program's store/, "installed plugin", /hourly|every hour/, "status message"];
+const HOW_TO_READ_MARKERS = [
+	"One box is one unit of work",
+	"names the evidence",
+	"Check a box only when its evidence exists",
+	"playbooks/",
+	RULE,
+];
+const PERF_ITEMS = ["Metric.", "Probe.", "Baseline.", "Rule."];
+const BOX = /^\s*- \[[ x]\] (.*)$/;
+
+const file = process.argv[2];
+if (!file) {
+	console.error("Usage: node check-plan.mjs <plan.md>");
+	process.exit(2);
+}
+
+const raw = fs.readFileSync(file, "utf8").replace(/^\uFEFF/, "").split(/\r?\n/);
+const problems = [];
+const fail = (line, message) => problems.push(`${file}:${line}: ${message}`);
+
+let start = 0;
+if (raw[0] === "---") {
+	start = raw.indexOf("---", 1) + 1;
+}
+
+const lines = [];
+let fence = null;
+const openingFence = (text) => {
+	const match = text.match(/^[ \t]*(`{3,}|~{3,})(.*)$/);
+	if (!match || (match[1][0] === "`" && match[2].includes("`"))) return null;
+	return { char: match[1][0], length: match[1].length };
+};
+const closingFence = (text, opening) => {
+	const match = text.match(/^[ \t]*(`+|~+)[ \t]*$/);
+	return Boolean(
+		match &&
+		match[1][0] === opening.char &&
+		match[1].length >= opening.length,
+	);
+};
+for (let i = start; i < raw.length; i++) {
+	const text = raw[i];
+	const n = i + 1;
+	let code = Boolean(fence);
+	if (fence && closingFence(text, fence)) {
+		code = false;
+		fence = null;
+	} else if (!fence) {
+		fence = openingFence(text);
+		code = Boolean(fence);
+	}
+	lines.push({ n, text, code });
+	if (code) continue;
+	const prose = text
+		.replace(/(?<!`)(`+)(?!`)(.*?)(?<!`)\1(?!`)/g, "`")
+		.replace(/!\[[^\]]*\]\([^)]*\)/g, "")
+		.replace(/\]\([^)]*\)/g, "]");
+	if (/[\u2013\u2014]/.test(prose)) fail(n, "long dash");
+	if (/[\u2018\u2019\u201c\u201d]/.test(prose)) fail(n, "curly quote");
+	if (/: \S/.test(prose)) fail(n, "mid-sentence colon");
+}
+
+function sectionsAtLevel(lines, prefix) {
+	const sections = [];
+	for (const l of lines) {
+		if (!l.code && l.text.startsWith(prefix)) {
+			sections.push({ title: l.text.slice(prefix.length).trim(), n: l.n, body: [] });
+		} else if (sections.length) sections.at(-1).body.push(l);
+	}
+	return sections;
+}
+const sections = sectionsAtLevel(lines, "## ");
+const find = (title) => sections.find((s) => s.title === title);
+const bodyText = (s) => s.body.filter((l) => !l.code).map((l) => l.text).join("\n");
+const boxes = (ls) => ls.filter((l) => !l.code && BOX.test(l.text)).map((l) => ({ n: l.n, text: l.text.match(BOX)[1] }));
+
+const h1 = lines.findIndex((l) => !l.code && l.text.startsWith("# "));
+if (h1 === -1) fail(1, "no H1 title");
+const howToRead = find("How to read this");
+if (!howToRead) fail(1, 'no "## How to read this" section');
+if (h1 !== -1 && howToRead) {
+	const intro = lines.slice(h1 + 1).filter((l) => l.n < howToRead.n && l.text.trim() !== "");
+	if (intro.length >= 10) fail(lines[h1].n, `intro is ${intro.length} lines, under ten required`);
+	for (const marker of HOW_TO_READ_MARKERS) {
+		if (!bodyText(howToRead).includes(marker)) fail(howToRead.n, `How to read this lacks "${marker}"`);
+	}
+}
+
+const program = find("Program checklist");
+if (!program) fail(1, 'no "## Program checklist" section');
+else {
+	const tasks = sectionsAtLevel(program.body, "### ");
+	let cursor = 0;
+	for (const name of PROGRAM_H3) {
+		const at = tasks.findIndex((t, i) => i >= cursor && t.title.startsWith(name));
+		if (at === -1) fail(program.n, `Program checklist lacks "### ${name}" in order`);
+		else {
+			const task = tasks[at];
+			if (boxes(task.body).length === 0) fail(task.n, `${task.title} has no box`);
+			cursor = at + 1;
+		}
+	}
+	for (const marker of PROGRAM_MARKERS) {
+		const ok = marker instanceof RegExp ? marker.test(bodyText(program)) : bodyText(program).includes(marker);
+		if (!ok) fail(program.n, `Program checklist lacks "${marker}"`);
+	}
+}
+
+const close = find("Close the program");
+if (!close) fail(1, 'no "## Close the program" section');
+else if (boxes(close.body).length === 0) fail(close.n, "Close the program has no box");
+const programIndex = sections.indexOf(program);
+const closeIndex = sections.indexOf(close);
+const prSections = programIndex === -1 || closeIndex === -1 ? [] : sections.slice(programIndex + 1, closeIndex);
+if (prSections.length === 0) fail(1, "no PR sections between Program checklist and Close the program");
+
+const report = [];
+for (const pr of prSections) {
+	const heads = [];
+	for (const l of pr.body) {
+		if (l.code) continue;
+		const m = l.text.match(/^\*\*([^*]+)\*\*(.*)$/);
+		if (m && SUB_BLOCKS.includes(m[1])) heads.push({ name: m[1], n: l.n, rest: m[2].trim(), lines: [] });
+		else if (heads.length) heads.at(-1).lines.push(l);
+	}
+	const names = heads.map((h) => h.name);
+	if (names.join("|") !== SUB_BLOCKS.join("|")) {
+		fail(pr.n, `${pr.title}: sub-blocks are [${names.join(", ")}], expected [${SUB_BLOCKS.join(", ")}]`);
+	}
+	const block = (name) => heads.find((h) => h.name === name);
+	const counts = {};
+	for (const h of heads) counts[h.name] = boxes(h.lines).length;
+
+	const depends = block("Depends on.");
+	if (depends && depends.rest === "") fail(depends.n, `${pr.title}: Depends on names nothing`);
+	for (const name of ["Files.", "Build.", "You see.", "Verify, unit.", "Merge."]) {
+		const b = block(name);
+		if (b && boxes(b.lines).length === 0) fail(b.n, `${pr.title}: ${name} has no box`);
+	}
+	for (const name of ["Verify, unit.", "Verify, live.", "Verify, perf."]) {
+		const b = block(name);
+		if (b && !b.rest.startsWith(RULE)) fail(b.n, `${pr.title}: ${name} does not open with the rule`);
+	}
+
+	const live = block("Verify, live.");
+	if (live) {
+		if (!live.rest.includes(LANES)) fail(live.n, `${pr.title}: Verify, live lacks "${LANES}"`);
+		const lanes = boxes(live.lines).map((b) => ({ ...b, m: b.text.match(/^Lane (\d+)\. /) }));
+		const numbers = lanes.filter((b) => b.m).map((b) => Number(b.m[1])).sort((a, b) => a - b);
+		if (numbers.join(",") !== "1,2,3,4,5,6,7,8,9,10") fail(live.n, `${pr.title}: lanes are [${numbers.join(",")}], expected 1 to 10`);
+		for (const lane of lanes) {
+			if (!lane.m) fail(lane.n, `${pr.title}: live box is not a lane`);
+			else if (!/Save `[^`]+`/.test(lane.text)) fail(lane.n, `${pr.title}: lane ${lane.m[1]} names no screenshot`);
+			else if (!lane.text.includes("Pass when")) fail(lane.n, `${pr.title}: lane ${lane.m[1]} has no pass predicate`);
+		}
+	}
+
+	const perf = block("Verify, perf.");
+	if (perf) {
+		const items = boxes(perf.lines).map((b) => b.text.split(" ")[0]);
+		if (items.join("|") !== PERF_ITEMS.join("|")) fail(perf.n, `${pr.title}: perf boxes are [${items.join(", ")}], expected [${PERF_ITEMS.join(", ")}]`);
+	}
+
+	const gate = block("Review gate.");
+	if (gate) {
+		const gateBoxes = boxes(gate.lines);
+		if (gate.rest.startsWith("None.")) {
+			if (gateBoxes.length) fail(gate.n, `${pr.title}: Review gate says None but has boxes`);
+		} else {
+			const text = gate.lines.filter((l) => !l.code).map((l) => l.text).join("\n");
+			if (gateBoxes.length === 0) fail(gate.n, `${pr.title}: Review gate has no box`);
+			for (const word of ["screenshot", "video", "operator"]) {
+				if (!text.includes(word)) fail(gate.n, `${pr.title}: Review gate lacks "${word}"`);
+			}
+		}
+	}
+
+	const total = boxes(pr.body).length;
+	const cells = SUB_BLOCKS.filter((s) => s !== "Depends on.").map((s) => `${s.replace(/[ ,.]+/g, "-").replace(/-$/, "").toLowerCase()}=${counts[s] ?? 0}`);
+	report.push(`${pr.title}  boxes=${total}  ${cells.join(" ")}`);
+}
+
+if (closeIndex !== -1) {
+	const tail = sections.slice(closeIndex + 1);
+	for (const s of tail) {
+		if (!s.title.startsWith("Appendix")) fail(s.n, `"## ${s.title}" after Close the program is not an appendix`);
+	}
+	if (!tail.some((s) => s.title.includes("Prototype evidence"))) fail(close.n, 'no "## Appendix ... Prototype evidence" section');
+}
+
+for (const line of report) console.log(line);
+console.log(`${prSections.length} PR sections, ${problems.length} problems`);
+for (const p of problems) console.error(p);
+process.exit(problems.length ? 1 : 0);

package/plugins/pstack/skills/poteto-mode/scripts/check-plan.test.ts

@@ -0,0 +1,115 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { expect, test } from "bun:test";
+
+const checker = join(import.meta.dir, "check-plan.mjs");
+const rule =
+	"Tests alone are not sufficient verification. A PR is verified only when its unit, live, and perf boxes are all checked.";
+
+const validPlan = `# Demo
+
+## How to read this
+One box is one unit of work and names the evidence. Check a box only when its evidence exists. See playbooks/.
+${rule}
+
+## Program checklist
+### Arm the program
+- [ ] Write the objective into notes.md in the program's store. Read the playbook from the installed plugin. Arm the hourly audit tick.
+### Spawn owners
+- [ ] Spawn one owner per PR.
+### PR mechanics
+- [ ] Open each PR ready.
+### Verdict and merge
+- [ ] Record each verdict.
+### Boot recipe
+\`git show origin/main:\` /loop 1h status message
+- [ ] Boot each live lane.
+
+## PR 1
+**Depends on.** None.
+**Files.**
+- [ ] Do the thing.
+**Build.**
+- [ ] Do the thing.
+**You see.**
+- [ ] Do the thing.
+**Verify, unit.** ${rule}
+- [ ] Check the thing.
+**Verify, live.** ${rule} Ten lanes on the configured \`swarm workers\` model at the PR head
+${Array.from({ length: 10 }, (_, i) => `- [ ] Lane ${i + 1}. Save \`lane-${i + 1}.png\`. Pass when evidence exists.`).join("\n")}
+**Verify, perf.** ${rule}
+- [ ] Metric. Recorded.
+- [ ] Probe. Recorded.
+- [ ] Baseline. Recorded.
+- [ ] Rule. Recorded.
+**Review gate.** None.
+**Merge.**
+- [ ] Merge when approved.
+
+## Close the program
+- [ ] Close.
+
+## Appendix Prototype evidence
+Recorded.
+`;
+
+const runPlan = (example: string, expectedExit: number) => {
+	const directory = mkdtempSync(join(tmpdir(), "check-plan-test-"));
+	const file = join(directory, "plan.md");
+	writeFileSync(file, validPlan + example);
+	try {
+		const result = spawnSync("node", [checker, file], { encoding: "utf8" });
+		expect(result.status).toBe(expectedExit);
+		return result;
+	} finally {
+		rmSync(directory, { recursive: true, force: true });
+	}
+};
+
+test("accepts ordinary, indented, and longer closing fences", () => {
+	for (const indent of ["", " ", "  ", "   "])
+		runPlan(`${indent}\`\`\`markdown\n## Example only\n${indent}\`\`\`\n`, 0);
+	runPlan("```markdown\n## Example only\n````\n", 0);
+});
+
+test("accepts nested backticks and tilde info strings", () => {
+	runPlan("````markdown\n```markdown\n## Example only\n```\n````\n", 0);
+	runPlan("~~~markdown `info`\n## Example only\n ~~~\n", 0);
+});
+
+test("keeps mismatched, shorter, and suffixed closers inside the fence", () => {
+	runPlan("````markdown\n~~~\n## Example only\n````\n", 0);
+	runPlan("````markdown\n```\n## Example only\n````\n", 0);
+	runPlan("````markdown\n``` info\n## Example only\n````\n", 0);
+});
+
+test("rejects headings and prose outside a proper close", () => {
+	for (const suffix of ["  ", "\t"]) {
+		const heading = runPlan(`\`\`\`markdown\n## Example only\n\`\`\`${suffix}\n## Example only\n`, 1);
+		expect(heading.stderr).toContain('"## Example only" after Close the program is not an appendix');
+	}
+
+	const prose = runPlan("```markdown\nThis prose has a mid-sentence colon: inside code\n```\nThis prose has a mid-sentence colon: bad.\n", 1);
+	expect(prose.stderr).toContain("mid-sentence colon");
+});
+
+test("rejects backtick info strings containing a backtick", () => {
+	const result = runPlan("```markdown `invalid`\n## Example only\n```\n", 1);
+	expect(result.stderr).toContain('"## Example only" after Close the program is not an appendix');
+});
+
+test("ignores prose punctuation inside matching multi-backtick code spans", () => {
+	for (const count of [2, 3, 4]) {
+		const delimiter = "`".repeat(count);
+		runPlan(`Use ${delimiter}echo \`x\`: “quoted” — example${delimiter}.\n`, 0);
+	}
+});
+
+test("checks prose following a multi-backtick span and unmatched delimiters", () => {
+	const outside = runPlan("Use ``echo `x`: y``. Bad: prose.\n", 1);
+	expect(outside.stderr).toContain("mid-sentence colon");
+	const unmatched = runPlan("Use ``unclosed: bad` here.\n", 1);
+	expect(unmatched.stderr).toContain("mid-sentence colon");
+});

package/plugins/pstack/skills/poteto-mode/scripts/check-playbooks.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+
+const BUNDLED = resolve(dirname(fileURLToPath(import.meta.url)), "../playbooks");
+const CHANGE = /^\s*(?:[-*]|\d+\.)\s+\*\*(?:After|Before|Replace|In)\*\*\s+"([^"]+)"/;
+const CHANGE_VERB = /^\s*(?:[-*]|\d+\.)\s+\*\*(?:After|Before|Replace|In)\*\*/;
+const flat = (text) => text.replace(/\s+/g, " ");
+
+export function checkPlaybooks(root, bundled = BUNDLED) {
+  const dir = join(root, ".agents/playbooks");
+  if (!existsSync(dir)) return [];
+  const problems = [];
+  for (const name of readdirSync(dir).filter((file) => file.endsWith(".md")).sort()) {
+    const path = `.agents/playbooks/${name}`;
+    const text = readFileSync(join(dir, name), "utf8").replace(/^\uFEFF/, "").replaceAll("\r\n", "\n");
+    const front = text.match(/^---\n([\s\S]*?)\n---\n/)?.[1] ?? "";
+    const field = (fieldName) => front.match(new RegExp(`^${fieldName}:[ \\t]*(.*)$`, "m"))?.[1].trim() ?? "";
+    if (!field("when")) problems.push(`${path}: its frontmatter needs a "when:" line`);
+    const bases = field("extends")
+      .split(",")
+      .map((stem) => stem.trim())
+      .filter(Boolean)
+      .map((stem) => {
+        const file = join(bundled, `${stem}.md`);
+        const known = !/[\\/]/.test(stem) && existsSync(file);
+        return { stem, text: known ? readFileSync(file, "utf8") : null };
+      });
+    for (const base of bases) {
+      if (base.text === null) problems.push(`${path}: extends \`${base.stem}\`, which this pstack has no playbook for`);
+    }
+    for (const line of text.split("\n")) {
+      if (CHANGE_VERB.test(line) && !CHANGE.test(line)) {
+        problems.push(`${path}: a change has no straight-quoted step text to anchor on: ${line.trim().slice(0, 80)}`);
+      }
+      const anchor = line.match(CHANGE)?.[1];
+      if (anchor && !bases.some((base) => base.text && flat(base.text).includes(flat(anchor)))) {
+        problems.push(`${path}: "${anchor}" is not in any playbook it extends`);
+      }
+    }
+  }
+  return problems;
+}
+
+// node leaves argv[1] unresolved and may set it to a non-file (`node -e ... arg`).
+function invokedDirectly() {
+  if (!process.argv[1]) return false;
+  try {
+    return fileURLToPath(import.meta.url) === realpathSync(process.argv[1]);
+  } catch {
+    return false;
+  }
+}
+
+if (invokedDirectly()) {
+  const root = resolve(process.argv[2] ?? ".");
+  const directory = join(root, ".agents/playbooks");
+  const problems = statSync(root, { throwIfNoEntry: false })?.isDirectory()
+    ? checkPlaybooks(root)
+    : [`${root} is not a directory`];
+  if (problems.length > 0) {
+    console.error(problems.join("\n"));
+    process.exitCode = 1;
+  } else if (existsSync(directory)) {
+    console.log("Every project playbook matches this pstack's playbooks.");
+  } else {
+    console.log(`No project playbooks to check: ${directory} does not exist.`);
+  }
+}

package/plugins/pstack/skills/poteto-mode/scripts/codex-session-effort.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// Read only the current thread's active-turn metadata; never infer from config
+// defaults, another thread, or a completed turn. Output contains no transcript.
+import { createReadStream, existsSync, readdirSync, realpathSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const levels = new Set(["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"]);
+
+export async function activeEffort(stream, threadId) {
+  let rest = "";
+  let sessionId;
+  let turnId;
+  let effort;
+  const record = (line) => {
+    if (!line) return;
+    const row = JSON.parse(line);
+    const data = row?.payload;
+    if (row?.type === "session_meta") sessionId = data?.id;
+    if (row?.type === "event_msg" && data?.type === "task_started") {
+      turnId = data.turn_id;
+      effort = undefined;
+    }
+    if (row?.type === "turn_context" && turnId && data?.turn_id === turnId) effort = data.effort;
+    if (row?.type === "event_msg" && data?.type === "task_complete" && data.turn_id === turnId) {
+      turnId = undefined;
+      effort = undefined;
+    }
+  };
+  // Split only on LF: JSON strings can contain literal U+2028 and U+2029.
+  for await (const chunk of stream) {
+    const lines = (rest + chunk).split("\n");
+    rest = lines.pop();
+    for (const line of lines) record(line);
+  }
+  if (rest) record(rest);
+  if (sessionId !== threadId) throw new Error("runtime log does not identify the current thread");
+  if (!turnId || !levels.has(effort)) throw new Error("current turn has no explicit effort metadata");
+  return effort;
+}
+
+export async function sessionEffort(threadId = process.env.CODEX_THREAD_ID, codexHome = process.env.CODEX_HOME) {
+  if (!threadId || !/^[a-zA-Z0-9_-]+$/.test(threadId)) throw new Error("CODEX_THREAD_ID is unavailable or invalid");
+  const root = join(codexHome || join(homedir(), ".codex"), "sessions");
+  const matches = [];
+  const walk = (directory, depth = 0) => {
+    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+      const path = join(directory, entry.name);
+      if (entry.isFile() && entry.name.startsWith("rollout-") && entry.name.endsWith(`-${threadId}.jsonl`)) matches.push(path);
+      else if (entry.isDirectory() && depth < 3) walk(path, depth + 1);
+    }
+  };
+  walk(root);
+  if (matches.length !== 1) throw new Error("current thread runtime log is missing or ambiguous");
+  return activeEffort(createReadStream(matches[0], { encoding: "utf8" }), threadId);
+}
+
+if (process.argv[1] && existsSync(process.argv[1]) && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try {
+    console.log(JSON.stringify({ effort: await sessionEffort() }));
+  } catch {
+    console.log(JSON.stringify({ effort: null, reason: "Current Codex turn effort is unavailable; choose an explicit effort before dispatching." }));
+    process.exitCode = 1;
+  }
+}

package/plugins/pstack/skills/poteto-mode/scripts/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@cursor-skill/poteto-mode-tools",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "bun test watch-pr check-plan.test.ts",
+    "typecheck": "tsc --project tsconfig.json"
+  },
+  "dependencies": {
+    "commander": "14.0.0"
+  },
+  "devDependencies": {
+    "bun-types": "latest",
+    "typescript": "latest"
+  }
+}