opencode-sessions-explorer 0.1.2 → 0.1.3

package/docs/guides/export-and-maintenance.md

@@ -55,12 +55,14 @@ maintenance.
    ```
 
 1. (Optional) Build the semantic index to unlock `sem` and `hybrid` search modes.
-   This is slow and only needs to run once. Run `ck --index .` from the export root,
-   not from the repository checkout:
+   This is slow and runs outside the plugin. Run it from the export root, not from
+   the repository checkout; use `ck --reindex .` when search warnings report a stale
+   or partially verified index:
 
    ```bash
    cd ~/.local/share/opencode-sessions-explorer
    ck --index .  # run in the export root, not the repo root
+   ck --reindex .  # explicit rebuild when stale/partial warnings appear
    ```
 
 1. Verify everything is wired up, and re-run after any OpenCode upgrade:

package/docs/guides/search-and-grep.md

@@ -26,8 +26,10 @@ known session, and audit individual tool invocations by name, status, or substri
 `search-text` and `grep-session` shell out to the optional [`ck`](https://github.com/BeaconBay/ck)
 CLI over the filesystem export tree. If `ck` is not installed, both return
 `CK_NOT_FOUND` cleanly; the other 16 tools keep working without it. Semantic modes
-additionally require a one-time `ck --index .` inside the export root — without it,
-`sem`/`hybrid` fall back to `regex` with a warning. See
+require an embedding index built outside the tool (`ck --index .` or
+`ck --reindex .` from the export root). Missing indexes fall back to `regex`; stale
+or partially verified indexes keep using `sem`/`hybrid` but warn that results may be
+incomplete. The tools never rebuild embeddings inline. See
 [search surfaces](../reference/search-surfaces.md) for the surface/channel model.
 
 ## Controls

package/docs/reference/architecture.md

@@ -48,9 +48,11 @@ Searchable content is materialized to a filesystem tree (default
 
 The tree is built once by `opencode-sessions-explorer-bulk-export` and then
 delta-synced automatically before each `search-text` / `grep-session` call, so new
-parts become searchable without a manual re-export. Sync is cursor-based on
-`(time_updated, id)`, which also re-exports parts whose status mutated since the last
-pass.
+parts become searchable without a manual re-export. Budgeted sync uses an id-cursor
+insert fast path for newly appended parts, plus session-dirty scans keyed by
+`session.time_updated` to re-export sessions whose part status or metadata changed.
+Short search-triggered syncs also schedule a throttled background reconcile, while
+unbudgeted bulk exports perform full tombstone cleanup inline.
 
 ### L3 — ck Index (Optional)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode-sessions-explorer",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "OpenCode plugin for recall and analysis of past OpenCode sessions: search, grep, and cost/usage insights across your session history via 18 LLM tools (17 read-only plus one write, unarchive-session).",
   "keywords": [
     "opencode",
@@ -45,7 +45,7 @@
     "opencode-sessions-explorer-check-deps": "./dist/bin/check-deps.js"
   },
   "scripts": {
-    "build": "bun run clean && bun build src/plugin.ts --target=bun --format=esm --outdir=dist && bun build src/bin/bulk-export.ts src/bin/dedupe-export.ts src/bin/check-deps.ts --target=bun --format=esm --outdir=dist/bin",
+    "build": "bun run clean && bun build src/plugin.ts src/lib/export-reconcile-worker.ts --target=bun --format=esm --outdir=dist && bun build src/bin/bulk-export.ts src/bin/dedupe-export.ts src/bin/check-deps.ts --target=bun --format=esm --outdir=dist/bin",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "bun test tests/",
     "test:live": "OPENCODE_SESSIONS_EXPLORER_LIVE=1 bun test tests/",