@bendyline/gilde 0.1.39 → 0.1.41

package/authoring/tactical/evals/refactor-module.json

@@ -0,0 +1,241 @@
+{
+  "schemaVersion": 1,
+  "title": "Behavior-preserving extraction of duplicated logic",
+  "objective": "The craftbook drives a disciplined refactor of copy-pasted name-normalization logic: a green baseline recorded before anything moves, reversible stages with the suite green throughout, a re-measured duplication target, and an enforced review — verified mechanically via a reference matrix across both call sites, a duplication count across src/, and a green-suite run.",
+  "tags": [
+    "code",
+    "refactor",
+    "tactical-fleet"
+  ],
+  "prompt": "Use the Behavior-Preserving Refactor craftbook for this: the same name-normalization logic is copy-pasted in src/format-name.js and src/report.js, and the copies have drifted once already. The brief is in source/refactor-brief.md. Extract the shared logic into a new src/normalize-name.js used by both files, without changing behavior.",
+  "setup": {
+    "projectName": "Crewlog",
+    "about": "A tiny crew-hours logging module. Tests run with `npm run test` (node --test).",
+    "files": [
+      {
+        "path": "package.json",
+        "content": "{\n  \"name\": \"crewlog\",\n  \"private\": true,\n  \"version\": \"1.0.0\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"test\": \"node --test\"\n  }\n}\n"
+      },
+      {
+        "path": "src/format-name.js",
+        "content": "export function formatName(raw) {\n  const words = String(raw).trim().split(/\\s+/);\n  const fixed = [];\n  for (const word of words) {\n    fixed.push(word.charAt(0).toUpperCase() + word.slice(1).toLowerCase());\n  }\n  return fixed.join(' ');\n}\n"
+      },
+      {
+        "path": "src/report.js",
+        "content": "function titleCaseName(raw) {\n  const words = String(raw).trim().split(/\\s+/);\n  const fixed = [];\n  for (const word of words) {\n    fixed.push(word.charAt(0).toUpperCase() + word.slice(1).toLowerCase());\n  }\n  return fixed.join(' ');\n}\n\nexport function reportLine(entry) {\n  return titleCaseName(entry.name) + ': ' + entry.hours + 'h';\n}\n\nexport function reportSummary(entries) {\n  return entries.map((entry) => reportLine(entry)).join('\\n');\n}\n"
+      },
+      {
+        "path": "tests/format.test.mjs",
+        "content": "import assert from 'node:assert/strict';\nimport { test } from 'node:test';\nimport { formatName } from '../src/format-name.js';\n\ntest('formats a messy name', () => {\n  assert.equal(formatName('  ada   lovelace '), 'Ada Lovelace');\n});\n"
+      },
+      {
+        "path": "tests/report.test.mjs",
+        "content": "import assert from 'node:assert/strict';\nimport { test } from 'node:test';\nimport { reportLine } from '../src/report.js';\n\ntest('report line normalizes the name', () => {\n  assert.equal(reportLine({ name: 'grace hopper', hours: 2 }), 'Grace Hopper: 2h');\n});\n"
+      },
+      {
+        "path": "source/refactor-brief.md",
+        "content": "# Refactor brief\n\nThe same name-normalization logic (trim, collapse inner whitespace, title-case each word) is copy-pasted in two places:\n\n- src/format-name.js - `formatName`, used by the profile screens\n- src/report.js - a private `titleCaseName` helper feeding `reportLine`\n\nThe copies drifted once before and had to be manually re-synced. Extract the shared logic into a NEW `src/normalize-name.js` module used by both files, WITHOUT changing behavior. Every output must stay byte-for-byte identical, including edge cases: extra inner spaces, ALL-CAPS input, single letters, and the empty string. Public exports must survive unchanged: `formatName`, `reportLine`, and `reportSummary` keep their names and signatures.\n"
+      },
+      {
+        "path": "tests/verify-refactor.mjs",
+        "surface": "harness",
+        "content": "import assert from 'node:assert/strict';\nimport { execFileSync } from 'node:child_process';\nimport { readFileSync, readdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { formatName } from '../src/format-name.js';\nimport { reportLine, reportSummary } from '../src/report.js';\n\n// 1) Behavior: a reference matrix across BOTH call sites, quirks included.\nconst matrix = [\n  ['  ada   lovelace ', 'Ada Lovelace'],\n  ['GRACE HOPPER', 'Grace Hopper'],\n  ['katherine  g.  johnson', 'Katherine G. Johnson'],\n  ['a', 'A'],\n  ['', ''],\n];\nfor (const [input, expected] of matrix) {\n  assert.equal(formatName(input), expected, 'formatName(' + JSON.stringify(input) + ')');\n}\nassert.equal(reportLine({ name: '  grace   HOPPER ', hours: 4 }), 'Grace Hopper: 4h');\nassert.equal(reportLine({ name: 'ada lovelace', hours: 2 }), 'Ada Lovelace: 2h');\nassert.equal(\n  reportSummary([\n    { name: 'ADA   LOVELACE', hours: 1 },\n    { name: ' mary jackson ', hours: 3 },\n  ]),\n  'Ada Lovelace: 1h\\nMary Jackson: 3h',\n);\nconsole.log('REFACTOR_MODULE_ORACLE behavior ok');\n\n// 2) Deduplication: the title-case implementation exists at most once\n// across src/ - two surviving copies mean the extraction did not happen.\nconst root = process.cwd();\nfunction countMarker(relDir) {\n  let count = 0;\n  for (const entry of readdirSync(join(root, relDir), { withFileTypes: true })) {\n    const relPath = relDir + '/' + entry.name;\n    if (entry.isDirectory()) {\n      count += countMarker(relPath);\n    } else if (/\\.(js|mjs|cjs|ts)$/.test(entry.name)) {\n      const text = readFileSync(join(root, relPath), 'utf8');\n      count += (text.match(/toUpperCase/g) ?? []).length;\n    }\n  }\n  return count;\n}\nconst occurrences = countMarker('src');\nassert.ok(\n  occurrences <= 1,\n  'the title-case implementation appears ' + occurrences + ' times across src/ - the duplication was not extracted to one shared place',\n);\nconsole.log('REFACTOR_MODULE_ORACLE dedupe ok');\n\n// 3) The whole suite is green on the refactored tree (real run).\nfunction runSuite(cwd) {\n  try {\n    execFileSync(process.execPath, ['--test'], { cwd, stdio: 'pipe', timeout: 30000 });\n    return 0;\n  } catch (err) {\n    return typeof err.status === 'number' ? err.status : 1;\n  }\n}\nassert.equal(runSuite(root), 0, 'the suite must be green on the refactored tree');\nconsole.log('REFACTOR_MODULE_ORACLE suite green');\nconsole.log('REFACTOR_MODULE_ORACLE done');\n"
+      }
+    ],
+    "craftbookParams": {
+      "workPath": "tasks/eval",
+      "scope": "Extract the duplicated name normalization in src/format-name.js and src/report.js into a shared src/normalize-name.js used by both, without changing behavior; see source/refactor-brief.md."
+    }
+  },
+  "success": {
+    "summary": "The duplicated normalization lives in exactly one place, both call sites behave byte-for-byte as before (reference matrix), the suite is green on a real run, and every fleet artifact exists with honest citations.",
+    "deliverables": [
+      {
+        "path": "tasks/eval/baseline.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 500,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/baseline.md",
+            "pattern": "^##\\s+Current behavior[\\s\\S]*^##\\s+Measurements[\\s\\S]*^##\\s+Guardrail",
+            "flags": "im",
+            "label": "baseline sections in order"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "tasks/eval/baseline.md",
+            "minCitations": 2,
+            "artifact": true
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/plan.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 500,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/plan.md",
+            "pattern": "^##\\s+Target[\\s\\S]*^##\\s+Stages[\\s\\S]*^##\\s+Acceptance criteria",
+            "flags": "im",
+            "label": "plan sections in order"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "tasks/eval/plan.md",
+            "minCitations": 2,
+            "artifact": true
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/change-notes.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 600,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/change-notes.md",
+            "pattern": "^##\\s+Stages executed[\\s\\S]*^##\\s+Files touched[\\s\\S]*^##\\s+Deviations from plan",
+            "flags": "im",
+            "label": "change-notes sections in order"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "tasks/eval/change-notes.md",
+            "minCitations": 2,
+            "artifact": true
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/verification.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 400,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/verification.md",
+            "pattern": "^##\\s+Before\\s*/\\s*after[\\s\\S]*^##\\s+Suite[\\s\\S]*^##\\s+Result",
+            "flags": "im",
+            "label": "verification sections in order"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/verification.md",
+            "pattern": "^##\\s+Before\\s*/\\s*after[\\s\\S]*\\d",
+            "flags": "im",
+            "label": "before/after figures quoted"
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/review.md",
+        "kind": "markdown-report",
+        "artifact": true,
+        "minBytes": 400,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/review.md",
+            "pattern": "Verdict:\\s*(?:PASS|REVISE)",
+            "flags": "i",
+            "label": "explicit reviewer verdict"
+          }
+        ]
+      }
+    ],
+    "checks": [
+      {
+        "kind": "notContains",
+        "file": "src/format-name.js",
+        "pattern": "toUpperCase",
+        "label": "format-name.js no longer carries its own title-case copy"
+      },
+      {
+        "kind": "notContains",
+        "file": "src/report.js",
+        "pattern": "toUpperCase",
+        "label": "report.js no longer carries its own title-case copy"
+      },
+      {
+        "kind": "sourceParses",
+        "file": "src/format-name.js"
+      },
+      {
+        "kind": "sourceParses",
+        "file": "src/report.js"
+      },
+      {
+        "kind": "nodeScriptPasses",
+        "script": "tests/verify-refactor.mjs",
+        "timeoutMs": 60000,
+        "requiredOutput": [
+          {
+            "pattern": "REFACTOR_MODULE_ORACLE behavior ok",
+            "label": "both call sites match the reference matrix"
+          },
+          {
+            "pattern": "REFACTOR_MODULE_ORACLE dedupe ok",
+            "label": "the implementation exists at most once across src/"
+          },
+          {
+            "pattern": "REFACTOR_MODULE_ORACLE suite green",
+            "label": "suite green on the refactored tree"
+          }
+        ]
+      }
+    ],
+    "taskNotes": {
+      "minBytes": 120,
+      "checks": [
+        {
+          "kind": "contains",
+          "file": "task-notes.md",
+          "pattern": "\\bDONE\\b[\\s\\S]*(npm\\s+run\\s+test|node\\s+--test)",
+          "flags": "i",
+          "label": "DONE note names the real test command"
+        }
+      ]
+    },
+    "taskGraph": {
+      "requireCraftbookTask": true,
+      "requireTerminalStep": true
+    },
+    "unchangedFixtures": [
+      "source/refactor-brief.md",
+      "package.json"
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "tasks/eval/change-notes.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "Guardrail-first discipline",
+        "description": "The suite was genuinely run and recorded green before any restructuring, characterization coverage was considered honestly, and the baseline counted the duplication with a stated method."
+      },
+      {
+        "name": "Reversible-stage execution",
+        "description": "The restructure happened in small planned stages at the real sites, with the suite kept green between stages and deviations recorded honestly rather than papered over."
+      },
+      {
+        "name": "Genuine deduplication",
+        "description": "One shared implementation remains, both call sites use it, public exports survived unchanged, and no behavior change was smuggled in under cover of the refactor."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "green-before/green-after receipts",
+    "same-method re-measurement",
+    "enforced review loop"
+  ]
+}

