@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/sdk/error-code-catalog.d.ts

@@ -10,56 +10,56 @@ export type PmErrorCodeStability = "provisional" | "stable";
 export type PmErrorCodeClass = "generic_failure" | "usage" | "not_found" | "conflict" | "dependency_failed";
 /** One externally observable refusal state and its executable entrypoint probe. */
 export interface PmRefusalStateContract {
-    /** Stable semantic state owned by the error code. */
-    state: string;
-    /** Stable probe identifier implemented by the entrypoint conformance suite. */
-    probe_id: string;
-    /** Public command roots through which the state must remain reachable. */
-    entrypoints: string[];
-    /** Exit class expected when the probe reaches the state. */
-    expected_exit_class: PmErrorCodeClass;
+/** Stable semantic state owned by the error code. */
+state: string;
+/** Stable probe identifier implemented by the entrypoint conformance suite. */
+probe_id: string;
+/** Public command roots through which the state must remain reachable. */
+entrypoints: string[];
+/** Exit class expected when the probe reaches the state. */
+expected_exit_class: PmErrorCodeClass;
 }
 /** Stable shell exit-code taxonomy shared by every structured error. */
 export declare const PM_ERROR_CODE_EXIT_CLASS_CONTRACTS: readonly [{
-    readonly exit_code: 1;
-    readonly class: "generic_failure";
+readonly exit_code: 1;
+readonly class: "generic_failure";
 }, {
-    readonly exit_code: 2;
-    readonly class: "usage";
+readonly exit_code: 2;
+readonly class: "usage";
 }, {
-    readonly exit_code: 3;
-    readonly class: "not_found";
+readonly exit_code: 3;
+readonly class: "not_found";
 }, {
-    readonly exit_code: 4;
-    readonly class: "conflict";
+readonly exit_code: 4;
+readonly class: "conflict";
 }, {
-    readonly exit_code: 5;
-    readonly class: "dependency_failed";
+readonly exit_code: 5;
+readonly class: "dependency_failed";
 }];
 /** One machine-readable error and its portable recovery contract. */
 export interface PmErrorCodeContract {
-    /** Stable snake_case identifier. */
-    code: string;
-    /** Concise description of the failed condition. */
-    meaning: string;
-    /** Compatibility tier for package consumers. */
-    stability: PmErrorCodeStability;
-    /** Process exit code emitted by the CLI transport. */
-    exit_code: 1 | 2 | 3 | 4 | 5;
-    /** Semantic class represented by the process exit code. */
-    class: PmErrorCodeClass;
-    /** Actionable caller recovery guidance. */
-    recovery: string;
-    /** Subsystems that can emit the code. */
-    sources: string[];
-    /** CLI command roots inferred from executable declaration ownership. */
-    emitting_commands: string[];
-    /** Canonical machine identifier for this compatibility group. */
-    canonical_code?: string;
-    /** Stable compatibility spellings that resolve to this canonical code. */
-    aliases?: string[];
-    /** Observable states this code claims, each backed by a real-entrypoint probe. */
-    owned_states?: PmRefusalStateContract[];
+/** Stable snake_case identifier. */
+code: string;
+/** Concise description of the failed condition. */
+meaning: string;
+/** Compatibility tier for package consumers. */
+stability: PmErrorCodeStability;
+/** Process exit code emitted by the CLI transport. */
+exit_code: 1 | 2 | 3 | 4 | 5;
+/** Semantic class represented by the process exit code. */
+class: PmErrorCodeClass;
+/** Actionable caller recovery guidance. */
+recovery: string;
+/** Subsystems that can emit the code. */
+sources: string[];
+/** CLI command roots inferred from executable declaration ownership. */
+emitting_commands: string[];
+/** Canonical machine identifier for this compatibility group. */
+canonical_code?: string;
+/** Stable compatibility spellings that resolve to this canonical code. */
+aliases?: string[];
+/** Observable states this code claims, each backed by a real-entrypoint probe. */
+owned_states?: PmRefusalStateContract[];
 }
 /** Validate, normalize, sort, and freeze an error-code catalog. */
 export declare function definePmErrorCodeCatalog(declarations: readonly PmErrorCodeContract[]): readonly PmErrorCodeContract[];

