@ai-dev-orchestrator/schemas 0.1.1

package/dist/persistence/run-manifest.d.ts

@@ -0,0 +1,422 @@
+import { z } from 'zod/v4';
+export declare const manifestWorkflowInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+}, z.core.$strip>;
+export type ManifestWorkflowInfo = z.infer<typeof manifestWorkflowInfoSchema>;
+export declare const stateVisitSchema: z.ZodObject<{
+    stateId: z.ZodString;
+    enteredAt: z.ZodString;
+    exitedAt: z.ZodString;
+    durationMs: z.ZodNumber;
+}, z.core.$strip>;
+export type StateVisit = z.infer<typeof stateVisitSchema>;
+export declare const stateTimingSchema: z.ZodObject<{
+    stateId: z.ZodString;
+    enteredAt: z.ZodString;
+    exitedAt: z.ZodString;
+    durationMs: z.ZodNumber;
+    visits: z.ZodNumber;
+}, z.core.$strip>;
+export type StateTiming = z.infer<typeof stateTimingSchema>;
+export declare const manifestTimingSchema: z.ZodObject<{
+    startedAt: z.ZodString;
+    completedAt: z.ZodString;
+    totalDurationMs: z.ZodNumber;
+    stateTimings: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        stateId: z.ZodString;
+        enteredAt: z.ZodString;
+        exitedAt: z.ZodString;
+        durationMs: z.ZodNumber;
+        visits: z.ZodNumber;
+    }, z.core.$strip>>>;
+    stateTrace: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        stateId: z.ZodString;
+        enteredAt: z.ZodString;
+        exitedAt: z.ZodString;
+        durationMs: z.ZodNumber;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+export type ManifestTiming = z.infer<typeof manifestTimingSchema>;
+export declare const roleUsageSchema: z.ZodObject<{
+    role: z.ZodString;
+    dispatches: z.ZodNumber;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    totalDurationMs: z.ZodNumber;
+    artifactsProduced: z.ZodNumber;
+}, z.core.$strip>;
+export type RoleUsage = z.infer<typeof roleUsageSchema>;
+export declare const manifestArtifactSummarySchema: z.ZodObject<{
+    ref: z.ZodObject<{
+        type: z.ZodEnum<{
+            intake_requirements: "intake_requirements";
+            canonical_specification: "canonical_specification";
+            clarification_questions: "clarification_questions";
+            clarification_answers: "clarification_answers";
+            plan: "plan";
+            plan_review: "plan_review";
+            test_plan: "test_plan";
+            implementation: "implementation";
+            static_review: "static_review";
+            security_review: "security_review";
+            performance_review: "performance_review";
+            adversarial_review: "adversarial_review";
+            design_review: "design_review";
+            docs_review: "docs_review";
+            ux_review: "ux_review";
+            review_report: "review_report";
+            remediation_plan: "remediation_plan";
+            verification: "verification";
+            judge_decision: "judge_decision";
+            planning_agreement: "planning_agreement";
+            implementation_agreement: "implementation_agreement";
+            verification_agreement: "verification_agreement";
+            release_summary: "release_summary";
+            release_agreement: "release_agreement";
+            escalation_context: "escalation_context";
+            run_manifest: "run_manifest";
+            codebase_context: "codebase_context";
+            test_suite: "test_suite";
+            acceptance_validation: "acceptance_validation";
+            review_findings: "review_findings";
+            task_breakdown: "task_breakdown";
+            decomposition_review: "decomposition_review";
+            task_specifications: "task_specifications";
+            pr_diff_context: "pr_diff_context";
+        }>;
+        name: z.ZodString;
+        version: z.ZodNumber;
+        checksum: z.ZodString;
+    }, z.core.$strip>;
+    producedBy: z.ZodString;
+    createdAt: z.ZodString;
+    sizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+export type ManifestArtifactSummary = z.infer<typeof manifestArtifactSummarySchema>;
+export declare const manifestIterationSummarySchema: z.ZodObject<{
+    contractId: z.ZodString;
+    totalIterations: z.ZodNumber;
+    judgeArbitrations: z.ZodNumber;
+    finalStatus: z.ZodString;
+    findingsTotal: z.ZodNumber;
+    findingsResolved: z.ZodNumber;
+}, z.core.$strip>;
+export type ManifestIterationSummary = z.infer<typeof manifestIterationSummarySchema>;
+export declare const manifestTokenUsageSchema: z.ZodObject<{
+    totalInputTokens: z.ZodNumber;
+    totalOutputTokens: z.ZodNumber;
+    totalTokens: z.ZodNumber;
+    byRole: z.ZodRecord<z.ZodString, z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ManifestTokenUsage = z.infer<typeof manifestTokenUsageSchema>;
+export declare const manifestBudgetSummarySchema: z.ZodObject<{
+    configuredMaxTokens: z.ZodNullable<z.ZodNumber>;
+    budgetExceeded: z.ZodBoolean;
+}, z.core.$strip>;
+export type ManifestBudgetSummary = z.infer<typeof manifestBudgetSummarySchema>;
+export declare const runManifestSchema: z.ZodObject<{
+    runId: z.ZodString;
+    version: z.ZodString;
+    repository: z.ZodString;
+    repoRoot: z.ZodOptional<z.ZodString>;
+    workflow: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+    timing: z.ZodObject<{
+        startedAt: z.ZodString;
+        completedAt: z.ZodString;
+        totalDurationMs: z.ZodNumber;
+        stateTimings: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            stateId: z.ZodString;
+            enteredAt: z.ZodString;
+            exitedAt: z.ZodString;
+            durationMs: z.ZodNumber;
+            visits: z.ZodNumber;
+        }, z.core.$strip>>>;
+        stateTrace: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            stateId: z.ZodString;
+            enteredAt: z.ZodString;
+            exitedAt: z.ZodString;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>;
+    status: z.ZodString;
+    finalState: z.ZodString;
+    abortReason: z.ZodOptional<z.ZodString>;
+    activeRoles: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        dispatches: z.ZodNumber;
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        totalDurationMs: z.ZodNumber;
+        artifactsProduced: z.ZodNumber;
+    }, z.core.$strip>>>;
+    artifactInventory: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        ref: z.ZodObject<{
+            type: z.ZodEnum<{
+                intake_requirements: "intake_requirements";
+                canonical_specification: "canonical_specification";
+                clarification_questions: "clarification_questions";
+                clarification_answers: "clarification_answers";
+                plan: "plan";
+                plan_review: "plan_review";
+                test_plan: "test_plan";
+                implementation: "implementation";
+                static_review: "static_review";
+                security_review: "security_review";
+                performance_review: "performance_review";
+                adversarial_review: "adversarial_review";
+                design_review: "design_review";
+                docs_review: "docs_review";
+                ux_review: "ux_review";
+                review_report: "review_report";
+                remediation_plan: "remediation_plan";
+                verification: "verification";
+                judge_decision: "judge_decision";
+                planning_agreement: "planning_agreement";
+                implementation_agreement: "implementation_agreement";
+                verification_agreement: "verification_agreement";
+                release_summary: "release_summary";
+                release_agreement: "release_agreement";
+                escalation_context: "escalation_context";
+                run_manifest: "run_manifest";
+                codebase_context: "codebase_context";
+                test_suite: "test_suite";
+                acceptance_validation: "acceptance_validation";
+                review_findings: "review_findings";
+                task_breakdown: "task_breakdown";
+                decomposition_review: "decomposition_review";
+                task_specifications: "task_specifications";
+                pr_diff_context: "pr_diff_context";
+            }>;
+            name: z.ZodString;
+            version: z.ZodNumber;
+            checksum: z.ZodString;
+        }, z.core.$strip>;
+        producedBy: z.ZodString;
+        createdAt: z.ZodString;
+        sizeBytes: z.ZodNumber;
+    }, z.core.$strip>>>;
+    totalArtifacts: z.ZodNumber;
+    totalArtifactSizeBytes: z.ZodNumber;
+    iterations: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        contractId: z.ZodString;
+        totalIterations: z.ZodNumber;
+        judgeArbitrations: z.ZodNumber;
+        finalStatus: z.ZodString;
+        findingsTotal: z.ZodNumber;
+        findingsResolved: z.ZodNumber;
+    }, z.core.$strip>>>;
+    governanceDecisions: z.ZodNumber;
+    escalations: z.ZodNumber;
+    humanInterventions: z.ZodNumber;
+    agreements: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            intake_requirements: "intake_requirements";
+            canonical_specification: "canonical_specification";
+            clarification_questions: "clarification_questions";
+            clarification_answers: "clarification_answers";
+            plan: "plan";
+            plan_review: "plan_review";
+            test_plan: "test_plan";
+            implementation: "implementation";
+            static_review: "static_review";
+            security_review: "security_review";
+            performance_review: "performance_review";
+            adversarial_review: "adversarial_review";
+            design_review: "design_review";
+            docs_review: "docs_review";
+            ux_review: "ux_review";
+            review_report: "review_report";
+            remediation_plan: "remediation_plan";
+            verification: "verification";
+            judge_decision: "judge_decision";
+            planning_agreement: "planning_agreement";
+            implementation_agreement: "implementation_agreement";
+            verification_agreement: "verification_agreement";
+            release_summary: "release_summary";
+            release_agreement: "release_agreement";
+            escalation_context: "escalation_context";
+            run_manifest: "run_manifest";
+            codebase_context: "codebase_context";
+            test_suite: "test_suite";
+            acceptance_validation: "acceptance_validation";
+            review_findings: "review_findings";
+            task_breakdown: "task_breakdown";
+            decomposition_review: "decomposition_review";
+            task_specifications: "task_specifications";
+            pr_diff_context: "pr_diff_context";
+        }>;
+        name: z.ZodString;
+        version: z.ZodNumber;
+        checksum: z.ZodString;
+    }, z.core.$strip>>>;
+    tokenUsage: z.ZodObject<{
+        totalInputTokens: z.ZodNumber;
+        totalOutputTokens: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+        byRole: z.ZodRecord<z.ZodString, z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    budgetSummary: z.ZodOptional<z.ZodObject<{
+        configuredMaxTokens: z.ZodNullable<z.ZodNumber>;
+        budgetExceeded: z.ZodBoolean;
+    }, z.core.$strip>>;
+    reportPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RunManifest = z.infer<typeof runManifestSchema>;
+export declare const manifestContextConfigSchema: z.ZodObject<{
+    startedAt: z.ZodString;
+    completedAt: z.ZodString;
+    governanceDecisions: z.ZodNumber;
+    escalations: z.ZodNumber;
+    iterations: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        contractId: z.ZodString;
+        totalIterations: z.ZodNumber;
+        judgeArbitrations: z.ZodNumber;
+        finalStatus: z.ZodString;
+        findingsTotal: z.ZodNumber;
+        findingsResolved: z.ZodNumber;
+    }, z.core.$strip>>>;
+    stateTimestamps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        stateId: z.ZodString;
+        enteredAt: z.ZodString;
+        exitedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    repoRoot: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ManifestContextConfig = z.infer<typeof manifestContextConfigSchema>;
+export declare const manifestContextSchema: z.ZodObject<{
+    runId: z.ZodString;
+    config: z.ZodObject<{
+        startedAt: z.ZodString;
+        completedAt: z.ZodString;
+        governanceDecisions: z.ZodNumber;
+        escalations: z.ZodNumber;
+        iterations: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            contractId: z.ZodString;
+            totalIterations: z.ZodNumber;
+            judgeArbitrations: z.ZodNumber;
+            finalStatus: z.ZodString;
+            findingsTotal: z.ZodNumber;
+            findingsResolved: z.ZodNumber;
+        }, z.core.$strip>>>;
+        stateTimestamps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            stateId: z.ZodString;
+            enteredAt: z.ZodString;
+            exitedAt: z.ZodString;
+        }, z.core.$strip>>>;
+        repoRoot: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    stateHistory: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    artifactInventory: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            intake_requirements: "intake_requirements";
+            canonical_specification: "canonical_specification";
+            clarification_questions: "clarification_questions";
+            clarification_answers: "clarification_answers";
+            plan: "plan";
+            plan_review: "plan_review";
+            test_plan: "test_plan";
+            implementation: "implementation";
+            static_review: "static_review";
+            security_review: "security_review";
+            performance_review: "performance_review";
+            adversarial_review: "adversarial_review";
+            design_review: "design_review";
+            docs_review: "docs_review";
+            ux_review: "ux_review";
+            review_report: "review_report";
+            remediation_plan: "remediation_plan";
+            verification: "verification";
+            judge_decision: "judge_decision";
+            planning_agreement: "planning_agreement";
+            implementation_agreement: "implementation_agreement";
+            verification_agreement: "verification_agreement";
+            release_summary: "release_summary";
+            release_agreement: "release_agreement";
+            escalation_context: "escalation_context";
+            run_manifest: "run_manifest";
+            codebase_context: "codebase_context";
+            test_suite: "test_suite";
+            acceptance_validation: "acceptance_validation";
+            review_findings: "review_findings";
+            task_breakdown: "task_breakdown";
+            decomposition_review: "decomposition_review";
+            task_specifications: "task_specifications";
+            pr_diff_context: "pr_diff_context";
+        }>;
+        name: z.ZodString;
+        version: z.ZodNumber;
+        checksum: z.ZodString;
+    }, z.core.$strip>>>;
+    journalPath: z.ZodString;
+    workerMetrics: z.ZodRecord<z.ZodString, z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        dispatches: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        artifactsProduced: z.ZodNumber;
+    }, z.core.$strip>>;
+    workflowName: z.ZodOptional<z.ZodString>;
+    workflowVersion: z.ZodOptional<z.ZodString>;
+    artifactSummaries: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        ref: z.ZodObject<{
+            type: z.ZodEnum<{
+                intake_requirements: "intake_requirements";
+                canonical_specification: "canonical_specification";
+                clarification_questions: "clarification_questions";
+                clarification_answers: "clarification_answers";
+                plan: "plan";
+                plan_review: "plan_review";
+                test_plan: "test_plan";
+                implementation: "implementation";
+                static_review: "static_review";
+                security_review: "security_review";
+                performance_review: "performance_review";
+                adversarial_review: "adversarial_review";
+                design_review: "design_review";
+                docs_review: "docs_review";
+                ux_review: "ux_review";
+                review_report: "review_report";
+                remediation_plan: "remediation_plan";
+                verification: "verification";
+                judge_decision: "judge_decision";
+                planning_agreement: "planning_agreement";
+                implementation_agreement: "implementation_agreement";
+                verification_agreement: "verification_agreement";
+                release_summary: "release_summary";
+                release_agreement: "release_agreement";
+                escalation_context: "escalation_context";
+                run_manifest: "run_manifest";
+                codebase_context: "codebase_context";
+                test_suite: "test_suite";
+                acceptance_validation: "acceptance_validation";
+                review_findings: "review_findings";
+                task_breakdown: "task_breakdown";
+                decomposition_review: "decomposition_review";
+                task_specifications: "task_specifications";
+                pr_diff_context: "pr_diff_context";
+            }>;
+            name: z.ZodString;
+            version: z.ZodNumber;
+            checksum: z.ZodString;
+        }, z.core.$strip>;
+        producedBy: z.ZodString;
+        createdAt: z.ZodString;
+        sizeBytes: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    budgetSummary: z.ZodOptional<z.ZodObject<{
+        configuredMaxTokens: z.ZodNullable<z.ZodNumber>;
+        budgetExceeded: z.ZodBoolean;
+    }, z.core.$strip>>;
+    reportPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ManifestContext = z.infer<typeof manifestContextSchema>;

