@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/core/lock/lock.d.ts

@@ -1,30 +1,30 @@
 interface LockInfo {
-id: string;
-pid: number;
-owner: string;
-token?: string;
-created_at: string;
-ttl_seconds: number;
+id:string;
+pid:number;
+owner:string;
+token?:string;
+created_at:string;
+ttl_seconds:number;
 }
 interface LockReadResult {
-info: LockInfo | null;
-warnings: string[];
+info:LockInfo | null;
+warnings:string[];
 }
 interface StaleLockRemovalResult {
-lockInfo: LockReadResult;
-shouldRetryCreate: boolean;
-staleRemovalCounted: boolean;
+lockInfo:LockReadResult;
+shouldRetryCreate:boolean;
+staleRemovalCounted:boolean;
 }
 /** Stable operating-system identity for a process when the host exposes one. */
 export interface ProcessIdentity {
 /** Operating-system process identifier captured with the owner record. */
-pid: number;
+pid:number;
 /** Host process-start coordinate that distinguishes reuse of the same PID. */
-process_start_identity?: string;
+process_start_identity?:string;
 }
-declare function parseLockInfo(raw: string): LockReadResult;
-declare function readLockInfo(lockPath: string, emitReadHook?: boolean): Promise<LockReadResult>;
-declare function isErrno(error: unknown, code: string): boolean;
+declare function parseLockInfo(raw:string):LockReadResult;
+declare function readLockInfo(lockPath:string,emitReadHook?:boolean):Promise<LockReadResult>;
+declare function isErrno(error:unknown,code:string):boolean;
 /**
  * Classify exclusive-create failures that prove another lock lifecycle is in
  * flight. Windows can report `EPERM`, `EACCES`, or `EBUSY` while a just-unlinked
@@ -33,48 +33,48 @@ declare function isErrno(error: unknown, code: string): boolean;
  * host. A missing or temporarily unstatable Windows path is contention only
  * when its parent remains writable, preserving genuine permission failures.
  */
-declare function isLockCreateContention(error: unknown, lockPath: string, platform?: NodeJS.Platform): Promise<boolean>;
-declare function buildLockPayload(id: string, owner: string, ttlSeconds: number, token?: string): LockInfo;
-declare function isStaleLock(info: LockInfo | null, ttlSeconds: number): boolean;
-declare function lockOwnerSuffix(info: LockInfo | null): string;
+declare function isLockCreateContention(error:unknown,lockPath:string,platform?:NodeJS.Platform):Promise<boolean>;
+declare function buildLockPayload(id:string,owner:string,ttlSeconds:number,token?:string):LockInfo;
+declare function isStaleLock(info:LockInfo | null,ttlSeconds:number):boolean;
+declare function lockOwnerSuffix(info:LockInfo | null):string;
 /** Resolves the effective bounded wait budget for a contended lock: the PM_LOCK_WAIT_MS environment override wins when it parses as a non-negative integer, then the caller-provided budget (settings `locks.wait_ms`), then 0 (fail-fast, the pre-wait behavior). */
-declare function resolveLockWaitMs(waitMs: number | undefined): number;
-declare function parseLinuxProcessStartIdentity(raw: string): string | null;
+declare function resolveLockWaitMs(waitMs:number | undefined):number;
+declare function parseLinuxProcessStartIdentity(raw:string):string | null;
 /** Read the host process-start coordinate used to distinguish PID reuse. */
-export declare function readProcessStartIdentity(pid: number): Promise<string | null>;
+export declare function readProcessStartIdentity(pid:number):Promise<string | null>;
 /** Capture the current PID plus a host process-start coordinate when available. */
-export declare function captureProcessIdentity(pid?: number): Promise<ProcessIdentity>;
+export declare function captureProcessIdentity(pid?:number):Promise<ProcessIdentity>;
 /**
  * Verify that a captured process owner still exists, with a bounded grace
  * period when the host cannot expose a reusable-PID-safe start coordinate.
  */
