start-vibing 1.1.2 → 1.1.4

package/template/.claude/hooks/workflow-manager.py

@@ -1,350 +0,0 @@
-#!/usr/bin/env python3
-"""
-Workflow Manager - Helper Script for Agents
-
-This script provides utilities for agents to update workflow state.
-Called by agents to track their execution.
-
-Usage:
-  workflow-manager.py start-task --type feature --description "Add login"
-  workflow-manager.py agent-executed --agent analyzer --result approved
-  workflow-manager.py approve-files --files "src/*.ts" "app/page.tsx"
-  workflow-manager.py quality-gate --gate typecheck --passed true
-  workflow-manager.py security-audit --result approved
-  workflow-manager.py final-validation --result approved --ready-to-commit true
-  workflow-manager.py complete-task --commit-hash abc123
-"""
-
-import json
-import sys
-import os
-import argparse
-from datetime import datetime
-from pathlib import Path
-
-PROJECT_DIR = os.environ.get('CLAUDE_PROJECT_DIR', os.getcwd())
-WORKFLOW_STATE_PATH = Path(PROJECT_DIR) / '.claude' / 'workflow-state.json'
-
-
-def load_state():
-    if not WORKFLOW_STATE_PATH.exists():
-        return {"version": "1.0.0", "currentTask": None, "sessions": []}
-    with open(WORKFLOW_STATE_PATH) as f:
-        return json.load(f)
-
-
-def save_state(state):
-    WORKFLOW_STATE_PATH.parent.mkdir(parents=True, exist_ok=True)
-    with open(WORKFLOW_STATE_PATH, 'w') as f:
-        json.dump(state, f, indent=2)
-
-
-def start_task(args):
-    """Start a new task"""
-    state = load_state()
-
-    # Archive current task if exists
-    if state.get('currentTask'):
-        print("Warning: Previous task was not completed. Archiving.", file=sys.stderr)
-
-    task_id = datetime.now().strftime('%Y%m%d_%H%M%S')
-
-    state['currentTask'] = {
-        'id': task_id,
-        'type': args.type,
-        'description': args.description,
-        'startedAt': datetime.now().isoformat(),
-        'agents': {
-            'orchestrator': {'executed': True, 'executedAt': datetime.now().isoformat(), 'result': 'approved'},
-            'analyzer': {'executed': False},
-            'research': {'executed': False},
-            'uiUxReviewer': {'executed': False},
-            'documenter': {'executed': False},
-            'tester': {'executed': False},
-            'securityAuditor': {'executed': False},
-            'qualityChecker': {'executed': False},
-            'finalValidator': {'executed': False},
-            'domainUpdater': {'executed': False},
-            'commitManager': {'executed': False},
-        },
-        'approvedFiles': [],
-        'modifiedFiles': [],
-        'testsCreated': [],
-        'docsUpdated': [],
-        'qualityGates': {},
-        'securityAudit': {},
-        'finalValidation': {}
-    }
-
-    save_state(state)
-    print(f"[OK] Task started: {task_id}")
-    print(f"  Type: {args.type}")
-    print(f"  Description: {args.description}")
-
-
-def agent_executed(args):
-    """Mark an agent as executed"""
-    state = load_state()
-
-    if not state.get('currentTask'):
-        print("Error: No active task", file=sys.stderr)
-        sys.exit(1)
-
-    # Map CLI names to JSON keys
-    agent_map = {
-        'orchestrator': 'orchestrator',
-        'analyzer': 'analyzer',
-        'research': 'research',
-        'ui-ux-reviewer': 'uiUxReviewer',
-        'documenter': 'documenter',
-        'tester': 'tester',
-        'security-auditor': 'securityAuditor',
-        'quality-checker': 'qualityChecker',
-        'final-validator': 'finalValidator',
-        'domain-updater': 'domainUpdater',
-        'domainUpdater': 'domainUpdater',
-        'commit-manager': 'commitManager',
-    }
-
-    agent_key = agent_map.get(args.agent, args.agent)
-
-    state['currentTask']['agents'][agent_key] = {
-        'executed': True,
-        'executedAt': datetime.now().isoformat(),
-        'result': args.result,
-        'notes': args.notes or ''
-    }
-
-    save_state(state)
-    print(f"[OK] Agent '{args.agent}' marked as executed with result: {args.result}")
-
-
-def approve_files(args):
-    """Add files to approved list"""
-    state = load_state()
-
-    if not state.get('currentTask'):
-        print("Error: No active task", file=sys.stderr)
-        sys.exit(1)
-
-    # Get current approved files
-    approved = state['currentTask'].get('approvedFiles', [])
-
-    # Add new files
-    for file in args.files:
-        if file not in approved:
-            approved.append(file)
-
-    state['currentTask']['approvedFiles'] = approved
-
-    save_state(state)
-    print(f"[OK] Approved {len(args.files)} file(s) for modification:")
-    for f in args.files:
-        print(f"  - {f}")
-
-
-def quality_gate(args):
-    """Record quality gate result"""
-    state = load_state()
-
-    if not state.get('currentTask'):
-        print("Error: No active task", file=sys.stderr)
-        sys.exit(1)
-
-    passed = args.passed.lower() == 'true'
-
-    state['currentTask']['qualityGates'][args.gate] = {
-        'passed': passed,
-        'executedAt': datetime.now().isoformat(),
-        'errors': args.errors.split(',') if args.errors else []
-    }
-
-    save_state(state)
-    status = "[PASS]" if passed else "[FAIL]"
-    print(f"{status}: Quality gate '{args.gate}'")
-
-
-def security_audit(args):
-    """Record security audit result"""
-    state = load_state()
-
-    if not state.get('currentTask'):
-        print("Error: No active task", file=sys.stderr)
-        sys.exit(1)
-
-    state['currentTask']['securityAudit'] = {
-        'executed': True,
-        'executedAt': datetime.now().isoformat(),
-        'result': args.result,
-        'vulnerabilities': args.vulnerabilities.split(',') if args.vulnerabilities else []
-    }
-
-    # Update agent status
-    state['currentTask']['agents']['securityAuditor'] = {
-        'executed': True,
-        'executedAt': datetime.now().isoformat(),
-        'result': args.result
-    }
-
-    save_state(state)
-    status = "[APPROVED]" if args.result == 'approved' else "[VETOED]"
-    print(f"{status}: Security audit")
-
-
-def final_validation(args):
-    """Record final validation result"""
-    state = load_state()
-
-    if not state.get('currentTask'):
-        print("Error: No active task", file=sys.stderr)
-        sys.exit(1)
-
-    ready = args.ready_to_commit.lower() == 'true' if args.ready_to_commit else False
-
-    state['currentTask']['finalValidation'] = {
-        'executed': True,
-        'executedAt': datetime.now().isoformat(),
-        'result': args.result,
-        'violations': args.violations.split(',') if args.violations else [],
-        'readyToCommit': ready
-    }
-
-    # Update agent status
-    state['currentTask']['agents']['finalValidator'] = {
-        'executed': True,
-        'executedAt': datetime.now().isoformat(),
-        'result': args.result
-    }
-
-    save_state(state)
-    status = "[APPROVED]" if args.result == 'approved' else "[VETOED]"
-    print(f"{status}: Final validation (ready to commit: {ready})")
-
-
-def complete_task(args):
-    """Complete current task and archive"""
-    state = load_state()
-
-    if not state.get('currentTask'):
-        print("Error: No active task", file=sys.stderr)
-        sys.exit(1)
-
-    task = state['currentTask']
-
-    # Check if ready to commit
-    final = task.get('finalValidation', {})
-    if not final.get('readyToCommit'):
-        print("Error: Task is not ready to commit. Run final validation first.", file=sys.stderr)
-        sys.exit(1)
-
-    # Archive task
-    session = {
-        'id': task['id'],
-        'task': task,
-        'completedAt': datetime.now().isoformat(),
-        'commitHash': args.commit_hash
-    }
-
-    state['sessions'].append(session)
-    state['currentTask'] = None
-
-    save_state(state)
-    print(f"[OK] Task completed and archived")
-    print(f"  Commit: {args.commit_hash}")
-
-
-def show_status(args):
-    """Show current workflow status"""
-    state = load_state()
-
-    if not state.get('currentTask'):
-        print("No active task")
-        print("Run: workflow-manager.py start-task --type <type> --description <desc>")
-        return
-
-    task = state['currentTask']
-    print(f"Current Task: {task['id']}")
-    print(f"Type: {task['type']}")
-    print(f"Description: {task['description']}")
-    print(f"Started: {task['startedAt']}")
-    print()
-    print("Agents:")
-    for name, agent_status in task['agents'].items():
-        icon = "[x]" if agent_status.get('executed') else "[ ]"
-        result = f" ({agent_status.get('result', 'pending')})" if agent_status.get('executed') else ""
-        print(f"  {icon} {name}{result}")
-    print()
-    print(f"Approved files: {len(task.get('approvedFiles', []))}")
-    print(f"Modified files: {len(task.get('modifiedFiles', []))}")
-    print(f"Tests created: {len(task.get('testsCreated', []))}")
-    print(f"Docs updated: {len(task.get('docsUpdated', []))}")
-
-
-def main():
-    parser = argparse.ArgumentParser(description='Workflow Manager')
-    subparsers = parser.add_subparsers(dest='command', help='Commands')
-
-    # start-task
-    p = subparsers.add_parser('start-task', help='Start a new task')
-    p.add_argument('--type', required=True, choices=['feature', 'fix', 'refactor', 'config', 'research'])
-    p.add_argument('--description', required=True)
-
-    # agent-executed
-    p = subparsers.add_parser('agent-executed', help='Mark agent as executed')
-    p.add_argument('--agent', required=True)
-    p.add_argument('--result', required=True, choices=['approved', 'vetoed', 'skipped'])
-    p.add_argument('--notes', default='')
-
-    # approve-files
-    p = subparsers.add_parser('approve-files', help='Approve files for modification')
-    p.add_argument('--files', nargs='+', required=True)
-
-    # quality-gate
-    p = subparsers.add_parser('quality-gate', help='Record quality gate result')
-    p.add_argument('--gate', required=True, choices=['typecheck', 'lint', 'unitTests', 'e2eTests', 'build'])
-    p.add_argument('--passed', required=True, choices=['true', 'false'])
-    p.add_argument('--errors', default='')
-
-    # security-audit
-    p = subparsers.add_parser('security-audit', help='Record security audit')
-    p.add_argument('--result', required=True, choices=['approved', 'vetoed'])
-    p.add_argument('--vulnerabilities', default='')
-
-    # final-validation
-    p = subparsers.add_parser('final-validation', help='Record final validation')
-    p.add_argument('--result', required=True, choices=['approved', 'vetoed'])
-    p.add_argument('--ready-to-commit', default='false')
-    p.add_argument('--violations', default='')
-
-    # complete-task
-    p = subparsers.add_parser('complete-task', help='Complete and archive task')
-    p.add_argument('--commit-hash', required=True)
-
-    # status
-    subparsers.add_parser('status', help='Show current status')
-
-    args = parser.parse_args()
-
-    if args.command == 'start-task':
-        start_task(args)
-    elif args.command == 'agent-executed':
-        agent_executed(args)
-    elif args.command == 'approve-files':
-        approve_files(args)
-    elif args.command == 'quality-gate':
-        quality_gate(args)
-    elif args.command == 'security-audit':
-        security_audit(args)
-    elif args.command == 'final-validation':
-        final_validation(args)
-    elif args.command == 'complete-task':
-        complete_task(args)
-    elif args.command == 'status':
-        show_status(args)
-    else:
-        parser.print_help()
-        sys.exit(1)
-
-
-if __name__ == '__main__':
-    main()

