Skip to main content

Module flows_add

Module flows_add 

Source
Expand description

keel flows add <entrypoint> — one-command durability designation (dx-spec §1 Level 2: “Durability, still config-only”).

Appends the entrypoint to [flows] entrypoints in keel.toml through the policy-diff engine (crate::diff), so the edit is surgical: user comments and formatting outside the touched key survive byte-for-byte, the [flows] table is created when absent, and the change is also emitted as an applyable unified diff + structured hunks (dx-spec §5, diffs as the lingua franca). Re-running with the same entrypoint is an exact no-op.

The one formatting caveat: the entrypoints array itself is re-rendered as a single-line array when appended to (the diff engine sets the whole value); everything outside that one line is untouched.

Ergonomics: the bare forms keel flows suggest prints are accepted — pipeline.ingest:main infers py:, jobs/nightly.ts#run infers ts: — and explicit py: / ts: / rs: refs pass through. The final ref is validated against the frozen entrypointRef grammar (contracts/policy.schema.json: ^(py|ts|rs):[^\s]+$) before anything is written.

Functions§

run
keel flows add <entrypoint> [--diff] for project.