autoworkflow 1.1.0 → 2.0.0

package/system/triggers.md

@@ -0,0 +1,369 @@
+# System Triggers
+
+> Event-driven actions that control Claude's workflow behavior.
+> These triggers fire automatically based on context and events.
+
+---
+
+## Trigger Definitions
+
+### `on:conversation_start`
+
+**When:** Claude begins a new conversation or task
+**Action:**
+1. Read root `CLAUDE.md` (entry point)
+2. Check if `instructions/BLUEPRINT.md` exists
+3. If NO → Trigger `on:blueprint_missing`
+4. If YES → Load blueprint and proceed
+5. Load `system/router.md` to determine task type
+6. Load `system/gates.md` for blocking rules
+7. Await user request
+
+```
+TRIGGER: conversation_start
+├── Read: CLAUDE.md
+├── Check: instructions/BLUEPRINT.md exists?
+│   ├── NO  → Trigger: on:blueprint_missing
+│   └── YES → Read: instructions/BLUEPRINT.md
+├── Read: system/router.md
+├── Read: system/gates.md
+└── State: READY
+```
+
+---
+
+### `on:blueprint_missing`
+
+**When:** BLUEPRINT.md does not exist at session start
+**Action:**
+1. Run single audit scan of codebase
+2. Generate BOTH AI_RULES.md updates AND BLUEPRINT.md
+3. Present proposed updates to user
+4. Save after approval
+
+```
+TRIGGER: blueprint_missing
+├── Notify: "No BLUEPRINT.md found. Running project audit..."
+├── Scan: codebase (single pass)
+│   ├── cat package.json → Tech stack
+│   ├── find src -type d → File structure
+│   ├── ls src/pages/ → Routes
+│   ├── ls src/components/ → Components
+│   ├── find src/api/ → API endpoints
+│   └── grep -r "fetch\|/api/" → Connections
+│
+├── Generate: AI_RULES.md updates (Tech Stack, File Structure)
+├── Generate: BLUEPRINT.md (Features, Routes, APIs)
+├── Present: both updates to user
+├── Await: user approval
+└── Save: both files after approval
+```
+
+**Output Format:**
+```
+⚠️ No BLUEPRINT.md found in this project.
+
+Running ONE audit to update TWO files:
+- 📄 AI_RULES.md → Tech Stack & File Structure
+- 📘 BLUEPRINT.md → Features, Routes, APIs
+
+Scanning codebase...
+```
+
+---
+
+### `on:task_received`
+
+**When:** User provides a task or request
+**Action:**
+1. Route task through `system/router.md`
+2. Identify task type (feature, fix, refactor, etc.)
+3. Load appropriate workflow from `instructions/CLAUDE.md`
+4. Enter ANALYZE phase
+
+```
+TRIGGER: task_received
+├── Parse: user request
+├── Route: system/router.md → task_type
+├── Load: instructions/CLAUDE.md#workflow
+└── Enter: ANALYZE phase
+```
+
+---
+
+### `on:phase_transition`
+
+**When:** Moving from one workflow phase to another
+**Action:**
+1. Check `system/gates.md` for phase gate
+2. If gate passes → proceed to next phase
+3. If gate fails → BLOCK and report
+
+```
+TRIGGER: phase_transition(from, to)
+├── Check: system/gates.md#{to}_gate
+├── If PASS → Enter: {to} phase
+└── If FAIL → BLOCK: report gate failure
+```
+
+---
+
+### `on:implementation_complete`
+
+**When:** Claude finishes writing/modifying code
+**Action:**
+1. Enter VERIFY phase automatically
+2. Start `verify_loop` from `system/loops.md`
+3. Report results
+
+```
+TRIGGER: implementation_complete
+├── Enter: VERIFY phase
+├── Start: system/loops.md#verify_loop
+└── Report: verification results
+```
+
+---
+
+### `on:verification_failed`
+
+**When:** `npm run verify` returns errors
+**Action:**
+1. Parse error output
+2. Enter FIX phase
+3. Start `fix_loop` from `system/loops.md`
+
+```
+TRIGGER: verification_failed
+├── Parse: error output
+├── Enter: FIX phase
+├── Start: system/loops.md#fix_loop
+└── Return to: VERIFY phase when fixed
+```
+
+---
+
+### `on:verification_passed`
+
+**When:** `npm run verify` returns success
+**Action:**
+1. Check if audits required (new feature/component)
+2. If yes → enter AUDIT phase
+3. If no → proceed to COMMIT gate
+
+```
+TRIGGER: verification_passed
+├── Check: is_audit_required?
+├── If YES → Enter: AUDIT phase
+├── If NO → Check: system/gates.md#pre_commit_gate
+└── Report: ready status
+```
+
+---
+
+### `on:commit_requested`
+
+**When:** User asks to commit or workflow reaches commit phase
+**Action:**
+1. Check `system/gates.md#pre_commit_gate`
+2. All gates must pass
+3. If blocked → report and await fix
+4. If passed → ask for commit confirmation
+
+```
+TRIGGER: commit_requested
+├── Check: system/gates.md#pre_commit_gate
+├── If BLOCKED → Report: blocking issues
+├── If PASSED → Show: commit preview
+└── Await: user confirmation
+```
+
+---
+
+### `on:error_detected`
+
+**When:** Any error occurs during execution
+**Action:**
+1. Identify error type
+2. Route to appropriate fix strategy
+3. Enter FIX phase if code error
+4. Report if environmental error
+
+```
+TRIGGER: error_detected(error_type)
+├── Identify: error_type
+├── If code_error → Enter: FIX phase
+├── If env_error → Report: to user
+└── If unknown → Ask: user for guidance
+```
+
+---
+
+### `on:file_changed`
+
+**When:** Claude modifies a file
+**Action:**
+1. Mark file as changed
+2. Queue for verification
+3. If in IMPLEMENT phase → continue
+4. If outside phase → trigger verification
+
+```
+TRIGGER: file_changed(file_path)
+├── Track: changed_files.add(file_path)
+├── If IMPLEMENT phase → Continue
+├── If other phase → Queue: verification
+└── Update: state
+```
+
+---
+
+### `on:user_approval`
+
+**When:** User approves a plan or action
+**Action:**
+1. Record approval
+2. Proceed to next phase
+3. If plan approval → enter IMPLEMENT
+4. If commit approval → execute commit
+
+```
+TRIGGER: user_approval(approval_type)
+├── Record: approval
+├── If plan_approval → Enter: IMPLEMENT phase
+├── If commit_approval → Execute: git commit
+└── Continue: workflow
+```
+
+---
+
+### `on:user_rejection`
+
+**When:** User rejects a plan or action
+**Action:**
+1. Record rejection
+2. Ask for feedback
+3. Return to PLAN phase
+4. Revise based on feedback
+
+```
+TRIGGER: user_rejection
+├── Record: rejection
+├── Ask: "What should I change?"
+├── Return to: PLAN phase
+└── Incorporate: user feedback
+```
+
+---
+
+## Trigger Priority
+
+When multiple triggers could fire, use this priority:
+
+| Priority | Trigger | Reason |
+|----------|---------|--------|
+| 1 | `on:error_detected` | Errors must be handled immediately |
+| 2 | `on:user_approval/rejection` | User input takes precedence |
+| 3 | `on:phase_transition` | Workflow control |
+| 4 | `on:verification_*` | Quality gates |
+| 5 | `on:file_changed` | Tracking |
+| 6 | `on:task_received` | New work |
+
+---
+
+## Trigger State Machine
+
+```
+[IDLE] ─────on:task_received────→ [ANALYZE]
+                                      │
+                                      ▼
+                                  [PLAN]
+                                      │
+                     on:user_rejection │ on:user_approval
+                            ◄─────────┴─────────►
+                            │                   │
+                            ▼                   ▼
+                        [PLAN]            [IMPLEMENT]
+                                              │
+                         on:implementation_complete
+                                              │
+                                              ▼
+                                         [VERIFY]
+                                              │
+                    on:verification_failed    │    on:verification_passed
+                            ◄─────────────────┴─────────────────►
+                            │                                   │
+                            ▼                                   ▼
+                         [FIX]                              [AUDIT]
+                            │                                   │
+                            └──────────► [VERIFY] ◄─────────────┘
+                                              │
+                                 on:commit_requested
+                                              │
+                                              ▼
+                                    [PRE_COMMIT_GATE]
+                                              │
+                           blocked            │           passed
+                            ◄─────────────────┴─────────────────►
+                            │                                   │
+                            ▼                                   ▼
+                         [FIX]                              [COMMIT]
+                                                               │
+                                                               ▼
+                                                           [IDLE]
+```
+
+---
+
+### `on:feature_complete`
+
+**When:** A new feature, route, or API is successfully committed
+**Action:**
+1. Check if BLUEPRINT.md needs updating
+2. Present proposed updates
+3. Update after approval
+
+```
+TRIGGER: feature_complete
+├── Check: was new feature/route/api added?
+├── If YES:
+│   ├── Generate: BLUEPRINT.md update
+│   ├── Present: proposed changes
+│   ├── Await: approval
+│   └── Update: BLUEPRINT.md
+└── If NO:
+    └── Skip: no update needed
+```
+
+**Update Triggers:**
+| Event | Action |
+|-------|--------|
+| New feature added | Add to Features section |
+| New route created | Add to Routes section |
+| New API endpoint | Add to API section |
+| Feature removed | Mark as deprecated or remove |
+
+**Output Format:**
+```
+## 📘 Blueprint Update
+
+Adding to BLUEPRINT.md:
+- Feature: [name] - [description]
+- Route: [path] → [Component]
+- API: [method] [endpoint]
+
+**Should I update BLUEPRINT.md?**
+```
+
+---
+
+## Usage
+
+Claude MUST check this file when:
+1. Starting any task
+2. Transitioning between phases
+3. Encountering errors
+4. Receiving user input
+5. Completing a feature (for blueprint updates)
+
+Triggers ensure consistent, predictable workflow behavior.

package/tsconfig.example.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    // ─────────────────────────────────────────────────────────────
+    // Language & Environment
+    // ─────────────────────────────────────────────────────────────
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "jsx": "react-jsx",
+
+    // ─────────────────────────────────────────────────────────────
+    // Module Resolution
+    // ─────────────────────────────────────────────────────────────
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "useDefineForClassFields": true,
+    "skipLibCheck": true,
+
+    // ─────────────────────────────────────────────────────────────
+    // STRICT MODE - All enabled for maximum type safety
+    // Per AI_RULES.md: "Never use any type"
+    // ─────────────────────────────────────────────────────────────
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitReturns": true,
+    "noImplicitOverride": true,
+    "exactOptionalPropertyTypes": true,
+    "forceConsistentCasingInFileNames": true,
+
+    // ─────────────────────────────────────────────────────────────
+    // Path Aliases (optional)
+    // ─────────────────────────────────────────────────────────────
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@/components/*": ["./src/components/*"],
+      "@/hooks/*": ["./src/hooks/*"],
+      "@/lib/*": ["./src/lib/*"],
+      "@/types/*": ["./src/types/*"]
+    }
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "coverage"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}