package/dist/sdk/errors.d.ts

@@ -20,32 +20,32 @@ export declare const PM_CLI_EXPECTED_ERROR_NAME = "PmCliError";
  * class, which keeps the contract stable across bundling boundaries.
  */
 export interface PmCliExpectedError extends Error {
-    /** Discriminant tag; always {@link PM_CLI_EXPECTED_ERROR_NAME}. */
-    name: typeof PM_CLI_EXPECTED_ERROR_NAME;
-    /** Positive process exit code the CLI should terminate with for this failure. */
-    exitCode: number;
-    /** Stable producer-owned error code, mirrored from context when available. */
-    code?: string;
-    /** Structured, secret-free metadata attached for diagnostics and error guidance. */
-    context: PmCliErrorContext;
-    /** Optional underlying error that triggered this one, preserved for cause chaining. */
-    cause?: unknown;
+/** Discriminant tag; always {@link PM_CLI_EXPECTED_ERROR_NAME}. */
+name: typeof PM_CLI_EXPECTED_ERROR_NAME;
+/** Positive process exit code the CLI should terminate with for this failure. */
+exitCode: number;
+/** Stable producer-owned error code, mirrored from context when available. */
+code?: string;
+/** Structured, secret-free metadata attached for diagnostics and error guidance. */
+context: PmCliErrorContext;
+/** Optional underlying error that triggered this one, preserved for cause chaining. */
+cause?: unknown;
 }
 /** A refused create operation whose canonical ID already names a persisted item. */
 export interface PmItemAlreadyExistsError extends PmCliExpectedError {
-    /** Stable discriminator independent of the diagnostic message. */
-    code: "item_already_exists";
-    /** Creation conflicts preserve the existing conflict exit-code contract. */
-    exitCode: typeof EXIT_CODE.CONFLICT;
-    /** Canonical identity and actual persisted path for a safe subsequent read. */
-    context: PmCliErrorContext & {
-        /** Producer-owned existing-item discriminator. */
-        code: "item_already_exists";
-        /** Normalized ID of the preserved existing item. */
-        id: string;
-        /** Actual document path of the preserved existing item. */
-        path: string;
-    };
+/** Stable discriminator independent of the diagnostic message. */
+code: "item_already_exists";
+/** Creation conflicts preserve the existing conflict exit-code contract. */
+exitCode: typeof EXIT_CODE.CONFLICT;
+/** Canonical identity and actual persisted path for a safe subsequent read. */
+context: PmCliErrorContext & {
+/** Producer-owned existing-item discriminator. */
+code: "item_already_exists";
+/** Normalized ID of the preserved existing item. */
+id: string;
+/** Actual document path of the preserved existing item. */
+path: string;
+};
 }
 /**
  * Detect an existing-item create conflict across separately bundled SDKs.
@@ -59,12 +59,12 @@ export declare function isItemAlreadyExistsError(error: unknown): error is PmIte
  * `cause`.
  */
 export interface CreatePmCliExpectedErrorOptions {
-    /** Positive exit code to assign; defaults to the usage-error code. Non-finite or non-positive values throw. */
-    exitCode?: number;
-    /** Structured, secret-free diagnostic metadata to attach to the error. */
-    context?: PmCliErrorContext;
-    /** Underlying error to retain as a non-enumerable `cause` when provided. */
-    cause?: unknown;
+/** Positive exit code to assign; defaults to the usage-error code. Non-finite or non-positive values throw. */
+exitCode?: number;
+/** Structured, secret-free diagnostic metadata to attach to the error. */
+context?: PmCliErrorContext;
+/** Underlying error to retain as a non-enumerable `cause` when provided. */
+cause?: unknown;
 }
 /**
  * Create a package-safe expected CLI error.

package/dist/sdk/eval.d.ts

@@ -5,57 +5,57 @@ export { EVAL_QUERY_SET_CONTRACT, EVAL_QUERY_SET_EXAMPLE, EVAL_QUERY_SET_SCHEMA_
 export declare const DEFAULT_EVAL_QUERIES_RELATIVE_PATH: string;
 /** Evaluation inputs shared by SDK hosts and the CLI adapter. */
 export interface EvalOptions {
-    /** Default retrieval mode for queries that do not set their own (keyword|semantic|hybrid). */
-    mode?: string;
-    /** Metric cutoff (`@k`); positive integer, defaults to {@link DEFAULT_EVAL_K}. */
-    k?: string | number;
-    /** Gate threshold: exit non-zero when the aggregate nDCG@k falls below this `[0,1]` value. */
-    failUnder?: string | number;
-    /** Override path to the golden-query JSON file (defaults to `<pmRoot>/search/eval-queries.json`). */
-    queries?: string;
-    /** Output format override: json|toon. */
-    format?: string;
+/** Default retrieval mode for queries that do not set their own (keyword|semantic|hybrid). */
+mode?: string;
+/** Metric cutoff (`@k`); positive integer, defaults to {@link DEFAULT_EVAL_K}. */
+k?: string | number;
+/** Gate threshold: exit non-zero when the aggregate nDCG@k falls below this `[0,1]` value. */
+failUnder?: string | number;
+/** Override path to the golden-query JSON file (defaults to `<pmRoot>/search/eval-queries.json`). */
+queries?: string;
+/** Output format override: json|toon. */
+format?: string;
 }
 /** Per-query relevance report row emitted by {@link runEval}. */
 export interface EvalQueryReport {
-    /** Original golden-query text used for retrieval. */
-    query: string;
-    /** Resolved retrieval mode after applying query and run defaults. */
-    mode: EvalSearchMode;
-    /** Number of unique items judged relevant to this query. */
-    relevant_total: number;
-    /** Relevant items found within the ranking cutoff. */
-    retrieved_relevant: number;
-    /** Normalized discounted cumulative gain at the selected cutoff. */
-    ndcg: number;
-    /** Reciprocal rank of the first relevant result, or zero when absent. */
-    mrr: number;
-    /** Fraction of positions at the selected cutoff containing relevant items. */
-    precision: number;
-    /** Fraction of judged relevant items retrieved at the selected cutoff. */
-    recall: number;
-    /** Failed per-query floors, compared against unrounded scores. */
-    violations?: string[];
+/** Original golden-query text used for retrieval. */
+query: string;
+/** Resolved retrieval mode after applying query and run defaults. */
+mode: EvalSearchMode;
+/** Number of unique items judged relevant to this query. */
+relevant_total: number;
+/** Relevant items found within the ranking cutoff. */
+retrieved_relevant: number;
+/** Normalized discounted cumulative gain at the selected cutoff. */
+ndcg: number;
+/** Reciprocal rank of the first relevant result, or zero when absent. */
+mrr: number;
+/** Fraction of positions at the selected cutoff containing relevant items. */
+precision: number;
+/** Fraction of judged relevant items retrieved at the selected cutoff. */
+recall: number;
+/** Failed per-query floors, compared against unrounded scores. */
+violations?: string[];
 }
 /** Rounded ranking evidence and the verdict computed from unrounded metrics. */
 export interface EvalResult {
-    /** Maximum ranking positions scored for each query. */
-    k: number;
-    /** Number of query entries represented by this result. */
-    query_count: number;
-    /** Equal-weight macro averages across all evaluated queries. */
-    aggregate: {
-        ndcg: number;
-        mrr: number;
-        precision: number;
-        recall: number;
-    };
-    /** Individual query scores and any failed declared floors. */
-    queries: EvalQueryReport[];
-    /** Present only when `--fail-under` was supplied. */
-    fail_under?: number;
-    /** Whether every declared per-query floor and optional aggregate nDCG threshold passed. */
-    passed: boolean;
+/** Maximum ranking positions scored for each query. */
+k: number;
+/** Number of query entries represented by this result. */
+query_count: number;
+/** Equal-weight macro averages across all evaluated queries. */
+aggregate: {
+ndcg: number;
+mrr: number;
+precision: number;
+recall: number;
+};
+/** Individual query scores and any failed declared floors. */
+queries: EvalQueryReport[];
+/** Present only when `--fail-under` was supplied. */
+fail_under?: number;
+/** Whether every declared per-query floor and optional aggregate nDCG threshold passed. */
+passed: boolean;
 }
 /**
  * Run the search-relevance evaluation (pm-u8n5). Loads the golden-query set

package/dist/sdk/extension/author-manifest.d.ts

@@ -1,20 +1,20 @@
 import { type ExtensionManifestSchemaFinding } from "../../core/extensions/manifest-schema.js";
 /** Read-only author-workspace manifest diagnostic shared by health and doctor. */
 export interface ExtensionAuthorManifestDiagnostic {
-    /** Absolute path inspected for the extension runtime manifest. */
-    path: string;
-    /** Whether the workspace declares a root extension manifest. */
-    present: boolean;
-    /** Parse state for absent, valid, or malformed manifest content. */
-    parse_status: "absent" | "valid" | "invalid_json" | "invalid_shape";
-    /** Canonical package catalog metadata location, distinct from manifest.json. */
-    package_metadata_location: "package.json#pm";
-    /** Public schema findings when the file is a JSON object. */
-    schema_findings: ExtensionManifestSchemaFinding[];
-    /** Runtime warning tokens incorporated into health/doctor status. */
-    warnings: string[];
-    /** Direct author correction for every reported state. */
-    remediation: string[];
+/** Absolute path inspected for the extension runtime manifest. */
+path: string;
+/** Whether the workspace declares a root extension manifest. */
+present: boolean;
+/** Parse state for absent, valid, or malformed manifest content. */
+parse_status: "absent" | "valid" | "invalid_json" | "invalid_shape";
+/** Canonical package catalog metadata location, distinct from manifest.json. */
+package_metadata_location: "package.json#pm";
+/** Public schema findings when the file is a JSON object. */
+schema_findings: ExtensionManifestSchemaFinding[];
+/** Runtime warning tokens incorporated into health/doctor status. */
+warnings: string[];
+/** Direct author correction for every reported state. */
+remediation: string[];
 }
 /** Inspect `<workspace>/manifest.json` without loading extension code. */
 export declare function inspectExtensionAuthorManifest(workspaceRoot: string): Promise<ExtensionAuthorManifestDiagnostic>;

