@unbrained/pm-cli 2026.6.7 → 2026.6.9

package/dist/core/extensions/flag-value-types.js

@@ -0,0 +1,78 @@
+
+!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]="63f541d2-f7f5-50d9-afbe-4ce8659063f8")}catch(e){}}();
+const FLAG_VALUE_KIND_BY_ALIAS = Object.freeze({
+    string: "string",
+    number: "number",
+    int: "number",
+    integer: "number",
+    float: "number",
+    boolean: "boolean",
+    bool: "boolean",
+});
+/**
+ * Resolve a declared flag value type (string) to its canonical kind, or `null`
+ * when it is not a recognized type/alias. Matching is trim- and
+ * case-insensitive.
+ */
+export function resolveFlagValueKind(raw) {
+    if (typeof raw !== "string") {
+        return null;
+    }
+    return FLAG_VALUE_KIND_BY_ALIAS[raw.trim().toLowerCase()] ?? null;
+}
+/**
+ * Flatten a `list` flag value (or default) into its individual entries the same
+ * way the runtime does: nested arrays are flattened and comma-joined strings are
+ * split, with surrounding whitespace trimmed and empty segments dropped. No
+ * type coercion is applied. Shared by the CLI coercion path and the
+ * registration-time default validator so the two never disagree.
+ */
+export function flattenFlagListValue(value) {
+    const entries = [];
+    const collect = (input) => {
+        if (Array.isArray(input)) {
+            for (const item of input) {
+                collect(item);
+            }
+            return;
+        }
+        if (typeof input === "string") {
+            for (const part of input.split(",")) {
+                const trimmed = part.trim();
+                if (trimmed.length > 0) {
+                    entries.push(trimmed);
+                }
+            }
+            return;
+        }
+        if (input !== undefined && input !== null) {
+            entries.push(input);
+        }
+    };
+    collect(value);
+    return entries;
+}
+/**
+ * Whether a scalar flag default would cleanly coerce under the declared kind,
+ * mirroring the runtime coercion rules in `coerceLooseCommandOptionsWithFlagDefinitions`.
+ * Used to reject contradictory definitions (e.g. `value_type: "number"` with
+ * `default: "abc"`) at registration instead of letting an untyped value pass
+ * through to activation.
+ */
+export function isFlagDefaultValueCoercible(value, kind) {
+    if (kind === "string") {
+        return true;
+    }
+    if (kind === "number") {
+        if (typeof value === "number") {
+            return Number.isFinite(value);
+        }
+        return typeof value === "string" && value.trim().length > 0 && Number.isFinite(Number(value));
+    }
+    if (typeof value === "boolean") {
+        return true;
+    }
+    return typeof value === "string" && ["true", "false", "1", "0"].includes(value.trim().toLowerCase());
+}
+//# sourceMappingURL=flag-value-types.js.map
+//# debugId=63f541d2-f7f5-50d9-afbe-4ce8659063f8

package/dist/core/extensions/flag-value-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-value-types.js","sources":["core/extensions/flag-value-types.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Canonical coercion kinds an extension flag can declare via `value_type`\n * (or the deprecated `type` alias). The runtime also accepts a few common\n * aliases (`int`/`integer`/`float` -> number, `bool` -> boolean) so author\n * intent is honored without surprises.\n */\nexport type FlagValueKind = \"string\" | \"number\" | \"boolean\";\n\nconst FLAG_VALUE_KIND_BY_ALIAS: Readonly<Record<string, FlagValueKind>> = Object.freeze({\n  string: \"string\",\n  number: \"number\",\n  int: \"number\",\n  integer: \"number\",\n  float: \"number\",\n  boolean: \"boolean\",\n  bool: \"boolean\",\n});\n\n/**\n * Resolve a declared flag value type (string) to its canonical kind, or `null`\n * when it is not a recognized type/alias. Matching is trim- and\n * case-insensitive.\n */\nexport function resolveFlagValueKind(raw: unknown): FlagValueKind | null {\n  if (typeof raw !== \"string\") {\n    return null;\n  }\n  return FLAG_VALUE_KIND_BY_ALIAS[raw.trim().toLowerCase()] ?? null;\n}\n\n/**\n * Flatten a `list` flag value (or default) into its individual entries the same\n * way the runtime does: nested arrays are flattened and comma-joined strings are\n * split, with surrounding whitespace trimmed and empty segments dropped. No\n * type coercion is applied. Shared by the CLI coercion path and the\n * registration-time default validator so the two never disagree.\n */\nexport function flattenFlagListValue(value: unknown): unknown[] {\n  const entries: unknown[] = [];\n  const collect = (input: unknown): void => {\n    if (Array.isArray(input)) {\n      for (const item of input) {\n        collect(item);\n      }\n      return;\n    }\n    if (typeof input === \"string\") {\n      for (const part of input.split(\",\")) {\n        const trimmed = part.trim();\n        if (trimmed.length > 0) {\n          entries.push(trimmed);\n        }\n      }\n      return;\n    }\n    if (input !== undefined && input !== null) {\n      entries.push(input);\n    }\n  };\n  collect(value);\n  return entries;\n}\n\n/**\n * Whether a scalar flag default would cleanly coerce under the declared kind,\n * mirroring the runtime coercion rules in `coerceLooseCommandOptionsWithFlagDefinitions`.\n * Used to reject contradictory definitions (e.g. `value_type: \"number\"` with\n * `default: \"abc\"`) at registration instead of letting an untyped value pass\n * through to activation.\n */\nexport function isFlagDefaultValueCoercible(value: string | number | boolean, kind: FlagValueKind): boolean {\n  if (kind === \"string\") {\n    return true;\n  }\n  if (kind === \"number\") {\n    if (typeof value === \"number\") {\n      return Number.isFinite(value);\n    }\n    return typeof value === \"string\" && value.trim().length > 0 && Number.isFinite(Number(value));\n  }\n  if (typeof value === \"boolean\") {\n    return true;\n  }\n  return typeof value === \"string\" && [\"true\", \"false\", \"1\", \"0\"].includes(value.trim().toLowerCase());\n}\n"],"names":[],"mappings":";;AAQA,MAAM,wBAAwB,GAA4C,MAAM,CAAC,MAAM,CAAC;IACtF,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,QAAQ;IACb,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;CAChB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,wBAAwB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,KAAc,EAAQ,EAAE;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IACF,OAAO,CAAC,KAAK,CAAC,CAAC;IACf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAgC,EAAE,IAAmB;IAC/F,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACvG,CAAC","debugId":"63f541d2-f7f5-50d9-afbe-4ce8659063f8"}

