@jabworks/condux 0.30.0 → 0.31.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jabworks/condux",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "OpenCode plugin for the condux workflow toolkit — bundles the condux skills and injects the specialist agents (coder, explorer, planner, researcher) plus an opt-in plan-review listener.",
   "type": "module",
   "publishConfig": {

package/skills/subagent-execution/SKILL.md

@@ -46,32 +46,22 @@ If you can't answer all four, don't spawn.
 
 ## Progress Ledger
 
-Conversation memory does not survive compaction. Track task completion in a
-ledger file, not only in todos.
-
-- At skill start, check for a ledger: `.condux/progress/<feature-slug>.md`
-  (slug inferred kebab-case from the plan's feature name — the same
-  convention `draft-plan` uses for its own filename). Tasks listed there as
-  complete are DONE — do not re-dispatch them; resume at the first task not
-  marked complete.
-- If no ledger exists, create it with a header naming the plan file:
-  ```
-  # Subagent Execution Progress: <feature-slug>
-
-  Plan: .condux/plans/<plan-file>.md
-
-  ```
-- When a task's review comes back clean, append one line in the same
-  message as other bookkeeping: `- [x] Task N: <name> — commits
-  <base7>..<head7>, review clean`.
-- The ledger is a recovery aid, not the source of truth — the commits it
-  names exist in git even if context no longer remembers creating them.
-  After compaction or a new session, trust the ledger and `git log` over
-  your own recollection.
-- `.condux/` is gitignored working state (see `/workflow` → Artifacts). If
-  it's ever deleted, recover progress from `git log` against the plan's task
-  list — and note the plan itself lived there too, so re-derive scope from
-  the spec in `specs/` if the plan is gone as well.
+The ledger contract — path, header, line format, wrap-up lines — is owned by
+`/workflow` → **Progress Ledger**, because inline execution keeps the same file;
+this section only adds what is specific to dispatching agents.
+
+- At skill start, check for a ledger: `.condux/progress/<feature-slug>.md`.
+  Tasks listed there as complete are DONE — do not re-dispatch them; resume at
+  the first task not marked complete.
+- If no ledger exists, create it with the header `/workflow` defines (naming the
+  plan file and the BASE commit).
+- When a task's review comes back clean, append one line in the same message as
+  other bookkeeping: `- [x] Task N: <name> — commits <base7>..<head7>, review
+  clean`.
+- After compaction or a new session, trust the ledger and `git log` over your own
+  recollection. If `.condux/` is ever deleted, recover progress from `git log`
+  against the plan's task list — and note the plan itself lived there too, so
+  re-derive scope from the spec in `specs/` if the plan is gone as well.
 
 ## How It Works
 

package/skills/workflow/SKILL.md

@@ -107,8 +107,8 @@ Every tier ends with `preflight` then `finalize` — no exceptions.
   Overview · Files · Interfaces · Sketch where non-obvious · Edge cases) → CP-1 →
   implement top-to-bottom → CP-2 → `/preflight` → `/finalize` → CP-3.
 - **LARGE:** load `discovery`, run fully to sign-off → load `draft-plan`, produce the
-  plan doc, sign-off → CP-1 → implement task by task (`subagent-execution` if the
-  user picks it) → CP-2 → `/preflight` → `/finalize` → CP-3.
+  plan doc, sign-off → CP-1 → implement task by task, keeping the Progress Ledger
+  (`subagent-execution` if the user picks it) → CP-2 → `/preflight` → `/finalize` → CP-3.
 
 ## Checkpoints
 
@@ -172,7 +172,7 @@ Load each only when its step is reached.
 | `blueprint` | discovery's propose step, or a standalone mockup/visualization ask | load only when a UI surface or data model is in play; structure, never styling |
 | `draft-plan` | LARGE, after discovery sign-off | needs a signed-off design; no design → apply the discovery soft gate first |
 | `test-first-development` | user asks, or picks it at CP-1 | one upfront consent; always ask before editing an existing test spec |
-| `subagent-execution` | LARGE plan where specialization/parallelism pays off | default is implement yourself |
+| `subagent-execution` | LARGE plan where specialization/parallelism pays off | default is implement yourself; keeps the Progress Ledger |
 | `subagent-deployment` | 2+ independent tasks, no shared files/deps | ad-hoc work, not ordered plans |
 | `preflight` | end of every tier, before finalize | automatic on SMALL; recommended CP-2 choice |
 | `finalize` | after all implementation | runs in order, once, stops on first failure; check AGENTS.md for the real commands |
@@ -229,6 +229,40 @@ without asking. Not a git repo → fall back to CWD and say so once.
 **Override.** A project can relocate either tier in `AGENTS.md`; an explicit
 override always wins over these defaults.
 
+## Progress Ledger
+
+Conversation memory does not survive compaction, and a plan file records intent,
+not progress. Whoever implements a plan saved in `.condux/plans/` — you inline,
+or `subagent-execution` — keeps one ledger beside it,
+`.condux/progress/<feature-slug>.md` (the plan's file name minus its date and
+extension):
+
+```
+# Progress: <feature-slug>
+
+Plan: .condux/plans/<plan-file>.md
+BASE: <sha7 of HEAD before Task 1>
+
+- [x] Task 1: <name> — commit <sha7>
+- [x] preflight clean
+- [x] committed <sha7>; PR #N open
+```
+
+- **Task lines** are appended after the task's commit, one per task, in the same
+  message as ticking the todo. A line names a real commit.
+- **Wrap-up lines** (no task number) are appended as each checkpoint step
+  finishes: `code-review`, `preflight`, `finalize`, live verification, then the
+  commit or PR line. A tool that reads the ledger — the `/condux` board — turns
+  them into the pipeline's done and still-to-come steps.
+- **Start of work:** if a ledger exists, tasks ticked there are DONE; resume at
+  the first one that is not.
+- **No saved plan file, no ledger.** A SMALL task and a MEDIUM inline plan have
+  nothing for a ledger to key on; do not invent a plan file to get one.
+- The ledger is a recovery aid, not the source of truth: the commits it names
+  exist in git even when context no longer remembers them. `.condux/` is
+  gitignored working state (see Artifacts), so never cite a ledger from a
+  committed file.
+
 ## Agents
 
 Five **named specialist agents** ship with condux — never invent a generic subagent

package/skills/workflow/hooks/hooks.json

@@ -11,5 +11,8 @@
         ]
       }
     ]
-  }
+  },
+  "modules": [
+    "./mod/register.tsx"
+  ]
 }