package/dist/sdk/extension/bundled-catalog.d.ts

@@ -19,17 +19,17 @@ export declare function resolveBundledPackageNpmName(alias: string): Promise<str
 export declare function resolveBundledAliasManifestName(input: string): Promise<string | null>;
 /** Implements build bundled package catalog for the public runtime surface of this module. */
 export declare function buildBundledPackageCatalog(scope: ExtensionScope, global: GlobalOptions, options?: ExtensionCommandOptions): Promise<{
-    total: number;
-    scope: ExtensionScope;
-    installable_resource_kinds: string[];
-    metadata_only_resource_kinds: string[];
-    packages: Array<Record<string, unknown>>;
+total: number;
+scope: ExtensionScope;
+installable_resource_kinds: string[];
+metadata_only_resource_kinds: string[];
+packages: Array<Record<string, unknown>>;
 }>;
 declare function parsePackageCatalogFields(raw: string | undefined): string[] | undefined;
 declare function projectPackageCatalogEntry(entry: Record<string, unknown>, fields: string[]): Record<string, unknown>;
 /** Public contract for test only bundled catalog, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyBundledCatalog: {
-    parsePackageCatalogFields: typeof parsePackageCatalogFields;
-    projectPackageCatalogEntry: typeof projectPackageCatalogEntry;
+parsePackageCatalogFields: typeof parsePackageCatalogFields;
+projectPackageCatalogEntry: typeof projectPackageCatalogEntry;
 };
 export {};

package/dist/sdk/extension/describe.d.ts

@@ -31,16 +31,16 @@ export type ExtensionDescribeActivationStatus = "ok" | "failed" | "not_loaded";
  * physical entries.
  */
 export interface ExtensionSurfaceDescription {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports version for this contract. */
-    version: string;
-    /** Activation outcome reported for this extension. */
-    activation_status: ExtensionDescribeActivationStatus;
-    /** Value that configures or reports surfaces for this contract. */
-    surfaces: ExtensionActivationSummary;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports version for this contract. */
+version: string;
+/** Activation outcome reported for this extension. */
+activation_status: ExtensionDescribeActivationStatus;
+/** Value that configures or reports surfaces for this contract. */
+surfaces: ExtensionActivationSummary;
 }
 /**
  * Result of {@link buildExtensionDescribeResult}: the per-extension surface maps
@@ -49,38 +49,38 @@ export interface ExtensionSurfaceDescription {
  * the described entries so callers need not re-measure `extensions`.
  */
 export interface ExtensionDescribeResult {
-    /** Value that configures or reports target for this contract. */
-    target: string | null;
-    /** Value that configures or reports total for this contract. */
-    total: number;
-    /** Value that configures or reports extensions for this contract. */
-    extensions: ExtensionSurfaceDescription[];
-    /** Value that configures or reports union for this contract. */
-    union: ExtensionActivationSummary;
-    /** Deterministic ownership table for every registered command handler or override in scope. */
-    command_ownership: ExtensionCommandOwnership[];
+/** Value that configures or reports target for this contract. */
+target: string | null;
+/** Value that configures or reports total for this contract. */
+total: number;
+/** Value that configures or reports extensions for this contract. */
+extensions: ExtensionSurfaceDescription[];
+/** Value that configures or reports union for this contract. */
+union: ExtensionActivationSummary;
+/** Deterministic ownership table for every registered command handler or override in scope. */
+command_ownership: ExtensionCommandOwnership[];
 }
 /** One package claim on a command path, including whether runtime precedence selects it. */
 export interface ExtensionCommandClaimant {
-    /** Extension manifest name. */
-    name: string;
-    /** Extension discovery layer. */
-    layer: ExtensionLayer;
-    /** Whether this claimant is the effective owner under the declared policy. */
-    winner: boolean;
+/** Extension manifest name. */
+name: string;
+/** Extension discovery layer. */
+layer: ExtensionLayer;
+/** Whether this claimant is the effective owner under the declared policy. */
+winner: boolean;
 }
 /** Inspectable ownership and collision state for one command registry surface. */
 export interface ExtensionCommandOwnership {
-    /** Full command path. */
-    command: string;
-    /** Registry surface that owns dispatch behavior. */
-    surface: "handler" | "override";
-    /** Stable runtime precedence policy. */
-    policy: "last_activated_wins";
-    /** Whether more than one extension claims this path on the same surface. */
-    collision: boolean;
-    /** Every claimant in activation order; exactly the final claimant is the winner. */
-    claimants: ExtensionCommandClaimant[];
+/** Full command path. */
+command: string;
+/** Registry surface that owns dispatch behavior. */
+surface: "handler" | "override";
+/** Stable runtime precedence policy. */
+policy: "last_activated_wins";
+/** Whether more than one extension claims this path on the same surface. */
+collision: boolean;
+/** Every claimant in activation order; exactly the final claimant is the winner. */
+claimants: ExtensionCommandClaimant[];
 }
 /**
  * Summarize, by name, every registration surface the loaded extensions exercised.

package/dist/sdk/extension/doctor.d.ts

@@ -8,33 +8,33 @@ import { type UnknownExtensionCapabilityWarningDetails } from "../../core/extens
 import type { ExtensionCommandOptions, ExtensionDoctorDetailMode, ExtensionScope, ExtensionTriageSummary, ManagedExtensionSummary } from "../extension.js";
 /** Project loader and activation failures into bounded doctor output. */
 export declare function summarizeExtensionFailures(failures: Array<{
-    layer: string;
-    name: string;
-    error: string;
+layer: string;
+name: string;
+error: string;
 }>): Array<{
-    layer: string;
-    name: string;
-    error: string;
+layer: string;
+name: string;
+error: string;
 }>;
 /** Implements apply doctor runtime activation state for the public runtime surface of this module. */
 export declare function applyDoctorRuntimeActivationState(extensions: ManagedExtensionSummary[], loadResult: Awaited<ReturnType<typeof loadExtensions>>, activationResult: Awaited<ReturnType<typeof activateExtensions>>): ManagedExtensionSummary[];
 /** Implements build registration collision remediation for the public runtime surface of this module. */
 export declare function buildRegistrationCollisionRemediation(warnings: string[], commands: {
-    deactivate: string;
-    doctor: string;
+deactivate: string;
+doctor: string;
 }): string | null;
 /** Implements classify doctor load failure warnings for the public runtime surface of this module. */
 export declare function classifyDoctorLoadFailureWarnings(loadFailures: Array<{
-    name: string;
-    error: string;
+name: string;
+error: string;
 }>): string[];
 /** Implements classify doctor activation failure warnings for the public runtime surface of this module. */
 export declare function classifyDoctorActivationFailureWarnings(activationFailures?: Array<{
-    name: string;
-    trace?: {
-        missing_capability?: string;
-        capability?: string;
-    };
+name: string;
+trace?: {
+missing_capability?: string;
+capability?: string;
+};
 }>): string[];
 /**
  * Classify advisory least-privilege warnings for capabilities each loaded
@@ -55,23 +55,23 @@ export declare function parseDoctorDetailMode(raw: string | undefined): Extensio
 export declare function collectUnknownCapabilityGuidance(warnings: string[]): UnknownExtensionCapabilityWarningDetails[];
 /** Implements build capability contract metadata for the public runtime surface of this module. */
 export declare function buildCapabilityContractMetadata(): {
-    version: number;
-    capabilities: string[];
-    legacy_aliases: Record<string, string>;
+version: number;
+capabilities: string[];
+legacy_aliases: Record<string, string>;
 };
 /** Implements build doctor consistency summary for the public runtime surface of this module. */
 export declare function buildDoctorConsistencySummary(scope: ExtensionScope, installedExtensions: ManagedExtensionSummary[], loadedExtensions: Array<{
-    layer: string;
-    name: string;
+layer: string;
+name: string;
 }>, failedLoads: Array<{
-    name: string;
+name: string;
 }>, disabledByFlag: boolean): {
-    warnings: string[];
-    summary: {
-        active_project_count: number;
-        loaded_project_count: number;
-        active_project_names: string[];
-        loaded_project_names: string[];
-        missing_active_project_names: string[];
-    };
+warnings: string[];
+summary: {
+active_project_count: number;
+loaded_project_count: number;
+active_project_names: string[];
+loaded_project_names: string[];
+missing_active_project_names: string[];
+};
 };

