@hanzlaa/rcode 3.6.16 → 4.0.0

package/cli/lib/config.cjs

@@ -1,10 +1,10 @@
 /**
- * Rihal Code configuration loader with 3-level cascade.
+ * rcode configuration loader with 3-level cascade.
  *
  * Priority (lowest to highest — higher overrides lower):
  *   1. Hardcoded defaults baked into this file
- *   2. User-level defaults at ~/.rihal-code/defaults.json
- *   3. Project-level config at {cwd}/.rihal/config.json
+ *   2. User-level defaults at ~/.rcode/defaults.json
+ *   3. Project-level config at {cwd}/.rcode/config.json
  *
  * All get/set operations go through this module so validation, typo
  * suggestions, and atomic writes happen in one place.
@@ -46,9 +46,9 @@ const HARDCODED_DEFAULTS = {
   document_output_language: 'English',
 
   // Paths
-  output_folder: '.rihal',
-  planning_artifacts: '.rihal/phases',
-  project_knowledge: '.rihal/context',
+  output_folder: '.rcode',
+  planning_artifacts: '.rcode/phases',
+  project_knowledge: '.rcode/context',
 
   // Model profile — matches model-profiles.json names
   model_profile: 'balanced',
@@ -102,15 +102,15 @@ const VALID_COMMUNICATION_MODES = new Set(['guided', 'yolo']);
 // ---------- Paths ----------
 
 function userLevelPath() {
-  return path.join(os.homedir(), '.rihal-code', 'defaults.json');
+  return path.join(os.homedir(), '.rcode', 'defaults.json');
 }
 
 function projectLevelPath(cwd) {
-  return path.join(cwd, '.rihal', 'config.json');
+  return path.join(cwd, '.rcode', 'config.json');
 }
 
 function projectYamlPath(cwd) {
-  return path.join(cwd, '.rihal', 'config.yaml');
+  return path.join(cwd, '.rcode', 'config.yaml');
 }
 
 // ---------- Loaders ----------

package/cli/lib/fsutil.cjs

@@ -1,7 +1,7 @@
 /**
- * Filesystem utilities for the Rihal Code CLI.
+ * Filesystem utilities for the rcode CLI.
  *
- * Currently provides atomic writes so state files (.rihal/state.json,
+ * Currently provides atomic writes so state files (.rcode/state.json,
  * github-map.json, model-profiles.json, AGENTS.md) can't be truncated by
  * a Ctrl+C mid-write. Pattern: write to a sibling temp file, fsync, then
  * rename over the target. On POSIX, rename within a filesystem is atomic,
@@ -89,7 +89,7 @@ function writeJsonAtomic(filePath, obj, opts = {}) {
  *
  * Symlinks INSIDE the directory are still followed by Node's rmSync — that
  * is unavoidable with the recursive flag. The threat model addressed here
- * is a single top-level symlink swap (e.g. `.rihal -> /`), not deep nested
+ * is a single top-level symlink swap (e.g. `.rcode -> /`), not deep nested
  * symlinks. Defense in depth, not a sandbox.
  *
  * @param {string} targetPath path to remove

package/cli/lib/github.cjs

@@ -1,5 +1,5 @@
 /**
- * GitHub CLI wrapper library for Rihal Code.
+ * GitHub CLI wrapper library for rcode.
  *
  * Uses the `gh` CLI exclusively. Never calls the GitHub API directly (keeps auth
  * in the user's existing `gh` session, respects GH_TOKEN, and works with SSO).
@@ -90,7 +90,8 @@ function ensureLabel(name, color, description, { execute = false, dryRun = true
   // Check if label exists
   const check = runGh(['label', 'list', '--search', name, '--json', 'name'], { allowFailure: true });
   if (check.status === 0) {
-    const labels = JSON.parse(check.stdout || '[]');
+    // external gh CLI output — guard against malformed JSON crashing the process
+    let labels; try { labels = JSON.parse(check.stdout || '[]'); } catch { labels = []; }
     if (labels.some((l) => l.name === name)) {
       return { existed: true, name };
     }
@@ -131,7 +132,8 @@ function createMilestone(title, description, dueDate, { execute = false, dryRun
   if (result.status !== 0) {
     return { error: result.stderr };
   }
-  const data = JSON.parse(result.stdout);
+  // external gh API response — guard against malformed JSON crashing the process
+  let data; try { data = JSON.parse(result.stdout); } catch { return { error: 'failed to parse milestone response' }; }
   return { created: true, number: data.number, id: data.id, title: data.title, url: data.html_url };
 }
 
@@ -148,7 +150,8 @@ function getIssue(number, { repo = null } = {}) {
   if (result.status !== 0) {
     return { error: result.stderr };
   }
-  return JSON.parse(result.stdout);
+  // external gh API response — guard against malformed JSON crashing the process
+  try { return JSON.parse(result.stdout); } catch { return { error: 'failed to parse issue response' }; }
 }
 
 function createIssue(
@@ -318,7 +321,8 @@ function createProject(owner, title, { execute = false, dryRun = true } = {}) {
   if (result.status !== 0) {
     return { error: result.stderr };
   }
-  return JSON.parse(result.stdout);
+  // external gh CLI output — guard against malformed JSON crashing the process
+  try { return JSON.parse(result.stdout); } catch { return { error: 'failed to parse project response' }; }
 }
 
 function addIssueToProject(projectNumber, owner, issueUrl, { execute = false, dryRun = true } = {}) {
@@ -340,7 +344,8 @@ function addIssueToProject(projectNumber, owner, issueUrl, { execute = false, dr
   if (result.status !== 0) {
     return { error: result.stderr };
   }
-  return JSON.parse(result.stdout);
+  // external gh CLI output — guard against malformed JSON crashing the process
+  try { return JSON.parse(result.stdout); } catch { return { error: 'failed to parse project item response' }; }
 }
 
 // ---------- Rate limit awareness ----------

package/cli/lib/manifest.cjs

@@ -19,28 +19,28 @@ const path = require('path');
  * Read the expected skill set from the package source.
  * Returns { agents: Set<string>, actions: Set<string> }.
  *
- * `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
+ * `agents` are the bare names (no rcode- prefix, no .md) of the agent files
+ *   under rcode/agents/*.md — these are what install ships to
+ *   .claude/agents/rcode-<name>.md, .cursor/rules/rcode/agents/, etc.
+ *   NOT the phrase-activated agent skills under rcode/skills/agents/.
+ * `actions` are the skill dir names under rcode/skills/actions/, plus the
+ *   nested rcode/skills/actions/research/ children (flattened — matches how
  *   installSkills() copies them).
  */
 function readPackageManifest(packageRoot) {
-  const skillsRoot = path.join(packageRoot, 'rihal/skills');
+  const skillsRoot = path.join(packageRoot, 'rcode/skills');
   const manifest = { agents: new Set(), actions: new Set() };
 
-  // Issue #783 — agents are file-based (rihal/agents/*.md), not the skill
-  // directories under rihal/skills/agents/. The installer ships rihal/agents/
+  // Issue #783 — agents are file-based (rcode/agents/*.md), not the skill
+  // directories under rcode/skills/agents/. The installer ships rcode/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');
+  const agentsDir = path.join(packageRoot, 'rcode/agents');
   if (fs.existsSync(agentsDir)) {
     for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
       if (!entry.isFile()) continue;
-      if (!entry.name.startsWith('rihal-') || !entry.name.endsWith('.md')) continue;
-      manifest.agents.add(entry.name.replace(/^rihal-/, '').replace(/\.md$/, ''));
+      if (!entry.name.startsWith('rcode-') || !entry.name.endsWith('.md')) continue;
+      manifest.agents.add(entry.name.replace(/^rcode-/, '').replace(/\.md$/, ''));
     }
   }
 
