qualia-framework-v2 2.8.1 → 2.10.0

package/bin/state.js

@@ -51,19 +51,54 @@ function readState() {
 // ─── STATE.md Parser ─────────────────────────────────────
 function parseStateMd(content) {
   if (!content) return null;
+  const schema_errors = [];
   const get = (prefix) => {
     const m = content.match(new RegExp(`^${prefix}:\\s*(.+)$`, "m"));
     return m ? m[1].trim() : "";
   };
+  const hasField = (prefix) =>
+    new RegExp(`^${prefix}:\\s*`, "m").test(content);
+
   const phaseMatch = content.match(
     /^Phase:\s*(\d+)\s+of\s+(\d+)\s*[—-]\s*(.+)$/m
   );
+  if (!phaseMatch) {
+    schema_errors.push({
+      field: "phase_header",
+      message: 'Missing or malformed "Phase: N of M — Name" header',
+      severity: "error",
+    });
+  }
+
+  // Status field presence (independent of value)
+  if (!hasField("Status")) {
+    schema_errors.push({
+      field: "status_field",
+      message: "Missing Status: field",
+      severity: "warning",
+    });
+  }
+
   // Parse roadmap table
   const phases = [];
+  const tableHeaderRe = /\| # \| Phase \| Goal \| Status \|/;
   const tableMatch = content.match(
     /\| # \| Phase \| Goal \| Status \|\n\|[-|]+\|\n([\s\S]*?)(?=\n##|\n$|$)/
   );
-  if (tableMatch) {
+  if (!tableHeaderRe.test(content)) {
+    schema_errors.push({
+      field: "roadmap_table",
+      message: "Roadmap table header not found",
+      severity: "error",
+    });
+  } else if (!tableMatch) {
+    // Header is there but the separator row or body is malformed
+    schema_errors.push({
+      field: "roadmap_table",
+      message: "Roadmap table is malformed (missing separator row or body)",
+      severity: "error",
+    });
+  } else {
     for (const row of tableMatch[1].trim().split("\n")) {
       const cols = row.split("|").map((c) => c.trim()).filter(Boolean);
       if (cols.length >= 4) {
@@ -76,6 +111,19 @@ function parseStateMd(content) {
       }
     }
   }
+
+  // Row count vs header "of M"
+  if (phaseMatch) {
+    const declaredTotal = parseInt(phaseMatch[2]);
+    if (phases.length && phases.length !== declaredTotal) {
+      schema_errors.push({
+        field: "roadmap_rows",
+        message: `Expected ${declaredTotal} phases in roadmap, found ${phases.length}`,
+        severity: "warning",
+      });
+    }
+  }
+
   return {
     phase: phaseMatch ? parseInt(phaseMatch[1]) : 1,
     total_phases: phaseMatch ? parseInt(phaseMatch[2]) : phases.length || 1,
@@ -83,6 +131,7 @@ function parseStateMd(content) {
     status: get("Status").toLowerCase().replace(/\s+/g, "_") || "setup",
     assigned_to: get("Assigned to") || "",
     phases,
+    schema_errors,
   };
 }
 
@@ -254,6 +303,7 @@ function cmdCheck(opts) {
       s.total_phases,
       t.verification
     ),
+    schema_errors: s.schema_errors && s.schema_errors.length ? s.schema_errors : undefined,
   });
 }
 
@@ -269,6 +319,16 @@ function cmdTransition(opts) {
     );
   }
 
+  // Refuse transitions if STATE.md has schema errors (severity=error)
+  if (s.schema_errors && s.schema_errors.some((e) => e.severity === "error")) {
+    return output(
+      fail(
+        "STATE_SCHEMA_ERROR",
+        "STATE.md is malformed. Run `node state.js check` to see errors. Consider `state.js fix` to rewrite canonically."
+      )
+    );
+  }
+
   // Special: note/activity (no status change)
   if (target === "note" || target === "activity") {
     const now = new Date().toISOString().split("T")[0];
@@ -466,6 +526,77 @@ function cmdInit(opts) {
   });
 }
 
