@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/extension/migrations.d.ts

@@ -4,103 +4,103 @@ import type { ExtensionCommandResult, ExtensionScope } from "../extension.js";
 export type ExtensionMigrationOutcomeStatus = "applied" | "failed";
 /** One durable extension-migration outcome. */
 export interface ExtensionMigrationStateEntry {
-    /** Stable layer/name/id identity. */
-    key: string;
-    /** Extension installation layer. */
-    layer: "global" | "project";
-    /** Owning extension name. */
-    extension: string;
-    /** Migration identifier declared by the extension. */
-    id: string;
-    /** Last durable outcome. */
-    status: ExtensionMigrationOutcomeStatus;
-    /** ISO timestamp for the last attempt. */
-    attempted_at: string;
-    /** Failure text retained only for failed outcomes. */
-    error?: string;
+/** Stable layer/name/id identity. */
+key: string;
+/** Extension installation layer. */
+layer: "global" | "project";
+/** Owning extension name. */
+extension: string;
+/** Migration identifier declared by the extension. */
+id: string;
+/** Last durable outcome. */
+status: ExtensionMigrationOutcomeStatus;
+/** ISO timestamp for the last attempt. */
+attempted_at: string;
+/** Failure text retained only for failed outcomes. */
+error?: string;
 }
 /** Versioned workspace state for extension migrations. */
 export interface ExtensionMigrationState {
-    /** Storage schema version. */
-    version: 1;
-    /** Last state change timestamp. */
-    updated_at: string;
-    /** Deterministically sorted outcomes. */
-    entries: ExtensionMigrationStateEntry[];
+/** Storage schema version. */
+version: 1;
+/** Last state change timestamp. */
+updated_at: string;
+/** Deterministically sorted outcomes. */
+entries: ExtensionMigrationStateEntry[];
 }
 /** Planned or executed row returned for one registered migration. */
 export interface ExtensionMigrationReceipt {
-    /** Stable layer/name/id identity. */
-    key: string;
-    /** Extension installation layer. */
-    layer: "global" | "project";
-    /** Owning extension name. */
-    extension: string;
-    /** Migration identifier. */
-    id: string;
-    /** State observed before this invocation. */
-    before: "pending" | ExtensionMigrationOutcomeStatus;
-    /** Invocation outcome. */
-    outcome: "pending" | "applied" | "skipped" | "failed";
-    /** Failure text for failed execution. */
-    error?: string;
+/** Stable layer/name/id identity. */
+key: string;
+/** Extension installation layer. */
+layer: "global" | "project";
+/** Owning extension name. */
+extension: string;
+/** Migration identifier. */
+id: string;
+/** State observed before this invocation. */
+before: "pending" | ExtensionMigrationOutcomeStatus;
+/** Invocation outcome. */
+outcome: "pending" | "applied" | "skipped" | "failed";
+/** Failure text for failed execution. */
+error?: string;
 }
 /** Structured plan/application envelope for extension migrations. */
 export interface ExtensionMigrationRunResult {
-    /** Whether the invocation executed no failing migration. */
-    ok: boolean;
-    /** Whether execution was suppressed. */
-    dry_run: boolean;
-    /** Durable state path. */
-    state_path: string;
-    /** Total registered migrations in scope. */
-    total: number;
-    /** Pending rows in the returned receipt. */
-    pending_count: number;
-    /** Applied rows in the returned receipt. */
-    applied_count: number;
-    /** Already-applied rows skipped idempotently. */
-    skipped_count: number;
-    /** Failed rows in the returned receipt. */
-    failed_count: number;
-    /** Deterministically ordered per-migration receipts. */
-    migrations: ExtensionMigrationReceipt[];
+/** Whether the invocation executed no failing migration. */
+ok: boolean;
+/** Whether execution was suppressed. */
+dry_run: boolean;
+/** Durable state path. */
+state_path: string;
+/** Total registered migrations in scope. */
+total: number;
+/** Pending rows in the returned receipt. */
+pending_count: number;
+/** Applied rows in the returned receipt. */
+applied_count: number;
+/** Already-applied rows skipped idempotently. */
+skipped_count: number;
+/** Failed rows in the returned receipt. */
+failed_count: number;
+/** Deterministically ordered per-migration receipts. */
+migrations: ExtensionMigrationReceipt[];
 }
 /** Options for planning or applying active extension migrations. */
 export interface RunExtensionMigrationsOptions {
-    /** Tracker root that owns durable migration state. */
-    pmRoot: string;
-    /** Active runtime registrations. */
-    migrations: RegisteredExtensionSchemaMigrationDefinition[];
-    /** Audit author written to workspace history. */
-    author: string;
-    /** Report pending work without invoking extension code. */
-    dryRun?: boolean;
-    /** Limit execution and receipts to one installation layer. */
-    scope?: "global" | "project";
+/** Tracker root that owns durable migration state. */
+pmRoot: string;
+/** Active runtime registrations. */
+migrations: RegisteredExtensionSchemaMigrationDefinition[];
+/** Audit author written to workspace history. */
+author: string;
+/** Report pending work without invoking extension code. */
+dryRun?: boolean;
+/** Limit execution and receipts to one installation layer. */
+scope?: "global" | "project";
 }
 /** Minimal lifecycle context required by the migration action dispatcher. */
 export interface ExtensionMigrationActionContext {
-    /** Selected package scope. */
-    scope: ExtensionScope;
-    /** Tracker and settings roots for the invocation. */
-    resolvedRoots: {
-        pm_root: string;
-        settings_root: string;
-    };
-    /** Mutable warning collection shared with the lifecycle result. */
-    warnings: string[];
-    /** Migration-specific command options. */
-    options: {
-        dryRun?: boolean;
-    };
-    /** Relevant global runtime options. */
-    global: {
-        noExtensions?: boolean;
-        author?: string;
-    };
-    /** Construct the standard extension lifecycle result envelope. */
-    withResult: (details: Record<string, unknown>, ok?: boolean) => ExtensionCommandResult;
+/** Selected package scope. */
+scope: ExtensionScope;
+/** Tracker and settings roots for the invocation. */
+resolvedRoots: {
+pm_root: string;
+settings_root: string;
+};
+/** Mutable warning collection shared with the lifecycle result. */
+warnings: string[];
+/** Migration-specific command options. */
+options: {
+dryRun?: boolean;
+};
+/** Relevant global runtime options. */
+global: {
+noExtensions?: boolean;
+author?: string;
+};
+/** Construct the standard extension lifecycle result envelope. */
+withResult: (details: Record<string, unknown>, ok?: boolean) => ExtensionCommandResult;
 }
 /** Return the durable workspace path for extension migration state. */
 export declare function resolveExtensionMigrationStatePath(pmRoot: string): string;