@@ -54,10 +54,10 @@ function readPackageManifest(packageRoot) {
       const full = path.join(dir, entry.name);
       if (fs.existsSync(path.join(full, 'SKILL.md'))) {
         // Use the name as it lands in .claude/skills/ (installSkills prefixes
-        // non-rihal- dirs with 'rihal-', but all current skills already have it)
-        const installedName = entry.name.startsWith('rihal-')
+        // non-rcode- dirs with 'rcode-', but all current skills already have it)
+        const installedName = entry.name.startsWith('rcode-')
           ? entry.name
-          : `rihal-${entry.name}`;
+          : `rcode-${entry.name}`;
         manifest.actions.add(installedName);
       } else {
         walkActions(full);
@@ -109,10 +109,10 @@ function diffSet(editor, kind, expected, installed) {
 }
 
 /**
- * Verify a Claude install. Agents live at .claude/agents/rihal-<name>.md.
- * Action skills live at .claude/skills/<name>/ (bare name, no rihal- prefix).
+ * Verify a Claude install. Agents live at .claude/agents/rcode-<name>.md.
+ * Action skills live at .claude/skills/<name>/ (bare name, no rcode- prefix).
  *
- * Note: .claude/skills/ ALSO contains rihal-<name>/ directories that are
+ * Note: .claude/skills/ ALSO contains rcode-<name>/ directories that are
  * auto-generated command stubs by generate-command-skills.cjs (so commands
  * appear in the IDE sidebar). Those are NOT agents — counting them as agents
  * makes doctor report drift like "agents 119/23" when nothing is wrong.
@@ -128,19 +128,19 @@ function verifyClaudeInstall(cwd, packageRoot, options = {}) {
   const agentsDir = path.join(cwd, '.claude/agents');
   const skillsDir = path.join(cwd, '.claude/skills');
 
-  // Agents: .claude/agents/rihal-<name>.md (file-based, not dir-based).
+  // Agents: .claude/agents/rcode-<name>.md (file-based, not dir-based).
   const installedAgents = new Set();
   if (fs.existsSync(agentsDir)) {
     for (const f of fs.readdirSync(agentsDir)) {
-      if (f.startsWith('rihal-') && f.endsWith('.md')) {
-        installedAgents.add(f.replace(/^rihal-/, '').replace(/\.md$/, ''));
+      if (f.startsWith('rcode-') && f.endsWith('.md')) {
+        installedAgents.add(f.replace(/^rcode-/, '').replace(/\.md$/, ''));
       }
     }
   }
 
   // Issue #664 — global precedence fallback.
   // The installer (cli/install.js ~line 1773) intentionally removes project-
-  // level .claude/agents/rihal-*.md when the user's ~/.claude/ already has
+  // level .claude/agents/rcode-*.md when the user's ~/.claude/ already has
   // them, to avoid duplicate commands. Without this fallback the verifier
   // reports 0 agents on every successful install in that scenario.
   if (installedAgents.size === 0 && globalFallback) {
@@ -149,18 +149,18 @@ function verifyClaudeInstall(cwd, packageRoot, options = {}) {
       const globalAgentsDir = path.join(os.homedir(), '.claude/agents');
       if (fs.existsSync(globalAgentsDir)) {
         for (const f of fs.readdirSync(globalAgentsDir)) {
-          if (f.startsWith('rihal-') && f.endsWith('.md')) {
-            installedAgents.add(f.replace(/^rihal-/, '').replace(/\.md$/, ''));
+          if (f.startsWith('rcode-') && f.endsWith('.md')) {
+            installedAgents.add(f.replace(/^rcode-/, '').replace(/\.md$/, ''));
           }
         }
       }
     } catch { /* non-fatal — permission errors etc. */ }
   }
 
