@hanzlaa/rcode 3.6.15 → 4.0.0

package/server/lib/html/client/views/PhasesView.js

@@ -60,7 +60,7 @@ function PhaseDetail({ phase: p, S }) {
 
   function handleRun(e) {
     e.stopPropagation();
-    runAndOpenTerm('phase-' + p.id, '/rihal-execute ' + p.id, 'Phase ' + p.id);
+    runAndOpenTerm('phase-' + p.id, '/rcode-execute ' + p.id, 'Phase ' + p.id);
   }
   function handleTerm(e) {
     e.stopPropagation();
@@ -108,7 +108,7 @@ function PhaseDetail({ phase: p, S }) {
           : html`
               <div class="empty">
                 No sprints in this phase yet.
-                <div class="empty-action">Run /rihal-plan to create sprints</div>
+                <div class="empty-action">Run /rcode-plan to create sprints</div>
               </div>
             `}
       </div>
@@ -146,14 +146,14 @@ export function PhasesView({ subId }) {
     phases.length > 0 &&
     phases.every(ph => ph.status === 'complete' || ph.status === 'completed' || ph.status === 'done');
   const plHints = [
-    ['/rihal-add-phase', 'Add a new phase'],
-    ['/rihal-stats',     'Project statistics'],
-    ['/rihal-progress',  'Overall progress'],
+    ['/rcode-add-phase', 'Add a new phase'],
+    ['/rcode-stats',     'Project statistics'],
+    ['/rcode-progress',  'Overall progress'],
   ];
   if (allComplete) {
-    plHints.push(['/rihal-audit-milestone',    'Audit milestone completion']);
-    plHints.push(['/rihal-complete-milestone', 'Complete and archive milestone']);
-    plHints.push(['/rihal-ship',               'Create PR and ship']);
+    plHints.push(['/rcode-audit-milestone',    'Audit milestone completion']);
+    plHints.push(['/rcode-complete-milestone', 'Complete and archive milestone']);
+    plHints.push(['/rcode-ship',               'Create PR and ship']);
   }
 
   const q = filter.toLowerCase();
@@ -174,7 +174,7 @@ export function PhasesView({ subId }) {
           : html`
               <div class="empty">
                 No phases yet.
-                <div class="empty-action">Run /rihal-new-project to start</div>
+                <div class="empty-action">Run /rcode-new-project to start</div>
               </div>
             `}
       </div>

package/server/lib/html/client/views/RoadmapView.js

@@ -88,7 +88,7 @@ function PhaseNode({ phase: p, filterQuery, expandSignal }) {
       <div class="tree-row" onClick=${() => setOpen(o => !o)} onDblClick=${handleDblClick}>
         <span class="tree-chevron">${open ? '▼' : '▶'}</span>
         <span class="tree-icon"><${Icon} name="clipboard-list" size=${14}/></span>
-        ${sps.length ? html`<${RunBtn} storyId=${'phase-' + p.id} cmd=${'/rihal-execute ' + p.id} label=${'Phase ' + p.id}/>` : null}
+        ${sps.length ? html`<${RunBtn} storyId=${'phase-' + p.id} cmd=${'/rcode-execute ' + p.id} label=${'Phase ' + p.id}/>` : null}
         <span class="tree-label">P${p.id} — ${p.name}</span>
         <${Chip} status=${p.status}/>
         <${RunningBadge} count=${running}/>
@@ -130,7 +130,7 @@ function SprintNode({ sprint: s, expandSignal }) {
       <div class="tree-row" onClick=${() => setOpen(o => !o)}>
         <span class="tree-chevron">${open ? '▼' : '▶'}</span>
         <span class="tree-icon"><${Icon} name="zap" size=${14}/></span>
-        <${RunBtn} storyId=${'sprint-' + s.id} cmd=${'/rihal-execute-sprint ' + s.id} label=${'Sprint ' + s.id}/>
+        <${RunBtn} storyId=${'sprint-' + s.id} cmd=${'/rcode-execute-sprint ' + s.id} label=${'Sprint ' + s.id}/>
         <span class="tree-label">Sprint ${s.id} — ${s.goal || 'No goal'}</span>
         <${Chip} status=${s.status}/>
         <span class="tree-badge">${sDone}/${sts.length}</span>
@@ -186,15 +186,15 @@ export function RoadmapView() {
     ph => ph.status === 'complete' || ph.status === 'completed' || ph.status === 'done'
   );
   const rmHints = [
-    ['/rihal-autonomous',       'Execute all remaining phases (autonomous)'],
-    ['/rihal-audit',            'Audit the project'],
-    ['/rihal-add-phase',        'Add a new phase'],
-    ['/rihal-milestone-summary','View milestone summary'],
-    ['/rihal-new-milestone',    'Start a new milestone'],
+    ['/rcode-autonomous',       'Execute all remaining phases (autonomous)'],
+    ['/rcode-audit',            'Audit the project'],
+    ['/rcode-add-phase',        'Add a new phase'],
+    ['/rcode-milestone-summary','View milestone summary'],
+    ['/rcode-new-milestone',    'Start a new milestone'],
   ];
   if (allPDone) {
-    rmHints.push(['/rihal-audit-milestone',    'Audit milestone completion']);
-    rmHints.push(['/rihal-complete-milestone', 'Complete and archive milestone']);
+    rmHints.push(['/rcode-audit-milestone',    'Audit milestone completion']);
+    rmHints.push(['/rcode-complete-milestone', 'Complete and archive milestone']);
   }
 
   const q = filterQuery.toLowerCase().trim();
@@ -218,11 +218,11 @@ export function RoadmapView() {
             </span>
             <span class="ms-actions">
               <button class="card-run-btn" title="Execute every remaining phase (autonomous run — pauses at checkpoints)"
-                onClick=${e => { e.stopPropagation(); runAndOpenTerm('milestone-execute-all', '/rihal-autonomous', 'Execute all phases'); }}>
+                onClick=${e => { e.stopPropagation(); runAndOpenTerm('milestone-execute-all', '/rcode-autonomous', 'Execute all phases'); }}>
                 <${Icon} name="play" size=${12}/> Run All
               </button>
               <button class="card-run-btn ms-audit-btn" title="Audit the whole milestone"
-                onClick=${e => { e.stopPropagation(); runAndOpenTerm('milestone-audit', '/rihal-audit-milestone', 'Audit milestone'); }}>
+                onClick=${e => { e.stopPropagation(); runAndOpenTerm('milestone-audit', '/rcode-audit-milestone', 'Audit milestone'); }}>
                 <${Icon} name="clipboard-list" size=${12}/> Audit
               </button>
             </span>

package/server/lib/html/client/views/SprintsView.js

@@ -49,7 +49,7 @@ function SprintDetail({ sprint: s, S }) {
 
   function handleRun(e) {
     e.stopPropagation();
-    runAndOpenTerm('sprint-' + s.id, '/rihal-execute-sprint ' + s.id, 'Sprint ' + s.id);
+    runAndOpenTerm('sprint-' + s.id, '/rcode-execute-sprint ' + s.id, 'Sprint ' + s.id);
   }
   function handleTerm(e) {
     e.stopPropagation();
@@ -91,7 +91,7 @@ function SprintDetail({ sprint: s, S }) {
           : html`
               <div class="empty">
                 No tasks in this sprint yet.
-                <div class="empty-action">Run /rihal-create-story to add tasks</div>
+                <div class="empty-action">Run /rcode-create-story to add tasks</div>
               </div>
             `}
       </div>
@@ -138,12 +138,12 @@ export function SprintsView({ subId }) {
   // List mode
   const curSp = sprints.find(sp => sp.id === S.currentSprint);
   const slHints = [
-    ['/rihal-sprint-planning','Plan a new sprint'],
-    ['/rihal-stats',          'Project statistics'],
+    ['/rcode-sprint-planning','Plan a new sprint'],
+    ['/rcode-stats',          'Project statistics'],
   ];
   if (curSp) {
-    slHints.push(['/rihal-execute',      'Execute current sprint ' + curSp.id]);
-    slHints.push(['/rihal-sprint-status','Status of Sprint ' + curSp.id]);
+    slHints.push(['/rcode-execute',      'Execute current sprint ' + curSp.id]);
+    slHints.push(['/rcode-sprint-status','Status of Sprint ' + curSp.id]);
   }
 
   const q = filter.toLowerCase();
@@ -168,7 +168,7 @@ export function SprintsView({ subId }) {
           : html`
               <div class="empty">
                 No sprints yet.
-                <div class="empty-action">Run /rihal-plan to create sprints</div>
+                <div class="empty-action">Run /rcode-plan to create sprints</div>
               </div>
             `}
       </div>

package/server/lib/html/client/views/TasksView.js

@@ -84,16 +84,16 @@ export function TasksView() {
   const allDone = rawTasks.length > 0 && rawTasks.every(t => t.status === 'done' || t.status === 'completed');
   const hasBlocked = rawTasks.some(t => t.status === 'blocked');
   const tHints = [
-    ['/rihal-create-story',   'Add a new story/task'],
-    ['/rihal-sprint-planning','Plan the next sprint'],
+    ['/rcode-create-story',   'Add a new story/task'],
+    ['/rcode-sprint-planning','Plan the next sprint'],
   ];
   if (allDone) {
-    tHints.push(['/rihal-verify-work','Verify all tasks pass UAT']);
-    tHints.push(['/rihal-audit-uat', 'Audit UAT coverage']);
+    tHints.push(['/rcode-verify-work','Verify all tasks pass UAT']);
+    tHints.push(['/rcode-audit-uat', 'Audit UAT coverage']);
   }
   if (hasBlocked) {
-    tHints.push(['/rihal-debug',         'Debug blocked tasks']);
-    tHints.push(['/rihal-correct-course','Course-correct blockers']);
+    tHints.push(['/rcode-debug',         'Debug blocked tasks']);
+    tHints.push(['/rcode-correct-course','Course-correct blockers']);
   }
 
   // Empty state
@@ -137,7 +137,7 @@ export function TasksView() {
               <div class="empty">
                 No tasks yet.
                 <div class="empty-action">
-                  Run <code>/rihal-plan${phaseHint}</code> to generate tasks for this project.
+                  Run <code>/rcode-plan${phaseHint}</code> to generate tasks for this project.
                 </div>
               </div>
             `}

package/server/lib/html/client.js

@@ -14,11 +14,18 @@
 
 const { ICONS } = require('./icons');
 
+// rcode version — read once at module load; surfaced in the dashboard status bar.
+let RCODE_VERSION = '';
+try { RCODE_VERSION = require('../../../package.json').version || ''; } catch { /* version unknown */ }
+
 // Fields the client needs from the scanned state. Kept in sync with
 // store.js initial state and the view components that read it.
 function clientState(state) {
   return JSON.stringify({
     phases:           state.phaseTree           || state.raw?.phases || [],
+    projectName:      state.projectName         || '',
+    projectRoot:      state.projectRoot         || '',
+    version:          RCODE_VERSION,
     milestone:        state.raw?.milestone      || '',
     currentPhase:     state.raw?.current_phase  || null,
     currentSprint:    state.raw?.current_sprint || null,

package/server/lib/html/css.js

@@ -1,7 +1,7 @@
 /* CLAUDE.md exemption: pure CSS data file, no logic — 1000-line limit does not apply */
 /**
  * Dashboard CSS — Linear design system.
- * Dark-first (Linear-style). Rihal accent: #5e6ad2 (Aether Blue).
+ * Dark-first (Linear-style). rcode accent: #5e6ad2 (Aether Blue).
  */
 function renderCss() {
   return `<style>
@@ -29,7 +29,7 @@ function renderCss() {
   --text-tertiary:  #8a8f98;
   --text-muted:     #62666d;
 
-  /* Brand — Rihal keeps Aether Blue */
+  /* Brand — rcode keeps Aether Blue */
   --accent-primary: #5e6ad2;
   --accent-hover:   #7170ff;
   --accent-active:  #4853bb;
@@ -226,6 +226,16 @@ html, body {
 }
 .nav-link:hover { background: var(--bg-hover); color: var(--text-secondary); }
 .nav-link.active { background: var(--bg-elev-2); color: var(--text-primary); }
+.nav-count {
+  margin-left: auto;
+  font-size: 10px;
+  font-weight: 600;
+  color: var(--text-muted);
+  background: var(--bg-elev-2);
+  padding: 1px 6px;
+  border-radius: var(--radius-2);
+}
+.nav-link.active .nav-count { color: var(--text-secondary); background: var(--bg-hover); }
 
 /* Mobile hamburger */
 .hamburger-btn {
@@ -2230,6 +2240,12 @@ footer {
   gap: var(--space-3);
   align-items: center;
 }
+.cmd-runner-hint {
+  margin-top: var(--space-3);
+  font-size: var(--text-xs);
+  color: var(--text-muted);
+  line-height: 1.5;
+}
 .cmd-runner-select {
   flex: 1;
   background: var(--bg-input, var(--bg-elev-2));

package/server/lib/html/shell.js

@@ -17,17 +17,37 @@ function renderHtml(state, orchToken) {
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
+<meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net https://esm.sh; style-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net https://fonts.googleapis.com; font-src 'self' https://fonts.gstatic.com data:; img-src 'self' data:; connect-src 'self' ws: wss:; object-src 'none'; base-uri 'self'; frame-ancestors 'none'">
+<meta http-equiv="X-Content-Type-Options" content="nosniff">
+<meta name="referrer" content="strict-origin-when-cross-origin">
 <title>Majlis — ${esc(projectName)}</title>
 <link rel="preconnect" href="https://fonts.googleapis.com">
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/xterm@5.3.0/css/xterm.css">
-<script src="https://cdn.jsdelivr.net/npm/marked@15.0.7/marked.min.js"><\/script>
-<script src="https://cdn.jsdelivr.net/npm/xterm@5.3.0/lib/xterm.js"><\/script>
-<script src="https://cdn.jsdelivr.net/npm/xterm-addon-fit@0.8.0/lib/xterm-addon-fit.js"><\/script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/xterm@5.3.0/css/xterm.css" integrity="sha384-LJcOxlx9IMbNXDqJ2axpfEQKkAYbFjJfhXexLfiRJhjDU81mzgkiQq8rkV0j6dVh" crossorigin="anonymous">
+<script src="https://cdn.jsdelivr.net/npm/marked@18.0.4/lib/marked.umd.js" integrity="sha384-8RA8Ah4c9upJmKfg5nH01OgjZoQ3mRX+ngrKYWXQYj2dHYxFqYz8POSlii33f0wB" crossorigin="anonymous"><\/script>
+<script src="https://cdn.jsdelivr.net/npm/xterm@5.3.0/lib/xterm.js" integrity="sha384-/nfmYPUzWMS6v2atn8hbljz7NE0EI1iGx34lJaNzyVjWGDzMv+ciUZUeJpKA3Glc" crossorigin="anonymous"><\/script>
+<script src="https://cdn.jsdelivr.net/npm/xterm-addon-fit@0.8.0/lib/xterm-addon-fit.js" integrity="sha384-AQLWHRKAgdTxkolJcLOELg4E9rE89CPE2xMy3tIRFn08NcGKPTsELdvKomqji+DL" crossorigin="anonymous"><\/script>
 <script>window.__ORCH_TOKEN__ = ${JSON.stringify(orchToken || '')};<\/script>
 ${renderCss()}
 </head>
 <body>
 
+<!-- ── SSR nav stubs (hidden) ──────────────────────────────────────────── -->
+<!-- Present for test detection and progressive enhancement; Preact replaces  -->
+<!-- these at runtime by mounting into #app-root.                             -->
+<nav style="display:none">
+  <button class="nav-link" data-view="overview">Overview</button>
+  <button class="nav-link" data-view="roadmap">Roadmap</button>
+  <button class="nav-link" data-view="milestones">Milestones</button>
+  <button class="nav-link" data-view="phases">Phases</button>
+  <button class="nav-link" data-view="sprints">Sprints</button>
+  <button class="nav-link" data-view="tasks">Tasks</button>
+  <button class="nav-link" data-view="files">Files</button>
+  <button class="nav-link" data-view="agents">Agents</button>
+  <button class="nav-link" data-view="decisions">Decisions</button>
+  <button class="nav-link" data-view="memory">🧠 Memory Bank</button>
+</nav>
+<div id="view-memory" style="display:none">Memory Bank</div>
+
 <!-- ── Preact app mount ────────────────────────────────────────────────── -->
 <!-- App renders: sidebar, topbar, and all 12 Preact views (sprint 31.4).  -->
 <div id="app-root"></div>
@@ -39,6 +59,9 @@ ${renderCss()}
      Static panel markup removed — XtermPanel.js + OrchPanel.js own the DOM. -->
 
 ${renderClientJs(state)}
+<footer style="position:fixed;bottom:8px;right:12px;font-size:11px;color:rgba(255,255,255,0.3);z-index:1;pointer-events:none">
+  <a href="https://github.com/hanzlahabib" target="_blank" rel="noopener noreferrer" style="color:inherit;text-decoration:none;pointer-events:auto">by Hanzla Habib</a>
+</footer>
 </body>
 </html>`;
 }

package/server/lib/scanner.js

@@ -1,5 +1,5 @@
 /**
- * State scanner — reads .rihal/ and .planning/ directories to build dashboard state.
+ * State scanner — reads .rcode/ and .planning/ directories to build dashboard state.
  */
 const fs = require('fs');
 const path = require('path');
@@ -85,11 +85,14 @@ function buildPhaseTree(projectDir, rawPhases) {
       while ((tm = taskRe.exec(text))) {
         const idM    = tm[1].match(/id="([^"]+)"/);
         const titleM = tm[2].match(/<title>([\s\S]*?)<\/title>/);
-        stories.push({
+        const acM    = tm[2].match(/<acceptance_criteria>\s*([\s\S]*?)\s*<\/acceptance_criteria>/);
+        const story = {
           id:     idM ? idM[1] : `${sid}-task-${stories.length + 1}`,
           title:  titleM ? titleM[1].trim() : `Task ${stories.length + 1}`,
           status: phaseComplete ? 'done' : 'todo',
-        });
+        };
+        if (acM && acM[1].trim()) story.acceptance = acM[1].trim();
+        stories.push(story);
       }
       // Fallback for pre-<task> SPRINT.md format (phases 20-30 era):
       // "### Story 20.01.01 — title" / "### Task X — title" headings.
@@ -118,10 +121,10 @@ function buildPhaseTree(projectDir, rawPhases) {
   });
 }
 
-function scanState(rihalDir) {
-  const projectDir = path.dirname(rihalDir);
+function scanState(rcodeDir) {
+  const projectDir = path.dirname(rcodeDir);
   const state = {
-    exists: fs.existsSync(rihalDir),
+    exists: fs.existsSync(rcodeDir),
     projectName: null,
     raw: null,
     rawParseError: null,
@@ -139,7 +142,7 @@ function scanState(rihalDir) {
 
   if (!state.exists) return state;
 
-  const rawResult = safeReadJson(path.join(rihalDir, 'state.json'));
+  const rawResult = safeReadJson(path.join(rcodeDir, 'state.json'));
   if (rawResult && rawResult.__parseError) {
     state.rawParseError = rawResult.__parseError;
     state.raw = null;
@@ -147,7 +150,7 @@ function scanState(rihalDir) {
     state.raw = rawResult;
   }
 
-  const cfg = parseSimpleYaml(safeReadText(path.join(rihalDir, 'config.yaml')));
+  const cfg = parseSimpleYaml(safeReadText(path.join(rcodeDir, 'config.yaml')));
 
   // Fix #260: project name shows '.' — derive from directory name as fallback
   const dirName = path.basename(projectDir);
@@ -156,6 +159,8 @@ function scanState(rihalDir) {
     || state.raw?.project
     || (dirName !== '.' ? dirName : 'Unknown project');
 
+  state.projectRoot = projectDir;
+
   state.currentPhase   = state.raw?.current_phase  || null;
   state.currentSprint  = state.raw?.current_sprint || null;
   state.milestone      = state.raw?.milestone       || null;
@@ -236,7 +241,7 @@ function scanState(rihalDir) {
     state.blockers = state.raw.blockers.filter(b => b && (typeof b === 'string' || b.title));
   }
 
-  state.context = safeReadText(path.join(rihalDir, 'context', 'active.md'))
+  state.context = safeReadText(path.join(rcodeDir, 'context', 'active.md'))
     || safeReadText(path.join(projectDir, '.planning', 'CONTEXT.md'));
 
   // Walk .planning/ for file tree
@@ -254,15 +259,15 @@ function scanState(rihalDir) {
   }
   if (fs.existsSync(planningDir)) walkPlanning(planningDir, '');
 
-  // #12 — surface pending handoff (.rihal/HANDOFF.json) and active context
-  // (.rihal/context/active.md) for the dashboard banner + memory-bank summary.
+  // #12 — surface pending handoff (.rcode/HANDOFF.json) and active context
+  // (.rcode/context/active.md) for the dashboard banner + memory-bank summary.
   // Both are no-op when the files don't exist. View-only — no writes.
-  const handoffPath = path.join(rihalDir, 'HANDOFF.json');
+  const handoffPath = path.join(rcodeDir, 'HANDOFF.json');
   if (fs.existsSync(handoffPath)) {
     const ho = safeReadJson(handoffPath);
     if (ho && !ho.__parseError) {
       state.pendingHandoff = {
-        path: '.rihal/HANDOFF.json',
+        path: '.rcode/HANDOFF.json',
         ts: ho.ts || ho.timestamp || null,
         summary: ho.summary || ho.note || ho.what_was_happening || null,
         phase: ho.phase || ho.current_phase || null,
@@ -272,14 +277,14 @@ function scanState(rihalDir) {
     }
   }
 
-  const activeCtx = path.join(rihalDir, 'context', 'active.md');
+  const activeCtx = path.join(rcodeDir, 'context', 'active.md');
   if (fs.existsSync(activeCtx)) {
     try {
       const stat = fs.statSync(activeCtx);
       const text = fs.readFileSync(activeCtx, 'utf8');
       state.memoryBank = state.memoryBank || {};
       state.memoryBank.active = {
-        path: '.rihal/context/active.md',
+        path: '.rcode/context/active.md',
         bytes: stat.size,
         lines: text.split('\n').length,
         updated: stat.mtime.toISOString(),
@@ -293,12 +298,12 @@ function scanState(rihalDir) {
 }
 
 /**
- * Scan the Memory Bank at .rihal/memory/. Returns structure suitable
+ * Scan the Memory Bank at .rcode/memory/. Returns structure suitable
  * for the /api/memory endpoint and the dashboard /memory view.
  * Returns { exists: false } when the Memory Bank has not been initialised.
  */
-function scanMemoryBank(rihalDir) {
-  const memoryDir = path.join(rihalDir, 'memory');
+function scanMemoryBank(rcodeDir) {
+  const memoryDir = path.join(rcodeDir, 'memory');
   const result = {
     exists: false,
     initialised: false,
@@ -317,7 +322,7 @@ function scanMemoryBank(rihalDir) {
   const indexPath = path.join(memoryDir, 'INDEX.md');
   if (fs.existsSync(indexPath)) {
     result.initialised = true;
-    result.indexPath = '.rihal/memory/INDEX.md';
+    result.indexPath = '.rcode/memory/INDEX.md';
   }
 
   const sectionMap = {
@@ -343,7 +348,7 @@ function scanMemoryBank(rihalDir) {
       }
       return {
         name,
-        path: `.rihal/memory/${section}/${name}`,
+        path: `.rcode/memory/${section}/${name}`,
         exists,
         bytes,
         populated,
@@ -356,7 +361,7 @@ function scanMemoryBank(rihalDir) {
     if (!fs.existsSync(full)) return [];
     return listDir(full)
       .filter(e => e.isFile() && e.name.endsWith('.md'))
-      .map(e => ({ name: e.name, path: `.rihal/memory/${subdir}/${e.name}` }));
+      .map(e => ({ name: e.name, path: `.rcode/memory/${subdir}/${e.name}` }));
   }
 
   result.distillates = listMd('distillates');

package/server/orchestrator.js

@@ -1,5 +1,5 @@
 /**
- * Rihal Local Orchestrator — port 7718
+ * rcode Local Orchestrator — port 7718
  *
  * Spawns interactive `claude` sessions inside a real pseudo-terminal
  * (node-pty) and bridges each one to the browser over a WebSocket.
@@ -41,12 +41,12 @@ let WebSocketServer = null;
 try { ({ WebSocketServer } = require('ws')); } catch { /* handled at boot */ }
 
 const PORT = parseInt(process.env.ORCH_PORT || '7718', 10);
-// Use the project root passed by the dashboard (RIHAL_DIR → parent, or explicit
+// Use the project root passed by the dashboard (RCODE_DIR → parent, or explicit
 // PROJECT_ROOT env var). Fall back to cwd so standalone orchestrator runs work.
 // NEVER use __dirname-relative path — that resolves to the npm package dir when
 // rcode is installed globally, not the user's actual project.
 const PROJECT_ROOT = process.env.PROJECT_ROOT
-  || (process.env.RIHAL_DIR ? path.dirname(process.env.RIHAL_DIR) : null)
+  || (process.env.RCODE_DIR ? path.dirname(process.env.RCODE_DIR) : null)
   || process.cwd();
 const CLAUDE_BIN   = process.env.CLAUDE_BIN || 'claude';
 
@@ -59,23 +59,23 @@ const STORY_ID_RE = /^[A-Za-z0-9._-]+$/;
 
 // Command allowlist — the SECURITY BOUNDARY for the dashboard command runner.
 // Only commands listed here may be launched via the UI command picker.
-// Slash-commands that launch dev work (rihal-dev-story, rihal-execute, etc.)
+// Slash-commands that launch dev work (rcode-dev-story, rcode-execute, etc.)
 // are NOT listed here; they are composed by the UI itself via storyId, not
-// by the command runner. This list covers read-mostly and informational rihal
+// by the command runner. This list covers read-mostly and informational rcode
 // slash-commands that are safe to run from the browser without further context.
 const COMMAND_ALLOWLIST = new Set([
-  '/rihal-init',
-  '/rihal-status',
-  '/rihal-progress',
-  '/rihal-help',
-  '/rihal-health',
-  '/rihal-next',
-  '/rihal-show',
-  '/rihal-list-plans',
-  '/rihal-sprint-status',
-  '/rihal-config',
-  '/rihal-diff',
-  '/rihal-stats',
+  '/rcode-init',
+  '/rcode-status',
+  '/rcode-progress',
+  '/rcode-help',
+  '/rcode-health',
+  '/rcode-next',
+  '/rcode-show',
+  '/rcode-list-plans',
+  '/rcode-sprint-status',
+  '/rcode-config',
+  '/rcode-diff',
+  '/rcode-stats',
 ]);
 
 // Cap kept-in-memory scrollback per session so a long run can't grow unbounded.
@@ -197,13 +197,13 @@ async function handleRun(req, res) {
 
   // Gate the allowlist on command-runner sessions only.
   // Command-runner sessions always use a storyId with the "cmd-" prefix
-  // (e.g. "cmd-rihal-init"). Existing dev-run sessions use storyIds such as
+  // (e.g. "cmd-rcode-init"). Existing dev-run sessions use storyIds such as
   // "phase-33", "sprint-33.1", or a raw task id — never "cmd-*" — and MUST NOT
   // be gated here, even though they also supply body.cmd explicitly.
   // This prefix check is the authoritative discriminant between the two call paths.
   // NOTE: The gate fires for ANY cmd- storyId — a missing or empty body.cmd is
   // also rejected. Previously the truthiness check on body.cmd allowed falsy values
-  // to bypass the allowlist and fall through to the /rihal-dev-story fallback.
+  // to bypass the allowlist and fall through to the /rcode-dev-story fallback.
   if (storyId.startsWith('cmd-')) {
     const reqCmd = typeof body.cmd === 'string' ? body.cmd.trim() : '';
     if (!reqCmd || !COMMAND_ALLOWLIST.has(reqCmd)) {
@@ -228,7 +228,7 @@ async function handleRun(req, res) {
   // Initial prompt. `claude [prompt]` starts an interactive session that
   // processes the prompt, then waits for further input — exactly the
   // run-then-communicate flow we want.
-  const cmd  = String(body.cmd || `/rihal-dev-story ${storyId}`);
+  const cmd  = String(body.cmd || `/rcode-dev-story ${storyId}`);
   const cols = 120, rows = 30;
 
   let proc;
@@ -337,6 +337,13 @@ function attachWebSocket(ws, storyId) {
 
 // ── server ────────────────────────────────────────────────────────────────────
 
+process.on('unhandledRejection', (reason) => {
+  console.error('[' + new Date().toISOString() + '] [orchestrator] unhandledRejection:', reason && reason.stack || reason);
+});
+process.on('uncaughtException', (err) => {
+  console.error('[' + new Date().toISOString() + '] [orchestrator] uncaughtException:', err && err.stack || err);
+});
+
 const server = http.createServer(async (req, res) => {
   const method = req.method || '';
   const url    = req.url    || '';
@@ -353,6 +360,7 @@ const server = http.createServer(async (req, res) => {
 
   const pathOnly = url.indexOf('?') === -1 ? url : url.slice(0, url.indexOf('?'));
 
+  if (method === 'GET'  && pathOnly === '/api/status')   { json(res, 200, { ok: true, sessions: sessions.size }); return; }
   if (method === 'GET'  && pathOnly === '/api/sessions') { await handleSessions(res); return; }
   if (method === 'POST' && pathOnly === '/api/run')      { await handleRun(req, res);  return; }
   if (method === 'POST' && pathOnly === '/api/stop')     { await handleStop(req, res); return; }
@@ -361,6 +369,11 @@ const server = http.createServer(async (req, res) => {
   res.writeHead(404); res.end('Not found');
 });
 
+server.on('error', (err) => {
+  console.error('[orchestrator] server error:', err.message);
+  process.exit(1);
+});
+
 // WebSocket upgrade — authenticate, validate the storyId, then hand off.
 if (WebSocketServer) {
   const wss = new WebSocketServer({ noServer: true });
@@ -374,11 +387,23 @@ if (WebSocketServer) {
   });
 }
 
+server.on('error', err => {
+  if (err.code === 'EADDRINUSE') {
+    // Exit with code 2 so the dashboard knows this is a port-conflict (not a crash)
+    // and can suppress the restart loop + print a one-time user hint.
+    console.error(`[orch] port ${PORT} already in use. Set ORCH_PORT=<N> env var to use a different port. Exiting without retry.`);
+    process.exit(2);
+  }
+  console.error('[orch] server error:', err.message);
+  process.exit(1);
+});
+
 server.listen(PORT, '127.0.0.1', () => {
-  console.log('\n🤖 Rihal Orchestrator');
+  console.log('\n🤖 rcode Orchestrator');
   console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('   Port:   ' + PORT + '  (127.0.0.1, loopback only)');
-  console.log('   Token:  ' + AUTH_TOKEN);
+  console.log('   Port:   ' + PORT);
+  console.log('   Bind:   127.0.0.1 (loopback only)');
+  console.log('   Token:  ' + AUTH_TOKEN.slice(0, 8) + '... (redacted)');
   console.log('   PTY:    ' + (pty ? 'node-pty ready' : 'node-pty MISSING'));
   console.log('   WS:     ' + (WebSocketServer ? 'ready' : 'ws MISSING'));
   console.log('   POST /api/run   GET /api/sessions   WS /ws/<id>');

package/rihal/DOCS-AUDIT.md

@@ -1,14 +0,0 @@
-# DOCS-AUDIT.md (per-project artefact)
-
-This file is generated by `/rihal-document-project` into the project root
-as `DOCS-AUDIT.md`. The shipped reference here just defines the schema:
-
-- **Inventory:** every doc file (path, last-touched, owner, freshness).
-- **Gaps:** docs that should exist per the project's domain (e.g. README,
-  CONTRIBUTING, ADRs for major decisions) but don't.
-- **Stale:** docs that diverge from current code/state (links to dead
-  files, version mismatches, removed features still documented).
-- **Recommendations:** ordered remediation list.
-
-Workflows that @-include this file expect the live audit output, which
-the workflow itself writes to disk before reading.