---
model: openai/gpt-5.6-sol
service: opencode
timestamp: 2026-08-01T01:53:21Z
git_ref: 74ea2152
diff_cmd: git diff HEAD~1..HEAD
---

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:

```text
........................................................................ [ 69%]
................................                                         [100%]
104 passed in 5.77s
```

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