@hanzlaa/rcode 4.4.0 → 4.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "4.4.0",
+  "version": "4.4.2",
   "description": "rcode — the AI team that never forgets. Persistent memory, specialist agents, and slash commands for AI IDEs. Works in Claude Code, Cursor, Gemini, VS Code, and Antigravity.",
   "main": "cli/index.js",
   "bin": {
@@ -55,7 +55,7 @@
     "access": "public"
   },
   "dependencies": {
-    "ws": "^8.20.1"
+    "ws": "^8.21.0"
   },
   "optionalDependencies": {
     "@lydell/node-pty": "1.2.0-beta.12"

package/rcode/bin/rcode-tools.cjs

@@ -7596,21 +7596,43 @@ async function main() {
         const validateErrors = [];
 
         if (target === 'state' || target === 'all') {
-          const state = readState();
-          if (!state) {
-            validateErrors.push('state: state.json not found or empty');
+          // Read state.json directly — readState() is scoped inside cmdState()
+          // and isn't reachable here (#940). Validate against the REAL schema:
+          // phases[] + milestones[], current_phase nullable on fresh installs.
+          const statePathV = path.join(RCODE_DIR, 'state.json');
+          if (!fs.existsSync(statePathV)) {
+            validateErrors.push('state: state.json not found — run rcode install');
           } else {
-            if (!state.current_phase) validateErrors.push('state: missing current_phase');
-            if (!state.current_milestone) validateErrors.push('state: missing current_milestone');
-            if (state.schema_version !== 2) validateErrors.push(`state: schema_version should be 2, got ${state.schema_version}`);
-            if (!Array.isArray(state.phases) && typeof state.phases !== 'object') validateErrors.push('state: phases must be array or object');
+            let state = null;
+            try {
+              state = JSON.parse(fs.readFileSync(statePathV, 'utf8'));
+            } catch (e) {
+              validateErrors.push(`state: invalid JSON — ${e.message}`);
+            }
+            if (state) {
+              // current_phase is legitimately null on a fresh / stub project,
+              // so do NOT require it. milestones is an array (no current_milestone field).
+              // schema_version 1 is valid on disk — migrateState() upgrades it to 2
+              // transparently on read, so accept either and only flag the unknown.
+              if (state.schema_version != null && ![1, 2].includes(state.schema_version)) {
+                validateErrors.push(`state: unknown schema_version ${state.schema_version} (expected 1 or 2)`);
+              }
+              if (state.phases != null && !Array.isArray(state.phases) && typeof state.phases !== 'object') {
+                validateErrors.push('state: phases must be an array or object');
+              }
+              if (state.milestones != null && !Array.isArray(state.milestones)) {
+                validateErrors.push('state: milestones must be an array');
+              }
+            }
           }
         }
 
         if (target === 'config' || target === 'all') {
+          // config.yaml holds project identity + workflow prefs only — it does
+          // NOT track current_phase (that lives in state.json). Only require
+          // the fields config actually owns (#940).
           const config = readConfig();
           if (!config.project_name) validateErrors.push('config: missing project_name');
-          if (!config.current_phase && !config.phase) validateErrors.push('config: missing current_phase or phase');
         }
 
         if (validateErrors.length) {

package/rcode/commands/lazy.md

@@ -0,0 +1,16 @@
+---
+name: rcode-lazy
+description: "Lazy senior dev lens — force the simplest solution that actually works before any code is written (YAGNI, stdlib first, one line before fifty)"
+argument-hint: "[challenge or code to simplify] [--intensity=lite|full|ultra]"
+allowed-tools:
+  - Read
+  - AskUserQuestion
+  - Skill
+---
+
+Invoke the `rcode-lazy` skill (via the Skill tool) and apply it to: $ARGUMENTS
+
+`rcode-lazy` is the always-on "lazy senior dev" lens — it forces the simplest
+solution that actually works (YAGNI, stdlib before custom code, native platform
+features before dependencies, one line before fifty) before any code is written.
+Pass `--intensity=lite|full|ultra` through if the user provided it; default is `full`.

package/rcode/references/verb-dictionary.md

@@ -112,7 +112,7 @@ These are matched alongside §Create / §Add / §Plan verbs to determine the dis
 | epic | `epic`, `epics`, `epics and stories`, **AR:** `ملحمة`, `ملاحم`, `فصل`, `فصول` | `/rcode-create-epics-and-stories` |
 | sprint | `sprint`, `iteration`, **AR:** `سباق`, `جولة`, `دورة عمل`, `سبرنت` | `/rcode-sprint-planning` |
 | PRD | `PRD`, `requirements doc`, `product requirements`, **AR:** `وثيقة المتطلبات`, `متطلبات المنتج`, `وثيقة المنتج` | `/rcode-create-prd` |
-| roadmap | `roadmap`, `plan` (top-level), **AR:** `خارطة طريق`, `خريطة الطريق`, `خطة عامة` | `/rcode-create-milestone` |
+| roadmap | `roadmap`, `plan` (top-level), **AR:** `خارطة طريق`, `خريطة الطريق`, `خطة عامة` | `/rcode-new-milestone` |
 | council | `council`, `majlis`, `panel`, `mashwara`, `salah`, **AR:** `مجلس`, `شورى`, `لجنة`, `استشارة` | `/rcode-council` |
 | plan (verb form — "plan phase N") | `plan`, **AR:** `خطّط`, `خطة` | `/rcode-plan` |
 | story (impl) | `dev story`, `implement story`, `build story`, **AR:** `نفذ القصة`, `طبّق القصة` | `/rcode-dev-story` |

package/rcode/skills/SKILLS_INDEX.md

@@ -56,7 +56,7 @@ Invoked by agents via the capabilities table in their SKILL.md. Organized by SDL
 - `actions/2-plan/rcode-frontend-design` — typography, colours, motion, spatial design
 - `actions/2-plan/rcode-create-epics-and-stories` — break down PRD into epics and stories
 - `actions/2-plan/rcode-create-story` — prepare a dev-ready user story
-- `actions/2-plan/rcode-create-milestone` — create milestone definition
+- `actions/2-plan/rcode-new-milestone` — create milestone definition
 
 ### 3 — Solutioning (3)
 - `actions/3-solutioning/rcode-create-architecture` — architectural decision record (ADR)

package/rcode/skills/actions/1-analysis/rcode-prfaq/SKILL.md

@@ -18,7 +18,7 @@ user-invocable: true
 
 - **Refining an existing PRD** — use `rcode-create-prd` or `rcode-edit-prd`.
 - **Brainstorming raw ideas** before there's a concept — use `rcode-brainstorming` first; PRFAQ assumes a candidate concept exists.
-- **Sprint or phase planning** — use `rcode-sprint-planning` / `rcode-create-milestone`.
+- **Sprint or phase planning** — use `rcode-sprint-planning` / `rcode-new-milestone`.
 - **Pure market research with no product hypothesis** — use a research workflow.
 - **Single-question Q&A** — PRFAQ runs a multi-stage gauntlet; for a one-off answer, just answer.
 

package/rcode/workflows/help.md

@@ -132,7 +132,6 @@ init → new-project → plan → execute → next → status → ship
 | `/rcode-insert-phase <after> <name>` | Alias for `/rcode-phase --insert <after> <name>`. |
 | `/rcode-remove-phase <n>` | Alias for `/rcode-phase --remove <n>`. |
 | `/rcode-quick [flags]` | Small ad-hoc tasks with rcode guarantees but skip optional agents. Flags: `--discuss`, `--research`, `--full`. |
-| `/rcode-fast "<task>"` | Trivial inline task — typo, gitignore tweak, etc. No subagents, ≤3 file edits. *Not yet implemented (#482-B).* |
 
 ## Capture & session continuity
 
@@ -226,7 +225,6 @@ init → new-project → plan → execute → next → status → ship
 | `/rcode-enable-hooks` | Install optional rcode hooks into `.claude/settings.json`. |
 | `/rcode-scaffold-project` | Scaffold a new project from the official rcode template. |
 | `/rcode-scaffold-skill --role <role>` | Scaffold a new compliant SKILL.md for a rcode role — eliminates friction of finding folder, copying, and chasing 5-component compliance. |
-| `/rcode-bootstrap` | Bootstrap repo with Vercel-linked resources and integrations. *Not yet implemented (#481).* |
 
 ## Story-level epics workflow