@pennyfarthing/core 7.0.2 → 7.4.0

package/packages/core/dist/workflow/workflow-schema.js

@@ -1,230 +0,0 @@
-/**
- * Workflow Schema Validation
- *
- * Defines types and validation for workflow definitions.
- * See pennyfarthing-dist/guides/workflow-schema.md for spec.
- */
-/**
- * Validates a workflow definition object
- *
- * @param input - Raw workflow object (e.g., parsed from YAML)
- * @returns Validation result with parsed workflow or errors
- *
- * @example
- * ```typescript
- * const yaml = fs.readFileSync('workflow.yaml', 'utf-8');
- * const parsed = YAML.parse(yaml);
- * const result = validateWorkflow(parsed);
- *
- * if (result.valid) {
- *   console.log(`Workflow "${result.workflow.name}" is valid`);
- * } else {
- *   console.error('Validation errors:', result.errors);
- * }
- * ```
- */
-export function validateWorkflow(input) {
-    const errors = [];
-    // Check input is an object
-    if (!input || typeof input !== 'object') {
-        return {
-            valid: false,
-            errors: [{ field: 'workflow', message: 'Input must be an object' }]
-        };
-    }
-    const inputObj = input;
-    // Check for root 'workflow' key
-    if (!('workflow' in inputObj) || !inputObj.workflow || typeof inputObj.workflow !== 'object') {
-        return {
-            valid: false,
-            errors: [{ field: 'workflow', message: 'Missing required root "workflow" key' }]
-        };
-    }
-    const workflowObj = inputObj.workflow;
-    // Validate workflow.name (required, string)
-    if (!('name' in workflowObj) || workflowObj.name === undefined || workflowObj.name === null) {
-        errors.push({ field: 'workflow.name', message: 'Name is required' });
-    }
-    else if (typeof workflowObj.name !== 'string') {
-        errors.push({ field: 'workflow.name', message: 'Name must be a string' });
-    }
-    // Validate workflow.phases (required, array with at least one phase)
-    if (!('phases' in workflowObj) || workflowObj.phases === undefined) {
-        errors.push({ field: 'workflow.phases', message: 'Phases is required' });
-    }
-    else if (!Array.isArray(workflowObj.phases)) {
-        errors.push({ field: 'workflow.phases', message: 'Phases must be an array' });
-    }
-    else if (workflowObj.phases.length === 0) {
-        errors.push({ field: 'workflow.phases', message: 'Workflow must have at least one phase' });
-    }
-    else {
-        // Validate each phase
-        const phases = workflowObj.phases;
-        phases.forEach((phase, index) => {
-            if (!phase || typeof phase !== 'object') {
-                errors.push({ field: `workflow.phases[${index}]`, message: 'Phase must be an object' });
-                return;
-            }
-            const phaseObj = phase;
-            // Phase name (required)
-            if (!('name' in phaseObj) || phaseObj.name === undefined || phaseObj.name === null) {
-                errors.push({ field: `workflow.phases[${index}].name`, message: 'Phase name is required' });
-            }
-            else if (typeof phaseObj.name !== 'string') {
-                errors.push({ field: `workflow.phases[${index}].name`, message: 'Phase name must be a string' });
-            }
-            // Phase agent (required)
-            if (!('agent' in phaseObj) || phaseObj.agent === undefined || phaseObj.agent === null) {
-                errors.push({ field: `workflow.phases[${index}].agent`, message: 'Phase agent is required' });
-            }
-            else if (typeof phaseObj.agent !== 'string') {
-                errors.push({ field: `workflow.phases[${index}].agent`, message: 'Phase agent must be a string' });
-            }
-            // Phase gate (optional, but if present must have type)
-            if ('gate' in phaseObj && phaseObj.gate !== undefined) {
-                if (!phaseObj.gate || typeof phaseObj.gate !== 'object') {
-                    errors.push({ field: `workflow.phases[${index}].gate`, message: 'Gate must be an object' });
-                }
-                else {
-                    const gateObj = phaseObj.gate;
-                    if (!('type' in gateObj) || gateObj.type === undefined || gateObj.type === null) {
-                        errors.push({ field: `workflow.phases[${index}].gate.type`, message: 'Gate type is required' });
-                    }
-                    else if (typeof gateObj.type !== 'string') {
-                        errors.push({ field: `workflow.phases[${index}].gate.type`, message: 'Gate type must be a string' });
-                    }
-                }
-            }
-            // Phase input (optional, array of strings)
-            if ('input' in phaseObj && phaseObj.input !== undefined) {
-                if (!Array.isArray(phaseObj.input)) {
-                    errors.push({ field: `workflow.phases[${index}].input`, message: 'Input must be an array' });
-                }
-            }
-            // Phase output (optional, array of strings)
-            if ('output' in phaseObj && phaseObj.output !== undefined) {
-                if (!Array.isArray(phaseObj.output)) {
-                    errors.push({ field: `workflow.phases[${index}].output`, message: 'Output must be an array' });
-                }
-            }
-        });
-    }
-    // Validate triggers (optional)
-    if ('triggers' in workflowObj && workflowObj.triggers !== undefined) {
-        if (!workflowObj.triggers || typeof workflowObj.triggers !== 'object') {
-            errors.push({ field: 'workflow.triggers', message: 'Triggers must be an object' });
-        }
-        else {
-            const triggersObj = workflowObj.triggers;
-            // tags (optional, array)
-            if ('tags' in triggersObj && triggersObj.tags !== undefined) {
-                if (!Array.isArray(triggersObj.tags)) {
-                    errors.push({ field: 'workflow.triggers.tags', message: 'Tags must be an array' });
-                }
-            }
-            // types (optional, array)
-            if ('types' in triggersObj && triggersObj.types !== undefined) {
-                if (!Array.isArray(triggersObj.types)) {
-                    errors.push({ field: 'workflow.triggers.types', message: 'Types must be an array' });
-                }
-            }
-            // points (optional, object with min/max)
-            if ('points' in triggersObj && triggersObj.points !== undefined) {
-                if (!triggersObj.points || typeof triggersObj.points !== 'object') {
-                    errors.push({ field: 'workflow.triggers.points', message: 'Points must be an object' });
-                }
-                else {
-                    const pointsObj = triggersObj.points;
-                    // min (optional, number)
-                    if ('min' in pointsObj && pointsObj.min !== undefined) {
-                        if (typeof pointsObj.min !== 'number') {
-                            errors.push({ field: 'workflow.triggers.points.min', message: 'Points min must be a number' });
-                        }
-                    }
-                    // max (optional, number)
-                    if ('max' in pointsObj && pointsObj.max !== undefined) {
-                        if (typeof pointsObj.max !== 'number') {
-                            errors.push({ field: 'workflow.triggers.points.max', message: 'Points max must be a number' });
-                        }
-                    }
-                    // Validate min <= max if both present and valid numbers
-                    if ('min' in pointsObj && 'max' in pointsObj &&
-                        typeof pointsObj.min === 'number' && typeof pointsObj.max === 'number' &&
-                        pointsObj.min > pointsObj.max) {
-                        errors.push({ field: 'workflow.triggers.points', message: 'Points min cannot be greater than max' });
-                    }
-                }
-            }
-            // default (optional, boolean)
-            if ('default' in triggersObj && triggersObj.default !== undefined) {
-                if (typeof triggersObj.default !== 'boolean') {
-                    errors.push({ field: 'workflow.triggers.default', message: 'Default must be a boolean' });
-                }
-            }
-        }
-    }
-    // If there are errors, return invalid result
-    if (errors.length > 0) {
-        return { valid: false, errors };
-    }
-    // Build the validated workflow object
-    const phases = workflowObj.phases.map((phase) => {
-        const result = {
-            name: phase.name,
-            agent: phase.agent
-        };
-        if (phase.input !== undefined) {
-            result.input = phase.input;
-        }
-        if (phase.output !== undefined) {
-            result.output = phase.output;
-        }
-        if (phase.gate !== undefined) {
-            const gateObj = phase.gate;
-            result.gate = {
-                type: gateObj.type
-            };
-            if (gateObj.condition !== undefined) {
-                result.gate.condition = gateObj.condition;
-            }
-        }
-        return result;
-    });
-    const workflow = {
-        name: workflowObj.name,
-        phases
-    };
-    if (workflowObj.description !== undefined) {
-        workflow.description = workflowObj.description;
-    }
-    if (workflowObj.version !== undefined) {
-        workflow.version = workflowObj.version;
-    }
-    if (workflowObj.triggers !== undefined) {
-        const triggersObj = workflowObj.triggers;
-        const triggers = {};
-        if (triggersObj.tags !== undefined) {
-            triggers.tags = triggersObj.tags;
-        }
-        if (triggersObj.types !== undefined) {
-            triggers.types = triggersObj.types;
-        }
-        if (triggersObj.points !== undefined) {
-            const pointsObj = triggersObj.points;
-            triggers.points = {};
-            if (pointsObj.min !== undefined) {
-                triggers.points.min = pointsObj.min;
-            }
-            if (pointsObj.max !== undefined) {
-                triggers.points.max = pointsObj.max;
-            }
-        }
-        if (triggersObj.default !== undefined) {
-            triggers.default = triggersObj.default;
-        }
-        workflow.triggers = triggers;
-    }
-    return { valid: true, workflow };
-}
-//# sourceMappingURL=workflow-schema.js.map

