@hanzlaa/rcode 2.3.2 → 2.3.4

package/README.md

@@ -37,8 +37,8 @@ Rihal Code packages a lot. To keep things approachable, everything is organized
 
 Most AI tools give you one assistant pretending to be everything. **Rihal Code gives you Rihal's team — and Rihal's brain — inside every project.**
 
-- **44 agents** with clear roles, cultural identity (Arabic names), and hard scope boundaries
-- **98 slash commands** covering research, planning, execution, verification, and recovery
+- **43 agents** with clear roles, cultural identity (Arabic names), and hard scope boundaries
+- **99 slash commands** covering research, planning, execution, verification, and recovery
 - **3 execution modes**: parallel debate (`/rihal:council`), sequential pipelines (`/rihal:chain`), and quick-sync (`/rihal:discuss`)
 - **File-based state** in `.rihal/` that every workflow reads and updates
 - **Intent guards** on every workflow — catch wrong commands early with copy-paste redirects
@@ -65,8 +65,8 @@ npx @hanzlaa/rcode install
 One unified installer. Pure file shipping, no runtime dependencies. Installs into:
 
 - `.rihal/` — config, workflows, references, bin (Rihal infrastructure)
-- `.claude/agents/` — 44 first-class subagents
-- `.claude/commands/rihal/` — 98 slash commands
+- `.claude/agents/` — 43 first-class subagents
+- `.claude/commands/rihal/` — 99 slash commands
 - `.claude/skills/` — 56 phrase-activated skills (scaffold-project, create-prd, prfaq, retrospective, etc.)
 - `rihal/brain/` — Rihal standards pulled from upstream (PR / commit / architecture docs)
 - `.planning/` — where your artifacts land (council sessions, plans, chains, summaries)
@@ -309,7 +309,7 @@ Recent additions in this session:
 
 ---
 
-## Full command surface (98 commands)
+## Full command surface (99 commands)
 
 ### Router + lifecycle
 `init` · `do` · `help` · `status` · `stats` · `health` · `forensics` · `update`
@@ -446,8 +446,8 @@ Every install runs 5 automated smoke tests before exiting:
     ✓ rihal-tools.cjs runs — syntax ok
     ✓ .rihal/config.yaml present — 412 bytes
     ✓ .rihal/state.json parses — valid JSON
