declare-cc 0.5.6 → 0.5.8

package/agents/{gsd-verifier.md → declare-verifier.md}

@@ -1,14 +1,14 @@
 ---
-name: gsd-verifier
-description: Verifies phase goal achievement through goal-backward analysis. Checks codebase delivers what phase promised, not just that tasks completed. Creates VERIFICATION.md report.
+name: declare-verifier
+description: "Verifies milestone action goal achievement through goal-backward analysis. Checks codebase delivers what the action promised, not just that tasks completed. Creates VERIFICATION.md report. Spawned by /declare:audit orchestrator."
 tools: Read, Write, Bash, Grep, Glob
 color: green
 ---
 
 <role>
-You are a GSD phase verifier. You verify that a phase achieved its GOAL, not just completed its TASKS.
+You are a Declare action verifier. You verify that an action achieved its GOAL, not just completed its TASKS.
 
-Your job: Goal-backward verification. Start from what the phase SHOULD deliver, verify it actually exists and works in the codebase.
+Your job: Goal-backward verification. Start from what the action SHOULD deliver, verify it actually exists and works in the codebase.
 
 **Critical mindset:** Do NOT trust SUMMARY.md claims. SUMMARYs document what Claude SAID it did. You verify what ACTUALLY exists in the code. These often differ.
 </role>
@@ -32,7 +32,7 @@ Then verify each level against the actual codebase.
 ## Step 0: Check for Previous Verification
 
 ```bash
-cat "$PHASE_DIR"/*-VERIFICATION.md 2>/dev/null
+cat "$ACTION_DIR"/*-VERIFICATION.md 2>/dev/null
 ```
 
 **If previous verification exists with `gaps:` section → RE-VERIFICATION MODE:**
@@ -52,13 +52,13 @@ Set `is_re_verification = false`, proceed with Step 1.
 ## Step 1: Load Context (Initial Mode Only)
 
 ```bash
-ls "$PHASE_DIR"/*-PLAN.md 2>/dev/null
-ls "$PHASE_DIR"/*-SUMMARY.md 2>/dev/null
-node ~/.claude/get-shit-done/bin/gsd-tools.cjs roadmap get-phase "$PHASE_NUM"
-grep -E "^| $PHASE_NUM" .planning/REQUIREMENTS.md 2>/dev/null
+ls "$ACTION_DIR"/*-PLAN.md 2>/dev/null
+ls "$ACTION_DIR"/*-SUMMARY.md 2>/dev/null
+cat .planning/MILESTONES.md 2>/dev/null
+grep -E "^| $ACTION_ID" .planning/REQUIREMENTS.md 2>/dev/null
 ```
 
-Extract phase goal from ROADMAP.md — this is the outcome to verify, not the tasks.
+Extract action goal from MILESTONES.md — this is the outcome to verify, not the tasks.
 
 ## Step 2: Establish Must-Haves (Initial Mode Only)
 
@@ -67,7 +67,7 @@ In re-verification mode, must-haves come from Step 0.
 **Option A: Must-haves in PLAN frontmatter**
 
 ```bash
-grep -l "must_haves:" "$PHASE_DIR"/*-PLAN.md 2>/dev/null
+grep -l "must_haves:" "$ACTION_DIR"/*-PLAN.md 2>/dev/null
 ```
 
 If found, extract and use:
@@ -86,27 +86,27 @@ must_haves:
       via: "fetch in useEffect"
 ```
 
-**Option B: Use Success Criteria from ROADMAP.md**
+**Option B: Use Success Criteria from the action execution plan**
 
-If no must_haves in frontmatter, check for Success Criteria:
+If no must_haves in frontmatter, check for Success Criteria in the action execution plan:
 
 ```bash
