@noodleseed/one 0.120.0 → 0.121.0

package/node_modules/@noodle-borg/knowledge/dist/conformance.js

@@ -0,0 +1,225 @@
+/**
+ * Shared port conformance suites (ADR 0202): every `KnowledgeIndex` implementation — the
+ * fake, the bundled BM25 adapter, and the managed Google adapter — passes the identical
+ * suite, and likewise every `SiteSearch` implementation. A behaviour asserted only against
+ * one implementation is one the others are free to violate in production.
+ *
+ * This module is shipped source, so it imports no test framework: assertions use the
+ * `node:assert` builtin and the caller injects its runner's `describe`/`it`. Declaring a
+ * framework here — even as an optional peer — would put it in the dependency graph of
+ * everything that depends on this package, including the published CLI.
+ */
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import { fuseHits } from './fusion.js';
+import { searchRequestSchema } from './hits.js';
+import { KnowledgeError, } from './ports.js';
+export const testScope = { org: 'acme', app: 'acme-app', env: 'prod' };
+export const testComponent = 'product';
+export function stagedDocument(path, title, text, sourceUrl) {
+    const bytes = Buffer.byteLength(text, 'utf8');
+    const hash = createHash('sha256').update(text, 'utf8').digest('hex');
+    return {
+        descriptor: {
+            path,
+            title,
+            ...(sourceUrl !== undefined ? { sourceUrl } : {}),
+            sha256: hash,
+            bytes,
+        },
+        text,
+    };
+}
+export const publicPredicate = (revision) => ({
+    audience: 'public',
+    revision,
+});
+export function describeKnowledgeIndex(runner, makeIndex, label) {
+    const { describe, it } = runner;
+    describe(`KnowledgeIndex conformance — ${label}`, () => {
+        it('stages a complete revision and reports its descriptors', async () => {
+            const index = makeIndex();
+            const revision = await index.stage(testScope, testComponent, [
+                stagedDocument('knowledge/a.md', 'A', 'alpha beta'),
+                stagedDocument('knowledge/b.txt', 'B', 'gamma delta'),
+            ]);
+            assert.equal(revision.documents.length, 2);
+            assert.deepEqual(revision.documents.map((document) => document.path), ['knowledge/a.md', 'knowledge/b.txt']);
+            assert.deepEqual(revision.scope, testScope);
+        });
+        it('verifies a positive predicate for the staged revision and rejects a mismatched one', async () => {
+            const index = makeIndex();
+            const revision = await index.stage(testScope, testComponent, [
+                stagedDocument('knowledge/a.md', 'A', 'alpha beta'),
+            ]);
+            assert.equal(await index.verify(revision.revisionId, publicPredicate(revision.revisionId)), true);
+            assert.equal(await index.verify(revision.revisionId, publicPredicate('other-revision')), false);
+        });
+        it('activates atomically: search reads only the active revision', async () => {
+            const index = makeIndex();
+            const first = await index.stage(testScope, testComponent, [
+                stagedDocument('knowledge/a.md', 'A', 'ancient content'),
+            ]);
+            await index.activate(first.revisionId);
+            const second = await index.stage(testScope, testComponent, [
+                stagedDocument('knowledge/a.md', 'A', 'fresh content'),
+                stagedDocument('knowledge/b.md', 'B', 'fresh content too'),
+            ]);
+            await index.activate(second.revisionId);
+            const hits = await index.search(testScope, testComponent, searchRequestSchema.parse({ query: 'content' }));
+            assert.ok(hits.length > 0, 'expected the active revision to return hits');
+            assert.equal(hits.some((hit) => hit.title === 'B'), true);
+            const active = await index.activeRevision(testScope, testComponent);
+            assert.equal(active?.revisionId, second.revisionId);
+        });
+        it('search before activation fails with an attributable not-found error', async () => {
+            const index = makeIndex();
+            await index.stage(testScope, testComponent, [stagedDocument('knowledge/a.md', 'A', 'alpha')]);
+            await assert.rejects(index.search(testScope, testComponent, { query: 'alpha', limit: 8 }), KnowledgeError);
+        });
+        it('returns bounded hits with stable ids, titles, excerpts, and source kind', async () => {
+            const index = makeIndex();
+            const revision = await index.stage(testScope, testComponent, [
+                stagedDocument('knowledge/a.md', 'Alpha doc', 'alpha beta gamma', 'https://acme.example/docs/a'),
+                stagedDocument('knowledge/b.md', 'Beta doc', 'beta gamma delta'),
+            ]);
+            await index.activate(revision.revisionId);
+            const hits = await index.search(testScope, testComponent, { query: 'gamma', limit: 1 });
+            assert.equal(hits.length, 1);
+            const hit = hits[0];
+            if (hit === undefined)
+                throw new Error('expected one bounded hit');
+            assert.ok(hit.id.length > 0, 'hit id must be stable and non-empty');
+            assert.ok(hit.title.length > 0, 'hit title must be non-empty');
+            assert.ok(hit.excerpt.length <= 2000, 'excerpt must stay within MAX_EXCERPT_CHARS');
+            assert.equal(hit.sourceKind, 'document');
+            if (hit.uri !== undefined)
+                assert.equal(hit.uri.startsWith('https://'), true);
+        });
+        it('deletes only unreferenced revisions', async () => {
+            const index = makeIndex();
+            const revision = await index.stage(testScope, testComponent, [
+                stagedDocument('knowledge/a.md', 'A', 'alpha'),
+            ]);
+            await index.activate(revision.revisionId);
+            await assert.rejects(index.delete(revision.revisionId), KnowledgeError);
+            const retired = await index.stage(testScope, testComponent, [
+                stagedDocument('knowledge/b.md', 'B', 'beta'),
+            ]);
+            await index.activate(retired.revisionId);
+            assert.equal(await index.delete(revision.revisionId), undefined);
+        });
+        it('rejects a non-public audience predicate at verification', async () => {
+            const index = makeIndex();
+            const revision = await index.stage(testScope, testComponent, [
+                stagedDocument('knowledge/a.md', 'A', 'alpha'),
+            ]);
+            assert.equal(await index.verify(revision.revisionId, {
+                audience: 'public',
+                revision: revision.revisionId,
+            }), true);
+        });
+    });
+}
+const policy = { origin: 'https://www.acme.test', include: ['/docs/**', '/pricing'] };
+export function describeSiteSearch(runner, makeSearch, label) {
+    const { describe, it } = runner;
+    describe(`SiteSearch conformance — ${label}`, () => {
+        it('requires a public audience predicate', async () => {
+            const search = makeSearch();
+            await assert.rejects(search.search(policy, { audience: 'private', revision: 'r' }, { query: 'anything', limit: 8 }), KnowledgeError);
+        });
+        it('returns only exact-origin, path-approved hits', async () => {
+            const search = makeSearch();
+            search.addPage?.('https://www.acme.test/docs/guide', 'Guide', 'install instructions here');
+            search.addPage?.('https://www.acme.test/blog/post', 'Blog', 'install instructions here');
+            search.addPage?.('https://evil.test/docs/guide', 'Evil', 'install instructions here');
+            const hits = await search.search(policy, publicPredicate('live'), {
+                query: 'install',
+                limit: 8,
+            });
+            assert.equal(hits.length, 1);
+            assert.equal(hits[0]?.uri, 'https://www.acme.test/docs/guide');
+        });
+        it('bounds results to the requested limit', async () => {
+            const search = makeSearch();
+            search.addPage?.('https://www.acme.test/docs/one', 'One', 'pricing details');
+            search.addPage?.('https://www.acme.test/docs/two', 'Two', 'pricing details');
+            search.addPage?.('https://www.acme.test/pricing', 'Pricing', 'pricing details');
+            const hits = await search.search(policy, publicPredicate('live'), {
+                query: 'pricing',
+                limit: 2,
+            });
+            assert.equal(hits.length, 2);
+        });
+        it('attributes failures through KnowledgeError, never raw provider text', async () => {
+            const search = makeSearch();
+            await assert.rejects(search.search(policy, publicPredicate('live'), { query: '', limit: 8 }), KnowledgeError);
+        });
+    });
+}
+/** Cross-source fusion is part of the contract: policy filters run before the limit. */
+export function fusionContractCases(runner) {
+    const { describe, it } = runner;
+    describe('fusion contract', () => {
+        const sitePolicies = [policy];
+        it('applies policy before the limit, never after', () => {
+            const documents = [];
+            const sites = [
+                {
+                    id: 'https://www.acme.test/docs/a',
+                    title: 'A',
+                    excerpt: 'x',
+                    sourceKind: 'site',
+                    uri: 'https://www.acme.test/docs/a',
+                },
+                {
+                    id: 'https://evil.test/docs/b',
+                    title: 'Evil',
+                    excerpt: 'x',
+                    sourceKind: 'site',
+                    uri: 'https://evil.test/docs/b',
+                },
+                {
+                    id: 'https://www.acme.test/blog/c',
+                    title: 'Blog',
+                    excerpt: 'x',
+                    sourceKind: 'site',
+                    uri: 'https://www.acme.test/blog/c',
+                },
+            ];
+            const fused = fuseHits(documents, sites, { limit: 2, sitePolicies });
+            assert.equal(fused.length, 1);
+            assert.equal(fused[0]?.id, 'https://www.acme.test/docs/a');
+        });
+        it('deduplicates by canonical URL then stable id, preferring document evidence', () => {
+            const sharedUri = 'https://www.acme.test/docs/a';
+            const documents = [
+                { id: 'doc:1', title: 'Doc', excerpt: 'x', sourceKind: 'document', uri: sharedUri },
+            ];
+            const sites = [
+                { id: sharedUri, title: 'Site', excerpt: 'x', sourceKind: 'site', uri: sharedUri },
+            ];
+            const fused = fuseHits(documents, sites, { limit: 8, sitePolicies });
+            assert.equal(fused.length, 1);
+            assert.equal(fused[0]?.sourceKind, 'document');
+        });
+        it('breaks equal scores deterministically: document evidence outranks site evidence', () => {
+            const documents = [
+                { id: 'doc:b', title: 'B', excerpt: 'x', sourceKind: 'document' },
+            ];
+            const sites = [
+                {
+                    id: 'https://www.acme.test/docs/a',
+                    title: 'A',
+                    excerpt: 'x',
+                    sourceKind: 'site',
+                    uri: 'https://www.acme.test/docs/a',
+                },
+            ];
+            const fused = fuseHits(documents, sites, { limit: 2, sitePolicies });
+            assert.deepEqual(fused.map((hit) => hit.id), ['doc:b', 'https://www.acme.test/docs/a']);
+        });
+    });
+}
+//# sourceMappingURL=conformance.js.map

