Skip to content

Add undocumented marker to BaseEngine; record antigravity exclusion decision in code#42848

Closed
pelikhan with Copilot wants to merge 2 commits into
mainfrom
copilot/doc-healer-fix-antigravity-docs
Closed

Add undocumented marker to BaseEngine; record antigravity exclusion decision in code#42848
pelikhan with Copilot wants to merge 2 commits into
mainfrom
copilot/doc-healer-fix-antigravity-docs

Conversation

Copilot AI commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

The antigravity engine is registered and used in production but intentionally absent from engines.md — a docs PR (#42294) adding it was closed unmerged by a maintainer. Because nothing in code recorded this intent, drift detectors (DeepReport, schema-consistency, doc-healer) kept re-filing the same reconciliation issues each cycle.

Changes

  • Engine interface + BaseEngine — adds IsUndocumented() bool method (defaults false). New undocumented bool field on BaseEngine carries the exclusion intent.
  • EngineRegistry.GetDocumentedEngines() — new method returning sorted engine IDs where IsUndocumented() == false. Drift detectors should call this instead of GetSupportedEngines() when comparing against engines.md/schema.
  • NewAntigravityEngine() — sets undocumented: true with a comment referencing the closed PR decision.
  • TestsTestSpec_Engine_DocumentedEnginesRegistered no longer lists antigravity; new TestSpec_Engine_AntigravityIsUndocumented asserts the engine remains runtime-registered while GetDocumentedEngines() excludes it.
// Before: every registered engine appeared as a docs drift candidate
registry.GetSupportedEngines() // ["antigravity", "claude", "codex", ...]

// After: drift detectors use this instead
registry.GetDocumentedEngines() // ["claude", "codex", "copilot", "crush", "gemini", "opencode", "pi"]

// antigravity still works at runtime
registry.GetEngine("antigravity") // ok — undocumented ≠ unregistered

No engines.md or schema change — the exclusion is now the enforced expectation.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Record exclusion in code for antigravity engine in documents Add undocumented marker to BaseEngine; record antigravity exclusion decision in code Jul 2, 2026
Copilot AI requested a review from pelikhan July 2, 2026 00:28
@pelikhan pelikhan closed this Jul 2, 2026
@github-actions github-actions Bot mentioned this pull request Jul 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[doc-healer] Decision needed: antigravity engine docs-fix direction was rejected — record exclusion in code

2 participants