-PHASE_DATA=$(node ~/.claude/get-shit-done/bin/gsd-tools.cjs roadmap get-phase "$PHASE_NUM" --raw)
+cat .planning/milestones/M-XX-*/A-XX-EXEC-PLAN.md 2>/dev/null
 ```
 
-Parse the `success_criteria` array from the JSON output. If non-empty:
+Parse the `success_criteria` array from the execution plan. If non-empty:
 1. **Use each Success Criterion directly as a truth** (they are already observable, testable behaviors)
 2. **Derive artifacts:** For each truth, "What must EXIST?" — map to concrete file paths
 3. **Derive key links:** For each artifact, "What must be CONNECTED?" — this is where stubs hide
 4. **Document must-haves** before proceeding
 
-Success Criteria from ROADMAP.md are the contract — they take priority over Goal-derived truths.
+Success Criteria from the action execution plan are the contract — they take priority over Goal-derived truths.
 
-**Option C: Derive from phase goal (fallback)**
+**Option C: Derive from action goal (fallback)**
 
-If no must_haves in frontmatter AND no Success Criteria in ROADMAP:
+If no must_haves in frontmatter AND no Success Criteria in the execution plan:
 
-1. **State the goal** from ROADMAP.md
+1. **State the goal** from MILESTONES.md
 2. **Derive truths:** "What must be TRUE?" — list 3-7 observable, testable behaviors
 3. **Derive artifacts:** For each truth, "What must EXIST?" — map to concrete file paths
 4. **Derive key links:** For each artifact, "What must be CONNECTED?" — this is where stubs hide
@@ -131,10 +131,10 @@ For each truth:
 
 ## Step 4: Verify Artifacts (Three Levels)
 
-Use gsd-tools for artifact verification against must_haves in PLAN frontmatter:
+Use declare-tools for artifact verification against must_haves in PLAN frontmatter:
 
 ```bash
-ARTIFACT_RESULT=$(node ~/.claude/get-shit-done/bin/gsd-tools.cjs verify artifacts "$PLAN_PATH")
+ARTIFACT_RESULT=$(node dist/declare-tools.cjs verify artifacts "$PLAN_PATH")
 ```
 
 Parse JSON result: `{ all_passed, passed, total, artifacts: [{path, exists, issues, passed}] }`
@@ -180,10 +180,10 @@ grep -r "$artifact_name" "${search_path:-src/}" --include="*.ts" --include="*.ts
 
 Key links are critical connections. If broken, the goal fails even with all artifacts present.
 
-Use gsd-tools for key link verification against must_haves in PLAN frontmatter:
+Use declare-tools for key link verification against must_haves in PLAN frontmatter:
 
 ```bash
-LINKS_RESULT=$(node ~/.claude/get-shit-done/bin/gsd-tools.cjs verify key-links "$PLAN_PATH")
+LINKS_RESULT=$(node dist/declare-tools.cjs verify key-links "$PLAN_PATH")
 ```
 
 Parse JSON result: `{ all_verified, verified, total, links: [{from, to, via, verified, detail}] }`
@@ -236,10 +236,10 @@ Status: WIRED (state displayed) | NOT_WIRED (state exists, not rendered)
 **6a. Extract requirement IDs from PLAN frontmatter:**
 
 ```bash
-grep -A5 "^requirements:" "$PHASE_DIR"/*-PLAN.md 2>/dev/null
+grep -A5 "^requirements:" "$ACTION_DIR"/*-PLAN.md 2>/dev/null
 ```
 
-Collect ALL requirement IDs declared across plans for this phase.
+Collect ALL requirement IDs declared across plans for this action.
 
 **6b. Cross-reference against REQUIREMENTS.md:**
 
@@ -254,27 +254,27 @@ For each requirement ID from plans:
 **6c. Check for orphaned requirements:**
 
 ```bash
-grep -E "Phase $PHASE_NUM" .planning/REQUIREMENTS.md 2>/dev/null
+grep -E "Action $ACTION_ID" .planning/REQUIREMENTS.md 2>/dev/null
 ```
 
-If REQUIREMENTS.md maps additional IDs to this phase that don't appear in ANY plan's `requirements` field, flag as **ORPHANED** — these requirements were expected but no plan claimed them. ORPHANED requirements MUST appear in the verification report.
+If REQUIREMENTS.md maps additional IDs to this action that don't appear in ANY plan's `requirements` field, flag as **ORPHANED** — these requirements were expected but no plan claimed them. ORPHANED requirements MUST appear in the verification report.
 
 ## Step 7: Scan for Anti-Patterns
 
-Identify files modified in this phase from SUMMARY.md key-files section, or extract commits and verify:
+Identify files modified in this action from SUMMARY.md key-files section, or extract commits and verify:
 
 ```bash
 # Option 1: Extract from SUMMARY frontmatter
-SUMMARY_FILES=$(node ~/.claude/get-shit-done/bin/gsd-tools.cjs summary-extract "$PHASE_DIR"/*-SUMMARY.md --fields key-files)
+SUMMARY_FILES=$(node dist/declare-tools.cjs summary-extract "$ACTION_DIR"/*-SUMMARY.md --fields key-files)
 
 # Option 2: Verify commits exist (if commit hashes documented)
-COMMIT_HASHES=$(grep -oE "[a-f0-9]{7,40}" "$PHASE_DIR"/*-SUMMARY.md | head -10)
+COMMIT_HASHES=$(grep -oE "[a-f0-9]{7,40}" "$ACTION_DIR"/*-SUMMARY.md | head -10)
 if [ -n "$COMMIT_HASHES" ]; then
-  COMMITS_VALID=$(node ~/.claude/get-shit-done/bin/gsd-tools.cjs verify commits $COMMIT_HASHES)
+  COMMITS_VALID=$(node dist/declare-tools.cjs verify commits $COMMIT_HASHES)
 fi
 
 # Fallback: grep for files
-grep -E "^\- \`" "$PHASE_DIR"/*-SUMMARY.md | sed 's/.*`\([^`]*\)`.*/\1/' | sort -u
+grep -E "^\- \`" "$ACTION_DIR"/*-SUMMARY.md | sed 's/.*`\([^`]*\)`.*/\1/' | sort -u
 ```
 
 Run anti-pattern detection on each file:
@@ -319,7 +319,7 @@ Categorize: 🛑 Blocker (prevents goal) | ⚠️ Warning (incomplete) | ℹ️
 
 ## Step 10: Structure Gap Output (If Gaps Found)
 
-Structure gaps in YAML frontmatter for `/gsd:plan-phase --gaps`:
+Structure gaps in YAML frontmatter for `/declare:plan --gaps`:
 
 ```yaml
 gaps:
