feat(schema/result-types): define analysis result TypeBox schemas
This commit is contained in:
@@ -182,4 +182,295 @@ type TaskRisk = import('../src/schema/enums.js').TaskRisk;
|
||||
type TaskImpact = import('../src/schema/enums.js').TaskImpact;
|
||||
type TaskLevel = import('../src/schema/enums.js').TaskLevel;
|
||||
type TaskPriority = import('../src/schema/enums.js').TaskPriority;
|
||||
type TaskStatus = import('../src/schema/enums.js').TaskStatus;
|
||||
type TaskStatus = import('../src/schema/enums.js').TaskStatus;
|
||||
|
||||
// --- Result schema tests ---
|
||||
|
||||
import {
|
||||
RiskPathResult as RiskPathResultSchema,
|
||||
DecomposeResult as DecomposeResultSchema,
|
||||
WorkflowCostOptions as WorkflowCostOptionsSchema,
|
||||
WorkflowCostResult as WorkflowCostResultSchema,
|
||||
EvConfig as EvConfigSchema,
|
||||
EvResult as EvResultSchema,
|
||||
RiskDistributionResult as RiskDistributionResultSchema,
|
||||
} from '../src/schema/results.js';
|
||||
|
||||
// Re-import type aliases for compile-time verification
|
||||
type RiskPathResultType = import('../src/schema/results.js').RiskPathResult;
|
||||
type DecomposeResultType = import('../src/schema/results.js').DecomposeResult;
|
||||
type WorkflowCostOptionsType = import('../src/schema/results.js').WorkflowCostOptions;
|
||||
type WorkflowCostResultType = import('../src/schema/results.js').WorkflowCostResult;
|
||||
type EvConfigType = import('../src/schema/results.js').EvConfig;
|
||||
type EvResultType = import('../src/schema/results.js').EvResult;
|
||||
type RiskDistributionResultType = import('../src/schema/results.js').RiskDistributionResult;
|
||||
|
||||
describe('RiskPathResult schema', () => {
|
||||
it('accepts valid input', () => {
|
||||
expect(Value.Check(RiskPathResultSchema, { path: ['a', 'b', 'c'], totalRisk: 0.75 })).toBe(true);
|
||||
});
|
||||
|
||||
it('accepts empty path', () => {
|
||||
expect(Value.Check(RiskPathResultSchema, { path: [], totalRisk: 0 })).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects missing fields', () => {
|
||||
expect(Value.Check(RiskPathResultSchema, { path: ['a'] })).toBe(false);
|
||||
expect(Value.Check(RiskPathResultSchema, { totalRisk: 0.5 })).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects wrong types', () => {
|
||||
expect(Value.Check(RiskPathResultSchema, { path: 'not-array', totalRisk: 0.5 })).toBe(false);
|
||||
expect(Value.Check(RiskPathResultSchema, { path: ['a'], totalRisk: 'not-number' })).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('DecomposeResult schema', () => {
|
||||
it('accepts shouldDecompose=true with reasons', () => {
|
||||
expect(Value.Check(DecomposeResultSchema, { shouldDecompose: true, reasons: ['high risk', 'broad scope'] })).toBe(true);
|
||||
});
|
||||
|
||||
it('accepts shouldDecompose=false with empty reasons', () => {
|
||||
expect(Value.Check(DecomposeResultSchema, { shouldDecompose: false, reasons: [] })).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects missing fields', () => {
|
||||
expect(Value.Check(DecomposeResultSchema, { shouldDecompose: true })).toBe(false);
|
||||
expect(Value.Check(DecomposeResultSchema, { reasons: ['x'] })).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects wrong types', () => {
|
||||
expect(Value.Check(DecomposeResultSchema, { shouldDecompose: 'yes', reasons: [] })).toBe(false);
|
||||
expect(Value.Check(DecomposeResultSchema, { shouldDecompose: true, reasons: 'not-array' })).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('WorkflowCostOptions schema', () => {
|
||||
it('accepts empty object (all fields optional)', () => {
|
||||
expect(Value.Check(WorkflowCostOptionsSchema, {})).toBe(true);
|
||||
});
|
||||
|
||||
it('accepts all fields specified', () => {
|
||||
expect(Value.Check(WorkflowCostOptionsSchema, {
|
||||
includeCompleted: true,
|
||||
limit: 10,
|
||||
propagationMode: 'independent',
|
||||
defaultQualityRetention: 0.9,
|
||||
})).toBe(true);
|
||||
});
|
||||
|
||||
it('accepts dag-propagate propagationMode', () => {
|
||||
expect(Value.Check(WorkflowCostOptionsSchema, { propagationMode: 'dag-propagate' })).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects invalid propagationMode', () => {
|
||||
expect(Value.Check(WorkflowCostOptionsSchema, { propagationMode: 'invalid' })).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects wrong type for boolean field', () => {
|
||||
expect(Value.Check(WorkflowCostOptionsSchema, { includeCompleted: 'yes' })).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects wrong type for number fields', () => {
|
||||
expect(Value.Check(WorkflowCostOptionsSchema, { limit: 'ten' })).toBe(false);
|
||||
expect(Value.Check(WorkflowCostOptionsSchema, { defaultQualityRetention: 'high' })).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('WorkflowCostResult schema', () => {
|
||||
const validResult = {
|
||||
tasks: [{
|
||||
taskId: 'task-1',
|
||||
name: 'My Task',
|
||||
ev: 3.5,
|
||||
pIntrinsic: 0.8,
|
||||
pEffective: 0.75,
|
||||
probability: 0.75,
|
||||
scopeCost: 2.0,
|
||||
impactWeight: 1.5,
|
||||
}],
|
||||
totalEv: 3.5,
|
||||
averageEv: 3.5,
|
||||
propagationMode: 'independent',
|
||||
};
|
||||
|
||||
it('accepts valid result with independent mode', () => {
|
||||
expect(Value.Check(WorkflowCostResultSchema, validResult)).toBe(true);
|
||||
});
|
||||
|
||||
it('accepts valid result with dag-propagate mode', () => {
|
||||
expect(Value.Check(WorkflowCostResultSchema, { ...validResult, propagationMode: 'dag-propagate' })).toBe(true);
|
||||
});
|
||||
|
||||
it('accepts empty tasks array', () => {
|
||||
expect(Value.Check(WorkflowCostResultSchema, {
|
||||
tasks: [],
|
||||
totalEv: 0,
|
||||
averageEv: 0,
|
||||
propagationMode: 'independent',
|
||||
})).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects missing fields', () => {
|
||||
expect(Value.Check(WorkflowCostResultSchema, { tasks: [], totalEv: 0, averageEv: 0 })).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects invalid propagationMode', () => {
|
||||
expect(Value.Check(WorkflowCostResultSchema, { ...validResult, propagationMode: 'invalid' })).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects task entry with missing fields', () => {
|
||||
const incomplete = {
|
||||
tasks: [{ taskId: 't1', name: 'T1' }],
|
||||
totalEv: 0,
|
||||
averageEv: 0,
|
||||
propagationMode: 'independent',
|
||||
};
|
||||
expect(Value.Check(WorkflowCostResultSchema, incomplete)).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('EvConfig schema', () => {
|
||||
it('accepts empty object (all fields optional)', () => {
|
||||
expect(Value.Check(EvConfigSchema, {})).toBe(true);
|
||||
});
|
||||
|
||||
it('accepts all fields specified', () => {
|
||||
expect(Value.Check(EvConfigSchema, {
|
||||
retries: 3,
|
||||
fallbackCost: 10,
|
||||
timeLost: 5,
|
||||
valueRate: 0.5,
|
||||
})).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects wrong types', () => {
|
||||
expect(Value.Check(EvConfigSchema, { retries: 'three' })).toBe(false);
|
||||
expect(Value.Check(EvConfigSchema, { fallbackCost: true })).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects unknown properties (additionalProperties)', () => {
|
||||
// TypeBox Object by default allows additional properties through Check
|
||||
// This test documents behavior — strict additionalProperties would need Type.Object({...}, { additionalProperties: false })
|
||||
expect(Value.Check(EvConfigSchema, { unknownField: 42 })).toBe(true);
|
||||
});
|
||||
});
|
||||
|
||||
describe('EvResult schema', () => {
|
||||
it('accepts valid input', () => {
|
||||
expect(Value.Check(EvResultSchema, { ev: 3.5, pSuccess: 0.8, expectedRetries: 1.2 })).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects missing fields', () => {
|
||||
expect(Value.Check(EvResultSchema, { ev: 3.5, pSuccess: 0.8 })).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects wrong types', () => {
|
||||
expect(Value.Check(EvResultSchema, { ev: 'high', pSuccess: 0.8, expectedRetries: 1 })).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('RiskDistributionResult schema', () => {
|
||||
it('accepts valid distribution', () => {
|
||||
expect(Value.Check(RiskDistributionResultSchema, {
|
||||
trivial: ['t1'],
|
||||
low: ['t2', 't3'],
|
||||
medium: [],
|
||||
high: ['t4'],
|
||||
critical: [],
|
||||
unspecified: ['t5'],
|
||||
})).toBe(true);
|
||||
});
|
||||
|
||||
it('accepts all empty arrays', () => {
|
||||
expect(Value.Check(RiskDistributionResultSchema, {
|
||||
trivial: [],
|
||||
low: [],
|
||||
medium: [],
|
||||
high: [],
|
||||
critical: [],
|
||||
unspecified: [],
|
||||
})).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects missing fields', () => {
|
||||
expect(Value.Check(RiskDistributionResultSchema, {
|
||||
trivial: [],
|
||||
low: [],
|
||||
medium: [],
|
||||
high: [],
|
||||
critical: [],
|
||||
})).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects non-array values', () => {
|
||||
expect(Value.Check(RiskDistributionResultSchema, {
|
||||
trivial: 't1',
|
||||
low: [],
|
||||
medium: [],
|
||||
high: [],
|
||||
critical: [],
|
||||
unspecified: [],
|
||||
})).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects non-string array elements', () => {
|
||||
expect(Value.Check(RiskDistributionResultSchema, {
|
||||
trivial: [123],
|
||||
low: [],
|
||||
medium: [],
|
||||
high: [],
|
||||
critical: [],
|
||||
unspecified: [],
|
||||
})).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('Result type alias correctness (compile-time)', () => {
|
||||
it('RiskPathResult type accepts valid values', () => {
|
||||
const result: RiskPathResultType = { path: ['a'], totalRisk: 0.5 };
|
||||
expect(result.totalRisk).toBe(0.5);
|
||||
});
|
||||
|
||||
it('DecomposeResult type accepts valid values', () => {
|
||||
const result: DecomposeResultType = { shouldDecompose: true, reasons: ['high risk'] };
|
||||
expect(result.shouldDecompose).toBe(true);
|
||||
});
|
||||
|
||||
it('WorkflowCostOptions type accepts valid values', () => {
|
||||
const opts: WorkflowCostOptionsType = { propagationMode: 'dag-propagate', limit: 5 };
|
||||
expect(opts.propagationMode).toBe('dag-propagate');
|
||||
});
|
||||
|
||||
it('WorkflowCostResult type accepts valid values', () => {
|
||||
const result: WorkflowCostResultType = {
|
||||
tasks: [],
|
||||
totalEv: 0,
|
||||
averageEv: 0,
|
||||
propagationMode: 'independent',
|
||||
};
|
||||
expect(result.propagationMode).toBe('independent');
|
||||
});
|
||||
|
||||
it('EvConfig type accepts valid values', () => {
|
||||
const config: EvConfigType = { retries: 3, fallbackCost: 10 };
|
||||
expect(config.retries).toBe(3);
|
||||
});
|
||||
|
||||
it('EvResult type accepts valid values', () => {
|
||||
const result: EvResultType = { ev: 2.5, pSuccess: 0.9, expectedRetries: 0.5 };
|
||||
expect(result.ev).toBe(2.5);
|
||||
});
|
||||
|
||||
it('RiskDistributionResult type accepts valid values', () => {
|
||||
const result: RiskDistributionResultType = {
|
||||
trivial: [],
|
||||
low: [],
|
||||
medium: [],
|
||||
high: [],
|
||||
critical: [],
|
||||
unspecified: [],
|
||||
};
|
||||
expect(result.unspecified).toEqual([]);
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user