@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/sdk/extension/install-receipts.d.ts

@@ -2,6 +2,6 @@
 import type { ExtensionCommandResult } from "../extension.js";
 /** Preserve per-package evidence while distinguishing planned and completed bundled installs. */
 export declare function buildBundledInstallReceipt(packages: ReadonlyArray<{
-    alias: string;
-    result: ExtensionCommandResult;
+alias: string;
+result: ExtensionCommandResult;
 }>, dryRun: boolean): Record<string, unknown>;

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

@@ -1,14 +1,14 @@
 import fs from "node:fs/promises";
 /** Retry and lease timing overrides for one extension install lock. */
 export interface ExtensionInstallLockOptions {
-    /** Maximum lock-acquisition attempts. */
-    attempts?: number;
-    /** Delay between contended acquisition attempts. */
-    delay_ms?: number;
-    /** Age after which an unchanged owner lease can be reclaimed. */
-    stale_ms?: number;
-    /** Lease heartbeat interval while the operation runs. */
-    heartbeat_ms?: number;
+/** Maximum lock-acquisition attempts. */
+attempts?: number;
+/** Delay between contended acquisition attempts. */
+delay_ms?: number;
+/** Age after which an unchanged owner lease can be reclaimed. */
+stale_ms?: number;
+/** Lease heartbeat interval while the operation runs. */
+heartbeat_ms?: number;
 }
 /** Identify transient copy races that are safe to retry during extension installation. */
 export declare const isRetriableExtensionInstallCopyError: (error: unknown) => boolean;

package/dist/sdk/extension/install-snapshot.d.ts

@@ -1,19 +1,19 @@
 /** Exact filesystem and metadata state captured before an extension install. */
 export interface ExtensionInstallSnapshot {
-    /** Temporary copy of the prior destination directory. */
-    backupDirectory: string;
-    /** Extension destination being installed. */
-    destinationDirectory: string;
-    /** Whether the destination existed before installation. */
-    destinationExists: boolean;
-    /** Managed-extension state file path. */
-    managedStatePath: string;
-    /** Exact prior managed-extension state contents. */
-    managedStateContents: Buffer | null;
-    /** Project settings file path. */
-    settingsPath: string;
-    /** Exact prior project settings contents. */
-    settingsContents: Buffer | null;
+/** Temporary copy of the prior destination directory. */
+backupDirectory: string;
+/** Extension destination being installed. */
+destinationDirectory: string;
+/** Whether the destination existed before installation. */
+destinationExists: boolean;
+/** Managed-extension state file path. */
+managedStatePath: string;
+/** Exact prior managed-extension state contents. */
+managedStateContents: Buffer | null;
+/** Project settings file path. */
+settingsPath: string;
+/** Exact prior project settings contents. */
+settingsContents: Buffer | null;
 }
 /** Capture one optional metadata file without weakening non-ENOENT failures. */
 export declare const readOptionalMetadataFile: (filePath: string) => Promise<Buffer | null>;

package/dist/sdk/extension/install-sources.d.ts

