declare-cc 0.3.7 → 0.4.0

package/commands/declare/actions.md

@@ -1,5 +1,5 @@
 ---
-description: Derive action plans per milestone
+description: Define actions per milestone — what must be done and what each produces (creates PLAN.md)
 allowed-tools:
   - Read
   - Write
@@ -96,4 +96,13 @@ node dist/declare-tools.cjs load-graph
 ```
 
 2. Show summary: milestones processed, plans created, total actions derived.
-3. Suggest: "Run `/declare:status` to see coverage and health."
+3. Suggest the next step clearly:
+
+```
+Actions defined. Next: create executable plans.
+
+  /declare:plan M-XX    — research + planner + checker loop → EXEC-PLAN files
+  /declare:execute M-XX — once plans exist, execute with wave scheduling
+```
+
+If multiple milestones were planned, list each one with its suggested next command.

package/commands/declare/plan.md

@@ -45,16 +45,16 @@ Check if `--skip-research` is present in `$ARGUMENTS`.
 **Step 2: Load milestone data.**
 
 ```bash
-node dist/declare-tools.cjs load-graph --milestone M-XX
+node dist/declare-tools.cjs load-graph
 ```
 
-Parse the JSON output. Extract:
-- `milestone`: milestone ID and title
-- `declarations`: array of declaration IDs and statements
-- `actions`: array of `{id, title, produces, dependsOn, status}`
-- `milestoneFolderPath`: path to the milestone planning folder
-- `researchPath`: path to RESEARCH.md if it exists
-- `contextPath`: path to CONTEXT.md if it exists
+Parse the JSON output. Find the milestone matching the ID. Extract:
+- `milestone`: milestone ID and title (from `milestones` array)
+- `declarations`: upstream declarations that realize this milestone (trace via `realizes` field)
+- `actions`: all actions whose `causes` array includes this milestone ID
+- `milestoneFolderPath`: derive as `.planning/milestones/M-XX-<slug>/`
+- `researchPath`: `.planning/milestones/M-XX-<slug>/RESEARCH.md` if it exists
+- `contextPath`: `.planning/milestones/M-XX-<slug>/CONTEXT.md` if it exists
 
 If no actions found, display: "No actions found for M-XX. Run `/declare:actions M-XX` first to create the milestone plan." and exit.
 

package/dist/declare-tools.cjs

@@ -1329,7 +1329,7 @@ var require_help = __commonJS({
             usage: "/declare:help"
           }
         ],
-        version: "0.1.0"
+        version: "0.3.9"
       };
     }
     module2.exports = { runHelp: runHelp2 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "declare-cc",
-  "version": "0.3.7",
+  "version": "0.4.0",
   "description": "A future-driven meta-prompting engine for agentic development, rooted in declared futures and causal graph structure.",
   "bin": {
     "declare-cc": "bin/install.js"