+function cmdFix(opts) {
+  const raw = readState();
+  const t = readTracking();
+  if (!raw && !t) {
+    return output(
+      fail("NO_PROJECT", "No .planning/ found. Run /qualia-new.")
+    );
+  }
+  const parsed = parseStateMd(raw) || {
+    phase: 1,
+    total_phases: 1,
+    phase_name: "",
+    status: "setup",
+    assigned_to: "",
+    phases: [],
+    schema_errors: [
+      { field: "content", message: "STATE.md missing or empty", severity: "error" },
+    ],
+  };
+  const previousErrors = (parsed.schema_errors || []).length;
+
+  // Prefer tracking.json values when parsed fields are defaulted/missing
+  const tr = t || {};
+  const totalPhases =
+    parseInt(tr.total_phases) || parsed.total_phases || parsed.phases.length || 1;
+  const phaseNum = parseInt(tr.phase) || parsed.phase || 1;
+  const phaseName =
+    (parsed.phase_name && parsed.phase_name.trim()) ||
+    tr.phase_name ||
+    `Phase ${phaseNum}`;
+  const status = parsed.status || tr.status || "setup";
+  const assignedTo = parsed.assigned_to || tr.assigned_to || "";
+
+  // Build a phases array of the right length
+  const phases = [];
+  for (let i = 0; i < totalPhases; i++) {
+    const existing = parsed.phases[i];
+    phases.push({
+      num: i + 1,
+      name: existing?.name || `Phase ${i + 1}`,
+      goal: existing?.goal || "TBD",
+      status: existing?.status || (i === 0 ? "ready" : "—"),
+    });
+  }
+
+  const s = {
+    phase: phaseNum,
+    total_phases: totalPhases,
+    phase_name: phaseName,
+    status,
+    assigned_to: assignedTo,
+    last_activity: "STATE.md repaired by state.js fix",
+    phases,
+    blockers: "None.",
+    resume: "—",
+  };
+
+  try {
+    writeStateMd(s);
+  } catch (e) {
+    return output(fail("WRITE_ERROR", e.message));
+  }
+
+  output({
+    ok: true,
+    action: "fix",
+    previous_errors: previousErrors,
+    fixed: true,
+  });
+}
+
 // ─── Output ──────────────────────────────────────────────
 function output(obj) {
   console.log(JSON.stringify(obj, null, 2));
@@ -486,11 +617,14 @@ switch (cmd) {
   case "init":
     cmdInit(opts);
     break;
+  case "fix":
+    cmdFix(opts);
+    break;
   default:
     output(
       fail(
         "UNKNOWN_COMMAND",
-        `Usage: state.js <check|transition|init> [--options]`
+        `Usage: state.js <check|transition|init|fix> [--options]`
       )
     );
 }

package/bin/statusline.js

@@ -11,6 +11,7 @@ const fs = require("fs");
 const os = require("os");
 const path = require("path");
 const { spawnSync } = require("child_process");
+const HOME = os.homedir();
 
 // ─── Colors (matches bin/qualia-ui.js palette) ───────────
 const TEAL = "\x1b[38;2;0;206;209m";
@@ -151,6 +152,47 @@ try {
   }
 } catch {}
 
