@hegemonart/get-design-done 1.39.2 → 1.40.0

package/skills/unlock-decision/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: gdd-unlock-decision
+description: "Reopens a LOCKED design decision — the only escape hatch from the hard lock. Requires an explicit --approver and writes an audit entry, then moves the decision locked → reviewing (via scripts/lib/collab/review-queue.cjs). Previews the audit record before writing; never unlocks silently. Use when a locked decision genuinely must change (a later constraint invalidated it) and a reviewer has signed off."
+argument-hint: "<decision-id> --approver <who> [--reason <text>] [--dry-run]"
+user-invocable: true
+tools: Read, Write, Bash, Grep, Glob
+---
+
+# /gdd:unlock-decision
+
+A `locked` decision is hard — it cannot be amended. This skill is the **only** way back, and it is
+deliberately heavyweight: it requires a named approver and records an audit entry, so reopening a
+locked decision is always traceable. Contract: `../../reference/multi-author-model.md`.
+
+## Invocation
+
+| Command | Behavior |
+|---|---|
+| `/gdd:unlock-decision <id> --approver <who>` | Unlock `<id>` (locked → reviewing), recording the approver. |
+| `/gdd:unlock-decision <id> --approver <who> --reason <text>` | Same, with a reason in the audit entry. |
+| `/gdd:unlock-decision <id> --dry-run` | Preview the audit record + the resulting state; change nothing. |
+
+## Steps
+
+1. **Validate args.** `<decision-id>` required; `--approver` required (a non-empty name). Missing
+   `--approver` → print the usage + exit without changing anything.
+2. **Load the entry** from `.design/reviews/<decision-id>/state.json`. Not found → report it. Not in
+   `locked` state → print `unlock-decision: <id> is not locked (state: <state>); nothing to unlock.`
+3. **Preview.** Show the audit entry that will be appended (`{ action: unlock, from: locked, to:
+   reviewing, approver, reason }`) and the resulting state. If `--dry-run`, stop here.
+4. **Apply** via the pure helper:
+
+   ```bash
+   node -e '
+     const fs = require("fs");
+     const rq = require("./scripts/lib/collab/review-queue.cjs");
+     const p = process.argv[1], approver = process.argv[2], reason = process.argv[3] || "";
+     const entry = JSON.parse(fs.readFileSync(p, "utf8"));
+     const next = rq.unlock(entry, { approver, reason });
+     fs.writeFileSync(p, JSON.stringify(next, null, 2) + "\n");
+     console.log(JSON.stringify(next.audit[next.audit.length - 1]));
+   ' ".design/reviews/<id>/state.json" "<who>" "<reason>"
+   ```
+
+5. **Report** the new state + the recorded approver. The decision is now `reviewing` and amendable
+   again; it must be re-reviewed + re-locked to become durable.
+
+## Output
+
+End with:
+
+```
+## UNLOCK-DECISION COMPLETE
+```

package/skills/update/SKILL.md

@@ -23,6 +23,24 @@ Updates the `get-design-done` plugin to the latest release (or a specific tag),
 
    > Run `/gdd:reapply-patches` if you have customized any `reference/` files to restore your modifications.
 
+7.5. **Deprecation advisory** (Phase 39.5) — load the path-migration registry and report anything that
+   crossed into `deprecated` or `removed` over the `[prevVersion → currentVersion]` window:
+
+   ```bash
+   node -e '
+     const fs = require("fs");
+     const dr = require("./scripts/lib/deprecation-registry.cjs");
+     const entries = dr.parseDeprecations(fs.readFileSync("reference/DEPRECATIONS.md","utf8"));
+     const crossed = entries.filter(e =>
+       dr.classify(e, currentVersion) !== "pending" &&
+       (prevVersion == null || dr.classify(e, prevVersion) !== dr.classify(e, currentVersion)));
+     console.log(JSON.stringify(crossed));
+   '
+   ```
+
+   If any entry crossed, print a `## Deprecations in this update` list (old → new + status) and point
+   the user at **`/gdd:migrate`** to rewrite their local references. If none crossed, say nothing.
+
 8. Print the new version and the changelog URL (`https://github.com/hegemonart/get-design-done/releases`).
 
 ## Output