package/dist/persistence/run-manifest.js

@@ -0,0 +1,118 @@
+import { z } from 'zod/v4';
+import { artifactRefSchema } from '../artifacts/artifact-system';
+export const manifestWorkflowInfoSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+});
+export const stateVisitSchema = z.object({
+    stateId: z.string(),
+    enteredAt: z.string(),
+    exitedAt: z.string(),
+    durationMs: z.number(),
+});
+export const stateTimingSchema = z.object({
+    stateId: z.string(),
+    enteredAt: z.string(),
+    exitedAt: z.string(),
+    durationMs: z.number(),
+    visits: z.number(),
+});
+export const manifestTimingSchema = z.object({
+    startedAt: z.string(),
+    completedAt: z.string(),
+    totalDurationMs: z.number(),
+    stateTimings: z.array(stateTimingSchema).readonly(),
+    stateTrace: z.array(stateVisitSchema).readonly().optional(),
+});
+export const roleUsageSchema = z.object({
+    role: z.string(),
+    dispatches: z.number(),
+    inputTokens: z.number(),
+    outputTokens: z.number(),
+    totalDurationMs: z.number(),
+    artifactsProduced: z.number(),
+});
+export const manifestArtifactSummarySchema = z.object({
+    ref: artifactRefSchema,
+    producedBy: z.string(),
+    createdAt: z.string(),
+    sizeBytes: z.number(),
+});
+export const manifestIterationSummarySchema = z.object({
+    contractId: z.string(),
+    totalIterations: z.number(),
+    judgeArbitrations: z.number(),
+    finalStatus: z.string(),
+    findingsTotal: z.number(),
+    findingsResolved: z.number(),
+});
+export const manifestTokenUsageSchema = z.object({
+    totalInputTokens: z.number(),
+    totalOutputTokens: z.number(),
+    totalTokens: z.number(),
+    byRole: z.record(z.string(), z.object({
+        input: z.number(),
+        output: z.number(),
+    })),
+});
+export const manifestBudgetSummarySchema = z.object({
+    configuredMaxTokens: z.number().nullable(),
+    budgetExceeded: z.boolean(),
+});
+export const runManifestSchema = z.object({
+    runId: z.string(),
+    version: z.string(),
+    repository: z.string(),
+    repoRoot: z.string().optional(),
+    workflow: manifestWorkflowInfoSchema,
+    timing: manifestTimingSchema,
+    status: z.string(),
+    finalState: z.string(),
+    abortReason: z.string().optional(),
+    activeRoles: z.array(roleUsageSchema).readonly(),
+    artifactInventory: z.array(manifestArtifactSummarySchema).readonly(),
+    totalArtifacts: z.number(),
+    totalArtifactSizeBytes: z.number(),
+    iterations: z.array(manifestIterationSummarySchema).readonly(),
+    governanceDecisions: z.number(),
+    escalations: z.number(),
+    humanInterventions: z.number(),
+    agreements: z.array(artifactRefSchema).readonly(),
+    tokenUsage: manifestTokenUsageSchema,
+    budgetSummary: manifestBudgetSummarySchema.optional(),
+    reportPath: z.string().optional(),
+});
+export const manifestContextConfigSchema = z.object({
+    startedAt: z.string(),
+    completedAt: z.string(),
+    governanceDecisions: z.number(),
+    escalations: z.number(),
+    iterations: z.array(manifestIterationSummarySchema).readonly(),
+    stateTimestamps: z
+        .array(z.object({
+        stateId: z.string(),
+        enteredAt: z.string(),
+        exitedAt: z.string(),
+    }))
+        .readonly(),
+    repoRoot: z.string().optional(),
+});
+export const manifestContextSchema = z.object({
+    runId: z.string(),
+    config: manifestContextConfigSchema,
+    stateHistory: z.array(z.string()).readonly(),
+    artifactInventory: z.array(artifactRefSchema).readonly(),
+    journalPath: z.string(),
+    workerMetrics: z.record(z.string(), z.object({
+        inputTokens: z.number(),
+        outputTokens: z.number(),
+        dispatches: z.number(),
+        durationMs: z.number(),
+        artifactsProduced: z.number(),
+    })),
+    workflowName: z.string().optional(),
+    workflowVersion: z.string().optional(),
+    artifactSummaries: z.array(manifestArtifactSummarySchema).readonly().optional(),
+    budgetSummary: manifestBudgetSummarySchema.optional(),
+    reportPath: z.string().optional(),
+});