@lssm/lib.companyos-spec 3.0.2

package/dist/validation/company-intelligence-learning-record.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as P}from"zod";import{z as h}from"zod";import{z as E}from"zod";var A=E.record(E.string(),E.unknown()),w=E.object({id:E.string().min(1),connectorCapability:E.string().min(1),providerKey:E.string().min(1).optional(),externalId:E.string().min(1).optional(),url:E.string().url().optional(),observedAt:E.string().min(1),metadata:A.default({})}),ft=E.object({default:E.string().min(1),translations:E.record(E.string(),E.string()).default({})}),G=E.object({id:E.string().min(1),type:E.string().min(1),label:E.string().min(1).optional()});var ne="1.0.0",en="company-intelligence-sha256:v1",nn="canonical-json:v1",Ct=h.enum(["truth","policy","proposal","approval","execution","outcome"]),ht=h.enum(["source","source_version","asset","part","fragment","evidence","claim","policy","entity","relation","conflict","gap","graph","edition","query","answer","verification","feedback","experiment","evaluation","promotion","rollback","replay"]),c=h.string().regex(/^sha256:[a-f0-9]{64}$/),tn=h.object({version:h.literal(en),canonicalization:h.literal(nn),value:c}).strict(),te=h.object({from:h.iso.datetime({offset:!0}),to:h.iso.datetime({offset:!0}).optional()}).strict(),an=h.object({reason:h.enum(["source_deleted","acl_revoked","superseded","retention_expired","privacy_request"]),tombstonedAt:h.iso.datetime({offset:!0})}).strict(),T=h.object({page:h.number().int().positive().optional(),section:h.string().min(1).optional(),lineStart:h.number().int().positive().optional(),lineEnd:h.number().int().positive().optional(),cell:h.string().min(1).optional(),messageId:h.string().min(1).optional(),timeStartMs:h.number().int().nonnegative().optional(),timeEndMs:h.number().int().nonnegative().optional()}).strict().refine((e)=>Object.values(e).some((s)=>s!==void 0),{message:"At least one stable evidence locator is required."}),ue=h.array(h.string().min(1)).refine((e)=>new Set(e).size===e.length,{message:"Reference ids must be unique."}),v=h.object({contractVersion:h.literal(ne),id:h.string().min(1),tenantId:h.string().min(1),ownerRef:G.strict(),recordedAt:h.iso.datetime({offset:!0}),validTime:te,recordRefIds:ue.default([]),evidenceRefIds:ue.default([]),supersedesRefId:h.string().min(1).optional(),tombstone:an.optional(),fingerprint:tn}).strict();import{z as y}from"zod";var ie=y.enum(["answered","abstained","refused","conflicted","degraded"]),ae=v.extend({kind:y.literal("query"),authorityClass:y.literal("proposal"),payload:y.object({actorRef:y.string().min(1),questionDigest:y.string().regex(/^sha256:[a-f0-9]{64}$/),authorizationDecisionRef:y.string().min(1),retrievalConfigRef:y.string().min(1),requestedAt:y.iso.datetime({offset:!0}),maxEvidenceRecords:y.number().int().positive(),filters:y.record(y.string(),y.string()).default({})}).strict()}).strict(),re=v.extend({kind:y.literal("answer"),authorityClass:y.literal("truth"),payload:y.object({queryRefId:y.string().min(1),status:ie,text:y.string().min(1).optional(),claimRefIds:y.array(y.string().min(1)).default([]),citationEvidenceRefIds:y.array(y.string().min(1)).default([]),conflictRefIds:y.array(y.string().min(1)).default([]),retrievalRunRef:y.string().min(1),verificationRefId:y.string().min(1).optional(),policyDecisionRef:y.string().min(1).optional(),graphSnapshotRefId:y.string().min(1).optional(),editionRefId:y.string().min(1).optional(),replayRefId:y.string().min(1),reasons:y.array(y.string().min(1)).default([]),usage:y.object({modelRef:y.string().min(1),promptFingerprint:y.string().regex(/^sha256:[a-f0-9]{64}$/),latencyMs:y.number().int().nonnegative(),costMicros:y.number().int().nonnegative()}).strict(),knowledgeAuthorizesAction:y.literal(!1)}).strict()}).strict(),oe=v.extend({kind:y.literal("verification"),authorityClass:y.literal("truth"),payload:y.object({answerRefId:y.string().min(1),verdict:y.enum(["supported","unsupported","blocked"]),claimSupport:y.array(y.object({claimRefId:y.string().min(1),evidenceRefIds:y.array(y.string().min(1)).min(1),verdict:y.enum(["supported","unsupported"]),confidence:y.number().min(0).max(1)}).strict()).default([]),deterministicRefsValidated:y.boolean(),independentVerifierRef:y.string().min(1),verifiedAt:y.iso.datetime({offset:!0})}).strict()}).strict(),Ie=[ae,re,oe];import{z as d}from"zod";var Y=d.enum(["unreviewed","review_required","approved","rejected","superseded"]),rn=v.extend({kind:d.literal("claim"),authorityClass:d.literal("truth"),payload:d.object({claimType:d.enum(["fact","procedure","decision","hypothesis","commitment","objective","risk","skill_candidate"]),statement:d.string().min(1),confidence:d.number().min(0).max(1),reviewState:Y,freshness:d.enum(["fresh","stale","unknown"])}).strict()}).strict(),on=v.extend({kind:d.literal("policy"),authorityClass:d.literal("policy"),payload:d.object({normativeStatement:d.string().min(1),scopeRefIds:d.array(d.string().min(1)).min(1),approvalRequired:d.boolean(),exceptionRefIds:d.array(d.string().min(1)).default([]),reviewState:Y}).strict()}).strict(),sn=v.extend({kind:d.literal("entity"),authorityClass:d.literal("truth"),payload:d.object({entityType:d.string().min(1),label:d.string().min(1),resolutionState:d.enum(["candidate","canonical","rejected","merged"]),stableIdentifierDigests:d.array(c).default([]),confidence:d.number().min(0).max(1),reviewState:Y}).strict()}).strict(),cn=v.extend({kind:d.literal("relation"),authorityClass:d.literal("truth"),payload:d.object({fromEntityRefId:d.string().min(1),toEntityRefId:d.string().min(1),predicate:d.string().min(1),confidence:d.number().min(0).max(1),reviewState:Y}).strict()}).strict(),dn=v.extend({kind:d.literal("conflict"),authorityClass:d.literal("truth"),payload:d.object({subjectRefId:d.string().min(1),competingRecordRefIds:d.array(d.string().min(1)).min(2),status:d.enum(["review_required","resolved","accepted_conflict"]),summary:d.string().min(1)}).strict()}).strict(),ln=v.extend({kind:d.literal("gap"),authorityClass:d.literal("truth"),payload:d.object({question:d.string().min(1),reason:d.enum(["missing_evidence","conflict","stale","ownerless","unauthorized"]),severity:d.enum(["low","medium","high","critical"]),remediationRefId:d.string().min(1).optional(),state:d.enum(["open","in_review","resolved","accepted_unknown"])}).strict()}).strict(),pn=v.extend({kind:d.literal("graph"),authorityClass:d.literal("truth"),payload:d.object({nodeRefIds:d.array(d.string().min(1)).min(1),edgeRefIds:d.array(d.string().min(1)).default([]),conflictRefIds:d.array(d.string().min(1)).default([]),snapshotAt:d.iso.datetime({offset:!0}),bounds:d.object({maxDepth:d.number().int().positive(),maxNodes:d.number().int().positive(),maxEdges:d.number().int().positive(),timeoutMs:d.number().int().positive()}).strict()}).strict()}).strict(),mn=v.extend({kind:d.literal("edition"),authorityClass:d.literal("truth"),payload:d.object({version:d.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/),recordRefIds:d.array(d.string().min(1)).min(1),graphSnapshotRefId:d.string().min(1),reviewDecisionRef:d.string().min(1),parentEditionRefId:d.string().min(1).optional(),schemaFingerprint:c}).strict()}).strict(),se=[rn,on,sn,cn,dn,ln,pn,mn];import{z as i}from"zod";import{z as r}from"zod";import{z as O}from"zod";var gn="company-intelligence-governed-learning:v1",L=Object.freeze({maxTransitions:64,maxMonitoringComparisons:8,maxPacketClosureRecords:128,maxRecordRefs:64,maxEvidenceRefs:64,maxMetrics:16,maxGuardrails:16,maxReasonCodes:16,minSampleObservations:1000,maxSampleObservations:1e4,maxSerializedBytes:65536,defaultDecisionDeadlineMs:1000,maxDecisionDeadlineMs:5000,maxAppendDeadlineMs:5000,maxGateAgeMs:86400000,maxApprovalValidityMs:86400000,maxReviewIntervalMs:2592000000,maxPromotionExpiryMs:7776000000}),yn=O.enum(["signal_captured","consent_redaction_recorded","classified","baseline_objective_recorded","candidate_proposed","risk_policy_decided","offline_evaluated","holdout_evaluated","adversarial_evaluated","shadow_evaluated","approval_recorded","canary_started","comparison_recorded","promotion_decided","rollback_executed","outcome_recorded","review_due","expired","replay_verified"]),Re=O.enum(["signal_pending","feedback_accepted","classified","candidate_pending","evaluating","shadow","awaiting_approval","canary","promoted","rejected","rolled_back","outcome_recorded","review_due","expired","replay_exact","replay_drifted","blocked"]),ce=["G01","G02","G03","G04","G05","G06","G07","G08","G09","G10","G11","G12","G13","G14","G15","G16","G17","G18","G19","G20","G21","G22","G23","G24","G25"],Ce=O.enum(ce),fn=["CI_LEARNING_BASELINE_REQUIRED","CI_LEARNING_BASELINE_NOT_IMMUTABLE","CI_LEARNING_OBJECTIVE_REQUIRED","CI_LEARNING_CANDIDATE_REQUIRED","CI_LEARNING_CANDIDATE_VERSION_REQUIRED","CI_LEARNING_CANDIDATE_FINGERPRINT_MISMATCH","CI_LEARNING_METRICS_REQUIRED","CI_LEARNING_GUARDRAILS_REQUIRED","CI_LEARNING_SAMPLE_NOT_REPRESENTATIVE","CI_LEARNING_TESTS_FAILED","CI_LEARNING_SAFETY_FAILED","CI_LEARNING_PRIVACY_FAILED","CI_LEARNING_COST_FAILED","CI_LEARNING_OFFLINE_REQUIRED","CI_LEARNING_HOLDOUT_REQUIRED","CI_LEARNING_ADVERSARIAL_REQUIRED","CI_LEARNING_EVALUATOR_NOT_INDEPENDENT","CI_LEARNING_POLICY_DENIED","CI_LEARNING_APPROVAL_REQUIRED","CI_LEARNING_APPROVER_NOT_INDEPENDENT","CI_LEARNING_ROLLBACK_PLAN_REQUIRED","CI_LEARNING_KILL_SWITCH_REQUIRED","CI_LEARNING_SHADOW_REQUIRED","CI_LEARNING_CANARY_REQUIRED","CI_LEARNING_COMPARISON_FAILED"],un=[...fn,"CI_LEARNING_SIGNAL_ACCEPTED","CI_LEARNING_FEEDBACK_POISONED","CI_LEARNING_CONSENT_REQUIRED","CI_LEARNING_REDACTION_REQUIRED","CI_LEARNING_AUTHORITY_REQUIRED","CI_LEARNING_CLASSIFICATION_REQUIRED","CI_LEARNING_SIGNAL_DUPLICATE","CI_LEARNING_SIGNAL_ORIGIN_INVALID","CI_LEARNING_SELF_APPLY_FORBIDDEN","CI_LEARNING_RUNTIME_ARTIFACT_NOT_BOUNDED","CI_LEARNING_VENDOR_EXPORT_DENIED","CI_LEARNING_VENDOR_LEARNING_DENIED","CI_LEARNING_EGRESS_EVIDENCE_REQUIRED","CI_LEARNING_CANARY_GATES_INCOMPLETE","CI_LEARNING_CANARY_REGRESSION","CI_LEARNING_ROLLBACK_REPRODUCTION_FAILED","CI_LEARNING_OUTCOME_REQUIRED","CI_LEARNING_REVIEW_DUE","CI_LEARNING_EXPIRED","CI_LEARNING_REPLAY_EXACT","CI_LEARNING_REPLAY_DRIFT"],de=O.enum(un),In=O.array(de).max(L.maxReasonCodes).refine((e)=>e.every((s,t)=>t===0||e[t-1]<s),"Reason codes must be sorted and unique."),j=O.object({version:O.literal(gn),lifecycleId:O.string().min(1),sequence:O.number().int().min(0).max(63),event:yn,stateBefore:Re.nullable(),stateAfter:Re,previousTransitionRecordRefId:O.string().min(1).optional(),previousStateFingerprint:c.optional(),inputFingerprint:c,stateFingerprint:c,reasonCodes:In,occurredAt:O.iso.datetime({offset:!0})}).strict();import{z as x}from"zod";var Q=x.object({receiptRef:x.string().min(1),status:x.literal("allow"),fingerprint:c,decidedAt:x.iso.datetime({offset:!0}),signerRef:x.string().min(1)}),he=x.object({consentReceiptRef:x.string().min(1),redactionReceiptRef:x.string().min(1),authorityReceiptRef:x.string().min(1),originIntegrityReceiptRef:x.string().min(1)}).strict(),ve=x.object({signalFingerprint:c,originRefId:x.string().min(1),consentReceipt:Q.extend({purpose:x.literal("governed_learning"),scopeRefId:x.string().min(1),signalFingerprint:c}).strict(),redactionReceipt:Q.extend({targetRefId:x.string().min(1)}).strict(),authorityReceipt:Q.extend({tenantId:x.string().min(1),objectiveRefId:x.string().min(1),actorRef:x.string().min(1)}).strict(),originIntegrityReceipt:Q.extend({originRefId:x.string().min(1),classification:x.literal("verified_first_party"),signalFingerprint:c}).strict(),duplicate:x.literal(!1)}).strict();var H=r.object({artifactRef:r.string().min(1),semanticVersion:r.string().regex(/^\d+\.\d+\.\d+$/),fingerprint:c}).strict(),_e=r.object({id:r.string().min(1),metric:r.string().min(1),direction:r.enum(["increase","decrease"]),threshold:r.number(),ownerRef:r.string().min(1)}).strict(),B=r.object({receiptRef:r.string().min(1),status:r.enum(["allow","deny","missing","failed","blocked","expired"]),fingerprint:c,decidedAt:r.iso.datetime({offset:!0}),signerRef:r.string().min(1)}).strict(),xe=r.object({suiteVersion:r.string().min(1),status:r.literal("allow"),fingerprint:c,decidedAt:r.iso.datetime({offset:!0}),signerRef:r.string().min(1)}).strict(),Se=r.object({baselineNormalizedCost:r.number().positive(),candidateNormalizedCost:r.number().positive(),ratio:r.number().positive().max(1.2),tenantBudgetAllowed:r.literal(!0),fingerprint:c}).strict().superRefine((e,s)=>{let t=e.candidateNormalizedCost/e.baselineNormalizedCost;if(Math.abs(t-e.ratio)>Number.EPSILON)s.addIssue({code:"custom",path:["ratio"],message:"Cost ratio must match candidate divided by baseline."})}),Ee=r.object({expectedBaselineFingerprint:c,observedRestoredFingerprint:c,status:r.literal("allow"),fingerprint:c}).strict().superRefine((e,s)=>{if(e.expectedBaselineFingerprint!==e.observedRestoredFingerprint)s.addIssue({code:"custom",path:["observedRestoredFingerprint"],message:"Rollback test must reproduce the exact baseline."})}),le=r.object({principalRef:r.string().min(1),implementationFingerprint:c,modelFingerprint:c,signerRef:r.string().min(1)}).strict(),be=r.object({datasetVersion:r.string().min(1),seed:r.number().int(),selectionMethod:r.string().min(1),observationCount:r.number().int().min(1000).max(1e4),strataCounts:r.record(r.string(),r.number().int().nonnegative()),languageCounts:r.record(r.string(),r.number().int().nonnegative()),fingerprint:c}).strict(),pe=r.object({metricRef:r.string().min(1),baseline:r.number(),candidate:r.number(),lowerConfidenceBound:r.number().optional(),passed:r.boolean()}).strict(),me=r.object({guardrailRef:r.string().min(1),observed:r.number(),threshold:r.number(),operator:r.enum(["eq","lte","gte"]),passed:r.boolean(),hard:r.literal(!0)}).strict(),Ae=r.object({headFingerprint:c,gates:r.array(r.object({id:Ce,status:r.enum(["passed","missing","failed","blocked","expired"]),reasonCode:de,receiptFingerprint:c.optional()}).strict()).max(25)}).strict(),Ne=r.discriminatedUnion("type",[r.object({type:r.literal("runtime_artifact"),artifactKind:r.enum(["prompt","provider_route","retrieval_configuration","ranking_rule","extraction_rule","entity_resolution_rule","memory_rule","compiled_skill","runbook_artifact","runtime_policy"]),artifact:H,activation:r.literal("governed_runtime_activation"),selfApply:r.literal(!1)}).strict(),r.object({type:r.literal("repository_work_item"),changeKind:r.enum(["code","public_contract","migration","deployment_configuration"]),workItemRef:r.string().min(1),fingerprint:c,promotable:r.literal(!1),selfApply:r.literal(!1)}).strict()]),Ge=r.object({vendorExportRequested:r.boolean(),vendorLearningRequested:r.boolean(),vendorExportAllowed:r.boolean().default(!1),vendorLearningAllowed:r.boolean().default(!1),receiptFingerprints:r.array(c).max(5),binding:r.object({signalFingerprint:c,sampleFingerprint:c,artifactFingerprint:c}).strict().optional()}).strict().superRefine((e,s)=>{if(!e.vendorExportAllowed&&!e.vendorLearningAllowed)return;if(!e.binding||e.receiptFingerprints.length!==5||new Set(e.receiptFingerprints).size!==5)s.addIssue({code:"custom",message:"Allowed vendor eligibility requires five unique bound receipts."})}),Le=r.object({baselineFingerprint:c,candidateFingerprint:c,sampleFingerprint:c,metrics:r.array(pe).min(1).max(16),guardrails:r.array(me).min(1).max(16),costRatio:r.number().positive(),latencyRatio:r.number().positive(),passed:r.boolean(),fingerprint:c}).strict(),Oe=r.object({expectedBaselineFingerprint:c,observedActiveFingerprint:c,restoredArtifactRef:r.string().min(1),reproductionReceiptFingerprint:c}).strict();var ke=i.enum(["prompt","provider_route","retrieval_configuration","ranking_rule","extraction_rule","entity_resolution_rule","memory_rule","compiled_skill","runbook_artifact","runtime_policy"]),Cn=i.object({answerRefId:i.string().min(1),actorRef:i.string().min(1),feedbackType:i.enum(["correction","outcome","retrieval_failure","drift"]),consentDecisionRef:i.string().min(1),redactionDecisionRef:i.string().min(1),correctionRefId:i.string().min(1).optional(),outcomeRefId:i.string().min(1).optional(),status:i.enum(["accepted","rejected","quarantined"]),governedLearning:j.optional(),dispositionEvidence:ve.optional()}).strict(),hn=i.object({feedbackType:i.literal("signal"),signalRefId:i.string().min(1),originRefId:i.string().min(1),actorRef:i.string().min(1),signalFingerprint:c,objectiveRefId:i.string().min(1),consentScopeRefId:i.string().min(1),originClassification:i.literal("verified_first_party"),dispositionRefs:he,status:i.enum(["quarantined","rejected"]),governedLearning:j}).strict(),vn=v.extend({kind:i.literal("feedback"),authorityClass:i.literal("outcome"),payload:i.union([Cn,hn])}).strict(),_n=v.extend({kind:i.literal("experiment"),authorityClass:i.literal("proposal"),payload:i.object({baselineRefId:i.string().min(1),candidateArtifactRef:i.string().min(1),candidateKind:ke,objective:i.string().min(1),policyDecisionRef:i.string().min(1),metricRefIds:i.array(i.string().min(1)).min(1),guardrailRefIds:i.array(i.string().min(1)).min(1),holdoutDatasetRef:i.string().min(1),adversarialDatasetRef:i.string().min(1),governedLearning:j.optional(),baseline:H.optional(),candidate:Ne.optional(),objectiveDefinition:_e.optional(),riskDecision:B.optional(),egressDecision:Ge.optional(),reviewDueAt:i.iso.datetime({offset:!0}).optional(),expiresAt:i.iso.datetime({offset:!0}).optional(),state:i.enum(["proposed","offline_evaluation","shadow","canary","completed","rejected"])}).strict()}).strict(),xn=v.extend({kind:i.literal("evaluation"),authorityClass:i.literal("truth"),payload:i.object({experimentRefId:i.string().min(1),candidateArtifactRef:i.string().min(1),evaluatorRef:i.string().min(1),independent:i.literal(!0),datasetRef:i.string().min(1),metricResults:i.record(i.string(),i.number()),safetyPassed:i.boolean(),privacyPassed:i.boolean(),costPassed:i.boolean(),verdict:i.enum(["pass","fail","blocked"]),evaluatedAt:i.iso.datetime({offset:!0}),governedLearning:j.optional(),phase:i.enum(["offline","holdout","adversarial","shadow","canary_compare","post_promotion"]).optional(),sampleReceipt:be.optional(),typedMetrics:i.array(pe).max(16).optional(),typedGuardrails:i.array(me).max(16).optional(),generatorIdentity:le.optional(),evaluatorIdentity:le.optional(),independenceReceipt:B.optional(),testsReceipt:xe.optional(),costEvidence:Se.optional()}).strict()}).strict(),Sn=v.extend({kind:i.literal("promotion"),authorityClass:i.literal("approval"),payload:i.object({experimentRefId:i.string().min(1),evaluationRefId:i.string().min(1),candidateArtifactRef:i.string().min(1),candidateKind:ke,approvalDecisionRef:i.string().min(1),policyDecisionRef:i.string().min(1),rollbackRefId:i.string().min(1),killSwitchRef:i.string().min(1),stage:i.enum(["shadow","canary","promoted","rejected"]),approvedAt:i.iso.datetime({offset:!0}).optional(),governedLearning:j.optional(),gateBundle:Ae.optional(),approvalReceipt:B.optional(),rollbackTestReceipt:Ee.optional(),killSwitchReceipt:B.optional(),comparisonReceipt:Le.optional(),effectiveArtifact:H.optional()}).strict().superRefine((e,s)=>{if(e.governedLearning&&(e.stage==="canary"||e.stage==="promoted")&&!e.gateBundle)s.addIssue({code:"custom",path:["gateBundle"],message:"Governed canary and promotion require a gate bundle."})})}).strict(),En=v.extend({kind:i.literal("rollback"),authorityClass:i.literal("execution"),payload:i.object({promotionRefId:i.string().min(1),baselineRefId:i.string().min(1),triggerRef:i.string().min(1),status:i.enum(["ready","executed","failed"]),executedAt:i.iso.datetime({offset:!0}).optional(),outcomeRefId:i.string().min(1).optional(),replayRefId:i.string().min(1),governedLearning:j.optional(),reproduction:Oe.optional()}).strict()}).strict(),bn=v.extend({kind:i.literal("replay"),authorityClass:i.literal("truth"),payload:i.object({inputFingerprint:c,configurationRefIds:i.array(i.string().min(1)).min(1),codeVersionRef:i.string().min(1),providerFixtureRef:i.string().min(1),orderedEventRefIds:i.array(i.string().min(1)),outputFingerprint:c,status:i.enum(["exact","drifted","blocked"]),replayedAt:i.iso.datetime({offset:!0}),governedLearning:j.optional(),lifecycleHeadFingerprint:c.optional(),baselineFingerprint:c.optional(),effectiveArtifactFingerprint:c.optional(),orderedTransitionFingerprints:i.array(c).optional()}).strict()}).strict(),ge=[vn,_n,xn,Sn,En,bn];import{z as m}from"zod";var An=v.extend({kind:m.literal("source"),authorityClass:m.literal("truth"),payload:m.object({connectionRef:m.string().min(1),authorizationRef:m.string().min(1),externalId:m.string().min(1),sourceType:m.string().min(1),aclRefIds:m.array(m.string().min(1)).min(1),state:m.enum(["registered","ready","degraded","revoked","deleted"])}).strict()}).strict(),Nn=v.extend({kind:m.literal("source_version"),authorityClass:m.literal("truth"),payload:m.object({sourceRecordRefId:m.string().min(1),version:m.number().int().positive(),observedAt:m.iso.datetime({offset:!0}),sourceFingerprint:c,assetRefIds:m.array(m.string().min(1)).default([])}).strict()}).strict(),Gn=v.extend({kind:m.literal("asset"),authorityClass:m.literal("truth"),payload:m.object({sourceVersionRefId:m.string().min(1),mediaType:m.string().min(1),byteLength:m.number().int().nonnegative(),storageRef:m.string().min(1),contentFingerprint:c,classification:m.enum(["public","internal","confidential","restricted"]),aclRefIds:m.array(m.string().min(1)).min(1)}).strict()}).strict(),Ln=v.extend({kind:m.literal("part"),authorityClass:m.literal("truth"),payload:m.object({assetRefId:m.string().min(1),partKind:m.enum(["page","section","table","line","cell","message","time_range"]),ordinal:m.number().int().nonnegative(),locator:T,contentFingerprint:c,language:m.string().min(2).optional(),parentPartRefId:m.string().min(1).optional()}).strict()}).strict(),On=v.extend({kind:m.literal("fragment"),authorityClass:m.literal("truth"),payload:m.object({partRefId:m.string().min(1),stableFragmentId:m.string().min(1),ordinal:m.number().int().nonnegative(),locator:T,contentFingerprint:c,tokenCount:m.number().int().nonnegative(),previousFragmentRefId:m.string().min(1).optional(),nextFragmentRefId:m.string().min(1).optional(),aclRefIds:m.array(m.string().min(1)).min(1)}).strict()}).strict(),kn=v.extend({kind:m.literal("evidence"),authorityClass:m.literal("truth"),payload:m.object({sourceVersionRefId:m.string().min(1),assetRefId:m.string().min(1).optional(),partRefId:m.string().min(1),fragmentRefId:m.string().min(1),locator:T,authorizationDecisionRef:m.string().min(1),redactionDecisionRef:m.string().min(1),contentFingerprint:c}).strict()}).strict(),ye=[An,Nn,Gn,Ln,On,kn];import{z as a}from"zod";import{z as l}from"zod";import{z as o}from"zod";import{z as R}from"zod";var Z=R.object({id:R.string().min(1),substrate:R.enum(["knowledge","data_transmission","authos","rbac"]),ref:R.string().min(1),evidenceRefIds:R.array(R.string().min(1)).default([]),metadata:A.default({})}),Dn=Z.extend({substrate:R.literal("knowledge"),spaceKey:R.string().min(1).optional(),fragmentId:R.string().min(1),sourceRef:w.optional(),queryEvidenceRef:R.string().min(1).optional()}),De=Z.extend({substrate:R.literal("data_transmission"),protocolVersion:R.literal("data-transmission.v0"),roomId:R.string().min(1),cursor:R.string().min(1).optional(),idempotencyKey:R.string().min(1).optional()}),we=Z.extend({substrate:R.literal("authos"),actorId:R.string().min(1),sessionRef:R.string().min(1).optional(),tenantId:R.string().min(1).optional()}),Te=Z.extend({substrate:R.literal("rbac"),decisionId:R.string().min(1),verdict:R.enum(["allow","deny","redacted","redact","requires_review"]),permissionIds:R.array(R.string().min(1)).default([]),redactedFieldRefs:R.array(R.string().min(1)).default([])}),je=R.discriminatedUnion("substrate",[Dn,De,we,Te]),Qt=R.object({actorRef:we,rbacDecisionRef:Te,resourceRef:R.string().min(1),sourceAclRefIds:R.array(R.string().min(1)).default([]),policyRefIds:R.array(R.string().min(1)).default([]),evidenceRefIds:R.array(R.string().min(1)).default([])}),Ht=R.object({roomRef:De,changeRef:R.string().min(1),sequence:R.number().int().nonnegative(),idempotencyKey:R.string().min(1),replayRef:R.string().min(1)});var wn=o.object({id:o.string().min(1),kind:o.enum(["knowledge","communication","issue_tracker","code_host","documentation","customer_system","incident_system","manual_record"]),label:o.string().min(1),connectorCapability:o.string().min(1),freshnessSla:o.enum(["manual","hourly","daily","near_realtime"]),metadata:A.default({})}),Tn=o.object({id:o.string().min(1),sourceSystemId:o.string().min(1),externalId:o.string().min(1),recordType:o.string().min(1),sourceHash:o.string().min(1),observedAt:o.string().min(1),provenance:o.array(w).min(1),substrateRefs:o.array(je).default([]),evidenceRefIds:o.array(o.string().min(1)).min(1),metadata:A.default({})}),jn=o.enum(["person","team","customer","project","repository","ticket","meeting","document","incident","decision","commitment","procedure","runbook","objective","work_item","knowledge_fragment"]),fe=o.object({status:o.enum(["fresh","stale","unknown"]),observedAt:o.string().min(1),expiresAt:o.string().min(1).optional(),evidenceRefIds:o.array(o.string().min(1)).min(1)}),Fn=o.object({reason:o.enum(["deleted_source","superseded","privacy_request","merged"]),tombstonedAt:o.string().min(1),supersededByNodeId:o.string().min(1).optional(),evidenceRefIds:o.array(o.string().min(1)).min(1)}),zn=o.object({id:o.string().min(1),kind:jn,label:o.string().min(1),sourceRecordRefIds:o.array(o.string().min(1)).min(1),evidenceRefIds:o.array(o.string().min(1)).min(1),sourceAclRefIds:o.array(o.string().min(1)).default([]),policyRefIds:o.array(o.string().min(1)).default([]),confidence:o.number().min(0).max(1),reviewState:o.enum(["unreviewed","review_required","reviewed","rejected"]),freshness:fe,tombstone:Fn.optional(),conflictRefIds:o.array(o.string().min(1)).default([]),metadata:A.default({})}),Pn=o.object({id:o.string().min(1),kind:o.enum(["owns","member_of","relates_to","blocks","depends_on","documents","decides","commits_to","implements","escalates_to","runbook_for","evidence_for"]),fromNodeId:o.string().min(1),toNodeId:o.string().min(1),sourceRecordRefIds:o.array(o.string().min(1)).min(1),evidenceRefIds:o.array(o.string().min(1)).min(1),confidence:o.number().min(0).max(1),reviewState:o.enum(["unreviewed","review_required","reviewed","rejected"]),metadata:A.default({})}),Bn=o.object({id:o.string().min(1),subjectNodeId:o.string().min(1),conflictingNodeIds:o.array(o.string().min(1)).default([]),conflictingRecordRefIds:o.array(o.string().min(1)).min(1),status:o.enum(["review_required","resolved","accepted_conflict"]),summary:o.string().min(1),evidenceRefIds:o.array(o.string().min(1)).min(1)}),ei=o.object({id:o.string().min(1),generatedAt:o.string().min(1),snapshotHash:o.string().min(1),sourceSystems:o.array(wn).min(1),sourceRecords:o.array(Tn).min(1),nodes:o.array(zn).min(1),edges:o.array(Pn).default([]),conflicts:o.array(Bn).default([]),replayCursorRef:o.string().min(1).optional(),evidenceRefIds:o.array(o.string().min(1)).min(1),metadata:A.default({})});var Vn=l.enum(["skill_file","runbook_pack","agent_prompt","conformance_pack"]),Mn=l.enum(["ready","blocked","review_required","stale","unauthorized","identity_unresolved","acl_redacted","conflicted"]),qn=l.enum(["pass","fail","not_run","blocked"]),Un=l.enum(["proposed","accepted","rejected","superseded","applied_to_contract"]),Fe=l.object({id:l.string().min(1),artifactKind:Vn,version:l.string().min(1),artifactRef:G,runbookProcedureId:l.string().min(1),sourceRecordRefIds:l.array(l.string().min(1)).min(1),identityDecisionIds:l.array(l.string().min(1)).default([]),accessDecisionIds:l.array(l.string().min(1)).min(1),compiledFromBrainEntryIds:l.array(l.string().min(1)).default([]),compilerPrincipalId:l.string().min(1),compiledAt:l.string().min(1),freshness:fe,evidenceRefIds:l.array(l.string().min(1)).min(1),sourceRefs:l.array(w).default([]),noProviderBinding:l.literal(!0).default(!0),metadata:A.default({})}).strict(),ri=l.object({id:l.string().min(1),compiledArtifactId:l.string().min(1),runbookReadinessId:l.string().min(1),status:Mn,evaluatedAt:l.string().min(1),sourceRecordRefIds:l.array(l.string().min(1)).min(1),identityDecisionIds:l.array(l.string().min(1)).default([]),accessDecisionIds:l.array(l.string().min(1)).min(1),blockedReasons:l.array(l.string().min(1)).default([]),evidenceRefIds:l.array(l.string().min(1)).min(1),metadata:A.default({})}).superRefine((e,s)=>{if(e.status!=="ready"&&e.blockedReasons.length===0)s.addIssue({code:l.ZodIssueCode.custom,message:"Non-ready agentic readiness checks require blocked reasons.",path:["blockedReasons"]});if(e.status==="ready"&&e.blockedReasons.length>0)s.addIssue({code:l.ZodIssueCode.custom,message:"Ready agentic readiness checks must not carry blocked reasons.",path:["blockedReasons"]})}),oi=l.object({id:l.string().min(1),compiledArtifactId:l.string().min(1),readinessCheckId:l.string().min(1),runbookConformanceCaseId:l.string().min(1),status:qn,assertion:l.string().min(1),checkedAt:l.string().min(1),failureReason:l.string().min(1).optional(),replayRefIds:l.array(l.string().min(1)).default([]),executionReceiptIds:l.array(l.string().min(1)).default([]),evidenceRefIds:l.array(l.string().min(1)).min(1),noRuntimeExecution:l.literal(!0).default(!0),metadata:A.default({})}).superRefine((e,s)=>{if(["fail","blocked"].includes(e.status)&&!e.failureReason)s.addIssue({code:l.ZodIssueCode.custom,message:"Failing or blocked agentic conformance evidence requires a failure reason.",path:["failureReason"]})}),si=l.object({id:l.string().min(1),compiledArtifactId:l.string().min(1),conformanceEvidenceId:l.string().min(1),correctionKind:l.enum(["source_correction","identity_correction","acl_correction","runbook_correction","outcome_correction"]),status:Un,summary:l.string().min(1),outcomeReceiptId:l.string().min(1),observedAt:l.string().min(1),sourceEvidenceRefIds:l.array(l.string().min(1)).min(1),evidenceRefIds:l.array(l.string().min(1)).min(1),noProviderMutation:l.literal(!0).default(!0),metadata:A.default({})}).strict();import{z as p}from"zod";var X=p.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/),F=p.string().regex(/^sha256:[a-f0-9]{64}$/),k=p.object({recordRef:p.string().min(1),version:X,schemaRef:p.string().min(1),contentFingerprint:F}).strict().readonly(),ze=p.object({id:p.string().min(1),version:X,contentFingerprint:F,schemaFingerprint:F}).strict().readonly(),Pe=p.object({namespace:p.string().regex(/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/),schemaRef:p.string().min(1),recordRef:p.string().min(1),version:X,contentFingerprint:F}).strict().readonly(),Kn=p.object({targetSchemaRef:p.string().min(1),independentConsumerRefs:p.array(G.strict()).min(2).refine((e)=>new Set(e.map((s)=>`${s.type}:${s.id}`)).size>=2,"two distinct vertical consumers are required"),migrationDecisionRef:G.strict()}).strict().readonly(),Yn=p.object({extensionRef:Pe,namespaceOwnerRef:G.strict(),schemaFingerprint:F,compatibilityIntent:p.enum(["additive","backward_compatible","breaking"]),evidenceRequirementRefs:p.array(G.strict()).min(1).readonly(),allowedRefTypes:p.array(p.string().min(1)).min(1).readonly(),sourcePolicyRef:G.strict(),legalReviewRef:G.strict(),lifecycleStatus:p.enum(["active","deprecated","promoted"]),deprecationDecisionRef:G.strict().optional(),replacementNamespace:p.string().min(1).optional(),promotion:Kn.optional(),collisionPolicy:p.literal("reject_incompatible_namespace_or_schema_reuse")}).strict().superRefine((e,s)=>{if(e.lifecycleStatus==="deprecated"&&!e.deprecationDecisionRef)s.addIssue({code:"custom",path:["deprecationDecisionRef"],message:"deprecated extensions require a decision ref"});if(e.lifecycleStatus==="promoted"&&!e.promotion)s.addIssue({code:"custom",path:["promotion"],message:"promoted extensions require approved migration evidence"})}),pi=p.array(Yn).readonly().superRefine((e,s)=>{let t=new Set,C=new Map;for(let[f,I]of e.entries()){let{namespace:u,schemaRef:_}=I.extensionRef;if(t.has(u))s.addIssue({code:"custom",path:[f,"extensionRef","namespace"],message:`namespace collision: ${u}`});t.add(u);let b=C.get(_);if(b&&b!==I.schemaFingerprint)s.addIssue({code:"custom",path:[f,"schemaFingerprint"],message:`incompatible schema reuse: ${_}`});C.set(_,I.schemaFingerprint)}}),$n=p.object({identityContextRefs:p.array(k).readonly().default([]),knowledgeAssertionRefs:p.array(k).readonly().default([]),procedureRefs:p.array(k).readonly().default([]),policyRefs:p.array(k).readonly().default([]),hypothesisRefs:p.array(k).readonly().default([]),decisionRefs:p.array(k).readonly().default([]),evidenceRefs:p.array(k).readonly().default([])}).strict().readonly(),mi=p.object({id:p.string().min(1),version:X,recordedAt:p.iso.datetime({offset:!0}),effectiveFrom:p.iso.datetime({offset:!0}).optional(),parentEditionRef:ze.optional(),baseEditionRef:ze.optional(),contentFingerprint:F,schemaFingerprint:F,sections:$n,graphSnapshotRef:k.optional(),evidenceReceiptRefs:p.array(p.string().min(1)).readonly().default([]),replayRef:p.string().min(1).optional(),reviewDecisionRef:p.string().min(1).optional(),extensionRefs:p.array(Pe).readonly().default([])}).strict().readonly(),Qn=p.object({id:p.string().min(1),title:p.string().min(1),kind:p.enum(["knowledge","procedure","policy","skill_candidate"]),summary:p.string().min(1),ownerPrincipalId:p.string().min(1),trustLevel:p.enum(["low","medium","high"]),freshness:p.enum(["fresh","stale","unknown"]),sourceRefs:p.array(w).min(1)}),Hn=p.object({id:p.string().min(1),summary:p.string().min(1),severity:p.enum(["low","medium","high"]),relatedSourceRefs:p.array(w).default([]),ownerPrincipalId:p.string().min(1)}),gi=p.object({id:p.string().min(1),entries:p.array(Qn).default([]),gaps:p.array(Hn).default([])});var Zn=a.enum(["fact","hypothesis","policy","procedure","decision","skill_candidate"]),Xn=a.enum(["unreviewed","review_required","approved","rejected","superseded"]),Be=a.object({statement:a.string().min(1),normativeLanguage:a.array(a.string().min(1)).default([]),scope:a.array(a.string().min(1)).default([]),prerequisites:a.array(a.string().min(1)).default([]),orderedSteps:a.array(a.string().min(1)).default([]),expectedOutputs:a.array(a.string().min(1)).default([]),failureBranches:a.array(a.string().min(1)).default([]),exceptions:a.array(a.string().min(1)).default([]),approvalBoundaries:a.array(a.string().min(1)).default([])}).strict(),Ci=a.object({tenantId:a.string().min(1),workspaceId:a.string().min(1),entryId:a.string().min(1),version:a.number().int().positive(),kind:Zn,title:a.string().min(1),content:Be,ownerRef:a.string().min(1).optional(),sourceRecordRefs:a.array(k).default([]),evidenceRefIds:a.array(a.string().min(1)).default([]),policyRefIds:a.array(a.string().min(1)).default([]),domain:a.string().min(1),trustLevel:a.enum(["low","medium","high"]),confidence:a.number().min(0).max(1),freshness:a.enum(["fresh","stale","unknown"]),reviewState:Xn,conflictState:a.enum(["clear","contradictory","resolved"]),risk:a.enum(["low","medium","high","critical"]),recordedAt:a.iso.datetime({offset:!0}),validTime:te,requiredCapabilities:a.array(a.string().min(1)).default([]),sensitiveFields:a.array(a.string().min(1)).default([]),tombstoneReason:a.enum(["source_deleted","acl_revoked","superseded","privacy_request"]).optional(),fingerprint:c}).strict(),hi=a.object({tenantId:a.string().min(1),workspaceId:a.string().min(1),decisionId:a.string().min(1),entryId:a.string().min(1),entryVersion:a.number().int().positive(),verdict:a.enum(["approved","rejected"]),reviewerRef:a.string().min(1),decidedAt:a.iso.datetime({offset:!0}),evidenceRefIds:a.array(a.string().min(1)).min(1),reason:a.string().min(1),fingerprint:c}).strict(),vi=a.object({tenantId:a.string().min(1),workspaceId:a.string().min(1),gapId:a.string().min(1),entryRef:a.string().min(1),reason:a.enum(["ownerless","stale","unsupported","low_confidence","contradictory"]),status:a.enum(["open","in_progress","resolved","accepted_unknown"]),ownerRef:a.string().min(1).optional(),evidenceRefIds:a.array(a.string().min(1)).min(1),recordedAt:a.iso.datetime({offset:!0}),fingerprint:c}).strict(),_i=a.object({tenantId:a.string().min(1),workspaceId:a.string().min(1),remediationId:a.string().min(1),gapId:a.string().min(1),status:a.enum(["proposed","accepted","in_progress","completed","cancelled"]),ownerRef:a.string().min(1),workRef:a.string().min(1),evidenceRefIds:a.array(a.string().min(1)).min(1),recordedAt:a.iso.datetime({offset:!0}),fingerprint:c}).strict(),xi=a.object({artifact:Fe,sourceEntryRef:a.string().min(1),accountableOwnerRef:a.string().min(1),policyRefIds:a.array(a.string().min(1)).default([]),content:Be,conformanceEvidenceRefIds:a.array(a.string().min(1)).min(1),contentFingerprint:c,noActionAuthorization:a.literal(!0),noActionExecution:a.literal(!0)}).strict();var Ei=[{surface:"@lssm/lib.companyos-spec/types/company-intelligence",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/validation/company-intelligence",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/fixtures/company-intelligence",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/docs/company-intelligence.docblock",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/types/company-intelligence/grounding-result",kind:"schema",intent:"additive"},{surface:"@lssm/lib.companyos-spec/validation/company-intelligence-grounding",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/fixtures/company-intelligence/grounding-result",kind:"export",intent:"additive"},{surface:"companyIntelligence.feedback.signal@1.0.0",kind:"schema",intent:"additive"},{surface:"companyIntelligence.governedLearning.transition@1.0.0",kind:"schema",intent:"additive"},{surface:"@lssm/lib.companyos-spec/validation/company-intelligence#validateCompanyIntelligenceGovernedLearningHistory",kind:"export",intent:"additive"},{surface:"companyIntelligence.extraction.candidate@1.0.0",kind:"schema",intent:"additive"},{surface:"@lssm/lib.contracts-spec/companyos/company-intelligence",kind:"export",intent:"additive"},...["companyIntelligence.brain.entry.create","companyIntelligence.brain.entry.version.append","companyIntelligence.brain.entry.review","companyIntelligence.brain.edition.create","companyIntelligence.brain.edition.compare","companyIntelligence.brain.gap.remediate","companyIntelligence.brain.artifact.compile","companyIntelligence.record.validate","companyIntelligence.graph.query","companyIntelligence.answer.query","companyIntelligence.feedback.record","companyIntelligence.experiment.evaluate","companyIntelligence.promotion.decide","companyIntelligence.rollback.execute","companyIntelligence.replay.get"].map((e)=>({surface:e,kind:"operation",intent:"additive"})),...["companyIntelligence.brain.entry.versioned","companyIntelligence.brain.entry.reviewed","companyIntelligence.brain.edition.created","companyIntelligence.brain.gap.recorded","companyIntelligence.brain.remediation.recorded","companyIntelligence.brain.artifact.compiled","companyIntelligence.record.committed","companyIntelligence.answer.verified","companyIntelligence.feedback.recorded","companyIntelligence.promotion.decided","companyIntelligence.rollback.completed"].map((e)=>({surface:e,kind:"event",intent:"additive"}))];import{z as g}from"zod";var Ve="companyos.company-intelligence-extraction-candidate",Me="1.0.0",Gi=g.enum(["fact","entity","relation","policy","procedure"]),Wn=g.object({evidenceRecordId:g.string().min(1),locator:T}).strict(),V=g.object({candidateKey:g.string().min(1),evidenceRefs:g.array(Wn).min(1),confidence:g.number().min(0).max(1),risk:g.enum(["low","medium","high","critical"])}),Jn=g.discriminatedUnion("kind",[V.extend({kind:g.literal("fact"),statement:g.string().min(1)}).strict(),V.extend({kind:g.literal("entity"),entityType:g.string().min(1),label:g.string().min(1)}).strict(),V.extend({kind:g.literal("relation"),fromCandidateKey:g.string().min(1),toCandidateKey:g.string().min(1),predicate:g.string().min(1)}).strict(),V.extend({kind:g.literal("policy"),normativeStatement:g.string().min(1),scopeRefIds:g.array(g.string().min(1)).min(1)}).strict(),V.extend({kind:g.literal("procedure"),statement:g.string().min(1)}).strict()]),Li=g.object({schemaId:g.literal(Ve),schemaVersion:g.literal(Me),candidates:g.array(Jn).min(1)}).strict().refine(({candidates:e})=>new Set(e.map(({candidateKey:s})=>s)).size===e.length,{message:"Candidate keys must be unique.",path:["candidates"]}),Oi=g.object({decisionRef:g.string().min(1),reviewerRef:g.string().min(1),candidateKeys:g.array(g.string().min(1)).min(1),verdict:g.enum(["approved","rejected"]),decidedAt:g.iso.datetime({offset:!0})}).strict(),ki=g.object({receiptId:g.string().min(1),tenantId:g.string().min(1),attemptId:g.string().min(1),modelRef:g.string().min(1),promptFingerprint:c,candidateSchema:g.object({id:g.literal(Ve),version:g.literal(Me),fingerprint:c}).strict(),runtimeVersion:g.string().min(1),costMicros:g.number().int().nonnegative(),redactionDecisionRef:g.string().min(1),evidenceRefIds:g.array(g.string().min(1)),dispositions:g.array(g.object({candidateKey:g.string().min(1),status:g.enum(["accepted","rejected","review_required"]),reason:g.string().min(1),recordId:g.string().min(1).optional()}).strict()),version:g.number().int().positive(),supersedesReceiptId:g.string().min(1).optional(),fingerprint:c}).strict();import{z as n}from"zod";var et=n.enum(["authorization_denied","scope_mismatch","policy_refused","no_authorized_evidence","retrieval_degraded","conflicting_authorized_evidence","stale_authorized_evidence","verifier_not_independent","drafting_degraded","draft_schema_invalid","verification_degraded","insufficient_claim_support","deadline_exceeded","budget_exceeded","fixture_adapter_forbidden","supported"]),q=n.array(n.string().min(1)).refine((e)=>new Set(e).size===e.length,{message:"Values must be unique."}),nt=n.object({tenantId:n.string().min(1),workspaceId:n.string().min(1),actorRef:n.string().min(1),viewerRef:n.string().min(1),capabilityRefs:q,authorizationDecisionRef:n.string().min(1),policyDecisionRef:n.string().min(1).optional()}).strict(),tt=n.object({questionBytes:n.number().int().positive().max(4096),filterEntries:n.number().int().nonnegative().max(20),channelCount:n.number().int().positive().max(3),perChannelTopK:n.number().int().positive().max(32),mergedEvidenceRecords:n.number().int().positive().max(16),excerptBytesPerEvidence:n.number().int().positive().max(2048),totalModelEvidenceBytes:n.number().int().positive().max(16384),maxClaims:n.number().int().positive().max(8),maxClaimStatementBytes:n.number().int().positive().max(512),maxCitationsPerClaim:n.number().int().positive().max(4),maxDraftAttempts:n.literal(2),maxVerificationAttempts:n.literal(2),maxRetrievalCalls:n.literal(3),runDeadlineMs:n.number().int().positive().max(12000)}).strict(),Ue=n.object({claimId:n.string().regex(/^clm_sha256:[a-f0-9]{64}$/),statement:n.string().min(1)}).strict(),Ke=n.object({citationId:n.string().regex(/^cit_sha256:[a-f0-9]{64}$/),evidenceRefId:n.string().min(1),tenantId:n.string().min(1),workspaceId:n.string().min(1),viewerRef:n.string().min(1),locator:T,excerpt:n.string().min(1),sourceContentFingerprint:c,viewerProjectionFingerprint:c,redactionDecisionRef:n.string().min(1),fusedScoreMicros:n.number().int().nonnegative()}).strict(),Ye=n.object({claimId:n.string().regex(/^clm_sha256:[a-f0-9]{64}$/),citationIds:n.array(n.string().regex(/^cit_sha256:[a-f0-9]{64}$/)).min(1).max(4),verdict:n.literal("supported"),confidence:n.number().min(0).max(1)}).strict(),qe=n.object({providerRef:n.string().min(1),modelRef:n.string().min(1),promptOrRuleVersion:n.string().min(1),independenceDomain:n.string().min(1),provenance:n.enum(["runtime","fixture"])}).strict(),it=n.object({request:c,retrieval:c.optional(),draft:c.optional(),validation:c.optional(),verification:c.optional(),output:c,replay:c}).strict(),at=n.object({drafterIdentity:qe.optional(),verifierIdentity:qe.optional(),retrievedCitationLedger:q,callCounts:n.object({retrieval:n.number().int().nonnegative().max(3),draft:n.number().int().nonnegative().max(2),verify:n.number().int().nonnegative().max(2)}).strict(),repairCount:n.number().int().nonnegative().max(1),warnings:q,fingerprints:it}).strict(),rt=n.object({schemaVersion:n.literal("company-intelligence-grounded-answer:v1"),codeVersionRef:n.string().min(1),retrievalConfigRef:n.string().min(1),recordedAt:n.iso.datetime({offset:!0}),modelVisibleEvidenceBytes:n.number().int().nonnegative().max(16384),supportThreshold:n.number().min(0).max(1)}).strict(),M=n.object({schemaVersion:n.literal("company-intelligence-grounded-answer:v1"),scope:nt,status:ie,reasonCodes:n.array(et).min(1),text:n.string().min(1).optional(),claims:n.array(Ue),citations:n.array(Ke),claimSupport:n.array(Ye),conflictRefIds:q,receipt:at,metadata:rt,bounds:tt,knowledgeAuthorizesAction:n.literal(!1)}).strict(),W={text:n.undefined().optional(),claims:n.array(n.never()).max(0),citations:n.array(n.never()).max(0),claimSupport:n.array(n.never()).max(0)},Fi=n.discriminatedUnion("status",[M.extend({status:n.literal("answered"),text:n.string().min(1),claims:n.array(Ue).min(1).max(8),citations:n.array(Ke).min(1),claimSupport:n.array(Ye).min(1),conflictRefIds:n.array(n.never()).max(0)}),M.extend({status:n.literal("abstained"),...W}),M.extend({status:n.literal("refused"),...W}),M.extend({status:n.literal("conflicted"),...W,conflictRefIds:q.pipe(n.array(n.string()).min(1))}),M.extend({status:n.literal("degraded"),...W})]);var ot=P.discriminatedUnion("kind",[...ye,...se,...Ie,...ge]),st=[...ye,...se,ae,re,oe,...ge].map((e)=>e.omit({fingerprint:!0})),Ki=P.union(st),Yi=P.object({contractVersion:P.literal(ne),tenantId:P.string().min(1),records:P.array(ot).min(1)}).strict();function S(e,s,t,C){e.push({code:s,path:t,message:C})}function $e(e,s,t,C,f){if(t.kind!=="experiment"||!t.payload.egressDecision)return;let I=t.payload.egressDecision;if(!(I.vendorExportAllowed||I.vendorLearningAllowed))return;let _=e.find((N)=>N.kind==="feedback"&&N.payload.feedbackType==="signal"),b=e.find((N)=>N.kind==="evaluation"&&N.payload.sampleReceipt),D=t.payload.candidate,K=D?.type==="runtime_artifact"?D.artifact.fingerprint:D?.fingerprint,z=new Set(e.slice(0,s).map(({fingerprint:N})=>N.value));if(I.vendorExportAllowed&&!I.vendorExportRequested||I.vendorLearningAllowed&&!I.vendorLearningRequested||!I.binding||I.binding.signalFingerprint!==(_?.kind==="feedback"&&_.payload.feedbackType==="signal"?_.payload.signalFingerprint:void 0)||I.binding.sampleFingerprint!==(b?.kind==="evaluation"?b.payload.sampleReceipt?.fingerprint:void 0)||I.binding.artifactFingerprint!==K||I.receiptFingerprints.some((N)=>!z.has(N)))S(f,"CI_LEARNING_TRANSITION_INVALID",`${C}.payload.egressDecision`,"Vendor eligibility requires five prior receipts bound to one signal, sample, and artifact.")}var ct={G01:"candidate_proposed",G02:"candidate_proposed",G03:"candidate_proposed",G04:"candidate_proposed",G05:"candidate_proposed",G06:"candidate_proposed",G07:"offline_evaluated",G08:"offline_evaluated",G09:"offline_evaluated",G10:"offline_evaluated",G11:"offline_evaluated",G12:"offline_evaluated",G13:"offline_evaluated",G14:"offline_evaluated",G15:"holdout_evaluated",G16:"adversarial_evaluated",G17:"adversarial_evaluated",G18:"risk_policy_decided",G19:"approval_recorded",G20:"approval_recorded",G21:"approval_recorded",G22:"approval_recorded",G23:"shadow_evaluated",G24:"canary_started",G25:"comparison_recorded"};function He(e,s,t){let C=ct[s];return e.findLast((f)=>("governedLearning"in f.payload)&&f.payload.governedLearning?.lifecycleId===t&&f.payload.governedLearning.event===C)}function Ze(e,s){let t=Date.parse(s)-Date.parse(e.recordedAt);return Number.isFinite(t)&&t>=0&&t<=L.maxGateAgeMs}function Xe(e,s,t){let C="governedLearning"in t.payload?t.payload.governedLearning:void 0;if(C?.event!=="review_due"&&C?.event!=="expired")return!0;let f=e.slice(0,s).findLast((u)=>u.kind==="promotion"&&u.payload.stage==="promoted"&&u.payload.governedLearning?.lifecycleId===C.lifecycleId);if(!f)return!1;let I=C.event==="review_due"?L.maxReviewIntervalMs:L.maxPromotionExpiryMs;return Date.parse(t.recordedAt)===Date.parse(f.recordedAt)+I}function We(e,s){let t=J(s,"candidate_proposed","experiment"),C=J(s,"risk_policy_decided","experiment"),f=U(s,"offline"),I=U(s,"holdout"),u=U(s,"adversarial"),_=U(s,"shadow"),b=J(s,"approval_recorded","promotion"),D=J(s,"canary_started","promotion"),K=U(s,"canary_compare"),z=t?.payload.candidate,N=z?.type==="runtime_artifact";return{G01:!!t?.payload.baseline,G02:!!t?.payload.baseline?.semanticVersion,G03:!!t?.payload.objectiveDefinition,G04:!!z,G05:N&&!!z.artifact.semanticVersion,G06:N&&z.artifact.artifactRef===t?.payload.candidateArtifactRef,G07:Qe(f?.payload.typedMetrics),G08:Qe(f?.payload.typedGuardrails)&&f.payload.typedGuardrails.every(({hard:ee})=>ee),G09:!!f?.payload.sampleReceipt,G10:f?.payload.verdict==="pass"&&f.payload.testsReceipt?.status==="allow"&&!!f.payload.testsReceipt.suiteVersion,G11:f?.payload.safetyPassed===!0,G12:f?.payload.privacyPassed===!0,G13:f?.payload.costPassed===!0&&f.payload.costEvidence?.tenantBudgetAllowed===!0&&f.payload.costEvidence.ratio<=1.2,G14:f?.payload.verdict==="pass",G15:I?.payload.verdict==="pass"&&I.payload.datasetRef!==f?.payload.datasetRef,G16:u?.payload.verdict==="pass",G17:dt(u),G18:C?.payload.riskDecision?.status==="allow",G19:b?.payload.approvalReceipt?.status==="allow",G20:lt(b,u),G21:!!t?.payload.baseline&&b?.payload.rollbackTestReceipt?.status==="allow"&&b.payload.rollbackTestReceipt.expectedBaselineFingerprint===t.payload.baseline.fingerprint&&b.payload.rollbackTestReceipt.observedRestoredFingerprint===t.payload.baseline.fingerprint,G22:b?.payload.killSwitchReceipt?.status==="allow"&&b.payload.killSwitchReceipt.receiptRef===b.payload.killSwitchRef,G23:_?.payload.verdict==="pass",G24:D?.payload.stage==="canary",G25:K?.payload.verdict==="pass"&&K.payload.typedGuardrails?.every(({passed:ee})=>ee)===!0}[e]}var Qe=(e)=>!!e&&e.length>0&&e.length<=16,J=(e,s,t)=>e.find((C)=>C.kind===t&&("governedLearning"in C.payload)&&C.payload.governedLearning?.event===s),U=(e,s)=>e.find((t)=>t.kind==="evaluation"&&t.payload.phase===s),dt=(e)=>!!e?.payload.generatorIdentity&&!!e.payload.evaluatorIdentity&&!!e.payload.independenceReceipt&&e.payload.independenceReceipt.status==="allow"&&e.payload.generatorIdentity.principalRef!==e.payload.evaluatorIdentity.principalRef&&e.payload.generatorIdentity.implementationFingerprint!==e.payload.evaluatorIdentity.implementationFingerprint&&e.payload.generatorIdentity.modelFingerprint!==e.payload.evaluatorIdentity.modelFingerprint&&e.payload.generatorIdentity.signerRef!==e.payload.evaluatorIdentity.signerRef,lt=(e,s)=>!!e?.payload.approvalReceipt?.signerRef&&!!s?.payload.generatorIdentity&&!!s.payload.evaluatorIdentity&&![s.payload.generatorIdentity.signerRef,s.payload.evaluatorIdentity.signerRef,s.payload.generatorIdentity.principalRef,s.payload.evaluatorIdentity.principalRef].includes(e.payload.approvalReceipt.signerRef);function la(e,s){let t=e.flatMap((u)=>u.kind==="evaluation"&&u.payload.phase?[u.payload.phase]:[]),C=["offline","holdout","adversarial","shadow"];for(let[u,_]of C.entries())if(t[u]!==void 0&&t[u]!==_)S(s,"CI_LEARNING_TRANSITION_INVALID",`records.phases.${u}`,"Evaluation phases cannot be skipped or reordered.");let f=t.indexOf("canary_compare");if(f>=0&&f!==4)S(s,"CI_LEARNING_TRANSITION_INVALID","records.phases.canary_compare","Canary comparison requires all four prior phases.");if(t.filter((u)=>u==="post_promotion").length>L.maxMonitoringComparisons)S(s,"CI_LEARNING_CAP_EXCEEDED","records.phases.post_promotion","Post-promotion comparison cap exceeded.")}function Je(e,s,t){if(!e.payload.governedLearning)return;if(!e.payload.phase||!e.payload.sampleReceipt||!e.payload.typedMetrics?.length||!e.payload.typedGuardrails?.length||!e.payload.generatorIdentity||!e.payload.evaluatorIdentity||!e.payload.independenceReceipt||!e.payload.testsReceipt||!e.payload.costEvidence)S(t,"CI_LEARNING_HISTORY_INCOMPLETE",`${s}.payload`,"Governed evaluation requires phase, sample, typed metrics and guardrails, identities, independence, tests, and cost evidence.")}function Ia(e,s,t,C,f,I){if(pt(t,f,I),$e(e,s,t,f,I),!Xe(e,s,t))S(I,"CI_LEARNING_TRANSITION_INVALID",`${f}.recordedAt`,"Governed review and expiry must equal their promotion-derived deadline.");if(t.kind==="evaluation")Je(t,f,I);if(t.kind==="evaluation"&&t.payload.phase){let u=t.payload.phase==="canary_compare"||t.payload.phase==="post_promotion"?"comparison":t.payload.phase;if(!C.event.startsWith(u))S(I,"CI_LEARNING_TRANSITION_INVALID",`${f}.payload.phase`,"Evaluation phase and event disagree.")}if(t.kind==="evaluation"&&t.payload.generatorIdentity&&t.payload.evaluatorIdentity){let u=t.payload.generatorIdentity,_=t.payload.evaluatorIdentity;if(u.principalRef===_.principalRef||u.implementationFingerprint===_.implementationFingerprint||u.modelFingerprint===_.modelFingerprint||u.signerRef===_.signerRef)S(I,"CI_LEARNING_TRANSITION_INVALID",`${f}.payload.evaluatorIdentity`,"Generator and evaluator must be independently identified.")}if(t.kind==="promotion"&&t.payload.gateBundle){let u=t.payload.stage==="canary"?23:t.payload.stage==="promoted"?25:0;if(u>0)mt(t.payload.gateBundle.gates,u,f,I);let _=e.slice(0,s);if(t.payload.gateBundle.gates.some((b)=>{let D=He(_,b.id,C.lifecycleId);return!D||b.receiptFingerprint!==D.fingerprint.value||!Ze(D,t.recordedAt)||!We(b.id,_)}))S(I,"CI_LEARNING_HISTORY_INCOMPLETE",`${f}.payload.gateBundle.gates`,"Every gate must cite the exact lifecycle-scoped record that proves its concrete fact.");if((t.payload.stage==="canary"||t.payload.stage==="promoted")&&t.payload.approvalReceipt?.status!=="allow")S(I,"CI_LEARNING_HISTORY_INCOMPLETE",`${f}.payload.approvalReceipt`,"Governed canary and promotion require a concrete approval allow receipt.");if(t.payload.approvalReceipt&&Date.parse(t.payload.approvalReceipt.decidedAt)+L.maxApprovalValidityMs<Date.parse(t.recordedAt))S(I,"CI_LEARNING_TRANSITION_INVALID",`${f}.payload.approvalReceipt`,"Approval receipt expired before use.")}if(t.kind==="promotion"&&(t.payload.stage==="canary"||t.payload.stage==="promoted")){let u=e.find((_)=>_.kind==="experiment"&&_.payload.governedLearning?.event==="candidate_proposed");if(u?.kind!=="experiment"||u.payload.candidate?.type!=="runtime_artifact")S(I,"CI_LEARNING_TRANSITION_INVALID",`${f}.payload.candidateArtifactRef`,"Repository work items cannot enter canary or promotion.")}if(t.kind==="rollback"&&t.payload.status==="executed"){let u=t.payload.reproduction;if(!u||u.expectedBaselineFingerprint!==u.observedActiveFingerprint)S(I,"CI_LEARNING_REPLAY_DRIFT",`${f}.payload.reproduction`,"Executed rollback must reproduce the exact baseline.")}if(t.kind==="replay"&&t.payload.status==="exact"&&(!t.payload.lifecycleHeadFingerprint||!t.payload.baselineFingerprint||!t.payload.effectiveArtifactFingerprint||t.payload.orderedTransitionFingerprints?.length!==C.sequence))S(I,"CI_LEARNING_REPLAY_DRIFT",`${f}.payload`,"Exact replay requires complete ordered fingerprints.")}function pt(e,s,t){if(e.recordRefIds.length>L.maxRecordRefs||e.evidenceRefIds.length>L.maxEvidenceRefs||new TextEncoder().encode(JSON.stringify(e.payload)).length>L.maxSerializedBytes)S(t,"CI_LEARNING_CAP_EXCEEDED",s,"Governed record exceeds a frozen v1 cap.");if(e.kind==="evaluation"&&e.payload.sampleReceipt){let C=e.payload.sampleReceipt,f=Object.values(C.strataCounts).reduce((u,_)=>u+_,0),I=Object.values(C.languageCounts).reduce((u,_)=>u+_,0);if(f!==C.observationCount||I!==C.observationCount)S(t,"CI_LEARNING_TRANSITION_INVALID",`${s}.payload.sampleReceipt`,"Sample strata and language counts must each cover the exact observation count.")}}function mt(e,s,t,C){let f=ce.slice(0,s);if(e.length!==s||e.some((I,u)=>I.id!==f[u]||I.status!=="passed"||!I.receiptFingerprint))S(C,"CI_LEARNING_HISTORY_INCOMPLETE",`${t}.payload.gateBundle.gates`,s===23?"Canary requires G01-G23 green.":"Promotion requires G01-G25 green.")}export{Ia as validateGovernedLearningRecord};

package/dist/validation/company-intelligence-learning-rules.d.ts

@@ -0,0 +1,6 @@
+import { type CompanyIntelligenceGovernedLearningLink, type CompanyIntelligenceRecord } from '../types/company-intelligence/index.js';
+import { type CompanyIntelligenceLearningValidationIssue } from './company-intelligence-learning-issues.js';
+export declare function governedLearningLink(record: CompanyIntelligenceRecord): CompanyIntelligenceGovernedLearningLink | undefined;
+export declare function sameGovernedLifecycleIdentity(record: CompanyIntelligenceRecord, firstRecord: CompanyIntelligenceRecord, link: CompanyIntelligenceGovernedLearningLink, first: CompanyIntelligenceGovernedLearningLink): boolean;
+export declare function validateGovernedLearningTransition(record: CompanyIntelligenceRecord, link: CompanyIntelligenceGovernedLearningLink, path: string, issues: CompanyIntelligenceLearningValidationIssue[]): void;
+export declare function validateGovernedLearningChain(records: readonly CompanyIntelligenceRecord[], index: number, record: CompanyIntelligenceRecord, link: CompanyIntelligenceGovernedLearningLink, issues: CompanyIntelligenceLearningValidationIssue[]): void;

package/dist/validation/company-intelligence-learning-rules.js

@@ -0,0 +1,2 @@
+// @bun
+function c(a,n,i){if(a.kind!=="feedback"||a.payload.feedbackType==="signal"||n.kind!=="feedback"||n.payload.feedbackType!=="signal")return!1;let e=a.payload.dispositionEvidence,t=n.payload.dispositionRefs;if(!e)return!1;return e.duplicate===!1&&e.signalFingerprint===n.payload.signalFingerprint&&e.originRefId===n.payload.originRefId&&e.consentReceipt.receiptRef===t.consentReceiptRef&&e.consentReceipt.receiptRef===a.payload.consentDecisionRef&&e.consentReceipt.purpose==="governed_learning"&&e.consentReceipt.scopeRefId===n.payload.consentScopeRefId&&e.consentReceipt.scopeRefId===i&&e.consentReceipt.signalFingerprint===n.payload.signalFingerprint&&e.redactionReceipt.receiptRef===t.redactionReceiptRef&&e.redactionReceipt.receiptRef===a.payload.redactionDecisionRef&&e.redactionReceipt.targetRefId===n.payload.originRefId&&e.authorityReceipt.receiptRef===t.authorityReceiptRef&&e.authorityReceipt.tenantId===n.tenantId&&e.authorityReceipt.tenantId===a.tenantId&&e.authorityReceipt.objectiveRefId===n.payload.objectiveRefId&&e.authorityReceipt.actorRef===n.payload.actorRef&&e.authorityReceipt.actorRef===a.payload.actorRef&&e.originIntegrityReceipt.receiptRef===t.originIntegrityReceiptRef&&e.originIntegrityReceipt.originRefId===n.payload.originRefId&&e.originIntegrityReceipt.classification===n.payload.originClassification&&e.originIntegrityReceipt.signalFingerprint===n.payload.signalFingerprint}function o(a,n,i,e){a.push({code:n,path:i,message:e})}var l={signal_captured:"feedback",consent_redaction_recorded:"feedback",classified:"experiment",baseline_objective_recorded:"experiment",candidate_proposed:"experiment",risk_policy_decided:"experiment",offline_evaluated:"evaluation",holdout_evaluated:"evaluation",adversarial_evaluated:"evaluation",shadow_evaluated:"evaluation",approval_recorded:"promotion",canary_started:"promotion",comparison_recorded:"evaluation",promotion_decided:"promotion",rollback_executed:"rollback",outcome_recorded:"feedback",review_due:"experiment",expired:"experiment",replay_verified:"replay"},p=new Set(["signal_captured:null:signal_pending","consent_redaction_recorded:signal_pending:feedback_accepted","classified:feedback_accepted:classified","baseline_objective_recorded:classified:candidate_pending","candidate_proposed:candidate_pending:candidate_pending","risk_policy_decided:candidate_pending:evaluating","risk_policy_decided:candidate_pending:rejected","offline_evaluated:evaluating:evaluating","holdout_evaluated:evaluating:evaluating","adversarial_evaluated:evaluating:evaluating","adversarial_evaluated:evaluating:rejected","shadow_evaluated:evaluating:shadow","shadow_evaluated:evaluating:rejected","approval_recorded:shadow:awaiting_approval","canary_started:awaiting_approval:canary","comparison_recorded:canary:canary","comparison_recorded:canary:rejected","promotion_decided:canary:promoted","promotion_decided:canary:rejected","comparison_recorded:promoted:promoted","comparison_recorded:promoted:rejected","rollback_executed:rejected:rolled_back","rollback_executed:promoted:rolled_back","rollback_executed:review_due:rolled_back","outcome_recorded:promoted:outcome_recorded","outcome_recorded:rejected:outcome_recorded","outcome_recorded:rolled_back:outcome_recorded","review_due:outcome_recorded:review_due","expired:review_due:expired","replay_verified:expired:replay_exact","replay_verified:expired:replay_drifted","replay_verified:expired:blocked"]);function I(a){if(!("governedLearning"in a.payload))return;return a.payload.governedLearning}function f(a,n,i,e){return a.tenantId===n.tenantId&&i.lifecycleId===e.lifecycleId&&a.ownerRef.id===n.ownerRef.id&&a.ownerRef.type===n.ownerRef.type&&a.ownerRef.label===n.ownerRef.label&&a.contractVersion===n.contractVersion&&a.fingerprint.version===n.fingerprint.version&&a.fingerprint.canonicalization===n.fingerprint.canonicalization}function R(a,n,i,e){if(n.occurredAt!==a.recordedAt)o(e,"CI_LEARNING_FINGERPRINT_MISMATCH",`${i}.recordedAt`,"Recorded and governed occurrence time must match.");if(a.kind!==l[n.event])o(e,"CI_LEARNING_TRANSITION_INVALID",`${i}.kind`,"Event is stored in the wrong canonical record kind.");if(n.event==="signal_captured"&&(a.kind!=="feedback"||a.payload.feedbackType!=="signal"||a.payload.status!=="quarantined"))o(e,"CI_LEARNING_TRANSITION_INVALID",`${i}.payload.status`,"Only a zero-weight quarantined signal may await consent and redaction.");if(n.event==="consent_redaction_recorded"&&(a.kind!=="feedback"||a.payload.feedbackType==="signal"||a.payload.status!=="accepted"))o(e,"CI_LEARNING_TRANSITION_INVALID",`${i}.payload.status`,"Learning requires accepted feedback with consent and redaction refs.");let t=`${n.event}:${n.stateBefore??"null"}:${n.stateAfter}`;if(!p.has(t))o(e,"CI_LEARNING_TRANSITION_INVALID",`${i}.payload.governedLearning`,`Illegal governed transition ${t}.`)}function u(a,n,i,e,t){if(n===0){if(e.event!=="signal_captured"||e.stateBefore!==null||e.previousTransitionRecordRefId||e.previousStateFingerprint)o(t,"CI_LEARNING_HISTORY_INCOMPLETE","records.0","Sequence zero must be an unlinked signal capture.");return}let d=a[n-1],r=I(d);if(e.event==="consent_redaction_recorded"&&!c(i,d,e.lifecycleId))o(t,"CI_LEARNING_HISTORY_INCOMPLETE",`records.${n}.payload.dispositionEvidence`,"Accepted governed feedback requires exact allow disposition evidence.");if(!r||e.previousTransitionRecordRefId!==d.id||e.previousStateFingerprint!==r.stateFingerprint||e.stateBefore!==r.stateAfter||!i.recordRefIds.includes(d.id))o(t,"CI_LEARNING_HEAD_CONFLICT",`records.${n}`,"Transition does not extend the exact previous head.")}export{I as governedLearningLink,f as sameGovernedLifecycleIdentity,u as validateGovernedLearningChain,R as validateGovernedLearningTransition};

package/dist/validation/company-intelligence-learning.d.ts

@@ -0,0 +1,4 @@
+import { type CompanyIntelligenceRecord } from '../types/company-intelligence/index.js';
+import { type CompanyIntelligenceLearningValidationResult } from './company-intelligence-learning-issues.js';
+export * from './company-intelligence-learning-issues.js';
+export declare function validateCompanyIntelligenceGovernedLearningHistory(records: readonly CompanyIntelligenceRecord[]): CompanyIntelligenceLearningValidationResult;

package/dist/validation/company-intelligence-learning.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as B}from"zod";import{z as h}from"zod";import{z as b}from"zod";var N=b.record(b.string(),b.unknown()),D=b.object({id:b.string().min(1),connectorCapability:b.string().min(1),providerKey:b.string().min(1).optional(),externalId:b.string().min(1).optional(),url:b.string().url().optional(),observedAt:b.string().min(1),metadata:N.default({})}),Et=b.object({default:b.string().min(1),translations:b.record(b.string(),b.string()).default({})}),L=b.object({id:b.string().min(1),type:b.string().min(1),label:b.string().min(1).optional()});var te="1.0.0",sn="company-intelligence-sha256:v1",dn="canonical-json:v1",At=h.enum(["truth","policy","proposal","approval","execution","outcome"]),Gt=h.enum(["source","source_version","asset","part","fragment","evidence","claim","policy","entity","relation","conflict","gap","graph","edition","query","answer","verification","feedback","experiment","evaluation","promotion","rollback","replay"]),d=h.string().regex(/^sha256:[a-f0-9]{64}$/),ln=h.object({version:h.literal(sn),canonicalization:h.literal(dn),value:d}).strict(),ie=h.object({from:h.iso.datetime({offset:!0}),to:h.iso.datetime({offset:!0}).optional()}).strict(),pn=h.object({reason:h.enum(["source_deleted","acl_revoked","superseded","retention_expired","privacy_request"]),tombstonedAt:h.iso.datetime({offset:!0})}).strict(),T=h.object({page:h.number().int().positive().optional(),section:h.string().min(1).optional(),lineStart:h.number().int().positive().optional(),lineEnd:h.number().int().positive().optional(),cell:h.string().min(1).optional(),messageId:h.string().min(1).optional(),timeStartMs:h.number().int().nonnegative().optional(),timeEndMs:h.number().int().nonnegative().optional()}).strict().refine((e)=>Object.values(e).some((n)=>n!==void 0),{message:"At least one stable evidence locator is required."}),Ie=h.array(h.string().min(1)).refine((e)=>new Set(e).size===e.length,{message:"Reference ids must be unique."}),x=h.object({contractVersion:h.literal(te),id:h.string().min(1),tenantId:h.string().min(1),ownerRef:L.strict(),recordedAt:h.iso.datetime({offset:!0}),validTime:ie,recordRefIds:Ie.default([]),evidenceRefIds:Ie.default([]),supersedesRefId:h.string().min(1).optional(),tombstone:pn.optional(),fingerprint:ln}).strict();import{z as R}from"zod";var ae=R.enum(["answered","abstained","refused","conflicted","degraded"]),re=x.extend({kind:R.literal("query"),authorityClass:R.literal("proposal"),payload:R.object({actorRef:R.string().min(1),questionDigest:R.string().regex(/^sha256:[a-f0-9]{64}$/),authorizationDecisionRef:R.string().min(1),retrievalConfigRef:R.string().min(1),requestedAt:R.iso.datetime({offset:!0}),maxEvidenceRecords:R.number().int().positive(),filters:R.record(R.string(),R.string()).default({})}).strict()}).strict(),oe=x.extend({kind:R.literal("answer"),authorityClass:R.literal("truth"),payload:R.object({queryRefId:R.string().min(1),status:ae,text:R.string().min(1).optional(),claimRefIds:R.array(R.string().min(1)).default([]),citationEvidenceRefIds:R.array(R.string().min(1)).default([]),conflictRefIds:R.array(R.string().min(1)).default([]),retrievalRunRef:R.string().min(1),verificationRefId:R.string().min(1).optional(),policyDecisionRef:R.string().min(1).optional(),graphSnapshotRefId:R.string().min(1).optional(),editionRefId:R.string().min(1).optional(),replayRefId:R.string().min(1),reasons:R.array(R.string().min(1)).default([]),usage:R.object({modelRef:R.string().min(1),promptFingerprint:R.string().regex(/^sha256:[a-f0-9]{64}$/),latencyMs:R.number().int().nonnegative(),costMicros:R.number().int().nonnegative()}).strict(),knowledgeAuthorizesAction:R.literal(!1)}).strict()}).strict(),ce=x.extend({kind:R.literal("verification"),authorityClass:R.literal("truth"),payload:R.object({answerRefId:R.string().min(1),verdict:R.enum(["supported","unsupported","blocked"]),claimSupport:R.array(R.object({claimRefId:R.string().min(1),evidenceRefIds:R.array(R.string().min(1)).min(1),verdict:R.enum(["supported","unsupported"]),confidence:R.number().min(0).max(1)}).strict()).default([]),deterministicRefsValidated:R.boolean(),independentVerifierRef:R.string().min(1),verifiedAt:R.iso.datetime({offset:!0})}).strict()}).strict(),Re=[re,oe,ce];import{z as l}from"zod";var H=l.enum(["unreviewed","review_required","approved","rejected","superseded"]),mn=x.extend({kind:l.literal("claim"),authorityClass:l.literal("truth"),payload:l.object({claimType:l.enum(["fact","procedure","decision","hypothesis","commitment","objective","risk","skill_candidate"]),statement:l.string().min(1),confidence:l.number().min(0).max(1),reviewState:H,freshness:l.enum(["fresh","stale","unknown"])}).strict()}).strict(),gn=x.extend({kind:l.literal("policy"),authorityClass:l.literal("policy"),payload:l.object({normativeStatement:l.string().min(1),scopeRefIds:l.array(l.string().min(1)).min(1),approvalRequired:l.boolean(),exceptionRefIds:l.array(l.string().min(1)).default([]),reviewState:H}).strict()}).strict(),yn=x.extend({kind:l.literal("entity"),authorityClass:l.literal("truth"),payload:l.object({entityType:l.string().min(1),label:l.string().min(1),resolutionState:l.enum(["candidate","canonical","rejected","merged"]),stableIdentifierDigests:l.array(d).default([]),confidence:l.number().min(0).max(1),reviewState:H}).strict()}).strict(),fn=x.extend({kind:l.literal("relation"),authorityClass:l.literal("truth"),payload:l.object({fromEntityRefId:l.string().min(1),toEntityRefId:l.string().min(1),predicate:l.string().min(1),confidence:l.number().min(0).max(1),reviewState:H}).strict()}).strict(),un=x.extend({kind:l.literal("conflict"),authorityClass:l.literal("truth"),payload:l.object({subjectRefId:l.string().min(1),competingRecordRefIds:l.array(l.string().min(1)).min(2),status:l.enum(["review_required","resolved","accepted_conflict"]),summary:l.string().min(1)}).strict()}).strict(),In=x.extend({kind:l.literal("gap"),authorityClass:l.literal("truth"),payload:l.object({question:l.string().min(1),reason:l.enum(["missing_evidence","conflict","stale","ownerless","unauthorized"]),severity:l.enum(["low","medium","high","critical"]),remediationRefId:l.string().min(1).optional(),state:l.enum(["open","in_review","resolved","accepted_unknown"])}).strict()}).strict(),Rn=x.extend({kind:l.literal("graph"),authorityClass:l.literal("truth"),payload:l.object({nodeRefIds:l.array(l.string().min(1)).min(1),edgeRefIds:l.array(l.string().min(1)).default([]),conflictRefIds:l.array(l.string().min(1)).default([]),snapshotAt:l.iso.datetime({offset:!0}),bounds:l.object({maxDepth:l.number().int().positive(),maxNodes:l.number().int().positive(),maxEdges:l.number().int().positive(),timeoutMs:l.number().int().positive()}).strict()}).strict()}).strict(),Cn=x.extend({kind:l.literal("edition"),authorityClass:l.literal("truth"),payload:l.object({version:l.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/),recordRefIds:l.array(l.string().min(1)).min(1),graphSnapshotRefId:l.string().min(1),reviewDecisionRef:l.string().min(1),parentEditionRefId:l.string().min(1).optional(),schemaFingerprint:d}).strict()}).strict(),se=[mn,gn,yn,fn,un,In,Rn,Cn];import{z as a}from"zod";import{z as o}from"zod";import{z as k}from"zod";var _n="company-intelligence-governed-learning:v1",A=Object.freeze({maxTransitions:64,maxMonitoringComparisons:8,maxPacketClosureRecords:128,maxRecordRefs:64,maxEvidenceRefs:64,maxMetrics:16,maxGuardrails:16,maxReasonCodes:16,minSampleObservations:1000,maxSampleObservations:1e4,maxSerializedBytes:65536,defaultDecisionDeadlineMs:1000,maxDecisionDeadlineMs:5000,maxAppendDeadlineMs:5000,maxGateAgeMs:86400000,maxApprovalValidityMs:86400000,maxReviewIntervalMs:2592000000,maxPromotionExpiryMs:7776000000}),vn=k.enum(["signal_captured","consent_redaction_recorded","classified","baseline_objective_recorded","candidate_proposed","risk_policy_decided","offline_evaluated","holdout_evaluated","adversarial_evaluated","shadow_evaluated","approval_recorded","canary_started","comparison_recorded","promotion_decided","rollback_executed","outcome_recorded","review_due","expired","replay_verified"]),Ce=k.enum(["signal_pending","feedback_accepted","classified","candidate_pending","evaluating","shadow","awaiting_approval","canary","promoted","rejected","rolled_back","outcome_recorded","review_due","expired","replay_exact","replay_drifted","blocked"]),de=["G01","G02","G03","G04","G05","G06","G07","G08","G09","G10","G11","G12","G13","G14","G15","G16","G17","G18","G19","G20","G21","G22","G23","G24","G25"],_e=k.enum(de),hn=["CI_LEARNING_BASELINE_REQUIRED","CI_LEARNING_BASELINE_NOT_IMMUTABLE","CI_LEARNING_OBJECTIVE_REQUIRED","CI_LEARNING_CANDIDATE_REQUIRED","CI_LEARNING_CANDIDATE_VERSION_REQUIRED","CI_LEARNING_CANDIDATE_FINGERPRINT_MISMATCH","CI_LEARNING_METRICS_REQUIRED","CI_LEARNING_GUARDRAILS_REQUIRED","CI_LEARNING_SAMPLE_NOT_REPRESENTATIVE","CI_LEARNING_TESTS_FAILED","CI_LEARNING_SAFETY_FAILED","CI_LEARNING_PRIVACY_FAILED","CI_LEARNING_COST_FAILED","CI_LEARNING_OFFLINE_REQUIRED","CI_LEARNING_HOLDOUT_REQUIRED","CI_LEARNING_ADVERSARIAL_REQUIRED","CI_LEARNING_EVALUATOR_NOT_INDEPENDENT","CI_LEARNING_POLICY_DENIED","CI_LEARNING_APPROVAL_REQUIRED","CI_LEARNING_APPROVER_NOT_INDEPENDENT","CI_LEARNING_ROLLBACK_PLAN_REQUIRED","CI_LEARNING_KILL_SWITCH_REQUIRED","CI_LEARNING_SHADOW_REQUIRED","CI_LEARNING_CANARY_REQUIRED","CI_LEARNING_COMPARISON_FAILED"],xn=[...hn,"CI_LEARNING_SIGNAL_ACCEPTED","CI_LEARNING_FEEDBACK_POISONED","CI_LEARNING_CONSENT_REQUIRED","CI_LEARNING_REDACTION_REQUIRED","CI_LEARNING_AUTHORITY_REQUIRED","CI_LEARNING_CLASSIFICATION_REQUIRED","CI_LEARNING_SIGNAL_DUPLICATE","CI_LEARNING_SIGNAL_ORIGIN_INVALID","CI_LEARNING_SELF_APPLY_FORBIDDEN","CI_LEARNING_RUNTIME_ARTIFACT_NOT_BOUNDED","CI_LEARNING_VENDOR_EXPORT_DENIED","CI_LEARNING_VENDOR_LEARNING_DENIED","CI_LEARNING_EGRESS_EVIDENCE_REQUIRED","CI_LEARNING_CANARY_GATES_INCOMPLETE","CI_LEARNING_CANARY_REGRESSION","CI_LEARNING_ROLLBACK_REPRODUCTION_FAILED","CI_LEARNING_OUTCOME_REQUIRED","CI_LEARNING_REVIEW_DUE","CI_LEARNING_EXPIRED","CI_LEARNING_REPLAY_EXACT","CI_LEARNING_REPLAY_DRIFT"],le=k.enum(xn),En=k.array(le).max(A.maxReasonCodes).refine((e)=>e.every((n,t)=>t===0||e[t-1]<n),"Reason codes must be sorted and unique."),j=k.object({version:k.literal(_n),lifecycleId:k.string().min(1),sequence:k.number().int().min(0).max(63),event:vn,stateBefore:Ce.nullable(),stateAfter:Ce,previousTransitionRecordRefId:k.string().min(1).optional(),previousStateFingerprint:d.optional(),inputFingerprint:d,stateFingerprint:d,reasonCodes:En,occurredAt:k.iso.datetime({offset:!0})}).strict();import{z as S}from"zod";var Q=S.object({receiptRef:S.string().min(1),status:S.literal("allow"),fingerprint:d,decidedAt:S.iso.datetime({offset:!0}),signerRef:S.string().min(1)}),ve=S.object({consentReceiptRef:S.string().min(1),redactionReceiptRef:S.string().min(1),authorityReceiptRef:S.string().min(1),originIntegrityReceiptRef:S.string().min(1)}).strict(),he=S.object({signalFingerprint:d,originRefId:S.string().min(1),consentReceipt:Q.extend({purpose:S.literal("governed_learning"),scopeRefId:S.string().min(1),signalFingerprint:d}).strict(),redactionReceipt:Q.extend({targetRefId:S.string().min(1)}).strict(),authorityReceipt:Q.extend({tenantId:S.string().min(1),objectiveRefId:S.string().min(1),actorRef:S.string().min(1)}).strict(),originIntegrityReceipt:Q.extend({originRefId:S.string().min(1),classification:S.literal("verified_first_party"),signalFingerprint:d}).strict(),duplicate:S.literal(!1)}).strict();var X=o.object({artifactRef:o.string().min(1),semanticVersion:o.string().regex(/^\d+\.\d+\.\d+$/),fingerprint:d}).strict(),xe=o.object({id:o.string().min(1),metric:o.string().min(1),direction:o.enum(["increase","decrease"]),threshold:o.number(),ownerRef:o.string().min(1)}).strict(),V=o.object({receiptRef:o.string().min(1),status:o.enum(["allow","deny","missing","failed","blocked","expired"]),fingerprint:d,decidedAt:o.iso.datetime({offset:!0}),signerRef:o.string().min(1)}).strict(),Ee=o.object({suiteVersion:o.string().min(1),status:o.literal("allow"),fingerprint:d,decidedAt:o.iso.datetime({offset:!0}),signerRef:o.string().min(1)}).strict(),Se=o.object({baselineNormalizedCost:o.number().positive(),candidateNormalizedCost:o.number().positive(),ratio:o.number().positive().max(1.2),tenantBudgetAllowed:o.literal(!0),fingerprint:d}).strict().superRefine((e,n)=>{let t=e.candidateNormalizedCost/e.baselineNormalizedCost;if(Math.abs(t-e.ratio)>Number.EPSILON)n.addIssue({code:"custom",path:["ratio"],message:"Cost ratio must match candidate divided by baseline."})}),be=o.object({expectedBaselineFingerprint:d,observedRestoredFingerprint:d,status:o.literal("allow"),fingerprint:d}).strict().superRefine((e,n)=>{if(e.expectedBaselineFingerprint!==e.observedRestoredFingerprint)n.addIssue({code:"custom",path:["observedRestoredFingerprint"],message:"Rollback test must reproduce the exact baseline."})}),pe=o.object({principalRef:o.string().min(1),implementationFingerprint:d,modelFingerprint:d,signerRef:o.string().min(1)}).strict(),Ne=o.object({datasetVersion:o.string().min(1),seed:o.number().int(),selectionMethod:o.string().min(1),observationCount:o.number().int().min(1000).max(1e4),strataCounts:o.record(o.string(),o.number().int().nonnegative()),languageCounts:o.record(o.string(),o.number().int().nonnegative()),fingerprint:d}).strict(),me=o.object({metricRef:o.string().min(1),baseline:o.number(),candidate:o.number(),lowerConfidenceBound:o.number().optional(),passed:o.boolean()}).strict(),ge=o.object({guardrailRef:o.string().min(1),observed:o.number(),threshold:o.number(),operator:o.enum(["eq","lte","gte"]),passed:o.boolean(),hard:o.literal(!0)}).strict(),Ae=o.object({headFingerprint:d,gates:o.array(o.object({id:_e,status:o.enum(["passed","missing","failed","blocked","expired"]),reasonCode:le,receiptFingerprint:d.optional()}).strict()).max(25)}).strict(),Ge=o.discriminatedUnion("type",[o.object({type:o.literal("runtime_artifact"),artifactKind:o.enum(["prompt","provider_route","retrieval_configuration","ranking_rule","extraction_rule","entity_resolution_rule","memory_rule","compiled_skill","runbook_artifact","runtime_policy"]),artifact:X,activation:o.literal("governed_runtime_activation"),selfApply:o.literal(!1)}).strict(),o.object({type:o.literal("repository_work_item"),changeKind:o.enum(["code","public_contract","migration","deployment_configuration"]),workItemRef:o.string().min(1),fingerprint:d,promotable:o.literal(!1),selfApply:o.literal(!1)}).strict()]),Le=o.object({vendorExportRequested:o.boolean(),vendorLearningRequested:o.boolean(),vendorExportAllowed:o.boolean().default(!1),vendorLearningAllowed:o.boolean().default(!1),receiptFingerprints:o.array(d).max(5),binding:o.object({signalFingerprint:d,sampleFingerprint:d,artifactFingerprint:d}).strict().optional()}).strict().superRefine((e,n)=>{if(!e.vendorExportAllowed&&!e.vendorLearningAllowed)return;if(!e.binding||e.receiptFingerprints.length!==5||new Set(e.receiptFingerprints).size!==5)n.addIssue({code:"custom",message:"Allowed vendor eligibility requires five unique bound receipts."})}),ke=o.object({baselineFingerprint:d,candidateFingerprint:d,sampleFingerprint:d,metrics:o.array(me).min(1).max(16),guardrails:o.array(ge).min(1).max(16),costRatio:o.number().positive(),latencyRatio:o.number().positive(),passed:o.boolean(),fingerprint:d}).strict(),Oe=o.object({expectedBaselineFingerprint:d,observedActiveFingerprint:d,restoredArtifactRef:o.string().min(1),reproductionReceiptFingerprint:d}).strict();var we=a.enum(["prompt","provider_route","retrieval_configuration","ranking_rule","extraction_rule","entity_resolution_rule","memory_rule","compiled_skill","runbook_artifact","runtime_policy"]),bn=a.object({answerRefId:a.string().min(1),actorRef:a.string().min(1),feedbackType:a.enum(["correction","outcome","retrieval_failure","drift"]),consentDecisionRef:a.string().min(1),redactionDecisionRef:a.string().min(1),correctionRefId:a.string().min(1).optional(),outcomeRefId:a.string().min(1).optional(),status:a.enum(["accepted","rejected","quarantined"]),governedLearning:j.optional(),dispositionEvidence:he.optional()}).strict(),Nn=a.object({feedbackType:a.literal("signal"),signalRefId:a.string().min(1),originRefId:a.string().min(1),actorRef:a.string().min(1),signalFingerprint:d,objectiveRefId:a.string().min(1),consentScopeRefId:a.string().min(1),originClassification:a.literal("verified_first_party"),dispositionRefs:ve,status:a.enum(["quarantined","rejected"]),governedLearning:j}).strict(),An=x.extend({kind:a.literal("feedback"),authorityClass:a.literal("outcome"),payload:a.union([bn,Nn])}).strict(),Gn=x.extend({kind:a.literal("experiment"),authorityClass:a.literal("proposal"),payload:a.object({baselineRefId:a.string().min(1),candidateArtifactRef:a.string().min(1),candidateKind:we,objective:a.string().min(1),policyDecisionRef:a.string().min(1),metricRefIds:a.array(a.string().min(1)).min(1),guardrailRefIds:a.array(a.string().min(1)).min(1),holdoutDatasetRef:a.string().min(1),adversarialDatasetRef:a.string().min(1),governedLearning:j.optional(),baseline:X.optional(),candidate:Ge.optional(),objectiveDefinition:xe.optional(),riskDecision:V.optional(),egressDecision:Le.optional(),reviewDueAt:a.iso.datetime({offset:!0}).optional(),expiresAt:a.iso.datetime({offset:!0}).optional(),state:a.enum(["proposed","offline_evaluation","shadow","canary","completed","rejected"])}).strict()}).strict(),Ln=x.extend({kind:a.literal("evaluation"),authorityClass:a.literal("truth"),payload:a.object({experimentRefId:a.string().min(1),candidateArtifactRef:a.string().min(1),evaluatorRef:a.string().min(1),independent:a.literal(!0),datasetRef:a.string().min(1),metricResults:a.record(a.string(),a.number()),safetyPassed:a.boolean(),privacyPassed:a.boolean(),costPassed:a.boolean(),verdict:a.enum(["pass","fail","blocked"]),evaluatedAt:a.iso.datetime({offset:!0}),governedLearning:j.optional(),phase:a.enum(["offline","holdout","adversarial","shadow","canary_compare","post_promotion"]).optional(),sampleReceipt:Ne.optional(),typedMetrics:a.array(me).max(16).optional(),typedGuardrails:a.array(ge).max(16).optional(),generatorIdentity:pe.optional(),evaluatorIdentity:pe.optional(),independenceReceipt:V.optional(),testsReceipt:Ee.optional(),costEvidence:Se.optional()}).strict()}).strict(),kn=x.extend({kind:a.literal("promotion"),authorityClass:a.literal("approval"),payload:a.object({experimentRefId:a.string().min(1),evaluationRefId:a.string().min(1),candidateArtifactRef:a.string().min(1),candidateKind:we,approvalDecisionRef:a.string().min(1),policyDecisionRef:a.string().min(1),rollbackRefId:a.string().min(1),killSwitchRef:a.string().min(1),stage:a.enum(["shadow","canary","promoted","rejected"]),approvedAt:a.iso.datetime({offset:!0}).optional(),governedLearning:j.optional(),gateBundle:Ae.optional(),approvalReceipt:V.optional(),rollbackTestReceipt:be.optional(),killSwitchReceipt:V.optional(),comparisonReceipt:ke.optional(),effectiveArtifact:X.optional()}).strict().superRefine((e,n)=>{if(e.governedLearning&&(e.stage==="canary"||e.stage==="promoted")&&!e.gateBundle)n.addIssue({code:"custom",path:["gateBundle"],message:"Governed canary and promotion require a gate bundle."})})}).strict(),On=x.extend({kind:a.literal("rollback"),authorityClass:a.literal("execution"),payload:a.object({promotionRefId:a.string().min(1),baselineRefId:a.string().min(1),triggerRef:a.string().min(1),status:a.enum(["ready","executed","failed"]),executedAt:a.iso.datetime({offset:!0}).optional(),outcomeRefId:a.string().min(1).optional(),replayRefId:a.string().min(1),governedLearning:j.optional(),reproduction:Oe.optional()}).strict()}).strict(),wn=x.extend({kind:a.literal("replay"),authorityClass:a.literal("truth"),payload:a.object({inputFingerprint:d,configurationRefIds:a.array(a.string().min(1)).min(1),codeVersionRef:a.string().min(1),providerFixtureRef:a.string().min(1),orderedEventRefIds:a.array(a.string().min(1)),outputFingerprint:d,status:a.enum(["exact","drifted","blocked"]),replayedAt:a.iso.datetime({offset:!0}),governedLearning:j.optional(),lifecycleHeadFingerprint:d.optional(),baselineFingerprint:d.optional(),effectiveArtifactFingerprint:d.optional(),orderedTransitionFingerprints:a.array(d).optional()}).strict()}).strict(),ye=[An,Gn,Ln,kn,On,wn];import{z as f}from"zod";var Dn=x.extend({kind:f.literal("source"),authorityClass:f.literal("truth"),payload:f.object({connectionRef:f.string().min(1),authorizationRef:f.string().min(1),externalId:f.string().min(1),sourceType:f.string().min(1),aclRefIds:f.array(f.string().min(1)).min(1),state:f.enum(["registered","ready","degraded","revoked","deleted"])}).strict()}).strict(),Tn=x.extend({kind:f.literal("source_version"),authorityClass:f.literal("truth"),payload:f.object({sourceRecordRefId:f.string().min(1),version:f.number().int().positive(),observedAt:f.iso.datetime({offset:!0}),sourceFingerprint:d,assetRefIds:f.array(f.string().min(1)).default([])}).strict()}).strict(),jn=x.extend({kind:f.literal("asset"),authorityClass:f.literal("truth"),payload:f.object({sourceVersionRefId:f.string().min(1),mediaType:f.string().min(1),byteLength:f.number().int().nonnegative(),storageRef:f.string().min(1),contentFingerprint:d,classification:f.enum(["public","internal","confidential","restricted"]),aclRefIds:f.array(f.string().min(1)).min(1)}).strict()}).strict(),Fn=x.extend({kind:f.literal("part"),authorityClass:f.literal("truth"),payload:f.object({assetRefId:f.string().min(1),partKind:f.enum(["page","section","table","line","cell","message","time_range"]),ordinal:f.number().int().nonnegative(),locator:T,contentFingerprint:d,language:f.string().min(2).optional(),parentPartRefId:f.string().min(1).optional()}).strict()}).strict(),zn=x.extend({kind:f.literal("fragment"),authorityClass:f.literal("truth"),payload:f.object({partRefId:f.string().min(1),stableFragmentId:f.string().min(1),ordinal:f.number().int().nonnegative(),locator:T,contentFingerprint:d,tokenCount:f.number().int().nonnegative(),previousFragmentRefId:f.string().min(1).optional(),nextFragmentRefId:f.string().min(1).optional(),aclRefIds:f.array(f.string().min(1)).min(1)}).strict()}).strict(),Pn=x.extend({kind:f.literal("evidence"),authorityClass:f.literal("truth"),payload:f.object({sourceVersionRefId:f.string().min(1),assetRefId:f.string().min(1).optional(),partRefId:f.string().min(1),fragmentRefId:f.string().min(1),locator:T,authorizationDecisionRef:f.string().min(1),redactionDecisionRef:f.string().min(1),contentFingerprint:d}).strict()}).strict(),fe=[Dn,Tn,jn,Fn,zn,Pn];import{z as r}from"zod";import{z as p}from"zod";import{z as c}from"zod";import{z as C}from"zod";var Z=C.object({id:C.string().min(1),substrate:C.enum(["knowledge","data_transmission","authos","rbac"]),ref:C.string().min(1),evidenceRefIds:C.array(C.string().min(1)).default([]),metadata:N.default({})}),Bn=Z.extend({substrate:C.literal("knowledge"),spaceKey:C.string().min(1).optional(),fragmentId:C.string().min(1),sourceRef:D.optional(),queryEvidenceRef:C.string().min(1).optional()}),De=Z.extend({substrate:C.literal("data_transmission"),protocolVersion:C.literal("data-transmission.v0"),roomId:C.string().min(1),cursor:C.string().min(1).optional(),idempotencyKey:C.string().min(1).optional()}),Te=Z.extend({substrate:C.literal("authos"),actorId:C.string().min(1),sessionRef:C.string().min(1).optional(),tenantId:C.string().min(1).optional()}),je=Z.extend({substrate:C.literal("rbac"),decisionId:C.string().min(1),verdict:C.enum(["allow","deny","redacted","redact","requires_review"]),permissionIds:C.array(C.string().min(1)).default([]),redactedFieldRefs:C.array(C.string().min(1)).default([])}),Fe=C.discriminatedUnion("substrate",[Bn,De,Te,je]),ii=C.object({actorRef:Te,rbacDecisionRef:je,resourceRef:C.string().min(1),sourceAclRefIds:C.array(C.string().min(1)).default([]),policyRefIds:C.array(C.string().min(1)).default([]),evidenceRefIds:C.array(C.string().min(1)).default([])}),ai=C.object({roomRef:De,changeRef:C.string().min(1),sequence:C.number().int().nonnegative(),idempotencyKey:C.string().min(1),replayRef:C.string().min(1)});var Vn=c.object({id:c.string().min(1),kind:c.enum(["knowledge","communication","issue_tracker","code_host","documentation","customer_system","incident_system","manual_record"]),label:c.string().min(1),connectorCapability:c.string().min(1),freshnessSla:c.enum(["manual","hourly","daily","near_realtime"]),metadata:N.default({})}),Mn=c.object({id:c.string().min(1),sourceSystemId:c.string().min(1),externalId:c.string().min(1),recordType:c.string().min(1),sourceHash:c.string().min(1),observedAt:c.string().min(1),provenance:c.array(D).min(1),substrateRefs:c.array(Fe).default([]),evidenceRefIds:c.array(c.string().min(1)).min(1),metadata:N.default({})}),qn=c.enum(["person","team","customer","project","repository","ticket","meeting","document","incident","decision","commitment","procedure","runbook","objective","work_item","knowledge_fragment"]),ue=c.object({status:c.enum(["fresh","stale","unknown"]),observedAt:c.string().min(1),expiresAt:c.string().min(1).optional(),evidenceRefIds:c.array(c.string().min(1)).min(1)}),Un=c.object({reason:c.enum(["deleted_source","superseded","privacy_request","merged"]),tombstonedAt:c.string().min(1),supersededByNodeId:c.string().min(1).optional(),evidenceRefIds:c.array(c.string().min(1)).min(1)}),$n=c.object({id:c.string().min(1),kind:qn,label:c.string().min(1),sourceRecordRefIds:c.array(c.string().min(1)).min(1),evidenceRefIds:c.array(c.string().min(1)).min(1),sourceAclRefIds:c.array(c.string().min(1)).default([]),policyRefIds:c.array(c.string().min(1)).default([]),confidence:c.number().min(0).max(1),reviewState:c.enum(["unreviewed","review_required","reviewed","rejected"]),freshness:ue,tombstone:Un.optional(),conflictRefIds:c.array(c.string().min(1)).default([]),metadata:N.default({})}),Kn=c.object({id:c.string().min(1),kind:c.enum(["owns","member_of","relates_to","blocks","depends_on","documents","decides","commits_to","implements","escalates_to","runbook_for","evidence_for"]),fromNodeId:c.string().min(1),toNodeId:c.string().min(1),sourceRecordRefIds:c.array(c.string().min(1)).min(1),evidenceRefIds:c.array(c.string().min(1)).min(1),confidence:c.number().min(0).max(1),reviewState:c.enum(["unreviewed","review_required","reviewed","rejected"]),metadata:N.default({})}),Yn=c.object({id:c.string().min(1),subjectNodeId:c.string().min(1),conflictingNodeIds:c.array(c.string().min(1)).default([]),conflictingRecordRefIds:c.array(c.string().min(1)).min(1),status:c.enum(["review_required","resolved","accepted_conflict"]),summary:c.string().min(1),evidenceRefIds:c.array(c.string().min(1)).min(1)}),di=c.object({id:c.string().min(1),generatedAt:c.string().min(1),snapshotHash:c.string().min(1),sourceSystems:c.array(Vn).min(1),sourceRecords:c.array(Mn).min(1),nodes:c.array($n).min(1),edges:c.array(Kn).default([]),conflicts:c.array(Yn).default([]),replayCursorRef:c.string().min(1).optional(),evidenceRefIds:c.array(c.string().min(1)).min(1),metadata:N.default({})});var Hn=p.enum(["skill_file","runbook_pack","agent_prompt","conformance_pack"]),Qn=p.enum(["ready","blocked","review_required","stale","unauthorized","identity_unresolved","acl_redacted","conflicted"]),Xn=p.enum(["pass","fail","not_run","blocked"]),Zn=p.enum(["proposed","accepted","rejected","superseded","applied_to_contract"]),ze=p.object({id:p.string().min(1),artifactKind:Hn,version:p.string().min(1),artifactRef:L,runbookProcedureId:p.string().min(1),sourceRecordRefIds:p.array(p.string().min(1)).min(1),identityDecisionIds:p.array(p.string().min(1)).default([]),accessDecisionIds:p.array(p.string().min(1)).min(1),compiledFromBrainEntryIds:p.array(p.string().min(1)).default([]),compilerPrincipalId:p.string().min(1),compiledAt:p.string().min(1),freshness:ue,evidenceRefIds:p.array(p.string().min(1)).min(1),sourceRefs:p.array(D).default([]),noProviderBinding:p.literal(!0).default(!0),metadata:N.default({})}).strict(),yi=p.object({id:p.string().min(1),compiledArtifactId:p.string().min(1),runbookReadinessId:p.string().min(1),status:Qn,evaluatedAt:p.string().min(1),sourceRecordRefIds:p.array(p.string().min(1)).min(1),identityDecisionIds:p.array(p.string().min(1)).default([]),accessDecisionIds:p.array(p.string().min(1)).min(1),blockedReasons:p.array(p.string().min(1)).default([]),evidenceRefIds:p.array(p.string().min(1)).min(1),metadata:N.default({})}).superRefine((e,n)=>{if(e.status!=="ready"&&e.blockedReasons.length===0)n.addIssue({code:p.ZodIssueCode.custom,message:"Non-ready agentic readiness checks require blocked reasons.",path:["blockedReasons"]});if(e.status==="ready"&&e.blockedReasons.length>0)n.addIssue({code:p.ZodIssueCode.custom,message:"Ready agentic readiness checks must not carry blocked reasons.",path:["blockedReasons"]})}),fi=p.object({id:p.string().min(1),compiledArtifactId:p.string().min(1),readinessCheckId:p.string().min(1),runbookConformanceCaseId:p.string().min(1),status:Xn,assertion:p.string().min(1),checkedAt:p.string().min(1),failureReason:p.string().min(1).optional(),replayRefIds:p.array(p.string().min(1)).default([]),executionReceiptIds:p.array(p.string().min(1)).default([]),evidenceRefIds:p.array(p.string().min(1)).min(1),noRuntimeExecution:p.literal(!0).default(!0),metadata:N.default({})}).superRefine((e,n)=>{if(["fail","blocked"].includes(e.status)&&!e.failureReason)n.addIssue({code:p.ZodIssueCode.custom,message:"Failing or blocked agentic conformance evidence requires a failure reason.",path:["failureReason"]})}),ui=p.object({id:p.string().min(1),compiledArtifactId:p.string().min(1),conformanceEvidenceId:p.string().min(1),correctionKind:p.enum(["source_correction","identity_correction","acl_correction","runbook_correction","outcome_correction"]),status:Zn,summary:p.string().min(1),outcomeReceiptId:p.string().min(1),observedAt:p.string().min(1),sourceEvidenceRefIds:p.array(p.string().min(1)).min(1),evidenceRefIds:p.array(p.string().min(1)).min(1),noProviderMutation:p.literal(!0).default(!0),metadata:N.default({})}).strict();import{z as g}from"zod";var W=g.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/),F=g.string().regex(/^sha256:[a-f0-9]{64}$/),O=g.object({recordRef:g.string().min(1),version:W,schemaRef:g.string().min(1),contentFingerprint:F}).strict().readonly(),Pe=g.object({id:g.string().min(1),version:W,contentFingerprint:F,schemaFingerprint:F}).strict().readonly(),Be=g.object({namespace:g.string().regex(/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/),schemaRef:g.string().min(1),recordRef:g.string().min(1),version:W,contentFingerprint:F}).strict().readonly(),Wn=g.object({targetSchemaRef:g.string().min(1),independentConsumerRefs:g.array(L.strict()).min(2).refine((e)=>new Set(e.map((n)=>`${n.type}:${n.id}`)).size>=2,"two distinct vertical consumers are required"),migrationDecisionRef:L.strict()}).strict().readonly(),Jn=g.object({extensionRef:Be,namespaceOwnerRef:L.strict(),schemaFingerprint:F,compatibilityIntent:g.enum(["additive","backward_compatible","breaking"]),evidenceRequirementRefs:g.array(L.strict()).min(1).readonly(),allowedRefTypes:g.array(g.string().min(1)).min(1).readonly(),sourcePolicyRef:L.strict(),legalReviewRef:L.strict(),lifecycleStatus:g.enum(["active","deprecated","promoted"]),deprecationDecisionRef:L.strict().optional(),replacementNamespace:g.string().min(1).optional(),promotion:Wn.optional(),collisionPolicy:g.literal("reject_incompatible_namespace_or_schema_reuse")}).strict().superRefine((e,n)=>{if(e.lifecycleStatus==="deprecated"&&!e.deprecationDecisionRef)n.addIssue({code:"custom",path:["deprecationDecisionRef"],message:"deprecated extensions require a decision ref"});if(e.lifecycleStatus==="promoted"&&!e.promotion)n.addIssue({code:"custom",path:["promotion"],message:"promoted extensions require approved migration evidence"})}),_i=g.array(Jn).readonly().superRefine((e,n)=>{let t=new Set,s=new Map;for(let[m,I]of e.entries()){let{namespace:y,schemaRef:_}=I.extensionRef;if(t.has(y))n.addIssue({code:"custom",path:[m,"extensionRef","namespace"],message:`namespace collision: ${y}`});t.add(y);let E=s.get(_);if(E&&E!==I.schemaFingerprint)n.addIssue({code:"custom",path:[m,"schemaFingerprint"],message:`incompatible schema reuse: ${_}`});s.set(_,I.schemaFingerprint)}}),et=g.object({identityContextRefs:g.array(O).readonly().default([]),knowledgeAssertionRefs:g.array(O).readonly().default([]),procedureRefs:g.array(O).readonly().default([]),policyRefs:g.array(O).readonly().default([]),hypothesisRefs:g.array(O).readonly().default([]),decisionRefs:g.array(O).readonly().default([]),evidenceRefs:g.array(O).readonly().default([])}).strict().readonly(),vi=g.object({id:g.string().min(1),version:W,recordedAt:g.iso.datetime({offset:!0}),effectiveFrom:g.iso.datetime({offset:!0}).optional(),parentEditionRef:Pe.optional(),baseEditionRef:Pe.optional(),contentFingerprint:F,schemaFingerprint:F,sections:et,graphSnapshotRef:O.optional(),evidenceReceiptRefs:g.array(g.string().min(1)).readonly().default([]),replayRef:g.string().min(1).optional(),reviewDecisionRef:g.string().min(1).optional(),extensionRefs:g.array(Be).readonly().default([])}).strict().readonly(),nt=g.object({id:g.string().min(1),title:g.string().min(1),kind:g.enum(["knowledge","procedure","policy","skill_candidate"]),summary:g.string().min(1),ownerPrincipalId:g.string().min(1),trustLevel:g.enum(["low","medium","high"]),freshness:g.enum(["fresh","stale","unknown"]),sourceRefs:g.array(D).min(1)}),tt=g.object({id:g.string().min(1),summary:g.string().min(1),severity:g.enum(["low","medium","high"]),relatedSourceRefs:g.array(D).default([]),ownerPrincipalId:g.string().min(1)}),hi=g.object({id:g.string().min(1),entries:g.array(nt).default([]),gaps:g.array(tt).default([])});var it=r.enum(["fact","hypothesis","policy","procedure","decision","skill_candidate"]),at=r.enum(["unreviewed","review_required","approved","rejected","superseded"]),Ve=r.object({statement:r.string().min(1),normativeLanguage:r.array(r.string().min(1)).default([]),scope:r.array(r.string().min(1)).default([]),prerequisites:r.array(r.string().min(1)).default([]),orderedSteps:r.array(r.string().min(1)).default([]),expectedOutputs:r.array(r.string().min(1)).default([]),failureBranches:r.array(r.string().min(1)).default([]),exceptions:r.array(r.string().min(1)).default([]),approvalBoundaries:r.array(r.string().min(1)).default([])}).strict(),Ai=r.object({tenantId:r.string().min(1),workspaceId:r.string().min(1),entryId:r.string().min(1),version:r.number().int().positive(),kind:it,title:r.string().min(1),content:Ve,ownerRef:r.string().min(1).optional(),sourceRecordRefs:r.array(O).default([]),evidenceRefIds:r.array(r.string().min(1)).default([]),policyRefIds:r.array(r.string().min(1)).default([]),domain:r.string().min(1),trustLevel:r.enum(["low","medium","high"]),confidence:r.number().min(0).max(1),freshness:r.enum(["fresh","stale","unknown"]),reviewState:at,conflictState:r.enum(["clear","contradictory","resolved"]),risk:r.enum(["low","medium","high","critical"]),recordedAt:r.iso.datetime({offset:!0}),validTime:ie,requiredCapabilities:r.array(r.string().min(1)).default([]),sensitiveFields:r.array(r.string().min(1)).default([]),tombstoneReason:r.enum(["source_deleted","acl_revoked","superseded","privacy_request"]).optional(),fingerprint:d}).strict(),Gi=r.object({tenantId:r.string().min(1),workspaceId:r.string().min(1),decisionId:r.string().min(1),entryId:r.string().min(1),entryVersion:r.number().int().positive(),verdict:r.enum(["approved","rejected"]),reviewerRef:r.string().min(1),decidedAt:r.iso.datetime({offset:!0}),evidenceRefIds:r.array(r.string().min(1)).min(1),reason:r.string().min(1),fingerprint:d}).strict(),Li=r.object({tenantId:r.string().min(1),workspaceId:r.string().min(1),gapId:r.string().min(1),entryRef:r.string().min(1),reason:r.enum(["ownerless","stale","unsupported","low_confidence","contradictory"]),status:r.enum(["open","in_progress","resolved","accepted_unknown"]),ownerRef:r.string().min(1).optional(),evidenceRefIds:r.array(r.string().min(1)).min(1),recordedAt:r.iso.datetime({offset:!0}),fingerprint:d}).strict(),ki=r.object({tenantId:r.string().min(1),workspaceId:r.string().min(1),remediationId:r.string().min(1),gapId:r.string().min(1),status:r.enum(["proposed","accepted","in_progress","completed","cancelled"]),ownerRef:r.string().min(1),workRef:r.string().min(1),evidenceRefIds:r.array(r.string().min(1)).min(1),recordedAt:r.iso.datetime({offset:!0}),fingerprint:d}).strict(),Oi=r.object({artifact:ze,sourceEntryRef:r.string().min(1),accountableOwnerRef:r.string().min(1),policyRefIds:r.array(r.string().min(1)).default([]),content:Ve,conformanceEvidenceRefIds:r.array(r.string().min(1)).min(1),contentFingerprint:d,noActionAuthorization:r.literal(!0),noActionExecution:r.literal(!0)}).strict();var Di=[{surface:"@lssm/lib.companyos-spec/types/company-intelligence",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/validation/company-intelligence",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/fixtures/company-intelligence",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/docs/company-intelligence.docblock",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/types/company-intelligence/grounding-result",kind:"schema",intent:"additive"},{surface:"@lssm/lib.companyos-spec/validation/company-intelligence-grounding",kind:"export",intent:"additive"},{surface:"@lssm/lib.companyos-spec/fixtures/company-intelligence/grounding-result",kind:"export",intent:"additive"},{surface:"companyIntelligence.feedback.signal@1.0.0",kind:"schema",intent:"additive"},{surface:"companyIntelligence.governedLearning.transition@1.0.0",kind:"schema",intent:"additive"},{surface:"@lssm/lib.companyos-spec/validation/company-intelligence#validateCompanyIntelligenceGovernedLearningHistory",kind:"export",intent:"additive"},{surface:"companyIntelligence.extraction.candidate@1.0.0",kind:"schema",intent:"additive"},{surface:"@lssm/lib.contracts-spec/companyos/company-intelligence",kind:"export",intent:"additive"},...["companyIntelligence.brain.entry.create","companyIntelligence.brain.entry.version.append","companyIntelligence.brain.entry.review","companyIntelligence.brain.edition.create","companyIntelligence.brain.edition.compare","companyIntelligence.brain.gap.remediate","companyIntelligence.brain.artifact.compile","companyIntelligence.record.validate","companyIntelligence.graph.query","companyIntelligence.answer.query","companyIntelligence.feedback.record","companyIntelligence.experiment.evaluate","companyIntelligence.promotion.decide","companyIntelligence.rollback.execute","companyIntelligence.replay.get"].map((e)=>({surface:e,kind:"operation",intent:"additive"})),...["companyIntelligence.brain.entry.versioned","companyIntelligence.brain.entry.reviewed","companyIntelligence.brain.edition.created","companyIntelligence.brain.gap.recorded","companyIntelligence.brain.remediation.recorded","companyIntelligence.brain.artifact.compiled","companyIntelligence.record.committed","companyIntelligence.answer.verified","companyIntelligence.feedback.recorded","companyIntelligence.promotion.decided","companyIntelligence.rollback.completed"].map((e)=>({surface:e,kind:"event",intent:"additive"}))];import{z as u}from"zod";var Me="companyos.company-intelligence-extraction-candidate",qe="1.0.0",zi=u.enum(["fact","entity","relation","policy","procedure"]),rt=u.object({evidenceRecordId:u.string().min(1),locator:T}).strict(),M=u.object({candidateKey:u.string().min(1),evidenceRefs:u.array(rt).min(1),confidence:u.number().min(0).max(1),risk:u.enum(["low","medium","high","critical"])}),ot=u.discriminatedUnion("kind",[M.extend({kind:u.literal("fact"),statement:u.string().min(1)}).strict(),M.extend({kind:u.literal("entity"),entityType:u.string().min(1),label:u.string().min(1)}).strict(),M.extend({kind:u.literal("relation"),fromCandidateKey:u.string().min(1),toCandidateKey:u.string().min(1),predicate:u.string().min(1)}).strict(),M.extend({kind:u.literal("policy"),normativeStatement:u.string().min(1),scopeRefIds:u.array(u.string().min(1)).min(1)}).strict(),M.extend({kind:u.literal("procedure"),statement:u.string().min(1)}).strict()]),Pi=u.object({schemaId:u.literal(Me),schemaVersion:u.literal(qe),candidates:u.array(ot).min(1)}).strict().refine(({candidates:e})=>new Set(e.map(({candidateKey:n})=>n)).size===e.length,{message:"Candidate keys must be unique.",path:["candidates"]}),Bi=u.object({decisionRef:u.string().min(1),reviewerRef:u.string().min(1),candidateKeys:u.array(u.string().min(1)).min(1),verdict:u.enum(["approved","rejected"]),decidedAt:u.iso.datetime({offset:!0})}).strict(),Vi=u.object({receiptId:u.string().min(1),tenantId:u.string().min(1),attemptId:u.string().min(1),modelRef:u.string().min(1),promptFingerprint:d,candidateSchema:u.object({id:u.literal(Me),version:u.literal(qe),fingerprint:d}).strict(),runtimeVersion:u.string().min(1),costMicros:u.number().int().nonnegative(),redactionDecisionRef:u.string().min(1),evidenceRefIds:u.array(u.string().min(1)),dispositions:u.array(u.object({candidateKey:u.string().min(1),status:u.enum(["accepted","rejected","review_required"]),reason:u.string().min(1),recordId:u.string().min(1).optional()}).strict()),version:u.number().int().positive(),supersedesReceiptId:u.string().min(1).optional(),fingerprint:d}).strict();import{z as i}from"zod";var ct=i.enum(["authorization_denied","scope_mismatch","policy_refused","no_authorized_evidence","retrieval_degraded","conflicting_authorized_evidence","stale_authorized_evidence","verifier_not_independent","drafting_degraded","draft_schema_invalid","verification_degraded","insufficient_claim_support","deadline_exceeded","budget_exceeded","fixture_adapter_forbidden","supported"]),U=i.array(i.string().min(1)).refine((e)=>new Set(e).size===e.length,{message:"Values must be unique."}),st=i.object({tenantId:i.string().min(1),workspaceId:i.string().min(1),actorRef:i.string().min(1),viewerRef:i.string().min(1),capabilityRefs:U,authorizationDecisionRef:i.string().min(1),policyDecisionRef:i.string().min(1).optional()}).strict(),dt=i.object({questionBytes:i.number().int().positive().max(4096),filterEntries:i.number().int().nonnegative().max(20),channelCount:i.number().int().positive().max(3),perChannelTopK:i.number().int().positive().max(32),mergedEvidenceRecords:i.number().int().positive().max(16),excerptBytesPerEvidence:i.number().int().positive().max(2048),totalModelEvidenceBytes:i.number().int().positive().max(16384),maxClaims:i.number().int().positive().max(8),maxClaimStatementBytes:i.number().int().positive().max(512),maxCitationsPerClaim:i.number().int().positive().max(4),maxDraftAttempts:i.literal(2),maxVerificationAttempts:i.literal(2),maxRetrievalCalls:i.literal(3),runDeadlineMs:i.number().int().positive().max(12000)}).strict(),$e=i.object({claimId:i.string().regex(/^clm_sha256:[a-f0-9]{64}$/),statement:i.string().min(1)}).strict(),Ke=i.object({citationId:i.string().regex(/^cit_sha256:[a-f0-9]{64}$/),evidenceRefId:i.string().min(1),tenantId:i.string().min(1),workspaceId:i.string().min(1),viewerRef:i.string().min(1),locator:T,excerpt:i.string().min(1),sourceContentFingerprint:d,viewerProjectionFingerprint:d,redactionDecisionRef:i.string().min(1),fusedScoreMicros:i.number().int().nonnegative()}).strict(),Ye=i.object({claimId:i.string().regex(/^clm_sha256:[a-f0-9]{64}$/),citationIds:i.array(i.string().regex(/^cit_sha256:[a-f0-9]{64}$/)).min(1).max(4),verdict:i.literal("supported"),confidence:i.number().min(0).max(1)}).strict(),Ue=i.object({providerRef:i.string().min(1),modelRef:i.string().min(1),promptOrRuleVersion:i.string().min(1),independenceDomain:i.string().min(1),provenance:i.enum(["runtime","fixture"])}).strict(),lt=i.object({request:d,retrieval:d.optional(),draft:d.optional(),validation:d.optional(),verification:d.optional(),output:d,replay:d}).strict(),pt=i.object({drafterIdentity:Ue.optional(),verifierIdentity:Ue.optional(),retrievedCitationLedger:U,callCounts:i.object({retrieval:i.number().int().nonnegative().max(3),draft:i.number().int().nonnegative().max(2),verify:i.number().int().nonnegative().max(2)}).strict(),repairCount:i.number().int().nonnegative().max(1),warnings:U,fingerprints:lt}).strict(),mt=i.object({schemaVersion:i.literal("company-intelligence-grounded-answer:v1"),codeVersionRef:i.string().min(1),retrievalConfigRef:i.string().min(1),recordedAt:i.iso.datetime({offset:!0}),modelVisibleEvidenceBytes:i.number().int().nonnegative().max(16384),supportThreshold:i.number().min(0).max(1)}).strict(),q=i.object({schemaVersion:i.literal("company-intelligence-grounded-answer:v1"),scope:st,status:ae,reasonCodes:i.array(ct).min(1),text:i.string().min(1).optional(),claims:i.array($e),citations:i.array(Ke),claimSupport:i.array(Ye),conflictRefIds:U,receipt:pt,metadata:mt,bounds:dt,knowledgeAuthorizesAction:i.literal(!1)}).strict(),J={text:i.undefined().optional(),claims:i.array(i.never()).max(0),citations:i.array(i.never()).max(0),claimSupport:i.array(i.never()).max(0)},Ki=i.discriminatedUnion("status",[q.extend({status:i.literal("answered"),text:i.string().min(1),claims:i.array($e).min(1).max(8),citations:i.array(Ke).min(1),claimSupport:i.array(Ye).min(1),conflictRefIds:i.array(i.never()).max(0)}),q.extend({status:i.literal("abstained"),...J}),q.extend({status:i.literal("refused"),...J}),q.extend({status:i.literal("conflicted"),...J,conflictRefIds:U.pipe(i.array(i.string()).min(1))}),q.extend({status:i.literal("degraded"),...J})]);var gt=B.discriminatedUnion("kind",[...fe,...se,...Re,...ye]),yt=[...fe,...se,re,oe,ce,...ye].map((e)=>e.omit({fingerprint:!0})),ea=B.union(yt),na=B.object({contractVersion:B.literal(te),tenantId:B.string().min(1),records:B.array(gt).min(1)}).strict();function v(e,n,t,s){e.push({code:n,path:t,message:s})}function He(e,n){let t=e.flatMap((y)=>y.kind==="evaluation"&&y.payload.phase?[y.payload.phase]:[]),s=["offline","holdout","adversarial","shadow"];for(let[y,_]of s.entries())if(t[y]!==void 0&&t[y]!==_)v(n,"CI_LEARNING_TRANSITION_INVALID",`records.phases.${y}`,"Evaluation phases cannot be skipped or reordered.");let m=t.indexOf("canary_compare");if(m>=0&&m!==4)v(n,"CI_LEARNING_TRANSITION_INVALID","records.phases.canary_compare","Canary comparison requires all four prior phases.");if(t.filter((y)=>y==="post_promotion").length>A.maxMonitoringComparisons)v(n,"CI_LEARNING_CAP_EXCEEDED","records.phases.post_promotion","Post-promotion comparison cap exceeded.")}function Qe(e,n,t){if(!e.payload.governedLearning)return;if(!e.payload.phase||!e.payload.sampleReceipt||!e.payload.typedMetrics?.length||!e.payload.typedGuardrails?.length||!e.payload.generatorIdentity||!e.payload.evaluatorIdentity||!e.payload.independenceReceipt||!e.payload.testsReceipt||!e.payload.costEvidence)v(t,"CI_LEARNING_HISTORY_INCOMPLETE",`${n}.payload`,"Governed evaluation requires phase, sample, typed metrics and guardrails, identities, independence, tests, and cost evidence.")}function Xe(e,n,t,s,m){if(t.kind!=="experiment"||!t.payload.egressDecision)return;let I=t.payload.egressDecision;if(!(I.vendorExportAllowed||I.vendorLearningAllowed))return;let _=e.find((G)=>G.kind==="feedback"&&G.payload.feedbackType==="signal"),E=e.find((G)=>G.kind==="evaluation"&&G.payload.sampleReceipt),w=t.payload.candidate,Y=w?.type==="runtime_artifact"?w.artifact.fingerprint:w?.fingerprint,P=new Set(e.slice(0,n).map(({fingerprint:G})=>G.value));if(I.vendorExportAllowed&&!I.vendorExportRequested||I.vendorLearningAllowed&&!I.vendorLearningRequested||!I.binding||I.binding.signalFingerprint!==(_?.kind==="feedback"&&_.payload.feedbackType==="signal"?_.payload.signalFingerprint:void 0)||I.binding.sampleFingerprint!==(E?.kind==="evaluation"?E.payload.sampleReceipt?.fingerprint:void 0)||I.binding.artifactFingerprint!==Y||I.receiptFingerprints.some((G)=>!P.has(G)))v(m,"CI_LEARNING_TRANSITION_INVALID",`${s}.payload.egressDecision`,"Vendor eligibility requires five prior receipts bound to one signal, sample, and artifact.")}var ft={G01:"candidate_proposed",G02:"candidate_proposed",G03:"candidate_proposed",G04:"candidate_proposed",G05:"candidate_proposed",G06:"candidate_proposed",G07:"offline_evaluated",G08:"offline_evaluated",G09:"offline_evaluated",G10:"offline_evaluated",G11:"offline_evaluated",G12:"offline_evaluated",G13:"offline_evaluated",G14:"offline_evaluated",G15:"holdout_evaluated",G16:"adversarial_evaluated",G17:"adversarial_evaluated",G18:"risk_policy_decided",G19:"approval_recorded",G20:"approval_recorded",G21:"approval_recorded",G22:"approval_recorded",G23:"shadow_evaluated",G24:"canary_started",G25:"comparison_recorded"};function We(e,n,t){let s=ft[n];return e.findLast((m)=>("governedLearning"in m.payload)&&m.payload.governedLearning?.lifecycleId===t&&m.payload.governedLearning.event===s)}function Je(e,n){let t=Date.parse(n)-Date.parse(e.recordedAt);return Number.isFinite(t)&&t>=0&&t<=A.maxGateAgeMs}function en(e,n,t){let s="governedLearning"in t.payload?t.payload.governedLearning:void 0;if(s?.event!=="review_due"&&s?.event!=="expired")return!0;let m=e.slice(0,n).findLast((y)=>y.kind==="promotion"&&y.payload.stage==="promoted"&&y.payload.governedLearning?.lifecycleId===s.lifecycleId);if(!m)return!1;let I=s.event==="review_due"?A.maxReviewIntervalMs:A.maxPromotionExpiryMs;return Date.parse(t.recordedAt)===Date.parse(m.recordedAt)+I}function nn(e,n){let t=ee(n,"candidate_proposed","experiment"),s=ee(n,"risk_policy_decided","experiment"),m=K(n,"offline"),I=K(n,"holdout"),y=K(n,"adversarial"),_=K(n,"shadow"),E=ee(n,"approval_recorded","promotion"),w=ee(n,"canary_started","promotion"),Y=K(n,"canary_compare"),P=t?.payload.candidate,G=P?.type==="runtime_artifact";return{G01:!!t?.payload.baseline,G02:!!t?.payload.baseline?.semanticVersion,G03:!!t?.payload.objectiveDefinition,G04:!!P,G05:G&&!!P.artifact.semanticVersion,G06:G&&P.artifact.artifactRef===t?.payload.candidateArtifactRef,G07:Ze(m?.payload.typedMetrics),G08:Ze(m?.payload.typedGuardrails)&&m.payload.typedGuardrails.every(({hard:ne})=>ne),G09:!!m?.payload.sampleReceipt,G10:m?.payload.verdict==="pass"&&m.payload.testsReceipt?.status==="allow"&&!!m.payload.testsReceipt.suiteVersion,G11:m?.payload.safetyPassed===!0,G12:m?.payload.privacyPassed===!0,G13:m?.payload.costPassed===!0&&m.payload.costEvidence?.tenantBudgetAllowed===!0&&m.payload.costEvidence.ratio<=1.2,G14:m?.payload.verdict==="pass",G15:I?.payload.verdict==="pass"&&I.payload.datasetRef!==m?.payload.datasetRef,G16:y?.payload.verdict==="pass",G17:ut(y),G18:s?.payload.riskDecision?.status==="allow",G19:E?.payload.approvalReceipt?.status==="allow",G20:It(E,y),G21:!!t?.payload.baseline&&E?.payload.rollbackTestReceipt?.status==="allow"&&E.payload.rollbackTestReceipt.expectedBaselineFingerprint===t.payload.baseline.fingerprint&&E.payload.rollbackTestReceipt.observedRestoredFingerprint===t.payload.baseline.fingerprint,G22:E?.payload.killSwitchReceipt?.status==="allow"&&E.payload.killSwitchReceipt.receiptRef===E.payload.killSwitchRef,G23:_?.payload.verdict==="pass",G24:w?.payload.stage==="canary",G25:Y?.payload.verdict==="pass"&&Y.payload.typedGuardrails?.every(({passed:ne})=>ne)===!0}[e]}var Ze=(e)=>!!e&&e.length>0&&e.length<=16,ee=(e,n,t)=>e.find((s)=>s.kind===t&&("governedLearning"in s.payload)&&s.payload.governedLearning?.event===n),K=(e,n)=>e.find((t)=>t.kind==="evaluation"&&t.payload.phase===n),ut=(e)=>!!e?.payload.generatorIdentity&&!!e.payload.evaluatorIdentity&&!!e.payload.independenceReceipt&&e.payload.independenceReceipt.status==="allow"&&e.payload.generatorIdentity.principalRef!==e.payload.evaluatorIdentity.principalRef&&e.payload.generatorIdentity.implementationFingerprint!==e.payload.evaluatorIdentity.implementationFingerprint&&e.payload.generatorIdentity.modelFingerprint!==e.payload.evaluatorIdentity.modelFingerprint&&e.payload.generatorIdentity.signerRef!==e.payload.evaluatorIdentity.signerRef,It=(e,n)=>!!e?.payload.approvalReceipt?.signerRef&&!!n?.payload.generatorIdentity&&!!n.payload.evaluatorIdentity&&![n.payload.generatorIdentity.signerRef,n.payload.evaluatorIdentity.signerRef,n.payload.generatorIdentity.principalRef,n.payload.evaluatorIdentity.principalRef].includes(e.payload.approvalReceipt.signerRef);function tn(e,n,t,s,m,I){if(Rt(t,m,I),Xe(e,n,t,m,I),!en(e,n,t))v(I,"CI_LEARNING_TRANSITION_INVALID",`${m}.recordedAt`,"Governed review and expiry must equal their promotion-derived deadline.");if(t.kind==="evaluation")Qe(t,m,I);if(t.kind==="evaluation"&&t.payload.phase){let y=t.payload.phase==="canary_compare"||t.payload.phase==="post_promotion"?"comparison":t.payload.phase;if(!s.event.startsWith(y))v(I,"CI_LEARNING_TRANSITION_INVALID",`${m}.payload.phase`,"Evaluation phase and event disagree.")}if(t.kind==="evaluation"&&t.payload.generatorIdentity&&t.payload.evaluatorIdentity){let y=t.payload.generatorIdentity,_=t.payload.evaluatorIdentity;if(y.principalRef===_.principalRef||y.implementationFingerprint===_.implementationFingerprint||y.modelFingerprint===_.modelFingerprint||y.signerRef===_.signerRef)v(I,"CI_LEARNING_TRANSITION_INVALID",`${m}.payload.evaluatorIdentity`,"Generator and evaluator must be independently identified.")}if(t.kind==="promotion"&&t.payload.gateBundle){let y=t.payload.stage==="canary"?23:t.payload.stage==="promoted"?25:0;if(y>0)Ct(t.payload.gateBundle.gates,y,m,I);let _=e.slice(0,n);if(t.payload.gateBundle.gates.some((E)=>{let w=We(_,E.id,s.lifecycleId);return!w||E.receiptFingerprint!==w.fingerprint.value||!Je(w,t.recordedAt)||!nn(E.id,_)}))v(I,"CI_LEARNING_HISTORY_INCOMPLETE",`${m}.payload.gateBundle.gates`,"Every gate must cite the exact lifecycle-scoped record that proves its concrete fact.");if((t.payload.stage==="canary"||t.payload.stage==="promoted")&&t.payload.approvalReceipt?.status!=="allow")v(I,"CI_LEARNING_HISTORY_INCOMPLETE",`${m}.payload.approvalReceipt`,"Governed canary and promotion require a concrete approval allow receipt.");if(t.payload.approvalReceipt&&Date.parse(t.payload.approvalReceipt.decidedAt)+A.maxApprovalValidityMs<Date.parse(t.recordedAt))v(I,"CI_LEARNING_TRANSITION_INVALID",`${m}.payload.approvalReceipt`,"Approval receipt expired before use.")}if(t.kind==="promotion"&&(t.payload.stage==="canary"||t.payload.stage==="promoted")){let y=e.find((_)=>_.kind==="experiment"&&_.payload.governedLearning?.event==="candidate_proposed");if(y?.kind!=="experiment"||y.payload.candidate?.type!=="runtime_artifact")v(I,"CI_LEARNING_TRANSITION_INVALID",`${m}.payload.candidateArtifactRef`,"Repository work items cannot enter canary or promotion.")}if(t.kind==="rollback"&&t.payload.status==="executed"){let y=t.payload.reproduction;if(!y||y.expectedBaselineFingerprint!==y.observedActiveFingerprint)v(I,"CI_LEARNING_REPLAY_DRIFT",`${m}.payload.reproduction`,"Executed rollback must reproduce the exact baseline.")}if(t.kind==="replay"&&t.payload.status==="exact"&&(!t.payload.lifecycleHeadFingerprint||!t.payload.baselineFingerprint||!t.payload.effectiveArtifactFingerprint||t.payload.orderedTransitionFingerprints?.length!==s.sequence))v(I,"CI_LEARNING_REPLAY_DRIFT",`${m}.payload`,"Exact replay requires complete ordered fingerprints.")}function Rt(e,n,t){if(e.recordRefIds.length>A.maxRecordRefs||e.evidenceRefIds.length>A.maxEvidenceRefs||new TextEncoder().encode(JSON.stringify(e.payload)).length>A.maxSerializedBytes)v(t,"CI_LEARNING_CAP_EXCEEDED",n,"Governed record exceeds a frozen v1 cap.");if(e.kind==="evaluation"&&e.payload.sampleReceipt){let s=e.payload.sampleReceipt,m=Object.values(s.strataCounts).reduce((y,_)=>y+_,0),I=Object.values(s.languageCounts).reduce((y,_)=>y+_,0);if(m!==s.observationCount||I!==s.observationCount)v(t,"CI_LEARNING_TRANSITION_INVALID",`${n}.payload.sampleReceipt`,"Sample strata and language counts must each cover the exact observation count.")}}function Ct(e,n,t,s){let m=de.slice(0,n);if(e.length!==n||e.some((I,y)=>I.id!==m[y]||I.status!=="passed"||!I.receiptFingerprint))v(s,"CI_LEARNING_HISTORY_INCOMPLETE",`${t}.payload.gateBundle.gates`,n===23?"Canary requires G01-G23 green.":"Promotion requires G01-G25 green.")}function an(e,n,t){if(e.kind!=="feedback"||e.payload.feedbackType==="signal"||n.kind!=="feedback"||n.payload.feedbackType!=="signal")return!1;let s=e.payload.dispositionEvidence,m=n.payload.dispositionRefs;if(!s)return!1;return s.duplicate===!1&&s.signalFingerprint===n.payload.signalFingerprint&&s.originRefId===n.payload.originRefId&&s.consentReceipt.receiptRef===m.consentReceiptRef&&s.consentReceipt.receiptRef===e.payload.consentDecisionRef&&s.consentReceipt.purpose==="governed_learning"&&s.consentReceipt.scopeRefId===n.payload.consentScopeRefId&&s.consentReceipt.scopeRefId===t&&s.consentReceipt.signalFingerprint===n.payload.signalFingerprint&&s.redactionReceipt.receiptRef===m.redactionReceiptRef&&s.redactionReceipt.receiptRef===e.payload.redactionDecisionRef&&s.redactionReceipt.targetRefId===n.payload.originRefId&&s.authorityReceipt.receiptRef===m.authorityReceiptRef&&s.authorityReceipt.tenantId===n.tenantId&&s.authorityReceipt.tenantId===e.tenantId&&s.authorityReceipt.objectiveRefId===n.payload.objectiveRefId&&s.authorityReceipt.actorRef===n.payload.actorRef&&s.authorityReceipt.actorRef===e.payload.actorRef&&s.originIntegrityReceipt.receiptRef===m.originIntegrityReceiptRef&&s.originIntegrityReceipt.originRefId===n.payload.originRefId&&s.originIntegrityReceipt.classification===n.payload.originClassification&&s.originIntegrityReceipt.signalFingerprint===n.payload.signalFingerprint}var _t={signal_captured:"feedback",consent_redaction_recorded:"feedback",classified:"experiment",baseline_objective_recorded:"experiment",candidate_proposed:"experiment",risk_policy_decided:"experiment",offline_evaluated:"evaluation",holdout_evaluated:"evaluation",adversarial_evaluated:"evaluation",shadow_evaluated:"evaluation",approval_recorded:"promotion",canary_started:"promotion",comparison_recorded:"evaluation",promotion_decided:"promotion",rollback_executed:"rollback",outcome_recorded:"feedback",review_due:"experiment",expired:"experiment",replay_verified:"replay"},vt=new Set(["signal_captured:null:signal_pending","consent_redaction_recorded:signal_pending:feedback_accepted","classified:feedback_accepted:classified","baseline_objective_recorded:classified:candidate_pending","candidate_proposed:candidate_pending:candidate_pending","risk_policy_decided:candidate_pending:evaluating","risk_policy_decided:candidate_pending:rejected","offline_evaluated:evaluating:evaluating","holdout_evaluated:evaluating:evaluating","adversarial_evaluated:evaluating:evaluating","adversarial_evaluated:evaluating:rejected","shadow_evaluated:evaluating:shadow","shadow_evaluated:evaluating:rejected","approval_recorded:shadow:awaiting_approval","canary_started:awaiting_approval:canary","comparison_recorded:canary:canary","comparison_recorded:canary:rejected","promotion_decided:canary:promoted","promotion_decided:canary:rejected","comparison_recorded:promoted:promoted","comparison_recorded:promoted:rejected","rollback_executed:rejected:rolled_back","rollback_executed:promoted:rolled_back","rollback_executed:review_due:rolled_back","outcome_recorded:promoted:outcome_recorded","outcome_recorded:rejected:outcome_recorded","outcome_recorded:rolled_back:outcome_recorded","review_due:outcome_recorded:review_due","expired:review_due:expired","replay_verified:expired:replay_exact","replay_verified:expired:replay_drifted","replay_verified:expired:blocked"]);function z(e){if(!("governedLearning"in e.payload))return;return e.payload.governedLearning}function rn(e,n,t,s){return e.tenantId===n.tenantId&&t.lifecycleId===s.lifecycleId&&e.ownerRef.id===n.ownerRef.id&&e.ownerRef.type===n.ownerRef.type&&e.ownerRef.label===n.ownerRef.label&&e.contractVersion===n.contractVersion&&e.fingerprint.version===n.fingerprint.version&&e.fingerprint.canonicalization===n.fingerprint.canonicalization}function on(e,n,t,s){if(n.occurredAt!==e.recordedAt)v(s,"CI_LEARNING_FINGERPRINT_MISMATCH",`${t}.recordedAt`,"Recorded and governed occurrence time must match.");if(e.kind!==_t[n.event])v(s,"CI_LEARNING_TRANSITION_INVALID",`${t}.kind`,"Event is stored in the wrong canonical record kind.");if(n.event==="signal_captured"&&(e.kind!=="feedback"||e.payload.feedbackType!=="signal"||e.payload.status!=="quarantined"))v(s,"CI_LEARNING_TRANSITION_INVALID",`${t}.payload.status`,"Only a zero-weight quarantined signal may await consent and redaction.");if(n.event==="consent_redaction_recorded"&&(e.kind!=="feedback"||e.payload.feedbackType==="signal"||e.payload.status!=="accepted"))v(s,"CI_LEARNING_TRANSITION_INVALID",`${t}.payload.status`,"Learning requires accepted feedback with consent and redaction refs.");let m=`${n.event}:${n.stateBefore??"null"}:${n.stateAfter}`;if(!vt.has(m))v(s,"CI_LEARNING_TRANSITION_INVALID",`${t}.payload.governedLearning`,`Illegal governed transition ${m}.`)}function cn(e,n,t,s,m){if(n===0){if(s.event!=="signal_captured"||s.stateBefore!==null||s.previousTransitionRecordRefId||s.previousStateFingerprint)v(m,"CI_LEARNING_HISTORY_INCOMPLETE","records.0","Sequence zero must be an unlinked signal capture.");return}let I=e[n-1],y=z(I);if(s.event==="consent_redaction_recorded"&&!an(t,I,s.lifecycleId))v(m,"CI_LEARNING_HISTORY_INCOMPLETE",`records.${n}.payload.dispositionEvidence`,"Accepted governed feedback requires exact allow disposition evidence.");if(!y||s.previousTransitionRecordRefId!==I.id||s.previousStateFingerprint!==y.stateFingerprint||s.stateBefore!==y.stateAfter||!t.recordRefIds.includes(I.id))v(m,"CI_LEARNING_HEAD_CONFLICT",`records.${n}`,"Transition does not extend the exact previous head.")}function Ta(e){let n=e.filter((I)=>z(I)!==void 0).sort((I,y)=>(z(I)?.sequence??0)-(z(y)?.sequence??0)),t=[];if(n.length===0)return{ok:!0,issues:t};if(n.length>A.maxTransitions)v(t,"CI_LEARNING_CAP_EXCEEDED","records","Lifecycle transition cap exceeded.");let s=n[0],m=z(s);if(!m)return{ok:!0,issues:t};for(let[I,y]of n.entries()){let _=z(y);if(!_)continue;let E=`records.${I}`;if(!rn(y,s,_,m))v(t,"CI_LEARNING_TENANT_MISMATCH",E,"Governed history must share exact tenant, lifecycle, owner, and contract identity.");if(_.sequence!==I)v(t,"CI_LEARNING_SEQUENCE_CONFLICT",`${E}.payload.governedLearning.sequence`,"Sequences must be contiguous from zero.");on(y,_,E,t),cn(n,I,y,_,t),tn(n,I,y,_,E,t)}return He(n,t),{ok:t.length===0,issues:t}}export{v as addLearningIssue,Ta as validateCompanyIntelligenceGovernedLearningHistory};

