3.7 KiB
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:
........................................................................ [ 71%]
............................. [100%]
101 passed in 1.72sReal 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.