feat(ultraplan-local): tally CLI baseline fixture for examples/02-real-cli (Spor B B2) [skip-docs]

Adds the runnable counterpart to examples/01-add-verbose-flag (which is
artifacts-only). The fixture is the measurement target for Spor B's
end-to-end pipeline run (B3) and Spor C's cache-prefix experiment.

Baseline:
- tally.mjs (80 lines, hand-rolled argv parser, zero deps)
- 3 flags: --json, -i/--ignore-case, --lines + --help
- Exit codes: 0 success, 1 file error, 2 invalid argv
- 10 node:test cases, all green (~2.2s wall-clock)
- Deterministic fixtures: sample.txt (foo×7, Foo×1, regex fo+×9) +
  poem.txt (--lines vs total distinction)
- REGENERATED.md skeleton (B3 fills the pipeline walk-through)

Brief preconditions verified:
- grep -c 'foo' sample.txt = 4 (>= 1)
- regex /fo+/g count = 9 (> grep count)
- Brief assumptions for B3 SC #1, #3 hold

This is the first runnable example in plugins/ultraplan-local/examples/.
Next: B3 runs /ultraresearch-local + /ultraplan-local + /ultraexecute-local
against the brief to add --regex/-r, then verifies all 10 Success Criteria.
This commit is contained in:
Kjell Tore Guttormsen 2026-05-04 20:18:57 +02:00
commit c8146c143d
5 changed files with 272 additions and 0 deletions

View file

@ -0,0 +1,85 @@
# REGENERATED.md — examples/02-real-cli
| Field | Value |
|-------|-------|
| Calibrated against | ultraplan-local v3.4.1 |
| Last regenerated | TBD — filled in after the B3 pipeline run |
| Source brief author | Hand-authored by operator (B1 session, 2026-05-04) |
| Baseline author | B2 session, 2026-05-04 |
| Pipeline run | TBD — B3 will run `/ultraresearch-local`, `/ultraplan-local`, `/ultraexecute-local` |
## What this example demonstrates
(Placeholder — fylles ut når B3-pipeline-runet er ferdig. Skal forklare
hvorfor 02-real-cli er en *runnable* fixture, i motsetning til 01-add-verbose-flag
som kun er artifacts.)
## Baseline (delivered by B2, 2026-05-04)
`tally` — a ~80-line zero-dep Node.js CLI that counts literal-substring
occurrences of a pattern in a text file. Three flags (`--json`,
`-i`/`--ignore-case`, `--lines`), `--help`, exit codes 0/1/2.
Layout:
```
examples/02-real-cli/
├── tally.mjs # CLI (≈ 80 lines, hand-rolled argv parser)
├── tests/tally.test.mjs # 10 node:test cases (all pass < 3s)
├── fixtures/
│ ├── sample.txt # 9-line input with known counts (foo×7, Foo×1, fo+ regex × 9)
│ └── poem.txt # 5-line input for --lines vs total distinction
└── REGENERATED.md # this file
```
(Placeholder — utvides med en mini-walk-through av baseline når B3 har
sluttført pipeline-runet.)
## Pipeline run (delivered by B3, TBD)
### `/ultraresearch-local`
(Placeholder — research-swarmen forventes å rapportere 0 topics og produsere
en kort placeholder-brief. Fyll inn faktisk output her.)
### `/ultraplan-local`
(Placeholder — plan.md forventes med 35 steg som målretter `tally.mjs`
+ `tests/tally.test.mjs`. Lim inn step-overskrifter + manifest-summary.)
### `/ultraexecute-local`
(Placeholder — `progress.json` forventes med `verify_passed: true` på alle
steg. Lim inn commit-SHA-ene + steg-tellingen.)
## How to re-run this example
```bash
cd /path/to/ultraplan-local
# 1. Re-run the pipeline against the existing brief
/ultraresearch-local --project .claude/projects/2026-05-04-examples-02-real-cli
/ultraplan-local --project .claude/projects/2026-05-04-examples-02-real-cli
/ultraexecute-local --project .claude/projects/2026-05-04-examples-02-real-cli
# 2. Verify all 10 Success Criteria from brief.md hold:
node --test examples/02-real-cli/tests/tally.test.mjs
node examples/02-real-cli/tally.mjs --regex 'fo+' examples/02-real-cli/fixtures/sample.txt
node examples/02-real-cli/tally.mjs --json --regex 'fo+' examples/02-real-cli/fixtures/sample.txt
```
(Placeholder — utvides med eksakte forventede verdier etter B3.)
## Regeneration triggers
When to re-run this example:
- ultraplan-local minor version bump (e.g. v3.4 → v3.5)
- `plan_version` schema bump
- Manifest YAML required-key additions
- `progress.json` schema bump
- Pipeline-output format change (brief / research / plan / progress)
When regenerating: re-run the pipeline against the existing `brief.md` and
update this file plus `examples/02-real-cli/` artifacts. The fixture itself
(`tally.mjs`, fixtures, baseline tests) stays stable across regenerations —
only the pipeline outputs change.