@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/mutation-guard.d.ts

@@ -10,49 +10,49 @@ export type SecretGuardMode = "off" | "advise" | "block";
 /** Settings consumed by the shared mutation guard. */
 export interface MutationGuardSettings {
 /** Reject mutations whose effective author is empty or `unknown`. */
-require_attributed_author: boolean;
+require_attributed_author:boolean;
 /** Detection policy for credential-shaped text. */
-secret_guard: SecretGuardMode;
+secret_guard:SecretGuardMode;
 /** Age threshold used by stale in-progress governance checks. */
-stale_in_progress_hours: number;
+stale_in_progress_hours:number;
 }
 /** One redacted credential-shaped match. Secret values are never returned. */
 export interface SecretGuardFinding {
 /** Stable detector identifier suitable for tests and telemetry. */
-rule: (typeof SECRET_RULES)[number]["mutationRule"];
+rule:(typeof SECRET_RULES)[number]["mutationRule"];
 /** Object path or argument index containing the match. */
-path: string;
+path:string;
 }
 /** Result of a non-blocking or bypassed mutation guard evaluation. */
 export interface MutationGuardResult {
 /** Effective author accepted by the guard. */
-author: string;
+author:string;
 /** Redacted detector matches. */
-findings: SecretGuardFinding[];
+findings:SecretGuardFinding[];
 /** Stable warning strings safe for stderr and structured warning arrays. */
-warnings: string[];
+warnings:string[];
 /** Whether an explicit force override bypassed blocking secret policy. */
-override_applied: boolean;
+override_applied:boolean;
 }
 /** Input accepted by the shared mutation guard. */
 export interface EvaluateMutationGuardOptions {
 /** Effective mutation author after normal CLI/SDK precedence resolution. */
-author: string;
+author:string;
 /** Arbitrary mutation payload. Only string leaves are inspected. */
-payload: unknown;
+payload:unknown;
 /** Workspace guard settings. */
-settings: MutationGuardSettings;
+settings:MutationGuardSettings;
 /** Explicit, caller-visible override for a blocking secret finding. */
-force?: boolean;
+force?:boolean;
 }
 /** Audit stream a native mutation must append when it changes durable state. */
 export type MutationHistoryScope = "item" | "workspace" | "history" | "conditional";
 /** Executable provenance contract for one native state-changing action. */
 export interface MutationActionContract {
 /** Canonical CLI/SDK/MCP action name. */
-action: string;
+action:string;
 /** Audit stream required when the action changes durable state. */
-history_scope: MutationHistoryScope;
+history_scope:MutationHistoryScope;
 }
 /**
  * Canonical native mutation inventory shared by guard dispatch, history
@@ -60,131 +60,131 @@ history_scope: MutationHistoryScope;
  * read/diagnostic and write modes; they require history only when a durable
  * mutation occurs.
  */
