@hanzlaa/rcode 2.8.0 → 3.2.0

package/dist/rcode.js

@@ -15952,69 +15952,65 @@ var require_install = __commonJS({
       console.log(lines.join("\n"));
     }
     function detectIdeSignals(target) {
-      const signals = { claude: false, cursor: false, gemini: false };
+      const signals = { claude: false, cursor: false, gemini: false, vscode: false, antigravity: false };
       if (fs2.existsSync(path2.join(target, ".claude"))) signals.claude = true;
       if (fs2.existsSync(path2.join(target, ".cursor"))) signals.cursor = true;
       if (fs2.existsSync(path2.join(target, ".gemini"))) signals.gemini = true;
+      if (fs2.existsSync(path2.join(target, ".vscode"))) signals.vscode = true;
+      if (fs2.existsSync(path2.join(target, ".antigravity"))) signals.antigravity = true;
       const home = os.homedir();
       if (fs2.existsSync(path2.join(home, ".claude"))) signals.claude = true;
       if (fs2.existsSync(path2.join(home, ".cursor"))) signals.cursor = true;
       if (fs2.existsSync(path2.join(home, ".config", "Cursor"))) signals.cursor = true;
       if (fs2.existsSync(path2.join(home, ".gemini"))) signals.gemini = true;
+      if (fs2.existsSync(path2.join(home, ".vscode"))) signals.vscode = true;
+      if (fs2.existsSync(path2.join(home, ".config", "Code"))) signals.vscode = true;
+      if (fs2.existsSync(path2.join(home, ".antigravity"))) signals.antigravity = true;
       if (process.env.CURSOR_TRACE_ID || /cursor/i.test(process.env.TERM_PROGRAM || "")) signals.cursor = true;
       if (process.env.CLAUDECODE === "1" || process.env.CLAUDE_CODE_ENTRYPOINT) signals.claude = true;
+      if (process.env.VSCODE_PID || /vscode/i.test(process.env.TERM_PROGRAM || "")) signals.vscode = true;
       return signals;
     }
     async function resolveIde(opts) {
       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"].filter((k) => signals[k]);
-      const choices = [
-        { key: "1", value: "claude", label: "Claude Code", hint: signals.claude ? dim("(detected)") : "" },
-        { key: "2", value: "cursor", label: "Cursor", hint: signals.cursor ? dim("(detected)") : "" },
-        { key: "3", value: "gemini", label: "Gemini CLI", hint: signals.gemini ? dim("(detected)") : dim("(beta \u2014 limited)") }
-      ];
+      const detected = ["claude", "cursor", "gemini", "vscode"].filter((k) => signals[k]);
       let defaultValue = "claude";
       if (detected.length === 1) defaultValue = detected[0];
-      const readline = require("readline");
-      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-      const prompt = (q) => new Promise((r) => rl.question(q, (a) => r(a)));
-      console.log(pc.bold("\u{1F3AF} Which editor will you use Rihal with?"));
-      console.log("");
-      for (const c of choices) {
-        const marker = c.value === defaultValue ? pc.green("\u25CF") : dim("\u25CB");
-        const label = c.value === defaultValue ? pc.bold(c.label) : c.label;
-        console.log(`   ${marker} ${pc.cyan("[" + c.key + "]")} ${label}  ${c.hint}`);
+      const choice = await clack.select({
+        message: "\u{1F3AF} Which editor will you use rcode with?",
+        initialValue: defaultValue,
+        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/)" }
+        ]
+      });
+      if (clack.isCancel(choice)) {
+        clack.cancel("Install cancelled.");
+        process.exit(0);
       }
-      console.log("");
-      const defaultKey = choices.find((c) => c.value === defaultValue).key;
-      const answer = (await prompt(`   Pick an editor [${defaultKey}]: `)).trim().toLowerCase();
-      rl.close();
-      if (!answer) return defaultValue;
-      const byKey = choices.find((c) => c.key === answer);
-      if (byKey) return byKey.value;
-      const byName = choices.find((c) => c.value === answer || c.label.toLowerCase().startsWith(answer));
-      if (byName) return byName.value;
-      console.log(dim(`   Unrecognised choice "${answer}" \u2014 falling back to ${defaultValue}.`));
-      return defaultValue;
+      return choice;
     }
     async function resolveCommitPlanning(opts) {
       if (opts.commitPlanning !== null) return opts.commitPlanning;
       if (opts.yes || !process.stdin.isTTY) return true;
-      const readline = require("readline");
-      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-      const prompt = (q) => new Promise((r) => rl.question(q, (a) => r(a)));
-      console.log("");
-      console.log("\u{1F4CB} .planning/ holds PRDs, roadmaps, sprints, SUMMARY files.");
-      console.log("   Commit them to git, or keep them local?");
-      console.log("");
-      console.log("   [Y] Commit \u2014 collaborators see the same plans  (default, recommended)");
-      console.log("   [n] Gitignore \u2014 planning stays local  (good for sensitive PRDs)");
-      console.log("");
-      const answer = (await prompt("   Commit planning artifacts? [Y/n]: ")).trim().toLowerCase();
-      rl.close();
-      return !(answer === "n" || answer === "no");
+      const choice = await clack.select({
+        message: "\u{1F4CB} .planning/ holds PRDs, roadmaps, sprints, SUMMARY files. How should they be tracked?",
+        initialValue: "commit",
+        options: [
+          { value: "commit", label: "Commit", hint: "collaborators see the same plans (recommended)" },
+          { value: "gitignore", label: "Gitignore", hint: "planning stays local (good for sensitive PRDs)" }
+        ]
+      });
+      if (clack.isCancel(choice)) {
+        clack.cancel("Install cancelled.");
+        process.exit(0);
+      }
+      return choice === "commit";
     }
     function printHelp2() {
       console.log(`
@@ -16791,6 +16787,7 @@ Say "plan a sprint" or run \`/rihal:sprint-planning\` to break Phase 01 into sto
       let preserved = 0;
       const preservedFiles = [];
       const preservedDiffs = [];
+      const conflictedFiles = [];
       const spinner = createSpinner(dim(`Installing ${plan.length} files\u2026`), { color: "cyan" }).start();
       for (const entry of plan) {
         const destPath = path2.join(opts.target, entry.rel);
@@ -16825,9 +16822,13 @@ Say "plan a sprint" or run \`/rihal:sprint-planning\` to break Phase 01 into sto
             continue;
           }
           if (!opts.yes && !opts.nonDestructive) {
-            spinner.stop();
-            console.warn("  " + warn(`${entry.rel} differs from package version \u2014 use --force-overwrite to overwrite`));
-            spinner.start();
+            conflictedFiles.push({
+              rel: relForward,
+              src: entry.src,
+              destPath,
+              existingContent: fs2.readFileSync(destPath, "utf8"),
+              sourceContent: fs2.readFileSync(entry.src, "utf8")
+            });
             skipped++;
             continue;
           }
@@ -16846,6 +16847,96 @@ Say "plan a sprint" or run \`/rihal:sprint-planning\` to break Phase 01 into sto
         copied++;
       }
       spinner.success({ text: ok(`${copied} files installed`) });
+      if (conflictedFiles.length > 0) {
+        const byCategory = { workflows: [], agents: [], commands: [], skills: [], references: [], other: [] };
+        for (const c of conflictedFiles) {
+          if (c.rel.includes("/workflows/")) byCategory.workflows.push(c);
+          else if (c.rel.includes("/agents/")) byCategory.agents.push(c);
+          else if (c.rel.includes("/commands/")) byCategory.commands.push(c);
+          else if (c.rel.includes("/skills/")) byCategory.skills.push(c);
+          else if (c.rel.includes("/references/")) byCategory.references.push(c);
+          else byCategory.other.push(c);
+        }
+        console.log("");
+        console.log("  " + warn(`${conflictedFiles.length} file${conflictedFiles.length === 1 ? "" : "s"} have local edits AND v${readPackageVersion()} updates:`));
+        for (const [cat, list] of Object.entries(byCategory)) {
+          if (list.length === 0) continue;
+          console.log("    " + dim(`${list.length} ${cat}`));
+        }
+        console.log("");
+        if (!opts.yes && process.stdin.isTTY) {
+          const action = await clack.select({
+            message: "How should we handle these?",
+            initialValue: "review",
+            options: [
+              { value: "review", label: "Review each one", hint: "see the diff, decide per file" },
+              { value: "upstream", label: "Take v" + readPackageVersion() + " for all", hint: "lose local edits, get all bug fixes" },
+              { value: "keep", label: "Keep my local edits", hint: "skip v" + readPackageVersion() + " updates for these files (current behaviour)" }
+            ]
+          });
+          if (clack.isCancel(action)) {
+            clack.note("Skipped \u2014 local edits preserved.");
+          } else if (action === "upstream") {
+            let applied = 0;
+            for (const c of conflictedFiles) {
+              fs2.writeFileSync(c.destPath, c.sourceContent, "utf8");
+              applied++;
+            }
+            console.log("  " + ok(`Applied v${readPackageVersion()} to ${applied} file${applied === 1 ? "" : "s"}.`));
+          } else if (action === "review") {
+            let applied = 0, kept = 0;
+            for (const c of conflictedFiles) {
+              const patch = createTwoFilesPatch(c.rel, c.rel, c.existingContent, c.sourceContent, "local", "v" + readPackageVersion());
+              let ins = 0, del = 0;
+              for (const line of patch.split("\n")) {
+                if (line.startsWith("+") && !line.startsWith("+++")) ins++;
+                if (line.startsWith("-") && !line.startsWith("---")) del++;
+              }
+              console.log("");
+              console.log("  " + pc.bold(c.rel) + dim("  ") + pc.green(`+${ins}`) + " " + pc.red(`-${del}`));
+              const decision = await clack.select({
+                message: "Take upstream, keep local, or view diff?",
+                initialValue: "view",
+                options: [
+                  { value: "upstream", label: "Take v" + readPackageVersion() },
+                  { value: "keep", label: "Keep local" },
+                  { value: "view", label: "View diff first" }
+                ]
+              });
+              let finalAction = decision;
+              if (clack.isCancel(decision) || decision === "view") {
+                for (const line of patch.split("\n").slice(4)) {
+                  if (line.startsWith("+")) process.stdout.write(pc.green(line) + "\n");
+                  else if (line.startsWith("-")) process.stdout.write(pc.red(line) + "\n");
+                  else if (line.startsWith("@")) process.stdout.write(pc.cyan(line) + "\n");
+                  else process.stdout.write(dim(line) + "\n");
+                }
+                const after = await clack.select({
+                  message: "Now: take upstream or keep local?",
+                  initialValue: "keep",
+                  options: [
+                    { value: "upstream", label: "Take v" + readPackageVersion() },
+                    { value: "keep", label: "Keep local" }
+                  ]
+                });
+                finalAction = clack.isCancel(after) ? "keep" : after;
+              }
+              if (finalAction === "upstream") {
+                fs2.writeFileSync(c.destPath, c.sourceContent, "utf8");
+                applied++;
+              } else {
+                kept++;
+              }
+            }
+            console.log("  " + ok(`Review complete: ${applied} applied, ${kept} kept local.`));
+          } else {
+            console.log("  " + dim(`${conflictedFiles.length} file${conflictedFiles.length === 1 ? "" : "s"} kept local. Re-run with --force-overwrite or 'rcode update' anytime.`));
+          }
+        } else {
+          console.log("  " + dim(`Re-run with --force-overwrite to apply v${readPackageVersion()} updates, or pipe through an interactive shell to resolve per-file.`));
+        }
+        console.log("");
+      }
       const configDir = path2.join(opts.target, ".rihal", "_config");
       ensureDir(configDir);
       fs2.writeFileSync(path2.join(configDir, "manifest.yaml"), generateInstallManifest(opts));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "2.8.0",
-  "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.",
+  "version": "3.2.0",
+  "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": {
     "rcode": "dist/rcode.js",

package/rihal/agents/rihal-advisor-researcher.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-advisor-researcher
 description: Researches a single gray area decision and returns a structured comparison table with rationale. Spawned by discuss-phase advisor mode.
-tools: read_file, run_shell_command, search_file_content, glob, google_web_search, web_fetch
+tools: Read, Bash, Grep, Glob, WebSearch, WebFetch
 color: cyan
 ---
 

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

@@ -1,7 +1,7 @@
 ---
 name: rihal-assumptions-analyzer
 description: Deeply analyzes codebase for a phase and returns structured assumptions with evidence. Spawned by discuss-phase assumptions mode.
-tools: read_file, run_shell_command, search_file_content, glob
+tools: Read, Bash, Grep, Glob
 color: cyan
 ---
 

package/rihal/agents/rihal-codebase-mapper.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-codebase-mapper
 description: Explores codebase and writes structured analysis documents. Spawned by map-codebase with a focus area (tech, arch, quality, concerns). Writes documents directly to reduce orchestrator context load.
-tools: read_file, run_shell_command, search_file_content, glob, write_file
+tools: Read, Bash, Grep, Glob, Write
 color: cyan
 ---
 

package/rihal/agents/rihal-docs-auditor.md

@@ -15,7 +15,7 @@ You are the **Documentation Auditor** at Rihal. You are spawned to audit documen
 
 ## Who you are
 
-Documentation quality specialist. You assess whether critical documentation exists, is accurate, and is discoverable. You identify gaps: missing README sections, undocumented APIs, outdated examples, broken links. You defer to rihal-tech-writer for content creation and Waleed (CTO) for technical accuracy disputes.
+Documentation quality specialist. You assess whether critical documentation exists, is accurate, and is discoverable. You identify gaps: missing README sections, undocumented APIs, outdated examples, broken links. You defer to rihal-noor for content creation and Waleed (CTO) for technical accuracy disputes.
 
 You do not write documentation. You audit and flag issues.
 
@@ -63,9 +63,9 @@ Structured: Coverage summary → Missing docs → Accuracy gaps → Quality issu
 
 Use command-redirect-format.md. One reason, then command.
 
-- Documentation writing → rihal-tech-writer
+- Documentation writing → rihal-noor
 - Technical accuracy verification → Waleed (CTO)
-- Content updates → rihal-tech-writer
+- Content updates → rihal-noor
 
 ## Constraints
 

package/rihal/agents/rihal-executor.md

@@ -17,6 +17,16 @@ Rihal sprint executor. Execute SPRINT.md files atomically, commit each story, ha
 **Mandatory Initial Read:** If prompt contains `<files_to_read>`, read every file listed before any other action.
 </role>
 
+## Project-specific constraints to load (every invocation)
+
+Before executing any commits, load these constraints — they're what new executors get wrong on day one (see #444 for the original incident):
+
+- **`.planning/` may be gitignored.** Many Rihal-style projects gitignore the planning directory. To commit SUMMARY.md, VERIFICATION.md, or any other artefact under `.planning/`, you must use `git add -f <path>`. Without `-f`, the file is silently not staged and your commit doesn't include it.
+- **Read `.rihal/config.yaml`** — if `workflow.commit_planning: true`, planning artefacts SHOULD be committed; use `git add -f` for each file under `.planning/`. If `commit_planning: false`, skip the commit step for those files entirely.
+- **Read `.rihal/context/active.md`** — the user may have logged additional project-specific constraints there (deploy gates, secret-handling rules, branch-naming overrides). Honour them.
+
+If you commit a file under `.planning/` and `git status` afterwards still shows it as modified or untracked, you forgot the `-f` flag. Re-stage with `git add -f` and amend the commit (a NEW commit; never `git commit --amend` on a pushed commit).
+
 ## Execution Flow (Slim)
 
 1. **Load state** — Extract executor config, phase info, sprint list. Read STATE.md for position/blockers.

package/rihal/agents/rihal-integration-checker.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-integration-checker
 description: Verifies cross-phase integration and E2E flows. Checks that phases connect properly and user workflows complete end-to-end.
-tools: read_file, run_shell_command, search_file_content, glob
+tools: Read, Bash, Grep, Glob
 color: blue
 ---
 

package/rihal/agents/rihal-noor.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-noor
-description: Technical Writer & Presentation Lead — spawned by /rihal:council for documentation, README files, API docs, architecture diagrams (Mermaid), changelogs, pitch decks, and blog posts. Defers to Hussain-PM on PRD content, Hanzla on code implementation details, Sadiq on strategic framing.
-tools: Read, Grep, Glob, Bash, WebFetch
+description: Technical Writer & Presentation Lead — spawned by /rihal:council and /rihal:docs-update for README files, API docs, architecture diagrams (Mermaid), changelogs, migration guides, inline code comments, pitch decks, and blog posts. Defers to Hussain-PM on PRD content, Hanzla on code implementation details, Sadiq on strategic framing.
+tools: Read, Write, Edit, Grep, Glob, Bash, WebFetch
 color: teal
 ---
 

package/rihal/agents/rihal-phase-researcher.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-phase-researcher
 description: Researches how to implement a phase before planning. Produces RESEARCH.md consumed by rihal-planner. Spawned by /rihal:plan orchestrator.
-tools: read_file, write_file, run_shell_command, search_file_content, glob, google_web_search, web_fetch
+tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch
 color: cyan
 ---
 

package/rihal/agents/rihal-planner.md

@@ -116,6 +116,31 @@ else: wave = max(waves of dependencies) + 1
 
 **File ownership:** No overlap in files_modified → can run parallel. Overlap → later depends on earlier.
 
+## File-existence verification (BLOCKER — added in v3.1.0 after #441)
+
+Before writing each entry into `files_modified`, you MUST verify the file actually exists in the project. Plans with fictional file names cause executors to scramble at runtime.
+
+For every candidate path:
+
+```bash
+# Try the exact name first
+test -f "<candidate>" && echo "OK" && exit 0
+
+# Then try a fuzzy match for renamed/moved files
+find . -type f \( -name "<basename>" -o -iname "*$<short-slug>*" \) \
+  -not -path './node_modules/*' -not -path './.git/*' 2>/dev/null
+```
+
+Apply these rules to every path you put in `files_modified`:
+
+- **Exact match exists** → use the verified path verbatim
+- **No exact match, fuzzy match found** → use the fuzzy match's path AND log a note in the SPRINT.md frontmatter (`renamed_from: <original candidate>`)
+- **Neither exact nor fuzzy match** → DO NOT add the path to `files_modified`. Either:
+  - Mark it as a CREATE story (the executor will create the file fresh) — set `creates: [<path>]` in the story body
+  - OR raise a BLOCKER finding for sprint-checker to surface: file referenced by name but not present and not flagged for creation
+
+Sprint-checker enforces this — see `rihal-sprint-checker.md` Mandatory Output Markers section. Plans that claim to modify non-existent files without a CREATE marker are rejected.
+
 ## Plan Structure
 
 ```markdown

package/rihal/agents/rihal-project-researcher.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-project-researcher
 description: Researches domain ecosystem before roadmap creation. Produces files in .rihal/research/ consumed during roadmap creation. Spawned by /rihal:new-project or /rihal:new-milestone orchestrators.
-tools: read_file, write_file, run_shell_command, search_file_content, glob, google_web_search, web_fetch
+tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch
 color: cyan
 ---
 

package/rihal/agents/rihal-research-synthesizer.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-research-synthesizer
 description: Synthesizes research outputs from parallel researcher agents into SUMMARY.md. Spawned by /rihal:new-project after 4 researcher agents complete.
-tools: read_file, write_file, run_shell_command
+tools: Read, Write, Bash
 color: purple
 ---
 

package/rihal/agents/rihal-roadmapper.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-roadmapper
 description: Creates project roadmaps with phase breakdown, requirement mapping, success criteria derivation, and coverage validation. Spawned by /rihal:new-project orchestrator.
-tools: read_file, write_file, run_shell_command, glob, search_file_content
+tools: Read, Write, Bash, Glob, Grep
 color: purple
 ---
 

package/rihal/agents/rihal-sprint-checker.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-sprint-checker
 description: Verifies sprints will achieve phase goal before execution. Goal-backward analysis of sprint quality. Spawned by /rihal:plan orchestrator.
-tools: read_file, run_shell_command, glob, search_file_content
+tools: Read, Bash, Glob, Grep
 color: green
 ---
 
@@ -108,6 +108,24 @@ Each dimension has pass/partial/fail criteria, remediation guidance, and output
 3. **Synthesize** — Produce CHECK.md with overall verdict, per-dimension scores, remediation asks.
 4. **Return** — Block execution if critical dimensions fail; proceed with cautions if only partials.
 
+## Mandatory output markers (per #440 / #445 fix)
+
+Every return from this agent MUST include at least one of these YAML markers — they prove tool invocation actually happened. The orchestrator's malfunction guard in `plan.md` blocks execution if none are present.
+
+```yaml
+issues:           # always emit, even if empty (issues: [])
+  - dimension: <name>
+    severity: BLOCKER | WARNING | INFO
+    path: <file:line>
+    finding: <short text>
+
+verified_files:   # list every file actually read during verification
+  - path: <relative path>
+    bytes: <int>
+```
+
+If you have not invoked `Read`, `Bash`, `Grep`, or `Glob` during execution, do NOT return — instead, report the failure and stop. Empty narrative output is treated as malfunction, not pass.
+
 ## On-Demand Rule Files
 
 | When you need... | Read |

package/rihal/agents/rihal-verifier.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-verifier
 description: Verifies phase goal achievement through goal-backward analysis. Checks codebase delivers what phase promised, not just that tasks completed. Creates VERIFICATION.md report.
-tools: read_file, write_file, run_shell_command, search_file_content, glob
+tools: Read, Write, Bash, Grep, Glob
 color: green
 ---
 

package/rihal/agents/rihal-waleed.md

@@ -43,7 +43,7 @@ Precise. Quantified. Trade-off oriented. Every claim cites a number, a constrain
 | Code | Description | Skill / workflow |
 |------|-------------|------------------|
 | ADR  | Write a single Architecture Decision Record | rihal-create-architecture |
-| RV   | Review existing architecture against current code | rihal-architect |
+| RV   | Review existing architecture against current code | inline |
 | TS   | Stack selection — 2-3 options + recommendation | inline |
 | FZ   | Feasibility check — can the current stack handle this? | inline |
 | KS   | Kill-switch design — exit criteria, sunset plan | inline |
@@ -64,7 +64,6 @@ Always read on activation:
 - Test / QA → Fatima
 - Backend impl detail → Yousef
 - Frontend → Haitham
-- Greenfield system design / multi-team org bets → rihal-architect (senior tier)
 
 ## Constraints (Waleed-specific)
 

package/rihal/commands/code-review.md

@@ -1,7 +1,7 @@
 ---
 name: rihal:code-review
 description: Review source files for bugs, security issues, and code quality problems.
-argument-hint: "<phase> [--depth=quick|standard|deep] [--files=file1,file2,...]"
+argument-hint: "<phase> [--depth=quick|standard|deep] [--files=file1,file2,...] [--karpathy] [--attack] [--edge-cases]"
 allowed-tools:
   - Read
   - Grep

package/rihal/commands/memory-audit.md

@@ -0,0 +1,10 @@
+---
+name: rcode:memory-audit
+description: Audit the Memory Bank for stale entries, contradictions, and unfilled placeholders — read-only report
+argument-hint: "[--severity {critical|warn|info}]"
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rihal/workflows/memory-audit.md

package/rihal/commands/memory-distill.md

@@ -0,0 +1,11 @@
+---
+name: rcode:memory-distill
+description: Regenerate Memory Bank distillates — token-optimised lossless compressions for fast LLM context loading
+argument-hint: "[--force] [--target {project|stack|all}]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+@.rihal/workflows/memory-distill.md

package/rihal/commands/memory-init.md

@@ -0,0 +1,12 @@
+---
+name: rcode:memory-init
+description: Bootstrap the rcode Memory Bank for this project — copies templates, asks 5 questions, populates seed files
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+@.rihal/workflows/memory-init.md

package/rihal/commands/memory-update.md

@@ -0,0 +1,12 @@
+---
+name: rcode:memory-update
+description: Append a decision, known issue, stakeholder, or milestone update to the Memory Bank from conversation context
+argument-hint: "<content>"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+@.rihal/workflows/memory-update.md

package/rihal/config/model-profiles.json

@@ -41,7 +41,7 @@
         "ux-designer": "sonnet",
         "doc-verifier": "haiku",
         "docs-auditor": "haiku",
-        "tech-writer": "haiku"
+        "noor": "haiku"
       }
     },
 
