@pegma/knowledge-base-application 0.0.0-stage → 0.1.0

package/dist/reads.js

@@ -0,0 +1,228 @@
+import { hasPermission } from "@pegma/authorization-core";
+import { articleKinds, knowledgePermissions, } from "@pegma/knowledge-base-contracts";
+import { KnowledgeBaseNotFoundError, KnowledgeBasePrerequisiteError, requirePermission, } from "./errors.js";
+import { loadGovernanceContext } from "./governance.js";
+import { createPublicationChecker } from "./publication.js";
+import { canonicalJson, RepositoryConflictError, RepositoryIntegrityError, requireIdentifier, snapshotData, } from "./storage-helpers.js";
+function readInput(value, field, extra = []) {
+    const input = snapshotData(value);
+    if (input === null ||
+        typeof input !== "object" ||
+        Array.isArray(input) ||
+        Object.keys(input).some((key) => key !== field && !extra.includes(key))) {
+        throw new TypeError("Read contains unsupported fields");
+    }
+    requireIdentifier(input[field], field);
+    return input;
+}
+function clockTime(options) {
+    const at = options.clock.now();
+    if (typeof at !== "string" ||
+        !Number.isFinite(Date.parse(at)) ||
+        new Date(at).toISOString() !== at) {
+        throw new TypeError("Clock must return a canonical ISO timestamp");
+    }
+    return at;
+}
+async function requiredArticle(repository, articleId) {
+    const current = await repository.readArticleVersioned(articleId);
+    if (current === null)
+        throw new KnowledgeBaseNotFoundError("article");
+    return current.value;
+}
+function snapshotReferences(snapshot) {
+    if (!Array.isArray(snapshot.references) || snapshot.references.length > 32) {
+        throw new RepositoryIntegrityError();
+    }
+    return snapshot.references;
+}
+/** Explicit keyed staff reads and a separately authorized portal-only read. */
+export function createReadServices(repository, options) {
+    const publications = createPublicationChecker(repository, options);
+    return {
+        async getCollection(access, request) {
+            access = snapshotData(access);
+            requirePermission(access, knowledgePermissions.collectionRead);
+            const input = readInput(request, "collectionId");
+            const current = await repository.readCollectionVersioned(input.collectionId);
+            if (current === null)
+                throw new KnowledgeBaseNotFoundError("collection");
+            requirePermission(access, knowledgePermissions.collectionRead);
+            return snapshotData({
+                generation: current.value.generation,
+                collection: current.value.collection,
+            });
+        },
+        async getValidationPolicy(access, request) {
+            access = snapshotData(access);
+            requirePermission(access, knowledgePermissions.validationManage);
+            const input = readInput(request, "policyId");
+            const current = await repository.readValidationPolicyVersioned(input.policyId);
+            if (current === null)
+                throw new KnowledgeBaseNotFoundError("validation_policy");
+            requirePermission(access, knowledgePermissions.validationManage);
+            return snapshotData({
+                generation: current.value.generation,
+                policy: current.value.policy,
+            });
+        },
+        async getGovernanceConfiguration(access, request) {
+            access = snapshotData(access);
+            requirePermission(access, knowledgePermissions.validationManage);
+            const input = readInput(request, "collectionId");
+            const current = await repository.readCollectionVersioned(input.collectionId);
+            if (current === null || current.value.configuration === undefined) {
+                throw new KnowledgeBaseNotFoundError("governance_configuration");
+            }
+            requirePermission(access, knowledgePermissions.validationManage);
+            return snapshotData({
+                collectionId: input.collectionId,
+                generation: current.value.generation,
+                configuration: current.value.configuration,
+            });
+        },
+        async getValidationRequirements(access, request) {
+            access = snapshotData(access);
+            const authorize = () => {
+                if (!hasPermission(access, knowledgePermissions.evidenceSubmit)) {
+                    requirePermission(access, knowledgePermissions.draftWrite);
+                }
+            };
+            authorize();
+            const input = readInput(request, "collectionId", ["kind"]);
+            if (!articleKinds.includes(input.kind)) {
+                throw new TypeError("Unknown article kind");
+            }
+            const governance = await loadGovernanceContext(repository, input.collectionId, clockTime(options));
+            const [collection, validation] = await Promise.all([
+                repository.readCollectionVersioned(input.collectionId),
+                repository.readValidationPolicyVersioned(governance.context.validationPolicy.id),
+            ]);
+            if (collection === null ||
+                collection.value.generation !== governance.governanceGeneration ||
+                validation === null ||
+                validation.value.generation !== governance.validationGeneration) {
+                throw new RepositoryConflictError();
+            }
+            authorize();
+            return snapshotData({
+                collectionId: input.collectionId,
+                governanceGeneration: governance.governanceGeneration,
+                validationPolicy: {
+                    id: governance.context.validationPolicy.id,
+                    version: governance.context.validationPolicy.version,
+                },
+                expectedStagingBuildId: governance.context.expectedStagingBuildId,
+                checks: governance.context.validationPolicy.requirements
+                    .filter((check) => check.kind === input.kind)
+                    .map((check) => ({
+                    id: check.id,
+                    testKind: check.testKind,
+                    maxAgeMilliseconds: check.maxAgeMilliseconds,
+                })),
+            });
+        },
+        async getDraft(access, request) {
+            access = snapshotData(access);
+            requirePermission(access, knowledgePermissions.draftRead);
+            const input = readInput(request, "articleId");
+            const current = await requiredArticle(repository, input.articleId);
+            requirePermission(access, knowledgePermissions.draftRead);
+            return snapshotData({
+                articleId: current.article.id,
+                generation: current.generation,
+                state: current.article.state,
+                revision: current.article.current,
+                hasPendingReview: current.review !== undefined,
+                hasPublication: current.article.published !== undefined,
+                publicationHeld: current.publicationHeld,
+            });
+        },
+        async getEvidence(access, request) {
+            access = snapshotData(access);
+            requirePermission(access, knowledgePermissions.evidenceRead);
+            const input = readInput(request, "articleId");
+            const current = await requiredArticle(repository, input.articleId);
+            requirePermission(access, knowledgePermissions.evidenceRead);
+            return snapshotData({
+                articleId: current.article.id,
+                generation: current.generation,
+                evidence: current.article.evidence,
+                revokedEvidence: current.revokedEvidence,
+            });
+        },
+        async getProvenance(access, request) {
+            access = snapshotData(access);
+            requirePermission(access, knowledgePermissions.provenanceRead);
+            const input = readInput(request, "articleId");
+            const current = await requiredArticle(repository, input.articleId);
+            const snapshots = [
+                current.provenance,
+                ...(current.publishedProvenance === undefined
+                    ? []
+                    : [current.publishedProvenance]),
+            ];
+            const references = new Map();
+            for (const source of snapshots) {
+                for (const reference of snapshotReferences(source))
+                    references.set(canonicalJson(reference), reference);
+            }
+            if (references.size > 0) {
+                const verifier = options.privateSources;
+                if (verifier === undefined || typeof verifier.canRead !== "function") {
+                    throw new KnowledgeBasePrerequisiteError("source_access_verifier");
+                }
+                let allowed;
+                try {
+                    allowed = await Promise.all([...references.values()].map((reference) => verifier.canRead({
+                        access: snapshotData(access),
+                        articleId: input.articleId,
+                        reference: snapshotData(reference),
+                    })));
+                }
+                catch {
+                    throw new KnowledgeBasePrerequisiteError("source_access_verifier");
+                }
+                if (allowed.some((value) => value !== true))
+                    throw new KnowledgeBaseNotFoundError("provenance");
+            }
+            requirePermission(access, knowledgePermissions.provenanceRead);
+            const latest = await requiredArticle(repository, input.articleId);
+            if (latest.generation !== current.generation)
+                throw new RepositoryConflictError();
+            requirePermission(access, knowledgePermissions.provenanceRead);
+            return snapshotData({
+                articleId: current.article.id,
+                generation: current.generation,
+                snapshot: current.provenance,
+                ...(current.publishedProvenance === undefined
+                    ? {}
+                    : { publishedSnapshot: current.publishedProvenance }),
+            });
+        },
+        async getReview(access, request) {
+            access = snapshotData(access);
+            requirePermission(access, knowledgePermissions.review);
+            const input = readInput(request, "articleId");
+            const current = await requiredArticle(repository, input.articleId);
+            if (current.review === undefined)
+                throw new KnowledgeBaseNotFoundError("review");
+            requirePermission(access, knowledgePermissions.review);
+            return snapshotData({
+                articleId: current.article.id,
+                generation: current.generation,
+                review: current.review,
+            });
+        },
+        async getPublishedArticle(access, request) {
+            const input = readInput(request, "articleId");
+            const checked = await publications.check({
+                access,
+                articleId: input.articleId,
+                purpose: "portal",
+            });
+            return checked.article;
+        },
+    };
+}
+//# sourceMappingURL=reads.js.map

