Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
41 changes: 27 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ system.
Bun 1.3.14 or newer is required.

```sh
bun add --global @hraness/kb@0.17.3
bun add --global @hraness/kb@0.18.0
```

## Why kb
Expand Down Expand Up @@ -193,6 +193,18 @@ Start with a short inherited `AGENTS.md` path for rules whose omission would mak

Treat the knowledge base as repository-adjacent durable memory. Authored Markdown and Git are the record; catalogs, indexes, embeddings, and graph views are replaceable ways to find and inspect it. Checks can validate structure, captures can preserve a selected surface, and similarity can suggest candidates. None of those mechanisms proves that a source is trustworthy or an explanation is still true. People and agents must revise the knowledge as the repository changes.

## Upgrade to v0.18.0

Version 0.18.0 adds a review-only adoption seam for exact dependency closures
from an Oh working authority. Trusted host code creates a
`createOhAdoptionPreparerV1` facade with the expected binding and head,
destination, rights clearance, review route, and conflict policy. The narrow
`prepare` call accepts only a capsule plus transformation and redaction
disclosures, returns deeply immutable deterministic Markdown and manifest
bytes with status `prepared`, and has no vault, Git, Oh-store, or promotion
capability. KB pins `@hraness/oh` v0.2.0 and delegates closure integrity to its
official store verifier.

## Upgrade to v0.17.3

Version 0.17.3 restructures the README around an inspectable first task,
Expand Down Expand Up @@ -247,43 +259,43 @@ audit projection disposable.
Copy this prompt into Codex, Claude Code, or another coding agent:

```text
Install the `kb` Agent Skill from `hraness/kb#v0.17.3` with the standard skills
Install the `kb` Agent Skill from `hraness/kb#v0.18.0` with the standard skills
CLI. Use the skill's runtime instructions to install the exact
`@hraness/kb@0.17.3` registry release only when the command is missing. Verify it
`@hraness/kb@0.18.0` registry release only when the command is missing. Verify it
with `kb doctor` and `kb --help`, but do not initialize or modify a vault until
I ask.
```

Install the single public skill with either runner:

```sh
npx skills add hraness/kb#v0.17.3
bunx skills add hraness/kb#v0.17.3
npx skills add hraness/kb#v0.18.0
bunx skills add hraness/kb#v0.18.0
```

Both commands discover the same `kb` skill and install it into the selected
agent runner. Skill installation is inert: it does not initialize a vault,
refresh a catalog, or edit Markdown. When invoked, the skill uses an existing
`kb` command or, when the command is missing, checks for Bun and installs the
CLI from the immutable `@hraness/kb@0.17.3` npm version.
CLI from the immutable `@hraness/kb@0.18.0` npm version.

The public skills CLI reads `skills/kb/` from the repository. The immutable
`0.17.3` npm package includes the same tree under
`0.18.0` npm package includes the same tree under
`node_modules/@hraness/kb/skills/kb/`, and the package check verifies that the
installed skill is byte-identical to the repository source.

Install the two global commands with Bun:

```sh
bun add --global @hraness/kb@0.17.3
bun add --global @hraness/kb@0.18.0
kb --help
kb-evaluation-builder --help
```

The same registry package can be installed with npm:

```sh
npm install --global --ignore-scripts @hraness/kb@0.17.3
npm install --global --ignore-scripts @hraness/kb@0.18.0
kb --help
```

Expand All @@ -296,20 +308,21 @@ reviewed and enabled; run `kb doctor` to inspect the resulting capabilities.
For programmatic use, add the exact npm version to a Bun project:

```sh
bun add --exact @hraness/kb@0.17.3
bun add --exact @hraness/kb@0.18.0
```

The resulting dependency should remain exact:

```json
{
"dependencies": {
"@hraness/kb": "0.17.3"
"@hraness/kb": "0.18.0"
}
}
```

Version 0.17.3 retains two public GitHub dependencies:
Version 0.18.0 retains three public GitHub dependencies: `@hraness/oh` at
immutable release `v0.2.0` for closure verification,
`@steipete/sweet-cookie` at Hraness release `v0.4.2` for the cookie-scope safety
fork, and `@tobilu/qmd` at commit
`aa993dceb3ef8cfb71d470554ca437570f5a2b3c` for store-local model behavior. A
Expand Down Expand Up @@ -572,9 +585,9 @@ a vault. The package smoke test keeps future tagged packages byte-identical to
that source tree.

```sh
npx skills add hraness/kb#v0.17.3
npx skills add hraness/kb#v0.18.0
# or
bunx skills add hraness/kb#v0.17.3
bunx skills add hraness/kb#v0.18.0
```

The skill invokes the installed `kb` command without depending on a repository
Expand Down
3 changes: 3 additions & 0 deletions bun.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading