@hanzlaa/rcode 2.1.0

package/rihal/commands/review-edge-case-hunter.md

@@ -0,0 +1,8 @@
+---
+name: rihal:review-edge-case-hunter
+description: Enumerate edge cases by category (input, state, concurrency, network) with severity (critical/high/medium/low). Callable inline during code-review.md. Output feeds into story AC or subtasks.
+argument-hint: "[--phase <name>] [--component <name>]"
+allowed-tools: Read, Glob, Grep, Agent
+---
+
+@.rihal/workflows/review-edge-case-hunter.md

package/rihal/commands/review.md

@@ -0,0 +1,18 @@
+---
+name: rihal:review
+description: Cross-AI peer review — invoke external AI CLIs to independently review phase plans.
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Cross-AI peer review — invoke external AI CLIs to independently review phase plans.
+</objective>
+
+<execution_context>
+@.rihal/workflows/review.md
+</execution_context>
+
+<process>
+Execute the review workflow from @.rihal/workflows/review.md end-to-end.
+</process>

package/rihal/commands/scan.md

@@ -0,0 +1,14 @@
+---
+name: rihal:scan
+description: Rapid codebase assessment — lightweight alternative to map-codebase.
+argument-hint: "[--focus <area>]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+@.rihal/workflows/scan.md

package/rihal/commands/secure-phase.md

@@ -0,0 +1,14 @@
+---
+name: rihal:secure-phase
+description: Retroactively verify threat mitigations for a completed phase.
+argument-hint: "<phase>"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+@.rihal/workflows/secure-phase.md

package/rihal/commands/session-report.md

@@ -0,0 +1,10 @@
+---
+name: rihal:session-report
+description: Generate a session report with work summary, token usage estimation, commits, decisions, and open blockers
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rihal/workflows/session-report.md

package/rihal/commands/settings.md

@@ -0,0 +1,8 @@
+---
+name: rihal:settings
+description: Interactive configuration wizard for Rihal project settings. Update model profile, research strategy, execution gates, and branching strategy.
+argument-hint: ""
+allowed-tools: Read, Write, Bash, AskUserQuestion
+---
+
+@.rihal/workflows/settings.md

package/rihal/commands/ship.md

@@ -0,0 +1,18 @@
+---
+name: rihal:ship
+description: Execute ship workflow
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute ship workflow
+</objective>
+
+<execution_context>
+@.rihal/workflows/ship.md
+</execution_context>
+
+<process>
+Execute the ship workflow from @.rihal/workflows/ship.md end-to-end.
+</process>

package/rihal/commands/show.md

@@ -0,0 +1,10 @@
+---
+name: rihal:show
+description: Print a plan or phase in full with execution status
+argument-hint: <id>
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rihal/workflows/show.md

package/rihal/commands/sprint-planning.md

@@ -0,0 +1,20 @@
+---
+name: rihal:sprint-planning
+description: Plan the next sprint — compute capacity, prioritize stories, create SPRINT.md, register in state.
+argument-hint: "[--phase <NN>] [--velocity <points>] [--goal 'Sprint goal']"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Plan a sprint end-to-end: load phase scope, compute capacity from velocity history, curate stories with user, create SPRINT.md, register sprint + stories in state.json, start the sprint.
+</objective>
+
+<execution_context>
+@.rihal/workflows/sprint-planning.md
+</execution_context>
+
+<process>
+Execute the sprint-planning workflow from @.rihal/workflows/sprint-planning.md end-to-end.
+Use rihal-tools.cjs for state operations (sprint add, story add, sprint start, sprint velocity).
+Present story table to user for confirmation before committing to sprint.
+</process>

package/rihal/commands/sprint-status.md

@@ -0,0 +1,21 @@
+---
+name: rihal:sprint-status
+description: Show current sprint progress — stories, points, velocity, burndown. Quick view of where the sprint stands.
+argument-hint: "[--sprint <NN.S>]"
+allowed-tools:
+  - Bash
+  - Read
+---
+
+<objective>
+Display current sprint status board: stories by status, points done vs remaining, velocity comparison, and actionable next-step recommendation.
+</objective>
+
+<execution_context>
+@.rihal/workflows/sprint-status.md
+</execution_context>
+
+<process>
+Execute the sprint-status workflow from @.rihal/workflows/sprint-status.md end-to-end.
+Load sprint data from state.json via rihal-tools.cjs, display compact board, suggest next action.
+</process>

