@unbrained/pm-cli 2026.6.16 → 2026.6.17

package/dist/core/schema/fields-file.js

@@ -0,0 +1,317 @@
+
+!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]="01bca6b9-49d3-5785-9d18-8399a0aac293")}catch(e){}}();
+import { RUNTIME_FIELD_COMMAND_VALUES, RUNTIME_FIELD_TYPE_VALUES, } from "../../types/index.js";
+/**
+ * Pure logic for the `pm schema add-field` / `pm schema remove-field` commands
+ * and the `list-fields` / `show-field` inspectors. The CLI command file
+ * (schema.ts) owns IO/governance; everything testable and side-effect-free lives
+ * here so it can be coverage-gated to 100%.
+ *
+ * Custom fields persist at `.agents/pm/schema/fields.json` under the shape
+ * `{ fields: RuntimeFieldDefinition[] }`. The runtime merge layer
+ * (loadRuntimeSchemaFromOptionalFiles) reads that file and dynamically registers
+ * a CLI flag per field on create/update/list/search/context, so this module only
+ * has to manage the persisted entries; it never duplicates the registration.
+ */
+const RUNTIME_FIELD_TYPE_SET = new Set(RUNTIME_FIELD_TYPE_VALUES);
+const RUNTIME_FIELD_COMMAND_SET = new Set(RUNTIME_FIELD_COMMAND_VALUES);
+/**
+ * Built-in front-matter field names a custom field key must never shadow. A
+ * custom key that collides with one of these would let `pm create --<key>` write
+ * over reserved metadata, so add-field rejects them up front (symmetric with the
+ * built-in-type guard in item-types-file.ts).
+ */
+export const BUILTIN_FIELD_KEYS = new Set([
+    "id",
+    "title",
+    "type",
+    "status",
+    "priority",
+    "tags",
+    "assignee",
+    "parent",
+    "description",
+    "body",
+    "created_at",
+    "updated_at",
+    "closed_at",
+    "author",
+    "deadline",
+    "estimate",
+    "sprint",
+    "release",
+    "risk",
+    "confidence",
+    "reviewer",
+    "resolution",
+    "expected",
+    "actual",
+]);
+/**
+ * The default commands a field is wired onto when `--commands` is omitted,
+ * matching the runtime default in runtime-schema.ts (normalizeRuntimeFieldDefinition).
+ */
+const DEFAULT_FIELD_COMMANDS = ["create", "update"];
+/**
+ * Normalizes a field key using the same rule as runtime-schema.ts: lowercase and
+ * collapse any run of whitespace/hyphens into a single underscore.
+ */
+export function normalizeFieldKey(value) {
+    return typeof value === "string" ? value.trim().toLowerCase().replaceAll(/[\s-]+/g, "_") : "";
+}
+/**
+ * Normalizes a CLI flag token: strip a leading `--`, lowercase, and collapse
+ * whitespace/underscore runs to a single hyphen (matches normalizeCliToken in
+ * runtime-schema.ts).
+ */
+function normalizeCliToken(value) {
+    if (typeof value !== "string") {
+        return "";
+    }
+    const collapsed = value.trim().toLowerCase().replaceAll(/[\s_]+/g, "-");
+    return collapsed.startsWith("--") ? collapsed.slice(2) : collapsed;
+}
+function keyToDefaultCliFlag(key) {
+    return key.replaceAll("_", "-");
+}
+function dedupeCliTokens(values, exclude) {
+    const seen = new Set();
+    for (const value of values) {
+        const token = normalizeCliToken(value);
+        if (token.length > 0 && token !== exclude) {
+            seen.add(token);
+        }
+    }
+    return [...seen].sort((left, right) => left.localeCompare(right));
+}
+function dedupeStringList(values) {
+    const seen = new Set();
+    for (const value of values ?? []) {
+        const trimmed = value.trim();
+        if (trimmed.length > 0) {
+            seen.add(trimmed);
+        }
+    }
+    return [...seen].sort((left, right) => left.localeCompare(right));
+}
+/**
+ * Validates and normalizes raw add-field CLI input. Throws a plain Error with a
+ * stable message when the key is missing/empty, collides with a built-in field,
+ * or carries an invalid type/command; the CLI layer maps these to PmCliError
+ * exit codes. A `string_array` type implies a repeatable field downstream
+ * (runtime-schema.ts derives `repeatable`), so no separate repeatable flag is
+ * exposed.
+ */
+export function normalizeAddFieldInput(raw) {
+    const key = normalizeFieldKey(raw.key);
+    if (key.length === 0) {
+        throw new Error("Field key must not be empty.");
+    }
+    if (BUILTIN_FIELD_KEYS.has(key)) {
+        throw new Error(`Cannot define custom field "${key}": it shadows a built-in field. Built-in fields are reserved.`);
+    }
+    const typeCandidate = typeof raw.type === "string" && raw.type.trim().length > 0 ? raw.type.trim().toLowerCase() : "string";
+    if (!RUNTIME_FIELD_TYPE_SET.has(typeCandidate)) {
+        throw new Error(`Invalid field type "${raw.type}". Allowed: ${RUNTIME_FIELD_TYPE_VALUES.join(", ")}.`);
+    }
+    const type = typeCandidate;
+    let commands;
+    if (raw.commands === undefined) {
+        commands = [...DEFAULT_FIELD_COMMANDS];
+    }
+    else {
+        const seen = new Set();
+        const normalized = [];
+        for (const rawCommand of raw.commands) {
+            const command = rawCommand.trim().toLowerCase();
+            if (command.length === 0) {
+                continue;
+            }
+            if (!RUNTIME_FIELD_COMMAND_SET.has(command)) {
+                throw new Error(`Invalid field command "${rawCommand}". Allowed: ${RUNTIME_FIELD_COMMAND_VALUES.join(", ")}.`);
+            }
+            if (!seen.has(command)) {
+                seen.add(command);
+                normalized.push(command);
+            }
+        }
+        commands = normalized.length > 0 ? normalized : [...DEFAULT_FIELD_COMMANDS];
+    }
+    const cliFlagToken = normalizeCliToken(raw.cliFlag);
+    const cliFlag = cliFlagToken.length > 0 && cliFlagToken !== keyToDefaultCliFlag(key) ? cliFlagToken : undefined;
+    const effectiveFlag = cliFlag ?? keyToDefaultCliFlag(key);
+    const cliAliases = dedupeCliTokens(raw.aliases ?? [], effectiveFlag);
+    const description = raw.description?.trim();
+    return {
+        key,
+        type,
+        commands,
+        description: description && description.length > 0 ? description : undefined,
+        cliFlag,
+        cliAliases,
+        required: raw.required === true,
+        requiredOnCreate: raw.requiredOnCreate === true,
+        // allow_unset defaults to true (omitted) and is only persisted when an
+        // operator explicitly disables it with --no-allow-unset (allowUnset === false).
+        allowUnset: raw.allowUnset !== false,
+        requiredTypes: dedupeStringList(raw.requiredTypes),
+    };
+}
+function selectFieldsArray(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 extractFieldDefinitions(parsed) {
+    const candidate = selectFieldsArray(parsed);
+    if (!candidate) {
+        return [];
+    }
+    const definitions = [];
+    for (const entry of candidate) {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            continue;
+        }
+        const record = entry;
+        if (typeof record.key !== "string" || record.key.trim().length === 0) {
+            continue;
+        }
+        definitions.push(record);
+    }
+    return definitions;
+}
+/**
+ * Coerces an arbitrary parsed value from fields.json into a FieldsFile. Accepts
+ * the canonical `{ fields: [...] }` shape, a bare array, or a `{ definitions: [...] }`
+ * form, and tolerates a missing/invalid file by returning an empty fields list.
+ */
+export function parseFieldsFile(raw) {
+    if (raw === null || raw === undefined || raw.trim().length === 0) {
+        return { fields: [] };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error("schema/fields.json contains invalid JSON.");
+    }
+    return { fields: extractFieldDefinitions(parsed) };
+}
+/**
+ * Serializes the fields file with a trailing newline (matches the rest of the
+ * schema scaffold files written by pm).
+ */
+export function serializeFieldsFile(file) {
+    return `${JSON.stringify({ fields: file.fields }, null, 2)}\n`;
+}
+/**
+ * Idempotent UPSERT of a custom field into the parsed file. Matching is by
+ * normalized key. When a definition already exists, the supplied input fully
+ * replaces its add-field-managed attributes (type/commands/description/flags/
+ * required flags) while preserving any unrelated keys the file may carry; any
+ * `metadata_key` already stored is preserved so existing item data keeps mapping
+ * to the same front-matter column.
+ */
+export function upsertField(file, input) {
+    // Match by normalized key. A hand-authored file may carry more than one entry
+    // for the same key, so drop ALL matches and re-insert a single merged result
+    // (collapsing duplicates) rather than only rewriting the first occurrence. The
+    // first existing match seeds preserved attributes (e.g. metadata_key).
+    const existing = file.fields.find((definition) => normalizeFieldKey(definition.key) === input.key);
+    const replaced = existing !== undefined;
+    const fields = file.fields.filter((definition) => normalizeFieldKey(definition.key) !== input.key);
+    const next = {
+        ...(existing ?? {}),
+        key: input.key,
+        type: input.type,
+        commands: [...input.commands],
+    };
+    applyOptionalString(next, "description", input.description);
+    applyOptionalString(next, "cli_flag", input.cliFlag);
+    if (input.cliAliases.length > 0) {
+        next.cli_aliases = [...input.cliAliases];
+    }
+    else {
+        delete next.cli_aliases;
+    }
+    applyBooleanFlag(next, "required", input.required);
+    applyBooleanFlag(next, "required_on_create", input.requiredOnCreate);
+    // allow_unset defaults true; only persist the explicit false override.
+    if (input.allowUnset === false) {
+        next.allow_unset = false;
+    }
+    else {
+        delete next.allow_unset;
+    }
+    if (input.requiredTypes.length > 0) {
+        next.required_types = [...input.requiredTypes];
+    }
+    else {
+        delete next.required_types;
+    }
+    fields.push(next);
+    fields.sort((left, right) => normalizeFieldKey(left.key).localeCompare(normalizeFieldKey(right.key)));
+    return {
+        file: { fields },
+        definition: next,
+        replaced,
+    };
+}
+/**
+ * Removes a custom field definition from the parsed file by key (normalized).
+ * Throws a plain Error when `key` is empty. Returns `removed: false` when no
+ * matching definition exists so the CLI layer can treat the call as an
+ * idempotent no-op.
+ */
+export function removeField(file, key) {
+    const normalizedKey = normalizeFieldKey(key);
+    if (normalizedKey.length === 0) {
+        throw new Error("Field key must not be empty.");
+    }
+    // Remove ALL matches (a hand-authored file may carry duplicate entries for the
+    // same normalized key) so no stale duplicate survives the removal.
+    const removed = [];
+    const fields = file.fields.filter((definition) => {
+        if (normalizeFieldKey(definition.key) === normalizedKey) {
+            removed.push(definition);
+            return false;
+        }
+        return true;
+    });
+    if (removed.length === 0) {
+        return { file: { fields }, removed: false };
+    }
+    return { file: { fields }, removed: true, definition: removed[0] };
+}
+function applyOptionalString(definition, key, value) {
+    const record = definition;
+    if (value !== undefined && value.length > 0) {
+        record[key] = value;
+    }
+    else {
+        delete record[key];
+    }
+}
+function applyBooleanFlag(definition, key, value) {
+    const record = definition;
+    if (value) {
+        record[key] = true;
+    }
+    else {
+        delete record[key];
+    }
+}
+//# sourceMappingURL=fields-file.js.map
+//# debugId=01bca6b9-49d3-5785-9d18-8399a0aac293

