@unbrained/pm-cli 2026.7.14 → 2026.7.16

package/dist/cli/commands/extension/shared.js

@@ -1,132 +1,6 @@
-/**
- * @module cli/commands/extension/shared
- *
- * Implements extension package-management support for Shared.
- */
+/** Compatibility exports for SDK-owned extension helpers. */
 
-!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]="c2f4d73a-8980-5fa4-9f38-2f22f35ca950")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { pathExists } from "../../../core/fs/fs-utils.js";
-import { isPathWithinDirectory } from "../../../core/fs/path-utils.js";
-import { EXIT_CODE } from "../../../core/shared/constants.js";
-import { PmCliError } from "../../../core/shared/errors.js";
-import { DEFAULT_EXTENSION_PRIORITY, isCanonicalPathWithinDirectory, } from "../../../core/extensions/loader.js";
-export { DEFAULT_EXTENSION_PRIORITY, isCanonicalPathWithinDirectory };
-/** Implements normalize string list for the public runtime surface of this module. */
-export function normalizeStringList(values) {
-    return [
-        ...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0)),
-    ].sort((left, right) => left.localeCompare(right));
-}
-/** Implements normalize extension name for match for the public runtime surface of this module. */
-export function normalizeExtensionNameForMatch(value) {
-    return value.trim().toLowerCase();
-}
-/** Implements normalize managed directory name for the public runtime surface of this module. */
-export function normalizeManagedDirectoryName(name) {
-    const normalized = name
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9._-]+/g, "-")
-        .replace(/^-+|-+$/g, "");
-    if (normalized.length === 0) {
-        throw new PmCliError("Extension manifest name must resolve to a non-empty directory name.", EXIT_CODE.USAGE);
-    }
-    if (normalized === "." || normalized === "..") {
-        // Manifest-controlled input must resolve to a dedicated child directory, never
-        // the extensions root itself or its parent (path-traversal guard).
-        throw new PmCliError('Extension manifest name must not resolve to "." or "..".', EXIT_CODE.USAGE);
-    }
-    return normalized;
-}
-function parseOptionalManifestPriority(value) {
-    if (value === undefined || value === null) {
-        return DEFAULT_EXTENSION_PRIORITY;
-    }
-    return typeof value === "number" && Number.isInteger(value) ? value : null;
-}
-function parseOptionalManifestCapabilities(value) {
-    if (value === undefined || value === null) {
-        return [];
-    }
-    if (!Array.isArray(value) ||
-        value.some((entry) => typeof entry !== "string")) {
-        return null;
-    }
-    return normalizeStringList(value.map((entry) => String(entry).toLowerCase()));
-}
-/** Implements parse extension manifest for the public runtime surface of this module. */
-export function parseExtensionManifest(raw) {
-    if (typeof raw !== "object" || raw === null) {
-        return null;
-    }
-    const candidate = raw;
-    if (typeof candidate.name !== "string" ||
-        candidate.name.trim().length === 0) {
-        return null;
-    }
-    if (typeof candidate.version !== "string" ||
-        candidate.version.trim().length === 0) {
-        return null;
-    }
-    if (typeof candidate.entry !== "string" ||
-        candidate.entry.trim().length === 0) {
-        return null;
-    }
-    const priority = parseOptionalManifestPriority(candidate.priority);
-    const capabilities = parseOptionalManifestCapabilities(candidate.capabilities);
-    if (priority === null || capabilities === null) {
-        return null;
-    }
-    return {
-        name: candidate.name.trim(),
-        version: candidate.version.trim(),
-        entry: candidate.entry.trim(),
-        priority,
-        capabilities,
-    };
-}
-/** Implements validate extension directory for the public runtime surface of this module. */
-export async function validateExtensionDirectory(directory) {
-    const manifestPath = path.join(directory, "manifest.json");
-    if (!(await pathExists(manifestPath))) {
-        throw new PmCliError(`Extension manifest is missing at "${manifestPath}".`, EXIT_CODE.USAGE);
-    }
-    let parsedManifest;
-    try {
-        parsedManifest = JSON.parse(await fs.readFile(manifestPath, "utf8"));
-    }
-    catch (error) {
-        throw new PmCliError(`Failed to parse extension manifest at "${manifestPath}": ${formatManifestReadError(error)}`, EXIT_CODE.USAGE);
-    }
-    const manifest = parseExtensionManifest(parsedManifest);
-    if (!manifest) {
-        throw new PmCliError(`Extension manifest at "${manifestPath}" is invalid.`, EXIT_CODE.USAGE);
-    }
-    const entryPath = path.resolve(directory, manifest.entry);
-    if (!isPathWithinDirectory(directory, entryPath)) {
-        throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory "${directory}".`, EXIT_CODE.USAGE);
-    }
-    if (!(await pathExists(entryPath))) {
-        throw new PmCliError(`Extension entry file is missing at "${entryPath}".`, EXIT_CODE.USAGE);
-    }
-    if (!(await isCanonicalPathWithinDirectory(directory, entryPath))) {
-        throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory after symlink resolution.`, EXIT_CODE.USAGE);
-    }
-    return {
-        directory,
-        manifest_path: manifestPath,
-        entry_path: entryPath,
-        manifest,
-    };
-}
-function formatManifestReadError(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-/** Public contract for test only extension shared, shared by SDK and presentation-layer consumers. */
-export const _testOnlyExtensionShared = {
-    formatManifestReadError,
-};
+!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]="7bcb2c6c-3b04-5a62-8863-3596d9f0f7ac")}catch(e){}}();
+export * from "../../../sdk/extension/shared.js";
 //# sourceMappingURL=shared.js.map
