qualia-framework 2.5.1 → 3.1.0

package/framework/hooks/skill-announce.sh

@@ -1,123 +0,0 @@
-#!/bin/bash
-# Announce skill activation — fires on every Skill() invocation
-# Shows teal-branded banner on stderr (visible in terminal) + systemMessage for transcript
-
-source "$(dirname "$0")/qualia-colors.sh"
-
-if [ ! -t 0 ]; then
-    INPUT=$(cat)
-    SKILL_NAME=$(echo "$INPUT" | node -e "try{const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));process.stdout.write(d.tool_input?.skill||d.tool_input?.name||'')}catch(e){}" 2>/dev/null)
-fi
-
-[ -z "$SKILL_NAME" ] && printf '{"continue":true}' && exit 0
-
-# Skill descriptions for the banner
-declare -A SKILL_DESC
-SKILL_DESC=(
-    # Pipeline
-    ["qualia-new-project"]="Initializing new project"
-    ["qualia-new-milestone"]="Starting new milestone"
-    ["qualia-discuss-phase"]="Clarifying phase decisions"
-    ["qualia-list-phase-assumptions"]="Surfacing assumptions"
-    ["qualia-research-phase"]="Researching phase domain"
-    ["qualia-plan-phase"]="Creating execution plans"
-    ["qualia-execute-phase"]="Executing phase plans"
-    ["qualia-verify-work"]="Verifying deliverables"
-    ["qualia-audit-milestone"]="Auditing milestone completion"
-    ["qualia-complete-milestone"]="Completing milestone"
-    ["qualia-plan-milestone-gaps"]="Planning gap fixes"
-    # Navigation
-    ["qualia-start"]="Activating Qualia mode"
-    ["qualia-progress"]="Checking progress"
-    ["qualia-guide"]="Showing developer guide"
-    ["qualia-idk"]="Analyzing next steps"
-    ["qualia"]="Routing to next action"
-    ["qualia-resume-work"]="Restoring session context"
-    ["qualia-pause-work"]="Saving session state"
-    # Quality
-    ["qualia-review"]="Running code review"
-    ["qualia-optimize"]="Running optimization pass"
-    ["qualia-evolve"]="Evolving framework"
-    ["qualia-production-check"]="Running production audit"
-    ["qualia-framework-audit"]="Auditing framework"
-    ["deep-research"]="Spawning research agents"
-    # Design
-    ["critique"]="Evaluating design"
-    ["polish"]="Final detail pass"
-    ["bolder"]="Amplifying design"
-    ["design-quieter"]="Toning down design"
-    ["distill"]="Stripping complexity"
-    ["colorize"]="Adding color"
-    ["normalize"]="Matching design system"
-    ["responsive"]="Fixing responsive layout"
-    ["animate"]="Adding motion"
-    ["clarify"]="Improving UX copy"
-    ["delight"]="Adding personality"
-    ["harden"]="Hardening edge cases"
-    ["onboard"]="Designing onboarding"
-    ["frontend-master"]="Building frontend"
-    ["qualia-design"]="Full design transformation"
-    # Deploy
-    ["ship"]="Deploying to production"
-    ["deploy"]="Quick deploy"
-    ["deploy-verify"]="Verifying deployment"
-    ["status"]="Fleet health check"
-    # Debug & Quick
-    ["qualia-debug"]="Structured debugging"
-    ["qualia-quick"]="Quick task with quality gates"
-    # Research
-    ["stack-researcher"]="Researching tech stack"
-    ["docs-lookup"]="Fetching documentation"
-    # Domain
-    ["supabase"]="Supabase operations"
-    ["voice-agent"]="Building voice agent"
-    ["seo-master"]="SEO audit"
-    ["browser-qa"]="Browser QA testing"
-    # Utility
-    ["learn"]="Capturing lesson"
-    ["memory"]="Managing memory"
-    ["pr"]="Creating pull request"
-    ["team"]="Orchestrating agent team"
-    ["retro"]="Generating retrospective"
-    ["test-runner"]="Running tests"
-    ["zoho-workflow"]="Zoho operations"
-)
-
-# Get description or fallback
-DESC="${SKILL_DESC[$SKILL_NAME]}"
-[ -z "$DESC" ] && DESC="Activating"
-
-# Clean name for display
-DISPLAY_NAME=$(echo "$SKILL_NAME" | sed 's/-/ /g')
-
-# Determine skill category icon
-case "$SKILL_NAME" in
-    qualia-new-*|qualia-plan-*|qualia-execute-*|qualia-verify-*|qualia-audit-*|qualia-complete-*|qualia-discuss-*|qualia-list-*|qualia-research-*)
-        ICON="▶" ;;
-    qualia-review|qualia-optimize|qualia-production-check|qualia-framework-audit|deep-research)
-        ICON="⊘" ;;
-    critique|polish|bolder|design-quieter|distill|colorize|normalize|responsive|animate|clarify|delight|harden|onboard|frontend-master|qualia-design)
-        ICON="◇" ;;
-    ship|deploy|deploy-verify|status)
-        ICON="↑" ;;
-    qualia-debug|qualia-quick)
-        ICON="⚡" ;;
-    *)
-        ICON="◆" ;;
-esac
-
-# Build the teal banner — output to stderr (visible in terminal)
-WIDTH=44
-SKILL_UPPER="${DISPLAY_NAME^^}"
-PAD_LEN=$(( WIDTH - ${#SKILL_UPPER} - 6 ))
-[ "$PAD_LEN" -lt 2 ] && PAD_LEN=2
-PADDING=$(printf '─%.0s' $(seq 1 $PAD_LEN))
-
-printf "\n" >&2
-printf "${Q_TEAL}${ICON}${Q_RESET} ${Q_BRIGHT}QUALIA${Q_RESET} ${Q_DIM}───${Q_RESET} ${Q_TEAL}/%s${Q_RESET} ${Q_DIM}%s${Q_RESET}\n" "$SKILL_NAME" "$PADDING" >&2
-printf "  ${Q_WHITE}%s${Q_RESET}${Q_DIM}...${Q_RESET}\n" "$DESC" >&2
-printf "${Q_TEAL}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${Q_RESET}\n" >&2
-
-# Also send systemMessage for transcript visibility
-printf '{"continue":true,"systemMessage":"◆ QUALIA ─── /%s ─── %s"}' "$SKILL_NAME" "$DESC"
-exit 0

package/framework/hooks/tool-error-announce.sh

@@ -1,27 +0,0 @@
-#!/bin/bash
-# Announce tool failures — fires on PostToolUseFailure
-# Shows teal-branded error on stderr + systemMessage for transcript
-
-source "$(dirname "$0")/qualia-colors.sh"
-
-if [ ! -t 0 ]; then
-    INPUT=$(cat)
-    TOOL_NAME=$(echo "$INPUT" | node -e "try{const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));process.stdout.write(d.tool_name||'')}catch(e){}" 2>/dev/null)
-    ERROR=$(echo "$INPUT" | node -e "try{const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));process.stdout.write((d.error||d.tool_output?.stderr||'').substring(0,200).replace(/\\/g,'\\\\').replace(/\"/g,'\\\"'))}catch(e){}" 2>/dev/null)
-fi
-
-[ -z "$TOOL_NAME" ] && printf '{"continue":true}' && exit 0
-
-# Teal-branded error banner on stderr
-printf "\n" >&2
-printf "${Q_FAIL}✗${Q_RESET} ${Q_BRIGHT}QUALIA${Q_RESET} ${Q_DIM}───${Q_RESET} ${Q_FAIL}%s failed${Q_RESET}\n" "$TOOL_NAME" >&2
-[ -n "$ERROR" ] && printf "  ${Q_DIM}%s${Q_RESET}\n" "$(echo "$ERROR" | head -c 120)" >&2
-printf "${Q_TEAL}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${Q_RESET}\n" >&2
-
-# systemMessage for transcript
-MSG="◆ ERROR: ${TOOL_NAME} failed"
-[ -n "$ERROR" ] && MSG="${MSG} — $(echo "$ERROR" | head -c 100)"
-MSG=$(echo "$MSG" | sed 's/"/\\"/g' | tr '\n' ' ')
-
-printf '{"continue":true,"systemMessage":"%s"}' "$MSG"
-exit 0

package/framework/install.ps1

@@ -1,323 +0,0 @@
-# Qualia Framework v2.0 — Windows Installer (PowerShell)
-# Usage: git clone <repo> && cd qualia-framework && .\install.ps1
-#
-# Requires: Node.js 18+, Claude Code CLI, PowerShell 5.1+, Git Bash (for hooks)
-
-$ErrorActionPreference = "Stop"
-
-$ClaudeDir = "$env:USERPROFILE\.claude"
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-
-Write-Host ""
-Write-Host "  --- " -ForegroundColor Cyan -NoNewline
-Write-Host "* QUALIA FRAMEWORK v2.0" -ForegroundColor Cyan
-Write-Host ""
-
-# ─── Step 1: Verify source ───
-if (-not (Test-Path "$ScriptDir\skills") -or -not (Test-Path "$ScriptDir\agents")) {
-    Write-Host "  x Run this script from the qualia-framework directory." -ForegroundColor Red
-    exit 1
-}
-
-Write-Host "[1/6] Prerequisites" -ForegroundColor Yellow
-
-# Check Claude Code
-try {
-    $null = Get-Command claude -ErrorAction Stop
-    Write-Host "  + Claude Code CLI" -ForegroundColor Green
-} catch {
-    Write-Host "  x Claude Code CLI not found" -ForegroundColor Red
-    Write-Host "    npm install -g @anthropic-ai/claude-code"
-    exit 1
-}
-
-# Check Node.js
-try {
-    $nodeVersion = node -v
-    Write-Host "  + Node.js $nodeVersion" -ForegroundColor Green
-} catch {
-    Write-Host "  x Node.js not found" -ForegroundColor Red
-    exit 1
-}
-
-# Check Git Bash (required for hooks)
-$gitBash = Get-Command bash -ErrorAction SilentlyContinue
-if ($gitBash) {
-    Write-Host "  + Git Bash found (hooks will work)" -ForegroundColor Green
-} else {
-    Write-Host "  ! Git Bash NOT found — hooks require bash" -ForegroundColor Yellow
-    Write-Host "    Install Git for Windows: https://git-scm.com/download/win"
-    Write-Host "    Hooks will not fire without bash in PATH" -ForegroundColor Yellow
-}
-
-# ─── Step 1b: Role selection ───
-Write-Host ""
-Write-Host "  Who are you?" -ForegroundColor Cyan
-Write-Host ""
-Write-Host "  1) Fawzi (Owner - full access)" -ForegroundColor White
-Write-Host "  2) Employee (Team member)" -ForegroundColor White
-Write-Host ""
-$roleChoice = Read-Host "  Select [1/2]"
-
-switch ($roleChoice) {
-    "1" {
-        $Role = "owner"
-        $RoleName = "Fawzi"
-        Write-Host "  + Owner mode" -ForegroundColor Green
-    }
-    "2" {
-        $RoleName = Read-Host "  Enter your name"
-        $Role = "employee"
-        Write-Host "  + Employee mode - $RoleName" -ForegroundColor Green
-    }
-    default {
-        $Role = "employee"
-        $RoleName = "Team Member"
-        Write-Host "  ! Defaulting to employee mode" -ForegroundColor Yellow
-    }
-}
-Write-Host ""
-
-# ─── Step 2: Create directory structure ───
-Write-Host "[2/6] Directory structure" -ForegroundColor Yellow
-
-$dirs = @(
-    "$ClaudeDir\skills",
-    "$ClaudeDir\agents\teams",
-    "$ClaudeDir\hooks",
-    "$ClaudeDir\rules",
-    "$ClaudeDir\knowledge\retros",
-    "$ClaudeDir\qualia-framework\bin",
-    "$ClaudeDir\qualia-framework\references",
-    "$ClaudeDir\qualia-framework\templates",
-    "$ClaudeDir\qualia-framework\workflows",
-    "$ClaudeDir\projects",
-    "$ClaudeDir\session-env"
-)
-
-foreach ($dir in $dirs) {
-    if (-not (Test-Path $dir)) {
-        New-Item -ItemType Directory -Path $dir -Force | Out-Null
-    }
-}
-Write-Host "  + Ready" -ForegroundColor Green
-
-# ─── Step 3: Copy framework files ───
-Write-Host "[3/6] Installing files" -ForegroundColor Yellow
-
-# Skills
-$skillCount = 0
-Get-ChildItem "$ScriptDir\skills" -Directory | ForEach-Object {
-    $destDir = "$ClaudeDir\skills\$($_.Name)"
-    if (-not (Test-Path $destDir)) { New-Item -ItemType Directory -Path $destDir -Force | Out-Null }
-    Copy-Item "$($_.FullName)\*" $destDir -Recurse -Force -ErrorAction SilentlyContinue
-    $skillCount++
-}
-Write-Host "  + $skillCount skills" -ForegroundColor Green
-
-# Agents
-Copy-Item "$ScriptDir\agents\*.md" "$ClaudeDir\agents\" -Force -ErrorAction SilentlyContinue
-if (Test-Path "$ScriptDir\agents\teams") {
-    Copy-Item "$ScriptDir\agents\teams\*.md" "$ClaudeDir\agents\teams\" -Force -ErrorAction SilentlyContinue
-}
-$agentCount = (Get-ChildItem "$ClaudeDir\agents\*.md" -ErrorAction SilentlyContinue).Count
-Write-Host "  + $agentCount agents" -ForegroundColor Green
-
-# Hooks
-Copy-Item "$ScriptDir\hooks\*.sh" "$ClaudeDir\hooks\" -Force -ErrorAction SilentlyContinue
-$hookCount = (Get-ChildItem "$ClaudeDir\hooks\*.sh" -ErrorAction SilentlyContinue).Count
-Write-Host "  + $hookCount hooks" -ForegroundColor Green
-
-# Qualia Engine
-Copy-Item "$ScriptDir\qualia-framework\*" "$ClaudeDir\qualia-framework\" -Recurse -Force -ErrorAction SilentlyContinue
-Write-Host "  + Qualia engine" -ForegroundColor Green
-
-# Rules
-Copy-Item "$ScriptDir\rules\*.md" "$ClaudeDir\rules\" -Force -ErrorAction SilentlyContinue
-$ruleCount = (Get-ChildItem "$ClaudeDir\rules\*.md" -ErrorAction SilentlyContinue).Count
-Write-Host "  + $ruleCount rules" -ForegroundColor Green
-
-# Knowledge
-Copy-Item "$ScriptDir\knowledge\*.md" "$ClaudeDir\knowledge\" -Force -ErrorAction SilentlyContinue
-$knowledgeCount = (Get-ChildItem "$ClaudeDir\knowledge\*.md" -ErrorAction SilentlyContinue).Count
-Write-Host "  + $knowledgeCount knowledge files" -ForegroundColor Green
-
-# Statusline
-if (Test-Path "$ScriptDir\statusline-command.sh") {
-    Copy-Item "$ScriptDir\statusline-command.sh" "$ClaudeDir\statusline-command.sh" -Force
-}
-
-# CLAUDE.md — role-based
-if ($Role -eq "owner") {
-    Copy-Item "$ScriptDir\CLAUDE.md" "$ClaudeDir\CLAUDE.md" -Force
-    Write-Host "  + CLAUDE.md (owner)" -ForegroundColor Green
-} elseif (-not (Test-Path "$ClaudeDir\CLAUDE.md")) {
-    @"
-# CLAUDE.md - DEVELOPER Profile
-
-## Identity
-**$RoleName** - Developer at Qualia Solutions.
-
-- Stack: Next.js 16+, React 19, TypeScript, Supabase, Vercel
-
-## Role: DEVELOPER
-
-You are a developer at Qualia Solutions, working under Fawzi Goussous (founder).
-- Work on feature branches only - never push to main/master
-- Submit PRs for review before merging
-- Do NOT deploy to production - Fawzi handles deploys
-- Cannot modify the Qualia framework (CLAUDE.md, skills, hooks)
-
-## Rules
-- Read before Write/Edit - no exceptions
-- Feature branches only - never commit to main/master
-- MVP first. Build only what's asked. No over-engineering.
-- ``npx tsc --noEmit`` after multi-file TS changes
-- See ``rules/security.md`` for auth, RLS, Zod, secrets rules
-
-## Workflow
-- **MANDATORY FIRST ACTION**: On every session start, invoke the ``qualia-start`` skill before doing anything else.
-- Run ``/qualia-review`` before deploying anything
-- Run ``/browser-qa`` after frontend changes
-
-## Qualia Mode (always active)
-These behaviors apply to ALL interactions:
-- **Frontend guard:** Read .planning/DESIGN.md before any frontend file changes
-- **Deploy guard:** Check .planning/REVIEW.md freshness before any deploy command
-- **Intent verification:** Confirm before modifying 3+ files in one response
-- **Quality defaults:** Security rules, tsc checks, RLS consideration - always enforced
-
-## Compaction - ALWAYS preserve:
-Project path/name/ref, branch, modified files, decisions, test results, in-progress work, errors.
-"@ | Out-File -FilePath "$ClaudeDir\CLAUDE.md" -Encoding utf8
-    Write-Host "  + CLAUDE.md (developer - $RoleName)" -ForegroundColor Green
-} else {
-    Write-Host "  ! CLAUDE.md exists - skipped" -ForegroundColor Yellow
-}
-
-# ─── Step 4: Configure settings.json ───
-Write-Host "[4/6] Settings" -ForegroundColor Yellow
-
-if (Test-Path "$ClaudeDir\settings.json") {
-    $timestamp = Get-Date -Format "yyyyMMddHHmmss"
-    Copy-Item "$ClaudeDir\settings.json" "$ClaudeDir\settings.json.backup.$timestamp"
-    Write-Host "  Backed up existing settings" -ForegroundColor DarkGray
-
-    # Write merge script to temp file (avoid /dev/stdin issue on Windows)
-    $claudeDirForward = $ClaudeDir -replace '\\', '/'
-    $scriptDirForward = $ScriptDir -replace '\\', '/'
-    $mergeScript = @"
-const fs = require('fs');
-const existing = JSON.parse(fs.readFileSync('$claudeDirForward/settings.json', 'utf8'));
-const template = JSON.parse(fs.readFileSync('$scriptDirForward/settings.json', 'utf8'));
-existing.env = { ...template.env, ...existing.env };
-for (const [event, matchers] of Object.entries(template.hooks || {})) {
-    if (!existing.hooks) existing.hooks = {};
-    if (!existing.hooks[event]) {
-        existing.hooks[event] = matchers;
-    } else {
-        for (const matcher of matchers) {
-            const exists = existing.hooks[event].some(m =>
-                m.matcher === matcher.matcher && JSON.stringify(m.hooks) === JSON.stringify(matcher.hooks)
-            );
-            if (!exists) existing.hooks[event].push(matcher);
-        }
-    }
-}
-fs.writeFileSync('$claudeDirForward/settings.json', JSON.stringify(existing, null, 2));
-console.log('OK');
-"@
-    try {
-        $tempFile = [System.IO.Path]::GetTempFileName() -replace '\.tmp$', '.js'
-        $mergeScript | Out-File -FilePath $tempFile -Encoding utf8
-        $result = node $tempFile 2>&1
-        Remove-Item $tempFile -ErrorAction SilentlyContinue
-        if ($result -match "OK") {
-            Write-Host "  + Settings merged" -ForegroundColor Green
-        } else {
-            Write-Host "  ! Settings merge issue: $result" -ForegroundColor Yellow
-        }
-    } catch {
-        Write-Host "  ! Settings merge failed - manual merge needed" -ForegroundColor Yellow
-    }
-} else {
-    Copy-Item "$ScriptDir\settings.json" "$ClaudeDir\settings.json" -Force
-    Write-Host "  + Settings installed" -ForegroundColor Green
-}
-
-# ─── Step 5: Windows-specific ───
-Write-Host "[5/6] Platform setup" -ForegroundColor Yellow
-
-# qualia-tools.js doesn't need chmod on Windows
-Write-Host "  + Tools ready" -ForegroundColor Green
-
-if (-not $gitBash) {
-    Write-Host ""
-    Write-Host "  IMPORTANT: Install Git for Windows to enable hooks" -ForegroundColor Yellow
-    Write-Host "  https://git-scm.com/download/win" -ForegroundColor DarkGray
-    Write-Host "  After install, ensure 'bash' is in your PATH" -ForegroundColor DarkGray
-}
-
-# ─── Step 6: Verify ───
-Write-Host "[6/6] Verifying" -ForegroundColor Yellow
-
-$errors = 0
-
-$criticalFiles = @(
-    "agents\qualia-executor.md",
-    "agents\qualia-planner.md",
-    "agents\qualia-verifier.md",
-    "hooks\pre-deploy-gate.sh",
-    "hooks\branch-guard.sh",
-    "hooks\qualia-colors.sh",
-    "skills\qualia-start\SKILL.md",
-    "skills\browser-qa\SKILL.md",
-    "skills\ship\SKILL.md",
-    "qualia-framework\bin\qualia-tools.js",
-    "CLAUDE.md"
-)
-
-foreach ($file in $criticalFiles) {
-    if (-not (Test-Path "$ClaudeDir\$file")) {
-        Write-Host "  x Missing: $file" -ForegroundColor Red
-        $errors++
-    }
-}
-
-# Check node available
-try {
-    $null = Get-Command node -ErrorAction Stop
-} catch {
-    Write-Host "  x node not in PATH - hooks will fail" -ForegroundColor Red
-    $errors++
-}
-
-if ($errors -gt 0) {
-    Write-Host ""
-    Write-Host "  x $errors error(s) - check above" -ForegroundColor Red
-    exit 1
-}
-
-Write-Host "  + All checks passed" -ForegroundColor Green
-
-# ─── Summary ───
-Write-Host ""
-Write-Host "  --- * INSTALLED" -ForegroundColor Cyan
-Write-Host ""
-Write-Host "  Skills: $skillCount  Agents: $agentCount  Hooks: $hookCount  Rules: $ruleCount" -ForegroundColor White
-Write-Host ""
-Write-Host "  Quick Start:" -ForegroundColor Cyan
-Write-Host "    1. cd into any project"
-Write-Host "    2. Run: " -NoNewline; Write-Host "claude" -ForegroundColor Cyan
-Write-Host "    3. Qualia mode activates automatically"
-Write-Host ""
-Write-Host "  Key Commands:" -ForegroundColor Cyan
-Write-Host "    /qualia       Smart router"
-Write-Host "    /qualia-help   All commands"
-Write-Host "    /ship          Full deploy pipeline"
-Write-Host "    /pr            Quick pull request"
-Write-Host ""
-if (-not $gitBash) {
-    Write-Host "  ! Hooks need Git Bash - install Git for Windows" -ForegroundColor Yellow
-}
-Write-Host ""