agentera 3.0.0-dev.4 → 3.0.0-dev.41

package/dist/state/decisionOverlay.js

@@ -0,0 +1,255 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { dumpYamlMapping, loadYamlMapping } from "../core/yaml.js";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { assertRealpathBoundary } from "../registries/artifactRegistry.js";
+import { decisionOverlayContract, } from "./archiveDiscovery.js";
+import { reject } from "./write/errors.js";
+function isMapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function mapping(value) {
+    return isMapping(value) ? value : {};
+}
+function valueAt(value, field) {
+    let current = value;
+    for (const part of field.split(".")) {
+        if (!isMapping(current))
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function setAt(target, field, value) {
+    const parts = field.split(".");
+    let current = target;
+    for (const part of parts.slice(0, -1)) {
+        const next = current[part];
+        if (!isMapping(next))
+            current[part] = {};
+        current = current[part];
+    }
+    current[parts.at(-1)] = structuredClone(value);
+}
+function pathAllowed(field, contract) {
+    return contract.mutablePaths.some((mutable) => mutable === field || mutable.startsWith(`${field}.`));
+}
+function validateValueTypes(field, value, contract, violations) {
+    if (field.endsWith(".state")) {
+        if (typeof value !== "string" || !contract.stateValues.includes(value)) {
+            violations.push(`${field} must be one of: ${contract.stateValues.join(", ")}`);
+        }
+        return;
+    }
+    if (field.endsWith(".evidence") || field.endsWith(".confirmed_by") || field.endsWith(".confirmed_at")) {
+        if (typeof value !== "string")
+            violations.push(`${field} must be a string`);
+    }
+}
+function validateOverlayValue(value, contract, prefix = "", violations = []) {
+    if (!isMapping(value)) {
+        violations.push(`${prefix || "overlay entry"} must be a mapping`);
+        return violations;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        const field = prefix ? `${prefix}.${key}` : key;
+        if (!pathAllowed(field, contract)) {
+            violations.push(`${field} is not an authority-declared mutable overlay field`);
+            continue;
+        }
+        if (isMapping(child))
+            validateOverlayValue(child, contract, field, violations);
+        else
+            validateValueTypes(field, child, contract, violations);
+    }
+    return violations;
+}
+function decisionNumberFromId(id, contract) {
+    const prefix = `${contract.identityPrefix}:`;
+    if (!id.startsWith(prefix))
+        return null;
+    const number = id.slice(prefix.length);
+    if (!/^[1-9][0-9]*$/.test(number))
+        return null;
+    const parsed = Number(number);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
+}
+export function decisionOverlayPath(projectRoot, sourceRoot = resolveSourceRoot()) {
+    const contract = decisionOverlayContract(sourceRoot);
+    const target = path.resolve(projectRoot, contract.location);
+    assertRealpathBoundary(projectRoot, target, "decision overlay");
+    return target;
+}
+export function decisionOverlayViolations(document, contract = decisionOverlayContract()) {
+    if (!isMapping(document))
+        return ["decision overlay root must be a mapping keyed by stable decision ID"];
+    const violations = [];
+    for (const [stableId, value] of Object.entries(document)) {
+        if (decisionNumberFromId(stableId, contract) === null) {
+            violations.push(`${stableId} is not a valid ${contract.identityKey} key`);
+            continue;
+        }
+        validateOverlayValue(value, contract, "", violations);
+    }
+    return violations;
+}
+function readOverlayDocument(projectRoot, sourceRoot = resolveSourceRoot()) {
+    const contract = decisionOverlayContract(sourceRoot);
+    const target = decisionOverlayPath(projectRoot, sourceRoot);
+    if (!fs.existsSync(target))
+        return { path: target, document: {}, contract };
+    const bytes = fs.readFileSync(target, "utf8");
+    let document;
+    try {
+        document = loadYamlMapping(bytes);
+    }
+    catch (error) {
+        throw new Error(`cannot parse decision overlay '${target}': ${error.message}`);
+    }
+    const violations = decisionOverlayViolations(document, contract);
+    if (violations.length > 0)
+        throw new Error(`decision overlay '${target}' is invalid: ${violations.join("; ")}`);
+    return { path: target, document: document, contract };
+}
+export function loadDecisionOverlay(projectRoot = process.cwd(), sourceRoot = resolveSourceRoot()) {
+    return readOverlayDocument(projectRoot, sourceRoot).document;
+}
+export function hydrateDecisionRecords(entries, source = process.cwd()) {
+    const overlay = typeof source === "string" ? loadDecisionOverlay(source) : source;
+    const contract = decisionOverlayContract();
+    return entries.map((entry) => {
+        const number = entry.number;
+        const stableId = typeof number === "number" || typeof number === "string" ? `decisions:${number}` : null;
+        return composeDecisionOverlay(entry, stableId ? overlay[stableId] : undefined, contract);
+    });
+}
+export function composeDecisionOverlay(entry, overlay, contract = decisionOverlayContract()) {
+    if (!overlay)
+        return structuredClone(entry);
+    const hydrated = structuredClone(entry);
+    const historicalSatisfaction = mapping(hydrated.satisfaction);
+    const overlaySatisfaction = mapping(overlay.satisfaction);
+    const composedSatisfaction = { ...historicalSatisfaction };
+    for (const field of contract.mutablePaths) {
+        const relative = field.startsWith("satisfaction.") ? field.slice("satisfaction.".length) : field;
+        const value = valueAt(overlaySatisfaction, relative);
+        if (value !== undefined)
+            setAt(composedSatisfaction, relative, value);
+    }
+    hydrated.satisfaction = composedSatisfaction;
+    return hydrated;
+}
+export function requestedSatisfaction(requested, contract) {
+    const violations = validateOverlayValue({ satisfaction: requested }, contract);
+    if (violations.length > 0) {
+        reject({
+            class: "schema_violation",
+            message: "decision satisfaction update contains invalid overlay fields",
+            violations,
+            syntax: "agentera state decisions update --id ID --satisfaction-state STATE --format json",
+            example: "agentera state decisions update --id qjtrmnpvka --satisfaction-state provisionally_satisfied --satisfaction-evidence 'verified' --format json",
+        });
+    }
+    const result = {};
+    for (const field of contract.mutablePaths) {
+        const relative = field.startsWith("satisfaction.") ? field.slice("satisfaction.".length) : field;
+        const value = valueAt(requested, relative);
+        if (value !== undefined)
+            setAt(result, relative, value);
+    }
+    return result;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function statePath(contract) {
+    return contract.mutablePaths.find((field) => field.endsWith(".state"))?.slice("satisfaction.".length) ?? "state";
+}
+function evidencePath(contract) {
+    return contract.mutablePaths.find((field) => field.endsWith(".evidence"))?.slice("satisfaction.".length) ?? "evidence";
+}
+function confirmationPaths(contract) {
+    return contract.mutablePaths
+        .filter((field) => field.includes("user_confirmation."))
+        .map((field) => field.slice("satisfaction.".length));
+}
+function effectiveState(overlay, historicalSatisfaction) {
+    return valueAt(overlay?.satisfaction, "state") ?? valueAt(historicalSatisfaction, "state");
+}
+export function validateTransition(requested, currentOverlay, historicalSatisfaction, contract) {
+    const nextState = valueAt(requested, statePath(contract));
+    const evidence = valueAt(requested, evidencePath(contract));
+    const confirmation = mapping(requested.user_confirmation);
+    if (nextState === "provisionally_satisfied" && !nonEmptyString(evidence)) {
+        reject({
+            class: "schema_violation",
+            message: "provisionally_satisfied requires non-empty --satisfaction-evidence",
+            syntax: "agentera state decisions update --id ID --satisfaction-state STATE --satisfaction-evidence TEXT --format json",
+            example: "agentera state decisions update --id qjtrmnpvka --satisfaction-state provisionally_satisfied --satisfaction-evidence 'verified' --format json",
+        });
+    }
+    if (nextState === "user_confirmed_satisfied") {
+        const paths = confirmationPaths(contract);
+        if (paths.some((field) => !nonEmptyString(valueAt(confirmation, field.split(".").at(-1))))) {
+            reject({
+                class: "schema_violation",
+                message: "user_confirmed_satisfied requires explicit current user confirmation metadata",
+                syntax: "agentera state decisions update --id ID --satisfaction-state user_confirmed_satisfied --confirmed-by USER --confirmed-at TIME --format json",
+                example: "agentera state decisions update --id qjtrmnpvka --satisfaction-state user_confirmed_satisfied --confirmed-by user --confirmed-at 2026-07-13T12:00:00Z --format json",
+            });
+        }
+    }
+    const currentState = effectiveState(currentOverlay, historicalSatisfaction);
+    if (typeof currentState === "string" && contract.stateValues.includes(currentState)) {
+        if (!contract.allowedNext[currentState]?.includes(String(nextState))) {
+            const downgradeConfirmation = confirmationPaths(contract).every((field) => nonEmptyString(valueAt(confirmation, field.split(".").at(-1))));
+            if (!(currentState === "user_confirmed_satisfied" && downgradeConfirmation)) {
+                reject({
+                    class: "conflict",
+                    message: `decision satisfaction cannot transition from ${currentState} to ${String(nextState)} without explicit current user confirmation`,
+                    syntax: "agentera state decisions update --id ID --satisfaction-state STATE --format json",
+                    example: "agentera state decisions update --id qjtrmnpvka --satisfaction-state user_confirmed_satisfied --confirmed-by user --confirmed-at 2026-07-13T12:00:00Z --format json",
+                });
+            }
+        }
+    }
+}
+export function updateDecisionOverlay(projectRoot, decisionNumber, requested, historicalSatisfaction, transaction, publish = true, sourceRoot = resolveSourceRoot()) {
+    const current = readOverlayDocument(projectRoot, sourceRoot);
+    const stableId = `${current.contract.identityPrefix}:${decisionNumber}`;
+    const currentEntry = current.document[stableId];
+    const satisfaction = requestedSatisfaction(requested, current.contract);
+    validateTransition(satisfaction, currentEntry, historicalSatisfaction, current.contract);
+    const nextDocument = structuredClone(current.document);
+    const replay = Boolean(currentEntry && isDeepStrictEqual(currentEntry.satisfaction, satisfaction));
+    if (!replay)
+        nextDocument[stableId] = { satisfaction };
+    if (!replay && publish) {
+        const bytes = dumpYamlMapping(nextDocument);
+        const violations = decisionOverlayViolations(nextDocument, current.contract);
+        if (violations.length > 0) {
+            reject({
+                class: "schema_violation",
+                message: "decision overlay publication failed validation",
+                violations,
+            });
+        }
+        const stage = transaction.stageProjection(current.path, bytes);
+        try {
+            transaction.syncStaged(stage);
+            transaction.publishProjection(stage, current.path);
+        }
+        finally {
+            transaction.removeStage(stage);
+        }
+    }
+    return {
+        path: current.path,
+        satisfaction,
+        replay,
+        before: current.document,
+        after: nextDocument,
+    };
+}
+//# sourceMappingURL=decisionOverlay.js.map

package/dist/state/decisionOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionOverlay.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/state/decisionOverlay.ts"],"names":[],"mappings":"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"}

package/dist/state/decisionRevision.js

@@ -0,0 +1,257 @@
+import path from "node:path";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { loadStateStorageAuthority } from "./stateStorageAuthority.js";
+const EXPECTED_AUTHORITY_SCHEMA = "agentera.stateStorageAuthority.v1";
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function requiredString(value, field) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`state storage authority field '${field}' must be a non-empty string`);
+    }
+    return value;
+}
+function requiredList(value, field) {
+    if (!Array.isArray(value) ||
+        value.some((item) => typeof item !== "string" || item.length === 0)) {
+        throw new Error(`state storage authority field '${field}' must be a list of non-empty strings`);
+    }
+    return value;
+}
+function readAuthority(sourceRoot) {
+    const authority = loadStateStorageAuthority(sourceRoot).document;
+    if (authority.schema_version !== EXPECTED_AUTHORITY_SCHEMA) {
+        throw new Error("state storage authority schema_version is unsupported");
+    }
+    if (authority.status !== "active_authority") {
+        throw new Error("state storage authority must be active_authority");
+    }
+    return authority;
+}
+function overlayCrossCheck(authority) {
+    const overlays = mapping(authority.overlays);
+    const identityKey = requiredString(overlays.identity_key, "overlays.identity_key");
+    const identityPrefix = identityKey.split(":")[0];
+    if (!identityPrefix || identityKey !== `${identityPrefix}:<decision-number>`) {
+        throw new Error("state storage authority overlays.identity_key is unsupported");
+    }
+    return {
+        identityPrefix,
+        mutablePaths: requiredList(overlays.mutable_paths, "overlays.mutable_paths"),
+    };
+}
+export function decisionRevisionContract(sourceRoot = resolveSourceRoot()) {
+    const authority = readAuthority(sourceRoot);
+    const revisions = mapping(authority.revisions);
+    if (Object.keys(revisions).length === 0) {
+        throw new Error("state storage authority revisions section is required");
+    }
+    const location = requiredString(revisions.location, "revisions.location");
+    if (path.isAbsolute(location) || location.split(/[\\/]/).some((part) => part === "..")) {
+        throw new Error("state storage authority revisions location must be project-relative");
+    }
+    const identityKey = requiredString(revisions.identity_key, "revisions.identity_key");
+    const identityPrefix = identityKey.split(":")[0];
+    if (!identityPrefix || identityKey !== `${identityPrefix}:<decision-number>`) {
+        throw new Error("state storage authority revisions identity_key is unsupported");
+    }
+    const overlay = overlayCrossCheck(authority);
+    if (identityPrefix !== overlay.identityPrefix) {
+        throw new Error("state storage authority revisions identity_key prefix must match the overlay identity");
+    }
+    const amendablePaths = requiredList(revisions.amendable_paths, "revisions.amendable_paths");
+    const legacyAmendablePaths = requiredList(revisions.legacy_amendable_paths, "revisions.legacy_amendable_paths");
+    const migrationAmendablePaths = requiredList(revisions.migration_amendable_paths, "revisions.migration_amendable_paths");
+    const identityPaths = requiredList(revisions.identity_paths, "revisions.identity_paths");
+    const temporalPaths = requiredList(revisions.temporal_paths, "revisions.temporal_paths");
+    const reserved = new Set([...identityPaths, ...temporalPaths]);
+    for (const [field, paths] of [["amendable_paths", amendablePaths], ["legacy_amendable_paths", legacyAmendablePaths], ["migration_amendable_paths", migrationAmendablePaths]]) {
+        for (const amendable of paths) {
+            if (reserved.has(amendable)) {
+                throw new Error(`state storage authority revisions.${field} must not include identity or temporal path '${amendable}'`);
+            }
+            if (overlay.mutablePaths.some((mutable) => amendable === mutable || amendable.startsWith(`${mutable}.`))) {
+                throw new Error(`state storage authority revisions.${field} must not overlap overlay mutable path '${amendable}'`);
+            }
+        }
+    }
+    return {
+        location,
+        legacySourceState: requiredString(revisions.legacy_source_state, "revisions.legacy_source_state"),
+        schemaVersion: requiredString(revisions.schema_version, "revisions.schema_version"),
+        identityKey,
+        identityPrefix,
+        amendablePaths,
+        legacyAmendablePaths,
+        migrationAmendablePaths,
+        currentConfidenceVocabulary: requiredList(mapping(mapping(authority.compatibility).legacy_label_coexistence).current_vocabulary, "compatibility.legacy_label_coexistence.current_vocabulary"),
+        knownLegacyConfidenceValues: requiredList(mapping(mapping(authority.compatibility).legacy_label_coexistence).known_legacy_examples, "compatibility.legacy_label_coexistence.known_legacy_examples"),
+        identityPaths,
+        temporalPaths,
+        separationFromOverlay: requiredString(revisions.separation_from_overlay, "revisions.separation_from_overlay"),
+        immutability: requiredString(revisions.immutability, "revisions.immutability"),
+        provenance: requiredString(revisions.provenance, "revisions.provenance"),
+        publicationOrder: requiredList(revisions.publication_order, "revisions.publication_order"),
+        applyState: requiredString(revisions.apply_state, "revisions.apply_state"),
+        applyStateNote: requiredString(revisions.apply_state_note, "revisions.apply_state_note"),
+    };
+}
+export function legacyLabelCoexistence(sourceRoot = resolveSourceRoot()) {
+    const authority = readAuthority(sourceRoot);
+    const compatibility = mapping(authority.compatibility);
+    const coexistence = mapping(compatibility.legacy_label_coexistence);
+    if (Object.keys(coexistence).length === 0) {
+        throw new Error("state storage authority compatibility.legacy_label_coexistence section is required");
+    }
+    const currentVocabulary = requiredList(coexistence.current_vocabulary, "compatibility.legacy_label_coexistence.current_vocabulary");
+    if (currentVocabulary.length === 0) {
+        throw new Error("state storage authority legacy_label_coexistence.current_vocabulary must be non-empty");
+    }
+    return {
+        dimensions: requiredList(coexistence.dimensions, "compatibility.legacy_label_coexistence.dimensions"),
+        currentVocabulary,
+        currentVocabularyRef: requiredString(coexistence.current_vocabulary_ref, "compatibility.legacy_label_coexistence.current_vocabulary_ref"),
+        knownLegacyExamples: requiredList(coexistence.known_legacy_examples, "compatibility.legacy_label_coexistence.known_legacy_examples"),
+        classificationRule: requiredString(coexistence.classification_rule, "compatibility.legacy_label_coexistence.classification_rule"),
+        noSilentNormalization: requiredString(coexistence.no_silent_normalization, "compatibility.legacy_label_coexistence.no_silent_normalization"),
+    };
+}
+export function classifyConfidenceLabel(contract, value, touched) {
+    const vocabulary = contract.currentVocabulary.join(", ");
+    if (contract.currentVocabulary.includes(value)) {
+        return { classification: "current", allowed: true, caveat: "" };
+    }
+    if (!touched) {
+        return {
+            classification: "explicit_legacy",
+            allowed: true,
+            caveat: `inherited unsupported confidence label '${value}' is explicit legacy state; current vocabulary is ${vocabulary}`,
+        };
+    }
+    return {
+        classification: "rejected",
+        allowed: false,
+        caveat: `confidence label '${value}' requires current vocabulary (${vocabulary}) for new or amended content`,
+    };
+}
+export const REVISION_PROVENANCE_VALUES = ["historical_revision", "degraded_projection"];
+const REVISION_META_KEYS = new Set(["date", "provenance", "base_sha256"]);
+const FORBIDDEN_REVISION_PROVENANCE = "historical_archive";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function decisionNumberFromId(id, contract) {
+    const prefix = `${contract.identityPrefix}:`;
+    if (!id.startsWith(prefix))
+        return null;
+    const number = id.slice(prefix.length);
+    if (!/^[1-9][0-9]*$/.test(number))
+        return null;
+    const parsed = Number(number);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
+}
+export function decisionRevisionViolations(document, contract = decisionRevisionContract()) {
+    if (!isRecord(document)) {
+        return ["decision revision root must be a mapping keyed by stable decision ID"];
+    }
+    const amendable = new Set(contract.legacyAmendablePaths);
+    const allowed = new Set([...REVISION_META_KEYS, ...contract.legacyAmendablePaths]);
+    const violations = [];
+    for (const [stableId, value] of Object.entries(document)) {
+        if (decisionNumberFromId(stableId, contract) === null) {
+            violations.push(`${stableId} is not a valid ${contract.identityKey} key`);
+            continue;
+        }
+        if (!Array.isArray(value)) {
+            violations.push(`${stableId} must be an ordered list of revision records`);
+            continue;
+        }
+        value.forEach((revision, index) => {
+            violations.push(...decisionRevisionRecordViolations(revision, `${stableId}[${index}]`, contract, allowed, amendable, contract.legacyAmendablePaths, true));
+        });
+    }
+    return violations;
+}
+function decisionRevisionRecordViolations(revision, label, contract, allowed = new Set([...REVISION_META_KEYS, ...contract.amendablePaths, ...contract.migrationAmendablePaths]), amendable = new Set([...contract.amendablePaths, ...contract.migrationAmendablePaths]), amendablePaths = [...contract.amendablePaths, ...contract.migrationAmendablePaths], legacy = false, allowLegacyConfidence = false) {
+    if (!isRecord(revision))
+        return [`${label} must be a mapping of amendable fields and revision provenance`];
+    const violations = [];
+    for (const key of Object.keys(revision)) {
+        if (!allowed.has(key))
+            violations.push(`${label} carries '${key}' which is not an amendable content path or revision meta key`);
+    }
+    if ("alternatives" in revision && ("alternatives.chosen" in revision || "alternatives.rejected" in revision)) {
+        violations.push(`${label} must not mix migration-only alternatives replacement with granular alternative changes`);
+    }
+    for (const key of amendable) {
+        if (!(key in revision))
+            continue;
+        const value = revision[key];
+        if (key === "alternatives") {
+            const alternatives = Array.isArray(value) ? value : [];
+            const malformed = !Array.isArray(value)
+                || alternatives.length === 0
+                || alternatives.some((entry) => {
+                    const candidate = isRecord(entry) ? entry : {};
+                    return typeof candidate.name !== "string"
+                        || candidate.name.length === 0
+                        || !["chosen", "rejected"].includes(String(candidate.status));
+                })
+                || alternatives.filter((entry) => isRecord(entry) && entry.status === "chosen").length !== 1;
+            if (malformed) {
+                violations.push(`${label}.alternatives must be a non-empty list with exactly one named chosen alternative and zero or more named rejected alternatives`);
+            }
+        }
+        else if (key === "alternatives.rejected") {
+            if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string" || entry.length === 0)) {
+                violations.push(`${label}.alternatives.rejected must be a list of non-empty strings`);
+            }
+        }
+        else if (typeof value !== "string" || value.length === 0) {
+            violations.push(`${label}.${key} must be a non-empty string`);
+        }
+        else if (key === "confidence" && !legacy && !contract.currentConfidenceVocabulary.includes(value) && !(allowLegacyConfidence && contract.knownLegacyConfidenceValues.includes(value))) {
+            violations.push(`${label}.confidence '${value}' is not one of: ${contract.currentConfidenceVocabulary.join(", ")}`);
+        }
+    }
+    const provenance = revision.provenance;
+    if (provenance !== undefined) {
+        if (typeof provenance !== "string")
+            violations.push(`${label}.provenance must be a string`);
+        else if (provenance === FORBIDDEN_REVISION_PROVENANCE)
+            violations.push(`${label}.provenance must never claim historical_archive provenance`);
+        else if (!REVISION_PROVENANCE_VALUES.includes(provenance)) {
+            violations.push(`${label}.provenance '${provenance}' is not one of: ${REVISION_PROVENANCE_VALUES.join(", ")}`);
+        }
+    }
+    const baseSha = revision.base_sha256;
+    if (baseSha !== undefined && (typeof baseSha !== "string" || !/^[0-9a-f]{64}$/.test(baseSha))) {
+        violations.push(`${label}.base_sha256 must be a 64-character sha256 hex digest`);
+    }
+    const date = revision.date;
+    if (date !== undefined && (typeof date !== "string" || date.length === 0)) {
+        violations.push(`${label}.date must be a non-empty string`);
+    }
+    if (!Object.keys(revision).some((key) => amendable.has(key))) {
+        violations.push(`${label} must amend at least one content field (${amendablePaths.join(", ")})`);
+    }
+    return violations;
+}
+export function decisionRevisionEntityViolations(record, contract = decisionRevisionContract(), allowLegacyConfidence = false) {
+    if (!isRecord(record.changes))
+        return ["decision revision changes must be a mapping of amendable fields"];
+    const amendable = new Set([...contract.amendablePaths, ...contract.migrationAmendablePaths]);
+    const violations = Object.keys(record.changes)
+        .filter((key) => !amendable.has(key))
+        .map((key) => `decision revision changes carries '${key}' which is not an amendable content path`);
+    violations.push(...decisionRevisionRecordViolations({
+        ...record.changes,
+        date: record.date,
+        provenance: record.provenance,
+        base_sha256: record.base_sha256,
+    }, "decision revision", contract, undefined, undefined, undefined, false, allowLegacyConfidence));
+    return violations;
+}
+//# sourceMappingURL=decisionRevision.js.map