package/node_modules/@noodle-borg/knowledge/dist/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"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"}

package/node_modules/@noodle-borg/knowledge/dist/fakes.d.ts

@@ -0,0 +1,23 @@
+import { type SearchHit, type SearchRequest } from './hits.js';
+import type { AudiencePredicate, KnowledgeScope, SitePolicy } from './ir.js';
+import { type KnowledgeIndex, type KnowledgeRevision, type SiteSearch, type StagedDocument } from './ports.js';
+export declare class FakeKnowledgeIndex implements KnowledgeIndex {
+    private readonly entries;
+    stage(scope: KnowledgeScope, componentName: string, documents: readonly StagedDocument[]): Promise<KnowledgeRevision>;
+    verify(revisionId: string, predicate: AudiencePredicate): Promise<boolean>;
+    activate(revisionId: string): Promise<void>;
+    search(scope: KnowledgeScope, componentName: string, request: SearchRequest): Promise<readonly SearchHit[]>;
+    delete(revisionId: string): Promise<void>;
+    activeRevision(scope: KnowledgeScope, componentName: string): Promise<KnowledgeRevision | undefined>;
+    /** Test hook: pin a revision like a deployment record would. */
+    pin(revisionId: string, deploymentId: string): void;
+    private require;
+}
+export declare function fakeDocumentHit(document: StagedDocument): SearchHit;
+/** Seeded live-site result set; applies the exact origin/path policy as its postfilter. */
+export declare class FakeSiteSearch implements SiteSearch {
+    private readonly pages;
+    addPage(uri: string, title: string, text: string): this;
+    search(policy: SitePolicy, predicate: AudiencePredicate, request: SearchRequest): Promise<readonly SearchHit[]>;
+}
+//# sourceMappingURL=fakes.d.ts.map

