@mu-crew/mu 3.0.0 → 3.1.0

package/docs/ARCHITECTURE.md

@@ -115,7 +115,7 @@ it mu is just an agent runner.
   decides edge satisfaction: any `CLOSED` task satisfies its blockers.
 - **Substate** qualifies status and never touches edges:
   `OPEN/todo|parked`, `IN_PROGRESS/active`,
-  `CLOSED/done|wontfix|duplicate|superseded`. Rule: **store intent,
+  `CLOSED/done|rejected|wontfix|duplicate|superseded`. Rule: **store intent,
   derive graph facts** — ready and blocked stay derived from edges.
   `OPEN/parked` is excluded from `ready` but stays in `goals`.
 

package/docs/USAGE_GUIDE.md

@@ -389,8 +389,8 @@ table/key/field is the reproduction. See
 `mu` refuses to open a pre-v11 DB (`SchemaTooOldError`, exit 4) or a DB
 newer than it understands (`SchemaTooNewError`, exit 4) and leaves the
 file alone. The retained `scripts/migrate.ts` sidecar auto-detects v7,
-v8, v9, or v10 and writes a fresh v11 DB. It never migrates in place.
-Legacy `REJECTED` tasks become `CLOSED/wontfix` and `DEFERRED` tasks
+v8, v9, v10, or v11 and writes a fresh v11 DB. It never migrates in place.
+Legacy `REJECTED` tasks become `CLOSED/rejected` and `DEFERRED` tasks
 become `OPEN/parked`; their original op payloads remain unchanged.
 Pre-1.0 archives restore as live workstreams under their original
 `source_workstream` names unless you pass `--drop-archives`.
@@ -1630,8 +1630,9 @@ mu task unpark polish               # OPEN/parked → OPEN/todo
 
 Every task carries a **substate** next to its status, rendered as a pair.
 `OPEN` is `todo` or `parked`; `IN_PROGRESS` is `active`; `CLOSED` is
-`done`, `wontfix`, `duplicate`, or `superseded`. `--as` picks the closed
-substate. Anything but `done` requires `--why`, stored as a note in the
+`done`, `rejected`, `wontfix`, `duplicate`, or `superseded`. `--as` picks
+the closed substate: `rejected` when the proposal itself was declined,
+`wontfix` when it is valid but not worth doing. Anything but `done` requires `--why`, stored as a note in the
 same transaction. Any `CLOSED/*` satisfies a blocker, so a non-`done`
 close prints the dependents it unblocked.
 