package/dist/core/schema/fields-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-file.js","sources":["core/schema/fields-file.ts"],"sourceRoot":"/","sourcesContent":["import {\n  RUNTIME_FIELD_COMMAND_VALUES,\n  RUNTIME_FIELD_TYPE_VALUES,\n} from \"../../types/index.js\";\nimport type { RuntimeFieldCommand, RuntimeFieldDefinition, RuntimeFieldType } from \"../../types/index.js\";\n\nexport type { RuntimeFieldCommand, RuntimeFieldDefinition, RuntimeFieldType } from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-field` / `pm schema remove-field` commands\n * and the `list-fields` / `show-field` inspectors. The CLI command file\n * (schema.ts) owns IO/governance; everything testable and side-effect-free lives\n * here so it can be coverage-gated to 100%.\n *\n * Custom fields persist at `.agents/pm/schema/fields.json` under the shape\n * `{ fields: RuntimeFieldDefinition[] }`. The runtime merge layer\n * (loadRuntimeSchemaFromOptionalFiles) reads that file and dynamically registers\n * a CLI flag per field on create/update/list/search/context, so this module only\n * has to manage the persisted entries; it never duplicates the registration.\n */\n\nconst RUNTIME_FIELD_TYPE_SET = new Set<string>(RUNTIME_FIELD_TYPE_VALUES);\nconst RUNTIME_FIELD_COMMAND_SET = new Set<string>(RUNTIME_FIELD_COMMAND_VALUES);\n\n/**\n * Built-in front-matter field names a custom field key must never shadow. A\n * custom key that collides with one of these would let `pm create --<key>` write\n * over reserved metadata, so add-field rejects them up front (symmetric with the\n * built-in-type guard in item-types-file.ts).\n */\nexport const BUILTIN_FIELD_KEYS: ReadonlySet<string> = new Set([\n  \"id\",\n  \"title\",\n  \"type\",\n  \"status\",\n  \"priority\",\n  \"tags\",\n  \"assignee\",\n  \"parent\",\n  \"description\",\n  \"body\",\n  \"created_at\",\n  \"updated_at\",\n  \"closed_at\",\n  \"author\",\n  \"deadline\",\n  \"estimate\",\n  \"sprint\",\n  \"release\",\n  \"risk\",\n  \"confidence\",\n  \"reviewer\",\n  \"resolution\",\n  \"expected\",\n  \"actual\",\n]);\n\n/**\n * The default commands a field is wired onto when `--commands` is omitted,\n * matching the runtime default in runtime-schema.ts (normalizeRuntimeFieldDefinition).\n */\nconst DEFAULT_FIELD_COMMANDS: RuntimeFieldCommand[] = [\"create\", \"update\"];\n\n/**\n * The shape persisted at `.agents/pm/schema/fields.json`.\n */\nexport interface FieldsFile {\n  fields: RuntimeFieldDefinition[];\n}\n\nexport interface RawAddFieldInput {\n  key: string | undefined;\n  type?: string;\n  commands?: string[];\n  description?: string;\n  cliFlag?: string;\n  aliases?: string[];\n  required?: boolean;\n  requiredOnCreate?: boolean;\n  allowUnset?: boolean;\n  requiredTypes?: string[];\n}\n\nexport interface NormalizedAddFieldInput {\n  key: string;\n  type: RuntimeFieldType;\n  commands: RuntimeFieldCommand[];\n  description?: string;\n  cliFlag?: string;\n  cliAliases: string[];\n  required: boolean;\n  requiredOnCreate: boolean;\n  allowUnset: boolean;\n  requiredTypes: string[];\n}\n\nexport interface UpsertFieldResult {\n  file: FieldsFile;\n  /** The definition as stored after the upsert. */\n  definition: RuntimeFieldDefinition;\n  /** True when an existing definition with the same (normalized) key was replaced. */\n  replaced: boolean;\n}\n\nexport interface RemoveFieldResult {\n  file: FieldsFile;\n  /** True when a matching definition existed and was dropped from the file. */\n  removed: boolean;\n  /** The removed definition, when one matched the requested key. */\n  definition?: RuntimeFieldDefinition;\n}\n\n/**\n * Normalizes a field key using the same rule as runtime-schema.ts: lowercase and\n * collapse any run of whitespace/hyphens into a single underscore.\n */\nexport function normalizeFieldKey(value: unknown): string {\n  return typeof value === \"string\" ? value.trim().toLowerCase().replaceAll(/[\\s-]+/g, \"_\") : \"\";\n}\n\n/**\n * Normalizes a CLI flag token: strip a leading `--`, lowercase, and collapse\n * whitespace/underscore runs to a single hyphen (matches normalizeCliToken in\n * runtime-schema.ts).\n */\nfunction normalizeCliToken(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return \"\";\n  }\n  const collapsed = value.trim().toLowerCase().replaceAll(/[\\s_]+/g, \"-\");\n  return collapsed.startsWith(\"--\") ? collapsed.slice(2) : collapsed;\n}\n\nfunction keyToDefaultCliFlag(key: string): string {\n  return key.replaceAll(\"_\", \"-\");\n}\n\nfunction dedupeCliTokens(values: Iterable<string>, exclude: string): string[] {\n  const seen = new Set<string>();\n  for (const value of values) {\n    const token = normalizeCliToken(value);\n    if (token.length > 0 && token !== exclude) {\n      seen.add(token);\n    }\n  }\n  return [...seen].sort((left, right) => left.localeCompare(right));\n}\n\nfunction dedupeStringList(values: string[] | undefined): string[] {\n  const seen = new Set<string>();\n  for (const value of values ?? []) {\n    const trimmed = value.trim();\n    if (trimmed.length > 0) {\n      seen.add(trimmed);\n    }\n  }\n  return [...seen].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Validates and normalizes raw add-field CLI input. Throws a plain Error with a\n * stable message when the key is missing/empty, collides with a built-in field,\n * or carries an invalid type/command; the CLI layer maps these to PmCliError\n * exit codes. A `string_array` type implies a repeatable field downstream\n * (runtime-schema.ts derives `repeatable`), so no separate repeatable flag is\n * exposed.\n */\nexport function normalizeAddFieldInput(raw: RawAddFieldInput): NormalizedAddFieldInput {\n  const key = normalizeFieldKey(raw.key);\n  if (key.length === 0) {\n    throw new Error(\"Field key must not be empty.\");\n  }\n  if (BUILTIN_FIELD_KEYS.has(key)) {\n    throw new Error(\n      `Cannot define custom field \"${key}\": it shadows a built-in field. Built-in fields are reserved.`,\n    );\n  }\n\n  const typeCandidate = typeof raw.type === \"string\" && raw.type.trim().length > 0 ? raw.type.trim().toLowerCase() : \"string\";\n  if (!RUNTIME_FIELD_TYPE_SET.has(typeCandidate)) {\n    throw new Error(`Invalid field type \"${raw.type}\". Allowed: ${RUNTIME_FIELD_TYPE_VALUES.join(\", \")}.`);\n  }\n  const type = typeCandidate as RuntimeFieldType;\n\n  let commands: RuntimeFieldCommand[];\n  if (raw.commands === undefined) {\n    commands = [...DEFAULT_FIELD_COMMANDS];\n  } else {\n    const seen = new Set<string>();\n    const normalized: RuntimeFieldCommand[] = [];\n    for (const rawCommand of raw.commands) {\n      const command = rawCommand.trim().toLowerCase();\n      if (command.length === 0) {\n        continue;\n      }\n      if (!RUNTIME_FIELD_COMMAND_SET.has(command)) {\n        throw new Error(`Invalid field command \"${rawCommand}\". Allowed: ${RUNTIME_FIELD_COMMAND_VALUES.join(\", \")}.`);\n      }\n      if (!seen.has(command)) {\n        seen.add(command);\n        normalized.push(command as RuntimeFieldCommand);\n      }\n    }\n    commands = normalized.length > 0 ? normalized : [...DEFAULT_FIELD_COMMANDS];\n  }\n\n  const cliFlagToken = normalizeCliToken(raw.cliFlag);\n  const cliFlag = cliFlagToken.length > 0 && cliFlagToken !== keyToDefaultCliFlag(key) ? cliFlagToken : undefined;\n  const effectiveFlag = cliFlag ?? keyToDefaultCliFlag(key);\n  const cliAliases = dedupeCliTokens(raw.aliases ?? [], effectiveFlag);\n\n  const description = raw.description?.trim();\n  return {\n    key,\n    type,\n    commands,\n    description: description && description.length > 0 ? description : undefined,\n    cliFlag,\n    cliAliases,\n    required: raw.required === true,\n    requiredOnCreate: raw.requiredOnCreate === true,\n    // allow_unset defaults to true (omitted) and is only persisted when an\n    // operator explicitly disables it with --no-allow-unset (allowUnset === false).\n    allowUnset: raw.allowUnset !== false,\n    requiredTypes: dedupeStringList(raw.requiredTypes),\n  };\n}\n\nfunction selectFieldsArray(parsed: unknown): unknown[] | undefined {\n  if (Array.isArray(parsed)) {\n    return parsed;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return undefined;\n  }\n  const record = parsed as Record<string, unknown>;\n  if (Array.isArray(record.fields)) {\n    return record.fields;\n  }\n  if (Array.isArray(record.definitions)) {\n    return record.definitions;\n  }\n  return undefined;\n}\n\nfunction extractFieldDefinitions(parsed: unknown): RuntimeFieldDefinition[] {\n  const candidate = selectFieldsArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: RuntimeFieldDefinition[] = [];\n  for (const entry of candidate) {\n    if (typeof entry !== \"object\" || entry === null || Array.isArray(entry)) {\n      continue;\n    }\n    const record = entry as Record<string, unknown>;\n    if (typeof record.key !== \"string\" || record.key.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as RuntimeFieldDefinition);\n  }\n  return definitions;\n}\n\n/**\n * Coerces an arbitrary parsed value from fields.json into a FieldsFile. Accepts\n * the canonical `{ fields: [...] }` shape, a bare array, or a `{ definitions: [...] }`\n * form, and tolerates a missing/invalid file by returning an empty fields list.\n */\nexport function parseFieldsFile(raw: string | null | undefined): FieldsFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { fields: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/fields.json contains invalid JSON.\");\n  }\n  return { fields: extractFieldDefinitions(parsed) };\n}\n\n/**\n * Serializes the fields file with a trailing newline (matches the rest of the\n * schema scaffold files written by pm).\n */\nexport function serializeFieldsFile(file: FieldsFile): string {\n  return `${JSON.stringify({ fields: file.fields }, null, 2)}\\n`;\n}\n\n/**\n * Idempotent UPSERT of a custom field into the parsed file. Matching is by\n * normalized key. When a definition already exists, the supplied input fully\n * replaces its add-field-managed attributes (type/commands/description/flags/\n * required flags) while preserving any unrelated keys the file may carry; any\n * `metadata_key` already stored is preserved so existing item data keeps mapping\n * to the same front-matter column.\n */\nexport function upsertField(file: FieldsFile, input: NormalizedAddFieldInput): UpsertFieldResult {\n  // Match by normalized key. A hand-authored file may carry more than one entry\n  // for the same key, so drop ALL matches and re-insert a single merged result\n  // (collapsing duplicates) rather than only rewriting the first occurrence. The\n  // first existing match seeds preserved attributes (e.g. metadata_key).\n  const existing = file.fields.find((definition) => normalizeFieldKey(definition.key) === input.key);\n  const replaced = existing !== undefined;\n  const fields = file.fields.filter((definition) => normalizeFieldKey(definition.key) !== input.key);\n\n  const next: RuntimeFieldDefinition = {\n    ...(existing ?? {}),\n    key: input.key,\n    type: input.type,\n    commands: [...input.commands],\n  };\n  applyOptionalString(next, \"description\", input.description);\n  applyOptionalString(next, \"cli_flag\", input.cliFlag);\n  if (input.cliAliases.length > 0) {\n    next.cli_aliases = [...input.cliAliases];\n  } else {\n    delete next.cli_aliases;\n  }\n  applyBooleanFlag(next, \"required\", input.required);\n  applyBooleanFlag(next, \"required_on_create\", input.requiredOnCreate);\n  // allow_unset defaults true; only persist the explicit false override.\n  if (input.allowUnset === false) {\n    next.allow_unset = false;\n  } else {\n    delete next.allow_unset;\n  }\n  if (input.requiredTypes.length > 0) {\n    next.required_types = [...input.requiredTypes];\n  } else {\n    delete next.required_types;\n  }\n\n  fields.push(next);\n  fields.sort((left, right) => normalizeFieldKey(left.key).localeCompare(normalizeFieldKey(right.key)));\n\n  return {\n    file: { fields },\n    definition: next,\n    replaced,\n  };\n}\n\n/**\n * Removes a custom field definition from the parsed file by key (normalized).\n * Throws a plain Error when `key` is empty. Returns `removed: false` when no\n * matching definition exists so the CLI layer can treat the call as an\n * idempotent no-op.\n */\nexport function removeField(file: FieldsFile, key: string | undefined): RemoveFieldResult {\n  const normalizedKey = normalizeFieldKey(key);\n  if (normalizedKey.length === 0) {\n    throw new Error(\"Field key must not be empty.\");\n  }\n  // Remove ALL matches (a hand-authored file may carry duplicate entries for the\n  // same normalized key) so no stale duplicate survives the removal.\n  const removed: RuntimeFieldDefinition[] = [];\n  const fields = file.fields.filter((definition) => {\n    if (normalizeFieldKey(definition.key) === normalizedKey) {\n      removed.push(definition);\n      return false;\n    }\n    return true;\n  });\n  if (removed.length === 0) {\n    return { file: { fields }, removed: false };\n  }\n  return { file: { fields }, removed: true, definition: removed[0] };\n}\n\nfunction applyOptionalString(definition: RuntimeFieldDefinition, key: string, value: string | undefined): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value !== undefined && value.length > 0) {\n    record[key] = value;\n  } else {\n    delete record[key];\n  }\n}\n\nfunction applyBooleanFlag(definition: RuntimeFieldDefinition, key: string, value: boolean): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value) {\n    record[key] = true;\n  } else {\n    delete record[key];\n  }\n}\n"],"names":[],"mappings":"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","debugId":"01bca6b9-49d3-5785-9d18-8399a0aac293"}