package/dist/validation/company-intelligence-record-semantics.d.ts

@@ -0,0 +1,3 @@
+import type { CompanyIntelligenceRecord } from '../types/company-intelligence/index.js';
+import type { CompanyIntelligenceValidationIssue } from './company-intelligence-semantics.js';
+export declare function validateCompanyIntelligenceRecordSemantics(record: CompanyIntelligenceRecord, index: number, issues: CompanyIntelligenceValidationIssue[]): void;

package/dist/validation/company-intelligence-record-semantics.js

@@ -0,0 +1,2 @@
+// @bun
+function I(e,a,t){if((e.kind==="claim"||e.kind==="entity"||e.kind==="relation")&&e.payload.confidence<0.9&&e.payload.reviewState!=="review_required")i(t,"CI_REVIEW_REQUIRED",a,e,"Low-confidence semantic candidates require review.");if(e.kind==="answer")p(e,a,t);if(e.kind==="feedback"){let n=e.payload.feedbackType==="correction"&&!e.payload.correctionRefId,s=e.payload.feedbackType==="outcome"&&!e.payload.outcomeRefId;if(n||s)i(t,"CI_FEEDBACK_SEMANTICS_INVALID",a,e,"Feedback must reference its correction or outcome.")}if(e.kind==="evaluation"&&e.payload.verdict==="pass"&&(!e.payload.safetyPassed||!e.payload.privacyPassed||!e.payload.costPassed))i(t,"CI_EVALUATION_GATES_FAILED",a,e,"Passing evaluation requires safety, privacy, and cost gates.");if(e.kind==="promotion"&&e.payload.stage==="promoted"&&!e.payload.approvedAt)i(t,"CI_PROMOTION_GATES_REQUIRED",a,e,"Promoted records require approval time and gate refs.");if(e.kind==="rollback"&&e.payload.status==="executed"&&!e.payload.executedAt)i(t,"CI_ROLLBACK_TIME_REQUIRED",a,e,"Executed rollback requires execution time.");if(e.kind==="replay"&&new Set(e.payload.orderedEventRefIds).size!==e.payload.orderedEventRefIds.length)i(t,"CI_REPLAY_ORDER_INVALID",a,e,"Replay event order cannot contain duplicates.")}function p(e,a,t){let{payload:n}=e,s=n.status==="answered"&&(!n.text||n.claimRefIds.length===0||n.citationEvidenceRefIds.length===0||!n.verificationRefId),o=(n.status==="abstained"||n.status==="refused")&&(n.claimRefIds.length>0||n.citationEvidenceRefIds.length>0),l=n.status==="conflicted"&&n.conflictRefIds.length===0,c=n.status!=="answered"&&n.reasons.length===0,d=n.status==="refused"&&!n.policyDecisionRef;if(s||o||l||c||d)i(t,"CI_ANSWER_SEMANTICS_INVALID",a,e,"Answer status, support, policy, and reason fields are inconsistent.")}function i(e,a,t,n,s){e.push({code:a,path:`records.${t}.${n.kind}`,message:s})}export{I as validateCompanyIntelligenceRecordSemantics};