package/node_modules/@noodle-borg/knowledge/dist/fakes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakes.d.ts","sourceRoot":"","sources":["../src/fakes.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAY,MAAM,WAAW,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE7E,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AASpB,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAElD,KAAK,CACT,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,SAAS,cAAc,EAAE,GACnC,OAAO,CAAC,iBAAiB,CAAC;IAwBvB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ1E,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3C,MAAM,CACV,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC;IA2B1B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,CAClB,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IASzC,gEAAgE;IAChE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAInD,OAAO,CAAC,OAAO;CAMhB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAQnE;AAED,2FAA2F;AAC3F,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsD;IAE5E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjD,MAAM,CACV,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC;CA2BjC"}

package/node_modules/@noodle-borg/knowledge/dist/fakes.js

@@ -0,0 +1,141 @@
+/**
+ * In-memory reference implementations of the knowledge ports. They exist to make the shared
+ * conformance suites executable without a provider; the bundled BM25 adapter and the managed
+ * Google adapter must pass the exact same suites.
+ */
+import { createHash } from 'node:crypto';
+import { siteHitAllowed } from './fusion.js';
+import { buildExcerpt, tokenize } from './hits.js';
+import { knowledgeScopeKey } from './ir.js';
+import { KnowledgeError, } from './ports.js';
+export class FakeKnowledgeIndex {
+    entries = new Map();
+    async stage(scope, componentName, documents) {
+        const hash = createHash('sha256')
+            .update(documents.map((document) => document.descriptor.sha256).join('\n'))
+            .digest('hex');
+        const revisionId = `fake-rev-${hash.slice(0, 16)}`;
+        this.entries.set(revisionId, {
+            revision: {
+                revisionId,
+                scope,
+                componentName,
+                documents: documents.map((document) => document.descriptor),
+            },
+            documents,
+            state: 'staged',
+            pins: new Set(),
+        });
+        return {
+            revisionId,
+            scope,
+            componentName,
+            documents: documents.map((document) => document.descriptor),
+        };
+    }
+    async verify(revisionId, predicate) {
+        const entry = this.require(revisionId);
+        if (predicate.audience !== 'public') {
+            throw new KnowledgeError('predicate', 'fake index only accepts a public audience');
+        }
+        return entry.revision.revisionId === predicate.revision && entry.documents.length > 0;
+    }
+    async activate(revisionId) {
+        const entry = this.require(revisionId);
+        for (const other of this.entries.values()) {
+            if (other !== entry &&
+                other.state === 'active' &&
+                knowledgeScopeKey(other.revision.scope, other.revision.componentName) ===
+                    knowledgeScopeKey(entry.revision.scope, entry.revision.componentName)) {
+                other.state = 'retired';
+            }
+        }
+        entry.state = 'active';
+    }
+    async search(scope, componentName, request) {
+        const scopeKey = knowledgeScopeKey(scope, componentName);
+        const entry = [...this.entries.values()].find((candidate) => candidate.state === 'active' &&
+            knowledgeScopeKey(candidate.revision.scope, candidate.revision.componentName) === scopeKey);
+        if (entry === undefined)
+            throw new KnowledgeError('not-found', 'no active revision for this component');
+        const terms = new Set(tokenize(request.query));
+        return entry.documents
+            .map((document) => {
+            const documentTerms = tokenize(document.text);
+            const matches = documentTerms.filter((term) => terms.has(term)).length;
+            return { document, matches };
+        })
+            .filter((candidate) => candidate.matches > 0)
+            .sort((a, b) => b.matches !== a.matches
+            ? b.matches - a.matches
+            : a.document.descriptor.path.localeCompare(b.document.descriptor.path))
+            .slice(0, request.limit)
+            .map(({ document }) => fakeDocumentHit(document));
+    }
+    async delete(revisionId) {
+        const entry = this.require(revisionId);
+        if (entry.state === 'active')
+            throw new KnowledgeError('store', 'cannot delete the active revision');
+        if (entry.pins.size > 0)
+            throw new KnowledgeError('store', 'cannot delete a pinned revision');
+        this.entries.delete(revisionId);
+    }
+    async activeRevision(scope, componentName) {
+        const scopeKey = knowledgeScopeKey(scope, componentName);
+        return [...this.entries.values()].find((candidate) => candidate.state === 'active' &&
+            knowledgeScopeKey(candidate.revision.scope, candidate.revision.componentName) === scopeKey)?.revision;
+    }
+    /** Test hook: pin a revision like a deployment record would. */
+    pin(revisionId, deploymentId) {
+        this.require(revisionId).pins.add(deploymentId);
+    }
+    require(revisionId) {
+        const entry = this.entries.get(revisionId);
+        if (entry === undefined)
+            throw new KnowledgeError('not-found', `unknown revision ${revisionId}`);
+        return entry;
+    }
+}
+export function fakeDocumentHit(document) {
+    return {
+        id: `doc:${document.descriptor.sha256.slice(0, 16)}`,
+        title: document.descriptor.title,
+        excerpt: buildExcerpt(document.text, ''),
+        sourceKind: 'document',
+        ...(document.descriptor.sourceUrl !== undefined ? { uri: document.descriptor.sourceUrl } : {}),
+    };
+}
+/** Seeded live-site result set; applies the exact origin/path policy as its postfilter. */
+export class FakeSiteSearch {
+    pages = new Map();
+    addPage(uri, title, text) {
+        this.pages.set(uri, { title, text });
+        return this;
+    }
+    async search(policy, predicate, request) {
+        if (predicate.audience !== 'public') {
+            throw new KnowledgeError('predicate', 'site search rejects non-public audiences');
+        }
+        if (request.query.trim().length === 0) {
+            throw new KnowledgeError('request', 'query must not be empty');
+        }
+        const terms = new Set(tokenize(request.query));
+        return [...this.pages.entries()]
+            .map(([uri, page]) => {
+            const hit = {
+                id: uri,
+                title: page.title,
+                excerpt: buildExcerpt(page.text, request.query),
+                sourceKind: 'site',
+                uri,
+            };
+            const matches = tokenize(`${page.title} ${page.text}`).filter((term) => terms.has(term)).length;
+            return { hit, matches };
+        })
+            .filter(({ hit, matches }) => matches > 0 && siteHitAllowed(policy, hit))
+            .sort((a, b) => b.matches - a.matches || a.hit.id.localeCompare(b.hit.id))
+            .slice(0, request.limit)
+            .map(({ hit }) => hit);
+    }
+}
+//# sourceMappingURL=fakes.js.map

