---
model: openai/gpt-5.6-sol
service: opencode
timestamp: 2026-07-31T16:52:15Z
git_ref: 0846cbd4
diff_cmd: git diff HEAD~1..HEAD
---

The user requested an evaluation and possible update of `piker store`,
including immediate help output when a group or endpoint is invoked with
no arguments. The user also proposed eventual optional `fzf` selection for
`anal` and `ldshm`, and authorized aggregating the recent time-series and
SHM debugging work into CLI endpoints. After reviewing three scopes, the
user selected the recommended safe foundation rather than implementing
interactive fuzzy selection or changing mutation defaults immediately.

> `git diff HEAD~1..HEAD -- piker/storage/cli.py`

Generated no-argument help behavior for the `store` group and every
endpoint. Added read-only `series` and `shm` commands, JSON and Rich output,
exact `--shm-name` plumbing, SHM cadence/invalid/order/gap summaries, and
safe corrupt-epoch formatting. Fixed existing `ldshm` no-write/no-reload
control flow and no-match debugger behavior.

> `git diff HEAD~1..HEAD -- piker/storage/nativedb.py`

Generated canonical `NativeSeriesRef` parsing and deterministic listing.
Changed the internal index to preserve `(fqme, period)` identities while
keeping unique-FQME compatibility listing and cardinality. Hardened
malformed, sidecar, Unicode-period, symlink, and traversal handling.

> `git diff HEAD~1..HEAD -- piker/tsp/_history.py`

Generated exact `ShmBufferRef` parsing and stable discovery, replacing
unsafe substring globbing. Added dtype resolution that mirrors history
allocation, exact-ref attachment, disappearance handling, and optional
exact-name iteration.

> `git diff HEAD~1..HEAD -- piker/data/_sharedmem.py`

Generated attach-only SHM access which never creates a segment when a
discovered object disappears.

> `git diff HEAD~1..HEAD -- piker/tsp/__init__.py`

Exported selector-ready SHM identity, parsing, listing, and dtype helpers.

> `git diff HEAD~1..HEAD -- tests/test_store_cli.py`

Generated command-level help, exact durable-series JSON, read-only SHM JSON,
and unknown exact-name regressions.

> `git diff HEAD~1..HEAD -- tests/test_ldshm.py`

Generated SHM identity, summary, ordering, dtype, forged-name, disabled
mutation-flag, and gap-markup regressions.

> `git diff HEAD~1..HEAD -- tests/test_storage_nativedb.py`

Generated compound index, canonical parser, malformed filename, and dotted
FQME regressions.

> `git diff HEAD~1..HEAD -- docs/manual_backfill_qualification.rst`

Documented `store series` and `store shm` as separate read-only durable and
live-memory triage layers.

> `git diff HEAD~1..HEAD -- .claude/skills/run-tests/test-harness-reference.md`

Registered the deterministic storage CLI UX target and mapping.

Verification output:

```text
........................................................................ [ 71%]
.............................                                            [100%]
101 passed in 1.72s
```

Real `piker store` and `piker store audit` invocations printed complete
help without `--help`, exiting with Click's normal no-args help status 2.
`git diff --check` passed. Ruff was unavailable in the existing worktree
environment.

Adversarial review drove fixes for provider dtype reconstruction, observed
versus expected cadence, exact SHM grammar, discovery races, Typer direct
defaults, malformed NativeDB periods, compound cardinality compatibility,
undefined `ldshm` reload payloads, no-match debugger hangs, ordering
corruption reporting, and dtype precedence. Final review found no issues.

Optional external `fzf` or built-in numbered selection remains deferred.
The exact series and SHM identities added here are the intended foundation
for that later patch.