-export declare function isProcessIdentityAlive(identity: ProcessIdentity, unverifiedAgeMs: number, maxUnverifiedAgeMs: number): Promise<boolean>;
-declare function acquireStaleCleanupGate(lockPath: string, _id: string): Promise<(() => Promise<void>) | null>;
-declare function removeConfirmedStaleLock(params: {
-lockPath: string;
-id: string;
-ttlSeconds: number;
-force: boolean;
-forceRequiredForStaleLock: boolean;
-staleRemovals: number;
-waitBudgetMs: number;
-startedAtMs: number;
-fallbackLockInfo: LockReadResult;
-}): Promise<StaleLockRemovalResult>;
+export declare function isProcessIdentityAlive(identity:ProcessIdentity,unverifiedAgeMs:number,maxUnverifiedAgeMs:number):Promise<boolean>;
+declare function acquireStaleCleanupGate(lockPath:string,_id:string):Promise<(() => Promise<void>) | null>;
+declare function removeConfirmedStaleLock(params:{
+lockPath:string;
+id:string;
+ttlSeconds:number;
+force:boolean;
+forceRequiredForStaleLock:boolean;
+staleRemovals:number;
+waitBudgetMs:number;
+startedAtMs:number;
+fallbackLockInfo:LockReadResult;
+}):Promise<StaleLockRemovalResult>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-parseLockInfo: typeof parseLockInfo;
-readLockInfo: typeof readLockInfo;
-isErrno: typeof isErrno;
-isLockCreateContention: typeof isLockCreateContention;
-buildLockPayload: typeof buildLockPayload;
-isStaleLock: typeof isStaleLock;
-lockOwnerSuffix: typeof lockOwnerSuffix;
-resolveLockWaitMs: typeof resolveLockWaitMs;
-parseLinuxProcessStartIdentity: typeof parseLinuxProcessStartIdentity;
-readProcessStartIdentity: typeof readProcessStartIdentity;
-acquireStaleCleanupGate: typeof acquireStaleCleanupGate;
-removeConfirmedStaleLock: typeof removeConfirmedStaleLock;
+export declare const _testOnly:{
+parseLockInfo:typeof parseLockInfo;
+readLockInfo:typeof readLockInfo;
+isErrno:typeof isErrno;
+isLockCreateContention:typeof isLockCreateContention;
+buildLockPayload:typeof buildLockPayload;
+isStaleLock:typeof isStaleLock;
+lockOwnerSuffix:typeof lockOwnerSuffix;
+resolveLockWaitMs:typeof resolveLockWaitMs;
+parseLinuxProcessStartIdentity:typeof parseLinuxProcessStartIdentity;
+readProcessStartIdentity:typeof readProcessStartIdentity;
+acquireStaleCleanupGate:typeof acquireStaleCleanupGate;
+removeConfirmedStaleLock:typeof removeConfirmedStaleLock;
 };
 /**
  * Acquire a token-owned tracker lock with bounded contention waiting and
@@ -82,7 +82,7 @@ removeConfirmedStaleLock: typeof removeConfirmedStaleLock;
  * parent directories so acquiring or retrying a lock cannot revive removed
  * storage. Extension overrides retain responsibility for their own lifecycle.
  */
-export declare function acquireLock(pmRoot: string, id: string, ttlSeconds: number, owner: string, force?: boolean, forceRequiredForStaleLock?: boolean, waitMs?: number, options?: {
-createParentDirectories?: boolean;
-}): Promise<() => Promise<void>>;
+export declare function acquireLock(pmRoot:string,id:string,ttlSeconds:number,owner:string,force?:boolean,forceRequiredForStaleLock?:boolean,waitMs?:number,options?:{
+createParentDirectories?:boolean;
+}):Promise<() => Promise<void>>;
 export {};

package/dist/core/output/mutation-projection.d.ts

@@ -1,34 +1,13 @@
-/**
- * Shared projection helper for mutation command results.
- *
- * Mutation commands (create/update/close/append/update-many) return a result
- * envelope that carries a `changed_fields` string array. On create this array simply
- * re-lists every field the command just set, which the item echo above it already
- * shows, so for high-volume agent loops it is ~50% redundant payload. This helper
- * lets the CLI (`--no-changed-fields`) and the MCP agent path trim that array down
- * to a deterministic `changed_field_count` without losing mutation evidence.
- *
- * Compaction is deliberately scoped to the mutation envelope only:
- *   - the envelope's own top-level `changed_fields` (create/update/close/append), and
- *   - `rows[*].changed_fields` (update-many reports its delta per row).
- *   - recognized start/pause/close composition steps sharing the root item id.
- * It does NOT recurse into arbitrary nested objects, so unrelated payloads that
- * legitimately carry `changed_fields` (for example `pm history --diff` entries, or a
- * custom runtime metadata field) are left untouched.
- *
- * The helper is pure and side-effect free, reused by both the output layer and the
- * MCP server, and returns the original reference unchanged when nothing is compacted.
- */
 /** Controls whether mutation output keeps full changed fields or compact counts. */
 export type ChangedFieldsMode = "full" | "compact";
 /** Documents the mutation projection options payload exchanged by command, SDK, and package integrations. */
 export interface MutationProjectionOptions {
 /** Defaults to "full" (unchanged output). "compact" drops the array, keeping a count. */
-changedFields?: ChangedFieldsMode;
+changedFields?:ChangedFieldsMode;
 /** Return the default agent envelope: id, status, changed-field count, and close reason. */
-compactEnvelope?: boolean;
+compactEnvelope?:boolean;
 /** Return only id/status for single-item mutation envelopes. */
-idOnly?: boolean;
+idOnly?:boolean;
 }
 /** Returns a copy of a mutation result with the envelope `changed_fields` arrays replaced by `changed_field_count` when compact mode is requested. Inputs that are not a mutation envelope (or full mode) are returned unchanged (same reference). */