package/node_modules/@noodle-borg/knowledge/dist/fakes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakes.js","sourceRoot":"","sources":["../src/fakes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAsC,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACL,cAAc,GAKf,MAAM,YAAY,CAAC;AASpB,MAAM,OAAO,kBAAkB;IACZ,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAExD,KAAK,CAAC,KAAK,CACT,KAAqB,EACrB,aAAqB,EACrB,SAAoC;QAEpC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;aAC9B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC1E,MAAM,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,UAAU,GAAG,YAAY,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE;YAC3B,QAAQ,EAAE;gBACR,UAAU;gBACV,KAAK;gBACL,aAAa;gBACb,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;aAC5D;YACD,SAAS;YACT,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,IAAI,GAAG,EAAU;SACxB,CAAC,CAAC;QACH,OAAO;YACL,UAAU;YACV,KAAK;YACL,aAAa;YACb,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;SAC5D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,SAA4B;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,2CAA2C,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAkB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IACE,KAAK,KAAK,KAAK;gBACf,KAAK,CAAC,KAAK,KAAK,QAAQ;gBACxB,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;oBACnE,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EACvE,CAAC;gBACD,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAqB,EACrB,aAAqB,EACrB,OAAsB;QAEtB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC3C,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,KAAK,KAAK,QAAQ;YAC5B,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,QAAQ,CAC7F,CAAC;QACF,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,uCAAuC,CAAC,CAAC;QAEjF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC,SAAS;aACnB,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChB,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YACvE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC/B,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC;aAC5C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACb,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YACrB,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;YACvB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CACzE;aACA,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;aACvB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ;YAC1B,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAC;QACzE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAC;QAC9F,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,KAAqB,EACrB,aAAqB;QAErB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACpC,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,KAAK,KAAK,QAAQ;YAC5B,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,QAAQ,CAC7F,EAAE,QAAQ,CAAC;IACd,CAAC;IAED,gEAAgE;IAChE,GAAG,CAAC,UAAkB,EAAE,YAAoB;QAC1C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;IAEO,OAAO,CAAC,UAAkB;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,oBAAoB,UAAU,EAAE,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,QAAwB;IACtD,OAAO;QACL,EAAE,EAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QACpD,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK;QAChC,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,UAAU,EAAE,UAAU;QACtB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,OAAO,cAAc;IACR,KAAK,GAAG,IAAI,GAAG,EAA2C,CAAC;IAE5E,OAAO,CAAC,GAAW,EAAE,KAAa,EAAE,IAAY;QAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CACV,MAAkB,EAClB,SAA4B,EAC5B,OAAsB;QAEtB,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,0CAA0C,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;aAC7B,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAc;gBACrB,EAAE,EAAE,GAAG;gBACP,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC;gBAC/C,UAAU,EAAE,MAAM;gBAClB,GAAG;aACJ,CAAC;YACF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACrE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAChB,CAAC,MAAM,CAAC;YACT,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;aACxE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aACzE,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;aACvB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/node_modules/@noodle-borg/knowledge/dist/fusion.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Deterministic result fusion (ADR 0202): equal-weight reciprocal rank fusion with k = 60,
+ * canonical-URL then stable-ID dedupe, deterministic source-kind/stable-ID tie-break, and
+ * policy filtering applied before the requested limit.
+ */
+import type { SearchHit } from './hits.js';
+import type { SitePolicy } from './ir.js';
+/** Exact origin/path admission for site hits — everything else is dropped, not returned. */
+export declare function siteHitAllowed(policy: SitePolicy, hit: SearchHit): boolean;
+/**
+ * Glob matching over URL paths. Supports `**` (any segments) and `*` (within one segment),
+ * with an exact literal as the degenerate case. A pattern with a trailing `/**` admits
+ * everything beneath the prefix but not the bare prefix itself unless listed.
+ */
+export declare function pathMatches(pathname: string, glob: string): boolean;
+export interface FuseOptions {
+    readonly limit: number;
+    /** Every site policy of the knowledge component; a site hit must satisfy at least one. */
+    readonly sitePolicies: readonly SitePolicy[];
+}
+/**
+ * Fuse document and site result lists. Both inputs are ranked best-first and may be longer
+ * than `limit`; providers' own scores are ignored — rank position is the only signal that
+ * crosses a provider boundary.
+ */
+export declare function fuseHits(documents: readonly SearchHit[], sites: readonly SearchHit[], options: FuseOptions): SearchHit[];
+//# sourceMappingURL=fusion.d.ts.map

