vibe-forge 0.4.0 → 0.8.1

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-template.md

@@ -1,87 +1,159 @@
----
-id: task-{ID}
-title: "{TITLE}"
-type: {TYPE}  # frontend | backend | test | docs | review | release | devops | security
-priority: {PRIORITY}  # critical | high | medium | low
-status: pending
-assigned_to: null
-blocked_by: []
-depends_on: []
-created: {TIMESTAMP}
-updated: {TIMESTAMP}
-estimated_complexity: {COMPLEXITY}  # trivial | low | medium | high | unknown
-epic: {EPIC_ID}
-story: {STORY_ID}  # optional
----
-
-# Context
-
-## Parent Epic
-See: /specs/epics/{EPIC_ID}.md
-
-## Relevant Files
-<!-- List ONLY files the agent needs to read or modify -->
-- /path/to/relevant/file.ts (reason: what to do here)
-- /path/to/reference/file.ts (reference only)
-
-## Dependencies
-<!-- Other tasks that must complete first -->
-- task-{DEP_ID} (status: pending|completed)
-
-## Background
-<!-- Brief context the agent needs - keep minimal, reference docs instead -->
-{BACKGROUND}
-
----
-
-# Acceptance Criteria
-
-<!-- Checkboxes for each requirement - agent marks complete as they work -->
-- [ ] {CRITERION_1}
-- [ ] {CRITERION_2}
-- [ ] {CRITERION_3}
-
----
-
-# Agent Instructions
-
-<!-- Specific instructions for the assigned agent -->
-{AGENT_TYPE}: {SPECIFIC_INSTRUCTIONS}
-
-**Boundaries:**
-- DO modify: {ALLOWED_PATHS}
-- DO NOT modify: {FORBIDDEN_PATHS}
-- If blocked, write blocker to task file and notify Forge Master
-
-**On Completion:**
-1. Ensure all acceptance criteria checked
-2. Run relevant tests
-3. Move this file to `/tasks/completed/`
-4. Include completion summary below
-
----
-
-# Output Expected
-
-- [ ] Files created/modified (list paths in completion)
-- [ ] Tests passing (include count)
-- [ ] No linting errors
-- [ ] Completion summary written
-
----
-
-# Completion Summary
-<!-- Filled by agent on completion -->
-
-```yaml
-completed_by: null
-completed_at: null
-duration_minutes: null
-files_modified: []
-files_created: []
-tests_added: 0
-tests_passing: 0
-notes: ""
-blockers_encountered: []
-ready_for_review: false
-```
+---
+id: task-{ID}
+title: "{TITLE}"
+type: {TYPE}  # frontend | backend | test | docs | review | release | devops | security
+priority: {PRIORITY}  # critical | high | medium | low
+status: pending
+assigned_to: null
+blocked_by: []
+depends_on: []
+created: {TIMESTAMP}
+updated: {TIMESTAMP}
+estimated_complexity: {COMPLEXITY}  # trivial | low | medium | high | unknown
+epic: {EPIC_ID}
+story: {STORY_ID}  # optional - epic_num.story_num format (e.g. 2.3)
+isolation: none  # none | worktree - use worktree for risky or experimental changes
+---
+
+# Context
+
+## Parent Epic
+See: /specs/epics/{EPIC_ID}.md
+
+## Relevant Files
+<!-- List ONLY files the agent needs to read or modify -->
+- /path/to/relevant/file.ts (reason: what to do here)
+- /path/to/reference/file.ts (reference only)
+
+## Dependencies
+<!-- Other tasks that must complete first -->
+- task-{DEP_ID} (status: pending|completed)
+
+## Background
+<!-- Brief context the agent needs - keep minimal, reference docs instead -->
+{BACKGROUND}
+
+## Dev Notes
+<!-- Architecture guardrails, relevant patterns, tech constraints - filled by Hub/Architect before assignment -->
+<!-- Example:
+- Auth uses JWT with refresh tokens - follow the pattern in src/middleware/auth.ts
+- All DB access goes through the repository layer in src/repositories/ - no raw queries in controllers
+- Error responses must use the Result<T,E> pattern from src/utils/result.ts
+- Relevant architecture decisions: context/architecture.md#section-3
+-->
+
+---
+
+# Acceptance Criteria
+
+<!-- Number each criterion - agents link tasks to AC numbers, Sentinel audits each one -->
+1. {CRITERION_1}
+2. {CRITERION_2}
+3. {CRITERION_3}
+
+---
+
+# Tasks / Subtasks
+
+<!-- Each task mapped to one or more AC numbers - enables per-criterion review audit -->
+- [ ] Task 1 (AC: #1, #2)
+  - [ ] Subtask 1.1
+  - [ ] Subtask 1.2
+- [ ] Task 2 (AC: #3)
+  - [ ] Subtask 2.1
+
+---
+
+# Agent Instructions
+
+<!-- Specific instructions for the assigned agent -->
+{AGENT_TYPE}: {SPECIFIC_INSTRUCTIONS}
+
+**Boundaries:**
+- DO modify: {ALLOWED_PATHS}
+- DO NOT modify: {FORBIDDEN_PATHS}
+
+**When to STOP and write to tasks/attention/:**
+- Required package/dependency not in project - get approval before adding
+- 3 consecutive failures on the same test
+- Acceptance criteria are ambiguous or contradictory
+- Schema or migration change would affect live data
+- Security concern requires Aegis review
+
+**On Completion:**
+1. Verify all Definition of Done items below are checked
+2. Run relevant tests - confirm they pass
+3. Move this file to `/tasks/completed/`
+4. Fill in completion summary below
+
+---
+
+# Definition of Done
+
+<!-- All items must be checked before setting ready_for_review: true -->
+<!-- Crucible audits this list before approving any task -->
+
+**Implementation**
+- [ ] All acceptance criteria satisfied (verify each numbered AC individually)
+- [ ] All tasks and subtasks completed
+- [ ] Edge cases handled — not just the happy path
+- [ ] No TODO/FIXME left in new code without a linked tracking task
+- [ ] No dead code or commented-out blocks committed
+
+**Testing**
+- [ ] Unit tests written for new functionality
+- [ ] Existing tests still pass (full suite, not just new tests)
+- [ ] No linting errors
+- [ ] Integration tests updated if this touches a service boundary
+- [ ] Negative cases tested (invalid input, error paths, boundary conditions)
+- [ ] No test is skipped or marked `.only` without a comment explaining why
+
+**Documentation**
+- [ ] File list complete in completion summary (every file touched)
+- [ ] Inline comments where logic is non-obvious
+- [ ] API contract documented if this adds or changes an endpoint
+- [ ] Breaking changes noted in completion summary with migration path
+
+**Security** _(if touching auth, data, external APIs, or file I/O)_
+- [ ] No hardcoded secrets or credentials
+- [ ] Input validated at boundaries
+- [ ] Error paths handled explicitly — not swallowed
+- [ ] Least privilege: no permissions broader than necessary
+
+**Database** _(if touching schema or data)_
+- [ ] Migration is reversible (down migration written and tested)
+- [ ] Migration does not destroy existing data without explicit task approval
+- [ ] Queries use parameterized inputs (no string concatenation)
+
+**Handoff**
+- [ ] Completion summary fully filled in (completed_by, files, test counts)
+- [ ] `ready_for_review: true` only when ALL above items are checked
+- [ ] Known limitations or follow-up tasks noted
+
+---
+
+# Output Expected
+
+- [ ] Files created/modified listed in completion summary
+- [ ] Tests passing (include count)
+- [ ] No linting errors
+- [ ] Definition of Done fully checked
+
+---
+
+# Completion Summary
+<!-- Filled by agent on completion -->
+
+```yaml
+completed_by: null
+completed_at: null
+duration_minutes: null
+agent_model: null
+files_modified: []
+files_created: []
+tests_added: 0
+tests_passing: 0
+notes: ""
+blockers_encountered: []
+ready_for_review: false
+```