-export declare function projectMutationResult(result: unknown, options?: MutationProjectionOptions): unknown;
+export declare function projectMutationResult(result:unknown,options?:MutationProjectionOptions):unknown;

package/dist/core/output/mutation-projection.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]="71a40065-6b91-54bb-ad90-4a4b018de3b4")}catch{}})();const CHANGED_FIELDS_KEY="changed_fields",CHANGED_FIELD_COUNT_KEY="changed_field_count",ROWS_KEY="rows",UPDATE_MANY_MUTATION_MODES=new Set(["apply","rollback"]),DELETE_OUTCOMES=new Set(["deleted","would_delete"]),COMPACT_RECURRENCE_TEXT_LIMIT=256,COMPOUND_MUTATION_STEPS={start_task:["claim","update"],pause_task:["update","release"],close_task:["close","release"]};function projectCompoundMutation(result,options){if(!isPlainObject(result)||typeof result.action!="string"||typeof result.id!="string"||result.id.length===0)return null;const steps=Object.hasOwn(COMPOUND_MUTATION_STEPS,result.action)?COMPOUND_MUTATION_STEPS[result.action]:void 0;if(!steps||!steps.every(step=>{const value=result[step];return isPlainObject(value)&&isPlainObject(value.item)&&value.item.id===result.id&&Array.isArray(value.changed_fields)&&value.changed_fields.every(field=>typeof field=="string")}))return null;const final=result[steps.at(-1)],identity=projectIdOnlyResult(final);return options.idOnly?identity:!options.compactEnvelope&&options.changedFields!=="compact"?null:{...result,...options.compactEnvelope?{...identity,changed_field_count:new Set(steps.flatMap(step=>result[step].changed_fields)).size}:{},...Object.fromEntries(steps.map(step=>[step,projectMutationResult(result[step],options)]))}}function truncateCompactRecurrenceText(value){return typeof value!="string"||value.length<=COMPACT_RECURRENCE_TEXT_LIMIT?value:`${value.slice(0,COMPACT_RECURRENCE_TEXT_LIMIT-1)}\u2026`}function projectCompactRecurrence(value){if(!isPlainObject(value))return null;const recurrence={...value};return recurrence.reason=truncateCompactRecurrenceText(recurrence.reason),isPlainObject(recurrence.previous_terminal)&&(recurrence.previous_terminal=Object.fromEntries(Object.entries(recurrence.previous_terminal).map(([key,entry])=>[key,truncateCompactRecurrenceText(entry)]))),recurrence}function isPlainObject(value){if(typeof value!="object"||value===null||Array.isArray(value))return!1;const proto=Object.getPrototypeOf(value);return proto===null||proto===Object.prototype}function compactOwnChangedFields(envelope){const changedFields=envelope[CHANGED_FIELDS_KEY];if(!Array.isArray(changedFields))return null;const projected=Object.getPrototypeOf(envelope)===null?Object.create(null):{};for(const[key,value]of Object.entries(envelope))key!==CHANGED_FIELDS_KEY&&(projected[key]=value);return projected[CHANGED_FIELD_COUNT_KEY]=changedFields.length,projected}function isMutationEnvelope(value){return"item"in value&&Array.isArray(value[CHANGED_FIELDS_KEY])}function isUpdateManyMutationEnvelope(value){return typeof value.mode=="string"&&UPDATE_MANY_MUTATION_MODES.has(value.mode)&&Array.isArray(value[ROWS_KEY])}function replaceRows(envelope,rows){const projected=Object.getPrototypeOf(envelope)===null?Object.create(null):{};return Object.assign(projected,envelope),projected[ROWS_KEY]=rows,projected}function projectIdOnlyResult(result){if(!isPlainObject(result))return null;const subject=isPlainObject(result.item)?result.item:isPlainObject(result.plan)?result.plan:null;if(subject===null)return null;const id=typeof subject.id=="string"?subject.id:void 0,status=typeof result.outcome=="string"&&DELETE_OUTCOMES.has(result.outcome)?result.outcome:typeof subject.status=="string"?subject.status:void 0;return id?status?{id,status,...typeof result.deleted=="boolean"?{deleted:result.deleted}:{}}:{id}:null}function projectCompactMutationEnvelope(result,includeItem){if(!isPlainObject(result))return null;if(isPlainObject(result.plan)&&isPlainObject(result.mutation_receipt)&&result.mutation_receipt.kind==="plan_mutation"&&result.mutation_receipt.id===result.plan.id&&result.mutation_receipt.action===result.action)return result.mutation_receipt;if(!includeItem||!isPlainObject(result.item)||typeof result.item.id!="string")return null;const changedFields=result[CHANGED_FIELDS_KEY];if(!Array.isArray(changedFields))return null;const compact={id:result.item.id,...typeof result.outcome=="string"&&DELETE_OUTCOMES.has(result.outcome)?{status:result.outcome}:typeof result.item.status=="string"?{status:result.item.status}:{},...typeof result.deleted=="boolean"?{deleted:result.deleted}:{},...typeof result.previous_status=="string"?{previous_status:result.previous_status}:{},changed_field_count:changedFields.length};return appendCompactMutationEvidence(result,result.item,compact),compact}function appendCompactMutationEvidence(result,item,compact){const closeReason=typeof result.close_reason=="string"?result.close_reason:typeof item.close_reason=="string"?item.close_reason:void 0;closeReason!==void 0&&(compact.close_reason=closeReason);const recurrence=projectCompactRecurrence(result.recurrence);if(recurrence!==null&&(compact.recurrence=recurrence),Array.isArray(result.warnings)&&result.warnings.length>0&&(compact.warnings=result.warnings),isPlainObject(result.recovery)&&(compact.recovery=result.recovery),typeof result.claimed_by=="string"||typeof result.released_by=="string")for(const key of["claimed_by","released_by","previous_assignee","forced","skipped","available","attempts","suggestions"])Object.hasOwn(result,key)&&(compact[key]=result[key])}function compactUpdateManyRows(envelope){const rows=isUpdateManyMutationEnvelope(envelope)?envelope[ROWS_KEY]:void 0;if(!Array.isArray(rows))return{projected:envelope,changed:!1};let rowsChanged=!1;const nextRows=rows.map(row=>{if(!isPlainObject(row))return row;const compactedRow=compactOwnChangedFields(row);return compactedRow?(rowsChanged=!0,compactedRow):row});return rowsChanged?{projected:replaceRows(envelope,nextRows),changed:!0}:{projected:envelope,changed:!1}}function projectMutationResult(result,options={}){const compound=projectCompoundMutation(result,options);if(compound!==null)return compound;if(options.idOnly===!0){const idOnly=projectIdOnlyResult(result);if(idOnly!==null)return idOnly}if(options.compactEnvelope===!0||options.changedFields==="compact"){const compact=projectCompactMutationEnvelope(result,options.compactEnvelope===!0);if(compact!==null)return compact}if((options.changedFields??"full")==="full"||!isPlainObject(result))return result;let changed=!1,projected=result;const compactedTop=isMutationEnvelope(result)?compactOwnChangedFields(result):null;compactedTop!==null&&(projected=compactedTop,changed=!0);const rowProjection=compactUpdateManyRows(projected);return rowProjection.changed&&(projected=rowProjection.projected,changed=!0),changed?projected:result}export{projectMutationResult};
+(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]="9bdf8ad1-8d1e-5e3e-a23a-ba1d4293402b")}catch{}})();import{unicodeSafePrefix}from"../shared/text-normalization.js";const CHANGED_FIELDS_KEY="changed_fields",CHANGED_FIELD_COUNT_KEY="changed_field_count",ROWS_KEY="rows",UPDATE_MANY_MUTATION_MODES=new Set(["apply","rollback"]),DELETE_OUTCOMES=new Set(["deleted","would_delete"]),COMPACT_RECURRENCE_TEXT_LIMIT=256,COMPOUND_MUTATION_STEPS={start_task:["claim","update"],pause_task:["update","release"],close_task:["close","release"]};function projectCompoundMutation(result,options){if(!isPlainObject(result)||typeof result.action!="string"||typeof result.id!="string"||result.id.length===0)return null;const steps=Object.hasOwn(COMPOUND_MUTATION_STEPS,result.action)?COMPOUND_MUTATION_STEPS[result.action]:void 0;if(!steps||!steps.every(step=>{const value=result[step];return isPlainObject(value)&&isPlainObject(value.item)&&value.item.id===result.id&&Array.isArray(value.changed_fields)&&value.changed_fields.every(field=>typeof field=="string")}))return null;const final=result[steps.at(-1)],identity=projectIdOnlyResult(final);return options.idOnly?identity:!options.compactEnvelope&&options.changedFields!=="compact"?null:{...result,...options.compactEnvelope?{...identity,changed_field_count:new Set(steps.flatMap(step=>result[step].changed_fields)).size}:{},...Object.fromEntries(steps.map(step=>[step,projectMutationResult(result[step],options)]))}}function truncateCompactRecurrenceText(value){return typeof value!="string"||value.length<=COMPACT_RECURRENCE_TEXT_LIMIT?value:`${unicodeSafePrefix(value,COMPACT_RECURRENCE_TEXT_LIMIT-1)}\u2026`}function projectCompactRecurrence(value){if(!isPlainObject(value))return null;const recurrence={...value};return recurrence.reason=truncateCompactRecurrenceText(recurrence.reason),isPlainObject(recurrence.previous_terminal)&&(recurrence.previous_terminal=Object.fromEntries(Object.entries(recurrence.previous_terminal).map(([key,entry])=>[key,truncateCompactRecurrenceText(entry)]))),recurrence}function isPlainObject(value){if(typeof value!="object"||value===null||Array.isArray(value))return!1;const proto=Object.getPrototypeOf(value);return proto===null||proto===Object.prototype}function compactOwnChangedFields(envelope){const changedFields=envelope[CHANGED_FIELDS_KEY];if(!Array.isArray(changedFields))return null;const projected=Object.getPrototypeOf(envelope)===null?Object.create(null):{};for(const[key,value]of Object.entries(envelope))key!==CHANGED_FIELDS_KEY&&(projected[key]=value);return projected[CHANGED_FIELD_COUNT_KEY]=changedFields.length,projected}function isMutationEnvelope(value){return"item"in value&&Array.isArray(value[CHANGED_FIELDS_KEY])}function isUpdateManyMutationEnvelope(value){return typeof value.mode=="string"&&UPDATE_MANY_MUTATION_MODES.has(value.mode)&&Array.isArray(value[ROWS_KEY])}function replaceRows(envelope,rows){const projected=Object.getPrototypeOf(envelope)===null?Object.create(null):{};return Object.assign(projected,envelope),projected[ROWS_KEY]=rows,projected}function projectIdOnlyResult(result){if(!isPlainObject(result))return null;const subject=isPlainObject(result.item)?result.item:isPlainObject(result.plan)?result.plan:null;if(subject===null)return null;const id=typeof subject.id=="string"?subject.id:void 0,status=typeof result.outcome=="string"&&DELETE_OUTCOMES.has(result.outcome)?result.outcome:typeof subject.status=="string"?subject.status:void 0;return id?status?{id,status,...typeof result.deleted=="boolean"?{deleted:result.deleted}:{}}:{id}:null}function projectCompactMutationEnvelope(result,includeItem){if(!isPlainObject(result))return null;if(isPlainObject(result.plan)&&isPlainObject(result.mutation_receipt)&&result.mutation_receipt.kind==="plan_mutation"&&result.mutation_receipt.id===result.plan.id&&result.mutation_receipt.action===result.action)return result.mutation_receipt;if(!includeItem||!isPlainObject(result.item)||typeof result.item.id!="string")return null;const changedFields=result[CHANGED_FIELDS_KEY];if(!Array.isArray(changedFields))return null;const compact={id:result.item.id,...typeof result.outcome=="string"&&DELETE_OUTCOMES.has(result.outcome)?{status:result.outcome}:typeof result.item.status=="string"?{status:result.item.status}:{},...typeof result.deleted=="boolean"?{deleted:result.deleted}:{},...typeof result.previous_status=="string"?{previous_status:result.previous_status}:{},changed_field_count:changedFields.length};return appendCompactMutationEvidence(result,result.item,compact),compact}function appendCompactMutationEvidence(result,item,compact){const closeReason=typeof result.close_reason=="string"?result.close_reason:typeof item.close_reason=="string"?item.close_reason:void 0;closeReason!==void 0&&(compact.close_reason=closeReason);const recurrence=projectCompactRecurrence(result.recurrence);recurrence!==null&&(compact.recurrence=recurrence),Array.isArray(result.warnings)&&result.warnings.length>0&&(compact.warnings=result.warnings);for(const key of["recovery","follow_up","handoff"])isPlainObject(result[key])&&(compact[key]=result[key]);if(typeof result.claimed_by=="string"||typeof result.released_by=="string")for(const key of["claimed_by","released_by","previous_assignee","forced","skipped","available","attempts","suggestions"])Object.hasOwn(result,key)&&(compact[key]=result[key])}function compactUpdateManyRows(envelope){const rows=isUpdateManyMutationEnvelope(envelope)?envelope[ROWS_KEY]:void 0;if(!Array.isArray(rows))return{projected:envelope,changed:!1};let rowsChanged=!1;const nextRows=rows.map(row=>{if(!isPlainObject(row))return row;const compactedRow=compactOwnChangedFields(row);return compactedRow?(rowsChanged=!0,compactedRow):row});return rowsChanged?{projected:replaceRows(envelope,nextRows),changed:!0}:{projected:envelope,changed:!1}}function projectMutationResult(result,options={}){const compound=projectCompoundMutation(result,options);if(compound!==null)return compound;if(options.idOnly===!0){const idOnly=projectIdOnlyResult(result);if(idOnly!==null)return idOnly}if(options.compactEnvelope===!0||options.changedFields==="compact"){const compact=projectCompactMutationEnvelope(result,options.compactEnvelope===!0);if(compact!==null)return compact}if((options.changedFields??"full")==="full"||!isPlainObject(result))return result;let changed=!1,projected=result;const compactedTop=isMutationEnvelope(result)?compactOwnChangedFields(result):null;compactedTop!==null&&(projected=compactedTop,changed=!0);const rowProjection=compactUpdateManyRows(projected);return rowProjection.changed&&(projected=rowProjection.projected,changed=!0),changed?projected:result}export{projectMutationResult};
 //# sourceMappingURL=mutation-projection.js.map