package/template/.claude/workflow-state.schema.json

@@ -1,200 +0,0 @@
-{
-	"$schema": "http://json-schema.org/draft-07/schema#",
-	"title": "Claude Workflow State",
-	"description": "Tracks agent workflow execution state for enforcement",
-	"type": "object",
-	"required": ["version", "currentTask", "sessions"],
-	"properties": {
-		"version": {
-			"type": "string",
-			"description": "Schema version"
-		},
-		"currentTask": {
-			"oneOf": [{ "type": "null" }, { "$ref": "#/definitions/task" }],
-			"description": "Currently active task (null if no task in progress)"
-		},
-		"sessions": {
-			"type": "array",
-			"items": { "$ref": "#/definitions/session" },
-			"description": "History of completed sessions"
-		}
-	},
-	"definitions": {
-		"task": {
-			"type": "object",
-			"required": [
-				"id",
-				"type",
-				"description",
-				"startedAt",
-				"agents",
-				"approvedFiles",
-				"modifiedFiles"
-			],
-			"properties": {
-				"id": {
-					"type": "string",
-					"description": "Unique task ID (timestamp-based)"
-				},
-				"type": {
-					"type": "string",
-					"enum": ["feature", "fix", "refactor", "config", "research"],
-					"description": "Task classification"
-				},
-				"description": {
-					"type": "string",
-					"description": "Task description from user"
-				},
-				"startedAt": {
-					"type": "string",
-					"format": "date-time",
-					"description": "When task started"
-				},
-				"agents": {
-					"$ref": "#/definitions/agentExecution",
-					"description": "Track which agents have executed"
-				},
-				"approvedFiles": {
-					"type": "array",
-					"items": { "type": "string" },
-					"description": "Files approved for modification by analyzer"
-				},
-				"modifiedFiles": {
-					"type": "array",
-					"items": { "$ref": "#/definitions/fileModification" },
-					"description": "Files actually modified"
-				},
-				"testsCreated": {
-					"type": "array",
-					"items": { "type": "string" },
-					"description": "Test files created"
-				},
-				"docsUpdated": {
-					"type": "array",
-					"items": { "type": "string" },
-					"description": "Documentation files updated"
-				},
-				"qualityGates": {
-					"$ref": "#/definitions/qualityGates",
-					"description": "Quality gate results"
-				},
-				"securityAudit": {
-					"$ref": "#/definitions/securityAudit",
-					"description": "Security audit result"
-				},
-				"finalValidation": {
-					"$ref": "#/definitions/finalValidation",
-					"description": "Final validation result"
-				}
-			}
-		},
-		"agentExecution": {
-			"type": "object",
-			"properties": {
-				"orchestrator": { "$ref": "#/definitions/agentStatus" },
-				"analyzer": { "$ref": "#/definitions/agentStatus" },
-				"uiUxReviewer": { "$ref": "#/definitions/agentStatus" },
-				"documenter": { "$ref": "#/definitions/agentStatus" },
-				"tester": { "$ref": "#/definitions/agentStatus" },
-				"securityAuditor": { "$ref": "#/definitions/agentStatus" },
-				"qualityChecker": { "$ref": "#/definitions/agentStatus" },
-				"finalValidator": { "$ref": "#/definitions/agentStatus" },
-				"commitManager": { "$ref": "#/definitions/agentStatus" }
-			}
-		},
-		"agentStatus": {
-			"type": "object",
-			"required": ["executed"],
-			"properties": {
-				"executed": {
-					"type": "boolean",
-					"description": "Whether this agent has executed"
-				},
-				"executedAt": {
-					"type": "string",
-					"format": "date-time",
-					"description": "When executed"
-				},
-				"result": {
-					"type": "string",
-					"enum": ["pending", "approved", "vetoed", "skipped"],
-					"description": "Agent result"
-				},
-				"notes": {
-					"type": "string",
-					"description": "Any notes from execution"
-				}
-			}
-		},
-		"fileModification": {
-			"type": "object",
-			"required": ["path", "action", "timestamp"],
-			"properties": {
-				"path": {
-					"type": "string",
-					"description": "File path"
-				},
-				"action": {
-					"type": "string",
-					"enum": ["created", "modified", "deleted"],
-					"description": "Type of modification"
-				},
-				"timestamp": {
-					"type": "string",
-					"format": "date-time"
-				},
-				"approved": {
-					"type": "boolean",
-					"description": "Was this file in approvedFiles list?"
-				}
-			}
-		},
-		"qualityGates": {
-			"type": "object",
-			"properties": {
-				"typecheck": { "$ref": "#/definitions/gateResult" },
-				"lint": { "$ref": "#/definitions/gateResult" },
-				"unitTests": { "$ref": "#/definitions/gateResult" },
-				"e2eTests": { "$ref": "#/definitions/gateResult" },
-				"build": { "$ref": "#/definitions/gateResult" }
-			}
-		},
-		"gateResult": {
-			"type": "object",
-			"properties": {
-				"passed": { "type": "boolean" },
-				"executedAt": { "type": "string", "format": "date-time" },
-				"errors": { "type": "array", "items": { "type": "string" } }
-			}
-		},
-		"securityAudit": {
-			"type": "object",
-			"properties": {
-				"executed": { "type": "boolean" },
-				"executedAt": { "type": "string", "format": "date-time" },
-				"result": { "type": "string", "enum": ["approved", "vetoed"] },
-				"vulnerabilities": { "type": "array", "items": { "type": "string" } }
-			}
-		},
-		"finalValidation": {
-			"type": "object",
-			"properties": {
-				"executed": { "type": "boolean" },
-				"executedAt": { "type": "string", "format": "date-time" },
-				"result": { "type": "string", "enum": ["approved", "vetoed"] },
-				"violations": { "type": "array", "items": { "type": "string" } },
-				"readyToCommit": { "type": "boolean" }
-			}
-		},
-		"session": {
-			"type": "object",
-			"required": ["id", "task", "completedAt", "commitHash"],
-			"properties": {
-				"id": { "type": "string" },
-				"task": { "$ref": "#/definitions/task" },
-				"completedAt": { "type": "string", "format": "date-time" },
-				"commitHash": { "type": "string" }
-			}
-		}
-	}
-}