package/dist/validation/company-intelligence-semantics.d.ts

@@ -0,0 +1,13 @@
+import type { CompanyIntelligenceRecordPacket } from '../types/company-intelligence/index.js';
+import type { CompanyIntelligenceLearningErrorCode } from './company-intelligence-learning-issues.js';
+export type CompanyIntelligenceValidationCode = CompanyIntelligenceLearningErrorCode | 'CI_SCHEMA_INVALID' | 'CI_TENANT_REQUIRED' | 'CI_OWNER_REQUIRED' | 'CI_TIME_REQUIRED' | 'CI_VALID_TIME_INVALID' | 'CI_DUPLICATE_ID' | 'CI_TENANT_MISMATCH' | 'CI_REFERENCE_NOT_FOUND' | 'CI_EVIDENCE_REQUIRED' | 'CI_EVIDENCE_NOT_FOUND' | 'CI_EVIDENCE_KIND_INVALID' | 'CI_REVIEW_REQUIRED' | 'CI_ANSWER_SEMANTICS_INVALID' | 'CI_FEEDBACK_SEMANTICS_INVALID' | 'CI_EVALUATION_GATES_FAILED' | 'CI_PROMOTION_GATES_REQUIRED' | 'CI_ROLLBACK_TIME_REQUIRED' | 'CI_REPLAY_ORDER_INVALID' | 'CI_FINGERPRINT_MISMATCH';
+export interface CompanyIntelligenceValidationIssue {
+    readonly code: CompanyIntelligenceValidationCode;
+    readonly path: string;
+    readonly message: string;
+}
+export interface CompanyIntelligenceValidationResult {
+    readonly ok: boolean;
+    readonly issues: readonly CompanyIntelligenceValidationIssue[];
+}
+export declare function validateCompanyIntelligenceSemanticInvariants(packet: CompanyIntelligenceRecordPacket): CompanyIntelligenceValidationIssue[];