package/dist/core/schema/type-inference.d.ts

@@ -0,0 +1,34 @@
+export interface InferredTypeCandidate {
+    /** Suggested PascalCase type name derived from the prefix. */
+    name: string;
+    /** The normalized prefix token (lowercase) the items share. */
+    prefix: string;
+    /** How many scanned titles carry this prefix. */
+    count: number;
+    /** A few example titles (capped) for human/agent review. */
+    examples: string[];
+    /** True when `name` already resolves to a reserved built-in type. */
+    shadows_builtin: boolean;
+}
+export interface InferTypesOptions {
+    /** Minimum number of titles that must share a prefix to surface it (default 10). */
+    minCount?: number;
+    /** Maximum example titles retained per candidate (default 3). */
+    maxExamples?: number;
+}
+/**
+ * Extracts the leading prefix token from a title, or undefined when the title has
+ * no stable letter-led `PREFIX-`/`PREFIX:` convention.
+ */
+export declare function extractTitlePrefix(title: string): string | undefined;
+/**
+ * Converts a normalized prefix token into a PascalCase type name. Internal
+ * hyphen/underscore runs become word boundaries; each word is capitalized.
+ */
+export declare function prefixToTypeName(prefix: string): string;
+/**
+ * Scans titles for shared prefix conventions and returns candidate custom types,
+ * sorted by descending frequency then name. Only prefixes carried by at least
+ * `minCount` titles are returned.
+ */
+export declare function inferTypesFromTitles(titles: string[], options?: InferTypesOptions): InferredTypeCandidate[];

