Description
The schema-consistency audit (#44217, 2026-07-08) found engine.driver schema/docs are narrower than the implementation. The main schema (pkg/parser/schemas/main_workflow_schema.json:12415-12420) and frontmatter-full.md:2323-2329 describe engine.driver as Pi-oriented and JS-only (.js/.cjs/.mjs), but the runtime (pkg/workflow/engine.go:61, parsing at engine.go:437-441) supports .js, .cjs, .mjs, .py, .ts, .mts, .rb, or a bare command name — and engines.md:345-365,399 already documents Copilot SDK/TS driver usage.
Broaden the schema description/pattern/examples and the frontmatter-full.md text so valid runtime-supported driver configs are not rejected or discouraged by validation/docs.
Expected Impact
Stops schema validation and docs from rejecting/discouraging configurations the runtime explicitly supports (Copilot SDK, non-JS drivers).
Suggested Agent
Schema Consistency agent.
Estimated Effort
Quick (< 1 hour)
Data Source
DeepReport 2026-07-08 · schema-consistency report #44217 (finding #3)
Generated by 🔬 Deep Report · 301.4 AIC · ⌖ 10.9 AIC · ⊞ 10K · ◷
Description
The schema-consistency audit (#44217, 2026-07-08) found
engine.driverschema/docs are narrower than the implementation. The main schema (pkg/parser/schemas/main_workflow_schema.json:12415-12420) andfrontmatter-full.md:2323-2329describeengine.driveras Pi-oriented and JS-only (.js/.cjs/.mjs), but the runtime (pkg/workflow/engine.go:61, parsing atengine.go:437-441) supports.js,.cjs,.mjs,.py,.ts,.mts,.rb, or a bare command name — andengines.md:345-365,399already documents Copilot SDK/TS driver usage.Broaden the schema description/pattern/examples and the frontmatter-full.md text so valid runtime-supported driver configs are not rejected or discouraged by validation/docs.
Expected Impact
Stops schema validation and docs from rejecting/discouraging configurations the runtime explicitly supports (Copilot SDK, non-JS drivers).
Suggested Agent
Schema Consistency agent.
Estimated Effort
Quick (< 1 hour)
Data Source
DeepReport 2026-07-08 · schema-consistency report #44217 (finding #3)