-//# debugId=c2f4d73a-8980-5fa4-9f38-2f22f35ca950
+//# debugId=7bcb2c6c-3b04-5a62-8863-3596d9f0f7ac

package/dist/cli/commands/extension/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sources":["cli/commands/extension/shared.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/extension/shared\n *\n * Implements extension package-management support for Shared.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport {\n  DEFAULT_EXTENSION_PRIORITY,\n  isCanonicalPathWithinDirectory,\n  type ExtensionManifest,\n} from \"../../../core/extensions/loader.js\";\n\nexport { DEFAULT_EXTENSION_PRIORITY, isCanonicalPathWithinDirectory };\n\n/** Documents the validated extension directory payload exchanged by command, SDK, and package integrations. */\nexport interface ValidatedExtensionDirectory {\n  /** Value that configures or reports directory for this contract. */\n  directory: string;\n  /** Filesystem path used for manifest resolution. */\n  manifest_path: string;\n  /** Filesystem path used for entry resolution. */\n  entry_path: string;\n  /** Declarative package manifest consumed by the extension loader. */\n  manifest: ExtensionManifest;\n}\n\n/** Implements normalize string list for the public runtime surface of this module. */\nexport function normalizeStringList(values: readonly string[]): string[] {\n  return [\n    ...new Set(\n      values.map((value) => value.trim()).filter((value) => value.length > 0),\n    ),\n  ].sort((left, right) => left.localeCompare(right));\n}\n\n/** Implements normalize extension name for match for the public runtime surface of this module. */\nexport function normalizeExtensionNameForMatch(value: string): string {\n  return value.trim().toLowerCase();\n}\n\n/** Implements normalize managed directory name for the public runtime surface of this module. */\nexport function normalizeManagedDirectoryName(name: string): string {\n  const normalized = name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  if (normalized.length === 0) {\n    throw new PmCliError(\n      \"Extension manifest name must resolve to a non-empty directory name.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (normalized === \".\" || normalized === \"..\") {\n    // Manifest-controlled input must resolve to a dedicated child directory, never\n    // the extensions root itself or its parent (path-traversal guard).\n    throw new PmCliError(\n      'Extension manifest name must not resolve to \".\" or \"..\".',\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n}\n\nfunction parseOptionalManifestPriority(value: unknown): number | null {\n  if (value === undefined || value === null) {\n    return DEFAULT_EXTENSION_PRIORITY;\n  }\n  return typeof value === \"number\" && Number.isInteger(value) ? value : null;\n}\n\nfunction parseOptionalManifestCapabilities(value: unknown): string[] | null {\n  if (value === undefined || value === null) {\n    return [];\n  }\n  if (\n    !Array.isArray(value) ||\n    value.some((entry) => typeof entry !== \"string\")\n  ) {\n    return null;\n  }\n  return normalizeStringList(value.map((entry) => String(entry).toLowerCase()));\n}\n\n/** Implements parse extension manifest for the public runtime surface of this module. */\nexport function parseExtensionManifest(raw: unknown): ExtensionManifest | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (\n    typeof candidate.name !== \"string\" ||\n    candidate.name.trim().length === 0\n  ) {\n    return null;\n  }\n  if (\n    typeof candidate.version !== \"string\" ||\n    candidate.version.trim().length === 0\n  ) {\n    return null;\n  }\n  if (\n    typeof candidate.entry !== \"string\" ||\n    candidate.entry.trim().length === 0\n  ) {\n    return null;\n  }\n\n  const priority = parseOptionalManifestPriority(candidate.priority);\n  const capabilities = parseOptionalManifestCapabilities(\n    candidate.capabilities,\n  );\n  if (priority === null || capabilities === null) {\n    return null;\n  }\n\n  return {\n    name: candidate.name.trim(),\n    version: candidate.version.trim(),\n    entry: candidate.entry.trim(),\n    priority,\n    capabilities,\n  };\n}\n\n/** Implements validate extension directory for the public runtime surface of this module. */\nexport async function validateExtensionDirectory(\n  directory: string,\n): Promise<ValidatedExtensionDirectory> {\n  const manifestPath = path.join(directory, \"manifest.json\");\n  if (!(await pathExists(manifestPath))) {\n    throw new PmCliError(\n      `Extension manifest is missing at \"${manifestPath}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let parsedManifest: unknown;\n  try {\n    parsedManifest = JSON.parse(\n      await fs.readFile(manifestPath, \"utf8\"),\n    ) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Failed to parse extension manifest at \"${manifestPath}\": ${formatManifestReadError(error)}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const manifest = parseExtensionManifest(parsedManifest);\n  if (!manifest) {\n    throw new PmCliError(\n      `Extension manifest at \"${manifestPath}\" is invalid.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const entryPath = path.resolve(directory, manifest.entry);\n  if (!isPathWithinDirectory(directory, entryPath)) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory \"${directory}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!(await pathExists(entryPath))) {\n    throw new PmCliError(\n      `Extension entry file is missing at \"${entryPath}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!(await isCanonicalPathWithinDirectory(directory, entryPath))) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory after symlink resolution.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  return {\n    directory,\n    manifest_path: manifestPath,\n    entry_path: entryPath,\n    manifest,\n  };\n}\n\nfunction formatManifestReadError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Public contract for test only extension shared, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyExtensionShared = {\n  formatManifestReadError,\n};\n"],"names":[],"mappings":"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","debugId":"c2f4d73a-8980-5fa4-9f38-2f22f35ca950"}
+{"version":3,"file":"shared.js","sources":["cli/commands/extension/shared.ts"],"sourceRoot":"/","sourcesContent":["/** Compatibility exports for SDK-owned extension helpers. */\nexport * from \"../../../sdk/extension/shared.js\";\n"],"names":[],"mappings":"AAAA,6DAA6D;;;AAC7D,cAAc,kCAAkC,CAAC","debugId":"7bcb2c6c-3b04-5a62-8863-3596d9f0f7ac"}

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