-  // Actions: .claude/skills/rihal-<name>/. installSkills (cli/install.js)
-  // prefixes every action with rihal-, and readPackageManifest does the
+  // Actions: .claude/skills/rcode-<name>/. installSkills (cli/install.js)
+  // prefixes every action with rcode-, and readPackageManifest does the
   // same — so both sides are normalized. The previous version filtered OUT
-  // rihal-* dirs which excluded ALL real actions and made the diff always
+  // rcode-* dirs which excluded ALL real actions and made the diff always
   // report "everything missing." Compare directly against the prefixed set.
   const allInstalled = readInstalledDirs(skillsDir);
   let actionsInstalled = new Set([...allInstalled].filter((n) => pkg.actions.has(n)));
@@ -187,23 +187,23 @@ function verifyClaudeInstall(cwd, packageRoot, options = {}) {
 
 /**
  * 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)
+ * .mdc agent rule per rcode/agents/*.md into the NESTED directory
+ *   .cursor/rules/rcode/agents/rcode-<name>.mdc   (cursor)
+ *   .windsurf/rules/rcode/agents/rcode-<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 base = editor === 'cursor' ? '.cursor/rules' : '.windsurf/rules';
-  const agentsDir = path.join(cwd, base, 'rihal', 'agents');
+  const agentsDir = path.join(cwd, base, 'rcode', 'agents');
 
   const installed = new Set();
   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$/, ''));
+      if (!entry.name.startsWith('rcode-') || !entry.name.endsWith('.mdc')) continue;
+      installed.add(entry.name.replace(/^rcode-/, '').replace(/\.mdc$/, ''));
     }
   }
 
@@ -212,18 +212,18 @@ function verifyRulesInstall(editor, cwd, packageRoot) {
 
 /**
  * Verify an Antigravity install. Issue #783: the installer ships agent files
- * to the NESTED .antigravity/rihal/agents/rihal-<name>.md — not
+ * to the NESTED .antigravity/rcode/agents/rcode-<name>.md — not
  * .antigravity/agents/. Compare against the package agent set.
  */
 function verifyAntigravityInstall(cwd, packageRoot) {
   const pkg = readPackageManifest(packageRoot);
-  const agentsDir = path.join(cwd, '.antigravity/rihal/agents');
+  const agentsDir = path.join(cwd, '.antigravity/rcode/agents');
   const installed = new Set();
   if (fs.existsSync(agentsDir)) {
     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$/, ''));
+      if (!entry.name.startsWith('rcode-') || !entry.name.endsWith('.md')) continue;
+      installed.add(entry.name.replace(/^rcode-/, '').replace(/\.md$/, ''));
     }
   }
 

