@unbrained/pm-cli 2026.5.18 → 2026.5.27

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

@@ -1,4 +1,11 @@
+import fs from "node:fs/promises";
 import type { GlobalOptions } from "../../core/shared/command-types.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 } 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";
 export type ExtensionCommandAction = "install" | "uninstall" | "explore" | "manage" | "reload" | "doctor" | "catalog" | "adopt" | "adopt-all" | "activate" | "deactivate" | "init";
 export type ExtensionScope = "project" | "global";
 export type ExtensionActivationStatus = "ok" | "failed" | "not_loaded" | "unknown";
@@ -29,67 +36,9 @@ export interface ExtensionCommandOptions {
     watch?: boolean;
     runtimeProbe?: boolean;
     fixManagedState?: boolean;
+    fields?: string;
     vocabulary?: "extension" | "package";
 }
-export interface ManagedExtensionSource {
-    kind: "local" | "github" | "npm" | "builtin";
-    input: string;
-    location: string;
-    name?: string;
-    package?: string;
-    version?: string;
-    repository?: string;
-    owner?: string;
-    repo?: string;
-    ref?: string;
-    subpath?: string;
-    commit?: string;
-}
-export interface ManagedExtensionRecord {
-    name: string;
-    directory: string;
-    scope: ExtensionScope;
-    manifest_version: string;
-    manifest_entry: string;
-    capabilities: string[];
-    installed_at: string;
-    updated_at: string;
-    source: ManagedExtensionSource;
-    last_update_check_at?: string;
-    last_update_remote_commit?: string;
-    update_available?: boolean | null;
-    update_error?: string;
-}
-export interface ManagedExtensionState {
-    version: number;
-    updated_at: string;
-    entries: ManagedExtensionRecord[];
-}
-export interface ManagedExtensionStateReadResult {
-    path: string;
-    state: ManagedExtensionState;
-    warnings: string[];
-}
-interface LocalInstallSource {
-    kind: "local";
-    input: string;
-    absolute_path: string;
-}
-interface GithubInstallSource {
-    kind: "github";
-    input: string;
-    owner: string;
-    repo: string;
-    repository: string;
-    ref?: string;
-    subpath?: string;
-}
-interface NpmInstallSource {
-    kind: "npm";
-    input: string;
-    spec: string;
-}
-type InstallSource = LocalInstallSource | GithubInstallSource | NpmInstallSource;
 export interface ManagedExtensionSummary {
     name: string;
     directory: string;
@@ -124,13 +73,33 @@ export interface ExtensionCommandResult {
     warnings: string[];
     details: Record<string, unknown>;
 }
-type ExtensionUpdateCheckStatus = "checked" | "skipped_unmanaged" | "skipped_non_github" | "failed" | "not_checked";
-export declare function resolveManagedExtensionStatePath(extensionsRoot: string): string;
-export declare function readManagedExtensionState(extensionsRoot: string): Promise<ManagedExtensionStateReadResult>;
-export declare function writeManagedExtensionState(extensionsRoot: string, state: ManagedExtensionState): Promise<void>;
-export declare function parseExtensionInstallSource(input: string, options?: {
-    forceGithub?: boolean;
-    ref?: string;
-}): InstallSource;
+export interface ExtensionTriageSummary {
+    status: "ok" | "warn";
+    warning_count: number;
+    warning_codes: string[];
+    warnings: string[];
+    policy_warning_count: number;
+    policy_violation_count: number;
+    policy_blocked_count: number;
+    total_extensions: number;
+    managed_total: number;
+    enabled_total: number;
+    active_total: number;
+    update_available_total: number;
+    update_health_coverage: "full" | "partial";
+    update_health_partial: boolean;
+    unmanaged_loaded_extension_count: number;
+    unmanaged_loaded_extensions: string[];
+    unmanaged_expected_extension_count: number;
+    unmanaged_expected_extensions: string[];
+    unmanaged_action_required_extension_count: number;
+    unmanaged_action_required_extensions: string[];
+    update_check_status_totals: Record<ExtensionUpdateCheckStatus, number>;
+    update_check_failed_total: number;
+    top_warnings: string[];
+    remediation: string[];
+}
+export type ExtensionUpdateCheckStatus = "checked" | "skipped_unmanaged" | "skipped_non_github" | "failed" | "not_checked";
+export type ExtensionDoctorDetailMode = "summary" | "deep";
+export declare function copyExtensionDirectoryForInstall(sourceDirectory: string, destinationDirectory: string, copyDirectory?: typeof fs.cp): Promise<void>;
 export declare function runExtension(target: string | undefined, options: ExtensionCommandOptions, global: GlobalOptions): Promise<ExtensionCommandResult>;
-export {};