package/dist/core/output/output-control.d.ts

@@ -8,11 +8,11 @@ export declare const SUPPRESS_HOST_OUTPUT_MARKER = "@unbrained/pm-cli:suppress-h
 /** A handled result that tells a pm host not to render or write another payload. */
 export interface SuppressedHostOutput<TResult = unknown> {
 /** Explicit protocol marker consumed by CLI and SDK-built presentation hosts. */
-readonly __pm_suppress_host_output: typeof SUPPRESS_HOST_OUTPUT_MARKER;
+readonly __pm_suppress_host_output:typeof SUPPRESS_HOST_OUTPUT_MARKER;
 /** Optional structured result retained for hooks, telemetry, and embedding hosts. */
-readonly result?: TResult;
+readonly result?:TResult;
 }
 /** Return from a command/exporter after it has written its own streaming, binary, or pre-rendered output. */
-export declare function suppressHostOutput<TResult = undefined>(result?: TResult): SuppressedHostOutput<TResult>;
+export declare function suppressHostOutput<TResult = undefined>(result?:TResult):SuppressedHostOutput<TResult>;
 /** Detect the public suppression result without relying on object identity across package boundaries. */
-export declare function isHostOutputSuppressed(value: unknown): value is SuppressedHostOutput;
+export declare function isHostOutputSuppressed(value:unknown):value is SuppressedHostOutput;

