@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/schema/runtime-schema.js

@@ -1,827 +1,3 @@
-/**
- * @module core/schema/runtime-schema
- *
- * Resolves configurable schema, fields, statuses, and workflows for Runtime Schema.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="633ef301-42a3-5b73-a4ed-7af0e0e40371")}catch(e){}}();
-import path from "node:path";
-import { pathExists, readFileIfExists, writeFileAtomic, } from "../fs/fs-utils.js";
-import { DEFAULT_STATUS_DEFINITIONS, DEFAULT_WORKFLOW_DEFINITION, } from "../shared/constants.js";
-import { RUNTIME_FIELD_COMMAND_VALUES, RUNTIME_FIELD_TYPE_VALUES, RUNTIME_STATUS_ROLE_VALUES, RUNTIME_UNKNOWN_FIELD_POLICY_VALUES, STATUS_VALUES, } from "../../types/index.js";
-import { normalizeStatusToken } from "./status-token.js";
-/** Fallback runtime schema file paths used when callers do not provide an override. */
-export const DEFAULT_RUNTIME_SCHEMA_FILE_PATHS = Object.freeze({
-    types: "schema/types.json",
-    statuses: "schema/statuses.json",
-    fields: "schema/fields.json",
-    workflows: "schema/workflows.json",
-});
-// Default lifecycle status model and workflow role mapping live in
-// src/core/shared/constants.ts as the single source of truth (also referenced
-// by SETTINGS_DEFAULTS). Re-exported here under the historical names.
-/** Fallback runtime workflow used when callers do not provide an override. */
-export const DEFAULT_RUNTIME_WORKFLOW = DEFAULT_WORKFLOW_DEFINITION;
-/** Fallback runtime status definitions used when callers do not provide an override. */
-export const DEFAULT_RUNTIME_STATUS_DEFINITIONS = DEFAULT_STATUS_DEFINITIONS;
-const DEFAULT_RUNTIME_FIELD_COMMANDS = [
-    "create",
-    "update",
-];
-const RUNTIME_STATUS_ROLE_SET = new Set(RUNTIME_STATUS_ROLE_VALUES);
-const RUNTIME_FIELD_TYPE_SET = new Set(RUNTIME_FIELD_TYPE_VALUES);
-const RUNTIME_FIELD_COMMAND_SET = new Set(RUNTIME_FIELD_COMMAND_VALUES);
-const RUNTIME_UNKNOWN_FIELD_POLICY_SET = new Set(RUNTIME_UNKNOWN_FIELD_POLICY_VALUES);
-const RUNTIME_FIELD_VALUE_TYPE_SET = new Set([
-    "string",
-    "number",
-    "boolean",
-    "array",
-    "object",
-]);
-const MAX_RUNTIME_FIELD_VALUE_SCHEMA_DEPTH = 16;
-function isPlainObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-const RUNTIME_FIELD_VALUE_SCHEMA_SHAPE_VALIDATORS = [
-    (schema) => schema.type === undefined ||
-        (typeof schema.type === "string" &&
-            RUNTIME_FIELD_VALUE_TYPE_SET.has(schema.type)),
-    (schema) => !Object.hasOwn(schema, "const") || isStructuredJsonValue(schema.const),
-    (schema) => schema.enum === undefined ||
-        (Array.isArray(schema.enum) &&
-            schema.enum.every((entry) => isStructuredJsonValue(entry))),
-    (schema) => schema.min_length === undefined ||
-        (Number.isInteger(schema.min_length) && schema.min_length >= 0),
-    (schema) => schema.min_items === undefined ||
-        (Number.isInteger(schema.min_items) && schema.min_items >= 0),
-    (schema) => schema.format === undefined || schema.format === "date-time",
-    (schema) => schema.required === undefined ||
-        (Array.isArray(schema.required) &&
-            schema.required.every((entry) => typeof entry === "string" && entry.length > 0)),
-    (schema) => schema.additional_properties === undefined ||
-        typeof schema.additional_properties === "boolean",
-    (schema) => schema.properties === undefined || isPlainObject(schema.properties),
-    (schema) => schema.one_of === undefined ||
-        (Array.isArray(schema.one_of) && schema.one_of.length > 0),
-];
-function isStructuredJsonValue(value, ancestors = new Set()) {
-    if (value === null ||
-        typeof value === "string" ||
-        typeof value === "boolean") {
-        return true;
-    }
-    if (typeof value === "number")
-        return Number.isFinite(value);
-    if (typeof value !== "object" || ancestors.has(value))
-        return false;
-    ancestors.add(value);
-    const valid = Array.isArray(value)
-        ? value.every((entry) => isStructuredJsonValue(entry, ancestors))
-        : Object.values(value).every((entry) => isStructuredJsonValue(entry, ancestors));
-    ancestors.delete(value);
-    return valid;
-}
-/** Normalize an untrusted recursive custom-field value schema or reject it. */
-function normalizeRuntimeFieldValueSchema(value, depth = 0, ancestors = new Set()) {
-    if (!isPlainObject(value) ||
-        depth > MAX_RUNTIME_FIELD_VALUE_SCHEMA_DEPTH ||
-        ancestors.has(value)) {
-        return undefined;
-    }
-    ancestors.add(value);
-    const schema = value;
-    const type = schema.type;
-    const enumValues = schema.enum;
-    const oneOf = schema.one_of;
-    const properties = schema.properties;
-    const items = schema.items;
-    const required = schema.required;
-    const minLength = schema.min_length;
-    const minItems = schema.min_items;
-    const format = schema.format;
-    const additionalProperties = schema.additional_properties;
-    if (!RUNTIME_FIELD_VALUE_SCHEMA_SHAPE_VALIDATORS.every((check) => check(schema))) {
-        ancestors.delete(value);
-        return undefined;
-    }
-    const normalizedProperties = properties === undefined
-        ? undefined
-        : Object.fromEntries(Object.entries(properties).map(([key, entry]) => [
-            key,
-            normalizeRuntimeFieldValueSchema(entry, depth + 1, ancestors),
-        ]));
-    const normalizedItems = items === undefined
-        ? undefined
-        : normalizeRuntimeFieldValueSchema(items, depth + 1, ancestors);
-    const normalizedOneOf = oneOf === undefined
-        ? undefined
-        : oneOf.map((entry) => normalizeRuntimeFieldValueSchema(entry, depth + 1, ancestors));
-    const normalizedNestedSchemas = [
-        ...Object.values(normalizedProperties ?? {}),
-        ...(items === undefined ? [] : [normalizedItems]),
-        ...(normalizedOneOf ?? []),
-    ];
-    if (normalizedNestedSchemas.some((entry) => entry === undefined)) {
-        ancestors.delete(value);
-        return undefined;
-    }
-    ancestors.delete(value);
-    return Object.fromEntries(Object.entries({
-        type: type,
-        const: Object.hasOwn(schema, "const") ? schema.const : undefined,
-        enum: enumValues,
-        min_length: minLength,
-        min_items: minItems,
-        format: format,
-        properties: normalizedProperties,
-        required: required === undefined ? undefined : [...new Set(required)],
-        additional_properties: additionalProperties,
-        items: normalizedItems,
-        one_of: normalizedOneOf,
-    }).filter(([, entry]) => entry !== undefined));
-}
-function normalizeStringList(values) {
-    const candidates = Array.isArray(values) ? values : [];
-    return [
-        ...new Set(candidates
-            .map((value) => (typeof value === "string" ? value.trim() : ""))
-            .filter((value) => value.length > 0)),
-    ].sort((left, right) => left.localeCompare(right));
-}
-function normalizeStatusId(value) {
-    if (typeof value !== "string" || value.length === 0) {
-        return undefined;
-    }
-    const normalized = normalizeStatusToken(value);
-    return normalized.length > 0 ? normalized : undefined;
-}
-function stripFlagPrefix(value) {
-    return value.startsWith("--") ? value.slice(2) : value;
-}
-function normalizeCliToken(value) {
-    return typeof value === "string"
-        ? stripFlagPrefix(value
-            .trim()
-            .toLowerCase()
-            .replaceAll(/[\s_]+/g, "-"))
-        : "";
-}
-function keyToDefaultCliFlag(value) {
-    return value.replaceAll("_", "-");
-}
-function toCamelCase(input) {
-    const segments = input
-        .replaceAll(/[^A-Za-z0-9]+/g, " ")
-        .trim()
-        .split(/\s+/)
-        .filter((segment) => segment.length > 0)
-        .map((segment) => segment.toLowerCase());
-    if (segments.length === 0) {
-        return input;
-    }
-    const [first, ...rest] = segments;
-    return `${first}${rest.map((segment) => `${segment.slice(0, 1).toUpperCase()}${segment.slice(1)}`).join("")}`;
-}
-function normalizeRuntimeStatusDefinition(definition, fallbackOrder) {
-    const id = normalizeStatusId(definition.id);
-    if (!id) {
-        return null;
-    }
-    const aliases = [
-        ...new Set(normalizeStringList(definition.aliases)
-            .map(normalizeStatusToken)
-            .filter((value) => value.length > 0)),
-    ].sort((left, right) => left.localeCompare(right));
-    const roles = normalizeStringList(definition.roles).filter((value) => RUNTIME_STATUS_ROLE_SET.has(value));
-    const description = definition.description?.trim();
-    const order = typeof definition.order === "number" && Number.isFinite(definition.order)
-        ? definition.order
-        : fallbackOrder;
-    return {
-        id,
-        aliases,
-        roles,
-        description: description && description.length > 0 ? description : undefined,
-        order,
-    };
-}
-function normalizeRuntimeWorkflow(workflow) {
-    return {
-        draft_status: normalizeStatusId(workflow?.draft_status),
-        open_status: normalizeStatusId(workflow?.open_status),
-        in_progress_status: normalizeStatusId(workflow?.in_progress_status),
-        blocked_status: normalizeStatusId(workflow?.blocked_status),
-        close_status: normalizeStatusId(workflow?.close_status),
-        canceled_status: normalizeStatusId(workflow?.canceled_status),
-    };
-}
-function appendTypeWorkflowPair(record, pair) {
-    if (!Array.isArray(pair) || pair.length !== 2) {
-        return;
-    }
-    const from = normalizeStatusToken(pair[0]);
-    const to = normalizeStatusToken(pair[1]);
-    if (from.length === 0 || to.length === 0) {
-        return;
-    }
-    if (record.pairs.some((candidate) => candidate[0] === from && candidate[1] === to)) {
-        return;
-    }
-    record.pairs.push([from, to]);
-}
-function normalizedTypeWorkflowEntry(entry) {
-    const rawType = typeof entry?.type === "string" ? entry.type.trim() : "";
-    if (rawType.length === 0 || !Array.isArray(entry?.allowed_transitions)) {
-        return null;
-    }
-    const record = {
-        type: rawType,
-        pairs: [],
-        denyAll: entry.allowed_transitions.length === 0,
-    };
-    for (const pair of entry.allowed_transitions) {
-        appendTypeWorkflowPair(record, pair);
-    }
-    return { typeKey: rawType.toLowerCase(), record };
-}
-function normalizeTypeWorkflowDefinitions(workflows) {
-    if (!Array.isArray(workflows) || workflows.length === 0) {
-        return undefined;
-    }
-    // Keep the raw (trimmed) type name so it round-trips verbatim; comparison is
-    // case-insensitive downstream (resolveTypeWorkflows lower-cases). from/to
-    // status tokens use the same normalization rules as runtime statuses.
-    //
-    // An EXPLICIT empty `allowed_transitions: []` is a deliberate DENY-ALL rule and
-    // MUST survive normalization (it must NOT collapse to "no entry", which would
-    // leave the type unrestricted). But a NON-empty array whose every pair is
-    // malformed (e.g. a 3-element tuple typo) must be DROPPED like other malformed
-    // schema-file content, NOT silently turned into a deny-all rule — otherwise a
-    // typo would start failing every update for that type under strict enforcement.
-    const byTypeKey = new Map();
-    for (const entry of workflows) {
-        const normalized = normalizedTypeWorkflowEntry(entry);
-        if (normalized === null) {
-            continue;
-        }
-        const record = byTypeKey.get(normalized.typeKey) ?? normalized.record;
-        record.denyAll ||= normalized.record.denyAll;
-        for (const pair of normalized.record.pairs) {
-            appendTypeWorkflowPair(record, pair);
-        }
-        byTypeKey.set(normalized.typeKey, record);
-    }
-    const normalized = [];
-    for (const record of byTypeKey.values()) {
-        // Keep when there is at least one valid transition OR an explicit deny-all was
-        // declared; drop nonempty-but-all-malformed entries (treated as typos).
-        if (record.pairs.length > 0 || record.denyAll) {
-            normalized.push({ type: record.type, allowed_transitions: record.pairs });
-        }
-    }
-    normalized.sort((left, right) => left.type.localeCompare(right.type));
-    return normalized.length > 0 ? normalized : undefined;
-}
-function normalizeRuntimeFieldDefinition(definition) {
-    const key = normalizeStatusToken(definition.key ?? "");
-    if (!key) {
-        return null;
-    }
-    const metadataKey = normalizeStatusToken(definition.metadata_key ?? definition.front_matter_key ?? key);
-    const cliFlag = normalizeCliToken(definition.cli_flag ?? keyToDefaultCliFlag(key));
-    if (!cliFlag) {
-        return null;
-    }
-    const cliAliases = normalizeStringList(definition.cli_aliases)
-        .map((value) => normalizeCliToken(value))
-        .filter((value) => value.length > 0 && value !== cliFlag);
-    const typeCandidate = typeof definition.type === "string"
-        ? definition.type.trim().toLowerCase()
-        : "string";
-    const type = RUNTIME_FIELD_TYPE_SET.has(typeCandidate)
-        ? typeCandidate
-        : "string";
-    const commands = (() => {
-        const normalized = normalizeStringList(definition.commands).filter((value) => RUNTIME_FIELD_COMMAND_SET.has(value));
-        if (normalized.length > 0) {
-            return normalized;
-        }
-        return [...DEFAULT_RUNTIME_FIELD_COMMANDS];
-    })();
-    const description = definition.description?.trim();
-    const requiredTypes = normalizeStringList(definition.required_types);
-    const valueSchema = definition.value_schema === undefined
-        ? undefined
-        : normalizeRuntimeFieldValueSchema(definition.value_schema);
-    if (definition.value_schema !== undefined && valueSchema === undefined) {
-        return null;
-    }
-    return {
-        key,
-        metadata_key: metadataKey,
-        cli_flag: cliFlag,
-        cli_aliases: cliAliases,
-        description: description && description.length > 0 ? description : undefined,
-        type,
-        commands,
-        repeatable: [
-            definition.repeatable === true,
-            type === "string_array",
-        ].includes(true),
-        required: definition.required === true,
-        required_on_create: definition.required_on_create === true,
-        required_types: requiredTypes,
-        allow_unset: definition.allow_unset !== false,
-        value_schema: valueSchema,
-    };
-}
-function normalizeRuntimeStatusDefinitions(statusesSource) {
-    const dedupedById = new Map();
-    for (const [index, definition] of statusesSource.entries()) {
-        const normalized = normalizeRuntimeStatusDefinition(definition, index);
-        if (normalized) {
-            dedupedById.set(normalized.id, normalized);
-        }
-    }
-    const values = sortRuntimeStatusDefinitions([...dedupedById.values()]);
-    if (values.length > 0) {
-        return values;
-    }
-    return sortRuntimeStatusDefinitions(DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition, index) => normalizeRuntimeStatusDefinition(definition, index)).filter((definition) => definition !== null));
-}
-function sortRuntimeStatusDefinitions(definitions) {
-    return definitions.sort((left, right) => left.order === right.order
-        ? left.id.localeCompare(right.id)
-        : left.order - right.order);
-}
-function normalizeRuntimeFieldDefinitions(fieldsSource) {
-    const dedupedByKey = new Map();
-    for (const definition of fieldsSource ?? []) {
-        const normalized = normalizeRuntimeFieldDefinition(definition);
-        if (normalized) {
-            dedupedByKey.set(normalized.key, normalized);
-        }
-    }
-    return [...dedupedByKey.values()].sort((left, right) => left.key.localeCompare(right.key));
-}
-function serializeRuntimeStatusDefinition(definition) {
-    return {
-        id: definition.id,
-        aliases: definition.aliases.length > 0 ? [...definition.aliases] : undefined,
-        roles: definition.roles.length > 0 ? [...definition.roles] : undefined,
-        description: definition.description,
-        order: definition.order,
-    };
-}
-function serializeRuntimeFieldDefinition(definition) {
-    return {
-        key: definition.key,
-        metadata_key: definition.metadata_key !== definition.key
-            ? definition.metadata_key
-            : undefined,
-        cli_flag: definition.cli_flag !== keyToDefaultCliFlag(definition.key)
-            ? definition.cli_flag
-            : undefined,
-        cli_aliases: definition.cli_aliases.length > 0
-            ? [...definition.cli_aliases]
-            : undefined,
-        description: definition.description,
-        type: definition.type,
-        commands: [...definition.commands],
-        repeatable: definition.repeatable === true ? true : undefined,
-        required: definition.required === true ? true : undefined,
-        required_on_create: definition.required_on_create === true ? true : undefined,
-        required_types: definition.required_types.length > 0
-            ? [...definition.required_types]
-            : undefined,
-        allow_unset: definition.allow_unset === false ? false : undefined,
-        value_schema: definition.value_schema,
-    };
-}
-function normalizeUnknownFieldPolicy(policy) {
-    const candidate = typeof policy === "string" ? policy.trim().toLowerCase() : "allow";
-    return RUNTIME_UNKNOWN_FIELD_POLICY_SET.has(candidate)
-        ? candidate
-        : "allow";
-}
-/** Implements normalize runtime schema settings for the public runtime surface of this module. */
-export function normalizeRuntimeSchemaSettings(schema) {
-    const files = {
-        ...DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
-        ...schema?.files,
-    };
-    const statusesSource = schema?.statuses && schema.statuses.length > 0
-        ? schema.statuses
-        : DEFAULT_RUNTIME_STATUS_DEFINITIONS;
-    const normalizedStatuses = normalizeRuntimeStatusDefinitions(statusesSource);
-    const normalizedFields = normalizeRuntimeFieldDefinitions(schema?.fields);
-    return {
-        version: typeof schema?.version === "number" && Number.isFinite(schema.version)
-            ? Math.floor(schema.version)
-            : 1,
-        files,
-        statuses: normalizedStatuses.map(serializeRuntimeStatusDefinition),
-        fields: normalizedFields.map(serializeRuntimeFieldDefinition),
-        workflow: {
-            ...DEFAULT_RUNTIME_WORKFLOW,
-            ...normalizeRuntimeWorkflow(schema?.workflow),
-        },
-        type_workflows: normalizeTypeWorkflowDefinitions(schema?.type_workflows),
-        unknown_field_policy: normalizeUnknownFieldPolicy(schema?.unknown_field_policy),
-    };
-}
-function serializeJson(value) {
-    return `${JSON.stringify(value, null, 2)}\n`;
-}
-function buildTypesFileSeed() {
-    return {
-        definitions: [],
-    };
-}
-function buildStatusesFileSeed() {
-    return {
-        statuses: DEFAULT_RUNTIME_STATUS_DEFINITIONS,
-    };
-}
-function buildFieldsFileSeed() {
-    return {
-        fields: [],
-    };
-}
-function buildWorkflowsFileSeed() {
-    return {
-        workflow: DEFAULT_RUNTIME_WORKFLOW,
-    };
-}
-function parseOptionalJson(raw, warningKey, warnings) {
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        warnings.push(warningKey);
-        return undefined;
-    }
-}
-function readTypeDefinitionsFromSchemaFile(parsed) {
-    if (Array.isArray(parsed)) {
-        return parsed;
-    }
-    if (typeof parsed !== "object" || parsed === null) {
-        return undefined;
-    }
-    const record = parsed;
-    if (Array.isArray(record.definitions)) {
-        return record.definitions;
-    }
-    if (typeof record.item_types === "object" && record.item_types !== null) {
-        const itemTypesRecord = record.item_types;
-        if (Array.isArray(itemTypesRecord.definitions)) {
-            return itemTypesRecord.definitions;
-        }
-    }
-    return undefined;
-}
-function readStatusesFromSchemaFile(parsed) {
-    if (Array.isArray(parsed)) {
-        return parsed;
-    }
-    if (typeof parsed !== "object" || parsed === null) {
-        return undefined;
-    }
-    const record = parsed;
-    if (Array.isArray(record.statuses)) {
-        return record.statuses;
-    }
-    if (Array.isArray(record.definitions)) {
-        return record.definitions;
-    }
-    return undefined;
-}
-function readFieldsFromSchemaFile(parsed) {
-    if (Array.isArray(parsed)) {
-        return parsed;
-    }
-    if (typeof parsed !== "object" || parsed === null) {
-        return undefined;
-    }
-    const record = parsed;
-    if (Array.isArray(record.fields)) {
-        return record.fields;
-    }
-    if (Array.isArray(record.definitions)) {
-        return record.definitions;
-    }
-    return undefined;
-}
-function readWorkflowFromSchemaFile(parsed) {
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-        return undefined;
-    }
-    const record = parsed;
-    if (typeof record.workflow === "object" &&
-        record.workflow !== null &&
-        !Array.isArray(record.workflow)) {
-        return record.workflow;
-    }
-    if (typeof record.workflows === "object" &&
-        record.workflows !== null &&
-        !Array.isArray(record.workflows)) {
-        return record.workflows;
-    }
-    return record;
-}
-function readTypeWorkflowsFromSchemaFile(parsed) {
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-        return undefined;
-    }
-    const record = parsed;
-    if (Array.isArray(record.type_workflows)) {
-        return record.type_workflows;
-    }
-    return undefined;
-}
-/** Implements file path for schema section for the public runtime surface of this module. */
-export function filePathForSchemaSection(pmRoot, configuredPath, fallbackPath) {
-    const normalized = configuredPath?.trim() || fallbackPath;
-    if (path.isAbsolute(normalized)) {
-        return normalized;
-    }
-    return path.join(pmRoot, normalized);
-}
-/** Resolves the active tracker's `schema/types.json` path so user-facing hints (e.g. the invalid-type error) point at the real `--pm-path` location instead of the hardcoded `.agents/pm` default. Mirrors how `pm schema add/remove-type` report their target path. */
-export function resolveItemTypesFilePath(pmRoot, schema) {
-    return filePathForSchemaSection(pmRoot, schema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types);
-}
-/** Implements ensure runtime schema file scaffold for the public runtime surface of this module. */
-export async function ensureRuntimeSchemaFileScaffold(pmRoot, schema) {
-    const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
-    const specs = [
-        {
-            path: filePathForSchemaSection(pmRoot, normalizedSchema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types),
-            seed: buildTypesFileSeed(),
-        },
-        {
-            path: filePathForSchemaSection(pmRoot, normalizedSchema.files.statuses, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses),
-            seed: buildStatusesFileSeed(),
-        },
-        {
-            path: filePathForSchemaSection(pmRoot, normalizedSchema.files.fields, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields),
-            seed: buildFieldsFileSeed(),
-        },
-        {
-            path: filePathForSchemaSection(pmRoot, normalizedSchema.files.workflows, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.workflows),
-            seed: buildWorkflowsFileSeed(),
-        },
-    ];
-    const createdPaths = [];
-    for (const spec of specs) {
-        if (await pathExists(spec.path)) {
-            continue;
-        }
-        await writeFileAtomic(spec.path, serializeJson(spec.seed));
-        createdPaths.push(spec.path);
-    }
-    return {
-        created_paths: createdPaths,
-    };
-}
-/** Implements load runtime schema from optional files for the public runtime surface of this module. */
-export async function loadRuntimeSchemaFromOptionalFiles(pmRoot, schema) {
-    const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
-    const warnings = [];
-    const typeFilePath = filePathForSchemaSection(pmRoot, normalizedSchema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types);
-    const statusFilePath = filePathForSchemaSection(pmRoot, normalizedSchema.files.statuses, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses);
-    const fieldsFilePath = filePathForSchemaSection(pmRoot, normalizedSchema.files.fields, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields);
-    const workflowsFilePath = filePathForSchemaSection(pmRoot, normalizedSchema.files.workflows, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.workflows);
-    let loadedTypeDefinitions;
-    let loadedStatuses;
-    let loadedFields;
-    let loadedWorkflow;
-    let loadedTypeWorkflows;
-    const readAndParse = async (targetPath, warningKey) => {
-        const raw = await readFileIfExists(targetPath);
-        if (raw === null) {
-            return undefined;
-        }
-        return parseOptionalJson(raw, warningKey, warnings);
-    };
-    const parsedTypes = await readAndParse(typeFilePath, "runtime_schema_types_invalid_json");
-    if (parsedTypes !== undefined) {
-        loadedTypeDefinitions = readTypeDefinitionsFromSchemaFile(parsedTypes);
-        if (loadedTypeDefinitions === undefined) {
-            warnings.push("runtime_schema_types_invalid_shape");
-        }
-    }
-    const parsedStatuses = await readAndParse(statusFilePath, "runtime_schema_statuses_invalid_json");
-    if (parsedStatuses !== undefined) {
-        loadedStatuses = readStatusesFromSchemaFile(parsedStatuses);
-        if (loadedStatuses === undefined) {
-            warnings.push("runtime_schema_statuses_invalid_shape");
-        }
-    }
-    const parsedFields = await readAndParse(fieldsFilePath, "runtime_schema_fields_invalid_json");
-    if (parsedFields !== undefined) {
-        loadedFields = readFieldsFromSchemaFile(parsedFields);
-        if (loadedFields === undefined) {
-            warnings.push("runtime_schema_fields_invalid_shape");
-        }
-    }
-    const parsedWorkflow = await readAndParse(workflowsFilePath, "runtime_schema_workflows_invalid_json");
-    if (parsedWorkflow !== undefined) {
-        loadedWorkflow = readWorkflowFromSchemaFile(parsedWorkflow);
-        if (loadedWorkflow === undefined) {
-            warnings.push("runtime_schema_workflows_invalid_shape");
-        }
-        // type_workflows live alongside `workflow` in the same file; their absence
-        // is not an error (the file may carry only the lifecycle workflow block).
-        loadedTypeWorkflows = readTypeWorkflowsFromSchemaFile(parsedWorkflow);
-    }
-    const mergedSchema = normalizeRuntimeSchemaSettings({
-        ...normalizedSchema,
-        statuses: [...normalizedSchema.statuses, ...(loadedStatuses ?? [])],
-        fields: [...normalizedSchema.fields, ...(loadedFields ?? [])],
-        workflow: {
-            ...normalizedSchema.workflow,
-            ...loadedWorkflow,
-        },
-        type_workflows: [
-            ...(normalizedSchema.type_workflows ?? []),
-            ...(loadedTypeWorkflows ?? []),
-        ],
-    });
-    return {
-        schema: mergedSchema,
-        type_definitions_from_file: loadedTypeDefinitions,
-        warnings,
-        created_paths: [],
-    };
-}
-function preferredStatusForRole(definitions, role, fallbackValues, fallbackFirst = false) {
-    const normalizedFallbacks = fallbackValues
-        .map((value) => normalizeStatusId(value))
-        .filter((value) => typeof value === "string");
-    const fallbackMatch = normalizedFallbacks.find((normalized) => definitions.some((definition) => definition.id === normalized));
-    if (fallbackFirst && fallbackMatch !== undefined) {
-        return fallbackMatch;
-    }
-    const withRole = definitions.find((definition) => definition.roles.includes(role));
-    if (withRole !== undefined) {
-        return withRole.id;
-    }
-    return fallbackMatch ?? definitions[0]?.id;
-}
-/** Build normalized identifier and alias indexes for runtime status lookup. */
-function buildRuntimeStatusIndexes(definitions) {
-    const aliasToId = new Map();
-    const byId = new Map();
-    for (const definition of definitions) {
-        byId.set(definition.id, definition);
-        aliasToId.set(definition.id, definition.id);
-        aliasToId.set(definition.id.replaceAll("_", "-"), definition.id);
-        aliasToId.set(definition.id.replaceAll("_", " "), definition.id);
-        for (const alias of definition.aliases) {
-            aliasToId.set(alias, definition.id);
-            aliasToId.set(alias.replaceAll("_", "-"), definition.id);
-            aliasToId.set(alias.replaceAll("_", " "), definition.id);
-        }
-    }
-    return { aliasToId, byId };
-}
-/** Classify runtime statuses into lifecycle role sets used by all consumers. */
-function buildRuntimeStatusRoleSets(definitions) {
-    const result = {
-        activeStatuses: new Set(),
-        blockedStatuses: new Set(),
-        draftStatuses: new Set(),
-        terminalCanceledStatuses: new Set(),
-        terminalDoneStatuses: new Set(),
-        terminalStatuses: new Set(),
-    };
-    for (const definition of definitions) {
-        const roles = new Set(definition.roles);
-        if (roles.has("terminal") ||
-            roles.has("terminal_done") ||
-            roles.has("terminal_canceled")) {
-            result.terminalStatuses.add(definition.id);
-        }
-        if (roles.has("terminal_done"))
-            result.terminalDoneStatuses.add(definition.id);
-        if (roles.has("terminal_canceled")) {
-            result.terminalCanceledStatuses.add(definition.id);
-        }
-        if (roles.has("active"))
-            result.activeStatuses.add(definition.id);
-        if (roles.has("blocked"))
-            result.blockedStatuses.add(definition.id);
-        if (roles.has("draft"))
-            result.draftStatuses.add(definition.id);
-    }
-    return result;
-}
-/** Implements resolve runtime status registry for the public runtime surface of this module. */
-export function resolveRuntimeStatusRegistry(schema) {
-    const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
-    const definitions = normalizedSchema.statuses
-        .map((definition, index) => normalizeRuntimeStatusDefinition(definition, index))
-        .filter((definition) => definition !== null);
-    const { aliasToId, byId } = buildRuntimeStatusIndexes(definitions);
-    const { activeStatuses, blockedStatuses, draftStatuses, terminalCanceledStatuses, terminalDoneStatuses, terminalStatuses, } = buildRuntimeStatusRoleSets(definitions);
-    const workflow = normalizedSchema.workflow;
-    const openStatus = (normalizeStatusId(workflow.open_status) ??
-        preferredStatusForRole(definitions, "default_open", [
-            "open",
-            "in_progress",
-            STATUS_VALUES[0],
-        ]));
-    const inProgressStatus = normalizeStatusId(workflow.in_progress_status) ??
-        preferredStatusForRole(definitions, "active", ["in_progress", "in-progress", openStatus], true);
-    const blockedStatus = normalizeStatusId(workflow.blocked_status) ??
-        preferredStatusForRole(definitions, "blocked", ["blocked"]);
-    const closeStatus = normalizeStatusId(workflow.close_status) ??
-        preferredStatusForRole(definitions, "default_close", [
-            "closed",
-            "done",
-            "complete",
-        ]);
-    const canceledStatus = normalizeStatusId(workflow.canceled_status) ??
-        preferredStatusForRole(definitions, "default_cancel", [
-            "canceled",
-            "cancelled",
-        ]);
-    return {
-        definitions,
-        by_id: byId,
-        alias_to_id: aliasToId,
-        terminal_statuses: terminalStatuses,
-        terminal_done_statuses: terminalDoneStatuses,
-        terminal_canceled_statuses: terminalCanceledStatuses,
-        active_statuses: activeStatuses,
-        blocked_statuses: blockedStatuses,
-        draft_statuses: draftStatuses,
-        open_status: openStatus,
-        in_progress_status: inProgressStatus,
-        blocked_status: blockedStatus,
-        close_status: closeStatus,
-        canceled_status: canceledStatus,
-    };
-}
-/** Implements normalize status input with registry for the public runtime surface of this module. */
-export function normalizeStatusInputWithRegistry(value, registry) {
-    const normalized = normalizeStatusToken(value);
-    if (!normalized) {
-        return undefined;
-    }
-    return registry.alias_to_id.get(normalized);
-}
-/** Implements resolve runtime field registry for the public runtime surface of this module. */
-export function resolveRuntimeFieldRegistry(schema) {
-    const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
-    const dedupedByKey = new Map();
-    const normalizedFields = normalizedSchema.fields
-        .map((definition) => normalizeRuntimeFieldDefinition(definition))
-        .filter((definition) => definition !== null);
-    for (const normalized of normalizedFields) {
-        dedupedByKey.set(normalized.key, normalized);
-    }
-    const definitions = [...dedupedByKey.values()].sort((left, right) => left.key.localeCompare(right.key));
-    const byKey = new Map();
-    const byCliToken = new Map();
-    const commandToFields = new Map();
-    for (const definition of definitions) {
-        byKey.set(definition.key, definition);
-        byCliToken.set(definition.cli_flag, definition);
-        for (const alias of definition.cli_aliases) {
-            byCliToken.set(alias, definition);
-        }
-        for (const command of definition.commands) {
-            const existing = commandToFields.get(command) ?? [];
-            existing.push(definition);
-            commandToFields.set(command, existing);
-        }
-    }
-    for (const [command, fieldDefinitions] of commandToFields.entries()) {
-        fieldDefinitions.sort((left, right) => left.key.localeCompare(right.key));
-        commandToFields.set(command, fieldDefinitions);
-    }
-    return {
-        definitions,
-        by_key: byKey,
-        by_cli_token: byCliToken,
-        command_to_fields: commandToFields,
-    };
-}
-/** Implements runtime field option target for the public runtime surface of this module. */
-export function runtimeFieldOptionTarget(field) {
-    return toCamelCase(field.key);
-}
-/** Implements status is terminal for the public runtime surface of this module. */
-export function statusIsTerminal(status, registry) {
-    const normalized = normalizeStatusInputWithRegistry(status, registry);
-    if (!normalized) {
-        return false;
-    }
-    return registry.terminal_statuses.has(normalized);
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="87798e93-c34c-5355-aa60-695fb9e3eef1")}catch(e2){}})();import path from"node:path";import{pathExists,readFileIfExists,writeFileAtomic}from"../fs/fs-utils.js";import{DEFAULT_STATUS_DEFINITIONS,DEFAULT_WORKFLOW_DEFINITION}from"../shared/constants.js";import{RUNTIME_FIELD_COMMAND_VALUES,RUNTIME_FIELD_TYPE_VALUES,RUNTIME_STATUS_ROLE_VALUES,RUNTIME_UNKNOWN_FIELD_POLICY_VALUES,STATUS_VALUES}from"../../types/index.js";import{normalizeStatusToken}from"./status-token.js";const DEFAULT_RUNTIME_SCHEMA_FILE_PATHS=Object.freeze({types:"schema/types.json",statuses:"schema/statuses.json",fields:"schema/fields.json",workflows:"schema/workflows.json"});const DEFAULT_RUNTIME_WORKFLOW=DEFAULT_WORKFLOW_DEFINITION;const DEFAULT_RUNTIME_STATUS_DEFINITIONS=DEFAULT_STATUS_DEFINITIONS;const DEFAULT_RUNTIME_FIELD_COMMANDS=["create","update"];const RUNTIME_STATUS_ROLE_SET=new Set(RUNTIME_STATUS_ROLE_VALUES);const RUNTIME_FIELD_TYPE_SET=new Set(RUNTIME_FIELD_TYPE_VALUES);const RUNTIME_FIELD_COMMAND_SET=new Set(RUNTIME_FIELD_COMMAND_VALUES);const RUNTIME_UNKNOWN_FIELD_POLICY_SET=new Set(RUNTIME_UNKNOWN_FIELD_POLICY_VALUES);const RUNTIME_FIELD_VALUE_TYPE_SET=new Set(["string","number","boolean","array","object"]);const MAX_RUNTIME_FIELD_VALUE_SCHEMA_DEPTH=16;function isPlainObject(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}const RUNTIME_FIELD_VALUE_SCHEMA_SHAPE_VALIDATORS=[schema=>schema.type===void 0||typeof schema.type==="string"&&RUNTIME_FIELD_VALUE_TYPE_SET.has(schema.type),schema=>!Object.hasOwn(schema,"const")||isStructuredJsonValue(schema.const),schema=>schema.enum===void 0||Array.isArray(schema.enum)&&schema.enum.every(entry=>isStructuredJsonValue(entry)),schema=>schema.min_length===void 0||Number.isInteger(schema.min_length)&&schema.min_length>=0,schema=>schema.min_items===void 0||Number.isInteger(schema.min_items)&&schema.min_items>=0,schema=>schema.format===void 0||schema.format==="date-time",schema=>schema.required===void 0||Array.isArray(schema.required)&&schema.required.every(entry=>typeof entry==="string"&&entry.length>0),schema=>schema.additional_properties===void 0||typeof schema.additional_properties==="boolean",schema=>schema.properties===void 0||isPlainObject(schema.properties),schema=>schema.one_of===void 0||Array.isArray(schema.one_of)&&schema.one_of.length>0];function isStructuredJsonValue(value,ancestors=new Set){if(value===null||typeof value==="string"||typeof value==="boolean"){return true}if(typeof value==="number")return Number.isFinite(value);if(typeof value!=="object"||ancestors.has(value))return false;ancestors.add(value);const valid=Array.isArray(value)?value.every(entry=>isStructuredJsonValue(entry,ancestors)):Object.values(value).every(entry=>isStructuredJsonValue(entry,ancestors));ancestors.delete(value);return valid}function normalizeRuntimeFieldValueSchema(value,depth=0,ancestors=new Set){if(!isPlainObject(value)||depth>MAX_RUNTIME_FIELD_VALUE_SCHEMA_DEPTH||ancestors.has(value)){return void 0}ancestors.add(value);const schema=value;const type=schema.type;const enumValues=schema.enum;const oneOf=schema.one_of;const properties=schema.properties;const items=schema.items;const required=schema.required;const minLength=schema.min_length;const minItems=schema.min_items;const format=schema.format;const additionalProperties=schema.additional_properties;if(!RUNTIME_FIELD_VALUE_SCHEMA_SHAPE_VALIDATORS.every(check=>check(schema))){ancestors.delete(value);return void 0}const normalizedProperties=properties===void 0?void 0:Object.fromEntries(Object.entries(properties).map(([key,entry])=>[key,normalizeRuntimeFieldValueSchema(entry,depth+1,ancestors)]));const normalizedItems=items===void 0?void 0:normalizeRuntimeFieldValueSchema(items,depth+1,ancestors);const normalizedOneOf=oneOf===void 0?void 0:oneOf.map(entry=>normalizeRuntimeFieldValueSchema(entry,depth+1,ancestors));const normalizedNestedSchemas=[...Object.values(normalizedProperties??{}),...items===void 0?[]:[normalizedItems],...normalizedOneOf??[]];if(normalizedNestedSchemas.some(entry=>entry===void 0)){ancestors.delete(value);return void 0}ancestors.delete(value);return Object.fromEntries(Object.entries({type,const:Object.hasOwn(schema,"const")?schema.const:void 0,enum:enumValues,min_length:minLength,min_items:minItems,format,properties:normalizedProperties,required:required===void 0?void 0:[...new Set(required)],additional_properties:additionalProperties,items:normalizedItems,one_of:normalizedOneOf}).filter(([,entry])=>entry!==void 0))}function normalizeStringList(values){const candidates=Array.isArray(values)?values:[];return[...new Set(candidates.map(value=>typeof value==="string"?value.trim():"").filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right))}function normalizeStatusId(value){if(typeof value!=="string"||value.length===0){return void 0}const normalized=normalizeStatusToken(value);return normalized.length>0?normalized:void 0}function stripFlagPrefix(value){return value.startsWith("--")?value.slice(2):value}function normalizeCliToken(value){return typeof value==="string"?stripFlagPrefix(value.trim().toLowerCase().replaceAll(/[\s_]+/g,"-")):""}function keyToDefaultCliFlag(value){return value.replaceAll("_","-")}function toCamelCase(input){const segments=input.replaceAll(/[^A-Za-z0-9]+/g," ").trim().split(/\s+/).filter(segment=>segment.length>0).map(segment=>segment.toLowerCase());if(segments.length===0){return input}const[first,...rest]=segments;return`${first}${rest.map(segment=>`${segment.slice(0,1).toUpperCase()}${segment.slice(1)}`).join("")}`}function normalizeRuntimeStatusDefinition(definition,fallbackOrder){const id=normalizeStatusId(definition.id);if(!id){return null}const aliases=[...new Set(normalizeStringList(definition.aliases).map(normalizeStatusToken).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right));const roles=normalizeStringList(definition.roles).filter(value=>RUNTIME_STATUS_ROLE_SET.has(value));const description=definition.description?.trim();const order=typeof definition.order==="number"&&Number.isFinite(definition.order)?definition.order:fallbackOrder;return{id,aliases,roles,description:description&&description.length>0?description:void 0,order}}function normalizeRuntimeWorkflow(workflow){return{draft_status:normalizeStatusId(workflow?.draft_status),open_status:normalizeStatusId(workflow?.open_status),in_progress_status:normalizeStatusId(workflow?.in_progress_status),blocked_status:normalizeStatusId(workflow?.blocked_status),close_status:normalizeStatusId(workflow?.close_status),canceled_status:normalizeStatusId(workflow?.canceled_status)}}function appendTypeWorkflowPair(record,pair){if(!Array.isArray(pair)||pair.length!==2){return}const from=normalizeStatusToken(pair[0]);const to=normalizeStatusToken(pair[1]);if(from.length===0||to.length===0){return}if(record.pairs.some(candidate=>candidate[0]===from&&candidate[1]===to)){return}record.pairs.push([from,to])}function normalizedTypeWorkflowEntry(entry){const rawType=typeof entry?.type==="string"?entry.type.trim():"";if(rawType.length===0||!Array.isArray(entry?.allowed_transitions)){return null}const record={type:rawType,pairs:[],denyAll:entry.allowed_transitions.length===0};for(const pair of entry.allowed_transitions){appendTypeWorkflowPair(record,pair)}return{typeKey:rawType.toLowerCase(),record}}function normalizeTypeWorkflowDefinitions(workflows){if(!Array.isArray(workflows)||workflows.length===0){return void 0}const byTypeKey=new Map;for(const entry of workflows){const normalized2=normalizedTypeWorkflowEntry(entry);if(normalized2===null){continue}const record=byTypeKey.get(normalized2.typeKey)??normalized2.record;record.denyAll||=normalized2.record.denyAll;for(const pair of normalized2.record.pairs){appendTypeWorkflowPair(record,pair)}byTypeKey.set(normalized2.typeKey,record)}const normalized=[];for(const record of byTypeKey.values()){if(record.pairs.length>0||record.denyAll){normalized.push({type:record.type,allowed_transitions:record.pairs})}}normalized.sort((left,right)=>left.type.localeCompare(right.type));return normalized.length>0?normalized:void 0}function normalizeRuntimeFieldDefinition(definition){const key=normalizeStatusToken(definition.key??"");if(!key){return null}const metadataKey=normalizeStatusToken(definition.metadata_key??definition.front_matter_key??key);const cliFlag=normalizeCliToken(definition.cli_flag??keyToDefaultCliFlag(key));if(!cliFlag){return null}const cliAliases=normalizeStringList(definition.cli_aliases).map(value=>normalizeCliToken(value)).filter(value=>value.length>0&&value!==cliFlag);const typeCandidate=typeof definition.type==="string"?definition.type.trim().toLowerCase():"string";const type=RUNTIME_FIELD_TYPE_SET.has(typeCandidate)?typeCandidate:"string";const commands=(()=>{const normalized=normalizeStringList(definition.commands).filter(value=>RUNTIME_FIELD_COMMAND_SET.has(value));if(normalized.length>0){return normalized}return[...DEFAULT_RUNTIME_FIELD_COMMANDS]})();const description=definition.description?.trim();const requiredTypes=normalizeStringList(definition.required_types);const valueSchema=definition.value_schema===void 0?void 0:normalizeRuntimeFieldValueSchema(definition.value_schema);if(definition.value_schema!==void 0&&valueSchema===void 0){return null}return{key,metadata_key:metadataKey,cli_flag:cliFlag,cli_aliases:cliAliases,description:description&&description.length>0?description:void 0,type,commands,repeatable:[definition.repeatable===true,type==="string_array"].includes(true),required:definition.required===true,required_on_create:definition.required_on_create===true,required_types:requiredTypes,allow_unset:definition.allow_unset!==false,value_schema:valueSchema}}function normalizeRuntimeStatusDefinitions(statusesSource){const dedupedById=new Map;for(const[index,definition]of statusesSource.entries()){const normalized=normalizeRuntimeStatusDefinition(definition,index);if(normalized){dedupedById.set(normalized.id,normalized)}}const values=sortRuntimeStatusDefinitions([...dedupedById.values()]);if(values.length>0){return values}return sortRuntimeStatusDefinitions(DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition,index)=>normalizeRuntimeStatusDefinition(definition,index)).filter(definition=>definition!==null))}function sortRuntimeStatusDefinitions(definitions){return definitions.sort((left,right)=>left.order===right.order?left.id.localeCompare(right.id):left.order-right.order)}function normalizeRuntimeFieldDefinitions(fieldsSource){const dedupedByKey=new Map;for(const definition of fieldsSource??[]){const normalized=normalizeRuntimeFieldDefinition(definition);if(normalized){dedupedByKey.set(normalized.key,normalized)}}return[...dedupedByKey.values()].sort((left,right)=>left.key.localeCompare(right.key))}function serializeRuntimeStatusDefinition(definition){return{id:definition.id,aliases:definition.aliases.length>0?[...definition.aliases]:void 0,roles:definition.roles.length>0?[...definition.roles]:void 0,description:definition.description,order:definition.order}}function serializeRuntimeFieldDefinition(definition){return{key:definition.key,metadata_key:definition.metadata_key!==definition.key?definition.metadata_key:void 0,cli_flag:definition.cli_flag!==keyToDefaultCliFlag(definition.key)?definition.cli_flag:void 0,cli_aliases:definition.cli_aliases.length>0?[...definition.cli_aliases]:void 0,description:definition.description,type:definition.type,commands:[...definition.commands],repeatable:definition.repeatable===true?true:void 0,required:definition.required===true?true:void 0,required_on_create:definition.required_on_create===true?true:void 0,required_types:definition.required_types.length>0?[...definition.required_types]:void 0,allow_unset:definition.allow_unset===false?false:void 0,value_schema:definition.value_schema}}function normalizeUnknownFieldPolicy(policy){const candidate=typeof policy==="string"?policy.trim().toLowerCase():"allow";return RUNTIME_UNKNOWN_FIELD_POLICY_SET.has(candidate)?candidate:"allow"}function normalizeRuntimeSchemaSettings(schema){const files={...DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,...schema?.files};const statusesSource=schema?.statuses&&schema.statuses.length>0?schema.statuses:DEFAULT_RUNTIME_STATUS_DEFINITIONS;const normalizedStatuses=normalizeRuntimeStatusDefinitions(statusesSource);const normalizedFields=normalizeRuntimeFieldDefinitions(schema?.fields);return{version:typeof schema?.version==="number"&&Number.isFinite(schema.version)?Math.floor(schema.version):1,files,statuses:normalizedStatuses.map(serializeRuntimeStatusDefinition),fields:normalizedFields.map(serializeRuntimeFieldDefinition),workflow:{...DEFAULT_RUNTIME_WORKFLOW,...normalizeRuntimeWorkflow(schema?.workflow)},type_workflows:normalizeTypeWorkflowDefinitions(schema?.type_workflows),unknown_field_policy:normalizeUnknownFieldPolicy(schema?.unknown_field_policy)}}function serializeJson(value){return`${JSON.stringify(value,null,2)}
+`}function buildTypesFileSeed(){return{definitions:[]}}function buildStatusesFileSeed(){return{statuses:DEFAULT_RUNTIME_STATUS_DEFINITIONS}}function buildFieldsFileSeed(){return{fields:[]}}function buildWorkflowsFileSeed(){return{workflow:DEFAULT_RUNTIME_WORKFLOW}}function parseOptionalJson(raw,warningKey,warnings){try{return JSON.parse(raw)}catch{warnings.push(warningKey);return void 0}}function readTypeDefinitionsFromSchemaFile(parsed){if(Array.isArray(parsed)){return parsed}if(typeof parsed!=="object"||parsed===null){return void 0}const record=parsed;if(Array.isArray(record.definitions)){return record.definitions}if(typeof record.item_types==="object"&&record.item_types!==null){const itemTypesRecord=record.item_types;if(Array.isArray(itemTypesRecord.definitions)){return itemTypesRecord.definitions}}return void 0}function readStatusesFromSchemaFile(parsed){if(Array.isArray(parsed)){return parsed}if(typeof parsed!=="object"||parsed===null){return void 0}const record=parsed;if(Array.isArray(record.statuses)){return record.statuses}if(Array.isArray(record.definitions)){return record.definitions}return void 0}function readFieldsFromSchemaFile(parsed){if(Array.isArray(parsed)){return parsed}if(typeof parsed!=="object"||parsed===null){return void 0}const record=parsed;if(Array.isArray(record.fields)){return record.fields}if(Array.isArray(record.definitions)){return record.definitions}return void 0}function readWorkflowFromSchemaFile(parsed){if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed)){return void 0}const record=parsed;if(typeof record.workflow==="object"&&record.workflow!==null&&!Array.isArray(record.workflow)){return record.workflow}if(typeof record.workflows==="object"&&record.workflows!==null&&!Array.isArray(record.workflows)){return record.workflows}return record}function readTypeWorkflowsFromSchemaFile(parsed){if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed)){return void 0}const record=parsed;if(Array.isArray(record.type_workflows)){return record.type_workflows}return void 0}function filePathForSchemaSection(pmRoot,configuredPath,fallbackPath){const normalized=configuredPath?.trim()||fallbackPath;if(path.isAbsolute(normalized)){return normalized}return path.join(pmRoot,normalized)}function resolveItemTypesFilePath(pmRoot,schema){return filePathForSchemaSection(pmRoot,schema.files.types,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types)}async function ensureRuntimeSchemaFileScaffold(pmRoot,schema){const normalizedSchema=normalizeRuntimeSchemaSettings(schema);const specs=[{path:filePathForSchemaSection(pmRoot,normalizedSchema.files.types,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types),seed:buildTypesFileSeed()},{path:filePathForSchemaSection(pmRoot,normalizedSchema.files.statuses,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses),seed:buildStatusesFileSeed()},{path:filePathForSchemaSection(pmRoot,normalizedSchema.files.fields,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields),seed:buildFieldsFileSeed()},{path:filePathForSchemaSection(pmRoot,normalizedSchema.files.workflows,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.workflows),seed:buildWorkflowsFileSeed()}];const createdPaths=[];for(const spec of specs){if(await pathExists(spec.path)){continue}await writeFileAtomic(spec.path,serializeJson(spec.seed));createdPaths.push(spec.path)}return{created_paths:createdPaths}}async function loadRuntimeSchemaFromOptionalFiles(pmRoot,schema){const normalizedSchema=normalizeRuntimeSchemaSettings(schema);const warnings=[];const typeFilePath=filePathForSchemaSection(pmRoot,normalizedSchema.files.types,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types);const statusFilePath=filePathForSchemaSection(pmRoot,normalizedSchema.files.statuses,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses);const fieldsFilePath=filePathForSchemaSection(pmRoot,normalizedSchema.files.fields,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields);const workflowsFilePath=filePathForSchemaSection(pmRoot,normalizedSchema.files.workflows,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.workflows);let loadedTypeDefinitions;let loadedStatuses;let loadedFields;let loadedWorkflow;let loadedTypeWorkflows;const readAndParse=async(targetPath,warningKey)=>{const raw=await readFileIfExists(targetPath);if(raw===null){return void 0}return parseOptionalJson(raw,warningKey,warnings)};const parsedTypes=await readAndParse(typeFilePath,"runtime_schema_types_invalid_json");if(parsedTypes!==void 0){loadedTypeDefinitions=readTypeDefinitionsFromSchemaFile(parsedTypes);if(loadedTypeDefinitions===void 0){warnings.push("runtime_schema_types_invalid_shape")}}const parsedStatuses=await readAndParse(statusFilePath,"runtime_schema_statuses_invalid_json");if(parsedStatuses!==void 0){loadedStatuses=readStatusesFromSchemaFile(parsedStatuses);if(loadedStatuses===void 0){warnings.push("runtime_schema_statuses_invalid_shape")}}const parsedFields=await readAndParse(fieldsFilePath,"runtime_schema_fields_invalid_json");if(parsedFields!==void 0){loadedFields=readFieldsFromSchemaFile(parsedFields);if(loadedFields===void 0){warnings.push("runtime_schema_fields_invalid_shape")}}const parsedWorkflow=await readAndParse(workflowsFilePath,"runtime_schema_workflows_invalid_json");if(parsedWorkflow!==void 0){loadedWorkflow=readWorkflowFromSchemaFile(parsedWorkflow);if(loadedWorkflow===void 0){warnings.push("runtime_schema_workflows_invalid_shape")}loadedTypeWorkflows=readTypeWorkflowsFromSchemaFile(parsedWorkflow)}const mergedSchema=normalizeRuntimeSchemaSettings({...normalizedSchema,statuses:[...normalizedSchema.statuses,...loadedStatuses??[]],fields:[...normalizedSchema.fields,...loadedFields??[]],workflow:{...normalizedSchema.workflow,...loadedWorkflow},type_workflows:[...normalizedSchema.type_workflows??[],...loadedTypeWorkflows??[]]});return{schema:mergedSchema,type_definitions_from_file:loadedTypeDefinitions,warnings,created_paths:[]}}function preferredStatusForRole(definitions,role,fallbackValues,fallbackFirst=false){const normalizedFallbacks=fallbackValues.map(value=>normalizeStatusId(value)).filter(value=>typeof value==="string");const fallbackMatch=normalizedFallbacks.find(normalized=>definitions.some(definition=>definition.id===normalized));if(fallbackFirst&&fallbackMatch!==void 0){return fallbackMatch}const withRole=definitions.find(definition=>definition.roles.includes(role));if(withRole!==void 0){return withRole.id}return fallbackMatch??definitions[0]?.id}function buildRuntimeStatusIndexes(definitions){const aliasToId=new Map;const byId=new Map;for(const definition of definitions){byId.set(definition.id,definition);aliasToId.set(definition.id,definition.id);aliasToId.set(definition.id.replaceAll("_","-"),definition.id);aliasToId.set(definition.id.replaceAll("_"," "),definition.id);for(const alias of definition.aliases){aliasToId.set(alias,definition.id);aliasToId.set(alias.replaceAll("_","-"),definition.id);aliasToId.set(alias.replaceAll("_"," "),definition.id)}}return{aliasToId,byId}}function buildRuntimeStatusRoleSets(definitions){const result={activeStatuses:new Set,blockedStatuses:new Set,draftStatuses:new Set,terminalCanceledStatuses:new Set,terminalDoneStatuses:new Set,terminalStatuses:new Set};for(const definition of definitions){const roles=new Set(definition.roles);if(roles.has("terminal")||roles.has("terminal_done")||roles.has("terminal_canceled")){result.terminalStatuses.add(definition.id)}if(roles.has("terminal_done"))result.terminalDoneStatuses.add(definition.id);if(roles.has("terminal_canceled")){result.terminalCanceledStatuses.add(definition.id)}if(roles.has("active"))result.activeStatuses.add(definition.id);if(roles.has("blocked"))result.blockedStatuses.add(definition.id);if(roles.has("draft"))result.draftStatuses.add(definition.id)}return result}function resolveRuntimeStatusRegistry(schema){const normalizedSchema=normalizeRuntimeSchemaSettings(schema);const definitions=normalizedSchema.statuses.map((definition,index)=>normalizeRuntimeStatusDefinition(definition,index)).filter(definition=>definition!==null);const{aliasToId,byId}=buildRuntimeStatusIndexes(definitions);const{activeStatuses,blockedStatuses,draftStatuses,terminalCanceledStatuses,terminalDoneStatuses,terminalStatuses}=buildRuntimeStatusRoleSets(definitions);const workflow=normalizedSchema.workflow;const openStatus=normalizeStatusId(workflow.open_status)??preferredStatusForRole(definitions,"default_open",["open","in_progress",STATUS_VALUES[0]]);const inProgressStatus=normalizeStatusId(workflow.in_progress_status)??preferredStatusForRole(definitions,"active",["in_progress","in-progress",openStatus],true);const blockedStatus=normalizeStatusId(workflow.blocked_status)??preferredStatusForRole(definitions,"blocked",["blocked"]);const closeStatus=normalizeStatusId(workflow.close_status)??preferredStatusForRole(definitions,"default_close",["closed","done","complete"]);const canceledStatus=normalizeStatusId(workflow.canceled_status)??preferredStatusForRole(definitions,"default_cancel",["canceled","cancelled"]);return{definitions,by_id:byId,alias_to_id:aliasToId,terminal_statuses:terminalStatuses,terminal_done_statuses:terminalDoneStatuses,terminal_canceled_statuses:terminalCanceledStatuses,active_statuses:activeStatuses,blocked_statuses:blockedStatuses,draft_statuses:draftStatuses,open_status:openStatus,in_progress_status:inProgressStatus,blocked_status:blockedStatus,close_status:closeStatus,canceled_status:canceledStatus}}function normalizeStatusInputWithRegistry(value,registry){const normalized=normalizeStatusToken(value);if(!normalized){return void 0}return registry.alias_to_id.get(normalized)}function resolveRuntimeFieldRegistry(schema){const normalizedSchema=normalizeRuntimeSchemaSettings(schema);const dedupedByKey=new Map;const normalizedFields=normalizedSchema.fields.map(definition=>normalizeRuntimeFieldDefinition(definition)).filter(definition=>definition!==null);for(const normalized of normalizedFields){dedupedByKey.set(normalized.key,normalized)}const definitions=[...dedupedByKey.values()].sort((left,right)=>left.key.localeCompare(right.key));const byKey=new Map;const byCliToken=new Map;const commandToFields=new Map;for(const definition of definitions){byKey.set(definition.key,definition);byCliToken.set(definition.cli_flag,definition);for(const alias of definition.cli_aliases){byCliToken.set(alias,definition)}for(const command of definition.commands){const existing=commandToFields.get(command)??[];existing.push(definition);commandToFields.set(command,existing)}}for(const[command,fieldDefinitions]of commandToFields.entries()){fieldDefinitions.sort((left,right)=>left.key.localeCompare(right.key));commandToFields.set(command,fieldDefinitions)}return{definitions,by_key:byKey,by_cli_token:byCliToken,command_to_fields:commandToFields}}function runtimeFieldOptionTarget(field){return toCamelCase(field.key)}function statusIsTerminal(status,registry){const normalized=normalizeStatusInputWithRegistry(status,registry);if(!normalized){return false}return registry.terminal_statuses.has(normalized)}export{DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,DEFAULT_RUNTIME_STATUS_DEFINITIONS,DEFAULT_RUNTIME_WORKFLOW,ensureRuntimeSchemaFileScaffold,filePathForSchemaSection,loadRuntimeSchemaFromOptionalFiles,normalizeRuntimeSchemaSettings,normalizeStatusInputWithRegistry,resolveItemTypesFilePath,resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry,runtimeFieldOptionTarget,statusIsTerminal};
 //# sourceMappingURL=runtime-schema.js.map
-//# debugId=633ef301-42a3-5b73-a4ed-7af0e0e40371