@skein-code/cli 0.3.20 → 0.3.22

package/README.md

@@ -57,8 +57,10 @@ inspectable index for code retrieval and no retrieval service dependency.
   artifact for bounded readback.
 - **Measurable token economy:** every model request records a privacy-safe
   receipt for stable, dynamic, history, retrieval, tool-result, and tool-schema
-  estimates, alongside actual provider usage when available. Receipts retain
-  only counts and runtime decisions, never prompt or source content.
+  estimates, alongside actual provider usage when available. OpenAI, Anthropic,
+  and Gemini cache/reasoning counters are normalized into session totals and
+  structured events when the provider reports them. Receipts retain only counts
+  and runtime decisions, never prompt or source content.
 - **Reversible work:** Skein snapshots affected files before mutation without
   touching your Git history.
 - **Resumable by default:** conversations, tasks, usage, and changed files live
@@ -94,7 +96,7 @@ To build, verify, and install a local package artifact from this checkout:
 
 ```bash
 npm run verify:package -- --output-dir artifacts/package
-npm install -g ./artifacts/package/skein-code-cli-0.3.16.tgz
+npm install -g ./artifacts/package/skein-code-cli-0.3.22.tgz
 ```
 
 To install the published package from npm:
@@ -449,14 +451,18 @@ command instead of allowing a retrieval change to lower the quality bar.
 The persisted local index now stores content-addressed TypeScript compiler AST
 facts for definitions, calls, and relative imports. Matching definitions can
 expand a query and import/call neighbors may receive a bounded graph score;
-Python and SQL continue to use explicit syntax-aware fallbacks. Git recency is
-collected through a bounded, isolated read-only history scan and contributes
-only a small tie-break score; missing Git, timeouts, output limits, and
-non-repository workspaces degrade to lexical/graph retrieval. Search and
-context JSON expose the index generation, file hash, matched/expanded terms,
-and bm25/path/symbol/phrase/graph/recency breakdown without persisting the
-query or an additional copy of source. Index schema v2 artifacts rebuild as v3
-rather than being trusted after the parser contract changes.
+Python module imports and SQL definitions/references use explicit syntax-aware
+offline fallbacks. Git recency is collected through a bounded, isolated
+read-only history scan and contributes only a small tie-break score; missing
+Git, timeouts, output limits, and non-repository workspaces degrade to
+lexical/graph retrieval. A failed configured verification may add a bounded
+diagnostic tie-break for paths parsed from non-truncated process output. Those
+hints are current-run only, clear on success or the next run, and cannot create
+a zero-relevance hit. Search and context JSON expose the index generation, file
+hash, matched/expanded terms, and bm25/path/symbol/phrase/graph/recency/
+diagnostic breakdown without persisting the query, diagnostic path, or another
+copy of source. Index schema v2 artifacts rebuild as v3 rather than being
+trusted after the parser contract changes.
 
 The included fixture is a deterministic regression gate, not evidence for
 performance on every production repository. `--fresh-index` deletes and