package/dist/core/schema/type-inference.js

@@ -0,0 +1,97 @@
+
+!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]="7ded2b63-46ff-5a7e-a47f-5a4488da1cae")}catch(e){}}();
+import { matchBuiltinTypeName } from "./item-types-file.js";
+/**
+ * Pure logic for `pm schema add-type --infer`: scan existing item titles for
+ * stable `PREFIX-`/`PREFIX:` conventions and propose them as custom item types.
+ * The CLI command file (schema.ts) owns IO and the optional registration; this
+ * module only derives candidates from a list of titles so it is fully testable
+ * and coverage-gated to 100%.
+ *
+ * Conventions recognized (case-insensitive, first run wins per title):
+ *  - `INFRA- ...`  / `SECURITY-...`  (hyphen-delimited prefix)
+ *  - `BUG: ...`    / `SPIKE: ...`    (colon-delimited prefix)
+ * The prefix token must be a letter-led identifier of letters, digits, and
+ * internal hyphens/underscores so it maps cleanly to a single PascalCase type
+ * name. Purely numeric or sequence-style prefixes (e.g. `S001-`, `E12-`) are
+ * intentionally skipped: they index items, they are not type boundaries.
+ */
+const PREFIX_PATTERN = /^([A-Za-z][A-Za-z0-9_-]*?)\s*[-:]\s+\S/;
+/**
+ * Extracts the leading prefix token from a title, or undefined when the title has
+ * no stable letter-led `PREFIX-`/`PREFIX:` convention.
+ */
+export function extractTitlePrefix(title) {
+    const match = PREFIX_PATTERN.exec(title.trim());
+    if (!match) {
+        return undefined;
+    }
+    const token = match[1];
+    // Reject single-character prefixes (e.g. "S-", "E-"): they are sequence/index
+    // markers far more often than genuine type boundaries.
+    if (token.length < 2) {
+        return undefined;
+    }
+    // Reject sequence/index-style prefixes — a single leading letter followed by
+    // only digits (e.g. "S001-", "E12-", "V1-"). These index items rather than
+    // mark a type boundary, matching the convention documented above.
+    if (/^[A-Za-z]\d+$/.test(token)) {
+        return undefined;
+    }
+    return token.toLowerCase();
+}
+/**
+ * Converts a normalized prefix token into a PascalCase type name. Internal
+ * hyphen/underscore runs become word boundaries; each word is capitalized.
+ */
+export function prefixToTypeName(prefix) {
+    return prefix
+        .split(/[-_]+/)
+        .filter((segment) => segment.length > 0)
+        .map((segment) => `${segment.slice(0, 1).toUpperCase()}${segment.slice(1).toLowerCase()}`)
+        .join("");
+}
+/**
+ * Scans titles for shared prefix conventions and returns candidate custom types,
+ * sorted by descending frequency then name. Only prefixes carried by at least
+ * `minCount` titles are returned.
+ */
+export function inferTypesFromTitles(titles, options = {}) {
+    const minCount = typeof options.minCount === "number" && options.minCount > 0 ? Math.trunc(options.minCount) : 10;
+    const maxExamples = typeof options.maxExamples === "number" && options.maxExamples > 0 ? Math.trunc(options.maxExamples) : 3;
+    const byPrefix = new Map();
+    for (const rawTitle of titles) {
+        const title = typeof rawTitle === "string" ? rawTitle.trim() : "";
+        if (title.length === 0) {
+            continue;
+        }
+        const prefix = extractTitlePrefix(title);
+        if (prefix === undefined) {
+            continue;
+        }
+        const bucket = byPrefix.get(prefix) ?? { count: 0, examples: [] };
+        bucket.count += 1;
+        if (bucket.examples.length < maxExamples) {
+            bucket.examples.push(title);
+        }
+        byPrefix.set(prefix, bucket);
+    }
+    const candidates = [];
+    for (const [prefix, bucket] of byPrefix.entries()) {
+        if (bucket.count < minCount) {
+            continue;
+        }
+        const name = prefixToTypeName(prefix);
+        candidates.push({
+            name,
+            prefix,
+            count: bucket.count,
+            examples: bucket.examples,
+            shadows_builtin: matchBuiltinTypeName(name) !== undefined,
+        });
+    }
+    candidates.sort((left, right) => (right.count - left.count) || left.name.localeCompare(right.name));
+    return candidates;
+}
+//# sourceMappingURL=type-inference.js.map
+//# debugId=7ded2b63-46ff-5a7e-a47f-5a4488da1cae