-    ✓ agents installed — 44
-    ✓ skills + commands installed — 56 skills + 98 commands
+    ✓ agents installed — 43
+    ✓ skills + commands installed — 56 skills + 99 commands
 ```
 
 A failed check prints the debug command and returns exit code 1 so CI catches broken installs.

package/cli/install.js

@@ -1251,6 +1251,19 @@ async function install(opts) {
   // .planning/council-sessions/ empty dir
   ensureDir(path.join(opts.target, '.planning', 'council-sessions'));
 
+  // .rihal/context/ — seed stub files so doctor doesn't report "never initialized"
+  // The /rihal:init slash command populates these with real project content.
+  const contextDir = path.join(opts.target, '.rihal', 'context');
+  ensureDir(contextDir);
+  const activeCtx = path.join(contextDir, 'active.md');
+  const briefCtx = path.join(contextDir, 'project-brief.md');
+  if (!fs.existsSync(activeCtx)) {
+    fs.writeFileSync(activeCtx, '# Active Context\n\n_Run `/rihal:init` inside your AI editor to populate this file._\n');
+  }
+  if (!fs.existsSync(briefCtx)) {
+    fs.writeFileSync(briefCtx, '# Project Brief\n\n_Run `/rihal:init` inside your AI editor to populate this file._\n');
+  }
+
   // ~/.rihal/agents/ global agents directory
   const globalAgentsDir = path.join(os.homedir(), '.rihal', 'agents');
   ensureDir(globalAgentsDir);

package/cli/lib/manifest.cjs

@@ -35,21 +35,27 @@ function readPackageManifest(packageRoot) {
     }
   }
 
-  const actionsDir = path.join(skillsRoot, 'actions');
-  if (fs.existsSync(actionsDir)) {
-    for (const entry of fs.readdirSync(actionsDir, { withFileTypes: true })) {
+  // Mirror installSkills() walkForSkills: recurse into action bucket dirs
+  // (1-analysis, 2-plan, etc.) until a dir with SKILL.md is found, then add
+  // the dir name as installed. Bucket dirs themselves are never installed.
+  function walkActions(dir) {
+    if (!fs.existsSync(dir)) return;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
       if (!entry.isDirectory()) continue;
-      if (entry.name === 'research') {
-        // Flatten research/* → actions set (matches installSkills)
-        const researchDir = path.join(actionsDir, 'research');
-        for (const sub of fs.readdirSync(researchDir, { withFileTypes: true })) {
-          if (sub.isDirectory()) manifest.actions.add(sub.name);
-        }
+      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-')
+          ? entry.name
+          : `rihal-${entry.name}`;
+        manifest.actions.add(installedName);
       } else {
-        manifest.actions.add(entry.name);
+        walkActions(full);
       }
     }
   }
+  walkActions(path.join(skillsRoot, 'actions'));
 
   return manifest;
 }

package/cli/lib/memory-bank.cjs

@@ -259,12 +259,12 @@ function checkStaleness(cwd) {
     };
   }
 
-  // Context files exist but no fingerprint stored — happened before
-  // fingerprinting was added, or state.json got truncated.
+  // Context files exist but no fingerprint stored — fresh install with stub
+  // context files, or state.json got truncated before fingerprint was written.
   if (!stored) {
     return {
       status: 'stale',
-      reasons: ['no fingerprint recorded — run /rihal:init once to bootstrap tracking'],
+      reasons: ['run /rihal:init in your editor to populate project context'],
       current,
       stored,
       context_files,

package/dist/rcode.js

@@ -15984,6 +15984,16 @@ Say "plan a sprint" or run \`/rihal:sprint-planning\` to break Phase 01 into sto
         }
       }
       ensureDir(path2.join(opts.target, ".planning", "council-sessions"));
+      const contextDir = path2.join(opts.target, ".rihal", "context");
+      ensureDir(contextDir);
+      const activeCtx = path2.join(contextDir, "active.md");
+      const briefCtx = path2.join(contextDir, "project-brief.md");
+      if (!fs2.existsSync(activeCtx)) {
+        fs2.writeFileSync(activeCtx, "# Active Context\n\n_Run `/rihal:init` inside your AI editor to populate this file._\n");
+      }
+      if (!fs2.existsSync(briefCtx)) {
+        fs2.writeFileSync(briefCtx, "# Project Brief\n\n_Run `/rihal:init` inside your AI editor to populate this file._\n");
+      }
       const globalAgentsDir = path2.join(os.homedir(), ".rihal", "agents");
       ensureDir(globalAgentsDir);
       fs2.writeFileSync(
@@ -16293,20 +16303,20 @@ var require_manifest = __commonJS({
           if (entry.isDirectory()) manifest.agents.add(entry.name);
         }
       }
-      const actionsDir = path2.join(skillsRoot, "actions");
-      if (fs2.existsSync(actionsDir)) {
-        for (const entry of fs2.readdirSync(actionsDir, { withFileTypes: true })) {
+      function walkActions(dir) {
+        if (!fs2.existsSync(dir)) return;
+        for (const entry of fs2.readdirSync(dir, { withFileTypes: true })) {
           if (!entry.isDirectory()) continue;
-          if (entry.name === "research") {
-            const researchDir = path2.join(actionsDir, "research");
-            for (const sub of fs2.readdirSync(researchDir, { withFileTypes: true })) {
-              if (sub.isDirectory()) manifest.actions.add(sub.name);
-            }
+          const full = path2.join(dir, entry.name);
+          if (fs2.existsSync(path2.join(full, "SKILL.md"))) {
+            const installedName = entry.name.startsWith("rihal-") ? entry.name : `rihal-${entry.name}`;
+            manifest.actions.add(installedName);
           } else {
-            manifest.actions.add(entry.name);
+            walkActions(full);
           }
         }
       }
+      walkActions(path2.join(skillsRoot, "actions"));
       return manifest;
     }
     function readInstalledDirs(dir, prefix = null) {
@@ -17471,7 +17481,7 @@ var require_memory_bank = __commonJS({
       if (!stored) {
         return {
           status: "stale",
-          reasons: ["no fingerprint recorded \u2014 run /rihal:init once to bootstrap tracking"],
+          reasons: ["run /rihal:init in your editor to populate project context"],
           current,
           stored,
           context_files

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "2.3.2",
-  "description": "Rihal Code (rcode) — installable context-brain for Rihalians. 44 agents, 98 slash commands, 56 skills, pullable Rihal standards. Unified install for Claude Code, Cursor, and Gemini.",
+  "version": "2.3.4",
+  "description": "Rihal Code (rcode) — installable context-brain for Rihalians. 43 agents, 99 slash commands, 56 skills, pullable Rihal standards. Unified install for Claude Code, Cursor, and Gemini.",
   "main": "cli/index.js",
   "bin": {
     "rcode": "dist/rcode.js",
+    "rihal": "dist/rcode.js",
     "rihal-code": "dist/rcode.js"
   },
   "scripts": {

package/rihal/state.json

@@ -0,0 +1,22 @@
+{
+  "version": "1",
+  "project": "__PROJECT_NAME__",
+  "created": "__INSTALL_DATE__",
+  "updated": "__INSTALL_DATE__",
+  "current_phase": "01",
+  "current_plan": 0,
+  "current_sprint": null,
+  "milestone": "M1 — Initial Delivery",
+  "phases": [
+    { "id": "01", "name": "Setup & Scaffolding", "status": "planned" }
+  ],
+  "executions": [],
+  "decisions": [],
+  "blockers": [],
+  "council_sessions": [],
+  "chains": [],
+  "workstreams": [],
+  "active_workstream": null,
+  "last_session": null,
+  "velocity_history": []
+}

package/rihal/workflows/chain.md

@@ -185,4 +185,4 @@ Silent on failure — state tracking is optional.
 - **state.json missing or corrupted:** continue without error — chain artifacts are mandatory, state tracking is optional.
 - **Stage fails to produce artifact:** print stage number, allow `/rihal:chain --continue` to resume.
 - **Agent returns empty output:** print "Agent produced no output. Check input and retry."
-- **`rihal-tools.cjs` missing:** tell user to run `rihal-code install-v2`.
+- **`rihal-tools.cjs` missing:** tell user to run `npx @hanzlaa/rcode install` (or `rcode install` if installed globally).

package/rihal/workflows/council.md

@@ -558,7 +558,7 @@ node .rihal/bin/rihal-tools.cjs state record-session
 
 - **Empty arguments or --help:** print usage block (Step 0), stop.
 - **Single-agent question detected:** redirect to `/rihal:discuss` (Step 0.5).
-- **`rihal-tools.cjs` not found:** user has v1 installed or package broken. Tell user to run `rihal-code install-v2`.
+- **`rihal-tools.cjs` not found:** user has v1 installed or package broken. Tell user to run `npx @hanzlaa/rcode install` (or `rcode install` if installed globally).
 - **Panel contains unknown agent:** print the installed-agent list and exit.
 - **state.json missing or corrupted:** continue without error — session artifact is mandatory, state tracking is optional.
 - **All panelists return empty responses:** likely subagents were spawned without proper prompts. Re-check Step 4 prompt construction.

package/rihal/workflows/discuss.md

@@ -219,8 +219,8 @@ This records the discuss session in `.rihal/state.json` as `last_session`.
 - **Empty arguments:** print usage block and stop (Step 0).
 - **Question redirects to council:** print redirect message (Step 0.5).
 - **state.json missing or corrupted:** continue without error — session artifact is mandatory, state tracking is optional.
-- **`rihal-tools.cjs` not found:** tell the user to run `rihal-code install-v2`.
-- **No installed agents:** print "No agents installed. Run `rihal-code install-v2`."
+- **`rihal-tools.cjs` not found:** tell the user to run `npx @hanzlaa/rcode install` (or `rcode install` if installed globally).
+- **No installed agents:** print "No agents installed. Run `npx @hanzlaa/rcode install`."
 - **Agent id not in installed list:** print available agents and ask the user to pick one.
 - **Agent returns empty response:** print "Agent responded empty. Check question clarity and retry."
 

package/rihal/workflows/enable-hooks.md

@@ -30,7 +30,7 @@ cat .rihal/templates/settings-hooks.json
 Parse the JSON. If file does not exist, print error and stop:
 
 ```
-Error: .rihal/templates/settings-hooks.json not found. Run 'rihal-code install-v2' to reinstall.
+Error: .rihal/templates/settings-hooks.json not found. Run 'npx @hanzlaa/rcode install' to reinstall.
 ```
 
 ## Step 2 — Load or create settings.json