package/dist/core/output/output.d.ts

@@ -1,67 +1,67 @@
 /** Host output controls shared by command execution and extension rendering. */
 export interface OutputOptions {
 /** Select JSON explicitly; otherwise use the host default format. */
-json?: boolean;
+json?:boolean;
 /** Suppress process output while retaining the active command result. */
-quiet?: boolean;
+quiet?:boolean;
 /** When true, mutation results drop the verbose changed_fields array (keeps changed_field_count). */
-noChangedFields?: boolean;
+noChangedFields?:boolean;
 /** When true, preserve the legacy full mutation envelope and changed-fields array. */
-fullChangedFields?: boolean;
+fullChangedFields?:boolean;
 /** When true, single-item mutation results print only id and status. */
-idOnly?: boolean;
+idOnly?:boolean;
 /** When true, JSON output omits null, undefined, and empty containers recursively. */
-lean?: boolean;
+lean?:boolean;
 /** Attach a bounded receipt for the emitted output before the receipt itself. */
-tokenAccounting?: boolean;
+tokenAccounting?:boolean;
 /** Canonical comma-separated fields or sections retained in read output. */
-outputInclude?: string;
+outputInclude?:string;
 /** Canonical maximum row count retained in read output. */
-outputLimit?: string;
+outputLimit?:string;
 /** Canonical estimated-token ceiling for read output. */
-outputBudget?: string;
+outputBudget?:string;
 /** Canonical renderer encoding for read output. */
-outputFormat?: "toon" | "json";
+outputFormat?:"toon" | "json";
 /** Caller-carried cross-call budget and served-item state. */
-outputSession?: string;
+outputSession?:string;
 /** Opaque budget-compaction continuation cursor. */
-outputCursor?: string;
+outputCursor?:string;
 /** Include machine-readable row location and row-encoding metadata. */
-outputRowContract?: boolean;
+outputRowContract?:boolean;
 /** Fallback output format used when callers do not provide an override. */
-defaultOutputFormat?: "toon" | "json";
+defaultOutputFormat?:"toon" | "json";
 /** Command identity used to resolve read contracts and extension overrides. */
-command?: string;
+command?:string;
 /** Positional arguments passed to the output service override. */
-commandArgs?: string[];
+commandArgs?:string[];
 /** Command options merged with active invocation options for output contracts. */
-commandOptions?: Record<string, unknown>;
+commandOptions?:Record<string,unknown>;
 /** Tracker root supplied to the output service override. */
-pmRoot?: string;
+pmRoot?:string;
 }
 /** Write stdout and return false when its consumer has closed the pipe. */
