@bendyline/gilde 0.1.40 → 0.1.41

package/data/craftbook-templates/ro/root-cause-investigation/versions/2.0.5/craftbook.json

@@ -0,0 +1,433 @@
+{
+  "id": "root-cause-investigation",
+  "name": "Root-Cause Investigation",
+  "description": "Debug systematically: reproduce the failure and find the true root cause before changing any code, then fix and verify. Enforces a no-fix-without-diagnosis discipline.",
+  "basedOn": {
+    "name": "gstack",
+    "url": "https://github.com/garrytan/gstack"
+  },
+  "plan": "Reproduce first, diagnose second, change code only after the evidence identifies a root cause. Keep an explicit hypothesis ledger so plausible stories cannot silently become facts. Prefer the smallest experiment that separates competing explanations. The final report must connect symptom, causal mechanism, fix, and regression proof with inspectable paths and command results.",
+  "entryStepId": "reproduce",
+  "triggers": [
+    "debug this",
+    "fix this bug",
+    "why is this broken",
+    "root cause analysis",
+    "investigate this error",
+    "investigate this bug",
+    "root cause this",
+    "why is this failing",
+    "figure out why it breaks",
+    "diagnose this incident",
+    "investigate this",
+    "find the bug",
+    "root cause"
+  ],
+  "command": "root-cause-investigation",
+  "steps": [
+    {
+      "id": "reproduce",
+      "name": "Reproduce and bound the failure",
+      "description": "Establish a stable failing case, expected behavior, environment, and blast radius.",
+      "prompt": "Read the request, relevant code, existing tests, logs, and configuration. Reproduce the problem with the smallest safe case you can run. Record exact inputs, expected and actual results, environment details, frequency, and whether the failure is deterministic. If it cannot be reproduced, document the attempts and the missing observation needed; do not invent a cause or edit production code.\n\nObservable handoff: write the completed result to `investigations/reproduction.md` in the workspace with `write_file`. Do not merely describe what the file would contain. Re-read it with `read_file` before finishing this phase and repair any incomplete sections.",
+      "suggestedRole": "debugging engineer",
+      "advanceWhen": {
+        "file": "investigations/reproduction.md",
+        "minBytes": 700,
+        "sniff": "nonempty",
+        "requireChange": true,
+        "goto": "diagnose"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "investigations/reproduction.md",
+            "bytes": 700
+          },
+          {
+            "kind": "sniff",
+            "file": "investigations/reproduction.md",
+            "sniff": "nonempty"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/reproduction.md",
+            "pattern": "^##\\s+Symptom",
+            "flags": "im",
+            "label": "Symptom section"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/reproduction.md",
+            "pattern": "^##\\s+Minimal reproduction",
+            "flags": "im",
+            "label": "Minimal reproduction section"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/reproduction.md",
+            "pattern": "^##\\s+Expected",
+            "flags": "im",
+            "label": "Expected behavior section"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/reproduction.md",
+            "pattern": "^##\\s+Actual",
+            "flags": "im",
+            "label": "Actual behavior section"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/reproduction.md",
+            "pattern": "^##\\s+Evidence",
+            "flags": "im",
+            "label": "Evidence section"
+          }
+        ],
+        "onReject": "reproduce",
+        "maxAttempts": 3
+      },
+      "next": "diagnose"
+    },
+    {
+      "id": "diagnose",
+      "name": "Prove the root cause",
+      "description": "Test competing hypotheses and identify the causal mechanism before modifying code.",
+      "prompt": "Use `investigations/reproduction.md` to form at least two plausible hypotheses. Trace the relevant execution and data paths with workspace search and file-reading tools. For each hypothesis, run a discriminating experiment and record its predicted versus observed outcome. Name the first bad state or decision, explain how it produces the symptom, and check for sibling cases. Do not change source code in this phase.\n\nObservable handoff: write the completed result to `investigations/root-cause-analysis.md` in the workspace with `write_file`. Do not merely describe what the file would contain. Re-read it with `read_file` before finishing this phase and repair any incomplete sections.",
+      "suggestedRole": "root-cause analyst",
+      "consumes": [
+        {
+          "file": "investigations/reproduction.md"
+        }
+      ],
+      "advanceWhen": {
+        "file": "investigations/root-cause-analysis.md",
+        "minBytes": 1000,
+        "sniff": "nonempty",
+        "requireChange": true,
+        "goto": "fix-and-verify"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "investigations/root-cause-analysis.md",
+            "bytes": 1000
+          },
+          {
+            "kind": "sniff",
+            "file": "investigations/root-cause-analysis.md",
+            "sniff": "nonempty"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/root-cause-analysis.md",
+            "pattern": "^##\\s+Hypotheses",
+            "flags": "im",
+            "label": "Hypotheses section"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/root-cause-analysis.md",
+            "pattern": "^##\\s+Experiments",
+            "flags": "im",
+            "label": "Experiments section"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/root-cause-analysis.md",
+            "pattern": "^##\\s+Root cause",
+            "flags": "im",
+            "label": "Root cause section"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/root-cause-analysis.md",
+            "pattern": "^##\\s+Causal chain",
+            "flags": "im",
+            "label": "Causal chain section"
+          },
+          {
+            "kind": "contains",
+            "file": "investigations/root-cause-analysis.md",
+            "pattern": "^##\\s+Blast radius",
+            "flags": "im",
+            "label": "Blast radius section"
+          }
+        ],
+        "onReject": "diagnose",
+        "maxAttempts": 3
+      },
+      "next": "fix-and-verify"
+    },
+    {
+      "id": "fix-and-verify",
+      "name": "Implement the smallest fix and verify it",
+      "description": "Correct the proven mechanism and demonstrate both regression coverage and non-regression.",
+      "prompt": "Read both investigation files. Implement the smallest maintainable change that breaks the documented causal chain. Add or strengthen a regression test that fails on the old behavior and passes with the fix. Run the focused test, relevant neighboring tests, and any proportionate static checks. Record exact changed paths and exact verification commands with exit results. If the environment prevents a check, label it unverified and explain what is needed to run it.\n\nObservable handoff: write the completed result to `{{workPath}}/reports/root-cause-investigation.md` in the project's artifacts drawer with `write_artifact`. Do not merely describe what the file would contain. Re-read it with `read_artifact` before finishing this phase and repair any incomplete sections.",
+      "suggestedRole": "software engineer",
+      "advanceWhen": {
+        "file": "{{workPath}}/reports/root-cause-investigation.md",
+        "minBytes": 1200,
+        "sniff": "nonempty",
+        "requireChange": true,
+        "artifact": true,
+        "goto": "evaluate"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "bytes": 1200,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Root cause",
+            "flags": "im",
+            "label": "Root cause section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Fix",
+            "flags": "im",
+            "label": "Fix section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Changed files",
+            "flags": "im",
+            "label": "Changed files section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Regression coverage",
+            "flags": "im",
+            "label": "Regression coverage section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Verification",
+            "flags": "im",
+            "label": "Verification section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Rollback",
+            "flags": "im",
+            "label": "Rollback section",
+            "artifact": true
+          }
+        ],
+        "onReject": "fix-and-verify",
+        "maxAttempts": 3
+      },
+      "next": "evaluate"
+    },
+    {
+      "id": "evaluate",
+      "name": "Evaluate the deliverable",
+      "description": "Independently grade the observable deliverable and route it to finish, repair, or user escalation.",
+      "prompt": "Review `{{workPath}}/reports/root-cause-investigation.md`, `investigations/reproduction.md`, `investigations/root-cause-analysis.md` against every criterion below. Inspect the underlying evidence files named by the workflow; do not grade from the author's summary alone.\n\n1. The failure is reproducible or the report explicitly stops without claiming an unproven diagnosis.\n2. Competing hypotheses were separated by recorded experiments rather than intuition.\n3. The stated root cause includes a causal chain from first bad state to observed symptom.\n4. The change is limited to that causal mechanism and covers identified sibling cases.\n5. A regression test and neighboring checks have concrete, credible results with no fabricated execution evidence.\n6. The report identifies changed files, residual risk, and a viable rollback.\n\nOpen `{{workPath}}/reports/root-cause-investigation.md` with `read_artifact`. Open `investigations/reproduction.md`, `investigations/root-cause-analysis.md` with `read_file`. Write the evidence-backed review to `{{workPath}}/reviews/root-cause-investigation-review.md` in the artifacts drawer with `write_artifact`. Give each criterion a PASS or FAIL with a concrete path, excerpt, measurement, or observed behavior. End with exactly `Verdict: PASS` or `Verdict: REVISE`. Then use `advance_task_step` for the active task: PASS routes to `finish`; REVISE routes to `repair` for review rounds 1 through 2, and the 3th REVISE routes to `needs-user`. Never route to finish while a criterion is unmet.",
+      "suggestedRole": "debugging reviewer",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reports/root-cause-investigation.md",
+          "artifact": true
+        },
+        {
+          "file": "investigations/reproduction.md"
+        },
+        {
+          "file": "investigations/root-cause-analysis.md"
+        }
+      ],
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/reviews/root-cause-investigation-review.md",
+            "bytes": 400,
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/root-cause-investigation-review.md",
+            "pattern": "Verdict:\\s*(?:PASS|REVISE)",
+            "flags": "i",
+            "label": "explicit PASS or REVISE verdict",
+            "artifact": true
+          }
+        ],
+        "onReject": "evaluate",
+        "maxAttempts": 3
+      },
+      "next": "repair"
+    },
+    {
+      "id": "repair",
+      "name": "Repair the deliverable",
+      "description": "Fix only the concrete gaps from the latest independent review.",
+      "prompt": "Read `{{workPath}}/reviews/root-cause-investigation-review.md` with `read_artifact` and repair every failed criterion in `{{workPath}}/reports/root-cause-investigation.md`, `investigations/reproduction.md`, `investigations/root-cause-analysis.md`. Make changes on each file's declared surface (`write_artifact` for artifact inputs, `write_file` for workspace inputs), not in task notes or a reply. Preserve evidence that already passed. Re-run or re-check anything the reviewer found unproven. Ensure `{{workPath}}/reports/root-cause-investigation.md` is genuinely updated this turn so the repair is observable, then hand it back for independent evaluation.",
+      "suggestedRole": "software engineer",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reviews/root-cause-investigation-review.md",
+          "artifact": true
+        },
+        {
+          "file": "{{workPath}}/reports/root-cause-investigation.md",
+          "artifact": true
+        },
+        {
+          "file": "investigations/reproduction.md"
+        },
+        {
+          "file": "investigations/root-cause-analysis.md"
+        }
+      ],
+      "advanceWhen": {
+        "file": "{{workPath}}/reports/root-cause-investigation.md",
+        "minBytes": 1200,
+        "sniff": "nonempty",
+        "requireChange": true,
+        "artifact": true,
+        "goto": "evaluate"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "bytes": 1200,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Root cause",
+            "flags": "im",
+            "label": "Root cause section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Fix",
+            "flags": "im",
+            "label": "Fix section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Changed files",
+            "flags": "im",
+            "label": "Changed files section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Regression coverage",
+            "flags": "im",
+            "label": "Regression coverage section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Verification",
+            "flags": "im",
+            "label": "Verification section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reports/root-cause-investigation.md",
+            "pattern": "^##\\s+Rollback",
+            "flags": "im",
+            "label": "Rollback section",
+            "artifact": true
+          }
+        ],
+        "onReject": "repair",
+        "maxAttempts": 3
+      },
+      "next": "evaluate"
+    },
+    {
+      "id": "finish",
+      "name": "Finish",
+      "description": "All deterministic and reviewer criteria passed.",
+      "prompt": "The independent review passed. Read `{{workPath}}/reviews/root-cause-investigation-review.md` with `read_artifact`, then use `write_task_note` to record a concise DONE summary with the final deliverable paths (`{{workPath}}/reports/root-cause-investigation.md`, `investigations/reproduction.md`, `investigations/root-cause-analysis.md`) and the evidence that each acceptance criterion passed. Report DONE without starting new work.",
+      "suggestedRole": "project lead",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reviews/root-cause-investigation-review.md",
+          "artifact": true
+        }
+      ],
+      "terminal": true
+    },
+    {
+      "id": "needs-user",
+      "name": "Escalate unresolved concerns",
+      "description": "The bounded repair loop ended without a defensible pass.",
+      "prompt": "The deliverable did not pass after 3 review rounds. Do not claim success. Read `{{workPath}}/reviews/root-cause-investigation-review.md` with `read_artifact`, then use `write_task_note` to record DONE_WITH_CONCERNS: the unmet criteria, what was attempted, the affected paths, and the smallest user decision or missing input needed to continue.",
+      "suggestedRole": "project lead",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reviews/root-cause-investigation-review.md",
+          "artifact": true
+        }
+      ],
+      "terminal": true
+    }
+  ],
+  "version": "2.0.5",
+  "releasedAt": "2026-08-24T00:00:00.000Z",
+  "paramSchema": {
+    "type": "object",
+    "properties": {
+      "workPath": {
+        "type": "string",
+        "title": "Working folder",
+        "description": "Per-task working folder in the artifacts drawer. Defaults to this task's own folder so runs never collide; override with a stable name when you deliberately want runs to share files.",
+        "default": "{{task.dir}}"
+      }
+    }
+  },
+  "minGezelVersion": "1.26233"
+}