@@ -82,7 +82,7 @@
         "ux-designer": "sonnet",
         "doc-verifier": "haiku",
         "docs-auditor": "haiku",
-        "tech-writer": "haiku"
+        "noor": "haiku"
       }
     },
 
@@ -123,7 +123,7 @@
         "ux-designer": "haiku",
         "doc-verifier": "haiku",
         "docs-auditor": "haiku",
-        "tech-writer": "haiku"
+        "noor": "haiku"
       }
     },
 
@@ -164,7 +164,7 @@
         "ux-designer": "inherit",
         "doc-verifier": "inherit",
         "docs-auditor": "inherit",
-        "tech-writer": "inherit"
+        "noor": "inherit"
       }
     }
   },
@@ -197,7 +197,7 @@
       "model_overrides": {
         "waleed": "opus",
         "code-reviewer": "sonnet",
-        "tech-writer": "inherit"
+        "noor": "inherit"
       }
     }
   },

package/rihal/references/karpathy-guidelines-full.md

@@ -69,7 +69,7 @@ Strong success criteria let you loop independently. Weak criteria ("make it work
 
 ## Enforcement
 
-Agents that write or modify code (rihal-executor, rihal-planner, rihal-tech-writer, rihal-codebase-mapper when producing code docs) must:
+Agents that write or modify code (rihal-executor, rihal-planner, rihal-noor, rihal-codebase-mapper when producing code docs) must:
 1. @-include this file
 2. Apply the 4 principles as hard constraints, not suggestions
 3. Reference the specific principle when refusing to make a change (e.g., "Declining per Karpathy #3: that's adjacent to the requested change but not part of it")

package/rihal/references/no-unauthorized-git-ops.md

@@ -60,7 +60,7 @@ Spawn the debug agent with git worktree isolation?
 
 ## Agent enforcement
 
-Every Rihal agent that can execute shell commands (rihal-executor, rihal-debugger, rihal-planner, rihal-tech-writer, etc.) must:
+Every Rihal agent that can execute shell commands (rihal-executor, rihal-debugger, rihal-planner, rihal-noor, etc.) must:
 
 1. Reject any prompt asking them to perform a banned operation without a prior user-confirmed authorization in their input
 2. Surface a warning if a parent workflow or user prompt tries to include a banned flag

package/rihal/references/verb-dictionary.md

@@ -87,7 +87,7 @@ These are matched alongside §Create / §Add / §Plan verbs to determine the dis
 | plan (verb form — "plan phase N") | `plan` | `/rihal:plan` |
 | story (impl) | `dev story`, `implement story`, `build story` | `/rihal:dev-story` |
 | brainstorm | `brainstorm`, `ideas`, `sochain`, `sochna` | `/rihal:brainstorm` |
-| review (code) | `code review`, `karpathy`, `check my diff` | `/rihal:karpathy-audit` / `/rihal:code-review` |
+| review (code) | `code review`, `karpathy`, `check my diff` | `/rihal:code-review [--karpathy]` |
 | debug | `debug`, `fix`, `bug`, `error`, `crash`, `kharab`, `theek` | `/rihal:debug` |
 
 ---