@unbrained/pm-cli 2026.10.12 → 2026.10.14

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

package/dist/core/shared/secret-rules.d.ts

@@ -5,106 +5,106 @@
  */
 /** One detector and any explicit repository-only scope exception. */
 export interface SecretRule {
-    /** Repository diagnostic identifier. */
-    name: string;
-    /** Compatible SDK diagnostic identifier. */
-    mutationRule: string;
-    /** Global pattern; consumers reset lastIndex before each scan. */
-    regex: RegExp;
-    /** Repository paths with deliberate fixture exemptions. */
-    excludeFiles?: RegExp;
-    /** Repository paths eligible for this rule. */
-    includeFiles?: RegExp;
-    /** Why the repository gate deliberately omits this mutation heuristic. */
-    mutationOnlyReason?: string;
-    /** Minimum Shannon entropy of the first capture group, when applicable. */
-    minimumEntropy?: number;
+/** Repository diagnostic identifier. */
+name: string;
+/** Compatible SDK diagnostic identifier. */
+mutationRule: string;
+/** Global pattern; consumers reset lastIndex before each scan. */
+regex: RegExp;
+/** Repository paths with deliberate fixture exemptions. */
+excludeFiles?: RegExp;
+/** Repository paths eligible for this rule. */
+includeFiles?: RegExp;
+/** Why the repository gate deliberately omits this mutation heuristic. */
+mutationOnlyReason?: string;
+/** Minimum Shannon entropy of the first capture group, when applicable. */
+minimumEntropy?: number;
 }
 /** Canonical patterns; repository exemptions never exempt mutation payloads. */
 export declare const SECRET_RULES: readonly [{
-    readonly name: "private-key";
-    readonly mutationRule: "private_key";
-    readonly regex: RegExp;
-}, {
-    readonly name: "github-token";
-    readonly mutationRule: "github_token";
-    readonly regex: RegExp;
-}, {
-    readonly name: "npm-token";
-    readonly mutationRule: "npm_token";
-    readonly regex: RegExp;
-}, {
-    readonly name: "aws-access-key";
-    readonly mutationRule: "aws_access_key";
-    readonly regex: RegExp;
-}, {
-    readonly name: "google-api-key";
-    readonly mutationRule: "google_api_key";
-    readonly regex: RegExp;
-}, {
-    readonly name: "slack-token";
-    readonly mutationRule: "slack_token";
-    readonly regex: RegExp;
-}, {
-    readonly name: "anthropic-api-key";
-    readonly mutationRule: "anthropic_api_key";
-    readonly regex: RegExp;
-}, {
-    readonly name: "openai-api-key";
-    readonly mutationRule: "openai_api_key";
-    readonly regex: RegExp;
-}, {
-    readonly name: "gitlab-token";
-    readonly mutationRule: "gitlab_token";
-    readonly regex: RegExp;
-}, {
-    readonly name: "jwt-like-token";
-    readonly mutationRule: "jwt_like_token";
-    readonly regex: RegExp;
-}, {
-    readonly name: "npm-auth-token-assignment";
-    readonly mutationRule: "npm_auth_token_assignment";
-    readonly regex: RegExp;
-}, {
-    readonly name: "sentry-user-token";
-    readonly mutationRule: "sentry_user_token";
-    readonly regex: RegExp;
-}, {
-    readonly name: "sentry-org-token";
-    readonly mutationRule: "sentry_org_token";
-    readonly regex: RegExp;
-}, {
-    readonly name: "private-ip";
-    readonly mutationRule: "private_ip";
-    readonly regex: RegExp;
-}, {
-    readonly name: "private-ssh-target";
-    readonly mutationRule: "private_ssh_target";
-    readonly regex: RegExp;
-}, {
-    readonly name: "sshpass-inline-password";
-    readonly mutationRule: "sshpass_inline_password";
-    readonly regex: RegExp;
-}, {
-    readonly name: "password-assignment";
-    readonly mutationRule: "password_assignment";
-    readonly regex: RegExp;
-}, {
-    readonly name: "absolute-home-path";
-    readonly mutationRule: "absolute_home_path";
-    readonly regex: RegExp;
-    readonly excludeFiles: RegExp;
-}, {
-    readonly name: "user-at-private-host";
-    readonly mutationRule: "user_at_private_host";
-    readonly regex: RegExp;
-    readonly excludeFiles: RegExp;
-}, {
-    readonly name: "high-entropy-assignment";
-    readonly mutationRule: "high_entropy_assignment";
-    readonly regex: RegExp;
-    readonly mutationOnlyReason: "Generic assignments in source code are not credentials; preserve the existing mutation heuristic without treating source identifiers as secrets.";
-    readonly minimumEntropy: 3.5;
+readonly name: "private-key";
+readonly mutationRule: "private_key";
+readonly regex: RegExp;
+}, {
+readonly name: "github-token";
+readonly mutationRule: "github_token";
+readonly regex: RegExp;
+}, {
+readonly name: "npm-token";
+readonly mutationRule: "npm_token";
+readonly regex: RegExp;
+}, {
+readonly name: "aws-access-key";
+readonly mutationRule: "aws_access_key";
+readonly regex: RegExp;
+}, {
+readonly name: "google-api-key";
+readonly mutationRule: "google_api_key";
+readonly regex: RegExp;
+}, {
+readonly name: "slack-token";
+readonly mutationRule: "slack_token";
+readonly regex: RegExp;
+}, {
+readonly name: "anthropic-api-key";
+readonly mutationRule: "anthropic_api_key";
+readonly regex: RegExp;
+}, {
+readonly name: "openai-api-key";
+readonly mutationRule: "openai_api_key";
+readonly regex: RegExp;
+}, {
+readonly name: "gitlab-token";
+readonly mutationRule: "gitlab_token";
+readonly regex: RegExp;
+}, {
+readonly name: "jwt-like-token";
+readonly mutationRule: "jwt_like_token";
+readonly regex: RegExp;
+}, {
+readonly name: "npm-auth-token-assignment";
+readonly mutationRule: "npm_auth_token_assignment";
+readonly regex: RegExp;
+}, {
+readonly name: "sentry-user-token";
+readonly mutationRule: "sentry_user_token";
+readonly regex: RegExp;
+}, {
+readonly name: "sentry-org-token";
+readonly mutationRule: "sentry_org_token";
+readonly regex: RegExp;
+}, {
+readonly name: "private-ip";
+readonly mutationRule: "private_ip";
+readonly regex: RegExp;
+}, {
+readonly name: "private-ssh-target";
+readonly mutationRule: "private_ssh_target";
+readonly regex: RegExp;
+}, {
+readonly name: "sshpass-inline-password";
+readonly mutationRule: "sshpass_inline_password";
+readonly regex: RegExp;
+}, {
+readonly name: "password-assignment";
+readonly mutationRule: "password_assignment";
+readonly regex: RegExp;
+}, {
+readonly name: "absolute-home-path";
+readonly mutationRule: "absolute_home_path";
+readonly regex: RegExp;
+readonly excludeFiles: RegExp;
+}, {
+readonly name: "user-at-private-host";
+readonly mutationRule: "user_at_private_host";
+readonly regex: RegExp;
+readonly excludeFiles: RegExp;
+}, {
+readonly name: "high-entropy-assignment";
+readonly mutationRule: "high_entropy_assignment";
+readonly regex: RegExp;
+readonly mutationOnlyReason: "Generic assignments in source code are not credentials; preserve the existing mutation heuristic without treating source identifiers as secrets.";
+readonly minimumEntropy: 3.5;
 }];
 /** Accept a pattern match, applying the declared entropy predicate when present. */
 export declare function acceptsSecretMatch(rule: SecretRule, match: RegExpMatchArray): boolean;

