@mcoda/mswarm 0.1.89 → 0.1.91

package/dist/vendor/codali/improvement/ProductionGovernance.d.ts

@@ -0,0 +1,91 @@
+import { type CodaliImprovementPolicyAction, type CodaliImprovementReleaseLevel, type CodaliImprovementStorageMode } from "./ImprovementPolicy.js";
+export declare const CODALI_PRODUCTION_GOVERNANCE_SCHEMA_VERSION: "codali.production_governance.v1";
+export declare const CODALI_PRODUCTION_GOVERNANCE_ENV_FLAGS: readonly ["CODALI_DATASET_ENABLED", "CODALI_STORAGE_MODE", "CODALI_STORAGE_UPLOAD_ENABLED", "CODALI_IMPROVEMENT_ENABLED", "CODALI_IMPROVEMENT_AUTO_TAG", "CODALI_IMPROVEMENT_AUTO_PUBLISH", "CODALI_IMPROVEMENT_TRAINING_ENABLED", "CODALI_IMPROVEMENT_SHADOW_ONLY"];
+export type CodaliProductionGovernanceEnvFlag = (typeof CODALI_PRODUCTION_GOVERNANCE_ENV_FLAGS)[number];
+export type CodaliProductionGovernanceStorageMode = "off" | CodaliImprovementStorageMode;
+export type CodaliProductionGovernanceAction = "dataset_export" | "service_gateway_write" | "improvement_analyze" | "improvement_eval_replay" | "candidate_branch" | "prerelease_canary" | "stable_publish" | "training";
+export interface CodaliProductionGovernanceInput {
+    env?: Record<string, string | undefined>;
+    releaseLevel?: CodaliImprovementReleaseLevel;
+    internalDeployment?: boolean;
+    privacyGatesStable?: boolean;
+    policyActive?: boolean;
+    ciActive?: boolean;
+    npmProvenanceActive?: boolean;
+    storageAuditActive?: boolean;
+    rollbackMonitorActive?: boolean;
+    hardGatesActive?: boolean;
+}
+export interface CodaliProductionGovernanceEffectiveConfig {
+    datasetEnabled: boolean;
+    storageMode: CodaliProductionGovernanceStorageMode;
+    storageUploadEnabled: boolean;
+    improvementEnabled: boolean;
+    trainingEnabled: boolean;
+    autoTagEnabled: boolean;
+    autoPublishEnabled: boolean;
+    shadowOnly: boolean;
+    releaseLevel: CodaliImprovementReleaseLevel;
+    internalDeployment: boolean;
+    privacyGatesStable: boolean;
+    policyActive: boolean;
+    ciActive: boolean;
+    npmProvenanceActive: boolean;
+    storageAuditActive: boolean;
+    rollbackMonitorActive: boolean;
+    hardGatesActive: boolean;
+}
+export interface CodaliProductionGovernanceEnvFlagState {
+    name: CodaliProductionGovernanceEnvFlag;
+    configured: boolean;
+    configuredValue?: string;
+    defaultValue: string;
+    effectiveValue: string | boolean;
+    disablesWhen: string;
+    disableActive: boolean;
+    effect: string;
+}
+export interface CodaliProductionGovernanceWarning {
+    code: string;
+    flag: string;
+    value?: string;
+    message: string;
+}
+export interface CodaliProductionGovernanceDecision {
+    action: CodaliProductionGovernanceAction;
+    allowed: boolean;
+    reasons: string[];
+    blockedBy: string[];
+    requiredGates: string[];
+}
+export interface CodaliProductionRolloutStage {
+    level: CodaliImprovementReleaseLevel;
+    name: string;
+    enabled: boolean;
+    description: string;
+    requiredGates: string[];
+    allowedActions: CodaliImprovementPolicyAction[];
+    blockedReasons: string[];
+}
+export interface CodaliProductionGovernanceState {
+    schemaVersion: typeof CODALI_PRODUCTION_GOVERNANCE_SCHEMA_VERSION;
+    effective: CodaliProductionGovernanceEffectiveConfig;
+    emergencyDisableFlags: CodaliProductionGovernanceEnvFlagState[];
+    stages: CodaliProductionRolloutStage[];
+    warnings: CodaliProductionGovernanceWarning[];
+}
+export interface CodaliProductionGovernanceImprovementOverrides {
+    dryRun?: boolean;
+    storageMode?: CodaliImprovementStorageMode;
+    exportEnabled?: boolean;
+    trainingEnabled?: boolean;
+    autoTagEnabled?: boolean;
+    autoPublishEnabled?: boolean;
+    blockedReasons: string[];
+}
+export declare const resolveCodaliProductionGovernance: (input?: CodaliProductionGovernanceInput) => CodaliProductionGovernanceState;
+export declare const evaluateCodaliProductionGovernanceAction: (governance: Pick<CodaliProductionGovernanceState, "effective">, action: CodaliProductionGovernanceAction) => CodaliProductionGovernanceDecision;
+export declare const buildCodaliProductionRolloutStages: (governance: Pick<CodaliProductionGovernanceState, "effective">) => CodaliProductionRolloutStage[];
+export declare const getCodaliProductionGovernanceFlag: (governance: CodaliProductionGovernanceState, flag: CodaliProductionGovernanceEnvFlag) => CodaliProductionGovernanceEnvFlagState | undefined;
+export declare const createCodaliProductionGovernanceImprovementOverrides: (governance: CodaliProductionGovernanceState) => CodaliProductionGovernanceImprovementOverrides;
+//# sourceMappingURL=ProductionGovernance.d.ts.map