package/authoring/tactical/evals/schema-migration.json

@@ -0,0 +1,225 @@
+{
+  "schemaVersion": 1,
+  "title": "Expand/contract data migration with no record stranded",
+  "objective": "The craftbook drives an expand/contract migration of a JSON user store from a flat name field to a nested profile shape: a plan grounded in the real files, accessors changed at their real sites with the suite green between stages, the data transformed with every value surviving exactly, and the old shape fully retired - verified mechanically, including a pure-nested-record probe proving the dual-read did not linger.",
+  "tags": [
+    "code",
+    "schema-migration",
+    "expand-contract",
+    "tactical-fleet"
+  ],
+  "prompt": "Use the Schema / Type Migration craftbook for this: migrate our user records from the flat name field to the nested profile shape described in source/migration-brief.md. No record may be lost, the accessors in src/users.js must keep working at every stage, and when it is done nothing may read the flat field any more.",
+  "setup": {
+    "projectName": "Crew Roster",
+    "about": "A tiny user-roster module backed by a JSON data file. Tests run with `npm run test` (node --test).",
+    "files": [
+      {
+        "path": "package.json",
+        "content": "{\n  \"name\": \"crew-roster\",\n  \"private\": true,\n  \"version\": \"1.0.0\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"test\": \"node --test\"\n  }\n}\n"
+      },
+      {
+        "path": "data/users.json",
+        "content": "[\n  { \"id\": 1, \"name\": \"Ada Lovelace\", \"email\": \"ada@example.com\" },\n  { \"id\": 2, \"name\": \"Grace Hopper\", \"email\": \"grace@example.com\" },\n  { \"id\": 3, \"name\": \"Annie Easley\", \"email\": \"annie@example.com\" }\n]\n"
+      },
+      {
+        "path": "src/users.js",
+        "content": "import { readFileSync } from 'node:fs';\n\nconst DB_URL = new URL('../data/users.json', import.meta.url);\n\nexport function loadUsers() {\n  return JSON.parse(readFileSync(DB_URL, 'utf8'));\n}\n\nexport function fullName(user) {\n  return user.name;\n}\n\nexport function byFullName(users, wanted) {\n  return users.find((user) => user.name === wanted);\n}\n"
+      },
+      {
+        "path": "tests/users.test.mjs",
+        "content": "import assert from 'node:assert/strict';\nimport { test } from 'node:test';\nimport { byFullName, fullName, loadUsers } from '../src/users.js';\n\ntest('loads every user record', () => {\n  assert.equal(loadUsers().length, 3);\n});\n\ntest('fullName renders the display name', () => {\n  assert.deepEqual(loadUsers().map(fullName), [\n    'Ada Lovelace',\n    'Grace Hopper',\n    'Annie Easley',\n  ]);\n});\n\ntest('byFullName finds a user by display name', () => {\n  assert.equal(byFullName(loadUsers(), 'Grace Hopper').email, 'grace@example.com');\n});\n"
+      },
+      {
+        "path": "source/migration-brief.md",
+        "content": "# Migration brief: nested profile shape\n\nWe sort and filter by last name now, so the flat `name` field has to go.\n\nCurrent record shape in `data/users.json`:\n\n    { \"id\": 1, \"name\": \"Ada Lovelace\", \"email\": \"ada@example.com\" }\n\nTarget record shape:\n\n    { \"id\": 1, \"profile\": { \"first\": \"Ada\", \"last\": \"Lovelace\" }, \"email\": \"ada@example.com\" }\n\nRules:\n\n- Every existing record must survive the migration exactly - same people, same\n  emails, names split on the single space between first and last name.\n- The accessors in `src/users.js` must keep working for their callers at every\n  stage: `fullName` and `byFullName` keep returning the same display names as\n  today.\n- When the migration is done, nothing reads the flat `name` field any more.\n"
+      },
+      {
+        "path": "tests/verify-migration.mjs",
+        "surface": "harness",
+        "content": "import assert from 'node:assert/strict';\nimport { execFileSync } from 'node:child_process';\nimport { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nconst root = process.cwd();\n\n// 1) The data moved to the target shape with no record stranded.\nconst records = JSON.parse(readFileSync(join(root, 'data/users.json'), 'utf8'));\nassert.ok(Array.isArray(records), 'data/users.json must stay a JSON array');\nassert.equal(records.length, 3, 'all three records must survive the migration');\nconst expected = new Map([\n  ['ada@example.com', ['Ada', 'Lovelace']],\n  ['grace@example.com', ['Grace', 'Hopper']],\n  ['annie@example.com', ['Annie', 'Easley']],\n]);\nfor (const record of records) {\n  assert.ok(record && typeof record === 'object', 'each record must stay an object');\n  assert.ok(!('name' in record), `record ${record.id} still carries the flat name field`);\n  const want = expected.get(record.email);\n  assert.ok(want, `record ${record.id} lost or changed its email`);\n  assert.equal(record.profile?.first, want[0], `record ${record.id} must keep its first name exactly`);\n  assert.equal(record.profile?.last, want[1], `record ${record.id} must keep its last name exactly`);\n}\nconsole.log('SCHEMAMIG_ORACLE data intact');\n\n// 2) The accessors read the new shape - a pure nested record, no flat fallback.\nconst users = await import(pathToFileURL(join(root, 'src/users.js')).href);\nassert.equal(\n  users.fullName({ profile: { first: 'Test', last: 'User' } }),\n  'Test User',\n  'fullName must read profile.first and profile.last',\n);\nassert.equal(\n  users.byFullName([{ profile: { first: 'Grace', last: 'Hopper' }, email: 'x' }], 'Grace Hopper')?.email,\n  'x',\n  'byFullName must match display names on the new shape',\n);\nconsole.log('SCHEMAMIG_ORACLE accessors migrated');\n\n// 3) Contract landed: no flat-shape read remains in the accessor module.\nconst accessorSource = readFileSync(join(root, 'src/users.js'), 'utf8');\nassert.ok(\n  !/\\.name\\b|\\[[\"']name[\"']\\]/.test(accessorSource),\n  'src/users.js still reads the flat name field',\n);\nconsole.log('SCHEMAMIG_ORACLE contract complete');\n\n// 4) The suite is green on the migrated tree, and the seeded test file survives.\nreadFileSync(join(root, 'tests/users.test.mjs'));\nfunction runSuite(cwd) {\n  try {\n    execFileSync(process.execPath, ['--test'], { cwd, stdio: 'pipe', timeout: 30000 });\n    return 0;\n  } catch (err) {\n    return typeof err.status === 'number' ? err.status : 1;\n  }\n}\nassert.equal(runSuite(root), 0, 'the suite must be green after the migration');\nconsole.log('SCHEMAMIG_ORACLE suite green');\nconsole.log('SCHEMAMIG_ORACLE done');\n"
+      }
+    ],
+    "craftbookParams": {
+      "workPath": "tasks/eval",
+      "scope": "Migrate data/users.json and src/users.js from the flat name field to profile.first/profile.last per source/migration-brief.md, with no record loss and reads working at every stage."
+    }
+  },
+  "success": {
+    "summary": "Every record reaches the nested profile shape with its values intact, the accessors read the new shape with the dual-read retired, the flat field is gone from data and code, the suite is green, and every fleet artifact exists with honest receipts.",
+    "deliverables": [
+      {
+        "path": "tasks/eval/migration-plan.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 700,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/migration-plan.md",
+            "pattern": "^##\\s+Current shape[\\s\\S]*^##\\s+Target shape[\\s\\S]*^##\\s+Stages[\\s\\S]*^##\\s+Data safety[\\s\\S]*^##\\s+Rollback per stage",
+            "flags": "im",
+            "label": "plan sections in order"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/migration-plan.md",
+            "pattern": "data/users\\.json",
+            "label": "names the real data file"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "tasks/eval/migration-plan.md",
+            "minCitations": 2,
+            "artifact": true
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/change-notes.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 700,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/change-notes.md",
+            "pattern": "^##\\s+Stages executed[\\s\\S]*^##\\s+Files touched[\\s\\S]*^##\\s+Data transformed[\\s\\S]*^##\\s+Deviations",
+            "flags": "im",
+            "label": "change-notes sections in order"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "tasks/eval/change-notes.md",
+            "minCitations": 2,
+            "artifact": true
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/verification.md",
+        "kind": "markdown-notes",
+        "artifact": true,
+        "minBytes": 500,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/verification.md",
+            "pattern": "^##\\s+Old shape check[\\s\\S]*^##\\s+Data integrity[\\s\\S]*^##\\s+Suite[\\s\\S]*^##\\s+Result",
+            "flags": "im",
+            "label": "verification sections in order"
+          }
+        ]
+      },
+      {
+        "path": "tasks/eval/review.md",
+        "kind": "markdown-report",
+        "artifact": true,
+        "minBytes": 400,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/review.md",
+            "pattern": "Verdict:\\s*(?:PASS|REVISE)",
+            "flags": "i",
+            "label": "explicit reviewer verdict"
+          }
+        ]
+      }
+    ],
+    "checks": [
+      {
+        "kind": "notContains",
+        "file": "data/users.json",
+        "pattern": "\"name\"\\s*:",
+        "label": "the flat name field is gone from the data"
+      },
+      {
+        "kind": "notContains",
+        "file": "src/users.js",
+        "pattern": "\\.name\\b|\\[[\"']name[\"']\\]",
+        "label": "no flat-shape read remains in the accessors"
+      },
+      {
+        "kind": "sourceParses",
+        "file": "src/users.js"
+      },
+      {
+        "kind": "sniff",
+        "file": "data/users.json",
+        "sniff": "json-valid"
+      },
+      {
+        "kind": "nodeRuns",
+        "file": "tests/users.test.mjs"
+      },
+      {
+        "kind": "nodeScriptPasses",
+        "script": "tests/verify-migration.mjs",
+        "timeoutMs": 60000,
+        "requiredOutput": [
+          {
+            "pattern": "SCHEMAMIG_ORACLE data intact",
+            "label": "every record migrated with values intact"
+          },
+          {
+            "pattern": "SCHEMAMIG_ORACLE accessors migrated",
+            "label": "accessors read the new shape"
+          },
+          {
+            "pattern": "SCHEMAMIG_ORACLE contract complete",
+            "label": "the dual-read retired with the old shape"
+          },
+          {
+            "pattern": "SCHEMAMIG_ORACLE suite green",
+            "label": "suite green on the migrated tree"
+          }
+        ]
+      }
+    ],
+    "taskNotes": {
+      "minBytes": 120,
+      "checks": [
+        {
+          "kind": "contains",
+          "file": "task-notes.md",
+          "pattern": "\\bDONE\\b[\\s\\S]*(npm\\s+run\\s+test|node\\s+--test)",
+          "flags": "i",
+          "label": "DONE note names the real test command"
+        }
+      ]
+    },
+    "taskGraph": {
+      "requireCraftbookTask": true,
+      "requireTerminalStep": true
+    },
+    "unchangedFixtures": [
+      "source/migration-brief.md",
+      "package.json"
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "tasks/eval/change-notes.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "Expand/contract discipline",
+        "description": "The stages genuinely followed expand, migrate, contract in order - readers accepted both shapes while the data moved, and the old shape was dropped only after the transform completed with a green suite."
+      },
+      {
+        "name": "Data preservation",
+        "description": "The transform is real and lossless: every record reached the target shape with names and emails surviving exactly, proven by counts and spot-checks rather than asserted."
+      },
+      {
+        "name": "Honest verification",
+        "description": "Verification searched for leftover old-shape reads, quoted what it found, ran the real suite, and labeled anything unrun as unverified instead of claiming it."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "expand/contract data safety",
+    "no record stranded",
+    "real-site accessor changes"
+  ]
+}