package/dist/core/extensions/item-field-types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Canonical coercion kinds accepted for extension-registered custom item fields.
+ *
+ * A `registerItemFields` definition declares one of these as its `type`; the
+ * value is later coerced by that kind (see `coerceRegisteredFieldValue`). Keep
+ * this list in lock-step with the coercion switch in `item-fields.ts`.
+ */
+export declare const KNOWN_ITEM_FIELD_TYPES: readonly ["string", "number", "boolean", "array", "object"];
+export type KnownItemFieldType = (typeof KNOWN_ITEM_FIELD_TYPES)[number];
+/**
+ * Normalize a declared field type to its canonical kind, or `null` when the
+ * value is not a known type. Matching is trim- and case-insensitive.
+ */
+export declare function normalizeItemFieldType(value: string): KnownItemFieldType | null;
+/**
+ * Suggest a known field type for a typo'd declaration (e.g. `"strnig"` ->
+ * `"string"`), using the shared OSA Damerau–Levenshtein helper so adjacent
+ * transpositions count as a single edit. Returns the first canonical type within
+ * the proportional edit budget (in declaration order — the kinds are distinct
+ * enough that at most one matches), or `null` when nothing is close enough.
+ */
+export declare function suggestKnownItemFieldType(value: string): KnownItemFieldType | null;

package/dist/core/extensions/item-field-types.js

