test(#2864): add regression test for map-codebase date restamp (#2964)

* test(#2864): add regression test for map-codebase date restamp

The wording fix shipped in #2550 without behavioral coverage, so the instruction could silently revert at any of the six date-stamp sites. This locks all six by reading the two shipped prompt files directly, using a per-file stale regex because the two files phrased the pre-fix instruction differently.

* test(#2864): cover both pre-fix phrasings in the workflow stale guard

The sequential-fallback site phrased the placeholder-only instruction with backticks and "from init context", so the stale-framing regex never matched it and that site's negative guard was dead. Only the site count caught a revert there.

---------

Co-authored-by: Tom Boucher <trekkie@nomorestars.com>

tests/codebase-mapper-date-restamp.test.cjs

@@ -0,0 +1,73 @@
+// allow-test-rule: source-text-is-the-product (see #2279)
+// The gsd-codebase-mapper agent and map-codebase workflow .md files ARE the
+// contract the model loads at runtime. Regression lock for #2279: on an Update
+// run the agent must restamp the codebase-doc dates unconditionally, not merely
+// substitute the [YYYY-MM-DD] placeholder (absent once a doc holds a real date).
+
+const { describe, test } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.join(__dirname, '..');
+const MAPPER = fs.readFileSync(path.join(ROOT, 'agents', 'gsd-codebase-mapper.md'), 'utf-8');
+const WORKFLOW = fs.readFileSync(path.join(ROOT, 'gsd-core', 'workflows', 'map-codebase.md'), 'utf-8');
+
+// The pre-fix framing: substitute-the-placeholder-only, which never fires on an
+// Update run because the placeholder was already replaced by a concrete date.
+// The two files phrased the bug differently, so each needs its own stale regex;
+// a single regex asserted against both silently passes on the file it never
+// matched, leaving that file's negative guard dead. map-codebase.md itself used
+// two pre-fix phrasings (the four per-spawn prompts plain, the sequential
+// fallback backtick-wrapped and carrying "from init context"), so its stale
+// regex has to cover both or the fallback site's guard is dead for the same
+// reason.
+const WORKFLOW_STALE_PLACEHOLDER_ONLY =
+  /Use `?\{date\}`?(?: from init context)? for all `?\[YYYY-MM-DD\]`? date placeholders/;
+const MAPPER_STALE_PLACEHOLDER_ONLY = /Replace `?\[YYYY-MM-DD\]`? with the date/i;
+
+// The fixed framing. Both files say "overwriting <any|whatever> ... date"; the
+// regex stays loose on the object so a future rewording of the tail does not
+// break the lock, while still requiring the overwrite verb the bug lacked.
+const OVERWRITE_INSTRUCTION = /overwrit(?:e|ing)\s+(?:any|whatever)[^.\n]*date/i;
+const WORKFLOW_OVERWRITE_SITE = /overwrit(?:e|ing) any existing date/gi;
+
+describe('map-codebase date restamp (#2279)', () => {
+  test('mapper instructs overwriting an existing date on update runs', () => {
+    assert.match(
+      MAPPER,
+      OVERWRITE_INSTRUCTION,
+      'gsd-codebase-mapper.md must tell the agent to overwrite a prior concrete date, not only fill [YYYY-MM-DD]',
+    );
+  });
+
+  test('workflow reminder requires overwriting an existing date', () => {
+    assert.match(
+      WORKFLOW,
+      OVERWRITE_INSTRUCTION,
+      'map-codebase.md must instruct overwriting an existing date, not only [YYYY-MM-DD] placeholders',
+    );
+  });
+
+  test('no date-instruction site retains the placeholder-only framing', () => {
+    // Every site must carry the overwrite instruction: the per-spawn Agent()
+    // prompts in spawn_agents (the primary path) regressed independently of
+    // the sequential_mapping fallback, so a whole-file "fix appears somewhere"
+    // match is not enough.
+    assert.doesNotMatch(
+      MAPPER,
+      MAPPER_STALE_PLACEHOLDER_ONLY,
+      'gsd-codebase-mapper.md still contains a placeholder-only date instruction',
+    );
+    assert.doesNotMatch(
+      WORKFLOW,
+      WORKFLOW_STALE_PLACEHOLDER_ONLY,
+      'map-codebase.md still contains a placeholder-only date instruction',
+    );
+    const overwriteSites = WORKFLOW.match(WORKFLOW_OVERWRITE_SITE) ?? [];
+    assert.ok(
+      overwriteSites.length >= 5,
+      `expected the overwrite instruction at every date-instruction site in map-codebase.md (4 per-spawn prompts + the sequential fallback), found ${overwriteSites.length}`,
+    );
+  });
+});