@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/sdk/query.d.ts

@@ -6,10 +6,10 @@
 export * from "./query/list.js";
 export * from "./query/complete-list.js";
 export * from "./query/search.js";
-export { runActivity, type ActivityCommandOptions, type ActivityEntry, type ActivityResult, type CompactActivityEntry, } from "./query/activity.js";
+export { runActivity,type ActivityCommandOptions,type ActivityEntry,type ActivityResult,type CompactActivityEntry,} from "./query/activity.js";
 export * from "./query/aggregate.js";
 export * from "./query/calendar.js";
-export { CONTEXT_OUTPUT_VALUES, applyContextTagProjection, buildChildrenByParent, collectSubtreeIds, compareCriticalItems, mergeSortedWarnings, packRankedContextItems, parseContextDepth, parseContextFocusFields, parseContextSections, projectContextFocusRows, renderContextMarkdown, resolveContextOutputFormat, resolveContextTokenBudget, runContext, toContextFocusItem, toContextPackingSummary, toContextRankingSummary, type BlockerEntry, type ContextAgendaEvent, type ContextFocusItem, type ContextOptions, type ContextOutputFormat, type ContextPackingSummary, type ContextRankingSummary, type ContextResult, type HierarchyChild, type HierarchyNode, type HotFile, type ProgressEntry, type RecentContextItem, type StaleEntry, type TestHealthSummary, type WorkloadEntry, } from "./query/context.js";
+export { CONTEXT_OUTPUT_VALUES,applyContextTagProjection,buildChildrenByParent,collectSubtreeIds,compareCriticalItems,mergeSortedWarnings,packRankedContextItems,parseContextDepth,parseContextFocusFields,parseContextSections,projectContextFocusRows,renderContextMarkdown,resolveContextOutputFormat,resolveContextTokenBudget,runContext,toContextFocusItem,toContextPackingSummary,toContextRankingSummary,type BlockerEntry,type ContextAgendaEvent,type ContextFocusItem,type ContextOptions,type ContextOutputFormat,type ContextPackingSummary,type ContextRankingSummary,type ContextResult,type HierarchyChild,type HierarchyNode,type HotFile,type ProgressEntry,type RecentContextItem,type StaleEntry,type TestHealthSummary,type WorkloadEntry,} from "./query/context.js";
 export * from "./query/get.js";
 export * from "./query/history.js";
 export * from "./query/next.js";
@@ -28,8 +28,8 @@ export * from "./context-signal-store.js";
 export * from "./context-usage.js";
 export * from "./workspace-memory.js";
 export * from "./duplicates.js";
-export { evaluateMetricFloors, parseEvalMetricFloors, EVAL_METRIC_NAMES, type EvalMetricFloors, } from "../core/search/eval-thresholds.js";
-export { analyzeDuplicateItems, type DuplicateItemInput, type DuplicateItemsAnalysis } from "./similarity.js";
-export { measureItemMetadataReadWork, type ItemMetadataReadWork } from "../core/store/item-metadata-read-work.js";
-export { executeEmbeddingBatchesWithRetry, type EmbeddingBatchReceipt, type EmbeddingBatchExecutionOptions, type EmbeddingBatchExecutionResult, type EmbeddingBatchProgressEvent, } from "../core/search/embedding-batches.js";
+export { evaluateMetricFloors,parseEvalMetricFloors,EVAL_METRIC_NAMES,type EvalMetricFloors,} from "../core/search/eval-thresholds.js";
+export { analyzeDuplicateItems,type DuplicateItemInput,type DuplicateItemsAnalysis } from "./similarity.js";
+export { measureItemMetadataReadWork,type ItemMetadataReadWork } from "../core/store/item-metadata-read-work.js";
+export { executeEmbeddingBatchesWithRetry,type EmbeddingBatchReceipt,type EmbeddingBatchExecutionOptions,type EmbeddingBatchExecutionResult,type EmbeddingBatchProgressEvent,} from "../core/search/embedding-batches.js";
 export type { EmbeddingProviderConfig } from "../core/search/providers.js";

package/dist/sdk/read-output/continuation.d.ts