package/dist/reads.js.map

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

package/dist/records.d.ts

@@ -0,0 +1,40 @@
+import { type StoredRecord } from "@pegma/storage-core";
+import type { Article, Collection, ValidationPolicy } from "@pegma/knowledge-base-contracts";
+import type { EvidenceRevocation, GovernanceConfiguration, ReviewSnapshot, SourceSnapshot } from "./types.js";
+export type ResourceKind = "article" | "collection" | "validation";
+export interface StoredArticle {
+    readonly generation: number;
+    readonly article: Article;
+    readonly provenance: SourceSnapshot;
+    readonly review?: ReviewSnapshot;
+    readonly publishedProvenance?: SourceSnapshot;
+    readonly publicationReview?: ReviewSnapshot;
+    readonly publicationHeld: boolean;
+    readonly revokedEvidence: readonly EvidenceRevocation[];
+}
+export interface StoredCollection {
+    readonly generation: number;
+    readonly collection: Collection;
+    readonly configuration?: GovernanceConfiguration;
+}
+export interface StoredValidationPolicy {
+    readonly generation: number;
+    readonly policy: ValidationPolicy;
+}
+export type KnowledgeRecordKind = "head" | "revision" | "evidence" | "review" | "publication" | "provenance" | "revocation" | "collection-policy" | "configuration" | "policy" | "audit" | "command" | "job";
+export interface KnowledgeRecord {
+    readonly schemaVersion: 1;
+    readonly resourceKind: ResourceKind;
+    readonly resourceId: string;
+    readonly partition: string;
+    readonly id: string;
+    readonly kind: KnowledgeRecordKind;
+    readonly data: unknown;
+}
+export declare const maximumRecordNativeBytes = 900000;
+export declare const maximumTransactionEncodedBytes: number;
+export declare const maximumTransactionActions = 100;
+export declare function encodeKnowledgeRecord(record: KnowledgeRecord): StoredRecord;
+export declare function decodeKnowledgeRecord(record: StoredRecord): KnowledgeRecord;
+export declare const knowledgeRecords: import("@pegma/storage-core").CollectionDefinition<KnowledgeRecord>;
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AASpB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,cAAc,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,cAAc,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,mBAAmB,GACnB,eAAe,GACf,QAAQ,GACR,OAAO,GACP,SAAS,GACT,KAAK,CAAC;AAEV,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAChD,eAAO,MAAM,8BAA8B,QAAkB,CAAC;AAC9D,eAAO,MAAM,yBAAyB,MAAM,CAAC;AA8C7C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CA0B3E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CA8C3E;AAED,eAAO,MAAM,gBAAgB,qEAI3B,CAAC"}