package/dist/state/decisionRevision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionRevision.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/state/decisionRevision.ts"],"names":[],"mappings":"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"}

package/dist/state/decisionRevisionMigration.js

@@ -0,0 +1,90 @@
+import { createHash } from "node:crypto";
+import { canonicalRecordJson, validateStateRecord } from "./archiveDiscovery.js";
+import { canonicalMigrationRecord } from "./canonicalMigrationRecord.js";
+import { applyDecisionChanges } from "./decisionEntities.js";
+import { classifyCompleteDecisionConfidence, decisionLegacyCoexistence } from "./decisionLegacyValidation.js";
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function hash(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function refuse(entry, recovery) {
+    entry.classification = "corrupt";
+    entry.detail_availability = "unavailable";
+    entry.compatibility = "degraded";
+    entry.proposed_target = null;
+    entry.target_sha256 = null;
+    entry.recovery = recovery;
+}
+function changesFrom(source) {
+    const changes = mapping(source.changes);
+    return structuredClone(changes ?? Object.fromEntries(Object.entries(source).filter(([field]) => !["decision", "date", "provenance", "base_sha256"].includes(field))));
+}
+export function migrateDecisionRevisionEntries(entries, decisions, legacyDecisions, sourceRoot, forbiddenAliases, sourceFingerprint) {
+    const coexistence = decisionLegacyCoexistence(sourceRoot);
+    const grouped = new Map();
+    for (const entry of entries.filter(({ boundary }) => boundary === "decision_revision")) {
+        const decision = entry.relationships.find(({ field }) => field === "decision")?.target_id ?? "";
+        grouped.set(decision, [...(grouped.get(decision) ?? []), entry]);
+    }
+    for (const [decision, revisions] of grouped) {
+        let effective = structuredClone(decisions.get(decision) ?? {});
+        const legacyBase = legacyDecisions.get(decision);
+        let legacyEffective = structuredClone(legacyBase ?? {});
+        const legacyBaseSha256 = legacyBase ? hash(canonicalRecordJson(legacyBase)) : null;
+        let chainValid = decisions.has(decision) && legacyBaseSha256 !== null;
+        for (const entry of revisions.sort((left, right) => left.source_identity.localeCompare(right.source_identity, undefined, { numeric: true }))) {
+            if (!entry.proposed_target) {
+                chainValid = false;
+                continue;
+            }
+            const source = entry.record;
+            const changes = changesFrom(source);
+            const expectedBase = hash(canonicalRecordJson(effective));
+            const claimedBase = typeof source.base_sha256 === "string" ? source.base_sha256 : null;
+            if (!chainValid || (claimedBase !== null && claimedBase !== legacyBaseSha256)) {
+                refuse(entry, claimedBase !== null && claimedBase !== legacyBaseSha256
+                    ? `Legacy revision '${entry.source_identity}' claims base ${claimedBase}, but the immutable legacy base is ${legacyBaseSha256}; preserve the source and reconcile the stale hash before migration.`
+                    : `Legacy revision '${entry.source_identity}' follows an invalid or unavailable revision base; preserve the source and repair the ordered chain before migration.`);
+                chainValid = false;
+                continue;
+            }
+            const legacyProjected = { ...legacyEffective, ...structuredClone(changes) };
+            const assessment = classifyCompleteDecisionConfidence(legacyProjected, coexistence, (candidate) => validateStateRecord(sourceRoot, "decisions", candidate), "active");
+            if (assessment.status === "invalid") {
+                refuse(entry, `Legacy revision '${entry.source_identity}' produces an invalid effective decision (${assessment.violations.join("; ")}); preserve the source and repair the revision before migration.`);
+                chainValid = false;
+                continue;
+            }
+            const projected = applyDecisionChanges(effective, changes);
+            const expectedProjection = canonicalMigrationRecord("decision", legacyProjected, forbiddenAliases);
+            if (canonicalRecordJson(projected) !== canonicalRecordJson(expectedProjection)) {
+                refuse(entry, `Legacy revision '${entry.source_identity}' cannot be represented by canonical decision changes without altering its effective value; preserve the source and repair the revision before migration.`);
+                chainValid = false;
+                continue;
+            }
+            entry.record = {
+                decision,
+                ...(typeof source.date === "string" ? { date: source.date } : {}),
+                provenance: typeof source.provenance === "string" ? source.provenance : "historical_revision",
+                base_sha256: expectedBase,
+                changes,
+            };
+            if (typeof changes.confidence === "string" && coexistence.knownLegacyExamples.includes(changes.confidence)) {
+                entry.canonical_migration_provenance = {
+                    kind: "inherited_decision_revision_confidence",
+                    source: "revision_document",
+                    source_path: entry.source_paths[0],
+                    source_identity: entry.source_identity,
+                    source_fingerprint: sourceFingerprint,
+                    source_record_sha256: entry.content_sha256 ?? hash(canonicalRecordJson(source)),
+                    confidence: changes.confidence,
+                };
+            }
+            effective = projected;
+            legacyEffective = legacyProjected;
+        }
+    }
+}
+//# sourceMappingURL=decisionRevisionMigration.js.map