@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/sdk/telemetry.d.ts

@@ -1,75 +1,75 @@
 import type { GlobalOptions } from "../core/shared/command-types.js";
 import { resolveTelemetryEnvironmentPolicy } from "../core/telemetry/policy.js";
 /** Public contract for telemetry subcommands, shared by SDK and presentation-layer consumers. */
-export declare const TELEMETRY_SUBCOMMANDS: readonly ["status", "flush", "stats", "clear"];
+export declare const TELEMETRY_SUBCOMMANDS:readonly ["status","flush","stats","clear"];
 /** Restricts telemetry subcommand values accepted by command, SDK, and storage contracts. */
 export type TelemetrySubcommand = (typeof TELEMETRY_SUBCOMMANDS)[number];
 /** Local telemetry configuration, queue, and most recent flush state. */
 export interface TelemetryStatusSummary {
 /** Whether telemetry delivery is enabled. */
-enabled: boolean;
+enabled:boolean;
 /** Persisted preference before process consent overrides. */
-configured_enabled: boolean;
+configured_enabled:boolean;
 /** Process opt-outs, resolved without changing persisted preferences. */
-env_overrides: ReturnType<typeof resolveTelemetryEnvironmentPolicy>;
+env_overrides:ReturnType<typeof resolveTelemetryEnvironmentPolicy>;
 /** Configured delivery endpoint. */
-endpoint: string;
+endpoint:string;
 /** Local event queue path. */
-queue_path: string;
+queue_path:string;
 /** Local telemetry state path. */
-state_path: string;
+state_path:string;
 /** Total queue rows, including invalid rows. */
-queue_rows_total: number;
+queue_rows_total:number;
 /** Valid queue entries eligible for delivery. */
-queue_entries: number;
+queue_entries:number;
 /** Invalid queue rows retained for diagnostics. */
-queue_invalid_rows: number;
+queue_invalid_rows:number;
 /** Queue file size in bytes. */
-queue_size_bytes: number;
+queue_size_bytes:number;
 /** Most recent attempted flush time. */
-last_attempted_flush_at: string | null;
+last_attempted_flush_at:string | null;
 /** Most recent successful flush time. */
-last_successful_flush_at: string | null;
+last_successful_flush_at:string | null;
 /** Most recent failed flush time. */
-last_failed_flush_at: string | null;
+last_failed_flush_at:string | null;
 /** Most recent failed flush message. */
-last_failed_flush_error: string | null;
+last_failed_flush_error:string | null;
 }
 /** Precise receipt returned by a telemetry flush operation. */
 export interface TelemetryFlushResult {
 /** Stable action discriminator. */
-action: "telemetry";
+action:"telemetry";
 /** Stable flush discriminator. */
-subcommand: "flush";
+subcommand:"flush";
 /** Valid queue entries observed before the flush attempt. */
-queue_entries_before: number;
+queue_entries_before:number;
 /** Valid queue entries that remain after the flush attempt. */
-queue_entries_after: number;
+queue_entries_after:number;
 /** Number of valid queue entries removed by this flush attempt. */
-queue_entries_drained: number;
+queue_entries_drained:number;
 /** Whether at least one valid queue entry was removed. */
-queue_progressed: boolean;
+queue_progressed:boolean;
 /** Whether no valid queue entries remain. */
-queue_empty: boolean;
+queue_empty:boolean;
 /** Compatibility completion field; equivalent to `queue_empty`. */
-queue_drained: boolean;
+queue_drained:boolean;
 /** Complete post-flush telemetry status. */
-status: TelemetryStatusSummary;
+status:TelemetryStatusSummary;
 /** ISO timestamp at which the receipt was assembled. */
-generated_at: string;
+generated_at:string;
 }
 /** Documents the telemetry command options payload exchanged by command, SDK, and package integrations. */
 export interface TelemetryCommandOptions {
 /** Value that configures or reports subcommand for this contract. */
-subcommand?: string;
+subcommand?:string;
 /** Value that configures or reports limit for this contract. */
-limit?: string | number;
+limit?:string | number;
 }
 /** Count one resolved deprecated command alias in consented, local-only telemetry state. */
