{"_id":"@booga/bground","_rev":"2-7ada3f74e08fdc6f6d1800d56cd10e70","name":"@booga/bground","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.1":{"name":"@booga/bground","version":"0.1.1","keywords":["cli","agent","prompt","lookup"],"license":"MIT","_id":"@booga/bground@0.1.1","maintainers":[{"name":"dreaktor","email":"me@dreaktor.com"}],"homepage":"https://github.com/bvasilenko/bGround#readme","bugs":{"url":"https://github.com/bvasilenko/bGround/issues"},"bin":{"bground":"bin/bground.js"},"dist":{"shasum":"0180ebbfecdefc55c5b7720e1bbc8386f00043a0","tarball":"https://registry.npmjs.org/@booga/bground/-/bground-0.1.1.tgz","fileCount":5,"integrity":"sha512-eYr3gTK8n6eDxf3AQqmMSGrdsFJrdK5+pToLbP2nTcGtxIbtpPSU2/fyax9E7eZkisdO+HwgPuVA4n2j3hvgng==","signatures":[{"sig":"MEYCIQCpBwyVf3rgODDx3eidSTkSGRWX2IQSCNUuQONQxFqKFAIhAOd8xbNrB+OQxgzavsDa5N81P8IBXH7VgOOhxoG0pbGU","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4929},"gitHead":"daafff3fb659388f88f94940454cb2c7a1a6c9b2","scripts":{"postinstall":"node ./bin/install.js"},"_npmUser":{"name":"dreaktor","email":"me@dreaktor.com"},"repository":{"url":"git+https://github.com/bvasilenko/bGround.git","type":"git"},"_npmVersion":"10.9.3","description":"Prompt lookup tool. Agent names a claim type from a fixed list; bground returns the prompt for that claim type. The prompt tells the agent how to check the claim against supplied evidence.","directories":{},"_nodeVersion":"22.19.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bground_0.1.1_1781268623643_0.511741072477859","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@booga/bground","version":"0.2.0","description":"Prompt lookup tool. Agent names a claim type from a fixed list; bground returns the prompt for that claim type. The prompt tells the agent how to check the claim against supplied evidence.","bin":{"bground":"bin/bground.js"},"scripts":{"postinstall":"node ./bin/install.js"},"keywords":["cli","agent","prompt","lookup"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/bvasilenko/bGround.git"},"_id":"@booga/bground@0.2.0","gitHead":"4932d6e6b7d1158cc74b77083a5b62cdbb268eca","bugs":{"url":"https://github.com/bvasilenko/bGround/issues"},"homepage":"https://github.com/bvasilenko/bGround#readme","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-x7lgZTehbPQ+zDi0Y3+wm7nGpEhI7AVm0hxVajlKizGg4TpJnf/6mr4Cj/YDXam+av0RpZ0xRuPQiOr06XhyBA==","shasum":"d799f1a95a7bf3fcece2b5bffdc4e8d3ecd546cc","tarball":"https://registry.npmjs.org/@booga/bground/-/bground-0.2.0.tgz","fileCount":5,"unpackedSize":6303,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIElAD/FB1EteCC1uTjtNh7dTWqjD7ruDwaxNJCnadvFdAiBJQTovf5XMXkPwQ3KAFrKU5ahhdjTjGwu6J6fOcIvwow=="}]},"_npmUser":{"name":"dreaktor","email":"me@dreaktor.com"},"directories":{},"maintainers":[{"name":"dreaktor","email":"me@dreaktor.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bground_0.2.0_1781980187378_0.4454461814200932"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-12T12:50:23.349Z","modified":"2026-06-20T18:29:47.626Z","0.1.1":"2026-06-12T12:50:23.790Z","0.2.0":"2026-06-20T18:29:47.492Z"},"bugs":{"url":"https://github.com/bvasilenko/bGround/issues"},"license":"MIT","homepage":"https://github.com/bvasilenko/bGround#readme","keywords":["cli","agent","prompt","lookup"],"repository":{"type":"git","url":"git+https://github.com/bvasilenko/bGround.git"},"description":"Prompt lookup tool. Agent names a claim type from a fixed list; bground returns the prompt for that claim type. The prompt tells the agent how to check the claim against supplied evidence.","maintainers":[{"name":"dreaktor","email":"me@dreaktor.com"}],"readme":"# bground\n\nFor agents that make claims. Before your AI coding agent writes \"the parser handles UTF-8\" or \"we cache for 5 minutes\", bground verifies that claim against the evidence the agent cited: a function signature, a test case, a config row, a doc paragraph. If the evidence does not back the claim, bground emits an UNGROUNDED directive that tells the agent which evidence to cite or which claim to drop. The claim taxonomy is closed (16 types); the prompt library that powers grounding evolves continuously via empirical-lift evaluation, so the same `bground verify` invocation gets stricter at catching ungrounded claims as the corpus matures.\n\n**v0.2 note:** the directive library shipped in this release is a hand-authored seed corpus -- fixture material that covers the full 16-variant claim taxonomy. An empirically evolved corpus ships in a later release.\n\n\nPrompt lookup tool. Agent names a claim type from a fixed list; bground returns the prompt for that claim type. The prompt tells the agent how to check the claim against supplied evidence.\n\nBuilt for agentic loops. Parses a typed claim, takes supplied evidence, writes a verdict on stdout, exits with a discriminating code so the calling agent can branch.\n\n```\nbground verify <claim>            check a claim against supplied evidence; exit 0 / 1 / 2 / 64\nbground claim-types               list the 16 supported claim-type identifiers\nbground init                      scaffold a manifest in the current directory\nbground update                    self-update to the latest published version\nbground tail                      stream recent verdict transcripts\nbground explain                   print taxonomy + exit-code reference\n```\n\nExit code contract: `0` claim grounded, `1` claim NOT grounded, `2` internal error, `64` malformed input.\n\n## Install\n\n```sh\ncargo install --git https://github.com/bvasilenko/bGround\n```\n\n## Use\n\n```sh\nbground verify \"file-exists:README.md:README must exist\" \\\n    --evidence readme=$(test -f README.md && echo present || echo absent)\n# stdout: GROUNDED\n# exit: 0\n\nbground verify \"value-equals:VERSION:0.1.0\" \\\n    --evidence VERSION=0.2.0\n# stdout: UNGROUNDED\n# exit: 1\n```\n\nThe `<claim>` argument is parsed as `<claim-type>:<target>:<assertion>`. Supply evidence with repeatable `--evidence <id>=<value>` flags. Optional flags: `--manifest <path>`, `--json`, `--quiet`, `--reason <text>`.\n\n## Claim taxonomy\n\nClosed 16-variant `ClaimType` enum. The taxonomy is fixed at this version; widening lands in a later version.\n\n| Category | Variants |\n|---|---|\n| Existence | `file-exists`, `fn-defined`, `dependency-installed` |\n| Equality | `value-equals`, `state-equals`, `fn-signature` |\n| Runtime | `fn-return-type`, `url-returns`, `cmd-output-matches`, `behavior` |\n| Coherence | `coherent-refactor`, `coherent-migration`, `coherent-spec-impl`, `coherent-contract`, `coherent-test-cover`, `coherent-dep-upgrade` |\n\n`bground claim-types` prints the full list.\n\n## Environment variables\n\n| Variable | Purpose | Default |\n|---|---|---|\n| `BSUITE_UPDATE_BASE_URL` | Base URL for the `bground update` manifest endpoint | placeholder (update will fail without a real endpoint) |\n| `BSUITE_TRANSCRIPT_DIR` | Override the transcript directory path | platform XDG/AppSupport/LocalAppData default |\n| `BSUITE_TRANSCRIPT_RETENTION_DAYS` | Transcript retention window in days | 90 |\n| `BSUITE_HOST_CONTEXT` | CMS adapter host context tag (set by adapters; not for manual use) | `l2a` |\n\n## License\n\nMIT.\n","readmeFilename":"README.md"}