@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/core/shared/command-types.d.ts

@@ -5,44 +5,44 @@
  */
 /** Carries process-wide CLI options shared by command handlers and runtime adapters. */
 export interface GlobalOptions {
-    /** Value that configures or reports json for this contract. */
-    json?: boolean;
-    /** Value that configures or reports quiet for this contract. */
-    quiet?: boolean;
-    /** Value that configures or reports no changed fields for this contract. */
-    noChangedFields?: boolean;
-    /** Preserve the legacy full mutation envelope and changed-fields array. */
-    fullChangedFields?: boolean;
-    /** Value that configures or reports id only for this contract. */
-    idOnly?: boolean;
-    /** Omit null and empty containers from JSON output. */
-    lean?: boolean;
-    /** Attach a bounded receipt attributing the emitted output token cost. */
-    tokenAccounting?: boolean;
-    /** Canonical comma-separated fields or sections retained in read output. */
-    outputInclude?: string;
-    /** Canonical maximum row count retained in read output. */
-    outputLimit?: string;
-    /** Canonical estimated-token ceiling for read output. */
-    outputBudget?: string;
-    /** Canonical renderer encoding for read output. */
-    outputFormat?: "toon" | "json";
-    /** Caller-carried cross-call budget and served-item state. */
-    outputSession?: string;
-    /** Opaque budget-compaction continuation cursor. */
-    outputCursor?: string;
-    /** Include the machine-readable row selector and TOON encoding contract. */
-    outputRowContract?: boolean;
-    /** Filesystem path used for path resolution. */
-    path?: string;
-    /** Value that configures or reports no extensions for this contract. */
-    noExtensions?: boolean;
-    /** Value that configures or reports no pager for this contract. */
-    noPager?: boolean;
-    /** Value that configures or reports profile for this contract. */
-    profile?: boolean;
-    /** Invocation-wide mutation author override. */
-    author?: string;
-    /** Fallback output format used when callers do not provide an override. */
-    defaultOutputFormat?: "toon" | "json";
+/** Value that configures or reports json for this contract. */
+json?: boolean;
+/** Value that configures or reports quiet for this contract. */
+quiet?: boolean;
+/** Value that configures or reports no changed fields for this contract. */
+noChangedFields?: boolean;
+/** Preserve the legacy full mutation envelope and changed-fields array. */
+fullChangedFields?: boolean;
+/** Value that configures or reports id only for this contract. */
+idOnly?: boolean;
+/** Omit null and empty containers from JSON output. */
+lean?: boolean;
+/** Attach a bounded receipt attributing the emitted output token cost. */
+tokenAccounting?: boolean;
+/** Canonical comma-separated fields or sections retained in read output. */
+outputInclude?: string;
+/** Canonical maximum row count retained in read output. */
+outputLimit?: string;
+/** Canonical estimated-token ceiling for read output. */
+outputBudget?: string;
+/** Canonical renderer encoding for read output. */
+outputFormat?: "toon" | "json";
+/** Caller-carried cross-call budget and served-item state. */
+outputSession?: string;
+/** Opaque budget-compaction continuation cursor. */
+outputCursor?: string;
+/** Include the machine-readable row selector and TOON encoding contract. */
+outputRowContract?: boolean;
+/** Filesystem path used for path resolution. */
+path?: string;
+/** Value that configures or reports no extensions for this contract. */
+noExtensions?: boolean;
+/** Value that configures or reports no pager for this contract. */
+noPager?: boolean;
+/** Value that configures or reports profile for this contract. */
+profile?: boolean;
+/** Invocation-wide mutation author override. */
+author?: string;
+/** Fallback output format used when callers do not provide an override. */
+defaultOutputFormat?: "toon" | "json";
 }

package/dist/core/shared/conflict-markers.d.ts