package/cli/lib/memory-bank.cjs

@@ -1,18 +1,18 @@
 /**
  * Memory bank freshness detection.
  *
- * The .rihal/context/ directory is the project's "memory bank" — a lean
- * brief and a fuller project-brief that every Rihal workflow reads at
+ * The .rcode/context/ directory is the project's "memory bank" — a lean
+ * brief and a fuller project-brief that every rcode workflow reads at
  * runtime. If these files go stale (code changed, deps updated, new
  * directories appeared), every agent gets outdated context and their
  * answers degrade silently.
  *
  * This module detects staleness programmatically by comparing a project
  * fingerprint (git HEAD, package manifest hash, top-level structure hash)
- * against one stored in .rihal/state.json at the last /rihal-init run.
+ * against one stored in .rcode/state.json at the last /rcode-init run.
  *
  * It is intentionally READ-ONLY + write-fingerprint. The actual scan and
- * rewrite of the memory bank is done by Claude when /rihal-init runs —
+ * rewrite of the memory bank is done by Claude when /rcode-init runs —
  * this library only tells callers WHEN to refresh, not HOW.
  */
 
@@ -72,7 +72,8 @@ function hashFileIfExists(filePath) {
   try {
     const buf = fs.readFileSync(filePath);
     return sha256(buf);
-  } catch {
+  } catch (err) {
+    console.error('[memory-bank] hashFileIfExists: failed to read', filePath + ':', err?.message || err);
     return null;
   }
 }
@@ -107,7 +108,8 @@ function structureFingerprint(cwd) {
       dirs: entries,
       hash: sha256(entries.join('|')),
     };
-  } catch {
+  } catch (err) {
+    console.error('[memory-bank] structureFingerprint: failed to read directory:', err?.message || err);
     return { dirs: [], hash: null };
   }
 }
@@ -124,7 +126,8 @@ function gitFingerprint(cwd) {
       head: sha.stdout.trim(),
       branch: branch.status === 0 ? branch.stdout.trim() : null,
     };
-  } catch {
+  } catch (err) {
+    console.error('[memory-bank] gitFingerprint: git command failed:', err?.message || err);
     return null;
   }
 }
@@ -143,7 +146,8 @@ function commitsBetween(cwd, from, to) {
     );
     if (result.status !== 0) return null;
     return parseInt(result.stdout.trim(), 10);
-  } catch {
+  } catch (err) {
+    console.error('[memory-bank] commitsBetween: git rev-list failed:', err?.message || err);
     return null;
   }
 }
