Skip to content

docs: trigger.type continuous, and --strict on a retargeted overlay patch (forge-cli #734) - #157

Merged
fas89 merged 1 commit into
mainfrom
docs/continuous-trigger-strict-overlays
Oct 21, 2026
Merged

fas89 merged 1 commit into
mainfrom
docs/continuous-trigger-strict-overlays

Conversation

@fas89

@fas89 fas89 commented Oct 21, 2026

Copy link
Copy Markdown
Collaborator

Summary

Docs for forge-cli #734; merge after it:

  • trigger.type: continuous (schema 0.7.6 preview): a build its platform keeps running, which no scheduler starts, and which takes no other trigger.
  • --strict fails on an overlay patch that lands on another entry (overlay_patch_retargeted), in fluid validate --env (and workspace mode), fluid contract-validation --env and fluid test --env.

Every new statement is marked (unreleased, forge-cli #734). The generated reference/contract-0.7.6-preview.md is left alone; it is rebuilt from a released schema by scripts/gen_contract_reference.py.

Page Change
docs/concepts/builds-exposes-bindings.md A new Continuous builds: trigger.type: continuous section; the Flink section, the trigger.type list and "Fields that need fluidVersion 0.7.6" point to it.
docs/cli/validate.md "--env and environment overlays" shows the retargeted patch as a validation warning, with --strict, --quiet, JSON, workspace mode, overlay_entry_added and the bundle gap.
docs/cli/test.md, docs/cli/contract-validation.md --strict covers the overlay warning ("Environment overlay" row / category overlay); --engine soda does not read --strict.
docs/concepts/environments-and-overlays.md The overlay_patch_retargeted bullet says the commands now report it.
docs/reference/preview-fields.md One unreleased paragraph, in the same shape as the engine: flink one.
docs/advanced/airflow.md, docs/walkthrough/airflow-declarative.md, docs/cli/generate-artifacts.md A continuous build gets no fluid apply DAG.

Output blocks are copied from the CLI on the #734 branch.

Checks (local)

  • scripts/check_cli_docs.py against the pinned CLI (data-product-forge 0.18.1): all six checks OK (1332 documented invocations, version sweep).
  • scripts/check_providers.py, scripts/gen_contract_reference.py --check: OK.
  • npm run docs:build, then node scripts/check-dist-links.mjs: clean (137,867 references, 242 pages); the two new anchors exist in the built HTML.

🤖 Generated with Claude Code

…atch (forge-cli #734)

builds-exposes-bindings.md gets a "Continuous builds: trigger.type:
continuous" section: the example, that no scheduler starts the build, the
refused trigger fields and their error, the 0.7.5 error, where the value
belongs (the dbt and python runners refuse it, scaffold-composer still
writes its nightly DAG), the overlay limitation and the stale-DAG note.
The Flink section, the trigger.type list and the 0.7.6 fields list point
to it, as do the Airflow pages that list the trigger types left out of
fluid apply DAGs.

validate.md's --env section shows overlay_patch_retargeted as a
validation warning that --strict fails on, with --quiet, JSON, workspace
mode, contract-validation, fluid test, overlay_entry_added and the bundle
gap; test.md, contract-validation.md, environments-and-overlays.md and
preview-fields.md point to it.

This branch was previously deployed

1 inactive deployment
github-pages — f04be205 Deployed Oct 21, 2026 by fas89 via deploy #205
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