@@ -8,82 +8,82 @@ import { type ReadEntry } from "tar";
 import { PmCliError, type PmCliErrorContext } from "../../core/shared/errors.js";
 declare const execFileAsync: typeof execFile.__promisify__;
 interface LocalPackageArchiveLimits {
-    maxArchiveBytes: number;
-    maxEntries: number;
-    maxExpandedBytes: number;
-    maxEntryBytes: number;
+maxArchiveBytes: number;
+maxEntries: number;
+maxExpandedBytes: number;
+maxEntryBytes: number;
 }
 /** Parsed filesystem install source. */
 export interface LocalInstallSource {
-    /** Discriminator for a filesystem source. */
-    kind: "local";
-    /** Exact caller-provided source text. */
-    input: string;
-    /** Absolute normalized source path. */
-    absolute_path: string;
+/** Discriminator for a filesystem source. */
+kind: "local";
+/** Exact caller-provided source text. */
+input: string;
+/** Absolute normalized source path. */
+absolute_path: string;
 }
 /** Parsed GitHub repository install source. */
 export interface GithubInstallSource {
-    /** Discriminator for a GitHub repository source. */
-    kind: "github";
-    /** Exact caller-provided source text. */
-    input: string;
-    /** Repository owner. */
-    owner: string;
-    /** Repository name without a `.git` suffix. */
-    repo: string;
-    /** Cloneable HTTPS repository URL. */
-    repository: string;
-    /** Optional Git ref selected by the caller or URL. */
-    ref?: string;
-    /** Optional repository-relative package directory. */
-    subpath?: string;
+/** Discriminator for a GitHub repository source. */
+kind: "github";
+/** Exact caller-provided source text. */
+input: string;
+/** Repository owner. */
+owner: string;
+/** Repository name without a `.git` suffix. */
+repo: string;
+/** Cloneable HTTPS repository URL. */
+repository: string;
+/** Optional Git ref selected by the caller or URL. */
+ref?: string;
+/** Optional repository-relative package directory. */
+subpath?: string;
 }
 /** Parsed npm registry or package-spec install source. */
 export interface NpmInstallSource {
-    /** Discriminator for an npm package source. */
-    kind: "npm";
-    /** Exact caller-provided source text. */
-    input: string;
-    /** Validated npm package specification. */
-    spec: string;
+/** Discriminator for an npm package source. */
+kind: "npm";
+/** Exact caller-provided source text. */
+input: string;
+/** Validated npm package specification. */
+spec: string;
 }
 /** Parsed extension install source accepted by the resolver. */
 export type InstallSource = LocalInstallSource | GithubInstallSource | NpmInstallSource;
 /** Materialized install source ready for extension validation. */
 export interface ResolvedInstallSource {
-    /** Parsed source that produced this directory. */
-    source: InstallSource;
-    /** Absolute extension or package directory ready for validation. */
-    directory: string;
-    /** Root unpacked or cloned source directory when different from `directory`. */
-    source_root?: string;
-    /** Repository subpath selected after clone. */
-    resolved_subpath?: string;
-    /** Resolved Git commit when the source is a repository. */
-    commit?: string;
-    /** Canonical npm package name when the source is a registry package. */
-    npm_package?: string;
-    /** Resolved npm package version. */
-    npm_version?: string;
-    /** Releases temporary source material created during resolution. */
-    cleanup?: () => Promise<void>;
+/** Parsed source that produced this directory. */
+source: InstallSource;
+/** Absolute extension or package directory ready for validation. */
+directory: string;
+/** Root unpacked or cloned source directory when different from `directory`. */
+source_root?: string;
+/** Repository subpath selected after clone. */
+resolved_subpath?: string;
+/** Resolved Git commit when the source is a repository. */
+commit?: string;
+/** Canonical npm package name when the source is a registry package. */
+npm_package?: string;
+/** Resolved npm package version. */
+npm_version?: string;
+/** Releases temporary source material created during resolution. */
+cleanup?: () => Promise<void>;
 }
 /** Installed npm package that competes with a bare bundled install target. */
 export interface InstalledNpmPackageCandidate {
-    /** Package identity read from its package.json. */
-    package: string;
-    /** Installed package version when declared. */
-    version?: string;
-    /** Absolute package root selected by Node-style ancestor lookup. */
-    directory: string;
+/** Package identity read from its package.json. */
+package: string;
+/** Installed package version when declared. */
+version?: string;
+/** Absolute package root selected by Node-style ancestor lookup. */
+directory: string;
 }
 /** Resolve an already-installed npm package without executing package code. */
 export declare function findInstalledNpmPackageCandidate(packageName: string, cwd?: string): Promise<InstalledNpmPackageCandidate | null>;
 /** Implements parse extension install source for the public runtime surface of this module. */
 export declare function parseExtensionInstallSource(input: string, options?: {
-    forceGithub?: boolean;
-    ref?: string;
+forceGithub?: boolean;
+ref?: string;
 }): InstallSource;
 /** Implements run git command for the public runtime surface of this module. */
 export declare function runGitCommand(args: string[], execRunner?: typeof execFileAsync, timeoutMs?: number): Promise<string>;
