ctx-cc 3.0.0 → 3.3.0

package/README.md

@@ -4,7 +4,7 @@
 
 ### Continuous Task eXecution
 
-**Production-grade workflow orchestration for Claude Code.**
+**Intelligent workflow orchestration for Claude Code.**
 
 [![npm version](https://img.shields.io/npm/v/ctx-cc.svg?style=flat-square)](https://www.npmjs.com/package/ctx-cc)
 [![npm downloads](https://img.shields.io/npm/dm/ctx-cc.svg?style=flat-square)](https://www.npmjs.com/package/ctx-cc)
@@ -13,9 +13,9 @@
 
 <img src="./assets/terminal.png" alt="CTX Terminal" width="700">
 
-**Repository mapping. Discussion phase. Model profiles. Git-native. Persistent debug. Parallel analysis.**
+**AI that learns your preferences. Predictive planning. Self-healing deployments. Voice control.**
 
-[Installation](#installation) · [Quick Start](#quick-start) · [New in 3.0](#new-in-30) · [Commands](#commands) · [Why CTX](#why-ctx)
+[Installation](#installation) · [Quick Start](#quick-start) · [New in 3.3](#new-in-33) · [Commands](#commands) · [Why CTX](#why-ctx)
 
 </div>
 
@@ -53,7 +53,302 @@ npx ctx-cc --force      # Overwrite existing installation
 
 ---
 
-## New in 3.0
+## New in 3.3
+
+### Learning System
+CTX learns from your codebase and preferences:
+
+```
+[LEARNER] Applying 3 learned preferences
+
+1. Using Zod for validation
+   → Based on pattern P001 (95% confidence, 12 observations)
+
+2. Functional components only
+   → Based on decision D005 (explicit preference)
+
+3. Avoiding moment.js, using date-fns
+   → Based on failure F001 (bundle size)
+```
+
+Memory stored in `.ctx/memory/`:
+- `patterns.json` - Code patterns you prefer
+- `decisions.json` - Past architectural decisions
+- `failures.json` - What didn't work
+- `preferences.json` - Communication style
+- `conventions.json` - Naming and structure
+
+Commands:
+```bash
+/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
+```
+
+### Predictive Planning
+AI suggests what to build next based on patterns:
+
+```
+[PREDICT] Feature Suggestions for MyApp
+
+Based on your e-commerce app at MVP stage:
+
+1. Cart Abandonment Recovery
+   ├─ ROI: 9/10
+   ├─ Effort: Medium (2-3 days)
+   └─ Impact: +15-25% recovered revenue
+
+2. Product Reviews & Ratings
+   ├─ ROI: 9/10
+   ├─ Effort: Low (1-2 days)
+   └─ Impact: +18% conversion rate
+
+3. Discount Codes System
+   ├─ ROI: 7/10
+   └─ Effort: Low (1 day)
+
+[1] Create story  [A] Create all  [R] Research more
+```
+
+Commands:
+```bash
+/ctx predict                # Full prediction analysis
+/ctx predict --quick        # Quick wins only (< 1 day)
+/ctx predict --create [id]  # Create story from suggestion
+```
+
+### Self-Healing Deployments
+Monitor production errors and auto-fix:
+
+```bash
+/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
+```
+
+Auto-fix workflow:
+```
+1. Sentry reports: "TypeError in checkout.ts:45"
+2. CTX analyzes error pattern
+3. If safe pattern (null check, import, etc.):
+   → Auto-generates fix
+   → Runs tests
+   → Creates PR
+   → Notifies team
+4. If complex pattern:
+   → Creates fix story
+   → Assigns priority
+   → Provides context
+```
+
+Supports: Sentry, LogRocket, Bugsnag, Datadog
+
+### Voice Control
+Speak your requirements instead of typing:
+
+```bash
+/ctx voice                  # Start voice input
+/ctx voice --continuous     # Always listening
+/ctx voice --dictate        # Long-form input
+```
+
+```
+[VOICE] 🎤 Listening...
+
+User: "Create a story for user authentication
+       with email login and forgot password"
+
+[VOICE] Story created:
+
+  Title: User Authentication
+  Criteria:
+    ✓ User can login with email/password
+    ✓ Forgot password sends reset email
+    ✓ Session persists across browser
+
+Add to PRD? [Y/n/edit]
+```
+
+Supports: macOS Speech, Whisper (local), Google Speech, Azure
+
+---
+
+## From 3.2
+
+### Milestone Workflow
+Full release management with audit, archive, and git tagging:
+```bash
+/ctx milestone              # Show current milestone status
+/ctx milestone list         # List all milestones
+/ctx milestone audit        # Verify milestone complete
+/ctx milestone complete     # Archive and create git tag
+/ctx milestone new v2.0     # Start next version
+/ctx milestone gaps         # Generate fix phases for failures
+```
+
+Features:
+- Archive phases to `.ctx/archive/v{version}/`
+- Auto-create git tags on complete
+- Gap analysis for incomplete milestones
+- Integration with Linear/Jira/GitHub
+
+### Team Collaboration
+Multiple developers working with CTX on same repo:
+```
+[TEAM] Current Activity
+
+Active:
+  alice: T001 - User authentication (10m)
+  bob: T003 - API endpoints (waiting for T001)
+
+Available:
+  charlie: idle
+```
+
+Features:
+- **File locking** - Prevent conflicts during execution
+- **Lock expiry** - Auto-release after 1 hour
+- **Conflict detection** - Fail fast on overlaps
+- **Team notifications** - Slack/Discord on phase complete
+- **Branch strategy** - Auto-create feature branches
+
+### Audit Trail (SOC2/HIPAA Compliance)
+Complete traceability for enterprise:
+```bash
+/ctx audit                  # Show today's summary
+/ctx audit week             # Weekly summary
+/ctx audit export           # Generate compliance report
+```
+
+Every action logged:
+```json
+{
+  "timestamp": "2024-01-20T09:30:00Z",
+  "action": "execute",
+  "story": "S001",
+  "agent": "ctx-executor",
+  "model": "claude-sonnet-4",
+  "tokens": {"input": 5000, "output": 2000},
+  "filesModified": ["src/auth/login.ts"],
+  "decisions": ["Use JWT for auth"],
+  "commit": "abc1234"
+}
+```
+
+Compliance features:
+- Access logging (who read what)
+- Decision tracking (with rationale)
+- Change log (all modifications)
+- Retention policies (90d daily, 1y weekly)
+- SOC2, HIPAA, GDPR modes
+
+### Metrics Dashboard
+Understand AI productivity impact:
+```bash
+/ctx metrics                # Overview dashboard
+/ctx metrics cost           # Cost analysis
+/ctx metrics export         # Export HTML dashboard
+```
+
+```
+╔══════════════════════════════════════════════════════════╗
+║                  CTX METRICS - Week 3                     ║
+╠══════════════════════════════════════════════════════════╣
+║  Stories/Week:    8  (+2)       Total Cost:    $4.87     ║
+║  Time/Story:      1h 45m        Per Story:     $0.61     ║
+║  Debug Loops:     12            Success Rate:  92%       ║
+║                                                          ║
+║  ROI: 30x  (24 hours saved, $145 net savings)            ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+Metrics tracked:
+- Stories completed per day/week
+- Average time per story
+- Token usage by phase/model
+- Cost analysis with ROI
+- Debug loop frequency
+- Verification success rate
+- Human intervention rate
+
+---
+
+## From 3.1
+
+### Intelligent Task Parallelization
+Tasks without dependencies run simultaneously:
+```
+Wave 1: [T001, T003] → Parallel (no deps)
+Wave 2: [T002]       → After T001
+Wave 3: [T004]       → After T002
+
+Result: 40% faster execution
+```
+
+### Pre-Commit Review (ctx-reviewer)
+Catches errors BEFORE they're committed:
+- Type errors (TypeScript, Python, Go)
+- Unresolved imports
+- Circular dependencies
+- Security vulnerabilities
+- Empty catch blocks, console.logs
+
+```
+[CTX] Pre-Commit Review
+  ✅ Types: Pass
+  ✅ Imports: Pass
+  ⚠️  Medium: 2 console.log statements
+  ❌ Critical: SQL injection risk at line 45
+
+Status: BLOCKED - Fix critical issue
+```
+
+### Acceptance Criteria Auto-Generation
+AI suggests comprehensive criteria:
+```
+Story: "Add user authentication"
+
+Suggested Criteria:
+  ✓ User can register with email/password
+  ✓ Invalid credentials show error
+  ✓ Passwords hashed with bcrypt
+  ✓ Session expires after 24h
+  ✓ Brute force protection enabled
+
+[A] Accept all  [B] See more  [C] Edit
+```
+
+### Smart Context Handoff
+Seamless transitions at context limits:
+
+| Threshold | Action |
+|-----------|--------|
+| 40% | Prepare handoff notes |
+| 50% | Write HANDOFF.md, warn |
+| 60% | Spawn fresh agent |
+
+Zero information loss. Work continues automatically.
+
+### Issue Tracker Integration
+Sync with Linear, Jira, or GitHub Issues:
+```bash
+/ctx integrate linear    # Setup Linear
+/ctx integrate jira      # Setup Jira
+/ctx integrate github    # Setup GitHub Issues
+/ctx integrate --sync    # Force sync all stories
+```
+
+Features:
+- Bidirectional story sync
+- Status mapping (CTX → tracker)
+- Auto-close on verify pass
+- Comment on verify fail
+
+---
+
+## From 3.0
 
 ### Repository Mapping (like Aider)
 ```bash
@@ -203,6 +498,57 @@ Results synthesized into `SUMMARY.md`.
 | `/ctx phase add "goal"` | Add new phase |
 | `/ctx phase next` | Complete current, move to next |
 
+### Integration
+| Command | Purpose |
+|---------|---------|
+| `/ctx integrate` | Show integration status |
+| `/ctx integrate linear` | Setup Linear |
+| `/ctx integrate jira` | Setup Jira |
+| `/ctx integrate github` | Setup GitHub Issues |
+| `/ctx integrate --sync` | Sync all stories |
+
+### 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 |
+| `/ctx milestone gaps` | Generate fix phases |
+
+### 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 |
+
 ---
 
 ## State Machine
@@ -246,7 +592,7 @@ Smart handoff creates `HANDOFF.md` with:
 
 ---
 
-## 10 Specialized Agents
+## 20 Specialized Agents
 
 | Agent | Spawned when | Model (balanced) |
 |-------|--------------|------------------|
@@ -262,6 +608,14 @@ Smart handoff creates `HANDOFF.md` with:
 | ctx-designer | design stories | sonnet |
 | ctx-debugger | status = debugging | sonnet |
 | ctx-verifier | status = verifying | haiku |
+| ctx-parallelizer | before execution | haiku |
+| ctx-reviewer | before commit | sonnet |
+| ctx-criteria-suggester | during init/discuss | sonnet |
+| ctx-handoff | at context thresholds | haiku |
+| ctx-team-coordinator | team mode | sonnet |
+| ctx-auditor | always (background) | haiku |
+| ctx-learner | observing patterns | haiku |
+| ctx-predictor | after milestone/on demand | sonnet |
 
 ---
 
@@ -399,6 +753,6 @@ MIT
 
 **[GitHub](https://github.com/jufjuf/CTX)** · **[Issues](https://github.com/jufjuf/CTX/issues)** · **[npm](https://www.npmjs.com/package/ctx-cc)**
 
-*CTX 3.0 - Repository mapping. Discussion phase. Model profiles. Git-native. Persistent debug.*
+*CTX 3.3 - AI that learns your preferences. Predictive planning. Self-healing. Voice control.*
 
 </div>