@@ -0,0 +1,43 @@
+
+!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]="557146c8-cf60-5bbf-a59a-606928c536de")}catch(e){}}();
+import { levenshteinDistanceWithinLimit } from "../shared/levenshtein.js";
+/**
+ * Canonical coercion kinds accepted for extension-registered custom item fields.
+ *
+ * A `registerItemFields` definition declares one of these as its `type`; the
+ * value is later coerced by that kind (see `coerceRegisteredFieldValue`). Keep
+ * this list in lock-step with the coercion switch in `item-fields.ts`.
+ */
+export const KNOWN_ITEM_FIELD_TYPES = ["string", "number", "boolean", "array", "object"];
+/**
+ * Normalize a declared field type to its canonical kind, or `null` when the
+ * value is not a known type. Matching is trim- and case-insensitive.
+ */
+export function normalizeItemFieldType(value) {
+    const normalized = value.trim().toLowerCase();
+    return KNOWN_ITEM_FIELD_TYPES.includes(normalized)
+        ? normalized
+        : null;
+}
+/**
+ * Suggest a known field type for a typo'd declaration (e.g. `"strnig"` ->
+ * `"string"`), using the shared OSA Damerau–Levenshtein helper so adjacent
+ * transpositions count as a single edit. Returns the first canonical type within
+ * the proportional edit budget (in declaration order — the kinds are distinct
+ * enough that at most one matches), or `null` when nothing is close enough.
+ */
+export function suggestKnownItemFieldType(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized.length === 0) {
+        return null;
+    }
+    const limit = Math.max(1, Math.floor(normalized.length * 0.34));
+    for (const candidate of KNOWN_ITEM_FIELD_TYPES) {
+        if (levenshteinDistanceWithinLimit(normalized, candidate, limit) !== null) {
+            return candidate;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=item-field-types.js.map
+//# debugId=557146c8-cf60-5bbf-a59a-606928c536de

package/dist/core/extensions/item-field-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-field-types.js","sources":["core/extensions/item-field-types.ts"],"sourceRoot":"/","sourcesContent":["import { levenshteinDistanceWithinLimit } from \"../shared/levenshtein.js\";\n\n/**\n * Canonical coercion kinds accepted for extension-registered custom item fields.\n *\n * A `registerItemFields` definition declares one of these as its `type`; the\n * value is later coerced by that kind (see `coerceRegisteredFieldValue`). Keep\n * this list in lock-step with the coercion switch in `item-fields.ts`.\n */\nexport const KNOWN_ITEM_FIELD_TYPES = [\"string\", \"number\", \"boolean\", \"array\", \"object\"] as const;\nexport type KnownItemFieldType = (typeof KNOWN_ITEM_FIELD_TYPES)[number];\n\n/**\n * Normalize a declared field type to its canonical kind, or `null` when the\n * value is not a known type. Matching is trim- and case-insensitive.\n */\nexport function normalizeItemFieldType(value: string): KnownItemFieldType | null {\n  const normalized = value.trim().toLowerCase();\n  return (KNOWN_ITEM_FIELD_TYPES as readonly string[]).includes(normalized)\n    ? (normalized as KnownItemFieldType)\n    : null;\n}\n\n/**\n * Suggest a known field type for a typo'd declaration (e.g. `\"strnig\"` ->\n * `\"string\"`), using the shared OSA Damerau–Levenshtein helper so adjacent\n * transpositions count as a single edit. Returns the first canonical type within\n * the proportional edit budget (in declaration order — the kinds are distinct\n * enough that at most one matches), or `null` when nothing is close enough.\n */\nexport function suggestKnownItemFieldType(value: string): KnownItemFieldType | null {\n  const normalized = value.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return null;\n  }\n  const limit = Math.max(1, Math.floor(normalized.length * 0.34));\n  for (const candidate of KNOWN_ITEM_FIELD_TYPES) {\n    if (levenshteinDistanceWithinLimit(normalized, candidate, limit) !== null) {\n      return candidate;\n    }\n  }\n  return null;\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAGlG;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,UAAU,CAAC;QACvE,CAAC,CAAE,UAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAChE,KAAK,MAAM,SAAS,IAAI,sBAAsB,EAAE,CAAC;QAC/C,IAAI,8BAA8B,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1E,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","debugId":"557146c8-cf60-5bbf-a59a-606928c536de"}

package/dist/core/extensions/item-fields.js

@@ -1,5 +1,6 @@
 
-!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]="60ed024d-4341-5166-bd9e-abed9b240b11")}catch(e){}}();
+!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]="1d92831e-54a7-5c1f-af04-7441908e8e5a")}catch(e){}}();
+import { normalizeItemFieldType } from "./item-field-types.js";
 import { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from "../shared/constants.js";
 import { PmCliError } from "../shared/errors.js";
 const RESERVED_ITEM_FIELD_NAMES = new Set(FRONT_MATTER_KEY_ORDER);
@@ -14,15 +15,7 @@ function normalizeFieldType(value) {
     if (typeof value !== "string") {
         return null;
     }
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "string" ||
-        normalized === "number" ||
-        normalized === "boolean" ||
-        normalized === "array" ||
-        normalized === "object") {
-        return normalized;
-    }
-    return null;
+    return normalizeItemFieldType(value);
 }
 function cloneFieldValue(value) {
     try {
@@ -201,4 +194,4 @@ export function applyRegisteredItemFieldDefaultsAndValidation(frontMatter, regis
     }
 }
 //# sourceMappingURL=item-fields.js.map
-//# debugId=60ed024d-4341-5166-bd9e-abed9b240b11
+//# debugId=1d92831e-54a7-5c1f-af04-7441908e8e5a

package/dist/core/extensions/item-fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-fields.js","sources":["core/extensions/item-fields.ts"],"sourceRoot":"/","sourcesContent":["import type { ExtensionRegistrationRegistry } from \"./loader.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst RESERVED_ITEM_FIELD_NAMES = new Set(FRONT_MATTER_KEY_ORDER);\n\nfunction normalizeFieldName(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : null;\n}\n\nfunction normalizeFieldType(value: unknown): \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim().toLowerCase();\n  if (\n    normalized === \"string\" ||\n    normalized === \"number\" ||\n    normalized === \"boolean\" ||\n    normalized === \"array\" ||\n    normalized === \"object\"\n  ) {\n    return normalized;\n  }\n  return null;\n}\n\nfunction cloneFieldValue<T>(value: T): T {\n  try {\n    return structuredClone(value);\n  } catch {\n    return value;\n  }\n}\n\nfunction parseFieldAssignment(raw: string): { key: string; value: string } {\n  const trimmed = raw.trim();\n  const separatorIndex = trimmed.indexOf(\"=\");\n  if (separatorIndex <= 0) {\n    throw new PmCliError(`--field entries must use name=value syntax, received: ${raw}`, EXIT_CODE.USAGE);\n  }\n  const key = trimmed.slice(0, separatorIndex).trim();\n  const value = trimmed.slice(separatorIndex + 1);\n  if (key.length === 0) {\n    throw new PmCliError(\"--field entries require a non-empty field name\", EXIT_CODE.USAGE);\n  }\n  return { key, value };\n}\n\nfunction parseJsonFieldValue(raw: string, fieldName: string, expectedType: \"array\" | \"object\"): unknown {\n  try {\n    const parsed = JSON.parse(raw);\n    if (expectedType === \"array\" && Array.isArray(parsed)) {\n      return parsed;\n    }\n    if (expectedType === \"object\" && typeof parsed === \"object\" && parsed !== null && !Array.isArray(parsed)) {\n      return parsed;\n    }\n  } catch {\n    // Fall through to the typed usage error below.\n  }\n  throw new PmCliError(`--field ${fieldName}=... must be valid JSON ${expectedType}`, EXIT_CODE.USAGE);\n}\n\nfunction coerceRegisteredFieldValue(fieldName: string, fieldType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\", raw: string): unknown {\n  if (fieldType === \"string\") {\n    return raw;\n  }\n  if (fieldType === \"number\") {\n    const trimmed = raw.trim();\n    if (trimmed.length === 0) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    const parsed = Number(trimmed);\n    if (!Number.isFinite(parsed)) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    return parsed;\n  }\n  if (fieldType === \"boolean\") {\n    const normalized = raw.trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\" || normalized === \"yes\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\" || normalized === \"no\") {\n      return false;\n    }\n    throw new PmCliError(`--field ${fieldName}=... must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);\n  }\n  return parseJsonFieldValue(raw, fieldName, fieldType);\n}\n\nfunction collectRegisteredFieldDefinitions(\n  registrations: ExtensionRegistrationRegistry | null,\n): Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }> {\n  const definitions = new Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }>();\n  if (!registrations) {\n    return definitions;\n  }\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      const fieldType = normalizeFieldType(definition.type);\n      if (!fieldName || !fieldType) {\n        continue;\n      }\n      const existing = definitions.get(fieldName);\n      if (existing && existing.type !== fieldType) {\n        throw new PmCliError(\n          `Extension item field \"${fieldName}\" is declared with conflicting types: ${existing.type}, ${fieldType}`,\n          EXIT_CODE.USAGE,\n          {\n            code: \"extension_item_field_type_conflict\",\n            nextSteps: [\"Make every active extension declaration for this field use the same type.\"],\n          },\n        );\n      }\n      definitions.set(fieldName, { name: fieldName, type: fieldType });\n    }\n  }\n  return definitions;\n}\n\nfunction assertNotReservedItemFieldName(fieldName: string): void {\n  if (!RESERVED_ITEM_FIELD_NAMES.has(fieldName)) {\n    return;\n  }\n  throw new PmCliError(`Extension item field \"${fieldName}\" collides with reserved item metadata`, EXIT_CODE.USAGE, {\n    code: \"extension_item_field_reserved\",\n    nextSteps: [\"Rename the extension item field, preferably with an extension-specific prefix.\"],\n  });\n}\n\nexport function collectRegisteredItemFieldNames(registrations: ExtensionRegistrationRegistry | null): string[] {\n  return [...collectRegisteredFieldDefinitions(registrations).keys()].sort((left, right) => left.localeCompare(right));\n}\n\nexport function parseRegisteredItemFieldAssignments(\n  rawFields: string[] | undefined,\n  registrations: ExtensionRegistrationRegistry | null,\n): Record<string, unknown> {\n  if (!rawFields || rawFields.length === 0) {\n    return {};\n  }\n  const definitions = collectRegisteredFieldDefinitions(registrations);\n  const values: Record<string, unknown> = {};\n  for (const raw of rawFields) {\n    const { key, value } = parseFieldAssignment(raw);\n    const definition = definitions.get(key);\n    if (!definition) {\n      const known = [...definitions.keys()].sort((left, right) => left.localeCompare(right));\n      throw new PmCliError(`--field ${key} is not declared by an active extension item-field registration`, EXIT_CODE.USAGE, {\n        code: \"extension_item_field_unknown\",\n        recovery: { provided_fields: known },\n        nextSteps: known.length > 0\n          ? [`Use one of the declared fields: ${known.join(\", \")}`]\n          : [\"Activate an extension that calls registerItemFields before setting extension fields.\"],\n      });\n    }\n    assertNotReservedItemFieldName(definition.name);\n    values[definition.name] = coerceRegisteredFieldValue(definition.name, definition.type, value);\n  }\n  return values;\n}\n\nfunction isValidFieldType(value: unknown, expectedType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\"): boolean {\n  if (expectedType === \"string\") {\n    return typeof value === \"string\";\n  }\n  if (expectedType === \"number\") {\n    return typeof value === \"number\" && Number.isFinite(value);\n  }\n  if (expectedType === \"boolean\") {\n    return typeof value === \"boolean\";\n  }\n  if (expectedType === \"array\") {\n    return Array.isArray(value);\n  }\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isAllowedFieldValue(value: unknown, allowed: unknown[] | undefined): boolean {\n  if (!allowed || allowed.length === 0) {\n    return true;\n  }\n  return allowed.some((candidate) => Object.is(candidate, value));\n}\n\nexport function applyRegisteredItemFieldDefaultsAndValidation(\n  frontMatter: Record<string, unknown>,\n  registrations: ExtensionRegistrationRegistry | null,\n  options: { skipDefaultFields?: ReadonlySet<string> } = {},\n): void {\n  if (!registrations) {\n    return;\n  }\n  collectRegisteredFieldDefinitions(registrations);\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      if (!fieldName) {\n        continue;\n      }\n      assertNotReservedItemFieldName(fieldName);\n      if (\n        !(fieldName in frontMatter) &&\n        !options.skipDefaultFields?.has(fieldName) &&\n        Object.prototype.hasOwnProperty.call(definition, \"default\")\n      ) {\n        frontMatter[fieldName] = cloneFieldValue(definition.default);\n      }\n\n      const currentValue = frontMatter[fieldName];\n      if (currentValue === undefined) {\n        continue;\n      }\n      const expectedType = normalizeFieldType(definition.type);\n      if (expectedType && !isValidFieldType(currentValue, expectedType)) {\n        throw new TypeError(`Item field \"${fieldName}\" must be of type ${expectedType}`);\n      }\n\n      const allowedValues = Array.isArray(definition.values) ? definition.values : undefined;\n      if (!isAllowedFieldValue(currentValue, allowedValues)) {\n        throw new TypeError(`Item field \"${fieldName}\" must match one of the configured allowed values`);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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","debugId":"60ed024d-4341-5166-bd9e-abed9b240b11"}
+{"version":3,"file":"item-fields.js","sources":["core/extensions/item-fields.ts"],"sourceRoot":"/","sourcesContent":["import type { ExtensionRegistrationRegistry } from \"./loader.js\";\nimport { normalizeItemFieldType, type KnownItemFieldType } from \"./item-field-types.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst RESERVED_ITEM_FIELD_NAMES = new Set(FRONT_MATTER_KEY_ORDER);\n\nfunction normalizeFieldName(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : null;\n}\n\nfunction normalizeFieldType(value: unknown): KnownItemFieldType | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  return normalizeItemFieldType(value);\n}\n\nfunction cloneFieldValue<T>(value: T): T {\n  try {\n    return structuredClone(value);\n  } catch {\n    return value;\n  }\n}\n\nfunction parseFieldAssignment(raw: string): { key: string; value: string } {\n  const trimmed = raw.trim();\n  const separatorIndex = trimmed.indexOf(\"=\");\n  if (separatorIndex <= 0) {\n    throw new PmCliError(`--field entries must use name=value syntax, received: ${raw}`, EXIT_CODE.USAGE);\n  }\n  const key = trimmed.slice(0, separatorIndex).trim();\n  const value = trimmed.slice(separatorIndex + 1);\n  if (key.length === 0) {\n    throw new PmCliError(\"--field entries require a non-empty field name\", EXIT_CODE.USAGE);\n  }\n  return { key, value };\n}\n\nfunction parseJsonFieldValue(raw: string, fieldName: string, expectedType: \"array\" | \"object\"): unknown {\n  try {\n    const parsed = JSON.parse(raw);\n    if (expectedType === \"array\" && Array.isArray(parsed)) {\n      return parsed;\n    }\n    if (expectedType === \"object\" && typeof parsed === \"object\" && parsed !== null && !Array.isArray(parsed)) {\n      return parsed;\n    }\n  } catch {\n    // Fall through to the typed usage error below.\n  }\n  throw new PmCliError(`--field ${fieldName}=... must be valid JSON ${expectedType}`, EXIT_CODE.USAGE);\n}\n\nfunction coerceRegisteredFieldValue(fieldName: string, fieldType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\", raw: string): unknown {\n  if (fieldType === \"string\") {\n    return raw;\n  }\n  if (fieldType === \"number\") {\n    const trimmed = raw.trim();\n    if (trimmed.length === 0) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    const parsed = Number(trimmed);\n    if (!Number.isFinite(parsed)) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    return parsed;\n  }\n  if (fieldType === \"boolean\") {\n    const normalized = raw.trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\" || normalized === \"yes\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\" || normalized === \"no\") {\n      return false;\n    }\n    throw new PmCliError(`--field ${fieldName}=... must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);\n  }\n  return parseJsonFieldValue(raw, fieldName, fieldType);\n}\n\nfunction collectRegisteredFieldDefinitions(\n  registrations: ExtensionRegistrationRegistry | null,\n): Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }> {\n  const definitions = new Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }>();\n  if (!registrations) {\n    return definitions;\n  }\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      const fieldType = normalizeFieldType(definition.type);\n      if (!fieldName || !fieldType) {\n        continue;\n      }\n      const existing = definitions.get(fieldName);\n      if (existing && existing.type !== fieldType) {\n        throw new PmCliError(\n          `Extension item field \"${fieldName}\" is declared with conflicting types: ${existing.type}, ${fieldType}`,\n          EXIT_CODE.USAGE,\n          {\n            code: \"extension_item_field_type_conflict\",\n            nextSteps: [\"Make every active extension declaration for this field use the same type.\"],\n          },\n        );\n      }\n      definitions.set(fieldName, { name: fieldName, type: fieldType });\n    }\n  }\n  return definitions;\n}\n\nfunction assertNotReservedItemFieldName(fieldName: string): void {\n  if (!RESERVED_ITEM_FIELD_NAMES.has(fieldName)) {\n    return;\n  }\n  throw new PmCliError(`Extension item field \"${fieldName}\" collides with reserved item metadata`, EXIT_CODE.USAGE, {\n    code: \"extension_item_field_reserved\",\n    nextSteps: [\"Rename the extension item field, preferably with an extension-specific prefix.\"],\n  });\n}\n\nexport function collectRegisteredItemFieldNames(registrations: ExtensionRegistrationRegistry | null): string[] {\n  return [...collectRegisteredFieldDefinitions(registrations).keys()].sort((left, right) => left.localeCompare(right));\n}\n\nexport function parseRegisteredItemFieldAssignments(\n  rawFields: string[] | undefined,\n  registrations: ExtensionRegistrationRegistry | null,\n): Record<string, unknown> {\n  if (!rawFields || rawFields.length === 0) {\n    return {};\n  }\n  const definitions = collectRegisteredFieldDefinitions(registrations);\n  const values: Record<string, unknown> = {};\n  for (const raw of rawFields) {\n    const { key, value } = parseFieldAssignment(raw);\n    const definition = definitions.get(key);\n    if (!definition) {\n      const known = [...definitions.keys()].sort((left, right) => left.localeCompare(right));\n      throw new PmCliError(`--field ${key} is not declared by an active extension item-field registration`, EXIT_CODE.USAGE, {\n        code: \"extension_item_field_unknown\",\n        recovery: { provided_fields: known },\n        nextSteps: known.length > 0\n          ? [`Use one of the declared fields: ${known.join(\", \")}`]\n          : [\"Activate an extension that calls registerItemFields before setting extension fields.\"],\n      });\n    }\n    assertNotReservedItemFieldName(definition.name);\n    values[definition.name] = coerceRegisteredFieldValue(definition.name, definition.type, value);\n  }\n  return values;\n}\n\nfunction isValidFieldType(value: unknown, expectedType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\"): boolean {\n  if (expectedType === \"string\") {\n    return typeof value === \"string\";\n  }\n  if (expectedType === \"number\") {\n    return typeof value === \"number\" && Number.isFinite(value);\n  }\n  if (expectedType === \"boolean\") {\n    return typeof value === \"boolean\";\n  }\n  if (expectedType === \"array\") {\n    return Array.isArray(value);\n  }\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isAllowedFieldValue(value: unknown, allowed: unknown[] | undefined): boolean {\n  if (!allowed || allowed.length === 0) {\n    return true;\n  }\n  return allowed.some((candidate) => Object.is(candidate, value));\n}\n\nexport function applyRegisteredItemFieldDefaultsAndValidation(\n  frontMatter: Record<string, unknown>,\n  registrations: ExtensionRegistrationRegistry | null,\n  options: { skipDefaultFields?: ReadonlySet<string> } = {},\n): void {\n  if (!registrations) {\n    return;\n  }\n  collectRegisteredFieldDefinitions(registrations);\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      if (!fieldName) {\n        continue;\n      }\n      assertNotReservedItemFieldName(fieldName);\n      if (\n        !(fieldName in frontMatter) &&\n        !options.skipDefaultFields?.has(fieldName) &&\n        Object.prototype.hasOwnProperty.call(definition, \"default\")\n      ) {\n        frontMatter[fieldName] = cloneFieldValue(definition.default);\n      }\n\n      const currentValue = frontMatter[fieldName];\n      if (currentValue === undefined) {\n        continue;\n      }\n      const expectedType = normalizeFieldType(definition.type);\n      if (expectedType && !isValidFieldType(currentValue, expectedType)) {\n        throw new TypeError(`Item field \"${fieldName}\" must be of type ${expectedType}`);\n      }\n\n      const allowedValues = Array.isArray(definition.values) ? definition.values : undefined;\n      if (!isAllowedFieldValue(currentValue, allowedValues)) {\n        throw new TypeError(`Item field \"${fieldName}\" must match one of the configured allowed values`);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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","debugId":"1d92831e-54a7-5c1f-af04-7441908e8e5a"}

package/dist/core/extensions/loader.d.ts

@@ -1,7 +1,7 @@
 export { parseUnknownExtensionCapabilityWarning, parseLegacyExtensionCapabilityAliasWarning, } from "./extension-capability-aliases.js";
 export { createEmptyExtensionHookRegistry, createEmptyExtensionCommandRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionServiceRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionRegistrationRegistry, } from "./extension-registries.js";
 export { runBeforeCommandHooks, runAfterCommandHooks, runOnWriteHooks, runOnReadHooks, runOnIndexHooks, runCommandHandler, runParserOverride, runPreflightOverride, runServiceOverrideSync, runServiceOverride, runCommandOverride, runRendererOverride, } from "./extension-hook-runtime.js";
-import { type ExtensionDiscoveryResult, type ExtensionLoadResult, type ExtensionActivationResult, type DiscoverExtensionsOptions } from "./extension-types.js";
+import { type ExtensionDeactivationResult, type ExtensionDiscoveryResult, type ExtensionLoadResult, type ExtensionActivationResult, type DiscoverExtensionsOptions } from "./extension-types.js";
 export * from "./extension-types.js";
 export declare function nextExtensionReloadToken(seed?: number): string;
 export declare function resolveExtensionRoots(pmRoot: string, cwd?: string): {
@@ -10,4 +10,17 @@ export declare function resolveExtensionRoots(pmRoot: string, cwd?: string): {
 };
 export declare function discoverExtensions(options: DiscoverExtensionsOptions): Promise<ExtensionDiscoveryResult>;
 export declare function loadExtensions(options: DiscoverExtensionsOptions): Promise<ExtensionLoadResult>;
+/**
+ * Run the optional `deactivate` teardown hook for every loaded extension that
+ * exports one. Best-effort: a throwing teardown is captured as a warning and a
+ * failure entry rather than propagated, so one extension cannot block another's
+ * cleanup. Hosts call this on shutdown/reload (e.g. the MCP server between
+ * native-action requests) to release resources opened during `activate`.
+ *
+ * Pass the `activationResult` to skip extensions whose `activate` failed — they
+ * never fully initialized, so (VS Code-style) their `deactivate` must not run.
+ * Teardowns run concurrently so one slow hook cannot serialize the rest; the
+ * returned warnings/failures preserve loaded order.
+ */
+export declare function deactivateExtensions(loadResult: ExtensionLoadResult, activationResult?: Pick<ExtensionActivationResult, "failed">): Promise<ExtensionDeactivationResult>;
 export declare function activateExtensions(loadResult: ExtensionLoadResult): Promise<ExtensionActivationResult>;

package/dist/core/extensions/loader.js

@@ -1,5 +1,5 @@
 
-!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]="54365547-c7be-5bd4-be2e-ca02f27aa365")}catch(e){}}();
+!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]="e5c4c469-142a-5854-82ca-a920130d2104")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
@@ -8,6 +8,8 @@ import { isPathWithinDirectory } from "../fs/path-utils.js";
 import { resolvePmPackageRootFromModule } from "../packages/root.js";
 import { resolveGlobalPmRoot } from "../store/paths.js";
 import { asRecordLoose } from "../shared/primitives.js";
