qualia-framework 2.4.0 → 2.4.2

package/framework/skills/qualia-report/SKILL.md

@@ -0,0 +1,217 @@
+---
+name: qualia-report
+description: "Generate a session work report for owner review — what was assigned, what was done, what deviated, what's next. Use this skill whenever the user says 'report', 'done for today', 'session report', 'log my work', 'what did I do', 'end of day', 'wrapping up', 'signing off', or finishes a working session. Also trigger when user mentions 'daily report', 'status update', 'work summary', or wants to document what they accomplished."
+---
+
+# Qualia Report — Session Work Report
+
+Generate a structured report of what was done in this session. This is for the owner to review — assigned vs done, deviations, blockers, and next steps.
+
+## Usage
+
+`/qualia-report` — Generate report for current session
+`/qualia-report --week` — Aggregate reports from the last 7 days
+
+## When to Run
+
+The framework should suggest this when:
+- Employee says "done for today", "stopping", "wrapping up", "signing off"
+- Employee has been working for 1+ hours and mentions pausing
+- A phase is completed or verified
+- Before running `/qualia-pause-work` (report first, then pause)
+
+## Process
+
+### 1. Gather Session Data
+
+**From git (what actually changed):**
+```bash
+# Commits made this session (last N hours or since last report)
+LAST_REPORT=$(ls -t .planning/reports/report-*.md 2>/dev/null | head -1)
+if [ -n "$LAST_REPORT" ]; then
+  SINCE=$(grep -m1 "^Date:" "$LAST_REPORT" | sed 's/^Date: *//')
+else
+  SINCE="8 hours ago"
+fi
+git log --oneline --since="$SINCE" --author="$(git config user.name)" 2>/dev/null
+git diff --stat HEAD~5..HEAD 2>/dev/null | tail -5
+```
+
+**From STATE.md (where the project stands):**
+- Current phase and status
+- Progress percentage
+- Assigned to whom
+
+**From ROADMAP.md (what was planned):**
+- Which phase was being worked on
+- What the phase goal is
+- What the success criteria are
+
+**From SUMMARY.md files (if any were created this session):**
+- Phase execution summaries
+- Deviations noted
+- Decisions made
+
+**From UAT.md files (if any were created this session):**
+- Test results
+- Issues found
+
+**From git diff (what files changed):**
+```bash
+git diff --name-only HEAD~5..HEAD 2>/dev/null | head -30
+```
+
+### 2. Analyze: Assigned vs Done
+
+Compare what ROADMAP.md says the current phase should deliver against what was actually built:
+
+- **Planned:** [from ROADMAP.md phase goal + success criteria]
+- **Completed:** [from commits + SUMMARY.md]
+- **Partially done:** [started but not finished]
+- **Not started:** [planned but untouched]
+- **Unplanned work:** [things done that weren't in the plan]
+
+### 3. Generate Report
+
+Create `.planning/reports/report-{YYYY-MM-DD-HHMM}.md`:
+
+```markdown
+# Session Report
+
+**Project:** {from PROJECT.md or directory name}
+**Date:** {YYYY-MM-DD HH:MM}
+**Employee:** {from STATE.md "Assigned to" or git config user.name}
+**Duration:** {estimated from first to last commit, or "~X hours"}
+**Phase:** {N} of {total} — {phase name}
+
+## What Was Assigned
+
+{Phase goal from ROADMAP.md}
+
+Success criteria:
+1. {criterion 1}
+2. {criterion 2}
+3. {criterion 3}
+
+## What Was Done
+
+{Summary of actual work, derived from commits and file changes}
+
+- {accomplishment 1}
+- {accomplishment 2}
+- {accomplishment 3}
+
+### Files Changed
+{Top 15 files modified, grouped by area}
+
+### Commits
+{List of commits this session}
+
+## Progress
+
+| Criterion | Status |
+|-----------|--------|
+| {criterion 1} | Done / Partial / Not started |
+| {criterion 2} | Done / Partial / Not started |
+| {criterion 3} | Done / Partial / Not started |
+
+**Phase progress:** {X}% → {Y}% (moved {delta}%)
+**Overall project:** {A}% → {B}%
+
+## Deviations
+
+{Anything done differently from the plan — and why}
+
+- {deviation 1}: {reason}
+
+{If no deviations: "None — followed the plan."}
+
+## Blockers & Issues
+
+{Anything that slowed down or blocked work}
+
+- {blocker 1}: {status — resolved / still blocking}
+
+{If none: "None — clear session."}
+
+## Decisions Made
+
+{Any choices that affect future work}
+
+| Decision | Why | Impact |
+|----------|-----|--------|
+| {choice} | {reason} | {what it affects} |
+
+## Next Session
+
+**What to do next:**
+1. {immediate next action}
+2. {following action}
+
+**Suggested command:** `/qualia-plan-phase {N}` or `/qualia-execute-phase {N}` etc.
+
+---
+*Generated by /qualia-report at {timestamp}*
+```
+
+### 4. Commit Report
+
+```bash
+mkdir -p .planning/reports
+git add .planning/reports/report-{timestamp}.md
+git commit -m "report: session report {date} — {employee name}"
+```
+
+### 5. Update STATE.md
+
+Update the `Last activity` and `Last worked by` fields in STATE.md.
+
+### 6. Suggest Next Steps
+
+> "Report saved to `.planning/reports/report-{date}.md`"
+>
+> "Want to also save session context? Run `/qualia-pause-work`"
+> "Ready to keep going? Run `/qualia-plan-phase {N}`"
+
+## Weekly Aggregate (`--week`)
+
+When run with `--week`, reads all reports from the last 7 days and produces a summary:
+
+```markdown
+# Weekly Report — {project name}
+
+**Period:** {date} to {date}
+**Employee:** {name}
+
+## Summary
+
+- **Sessions:** {count}
+- **Phases progressed:** Phase {X} → Phase {Y}
+- **Overall progress:** {A}% → {B}%
+- **Commits:** {total}
+
+## Per-Session Breakdown
+
+| Date | Phase | Progress | Key Accomplishment |
+|------|-------|----------|-------------------|
+| {date} | Phase 3 | +15% | Built auth flow |
+| {date} | Phase 3 | +10% | Added RLS policies |
+| {date} | Phase 4 | +5% | Started chat UI |
+
+## Cumulative Deviations
+
+{Any patterns — repeated blockers, scope changes, etc.}
+
+## Blockers Still Open
+
+{Unresolved from any session}
+
+## Next Week
+
+{What's ahead based on ROADMAP.md}
+```
+
+Save to `.planning/reports/weekly-{date}.md`.
+
+---
+> Stuck? Type `/qualia-idk` · Lost? Type `/qualia-help`

package/framework/skills/qualia-start/SKILL.md

@@ -20,75 +20,52 @@ You will:
 
 **CRITICAL**: Do NOT dump raw bash output. YOU format the dashboard as styled text output.
 
-## Step 1: Gather Project Data
+## Step 1: Gather ALL Data (2 bash calls max)
 
-Run these bash commands to collect info (combine where possible):
+**CRITICAL: Run exactly 2 bash calls in parallel.** Do NOT split these into separate calls.
 
-```bash
-pwd
-```
-
-```bash
-node -e "try{const p=require('./package.json');console.log(p.name||'')}catch(e){console.log('')}" 2>/dev/null
-```
-
-```bash
-git branch --show-current 2>/dev/null || echo ""
-```
-
-```bash
-git status --porcelain 2>/dev/null | wc -l
-```
+### Call 1 — Project & System Health
 
-```bash
-node -v 2>/dev/null || echo "none"
-```
+Run this single combined command:
 
 ```bash
-test -f tsconfig.json && echo "yes" || echo "no"
+echo "---PROJECT---"
+echo "DIR:$(pwd)"
+echo "NAME:$(node -e "try{const p=require('./package.json');console.log(p.name||'')}catch(e){console.log('')}" 2>/dev/null)"
+echo "BRANCH:$(git branch --show-current 2>/dev/null || echo '')"
+echo "CHANGES:$(git status --porcelain 2>/dev/null | wc -l)"
+echo "NODE:$(node -v 2>/dev/null || echo 'none')"
+echo "TS:$(test -f tsconfig.json && echo 'yes' || echo 'no')"
+echo "SUPABASE:$(test -d supabase && echo 'yes' || echo 'no')"
+echo "PLANNING:$(test -d .planning && echo 'yes' || echo 'no')"
+echo "NEXTCONF:$(ls next.config.* 2>/dev/null | head -1)"
+echo "EXPO:$(ls app.json expo.json 2>/dev/null | head -1)"
+echo "PYTHON:$(ls app.py main.py 2>/dev/null | head -1)"
+echo "HANDOFF:$(test -f .continue-here.md && echo 'yes' || echo 'no')"
+echo "---SYSTEM---"
+HOOKS_OK=0; HOOKS_TOTAL=0; for h in branch-guard pre-commit confirm-delete migration-validate pre-deploy-gate block-env-edit auto-format session-context-loader retention-cleanup pre-compact save-session-state session-learn notification-speak qualia-colors skill-announce tool-error-announce; do HOOKS_TOTAL=$((HOOKS_TOTAL+1)); test -f "$HOME/.claude/hooks/${h}.sh" && HOOKS_OK=$((HOOKS_OK+1)); done; echo "HOOKS:${HOOKS_OK}/${HOOKS_TOTAL}"
+echo "ENGINE:$(test -f "$HOME/.claude/qualia-framework/bin/qualia-tools.js" && echo 'ok' || echo 'MISSING')"
+echo "VERSION:$(cat "$HOME/.claude/qualia-framework/VERSION" 2>/dev/null || echo 'unknown')"
 ```
 
-```bash
-test -d supabase && echo "supabase:yes" || echo "supabase:no"; test -d .planning && echo "planning:yes" || echo "planning:no"; ls next.config.* 2>/dev/null | head -1; ls app.json expo.json 2>/dev/null | head -1; ls app.py main.py 2>/dev/null | head -1
-```
+### Call 2 — Session Context
 
-```bash
-HOOKS_OK=0; HOOKS_TOTAL=0; for h in branch-guard pre-commit confirm-delete migration-validate pre-deploy-gate block-env-edit auto-format session-context-loader retention-cleanup pre-compact save-session-state session-learn notification-speak qualia-colors skill-announce tool-error-announce; do HOOKS_TOTAL=$((HOOKS_TOTAL+1)); test -f "$HOME/.claude/hooks/${h}.sh" && HOOKS_OK=$((HOOKS_OK+1)); done; echo "${HOOKS_OK}/${HOOKS_TOTAL}"
-```
+Run this single combined command:
 
 ```bash
-# Qualia engine health
-test -f "$HOME/.claude/qualia-engine/bin/qualia-tools.js" && echo "engine:ok" || echo "engine:MISSING"
-cat "$HOME/.claude/qualia-engine/VERSION" 2>/dev/null || echo "engine:no-version"
-```
-
-If `.planning/STATE.md` exists, read it. If `.planning/ROADMAP.md` exists, read it.
-
-Classify project type from signals: `web` | `voice` | `mobile` | `python-agent` | `edge-functions` | `framework` | `unknown`
-
-## Step 2: Gather Session Context
-
-This replaces the old session-context-loader. Run these:
-
-```bash
-# Cross-project session digest (last 5 sessions)
+echo "---DIGEST---"
 tail -n +4 ~/.claude/knowledge/session-digest.md 2>/dev/null | head -5
+echo "---STALE---"
+NOW=$(date +%s); find ~/.claude/knowledge -maxdepth 1 -name "*.md" -type f | while read f; do B=$(basename "$f"); [ "$B" = "session-digest.md" ] && continue; AGE=$(( (NOW - $(stat -c %Y "$f" 2>/dev/null || echo $NOW)) / 86400 )); [ "$AGE" -gt 30 ] && echo "${B} (${AGE}d)"; done
+echo "---PULSE---"
+for DIR in ~/Projects/*/; do [ -d "$DIR/.git" ] || continue; LAST=$(git -C "$DIR" log --oneline -1 --since="7 days ago" --format="%ar" 2>/dev/null); [ -n "$LAST" ] && echo "$(basename "$DIR")(${LAST})"; done | head -10
 ```
 
-```bash
-# Stale knowledge detection (>30 days) — only top-level .md files
-NOW=$(date +%s); find ~/.claude/knowledge -maxdepth 1 -name "*.md" -type f | while read f; do B=$(basename "$f"); [ "$B" = "session-digest.md" ] && continue; AGE=$(( (NOW - $(stat -c %Y "$f" 2>/dev/null || echo $NOW)) / 86400 )); [ "$AGE" -gt 30 ] && echo "STALE: ${B} (${AGE}d)"; done
-```
+### After bash calls
 
-```bash
-# Project pulse (git activity in last 7 days)
-for DIR in ~/Projects/*/; do [ -d "$DIR/.git" ] || continue; LAST=$(git -C "$DIR" log --oneline -1 --since="7 days ago" --format="%ar" 2>/dev/null); [ -n "$LAST" ] && echo "$(basename "$DIR")(${LAST})"; done | head -10
-```
+If PLANNING is "yes", read `.planning/STATE.md` and `.planning/ROADMAP.md` (use the Read tool, not bash).
 
-```bash
-# Check for .continue-here.md (auto-handoff from previous session)
-test -f .continue-here.md && echo "HANDOFF: .continue-here.md exists" || echo ""
-```
+Classify project type from signals: `web` | `voice` | `mobile` | `python-agent` | `edge-functions` | `framework` | `unknown`
 
 ## Step 3: Render the Dashboard
 
@@ -123,11 +100,6 @@ test -f .continue-here.md && echo "HANDOFF: .continue-here.md exists" || echo ""
   Status    executed
   DESIGN.md ✓   REVIEW.md ▲ stale
 
-── GATES ───────────────────────────────
-  ✓ Frontend guard    ✓ Deploy guard
-  ✓ Intent verify     ✓ Security rules
-  ✓ TypeScript        ✓ .env protection
-
 ── PATTERNS ────────────────────────────
   frontend-master  responsive  seo-master  ship
 

package/framework/skills/qualia-verify-work/SKILL.md

@@ -93,7 +93,23 @@ For items relevant to this phase's scope, verify each one:
 
 Do NOT check items outside this phase's scope (e.g., don't check deployment items during a Phase 1 verify).
 
