iosm-cli 0.1.0

package/dist/iosm/config.js

@@ -0,0 +1,323 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { parse } from "yaml";
+import { IOSM_METRICS } from "./metrics.js";
+import { getIosmConfigPath } from "./paths.js";
+function expectObject(value, path) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`Expected object at ${path}`);
+    }
+    return value;
+}
+function expectString(value, path) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`Expected non-empty string at ${path}`);
+    }
+    return value;
+}
+function expectBoolean(value, path) {
+    if (typeof value !== "boolean") {
+        throw new Error(`Expected boolean at ${path}`);
+    }
+    return value;
+}
+function expectNumber(value, path) {
+    if (typeof value !== "number" || Number.isNaN(value) || !Number.isFinite(value)) {
+        throw new Error(`Expected finite number at ${path}`);
+    }
+    return value;
+}
+function expectInteger(value, path) {
+    const number = expectNumber(value, path);
+    if (!Number.isInteger(number)) {
+        throw new Error(`Expected integer at ${path}`);
+    }
+    return number;
+}
+function expectStringArray(value, path) {
+    if (!Array.isArray(value)) {
+        throw new Error(`Expected array at ${path}`);
+    }
+    return value.map((entry, index) => expectString(entry, `${path}[${index}]`));
+}
+function assertUnitInterval(value, path) {
+    if (value < 0 || value > 1) {
+        throw new Error(`Expected ${path} to be in [0.0, 1.0], received ${value}`);
+    }
+}
+function assertPositiveInteger(value, path) {
+    if (!Number.isInteger(value) || value < 1) {
+        throw new Error(`Expected ${path} to be an integer >= 1, received ${value}`);
+    }
+}
+function assertNonNegativeInteger(value, path) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`Expected ${path} to be an integer >= 0, received ${value}`);
+    }
+}
+function assertNonNegative(value, path) {
+    if (value < 0) {
+        throw new Error(`Expected ${path} to be >= 0, received ${value}`);
+    }
+}
+function parseMetricNumberRecord(value, path) {
+    const object = expectObject(value, path);
+    return {
+        semantic: expectNumber(object.semantic, `${path}.semantic`),
+        logic: expectNumber(object.logic, `${path}.logic`),
+        performance: expectNumber(object.performance, `${path}.performance`),
+        simplicity: expectNumber(object.simplicity, `${path}.simplicity`),
+        modularity: expectNumber(object.modularity, `${path}.modularity`),
+        flow: expectNumber(object.flow, `${path}.flow`),
+    };
+}
+function parseMetricFloorRecord(value, path) {
+    const object = expectObject(value, path);
+    const result = {};
+    for (const metric of IOSM_METRICS) {
+        const metricValue = object[metric];
+        if (metricValue !== undefined) {
+            result[metric] = expectNumber(metricValue, `${path}.${metric}`);
+        }
+    }
+    return result;
+}
+function validateMetricIntervals(values, path) {
+    for (const metric of IOSM_METRICS) {
+        const value = values[metric];
+        if (value !== undefined) {
+            assertUnitInterval(value, `${path}.${metric}`);
+        }
+    }
+}
+function validateMetricRecord(values, path) {
+    for (const metric of IOSM_METRICS) {
+        assertUnitInterval(values[metric], `${path}.${metric}`);
+    }
+}
+export function findIosmRootDir(startDir = process.cwd()) {
+    let currentDir = resolve(startDir);
+    while (true) {
+        if (existsSync(getIosmConfigPath(currentDir))) {
+            return currentDir;
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            return undefined;
+        }
+        currentDir = parentDir;
+    }
+}
+export function resolveIosmRootDir(startDir = process.cwd()) {
+    const rootDir = findIosmRootDir(startDir);
+    if (!rootDir) {
+        throw new Error(`Missing iosm.yaml in ${resolve(startDir)} or its parent directories. Run "iosm init" first.`);
+    }
+    return rootDir;
+}
+export function loadIosmConfig(cwd = process.cwd()) {
+    const rootDir = resolveIosmRootDir(cwd);
+    const path = getIosmConfigPath(rootDir);
+    const contents = readFileSync(path, "utf8");
+    const parsed = parse(contents);
+    const document = expectObject(parsed, "config");
+    const iosm = expectObject(document.iosm, "iosm");
+    const metadataObject = expectObject(iosm.metadata, "iosm.metadata");
+    const planningObject = expectObject(iosm.planning, "iosm.planning");
+    const cycleCapacityObject = expectObject(iosm.cycle_capacity, "iosm.cycle_capacity");
+    const cyclePolicyObject = expectObject(iosm.cycle_policy, "iosm.cycle_policy");
+    const stabilizationObject = expectObject(cyclePolicyObject.stabilization, "iosm.cycle_policy.stabilization");
+    const qualityGatesObject = expectObject(iosm.quality_gates, "iosm.quality_gates");
+    const gateIObject = expectObject(qualityGatesObject.gate_I, "iosm.quality_gates.gate_I");
+    const gateOObject = expectObject(qualityGatesObject.gate_O, "iosm.quality_gates.gate_O");
+    const gateOLatencyObject = expectObject(gateOObject.latency_ms, "iosm.quality_gates.gate_O.latency_ms");
+    const gateSObject = expectObject(qualityGatesObject.gate_S, "iosm.quality_gates.gate_S");
+    const gateMObject = expectObject(qualityGatesObject.gate_M, "iosm.quality_gates.gate_M");
+    const guardrailsObject = expectObject(iosm.guardrails, "iosm.guardrails");
+    const evidenceObject = expectObject(iosm.evidence, "iosm.evidence");
+    const freshnessObject = expectObject(evidenceObject.freshness_sla_hours, "iosm.evidence.freshness_sla_hours");
+    const waiversObject = expectObject(iosm.waivers, "iosm.waivers");
+    const metricTargetsObject = expectObject(iosm.metric_targets, "iosm.metric_targets");
+    const semanticTargetsObject = expectObject(metricTargetsObject.semantic, "iosm.metric_targets.semantic");
+    const logicTargetsObject = expectObject(metricTargetsObject.logic, "iosm.metric_targets.logic");
+    const performanceTargetsObject = expectObject(metricTargetsObject.performance, "iosm.metric_targets.performance");
+    const performanceLatencyObject = expectObject(performanceTargetsObject.latency_ms, "iosm.metric_targets.performance.latency_ms");
+    const simplicityTargetsObject = expectObject(metricTargetsObject.simplicity, "iosm.metric_targets.simplicity");
+    const modularityTargetsObject = expectObject(metricTargetsObject.modularity, "iosm.metric_targets.modularity");
+    const flowTargetsObject = expectObject(metricTargetsObject.flow, "iosm.metric_targets.flow");
+    const indexObject = expectObject(iosm.index, "iosm.index");
+    const automationObject = expectObject(iosm.automation, "iosm.automation");
+    const reportingObject = expectObject(iosm.reporting, "iosm.reporting");
+    const learningObject = expectObject(iosm.learning, "iosm.learning");
+    const config = {
+        iosm: {
+            metadata: {
+                system_name: expectString(metadataObject.system_name, "iosm.metadata.system_name"),
+                scope: expectString(metadataObject.scope, "iosm.metadata.scope"),
+                criticality_profile: expectString(metadataObject.criticality_profile, "iosm.metadata.criticality_profile"),
+                delivery_boundary: expectString(metadataObject.delivery_boundary, "iosm.metadata.delivery_boundary"),
+            },
+            planning: {
+                use_economic_decision: expectBoolean(planningObject.use_economic_decision, "iosm.planning.use_economic_decision"),
+                prioritization_formula: expectString(planningObject.prioritization_formula, "iosm.planning.prioritization_formula"),
+                min_confidence: expectNumber(planningObject.min_confidence, "iosm.planning.min_confidence"),
+                hypothesis_required: expectBoolean(planningObject.hypothesis_required, "iosm.planning.hypothesis_required"),
+                cycle_scope_required: expectBoolean(planningObject.cycle_scope_required, "iosm.planning.cycle_scope_required"),
+            },
+            cycle_capacity: {
+                max_goals: expectInteger(cycleCapacityObject.max_goals, "iosm.cycle_capacity.max_goals"),
+                max_scope_items: expectInteger(cycleCapacityObject.max_scope_items, "iosm.cycle_capacity.max_scope_items"),
+                max_expected_change_surface: expectInteger(cycleCapacityObject.max_expected_change_surface, "iosm.cycle_capacity.max_expected_change_surface"),
+            },
+            cycle_policy: {
+                max_iterations_per_phase: expectInteger(cyclePolicyObject.max_iterations_per_phase, "iosm.cycle_policy.max_iterations_per_phase"),
+                stabilization: {
+                    target_index: expectNumber(stabilizationObject.target_index, "iosm.cycle_policy.stabilization.target_index"),
+                    consecutive_cycles: expectInteger(stabilizationObject.consecutive_cycles, "iosm.cycle_policy.stabilization.consecutive_cycles"),
+                    global_metric_floor: expectNumber(stabilizationObject.global_metric_floor, "iosm.cycle_policy.stabilization.global_metric_floor"),
+                    max_consecutive_unexplained_declines: expectInteger(stabilizationObject.max_consecutive_unexplained_declines, "iosm.cycle_policy.stabilization.max_consecutive_unexplained_declines"),
+                    metric_floors: parseMetricFloorRecord(stabilizationObject.metric_floors, "iosm.cycle_policy.stabilization.metric_floors"),
+                },
+            },
+            quality_gates: {
+                gate_I: {
+                    semantic_min: expectNumber(gateIObject.semantic_min, "iosm.quality_gates.gate_I.semantic_min"),
+                    logical_consistency_min: expectNumber(gateIObject.logical_consistency_min, "iosm.quality_gates.gate_I.logical_consistency_min"),
+                    duplication_max: expectNumber(gateIObject.duplication_max, "iosm.quality_gates.gate_I.duplication_max"),
+                },
+                gate_O: {
+                    latency_ms: {
+                        p50_max: expectNumber(gateOLatencyObject.p50_max, "iosm.quality_gates.gate_O.latency_ms.p50_max"),
+                        p95_max: expectNumber(gateOLatencyObject.p95_max, "iosm.quality_gates.gate_O.latency_ms.p95_max"),
+                        p99_max: expectNumber(gateOLatencyObject.p99_max, "iosm.quality_gates.gate_O.latency_ms.p99_max"),
+                    },
+                    error_budget_respected: expectBoolean(gateOObject.error_budget_respected, "iosm.quality_gates.gate_O.error_budget_respected"),
+                    chaos_pass_rate_min: expectNumber(gateOObject.chaos_pass_rate_min, "iosm.quality_gates.gate_O.chaos_pass_rate_min"),
+                },
+                gate_S: {
+                    at_least_one_dimension: expectBoolean(gateSObject.at_least_one_dimension, "iosm.quality_gates.gate_S.at_least_one_dimension"),
+                    api_surface_reduction_min: expectNumber(gateSObject.api_surface_reduction_min, "iosm.quality_gates.gate_S.api_surface_reduction_min"),
+                    dependency_hygiene_min: expectNumber(gateSObject.dependency_hygiene_min, "iosm.quality_gates.gate_S.dependency_hygiene_min"),
+                    onboarding_time_minutes_max: expectNumber(gateSObject.onboarding_time_minutes_max, "iosm.quality_gates.gate_S.onboarding_time_minutes_max"),
+                    regression_budget_max: expectInteger(gateSObject.regression_budget_max, "iosm.quality_gates.gate_S.regression_budget_max"),
+                },
+                gate_M: {
+                    change_surface_max: expectInteger(gateMObject.change_surface_max, "iosm.quality_gates.gate_M.change_surface_max"),
+                    coupling_max: expectNumber(gateMObject.coupling_max, "iosm.quality_gates.gate_M.coupling_max"),
+                    cohesion_min: expectNumber(gateMObject.cohesion_min, "iosm.quality_gates.gate_M.cohesion_min"),
+                    contracts_pass: expectBoolean(gateMObject.contracts_pass, "iosm.quality_gates.gate_M.contracts_pass"),
+                },
+            },
+            guardrails: {
+                max_negative_delta: parseMetricNumberRecord(guardrailsObject.max_negative_delta, "iosm.guardrails.max_negative_delta"),
+            },
+            evidence: {
+                min_decision_confidence: expectNumber(evidenceObject.min_decision_confidence, "iosm.evidence.min_decision_confidence"),
+                freshness_sla_hours: {
+                    tier_a: expectInteger(freshnessObject.tier_a, "iosm.evidence.freshness_sla_hours.tier_a"),
+                    tier_b: expectInteger(freshnessObject.tier_b, "iosm.evidence.freshness_sla_hours.tier_b"),
+                },
+                min_metric_confidence: parseMetricNumberRecord(evidenceObject.min_metric_confidence, "iosm.evidence.min_metric_confidence"),
+            },
+            waivers: {
+                max_duration_days: expectInteger(waiversObject.max_duration_days, "iosm.waivers.max_duration_days"),
+                require_human_approval: expectBoolean(waiversObject.require_human_approval, "iosm.waivers.require_human_approval"),
+            },
+            metric_targets: {
+                semantic: {
+                    glossary_coverage_min: expectNumber(semanticTargetsObject.glossary_coverage_min, "iosm.metric_targets.semantic.glossary_coverage_min"),
+                    naming_consistency_min: expectNumber(semanticTargetsObject.naming_consistency_min, "iosm.metric_targets.semantic.naming_consistency_min"),
+                    ambiguity_ratio_max: expectNumber(semanticTargetsObject.ambiguity_ratio_max, "iosm.metric_targets.semantic.ambiguity_ratio_max"),
+                },
+                logic: {
+                    invariant_pass_rate_min: expectNumber(logicTargetsObject.invariant_pass_rate_min, "iosm.metric_targets.logic.invariant_pass_rate_min"),
+                },
+                performance: {
+                    latency_ms: {
+                        p50_max: expectNumber(performanceLatencyObject.p50_max, "iosm.metric_targets.performance.latency_ms.p50_max"),
+                        p95_max: expectNumber(performanceLatencyObject.p95_max, "iosm.metric_targets.performance.latency_ms.p95_max"),
+                        p99_max: expectNumber(performanceLatencyObject.p99_max, "iosm.metric_targets.performance.latency_ms.p99_max"),
+                    },
+                },
+                simplicity: {
+                    onboarding_time_minutes_max: expectNumber(simplicityTargetsObject.onboarding_time_minutes_max, "iosm.metric_targets.simplicity.onboarding_time_minutes_max"),
+                },
+                modularity: {
+                    change_surface_max: expectInteger(modularityTargetsObject.change_surface_max, "iosm.metric_targets.modularity.change_surface_max"),
+                },
+                flow: {
+                    lead_time_hours_max: expectNumber(flowTargetsObject.lead_time_hours_max, "iosm.metric_targets.flow.lead_time_hours_max"),
+                    deploy_frequency_per_week_min: expectNumber(flowTargetsObject.deploy_frequency_per_week_min, "iosm.metric_targets.flow.deploy_frequency_per_week_min"),
+                    change_failure_rate_max: expectNumber(flowTargetsObject.change_failure_rate_max, "iosm.metric_targets.flow.change_failure_rate_max"),
+                    review_latency_hours_max: expectNumber(flowTargetsObject.review_latency_hours_max, "iosm.metric_targets.flow.review_latency_hours_max"),
+                },
+            },
+            index: {
+                weights: parseMetricNumberRecord(indexObject.weights, "iosm.index.weights"),
+            },
+            automation: {
+                allow_agents: expectBoolean(automationObject.allow_agents, "iosm.automation.allow_agents"),
+                human_approval_required_for: expectStringArray(automationObject.human_approval_required_for, "iosm.automation.human_approval_required_for"),
+            },
+            reporting: {
+                persist_history: expectBoolean(reportingObject.persist_history, "iosm.reporting.persist_history"),
+                output_format: expectString(reportingObject.output_format, "iosm.reporting.output_format"),
+            },
+            learning: {
+                update_pattern_library: expectBoolean(learningObject.update_pattern_library, "iosm.learning.update_pattern_library"),
+                update_decision_log: expectBoolean(learningObject.update_decision_log, "iosm.learning.update_decision_log"),
+                update_glossary: expectBoolean(learningObject.update_glossary, "iosm.learning.update_glossary"),
+            },
+        },
+    };
+    if (!["exploratory", "standard", "critical"].includes(config.iosm.metadata.criticality_profile)) {
+        throw new Error(`Unsupported iosm.metadata.criticality_profile: ${config.iosm.metadata.criticality_profile}`);
+    }
+    assertUnitInterval(config.iosm.planning.min_confidence, "iosm.planning.min_confidence");
+    if (!config.iosm.planning.cycle_scope_required) {
+        throw new Error("iosm.planning.cycle_scope_required must be true");
+    }
+    assertPositiveInteger(config.iosm.cycle_capacity.max_goals, "iosm.cycle_capacity.max_goals");
+    assertPositiveInteger(config.iosm.cycle_capacity.max_scope_items, "iosm.cycle_capacity.max_scope_items");
+    assertPositiveInteger(config.iosm.cycle_capacity.max_expected_change_surface, "iosm.cycle_capacity.max_expected_change_surface");
+    assertPositiveInteger(config.iosm.cycle_policy.max_iterations_per_phase, "iosm.cycle_policy.max_iterations_per_phase");
+    assertUnitInterval(config.iosm.cycle_policy.stabilization.target_index, "iosm.cycle_policy.stabilization.target_index");
+    assertPositiveInteger(config.iosm.cycle_policy.stabilization.consecutive_cycles, "iosm.cycle_policy.stabilization.consecutive_cycles");
+    assertUnitInterval(config.iosm.cycle_policy.stabilization.global_metric_floor, "iosm.cycle_policy.stabilization.global_metric_floor");
+    assertNonNegativeInteger(config.iosm.cycle_policy.stabilization.max_consecutive_unexplained_declines, "iosm.cycle_policy.stabilization.max_consecutive_unexplained_declines");
+    validateMetricIntervals(config.iosm.cycle_policy.stabilization.metric_floors, "iosm.cycle_policy.stabilization.metric_floors");
+    assertUnitInterval(config.iosm.quality_gates.gate_I.semantic_min, "iosm.quality_gates.gate_I.semantic_min");
+    assertUnitInterval(config.iosm.quality_gates.gate_I.logical_consistency_min, "iosm.quality_gates.gate_I.logical_consistency_min");
+    assertUnitInterval(config.iosm.quality_gates.gate_I.duplication_max, "iosm.quality_gates.gate_I.duplication_max");
+    assertUnitInterval(config.iosm.quality_gates.gate_O.chaos_pass_rate_min, "iosm.quality_gates.gate_O.chaos_pass_rate_min");
+    assertUnitInterval(config.iosm.quality_gates.gate_S.api_surface_reduction_min, "iosm.quality_gates.gate_S.api_surface_reduction_min");
+    assertUnitInterval(config.iosm.quality_gates.gate_S.dependency_hygiene_min, "iosm.quality_gates.gate_S.dependency_hygiene_min");
+    assertNonNegative(config.iosm.quality_gates.gate_S.onboarding_time_minutes_max, "iosm.quality_gates.gate_S.onboarding_time_minutes_max");
+    assertNonNegativeInteger(config.iosm.quality_gates.gate_S.regression_budget_max, "iosm.quality_gates.gate_S.regression_budget_max");
+    assertPositiveInteger(config.iosm.quality_gates.gate_M.change_surface_max, "iosm.quality_gates.gate_M.change_surface_max");
+    assertUnitInterval(config.iosm.quality_gates.gate_M.coupling_max, "iosm.quality_gates.gate_M.coupling_max");
+    assertUnitInterval(config.iosm.quality_gates.gate_M.cohesion_min, "iosm.quality_gates.gate_M.cohesion_min");
+    validateMetricRecord(config.iosm.guardrails.max_negative_delta, "iosm.guardrails.max_negative_delta");
+    assertUnitInterval(config.iosm.evidence.min_decision_confidence, "iosm.evidence.min_decision_confidence");
+    validateMetricRecord(config.iosm.evidence.min_metric_confidence, "iosm.evidence.min_metric_confidence");
+    assertPositiveInteger(config.iosm.evidence.freshness_sla_hours.tier_a, "iosm.evidence.freshness_sla_hours.tier_a");
+    assertPositiveInteger(config.iosm.evidence.freshness_sla_hours.tier_b, "iosm.evidence.freshness_sla_hours.tier_b");
+    assertPositiveInteger(config.iosm.waivers.max_duration_days, "iosm.waivers.max_duration_days");
+    assertUnitInterval(config.iosm.metric_targets.semantic.glossary_coverage_min, "iosm.metric_targets.semantic.glossary_coverage_min");
+    assertUnitInterval(config.iosm.metric_targets.semantic.naming_consistency_min, "iosm.metric_targets.semantic.naming_consistency_min");
+    assertUnitInterval(config.iosm.metric_targets.semantic.ambiguity_ratio_max, "iosm.metric_targets.semantic.ambiguity_ratio_max");
+    assertUnitInterval(config.iosm.metric_targets.logic.invariant_pass_rate_min, "iosm.metric_targets.logic.invariant_pass_rate_min");
+    assertNonNegative(config.iosm.metric_targets.simplicity.onboarding_time_minutes_max, "iosm.metric_targets.simplicity.onboarding_time_minutes_max");
+    assertPositiveInteger(config.iosm.metric_targets.modularity.change_surface_max, "iosm.metric_targets.modularity.change_surface_max");
+    assertNonNegative(config.iosm.metric_targets.flow.lead_time_hours_max, "iosm.metric_targets.flow.lead_time_hours_max");
+    assertNonNegative(config.iosm.metric_targets.flow.deploy_frequency_per_week_min, "iosm.metric_targets.flow.deploy_frequency_per_week_min");
+    assertUnitInterval(config.iosm.metric_targets.flow.change_failure_rate_max, "iosm.metric_targets.flow.change_failure_rate_max");
+    assertNonNegative(config.iosm.metric_targets.flow.review_latency_hours_max, "iosm.metric_targets.flow.review_latency_hours_max");
+    validateMetricRecord(config.iosm.index.weights, "iosm.index.weights");
+    const weightSum = IOSM_METRICS.reduce((sum, metric) => sum + config.iosm.index.weights[metric], 0);
+    if (Math.abs(weightSum - 1) > 0.001) {
+        throw new Error(`iosm.index.weights must sum to 1.0, received ${weightSum.toFixed(3)}`);
+    }
+    return { rootDir, path, config };
+}
+//# sourceMappingURL=config.js.map

