qualia-framework 3.3.0 → 3.3.2

package/bin/state.js

@@ -393,9 +393,15 @@ function cmdTransition(opts) {
     { ...opts, phase }
   );
   if (!check.ok) {
-    // Force only bypasses status-ordering errors (PRECONDITION_FAILED, GAP_CYCLE_LIMIT).
-    // Never bypass MISSING_FILE, MISSING_ARG, INVALID_PLAN — those cause broken state.
-    const forceableErrors = ["PRECONDITION_FAILED", "GAP_CYCLE_LIMIT"];
+    // Force bypasses status-ordering errors AND plan-content errors. The use case
+    // is retroactive bookkeeping: a phase was built without /qualia-plan and the
+    // user is catching STATE.md up to reality. `--force` never bypasses MISSING_FILE
+    // or MISSING_ARG — those would leave the state machine pointing at nothing.
+    const forceableErrors = [
+      "PRECONDITION_FAILED",
+      "GAP_CYCLE_LIMIT",
+      "INVALID_PLAN",
+    ];
     if (opts.force && forceableErrors.includes(check.error)) {
       console.error(`WARNING: Forcing transition despite: ${check.message}`);
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qualia-framework",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "Claude Code workflow framework by Qualia Solutions. Plan, build, verify, ship.",
   "bin": {
     "qualia-framework": "./bin/cli.js"

package/skills/qualia-milestone/SKILL.md

@@ -86,7 +86,7 @@ Spawn the roadmapper to create a new ROADMAP.md for the next milestone:
 
 ```
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-roadmapper.md
+Read your role: @~/.claude/agents/roadmapper.md
 
 <task>
 Create a new ROADMAP.md for the next milestone.

package/skills/qualia-new/SKILL.md

@@ -236,7 +236,7 @@ mkdir -p .planning/research
 
 ```
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-researcher.md
+Read your role: @~/.claude/agents/researcher.md
 
 <dimension>stack</dimension>
 <domain>{inferred domain from PROJECT.md}</domain>
@@ -246,7 +246,7 @@ Read your role: @~/.claude/agents/qualia-researcher.md
 ", subagent_type="qualia-researcher", description="Stack research")
 
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-researcher.md
+Read your role: @~/.claude/agents/researcher.md
 
 <dimension>features</dimension>
 <domain>{inferred domain}</domain>
@@ -256,7 +256,7 @@ Read your role: @~/.claude/agents/qualia-researcher.md
 ", subagent_type="qualia-researcher", description="Features research")
 
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-researcher.md
+Read your role: @~/.claude/agents/researcher.md
 
 <dimension>architecture</dimension>
 <domain>{inferred domain}</domain>
@@ -266,7 +266,7 @@ Read your role: @~/.claude/agents/qualia-researcher.md
 ", subagent_type="qualia-researcher", description="Architecture research")
 
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-researcher.md
+Read your role: @~/.claude/agents/researcher.md
 
 <dimension>pitfalls</dimension>
 <domain>{inferred domain}</domain>
@@ -280,7 +280,7 @@ Read your role: @~/.claude/agents/qualia-researcher.md
 
 ```
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-research-synthesizer.md
+Read your role: @~/.claude/agents/research-synthesizer.md
 
 Merge the 4 research files at .planning/research/ into .planning/research/SUMMARY.md.
 Include roadmap implications.
@@ -332,7 +332,7 @@ Spawn the roadmapper agent:
 
 ```
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-roadmapper.md
+Read your role: @~/.claude/agents/roadmapper.md
 
 <task>
 Create REQUIREMENTS.md and ROADMAP.md for this project.

package/skills/qualia-optimize/SKILL.md

@@ -367,7 +367,7 @@ status: {clean|needs_attention|critical_issues}
 
 Commit:
 ```bash
-node ~/.claude/qualia-framework/bin/qualia-tools.js commit "docs: optimization report ({mode} mode, {critical} critical)" --files .planning/OPTIMIZE.md
+git add .planning/OPTIMIZE.md && git commit -m "docs: optimization report ({mode} mode, {critical} critical)"
 ```
 
 **Present results:**

package/skills/qualia-plan/SKILL.md

@@ -61,7 +61,7 @@ Spawn the planner:
 
 ```
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-planner.md
+Read your role: @~/.claude/agents/planner.md
 
 <project_context>
 @.planning/PROJECT.md
@@ -104,7 +104,7 @@ Read the generated plan. Spawn the plan-checker:
 
 ```
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-plan-checker.md
+Read your role: @~/.claude/agents/plan-checker.md
 
 <plan_path>.planning/phase-{N}-plan.md</plan_path>
 <phase_goal>{goal from ROADMAP.md}</phase_goal>
@@ -125,7 +125,7 @@ For each revision:
 
 ```
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-planner.md
+Read your role: @~/.claude/agents/planner.md
 
 <revision_mode>true</revision_mode>
 <current_plan>@.planning/phase-{N}-plan.md</current_plan>

package/skills/qualia-research/SKILL.md

@@ -50,7 +50,7 @@ Wait for their answer. Their answer defines the research question.
 
 ```
 Agent(prompt="
-Read your role: @~/.claude/agents/qualia-researcher.md
+Read your role: @~/.claude/agents/researcher.md
 
 <dimension>phase-specific</dimension>
 

package/tests/runner.js

@@ -774,14 +774,31 @@ waves: 1
     }
   });
 
-  it("--force does NOT bypass INVALID_PLAN", () => {
+  it("--force bypasses INVALID_PLAN (retroactive bookkeeping)", () => {
+    // Use case: a phase was built without /qualia-plan and the user is
+    // catching STATE.md up to reality. The plan file exists as documentation
+    // but lacks `**Done when:**` markers — that should not block --force.
     const tmpDir = makeProject();
     try {
       fs.writeFileSync(path.join(tmpDir, ".planning", "phase-1-plan.md"), "# No tasks here");
+      const r = runState(["transition", "--to", "planned", "--force"], tmpDir);
+      assert.equal(r.status, 0);
+      const out = JSON.parse(r.stdout);
+      assert.equal(out.ok, true);
+      assert.equal(out.status, "planned");
+    } finally {
+      fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  it("--force still rejects MISSING_FILE", () => {
+    // Sanity: --force unblocks plan-content errors but not "no plan at all".
+    const tmpDir = makeProject();
+    try {
       const r = runState(["transition", "--to", "planned", "--force"], tmpDir);
       assert.equal(r.status, 1);
       const out = JSON.parse(r.stdout);
-      assert.equal(out.error, "INVALID_PLAN");
+      assert.equal(out.error, "MISSING_FILE");
     } finally {
       fs.rmSync(tmpDir, { recursive: true, force: true });
     }