package/dist/sdk/extension/install-plan.d.ts

@@ -1,67 +1,67 @@
 import { type ResolvedInstallSource } from "./install-sources.js";
 /** Limits filesystem enumeration independently of the size of the source tree. */
 export interface ExtensionCopyPlanOptions {
-    /** Maximum directory entries inspected; defaults to 10,000. */
-    maxEntries?: number;
-    /** Maximum directory nesting inspected; defaults to 64. */
-    maxDepth?: number;
-    /** Cancels between filesystem operations and closes every open directory handle. */
-    signal?: AbortSignal;
+/** Maximum directory entries inspected; defaults to 10,000. */
+maxEntries?: number;
+/** Maximum directory nesting inspected; defaults to 64. */
+maxDepth?: number;
+/** Cancels between filesystem operations and closes every open directory handle. */
+signal?: AbortSignal;
 }
 /** Observed logical file bytes, excluding dependency installation, metadata writes, and symlink targets. */
 export interface ExtensionCopyPlan {
-    /** Snapshot policy shared with the actual copy operation. */
-    copy_scope: "directory_snapshot" | "nested_filtered_snapshot" | "in_place";
-    /** Absolute source directory used by the copy. */
-    source_directory: string;
-    /** Absolute destination, resolved through existing parent symlinks. */
-    destination_directory: string;
-    /** Regular files included in the observed snapshot. */
-    files: number;
-    /** Sum of observed regular-file logical sizes; a lower bound when incomplete. */
-    bytes: number;
-    /** Included directories, excluding the source root. */
-    directories: number;
-    /** Included symlinks; targets are never traversed. */
-    symlinks: number;
-    /** Included special filesystem entries, whose copy support is platform dependent. */
-    other_entries: number;
-    /** Entries inspected, including exclusions. */
-    scanned_entries: number;
-    /** Entries excluded by the nested-destination policy. */
-    excluded_entries: number;
-    /** Included entries under conventional dependency, VCS, build, or coverage directories. */
-    development_entries: number;
-    /** True only when enumeration finished within both limits. */
-    complete: boolean;
-    /** Why enumeration ended; incomplete counts are never presented as totals. */
-    stop_reason: "complete" | "entry_limit" | "depth_limit";
-    /** Effective maximum directory entries inspected. */
-    max_entries: number;
-    /** Effective maximum directory nesting inspected. */
-    max_depth: number;
+/** Snapshot policy shared with the actual copy operation. */
+copy_scope: "directory_snapshot" | "nested_filtered_snapshot" | "in_place";
+/** Absolute source directory used by the copy. */
+source_directory: string;
+/** Absolute destination, resolved through existing parent symlinks. */
+destination_directory: string;
+/** Regular files included in the observed snapshot. */
+files: number;
+/** Sum of observed regular-file logical sizes; a lower bound when incomplete. */
+bytes: number;
+/** Included directories, excluding the source root. */
+directories: number;
+/** Included symlinks; targets are never traversed. */
+symlinks: number;
+/** Included special filesystem entries, whose copy support is platform dependent. */
+other_entries: number;
+/** Entries inspected, including exclusions. */
+scanned_entries: number;
+/** Entries excluded by the nested-destination policy. */
+excluded_entries: number;
+/** Included entries under conventional dependency, VCS, build, or coverage directories. */
+development_entries: number;
+/** True only when enumeration finished within both limits. */
+complete: boolean;
+/** Why enumeration ended; incomplete counts are never presented as totals. */
+stop_reason: "complete" | "entry_limit" | "depth_limit";
+/** Effective maximum directory entries inspected. */
+max_entries: number;
+/** Effective maximum directory nesting inspected. */
+max_depth: number;
 }
 /** Source identity, copy cost, and a script-free packed alternative for one resolved install. */
 export interface ExtensionInstallPlan {
-    /** Distinguishes an explicit directory snapshot from an unpacked archive or remote source. */
-    source_mode: "directory" | "archive" | "npm" | "github";
-    /** Original archive size before unpacking, when supplied as a local file. */
-    archive_bytes?: number;
-    /** Bounded enumeration of the exact selected extension directory. */
-    copy: ExtensionCopyPlan;
-    /** Suggested argument-vector workflow; substitute the pack result filename before installation. */
-    packed_alternative?: {
-        cwd: string;
-        pack: {
-            command: "npm";
-            args: string[];
-        };
-        install: {
-            command: "pm";
-            args: string[];
-        };
-        archive_argument: "pack_result[0].filename";
-    };
+/** Distinguishes an explicit directory snapshot from an unpacked archive or remote source. */
+source_mode: "directory" | "archive" | "npm" | "github";
+/** Original archive size before unpacking, when supplied as a local file. */
+archive_bytes?: number;
+/** Bounded enumeration of the exact selected extension directory. */
+copy: ExtensionCopyPlan;
+/** Suggested argument-vector workflow; substitute the pack result filename before installation. */
+packed_alternative?: {
+cwd: string;
+pack: {
+command: "npm";
+args: string[];
+};
+install: {
+command: "pm";
+args: string[];
+};
+archive_argument: "pack_result[0].filename";
+};
 }
 /** Estimate a resolved install before destination writes. Source resolution may have prepared a temporary archive or remote tree. */
 export declare function buildExtensionInstallPlan(resolved: ResolvedInstallSource, destination: string, scope: "project" | "global", options?: ExtensionCopyPlanOptions): Promise<ExtensionInstallPlan>;