{"_id":"@bendyline/gezel-knowledge","_rev":"6-f35fe8735fd447bac6c70a4de7b7911d","name":"@bendyline/gezel-knowledge","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.6":{"name":"@bendyline/gezel-knowledge","version":"1.0.6","keywords":["gezel","ai","agents","local-first","knowledge","rag","sqlite-vec"],"author":{"name":"Bendyline","email":"support@bendyline.com"},"license":"MIT","_id":"@bendyline/gezel-knowledge@1.0.6","maintainers":[{"name":"bendylinesupport","email":"admin@bendyline.com"}],"homepage":"https://github.com/bendyline/gezel","bugs":{"url":"https://github.com/bendyline/gezel/issues"},"dist":{"shasum":"d94a7a5a0e725266d93dc74ae7b8de75be02ec67","tarball":"https://registry.npmjs.org/@bendyline/gezel-knowledge/-/gezel-knowledge-1.0.6.tgz","fileCount":5,"integrity":"sha512-O8AOFR69C7GzynH8K+pt6tRwv1LY4UnJ85DaaPzmwThrnKDBcrfGkianfIGahs2vIqfnXpltf1Hvy1oa3BKmLQ==","signatures":[{"sig":"MEUCIQCae1p2srMUra17R15G2KNQBa+BCHGQd7dLEbOPNMJjHgIgAP8H0UrPTmvS+sPJUwriAuuVWXLE9lEPSNauNGosePw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":110106},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit"},"_npmUser":{"name":"bendylinesupport","email":"admin@bendyline.com"},"repository":{"url":"git+https://github.com/bendyline/gezel.git","type":"git","directory":"packages/knowledge"},"description":"Gezel knowledge catalogs: the .gezk compiler, archive safety, read-only reader, routing, and signatures.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","yazl":"^3.3.1","yauzl":"^3.4.0","sqlite-vec":"^0.1.9","@bendyline/gezel":"1.0.6"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","vitest":"^4.1.10","typescript":"^6.0.3","@types/node":"^24.10.1","@types/yazl":"^2.4.6","@types/yauzl":"^2.10.3","@huggingface/transformers":"^3.8.1"},"peerDependencies":{"@huggingface/transformers":"^3.8.1"},"peerDependenciesMeta":{"@huggingface/transformers":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/gezel-knowledge_1.0.6_1787376482424_0.7275879393449369","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@bendyline/gezel-knowledge","version":"1.0.7","keywords":["gezel","ai","agents","local-first","knowledge","rag","sqlite-vec"],"author":{"name":"Bendyline","email":"support@bendyline.com"},"license":"MIT","_id":"@bendyline/gezel-knowledge@1.0.7","maintainers":[{"name":"bendylinesupport","email":"admin@bendyline.com"}],"homepage":"https://github.com/bendyline/gezel","bugs":{"url":"https://github.com/bendyline/gezel/issues"},"dist":{"shasum":"7b1517b502ae08e90fbd522f5a75460d9961e9a7","tarball":"https://registry.npmjs.org/@bendyline/gezel-knowledge/-/gezel-knowledge-1.0.7.tgz","fileCount":5,"integrity":"sha512-T3UqMZrsc+UJBKIxg/sWT2G7SApnpHDDd/P/Z7YmMmLpaB57wu0RAThnQzAIuV51jLnC20utkRJ5eDPSaTzLOA==","signatures":[{"sig":"MEUCIHdPIxJC4XG4WfSBlGUrHpakqVP5+nRiVlA2V1EahB9AAiEAk5yj0n6fZZdenLTEAOY6/pPbWTkIFdYB0NpBwZMrCSY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bendyline%2fgezel-knowledge@1.0.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":124207},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:a8eb5aaa-42af-48c7-8808-f24a2e20a151"}},"repository":{"url":"git+https://github.com/bendyline/gezel.git","type":"git","directory":"packages/knowledge"},"description":"Gezel knowledge catalogs: the .gezk compiler, archive safety, read-only reader, routing, and signatures.","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","yazl":"^3.3.1","yauzl":"^3.4.0","sqlite-vec":"^0.1.9","@bendyline/gezel":"1.0.7"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","vitest":"^4.1.10","typescript":"^6.0.3","@types/node":"^24.10.1","@types/yazl":"^2.4.6","@types/yauzl":"^2.10.3","@huggingface/transformers":"^3.8.1"},"peerDependencies":{"@huggingface/transformers":"^3.8.1"},"peerDependenciesMeta":{"@huggingface/transformers":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/gezel-knowledge_1.0.7_1788305227712_0.42151559617495793","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@bendyline/gezel-knowledge","version":"1.1.0","keywords":["gezel","ai","agents","local-first","knowledge","rag","gezk"],"author":{"name":"Bendyline","email":"support@bendyline.com"},"license":"MIT","_id":"@bendyline/gezel-knowledge@1.1.0","maintainers":[{"name":"bendylinesupport","email":"admin@bendyline.com"}],"homepage":"https://github.com/bendyline/gezel","bugs":{"url":"https://github.com/bendyline/gezel/issues"},"dist":{"shasum":"1c4ef6a7584ac04d98b4e0c6778598ac622ea939","tarball":"https://registry.npmjs.org/@bendyline/gezel-knowledge/-/gezel-knowledge-1.1.0.tgz","fileCount":5,"integrity":"sha512-uLqo+8TfUIuhjwkl0EvR39YOx/nRSIcnVfbnTZAeIMeATcASX4Ni6yP2/EljTEVSnyjIUJxPQycwvQ1de8n6CA==","signatures":[{"sig":"MEYCIQCqSdJTE95pZ3uAWXr5wmxNGez8wM5m59r5VyvtdZJGOwIhAJ/DLhHXKcoQnu9WROL+8GZMHRJIVVE1Q3aJpjaYxWCZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bendyline%2fgezel-knowledge@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":153183},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit","build-conformance":"tsx scripts/build-conformance.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:a8eb5aaa-42af-48c7-8808-f24a2e20a151"}},"repository":{"url":"git+https://github.com/bendyline/gezel.git","type":"git","directory":"packages/knowledge"},"description":"Gezel knowledge catalogs: the .gezk compiler, archive safety, read-only reader, routing, and signatures.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","yazl":"^3.3.1","yauzl":"^3.4.0","@bendyline/gezk":"1.0.0"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.1","tsup":"^8.5.1","vitest":"^4.1.10","typescript":"^6.0.3","@types/node":"^24.10.1","@types/yazl":"^2.4.6","@types/yauzl":"^2.10.3","@huggingface/transformers":"^3.8.1"},"peerDependencies":{"@huggingface/transformers":"^3.8.1"},"peerDependenciesMeta":{"@huggingface/transformers":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/gezel-knowledge_1.1.0_1788585421945_0.730900694021819","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@bendyline/gezel-knowledge","version":"1.1.1","keywords":["gezel","ai","agents","local-first","knowledge","rag","gezk"],"author":{"name":"Bendyline","email":"support@bendyline.com"},"license":"MIT","_id":"@bendyline/gezel-knowledge@1.1.1","maintainers":[{"name":"bendylinesupport","email":"admin@bendyline.com"}],"homepage":"https://github.com/bendyline/gezel","bugs":{"url":"https://github.com/bendyline/gezel/issues"},"dist":{"shasum":"5fdca5c784114073b6349f377a338b8658f8ad14","tarball":"https://registry.npmjs.org/@bendyline/gezel-knowledge/-/gezel-knowledge-1.1.1.tgz","fileCount":5,"integrity":"sha512-R1BK51zbEhqRrj9V9UXphR3w1T+OVHwd0/nitio9XfLvROUIgILZW8gw0WXb5WKt11DOWbdkjMzbjZb5XXo1cQ==","signatures":[{"sig":"MEQCIGzXlkRUDmBSmKwFW8AfdH+/X30wKemeu1M89m4/UjaGAiA2u2JNFqxd7Z5PahN1Jf4EvFwzMWdqthUzlYzgPjf5OA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bendyline%2fgezel-knowledge@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":211993},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit","build-conformance":"tsx scripts/build-conformance.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:a8eb5aaa-42af-48c7-8808-f24a2e20a151"}},"repository":{"url":"git+https://github.com/bendyline/gezel.git","type":"git","directory":"packages/knowledge"},"description":"Gezel knowledge catalogs: the .gezk compiler, archive safety, read-only reader, routing, and signatures.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","yaml":"^2.9.0","yazl":"^3.3.1","yauzl":"^3.4.0","@bendyline/gezk":"1.0.1"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.1","tsup":"^8.5.1","vitest":"^4.1.10","typescript":"^6.0.3","@types/node":"^24.10.1","@types/yazl":"^2.4.6","@types/yauzl":"^2.10.3","@huggingface/transformers":"^3.8.1"},"peerDependencies":{"@huggingface/transformers":"^3.8.1"},"peerDependenciesMeta":{"@huggingface/transformers":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/gezel-knowledge_1.1.1_1788873586358_0.35939400506959895","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@bendyline/gezel-knowledge","version":"1.1.2","keywords":["gezel","ai","agents","local-first","knowledge","rag","gezk"],"author":{"name":"Bendyline","email":"support@bendyline.com"},"license":"MIT","_id":"@bendyline/gezel-knowledge@1.1.2","maintainers":[{"name":"bendylinesupport","email":"admin@bendyline.com"}],"homepage":"https://github.com/bendyline/gezel","bugs":{"url":"https://github.com/bendyline/gezel/issues"},"dist":{"shasum":"084790c08a8dad4a6ba67065948fef4f13de26c2","tarball":"https://registry.npmjs.org/@bendyline/gezel-knowledge/-/gezel-knowledge-1.1.2.tgz","fileCount":5,"integrity":"sha512-h2m3psxf4eEF5hbO7F3FIIQU2G4AjgORRb9WHACpawlFiiGQ3smx69k6+MyMUG1MAamnZdHDqsJDmE+c2z2arg==","signatures":[{"sig":"MEUCIQCJDSV6AZQ10Xf/nRS5aFFMBmWyhNBxltrBj/TskW41SQIgamVxhO+IZ4xYD7+oI68ZTGj9eh87eyn94ZExrK1trNs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIFCrJBYD/g3DYWr3MTGUgyInZznSiwdr8oAip5zcTRo4AiEA85dLD3h3aYvlRiKIoQ1GtEb8CF7M9fjLkLiU6Rmuh04=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bendyline%2fgezel-knowledge@1.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":224996},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit","build-conformance":"tsx scripts/build-conformance.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:a8eb5aaa-42af-48c7-8808-f24a2e20a151"}},"repository":{"url":"git+https://github.com/bendyline/gezel.git","type":"git","directory":"packages/knowledge"},"description":"Gezel knowledge catalogs: the .gezk compiler, archive safety, read-only reader, routing, and signatures.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","yaml":"^2.9.0","yazl":"^3.3.1","yauzl":"^3.4.0","@bendyline/gezk":"1.0.2"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.1","tsup":"^8.5.1","vitest":"^4.1.10","typescript":"^6.0.3","@types/node":"^24.10.1","@types/yazl":"^2.4.6","@types/yauzl":"^2.10.3","@huggingface/transformers":"^3.8.1"},"peerDependencies":{"@huggingface/transformers":"^3.8.1"},"peerDependenciesMeta":{"@huggingface/transformers":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/gezel-knowledge_1.1.2_1789773100179_0.5145137189636977","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"_id":"@bendyline/gezel-knowledge@1.2.0","bugs":{"url":"https://github.com/bendyline/gezel/issues"},"dist":{"shasum":"b61eb82bf76f346dfeb1360d18fd04477b8a74a8","tarball":"https://registry.npmjs.org/@bendyline/gezel-knowledge/-/gezel-knowledge-1.2.0.tgz","fileCount":5,"integrity":"sha512-dAwyEeL6jWNwGovuS3+UBY7/BDTZXlCPv3hWAQAkx9Tcfo5hpIzrS5hqduHE+snprq3j4eRtD6sMOjB7pUidNw==","signatures":[{"sig":"MEQCIDYIsrvbKHlZOP7FOnAnQ+LQXxVWC3qJ3eJ5XO4wK3PKAiA9z3ezkuEF4Mh9ubTR9b5dpEBlAVlGFrwqbONRaYIKzQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD+RPGsB97OmqqlNVJdTSRmUPfhI6STDmbdNfTJ8sVkSQIhANXyV18C6OZXc0C2qssDAa5x7+OTiIE6iFUdaPlo+1ZB"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bendyline%2fgezel-knowledge@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":229006},"main":"./dist/index.js","name":"@bendyline/gezel-knowledge","type":"module","types":"./dist/index.d.ts","author":{"name":"Bendyline","email":"support@bendyline.com"},"module":"./dist/index.js","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"license":"MIT","scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit","build-conformance":"tsx scripts/build-conformance.ts"},"version":"1.2.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"a8eb5aaa-42af-48c7-8808-f24a2e20a151"}},"homepage":"https://github.com/bendyline/gezel","keywords":["gezel","ai","agents","local-first","knowledge","rag","gezk"],"repository":{"url":"git+https://github.com/bendyline/gezel.git","type":"git","directory":"packages/knowledge"},"description":"Gezel knowledge catalogs: the .gezk compiler, archive safety, read-only reader, routing, and signatures.","directories":{},"maintainers":[{"name":"bendylinesupport","email":"admin@bendyline.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.4.3","yaml":"^2.9.0","yazl":"^3.3.1","yauzl":"^3.4.0","@bendyline/gezk":"1.0.2"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.1","tsup":"^8.5.1","vitest":"^4.1.10","typescript":"^6.0.3","@types/node":"^24.10.1","@types/yazl":"^2.4.6","@types/yauzl":"^2.10.3","@huggingface/transformers":"^3.8.1"},"peerDependencies":{"@huggingface/transformers":"^3.8.1"},"peerDependenciesMeta":{"@huggingface/transformers":{"optional":true}},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gezel-knowledge_1.2.0_1790787042070_0.6394093061474937"}}},"time":{"created":"2026-08-22T05:28:02.307Z","modified":"2026-09-30T16:50:42.556Z","1.0.6":"2026-08-22T05:28:02.581Z","1.0.7":"2026-09-01T23:27:07.864Z","1.1.0":"2026-09-05T05:17:02.102Z","1.1.1":"2026-09-08T13:19:46.492Z","1.1.2":"2026-09-18T23:11:40.268Z","1.2.0":"2026-09-30T16:50:42.154Z"},"bugs":{"url":"https://github.com/bendyline/gezel/issues"},"author":{"name":"Bendyline","email":"support@bendyline.com"},"license":"MIT","homepage":"https://github.com/bendyline/gezel","keywords":["gezel","ai","agents","local-first","knowledge","rag","gezk"],"repository":{"url":"git+https://github.com/bendyline/gezel.git","type":"git","directory":"packages/knowledge"},"description":"Gezel knowledge catalogs: the .gezk compiler, archive safety, read-only reader, routing, and signatures.","maintainers":[{"name":"bendylinesupport","email":"admin@bendyline.com"}],"readme":"# @bendyline/gezel-knowledge\n\nThe `.gezk` knowledge-catalog toolchain for\n[gezel](https://github.com/bendyline/gezel): a deterministic compiler, a\nverified archive reader, and a read-only catalog handle with two-stage\n`bit+int8` retrieval. One format and one runtime serve a 200-document\npersonal reference and a 2,000,000-document Wikipedia-class corpus.\n\n```bash\nnpm install @bendyline/gezel-knowledge\n```\n\n## What a `.gezk` is\n\nAn open format (format version 0.6, preliminary until format 1.0; 0.5\narchives still open): a ZIP whose first entry is\nthe stored `mimetype` magic (`application/vnd.gezk+zip`), then\n`manifest.json`, `README.md`, `LICENSES/`, a `router.db` (topics, document\ndirectory, brotli bodies, routing centroids) and shard SQLite databases with\nFTS5 and quantized vectors in plain BLOB tables. Nothing beyond stock SQLite\nis needed to read one. The format definitions are the separate\n[`@bendyline/gezk`](https://www.npmjs.com/package/@bendyline/gezk) package,\nwhose npm version is independent of the format version it writes;\nthe specification, JSON Schemas, conformance fixtures and a Python reference\nreader live in [bendyline/gezk](https://github.com/bendyline/gezk).\n\n## Building a catalog\n\n```ts\nimport {\n  BGE_SMALL_EN_V15_1,\n  MARKDOWN_CHUNKS_2,\n  compileKnowledgeCatalog,\n  createProfileEmbedder,\n  loadMarkdownCatalog,\n} from '@bendyline/gezel-knowledge';\n\nconst source = await loadMarkdownCatalog('./my-notes', { language: 'en' });\nconst embedder = await createProfileEmbedder(BGE_SMALL_EN_V15_1);\nawait compileKnowledgeCatalog({\n  catalog: {\n    id: 'my-notes',\n    version: '1.0.0',\n    name: 'My Notes',\n    language: 'en',\n    publisher: { id: 'me', name: 'Me' },\n    createdAt: new Date().toISOString(),\n    license: { name: 'MIT', spdx: 'MIT', attributionRequired: false },\n  },\n  topics: source.topics,\n  documents: (async function* () {\n    for (const doc of source.documents) yield doc;\n  })(),\n  outputPath: './my-notes-1.0.0.gezk',\n  embeddingProfile: BGE_SMALL_EN_V15_1,\n  chunkingProfile: MARKDOWN_CHUNKS_2,\n  embed: (texts) => embedder.embed(texts),\n  countTokens: (text) => embedder.countTokens(text),\n  workDir: './.gezk-work',\n});\n```\n\nEvery archive ships a `README.md` and `LICENSES/catalog.txt`; the compiler\ngenerates minimal ones from the catalog block unless you pass richer texts in\n`extraFiles`. Embedding requires `@huggingface/transformers` at runtime; the\nmodule is imported dynamically so everything else works without it. The\n`gezel knowledge` CLI wraps this same API (`init`, `build`, `validate`,\n`inspect`, `search`), entirely offline — no daemon.\n\n## Reading a catalog\n\n```ts\nimport { CatalogHandle, extractGezkVerified } from '@bendyline/gezel-knowledge';\n\nawait extractGezkVerified('./my-notes-1.0.0.gezk', './extracted');\nconst handle = CatalogHandle.open('./extracted');\nconst topics = handle.topics();\nconst hits = handle.searchDocumentsFts('woodworking');\nhandle.close();\n```\n\nExtraction verifies every file against the manifest (both directions —\nundeclared and missing files are equally fatal) and rejects unsafe archive\nentries. Catalog databases are opened strictly read-only and immutable.\nSemantic search loads a shard's sign-bit rows into memory once (9.6 MB for a\nfull 200,000-chunk shard) and scores the float query against them through a\nper-byte lookup table (the query is centered first when the catalog's profile\nis `centered-sign`); the int8 rerank reads the top 1,024 candidates by rowid.\n\n## Stability\n\nPublished for the gezel toolchain and the Bendyline content pipeline. The\narchive format is versioned (`formatVersion` / `indexSchemaVersion`) and\nreaders never migrate a catalog — incompatibility is a typed, reported\nstate. While the format is `0.x`, a minor release may break compatibility;\neach reader names the exact versions it supports.\n","readmeFilename":""}