@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/sdk/cli-contracts/grammar-contracts.d.ts

@@ -8,144 +8,144 @@
  */
 import { type PmCommandAliasContract } from "./command-aliases.js";
 /** Canonical top-level domains an agent must retain to route pm operations. */
-export declare const PM_CLI_GRAMMAR_NOUNS: readonly ["item", "list", "context", "search", "graph", "history", "workspace", "package", "ops", "plan", "contracts", "help"];
+export declare const PM_CLI_GRAMMAR_NOUNS:readonly ["item","list","context","search","graph","history","workspace","package","ops","plan","contracts","help"];
 /** Shared verbs whose meaning transfers across domain nouns. */
-export declare const PM_CLI_SHARED_VERBS: readonly ["acknowledge", "activate", "add", "adopt", "adopt-all", "catalog", "compact", "complete", "create", "deactivate", "delete", "describe", "doctor", "edit", "explore", "import", "init", "inspect", "install", "list", "manage", "migrate", "mutate", "read", "redact", "reload", "remove", "reopen", "repair", "restore", "run", "show", "uninstall", "upgrade", "verify"];
+export declare const PM_CLI_SHARED_VERBS:readonly ["acknowledge","activate","add","adopt","adopt-all","catalog","compact","complete","create","deactivate","delete","describe","doctor","edit","explore","import","init","inspect","install","list","manage","migrate","mutate","read","redact","reload","remove","reopen","repair","restore","run","show","uninstall","upgrade","verify"];
 /** Why a current command is permitted while the grammar migration proceeds. */
 export type PmCommandDestinationDisposition = "target_noun" | "consolidation" | "package_owned" | "keep_as_is";
 /** Exact destination decision for one command emitted by runtime contracts. */
 export interface PmCommandDestinationContract {
 /** Current executable command path. */
-command: string;
+command:string;
 /** Canonical noun that owns the capability. */
-noun: (typeof PM_CLI_GRAMMAR_NOUNS)[number];
+noun:(typeof PM_CLI_GRAMMAR_NOUNS)[number];
 /** Canonical noun-first invocation or family destination. */
-target: string;
+target:string;
 /** Why the current spelling remains in the executable surface. */
-disposition: PmCommandDestinationDisposition;
+disposition:PmCommandDestinationDisposition;
 /** PM item or package identifier owning the disposition. */
-owner: string;
+owner:string;
 /** Reason required only for a deliberate keep-as-is exception. */
-reason?: string;
+reason?:string;
 }
 /** Semantic value class for one positional slot, independent of its display label. */
 export type PmCommandPositionalValueKind = "action" | "integer" | "item_id" | "string";
 /** One ordered positional slot accepted by a command path. */
 export interface PmCommandPositionalSlotContract {
 /** Stable agent-facing slot name. */
-name: string;
+name:string;
 /** Whether Commander and the SDK action both require the slot. */
-required: boolean;
+required:boolean;
 /** Whether the final slot consumes every remaining positional token. */
-variadic: boolean;
+variadic:boolean;
 /** Semantic value class used to compare shapes across commands. */
-value_kind: PmCommandPositionalValueKind;
+value_kind:PmCommandPositionalValueKind;
 /** Whether the slot accepts more than one concept for compatibility. */
-polymorphic: boolean;
+polymorphic:boolean;
 }
 /** Complete positional signature for one executable or virtual action path. */
 export interface PmCommandPositionalContract {
 /** Normalized command path. */
-command: string;
+command:string;
 /** Ordered positional slots after the command path. */
-slots: readonly PmCommandPositionalSlotContract[];
+slots:readonly PmCommandPositionalSlotContract[];
 }
 /** Discoverable positional action projected through help, contracts, and completion. */
 export interface PmPositionalActionContract extends PmCommandPositionalContract {
 /** Commander command that dispatches the action positionally. */
-parent: "assurance" | "plan" | "workspace" | "workspace snapshot";
+parent:"assurance" | "plan" | "workspace" | "workspace snapshot";
 /** Literal action token accepted in the parent's first positional slot. */
-action: string;
+action:string;
 /** Canonical flags applicable to this action-specific view. */
-accepted_flags: readonly string[];
+accepted_flags:readonly string[];
 /** Concise action-specific intent. */
-description: string;
+description:string;
 /** Executable example suitable for recovery and help output. */
-example: string;
+example:string;
 }
 /** Virtual action paths dispatched by positional parent commands. */
