@unbrained/pm-cli 2026.10.11 → 2026.10.13

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

@@ -9,50 +9,50 @@ import { SECRET_RULES } from "../core/shared/secret-rules.js";
 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;
-    /** Detection policy for credential-shaped text. */
-    secret_guard: SecretGuardMode;
-    /** Age threshold used by stale in-progress governance checks. */
-    stale_in_progress_hours: number;
+/** Reject mutations whose effective author is empty or `unknown`. */
+require_attributed_author: boolean;
+/** Detection policy for credential-shaped text. */
+secret_guard: SecretGuardMode;
+/** Age threshold used by stale in-progress governance checks. */
+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"];
-    /** Object path or argument index containing the match. */
-    path: string;
+/** Stable detector identifier suitable for tests and telemetry. */
+rule: (typeof SECRET_RULES)[number]["mutationRule"];
+/** Object path or argument index containing the match. */
+path: string;
 }
 /** Result of a non-blocking or bypassed mutation guard evaluation. */
 export interface MutationGuardResult {
-    /** Effective author accepted by the guard. */
-    author: string;
-    /** Redacted detector matches. */
-    findings: SecretGuardFinding[];
-    /** Stable warning strings safe for stderr and structured warning arrays. */
-    warnings: string[];
-    /** Whether an explicit force override bypassed blocking secret policy. */
-    override_applied: boolean;
+/** Effective author accepted by the guard. */
+author: string;
+/** Redacted detector matches. */
+findings: SecretGuardFinding[];
+/** Stable warning strings safe for stderr and structured warning arrays. */
+warnings: string[];
+/** Whether an explicit force override bypassed blocking secret policy. */
+override_applied: boolean;
 }
 /** Input accepted by the shared mutation guard. */
 export interface EvaluateMutationGuardOptions {
-    /** Effective mutation author after normal CLI/SDK precedence resolution. */
-    author: string;
-    /** Arbitrary mutation payload. Only string leaves are inspected. */
-    payload: unknown;
-    /** Workspace guard settings. */
-    settings: MutationGuardSettings;
-    /** Explicit, caller-visible override for a blocking secret finding. */
-    force?: boolean;
+/** Effective mutation author after normal CLI/SDK precedence resolution. */
+author: string;
+/** Arbitrary mutation payload. Only string leaves are inspected. */
+payload: unknown;
+/** Workspace guard settings. */
+settings: MutationGuardSettings;
+/** Explicit, caller-visible override for a blocking secret finding. */
+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;
-    /** Audit stream required when the action changes durable state. */
-    history_scope: MutationHistoryScope;
+/** Canonical CLI/SDK/MCP action name. */
+action: string;
+/** Audit stream required when the action changes durable state. */
+history_scope: MutationHistoryScope;
 }
 /**
  * Canonical native mutation inventory shared by guard dispatch, history
@@ -61,119 +61,119 @@ export interface MutationActionContract {
  * mutation occurs.
  */
 export declare const PM_MUTATION_ACTION_CONTRACTS: readonly [{
-    readonly action: "append";
-    readonly history_scope: "item";
+readonly action: "append";
+readonly history_scope: "item";
 }, {
-    readonly action: "claim";
-    readonly history_scope: "item";
+readonly action: "claim";
+readonly history_scope: "item";
 }, {
-    readonly action: "close";
-    readonly history_scope: "item";
+readonly action: "close";
+readonly history_scope: "item";
 }, {
-    readonly action: "close-many";
-    readonly history_scope: "item";
+readonly action: "close-many";
+readonly history_scope: "item";
 }, {
-    readonly action: "close-task";
-    readonly history_scope: "item";
+readonly action: "close-task";
+readonly history_scope: "item";
 }, {
-    readonly action: "comments";
-    readonly history_scope: "conditional";
+readonly action: "comments";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "config";
-    readonly history_scope: "conditional";
+readonly action: "config";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "copy";
-    readonly history_scope: "item";
+readonly action: "copy";
+readonly history_scope: "item";
 }, {
-    readonly action: "create";
-    readonly history_scope: "item";
+readonly action: "create";
+readonly history_scope: "item";
 }, {
-    readonly action: "delete";
-    readonly history_scope: "item";
+readonly action: "delete";
+readonly history_scope: "item";
 }, {
-    readonly action: "deps";
-    readonly history_scope: "conditional";
+readonly action: "deps";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "discover";
-    readonly history_scope: "item";
+readonly action: "discover";
+readonly history_scope: "item";
 }, {
-    readonly action: "docs";
-    readonly history_scope: "conditional";
+readonly action: "docs";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "files";
-    readonly history_scope: "conditional";
+readonly action: "files";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "focus";
-    readonly history_scope: "conditional";
+readonly action: "focus";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "gc";
-    readonly history_scope: "conditional";
+readonly action: "gc";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "history-compact";
-    readonly history_scope: "history";
+readonly action: "history-compact";
+readonly history_scope: "history";
 }, {
-    readonly action: "history-author-acknowledge";
-    readonly history_scope: "workspace";
+readonly action: "history-author-acknowledge";
+readonly history_scope: "workspace";
 }, {
-    readonly action: "history-redact";
-    readonly history_scope: "history";
+readonly action: "history-redact";
+readonly history_scope: "history";
 }, {
-    readonly action: "history-repair";
-    readonly history_scope: "history";
+readonly action: "history-repair";
+readonly history_scope: "history";
 }, {
-    readonly action: "init";
-    readonly history_scope: "workspace";
+readonly action: "init";
+readonly history_scope: "workspace";
 }, {
-    readonly action: "install";
-    readonly history_scope: "conditional";
+readonly action: "install";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "learnings";
-    readonly history_scope: "conditional";
+readonly action: "learnings";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "notes";
-    readonly history_scope: "conditional";
+readonly action: "notes";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "package";
-    readonly history_scope: "conditional";
+readonly action: "package";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "pause-task";
-    readonly history_scope: "item";
+readonly action: "pause-task";
+readonly history_scope: "item";
 }, {
-    readonly action: "plan";
-    readonly history_scope: "conditional";
+readonly action: "plan";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "profile";
-    readonly history_scope: "conditional";
+readonly action: "profile";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "release";
-    readonly history_scope: "item";
+readonly action: "release";
+readonly history_scope: "item";
 }, {
-    readonly action: "restore";
-    readonly history_scope: "item";
+readonly action: "restore";
+readonly history_scope: "item";
 }, {
-    readonly action: "schema";
-    readonly history_scope: "conditional";
+readonly action: "schema";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "start-task";
-    readonly history_scope: "item";
+readonly action: "start-task";
+readonly history_scope: "item";
 }, {
-    readonly action: "templates";
-    readonly history_scope: "conditional";
+readonly action: "templates";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "test";
-    readonly history_scope: "conditional";
+readonly action: "test";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "test-all";
-    readonly history_scope: "conditional";
+readonly action: "test-all";
+readonly history_scope: "conditional";
 }, {
-    readonly action: "update";
-    readonly history_scope: "item";
+readonly action: "update";
+readonly history_scope: "item";
 }, {
-    readonly action: "update-many";
-    readonly history_scope: "item";
+readonly action: "update-many";
+readonly history_scope: "item";
 }, {
-    readonly action: "upgrade";
-    readonly history_scope: "conditional";
+readonly action: "upgrade";
+readonly history_scope: "conditional";
 }];
 /** Detect credential-shaped string leaves without returning matched values. */
 export declare function scanMutationSecrets(payload: unknown): SecretGuardFinding[];

