Skip to content

Use installed local search for the repository KB #19

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
0thernet merged 1 commit into from
Oct 1, 2026
Merged

Use installed local search for the repository KB #19

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,3 +69,9 @@
- Confirm installation with `bunx skills list --global`. If Bun or network access is unavailable, continue with repository-native tools instead of blocking delivery.
- Treat ALGAL receipts as execution evidence, not provider attestation, and preserve the repository's normal verification and release gates.
<!-- algal-skills:end -->

<!-- wordcell-search:start -->
- During repository setup, install the standalone pinned search tool with `bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.26.0/hraness-wordcell-0.26.0.tgz` and confirm `HRANESS_NO_UPDATE=1 wordcell --version` reports `0.26.0`. Preserve the repository’s independently pinned KB maintenance tooling.
- Search from the repository root with `bun run kb:search "query" --json` or its local alias `bun run kb:search:local "query" --json`. This uses the installed executable without a query-time package runner, embedding download, or provider credential. Read the matched Markdown and linked sources; selected passages include source-line references.
- Keep private notes and confidential queries local. Add `--rerank typesafe --rerank-limit 25` only for a vault and query approved for hosted processing; keys stay outside Git. Hosted ranking sends the query and up to 25 candidates' identifiers, titles, relative paths and 512 UTF-8 bytes of snippet text each, with provider charges. Inspect the `rerank` lane and usage receipt: fallback can return useful results with a successful exit. See the [pinned reranking reference](https://github.com/hraness/wordcell/blob/v0.26.0/docs/reranking.md).
<!-- wordcell-search:end -->
3 changes: 2 additions & 1 deletion package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,8 @@
"kb:check:lane": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell check --root kb --no-catalog",
"kb:check": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell check --root kb && bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell agents check --root kb --repo .",
"kb:catalog": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell catalog --root kb",
"kb:search": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell search --root kb --mode exact --selected-passage",
"kb:search": "HRANESS_NO_UPDATE=1 wordcell search --root kb --mode exact --selected-passage",
"kb:search:local": "HRANESS_NO_UPDATE=1 wordcell search --root kb --mode exact --selected-passage",
"check": "bun run typecheck && bun run test:package && bun run test",
"prepack": "bun run check"
},
Expand Down
Loading