codex-orchestrator 0.1.51 → 2.0.0

package/dist/src/config/schema.js

@@ -1,673 +0,0 @@
-import { forbiddenRuntimeKeys, labelKeys, labelPreparationPolicies, workflowKeys, workflowSources, } from './constants.js';
-import { reviewHandoffFlows } from '../review-handoff.js';
-export const checkExecutionPhaseKeys = ['child', 'parent-integration'];
-export const acceptanceProofStrategies = [
-    'auto',
-    'visual',
-    'browser-visual',
-    'mobile-visual',
-    'non-visual-smoke',
-    'none',
-];
-export const codexPhaseKeys = [
-    'plan-parent',
-    'scoped-issue',
-    'tree-child',
-    'acceptance-proof',
-    'fresh-context-review',
-    'visual-proof',
-    'quality-review',
-];
-export const forbiddenCodexProfileEnvKeys = new Set([
-    'GH_TOKEN',
-    'GITHUB_TOKEN',
-    'SSH_AUTH_SOCK',
-    'GIT_ASKPASS',
-    'HOME',
-    'CODEX_ORCHESTRATOR_ALLOW_MOBILE_DEVICE_CONTROL',
-    'CODEX_ORCHESTRATOR_MOBILE_DEVICE_GUARD',
-    'CODEX_ORCHESTRATOR_PROMPT_FILE',
-    'CODEX_ORCHESTRATOR_REPORT_FILE',
-]);
-export function validateConfig(input) {
-    const errors = [];
-    const root = asObject(input);
-    if (!root) {
-        return { ok: false, errors: ['config must be an object'] };
-    }
-    for (const forbiddenKey of forbiddenRuntimeKeys) {
-        if (forbiddenKey in root) {
-            errors.push(`${forbiddenKey} is runtime state and must not be committed config`);
-        }
-    }
-    expectLiteral(root, 'version', 1, errors);
-    const github = expectObject(root, 'github', errors);
-    const runner = expectObject(root, 'runner', errors);
-    const codex = expectObject(root, 'codex', errors);
-    const project = expectObject(root, 'project', errors);
-    const workflows = expectObject(root, 'workflows', errors);
-    const checks = expectObject(root, 'checks', errors);
-    const checksPolicy = expectOptionalObject(root, 'checksPolicy', errors);
-    const reviewGates = expectObject(root, 'reviewGates', errors);
-    const loopPolicy = expectObject(root, 'loopPolicy', errors);
-    const deny = expectObject(root, 'deny', errors);
-    const branches = expectObject(root, 'branches', errors);
-    const pullRequests = expectObject(root, 'pullRequests', errors);
-    const issueClassification = expectObject(root, 'issueClassification', errors);
-    if (github) {
-        expectString(github, 'github.owner', errors);
-        expectString(github, 'github.repo', errors);
-        expectUnion(github, 'github.prepareLabels', labelPreparationPolicies, errors);
-        const labels = expectObject(github, 'github.labels', errors);
-        if (labels) {
-            for (const labelKey of labelKeys) {
-                validateLabel(labels, `github.labels.${labelKey}`, errors);
-            }
-        }
-    }
-    if (runner) {
-        expectString(runner, 'runner.workspaceRoot', errors);
-        expectParallelLimit(runner, errors);
-        expectOptionalParallelLimit(runner, 'runner.maxParallelScopedIssues', errors);
-        expectString(runner, 'runner.stateDir', errors);
-        expectBoolean(runner, 'runner.allowAgentLocalCommits', errors);
-        validateWorktreeCleanup(runner, errors);
-        validateResolutionMission(runner, errors);
-    }
-    if (codex) {
-        expectLiteral(codex, 'codex.adapter', 'codex-cli', errors);
-        expectString(codex, 'codex.command', errors);
-        expectStringArray(codex, 'codex.args', errors);
-        expectOptionalPositiveInteger(codex, 'codex.timeoutMs', errors);
-        expectOptionalPositiveInteger(codex, 'codex.mobileTimeoutMs', errors);
-        expectOptionalPositiveInteger(codex, 'codex.idleTimeoutMs', errors);
-        expectOptionalBoolean(codex, 'codex.ignoreUserConfig', errors);
-        validateCodexFigmaMcp(codex, errors);
-        validateCodexProfiles(codex, errors);
-        expectLiteral(codex, 'codex.promptFileEnv', 'CODEX_ORCHESTRATOR_PROMPT_FILE', errors);
-        expectLiteral(codex, 'codex.reportFileEnv', 'CODEX_ORCHESTRATOR_REPORT_FILE', errors);
-    }
-    if (project) {
-        expectLiteral(project, 'project.configDir', '.codex-orchestrator', errors);
-        expectLiteral(project, 'project.promptsDir', '.codex-orchestrator/prompts', errors);
-    }
-    if (workflows) {
-        for (const workflowKey of workflowKeys) {
-            validateWorkflow(workflows, `workflows.${workflowKey}`, errors);
-        }
-    }
-    if (checks) {
-        validateChecks(checks, errors);
-    }
-    if (checksPolicy) {
-        validateChecksPolicy(checksPolicy, errors);
-    }
-    if (reviewGates) {
-        validateReviewGates(reviewGates, errors);
-    }
-    if (loopPolicy) {
-        validateLoopPolicy(loopPolicy, errors);
-    }
-    if (deny) {
-        expectStringArray(deny, 'deny.secretFiles', errors);
-        expectBoolean(deny, 'deny.destructiveDbOrCache', errors);
-        expectBoolean(deny, 'deny.productionDeployOrRelease', errors);
-        expectStringArray(deny, 'deny.additionalPathGlobs', errors);
-    }
-    if (branches) {
-        validateBaseBranch(branches, errors);
-        expectString(branches, 'branches.scopedIssue', errors);
-        expectString(branches, 'branches.issueTree', errors);
-    }
-    if (pullRequests) {
-        expectString(pullRequests, 'pullRequests.scopedIssueTitle', errors);
-        expectString(pullRequests, 'pullRequests.issueTreeTitle', errors);
-    }
-    if (issueClassification) {
-        expectStringArray(issueClassification, 'issueClassification.promotionCriteria', errors);
-        expectLiteral(issueClassification, 'issueClassification.clarificationGate', 'block-and-comment', errors);
-    }
-    if (errors.length > 0) {
-        return { ok: false, errors };
-    }
-    return { ok: true, value: normalizeConfig(root) };
-}
-function normalizeConfig(config) {
-    const figmaMcp = config.codex.figmaMcp;
-    if (!figmaMcp) {
-        return config;
-    }
-    const { issueTextPatterns, optionalIssueTextPatterns, requiredIssueTextPatterns, optionalFailure, requiredFailure, ...rest } = figmaMcp;
-    return {
-        ...config,
-        codex: {
-            ...config.codex,
-            figmaMcp: {
-                ...rest,
-                optionalIssueTextPatterns: optionalIssueTextPatterns ?? issueTextPatterns ?? [],
-                requiredIssueTextPatterns: requiredIssueTextPatterns ?? [],
-                optionalFailure: optionalFailure ?? 'retry-without-mcp',
-                requiredFailure: requiredFailure ?? 'block',
-            },
-        },
-    };
-}
-function asObject(value) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
-        return undefined;
-    }
-    return value;
-}
-function readPath(parent, path) {
-    const lastKey = path.split('.').at(-1);
-    return lastKey ? parent[lastKey] : undefined;
-}
-function expectObject(parent, path, errors) {
-    const value = readPath(parent, path);
-    const objectValue = asObject(value);
-    if (!objectValue) {
-        errors.push(`${path} must be an object`);
-        return undefined;
-    }
-    return objectValue;
-}
-function expectOptionalObject(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (value === undefined) {
-        return undefined;
-    }
-    const objectValue = asObject(value);
-    if (!objectValue) {
-        errors.push(`${path} must be an object`);
-        return undefined;
-    }
-    return objectValue;
-}
-function expectString(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (typeof value !== 'string' || value.length === 0) {
-        errors.push(`${path} must be a non-empty string`);
-        return undefined;
-    }
-    return value;
-}
-function expectBoolean(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (typeof value !== 'boolean') {
-        errors.push(`${path} must be a boolean`);
-        return undefined;
-    }
-    return value;
-}
-function expectOptionalBoolean(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value !== 'boolean') {
-        errors.push(`${path} must be a boolean when provided`);
-        return undefined;
-    }
-    return value;
-}
-function expectLiteral(parent, path, expected, errors) {
-    const value = readPath(parent, path);
-    if (value !== expected) {
-        errors.push(`${path} must be ${expected}`);
-        return undefined;
-    }
-    return expected;
-}
-function expectUnion(parent, path, expected, errors) {
-    const value = readPath(parent, path);
-    if (typeof value !== 'string' || !expected.includes(value)) {
-        errors.push(`${path} must be one of ${expected.join(', ')}`);
-        return undefined;
-    }
-    return value;
-}
-function expectParallelLimit(parent, errors) {
-    const value = readPath(parent, 'runner.maxParallelChildren');
-    if (!Number.isInteger(value) || typeof value !== 'number' || value < 1 || value > 3) {
-        errors.push('runner.maxParallelChildren must be an integer between 1 and 3');
-        return undefined;
-    }
-    return value;
-}
-function expectOptionalParallelLimit(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (value === undefined) {
-        return undefined;
-    }
-    if (!Number.isInteger(value) || typeof value !== 'number' || value < 1 || value > 3) {
-        errors.push(`${path} must be an integer between 1 and 3 when provided`);
-        return undefined;
-    }
-    return value;
-}
-function expectStringArray(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string' || item.length === 0)) {
-        errors.push(`${path} must be an array of non-empty strings`);
-        return undefined;
-    }
-    return value;
-}
-function expectOptionalStringArray(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (value === undefined) {
-        return undefined;
-    }
-    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string' || item.length === 0)) {
-        errors.push(`${path} must be an array of non-empty strings when provided`);
-        return undefined;
-    }
-    return value;
-}
-function validateLabel(parent, path, errors) {
-    const label = expectObject(parent, path, errors);
-    if (!label) {
-        return;
-    }
-    expectString(label, `${path}.name`, errors);
-    expectString(label, `${path}.color`, errors);
-    expectString(label, `${path}.description`, errors);
-}
-function validateBaseBranch(branches, errors) {
-    const value = readPath(branches, 'branches.base');
-    if (typeof value === 'string') {
-        if (value.length === 0) {
-            errors.push('branches.base must be a non-empty string or explicit base branch object');
-        }
-        return;
-    }
-    const base = asObject(value);
-    if (!base) {
-        errors.push('branches.base must be a non-empty string or explicit base branch object');
-        return;
-    }
-    expectLiteral(base, 'branches.base.mode', 'explicit', errors);
-    expectString(base, 'branches.base.remote', errors);
-    expectString(base, 'branches.base.branch', errors);
-}
-function validateWorkflow(parent, path, errors) {
-    const workflow = expectObject(parent, path, errors);
-    if (!workflow) {
-        return;
-    }
-    const source = expectUnion(workflow, `${path}.source`, workflowSources, errors);
-    expectString(workflow, `${path}.skillName`, errors);
-    if (source === 'existing-skill' || source === 'package-owned-skill') {
-        expectString(workflow, `${path}.skillPath`, errors);
-    }
-    if (source === 'package-bundled-prompt' || source === 'package-owned-prompt-fallback') {
-        expectString(workflow, `${path}.promptPath`, errors);
-    }
-}
-function validateChecks(checks, errors) {
-    for (const [name, command] of Object.entries(checks)) {
-        if (name.length === 0 || typeof command !== 'string' || command.length === 0) {
-            errors.push('checks must map non-empty names to non-empty shell commands');
-        }
-    }
-}
-function validateCodexProfiles(codex, errors) {
-    const profiles = expectOptionalObject(codex, 'codex.profiles', errors);
-    if (!profiles) {
-        return;
-    }
-    for (const key of Object.keys(profiles)) {
-        if (!codexPhaseKeys.includes(key)) {
-            errors.push(`codex.profiles contains unknown phase ${key}`);
-            continue;
-        }
-        const profile = expectOptionalObject(profiles, `codex.profiles.${key}`, errors);
-        if (!profile) {
-            continue;
-        }
-        expectOptionalString(profile, `codex.profiles.${key}.command`, errors);
-        expectOptionalStringArray(profile, `codex.profiles.${key}.args`, errors);
-        expectOptionalPositiveInteger(profile, `codex.profiles.${key}.timeoutMs`, errors);
-        expectOptionalPositiveInteger(profile, `codex.profiles.${key}.idleTimeoutMs`, errors);
-        validateCodexProfileEnv(profile, key, errors);
-    }
-}
-function validateCodexProfileEnv(profile, phase, errors) {
-    const env = expectOptionalObject(profile, `codex.profiles.${phase}.env`, errors);
-    if (!env) {
-        return;
-    }
-    const keys = Object.keys(env);
-    if (keys.some((key) => !/^[A-Z_][A-Z0-9_]*$/.test(key))) {
-        errors.push(`codex.profiles.${phase}.env must contain valid environment variable names`);
-    }
-    const forbidden = keys.find((key) => forbiddenCodexProfileEnvKeys.has(key));
-    if (forbidden) {
-        errors.push(`codex.profiles.${phase}.env must not contain forbidden key ${forbidden}`);
-    }
-    for (const [key, value] of Object.entries(env)) {
-        if (typeof value !== 'string') {
-            errors.push(`codex.profiles.${phase}.env.${key} must be a string`);
-        }
-    }
-}
-function validateCodexFigmaMcp(codex, errors) {
-    const figmaMcp = expectOptionalObject(codex, 'codex.figmaMcp', errors);
-    if (!figmaMcp) {
-        return;
-    }
-    expectBoolean(figmaMcp, 'codex.figmaMcp.enabled', errors);
-    expectString(figmaMcp, 'codex.figmaMcp.url', errors);
-    const hasLegacyPatterns = Array.isArray(figmaMcp.issueTextPatterns);
-    if (hasLegacyPatterns) {
-        expectStringArray(figmaMcp, 'codex.figmaMcp.issueTextPatterns', errors);
-        validateRegexArray(figmaMcp, 'codex.figmaMcp.issueTextPatterns', errors);
-    }
-    else {
-        expectStringArray(figmaMcp, 'codex.figmaMcp.optionalIssueTextPatterns', errors);
-        validateRegexArray(figmaMcp, 'codex.figmaMcp.optionalIssueTextPatterns', errors);
-        expectStringArray(figmaMcp, 'codex.figmaMcp.requiredIssueTextPatterns', errors);
-        validateRegexArray(figmaMcp, 'codex.figmaMcp.requiredIssueTextPatterns', errors);
-    }
-    if ('optionalFailure' in figmaMcp) {
-        expectLiteral(figmaMcp, 'codex.figmaMcp.optionalFailure', 'retry-without-mcp', errors);
-    }
-    if ('requiredFailure' in figmaMcp) {
-        expectLiteral(figmaMcp, 'codex.figmaMcp.requiredFailure', 'block', errors);
-    }
-    const httpHeaders = expectObject(figmaMcp, 'codex.figmaMcp.httpHeaders', errors);
-    if (!httpHeaders) {
-        return;
-    }
-    for (const [key, value] of Object.entries(httpHeaders)) {
-        if (key.length === 0 || typeof value !== 'string' || value.length === 0) {
-            errors.push('codex.figmaMcp.httpHeaders must map non-empty names to non-empty string values');
-        }
-    }
-}
-function validateChecksPolicy(policy, errors) {
-    if ('missingNpmScript' in policy) {
-        expectUnion(policy, 'checksPolicy.missingNpmScript', ['fail', 'skip'], errors);
-    }
-    const lintBaseline = 'lintBaseline' in policy ? asObject(policy.lintBaseline) : undefined;
-    if ('lintBaseline' in policy && !lintBaseline) {
-        errors.push('checksPolicy.lintBaseline must be an object');
-        return;
-    }
-    if (lintBaseline) {
-        if ('mode' in lintBaseline) {
-            expectUnion(lintBaseline, 'checksPolicy.lintBaseline.mode', ['strict', 'touched-only'], errors);
-        }
-        if ('touchedFilesCommand' in lintBaseline) {
-            expectString(lintBaseline, 'checksPolicy.lintBaseline.touchedFilesCommand', errors);
-        }
-    }
-    const scope = 'scope' in policy ? asObject(policy.scope) : undefined;
-    if ('scope' in policy && !scope) {
-        errors.push('checksPolicy.scope must be an object');
-        return;
-    }
-    if (scope) {
-        validateChecksPolicyScope(scope, errors);
-    }
-}
-function validateChecksPolicyScope(scope, errors) {
-    for (const [checkName, rawRule] of Object.entries(scope)) {
-        if (checkName.length === 0) {
-            errors.push('checksPolicy.scope must map non-empty check names to objects');
-            continue;
-        }
-        const rule = asObject(rawRule);
-        if (!rule) {
-            errors.push(`checksPolicy.scope.${checkName} must be an object`);
-            continue;
-        }
-        if ('phases' in rule) {
-            const phases = expectOptionalStringArray(rule, `checksPolicy.scope.${checkName}.phases`, errors);
-            if (phases && phases.some((phase) => !checkExecutionPhaseKeys.includes(phase))) {
-                errors.push(`checksPolicy.scope.${checkName}.phases must contain only ${checkExecutionPhaseKeys.join(', ')}`);
-            }
-        }
-        if ('changedPathGlobs' in rule) {
-            expectOptionalStringArray(rule, `checksPolicy.scope.${checkName}.changedPathGlobs`, errors);
-        }
-    }
-}
-function validateReviewGates(parent, errors) {
-    const acceptanceProof = expectObject(parent, 'reviewGates.acceptanceProof', errors);
-    if (acceptanceProof) {
-        expectBoolean(acceptanceProof, 'reviewGates.acceptanceProof.enabled', errors);
-        expectUnion(acceptanceProof, 'reviewGates.acceptanceProof.proofStrategy', acceptanceProofStrategies, errors);
-        expectString(acceptanceProof, 'reviewGates.acceptanceProof.artifactDir', errors);
-        expectStringArray(acceptanceProof, 'reviewGates.acceptanceProof.issueTextPatterns', errors);
-        expectStringArray(acceptanceProof, 'reviewGates.acceptanceProof.changedPathGlobs', errors);
-        expectStringArray(acceptanceProof, 'reviewGates.acceptanceProof.proofOwnedPathGlobs', errors);
-        expectPositiveInteger(acceptanceProof, 'reviewGates.acceptanceProof.maxIterations', errors);
-        expectOptionalString(acceptanceProof, 'reviewGates.acceptanceProof.runnerValidationCommand', errors);
-        expectOptionalPositiveInteger(acceptanceProof, 'reviewGates.acceptanceProof.runnerTimeoutMs', errors);
-        expectOptionalStringArray(acceptanceProof, 'reviewGates.acceptanceProof.envPassthrough', errors);
-        validateBrowserProofConfig(acceptanceProof, errors);
-        validateEnvironmentVariableNames(acceptanceProof, 'reviewGates.acceptanceProof.envPassthrough', errors);
-        validateRegexArray(acceptanceProof, 'reviewGates.acceptanceProof.issueTextPatterns', errors);
-    }
-    const visualProof = expectObject(parent, 'reviewGates.visualProof', errors);
-    if (visualProof) {
-        expectBoolean(visualProof, 'reviewGates.visualProof.enabled', errors);
-        expectString(visualProof, 'reviewGates.visualProof.artifactDir', errors);
-        expectStringArray(visualProof, 'reviewGates.visualProof.issueTextPatterns', errors);
-        expectStringArray(visualProof, 'reviewGates.visualProof.changedPathGlobs', errors);
-        expectStringArray(visualProof, 'reviewGates.visualProof.requiredValidationPatterns', errors);
-        expectStringArray(visualProof, 'reviewGates.visualProof.blockOnSkippedPatterns', errors);
-        expectPositiveInteger(visualProof, 'reviewGates.visualProof.minScreenshotArtifacts', errors);
-        expectOptionalBoolean(visualProof, 'reviewGates.visualProof.requireWhenDesirable', errors);
-        expectOptionalString(visualProof, 'reviewGates.visualProof.runnerValidationCommand', errors);
-        expectOptionalPositiveInteger(visualProof, 'reviewGates.visualProof.runnerTimeoutMs', errors);
-        expectOptionalStringArray(visualProof, 'reviewGates.visualProof.envPassthrough', errors);
-        validateEnvironmentVariableNames(visualProof, 'reviewGates.visualProof.envPassthrough', errors);
-        validateRegexArray(visualProof, 'reviewGates.visualProof.issueTextPatterns', errors);
-        validateRegexArray(visualProof, 'reviewGates.visualProof.requiredValidationPatterns', errors);
-        validateRegexArray(visualProof, 'reviewGates.visualProof.blockOnSkippedPatterns', errors);
-    }
-    validateQualityGate(parent, errors);
-    validateRiskRoutingGate(parent, errors);
-}
-function validateRiskRoutingGate(parent, errors) {
-    const riskRouting = expectOptionalObject(parent, 'reviewGates.riskRouting', errors);
-    if (!riskRouting) {
-        return;
-    }
-    expectBoolean(riskRouting, 'reviewGates.riskRouting.enabled', errors);
-    expectUnion(riskRouting, 'reviewGates.riskRouting.mode', ['warn', 'block'], errors);
-    expectBoolean(riskRouting, 'reviewGates.riskRouting.requireScopedReviewHandoff', errors);
-    expectBoolean(riskRouting, 'reviewGates.riskRouting.requireParentSizeRisk', errors);
-    expectBoolean(riskRouting, 'reviewGates.riskRouting.requireParentReviewHandoff', errors);
-    expectStringArray(riskRouting, 'reviewGates.riskRouting.riskyChangedPathGlobs', errors);
-    expectBoolean(riskRouting, 'reviewGates.riskRouting.highRiskRequiresCodeReview', errors);
-    expectReviewHandoffFlows(riskRouting, errors);
-}
-function validateBrowserProofConfig(acceptanceProof, errors) {
-    const browserProof = expectOptionalObject(acceptanceProof, 'reviewGates.acceptanceProof.browserProof', errors);
-    if (!browserProof) {
-        return;
-    }
-    expectOptionalString(browserProof, 'reviewGates.acceptanceProof.browserProof.scenarioPath', errors);
-    expectOptionalString(browserProof, 'reviewGates.acceptanceProof.browserProof.baseUrl', errors);
-    expectBoolean(browserProof, 'reviewGates.acceptanceProof.browserProof.strictConsoleErrors', errors);
-    expectBoolean(browserProof, 'reviewGates.acceptanceProof.browserProof.strictNetworkFailures', errors);
-}
-function validateLoopPolicy(parent, errors) {
-    const issueSelection = expectObject(parent, 'loopPolicy.issueSelection', errors);
-    if (issueSelection) {
-        expectStringArray(issueSelection, 'loopPolicy.issueSelection.priorityLabels', errors);
-        expectUnion(issueSelection, 'loopPolicy.issueSelection.tieBreaker', ['issue-number-asc'], errors);
-    }
-    const rework = expectObject(parent, 'loopPolicy.rework', errors);
-    if (rework) {
-        expectNonNegativeInteger(rework, 'loopPolicy.rework.maxAttempts', errors);
-        expectRetryableBlockers(rework, errors);
-    }
-    const freshContextReview = expectObject(parent, 'loopPolicy.freshContextReview', errors);
-    if (freshContextReview) {
-        expectBoolean(freshContextReview, 'loopPolicy.freshContextReview.enabled', errors);
-        expectUnion(freshContextReview, 'loopPolicy.freshContextReview.mode', ['advisory'], errors);
-        expectBoolean(freshContextReview, 'loopPolicy.freshContextReview.blockOnHighConfidencePolicyViolations', errors);
-    }
-    const durableRunSummaries = expectObject(parent, 'loopPolicy.durableRunSummaries', errors);
-    if (durableRunSummaries) {
-        expectBoolean(durableRunSummaries, 'loopPolicy.durableRunSummaries.enabled', errors);
-    }
-    const policySuggestions = expectObject(parent, 'loopPolicy.policySuggestions', errors);
-    if (policySuggestions) {
-        expectBoolean(policySuggestions, 'loopPolicy.policySuggestions.enabled', errors);
-        expectPositiveInteger(policySuggestions, 'loopPolicy.policySuggestions.maxSuggestions', errors);
-    }
-}
-function validateQualityGate(parent, errors) {
-    const quality = expectObject(parent, 'reviewGates.quality', errors);
-    if (!quality) {
-        return;
-    }
-    expectBoolean(quality, 'reviewGates.quality.enabled', errors);
-    expectStringArray(quality, 'reviewGates.quality.runtimeChangedPathGlobs', errors);
-    expectStringArray(quality, 'reviewGates.quality.testChangedPathGlobs', errors);
-    const tdd = expectObject(quality, 'reviewGates.quality.tdd', errors);
-    if (tdd) {
-        expectBoolean(tdd, 'reviewGates.quality.tdd.enabled', errors);
-        expectBoolean(tdd, 'reviewGates.quality.tdd.requireTestChange', errors);
-        expectStringArray(tdd, 'reviewGates.quality.tdd.requiredValidationPatterns', errors);
-        validateRegexArray(tdd, 'reviewGates.quality.tdd.requiredValidationPatterns', errors);
-    }
-    const cleanupReview = expectObject(quality, 'reviewGates.quality.cleanupReview', errors);
-    if (cleanupReview) {
-        expectBoolean(cleanupReview, 'reviewGates.quality.cleanupReview.enabled', errors);
-        expectPositiveInteger(cleanupReview, 'reviewGates.quality.cleanupReview.runtimeFileThreshold', errors);
-        expectStringArray(cleanupReview, 'reviewGates.quality.cleanupReview.requiredValidationPatterns', errors);
-        validateRegexArray(cleanupReview, 'reviewGates.quality.cleanupReview.requiredValidationPatterns', errors);
-    }
-    const codeReview = expectObject(quality, 'reviewGates.quality.codeReview', errors);
-    if (codeReview) {
-        expectBoolean(codeReview, 'reviewGates.quality.codeReview.enabled', errors);
-        expectStringArray(codeReview, 'reviewGates.quality.codeReview.requiredValidationPatterns', errors);
-        validateRegexArray(codeReview, 'reviewGates.quality.codeReview.requiredValidationPatterns', errors);
-    }
-}
-function validateWorktreeCleanup(parent, errors) {
-    const value = readPath(parent, 'runner.worktreeCleanup');
-    if (value === undefined) {
-        return;
-    }
-    const worktreeCleanup = asObject(value);
-    if (!worktreeCleanup) {
-        errors.push('runner.worktreeCleanup must be an object when provided');
-        return;
-    }
-    expectBoolean(worktreeCleanup, 'runner.worktreeCleanup.enabled', errors);
-}
-function validateResolutionMission(parent, errors) {
-    const resolutionMission = expectOptionalObject(parent, 'runner.resolutionMission', errors);
-    if (!resolutionMission) {
-        return;
-    }
-    const mode = readPath(resolutionMission, 'runner.resolutionMission.mode');
-    if (mode !== 'off' && mode !== 'shadow' && mode !== 'enabled') {
-        errors.push('runner.resolutionMission.mode must be off, shadow, or enabled');
-    }
-    const markerLabel = expectString(resolutionMission, 'runner.resolutionMission.markerLabel', errors);
-    if (markerLabel !== undefined && markerLabel.trim().length === 0) {
-        errors.push('runner.resolutionMission.markerLabel must contain non-whitespace characters');
-    }
-}
-function expectOptionalString(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value !== 'string') {
-        errors.push(`${path} must be a string when provided`);
-        return undefined;
-    }
-    return value;
-}
-function expectPositiveInteger(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (!Number.isInteger(value) || typeof value !== 'number' || value < 1) {
-        errors.push(`${path} must be a positive integer`);
-        return undefined;
-    }
-    return value;
-}
-function expectNonNegativeInteger(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (!Number.isInteger(value) || typeof value !== 'number' || value < 0) {
-        errors.push(`${path} must be a non-negative integer`);
-        return undefined;
-    }
-    return value;
-}
-function expectRetryableBlockers(parent, errors) {
-    const validBlockers = [
-        'missing-completion-report',
-        'idle-timeout-before-change',
-        'incomplete-after-progress',
-        'invalid-completion-report',
-        'no-changed-files',
-        'failed-configured-checks',
-        'missing-quality-gate-evidence',
-        'failed-acceptance-proof',
-        'risk-routing-policy',
-        'optional-figma-mcp-failure',
-    ];
-    const value = readPath(parent, 'loopPolicy.rework.retryableBlockers');
-    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string' || !validBlockers.includes(item))) {
-        errors.push(`loopPolicy.rework.retryableBlockers must contain only ${validBlockers.join(', ')}`);
-        return undefined;
-    }
-    return value;
-}
-function expectReviewHandoffFlows(parent, errors) {
-    const value = readPath(parent, 'reviewGates.riskRouting.allowedLowRiskFlows');
-    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string' || !reviewHandoffFlows.includes(item))) {
-        errors.push(`reviewGates.riskRouting.allowedLowRiskFlows must contain only ${reviewHandoffFlows.join(', ')}`);
-        return undefined;
-    }
-    return value;
-}
-function expectOptionalPositiveInteger(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (value === undefined) {
-        return undefined;
-    }
-    if (!Number.isInteger(value) || typeof value !== 'number' || value < 1) {
-        errors.push(`${path} must be a positive integer when provided`);
-        return undefined;
-    }
-    return value;
-}
-function validateRegexArray(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (!Array.isArray(value)) {
-        return;
-    }
-    for (const pattern of value) {
-        if (typeof pattern !== 'string') {
-            continue;
-        }
-        try {
-            new RegExp(pattern, 'iu');
-        }
-        catch {
-            errors.push(`${path} contains invalid regular expression ${pattern}`);
-        }
-    }
-}
-function validateEnvironmentVariableNames(parent, path, errors) {
-    const value = readPath(parent, path);
-    if (!Array.isArray(value)) {
-        return;
-    }
-    const hasInvalidName = value.some((name) => typeof name === 'string' && !/^[A-Z_][A-Z0-9_]*$/u.test(name));
-    if (hasInvalidName) {
-        errors.push(`${path} must contain valid environment variable names`);
-    }
-}
-//# sourceMappingURL=schema.js.map