package/dist/sdk/notes.d.ts

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

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

@@ -8,17 +8,17 @@
 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[];
-    /** Missing field coordinates, expressed as [zero-based row, column name]. */
-    absent: Array<[number, string]>;
+/** Columns whose every present cell contains a JSON-serialized value. */
+json_columns: string[];
+/** Missing field coordinates, expressed as [zero-based row, column name]. */
+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>[];
-    /** Explicit decoding metadata; never inferred from cell content. */
-    encoding: PmTableCellEncoding;
+/** Key-hoisted rows with primitive cells and null padding for absent keys. */
+rows: Record<string, string | number | boolean | null>[];
+/** Explicit decoding metadata; never inferred from cell content. */
+encoding: PmTableCellEncoding;
 }
 /**
  * Project JSON object rows into a lossless table, preserving key order by first

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

@@ -4,50 +4,50 @@ export declare const PM_OUTPUT_ENVELOPE_KINDS: readonly ["mutation_receipt", "en
 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;
-    /** Semantic result family. */
-    kind: PmOutputEnvelopeKind;
-    /** Root key carrying the primary value, or null for a flat receipt/stream. */
-    wrapper_key: string | null;
-    /** Whether the output can carry multiple primary rows. */
-    cardinality: "one" | "many" | "none";
-    /** Stable format-flag spelling accepted by every command. */
-    format_flag: "--json";
+/** Canonical command path. */
+command: string;
+/** Semantic result family. */
+kind: PmOutputEnvelopeKind;
+/** Root key carrying the primary value, or null for a flat receipt/stream. */
+wrapper_key: string | null;
+/** Whether the output can carry multiple primary rows. */
+cardinality: "one" | "many" | "none";
+/** Stable format-flag spelling accepted by every command. */
+format_flag: "--json";
 }
 /** Normalized SDK representation of the flat CLI mutation receipt. */
 export interface PmMutationReceipt {
-    /** Mutated item or plan identifier. */
-    id: string;
-    /** Resulting lifecycle status or deletion outcome. */
-    status: string;
-    /** Number of fields changed by the mutation. */
-    changedFieldCount: number;
-    /** Persisted close reason when the command closed work. */
-    closeReason?: string;
-    /** Whether a destructive mutation removed its target. */
-    deleted?: boolean;
-    /** Status before the mutation when the command reports it. */
-    previousStatus?: string;
-    /** Non-fatal mutation warnings retained by the transport. */
-    warnings?: readonly unknown[];
+/** Mutated item or plan identifier. */
+id: string;
+/** Resulting lifecycle status or deletion outcome. */
+status: string;
+/** Number of fields changed by the mutation. */
+changedFieldCount: number;
+/** Persisted close reason when the command closed work. */
+closeReason?: string;
+/** Whether a destructive mutation removed its target. */
+deleted?: boolean;
+/** Status before the mutation when the command reports it. */
+previousStatus?: string;
+/** Non-fatal mutation warnings retained by the transport. */
+warnings?: readonly unknown[];
 }
 /** Wire representation emitted by CLI mutation commands in JSON mode. */
 export interface PmCliMutationReceipt {
-    /** Mutated item or plan identifier. */
-    id: string;
-    /** Resulting lifecycle status or deletion outcome. */
-    status: string;
-    /** Number of fields changed by the mutation. */
-    changed_field_count: number;
-    /** Persisted close reason when the command closed work. */
-    close_reason?: string;
-    /** Whether a destructive mutation removed its target. */
-    deleted?: boolean;
-    /** Status before the mutation when the command reports it. */
-    previous_status?: string;
-    /** Non-fatal mutation warnings retained by the transport. */
-    warnings?: readonly unknown[];
+/** Mutated item or plan identifier. */
+id: string;
+/** Resulting lifecycle status or deletion outcome. */
+status: string;
+/** Number of fields changed by the mutation. */
+changed_field_count: number;
+/** Persisted close reason when the command closed work. */
+close_reason?: string;
+/** Whether a destructive mutation removed its target. */
+deleted?: boolean;
+/** Status before the mutation when the command reports it. */
+previous_status?: string;
+/** Non-fatal mutation warnings retained by the transport. */
+warnings?: readonly unknown[];
 }
 /** Validate and preserve one package-authored output-envelope declaration. */
 export declare function definePmCommandOutputEnvelope<TContract extends PmCommandOutputEnvelopeContract>(contract: TContract): TContract;