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

package/dist/state/progressGlossaryCaveat.js

@@ -0,0 +1,169 @@
+import { glossaryCaveatPairAllowed, glossaryCaveatContract, } from "../registries/glossaryCaveatContract.js";
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function boundedString(value, contract) {
+    return (typeof value === "string" &&
+        value.length > 0 &&
+        Buffer.byteLength(value, "utf8") <= contract.maxStringUtf8Bytes);
+}
+function isProjectionSource(entity, contract) {
+    return entity.artifact === contract.primeSourceArtifact && entity.boundary === contract.primeSourceBoundary;
+}
+export function validateProgressGlossaryCaveat(record, contract = glossaryCaveatContract()) {
+    if (!Object.prototype.hasOwnProperty.call(record, "glossary_caveat")) {
+        return { status: "absent", caveat: null, violations: [] };
+    }
+    const value = record.glossary_caveat;
+    const violations = [];
+    if (!mapping(value)) {
+        return {
+            status: "invalid",
+            caveat: null,
+            violations: ["glossary_caveat must be one privacy-safe mapping"],
+        };
+    }
+    const keys = Object.keys(value);
+    if (keys.length !== contract.fields.length ||
+        keys.some((field) => !contract.fields.includes(field))) {
+        violations.push("glossary_caveat must contain exactly the authority-declared fields");
+    }
+    if (contract.fields.some((field) => !(field in value))) {
+        violations.push("glossary_caveat requires every authority-declared field");
+    }
+    for (const field of ["caveat_id", "event", "capability", "reason", "ownership_state"])
+        if (!boundedString(value[field], contract))
+            violations.push("glossary_caveat string fields must be non-empty and bounded");
+    if (!contract.idPattern.test(typeof value.caveat_id === "string" ? value.caveat_id : ""))
+        violations.push("glossary_caveat caveat_id must be one opaque ID");
+    if (!contract.events.includes(typeof value.event === "string" ? value.event : ""))
+        violations.push("glossary_caveat event is outside the bounded vocabulary");
+    if (!contract.capabilities.includes(typeof value.capability === "string" ? value.capability : ""))
+        violations.push("glossary_caveat capability is outside the bounded vocabulary");
+    if (value.capability !== contract.primeSourceCapability)
+        violations.push("glossary_caveat capability does not own prime projection evidence");
+    if (!contract.reasons.includes(typeof value.reason === "string" ? value.reason : ""))
+        violations.push("glossary_caveat reason is outside the bounded vocabulary");
+    if (!contract.ownershipStates.includes(typeof value.ownership_state === "string" ? value.ownership_state : ""))
+        violations.push("glossary_caveat ownership_state is outside the bounded vocabulary");
+    if (typeof value.reason === "string" &&
+        typeof value.ownership_state === "string" &&
+        !glossaryCaveatPairAllowed(contract, value.reason, value.ownership_state))
+        violations.push("glossary_caveat reason and ownership_state pair is not allowed");
+    const transition = value.transition_id;
+    if (!(transition === null || boundedString(transition, contract)))
+        violations.push("glossary_caveat transition_id must be null or one bounded opaque ID");
+    if (typeof transition === "string" && !contract.idPattern.test(transition))
+        violations.push("glossary_caveat transition_id must be one opaque ID");
+    if ((value.event === "current" || value.event === "resolved") && transition !== null)
+        violations.push("current and resolved glossary_caveat events require null transition_id");
+    if (value.event === "superseded" &&
+        (typeof transition !== "string" || transition === value.caveat_id))
+        violations.push("superseded glossary_caveat requires one different successor ID");
+    if (violations.length)
+        return { status: "invalid", caveat: null, violations: [...new Set(violations)] };
+    return { status: "valid", caveat: value, violations: [] };
+}
+export function glossaryCaveatLifecycleInvalidEntities(entities, contract = glossaryCaveatContract()) {
+    const rows = entities.flatMap((entity) => {
+        if (entity.classification !== "valid" || !entity.record)
+            return [];
+        const result = validateProgressGlossaryCaveat(entity.record, contract);
+        return result.status === "valid" ? [{ entity, caveat: result.caveat }] : [];
+    });
+    const invalid = new Set();
+    const byId = new Map();
+    for (const row of rows)
+        byId.set(row.caveat.caveat_id, [...(byId.get(row.caveat.caveat_id) ?? []), row]);
+    const transitions = new Map();
+    for (const [id, matches] of byId) {
+        const current = matches.filter(({ caveat }) => caveat.event === "current");
+        const terminal = matches.filter(({ caveat }) => caveat.event !== "current");
+        if (current.length !== 1) {
+            matches.forEach(({ entity }) => invalid.add(entity));
+            continue;
+        }
+        if (terminal.length > 1) {
+            terminal.forEach(({ entity }) => invalid.add(entity));
+            continue;
+        }
+        if (terminal.length && current.length === 1) {
+            const base = current[0].caveat;
+            for (const row of terminal) {
+                if (row.caveat.capability !== base.capability ||
+                    row.caveat.reason !== base.reason ||
+                    row.caveat.ownership_state !== base.ownership_state) {
+                    invalid.add(row.entity);
+                    continue;
+                }
+                if (row.caveat.event === "superseded") {
+                    const target = byId.get(row.caveat.transition_id) ?? [];
+                    if (target.filter(({ caveat }) => caveat.event === "current").length !== 1) {
+                        invalid.add(row.entity);
+                    }
+                    else
+                        transitions.set(id, { target: row.caveat.transition_id, entity: row.entity });
+                }
+            }
+        }
+    }
+    for (const start of transitions.keys()) {
+        const seen = new Set();
+        let cursor = start;
+        while (cursor && !seen.has(cursor)) {
+            seen.add(cursor);
+            cursor = transitions.get(cursor)?.target;
+        }
+        if (cursor)
+            for (const id of seen) {
+                const transition = transitions.get(id);
+                if (transition)
+                    invalid.add(transition.entity);
+            }
+    }
+    return invalid;
+}
+/** Project only validated lifecycle state; opaque identities never leave this module. */
+export function projectCurrentGlossaryCaveats(entities, contract = glossaryCaveatContract()) {
+    const byId = new Map();
+    for (const entity of entities) {
+        if (entity.classification !== "valid" ||
+            !entity.record ||
+            !isProjectionSource(entity, contract))
+            continue;
+        const result = validateProgressGlossaryCaveat(entity.record, contract);
+        if (result.status !== "valid")
+            continue;
+        byId.set(result.caveat.caveat_id, [
+            ...(byId.get(result.caveat.caveat_id) ?? []),
+            result.caveat,
+        ]);
+    }
+    let currentCount = 0;
+    for (const events of byId.values()) {
+        if (events.some(({ event }) => event === "current") &&
+            !events.some(({ event }) => event !== "current"))
+            currentCount += 1;
+    }
+    return {
+        currentCount,
+        attention: currentCount > 0 && contract.primeAttentionText ? contract.primeAttentionText : null,
+        publicAttentionLimit: contract.primePublicAttentionLimit,
+        reservedGlossarySlots: contract.primeReservedGlossarySlots,
+    };
+}
+export function applyGlossaryCaveatLifecycleValidation(projectRoot, entities, issues, contract) {
+    for (const entity of glossaryCaveatLifecycleInvalidEntities(entities.filter((candidate) => isProjectionSource(candidate, contract)), contract)) {
+        entity.classification = "malformed";
+        issues.push({
+            code: "malformed_entity",
+            path: entity.relativePath,
+            id: entity.id ?? undefined,
+            artifact: entity.artifact ?? undefined,
+            boundary: entity.boundary ?? undefined,
+            message: `entity '${entity.relativePath}' has an invalid glossary caveat lifecycle relation`,
+            recovery: `repair '${entity.relativePath}' using the Build-owned progress glossary caveat lifecycle; rerun agentera check validate state --cwd ${JSON.stringify(projectRoot)}`,
+        });
+    }
+}
+//# sourceMappingURL=progressGlossaryCaveat.js.map

package/dist/state/progressGlossaryCaveat.js.map

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

package/dist/state/progressPublicationOrder.js

@@ -0,0 +1,20 @@
+export const PROGRESS_PUBLICATION_ORDER_FIELD = "publication_order";
+export function progressPublicationOrder(record) {
+    const value = record?.[PROGRESS_PUBLICATION_ORDER_FIELD];
+    return Number.isSafeInteger(value) && Number(value) > 0 ? Number(value) : null;
+}
+export function progressPublicationOrderViolations(record) {
+    if (!(PROGRESS_PUBLICATION_ORDER_FIELD in record))
+        return [];
+    return progressPublicationOrder(record) === null
+        ? ["publication_order must be a positive safe integer when present"]
+        : [];
+}
+export function nextProgressPublicationOrder(records) {
+    const maximum = records.reduce((current, record) => Math.max(current, progressPublicationOrder(record) ?? 0), 0);
+    if (maximum >= Number.MAX_SAFE_INTEGER) {
+        throw new Error("progress publication order is exhausted; preserve state and request repair before retrying");
+    }
+    return maximum + 1;
+}
+//# sourceMappingURL=progressPublicationOrder.js.map

package/dist/state/progressPublicationOrder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressPublicationOrder.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/state/progressPublicationOrder.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAG,mBAAmB,CAAC;AAEpE,MAAM,UAAU,wBAAwB,CAAC,MAAyB;IAChE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,gCAAgC,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,MAAkB;IACnE,IAAI,CAAC,CAAC,gCAAgC,IAAI,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7D,OAAO,wBAAwB,CAAC,MAAM,CAAC,KAAK,IAAI;QAC9C,CAAC,CAAC,CAAC,gEAAgE,CAAC;QACpE,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAqB;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAC5B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAC7E,CAAC,CACF,CAAC;IACF,IAAI,OAAO,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/state/projectRoot.js

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+import path from "node:path";
+function directoryPrefixes(absolute) {
+    const parsed = path.parse(absolute);
+    const segments = absolute.slice(parsed.root.length).split(path.sep).filter(Boolean);
+    return [parsed.root, ...segments.map((_, index) => path.join(parsed.root, ...segments.slice(0, index + 1)))];
+}
+export function assertValidatedProjectRoot(root) {
+    const stable = root.identities.every((identity) => {
+        try {
+            const current = fs.lstatSync(identity.absolute, { bigint: true });
+            return identity.type === "directory"
+                && current.isDirectory()
+                && !current.isSymbolicLink()
+                && current.dev === identity.dev
+                && current.ino === identity.ino;
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!stable) {
+        throw new Error(`project root '${root.path}' changed after validation; restore the exact real directory and retry`);
+    }
+}
+export function validateRealProjectRoot(projectRoot) {
+    const root = path.resolve(projectRoot);
+    let stat;
+    try {
+        stat = fs.lstatSync(root, { bigint: true });
+    }
+    catch {
+        throw new Error(`project root '${root}' does not exist; choose an existing, real directory and retry`);
+    }
+    if (stat.isSymbolicLink()) {
+        throw new Error(`project root '${root}' is a symbolic link; choose an existing, real directory and retry`);
+    }
+    if (!stat.isDirectory()) {
+        throw new Error(`project root '${root}' is not a directory; choose an existing, real directory and retry`);
+    }
+    try {
+        if (fs.realpathSync(root) !== root) {
+            throw new Error(`project root '${root}' traverses a symbolic link; choose an existing, real directory and retry`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith("project root '"))
+            throw error;
+        throw new Error(`project root '${root}' cannot be resolved safely; choose an existing, real directory and retry`);
+    }
+    const identities = directoryPrefixes(root).map((absolute) => {
+        const current = fs.lstatSync(absolute, { bigint: true });
+        return { absolute, dev: current.dev, ino: current.ino, type: "directory" };
+    });
+    const validated = { path: root, identities };
+    const rootIdentity = identities.at(-1);
+    if (rootIdentity.dev !== stat.dev || rootIdentity.ino !== stat.ino) {
+        throw new Error(`project root '${root}' changed during validation; restore the exact real directory and retry`);
+    }
+    assertValidatedProjectRoot(validated);
+    return validated;
+}
+//# sourceMappingURL=projectRoot.js.map

package/dist/state/projectRoot.js.map

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

package/dist/state/projectionPolicy.js

@@ -0,0 +1,191 @@
+import fs from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { loadYamlMapping } from "../core/yaml.js";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { entityListFamily } from "./entityRetrievalHelp.js";
+const AUTHORITY_RELATIVE_PATH = "references/artifacts/state-storage-authority.yaml";
+const AUTHORITY_SCHEMA_VERSION = "agentera.stateStorageAuthority.v1";
+const NUMBERED_ARTIFACTS = new Set(["progress", "decisions", "health"]);
+function canonicalRetrieval(family) {
+    const list = `agentera state ${family.commandTokens.join(" ")} list --format json`;
+    return { available: true, command: list, list, get: family.get };
+}
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function positiveInteger(value, field) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1) {
+        throw new Error(`state storage authority field '${field}' must be a positive integer`);
+    }
+    return value;
+}
+export function loadProjectionPolicy(sourceRoot = resolveSourceRoot()) {
+    const authorityPath = path.join(sourceRoot, AUTHORITY_RELATIVE_PATH);
+    const authority = loadYamlMapping(fs.readFileSync(authorityPath, "utf8"));
+    if (authority.schema_version !== AUTHORITY_SCHEMA_VERSION) {
+        throw new Error(`state storage authority schema_version must be ${AUTHORITY_SCHEMA_VERSION}`);
+    }
+    const capacity = mapping(mapping(authority.projections).current).default_capacity;
+    const activeEntries = positiveInteger(mapping(capacity).active_entries, "projections.current.default_capacity.active_entries");
+    const summaryEntries = positiveInteger(mapping(capacity).summary_entries, "projections.current.default_capacity.summary_entries");
+    const totalEntries = positiveInteger(mapping(capacity).total_entries, "projections.current.default_capacity.total_entries");
+    if (activeEntries + summaryEntries !== totalEntries) {
+        throw new Error("state storage authority projection capacity must equal active plus summary entries");
+    }
+    const maxUtf8Bytes = positiveInteger(mapping(mapping(authority.budgets).projection).max_utf8_bytes, "budgets.projection.max_utf8_bytes");
+    return { activeEntries, summaryEntries, totalEntries, maxUtf8Bytes };
+}
+export function projectionRetrieval(command) {
+    if (NUMBERED_ARTIFACTS.has(command)) {
+        return canonicalRetrieval(entityListFamily(command));
+    }
+    if (command === "plan") {
+        const tasks = entityListFamily("plan_tasks");
+        const plans = entityListFamily("plans");
+        return {
+            available: true,
+            list: `agentera state ${tasks.commandTokens.join(" ")} list --format json`,
+            get: tasks.get,
+            plans_list: `agentera state ${plans.commandTokens.join(" ")} list --format json`,
+            plans_get: plans.get,
+        };
+    }
+    return {
+        available: false,
+        reason: "unsupported_numbered_retrieval",
+        artifact_id: command,
+    };
+}
+export function projectionOmission(command, count, reason, options = {}) {
+    return {
+        omitted: options.forceOmitted ?? count > 0,
+        omitted_count: count,
+        omission_reason: reason,
+        retrieval: projectionRetrieval(command),
+        omission_provenance: options.provenance ?? null,
+    };
+}
+export function serializedProjectionBytes(value, format) {
+    const serialized = format === "yaml" ? YAML.stringify(value, { sortMapEntries: false }) : JSON.stringify(value, null, 2) + "\n";
+    return Buffer.byteLength(serialized, "utf8");
+}
+function entryNumber(value, index) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return [Number.POSITIVE_INFINITY, index];
+    const object = value;
+    const candidates = [object.entry_number, object.number];
+    for (const candidate of candidates) {
+        if (typeof candidate === "number" && Number.isSafeInteger(candidate))
+            return [candidate, index];
+        if (typeof candidate === "string" && /^[1-9][0-9]*$/.test(candidate))
+            return [Number(candidate), index];
+    }
+    const stableId = object.stable_id;
+    if (typeof stableId === "string") {
+        const match = /:(\d+)$/.exec(stableId);
+        if (match)
+            return [Number(match[1]), index];
+    }
+    return [Number.POSITIVE_INFINITY, index];
+}
+function omissionCount(value) {
+    const count = value.omitted_count;
+    return typeof count === "number" && Number.isSafeInteger(count) && count > 0 ? count : 0;
+}
+function boundedValue(value, itemKey, items, omittedCount, command) {
+    const result = { ...value, [itemKey]: items };
+    const existingCounts = result.counts;
+    if (itemKey === "entries" && existingCounts && typeof existingCounts === "object" && !Array.isArray(existingCounts)) {
+        result.counts = {
+            ...existingCounts,
+            entries: items.length + omittedCount,
+            returned_entries: items.length,
+        };
+    }
+    return {
+        ...result,
+        ...projectionOmission(command, omittedCount, "projection_byte_budget", { forceOmitted: true }),
+    };
+}
+function minimalBudgetedProjection(command, omittedCount, policy, format) {
+    const omission = projectionOmission(command, omittedCount, "projection_required_fields_exceed_budget", {
+        forceOmitted: true,
+        provenance: {
+            source: "current_projection",
+            detail_availability: "unavailable",
+            compatibility: "degraded",
+            archive_verified: false,
+            omitted_count: omittedCount,
+        },
+    });
+    const fallback = {
+        command,
+        status: "degraded",
+        entries: [],
+        counts: { entries: omittedCount, returned_entries: 0 },
+        source: { artifact: command, detail_availability: "unavailable", source: "current_projection" },
+        ...omission,
+        error: {
+            class: "projection_output_budget",
+            message: "optional projection detail was omitted because required output fields exceeded the authority byte budget",
+            syntax: `agentera state ${command} --format json`,
+            example: `agentera state ${command} --format json`,
+            recovery: omission.retrieval.available === true
+                ? String(omission.retrieval.command ?? omission.retrieval.list)
+                : "No direct retrieval route is declared for this artifact; use its supported state command.",
+        },
+    };
+    if (serializedProjectionBytes(fallback, format) <= policy.maxUtf8Bytes)
+        return fallback;
+    const minimal = {
+        command,
+        status: "degraded",
+        omitted: true,
+        omitted_count: omittedCount,
+        omission_reason: "projection_output_budget",
+        retrieval: omission.retrieval,
+    };
+    if (serializedProjectionBytes(minimal, format) > policy.maxUtf8Bytes) {
+        throw new Error(`projection output budget ${policy.maxUtf8Bytes} bytes is too small for required omission metadata`);
+    }
+    return minimal;
+}
+/**
+ * Bound a structured projection without truncating strings or splitting UTF-8.
+ * Entries are removed oldest-first by numeric identity; every removal is
+ * declared in the response and points at the future direct-get surface.
+ */
+export function boundStructuredProjection(value, command, format, policy = loadProjectionPolicy()) {
+    if (serializedProjectionBytes(value, format) <= policy.maxUtf8Bytes)
+        return value;
+    const itemKey = Array.isArray(value.entries)
+        ? "entries"
+        : Array.isArray(value.operations)
+            ? "operations"
+            : null;
+    if (itemKey === null)
+        return minimalBudgetedProjection(command, 0, policy, format);
+    const items = value[itemKey];
+    const removalOrder = items
+        .map((item, index) => ({ index, key: entryNumber(item, index) }))
+        .sort((left, right) => left.key[0] - right.key[0] || left.key[1] - right.key[1]);
+    let omitted = omissionCount(value);
+    let retained = [...items];
+    for (const candidate of removalOrder) {
+        if (serializedProjectionBytes(boundedValue(value, itemKey, retained, omitted, command), format) <= policy.maxUtf8Bytes) {
+            return boundedValue(value, itemKey, retained, omitted, command);
+        }
+        const retainedIndex = retained.indexOf(items[candidate.index]);
+        if (retainedIndex >= 0)
+            retained.splice(retainedIndex, 1);
+        omitted += 1;
+    }
+    let result = boundedValue(value, itemKey, retained, omitted, command);
+    if (serializedProjectionBytes(result, format) <= policy.maxUtf8Bytes)
+        return result;
+    return minimalBudgetedProjection(command, omitted, policy, format);
+}
+//# sourceMappingURL=projectionPolicy.js.map

package/dist/state/projectionPolicy.js.map

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

package/dist/state/retrievalAuthority.js

@@ -0,0 +1,157 @@
+import { createHash } from "node:crypto";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { validateEntityListHelp } from "./entityRetrievalHelp.js";
+import { loadStateStorageAuthority } from "./stateStorageAuthority.js";
+export const STATE_RETRIEVAL_AUTHORITY_PATH = "references/artifacts/state-storage-authority.yaml";
+export const STATE_RETRIEVAL_SCHEMA_VERSION = "agentera.entityPublicRetrieval.v1";
+const POLICY_SCHEMA_VERSION = "agentera.entityPublicRetrievalPolicy.v1";
+const FAILURE_CLASSES = [
+    "invalid_request",
+    "unsupported_artifact",
+    "not_found",
+    "ambiguous",
+    "corrupt",
+    "incomplete",
+    "cursor_invalid",
+    "cursor_snapshot_unavailable",
+    "unsupported_state",
+];
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function strings(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string")
+        ? value
+        : [];
+}
+function requireNonEmpty(record, field, prefix, errors) {
+    if (typeof record[field] !== "string" || String(record[field]).trim() === "") {
+        errors.push(`${prefix}.${field}`);
+    }
+}
+export function deriveLegacyPlanIdentity(canonicalJson) {
+    return `legacy-plan:${createHash("sha256").update(canonicalJson, "utf8").digest("hex")}`;
+}
+/** Validate the canonical archive projection against its owning archive contract. */
+export function validateExperimentPublicationParity(value) {
+    const errors = [];
+    const retrieval = mapping(mapping(value.entity_target).public_retrieval);
+    const archivePolicy = mapping(mapping(mapping(retrieval.policy).archive_policy).experiments);
+    const archive = mapping(value.experiment_archival);
+    const layout = mapping(archive.layout);
+    const publication = mapping(archive.publication);
+    const projection = mapping(archive.projection);
+    const prefix = "entity_target.public_retrieval.policy.archive_policy.experiments";
+    if (archivePolicy.owner !== "experiment_archival" || archive.status !== "implemented") {
+        errors.push(`${prefix}.owner`);
+    }
+    if (archivePolicy.storage_scope !== "objective_directory" || archivePolicy.storage_scope !== layout.ownership) {
+        errors.push(`${prefix}.storage_scope`);
+    }
+    if (archivePolicy.publication_order !== "archive_before_projection" || publication.archive_before_projection !== true) {
+        errors.push(`${prefix}.publication_order`);
+    }
+    if (archivePolicy.projection_policy !== "uniform_10_40_50" || archivePolicy.projection_policy !== projection.policy) {
+        errors.push(`${prefix}.projection_policy`);
+    }
+    return errors;
+}
+/** Validate the sole active public retrieval projection and its unique policy. */
+export function validateStateRetrievalAuthority(value) {
+    const errors = validateEntityListHelp(value);
+    const retrieval = mapping(mapping(value.entity_target).public_retrieval);
+    const policy = mapping(retrieval.policy);
+    const prefix = "entity_target.public_retrieval";
+    if (retrieval.schema_version !== STATE_RETRIEVAL_SCHEMA_VERSION)
+        errors.push(`${prefix}.schema_version`);
+    if (retrieval.status !== "final")
+        errors.push(`${prefix}.status`);
+    if (policy.schema_version !== POLICY_SCHEMA_VERSION)
+        errors.push(`${prefix}.policy.schema_version`);
+    const identity = mapping(mapping(value.entity_target).identity);
+    if (identity.accepted_pattern !== "^[a-z]{10}$")
+        errors.push(`${prefix}.identity.accepted_pattern`);
+    const envelope = mapping(policy.envelope);
+    for (const field of ["schemaVersion", "command", "status", "entries", "counts", "filters", "snapshot", "source", "source_contract"]) {
+        if (!strings(envelope.required_fields).includes(field))
+            errors.push(`${prefix}.policy.envelope.required_fields.${field}`);
+    }
+    const projection = mapping(envelope.bounded_summary_projection);
+    if (projection.cardinality_owner !== "summary_rows_after_filters_and_cursor") {
+        errors.push(`${prefix}.policy.envelope.bounded_summary_projection.cardinality_owner`);
+    }
+    const degradation = mapping(projection.optional_detail_degradation);
+    for (const field of ["reason", "detail_omitted_count", "omitted_fields", "recovery"]) {
+        if (!strings(degradation.required_metadata).includes(field)) {
+            errors.push(`${prefix}.policy.envelope.bounded_summary_projection.optional_detail_degradation.required_metadata.${field}`);
+        }
+    }
+    if (degradation.row_omission !== "forbidden" || degradation.scalar_truncation !== "forbidden") {
+        errors.push(`${prefix}.policy.envelope.bounded_summary_projection.optional_detail_degradation.loss`);
+    }
+    const cursor = mapping(policy.cursor);
+    for (const field of ["vocabulary", "response_field", "binding", "invalid_behavior", "unavailable_behavior"]) {
+        if (!(field in cursor))
+            errors.push(`${prefix}.policy.cursor.${field}`);
+    }
+    const omission = mapping(policy.omission);
+    for (const field of ["omitted", "omitted_count", "omission_reason", "retrieval"]) {
+        if (!strings(omission.required_when_candidates_remain).includes(field)) {
+            errors.push(`${prefix}.policy.omission.required_when_candidates_remain.${field}`);
+        }
+    }
+    requireNonEmpty(omission, "semantics", `${prefix}.policy.omission`, errors);
+    const output = mapping(policy.output_bounds);
+    if (!Number.isSafeInteger(output.maximum_limit) || Number(output.maximum_limit) < 1 || Number(output.maximum_limit) > 100) {
+        errors.push(`${prefix}.policy.output_bounds.maximum_limit`);
+    }
+    if (!Number.isSafeInteger(output.max_serialized_utf8_bytes) || Number(output.max_serialized_utf8_bytes) < 1_024) {
+        errors.push(`${prefix}.policy.output_bounds.max_serialized_utf8_bytes`);
+    }
+    if (output.scalar_truncation !== "forbidden")
+        errors.push(`${prefix}.policy.output_bounds.scalar_truncation`);
+    if (output.row_omission_under_byte_pressure !== "forbidden")
+        errors.push(`${prefix}.policy.output_bounds.row_omission_under_byte_pressure`);
+    const failures = mapping(policy.failures);
+    for (const field of ["class", "message", "syntax", "example", "recovery"]) {
+        if (!strings(failures.required_fields).includes(field))
+            errors.push(`${prefix}.policy.failures.required_fields.${field}`);
+    }
+    const classes = mapping(failures.classes);
+    for (const name of FAILURE_CLASSES)
+        requireNonEmpty(classes, name, `${prefix}.policy.failures.classes`, errors);
+    const planArchive = mapping(mapping(policy.archive_policy).plan);
+    for (const field of ["owner", "diagnostics", "unselected_diagnostics"]) {
+        requireNonEmpty(planArchive, field, `${prefix}.policy.archive_policy.plan`, errors);
+    }
+    errors.push(...validateExperimentPublicationParity(value));
+    return [...new Set(errors)];
+}
+export function loadStateRetrievalAuthority(sourceRoot = resolveSourceRoot()) {
+    const authority = loadStateStorageAuthority(sourceRoot);
+    const errors = validateStateRetrievalAuthority(authority.document);
+    if (errors.length > 0)
+        throw new Error(`invalid state retrieval authority: ${errors.join(", ")}`);
+    return {
+        authority: STATE_RETRIEVAL_AUTHORITY_PATH,
+        retrieval: mapping(mapping(authority.document.entity_target).public_retrieval),
+    };
+}
+export function stateRetrievalCommands(sourceRoot = resolveSourceRoot()) {
+    return mapping(loadStateRetrievalAuthority(sourceRoot).retrieval.commands);
+}
+export function entityPublicRetrieval(sourceRoot = resolveSourceRoot()) {
+    return loadStateRetrievalAuthority(sourceRoot).retrieval;
+}
+export function startupSurfaceBudget(surface, sourceRoot = resolveSourceRoot()) {
+    const authority = loadStateStorageAuthority(sourceRoot);
+    const surfaces = mapping(mapping(mapping(authority.document.budgets).startup).surfaces);
+    const budget = Number(mapping(surfaces[surface]).max_utf8_bytes);
+    if (!Number.isSafeInteger(budget) || budget < 1) {
+        throw new Error(`state storage authority '${authority.authorityPath}' has no positive startup budget for '${surface}'`);
+    }
+    return budget;
+}
+//# sourceMappingURL=retrievalAuthority.js.map