`bd list --wisp-type heartbeat` returns an empty listing for EVERY input, and
`bd list` exposes no flag that changes that.
ListRequest.WispType is a predicate, not a plane selector — its own doc says
so, and RunReaderListWispTypeNarrowsTheAdmittedPlaneRatherThanAdmittingIt pins
it. That contract is right and this does not touch it. The doc also names the
way out:
The combination that answers with rows is IncludeEphemeral (or
IncludeInfra) plus this, and it is lawful rather than refused.
`bd list` registers neither `--include-ephemeral` nor `--all-types`. So of the
two combinations the doc names, the CLI can express only IncludeInfra — which
admits the plane AND lifts the infra-type exclusions AND changes the template
treatment, three decisions a caller who wanted one classification did not ask
for. The narrow knob the doc names FIRST has no flag at all.
That is the whole defect: the API composes correctly, and the CLI is missing
the other half of the pair.
## What this does
1. Registers `--include-ephemeral` on `bd list`, wired to
`ListRequest.IncludeEphemeral` — the plane knob alone, off by default, so
the default listing is byte-identical.
2. Refuses `--wisp-type` when no plane is admitted, with the fix in the hint,
instead of printing an empty listing.
The refusal is at the CLI layer ONLY. At the API layer the combination stays
lawful and still composes to an empty page: that is the pinned contract, and a
programmatic caller composing filters may legitimately land on it. A human
typing `--wisp-type heartbeat` cannot have meant "prove to me that durable rows
carry no classification", so the CLI is where the guess is safe to make.
An explicit `--type` is deliberately left alone: an infra type routes to the
plane by itself, so the request may well be satisfiable, and this layer cannot
tell which types those are without loading the workspace's infra vocabulary.
Refusing there would reject lawful, answerable requests.
## Verification
--- PASS: TestListRegistersIncludeEphemeral
--- PASS: TestGatherListInput_WispTypeWithoutAPlaneIsRefused
--- PASS: TestGatherListInput_WispTypeWithAPlaneIsAccepted (3 subtests)
--- PASS: TestGatherListInput_IncludeEphemeralReachesTheRequest
The pair discriminates rather than being trivially green: a guard that refused
every `--wisp-type` would pass the refusal test and fail all three acceptance
subtests, one per route that admits the plane.
`ok github.com/steveyegge/beads/cmd/bd`, `ok
github.com/steveyegge/beads/internal/workapi`, `go build ./...` and `go vet`
clean. `internal/workapi/list.go` and the golden corpus are untouched.
docs/CLI_REFERENCE.md is not regenerated here: the docs pipeline builds from
the release tag in docs/cli-docs.pin (v1.2.2), not from this checkout, so the
new flag appears at the next release bump.
Claude-Session: https://claude.ai/code/session_01X1jMLQTSrCwtzFRS1xeUC6