spectoflow 0.14.0 → 0.14.2

package/README.md

@@ -41,6 +41,7 @@ Every command works both ways — `spectoflow <cmd>` when installed globally, or
 spectoflow init [dir] [--agent=claude,codex]   scaffold a project (auto-detects installed agents)
 spectoflow update [--dry-run]                  refresh framework files to this kit version
 spectoflow dashboard [--port=NNNN]             run the local control plane (default 4319)
+spectoflow dashboard stop   (or: stop)         stop the running dashboard
 spectoflow status                              progress + whether the dashboard is running
 spectoflow --version   (-v)                    print the version
 spectoflow --help      (-h)                    show help

package/bin/spectoflow.js

@@ -135,9 +135,9 @@ function init() {
 
   // gitignore the volatile runtime
   const gi = path.join(target, '.gitignore');
-  const line = '.spectoflow/runtime.json';
-  if (!fs.existsSync(gi) || !fs.readFileSync(gi, 'utf8').includes(line)) {
-    fs.appendFileSync(gi, (fs.existsSync(gi) ? '\n' : '') + line + '\n');
+  const giText = fs.existsSync(gi) ? fs.readFileSync(gi, 'utf8') : '';
+  for (const line of ['.spectoflow/runtime.json', '.spectoflow/.dashboard.lock']) {
+    if (!giText.includes(line)) fs.appendFileSync(gi, ((fs.existsSync(gi) && fs.readFileSync(gi, 'utf8').length) ? '\n' : '') + line + '\n');
   }
 
   console.log('spectoflow installed in', target);
@@ -187,6 +187,7 @@ function update() {
 // THE launch command — prints the URL clearly and won't crash on EADDRINUSE: it probes first
 // and, if a dashboard is already up on that port, just reports it instead of spawning a second one.
 async function dashboard() {
+  if (argv[1] === 'stop' || argv.includes('stop')) return stopDashboard();
   const port = resolvePort(argv);
   const url = `http://localhost:${port}`;
   if (await probeDashboard(port)) {
@@ -200,6 +201,30 @@ async function dashboard() {
   console.log(`spectoflow dashboard → ${url}`);
 }
 
+// Stop the running dashboard: read the pidfile it wrote, verify it's actually up, then terminate it
+// and clear the lock. Safe against a stale lock (a recycled pid) because it only kills when the port
+// still responds.
+async function stopDashboard() {
+  const root = process.cwd();
+  const lock = path.join(root, '.spectoflow', '.dashboard.lock');
+  let info = null;
+  try { info = JSON.parse(fs.readFileSync(lock, 'utf8')); } catch {}
+  const port = (info && info.port) || resolvePort(argv);
+  const running = await probeDashboard(port);
+  if (!running) {
+    if (info) { try { fs.unlinkSync(lock); } catch {} }   // stale lock
+    return console.log('No spectoflow dashboard is running.');
+  }
+  if (info && info.pid) {
+    try {
+      process.kill(info.pid);                  // SIGTERM → server clears its own lock (POSIX)
+      try { fs.unlinkSync(lock); } catch {}     // and we clear it too (Windows has no real signals)
+      return console.log(`spectoflow dashboard stopped (pid ${info.pid}, was on http://localhost:${port}).`);
+    } catch {}
+  }
+  console.log(`A dashboard is responding on http://localhost:${port} but isn't stoppable via the lock file — stop it where you launched it (Ctrl+C).`);
+}
+
 async function status() {
   const root = process.cwd();
   const cfg = store.readConfig(root);
@@ -228,6 +253,7 @@ ${c.bold('Commands:')}
   ${c.g('init')} [dir] [--agent=claude,codex]   scaffold a project (auto-detects installed agents)
   ${c.g('update')} [--dry-run]                  refresh framework files to this kit version
   ${c.g('dashboard')} [--port=NNNN]             run the local control plane (default 4319, or $SPECTOFLOW_PORT)
+  ${c.g('dashboard stop')}                      stop the running dashboard (alias: ${c.g('stop')})
   ${c.g('status')}                              print progress + whether the dashboard is running
 
 ${c.bold('Options:')}
@@ -236,7 +262,7 @@ ${c.bold('Options:')}
 
 ${c.dim('Docs:')} https://github.com/georgesmomo/spectoflow`);
 
-const fns = { init, update, dashboard, status, help, version };
+const fns = { init, update, dashboard, stop: stopDashboard, status, help, version };
 if (['-v', '-V', '--version', 'version'].includes(cmd)) version();
 else if (['-h', '--help'].includes(cmd)) help();
 else if (fns[cmd]) fns[cmd]();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectoflow",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "Agent-agnostic spec-driven development framework + real-time local control plane. Markdown artifacts, intent router, workflow-by-scope.",
   "keywords": [
     "spec-driven-development",

package/templates/dashboard/public/app.js

@@ -287,9 +287,15 @@ function renderOverview(){
   if(!steps.length) strip.append(el('div','empty','No workflow defined.'));
   box.append(ocard('Workflow at a glance', strip));
 
-  // Per-phase progress bars
-  const rows=s.phases.map(ph=>({label:ph.title,pct:ph.pct,sub:`${ph.done}/${ph.total}`}));
-  box.append(ocard('Phase progress', bars(rows)));
+  // Per-phase progress bars — only phases that actually hold tasks (headings with no checkbox tasks
+  // are noise, not phases), and cap the list height with an internal scroll so a big project with
+  // dozens of phases can't blow up the overview.
+  const phaseRows=s.phases.filter(ph=>ph.total>0).map(ph=>({label:ph.title,pct:ph.pct,sub:`${ph.done}/${ph.total}`}));
+  if(phaseRows.length){
+    const barsEl=bars(phaseRows);
+    if(phaseRows.length>8) barsEl.classList.add('scroll-cap');
+    box.append(ocard(`Phase progress (${phaseRows.length})`, barsEl));
+  }
 }
 
 function taskMatches(t){

package/templates/dashboard/public/styles.css

@@ -821,3 +821,6 @@ body.booting .wf-step2 { opacity:0; animation:rise .4s cubic-bezier(.2,.8,.2,1)
 .mini-btn:hover { color:var(--ink); border-color:var(--cool); }
 .main:has(.board.is-kanban) #phaseToggleAll { display:none; }   /* phases are a List concept */
 .kanban-col-body { max-height:64vh; overflow-y:auto; }          /* keep columns compact on a big project */
+
+/* Phase progress: cap the list so a big project (many phases) doesn't dominate the overview */
+.bars-block.scroll-cap { max-height:340px; overflow-y:auto; padding-right:6px; }

package/templates/dashboard/server.js

@@ -222,4 +222,10 @@ const server = http.createServer(async (req,res)=>{
     });
   }catch(e){ sendJSON(res,500,{error:String(e&&e.message||e)}); }
 });
-server.listen(PORT,()=>{ console.log(`spectoflow · dashboard → http://localhost:${PORT}`); console.log(`project root: ${ROOT}`); });
+// pidfile so `spectoflow dashboard stop` can find and stop this server; cleared on exit.
+const LOCK = path.join(ROOT, '.spectoflow', '.dashboard.lock');
+function writeLock(){ try{ fs.mkdirSync(path.dirname(LOCK),{recursive:true}); fs.writeFileSync(LOCK, JSON.stringify({ pid:process.pid, port:PORT, url:`http://localhost:${PORT}`, startedAt:new Date().toISOString() })+'\n'); }catch{} }
+function clearLock(){ try{ const l=JSON.parse(fs.readFileSync(LOCK,'utf8')); if(l.pid===process.pid) fs.unlinkSync(LOCK); }catch{} }
+process.on('exit', clearLock);
+['SIGINT','SIGTERM'].forEach((s)=> process.on(s, ()=>{ clearLock(); process.exit(0); }));
+server.listen(PORT,()=>{ writeLock(); console.log(`spectoflow · dashboard → http://localhost:${PORT}`); console.log(`project root: ${ROOT}`); });