Skip to content

[deep-report] Reconcile schema/parser/compiler drift: tools.serena (x-removed but accepted) and engine.bare (docs claim ✅, compiler warns [Content truncated due to length] #33081

Description

@github-actions

Context

The Schema Consistency Audit (#32969, prior version #32772) caught two persistent drifts where the JSON Schema, the Go parser, and the docs disagree:

1. tools.serena — schema removed, parser still accepts

  • Schema declares x-removed: true
  • Parser still treats it as a built-in MCP tool with explicit handling at pkg/parser/mcp.go:186, 214, 425
  • Result: IDE schema integration shows REMOVED, runtime silently accepts → confusing UX for any workflow that imports tools.serena

2. engine.bare for Codex / Gemini

  • Docs feature matrix says ✅ supported
  • Schema description says supported
  • Compiler at pkg/workflow/agent_validation.go:229 emits a warning and ignores the field
  • Result: three sources disagree; users who follow the docs hit silent failure

Why it matters

  • Schema-vs-parser drift erodes trust in the IDE schema integration — the primary onboarding surface for non-Copilot users
  • Both items have been flagged in at least two daily reports and not fixed
  • Either fix direction (re-enable or fully remove) is local and small

Proposed approach

For tools.serena — pick one:

  • (a) Remove the parser handling at pkg/parser/mcp.go:186, 214, 425 so workflows fail loudly at compile, or
  • (b) Drop x-removed: true from the schema and keep the parser as-is

For engine.bare (Codex/Gemini) — pick one:

  • (a) Make agent_validation.go:229 actually honor the flag for Codex and Gemini (matches docs), or
  • (b) Update docs feature matrix and schema to mark it as ❌ for those engines (matches compiler)

Suggested agent

Schema Consistency Audit agent (familiar with all three surfaces) or a focused Go-refactor agent.

Estimated effort

Small: one-decision-per-item, small code/docs edits, run schema validation tests.

Source

Schema Consistency Audit #32969; DeepReport 2026-05-17 #32887.

Generated by 🔬 DeepReport - Intelligence Gathering Agent · ● 19.5M ·

  • expires on May 20, 2026, 4:10 PM UTC

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions