[Schema Consistency] 🔍 Schema Consistency Check - 2026-07-01

[github-actions[bot]]

Summary

• Inconsistencies Found: 4
• Categories Analyzed: Schema, Parser, Documentation, Workflows
• Strategy Used: Engine sub-object key coverage + alias/documentation verification
• New Strategy: No

Critical Issues

1. Engine catalog drift: antigravity is implemented and used, but the main engine schema text still omits it

   • Schema: $defs.engine_config.oneOf[1].properties.id.description lists built-ins as claude, codex, copilot, gemini, opencode, crush, pi.
   • Parser/runtime: pkg/workflow/agentic_engine.go:485 registers NewAntigravityEngine().
   • Workflows: .github/workflows/smoke-antigravity.md:37 uses engine.id: antigravity.
   • Impact: schema-generated docs understate supported engines, so users may think a valid engine is unsupported.

2. Docs advertise engine.copilot-sdk-driver, but parser reads engine.driver and schema does not declare the documented alias

   • Docs: docs/src/content/docs/reference/engines.md:325,332,380 and docs/src/content/docs/reference/frontmatter-full.md:2329 document copilot-sdk-driver.
   • Parser: pkg/workflow/engine.go:409 reads engineObj["driver"]; no matching engineObj["copilot-sdk-driver"] lookup exists.
   • Schema: $defs.engine_config.oneOf[1].properties contains driver but not copilot-sdk-driver.
   • Impact: documented examples are not schema-valid and appear not to match the parser entrypoint, creating a likely user-facing compile/validation failure.

Documentation Gaps

3. dispatch_repository is still surfaced in generated frontmatter reference even though parser marks it deprecated

   • Parser: pkg/workflow/dispatch_repository.go:36-41 makes dispatch-repository canonical and warns that dispatch_repository is deprecated.
   • Reference doc: docs/src/content/docs/reference/frontmatter-full.md:7497 still presents dispatch_repository: in the frontmatter reference block.
   • Other docs: docs/src/content/docs/reference/safe-outputs.md:1343+ consistently use dispatch-repository.
   • Impact: users copying from frontmatter-full are steered toward a deprecated alias while other docs and warnings push the opposite direction.

4. Top-level frontmatter guide is less complete than actual engine support/docs for engine-specific keys

   • Frontmatter guide: docs/src/content/docs/reference/frontmatter.md only says “See AI Engines for details” and does not expose high-signal engine subkeys.
   • Engine docs/runtime: engine.extensions is implemented in pkg/workflow/engine.go:509-529 and documented in docs/src/content/docs/reference/engines.md:422-435.
   • Impact: users consulting the main frontmatter guide do not discover valid engine subkeys that are available in runtime and specialized docs.

Workflow Violations

• No repository workflow violation requiring source edits was found in the sampled workflows.
• The notable workflow-side evidence is positive support evidence: .github/workflows/smoke-antigravity.md proves antigravity is real runtime surface, which conflicts with the schema description/catalog wording.

Recommendations

1. Update the engine schema descriptions/examples to include antigravity wherever built-in engine lists are enumerated.
2. Resolve the copilot-sdk-driver drift by either:
   • adding copilot-sdk-driver as an explicit schema/parser alias, or
   • removing/rewriting docs and generated frontmatter examples to use engine.driver only.
3. Regenerate/fix frontmatter-full.md so dispatch-repository is the primary surfaced key and dispatch_repository is labeled deprecated if retained.
4. Add a compact engine-subkeys summary or pointers in frontmatter.md for discoverability (driver, extensions, copilot-sdk, etc.).

Strategy Performance

• Strategy Used: Engine sub-object key coverage (schema vs parser vs docs) + alias verification
• Findings: 4
• Effectiveness: High
• Should Reuse: Yes

Next Steps

• Fix engine schema descriptions/examples
• Align parser/schema/docs for Copilot custom driver key naming
• Regenerate frontmatter reference for dispatch-repository naming
• Improve main frontmatter guide cross-linking/discoverability

Generated by ✅ Schema Consistency Checker · 25.9 AIC · ⌖ 24 AIC · ⊞ 7.4K · ◷

• expires on Jul 1, 2026, 10:55 PM UTC-08:00

[github-actions[bot]]

This discussion was automatically closed because it expired on 2026-07-02T06:55:38.159Z.

Closed by Workflow