package/dist/vendor/codali/improvement/ProductionGovernance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductionGovernance.d.ts","sourceRoot":"","sources":["../../src/improvement/ProductionGovernance.ts"],"names":[],"mappings":"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"}

package/dist/vendor/codali/improvement/ProductionGovernance.js

@@ -0,0 +1,329 @@
+import { CODALI_IMPROVEMENT_RELEASE_LEVEL_CONTRACTS, DEFAULT_CODALI_IMPROVEMENT_POLICY_LIMITS, } from "./ImprovementPolicy.js";
+export const CODALI_PRODUCTION_GOVERNANCE_SCHEMA_VERSION = "codali.production_governance.v1";
+export const CODALI_PRODUCTION_GOVERNANCE_ENV_FLAGS = [
+    "CODALI_DATASET_ENABLED",
+    "CODALI_STORAGE_MODE",
+    "CODALI_STORAGE_UPLOAD_ENABLED",
+    "CODALI_IMPROVEMENT_ENABLED",
+    "CODALI_IMPROVEMENT_AUTO_TAG",
+    "CODALI_IMPROVEMENT_AUTO_PUBLISH",
+    "CODALI_IMPROVEMENT_TRAINING_ENABLED",
+    "CODALI_IMPROVEMENT_SHADOW_ONLY",
+];
+const BOOLEAN_TRUE = new Set(["1", "true", "yes", "on", "enabled"]);
+const BOOLEAN_FALSE = new Set(["0", "false", "no", "off", "disabled"]);
+const STORAGE_MODES = new Set([
+    "off",
+    "local_only",
+    "storage_service",
+    "hybrid",
+]);
+const FLAG_EFFECTS = {
+    CODALI_DATASET_ENABLED: "Disables dataset collection and export when false.",
+    CODALI_STORAGE_MODE: "Forces storage off, local_only, storage_service, or hybrid.",
+    CODALI_STORAGE_UPLOAD_ENABLED: "Disables storage-service writes and release writebacks when false.",
+    CODALI_IMPROVEMENT_ENABLED: "Disables auto-improvement commands when false.",
+    CODALI_IMPROVEMENT_AUTO_TAG: "Disables automatic tag creation when false.",
+    CODALI_IMPROVEMENT_AUTO_PUBLISH: "Disables stable auto-publish when false.",
+    CODALI_IMPROVEMENT_TRAINING_ENABLED: "Disables training and fine-tune proposal actions when false.",
+    CODALI_IMPROVEMENT_SHADOW_ONLY: "Forces improvement workflows into dry-run shadow mode when true.",
+};
+const hasConfiguredFlag = (env, flag) => Object.prototype.hasOwnProperty.call(env, flag);
+const normalizeFlagValue = (value) => value.trim().toLowerCase();
+const readBooleanFlag = (env, flag, fallback, warnings) => {
+    const raw = env[flag];
+    if (raw === undefined) {
+        return fallback;
+    }
+    const normalized = normalizeFlagValue(raw);
+    if (BOOLEAN_TRUE.has(normalized)) {
+        return true;
+    }
+    if (BOOLEAN_FALSE.has(normalized)) {
+        return false;
+    }
+    warnings.push({
+        code: "invalid_boolean_flag",
+        flag,
+        value: raw,
+        message: `${flag} must be a boolean-like value; using ${String(fallback)}.`,
+    });
+    return fallback;
+};
+const readStorageModeFlag = (env, warnings) => {
+    const raw = env.CODALI_STORAGE_MODE;
+    if (raw === undefined) {
+        return DEFAULT_CODALI_IMPROVEMENT_POLICY_LIMITS.storageMode;
+    }
+    const normalized = normalizeFlagValue(raw);
+    if (STORAGE_MODES.has(normalized)) {
+        return normalized;
+    }
+    warnings.push({
+        code: "invalid_storage_mode",
+        flag: "CODALI_STORAGE_MODE",
+        value: raw,
+        message: "CODALI_STORAGE_MODE must be off, local_only, storage_service, or hybrid; using local_only.",
+    });
+    return "local_only";
+};
+const readGateFlag = (input, envFlag, explicit) => {
+    if (explicit !== undefined) {
+        return explicit;
+    }
+    return readBooleanFlag(input.env ?? process.env, envFlag, false, []);
+};
+const flagState = (env, name, defaultValue, effectiveValue, disablesWhen, disableActive) => ({
+    name,
+    configured: hasConfiguredFlag(env, name),
+    ...(env[name] === undefined ? {} : { configuredValue: env[name] }),
+    defaultValue,
+    effectiveValue,
+    disablesWhen,
+    disableActive,
+    effect: FLAG_EFFECTS[name],
+});
+const unique = (values) => Array.from(new Set(values));
+const releaseLevelAtLeast = (actual, expected) => actual >= expected;
+export const resolveCodaliProductionGovernance = (input = {}) => {
+    const env = input.env ?? process.env;
+    const warnings = [];
+    const storageMode = readStorageModeFlag(env, warnings);
+    const effective = {
+        datasetEnabled: readBooleanFlag(env, "CODALI_DATASET_ENABLED", true, warnings),
+        storageMode,
+        storageUploadEnabled: readBooleanFlag(env, "CODALI_STORAGE_UPLOAD_ENABLED", false, warnings),
+        improvementEnabled: readBooleanFlag(env, "CODALI_IMPROVEMENT_ENABLED", true, warnings),
+        trainingEnabled: readBooleanFlag(env, "CODALI_IMPROVEMENT_TRAINING_ENABLED", false, warnings),
+        autoTagEnabled: readBooleanFlag(env, "CODALI_IMPROVEMENT_AUTO_TAG", false, warnings),
+        autoPublishEnabled: readBooleanFlag(env, "CODALI_IMPROVEMENT_AUTO_PUBLISH", false, warnings),
+        shadowOnly: readBooleanFlag(env, "CODALI_IMPROVEMENT_SHADOW_ONLY", false, warnings),
+        releaseLevel: input.releaseLevel ?? DEFAULT_CODALI_IMPROVEMENT_POLICY_LIMITS.releaseLevel,
+        internalDeployment: readGateFlag(input, "CODALI_IMPROVEMENT_INTERNAL_DEPLOYMENT", input.internalDeployment),
+        privacyGatesStable: readGateFlag(input, "CODALI_PRIVACY_GATES_STABLE", input.privacyGatesStable),
+        policyActive: readGateFlag(input, "CODALI_IMPROVEMENT_POLICY_ACTIVE", input.policyActive),
+        ciActive: readGateFlag(input, "CODALI_IMPROVEMENT_CI_ACTIVE", input.ciActive),
+        npmProvenanceActive: readGateFlag(input, "CODALI_IMPROVEMENT_NPM_PROVENANCE_ACTIVE", input.npmProvenanceActive),
+        storageAuditActive: readGateFlag(input, "CODALI_IMPROVEMENT_STORAGE_AUDIT_ACTIVE", input.storageAuditActive),
+        rollbackMonitorActive: readGateFlag(input, "CODALI_IMPROVEMENT_ROLLBACK_MONITOR_ACTIVE", input.rollbackMonitorActive),
+        hardGatesActive: readGateFlag(input, "CODALI_IMPROVEMENT_HARD_GATES_ACTIVE", input.hardGatesActive),
+    };
+    const stateWithoutStages = {
+        schemaVersion: CODALI_PRODUCTION_GOVERNANCE_SCHEMA_VERSION,
+        effective,
+        emergencyDisableFlags: [
+            flagState(env, "CODALI_DATASET_ENABLED", "true", effective.datasetEnabled, "false", hasConfiguredFlag(env, "CODALI_DATASET_ENABLED") &&
+                !effective.datasetEnabled),
+            flagState(env, "CODALI_STORAGE_MODE", "local_only", effective.storageMode, "off", effective.storageMode === "off"),
+            flagState(env, "CODALI_STORAGE_UPLOAD_ENABLED", "false", effective.storageUploadEnabled, "false", hasConfiguredFlag(env, "CODALI_STORAGE_UPLOAD_ENABLED") &&
+                !effective.storageUploadEnabled),
+            flagState(env, "CODALI_IMPROVEMENT_ENABLED", "true", effective.improvementEnabled, "false", hasConfiguredFlag(env, "CODALI_IMPROVEMENT_ENABLED") &&
+                !effective.improvementEnabled),
+            flagState(env, "CODALI_IMPROVEMENT_AUTO_TAG", "false", effective.autoTagEnabled, "false", hasConfiguredFlag(env, "CODALI_IMPROVEMENT_AUTO_TAG") &&
+                !effective.autoTagEnabled),
+            flagState(env, "CODALI_IMPROVEMENT_AUTO_PUBLISH", "false", effective.autoPublishEnabled, "false", hasConfiguredFlag(env, "CODALI_IMPROVEMENT_AUTO_PUBLISH") &&
+                !effective.autoPublishEnabled),
+            flagState(env, "CODALI_IMPROVEMENT_TRAINING_ENABLED", "false", effective.trainingEnabled, "false", hasConfiguredFlag(env, "CODALI_IMPROVEMENT_TRAINING_ENABLED") &&
+                !effective.trainingEnabled),
+            flagState(env, "CODALI_IMPROVEMENT_SHADOW_ONLY", "false", effective.shadowOnly, "true", effective.shadowOnly),
+        ],
+        warnings,
+    };
+    const state = {
+        ...stateWithoutStages,
+        stages: buildCodaliProductionRolloutStages(stateWithoutStages),
+    };
+    return state;
+};
+export const evaluateCodaliProductionGovernanceAction = (governance, action) => {
+    const reasons = [];
+    const blockedBy = [];
+    const requiredGates = [];
+    const effective = governance.effective;
+    const block = (reason, gate) => {
+        reasons.push(reason);
+        if (gate) {
+            blockedBy.push(gate);
+            requiredGates.push(gate);
+        }
+    };
+    if (action === "dataset_export" ||
+        action === "service_gateway_write") {
+        if (!effective.datasetEnabled) {
+            block("dataset_disabled", "CODALI_DATASET_ENABLED");
+        }
+        if (effective.storageMode === "off") {
+            block("storage_mode_off", "CODALI_STORAGE_MODE");
+        }
+    }
+    if (action === "service_gateway_write") {
+        if (effective.storageMode !== "storage_service" &&
+            effective.storageMode !== "hybrid") {
+            block("storage_service_not_enabled", "CODALI_STORAGE_MODE");
+        }
+        if (!effective.storageUploadEnabled) {
+            block("storage_upload_disabled", "CODALI_STORAGE_UPLOAD_ENABLED");
+        }
+    }
+    if (action === "improvement_analyze" ||
+        action === "improvement_eval_replay" ||
+        action === "candidate_branch" ||
+        action === "prerelease_canary" ||
+        action === "stable_publish" ||
+        action === "training") {
+        if (!effective.improvementEnabled) {
+            block("improvement_disabled", "CODALI_IMPROVEMENT_ENABLED");
+        }
+    }
+    if (action === "improvement_eval_replay") {
+        if (!releaseLevelAtLeast(effective.releaseLevel, 1)) {
+            block("release_level_below_1", "CODALI_IMPROVEMENT_RELEASE_LEVEL");
+        }
+    }
+    if (action === "candidate_branch") {
+        if (!releaseLevelAtLeast(effective.releaseLevel, 2)) {
+            block("release_level_below_2", "CODALI_IMPROVEMENT_RELEASE_LEVEL");
+        }
+        if (!effective.privacyGatesStable) {
+            block("privacy_gates_not_stable", "CODALI_PRIVACY_GATES_STABLE");
+        }
+    }
+    if (action === "prerelease_canary") {
+        if (!releaseLevelAtLeast(effective.releaseLevel, 3)) {
+            block("release_level_below_3", "CODALI_IMPROVEMENT_RELEASE_LEVEL");
+        }
+        if (!effective.internalDeployment) {
+            block("internal_deployment_required", "CODALI_IMPROVEMENT_INTERNAL_DEPLOYMENT");
+        }
+        if (effective.shadowOnly) {
+            block("shadow_only_mode", "CODALI_IMPROVEMENT_SHADOW_ONLY");
+        }
+    }
+    if (action === "stable_publish") {
+        if (!releaseLevelAtLeast(effective.releaseLevel, 4)) {
+            block("release_level_below_4", "CODALI_IMPROVEMENT_RELEASE_LEVEL");
+        }
+        if (!effective.autoTagEnabled) {
+            block("auto_tag_disabled", "CODALI_IMPROVEMENT_AUTO_TAG");
+        }
+        if (!effective.autoPublishEnabled) {
+            block("auto_publish_disabled", "CODALI_IMPROVEMENT_AUTO_PUBLISH");
+        }
+        if (!effective.policyActive) {
+            block("policy_gate_inactive", "CODALI_IMPROVEMENT_POLICY_ACTIVE");
+        }
+        if (!effective.ciActive) {
+            block("ci_gate_inactive", "CODALI_IMPROVEMENT_CI_ACTIVE");
+        }
+        if (!effective.npmProvenanceActive) {
+            block("npm_provenance_gate_inactive", "CODALI_IMPROVEMENT_NPM_PROVENANCE_ACTIVE");
+        }
+        if (!effective.storageAuditActive) {
+            block("storage_audit_gate_inactive", "CODALI_IMPROVEMENT_STORAGE_AUDIT_ACTIVE");
+        }
+        if (!effective.rollbackMonitorActive) {
+            block("rollback_monitor_gate_inactive", "CODALI_IMPROVEMENT_ROLLBACK_MONITOR_ACTIVE");
+        }
+        if (!effective.hardGatesActive) {
+            block("hard_gates_inactive", "CODALI_IMPROVEMENT_HARD_GATES_ACTIVE");
+        }
+        if (effective.shadowOnly) {
+            block("shadow_only_mode", "CODALI_IMPROVEMENT_SHADOW_ONLY");
+        }
+    }
+    if (action === "training") {
+        if (!effective.trainingEnabled) {
+            block("training_disabled", "CODALI_IMPROVEMENT_TRAINING_ENABLED");
+        }
+    }
+    return {
+        action,
+        allowed: reasons.length === 0,
+        reasons: unique(reasons),
+        blockedBy: unique(blockedBy),
+        requiredGates: unique(requiredGates),
+    };
+};
+export const buildCodaliProductionRolloutStages = (governance) => {
+    const stageDefinitions = [
+        {
+            level: 0,
+            action: "improvement_analyze",
+            description: "Local-only analysis and recommendation capture.",
+        },
+        {
+            level: 1,
+            action: "improvement_eval_replay",
+            description: "Eval and replay improvements without release automation.",
+        },
+        {
+            level: 2,
+            action: "candidate_branch",
+            description: "Candidate metadata branches after privacy gates are stable.",
+        },
+        {
+            level: 3,
+            action: "prerelease_canary",
+            description: "Internal prerelease or canary automation only.",
+        },
+        {
+            level: 4,
+            action: "stable_publish",
+            description: "Stable auto-publish only with policy, CI, provenance, audit, rollback, and hard gates.",
+        },
+    ];
+    return stageDefinitions.map((stage) => {
+        const contract = CODALI_IMPROVEMENT_RELEASE_LEVEL_CONTRACTS[stage.level];
+        const decision = evaluateCodaliProductionGovernanceAction(governance, stage.action);
+        return {
+            level: stage.level,
+            name: contract.name,
+            enabled: decision.allowed,
+            description: stage.description,
+            requiredGates: decision.requiredGates,
+            allowedActions: [...contract.allowedActions],
+            blockedReasons: decision.reasons,
+        };
+    });
+};
+export const getCodaliProductionGovernanceFlag = (governance, flag) => governance.emergencyDisableFlags.find((entry) => entry.name === flag);
+export const createCodaliProductionGovernanceImprovementOverrides = (governance) => {
+    const overrides = {
+        blockedReasons: [],
+    };
+    const storageFlag = getCodaliProductionGovernanceFlag(governance, "CODALI_STORAGE_MODE");
+    if (storageFlag?.configured && governance.effective.storageMode !== "off") {
+        overrides.storageMode =
+            governance.effective.storageMode;
+    }
+    if (governance.effective.storageMode === "off") {
+        overrides.storageMode = "local_only";
+        overrides.dryRun = true;
+        overrides.blockedReasons.push("storage_mode_off");
+    }
+    if (!governance.effective.storageUploadEnabled) {
+        overrides.dryRun = true;
+    }
+    if (governance.effective.shadowOnly) {
+        overrides.dryRun = true;
+        overrides.autoTagEnabled = false;
+        overrides.autoPublishEnabled = false;
+    }
+    const exportFlag = getCodaliProductionGovernanceFlag(governance, "CODALI_DATASET_ENABLED");
+    if (exportFlag?.configured) {
+        overrides.exportEnabled = governance.effective.datasetEnabled;
+    }
+    const trainingFlag = getCodaliProductionGovernanceFlag(governance, "CODALI_IMPROVEMENT_TRAINING_ENABLED");
+    if (trainingFlag?.configured) {
+        overrides.trainingEnabled = governance.effective.trainingEnabled;
+    }
+    const autoTagFlag = getCodaliProductionGovernanceFlag(governance, "CODALI_IMPROVEMENT_AUTO_TAG");
+    if (autoTagFlag?.configured) {
+        overrides.autoTagEnabled = governance.effective.autoTagEnabled;
+    }
+    const autoPublishFlag = getCodaliProductionGovernanceFlag(governance, "CODALI_IMPROVEMENT_AUTO_PUBLISH");
+    if (autoPublishFlag?.configured) {
+        overrides.autoPublishEnabled = governance.effective.autoPublishEnabled;
+    }
+    return overrides;
+};