package/dist/iosm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/iosm/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { parse } from \"yaml\";\nimport { IOSM_METRICS } from \"./metrics.js\";\nimport { getIosmConfigPath } from \"./paths.js\";\nimport type { IosmMetric, IosmMetricRecord } from \"./types.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\ntype IosmCriticalityProfile = \"exploratory\" | \"standard\" | \"critical\";\n\nexport interface IosmMetadataConfig {\n\tsystem_name: string;\n\tscope: string;\n\tcriticality_profile: IosmCriticalityProfile;\n\tdelivery_boundary: string;\n}\n\nexport interface IosmPlanningConfig {\n\tuse_economic_decision: boolean;\n\tprioritization_formula: string;\n\tmin_confidence: number;\n\thypothesis_required: boolean;\n\tcycle_scope_required: boolean;\n}\n\nexport interface IosmCycleCapacityConfig {\n\tmax_goals: number;\n\tmax_scope_items: number;\n\tmax_expected_change_surface: number;\n}\n\nexport interface IosmStabilizationConfig {\n\ttarget_index: number;\n\tconsecutive_cycles: number;\n\tglobal_metric_floor: number;\n\tmax_consecutive_unexplained_declines: number;\n\tmetric_floors: Partial<IosmMetricRecord<number>>;\n}\n\nexport interface IosmCyclePolicyConfig {\n\tmax_iterations_per_phase: number;\n\tstabilization: IosmStabilizationConfig;\n}\n\nexport interface IosmQualityGateIConfig {\n\tsemantic_min: number;\n\tlogical_consistency_min: number;\n\tduplication_max: number;\n}\n\nexport interface IosmQualityGateOConfig {\n\tlatency_ms: {\n\t\tp50_max: number;\n\t\tp95_max: number;\n\t\tp99_max: number;\n\t};\n\terror_budget_respected: boolean;\n\tchaos_pass_rate_min: number;\n}\n\nexport interface IosmQualityGateSConfig {\n\tat_least_one_dimension: boolean;\n\tapi_surface_reduction_min: number;\n\tdependency_hygiene_min: number;\n\tonboarding_time_minutes_max: number;\n\tregression_budget_max: number;\n}\n\nexport interface IosmQualityGateMConfig {\n\tchange_surface_max: number;\n\tcoupling_max: number;\n\tcohesion_min: number;\n\tcontracts_pass: boolean;\n}\n\nexport interface IosmQualityGatesConfig {\n\tgate_I: IosmQualityGateIConfig;\n\tgate_O: IosmQualityGateOConfig;\n\tgate_S: IosmQualityGateSConfig;\n\tgate_M: IosmQualityGateMConfig;\n}\n\nexport interface IosmGuardrailsConfig {\n\tmax_negative_delta: IosmMetricRecord<number>;\n}\n\nexport interface IosmEvidenceConfig {\n\tmin_decision_confidence: number;\n\tfreshness_sla_hours: {\n\t\ttier_a: number;\n\t\ttier_b: number;\n\t};\n\tmin_metric_confidence: IosmMetricRecord<number>;\n}\n\nexport interface IosmWaiversConfig {\n\tmax_duration_days: number;\n\trequire_human_approval: boolean;\n}\n\nexport interface IosmMetricTargetsConfig {\n\tsemantic: {\n\t\tglossary_coverage_min: number;\n\t\tnaming_consistency_min: number;\n\t\tambiguity_ratio_max: number;\n\t};\n\tlogic: {\n\t\tinvariant_pass_rate_min: number;\n\t};\n\tperformance: {\n\t\tlatency_ms: {\n\t\t\tp50_max: number;\n\t\t\tp95_max: number;\n\t\t\tp99_max: number;\n\t\t};\n\t};\n\tsimplicity: {\n\t\tonboarding_time_minutes_max: number;\n\t};\n\tmodularity: {\n\t\tchange_surface_max: number;\n\t};\n\tflow: {\n\t\tlead_time_hours_max: number;\n\t\tdeploy_frequency_per_week_min: number;\n\t\tchange_failure_rate_max: number;\n\t\treview_latency_hours_max: number;\n\t};\n}\n\nexport interface IosmIndexConfig {\n\tweights: IosmMetricRecord<number>;\n}\n\nexport interface IosmAutomationConfig {\n\tallow_agents: boolean;\n\thuman_approval_required_for: string[];\n}\n\nexport interface IosmReportingConfig {\n\tpersist_history: boolean;\n\toutput_format: string;\n}\n\nexport interface IosmLearningConfig {\n\tupdate_pattern_library: boolean;\n\tupdate_decision_log: boolean;\n\tupdate_glossary: boolean;\n}\n\nexport interface IosmConfigModel {\n\tmetadata: IosmMetadataConfig;\n\tplanning: IosmPlanningConfig;\n\tcycle_capacity: IosmCycleCapacityConfig;\n\tcycle_policy: IosmCyclePolicyConfig;\n\tquality_gates: IosmQualityGatesConfig;\n\tguardrails: IosmGuardrailsConfig;\n\tevidence: IosmEvidenceConfig;\n\twaivers: IosmWaiversConfig;\n\tmetric_targets: IosmMetricTargetsConfig;\n\tindex: IosmIndexConfig;\n\tautomation: IosmAutomationConfig;\n\treporting: IosmReportingConfig;\n\tlearning: IosmLearningConfig;\n}\n\nexport interface IosmConfig {\n\tiosm: IosmConfigModel;\n}\n\nfunction expectObject(value: unknown, path: string): UnknownRecord {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new Error(`Expected object at ${path}`);\n\t}\n\n\treturn value as UnknownRecord;\n}\n\nfunction expectString(value: unknown, path: string): string {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\tthrow new Error(`Expected non-empty string at ${path}`);\n\t}\n\n\treturn value;\n}\n\nfunction expectBoolean(value: unknown, path: string): boolean {\n\tif (typeof value !== \"boolean\") {\n\t\tthrow new Error(`Expected boolean at ${path}`);\n\t}\n\n\treturn value;\n}\n\nfunction expectNumber(value: unknown, path: string): number {\n\tif (typeof value !== \"number\" || Number.isNaN(value) || !Number.isFinite(value)) {\n\t\tthrow new Error(`Expected finite number at ${path}`);\n\t}\n\n\treturn value;\n}\n\nfunction expectInteger(value: unknown, path: string): number {\n\tconst number = expectNumber(value, path);\n\tif (!Number.isInteger(number)) {\n\t\tthrow new Error(`Expected integer at ${path}`);\n\t}\n\n\treturn number;\n}\n\nfunction expectStringArray(value: unknown, path: string): string[] {\n\tif (!Array.isArray(value)) {\n\t\tthrow new Error(`Expected array at ${path}`);\n\t}\n\n\treturn value.map((entry, index) => expectString(entry, `${path}[${index}]`));\n}\n\nfunction assertUnitInterval(value: number, path: string): void {\n\tif (value < 0 || value > 1) {\n\t\tthrow new Error(`Expected ${path} to be in [0.0, 1.0], received ${value}`);\n\t}\n}\n\nfunction assertPositiveInteger(value: number, path: string): void {\n\tif (!Number.isInteger(value) || value < 1) {\n\t\tthrow new Error(`Expected ${path} to be an integer >= 1, received ${value}`);\n\t}\n}\n\nfunction assertNonNegativeInteger(value: number, path: string): void {\n\tif (!Number.isInteger(value) || value < 0) {\n\t\tthrow new Error(`Expected ${path} to be an integer >= 0, received ${value}`);\n\t}\n}\n\nfunction assertNonNegative(value: number, path: string): void {\n\tif (value < 0) {\n\t\tthrow new Error(`Expected ${path} to be >= 0, received ${value}`);\n\t}\n}\n\nfunction parseMetricNumberRecord(value: unknown, path: string): IosmMetricRecord<number> {\n\tconst object = expectObject(value, path);\n\treturn {\n\t\tsemantic: expectNumber(object.semantic, `${path}.semantic`),\n\t\tlogic: expectNumber(object.logic, `${path}.logic`),\n\t\tperformance: expectNumber(object.performance, `${path}.performance`),\n\t\tsimplicity: expectNumber(object.simplicity, `${path}.simplicity`),\n\t\tmodularity: expectNumber(object.modularity, `${path}.modularity`),\n\t\tflow: expectNumber(object.flow, `${path}.flow`),\n\t};\n}\n\nfunction parseMetricFloorRecord(value: unknown, path: string): Partial<IosmMetricRecord<number>> {\n\tconst object = expectObject(value, path);\n\tconst result: Partial<IosmMetricRecord<number>> = {};\n\tfor (const metric of IOSM_METRICS) {\n\t\tconst metricValue = object[metric];\n\t\tif (metricValue !== undefined) {\n\t\t\tresult[metric] = expectNumber(metricValue, `${path}.${metric}`);\n\t\t}\n\t}\n\treturn result;\n}\n\nfunction validateMetricIntervals(values: Partial<IosmMetricRecord<number>>, path: string): void {\n\tfor (const metric of IOSM_METRICS) {\n\t\tconst value = values[metric];\n\t\tif (value !== undefined) {\n\t\t\tassertUnitInterval(value, `${path}.${metric}`);\n\t\t}\n\t}\n}\n\nfunction validateMetricRecord(values: IosmMetricRecord<number>, path: string): void {\n\tfor (const metric of IOSM_METRICS) {\n\t\tassertUnitInterval(values[metric], `${path}.${metric}`);\n\t}\n}\n\nexport function findIosmRootDir(startDir: string = process.cwd()): string | undefined {\n\tlet currentDir = resolve(startDir);\n\twhile (true) {\n\t\tif (existsSync(getIosmConfigPath(currentDir))) {\n\t\t\treturn currentDir;\n\t\t}\n\n\t\tconst parentDir = dirname(currentDir);\n\t\tif (parentDir === currentDir) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tcurrentDir = parentDir;\n\t}\n}\n\nexport function resolveIosmRootDir(startDir: string = process.cwd()): string {\n\tconst rootDir = findIosmRootDir(startDir);\n\tif (!rootDir) {\n\t\tthrow new Error(`Missing iosm.yaml in ${resolve(startDir)} or its parent directories. Run \"iosm init\" first.`);\n\t}\n\treturn rootDir;\n}\n\nexport function loadIosmConfig(cwd: string = process.cwd()): { rootDir: string; path: string; config: IosmConfig } {\n\tconst rootDir = resolveIosmRootDir(cwd);\n\tconst path = getIosmConfigPath(rootDir);\n\tconst contents = readFileSync(path, \"utf8\");\n\tconst parsed = parse(contents);\n\tconst document = expectObject(parsed, \"config\");\n\tconst iosm = expectObject(document.iosm, \"iosm\");\n\n\tconst metadataObject = expectObject(iosm.metadata, \"iosm.metadata\");\n\tconst planningObject = expectObject(iosm.planning, \"iosm.planning\");\n\tconst cycleCapacityObject = expectObject(iosm.cycle_capacity, \"iosm.cycle_capacity\");\n\tconst cyclePolicyObject = expectObject(iosm.cycle_policy, \"iosm.cycle_policy\");\n\tconst stabilizationObject = expectObject(cyclePolicyObject.stabilization, \"iosm.cycle_policy.stabilization\");\n\tconst qualityGatesObject = expectObject(iosm.quality_gates, \"iosm.quality_gates\");\n\tconst gateIObject = expectObject(qualityGatesObject.gate_I, \"iosm.quality_gates.gate_I\");\n\tconst gateOObject = expectObject(qualityGatesObject.gate_O, \"iosm.quality_gates.gate_O\");\n\tconst gateOLatencyObject = expectObject(gateOObject.latency_ms, \"iosm.quality_gates.gate_O.latency_ms\");\n\tconst gateSObject = expectObject(qualityGatesObject.gate_S, \"iosm.quality_gates.gate_S\");\n\tconst gateMObject = expectObject(qualityGatesObject.gate_M, \"iosm.quality_gates.gate_M\");\n\tconst guardrailsObject = expectObject(iosm.guardrails, \"iosm.guardrails\");\n\tconst evidenceObject = expectObject(iosm.evidence, \"iosm.evidence\");\n\tconst freshnessObject = expectObject(evidenceObject.freshness_sla_hours, \"iosm.evidence.freshness_sla_hours\");\n\tconst waiversObject = expectObject(iosm.waivers, \"iosm.waivers\");\n\tconst metricTargetsObject = expectObject(iosm.metric_targets, \"iosm.metric_targets\");\n\tconst semanticTargetsObject = expectObject(metricTargetsObject.semantic, \"iosm.metric_targets.semantic\");\n\tconst logicTargetsObject = expectObject(metricTargetsObject.logic, \"iosm.metric_targets.logic\");\n\tconst performanceTargetsObject = expectObject(metricTargetsObject.performance, \"iosm.metric_targets.performance\");\n\tconst performanceLatencyObject = expectObject(\n\t\tperformanceTargetsObject.latency_ms,\n\t\t\"iosm.metric_targets.performance.latency_ms\",\n\t);\n\tconst simplicityTargetsObject = expectObject(metricTargetsObject.simplicity, \"iosm.metric_targets.simplicity\");\n\tconst modularityTargetsObject = expectObject(metricTargetsObject.modularity, \"iosm.metric_targets.modularity\");\n\tconst flowTargetsObject = expectObject(metricTargetsObject.flow, \"iosm.metric_targets.flow\");\n\tconst indexObject = expectObject(iosm.index, \"iosm.index\");\n\tconst automationObject = expectObject(iosm.automation, \"iosm.automation\");\n\tconst reportingObject = expectObject(iosm.reporting, \"iosm.reporting\");\n\tconst learningObject = expectObject(iosm.learning, \"iosm.learning\");\n\n\tconst config: IosmConfig = {\n\t\tiosm: {\n\t\t\tmetadata: {\n\t\t\t\tsystem_name: expectString(metadataObject.system_name, \"iosm.metadata.system_name\"),\n\t\t\t\tscope: expectString(metadataObject.scope, \"iosm.metadata.scope\"),\n\t\t\t\tcriticality_profile: expectString(\n\t\t\t\t\tmetadataObject.criticality_profile,\n\t\t\t\t\t\"iosm.metadata.criticality_profile\",\n\t\t\t\t) as IosmCriticalityProfile,\n\t\t\t\tdelivery_boundary: expectString(metadataObject.delivery_boundary, \"iosm.metadata.delivery_boundary\"),\n\t\t\t},\n\t\t\tplanning: {\n\t\t\t\tuse_economic_decision: expectBoolean(\n\t\t\t\t\tplanningObject.use_economic_decision,\n\t\t\t\t\t\"iosm.planning.use_economic_decision\",\n\t\t\t\t),\n\t\t\t\tprioritization_formula: expectString(\n\t\t\t\t\tplanningObject.prioritization_formula,\n\t\t\t\t\t\"iosm.planning.prioritization_formula\",\n\t\t\t\t),\n\t\t\t\tmin_confidence: expectNumber(planningObject.min_confidence, \"iosm.planning.min_confidence\"),\n\t\t\t\thypothesis_required: expectBoolean(\n\t\t\t\t\tplanningObject.hypothesis_required,\n\t\t\t\t\t\"iosm.planning.hypothesis_required\",\n\t\t\t\t),\n\t\t\t\tcycle_scope_required: expectBoolean(\n\t\t\t\t\tplanningObject.cycle_scope_required,\n\t\t\t\t\t\"iosm.planning.cycle_scope_required\",\n\t\t\t\t),\n\t\t\t},\n\t\t\tcycle_capacity: {\n\t\t\t\tmax_goals: expectInteger(cycleCapacityObject.max_goals, \"iosm.cycle_capacity.max_goals\"),\n\t\t\t\tmax_scope_items: expectInteger(\n\t\t\t\t\tcycleCapacityObject.max_scope_items,\n\t\t\t\t\t\"iosm.cycle_capacity.max_scope_items\",\n\t\t\t\t),\n\t\t\t\tmax_expected_change_surface: expectInteger(\n\t\t\t\t\tcycleCapacityObject.max_expected_change_surface,\n\t\t\t\t\t\"iosm.cycle_capacity.max_expected_change_surface\",\n\t\t\t\t),\n\t\t\t},\n\t\t\tcycle_policy: {\n\t\t\t\tmax_iterations_per_phase: expectInteger(\n\t\t\t\t\tcyclePolicyObject.max_iterations_per_phase,\n\t\t\t\t\t\"iosm.cycle_policy.max_iterations_per_phase\",\n\t\t\t\t),\n\t\t\t\tstabilization: {\n\t\t\t\t\ttarget_index: expectNumber(stabilizationObject.target_index, \"iosm.cycle_policy.stabilization.target_index\"),\n\t\t\t\t\tconsecutive_cycles: expectInteger(\n\t\t\t\t\t\tstabilizationObject.consecutive_cycles,\n\t\t\t\t\t\t\"iosm.cycle_policy.stabilization.consecutive_cycles\",\n\t\t\t\t\t),\n\t\t\t\t\tglobal_metric_floor: expectNumber(\n\t\t\t\t\t\tstabilizationObject.global_metric_floor,\n\t\t\t\t\t\t\"iosm.cycle_policy.stabilization.global_metric_floor\",\n\t\t\t\t\t),\n\t\t\t\t\tmax_consecutive_unexplained_declines: expectInteger(\n\t\t\t\t\t\tstabilizationObject.max_consecutive_unexplained_declines,\n\t\t\t\t\t\t\"iosm.cycle_policy.stabilization.max_consecutive_unexplained_declines\",\n\t\t\t\t\t),\n\t\t\t\t\tmetric_floors: parseMetricFloorRecord(\n\t\t\t\t\t\tstabilizationObject.metric_floors,\n\t\t\t\t\t\t\"iosm.cycle_policy.stabilization.metric_floors\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t},\n\t\t\tquality_gates: {\n\t\t\t\tgate_I: {\n\t\t\t\t\tsemantic_min: expectNumber(gateIObject.semantic_min, \"iosm.quality_gates.gate_I.semantic_min\"),\n\t\t\t\t\tlogical_consistency_min: expectNumber(\n\t\t\t\t\t\tgateIObject.logical_consistency_min,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_I.logical_consistency_min\",\n\t\t\t\t\t),\n\t\t\t\t\tduplication_max: expectNumber(gateIObject.duplication_max, \"iosm.quality_gates.gate_I.duplication_max\"),\n\t\t\t\t},\n\t\t\t\tgate_O: {\n\t\t\t\t\tlatency_ms: {\n\t\t\t\t\t\tp50_max: expectNumber(\n\t\t\t\t\t\t\tgateOLatencyObject.p50_max,\n\t\t\t\t\t\t\t\"iosm.quality_gates.gate_O.latency_ms.p50_max\",\n\t\t\t\t\t\t),\n\t\t\t\t\t\tp95_max: expectNumber(\n\t\t\t\t\t\t\tgateOLatencyObject.p95_max,\n\t\t\t\t\t\t\t\"iosm.quality_gates.gate_O.latency_ms.p95_max\",\n\t\t\t\t\t\t),\n\t\t\t\t\t\tp99_max: expectNumber(\n\t\t\t\t\t\t\tgateOLatencyObject.p99_max,\n\t\t\t\t\t\t\t\"iosm.quality_gates.gate_O.latency_ms.p99_max\",\n\t\t\t\t\t\t),\n\t\t\t\t\t},\n\t\t\t\t\terror_budget_respected: expectBoolean(\n\t\t\t\t\t\tgateOObject.error_budget_respected,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_O.error_budget_respected\",\n\t\t\t\t\t),\n\t\t\t\t\tchaos_pass_rate_min: expectNumber(\n\t\t\t\t\t\tgateOObject.chaos_pass_rate_min,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_O.chaos_pass_rate_min\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t\tgate_S: {\n\t\t\t\t\tat_least_one_dimension: expectBoolean(\n\t\t\t\t\t\tgateSObject.at_least_one_dimension,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_S.at_least_one_dimension\",\n\t\t\t\t\t),\n\t\t\t\t\tapi_surface_reduction_min: expectNumber(\n\t\t\t\t\t\tgateSObject.api_surface_reduction_min,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_S.api_surface_reduction_min\",\n\t\t\t\t\t),\n\t\t\t\t\tdependency_hygiene_min: expectNumber(\n\t\t\t\t\t\tgateSObject.dependency_hygiene_min,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_S.dependency_hygiene_min\",\n\t\t\t\t\t),\n\t\t\t\t\tonboarding_time_minutes_max: expectNumber(\n\t\t\t\t\t\tgateSObject.onboarding_time_minutes_max,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_S.onboarding_time_minutes_max\",\n\t\t\t\t\t),\n\t\t\t\t\tregression_budget_max: expectInteger(\n\t\t\t\t\t\tgateSObject.regression_budget_max,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_S.regression_budget_max\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t\tgate_M: {\n\t\t\t\t\tchange_surface_max: expectInteger(\n\t\t\t\t\t\tgateMObject.change_surface_max,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_M.change_surface_max\",\n\t\t\t\t\t),\n\t\t\t\t\tcoupling_max: expectNumber(gateMObject.coupling_max, \"iosm.quality_gates.gate_M.coupling_max\"),\n\t\t\t\t\tcohesion_min: expectNumber(gateMObject.cohesion_min, \"iosm.quality_gates.gate_M.cohesion_min\"),\n\t\t\t\t\tcontracts_pass: expectBoolean(\n\t\t\t\t\t\tgateMObject.contracts_pass,\n\t\t\t\t\t\t\"iosm.quality_gates.gate_M.contracts_pass\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t},\n\t\t\tguardrails: {\n\t\t\t\tmax_negative_delta: parseMetricNumberRecord(\n\t\t\t\t\tguardrailsObject.max_negative_delta,\n\t\t\t\t\t\"iosm.guardrails.max_negative_delta\",\n\t\t\t\t),\n\t\t\t},\n\t\t\tevidence: {\n\t\t\t\tmin_decision_confidence: expectNumber(\n\t\t\t\t\tevidenceObject.min_decision_confidence,\n\t\t\t\t\t\"iosm.evidence.min_decision_confidence\",\n\t\t\t\t),\n\t\t\t\tfreshness_sla_hours: {\n\t\t\t\t\ttier_a: expectInteger(freshnessObject.tier_a, \"iosm.evidence.freshness_sla_hours.tier_a\"),\n\t\t\t\t\ttier_b: expectInteger(freshnessObject.tier_b, \"iosm.evidence.freshness_sla_hours.tier_b\"),\n\t\t\t\t},\n\t\t\t\tmin_metric_confidence: parseMetricNumberRecord(\n\t\t\t\t\tevidenceObject.min_metric_confidence,\n\t\t\t\t\t\"iosm.evidence.min_metric_confidence\",\n\t\t\t\t),\n\t\t\t},\n\t\t\twaivers: {\n\t\t\t\tmax_duration_days: expectInteger(waiversObject.max_duration_days, \"iosm.waivers.max_duration_days\"),\n\t\t\t\trequire_human_approval: expectBoolean(\n\t\t\t\t\twaiversObject.require_human_approval,\n\t\t\t\t\t\"iosm.waivers.require_human_approval\",\n\t\t\t\t),\n\t\t\t},\n\t\t\tmetric_targets: {\n\t\t\t\tsemantic: {\n\t\t\t\t\tglossary_coverage_min: expectNumber(\n\t\t\t\t\t\tsemanticTargetsObject.glossary_coverage_min,\n\t\t\t\t\t\t\"iosm.metric_targets.semantic.glossary_coverage_min\",\n\t\t\t\t\t),\n\t\t\t\t\tnaming_consistency_min: expectNumber(\n\t\t\t\t\t\tsemanticTargetsObject.naming_consistency_min,\n\t\t\t\t\t\t\"iosm.metric_targets.semantic.naming_consistency_min\",\n\t\t\t\t\t),\n\t\t\t\t\tambiguity_ratio_max: expectNumber(\n\t\t\t\t\t\tsemanticTargetsObject.ambiguity_ratio_max,\n\t\t\t\t\t\t\"iosm.metric_targets.semantic.ambiguity_ratio_max\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t\tlogic: {\n\t\t\t\t\tinvariant_pass_rate_min: expectNumber(\n\t\t\t\t\t\tlogicTargetsObject.invariant_pass_rate_min,\n\t\t\t\t\t\t\"iosm.metric_targets.logic.invariant_pass_rate_min\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t\tperformance: {\n\t\t\t\t\tlatency_ms: {\n\t\t\t\t\t\tp50_max: expectNumber(\n\t\t\t\t\t\t\tperformanceLatencyObject.p50_max,\n\t\t\t\t\t\t\t\"iosm.metric_targets.performance.latency_ms.p50_max\",\n\t\t\t\t\t\t),\n\t\t\t\t\t\tp95_max: expectNumber(\n\t\t\t\t\t\t\tperformanceLatencyObject.p95_max,\n\t\t\t\t\t\t\t\"iosm.metric_targets.performance.latency_ms.p95_max\",\n\t\t\t\t\t\t),\n\t\t\t\t\t\tp99_max: expectNumber(\n\t\t\t\t\t\t\tperformanceLatencyObject.p99_max,\n\t\t\t\t\t\t\t\"iosm.metric_targets.performance.latency_ms.p99_max\",\n\t\t\t\t\t\t),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tsimplicity: {\n\t\t\t\t\tonboarding_time_minutes_max: expectNumber(\n\t\t\t\t\t\tsimplicityTargetsObject.onboarding_time_minutes_max,\n\t\t\t\t\t\t\"iosm.metric_targets.simplicity.onboarding_time_minutes_max\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t\tmodularity: {\n\t\t\t\t\tchange_surface_max: expectInteger(\n\t\t\t\t\t\tmodularityTargetsObject.change_surface_max,\n\t\t\t\t\t\t\"iosm.metric_targets.modularity.change_surface_max\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t\tflow: {\n\t\t\t\t\tlead_time_hours_max: expectNumber(\n\t\t\t\t\t\tflowTargetsObject.lead_time_hours_max,\n\t\t\t\t\t\t\"iosm.metric_targets.flow.lead_time_hours_max\",\n\t\t\t\t\t),\n\t\t\t\t\tdeploy_frequency_per_week_min: expectNumber(\n\t\t\t\t\t\tflowTargetsObject.deploy_frequency_per_week_min,\n\t\t\t\t\t\t\"iosm.metric_targets.flow.deploy_frequency_per_week_min\",\n\t\t\t\t\t),\n\t\t\t\t\tchange_failure_rate_max: expectNumber(\n\t\t\t\t\t\tflowTargetsObject.change_failure_rate_max,\n\t\t\t\t\t\t\"iosm.metric_targets.flow.change_failure_rate_max\",\n\t\t\t\t\t),\n\t\t\t\t\treview_latency_hours_max: expectNumber(\n\t\t\t\t\t\tflowTargetsObject.review_latency_hours_max,\n\t\t\t\t\t\t\"iosm.metric_targets.flow.review_latency_hours_max\",\n\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t},\n\t\t\tindex: {\n\t\t\t\tweights: parseMetricNumberRecord(indexObject.weights, \"iosm.index.weights\"),\n\t\t\t},\n\t\t\tautomation: {\n\t\t\t\tallow_agents: expectBoolean(automationObject.allow_agents, \"iosm.automation.allow_agents\"),\n\t\t\t\thuman_approval_required_for: expectStringArray(\n\t\t\t\t\tautomationObject.human_approval_required_for,\n\t\t\t\t\t\"iosm.automation.human_approval_required_for\",\n\t\t\t\t),\n\t\t\t},\n\t\t\treporting: {\n\t\t\t\tpersist_history: expectBoolean(reportingObject.persist_history, \"iosm.reporting.persist_history\"),\n\t\t\t\toutput_format: expectString(reportingObject.output_format, \"iosm.reporting.output_format\"),\n\t\t\t},\n\t\t\tlearning: {\n\t\t\t\tupdate_pattern_library: expectBoolean(\n\t\t\t\t\tlearningObject.update_pattern_library,\n\t\t\t\t\t\"iosm.learning.update_pattern_library\",\n\t\t\t\t),\n\t\t\t\tupdate_decision_log: expectBoolean(\n\t\t\t\t\tlearningObject.update_decision_log,\n\t\t\t\t\t\"iosm.learning.update_decision_log\",\n\t\t\t\t),\n\t\t\t\tupdate_glossary: expectBoolean(learningObject.update_glossary, \"iosm.learning.update_glossary\"),\n\t\t\t},\n\t\t},\n\t};\n\n\tif (![\"exploratory\", \"standard\", \"critical\"].includes(config.iosm.metadata.criticality_profile)) {\n\t\tthrow new Error(\n\t\t\t`Unsupported iosm.metadata.criticality_profile: ${config.iosm.metadata.criticality_profile}`,\n\t\t);\n\t}\n\n\tassertUnitInterval(config.iosm.planning.min_confidence, \"iosm.planning.min_confidence\");\n\tif (!config.iosm.planning.cycle_scope_required) {\n\t\tthrow new Error(\"iosm.planning.cycle_scope_required must be true\");\n\t}\n\n\tassertPositiveInteger(config.iosm.cycle_capacity.max_goals, \"iosm.cycle_capacity.max_goals\");\n\tassertPositiveInteger(config.iosm.cycle_capacity.max_scope_items, \"iosm.cycle_capacity.max_scope_items\");\n\tassertPositiveInteger(\n\t\tconfig.iosm.cycle_capacity.max_expected_change_surface,\n\t\t\"iosm.cycle_capacity.max_expected_change_surface\",\n\t);\n\tassertPositiveInteger(\n\t\tconfig.iosm.cycle_policy.max_iterations_per_phase,\n\t\t\"iosm.cycle_policy.max_iterations_per_phase\",\n\t);\n\n\tassertUnitInterval(config.iosm.cycle_policy.stabilization.target_index, \"iosm.cycle_policy.stabilization.target_index\");\n\tassertPositiveInteger(\n\t\tconfig.iosm.cycle_policy.stabilization.consecutive_cycles,\n\t\t\"iosm.cycle_policy.stabilization.consecutive_cycles\",\n\t);\n\tassertUnitInterval(\n\t\tconfig.iosm.cycle_policy.stabilization.global_metric_floor,\n\t\t\"iosm.cycle_policy.stabilization.global_metric_floor\",\n\t);\n\tassertNonNegativeInteger(\n\t\tconfig.iosm.cycle_policy.stabilization.max_consecutive_unexplained_declines,\n\t\t\"iosm.cycle_policy.stabilization.max_consecutive_unexplained_declines\",\n\t);\n\tvalidateMetricIntervals(\n\t\tconfig.iosm.cycle_policy.stabilization.metric_floors,\n\t\t\"iosm.cycle_policy.stabilization.metric_floors\",\n\t);\n\n\tassertUnitInterval(config.iosm.quality_gates.gate_I.semantic_min, \"iosm.quality_gates.gate_I.semantic_min\");\n\tassertUnitInterval(\n\t\tconfig.iosm.quality_gates.gate_I.logical_consistency_min,\n\t\t\"iosm.quality_gates.gate_I.logical_consistency_min\",\n\t);\n\tassertUnitInterval(config.iosm.quality_gates.gate_I.duplication_max, \"iosm.quality_gates.gate_I.duplication_max\");\n\tassertUnitInterval(\n\t\tconfig.iosm.quality_gates.gate_O.chaos_pass_rate_min,\n\t\t\"iosm.quality_gates.gate_O.chaos_pass_rate_min\",\n\t);\n\tassertUnitInterval(\n\t\tconfig.iosm.quality_gates.gate_S.api_surface_reduction_min,\n\t\t\"iosm.quality_gates.gate_S.api_surface_reduction_min\",\n\t);\n\tassertUnitInterval(\n\t\tconfig.iosm.quality_gates.gate_S.dependency_hygiene_min,\n\t\t\"iosm.quality_gates.gate_S.dependency_hygiene_min\",\n\t);\n\tassertNonNegative(config.iosm.quality_gates.gate_S.onboarding_time_minutes_max, \"iosm.quality_gates.gate_S.onboarding_time_minutes_max\");\n\tassertNonNegativeInteger(config.iosm.quality_gates.gate_S.regression_budget_max, \"iosm.quality_gates.gate_S.regression_budget_max\");\n\tassertPositiveInteger(config.iosm.quality_gates.gate_M.change_surface_max, \"iosm.quality_gates.gate_M.change_surface_max\");\n\tassertUnitInterval(config.iosm.quality_gates.gate_M.coupling_max, \"iosm.quality_gates.gate_M.coupling_max\");\n\tassertUnitInterval(config.iosm.quality_gates.gate_M.cohesion_min, \"iosm.quality_gates.gate_M.cohesion_min\");\n\n\tvalidateMetricRecord(config.iosm.guardrails.max_negative_delta, \"iosm.guardrails.max_negative_delta\");\n\tassertUnitInterval(config.iosm.evidence.min_decision_confidence, \"iosm.evidence.min_decision_confidence\");\n\tvalidateMetricRecord(config.iosm.evidence.min_metric_confidence, \"iosm.evidence.min_metric_confidence\");\n\tassertPositiveInteger(config.iosm.evidence.freshness_sla_hours.tier_a, \"iosm.evidence.freshness_sla_hours.tier_a\");\n\tassertPositiveInteger(config.iosm.evidence.freshness_sla_hours.tier_b, \"iosm.evidence.freshness_sla_hours.tier_b\");\n\tassertPositiveInteger(config.iosm.waivers.max_duration_days, \"iosm.waivers.max_duration_days\");\n\n\tassertUnitInterval(config.iosm.metric_targets.semantic.glossary_coverage_min, \"iosm.metric_targets.semantic.glossary_coverage_min\");\n\tassertUnitInterval(config.iosm.metric_targets.semantic.naming_consistency_min, \"iosm.metric_targets.semantic.naming_consistency_min\");\n\tassertUnitInterval(config.iosm.metric_targets.semantic.ambiguity_ratio_max, \"iosm.metric_targets.semantic.ambiguity_ratio_max\");\n\tassertUnitInterval(config.iosm.metric_targets.logic.invariant_pass_rate_min, \"iosm.metric_targets.logic.invariant_pass_rate_min\");\n\tassertNonNegative(\n\t\tconfig.iosm.metric_targets.simplicity.onboarding_time_minutes_max,\n\t\t\"iosm.metric_targets.simplicity.onboarding_time_minutes_max\",\n\t);\n\tassertPositiveInteger(\n\t\tconfig.iosm.metric_targets.modularity.change_surface_max,\n\t\t\"iosm.metric_targets.modularity.change_surface_max\",\n\t);\n\tassertNonNegative(config.iosm.metric_targets.flow.lead_time_hours_max, \"iosm.metric_targets.flow.lead_time_hours_max\");\n\tassertNonNegative(\n\t\tconfig.iosm.metric_targets.flow.deploy_frequency_per_week_min,\n\t\t\"iosm.metric_targets.flow.deploy_frequency_per_week_min\",\n\t);\n\tassertUnitInterval(config.iosm.metric_targets.flow.change_failure_rate_max, \"iosm.metric_targets.flow.change_failure_rate_max\");\n\tassertNonNegative(config.iosm.metric_targets.flow.review_latency_hours_max, \"iosm.metric_targets.flow.review_latency_hours_max\");\n\n\tvalidateMetricRecord(config.iosm.index.weights, \"iosm.index.weights\");\n\tconst weightSum = IOSM_METRICS.reduce((sum, metric) => sum + config.iosm.index.weights[metric], 0);\n\tif (Math.abs(weightSum - 1) > 0.001) {\n\t\tthrow new Error(`iosm.index.weights must sum to 1.0, received ${weightSum.toFixed(3)}`);\n\t}\n\n\treturn { rootDir, path, config };\n}\n"]}

