@hanzlaa/rcode 4.7.1 → 4.7.2

package/package.json

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

@@ -131,7 +131,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 +295,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;">

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,
 } 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>
@@ -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>