@@ -1,403 +1,6 @@
-import fs from "node:fs/promises";
-import { activateExtensions, loadExtensions } from "../../core/extensions/index.js";
-import type { GlobalOptions } from "../../core/shared/command-types.js";
-import type { PmSettings } from "../../types/index.js";
-import { parseExtensionManifest, validateExtensionDirectory } from "./extension/shared.js";
-import { readManagedExtensionState, writeManagedExtensionState, resolveManagedExtensionStatePath, type ManagedExtensionSource, type ManagedExtensionRecord, type ManagedExtensionState } from "./extension/managed-state.js";
-import { parseExtensionInstallSource, runGitCommand } from "./extension/install-sources.js";
-export { parseExtensionManifest, validateExtensionDirectory, readManagedExtensionState, writeManagedExtensionState, resolveManagedExtensionStatePath, parseExtensionInstallSource, };
-export type { ManagedExtensionSource, ManagedExtensionRecord, ManagedExtensionState, };
-export type { ManagedExtensionStateReadResult } from "./extension/managed-state.js";
-/** Restricts extension command action values accepted by command, SDK, and storage contracts. */
-export type ExtensionCommandAction = "install" | "uninstall" | "explore" | "manage" | "describe" | "reload" | "doctor" | "catalog" | "adopt" | "adopt-all" | "activate" | "deactivate" | "init";
-/** Restricts extension scope values accepted by command, SDK, and storage contracts. */
-export type ExtensionScope = "project" | "global";
-/** Restricts extension activation status values accepted by command, SDK, and storage contracts. */
-export type ExtensionActivationStatus = "ok" | "failed" | "not_loaded" | "unknown";
-/** Documents the extension command options payload exchanged by command, SDK, and package integrations. */
-export interface ExtensionCommandOptions {
-    /** Value that configures or reports install for this contract. */
-    install?: boolean;
-    /** Value that configures or reports uninstall for this contract. */
-    uninstall?: boolean;
-    /** Value that configures or reports explore for this contract. */
-    explore?: boolean;
-    /** Value that configures or reports manage for this contract. */
-    manage?: boolean;
-    /** Value that configures or reports describe for this contract. */
-    describe?: boolean;
-    /** Value that configures or reports markdown for this contract. */
-    markdown?: boolean;
-    /** Value that configures or reports output for this contract. */
-    output?: string;
-    /** Value that configures or reports reload for this contract. */
-    reload?: boolean;
-    /** Value that configures or reports doctor for this contract. */
-    doctor?: boolean;
-    /** Value that configures or reports catalog for this contract. */
-    catalog?: boolean;
-    /** Value that configures or reports init for this contract. */
-    init?: boolean;
-    /** Value that configures or reports scaffold for this contract. */
-    scaffold?: boolean;
-    /** Value that configures or reports strict exit for this contract. */
-    strictExit?: boolean;
-    /** Value that configures or reports fail on warn for this contract. */
-    failOnWarn?: boolean;
-    /** Value that configures or reports adopt for this contract. */
-    adopt?: boolean;
-    /** Value that configures or reports adopt all for this contract. */
-    adoptAll?: boolean;
-    /** Registers this package's commands, actions, and runtime hooks with the host. */
-    activate?: boolean;
-    /** Value that configures or reports deactivate for this contract. */
-    deactivate?: boolean;
-    /** Value that configures or reports project for this contract. */
-    project?: boolean;
-    /** Value that configures or reports local for this contract. */
-    local?: boolean;
-    /** Value that configures or reports global for this contract. */
-    global?: boolean;
-    /** Value that configures or reports gh for this contract. */
-    gh?: string;
-    /** Value that configures or reports github for this contract. */
-    github?: string;
-    /** Value that configures or reports ref for this contract. */
-    ref?: string;
-    /** Value that configures or reports detail for this contract. */
-    detail?: string;
-    /** Value that configures or reports trace for this contract. */
-    trace?: boolean;
-    /** Value that configures or reports watch for this contract. */
-    watch?: boolean;
-    /** Value that configures or reports runtime probe for this contract. */
-    runtimeProbe?: boolean;
-    /** Value that configures or reports fix managed state for this contract. */
-    fixManagedState?: boolean;
-    /** Value that configures or reports isolated for this contract. */
-    isolated?: boolean;
-    /** Value that configures or reports ignore global for this contract. */
-    ignoreGlobal?: boolean;
-    /** Value that configures or reports fields for this contract. */
-    fields?: string;
-    /** Value that configures or reports capability for this contract. */
-    capability?: string;
-    /** Value that configures or reports declarative for this contract. */
-    declarative?: boolean;
-    /** Value that configures or reports vocabulary for this contract. */
-    vocabulary?: "extension" | "package";
-}
-/** Documents the managed extension summary payload exchanged by command, SDK, and package integrations. */
-export interface ManagedExtensionSummary {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports directory for this contract. */
-    directory: string;
-    /** Value that configures or reports version for this contract. */
-    version: string;
-    /** Value that configures or reports entry for this contract. */
-    entry: string;
-    /** Value that configures or reports scope for this contract. */
-    scope: ExtensionScope;
-    /** Value that configures or reports active for this contract. */
-    active: boolean;
-    /** Whether enabled applies to this operation. */
-    enabled: boolean;
-    /** Value that configures or reports runtime active for this contract. */
-    runtime_active: boolean | null;
-    /** Lifecycle state reported for activationthe record. */
-    activation_status: ExtensionActivationStatus;
-    /** Value that configures or reports command paths for this contract. */
-    command_paths?: string[];
-    /** Value that configures or reports action paths for this contract. */
-    action_paths?: string[];
-    /** Value that configures or reports managed for this contract. */
-    managed: boolean;
-    /** Value that configures or reports source for this contract. */
-    source?: ManagedExtensionSource;
-    /** Value that configures or reports update available for this contract. */
-    update_available?: boolean | null;
-    /** ISO 8601 timestamp recording when last update check occurred. */
-    last_update_check_at?: string;
-    /** Value that configures or reports last update remote commit for this contract. */
-    last_update_remote_commit?: string;
-    /** Value that configures or reports update error for this contract. */
-    update_error?: string;
-    /** Lifecycle state reported for update checkthe record. */
-    update_check_status: ExtensionUpdateCheckStatus;
-    /** Value that configures or reports update check reason for this contract. */
-    update_check_reason: string;
-}
-/** Documents the extension command result payload exchanged by command, SDK, and package integrations. */
-export interface ExtensionCommandResult {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Value that configures or reports action for this contract. */
-    action: ExtensionCommandAction;
-    /** Value that configures or reports scope for this contract. */
-    scope: ExtensionScope;
-    /** Value that configures or reports roots for this contract. */
-    roots: {
-        project: string;
-        global: string;
-        selected: string;
-        settings_root: string;
-    };
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports details for this contract. */
-    details: Record<string, unknown>;
-}
-/** Documents the extension triage summary payload exchanged by command, SDK, and package integrations. */
-export interface ExtensionTriageSummary {
-    /** Lifecycle state reported for status. */
-    status: "ok" | "warn";
-    /** Number of warning entries represented by this result. */
-    warning_count: number;
-    /** Value that configures or reports warning codes for this contract. */
-    warning_codes: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Number of policy warning entries represented by this result. */
-    policy_warning_count: number;
-    /** Number of policy violation entries represented by this result. */
-    policy_violation_count: number;
-    /** Number of policy blocked entries represented by this result. */
-    policy_blocked_count: number;
-    /** Value that configures or reports total extensions for this contract. */
-    total_extensions: number;
-    /** Value that configures or reports managed total for this contract. */
-    managed_total: number;
-    /** Value that configures or reports enabled total for this contract. */
-    enabled_total: number;
-    /** Value that configures or reports active total for this contract. */
-    active_total: number;
-    /** Value that configures or reports update available total for this contract. */
-    update_available_total: number;
-    /** Value that configures or reports update health coverage for this contract. */
-    update_health_coverage: "full" | "partial";
-    /** Value that configures or reports update health partial for this contract. */
-    update_health_partial: boolean;
-    /** Number of unmanaged loaded extension entries represented by this result. */
-    unmanaged_loaded_extension_count: number;
-    /** Value that configures or reports unmanaged loaded extensions for this contract. */
-    unmanaged_loaded_extensions: string[];
-    /** Number of unmanaged expected extension entries represented by this result. */
-    unmanaged_expected_extension_count: number;
-    /** Value that configures or reports unmanaged expected extensions for this contract. */
-    unmanaged_expected_extensions: string[];
-    /** Number of unmanaged action required extension entries represented by this result. */
-    unmanaged_action_required_extension_count: number;
-    /** Value that configures or reports unmanaged action required extensions for this contract. */
-    unmanaged_action_required_extensions: string[];
-    /** Value that configures or reports update check status totals for this contract. */
-    update_check_status_totals: Record<ExtensionUpdateCheckStatus, number>;
-    /** Value that configures or reports update check failed total for this contract. */
-    update_check_failed_total: number;
-    /** Value that configures or reports top warnings for this contract. */
-    top_warnings: string[];
-    /** Value that configures or reports remediation for this contract. */
-    remediation: string[];
-    /** Value that configures or reports collision plan for this contract. */
-    collision_plan?: ExtensionCollisionPlan;
-}
-/** Documents the extension collision plan payload exchanged by command, SDK, and package integrations. */
-export interface ExtensionCollisionPlan {
-    /** Lifecycle state reported for status. */
-    status: "ok" | "conflicts_detected";
-    /** Number of collision entries represented by this result. */
-    collision_count: number;
-    /** Number of extension entries represented by this result. */
-    extension_count: number;
-    /** Value that configures or reports next best command for this contract. */
-    next_best_command: string;
-    /** Value that configures or reports collisions for this contract. */
-    collisions: Array<{
-        code: string;
-        surface: string;
-        winner: {
-            layer: ExtensionScope;
-            name: string;
-        };
-        displaced: {
-            layer: ExtensionScope;
-            name: string;
-        };
-    }>;
-    /** Value that configures or reports remediation candidates for this contract. */
-    remediation_candidates: Array<{
-        action: "deactivate";
-        extension: string;
-        command: string;
-        affected_collisions: number;
-        feature_loss: {
-            command_paths: string[];
-            action_paths: string[];
-        };
-    }>;
-}
-/** Restricts extension update check status values accepted by command, SDK, and storage contracts. */
-export type ExtensionUpdateCheckStatus = "checked" | "skipped_unmanaged" | "skipped_non_github" | "failed" | "not_checked";
-interface ExtensionUpdateCheckResolution {
-    status: ExtensionUpdateCheckStatus;
-    reason: string;
-}
-/** Restricts extension doctor detail mode values accepted by command, SDK, and storage contracts. */
-export type ExtensionDoctorDetailMode = "summary" | "deep";
-interface ExtensionPolicyOverrideDetails {
-    name: string;
-    disabled?: boolean;
-    require_trusted?: boolean;
-    require_provenance?: boolean;
-    sandbox_profile?: "none" | "restricted" | "strict";
-    allowed_capabilities?: string[];
-    blocked_capabilities?: string[];
-    allowed_surfaces?: string[];
-    blocked_surfaces?: string[];
-    allowed_commands?: string[];
-    blocked_commands?: string[];
-    allowed_actions?: string[];
-    blocked_actions?: string[];
-    allowed_services?: string[];
-    blocked_services?: string[];
-}
-interface ExtensionPolicyDetails {
-    mode: "off" | "warn" | "enforce";
-    trust_mode: "off" | "warn" | "enforce";
-    require_provenance: boolean;
-    trusted_extensions: string[];
-    default_sandbox_profile: "none" | "restricted" | "strict";
-    allowed_extensions: string[];
-    blocked_extensions: string[];
-    allowed_capabilities: string[];
-    blocked_capabilities: string[];
-    allowed_surfaces: string[];
-    blocked_surfaces: string[];
-    allowed_commands: string[];
-    blocked_commands: string[];
-    allowed_actions: string[];
-    blocked_actions: string[];
-    allowed_services: string[];
-    blocked_services: string[];
-    extension_overrides: ExtensionPolicyOverrideDetails[];
-}
-declare function buildExtensionPolicyDetails(policy: PmSettings["extensions"]["policy"] | null | undefined): ExtensionPolicyDetails;
-declare function isRetriableExtensionInstallCopyError(error: unknown): boolean;
-declare function isErrnoCode(error: unknown, code: string): boolean;
-/** Implements copy extension directory for install for the public runtime surface of this module. */
-export declare function copyExtensionDirectoryForInstall(sourceDirectory: string, destinationDirectory: string, copyDirectory?: typeof fs.cp): Promise<void>;
-declare function copyExtensionDirectoryWithoutSelfNesting(sourceDirectory: string, destinationDirectory: string, copyDirectory: typeof fs.cp): Promise<void>;
-declare function withExtensionInstallLock<T>(settingsRoot: string, destinationDirectoryName: string, run: () => Promise<T>, options?: {
-    attempts?: number;
-    delay_ms?: number;
-    stale_ms?: number;
-}): Promise<T>;
-declare function resolveInstalledExtensionCandidate(installed: ManagedExtensionSummary[], extensionTarget: string): Promise<ManagedExtensionSummary | undefined>;
-declare function clearExtensionState(settings: PmSettings, name: string): boolean;
-declare function resolveAction(target: string | undefined, options: ExtensionCommandOptions): ExtensionCommandAction;
-declare function resolveScope(options: ExtensionCommandOptions): ExtensionScope;
-declare function resolveUpdateCheckResolution(managedEntry: ManagedExtensionRecord | undefined): ExtensionUpdateCheckResolution;
-declare function listInstalledExtensions(extensionsRoot: string, scope: ExtensionScope, settings: PmSettings, state: ManagedExtensionState): Promise<{
-    extensions: ManagedExtensionSummary[];
-    warnings: string[];
-}>;
-interface GithubUpdateStatus {
-    checked_at: string;
-    available: boolean | null;
-    remote_commit?: string;
-    error?: string;
-}
-type ActivationFailureEntry = Awaited<ReturnType<typeof activateExtensions>>["failed"][number];
-interface ActivationFailureDiagnostic {
-    layer: string;
-    name: string;
-    entry_path: string;
-    error: string;
-    missing_capability?: string;
-    hint?: string;
-    trace?: {
-        method: string;
-        registration_index: number;
-        expected_schema: string;
-        command?: string;
-        capability?: string;
-        missing_capability?: string;
-        hint?: string;
-    };
-}
-declare function resolveCommandDiscoveryPackageName(extensionName: string, source: ManagedExtensionSource): string;
-declare function buildInstallCommandDiscovery(extensionName: string, source: ManagedExtensionSource, commandSummary: {
-    command_paths: string[];
-    action_paths: string[];
-}, activationFailure?: ActivationFailureDiagnostic): Record<string, unknown>;
-declare function collectActivationFailureDiagnostics(failures: ActivationFailureEntry[]): ActivationFailureDiagnostic[];
-declare function findActivationFailureByName(extensionName: string, failures: ActivationFailureDiagnostic[], layer?: ExtensionScope): ActivationFailureDiagnostic | undefined;
-declare function resolveInstallRuntimeActivationStatus(extensionName: string, scope: ExtensionScope, runtimeInstalled: ManagedExtensionSummary[], installActivationFailure: ActivationFailureDiagnostic | undefined): ExtensionActivationStatus;
-declare function checkGithubUpdate(source: ManagedExtensionSource, gitCommandRunner?: typeof runGitCommand): Promise<GithubUpdateStatus>;
-interface AdoptedUnmanagedExtension {
-    name: string;
-    directory: string;
-    version: string;
-    entry: string;
-    source: ManagedExtensionSource;
-}
-interface AdoptUnmanagedExtensionsResult {
-    state: ManagedExtensionState;
-    adopted_entries: AdoptedUnmanagedExtension[];
-    unmanaged_candidates: ManagedExtensionSummary[];
-    already_managed_count: number;
-}
-declare function adoptUnmanagedExtensions(extensionsRoot: string, scope: ExtensionScope, installedExtensions: ManagedExtensionSummary[], state: ManagedExtensionState): Promise<AdoptUnmanagedExtensionsResult>;
-declare function resolveGithubOption(options: ExtensionCommandOptions): string | undefined;
-declare function requireTarget(target: string | undefined, action: ExtensionCommandAction, options?: ExtensionCommandOptions): string;
-declare function collectGlobalOutputOverrideDoctorWarnings(activationResult: Awaited<ReturnType<typeof activateExtensions>>): string[];
 /**
- * Doctor advisory: flag loaded extensions that contribute GLOBAL schema (custom
- * item types or fields) yet also declare narrow `activation.commands`.
+ * @module cli/commands/extension
  *
- * Custom item types and fields must be present for the built-in commands the
- * extension does not own and cannot enumerate (`pm create <type>`,
- * `pm list --type <type>`, `pm validate`). Declaring `activation.commands` gates
- * lazy activation to only the listed command paths, so the package never
- * activates for those built-ins and its custom type silently fails to register —
- * a quiet footgun (decision pm-halx). The `schema` scaffold deliberately omits
- * the field; this advisory catches hand-authored packages that do not. It is
- * doctor-only and non-blocking — `pm health` does not surface it — so the author
- * can either drop `activation.commands` or, when the schema is intentionally
- * command-scoped, knowingly ignore the hint.
+ * Compatibility exports for the SDK-owned extension and package engine.
  */
