79 lines
3.2 KiB
Markdown
79 lines
3.2 KiB
Markdown
|
---
|
||
|
|
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.
|