@@ -2400,10 +2401,10 @@ mv "$DB" "${DB}.old-kept" && mv "${DB}.v11" "$DB"
 mu doctor
 ```
 
-The script auto-detects v7, v8, v9, or v10, opens it read-only, compares
+The script auto-detects v7, v8, v9, v10, or v11, opens it read-only, compares
 its SHA-256 before and after, and never overwrites a target unless
 `--force` is explicit. v9/v10 history is retained unchanged; legacy
-statuses map onto substates (`REJECTED` → `CLOSED/wontfix`, `DEFERRED` →
+statuses map onto substates (`REJECTED` → `CLOSED/rejected`, `DEFERRED` →
 `OPEN/parked`) while projecting into v11, and no migration notes are
 written. Where an undo or a note hid the legacy status, the script
 records a `migrate.substate` op; `--recover <db>` reruns that recovery

package/docs/VOCABULARY.md

@@ -30,7 +30,7 @@ defined here, fix the doc. If you need a new term, add it here first.
 | **crew**              | *Informal* collective noun for the agents in a workstream                | (no API surface; prose only)                       |
 | **task**              | A node in the DAG. Has mandatory `impact` and `effort_days`. Has a **task status** and a **substate**, shown as a pair (`OPEN/parked`, `CLOSED/wontfix`). | "issue", "ticket", "item"                          |
 | **task status**       | The lifecycle phase, one of 3: **OPEN** = not started; **IN_PROGRESS** = claimed and active; **CLOSED** = ended. Status alone decides edge satisfaction: any `CLOSED/*` satisfies a `--blocked-by` edge. | "state"                                            |
-| **substate**          | What the **task status** means for this task. Never null; each status has a default. `OPEN`: `todo` (default), `parked`. `IN_PROGRESS`: `active`. `CLOSED`: `done` (default), `wontfix`, `duplicate`, `superseded`. Rendered as a pair `STATUS/substate`; a default substate renders as the bare status. Valid pairs live in the `task_substates` table. Never affects edges. Refer to a non-`done` close as a *closed substate*. | "resolution", "reason", "sub-status" |
+| **substate**          | What the **task status** means for this task. Never null; each status has a default. `OPEN`: `todo` (default), `parked`. `IN_PROGRESS`: `active`. `CLOSED`: `done` (default), `rejected` (the proposal was declined), `wontfix` (valid, not worth doing), `duplicate`, `superseded`. Rendered as a pair `STATUS/substate`; a default substate renders as the bare status. Valid pairs live in the `task_substates` table. Never affects edges. Refer to a non-`done` close as a *closed substate*. | "resolution", "reason", "sub-status" |
 | **park**              | Verb: set an `OPEN` task to `OPEN/parked` with a required `--why` note. A parked task leaves **ready** and `next`, `claim` refuses it without `--force`, and it stays in **goals**. Its dependents stay blocked. Refuses `IN_PROGRESS` (release first) and `CLOSED` (open first). | "defer", "snooze", "shelve" |
 | **unpark**            | Verb: return an `OPEN/parked` task to `OPEN/todo`.                        | "resume", "reactivate"                             |
 | **task DAG** / **graph** | The directed acyclic graph of tasks. | "task list", "todo", "tree" (it's a DAG, not a tree) |

package/docs/specs/2026-09-29-task-substates.md

@@ -57,7 +57,7 @@ Consequences:
 | D8 | Apply resolves the pair before writing: a status-only op, or an unknown substate from a newer peer, falls back to the status default. The original payload stays in `ops`. | The foreign key fails the whole commit. Version skew must not break sync; the foreign key is there to catch our own bugs. |
 | D9 | Non-`done` close and `park` require `--why`, stored as an ordinary note in the same transaction. | Keeps the rationale, the one good part of the notes-only convention. |
 | D10 | Start with `parked` as the only non-default `OPEN` substate. No `--until`. | YAGNI. mu has no daemon to run the automatic un-park. Adding `triage` later is one seeded row. |
-| D11 | One shared legacy mapping: `REJECTED → CLOSED/wontfix`, `DEFERRED → OPEN/parked`. | Replaces `normalizeTaskStatus` (currently folds both onto `OPEN`). Apply, rebuild, undo and migration all use it, so recovery happens on every path. |
+| D11 | One shared legacy mapping: `REJECTED → CLOSED/rejected` (3.1.0; 3.0.0 used `wontfix`), `DEFERRED → OPEN/parked`. | Replaces `normalizeTaskStatus` (currently folds both onto `OPEN`). Apply, rebuild, undo and migration all use it, so recovery happens on every path. |
 | D12 | Migrate v10 → v11 through `scripts/migrate.ts`, not in `openDb`. | Keeps the "production never migrates in place" rule. SQLite cannot add a foreign key to an existing table, so a new target is required anyway. |
 
 ## Schema (v11)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-crew/mu",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "A persistent, observable crew of pi agents running in one tmux or herdr session per workstream, coordinated through a built-in task DAG.",
   "publishConfig": {
     "access": "public"

package/skills/mu/SKILL.md

@@ -36,7 +36,7 @@ both. `--json` exists on every verb:
   on tmux and from herdr on herdr; `mu agent kick` is Linux-only on herdr.
 - **task** — DAG node with mandatory `impact` (1–100) and
   `effort_days`. Shown as status/substate: `OPEN/todo|parked`,
-  `IN_PROGRESS/active`, `CLOSED/done|wontfix|duplicate|superseded`.
+  `IN_PROGRESS/active`, `CLOSED/done|rejected|wontfix|duplicate|superseded`.
   Any `CLOSED/*` satisfies `--blocked-by`.
 - **claim / release** — atomic take/clear of `tasks.owner`.
 - **note** — append-only task context; survives sessions.
@@ -233,7 +233,7 @@ Every turn:
   5 timeout, 6 pane died.
 - **`task close --if-ready`** no-ops until every blocker is CLOSED; bare
   `task release` reopens IN_PROGRESS.
-- **`task close --as wontfix --why ...`** unblocks dependents (listed in
+- **`task close --as rejected|wontfix --why ...`** (declined | valid, not worth it) unblocks dependents (listed in
   the output). To keep dependents waiting, `task park --why` instead: parked
   leaves `next`, and `claim` refuses it without `--force`. Park refuses
   IN_PROGRESS — `task release` first.