# 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.