feat(work): add ISO timestamps + auto-bump on staged work-doc changes

- New scripts/work/bump-updated-timestamps.mjs stamps the `updated:`
  frontmatter field to the current ISO 8601 UTC timestamp on every
  staged docs/work/**/*.md file. Idempotent; adds the field after
  `created:` if missing.
- .husky/pre-commit invokes the bump script as step 2 (before
  rebuild-state) so _state.json sees the fresh timestamp.
- Backfill all existing work docs (4 PRDs + 3 epics + 21 stories):
    * created: promoted from \`YYYY-MM-DD\` -> ISO timestamp using
      git log --diff-filter=A on each file (first-commit date for
      stories that had no \`created:\` line, midnight UTC for PRDs
      and epics that had date-only created).
    * updated: added from \`git log -1 --format=%aI\` on each file
      (last-commit timestamp); will be re-stamped to "now" by the
      pre-commit hook on this commit.

Stories that had no \`created:\` line now get one.

.husky/pre-commit

@@ -6,7 +6,10 @@
 # 1. lint-staged: format + lint staged files
 pnpm exec lint-staged || exit 1
 
-# 2. If any docs/work/ markdown is staged, regenerate _state.json + re-stage it
+# 2. Stamp the `updated:` frontmatter field on every staged docs/work/ md file.
+node scripts/work/bump-updated-timestamps.mjs || exit 1
+
+# 3. If any docs/work/ markdown is staged, regenerate _state.json + re-stage it
 if git diff --cached --name-only | grep -qE '^docs/work/.*\.md$'; then
   pnpm work rebuild-state
   git add docs/work/_state.json

docs/work/2026-05-13-binder-wrap-helper/01-wire-use-case-helper/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: core-shared
 depends-on: []
 blocks: [02-migrate-feature-binders, 03-update-generator-templates]
+created: 2026-05-13T19:17:10+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-13-binder-wrap-helper/02-migrate-feature-binders/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: auth, blog, media, marketing-pages, navigation
 depends-on: [01-wire-use-case-helper]
 blocks: []
+created: 2026-05-13T19:17:10+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-13-binder-wrap-helper/03-update-generator-templates/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: core-shared
 depends-on: [01-wire-use-case-helper]
 blocks: []
+created: 2026-05-13T19:17:10+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-13-binder-wrap-helper/_epic.md

@@ -5,7 +5,8 @@ title: Collapse binder duplication via wireUseCase helper
 type: epic
 status: done
 features: [core-shared, auth, blog, media, marketing-pages, navigation]
-created: 2026-05-13
+created: 2026-05-13T00:00:00Z
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/01-trace-schema-extensions/_story.md

@@ -12,6 +12,8 @@ blocks:
     04-major-bump-reevaluation,
     05-trace-revalidation-workflow,
   ]
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/02-socket-integration/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: [01-trace-schema-extensions]
 blocks: [08-reviewer-prompt-update]
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/03-renovate-adoption/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: []
 blocks: [09-ci-security-guide-and-docs]
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/04-major-bump-reevaluation/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: scripts
 depends-on: [01-trace-schema-extensions]
 blocks: [05-trace-revalidation-workflow]
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/05-trace-revalidation-workflow/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: scripts
 depends-on: [01-trace-schema-extensions, 04-major-bump-reevaluation]
 blocks: [09-ci-security-guide-and-docs]
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/06-codeql-and-audit-signatures/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: []
 blocks: [08-reviewer-prompt-update]
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/07-gitleaks-precommit/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: []
 blocks: [09-ci-security-guide-and-docs]
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/08-reviewer-prompt-update/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: [02-socket-integration, 06-codeql-and-audit-signatures]
 blocks: [09-ci-security-guide-and-docs]
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/09-ci-security-guide-and-docs/_story.md

@@ -17,6 +17,8 @@ depends-on:
     08-reviewer-prompt-update,
   ]
 blocks: []
+created: 2026-05-14T18:59:12+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-ci-security-and-supply-chain/_epic.md

@@ -5,7 +5,8 @@ title: CI security + supply-chain enforcement stack
 type: epic
 status: done
 features: [scripts, tooling, docs]
-created: 2026-05-14
+created: 2026-05-14T00:00:00Z
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/01-trace-schema-foundation/_story.md

@@ -13,6 +13,8 @@ blocks:
     07-generator-pre-shipped-traces,
     08-backfill-traces,
   ]
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/02-pre-commit-check-script/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: scripts
 depends-on: [01-trace-schema-foundation]
 blocks: [06-sandcastle-reviewer-prompt]
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/03-claude-hooks/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: []
 blocks: []
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/04-evaluate-library-skill/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: [01-trace-schema-foundation]
 blocks: [05-human-guide]
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/05-human-guide/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: docs
 depends-on: [04-evaluate-library-skill]
 blocks: [09-claude-md-update]
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/06-sandcastle-reviewer-prompt/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: [02-pre-commit-check-script]
 blocks: []
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/07-generator-pre-shipped-traces/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: tooling
 depends-on: [01-trace-schema-foundation]
 blocks: []
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/08-backfill-traces/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: docs
 depends-on: [01-trace-schema-foundation]
 blocks: []
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/09-claude-md-update/_story.md

@@ -7,6 +7,8 @@ status: done
 feature: docs
 depends-on: [05-human-guide]
 blocks: []
+created: 2026-05-14T06:52:02+02:00
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/2026-05-14-library-evaluation-policy/_epic.md

@@ -5,7 +5,8 @@ title: Library evaluation policy — skill, traces, enforcement stack
 type: epic
 status: done
 features: [scripts, tooling, docs]
-created: 2026-05-14
+created: 2026-05-14T00:00:00Z
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Goal

docs/work/_state.json

@@ -1,5 +1,5 @@
 {
-  "updated_at": "2026-05-14T19:05:08.479Z",
+  "updated_at": "2026-05-14T19:10:35.823Z",
   "epics": {
     "2026-05-13-binder-wrap-helper": {
       "status": "done",

docs/work/prds/2026-05-13-binder-wrap-helper.prd.md

@@ -5,7 +5,8 @@ type: prd
 status: approved
 author: danijel
 elicitation-session: improve-codebase-architecture-2026-05-13
-created: 2026-05-13
+created: 2026-05-13T00:00:00Z
+updated: 2026-05-14T19:10:35.370Z
 ---
 
 ## Problem

docs/work/prds/2026-05-13-coverage-architecture.prd.md

@@ -5,7 +5,8 @@ type: prd
 status: shipped
 author: danijel
 elicitation-session: brainstorm-2026-05-13
-created: 2026-05-13
+created: 2026-05-13T00:00:00Z
+updated: 2026-05-14T19:10:35.370Z
 shipped: 2026-05-13
 shipping-commits:
   - 7eb783a (PRD)

docs/work/prds/2026-05-14-ci-security-and-supply-chain.prd.md

@@ -4,7 +4,8 @@ title: CI security + supply-chain enforcement stack
 type: prd
 status: approved
 author: danijel
-created: 2026-05-14
+created: 2026-05-14T00:00:00Z
+updated: 2026-05-14T19:10:35.370Z
 adr: adr-023
 builds-on: 2026-05-14-library-evaluation-policy
 ---

docs/work/prds/2026-05-14-library-evaluation-policy.prd.md

@@ -4,7 +4,8 @@ title: Library evaluation policy — skill, traces, enforcement stack
 type: prd
 status: approved
 author: danijel
-created: 2026-05-14
+created: 2026-05-14T00:00:00Z
+updated: 2026-05-14T19:10:35.370Z
 adr: adr-022
 ---
 

scripts/work/bump-updated-timestamps.mjs

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * Stamp every staged `docs/work/**\/*.md` file's frontmatter `updated:` field
+ * to the current ISO 8601 timestamp. Runs from `.husky/pre-commit` before
+ * `pnpm work rebuild-state`, so `_state.json` sees the fresh value.
+ *
+ * Idempotent: re-running produces the same result. The script silently no-ops
+ * on files without frontmatter or without an `updated:` line to replace —
+ * adds the field after `created:` if missing.
+ *
+ * Only stamps files explicitly listed in the staged diff; never walks the
+ * tree. That way the timestamp tracks "the last commit that actually
+ * modified the file," not "the last commit period."
+ */
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+
+const REPO_ROOT = execSync("git rev-parse --show-toplevel", {
+  encoding: "utf8",
+}).trim();
+
+function stagedWorkDocs() {
+  const out = execSync("git diff --cached --name-only --diff-filter=ACMR", {
+    cwd: REPO_ROOT,
+    encoding: "utf8",
+  });
+  return out
+    .split("\n")
+    .map((p) => p.trim())
+    .filter(
+      (p) =>
+        p.startsWith("docs/work/") &&
+        p.endsWith(".md") &&
+        !p.endsWith("README.md"),
+    );
+}
+
+function stampUpdated(content, isoNow) {
+  const fmMatch = content.match(/^(---\n)([\s\S]+?)(\n---)/);
+  if (!fmMatch) return content;
+  const [full, openDelim, body, closeDelim] = fmMatch;
+
+  let newBody;
+  if (/^updated:\s*/m.test(body)) {
+    newBody = body.replace(/^updated:\s*.*$/m, `updated: ${isoNow}`);
+  } else if (/^created:\s*/m.test(body)) {
+    // Insert `updated:` immediately after the `created:` line.
+    newBody = body.replace(/^(created:\s*.*)$/m, `$1\nupdated: ${isoNow}`);
+  } else {
+    return content;
+  }
+  return content.replace(full, `${openDelim}${newBody}${closeDelim}`);
+}
+
+function main() {
+  const files = stagedWorkDocs();
+  if (files.length === 0) return;
+  const isoNow = new Date().toISOString();
+  let touched = 0;
+  for (const rel of files) {
+    const abs = path.join(REPO_ROOT, rel);
+    if (!fs.existsSync(abs)) continue;
+    const original = fs.readFileSync(abs, "utf8");
+    const next = stampUpdated(original, isoNow);
+    if (next === original) continue;
+    fs.writeFileSync(abs, next);
+    execSync(`git add ${JSON.stringify(rel)}`, { cwd: REPO_ROOT });
+    touched++;
+  }
+  if (touched > 0) {
+    console.log(
+      `bump-updated-timestamps: stamped ${touched} file(s) at ${isoNow}`,
+    );
+  }
+}
+
+main();