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

package/dist/types/contracts/currentness.d.ts

@@ -0,0 +1,477 @@
+import { z } from 'zod';
+export declare const currentnessStateSchema: z.ZodEnum<{
+    UNKNOWN: "UNKNOWN";
+    DUE: "DUE";
+    CURRENT: "CURRENT";
+    STALE: "STALE";
+    BLOCKED: "BLOCKED";
+}>;
+export declare const currentnessActionSchema: z.ZodEnum<{
+    ALLOW: "ALLOW";
+    REVIEW_REQUIRED: "REVIEW_REQUIRED";
+    DENY: "DENY";
+}>;
+export declare const currentnessSubjectKindSchema: z.ZodEnum<{
+    SOURCE: "SOURCE";
+    EVIDENCE: "EVIDENCE";
+    ARTIFACT: "ARTIFACT";
+}>;
+export declare const currentnessPolicySchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    dueAfterSeconds: z.ZodNumber;
+    staleAfterSeconds: z.ZodNumber;
+    staleAction: z.ZodDefault<z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>>;
+    unknownAction: z.ZodDefault<z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>>;
+    blockedAction: z.ZodDefault<z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>>;
+}, z.core.$strict>;
+export declare const currentnessReasonCodeSchema: z.ZodEnum<{
+    CURRENT_WITHIN_CADENCE: "CURRENT_WITHIN_CADENCE";
+    REFRESH_DUE: "REFRESH_DUE";
+    STALE_AFTER_THRESHOLD: "STALE_AFTER_THRESHOLD";
+    SOURCE_BLOCKED: "SOURCE_BLOCKED";
+    SOURCE_CONTENT_CHANGED: "SOURCE_CONTENT_CHANGED";
+    NO_SUCCESSFUL_OBSERVATION: "NO_SUCCESSFUL_OBSERVATION";
+}>;
+export declare const currentnessAssessmentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    subjectRef: z.ZodString;
+    subjectKind: z.ZodEnum<{
+        SOURCE: "SOURCE";
+        EVIDENCE: "EVIDENCE";
+        ARTIFACT: "ARTIFACT";
+    }>;
+    projectRef: z.ZodOptional<z.ZodString>;
+    sourceRevisionRef: z.ZodOptional<z.ZodString>;
+    basisRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    state: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
+        DUE: "DUE";
+        CURRENT: "CURRENT";
+        STALE: "STALE";
+        BLOCKED: "BLOCKED";
+    }>;
+    action: z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>;
+    assessedAt: z.ZodISODateTime;
+    observedAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    lastSuccessAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    lastAttemptAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    dueAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    staleAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    ageSeconds: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    reasonCode: z.ZodEnum<{
+        CURRENT_WITHIN_CADENCE: "CURRENT_WITHIN_CADENCE";
+        REFRESH_DUE: "REFRESH_DUE";
+        STALE_AFTER_THRESHOLD: "STALE_AFTER_THRESHOLD";
+        SOURCE_BLOCKED: "SOURCE_BLOCKED";
+        SOURCE_CONTENT_CHANGED: "SOURCE_CONTENT_CHANGED";
+        NO_SUCCESSFUL_OBSERVATION: "NO_SUCCESSFUL_OBSERVATION";
+    }>;
+    policy: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        dueAfterSeconds: z.ZodNumber;
+        staleAfterSeconds: z.ZodNumber;
+        staleAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+        unknownAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+        blockedAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type CurrentnessState = z.infer<typeof currentnessStateSchema>;
+export type CurrentnessReasonCode = z.infer<typeof currentnessReasonCodeSchema>;
+export type CurrentnessAction = z.infer<typeof currentnessActionSchema>;
+export type CurrentnessPolicy = z.infer<typeof currentnessPolicySchema>;
+export type CurrentnessAssessment = z.infer<typeof currentnessAssessmentSchema>;
+export declare const claimCurrentnessStatusSchema: z.ZodEnum<{
+    SUPERSEDED: "SUPERSEDED";
+    CURRENT: "CURRENT";
+    PARTIALLY_SUPERSEDED: "PARTIALLY_SUPERSEDED";
+    PENDING_CURRENTNESS_REVIEW: "PENDING_CURRENTNESS_REVIEW";
+    HISTORICAL_REFERENCE: "HISTORICAL_REFERENCE";
+    DYNAMIC_CURRENT: "DYNAMIC_CURRENT";
+    DYNAMIC_EXPIRED: "DYNAMIC_EXPIRED";
+}>;
+export declare const claimCurrentnessRiskSchema: z.ZodEnum<{
+    STANDARD: "STANDARD";
+    HIGH: "HIGH";
+}>;
+export declare const claimTimeSensitivitySchema: z.ZodEnum<{
+    DURABLE: "DURABLE";
+    TIME_SENSITIVE: "TIME_SENSITIVE";
+    DYNAMIC: "DYNAMIC";
+}>;
+export declare const claimReviewTriggerSchema: z.ZodEnum<{
+    SCHEDULED_REFRESH: "SCHEDULED_REFRESH";
+    SAME_URL_DIFFERENT_HASH: "SAME_URL_DIFFERENT_HASH";
+    LATER_OFFICIAL_SOURCE: "LATER_OFFICIAL_SOURCE";
+    REGULATORY_ACTION: "REGULATORY_ACTION";
+    OPERATOR_TRANSITION: "OPERATOR_TRANSITION";
+    CORRECTION: "CORRECTION";
+    DYNAMIC_EXPIRY: "DYNAMIC_EXPIRY";
+    INITIAL_REVIEW: "INITIAL_REVIEW";
+}>;
+export declare const claimCurrentnessChangeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    artifactRef: z.ZodString;
+    claimId: z.ZodString;
+    scope: z.ZodString;
+    status: z.ZodEnum<{
+        SUPERSEDED: "SUPERSEDED";
+        CURRENT: "CURRENT";
+        PARTIALLY_SUPERSEDED: "PARTIALLY_SUPERSEDED";
+        PENDING_CURRENTNESS_REVIEW: "PENDING_CURRENTNESS_REVIEW";
+        HISTORICAL_REFERENCE: "HISTORICAL_REFERENCE";
+        DYNAMIC_CURRENT: "DYNAMIC_CURRENT";
+        DYNAMIC_EXPIRED: "DYNAMIC_EXPIRED";
+    }>;
+    risk: z.ZodDefault<z.ZodEnum<{
+        STANDARD: "STANDARD";
+        HIGH: "HIGH";
+    }>>;
+    timeSensitivity: z.ZodDefault<z.ZodEnum<{
+        DURABLE: "DURABLE";
+        TIME_SENSITIVE: "TIME_SENSITIVE";
+        DYNAMIC: "DYNAMIC";
+    }>>;
+    effectiveFrom: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    effectiveUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    discoveredAt: z.ZodISODateTime;
+    reviewTrigger: z.ZodEnum<{
+        SCHEDULED_REFRESH: "SCHEDULED_REFRESH";
+        SAME_URL_DIFFERENT_HASH: "SAME_URL_DIFFERENT_HASH";
+        LATER_OFFICIAL_SOURCE: "LATER_OFFICIAL_SOURCE";
+        REGULATORY_ACTION: "REGULATORY_ACTION";
+        OPERATOR_TRANSITION: "OPERATOR_TRANSITION";
+        CORRECTION: "CORRECTION";
+        DYNAMIC_EXPIRY: "DYNAMIC_EXPIRY";
+        INITIAL_REVIEW: "INITIAL_REVIEW";
+    }>;
+    previousEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    currentEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    replacementArtifactRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export declare const claimCurrentnessDecisionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    artifactRef: z.ZodString;
+    claimId: z.ZodString;
+    scope: z.ZodString;
+    status: z.ZodEnum<{
+        SUPERSEDED: "SUPERSEDED";
+        CURRENT: "CURRENT";
+        PARTIALLY_SUPERSEDED: "PARTIALLY_SUPERSEDED";
+        PENDING_CURRENTNESS_REVIEW: "PENDING_CURRENTNESS_REVIEW";
+        HISTORICAL_REFERENCE: "HISTORICAL_REFERENCE";
+        DYNAMIC_CURRENT: "DYNAMIC_CURRENT";
+        DYNAMIC_EXPIRED: "DYNAMIC_EXPIRED";
+    }>;
+    risk: z.ZodDefault<z.ZodEnum<{
+        STANDARD: "STANDARD";
+        HIGH: "HIGH";
+    }>>;
+    timeSensitivity: z.ZodDefault<z.ZodEnum<{
+        DURABLE: "DURABLE";
+        TIME_SENSITIVE: "TIME_SENSITIVE";
+        DYNAMIC: "DYNAMIC";
+    }>>;
+    effectiveFrom: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    effectiveUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    discoveredAt: z.ZodISODateTime;
+    reviewTrigger: z.ZodEnum<{
+        SCHEDULED_REFRESH: "SCHEDULED_REFRESH";
+        SAME_URL_DIFFERENT_HASH: "SAME_URL_DIFFERENT_HASH";
+        LATER_OFFICIAL_SOURCE: "LATER_OFFICIAL_SOURCE";
+        REGULATORY_ACTION: "REGULATORY_ACTION";
+        OPERATOR_TRANSITION: "OPERATOR_TRANSITION";
+        CORRECTION: "CORRECTION";
+        DYNAMIC_EXPIRY: "DYNAMIC_EXPIRY";
+        INITIAL_REVIEW: "INITIAL_REVIEW";
+    }>;
+    previousEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    currentEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    replacementArtifactRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    reason: z.ZodString;
+    reviewedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const claimCurrentnessProposalSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"CLAIM_CURRENTNESS_PROPOSAL">;
+    projectKey: z.ZodString;
+    proposalId: z.ZodString;
+    artifactRef: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    changes: z.ZodArray<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        artifactRef: z.ZodString;
+        claimId: z.ZodString;
+        scope: z.ZodString;
+        status: z.ZodEnum<{
+            SUPERSEDED: "SUPERSEDED";
+            CURRENT: "CURRENT";
+            PARTIALLY_SUPERSEDED: "PARTIALLY_SUPERSEDED";
+            PENDING_CURRENTNESS_REVIEW: "PENDING_CURRENTNESS_REVIEW";
+            HISTORICAL_REFERENCE: "HISTORICAL_REFERENCE";
+            DYNAMIC_CURRENT: "DYNAMIC_CURRENT";
+            DYNAMIC_EXPIRED: "DYNAMIC_EXPIRED";
+        }>;
+        risk: z.ZodDefault<z.ZodEnum<{
+            STANDARD: "STANDARD";
+            HIGH: "HIGH";
+        }>>;
+        timeSensitivity: z.ZodDefault<z.ZodEnum<{
+            DURABLE: "DURABLE";
+            TIME_SENSITIVE: "TIME_SENSITIVE";
+            DYNAMIC: "DYNAMIC";
+        }>>;
+        effectiveFrom: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        effectiveUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        discoveredAt: z.ZodISODateTime;
+        reviewTrigger: z.ZodEnum<{
+            SCHEDULED_REFRESH: "SCHEDULED_REFRESH";
+            SAME_URL_DIFFERENT_HASH: "SAME_URL_DIFFERENT_HASH";
+            LATER_OFFICIAL_SOURCE: "LATER_OFFICIAL_SOURCE";
+            REGULATORY_ACTION: "REGULATORY_ACTION";
+            OPERATOR_TRANSITION: "OPERATOR_TRANSITION";
+            CORRECTION: "CORRECTION";
+            DYNAMIC_EXPIRY: "DYNAMIC_EXPIRY";
+            INITIAL_REVIEW: "INITIAL_REVIEW";
+        }>;
+        previousEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        currentEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        replacementArtifactRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        reason: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const claimCurrentnessLedgerSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    ledgerId: z.ZodString;
+    projectKey: z.ZodString;
+    artifactRef: z.ZodString;
+    proposalRef: z.ZodString;
+    reviewRef: z.ZodString;
+    reviewedAt: z.ZodISODateTime;
+    decisionsHash: z.ZodString;
+    decisions: z.ZodArray<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        artifactRef: z.ZodString;
+        claimId: z.ZodString;
+        scope: z.ZodString;
+        status: z.ZodEnum<{
+            SUPERSEDED: "SUPERSEDED";
+            CURRENT: "CURRENT";
+            PARTIALLY_SUPERSEDED: "PARTIALLY_SUPERSEDED";
+            PENDING_CURRENTNESS_REVIEW: "PENDING_CURRENTNESS_REVIEW";
+            HISTORICAL_REFERENCE: "HISTORICAL_REFERENCE";
+            DYNAMIC_CURRENT: "DYNAMIC_CURRENT";
+            DYNAMIC_EXPIRED: "DYNAMIC_EXPIRED";
+        }>;
+        risk: z.ZodDefault<z.ZodEnum<{
+            STANDARD: "STANDARD";
+            HIGH: "HIGH";
+        }>>;
+        timeSensitivity: z.ZodDefault<z.ZodEnum<{
+            DURABLE: "DURABLE";
+            TIME_SENSITIVE: "TIME_SENSITIVE";
+            DYNAMIC: "DYNAMIC";
+        }>>;
+        effectiveFrom: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        effectiveUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        discoveredAt: z.ZodISODateTime;
+        reviewTrigger: z.ZodEnum<{
+            SCHEDULED_REFRESH: "SCHEDULED_REFRESH";
+            SAME_URL_DIFFERENT_HASH: "SAME_URL_DIFFERENT_HASH";
+            LATER_OFFICIAL_SOURCE: "LATER_OFFICIAL_SOURCE";
+            REGULATORY_ACTION: "REGULATORY_ACTION";
+            OPERATOR_TRANSITION: "OPERATOR_TRANSITION";
+            CORRECTION: "CORRECTION";
+            DYNAMIC_EXPIRY: "DYNAMIC_EXPIRY";
+            INITIAL_REVIEW: "INITIAL_REVIEW";
+        }>;
+        previousEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        currentEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        replacementArtifactRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        reason: z.ZodString;
+        reviewedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ClaimCurrentnessStatus = z.infer<typeof claimCurrentnessStatusSchema>;
+export type ClaimCurrentnessChange = z.infer<typeof claimCurrentnessChangeSchema>;
+export type ClaimCurrentnessDecision = z.infer<typeof claimCurrentnessDecisionSchema>;
+export type ClaimCurrentnessProposal = z.infer<typeof claimCurrentnessProposalSchema>;
+export type ClaimCurrentnessLedger = z.infer<typeof claimCurrentnessLedgerSchema>;
+export declare const artifactSemanticStatusSchema: z.ZodEnum<{
+    SUPERSEDED: "SUPERSEDED";
+    REVIEWED: "REVIEWED";
+}>;
+export declare const artifactSupportStateSchema: z.ZodEnum<{
+    SUPERSEDED: "SUPERSEDED";
+    REFRESH_DUE: "REFRESH_DUE";
+    CURRENTLY_SUPPORTED: "CURRENTLY_SUPPORTED";
+    CURRENTNESS_REVIEW_REQUIRED: "CURRENTNESS_REVIEW_REQUIRED";
+    CURRENTNESS_DENIED: "CURRENTNESS_DENIED";
+}>;
+export declare const artifactSupportEvidenceSchema: z.ZodObject<{
+    evidenceRef: z.ZodString;
+    state: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
+        DUE: "DUE";
+        CURRENT: "CURRENT";
+        STALE: "STALE";
+        BLOCKED: "BLOCKED";
+    }>;
+    action: z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>;
+    assessedAt: z.ZodISODateTime;
+    lastSuccessAt: z.ZodNullable<z.ZodISODateTime>;
+    reasonCode: z.ZodEnum<{
+        CURRENT_WITHIN_CADENCE: "CURRENT_WITHIN_CADENCE";
+        REFRESH_DUE: "REFRESH_DUE";
+        STALE_AFTER_THRESHOLD: "STALE_AFTER_THRESHOLD";
+        SOURCE_BLOCKED: "SOURCE_BLOCKED";
+        SOURCE_CONTENT_CHANGED: "SOURCE_CONTENT_CHANGED";
+        NO_SUCCESSFUL_OBSERVATION: "NO_SUCCESSFUL_OBSERVATION";
+    }>;
+}, z.core.$strict>;
+export declare const artifactSupportAssessmentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    artifactRef: z.ZodString;
+    identityRef: z.ZodString;
+    projectKey: z.ZodString;
+    artifactKind: z.ZodEnum<{
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    semanticStatus: z.ZodEnum<{
+        SUPERSEDED: "SUPERSEDED";
+        REVIEWED: "REVIEWED";
+    }>;
+    supportState: z.ZodEnum<{
+        SUPERSEDED: "SUPERSEDED";
+        REFRESH_DUE: "REFRESH_DUE";
+        CURRENTLY_SUPPORTED: "CURRENTLY_SUPPORTED";
+        CURRENTNESS_REVIEW_REQUIRED: "CURRENTNESS_REVIEW_REQUIRED";
+        CURRENTNESS_DENIED: "CURRENTNESS_DENIED";
+    }>;
+    action: z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>;
+    assessedAt: z.ZodISODateTime;
+    validUntil: z.ZodNullable<z.ZodISODateTime>;
+    evidence: z.ZodArray<z.ZodObject<{
+        evidenceRef: z.ZodString;
+        state: z.ZodEnum<{
+            UNKNOWN: "UNKNOWN";
+            DUE: "DUE";
+            CURRENT: "CURRENT";
+            STALE: "STALE";
+            BLOCKED: "BLOCKED";
+        }>;
+        action: z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>;
+        assessedAt: z.ZodISODateTime;
+        lastSuccessAt: z.ZodNullable<z.ZodISODateTime>;
+        reasonCode: z.ZodEnum<{
+            CURRENT_WITHIN_CADENCE: "CURRENT_WITHIN_CADENCE";
+            REFRESH_DUE: "REFRESH_DUE";
+            STALE_AFTER_THRESHOLD: "STALE_AFTER_THRESHOLD";
+            SOURCE_BLOCKED: "SOURCE_BLOCKED";
+            SOURCE_CONTENT_CHANGED: "SOURCE_CONTENT_CHANGED";
+            NO_SUCCESSFUL_OBSERVATION: "NO_SUCCESSFUL_OBSERVATION";
+        }>;
+    }, z.core.$strict>>;
+    claims: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        artifactRef: z.ZodString;
+        claimId: z.ZodString;
+        scope: z.ZodString;
+        status: z.ZodEnum<{
+            SUPERSEDED: "SUPERSEDED";
+            CURRENT: "CURRENT";
+            PARTIALLY_SUPERSEDED: "PARTIALLY_SUPERSEDED";
+            PENDING_CURRENTNESS_REVIEW: "PENDING_CURRENTNESS_REVIEW";
+            HISTORICAL_REFERENCE: "HISTORICAL_REFERENCE";
+            DYNAMIC_CURRENT: "DYNAMIC_CURRENT";
+            DYNAMIC_EXPIRED: "DYNAMIC_EXPIRED";
+        }>;
+        risk: z.ZodDefault<z.ZodEnum<{
+            STANDARD: "STANDARD";
+            HIGH: "HIGH";
+        }>>;
+        timeSensitivity: z.ZodDefault<z.ZodEnum<{
+            DURABLE: "DURABLE";
+            TIME_SENSITIVE: "TIME_SENSITIVE";
+            DYNAMIC: "DYNAMIC";
+        }>>;
+        effectiveFrom: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        effectiveUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        discoveredAt: z.ZodISODateTime;
+        reviewTrigger: z.ZodEnum<{
+            SCHEDULED_REFRESH: "SCHEDULED_REFRESH";
+            SAME_URL_DIFFERENT_HASH: "SAME_URL_DIFFERENT_HASH";
+            LATER_OFFICIAL_SOURCE: "LATER_OFFICIAL_SOURCE";
+            REGULATORY_ACTION: "REGULATORY_ACTION";
+            OPERATOR_TRANSITION: "OPERATOR_TRANSITION";
+            CORRECTION: "CORRECTION";
+            DYNAMIC_EXPIRY: "DYNAMIC_EXPIRY";
+            INITIAL_REVIEW: "INITIAL_REVIEW";
+        }>;
+        previousEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        currentEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        replacementArtifactRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        reason: z.ZodString;
+        reviewedAt: z.ZodISODateTime;
+    }, z.core.$strict>>>;
+    missingEvidenceRefs: z.ZodArray<z.ZodString>;
+    reasonCodes: z.ZodArray<z.ZodEnum<{
+        ALL_EVIDENCE_CURRENT: "ALL_EVIDENCE_CURRENT";
+        EVIDENCE_REFRESH_DUE: "EVIDENCE_REFRESH_DUE";
+        EVIDENCE_REVIEW_REQUIRED: "EVIDENCE_REVIEW_REQUIRED";
+        EVIDENCE_DENIED: "EVIDENCE_DENIED";
+        EVIDENCE_CURRENTNESS_MISSING: "EVIDENCE_CURRENTNESS_MISSING";
+        ARTIFACT_EVIDENCE_REQUIRED: "ARTIFACT_EVIDENCE_REQUIRED";
+        ARTIFACT_VALIDITY_EXPIRED: "ARTIFACT_VALIDITY_EXPIRED";
+        ARTIFACT_EXPLICITLY_SUPERSEDED: "ARTIFACT_EXPLICITLY_SUPERSEDED";
+        CLAIM_PARTIALLY_SUPERSEDED: "CLAIM_PARTIALLY_SUPERSEDED";
+        CLAIM_PENDING_CURRENTNESS_REVIEW: "CLAIM_PENDING_CURRENTNESS_REVIEW";
+        CLAIM_SUPERSEDED: "CLAIM_SUPERSEDED";
+        CLAIM_HISTORICAL_REFERENCE: "CLAIM_HISTORICAL_REFERENCE";
+        CLAIM_DYNAMIC_EXPIRED: "CLAIM_DYNAMIC_EXPIRED";
+    }>>;
+}, z.core.$strict>;
+export type ArtifactSemanticStatus = z.infer<typeof artifactSemanticStatusSchema>;
+export type ArtifactSupportState = z.infer<typeof artifactSupportStateSchema>;
+export type ArtifactSupportAssessment = z.infer<typeof artifactSupportAssessmentSchema>;

