@noodleseed/one 0.120.1 → 0.122.0

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

@@ -0,0 +1,19 @@
+/**
+ * Structural v0 knowledge limits (ADR 0202 fixed table, amended for the managed-bundled model).
+ * These are ceilings, not defaults: operators and app code may narrow them, never raise them.
+ * One owner for every bound so a declared limit nobody reads is unrepresentable.
+ */
+/** UTF-8 `.md` / `.txt` only; regular, non-symlinked, inside project root. */
+export declare const ALLOWED_DOCUMENT_EXTENSIONS: readonly [".md", ".txt"];
+export declare const MAX_DOCUMENTS_PER_COMPONENT = 100;
+export declare const MAX_DOCUMENT_BYTES: number;
+export declare const MAX_COMPONENT_TOTAL_BYTES: number;
+export declare const MIN_QUERY_CHARS = 1;
+export declare const MAX_QUERY_CHARS = 2000;
+export declare const MIN_RESULT_LIMIT = 1;
+export declare const MAX_RESULT_LIMIT = 20;
+export declare const DEFAULT_RESULT_LIMIT = 8;
+export declare const MAX_EXCERPT_CHARS = 2000;
+/** Reciprocal-rank fusion constant; equal weight across sources (ADR 0202). */
+export declare const RRF_K = 60;
+//# sourceMappingURL=limits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,0BAA2B,CAAC;AAEpE,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,kBAAkB,QAAc,CAAC;AAC9C,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAE1D,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,+EAA+E;AAC/E,eAAO,MAAM,KAAK,KAAK,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Structural v0 knowledge limits (ADR 0202 fixed table, amended for the managed-bundled model).
+ * These are ceilings, not defaults: operators and app code may narrow them, never raise them.
+ * One owner for every bound so a declared limit nobody reads is unrepresentable.
+ */
+/** UTF-8 `.md` / `.txt` only; regular, non-symlinked, inside project root. */
+export const ALLOWED_DOCUMENT_EXTENSIONS = ['.md', '.txt'];
+export const MAX_DOCUMENTS_PER_COMPONENT = 100;
+export const MAX_DOCUMENT_BYTES = 1024 * 1024;
+export const MAX_COMPONENT_TOTAL_BYTES = 25 * 1024 * 1024;
+export const MIN_QUERY_CHARS = 1;
+export const MAX_QUERY_CHARS = 2000;
+export const MIN_RESULT_LIMIT = 1;
+export const MAX_RESULT_LIMIT = 20;
+export const DEFAULT_RESULT_LIMIT = 8;
+export const MAX_EXCERPT_CHARS = 2000;
+/** Reciprocal-rank fusion constant; equal weight across sources (ADR 0202). */
+export const RRF_K = 60;
+//# sourceMappingURL=limits.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAEpE,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Core v2 manifest fragment for knowledge components (ADR 0202). Owned here so the pinned
+ * compiler only wires the surface; the shapes are the single source both the manifest schema
+ * and the compile pass consume.
+ */
+import { z } from 'zod';
+/**
+ * One deploy-coupled knowledge document. Authoring form carries `path`/`title`; the compile
+ * pass reads the file, verifies the structural limits, and fills `sha256`/`bytes` — the
+ * compiled form never carries document contents.
+ */
+export declare const knowledgeDocumentManifestSchema: z.ZodObject<{
+    path: z.ZodString;
+    title: z.ZodString;
+    sourceUrl: z.ZodOptional<z.ZodURL>;
+    sha256: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const knowledgeSiteManifestSchema: z.ZodObject<{
+    origin: z.ZodURL;
+    include: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const knowledgeComponentManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    documents: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodString;
+        sourceUrl: z.ZodOptional<z.ZodURL>;
+        sha256: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    sites: z.ZodArray<z.ZodObject<{
+        origin: z.ZodURL;
+        include: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeDocumentManifest = z.infer<typeof knowledgeDocumentManifestSchema>;
+export type KnowledgeSiteManifest = z.infer<typeof knowledgeSiteManifestSchema>;
+export type KnowledgeComponentManifest = z.infer<typeof knowledgeComponentManifestSchema>;
+//# sourceMappingURL=manifest-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../src/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;kBAiBjC,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;kBAO7B,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;kBAQlC,CAAC;AAEZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

package/node_modules/@noodle-borg/knowledge/dist/manifest-schema.js

@@ -0,0 +1,45 @@
+/**
+ * Core v2 manifest fragment for knowledge components (ADR 0202). Owned here so the pinned
+ * compiler only wires the surface; the shapes are the single source both the manifest schema
+ * and the compile pass consume.
+ */
+import { z } from 'zod';
+const httpsUrlSchema = z.url().regex(/^https:\/\//, 'must use https');
+/**
+ * One deploy-coupled knowledge document. Authoring form carries `path`/`title`; the compile
+ * pass reads the file, verifies the structural limits, and fills `sha256`/`bytes` — the
+ * compiled form never carries document contents.
+ */
+export const knowledgeDocumentManifestSchema = z
+    .object({
+    path: z
+        .string()
+        .min(1)
+        .refine((value) => !value.startsWith('/') && !value.split('/').includes('..'), 'document path must stay inside the project root'),
+    title: z.string().trim().min(1),
+    sourceUrl: httpsUrlSchema.optional(),
+    sha256: z
+        .string()
+        .regex(/^[0-9a-f]{64}$/, 'must be a lowercase hex SHA-256')
+        .optional(),
+    bytes: z.number().int().positive().optional(),
+})
+    .strict();
+export const knowledgeSiteManifestSchema = z
+    .object({
+    origin: httpsUrlSchema.refine((value) => !value.slice('https://'.length).includes('/'), {
+        message: 'site origin must not contain a path',
+    }),
+    include: z.array(z.string().min(1)).min(1),
+})
+    .strict();
+export const knowledgeComponentManifestSchema = z
+    .object({
+    name: z.string().regex(/^[a-z][a-z0-9_]*$/, 'must be lowercase snake-case'),
+    title: z.string().trim().min(1),
+    description: z.string().min(1),
+    documents: z.array(knowledgeDocumentManifestSchema).max(100),
+    sites: z.array(knowledgeSiteManifestSchema),
+})
+    .strict();
+//# sourceMappingURL=manifest-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../src/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EACrE,iDAAiD,CAClD;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,KAAK,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;SAC1D,QAAQ,EAAE;IACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QACtF,OAAO,EAAE,qCAAqC;KAC/C,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC;KAC9C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,8BAA8B,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;CAC5C,CAAC;KACD,MAAM,EAAE,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * Provider-neutral knowledge ports (ADR 0202). A fake and a production implementation pass
+ * the same conformance suites; provider names, scores, and answers never cross these seams.
+ */
+import type { SearchHit, SearchRequest } from './hits.js';
+import type { AudiencePredicate, DocumentDescriptor, KnowledgeScope, SitePolicy } from './ir.js';
+/** Which provider layer failed, so operators see the accountable surface, never content. */
+export type KnowledgeErrorLayer = 'request' | 'predicate' | 'provider' | 'store' | 'not-found';
+export declare class KnowledgeError extends Error {
+    readonly layer: KnowledgeErrorLayer;
+    constructor(layer: KnowledgeErrorLayer, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** One staged document: its compiled descriptor plus the UTF-8 content the provider will index. */
+export interface StagedDocument {
+    readonly descriptor: DocumentDescriptor;
+    readonly text: string;
+}
+export interface KnowledgeRevision {
+    /** Opaque provider/adapter-local revision identifier pinned by the deploy record. */
+    readonly revisionId: string;
+    readonly scope: KnowledgeScope;
+    readonly componentName: string;
+    readonly documents: readonly DocumentDescriptor[];
+}
+/**
+ * Publishes and queries deployment-versioned text documents. Implementations must:
+ * stage complete revisions, verify a positive typed-predicate query before activation,
+ * activate atomically, and delete only unreferenced revisions.
+ */
+export interface KnowledgeIndex {
+    /** Stage a complete replacement revision and return its identifier. Idempotent on content hash. */
+    stage(scope: KnowledgeScope, componentName: string, documents: readonly StagedDocument[]): Promise<KnowledgeRevision>;
+    /**
+     * Prove the staged revision answers a positive filtered query for the given predicate —
+     * the launch gate that catches a knowledge base that silently returns nothing.
+     */
+    verify(revisionId: string, predicate: AudiencePredicate): Promise<boolean>;
+    /** Make the staged revision the one searches read. Fails if not staged. */
+    activate(revisionId: string): Promise<void>;
+    /** Query the active revision for the scope/component. */
+    search(scope: KnowledgeScope, componentName: string, request: SearchRequest): Promise<readonly SearchHit[]>;
+    /** Delete only a revision no activation or deployment pin references. */
+    delete(revisionId: string): Promise<void>;
+    /** The revision searches currently read, if one is active. */
+    activeRevision(scope: KnowledgeScope, componentName: string): Promise<KnowledgeRevision | undefined>;
+}
+/**
+ * Queries provider-managed live public websites. The mandatory predicate must carry
+ * `audience: public`; results are exact-origin/path-approved only.
+ */
+export interface SiteSearch {
+    search(policy: SitePolicy, predicate: AudiencePredicate, request: SearchRequest): Promise<readonly SearchHit[]>;
+}
+//# sourceMappingURL=ports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjG,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE/F,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;gBAExB,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKvF;AAED,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,KAAK,CACH,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,SAAS,cAAc,EAAE,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,yDAAyD;IACzD,MAAM,CACJ,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACjC,yEAAyE;IACzE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,cAAc,CACZ,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CACJ,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;CAClC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Provider-neutral knowledge ports (ADR 0202). A fake and a production implementation pass
+ * the same conformance suites; provider names, scores, and answers never cross these seams.
+ */
+export class KnowledgeError extends Error {
+    layer;
+    constructor(layer, message, options) {
+        super(message, options);
+        this.name = 'KnowledgeError';
+        this.layer = layer;
+    }
+}
+//# sourceMappingURL=ports.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,KAAK,CAAsB;IAEpC,YAAY,KAA0B,EAAE,OAAe,EAAE,OAA6B;QACpF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/node_modules/@noodle-borg/knowledge/dist/postgres-budget-store.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Durable search-budget store: Postgres parity for the org-pooled monthly ceiling with
+ * per-app sub-caps (ADR 0202 as amended). Consume is one transaction over two counter rows
+ * (the app row and the org-total row `app = ''`), locked in a fixed order, so concurrent
+ * requests can never over-grant and a refusal spends nothing at either granularity.
+ */
+import type { Pool } from 'pg';
+import { type SearchBudgetCeilings, type SearchBudgetDecision, type SearchBudgetScope, type SearchBudgetState, type SearchBudgetStore } from './budget.js';
+export declare class PostgresSearchBudgetStore implements SearchBudgetStore {
+    #private;
+    constructor(pool: Pool, now?: () => Date);
+    ensureSchema(): Promise<void>;
+    consume(scope: SearchBudgetScope, count: number, ceilings: SearchBudgetCeilings): Promise<SearchBudgetDecision>;
+    peek(scope: SearchBudgetScope, ceilings: SearchBudgetCeilings): Promise<SearchBudgetState>;
+    /** Ensure the counter row exists, lock it, and return its consumed value. */
+    private lockCounter;
+    private addToCounter;
+    private state;
+    private orgKey;
+    private appKey;
+}
+//# sourceMappingURL=postgres-budget-store.d.ts.map

package/node_modules/@noodle-borg/knowledge/dist/postgres-budget-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-budget-store.d.ts","sourceRoot":"","sources":["../src/postgres-budget-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAC3C,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAKrB,qBAAa,yBAA0B,YAAW,iBAAiB;;gBAIrD,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,MAAM,IAAuB;IAKpD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7B,OAAO,CACX,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,oBAAoB,CAAC;IAgC1B,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgBhG,6EAA6E;YAC/D,WAAW;YAqBX,YAAY;IAc1B,OAAO,CAAC,KAAK;IAkBb,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,MAAM;CAGf"}

package/node_modules/@noodle-borg/knowledge/dist/postgres-budget-store.js

@@ -0,0 +1,102 @@
+import { budgetWindow, } from './budget.js';
+/** The org-total row's app key; real app ids are never empty. */
+const ORG_TOTAL_APP = '';
+export class PostgresSearchBudgetStore {
+    #pool;
+    #now;
+    constructor(pool, now = () => new Date()) {
+        this.#pool = pool;
+        this.#now = now;
+    }
+    async ensureSchema() {
+        await this.#pool.query(`
+      CREATE TABLE IF NOT EXISTS knowledge_search_budgets (
+        org text NOT NULL,
+        app text NOT NULL,
+        year integer NOT NULL,
+        month integer NOT NULL,
+        consumed bigint NOT NULL DEFAULT 0,
+        PRIMARY KEY (org, app, year, month)
+      )
+    `);
+    }
+    async consume(scope, count, ceilings) {
+        const window = budgetWindow(this.#now);
+        if (ceilings.app <= 0 || ceilings.org <= 0) {
+            // Kill switch: block before touching the database.
+            const state = await this.peek(scope, ceilings);
+            return { granted: false, state };
+        }
+        const client = await this.#pool.connect();
+        try {
+            await client.query('BEGIN');
+            const appConsumed = await this.lockCounter(client, scope.org, scope.app, window);
+            const orgConsumed = await this.lockCounter(client, scope.org, ORG_TOTAL_APP, window);
+            const granted = appConsumed + count <= ceilings.app && orgConsumed + count <= ceilings.org;
+            if (granted) {
+                await this.addToCounter(client, scope.org, scope.app, window, count);
+                await this.addToCounter(client, scope.org, ORG_TOTAL_APP, window, count);
+                await client.query('COMMIT');
+                return {
+                    granted,
+                    state: this.state(scope, window, ceilings, orgConsumed + count, appConsumed + count),
+                };
+            }
+            await client.query('ROLLBACK');
+            return { granted, state: this.state(scope, window, ceilings, orgConsumed, appConsumed) };
+        }
+        catch (error) {
+            await client.query('ROLLBACK').catch(() => undefined);
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async peek(scope, ceilings) {
+        const window = budgetWindow(this.#now);
+        const result = await this.#pool.query(`SELECT app, consumed FROM knowledge_search_budgets
+       WHERE org = $1 AND app IN ($2, $3) AND year = $4 AND month = $5`, [this.orgKey(scope), this.appKey(scope), ORG_TOTAL_APP, window.year, window.month]);
+        let orgConsumed = 0;
+        let appConsumed = 0;
+        for (const row of result.rows) {
+            if (row.app === ORG_TOTAL_APP)
+                orgConsumed = Number(row.consumed);
+            else
+                appConsumed = Number(row.consumed);
+        }
+        return this.state(scope, window, ceilings, orgConsumed, appConsumed);
+    }
+    /** Ensure the counter row exists, lock it, and return its consumed value. */
+    async lockCounter(client, org, app, window) {
+        await client.query(`INSERT INTO knowledge_search_budgets (org, app, year, month, consumed)
+       VALUES ($1, $2, $3, $4, 0)
+       ON CONFLICT (org, app, year, month) DO NOTHING`, [org.toLowerCase(), app.toLowerCase(), window.year, window.month]);
+        const locked = await client.query(`SELECT consumed FROM knowledge_search_budgets
+       WHERE org = $1 AND app = $2 AND year = $3 AND month = $4
+       FOR UPDATE`, [org.toLowerCase(), app.toLowerCase(), window.year, window.month]);
+        return Number(locked.rows[0]?.consumed ?? 0);
+    }
+    async addToCounter(client, org, app, window, count) {
+        await client.query(`UPDATE knowledge_search_budgets SET consumed = consumed + $5
+       WHERE org = $1 AND app = $2 AND year = $3 AND month = $4`, [org.toLowerCase(), app.toLowerCase(), window.year, window.month, count]);
+    }
+    state(scope, window, ceilings, orgConsumed, appConsumed) {
+        return {
+            org: scope.org,
+            app: scope.app,
+            ...window,
+            orgConsumed,
+            appConsumed,
+            orgCeiling: ceilings.org,
+            appCeiling: ceilings.app,
+        };
+    }
+    orgKey(scope) {
+        return scope.org.toLowerCase();
+    }
+    appKey(scope) {
+        return scope.app.toLowerCase();
+    }
+}
+//# sourceMappingURL=postgres-budget-store.js.map

package/node_modules/@noodle-borg/knowledge/dist/postgres-budget-store.js.map

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

package/node_modules/@noodle-borg/knowledge/dist/postgres-revision-store.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Durable knowledge revision store: Postgres parity for the deploy-coupled publication
+ * transaction (ADR 0202). Every state transition the in-memory store makes in one process,
+ * this store makes atomically across every service instance:
+ *
+ * - stage is idempotent on (scope, content_hash);
+ * - activate retires the previous active revision and pins the deployment in one transaction;
+ * - rollback reselects exactly the revision the target deployment pinned;
+ * - GC removes only revisions that are neither active nor pinned;
+ * - leases serialize publication per component/scope with a bounded timeout.
+ */
+import type { Pool } from 'pg';
+import type { KnowledgeScope } from './ir.js';
+import { type KnowledgeRevision, type StagedDocument } from './ports.js';
+import { type DocumentTextCodec, type KnowledgeRevisionStore, type LeaseTicket, type RevisionRecord, type StageRevisionInput } from './revision-store.js';
+export declare class PostgresKnowledgeRevisionStore implements KnowledgeRevisionStore {
+    #private;
+    constructor(pool: Pool, codec?: DocumentTextCodec);
+    ensureSchema(): Promise<void>;
+    stage(input: StageRevisionInput): Promise<KnowledgeRevision>;
+    acquireLease(scope: KnowledgeScope, componentName: string, holder: string): Promise<LeaseTicket>;
+    releaseLease(ticket: LeaseTicket): Promise<void>;
+    activate(scope: KnowledgeScope, componentName: string, revisionId: string, deploymentId: string): Promise<void>;
+    pin(revisionId: string, deploymentId: string): Promise<void>;
+    rollback(deploymentId: string): Promise<KnowledgeRevision | undefined>;
+    collectGarbage(): Promise<number>;
+    active(scope: KnowledgeScope, componentName: string): Promise<KnowledgeRevision | undefined>;
+    record(revisionId: string): Promise<RevisionRecord | undefined>;
+    delete(revisionId: string): Promise<void>;
+    stageDocuments(revisionId: string, documents: readonly StagedDocument[]): Promise<void>;
+    documents(revisionId: string): Promise<readonly StagedDocument[]>;
+    private rowScope;
+    private toRevision;
+}
+//# sourceMappingURL=postgres-revision-store.d.ts.map

package/node_modules/@noodle-borg/knowledge/dist/postgres-revision-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-revision-store.d.ts","sourceRoot":"","sources":["../src/postgres-revision-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAgB7B,qBAAa,8BAA+B,YAAW,sBAAsB;;gBAI/D,IAAI,EAAE,IAAI,EAAE,KAAK,GAAE,iBAA6C;IAKtE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC7B,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8B5D,YAAY,CAChB,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC;IAmBjB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,QAAQ,CACZ,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAmCV,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAwCtE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAWjC,MAAM,CACV,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IASnC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAoB/D,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCvF,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IA6BvE,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;CAQnB"}