-declare function collectSchemaNarrowActivationDoctorWarnings(loadResult: Awaited<ReturnType<typeof loadExtensions>>, activationResult: Awaited<ReturnType<typeof activateExtensions>>): string[];
-/**
- * Entry point for the `pm extension` / `pm package` command surface. Resolves the
- * requested lifecycle action and scope, rejects out-of-scope option usage,
- * normalizes positional aliases, then dispatches to the matching action handler —
- * each of which reads and writes managed-extension state, runtime-probes, and
- * returns the canonical {@link ExtensionCommandResult}. `--doctor` results are
- * flagged for native (non-JSON-wrapped) output.
- */
-export declare function runExtension(target: string | undefined, options: ExtensionCommandOptions, global: GlobalOptions): Promise<ExtensionCommandResult>;
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-    adoptUnmanagedExtensions: typeof adoptUnmanagedExtensions;
-    buildExtensionPolicyDetails: typeof buildExtensionPolicyDetails;
-    buildInstallCommandDiscovery: typeof buildInstallCommandDiscovery;
-    checkGithubUpdate: typeof checkGithubUpdate;
-    clearExtensionState: typeof clearExtensionState;
-    collectActivationFailureDiagnostics: typeof collectActivationFailureDiagnostics;
-    findActivationFailureByName: typeof findActivationFailureByName;
-    resolveInstallRuntimeActivationStatus: typeof resolveInstallRuntimeActivationStatus;
-    collectGlobalOutputOverrideDoctorWarnings: typeof collectGlobalOutputOverrideDoctorWarnings;
-    collectSchemaNarrowActivationDoctorWarnings: typeof collectSchemaNarrowActivationDoctorWarnings;
-    copyExtensionDirectoryWithoutSelfNesting: typeof copyExtensionDirectoryWithoutSelfNesting;
-    isErrnoCode: typeof isErrnoCode;
-    isRetriableExtensionInstallCopyError: typeof isRetriableExtensionInstallCopyError;
-    listInstalledExtensions: typeof listInstalledExtensions;
-    requireTarget: typeof requireTarget;
-    resolveAction: typeof resolveAction;
-    resolveCommandDiscoveryPackageName: typeof resolveCommandDiscoveryPackageName;
-    resolveGithubOption: typeof resolveGithubOption;
-    resolveInstalledExtensionCandidate: typeof resolveInstalledExtensionCandidate;
-    resolveScope: typeof resolveScope;
-    resolveUpdateCheckResolution: typeof resolveUpdateCheckResolution;
-    withExtensionInstallLock: typeof withExtensionInstallLock;
-};
+export * from "../../sdk/extension.js";