+import { flattenFlagListValue, isFlagDefaultValueCoercible, resolveFlagValueKind } from "./flag-value-types.js";
+import { KNOWN_ITEM_FIELD_TYPES, normalizeItemFieldType, suggestKnownItemFieldType } from "./item-field-types.js";
 // Cohesive helper groups now live in sibling modules. They are imported for the
 // discovery/activation code that stays here and re-exported below so existing
 // import sites (sdk/index.ts, commands/extension.ts, health.ts, tests, …) keep
@@ -19,7 +21,7 @@ import { normalizeCommandName, cloneContextSnapshot, } from "./extension-runtime
 export { parseUnknownExtensionCapabilityWarning, parseLegacyExtensionCapabilityAliasWarning, } from "./extension-capability-aliases.js";
 export { createEmptyExtensionHookRegistry, createEmptyExtensionCommandRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionServiceRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionRegistrationRegistry, } from "./extension-registries.js";
 export { runBeforeCommandHooks, runAfterCommandHooks, runOnWriteHooks, runOnReadHooks, runOnIndexHooks, runCommandHandler, runParserOverride, runPreflightOverride, runServiceOverrideSync, runServiceOverride, runCommandOverride, runRendererOverride, } from "./extension-hook-runtime.js";
-import { KNOWN_EXTENSION_SERVICE_NAMES, createDefaultExtensionGovernancePolicy, } from "./extension-types.js";
+import { KNOWN_EXTENSION_CAPABILITIES, KNOWN_EXTENSION_SERVICE_NAMES, createDefaultExtensionGovernancePolicy, } from "./extension-types.js";
 export * from "./extension-types.js";
 const DEFAULT_EXTENSION_PRIORITY = 100;
 let currentPmCliVersionPromise = null;
