@hanzlaa/rcode 3.6.8 → 3.6.15

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`, 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`, `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`, 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

@@ -131,7 +131,7 @@ User types:  /rihal-prfaq
 | Add a new `/rihal-something` slash command | Create `rihal/commands/something.md` pointing to a workflow or skill |
 | Change the steps in an existing command | Edit the workflow it points to |
 | Improve how a persona thinks (Hanzla, Waleed, etc.) | Edit `rihal/skills/agents/<name>/SKILL.md` or `rihal/agents/<name>.md` |
-| Add a new agent to `/rihal-council` | Edit `rihal/agents/team.yaml` + add agent file |
+| Add a new agent to `/rihal-council` | Edit `rihal/team.yaml` + add agent file |
 | Improve a complex multi-stage task (PRFAQ, code review, etc.) | Edit the skill's stage reference files |
 | Add a new skill triggered by natural language | Create `rihal/skills/actions/<category>/<name>/SKILL.md` — no command file needed if slash is not required |
 | Fix a broken `@-include` reference | Check that the target file exists at `.rihal/<path>` after install |

package/README.md

@@ -11,7 +11,7 @@ npx @hanzlaa/rcode install    # one command, zero dependencies
 [![npm version](https://img.shields.io/npm/v/@hanzlaa/rcode)](https://www.npmjs.com/package/@hanzlaa/rcode)
 [![downloads](https://img.shields.io/npm/dw/@hanzlaa/rcode)](https://www.npmjs.com/package/@hanzlaa/rcode)
 
-Status: actively developed — published on npm as `@hanzlaa/rcode` v3.5.x, with an automated test suite covered by `node --test`.
+Status: actively developed — published on npm as `@hanzlaa/rcode` v3.6.x, with an automated test suite covered by `node --test`.
 
 ---
 
@@ -81,7 +81,7 @@ See [`docs/install.md`](docs/install.md) for flavors (module subsets, IDE option
 
 ```
 /rihal-council should I rewrite auth?        → 5 agents debate in parallel, 2 rounds
-/rihal-plan --research build a rental app    → researcher grounds, plan-checker verifies
+/rihal-plan --research build a rental app    → researcher grounds, sprint-checker verifies
 /rihal-execute .planning/plans/01/PLAN.md    → atomic commits + post-gates
 /rihal-status                                → phases, decisions, blockers, sessions
 ```
@@ -141,7 +141,7 @@ The design rule: **markdown owns the logic, scripts own the boundaries.** Heavy
 
 ### Verification built in
 
-`/rihal-plan` runs `rihal-plan-checker` to validate file/symbol references before execution. `/rihal-execute` runs `rihal-integration-checker` (cross-phase E2E) and `rihal-nyquist-auditor` (test coverage) after completion.
+`/rihal-plan` runs `rihal-sprint-checker` to validate file/symbol references before execution. `/rihal-execute` runs `rihal-integration-checker` (cross-phase E2E) and `rihal-nyquist-auditor` (test coverage) after completion.
 
 ---
 

package/cli/generate-command-skills.cjs

@@ -40,18 +40,11 @@ const path = require('path');
  * functional). Power users running niche commands like /rihal-prfaq or
  * /rihal-ui-phase still get them — they just don't show up in the sidebar.
  */
-const SIDEBAR_COMMANDS = new Set([
-  // Navigation & status (the daily check-in)
-  'do', 'status', 'next',
-  // Core lifecycle (the workflow loop)
-  'plan', 'execute', 'ship',
-  // Strategic
-  'council',
-  // Quality gate
-  'audit', 'verify-phase',
-  // Utility
-  'note',
-]);
+// Empty — sidebar stubs with user-invocable:false block direct /rihal-* invocation
+// in Claude Code 2.x. Commands in .claude/commands/ already appear in slash autocomplete.
+// The VS Code sidebar also shows commands directly in CC 2.x, so stubs are redundant.
+// Issue #710: sidebar stubs caused "can only be invoked by Claude" error for users.
+const SIDEBAR_COMMANDS = new Set([]);
 
 function parseFrontmatter(text) {
   if (!text.startsWith('---\n')) return {};

package/cli/index.js

@@ -139,7 +139,11 @@ function countGlobalRihal(dir) {
 }
 
 async function main() {
-  const [, , command = 'help', ...args] = process.argv;
+  let [, , command = 'help', ...args] = process.argv;
+
+  // Normalise flag aliases → bare-word commands
+  if (command === '--help' || command === '-h') command = 'help';
+  if (command === '--version' || command === '-v') command = 'version';
 
   // Show first-run banner before dispatching — npm hides postinstall output,
   // so this is the user's first visible confirmation that the install worked.

package/cli/lib/manifest.cjs

@@ -19,7 +19,10 @@ const path = require('path');
  * Read the expected skill set from the package source.
  * Returns { agents: Set<string>, actions: Set<string> }.
  *
- * `agents` are the directory names under rihal/skills/agents/ (e.g. "waleed-cto").
+ * `agents` are the bare names (no rihal- prefix, no .md) of the agent files
+ *   under rihal/agents/*.md — these are what install ships to
+ *   .claude/agents/rihal-<name>.md, .cursor/rules/rihal/agents/, etc.
+ *   NOT the phrase-activated agent skills under rihal/skills/agents/.
  * `actions` are the skill dir names under rihal/skills/actions/, plus the
  *   nested rihal/skills/actions/research/ children (flattened — matches how
  *   installSkills() copies them).
@@ -28,10 +31,16 @@ function readPackageManifest(packageRoot) {
   const skillsRoot = path.join(packageRoot, 'rihal/skills');
   const manifest = { agents: new Set(), actions: new Set() };
 
-  const agentsDir = path.join(skillsRoot, 'agents');
+  // Issue #783 — agents are file-based (rihal/agents/*.md), not the skill
+  // directories under rihal/skills/agents/. The installer ships rihal/agents/
+  // to every editor target; the old skill-dir source produced a different
+  // namespace ("fatima-qa" vs "fatima") and made doctor report constant drift.
+  const agentsDir = path.join(packageRoot, 'rihal/agents');
   if (fs.existsSync(agentsDir)) {
     for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
-      if (entry.isDirectory()) manifest.agents.add(entry.name);
+      if (!entry.isFile()) continue;
+      if (!entry.name.startsWith('rihal-') || !entry.name.endsWith('.md')) continue;
+      manifest.agents.add(entry.name.replace(/^rihal-/, '').replace(/\.md$/, ''));
     }
   }
 
@@ -154,7 +163,21 @@ function verifyClaudeInstall(cwd, packageRoot, options = {}) {
   // rihal-* dirs which excluded ALL real actions and made the diff always
   // report "everything missing." Compare directly against the prefixed set.
   const allInstalled = readInstalledDirs(skillsDir);
-  const actionsInstalled = new Set([...allInstalled].filter((n) => pkg.actions.has(n)));
+  let actionsInstalled = new Set([...allInstalled].filter((n) => pkg.actions.has(n)));
+
+  // Issue #783 — global precedence fallback for action skills, mirroring the
+  // agent fallback above. installSkills() skips project-level skills when
+  // ~/.claude/skills/ already has them (#679), leaving the project skills dir
+  // with only command stubs. Without this fallback the verifier reports
+  // "actions 0/37" on every successful install in that scenario.
+  if (actionsInstalled.size === 0 && globalFallback) {
+    try {
+      const os = require('os');
+      const globalSkillsDir = path.join(os.homedir(), '.claude/skills');
+      const globalInstalled = readInstalledDirs(globalSkillsDir);
+      actionsInstalled = new Set([...globalInstalled].filter((n) => pkg.actions.has(n)));
+    } catch { /* non-fatal — permission errors etc. */ }
+  }
 
   return [
     diffSet('claude', 'agents', pkg.agents, installedAgents),
@@ -163,63 +186,48 @@ function verifyClaudeInstall(cwd, packageRoot, options = {}) {
 }
 
 /**
- * Verify a Cursor or Windsurf install. Both install 19 digest-based
- * .mdc rules (one per agent) + a rihal-code.mdc overview rule.
+ * Verify a Cursor or Windsurf install. Issue #783: the installer ships one
+ * .mdc agent rule per rihal/agents/*.md into the NESTED directory
+ *   .cursor/rules/rihal/agents/rihal-<name>.mdc   (cursor)
+ *   .windsurf/rules/rihal/agents/rihal-<name>.mdc (windsurf)
+ * — not flat digest-based rules at .<ide>/rules/. Compare against the same
+ * agent set the Claude install uses.
  */
 function verifyRulesInstall(editor, cwd, packageRoot) {
   const pkg = readPackageManifest(packageRoot);
-  const rulesDir = path.join(
-    cwd,
-    editor === 'cursor' ? '.cursor/rules' : '.windsurf/rules'
-  );
+  const base = editor === 'cursor' ? '.cursor/rules' : '.windsurf/rules';
+  const agentsDir = path.join(cwd, base, 'rihal', 'agents');
 
   const installed = new Set();
-  if (fs.existsSync(rulesDir)) {
-    for (const file of fs.readdirSync(rulesDir)) {
-      if (!file.startsWith('rihal-') || !file.endsWith('.mdc')) continue;
-      if (file === 'rihal-code.mdc') continue; // overview meta-rule, not per-agent
-      installed.add(file.replace(/^rihal-/, '').replace(/\.mdc$/, ''));
-    }
-  }
-
-  // Rules are generated from digests, not agent skill dirs. Build expected
-  // set from rihal/digests/*.md.
-  const digestsDir = path.join(packageRoot, 'rihal/digests');
-  const expected = new Set();
-  if (fs.existsSync(digestsDir)) {
-    for (const file of fs.readdirSync(digestsDir)) {
-      if (!file.endsWith('.md') || file === 'README.md') continue;
-      expected.add(file.replace(/\.md$/, ''));
+  if (fs.existsSync(agentsDir)) {
+    for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
+      if (!entry.isFile()) continue; // skip the nested rules/ subdir
+      if (!entry.name.startsWith('rihal-') || !entry.name.endsWith('.mdc')) continue;
+      installed.add(entry.name.replace(/^rihal-/, '').replace(/\.mdc$/, ''));
     }
   }
 
-  return [diffSet(editor, 'rules', expected, installed)];
+  return [diffSet(editor, 'agents', pkg.agents, installed)];
 }
 
 /**
- * Verify an Antigravity install: .antigravity/agents/rihal-<agent>.md files.
- * One per digest.
+ * Verify an Antigravity install. Issue #783: the installer ships agent files
+ * to the NESTED .antigravity/rihal/agents/rihal-<name>.md — not
+ * .antigravity/agents/. Compare against the package agent set.
  */
 function verifyAntigravityInstall(cwd, packageRoot) {
-  const agentsDir = path.join(cwd, '.antigravity/agents');
+  const pkg = readPackageManifest(packageRoot);
+  const agentsDir = path.join(cwd, '.antigravity/rihal/agents');
   const installed = new Set();
   if (fs.existsSync(agentsDir)) {
-    for (const file of fs.readdirSync(agentsDir)) {
-      if (!file.startsWith('rihal-') || !file.endsWith('.md')) continue;
-      installed.add(file.replace(/^rihal-/, '').replace(/\.md$/, ''));
-    }
-  }
-
-  const digestsDir = path.join(packageRoot, 'rihal/digests');
-  const expected = new Set();
-  if (fs.existsSync(digestsDir)) {
-    for (const file of fs.readdirSync(digestsDir)) {
-      if (!file.endsWith('.md') || file === 'README.md') continue;
-      expected.add(file.replace(/\.md$/, ''));
+    for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
+      if (!entry.isFile()) continue;
+      if (!entry.name.startsWith('rihal-') || !entry.name.endsWith('.md')) continue;
+      installed.add(entry.name.replace(/^rihal-/, '').replace(/\.md$/, ''));
     }
   }
 
-  return [diffSet('antigravity', 'agents', expected, installed)];
+  return [diffSet('antigravity', 'agents', pkg.agents, installed)];
 }
 
 /**

package/dist/rcode.js

@@ -15029,10 +15029,12 @@ var require_manifest = __commonJS({
     function readPackageManifest(packageRoot) {
       const skillsRoot = path2.join(packageRoot, "rihal/skills");
       const manifest = { agents: /* @__PURE__ */ new Set(), actions: /* @__PURE__ */ new Set() };
-      const agentsDir = path2.join(skillsRoot, "agents");
+      const agentsDir = path2.join(packageRoot, "rihal/agents");
       if (fs2.existsSync(agentsDir)) {
         for (const entry of fs2.readdirSync(agentsDir, { withFileTypes: true })) {
-          if (entry.isDirectory()) manifest.agents.add(entry.name);
+          if (!entry.isFile()) continue;
+          if (!entry.name.startsWith("rihal-") || !entry.name.endsWith(".md")) continue;
+          manifest.agents.add(entry.name.replace(/^rihal-/, "").replace(/\.md$/, ""));
         }
       }
       function walkActions(dir) {
@@ -15101,7 +15103,16 @@ var require_manifest = __commonJS({
         }
       }
       const allInstalled = readInstalledDirs(skillsDir);
-      const actionsInstalled = new Set([...allInstalled].filter((n) => pkg.actions.has(n)));
+      let actionsInstalled = new Set([...allInstalled].filter((n) => pkg.actions.has(n)));
+      if (actionsInstalled.size === 0 && globalFallback) {
+        try {
+          const os = require("os");
+          const globalSkillsDir = path2.join(os.homedir(), ".claude/skills");
+          const globalInstalled = readInstalledDirs(globalSkillsDir);
+          actionsInstalled = new Set([...globalInstalled].filter((n) => pkg.actions.has(n)));
+        } catch {
+        }
+      }
       return [
         diffSet("claude", "agents", pkg.agents, installedAgents),
         diffSet("claude", "actions", pkg.actions, actionsInstalled)
@@ -15109,46 +15120,30 @@ var require_manifest = __commonJS({
     }
     function verifyRulesInstall(editor, cwd, packageRoot) {
       const pkg = readPackageManifest(packageRoot);
-      const rulesDir = path2.join(
-        cwd,
-        editor === "cursor" ? ".cursor/rules" : ".windsurf/rules"
-      );
+      const base = editor === "cursor" ? ".cursor/rules" : ".windsurf/rules";
+      const agentsDir = path2.join(cwd, base, "rihal", "agents");
       const installed = /* @__PURE__ */ new Set();
-      if (fs2.existsSync(rulesDir)) {
-        for (const file of fs2.readdirSync(rulesDir)) {
-          if (!file.startsWith("rihal-") || !file.endsWith(".mdc")) continue;
-          if (file === "rihal-code.mdc") continue;
-          installed.add(file.replace(/^rihal-/, "").replace(/\.mdc$/, ""));
-        }
-      }
-      const digestsDir = path2.join(packageRoot, "rihal/digests");
-      const expected = /* @__PURE__ */ new Set();
-      if (fs2.existsSync(digestsDir)) {
-        for (const file of fs2.readdirSync(digestsDir)) {
-          if (!file.endsWith(".md") || file === "README.md") continue;
-          expected.add(file.replace(/\.md$/, ""));
+      if (fs2.existsSync(agentsDir)) {
+        for (const entry of fs2.readdirSync(agentsDir, { withFileTypes: true })) {
+          if (!entry.isFile()) continue;
+          if (!entry.name.startsWith("rihal-") || !entry.name.endsWith(".mdc")) continue;
+          installed.add(entry.name.replace(/^rihal-/, "").replace(/\.mdc$/, ""));
         }
       }
-      return [diffSet(editor, "rules", expected, installed)];
+      return [diffSet(editor, "agents", pkg.agents, installed)];
     }
     function verifyAntigravityInstall(cwd, packageRoot) {
-      const agentsDir = path2.join(cwd, ".antigravity/agents");
+      const pkg = readPackageManifest(packageRoot);
+      const agentsDir = path2.join(cwd, ".antigravity/rihal/agents");
       const installed = /* @__PURE__ */ new Set();
       if (fs2.existsSync(agentsDir)) {
-        for (const file of fs2.readdirSync(agentsDir)) {
-          if (!file.startsWith("rihal-") || !file.endsWith(".md")) continue;
-          installed.add(file.replace(/^rihal-/, "").replace(/\.md$/, ""));
-        }
-      }
-      const digestsDir = path2.join(packageRoot, "rihal/digests");
-      const expected = /* @__PURE__ */ new Set();
-      if (fs2.existsSync(digestsDir)) {
-        for (const file of fs2.readdirSync(digestsDir)) {
-          if (!file.endsWith(".md") || file === "README.md") continue;
-          expected.add(file.replace(/\.md$/, ""));
+        for (const entry of fs2.readdirSync(agentsDir, { withFileTypes: true })) {
+          if (!entry.isFile()) continue;
+          if (!entry.name.startsWith("rihal-") || !entry.name.endsWith(".md")) continue;
+          installed.add(entry.name.replace(/^rihal-/, "").replace(/\.md$/, ""));
         }
       }
-      return [diffSet("antigravity", "agents", expected, installed)];
+      return [diffSet("antigravity", "agents", pkg.agents, installed)];
     }
     function verifyInstall(cwd, packageRoot, editors) {
       const reports = [];
@@ -21764,7 +21759,9 @@ function countGlobalRihal(dir) {
   }
 }
 async function main() {
-  const [, , command = "help", ...args] = process.argv;
+  let [, , command = "help", ...args] = process.argv;
+  if (command === "--help" || command === "-h") command = "help";
+  if (command === "--version" || command === "-v") command = "version";
   maybeShowFirstRunBanner();
   const handler = COMMANDS[command];
   if (!handler) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "3.6.8",
+  "version": "3.6.15",
   "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": {
@@ -29,6 +29,7 @@
     "CONTRIBUTING.md"
   ],
   "keywords": [
+    "rcode",
     "claude-code",
     "claude",
     "ai-agents",
@@ -53,7 +54,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hanzlahabib/rihal-code.git"
+    "url": "git+https://github.com/hanzlahabib/rihal-code.git"
   },
   "bugs": {
     "url": "https://github.com/hanzlahabib/rihal-code/issues"

package/rihal/bin/rihal-tools.cjs

@@ -1020,6 +1020,26 @@ function cmdState(subArgs) {
       }
     }
 
+    // Issue #681: auto-clear the install-time _seeded_stub marker once the
+    // state has graduated to a real project (project field set + at least one
+    // real phase OR REQUIREMENTS.md present). project-status (#675) reads
+    // _seeded_stub; if no writer ever clears it, every project stays "stub"
+    // forever and downstream workflows misroute.
+    if (state._seeded_stub === true) {
+      const phases = Array.isArray(state.phases) ? state.phases : [];
+      const firstPhaseName = phases[0]?.name || '';
+      const hasRealPhase = phases.length > 1 ||
+        (firstPhaseName && firstPhaseName !== 'Setup & Scaffolding');
+      const hasRequirements = (() => {
+        try {
+          return fs.existsSync(path.join(PROJECT_ROOT, '.planning', 'REQUIREMENTS.md'));
+        } catch { return false; }
+      })();
+      if ((state.project && hasRealPhase) || hasRequirements) {
+        delete state._seeded_stub;
+      }
+    }
+
     state.updated = new Date().toISOString();
     fs.mkdirSync(RIHAL_DIR, { recursive: true });
     const lockPath = statePath + '.lock';
@@ -6070,7 +6090,7 @@ function cmdProgress(args) {
     return insights;
   }
 
-  function deriveRoutes(state, roadmapPhases, diskByNum) {
+  function deriveRoutes(state, roadmapPhases, diskByNum, insights) {
     const routes = [];
     const statePhases = (state && (state.state?.phases || state.phases)) || [];
 
@@ -6092,26 +6112,18 @@ function cmdProgress(args) {
     }).slice(0, 3);
     for (const p of pendingExec) {
       const k = phaseKey(p);
-      routes.push({
-        letter: 'A',
-        label: `Execute phase ${k} — unfinished plans`,
-        command: `/rihal-execute ${k}`,
-      });
+      routes.push({ letter: 'A', label: '', command: `/rihal-execute ${k}` });
     }
 
     // Route B — phases with research but no plans
     const researchOnly = Object.entries(diskByNum)
       .filter(([num, d]) => d.has_research && d.plan_count === 0)
       .slice(0, 3);
-    for (const [num, d] of researchOnly) {
-      routes.push({
-        letter: 'B',
-        label: `Plan phase ${num} — researched, awaiting plan`,
-        command: `/rihal-plan-phase ${num}`,
-      });
+    for (const [num] of researchOnly) {
+      routes.push({ letter: 'B', label: '', command: `/rihal-plan ${num}` });
     }
 
-    // Route B' — in-progress phases without plans (the user is actively working but no SPRINT.md exists yet)
+    // Route B' — in-progress phases without plans
     const inProgressNoPlan = statePhases
       .filter(p => (p.status === 'in_progress' || p.status === 'in-progress'))
       .filter(p => {
@@ -6121,24 +6133,32 @@ function cmdProgress(args) {
       .slice(0, 2);
     for (const p of inProgressNoPlan) {
       const k = phaseKey(p);
-      routes.push({
-        letter: 'B',
-        label: `Plan phase ${k} — in progress without SPRINT.md`,
-        command: `/rihal-plan ${k}`,
-      });
+      routes.push({ letter: 'B', label: '', command: `/rihal-plan ${k}` });
     }
 
     // Route C — close out milestone if everything seems done
     const allDone = statePhases.length > 0 && statePhases.every(p => p.status === 'complete' || p.completed);
     if (allDone) {
-      routes.push({ letter: 'C', label: 'Audit current milestone', command: '/rihal-audit-milestone' });
-      routes.push({ letter: 'C', label: 'Complete current milestone', command: '/rihal-complete-milestone' });
+      // Count unverified phases (complete but no VERIFICATION.md on disk)
+      const unverifiedCount = statePhases.filter(p => {
+        const disk = diskByNum[phaseKey(p)];
+        return (p.status === 'complete' || p.completed) && disk && !disk.has_verification;
+      }).length;
+      const hasDrift = (insights || []).some(i => i.kind === 'roadmap-drift' || (i.message && i.message.includes('ROADMAP')));
+      const auditArgs = [];
+      if (unverifiedCount > 0) auditArgs.push(String(unverifiedCount));
+      if (hasDrift) auditArgs.push('--fix-drift');
+      const auditCmd = auditArgs.length > 0
+        ? `/rihal-audit-milestone ${auditArgs.join(' ')}`
+        : '/rihal-audit-milestone';
+      routes.push({ letter: 'C', label: '', command: auditCmd });
+      routes.push({ letter: 'C', label: '', command: '/rihal-complete-milestone' });
     }
 
     // Fallback — nothing obvious: offer status
     if (routes.length === 0) {
-      routes.push({ letter: 'A', label: 'Check progress detail', command: '/rihal-progress' });
-      routes.push({ letter: 'B', label: 'Start a council on what to do next', command: '/rihal-council' });
+      routes.push({ letter: 'A', label: '', command: '/rihal-progress' });
+      routes.push({ letter: 'B', label: '', command: '/rihal-council' });
     }
 
     return routes;
@@ -6208,14 +6228,15 @@ function cmdProgress(args) {
   }
 
   if (sub === 'routes') {
-    return { ok: true, routes: deriveRoutes(state, roadmapPhases, diskByNum) };
+    const routeInsights = detectInsights(state, roadmapPhases, diskByNum);
+    return { ok: true, routes: deriveRoutes(state, roadmapPhases, diskByNum, routeInsights) };
   }
 
   // sub === 'init' (default) — full snapshot
   const currentPhase = state && state.current_phase;
   const insights = detectInsights(state, roadmapPhases, diskByNum);
   enforceStrictGate(insights);
-  const routes = deriveRoutes(state, roadmapPhases, diskByNum);
+  const routes = deriveRoutes(state, roadmapPhases, diskByNum, insights);
   const { weighted: weightedCompleted, pct: weightedPct } = computeWeightedProgress(statePhases, diskByNum);
 
   return {

package/rihal/commands/add-todo.md

@@ -2,7 +2,7 @@
 name: rihal-add-todo
 description: Capture an idea or task for later work
 argument-hint: "<todo-title>"
-allowed-tools: bash, read, write
+allowed-tools: Bash, Read, Write
 ---
 
 @.rihal/workflows/add-todo.md

package/rihal/commands/check-implementation-readiness.md

@@ -0,0 +1,18 @@
+---
+name: rihal-check-implementation-readiness
+description: "Verify a feature is fully ready to implement — PRD approved, architecture approved, dependencies identified — before writing code."
+argument-hint: "[--phase <n>]"
+allowed-tools: Read, Write, Bash, Glob, Grep, Agent
+---
+
+<objective>
+Execute check-implementation-readiness workflow
+</objective>
+
+<execution_context>
+@.rihal/workflows/check-implementation-readiness.md
+</execution_context>
+
+<process>
+Execute the check-implementation-readiness workflow from @.rihal/workflows/check-implementation-readiness.md end-to-end.
+</process>

package/rihal/commands/create-architecture.md

@@ -0,0 +1,18 @@
+---
+name: rihal-create-architecture
+description: "Write an Architecture Decision Record (ADR) or system design document that informs implementation."
+argument-hint: "[topic]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Execute create-architecture workflow
+</objective>
+
+<execution_context>
+@.rihal/workflows/create-architecture.md
+</execution_context>
+
+<process>
+Execute the create-architecture workflow from @.rihal/workflows/create-architecture.md end-to-end.
+</process>

package/rihal/commands/debug.md

@@ -2,7 +2,7 @@
 name: rihal-debug
 description: Systematically investigate and diagnose issues
 argument-hint: "<issue-description>"
-allowed-tools: task, bash, read, grep, glob
+allowed-tools: Task, Bash, Read, Grep, Glob
 ---
 
 @.rihal/workflows/debug.md

package/rihal/commands/edit-prd.md

@@ -0,0 +1,18 @@
+---
+name: rihal-edit-prd
+description: "Update an existing PRD with revisions or clarifications. Use after validation findings or scope changes."
+argument-hint: "[prd-path]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute edit-prd workflow
+</objective>
+
+<execution_context>
+@.rihal/workflows/edit-prd.md
+</execution_context>
+
+<process>
+Execute the edit-prd workflow from @.rihal/workflows/edit-prd.md end-to-end.
+</process>

package/rihal/commands/memory-audit.md

@@ -1,5 +1,5 @@
 ---
-name: rcode:memory-audit
+name: rihal-memory-audit
 description: Audit the Memory Bank for stale entries, contradictions, and unfilled placeholders — read-only report
 argument-hint: "[--severity {critical|warn|info}]"
 allowed-tools:

package/rihal/commands/memory-distill.md

@@ -1,5 +1,5 @@
 ---
-name: rcode:memory-distill
+name: rihal-memory-distill
 description: Regenerate Memory Bank distillates — token-optimised lossless compressions for fast LLM context loading
 argument-hint: "[--force] [--target {project|stack|all}]"
 allowed-tools:

package/rihal/commands/memory-init.md

@@ -1,5 +1,5 @@
 ---
-name: rcode:memory-init
+name: rihal-memory-init
 description: Bootstrap the rcode Memory Bank for this project — copies templates, asks 5 questions, populates seed files
 argument-hint: ""
 allowed-tools:

package/rihal/commands/memory-update.md

@@ -1,5 +1,5 @@
 ---
-name: rcode:memory-update
+name: rihal-memory-update
 description: Append a decision, known issue, stakeholder, or milestone update to the Memory Bank from conversation context
 argument-hint: "<content>"
 allowed-tools:

package/rihal/commands/progress.md

@@ -2,7 +2,7 @@
 name: rihal-progress
 description: Alias of /rihal-status --verbose — full project state dashboard with decisions, blockers, and next-step routes
 argument-hint: ""
-allowed-tools: bash, read, grep
+allowed-tools: Bash, Read, Grep
 ---
 
 <objective>

package/rihal/commands/resume-work.md

@@ -2,7 +2,7 @@
 name: rihal-resume-work
 description: Restore project context and resume work
 argument-hint: ""
-allowed-tools: bash, read
+allowed-tools: Bash, Read
 ---
 
 @.rihal/workflows/resume-work.md

package/rihal/commands/retrospective.md

@@ -0,0 +1,18 @@
+---
+name: rihal-retrospective
+description: "Run an epic retrospective and produce owned action items."
+argument-hint: "[epic]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute retrospective workflow
+</objective>
+
+<execution_context>
+@.rihal/workflows/retrospective.md
+</execution_context>
+
+<process>
+Execute the retrospective workflow from @.rihal/workflows/retrospective.md end-to-end.
+</process>