@hanzlaa/rcode 4.7.1 → 4.7.3

package/AGENTS.md

@@ -24,7 +24,7 @@ If a user says "just keep going" or "don't stop until done", that authorization
 
 - Follow [Conventional Commits](https://www.conventionalcommits.org/) format: `type(scope): subject`
 - Types allowed: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `perf`, `revert`
-- Scopes allowed: `agents`, `skills`, `workflows`, `templates`, `dashboard`, `docs`, `config`, `github`, `commands`, `memory`, `brand`, `cli`, `ci`, `release`, `meta`, `tasks`, `migrations`, `refs`, `state`, `hooks`, `install`, `parity`, `triggers`, `dogfood`, `namespace`, `planning`, `insights`, `help`, `roadmap`, `session`, `audits`, `execute`, `executor`, `plan`, `planner`, `readme`, `sync`, `sprint`, `agent-exp`, `extensibility`, `lens-audit`, `tiers`, `build`, `council`, `doctor`, `postinstall`, `progress`, `security`, `tools`, `uninstall`, `update`, `test`, `changelog`, `scopes`, `phases`, `references`, `kanban`, `orchestrator`, `orchpanel`, `status`, `bin`, `brain`, `dogfeed`, `new-project`, `package`, `rcode-tools`, `rihal-tools`, `team`, `usp`, `v4`, `observability`, `audit`, `agent-rules`, `cursor`, `i18n`, `phase`, `scaffold`, `campaign`, `ship`, `getting-started`, `do-router`, `milestone-health`, `modules`, `project-types`, `roadmapper`, `token`, plus numeric phase/sprint scopes (e.g. `docs(15)`, `feat(8.3)`)
+- Scopes allowed: `agents`, `skills`, `workflows`, `templates`, `dashboard`, `docs`, `config`, `github`, `commands`, `memory`, `brand`, `cli`, `ci`, `release`, `meta`, `tasks`, `migrations`, `refs`, `state`, `hooks`, `init`, `install`, `parity`, `triggers`, `dogfood`, `namespace`, `planning`, `insights`, `help`, `roadmap`, `session`, `audits`, `execute`, `executor`, `plan`, `planner`, `readme`, `sync`, `sprint`, `agent-exp`, `extensibility`, `lens-audit`, `tiers`, `build`, `council`, `doctor`, `postinstall`, `progress`, `security`, `tools`, `uninstall`, `update`, `test`, `changelog`, `scopes`, `phases`, `references`, `kanban`, `orchestrator`, `orchpanel`, `status`, `bin`, `brain`, `dogfeed`, `new-project`, `package`, `rcode-tools`, `rihal-tools`, `team`, `usp`, `v4`, `observability`, `audit`, `agent-rules`, `cursor`, `i18n`, `phase`, `scaffold`, `campaign`, `ship`, `getting-started`, `do-router`, `milestone-health`, `modules`, `project-types`, `roadmapper`, `token`, plus numeric phase/sprint scopes (e.g. `docs(15)`, `feat(8.3)`)
 - Subject: lowercase first letter, imperative mood, no trailing period, under 72 chars
 - **NEVER add Claude/AI attribution to commit messages.** No "Generated with Claude Code", no "Co-Authored-By: Claude", no "🤖 Generated". The user does not want this.
 - **NEVER use `--no-verify`** to bypass hooks. If hooks fail, fix the underlying issue.

package/CONTRIBUTING.md

@@ -286,6 +286,7 @@ We use [Conventional Commits](https://www.conventionalcommits.org/) format. The
 - `state` — `.rcode/state.json` and state-manipulation code paths
 - `refs` — files inside `rcode/references/`
 - `hooks` — `.claude/hooks/*` and install-time hook wiring
+- `init` — `/rcode-init` command and init-time project bootstrap
 - `install` — installer flow, manifest, side-effects
 - `memory` — Memory Bank distillates and templates
 - `brand` — branding/voice across surfaces

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "4.7.1",
+  "version": "4.7.3",
   "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/commands/do.md

@@ -1,6 +1,15 @@
 ---
 name: rcode-do
-description: "[ROUTER] Interactive picker — describe what you want and rcode picks the command"
+description: >-
+  [ROUTER] Interactive picker — describe what you want and rcode picks
+  the command. Activates whenever the user says "use rcode", "using
+  rcode", "rcode kar do", "rcode say kara do", "let rcode handle
+  this/it", "rcode this", or otherwise names rcode as the tool to use
+  for a task without naming a specific /rcode-* command — especially
+  when the request bundles multiple asks (e.g. "init a phase, build a
+  checklist, make a sprint"). Route through this picker instead of
+  hand-rolling files or Bash workarounds for what rcode already has a
+  command for.
 argument-hint: "[optional question or task description]"
 allowed-tools:
   - Read

package/rcode/workflows/plan-spawn-planner.md

@@ -79,6 +79,12 @@ Planner prompt:
 **Phase:** {phase_number}
 **Mode:** {standard | gap_closure | reviews}
 
+## Scope
+
+Default: `phase` (one SPRINT.md, up to 8 stories — see Scope-Driven Sizing in your role instructions).
+
+**Self-upgrade to `initiative` mid-decomposition** if, once you've read CONTEXT.md/ROADMAP.md and started breaking down the work, it splits into independent waves or work-streams (e.g. shared-primitive foundation → feature-local migrations → cleanup/tests) and total stories would exceed 8. When that happens, emit multiple SPRINT.md files (`{phase}-1-SPRINT.md`, `{phase}-2-SPRINT.md`, ...) in this same run instead of one oversized plan. Do not wait for rcode-sprint-checker's "scope exceeds context budget" rejection to force a resharding pass — that costs a full extra planner run. Decide the split now, while you're already looking at the file/story list.
+
 <files_to_read>
 - {state_path} (Project State)
 - {roadmap_path} (Roadmap)

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

@@ -17,6 +17,21 @@ import { Icon } from '../icons-client.js';
 import { TaskPipeline } from './TaskPipeline.js';
 import { openRunnerPicker } from './RunnerPicker.js';
 
+// ---- Acceptance criteria: SPRINT.md stores this as "- line\n- line";
+// rendering it as raw text collapses the newlines into one run-on line. ----
+export function AcceptanceList({ text }) {
+  const lines = String(text || '')
+    .split('\n')
+    .map(l => l.replace(/^\s*[-*]\s*/, '').trim())
+    .filter(Boolean);
+  if (!lines.length) return null;
+  return html`
+    <ul class="task-actions-list">
+      ${lines.map((line, i) => html`<li key=${i} class="task-action-step">${line}</li>`)}
+    </ul>
+  `;
+}
+
 // ---- Toast helper (shared by CmdHint copy action and any view) ----
 export function showToast(msg) {
   const el = document.getElementById('toast');
@@ -131,7 +146,11 @@ export function Breadcrumb({ items }) {
  * @param {{ cmd: string, desc: string }} props
  */
 export function CmdHint({ cmd, desc }) {
-  function handleClick() {
+  function handleClick(e) {
+    // CmdHint often sits inside a clickable card row (SprintCard's empty
+    // state, etc.) — without this, copying the command also fires the
+    // row's own click (e.g. navigating away mid-copy).
+    if (e && e.stopPropagation) e.stopPropagation();
     navigator.clipboard.writeText(cmd)
       .then(() => showToast('Copied: ' + cmd))
       .catch(() => {
@@ -291,9 +310,7 @@ export function SprintCard({ sprint: s, S }) {
       </div>
       <div style="margin-top:6px;"><${ProgressBar} done=${done} total=${stories.length}/></div>
       ${stories.length === 0 ? html`
-        <div class="empty-action" style="margin-top:var(--space-2);font-size:var(--text-xs);">
-          No tasks — run <code>/rcode-plan ${phaseId}</code> to populate
-        </div>
+        <${CmdHint} cmd=${'/rcode-plan ' + phaseId} desc="Populate this sprint with tasks"/>
       ` : null}
       ${s.started_at ? html`
         <div style="color:var(--text-muted);font-size:var(--text-xs);margin-top:4px;">
@@ -370,7 +387,12 @@ export function TaskCard({ task: t }) {
               <strong>Phase:</strong> P${t.phaseId}${t.phaseName ? ' — ' + t.phaseName : ''}
             </div>
           ` : null}
-          ${t.acceptance ? html`<div class="task-detail-row"><strong>Acceptance:</strong> ${t.acceptance}</div>` : null}
+          ${t.acceptance ? html`
+            <div class="task-actions">
+              <div class="task-actions-title">Acceptance</div>
+              <${AcceptanceList} text=${t.acceptance}/>
+            </div>
+          ` : null}
           ${t.assignee ? html`<div class="task-detail-row"><strong>Assignee:</strong> ${t.assignee}</div>` : null}
           ${(t.actions && t.actions.length) ? html`
             <div class="task-actions">

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

@@ -9,7 +9,7 @@
 
 import { html } from '../preact.js';
 import { useStore } from '../store.js';
-import { pressable } from '../components/shared.js';
+import { pressable, CmdHint } from '../components/shared.js';
 import { Icon } from '../icons-client.js';
 
 export function BacklogView() {
@@ -23,7 +23,7 @@ export function BacklogView() {
         ? html`
           <div class="empty">
             No phases waiting in the backlog.
-            <div class="empty-action">Run /rcode-add-phase to queue up new work</div>
+            <${CmdHint} cmd="/rcode-add-phase" desc="Queue up new work"/>
           </div>
         `
         : html`

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

@@ -9,11 +9,11 @@
 
 import { html, useState, useCallback } from '../preact.js';
 import { useStore, refresh } from '../store.js';
-import { allTasks, currentPhaseName } from '../util.js';
+import { allTasks, currentPhaseName, currentPhaseId } from '../util.js';
 import { stopStory, openOrchPanel, openTermPanel, setTaskStatus } from '../orchestrator.js';
 import { openFileViewer } from '../store.js';
 import { openRunnerPicker } from '../components/RunnerPicker.js';
-import { showToast } from '../components/shared.js';
+import { showToast, CmdHint } from '../components/shared.js';
 
 // ---- Column descriptors ----
 const COLS = [
@@ -262,9 +262,11 @@ export function KanbanView() {
               ${' is active.'}
             </div>
           ` : null}
+          <${CmdHint}
+            cmd=${'/rcode-plan' + (currentPhaseId(currentPhase) ? ' ' + currentPhaseId(currentPhase) : '')}
+            desc="Generate sprint stories"/>
           <div class="empty-action">
-            Run <code>/rcode-plan</code> to generate sprint stories, or browse
-            planning docs in the <a href="#files">Files</a> view.
+            Or browse planning docs in the <a href="#files">Files</a> view.
           </div>
         </div>
       </div>

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

@@ -14,6 +14,7 @@
 
 import { html, useState, useEffect } from '../preact.js';
 import { FileReader } from '../components/FileReader.js';
+import { CmdHint } from '../components/shared.js';
 
 // ---- Command hints accordion ----
 const MEMORY_HINTS = [
@@ -127,7 +128,7 @@ export function MemoryView() {
         <div class="empty">
           <h3 style="color:var(--rcode-gold);">Not initialised</h3>
           <p>The Memory Bank is rcode's structured project context.</p>
-          <div class="empty-action">Run <code>/rcode-memory-init</code> to bootstrap</div>
+          <${CmdHint} cmd="/rcode-memory-init" desc="Bootstrap the Memory Bank"/>
         </div>
       </div>
     `;

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

@@ -11,7 +11,7 @@ import { html, useState } from '../preact.js';
 import { useStore } from '../store.js';
 import { pct, humanDate, phaseHints, chip, phaseMilestone } from '../util.js';
 import {
-  Chip, ProgressBar, Breadcrumb, CmdHints, RunningBadge, SprintCard, PhaseCard,
+  Chip, ProgressBar, Breadcrumb, CmdHint, CmdHints, RunningBadge, SprintCard, PhaseCard,
 } from '../components/shared.js';
 import { openTermPanel, runningInPhase } from '../orchestrator.js';
 import { openFileViewer } from '../store.js';
@@ -118,7 +118,7 @@ function PhaseDetail({ phase: p, S }) {
           : html`
               <div class="empty">
                 No sprints in this phase yet.
-                <div class="empty-action">Run /rcode-plan to create sprints</div>
+                <${CmdHint} cmd=${'/rcode-plan ' + p.id} desc="Create sprints for this phase"/>
               </div>
             `}
       </div>
@@ -212,7 +212,7 @@ export function PhasesView({ subId, filters }) {
           : html`
               <div class="empty">
                 No phases yet.
-                <div class="empty-action">Run /rcode-new-project to start</div>
+                <${CmdHint} cmd="/rcode-new-project" desc="Design your first project"/>
               </div>
             `}
       </div>

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

@@ -10,9 +10,9 @@
 
 import { html, useState } from '../preact.js';
 import { useStore } from '../store.js';
-import { pct, humanDate, allSprints, sprintHints, chip, phaseMilestone } from '../util.js';
+import { pct, humanDate, allSprints, sprintHints, chip, phaseMilestone, currentPhaseId } from '../util.js';
 import {
-  Chip, ProgressBar, Breadcrumb, CmdHints, RunningBadge, SprintCard, TaskCard,
+  Chip, ProgressBar, Breadcrumb, CmdHint, CmdHints, RunningBadge, SprintCard, TaskCard, AcceptanceList,
 } from '../components/shared.js';
 import { openTermPanel, runningInSprint } from '../orchestrator.js';
 import { openFileViewer } from '../store.js';
@@ -105,7 +105,7 @@ function SprintDetail({ sprint: s, S }) {
           : html`
               <div class="empty">
                 No tasks in this sprint yet.
-                <div class="empty-action">Run /rcode-create-story to add tasks</div>
+                <${CmdHint} cmd=${'/rcode-create-story ' + s.id} desc="Add a task to this sprint"/>
               </div>
             `}
       </div>
@@ -115,8 +115,8 @@ function SprintDetail({ sprint: s, S }) {
           ${storiesWithAc.map(t => html`
             <div key=${t.id || t.title} class="item">
               <div class="item-title">${t.title}</div>
-              <div style="color:var(--text-secondary);font-size:var(--text-sm);margin-top:4px;">
-                ✓ ${t.acceptance}
+              <div style="margin-top:4px;">
+                <${AcceptanceList} text=${t.acceptance}/>
               </div>
             </div>
           `)}
@@ -210,7 +210,7 @@ export function SprintsView({ subId, filters }) {
           : html`
               <div class="empty">
                 No sprints yet.
-                <div class="empty-action">Run /rcode-plan to create sprints</div>
+                <${CmdHint} cmd=${'/rcode-plan' + (currentPhaseId(S.currentPhase) ? ' ' + currentPhaseId(S.currentPhase) : '')} desc="Plan sprints for the current phase"/>
               </div>
             `}
       </div>

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

@@ -9,7 +9,7 @@
 import { html, useState, useMemo } from '../preact.js';
 import { useStore } from '../store.js';
 import { allTasks, currentPhaseId } from '../util.js';
-import { CmdHints, TaskCard } from '../components/shared.js';
+import { CmdHint, CmdHints, TaskCard } from '../components/shared.js';
 
 function TaskGrouped({ tasks }) {
   if (!tasks.length) return null;
@@ -137,9 +137,7 @@ export function TasksView() {
           : html`
               <div class="empty">
                 No tasks yet.
-                <div class="empty-action">
-                  Run <code>/rcode-plan${phaseHint}</code> to generate tasks for this project.
-                </div>
+                <${CmdHint} cmd=${'/rcode-plan' + phaseHint} desc="Generate tasks for this project"/>
               </div>
             `}
       </div>

package/server/lib/scanner.js

@@ -149,17 +149,20 @@ function buildPhaseTree(projectDir, rawPhases, listCached, overrides) {
         goal = (obj.trim().split('\n').map(s => s.trim()).filter(Boolean)[0] || '').slice(0, 160);
       }
 
-      // Stories: one per <task> block; title from <title>.
+      // Stories: one per <task> block; title from the task's own title="..."
+      // attribute (current planner output), falling back to a legacy nested
+      // <title> child element for older SPRINT.md files.
       const stories = [];
       const taskRe = /<task\b([^>]*)>([\s\S]*?)<\/task>/g;
       let tm;
       while ((tm = taskRe.exec(text))) {
-        const idM    = tm[1].match(/id="([^"]+)"/);
-        const titleM = tm[2].match(/<title>([\s\S]*?)<\/title>/);
+        const idM      = tm[1].match(/id="([^"]+)"/);
+        const titleAttrM = tm[1].match(/title="([^"]*)"/);
+        const titleTagM  = tm[2].match(/<title>([\s\S]*?)<\/title>/);
         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}`,
+          title:  (titleAttrM && titleAttrM[1].trim()) || (titleTagM && titleTagM[1].trim()) || `Task ${stories.length + 1}`,
           status: phaseComplete ? 'done' : 'todo',
         };
         if (ov[story.id]) story.status = ov[story.id].status;