-export declare function recordDeprecatedAliasUsage(alias: string): Promise<boolean>;
+export declare function recordDeprecatedAliasUsage(alias:string):Promise<boolean>;
 /** Run telemetry flush with a precise completion receipt. */
-export declare function runTelemetry(options: TelemetryCommandOptions & {
-subcommand: "flush";
-}, global: GlobalOptions): Promise<TelemetryFlushResult>;
+export declare function runTelemetry(options:TelemetryCommandOptions & {
+subcommand:"flush";
+},global:GlobalOptions):Promise<TelemetryFlushResult>;
 /** Run any telemetry subcommand through the public runtime surface. */
-export declare function runTelemetry(options: TelemetryCommandOptions, global: GlobalOptions): Promise<Record<string, unknown>>;
+export declare function runTelemetry(options:TelemetryCommandOptions,global:GlobalOptions):Promise<Record<string,unknown>>;

package/dist/sdk/templates.d.ts

@@ -1,73 +1,73 @@
 import type { GlobalOptions } from "../core/shared/command-types.js";
 type TemplateOptionValue = string | string[];
 /** Restricts create template options values accepted by command, SDK, and storage contracts. */
-export type CreateTemplateOptions = Record<string, TemplateOptionValue>;
+export type CreateTemplateOptions = Record<string,TemplateOptionValue>;
 /** Restricts template source values accepted by command, SDK, and storage contracts. */
 export type TemplateSource = "builtin" | "user";
 interface StoredCreateTemplateDocument {
-name: string;
-created_at: string;
-updated_at: string;
-options: CreateTemplateOptions;
+name:string;
+created_at:string;
+updated_at:string;
+options:CreateTemplateOptions;
 }
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-normalizeTemplateName: typeof normalizeTemplateName;
-extractTemplateOptions: typeof extractTemplateOptions;
-parseStoredTemplateDocument: typeof parseStoredTemplateDocument;
-builtinTemplateDocument: typeof builtinTemplateDocument;
-readStoredTemplateDocument: typeof readStoredTemplateDocument;
+export declare const _testOnly:{
+normalizeTemplateName:typeof normalizeTemplateName;
+extractTemplateOptions:typeof extractTemplateOptions;
+parseStoredTemplateDocument:typeof parseStoredTemplateDocument;
+builtinTemplateDocument:typeof builtinTemplateDocument;
+readStoredTemplateDocument:typeof readStoredTemplateDocument;
 };
 /** Documents the templates save result payload exchanged by command, SDK, and package integrations. */
 export interface TemplatesSaveResult {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** ISO 8601 timestamp recording when created occurred. */
-created_at: string;
+created_at:string;
 /** ISO 8601 timestamp recording when updated occurred. */
-updated_at: string;
+updated_at:string;
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports options for this contract. */
-options: CreateTemplateOptions;
+options:CreateTemplateOptions;
 }
 /** Documents the templates list result payload exchanged by command, SDK, and package integrations. */
 export interface TemplatesListResult {
 /** Value that configures or reports templates for this contract. */
-templates: string[];
+templates:string[];
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Value that configures or reports builtin templates for this contract. */
-builtin_templates: string[];
+builtin_templates:string[];
 /** Value that configures or reports user templates for this contract. */
-user_templates: string[];
+user_templates:string[];
 }
 /** Documents the templates show result payload exchanged by command, SDK, and package integrations. */
 export interface TemplatesShowResult {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports source for this contract. */
-source: TemplateSource;
+source:TemplateSource;
 /** ISO 8601 timestamp recording when created occurred. */
-created_at: string;
+created_at:string;
 /** ISO 8601 timestamp recording when updated occurred. */
-updated_at: string;
+updated_at:string;
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports options for this contract. */
-options: CreateTemplateOptions;
+options:CreateTemplateOptions;
 }