@@ -727,24 +729,82 @@ export async function loadExtensions(options) {
         failed,
     };
 }
+function toActivatableExtension(source) {
+    // Bind to `source` so a module/default-export authored with methods (or a class
+    // instance) keeps its `this` across both lifecycle calls — `activate` is a
+    // method call on a fresh object and `deactivate` is invoked bare, so without
+    // binding the two would see different (or undefined) `this`.
+    const activate = source.activate;
+    const activatable = {
+        activate: activate.bind(source),
+    };
+    if (typeof source.deactivate === "function") {
+        const deactivate = source.deactivate;
+        activatable.deactivate = deactivate.bind(source);
+    }
+    return activatable;
+}
 function resolveActivatableExtension(module) {
     const moduleRecord = asRecordLoose(module);
     if (!moduleRecord) {
         return null;
     }
     if (typeof moduleRecord.activate === "function") {
-        return {
-            activate: moduleRecord.activate,
-        };
+        return toActivatableExtension(moduleRecord);
     }
     const defaultExport = asRecordLoose(moduleRecord.default);
     if (defaultExport && typeof defaultExport.activate === "function") {
-        return {
-            activate: defaultExport.activate,
-        };
+        return toActivatableExtension(defaultExport);
     }
     return null;
 }
+/**
+ * Run the optional `deactivate` teardown hook for every loaded extension that
+ * exports one. Best-effort: a throwing teardown is captured as a warning and a
+ * failure entry rather than propagated, so one extension cannot block another's
+ * cleanup. Hosts call this on shutdown/reload (e.g. the MCP server between
+ * native-action requests) to release resources opened during `activate`.
+ *
+ * Pass the `activationResult` to skip extensions whose `activate` failed — they
+ * never fully initialized, so (VS Code-style) their `deactivate` must not run.
+ * Teardowns run concurrently so one slow hook cannot serialize the rest; the
+ * returned warnings/failures preserve loaded order.
+ */
+export async function deactivateExtensions(loadResult, activationResult) {
+    const failedActivationKeys = new Set((activationResult?.failed ?? []).map((entry) => `${entry.layer}:${entry.name}`));
+    const targets = [];
+    for (const extension of loadResult.loaded) {
+        if (failedActivationKeys.has(`${extension.layer}:${extension.name}`)) {
+            continue;
+        }
+        const activatable = resolveActivatableExtension(extension.module);
+        if (!activatable || typeof activatable.deactivate !== "function") {
+            continue;
+        }
+        targets.push({ extension, deactivate: activatable.deactivate });
+    }
+    const outcomes = await Promise.all(targets.map(async ({ extension, deactivate }) => {
+        try {
+            await deactivate();
+            return { ok: true };
+        }
+        catch (error) {
+            return { ok: false, layer: extension.layer, name: extension.name, error: formatUnknownError(error) };
+        }
+    }));
+    const warnings = [];
+    const failed = [];
+    let deactivated = 0;
+    for (const outcome of outcomes) {
+        if (outcome.ok) {
+            deactivated += 1;
+            continue;
+        }
+        warnings.push(`extension_deactivate_failed:${outcome.layer}:${outcome.name}`);
+        failed.push({ layer: outcome.layer, name: outcome.name, error: outcome.error });
+    }
+    return { deactivated, warnings, failed };
+}
 function isOutputRendererFormat(value) {
     return value === "toon" || value === "json";
 }