package/rihal/commands/stats.md

@@ -0,0 +1,10 @@
+---
+name: rihal:stats
+description: Show project statistics from state.json — phases, plans, decisions, council sessions, timeline
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rihal/workflows/stats.md

package/rihal/commands/status.md

@@ -0,0 +1,21 @@
+---
+name: rihal:status
+description: Print current project state — phase, plan progress, recent decisions, blockers, last council session
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Bash
+---
+
+<objective>
+Print current project state dashboard — phase, sprint progress, recent decisions, blockers, last council session.
+</objective>
+
+<execution_context>
+@.rihal/workflows/status.md
+</execution_context>
+
+<process>
+Execute the status workflow from @.rihal/workflows/status.md end-to-end.
+Read state.json and display formatted dashboard.
+</process>

package/rihal/commands/ui-phase.md

@@ -0,0 +1,8 @@
+---
+name: rihal:ui-phase
+description: Produce UI-SPEC.md with color tokens, typography, component inventory, interaction states, and accessibility guidelines. Detects frontend keywords and suggests this command early in plan.md if UI-SPEC.md is absent.
+argument-hint: "[--existing-ui <path>] [--design-system <path>]"
+allowed-tools: Agent, Read, Glob, Grep, Write
+---
+
+@.rihal/workflows/ui-phase.md

package/rihal/commands/ui-review.md

@@ -0,0 +1,8 @@
+---
+name: rihal:ui-review
+description: Retroactive 6-pillar visual audit of completed UI work. Validates color consistency, typography, component completeness, accessibility, responsive behavior, and design coherence.
+argument-hint: "[--phase <name>] [--detailed]"
+allowed-tools: Agent, Read, Glob, Grep, Bash
+---
+
+@.rihal/workflows/ui-review.md

package/rihal/commands/undo.md

@@ -0,0 +1,14 @@
+---
+name: rihal:undo
+description: Safe git revert — roll back phase or plan commits with dependency checks.
+argument-hint: "--last N | --phase NN [--to-snapshot] | --plan NN-MM"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+@.rihal/workflows/undo.md

package/rihal/commands/update.md

@@ -0,0 +1,11 @@
+---
+name: rihal:update
+description: Check for rihal-code package updates and apply them with changelog preview
+argument-hint: "[--no-confirm]"
+allowed-tools:
+  - Read
+  - Bash
+  - AskUserQuestion
+---
+
+@.rihal/workflows/update.md

package/rihal/commands/validate-phase.md

@@ -0,0 +1,18 @@
+---
+name: rihal:validate-phase
+description: Audit Nyquist validation gaps for a completed phase. Generate missing tests. Update VALIDATION.md.
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Audit Nyquist validation gaps for a completed phase. Generate missing tests. Update VALIDATION.md.
+</objective>
+
+<execution_context>
+@.rihal/workflows/validate-phase.md
+</execution_context>
+
+<process>
+Execute the validate-phase workflow from @.rihal/workflows/validate-phase.md end-to-end.
+</process>

package/rihal/commands/verify-phase.md

@@ -0,0 +1,18 @@
+---
+name: rihal:verify-phase
+description: Verify phase goal achievement through goal-backward analysis. Check that the codebase delivers what the phase promised, 
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Verify phase goal achievement through goal-backward analysis. Check that the codebase delivers what the phase promised, 
+</objective>
+
+<execution_context>
+@.rihal/workflows/verify-phase.md
+</execution_context>
+
+<process>
+Execute the verify-phase workflow from @.rihal/workflows/verify-phase.md end-to-end.
+</process>

package/rihal/commands/verify-work.md

@@ -0,0 +1,19 @@
+---
+name: rihal:verify-work
+description: Conversational acceptance testing — verify sprint stories against acceptance criteria
+argument-hint: "[--phase <NN>]"
+allowed-tools: Read, Bash, Grep, Glob, AskUserQuestion
+---
+
+<objective>
+Run conversational UAT against completed sprint stories. Verify each story's acceptance criteria are met in the actual codebase. Closes the plan→execute→VERIFY loop.
+</objective>
+
+<execution_context>
+@.rihal/workflows/verify-work.md
+</execution_context>
+
+<process>
+Execute the verify-work workflow from @.rihal/workflows/verify-work.md end-to-end.
+Load sprint stories, check acceptance criteria against codebase, report pass/fail per story.
+</process>

