declare-cc 0.5.7 → 0.5.8

package/dist/declare-tools.cjs

@@ -1329,7 +1329,7 @@ var require_help = __commonJS({
             usage: "/declare:help"
           }
         ],
-        version: "0.5.7"
+        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.7",
+  "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"