fix: Planner agent schema validation infrastructure failure

[ashleyshaw]

---

file_type: "issue"
issue_type: "bug"
area: "automation"
priority: "critical"
component: "workflows"
status: "needs-triage"

Build/CI Summary

The planner GitHub Actions workflow fails during schema validation with an infrastructure error. This is a pre-existing issue blocking all PRs regardless of planner agent code quality.

Problem Statement

Planner schema validation setup issue — workflow cannot complete schema validation phase, causing check to fail on every PR run.

Impact:

• All PRs fail planner check
• Blocks merge gate
• Prevents planner agent functionality testing

Symptoms:

• Planner check fails in ~10 seconds
• Consistent failure across all PR commits
• No actionable error message (infrastructure error, not code error)

Steps / Checklist

• Review planner.yml workflow schema validation step
• Check if schema definition file exists and is valid
• Verify schema validation tool is properly configured
• Check planner agent schema requirements
• Test schema validation with sample agent invocation
• Verify workflow step configuration
• Check for missing dependencies or setup steps
• Update workflow error handling if needed
• Test with test PR to verify fix

Acceptance Criteria

• Planner workflow schema validation passes
• Check runs successfully on test PR
• No errors in workflow logs
• Planner agent functionality can be tested
• Error messages are clear and actionable
• Consistent behavior across multiple runs

Additional Context

Affected Workflows:

• .github/workflows/planner.yml
• All PRs (planner check gates merge)

Related Code:

• scripts/agents/planner.agent.js
• .github/workflows/planner.yml
• Agent schema validation setup

Related Issues:

• PR feat: Phase 2 - Planner Agent GitHub API Integration #634 (planner agent enhancements) blocked by this
• Issues fix: Test suite ESM/TextDecoder compatibility issue blocking all PRs #642, fix: Fixture validation test infrastructure failure blocking all PRs #644 (other infrastructure failures)

References

• GitHub Actions Workflow Syntax
• Planner Agent Spec
• Workflow Documentation
• CONTRIBUTING.md

---

Definition of Ready (DoR)

• Build/CI goal and scope defined
• Checklist prepared
• Estimate added

Definition of Done (DoD)

• All checklist and acceptance criteria completed
• Workflow logs show no validation errors
• Planner check passes consistently
• Approved by maintainer

[linear-code]

LS-821

[ashleyshaw]

✅ RESOLVED in PR #677 (commit 5670556)

The planner agent schema validation infrastructure failure was a downstream effect of issue #646 (TextDecoder ESM compatibility). Once the Jest setup file was properly configured with TextDecoder polyfills, the schema validation tests passed.

Current Status:

• All 56 test suites passing
• All 452 tests passing
• Planner workflow validation: operational
• Schema validation infrastructure: functional

---

Generated by Claude Code