+// ─── Memory count ────────────────────────────────────────
+let MEMORY_COUNT = 0;
+try {
+  const dirKey = DIR.replace(/\//g, "-");
+  const memDir = path.join(HOME, ".claude", "projects", dirKey, "memory");
+  if (fs.existsSync(memDir)) {
+    const files = fs.readdirSync(memDir).filter(f => f.endsWith(".md") && f !== "MEMORY.md");
+    MEMORY_COUNT = files.length;
+  }
+} catch {}
+
+// ─── Hooks count ─────────────────────────────────────────
+let HOOKS_COUNT = 0;
+try {
+  const settingsPath = path.join(HOME, ".claude", "settings.json");
+  if (fs.existsSync(settingsPath)) {
+    const settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    if (settings.hooks) {
+      for (const event of Object.values(settings.hooks)) {
+        if (Array.isArray(event)) {
+          for (const matcher of event) {
+            if (matcher.hooks && Array.isArray(matcher.hooks)) {
+              HOOKS_COUNT += matcher.hooks.length;
+            }
+          }
+        }
+      }
+    }
+  }
+} catch {}
+
+// ─── Skills count ────────────────────────────────────────
+let SKILLS_COUNT = 0;
+try {
+  const skillsDir = path.join(HOME, ".claude", "skills");
+  if (fs.existsSync(skillsDir)) {
+    const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+    SKILLS_COUNT = entries.filter(e => e.isDirectory() || e.name.endsWith(".md")).length;
+  }
+} catch {}
+
 // ─── Duration ────────────────────────────────────────────
 let DUR = "0s";
 try {
@@ -167,11 +209,11 @@ try {
   COST_FMT = `$${COST.toFixed(2)}`;
 } catch {}
 
-// ─── Line 1: Project + Git + Agent + Worktree + Phase ────
+// ─── Line 1: Project + Git + Agent + Worktree + Phase + Memory + Hooks ──
 let LINE1 = "";
 try {
   const dirBase = path.basename(DIR) || DIR;
-  LINE1 = `${TEAL}◆${RESET} ${WHITE}${dirBase}${RESET}`;
+  LINE1 = `${TEAL}⬢${RESET} ${WHITE}${dirBase}${RESET}`;
   if (BRANCH) {
     if (CHANGES > 0) {
       LINE1 += ` ${DIM}on${RESET} ${TEAL_GLOW}${BRANCH}${RESET} ${YELLOW}~${CHANGES}${RESET}`;
@@ -182,8 +224,16 @@ try {
   if (AGENT) LINE1 += ` ${DIM}│${RESET} ${TEAL}⚡${AGENT}${RESET}`;
   if (WORKTREE) LINE1 += ` ${DIM}│${RESET} ${TEAL_DIM}⎇ ${WORKTREE}${RESET}`;
   if (PHASE_INFO) LINE1 += ` ${DIM}│${RESET} ${PHASE_INFO}`;
+  // Memory, hooks, skills — context indicators
+  const contextParts = [];
+  if (MEMORY_COUNT > 0) contextParts.push(`${TEAL}⊙${RESET}${DIM}${MEMORY_COUNT}${RESET}`);
+  if (HOOKS_COUNT > 0) contextParts.push(`${TEAL_GLOW}⚙${RESET}${DIM}${HOOKS_COUNT}${RESET}`);
+  if (SKILLS_COUNT > 0) contextParts.push(`${TEAL_DIM}✦${RESET}${DIM}${SKILLS_COUNT}${RESET}`);
+  if (contextParts.length > 0) {
+    LINE1 += ` ${DIM}│${RESET} ${contextParts.join(` ${DIM}·${RESET} `)}`;
+  }
 } catch {
-  LINE1 = `${TEAL}◆${RESET} ${WHITE}qualia${RESET}`;
+  LINE1 = `${TEAL}⬢${RESET} ${WHITE}qualia${RESET}`;
 }
 
 // ─── Line 2: Context bar + Cost + Duration + Model ───────

package/hooks/migration-guard.js

@@ -48,7 +48,7 @@ if (/CREATE\s+TABLE/i.test(content) && !/ENABLE\s+ROW\s+LEVEL\s+SECURITY/i.test(
 }
 
 if (errors.length > 0) {
-  console.log("◆ Migration guard — dangerous patterns found:");
+  console.log("⬢ Migration guard — dangerous patterns found:");
   for (const e of errors) {
     console.log(`  ✗ ${e}`);
   }

package/hooks/pre-deploy-gate.js

@@ -73,7 +73,7 @@ function scanServiceRoleLeaks() {
   return leaks;
 }
 
-console.log("◆ Pre-deploy gate...");
+console.log("⬢ Pre-deploy gate...");
 
 // TypeScript
 if (fs.existsSync("tsconfig.json")) {
@@ -105,6 +105,6 @@ if (leaks.length > 0) {
   process.exit(1);
 }
 console.log("  ✓ Security");
-console.log("◆ All gates passed.");
+console.log("⬢ All gates passed.");
 
 process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qualia-framework-v2",
-  "version": "2.8.1",
+  "version": "2.10.0",
   "description": "Claude Code workflow framework by Qualia Solutions. Plan, build, verify, ship.",
   "bin": {
     "qualia-framework-v2": "./bin/cli.js"
@@ -23,7 +23,7 @@
   },
   "homepage": "https://github.com/Qualiasolutions/qualia-framework-v2#readme",
   "scripts": {
-    "test": "bash tests/hooks.test.sh && bash tests/state.test.sh"
+    "test": "bash tests/hooks.test.sh && bash tests/state.test.sh && bash tests/bin.test.sh && bash tests/statusline.test.sh"
   },
   "files": [
     "bin/",

package/skills/qualia-design/SKILL.md

@@ -73,7 +73,7 @@ git commit -m "style: design transformation"
 ```
 
 ```
-◆ Design Transformation Complete
+⬢ Design Transformation Complete
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Files: {N}
   Changes:

package/skills/qualia-learn/SKILL.md

@@ -70,7 +70,7 @@ echo "{formatted entry}" >> ~/.claude/knowledge/{type}.md
 ### 4. Confirm
 
 ```
-◆ Saved to {file}
+⬢ Saved to {file}
   "{title}"
 ```
 

package/skills/qualia-new/SKILL.md

@@ -100,7 +100,7 @@ options:
     description: "Gradients, rounded shapes, vibrant palette"
     preview: |
       ┌──────────────────────────────┐
-      │  ◆ ● ▲ ■  COLORFUL          │
+      │  ⬢ ● ▲ ■  COLORFUL          │
       │                              │
       │  ╭──────╮  ╭──────╮         │
       │  │ Card │  │ Card │         │
@@ -173,7 +173,7 @@ If there's an entry for this client, show it to the user: *"I have notes on {cli
 Present a summary:
 
 ```
-◆ QUALIA ► PROJECT SUMMARY
+⬢ QUALIA ▸ PROJECT SUMMARY
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   Project    {name}

package/skills/qualia-review/SKILL.md

@@ -64,7 +64,7 @@ Every finding:
 Write to `.planning/REVIEW.md`. CRITICAL or HIGH findings are deploy blockers — `/qualia-ship` checks for them.
 
 ```
-◆ Review Complete
+⬢ Review Complete
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Critical:  {N}
   High:      {N}