package/node_modules/@noodle-borg/knowledge/dist/fusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion.d.ts","sourceRoot":"","sources":["../src/fusion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAU1E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAyBnE;AAqBD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,OAAO,EAAE,WAAW,GACnB,SAAS,EAAE,CA0Cb"}

package/node_modules/@noodle-borg/knowledge/dist/fusion.js

@@ -0,0 +1,119 @@
+import { RRF_K } from './limits.js';
+/** Exact origin/path admission for site hits — everything else is dropped, not returned. */
+export function siteHitAllowed(policy, hit) {
+    if (hit.sourceKind !== 'site' || hit.uri === undefined)
+        return false;
+    let parsed;
+    try {
+        parsed = new URL(hit.uri);
+    }
+    catch {
+        return false;
+    }
+    if (parsed.origin !== policy.origin)
+        return false;
+    return policy.include.some((glob) => pathMatches(parsed.pathname, glob));
+}
+/**
+ * Glob matching over URL paths. Supports `**` (any segments) and `*` (within one segment),
+ * with an exact literal as the degenerate case. A pattern with a trailing `/**` admits
+ * everything beneath the prefix but not the bare prefix itself unless listed.
+ */
+export function pathMatches(pathname, glob) {
+    const pathSegments = pathname.split('/').filter((segment) => segment !== '');
+    const globSegments = glob.split('/').filter((segment) => segment !== '');
+    if (globSegments.length === 0)
+        return false;
+    function match(pathIndex, globIndex) {
+        if (globIndex === globSegments.length)
+            return pathIndex === pathSegments.length;
+        const pattern = globSegments[globIndex];
+        if (pattern === undefined)
+            return false;
+        if (pattern === '**') {
+            // `**` consumes zero or more segments; a *trailing* `**` must consume at least one,
+            // so `/docs/**` admits everything beneath `/docs` but not the bare prefix.
+            const minimum = globIndex === globSegments.length - 1 ? 1 : 0;
+            for (let skip = pathSegments.length - pathIndex; skip >= minimum; skip -= 1) {
+                if (match(pathIndex + skip, globIndex + 1))
+                    return true;
+            }
+            return false;
+        }
+        if (pathIndex === pathSegments.length)
+            return false;
+        const segment = pathSegments[pathIndex];
+        if (segment === undefined || !segmentMatches(segment, pattern))
+            return false;
+        return match(pathIndex + 1, globIndex + 1);
+    }
+    return match(0, 0);
+}
+function segmentMatches(segment, pattern) {
+    const firstStar = pattern.indexOf('*');
+    if (firstStar === -1)
+        return segment === pattern;
+    const lastStar = pattern.lastIndexOf('*');
+    const prefix = pattern.slice(0, firstStar);
+    const suffix = pattern.slice(lastStar + 1);
+    if (!segment.startsWith(prefix) || !segment.endsWith(suffix))
+        return false;
+    if (segment.length < prefix.length + suffix.length)
+        return false;
+    const available = segment.length - suffix.length;
+    let cursor = prefix.length;
+    for (const middle of pattern.slice(firstStar + 1, lastStar).split('*')) {
+        if (middle === '')
+            continue;
+        const found = segment.indexOf(middle, cursor);
+        if (found === -1 || found + middle.length > available)
+            return false;
+        cursor = found + middle.length;
+    }
+    return true;
+}
+/**
+ * Fuse document and site result lists. Both inputs are ranked best-first and may be longer
+ * than `limit`; providers' own scores are ignored — rank position is the only signal that
+ * crosses a provider boundary.
+ */
+export function fuseHits(documents, sites, options) {
+    const scores = new Map();
+    const admit = (hit, rank, weight) => {
+        if (hit.sourceKind === 'site' &&
+            !options.sitePolicies.some((policy) => siteHitAllowed(policy, hit))) {
+            return;
+        }
+        const key = hit.uri ?? hit.id;
+        const contribution = weight / (RRF_K + rank + 1);
+        const existing = scores.get(key);
+        if (existing === undefined) {
+            scores.set(key, { hit, score: contribution });
+            return;
+        }
+        existing.score += contribution;
+        // Canonical-URL then stable-ID dedupe keeps the earliest-seen hit; document evidence
+        // outranks site evidence on collision because it is the versioned source.
+        if (existing.hit.sourceKind === 'site' && hit.sourceKind === 'document') {
+            existing.hit = hit;
+        }
+    };
+    documents.forEach((hit, rank) => {
+        admit(hit, rank, 1);
+    });
+    sites.forEach((hit, rank) => {
+        admit(hit, rank, 1);
+    });
+    return [...scores.values()]
+        .sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        if (a.hit.sourceKind !== b.hit.sourceKind) {
+            return a.hit.sourceKind === 'document' ? -1 : 1;
+        }
+        return a.hit.id.localeCompare(b.hit.id);
+    })
+        .slice(0, options.limit)
+        .map((entry) => entry.hit);
+}
+//# sourceMappingURL=fusion.js.map

