@hanzlaa/rcode 3.6.16 → 4.1.0

package/cli/nuke.js

@@ -1,12 +1,12 @@
 /**
  * rcode nuke — one-shot full cleanup
  *
- * Removes EVERY trace of rihal/rcode from the system:
+ * Removes EVERY trace of rcode/rcode from the system:
  *   - Global npm/pnpm/yarn/bun installs (both @hanzlaa/rcode and legacy @hanzlahabib/rihal-code)
- *   - Global binaries (rcode, rihal, rihal-code) in all known PATH dirs
- *   - Global Claude Code artifacts (~/.claude/commands/rihal*, ~/.claude/agents/rihal-*, ~/.claude/skills/rihal-*)
- *   - Global state (~/.rihal/)
- *   - Project-level artifacts in CWD (.claude/commands/rihal*, .claude/agents/rihal-*, .rihal/, .planning/ optional)
+ *   - Global binaries (rcode, rcode, rcode) in all known PATH dirs
+ *   - Global Claude Code artifacts (~/.claude/commands/rcode*, ~/.claude/agents/rcode-*, ~/.claude/skills/rcode-*)
+ *   - Global state (~/.rcode/)
+ *   - Project-level artifacts in CWD (.claude/commands/rcode*, .claude/agents/rcode-*, .rcode/, .planning/ optional)
  *
  * Default mode: dry-run — prints what *would* be removed.
  * Pass --yes to actually remove. Pass --include-planning to also remove .planning/ in CWD.
@@ -84,17 +84,17 @@ function getGlobalNodeModulesDirs() {
 }
 
 /**
- * For a given global node_modules dir, return a list of rihal/rcode package paths.
+ * For a given global node_modules dir, return a list of rcode/rcode package paths.
  * Looks for both @hanzlaa/rcode (current) and @hanzlahabib/rihal-code (legacy).
  */
