docs(changelog): plan_version 1.9 and the trial-4 findings, with door lines

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tests/lib/plan-version-1-9-docs.test.mjs

@@ -139,3 +139,50 @@ test('the template\'s own example steps validate as 1.9 with none of the new pat
   const soft = validatePlanContent(read('templates/plan-template.md'), { strict: false });
   assert.deepEqual([...soft.errors, ...soft.warnings].map((i) => i.code).filter((c) => NEW_CODES.includes(c)), []);
 });
+
+// Step 14: the CHANGELOG's top section is the Unreleased 1.9 delivery, with door
+// lines the release check accepts. The release check is imported as a module
+// namespace, so a missing parseDoors export fails an assertion, not the load.
+const releaseCheck = await import('../../scripts/release-check.mjs');
+const UNRELEASED = '## Unreleased — plan_version 1.9, the trial-4 findings, session-clean tests';
+
+function firstChangelogSection() {
+  const lines = read('CHANGELOG.md').split('\n');
+  const start = lines.findIndex((l) => /^## /.test(l));
+  assert.ok(start >= 0, 'CHANGELOG.md has no "## " section');
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i++) {
+    if (/^## /.test(lines[i])) { end = i; break; }
+  }
+  return { heading: lines[start], body: lines.slice(start + 1, end).join('\n') };
+}
+
+test('CHANGELOG: the first "## " section is the Unreleased plan_version 1.9 section', () => {
+  assert.equal(firstChangelogSection().heading, UNRELEASED);
+});
+
+test('CHANGELOG: parseDoors reads the Unreleased section\'s door lines, none bad, one naming plan_version 1.9', () => {
+  assert.equal(typeof releaseCheck.parseDoors, 'function', 'scripts/release-check.mjs exports parseDoors');
+  const { heading, body } = firstChangelogSection();
+  assert.equal(heading, UNRELEASED);
+  const d = releaseCheck.parseDoors(body);
+  assert.equal(d.found, true, 'the Unreleased section has a "### Doors" heading');
+  assert.ok(d.entries.length > 0, 'the Doors list has door lines');
+  assert.deepEqual(d.bad, [], 'every top-level door line reads "- one-way: ..." or "- two-way: ..."');
+  assert.ok(d.entries.some((e) => e.text.includes('plan_version 1.9')),
+    `one door line names plan_version 1.9: ${JSON.stringify(d.entries.map((e) => e.text))}`);
+});
+
+test('CHANGELOG: the Unreleased section\'s Known issues name the session split', () => {
+  const { heading, body } = firstChangelogSection();
+  assert.equal(heading, UNRELEASED);
+  const lines = body.split('\n');
+  const start = lines.findIndex((l) => /^### Known issues\s*$/.test(l));
+  assert.ok(start >= 0, 'the Unreleased section has a "### Known issues" heading');
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i++) {
+    if (/^###? /.test(lines[i])) { end = i; break; }
+  }
+  const known = lines.slice(start + 1, end).join('\n');
+  assert.match(known, /session split/, `Known issues name the session split: ${JSON.stringify(known)}`);
+});