agentera 3.0.0-dev.3 → 3.0.0-dev.31

package/dist/state/decisionMigrationProvenance.js

@@ -0,0 +1,117 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { loadYamlMapping } from "../core/yaml.js";
+import { canonicalRecordJson, numberedArchiveContract, stateCurrentProjectionPath, validateNumberedArchiveBytes, validateStateRecord } from "./archiveDiscovery.js";
+import { canonicalMigrationRecord } from "./canonicalMigrationRecord.js";
+import { classifyCompleteDecisionConfidence } from "./decisionLegacyValidation.js";
+import { legacyLabelCoexistence } from "./decisionRevision.js";
+import { readBoundMigrationSource } from "./migrationSourceBinding.js";
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Validate the sole authority-declared canonical migration metadata shape. */
+export function decisionMigrationProvenanceViolations(record, provenance, declared, forbiddenAliases, sourceRoot, binding) {
+    if (declared.additionalFields !== "forbidden" || !declared.kind || declared.requiredFields.length === 0 || declared.sources.length === 0) {
+        throw new Error("invalid migration provenance authority for 'decision'");
+    }
+    const coexistence = legacyLabelCoexistence(sourceRoot ?? resolveSourceRoot());
+    const confidence = record.confidence;
+    if (typeof confidence !== "string")
+        return ["confidence must be a string from the authority-declared vocabulary"];
+    if (coexistence.currentVocabulary.includes(confidence)) {
+        return provenance === null || provenance === undefined ? [] : ["migration_provenance is allowed only for an inherited unsupported confidence"];
+    }
+    if (!coexistence.knownLegacyExamples.includes(confidence))
+        return [`unsupported decision confidence '${confidence}'`];
+    if (!mapping(provenance))
+        return ["an inherited unsupported confidence requires mapping migration_provenance"];
+    const violations = [];
+    const declaredKeys = new Set(declared.requiredFields);
+    for (const field of declared.requiredFields)
+        if (!(field in provenance))
+            violations.push(`migration_provenance.${field} is required`);
+    for (const field of Object.keys(provenance))
+        if (!declaredKeys.has(field))
+            violations.push(`migration_provenance.${field} is not allowed`);
+    if (provenance.kind !== declared.kind)
+        violations.push(`migration_provenance.kind must be '${declared.kind}'`);
+    if (typeof provenance.source !== "string" || !declared.sources.includes(provenance.source))
+        violations.push(`migration_provenance.source must be one of: ${declared.sources.join(", ")}`);
+    if (typeof provenance.source_path !== "string" || provenance.source_path.length === 0 || path.isAbsolute(provenance.source_path) || provenance.source_path.split(/[\\/]/).includes(".."))
+        violations.push("migration_provenance.source_path must be a safe project-relative path");
+    if (typeof provenance.source_record_sha256 !== "string" || !/^[a-f0-9]{64}$/.test(provenance.source_record_sha256))
+        violations.push("migration_provenance.source_record_sha256 must be a lowercase SHA-256 digest");
+    if (provenance.confidence !== confidence)
+        violations.push("migration_provenance.confidence must match record.confidence");
+    if (violations.length)
+        return violations;
+    if (binding === undefined)
+        return ["an inherited unsupported confidence requires a source binding context"];
+    violations.push(...sourceBindingViolations(record, provenance, binding, sourceRoot ?? resolveSourceRoot(), forbiddenAliases));
+    return violations;
+}
+function sourceAssessment(record, sourceRoot, source) {
+    return classifyCompleteDecisionConfidence(record, legacyLabelCoexistence(sourceRoot), (candidate) => validateStateRecord(sourceRoot, "decisions", candidate), source);
+}
+function sourceMatchesCanonical(source, canonical, forbiddenAliases) {
+    return canonicalRecordJson(canonicalMigrationRecord("decision", source, forbiddenAliases)) === canonicalRecordJson(canonical);
+}
+function sourceHash(record) {
+    return createHash("sha256").update(canonicalRecordJson(record)).digest("hex");
+}
+function sourceBindingViolations(record, provenance, binding, sourceRoot, forbiddenAliases) {
+    const sourcePath = String(provenance.source_path);
+    const digest = String(provenance.source_record_sha256);
+    const confidence = String(provenance.confidence);
+    if (provenance.source === "current_projection") {
+        const declaredPath = path.relative("/", stateCurrentProjectionPath("/", "decisions", sourceRoot)).split(path.sep).join("/");
+        if (sourcePath !== declaredPath)
+            return [`migration_provenance.source_path must be the authority-declared current projection '${declaredPath}'`];
+        const sourceFile = readBoundMigrationSource(binding, declaredPath);
+        if (sourceFile.kind !== "file")
+            return [`migration_provenance source '${declaredPath}' is ${sourceFile.kind === "missing" ? "missing" : `unsafe (${sourceFile.reason})`}`];
+        let document;
+        try {
+            document = loadYamlMapping(sourceFile.bytes);
+        }
+        catch (error) {
+            return [`migration_provenance source '${declaredPath}' is invalid YAML: ${error.message}`];
+        }
+        const candidates = [document.decisions, document.archive].flatMap((value) => Array.isArray(value) ? value.filter(mapping) : []);
+        const candidate = candidates.find((source) => sourceHash(source) === digest && source.confidence === confidence && sourceMatchesCanonical(source, record, forbiddenAliases));
+        if (!candidate)
+            return ["migration_provenance does not match any complete decision in the preserved current projection"];
+        const assessment = sourceAssessment(candidate, sourceRoot, "active");
+        return assessment.status === "inherited" ? [] : ["migration_provenance current-projection source is not a complete inherited-confidence decision"];
+    }
+    const contract = numberedArchiveContract("decisions", sourceRoot);
+    const archivePrefix = path.posix.join(contract.archiveRoot, "decisions");
+    const escapedExtension = contract.archiveExtension.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const match = new RegExp(`^${archivePrefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/([1-9][0-9]*)${escapedExtension}$`).exec(sourcePath);
+    if (!match)
+        return [`migration_provenance.source_path must be an authority-valid numbered decision archive path under '${archivePrefix}'`];
+    const entryNumber = Number(match[1]);
+    const sourceFile = readBoundMigrationSource(binding, sourcePath);
+    if (sourceFile.kind !== "file")
+        return [`migration_provenance archive source is ${sourceFile.kind === "missing" ? "missing" : `unsafe (${sourceFile.reason})`}: ${sourcePath}`];
+    const lookup = validateNumberedArchiveBytes("decisions", entryNumber, sourceFile.bytes, {
+        sourceRoot,
+        sourcePath,
+        recordValidator: (source) => {
+            const assessment = sourceAssessment(source, sourceRoot, "archive");
+            return assessment.status === "inherited" ? [] : assessment.violations.length ? assessment.violations : ["archive decision is not inherited legacy confidence"];
+        },
+    });
+    if (!lookup.entry?.record)
+        return [`migration_provenance archive source is missing or invalid: ${lookup.rejection?.message ?? sourcePath}`];
+    const source = lookup.entry.record;
+    if (lookup.entry.recordSha256 !== digest || sourceHash(source) !== digest)
+        return ["migration_provenance source_record_sha256 does not match the authority-valid archive record"];
+    if (source.confidence !== confidence)
+        return ["migration_provenance confidence does not match the archive record"];
+    if (!sourceMatchesCanonical(source, record, forbiddenAliases))
+        return ["migration_provenance archive record does not correspond to the canonical decision content"];
+    return [];
+}
+//# sourceMappingURL=decisionMigrationProvenance.js.map