package/dist/sdk/extension/output-ownership.d.ts

@@ -1,30 +1,30 @@
 interface OutputActivationSummary {
-    services: {
-        overrides: Array<{
-            service: string;
-            layer: string;
-            name: string;
-            passThrough?: boolean;
-        }>;
-    };
-    renderers: {
-        overrides: Array<{
-            format: string;
-            layer: string;
-            name: string;
-            commands?: string[];
-            resultDiscriminator?: (result: unknown) => boolean;
-        }>;
-    };
+services: {
+overrides: Array<{
+service: string;
+layer: string;
+name: string;
+passThrough?: boolean;
+}>;
+};
+renderers: {
+overrides: Array<{
+format: string;
+layer: string;
+name: string;
+commands?: string[];
+resultDiscriminator?: (result: unknown) => boolean;
+}>;
+};
 }
 interface OutputLoadSummary {
-    loaded: Array<{
-        layer: string;
-        name: string;
-        activation?: {
-            commands?: string[];
-        };
-    }>;
+loaded: Array<{
+layer: string;
+name: string;
+activation?: {
+commands?: string[];
+};
+}>;
 }
 /** Collect doctor warnings for output overrides without an explicit command or result ownership boundary. */
 export declare function collectGlobalOutputOverrideDoctorWarnings(activationResult: OutputActivationSummary, loadResult?: OutputLoadSummary): string[];

package/dist/sdk/extension/runtime-summary.d.ts

