@unbrained/pm-cli 2026.3.12 → 2026.5.1

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

@@ -0,0 +1,122 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+export type ExtensionCommandAction = "install" | "uninstall" | "explore" | "manage" | "doctor" | "adopt" | "adopt-all" | "activate" | "deactivate" | "init";
+export type ExtensionScope = "project" | "global";
+export type ExtensionActivationStatus = "ok" | "failed" | "not_loaded" | "unknown";
+export interface ExtensionCommandOptions {
+    install?: boolean;
+    uninstall?: boolean;
+    explore?: boolean;
+    manage?: boolean;
+    doctor?: boolean;
+    init?: boolean;
+    scaffold?: boolean;
+    strictExit?: boolean;
+    failOnWarn?: boolean;
+    adopt?: boolean;
+    adoptAll?: boolean;
+    activate?: boolean;
+    deactivate?: boolean;
+    project?: boolean;
+    local?: boolean;
+    global?: boolean;
+    gh?: string;
+    github?: string;
+    ref?: string;
+    detail?: string;
+    trace?: boolean;
+    runtimeProbe?: boolean;
+    fixManagedState?: boolean;
+}
+export interface ManagedExtensionSource {
+    kind: "local" | "github";
+    input: string;
+    location: 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;
+}
+type InstallSource = LocalInstallSource | GithubInstallSource;
+export interface ManagedExtensionSummary {
+    name: string;
+    directory: string;
+    version: string;
+    entry: string;
+    scope: ExtensionScope;
+    active: boolean;
+    enabled: boolean;
+    runtime_active: boolean | null;
+    activation_status: ExtensionActivationStatus;
+    managed: boolean;
+    source?: ManagedExtensionSource;
+    update_available?: boolean | null;
+    last_update_check_at?: string;
+    last_update_remote_commit?: string;
+    update_error?: string;
+    update_check_status: ExtensionUpdateCheckStatus;
+    update_check_reason: string;
+}
+export interface ExtensionCommandResult {
+    ok: boolean;
+    action: ExtensionCommandAction;
+    scope: ExtensionScope;
+    roots: {
+        project: string;
+        global: string;
+        selected: string;
+        settings_root: string;
+    };
+    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 declare function runExtension(target: string | undefined, options: ExtensionCommandOptions, global: GlobalOptions): Promise<ExtensionCommandResult>;
+export {};