qualia-framework 2.5.1 → 3.1.0

package/framework/install.sh

@@ -1,313 +0,0 @@
-#!/bin/bash
-# Qualia Framework v2.0 — Linux Installer
-# Usage: git clone <repo> && cd qualia-framework && ./install.sh
-#
-# Tested on: Ubuntu 22.04+, Pop!_OS 22.04+, Endeavour OS (Arch), Cosmic
-# Requires: Node.js 18+, Claude Code CLI, bash 4+
-#
-# What it does:
-# 1. Copies all framework files to ~/.claude/
-# 2. Sets up hooks, agents, skills, engine, knowledge, rules
-# 3. Configures settings.json (merges with existing)
-# 4. Makes hooks executable
-# 5. Verifies installation
-
-set -euo pipefail
-
-# Colors (Qualia teal palette)
-Q_TEAL='\033[38;2;0;188;175m'
-Q_BRIGHT='\033[38;2;45;226;210m'
-Q_PASS='\033[38;2;52;211;153m'
-Q_WARN='\033[38;2;234;179;8m'
-Q_FAIL='\033[38;2;239;68;68m'
-Q_WHITE='\033[38;2;220;225;230m'
-Q_DIM='\033[38;2;70;78;88m'
-Q_RESET='\033[0m'
-
-CLAUDE_DIR="$HOME/.claude"
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-printf "\n"
-printf "${Q_TEAL}━━━${Q_RESET} ${Q_BRIGHT}◆ QUALIA FRAMEWORK v2.0${Q_RESET}\n"
-printf "\n"
-
-# ─── Step 1: Verify source ───
-if [ ! -d "$SCRIPT_DIR/skills" ] || [ ! -d "$SCRIPT_DIR/agents" ]; then
-    printf "${Q_FAIL}  ✗ Run this script from the qualia-framework directory.${Q_RESET}\n"
-    exit 1
-fi
-
-printf "${Q_WARN}[1/6] Prerequisites${Q_RESET}\n"
-
-# Check Claude Code
-if ! command -v claude >/dev/null 2>&1; then
-    printf "${Q_FAIL}  ✗ Claude Code CLI not found${Q_RESET}\n"
-    printf "    npm install -g @anthropic-ai/claude-code\n"
-    exit 1
-fi
-printf "${Q_PASS}  ✓ Claude Code CLI${Q_RESET}\n"
-
-# Check Node.js
-if ! command -v node >/dev/null 2>&1; then
-    printf "${Q_FAIL}  ✗ Node.js not found${Q_RESET}\n"
-    exit 1
-fi
-printf "${Q_PASS}  ✓ Node.js $(node -v)${Q_RESET}\n"
-
-# Check optional deps
-command -v jq >/dev/null 2>&1 && printf "${Q_PASS}  ✓ jq${Q_RESET}\n" || printf "${Q_WARN}  ▲ jq not found (optional — deploy-verify scripts need it)${Q_RESET}\n"
-command -v bc >/dev/null 2>&1 && printf "${Q_PASS}  ✓ bc${Q_RESET}\n" || printf "${Q_WARN}  ▲ bc not found (optional — install: pacman -S bc / apt install bc)${Q_RESET}\n"
-
-# ─── Step 1b: Role selection ───
-printf "\n${Q_BRIGHT}Who are you?${Q_RESET}\n\n"
-printf "  1) ${Q_WHITE}Fawzi${Q_RESET} (Owner — full access)\n"
-printf "  2) ${Q_WHITE}Employee${Q_RESET} (Team member — guided workflow)\n\n"
-
-# Read from terminal even if script is piped
-read -rp "Select [1/2]: " ROLE_CHOICE </dev/tty
-
-case "$ROLE_CHOICE" in
-    1)
-        ROLE="owner"
-        ROLE_NAME="Fawzi"
-        printf "${Q_PASS}  ✓ Owner mode${Q_RESET}\n"
-        ;;
-    2)
-        read -rp "Enter your name: " EMPLOYEE_NAME </dev/tty
-        ROLE="employee"
-        ROLE_NAME="$EMPLOYEE_NAME"
-        printf "${Q_PASS}  ✓ Employee mode — $ROLE_NAME${Q_RESET}\n"
-        ;;
-    *)
-        ROLE="employee"
-        ROLE_NAME="Team Member"
-        printf "${Q_WARN}  ▲ Defaulting to employee mode${Q_RESET}\n"
-        ;;
-esac
-
-printf "\n"
-
-# ─── Step 2: Create directory structure ───
-printf "${Q_WARN}[2/6] Directory structure${Q_RESET}\n"
-
-mkdir -p "$CLAUDE_DIR"/{skills,agents,hooks,rules,knowledge/retros,qualia-framework/{bin,references,templates,workflows},projects,session-env}
-
-printf "${Q_PASS}  ✓ Ready${Q_RESET}\n"
-
-# ─── Step 3: Copy framework files ───
-printf "${Q_WARN}[3/6] Installing files${Q_RESET}\n"
-
-# Skills
-SKILL_COUNT=0
-for skill_dir in "$SCRIPT_DIR"/skills/*/; do
-    skill_name=$(basename "$skill_dir")
-    mkdir -p "$CLAUDE_DIR/skills/$skill_name"
-    cp -r "$skill_dir"* "$CLAUDE_DIR/skills/$skill_name/" 2>/dev/null || true
-    SKILL_COUNT=$((SKILL_COUNT + 1))
-done
-printf "${Q_PASS}  ✓ $SKILL_COUNT skills${Q_RESET}\n"
-
-# Agents
-cp "$SCRIPT_DIR"/agents/*.md "$CLAUDE_DIR/agents/" 2>/dev/null || true
-if [ -d "$SCRIPT_DIR/agents/teams" ]; then
-    mkdir -p "$CLAUDE_DIR/agents/teams"
-    cp "$SCRIPT_DIR"/agents/teams/*.md "$CLAUDE_DIR/agents/teams/" 2>/dev/null || true
-fi
-AGENT_COUNT=$(find "$CLAUDE_DIR/agents" -maxdepth 1 -name "*.md" -type f | wc -l)
-printf "${Q_PASS}  ✓ $AGENT_COUNT agents${Q_RESET}\n"
-
-# Hooks
-cp "$SCRIPT_DIR"/hooks/*.sh "$CLAUDE_DIR/hooks/" 2>/dev/null || true
-chmod +x "$CLAUDE_DIR"/hooks/*.sh
-HOOK_COUNT=$(find "$CLAUDE_DIR/hooks" -name "*.sh" -type f | wc -l)
-printf "${Q_PASS}  ✓ $HOOK_COUNT hooks${Q_RESET}\n"
-
-# Qualia Engine
-cp -r "$SCRIPT_DIR"/qualia-framework/* "$CLAUDE_DIR/qualia-framework/" 2>/dev/null || true
-# Clean up old path if it exists from previous installs
-[ -d "$CLAUDE_DIR/qualia-engine" ] && rm -rf "$CLAUDE_DIR/qualia-engine"
-printf "${Q_PASS}  ✓ Qualia engine${Q_RESET}\n"
-
-# Rules
-cp "$SCRIPT_DIR"/rules/*.md "$CLAUDE_DIR/rules/" 2>/dev/null || true
-RULE_COUNT=$(find "$CLAUDE_DIR/rules" -name "*.md" -type f | wc -l)
-printf "${Q_PASS}  ✓ $RULE_COUNT rules${Q_RESET}\n"
-
-# Knowledge base
-cp "$SCRIPT_DIR"/knowledge/*.md "$CLAUDE_DIR/knowledge/" 2>/dev/null || true
-KNOWLEDGE_COUNT=$(find "$CLAUDE_DIR/knowledge" -maxdepth 1 -name "*.md" -type f | wc -l)
-printf "${Q_PASS}  ✓ $KNOWLEDGE_COUNT knowledge files${Q_RESET}\n"
-
-# Statusline
-[ -f "$SCRIPT_DIR/statusline-command.sh" ] && cp "$SCRIPT_DIR/statusline-command.sh" "$CLAUDE_DIR/statusline-command.sh" && chmod +x "$CLAUDE_DIR/statusline-command.sh"
-
-# CLAUDE.md — role-based
-if [ "$ROLE" = "owner" ]; then
-    cp "$SCRIPT_DIR/CLAUDE.md" "$CLAUDE_DIR/CLAUDE.md"
-    printf "${Q_PASS}  ✓ CLAUDE.md (owner)${Q_RESET}\n"
-elif [ ! -f "$CLAUDE_DIR/CLAUDE.md" ]; then
-    cat > "$CLAUDE_DIR/CLAUDE.md" << EMPLOYEE_EOF
-# CLAUDE.md — DEVELOPER Profile
-
-## Identity
-**$ROLE_NAME** — Developer at Qualia Solutions.
-
-- Stack: Next.js 16+, React 19, TypeScript, Supabase, Vercel, Retell AI, ElevenLabs, Telnyx, OpenRouter
-
-## Role: DEVELOPER
-
-You are a developer at Qualia Solutions, working under Fawzi Goussous (founder).
-- Work on feature branches only — never push to main/master
-- Use \`/ship\` to deploy — it runs quality gates, auto-creates feature branches, and deploys
-- Cannot modify the Qualia framework (CLAUDE.md, skills, hooks)
-- Ask Fawzi when unsure about architecture decisions
-
-## 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
-- See \`rules/frontend.md\` for design standards
-
-## Getting Started
-- Run \`/collab-onboard\` when joining a new project — it explains what's built and how to contribute
-- Onboarding guide: ~/Projects/qualia-erp/docs/trainee-onboarding.md
-
-## Workflow
-- **MANDATORY FIRST ACTION**: On every session start, invoke the \`qualia-start\` skill before doing anything else.
-- Run \`/qualia-review\` before deploying
-- Run \`/browser-qa\` after frontend changes
-- Run \`/pr\` to submit work for review — never push to main directly
-- Run \`/qualia-idk\` if stuck — it suggests next steps and can escalate to Fawzi
-- Ask for help if stuck — don't guess
-
-## 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, Qualia mode active/inactive state.
-EMPLOYEE_EOF
-    printf "${Q_PASS}  ✓ CLAUDE.md (developer — $ROLE_NAME)${Q_RESET}\n"
-else
-    printf "${Q_WARN}  ▲ CLAUDE.md exists — skipped${Q_RESET}\n"
-fi
-
-# ─── Step 4: Configure settings.json ───
-printf "${Q_WARN}[4/6] Settings${Q_RESET}\n"
-
-if [ -f "$CLAUDE_DIR/settings.json" ]; then
-    cp "$CLAUDE_DIR/settings.json" "$CLAUDE_DIR/settings.json.backup.$(date +%s)"
-    printf "${Q_DIM}  Backed up existing settings${Q_RESET}\n"
-
-    node -e "
-const fs = require('fs');
-const existing = JSON.parse(fs.readFileSync('$CLAUDE_DIR/settings.json', 'utf8'));
-const template = JSON.parse(fs.readFileSync('$SCRIPT_DIR/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('$CLAUDE_DIR/settings.json', JSON.stringify(existing, null, 2));
-" 2>/dev/null && printf "${Q_PASS}  ✓ Settings merged${Q_RESET}\n" || printf "${Q_WARN}  ▲ Settings merge failed — manual merge needed${Q_RESET}\n"
-else
-    cp "$SCRIPT_DIR/settings.json" "$CLAUDE_DIR/settings.json"
-    printf "${Q_PASS}  ✓ Settings installed${Q_RESET}\n"
-fi
-
-# ─── Step 5: Platform setup ───
-printf "${Q_WARN}[5/6] Platform setup${Q_RESET}\n"
-
-# Make qualia-tools executable
-[ -f "$CLAUDE_DIR/qualia-framework/bin/qualia-tools.js" ] && chmod +x "$CLAUDE_DIR/qualia-framework/bin/qualia-tools.js"
-
-# Askpass helper (works with zenity, kdialog, or falls back to terminal)
-if [ ! -f "$CLAUDE_DIR/askpass.sh" ]; then
-    cat > "$CLAUDE_DIR/askpass.sh" << 'ASKPASS_EOF'
-#!/bin/bash
-if command -v zenity >/dev/null 2>&1; then
-    zenity --password --title="sudo password" 2>/dev/null
-elif command -v kdialog >/dev/null 2>&1; then
-    kdialog --password "sudo password" 2>/dev/null
-else
-    read -rsp "Password: " pass </dev/tty
-    echo "$pass"
-fi
-ASKPASS_EOF
-    chmod +x "$CLAUDE_DIR/askpass.sh"
-fi
-
-printf "${Q_PASS}  ✓ Tools ready${Q_RESET}\n"
-
-# Detect distro
-if [ -f /etc/os-release ]; then
-    DISTRO=$(grep -oP '(?<=^ID=).+' /etc/os-release | tr -d '"')
-    printf "${Q_DIM}  Detected: $DISTRO${Q_RESET}\n"
-fi
-
-# ─── Step 6: Verify ───
-printf "${Q_WARN}[6/6] Verifying${Q_RESET}\n"
-
-ERRORS=0
-
-for check in \
-    "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"; do
-    if [ ! -f "$CLAUDE_DIR/$check" ]; then
-        printf "${Q_FAIL}  ✗ Missing: $check${Q_RESET}\n"
-        ERRORS=$((ERRORS + 1))
-    fi
-done
-
-# Check hooks executable
-for hook in "$CLAUDE_DIR"/hooks/*.sh; do
-    [ -x "$hook" ] || { printf "${Q_FAIL}  ✗ Not executable: $(basename "$hook")${Q_RESET}\n"; ERRORS=$((ERRORS + 1)); }
-done
-
-# Check node available for hooks
-command -v node >/dev/null 2>&1 || { printf "${Q_FAIL}  ✗ node not in PATH — hooks will silently fail${Q_RESET}\n"; ERRORS=$((ERRORS + 1)); }
-
-if [ "$ERRORS" -gt 0 ]; then
-    printf "\n${Q_FAIL}  ✗ $ERRORS error(s) — check above${Q_RESET}\n"
-    exit 1
-fi
-
-printf "${Q_PASS}  ✓ All checks passed${Q_RESET}\n"
-
-# ─── Summary ───
-printf "\n"
-printf "${Q_TEAL}━━━${Q_RESET} ${Q_BRIGHT}◆ INSTALLED${Q_RESET}\n\n"
-printf "  ${Q_WHITE}Skills: $SKILL_COUNT  Agents: $AGENT_COUNT  Hooks: $HOOK_COUNT  Rules: $RULE_COUNT${Q_RESET}\n\n"
-printf "  ${Q_BRIGHT}Quick Start:${Q_RESET}\n"
-printf "    1. ${Q_DIM}cd${Q_RESET} into any project\n"
-printf "    2. Run ${Q_TEAL}claude${Q_RESET}\n"
-printf "    3. Qualia mode activates automatically\n\n"
-printf "  ${Q_BRIGHT}Key Commands:${Q_RESET}\n"
-printf "    ${Q_TEAL}/qualia${Q_RESET}         Smart router — tells you what to do next\n"
-printf "    ${Q_TEAL}/qualia-help${Q_RESET}    All available commands\n"
-printf "    ${Q_TEAL}/ship${Q_RESET}           Full deploy pipeline\n"
-printf "    ${Q_TEAL}/pr${Q_RESET}             Quick pull request\n\n"

package/framework/qualia-framework/VERSION

@@ -1 +0,0 @@
-2.5.1

package/framework/qualia-framework/bin/collect-metrics.sh

@@ -1,67 +0,0 @@
-#!/bin/bash
-# Qualia Framework Metrics Collection
-# Run after a project ships to capture performance data.
-# Usage: collect-metrics.sh [project-dir]
-# Output: appends to ~/.claude/knowledge/framework-metrics.md
-
-PROJECT_DIR="${1:-.}"
-METRICS_FILE="$HOME/.claude/knowledge/framework-metrics.md"
-DATE=$(date +%Y-%m-%d)
-
-# Ensure metrics file exists
-if [ ! -f "$METRICS_FILE" ]; then
-  cat > "$METRICS_FILE" << 'HEADER'
-# Framework Performance Metrics
-
-> Auto-collected after each project ships. Read by `/qualia-evolve` to optimize the framework.
-
-| Date | Project | Phases | Sessions | Deviations | IDK Calls | Verify Pass Rate | Lab Notes | FQS |
-|------|---------|--------|----------|------------|-----------|-----------------|-----------|-----|
-HEADER
-fi
-
-cd "$PROJECT_DIR" || exit 1
-
-# Project name
-PROJECT=$(basename "$(pwd)")
-
-# Phase count
-PHASES=$(ls -d .planning/phases/*/ 2>/dev/null | wc -l)
-
-# Session count (from session-digest entries for this project)
-SESSIONS=$(grep -c "$PROJECT" ~/.claude/knowledge/session-digest.md 2>/dev/null || echo "?")
-
-# Deviation count (gap-fix plans)
-DEVIATIONS=$(find .planning/phases/ -name "*-PLAN.md" -exec grep -l "gaps" {} \; 2>/dev/null | wc -l)
-
-# IDK calls (search session digest for qualia-idk mentions with this project)
-IDK_CALLS=$(grep "$PROJECT" ~/.claude/knowledge/session-digest.md 2>/dev/null | grep -c "idk\|stuck\|lost" || echo "0")
-
-# Verify pass rate (UAT files with PASSED vs total UAT files)
-TOTAL_UAT=$(find .planning/phases/ -name "*-UAT.md" 2>/dev/null | wc -l)
-PASSED_UAT=$(grep -rl "PASSED\|✅.*Overall" .planning/phases/*/*.md 2>/dev/null | wc -l)
-if [ "$TOTAL_UAT" -gt 0 ]; then
-  PASS_RATE=$(( PASSED_UAT * 100 / TOTAL_UAT ))%
-else
-  PASS_RATE="n/a"
-fi
-
-# Lab Notes count
-LAB_NOTES=$(grep -c "^###" .planning/lab-notes.md 2>/dev/null || echo "0")
-
-# Completion rate from ROADMAP.md (case-insensitive, allows indentation)
-TOTAL_PLANS=$(grep -ciE "^\s*- \[" .planning/ROADMAP.md 2>/dev/null || echo "0")
-COMPLETED_PLANS=$(grep -ciE "^\s*- \[x\]" .planning/ROADMAP.md 2>/dev/null || echo "0")
-
-# FQS = (completion_fraction) / sessions * 100 (per OBJECTIVE.md)
-# = COMPLETED_PLANS * 100 / (TOTAL_PLANS * SESSIONS)
-if [ "$TOTAL_PLANS" -gt 0 ] && [ "$SESSIONS" != "?" ] && [ "$SESSIONS" -gt 0 ]; then
-  FQS=$(( COMPLETED_PLANS * 100 / (TOTAL_PLANS * SESSIONS) ))
-else
-  FQS="?"
-fi
-
-# Append to metrics file
-echo "| $DATE | $PROJECT | $PHASES | $SESSIONS | $DEVIATIONS | $IDK_CALLS | $PASS_RATE | $LAB_NOTES | $FQS |" >> "$METRICS_FILE"
-
-echo "Metrics collected for $PROJECT → $METRICS_FILE"