package/dist/types/contracts/event.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+export declare const knowledgeEventTypeSchema: z.ZodEnum<{
+    SOURCE_CHANGED: "SOURCE_CHANGED";
+    SOURCE_FAILURE: "SOURCE_FAILURE";
+    REVIEW_READY: "REVIEW_READY";
+    APPROVAL_READY: "APPROVAL_READY";
+    MATERIAL_DRIFT: "MATERIAL_DRIFT";
+    BOUNDARY_RISK: "BOUNDARY_RISK";
+    CURRENTNESS_RISK: "CURRENTNESS_RISK";
+    CLOSURE_MILESTONE: "CLOSURE_MILESTONE";
+    SCHEDULER_FAILURE: "SCHEDULER_FAILURE";
+    SIGNAL_READY: "SIGNAL_READY";
+    GAP_READY: "GAP_READY";
+    PROGRAM_EVOLUTION_READY: "PROGRAM_EVOLUTION_READY";
+}>;
+export declare const eventSeveritySchema: z.ZodEnum<{
+    INFO: "INFO";
+    NORMAL: "NORMAL";
+    WARNING: "WARNING";
+    CRITICAL: "CRITICAL";
+}>;
+export declare const knowledgeEventSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    projectKey: z.ZodOptional<z.ZodString>;
+    projectRef: z.ZodOptional<z.ZodString>;
+    sourceRef: z.ZodOptional<z.ZodString>;
+    sourceRevisionRef: z.ZodOptional<z.ZodString>;
+    collectionBatchRef: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        SOURCE_CHANGED: "SOURCE_CHANGED";
+        SOURCE_FAILURE: "SOURCE_FAILURE";
+        REVIEW_READY: "REVIEW_READY";
+        APPROVAL_READY: "APPROVAL_READY";
+        MATERIAL_DRIFT: "MATERIAL_DRIFT";
+        BOUNDARY_RISK: "BOUNDARY_RISK";
+        CURRENTNESS_RISK: "CURRENTNESS_RISK";
+        CLOSURE_MILESTONE: "CLOSURE_MILESTONE";
+        SCHEDULER_FAILURE: "SCHEDULER_FAILURE";
+        SIGNAL_READY: "SIGNAL_READY";
+        GAP_READY: "GAP_READY";
+        PROGRAM_EVOLUTION_READY: "PROGRAM_EVOLUTION_READY";
+    }>;
+    severity: z.ZodEnum<{
+        INFO: "INFO";
+        NORMAL: "NORMAL";
+        WARNING: "WARNING";
+        CRITICAL: "CRITICAL";
+    }>;
+    createdAt: z.ZodISODateTime;
+    runtimeNodeId: z.ZodOptional<z.ZodString>;
+    artifactRef: z.ZodOptional<z.ZodString>;
+    evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    contentHash: z.ZodOptional<z.ZodString>;
+    requiresUserAction: z.ZodBoolean;
+    dedupeKey: z.ZodString;
+}, z.core.$strict>;
+export type KnowledgeEventType = z.infer<typeof knowledgeEventTypeSchema>;
+export type EventSeverity = z.infer<typeof eventSeveritySchema>;
+export type KnowledgeEvent = z.infer<typeof knowledgeEventSchema>;