-export declare const PM_POSITIONAL_ACTION_CONTRACTS: readonly PmPositionalActionContract[];
+export declare const PM_POSITIONAL_ACTION_CONTRACTS:readonly PmPositionalActionContract[];
 /** Resolve one declared signature without treating arbitrary object keys as commands. */
-export declare function resolvePmCommandPositionalContract(command: string): PmCommandPositionalContract | undefined;
+export declare function resolvePmCommandPositionalContract(command:string):PmCommandPositionalContract | undefined;
 /** Resolve one action-specific help/contract view. */
-export declare function resolvePmPositionalActionContract(command: string): PmPositionalActionContract | undefined;
+export declare function resolvePmPositionalActionContract(command:string):PmPositionalActionContract | undefined;
 /** Format the shared action-flag tip rendered by text and structured help. */
-export declare function formatPmPositionalActionFlagTip(acceptedFlags: readonly string[]): string;
+export declare function formatPmPositionalActionFlagTip(acceptedFlags:readonly string[]):string;
 /** Checked-in exhaustive destination census for core and known package commands. */
-export declare const PM_COMMAND_DESTINATION_CONTRACTS: readonly PmCommandDestinationContract[];
+export declare const PM_COMMAND_DESTINATION_CONTRACTS:readonly PmCommandDestinationContract[];
 /** Exhaustive current command and positional-action signature table. */
-export declare const PM_COMMAND_POSITIONAL_CONTRACTS: readonly PmCommandPositionalContract[];
+export declare const PM_COMMAND_POSITIONAL_CONTRACTS:readonly PmCommandPositionalContract[];
 /** Immutable grammar policy used by contracts and the CI gate. */