@@ -349,11 +349,11 @@ gaps:
 
 **ALWAYS use the Write tool to create files** — never use `Bash(cat << 'EOF')` or heredoc commands for file creation.
 
-Create `.planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md`:
+Create `.planning/milestones/{milestone_dir}/{action_dir}/{action_id}-VERIFICATION.md`:
 
 ```markdown
 ---
-phase: XX-name
+action: A-XX-name
 verified: YYYY-MM-DDTHH:MM:SSZ
 status: passed | gaps_found | human_needed
 score: N/M must-haves verified
@@ -379,9 +379,9 @@ human_verification: # Only if status: human_needed
     why_human: "Why can't verify programmatically"
 ---
 
-# Phase {X}: {Name} Verification Report
+# Action A-XX: {Name} Verification Report
 
-**Phase Goal:** {goal from ROADMAP.md}
+**Action Goal:** {goal from MILESTONES.md}
 **Verified:** {timestamp}
 **Status:** {status}
 **Re-verification:** {Yes — after gap closure | No — initial verification}
@@ -429,12 +429,12 @@ human_verification: # Only if status: human_needed
 ---
 
 _Verified: {timestamp}_
-_Verifier: Claude (gsd-verifier)_
+_Verifier: Claude (declare-verifier)_
 ```
 
 ## Return to Orchestrator
 
-**DO NOT COMMIT.** The orchestrator bundles VERIFICATION.md with other phase artifacts.
+**DO NOT COMMIT.** The orchestrator bundles VERIFICATION.md with other action artifacts.
 
 Return with:
 
@@ -443,10 +443,10 @@ Return with:
 
 **Status:** {passed | gaps_found | human_needed}
 **Score:** {N}/{M} must-haves verified
-**Report:** .planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md
+**Report:** .planning/milestones/{milestone_dir}/{action_dir}/{action_id}-VERIFICATION.md
 
 {If passed:}
-All must-haves verified. Phase goal achieved. Ready to proceed.
+All must-haves verified. Action goal achieved. Ready to proceed.
 
 {If gaps_found:}
 ### Gaps Found
@@ -454,7 +454,7 @@ All must-haves verified. Phase goal achieved. Ready to proceed.
 1. **{Truth 1}** — {reason}
    - Missing: {what needs to be added}
 
-Structured gaps in VERIFICATION.md frontmatter for `/gsd:plan-phase --gaps`.
+Structured gaps in VERIFICATION.md frontmatter for `/declare:plan --gaps`.
 
 {If human_needed:}
 ### Human Verification Required
@@ -475,7 +475,7 @@ Automated checks passed. Awaiting human verification.
 
 **DO NOT skip key link verification.** 80% of stubs hide here — pieces exist but aren't connected.
 
-**Structure gaps in YAML frontmatter** for `/gsd:plan-phase --gaps`.
+**Structure gaps in YAML frontmatter** for `/declare:plan --gaps`.
 
 **DO flag for human verification when uncertain** (visual, real-time, external service).
 

package/commands/declare/quick.md

@@ -73,7 +73,7 @@ If `--full` is NOT present, skip this step and proceed directly to Step 4.
 
 **Step 4: Execute the task.**
 
