@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/governance/upgrade.d.ts

@@ -1,142 +1,142 @@
-import { type ExtensionScope, type ManagedExtensionRecord, type ManagedExtensionSource } from "../extension.js";
+import { type ExtensionScope,type ManagedExtensionRecord,type ManagedExtensionSource } from "../extension.js";
 import { type GlobalOptions } from "../runtime-primitives.js";
 /** Documents the upgrade command options payload exchanged by command, SDK, and package integrations. */
 export interface UpgradeCommandOptions {
 /** Managed package scope selected by structured SDK and MCP clients. */
-scope?: ExtensionScope;
+scope?:ExtensionScope;
 /** Value that configures or reports dry run for this contract. */
-dryRun?: boolean;
+dryRun?:boolean;
 /** Value that configures or reports cli only for this contract. */
-cliOnly?: boolean;
+cliOnly?:boolean;
 /** Value that configures or reports packages only for this contract. */
-packagesOnly?: boolean;
+packagesOnly?:boolean;
 /** Value that configures or reports project for this contract. */
-project?: boolean;
+project?:boolean;
 /** Value that configures or reports local for this contract. */
-local?: boolean;
+local?:boolean;
 /** Value that configures or reports global for this contract. */
-global?: boolean;
+global?:boolean;
 /** Value that configures or reports repair for this contract. */
-repair?: boolean;
+repair?:boolean;
 /** Value that configures or reports tag for this contract. */
-tag?: string;
+tag?:string;
 /** Value that configures or reports package name for this contract. */
-packageName?: string;
+packageName?:string;
 /** Value that configures or reports command runner for this contract. */
-commandRunner?: UpgradeCommandRunner;
+commandRunner?:UpgradeCommandRunner;
 }
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-defaultCommandRunner: typeof defaultCommandRunner;
-isLocalNpmSpec: typeof isLocalNpmSpec;
-normalizeTarget: typeof normalizeTarget;
-packageRecordMatchesTarget: typeof packageRecordMatchesTarget;
-resolveCliPackage: typeof resolveCliPackage;
-resolvePackageInstallSource: typeof resolvePackageInstallSource;
-resolveRunnablePackageSource: typeof resolveRunnablePackageSource;
-resolveScope: typeof resolveScope;
-resolveTag: typeof resolveTag;
-packageCommandFor: typeof packageCommandFor;
-summarize: typeof summarize;
+export declare const _testOnly:{
+defaultCommandRunner:typeof defaultCommandRunner;
+isLocalNpmSpec:typeof isLocalNpmSpec;
+normalizeTarget:typeof normalizeTarget;
+packageRecordMatchesTarget:typeof packageRecordMatchesTarget;
+resolveCliPackage:typeof resolveCliPackage;
+resolvePackageInstallSource:typeof resolvePackageInstallSource;
+resolveRunnablePackageSource:typeof resolveRunnablePackageSource;
+resolveScope:typeof resolveScope;
+resolveTag:typeof resolveTag;
+packageCommandFor:typeof packageCommandFor;
+summarize:typeof summarize;
 };
 /** Documents the upgrade command runner result payload exchanged by command, SDK, and package integrations. */
 export interface UpgradeCommandRunnerResult {
 /** Value that configures or reports stdout for this contract. */
-stdout: string;
+stdout:string;
 /** Value that configures or reports stderr for this contract. */
-stderr: string;
+stderr:string;
 }
 /** Restricts upgrade command runner values accepted by command, SDK, and storage contracts. */
