ctx-cc 3.3.5 → 3.3.7

package/README.md

@@ -13,7 +13,9 @@
 
 <img src="./assets/terminal.png" alt="CTX Terminal" width="700">
 
-**AI that learns your preferences. Predictive planning. Self-healing deployments. Voice control.**
+**Conversational-first. Just describe what you want — no commands to memorize.**
+
+AI that learns your preferences. Predictive planning. Self-healing deployments. 21 specialized agents.
 
 [Installation](#installation) · [Quick Start](#quick-start) · [New in 3.3](#new-in-33) · [Commands](#commands) · [Why CTX](#why-ctx) · [**Getting Started Guide**](./GETTING_STARTED.md)
 
@@ -40,6 +42,16 @@ npx ctx-cc --force      # Overwrite existing installation
 
 ## Quick Start
 
+**Just talk to CTX.** No commands to memorize:
+
+```
+"I want to build a todo app"     → CTX sets up your project
+"Fix the login bug"              → CTX starts debugging
+"Is my app accessible?"          → CTX runs accessibility QA
+"What should I do next?"         → CTX shows status + recommendation
+```
+
+Or use commands directly:
 ```
 1. /ctx init           Gather requirements + credentials + design context
 2. /ctx map            Build repository map (existing codebases)
@@ -48,13 +60,60 @@ npx ctx-cc --force      # Overwrite existing installation
 
 **The Flow:**
 ```
-/ctx init → /ctx map → /ctx → Autonomous loop → Delivered!
+Tell CTX what you want → CTX figures out the rest → Delivered!
 ```
 
 ---
 
 ## New in 3.3
 
+### Conversational-First Routing
+**No commands to memorize.** CTX understands natural language from your first prompt:
+
+| You Say | CTX Does |
+|---------|----------|
+| "I want to build a todo app" | Sets up project, researches best practices, creates plan |
+| "Fix the login bug" | Analyzes codebase, starts debugging |
+| "Is my app accessible?" | Runs WCAG 2.1 AA accessibility audit |
+| "Test everything" | Crawls every page, clicks every button |
+| "What's next?" | Shows status and recommended action |
+| "Ship it" | Runs verification, then deploys |
+
+**New user?** CTX welcomes you and guides setup:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Welcome to CTX!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+I understood: "build a todo app with React"
+
+You want to build something new. Let's set it up!
+
+I'll now:
+1. Create your project structure
+2. Research best practices for React todo apps
+3. Create a plan with clear milestones
+```
+
+Commands still work as shortcuts for power users.
+
+### Full System QA
+Crawl every page, click every button, find all issues:
+
+```bash
+/ctx qa                     # Full system QA (WCAG 2.1 AA)
+/ctx qa --a11y-only         # Accessibility audit only
+/ctx qa --visual-only       # Visual regression (3 viewports)
+/ctx qa --resume            # Resume interrupted session
+```
+
+Features:
+- **WCAG 2.1 AA compliance** - Touch targets, alt text, labels, contrast, keyboard
+- **Multi-viewport testing** - Mobile (375px), Tablet (768px), Desktop (1280px)
+- **Performance monitoring** - Slow requests, large assets
+- **Trace capture** - Screenshots and logs for every failed interaction
+- **Fix tasks** - Issues organized by section, ready for execution
+
 ### Learning System
 CTX learns from your codebase and preferences:
 
@@ -517,8 +576,10 @@ Results synthesized into `SUMMARY.md`.
 ### QA (Full System Testing)
 | Command | Purpose |
 |---------|---------|
-| `/ctx qa` | Full system QA - every page, every button |
+| `/ctx qa` | Full system QA - WCAG 2.1 AA, every page, every button |
 | `/ctx qa --section "auth"` | QA specific section only |
+| `/ctx qa --a11y-only` | Accessibility audit only |
+| `/ctx qa --visual-only` | Visual regression (mobile/tablet/desktop) |
 | `/ctx qa --resume` | Resume interrupted QA session |
 | `/ctx qa --report` | Show last QA report |
 
@@ -790,6 +851,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.3 - AI that learns your preferences. Predictive planning. Self-healing. Voice control.*
+*CTX 3.3 - Conversational-first. Just describe what you want. 21 agents. Learning system. Self-healing.*
 
 </div>

package/commands/ctx.md

@@ -30,6 +30,9 @@ Before checking state, parse the user's natural language request.
 | "fix", "bug", "broken", "not working", "error" | `debug` | /ctx:debug |
 | "test", "QA", "check", "accessible", "works?" | `qa` | /ctx:qa |
 | "review", "audit", "security", "ready?" | `review` | /ctx:verify |
+| "production", "prod ready", "production ready" | `production-ready` | Full audit → QA → fixes |
+| "study", "analyze", "understand", "learn", "explore" | `analyze` | /ctx:map-codebase |
+| "improve", "optimize", "better", "enhance" | `improve` | Analyze → suggest → fix |
 | "deploy", "ship", "publish", "release" | `ship` | /ctx:verify → ship |
 | "status", "progress", "where", "what's next" | `status` | /ctx:status |
 | "help", "how", "what can", "commands" | `help` | /ctx:help |
@@ -57,6 +60,21 @@ function detectIntent(userMessage) {
     return 'qa';
   }
 
+  // Production-ready signals
+  if (msg.match(/\b(production|prod ready|production.?ready|make it ready)\b/)) {
+    return 'production-ready';
+  }
+
+  // Analyze/study signals
+  if (msg.match(/\b(study|analyze|understand|learn|explore|what is this)\b/)) {
+    return 'analyze';
+  }
+
+  // Improve signals
+  if (msg.match(/\b(improve|optimize|better|enhance|upgrade|refactor)\b/)) {
+    return 'improve';
+  }
+
   // Review signals
   if (msg.match(/\b(review|audit|security|ready|before deploy)\b/)) {
     return 'review';
@@ -93,11 +111,65 @@ Based on detected intent:
 | Intent | Action |
 |--------|--------|
 | `new-project` | "Let's set up your project!" → Run /ctx:init flow |
-| `debug` | "Let me understand the codebase first." → Run /ctx:init --existing |
-| `qa` | "I'll analyze the project first." → Run /ctx:map then /ctx:qa |
-| `continue` | Guide user: "What would you like to build or work on?" |
+| `debug` | "Let me understand the codebase first." → Run /ctx:map → /ctx:debug |
+| `qa` | "I'll analyze the project first." → Run /ctx:map → /ctx:qa |
+| `production-ready` | "I'll audit everything and make it production ready." → Full pipeline below |
+| `analyze` | "Let me study this codebase." → Run /ctx:map-codebase |
+| `improve` | "I'll analyze and suggest improvements." → Run /ctx:map → analyze → suggest |
+| `continue` | Guide user: "What would you like to do with this project?" |
 | `help` | Show quick start guide |
 
+### Production-Ready Pipeline
+
+When user says "make it production ready":
+
+```
+1. /ctx:map-codebase     → Deep analysis (4 parallel agents)
+2. /ctx:qa               → Full system QA (WCAG 2.1 AA)
+3. Security audit        → Check for vulnerabilities
+4. Performance check     → Find slow requests, large assets
+5. Create fix tasks      → Prioritized by severity
+6. Execute fixes         → With verification loop
+7. Final verification    → Three-level check
+8. Report                → Production readiness score
+```
+
+Output:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+PRODUCTION READINESS AUDIT
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Codebase Analysis: ✓ Complete
+├── Tech: React 18, Node.js, PostgreSQL
+├── Architecture: Clean, well-structured
+├── Quality: 78% test coverage
+└── Concerns: 3 security issues, 5 performance issues
+
+Full QA: ✓ Complete
+├── Pages tested: 24
+├── WCAG 2.1 AA: 92% compliant
+├── Issues found: 12
+└── Critical: 2
+
+Security Audit: ⚠ Issues Found
+├── SQL injection risk: 1
+├── XSS vulnerability: 1
+└── Exposed secrets: 1
+
+Performance: ⚠ Issues Found
+├── Slow API calls: 3
+├── Large assets: 2
+└── Missing caching: Yes
+
+Fix Tasks Created: 8
+├── Critical: 3 (security)
+├── High: 5 (performance, a11y)
+└── Medium: 4
+
+Ready to fix? [Y] Fix all  [C] Critical only  [R] Review first
+```
+
 **Output for new users:**
 ```
 [CTX] Welcome! I see this is a new project.
@@ -123,6 +195,9 @@ Combine detected intent with current state:
 | `new-project` | any | Warn if project exists, offer to add story |
 | `debug` | any | Route to /ctx:debug |
 | `qa` | any | Route to /ctx:qa |
+| `production-ready` | any | Run full production-ready pipeline |
+| `analyze` | any | Route to /ctx:map-codebase |
+| `improve` | any | Analyze → suggest improvements → create stories |
 | `status` | any | Show STATE.md summary |
 | `continue` | initializing | Run research phase |
 | `continue` | discussing | Run discussion phase |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx-cc",
-  "version": "3.3.5",
+  "version": "3.3.7",
   "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

@@ -123,6 +123,14 @@ export async function install(options) {
   if (fs.existsSync(srcCommands)) {
     const count = copyDir(srcCommands, commandsDir);
     console.log(green(`  ✓`) + ` Installed commands/ctx (${count} files)`);
+
+    // Also copy ctx.md to commands root so /ctx works directly
+    const mainRouter = path.join(commandsDir, 'ctx.md');
+    const rootRouter = path.join(targetBase, 'commands', 'ctx.md');
+    if (fs.existsSync(mainRouter)) {
+      fs.copyFileSync(mainRouter, rootRouter);
+      console.log(green(`  ✓`) + ` Installed /ctx command`);
+    }
   }
 
   // Copy agents