@hanzlaa/rcode 4.3.0 → 4.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "4.3.0",
+  "version": "4.3.2",
   "description": "rcode — the AI team that never forgets. Persistent memory, specialist agents, and slash commands for AI IDEs. Works in Claude Code, Cursor, Gemini, VS Code, and Antigravity.",
   "main": "cli/index.js",
   "bin": {

package/rcode/references/auto-init-guard.md

@@ -25,8 +25,8 @@ rcode isn't configured for this project yet. Let me set it up — takes 30 secon
 **1. Bootstrap local tooling** — copy bin from the global install:
 
 ```bash
-GLOBAL_RIHAL="$HOME/.rcode"
-TOOLS_SRC="$GLOBAL_RIHAL/bin/rcode-tools.cjs"
+GLOBAL_RCODE="$HOME/.rcode"
+TOOLS_SRC="$GLOBAL_RCODE/bin/rcode-tools.cjs"
 
 if [ ! -f "$TOOLS_SRC" ]; then
   echo "ERROR: Global rcode tools not found at $TOOLS_SRC"

package/rcode/references/output-format.md

@@ -42,7 +42,7 @@ Use for major workflow transitions.
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- RIHAL ► {STAGE NAME}
+ RCODE ► {STAGE NAME}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -69,7 +69,7 @@ Use this when a router command dispatches to another command:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- RIHAL ► ROUTING
+ RCODE ► ROUTING
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Input: {user's question or intent}
@@ -328,7 +328,7 @@ Use standard markdown pipe tables with status symbols:
 **Majlis banner** (multi-agent council):
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- RIHAL ► MAJLIS CONVENING
+ RCODE ► MAJLIS CONVENING
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -354,7 +354,7 @@ the banner, not inside it.
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- RIHAL ► PLANNING SPRINT 01.1
+ RCODE ► PLANNING SPRINT 01.1
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 التخطيط للسباق 01.1 — يرجى الانتظار
 ```
@@ -389,7 +389,7 @@ translated prose goes outside the art, on its own line(s).
 
 - Varying box/banner widths within same output
 - Mixing banner styles (`===`, `---`, `***`)
-- Skipping `RIHAL ►` prefix in stage banners
+- Skipping `RCODE ►` prefix in stage banners
 - Random emoji (`🚀`, `✨`, `💫`) outside the approved set
 - Missing Next Up block after workflow completions
 - Hardcoding references to other methodologies in rcode's UX

package/rcode/skills/actions/2-plan/rcode-create-milestone/steps/step-10-complete.md

@@ -16,7 +16,7 @@ Append `step-10-complete` to `stepsCompleted`. Add `completedAt: {ISO date}`.
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- RIHAL ► ROADMAP CREATED
+ RCODE ► ROADMAP CREATED
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Source PRD:     {inputFile}

package/server/dashboard.js

@@ -160,11 +160,12 @@ function handleRequest(req, res) {
 server.listen(PORT, '127.0.0.1', () => {
   console.log(`\n🕌 Majlis (مجلس) — rcode Dashboard`);
   console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
-  console.log(`   Mode:       view-only`);
-  console.log(`   URL:        http://localhost:${PORT}`);
-  console.log(`   Scanning:   ${RCODE_DIR}`);
-  console.log(`   Refresh:    30s soft poll`);
-  console.log(`   Stop:       kill $(ss -ltnp 'sport = :${PORT}' | awk 'NR>1{match($6,/pid=([0-9]+)/,m); print m[1]}')`);
+  console.log(`   👉 OPEN THIS:  http://localhost:${PORT}`);
+  console.log(`   Mode:          view-only`);
+  console.log(`   Scanning:      ${RCODE_DIR}`);
+  console.log(`   Refresh:       30s soft poll`);
+  console.log(`   Note:          port ${PORT + 1} is the internal orchestrator API — not for the browser`);
+  console.log(`   Stop:          kill $(ss -ltnp 'sport = :${PORT}' | awk 'NR>1{match($6,/pid=([0-9]+)/,m); print m[1]}')`);
   console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
 });
 
@@ -224,7 +225,7 @@ function spawnOrchestrator() {
   try {
     _orchProc = spawn(process.execPath, [ORCH_BIN], {
       cwd: path.join(__dirname, '..'),
-      env: { ...process.env, ORCH_TOKEN, RCODE_DIR, PROJECT_ROOT },
+      env: { ...process.env, ORCH_TOKEN, RCODE_DIR, PROJECT_ROOT, DASH_PORT: String(PORT) },
       stdio: 'pipe',
     });
     _orchProc.stdout.on('data', chunk => {

package/server/lib/html/client/components/StatusSummaryBar.js

@@ -9,7 +9,7 @@
 
 import { html } from '../preact.js';
 import { useStore } from '../store.js';
-import { allSprints, chip } from '../util.js';
+import { allSprints, chip, sessionChip } from '../util.js';
 
 /**
  * Build a `{ [cls]: count }` map from an array of items by normalising each
@@ -27,6 +27,24 @@ function countByStatus(items) {
   return map;
 }
 
+/**
+ * Build a `{ [cls]: count }` map from session objects using `sessionChip()`
+ * rather than the phase/sprint-oriented `chip()`. Sessions carry a distinct
+ * status vocabulary ('running', 'stopped', 'starting', 'error') that maps to
+ * separate CSS classes so they can be styled independently.
+ *
+ * @param {Array<{ status: string }>} sessions
+ * @returns {Object.<string, number>}
+ */
+function countSessionsByStatus(sessions) {
+  const map = {};
+  for (const session of sessions) {
+    const { cls } = sessionChip(session.status || '');
+    map[cls] = (map[cls] || 0) + 1;
+  }
+  return map;
+}
+
 /**
  * Render a single group of count chips.
  *
@@ -58,7 +76,7 @@ export function StatusSummaryBar() {
 
   const phaseCounts   = countByStatus(phases);
   const sprintCounts  = countByStatus(sprints);
-  const sessionCounts = countByStatus(sessions);
+  const sessionCounts = countSessionsByStatus(sessions);
 
   const hasPhases   = phases.length > 0;
   const hasSprints  = sprints.length > 0;

package/server/lib/html/client/util.js

@@ -80,6 +80,22 @@ export function allTasks(phases) {
   );
 }
 
+/**
+ * Map a numeric phase id to its milestone bucket.
+ * Single source of truth — imported by PhasesView and SprintsView so that
+ * milestone boundaries (19, 33) never diverge between the two views.
+ * M1 = phases 1–19, M2 = 20–33, M3 = 34+.
+ *
+ * @param {number|string} id — phase id
+ * @returns {'M1'|'M2'|'M3'}
+ */
+export function phaseMilestone(id) {
+  const n = Number(id);
+  if (n <= 19) return 'M1';
+  if (n <= 33) return 'M2';
+  return 'M3';
+}
+
 /**
  * Return a status chip descriptor — NOT an HTML string.
  * Components decide how to render the CSS class and label.
@@ -98,6 +114,31 @@ export function chip(status) {
   return { cls, label: status };
 }
 
+/**
+ * Return a status chip descriptor for orchestrator session statuses.
+ * Session objects use a different vocabulary than phases/sprints
+ * ('running', 'stopped', 'starting', 'error'), so a separate normaliser
+ * keeps the two status domains from coupling inside chip().
+ *
+ * Mapping:
+ *   running  → 'sess-running'  (accent-blue — live activity)
+ *   starting → 'sess-starting' (amber — transient / pending)
+ *   stopped  → 'sess-stopped'  (text-secondary — idle / muted)
+ *   error    → 'sess-error'    (accent-red — needs attention)
+ *
+ * @param {string} status
+ * @returns {{ cls: string, label: string }}
+ */
+export function sessionChip(status) {
+  const s = String(status || '').toLowerCase();
+  const cls =
+    s === 'running'  ? 'sess-running'  :
+    s === 'starting' ? 'sess-starting' :
+    s === 'error'    ? 'sess-error'    :
+    s === 'stopped'  ? 'sess-stopped'  : 'sess-stopped';
+  return { cls, label: status };
+}
+
 /**
  * Props for a clickable card row that navigates to a hash route.
  * Spread onto a list row (`<li ...${rowLink('tasks')}>`) to make it act like

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

@@ -9,7 +9,7 @@
 
 import { html, useState } from '../preact.js';
 import { useStore } from '../store.js';
-import { pct, humanDate, phaseHints, chip } from '../util.js';
+import { pct, humanDate, phaseHints, chip, phaseMilestone } from '../util.js';
 import {
   Chip, ProgressBar, Breadcrumb, CmdHints, RunningBadge, SprintCard, PhaseCard,
 } from '../components/shared.js';
@@ -122,17 +122,6 @@ function PhaseDetail({ phase: p, S }) {
   `;
 }
 
-/**
- * Map a numeric phase id to its milestone bucket.
- * M1 = phases 1–19, M2 = 20–33, M3 = 34+.
- */
-function phaseMilestone(id) {
-  const n = Number(id);
-  if (n <= 19) return 'M1';
-  if (n <= 33) return 'M2';
-  return 'M3';
-}
-
 export function PhasesView({ subId, filters }) {
   const S = useStore();
   const phases = S.phases || [];

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

@@ -10,7 +10,7 @@
 
 import { html, useState } from '../preact.js';
 import { useStore } from '../store.js';
-import { pct, humanDate, allSprints, sprintHints, chip } from '../util.js';
+import { pct, humanDate, allSprints, sprintHints, chip, phaseMilestone } from '../util.js';
 import {
   Chip, ProgressBar, Breadcrumb, CmdHints, RunningBadge, SprintCard, TaskCard,
 } from '../components/shared.js';
@@ -118,17 +118,6 @@ function SprintDetail({ sprint: s, S }) {
   `;
 }
 
-/**
- * Map a numeric phase id to its milestone bucket.
- * M1 = phases 1–19, M2 = 20–33, M3 = 34+.
- */
-function phaseMilestone(id) {
-  const n = Number(id);
-  if (n <= 19) return 'M1';
-  if (n <= 33) return 'M2';
-  return 'M3';
-}
-
 export function SprintsView({ subId, filters }) {
   const S = useStore();
   const sprints = allSprints(S.phases || []);

package/server/lib/html/css.js

@@ -4390,6 +4390,11 @@ summary:focus-visible,
 .summary-count-chip.blocked  { color: var(--accent-red); }
 .summary-count-chip.planned,
 .summary-count-chip.todo     { color: var(--text-secondary); }
+/* Session status chips — use sessionChip() vocabulary, not chip() */
+.summary-count-chip.sess-running  { color: var(--accent-blue); }
+.summary-count-chip.sess-starting { color: var(--amber); }
+.summary-count-chip.sess-stopped  { color: var(--text-secondary); }
+.summary-count-chip.sess-error    { color: var(--accent-red); }
 
 /* ── Filter chips ────────────────────────────────────────────────── */
 .filter-chips {

package/server/orchestrator.js

@@ -676,10 +676,25 @@ const server = http.createServer(async (req, res) => {
   res.setHeader('Access-Control-Allow-Headers', 'Authorization, Content-Type');
   if (method === 'OPTIONS') { res.writeHead(204); res.end(); return; }
 
-  if (!authed(req)) { json(res, 401, { error: 'unauthorized' }); return; }
-
   const pathOnly = url.indexOf('?') === -1 ? url : url.slice(0, url.indexOf('?'));
 
+  // Friendly landing for browser navigation (no token needed). Hitting this
+  // port directly is a common mistake — the orchestrator is the INTERNAL API,
+  // not the dashboard. Point people at the dashboard instead of a bare 401.
+  if (method === 'GET' && (pathOnly === '/' || pathOnly === '/favicon.ico')) {
+    const dashUrl = 'http://localhost:' + (process.env.DASH_PORT || '7717');
+    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+    res.end('<!doctype html><meta charset="utf-8"><title>rcode orchestrator</title>'
+      + '<body style="font-family:system-ui,sans-serif;background:#05080f;color:#e6edf7;'
+      + 'display:grid;place-items:center;height:100vh;margin:0;text-align:center">'
+      + '<div><h1 style="color:#2dd4bf;margin:0 0 .5rem">rcode orchestrator</h1>'
+      + '<p style="color:#8595ad">This is the internal API (port ' + PORT + ') — not the dashboard.</p>'
+      + '<p>Open the dashboard → <a style="color:#a78bfa" href="' + dashUrl + '">' + dashUrl + '</a></p></div>');
+    return;
+  }
+
+  if (!authed(req)) { json(res, 401, { error: 'unauthorized' }); return; }
+
   if (method === 'GET'  && pathOnly === '/api/status')   { json(res, 200, { ok: true, sessions: sessions.size }); return; }
   if (method === 'GET'  && pathOnly === '/api/runners')  { await handleRunners(res); return; }
   if (method === 'GET'  && pathOnly === '/api/sessions') { await handleSessions(res); return; }