@@ -5,12 +5,12 @@
  */
 /** Describes a detected unresolved merge-conflict marker and its source location. */
 export interface ConflictMarkerMatch {
-    /** Value that configures or reports line for this contract. */
-    line: number;
-    /** Value that configures or reports marker for this contract. */
-    marker: "<<<<<<<" | "=======" | ">>>>>>>";
-    /** Value that configures or reports text for this contract. */
-    text: string;
+/** Value that configures or reports line for this contract. */
+line: number;
+/** Value that configures or reports marker for this contract. */
+marker: "<<<<<<<" | "=======" | ">>>>>>>";
+/** Value that configures or reports text for this contract. */
+text: string;
 }
 /** Implements find merge conflict markers for the public runtime surface of this module. */
 export declare function findMergeConflictMarkers(content: string): ConflictMarkerMatch[];

package/dist/core/shared/constants.d.ts

@@ -36,27 +36,27 @@ export declare const GOVERNANCE_PRESET_DEFAULTS: Record<BuiltinGovernancePreset,
 export declare const DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS: readonly ["no active blocker", "ready for planned execution sequencing", "work completed", "work is closed"];
 /** Fallback validate closure like metadata field patterns used when callers do not provide an override. */
 export declare const DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS: {
-    readonly blocked_reason: readonly ["no active blocker because work is closed", "work is closed"];
-    readonly resolution: readonly ["closed with implementation evidence", "closed with verification evidence", "work completed and recorded", "work is closed"];
-    readonly actual_result: readonly ["closed and recorded", "work completed", "work completed and recorded"];
+readonly blocked_reason: readonly ["no active blocker because work is closed", "work is closed"];
+readonly resolution: readonly ["closed with implementation evidence", "closed with verification evidence", "work completed and recorded", "work is closed"];
+readonly actual_result: readonly ["closed and recorded", "work completed", "work completed and recorded"];
 };
 /** Public contract for settings defaults, shared by SDK and presentation-layer consumers. */
 export declare const SETTINGS_DEFAULTS: PmSettings;
 /** Public contract for empty canonical document, shared by SDK and presentation-layer consumers. */
 export declare const EMPTY_CANONICAL_DOCUMENT: {
-    metadata: {};
-    body: string;
+metadata: {};
+body: string;
 };
 /** Public contract for exit code, shared by SDK and presentation-layer consumers. */
 export declare const EXIT_CODE: {
-    readonly SUCCESS: 0;
-    readonly GENERIC_FAILURE: 1;
-    readonly USAGE: 2;
-    readonly NOT_FOUND: 3;
-    readonly CONFLICT: 4;
-    readonly DEPENDENCY_FAILED: 5;
-    readonly NO_EFFECT: 6;
-    readonly PARTIAL_EFFECT: 7;
+readonly SUCCESS: 0;
+readonly GENERIC_FAILURE: 1;
+readonly USAGE: 2;
+readonly NOT_FOUND: 3;
+readonly CONFLICT: 4;
+readonly DEPENDENCY_FAILED: 5;
+readonly NO_EFFECT: 6;
+readonly PARTIAL_EFFECT: 7;
 };
 /** Restricts telemetry error category values accepted by command, SDK, and storage contracts. */
 export type TelemetryErrorCategory = "usage" | "validation" | "conflict" | "runtime" | "unknown";

package/dist/core/shared/errors.d.ts