package/dist/records.js

@@ -0,0 +1,122 @@
+import { defineCollection } from "@pegma/storage-core";
+import { canonicalJson, RepositoryCapacityError, RepositoryIntegrityError, requireGeneration, requireIdentifier, } from "./storage-helpers.js";
+export const maximumRecordNativeBytes = 900_000;
+export const maximumTransactionEncodedBytes = 3 * 1024 * 1024;
+export const maximumTransactionActions = 100;
+const chunkCharacters = 30_000;
+const maximumChunks = 15;
+const kinds = [
+    "head",
+    "revision",
+    "evidence",
+    "review",
+    "publication",
+    "provenance",
+    "revocation",
+    "collection-policy",
+    "configuration",
+    "policy",
+    "audit",
+    "command",
+    "job",
+];
+function validateRecord(record) {
+    if (record.schemaVersion !== 1 ||
+        !["article", "collection", "validation"].includes(record.resourceKind) ||
+        !kinds.includes(record.kind))
+        throw new RepositoryIntegrityError();
+    requireIdentifier(record.resourceId);
+    if (record.data === null ||
+        typeof record.data !== "object" ||
+        Array.isArray(record.data))
+        throw new RepositoryIntegrityError();
+    if (typeof record.partition !== "string" ||
+        typeof record.id !== "string" ||
+        !new RegExp("^" + record.resourceKind + ":[a-f0-9]{64}$", "u").test(record.partition) ||
+        record.id.length === 0 ||
+        record.id.length > 300 ||
+        /[^A-Za-z0-9|:._-]/u.test(record.id))
+        throw new RepositoryIntegrityError();
+}
+export function encodeKnowledgeRecord(record) {
+    validateRecord(record);
+    const payload = canonicalJson(record.data);
+    if (payload.length * 2 > maximumRecordNativeBytes - 4_096)
+        throw new RepositoryCapacityError("record_bytes");
+    const parts = [];
+    for (let offset = 0; offset < payload.length;) {
+        let end = Math.min(payload.length, offset + chunkCharacters);
+        const last = payload.charCodeAt(end - 1);
+        if (end < payload.length && last >= 0xd800 && last <= 0xdbff)
+            end -= 1;
+        parts.push(payload.slice(offset, end));
+        offset = end;
+    }
+    if (parts.length === 0 || parts.length > maximumChunks)
+        throw new RepositoryCapacityError("record_chunks");
+    const encoded = {
+        schemaVersion: 1,
+        resourceKind: record.resourceKind,
+        resourceId: record.resourceId,
+        recordPartition: record.partition,
+        recordId: record.id,
+        kind: record.kind,
+        partCount: parts.length,
+    };
+    for (const [index, part] of parts.entries())
+        encoded["part" + index] = part;
+    return encoded;
+}
+export function decodeKnowledgeRecord(record) {
+    try {
+        if (record.schemaVersion !== 1 || typeof record.partCount !== "number")
+            throw new RepositoryIntegrityError();
+        requireGeneration(record.partCount, 1);
+        if (record.partCount > maximumChunks)
+            throw new RepositoryIntegrityError();
+        const expected = new Set([
+            "schemaVersion",
+            "resourceKind",
+            "resourceId",
+            "recordPartition",
+            "recordId",
+            "kind",
+            "partCount",
+            ...Array.from({ length: record.partCount }, (_, index) => "part" + index),
+        ]);
+        if (Object.keys(record).length !== expected.size ||
+            Object.keys(record).some((key) => !expected.has(key)))
+            throw new RepositoryIntegrityError();
+        const parts = [];
+        for (let index = 0; index < record.partCount; index += 1) {
+            const part = record["part" + index];
+            if (typeof part !== "string" || part.length > chunkCharacters)
+                throw new RepositoryIntegrityError();
+            parts.push(part);
+        }
+        const payload = parts.join("");
+        if (payload.length * 2 > maximumRecordNativeBytes - 4_096)
+            throw new RepositoryIntegrityError();
+        const decoded = {
+            schemaVersion: 1,
+            resourceKind: record.resourceKind,
+            resourceId: record.resourceId,
+            partition: record.recordPartition,
+            id: record.recordId,
+            kind: record.kind,
+            data: JSON.parse(payload),
+        };
+        validateRecord(decoded);
+        canonicalJson(decoded.data);
+        return decoded;
+    }
+    catch {
+        throw new RepositoryIntegrityError();
+    }
+}
+export const knowledgeRecords = defineCollection({
+    name: "knowledge-base.records.v1",
+    key: (record) => ({ partition: record.partition, id: record.id }),
+    codec: { encode: encodeKnowledgeRecord, decode: decodeKnowledgeRecord },
+});
+//# sourceMappingURL=records.js.map

