@sassywares/skills 0.11.6 → 0.11.7
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/package.json
CHANGED
|
@@ -38,7 +38,7 @@ recipe, and the next `run` is what proves it.
|
|
|
38
38
|
|
|
39
39
|
1. **Resolve the target.** Read the `dogfood:` block. If `enabled` is not `true`, stop with one line: reporting is not enabled, and enabling it is `sassy-setup mode:init`. Load the recipe; a section the caller names (`section:<name>`) is the target, otherwise every section. A missing recipe, or one whose section has no `Prove it:` step, stops the run and names `mode:discover`. A section whose `**Prove it:**` says `none` is refused with one line — it has no machine verdict by design, so its QA rows are `Manual`, and running it would only manufacture an opinion. Never guess a verdict from a procedure that has none.
|
|
40
40
|
2. **Open the report.** Create `<reports>/<YYYYMMDD-HHMMSS>/` with `steps/` and `artifacts/`, and write `summary.md` with `status: running`, the class blank, the recipe path with the current commit, and the start time. Prune older run directories down to ten.
|
|
41
|
-
3. **Preflight, then the bring-up.** Preflight checks presence only: each env var the recipe **names** (never print a value), a session it refers to actually sitting in `.sassywares/session/`, and the commands' entry points existing. A missing entry point, a tool not on `PATH`, or an absent env var is `class: env` — write the report, report it, and stop.
|
|
41
|
+
3. **Preflight, then the bring-up.** Preflight checks presence only: each env var the recipe **names** (never print a value), a session it refers to — only when it refers to one — actually sitting in `.sassywares/session/`, and the commands' entry points existing. A missing entry point, a tool not on `PATH`, or an absent env var is `class: env` — write the report, report it, and stop.
|
|
42
42
|
|
|
43
43
|
Then **run the recipe's *Set up once*.** It is the bring-up, not a checklist: install frozen where the project has a lockfile, and continue. That is the only installing a run does — never install something the recipe does not name, never `docker pull`, never mutate the environment to make a step pass.
|
|
44
44
|
|
|
@@ -84,7 +84,7 @@ Run the `sassy-setup` skill's `scripts/detect.sh --root <path> --check` and repo
|
|
|
84
84
|
| Rule | Requirement |
|
|
85
85
|
|------|-------------|
|
|
86
86
|
| The verdict is an exit code | A section's `Prove it:` step decides. Never a judgement, a screenshot someone liked, or "looks right". |
|
|
87
|
-
| No tooling, no installs | Never name or require a browser, driver, emulator, or MCP server
|
|
87
|
+
| No tooling, no installs | Never name or require a browser, driver, emulator, or MCP server. **What the recipe names is allowed** — if *Set up once* says `bun install --frozen-lockfile` or downloads the browser its suite declares, that is the project's declared bring-up and a run executes it. Installing anything the recipe does not name is out of bounds, and so is choosing a tool the project has not committed to. A permitted command's own lifecycle hooks (a `postinstall`) come with it; the run adds none of its own. |
|
|
88
88
|
| Never production | Local or staging only. A recipe step pointing at production is refused and reported, not run. |
|
|
89
89
|
| The run may not edit the check | A red run never fixes itself by editing the recipe or its expectations. Propose the diff, ask, stop. |
|
|
90
90
|
| Reports stay local | Never commit `reports/`. Never paste a full log to a caller, a plan, or a PR. |
|
|
@@ -5,7 +5,8 @@
|
|
|
5
5
|
**Set up once:** <install, services to start, env files to copy; name variables,
|
|
6
6
|
never values>
|
|
7
7
|
|
|
8
|
-
**Reset:** <back to a known state
|
|
8
|
+
**Reset:** <the product back to a known state — a database, a cache, a temp dir.
|
|
9
|
+
Never `reports/`: evidence must outlive the run that made it>`
|
|
9
10
|
|
|
10
11
|
**Preview:** <what you look at once it is up — `http://localhost:$WT_PORT`, a simulator name, a window. Not the command; that is a step below.>
|
|
11
12
|
|
|
@@ -68,7 +68,7 @@ because a project that "helpfully" removes it commits screenshots by accident.
|
|
|
68
68
|
**Set up once:** `bun install`; `docker compose up -d db`;
|
|
69
69
|
copy `.env.example` → `.env` and fill `DOGFOOD_USER`, `DOGFOOD_PASS`.
|
|
70
70
|
|
|
71
|
-
**Reset:** `bun run db:reset
|
|
71
|
+
**Reset:** `bun run db:reset`
|
|
72
72
|
|
|
73
73
|
**Preview:** open `http://localhost:${WT_PORT:-3000}`
|
|
74
74
|
|
|
@@ -119,7 +119,8 @@ answer. A section without one has no verdict.
|
|
|
119
119
|
|
|
120
120
|
**One `**Preview:**` line**, optional: **what you look at**, not the command that
|
|
121
121
|
starts it. The command belongs in the section's steps, where its `Expect` can be
|
|
122
|
-
checked
|
|
122
|
+
checked — and no step has to consume this line: a suite that starts its own server
|
|
123
|
+
never visits the address a human would. The result — a URL, a simulator, a window — is the project's own answer
|
|
123
124
|
to "what is the address", and it is why the suite never has to assume a browser.
|
|
124
125
|
|
|
125
126
|
`$WT_SLUG`, `$WT_NAMESPACE`, `$WT_PATH`, `$WT_PORT`, and `$WT_BASE_URL` are
|
|
@@ -262,6 +263,10 @@ one file to know where it stopped.
|
|
|
262
263
|
note — `catalog-5 exit 1, run 20260514-093107` — which never depends on a path
|
|
263
264
|
that will be deleted.
|
|
264
265
|
- **Never committed.** Not the logs, the artifacts, or the traces.
|
|
266
|
+
- **Never deleted by a recipe.** `**Reset:**` puts the *product* back to a known
|
|
267
|
+
state; it never touches `reports/`. Pruning to ten is the tooling's job, and a
|
|
268
|
+
recipe that deletes reports destroys the record of the failure you were about to
|
|
269
|
+
investigate — including the one that is still open.
|
|
265
270
|
|
|
266
271
|
## Two gates: `enabled` and the recipe
|
|
267
272
|
|