@@ -1,24 +1,24 @@
-import type { PmReadOutputCursorEnvelope, PmReadOutputSurface } from "../read-output-contracts.js";
+import type { PmReadOutputCursorEnvelope,PmReadOutputSurface } from "../read-output-contracts.js";
 /** Stable snapshot policy for a read surface whose probes refresh observation metadata. */
 export interface PmReadOutputContinuationFingerprintPolicy {
 /** Version included in fingerprints so policy changes invalidate older cursors. */
-version: 3;
+version:3;
 /** Declared continuation row paths governed by this policy. */
-paths: readonly string[];
+paths:readonly string[];
 /** Exact direct detail fields excluded for each named dynamic row. */
-ignored_detail_field_names_by_row: Readonly<Record<string, readonly string[]>>;
+ignored_detail_field_names_by_row:Readonly<Record<string,readonly string[]>>;
 /** Promise that verdicts, stable configuration, and nonvolatile evidence remain bound. */
-guarantee: "nonvolatile_snapshot_and_stable_configuration";
+guarantee:"nonvolatile_snapshot_and_stable_configuration";
 }
 /** Command-specific exceptions to complete-row continuation fingerprinting. */
-export declare const PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES: Readonly<Partial<Record<PmReadOutputSurface, PmReadOutputContinuationFingerprintPolicy>>>;
+export declare const PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES:Readonly<Partial<Record<PmReadOutputSurface,PmReadOutputContinuationFingerprintPolicy>>>;
 /** Fingerprint the policy-normalized row snapshot so stable evidence changes fail closed. */
-export declare function readOutputCollectionFingerprint(path: string, value: unknown[] | Record<string, unknown>, command?: PmReadOutputSurface): string;
+export declare function readOutputCollectionFingerprint(path:string,value:unknown[] | Record<string,unknown>,command?:PmReadOutputSurface):string;
 /** Encode one stable declared-row continuation for CLI, SDK, and MCP callers. */
-export declare function encodeReadOutputContinuationCursor(cursor: Omit<PmReadOutputCursorEnvelope, "version">): string;
+export declare function encodeReadOutputContinuationCursor(cursor:Omit<PmReadOutputCursorEnvelope,"version">):string;
 /** Decode and validate one universal declared-row continuation cursor. */
-export declare function decodeReadOutputContinuationCursor(raw: string): PmReadOutputCursorEnvelope;
+export declare function decodeReadOutputContinuationCursor(raw:string):PmReadOutputCursorEnvelope;
 /** Place every non-passing assurance assertion before passing evidence. */
-export declare function prioritizeAssuranceAssertions(result: Record<string, unknown>): Record<string, unknown>;
+export declare function prioritizeAssuranceAssertions(result:Record<string,unknown>):Record<string,unknown>;
 /** Validate and apply a continuation suffix to its declared row collection. */
-export declare function applyReadOutputContinuation(result: Record<string, unknown>, command: PmReadOutputSurface, cursor: PmReadOutputCursorEnvelope | undefined): Record<string, unknown>;
+export declare function applyReadOutputContinuation(result:Record<string,unknown>,command:PmReadOutputSurface,cursor:PmReadOutputCursorEnvelope | undefined):Record<string,unknown>;

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

@@ -1,7 +1,7 @@
 import type { RegisteredExtensionCommandDefinition } from "../../core/extensions/extension-types.js";
 /** Find the winning command declaration by CLI path, SDK action or receipt identity. */
-export declare function resolveExtensionOutputCommand(command: string): RegisteredExtensionCommandDefinition | undefined;
+export declare function resolveExtensionOutputCommand(command:string):RegisteredExtensionCommandDefinition | undefined;
 /** Resolve read permission only from the winning command registration. */
-export declare function resolveExtensionReadOutput(command: string): RegisteredExtensionCommandDefinition | undefined;
+export declare function resolveExtensionReadOutput(command:string):RegisteredExtensionCommandDefinition | undefined;
 /** Validate declared rows before projection and attach the host-owned row contract. */
-export declare function attachExtensionReadOutputRows(command: string, result: unknown): unknown;
+export declare function attachExtensionReadOutputRows(command:string,result:unknown):unknown;

package/dist/sdk/read-output/options.d.ts

@@ -4,13 +4,13 @@
  * Shares universal presentation controls without loading read execution code.
  */
 /** Canonical field, amount, cost and encoding controls for every read surface. */