package/dist/core/schema/type-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-inference.js","sources":["core/schema/type-inference.ts"],"sourceRoot":"/","sourcesContent":["import { matchBuiltinTypeName } from \"./item-types-file.js\";\n\n/**\n * Pure logic for `pm schema add-type --infer`: scan existing item titles for\n * stable `PREFIX-`/`PREFIX:` conventions and propose them as custom item types.\n * The CLI command file (schema.ts) owns IO and the optional registration; this\n * module only derives candidates from a list of titles so it is fully testable\n * and coverage-gated to 100%.\n *\n * Conventions recognized (case-insensitive, first run wins per title):\n *  - `INFRA- ...`  / `SECURITY-...`  (hyphen-delimited prefix)\n *  - `BUG: ...`    / `SPIKE: ...`    (colon-delimited prefix)\n * The prefix token must be a letter-led identifier of letters, digits, and\n * internal hyphens/underscores so it maps cleanly to a single PascalCase type\n * name. Purely numeric or sequence-style prefixes (e.g. `S001-`, `E12-`) are\n * intentionally skipped: they index items, they are not type boundaries.\n */\n\nconst PREFIX_PATTERN = /^([A-Za-z][A-Za-z0-9_-]*?)\\s*[-:]\\s+\\S/;\n\nexport interface InferredTypeCandidate {\n  /** Suggested PascalCase type name derived from the prefix. */\n  name: string;\n  /** The normalized prefix token (lowercase) the items share. */\n  prefix: string;\n  /** How many scanned titles carry this prefix. */\n  count: number;\n  /** A few example titles (capped) for human/agent review. */\n  examples: string[];\n  /** True when `name` already resolves to a reserved built-in type. */\n  shadows_builtin: boolean;\n}\n\nexport interface InferTypesOptions {\n  /** Minimum number of titles that must share a prefix to surface it (default 10). */\n  minCount?: number;\n  /** Maximum example titles retained per candidate (default 3). */\n  maxExamples?: number;\n}\n\n/**\n * Extracts the leading prefix token from a title, or undefined when the title has\n * no stable letter-led `PREFIX-`/`PREFIX:` convention.\n */\nexport function extractTitlePrefix(title: string): string | undefined {\n  const match = PREFIX_PATTERN.exec(title.trim());\n  if (!match) {\n    return undefined;\n  }\n  const token = match[1];\n  // Reject single-character prefixes (e.g. \"S-\", \"E-\"): they are sequence/index\n  // markers far more often than genuine type boundaries.\n  if (token.length < 2) {\n    return undefined;\n  }\n  // Reject sequence/index-style prefixes — a single leading letter followed by\n  // only digits (e.g. \"S001-\", \"E12-\", \"V1-\"). These index items rather than\n  // mark a type boundary, matching the convention documented above.\n  if (/^[A-Za-z]\\d+$/.test(token)) {\n    return undefined;\n  }\n  return token.toLowerCase();\n}\n\n/**\n * Converts a normalized prefix token into a PascalCase type name. Internal\n * hyphen/underscore runs become word boundaries; each word is capitalized.\n */\nexport function prefixToTypeName(prefix: string): string {\n  return prefix\n    .split(/[-_]+/)\n    .filter((segment) => segment.length > 0)\n    .map((segment) => `${segment.slice(0, 1).toUpperCase()}${segment.slice(1).toLowerCase()}`)\n    .join(\"\");\n}\n\n/**\n * Scans titles for shared prefix conventions and returns candidate custom types,\n * sorted by descending frequency then name. Only prefixes carried by at least\n * `minCount` titles are returned.\n */\nexport function inferTypesFromTitles(titles: string[], options: InferTypesOptions = {}): InferredTypeCandidate[] {\n  const minCount = typeof options.minCount === \"number\" && options.minCount > 0 ? Math.trunc(options.minCount) : 10;\n  const maxExamples = typeof options.maxExamples === \"number\" && options.maxExamples > 0 ? Math.trunc(options.maxExamples) : 3;\n  const byPrefix = new Map<string, { count: number; examples: string[] }>();\n  for (const rawTitle of titles) {\n    const title = typeof rawTitle === \"string\" ? rawTitle.trim() : \"\";\n    if (title.length === 0) {\n      continue;\n    }\n    const prefix = extractTitlePrefix(title);\n    if (prefix === undefined) {\n      continue;\n    }\n    const bucket = byPrefix.get(prefix) ?? { count: 0, examples: [] };\n    bucket.count += 1;\n    if (bucket.examples.length < maxExamples) {\n      bucket.examples.push(title);\n    }\n    byPrefix.set(prefix, bucket);\n  }\n  const candidates: InferredTypeCandidate[] = [];\n  for (const [prefix, bucket] of byPrefix.entries()) {\n    if (bucket.count < minCount) {\n      continue;\n    }\n    const name = prefixToTypeName(prefix);\n    candidates.push({\n      name,\n      prefix,\n      count: bucket.count,\n      examples: bucket.examples,\n      shadows_builtin: matchBuiltinTypeName(name) !== undefined,\n    });\n  }\n  candidates.sort((left, right) => (right.count - left.count) || left.name.localeCompare(right.name));\n  return candidates;\n}\n"],"names":[],"mappings":"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","debugId":"7ded2b63-46ff-5a7e-a47f-5a4488da1cae"}

