@hanzlaa/rcode 3.6.16 → 4.1.0

package/cli/doctor.js

@@ -1,9 +1,9 @@
 /**
- * rihal-code doctor — preflight + compliance checks
+ * rcode doctor — preflight + compliance checks
  *
  * Two sections:
  *   1. Preflight — environment checks that affect whether install/sync will work
- *      (node version, writable .rihal/, model-profiles.json validity, optional
+ *      (node version, writable .rcode/, model-profiles.json validity, optional
  *      git/gh availability, agent manifest drift)
  *   2. Package compliance — 5-component skill standard on the package source
  *
@@ -40,7 +40,7 @@ function findSkillFiles(dir) {
 }
 
 /**
- * One-level scan of `rihal/agents/` for `.md` files. There is no existing
+ * One-level scan of `rcode/agents/` for `.md` files. There is no existing
  * agent-file iterator (findSkillFiles matches only files named SKILL.md),
  * so the schema-validation pass needs its own shallow glob.
  */
@@ -52,13 +52,30 @@ function findAgentFiles(dir) {
     .map((e) => path.join(dir, e.name));
 }
 
+// Negative-boundary signal — an explicit statement of what a skill does NOT do.
+// Mirrors the same constant in cli/lib/schemas.cjs so both checks stay in sync.
+const NEGATIVE_BOUNDARY_RE = /not for|do not|does not|don't|never\b|audit-only|negative/i;
+
 function checkCompliance(filePath) {
   const content = fs.readFileSync(filePath, 'utf8');
+  const { frontmatter, body } = parseFrontmatter(content);
   const missing = [];
   if (!/^name:/m.test(content)) missing.push('name');
   if (!/^description:/m.test(content)) missing.push('description');
+  if (!/^## Overview/m.test(content)) missing.push('Overview section');
   if (!/^## Output Format/m.test(content)) missing.push('Output Format');
   if (!/^## Examples/m.test(content)) missing.push('Examples');
+
+  // Negative-boundary clause (component 1 of the 5-component standard).
+  // Parse the frontmatter description so folded-block YAML is normalized
+  // before the regex runs — "Do\n  NOT" becomes "Do NOT" after normalization.
+  const desc = typeof frontmatter.description === 'string' ? frontmatter.description : '';
+  const hasBoundary =
+    NEGATIVE_BOUNDARY_RE.test(desc) ||
+    /##[^\n]*\bnot\b/i.test(body) ||
+    /\bdo not (use|include)\b/i.test(body);
+  if (!hasBoundary) missing.push('negative-boundary clause');
+
   return missing;
 }
 
@@ -100,24 +117,24 @@ function runPreflight(cwd, packageRoot) {
     message: `v${nodeVersion}${major < 18 ? ' — upgrade to 18 LTS or newer' : ''}`,
   });
 
-  // 2. .rihal/ state directory — only check if project is initialized
-  const rihalDir = path.join(cwd, '.rihal');
-  if (fs.existsSync(rihalDir)) {
+  // 2. .rcode/ state directory — only check if project is initialized
+  const rcodeDir = path.join(cwd, '.rcode');
+  if (fs.existsSync(rcodeDir)) {
     checks.push({
-      label: '.rihal/ writable',
-      status: isWritable(rihalDir) ? 'ok' : 'fail',
-      message: rihalDir,
+      label: '.rcode/ writable',
+      status: isWritable(rcodeDir) ? 'ok' : 'fail',
+      message: rcodeDir,
     });
   } else {
     checks.push({
-      label: '.rihal/ state',
+      label: '.rcode/ state',
       status: 'warn',
       message: 'not initialized in this directory (run `rcode install`)',
     });
   }
 
   // 3. Package model-profiles.json parses and has expected profiles
-  const profilesPath = path.join(packageRoot, 'rihal/config/model-profiles.json');
+  const profilesPath = path.join(packageRoot, 'rcode/config/model-profiles.json');
   if (fs.existsSync(profilesPath)) {
     try {
       const profiles = JSON.parse(fs.readFileSync(profilesPath, 'utf8'));
@@ -168,8 +185,8 @@ function runPreflight(cwd, packageRoot) {
       : 'not found (github-sync unavailable)',
   });
 
-  // 6. Agent manifest drift (only if .rihal/ is initialized — indicates installed editors)
-  if (fs.existsSync(rihalDir)) {
+  // 6. Agent manifest drift (only if .rcode/ is initialized — indicates installed editors)
+  if (fs.existsSync(rcodeDir)) {
     const editors = [];
     if (fs.existsSync(path.join(cwd, '.claude/skills'))) editors.push('claude');
     if (fs.existsSync(path.join(cwd, '.cursor/rules'))) editors.push('cursor');
@@ -210,7 +227,7 @@ function runPreflight(cwd, packageRoot) {
       checks.push({
         label: 'Memory bank',
         status: 'warn',
-        message: 'never initialized (run /rihal-init to populate)',
+        message: 'never initialized (run /rcode-init to populate)',
       });
     } else {
       checks.push({
@@ -241,8 +258,8 @@ function printChecks(checks) {
 
 function runCompliance(packageRoot) {
   const skillDirs = [
-    path.join(packageRoot, 'rihal/skills/agents'),
-    path.join(packageRoot, 'rihal/skills/actions'),
+    path.join(packageRoot, 'rcode/skills/agents'),
+    path.join(packageRoot, 'rcode/skills/actions'),
   ];
 
   let totalSkills = 0;
@@ -290,8 +307,8 @@ function runCompliance(packageRoot) {
  */
 function runSchemaValidation(packageRoot) {
   const skillDirs = [
-    path.join(packageRoot, 'rihal/skills/agents'),
-    path.join(packageRoot, 'rihal/skills/actions'),
+    path.join(packageRoot, 'rcode/skills/agents'),
+    path.join(packageRoot, 'rcode/skills/actions'),
   ];
 
   let totalSkills = 0;
@@ -317,7 +334,7 @@ function runSchemaValidation(packageRoot) {
     }
   }
 
-  for (const file of findAgentFiles(path.join(packageRoot, 'rihal/agents'))) {
+  for (const file of findAgentFiles(path.join(packageRoot, 'rcode/agents'))) {
     totalAgents++;
     const { frontmatter } = parseFrontmatter(fs.readFileSync(file, 'utf8'));
     const result = validateAgentFrontmatter(frontmatter);
@@ -344,7 +361,7 @@ function runSchemaValidation(packageRoot) {
 // ---------- Duplicate-installation check ----------
 
 /**
- * Detect rcode/rihal-code installations across all known package managers.
+ * Detect rcode/rcode installations across all known package managers.
  * Multiple installs cause duplicate slash commands in Claude Code (#637-#644).
  * Returns { count, installs[], warnings[] }.
  */
@@ -377,7 +394,7 @@ function checkDuplicateInstalls() {
       const scopeDir = path.join(dir, scope);
       if (!fs.existsSync(scopeDir)) continue;
       for (const pkg of fs.readdirSync(scopeDir)) {
-        if (pkg === 'rcode' || pkg === 'rihal-code' || pkg.startsWith('rihal')) {
+        if (pkg === 'rcode' || pkg === 'rcode' || pkg.startsWith('rcode')) {
           let version = 'unknown';
           try {
             const pkgJson = JSON.parse(fs.readFileSync(path.join(scopeDir, pkg, 'package.json'), 'utf8'));
@@ -417,7 +434,7 @@ function printDuplicateChecks(result) {
 module.exports = function doctor(args, { packageRoot }) {
   const cwd = process.cwd();
 
-  console.log(`\n🕌 Rihal Code — Doctor\n`);
+  console.log(`\n🕌 rcode — Doctor\n`);
 
   console.log(`Preflight:`);
   const checks = runPreflight(cwd, packageRoot);

package/cli/generate-command-skills.cjs

@@ -3,9 +3,9 @@
  * Install-time generator: skill stubs that mirror slash commands.
  *
  * WHY: VS Code's Claude Code extension lists `.claude/skills/` in its
- * sidebar, but slash commands at `.claude/commands/rihal/` are only
+ * sidebar, but slash commands at `.claude/commands/rcode/` are only
  * reachable via the `/` autocomplete. Users expect to see lifecycle
- * commands like `rihal-do` in the sidebar — generating a thin skill
+ * commands like `rcode-do` in the sidebar — generating a thin skill
  * stub per command makes them browsable without duplicating real skills.
  *
  * This script creates ONE skill stub per slash command at install time,
@@ -37,14 +37,16 @@ const path = require('path');
  *
  * Everything else stays reachable via `/` autocomplete (claude-code reads
  * .claude/commands/ for slash dispatch — sidebar stubs are UX sugar, not
- * 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.
+ * functional). Power users running niche commands like /rcode-prfaq or
+ * /rcode-ui-phase still get them — they just don't show up in the sidebar.
  */
-// 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([]);
+// Minimal set — only the primary entry-point command that users expect to
+// find browsable in the sidebar. CC 2.x shows all .claude/commands/ in slash
+// autocomplete, so stubs are UX sugar only. Issue #710 required trimming
+// from 43 → 1 to avoid "491 descriptions dropped" budget exhaustion.
+const SIDEBAR_COMMANDS = new Set([
+  'do', // primary router — users pick workflows from the sidebar via /rcode-do
+]);
 
 function parseFrontmatter(text) {
   if (!text.startsWith('---\n')) return {};
@@ -63,20 +65,20 @@ function discoverRealSkills(packageRoot) {
   const out = new Set();
   const buckets = ['core', 'agents'];
   for (const bucket of buckets) {
-    const dir = path.join(packageRoot, 'rihal', 'skills', bucket);
+    const dir = path.join(packageRoot, 'rcode', 'skills', bucket);
     if (!fs.existsSync(dir)) continue;
     for (const entry of fs.readdirSync(dir)) {
-      if (entry.startsWith('rihal-')) out.add(entry);
+      if (entry.startsWith('rcode-')) out.add(entry);
     }
   }
   // actions are nested by phase
-  const actionsDir = path.join(packageRoot, 'rihal', 'skills', 'actions');
+  const actionsDir = path.join(packageRoot, 'rcode', 'skills', 'actions');
   if (fs.existsSync(actionsDir)) {
     for (const phase of fs.readdirSync(actionsDir)) {
       const phaseDir = path.join(actionsDir, phase);
       if (!fs.statSync(phaseDir).isDirectory()) continue;
       for (const entry of fs.readdirSync(phaseDir)) {
-        if (entry.startsWith('rihal-')) out.add(entry);
+        if (entry.startsWith('rcode-')) out.add(entry);
       }
     }
   }
@@ -84,24 +86,24 @@ function discoverRealSkills(packageRoot) {
 }
 
 function generateStub(cmdName, commandFm, version) {
-  const desc = commandFm.description || `Slash command shortcut for /rihal-${cmdName}.`;
+  const desc = commandFm.description || `Slash command shortcut for /rcode-${cmdName}.`;
   const triggers = [
-    `rihal ${cmdName}`,
-    `rihal-${cmdName}`,
-    `/rihal-${cmdName}`,
+    `rcode ${cmdName}`,
+    `rcode-${cmdName}`,
+    `/rcode-${cmdName}`,
   ];
 
   return `---
-name: rihal-${cmdName}
+name: rcode-${cmdName}
 description: >
   ${desc.replace(/\n/g, ' ')}
-  Sidebar entry — invokes the same workflow as /rihal-${cmdName}.
+  Sidebar entry — invokes the same workflow as /rcode-${cmdName}.
 triggers:
 ${triggers.map((t) => `  - "${t}"`).join('\n')}
 user-invocable: false
 generated: true
 generated-by: rcode-install-v${version}
-source: rihal/commands/${cmdName}.md
+source: rcode/commands/${cmdName}.md
 ---
 
 <!--
@@ -109,35 +111,35 @@ AUTO-GENERATED at install time by cli/generate-command-skills.cjs.
 Do NOT edit this file directly — your changes will be overwritten on the next
 install or update. To customise, create a sibling \`.local.md\` file (which
 is preserved across installs) or modify the source command at
-rihal/commands/${cmdName}.md.
+rcode/commands/${cmdName}.md.
 
-This stub exists so the slash command /rihal-${cmdName} appears in VS Code's
+This stub exists so the slash command /rcode-${cmdName} appears in VS Code's
 Claude Code sidebar (which lists skills only, not slash commands). The
-behaviour is identical to /rihal-${cmdName} — both invoke the workflow at
-.rihal/workflows/${cmdName}.md.
+behaviour is identical to /rcode-${cmdName} — both invoke the workflow at
+.rcode/workflows/${cmdName}.md.
 -->
 
 ## Overview
 
-Sidebar entry for the \`/rihal-${cmdName}\` slash command. Phrase-activated alternative invocation route.
+Sidebar entry for the \`/rcode-${cmdName}\` slash command. Phrase-activated alternative invocation route.
 
 ## Workflow
 
-Read and execute \`@.rihal/workflows/${cmdName}.md\` end-to-end. The behaviour is the same as invoking \`/rihal-${cmdName}\` directly.
+Read and execute \`@.rcode/workflows/${cmdName}.md\` end-to-end. The behaviour is the same as invoking \`/rcode-${cmdName}\` directly.
 
 ## Output Format
 
-Identical to \`/rihal-${cmdName}\`. See the workflow file for the canonical output spec.
+Identical to \`/rcode-${cmdName}\`. See the workflow file for the canonical output spec.
 
 ## Examples
 
-**Happy path** — say "rihal ${cmdName}" or "/rihal-${cmdName}" → workflow runs identically either way.
+**Happy path** — say "rcode ${cmdName}" or "/rcode-${cmdName}" → workflow runs identically either way.
 
-**Negative — looking for the canonical command file** — see \`rihal/commands/${cmdName}.md\` (the source of truth) and \`rihal/workflows/${cmdName}.md\` (the orchestration logic).
+**Negative — looking for the canonical command file** — see \`rcode/commands/${cmdName}.md\` (the source of truth) and \`rcode/workflows/${cmdName}.md\` (the orchestration logic).
 
 ## Memory Bank Hooks
 
-- **Reads:** whatever \`.rihal/workflows/${cmdName}.md\` reads
+- **Reads:** whatever \`.rcode/workflows/${cmdName}.md\` reads
 - **Writes:** whatever the workflow writes
 - This stub itself is read-only — it just dispatches to the workflow.
 `;
@@ -149,18 +151,18 @@ function main(packageRoot, targetSkillsDir, version, options = {}) {
   }
 
   const realSkills = discoverRealSkills(packageRoot);
-  const commandsDir = path.join(packageRoot, 'rihal', 'commands');
+  const commandsDir = path.join(packageRoot, 'rcode', 'commands');
   if (!fs.existsSync(commandsDir)) {
     console.warn(`[generate-command-skills] commands dir not found: ${commandsDir}`);
     return { generated: 0, skipped: 0, skippedGlobal: 0 };
   }
 
   // Issue #679: skip stubs whose name already exists in ~/.claude/skills/.
-  // Otherwise the slash picker shows the same /rihal-* twice.
+  // Otherwise the slash picker shows the same /rcode-* twice.
   const os = require('os');
   const globalSkillsDir = path.join(os.homedir(), '.claude', 'skills');
   const globalSkills = (options.skipGlobalDuplicates && fs.existsSync(globalSkillsDir))
-    ? new Set(fs.readdirSync(globalSkillsDir).filter(n => n.startsWith('rihal-')))
+    ? new Set(fs.readdirSync(globalSkillsDir).filter(n => n.startsWith('rcode-')))
     : new Set();
 
   let generated = 0;
@@ -173,7 +175,7 @@ function main(packageRoot, targetSkillsDir, version, options = {}) {
     const cmdName = file.replace(/\.md$/, '');
     if (!SIDEBAR_COMMANDS.has(cmdName)) { skipped++; continue; }
 
-    const skillName = `rihal-${cmdName}`;
+    const skillName = `rcode-${cmdName}`;
     if (realSkills.has(skillName)) {
       // A real skill with this name exists in the source tree — don't shadow it
       skipped++;
@@ -231,8 +233,8 @@ function main(packageRoot, targetSkillsDir, version, options = {}) {
   let cleaned = 0;
   try {
     for (const entry of fs.readdirSync(targetSkillsDir)) {
-      if (!entry.startsWith('rihal-')) continue;
-      const cmdName = entry.replace(/^rihal-/, '');
+      if (!entry.startsWith('rcode-')) continue;
+      const cmdName = entry.replace(/^rcode-/, '');
       if (SIDEBAR_COMMANDS.has(cmdName)) continue; // still wanted — leave it
       if (realSkills.has(entry)) continue;          // real skill — never touch
       const skillFile = path.join(targetSkillsDir, entry, 'SKILL.md');
@@ -240,7 +242,7 @@ function main(packageRoot, targetSkillsDir, version, options = {}) {
       const text = fs.readFileSync(skillFile, 'utf8');
       // Only remove stubs that were auto-generated from a command file.
       if (!/^generated:\s*true/m.test(text)) continue;
-      if (!/^source:\s*rihal\/commands\//m.test(text)) continue;
+      if (!/^source:\s*rcode\/commands\//m.test(text)) continue;
       fs.rmSync(path.join(targetSkillsDir, entry), { recursive: true, force: true });
       cleaned++;
     }

package/cli/github-sync.js

@@ -1,5 +1,5 @@
 /**
- * rihal-code github-sync — sync .rihal/ state to GitHub as issues
+ * rcode github-sync — sync .rcode/ state to GitHub as issues
  *
  * Creates milestones (phases), epics (issues), and stories (issues) with
  * proper parent-child linking via GitHub's native issue references.
@@ -7,8 +7,8 @@
  * Dry-run by default. Mutations always require --execute.
  *
  * Usage:
- *   rihal-code github-sync                 # dry-run preview
- *   rihal-code github-sync --execute       # actually create issues
+ *   rcode github-sync                 # dry-run preview
+ *   rcode github-sync --execute       # actually create issues
  *
  * Granular targeting (push specific items):
  *   --phase=phase-02          push one phase (all its epics + stories)
@@ -18,7 +18,7 @@
  *
  * Options:
  *   --repo=owner/name     target a specific repo (otherwise auto-detect)
- *   --with-labels         also create/ensure the Rihal label taxonomy
+ *   --with-labels         also create/ensure the rcode label taxonomy
  *   --project             also create a Project v2 board
  *   --yes                 skip the confirmation prompt (denied in yolo mode)
  *   --force-yolo          allow --yes to apply in yolo mode (explicit opt-in)
@@ -157,7 +157,7 @@ function extractFrontmatter(content) {
 }
 
 /**
- * Parse .rihal/phases/{phase}/sprints.md if present and return a map of
+ * Parse .rcode/phases/{phase}/sprints.md if present and return a map of
  * sprint-id → story-ids (based on "- [ ] story-X-Y" list entries under
  * each sprint section). Used by --sprint=ID filtering.
  *
@@ -185,18 +185,19 @@ function parseSprintsFile(sprintsContent) {
   return sprintMap;
 }
 
-// ---------- Discover .rihal/ content ----------
+// ---------- Discover .rcode/ content ----------
 
 function loadState(cwd) {
-  const statePath = path.join(cwd, '.rihal/state.json');
+  const statePath = path.join(cwd, '.rcode/state.json');
   if (!fs.existsSync(statePath)) {
     return null;
   }
-  return JSON.parse(fs.readFileSync(statePath, 'utf8'));
+  // on-disk state file written by users/CI — guard against corruption or partial writes
+  try { return JSON.parse(fs.readFileSync(statePath, 'utf8')); } catch { return null; }
 }
 
 function discoverPhases(cwd) {
-  const phasesDir = path.join(cwd, '.rihal/phases');
+  const phasesDir = path.join(cwd, '.rcode/phases');
   if (!fs.existsSync(phasesDir)) return [];
 
   const phases = [];
@@ -340,15 +341,20 @@ function extractTitle(markdown) {
 // ---------- Load/save sync map (for idempotency) ----------
 
 function loadSyncMap(cwd) {
-  const mapPath = path.join(cwd, '.rihal/integrations/github-map.json');
+  const mapPath = path.join(cwd, '.rcode/integrations/github-map.json');
   if (!fs.existsSync(mapPath)) {
     return { phases: {}, epics: {}, stories: {}, project: null, labels: [] };
   }
-  return JSON.parse(fs.readFileSync(mapPath, 'utf8'));
+  // on-disk sync map — guard against corruption so a bad write doesn't kill the sync run
+  try {
+    return JSON.parse(fs.readFileSync(mapPath, 'utf8'));
+  } catch {
+    return { phases: {}, epics: {}, stories: {}, project: null, labels: [] };
+  }
 }
 
 function saveSyncMap(cwd, map) {
-  const mapPath = path.join(cwd, '.rihal/integrations/github-map.json');
+  const mapPath = path.join(cwd, '.rcode/integrations/github-map.json');
   // Atomic: partial writes on Ctrl+C would desync our local↔remote mapping
   // and orphan issues. writeJsonAtomic ensures the file is either old or new.
   writeJsonAtomic(mapPath, map);
@@ -409,7 +415,7 @@ async function main(args) {
   const config = loadConfig(cwd);
   const communicationMode = config.communication_mode || 'guided';
 
-  console.log(`\n🕌 Rihal Code — GitHub Sync`);
+  console.log(`\n🕌 rcode — GitHub Sync`);
   console.log(`   Mode:          ${opts.dryRun ? 'DRY-RUN (preview only, nothing is sent)' : 'EXECUTE'}`);
   console.log(`   Comms mode:    ${communicationMode}`);
   console.log(`   Scope:         ${opts.only || 'full (create + update existing)'}`);
@@ -443,10 +449,10 @@ async function main(args) {
   }
   console.log(`   ✓ Target repo: ${repo}`);
 
-  // ------ Precondition: .rihal/ exists ------
+  // ------ Precondition: .rcode/ exists ------
   const state = loadState(cwd);
   if (!state) {
-    console.error(`❌ No .rihal/state.json found. Run 'rcode install' first.`);
+    console.error(`❌ No .rcode/state.json found. Run 'rcode install' first.`);
     process.exit(1);
   }
   console.log(`   ✓ Project: ${state.project_name || '(unnamed)'}`);
@@ -475,8 +481,9 @@ async function main(args) {
       console.error(`   Check the filter value or run without filters to see available ids.`);
       process.exit(1);
     }
-    console.error(`❌ No phases found in .rihal/phases/.`);
-    process.exit(1);
+    console.log(`ℹ  No phases found in .rcode/phases/ — nothing to sync.`);
+    console.log(`   Run 'rcode init' or create a phase to get started.`);
+    process.exit(0);
   }
 
   console.log(`   ✓ Phases found: ${phases.length}`);
@@ -506,7 +513,7 @@ async function main(args) {
   // The plan diffs local state against what we know was synced before.
   // If updateEnabled is false, the update list stays empty (create-only mode).
   //
-  // Label taxonomy follows the Rihal GitHub Standards (4 categories:
+  // Label taxonomy follows the rcode GitHub Standards (4 categories:
   // Type / Priority / Status / Area). It is NOT created or assigned by
   // default — pass --with-labels to opt in. Without the flag, we focus
   // on clean issue creation with proper parent-child linking and leave
@@ -659,7 +666,7 @@ async function main(args) {
   if (!opts.only || opts.only === 'milestones') {
     console.log(`\n🎯 Milestones (phases)`);
     for (const phase of plan.milestones) {
-      const desc = phase.brief ? phase.brief.split('\n').slice(0, 5).join('\n') : 'Rihal Code phase';
+      const desc = phase.brief ? phase.brief.split('\n').slice(0, 5).join('\n') : 'rcode phase';
       const result = gh.createMilestone(phase.id, desc, null, syncOpts);
       results.milestones.push({ phase: phase.id, ...result });
       if (result.error) {
@@ -695,8 +702,8 @@ async function main(args) {
         `## 📊 Meta`,
         ``,
         `- **Phase:** \`${epic.phase}\``,
-        `- **Source:** \`.rihal/phases/${epic.phase}/tasks/${epic.file}\``,
-        `- **Synced by:** Rihal Code github-sync`,
+        `- **Source:** \`.rcode/phases/${epic.phase}/tasks/${epic.file}\``,
+        `- **Synced by:** rcode github-sync`,
         ``,
         `## 📝 Child Stories`,
         ``,
@@ -778,8 +785,8 @@ async function main(args) {
         parentRefLine,
         sprintRefLine,
         `- **Phase:** \`${story.phase}\``,
-        `- **Source:** \`.rihal/phases/${story.phase}/stories/${story.file}\``,
-        `- **Synced by:** Rihal Code github-sync`,
+        `- **Source:** \`.rcode/phases/${story.phase}/stories/${story.file}\``,
+        `- **Synced by:** rcode github-sync`,
         ``,
         `> **Linking:** Reference this story in commits with \`refs #${'{issue}'}\``,
         `> or close it via PR with \`Closes #${'{issue}'}\`.`,
@@ -885,7 +892,7 @@ async function main(args) {
       const body = [
         `## 🎯 Epic Vision`,
         ``,
-        `_Strategic goal this Epic contributes to. Fill in from \`.rihal/phases/${epic.phase}/tasks/${epic.file}\`._`,
+        `_Strategic goal this Epic contributes to. Fill in from \`.rcode/phases/${epic.phase}/tasks/${epic.file}\`._`,
         ``,
         `## 📋 Source Content`,
         ``,
@@ -896,7 +903,7 @@ async function main(args) {
         `## 📊 Meta`,
         ``,
         `- **Phase:** \`${epic.phase}\``,
-        `- **Source:** \`.rihal/phases/${epic.phase}/tasks/${epic.file}\``,
+        `- **Source:** \`.rcode/phases/${epic.phase}/tasks/${epic.file}\``,
         `- **Last synced:** ${new Date().toISOString()}`,
       ].join('\n');
 
@@ -930,7 +937,7 @@ async function main(args) {
       const body = [
         `## 🎯 Problem Statement`,
         ``,
-        `_From \`.rihal/phases/${story.phase}/stories/${story.file}\`._`,
+        `_From \`.rcode/phases/${story.phase}/stories/${story.file}\`._`,
         ``,
         `## 📋 Source Content`,
         ``,
@@ -941,7 +948,7 @@ async function main(args) {
         `## 📊 Meta`,
         ``,
         `- **Phase:** \`${story.phase}\``,
-        `- **Source:** \`.rihal/phases/${story.phase}/stories/${story.file}\``,
+        `- **Source:** \`.rcode/phases/${story.phase}/stories/${story.file}\``,
         `- **Last synced:** ${new Date().toISOString()}`,
       ].join('\n');
 
@@ -980,7 +987,7 @@ async function main(args) {
   // ------ Save sync map (only if we executed) ------
   if (opts.execute) {
     saveSyncMap(cwd, syncMap);
-    console.log(`\n💾 Sync map saved to .rihal/integrations/github-map.json`);
+    console.log(`\n💾 Sync map saved to .rcode/integrations/github-map.json`);
   }
 
   // ------ Summary ------

package/cli/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 /**
- * Rihal Code CLI
+ * rcode CLI
  *
  * Usage:
- *   npx @hanzlaa/rcode init          → scaffold .rihal/ in current project
+ *   npx @hanzlaa/rcode init          → scaffold .rcode/ in current project
  *   npx @hanzlaa/rcode dashboard     → start the Diwan view-only dashboard
  *   npx @hanzlaa/rcode serve         → alias for dashboard
  *   npx @hanzlaa/rcode digest        → print compact agent digests
@@ -46,27 +46,27 @@ const COMMANDS = {
 
 function printHelp() {
   console.log(`
-🕌 Rihal Code v${PACKAGE_JSON.version}
-    Context-aware AI team methodology. See tiers: \`rihal-code tiers\`
+🕌 rcode v${PACKAGE_JSON.version}
+    Context-aware AI team methodology. See tiers: \`rcode tiers\`
 
 Usage:
   rcode <command>
 
 📦 PROJECT
-  install        Install Rihal Code into the current project
-                 (sets up .rihal/, .claude/skills/, .claude/commands/,
+  install        Install rcode into the current project
+                 (sets up .rcode/, .claude/skills/, .claude/commands/,
                  .cursor/rules/, .windsurf/rules/, .antigravity/agents/, AGENTS.md)
   init           Alias for install
-  update         Refresh skill files (backs up .rihal/ state first)
-  uninstall      Remove Rihal Code from the current project
+  update         Refresh skill files (backs up .rcode/ state first)
+  uninstall      Remove rcode from the current project
   remove         Alias for uninstall
-  nuke           Wipe ALL rihal/rcode installs everywhere (global packages,
-                 binaries, ~/.claude/* rihal artifacts, ~/.rihal/, project artifacts)
+  nuke           Wipe ALL rcode/rcode installs everywhere (global packages,
+                 binaries, ~/.claude/* rcode artifacts, ~/.rcode/, project artifacts)
                  Default = dry-run. Pass --yes to remove. Pass --include-planning
                  to also remove .planning/ in CWD.
   config         Get/set project configuration (project_name, user_name, etc.)
   context        Memory bank freshness (--check | --refresh | --install-hook)
-  github-sync    Sync .rihal/ phases/epics/stories to GitHub (dry-run default)
+  github-sync    Sync .rcode/ phases/epics/stories to GitHub (dry-run default)
 
 👥 TEAM
   team           List the team roster
@@ -100,28 +100,28 @@ Documentation: https://github.com/hanzlahabib/rihal-code
  * who run `npm install -g @hanzlaa/rcode` see only "added 1 package" with no
  * confirmation that 100+ commands and skills were installed. We detect a fresh
  * install on the first `rcode <anything>` invocation by checking for a marker
- * file under ~/.rihal/, print a one-time welcome banner, then drop the marker.
+ * file under ~/.rcode/, print a one-time welcome banner, then drop the marker.
  */
 function maybeShowFirstRunBanner() {
   const os = require('os');
   const home = os.homedir();
-  const markerDir = path.join(home, '.rihal');
+  const markerDir = path.join(home, '.rcode');
   const marker = path.join(markerDir, '.welcome-shown');
   if (fs.existsSync(marker)) return;
 
   // Only show banner if global install actually ran — i.e. ~/.claude/commands/
-  // has rihal-*.md files. Otherwise this is a developer running from source.
+  // has rcode-*.md files. Otherwise this is a developer running from source.
   const globalCommands = path.join(home, '.claude', 'commands');
-  let hasGlobalRihal = false;
+  let hasGlobalrcode = false;
   try {
-    hasGlobalRihal = fs.existsSync(globalCommands) &&
-      fs.readdirSync(globalCommands).some(f => f.startsWith('rihal-') && f.endsWith('.md'));
+    hasGlobalrcode = fs.existsSync(globalCommands) &&
+      fs.readdirSync(globalCommands).some(f => f.startsWith('rcode-') && f.endsWith('.md'));
   } catch { /* unreadable */ }
-  if (!hasGlobalRihal) return;
+  if (!hasGlobalrcode) return;
 
-  console.log(`\n🕌 Rihal Code v${PACKAGE_JSON.version} — first run detected.\n`);
-  console.log(`   ✓ ${countGlobalRihal(globalCommands)} slash commands installed → ~/.claude/commands/`);
-  console.log(`   ✓ All /rihal-* commands available in every Claude Code project.`);
+  console.log(`\n🕌 rcode v${PACKAGE_JSON.version} — first run detected.\n`);
+  console.log(`   ✓ ${countGlobalRcode(globalCommands)} slash commands installed → ~/.claude/commands/`);
+  console.log(`   ✓ All /rcode-* commands available in every Claude Code project.`);
   console.log(`\n   To set up a project:  cd my-project && rcode install`);
   console.log(`   Show all commands:    rcode help`);
   console.log(`   Diagnose issues:      rcode doctor\n`);
@@ -132,9 +132,9 @@ function maybeShowFirstRunBanner() {
   } catch { /* if we can't write the marker, banner shows again next time — annoying but not broken */ }
 }
 
-function countGlobalRihal(dir) {
+function countGlobalRcode(dir) {
   try {
-    return fs.readdirSync(dir).filter(f => f.startsWith('rihal-') && f.endsWith('.md')).length;
+    return fs.readdirSync(dir).filter(f => f.startsWith('rcode-') && f.endsWith('.md')).length;
   } catch { return 0; }
 }