start-vibing 1.1.2 → 1.1.3

package/template/.claude/config/testing-config.json

@@ -1,168 +1,168 @@
-{
-  "$comment": "Testing configuration. Used by tester agent.",
-
-  "framework": {
-    "unit": "vitest",
-    "e2e": "playwright",
-    "version": "1.40+"
-  },
-
-  "paths": {
-    "unitTests": "tests/unit/*.test.ts",
-    "e2eTests": "tests/e2e/**/*.spec.ts",
-    "fixtures": "tests/e2e/fixtures/",
-    "pages": "tests/e2e/pages/",
-    "flows": "tests/e2e/flows/",
-    "api": "tests/e2e/api/",
-    "authState": "tests/e2e/.auth/"
-  },
-
-  "viewports": {
-    "desktop": {
-      "device": "Desktop Chrome",
-      "width": 1280,
-      "height": 800,
-      "required": true
-    },
-    "tablet": {
-      "device": "iPad",
-      "width": 768,
-      "height": 1024,
-      "required": true
-    },
-    "mobile": {
-      "device": "iPhone SE",
-      "width": 375,
-      "height": 667,
-      "required": true
-    },
-    "mobileLarge": {
-      "device": "iPhone 14",
-      "width": 390,
-      "height": 844,
-      "required": false
-    }
-  },
-
-  "auth": {
-    "storageStatePath": "tests/e2e/.auth/user.json",
-    "loginPage": "/auth/login",
-    "registerPage": "/auth/register",
-    "protectedPrefix": "/app",
-    "setupProject": "setup",
-    "reuseSession": true
-  },
-
-  "database": {
-    "type": "mongodb",
-    "testConnectionEnv": "MONGODB_URI",
-    "cleanupStrategy": "fixture-tracking",
-    "verifyAfterActions": true
-  },
-
-  "cleanup": {
-    "strategy": "fixture-based",
-    "trackCreatedIds": true,
-    "deleteOnlyTracked": true,
-    "cleanupOnFailure": true,
-    "collections": ["users", "items", "sessions"]
-  },
-
-  "dataTestIds": {
-    "form": {
-      "nameInput": "name-input",
-      "emailInput": "email-input",
-      "passwordInput": "password-input",
-      "confirmPasswordInput": "confirm-password-input",
-      "submitButton": "submit-button"
-    },
-    "feedback": {
-      "errorMessage": "error-message",
-      "successMessage": "success-message",
-      "loadingSpinner": "loading-spinner"
-    },
-    "navigation": {
-      "sidebar": "sidebar",
-      "hamburgerMenu": "hamburger-menu",
-      "mobileNav": "mobile-nav",
-      "logoutButton": "logout-button"
-    },
-    "actions": {
-      "deleteButton": "delete-button",
-      "editButton": "edit-button",
-      "confirmDelete": "confirm-delete",
-      "cancelButton": "cancel-button"
-    }
-  },
-
-  "api": {
-    "rest": {
-      "baseUrl": "/api",
-      "authEndpoint": "/api/auth/login",
-      "validateInput": true,
-      "requireAuth": true
-    },
-    "trpc": {
-      "baseUrl": "/api/trpc",
-      "batchEnabled": true,
-      "validateInput": true
-    }
-  },
-
-  "security": {
-    "testForbiddenRequests": true,
-    "testRateLimiting": true,
-    "testCrossUserAccess": true,
-    "testUnauthenticated": true,
-    "expectedForbiddenStatus": 403,
-    "expectedUnauthorizedStatus": 401,
-    "expectedRateLimitStatus": 429
-  },
-
-  "flows": {
-    "required": [
-      "registration",
-      "login",
-      "logout",
-      "crud-create",
-      "crud-read",
-      "crud-update",
-      "crud-delete",
-      "permissions"
-    ],
-    "optional": [
-      "password-reset",
-      "email-verification",
-      "profile-update"
-    ]
-  },
-
-  "commands": {
-    "install": "bun add -D @playwright/test && bunx playwright install",
-    "run": "bunx playwright test",
-    "runUi": "bunx playwright test --ui",
-    "runHeaded": "bunx playwright test --headed",
-    "runMobile": "bunx playwright test --project='iPhone SE'",
-    "debug": "bunx playwright test --debug",
-    "report": "bunx playwright show-report",
-    "codegen": "bunx playwright codegen"
-  },
-
-  "rules": {
-    "noSkip": true,
-    "noMockAuth": true,
-    "requireCleanup": true,
-    "requireDbValidation": true,
-    "requireViewportTests": true,
-    "requireDataTestId": true,
-    "uniqueTestData": true,
-    "timestampEmails": true
-  },
-
-  "reporting": {
-    "trace": "on-first-retry",
-    "screenshot": "only-on-failure",
-    "video": "retain-on-failure",
-    "outputFolder": "test-results"
-  }
-}
+{
+  "$comment": "Testing configuration. Used by tester agent.",
+
+  "framework": {
+    "unit": "vitest",
+    "e2e": "playwright",
+    "version": "1.40+"
+  },
+
+  "paths": {
+    "unitTests": "tests/unit/*.test.ts",
+    "e2eTests": "tests/e2e/**/*.spec.ts",
+    "fixtures": "tests/e2e/fixtures/",
+    "pages": "tests/e2e/pages/",
+    "flows": "tests/e2e/flows/",
+    "api": "tests/e2e/api/",
+    "authState": "tests/e2e/.auth/"
+  },
+
+  "viewports": {
+    "desktop": {
+      "device": "Desktop Chrome",
+      "width": 1280,
+      "height": 800,
+      "required": true
+    },
+    "tablet": {
+      "device": "iPad",
+      "width": 768,
+      "height": 1024,
+      "required": true
+    },
+    "mobile": {
+      "device": "iPhone SE",
+      "width": 375,
+      "height": 667,
+      "required": true
+    },
+    "mobileLarge": {
+      "device": "iPhone 14",
+      "width": 390,
+      "height": 844,
+      "required": false
+    }
+  },
+
+  "auth": {
+    "storageStatePath": "tests/e2e/.auth/user.json",
+    "loginPage": "/auth/login",
+    "registerPage": "/auth/register",
+    "protectedPrefix": "/app",
+    "setupProject": "setup",
+    "reuseSession": true
+  },
+
+  "database": {
+    "type": "mongodb",
+    "testConnectionEnv": "MONGODB_URI",
+    "cleanupStrategy": "fixture-tracking",
+    "verifyAfterActions": true
+  },
+
+  "cleanup": {
+    "strategy": "fixture-based",
+    "trackCreatedIds": true,
+    "deleteOnlyTracked": true,
+    "cleanupOnFailure": true,
+    "collections": ["users", "items", "sessions"]
+  },
+
+  "dataTestIds": {
+    "form": {
+      "nameInput": "name-input",
+      "emailInput": "email-input",
+      "passwordInput": "password-input",
+      "confirmPasswordInput": "confirm-password-input",
+      "submitButton": "submit-button"
+    },
+    "feedback": {
+      "errorMessage": "error-message",
+      "successMessage": "success-message",
+      "loadingSpinner": "loading-spinner"
+    },
+    "navigation": {
+      "sidebar": "sidebar",
+      "hamburgerMenu": "hamburger-menu",
+      "mobileNav": "mobile-nav",
+      "logoutButton": "logout-button"
+    },
+    "actions": {
+      "deleteButton": "delete-button",
+      "editButton": "edit-button",
+      "confirmDelete": "confirm-delete",
+      "cancelButton": "cancel-button"
+    }
+  },
+
+  "api": {
+    "rest": {
+      "baseUrl": "/api",
+      "authEndpoint": "/api/auth/login",
+      "validateInput": true,
+      "requireAuth": true
+    },
+    "trpc": {
+      "baseUrl": "/api/trpc",
+      "batchEnabled": true,
+      "validateInput": true
+    }
+  },
+
+  "security": {
+    "testForbiddenRequests": true,
+    "testRateLimiting": true,
+    "testCrossUserAccess": true,
+    "testUnauthenticated": true,
+    "expectedForbiddenStatus": 403,
+    "expectedUnauthorizedStatus": 401,
+    "expectedRateLimitStatus": 429
+  },
+
+  "flows": {
+    "required": [
+      "registration",
+      "login",
+      "logout",
+      "crud-create",
+      "crud-read",
+      "crud-update",
+      "crud-delete",
+      "permissions"
+    ],
+    "optional": [
+      "password-reset",
+      "email-verification",
+      "profile-update"
+    ]
+  },
+
+  "commands": {
+    "install": "bun add -D @playwright/test && bunx playwright install",
+    "run": "bunx playwright test",
+    "runUi": "bunx playwright test --ui",
+    "runHeaded": "bunx playwright test --headed",
+    "runMobile": "bunx playwright test --project='iPhone SE'",
+    "debug": "bunx playwright test --debug",
+    "report": "bunx playwright show-report",
+    "codegen": "bunx playwright codegen"
+  },
+
+  "rules": {
+    "noSkip": true,
+    "noMockAuth": true,
+    "requireCleanup": true,
+    "requireDbValidation": true,
+    "requireViewportTests": true,
+    "requireDataTestId": true,
+    "uniqueTestData": true,
+    "timestampEmails": true
+  },
+
+  "reporting": {
+    "trace": "on-first-retry",
+    "screenshot": "only-on-failure",
+    "video": "retain-on-failure",
+    "outputFolder": "test-results"
+  }
+}

