3.2 KiB
The user requested command-surface refinements after reviewing the new storage CLI. Bare ls should default to all series and act as a compact form of detailed series; commands should produce sensible default output without requiring trigger flags; and ls needed a parent-help description. The user first proposed folding read-only SHM inspection into ldshm -r, then clarified that shm is the better canonical command because attaching to volatile segments is implied by the resource name.
The resulting design uses piker store ls as a compact NativeDB FQME and period view, while piker store series reports each exact sub-series with size and path details. Both default to all records and accept an optional FQME substring.
piker store shm FQME is read-only by default. Persistence and reload enter the prior repair workflow only through explicit --write-parquet and --reload-parquet-to-shm flags. Reload requires persistence, and read-only formatting flags are rejected in repair mode instead of being ignored.
git diff HEAD~1..HEAD -- piker/storage/cli.py
Generated shared NativeDB payload collection, compact and detailed output, numeric period ordering, default-all semantics, the canonical shm command, safe mode dispatch, explicit repair validation, and debugger propagation in read-only mode.
git diff HEAD~1..HEAD -- tests/test_store_cli.py
Generated regressions for no-flag listing, parent-help descriptions, numeric period display, default read-only SHM JSON, reload dependencies, and repair versus read-only option conflicts.
git diff HEAD~1..HEAD -- tests/test_ldshm.py
Adjusted persistence regressions for the renamed command and explicit repair entry while preserving the historical failure rationale.
git diff HEAD~1..HEAD -- docs/manual_backfill_qualification.rst
Documented compact versus detailed NativeDB discovery, default read-only SHM inspection, and the explicitly mutating repair invocation.
git diff HEAD~1..HEAD -- snippets/claude_debug_helper.py
Updated executable debug helper commands to select explicit SHM persistence.
git diff HEAD~1..HEAD -- .claude/skills/run-tests/test-harness-reference.md
Updated operational safety guidance and SHM regression mappings.
git diff HEAD~1..HEAD -- .claude/skills/piker-slang/examples.md
Updated the command example to the canonical shm spelling.
Verification output:
........................................................................ [ 69%]
................................ [100%]
104 passed in 5.77sReal command-help rendering was checked for the parent group, ls, series, and shm. Real read-only ls and series --json output was also exercised against the configured NativeDB. git diff --check passed.
Adversarial review identified and drove fixes for lexicographic period ordering, stale runbook safety wording, ignored mode-specific options, and an explicit-default --max-gaps 10 validation bypass. Final review found no remaining issues. Real OS-backed SHM attachment and successful repair/reload remain integration-level validation concerns.