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]forproject.