declare-cc 0.4.3 → 0.4.5

package/bin/install.js

@@ -1465,8 +1465,9 @@ function install(isGlobal, runtime = 'claude') {
     console.log(`  ${green}✓${reset} Installed workflows/`);
   }
 
-  // Copy dashboard static files (src/server/public/) → .claude/server/public/
-  const publicSrc = path.join(src, 'src', 'server', 'public');
+  // Copy dashboard static files (dist/public/) → .claude/server/public/
+  // dist/public/ ships in the npm package (built by esbuild.config.js)
+  const publicSrc = path.join(src, 'dist', 'public');
   if (fs.existsSync(publicSrc)) {
     const publicDest = path.join(targetDir, 'server', 'public');
     fs.mkdirSync(publicDest, { recursive: true });

package/commands/declare/actions.md

@@ -95,11 +95,16 @@ After all milestones processed:
 node dist/declare-tools.cjs load-graph
 ```
 
-2. Show summary: milestones processed, plans created, total actions derived.
-3. Suggest the next step clearly:
+2. Start the dashboard if not already running:
+```bash
+curl -sf http://localhost:3847/api/graph -o /dev/null || (node dist/declare-tools.cjs serve --port 3847 > /tmp/declare-dashboard.log 2>&1 & sleep 1 && open http://localhost:3847 2>/dev/null || true)
+```
+
+3. Show summary: milestones processed, plans created, total actions derived.
+4. Suggest the next step clearly:
 
 ```
-Actions defined. Next: create executable plans.
+Actions and edges are live in the dashboard → http://localhost:3847
 
   /declare:plan M-XX    — research + planner + checker loop → EXEC-PLAN files
   /declare:execute M-XX — once plans exist, execute with wave scheduling

package/commands/declare/future.md

@@ -44,9 +44,29 @@ node dist/declare-tools.cjs add-declaration --title "Short Title" --statement "F
 
 Parse the JSON output to confirm the declaration was created and note its assigned ID (e.g., D-01).
 
-**Step 5: Show summary and suggest next step.**
+**Step 5: Launch dashboard and show summary.**
 
 After all declarations are captured:
 
-1. List all declarations with their IDs and statements.
-2. Suggest: "Run `/declare:milestones` to work backward from these declarations to milestones and actions."
+1. Start the dashboard server (if not already running):
+
+```bash
+node dist/declare-tools.cjs serve --port 3847 > /tmp/declare-dashboard.log 2>&1 &
+sleep 1 && curl -sf http://localhost:3847/api/graph -o /dev/null && echo "RUNNING" || echo "FAILED"
+```
+
+If RUNNING, open it:
+```bash
+open http://localhost:3847 2>/dev/null || true
+```
+
+2. List all declarations with their IDs and statements.
+
+3. Suggest next step:
+
+```
+Your declarations are live in the dashboard → http://localhost:3847
+The graph updates every 5 seconds as you add milestones and actions.
+
+Run /declare:milestones to work backward from these declarations.
+```

package/commands/declare/milestones.md

@@ -77,5 +77,10 @@ After all declarations processed:
 node dist/declare-tools.cjs load-graph
 ```
 
-2. Show summary: declarations processed, milestones derived.
-3. Suggest: "Run `/declare:actions` to derive action plans for each milestone."
+2. Start the dashboard if not already running (dashboard updates live when files change):
+```bash
+curl -sf http://localhost:3847/api/graph -o /dev/null || (node dist/declare-tools.cjs serve --port 3847 > /tmp/declare-dashboard.log 2>&1 & sleep 1 && open http://localhost:3847 2>/dev/null || true)
+```
+
+3. Show summary: declarations processed, milestones derived.
+4. Suggest: "Milestones are live in the dashboard → http://localhost:3847 — Run `/declare:actions` to derive action plans."

package/dist/declare-tools.cjs

@@ -1329,7 +1329,7 @@ var require_help = __commonJS({
             usage: "/declare:help"
           }
         ],
-        version: "0.4.0"
+        version: "0.4.4"
       };
     }
     module2.exports = { runHelp: runHelp2 };
@@ -3677,7 +3677,9 @@ var require_server = __commonJS({
     };
     function getPublicDir(cwd) {
       const installed = path.join(cwd, ".claude", "server", "public");
-      if (require("fs").existsSync(installed)) return installed;
+      if (fs.existsSync(installed)) return installed;
+      const bundled = path.join(__dirname, "public");
+      if (fs.existsSync(bundled)) return bundled;
       return path.join(cwd, "src", "server", "public");
     }
     function sendJson(res, statusCode, data) {
@@ -3760,6 +3762,31 @@ var require_server = __commonJS({
         sendJson(res, 500, { error: String(err) });
       }
     }
+    var sseClients = /* @__PURE__ */ new Set();
+    function broadcastChange() {
+      for (const client of sseClients) {
+        try {
+          client.write("event: change\ndata: {}\n\n");
+        } catch (_) {
+          sseClients.delete(client);
+        }
+      }
+    }
+    function watchPlanning(cwd) {
+      const planningDir = path.join(cwd, ".planning");
+      if (!fs.existsSync(planningDir)) return;
+      let debounceTimer = null;
+      try {
+        fs.watch(planningDir, { recursive: true }, () => {
+          if (debounceTimer) clearTimeout(debounceTimer);
+          debounceTimer = setTimeout(() => {
+            broadcastChange();
+            debounceTimer = null;
+          }, 200);
+        });
+      } catch (_) {
+      }
+    }
     function route(req, res, cwd) {
       const method = req.method || "GET";
       const url = req.url || "/";
@@ -3777,6 +3804,18 @@ var require_server = __commonJS({
         sendJson(res, 405, { error: "Method Not Allowed" });
         return;
       }
+      if (urlPath === "/events") {
+        res.writeHead(200, {
+          "Content-Type": "text/event-stream",
+          "Cache-Control": "no-cache",
+          "Connection": "keep-alive",
+          "Access-Control-Allow-Origin": "*"
+        });
+        res.write("retry: 3000\n\n");
+        sseClients.add(res);
+        req.on("close", () => sseClients.delete(res));
+        return;
+      }
       if (urlPath === "/api/graph") {
         handleGraph(res, cwd);
         return;
@@ -3818,6 +3857,7 @@ var require_server = __commonJS({
       const resolvedPort = port || parseInt(process.env.PORT || "", 10) || 3847;
       const server = createServer(cwd, resolvedPort);
       server.listen(resolvedPort, "127.0.0.1", () => {
+        watchPlanning(cwd);
       });
       const url = `http://localhost:${resolvedPort}`;
       return { server, port: resolvedPort, url };