package/dist/core/schema/type-presets.d.ts

@@ -0,0 +1,30 @@
+import { type NormalizedAddTypeInput, type RawAddTypeInput } from "./item-types-file.js";
+/**
+ * Shared domain item-type presets. These power both `pm init --type-preset`
+ * (registered during initialization) and the standalone `pm schema apply-preset`
+ * subcommand (adopting a preset into an already-initialized project). Keeping the
+ * raw definitions and the preset-name normalizer in one place guarantees init and
+ * schema register byte-identical types.
+ */
+export declare const TYPE_PRESET_NAMES: readonly ["agile", "ops", "research"];
+export type TypePresetName = (typeof TYPE_PRESET_NAMES)[number];
+/**
+ * Raw (pre-normalization) preset definitions keyed by preset name. Each entry is
+ * fed through {@link normalizeAddTypeInput} before being upserted so the same
+ * validation/normalization the `pm schema add-type` CLI applies governs preset
+ * registration too.
+ */
+export declare const TYPE_PRESET_DEFINITIONS: Record<TypePresetName, RawAddTypeInput[]>;
+/**
+ * Validates and normalizes a raw preset-name CLI value. Returns `undefined` when
+ * the value is omitted (no preset requested). Throws a plain Error with a stable
+ * message for an empty or unknown preset; CLI layers map it to a USAGE exit code.
+ * Accepts hyphen/underscore-insensitive casing for ergonomics.
+ */
+export declare function normalizeTypePresetName(rawValue: string | undefined): TypePresetName | undefined;
+/**
+ * Returns the normalized add-type inputs for a preset, in the order they should
+ * be upserted. Each raw definition is run through normalizeAddTypeInput so callers
+ * get the same validated shape as an individual `add-type` invocation.
+ */
+export declare function resolveTypePresetDefinitions(preset: TypePresetName): NormalizedAddTypeInput[];

