@unbrained/pm-cli 2026.6.24 → 2026.7.1

package/dist/cli/commands/extension/managed-state.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Managed State.
  */
 
-!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]="2522dc0e-5909-57da-b8cb-ceb4eac20da2")}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]="0874e784-e274-5edd-8fbf-26d94a6c4a32")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { EXIT_CODE } from "../../../core/shared/constants.js";
@@ -63,6 +63,101 @@ export function managedExtensionSourcesEquivalent(left, right) {
     }
     return true;
 }
+/**
+ * Narrow `value` to a string, or `undefined` for any other type — the
+ * normalization applied to every optional managed-state string field so an
+ * absent or malformed value is dropped rather than carried through as `unknown`.
+ */
+function optionalString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+/**
+ * Type guard asserting `entry` carries every always-present managed-record field
+ * with the right primitive type: a non-empty `name`/`directory`, a known
+ * {@link ExtensionScope}, string manifest metadata, a `string[]` capability
+ * list, and string `installed_at`/`updated_at` timestamps. The optional columns
+ * (`source` plus the update-check fields) are validated separately by the
+ * caller, so this guard narrows only the required columns.
+ */
+function hasRequiredManagedRecordFields(entry) {
+    return (typeof entry.name === "string" &&
+        entry.name.trim().length > 0 &&
+        typeof entry.directory === "string" &&
+        entry.directory.trim().length > 0 &&
+        (entry.scope === "project" || entry.scope === "global") &&
+        typeof entry.manifest_version === "string" &&
+        typeof entry.manifest_entry === "string" &&
+        Array.isArray(entry.capabilities) &&
+        entry.capabilities.every((value) => typeof value === "string") &&
+        typeof entry.installed_at === "string" &&
+        typeof entry.updated_at === "string");
+}
+/**
+ * Normalize one persisted managed-extension source object, returning `null` when
+ * the discriminant (`kind`) or the required `input`/`location` strings are
+ * missing or malformed so the caller can skip the owning record.
+ */
+function normalizeManagedSource(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        return null;
+    }
+    const source = raw;
+    if ((source.kind !== "local" && source.kind !== "github" && source.kind !== "npm" && source.kind !== "builtin") ||
+        typeof source.input !== "string" ||
+        typeof source.location !== "string") {
+        return null;
+    }
+    return {
+        kind: source.kind,
+        input: source.input,
+        location: source.location,
+        name: optionalString(source.name),
+        package: optionalString(source.package),
+        version: optionalString(source.version),
+        repository: optionalString(source.repository),
+        owner: optionalString(source.owner),
+        repo: optionalString(source.repo),
+        ref: optionalString(source.ref),
+        subpath: optionalString(source.subpath),
+        commit: optionalString(source.commit),
+    };
+}
+/**
+ * Normalize one persisted managed-extension record, returning `null` when any
+ * required field or its `source` is missing or malformed so {@link
+ * normalizeManagedState} can drop the entry without discarding the rest of the
+ * file.
+ */
+function normalizeManagedRecord(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        return null;
+    }
+    const entry = raw;
+    if (!hasRequiredManagedRecordFields(entry)) {
+        return null;
+    }
+    const source = normalizeManagedSource(entry.source);
+    if (!source) {
+        return null;
+    }
+    return {
+        name: entry.name.trim(),
+        directory: entry.directory.trim(),
+        scope: entry.scope,
+        manifest_version: entry.manifest_version,
+        manifest_entry: entry.manifest_entry,
+        capabilities: normalizeStringList(entry.capabilities),
+        installed_at: entry.installed_at,
+        updated_at: entry.updated_at,
+        source,
+        last_update_check_at: optionalString(entry.last_update_check_at),
+        last_update_remote_commit: optionalString(entry.last_update_remote_commit),
+        update_available: typeof entry.update_available === "boolean" || entry.update_available === null
+            ? entry.update_available
+            : undefined,
+        update_error: optionalString(entry.update_error),
+    };
+}
 /**
  * Implements normalize managed state for the public runtime surface of this module.
  */
@@ -76,65 +171,14 @@ export function normalizeManagedState(raw) {
     }
     const entries = [];
     for (const rawEntry of candidate.entries) {
-        if (typeof rawEntry !== "object" || rawEntry === null) {
-            continue;
-        }
-        const entry = rawEntry;
-        if (typeof entry.name !== "string" ||
-            entry.name.trim().length === 0 ||
-            typeof entry.directory !== "string" ||
-            entry.directory.trim().length === 0 ||
-            (entry.scope !== "project" && entry.scope !== "global") ||
-            typeof entry.manifest_version !== "string" ||
-            typeof entry.manifest_entry !== "string" ||
-            !Array.isArray(entry.capabilities) ||
-            entry.capabilities.some((value) => typeof value !== "string") ||
-            typeof entry.installed_at !== "string" ||
-            typeof entry.updated_at !== "string" ||
-            typeof entry.source !== "object" ||
-            entry.source === null) {
-            continue;
-        }
-        const source = entry.source;
-        if ((source.kind !== "local" && source.kind !== "github" && source.kind !== "npm" && source.kind !== "builtin") ||
-            typeof source.input !== "string" ||
-            typeof source.location !== "string") {
-            continue;
+        const record = normalizeManagedRecord(rawEntry);
+        if (record) {
+            entries.push(record);
         }
-        entries.push({
-            name: entry.name.trim(),
-            directory: entry.directory.trim(),
-            scope: entry.scope,
-            manifest_version: entry.manifest_version,
-            manifest_entry: entry.manifest_entry,
-            capabilities: normalizeStringList(entry.capabilities),
-            installed_at: entry.installed_at,
-            updated_at: entry.updated_at,
-            source: {
-                kind: source.kind,
-                input: source.input,
-                location: source.location,
-                name: typeof source.name === "string" ? source.name : undefined,
-                package: typeof source.package === "string" ? source.package : undefined,
-                version: typeof source.version === "string" ? source.version : undefined,
-                repository: typeof source.repository === "string" ? source.repository : undefined,
-                owner: typeof source.owner === "string" ? source.owner : undefined,
-                repo: typeof source.repo === "string" ? source.repo : undefined,
-                ref: typeof source.ref === "string" ? source.ref : undefined,
-                subpath: typeof source.subpath === "string" ? source.subpath : undefined,
-                commit: typeof source.commit === "string" ? source.commit : undefined,
-            },
-            last_update_check_at: typeof entry.last_update_check_at === "string" ? entry.last_update_check_at : undefined,
-            last_update_remote_commit: typeof entry.last_update_remote_commit === "string" ? entry.last_update_remote_commit : undefined,
-            update_available: typeof entry.update_available === "boolean" || entry.update_available === null
-                ? entry.update_available
-                : undefined,
-            update_error: typeof entry.update_error === "string" ? entry.update_error : undefined,
-        });
     }
     return {
         version: MANAGED_EXTENSION_STATE_VERSION,
-        updated_at: typeof candidate.updated_at === "string" ? candidate.updated_at : nowIso(),
+        updated_at: optionalString(candidate.updated_at) ?? nowIso(),
         entries: sortManagedEntries(entries),
     };
 }
@@ -198,4 +242,4 @@ export function upsertManagedEntry(state, entry) {
     };
 }
 //# sourceMappingURL=managed-state.js.map
-//# debugId=2522dc0e-5909-57da-b8cb-ceb4eac20da2
+//# debugId=0874e784-e274-5edd-8fbf-26d94a6c4a32