package/dist/vendor/codali/improvement/PromptSchemaToolMetadataCandidateBuilder.d.ts

@@ -0,0 +1,152 @@
+import type { CodaliStorageDatasetKind, CodaliStorageObjectPrivacyFlags } from "../storage/CodaliStorageContracts.js";
+import type { DatasetEligibilityGateRejectedExample } from "./DatasetEligibilityGate.js";
+import type { DatasetExportManifestReaderResult } from "./DatasetExportManifestReader.js";
+export declare const CODALI_PATCH_CANDIDATE_SCHEMA_VERSION: "codali.improvement.patch_candidate.v1";
+export declare const CODALI_PATCH_PROPOSAL_ARTIFACTS: readonly ["prompt", "schema", "tool-metadata"];
+export type CodaliPatchProposalArtifact = (typeof CODALI_PATCH_PROPOSAL_ARTIFACTS)[number];
+export type CodaliPatchCandidateKind = "prompt" | "schema" | "tool_metadata";
+export type CodaliPatchOperationType = "add_prompt_failure_guardrail" | "tighten_schema_contract" | "update_tool_metadata_contract";
+export interface CodaliPatchObjectRefSummary {
+    refId: string;
+    kind: string;
+    contentHash: string;
+    byteSize: number;
+    mimeType: string;
+    deletionGroupId: string;
+    privacyFlags: CodaliStorageObjectPrivacyFlags;
+    uri?: string;
+    mediaType?: string;
+    metadataKeys: string[];
+}
+export interface CodaliPatchSourceExample {
+    recordId: string;
+    sourceGatewayRecordId?: string;
+    datasetKind?: CodaliStorageDatasetKind;
+    artifactTypes: string[];
+    failureClasses: string[];
+    failureReasonCodes: string[];
+    preferenceSignals: string[];
+    priorityScore: number;
+    lineageKey: {
+        runIds: string[];
+        deletionGroupIds: string[];
+        promptHash?: string;
+        schemaHash?: string;
+        toolContractHash?: string;
+        expectedTargetHash?: string;
+    };
+    objectRefs: {
+        inputRef?: CodaliPatchObjectRefSummary;
+        outputRef?: CodaliPatchObjectRefSummary;
+        evidenceRefs: CodaliPatchObjectRefSummary[];
+    };
+    metadataShape: {
+        keys: string[];
+        failureEvidenceKeys: string[];
+        contractKeys: string[];
+    };
+}
+export interface CodaliPatchFailureEvidence {
+    source: "source_example" | "curation_rejection";
+    recordId?: string;
+    targetType?: DatasetEligibilityGateRejectedExample["targetType"];
+    failureClasses: string[];
+    reasonCodes: string[];
+    paths: string[];
+}
+export interface CodaliPatchPlanOperation {
+    operationId: string;
+    operationType: CodaliPatchOperationType;
+    productNeutral: true;
+    contractDriven: true;
+    sourceRecordIds: string[];
+    failureClasses: string[];
+    requiredEvidence: Array<"source_examples" | "failure_classes">;
+    writesRuntimeCode: false;
+    target: {
+        artifact: CodaliPatchProposalArtifact;
+        candidateKind: CodaliPatchCandidateKind;
+        promptHashes: string[];
+        schemaHashes: string[];
+        toolContractHashes: string[];
+        expectedTargetHashes: string[];
+    };
+}
+export interface CodaliPatchPlan {
+    planId: string;
+    artifact: CodaliPatchProposalArtifact;
+    candidateKind: CodaliPatchCandidateKind;
+    deterministic: true;
+    patchArtifactType: "prompt_patch" | "schema_patch" | "tool_metadata_patch";
+    sourceExampleCount: number;
+    failureClasses: string[];
+    operations: CodaliPatchPlanOperation[];
+    blockedReasons: string[];
+}
+export interface CodaliPromptRegressionEvalCandidate {
+    suiteId: string;
+    sourceExportId: string;
+    wouldFailBeforeChange: true;
+    cases: Array<{
+        caseId: string;
+        sourceRecordId: string;
+        failureClasses: string[];
+        preChangeExpectedStatus: "fail";
+        postChangeExpectedStatus: "pass";
+        assertions: string[];
+        objectRefs: CodaliPatchSourceExample["objectRefs"];
+    }>;
+}
+export interface CodaliPatchImprovementCandidateSummary {
+    candidateId: string;
+    candidateKind: CodaliPatchCandidateKind;
+    status: "proposed" | "blocked";
+    patchPlanId: string;
+    sourceExportIds: string[];
+    sourceRecordIds: string[];
+    artifactIds: string[];
+    exampleCount: number;
+    objectBytes: number;
+    failureClasses: string[];
+    blockedReasons: string[];
+}
+export interface CodaliPatchCandidateBundle {
+    schemaVersion: typeof CODALI_PATCH_CANDIDATE_SCHEMA_VERSION;
+    artifact: CodaliPatchProposalArtifact;
+    source: {
+        exportId: string;
+        manifestId: string;
+        manifestPath: string;
+        exportKind: string;
+        checksum: string;
+        recordCount: number;
+        primaryArtifactRef: CodaliPatchObjectRefSummary;
+    };
+    generationPolicy: {
+        deterministic: true;
+        modifiesRuntimePrompts: false;
+        modifiesRuntimeCode: false;
+        bodyPolicy: "object_refs_only";
+        failureEvidenceRequired: true;
+        sourceExamplesRequired: true;
+    };
+    expectedShape: {
+        schemaVersion: typeof CODALI_PATCH_CANDIDATE_SCHEMA_VERSION;
+        artifact: CodaliPatchProposalArtifact;
+        requiredFields: string[];
+        sourceExampleRequiredFields: string[];
+        patchPlanRequiredFields: string[];
+    };
+    sourceExamples: CodaliPatchSourceExample[];
+    failureEvidence: CodaliPatchFailureEvidence[];
+    failureClasses: string[];
+    patchPlan: CodaliPatchPlan;
+    promptEval?: CodaliPromptRegressionEvalCandidate;
+    candidates: CodaliPatchImprovementCandidateSummary[];
+}
+export interface BuildCodaliPatchCandidateBundleInput {
+    inspection: DatasetExportManifestReaderResult;
+    artifact: CodaliPatchProposalArtifact;
+}
+export declare const buildCodaliPatchCandidateBundle: (input: BuildCodaliPatchCandidateBundleInput) => CodaliPatchCandidateBundle;
+//# sourceMappingURL=PromptSchemaToolMetadataCandidateBuilder.d.ts.map

package/dist/vendor/codali/improvement/PromptSchemaToolMetadataCandidateBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptSchemaToolMetadataCandidateBuilder.d.ts","sourceRoot":"","sources":["../../src/improvement/PromptSchemaToolMetadataCandidateBuilder.ts"],"names":[],"mappings":"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"}