package/node_modules/@noodle-borg/knowledge/dist/fusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion.js","sourceRoot":"","sources":["../src/fusion.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,GAAc;IAC/D,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,IAAY;IACxD,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IAC7E,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IACzE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5C,SAAS,KAAK,CAAC,SAAiB,EAAE,SAAiB;QACjD,IAAI,SAAS,KAAK,YAAY,CAAC,MAAM;YAAE,OAAO,SAAS,KAAK,YAAY,CAAC,MAAM,CAAC;QAChF,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,oFAAoF;YACpF,2EAA2E;YAC3E,MAAM,OAAO,GAAG,SAAS,KAAK,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,KAAK,IAAI,IAAI,GAAG,YAAY,CAAC,MAAM,GAAG,SAAS,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;gBAC5E,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,EAAE,SAAS,GAAG,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC1D,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,SAAS,KAAK,YAAY,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACpD,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7E,OAAO,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,OAAe;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,OAAO,OAAO,KAAK,OAAO,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACvE,IAAI,MAAM,KAAK,EAAE;YAAE,SAAS;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,SAAS;YAAE,OAAO,KAAK,CAAC;QACpE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,SAA+B,EAC/B,KAA2B,EAC3B,OAAoB;IAEpB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6C,CAAC;IAEpE,MAAM,KAAK,GAAG,CAAC,GAAc,EAAE,IAAY,EAAE,MAAc,EAAE,EAAE;QAC7D,IACE,GAAG,CAAC,UAAU,KAAK,MAAM;YACzB,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EACnE,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,KAAK,IAAI,YAAY,CAAC;QAC/B,qFAAqF;QACrF,0EAA0E;QAC1E,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACxE,QAAQ,CAAC,GAAG,GAAG,GAAG,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAC9B,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAC1B,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;SACxB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;YAC1C,OAAO,CAAC,CAAC,GAAG,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;SACvB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/node_modules/@noodle-borg/knowledge/dist/google-agent-search.d.ts