package/dist/core/schema/type-presets.js

@@ -0,0 +1,96 @@
+
+!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]="435e9450-a234-54ff-b34e-a992acb16c4e")}catch(e){}}();
+import { normalizeAddTypeInput } from "./item-types-file.js";
+/**
+ * Shared domain item-type presets. These power both `pm init --type-preset`
+ * (registered during initialization) and the standalone `pm schema apply-preset`
+ * subcommand (adopting a preset into an already-initialized project). Keeping the
+ * raw definitions and the preset-name normalizer in one place guarantees init and
+ * schema register byte-identical types.
+ */
+export const TYPE_PRESET_NAMES = ["agile", "ops", "research"];
+/**
+ * Raw (pre-normalization) preset definitions keyed by preset name. Each entry is
+ * fed through {@link normalizeAddTypeInput} before being upserted so the same
+ * validation/normalization the `pm schema add-type` CLI applies governs preset
+ * registration too.
+ */
+export const TYPE_PRESET_DEFINITIONS = {
+    agile: [
+        {
+            name: "Story",
+            description: "User-facing outcome or capability slice expressed from a stakeholder perspective.",
+            defaultStatus: "open",
+            folder: "stories",
+            aliases: ["user-story"],
+        },
+        {
+            name: "Spike",
+            description: "Time-boxed investigation used to reduce uncertainty before implementation.",
+            defaultStatus: "open",
+            folder: "spikes",
+            aliases: ["research-spike"],
+        },
+    ],
+    ops: [
+        {
+            name: "Incident",
+            description: "Operational disruption, degradation, or support escalation with recovery tracking.",
+            defaultStatus: "open",
+            folder: "incidents",
+            aliases: ["outage"],
+        },
+        {
+            name: "Runbook",
+            description: "Repeatable operational procedure, diagnostic path, or response playbook.",
+            defaultStatus: "open",
+            folder: "runbooks",
+            aliases: ["playbook"],
+        },
+    ],
+    research: [
+        {
+            name: "Experiment",
+            description: "Validated-learning activity with hypothesis, method, and outcome tracking.",
+            defaultStatus: "open",
+            folder: "experiments",
+            aliases: ["study"],
+        },
+        {
+            name: "Hypothesis",
+            description: "Testable claim or assumption that should be supported, rejected, or refined.",
+            defaultStatus: "open",
+            folder: "hypotheses",
+            aliases: ["assumption"],
+        },
+    ],
+};
+/**
+ * Validates and normalizes a raw preset-name CLI value. Returns `undefined` when
+ * the value is omitted (no preset requested). Throws a plain Error with a stable
+ * message for an empty or unknown preset; CLI layers map it to a USAGE exit code.
+ * Accepts hyphen/underscore-insensitive casing for ergonomics.
+ */
+export function normalizeTypePresetName(rawValue) {
+    if (rawValue === undefined) {
+        return undefined;
+    }
+    const normalized = rawValue.trim().toLowerCase().replaceAll("-", "_");
+    if (normalized.length === 0) {
+        throw new Error("Type preset name must not be empty.");
+    }
+    if (normalized === "agile" || normalized === "ops" || normalized === "research") {
+        return normalized;
+    }
+    throw new Error(`Invalid type preset "${rawValue}". Allowed: ${TYPE_PRESET_NAMES.join(", ")}.`);
+}
+/**
+ * Returns the normalized add-type inputs for a preset, in the order they should
+ * be upserted. Each raw definition is run through normalizeAddTypeInput so callers
+ * get the same validated shape as an individual `add-type` invocation.
+ */
+export function resolveTypePresetDefinitions(preset) {
+    return TYPE_PRESET_DEFINITIONS[preset].map((rawDefinition) => normalizeAddTypeInput(rawDefinition));
+}
+//# sourceMappingURL=type-presets.js.map
+//# debugId=435e9450-a234-54ff-b34e-a992acb16c4e