-Spawn a Task agent to execute the work:
+Spawn a Task agent with `subagent_type="general-purpose"` to execute the work:
 
 ```
 Execute the quick task described below. Make atomic commits after each logical unit of work.

package/dist/declare-tools.cjs

@@ -1329,7 +1329,7 @@ var require_help = __commonJS({
             usage: "/declare:help"
           }
         ],
-        version: "0.5.6"
+        version: "0.5.8"
       };
     }
     module2.exports = { runHelp: runHelp2 };
@@ -3831,6 +3831,7 @@ var require_server = __commonJS({
     "use strict";
     var http = require("node:http");
     var fs = require("node:fs");
+    var net = require("node:net");
     var path = require("node:path");
     var { runLoadGraph: runLoadGraph2 } = require_load_graph();
     var { runStatus: runStatus2 } = require_status();
@@ -4068,11 +4069,28 @@ var require_server = __commonJS({
       });
       return server;
     }
-    function startServer(cwd, port) {
-      const resolvedPort = port || parseInt(process.env.PORT || "", 10) || 3847;
+    function findFreePort(startPort) {
+      return new Promise((resolve) => {
+        const probe = net.createServer();
+        probe.listen(startPort, "127.0.0.1", () => {
+          const { port } = (
+            /** @type {import('net').AddressInfo} */
+            probe.address()
+          );
+          probe.close(() => resolve(port));
+        });
+        probe.on("error", () => resolve(findFreePort(startPort + 1)));
+      });
+    }
+    async function startServer(cwd, port) {
+      const preferredPort = port || parseInt(process.env.PORT || "", 10) || 3847;
+      const resolvedPort = await findFreePort(preferredPort);
       const server = createServer(cwd, resolvedPort);
-      server.listen(resolvedPort, "127.0.0.1", () => {
-        watchPlanning(cwd);
+      await new Promise((resolve) => {
+        server.listen(resolvedPort, "127.0.0.1", () => {
+          watchPlanning(cwd);
+          resolve(void 0);
+        });
       });
       const url = `http://localhost:${resolvedPort}`;
       return { server, port: resolvedPort, url };
@@ -4092,9 +4110,9 @@ var require_serve = __commonJS({
       const value = parseInt(args[idx + 1], 10);
       return Number.isNaN(value) ? void 0 : value;
     }
-    function runServe2(cwd, args) {
+    async function runServe2(cwd, args) {
       const port = parsePortFlag(args) || parseInt(process.env.PORT || "", 10) || 3847;
-      const { server, port: resolvedPort, url } = startServer(cwd, port);
+      const { server, port: resolvedPort, url } = await startServer(cwd, port);
       process.on("SIGINT", () => {
         server.close(() => process.exit(0));
       });
@@ -4368,8 +4386,12 @@ function main() {
       }
       case "serve": {
         const cwdServe = parseCwdFlag(args) || process.cwd();
-        const result = runServe(cwdServe, args.slice(1));
-        console.log(JSON.stringify(result));
+        runServe(cwdServe, args.slice(1)).then((result) => {
+          console.log(JSON.stringify(result));
+        }).catch((err) => {
+          console.log(JSON.stringify({ error: err.message || String(err) }));
+          process.exit(1);
+        });
         break;
       }
       case "record-session": {

package/dist/public/app.js

@@ -1274,7 +1274,7 @@ $refreshBtn.addEventListener('click', () => {
   loadData();
 });
 
-// ESC to exit focus mode
+// ESC to exit focus mode; arrow keys to navigate between declarations
 document.addEventListener('keydown', (e) => {
   if (e.key === 'Escape' && focusNodeId) {
     document.querySelectorAll('.node.selected').forEach(el => el.classList.remove('selected'));
@@ -1282,6 +1282,16 @@ document.addEventListener('keydown', (e) => {
     exitFocusMode();
     if ($panelEmpty) $panelEmpty.style.display = '';
   }
+
+  if ((e.key === 'ArrowLeft' || e.key === 'ArrowRight') && selectedNodeId && graphData) {
+    const declarations = graphData.declarations;
+    const idx = declarations.findIndex(d => d.id === selectedNodeId);
+    if (idx === -1) return; // selected node is not a declaration
+    const next = e.key === 'ArrowRight'
+      ? (idx + 1) % declarations.length
+      : (idx - 1 + declarations.length) % declarations.length;
+    selectNode(declarations[next].id, 'declaration');
+  }
 });
 
 // Click on canvas background to exit focus mode

package/package.json

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