@hanzlaa/rcode 3.3.2 → 3.4.1

package/README.md

@@ -2,9 +2,17 @@
 
 <div dir="rtl">طريقة رحال</div>
 
-> **rcode is the memory bank for AI-driven SaaS teams — your project's context, structured, visible, and never lost.**
->
-> Built by Rihal. Designed for solo devs, startup teams, and SaaS builders. Install once, and your AI assistant gets a persistent project brain: structured memory, decisions log, distinctive personas, and phase-based workflows. Works in Claude Code, Cursor, and any compatible AI IDE.
+> **The AI team that never forgets.** Persistent memory, 45 specialist agents, 95 commands — install once, and your AI IDE gets a project brain that survives every session reset.
+
+```bash
+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)
+
+<!-- TODO: Replace with actual demo GIF once recorded (story 05.1.03) -->
+<!-- ![rcode demo](docs/assets/demo.gif) -->
 
 ---
 
@@ -27,8 +35,6 @@ Every project carries unwritten context — how the team reviews PRs, what "done
 
 **rcode fixes that.** One install, and the AI knows. Every session. Every repo. Every contributor.
 
-See [`docs/what-is-rihal-code.md`](docs/what-is-rihal-code.md) for the full story, and [`docs/ROADMAP.md`](docs/ROADMAP.md) for where this is going (next: live MCP server in v3.0).
-
 ---
 
 ## 🚦 Start Here
@@ -44,7 +50,7 @@ Rihal Code packages a lot. To keep things approachable, everything is organized
 
 **Brand new?** Do the [Golden Path](docs/TIERS.md#-starter--the-golden-path): scaffold → PRD → stories → sprint → dev → review → status. Seven skills, one project, end-to-end.
 
-> **v2.0 — Rihal Brain.** v1 was a generic AI-engineering methodology. v2 keeps all of that and adds the Rihal context layer on top: standards, guides, and institutional knowledge pulled fresh from Rihal's own repos on install and on `/rihal-update`. See [`CHANGELOG.md`](CHANGELOG.md) and the [v2.0 milestone](https://github.com/hanzlahabib/rihal-code/milestone/4).
+> **v3 — Rihal Brain.** v1 was a generic AI-engineering methodology. v2 added the Rihal context layer. v3 ships it as a single npm package with a Memory Bank, live dashboard, and 134 automated tests. See [`CHANGELOG.md`](CHANGELOG.md).
 
 ---
 
@@ -54,7 +60,8 @@ Most AI tools give you one assistant pretending to be everything. **Rihal Code g
 
 - **45 agents** with clear roles, cultural identity (Arabic names), and hard scope boundaries
 - **95 slash commands** covering research, planning, execution, verification, and recovery
-- **80 skills** including Memory Bank primitives, 11 engineering-rigor skills (TDD, harden, perf, debug, trim, etc.), and 8 real-pain skills (auth-audit, mvp-graduate, deploy-unify, etc.)
+- **105 skills** including Memory Bank primitives, 11 engineering-rigor skills (TDD, harden, perf, debug, trim, etc.), and 8 real-pain skills (auth-audit, mvp-graduate, deploy-unify, etc.)
+- **102 workflows** — the execution backbone behind every slash command
 - **Persistent project memory** at `.rihal/memory/` — checked into git, visible in the Diwan dashboard, lossless distillates for fast LLM hydration
 - **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
@@ -79,14 +86,14 @@ In any project directory (existing codebase OR empty folder):
 npx @hanzlaa/rcode install
 ```
 