-declare function normalizeTemplateName(rawName: string): string;
-declare function extractTemplateOptions(rawOptions: Record<string, unknown>): CreateTemplateOptions;
-declare function parseStoredTemplateDocument(raw: string, normalizedName: string): StoredCreateTemplateDocument;
-declare function builtinTemplateDocument(normalizedName: string): StoredCreateTemplateDocument | null;
-declare function readStoredTemplateDocument(pmRoot: string, normalizedName: string): Promise<StoredCreateTemplateDocument>;
+declare function normalizeTemplateName(rawName:string):string;
+declare function extractTemplateOptions(rawOptions:Record<string,unknown>):CreateTemplateOptions;
+declare function parseStoredTemplateDocument(raw:string,normalizedName:string):StoredCreateTemplateDocument;
+declare function builtinTemplateDocument(normalizedName:string):StoredCreateTemplateDocument | null;
+declare function readStoredTemplateDocument(pmRoot:string,normalizedName:string):Promise<StoredCreateTemplateDocument>;
 /** Implements load create template options for the public runtime surface of this module. */
-export declare function loadCreateTemplateOptions(pmRoot: string, rawTemplateName: string): Promise<CreateTemplateOptions>;
+export declare function loadCreateTemplateOptions(pmRoot:string,rawTemplateName:string):Promise<CreateTemplateOptions>;
 /** Implements run templates save for the public runtime surface of this module. */
-export declare function runTemplatesSave(rawTemplateName: string, options: Record<string, unknown>, global: GlobalOptions): Promise<TemplatesSaveResult>;
+export declare function runTemplatesSave(rawTemplateName:string,options:Record<string,unknown>,global:GlobalOptions):Promise<TemplatesSaveResult>;
 /** Implements run templates list for the public runtime surface of this module. */
-export declare function runTemplatesList(global: GlobalOptions): Promise<TemplatesListResult>;
+export declare function runTemplatesList(global:GlobalOptions):Promise<TemplatesListResult>;
 /** Implements run templates show for the public runtime surface of this module. */
-export declare function runTemplatesShow(rawTemplateName: string, global: GlobalOptions): Promise<TemplatesShowResult>;
+export declare function runTemplatesShow(rawTemplateName:string,global:GlobalOptions):Promise<TemplatesShowResult>;
 export {};

package/dist/sdk/test/batch.d.ts