package/dist/core/schema/type-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-presets.js","sources":["core/schema/type-presets.ts"],"sourceRoot":"/","sourcesContent":["import { normalizeAddTypeInput, type NormalizedAddTypeInput, type RawAddTypeInput } from \"./item-types-file.js\";\n\n/**\n * Shared domain item-type presets. These power both `pm init --type-preset`\n * (registered during initialization) and the standalone `pm schema apply-preset`\n * subcommand (adopting a preset into an already-initialized project). Keeping the\n * raw definitions and the preset-name normalizer in one place guarantees init and\n * schema register byte-identical types.\n */\n\nexport const TYPE_PRESET_NAMES = [\"agile\", \"ops\", \"research\"] as const;\nexport type TypePresetName = (typeof TYPE_PRESET_NAMES)[number];\n\n/**\n * Raw (pre-normalization) preset definitions keyed by preset name. Each entry is\n * fed through {@link normalizeAddTypeInput} before being upserted so the same\n * validation/normalization the `pm schema add-type` CLI applies governs preset\n * registration too.\n */\nexport const TYPE_PRESET_DEFINITIONS: Record<TypePresetName, RawAddTypeInput[]> = {\n  agile: [\n    {\n      name: \"Story\",\n      description: \"User-facing outcome or capability slice expressed from a stakeholder perspective.\",\n      defaultStatus: \"open\",\n      folder: \"stories\",\n      aliases: [\"user-story\"],\n    },\n    {\n      name: \"Spike\",\n      description: \"Time-boxed investigation used to reduce uncertainty before implementation.\",\n      defaultStatus: \"open\",\n      folder: \"spikes\",\n      aliases: [\"research-spike\"],\n    },\n  ],\n  ops: [\n    {\n      name: \"Incident\",\n      description: \"Operational disruption, degradation, or support escalation with recovery tracking.\",\n      defaultStatus: \"open\",\n      folder: \"incidents\",\n      aliases: [\"outage\"],\n    },\n    {\n      name: \"Runbook\",\n      description: \"Repeatable operational procedure, diagnostic path, or response playbook.\",\n      defaultStatus: \"open\",\n      folder: \"runbooks\",\n      aliases: [\"playbook\"],\n    },\n  ],\n  research: [\n    {\n      name: \"Experiment\",\n      description: \"Validated-learning activity with hypothesis, method, and outcome tracking.\",\n      defaultStatus: \"open\",\n      folder: \"experiments\",\n      aliases: [\"study\"],\n    },\n    {\n      name: \"Hypothesis\",\n      description: \"Testable claim or assumption that should be supported, rejected, or refined.\",\n      defaultStatus: \"open\",\n      folder: \"hypotheses\",\n      aliases: [\"assumption\"],\n    },\n  ],\n};\n\n/**\n * Validates and normalizes a raw preset-name CLI value. Returns `undefined` when\n * the value is omitted (no preset requested). Throws a plain Error with a stable\n * message for an empty or unknown preset; CLI layers map it to a USAGE exit code.\n * Accepts hyphen/underscore-insensitive casing for ergonomics.\n */\nexport function normalizeTypePresetName(rawValue: string | undefined): TypePresetName | undefined {\n  if (rawValue === undefined) {\n    return undefined;\n  }\n  const normalized = rawValue.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized.length === 0) {\n    throw new Error(\"Type preset name must not be empty.\");\n  }\n  if (normalized === \"agile\" || normalized === \"ops\" || normalized === \"research\") {\n    return normalized;\n  }\n  throw new Error(`Invalid type preset \"${rawValue}\". Allowed: ${TYPE_PRESET_NAMES.join(\", \")}.`);\n}\n\n/**\n * Returns the normalized add-type inputs for a preset, in the order they should\n * be upserted. Each raw definition is run through normalizeAddTypeInput so callers\n * get the same validated shape as an individual `add-type` invocation.\n */\nexport function resolveTypePresetDefinitions(preset: TypePresetName): NormalizedAddTypeInput[] {\n  return TYPE_PRESET_DEFINITIONS[preset].map((rawDefinition) => normalizeAddTypeInput(rawDefinition));\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,qBAAqB,EAAqD,MAAM,sBAAsB,CAAC;AAEhH;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAU,CAAC;AAGvE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA8C;IAChF,KAAK,EAAE;QACL;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,mFAAmF;YAChG,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,CAAC,YAAY,CAAC;SACxB;QACD;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,4EAA4E;YACzF,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,CAAC,gBAAgB,CAAC;SAC5B;KACF;IACD,GAAG,EAAE;QACH;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,oFAAoF;YACjG,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,CAAC,QAAQ,CAAC;SACpB;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,0EAA0E;YACvF,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,CAAC,UAAU,CAAC;SACtB;KACF;IACD,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,4EAA4E;YACzF,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,CAAC,OAAO,CAAC;SACnB;QACD;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,8EAA8E;YAC3F,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,CAAC,YAAY,CAAC;SACxB;KACF;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAA4B;IAClE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAChF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,eAAe,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAsB;IACjE,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC;AACtG,CAAC","debugId":"435e9450-a234-54ff-b34e-a992acb16c4e"}