-export declare const PM_CLI_GRAMMAR_CONTRACT: {
-readonly nouns: readonly ["item", "list", "context", "search", "graph", "history", "workspace", "package", "ops", "plan", "contracts", "help"];
-readonly shared_verbs: readonly ["acknowledge", "activate", "add", "adopt", "adopt-all", "catalog", "compact", "complete", "create", "deactivate", "delete", "describe", "doctor", "edit", "explore", "import", "init", "inspect", "install", "list", "manage", "migrate", "mutate", "read", "redact", "reload", "remove", "reopen", "repair", "restore", "run", "show", "uninstall", "upgrade", "verify"];
-readonly scope_before_verb: true;
-readonly visible_top_level_ceiling: 69;
-readonly ceiling_raise_requires_pm_item: true;
-readonly positional_shape_budget: 21;
+export declare const PM_CLI_GRAMMAR_CONTRACT:{
+readonly nouns:readonly ["item","list","context","search","graph","history","workspace","package","ops","plan","contracts","help"];
+readonly shared_verbs:readonly ["acknowledge","activate","add","adopt","adopt-all","catalog","compact","complete","create","deactivate","delete","describe","doctor","edit","explore","import","init","inspect","install","list","manage","migrate","mutate","read","redact","reload","remove","reopen","repair","restore","run","show","uninstall","upgrade","verify"];
+readonly scope_before_verb:true;
+readonly visible_top_level_ceiling:69;
+readonly ceiling_raise_requires_pm_item:true;
+readonly positional_shape_budget:21;
 };
 /** One positional-signature drift finding. */
 export interface PmCommandPositionalFinding {
 /** Stable remediation category. */
-code: "missing_observed_signature" | "positional_shape_budget_exceeded" | "positional_signature_mismatch" | "stale_observed_signature";
+code:"missing_observed_signature" | "positional_shape_budget_exceeded" | "positional_signature_mismatch" | "stale_observed_signature";
 /** Command path whose positional contract drifted. */
-command: string;
+command:string;
 /** Actionable mismatch detail. */
-detail: string;
+detail:string;
 }
 /** Complete positional grammar conformance receipt. */
 export interface PmCommandPositionalReport {
 /** Whether the observed signatures exactly match the declaration. */
-ok: boolean;
+ok:boolean;
 /** Declared command/action paths. */
-declared_command_count: number;
+declared_command_count:number;
 /** Independently observed command/action paths. */
-observed_command_count: number;
+observed_command_count:number;
 /** Number of distinct semantic positional shapes. */
-positional_shape_count: number;
+positional_shape_count:number;
 /** Maximum distinct shapes allowed without a tracked grammar decision. */
-positional_shape_budget: number;
+positional_shape_budget:number;
 /** Stable positional conformance failures. */
-findings: PmCommandPositionalFinding[];
+findings:PmCommandPositionalFinding[];
 }
 /** Report explicit positional entries that no destination command declares. */
-export declare function verifyExplicitPositionalSlotCensus(explicitCommands: Iterable<string>, destinationCommands: Iterable<string>): PmCommandPositionalFinding[];
+export declare function verifyExplicitPositionalSlotCensus(explicitCommands:Iterable<string>,destinationCommands:Iterable<string>):PmCommandPositionalFinding[];
 /** Return the semantic shape identity used by the positional-shape budget. */
-export declare function positionalShapeKey(slots: readonly PmCommandPositionalSlotContract[]): string;
+export declare function positionalShapeKey(slots:readonly PmCommandPositionalSlotContract[]):string;
 /** Return the exact canonical identity of an ordered positional signature. */
-export declare function positionalSignatureKey(slots: readonly PmCommandPositionalSlotContract[]): string;
+export declare function positionalSignatureKey(slots:readonly PmCommandPositionalSlotContract[]):string;
 /** Compare independently observed Commander signatures with the SDK declaration. */
-export declare function verifyPmCommandPositionalContracts(observed: readonly PmCommandPositionalContract[], options?: {
-declared?: readonly PmCommandPositionalContract[];
-positionalShapeBudget?: number;
-}): PmCommandPositionalReport;
+export declare function verifyPmCommandPositionalContracts(observed:readonly PmCommandPositionalContract[],options?:{
+declared?:readonly PmCommandPositionalContract[];
+positionalShapeBudget?:number;
+}):PmCommandPositionalReport;
 /** One self-correcting grammar-gate finding. */
 export interface PmCliGrammarFinding {
 /** Stable diagnostic category suitable for automated remediation. */
-code: "alias_target_missing" | "duplicate_destination" | "missing_destination" | "stale_destination" | "unknown_noun" | "visible_surface_ceiling_exceeded";
+code:"alias_target_missing" | "duplicate_destination" | "missing_destination" | "stale_destination" | "unknown_noun" | "visible_surface_ceiling_exceeded";
 /** Exact command or alias spelling that violated the contract. */
-spelling: string;
+spelling:string;
 /** Human-readable explanation of the violated invariant. */
-message: string;
+message:string;
 /** Closest canonical invocation or corrective policy action. */
-nearest_target: string;
+nearest_target:string;
 }
 /** Deterministic conformance report for the live command and alias surfaces. */
 export interface PmCliGrammarReport {
 /** Whether every checked grammar invariant passed. */
-ok: boolean;
+ok:boolean;
 /** Number of normalized live command paths evaluated. */
-command_count: number;
+command_count:number;
 /** Number of checked-in destination-census rows. */
-destination_count: number;
+destination_count:number;
 /** Number of declared aliases omitted from default discovery. */
-hidden_alias_count: number;
+hidden_alias_count:number;
 /** Number of distinct visible non-package single-token command paths. */
-visible_top_level_count: number;
+visible_top_level_count:number;
 /** Maximum visible single-token command paths permitted by the ADR. */
-visible_top_level_ceiling: number;
+visible_top_level_ceiling:number;
 /** Self-correcting conformance diagnostics, empty when `ok` is true. */
-findings: PmCliGrammarFinding[];
+findings:PmCliGrammarFinding[];
 }
 /** Verify exhaustive census parity, noun ownership, alias targets, and growth. */
-export declare function verifyPmCliGrammar(commands: readonly string[], aliases?: readonly PmCommandAliasContract[]): PmCliGrammarReport;
+export declare function verifyPmCliGrammar(commands:readonly string[],aliases?:readonly PmCommandAliasContract[]):PmCliGrammarReport;

package/dist/sdk/cli-contracts/registration-helpers.d.ts

@@ -4,106 +4,106 @@
  * Provides CLI runtime support for Registration Helpers.
  */
 import { type Command } from "commander";
-import { printError, printResult, writeStdout, setActiveCommandResult, type GlobalOptions } from "../runtime-primitives.js";
+import { printError,printResult,writeStdout,setActiveCommandResult,type GlobalOptions } from "../runtime-primitives.js";
 import type { ContextOptions } from "../query/context.js";
 import type { CreateCommandOptions } from "../lifecycle/create.js";
 import type { AggregateOptions } from "../query/aggregate.js";
-import type { ListOptions, runList } from "../query/list.js";
+import type { ListOptions,runList } from "../query/list.js";
 import type { NextOptions } from "../query/next.js";
 import type { runActivity } from "../query/activity.js";
-export { buildBackgroundTestCommandArgs, buildBackgroundTestAllCommandArgs, } from "../test/command-args.js";
+export { buildBackgroundTestCommandArgs,buildBackgroundTestAllCommandArgs,} from "../test/command-args.js";
 export { setActiveCommandResult };
-export { printError, printResult, writeStdout };
+export { printError,printResult,writeStdout };
 /** Let an active package asynchronously augment a completed command result. */
-export declare function applyActiveCommandResultService(command: string, args: string[], options: Record<string, unknown>, global: GlobalOptions, result: unknown): Promise<unknown>;
+export declare function applyActiveCommandResultService(command:string,args:string[],options:Record<string,unknown>,global:GlobalOptions,result:unknown):Promise<unknown>;
 /** Synchronize parser-derived options with Commander and its action arguments. */
-export declare function syncCommanderActionOptions(actionCommand: Command, commandOptions: Record<string, unknown>): void;
+export declare function syncCommanderActionOptions(actionCommand:Command,commandOptions:Record<string,unknown>):void;
 /** Implements set resolved global options for the public runtime surface of this module. */
-export declare function setResolvedGlobalOptions(command: Command, globalOptions: GlobalOptions): void;
+export declare function setResolvedGlobalOptions(command:Command,globalOptions:GlobalOptions):void;
 /** Implements clear resolved global options for the public runtime surface of this module. */
-export declare function clearResolvedGlobalOptions(command: Command): void;
+export declare function clearResolvedGlobalOptions(command:Command):void;
 /** Implements get global options for the public runtime surface of this module. */
-export declare function getGlobalOptions(command: Command): GlobalOptions;
+export declare function getGlobalOptions(command:Command):GlobalOptions;
 /** Implements get command path for the public runtime surface of this module. */
-export declare function getCommandPath(command: Command): string;
+export declare function getCommandPath(command:Command):string;
 /** Implements apply default output format for the public runtime surface of this module. */
-export declare function applyDefaultOutputFormat(globalOptions: GlobalOptions): Promise<GlobalOptions>;
+export declare function applyDefaultOutputFormat(globalOptions:GlobalOptions):Promise<GlobalOptions>;
 /** Implements collect for the public runtime surface of this module. */
-export declare function collect(value: string, previous: string[] | undefined): string[];
+export declare function collect(value:string,previous:string[] | undefined):string[];
 /** Reads an option value when Commander supplied it as a string. */
-export declare function readOptionString(options: Record<string, unknown>, key: string): string | undefined;
+export declare function readOptionString(options:Record<string,unknown>,key:string):string | undefined;
 /** Adds a Commander option that remains parseable but hidden from human help. */
-export declare function addHiddenOption(command: Command, flags: string, description: string, repeatable?: boolean, repeatableParser?: ((value: string) => string[]) | undefined): void;
+export declare function addHiddenOption(command:Command,flags:string,description:string,repeatable?:boolean,repeatableParser?:((value:string) => string[]) | undefined):void;
 /** Adds a group of parseable Commander aliases hidden from human help. */
-export declare function addHiddenOptions(command: Command, aliases: ReadonlyArray<readonly [flags: string, description: string]>, repeatable: boolean): void;
+export declare function addHiddenOptions(command:Command,aliases:ReadonlyArray<readonly [flags:string,description:string]>,repeatable:boolean):void;
 /** Implements format hook warnings for the public runtime surface of this module. */
-export declare function formatHookWarnings(warnings: string[]): string;
+export declare function formatHookWarnings(warnings:string[]):string;
 /** Implements normalize create options for the public runtime surface of this module. */
-export declare function normalizeCreateOptions(commandOptions: Record<string, unknown>, options?: {
-requireType?: boolean;
-}): CreateCommandOptions;
+export declare function normalizeCreateOptions(commandOptions:Record<string,unknown>,options?:{
+requireType?:boolean;
+}):CreateCommandOptions;
 /** Implements normalize update options for the public runtime surface of this module. */
-export declare function normalizeUpdateOptions(commandOptions: Record<string, unknown>): Record<string, unknown>;
+export declare function normalizeUpdateOptions(commandOptions:Record<string,unknown>):Record<string,unknown>;
 /** Implements extract update many mutation option source for the public runtime surface of this module. */
-export declare function extractUpdateManyMutationOptionSource(commandOptions: Record<string, unknown>): Record<string, unknown>;
+export declare function extractUpdateManyMutationOptionSource(commandOptions:Record<string,unknown>):Record<string,unknown>;
 /** Implements normalize list options for the public runtime surface of this module. */
-export declare function normalizeListOptions(options: Record<string, unknown>): ListOptions;
+export declare function normalizeListOptions(options:Record<string,unknown>):ListOptions;
 /** Implements normalize aggregate options for the public runtime surface of this module. */
-export declare function normalizeAggregateOptions(options: Record<string, unknown>): AggregateOptions;
+export declare function normalizeAggregateOptions(options:Record<string,unknown>):AggregateOptions;
 type ListCommandResult = Awaited<ReturnType<typeof runList>>;
 /** Implements print list json stream for the public runtime surface of this module. */
-export declare function printListJsonStream(commandName: string, result: ListCommandResult, globalOptions: GlobalOptions): void;
+export declare function printListJsonStream(commandName:string,result:ListCommandResult,globalOptions:GlobalOptions):void;
 type ActivityCommandResult = Awaited<ReturnType<typeof runActivity>>;
 /** Implements print activity json stream for the public runtime surface of this module. */
-export declare function printActivityJsonStream(result: ActivityCommandResult, options: {
-id?: string;
-op?: string;
-author?: string;
-from?: string;
-to?: string;
-limit?: string;
-}, globalOptions: GlobalOptions): void;
+export declare function printActivityJsonStream(result:ActivityCommandResult,options:{
+id?:string;
+op?:string;
+author?:string;
+from?:string;
+to?:string;
+limit?:string;
+},globalOptions:GlobalOptions):void;
 /** Implements normalize search options for the public runtime surface of this module. */
-export declare function normalizeSearchOptions(options: Record<string, unknown>): Record<string, unknown>;
+export declare function normalizeSearchOptions(options:Record<string,unknown>):Record<string,unknown>;
 /** Implements normalize search keywords input for the public runtime surface of this module. */
-export declare function normalizeSearchKeywordsInput(keywords: string[]): string;
+export declare function normalizeSearchKeywordsInput(keywords:string[]):string;
 /** Canonical Commander-normalized activity query options. */
 export interface NormalizedActivityOptions {
 /** Exact item identifier filter. */
-id?: string;
+id?:string;
 /** Exact immutable history operation filter. */
-op?: string;
+op?:string;
 /** Exact recorded author filter. */
-author?: string;
+author?:string;
 /** Inclusive activity window lower bound. */
-from?: string;
+from?:string;
 /** Inclusive activity window upper bound. */
-to?: string;
+to?:string;
 /** Maximum projected row count encoded as Commander text. */
-limit?: string;
+limit?:string;
 /** Select the compact raw-event projection. */
-compact?: boolean;
+compact?:boolean;
 /** Select a raw event projection instead of the item digest. */
-raw?: boolean;
+raw?:boolean;
 /** Disable the default projection row bound. */
-unbounded?: boolean;
+unbounded?:boolean;
 /** Select privacy-safe provenance event rows. */
-provenance?: boolean;
+provenance?:boolean;
 /** Include constant-size provenance completeness metrics. */
-provenanceSummary?: boolean;
+provenanceSummary?:boolean;
 /** Canonical harness filters supplied by Commander. */
-harness?: string[];
+harness?:string[];
 /** Privacy-safe agent invocation fingerprint filters. */
-agentInstance?: string[];
+agentInstance?:string[];
 /** Exact provenance dimension predicates. */
-provenanceFilter?: string[];
+provenanceFilter?:string[];
 }
 /** Implements normalize activity options for the public runtime surface of this module. */
-export declare function normalizeActivityOptions(options: Record<string, unknown>): NormalizedActivityOptions;
+export declare function normalizeActivityOptions(options:Record<string,unknown>):NormalizedActivityOptions;
 /** Implements resolve activity stream mode for the public runtime surface of this module. */
-export declare function resolveActivityStreamMode(raw: unknown): boolean;
+export declare function resolveActivityStreamMode(raw:unknown):boolean;
 /** Implements normalize context options for the public runtime surface of this module. */
-export declare function normalizeContextOptions(options: Record<string, unknown>): ContextOptions;
+export declare function normalizeContextOptions(options:Record<string,unknown>):ContextOptions;
 /**
  * Normalizes raw commander options for `pm next` into a typed {@link NextOptions}
  * payload, resolving snake_case flag aliases (e.g. `--assignee_filter`,
@@ -111,11 +111,11 @@ export declare function normalizeContextOptions(options: Record<string, unknown>
  * the boolean `--ready-only` switch. Unknown keys are passed through untouched so
  * downstream filtering still sees them.
  */
-export declare function normalizeNextOptions(options: Record<string, unknown>): NextOptions;
-declare function collectMutationItemIds(result: unknown): string[];
+export declare function normalizeNextOptions(options:Record<string,unknown>):NextOptions;
+declare function collectMutationItemIds(result:unknown):string[];
 /** Implements invalidate search caches for mutation for the public runtime surface of this module. */
-export declare function invalidateSearchCachesForMutation(globalOptions: GlobalOptions, result?: unknown): Promise<void>;
+export declare function invalidateSearchCachesForMutation(globalOptions:GlobalOptions,result?:unknown):Promise<void>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-collectMutationItemIds: typeof collectMutationItemIds;
+export declare const _testOnly:{
+collectMutationItemIds:typeof collectMutationItemIds;
 };