@@ -1,102 +1,102 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
-import type { ItemStatus, LinkedTest } from "../../types/index.js";
-import { type LinkedTestFailureCategory, type TestRunResult } from "./execution.js";
+import type { ItemStatus,LinkedTest } from "../../types/index.js";
+import { type LinkedTestFailureCategory,type TestRunResult } from "./execution.js";
 /** Documents the test all command options payload exchanged by command, SDK, and package integrations. */
 export interface TestAllCommandOptions {
 /** Explicit author recorded on item test-run tracking events. */
-author?: string;
+author?:string;
 /** Lifecycle state reported for status. */
-status?: string;
+status?:string;
 /** Value that configures or reports limit for this contract. */
-limit?: string;
+limit?:string;
 /** Value that configures or reports offset for this contract. */
-offset?: string;
+offset?:string;
 /** Value that configures or reports timeout for this contract. */
-timeout?: string;
+timeout?:string;
 /** Value that configures or reports progress for this contract. */
-progress?: boolean;
+progress?:boolean;
 /** Value that configures or reports env set for this contract. */
-envSet?: string[];
+envSet?:string[];
 /** Value that configures or reports env clear for this contract. */
-envClear?: string[];
+envClear?:string[];
 /** Value that configures or reports shared host safe for this contract. */
-sharedHostSafe?: boolean;
+sharedHostSafe?:boolean;
 /** Value that configures or reports pm context for this contract. */
-pmContext?: string;
+pmContext?:string;
 /** Value that configures or reports override linked pm context for this contract. */
-overrideLinkedPmContext?: boolean;
+overrideLinkedPmContext?:boolean;
 /** Source-workspace visibility and working-directory mode. */
-workspaceContext?: string;
+workspaceContext?:string;
 /** Force run-level source-workspace mode over linked metadata. */
-overrideLinkedWorkspaceContext?: boolean;
+overrideLinkedWorkspaceContext?:boolean;
 /** Explicitly permit untrusted commands when project policy also permits them. */
-allowUntrustedLinkedTests?: boolean;
+allowUntrustedLinkedTests?:boolean;
 /** Value that configures or reports fail on context mismatch for this contract. */
-failOnContextMismatch?: boolean;
+failOnContextMismatch?:boolean;
 /** Value that configures or reports fail on skipped for this contract. */
-failOnSkipped?: boolean;
+failOnSkipped?:boolean;
 /** Value that configures or reports fail on empty test run for this contract. */
-failOnEmptyTestRun?: boolean;
+failOnEmptyTestRun?:boolean;
 /** Value that configures or reports require assertions for pm for this contract. */
-requireAssertionsForPm?: boolean;
+requireAssertionsForPm?:boolean;
 /** Value that configures or reports check context for this contract. */
-checkContext?: boolean;
+checkContext?:boolean;
 /** Value that configures or reports auto pm context for this contract. */
-autoPmContext?: boolean;
+autoPmContext?:boolean;
 }
 /** Documents the test all item result payload exchanged by command, SDK, and package integrations. */
 export interface TestAllItemResult {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Lifecycle state reported for status. */
-status: ItemStatus;
+status:ItemStatus;
 /** Number of test entries represented by this result. */
-test_count: number;
+test_count:number;
 /** Value that configures or reports passed for this contract. */
-passed: number;
+passed:number;
 /** Value that configures or reports failed for this contract. */
-failed: number;
+failed:number;
 /** Value that configures or reports skipped for this contract. */
-skipped: number;
+skipped:number;
 /** Executes the results operation through the package runtime. */
-run_results: TestRunResult[];
+run_results:TestRunResult[];
 /** Value that configures or reports failure categories for this contract. */
-failure_categories: Record<LinkedTestFailureCategory, number>;
+failure_categories:Record<LinkedTestFailureCategory,number>;
 }
 /** Documents the test all result payload exchanged by command, SDK, and package integrations. */
 export interface TestAllResult {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Value that configures or reports totals for this contract. */
-totals: {
-items: number;
-linked_tests: number;
-passed: number;
-failed: number;
-skipped: number;
-failure_categories: Record<LinkedTestFailureCategory, number>;
+totals:{
+items:number;
+linked_tests:number;
+passed:number;
+failed:number;
+skipped:number;
+failure_categories:Record<LinkedTestFailureCategory,number>;
 };
 /** Value that configures or reports failed for this contract. */
-failed: number;
+failed:number;
 /** Value that configures or reports passed for this contract. */
-passed: number;
+passed:number;
 /** Value that configures or reports skipped for this contract. */
-skipped: number;
+skipped:number;
 /** Value that configures or reports fail on skipped triggered for this contract. */
-fail_on_skipped_triggered?: boolean;
+fail_on_skipped_triggered?:boolean;
 /** Value that configures or reports fail on empty test run triggered for this contract. */
-fail_on_empty_test_run_triggered?: boolean;
+fail_on_empty_test_run_triggered?:boolean;
 /** Value that configures or reports warnings for this contract. */
-warnings?: string[];
+warnings?:string[];
 /** Value that configures or reports results for this contract. */
-results: TestAllItemResult[];
+results:TestAllItemResult[];
 }
 /** Implements run test all for the public runtime surface of this module. */
-export declare const runTestAll: (options: TestAllCommandOptions, global: GlobalOptions) => Promise<TestAllResult>;
+export declare const runTestAll:(options:TestAllCommandOptions,global:GlobalOptions) => Promise<TestAllResult>;
 /** Public contract for test only test all, shared by SDK and presentation-layer consumers. */
-export declare const _testOnlyTestAll: {
-buildLinkedTestKey: (test: LinkedTest) => string;
-formatTrackingError: (error: unknown) => string;
+export declare const _testOnlyTestAll:{
+buildLinkedTestKey:(test:LinkedTest) => string;
+formatTrackingError:(error:unknown) => string;
 };

package/dist/sdk/test/command-args.d.ts

@@ -1,4 +1,4 @@
 /** Serialize one item test run with its mutations, selectors, context and explicitly supplied trust flags. */
-export declare function buildBackgroundTestCommandArgs(id: string, options: Record<string, unknown>): string[];
+export declare function buildBackgroundTestCommandArgs(id:string,options:Record<string,unknown>):string[];
 /** Serialize a tracker-wide test run with status filters and shared execution policy. */
-export declare function buildBackgroundTestAllCommandArgs(options: Record<string, unknown>): string[];
+export declare function buildBackgroundTestAllCommandArgs(options:Record<string,unknown>):string[];

package/dist/sdk/test/entry.d.ts

@@ -1,9 +1,9 @@
 import type { LinkedTest } from "../../types/index.js";
 /** Refuse an unbound tracker context before a linked-test mutation can persist it. */
-export declare function assertLinkedTestContext(test: LinkedTest): void;
+export declare function assertLinkedTestContext(test:LinkedTest):void;
 /** Public contract for structured linked test keys, shared by SDK and presentation-layer consumers. */
-export declare const STRUCTURED_LINKED_TEST_KEYS: readonly ["command", "cmd", "path", "scope", "timeout", "timeout_seconds", "pm_context_mode", "workspace_context_mode", "env_set", "env_clear", "shared_host_safe", "assert_stdout_contains", "assert_stdout_regex", "assert_stderr_contains", "assert_stderr_regex", "assert_stdout_min_lines", "assert_json_field_equals", "assert_json_field_gte", "note"];
+export declare const STRUCTURED_LINKED_TEST_KEYS:readonly ["command","cmd","path","scope","timeout","timeout_seconds","pm_context_mode","workspace_context_mode","env_set","env_clear","shared_host_safe","assert_stdout_contains","assert_stdout_regex","assert_stderr_contains","assert_stderr_regex","assert_stdout_min_lines","assert_json_field_equals","assert_json_field_gte","note"];
 /** Classify linked-test plaintext through the shared structured-entry grammar. */
-export declare function looksLikeStructuredLinkedTestEntry(raw: string): boolean;
+export declare function looksLikeStructuredLinkedTestEntry(raw:string):boolean;
 /** Implements normalize structured linked test entry for the public runtime surface of this module. */
-export declare function normalizeStructuredLinkedTestEntry(kv: Record<string, string>, optionName: "--add" | "--test"): Record<string, string>;
+export declare function normalizeStructuredLinkedTestEntry(kv:Record<string,string>,optionName:"--add" | "--test"):Record<string,string>;

package/dist/sdk/test/execution-receipts.d.ts

@@ -1,9 +1,9 @@
 /** Detect explicit empty-run summaries even when another output line reports a positive count. */
-export declare function detectEmptyLinkedTestRun(stdout: string, stderr: string): {
-code: string;
+export declare function detectEmptyLinkedTestRun(stdout:string,stderr:string):{
+code:string;
 } | null;
 /** Find the first supported positive execution summary, preferring stdout over stderr. */
-export declare function findLinkedTestExecutionReceipt(stdout: string, stderr: string): {
-code: string;
-stream: "stdout" | "stderr";
+export declare function findLinkedTestExecutionReceipt(stdout:string,stderr:string):{
+code:string;
+stream:"stdout" | "stderr";
 } | undefined;