package/dist/iosm/context-loader.d.ts

@@ -0,0 +1,12 @@
+export declare function buildIosmContextBlock(content: string): string;
+export declare function loadIosmContextFromPath(guidePath: string): string | undefined;
+export declare function findIosmGuidePath(startDir?: string): string | undefined;
+/**
+ * Load the nearest IOSM.md from the given working directory (walking up
+ * ancestor directories) and return it wrapped in a structured context block
+ * suitable for injection into the agent system prompt.
+ *
+ * Returns `undefined` if no IOSM.md file exists in `cwd` or its parents.
+ */
+export declare function loadIosmContext(cwd: string): string | undefined;
+//# sourceMappingURL=context-loader.d.ts.map

package/dist/iosm/context-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-loader.d.ts","sourceRoot":"","sources":["../../src/iosm/context-loader.ts"],"names":[],"mappings":"AAOA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa7E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,SAAS,CAoBtF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/D"}

package/dist/iosm/context-loader.js

@@ -0,0 +1,50 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { getIosmGuidePath } from "./paths.js";
+const IOSM_CONTEXT_INTRO = "The following is the IOSM operational guide for this project. Read it carefully before each engineering action.";
+export function buildIosmContextBlock(content) {
+    return ["<iosm-context>", IOSM_CONTEXT_INTRO, "", content.trimEnd(), "</iosm-context>"].join("\n");
+}
+export function loadIosmContextFromPath(guidePath) {
+    if (!existsSync(guidePath)) {
+        return undefined;
+    }
+    let content;
+    try {
+        content = readFileSync(guidePath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    return buildIosmContextBlock(content);
+}
+export function findIosmGuidePath(startDir = process.cwd()) {
+    let currentDir = resolve(startDir);
+    const rootDir = resolve("/");
+    while (true) {
+        const guidePath = getIosmGuidePath(currentDir);
+        if (existsSync(guidePath)) {
+            return guidePath;
+        }
+        if (currentDir === rootDir) {
+            return undefined;
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            return undefined;
+        }
+        currentDir = parentDir;
+    }
+}
+/**
+ * Load the nearest IOSM.md from the given working directory (walking up
+ * ancestor directories) and return it wrapped in a structured context block
+ * suitable for injection into the agent system prompt.
+ *
+ * Returns `undefined` if no IOSM.md file exists in `cwd` or its parents.
+ */
+export function loadIosmContext(cwd) {
+    const guidePath = findIosmGuidePath(cwd);
+    return guidePath ? loadIosmContextFromPath(guidePath) : undefined;
+}
+//# sourceMappingURL=context-loader.js.map

package/dist/iosm/context-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-loader.js","sourceRoot":"","sources":["../../src/iosm/context-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,kBAAkB,GACvB,iHAAiH,CAAC;AAEnH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACpD,OAAO,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACxD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACJ,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IACjE,IAAI,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE7B,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACxB,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IAC1C,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { getIosmGuidePath } from \"./paths.js\";\n\nconst IOSM_CONTEXT_INTRO =\n\t\"The following is the IOSM operational guide for this project. Read it carefully before each engineering action.\";\n\nexport function buildIosmContextBlock(content: string): string {\n\treturn [\"<iosm-context>\", IOSM_CONTEXT_INTRO, \"\", content.trimEnd(), \"</iosm-context>\"].join(\"\\n\");\n}\n\nexport function loadIosmContextFromPath(guidePath: string): string | undefined {\n\tif (!existsSync(guidePath)) {\n\t\treturn undefined;\n\t}\n\n\tlet content: string;\n\ttry {\n\t\tcontent = readFileSync(guidePath, \"utf8\");\n\t} catch {\n\t\treturn undefined;\n\t}\n\n\treturn buildIosmContextBlock(content);\n}\n\nexport function findIosmGuidePath(startDir: string = process.cwd()): string | undefined {\n\tlet currentDir = resolve(startDir);\n\tconst rootDir = resolve(\"/\");\n\n\twhile (true) {\n\t\tconst guidePath = getIosmGuidePath(currentDir);\n\t\tif (existsSync(guidePath)) {\n\t\t\treturn guidePath;\n\t\t}\n\n\t\tif (currentDir === rootDir) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst parentDir = dirname(currentDir);\n\t\tif (parentDir === currentDir) {\n\t\t\treturn undefined;\n\t\t}\n\t\tcurrentDir = parentDir;\n\t}\n}\n\n/**\n * Load the nearest IOSM.md from the given working directory (walking up\n * ancestor directories) and return it wrapped in a structured context block\n * suitable for injection into the agent system prompt.\n *\n * Returns `undefined` if no IOSM.md file exists in `cwd` or its parents.\n */\nexport function loadIosmContext(cwd: string): string | undefined {\n\tconst guidePath = findIosmGuidePath(cwd);\n\treturn guidePath ? loadIosmContextFromPath(guidePath) : undefined;\n}\n"]}