package/dist/validation/company-intelligence-semantics.js

@@ -0,0 +1,2 @@
+// @bun
+function d(e,i,t){if((e.kind==="claim"||e.kind==="entity"||e.kind==="relation")&&e.payload.confidence<0.9&&e.payload.reviewState!=="review_required")l(t,"CI_REVIEW_REQUIRED",i,e,"Low-confidence semantic candidates require review.");if(e.kind==="answer")p(e,i,t);if(e.kind==="feedback"){let n=e.payload.feedbackType==="correction"&&!e.payload.correctionRefId,a=e.payload.feedbackType==="outcome"&&!e.payload.outcomeRefId;if(n||a)l(t,"CI_FEEDBACK_SEMANTICS_INVALID",i,e,"Feedback must reference its correction or outcome.")}if(e.kind==="evaluation"&&e.payload.verdict==="pass"&&(!e.payload.safetyPassed||!e.payload.privacyPassed||!e.payload.costPassed))l(t,"CI_EVALUATION_GATES_FAILED",i,e,"Passing evaluation requires safety, privacy, and cost gates.");if(e.kind==="promotion"&&e.payload.stage==="promoted"&&!e.payload.approvedAt)l(t,"CI_PROMOTION_GATES_REQUIRED",i,e,"Promoted records require approval time and gate refs.");if(e.kind==="rollback"&&e.payload.status==="executed"&&!e.payload.executedAt)l(t,"CI_ROLLBACK_TIME_REQUIRED",i,e,"Executed rollback requires execution time.");if(e.kind==="replay"&&new Set(e.payload.orderedEventRefIds).size!==e.payload.orderedEventRefIds.length)l(t,"CI_REPLAY_ORDER_INVALID",i,e,"Replay event order cannot contain duplicates.")}function p(e,i,t){let{payload:n}=e,a=n.status==="answered"&&(!n.text||n.claimRefIds.length===0||n.citationEvidenceRefIds.length===0||!n.verificationRefId),o=(n.status==="abstained"||n.status==="refused")&&(n.claimRefIds.length>0||n.citationEvidenceRefIds.length>0),s=n.status==="conflicted"&&n.conflictRefIds.length===0,c=n.status!=="answered"&&n.reasons.length===0,r=n.status==="refused"&&!n.policyDecisionRef;if(a||o||s||c||r)l(t,"CI_ANSWER_SEMANTICS_INVALID",i,e,"Answer status, support, policy, and reason fields are inconsistent.")}function l(e,i,t,n,a){e.push({code:i,path:`records.${t}.${n.kind}`,message:a})}var E=new Set(["claim","policy","entity","relation","conflict","gap","graph","edition","answer","verification","feedback","experiment","evaluation","promotion","rollback","replay"]);function y(e){let i=[],t=new Map;for(let[n,a]of e.records.entries()){if(t.has(a.id))I(i,"CI_DUPLICATE_ID",n,a,"Record ids must be unique.");if(t.set(a.id,a),a.tenantId!==e.tenantId)I(i,"CI_TENANT_MISMATCH",n,a,"Record tenant must match packet tenant.");if(a.validTime.to&&Date.parse(a.validTime.to)<=Date.parse(a.validTime.from))I(i,"CI_VALID_TIME_INVALID",n,a,"Valid-to must be later than valid-from.");let o=a.kind==="feedback"&&a.payload.feedbackType==="signal";if(E.has(a.kind)&&a.evidenceRefIds.length===0&&!o)I(i,"CI_EVIDENCE_REQUIRED",n,a,"Semantic records require evidence refs.")}for(let[n,a]of e.records.entries()){for(let o of a.recordRefIds)if(!t.has(o))I(i,"CI_REFERENCE_NOT_FOUND",n,a,`Unknown record ref ${o}.`);for(let o of a.evidenceRefIds){let s=t.get(o);if(!s)I(i,"CI_EVIDENCE_NOT_FOUND",n,a,`Unknown evidence ref ${o}.`);else if(s.kind!=="evidence")I(i,"CI_EVIDENCE_KIND_INVALID",n,a,`${o} is not an evidence record.`)}d(a,n,i)}return i}function I(e,i,t,n,a){e.push({code:i,path:`records.${t}.${n.kind}`,message:a})}export{y as validateCompanyIntelligenceSemanticInvariants};