package/packages/core/dist/workflow/workflow-schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-schema.js","sourceRoot":"","sources":["../../src/workflow/workflow-schema.ts"],"names":[],"mappings":"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"}

package/pennyfarthing-dist/agents/README.md

@@ -1,411 +0,0 @@
-# Pennyfarthing Core Agents
-
-## Overview
-
-This directory contains the **single source of truth** for all Pennyfarthing agent definitions. Agents are coordinated across both `API` and `UI` repositories.
-
-**See:** `../ AGENT-COORDINATION.md` for complete architecture documentation.
-
-## Agent Maturity
-
-Agents are marked with `<status>` tags indicating their maturity level:
-
-### Production Agents
-These agents follow the TDD workflow and are battle-tested:
-- **SM** - Scrum Master (story coordination, session management)
-- **TEA** - Test Engineer/Architect (test writing, TDD guidance)
-- **Dev** - Developer (implementation, making tests pass)
-- **Reviewer** - Code Reviewer (adversarial review, quality gates)
-
-### Experimental Agents
-These agents are available but not yet modernized to the same standard:
-- **Orchestrator** - Meta operations, process improvement
-- **PM** - Product Manager (planning, prioritization)
-- **Architect** - System Architect (design decisions)
-- **DevOps** - DevOps Engineer (infrastructure, deployment)
-- **Tech Writer** - Technical Writer (documentation)
-- **UX Designer** - UX Designer (UI design, accessibility)
-
-> **Tip:** Start with production agents for core development work. Experimental agents may have less consistent behavior or missing features.
-
-## Agent Hierarchy
-
-### Strategic Agents (Full Scope)
-Oversee both repos, make cross-repo decisions, coordinate work.
-
-- **`orchestrator.md`** - Master orchestrator
-- **`pm.md`** - Product Manager (planning, prioritization)
-- **`sm.md`** - Scrum Master (story creation, technical specs)
-- **`architect.md`** - System Architect (design decisions, patterns)
-- **`devops.md`** - DevOps Engineer (infrastructure, deployment)
-
-### Tactical Agents (Story-Scoped)
-Focus on specific repo(s), implement/test/document features.
-
-- **`dev.md`** - Developer (feature implementation)
-- **`tea.md`** - Test Engineer/Architect (testing, quality)
-- **`reviewer.md`** - Code Reviewer (adversarial review, quality gates)
-- **`tech-writer.md`** - Technical Writer (documentation)
-- **`ux-designer.md`** - UX Designer (UI design, UX)
-
-### Official Subagents (Haiku-based)
-Lightweight subagents for mechanical tasks. Invoked via `Task tool` with `subagent_type: "general-purpose"` and `model: "haiku"`.
-
-**Invocation pattern:**
-```yaml
-Task tool:
-  subagent_type: "general-purpose"
-  model: "haiku"
-  prompt: |
-    Read and follow: .pennyfarthing/agents/{subagent-name}.md
-
-    {PARAMETERS}
-```
-
-- **`workflow-status-check.md`** - Detect workflow state
-- **`generic-sm-setup.md`** - Research OR setup mode (Story 31-11)
-- **`generic-sm-finish.md`** - Preflight OR execute phase (Story 31-11)
-- **`generic-handoff.md`** - Workflow-driven handoff (Stories 31-7, 31-10)
-- **`sm-handoff.md`** - SM→TEA/Dev handoff with Jira/branch verification
-- **`sm-file-summary.md`** - Summarize file changes
-- **`reviewer-preflight.md`** - Gather review data
-- **`testing-runner.md`** - Execute tests, report results
-
-### Removed Files (Stories 31-11, 31-12)
-These files have been deleted and replaced by consolidated versions:
-
-**SM Subagents (Story 31-12):**
-- `sm-work-research.md` → use `generic-sm-setup` with MODE=research
-- `sm-story-setup.md` → use `generic-sm-setup` with MODE=setup
-- `sm-finish-bookkeeping.md` → use `generic-sm-finish` with PHASE=preflight
-- `sm-finish-execution.md` → use `generic-sm-finish` with PHASE=execute
-
-**Handoff Subagents (Story 31-11):**
-- `tea-handoff.md` → use `generic-handoff` with CURRENT_PHASE=red
-- `dev-handoff.md` → use `generic-handoff` with CURRENT_PHASE=green
-- `reviewer-handoff-approve.md` → use `generic-handoff` with VERDICT=approved
-- `reviewer-handoff-reject.md` → use `generic-handoff` with VERDICT=rejected
-
-## Context Loading
-
-Agents load context based on their type:
-
-### Strategic Agents Load:
-- Full sprint status
-- Both API and UI contexts
-- Epic definitions
-- Active work
-
-### Tactical Agents Load:
-- Story section of sprint status
-- Active work
-- Target repo context only (based on story)
-
-**Configuration:** `.claude/project/docs/agent-scopes.yaml`
-
-## Usage
-
-### Activate an Agent
-
-```bash
-# Via workflow
-@/pm
-@/dev
-@/tea
-
-# Or mention in chat
-"Let's activate the PM agent"
-"Activate Dev to implement this story"
-```
-
-### Agent Files
-
-Each agent file contains:
-- **Persona:** Character and expertise
-- **Responsibilities:** What they handle
-- **Context:** Project information
-- **Context Loading:** What files to load on activation
-- **Activation:** How they operate
-- **Workflows:** Common tasks and patterns
-- **Handoffs:** How they coordinate with other agents
-
-## File Structure
-
-```
-.pennyfarthing/agents/
-├── README.md                  # This file
-│
-│ # Main Agents (10)
-├── orchestrator.md            # Master orchestrator
-├── pm.md                      # Product Manager
-├── sm.md                      # Scrum Master
-├── architect.md               # System Architect
-├── devops.md                  # DevOps Engineer
-├── dev.md                     # Developer
-├── tea.md                     # Test Engineer
-├── reviewer.md                # Code Reviewer
-├── tech-writer.md             # Technical Writer
-├── ux-designer.md             # UX Designer
-│
-│ # Official Subagents (8 active)
-├── workflow-status-check.md   # Detect workflow state
-├── generic-sm-setup.md        # Research or setup mode (Story 31-11)
-├── generic-sm-finish.md       # Preflight or execute (Story 31-11)
-├── generic-handoff.md         # Workflow-driven handoff (Stories 31-7, 31-10)
-├── sm-handoff.md              # SM→TEA/Dev handoff with Jira/branch
-├── sm-file-summary.md         # Summarize files
-├── reviewer-preflight.md      # Review prep
-└── testing-runner.md          # Run tests
-```
-
-## Context Budget
-
-Each agent is designed to work within **~500-800 line context budget**:
-
-### Strategic Agent Budget
-- Agent file: ~200-300 lines
-- Sprint status: ~100-150 lines
-- Repo contexts: ~60 lines
-- Epics/docs: ~100 lines
-- Active work: ~50 lines
-- **Total:** ~500-660 lines
-
-### Tactical Agent Budget
-- Agent file: ~250-400 lines
-- Sprint status (story): ~50 lines
-- Active work: ~50 lines
-- Target repo context: ~100 lines
-- **Total:** ~450-600 lines
-
-## Agent Coordination
-
-### TDD Flow Handoffs
-
-```
-SM → TEA:      Story selected, write failing tests
-TEA → Dev:     Tests written (RED), make them pass
-Dev → Reviewer: Implementation done, review PR
-Reviewer → SM: Story approved, finish it
-Reviewer → Dev: Issues found, fix needed
-```
-
-### Strategic → Tactical Handoffs
-
-```
-PM → SM:     Epic needs stories
-SM → TEA:    Story ready for tests
-TEA → Dev:   Tests ready for implementation
-Dev → Reviewer: PR ready for review
-```
-
-### Strategic ↔ Strategic Coordination
-
-```
-PM ↔ Architect:  Need design decisions
-PM ↔ SM:         Story prioritization
-SM ↔ Architect:  Technical approach
-```
-
-### Tactical → Strategic Feedback
-
-```
-Dev → SM:         Story blocked or needs clarification
-TEA → SM:         Test coverage gaps identified
-Reviewer → SM:    Code quality concerns
-Tech Writer → SM: Documentation needs
-```
-
-## Creating New Agents
-
-To add a new agent:
-
-1. Create `.pennyfarthing/agents/[name].md`
-2. Follow existing agent structure
-3. Add to `../agent-scopes.yaml`
-4. Update this README
-5. Create command in `.claude/commands/[name].md`
-
-### Agent Template Structure
-
-```markdown
-# [Agent Name] Agent - [Role]
-
-## Persona
-[Character description and expertise]
-
-## Responsibilities
-[What they handle]
-
-## Context
-[Project information]
-
-## Context Loading
-[What files to load on activation]
-
-## Activation
-[How they operate]
-
-## Key Workflows
-[Common tasks]
-
-## Handoffs
-[Coordination with other agents]
-
-## Activation Command
-[@/agent-name]
-
-## Exit
-[How to exit agent mode]
-```
-
-## Benefits
-
-✅ **Single Source of Truth** - All agents in one place
-✅ **Coordinated Planning** - Strategic agents see full scope
-✅ **Focused Implementation** - Tactical agents load only what they need
-✅ **Clear Hierarchy** - Strategic coordinate, tactical execute
-✅ **Scalable** - Easy to add new agents
-
-## Path Standards
-
-**IMPORTANT:** All agent commands use `$CLAUDE_PROJECT_DIR` for path references.
-
-### Standard Pattern
-```bash
-# ✅ CORRECT - Use $CLAUDE_PROJECT_DIR
-$CLAUDE_PROJECT_DIR/scripts/agent-session.sh start "Agent Name"
-$CLAUDE_PROJECT_DIR/.session/{STORY_ID}-session.md
-
-# ❌ WRONG - Don't use git rev-parse (unreliable in agent context)
-$(git rev-parse --show-toplevel)/scripts/agent-session.sh
-
-# ❌ WRONG - Don't hardcode absolute paths
-/Users/someone/project/scripts/agent-session.sh
-```
-
-### Why $CLAUDE_PROJECT_DIR?
-- `$(git rev-parse --show-toplevel)` doesn't work reliably in agent context
-- Hardcoded paths break on different machines
-- `$CLAUDE_PROJECT_DIR` is set by the environment and works consistently
-
-### Usage in Agent Commands
-All agent commands in `.claude/commands/` have been standardized to use `$CLAUDE_PROJECT_DIR`:
-- Agent session registration
-- Script execution
-- File path references
-
-## Background Subagent Execution
-
-Subagents can run in background using Claude Code's `run_in_background` parameter. This allows the main agent to continue working while slow operations complete asynchronously.
-
-### When to Use Background Execution
-
-**Good candidates:**
-- Test runs (via `testing-runner`) while writing more code
-- Multiple independent file searches
-- Long-running git operations (fetch, clone)
-- Parallel exploration of code paths
-
-**When NOT to use:**
-- Operations where subsequent work depends on the result
-- Operations that modify shared state (session file, git working tree)
-- Sequential workflows (must complete phase A before phase B)
-
-### Spawning Background Subagents
-
-```yaml
-Task tool:
-  subagent_type: "general-purpose"
-  model: "haiku"
-  run_in_background: true
-  prompt: |
-    Read and follow: .pennyfarthing/agents/testing-runner.md
-
-    REPOS: all
-    CONTEXT: Background test run while implementing
-    RUN_ID: bg-test-001
-```
-
-### Checking Background Task Status
-
-Use the `TaskOutput` tool to check on background tasks:
-
-```yaml
-TaskOutput tool:
-  task_id: {task_id from spawn}
-  block: false          # Non-blocking check
-  timeout: 1000         # Quick timeout for status check
-```
-
-**Status values:**
-- `running` - Task still executing
-- `completed` - Task finished, results available
-- `error` - Task failed
-
-### Tracking Background Tasks in Session Files
-
-Use the background task tracking utilities to manage session file entries:
-
-```bash
-source $CLAUDE_PROJECT_DIR/scripts/utils/background-tasks.sh
-SESSION_FILE="$CLAUDE_PROJECT_DIR/.session/${STORY_ID}-session.md"
-
-# After spawning, record the task:
-bg_task_add "$SESSION_FILE" "$TASK_ID" "testing-runner" "Background test run"
-
-# After checking TaskOutput, update status:
-bg_task_update "$SESSION_FILE" "$TASK_ID" "completed"  # or "error"
-
-# Clean up finished tasks:
-bg_task_cleanup "$SESSION_FILE"
-```
-
-**Available functions:**
-| Function | Purpose |
-|----------|---------|
-| `bg_task_add` | Record new background task |
-| `bg_task_update` | Update task status (running/completed/error) |
-| `bg_task_cleanup` | Remove completed and errored tasks |
-| `bg_task_list` | Show all running tasks |
-| `bg_task_check` | Return 0 if any tasks running |
-| `bg_task_summary` | Print counts by status |
-
-### Background Execution Constraints
-
-1. **No concurrent state mutation** - Don't have multiple background tasks writing to the same file
-2. **Independent operations only** - Each background task should be self-contained
-3. **Check before proceeding** - If you need the result, wait for it with `block: true`
-4. **Clean up tracking** - Use `bg_task_cleanup` after processing results
-
-### Example: Background Tests While Coding
-
-```bash
-# 1. Spawn testing-runner with run_in_background: true
-# 2. Record: bg_task_add "$SESSION_FILE" "$TASK_ID" "testing-runner" "Tests while coding"
-# 3. Continue writing code
-# 4. Periodically check TaskOutput with block: false
-# 5. When complete: bg_task_update "$SESSION_FILE" "$TASK_ID" "completed"
-# 6. Cleanup: bg_task_cleanup "$SESSION_FILE"
-# 7. If RED: stop and fix
-# 8. If GREEN: continue with confidence
-```
-
-## Quick Reference
-
-```bash
-# View agent scope configuration
-cat .claude/project/docs/agent-scopes.yaml
-
-# List all agents
-ls .pennyfarthing/agents/
-
-# View agent definition
-cat .pennyfarthing/agents/pm.md
-
-# Activate agent
-@/pm
-```
-
----
-
-**Your coordinated Pennyfarthing agent system is ready!**