package/dist/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAY1E,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAmD9B,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAChD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9D,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,KAAK,GAAsB;IAC/B,MAAM;IACN,UAAU;IACV,UAAU;IACV,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,mBAAmB;IACnB,eAAe;IACf,QAAQ;IACR,OAAO;IACP,SAAS;IACT,KAAK;CACN,CAAC;AAEF,SAAS,cAAc,CAAC,MAAuB;IAC7C,IACE,MAAM,CAAC,aAAa,KAAK,CAAC;QAC1B,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC;QACtE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;QAE5B,MAAM,IAAI,wBAAwB,EAAE,CAAC;IACvC,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrC,IACE,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QAE1B,MAAM,IAAI,wBAAwB,EAAE,CAAC;IACvC,IACE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;QAC7B,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,YAAY,GAAG,gBAAgB,EAAE,GAAG,CAAC,CAAC,IAAI,CACjE,MAAM,CAAC,SAAS,CACjB;QACD,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QACtB,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG;QACtB,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAEpC,MAAM,IAAI,wBAAwB,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,wBAAwB,GAAG,KAAK;QACvD,MAAM,IAAI,uBAAuB,CAAC,cAAc,CAAC,CAAC;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;QAC9C,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;YAAE,GAAG,IAAI,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa;QACpD,MAAM,IAAI,uBAAuB,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,OAAO,GAAoC;QAC/C,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,eAAe,EAAE,MAAM,CAAC,SAAS;QACjC,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,KAAK,CAAC,MAAM;KACxB,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IAC5E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACpE,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACvC,iBAAiB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,SAAS,GAAG,aAAa;YAAE,MAAM,IAAI,wBAAwB,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;YACvB,eAAe;YACf,cAAc;YACd,YAAY;YACZ,iBAAiB;YACjB,UAAU;YACV,MAAM;YACN,WAAW;YACX,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC;SAC1E,CAAC,CAAC;QACH,IACE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI;YAC5C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAErD,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;YACpC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe;gBAC3D,MAAM,IAAI,wBAAwB,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,wBAAwB,GAAG,KAAK;YACvD,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACvC,MAAM,OAAO,GAAoB;YAC/B,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,MAAM,CAAC,YAA4B;YACjD,UAAU,EAAE,MAAM,CAAC,UAAoB;YACvC,SAAS,EAAE,MAAM,CAAC,eAAyB;YAC3C,EAAE,EAAE,MAAM,CAAC,QAAkB;YAC7B,IAAI,EAAE,MAAM,CAAC,IAA2B;YACxC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY;SACrC,CAAC;QACF,cAAc,CAAC,OAAO,CAAC,CAAC;QACxB,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,wBAAwB,EAAE,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAkB;IAChE,IAAI,EAAE,2BAA2B;IACjC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;IACjE,KAAK,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,qBAAqB,EAAE;CACxE,CAAC,CAAC"}