package/rihal/commands/why.md

@@ -0,0 +1,10 @@
+---
+name: rihal:why
+description: Explain the reasoning behind a decision, classification, or panel selection
+argument-hint: <topic-or-question>
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rihal/workflows/why.md

package/rihal/commands/workstream.md

@@ -0,0 +1,11 @@
+---
+name: rihal:workstream
+description: Manage parallel workstreams (milestone tracks). Create, switch, list, or complete workstreams in state.json.
+argument-hint: "<subcommand> [--name <name>]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+@.rihal/workflows/workstream.md

package/rihal/config/model-profiles.json

@@ -0,0 +1,226 @@
+{
+  "$schema": "./model-profiles.schema.json",
+  "version": "2.0.0",
+  "description": "Model profiles for Rihal Code agents (v1.0-beta). Each profile maps every agent to a specific model tier. Switch profiles at runtime to balance quality vs cost vs runtime compatibility.",
+
+  "profiles": {
+    "quality": {
+      "description": "Maximum reasoning power. Opus for all decision-making and research agents, Sonnet for execution and review, Haiku for summary tasks. Use when: quota available, critical architecture work, strategic demos.",
+      "agents": {
+        "sadiq": "opus",
+        "waleed": "opus",
+        "hussain-pm": "opus",
+        "mariam": "opus",
+        "fatima": "sonnet",
+        "planner": "opus",
+        "architect": "opus",
+        "sprint-checker": "opus",
+        "roadmapper": "opus",
+        "advisor-researcher": "opus",
+        "phase-researcher": "opus",
+        "project-researcher": "opus",
+        "codebase-mapper": "opus",
+        "assumptions-analyzer": "opus",
+        "profiler": "opus",
+        "research-synthesizer": "opus",
+        "edge-case-hunter": "opus",
+        "executor": "sonnet",
+        "code-fixer": "sonnet",
+        "doc-writer": "sonnet",
+        "remediation-planner": "sonnet",
+        "verifier": "sonnet",
+        "code-reviewer": "sonnet",
+        "debugger": "sonnet",
+        "deviation-analyzer": "sonnet",
+        "security-auditor": "sonnet",
+        "security-adversary": "sonnet",
+        "integration-checker": "sonnet",
+        "nyquist-auditor": "sonnet",
+        "ui-auditor": "sonnet",
+        "ui-designer": "sonnet",
+        "ux-designer": "sonnet",
+        "doc-verifier": "haiku",
+        "docs-auditor": "haiku",
+        "tech-writer": "haiku"
+      }
+    },
+
+    "balanced": {
+      "description": "Smart allocation (default). Opus only for deep-reasoning agents — strategists, CTO, planning, research. Sonnet for execution and structured work. Haiku for high-volume summaries. Use when: normal day-to-day development.",
+      "agents": {
+        "sadiq": "opus",
+        "waleed": "opus",
+        "hussain-pm": "opus",
+        "mariam": "sonnet",
+        "fatima": "sonnet",
+        "planner": "opus",
+        "architect": "opus",
+        "sprint-checker": "sonnet",
+        "roadmapper": "sonnet",
+        "advisor-researcher": "sonnet",
+        "phase-researcher": "sonnet",
+        "project-researcher": "sonnet",
+        "codebase-mapper": "sonnet",
+        "assumptions-analyzer": "sonnet",
+        "profiler": "sonnet",
+        "research-synthesizer": "sonnet",
+        "edge-case-hunter": "sonnet",
+        "executor": "sonnet",
+        "code-fixer": "sonnet",
+        "doc-writer": "haiku",
+        "remediation-planner": "sonnet",
+        "verifier": "sonnet",
+        "code-reviewer": "sonnet",
+        "debugger": "sonnet",
+        "deviation-analyzer": "sonnet",
+        "security-auditor": "sonnet",
+        "security-adversary": "sonnet",
+        "integration-checker": "sonnet",
+        "nyquist-auditor": "sonnet",
+        "ui-auditor": "sonnet",
+        "ui-designer": "sonnet",
+        "ux-designer": "sonnet",
+        "doc-verifier": "haiku",
+        "docs-auditor": "haiku",
+        "tech-writer": "haiku"
+      }
+    },
+
+    "budget": {
+      "description": "Minimum cost. Sonnet for reasoning agents, Haiku for everything else. Use when: pricing constraints, experiments, prototyping.",
+      "agents": {
+        "sadiq": "sonnet",
+        "waleed": "sonnet",
+        "hussain-pm": "sonnet",
+        "mariam": "haiku",
+        "fatima": "haiku",
+        "planner": "sonnet",
+        "architect": "sonnet",
+        "sprint-checker": "haiku",
+        "roadmapper": "haiku",
+        "advisor-researcher": "haiku",
+        "phase-researcher": "haiku",
+        "project-researcher": "haiku",
+        "codebase-mapper": "haiku",
+        "assumptions-analyzer": "haiku",
+        "profiler": "haiku",
+        "research-synthesizer": "haiku",
+        "edge-case-hunter": "haiku",
+        "executor": "haiku",
+        "code-fixer": "haiku",
+        "doc-writer": "haiku",
+        "remediation-planner": "haiku",
+        "verifier": "haiku",
+        "code-reviewer": "haiku",
+        "debugger": "haiku",
+        "deviation-analyzer": "haiku",
+        "security-auditor": "haiku",
+        "security-adversary": "haiku",
+        "integration-checker": "haiku",
+        "nyquist-auditor": "haiku",
+        "ui-auditor": "haiku",
+        "ui-designer": "haiku",
+        "ux-designer": "haiku",
+        "doc-verifier": "haiku",
+        "docs-auditor": "haiku",
+        "tech-writer": "haiku"
+      }
+    },
+
+    "inherit": {
+      "description": "Follow the current session model. All agents resolve to 'inherit'. Best when you switch models interactively (e.g., OpenCode /model command) or when using non-Anthropic providers (OpenRouter, local models) — otherwise Rihal Code may call Anthropic models directly, incurring unexpected costs.",
+      "agents": {
+        "sadiq": "inherit",
+        "waleed": "inherit",
+        "hussain-pm": "inherit",
+        "mariam": "inherit",
+        "fatima": "inherit",
+        "planner": "inherit",
+        "architect": "inherit",
+        "sprint-checker": "inherit",
+        "roadmapper": "inherit",
+        "advisor-researcher": "inherit",
+        "phase-researcher": "inherit",
+        "project-researcher": "inherit",
+        "codebase-mapper": "inherit",
+        "assumptions-analyzer": "inherit",
+        "profiler": "inherit",
+        "research-synthesizer": "inherit",
+        "edge-case-hunter": "inherit",
+        "executor": "inherit",
+        "code-fixer": "inherit",
+        "doc-writer": "inherit",
+        "remediation-planner": "inherit",
+        "verifier": "inherit",
+        "code-reviewer": "inherit",
+        "debugger": "inherit",
+        "deviation-analyzer": "inherit",
+        "security-auditor": "inherit",
+        "security-adversary": "inherit",
+        "integration-checker": "inherit",
+        "nyquist-auditor": "inherit",
+        "ui-auditor": "inherit",
+        "ui-designer": "inherit",
+        "ux-designer": "inherit",
+        "doc-verifier": "inherit",
+        "docs-auditor": "inherit",
+        "tech-writer": "inherit"
+      }
+    }
+  },
+
+  "default_profile": "balanced",
+
+  "model_aliases": {
+    "description": "Short names for the common Claude models in 2026. These are used throughout the profiles table.",
+    "opus": "claude-opus-4-6",
+    "sonnet": "claude-sonnet-4-6",
+    "haiku": "claude-haiku-4-5-20251001",
+    "inherit": null
+  },
+
+  "resolution_rules": {
+    "description": "How to resolve which model an agent should use at dispatch time",
+    "steps": [
+      "1. Read .rihal/config.json (project-level config). If `model_overrides.{agent}` is set, use that.",
+      "2. If no override, look up the agent in the current profile's `agents` map.",
+      "3. If the result is 'inherit', return null/empty to let the runtime pick.",
+      "4. If the result is a tier name (opus/sonnet/haiku), resolve via model_aliases.",
+      "5. If it's a fully-qualified model ID, pass it through unchanged."
+    ]
+  },
+
+  "per_project_config_example": {
+    "description": "Example .rihal/config.json for per-project model profile + overrides",
+    "example": {
+      "model_profile": "balanced",
+      "model_overrides": {
+        "waleed": "opus",
+        "code-reviewer": "sonnet",
+        "tech-writer": "inherit"
+      }
+    }
+  },
+
+  "runtime_compatibility": {
+    "description": "Different runtimes need different model ID formats",
+    "claude_code": "Use short aliases (opus/sonnet/haiku) or full Anthropic model IDs",
+    "codex": "Set profile to 'inherit' OR use model_overrides with OpenAI IDs (o3, o4-mini)",
+    "opencode": "Use 'inherit' profile to follow the live /model selection",
+    "gemini_cli": "Use 'inherit' profile and model_overrides with Gemini IDs (google/gemini-2.5-pro)",
+    "openrouter": "Use 'inherit' profile and model_overrides with OpenRouter IDs (anthropic/claude-opus-4-6)",
+    "local": "Use 'inherit' profile — runtime picks based on loaded model"
+  },
+
+  "design_rationale": {
+    "why_opus_for_sadiq": "Strategic framing affects months of work. Opus handles multi-variable optimization better.",
+    "why_opus_for_waleed": "Architecture decisions have year-2 change cost. Opus reasons about trade-offs more reliably.",
+    "why_opus_for_hussain_pm": "PRD scope decisions need careful trade-off reasoning across stakeholders.",
+    "why_opus_for_planner": "Plan quality determines execution velocity; bad plans compound across the whole phase.",
+    "why_opus_for_architect": "Architecture reviews flag long-term consequences that cheaper models miss.",
+    "why_sonnet_for_executors": "Execution follows explicit plan instructions. Sonnet handles this reliably at lower cost.",
+    "why_sonnet_for_reviewers": "Code review benefits from strong reasoning but doesn't require opus-level for structured outputs.",
+    "why_haiku_for_writers": "Documentation and summary tasks are high-volume and structured — Haiku is fast and cheap.",
+    "why_inherit_profile": "Some runtimes let users switch models at runtime. Inherit keeps all agents aligned to that live selection. Also required for non-Anthropic providers."
+  }
+}

