Skip to content

[doc-healer] DDUw improvement - stop re-processing rejected antigravity engine-catalog direction #47159

Description

@github-actions

DDUw keeps re-processing the 3x-rejected antigravity engine-catalog direction

The Daily Documentation Healer re-encountered the recurring antigravity engine catalog drift again this run. It remains a rejected fix direction, yet drift detectors keep re-filing it and each DDUw/healer cycle re-derives the same rejected conclusion.

Evidence (verified on main, 2026-07-22)

$ grep -ci antigravity docs/src/content/docs/reference/engines.md
0
$ grep -c antigravity pkg/parser/schemas/main_workflow_schema.json
0
$ grep -n 'NewAntigravityEngine' pkg/workflow/agentic_engine.go
500:		NewAntigravityEngine(),

The engine is registered and used in production (.github/workflows/smoke-antigravity.md sets engine.id: antigravity) but intentionally kept out of the reference/schema. Nothing in code records this exclusion, so detectors keep flagging it.

Root cause

DDUw (.github/workflows/daily-doc-updater.md:164) handles not_planned issues by cross-referencing against recent commits, but it has no memory of a rejected fix direction. It cannot tell that "add antigravity to engines.md/schema" was already rejected 3x, so it re-investigates every duplicate re-filing.

Proposed fixes

1. Land the inverse code fix from #45017 (stops the re-filing at the source).

  • Add an undocumented (or hidden) boolean to the engine base config, default false, set true in NewAntigravityEngine() (pkg/workflow/antigravity_engine.go).
  • Teach the DeepReport / schema-consistency drift checks (which compare registered engines vs engines listed in engines.md / main_workflow_schema.json) to skip engines where undocumented == true.
  • No engines.md / schema edit required — the exclusion becomes documented, enforced intent.

2. Give DDUw a rejected-direction skip list. Add a step to daily-doc-updater.md that, before acting on a documentation issue, checks a persisted list of rejected drift signatures (e.g. antigravity + engines.md/schema). If matched, skip and do not re-file — mirroring the healer's site-build-ui-issues cache pattern.

Decision needed

@pelikhan — this direction has been rejected at least 3 times but keeps being re-filed (currently open: #47014). Please either (A) approve fix #1 (mark antigravity undocumented in code so detectors stop flagging), or (B) confirm the exclusion is permanent so we can encode a hard skip. Without a durable record, DDUw and the detectors will keep re-filing indefinitely.

Related

Generated by 📝 Daily Documentation Healer · sonnet46 293.5 AIC · ⌖ 35.9 AIC · ⊞ 8K ·

  • expires on Jul 24, 2026, 4:07 PM UTC-08:00

Activity

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

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions