@unbrained/pm-cli 2026.10.14 → 2026.10.15

package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts

@@ -1,15 +1,15 @@
 /** Inputs for the internal workspace-wide hierarchy mutation lock. */
 export interface HierarchyMutationLockOptions {
 /** Tracker root whose hierarchy is being changed. */
-pmRoot: string;
+pmRoot:string;
 /** Principal recorded as the lock owner. */
-author: string;
+author:string;
 /** Tracker-configured stale-lock lifetime. */
-ttlSeconds: number;
+ttlSeconds:number;
 /** Tracker-configured bounded lock wait. */
-waitMs: number;
+waitMs:number;
 /** Whether this mutation can add hierarchy evidence or a one-edge relationship. */
-required: boolean;
+required:boolean;
 }
 /** Acquire the shared hierarchy writer lock, or return a no-op release. */
-export declare function acquireHierarchyMutationLock(options: HierarchyMutationLockOptions): Promise<() => Promise<void>>;
+export declare function acquireHierarchyMutationLock(options:HierarchyMutationLockOptions):Promise<() => Promise<void>>;

package/dist/sdk/lifecycle/legacy-none-tokens.d.ts

@@ -1,71 +1,71 @@
 /** Describes a repeatable option whose legacy none/null token maps to a clear flag. */
 export interface LegacyNoneCollectionNormalizer<TOptions extends object> {
 /** Value that configures or reports option key for this contract. */
-optionKey: keyof TOptions;
+optionKey:keyof TOptions;
 /** Value that configures or reports clear flag key for this contract. */
-clearFlagKey: keyof TOptions;
+clearFlagKey:keyof TOptions;
 /** Value that configures or reports value flag for this contract. */
-valueFlag: string;
+valueFlag:string;
 /** Value that configures or reports clear flag for this contract. */
-clearFlag: string;
+clearFlag:string;
 /** Value that configures or reports disable flag key for this contract. */
-disableFlagKey?: keyof TOptions;
+disableFlagKey?:keyof TOptions;
 }
 /** Collection and clear options shared by create and update legacy-token normalization. */
 export interface LegacyNoneCollectionOptions {
 /** Dependency entries accepted by create and update. */
-dep?: string[];
+dep?:string[];
 /** Whether dependency entries should be cleared. */
-clearDeps?: boolean;
+clearDeps?:boolean;
 /** Comment entries accepted by create and update. */
-comment?: string[];
+comment?:string[];
 /** Whether comment entries should be cleared. */
-clearComments?: boolean;
+clearComments?:boolean;
 /** Note entries accepted by create and update. */
-note?: string[];
+note?:string[];
 /** Whether note entries should be cleared. */
-clearNotes?: boolean;
+clearNotes?:boolean;
 /** Learning entries accepted by create and update. */
-learning?: string[];
+learning?:string[];
 /** Whether learning entries should be cleared. */
-clearLearnings?: boolean;
+clearLearnings?:boolean;
 /** Linked-file entries accepted by create and update. */
-file?: string[];
+file?:string[];
 /** Whether linked-file entries should be cleared. */
-clearFiles?: boolean;
+clearFiles?:boolean;
 /** Linked-test entries accepted by create and update. */
-test?: string[];
+test?:string[];
 /** Whether linked-test entries should be cleared. */
-clearTests?: boolean;
+clearTests?:boolean;
 /** Linked-document entries accepted by create and update. */
-doc?: string[];
+doc?:string[];
 /** Whether linked-document entries should be cleared. */
-clearDocs?: boolean;
+clearDocs?:boolean;
 /** Reminder entries accepted by create and update. */
-reminder?: string[];
+reminder?:string[];
 /** Whether reminder entries should be cleared. */
-clearReminders?: boolean;
+clearReminders?:boolean;
 /** Event entries accepted by create and update. */
-event?: string[];
+event?:string[];
 /** Whether event entries should be cleared. */
-clearEvents?: boolean;
+clearEvents?:boolean;
 /** Custom type-option entries accepted by create and update. */
-typeOption?: string[];
+typeOption?:string[];
 /** Whether custom type-option entries should be cleared. */
-clearTypeOptions?: boolean;
+clearTypeOptions?:boolean;
 }
 /** Build the shared create/update collection normalizer table with optional replacement-mode guards. */
-export declare function createLegacyNoneCollectionNormalizers<TOptions extends LegacyNoneCollectionOptions>(options?: {
-depDisableFlagKey?: keyof TOptions;
-fileDisableFlagKey?: keyof TOptions;
-testDisableFlagKey?: keyof TOptions;
-docDisableFlagKey?: keyof TOptions;
-}): ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>>;
+export declare function createLegacyNoneCollectionNormalizers<TOptions extends LegacyNoneCollectionOptions>(options?:{
+depDisableFlagKey?:keyof TOptions;
+fileDisableFlagKey?:keyof TOptions;
+testDisableFlagKey?:keyof TOptions;
+docDisableFlagKey?:keyof TOptions;
+}):ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>>;
 /** Implements check whether legacy none token for the public runtime surface of this module. */
-export declare function isLegacyNoneToken(value: string | undefined): boolean;
+export declare function isLegacyNoneToken(value:string | undefined):boolean;
 /** Implements assert no legacy none token for the public runtime surface of this module. */
-export declare function assertNoLegacyNoneToken(value: string | undefined, flag: string, replacementHint?: string): void;
+export declare function assertNoLegacyNoneToken(value:string | undefined,flag:string,replacementHint?:string):void;
 /** Implements assert no legacy none tokens for the public runtime surface of this module. */
-export declare function assertNoLegacyNoneTokens(values: string[] | undefined, flag: string, replacementHint?: string): void;
+export declare function assertNoLegacyNoneTokens(values:string[] | undefined,flag:string,replacementHint?:string):void;
 /** Convert collection-level legacy none/null tokens into their explicit clear flags. */
-export declare function applyLegacyNoneCollectionNormalizers<TOptions extends Record<string, unknown>>(normalized: TOptions, definitions: ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>>): TOptions;
+export declare function applyLegacyNoneCollectionNormalizers<TOptions extends Record<string,unknown>>(normalized:TOptions,definitions:ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>>):TOptions;

package/dist/sdk/lifecycle/lifecycle-transitions.d.ts

@@ -7,9 +7,9 @@ import { type RuntimeStatusRegistry } from "../runtime-primitives.js";
 /** GH-216: a contextual next-step hint that nudges agents toward the underutilized `in_progress` lifecycle state instead of jumping straight from `open` to `closed`. The suggestion is intentionally non-binding (no governance enforcement) and only surfaces when a richer transition genuinely exists. */
 export interface LifecycleTransitionSuggestion {
 /** Ready-to-run command that advances the item to the suggested status. */
-command: string;
+command:string;
 /** The status the suggested command moves the item to. */
-to_status: string;
+to_status:string;
 }
 /**
  * Suggest the next lifecycle transition for a freshly created (or open) item.
@@ -20,4 +20,4 @@ to_status: string;
  * scheduling types and workflows that collapse `in_progress` into `open` — so
  * the suggestion never fabricates a transition the workflow cannot perform.
  */
-export declare function suggestNextLifecycleTransition(id: string, type: string, status: string, statusRegistry: RuntimeStatusRegistry): LifecycleTransitionSuggestion | undefined;
+export declare function suggestNextLifecycleTransition(id:string,type:string,status:string,statusRegistry:RuntimeStatusRegistry):LifecycleTransitionSuggestion | undefined;

package/dist/sdk/lifecycle/mcp-actions.d.ts

@@ -2,23 +2,23 @@ import type { GlobalOptions } from "../../core/shared/command-types.js";
 /** Minimal generic dispatch context consumed by lifecycle mutation adapters. */
 export interface LifecycleMutationActionContext {
 /** Flat MCP/action arguments. */
-args: Record<string, unknown>;
+args:Record<string,unknown>;
 /** Normalized command option bag. */
-options: Record<string, unknown>;
+options:Record<string,unknown>;
 /** Item id resolved from flat arguments, when present. */
-id: string | undefined;
+id:string | undefined;
 /** Normalized transport-level force override. */
-force?: boolean;
+force?:boolean;
 /** Presentation-neutral global command options. */
-global: GlobalOptions;
+global:GlobalOptions;
 }
 /** Dispatch explicit and ranked claims through the same compact receipt contract. */
-export declare function runMcpClaimAction(context: LifecycleMutationActionContext): Promise<unknown>;
+export declare function runMcpClaimAction(context:LifecycleMutationActionContext):Promise<unknown>;
 /** Dispatch close through the shared MCP mutation compaction contract. */
-export declare function runMcpCloseAction(context: LifecycleMutationActionContext): Promise<unknown>;
+export declare function runMcpCloseAction(context:LifecycleMutationActionContext):Promise<unknown>;
 /** Apply one shared transport projection to canonical and legacy lifecycle compositions. */
-export declare function runMcpTaskCompositionAction(context: LifecycleMutationActionContext, action: "start_task" | "pause_task" | "close_task"): Promise<unknown>;
+export declare function runMcpTaskCompositionAction(context:LifecycleMutationActionContext,action:"start_task" | "pause_task" | "close_task"):Promise<unknown>;
 /** Release ownership with the same compact/full controls used by claiming and pausing. */
-export declare function runMcpReleaseAction(context: LifecycleMutationActionContext): Promise<unknown>;
+export declare function runMcpReleaseAction(context:LifecycleMutationActionContext):Promise<unknown>;
 /** Dispatch recurrence through the shared MCP mutation compaction contract. */
-export declare function runMcpReopenAction(context: LifecycleMutationActionContext): Promise<unknown>;
+export declare function runMcpReopenAction(context:LifecycleMutationActionContext):Promise<unknown>;

package/dist/sdk/lifecycle/metadata-normalizers.d.ts

@@ -1,8 +1,8 @@
 /** Implements normalize risk input for the public runtime surface of this module. */
-export declare function normalizeRiskInput(value: string): string;
+export declare function normalizeRiskInput(value:string):string;
 /** Implements normalize severity input for the public runtime surface of this module. */
-export declare function normalizeSeverityInput(value: string): string;
+export declare function normalizeSeverityInput(value:string):string;
 /** Implements parse confidence input for the public runtime surface of this module. */
-export declare function parseConfidenceInput(value: string): number | "low" | "medium" | "high";
+export declare function parseConfidenceInput(value:string):number | "low" | "medium" | "high";
 /** Implements parse regression input for the public runtime surface of this module. */
-export declare function parseRegressionInput(value: string): boolean;
+export declare function parseRegressionInput(value:string):boolean;

package/dist/sdk/lifecycle/mutation-command-options.d.ts

@@ -6,125 +6,125 @@
 /** Documents metadata mutation options shared by create and update command payloads. */
 export interface MutationMetadataCommandOptions {
 /** Value that configures or reports deadline for this contract. */
-deadline?: string;
+deadline?:string;
 /** Value that configures or reports estimated minutes for this contract. */
-estimatedMinutes?: string;
+estimatedMinutes?:string;
 /** Value that configures or reports acceptance criteria for this contract. */
-acceptanceCriteria?: string;
+acceptanceCriteria?:string;
 /** Value that configures or reports definition of ready for this contract. */
-definitionOfReady?: string;
+definitionOfReady?:string;
 /** Value that configures or reports order for this contract. */
-order?: string;
+order?:string;
 /** Value that configures or reports rank for this contract. */
-rank?: string;
+rank?:string;
 /** Value that configures or reports goal for this contract. */
-goal?: string;
+goal?:string;
 /** Value that configures or reports objective for this contract. */
-objective?: string;
+objective?:string;
 /** Value that configures or reports value for this contract. */
-value?: string;
+value?:string;
 /** Value that configures or reports impact for this contract. */
-impact?: string;
+impact?:string;
 /** Value that configures or reports outcome for this contract. */
-outcome?: string;
+outcome?:string;
 /** Value that configures or reports why now for this contract. */
-whyNow?: string;
+whyNow?:string;
 /** Value that configures or reports author for this contract. */
-author?: string;
+author?:string;
 /** Human-readable explanation suitable for logs and agent-facing output. */
-message?: string;
+message?:string;
 /** Value that configures or reports assignee for this contract. */
-assignee?: string;
+assignee?:string;
 /** Value that configures or reports parent for this contract. */
-parent?: string;
+parent?:string;
 /** Value that configures or reports reviewer for this contract. */
-reviewer?: string;
+reviewer?:string;
 /** Value that configures or reports risk for this contract. */
-risk?: string;
+risk?:string;
 /** Value that configures or reports confidence for this contract. */
-confidence?: string;
+confidence?:string;
 /** Value that configures or reports sprint for this contract. */
-sprint?: string;
+sprint?:string;
 /** Value that configures or reports release for this contract. */
-release?: string;
+release?:string;
 /** Value that configures or reports blocked by for this contract. */
-blockedBy?: string;
+blockedBy?:string;
 /** Value that configures or reports blocked reason for this contract. */
-blockedReason?: string;
+blockedReason?:string;
 /** Value that configures or reports unblock note for this contract. */
-unblockNote?: string;
+unblockNote?:string;
 /** Value that configures or reports reporter for this contract. */
-reporter?: string;
+reporter?:string;
 /** Value that configures or reports severity for this contract. */
-severity?: string;
+severity?:string;
 /** Value that configures or reports environment for this contract. */
-environment?: string;
+environment?:string;
 /** Value that configures or reports repro steps for this contract. */
-reproSteps?: string;
+reproSteps?:string;
 /** Value that configures or reports resolution for this contract. */
-resolution?: string;
+resolution?:string;
 /** Structured result returned by the expected operation. */
-expectedResult?: string;
+expectedResult?:string;
 /** Structured result returned by the actual operation. */
-actualResult?: string;
+actualResult?:string;
 /** Value that configures or reports affected version for this contract. */
-affectedVersion?: string;
+affectedVersion?:string;
 /** Value that configures or reports fixed version for this contract. */
-fixedVersion?: string;
+fixedVersion?:string;
 /** Value that configures or reports component for this contract. */
-component?: string;
+component?:string;
 /** Value that configures or reports regression for this contract. */
-regression?: string;
+regression?:string;
 /** Value that configures or reports customer impact for this contract. */
-customerImpact?: string;
+customerImpact?:string;
 }
 /** Documents repeatable linked-resource option payloads accepted by create/update commands. */
 export interface SharedLinkedResourceOptions {
 /** Value that configures or reports comment for this contract. */
-comment?: string[];
+comment?:string[];
 /** Value that configures or reports note for this contract. */
-note?: string[];
+note?:string[];
 /** Value that configures or reports learning for this contract. */
-learning?: string[];
+learning?:string[];
 /** Value that configures or reports file for this contract. */
-file?: string[];
+file?:string[];
 /** Value that configures or reports test for this contract. */
-test?: string[];
+test?:string[];
 /** Value that configures or reports doc for this contract. */
-doc?: string[];
+doc?:string[];
 /** Value that configures or reports dep for this contract. */
-dep?: string[];
+dep?:string[];
 /** Value that configures or reports reminder for this contract. */
-reminder?: string[];
+reminder?:string[];
 /** Value that configures or reports event for this contract. */
-event?: string[];
+event?:string[];
 /** Value that configures or reports type option for this contract. */
-typeOption?: string[];
+typeOption?:string[];
 /** Value that configures or reports field for this contract. */
-field?: string[];
+field?:string[];
 }
 /** Documents shared linked-resource clear flags accepted by create/update commands. */
 export interface SharedLinkedResourceClearOptions {
 /** Value that configures or reports unset for this contract. */
-unset?: string[];
+unset?:string[];
 /** Value that configures or reports clear deps for this contract. */
-clearDeps?: boolean;
+clearDeps?:boolean;
 /** Value that configures or reports clear comments for this contract. */
-clearComments?: boolean;
+clearComments?:boolean;
 /** Value that configures or reports clear notes for this contract. */
-clearNotes?: boolean;
+clearNotes?:boolean;
 /** Value that configures or reports clear learnings for this contract. */
-clearLearnings?: boolean;
+clearLearnings?:boolean;
 /** Value that configures or reports clear files for this contract. */
-clearFiles?: boolean;
+clearFiles?:boolean;
 /** Value that configures or reports clear tests for this contract. */
-clearTests?: boolean;
+clearTests?:boolean;
 /** Value that configures or reports clear docs for this contract. */
-clearDocs?: boolean;
+clearDocs?:boolean;
 /** Value that configures or reports clear reminders for this contract. */
-clearReminders?: boolean;
+clearReminders?:boolean;
 /** Value that configures or reports clear events for this contract. */
-clearEvents?: boolean;
+clearEvents?:boolean;
 /** Inputs that customize the clear type operation. */
-clearTypeOptions?: boolean;
+clearTypeOptions?:boolean;
 }