package/rihal/config/model-profiles.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://github.com/hanzlahabib/rihal-code/blob/main/rihal/config/model-profiles.schema.json",
+  "title": "Rihal Code Model Profiles",
+  "description": "Schema for model profiles. Each profile is a complete mapping of every agent to a model tier.",
+  "type": "object",
+  "required": ["version", "profiles", "default_profile", "model_aliases"],
+  "properties": {
+    "version": { "type": "string" },
+    "description": { "type": "string" },
+    "profiles": {
+      "type": "object",
+      "description": "Named profiles (quality, balanced, budget, inherit). Each profile defines a model per agent.",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["agents"],
+        "properties": {
+          "description": { "type": "string" },
+          "agents": {
+            "type": "object",
+            "description": "Map of agent name → model tier (opus/sonnet/haiku) or 'inherit' or fully-qualified model ID",
+            "additionalProperties": { "type": "string" }
+          }
+        }
+      }
+    },
+    "default_profile": {
+      "type": "string",
+      "description": "Profile to use when no project-level override is set"
+    },
+    "model_aliases": {
+      "type": "object",
+      "description": "Short alias → concrete model ID"
+    }
+  }
+}

package/rihal/config.yaml

@@ -0,0 +1,39 @@
+module:
+  code: rihal
+  name: Rihal Code
+  arabic_name: طريقة رحال
+  version: 0.1.0
+  category: team-methodology
+  description: Context-aware AI team methodology inspired by Rihal (Muscat, Oman). Agents embody real team roles to guide projects from strategy to ship.
+  author: Hanzla Habib
+  organization: Rihal (inspired)
+  tagline: "رحلة البناء — The journey of building"
+  license: MIT
+
+cultural:
+  origin: Muscat, Oman
+  language_primary: English
+  language_secondary: Arabic
+  greetings:
+    - "مرحباً (Marhaban) — Welcome"
+    - "السلام عليكم (Assalamu Alaikum) — Peace be upon you"
+  team_inspired_by: Rihal Oman
+  note: |
+    Agent names are Arabic/Omani placeholders. Replace with real team
+    members in your .rihal/team.yaml file to personalize.
+
+state_directory: .rihal
+context_management:
+  max_context_tokens: 120000
+  compact_threshold: 0.70
+  reset_threshold: 0.85
+  artifacts_enabled: true
+  progress_tracking: true
+
+server:
+  port: 7717
+  mode: view-only
+  auto_refresh_seconds: 5
+
+communication_language: English
+output_folder: ./output