Repository navigation
Releases
Releases · iamironz/opencode-sessions-explorer
v0.1.4
v0.1.3
Fixed
search-textnow reports honestcksemantic index freshness forsem/hybrid
modes (missing/stale/partial) and directs users to explicitck --index/
ck --reindexworkflows instead of implying inline rebuilds.search-textandgrep-sessionnow expose partial multi-scopeckcoverage when
timeout truncation leaves some session/channel scopes unsearched.
v0.1.2
Changed
- Clarified installation, source-dev, and first-run docs, including plugin
registration troubleshooting, platform-specific database paths, and export/index
setup; shippeddocs/in the npm package so README guide links resolve for
package consumers.
v0.1.1
Changed
- Documentation restructure: organized the
docs/tree (getting started, install, guides,
reference, support, maintainers) and reworkedREADME.mdinto a concise entry point that
links out to the new docs. - Generalized the product descriptions and wording across
package.json,README.md, and
the docs tree so they are non-parochial (removed machine- and author-specific phrasing).
No runtime or API changes.
v0.1.0
Initial public release on npm.
Added
opencode-sessions-explorer-unarchive-session— the first and only write tool. Restores a session to a usable state by clearingsession.time_archivedand refreshingsession.time_updatedin oneUPDATE. It always resurfaces (even an already-active-but-buried session), so it is not a silent no-op on active rows; idempotent in effect (active + at the top). Only a non-existent id returnsNOT_FOUND. Thetime_updatedbump is required: OpenCode loads sessions ordered bytime_updated DESCwith a defaultLIMIT 100per directory, so merely clearingtime_archivedleaves a long-archived session buried below that window — the app never loads it and prompting fails with "Unable to retrieve session". Bumping resurfaces it at the top. OpenCode exposes no HTTP/SDK endpoint that can clear the flag (itsUpdatePayload.time.archivedis a finite number and the handler ignoresundefined; verified against v1.15.12 source) andopencode sessiononly offers list/delete, so a direct DB write is the only mechanism. Reads stay on the shared read-only handle; the write goes through a separate short-lived read-write connection insrc/lib/db-write.ts. NewWRITE_FAILEDerror code. The plugin namespace is now 18 tools (17 read-only + 1 write).tests/unarchive.test.ts— exercises the write path against a throwaway snapshot copy of the live DB (real archived session → unarchived, already-active-but-buried session → resurfaced,time_updatedrefresh, NOT_FOUND, and live-DB isolation), so the suite never mutates the real DB.verify-end-to-end.tsprobes the tool via the zero-mutation NOT_FOUND path (now 17/17).- Columnar + interning result codec (
src/lib/table.ts:table()/decodeTable()/isTable()) applied to all list-shaped tool results. Lossless; measured −33% to −56% payload size by removing per-row key repetition and interning repeated model/directory/agent/project/channel/type values. Envelope and tool descriptions unchanged. Flatsearch-texthits drop the constantraw_ref(use the in-rowpart_idwithget-part); duplicateranked_sessionsremoved in favor of the singlesessionstable. - Hermetic synthetic fixture DB so
bun testruns without a live OpenCode history by default; live runs are opt-in viaOPENCODE_SESSIONS_EXPLORER_LIVE=1(orbun run test:live). - Curated recall surfaces for
search-textandgrep-session:recall,debug_trace,tool_audit,code, andforensics. - Channelized export views under
by-channel/while preserving rawby-session/replay data. - Session-first ranked
search-textresults for unscoped recall, with evidence snippets, channel counts, suppressed counts, and raw refs. - Structured
truncated_fieldsmetadata inget-partandget-message. current-sessioncompact/default output with explicitdetail:'full'for counters, children, paths, and suggestions.- Redaction regression coverage and forensic/raw parity coverage in the rehearsal suite.
- Initial extraction from
~/.config/opencode/into a standalone repo. - 18 tools registered under the
opencode-sessions-explorer-*namespace:- Recall:
current-session,get-session,session-summary,session-timeline,get-message,get-part,session-genealogy - Browse:
list-sessions,search-sessions-meta - Search:
search-text,grep-session,search-tool-calls - Analysis:
cost-by-project,cost-by-period,list-tool-failures,list-repeated-prompts - Health:
db-stats - Mutate (write):
unarchive-session
- Recall:
- CLI bins:
opencode-sessions-explorer-bulk-export,opencode-sessions-explorer-dedupe-export,opencode-sessions-explorer-check-deps. - Single Plugin entry point at
src/plugin.tsreturning{ tool: { ... } }per OpenCode plugin contract. - 99 rehearsal probes covering the read-only tools (hermetic by default; live mode opt-in via
OPENCODE_SESSIONS_EXPLORER_LIVE=1). - README + LICENSE (MIT) + CHANGELOG.
Fixed
- Fixed
ckmulti-scope hangs by running bounded single-scope invocations and merging results. - Reduced default noise in
search-tool-calls,session-timeline,session-summary,list-tool-failures, andlist-repeated-prompts. - Defaulted search snippet redaction to on and expanded common secret patterns.
- Removed hardcoded
/Users/aleksandr.efremenkov/.cargo/bin/ckfromlib/ck.ts; addedOPENCODE_SESSIONS_EXPLORER_CK_BINenv override. - Replaced CJS
require("node:fs")with ESM import inlib/ck.ts. - Added
OPENCODE_SESSIONS_EXPLORER_TOOL_OUTPUT_DIRenv override inlib/path-guard.ts; added Windows support via%LOCALAPPDATA%. - All tool imports rewritten from
"../opencode-sessions-explorer/lib/…"(home-dir-coupled) to"../lib/…"(portable repo-relative).