Merge pull request #296 from Data-Wise/dev

Release: v4.2.0

Author: Data-Wise

.STATUS

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Full-stack developer toolkit for Claude Code with 48 commands, 2 agents, and 40 skills",
-    "version": "4.1.0"
+    "version": "4.2.0"
   },
   "plugins": [
     {
@@ -16,7 +16,7 @@
         "repo": "Data-Wise/craft"
       },
       "description": "Full-stack developer toolkit for Claude Code with 48 commands, 2 agents, and 40 skills",
-      "version": "4.1.0",
+      "version": "4.2.0",
       "author": {
         "name": "Data-Wise",
         "email": "dt@stat-wise.com"

.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "craft",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "Full-stack developer toolkit with integrated workflow automation - 48 commands, 2 agents, 40 skills with standardized dry-run preview mode (29 with --dry-run support). Code, git, site, docs, testing, architecture, CI, distribution, teaching workflows, planning, release pipeline, and ADHD-friendly features including brainstorming, task management, and spec capture",
   "author": {
     "name": "Data-Wise",

.claude-plugin/plugin.json

@@ -9,6 +9,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [4.2.0] - 2026-07-19
+
+### Changed
+
+- **BREAKING: `/craft:done` renamed to `/craft:finish`** ([ADR-006](docs/adr/ADR-006-done-renamed-to-finish.md))
+  — the session-completion shim moves to a name matching the existing zsh
+  `finish` alias. No backward-compat shim kept; the old `/craft:done` slash
+  entry point no longer resolves. Command count unchanged (48) — this is a
+  rename, not an addition. All live docs, skill references, and tests swept;
+  historical docs (specs, other ADRs, changelog) intentionally left
+  unchanged per this repo's staleness-check exclusion convention.
+
+### Fixed
+
+- `docs/specs/SPEC-craft-restore-2026-07-17.md` and its companion report
+  corrected from `DRAFT` to `SHIPPED` status — `/craft:restore` had already
+  shipped in v4.1.0 when these docs were written.
+
+### Added
+
+- `docs/specs/REPORT-craft-restore-2026-07-17.md` — ADHD-friendly report
+  view of the `/craft:restore` spec.
+
+---
+
 ## [4.1.0] - 2026-07-17
 
 ### Added

CHANGELOG.md

@@ -4,9 +4,9 @@
 
 **48 commands** · **40 skills** · **2 agents** · [Docs](https://data-wise.github.io/craft/) · [GitHub](https://github.com/Data-Wise/craft)
 
-> `orchestrate:drive` — spec-driven autonomous /goal loop · `prompt-refiner` skill + `--refine` flag (7 commands)
+> `orchestrate:drive` — spec-driven autonomous /goal loop · `prompt-refiner` skill + `--refine` flag (7 commands) · `/craft:restore` — combined git+`.STATUS` recap (v4.1.0)
 
-**Current Version:** v4.1.0 | **Tests:** full suite via `python3 -m pytest tests/` · tiers via `/craft:test <unit|e2e|dogfood>`
+**Current Version:** v4.2.0 | **Tests:** full suite via `python3 -m pytest tests/` · tiers via `/craft:test <unit|e2e|dogfood>`
 
 > For project details, see `plugin.json` description and `scripts/validate-counts.sh`
 

CLAUDE.md

@@ -8,7 +8,7 @@
 
 **main:** [![Craft CI](https://github.com/Data-Wise/craft/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Data-Wise/craft/actions/workflows/ci.yml) [![Deploy Docs](https://github.com/Data-Wise/craft/actions/workflows/docs.yml/badge.svg)](https://github.com/Data-Wise/craft/actions/workflows/docs.yml)
 **dev:** [![Craft CI](https://github.com/Data-Wise/craft/actions/workflows/ci.yml/badge.svg?branch=dev)](https://github.com/Data-Wise/craft/actions/workflows/ci.yml) [![Documentation Quality](https://github.com/Data-Wise/craft/actions/workflows/docs-quality.yml/badge.svg?branch=dev)](https://github.com/Data-Wise/craft/actions/workflows/docs-quality.yml)
-[![Version](https://img.shields.io/badge/version-4.1.0-brightgreen.svg)](https://github.com/Data-Wise/craft/releases)
+[![Version](https://img.shields.io/badge/version-4.2.0-brightgreen.svg)](https://github.com/Data-Wise/craft/releases)
 
 > **Docs/publishing commands moved to [`folio`](https://github.com/Data-Wise/folio)** — see
 > [MIGRATION-v4.md](docs/MIGRATION-v4.md) for the old-command → new-location table.

README.md

@@ -321,5 +321,5 @@ Key risk:  [condition → mitigation]
 ## See Also
 
 - `/craft:do <task> --brief` — execute + append block
-- `/craft:done` — full session completion flow
+- `/craft:finish` — full session completion flow
 - `/craft:brainstorm` — full planning session from scratch

commands/brief.md

@@ -1,16 +1,16 @@
 ---
-description: /done - Session Completion & Context Capture
-deprecated: true
-replaced-by: "skills/workflow/adhd-workflow/"
+description: /finish - Session Completion & Context Capture
 ---
 
-# /done - Session Completion & Context Capture
+# /finish - Session Completion & Context Capture
 
 > **This command is a thin shim.** The canonical behavior lives in the
 > `adhd-workflow` skill's Session Completion operation. This file exists only to
-> preserve the explicit `/craft:done` slash entry point through the
-> v2.34.0 → v3.0.0 migration (see
-> [ADR-002](../docs/adr/ADR-002-done-command-skill-consolidation.md)).
+> preserve the explicit `/craft:finish` slash entry point (renamed from
+> `/craft:done` on 2026-07-17 — see
+> [ADR-006](../docs/adr/ADR-006-done-renamed-to-finish.md), which supersedes
+> [ADR-002](../docs/adr/ADR-002-done-command-skill-consolidation.md) on
+> naming only; ADR-002's shim-vs-skill rationale is unchanged).
 
 ## When invoked
 
@@ -22,14 +22,13 @@ replaced-by: "skills/workflow/adhd-workflow/"
    Insights Capture (Step 1.13), Worktree Status (Step 1.14), the interactive
    summary (Step 2), and auto-git (Step 3.5).
 
-2. **Do not reimplement here.** Any change to `/done` behavior must be made in
+2. **Do not reimplement here.** Any change to `/finish` behavior must be made in
    the reference file, never duplicated into this shim. Keeping the body in one
    place is the entire point of [ADR-002](../docs/adr/ADR-002-done-command-skill-consolidation.md).
 
 ## Why this is a shim
 
-`/done` is one of seven `commands/workflow/*.md` commands being consolidated into
-the `adhd-workflow` skill. Both entry paths — the explicit `/craft:done`
-slash command and the skill's natural-language match ("wrap up", "I'm done") —
-now route to the same reference file. At v3.0.0 this shim may be retired; the
-canonical body in the skill survives.
+`/finish` (renamed from `/done`) routes to the `adhd-workflow` skill's Session
+Completion operation. Both entry paths — the explicit `/craft:finish` slash
+command and the skill's natural-language match ("wrap up", "I'm done") — route
+to the same reference file.

commands/done.md commands/finish.mdcommands/done.md renamed to commands/finish.md

@@ -171,7 +171,7 @@ Display template:
 
 ```
 ┌─────────────────────────────────────────────────────────────────────────┐
-│  CRAFT - Full Stack Developer Toolkit v4.1.0                          │
+│  CRAFT - Full Stack Developer Toolkit v4.2.0                          │
 │  [PROJECT_NAME] ([PROJECT_TYPE]) on [GIT_BRANCH]                       │
 │  {stats['total']} commands | {skill_count} skills | {agent_count} agents | {test_count} tests passing │
 ├─────────────────────────────────────────────────────────────────────────┤

commands/hub.md

@@ -45,9 +45,9 @@ only reads and reports. There is no `--sync` flag (unlike `savant:restore`, whic
 optionally applies diff-gated doc updates). If write-back is ever wanted, that is
 a separate, explicitly-scoped addition — not part of this command today.
 
-## Relationship to `/craft:done` and `/craft:next`
+## Relationship to `/craft:finish` and `/craft:next`
 
-`/craft:done` (session completion) *produces* the `.STATUS` state this command
+`/craft:finish` (session completion) *produces* the `.STATUS` state this command
 *consumes*. `/craft:next` suggests the next task from that same state. `/craft:restore`
 is the read-only "where did I leave off" opener that precedes both — run it first
 when returning to a project after a break.