From febbf1d61000c094abd8ccd2b7b4ca8ddd33f4de Mon Sep 17 00:00:00 2001 From: "spiderbrainai[bot]" <301081152+spiderbrainai[bot]@users.noreply.github.com> Date: Sun, 19 Jul 2026 00:40:09 +0000 Subject: [PATCH] Add SpiderBrain understanding layer Co-Authored-By: core --- .spiderbrain/.gitattributes | 2 ++ .spiderbrain/AGENTS.block.md | 29 +++++++++++++++++++ .spiderbrain/manifest.json | 33 ++++++++++++++++++++++ .spiderbrain/structure.ndjson | 53 +++++++++++++++++++++++++++++++++++ AGENTS.md | 29 +++++++++++++++++++ 5 files changed, 146 insertions(+) create mode 100644 .spiderbrain/.gitattributes create mode 100644 .spiderbrain/AGENTS.block.md create mode 100644 .spiderbrain/manifest.json create mode 100644 .spiderbrain/structure.ndjson create mode 100644 AGENTS.md diff --git a/.spiderbrain/.gitattributes b/.spiderbrain/.gitattributes new file mode 100644 index 0000000..267e608 --- /dev/null +++ b/.spiderbrain/.gitattributes @@ -0,0 +1,2 @@ +# SpiderBrain understanding set: byte-exact files, never EOL-converted. +* -text diff --git a/.spiderbrain/AGENTS.block.md b/.spiderbrain/AGENTS.block.md new file mode 100644 index 0000000..8b84710 --- /dev/null +++ b/.spiderbrain/AGENTS.block.md @@ -0,0 +1,29 @@ + +## Repo understanding (SpiderBrain) + +This repo carries a committed brain in `.spiderbrain/`: a deterministic, source-free map of its +structure, dependencies, and blast radius (53 files, 43 edges). Consult it before +reading files, to know what matters and what a change reaches. + +Fastest use (an MCP server for this repo, no SpiderBrain install, no account): + npx spiderbrain mcp +One-off: + npx spiderbrain blast # what a change to reaches + npx spiderbrain keystones # the load-bearing files + +Keystones (top by reach, precomputed so you get value without installing anything): +- corpora/micro-app/src/shared/config.ts (reaches 9 files) +- corpora/micro-app/src/shared/http.ts (reaches 7 files) +- corpora/micro-app/src/shared/events.ts (reaches 4 files) +- lib/metrics.mjs (reaches 4 files) +- benchmarks/impact-closure/lib/answer.mjs (reaches 3 files) +- benchmarks/impact-closure/lib/manifest.mjs (reaches 3 files) +- benchmarks/impact-closure/lib/run-record.mjs (reaches 3 files) +- benchmarks/impact-closure/lib/scoring.mjs (reaches 3 files) + +The why (decisions, reasoning, always-fresh scores) is the cloud layer. Set SPIDERBRAIN_API_KEY +(get one at https://spiderbrain.ai/dashboard?tab=keys) and any command above also returns fresh +scores, semantic search, and `why ` (the decision behind a file). + +Deterministic: regenerates byte-identically from commit 6a37c2abded9 (fingerprint 667821695e6b8238). Do not hand-edit between the markers. + diff --git a/.spiderbrain/manifest.json b/.spiderbrain/manifest.json new file mode 100644 index 0000000..275b200 --- /dev/null +++ b/.spiderbrain/manifest.json @@ -0,0 +1,33 @@ +{ + "schemaVersion": 1, + "variant": "public", + "privacy": "plain-paths", + "engineVersion": "v5", + "scoredFrom": "6a37c2abded91b21b3ab9be2854be89a07dc4ca6", + "repo": { + "name": "aabhisrv/contextbenchmark", + "commit": "6a37c2abded91b21b3ab9be2854be89a07dc4ca6" + }, + "counts": { + "files": 53, + "edges": 43, + "clusters": 8, + "masters": 8 + }, + "graphFingerprint": "667821695e6b8238", + "fileHashes": { + "structure.ndjson": "667821695e6b82381f676e9338d1258c324df24bac8310f0eff2cd05a4c862a7", + "AGENTS.block.md": "04f2eee154834bd5964e48fed8a966461a7c5332d5e5f691576f899e69f1d280" + }, + "benchmark": { + "standard": "context-trust-level", + "url": "https://contextbenchmark.com", + "note": "CTL is measured, never hardcoded; see the published run." + }, + "ownership": { + "owner": "repo", + "license": "inherits-repo", + "generator": "spiderbrain" + }, + "attribution": null +} diff --git a/.spiderbrain/structure.ndjson b/.spiderbrain/structure.ndjson new file mode 100644 index 0000000..6937638 --- /dev/null +++ b/.spiderbrain/structure.ndjson @@ -0,0 +1,53 @@ +{"blastRadius":0,"cluster":"shell","contentHash":"","dependsOn":[],"id":".github/workflows/cross-machine.yml","isMaster":false,"kind":"content","layer":"gamma","master":"package.json","role":""} +{"blastRadius":0,"cluster":"shell","contentHash":"","dependsOn":[],"id":"CONTRIBUTING.md","isMaster":false,"kind":"content","layer":"gamma","master":"package.json","role":""} +{"blastRadius":0,"cluster":"shell","contentHash":"","dependsOn":[],"id":"README.md","isMaster":false,"kind":"content","layer":"gamma","master":"package.json","role":""} +{"blastRadius":0,"cluster":"adapters","contentHash":"","dependsOn":[],"id":"adapters/ADAPTER.md","isMaster":false,"kind":"content","layer":"gamma","master":"adapters/bm25.mjs","role":""} +{"blastRadius":0,"cluster":"adapters","contentHash":"8685c22bb69f","dependsOn":["lib/metrics.mjs"],"id":"adapters/bm25.mjs","isMaster":true,"kind":"code","layer":"theta","master":"adapters/bm25.mjs","role":""} +{"blastRadius":0,"cluster":"adapters","contentHash":"8d71f25311e1","dependsOn":["lib/metrics.mjs"],"id":"adapters/emb-minilm.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"lib/metrics.mjs","role":""} +{"blastRadius":0,"cluster":"adapters","contentHash":"110af446b64e","dependsOn":["lib/metrics.mjs"],"id":"adapters/spiderbrain.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"lib/metrics.mjs","role":""} +{"blastRadius":0,"cluster":"benchmarks","contentHash":"","dependsOn":[],"id":"benchmarks/impact-closure/README.md","isMaster":false,"kind":"content","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":2,"cluster":"benchmarks","contentHash":"e400015cc439","dependsOn":[],"id":"benchmarks/impact-closure/arms/mock-agent.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":2,"cluster":"benchmarks","contentHash":"4a2908604f3c","dependsOn":[],"id":"benchmarks/impact-closure/arms/real-agent.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":3,"cluster":"benchmarks","contentHash":"9f7db91c0e36","dependsOn":[],"id":"benchmarks/impact-closure/lib/answer.mjs","isMaster":true,"kind":"code","layer":"theta","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":3,"cluster":"benchmarks","contentHash":"90f473121ab5","dependsOn":[],"id":"benchmarks/impact-closure/lib/manifest.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":3,"cluster":"benchmarks","contentHash":"7202e01776a0","dependsOn":[],"id":"benchmarks/impact-closure/lib/run-record.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":3,"cluster":"benchmarks","contentHash":"bfe62ddc069d","dependsOn":[],"id":"benchmarks/impact-closure/lib/scoring.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":1,"cluster":"benchmarks","contentHash":"6440bee67ec1","dependsOn":["benchmarks/impact-closure/arms/mock-agent.mjs","benchmarks/impact-closure/arms/real-agent.mjs","benchmarks/impact-closure/lib/answer.mjs","benchmarks/impact-closure/lib/manifest.mjs","benchmarks/impact-closure/lib/run-record.mjs","benchmarks/impact-closure/lib/scoring.mjs"],"id":"benchmarks/impact-closure/run.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":0,"cluster":"benchmarks","contentHash":"2b69a74e007e","dependsOn":["benchmarks/impact-closure/lib/answer.mjs","benchmarks/impact-closure/lib/manifest.mjs","benchmarks/impact-closure/lib/run-record.mjs","benchmarks/impact-closure/lib/scoring.mjs"],"id":"benchmarks/impact-closure/test/lib.test.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":0,"cluster":"benchmarks","contentHash":"303215c929b6","dependsOn":["benchmarks/impact-closure/arms/mock-agent.mjs","benchmarks/impact-closure/lib/manifest.mjs","benchmarks/impact-closure/run.mjs"],"id":"benchmarks/impact-closure/test/pipeline.test.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"benchmarks/impact-closure/lib/answer.mjs","role":""} +{"blastRadius":0,"cluster":"shell","contentHash":"84e7649dc269","dependsOn":["lib/corpus.mjs","lib/fingerprint.mjs","lib/metrics.mjs"],"id":"contextbenchmark.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"lib/metrics.mjs","role":""} +{"blastRadius":0,"cluster":"corpora","contentHash":"8b1ccaec416c","dependsOn":[],"id":"corpora/micro-app/queries.json","isMaster":false,"kind":"config","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":0,"cluster":"corpora","contentHash":"1f4b0ab0563e","dependsOn":["corpora/micro-app/src/auth/session.ts","corpora/micro-app/src/shared/config.ts","corpora/micro-app/src/shared/http.ts"],"id":"corpora/micro-app/src/auth/login.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":1,"cluster":"corpora","contentHash":"0291b4999b39","dependsOn":["corpora/micro-app/src/shared/config.ts","corpora/micro-app/src/shared/events.ts"],"id":"corpora/micro-app/src/auth/session.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":1,"cluster":"corpora","contentHash":"338d45ab3a13","dependsOn":["corpora/micro-app/src/catalog/products.ts","corpora/micro-app/src/shared/config.ts","corpora/micro-app/src/shared/events.ts"],"id":"corpora/micro-app/src/cart/cart.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":0,"cluster":"corpora","contentHash":"5e32e43fe99d","dependsOn":["corpora/micro-app/src/cart/cart.ts"],"id":"corpora/micro-app/src/cart/discounts.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":3,"cluster":"corpora","contentHash":"3c41e47a86d2","dependsOn":["corpora/micro-app/src/shared/config.ts","corpora/micro-app/src/shared/http.ts"],"id":"corpora/micro-app/src/catalog/products.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":0,"cluster":"corpora","contentHash":"fb88402d480e","dependsOn":["corpora/micro-app/src/catalog/products.ts","corpora/micro-app/src/shared/config.ts","corpora/micro-app/src/shared/http.ts"],"id":"corpora/micro-app/src/catalog/search.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":1,"cluster":"corpora","contentHash":"20c354f8b1ef","dependsOn":["corpora/micro-app/src/shared/config.ts","corpora/micro-app/src/shared/http.ts"],"id":"corpora/micro-app/src/payments/gateway.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":0,"cluster":"corpora","contentHash":"b6e694741275","dependsOn":["corpora/micro-app/src/payments/gateway.ts","corpora/micro-app/src/shared/config.ts","corpora/micro-app/src/shared/http.ts"],"id":"corpora/micro-app/src/payments/refunds.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":9,"cluster":"corpora","contentHash":"a790e54131da","dependsOn":[],"id":"corpora/micro-app/src/shared/config.ts","isMaster":true,"kind":"code","layer":"theta","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":4,"cluster":"corpora","contentHash":"adde2730a699","dependsOn":["corpora/micro-app/src/shared/config.ts"],"id":"corpora/micro-app/src/shared/events.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":7,"cluster":"corpora","contentHash":"58b856c71d94","dependsOn":[],"id":"corpora/micro-app/src/shared/http.ts","isMaster":false,"kind":"code","layer":"gamma","master":"corpora/micro-app/src/shared/config.ts","role":""} +{"blastRadius":1,"cluster":"lib","contentHash":"1801645aa4ff","dependsOn":[],"id":"lib/corpus.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"lib/metrics.mjs","role":""} +{"blastRadius":2,"cluster":"lib","contentHash":"b4edb68ff159","dependsOn":[],"id":"lib/fingerprint.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"lib/metrics.mjs","role":""} +{"blastRadius":4,"cluster":"lib","contentHash":"6721c0a81d37","dependsOn":[],"id":"lib/metrics.mjs","isMaster":true,"kind":"code","layer":"theta","master":"lib/metrics.mjs","role":""} +{"blastRadius":0,"cluster":"shell","contentHash":"22eadd5a2cb2","dependsOn":[],"id":"package.json","isMaster":true,"kind":"config","layer":"theta","master":"package.json","role":""} +{"blastRadius":0,"cluster":"results","contentHash":"b8e77350176d","dependsOn":[],"id":"results/bm25.micro-app.win32-x64.fingerprint.json","isMaster":true,"kind":"config","layer":"theta","master":"results/bm25.micro-app.win32-x64.fingerprint.json","role":""} +{"blastRadius":0,"cluster":"results","contentHash":"88b732fb7c97","dependsOn":[],"id":"results/emb-minilm.micro-app.win32-x64.fingerprint.json","isMaster":false,"kind":"config","layer":"gamma","master":"results/bm25.micro-app.win32-x64.fingerprint.json","role":""} +{"blastRadius":0,"cluster":"results","contentHash":"1e2e85fc4110","dependsOn":[],"id":"results/run-micro-app-bm25+spiderbrain.json","isMaster":false,"kind":"config","layer":"gamma","master":"results/bm25.micro-app.win32-x64.fingerprint.json","role":""} +{"blastRadius":0,"cluster":"results","contentHash":"64c5a5d98d93","dependsOn":[],"id":"results/run-micro-app-bm25.json","isMaster":false,"kind":"config","layer":"gamma","master":"results/bm25.micro-app.win32-x64.fingerprint.json","role":""} +{"blastRadius":0,"cluster":"results","contentHash":"3f48ff582868","dependsOn":[],"id":"results/run-micro-app-emb-minilm.json","isMaster":false,"kind":"config","layer":"gamma","master":"results/bm25.micro-app.win32-x64.fingerprint.json","role":""} +{"blastRadius":0,"cluster":"results","contentHash":"ed3fb5600801","dependsOn":[],"id":"results/run-micro-app-spiderbrain.json","isMaster":false,"kind":"config","layer":"gamma","master":"results/bm25.micro-app.win32-x64.fingerprint.json","role":""} +{"blastRadius":0,"cluster":"results","contentHash":"962183072609","dependsOn":[],"id":"results/spiderbrain.micro-app.win32-x64.fingerprint.json","isMaster":false,"kind":"config","layer":"gamma","master":"results/bm25.micro-app.win32-x64.fingerprint.json","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"3ccdc9a8865c","dependsOn":[],"id":"site/public/404.html","isMaster":false,"kind":"html","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"7372ef6f83f6","dependsOn":[],"id":"site/public/index.html","isMaster":false,"kind":"html","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"","dependsOn":[],"id":"site/public/llms-full.txt","isMaster":false,"kind":"content","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"","dependsOn":[],"id":"site/public/llms.txt","isMaster":false,"kind":"content","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"b5acbb79d060","dependsOn":[],"id":"site/public/results.json","isMaster":false,"kind":"config","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"","dependsOn":[],"id":"site/public/robots.txt","isMaster":false,"kind":"content","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"","dependsOn":[],"id":"site/public/sitemap.xml","isMaster":false,"kind":"content","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":2,"cluster":"site","contentHash":"78eb72f6abc3","dependsOn":[],"id":"site/src/canonical.js","isMaster":true,"kind":"code","layer":"theta","master":"site/src/canonical.js","role":""} +{"blastRadius":1,"cluster":"site","contentHash":"34c90b0c6565","dependsOn":["site/src/canonical.js"],"id":"site/src/index.js","isMaster":false,"kind":"code","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"fdfc95a19bc7","dependsOn":["site/src/canonical.js","site/src/index.js"],"id":"site/test/canonical.test.mjs","isMaster":false,"kind":"code","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"site","contentHash":"","dependsOn":[],"id":"site/wrangler.toml","isMaster":false,"kind":"content","layer":"gamma","master":"site/src/canonical.js","role":""} +{"blastRadius":0,"cluster":"test","contentHash":"0f0fe6c85467","dependsOn":["lib/fingerprint.mjs"],"id":"test/compare.test.mjs","isMaster":true,"kind":"code","layer":"theta","master":"test/compare.test.mjs","role":""} diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8b84710 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,29 @@ + +## Repo understanding (SpiderBrain) + +This repo carries a committed brain in `.spiderbrain/`: a deterministic, source-free map of its +structure, dependencies, and blast radius (53 files, 43 edges). Consult it before +reading files, to know what matters and what a change reaches. + +Fastest use (an MCP server for this repo, no SpiderBrain install, no account): + npx spiderbrain mcp +One-off: + npx spiderbrain blast # what a change to reaches + npx spiderbrain keystones # the load-bearing files + +Keystones (top by reach, precomputed so you get value without installing anything): +- corpora/micro-app/src/shared/config.ts (reaches 9 files) +- corpora/micro-app/src/shared/http.ts (reaches 7 files) +- corpora/micro-app/src/shared/events.ts (reaches 4 files) +- lib/metrics.mjs (reaches 4 files) +- benchmarks/impact-closure/lib/answer.mjs (reaches 3 files) +- benchmarks/impact-closure/lib/manifest.mjs (reaches 3 files) +- benchmarks/impact-closure/lib/run-record.mjs (reaches 3 files) +- benchmarks/impact-closure/lib/scoring.mjs (reaches 3 files) + +The why (decisions, reasoning, always-fresh scores) is the cloud layer. Set SPIDERBRAIN_API_KEY +(get one at https://spiderbrain.ai/dashboard?tab=keys) and any command above also returns fresh +scores, semantic search, and `why ` (the decision behind a file). + +Deterministic: regenerates byte-identically from commit 6a37c2abded9 (fingerprint 667821695e6b8238). Do not hand-edit between the markers. +