fix(#1205): roadmapper applies phase_id_convention to generated phase IDs (#1215)

* fix(#1205): roadmapper applies phase_id_convention to generated phase IDs

- Add Phase ID Convention section to <phase_identification> block:
  documents sequential (default) vs milestone-prefixed forms, and
  instructs the agent to read phase_id_convention from config.json
- Update <output_formats> to show both header and checklist forms for
  sequential and milestone-prefixed conventions with examples
  (e.g. ### Phase 1-01: Name, - [ ] **Phase 1-01: Name**)
- Add TDD regression test tests/bug-1205-roadmapper-convention.test.cjs
  (5 assertions, confirmed fail-first then pass after fix)
- Update tests/agent-size-baseline.json to reflect legitimate growth
- Add .changeset/brave-otters-leap.md (Fixed, pr:0 placeholder)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore: backfill changeset pr: 1215 for fix/1205

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* test(#1205): move phase_id_convention regression into roadmapper-granularity.test.cjs

lint-regression-test-names rejects new standalone bug-NNNN-*.test.cjs files;
regression cases must live in the owning module's test file.

Move the 5 phase_id_convention assertions (#1205 regression) from the
removed tests/bug-1205-roadmapper-convention.test.cjs into
tests/roadmapper-granularity.test.cjs as a new describe block, alongside
the existing granularity calibration tests. Also update the allow-test-rule
comment to cover both #163 and #1205 surface contracts.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* test(#1205): fix lint-allow-test-rule-refs for roadmapper-granularity

- Add issue ref (see #1205) to allow-test-rule comment in
  tests/roadmapper-granularity.test.cjs so lint-allow-test-rule-refs
  passes (new exemptions require #NNN per ADR-456)
- Prune stale 'source-text-is-the-product' entry from
  scripts/lint-allow-test-rule-refs.allowlist.json (ratchet-down;
  comment now compliant and no longer needs grandfathering)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

tests/agent-size-baseline.json

@@ -26,7 +26,7 @@
   "gsd-planner.md": 48885,
   "gsd-project-researcher.md": 21987,
   "gsd-research-synthesizer.md": 13646,
-  "gsd-roadmapper.md": 19652,
+  "gsd-roadmapper.md": 21774,
   "gsd-security-auditor.md": 6216,
   "gsd-ui-auditor.md": 17152,
   "gsd-ui-checker.md": 11081,

tests/roadmapper-granularity.test.cjs

@@ -1,7 +1,7 @@
-// allow-test-rule: source-text-is-the-product
-// agents/gsd-roadmapper.md is the installed agent — the Granularity Calibration
-// table IS the deployed instruction. Asserting on its text asserts what runs in
-// production. Locks the tightened phase-count buckets from #163.
+// allow-test-rule: runtime-contract-is-the-product agent .md instruction surface see #1205
+// agents/gsd-roadmapper.md is the deployed agent — the Granularity Calibration table
+// AND the phase_id_convention instructions ARE the deployed behavior. Asserting on
+// their prose asserts what runs in production (#163, #1205).
 'use strict';
 
 const { describe, test } = require('node:test');
@@ -26,6 +26,17 @@ function granularitySection(content) {
   return nextHeading === -1 ? rest : rest.slice(0, nextHeading);
 }
 
+// Extract a named XML-tag block (e.g. <phase_identification>…</phase_identification>)
+function extractBlock(content, tag) {
+  const open = `<${tag}>`;
+  const close = `</${tag}>`;
+  const start = content.indexOf(open);
+  const end = content.indexOf(close);
+  assert.ok(start !== -1, `<${tag}> block must exist in agent`);
+  assert.ok(end !== -1, `</${tag}> must close the block`);
+  return content.slice(start + open.length, end);
+}
+
 describe('gsd-roadmapper granularity calibration (#163)', () => {
   const section = granularitySection(readAgent('gsd-roadmapper'));
 
@@ -56,3 +67,51 @@ describe('gsd-roadmapper granularity calibration (#163)', () => {
     );
   });
 });
+
+describe('gsd-roadmapper phase_id_convention support (#1205)', () => {
+  const content = readAgent('gsd-roadmapper');
+
+  test('phase_identification section reads phase_id_convention from config', () => {
+    const section = extractBlock(content, 'phase_identification');
+    assert.ok(
+      section.includes('phase_id_convention'),
+      'phase_identification block must reference phase_id_convention config key'
+    );
+  });
+
+  test('output_formats documents milestone-prefixed header format', () => {
+    const section = extractBlock(content, 'output_formats');
+    assert.ok(
+      section.includes('milestone-prefixed'),
+      'output_formats block must document the milestone-prefixed convention'
+    );
+  });
+
+  test('output_formats shows milestone-prefixed phase header example (e.g. ### Phase 1-01:)', () => {
+    const section = extractBlock(content, 'output_formats');
+    assert.ok(
+      /###\s+Phase\s+\d+-\d{2}:/.test(section),
+      'output_formats must show a milestone-prefixed header example like "### Phase 1-01: Name"'
+    );
+  });
+
+  test('output_formats shows both sequential and milestone-prefixed summary checklist forms', () => {
+    const section = extractBlock(content, 'output_formats');
+    assert.ok(
+      /- \[ \] \*\*Phase \d+:/.test(section),
+      'output_formats must still show sequential summary checklist form "- [ ] **Phase N:"'
+    );
+    assert.ok(
+      /- \[ \] \*\*Phase \d+-\d{2}:/.test(section),
+      'output_formats must show milestone-prefixed checklist form "- [ ] **Phase N-NN:"'
+    );
+  });
+
+  test('phase_identification section falls back to sequential when convention absent or "sequential"', () => {
+    const section = extractBlock(content, 'phase_identification');
+    assert.ok(
+      section.includes('sequential'),
+      'phase_identification block must document that sequential is the default/fallback'
+    );
+  });
+});