-export declare const READ_OUTPUT_DIMENSION_FLAGS: {
-readonly include: "--output-include";
-readonly amount: "--output-limit";
-readonly cost: "--output-budget";
-readonly encoding: "--output-format";
+export declare const READ_OUTPUT_DIMENSION_FLAGS:{
+readonly include:"--output-include";
+readonly amount:"--output-limit";
+readonly cost:"--output-budget";
+readonly encoding:"--output-format";
 };
 /** Presentation-only controls composing universal output shaping across calls. */
-export declare const READ_OUTPUT_COMPOSITION_FLAGS: readonly ["--output-session", "--output-cursor", "--output-row-contract"];
+export declare const READ_OUTPUT_COMPOSITION_FLAGS:readonly ["--output-session","--output-cursor","--output-row-contract"];
 /** Built-in command roots whose primary operation is a read. */
-export declare const PM_READ_OUTPUT_SURFACES: readonly ["list", "context", "search", "get", "next", "health", "deps", "graph", "history", "activity", "validate", "events", "contracts", "comments", "notes", "files", "docs", "stats", "aggregate", "duplicates", "package-catalog", "package-manage", "comments-audit", "assurance"];
+export declare const PM_READ_OUTPUT_SURFACES:readonly ["list","context","search","get","next","health","deps","graph","history","activity","validate","events","contracts","comments","notes","files","docs","stats","aggregate","duplicates","package-catalog","package-manage","comments-audit","assurance"];

package/dist/sdk/read-output/provenance.d.ts

@@ -4,17 +4,17 @@
  * Retains private invocation-origin evidence through SDK option normalization.
  */
 /** Private invocation origin shared by SDK option construction and read-output resolution. */
-export declare const READ_OUTPUT_INVOCATION_PROVENANCE: unique symbol;
+export declare const READ_OUTPUT_INVOCATION_PROVENANCE:unique symbol;
 /** Internal evidence that distinguishes caller aliases from forwarded command options. */
 export interface PmReadOutputInvocationProvenance {
 /** Canonical include modes forwarded through command-local option keys. */
-canonical_include_modes: string[];
+canonical_include_modes:string[];
 /** Compatibility aliases observed before defaults or canonical forwarding. */
-explicit_legacy_aliases: string[];
+explicit_legacy_aliases:string[];
 /** Whether the CLI captured the complete set of caller-supplied aliases. */
-cli_invocation_observed?: boolean;
+cli_invocation_observed?:boolean;
 /** Whether an SDK helper constructed every command-local option itself. */
-sdk_invocation_observed?: boolean;
+sdk_invocation_observed?:boolean;
 }
 /** Mark a complete SDK helper request so internal command options are not reported as caller aliases. */
-export declare function markCanonicalSdkReadOutputOptions<Options extends object>(options: Options, canonicalIncludeModes: readonly string[]): Options;
+export declare function markCanonicalSdkReadOutputOptions<Options extends object>(options:Options,canonicalIncludeModes:readonly string[]):Options;

package/dist/sdk/read-output-budget.d.ts

@@ -1,32 +1,32 @@
 import type { PmReadOutputReceipt } from "./read-output-contracts.js";
 /** Project a standard item read to brief depth, preserving metadata and disclosing every removed section. */
-export declare function projectReadOutputItemToBrief(command: string, options: Record<string, unknown>, result: Record<string, unknown>): Record<string, unknown> | undefined;
+export declare function projectReadOutputItemToBrief(command:string,options:Record<string,unknown>,result:Record<string,unknown>):Record<string,unknown> | undefined;
 /** Input to the deterministic finite-retry recommendation contract. */
 export interface PmReadOutputRecoveryBudgetInput {
 /** Ceiling that already bound and truncated the response. */
-effective_budget_tokens: number;
+effective_budget_tokens:number;
 /** Measured cost of the useful result before row compaction. */
-measured_result_tokens: number;
+measured_result_tokens:number;
 }
 /** Executable next-budget recommendation shared by CLI, SDK, and MCP. */
 export interface PmReadOutputRecoveryBudget {
 /** Rounded finite retry ceiling, or the only truthful safe fallback. */
-output_budget: number | "unbounded";
+output_budget:number | "unbounded";
 /** Ratio to the binding request, absent when finite arithmetic is unsafe. */
-recovery_budget_multiplier: number | null;
+recovery_budget_multiplier:number | null;
 /** Stable algorithm revision for consumers and fixtures. */
-rule_version: "v1";
+rule_version:"v1";
 }
 /**
  * Recommend a retry that is strictly larger than both the binding request and
  * the pre-compaction result, with a 25% envelope margin rounded to 100 tokens.
  */
-export declare function resolveReadOutputRecoveryBudget(input: PmReadOutputRecoveryBudgetInput): PmReadOutputRecoveryBudget;
+export declare function resolveReadOutputRecoveryBudget(input:PmReadOutputRecoveryBudgetInput):PmReadOutputRecoveryBudget;
 /** Preserve an internal row declaration across clones without charging it as emitted metadata. */
-export declare function preserveReadOutputRowContract(source: Record<string, unknown>, target: Record<string, unknown>, suppress?: boolean): void;
+export declare function preserveReadOutputRowContract(source:Record<string,unknown>,target:Record<string,unknown>,suppress?:boolean):void;
 /** Estimate UTF-8 token cost using the selected JSON/TOON renderer, or compact JSON for structured SDK calls without a renderer. */
-export declare function estimateReadOutputTokens(result: unknown, format?: "json" | "toon"): number;
+export declare function estimateReadOutputTokens(result:unknown,format?:"json" | "toon"):number;
 /** Update a receipt to the fixed-point estimate of the result containing it. */
-export declare function updateReadOutputReceiptEstimate(result: Record<string, unknown>, receipt: PmReadOutputReceipt, format?: "json" | "toon"): void;
+export declare function updateReadOutputReceiptEstimate(result:Record<string,unknown>,receipt:PmReadOutputReceipt,format?:"json" | "toon"):void;
 /** Compact strings and rows in place, then return the final exact estimate. */
-export declare function compactReadOutputToBudget(result: Record<string, unknown>, receipt: PmReadOutputReceipt, budget: number, minimumRowsByPath?: ReadonlyMap<string, number>, format?: "json" | "toon", finalize?: (result: Record<string, unknown>) => void, preserveStrings?: boolean): Record<string, unknown>;
+export declare function compactReadOutputToBudget(result:Record<string,unknown>,receipt:PmReadOutputReceipt,budget:number,minimumRowsByPath?:ReadonlyMap<string,number>,format?:"json" | "toon",finalize?:(result:Record<string,unknown>) => void,preserveStrings?:boolean):Record<string,unknown>;

package/dist/sdk/read-output-contracts.d.ts

@@ -6,12 +6,12 @@
  */
 import { PM_READ_OUTPUT_SURFACES } from "./read-output/options.js";
 export { resolveReadOutputRecoveryBudget } from "./read-output-budget.js";
-export type { PmReadOutputRecoveryBudget, PmReadOutputRecoveryBudgetInput, } from "./read-output-budget.js";
-export { decodeReadOutputContinuationCursor, encodeReadOutputContinuationCursor, PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES, readOutputCollectionFingerprint, } from "./read-output/continuation.js";
+export type { PmReadOutputRecoveryBudget,PmReadOutputRecoveryBudgetInput,} from "./read-output-budget.js";
+export { decodeReadOutputContinuationCursor,encodeReadOutputContinuationCursor,PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES,readOutputCollectionFingerprint,} from "./read-output/continuation.js";
 export type { PmReadOutputContinuationFingerprintPolicy } from "./read-output/continuation.js";
-import { type PmReadOutputSessionReceipt, type PmReadOutputSessionState } from "./read-output-session.js";
+import { type PmReadOutputSessionReceipt,type PmReadOutputSessionState } from "./read-output-session.js";
 /** Stable output dimensions shared by every read surface. */
-export declare const PM_READ_OUTPUT_DIMENSIONS: readonly ["include", "amount", "cost", "encoding"];
+export declare const PM_READ_OUTPUT_DIMENSIONS:readonly ["include","amount","cost","encoding"];
 /** One member of the universal read-output dimension set. */
 export type PmReadOutputDimension = (typeof PM_READ_OUTPUT_DIMENSIONS)[number];
 export { PM_READ_OUTPUT_SURFACES } from "./read-output/options.js";
@@ -20,234 +20,234 @@ export type PmReadOutputSurface = (typeof PM_READ_OUTPUT_SURFACES)[number] | `ex
 /** Canonical output controls accepted by every built-in read action. */
 export interface PmReadOutputOptions {
 /** Comma-separated fields or sections retained in the result. */
-outputInclude?: string | string[];
+outputInclude?:string | string[];
 /** Maximum rows retained, or `unbounded` to disable the shared row ceiling. */
-outputLimit?: string | number | "unbounded";
+outputLimit?:string | number | "unbounded";
 /** Maximum estimated result tokens, or `unbounded` to disable the default ceiling. */
-outputBudget?: string | number | "unbounded";
+outputBudget?:string | number | "unbounded";
 /** Requested static renderer encoding; streaming remains a command behavior. */
-outputFormat?: "json" | "toon";
+outputFormat?:"json" | "toon";
 /** Caller-carried cross-call budget and served-fact state. */
-outputSession?: string | PmReadOutputSessionState;
+outputSession?:string | PmReadOutputSessionState;
 /** Opaque continuation returned after a budget-compacted declared row path. */
-outputCursor?: string;
+outputCursor?:string;
 /** Include row selector and encoding discovery metadata. */
-outputRowContract?: boolean;
+outputRowContract?:boolean;
 }
 /** Compatibility spelling retained for a command-specific output control. */
 export interface PmReadOutputLegacyAlias {
 /** Historical CLI spelling. */
-flag: string;
+flag:string;
 /** Strength of the migration promise carried by this alias. */
-semantics?: "replacement" | "behavior_preserving";
+semantics?:"replacement" | "behavior_preserving";
 /** One-line migration instruction for agents and help generators. */
-migration_hint: string;
+migration_hint:string;
 /** Compatibility aliases are accepted but omitted from the canonical vocabulary. */
-visibility: "hidden_alias";
+visibility:"hidden_alias";
 }
 /** Contract for one output dimension on one read surface. */
 export interface PmReadOutputDimensionContract {
 /** Stable dimension name. */
-dimension: PmReadOutputDimension;
+dimension:PmReadOutputDimension;
 /** Canonical cross-command CLI option. */
-canonical_option: string;
+canonical_option:string;
 /** Whether the dimension has executable behavior on this surface. */
-applicable: boolean;
+applicable:boolean;
 /** Explanation used only when the dimension cannot apply. */
-inapplicable_reason: string | null;
+inapplicable_reason:string | null;
 /** Historical command-local options mapped into this dimension. */
-legacy_aliases: PmReadOutputLegacyAlias[];
+legacy_aliases:PmReadOutputLegacyAlias[];
 }
 /** Complete four-dimension contract for one read surface. */
 export interface PmReadOutputSurfaceContract {
 /** Canonical command root. */
-command: PmReadOutputSurface;
+command:PmReadOutputSurface;
 /** Identical dimension keys shared by every read surface. */
-dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>;
+dimensions:Record<PmReadOutputDimension,PmReadOutputDimensionContract>;
 /** Deterministic precedence from strongest caller declaration to fallback. */
-precedence: readonly ["canonical", "legacy", "intent", "default"];
+precedence:readonly ["canonical","legacy","intent","default"];
 /** Stable policy used before budget compaction selects retained rows. */
-budget_retention_policy: "ordered_prefix" | "verdict_priority";
+budget_retention_policy:"ordered_prefix" | "verdict_priority";
 /** Exact command-local whole-result modes accepted by `outputInclude`. */
-projection_modes?: readonly string[];
+projection_modes?:readonly string[];
 }
 /** Source that selected an effective output dimension. */
 export type PmReadOutputDimensionSource = "canonical" | "legacy" | "intent" | "default";
 /** Resolved value and provenance for one dimension. */
 export interface PmResolvedReadOutputDimension<T> {
 /** Effective value after precedence resolution. */
-value: T;
+value:T;
 /** Layer that supplied the effective value. */
-source: PmReadOutputDimensionSource;
+source:PmReadOutputDimensionSource;
 }
 /** Fully resolved output controls for one invocation. */
 export interface PmResolvedReadOutputDimensions {
 /** Canonical read surface. */
-command: PmReadOutputSurface;
+command:PmReadOutputSurface;
 /** Requested field or section selectors. */
-include?: PmResolvedReadOutputDimension<string[]>;
+include?:PmResolvedReadOutputDimension<string[]>;
 /** Requested row ceiling. */
-amount?: PmResolvedReadOutputDimension<number | "unbounded">;
+amount?:PmResolvedReadOutputDimension<number | "unbounded">;
 /** Requested estimated-token ceiling or explicit opt-out. */
-cost?: PmResolvedReadOutputDimension<number | "unbounded">;
+cost?:PmResolvedReadOutputDimension<number | "unbounded">;
 /** Requested static encoding or a retained legacy streaming behavior. */
-encoding?: PmResolvedReadOutputDimension<"json" | "toon" | "stream">;
+encoding?:PmResolvedReadOutputDimension<"json" | "toon" | "stream">;
 /** Canonical CLI options observed on the invocation. */
-canonical_options_used?: string[];
+canonical_options_used?:string[];
 /** Compatibility flags observed on the invocation. */
-legacy_aliases_used: string[];
+legacy_aliases_used:string[];
 /** One-line migration instructions for observed compatibility flags. */
-migration_hints: string[];
+migration_hints:string[];
 /** Deterministic precedence applied to every dimension. */
-precedence: readonly ["canonical", "legacy", "intent", "default"];
+precedence:readonly ["canonical","legacy","intent","default"];
 }
 /** Machine-readable proof of output dimensions applied to one read. */
 export interface PmReadOutputReceipt {
 /** Contract format version. */
-contract_version: 1;
+contract_version:1;
 /** Canonical read surface. */
-command: PmReadOutputSurface;
+command:PmReadOutputSurface;
 /** Dimensions explicitly or compatibly requested by the invocation. */
-requested_dimensions: PmReadOutputDimension[];
+requested_dimensions:PmReadOutputDimension[];
 /** Layer supplying a default ceiling or the context compatibility ceiling. */
-budget_source?: "default" | "legacy";
+budget_source?:"default" | "legacy";
 /** Applied default or context compatibility ceiling; canonical/session budgets already disclose their value. */
-budget_tokens?: number;
+budget_tokens?:number;
 /** Deterministic precedence used during resolution. */
-precedence: readonly ["canonical", "legacy", "intent", "default"];
+precedence:readonly ["canonical","legacy","intent","default"];
 /** Canonical CLI options observed on the invocation. */
-canonical_options_used?: string[];
+canonical_options_used?:string[];
 /** Compatibility options observed on the invocation. */
-legacy_aliases_used: string[];
+legacy_aliases_used:string[];
 /** One-line migration instructions for compatibility options. */
-migration_hints: string[];
+migration_hints:string[];
 /** Deterministic UTF-8 byte token estimate of the result and receipt in the selected JSON or TOON rendering; SDK calls without a format use compact JSON. */
-estimated_tokens: number;
+estimated_tokens:number;
 /** Whether the final result fits the requested cost ceiling. */
-within_budget: boolean;
+within_budget:boolean;
 /** Whether long string values were shortened while satisfying the cost ceiling. */
-strings_compacted: boolean;
+strings_compacted:boolean;
 /** Whether row collections were reduced while satisfying the cost ceiling. */
-rows_compacted: boolean;
+rows_compacted:boolean;
 /** Declared or nested collection paths reduced by budget degradation. */
-compacted_row_paths?: string[];
+compacted_row_paths?:string[];
 /** Whether the requested cost ceiling forced the useful result to be omitted. */
-result_omitted: boolean;
+result_omitted:boolean;
 /** Estimated tokens in the useful result immediately before whole-result omission. */
-omitted_result_estimated_tokens?: number;
+omitted_result_estimated_tokens?:number;
 /** Detail depth selected before destructive string or row compaction. */
-applied_depth?: "brief";
+applied_depth?:"brief";
 /** Binding constraint that selected the smaller detail projection. */
-degradation_reason?: "output_budget_reached";
+degradation_reason?:"output_budget_reached";
 }
 /** Machine-readable explanation of budget-driven row degradation. */
 export interface PmReadOutputTruncationDisclosure {
 /** Stable reason for dropping rows. */
-reason: "output_budget_reached";
+reason:"output_budget_reached";
 /** Layer that supplied the binding ceiling. */
-budget_source: PmReadOutputDimensionSource | "session";
+budget_source:PmReadOutputDimensionSource | "session";
 /** Binding estimated-token ceiling. */
-budget_tokens: number;
+budget_tokens:number;
 /** Explicit dimensions whose unbounded request was overridden by the ceiling. */
-overridden_dimensions: PmReadOutputDimension[];
+overridden_dimensions:PmReadOutputDimension[];
 /** Declared or nested collection paths reduced by budget degradation. */
-compacted_row_paths: string[];
+compacted_row_paths:string[];
 /** Whether next_cursor was moved back to the last row that survived compaction. */
-continuation_cursor_rebased: boolean;
+continuation_cursor_rebased:boolean;
 /** Whether at least one declared row collection can be resumed within the budget. */
-continuation_available: boolean;
+continuation_available:boolean;
 /** Maximum next-page useful-result budget relative to the current budget. */
-recovery_budget_multiplier: number | null;
+recovery_budget_multiplier:number | null;
 /** Bounded continuation instructions for every compacted declared row path. */
-continuations: PmReadOutputContinuation[];
+continuations:PmReadOutputContinuation[];
 /** Retry guidance, or `recovery` to require the adjacent cursor and transport bindings. */
-restore_with: string;
+restore_with:string;
 /** Transport-specific machine recovery options. */
-recovery: {
+recovery:{
 /** Opaque value supplied through each declared transport binding. */
-cursor: string;
+cursor:string;
 /** CLI option accepting cursor. */
-cli: "--output-cursor";
+cli:"--output-cursor";
 /** SDK option field accepting cursor. */
-sdk: "outputCursor";
+sdk:"outputCursor";
 /** MCP input field accepting cursor. */
-mcp: "outputCursor";
+mcp:"outputCursor";
 } | {
-cli: string;
-sdk: {
-outputBudget: number | "unbounded";
+cli:string;
+sdk:{
+outputBudget:number | "unbounded";
 };
-mcp: {
-outputBudget: number | "unbounded";
+mcp:{
+outputBudget:number | "unbounded";
 };
 };
 }
 /** One resumable declared-row collection withheld by budget compaction. */
 export interface PmReadOutputContinuation {
 /** Dot-delimited declared row path being resumed. */
-path: string;
+path:string;
 /** Opaque cursor accepted by CLI, SDK, and MCP outputCursor inputs. */
-cursor: string;
+cursor:string;
 /** Rows retained from this path in the current response. */
-retained_rows: number;
+retained_rows:number;
 /** Rows remaining after the current response. */
-remaining_rows: number;
+remaining_rows:number;
 /** Total rows in the stable collection snapshot. */
-total_rows: number;
+total_rows:number;
 }
 /** Versioned, command-bound cursor payload for one stable declared row collection. */
 export interface PmReadOutputCursorEnvelope {
 /** Serialized cursor format version. */
-version: 1;
+version:1;
 /** Canonical read surface that produced the cursor. */
-command: PmReadOutputSurface;
+command:PmReadOutputSurface;
 /** Dot-delimited declared row path being continued. */
-path: string;
+path:string;
 /** Zero-based index of the first withheld row. */
-offset: number;
+offset:number;
 /** Stable pre-projection denominator for the row collection. */
-total_rows: number;
+total_rows:number;
 /** Stable identity fingerprint used to refuse stale continuation. */
-fingerprint: string;
+fingerprint:string;
 }
 /** Result returned when the requested cost ceiling cannot fit useful content. */
 export interface PmReadOutputBudgetExceeded {
 /** Stable omission marker and recovery instruction. */
-output_budget_exceeded: {
+output_budget_exceeded:{
 /** Confirms that the useful result was deliberately omitted. */
-omitted_result: true;
+omitted_result:true;
 /** Stable reason for machine-readable recovery. */
-reason: "requested_budget_infeasible";
+reason:"requested_budget_infeasible";
 /** Human- and agent-readable recovery instruction. */
-restore_with: string;
+restore_with:string;
 /** Transport-specific machine recovery options. */
-recovery: {
-outputBudget: "unbounded";
+recovery:{
+outputBudget:"unbounded";
 };
 };
 /** Exact receipt for the bounded omission envelope. */
-read_output: PmReadOutputReceipt;
+read_output:PmReadOutputReceipt;
 }
 /** Read result with an optional shaping receipt or a discriminated omission. */
 export type PmReadOutputResult<Result> = (Result & {
-read_output?: PmReadOutputReceipt;
-read_session?: PmReadOutputSessionReceipt;
-output_budget_truncation?: PmReadOutputTruncationDisclosure;
+read_output?:PmReadOutputReceipt;
+read_session?:PmReadOutputSessionReceipt;
+output_budget_truncation?:PmReadOutputTruncationDisclosure;
 }) | (PmReadOutputBudgetExceeded & {
-read_session?: PmReadOutputSessionReceipt;
+read_session?:PmReadOutputSessionReceipt;
 });
 /** Select the omission-aware result type when an option shape can request a budget. */
-export type PmReadOutputResultFor<Result, Options> = "outputBudget" extends keyof Options ? PmReadOutputResult<Result> : "outputSession" extends keyof Options ? PmReadOutputResult<Result> : "outputCursor" extends keyof Options ? PmReadOutputResult<Result> : Result;
+export type PmReadOutputResultFor<Result,Options> = "outputBudget" extends keyof Options ? PmReadOutputResult<Result> :"outputSession" extends keyof Options ? PmReadOutputResult<Result> :"outputCursor" extends keyof Options ? PmReadOutputResult<Result> :Result;
 /** Canonical CLI flags that opt a read invocation into universal output shaping. */
-export declare const PM_READ_OUTPUT_OPTION_FLAGS: readonly string[];
+export declare const PM_READ_OUTPUT_OPTION_FLAGS:readonly string[];
 /** Canonical control that composes the four per-call dimensions across reads. */
-export declare const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS: readonly ["--output-session", "--output-cursor", "--output-row-contract"];
+export declare const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS:readonly ["--output-session","--output-cursor","--output-row-contract"];
 /** Universal output contract for every built-in read surface. */
-export declare const PM_READ_OUTPUT_SURFACE_CONTRACTS: readonly PmReadOutputSurfaceContract[];
+export declare const PM_READ_OUTPUT_SURFACE_CONTRACTS:readonly PmReadOutputSurfaceContract[];
 /** Resolve a command or list/context alias to its canonical read-output surface. */
-export declare function resolveReadOutputSurface(command: string, options?: Record<string, unknown>): PmReadOutputSurface | undefined;
+export declare function resolveReadOutputSurface(command:string,options?:Record<string,unknown>):PmReadOutputSurface | undefined;
 /** Reject malformed or mutation-scoped universal output controls before command execution. */
-export declare function validateReadOutputOptions(command: string, options: Record<string, unknown>): void;
+export declare function validateReadOutputOptions(command:string,options:Record<string,unknown>):void;
 /**
  * Map every canonical `--output-include` token that names a projection mode
  * rather than a row field onto the command-local option that mode already owns.
@@ -258,16 +258,16 @@ export declare function validateReadOutputOptions(command: string, options: Reco
  * whole declared projection. Only the first kind can be honoured by projecting
  * an already-computed result, so mode tokens have to reach the command itself.
  */
-export declare function readOutputIncludeModeOptions(command: string): ReadonlyMap<string, string>;
+export declare function readOutputIncludeModeOptions(command:string):ReadonlyMap<string,string>;
 /**
  * Translate canonical projection-mode tokens into the command-local options
  * they alias, so the spelling the migration hints recommend is behaviour
  * identical to the legacy flag it replaces, and return the field selectors that
  * remain for post-execution projection.
  */
-export declare function applyReadOutputIncludeModes(command: string, includeValue: unknown, commandOptions: Record<string, unknown>): {
-selectors: string[];
-modes: string[];
+export declare function applyReadOutputIncludeModes(command:string,includeValue:unknown,commandOptions:Record<string,unknown>):{
+selectors:string[];
+modes:string[];
 };
 /**
  * Resolve canonical include modes against one combined options bag, rewriting
@@ -277,14 +277,14 @@ modes: string[];
  * controls in a single record, so an action honours a mode token exactly as the
  * CLI does.
  */
-export declare function normalizeReadOutputIncludeModeOptions(command: string, options: Record<string, unknown>): void;
+export declare function normalizeReadOutputIncludeModeOptions(command:string,options:Record<string,unknown>):void;
 /** Resolve canonical and compatibility controls into the universal dimension set. */
-export declare function resolveReadOutputDimensions(command: string, options: Record<string, unknown>): PmResolvedReadOutputDimensions | undefined;
+export declare function resolveReadOutputDimensions(command:string,options:Record<string,unknown>):PmResolvedReadOutputDimensions | undefined;
 /** Recompute read and optional session receipts after a final envelope projection. */
-export declare function stabilizeReadOutputReceiptEstimates(result: Record<string, unknown>, options: Record<string, unknown>): Record<string, unknown>;
+export declare function stabilizeReadOutputReceiptEstimates(result:Record<string,unknown>,options:Record<string,unknown>):Record<string,unknown>;
 /** Apply universal field, row, and token bounds and attach an exact receipt. */
-export declare function applyReadOutputDimensions<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result): PmReadOutputResult<Result>;
+export declare function applyReadOutputDimensions<Result extends Record<string,unknown>>(command:string,options:Record<string,unknown>,result:Result):PmReadOutputResult<Result>;
 /** Narrow a universal read result to its budget-omission branch. */
-export declare function isReadOutputBudgetExceeded(result: unknown): result is PmReadOutputBudgetExceeded;
+export declare function isReadOutputBudgetExceeded(result:unknown):result is PmReadOutputBudgetExceeded;
 /** Resolve only the canonical renderer override for shared CLI output code. */
-export declare function resolveReadOutputEncoding(command: string, options: Record<string, unknown>): "json" | "toon" | undefined;
+export declare function resolveReadOutputEncoding(command:string,options:Record<string,unknown>):"json" | "toon" | undefined;