-[Live on npm](https://www.npmjs.com/package/@hanzlaa/rcode) as `@hanzlaa/rcode` · current version `v2.1.0`. See [`docs/install.md`](docs/install.md) for flavors (module subsets, IDE options, version pinning, yolo mode).
+[Live on npm](https://www.npmjs.com/package/@hanzlaa/rcode) as `@hanzlaa/rcode`. See [`docs/install.md`](docs/install.md) for flavors (module subsets, IDE options, version pinning, yolo mode).
 
 One unified installer. Pure file shipping, no runtime dependencies. Installs into:
 
 - `.rihal/` — config, workflows, references, bin (Rihal infrastructure)
 - `.claude/agents/` — 45 first-class subagents
 - `.claude/commands/rihal/` — 95 slash commands
-- `.claude/skills/` — 80 phrase-activated skills (scaffold-project, create-prd, prfaq, memory-init, retrospective, etc.)
+- `.claude/skills/` — 105 phrase-activated skills (scaffold-project, create-prd, prfaq, memory-init, retrospective, etc.)
 - `rihal/brain/` — Rihal standards pulled from upstream (PR / commit / architecture docs)
 - `.planning/` — where your artifacts land (council sessions, plans, chains, summaries)
 
@@ -148,7 +155,7 @@ npx @hanzlaa/rcode install --ide gemini
   bin/
     rihal-tools.cjs            — CLI helper (state read/write, panel scoring, etc.)
     lib/council-panel.cjs      — deterministic panel scorer
-  workflows/                   — 69 slash command workflows
+  workflows/                   — 102 slash command workflows
   references/                  — shared contracts (council-protocol, gates, karpathy-guidelines, etc.)
   agents-rules/                — lazy-loaded agent rule files (planner, executor, debugger)
 ```
@@ -308,26 +315,6 @@ Amazon's "Working Backwards" method: write the finished-product press release *b
 
 ---
 
-## What's new in v2-prototype
-
-Recent additions in this session:
-
-- **69 slash commands** across 3 modes and 3 modules (up from 64)
-- **Numeric ID system** — milestones (M1, M2), phases (01, 02, 02.1), plans (01.01, 02.03), tasks (01.01.01) with decimal insertion for urgent inserts
-- **Intent guards** (`Step 0.5`) — every workflow detects mismatched intent and redirects instead of failing
-- **Plan-checker loop** — `/rihal-plan` now verifies file existence and symbol definitions; loops back to planner on validation failure
-- **Post-execute gates** — `/rihal-execute` runs integration-checker (E2E) and nyquist-auditor (coverage) as hard gates
-- **Multilingual classifier** — Roman Urdu, Arabic, English with cultural signal routing (Mariam leads GCC/MENA)
-- **Karpathy guidelines enforcement** — 4 coding principles baked into every code-writing agent
-- **Global agents** — customize agents in `~/.rihal/agents/` without forking the repo
-- **Multi-IDE installer** — support for Claude Code, Cursor, Gemini CLI
-- **Hooks system** — opt-in pre-edit, pre-workflow, post-commit enforcement
-- **Session pause/resume** — `/rihal-pause-work` + `/rihal-resume-work` with HANDOFF.json
-- **Workspace isolation** — `/rihal-new-workspace` for parallel tracks
-- **Decimal phase insertion** — `/rihal-insert-phase` for urgent mid-cycle work
-
----
-
 ## Full command surface (95 commands)
 
 ### Router + lifecycle
@@ -428,18 +415,18 @@ Installs 3 opt-in hooks into `.claude/settings.json`:
 | **execution** | Executor, planner, verifier + checker agents, `/rihal-execute`, `/rihal-plan`, `/rihal-quick`, `/rihal-debug`, `/rihal-audit-fix`, `/rihal-undo` |
 | **discovery** | Codebase-mapper, project-researcher, roadmapper, `/rihal-new-project`, `/rihal-map-codebase`, `/rihal-scan`, `/rihal-explore`, `/rihal-code-review`, `/rihal-docs-update` |
 
-Full install = all 3 modules = 201 files.
+Full install = all 3 modules = 700+ files.
 
 ---
 
 ## Testing
 
 ```bash
-node --test          # full suite (95 tests, ~1s)
+node --test          # full suite (134 tests, ~2s)
 node --test --test-reporter=spec   # verbose output with test names
 ```
 
-**95 tests · 0 failures · pure Node stdlib (no test runner install needed)**
+**134 tests · pure Node stdlib (no test runner install needed)**
 
 ### Test scenarios
 
@@ -466,7 +453,7 @@ Every install runs 5 automated smoke tests before exiting:
     ✓ .rihal/config.yaml present — 412 bytes
     ✓ .rihal/state.json parses — valid JSON
     ✓ agents installed — 45
-    ✓ skills + commands installed — 80 skills + 95 commands
+    ✓ skills + commands installed — 105 skills + 95 commands
 ```
 
 A failed check prints the debug command and returns exit code 1 so CI catches broken installs.
@@ -508,12 +495,10 @@ node --test test/lib/manifest.test.cjs   # install verification only
 
 ## License
 
-MIT
+UNLICENSED — proprietary. All rights reserved.
 
 ---
 
 ## Roadmap
 
-See [GitHub Issues](https://github.com/hanzlahabib/rihal-code/issues) for tracked work. Current branch: `v2-prototype` — under active development. Main branch will track stable releases.
-
-**This branch is pre-release.** For production, wait for `v0.2.0` on main.
+See [GitHub Issues](https://github.com/hanzlahabib/rihal-code/issues) for tracked work. Current focus: marketing launch, MCP server, dashboard enhancements.

package/cli/install.js

@@ -299,20 +299,19 @@ function detectIdeSignals(target) {
  * actually wanted cursor or gemini.
  */
 async function resolveIde(opts) {
-  if (opts.ideProvided) return opts.ide;            // user passed --ide, respect it
-  if (opts.yes || !process.stdin.isTTY) return opts.ide || 'claude';
+  if (opts.ideProvided) return [opts.ide];            // user passed --ide, respect it
+  if (opts.yes || !process.stdin.isTTY) return [opts.ide || 'claude'];
 
   const signals = detectIdeSignals(opts.target);
   const detected = ['claude', 'cursor', 'gemini', 'vscode'].filter(k => signals[k]);
 
-  // Pick a default: prefer the single detected IDE; otherwise claude
-  let defaultValue = 'claude';
-  if (detected.length === 1) defaultValue = detected[0];
+  // Pre-select detected IDEs, or default to claude
+  const initialValues = detected.length > 0 ? detected : ['claude'];
 
-  // Use @clack/prompts for arrow-key navigation. Closes #449 / #450.
-  const choice = await clack.select({
-    message: '🎯 Which editor will you use rcode with?',
-    initialValue: defaultValue,
+  // Use @clack/prompts multiselect for multi-editor support. Closes #449 / #450.
+  const choices = await clack.multiselect({
+    message: '🎯 Which editor(s) will you use rcode with?',
+    initialValues,
     options: [
       { value: 'claude',     label: 'Claude Code',  hint: signals.claude ? '(detected)' : undefined },
       { value: 'cursor',     label: 'Cursor',       hint: signals.cursor ? '(detected)' : undefined },
@@ -320,15 +319,16 @@ async function resolveIde(opts) {
       { value: 'vscode',     label: 'VS Code',      hint: signals.vscode ? '(detected)' : '(via Continue / Copilot extensions)' },
       { value: 'antigravity', label: 'Antigravity', hint: '(experimental — installs to .antigravity/)' },
     ],
+    required: true,
   });
 
   // Handle Ctrl-C cleanly
-  if (clack.isCancel(choice)) {
+  if (clack.isCancel(choices)) {
     clack.cancel('Install cancelled.');
     process.exit(0);
   }
 
-  return choice;
+  return choices;
 }
 
 /**
@@ -1226,7 +1226,7 @@ async function install(opts) {
   if (isInteractive) printInstallHeader(pkgVersion);
 
   // Resolve target IDE (interactive prompt unless --ide flag, --yes, or non-TTY).
-  opts.ide = await resolveIde(opts);
+  opts.ides = await resolveIde(opts);
 
   // Resolve commit-planning preference (interactive prompt or flag) — #189.
   opts.commitPlanning = await resolveCommitPlanning(opts);
@@ -1255,9 +1255,11 @@ async function install(opts) {
     return 1;
   }
 
-  // Validate IDE — structured error for unsupported editors (#197).
-  if (!['claude', 'cursor', 'gemini', 'vscode', 'antigravity'].includes(opts.ide)) {
-    console.error(`✖ --ide ${opts.ide} is not supported in v${readPackageVersion()}.`);
+  // Validate IDE(s) — structured error for unsupported editors (#197).
+  const SUPPORTED_IDES = ['claude', 'cursor', 'gemini', 'vscode', 'antigravity'];
+  const unsupported = opts.ides.filter(ide => !SUPPORTED_IDES.includes(ide));
+  if (unsupported.length > 0) {
+    console.error(`✖ --ide ${unsupported.join(', ')} is not supported in v${readPackageVersion()}.`);
     console.error('');
     console.error('  Currently supported:');
     console.error('    claude       — Claude Code native (recommended)');
@@ -1274,21 +1276,23 @@ async function install(opts) {
   }
 
   // VS Code installs to .claude/ paths (extension reads from there). Inform the user.
-  if (opts.ide === 'vscode') {
+  if (opts.ides.includes('vscode')) {
     console.log('  ' + dim('VS Code → installing to .claude/ paths (read by Claude Code / Continue / Copilot extensions).'));
   }
 
   // Gemini IDE support deferred
-  if (opts.ide === 'gemini') {
+  if (opts.ides.includes('gemini')) {
     console.log(`\n⚠️  Gemini CLI install not yet implemented\n`);
     console.log(`Gemini IDE requires aggregating all agents and commands into a single GEMINI.md file.`);
     console.log(`This feature is planned but not yet available.\n`);
     console.log(`For now, use: --ide claude or --ide cursor\n`);
-    return 1;
+    // Remove gemini from the list so install can continue for other IDEs
+    opts.ides = opts.ides.filter(e => e !== 'gemini');
+    if (opts.ides.length === 0) return 1;
   }
 
   // Antigravity install is experimental — best-effort path, user may need to adjust
-  if (opts.ide === 'antigravity') {
+  if (opts.ides.includes('antigravity')) {
     console.log('  ' + warn('Antigravity install is experimental. Files land at .antigravity/rihal/{agents,commands}/.'));
     console.log('  ' + dim('If Antigravity expects a different path, adjust .rihal/config.yaml and re-run.'));
   }
@@ -1304,7 +1308,7 @@ async function install(opts) {
     }
   }
 
-  const fullPlan = buildInstallPlan(opts.ide, opts.target);
+  const fullPlan = buildInstallPlan(opts.ides, opts.target);
   const plan = filterPlanByModules(fullPlan, opts.modules);
   if (plan.length === 0) {
     console.error('✖ Nothing to install — install plan is empty.');
@@ -1719,7 +1723,8 @@ async function install(opts) {
   // Count installed agents + commands dynamically (#190). Reads from the
   // IDE-specific install paths so cursor/gemini/vscode/antigravity don't
   // false-fail the health check.
-  const idePaths = getPathsForIde(opts.ide, opts.target);
+  const primaryIde = opts.ides[0];
+  const idePaths = getPathsForIde(primaryIde, opts.target);
   const agentsDir = idePaths.agentsDir;
   const commandsDir = idePaths.commandsDir;
   let agentCount = 0, commandCount = 0;
@@ -1735,7 +1740,7 @@ async function install(opts) {
   const version = readPackageVersion();
   console.log('');
   console.log(`  ${bold('Version:')}   ${pc.cyan('@hanzlaa/rcode@' + version)}`);
-  console.log(`  ${bold('IDE:')}       ${opts.ide}`);
+  console.log(`  ${bold('IDE:')}       ${opts.ides.join(', ')}`);
   console.log(`  ${bold('Language:')}  ${opts.language}  ${dim('(change in .rihal/config.yaml)')}`);
   console.log(`  ${bold('Mode:')}      ${opts.mode}  ${dim('(guided=confirm at gates, yolo=autonomous)')}`);
   console.log(`  ${bold('Planning:')}  ${opts.commitPlanning !== false ? 'committed' : 'gitignored'}  ${dim('(flip: rihal-tools gitignore refresh)')}`);
@@ -1898,7 +1903,7 @@ async function main() {
  * Mutates opts in-place. Exits 0 on cancel.
  */
 async function runInstallWizard(opts) {
-  const { intro, outro, text, select, confirm, isCancel, cancel, note } = clack;
+  const { intro, outro, text, select, multiselect, confirm, isCancel, cancel, note } = clack;
   const pkgVersion = readPackageVersion();
 
   console.log('');
@@ -1919,17 +1924,20 @@ async function runInstallWizard(opts) {
   }
 
   // ── 2. Editor / LLM ──────────────────────────────────────────────────
-  const editorChoice = await select({
-    message: 'Which editor are you installing for?',
+  const editorChoices = await multiselect({
+    message: 'Which editor(s) are you installing for?',
     options: [
       { value: 'claude',  label: 'Claude Code',  hint: 'recommended' },
       { value: 'cursor',  label: 'Cursor' },
       { value: 'gemini',  label: 'Gemini CLI',   hint: 'coming soon' },
+      { value: 'vscode',  label: 'VS Code',      hint: 'via Continue / Copilot extensions' },
+      { value: 'antigravity', label: 'Antigravity', hint: 'experimental' },
     ],
-    initialValue: opts.ide || 'claude',
+    initialValues: opts.ide ? [opts.ide] : ['claude'],
+    required: true,
   });
-  if (isCancel(editorChoice)) { cancel('Installation cancelled.'); process.exit(0); }
-  opts.ide = editorChoice;
+  if (isCancel(editorChoices)) { cancel('Installation cancelled.'); process.exit(0); }
+  opts.ides = editorChoices;
 
   // ── 3. Communication language ─────────────────────────────────────────
   const langChoice = await select({
@@ -1984,7 +1992,7 @@ async function runInstallWizard(opts) {
   note(
     [
       `${pc.dim('Directory:')}   ${opts.target}`,
-      `${pc.dim('Editor:')}      ${opts.ide}`,
+      `${pc.dim('Editor:')}      ${opts.ides.join(', ')}`,
       `${pc.dim('Language:')}    ${opts.language}`,
       `${pc.dim('Mode:')}        ${opts.mode}`,
       `${pc.dim('Planning:')}    ${opts.commitPlanning ? 'committed to git' : 'kept local (gitignored)'}`,

package/cli/update.js

@@ -31,7 +31,8 @@
 const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
-const { askConfirm, askChoice, PromptAbortError } = require('./lib/prompts.cjs');
+const clack = require('@clack/prompts');
+const { PromptAbortError } = require('./lib/prompts.cjs');
 const { writeJsonAtomic } = require('./lib/fsutil.cjs');
 const { verifyInstall, formatReport } = require('./lib/manifest.cjs');
 const install = require('./install');
@@ -273,21 +274,17 @@ async function runUpdate(args, { packageRoot, packageJson }) {
     const ALL_EDITORS = ['claude', 'cursor', 'gemini'];
     const missing = ALL_EDITORS.filter(e => !editors.includes(e));
     if (missing.length > 0) {
-      const choices = [
-        { id: 'no',  label: `No — refresh existing only (${editors.join(', ')})` },
-        ...missing.map(e => ({ id: e, label: `Add ${e}` })),
-        { id: 'all', label: 'Add all missing editors' },
-      ];
-      const answer = await askChoice(
-        `Add support for additional editors?`,
-        { choices, default: 'no' }
-      );
-      const picked = answer[0];
-      if (picked === 'all') {
-        for (const e of missing) editors.push(e);
-      } else if (picked !== 'no') {
-        editors.push(picked);
+      const editorLabels = { claude: 'Claude Code', cursor: 'Cursor', gemini: 'Gemini CLI' };
+      const selected = await clack.multiselect({
+        message: 'Add support for additional editors?',
+        options: missing.map(e => ({ value: e, label: editorLabels[e] || e })),
+        required: false,
+      });
+      if (clack.isCancel(selected)) {
+        clack.cancel('Update cancelled.');
+        process.exit(0);
       }
+      for (const e of selected) editors.push(e);
       console.log(`   Editors to update: ${editors.join(', ')}`);
       console.log();
     }
@@ -295,11 +292,11 @@ async function runUpdate(args, { packageRoot, packageJson }) {
 
   // ------ Confirm ------
   if (!opts.yes) {
-    const proceed = await askConfirm(
-      `Proceed with update? [y/N] `,
-      { default: 'n' },
-    );
-    if (!proceed) {
+    const proceed = await clack.confirm({
+      message: 'Proceed with update?',
+      initialValue: false,
+    });
+    if (clack.isCancel(proceed) || !proceed) {
       console.log(`\n❌ Update cancelled. Nothing changed.`);
       return;
     }

package/dist/rcode.js

@@ -15972,28 +15972,28 @@ var require_install = __commonJS({
       return signals;
     }
     async function resolveIde(opts) {
-      if (opts.ideProvided) return opts.ide;
-      if (opts.yes || !process.stdin.isTTY) return opts.ide || "claude";
+      if (opts.ideProvided) return [opts.ide];
+      if (opts.yes || !process.stdin.isTTY) return [opts.ide || "claude"];
       const signals = detectIdeSignals(opts.target);
       const detected = ["claude", "cursor", "gemini", "vscode"].filter((k) => signals[k]);
-      let defaultValue = "claude";
-      if (detected.length === 1) defaultValue = detected[0];
-      const choice = await clack.select({
-        message: "\u{1F3AF} Which editor will you use rcode with?",
-        initialValue: defaultValue,
+      const initialValues = detected.length > 0 ? detected : ["claude"];
+      const choices = await clack.multiselect({
+        message: "\u{1F3AF} Which editor(s) will you use rcode with?",
+        initialValues,
         options: [
           { value: "claude", label: "Claude Code", hint: signals.claude ? "(detected)" : void 0 },
           { value: "cursor", label: "Cursor", hint: signals.cursor ? "(detected)" : void 0 },
           { value: "gemini", label: "Gemini CLI", hint: signals.gemini ? "(detected)" : "(beta \u2014 limited)" },
           { value: "vscode", label: "VS Code", hint: signals.vscode ? "(detected)" : "(via Continue / Copilot extensions)" },
           { value: "antigravity", label: "Antigravity", hint: "(experimental \u2014 installs to .antigravity/)" }
-        ]
+        ],
+        required: true
       });
-      if (clack.isCancel(choice)) {
+      if (clack.isCancel(choices)) {
         clack.cancel("Install cancelled.");
         process.exit(0);
       }
-      return choice;
+      return choices;
     }
     async function resolveCommitPlanning(opts) {
       if (opts.commitPlanning !== null) return opts.commitPlanning;
@@ -16695,7 +16695,7 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
       const pkgVersion = readPackageVersion();
       const isInteractive = process.stdin.isTTY && !opts.yes;
       if (isInteractive) printInstallHeader(pkgVersion);
-      opts.ide = await resolveIde(opts);
+      opts.ides = await resolveIde(opts);
       opts.commitPlanning = await resolveCommitPlanning(opts);
       console.log(`
 \u{1F54C} ${bold("Rihal Code")} ${pc.cyan("v" + pkgVersion)} ${dim("\u2192")} ${opts.target}`);
@@ -16717,8 +16717,10 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
         console.error(`\u2716 Source tree not found at ${SOURCE_ROOT}. Running from wrong dir?`);
         return 1;
       }
-      if (!["claude", "cursor", "gemini", "vscode", "antigravity"].includes(opts.ide)) {
-        console.error(`\u2716 --ide ${opts.ide} is not supported in v${readPackageVersion()}.`);
+      const SUPPORTED_IDES = ["claude", "cursor", "gemini", "vscode", "antigravity"];
+      const unsupported = opts.ides.filter((ide) => !SUPPORTED_IDES.includes(ide));
+      if (unsupported.length > 0) {
+        console.error(`\u2716 --ide ${unsupported.join(", ")} is not supported in v${readPackageVersion()}.`);
         console.error("");
         console.error("  Currently supported:");
         console.error("    claude       \u2014 Claude Code native (recommended)");
@@ -16733,10 +16735,10 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
         console.error("");
         return 1;
       }
-      if (opts.ide === "vscode") {
+      if (opts.ides.includes("vscode")) {
         console.log("  " + dim("VS Code \u2192 installing to .claude/ paths (read by Claude Code / Continue / Copilot extensions)."));
       }
-      if (opts.ide === "gemini") {
+      if (opts.ides.includes("gemini")) {
         console.log(`
 \u26A0\uFE0F  Gemini CLI install not yet implemented
 `);
@@ -16745,9 +16747,10 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
 `);
         console.log(`For now, use: --ide claude or --ide cursor
 `);
-        return 1;
+        opts.ides = opts.ides.filter((e) => e !== "gemini");
+        if (opts.ides.length === 0) return 1;
       }
-      if (opts.ide === "antigravity") {
+      if (opts.ides.includes("antigravity")) {
         console.log("  " + warn("Antigravity install is experimental. Files land at .antigravity/rihal/{agents,commands}/."));
         console.log("  " + dim("If Antigravity expects a different path, adjust .rihal/config.yaml and re-run."));
       }
@@ -16760,7 +16763,7 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
           return 1;
         }
       }
-      const fullPlan = buildInstallPlan(opts.ide, opts.target);
+      const fullPlan = buildInstallPlan(opts.ides, opts.target);
       const plan = filterPlanByModules(fullPlan, opts.modules);
       if (plan.length === 0) {
         console.error("\u2716 Nothing to install \u2014 install plan is empty.");
@@ -17090,7 +17093,8 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
         console.log(dim("  To overwrite: re-run with --force-overwrite  |  To see full diffs: --show-diff"));
         console.log("");
       }
-      const idePaths = getPathsForIde(opts.ide, opts.target);
+      const primaryIde = opts.ides[0];
+      const idePaths = getPathsForIde(primaryIde, opts.target);
       const agentsDir = idePaths.agentsDir;
       const commandsDir = idePaths.commandsDir;
       let agentCount = 0, commandCount = 0;
@@ -17106,7 +17110,7 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
       const version = readPackageVersion();
       console.log("");
       console.log(`  ${bold("Version:")}   ${pc.cyan("@hanzlaa/rcode@" + version)}`);
-      console.log(`  ${bold("IDE:")}       ${opts.ide}`);
+      console.log(`  ${bold("IDE:")}       ${opts.ides.join(", ")}`);
       console.log(`  ${bold("Language:")}  ${opts.language}  ${dim("(change in .rihal/config.yaml)")}`);
       console.log(`  ${bold("Mode:")}      ${opts.mode}  ${dim("(guided=confirm at gates, yolo=autonomous)")}`);
       console.log(`  ${bold("Planning:")}  ${opts.commitPlanning !== false ? "committed" : "gitignored"}  ${dim("(flip: rihal-tools gitignore refresh)")}`);
@@ -17243,7 +17247,7 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
       }
     }
     async function runInstallWizard(opts) {
-      const { intro, outro, text, select, confirm, isCancel, cancel, note } = clack;
+      const { intro, outro, text, select, multiselect, confirm, isCancel, cancel, note } = clack;
       const pkgVersion = readPackageVersion();
       console.log("");
       intro(pc.bold("\u{1F54C} Rihal Code") + pc.dim(`  v${pkgVersion}`));
@@ -17262,20 +17266,23 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
         opts.target = resolved;
         opts.projectName = path2.basename(resolved);
       }
-      const editorChoice = await select({
-        message: "Which editor are you installing for?",
+      const editorChoices = await multiselect({
+        message: "Which editor(s) are you installing for?",
         options: [
           { value: "claude", label: "Claude Code", hint: "recommended" },
           { value: "cursor", label: "Cursor" },
-          { value: "gemini", label: "Gemini CLI", hint: "coming soon" }
+          { value: "gemini", label: "Gemini CLI", hint: "coming soon" },
+          { value: "vscode", label: "VS Code", hint: "via Continue / Copilot extensions" },
+          { value: "antigravity", label: "Antigravity", hint: "experimental" }
         ],
-        initialValue: opts.ide || "claude"
+        initialValues: opts.ide ? [opts.ide] : ["claude"],
+        required: true
       });
-      if (isCancel(editorChoice)) {
+      if (isCancel(editorChoices)) {
         cancel("Installation cancelled.");
         process.exit(0);
       }
-      opts.ide = editorChoice;
+      opts.ides = editorChoices;
       const langChoice = await select({
         message: "Communication language?",
         options: [
@@ -17332,7 +17339,7 @@ Say "plan a sprint" or run \`/rihal-sprint-planning\` to break Phase 01 into sto
       note(
         [
           `${pc.dim("Directory:")}   ${opts.target}`,
-          `${pc.dim("Editor:")}      ${opts.ide}`,
+          `${pc.dim("Editor:")}      ${opts.ides.join(", ")}`,
           `${pc.dim("Language:")}    ${opts.language}`,
           `${pc.dim("Mode:")}        ${opts.mode}`,
           `${pc.dim("Planning:")}    ${opts.commitPlanning ? "committed to git" : "kept local (gitignored)"}`,
@@ -17767,7 +17774,8 @@ var require_update = __commonJS({
     var fs2 = require("fs");
     var path2 = require("path");
     var { spawnSync } = require("child_process");
-    var { askConfirm, askChoice, PromptAbortError } = require_prompts();
+    var clack = require_dist3();
+    var { PromptAbortError } = require_prompts();
     var { writeJsonAtomic } = require_fsutil();
     var { verifyInstall, formatReport } = require_manifest();
     var install = require_install();
@@ -17964,31 +17972,27 @@ var require_update = __commonJS({
         const ALL_EDITORS = ["claude", "cursor", "gemini"];
         const missing = ALL_EDITORS.filter((e) => !editors.includes(e));
         if (missing.length > 0) {
-          const choices = [
-            { id: "no", label: `No \u2014 refresh existing only (${editors.join(", ")})` },
-            ...missing.map((e) => ({ id: e, label: `Add ${e}` })),
-            { id: "all", label: "Add all missing editors" }
-          ];
-          const answer = await askChoice(
-            `Add support for additional editors?`,
-            { choices, default: "no" }
-          );
-          const picked = answer[0];
-          if (picked === "all") {
-            for (const e of missing) editors.push(e);
-          } else if (picked !== "no") {
-            editors.push(picked);
+          const editorLabels = { claude: "Claude Code", cursor: "Cursor", gemini: "Gemini CLI" };
+          const selected = await clack.multiselect({
+            message: "Add support for additional editors?",
+            options: missing.map((e) => ({ value: e, label: editorLabels[e] || e })),
+            required: false
+          });
+          if (clack.isCancel(selected)) {
+            clack.cancel("Update cancelled.");
+            process.exit(0);
           }
+          for (const e of selected) editors.push(e);
           console.log(`   Editors to update: ${editors.join(", ")}`);
           console.log();
         }
       }
       if (!opts.yes) {
-        const proceed = await askConfirm(
-          `Proceed with update? [y/N] `,
-          { default: "n" }
-        );
-        if (!proceed) {
+        const proceed = await clack.confirm({
+          message: "Proceed with update?",
+          initialValue: false
+        });
+        if (clack.isCancel(proceed) || !proceed) {
           console.log(`
 \u274C Update cancelled. Nothing changed.`);
           return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "3.3.2",
+  "version": "3.4.1",
   "description": "rcode — the memory bank for AI-driven SaaS teams. Persistent project context, distinctive engineering personas, and phase-based workflows. Built by Rihal. Works in Claude Code, Cursor, Gemini, VS Code, and Antigravity.",
   "main": "cli/index.js",
   "bin": {
@@ -8,14 +8,6 @@
     "rihal": "dist/rcode.js",
     "rihal-code": "dist/rcode.js"
   },
-  "scripts": {
-    "dashboard": "node server/dashboard.js",
-    "test": "node --test",
-    "test:ci": "node --test --test-reporter=spec",
-    "postinstall": "node cli/postinstall.js",
-    "build:cli": "node scripts/build.cjs",
-    "build": "node scripts/build.cjs"
-  },
   "files": [
     "cli/",
     "rihal/",
@@ -70,5 +62,13 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "dashboard": "node server/dashboard.js",
+    "test": "node --test",
+    "test:ci": "node --test --test-reporter=spec",
+    "postinstall": "node cli/postinstall.js",
+    "build:cli": "node scripts/build.cjs",
+    "build": "node scripts/build.cjs"
   }
-}
+}

package/rihal/agents/rihal-assumptions-analyzer.md

@@ -6,6 +6,7 @@ color: cyan
 ---
 
 @.rihal/references/response-style.md
+@.rihal/references/karpathy-guidelines.md
 
 
 
@@ -114,4 +115,3 @@ ecosystem best practices, etc. Leave empty if codebase provides enough evidence.
 - validate assumptions against available evidence
 - document assumption risk and impact
 - preserve plan context and objectives
-- return clear assumption list with validation status