package/template/.claude/hooks/SETUP.md

@@ -1,181 +1,52 @@
-# Workflow Enforcement Hooks - Setup Guide
-
-## Overview
-
-This system enforces the agent workflow by:
-
-1. **Blocking file modifications** until workflow is started and files are approved
-2. **Tracking all changes** automatically
-3. **Preventing incomplete workflow** from stopping
-4. **Blocking commits** that don't follow the workflow
-
-## Requirements
-
-- Python 3.8+
-- Git
-- Husky (for pre-commit hooks)
-
-## Files
-
-| File                  | Purpose                                          |
-| --------------------- | ------------------------------------------------ |
-| `pre-tool-use.py`     | Blocks Edit/Write unless file is approved        |
-| `post-tool-use.py`    | Auto-tracks modifications to workflow-state.json |
-| `stop-validation.py`  | Blocks stopping if workflow incomplete           |
-| `validate-commit.py`  | Husky pre-commit validation                      |
-| `workflow-manager.py` | CLI for agents to update workflow state          |
-
-## Husky Integration
-
-### 1. Install Husky
-
-```bash
-bun add husky --dev
-bunx husky init
-```
-
-### 2. Create Pre-Commit Hook
-
-```bash
-# Create .husky/pre-commit
-echo '#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-python .claude/hooks/validate-commit.py
-' > .husky/pre-commit
-
-chmod +x .husky/pre-commit
-```
-
-### 3. Add to package.json
-
-```json
-{
-	"scripts": {
-		"prepare": "husky"
-	}
-}
-```
-
-## Claude Code Configuration
-
-The hooks are configured in `.claude/settings.json`:
-
-```json
-{
-	"hooks": {
-		"PreToolUse": [
-			{
-				"matcher": "Edit|Write|NotebookEdit",
-				"hooks": [
-					{
-						"type": "command",
-						"command": "python \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-tool-use.py\"",
-						"timeout": 30
-					}
-				]
-			}
-		],
-		"PostToolUse": [
-			{
-				"matcher": "Edit|Write|NotebookEdit",
-				"hooks": [
-					{
-						"type": "command",
-						"command": "python \"$CLAUDE_PROJECT_DIR/.claude/hooks/post-tool-use.py\"",
-						"timeout": 30
-					}
-				]
-			}
-		],
-		"Stop": [
-			{
-				"matcher": "",
-				"hooks": [
-					{
-						"type": "command",
-						"command": "python \"$CLAUDE_PROJECT_DIR/.claude/hooks/stop-validation.py\"",
-						"timeout": 30
-					}
-				]
-			}
-		]
-	}
-}
-```
-
-**IMPORTANT:** Use `$CLAUDE_PROJECT_DIR` to ensure hooks work from any directory.
-
-## Workflow Manager CLI
-
-```bash
-# Start a task (REQUIRED FIRST)
-python .claude/hooks/workflow-manager.py start-task --type feature --description "Add user auth"
-
-# Approve files for modification
-python .claude/hooks/workflow-manager.py approve-files --files "src/auth.ts" "app/login/*"
-
-# Mark agent as executed
-python .claude/hooks/workflow-manager.py agent-executed --agent analyzer --result approved
-
-# Record quality gate result
-python .claude/hooks/workflow-manager.py quality-gate --gate typecheck --passed true
-
-# Record security audit
-python .claude/hooks/workflow-manager.py security-audit --result approved
-
-# Final validation
-python .claude/hooks/workflow-manager.py final-validation --result approved --ready-to-commit true
-
-# Complete task after commit
-python .claude/hooks/workflow-manager.py complete-task --commit-hash abc123def
-
-# Check current status
-python .claude/hooks/workflow-manager.py status
-```
-
-## Error Messages
-
-### "BLOCKED: No active task"
-
-Run `workflow-manager.py start-task` first.
-
-### "BLOCKED: Analyzer agent has not executed"
-
-Run the analyzer agent and call `workflow-manager.py agent-executed --agent analyzer --result approved`.
-
-### "BLOCKED: File not in approved list"
-
-Add the file to approved list via `workflow-manager.py approve-files --files "path/to/file"`.
-
-### "WORKFLOW INCOMPLETE - Cannot stop yet"
-
-Execute all required agents before stopping the session.
-
-### "COMMIT BLOCKED - Workflow validation failed"
-
-Ensure all agents executed, tests created, and final validation approved.
-
-## Environment Variables
-
-| Variable             | Default       | Description            |
-| -------------------- | ------------- | ---------------------- |
-| `CLAUDE_PROJECT_DIR` | `os.getcwd()` | Project root directory |
-
-## Troubleshooting
-
-### Hooks not executing
-
-1. Verify Python is in PATH
-2. Check `.claude/settings.json` hooks configuration
-3. Ensure hook files have execute permissions
-
-### Workflow state corrupted
-
-Delete `.claude/workflow-state.json` and start fresh.
-
-### Husky not running
-
-1. Run `bun run prepare`
-2. Check `.husky/pre-commit` has execute permissions
-3. Verify Git hooks are enabled: `git config core.hooksPath`
+# Workflow Enforcement Hooks - Setup Guide
+
+## Overview
+
+This system provides agent selection guidance by analyzing prompts and suggesting the best agent for the task.
+
+## Requirements
+
+- Python 3.8+
+
+## Files
+
+| File                     | Purpose                                               |
+| ------------------------ | ----------------------------------------------------- |
+| `user-prompt-submit.py`  | Analyzes prompts and suggests appropriate agents      |
+
+## Claude Code Configuration
+
+The hooks are configured in `.claude/settings.local.json`:
+
+```json
+{
+	"hooks": {
+		"UserPromptSubmit": [
+			{
+				"matcher": "",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "python .claude/hooks/user-prompt-submit.py",
+						"timeout": 10
+					}
+				]
+			}
+		]
+	}
+}
+```
+
+## Environment Variables
+
+| Variable             | Default       | Description            |
+| -------------------- | ------------- | ---------------------- |
+| `CLAUDE_PROJECT_DIR` | `os.getcwd()` | Project root directory |
+
+## Troubleshooting
+
+### Hooks not executing
+
+1. Verify Python is in PATH
+2. Check `.claude/settings.local.json` hooks configuration
+3. Ensure hook files have execute permissions