-export declare function writeStdout(text: string): boolean;
+export declare function writeStdout(text:string):boolean;
 /** Write stderr and preserve diagnostic delivery failures in the process exit code. */
-export declare function writeStderr(text: string): boolean;
+export declare function writeStderr(text:string):boolean;
 /** Keep sparse presentation rules shared while allowing lean JSON to retain count aliases. */
-declare function compactToonValue(value: unknown, omitDuplicateCountAliases?: boolean): unknown | undefined;
+declare function compactToonValue(value:unknown,omitDuplicateCountAliases?:boolean):unknown | undefined;
 /** Render objects recursively and arrays through the standard TOON encoder. */
-declare function renderToonValue(value: unknown, depth: number): string;
+declare function renderToonValue(value:unknown,depth:number):string;
 /**
  * Render a result with pm's built-in JSON or TOON formatter without invoking
  * extension overrides. SDK budget accounting uses this exact representation
  * so reported token cost describes the bytes the host emits by default.
  */
-export declare function formatBuiltInOutput(result: unknown, format: "json" | "toon"): string;
+export declare function formatBuiltInOutput(result:unknown,format:"json" | "toon"):string;
 /** Resolve command ownership and suppression before projecting and rendering the result. */
-export declare function formatOutput(result: unknown, options: OutputOptions): string;
+export declare function formatOutput(result:unknown,options:OutputOptions):string;
 /** Apply declared exit codes and mutation projection before writing a nonquiet result. */
