@futurelastic/colab-handbook 1.12.0-rc.12 → 1.12.0-rc.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/audit/audit.mjs +4 -2
- package/package.json +1 -1
- package/templates/ci-laravel.yml +25 -0
- package/templates/ci-node.yml +26 -0
- package/templates/ci-python.yml +26 -0
package/audit/audit.mjs
CHANGED
|
@@ -1270,12 +1270,14 @@ function auditRepo(target, ctx) {
|
|
|
1270
1270
|
// ---- ship-batch (#373) ------------------------------------------------------
|
|
1271
1271
|
// Batch landing's opt-in: an integer 1–3 (tools/lib/ship-batch.js parseShipBatch — the one reading
|
|
1272
1272
|
// `colab ship --batch` uses, so the two cannot disagree). A malformed value makes ship fail closed
|
|
1273
|
-
// to serial, which is safe but silent, so it fails here
|
|
1273
|
+
// to serial, which is safe but silent, so it fails here — and, since this audit is run by hand, in
|
|
1274
|
+
// the CI templates' descriptor check too (#416, held to this same parser by
|
|
1275
|
+
// tools/lib/ci-template-descriptor-check.test.js). Two further shapes are inert rather than
|
|
1274
1276
|
// wrong, so they warn: no workflow fires on a `ship-batch/**` push (the combined run can never
|
|
1275
1277
|
// arrive), and no `autonomy: auto-trunk` (a batch lands in one unattended push, which needs it).
|
|
1276
1278
|
if ("ship-batch" in (cfg || {}) && cfg["ship-batch"] !== null) {
|
|
1277
1279
|
const sbCfg = shipBatch.parseShipBatch(cfg);
|
|
1278
|
-
if (!sbCfg.valid) fail(sbCfg.reason);
|
|
1280
|
+
if (!sbCfg.valid) fail(`${sbCfg.reason} — the cap is deliberate, see project.schema.md, ship-batch`);
|
|
1279
1281
|
else if (sbCfg.n > 1) {
|
|
1280
1282
|
const firing = workflowsFiringOnBranchPush({ readFile: (p) => src.readFile(p), workflows, branch: shipBatch.PROBE_REF });
|
|
1281
1283
|
if (!firing.length) warn(`ship-batch: ${sbCfg.n} but no workflow in .github/workflows fires on a push to ship-batch/** — colab ship --batch will always fall back to serial; add 'ship-batch/**' to a CI workflow's push: branches:`);
|
package/package.json
CHANGED
package/templates/ci-laravel.yml
CHANGED
|
@@ -154,6 +154,31 @@ jobs:
|
|
|
154
154
|
with:
|
|
155
155
|
persist-credentials: false
|
|
156
156
|
|
|
157
|
+
# ---------------------------------------------------------------------------
|
|
158
|
+
# Descriptor check (#416). A value `colab ship` cannot use does not fail there —
|
|
159
|
+
# it fails closed to the safe default, silently. `ship-batch: 5` (the cap is 3)
|
|
160
|
+
# once turned every landing in a busy repo back to serial while this CI stayed
|
|
161
|
+
# green; only a ship dry run noticed. So the value fails HERE, where the person
|
|
162
|
+
# who changed project.yml is looking. Same rule as `colab ship` and the audit
|
|
163
|
+
# (tools/lib/ship-batch.js parseShipBatch): absent/empty/null, or 1–3. Why the
|
|
164
|
+
# cap is 3: project.schema.md, `ship-batch`.
|
|
165
|
+
# ---------------------------------------------------------------------------
|
|
166
|
+
- name: Descriptor check (.github/project.yml)
|
|
167
|
+
working-directory: ${{ github.workspace }}
|
|
168
|
+
run: |
|
|
169
|
+
[ -f .github/project.yml ] || exit 0
|
|
170
|
+
line="$(grep -E '^ship-batch[[:space:]]*:' .github/project.yml | head -1 || true)"
|
|
171
|
+
[ -n "$line" ] || exit 0
|
|
172
|
+
v="$(printf '%s\n' "$line" | sed -E -e 's/^ship-batch[[:space:]]*:[[:space:]]*//' \
|
|
173
|
+
-e 's/[[:space:]]+#.*$//' -e 's/[[:space:]]+$//' \
|
|
174
|
+
-e 's/^"(.*)"$/\1/' -e "s/^'(.*)'\$/\\1/")"
|
|
175
|
+
case "$v" in
|
|
176
|
+
''|'~'|null|1|2|3) echo "ship-batch: ${v:-absent} — ok" ;;
|
|
177
|
+
*)
|
|
178
|
+
echo "::error file=.github/project.yml::ship-batch is '$v', expected an integer 1-3 (omit for serial). colab ship ignores any other value and lands serially. Why the cap is 3: project.schema.md, ship-batch."
|
|
179
|
+
exit 1 ;;
|
|
180
|
+
esac
|
|
181
|
+
|
|
157
182
|
# ---------------------------------------------------------------------------
|
|
158
183
|
# Toolchain resolution. Precedence, highest first:
|
|
159
184
|
# PHP : 1. .github/project.yml -> php: 2. composer.json -> require.php
|
package/templates/ci-node.yml
CHANGED
|
@@ -13,6 +13,7 @@
|
|
|
13
13
|
# `php artisan wayfinder:generate` and needs PHP on the runner. Use ci-laravel.yml.
|
|
14
14
|
#
|
|
15
15
|
# What it does:
|
|
16
|
+
# 0. Fail on a .github/project.yml value colab would silently ignore (ship-batch, #416).
|
|
16
17
|
# 1. Resolve the Node version from declared sources — never a hardcoded default.
|
|
17
18
|
# 2. Secret scan with gitleaks (pinned release binary, see note at the step).
|
|
18
19
|
# 3. Install dependencies with the package manager the lockfile implies.
|
|
@@ -147,6 +148,31 @@ jobs:
|
|
|
147
148
|
with:
|
|
148
149
|
persist-credentials: false
|
|
149
150
|
|
|
151
|
+
# ---------------------------------------------------------------------------
|
|
152
|
+
# Descriptor check (#416). A value `colab ship` cannot use does not fail there —
|
|
153
|
+
# it fails closed to the safe default, silently. `ship-batch: 5` (the cap is 3)
|
|
154
|
+
# once turned every landing in a busy repo back to serial while this CI stayed
|
|
155
|
+
# green; only a ship dry run noticed. So the value fails HERE, where the person
|
|
156
|
+
# who changed project.yml is looking. Same rule as `colab ship` and the audit
|
|
157
|
+
# (tools/lib/ship-batch.js parseShipBatch): absent/empty/null, or 1–3. Why the
|
|
158
|
+
# cap is 3: project.schema.md, `ship-batch`.
|
|
159
|
+
# ---------------------------------------------------------------------------
|
|
160
|
+
- name: Descriptor check (.github/project.yml)
|
|
161
|
+
working-directory: ${{ github.workspace }}
|
|
162
|
+
run: |
|
|
163
|
+
[ -f .github/project.yml ] || exit 0
|
|
164
|
+
line="$(grep -E '^ship-batch[[:space:]]*:' .github/project.yml | head -1 || true)"
|
|
165
|
+
[ -n "$line" ] || exit 0
|
|
166
|
+
v="$(printf '%s\n' "$line" | sed -E -e 's/^ship-batch[[:space:]]*:[[:space:]]*//' \
|
|
167
|
+
-e 's/[[:space:]]+#.*$//' -e 's/[[:space:]]+$//' \
|
|
168
|
+
-e 's/^"(.*)"$/\1/' -e "s/^'(.*)'\$/\\1/")"
|
|
169
|
+
case "$v" in
|
|
170
|
+
''|'~'|null|1|2|3) echo "ship-batch: ${v:-absent} — ok" ;;
|
|
171
|
+
*)
|
|
172
|
+
echo "::error file=.github/project.yml::ship-batch is '$v', expected an integer 1-3 (omit for serial). colab ship ignores any other value and lands serially. Why the cap is 3: project.schema.md, ship-batch."
|
|
173
|
+
exit 1 ;;
|
|
174
|
+
esac
|
|
175
|
+
|
|
150
176
|
# ---------------------------------------------------------------------------
|
|
151
177
|
# Toolchain resolution. Precedence, highest first:
|
|
152
178
|
# 1. .github/project.yml -> node: <version>
|
package/templates/ci-python.yml
CHANGED
|
@@ -27,6 +27,7 @@
|
|
|
27
27
|
# NOT for: Laravel + Inertia fullstack apps — use ci-laravel.yml.
|
|
28
28
|
#
|
|
29
29
|
# What it does:
|
|
30
|
+
# 0. Fail on a .github/project.yml value colab would silently ignore (ship-batch, #416).
|
|
30
31
|
# 1. Resolve the Python version from declared sources — never a hardcoded default.
|
|
31
32
|
# 2. Secret scan with gitleaks (pinned release binary, see note at the step).
|
|
32
33
|
# 3. Install dependencies from whichever manifest the repo actually has.
|
|
@@ -138,6 +139,31 @@ jobs:
|
|
|
138
139
|
with:
|
|
139
140
|
persist-credentials: false
|
|
140
141
|
|
|
142
|
+
# ---------------------------------------------------------------------------
|
|
143
|
+
# Descriptor check (#416). A value `colab ship` cannot use does not fail there —
|
|
144
|
+
# it fails closed to the safe default, silently. `ship-batch: 5` (the cap is 3)
|
|
145
|
+
# once turned every landing in a busy repo back to serial while this CI stayed
|
|
146
|
+
# green; only a ship dry run noticed. So the value fails HERE, where the person
|
|
147
|
+
# who changed project.yml is looking. Same rule as `colab ship` and the audit
|
|
148
|
+
# (tools/lib/ship-batch.js parseShipBatch): absent/empty/null, or 1–3. Why the
|
|
149
|
+
# cap is 3: project.schema.md, `ship-batch`.
|
|
150
|
+
# ---------------------------------------------------------------------------
|
|
151
|
+
- name: Descriptor check (.github/project.yml)
|
|
152
|
+
working-directory: ${{ github.workspace }}
|
|
153
|
+
run: |
|
|
154
|
+
[ -f .github/project.yml ] || exit 0
|
|
155
|
+
line="$(grep -E '^ship-batch[[:space:]]*:' .github/project.yml | head -1 || true)"
|
|
156
|
+
[ -n "$line" ] || exit 0
|
|
157
|
+
v="$(printf '%s\n' "$line" | sed -E -e 's/^ship-batch[[:space:]]*:[[:space:]]*//' \
|
|
158
|
+
-e 's/[[:space:]]+#.*$//' -e 's/[[:space:]]+$//' \
|
|
159
|
+
-e 's/^"(.*)"$/\1/' -e "s/^'(.*)'\$/\\1/")"
|
|
160
|
+
case "$v" in
|
|
161
|
+
''|'~'|null|1|2|3) echo "ship-batch: ${v:-absent} — ok" ;;
|
|
162
|
+
*)
|
|
163
|
+
echo "::error file=.github/project.yml::ship-batch is '$v', expected an integer 1-3 (omit for serial). colab ship ignores any other value and lands serially. Why the cap is 3: project.schema.md, ship-batch."
|
|
164
|
+
exit 1 ;;
|
|
165
|
+
esac
|
|
166
|
+
|
|
141
167
|
# ---------------------------------------------------------------------------
|
|
142
168
|
# Toolchain resolution. Precedence, highest first:
|
|
143
169
|
# 1. .github/project.yml -> python: <version>
|