@ai-dev-orchestrator/schemas 0.1.1

package/dist/governance/governance.js

@@ -0,0 +1,111 @@
+import { z } from 'zod/v4';
+import { artifactRefSchema } from '../artifacts/artifact-system';
+import { runIdSchema } from '../shared/shared';
+export const policyTokenUsageSchema = z.object({
+    inputTokens: z.number(),
+    outputTokens: z.number(),
+    totalTokens: z.number(),
+});
+export const humanApprovalSchema = z.object({
+    approvedBy: z.string(),
+    timestamp: z.string(),
+    conditions: z.string().optional(),
+    artifactRef: artifactRefSchema.optional(),
+});
+const ESCALATION_REASONS = [
+    'iteration_limit_exceeded',
+    'quality_gate_failed',
+    'unresolvable_conflict',
+    'human_requested',
+    'token_budget_exceeded',
+    'retry_limit_exceeded',
+    'confidence_too_low',
+];
+export const escalationReasonSchema = z.enum(ESCALATION_REASONS);
+const ESCALATION_TRIGGERS = [
+    ...ESCALATION_REASONS,
+    'provider_failure',
+    'timeout',
+    'unrecoverable_error',
+];
+export const escalationTriggerSchema = z.enum(ESCALATION_TRIGGERS);
+export const findingSummarySchema = z.object({
+    id: z.string(),
+    severity: z.string(),
+    status: z.string(),
+    description: z.string(),
+    resolutionRef: artifactRefSchema.optional(),
+});
+export const iterationSummarySchema = z.object({
+    iteration: z.number(),
+    producerArtifact: artifactRefSchema,
+    reviewerArtifact: artifactRefSchema,
+    findingsProduced: z.number(),
+    findingsResolved: z.number(),
+    findingsRemaining: z.number(),
+});
+export const escalationContextSchema = z.object({
+    runId: runIdSchema,
+    stageId: z.string(),
+    reason: escalationReasonSchema,
+    iterationHistory: z.array(iterationSummarySchema).readonly(),
+    unresolvedFindings: z.array(findingSummarySchema).readonly(),
+    artifactRefs: z.array(artifactRefSchema).readonly(),
+    suggestedActions: z.array(z.string()).readonly(),
+});
+export const transitionAllowedSchema = z.object({
+    allowed: z.literal(true),
+    reason: z.string(),
+});
+export const transitionDeniedSchema = z.object({
+    allowed: z.literal(false),
+    reason: z.string(),
+    remediation: z.string(),
+});
+export const transitionEscalatedSchema = z.object({
+    escalate: z.literal(true),
+    reason: z.string(),
+    context: escalationContextSchema,
+});
+export const transitionDecisionSchema = z.union([
+    transitionAllowedSchema,
+    transitionDeniedSchema,
+    transitionEscalatedSchema,
+]);
+export const transitionRequestSchema = z.object({
+    runId: runIdSchema,
+    from: z.string(),
+    to: z.string(),
+    artifacts: z.array(artifactRefSchema).readonly(),
+    iterationCount: z.number().optional(),
+    findings: z.array(findingSummarySchema).readonly().optional(),
+    humanApproval: humanApprovalSchema.optional(),
+    tokenUsage: policyTokenUsageSchema.optional(),
+});
+export const agreementStatusSchema = z.object({
+    exists: z.boolean(),
+    valid: z.boolean(),
+    artifact: artifactRefSchema.optional(),
+    missingReason: z.string().optional(),
+});
+export const policyCheckOutcomeSchema = z.enum(['pass', 'fail', 'skip']);
+export const policyEvaluationSchema = z.object({
+    policy: z.string(),
+    evaluated: z.boolean(),
+    result: policyCheckOutcomeSchema,
+    detail: z.string(),
+    escalationTrigger: escalationTriggerSchema.optional(),
+});
+export const governanceOutcomeSchema = z.enum(['allowed', 'denied', 'escalated']);
+export const governanceDecisionSchema = z.object({
+    timestamp: z.string(),
+    runId: runIdSchema,
+    transitionRequested: z.object({
+        from: z.string(),
+        to: z.string(),
+    }),
+    policiesEvaluated: z.array(policyEvaluationSchema).readonly(),
+    outcome: governanceOutcomeSchema,
+    reason: z.string(),
+    artifactsInspected: z.array(artifactRefSchema).readonly(),
+});

package/dist/governance/index.d.ts

@@ -0,0 +1,3 @@
+export * from './governance';
+export * from './policy-engine';
+export * from './review-resolution';

package/dist/governance/index.js

@@ -0,0 +1,3 @@
+export * from './governance';
+export * from './policy-engine';
+export * from './review-resolution';