Add scripts-to-rule-them-all scaffold (closes #4) #5

clawbot · 2026-07-25T13:23:22+02:00

clawbot commented

2026-07-25 13:23:22 +02:00

Adds the standard STRTA scaffold to this Hugo site, resolving #4.

Makefile — nine standard targets as thin @script/NAME shims (hooks -> @script/install-precommit), plus a serve convenience target (hugo server).
script/ — executable POSIX-sh entrypoints (bootstrap, setup, test, lint, fmt, fmt-check, check, docker, install-precommit, cibuild, and helpers), with Hugo-appropriate bodies: test/check run a clean hugo --minify build; fmt/fmt-check run prettier scoped to the repo's own top-level docs only (content/ is left untouched).
Dockerfile (+ .dockerignore) — pinned base; the build runs make check, so the image build fails on any format or Hugo error.
.gitea/workflows/check.yml — runs script/cibuild.

Verified locally: make check and docker build . both green. Scope is limited to the scaffold; the remaining non-STRTA items (LICENSE, REPO_POLICIES.md, .editorconfig, pinning deploy.yml) are tracked separately.

Adds the standard STRTA scaffold to this Hugo site, resolving #4. - `Makefile` — nine standard targets as thin `@script/NAME` shims (`hooks` -> `@script/install-precommit`), plus a `serve` convenience target (`hugo server`). - `script/` — executable POSIX-`sh` entrypoints (`bootstrap`, `setup`, `test`, `lint`, `fmt`, `fmt-check`, `check`, `docker`, `install-precommit`, `cibuild`, and helpers), with Hugo-appropriate bodies: `test`/`check` run a clean `hugo --minify` build; `fmt`/`fmt-check` run prettier scoped to the repo's own top-level docs only (`content/` is left untouched). - `Dockerfile` (+ `.dockerignore`) — pinned base; the build runs `make check`, so the image build fails on any format or Hugo error. - `.gitea/workflows/check.yml` — runs `script/cibuild`. Verified locally: `make check` and `docker build .` both green. Scope is limited to the scaffold; the remaining non-STRTA items (`LICENSE`, `REPO_POLICIES.md`, `.editorconfig`, pinning `deploy.yml`) are tracked separately.

clawbot added 1 commit 2026-07-25 13:23:22 +02:00

Add scripts-to-rule-them-all scaffold (closes #4 )

check / check (push) Successful in 4s

Details

Build and Deploy to Cloudflare Pages / build (push) Successful in 5s

Details

Build and Deploy to Cloudflare Pages / deploy (push) Successful in 18s

Details

7cad989724

Adopt the Scripts to Rule Them All standard for this Hugo site:

- script/ POSIX-sh entrypoints (bootstrap, setup, projectname, test,
  lint, fmt, fmt-check, check, docker, cibuild, precommit,
  install-precommit). The correctness check (test/lint) is a clean
  `hugo --minify` production build; fmt/fmt-check run prettier over the
  repo's own top-level markdown only, leaving content/ untouched.
- Makefile targets reduced to thin shims that call script/NAME, plus a
  convenience serve target for `hugo server`.
- Dockerfile on a sha256-pinned alpine base that installs deps via
  script/bootstrap and runs `make check`, so the image build fails on
  any formatting or Hugo build error; .dockerignore added.
- .gitea/workflows/check.yml runs script/cibuild on push.
- README Entrypoints section documenting the scripts.

clawbot merged commit 7cad989724 into main

2026-07-25 13:26:13 +02:00

clawbot deleted branch strta-conformance

2026-07-25 13:26:13 +02:00

clawbot commented

2026-07-25 13:26:18 +02:00

Merged to main after an independent adversarial review (a reviewer separate from the author) verified it: make check and docker build . both re-run green, all nine standard targets are pure @script/* shims backed by a full script/ set including cibuild, the Dockerfile gates on make check, checks are real (no fake no-ops), scope is limited to the scaffold, and there are no AI/trailer hygiene issues. Verdict: PASS.

Two trivial, non-blocking observations noted for optional future polish (not worth their own issue):

script/check composes fmt-check + test but does not call script/lint, so Hugo's --printPathWarnings is not exercised in CI. Fine per STRTA; revisit only if you want path-collision warnings gated.
The README line for script/install-precommit says the hook runs script/check; it actually runs script/precommit (which calls script/check) — accurate in effect, slightly imprecise in wording.

Merged to `main` after an independent adversarial review (a reviewer separate from the author) verified it: `make check` and `docker build .` both re-run green, all nine standard targets are pure `@script/*` shims backed by a full `script/` set including `cibuild`, the `Dockerfile` gates on `make check`, checks are real (no fake no-ops), scope is limited to the scaffold, and there are no AI/trailer hygiene issues. Verdict: PASS. Two trivial, non-blocking observations noted for optional future polish (not worth their own issue): - `script/check` composes `fmt-check` + `test` but does not call `script/lint`, so Hugo's `--printPathWarnings` is not exercised in CI. Fine per STRTA; revisit only if you want path-collision warnings gated. - The README line for `script/install-precommit` says the hook runs `script/check`; it actually runs `script/precommit` (which calls `script/check`) — accurate in effect, slightly imprecise in wording.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: sneak/lora.vegas#5