@@ -99,8 +99,8 @@ export declare function isNpmNotFoundError(error: unknown): boolean;
 export declare function isNpmPackNotFoundError(error: unknown): boolean;
 /** Implements build npm not found recovery for the public runtime surface of this module. */
 export declare function buildNpmNotFoundRecovery(spec: string): {
-    message: string;
-    context: PmCliErrorContext;
+message: string;
+context: PmCliErrorContext;
 };
 /** Implements wrap npm pack resolution error for the public runtime surface of this module. */
 export declare function wrapNpmPackResolutionError(spec: string, error: unknown): PmCliError | null;
@@ -108,15 +108,15 @@ declare function resolveNpmPackSpec(spec: string): Promise<string>;
 /** Implements normalize npm local file alias spec for the public runtime surface of this module. */
 export declare function normalizeNpmLocalFileAliasSpec(spec: string, cwd?: string): string;
 declare function parsePackedNpmPackage(stdout: string, packDirectory: string, expectedPackage?: string): {
-    tarball: string;
-    package?: string;
-    version?: string;
+tarball: string;
+package?: string;
+version?: string;
 };
 declare function resolveNpmSourceDirectory(source: NpmInstallSource): Promise<{
-    directory: string;
-    package?: string;
-    version?: string;
-    cleanup: () => Promise<void>;
+directory: string;
+package?: string;
+version?: string;
+cleanup: () => Promise<void>;
 }>;
 /**
  * Resolve an npm source with an injectable, argv-safe package-manager runner.
@@ -126,36 +126,36 @@ declare function resolveNpmSourceDirectory(source: NpmInstallSource): Promise<{
  * contract. Registry artifacts must also exist inside the requested pack root.
  */
 declare function resolveNpmSourceDirectoryWithRunner(source: NpmInstallSource, npmRunner: typeof runNpmCommand): Promise<{
-    directory: string;
-    package?: string;
-    version?: string;
-    cleanup: () => Promise<void>;
+directory: string;
+package?: string;
+version?: string;
+cleanup: () => Promise<void>;
 }>;
 declare function validateLocalPackageArchiveEntry(entry: ReadEntry, limits: LocalPackageArchiveLimits, state: {
-    entries: number;
-    expandedBytes: number;
-    packageJsonEntries: number;
+entries: number;
+expandedBytes: number;
+packageJsonEntries: number;
 }): void;
 /** Validate and extract one local npm package archive into an isolated temporary root. */
 declare function extractLocalPackageArchive(archivePath: string, limits?: LocalPackageArchiveLimits): Promise<{
-    directory: string;
-    package?: string;
-    version?: string;
-    cleanup: () => Promise<void>;
+directory: string;
+package?: string;
+version?: string;
+cleanup: () => Promise<void>;
 }>;
 declare function installNpmPackageRuntimeDependencies(packageRoot: string, npmRunner?: typeof runNpmCommand): Promise<void>;
 declare function hasHostedPmCliDependency(manifest: {
-    dependencies?: unknown;
-    optionalDependencies?: unknown;
-    peerDependencies?: unknown;
+dependencies?: unknown;
+optionalDependencies?: unknown;
+peerDependencies?: unknown;
 }): boolean;
 declare function removeHostedPmCliDependency(manifest: Record<string, unknown>): void;
 declare function linkHostedPmCliDependency(packageRoot: string): Promise<void>;
 declare function resolveDirectorySymlinkType(platform: NodeJS.Platform): "dir" | "junction";
 declare function runtimeDependencyInstallSpecs(manifest: {
-    dependencies?: unknown;
-    optionalDependencies?: unknown;
-    peerDependencies?: unknown;
+dependencies?: unknown;
+optionalDependencies?: unknown;
+peerDependencies?: unknown;
 }): string[];
 declare function resolvePackageExtensionDirectory(packageRoot: string, sourceLabel: string): Promise<string>;
 /** Implements resolve install source for the public runtime surface of this module. */
