agentera 3.0.0-dev.5 → 3.0.0-dev.6

package/dist/hooks/validateArtifact/markdown.js

@@ -0,0 +1,95 @@
+/**
+ * Markdown validation for human-facing artifacts (TODO.md, CHANGELOG.md,
+ * SKILL.md, ...). Walks the artifact's schema looking for any group
+ * with required `field` entries and dispatches to the appropriate
+ * section check (ITEM, RELEASE, TOKEN).
+ */
+import { isMapping } from "./schema.js";
+const SKIP_META = new Set(["meta", "GROUP_PREFIXES", "BUDGET", "COMPACTION", "VALIDATION", "CONVENTION"]);
+export function validateMd(content, name, schema = null) {
+    const violations = [];
+    if (!content.trim())
+        violations.push(`${name}: empty content`);
+    const fences = (content.match(/^```/gm) ?? []).length;
+    if (fences % 2)
+        violations.push(`${name}: unclosed code fence`);
+    if (schema)
+        violations.push(...validateMdSchema(content, name, schema));
+    return violations;
+}
+export function validateMdSchema(content, name, schema) {
+    const violations = [];
+    if (!content.trim())
+        return violations;
+    for (const [groupKey, groupValue] of Object.entries(schema)) {
+        if (SKIP_META.has(groupKey) || !isMapping(groupValue))
+            continue;
+        const hasRequired = Object.values(groupValue).some((e) => isMapping(e) && e.required && e.field);
+        if (!hasRequired)
+            continue;
+        if (groupKey === "ITEM")
+            validateMdItems(content, name, violations);
+        else if (groupKey === "RELEASE")
+            validateMdReleases(content, name, violations);
+        else if (groupKey === "TOKEN")
+            validateMdTokens(content, name, violations);
+    }
+    return violations;
+}
+export function validateMdItems(content, name, violations) {
+    const versionHeading = /^##\s+/m.exec(content);
+    if (!versionHeading) {
+        violations.push(`${name}: missing severity sections (expected '## <glyph> <name>' headings)`);
+        return;
+    }
+    const severityGlyphs = ["⇶", "⇉", "→", "⇢"];
+    const requiredItemGlyphs = new Set(["⇶"]);
+    let found = false;
+    for (const glyph of severityGlyphs) {
+        const g = glyph.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        if (new RegExp(`^##\\s*${g}`, "m").test(content)) {
+            found = true;
+            const sectionStart = new RegExp(`^##\\s*${g}.+$`, "m").exec(content);
+            if (sectionStart) {
+                const idx = sectionStart.index + sectionStart[0].length;
+                const nextMatch = content.slice(idx).match(/\n##\s/);
+                let bodyStart = idx;
+                if (content.startsWith("\r\n", bodyStart))
+                    bodyStart += 2;
+                else if (content[bodyStart] === "\n")
+                    bodyStart += 1;
+                const sectionEnd = nextMatch ? idx + nextMatch.index : content.length;
+                const sectionBody = content.slice(bodyStart, sectionEnd);
+                if (requiredItemGlyphs.has(glyph) && !/^\s*-/m.test(sectionBody)) {
+                    const headingSlice = content.slice(sectionStart.index, sectionStart.index + sectionStart[0].length);
+                    const glyphNameMatch = new RegExp(`^##\\s*(${g}.+)$`, "m").exec(headingSlice);
+                    const headingText = glyphNameMatch ? glyphNameMatch[1] : glyph;
+                    violations.push(`${name}: severity section '${headingText}' has no list entries (expected '- [type]' items)`);
+                }
+            }
+        }
+    }
+    if (!found) {
+        violations.push(`${name}: missing severity glyph in section headings (expected '## ⇶ Critical', '## ⇉ Degraded', '## → Normal', '## ⇢ Annoying')`);
+    }
+}
+export function validateMdReleases(content, name, violations) {
+    if (!/^##\s*\[/m.test(content)) {
+        violations.push(`${name}: missing version header (expected '## [X.Y.Z]')`);
+    }
+    const changeSections = new Set(["### Added", "### Changed", "### Fixed", "### Removed"]);
+    const lines = new Set(content.split("\n"));
+    if (![...changeSections].some((s) => lines.has(s))) {
+        violations.push(`${name}: missing change sections (expected '### Added', '### Changed', '### Fixed', or '### Removed')`);
+    }
+}
+export function validateMdTokens(content, name, violations) {
+    if (!/^##\s/m.test(content)) {
+        violations.push(`${name}: missing section heading (expected '## SectionName')`);
+    }
+    const yamlBlocks = (content.match(/^```yaml\s*$/gm) ?? []).length;
+    if (!yamlBlocks) {
+        violations.push(`${name}: missing YAML code block with token definitions (expected '\`\`\`yaml')`);
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/hooks/validateArtifact/markdown.js.map

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

package/dist/hooks/validateArtifact/runtime.js

@@ -0,0 +1,83 @@
+/**
+ * Runtime event parsing for agent artifact writes.
+ *
+ * Detects which file a runtime wants to write (or which apply_patch
+ * headers describe) and packages it as an `ArtifactWrite`. The CLI
+ * adapter uses this on the JSON payload that Claude, OpenCode, Codex,
+ * and Copilot hand to a PostToolUse hook.
+ */
+import { isMapping } from "./schema.js";
+export class ArtifactWrite {
+    file_path;
+    content;
+    constructor(filePath, content = null) {
+        this.file_path = filePath;
+        this.content = content;
+    }
+}
+export class RuntimeEventParser {
+    parseClaude(data) {
+        const ti = data.tool_input;
+        if (!isMapping(ti))
+            return null;
+        const fp = ti.file_path;
+        if (fp)
+            return new ArtifactWrite(String(fp), ti.content ?? null);
+        return null;
+    }
+    parseOpencode(data) {
+        const inp = data.input;
+        if (!isMapping(inp))
+            return null;
+        const fp = inp.path;
+        if (fp)
+            return new ArtifactWrite(String(fp), inp.content ?? null);
+        return null;
+    }
+    parseCodex(data) {
+        const ti = data.tool_input;
+        if (!isMapping(ti))
+            return null;
+        const fp = ti.path;
+        const patchBody = ti.patch || ti.command || "";
+        if (fp)
+            return new ArtifactWrite(String(fp));
+        if (typeof patchBody === "string") {
+            const headers = [...patchBody.matchAll(/^\*\*\*\s+(?:Add File|Update File):\s+(.+?)\s*$/gm)];
+            if (headers.length > 0)
+                return new ArtifactWrite(headers[0][1]);
+        }
+        return null;
+    }
+    parseCopilot(data) {
+        const inp = data.input;
+        if (!isMapping(inp))
+            return null;
+        const fp = inp.filePath || inp.file_path;
+        if (fp)
+            return new ArtifactWrite(String(fp), inp.content ?? null);
+        return null;
+    }
+    parse(data) {
+        const tn = data.tool_name ?? "";
+        if (tn === "apply_patch") {
+            const candidate = this.parseCodex(data);
+            if (candidate)
+                return candidate;
+        }
+        if (tn === "Edit" || tn === "Write" || (isMapping(data.tool_input) && "file_path" in data.tool_input)) {
+            const candidate = this.parseClaude(data);
+            if (candidate)
+                return candidate;
+        }
+        if (isMapping(data.input)) {
+            const inp = data.input;
+            if ("filePath" in inp || "file_path" in inp)
+                return this.parseCopilot(data);
+            if ("path" in inp)
+                return this.parseOpencode(data);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/hooks/validateArtifact/runtime.js.map

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

package/dist/hooks/validateArtifact/schema.js

@@ -0,0 +1,455 @@
+/**
+ * Schema-driven validation helpers for the v2 artifact protocol.
+ *
+ * Walks the schema (skills/agentera/schemas/artifacts/<name>.yaml) and
+ * a parsed artifact mapping, producing a list of human-readable
+ * violation strings. The helpers in this file are pure (no I/O) and
+ * are orchestrated by `violations.ts` for the YAML side and by
+ * `markdown.ts` for the human-facing side.
+ */
+export function isMapping(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+export function pyTypeName(v) {
+    if (v === null || v === undefined)
+        return "NoneType";
+    if (typeof v === "boolean")
+        return "bool";
+    if (typeof v === "number")
+        return Number.isInteger(v) ? "int" : "float";
+    if (typeof v === "string")
+        return "str";
+    if (Array.isArray(v))
+        return "list";
+    if (typeof v === "object")
+        return "dict";
+    return typeof v;
+}
+export function wordCount(text) {
+    return (text.match(/\S+/g) ?? []).length;
+}
+const SKIP_META = new Set(["meta", "GROUP_PREFIXES", "BUDGET", "COMPACTION", "VALIDATION", "CONVENTION"]);
+const LIST_INDICATORS = new Set(["number", "entry", "summary"]);
+const SEQUENCE_KEYS_BY_ARTIFACT = {
+    decisions: { DECISION: "decisions", ARCHIVE: "archive" },
+    docs: { MAPPING: "mapping", INDEX: "index", AUDIT_LOG: "audit_log" },
+    experiments: { EXPERIMENT: "experiments", ARCHIVE: "archive" },
+    plan: { TASK: "tasks" },
+    progress: { CYCLE: "cycles", ARCHIVE: "archive" },
+    session: { BOOKMARK: "bookmarks" },
+    vision: { PERSONA: "personas", PRINCIPLE: "principles" },
+};
+const NESTED_SEQUENCE_KEYS = [[["DECISION", "ALTERNATIVE"], "alternatives"]];
+const SEQUENCE_ORDER_BY_ARTIFACT = { "progress\0cycles": "descending" };
+export function collectSingletonGroups(schema) {
+    const result = [];
+    for (const [gk, gv] of Object.entries(schema)) {
+        if (SKIP_META.has(gk) || !isMapping(gv))
+            continue;
+        let isListOrSub = false;
+        for (const e of Object.values(gv)) {
+            if (isMapping(e) && (LIST_INDICATORS.has(e.field) || e.parent)) {
+                isListOrSub = true;
+                break;
+            }
+        }
+        if (isListOrSub)
+            continue;
+        const fields = [];
+        for (const e of Object.values(gv)) {
+            if (isMapping(e) && e.required && "field" in e)
+                fields.push(e.field);
+        }
+        if (fields.length > 0)
+            result.push([gk, gk.toLowerCase(), fields]);
+    }
+    return result;
+}
+export function isEmptyRequired(value) {
+    if (value === null || value === undefined)
+        return true;
+    if (typeof value === "string")
+        return !value.trim();
+    if (Array.isArray(value))
+        return value.length === 0;
+    if (typeof value === "object")
+        return Object.keys(value).length === 0;
+    return false;
+}
+export function* iterGroupEntries(schema, group) {
+    const gv = schema[group];
+    if (!isMapping(gv))
+        return;
+    for (const entry of Object.values(gv)) {
+        if (isMapping(entry) && "field" in entry)
+            yield entry;
+    }
+}
+export function validateField(violations, name, scope, field, p) {
+    const fullPath = p ? `${p}.${field}` : field;
+    if (!(field in scope)) {
+        violations.push(`${name}: missing required field '${fullPath}'`);
+    }
+    else if (isEmptyRequired(scope[field])) {
+        violations.push(`${name}: empty required field '${fullPath}'`);
+    }
+}
+export function allowedValues(entry) {
+    for (const rule of entry.validation ?? []) {
+        if (typeof rule === "string" && rule.startsWith("Must be one of: ")) {
+            return rule.slice("Must be one of: ".length).split(",").map((v) => v.trim());
+        }
+    }
+    return [];
+}
+export function validateAllowedValue(violations, name, scope, entry, p) {
+    const field = entry.field;
+    const allowed = allowedValues(entry);
+    if (!field || allowed.length === 0 || !(field in scope) || isEmptyRequired(scope[field]))
+        return;
+    const value = scope[field];
+    if (typeof value === "string" && !allowed.includes(value)) {
+        violations.push(`${name}: invalid value '${value}' for '${p}.${field}' (expected one of: ${allowed.join(", ")})`);
+    }
+}
+export function validateFieldType(violations, name, scope, entry, p) {
+    const field = entry.field;
+    if (!field || !(field in scope))
+        return true;
+    const value = scope[field];
+    const expectedType = entry.type;
+    if (!expectedType || isEmptyRequired(value))
+        return true;
+    const fullPath = p ? `${p}.${field}` : field;
+    let isValid = true;
+    if (expectedType === "integer") {
+        if (typeof value === "boolean" || !(typeof value === "number" && Number.isInteger(value))) {
+            violations.push(`${name}: '${fullPath}' must be an integer, got ${pyTypeName(value)}`);
+            isValid = false;
+        }
+    }
+    else if (expectedType === "string") {
+        if (typeof value !== "string") {
+            violations.push(`${name}: '${fullPath}' must be a string, got ${pyTypeName(value)}`);
+            isValid = false;
+        }
+    }
+    else if (expectedType === "map") {
+        if (!isMapping(value)) {
+            violations.push(`${name}: '${fullPath}' must be a mapping, got ${pyTypeName(value)}`);
+            isValid = false;
+        }
+    }
+    else if (expectedType === "list[string]") {
+        if (!Array.isArray(value) || !value.every((x) => typeof x === "string")) {
+            violations.push(`${name}: '${fullPath}' must be a list of strings`);
+            isValid = false;
+        }
+    }
+    else if (expectedType === "list[map]") {
+        if (!Array.isArray(value) || !value.every((x) => isMapping(x))) {
+            violations.push(`${name}: '${fullPath}' must be a list of mappings`);
+            isValid = false;
+        }
+    }
+    return isValid;
+}
+export function validateFieldConstraints(violations, name, scope, entry, p) {
+    const field = entry.field;
+    if (!field || !(field in scope))
+        return;
+    const value = scope[field];
+    for (const rule of entry.validation ?? []) {
+        if (typeof rule !== "string")
+            continue;
+        if (rule === "Must be a positive integer") {
+            if (typeof value === "boolean" || !(typeof value === "number" && Number.isInteger(value)) || value <= 0) {
+                const fullPath = p ? `${p}.${field}` : field;
+                violations.push(`${name}: '${fullPath}' must be a positive integer`);
+            }
+        }
+    }
+}
+export function validateRequiredFields(violations, name, schema, group, scope, p) {
+    for (const entry of iterGroupEntries(schema, group)) {
+        const field = entry.field;
+        if (entry.parent || field === "entry")
+            continue;
+        if (entry.required)
+            validateField(violations, name, scope, field, p);
+        if (field in scope && !isEmptyRequired(scope[field])) {
+            if (validateFieldType(violations, name, scope, entry, p)) {
+                validateAllowedValue(violations, name, scope, entry, p);
+                validateFieldConstraints(violations, name, scope, entry, p);
+            }
+        }
+        const value = scope[field];
+        if (isMapping(value)) {
+            for (const child of entry.children ?? []) {
+                if (isMapping(child) && child.field) {
+                    const childField = child.field;
+                    const childPath = p ? `${p}.${field}` : field;
+                    if (child.required)
+                        validateField(violations, name, value, childField, childPath);
+                    if (childField in value && !isEmptyRequired(value[childField])) {
+                        if (validateFieldType(violations, name, value, child, childPath)) {
+                            validateAllowedValue(violations, name, value, child, childPath);
+                            validateFieldConstraints(violations, name, value, child, childPath);
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+export function validateSingletonGroup(violations, name, schema, group, scope, p) {
+    for (const entry of iterGroupEntries(schema, group)) {
+        const field = entry.field;
+        if (entry.parent || field === "entry")
+            continue;
+        if (entry.required)
+            validateField(violations, name, scope, field, p);
+        if (field in scope && !isEmptyRequired(scope[field])) {
+            if (validateFieldType(violations, name, scope, entry, p)) {
+                validateAllowedValue(violations, name, scope, entry, p);
+                validateFieldConstraints(violations, name, scope, entry, p);
+            }
+        }
+    }
+}
+export function schemaFieldNames(schema, group) {
+    const out = new Set();
+    for (const entry of iterGroupEntries(schema, group)) {
+        if (entry.field && !entry.parent && entry.field !== "entry")
+            out.add(entry.field);
+    }
+    return out;
+}
+export function validateUnknownFields(violations, name, scope, allowed, p) {
+    for (const field of Object.keys(scope)) {
+        if (!allowed.has(field)) {
+            const fullPath = p ? `${p}.${field}` : field;
+            violations.push(`${name}: unsupported field '${fullPath}'`);
+        }
+    }
+}
+export function validatePlanKnownFields(data, schema, violations) {
+    const groupedScopes = { header: "HEADER", scope: "SCOPE" };
+    const sequenceKeys = new Set(Object.values(SEQUENCE_KEYS_BY_ARTIFACT.plan ?? {}));
+    const allowedTopLevel = new Set([
+        ...schemaFieldNames(schema, "PLAN"),
+        ...Object.keys(groupedScopes),
+        ...sequenceKeys,
+    ]);
+    validateUnknownFields(violations, "plan", data, allowedTopLevel, "");
+    for (const [key, group] of Object.entries(groupedScopes)) {
+        const scope = data[key];
+        if (isMapping(scope)) {
+            validateUnknownFields(violations, "plan", scope, schemaFieldNames(schema, group), key);
+        }
+    }
+}
+export function validateFullPlanContract(data, violations) {
+    const header = isMapping(data.header) ? data.header : {};
+    if (String(header.level ?? "").toLowerCase() !== "full")
+        return;
+    for (const field of ["reviewed", "critic_issues"]) {
+        validateField(violations, "plan", header, field, "header");
+    }
+    validateField(violations, "plan", data, "design", "");
+    const criticIssues = header.critic_issues;
+    if (!isEmptyRequired(criticIssues)) {
+        const match = /^\s*(\d+)\s+found,\s*(\d+)\s+addressed,\s*(\d+)\s+dismissed\s*$/.exec(String(criticIssues));
+        if (!match) {
+            violations.push("plan: header.critic_issues must match 'N found, M addressed, K dismissed'");
+        }
+        else {
+            const [found, addressed, dismissed] = [match[1], match[2], match[3]].map((v) => parseInt(v, 10));
+            if (found < 1)
+                violations.push("plan: header.critic_issues must record at least 1 found issue");
+            if (addressed + dismissed !== found) {
+                violations.push("plan: header.critic_issues counts must satisfy addressed + dismissed == found");
+            }
+        }
+    }
+    const tasks = data.tasks;
+    if (!Array.isArray(tasks))
+        return;
+    tasks.forEach((task, index) => {
+        if (isMapping(task))
+            validateField(violations, "plan", task, "acceptance", `tasks[${index}]`);
+    });
+}
+export function entryMinCount(schema, group) {
+    for (const entry of iterGroupEntries(schema, group)) {
+        if (entry.field === "entry" && entry.required)
+            return entry.min_count || 1;
+    }
+    return null;
+}
+export function parentRequirements(schema, parentGroup) {
+    const requirements = {};
+    const prefix = `${parentGroup}.`;
+    for (const group of Object.keys(schema)) {
+        if (SKIP_META.has(group))
+            continue;
+        for (const entry of iterGroupEntries(schema, group)) {
+            const parent = entry.parent;
+            if (typeof parent === "string" &&
+                parent.startsWith(prefix) &&
+                parent !== `${group}.entry` &&
+                entry.required &&
+                entry.field) {
+                const parentField = parent.slice(prefix.length);
+                (requirements[parentField] ??= []).push(entry.field);
+            }
+        }
+    }
+    return requirements;
+}
+export function entryRequirements(schema, group) {
+    const parent = `${group}.entry`;
+    const out = [];
+    for (const entry of iterGroupEntries(schema, group)) {
+        if (entry.parent === parent && entry.required && entry.field)
+            out.push(entry.field);
+    }
+    return out;
+}
+export function validateSequences(data, schema, name, violations) {
+    for (const [group, key] of Object.entries(SEQUENCE_KEYS_BY_ARTIFACT[name] ?? {})) {
+        const seq = data[key];
+        if (seq === null || seq === undefined)
+            continue;
+        if (!Array.isArray(seq)) {
+            violations.push(`${name}: '${key}' must be a list`);
+            continue;
+        }
+        if (seq.length === 0) {
+            violations.push(`${name}: '${key}' requires at least 1 entry`);
+            continue;
+        }
+        const childRequirements = parentRequirements(schema, group);
+        seq.forEach((item, index) => {
+            const p = `${key}[${index}]`;
+            if (!isMapping(item)) {
+                violations.push(`${name}: '${p}' must be a mapping`);
+                return;
+            }
+            validateRequiredFields(violations, name, schema, group, item, p);
+            for (const [parentField, childFields] of Object.entries(childRequirements)) {
+                const childScope = item[parentField];
+                if (!isMapping(childScope))
+                    continue;
+                for (const childField of childFields) {
+                    validateField(violations, name, childScope, childField, `${p}.${parentField}`);
+                }
+            }
+            for (const [[parentGroup, childGroup], childKey] of NESTED_SEQUENCE_KEYS) {
+                if (parentGroup !== group)
+                    continue;
+                const childSeq = item[childKey];
+                const minCount = entryMinCount(schema, childGroup);
+                if (minCount && (!Array.isArray(childSeq) || childSeq.length < minCount)) {
+                    violations.push(`${name}: '${p}.${childKey}' requires at least ${minCount} entry`);
+                    continue;
+                }
+                if (!Array.isArray(childSeq))
+                    continue;
+                const required = entryRequirements(schema, childGroup);
+                childSeq.forEach((child, childIndex) => {
+                    const childPath = `${p}.${childKey}[${childIndex}]`;
+                    if (!isMapping(child)) {
+                        violations.push(`${name}: '${childPath}' must be a mapping`);
+                        return;
+                    }
+                    for (const field of required)
+                        validateField(violations, name, child, field, childPath);
+                });
+            }
+        });
+    }
+}
+export function validateDecisionAlternatives(data, name) {
+    const violations = [];
+    (data.decisions ?? []).forEach((decision, index) => {
+        if (!isMapping(decision))
+            return;
+        const alternatives = decision.alternatives ?? [];
+        if (!Array.isArray(alternatives))
+            return;
+        const chosen = alternatives.filter((alt) => isMapping(alt) && alt.status === "chosen");
+        if (chosen.length !== 1) {
+            violations.push(`${name}: 'decisions[${index}].alternatives' must have exactly one chosen entry`);
+        }
+    });
+    return violations;
+}
+export function validateDecisionSatisfaction(data, name) {
+    const violations = [];
+    const allowedStates = new Set(["open", "provisionally_satisfied", "user_confirmed_satisfied"]);
+    const entries = [
+        ...(data.decisions ?? []).map((d, i) => [`decisions[${i}]`, d]),
+        ...(data.archive ?? []).map((d, i) => [`archive[${i}]`, d]),
+    ];
+    for (const [entryPath, decision] of entries) {
+        if (!isMapping(decision) || !("satisfaction" in decision))
+            continue;
+        const p = `${entryPath}.satisfaction`;
+        const satisfaction = decision.satisfaction;
+        if (!isMapping(satisfaction)) {
+            violations.push(`${name}: '${p}' must be a mapping`);
+            continue;
+        }
+        validateUnknownFields(violations, name, satisfaction, new Set(["state", "evidence", "user_confirmation"]), p);
+        const state = satisfaction.state;
+        if (typeof state !== "string" || !state.trim()) {
+            violations.push(`${name}: missing required field '${p}.state'`);
+            continue;
+        }
+        if (!allowedStates.has(state)) {
+            violations.push(`${name}: invalid value '${state}' for '${p}.state' (expected one of: open, provisionally_satisfied, user_confirmed_satisfied)`);
+            continue;
+        }
+        if (state === "provisionally_satisfied" && isEmptyRequired(satisfaction.evidence)) {
+            violations.push(`${name}: '${p}.evidence' is required for provisionally_satisfied`);
+        }
+        if (state === "user_confirmed_satisfied") {
+            const confirmation = satisfaction.user_confirmation;
+            if (confirmation === null || confirmation === undefined) {
+                violations.push(`${name}: '${p}.user_confirmation' is required for user_confirmed_satisfied`);
+                continue;
+            }
+            if (!isMapping(confirmation)) {
+                violations.push(`${name}: '${p}.user_confirmation' must be a mapping with confirmed_by and confirmed_at, got ${pyTypeName(confirmation)}`);
+                continue;
+            }
+            for (const field of ["confirmed_by", "confirmed_at"]) {
+                if (isEmptyRequired(confirmation[field])) {
+                    violations.push(`${name}: missing required field '${p}.user_confirmation.${field}'`);
+                }
+            }
+        }
+    }
+    return violations;
+}
+export function validationRuleSeverity(schema, rule) {
+    for (const groupKey of ["VALIDATION", "VALIDATION_RULES"]) {
+        for (const entry of Object.values(schema[groupKey] ?? {})) {
+            if (isMapping(entry) && entry.rule === rule) {
+                const severity = entry.severity;
+                return severity ? String(severity) : null;
+            }
+        }
+    }
+    return null;
+}
+export function expectedSequenceOrder(name, key) {
+    return SEQUENCE_ORDER_BY_ARTIFACT[`${name}\0${key}`] ?? "ascending";
+}
+export function sequenceInOrder(nums, direction) {
+    const reverse = direction === "descending";
+    const sorted = [...nums].sort((a, b) => (reverse ? b - a : a - b));
+    return nums.length === sorted.length && nums.every((n, i) => n === sorted[i]);
+}
+//# sourceMappingURL=schema.js.map