Kjell Tore Guttormsen
c8146c143d
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.
85 lines
3.2 KiB
Markdown
85 lines
3.2 KiB
Markdown
# 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 3–5 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.
|