@native-knowledge/knowledge-sdk 0.0.0-stage → 0.1.0-rc.2

package/dist/internal/contracts/review-plane.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { accessClassificationSchema, idSchema, isoDateTimeSchema, projectKeySchema, schemaVersionSchema, sha256Schema, stableUriSchema, } from './common.js';
+import { artifactKindSchema } from './artifact.js';
+import { driveRelativePathSchema } from './projection.js';
+export const reviewPlaneStageSchema = z.enum([
+    'PROGRAM',
+    'INBOX',
+    'REVIEWED',
+    'USER_APPROVED',
+    'PROMOTION_RECEIPTS',
+    'GUIDES',
+    'REJECTED_SUPERSEDED',
+]);
+export const reviewPlaneWorkspaceSchema = z.object({
+    schemaVersion: schemaVersionSchema,
+    projectKey: projectKeySchema,
+    provider: z.literal('GOOGLE_DRIVE'),
+    rootPath: driveRelativePathSchema,
+    folders: z.object({
+        PROGRAM: driveRelativePathSchema,
+        INBOX: driveRelativePathSchema,
+        REVIEWED: driveRelativePathSchema,
+        USER_APPROVED: driveRelativePathSchema,
+        PROMOTION_RECEIPTS: driveRelativePathSchema,
+        GUIDES: driveRelativePathSchema.optional(),
+        REJECTED_SUPERSEDED: driveRelativePathSchema,
+    }).strict(),
+}).strict().superRefine((value, ctx) => {
+    const seen = new Set();
+    for (const [key, folder] of Object.entries(value.folders)) {
+        if (folder === undefined)
+            continue;
+        if (seen.has(folder))
+            ctx.addIssue({ code: 'custom', path: ['folders', key], message: 'review-plane folders must be unique' });
+        seen.add(folder);
+    }
+});
+export const reviewPlaneApprovalSchema = z.object({
+    schemaVersion: schemaVersionSchema,
+    approvalId: idSchema,
+    projectKey: projectKeySchema,
+    sourceProvider: z.literal('GOOGLE_DRIVE'),
+    sourcePath: driveRelativePathSchema,
+    sourceFileId: z.string().trim().min(1).max(512).nullable(),
+    sourceContentHash: sha256Schema,
+    sourceArtifactRef: stableUriSchema.nullable(),
+    reviewedAt: isoDateTimeSchema,
+    approvedAt: isoDateTimeSchema,
+    decision: z.literal('PASS'),
+    approvalAuthority: z.literal('EXPLICIT_HUMAN'),
+    hostDisposition: z.enum(['APPROVED_RESEARCH', 'APPROVED_KNOWLEDGE', 'APPROVED_INSIGHT']),
+    targetArtifactId: idSchema,
+    targetVersion: z.number().int().positive(),
+    targetTitle: z.string().trim().min(1).max(500),
+    mediaType: z.string().trim().min(1).max(256),
+    observedAt: isoDateTimeSchema.nullable(),
+    validUntil: isoDateTimeSchema.nullable(),
+    access: accessClassificationSchema,
+    evidenceRefs: z.array(stableUriSchema).max(256),
+    approvalEvidenceRefs: z.array(stableUriSchema).max(256),
+    supersedesRef: stableUriSchema.nullable(),
+}).strict().superRefine((value, ctx) => {
+    if (Date.parse(value.approvedAt) < Date.parse(value.reviewedAt))
+        ctx.addIssue({ code: 'custom', path: ['approvedAt'], message: 'approvedAt must not precede reviewedAt' });
+    if (value.validUntil && value.observedAt && Date.parse(value.validUntil) < Date.parse(value.observedAt))
+        ctx.addIssue({ code: 'custom', path: ['validUntil'], message: 'validUntil must not precede observedAt' });
+    if (value.targetVersion === 1 && value.supersedesRef !== null)
+        ctx.addIssue({ code: 'custom', path: ['supersedesRef'], message: 'version 1 cannot supersede' });
+    if (value.targetVersion > 1 && value.supersedesRef === null)
+        ctx.addIssue({ code: 'custom', path: ['supersedesRef'], message: 'later version requires exact predecessor ref' });
+});
+export const reviewPlanePromotionReceiptSchema = z.object({
+    schemaVersion: schemaVersionSchema,
+    projectKey: projectKeySchema,
+    approvalId: idSchema,
+    sourcePath: driveRelativePathSchema,
+    sourceFileId: z.string().trim().min(1).max(512).nullable(),
+    sourceContentHash: sha256Schema,
+    promotedAt: isoDateTimeSchema,
+    targetKind: artifactKindSchema,
+    draftRef: stableUriSchema,
+    readyRef: stableUriSchema,
+    reviewRef: stableUriSchema,
+    approvedRef: stableUriSchema,
+    approvedContentHash: sha256Schema,
+    exactBytesVerified: z.literal(true),
+    humanApprovalVerified: z.literal(true),
+    automaticPromotion: z.literal(false),
+}).strict();