package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts

@@ -3,4 +3,4 @@
  * Shares stored collection names, mutation option identities, and serialized entry fields.
  */
 /** Authoritative collection-to-option mapping for structured item IO and core-field recovery. */
-export declare const ITEM_MUTATION_FACET_OPTION_MAPPINGS: ReadonlyArray<readonly [string, string, readonly string[]]>;
+export declare const ITEM_MUTATION_FACET_OPTION_MAPPINGS:ReadonlyArray<readonly [string,string,readonly string[]]>;

package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts

@@ -2,52 +2,52 @@
  * @module sdk/lifecycle/plan-mutation-receipt
  * Bounded mutation acknowledgements; full Plan state remains a separate read.
  */
-import type { PlanCommandResult, PlanStepSummary, PlanSubcommand } from "./plan.js";
-import type { PlanMode, PlanStepStatus } from "../../types/index.js";
+import type { PlanCommandResult,PlanStepSummary,PlanSubcommand } from "./plan.js";
+import type { PlanMode,PlanStepStatus } from "../../types/index.js";
 /** Stable mutation facts whose size does not grow with unrelated Plan content. */
 export interface PlanMutationReceipt {
 /** Discriminator used by CLI and MCP mutation projection. */
-kind: "plan_mutation";
+kind:"plan_mutation";
 /** Operation that completed successfully. */
-action: PlanSubcommand;
+action:PlanSubcommand;
 /** Persisted Plan identifier. */
-id: string;
+id:string;
 /** Persisted item lifecycle state. */
-status: string;
+status:string;
 /** Persisted execution mode. */
-mode: PlanMode;
+mode:PlanMode;
 /** Counts over the complete persisted step collection. */
-steps_summary: PlanStepSummary;
+steps_summary:PlanStepSummary;
 /** Affected step identity when the operation returns a step. */
-step?: Pick<NonNullable<PlanCommandResult["step"]>, "id" | "order"> & {
-status: PlanStepStatus;
+step?:Pick<NonNullable<PlanCommandResult["step"]>,"id" | "order"> & {
+status:PlanStepStatus;
 };
 /** Number of items created by this materialization. */
-materialized_count: number;
+materialized_count:number;
 /** Number of already completed or materialized steps skipped. */
-skipped_count: number;
+skipped_count:number;
 /** Number of warnings in the full SDK result. */
-warning_count: number;
+warning_count:number;
 /** Up to three warning previews, each bounded to 160 characters. */
-warnings: string[];
+warnings:string[];
 /** Whether any warning content is absent from the previews. */
-warnings_truncated: boolean;
+warnings_truncated:boolean;
 /** First applicable next action, falling back to read-only inspection. */
-next_action: string;
+next_action:string;
 /** Read-only recovery for complete steps, evidence and resume context. */
-inspection_command: string;
+inspection_command:string;
 /** Explicitly declares that this acknowledgement is not complete Plan state. */
-omission_receipt: {
+omission_receipt:{
 /** Full Plan content is intentionally withheld. */
-has_omissions: true;
+has_omissions:true;
 /** Projection group count. */
-omitted_field_group_count: 1;
+omitted_field_group_count:1;
 /** Named omitted group and its safe read-only recovery. */
-omitted_field_groups: {
-name: "plan_detail";
-restore_with: string;
+omitted_field_groups:{
+name:"plan_detail";
+restore_with:string;
 }[];
 };
 }
 /** Project completed work; omit the root for MCP recovery in the caller's existing workspace context. */
-export declare function buildPlanMutationReceipt(result: PlanCommandResult, pmRoot: string | undefined): PlanMutationReceipt;
+export declare function buildPlanMutationReceipt(result:PlanCommandResult,pmRoot:string | undefined):PlanMutationReceipt;