package/data/craftbook-templates/ro/root-cause-investigation/versions/2.0.5/test.json

@@ -0,0 +1,157 @@
+{
+  "schemaVersion": 1,
+  "title": "Root-Cause Investigation — decimal cart total regression",
+  "objective": "Require the Root-Cause Investigation craftbook to reproduce a deterministic failure, identify the causal mechanism before editing, implement the smallest fix, and prove the regression test passes.",
+  "tags": [
+    "workflow",
+    "debugging",
+    "code-with-tests",
+    "node"
+  ],
+  "prompt": "Use the Root-Cause Investigation craftbook to diagnose the failing decimal cart-total behavior in this workspace. First reproduce it with the existing dependency-free test and preserve concrete evidence; do not edit until a causal hypothesis has been tested. Then make the smallest correct source change, keep the regression coverage, and write the craftbook's artifacts, including `tasks/eval/reports/root-cause-investigation.md`. The final report must cite the files inspected, distinguish root cause from symptom, include the exact verification command and result, and describe a safe rollback.",
+  "setup": {
+    "projectName": "Decimal cart total regression",
+    "about": "A tiny dependency-free Node project with one reproducible arithmetic defect. The initial test is expected to fail.",
+    "missionObjectives": "Restore exact cent-based addition for decimal prices without broad refactoring and leave a passing regression test plus an evidence-backed investigation report.",
+    "files": [
+      {
+        "path": "package.json",
+        "content": "{\n  \"name\": \"cart-total-fixture\",\n  \"private\": true,\n  \"type\": \"module\"\n}\n"
+      },
+      {
+        "path": "src/cart-total.js",
+        "content": "/** Sum display-price strings and return a two-decimal total. */\nexport function cartTotal(prices) {\n  const cents = prices.reduce((sum, price) => sum + parseInt(price, 10) * 100, 0);\n  return (cents / 100).toFixed(2);\n}\n"
+      },
+      {
+        "path": "tests/cart-total.test.mjs",
+        "content": "import test from 'node:test';\nimport assert from 'node:assert/strict';\nimport { cartTotal } from '../src/cart-total.js';\n\ntest('keeps cents when totaling decimal display prices', () => {\n  assert.equal(cartTotal(['19.99', '5.50']), '25.49');\n});\n\ntest('handles a single whole-dollar price', () => {\n  assert.equal(cartTotal(['7.00']), '7.00');\n});\n"
+      },
+      {
+        "path": "source/incident.md",
+        "content": "# Incident note\n\nCheckout preview showed **$24.00** for line items **$19.99** and **$5.50**. The expected total is **$25.49**. The defect appeared after price inputs changed from integer-dollar strings to two-decimal display strings. No production data migration is in scope.\n"
+      },
+      {
+        "path": "tests/verify-cart-total.mjs",
+        "content": "import assert from 'node:assert/strict';\nimport { cartTotal } from '../src/cart-total.js';\n\nconst cases = [\n  [['19.99', '5.50'], '25.49'],\n  [['0.10', '0.20'], '0.30'],\n  [['12.34', '0.66'], '13.00'],\n  [['7.00'], '7.00'],\n  [['1.01', '2.02', '3.03'], '6.06'],\n];\nfor (const [prices, expected] of cases) assert.equal(cartTotal(prices), expected, prices.join(' + '));\nconsole.log('CART_TOTAL_ORACLE_OK 5/5');\n",
+        "surface": "harness"
+      }
+    ],
+    "craftbookParams": {
+      "workPath": "tasks/eval"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "The decimal regression is fixed by a diagnosed causal change, the existing test passes, and the craftbook report preserves reproducible evidence.",
+    "deliverables": [
+      {
+        "path": "tasks/eval/reports/root-cause-investigation.md",
+        "kind": "markdown-report",
+        "artifact": true,
+        "minBytes": 1200,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/reports/root-cause-investigation.md",
+            "pattern": "^#{1,3}\\s+Root cause\\b[\\s\\S]*^#{1,3}\\s+(Fix|Changed files)\\b[\\s\\S]*^#{1,3}\\s+(Regression coverage|Verification)\\b[\\s\\S]*^#{1,3}\\s+Rollback\\b",
+            "flags": "im",
+            "label": "root cause through rollback sections"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/reports/root-cause-investigation.md",
+            "pattern": "parseInt|truncat(?:e|ed|ion)|discard(?:s|ed)?\\s+(?:the\\s+)?(?:decimal|fractional|cent)",
+            "flags": "i",
+            "label": "causal mechanism"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/reports/root-cause-investigation.md",
+            "pattern": "node\\s+--test\\s+tests/cart-total\\.test\\.mjs[\\s\\S]*(pass|2\\s+tests?|exit(?:ed)?\\s+0)",
+            "flags": "i",
+            "label": "verification command and result"
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "tasks/eval/reports/root-cause-investigation.md",
+            "minCitations": 2
+          }
+        ]
+      }
+    ],
+    "checks": [
+      {
+        "kind": "notContains",
+        "file": "src/cart-total.js",
+        "pattern": "\\bparseInt\\s*\\(",
+        "label": "lossy integer parsing removed"
+      },
+      {
+        "kind": "sourceParses",
+        "file": "src/cart-total.js"
+      },
+      {
+        "kind": "nodeRuns",
+        "file": "tests/cart-total.test.mjs",
+        "timeoutMs": 20000
+      },
+      {
+        "kind": "nodeScriptPasses",
+        "script": "tests/verify-cart-total.mjs",
+        "requiredOutput": [
+          {
+            "pattern": "CART_TOTAL_ORACLE_OK 5/5",
+            "label": "hidden multi-case regression oracle"
+          }
+        ]
+      }
+    ],
+    "taskNotes": {
+      "minBytes": 180,
+      "checks": [
+        {
+          "kind": "contains",
+          "file": "task-notes.md",
+          "pattern": "\\bDONE\\b[\\s\\S]*(node\\s+--test|tests/cart-total\\.test\\.mjs)[\\s\\S]*tasks/eval/reports/root-cause-investigation\\.md",
+          "flags": "i",
+          "label": "terminal note records proof and report"
+        }
+      ],
+      "requireCraftbookTask": true
+    },
+    "taskGraph": {
+      "requireCraftbookTask": true,
+      "requireTerminalStep": true
+    },
+    "unchangedFixtures": [
+      "package.json",
+      "tests/cart-total.test.mjs",
+      "source/incident.md"
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "tasks/eval/reports/root-cause-investigation.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "Causal rigor",
+        "description": "The report explains why the observed inputs fail in this implementation and distinguishes causal evidence from guesses."
+      },
+      {
+        "name": "Fix discipline",
+        "description": "The source change is minimal, directly addresses the diagnosed mechanism, and avoids unrelated refactoring."
+      },
+      {
+        "name": "Verification quality",
+        "description": "Reproduction, regression coverage, final command result, blast radius, and rollback are concrete and auditable."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "Diagnosis precedes source edits",
+    "The fix preserves decimal cents and passes the dependency-free test",
+    "The final report cites real workspace files and includes rollback"
+  ]
+}

package/data/craftbook-templates/sc/schema-migration/manifest.json

@@ -5,14 +5,14 @@
   "role": "maintenance-review",
   "category": "code-quality",
   "name": "Schema / Type Migration",
-  "description": "Plan and execute a multi-file schema or type migration safely — changing a data model, type definition, or interface across the codebase while keeping everything compiling and consistent. Plans the migration FIRST — the before/after shape, every call-site and file touched, the ordering that never leaves the tree broken, and the backout — then applies the change file-by-file, then a reviewer verifies the tree still builds and nothing referencing the old shape remains. Covers find-all-references, safe edit ordering, backward-compatibility shims, codemod-style changes, and compile/test-green verification.",
+  "description": "Migrate a schema or data shape with the expand/contract discipline: reads accept both shapes while the data moves, the old shape is dropped only after every record is transformed, and real suite runs between stages prove no record was ever stranded.",
   "tags": [
-    "gallery",
     "migration",
-    "refactor",
     "schema",
     "types",
-    "codemod"
+    "refactor",
+    "codemod",
+    "expand-contract"
   ],
   "maintainer": {
     "name": "Gezel"