package/dist/state/decisionMigrationProvenance.js.map

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

package/dist/state/decisionOverlay.js

@@ -0,0 +1,278 @@
+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 { composeDecisionRevision, decisionRevisionContract, loadDecisionRevision, } from "./decisionRevision.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();
+    // Revisions (content authority) compose over the base before and separately
+    // from the satisfaction overlay. When the source is a project root, load the
+    // revision document once so the compaction consumer sees one latest effective
+    // record per decision. Skipped for explicit overlay documents (decision-only
+    // callers) where no project root is available.
+    const revisionDocument = typeof source === "string" ? loadRevisionDocument(source) : {};
+    const revisionContract = revisionDocument ? decisionRevisionContract() : null;
+    return entries.map((entry) => {
+        const number = entry.number;
+        const stableId = typeof number === "number" || typeof number === "string" ? `decisions:${number}` : null;
+        const effective = stableId && revisionContract && revisionDocument[stableId]
+            ? composeDecisionRevision(entry, revisionDocument[stableId], { contract: revisionContract }).record
+            : entry;
+        return composeDecisionOverlay(effective, stableId ? overlay[stableId] : undefined, contract);
+    });
+}
+function loadRevisionDocument(projectRoot) {
+    try {
+        return loadDecisionRevision(projectRoot);
+    }
+    catch {
+        // A missing revision document is the common case (no amendments yet). A
+        // corrupt document surfaces at read time via the focused read consumers;
+        // compaction degrades rather than forcing amendment awareness for plain
+        // overlay composition paths.
+        return {};
+    }
+}
+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 --number N --satisfaction-state STATE --format json",
+            example: "agentera state decisions update --number 53 --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 --number N --satisfaction-state STATE --satisfaction-evidence TEXT --format json",
+            example: "agentera state decisions update --number 53 --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 --number N --satisfaction-state user_confirmed_satisfied --confirmed-by USER --confirmed-at TIME --format json",
+                example: "agentera state decisions update --number 53 --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 --number N --satisfaction-state STATE --format json",
+                    example: "agentera state decisions update --number 53 --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/packages/cli/src/state/decisionOverlay.ts"],"names":[],"mappings":"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"}