package/dist/core/shared/serial-queue.d.ts

@@ -5,17 +5,17 @@
  */
 /** Defines the FIFO queue contract used to serialize asynchronous mutation-sensitive work. */
 export interface SerialQueue {
-    /** Schedule `task` to run after every previously-enqueued task has settled. Returns a promise for this task's result (or rejection) so callers can await individual outcomes. A rejected task never wedges the queue: later tasks still run in order. */
-    enqueue<T>(task: () => Promise<T> | T): Promise<T>;
-    /** Resolves once the queue has fully drained (no pending tasks remain). */
-    idle(): Promise<void>;
+/** Schedule `task` to run after every previously-enqueued task has settled. Returns a promise for this task's result (or rejection) so callers can await individual outcomes. A rejected task never wedges the queue: later tasks still run in order. */
+enqueue<T>(task: () => Promise<T> | T): Promise<T>;
+/** Resolves once the queue has fully drained (no pending tasks remain). */
+idle(): Promise<void>;
 }
 /** Coordinates concurrent readers with FIFO-exclusive writers without serializing independent read work. */
 export interface AsyncReadWriteGate {
-    /** Run work concurrently after every writer scheduled before this call has settled. */
-    read<T>(task: () => Promise<T> | T): Promise<T>;
-    /** Run work exclusively after all readers and writers scheduled before this call have settled. */
-    write<T>(task: () => Promise<T> | T): Promise<T>;
+/** Run work concurrently after every writer scheduled before this call has settled. */
+read<T>(task: () => Promise<T> | T): Promise<T>;
+/** Run work exclusively after all readers and writers scheduled before this call have settled. */
+write<T>(task: () => Promise<T> | T): Promise<T>;
 }
 /** Create an arrival-ordered asynchronous read/write gate. Readers may overlap, while writers exclude both modes and never starve behind later readers. */
 export declare function createAsyncReadWriteGate(): AsyncReadWriteGate;