ctx-cc 3.3.0 → 3.3.1

package/bin/ctx.js

@@ -19,9 +19,9 @@ if (options.help) {
   ╚██████╗   ██║   ██╔╝ ██╗
    ╚═════╝   ╚═╝   ╚═╝  ╚═╝\x1b[0m
 
-  \x1b[1mCTX 2.2 - Continuous Task eXecution\x1b[0m
-  PRD-driven workflow orchestration for Claude Code.
-  8 commands. Story-verified. Debug loop.
+  \x1b[1mCTX 3.3 - Continuous Task eXecution\x1b[0m
+  Intelligent workflow orchestration for Claude Code.
+  20 agents. Learning system. Predictive planning. Self-healing.
 
   \x1b[1mUsage:\x1b[0m
     npx ctx-cc [options]

package/commands/help.md

@@ -4,134 +4,227 @@ description: Show CTX commands and usage guide
 ---
 
 <objective>
-Display the CTX 2.3 command reference.
+Display the CTX 3.3 command reference.
 
 Output ONLY the reference content below. Do NOT add project-specific analysis.
 </objective>
 
 <reference>
-# CTX 2.3 Command Reference
+# CTX 3.3 Command Reference
 
-**CTX** (Continuous Task eXecution) - Smart workflow orchestration for Claude Code.
-8 commands. PRD-driven. Design-first. Smart routing. Debug loop until 100% fixed.
+**CTX** (Continuous Task eXecution) - Intelligent workflow orchestration for Claude Code.
+20 agents. Learning system. Predictive planning. Self-healing. Voice control.
 
 ## Quick Start
 
 ```
 1. /ctx init           Initialize project + generate PRD.json
-2. /ctx                Smart router does the right thing
-3. /ctx status         Check progress (read-only)
-4. /ctx pause          Checkpoint when needed
+2. /ctx map            Build repository map
+3. /ctx                Smart router does the right thing
+4. /ctx status         Check progress (read-only)
 ```
 
-## What's New in 2.3
+## What's New in 3.3
 
-- **Design System Integration** - Full brand + UI design workflow
-- **ctx-designer Agent** - WCAG 2.2 AA, W3C tokens, Figma MCP, Gemini
-- **Story Types** - feature, brand, design, fix, refactor
-- **3 Options Pattern** - Always present A/B/C for design decisions
-- **Visual Approval Gates** - Mood board → Direction → Prototype → Final
-- **BRAND_KIT.md** - Visual foundation with W3C design tokens
-- **EAA 2025 Ready** - European Accessibility Act compliance
+- **Learning System** - CTX learns your patterns, decisions, preferences
+- **Predictive Planning** - AI suggests what to build next with ROI scoring
+- **Self-Healing** - Monitor production errors, auto-create fixes
+- **Voice Control** - Speak commands and dictate stories
 
-## What's in 2.2
+## What's in 3.2
 
-- **Front-Loaded Approach** - Gather ALL info upfront, execute autonomously
-- **PRD.json** - Requirements contract with user stories
-- **Secure Credentials** - `.ctx/.env` for test credentials (gitignored)
-- **Acceptance Criteria** - Each story has verifiable criteria
-- **`passes` Flag** - Auto-tracks story completion
-- **Story-Driven Workflow** - Plan → Execute → Verify → Next Story
+- **Milestone Workflow** - Full release management with git tagging
+- **Team Collaboration** - File locking, conflict detection, notifications
+- **Audit Trail** - SOC2/HIPAA/GDPR compliance logging
+- **Metrics Dashboard** - Stories/day, cost analysis, ROI tracking
 
-## Front-Loaded Philosophy
+## What's in 3.1
 
-```
-/ctx init gathers:
-├── Requirements → PRD.json stories
-├── Context → problem, target user, success criteria
-├── Credentials → .ctx/.env (gitignored)
-└── Constitution → rules for autonomous decisions
-
-Then /ctx runs autonomously:
-├── Only interrupts for architecture decisions
-├── Uses stored credentials for browser testing
-└── Loops until all stories pass
-```
+- **Task Parallelization** - Run independent tasks simultaneously
+- **Pre-Commit Review** - Catch errors before commit
+- **Criteria Auto-Gen** - AI-suggested acceptance criteria
+- **Smart Handoff** - Seamless context transitions
+- **Issue Tracker Sync** - Linear, Jira, GitHub Issues
 
-## The 8 Commands
+## What's in 3.0
 
-### Smart (Auto-routing)
+- **Repository Mapping** - Token-optimized codebase map
+- **Discussion Phase** - Capture decisions before planning
+- **Model Profiles** - quality/balanced/budget routing
+- **Git-Native** - Auto-commit per task
+- **Persistent Debug** - Sessions survive context resets
+- **Parallel Codebase Analysis** - 4 mapper agents
 
+---
+
+## Commands
+
+### Smart (Auto-routing)
 | Command | Purpose |
 |---------|---------|
 | `/ctx` | **Smart router** - reads STATE.md, does the right thing |
-| `/ctx init` | Initialize project with STATE.md |
+| `/ctx init` | Initialize project with STATE.md + PRD.json |
 
-### Inspect (Read-only)
+### Mapping
+| Command | Purpose |
+|---------|---------|
+| `/ctx map` | Build repository map (REPO-MAP.md) |
+| `/ctx map-codebase` | Deep analysis (4 parallel agents) |
 
+### Discussion
 | Command | Purpose |
 |---------|---------|
-| `/ctx status` | See current state without triggering action |
+| `/ctx discuss [story]` | Capture decisions before planning |
+
+### Configuration
+| Command | Purpose |
+|---------|---------|
+| `/ctx profile [name]` | Switch model profile (quality/balanced/budget) |
 
-### Control (Override smart router)
+### Inspect (Read-only)
+| Command | Purpose |
+|---------|---------|
+| `/ctx status` | See current state without triggering action |
 
+### Control (Override)
 | Command | Purpose |
 |---------|---------|
 | `/ctx plan [goal]` | Force research + planning |
 | `/ctx verify` | Force three-level verification |
-| `/ctx quick "task"` | Quick task bypass (skip workflow) |
+| `/ctx quick "task"` | Quick task bypass |
 
 ### Session
-
 | Command | Purpose |
 |---------|---------|
 | `/ctx pause` | Checkpoint for session resume |
 
 ### Phase Management
-
 | Command | Purpose |
 |---------|---------|
-| `/ctx phase list` | Show all phases with status |
-| `/ctx phase add "goal"` | Add new phase to roadmap |
+| `/ctx phase list` | Show all phases |
+| `/ctx phase add "goal"` | Add new phase |
 | `/ctx phase next` | Complete current, move to next |
-| `/ctx phase skip` | Skip current phase |
+
+### Integration
+| Command | Purpose |
+|---------|---------|
+| `/ctx integrate` | Show integration status |
+| `/ctx integrate linear` | Setup Linear |
+| `/ctx integrate jira` | Setup Jira |
+| `/ctx integrate github` | Setup GitHub Issues |
+
+### Milestone
+| Command | Purpose |
+|---------|---------|
+| `/ctx milestone` | Show current milestone |
+| `/ctx milestone list` | List all milestones |
+| `/ctx milestone audit` | Verify completion |
+| `/ctx milestone complete` | Archive and tag |
+| `/ctx milestone new [name]` | Start next version |
+
+### Metrics & Audit
+| Command | Purpose |
+|---------|---------|
+| `/ctx metrics` | Show productivity dashboard |
+| `/ctx metrics cost` | Cost analysis |
+| `/ctx metrics export` | Export HTML dashboard |
+| `/ctx audit` | Show audit summary |
+| `/ctx audit export` | Generate compliance report |
+
+### Learning & Prediction
+| Command | Purpose |
+|---------|---------|
+| `/ctx learn` | Show what CTX has learned |
+| `/ctx learn patterns` | Show code patterns |
+| `/ctx learn decisions` | Show architectural decisions |
+| `/ctx learn forget [id]` | Remove a learned pattern |
+| `/ctx predict` | Get feature suggestions |
+| `/ctx predict --quick` | Quick wins only |
+| `/ctx predict --create [id]` | Create story from suggestion |
+
+### Monitoring & Voice
+| Command | Purpose |
+|---------|---------|
+| `/ctx monitor` | Show monitoring status |
+| `/ctx monitor connect sentry` | Connect Sentry |
+| `/ctx monitor errors` | List recent errors |
+| `/ctx monitor auto-fix [id]` | Auto-fix with PR |
+| `/ctx monitor --watch` | Continuous monitoring |
+| `/ctx voice` | Start voice input |
+| `/ctx voice --continuous` | Always listening mode |
+| `/ctx voice --dictate` | Long-form dictation |
 
 ---
 
 ## Smart Router States
 
-When you run `/ctx`, it reads STATE.md and PRD.json, auto-routes:
-
 | State | What happens |
 |-------|--------------|
-| initializing | Research + Plan for current story |
-| executing | Execute tasks for current story |
-| debugging | **Debug loop until 100% fixed** |
-| verifying | Verify acceptance criteria → mark story as passed |
+| initializing | Research + Map + Plan |
+| discussing | Capture decisions in CONTEXT.md |
+| executing | Execute with git-native commits |
+| debugging | Persistent debug loop (max 10 attempts) |
+| verifying | Three-level verification |
 | paused | Resume from checkpoint |
 
-**Story Flow:**
+## Model Profiles
+
+| Profile | Research | Execute | Verify | Cost |
+|---------|----------|---------|--------|------|
+| quality | Opus | Opus | Sonnet | 3x |
+| balanced | Opus | Sonnet | Haiku | 1x |
+| budget | Sonnet | Sonnet | Haiku | 0.4x |
+
+## 20 Specialized Agents
+
+| Agent | Purpose |
+|-------|---------|
+| ctx-mapper | Repository mapping |
+| ctx-tech-mapper | Technology analysis |
+| ctx-arch-mapper | Architecture analysis |
+| ctx-quality-mapper | Quality analysis |
+| ctx-concerns-mapper | Security/debt analysis |
+| ctx-discusser | Decision capture |
+| ctx-researcher | Web research |
+| ctx-planner | Task planning |
+| ctx-executor | Code execution |
+| ctx-designer | Design/brand work |
+| ctx-debugger | Persistent debugging |
+| ctx-verifier | Three-level verification |
+| ctx-parallelizer | Task parallelization |
+| ctx-reviewer | Pre-commit review |
+| ctx-criteria-suggester | Criteria generation |
+| ctx-handoff | Context transitions |
+| ctx-team-coordinator | Team collaboration |
+| ctx-auditor | Compliance logging |
+| ctx-learner | Pattern learning |
+| ctx-predictor | Feature prediction |
+
+## Key Features
+
+### Learning System
 ```
-S001 → plan → execute → verify ✓ → S002 → plan → execute → verify ✓ → ...
+.ctx/memory/
+├── patterns.json      # Code patterns you prefer
+├── decisions.json     # Past architectural decisions
+├── failures.json      # What didn't work
+└── preferences.json   # Communication style
 ```
 
-## Debug Loop
+### Predictive Planning
+- Pattern matching (e-commerce, SaaS, social)
+- ROI scoring for suggestions
+- Auto story generation
 
-When something breaks, CTX enters debug mode:
+### Self-Healing
+- Sentry, LogRocket, Bugsnag, Datadog
+- Auto-fix safe patterns
+- PR creation with tests
 
-```
-Loop (max 5 attempts):
-  1. Analyze error
-  2. Form hypothesis
-  3. Apply fix
-  4. Verify (build + tests + browser)
-  5. If fixed → done
-     If not → new hypothesis, try again
-```
-
-**Browser verification for UI:**
-- Playwright or Chrome DevTools
-- Screenshots saved to `.ctx/debug/`
+### Voice Control
+- Command recognition
+- Story dictation
+- Continuous listening mode
 
 ## Three-Level Verification
 
@@ -141,148 +234,34 @@ Loop (max 5 attempts):
 | Substantive | Real code, not stub? | No TODOs, no placeholders |
 | Wired | Imported and used? | Trace imports |
 
-## Design Workflow
-
-CTX handles visual work with dedicated agents and approval gates.
+## Context Budget
 
-### Story Types
-| Type | Agent | Purpose |
-|------|-------|---------|
-| feature | ctx-executor | Standard implementation |
-| brand | ctx-designer | BRAND_KIT.md + tokens |
-| design | ctx-designer | UI components/pages |
-| fix | ctx-debugger | Bug fixes |
-| refactor | ctx-executor | Code improvements |
-
-### Design Approval Gates
-```
-Mood Board → Direction (A/B/C) → Prototype → Final
-```
-Each gate requires user approval before proceeding.
-
-### 3 Options Pattern
-All design decisions present:
-- **Option A**: Conservative (safe, proven)
-- **Option B**: Balanced (recommended)
-- **Option C**: Bold (distinctive)
-
-### WCAG 2.2 AA Compliance
-| Criterion | Requirement |
-|-----------|-------------|
-| 2.4.11 | Focus not obscured |
-| 2.5.7 | Drag alternatives |
-| 2.5.8 | 24x24px targets |
-| 3.3.8 | Accessible auth |
-
-### W3C Design Tokens
-```
-tokens/
-├── primitive.tokens.json  # Raw values
-├── semantic.tokens.json   # Purpose aliases
-└── component.tokens.json  # Component-specific
-```
-
-## Key Design Principles
-
-### Atomic Planning (2-3 Tasks Max)
-Prevents context degradation. Big work = multiple phases.
-
-### 95% Auto-Deviation Handling
-| Trigger | Action |
-|---------|--------|
-| Bug in existing code | Auto-fix |
-| Missing validation | Auto-add |
-| Blocking issue | Auto-fix |
-| Architecture decision | Ask user |
-
-### Context Budget
 | Usage | Quality | Action |
 |-------|---------|--------|
 | 0-30% | Peak | Continue |
-| 30-50% | Good | Continue |
-| 50%+ | Degrading | Auto-checkpoint |
-
-## 6 Specialized Agents
-
-| Agent | When spawned |
-|-------|--------------|
-| ctx-researcher | During planning (ArguSeek + ChunkHound) |
-| ctx-planner | After research |
-| ctx-executor | During execution (feature stories) |
-| ctx-designer | During execution (brand/design stories) |
-| ctx-debugger | When debugging |
-| ctx-verifier | During verification |
-
-## Integrations
-
-- **ArguSeek**: Web research during planning
-- **ChunkHound**: Semantic code search (`uv tool install chunkhound`)
-- **Playwright/DevTools**: Browser verification for UI
-- **Figma MCP**: Design context extraction and screenshots
-- **Gemini Design**: Image generation and UI code generation
+| 30-40% | Good | Continue |
+| 40-50% | Good | Prepare handoff |
+| 50-60% | Degrading | Auto-checkpoint |
+| 60-70% | Degrading | Create HANDOFF.md |
+| 70%+ | Poor | Force checkpoint |
 
 ## Directory Structure
 
 ```
 .ctx/
-├── STATE.md          # Living digest - execution state
-├── PRD.json          # Requirements contract - stories + criteria
-├── .env              # Test credentials (GITIGNORED)
-├── .gitignore        # Protects secrets
-├── phases/{story_id}/  # Per-story data
-│   ├── RESEARCH.md   # ArguSeek + ChunkHound results
-│   ├── PLAN.md       # Tasks mapped to acceptance criteria
-│   ├── VERIFY.md     # Verification report
-│   ├── MOOD_BOARD.md # Design references (design stories)
-│   └── DESIGN_BRIEF.md # Design decisions (design stories)
+├── config.json       # Model profiles, git settings
+├── STATE.md          # Execution state
+├── PRD.json          # Requirements contract
+├── REPO-MAP.md       # Codebase map
+├── codebase/         # Deep analysis
+├── phases/           # Per-story data
+├── memory/           # Learned patterns
+├── audit/            # Compliance logs
+├── metrics/          # Productivity data
+├── debug/            # Debug sessions
 ├── checkpoints/      # Auto-checkpoints
-├── debug/            # Debug screenshots
-└── verify/           # Verification screenshots
-
-project/
-├── BRAND_KIT.md      # Visual foundation (brand stories)
-└── tokens/           # W3C design tokens
-    ├── primitive.tokens.json
-    ├── semantic.tokens.json
-    └── component.tokens.json
-```
-
-## PRD.json Structure
-
-```json
-{
-  "brand": {
-    "hasBrandKit": false,
-    "personality": ["professional", "modern"],
-    "euMarket": true
-  },
-  "design": {
-    "wcagLevel": "AA",
-    "eaaCompliance": true,
-    "tokenFormat": "w3c"
-  },
-  "stories": [
-    {
-      "id": "S001",
-      "type": "brand",
-      "title": "Establish brand kit",
-      "acceptanceCriteria": ["BRAND_KIT.md exists", "tokens/ populated"],
-      "passes": false
-    },
-    {
-      "id": "S002",
-      "type": "design",
-      "title": "Login page",
-      "acceptanceCriteria": ["WCAG 2.2 AA compliant", "All states implemented"],
-      "passes": false
-    }
-  ],
-  "metadata": {
-    "currentStory": "S001",
-    "passedStories": 0,
-    "totalStories": 5
-  }
-}
+├── milestones/       # Milestone archives
+└── locks/            # Team file locks
 ```
 
 ## Updating CTX
@@ -292,5 +271,5 @@ npx ctx-cc --force
 ```
 
 ---
-*CTX 2.3 - PRD-driven, design-first, story-verified, debug loop until 100% fixed*
+*CTX 3.3 - Learning. Prediction. Self-healing. Voice control.*
 </reference>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx-cc",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "CTX 3.3 (Continuous Task eXecution) - AI that learns your preferences. Learning system, predictive planning, self-healing deployments (Sentry/LogRocket), voice control for hands-free development.",
   "keywords": [
     "claude",

package/src/install.js

@@ -28,9 +28,9 @@ function printBanner() {
   ╚██████╗   ██║   ██╔╝ ██╗
    ╚═════╝   ╚═╝   ╚═╝  ╚═╝
 `));
-  console.log(`  ${bold('CTX 2.2')} ${dim(`v${VERSION}`)}`);
-  console.log('  PRD-driven workflow orchestration for Claude Code.');
-  console.log('  8 commands. Story-verified. Debug loop.\n');
+  console.log(`  ${bold('CTX 3.3')} ${dim(`v${VERSION}`)}`);
+  console.log('  Intelligent workflow orchestration for Claude Code.');
+  console.log('  20 agents. Learning system. Predictive planning. Self-healing.\n');
 }
 
 function copyDir(src, dest) {