spectoflow 0.31.1 → 0.32.0

package/README.md

@@ -24,6 +24,17 @@ An **agent-agnostic** spec-driven development framework with a **real-time local
 You speak in plain language; the framework classifies your intent and runs the right workflow. No
 ceremonial command to start.
 
+## Quick start
+
+```bash
+npm install -g spectoflow
+cd my-project && spectoflow init     # fits the workflow to your project, detects your agents
+spectoflow dashboard                 # → http://localhost:4319
+```
+
+Then just tell your coding agent what you want to build. Optional, once per machine:
+`spectoflow brain setup` so your agents remember you across projects.
+
 **Works with whichever coding agent you have.** `init` auto-detects what's installed; the dashboard's
 topbar always shows the **active agent**, front and center, with a switcher — pick another and it's
 verified as genuinely installed before activating (a red **"No agent found"** if none is), never

package/bin/spectoflow.js

@@ -517,6 +517,11 @@ async function startDashboard() {
   const boardUrl = (p) => (entry ? `http://localhost:${p}/p/${entry.id}/board` : `http://localhost:${p}/`);
   const info = workspace.readLock();
   if (info && info.port && await probeDashboard(info.port)) {
+    // A hub started by an older spectoflow keeps running that old code: replace it (D77).
+    if (info.version !== VERSION) {
+      console.log(`${c.cy('↻')} the running hub is ${info.version ? 'spectoflow v' + info.version : 'an older spectoflow'} — restarting it on v${VERSION}`);
+      return restartDashboard();
+    }
     console.log(`${c.g('●')} hub already running → ${c.bold(boardUrl(info.port))}`);
     await printOnlineLine(info.port, true);
     return printDashboardCommands();

package/lib/dashboard/handlers.js

@@ -68,6 +68,7 @@ function createHandlers(root) {
     // A process restart loses any in-flight orchestration; clear a stale 'running'/'awaiting_approval'
     // so the 409 guard in orchestrate.start can't wedge forever. Not a resume — just un-wedging.
     try { orchestrator.reconcileOnBoot(root); } catch (_) {}
+    try { require('./runner').reconcileRunsOnBoot(root); } catch (_) {}
   }
   return {
     handleApi,

package/lib/dashboard/hub-server.js

@@ -278,7 +278,7 @@ function serveStatic(reqPath, req, res, root) {
 const PROJECT_PREFIX = /^\/p\/([0-9a-f]{6})(\/.*)?$/;
 
 const LOCK = workspace.lockPath();
-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 writeLock(){ try{ fs.mkdirSync(path.dirname(LOCK),{recursive:true}); fs.writeFileSync(LOCK, JSON.stringify({ pid:process.pid, port:PORT, url:`http://localhost:${PORT}`, version:VERSION, 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, ()=>{ if (connector) connector.stop(); clearLock(); process.exit(0); }));

package/lib/dashboard/meeting.js

@@ -10,7 +10,7 @@
 const { spawn } = require('child_process');
 const store = require('../store');
 const files = require('./files');
-const { resolveRunnerCommand } = require('./runner');
+const { resolveRunnerCommand, trackChild } = require('./runner');
 const runnerTrust = require('../runner-trust');
 const { formatLog } = require('./summarize'); // reused as-is rather than reimplemented — see report
 
@@ -106,6 +106,7 @@ function runMeetingGenerate(root, { agent, date } = {}, emit) {
   let out = '';
   child.stdout && child.stdout.on('data', (d) => { out += d.toString(); });
   child.stderr && child.stderr.on('data', (d) => { out += d.toString(); });
+  trackChild(root, child);
   child.on('close', (code) => {
     const text = out.trim() || (code === 0 ? '(no output)' : `meeting generate failed (exit ${code})`);
     files.writeFile(root, meetingPath(day), text);

package/lib/dashboard/ops.js

@@ -11,7 +11,7 @@ const fs = require('fs');
 const path = require('path');
 const store = require('../store');
 const files = require('./files');
-const { startRun } = require('./runner');
+const { startRun, stopRuns } = require('./runner');
 const { runSummarize } = require('./summarize');
 const { runMeetingGenerate, todayLocal } = require('./meeting');
 const orchestrator = require('./orchestrator');
@@ -165,6 +165,7 @@ const ops = {
     // for which .spectoflow/meetings/<date>.md "today" resolves to.
     p.todayDate = todayLocal();
     p.untrustedRunners = runnerTrust.untrusted(root, p.config);
+    p.kitVersion = PKG_VERSION;
     return p;
   },
   'agentfile.read': async (root, { path: rel }) => readAgentFile(root, rel),
@@ -234,6 +235,14 @@ const ops = {
     if (r.error) bad(r.error);
     return { runId: r.runId };
   },
+  // Bring the project's framework files up to the installed spectoflow (same as `spectoflow update`). Local
+  // only: it writes framework files on the owner's machine (D77).
+  'project.update': async (root, _args, ctx) => {
+    if (ctx && ctx.remote) throw new OpError(404, 'Unknown operation.');
+    const r = require('../update').runUpdate({ projectRoot: root, templatesDir: path.join(__dirname, '..', '..', 'templates'), version: PKG_VERSION });
+    return changed(ctx, { fromVersion: r.fromVersion, toVersion: r.toVersion, refreshed: r.refreshed.length + r.created.length + r.forced.length + r.removed.length, review: r.newSidecar });
+  },
+  'run.stop': async (root, _args, ctx) => changed(ctx, { stopped: stopRuns(root) }),
   'chat.summarize': async (root, { agent }, ctx) => {
     const r = runSummarize(root, { agent }, ctx.emit);
     if (r.error) bad(r.error);

package/lib/dashboard/public/app.js

@@ -300,7 +300,7 @@ async function load(){
   const r = await fetch(withProject('/api/project')); P = await r.json();
   syncSettingsFromServer();
   REMOTE=typeof P.online==='boolean'; // known before the first paint: the brain tab is hidden online
-  render(); setOffline(P);
+  render(); setOffline(P); renderUpdateBar(); notifyOrchestration();
   if(!REMOTE && !brainData) loadBrain();
   if(openTaskId) openDrawer(openTaskId,true);
 }
@@ -315,7 +315,7 @@ function connect(){
     let m; try{ m=JSON.parse(ev.data); }catch{ return; }
     if(m.type==='change'||m.type==='message') return scheduleLoad(); // messages live from runtime.messages
     if(m.type==='brain') return loadBrain();                    // ~/.spectoflow/brain.md changed (page, MCP, run line)
-    if(m.type==='run-start'||m.type==='run-end') { chatState.forEach(st=>{ st.rawBlock=null; }); sseBusy=(m.type==='run-start'); updateChatBusyUI(); return; }
+    if(m.type==='run-start'||m.type==='run-end') { chatState.forEach(st=>{ st.rawBlock=null; }); sseBusy=(m.type==='run-start'); updateChatBusyUI(); if(m.type==='run-end') notify(t(m.code===0?'notify.done':'notify.failed',{project:P&&P.projectName||'spectoflow'}), ''); return; }
     if(m.type==='run-line') return appendRaw(m.chunk);          // raw output is ephemeral (not logged)
   };
   es.onerror = ()=>{ $('#sync').classList.add('offline'); $('#syncLabel').textContent='offline'; };
@@ -386,7 +386,26 @@ function showChatError(message){
     scrollChat(container);
   });
 }
+// Native browser notifications when an agent finishes or a step waits for approval — only while this tab
+// isn't in front (D77). Permission is asked on the user's own click that starts agent work, never unprompted.
+function askNotifyPermission(){ try{ if('Notification' in window && Notification.permission==='default') Notification.requestPermission(); }catch(_){} }
+function notify(title,body){
+  try{
+    if(!document.hidden || !('Notification' in window) || Notification.permission!=='granted') return;
+    const n=new Notification(title,{body,tag:'spectoflow-'+(P&&P.projectName||'')});
+    n.onclick=()=>{ window.focus(); n.close(); };
+  }catch(_){}
+}
+let notifiedApproval='';
+function notifyOrchestration(){
+  const o=P&&P.runtime&&P.runtime.orchestration; if(!o) return;
+  const step=o.steps&&o.steps[o.currentStep];
+  const key=o.status==='awaiting_approval'?`${o.id}:${o.currentStep}`:'';
+  if(key && key!==notifiedApproval){ notify(t('notify.approval',{project:P.projectName||'spectoflow'}), step?step.name:''); }
+  notifiedApproval=key;
+}
 async function postRunRequest(url,body){
+  askNotifyPermission();
   const r=await fetch(withProject(url),{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(body)});
   if(!r.ok){ const d=await r.json().catch(()=>({})); showChatError(d.error||t('files.saveError')); if(/needs your OK/.test(d.error||'')) scheduleLoad(); }
   return r.ok;
@@ -1090,6 +1109,27 @@ function renderUntrustedRunners(){
     row.append(b); box.append(row);
   });
 }
+// The project's framework files are older than the installed spectoflow (D77). Local only.
+const semverLess=(a,b)=>{ const x=String(a||'').split('.').map(Number), y=String(b||'').split('.').map(Number); for(let i=0;i<3;i++){ if((x[i]||0)!==(y[i]||0)) return (x[i]||0)<(y[i]||0); } return false; };
+let updateNote='';
+function renderUpdateBar(){
+  const bar=$('#updateBar'); if(!bar) return;
+  const stale=!REMOTE && P && P.version && P.kitVersion && semverLess(P.version,P.kitVersion);
+  bar.hidden=!stale && !updateNote;
+  $('#updateText').textContent=updateNote || (stale ? t('update.banner',{from:'v'+P.version,to:'v'+P.kitVersion}) : '');
+  $('#updateBtn').hidden=!stale;
+}
+async function updateProject(){
+  const b=$('#updateBtn'); b.disabled=true; flash();
+  try{
+    const r=await fetch(withProject('/api/project/update'),{method:'POST'});
+    const d=await r.json().catch(()=>({}));
+    if(!r.ok) throw new Error(d.error||'error');
+    updateNote=t('update.done',{n:d.refreshed})+(d.review&&d.review.length?' '+t('update.review',{n:d.review.length}):'');
+  }catch(e){ updateNote=t('update.error'); }
+  b.disabled=false; scheduleLoad();
+  setTimeout(()=>{ updateNote=''; renderUpdateBar(); },8000);
+}
 function wfDetailRow(k,v){ const r=el('div','wf-detail-row'); r.append(el('span','wf-detail-k',k), el('span','wf-detail-v',v)); return r; }
 function wfPopFill(pop, s, idx){
   const skill=(P.skills||[]).find(x=>x.name===s.skill);
@@ -2641,7 +2681,9 @@ $('#blAddCancel').addEventListener('click', closeBacklogAddForm);
 $('#blAddSubmit').addEventListener('click', submitBacklogAdd);
 $('#blAddTitle').addEventListener('keydown', e=>{ if(e.key==='Enter') submitBacklogAdd(); });
 // attention tab: add a note + filter chips
+$$('.chat-stop').forEach(b=>b.addEventListener('click',async()=>{ b.disabled=true; flash(); try{ await fetch(withProject('/api/run/stop'),{method:'POST'}); }finally{ setTimeout(()=>{ b.disabled=false; },800); } }));
 $('#wfAnalyzeBtn').addEventListener('click',analyzeWorkflow);
+$('#updateBtn').addEventListener('click',updateProject);
 $('#setWorkflowAuto').addEventListener('change',(e)=>{ if(P&&P.config) P.config.workflowAutoEnable=e.target.checked; saveSetting({workflowAutoEnable:e.target.checked}); });
 $('#brainAutoAdd').addEventListener('change',(e)=>brainAct(()=>brainCall('POST','/api/brain/settings',{autoAdd:e.target.checked})));
 $('#attnAddBtn').addEventListener('click',()=>{ const t=$('#attnInput'); const v=t.value.trim(); if(v){ addAttn(v); t.value=''; } });

package/lib/dashboard/public/i18n.js

@@ -90,6 +90,9 @@ en: {
   'drawer.agent':'Agent','drawer.skill':'Skill','drawer.file':'File · {rel}',
   'drawer.loading':'Loading…','drawer.loadError':'Could not load this file.','files.title':'Files','files.sub':'Browse the project\'s files — view Markdown & HTML, edit any text file, create new ones.','files.newFile':'+ File','files.newFolder':'+ Folder','files.pickFile':'Select a file to view it.','files.empty':'No files yet.','files.edit':'Edit','files.preview':'Preview','files.save':'Save','files.saved':'✓ saved','files.saveError':'Could not save this file.','files.loadError':'Could not load this file.','files.binary':'This file can\'t be previewed here (not text).','files.discardConfirm':'Discard unsaved changes?','files.newFilePrompt':'New file name (e.g. todo.md):','files.newFolderPrompt':'New folder name:','files.projectRoot':'project root','files.creatingIn':'Creating in: {path}','files.refresh':'Refresh','files.discard':'Discard','files.create':'Create',
   'notes.sub':'A freeform scratchpad for this project — Markdown, autosaved as you type. Only you (and whoever else opens this dashboard) can see it.','notes.saving':'Saving…',
+  'notify.done':'{project}: the agent finished','notify.failed':'{project}: the agent stopped with an error','notify.approval':'{project}: a step is waiting for your approval',
+  'update.banner':'This project uses spectoflow {from}; {to} is installed.','update.button':'Update the project','update.done':'Project updated: {n} framework file(s) refreshed.','update.review':'{n} file(s) you had edited: the new version is saved next to each as .new.','update.error':'Could not update the project.',
+  'chat.stop':'Stop',
   'runners.title':'A custom command needs your OK','runners.hint':'This project’s config.json launches an agent with a command other than its default. It only runs once you allow it on this machine.','runners.allow':'Allow on this machine',
   'workflow.analyze':'Analyze the project','workflow.analyzeTitle':'Look at the project and suggest which steps fit it now','workflow.detected':'Detected: {type} · {phase}','workflow.type.app':'application','workflow.type.infra':'infrastructure','workflow.type.data':'data','workflow.phase.design':'design phase, no code yet','workflow.phase.build':'has code','workflow.matches':'Your workflow already matches the project.','workflow.apply':'Apply','workflow.dismiss':'Close','workflow.applied':'{n} step(s) updated.','workflow.analyzeError':'Could not analyze the project.','workflow.on':'on','workflow.off':'off','workflow.reason.always':'always useful','workflow.reason.design-no-code':'no code yet','workflow.reason.has-code':'the project has code','workflow.reason.has-tests':'the project has tests','workflow.reason.infra-no-tests':'infrastructure project with no tests','workflow.reason.data-quality':'data project — data quality tests','workflow.reason.has-integration-tests':'integration tests exist','workflow.reason.no-integration-tests':'no integration tests yet','workflow.reason.has-e2e-setup':'an end-to-end test setup exists','workflow.reason.no-e2e-setup':'no end-to-end test setup','settings.workflowAuto':'Let the agent enable workflow steps when needed','settings.workflowAutoHint':'Off: it asks you first. It never disables a step on its own.',
   'brain.sub':'What spectoflow has learned about you, shared by all your projects and given to your agent in every session. Add or fix anything.','brain.autoAdd':'Add what the agent learns directly','brain.autoAddOn':'New facts are added right away — you can fix or delete them here.','brain.autoAddOff':'New facts wait in “To confirm” until you accept them.','brain.agents':'Reachable by:','brain.agentWired':'Connected: this agent reads and grows your second brain','brain.agentNotWired':'Not connected yet','brain.setupHint':'Run {cmd} to connect the others.','brain.noAgents':'No coding agent found on this machine.','brain.tooMany':'{n} entries — all of it is given to your agent in every session. Consider removing what is no longer true.','brain.empty':'Nothing yet. As you work, your agent notes durable things about you here — your role, your preferences, how you like to work, what to avoid. You can also add them yourself below.','brain.toConfirm':'To confirm','brain.confirm':'Confirm','brain.confirmAll':'Confirm all','brain.reject':'Reject','brain.cat.profile':'Profile','brain.cat.preferences':'Preferences','brain.cat.workflow':'Working style','brain.cat.avoid':'Avoid','brain.catHint.profile':'Who you are: role, skills, context.','brain.catHint.preferences':'Tools, languages, code style, formats you prefer.','brain.catHint.workflow':'How you like the agent to work with you.','brain.catHint.avoid':'What the agent should never do.','brain.catEmpty':'Nothing here yet.','brain.addPlaceholder':'Add a fact…','brain.duplicate':'Already in your second brain.','brain.byAgent':'learned by the agent','brain.byYou':'added by you','brain.path':'Stored in {path} — never inside a project.','brain.error':'Could not reach your second brain.',
@@ -212,6 +215,9 @@ fr: {
   'drawer.agent':'Agent','drawer.skill':'Compétence','drawer.file':'Fichier · {rel}',
   'drawer.loading':'Chargement…','drawer.loadError':'Impossible de charger ce fichier.','files.title':'Fichiers','files.sub':'Parcourez les fichiers du projet — visualisez Markdown et HTML, modifiez tout fichier texte, créez-en de nouveaux.','files.newFile':'+ Fichier','files.newFolder':'+ Dossier','files.pickFile':'Sélectionnez un fichier pour l’afficher.','files.empty':'Aucun fichier pour l’instant.','files.edit':'Modifier','files.preview':'Aperçu','files.save':'Enregistrer','files.saved':'✓ enregistré','files.saveError':'Impossible d’enregistrer ce fichier.','files.loadError':'Impossible de charger ce fichier.','files.binary':'Ce fichier ne peut pas être prévisualisé ici (non textuel).','files.discardConfirm':'Abandonner les modifications non enregistrées ?','files.newFilePrompt':'Nom du nouveau fichier (ex. todo.md) :','files.newFolderPrompt':'Nom du nouveau dossier :','files.projectRoot':'racine du projet','files.creatingIn':'Création dans : {path}','files.refresh':'Actualiser','files.discard':'Annuler','files.create':'Créer',
   'notes.sub':'Un bloc-note libre pour ce projet — Markdown, enregistré automatiquement au fil de la frappe. Visible uniquement par vous (et quiconque ouvre ce tableau de bord).','notes.saving':'Enregistrement…',
+  'notify.done':'{project} : l’agent a terminé','notify.failed':'{project} : l’agent s’est arrêté sur une erreur','notify.approval':'{project} : une étape attend votre approbation',
+  'update.banner':'Ce projet utilise spectoflow {from} ; {to} est installé.','update.button':'Mettre à jour le projet','update.done':'Projet mis à jour : {n} fichier(s) du framework rafraîchi(s).','update.review':'{n} fichier(s) que vous aviez modifié(s) : la nouvelle version est enregistrée à côté en .new.','update.error':'Impossible de mettre à jour le projet.',
+  'chat.stop':'Arrêter',
   'runners.title':'Une commande personnalisée attend votre accord','runners.hint':'Le config.json de ce projet lance un agent avec une commande différente de celle par défaut. Elle ne s’exécute qu’une fois autorisée sur cette machine.','runners.allow':'Autoriser sur cette machine',
   'workflow.analyze':'Analyser le projet','workflow.analyzeTitle':'Examiner le projet et proposer les étapes qui lui conviennent maintenant','workflow.detected':'Détecté : {type} · {phase}','workflow.type.app':'application','workflow.type.infra':'infrastructure','workflow.type.data':'données','workflow.phase.design':'phase de conception, pas encore de code','workflow.phase.build':'contient du code','workflow.matches':'Votre workflow correspond déjà au projet.','workflow.apply':'Appliquer','workflow.dismiss':'Fermer','workflow.applied':'{n} étape(s) mise(s) à jour.','workflow.analyzeError':'Impossible d’analyser le projet.','workflow.on':'activée','workflow.off':'désactivée','workflow.reason.always':'toujours utile','workflow.reason.design-no-code':'pas encore de code','workflow.reason.has-code':'le projet contient du code','workflow.reason.has-tests':'le projet a des tests','workflow.reason.infra-no-tests':'projet d’infrastructure sans tests','workflow.reason.data-quality':'projet de données — tests de qualité des données','workflow.reason.has-integration-tests':'des tests d’intégration existent','workflow.reason.no-integration-tests':'pas encore de tests d’intégration','workflow.reason.has-e2e-setup':'une configuration de tests de bout en bout existe','workflow.reason.no-e2e-setup':'pas de configuration de tests de bout en bout','settings.workflowAuto':'Laisser l’agent activer les étapes du workflow quand il faut','settings.workflowAutoHint':'Désactivé : il vous demande d’abord. Il ne désactive jamais une étape de lui-même.',
   'brain.sub':'Ce que spectoflow a appris sur vous, partagé par tous vos projets et donné à votre agent à chaque session. Ajoutez ou corrigez ce que vous voulez.','brain.autoAdd':'Ajouter directement ce que l’agent apprend','brain.autoAddOn':'Les nouveaux faits sont ajoutés tout de suite — vous pouvez les corriger ou les supprimer ici.','brain.autoAddOff':'Les nouveaux faits attendent dans « À confirmer » jusqu’à votre validation.','brain.agents':'Accessible par :','brain.agentWired':'Connecté : cet agent lit et enrichit votre second cerveau','brain.agentNotWired':'Pas encore connecté','brain.setupHint':'Lancez {cmd} pour connecter les autres.','brain.noAgents':'Aucun agent de code trouvé sur cette machine.','brain.tooMany':'{n} entrées — tout est donné à votre agent à chaque session. Pensez à retirer ce qui n’est plus vrai.','brain.empty':'Rien pour l’instant. Au fil de votre travail, votre agent note ici des choses durables sur vous — votre rôle, vos préférences, votre façon de travailler, ce qu’il faut éviter. Vous pouvez aussi les ajouter vous-même ci-dessous.','brain.toConfirm':'À confirmer','brain.confirm':'Confirmer','brain.confirmAll':'Tout confirmer','brain.reject':'Rejeter','brain.cat.profile':'Profil','brain.cat.preferences':'Préférences','brain.cat.workflow':'Façon de travailler','brain.cat.avoid':'À éviter','brain.catHint.profile':'Qui vous êtes : rôle, compétences, contexte.','brain.catHint.preferences':'Outils, langues, style de code, formats que vous préférez.','brain.catHint.workflow':'Comment vous aimez que l’agent travaille avec vous.','brain.catHint.avoid':'Ce que l’agent ne doit jamais faire.','brain.catEmpty':'Rien ici pour l’instant.','brain.addPlaceholder':'Ajouter un fait…','brain.duplicate':'Déjà dans votre second cerveau.','brain.byAgent':'appris par l’agent','brain.byYou':'ajouté par vous','brain.path':'Stocké dans {path} — jamais dans un projet.','brain.error':'Impossible d’accéder à votre second cerveau.',
@@ -334,6 +340,9 @@ es: {
   'drawer.agent':'Agente','drawer.skill':'Habilidad','drawer.file':'Archivo · {rel}',
   'drawer.loading':'Cargando…','drawer.loadError':'No se pudo cargar este archivo.','files.title':'Archivos','files.sub':'Explora los archivos del proyecto — visualiza Markdown y HTML, edita cualquier archivo de texto, crea otros nuevos.','files.newFile':'+ Archivo','files.newFolder':'+ Carpeta','files.pickFile':'Selecciona un archivo para verlo.','files.empty':'Aún no hay archivos.','files.edit':'Editar','files.preview':'Vista previa','files.save':'Guardar','files.saved':'✓ guardado','files.saveError':'No se pudo guardar este archivo.','files.loadError':'No se pudo cargar este archivo.','files.binary':'Este archivo no se puede previsualizar aquí (no es texto).','files.discardConfirm':'¿Descartar los cambios sin guardar?','files.newFilePrompt':'Nombre del nuevo archivo (p. ej. todo.md):','files.newFolderPrompt':'Nombre de la nueva carpeta:','files.projectRoot':'raíz del proyecto','files.creatingIn':'Creando en: {path}','files.refresh':'Actualizar','files.discard':'Descartar','files.create':'Crear',
   'notes.sub':'Un bloc de notas libre para este proyecto — Markdown, guardado automáticamente mientras escribes. Solo tú (y quien más abra este panel) puedes verlo.','notes.saving':'Guardando…',
+  'notify.done':'{project}: el agente ha terminado','notify.failed':'{project}: el agente se detuvo con un error','notify.approval':'{project}: un paso espera tu aprobación',
+  'update.banner':'Este proyecto usa spectoflow {from}; está instalado {to}.','update.button':'Actualizar el proyecto','update.done':'Proyecto actualizado: {n} archivo(s) del framework renovado(s).','update.review':'{n} archivo(s) que habías editado: la nueva versión se guarda al lado como .new.','update.error':'No se pudo actualizar el proyecto.',
+  'chat.stop':'Detener',
   'runners.title':'Un comando personalizado espera tu aprobación','runners.hint':'El config.json de este proyecto lanza un agente con un comando distinto del predeterminado. Solo se ejecuta cuando lo autorizas en esta máquina.','runners.allow':'Autorizar en esta máquina',
   'workflow.analyze':'Analizar el proyecto','workflow.analyzeTitle':'Examinar el proyecto y proponer los pasos que le convienen ahora','workflow.detected':'Detectado: {type} · {phase}','workflow.type.app':'aplicación','workflow.type.infra':'infraestructura','workflow.type.data':'datos','workflow.phase.design':'fase de diseño, aún sin código','workflow.phase.build':'tiene código','workflow.matches':'Tu workflow ya corresponde al proyecto.','workflow.apply':'Aplicar','workflow.dismiss':'Cerrar','workflow.applied':'{n} paso(s) actualizado(s).','workflow.analyzeError':'No se pudo analizar el proyecto.','workflow.on':'activado','workflow.off':'desactivado','workflow.reason.always':'siempre útil','workflow.reason.design-no-code':'aún no hay código','workflow.reason.has-code':'el proyecto tiene código','workflow.reason.has-tests':'el proyecto tiene tests','workflow.reason.infra-no-tests':'proyecto de infraestructura sin tests','workflow.reason.data-quality':'proyecto de datos — tests de calidad de datos','workflow.reason.has-integration-tests':'existen tests de integración','workflow.reason.no-integration-tests':'aún no hay tests de integración','workflow.reason.has-e2e-setup':'existe una configuración de tests end-to-end','workflow.reason.no-e2e-setup':'no hay configuración de tests end-to-end','settings.workflowAuto':'Dejar que el agente active pasos del workflow cuando haga falta','settings.workflowAutoHint':'Desactivado: te pregunta antes. Nunca desactiva un paso por su cuenta.',
   'brain.sub':'Lo que spectoflow ha aprendido sobre ti, compartido por todos tus proyectos y dado a tu agente en cada sesión. Añade o corrige lo que quieras.','brain.autoAdd':'Añadir directamente lo que aprende el agente','brain.autoAddOn':'Los nuevos datos se añaden al instante — puedes corregirlos o borrarlos aquí.','brain.autoAddOff':'Los nuevos datos esperan en «Por confirmar» hasta que los aceptes.','brain.agents':'Accesible por:','brain.agentWired':'Conectado: este agente lee y amplía tu segundo cerebro','brain.agentNotWired':'Aún no conectado','brain.setupHint':'Ejecuta {cmd} para conectar los demás.','brain.noAgents':'No se encontró ningún agente de código en esta máquina.','brain.tooMany':'{n} entradas — todo se da a tu agente en cada sesión. Plantéate quitar lo que ya no sea cierto.','brain.empty':'Nada todavía. Mientras trabajas, tu agente anota aquí cosas duraderas sobre ti — tu rol, tus preferencias, cómo te gusta trabajar, qué evitar. También puedes añadirlas tú abajo.','brain.toConfirm':'Por confirmar','brain.confirm':'Confirmar','brain.confirmAll':'Confirmar todo','brain.reject':'Rechazar','brain.cat.profile':'Perfil','brain.cat.preferences':'Preferencias','brain.cat.workflow':'Forma de trabajar','brain.cat.avoid':'Evitar','brain.catHint.profile':'Quién eres: rol, habilidades, contexto.','brain.catHint.preferences':'Herramientas, idiomas, estilo de código, formatos que prefieres.','brain.catHint.workflow':'Cómo te gusta que el agente trabaje contigo.','brain.catHint.avoid':'Lo que el agente nunca debe hacer.','brain.catEmpty':'Nada aquí todavía.','brain.addPlaceholder':'Añadir un dato…','brain.duplicate':'Ya está en tu segundo cerebro.','brain.byAgent':'aprendido por el agente','brain.byYou':'añadido por ti','brain.path':'Guardado en {path} — nunca dentro de un proyecto.','brain.error':'No se pudo acceder a tu segundo cerebro.',
@@ -456,6 +465,9 @@ de: {
   'drawer.agent':'Agent','drawer.skill':'Skill','drawer.file':'Datei · {rel}',
   'drawer.loading':'Lädt…','drawer.loadError':'Diese Datei konnte nicht geladen werden.','files.title':'Dateien','files.sub':'Durchsuche die Projektdateien — Markdown & HTML ansehen, jede Textdatei bearbeiten, neue erstellen.','files.newFile':'+ Datei','files.newFolder':'+ Ordner','files.pickFile':'Wähle eine Datei aus, um sie anzuzeigen.','files.empty':'Noch keine Dateien.','files.edit':'Bearbeiten','files.preview':'Vorschau','files.save':'Speichern','files.saved':'✓ gespeichert','files.saveError':'Diese Datei konnte nicht gespeichert werden.','files.loadError':'Diese Datei konnte nicht geladen werden.','files.binary':'Diese Datei kann hier nicht angezeigt werden (kein Text).','files.discardConfirm':'Nicht gespeicherte Änderungen verwerfen?','files.newFilePrompt':'Name der neuen Datei (z. B. todo.md):','files.newFolderPrompt':'Name des neuen Ordners:','files.projectRoot':'Projektstamm','files.creatingIn':'Erstellen in: {path}','files.refresh':'Aktualisieren','files.discard':'Verwerfen','files.create':'Erstellen',
   'notes.sub':'Ein freier Notizblock für dieses Projekt — Markdown, automatisch gespeichert während der Eingabe. Nur du (und wer sonst dieses Dashboard öffnet) siehst ihn.','notes.saving':'Speichert…',
+  'notify.done':'{project}: der Agent ist fertig','notify.failed':'{project}: der Agent hat mit einem Fehler aufgehört','notify.approval':'{project}: ein Schritt wartet auf deine Freigabe',
+  'update.banner':'Dieses Projekt nutzt spectoflow {from}; installiert ist {to}.','update.button':'Projekt aktualisieren','update.done':'Projekt aktualisiert: {n} Framework-Datei(en) erneuert.','update.review':'{n} von dir bearbeitete Datei(en): die neue Version liegt jeweils daneben als .new.','update.error':'Das Projekt konnte nicht aktualisiert werden.',
+  'chat.stop':'Stoppen',
   'runners.title':'Ein eigener Befehl braucht deine Zustimmung','runners.hint':'Die config.json dieses Projekts startet einen Agenten mit einem anderen als dem Standardbefehl. Er läuft erst, wenn du ihn auf diesem Rechner erlaubst.','runners.allow':'Auf diesem Rechner erlauben',
   'workflow.analyze':'Projekt analysieren','workflow.analyzeTitle':'Das Projekt ansehen und vorschlagen, welche Schritte jetzt passen','workflow.detected':'Erkannt: {type} · {phase}','workflow.type.app':'Anwendung','workflow.type.infra':'Infrastruktur','workflow.type.data':'Daten','workflow.phase.design':'Entwurfsphase, noch kein Code','workflow.phase.build':'enthält Code','workflow.matches':'Dein Workflow passt bereits zum Projekt.','workflow.apply':'Anwenden','workflow.dismiss':'Schließen','workflow.applied':'{n} Schritt(e) aktualisiert.','workflow.analyzeError':'Das Projekt konnte nicht analysiert werden.','workflow.on':'an','workflow.off':'aus','workflow.reason.always':'immer nützlich','workflow.reason.design-no-code':'noch kein Code','workflow.reason.has-code':'das Projekt enthält Code','workflow.reason.has-tests':'das Projekt hat Tests','workflow.reason.infra-no-tests':'Infrastrukturprojekt ohne Tests','workflow.reason.data-quality':'Datenprojekt — Datenqualitätstests','workflow.reason.has-integration-tests':'Integrationstests vorhanden','workflow.reason.no-integration-tests':'noch keine Integrationstests','workflow.reason.has-e2e-setup':'ein End-to-End-Test-Setup ist vorhanden','workflow.reason.no-e2e-setup':'kein End-to-End-Test-Setup','settings.workflowAuto':'Den Agenten Workflow-Schritte bei Bedarf aktivieren lassen','settings.workflowAutoHint':'Aus: er fragt dich vorher. Er deaktiviert nie selbst einen Schritt.',
   'brain.sub':'Was spectoflow über dich gelernt hat — geteilt von all deinen Projekten und deinem Agenten in jeder Sitzung mitgegeben. Ergänze oder korrigiere, was du willst.','brain.autoAdd':'Was der Agent lernt, direkt hinzufügen','brain.autoAddOn':'Neue Fakten werden sofort hinzugefügt — du kannst sie hier korrigieren oder löschen.','brain.autoAddOff':'Neue Fakten warten unter „Zu bestätigen“, bis du sie annimmst.','brain.agents':'Erreichbar für:','brain.agentWired':'Verbunden: dieser Agent liest und erweitert dein zweites Gehirn','brain.agentNotWired':'Noch nicht verbunden','brain.setupHint':'Führe {cmd} aus, um die anderen zu verbinden.','brain.noAgents':'Kein Coding-Agent auf diesem Rechner gefunden.','brain.tooMany':'{n} Einträge — alles wird deinem Agenten in jeder Sitzung mitgegeben. Entferne, was nicht mehr stimmt.','brain.empty':'Noch nichts. Während du arbeitest, notiert dein Agent hier Dauerhaftes über dich — deine Rolle, deine Vorlieben, wie du gern arbeitest, was zu vermeiden ist. Du kannst sie auch unten selbst hinzufügen.','brain.toConfirm':'Zu bestätigen','brain.confirm':'Bestätigen','brain.confirmAll':'Alle bestätigen','brain.reject':'Ablehnen','brain.cat.profile':'Profil','brain.cat.preferences':'Vorlieben','brain.cat.workflow':'Arbeitsweise','brain.cat.avoid':'Vermeiden','brain.catHint.profile':'Wer du bist: Rolle, Fähigkeiten, Kontext.','brain.catHint.preferences':'Werkzeuge, Sprachen, Code-Stil, Formate, die du bevorzugst.','brain.catHint.workflow':'Wie der Agent mit dir arbeiten soll.','brain.catHint.avoid':'Was der Agent nie tun soll.','brain.catEmpty':'Hier ist noch nichts.','brain.addPlaceholder':'Fakt hinzufügen…','brain.duplicate':'Schon in deinem zweiten Gehirn.','brain.byAgent':'vom Agenten gelernt','brain.byYou':'von dir hinzugefügt','brain.path':'Gespeichert in {path} — nie in einem Projekt.','brain.error':'Dein zweites Gehirn ist nicht erreichbar.',
@@ -578,6 +590,9 @@ pt: {
   'drawer.agent':'Agente','drawer.skill':'Habilidade','drawer.file':'Ficheiro · {rel}',
   'drawer.loading':'A carregar…','drawer.loadError':'Não foi possível carregar este ficheiro.','files.title':'Ficheiros','files.sub':'Percorra os ficheiros do projeto — veja Markdown e HTML, edite qualquer ficheiro de texto, crie novos.','files.newFile':'+ Ficheiro','files.newFolder':'+ Pasta','files.pickFile':'Selecione um ficheiro para o ver.','files.empty':'Ainda não há ficheiros.','files.edit':'Editar','files.preview':'Pré-visualizar','files.save':'Guardar','files.saved':'✓ guardado','files.saveError':'Não foi possível guardar este ficheiro.','files.loadError':'Não foi possível carregar este ficheiro.','files.binary':'Este ficheiro não pode ser pré-visualizado aqui (não é texto).','files.discardConfirm':'Descartar alterações não guardadas?','files.newFilePrompt':'Nome do novo ficheiro (ex. todo.md):','files.newFolderPrompt':'Nome da nova pasta:','files.projectRoot':'raiz do projeto','files.creatingIn':'A criar em: {path}','files.refresh':'Atualizar','files.discard':'Descartar','files.create':'Criar',
   'notes.sub':'Um bloco de notas livre para este projeto — Markdown, guardado automaticamente enquanto escreve. Só você (e quem mais abrir este painel) o vê.','notes.saving':'A guardar…',
+  'notify.done':'{project}: o agente terminou','notify.failed':'{project}: o agente parou com um erro','notify.approval':'{project}: um passo aguarda a sua aprovação',
+  'update.banner':'Este projeto usa spectoflow {from}; está instalado {to}.','update.button':'Atualizar o projeto','update.done':'Projeto atualizado: {n} ficheiro(s) do framework renovado(s).','update.review':'{n} ficheiro(s) que tinha editado: a nova versão fica ao lado como .new.','update.error':'Não foi possível atualizar o projeto.',
+  'chat.stop':'Parar',
   'runners.title':'Um comando personalizado aguarda a sua aprovação','runners.hint':'O config.json deste projeto inicia um agente com um comando diferente do predefinido. Só é executado depois de o autorizar nesta máquina.','runners.allow':'Autorizar nesta máquina',
   'workflow.analyze':'Analisar o projeto','workflow.analyzeTitle':'Examinar o projeto e propor os passos que lhe convêm agora','workflow.detected':'Detetado: {type} · {phase}','workflow.type.app':'aplicação','workflow.type.infra':'infraestrutura','workflow.type.data':'dados','workflow.phase.design':'fase de conceção, ainda sem código','workflow.phase.build':'tem código','workflow.matches':'O seu workflow já corresponde ao projeto.','workflow.apply':'Aplicar','workflow.dismiss':'Fechar','workflow.applied':'{n} passo(s) atualizado(s).','workflow.analyzeError':'Não foi possível analisar o projeto.','workflow.on':'ativado','workflow.off':'desativado','workflow.reason.always':'sempre útil','workflow.reason.design-no-code':'ainda sem código','workflow.reason.has-code':'o projeto tem código','workflow.reason.has-tests':'o projeto tem testes','workflow.reason.infra-no-tests':'projeto de infraestrutura sem testes','workflow.reason.data-quality':'projeto de dados — testes de qualidade de dados','workflow.reason.has-integration-tests':'existem testes de integração','workflow.reason.no-integration-tests':'ainda sem testes de integração','workflow.reason.has-e2e-setup':'existe uma configuração de testes ponta a ponta','workflow.reason.no-e2e-setup':'sem configuração de testes ponta a ponta','settings.workflowAuto':'Deixar o agente ativar passos do workflow quando necessário','settings.workflowAutoHint':'Desativado: pergunta-lhe primeiro. Nunca desativa um passo por conta própria.',
   'brain.sub':'O que o spectoflow aprendeu sobre si, partilhado por todos os seus projetos e dado ao seu agente em cada sessão. Acrescente ou corrija o que quiser.','brain.autoAdd':'Adicionar diretamente o que o agente aprende','brain.autoAddOn':'Os novos factos são adicionados de imediato — pode corrigi-los ou apagá-los aqui.','brain.autoAddOff':'Os novos factos esperam em «A confirmar» até os aceitar.','brain.agents':'Acessível por:','brain.agentWired':'Ligado: este agente lê e enriquece o seu segundo cérebro','brain.agentNotWired':'Ainda não ligado','brain.setupHint':'Execute {cmd} para ligar os outros.','brain.noAgents':'Nenhum agente de código encontrado nesta máquina.','brain.tooMany':'{n} entradas — tudo é dado ao seu agente em cada sessão. Pense em retirar o que já não é verdade.','brain.empty':'Ainda nada. À medida que trabalha, o seu agente anota aqui coisas duradouras sobre si — o seu papel, as suas preferências, como gosta de trabalhar, o que evitar. Também as pode adicionar abaixo.','brain.toConfirm':'A confirmar','brain.confirm':'Confirmar','brain.confirmAll':'Confirmar tudo','brain.reject':'Rejeitar','brain.cat.profile':'Perfil','brain.cat.preferences':'Preferências','brain.cat.workflow':'Forma de trabalhar','brain.cat.avoid':'A evitar','brain.catHint.profile':'Quem é: papel, competências, contexto.','brain.catHint.preferences':'Ferramentas, línguas, estilo de código, formatos que prefere.','brain.catHint.workflow':'Como gosta que o agente trabalhe consigo.','brain.catHint.avoid':'O que o agente nunca deve fazer.','brain.catEmpty':'Ainda nada aqui.','brain.addPlaceholder':'Adicionar um facto…','brain.duplicate':'Já está no seu segundo cérebro.','brain.byAgent':'aprendido pelo agente','brain.byYou':'adicionado por si','brain.path':'Guardado em {path} — nunca dentro de um projeto.','brain.error':'Não foi possível aceder ao seu segundo cérebro.',
@@ -700,6 +715,9 @@ it: {
   'drawer.agent':'Agente','drawer.skill':'Skill','drawer.file':'File · {rel}',
   'drawer.loading':'Caricamento…','drawer.loadError':'Impossibile caricare questo file.','files.title':'File','files.sub':'Sfoglia i file del progetto — visualizza Markdown e HTML, modifica qualsiasi file di testo, creane di nuovi.','files.newFile':'+ File','files.newFolder':'+ Cartella','files.pickFile':'Seleziona un file per visualizzarlo.','files.empty':'Nessun file ancora.','files.edit':'Modifica','files.preview':'Anteprima','files.save':'Salva','files.saved':'✓ salvato','files.saveError':'Impossibile salvare questo file.','files.loadError':'Impossibile caricare questo file.','files.binary':'Questo file non può essere visualizzato qui (non è testo).','files.discardConfirm':'Scartare le modifiche non salvate?','files.newFilePrompt':'Nome del nuovo file (es. todo.md):','files.newFolderPrompt':'Nome della nuova cartella:','files.projectRoot':'radice del progetto','files.creatingIn':'Creazione in: {path}','files.refresh':'Aggiorna','files.discard':'Scarta','files.create':'Crea',
   'notes.sub':'Un blocco note libero per questo progetto — Markdown, salvato automaticamente mentre scrivi. Solo tu (e chiunque altro apra questa dashboard) puoi vederlo.','notes.saving':'Salvataggio…',
+  'notify.done':'{project}: l’agente ha finito','notify.failed':'{project}: l’agente si è fermato con un errore','notify.approval':'{project}: un passo attende la tua approvazione',
+  'update.banner':'Questo progetto usa spectoflow {from}; è installato {to}.','update.button':'Aggiorna il progetto','update.done':'Progetto aggiornato: {n} file del framework rinnovati.','update.review':'{n} file che avevi modificato: la nuova versione è salvata accanto come .new.','update.error':'Impossibile aggiornare il progetto.',
+  'chat.stop':'Ferma',
   'runners.title':'Un comando personalizzato attende la tua approvazione','runners.hint':'Il config.json di questo progetto avvia un agente con un comando diverso da quello predefinito. Viene eseguito solo dopo che lo autorizzi su questa macchina.','runners.allow':'Autorizza su questa macchina',
   'workflow.analyze':'Analizza il progetto','workflow.analyzeTitle':'Esaminare il progetto e proporre i passi adatti ora','workflow.detected':'Rilevato: {type} · {phase}','workflow.type.app':'applicazione','workflow.type.infra':'infrastruttura','workflow.type.data':'dati','workflow.phase.design':'fase di progettazione, ancora nessun codice','workflow.phase.build':'contiene codice','workflow.matches':'Il tuo workflow corrisponde già al progetto.','workflow.apply':'Applica','workflow.dismiss':'Chiudi','workflow.applied':'{n} passo/i aggiornato/i.','workflow.analyzeError':'Impossibile analizzare il progetto.','workflow.on':'attivo','workflow.off':'disattivo','workflow.reason.always':'sempre utile','workflow.reason.design-no-code':'ancora nessun codice','workflow.reason.has-code':'il progetto contiene codice','workflow.reason.has-tests':'il progetto ha dei test','workflow.reason.infra-no-tests':'progetto di infrastruttura senza test','workflow.reason.data-quality':'progetto di dati — test di qualità dei dati','workflow.reason.has-integration-tests':'esistono test di integrazione','workflow.reason.no-integration-tests':'ancora nessun test di integrazione','workflow.reason.has-e2e-setup':'esiste una configurazione di test end-to-end','workflow.reason.no-e2e-setup':'nessuna configurazione di test end-to-end','settings.workflowAuto':'Lascia che l’agente attivi i passi del workflow quando serve','settings.workflowAutoHint':'Disattivato: ti chiede prima. Non disattiva mai un passo da solo.',
   'brain.sub':'Ciò che spectoflow ha imparato su di te, condiviso da tutti i tuoi progetti e dato al tuo agente in ogni sessione. Aggiungi o correggi ciò che vuoi.','brain.autoAdd':'Aggiungi direttamente ciò che l’agente impara','brain.autoAddOn':'I nuovi fatti vengono aggiunti subito — puoi correggerli o eliminarli qui.','brain.autoAddOff':'I nuovi fatti attendono in «Da confermare» finché non li accetti.','brain.agents':'Raggiungibile da:','brain.agentWired':'Collegato: questo agente legge e arricchisce il tuo secondo cervello','brain.agentNotWired':'Non ancora collegato','brain.setupHint':'Esegui {cmd} per collegare gli altri.','brain.noAgents':'Nessun agente di programmazione trovato su questa macchina.','brain.tooMany':'{n} voci — tutto viene dato al tuo agente in ogni sessione. Valuta di rimuovere ciò che non è più vero.','brain.empty':'Ancora niente. Mentre lavori, il tuo agente annota qui cose durature su di te — il tuo ruolo, le tue preferenze, come ti piace lavorare, cosa evitare. Puoi anche aggiungerle tu qui sotto.','brain.toConfirm':'Da confermare','brain.confirm':'Conferma','brain.confirmAll':'Conferma tutto','brain.reject':'Rifiuta','brain.cat.profile':'Profilo','brain.cat.preferences':'Preferenze','brain.cat.workflow':'Modo di lavorare','brain.cat.avoid':'Da evitare','brain.catHint.profile':'Chi sei: ruolo, competenze, contesto.','brain.catHint.preferences':'Strumenti, lingue, stile di codice, formati che preferisci.','brain.catHint.workflow':'Come ti piace che l’agente lavori con te.','brain.catHint.avoid':'Ciò che l’agente non deve mai fare.','brain.catEmpty':'Ancora niente qui.','brain.addPlaceholder':'Aggiungi un fatto…','brain.duplicate':'Già nel tuo secondo cervello.','brain.byAgent':'imparato dall’agente','brain.byYou':'aggiunto da te','brain.path':'Salvato in {path} — mai dentro un progetto.','brain.error':'Impossibile raggiungere il tuo secondo cervello.',

package/lib/dashboard/public/index.html

@@ -79,6 +79,7 @@
   </header>
 
   <div class="offline-bar" id="offlineBar" hidden><span class="offline-dot"></span><span id="offlineText"></span></div>
+  <div class="update-bar" id="updateBar" hidden><span id="updateText"></span> <button class="btn btn-xs" id="updateBtn" type="button" data-i18n="update.button">Update the project</button></div>
 
   <main class="stage">
     <!-- BOARD -->
@@ -358,7 +359,7 @@
           </div>
         </div>
         <p class="chat-warn" data-i18n-html="chat.warn">⚠ Launches a real agent (<code>config.json → runners</code>) that can modify files &amp; run commands.</p>
-        <p class="chat-status" id="tabChatStatus" hidden><span class="spinner" aria-hidden="true"></span><span data-i18n="chat.running">Agent running…</span></p>
+        <p class="chat-status" id="tabChatStatus" hidden><span class="spinner" aria-hidden="true"></span><span data-i18n="chat.running">Agent running…</span> <button class="btn btn-xs chat-stop" type="button" data-i18n="chat.stop">Stop</button></p>
       </div>
     </section>
 
@@ -499,7 +500,7 @@
       <button id="orchBtn" class="btn chat-send" data-i18n-title="chat.orchestrateTitle" data-i18n="action.orchestrate" title="Walk the enabled workflow">Orchestrate</button>
     </div>
     <p class="chat-warn" data-i18n-html="chat.warn">⚠ Launches a real agent (<code>config.json → runners</code>) that can modify files &amp; run commands.</p>
-    <p class="chat-status" id="widgetChatStatus" hidden><span class="spinner" aria-hidden="true"></span><span data-i18n="chat.running">Agent running…</span></p>
+    <p class="chat-status" id="widgetChatStatus" hidden><span class="spinner" aria-hidden="true"></span><span data-i18n="chat.running">Agent running…</span> <button class="btn btn-xs chat-stop" type="button" data-i18n="chat.stop">Stop</button></p>
   </div>
 
   <!-- Slash-command autocomplete popover, reused by both #runPrompt and #tabRunPrompt (app.js) -->

package/lib/dashboard/public/styles.css

@@ -659,6 +659,10 @@ body.booting .ring-svg circle:last-of-type { transform-origin:center; animation:
 .attn-edit { width:100%; min-height:64px; font-family:inherit; font-size:14px; padding:8px; border:1px solid var(--cool); border-radius:8px; background:var(--surface-2); color:var(--ink); box-sizing:border-box; }
 .attn-actions { display:flex; flex-wrap:wrap; gap:8px; margin-top:11px; }
 
+/* ---- Project framework older than the installed spectoflow (D77) ---- */
+.update-bar { display:flex; flex-wrap:wrap; align-items:center; gap:6px 10px; padding:7px 22px; font-size:12.5px; background:color-mix(in srgb,var(--signal) 12%,var(--surface)); border-bottom:1px solid var(--line); color:var(--ink); }
+.update-bar[hidden] { display:none; }
+
 /* ---- Custom agent commands awaiting the user's OK (D76) ---- */
 .runner-trust { border:1px solid color-mix(in srgb,var(--s-blocked) 45%,var(--line)); border-radius:var(--radius); padding:10px 12px; display:flex; flex-direction:column; gap:8px; }
 .runner-trust[hidden] { display:none; }

package/lib/dashboard/routes.js

@@ -23,13 +23,15 @@ const ROUTES = [
   ['GET', '/api/workflow/suggest', 'workflow.suggest', () => ({})],
   ['POST', '/api/workflow/apply', 'workflow.apply', (_u, b) => b],
   ['POST', '/api/run', 'run.start', (_u, b) => b],
+  ['POST', '/api/run/stop', 'run.stop', () => ({})],
   ['POST', '/api/chat/summarize', 'chat.summarize', (_u, b) => b],
   ['POST', '/api/meeting/generate', 'meeting.generate', (_u, b) => b],
   ['POST', '/api/chat/clear', 'chat.clear', () => ({})],
   ['POST', '/api/orchestrate', 'orchestrate.start', (_u, b) => b],
   ['POST', '/api/orchestrate/approve', 'orchestrate.approve', (_u, b) => b],
   ['POST', '/api/settings', 'settings.save', (_u, b) => b],
-  // Local only — deliberately absent from server/src/relay.js's OP_PERMISSIONS (D76).
+  // Local only — deliberately absent from server/src/relay.js's OP_PERMISSIONS (D76, D77).
+  ['POST', '/api/project/update', 'project.update', () => ({})],
   ['POST', '/api/runners/trust', 'runners.trust', (_u, b) => b],
   ['POST', '/api/attention', 'attention.add', (_u, b) => b],
   ['POST', /^\/api\/attention\/[^/]+\/promote$/, 'attention.promote', (_u, _b, p) => ({ id: seg(p, 3) })],

package/lib/dashboard/runner.js

@@ -7,6 +7,7 @@
  *
  * Kept separate from the HTTP layer so the pipeline is unit-testable without a server.
  */
+const path = require('path');
 const { spawn } = require('child_process');
 const store = require('../store');
 const adapters = require('../adapters');
@@ -25,12 +26,39 @@ function resolveRunnerCommand(root, cfg, which, opts) {
   return null;
 }
 
+// Agent processes in flight, per project — so a stuck one can be stopped from the dashboard. Runs, summaries
+// and meeting notes all register here.
+const inFlight = new Map();
+function trackChild(root, child) {
+  const key = path.resolve(root);
+  if (!inFlight.has(key)) inFlight.set(key, new Set());
+  inFlight.get(key).add(child);
+  child.on('close', () => { const set = inFlight.get(key); if (set) set.delete(child); });
+}
+// Stop every agent process running for this project → how many were signalled.
+function stopRuns(root) {
+  const set = inFlight.get(path.resolve(root));
+  if (!set || !set.size) return 0;
+  for (const child of set) { try { child.kill(); } catch (_) {} }
+  return set.size;
+}
+// After a crash or restart, runs recorded as running can't be: mark them interrupted.
+function reconcileRunsOnBoot(root) {
+  const rt = store.readRuntime(root);
+  const stale = (rt.agents || []).filter((a) => a.status === 'running');
+  if (!stale.length) return 0;
+  const now = new Date().toISOString();
+  stale.forEach((a) => { a.status = 'interrupted'; a.endedAt = a.endedAt || now; });
+  store.writeRuntime(root, rt);
+  return stale.length;
+}
+
 function runStart(root, run) {
   const rt = store.readRuntime(root); rt.agents = rt.agents || []; rt.agents.push(run); store.writeRuntime(root, rt);
 }
-function runEnd(root, id, code) {
+function runEnd(root, id, code, signal) {
   const rt = store.readRuntime(root); const a = (rt.agents || []).find((x) => x.id === id);
-  if (a) { a.status = code === 0 ? 'done' : 'failed'; a.endedAt = new Date().toISOString(); }
+  if (a) { a.status = signal ? 'stopped' : code === 0 ? 'done' : 'failed'; a.endedAt = new Date().toISOString(); }
   store.writeRuntime(root, rt);
 }
 // Buffer a stream into whole lines; flush() emits any trailing partial line at close.
@@ -113,6 +141,7 @@ function startRun(root, { prompt, agent, logPrompt = true, display, learn = true
   // End the child's stdin immediately: a child that reads stdin (or a Windows pipe that
   // otherwise keeps 'close' from firing) can't stall the run waiting on input that never comes.
   try { child.stdin && child.stdin.end(); } catch {}
+  trackChild(root, child);
 
   const onLine = (line) => {
     // A learn line is swallowed either way. When recorded, it ALWAYS waits in "To confirm", whatever
@@ -135,14 +164,14 @@ function startRun(root, { prompt, agent, logPrompt = true, display, learn = true
   child.stdout && child.stdout.on('data', (d) => out.feed(d));
   child.stderr && child.stderr.on('data', (d) => err.feed(d));
   child.on('error', (e) => emit({ type: 'run-line', runId, chunk: 'error: ' + e.message + '\n' }));
-  child.on('close', (code) => {
+  child.on('close', (code, signal) => {
     out.flush(); err.flush();
-    runEnd(root, runId, code);
-    const sm = store.appendMessage(root, { role: which, kind: 'status', text: `finished (exit ${code})`, agent: which, runId });
+    runEnd(root, runId, code, signal);
+    const sm = store.appendMessage(root, { role: which, kind: 'status', text: signal ? 'stopped' : `finished (exit ${code})`, agent: which, runId });
     emit({ type: 'message', message: sm });
     emit({ type: 'run-end', runId, code }); emit({ type: 'change' });
   });
   return { runId, child };
 }
 
-module.exports = { startRun, resolveRunnerCommand, parseLearnLine };
+module.exports = { startRun, resolveRunnerCommand, parseLearnLine, trackChild, stopRuns, reconcileRunsOnBoot };

package/lib/dashboard/summarize.js

@@ -8,7 +8,7 @@
  */
 const { spawn } = require('child_process');
 const store = require('../store');
-const { resolveRunnerCommand } = require('./runner');
+const { resolveRunnerCommand, trackChild } = require('./runner');
 const runnerTrust = require('../runner-trust');
 
 const DEFAULT_LIMIT = 40;
@@ -55,6 +55,7 @@ function runSummarize(root, { agent } = {}, emit) {
   let out = '';
   child.stdout && child.stdout.on('data', (d) => { out += d.toString(); });
   child.stderr && child.stderr.on('data', (d) => { out += d.toString(); });
+  trackChild(root, child);
   child.on('close', (code) => {
     const text = out.trim() || (code === 0 ? '(no output)' : `summarize failed (exit ${code})`);
     const summary = {

package/lib/store.js

@@ -182,7 +182,8 @@ function addTask(projectRoot, { file, phase, title, owner, level, status } = {})
 }
 
 function writeAtomic(fp, content) {
-  const tmp = fp + '.tmp';
+  // Unique temp name: the hub and a CLI command can write the same file at the same moment.
+  const tmp = `${fp}.${process.pid}.${Math.random().toString(36).slice(2, 8)}.tmp`;
   fs.writeFileSync(tmp, content, 'utf8');
   fs.renameSync(tmp, fp);
 }
@@ -193,7 +194,10 @@ function readRuntime(projectRoot) {
   try { return JSON.parse(fs.readFileSync(runtimePath(projectRoot), 'utf8')); }
   catch { return { agents: [], tests: {}, messages: [], updatedAt: null }; }
 }
+// runtime.json is volatile and re-read on every dashboard refresh: keep it bounded. The newest entries win.
+const RUNTIME_LIMITS = { messages: 500, agents: 100 };
 function writeRuntime(projectRoot, rt) {
+  for (const [key, max] of Object.entries(RUNTIME_LIMITS)) if (Array.isArray(rt[key]) && rt[key].length > max) rt[key] = rt[key].slice(-max);
   rt.updatedAt = new Date().toISOString();
   writeAtomic(runtimePath(projectRoot), JSON.stringify(rt, null, 2) + '\n');
   return rt;
@@ -378,6 +382,6 @@ function readSkills(projectRoot) {
 module.exports = {
   parseTaskLine, buildTaskLine, parsePlan, readPlans, readSpecs, updateTaskLine, addTaskComment,
   nextTaskId, addTask,
-  readRuntime, writeRuntime, parseAgentLine, appendMessage, readConfig, readWorkflow, readProject,
+  readRuntime, writeRuntime, RUNTIME_LIMITS, parseAgentLine, appendMessage, readConfig, readWorkflow, readProject,
   readAgents, readSkills, readCustomDashboards, recordSnapshot, resolvePlansDir, resolveSpecsDir,
 };

package/package.json

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