@@ -5,193 +5,204 @@
  */
 /** Carries structured recovery guidance attached to expected pm CLI errors. */
 export interface PmCliErrorRecoveryPayload {
-    /** Strategy used to control recovery behavior. */
-    recovery_mode?: "compact";
-    /** Value that configures or reports attempted command for this contract. */
-    attempted_command?: string;
-    /** Value that configures or reports normalized args for this contract. */
-    normalized_args?: string[];
-    /** Positional tokens paired with their parser roles for unambiguous recovery. */
-    parsed_positionals?: Array<{
-        role: string;
-        value: string;
-    }>;
-    /** Value that configures or reports provided fields for this contract. */
-    provided_fields?: string[];
-    /** Value that configures or reports missing for this contract. */
-    missing?: string[];
-    /** Value that configures or reports missing required fields for this contract. */
-    missing_required_fields?: string[];
-    /** Value that configures or reports suggested flags for this contract. */
-    suggested_flags?: string[];
-    /** Complete allowed value set for a refused positional or enum token. */
-    allowed_values?: string[];
-    /** Ranked command paths that accept an option rejected on the attempted path. */
-    candidate_commands?: string[];
-    /** Complete number of accepting command paths before the recovery ceiling. */
-    candidate_commands_total?: number;
-    /** Whether additional accepting command paths were omitted from this payload. */
-    candidate_commands_truncated?: boolean;
-    /** Declared lexicon membership of an option rejected by the attempted path. */
-    option_scope?: "declared_on_path" | "declared_elsewhere" | "declared_nowhere";
-    /** Value that configures or reports suggested retry for this contract. */
-    suggested_retry?: string;
-    /** Tokenized retry arguments for direct execution without reparsing display text. */
-    suggested_retry_args?: string[];
-    /** Elapsed time in milliseconds for retry after. */
-    retry_after_ms?: number;
-    /** Value that configures or reports fallback candidates for this contract. */
-    fallback_candidates?: Array<{
-        source: string;
-        command: string;
-        reason: string;
-    }>;
-    /** Value that configures or reports next best command for this contract. */
-    next_best_command?: string;
+/** Strategy used to control recovery behavior. */
+recovery_mode?: "compact";
+/** Value that configures or reports attempted command for this contract. */
+attempted_command?: string;
+/** Value that configures or reports normalized args for this contract. */
+normalized_args?: string[];
+/** Positional tokens paired with their parser roles for unambiguous recovery. */
+parsed_positionals?: Array<{
+role: string;
+value: string;
+}>;
+/** Value that configures or reports provided fields for this contract. */
+provided_fields?: string[];
+/** Value that configures or reports missing for this contract. */
+missing?: string[];
+/** Value that configures or reports missing required fields for this contract. */
+missing_required_fields?: string[];
+/** Value that configures or reports suggested flags for this contract. */
+suggested_flags?: string[];
+/** Complete allowed value set for a refused positional or enum token. */
+allowed_values?: string[];
+/** Ranked command paths that accept an option rejected on the attempted path. */
+candidate_commands?: string[];
+/** Complete number of accepting command paths before the recovery ceiling. */
+candidate_commands_total?: number;
+/** Whether additional accepting command paths were omitted from this payload. */
+candidate_commands_truncated?: boolean;
+/** Declared lexicon membership of an option rejected by the attempted path. */
+option_scope?: "declared_on_path" | "declared_elsewhere" | "declared_nowhere";
+/** Value that configures or reports suggested retry for this contract. */
+suggested_retry?: string;
+/** Tokenized retry arguments for direct execution without reparsing display text. */
+suggested_retry_args?: string[];
+/** Elapsed time in milliseconds for retry after. */
+retry_after_ms?: number;
+/** Value that configures or reports fallback candidates for this contract. */
+fallback_candidates?: Array<{
+source: string;
+command: string;
+reason: string;
+}>;
+/** Value that configures or reports next best command for this contract. */
+next_best_command?: string;
 }
 /** Documents the pm cli error context payload exchanged by command, SDK, and package integrations. */
 export interface PmCliErrorContext {
-    /** Value that configures or reports code for this contract. */
-    code?: string;
-    /** Canonical existing item identity returned by a refused create operation. */
-    id?: string;
-    /** Actual persisted existing-item path returned by a refused create operation. */
-    path?: string;
-    /** Item whose document could not be decoded or parsed. */
-    item_id?: string;
-    /** Ordered mutation that failed semantic preview validation. */
-    transaction_operation?: {
-        /** Zero-based position in the resolved batch. */
-        index: number;
-        /** Mutation kind from the resolved batch. */
-        op: string;
-        /** Resolved target identity. */
-        id: string;
-    };
-    /** Verified retained deletion and the latest recoverable durable address. */
-    tombstone?: {
-        /** The retained stream proves the item is currently deleted. */
-        deleted: true;
-        /** Timestamp of the most recent recorded deletion. */
-        deleted_at: string;
-        /** Whether a retained materialized state has an unambiguous recovery address. */
-        recoverable: boolean;
-        /** Durable version before deletion, or null when compaction lost the mapping. */
-        last_materialized_version: number | null;
-    };
-    /** Bounded policy violations explaining a refused mutation without item values. */
-    policy_violations?: Array<{
-        /** Stable declaration that refused the mutation. */
-        policy_id: string;
-        /** Requirement kind evaluated by the policy engine. */
-        rule: string;
-        /** Workspace-authored rationale, when declared. */
-        description?: string;
-        /** Required metadata paths absent from the proposed record. */
-        missing_fields: string[];
-    }>;
-    /** Total violations before the diagnostic's three-policy ceiling. */
-    policy_violation_count?: number;
-    /** Exact filesystem path of the unreadable item document. */
-    item_path?: string;
-    /** Tracker-relative documents claiming the same item identity. */
-    paths?: string[];
-    /** Original document size before decoding or parsing. */
-    byte_length?: number;
-    /** Whether the original item document contained no bytes. */
-    empty?: boolean;
-    /** Stable failure class within the operation-specific error code. */
-    reason?: string;
-    /** Metadata field responsible for a validation failure, when known. */
-    field?: string;
-    /** Assurance gate whose evaluation was refused, when known. */
-    gate_id?: string;
-    /** Assurance assertion whose evaluation was refused, when known. */
-    assertion_id?: string;
-    /** Assurance measurement whose source could not resolve, when known. */
-    measurement_id?: string;
-    /** Assurance measurement source kind involved in a refusal, when known. */
-    source_kind?: string;
-    /** Source item whose endpoint metadata violated a relationship contract. */
-    source_id?: string;
-    /** Source item creation time used to evaluate a temporal relationship contract. */
-    source_created_at?: string;
-    /** Target item whose endpoint metadata violated a relationship contract. */
-    target_id?: string;
-    /** Target item creation time used to evaluate a temporal relationship contract. */
-    target_created_at?: string;
-    /** Temporal relationship rule evaluated for the source and target. */
-    temporal_order?: string;
-    /** Validate or health check selected by an assurance source, when known. */
-    check?: string;
-    /** Serialization format involved in a parse failure. */
-    format?: string;
-    /** CLI flag whose supplied value violated a shared mutation grammar. */
-    flag?: string;
-    /** Supplied scalar value that violated a shared mutation grammar. */
-    value?: string;
-    /** Item format version involved in a compatibility failure. */
-    format_version?: number;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: string;
-    /** Value that configures or reports required for this contract. */
-    required?: string;
-    /** Value that configures or reports why for this contract. */
-    why?: string;
-    /** Filesystem path selected by target resolution, when relevant. */
-    resolved_path?: string;
-    /** Filesystem path from which target resolution began, when relevant. */
-    requested_path?: string;
-    /** Safer explicit filesystem target suggested for recovery. */
-    suggested_path?: string;
-    /** Value that configures or reports examples for this contract. */
-    examples?: string[];
-    /** Value that configures or reports next steps for this contract. */
-    nextSteps?: string[];
-    /** Exact selectors that could not be matched by a lossless removal. */
-    unmatched?: string[];
-    /** Dependency selectors that matched no stored edge. */
-    unmatched_selectors?: Array<{
-        id: string;
-        kind?: string;
-        source_kind?: string;
-        author?: string;
-        created_at?: string;
-    }>;
-    /** Compact stored dependency identities available when a removal failed. */
-    available_dependencies?: Array<{
-        id: string;
-        kind: string;
-        source_kind?: string;
-        author?: string;
-        created_at?: string;
-    }>;
-    /** Exact verifier findings that caused an integrity-sensitive operation to refuse. */
-    verification_errors?: string[];
-    /** Local dependency targets that could not be resolved before mutation. */
-    unresolved_targets?: string[];
-    /** Available history bounds for a failed point-in-time read or restore target. */
-    valid_range?: {
-        /** Earliest available one-based version, or null for an empty stream. */
-        first_version: number | null;
-        /** Latest available one-based version, or null for an empty stream. */
-        last_version: number | null;
-        /** Earliest available history timestamp, or null for an empty stream. */
-        first_timestamp: string | null;
-        /** Latest available history timestamp, or null for an empty stream. */
-        last_timestamp: string | null;
-    };
-    /** Value that configures or reports recovery for this contract. */
-    recovery?: PmCliErrorRecoveryPayload;
+/** Value that configures or reports code for this contract. */
+code?: string;
+/** Canonical existing item identity returned by a refused create operation. */
+id?: string;
+/** Actual persisted existing-item path returned by a refused create operation. */
+path?: string;
+/** Item whose document could not be decoded or parsed. */
+item_id?: string;
+/** Ordered mutation that failed semantic preview validation. */
+transaction_operation?: {
+/** Zero-based position in the resolved batch. */
+index: number;
+/** Mutation kind from the resolved batch. */
+op: string;
+/** Resolved target identity. */
+id: string;
+};
+/** Verified retained deletion and the latest recoverable durable address. */
+tombstone?: {
+/** The retained stream proves the item is currently deleted. */
+deleted: true;
+/** Timestamp of the most recent recorded deletion. */
+deleted_at: string;
+/** Whether a retained materialized state has an unambiguous recovery address. */
+recoverable: boolean;
+/** Durable version before deletion, or null when compaction lost the mapping. */
+last_materialized_version: number | null;
+};
+/** Bounded policy violations explaining a refused mutation without item values. */
+policy_violations?: Array<{
+/** Stable declaration that refused the mutation. */
+policy_id: string;
+/** Requirement kind evaluated by the policy engine. */
+rule: string;
+/** Workspace-authored rationale, when declared. */
+description?: string;
+/** Required metadata paths absent from the proposed record. */
+missing_fields: string[];
+}>;
+/** Total violations before the diagnostic's three-policy ceiling. */
+policy_violation_count?: number;
+/** Exact filesystem path of the unreadable item document. */
+item_path?: string;
+/** Tracker-relative documents claiming the same item identity. */
+paths?: string[];
+/** Original document size before decoding or parsing. */
+byte_length?: number;
+/** Whether the original item document contained no bytes. */
+empty?: boolean;
+/** Stable failure class within the operation-specific error code. */
+reason?: string;
+/** Metadata field responsible for a validation failure, when known. */
+field?: string;
+/** Assurance gate whose evaluation was refused, when known. */
+gate_id?: string;
+/** Assurance assertion whose evaluation was refused, when known. */
+assertion_id?: string;
+/** Assurance measurement whose source could not resolve, when known. */
+measurement_id?: string;
+/** Assurance measurement source kind involved in a refusal, when known. */
+source_kind?: string;
+/** Source item whose endpoint metadata violated a relationship contract. */
+source_id?: string;
+/** Source item creation time used to evaluate a temporal relationship contract. */
+source_created_at?: string;
+/** Target item whose endpoint metadata violated a relationship contract. */
+target_id?: string;
+/** Target item creation time used to evaluate a temporal relationship contract. */
+target_created_at?: string;
+/** Temporal relationship rule evaluated for the source and target. */
+temporal_order?: string;
+/** Active one-edge relationship constraint violated by a prospective mutation. */
+relationship_cardinality?: {
+/** Canonical registered relationship kind. */
+kind: string;
+/** Endpoint orientation whose multiplicity is constrained. */
+direction: "outgoing" | "incoming";
+/** Node whose one-edge constraint would be exceeded. */
+node_id: string;
+/** Distinct conflicting logical endpoints in deterministic order. */
+endpoint_ids: string[];
+};
+/** Validate or health check selected by an assurance source, when known. */
+check?: string;
+/** Serialization format involved in a parse failure. */
+format?: string;
+/** CLI flag whose supplied value violated a shared mutation grammar. */
+flag?: string;
+/** Supplied scalar value that violated a shared mutation grammar. */
+value?: string;
+/** Item format version involved in a compatibility failure. */
+format_version?: number;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: string;
+/** Value that configures or reports required for this contract. */
+required?: string;
+/** Value that configures or reports why for this contract. */
+why?: string;
+/** Filesystem path selected by target resolution, when relevant. */
+resolved_path?: string;
+/** Filesystem path from which target resolution began, when relevant. */
+requested_path?: string;
+/** Safer explicit filesystem target suggested for recovery. */
+suggested_path?: string;
+/** Value that configures or reports examples for this contract. */
+examples?: string[];
+/** Value that configures or reports next steps for this contract. */
+nextSteps?: string[];
+/** Exact selectors that could not be matched by a lossless removal. */
+unmatched?: string[];
+/** Dependency selectors that matched no stored edge. */
+unmatched_selectors?: Array<{
+id: string;
+kind?: string;
+source_kind?: string;
+author?: string;
+created_at?: string;
+}>;
+/** Compact stored dependency identities available when a removal failed. */
+available_dependencies?: Array<{
+id: string;
+kind: string;
+source_kind?: string;
+author?: string;
+created_at?: string;
+}>;
+/** Exact verifier findings that caused an integrity-sensitive operation to refuse. */
+verification_errors?: string[];
+/** Local dependency targets that could not be resolved before mutation. */
+unresolved_targets?: string[];
+/** Available history bounds for a failed point-in-time read or restore target. */
+valid_range?: {
+/** Earliest available one-based version, or null for an empty stream. */
+first_version: number | null;
+/** Latest available one-based version, or null for an empty stream. */
+last_version: number | null;
+/** Earliest available history timestamp, or null for an empty stream. */
+first_timestamp: string | null;
+/** Latest available history timestamp, or null for an empty stream. */
+last_timestamp: string | null;
+};
+/** Value that configures or reports recovery for this contract. */
+recovery?: PmCliErrorRecoveryPayload;
 }
 /** Implements the exported pm cli error runtime abstraction for core/shared/errors.ts. */
 export declare class PmCliError extends Error {
-    /** Value that configures or reports exit code for this contract. */
-    readonly exitCode: number;
-    /** Stable machine-readable code mirrored from context for direct SDK consumption. */
-    readonly code?: string;
-    /** Value that configures or reports context for this contract. */
-    readonly context: PmCliErrorContext;
-    /** Value that configures or reports constructor for this contract. */
-    constructor(message: string, exitCode: number, context?: PmCliErrorContext);
+/** Value that configures or reports exit code for this contract. */
+readonly exitCode: number;
+/** Stable machine-readable code mirrored from context for direct SDK consumption. */
+readonly code?: string;
+/** Value that configures or reports context for this contract. */
+readonly context: PmCliErrorContext;
+/** Value that configures or reports constructor for this contract. */
+constructor(message: string, exitCode: number, context?: PmCliErrorContext);
 }

package/dist/core/shared/errors.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="82886059-8bb7-5765-925f-064c93e3e7c7")}catch{}})();class PmCliError extends Error{exitCode;code;context;constructor(message,exitCode,context={}){super(message),this.name="PmCliError",this.exitCode=exitCode,this.context=context,this.code=context.code}}export{PmCliError};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="06acc04a-fd01-541b-bb84-720824d15b8b")}catch{}})();class PmCliError extends Error{exitCode;code;context;constructor(message,exitCode,context={}){super(message),this.name="PmCliError",this.exitCode=exitCode,this.context=context,this.code=context.code}}export{PmCliError};
 //# sourceMappingURL=errors.js.map