@@ -164,21 +164,21 @@ export declare function resolveInstallSource(source: InstallSource): Promise<Res
 export declare function areDirectoriesEquivalent(left: string, right: string): Promise<boolean>;
 /** Public contract for test only install sources, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyInstallSources: {
-    extractLocalPackageArchive: typeof extractLocalPackageArchive;
-    validateLocalPackageArchiveEntry: typeof validateLocalPackageArchiveEntry;
-    installNpmPackageRuntimeDependencies: typeof installNpmPackageRuntimeDependencies;
-    npmPackageNameFromSpec: typeof npmPackageNameFromSpec;
-    parsePackedNpmPackage: typeof parsePackedNpmPackage;
-    resolveNpmSourceDirectoryWithRunner: typeof resolveNpmSourceDirectoryWithRunner;
-    resolveNpmSourceDirectory: typeof resolveNpmSourceDirectory;
-    resolveNpmPackSpec: typeof resolveNpmPackSpec;
-    findInstalledNpmPackageCandidate: typeof findInstalledNpmPackageCandidate;
-    resolvePackageExtensionDirectory: typeof resolvePackageExtensionDirectory;
-    runtimeDependencyInstallSpecs: typeof runtimeDependencyInstallSpecs;
-    hasHostedPmCliDependency: typeof hasHostedPmCliDependency;
-    removeHostedPmCliDependency: typeof removeHostedPmCliDependency;
-    linkHostedPmCliDependency: typeof linkHostedPmCliDependency;
-    resolveDirectorySymlinkType: typeof resolveDirectorySymlinkType;
-    runNpmCommand: typeof runNpmCommand;
+extractLocalPackageArchive: typeof extractLocalPackageArchive;
+validateLocalPackageArchiveEntry: typeof validateLocalPackageArchiveEntry;
+installNpmPackageRuntimeDependencies: typeof installNpmPackageRuntimeDependencies;
+npmPackageNameFromSpec: typeof npmPackageNameFromSpec;
+parsePackedNpmPackage: typeof parsePackedNpmPackage;
+resolveNpmSourceDirectoryWithRunner: typeof resolveNpmSourceDirectoryWithRunner;
+resolveNpmSourceDirectory: typeof resolveNpmSourceDirectory;
+resolveNpmPackSpec: typeof resolveNpmPackSpec;
+findInstalledNpmPackageCandidate: typeof findInstalledNpmPackageCandidate;
+resolvePackageExtensionDirectory: typeof resolvePackageExtensionDirectory;
+runtimeDependencyInstallSpecs: typeof runtimeDependencyInstallSpecs;
+hasHostedPmCliDependency: typeof hasHostedPmCliDependency;
+removeHostedPmCliDependency: typeof removeHostedPmCliDependency;
+linkHostedPmCliDependency: typeof linkHostedPmCliDependency;
+resolveDirectorySymlinkType: typeof resolveDirectorySymlinkType;
+runNpmCommand: typeof runNpmCommand;
 };
 export {};

package/dist/sdk/extension/managed-state.d.ts

@@ -2,81 +2,81 @@ import type { ExtensionContributionInventory } from "../../core/extensions/exten
 import type { ExtensionScope } from "../extension.js";
 /** Documents the managed extension source payload exchanged by command, SDK, and package integrations. */
 export interface ManagedExtensionSource {
-    /** Value that configures or reports kind for this contract. */
-    kind: "local" | "github" | "npm" | "builtin";
-    /** Value that configures or reports input for this contract. */
-    input: string;
-    /** Value that configures or reports location for this contract. */
-    location: string;
-    /** Value that configures or reports name for this contract. */
-    name?: string;
-    /** Value that configures or reports package for this contract. */
-    package?: string;
-    /** Value that configures or reports version for this contract. */
-    version?: string;
-    /** Value that configures or reports repository for this contract. */
-    repository?: string;
-    /** Value that configures or reports owner for this contract. */
-    owner?: string;
-    /** Value that configures or reports repo for this contract. */
-    repo?: string;
-    /** Value that configures or reports ref for this contract. */
-    ref?: string;
-    /** Value that configures or reports subpath for this contract. */
-    subpath?: string;
-    /** Value that configures or reports commit for this contract. */
-    commit?: string;
+/** Value that configures or reports kind for this contract. */
+kind: "local" | "github" | "npm" | "builtin";
+/** Value that configures or reports input for this contract. */
+input: string;
+/** Value that configures or reports location for this contract. */
+location: string;
+/** Value that configures or reports name for this contract. */
+name?: string;
+/** Value that configures or reports package for this contract. */
+package?: string;
+/** Value that configures or reports version for this contract. */
+version?: string;
+/** Value that configures or reports repository for this contract. */
+repository?: string;
+/** Value that configures or reports owner for this contract. */
+owner?: string;
+/** Value that configures or reports repo for this contract. */
+repo?: string;
+/** Value that configures or reports ref for this contract. */
+ref?: string;
+/** Value that configures or reports subpath for this contract. */
+subpath?: string;
+/** Value that configures or reports commit for this contract. */
+commit?: string;
 }
 /** Documents the managed extension record payload exchanged by command, SDK, and package integrations. */
 export interface ManagedExtensionRecord {
-    /** 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 scope for this contract. */
-    scope: ExtensionScope;
-    /** Value that configures or reports manifest version for this contract. */
-    manifest_version: string;
-    /** Value that configures or reports manifest entry for this contract. */
-    manifest_entry: string;
-    /** Value that configures or reports capabilities for this contract. */
-    capabilities: string[];
-    /** Install-time snapshot of every registered extension surface. */
-    contributions?: ExtensionContributionInventory;
-    /** ISO 8601 timestamp recording when installed occurred. */
-    installed_at: string;
-    /** ISO 8601 timestamp recording when updated occurred. */
-    updated_at: string;
-    /** Value that configures or reports source for this contract. */
-    source: ManagedExtensionSource;
-    /** 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;
-    /** Latest registry version observed by a diagnostic check; diagnostics never persist this field. */
-    last_update_remote_version?: string;
-    /** Value that configures or reports update available for this contract. */
-    update_available?: boolean | null;
-    /** Value that configures or reports update error for this contract. */
-    update_error?: string;
+/** 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 scope for this contract. */
+scope: ExtensionScope;
+/** Value that configures or reports manifest version for this contract. */
+manifest_version: string;
+/** Value that configures or reports manifest entry for this contract. */
+manifest_entry: string;
+/** Value that configures or reports capabilities for this contract. */
+capabilities: string[];
+/** Install-time snapshot of every registered extension surface. */
+contributions?: ExtensionContributionInventory;
+/** ISO 8601 timestamp recording when installed occurred. */
+installed_at: string;
+/** ISO 8601 timestamp recording when updated occurred. */
+updated_at: string;
+/** Value that configures or reports source for this contract. */
+source: ManagedExtensionSource;
+/** 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;
+/** Latest registry version observed by a diagnostic check; diagnostics never persist this field. */
+last_update_remote_version?: string;
+/** Value that configures or reports update available for this contract. */
+update_available?: boolean | null;
+/** Value that configures or reports update error for this contract. */
+update_error?: string;
 }
 /** Documents the managed extension state payload exchanged by command, SDK, and package integrations. */
 export interface ManagedExtensionState {
-    /** Value that configures or reports version for this contract. */
-    version: number;
-    /** ISO 8601 timestamp recording when updated occurred. */
-    updated_at: string;
-    /** Value that configures or reports entries for this contract. */
-    entries: ManagedExtensionRecord[];
+/** Value that configures or reports version for this contract. */
+version: number;
+/** ISO 8601 timestamp recording when updated occurred. */
+updated_at: string;
+/** Value that configures or reports entries for this contract. */
+entries: ManagedExtensionRecord[];
 }
 /** Documents the managed extension state read result payload exchanged by command, SDK, and package integrations. */
 export interface ManagedExtensionStateReadResult {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports state for this contract. */
-    state: ManagedExtensionState;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports state for this contract. */
+state: ManagedExtensionState;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Implements resolve managed extension state path for the public runtime surface of this module. */
 export declare function resolveManagedExtensionStatePath(extensionsRoot: string): string;