-export declare function printResult(result: unknown, options: OutputOptions): void;
+export declare function printResult(result:unknown,options:OutputOptions):void;
 /** Apply the error service override and emit one newline-terminated diagnostic. */
-export declare function printError(message: string): void;
+export declare function printError(message:string):void;
 /** Internal rendering seams retained for deterministic presentation regression tests. */
-export declare const outputTestOnly: {
-compactToonValue: typeof compactToonValue;
-renderToonValue: typeof renderToonValue;
+export declare const outputTestOnly:{
+compactToonValue:typeof compactToonValue;
+renderToonValue:typeof renderToonValue;
 };
 export {};

package/dist/core/output/query-summary.d.ts

@@ -10,12 +10,12 @@
 /** Compact echo of filters and projection mode applied to list/search responses. */
 export interface QuerySummary {
 /** Value that configures or reports filters for this contract. */
-filters: Record<string, unknown>;
+filters:Record<string,unknown>;
 /** Value that configures or reports projection for this contract. */
-projection: string;
+projection:string;
 }
 /** Resolve the projection label implied by list/search projection options. Used when the result payload itself carries no projection metadata (the compact summary paths omit it for token efficiency). */
-export declare function resolveQueryProjectionLabel(options: Record<string, unknown>): string;
+export declare function resolveQueryProjectionLabel(options:Record<string,unknown>):string;
 /**
  * Attach a `query_summary` to a list/search result.
  *
@@ -25,6 +25,6 @@ export declare function resolveQueryProjectionLabel(options: Record<string, unkn
  * verbose payloads, and the options-derived label covers the compact summary
  * paths that omit projection metadata.
  */
-export declare function withQuerySummary<T extends Record<string, unknown>>(result: T, options: Record<string, unknown>): T & {
-query_summary: QuerySummary;
+export declare function withQuerySummary<T extends Record<string,unknown>>(result:T,options:Record<string,unknown>):T & {
+query_summary:QuerySummary;
 };

package/dist/core/output/tabular.d.ts

@@ -7,8 +7,8 @@
  * spreadsheet or terminal get a directly consumable shape.
  */
 /** A projected row: a flat map of column name to scalar/collection cell value. */
-export type TabularRow = Record<string, unknown>;
+export type TabularRow = Record<string,unknown>;
 /** Renders rows as RFC 4180 CSV with a header row of column names. Returns an empty string when there are no rows so callers emit nothing rather than a stray blank line. */
-export declare function renderRowsAsCsv(rows: TabularRow[]): string;
+export declare function renderRowsAsCsv(rows:TabularRow[]):string;
 /** Renders rows as a fixed-width text table: a header row, a dashed separator, and one padded row per item. Columns are widened to fit their widest cell so the output stays aligned in a monospace terminal. Returns an empty string when there are no rows. */
-export declare function renderRowsAsTable(rows: TabularRow[]): string;
+export declare function renderRowsAsTable(rows:TabularRow[]):string;

package/dist/core/packages/manifest.d.ts

@@ -1,74 +1,74 @@
 /** Public contract for pm package resource kinds, shared by SDK and presentation-layer consumers. */
-export declare const PM_PACKAGE_RESOURCE_KINDS: readonly ["extensions", "docs", "examples", "assets", "prompts"];
+export declare const PM_PACKAGE_RESOURCE_KINDS:readonly ["extensions","docs","examples","assets","prompts"];
 /** Restricts pm package resource kind values accepted by command, SDK, and storage contracts. */
 export type PmPackageResourceKind = (typeof PM_PACKAGE_RESOURCE_KINDS)[number];
 /** Restricts pm package resource map values accepted by command, SDK, and storage contracts. */
-export type PmPackageResourceMap = Partial<Record<PmPackageResourceKind, string[]>>;
+export type PmPackageResourceMap = Partial<Record<PmPackageResourceKind,string[]>>;
 /** Documents the pm package catalog link map payload exchanged by command, SDK, and package integrations. */
 export interface PmPackageCatalogLinkMap {
 /** Value that configures or reports docs for this contract. */
-docs?: string;
+docs?:string;
 /** Value that configures or reports npm for this contract. */
-npm?: string;
+npm?:string;
 /** Value that configures or reports repository for this contract. */
-repository?: string;
+repository?:string;
 /** Value that configures or reports report for this contract. */
-report?: string;
+report?:string;
 }
 /** Documents the pm package catalog media map payload exchanged by command, SDK, and package integrations. */
 export interface PmPackageCatalogMediaMap {
 /** Value that configures or reports image for this contract. */
-image?: string;
+image?:string;
 /** Value that configures or reports video for this contract. */
-video?: string;
+video?:string;
 }
 /** Documents the pm package catalog metadata payload exchanged by command, SDK, and package integrations. */
 export interface PmPackageCatalogMetadata {
 /** Value that configures or reports display name for this contract. */
-display_name?: string;
+display_name?:string;
 /** Value that configures or reports category for this contract. */
-category?: string;
+category?:string;
 /** Value that configures or reports summary for this contract. */
-summary?: string;
+summary?:string;
 /** Value that configures or reports links for this contract. */
-links?: PmPackageCatalogLinkMap;
+links?:PmPackageCatalogLinkMap;
 /** Value that configures or reports media for this contract. */
-media?: PmPackageCatalogMediaMap;
+media?:PmPackageCatalogMediaMap;
 /** Value that configures or reports tags for this contract. */
-tags?: string[];
+tags?:string[];
 }
 /** Documents the pm package manifest payload exchanged by command, SDK, and package integrations. */
 export interface PmPackageManifest {
 /** Value that configures or reports source for this contract. */
-source: "pm" | "convention";
+source:"pm" | "convention";
 /** Filesystem path used for package json resolution. */
-package_json_path?: string;
+package_json_path?:string;
 /** Value that configures or reports package name for this contract. */
-package_name?: string;
+package_name?:string;
 /** Value that configures or reports package version for this contract. */
-package_version?: string;
+package_version?:string;
 /** Value that configures or reports package private for this contract. */
-package_private?: boolean;
+package_private?:boolean;
 /** Value that configures or reports package description for this contract. */
-package_description?: string;
+package_description?:string;
 /** Value that configures or reports package keywords for this contract. */
-package_keywords?: string[];
+package_keywords?:string[];
 /** Value that configures or reports package homepage for this contract. */
-package_homepage?: string;
+package_homepage?:string;
 /** Value that configures or reports package repository url for this contract. */
-package_repository_url?: string;
+package_repository_url?:string;
 /** Value that configures or reports package bugs url for this contract. */
-package_bugs_url?: string;
+package_bugs_url?:string;
 /** Value that configures or reports aliases for this contract. */
-aliases?: string[];
+aliases?:string[];
 /** Value that configures or reports resources for this contract. */
-resources: PmPackageResourceMap;
+resources:PmPackageResourceMap;
 /** Value that configures or reports catalog for this contract. */
-catalog?: PmPackageCatalogMetadata;
+catalog?:PmPackageCatalogMetadata;
 }
 /** Public contract for pm package conventional resource roots, shared by SDK and presentation-layer consumers. */
-export declare const PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS: Readonly<Record<PmPackageResourceKind, readonly string[]>>;
+export declare const PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS:Readonly<Record<PmPackageResourceKind,readonly string[]>>;
 /** Implements read pm package manifest for the public runtime surface of this module. */
-export declare function readPmPackageManifest(packageRoot: string): Promise<PmPackageManifest>;
+export declare function readPmPackageManifest(packageRoot:string):Promise<PmPackageManifest>;
 /** Implements collect package extension directories for the public runtime surface of this module. */
-export declare function collectPackageExtensionDirectories(packageRoot: string): Promise<string[]>;
+export declare function collectPackageExtensionDirectories(packageRoot:string):Promise<string[]>;

package/dist/core/packages/root.d.ts

@@ -1,7 +1,7 @@
 /** Implements find pm package root from path for the public runtime surface of this module. */
-export declare function findPmPackageRootFromPath(startPath: string): string | undefined;
+export declare function findPmPackageRootFromPath(startPath:string):string | undefined;
 /** Implements resolve pm package root from module for the public runtime surface of this module. */
-export declare function resolvePmPackageRootFromModule(metaUrl: string, fallbackRelativeSegments?: string[]): string;
+export declare function resolvePmPackageRootFromModule(metaUrl:string,fallbackRelativeSegments?:string[]):string;
 /**
  * Read the pm-cli package version from the resolved package root's `package.json`.
  *
@@ -11,6 +11,6 @@ export declare function resolvePmPackageRootFromModule(metaUrl: string, fallback
  * own fallback (the CLI/MCP use `"0.0.0"`). Resolution must never throw, so the
  * hot startup path is safe.
  */
-export declare function resolvePmCliVersion(metaUrl: string, fallbackRelativeSegments?: string[]): string | undefined;
+export declare function resolvePmCliVersion(metaUrl:string,fallbackRelativeSegments?:string[]):string | undefined;
 /** Implements resolve configured pm package root for the public runtime surface of this module. */
-export declare function resolveConfiguredPmPackageRoot(env?: NodeJS.ProcessEnv, envName?: string, metaUrl?: string, fallbackRelativeSegments?: string[]): string;
+export declare function resolveConfiguredPmPackageRoot(env?:NodeJS.ProcessEnv,envName?:string,metaUrl?:string,fallbackRelativeSegments?:string[]):string;