-function findRihalPackages(globalNodeModules) {
+function findRcodePackages(globalNodeModules) {
   const found = [];
   for (const scope of ['@hanzlaa', '@hanzlahabib']) {
     const scopeDir = path.join(globalNodeModules, scope);
     if (!exists(scopeDir)) continue;
     for (const pkg of readDirSafe(scopeDir)) {
-      // Match rcode, rihal-code, or anything starting with rihal
-      if (pkg === 'rcode' || pkg === 'rihal-code' || pkg.startsWith('rihal')) {
+      // Match rcode, rcode, or anything starting with rcode
+      if (pkg === 'rcode' || pkg === 'rcode' || pkg.startsWith('rcode')) {
         found.push({ scope, pkg, dir: path.join(scopeDir, pkg) });
       }
     }
@@ -103,7 +103,7 @@ function findRihalPackages(globalNodeModules) {
 }
 
 /**
- * Resolve global bin directories where rcode/rihal/rihal-code may live.
+ * Resolve global bin directories where rcode/rcode/rcode may live.
  */
 function getGlobalBinDirs() {
   const home = os.homedir();
@@ -149,18 +149,18 @@ function getGlobalBinDirs() {
   return [...dirs].filter(exists);
 }
 
-const RCODE_BINS = ['rcode', 'rihal', 'rihal-code'];
+const RCODE_BINS = ['rcode', 'rcode', 'rcode'];
 
-function findRihalBins(binDir) {
+function findRcodeBins(binDir) {
   const found = [];
   for (const name of RCODE_BINS) {
     const p = path.join(binDir, name);
     if (exists(p)) {
       let target = null;
       try { target = fs.readlinkSync(p); } catch {}
-      // Only flag if it's clearly ours (target points at rcode/rihal-code package).
+      // Only flag if it's clearly ours (target points at rcode/rcode package).
       // If it's not a symlink, include it anyway — bare scripts in pnpm bin etc.
-      if (!target || /rcode|rihal-code|@hanzlaa|@hanzlahabib/.test(target)) {
+      if (!target || /rcode|rcode|@hanzlaa|@hanzlahabib/.test(target)) {
         found.push({ name, path: p, target });
       }
     }
@@ -169,42 +169,42 @@ function findRihalBins(binDir) {
 }
 
 /**
- * Find rihal-related artifacts in a Claude Code config dir (~/.claude or .claude in CWD).
+ * Find rcode-related artifacts in a Claude Code config dir (~/.claude or .claude in CWD).
  */
 function findClaudeArtifacts(claudeDir) {
   const found = [];
   if (!exists(claudeDir)) return found;
 
-  // .claude/commands/rihal-*.md (claude-style root)
+  // .claude/commands/rcode-*.md (claude-style root)
   const cmdRoot = path.join(claudeDir, 'commands');
   if (exists(cmdRoot)) {
     for (const f of readDirSafe(cmdRoot)) {
-      if (f.startsWith('rihal-') && (f.endsWith('.md') || f.endsWith('.mdc'))) {
+      if (f.startsWith('rcode-') && (f.endsWith('.md') || f.endsWith('.mdc'))) {
         found.push({ kind: 'command', path: path.join(cmdRoot, f) });
       }
     }
-    // .claude/commands/rihal/ (vscode-style subdir)
-    const rihalSubdir = path.join(cmdRoot, 'rihal');
-    if (exists(rihalSubdir)) {
-      found.push({ kind: 'commands-dir', path: rihalSubdir });
+    // .claude/commands/rcode/ (vscode-style subdir)
+    const rcodeSubdir = path.join(cmdRoot, 'rcode');
+    if (exists(rcodeSubdir)) {
+      found.push({ kind: 'commands-dir', path: rcodeSubdir });
     }
   }
 
-  // .claude/agents/rihal-*.md
+  // .claude/agents/rcode-*.md
   const agentsDir = path.join(claudeDir, 'agents');
   if (exists(agentsDir)) {
     for (const f of readDirSafe(agentsDir)) {
-      if (f.startsWith('rihal-') && (f.endsWith('.md') || f.endsWith('.mdc'))) {
+      if (f.startsWith('rcode-') && (f.endsWith('.md') || f.endsWith('.mdc'))) {
         found.push({ kind: 'agent', path: path.join(agentsDir, f) });
       }
     }
   }
 
-  // .claude/skills/rihal-*
+  // .claude/skills/rcode-*
   const skillsDir = path.join(claudeDir, 'skills');
   if (exists(skillsDir)) {
     for (const d of readDirSafe(skillsDir)) {
-      if (d.startsWith('rihal-')) {
+      if (d.startsWith('rcode-')) {
         found.push({ kind: 'skill-dir', path: path.join(skillsDir, d) });
       }
     }
@@ -220,22 +220,22 @@ function buildPlan({ includePlanning }) {
     packages: [],
     bins: [],
     globalClaude: [],
-    globalRihal: null,
+    globalrcode: null,
     projectClaude: [],
-    projectRihal: null,
+    projectrcode: null,
     projectPlanning: null,
   };
 
   // Global node_modules packages
   for (const { manager, dir } of getGlobalNodeModulesDirs()) {
-    for (const pkg of findRihalPackages(dir)) {
+    for (const pkg of findRcodePackages(dir)) {
       plan.packages.push({ manager, ...pkg });
     }
   }
 
   // Global binaries
   for (const binDir of getGlobalBinDirs()) {
-    for (const bin of findRihalBins(binDir)) {
+    for (const bin of findRcodeBins(binDir)) {
       plan.bins.push({ binDir, ...bin });
     }
   }
@@ -243,14 +243,14 @@ function buildPlan({ includePlanning }) {
   // Global Claude artifacts (~/.claude/)
   plan.globalClaude = findClaudeArtifacts(path.join(home, '.claude'));
 
-  // Global state (~/.rihal/)
-  const globalRihal = path.join(home, '.rihal');
-  if (exists(globalRihal)) plan.globalRihal = globalRihal;
+  // Global state (~/.rcode/)
+  const globalrcode = path.join(home, '.rcode');
+  if (exists(globalrcode)) plan.globalrcode = globalRcode;
 
   // Project-level (CWD only — never recurse, user may have many projects)
   plan.projectClaude = findClaudeArtifacts(path.join(cwd, '.claude'));
-  const projectRihal = path.join(cwd, '.rihal');
-  if (exists(projectRihal) && cwd !== home) plan.projectRihal = projectRihal;
+  const projectrcode = path.join(cwd, '.rcode');
+  if (exists(projectrcode) && cwd !== home) plan.projectrcode = projectRcode;
 
   if (includePlanning) {
     const projectPlanning = path.join(cwd, '.planning');
@@ -262,7 +262,7 @@ function buildPlan({ includePlanning }) {
 
 function printPlan(plan, { dryRun }) {
   const banner = dryRun ? '[DRY RUN — pass --yes to remove]' : '[REMOVING]';
-  console.log(`\n🔥 rcode nuke ${banner}\n`);
+  console.log(`\n🔥 rcode nuke  · by Hanzla Habib  ${banner}\n`);
 
   let total = 0;
   const section = (title, items) => {
@@ -292,13 +292,13 @@ function printPlan(plan, { dryRun }) {
     description: `[${a.kind}] ${a.path}`,
   })));
 
-  if (plan.globalRihal) section('🗂️  ~/.rihal/ (global state):', plan.globalRihal);
+  if (plan.globalrcode) section('🗂️  ~/.rcode/ (global state):', plan.globalrcode);
 
   section('🤖 ./.claude/ artifacts (current project):', plan.projectClaude.map(a => ({
     description: `[${a.kind}] ${a.path}`,
   })));
 
-  if (plan.projectRihal) section('🗂️  ./.rihal/ (project state):', plan.projectRihal);
+  if (plan.projectrcode) section('🗂️  ./.rcode/ (project state):', plan.projectrcode);
   if (plan.projectPlanning) section('📋 ./.planning/ (your work — only with --include-planning):', plan.projectPlanning);
 
   if (total === 0) {
@@ -350,16 +350,16 @@ function executePlan(plan) {
   for (const a of plan.globalClaude) {
     if (rmrf(a.path)) { console.log(`  ✓ removed ${a.path}`); removed++; }
   }
-  if (plan.globalRihal && rmrf(plan.globalRihal)) {
-    console.log(`  ✓ removed ${plan.globalRihal}`); removed++;
+  if (plan.globalrcode && rmrf(plan.globalrcode)) {
+    console.log(`  ✓ removed ${plan.globalRcode}`); removed++;
   }
 
   // Claude artifacts (project)
   for (const a of plan.projectClaude) {
     if (rmrf(a.path)) { console.log(`  ✓ removed ${a.path}`); removed++; }
   }
-  if (plan.projectRihal && rmrf(plan.projectRihal)) {
-    console.log(`  ✓ removed ${plan.projectRihal}`); removed++;
+  if (plan.projectrcode && rmrf(plan.projectrcode)) {
+    console.log(`  ✓ removed ${plan.projectRcode}`); removed++;
   }
   if (plan.projectPlanning && rmrf(plan.projectPlanning)) {
     console.log(`  ✓ removed ${plan.projectPlanning}`); removed++;
@@ -379,7 +379,7 @@ module.exports = function nuke(args = []) {
       const pkg = JSON.parse(fs.readFileSync(cwdPkgJson, 'utf8'));
       if (pkg.name === '@hanzlaa/rcode' || pkg.name === '@hanzlahabib/rihal-code') {
         console.log('\n⚠  You are inside the rcode source repo.');
-        console.log('   Nuke would remove this repo\'s .claude/, .rihal/, and possibly .planning/.');
+        console.log('   Nuke would remove this repo\'s .claude/, .rcode/, and possibly .planning/.');
         console.log('   That is your source code — almost certainly not what you want.');
         console.log('   Run nuke from a different directory, or pass --i-know-what-im-doing to override.\n');
         if (!args.includes('--i-know-what-im-doing')) return;

package/cli/postinstall.js

@@ -1,8 +1,8 @@
 /**
- * rihal-code postinstall hook — runs automatically after `npm install -g`
+ * rcode postinstall hook — runs automatically after `npm install -g`
  *
  * Auto-installs commands, skills, workflows, and bin tools into the global
- * Claude Code directory (~/.claude/) so every project can use rihal immediately
+ * Claude Code directory (~/.claude/) so every project can use rcode immediately
  * without needing a per-project `rcode install` run.
  *
  * Artifacts (.planning/, STATE.md, ROADMAP.md) are always created in the
@@ -75,10 +75,10 @@ if (isGlobalInstall(process.env, __dirname, process.cwd())) {
       // surface later for users who never saw the original line.
       const receiptLine = `✓ rcode installed → ${globalTarget}  (run 'rcode install' in a project to configure)`;
       process.stderr.write('\n' + receiptLine + '\n');
-      process.stderr.write('  All /rihal-* commands are now available in every project.\n\n');
+      process.stderr.write('  All /rcode-* commands are now available in every project.\n\n');
       try {
         const fs = require('fs');
-        const receiptPath = path.join(globalTarget, '.rihal-install-receipt');
+        const receiptPath = path.join(globalTarget, '.rcode-install-receipt');
         const receipt = {
           ts: new Date().toISOString(),
           target: globalTarget,
@@ -95,7 +95,7 @@ if (isGlobalInstall(process.env, __dirname, process.cwd())) {
   });
   child.on('error', (err) => {
     console.warn(`\n⚠ Global auto-install failed: ${err.message}`);
-    console.warn('  Run "rcode install" manually to set up rihal commands.\n');
+    console.warn('  Run "rcode install" manually to set up rcode commands.\n');
     printWelcome();
   });
 } else {
@@ -104,21 +104,21 @@ if (isGlobalInstall(process.env, __dirname, process.cwd())) {
 
 function printWelcome() {
   console.log(`
-🕌 Rihal Code installed.
+🕌 rcode installed — by Hanzla Habib
 
 Commands are available globally in every Claude Code project.
 To set up per-project state + planning structure, run inside your project:
 
-  rcode install      # creates .rihal/config.yaml, .planning/, STATE.md
+  rcode install      # creates .rcode/config.yaml, .planning/, STATE.md
 
 🌱 The Golden Path (say these phrases in your AI IDE):
-  1. "scaffold a new project"     → rihal-scaffold-project
-  2. "create a PRD"               → rihal-create-prd
-  3. "create a story"             → rihal-create-story
-  4. "plan a sprint"              → rihal-sprint-planning
-  5. "dev this story"             → rihal-dev-story
-  6. "review this code"           → rihal-code-review
-  7. "sprint status"              → rihal-sprint-status
+  1. "scaffold a new project"     → rcode-scaffold-project
+  2. "create a PRD"               → rcode-create-prd
+  3. "create a story"             → rcode-create-story
+  4. "plan a sprint"              → rcode-sprint-planning
+  5. "dev this story"             → rcode-dev-story
+  6. "review this code"           → rcode-review
+  7. "sprint status"              → rcode-sprint-status
 
 More:
   rcode help         # all commands (grouped)

package/cli/set-mode.js

@@ -1,21 +1,21 @@
 /**
- * rihal-code set-mode — toggle the communication mode.
+ * rcode set-mode — toggle the communication mode.
  *
- * Thin wrapper over `rihal-code config communication_mode <value>` with
+ * Thin wrapper over `rcode config communication_mode <value>` with
  * inline explanations of what each mode changes. Supports the same
  * typo suggestions as the underlying config setter.
  *
  * Usage:
- *   rihal-code set-mode                show current mode + explanation
- *   rihal-code set-mode guided         switch to guided (ask at gates)
- *   rihal-code set-mode yolo           switch to yolo (skip menus, trust defaults)
+ *   rcode set-mode                show current mode + explanation
+ *   rcode set-mode guided         switch to guided (ask at gates)
+ *   rcode set-mode yolo           switch to yolo (skip menus, trust defaults)
  *
  * Affects:
  *   - Workflow step files ("halt at menu" vs "pick default and continue")
- *   - /rihal-kickoff next-step menu (interactive vs auto-continue)
+ *   - /rcode-kickoff next-step menu (interactive vs auto-continue)
  *   - github-sync confirmation prompts (yolo still requires --force-yolo
  *     for github mutations — see docs/adr/0001-github-sync-as-cli.md)
- *   - /rihal-pause and /rihal-resume (yolo skips the confirmation prompt
+ *   - /rcode-pause and /rcode-resume (yolo skips the confirmation prompt
  *     on resume; guided always asks)
  *   - All agent skill files that read communication_mode from config
  */
@@ -41,16 +41,26 @@ const MODE_DESCRIPTIONS = {
 
 module.exports = function setMode(args) {
   const cwd = process.cwd();
-  const rihalDir = path.join(cwd, '.rihal');
+  const rcodeDir = path.join(cwd, '.rcode');
 
-  if (!fs.existsSync(rihalDir)) {
-    console.error(`❌ No .rihal/ directory found in ${cwd}`);
+  if (!fs.existsSync(rcodeDir)) {
+    console.error(`❌ No .rcode/ directory found in ${cwd}`);
     console.error(`   Run 'rcode install' first.`);
     process.exit(1);
   }
 
   const requested = args[0];
 
+  if (requested === '--help' || requested === '-h') {
+    console.log(`Usage: rcode set-mode [<mode>]`);
+    console.log();
+    console.log(`  rcode set-mode               show current mode + explanation`);
+    console.log(`  rcode set-mode <mode>        switch to mode <mode>`);
+    console.log();
+    console.log(`Available modes: ${[...VALID_COMMUNICATION_MODES].join(', ')}`);
+    process.exit(0);
+  }
+
   if (!requested) {
     // Show current + available modes
     const config = loadConfig(cwd);

package/cli/set-profile.js

@@ -1,5 +1,5 @@
 /**
- * rihal-code set-profile — change the model profile for the current project
+ * rcode set-profile — change the model profile for the current project
  *
  * Usage:
  *   npx @hanzlaa/rcode set-profile balanced
@@ -8,7 +8,7 @@
  *   npx @hanzlaa/rcode set-profile inherit
  *   npx @hanzlaa/rcode set-profile                  # show current
  *
- * This is a thin wrapper over `rihal-code config model_profile <name>`.
+ * This is a thin wrapper over `rcode config model_profile <name>`.
  * All config read/write goes through cli/lib/config.cjs, which handles
  * atomic writes, allowlist validation, and typo suggestions.
  */
@@ -26,10 +26,10 @@ const { setConfigValue, getConfigValue } = require('./lib/config.cjs');
 
 module.exports = function setProfile(args) {
   const cwd = process.cwd();
-  const rihalDir = path.join(cwd, '.rihal');
+  const rcodeDir = path.join(cwd, '.rcode');
 
-  if (!fs.existsSync(rihalDir)) {
-    console.error(`❌ No .rihal/ directory found in ${cwd}`);
+  if (!fs.existsSync(rcodeDir)) {
+    console.error(`❌ No .rcode/ directory found in ${cwd}`);
     console.error(`   Run 'rcode install' first.`);
     process.exit(1);
   }
@@ -37,6 +37,16 @@ module.exports = function setProfile(args) {
   const requested = args[0];
   const available = listProfiles();
 
+  if (requested === '--help' || requested === '-h') {
+    console.log(`Usage: rcode set-profile [<name>]`);
+    console.log();
+    console.log(`  rcode set-profile             show current profile + available options`);
+    console.log(`  rcode set-profile <name>      switch to profile <name>`);
+    console.log();
+    console.log(`Available profiles: ${available.join(', ')}`);
+    process.exit(0);
+  }
+
   if (!requested) {
     // Show current profile + available options
     const current = getProjectProfile(cwd);

package/cli/show-model.js

@@ -1,5 +1,5 @@
 /**
- * rihal-code show-model — print the resolved model for an agent (or all agents)
+ * rcode show-model — print the resolved model for an agent (or all agents)
  *
  * Usage:
  *   npx @hanzlaa/rcode show-model              # all agents in current profile

package/cli/team.js

@@ -1,12 +1,12 @@
 /**
- * rihal-code team — list the team roster
+ * rcode team — list the team roster
  */
 
 const fs = require('fs');
 const path = require('path');
 
 module.exports = function team(args, { packageRoot }) {
-  const digestDir = path.join(packageRoot, 'rihal/digests');
+  const digestDir = path.join(packageRoot, 'rcode/digests');
 
   if (!fs.existsSync(digestDir)) {
     console.error('Agent digests not found. Is the package installed correctly?');
@@ -15,7 +15,7 @@ module.exports = function team(args, { packageRoot }) {
 
   const files = fs.readdirSync(digestDir).filter((f) => f.endsWith('.md') && f !== 'README.md');
 
-  console.log(`\n🕌 Rihal Code Team Roster (${files.length} agents)\n`);
+  console.log(`\n🕌 rcode Team Roster (${files.length} agents)\n`);
   console.log('─'.repeat(80));
 
   for (const file of files.sort()) {
@@ -30,6 +30,6 @@ module.exports = function team(args, { packageRoot }) {
   }
 
   console.log('─'.repeat(80));
-  console.log(`\nFor full agent details: cat rihal/digests/{agent}.md`);
-  console.log(`For full skill: rihal/skills/agents/{agent-dir}/SKILL.md\n`);
+  console.log(`\nFor full agent details: cat rcode/digests/{agent}.md`);
+  console.log(`For full skill: rcode/skills/agents/{agent-dir}/SKILL.md\n`);
 };

package/cli/tiers.js

@@ -1,5 +1,5 @@
 /**
- * rihal-code tiers — print the tier map
+ * rcode tiers — print the tier map
  *
  * Reads docs/TIERS.md from the package and prints a compact version.
  * Full detail stays in docs/TIERS.md (single source of truth).
@@ -7,19 +7,19 @@
 
 module.exports = function tiers(_args, { packageJson }) {
   console.log(`
-🕌 Rihal Code v${packageJson.version} — Tiers
+🕌 rcode v${packageJson.version} — Tiers
 
 Everything is organized into 4 tiers + a preview track. Start with 🌱 Starter.
 
 🌱 STARTER — The Golden Path (7 skills)
-   First-time Rihalian. Scaffold → ship, end-to-end.
-     1. rihal-scaffold-project      "scaffold a new project"
-     2. rihal-create-prd            "create a PRD"
-     3. rihal-create-story          "create a story"
-     4. rihal-sprint-planning       "plan a sprint"
-     5. rihal-dev-story             "dev this story"
-     6. rihal-code-review           "review this code"
-     7. rihal-sprint-status         "sprint status"
+   First-time rcode user. Scaffold → ship, end-to-end.
+     1. rcode-scaffold-project      "scaffold a new project"
+     2. rcode-create-prd            "create a PRD"
+     3. rcode-create-story          "create a story"
+     4. rcode-sprint-planning       "plan a sprint"
+     5. rcode-dev-story             "dev this story"
+     6. rcode-review           "review this code"
+     7. rcode-sprint-status         "sprint status"
    Agents: Sadiq · Hussain · Nasser
 
 🌿 ADVANCED — Real Sprint Team (9 skills)