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:
parent
baff890789
commit
c8146c143d
5 changed files with 272 additions and 0 deletions
85
plugins/ultraplan-local/examples/02-real-cli/REGENERATED.md
Normal file
85
plugins/ultraplan-local/examples/02-real-cli/REGENERATED.md
Normal 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 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue