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

package/dist/state/write/glossaryPublication.js

@@ -0,0 +1,264 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { canonicalTerminologyJson, validateTerminologyProposal, } from "../../audit/terminologyDrift.js";
+import { dumpYamlMapping, loadYamlMapping } from "../../core/yaml.js";
+import { loadArtifactRecord, resolveArtifactPath, } from "../../registries/artifactRegistry.js";
+import { GlossaryEntryBoundError, validateGlossaryEntry } from "../../registries/glossaryEntryContract.js";
+import { unicodeCaselessExact } from "../../registries/glossaryTermIdentity.js";
+import { containsGlossaryTerm } from "../../registries/glossaryTermOccurrence.js";
+import { assertValidatedProjectRoot } from "../projectRoot.js";
+import { reject } from "./errors.js";
+import { withStateMutation } from "./mutation.js";
+const REQUEST_VERSION = "agentera.glossaryPublicationRequest.v1";
+const DOCUMENT_VERSION = "agentera.projectGlossary.v1";
+const REQUEST_FIELDS = ["schema_version", "proposal", "confirmation"];
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function exactFields(value, allowed) {
+    return Object.keys(value).every((field) => allowed.includes(field));
+}
+function validTimestamp(value) {
+    if (typeof value !== "string")
+        return false;
+    const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:Z|[+-](\d{2}):(\d{2}))$/.exec(value);
+    if (!match || Number.isNaN(Date.parse(value)))
+        return false;
+    const [, year, month, day, hour, minute, second, offsetHour = "00", offsetMinute = "00"] = match;
+    const calendar = new Date(Date.UTC(Number(year), Number(month) - 1, Number(day)));
+    return calendar.getUTCFullYear() === Number(year)
+        && calendar.getUTCMonth() + 1 === Number(month)
+        && calendar.getUTCDate() === Number(day)
+        && Number(hour) <= 23
+        && Number(minute) <= 59
+        && Number(second) <= 59
+        && Number(offsetHour) <= 23
+        && Number(offsetMinute) <= 59;
+}
+function correction(message, classification = "schema_violation", recovery = "Rerun audit against current project files, obtain explicit user confirmation for the returned proposal_digest, and retry the same glossary publish command.") {
+    reject({
+        class: classification,
+        message,
+        recovery,
+        example: "agentera state glossary publish --input glossary-publication.yaml --format json",
+    });
+}
+function proposal(value) {
+    const validated = validateTerminologyProposal(value);
+    if (!validated.proposal) {
+        correction(`proposal is not canonical Audit output: ${validated.violations.join("; ")}`);
+    }
+    return validated.proposal;
+}
+function confirmation(value, digest) {
+    if (!mapping(value) || !exactFields(value, ["proposal_digest", "confirmed_by", "confirmed_at"])) {
+        correction("confirmation must contain only proposal_digest, confirmed_by, and confirmed_at");
+    }
+    if (value.confirmed_by !== "user") {
+        correction("confirmation.confirmed_by must be 'user'; generic consent or agent attribution is not approval");
+    }
+    if (!validTimestamp(value.confirmed_at)) {
+        correction("confirmation.confirmed_at must be a valid ISO 8601 timestamp with timezone");
+    }
+    if (value.proposal_digest !== digest) {
+        correction("confirmation.proposal_digest does not bind the submitted proposal");
+    }
+    return value;
+}
+function revalidateEvidence(root, proposalValue) {
+    const groups = [
+        { term: proposalValue.proposed_canonical_term, evidence: proposalValue.canonical_evidence },
+        ...proposalValue.variants,
+    ];
+    for (const group of groups) {
+        for (const record of group.evidence) {
+            assertValidatedProjectRoot(root);
+            const candidate = path.resolve(root.path, record.source_path);
+            let resolved;
+            try {
+                resolved = fs.realpathSync(candidate);
+            }
+            catch {
+                correction(`source evidence '${record.source_path}:${record.line}' is missing or unreadable`);
+            }
+            if (!resolved.startsWith(`${root.path}${path.sep}`) || !fs.statSync(resolved).isFile()) {
+                correction(`source evidence '${record.source_path}:${record.line}' escapes the project or is not a file`);
+            }
+            const canonicalPath = path.relative(root.path, resolved).split(path.sep).join(path.posix.sep);
+            if (canonicalPath !== record.source_path) {
+                correction(`source evidence '${record.source_path}:${record.line}' is not the canonical Audit-emitted project identity '${canonicalPath}:${record.line}'`);
+            }
+            const line = fs.readFileSync(resolved, "utf8").split(/\r?\n/)[record.line - 1];
+            const digest = line === undefined ? "" : crypto.createHash("sha256").update(line).digest("hex");
+            if (line === undefined || digest !== record.source_record_sha256 || !containsGlossaryTerm(line, group.term)) {
+                correction(`source evidence '${record.source_path}:${record.line}' is stale or no longer identifies '${group.term}'`);
+            }
+        }
+    }
+}
+function deriveEntry(proposalValue, confirmed) {
+    const source = proposalValue.canonical_evidence[0];
+    const date = confirmed.confirmed_at.slice(0, 10);
+    const entry = {
+        term: proposalValue.proposed_canonical_term,
+        meaning: proposalValue.concept,
+        confidence: proposalValue.confidence,
+        permanence: "stable",
+        temporal: { observed_at: date, last_confirmed_at: date },
+        provenance: {
+            kind: "project_file",
+            evidence: [{ source_path: source.source_path, source_record_sha256: source.source_record_sha256 }],
+        },
+    };
+    const violations = validateGlossaryEntry(entry, "project");
+    if (violations.length > 0)
+        correction(`derived project glossary entry is invalid: ${violations.join("; ")}`);
+    return entry;
+}
+function same(left, right) {
+    return canonicalTerminologyJson(left) === canonicalTerminologyJson(right);
+}
+function parseApproval(value, index) {
+    if (!mapping(value) || !exactFields(value, ["proposal_digest", "proposal", "confirmation"])) {
+        correction(`existing approvals[${index}] is malformed`, "conflict");
+    }
+    const proposed = proposal(value.proposal);
+    const confirmed = confirmation(value.confirmation, proposed.proposal_digest);
+    if (value.proposal_digest !== proposed.proposal_digest) {
+        correction(`existing approvals[${index}] has conflicting digest identity`, "conflict");
+    }
+    return {
+        approval: { proposal_digest: proposed.proposal_digest, proposal: proposed, confirmation: confirmed },
+        entry: deriveEntry(proposed, confirmed),
+    };
+}
+export function parseProjectGlossaryDocument(bytes, maxEntries = Number.POSITIVE_INFINITY) {
+    let value;
+    try {
+        value = loadYamlMapping(bytes);
+    }
+    catch (error) {
+        correction(`existing glossary document is malformed: ${error.message}`, "conflict");
+    }
+    if (!exactFields(value, ["schema_version", "approvals", "entries"]) || value.schema_version !== DOCUMENT_VERSION || !Array.isArray(value.approvals) || !Array.isArray(value.entries)) {
+        correction(`existing glossary document must use ${DOCUMENT_VERSION} with approvals and entries lists`, "conflict");
+    }
+    if (value.entries.length > maxEntries || value.approvals.length > maxEntries)
+        throw new GlossaryEntryBoundError("project glossary exceeds the consumer entry bound");
+    const approvals = value.approvals.map((item, index) => parseApproval(item, index));
+    const entries = value.entries;
+    if (entries.length !== approvals.length)
+        correction("existing glossary approvals and entries do not form complete publication pairs", "conflict");
+    const terminologyIdentities = [];
+    const digestIdentities = new Set();
+    for (const [index, item] of entries.entries()) {
+        if (!mapping(item))
+            correction(`existing entries[${index}] is malformed`, "conflict");
+        const violations = validateGlossaryEntry(item, "project");
+        if (violations.length > 0)
+            correction(`existing entries[${index}] is malformed: ${violations.join("; ")}`, "conflict");
+        if (!same(item, approvals[index].entry))
+            correction(`existing approval and entry at index ${index} do not match`, "conflict");
+        const canonical = String(item.term);
+        const digest = approvals[index].approval.proposal_digest;
+        if (digestIdentities.has(digest))
+            correction("existing glossary contains duplicate term or approval identity", "conflict");
+        digestIdentities.add(digest);
+        const terms = [canonical, ...approvals[index].approval.proposal.variants.map(({ term }) => term)];
+        for (const term of terms) {
+            const existing = terminologyIdentities.find((identity) => unicodeCaselessExact(identity.term, term));
+            if (existing) {
+                correction(`terminology identity collision for '${term}' between canonical sets '${existing.canonical}' and '${canonical}'`, "conflict", `Choose distinct canonical and variant terms for '${existing.canonical}' and '${canonical}', rerun audit, obtain confirmation for the corrected proposal, and retry the same glossary publish command.`);
+            }
+            terminologyIdentities.push({ term, canonical });
+        }
+    }
+    return {
+        schema_version: DOCUMENT_VERSION,
+        approvals: approvals.map(({ approval }) => approval),
+        entries: entries,
+    };
+}
+function validateCandidateBytes(bytes) {
+    return parseProjectGlossaryDocument(bytes);
+}
+export function loadProjectGlossaryDocument(projectRoot) {
+    const record = loadArtifactRecord("glossary");
+    if (!record)
+        correction("registered glossary artifact is unavailable");
+    const target = resolveArtifactPath(record, projectRoot);
+    if (!fs.existsSync(target))
+        return null;
+    return { path: target, document: parseProjectGlossaryDocument(fs.readFileSync(target, "utf8")) };
+}
+export function publishGlossary(req, root, options = {}) {
+    if (!req.input || !exactFields(req.input, REQUEST_FIELDS) || req.input.schema_version !== REQUEST_VERSION) {
+        correction(`publication request must use ${REQUEST_VERSION} and contain only proposal and confirmation`);
+    }
+    const proposed = proposal(req.input.proposal);
+    const confirmed = confirmation(req.input.confirmation, proposed.proposal_digest);
+    const entry = deriveEntry(proposed, confirmed);
+    const approval = {
+        proposal_digest: proposed.proposal_digest,
+        proposal: proposed,
+        confirmation: confirmed,
+    };
+    const record = loadArtifactRecord("glossary");
+    if (!record)
+        correction("registered glossary artifact is unavailable");
+    return withStateMutation(root.path, (transaction) => {
+        assertValidatedProjectRoot(root);
+        const target = resolveArtifactPath(record, root.path, { strictWrite: true });
+        const relativePath = path.relative(root.path, target).split(path.sep).join("/");
+        revalidateEvidence(root, proposed);
+        const previousBytes = fs.existsSync(target) ? fs.readFileSync(target, "utf8") : "";
+        const current = previousBytes
+            ? parseProjectGlossaryDocument(previousBytes)
+            : { schema_version: DOCUMENT_VERSION, approvals: [], entries: [] };
+        const approvalIndex = current.approvals.findIndex((item) => item.proposal_digest === proposed.proposal_digest);
+        const termIndex = current.entries.findIndex((item) => unicodeCaselessExact(String(item.term), proposed.proposed_canonical_term));
+        if (approvalIndex >= 0 || termIndex >= 0) {
+            if (approvalIndex === termIndex && approvalIndex >= 0 && same(current.approvals[approvalIndex], approval) && same(current.entries[termIndex], entry)) {
+                return {
+                    schemaVersion: "agentera.stateWrite.v1",
+                    status: "pass",
+                    command: "state glossary publish",
+                    artifact: "glossary",
+                    path: relativePath,
+                    operation: { dry_run: req.dryRun, changed: false, idempotent_replay: true },
+                    candidate: current,
+                };
+            }
+            correction(`confirmed term '${proposed.proposed_canonical_term}' conflicts with existing approval or entry state`, "conflict");
+        }
+        const candidate = {
+            schema_version: DOCUMENT_VERSION,
+            approvals: [...current.approvals, approval],
+            entries: [...current.entries, entry],
+        };
+        const bytes = dumpYamlMapping(candidate);
+        validateCandidateBytes(bytes);
+        if (!req.dryRun) {
+            const stage = transaction.stageProjection(target, bytes);
+            try {
+                transaction.syncStaged(stage);
+                assertValidatedProjectRoot(root);
+                transaction.publishProjection(stage, target, previousBytes);
+            }
+            finally {
+                transaction.removeStage(stage);
+            }
+        }
+        return {
+            schemaVersion: "agentera.stateWrite.v1",
+            status: "pass",
+            command: "state glossary publish",
+            artifact: "glossary",
+            path: relativePath,
+            operation: { dry_run: req.dryRun, changed: true, idempotent_replay: false },
+            candidate,
+        };
+    }, options, root);
+}
+//# sourceMappingURL=glossaryPublication.js.map

package/dist/state/write/glossaryPublication.js.map

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

package/dist/state/write/grammar.js

@@ -0,0 +1,271 @@
+import crypto from "node:crypto";
+import { resolveSourceRoot } from "../../core/sourceRoot.js";
+import { loadStateStorageAuthority } from "../stateStorageAuthority.js";
+import { runtimeOperationSpecs } from "./runtimeOperations.js";
+export const MUTATION_CLASSES = [
+    "record_payload",
+    "simple_transition",
+    "batch_transaction",
+];
+export const MUTATION_INPUT_MODES = [
+    "none",
+    "structured",
+    "flags_until_conversion",
+];
+let cache;
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function requiredString(value, path) {
+    if (typeof value !== "string" || value.length === 0)
+        throw new Error(`invalid mutation grammar: ${path} must be a non-empty string`);
+    return value;
+}
+function strings(value, path) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string"))
+        throw new Error(`invalid mutation grammar: ${path} must be a string list`);
+    return [...value];
+}
+function clonePlain(value) {
+    if (Array.isArray(value))
+        return value.map(clonePlain);
+    if (mapping(value))
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, clonePlain(item)]));
+    return value;
+}
+function fields(value, path) {
+    if (!Array.isArray(value))
+        throw new Error(`invalid mutation grammar: ${path} must be a list`);
+    const seenFlags = new Set();
+    const seenFields = new Set();
+    return value.map((raw, index) => {
+        const fieldPath = `${path}[${index}]`;
+        if (!mapping(raw))
+            throw new Error(`invalid mutation grammar: ${fieldPath} must be a mapping`);
+        const flag = requiredString(raw.flag, `${fieldPath}.flag`);
+        const field = requiredString(raw.field, `${fieldPath}.field`);
+        const kind = requiredString(raw.kind, `${fieldPath}.kind`);
+        if (!["string", "boolean", "integer", "string_list", "date", "datetime"].includes(kind))
+            throw new Error(`invalid mutation grammar: ${fieldPath}.kind '${kind}' is unsupported`);
+        if (seenFlags.has(flag) || seenFields.has(field))
+            throw new Error(`invalid mutation grammar: duplicate field ${flag}/${field} in ${path}`);
+        seenFlags.add(flag);
+        seenFields.add(field);
+        const validValues = raw.valid_values === undefined ? undefined : strings(raw.valid_values, `${fieldPath}.valid_values`);
+        const validValuesSource = raw.valid_values_source === undefined ? undefined : requiredString(raw.valid_values_source, `${fieldPath}.valid_values_source`);
+        if (validValues && validValuesSource)
+            throw new Error(`invalid mutation grammar: ${fieldPath} cannot declare both valid_values and valid_values_source`);
+        return {
+            flag,
+            field,
+            kind,
+            required: raw.required === true,
+            ...(raw.repeatable === true ? { repeatable: true } : {}),
+            ...(validValues ? { validValues } : {}),
+            ...(validValuesSource ? { validValuesSource } : {}),
+            ...(typeof raw.description === "string" ? { description: raw.description } : {}),
+        };
+    });
+}
+export function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(",")}]`;
+    if (mapping(value)) {
+        return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key])}`).join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+function digest(value) {
+    return crypto.createHash("sha256").update(canonicalJson(value)).digest("hex");
+}
+function parseOperation(raw, index) {
+    const p = `mutation_grammar.operations[${index}]`;
+    if (!mapping(raw))
+        throw new Error(`invalid mutation grammar: ${p} must be a mapping`);
+    const artifact = requiredString(raw.artifact, `${p}.artifact`);
+    const verb = requiredString(raw.verb, `${p}.verb`);
+    const mutationClass = requiredString(raw.class, `${p}.class`);
+    if (!MUTATION_CLASSES.includes(mutationClass))
+        throw new Error(`invalid mutation grammar: ${p}.class '${mutationClass}' is unsupported`);
+    if (!mapping(raw.input))
+        throw new Error(`invalid mutation grammar: ${p}.input must be a mapping`);
+    const inputMode = requiredString(raw.input.mode, `${p}.input.mode`);
+    if (!MUTATION_INPUT_MODES.includes(inputMode))
+        throw new Error(`invalid mutation grammar: ${p}.input.mode '${inputMode}' is unsupported`);
+    const input = {
+        mode: inputMode,
+        ...(raw.input.root === undefined ? {} : { root: requiredString(raw.input.root, `${p}.input.root`) }),
+        sources: strings(raw.input.sources, `${p}.input.sources`),
+        ...(raw.input.structured_sources === undefined
+            ? (inputMode === "structured" ? { structuredSources: strings(raw.input.sources, `${p}.input.sources`) } : {})
+            : { structuredSources: strings(raw.input.structured_sources, `${p}.input.structured_sources`) }),
+        cliOwnedFields: strings(raw.input.cli_owned_fields, `${p}.input.cli_owned_fields`),
+    };
+    if (inputMode === "structured" && (!input.root || input.sources.length === 0))
+        throw new Error(`invalid mutation grammar: ${p} structured input needs a root and source`);
+    if (inputMode === "none" && (input.sources.length > 0 || input.root !== undefined))
+        throw new Error(`invalid mutation grammar: ${p} none input cannot declare sources or a root`);
+    const operation = {
+        artifact,
+        verb,
+        mutationClass,
+        selectors: strings(raw.selectors, `${p}.selectors`),
+        preconditions: strings(raw.preconditions, `${p}.preconditions`),
+        ownedFields: strings(raw.owned_fields, `${p}.owned_fields`),
+        input,
+        recovery: requiredString(raw.recovery, `${p}.recovery`),
+        examples: strings(raw.examples, `${p}.examples`),
+        bounds: mapping(raw.bounds) ? clonePlain(raw.bounds) : (() => { throw new Error(`invalid mutation grammar: ${p}.bounds must be a mapping`); })(),
+        fields: fields(raw.fields, `${p}.fields`),
+        allowForce: raw.allow_force === true,
+        compacts: raw.compacts === true,
+    };
+    if (operation.examples.length === 0)
+        throw new Error(`invalid mutation grammar: ${p}.examples must not be empty`);
+    const selectors = new Set(operation.selectors);
+    for (const selector of selectors) {
+        if (!selector.startsWith("--"))
+            throw new Error(`invalid mutation grammar: ${p}.selectors must contain flags`);
+    }
+    return operation;
+}
+function runtimeFieldProjection(field) {
+    return {
+        flag: field.flag,
+        field: field.field,
+        kind: field.kind,
+        required: field.required === true,
+        repeatable: field.repeatable === true,
+        ...(field.validValuesSource
+            ? { valid_values_source: field.validValuesSource }
+            : field.validValues
+                ? { valid_values: field.validValues }
+                : {}),
+    };
+}
+function declaredFieldProjection(field) {
+    return runtimeFieldProjection(field);
+}
+function operationParityProjection(operation) {
+    return {
+        artifact: operation.artifact,
+        verb: operation.verb,
+        selectors: operation.selectors,
+        owned_fields: operation.ownedFields,
+        input: {
+            mode: operation.input.mode,
+            ...(operation.input.root ? { root: operation.input.root } : {}),
+            sources: operation.input.sources,
+            structured_sources: operation.input.structuredSources ?? [],
+            cli_owned_fields: operation.input.cliOwnedFields,
+        },
+        fields: operation.fields.map(declaredFieldProjection),
+        allow_force: operation.allowForce,
+        compacts: operation.compacts,
+        bounds: operation.input.mode === "structured"
+            ? { max_input_utf8_bytes: operation.bounds.max_input_utf8_bytes }
+            : { max_input_utf8_bytes: 0 },
+    };
+}
+function runtimeParityProjection(operation) {
+    return {
+        artifact: operation.artifact,
+        verb: operation.verb,
+        selectors: operation.selectors,
+        owned_fields: operation.ownedFields,
+        input: {
+            mode: operation.inputMode,
+            ...(operation.inputRoot ? { root: operation.inputRoot } : {}),
+            sources: operation.inputSources,
+            structured_sources: operation.structuredInputSources,
+            cli_owned_fields: operation.cliOwnedFields,
+        },
+        fields: operation.fields.map(runtimeFieldProjection),
+        allow_force: operation.allowForce,
+        compacts: operation.compacts,
+        bounds: { max_input_utf8_bytes: operation.inputMaxBytes },
+    };
+}
+export function validateMutationGrammarParity(operations, authorityPath = "references/artifacts/state-storage-authority.yaml") {
+    const runtime = runtimeOperationSpecs();
+    const runtimeByKey = new Map(runtime.map((operation) => [`${operation.artifact}.${operation.verb}`, operation]));
+    const declaredByKey = new Map(operations.map((operation) => [`${operation.artifact}.${operation.verb}`, operation]));
+    const keys = [...new Set([...runtimeByKey.keys(), ...declaredByKey.keys()])].sort();
+    const mismatches = [];
+    for (const key of keys) {
+        const code = runtimeByKey.get(key);
+        const declared = declaredByKey.get(key);
+        if (!code || !declared) {
+            mismatches.push(`${key}: operation is ${code ? "missing from discovery" : "not code-owned"}`);
+            continue;
+        }
+        const expected = canonicalJson(runtimeParityProjection(code));
+        const actual = canonicalJson(operationParityProjection(declared));
+        if (expected !== actual)
+            mismatches.push(`${key}: discovery does not match code-owned runtime grammar`);
+    }
+    if (mismatches.length) {
+        throw new Error(`mutation grammar parity failure for '${authorityPath}': ${mismatches.join("; ")}`);
+    }
+}
+function parseGrammar(document, authority) {
+    const raw = document.mutation_grammar;
+    if (!mapping(raw))
+        throw new Error(`invalid mutation grammar in '${authority}': mutation_grammar is missing`);
+    const schemaVersion = requiredString(raw.schema_version, "mutation_grammar.schema_version");
+    if (schemaVersion !== "agentera.stateMutationGrammar.v1")
+        throw new Error(`invalid mutation grammar: unsupported schema version '${schemaVersion}'`);
+    const operationClasses = strings(raw.operation_classes, "mutation_grammar.operation_classes");
+    if (operationClasses.some((value) => !MUTATION_CLASSES.includes(value)))
+        throw new Error("invalid mutation grammar: operation_classes contains an unsupported class");
+    if (!mapping(raw.structured_input))
+        throw new Error("invalid mutation grammar: structured_input must be a mapping");
+    if (!Array.isArray(raw.operations))
+        throw new Error("invalid mutation grammar: operations must be a list");
+    const operations = raw.operations.map(parseOperation);
+    const seen = new Set();
+    for (const operation of operations) {
+        const key = `${operation.artifact}.${operation.verb}`;
+        if (seen.has(key))
+            throw new Error(`invalid mutation grammar: duplicate public mutation '${key}'`);
+        seen.add(key);
+    }
+    validateMutationGrammarParity(operations, authority);
+    const contract = {
+        schema_version: schemaVersion,
+        operation_classes: operationClasses,
+        structured_input: raw.structured_input,
+        operations,
+    };
+    return {
+        schemaVersion,
+        authority: "references/artifacts/state-storage-authority.yaml",
+        operationClasses,
+        structuredInput: clonePlain(raw.structured_input),
+        operations,
+        contractDigest: digest(contract),
+    };
+}
+export function loadMutationGrammar(sourceRoot = resolveSourceRoot()) {
+    const authority = loadStateStorageAuthority(sourceRoot);
+    if (cache?.revision === authority.revision)
+        return cache.grammar;
+    const grammar = parseGrammar(authority.document, authority.authorityPath);
+    cache = { revision: authority.revision, grammar };
+    return grammar;
+}
+export function mutationOperationsForArtifact(artifact, sourceRoot = resolveSourceRoot()) {
+    return loadMutationGrammar(sourceRoot).operations.filter((operation) => operation.artifact === artifact);
+}
+export function mutationGrammarPayload(sourceRoot = resolveSourceRoot()) {
+    const grammar = loadMutationGrammar(sourceRoot);
+    return {
+        schemaVersion: grammar.schemaVersion,
+        authority: grammar.authority,
+        contract_digest: grammar.contractDigest,
+        operation_classes: grammar.operationClasses,
+        structured_input: grammar.structuredInput,
+        operations: grammar.operations,
+    };
+}
+//# sourceMappingURL=grammar.js.map

package/dist/state/write/grammar.js.map

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

package/dist/state/write/helpers.js

@@ -0,0 +1,30 @@
+import { reject } from "./errors.js";
+export function schemaViolation(violations) {
+    reject({ class: "schema_violation", message: violations[0], violations });
+}
+export function findByNumber(entries, number) {
+    return entries.find((entry) => Number(entry.number) === number);
+}
+/** Coerce an unknown value into a plain mapping, returning `{}` for non-objects. */
+export function mapping(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+/** Return the object-valued elements of `doc[key]`, dropping non-mapping entries. */
+export function array(doc, key) {
+    return Array.isArray(doc[key])
+        ? doc[key].filter((v) => Boolean(v && typeof v === "object" && !Array.isArray(v)))
+        : [];
+}
+/** Traverse a dotted field path into a nested mapping, returning `undefined` on miss. */
+export function mappingPath(entry, field) {
+    let value = entry;
+    for (const part of field.split(".")) {
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            return undefined;
+        value = value[part];
+    }
+    return value;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/state/write/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/state/write/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,UAAU,eAAe,CAAC,UAAoB;IAClD,MAAM,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAkC,EAClC,MAAc;IAEd,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC;AAClE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,KAAK,CAAC,GAA4B,EAAE,GAAW;IAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC,CAAE,GAAG,CAAC,GAAG,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CACjE,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CACzD;QACH,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,WAAW,CAAC,KAA8B,EAAE,KAAa;IACvE,IAAI,KAAK,GAAY,KAAK,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAClF,KAAK,GAAI,KAAiC,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/state/write/index.js

@@ -0,0 +1,13 @@
+export * from "./operations.js";
+export * from "./fields.js";
+export * from "./input.js";
+export * from "./assign.js";
+export * from "./explain.js";
+export * from "./lock.js";
+export * from "./mutation.js";
+export * from "./transaction.js";
+export * from "./validate.js";
+export * from "./serialize.js";
+export * from "./errors.js";
+export * from "./glossaryPublication.js";
+//# sourceMappingURL=index.js.map

package/dist/state/write/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/state/write/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC"}