package/dist/validation/company-intelligence.d.ts

@@ -0,0 +1,18 @@
+import { type CompanyIntelligenceRecord, type CompanyIntelligenceRecordDraft } from '../types/company-intelligence/index.js';
+import { type CompanyIntelligenceValidationResult } from './company-intelligence-semantics.js';
+export * from './company-intelligence-learning.js';
+export * from './company-intelligence-semantics.js';
+export declare const COMPANY_INTELLIGENCE_SCHEMA_IDENTITY: {
+    readonly schemaId: 'companyos.company-intelligence-record';
+    readonly version: '1.0.0';
+    readonly compatibility: 'additive';
+    readonly canonicalization: "canonical-json:v1";
+    readonly fingerprint: "company-intelligence-sha256:v1";
+    readonly recordKinds: readonly ['source', 'source_version', 'asset', 'part', 'fragment', 'evidence', 'claim', 'policy', 'entity', 'relation', 'conflict', 'gap', 'graph', 'edition', 'query', 'answer', 'verification', 'feedback', 'experiment', 'evaluation', 'promotion', 'rollback', 'replay'];
+};
+export declare function canonicalSerializeCompanyIntelligenceRecord(record: CompanyIntelligenceRecord | CompanyIntelligenceRecordDraft): string;
+export declare function fingerprintCompanyIntelligenceRecord(record: CompanyIntelligenceRecord | CompanyIntelligenceRecordDraft): Promise<string>;
+export declare function fingerprintCompanyIntelligenceCanonicalValue(value: unknown): Promise<string>;
+export declare function fingerprintCompanyIntelligenceSchema(): Promise<string>;
+export declare function withCompanyIntelligenceFingerprint(record: CompanyIntelligenceRecordDraft): Promise<CompanyIntelligenceRecord>;
+export declare function validateCompanyIntelligenceRecordPacket(input: unknown): Promise<CompanyIntelligenceValidationResult>;