@unbrained/pm-cli 2026.10.12 → 2026.10.13

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

@@ -1,16 +1,16 @@
 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>;
-    /** Normalized command option bag. */
-    options: Record<string, unknown>;
-    /** Item id resolved from flat arguments, when present. */
-    id: string | undefined;
-    /** Normalized transport-level force override. */
-    force?: boolean;
-    /** Presentation-neutral global command options. */
-    global: GlobalOptions;
+/** Flat MCP/action arguments. */
+args: Record<string, unknown>;
+/** Normalized command option bag. */
+options: Record<string, unknown>;
+/** Item id resolved from flat arguments, when present. */
+id: string | undefined;
+/** Normalized transport-level force override. */
+force?: boolean;
+/** Presentation-neutral global command options. */
+global: GlobalOptions;
 }
 /** Dispatch explicit and ranked claims through the same compact receipt contract. */
 export declare function runMcpClaimAction(context: LifecycleMutationActionContext): Promise<unknown>;

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * @module sdk/lifecycle/mutation-facet-contracts
+ * 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[]]>;

package/dist/sdk/lifecycle/mutation-facet-contracts.js

@@ -0,0 +1,2 @@
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6ccfe6c7-3911-5623-aa29-5eff0293f816")}catch{}})();const ITEM_MUTATION_FACET_OPTION_MAPPINGS=[["dependencies","dep",["id","kind","created_at","author","source_kind"]],["comments","comment",["text","created_at","author"]],["notes","note",["text","created_at","author"]],["learnings","learning",["text","created_at","author"]],["files","file",["path","scope","note"]],["tests","test",["command","scope","timeout_seconds"]],["docs","doc",["path","scope","note"]],["reminders","reminder",["at","text","created_at"]],["events","event",["start_at","end_at","title","location"]],["type_options","typeOption",["key","value"]]];export{ITEM_MUTATION_FACET_OPTION_MAPPINGS};
+//# sourceMappingURL=mutation-facet-contracts.js.map

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

@@ -6,48 +6,48 @@ import type { PlanCommandResult, PlanStepSummary, PlanSubcommand } from "./plan.
 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";
-    /** Operation that completed successfully. */
-    action: PlanSubcommand;
-    /** Persisted Plan identifier. */
-    id: string;
-    /** Persisted item lifecycle state. */
-    status: string;
-    /** Persisted execution mode. */
-    mode: PlanMode;
-    /** Counts over the complete persisted step collection. */
-    steps_summary: PlanStepSummary;
-    /** Affected step identity when the operation returns a step. */
-    step?: Pick<NonNullable<PlanCommandResult["step"]>, "id" | "order"> & {
-        status: PlanStepStatus;
-    };
-    /** Number of items created by this materialization. */
-    materialized_count: number;
-    /** Number of already completed or materialized steps skipped. */
-    skipped_count: number;
-    /** Number of warnings in the full SDK result. */
-    warning_count: number;
-    /** Up to three warning previews, each bounded to 160 characters. */
-    warnings: string[];
-    /** Whether any warning content is absent from the previews. */
-    warnings_truncated: boolean;
-    /** First applicable next action, falling back to read-only inspection. */
-    next_action: string;
-    /** Read-only recovery for complete steps, evidence and resume context. */
-    inspection_command: string;
-    /** Explicitly declares that this acknowledgement is not complete Plan state. */
-    omission_receipt: {
-        /** Full Plan content is intentionally withheld. */
-        has_omissions: true;
-        /** Projection group count. */
-        omitted_field_group_count: 1;
-        /** Named omitted group and its safe read-only recovery. */
-        omitted_field_groups: {
-            name: "plan_detail";
-            restore_with: string;
-        }[];
-    };
+/** Discriminator used by CLI and MCP mutation projection. */
+kind: "plan_mutation";
+/** Operation that completed successfully. */
+action: PlanSubcommand;
+/** Persisted Plan identifier. */
+id: string;
+/** Persisted item lifecycle state. */
+status: string;
+/** Persisted execution mode. */
+mode: PlanMode;
+/** Counts over the complete persisted step collection. */
+steps_summary: PlanStepSummary;
+/** Affected step identity when the operation returns a step. */
+step?: Pick<NonNullable<PlanCommandResult["step"]>, "id" | "order"> & {
+status: PlanStepStatus;
+};
+/** Number of items created by this materialization. */
+materialized_count: number;
+/** Number of already completed or materialized steps skipped. */
+skipped_count: number;
+/** Number of warnings in the full SDK result. */
+warning_count: number;
+/** Up to three warning previews, each bounded to 160 characters. */
+warnings: string[];
+/** Whether any warning content is absent from the previews. */
+warnings_truncated: boolean;
+/** First applicable next action, falling back to read-only inspection. */
+next_action: string;
+/** Read-only recovery for complete steps, evidence and resume context. */
+inspection_command: string;
+/** Explicitly declares that this acknowledgement is not complete Plan state. */
+omission_receipt: {
+/** Full Plan content is intentionally withheld. */
+has_omissions: true;
+/** Projection group count. */
+omitted_field_group_count: 1;
+/** Named omitted group and its safe read-only recovery. */
+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;