-export declare const PM_MUTATION_ACTION_CONTRACTS: readonly [{
-readonly action: "append";
-readonly history_scope: "item";
-}, {
-readonly action: "claim";
-readonly history_scope: "item";
-}, {
-readonly action: "close";
-readonly history_scope: "item";
-}, {
-readonly action: "close-many";
-readonly history_scope: "item";
-}, {
-readonly action: "close-task";
-readonly history_scope: "item";
-}, {
-readonly action: "comments";
-readonly history_scope: "conditional";
-}, {
-readonly action: "config";
-readonly history_scope: "conditional";
-}, {
-readonly action: "copy";
-readonly history_scope: "item";
-}, {
-readonly action: "create";
-readonly history_scope: "item";
-}, {
-readonly action: "delete";
-readonly history_scope: "item";
-}, {
-readonly action: "deps";
-readonly history_scope: "conditional";
-}, {
-readonly action: "discover";
-readonly history_scope: "item";
-}, {
-readonly action: "docs";
-readonly history_scope: "conditional";
-}, {
-readonly action: "files";
-readonly history_scope: "conditional";
-}, {
-readonly action: "focus";
-readonly history_scope: "conditional";
-}, {
-readonly action: "gc";
-readonly history_scope: "conditional";
-}, {
-readonly action: "history-compact";
-readonly history_scope: "history";
-}, {
-readonly action: "history-author-acknowledge";
-readonly history_scope: "workspace";
-}, {
-readonly action: "history-redact";
-readonly history_scope: "history";
-}, {
-readonly action: "history-repair";
-readonly history_scope: "history";
-}, {
-readonly action: "init";
-readonly history_scope: "workspace";
-}, {
-readonly action: "install";
-readonly history_scope: "conditional";
-}, {
-readonly action: "learnings";
-readonly history_scope: "conditional";
-}, {
-readonly action: "notes";
-readonly history_scope: "conditional";
-}, {
-readonly action: "package";
-readonly history_scope: "conditional";
-}, {
-readonly action: "pause-task";
-readonly history_scope: "item";
-}, {
-readonly action: "plan";
-readonly history_scope: "conditional";
-}, {
-readonly action: "profile";
-readonly history_scope: "conditional";
-}, {
-readonly action: "release";
-readonly history_scope: "item";
-}, {
-readonly action: "restore";
-readonly history_scope: "item";
-}, {
-readonly action: "schema";
-readonly history_scope: "conditional";
-}, {
-readonly action: "start-task";
-readonly history_scope: "item";
-}, {
-readonly action: "templates";
-readonly history_scope: "conditional";
-}, {
-readonly action: "test";
-readonly history_scope: "conditional";
-}, {
-readonly action: "test-all";
-readonly history_scope: "conditional";
-}, {
-readonly action: "update";
-readonly history_scope: "item";
-}, {
-readonly action: "update-many";
-readonly history_scope: "item";
-}, {
-readonly action: "upgrade";
-readonly history_scope: "conditional";
+export declare const PM_MUTATION_ACTION_CONTRACTS:readonly [{
+readonly action:"append";
+readonly history_scope:"item";
+},{
+readonly action:"claim";
+readonly history_scope:"item";
+},{
+readonly action:"close";
+readonly history_scope:"item";
+},{
+readonly action:"close-many";
+readonly history_scope:"item";
+},{
+readonly action:"close-task";
+readonly history_scope:"item";
+},{
+readonly action:"comments";
+readonly history_scope:"conditional";
+},{
+readonly action:"config";
+readonly history_scope:"conditional";
+},{
+readonly action:"copy";
+readonly history_scope:"item";
+},{
+readonly action:"create";
+readonly history_scope:"item";
+},{
+readonly action:"delete";
+readonly history_scope:"item";
+},{
+readonly action:"deps";
+readonly history_scope:"conditional";
+},{
+readonly action:"discover";
+readonly history_scope:"item";
+},{
+readonly action:"docs";
+readonly history_scope:"conditional";
+},{
+readonly action:"files";
+readonly history_scope:"conditional";
+},{
+readonly action:"focus";
+readonly history_scope:"conditional";
+},{
+readonly action:"gc";
+readonly history_scope:"conditional";
+},{
+readonly action:"history-compact";
+readonly history_scope:"history";
+},{
+readonly action:"history-author-acknowledge";
+readonly history_scope:"workspace";
+},{
+readonly action:"history-redact";
+readonly history_scope:"history";
+},{
+readonly action:"history-repair";
+readonly history_scope:"history";
+},{
+readonly action:"init";
+readonly history_scope:"workspace";
+},{
+readonly action:"install";
+readonly history_scope:"conditional";
+},{
+readonly action:"learnings";
+readonly history_scope:"conditional";
+},{
+readonly action:"notes";
+readonly history_scope:"conditional";
+},{
+readonly action:"package";
+readonly history_scope:"conditional";
+},{
+readonly action:"pause-task";
+readonly history_scope:"item";
+},{
+readonly action:"plan";
+readonly history_scope:"conditional";
+},{
+readonly action:"profile";
+readonly history_scope:"conditional";
+},{
+readonly action:"release";
+readonly history_scope:"item";
+},{
+readonly action:"restore";
+readonly history_scope:"item";
+},{
+readonly action:"schema";
+readonly history_scope:"conditional";
+},{
+readonly action:"start-task";
+readonly history_scope:"item";
+},{
+readonly action:"templates";
+readonly history_scope:"conditional";
+},{
+readonly action:"test";
+readonly history_scope:"conditional";
+},{
+readonly action:"test-all";
+readonly history_scope:"conditional";
+},{
+readonly action:"update";
+readonly history_scope:"item";
+},{
+readonly action:"update-many";
+readonly history_scope:"item";
+},{
+readonly action:"upgrade";
+readonly history_scope:"conditional";
 }];
 /** Detect credential-shaped string leaves without returning matched values. */
-export declare function scanMutationSecrets(payload: unknown): SecretGuardFinding[];
+export declare function scanMutationSecrets(payload:unknown):SecretGuardFinding[];
 /**
  * Enforce shared provenance and secret policy before a mutation is dispatched.
  * Detector failures are fail-open and surface a stable advisory.
  */
-export declare function evaluateMutationGuard(options: EvaluateMutationGuardOptions): MutationGuardResult;
+export declare function evaluateMutationGuard(options:EvaluateMutationGuardOptions):MutationGuardResult;
 /** Identify native actions that can persist tracker or workspace state. */
-export declare function isMutationAction(action: string): boolean;
+export declare function isMutationAction(action:string):boolean;
 /** Return the canonical, stable native mutation-action inventory. */
-export declare function listMutationActions(): string[];
+export declare function listMutationActions():string[];
 /** Resolve the history contract for one native mutation action. */
-export declare function getMutationActionContract(action: string): MutationActionContract | undefined;
+export declare function getMutationActionContract(action:string):MutationActionContract | undefined;

package/dist/sdk/notes.d.ts

@@ -5,64 +5,64 @@
  */
 import { type GlobalOptions } from "./runtime-primitives.js";
 import type { LogNote } from "../types/index.js";
-import { type AnnotationMutationReceipt, type AnnotationOmissionReceipt } from "./annotations.js";
+import { type AnnotationMutationReceipt,type AnnotationOmissionReceipt } from "./annotations.js";
 /** Documents the notes command options payload exchanged by command, SDK, and package integrations. */
 export interface NotesCommandOptions {
 /** Value that configures or reports add for this contract. */
-add?: string;
+add?:string;
 /** Append a validated JSON context event to the merge-safe notes collection. */
-addJson?: string;
+addJson?:string;
 /** Read note text from stdin. */
-stdin?: boolean;
+stdin?:boolean;
 /** Read note text from a UTF-8 file. */
-file?: string;
+file?:string;
 /** Replace the note at this one-based index. */
-edit?: number;
+edit?:number;
 /** Delete the note at this one-based index. */
-delete?: number;
+delete?:number;
 /** Value that configures or reports limit for this contract. */
-limit?: string;
+limit?:string;
 /** Return structured events created at or after this ISO timestamp. */
-since?: string;
+since?:string;
 /** Return structured events whose top-level `type` property matches this value. */
-eventType?: string;
+eventType?:string;
 /** Include total, returned, and truncation metadata. */
-includeMeta?: boolean;
+includeMeta?:boolean;
 /** Return complete note history after a mutation instead of a bounded receipt. */
-fullHistory?: boolean;
+fullHistory?:boolean;
 /** Append only when no note has the same resolved author and text. */
-ifAbsent?: boolean;
+ifAbsent?:boolean;
 /** 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 force for this contract. */
-force?: boolean;
+force?:boolean;
 }
 /** Documents the notes result payload exchanged by command, SDK, and package integrations. */
 export interface NotesResult {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports notes for this contract. */
-notes: LogNote[];
+notes:LogNote[];
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Total entries before limit and structured-event filters. */
-total_count?: number;
+total_count?:number;
 /** Number of entries returned after filtering and limiting. */
-returned_count?: number;
+returned_count?:number;
 /** Whether additional matching entries were omitted by the limit. */
-has_more?: boolean;
+has_more?:boolean;
 /** Applied result limit. */
-limit?: number;
+limit?:number;
 /** Number of structured context events in the returned projection. */
-structured_event_count?: number;
+structured_event_count?:number;
 /** Mutation identity when this result changed the collection. */
-mutation_receipt?: AnnotationMutationReceipt;
+mutation_receipt?:AnnotationMutationReceipt;
 /** Declares whether older notes were withheld from a mutation response. */
-omission_receipt?: AnnotationOmissionReceipt;
+omission_receipt?:AnnotationOmissionReceipt;
 /** Whether a requested mutation changed persisted state. */
-changed?: boolean;
+changed?:boolean;
 }
 /** Implements run notes for the public runtime surface of this module. */
-export declare function runNotes(id: string, options: NotesCommandOptions, global: GlobalOptions): Promise<NotesResult>;
+export declare function runNotes(id:string,options:NotesCommandOptions,global:GlobalOptions):Promise<NotesResult>;

package/dist/sdk/output/table-rows.d.ts

@@ -9,16 +9,16 @@ import type { JsonValue } from "@toon-format/toon";
 /** Metadata required to restore nested cells and sparse object rows. */
 export interface PmTableCellEncoding {
 /** Columns whose every present cell contains a JSON-serialized value. */
-json_columns: string[];
+json_columns:string[];
 /** Missing field coordinates, expressed as [zero-based row, column name]. */
-absent: Array<[number, string]>;
+absent:Array<[number,string]>;
 }
 /** Primitive rows accepted by the standard TOON tabular encoder. */
 export interface PmEncodedTableRows {
 /** Key-hoisted rows with primitive cells and null padding for absent keys. */
-rows: Record<string, string | number | boolean | null>[];
+rows:Record<string,string | number | boolean | null>[];
 /** Explicit decoding metadata; never inferred from cell content. */
-encoding: PmTableCellEncoding;
+encoding:PmTableCellEncoding;
 }
 /**
  * Project JSON object rows into a lossless table, preserving key order by first
@@ -28,10 +28,10 @@ encoding: PmTableCellEncoding;
  * that dense grid before encoding sparse inputs. The host formatter preflights
  * automatic candidates and falls back to expanded TOON for sparse grids.
  */
-export declare function encodePmTableRows(rows: readonly Record<string, JsonValue>[]): PmEncodedTableRows;
+export declare function encodePmTableRows(rows:readonly Record<string,JsonValue>[]):PmEncodedTableRows;
 /**
  * Restore rows emitted by {@link encodePmTableRows}. Metadata is explicit, so
  * strings resembling JSON stay strings unless their column declares JSON.
  * Malformed JSON cells throw instead of silently changing their meaning.
  */
-export declare function decodePmTableRows(table: PmEncodedTableRows): Record<string, JsonValue>[];
+export declare function decodePmTableRows(table:PmEncodedTableRows):Record<string,JsonValue>[];

package/dist/sdk/output-contracts.d.ts

@@ -1,67 +1,67 @@
 /** Stable machine-readable result families used across pm transports. */
-export declare const PM_OUTPUT_ENVELOPE_KINDS: readonly ["mutation_receipt", "entity", "collection", "diagnostic", "stream"];
+export declare const PM_OUTPUT_ENVELOPE_KINDS:readonly ["mutation_receipt","entity","collection","diagnostic","stream"];
 /** Restricts portable result-envelope families. */
 export type PmOutputEnvelopeKind = (typeof PM_OUTPUT_ENVELOPE_KINDS)[number];
 /** Describes how one command exposes its default machine-readable result. */
 export interface PmCommandOutputEnvelopeContract {
 /** Canonical command path. */
-command: string;
+command:string;
 /** Semantic result family. */
-kind: PmOutputEnvelopeKind;
+kind:PmOutputEnvelopeKind;
 /** Root key carrying the primary value, or null for a flat receipt/stream. */
-wrapper_key: string | null;
+wrapper_key:string | null;
 /** Whether the output can carry multiple primary rows. */
-cardinality: "one" | "many" | "none";
+cardinality:"one" | "many" | "none";
 /** Stable format-flag spelling accepted by every command. */
-format_flag: "--json";
+format_flag:"--json";
 }
 /** Normalized SDK representation of the flat CLI mutation receipt. */
 export interface PmMutationReceipt {
 /** Mutated item or plan identifier. */
-id: string;
+id:string;
 /** Resulting lifecycle status or deletion outcome. */
-status: string;
+status:string;
 /** Number of fields changed by the mutation. */
-changedFieldCount: number;
+changedFieldCount:number;
 /** Persisted close reason when the command closed work. */
-closeReason?: string;
+closeReason?:string;
 /** Whether a destructive mutation removed its target. */
-deleted?: boolean;
+deleted?:boolean;
 /** Status before the mutation when the command reports it. */
-previousStatus?: string;
+previousStatus?:string;
 /** Non-fatal mutation warnings retained by the transport. */
-warnings?: readonly unknown[];
+warnings?:readonly unknown[];
 }
 /** Wire representation emitted by CLI mutation commands in JSON mode. */
 export interface PmCliMutationReceipt {
 /** Mutated item or plan identifier. */
-id: string;
+id:string;
 /** Resulting lifecycle status or deletion outcome. */
-status: string;
+status:string;
 /** Number of fields changed by the mutation. */
-changed_field_count: number;
+changed_field_count:number;
 /** Persisted close reason when the command closed work. */
-close_reason?: string;
+close_reason?:string;
 /** Whether a destructive mutation removed its target. */
-deleted?: boolean;
+deleted?:boolean;
 /** Status before the mutation when the command reports it. */
-previous_status?: string;
+previous_status?:string;
 /** Non-fatal mutation warnings retained by the transport. */
-warnings?: readonly unknown[];
+warnings?:readonly unknown[];
 }
 /** Validate and preserve one package-authored output-envelope declaration. */
-export declare function definePmCommandOutputEnvelope<TContract extends PmCommandOutputEnvelopeContract>(contract: TContract): TContract;
+export declare function definePmCommandOutputEnvelope<TContract extends PmCommandOutputEnvelopeContract>(contract:TContract):TContract;
 /** Default envelope declaration for every built-in command. */
-export declare const PM_COMMAND_OUTPUT_ENVELOPE_CONTRACTS: PmCommandOutputEnvelopeContract[];
+export declare const PM_COMMAND_OUTPUT_ENVELOPE_CONTRACTS:PmCommandOutputEnvelopeContract[];
 /** Resolve a built-in envelope or generate a conservative package fallback. */
-export declare function resolvePmCommandOutputEnvelope(command: string): PmCommandOutputEnvelopeContract;
+export declare function resolvePmCommandOutputEnvelope(command:string):PmCommandOutputEnvelopeContract;
 /** Return whether an unknown value is the flat CLI mutation receipt shape. */
-export declare function isPmMutationReceipt(value: unknown): value is PmCliMutationReceipt;
+export declare function isPmMutationReceipt(value:unknown):value is PmCliMutationReceipt;
 /**
  * Parse and normalize the flat JSON receipt emitted by mutation commands.
  * Wrapped read envelopes are rejected so a wrong consumer assumption fails at
  * the integration boundary instead of silently returning an undefined id.
  */
-export declare function parseMutationReceipt(json: string): PmMutationReceipt;
+export declare function parseMutationReceipt(json:string):PmMutationReceipt;
 /** Parse and normalize an already decoded mutation receipt value. */
-export declare function parseMutationReceipt(value: unknown): PmMutationReceipt;
+export declare function parseMutationReceipt(value:unknown):PmMutationReceipt;