package/dist/repository.d.ts

@@ -0,0 +1,74 @@
+import { type AuditDetails } from "@pegma/audit";
+import type { IsoTimestamp, PrincipalId, VerificationEvidence, ArticleRevision, Article, PublishedArticle } from "@pegma/knowledge-base-contracts";
+import type { Store } from "@pegma/storage-core";
+import { type ResourceKind, type StoredArticle, type StoredCollection, type StoredValidationPolicy } from "./records.js";
+import type { ReviewSnapshot, SourceSnapshot } from "./types.js";
+export interface KnowledgeRepositoryLimits {
+    readonly maxPhysicalRows: number;
+    readonly maxRetainedBytes: number;
+    readonly controlReserveRows: number;
+    readonly controlReserveBytes: number;
+    readonly maxArticleRevisions: number;
+    readonly maxEvidenceVersions: number;
+    readonly maxConflictAttempts: number;
+}
+export interface VersionedState<T> {
+    readonly value: T;
+    readonly version: string;
+}
+export interface RepositoryCommand {
+    readonly commandId: string;
+    readonly correlationId: string;
+    readonly actorId: PrincipalId;
+    readonly operation: string;
+    readonly fingerprint: string;
+    readonly occurredAt: IsoTimestamp;
+}
+export interface KnowledgeJobInput {
+    readonly task: "article_changed" | "collection_changed" | "validation_changed";
+    readonly payload?: Readonly<Record<string, string | number | boolean | null>>;
+}
+export interface MutationInput<T> {
+    readonly id: string;
+    readonly command: RepositoryCommand;
+    readonly expectedGeneration?: number;
+    readonly control?: boolean;
+    readonly recheck: (current: T | null) => Promise<void>;
+    readonly decide: (current: T | null, nextGeneration: number) => Promise<{
+        readonly next: Omit<T, "generation">;
+        readonly jobs?: readonly KnowledgeJobInput[];
+        readonly auditDetails?: AuditDetails;
+    }>;
+}
+export interface RepositoryResult<T> {
+    readonly value: T;
+    readonly replayed: boolean;
+}
+/** Publication-only hydration; unrelated current draft/proofs remain private. */
+export interface ArticlePublicationState {
+    readonly articleId: string;
+    readonly generation: number;
+    readonly state: Article["state"];
+    readonly publicationHeld: boolean;
+    readonly published?: PublishedArticle;
+    readonly publishedProvenance?: SourceSnapshot;
+    readonly publicationReview?: ReviewSnapshot;
+}
+export interface KnowledgeRepository {
+    readonly limits: KnowledgeRepositoryLimits;
+    readArticleVersioned(id: string): Promise<VersionedState<StoredArticle> | null>;
+    readArticlePublicationVersioned(id: string): Promise<VersionedState<ArticlePublicationState> | null>;
+    /** One keyed head read; never hydrates draft, evidence, or private source rows. */
+    readResourceGeneration(kind: ResourceKind, id: string): Promise<number | null>;
+    readCollectionVersioned(id: string): Promise<VersionedState<StoredCollection> | null>;
+    readValidationPolicyVersioned(id: string): Promise<VersionedState<StoredValidationPolicy> | null>;
+    getArticleRevision(id: string, revision: number): Promise<ArticleRevision | null>;
+    getEvidenceVersion(id: string, articleRevision: number, evidenceId: string, version: number): Promise<VerificationEvidence | null>;
+    isEvidenceRevoked(id: string, hash: string): Promise<boolean>;
+    executeArticle(input: MutationInput<StoredArticle>): Promise<RepositoryResult<StoredArticle>>;
+    executeCollection(input: MutationInput<StoredCollection>): Promise<RepositoryResult<StoredCollection>>;
+    executeValidationPolicy(input: MutationInput<StoredValidationPolicy>): Promise<RepositoryResult<StoredValidationPolicy>>;
+}
+export declare const defaultKnowledgeRepositoryLimits: KnowledgeRepositoryLimits;
+export declare function createKnowledgeRepository(store: Store, overrides?: Partial<KnowledgeRepositoryLimits>): KnowledgeRepository;
+//# sourceMappingURL=repository.d.ts.map

package/dist/repository.d.ts.map

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