@@ -873,6 +933,25 @@ function assertOptionalStringField(name, value) {
         throw new TypeError(`${name} must be a non-empty string when provided`);
     }
 }
+function isFlagDefaultScalar(value) {
+    return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function assertOptionalFlagDefaultField(name, value) {
+    if (value === undefined) {
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const [index, item] of value.entries()) {
+            if (!isFlagDefaultScalar(item)) {
+                throw new TypeError(`${name}[${index}] must be a string, number, or boolean`);
+            }
+        }
+        return;
+    }
+    if (!isFlagDefaultScalar(value)) {
+        throw new TypeError(`${name} must be a string, number, or boolean, or an array of these when provided`);
+    }
+}
 function assertOptionalStringArrayField(name, value) {
     if (value === undefined) {
         return;
@@ -992,6 +1071,42 @@ function validateFlagDefinitions(flags) {
         assertOptionalBooleanField(`registerFlags flags[${index}].required`, record.required);
         assertOptionalBooleanField(`registerFlags flags[${index}].enabled`, record.enabled);
         assertOptionalBooleanField(`registerFlags flags[${index}].visible`, record.visible);
+        assertOptionalBooleanField(`registerFlags flags[${index}].list`, record.list);
+        assertOptionalFlagDefaultField(`registerFlags flags[${index}].default`, record.default);
+        if (Array.isArray(record.default) && record.list !== true) {
+            throw new TypeError(`registerFlags flags[${index}].default cannot be an array unless list is true.`);
+        }
+        assertFlagValueTypeAndDefault(`registerFlags flags[${index}]`, record);
+    }
+}
+/**
+ * Reject a declared `value_type`/`type` that is not a known flag value kind, and
+ * a `default` whose value(s) would not cleanly coerce under that kind — so the
+ * typed-flag contract is enforced at registration instead of silently leaving
+ * an untyped value to surface at use time.
+ */
+function assertFlagValueTypeAndDefault(label, record) {
+    const declaredType = (typeof record.value_type === "string" ? record.value_type : undefined) ??
+        (typeof record.type === "string" ? record.type : undefined);
+    if (declaredType === undefined) {
+        return;
+    }
+    const kind = resolveFlagValueKind(declaredType);
+    if (kind === null) {
+        throw new TypeError(`${label} value_type "${declaredType}" is not a known flag value type (expected one of: string, number, boolean).`);
+    }
+    if (record.default === undefined) {
+        return;
+    }
+    // For list flags, validate the default exactly as the runtime will see it —
+    // comma-joined strings and nested arrays are flattened first — so a valid
+    // default like `value_type: "number", default: "10,20"` is not wrongly rejected.
+    const defaults = record.list === true ? flattenFlagListValue(record.default) : [record.default];
+    for (const [defaultIndex, defaultValue] of defaults.entries()) {
+        if (!isFlagDefaultValueCoercible(defaultValue, kind)) {
+            const suffix = defaults.length > 1 ? `default[${defaultIndex}]` : "default";
+            throw new TypeError(`${label}.${suffix} (${JSON.stringify(defaultValue)}) is not coercible to ${kind}.`);
+        }
     }
 }
 function validateItemFieldDefinitions(fields) {
@@ -1001,7 +1116,13 @@ function validateItemFieldDefinitions(fields) {
     for (const [index, raw] of fields.entries()) {
         const record = asRegistrationRecord(`registerItemFields fields[${index}]`, raw);
         assertNonEmptyString(`registerItemFields fields[${index}].name`, record.name);
-        assertNonEmptyString(`registerItemFields fields[${index}].type`, record.type);
+        const fieldType = assertNonEmptyString(`registerItemFields fields[${index}].type`, record.type);
+        if (normalizeItemFieldType(fieldType) === null) {
+            const suggestion = suggestKnownItemFieldType(fieldType);
+            const hint = suggestion ? ` Did you mean "${suggestion}"?` : "";
+            throw new TypeError(`registerItemFields fields[${index}].type "${fieldType}" is not a known field type ` +
+                `(expected one of: ${KNOWN_ITEM_FIELD_TYPES.join(", ")}).${hint}`);
+        }
         assertOptionalBooleanField(`registerItemFields fields[${index}].optional`, record.optional);
     }
 }
@@ -1102,6 +1223,15 @@ function assertExtensionCapability(extension, capability, method) {
     }
 }
 function createExtensionApi(extension, hooks, commands, parsers, preflight, services, renderers, registrations, activationWarnings, policy) {
+    const selfIdentity = Object.freeze({
+        name: extension.name,
+        layer: extension.layer,
+        version: extension.version,
+        capabilities: Object.freeze((extension.capabilities ?? []).filter((capability) => KNOWN_EXTENSION_CAPABILITIES.includes(capability))),
+        pm_min_version: extension.pm_min_version,
+        pm_max_version: extension.pm_max_version,
+        source_package: extension.source_package,
+    });
     const extensionRef = {
         layer: extension.layer,
         name: extension.name,
@@ -1552,6 +1682,7 @@ function createExtensionApi(extension, hooks, commands, parsers, preflight, serv
         });
     };
     return {
+        extension: selfIdentity,
         registerCommand,
         registerParser,
         registerPreflight,
@@ -1769,4 +1900,4 @@ export async function activateExtensions(loadResult) {
     };
 }
 //# sourceMappingURL=loader.js.map
-//# debugId=54365547-c7be-5bd4-be2e-ca02f27aa365
+//# debugId=e5c4c469-142a-5854-82ca-a920130d2104