vibe-forge 0.4.0 → 0.8.2

package/config/agents.json

@@ -1,132 +1,207 @@
-{
-  "_comment": "SINGLE SOURCE OF TRUTH for agent configuration. Used by bash scripts via load_agents_from_json() and Node.js directly. See config/agent-manifest.yaml for rich documentation (non-normative).",
-  "version": "1.1.0",
-  "agents": {
-    "hub": {
-      "name": "Planning Hub",
-      "icon": "⚒️",
-      "role": "Chief Orchestrator",
-      "aliases": ["planning", "master", "forge-master"],
-      "type": "core",
-      "persistent": true,
-      "terminal_tab": 1,
-      "personality_file": "agents/planning-hub/personality.md",
-      "tab_color": "#FF6B35",
-      "description": "Task distribution, progress tracking, agent coordination",
-      "task_types": ["planning", "coordination", "orchestration"]
-    },
-    "sentinel": {
-      "name": "Sentinel",
-      "icon": "🛡️",
-      "role": "Code Reviewer",
-      "aliases": ["review", "reviewer", "cr"],
-      "type": "core",
-      "persistent": true,
-      "terminal_tab": 5,
-      "personality_file": "agents/sentinel/personality.md",
-      "tab_color": "#8B5CF6",
-      "description": "Quality gates, code review, PR approval",
-      "task_types": ["review", "pr", "quality"]
-    },
-    "anvil": {
-      "name": "Anvil",
-      "icon": "🔨",
-      "role": "Frontend Developer",
-      "aliases": ["frontend", "ui", "fe"],
-      "type": "worker",
-      "persistent": true,
-      "terminal_tab": 2,
-      "personality_file": "agents/anvil/personality.md",
-      "tab_color": "#3B82F6",
-      "description": "UI components, React/Vue/Blazor, CSS, client-side logic",
-      "task_types": ["frontend", "component", "ui", "styling", "blazor"]
-    },
-    "furnace": {
-      "name": "Furnace",
-      "icon": "🔥",
-      "role": "Backend Developer",
-      "aliases": ["backend", "api", "be"],
-      "type": "worker",
-      "persistent": true,
-      "terminal_tab": 3,
-      "personality_file": "agents/furnace/personality.md",
-      "tab_color": "#EF4444",
-      "description": "API endpoints, database, server logic, .NET/Node.js services",
-      "task_types": ["backend", "api", "database", "service", "dotnet"]
-    },
-    "crucible": {
-      "name": "Crucible",
-      "icon": "🧪",
-      "role": "Tester / QA",
-      "aliases": ["test", "testing", "qa", "tester"],
-      "type": "worker",
-      "persistent": true,
-      "terminal_tab": 4,
-      "personality_file": "agents/crucible/personality.md",
-      "tab_color": "#10B981",
-      "description": "Test writing, bug hunting, quality validation, xUnit/NUnit/Jest",
-      "task_types": ["test", "qa", "bugfix", "e2e", "xunit"]
-    },
-    "scribe": {
-      "name": "Scribe",
-      "icon": "📜",
-      "role": "Documentation Specialist",
-      "aliases": ["docs", "documentation", "doc"],
-      "type": "worker",
-      "persistent": false,
-      "personality_file": "agents/scribe/personality.md",
-      "tab_color": "#F59E0B",
-      "description": "Docs, README, API documentation, inline comments",
-      "task_types": ["docs", "readme", "api-docs", "comments"]
-    },
-    "herald": {
-      "name": "Herald",
-      "icon": "📯",
-      "role": "Release Manager",
-      "aliases": ["release", "deploy", "deployment"],
-      "type": "worker",
-      "persistent": false,
-      "personality_file": "agents/herald/personality.md",
-      "tab_color": "#EC4899",
-      "description": "Versioning, changelog, deployment, release notes",
-      "task_types": ["release", "deploy", "changelog", "version"]
-    },
-    "ember": {
-      "name": "Ember",
-      "icon": "⚙️",
-      "role": "DevOps Engineer",
-      "aliases": ["devops", "ops", "infra", "infrastructure"],
-      "type": "specialist",
-      "persistent": false,
-      "personality_file": "agents/ember/personality.md",
-      "tab_color": "#F97316",
-      "description": "Infrastructure, CI/CD, Docker, Azure, .NET deployment",
-      "task_types": ["devops", "infra", "ci-cd", "docker", "azure"]
-    },
-    "aegis": {
-      "name": "Aegis",
-      "icon": "🔒",
-      "role": "Security Specialist",
-      "aliases": ["security", "sec", "appsec"],
-      "type": "specialist",
-      "persistent": false,
-      "personality_file": "agents/aegis/personality.md",
-      "tab_color": "#06B6D4",
-      "description": "Security audit, vulnerability assessment, hardening",
-      "task_types": ["security", "audit", "vulnerability"],
-      "requires_approval": true
-    },
-    "architect": {
-      "name": "Architect",
-      "icon": "🏛️",
-      "role": "System Architect",
-      "aliases": ["arch", "design", "sage"],
-      "type": "advisor",
-      "persistent": false,
-      "personality_file": "agents/architect/personality.md",
-      "tab_color": "#6366F1",
-      "description": "System design, technical decisions, architecture review",
-      "task_types": ["architecture", "design", "tech-debt"]
-    }
-  }
-}
+{
+  "_comment": "SINGLE SOURCE OF TRUTH for agent configuration. Used by bash scripts via load_agents_from_json() and Node.js directly. See config/agent-manifest.yaml for rich documentation (non-normative).",
+  "version": "1.1.0",
+  "agents": {
+    "hub": {
+      "name": "Planning Hub",
+      "icon": "⚒️",
+      "role": "Chief Orchestrator",
+      "aliases": ["planning", "master", "forge-master"],
+      "type": "core",
+      "persistent": true,
+      "terminal_tab": 1,
+      "personality_file": "agents/planning-hub/personality.md",
+      "tab_color": "#FF6B35",
+      "description": "Task distribution, progress tracking, agent coordination",
+      "task_types": ["planning", "coordination", "orchestration"]
+    },
+    "temper": {
+      "name": "Temper",
+      "icon": "⚖️",
+      "role": "Code Reviewer",
+      "aliases": ["review", "reviewer", "cr"],
+      "type": "core",
+      "persistent": true,
+      "terminal_tab": 5,
+      "personality_file": "agents/temper/personality.md",
+      "tab_color": "#8B5CF6",
+      "description": "Quality gates, code review, PR approval",
+      "task_types": ["review", "pr", "quality"]
+    },
+    "anvil": {
+      "name": "Anvil",
+      "icon": "🔨",
+      "role": "Frontend Developer",
+      "aliases": ["frontend", "ui", "fe"],
+      "type": "worker",
+      "persistent": true,
+      "terminal_tab": 2,
+      "personality_file": "agents/anvil/personality.md",
+      "tab_color": "#3B82F6",
+      "description": "UI components, React/Vue/Blazor, CSS, client-side logic",
+      "task_types": ["frontend", "component", "ui", "styling", "blazor"]
+    },
+    "furnace": {
+      "name": "Furnace",
+      "icon": "🔥",
+      "role": "Backend Developer",
+      "aliases": ["backend", "api", "be"],
+      "type": "worker",
+      "persistent": true,
+      "terminal_tab": 3,
+      "personality_file": "agents/furnace/personality.md",
+      "tab_color": "#EF4444",
+      "description": "API endpoints, database, server logic, .NET/Node.js services",
+      "task_types": ["backend", "api", "database", "service", "dotnet"]
+    },
+    "crucible": {
+      "name": "Crucible",
+      "icon": "🧪",
+      "role": "Tester / QA",
+      "aliases": ["test", "testing", "qa", "tester"],
+      "type": "worker",
+      "persistent": true,
+      "terminal_tab": 4,
+      "personality_file": "agents/crucible/personality.md",
+      "tab_color": "#10B981",
+      "description": "Test writing, bug hunting, quality validation, xUnit/NUnit/Jest",
+      "task_types": ["test", "qa", "bugfix", "e2e", "xunit"]
+    },
+    "scribe": {
+      "name": "Scribe",
+      "icon": "📜",
+      "role": "Documentation Specialist",
+      "aliases": ["docs", "documentation", "doc"],
+      "type": "worker",
+      "persistent": false,
+      "personality_file": "agents/scribe/personality.md",
+      "tab_color": "#F59E0B",
+      "description": "Docs, README, API documentation, inline comments",
+      "task_types": ["docs", "readme", "api-docs", "comments"]
+    },
+    "herald": {
+      "name": "Herald",
+      "icon": "📯",
+      "role": "Release Manager",
+      "aliases": ["release", "deploy", "deployment"],
+      "type": "worker",
+      "persistent": false,
+      "personality_file": "agents/herald/personality.md",
+      "tab_color": "#EC4899",
+      "description": "Versioning, changelog, deployment, release notes",
+      "task_types": ["release", "deploy", "changelog", "version"]
+    },
+    "ember": {
+      "name": "Ember",
+      "icon": "⚙️",
+      "role": "DevOps Engineer",
+      "aliases": ["devops", "ops", "infra", "infrastructure"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/ember/personality.md",
+      "tab_color": "#F97316",
+      "description": "Infrastructure, CI/CD, Docker, Azure, .NET deployment",
+      "task_types": ["devops", "infra", "ci-cd", "docker", "azure"]
+    },
+    "aegis": {
+      "name": "Aegis",
+      "icon": "🔒",
+      "role": "Security Specialist",
+      "aliases": ["security", "sec", "appsec"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/aegis/personality.md",
+      "tab_color": "#06B6D4",
+      "description": "Security audit, vulnerability assessment, hardening",
+      "task_types": ["security", "audit", "vulnerability"],
+      "requires_approval": true
+    },
+    "slag": {
+      "name": "Slag",
+      "icon": "💀",
+      "role": "Red Team Lead",
+      "aliases": ["redteam", "red-team", "pentest", "offensive"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/slag/personality.md",
+      "tab_color": "#DC2626",
+      "description": "Offensive security, OWASP testing, engagement lead, attack simulation",
+      "task_types": ["redteam", "pentest", "offensive-security"],
+      "requires_approval": true
+    },
+    "flux": {
+      "name": "Flux",
+      "icon": "⚡",
+      "role": "Red Team Operator",
+      "aliases": ["infra-sec", "supply-chain", "chaos"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/flux/personality.md",
+      "tab_color": "#B91C1C",
+      "description": "Infrastructure security, dependency CVEs, CI/CD attacks, chaos testing",
+      "task_types": ["redteam", "infra-security", "supply-chain", "chaos"],
+      "requires_approval": true
+    },
+    "architect": {
+      "name": "Architect",
+      "icon": "🏛️",
+      "role": "System Architect",
+      "aliases": ["arch", "sage"],
+      "type": "advisor",
+      "persistent": false,
+      "personality_file": "agents/architect/personality.md",
+      "tab_color": "#6366F1",
+      "description": "System design, technical decisions, architecture review",
+      "task_types": ["architecture", "design", "tech-debt"]
+    },
+    "pixel": {
+      "name": "Pixel",
+      "icon": "🎨",
+      "role": "UX Designer",
+      "aliases": ["ux", "ui-design", "user-experience"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/pixel/personality.md",
+      "tab_color": "#D946EF",
+      "description": "User experience, interaction design, wireframes, accessibility",
+      "task_types": ["ux", "wireframe", "design", "accessibility", "user-research"]
+    },
+    "oracle": {
+      "name": "Oracle",
+      "icon": "🔮",
+      "role": "Product Owner / Requirements Analyst",
+      "aliases": ["product", "po", "requirements", "req", "analyst"],
+      "type": "advisor",
+      "persistent": false,
+      "personality_file": "agents/oracle/personality.md",
+      "tab_color": "#FBBF24",
+      "description": "Product requirements, epics, user stories, acceptance criteria, research",
+      "task_types": ["product", "requirements", "epics", "stories", "research", "planning"]
+    },
+    "loki": {
+      "name": "Loki",
+      "icon": "🎭",
+      "role": "Lateral Thinker, Assumption Challenger",
+      "aliases": ["trickster", "contrarian", "challenge", "brainstorm"],
+      "type": "advisor",
+      "persistent": false,
+      "personality_file": "agents/loki/personality.md",
+      "tab_color": "#7C3AED",
+      "description": "Challenges assumptions, lateral thinking, brainstorm provocations",
+      "task_types": ["brainstorm", "design-review", "planning", "postmortem"]
+    },
+    "crucible-x": {
+      "name": "Crucible-X",
+      "icon": "🔥🧪",
+      "role": "Adversarial Reviewer",
+      "aliases": ["adversarial", "break-it", "breaker", "cx"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/crucible-x/personality.md",
+      "tab_color": "#DC2626",
+      "description": "Adversarial testing, edge case discovery, failing test generation",
+      "task_types": ["adversarial-review", "security-test", "edge-case"],
+      "requires_approval": false
+    }
+  }
+}

package/config/task-types.yaml

@@ -1,106 +1,111 @@
-# Vibe Forge Task Types
-# Used by Forge Master for routing decisions
-
-task_types:
-  frontend:
-    agent: anvil
-    description: "UI components, React/Vue/Svelte, CSS, client-side logic"
-    file_patterns:
-      - "src/components/**"
-      - "src/pages/**"
-      - "src/styles/**"
-      - "*.css"
-      - "*.scss"
-
-  backend:
-    agent: furnace
-    description: "API endpoints, server logic, database operations"
-    file_patterns:
-      - "src/api/**"
-      - "src/services/**"
-      - "src/models/**"
-      - "src/middleware/**"
-      - "prisma/**"
-
-  test:
-    agent: crucible
-    description: "Unit tests, integration tests, E2E tests, bug fixes"
-    file_patterns:
-      - "**/*.test.ts"
-      - "**/*.spec.ts"
-      - "tests/**"
-      - "e2e/**"
-
-  docs:
-    agent: scribe
-    description: "Documentation, README, API docs, inline comments"
-    file_patterns:
-      - "docs/**"
-      - "*.md"
-      - "openapi.yaml"
-
-  review:
-    agent: sentinel
-    description: "Code review, quality checks, PR review"
-    auto_assign: true  # All completed tasks auto-route here
-
-  release:
-    agent: herald
-    description: "Version bumps, changelog, deployment, release notes"
-    file_patterns:
-      - "CHANGELOG.md"
-      - "package.json (version)"
-      - ".github/workflows/**"
-
-  devops:
-    agent: ember
-    description: "Infrastructure, CI/CD, Docker, server management"
-    file_patterns:
-      - "Dockerfile"
-      - "docker-compose.yaml"
-      - ".github/workflows/**"
-      - "terraform/**"
-      - "k8s/**"
-
-  security:
-    agent: aegis
-    description: "Security audit, vulnerability fixes, auth hardening"
-    requires_approval: true  # Needs Planning Hub sign-off
-
-priorities:
-  critical:
-    sla_hours: 0
-    description: "Blocking other work, production issue"
-
-  high:
-    sla_hours: 8
-    description: "Sprint commitment, needed today"
-
-  medium:
-    sla_hours: 40
-    description: "Sprint goal, this sprint"
-
-  low:
-    sla_hours: null
-    description: "Nice to have, when available"
-
-complexity:
-  trivial:
-    estimated_minutes: 15
-    description: "Config change, typo fix"
-
-  low:
-    estimated_minutes: 30
-    description: "Simple function, minor feature"
-
-  medium:
-    estimated_minutes: 60
-    description: "New component, API endpoint"
-
-  high:
-    estimated_minutes: 180
-    description: "Complex feature, refactoring"
-
-  unknown:
-    estimated_minutes: null
-    description: "Needs investigation"
+# Vibe Forge Task Types
+# Used by Planning Hub for routing decisions
+
+task_types:
+  frontend:
+    agent: anvil
+    description: "UI components, React/Vue/Svelte, CSS, client-side logic"
+    file_patterns:
+      - "src/components/**"
+      - "src/pages/**"
+      - "src/styles/**"
+      - "*.css"
+      - "*.scss"
+
+  backend:
+    agent: furnace
+    description: "API endpoints, server logic, database operations"
+    file_patterns:
+      - "src/api/**"
+      - "src/services/**"
+      - "src/models/**"
+      - "src/middleware/**"
+      - "prisma/**"
+
+  test:
+    agent: crucible
+    description: "Unit tests, integration tests, E2E tests, bug fixes"
+    file_patterns:
+      - "**/*.test.ts"
+      - "**/*.spec.ts"
+      - "tests/**"
+      - "e2e/**"
+
+  docs:
+    agent: scribe
+    description: "Documentation, README, API docs, inline comments"
+    file_patterns:
+      - "docs/**"
+      - "*.md"
+      - "openapi.yaml"
+
+  review:
+    agent: sentinel
+    description: "Code review, quality checks, PR review"
+    auto_assign: true  # All completed tasks auto-route here
+
+  release:
+    agent: herald
+    description: "Version bumps, changelog, deployment, release notes"
+    file_patterns:
+      - "CHANGELOG.md"
+      - "package.json (version)"
+      - ".github/workflows/**"
+
+  devops:
+    agent: ember
+    description: "Infrastructure, CI/CD, Docker, server management"
+    file_patterns:
+      - "Dockerfile"
+      - "docker-compose.yaml"
+      - ".github/workflows/**"
+      - "terraform/**"
+      - "k8s/**"
+
+  security:
+    agent: aegis
+    description: "Security audit, vulnerability fixes, auth hardening"
+    requires_approval: true  # Needs Planning Hub sign-off
+
+  redteam:
+    agent: slag
+    description: "Offensive security testing, penetration testing, red team engagements"
+    requires_approval: true  # All red team actions need sign-off
+
+priorities:
+  critical:
+    sla_hours: 0
+    description: "Blocking other work, production issue"
+
+  high:
+    sla_hours: 8
+    description: "Sprint commitment, needed today"
+
+  medium:
+    sla_hours: 40
+    description: "Sprint goal, this sprint"
+
+  low:
+    sla_hours: null
+    description: "Nice to have, when available"
+
+complexity:
+  trivial:
+    estimated_minutes: 15
+    description: "Config change, typo fix"
+
+  low:
+    estimated_minutes: 30
+    description: "Simple function, minor feature"
+
+  medium:
+    estimated_minutes: 60
+    description: "New component, API endpoint"
+
+  high:
+    estimated_minutes: 180
+    description: "Complex feature, refactoring"
+
+  unknown:
+    estimated_minutes: null
+    description: "Needs investigation"

package/context/agent-overrides/README.md

@@ -0,0 +1,41 @@
+# Agent Overrides
+
+Place per-agent override files here to customize agent behavior for this project.
+
+## How It Works
+
+When Planning Hub spawns a worker, it appends the contents of
+`context/agent-overrides/<agent-name>.md` to the agent's system prompt.
+This lets you add project-specific rules without modifying the global
+personality files.
+
+## File Naming
+
+Use the canonical agent name (matching `config/agents.json`):
+
+```
+context/agent-overrides/
+  anvil.md        # Frontend-specific project rules
+  furnace.md      # Backend-specific project rules
+  crucible.md     # Testing conventions for this project
+  ...
+```
+
+## What to Put Here
+
+- Tech stack constraints ("Use React Query, not SWR")
+- Naming conventions specific to this project
+- Files or directories the agent should never touch
+- Patterns the agent should follow or avoid
+- Project-specific testing requirements
+
+## Example
+
+```markdown
+# Anvil Overrides
+
+- Use Tailwind CSS utility classes, no custom CSS files
+- All components must be in `src/components/` with PascalCase naming
+- Use `shadcn/ui` for base components, don't reinvent
+- Never import from `@/lib/legacy/` (deprecated)
+```

package/context/architecture.md

@@ -0,0 +1,42 @@
+# Project Architecture
+
+This file contains project-specific architectural decisions and guardrails.
+Agents read this during planning and task execution to stay aligned.
+
+For Vibe Forge's own architecture, see [docs/architecture.md](../docs/architecture.md).
+
+---
+
+## Key Decisions
+
+<!-- Add project-specific architectural decisions here -->
+<!-- Example:
+- **Auth:** JWT with httpOnly cookies, refresh token rotation
+- **Database:** PostgreSQL via Prisma ORM, no raw SQL outside migrations
+- **API:** REST for CRUD, WebSocket for real-time updates
+-->
+
+## Patterns
+
+<!-- Document patterns agents should follow -->
+<!-- Example:
+- Repository pattern for data access (no direct DB queries in handlers)
+- Error boundaries at route level, not in services
+- All new endpoints require OpenAPI spec before implementation
+-->
+
+## Guardrails
+
+<!-- Things agents must NOT do -->
+<!-- Example:
+- Never modify schema files without running `prisma migrate dev`
+- No new dependencies without architect approval
+- No `any` types in TypeScript
+-->
+
+## ADR Index
+
+<!-- Link to Architecture Decision Records as they're created -->
+<!-- Example:
+- [ADR-001](../docs/adr/ADR-001-daemon-module-extraction.md) - Daemon module extraction
+-->