@@ -171,7 +175,7 @@ function computeFingerprint(cwd) {
 // ---------- State.json I/O ----------
 
 function stateFilePath(cwd) {
-  return path.join(cwd, '.rihal', 'state.json');
+  return path.join(cwd, '.rcode', 'state.json');
 }
 
 function readState(cwd) {
@@ -179,14 +183,15 @@ function readState(cwd) {
   if (!fs.existsSync(p)) return null;
   try {
     return JSON.parse(fs.readFileSync(p, 'utf8'));
-  } catch {
+  } catch (err) {
+    console.error('[memory-bank] readState: failed to parse state.json at', p + ':', err?.message || err);
     return null;
   }
 }
 
 /**
- * Persist the init fingerprint into .rihal/state.json under `memory_bank`.
- * Called by /rihal-init (via rihal-code context --refresh) after a scan
+ * Persist the init fingerprint into .rcode/state.json under `memory_bank`.
+ * Called by /rcode-init (via rcode context --refresh) after a scan
  * rewrites context/active.md + context/project-brief.md.
  */
 function writeFingerprint(cwd) {
@@ -227,8 +232,8 @@ function checkStaleness(cwd) {
   const current = computeFingerprint(cwd);
   const stored = readFingerprint(cwd);
 
-  const activePath = path.join(cwd, '.rihal/context/active.md');
-  const briefPath = path.join(cwd, '.rihal/context/project-brief.md');
+  const activePath = path.join(cwd, '.rcode/context/active.md');
+  const briefPath = path.join(cwd, '.rcode/context/project-brief.md');
   const context_files = {
     active: fs.existsSync(activePath),
     brief: fs.existsSync(briefPath),
@@ -238,7 +243,7 @@ function checkStaleness(cwd) {
   if (!context_files.active && !context_files.brief) {
     return {
       status: 'never',
-      reasons: ['memory bank has never been initialized — run /rihal-init'],
+      reasons: ['memory bank has never been initialized — run /rcode-init'],
       current,
       stored,
       context_files,
@@ -248,8 +253,8 @@ function checkStaleness(cwd) {
   // Partially-present: one file exists but not the other.
   if (!context_files.active || !context_files.brief) {
     const missing = [];
-    if (!context_files.active) missing.push('.rihal/context/active.md');
-    if (!context_files.brief) missing.push('.rihal/context/project-brief.md');
+    if (!context_files.active) missing.push('.rcode/context/active.md');
+    if (!context_files.brief) missing.push('.rcode/context/project-brief.md');
     return {
       status: 'stale',
       reasons: [`incomplete memory bank — missing: ${missing.join(', ')}`],
@@ -264,7 +269,7 @@ function checkStaleness(cwd) {
   if (!stored) {
     return {
       status: 'stale',
-      reasons: ['run /rihal-init in your editor to populate project context'],
+      reasons: ['run /rcode-init in your editor to populate project context'],
       current,
       stored,
       context_files,

package/cli/lib/model-profiles.cjs

@@ -1,8 +1,8 @@
 /**
- * Rihal Code — Model Profile Resolution Library
+ * rcode — Model Profile Resolution Library
  *
  * Reads model profiles from
- * rihal/config/model-profiles.json and resolves the right model for
+ * rcode/config/model-profiles.json and resolves the right model for
  * each agent at dispatch time.
  *
  * Usage:
@@ -28,7 +28,7 @@ function findPackageRoot(dir) {
   throw new Error('Could not find package root');
 }
 const PACKAGE_ROOT = findPackageRoot(__dirname);
-const PROFILES_PATH = path.join(PACKAGE_ROOT, 'rihal/config/model-profiles.json');
+const PROFILES_PATH = path.join(PACKAGE_ROOT, 'rcode/config/model-profiles.json');
 
 let _cached = null;
 
@@ -94,7 +94,7 @@ function resolveModelForAgent(agent, opts = {}) {
   const value = profile.agents[agent];
   if (!value) {
     throw new Error(
-      `Agent '${agent}' not mapped in profile '${profileName}'. Check rihal/config/model-profiles.json.`,
+      `Agent '${agent}' not mapped in profile '${profileName}'. Check rcode/config/model-profiles.json.`,
     );
   }
 
@@ -144,11 +144,11 @@ function formatMapAsTable(map) {
 }
 
 /**
- * Read the project's current profile from .rihal/config.json (if present).
+ * Read the project's current profile from .rcode/config.json (if present).
  * Falls back to the default profile from the package config.
  */
 function getProjectProfile(projectDir = process.cwd()) {
-  const projectConfigPath = path.join(projectDir, '.rihal', 'config.json');
+  const projectConfigPath = path.join(projectDir, '.rcode', 'config.json');
   if (fs.existsSync(projectConfigPath)) {
     try {
       const cfg = JSON.parse(fs.readFileSync(projectConfigPath, 'utf8'));
@@ -157,7 +157,7 @@ function getProjectProfile(projectDir = process.cwd()) {
         overrides: cfg.model_overrides || {},
       };
     } catch (e) {
-      console.warn(`Warning: .rihal/config.json is invalid JSON. Using defaults.`);
+      console.warn(`Warning: .rcode/config.json is invalid JSON. Using defaults.`);
     }
   }
   return { profile: getDefaultProfile(), overrides: {} };

package/cli/lib/prompts.cjs

@@ -1,5 +1,5 @@
 /**
- * Zero-dep interactive prompt helpers for the Rihal Code CLI.
+ * Zero-dep interactive prompt helpers for the rcode CLI.
  *
  * Why this exists:
  *   Hand-rolled readline.question() crashes or silently aborts when a user
@@ -91,7 +91,7 @@ function openSession() {
   //    ourselves, readline's internal cursor tracking walks past the
   //    prompt on backspace and erases it — that was the bug in #16.
   //
-  // 2. Piped mode (CI, test harness, rihal-code install | tee ...) —
+  // 2. Piped mode (CI, test harness, rcode install | tee ...) —
   //    rl.question() has a quirk where the second call in a sequence
   //    can miss the next buffered line. The line-event queue pattern
   //    below avoids it: we listen for `line` events ourselves and

package/cli/lib/schemas.cjs

@@ -1,7 +1,7 @@
 /**
- * Schema validators for rihal-code's own artifacts.
+ * Schema validators for rcode's own artifacts.
  *
- * Validates SKILL.md frontmatter, agent frontmatter, and `.rihal/state.json`
+ * Validates SKILL.md frontmatter, agent frontmatter, and `.rcode/state.json`
  * against zod schemas — mirroring the zod usage style in `cli/lib/config.cjs`.
  *
  * Why: today malformed SKILL.md / agent frontmatter is only caught by brittle
@@ -22,8 +22,8 @@ const { z } = require('zod');
 /**
  * Extract YAML frontmatter from a markdown document.
  *
- * Handles three value shapes seen in rihal artifacts:
- *   - plain scalars:        `name: rihal-foo`
+ * Handles three value shapes seen in rcode artifacts:
+ *   - plain scalars:        `name: rcode-foo`
  *   - folded multiline:     `description: >` followed by indented lines
  *   - block sequences:      `triggers:` followed by `  - "phrase"` lines
  *
@@ -228,15 +228,15 @@ const agentFrontmatterSchema = z.object({
   name: z
     .string()
     .min(1, 'name is required')
-    .refine((v) => v.startsWith('rihal-'), 'name must start with the "rihal-" prefix'),
+    .refine((v) => v.startsWith('rcode-'), 'name must start with the "rcode-" prefix'),
   description: z.string().min(1, 'description is required'),
   color: z.string().min(1, 'color is required'),
 });
 
 /**
- * Validate a parsed agent (`rihal/agents/*.md`) frontmatter object.
+ * Validate a parsed agent (`rcode/agents/*.md`) frontmatter object.
  *
- * Requires `name` (rihal- prefixed), `description`, `tools` (comma-list or
+ * Requires `name` (rcode- prefixed), `description`, `tools` (comma-list or
  * array), and `color`.
  *
  * @param {object} obj parsed frontmatter
@@ -269,8 +269,8 @@ function validateAgentFrontmatter(obj) {
 
 // ---------- state.json ----------
 
-// NOTE: keep this schema coordinated with `.rihal/references/state-schema.md`
-// and the canonical shape written by rihal-tools.cjs — see issue #735
+// NOTE: keep this schema coordinated with `.rcode/references/state-schema.md`
+// and the canonical shape written by rcode-tools.cjs — see issue #735
 // (coordinate state.json schema across producers/consumers). Optional and
 // unknown keys are permitted on purpose so state.json can evolve without
 // breaking this validator; only the load-bearing top-level keys are required.
@@ -289,7 +289,7 @@ const stateSchema = z
   .passthrough();
 
 /**
- * Validate the top-level shape of `.rihal/state.json`.
+ * Validate the top-level shape of `.rcode/state.json`.
  *
  * @param {object} obj parsed state.json
  * @returns {{ ok: boolean, errors: string[] }}