Add SpiderBrain understanding layer

.spiderbrain/.gitattributes

@@ -0,0 +1,2 @@
+# SpiderBrain understanding set: byte-exact files, never EOL-converted.
+* -text

.spiderbrain/AGENTS.block.md

@@ -0,0 +1,29 @@
+<!-- spiderbrain:start v=1 fp=667821695e6b8238 commit=6a37c2abded9 -->
+## 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 <path>     # what a change to <path> 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 <path>` (the decision behind a file).
+
+Deterministic: regenerates byte-identically from commit 6a37c2abded9 (fingerprint 667821695e6b8238). Do not hand-edit between the markers.
+<!-- spiderbrain:end -->

.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
+}

.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":""}

AGENTS.md

@@ -0,0 +1,29 @@
+<!-- spiderbrain:start v=1 fp=667821695e6b8238 commit=6a37c2abded9 -->
+## 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 <path>     # what a change to <path> 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 <path>` (the decision behind a file).
+
+Deterministic: regenerates byte-identically from commit 6a37c2abded9 (fingerprint 667821695e6b8238). Do not hand-edit between the markers.
+<!-- spiderbrain:end -->