@@ -0,0 +1,49 @@
+import { type SearchHit, type SearchRequest } from './hits.js';
+import type { AudiencePredicate, KnowledgeScope, SitePolicy } from './ir.js';
+import { type KnowledgeIndex, type KnowledgeRevision, type SiteSearch, type StagedDocument } from './ports.js';
+/** Supplies short-lived bearer tokens. The broker implements this; tests inject a fixed token. */
+export type GoogleAccessTokenProvider = () => Promise<string>;
+/** Minimal fetch-shaped transport so unit tests run against scripted responses, never network. */
+export type GoogleTransport = (url: string, init: {
+    readonly method: 'POST' | 'GET' | 'DELETE';
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: string;
+}) => Promise<{
+    status: number;
+    json(): Promise<unknown>;
+}>;
+export interface GoogleAgentSearchOptions {
+    /** Noodle-owned GCP project id (managed v0; BYO project arrives with the deferred tier). */
+    readonly project: string;
+    readonly location: string;
+    readonly tokenProvider: GoogleAccessTokenProvider;
+    readonly transport?: GoogleTransport;
+    /** Escape hatch for tests/ops to point at a stub endpoint. */
+    readonly apiRoot?: string;
+    /**
+     * Tenant scope this instance serves. One adapter instance per tenant: the service binds it at
+     * request time from the deployment's identity, and site search needs it to target the tenant's
+     * website data store.
+     */
+    readonly scope: KnowledgeScope;
+}
+export declare class GoogleAgentSearchAdapter implements KnowledgeIndex {
+    #private;
+    constructor(options: GoogleAgentSearchOptions);
+    private dataStoreName;
+    private call;
+    stage(scope: KnowledgeScope, componentName: string, documents: readonly StagedDocument[]): Promise<KnowledgeRevision>;
+    verify(revisionId: string, predicate: AudiencePredicate): Promise<boolean>;
+    activate(revisionId: string): Promise<void>;
+    search(scope: KnowledgeScope, componentName: string, request: SearchRequest): Promise<readonly SearchHit[]>;
+    private toDocumentHit;
+    delete(revisionId: string): Promise<void>;
+    activeRevision(scope: KnowledgeScope, componentName: string): Promise<KnowledgeRevision | undefined>;
+}
+/** Site half of the managed adapter: live public-website search over the tenant's WEBSITE store. */
+export declare class GoogleAgentSearchSites implements SiteSearch {
+    #private;
+    constructor(options: GoogleAgentSearchOptions);
+    search(policy: SitePolicy, predicate: AudiencePredicate, request: SearchRequest): Promise<readonly SearchHit[]>;
+}
+//# sourceMappingURL=google-agent-search.d.ts.map