@@ -1,9 +1,9 @@
 /** Return stable runtime command and action paths registered by one extension. */
 export declare function summarizeRuntimeCommandPathsForExtension(extensionName: string, installed: ReadonlyArray<{
-    name: string;
-    command_paths?: string[];
-    action_paths?: string[];
+name: string;
+command_paths?: string[];
+action_paths?: string[];
 }>): {
-    command_paths: string[];
-    action_paths: string[];
+command_paths: string[];
+action_paths: string[];
 };

package/dist/sdk/extension/scaffold.d.ts

@@ -7,20 +7,20 @@ export declare const SCAFFOLD_CAPABILITIES: readonly ["commands", "hooks", "sear
  */
 export type ExtensionScaffoldCapability = (typeof SCAFFOLD_CAPABILITIES)[number];
 interface ExtensionScaffoldFileResult {
-    path: string;
-    status: "created" | "unchanged";
+path: string;
+status: "created" | "unchanged";
 }
 interface ExtensionScaffoldResult {
-    extension_name: string;
-    package_name: string;
-    command_name: string;
-    invocation_command: 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[];
+extension_name: string;
+package_name: string;
+command_name: string;
+invocation_command: 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

package/dist/sdk/extension/shared.d.ts

@@ -2,23 +2,23 @@ import { isCanonicalPathWithinDirectory, type ExtensionManifest } from "../../co
 export { isCanonicalPathWithinDirectory };
 /** Documents the validated extension directory payload exchanged by command, SDK, and package integrations. */
 export interface ValidatedExtensionDirectory {
-    /** Value that configures or reports directory for this contract. */
-    directory: string;
-    /** Filesystem path used for manifest resolution. */
-    manifest_path: string;
-    /** Filesystem path used for entry resolution. */
-    entry_path: string;
-    /** Declarative package manifest consumed by the extension loader. */
-    manifest: ExtensionManifest;
+/** Value that configures or reports directory for this contract. */
+directory: string;
+/** Filesystem path used for manifest resolution. */
+manifest_path: string;
+/** Filesystem path used for entry resolution. */
+entry_path: string;
+/** Declarative package manifest consumed by the extension loader. */
+manifest: ExtensionManifest;
 }
 /** Optional install-source evidence used to make validation failures actionable. */
 export interface ExtensionDirectoryValidationContext {
-    /** Source kind whose behavior explains a missing built artifact. */
-    source_kind?: "github" | "local" | "npm";
-    /** Original source spelling shown in recovery guidance. */
-    source_input?: string;
-    /** Package root containing package.json for source-aware diagnostics. */
-    source_root?: string;
+/** Source kind whose behavior explains a missing built artifact. */
+source_kind?: "github" | "local" | "npm";
+/** Original source spelling shown in recovery guidance. */
+source_input?: string;
+/** Package root containing package.json for source-aware diagnostics. */
+source_root?: string;
 }
 /** Implements normalize string list for the public runtime surface of this module. */
 export declare function normalizeStringList(values: readonly string[]): string[];
@@ -33,5 +33,5 @@ export declare function validateExtensionDirectory(directory: string, context?:
 declare function formatManifestReadError(error: unknown): string;
 /** Public contract for test only extension shared, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyExtensionShared: {
-    formatManifestReadError: typeof formatManifestReadError;
+formatManifestReadError: typeof formatManifestReadError;
 };

package/dist/sdk/extension/source-resolution.d.ts

@@ -2,45 +2,45 @@ import { type InstallSource } from "./install-sources.js";
 import type { ManagedExtensionRecord } from "./managed-state.js";
 /** Selected install-source identity. */
 export interface ExtensionInstallSourceSelection {
-    /** Selected source family. */
-    kind: "builtin" | "local" | "github" | "npm";
-    /** Canonical source input used for resolution. */
-    input: string;
-    /** Canonical package name when known. */
-    package?: string;
+/** Selected source family. */
+kind: "builtin" | "local" | "github" | "npm";
+/** Canonical source input used for resolution. */
+input: string;
+/** Canonical package name when known. */
+package?: string;
 }
 /** One source candidate and the explicit command that selects it. */
 export interface ExtensionInstallSourceCandidate extends ExtensionInstallSourceSelection {
-    /** Installed candidate version when known. */
-    version?: string;
-    /** Installed candidate directory when relevant. */
-    directory?: string;
-    /** Unambiguous CLI command that selects this candidate. */
-    command: string;
+/** Installed candidate version when known. */
+version?: string;
+/** Installed candidate directory when relevant. */
+directory?: string;
+/** Unambiguous CLI command that selects this candidate. */
+command: string;
 }
 /** Machine-readable explanation of how one install target resolved. */
 export interface ExtensionInstallSourceResolution {
-    /** Exact target supplied by the caller. */
-    requested: string;
-    /** Source selected by the deterministic resolver. */
-    selected: ExtensionInstallSourceSelection;
-    /** Whether another locally available source could satisfy the same bare name. */
-    ambiguous: boolean;
-    /** Stable precedence rule used for the selection. */
-    precedence: "bundled_alias_before_installed_npm";
-    /** Every matching candidate and its explicit install command. */
-    candidates: ExtensionInstallSourceCandidate[];
+/** Exact target supplied by the caller. */
+requested: string;
+/** Source selected by the deterministic resolver. */
+selected: ExtensionInstallSourceSelection;
+/** Whether another locally available source could satisfy the same bare name. */
+ambiguous: boolean;
+/** Stable precedence rule used for the selection. */
+precedence: "bundled_alias_before_installed_npm";
+/** Every matching candidate and its explicit install command. */
+candidates: ExtensionInstallSourceCandidate[];
 }
 /** Complete result of resolving one extension install target. */
 export interface ResolvedExtensionInstallSource {
-    /** Normalized bundled alias, or null for non-bundled sources. */
-    bundledAliasName: string | null;
-    /** Bundled package name, or null when unavailable. */
-    bundledPackageName: string | null;
-    /** Parsed source passed to the install resolver. */
-    installSource: InstallSource;
-    /** Observable source-selection decision. */
-    sourceResolution: ExtensionInstallSourceResolution;
+/** Normalized bundled alias, or null for non-bundled sources. */
+bundledAliasName: string | null;
+/** Bundled package name, or null when unavailable. */
+bundledPackageName: string | null;
+/** Parsed source passed to the install resolver. */
+installSource: InstallSource;
+/** Observable source-selection decision. */
+sourceResolution: ExtensionInstallSourceResolution;
 }
 /** Resolve bundled-alias provenance and competing installed npm identity. */
 export declare function resolveExtensionInstallSourceIdentity(explicitSourceInput: string, githubOption: string | undefined, ref: string | undefined, managedEntries?: readonly ManagedExtensionRecord[]): Promise<ResolvedExtensionInstallSource>;

package/dist/sdk/extension/static-inventory.d.ts

@@ -1,54 +1,54 @@
 /** One read failure or malformed document that prevents a complete inventory. */
 export interface StaticExtensionInventoryError {
-    /** Stable machine-readable reason. */
-    code: "settings_invalid" | "settings_unreadable" | "managed_state_invalid" | "managed_state_unreadable" | "extensions_unreadable" | "manifest_invalid" | "manifest_unreadable";
-    /** File or directory whose read failed. */
-    path: string;
+/** Stable machine-readable reason. */
+code: "settings_invalid" | "settings_unreadable" | "managed_state_invalid" | "managed_state_unreadable" | "extensions_unreadable" | "manifest_invalid" | "manifest_unreadable";
+/** File or directory whose read failed. */
+path: string;
 }
 /** A configured package; runtime activation has deliberately not been tested. */
 export interface StaticExtensionInventoryEntry {
-    /** Manifest name, or directory name when the manifest is malformed. */
-    name: string;
-    /** Extension directory basename. */
-    directory: string | null;
-    /** Selected storage scope. */
-    scope: "project" | "global";
-    /** Whether an installed directory was found. */
-    installed: boolean;
-    /** Installed, disabled, absent, or unreadable manifest outcome. */
-    status: "installed" | "inactive" | "absent" | "malformed_manifest";
-    /** Effective configured state; null when settings cannot be trusted. */
-    configured_enabled: boolean | null;
-    /** Whether managed metadata identifies this install; null when that metadata is invalid. */
-    managed: boolean | null;
-    /** Runtime state is never inferred from configuration. */
-    runtime_active: null;
-    /** Manifest version when available. */
-    version?: string;
+/** Manifest name, or directory name when the manifest is malformed. */
+name: string;
+/** Extension directory basename. */
+directory: string | null;
+/** Selected storage scope. */
+scope: "project" | "global";
+/** Whether an installed directory was found. */
+installed: boolean;
+/** Installed, disabled, absent, or unreadable manifest outcome. */
+status: "installed" | "inactive" | "absent" | "malformed_manifest";
+/** Effective configured state; null when settings cannot be trusted. */
+configured_enabled: boolean | null;
+/** Whether managed metadata identifies this install; null when that metadata is invalid. */
+managed: boolean | null;
+/** Runtime state is never inferred from configuration. */
+runtime_active: null;
+/** Manifest version when available. */
+version?: string;
 }
 /** A read-only inventory with explicit completeness and source receipts. */
 export interface StaticExtensionInventoryResult {
-    /** Selected storage scope. */
-    scope: "project" | "global";
-    /** False if any source could not be read or parsed completely. */
-    complete: boolean;
-    /** Status of the two configuration sources. */
-    settings_status: "ok" | "absent" | "invalid" | "unreadable";
-    /** Status of the managed install metadata. */
-    managed_state_status: "ok" | "absent" | "invalid" | "unreadable";
-    /** Installed entries, or one absent entry for a missing requested name. */
-    extensions: StaticExtensionInventoryEntry[];
-    /** Every failure that affected completeness. */
-    errors: StaticExtensionInventoryError[];
+/** Selected storage scope. */
+scope: "project" | "global";
+/** False if any source could not be read or parsed completely. */
+complete: boolean;
+/** Status of the two configuration sources. */
+settings_status: "ok" | "absent" | "invalid" | "unreadable";
+/** Status of the managed install metadata. */
+managed_state_status: "ok" | "absent" | "invalid" | "unreadable";
+/** Installed entries, or one absent entry for a missing requested name. */
+extensions: StaticExtensionInventoryEntry[];
+/** Every failure that affected completeness. */
+errors: StaticExtensionInventoryError[];
 }
 /** Read configured extension state through filesystem reads only. */
 export declare function inspectStaticExtensionInventory(options: {
-    /** Tracker root for the project scope. */
-    pmRoot: string;
-    /** Storage scope; project is the default. */
-    scope?: "project" | "global";
-    /** Optional name or directory to inspect, including absent installs. */
-    name?: string;
-    /** Base directory used to resolve the global PM root. */
-    cwd?: string;
+/** Tracker root for the project scope. */
+pmRoot: string;
+/** Storage scope; project is the default. */
+scope?: "project" | "global";
+/** Optional name or directory to inspect, including absent installs. */
+name?: string;
+/** Base directory used to resolve the global PM root. */
+cwd?: string;
 }): Promise<StaticExtensionInventoryResult>;

package/dist/sdk/extension/update-check.d.ts

@@ -2,19 +2,19 @@ import type { ManagedExtensionSource } from "./managed-state.js";
 import { runGitCommand } from "./install-sources.js";
 /** Describes the remote revision health of one managed GitHub extension. */
 export interface GithubUpdateStatus {
-    /** Time at which the remote comparison completed. */
-    checked_at: string;
-    /** Whether the remote commit differs, or null when no comparison is possible. */
-    available: boolean | null;
-    /** Peeled remote commit when the selected reference resolves. */
-    remote_commit?: string;
-    /** Stable failure reason when the comparison is incomplete. */
-    error?: string;
+/** Time at which the remote comparison completed. */
+checked_at: string;
+/** Whether the remote commit differs, or null when no comparison is possible. */
+available: boolean | null;
+/** Peeled remote commit when the selected reference resolves. */
+remote_commit?: string;
+/** Stable failure reason when the comparison is incomplete. */
+error?: string;
 }
 /** Result of comparing the installed npm identity with its registry latest dist-tag. */
 export interface NpmUpdateStatus extends Omit<GithubUpdateStatus, "remote_commit"> {
-    /** Registry version selected by the latest dist-tag, when valid. */
-    remote_version?: string;
+/** Registry version selected by the latest dist-tag, when valid. */
+remote_version?: string;
 }
 /** Query npm's configured registry with bounded execution and no lifecycle scripts. */
 declare function runNpmUpdateQuery(args: string[], timeout: number): Promise<string>;