@skein-code/cli 0.3.19 → 0.3.21

package/README.md

@@ -94,7 +94,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.21.tgz
 ```
 
 To install the published package from npm:
@@ -449,11 +449,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. Search and
-context JSON expose the index generation, file hash, matched/expanded terms,
-and bm25/path/symbol/phrase/graph 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