Skip to content

docs(env): add DEEP_HEALTH_CHECK_ENABLED to .env.example - #14685

Closed
gonisulaimann wants to merge 1 commit into
diegosouzapw:release/v3.8.51from
gonisulaimann:docs/env-deep-health-check-contract
Closed

gonisulaimann wants to merge 1 commit into
diegosouzapw:release/v3.8.51from
gonisulaimann:docs/env-deep-health-check-contract

Conversation

@gonisulaimann

Copy link
Copy Markdown
Contributor

Why

npm run check:docs-all fails on the current release/v3.8.51 tip — the env-contract sync reports one var in code but missing from .env.example:

✗ In code but missing from .env.example: 1
   - DEEP_HEALTH_CHECK_ENABLED

The flag ships with #14236 (opt-in ?deep=1 completions sampling on /api/monitoring/health) but was never added to the env surface docs, and the sync gate reads both .env.example and docs/reference/ENVIRONMENT.md.

What

  • .env.example: document DEEP_HEALTH_CHECK_ENABLED (commented example, default off) next to the OMNIROUTE_HEALTHCHECK_PATH block it belongs with.
  • docs/reference/ENVIRONMENT.md: one matching row pointing at src/app/api/monitoring/health/route.ts and the ?deep=1 behavior.

No code change — the flag itself already behaves exactly as #14236 specified.

Verification

check result
npm run check:env-doc-sync fails on the tip, passes here (0 missing in any direction)
npm run check:docs-all fails on the tip, passes here (no fabricated refs)

Refs #14547 (docs-gates slice of the base-red).

The opt-in deep health check flag shipped in diegosouzapw#14236 but only ever existed
in code; check-env-doc-sync now fails on the release tip because the var
is referenced in src/app/api/monitoring/health/route.ts and absent from
.env.example. Document it next to the healthcheck-path block and mirror
the row in ENVIRONMENT.md (the sync check reads both).

Verified: npm run check:env-doc-sync and npm run check:docs-all pass on
this tree; both fail on the release tip without the change.
@gonisulaimann

Copy link
Copy Markdown
Contributor Author

Closing in favor of #14683, which covers the same DEEP_HEALTH_CHECK_ENABLED contract gap in both .env.example and docs/reference/ENVIRONMENT.md alongside the other release-quality repairs. No point carrying a duplicate.

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.

1 participant