package/dist/iosm/cycle.d.ts

@@ -0,0 +1,51 @@
+import type { IosmCycleReport, IosmDecision } from "./types.js";
+export interface PlanIosmCycleOptions {
+    cwd?: string;
+    goals: string[];
+    cycleId?: string;
+    force?: boolean;
+}
+export interface PlannedIosmCycle {
+    cycleId: string;
+    cycleDir: string;
+    reportPath: string;
+    baselineReportPath: string;
+    hypothesesPath: string;
+}
+export interface IosmCycleListItem {
+    cycleId: string;
+    path: string;
+    status: IosmCycleReport["status"] | "unknown";
+    goals: string[];
+    decision: IosmDecision | "unknown";
+}
+export interface IosmCycleStatus {
+    cycleId: string;
+    rootDir: string;
+    reportPath: string;
+    status: IosmCycleReport["status"];
+    decision: IosmDecision;
+    reportComplete: boolean;
+    learningClosed: boolean;
+    historyRecorded: boolean;
+    capacityPass: boolean;
+    guardrailsPass: boolean | null;
+    blockingIssues: string[];
+    warnings: string[];
+}
+export interface IosmCycleHistoryRecordResult {
+    cycleId: string;
+    historyPath: string;
+    replaced: boolean;
+}
+export declare function planIosmCycle(options: PlanIosmCycleOptions): PlannedIosmCycle;
+export declare function listIosmCycles(cwd?: string): IosmCycleListItem[];
+/**
+ * Async variant of listIosmCycles that hydrates all cycle reports in parallel.
+ * Significantly faster than the synchronous version when many cycles exist.
+ */
+export declare function listIosmCyclesAsync(cwd?: string): Promise<IosmCycleListItem[]>;
+export declare function readIosmCycleReport(cwd?: string, cycleId?: string): IosmCycleReport;
+export declare function inspectIosmCycle(cwd?: string, cycleId?: string): IosmCycleStatus;
+export declare function recordIosmCycleHistory(cwd?: string, cycleId?: string): IosmCycleHistoryRecordResult;
+//# sourceMappingURL=cycle.d.ts.map

package/dist/iosm/cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle.d.ts","sourceRoot":"","sources":["../../src/iosm/cycle.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAGX,eAAe,EAEf,YAAY,EAYZ,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,oBAAoB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAg0BD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,CAsD7E;AAED,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,EAAE,CAgC/E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoCnG;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAIlG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAqE/F;AAED,wBAAgB,sBAAsB,CACrC,GAAG,GAAE,MAAsB,EAC3B,OAAO,CAAC,EAAE,MAAM,GACd,4BAA4B,CAsB9B"}