This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow-steward.git
The following commit(s) were added to refs/heads/main by this push:
new 249d342 default plan, update and consolidate to 1 pass (#328)
249d342 is described below
commit 249d342ebc201fdeadf70b9acf8f7551ceddb480
Author: Justin Mclean <[email protected]>
AuthorDate: Thu May 28 09:19:08 2026 +1000
default plan, update and consolidate to 1 pass (#328)
---
tools/spec-loop/README.md | 6 +++---
tools/spec-loop/loop.sh | 12 ++++++------
2 files changed, 9 insertions(+), 9 deletions(-)
diff --git a/tools/spec-loop/README.md b/tools/spec-loop/README.md
index 9d8fc67..defb82f 100644
--- a/tools/spec-loop/README.md
+++ b/tools/spec-loop/README.md
@@ -27,9 +27,9 @@ this is the operator quickstart.
```bash
./tools/spec-loop/loop.sh # build, unlimited iterations
./tools/spec-loop/loop.sh 10 # build, max 10 iterations
-./tools/spec-loop/loop.sh plan # gap-analysis → rewrite the plan (no
code changes)
-./tools/spec-loop/loop.sh update # back-fill specs from functionality
others contributed
-./tools/spec-loop/loop.sh consolidate # shrink the plan when it grows too long
+./tools/spec-loop/loop.sh plan # gap-analysis → rewrite the plan (no
code changes; 1 pass, add N for more)
+./tools/spec-loop/loop.sh update # back-fill specs from functionality
others contributed (1 pass, add N for more)
+./tools/spec-loop/loop.sh consolidate # shrink the plan when it grows too
long (1 pass, add N for more)
```
- **plan** — compares `specs/` against the code and rewrites
diff --git a/tools/spec-loop/loop.sh b/tools/spec-loop/loop.sh
index ad96164..c5b22c2 100755
--- a/tools/spec-loop/loop.sh
+++ b/tools/spec-loop/loop.sh
@@ -10,9 +10,9 @@
# * THREE modes, ONE mechanism:
# ./loop.sh build, unlimited iterations
# ./loop.sh 20 build, max 20 iterations
-# ./loop.sh plan [N] gap-analysis only (updates the plan)
-# ./loop.sh update [N] back-fill specs from code others contributed
-# ./loop.sh consolidate [N] shrink the plan
+# ./loop.sh plan [N] gap-analysis only, updates the plan (default
1 pass; N=0 unlimited)
+# ./loop.sh update [N] back-fill specs from code others contributed
(default 1 pass; N=0 unlimited)
+# ./loop.sh consolidate [N] shrink the plan (default 1 pass; N=0
unlimited)
# * BRANCH PER WORK ITEM: before each build iteration the loop returns
# to the integration base; the build prompt then carves out
# <slug> for the one work item it implements. One work item =
@@ -93,11 +93,11 @@ PLAN_CONSOLIDATE_THRESHOLD="${SPEC_LOOP_PLAN_MAX:-500}"
# ---- parse arguments -------------------------------------------------
if [ "${1:-}" = "plan" ]; then
- MODE="plan"; PROMPT_FILE="$LOOP_DIR/PROMPT_plan.md";
MAX_ITERATIONS="${2:-0}"
+ MODE="plan"; PROMPT_FILE="$LOOP_DIR/PROMPT_plan.md";
MAX_ITERATIONS="${2:-1}"
elif [ "${1:-}" = "update" ]; then
- MODE="update"; PROMPT_FILE="$LOOP_DIR/PROMPT_update.md";
MAX_ITERATIONS="${2:-0}"
+ MODE="update"; PROMPT_FILE="$LOOP_DIR/PROMPT_update.md";
MAX_ITERATIONS="${2:-1}"
elif [ "${1:-}" = "consolidate" ]; then
- MODE="consolidate"; PROMPT_FILE="$LOOP_DIR/PROMPT_consolidate.md";
MAX_ITERATIONS="${2:-0}"
+ MODE="consolidate"; PROMPT_FILE="$LOOP_DIR/PROMPT_consolidate.md";
MAX_ITERATIONS="${2:-1}"
elif [[ "${1:-}" =~ ^[0-9]+$ ]]; then
MODE="build"; PROMPT_FILE="$LOOP_DIR/PROMPT_build.md";
MAX_ITERATIONS="$1"
else