-export type UpgradeCommandRunner = (command: string, args: string[], options?: {
-cwd?: string;
+export type UpgradeCommandRunner = (command:string,args:string[],options?:{
+cwd?:string;
 }) => Promise<UpgradeCommandRunnerResult>;
 /** Documents the upgrade cli result payload exchanged by command, SDK, and package integrations. */
 export interface UpgradeCliResult {
 /** Value that configures or reports requested for this contract. */
-requested: boolean;
+requested:boolean;
 /** Lifecycle state reported for status. */
-status: "planned" | "updated" | "failed" | "skipped";
+status:"planned" | "updated" | "failed" | "skipped";
 /** Value that configures or reports package for this contract. */
-package: string;
+package:string;
 /** Value that configures or reports target for this contract. */
-target: string;
+target:string;
 /** Value that configures or reports command for this contract. */
-command: string[];
+command:string[];
 /** Package-owned command migrations relevant to this CLI upgrade plan or outcome. */
-migration_guidance?: string[];
+migration_guidance?:string[];
 /** Value that configures or reports before version for this contract. */
-before_version?: string;
+before_version?:string;
 /** Value that configures or reports after version for this contract. */
-after_version?: string;
+after_version?:string;
 /** Value that configures or reports repair for this contract. */
-repair: boolean;
+repair:boolean;
 /** Value that configures or reports reason for this contract. */
-reason?: string;
+reason?:string;
 /** Value that configures or reports error for this contract. */
-error?: string;
+error?:string;
 }
 /** Documents the upgrade package result payload exchanged by command, SDK, and package integrations. */
 export interface UpgradePackageResult {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports directory for this contract. */
-directory: string;
+directory:string;
 /** Value that configures or reports scope for this contract. */
-scope: ExtensionScope;
+scope:ExtensionScope;
 /** Value that configures or reports source for this contract. */
-source: ManagedExtensionSource;
+source:ManagedExtensionSource;
 /** Lifecycle state reported for status. */
-status: "planned" | "updated" | "failed" | "skipped";
+status:"planned" | "updated" | "failed" | "skipped";
 /** Value that configures or reports command for this contract. */
-command: string[];
+command:string[];
 /** Value that configures or reports previous version for this contract. */
-previous_version: string;
+previous_version:string;
 /** Value that configures or reports installed version for this contract. */
-installed_version?: string;
+installed_version?:string;
 /** Value that configures or reports reason for this contract. */
-reason?: string;
+reason?:string;
 /** Value that configures or reports error for this contract. */
-error?: string;
+error?:string;
 }
 /** Documents the upgrade result payload exchanged by command, SDK, and package integrations. */
 export interface UpgradeResult {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Value that configures or reports action for this contract. */
-action: "upgrade";
+action:"upgrade";
 /** Value that configures or reports dry run for this contract. */
-dry_run: boolean;
+dry_run:boolean;
 /** Value that configures or reports scope for this contract. */
-scope: ExtensionScope;
+scope:ExtensionScope;
 /** Value that configures or reports target for this contract. */
-target?: string;
+target?:string;
 /** Value that configures or reports cli for this contract. */
-cli: UpgradeCliResult;
+cli:UpgradeCliResult;
 /** Value that configures or reports packages for this contract. */
-packages: UpgradePackageResult[];
+packages:UpgradePackageResult[];
 /** Value that configures or reports summary for this contract. */
-summary: {
-requested_cli: boolean;
-requested_packages: boolean;
-planned: number;
-updated: number;
-skipped: number;
-failed: number;
+summary:{
+requested_cli:boolean;
+requested_packages:boolean;
+planned:number;
+updated:number;
+skipped:number;
+failed:number;
 };
 }
-declare function resolveScope(options: UpgradeCommandOptions): ExtensionScope;
-declare function normalizeTarget(value: string): string;
-declare function packageRecordMatchesTarget(record: ManagedExtensionRecord, target: string): boolean;
-declare function defaultCommandRunner(command: string, args: string[], options?: {
-cwd?: string;
-}): Promise<UpgradeCommandRunnerResult>;
-declare function resolveTag(options: UpgradeCommandOptions): string;
-declare function resolveCliPackage(options: UpgradeCommandOptions): string;
-declare function isLocalNpmSpec(spec: string): boolean;
-declare function resolvePackageInstallSource(source: ManagedExtensionSource, tag: string): string;
-declare function resolveRunnablePackageSource(source: ManagedExtensionSource, tag: string): Promise<string>;
-declare function packageCommandFor(source: ManagedExtensionSource, installSource: string, scope: ExtensionScope, ref?: string): string[];
-declare function summarize(cli: UpgradeCliResult, packages: UpgradePackageResult[], includeCli: boolean, includePackages: boolean): UpgradeResult["summary"];
+declare function resolveScope(options:UpgradeCommandOptions):ExtensionScope;
+declare function normalizeTarget(value:string):string;
+declare function packageRecordMatchesTarget(record:ManagedExtensionRecord,target:string):boolean;
+declare function defaultCommandRunner(command:string,args:string[],options?:{
+cwd?:string;
+}):Promise<UpgradeCommandRunnerResult>;
+declare function resolveTag(options:UpgradeCommandOptions):string;
+declare function resolveCliPackage(options:UpgradeCommandOptions):string;
+declare function isLocalNpmSpec(spec:string):boolean;
+declare function resolvePackageInstallSource(source:ManagedExtensionSource,tag:string):string;
+declare function resolveRunnablePackageSource(source:ManagedExtensionSource,tag:string):Promise<string>;
+declare function packageCommandFor(source:ManagedExtensionSource,installSource:string,scope:ExtensionScope,ref?:string):string[];
+declare function summarize(cli:UpgradeCliResult,packages:UpgradePackageResult[],includeCli:boolean,includePackages:boolean):UpgradeResult["summary"];
 /** Implements run upgrade for the public runtime surface of this module. */
-export declare function runUpgrade(target: string | undefined, options: UpgradeCommandOptions, global: GlobalOptions): Promise<UpgradeResult>;
+export declare function runUpgrade(target:string | undefined,options:UpgradeCommandOptions,global:GlobalOptions):Promise<UpgradeResult>;
 export {};

package/dist/sdk/governance/validate-history-drift.d.ts

@@ -1,7 +1,7 @@
 import type { ValidateCheck } from "./validate.js";
 import type { ValidateItem } from "./validate-item-reader.js";
 /** Build the validation warning and bounded evidence projection for history drift. */
-export declare function buildValidateHistoryDriftCheck(pmRoot: string, items: ValidateItem[], verboseDiagnostics: boolean): Promise<{
-check: ValidateCheck;
-warnings: string[];
+export declare function buildValidateHistoryDriftCheck(pmRoot:string,items:ValidateItem[],verboseDiagnostics:boolean):Promise<{
+check:ValidateCheck;
+warnings:string[];
 }>;

package/dist/sdk/governance/validate-item-reader.d.ts

@@ -1,13 +1,13 @@
-import type { ItemMetadata, PmSettings } from "../../types/index.js";
+import type { ItemMetadata,PmSettings } from "../../types/index.js";
 /** Item projection accepted by validate checks; body is read only for strict drift verification. */
 export type ValidateItem = ItemMetadata & {
-body: string;
+body:string;
 };
 /** Load collections for normal checks and add bodies only when history hashes must be verified. */
-export declare function readValidateItems(params: {
-includeBody: boolean;
-pmRoot: string;
-settings: PmSettings;
-typeToFolder: Record<string, string>;
-warnings: string[];
-}): Promise<ValidateItem[]>;
+export declare function readValidateItems(params:{
+includeBody:boolean;
+pmRoot:string;
+settings:PmSettings;
+typeToFolder:Record<string,string>;
+warnings:string[];
+}):Promise<ValidateItem[]>;

package/dist/sdk/governance/validate-normalization.d.ts

@@ -1,8 +1,8 @@
 /** Normalize a repository-relative path to stable forward-slash form. */
-export declare function normalizeRelativePath(value: string): string;
+export declare function normalizeRelativePath(value:string):string;
 /** Normalize a repository-relative directory without trailing separators. */
-export declare function normalizeRelativeDirectoryPath(value: string): string;
+export declare function normalizeRelativeDirectoryPath(value:string):string;
 /** Treat blank and legacy null-like metadata tokens as absent values. */
-export declare function toMeaningfulString(value: unknown): string | undefined;
+export declare function toMeaningfulString(value:unknown):string | undefined;
 /** Collapse a linked command to the bounded preview used in validation rows. */
-export declare function summarizeCommandPreview(command: string): string;
+export declare function summarizeCommandPreview(command:string):string;