package/dist/cli/commands/extension/managed-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"managed-state.js","sources":["cli/commands/extension/managed-state.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/extension/managed-state\n *\n * Implements extension package-management support for Managed State.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { nowIso } from \"../../../core/shared/time.js\";\nimport { normalizeExtensionNameForMatch, normalizeStringList } from \"./shared.js\";\nimport type { ExtensionScope } from \"../extension.js\";\n\nconst MANAGED_EXTENSION_STATE_FILENAME = \".managed-extensions.json\";\nconst MANAGED_EXTENSION_STATE_VERSION = 1;\n\n/**\n * Documents the managed extension source payload exchanged by command, SDK, and package integrations.\n */\nexport interface ManagedExtensionSource {\n  kind: \"local\" | \"github\" | \"npm\" | \"builtin\";\n  input: string;\n  location: string;\n  name?: string;\n  package?: string;\n  version?: string;\n  repository?: string;\n  owner?: string;\n  repo?: string;\n  ref?: string;\n  subpath?: string;\n  commit?: string;\n}\n\n/**\n * Documents the managed extension record payload exchanged by command, SDK, and package integrations.\n */\nexport interface ManagedExtensionRecord {\n  name: string;\n  directory: string;\n  scope: ExtensionScope;\n  manifest_version: string;\n  manifest_entry: string;\n  capabilities: string[];\n  installed_at: string;\n  updated_at: string;\n  source: ManagedExtensionSource;\n  last_update_check_at?: string;\n  last_update_remote_commit?: string;\n  update_available?: boolean | null;\n  update_error?: string;\n}\n\n/**\n * Documents the managed extension state payload exchanged by command, SDK, and package integrations.\n */\nexport interface ManagedExtensionState {\n  version: number;\n  updated_at: string;\n  entries: ManagedExtensionRecord[];\n}\n\n/**\n * Documents the managed extension state read result payload exchanged by command, SDK, and package integrations.\n */\nexport interface ManagedExtensionStateReadResult {\n  path: string;\n  state: ManagedExtensionState;\n  warnings: string[];\n}\n\n/**\n * Implements resolve managed extension state path for the public runtime surface of this module.\n */\nexport function resolveManagedExtensionStatePath(extensionsRoot: string): string {\n  return path.join(extensionsRoot, MANAGED_EXTENSION_STATE_FILENAME);\n}\n\n/**\n * Implements create empty managed extension state for the public runtime surface of this module.\n */\nexport function createEmptyManagedExtensionState(): ManagedExtensionState {\n  return {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: nowIso(),\n    entries: [],\n  };\n}\n\n/**\n * Implements sort managed entries for the public runtime surface of this module.\n */\nexport function sortManagedEntries(entries: ManagedExtensionRecord[]): ManagedExtensionRecord[] {\n  return [...entries].sort((left, right) => {\n    const byScope = left.scope.localeCompare(right.scope);\n    if (byScope !== 0) {\n      return byScope;\n    }\n    const byName = left.name.localeCompare(right.name);\n    if (byName !== 0) {\n      return byName;\n    }\n    return left.directory.localeCompare(right.directory);\n  });\n}\n\n/**\n * Implements managed extension sources equivalent for the public runtime surface of this module.\n */\nexport function managedExtensionSourcesEquivalent(left: ManagedExtensionSource, right: ManagedExtensionSource): boolean {\n  if (left.kind !== right.kind || left.input !== right.input || left.location !== right.location) {\n    return false;\n  }\n  if (left.kind === \"npm\" && right.kind === \"npm\") {\n    return left.package === right.package && left.version === right.version;\n  }\n  if (left.kind === \"github\" && right.kind === \"github\") {\n    return left.repository === right.repository && left.ref === right.ref && left.subpath === right.subpath && left.commit === right.commit;\n  }\n  if (left.kind === \"builtin\" && right.kind === \"builtin\") {\n    return left.name === right.name;\n  }\n  return true;\n}\n\n/**\n * Implements normalize managed state for the public runtime surface of this module.\n */\nexport function normalizeManagedState(raw: unknown): ManagedExtensionState | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (candidate.version !== MANAGED_EXTENSION_STATE_VERSION || !Array.isArray(candidate.entries)) {\n    return null;\n  }\n\n  const entries: ManagedExtensionRecord[] = [];\n  for (const rawEntry of candidate.entries) {\n    if (typeof rawEntry !== \"object\" || rawEntry === null) {\n      continue;\n    }\n    const entry = rawEntry as Record<string, unknown>;\n    if (\n      typeof entry.name !== \"string\" ||\n      entry.name.trim().length === 0 ||\n      typeof entry.directory !== \"string\" ||\n      entry.directory.trim().length === 0 ||\n      (entry.scope !== \"project\" && entry.scope !== \"global\") ||\n      typeof entry.manifest_version !== \"string\" ||\n      typeof entry.manifest_entry !== \"string\" ||\n      !Array.isArray(entry.capabilities) ||\n      entry.capabilities.some((value) => typeof value !== \"string\") ||\n      typeof entry.installed_at !== \"string\" ||\n      typeof entry.updated_at !== \"string\" ||\n      typeof entry.source !== \"object\" ||\n      entry.source === null\n    ) {\n      continue;\n    }\n    const source = entry.source as Record<string, unknown>;\n    if (\n      (source.kind !== \"local\" && source.kind !== \"github\" && source.kind !== \"npm\" && source.kind !== \"builtin\") ||\n      typeof source.input !== \"string\" ||\n      typeof source.location !== \"string\"\n    ) {\n      continue;\n    }\n    entries.push({\n      name: entry.name.trim(),\n      directory: entry.directory.trim(),\n      scope: entry.scope,\n      manifest_version: entry.manifest_version,\n      manifest_entry: entry.manifest_entry,\n      capabilities: normalizeStringList(entry.capabilities as string[]),\n      installed_at: entry.installed_at,\n      updated_at: entry.updated_at,\n      source: {\n        kind: source.kind,\n        input: source.input,\n        location: source.location,\n        name: typeof source.name === \"string\" ? source.name : undefined,\n        package: typeof source.package === \"string\" ? source.package : undefined,\n        version: typeof source.version === \"string\" ? source.version : undefined,\n        repository: typeof source.repository === \"string\" ? source.repository : undefined,\n        owner: typeof source.owner === \"string\" ? source.owner : undefined,\n        repo: typeof source.repo === \"string\" ? source.repo : undefined,\n        ref: typeof source.ref === \"string\" ? source.ref : undefined,\n        subpath: typeof source.subpath === \"string\" ? source.subpath : undefined,\n        commit: typeof source.commit === \"string\" ? source.commit : undefined,\n      },\n      last_update_check_at: typeof entry.last_update_check_at === \"string\" ? entry.last_update_check_at : undefined,\n      last_update_remote_commit:\n        typeof entry.last_update_remote_commit === \"string\" ? entry.last_update_remote_commit : undefined,\n      update_available:\n        typeof entry.update_available === \"boolean\" || entry.update_available === null\n          ? entry.update_available\n          : undefined,\n      update_error: typeof entry.update_error === \"string\" ? entry.update_error : undefined,\n    });\n  }\n  return {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: typeof candidate.updated_at === \"string\" ? candidate.updated_at : nowIso(),\n    entries: sortManagedEntries(entries),\n  };\n}\n\n/**\n * Implements read managed extension state for the public runtime surface of this module.\n */\nexport async function readManagedExtensionState(extensionsRoot: string): Promise<ManagedExtensionStateReadResult> {\n  const statePath = resolveManagedExtensionStatePath(extensionsRoot);\n  const fallback = createEmptyManagedExtensionState();\n  try {\n    const raw = await fs.readFile(statePath, \"utf8\");\n    const parsed = JSON.parse(raw) as unknown;\n    const normalized = normalizeManagedState(parsed);\n    if (!normalized) {\n      throw new PmCliError(\n        `Managed extension state file \"${statePath}\" has an invalid schema. Repair or remove it before mutating extension state.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    return {\n      path: statePath,\n      state: normalized,\n      warnings: [],\n    };\n  } catch (error: unknown) {\n    if (error instanceof PmCliError) {\n      throw error;\n    }\n    if (typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === \"ENOENT\") {\n      return {\n        path: statePath,\n        state: fallback,\n        warnings: [],\n      };\n    }\n    throw new PmCliError(\n      `Managed extension state file \"${statePath}\" could not be read. Repair or remove it before mutating extension state.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\n/**\n * Implements write managed extension state for the public runtime surface of this module.\n */\nexport async function writeManagedExtensionState(extensionsRoot: string, state: ManagedExtensionState): Promise<void> {\n  const statePath = resolveManagedExtensionStatePath(extensionsRoot);\n  const normalized: ManagedExtensionState = {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: nowIso(),\n    entries: sortManagedEntries(state.entries),\n  };\n  await fs.mkdir(extensionsRoot, { recursive: true });\n  await fs.writeFile(statePath, `${JSON.stringify(normalized, null, 2)}\\n`, \"utf8\");\n}\n\n\n/**\n * Implements upsert managed entry for the public runtime surface of this module.\n */\nexport function upsertManagedEntry(state: ManagedExtensionState, entry: ManagedExtensionRecord): ManagedExtensionState {\n  const updatedEntries = state.entries.filter(\n    (candidate) =>\n      normalizeExtensionNameForMatch(candidate.name) !== normalizeExtensionNameForMatch(entry.name) &&\n      normalizeExtensionNameForMatch(candidate.directory) !== normalizeExtensionNameForMatch(entry.directory),\n  );\n  updatedEntries.push(entry);\n  return {\n    ...state,\n    updated_at: nowIso(),\n    entries: sortManagedEntries(updatedEntries),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"2522dc0e-5909-57da-b8cb-ceb4eac20da2"}
+{"version":3,"file":"managed-state.js","sources":["cli/commands/extension/managed-state.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/extension/managed-state\n *\n * Implements extension package-management support for Managed State.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { nowIso } from \"../../../core/shared/time.js\";\nimport { normalizeExtensionNameForMatch, normalizeStringList } from \"./shared.js\";\nimport type { ExtensionScope } from \"../extension.js\";\n\nconst MANAGED_EXTENSION_STATE_FILENAME = \".managed-extensions.json\";\nconst MANAGED_EXTENSION_STATE_VERSION = 1;\n\n/**\n * Documents the managed extension source payload exchanged by command, SDK, and package integrations.\n */\nexport interface ManagedExtensionSource {\n  kind: \"local\" | \"github\" | \"npm\" | \"builtin\";\n  input: string;\n  location: string;\n  name?: string;\n  package?: string;\n  version?: string;\n  repository?: string;\n  owner?: string;\n  repo?: string;\n  ref?: string;\n  subpath?: string;\n  commit?: string;\n}\n\n/**\n * Documents the managed extension record payload exchanged by command, SDK, and package integrations.\n */\nexport interface ManagedExtensionRecord {\n  name: string;\n  directory: string;\n  scope: ExtensionScope;\n  manifest_version: string;\n  manifest_entry: string;\n  capabilities: string[];\n  installed_at: string;\n  updated_at: string;\n  source: ManagedExtensionSource;\n  last_update_check_at?: string;\n  last_update_remote_commit?: string;\n  update_available?: boolean | null;\n  update_error?: string;\n}\n\n/**\n * Documents the managed extension state payload exchanged by command, SDK, and package integrations.\n */\nexport interface ManagedExtensionState {\n  version: number;\n  updated_at: string;\n  entries: ManagedExtensionRecord[];\n}\n\n/**\n * Documents the managed extension state read result payload exchanged by command, SDK, and package integrations.\n */\nexport interface ManagedExtensionStateReadResult {\n  path: string;\n  state: ManagedExtensionState;\n  warnings: string[];\n}\n\n/**\n * Implements resolve managed extension state path for the public runtime surface of this module.\n */\nexport function resolveManagedExtensionStatePath(extensionsRoot: string): string {\n  return path.join(extensionsRoot, MANAGED_EXTENSION_STATE_FILENAME);\n}\n\n/**\n * Implements create empty managed extension state for the public runtime surface of this module.\n */\nexport function createEmptyManagedExtensionState(): ManagedExtensionState {\n  return {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: nowIso(),\n    entries: [],\n  };\n}\n\n/**\n * Implements sort managed entries for the public runtime surface of this module.\n */\nexport function sortManagedEntries(entries: ManagedExtensionRecord[]): ManagedExtensionRecord[] {\n  return [...entries].sort((left, right) => {\n    const byScope = left.scope.localeCompare(right.scope);\n    if (byScope !== 0) {\n      return byScope;\n    }\n    const byName = left.name.localeCompare(right.name);\n    if (byName !== 0) {\n      return byName;\n    }\n    return left.directory.localeCompare(right.directory);\n  });\n}\n\n/**\n * Implements managed extension sources equivalent for the public runtime surface of this module.\n */\nexport function managedExtensionSourcesEquivalent(left: ManagedExtensionSource, right: ManagedExtensionSource): boolean {\n  if (left.kind !== right.kind || left.input !== right.input || left.location !== right.location) {\n    return false;\n  }\n  if (left.kind === \"npm\" && right.kind === \"npm\") {\n    return left.package === right.package && left.version === right.version;\n  }\n  if (left.kind === \"github\" && right.kind === \"github\") {\n    return left.repository === right.repository && left.ref === right.ref && left.subpath === right.subpath && left.commit === right.commit;\n  }\n  if (left.kind === \"builtin\" && right.kind === \"builtin\") {\n    return left.name === right.name;\n  }\n  return true;\n}\n\n/**\n * Narrow `value` to a string, or `undefined` for any other type — the\n * normalization applied to every optional managed-state string field so an\n * absent or malformed value is dropped rather than carried through as `unknown`.\n */\nfunction optionalString(value: unknown): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n\n/**\n * Type guard asserting `entry` carries every always-present managed-record field\n * with the right primitive type: a non-empty `name`/`directory`, a known\n * {@link ExtensionScope}, string manifest metadata, a `string[]` capability\n * list, and string `installed_at`/`updated_at` timestamps. The optional columns\n * (`source` plus the update-check fields) are validated separately by the\n * caller, so this guard narrows only the required columns.\n */\nfunction hasRequiredManagedRecordFields(\n  entry: Record<string, unknown>,\n): entry is Record<string, unknown> &\n  Pick<\n    ManagedExtensionRecord,\n    \"name\" | \"directory\" | \"scope\" | \"manifest_version\" | \"manifest_entry\" | \"capabilities\" | \"installed_at\" | \"updated_at\"\n  > {\n  return (\n    typeof entry.name === \"string\" &&\n    entry.name.trim().length > 0 &&\n    typeof entry.directory === \"string\" &&\n    entry.directory.trim().length > 0 &&\n    (entry.scope === \"project\" || entry.scope === \"global\") &&\n    typeof entry.manifest_version === \"string\" &&\n    typeof entry.manifest_entry === \"string\" &&\n    Array.isArray(entry.capabilities) &&\n    entry.capabilities.every((value): value is string => typeof value === \"string\") &&\n    typeof entry.installed_at === \"string\" &&\n    typeof entry.updated_at === \"string\"\n  );\n}\n\n/**\n * Normalize one persisted managed-extension source object, returning `null` when\n * the discriminant (`kind`) or the required `input`/`location` strings are\n * missing or malformed so the caller can skip the owning record.\n */\nfunction normalizeManagedSource(raw: unknown): ManagedExtensionSource | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const source = raw as Record<string, unknown>;\n  if (\n    (source.kind !== \"local\" && source.kind !== \"github\" && source.kind !== \"npm\" && source.kind !== \"builtin\") ||\n    typeof source.input !== \"string\" ||\n    typeof source.location !== \"string\"\n  ) {\n    return null;\n  }\n  return {\n    kind: source.kind,\n    input: source.input,\n    location: source.location,\n    name: optionalString(source.name),\n    package: optionalString(source.package),\n    version: optionalString(source.version),\n    repository: optionalString(source.repository),\n    owner: optionalString(source.owner),\n    repo: optionalString(source.repo),\n    ref: optionalString(source.ref),\n    subpath: optionalString(source.subpath),\n    commit: optionalString(source.commit),\n  };\n}\n\n/**\n * Normalize one persisted managed-extension record, returning `null` when any\n * required field or its `source` is missing or malformed so {@link\n * normalizeManagedState} can drop the entry without discarding the rest of the\n * file.\n */\nfunction normalizeManagedRecord(raw: unknown): ManagedExtensionRecord | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const entry = raw as Record<string, unknown>;\n  if (!hasRequiredManagedRecordFields(entry)) {\n    return null;\n  }\n  const source = normalizeManagedSource(entry.source);\n  if (!source) {\n    return null;\n  }\n  return {\n    name: entry.name.trim(),\n    directory: entry.directory.trim(),\n    scope: entry.scope,\n    manifest_version: entry.manifest_version,\n    manifest_entry: entry.manifest_entry,\n    capabilities: normalizeStringList(entry.capabilities),\n    installed_at: entry.installed_at,\n    updated_at: entry.updated_at,\n    source,\n    last_update_check_at: optionalString(entry.last_update_check_at),\n    last_update_remote_commit: optionalString(entry.last_update_remote_commit),\n    update_available:\n      typeof entry.update_available === \"boolean\" || entry.update_available === null\n        ? entry.update_available\n        : undefined,\n    update_error: optionalString(entry.update_error),\n  };\n}\n\n/**\n * Implements normalize managed state for the public runtime surface of this module.\n */\nexport function normalizeManagedState(raw: unknown): ManagedExtensionState | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (candidate.version !== MANAGED_EXTENSION_STATE_VERSION || !Array.isArray(candidate.entries)) {\n    return null;\n  }\n\n  const entries: ManagedExtensionRecord[] = [];\n  for (const rawEntry of candidate.entries) {\n    const record = normalizeManagedRecord(rawEntry);\n    if (record) {\n      entries.push(record);\n    }\n  }\n  return {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: optionalString(candidate.updated_at) ?? nowIso(),\n    entries: sortManagedEntries(entries),\n  };\n}\n\n/**\n * Implements read managed extension state for the public runtime surface of this module.\n */\nexport async function readManagedExtensionState(extensionsRoot: string): Promise<ManagedExtensionStateReadResult> {\n  const statePath = resolveManagedExtensionStatePath(extensionsRoot);\n  const fallback = createEmptyManagedExtensionState();\n  try {\n    const raw = await fs.readFile(statePath, \"utf8\");\n    const parsed = JSON.parse(raw) as unknown;\n    const normalized = normalizeManagedState(parsed);\n    if (!normalized) {\n      throw new PmCliError(\n        `Managed extension state file \"${statePath}\" has an invalid schema. Repair or remove it before mutating extension state.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    return {\n      path: statePath,\n      state: normalized,\n      warnings: [],\n    };\n  } catch (error: unknown) {\n    if (error instanceof PmCliError) {\n      throw error;\n    }\n    if (typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === \"ENOENT\") {\n      return {\n        path: statePath,\n        state: fallback,\n        warnings: [],\n      };\n    }\n    throw new PmCliError(\n      `Managed extension state file \"${statePath}\" could not be read. Repair or remove it before mutating extension state.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\n/**\n * Implements write managed extension state for the public runtime surface of this module.\n */\nexport async function writeManagedExtensionState(extensionsRoot: string, state: ManagedExtensionState): Promise<void> {\n  const statePath = resolveManagedExtensionStatePath(extensionsRoot);\n  const normalized: ManagedExtensionState = {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: nowIso(),\n    entries: sortManagedEntries(state.entries),\n  };\n  await fs.mkdir(extensionsRoot, { recursive: true });\n  await fs.writeFile(statePath, `${JSON.stringify(normalized, null, 2)}\\n`, \"utf8\");\n}\n\n\n/**\n * Implements upsert managed entry for the public runtime surface of this module.\n */\nexport function upsertManagedEntry(state: ManagedExtensionState, entry: ManagedExtensionRecord): ManagedExtensionState {\n  const updatedEntries = state.entries.filter(\n    (candidate) =>\n      normalizeExtensionNameForMatch(candidate.name) !== normalizeExtensionNameForMatch(entry.name) &&\n      normalizeExtensionNameForMatch(candidate.directory) !== normalizeExtensionNameForMatch(entry.directory),\n  );\n  updatedEntries.push(entry);\n  return {\n    ...state,\n    updated_at: nowIso(),\n    entries: sortManagedEntries(updatedEntries),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"0874e784-e274-5edd-8fbf-26d94a6c4a32"}

package/dist/cli/commands/extension/scaffold.d.ts

@@ -1,12 +1,22 @@
+export declare const SCAFFOLD_PM_MIN_VERSION = "2026.6.24";
 /**
  * Capability shapes the package/extension scaffolder can target via the
- * `--capability` selector. `commands` emits the default command-only starter;
- * `hooks` additionally wires an `after_command` lifecycle reactor, `search`
- * wires an in-memory provider/adapter pair, and `importers` wires importer and
- * exporter command primitives so authors can customize project context movement
- * without starting from a blank extension.
+ * `--capability` selector — one per SDK extension capability, so every
+ * registration surface has a runnable starter. `commands` emits the default
+ * command-only starter; `hooks` additionally wires an `after_command` lifecycle
+ * reactor; `search` wires an in-memory provider/adapter pair; `importers` wires
+ * importer and exporter command primitives so authors can customize project
+ * context movement; `schema` registers a custom item type, item field, and
+ * migration so authors can model their own project domain; `profile` registers a
+ * complete project-profile archetype (item types, statuses, fields, a workflow,
+ * config, a template, and package recommendations) via `api.registerProfile` so
+ * `pm profile apply` can tailor a tracker in one shot; `renderers` overrides how
+ * a command's output is serialized for a format; `parser` rewrites a command's
+ * parsed options before its handler runs; `preflight` adjusts pm's pre-run
+ * migration/format gate decision; and `services` overrides a built-in pm service
+ * (e.g. output formatting) — without starting from a blank extension.
  */
-export declare const SCAFFOLD_CAPABILITIES: readonly ["commands", "hooks", "search", "importers"];
+export declare const SCAFFOLD_CAPABILITIES: readonly ["commands", "hooks", "search", "importers", "schema", "profile", "renderers", "parser", "preflight", "services"];
 /**
  * Restricts the `--capability` selector to a {@link SCAFFOLD_CAPABILITIES} value.
  */
@@ -19,16 +29,36 @@ interface ExtensionScaffoldResult {
     extension_name: string;
     command_name: string;
     capability: ExtensionScaffoldCapability;
+    /**
+     * Authoring style of the generated entrypoint: `"imperative"` (a hand-written
+     * `activate` body, the default) or `"declarative"` (a `composeExtension`
+     * blueprint). The declarative style is package-mode only (any capability).
+     */
+    style: ExtensionScaffoldStyle;
     target_path: string;
     created_directory: boolean;
     files: ExtensionScaffoldFileResult[];
 }
+/**
+ * Authoring style the scaffolder targets for the generated entrypoint. The
+ * default `"imperative"` emits a hand-written `activate` body; `"declarative"`
+ * emits the SDK's `composeExtension` blueprint loop (package-mode only, for any
+ * capability — see {@link buildDeclarativeEntrypoint}).
+ */
+export type ExtensionScaffoldStyle = "imperative" | "declarative";
+/**
+ * Builds the starter command path from the normalized package/extension name.
+ * Names that start with a built-in pm command or executable alias are prefixed
+ * with `starter` so the generated command dispatches to the package instead of
+ * being consumed by core command parsing.
+ */
+export declare function buildScaffoldCommandName(extensionName: string): string;
 /**
  * Implements build starter extension scaffold files for the public runtime surface of this module.
  */
-export declare function buildStarterExtensionScaffoldFiles(extensionName: string, commandName: string, vocabulary: "extension" | "package", capability?: ExtensionScaffoldCapability): Record<string, string>;
+export declare function buildStarterExtensionScaffoldFiles(extensionName: string, commandName: string, vocabulary: "extension" | "package", capability?: ExtensionScaffoldCapability, declarative?: boolean): Record<string, string>;
 /**
  * Implements scaffold extension project for the public runtime surface of this module.
  */
-export declare function scaffoldExtensionProject(target: string, vocabulary?: "extension" | "package", capability?: string): Promise<ExtensionScaffoldResult>;
+export declare function scaffoldExtensionProject(target: string, vocabulary?: "extension" | "package", capability?: string, declarative?: boolean): Promise<ExtensionScaffoldResult>;
 export {};