-### 6. Design Quality Check (Frontend Phases)
+### 6. Red-Team QA (Optional Adversarial Pass)
+
+After cooperative verification passes (all UAT items green), offer an adversarial stress test:
+
+> "UAT passed. Want to run red-team QA? This spawns an adversarial agent that actively tries to break the implementation — edge cases, error paths, permission bypasses. Run it? (recommended for phases with auth, payments, or user input)"
+
+If accepted, spawn the `red-team-qa` agent:
+- Pass ONLY the phase goal text (from ROADMAP.md) — do NOT pass SUMMARY.md or PLAN.md
+- The agent works from the goal + codebase alone (prevents confirmation bias)
+- Agent produces an attack report with BROKEN / WEAK / SOLID verdicts
+
+**On red-team results:**
+- **BROKEN findings**: treat as UAT failures — add to UAT.md, route to gap planning
+- **WEAK findings**: add as advisory notes in UAT.md, user decides whether to fix
+- **All SOLID**: add "Red-team QA: PASSED" to UAT.md, proceed
+
+### 7. Design Quality Check (Frontend Phases)
 
 If the phase involves frontend work (detected from PLAN.md file references or phase description), after UAT passes with zero issues, suggest the design quality workflow:
 
@@ -101,15 +117,16 @@ If the phase involves frontend work (detected from PLAN.md file references or ph
 
 This is advisory — user can skip by running the next command directly.
 
-### 7. Update State
+### 8. Update State
 
 Update `.planning/STATE.md` to reflect verification status.
 
 ### Agents Used
 | Agent | File | Role |
 |-------|------|------|
+| `red-team-qa` | `~/.claude/agents/red-team-qa.md` | Adversarial QA — tries to break the implementation |
 | `qualia-planner` | `~/.claude/agents/qualia-planner.md` | Creates fix plans from diagnosed gaps |
 | `qualia-plan-checker` | `~/.claude/agents/qualia-plan-checker.md` | Validates fix plans (max 3 iterations) |
 
 ---
-> Stuck? Type `/qualia-idk` · Lost? Type `/qualia-help`
+> Stuck? Type `/qualia-idk` · Lost? Type `/qualia-help` · Done for today? Type `/qualia-report`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qualia-framework",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "Qualia Solutions — Claude Code Framework",
   "bin": {
     "qualia-framework": "./bin/cli.js"