@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/query/activity.d.ts

@@ -4,131 +4,131 @@ import { type OutputOmissionReceipt } from "../output-projection.js";
 import { type HistoryProvenanceRow, type HistoryProvenanceSummary } from "../history-provenance.js";
 /** Documents the activity command options payload exchanged by command, SDK, and package integrations. */
 export interface ActivityCommandOptions {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id?: string;
-    /** Value that configures or reports op for this contract. */
-    op?: string;
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Value that configures or reports from for this contract. */
-    from?: string;
-    /** Value that configures or reports to for this contract. */
-    to?: string;
-    /** Value that configures or reports limit for this contract. */
-    limit?: string;
-    /** Value that configures or reports compact for this contract. */
-    compact?: boolean;
-    /** Return the legacy per-event stream instead of the item-centric digest. */
-    raw?: boolean;
-    /** Explicitly disables the default activity bound. */
-    unbounded?: boolean;
-    /** Return patch-free provenance rows. */
-    provenance?: boolean;
-    /** Include constant-size provenance completeness metrics. */
-    provenanceSummary?: boolean;
-    /** Filter by canonical recorded or vocabulary-resolved harness. */
-    harness?: string | readonly string[];
-    /** Filter by privacy-safe invocation fingerprint. */
-    agentInstance?: string | readonly string[];
-    /** Exact provenance dimension predicates (`dimension=value`). */
-    provenanceFilter?: string | readonly string[];
+/** Stable identifier used to reference this record across commands and storage. */
+id?: string;
+/** Value that configures or reports op for this contract. */
+op?: string;
+/** Value that configures or reports author for this contract. */
+author?: string;
+/** Value that configures or reports from for this contract. */
+from?: string;
+/** Value that configures or reports to for this contract. */
+to?: string;
+/** Value that configures or reports limit for this contract. */
+limit?: string;
+/** Value that configures or reports compact for this contract. */
+compact?: boolean;
+/** Return the legacy per-event stream instead of the item-centric digest. */
+raw?: boolean;
+/** Explicitly disables the default activity bound. */
+unbounded?: boolean;
+/** Return patch-free provenance rows. */
+provenance?: boolean;
+/** Include constant-size provenance completeness metrics. */
+provenanceSummary?: boolean;
+/** Filter by canonical recorded or vocabulary-resolved harness. */
+harness?: string | readonly string[];
+/** Filter by privacy-safe invocation fingerprint. */
+agentInstance?: string | readonly string[];
+/** Exact provenance dimension predicates (`dimension=value`). */
+provenanceFilter?: string | readonly string[];
 }
 /** Normalize raw and full aliases into one explicit activity row projection. */
 export declare function normalizeActivityProjectionOptions(options: ActivityCommandOptions & {
-    full?: unknown;
+full?: unknown;
 }): ActivityCommandOptions;
 /** Documents the activity entry payload exchanged by command, SDK, and package integrations. */
 export interface ActivityEntry extends HistoryEntry {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
 }
 /** Documents the compact activity entry payload exchanged by command, SDK, and package integrations. */
 export interface CompactActivityEntry {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports op for this contract. */
-    op: string;
-    /** Value that configures or reports ts for this contract. */
-    ts: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Value that configures or reports msg for this contract. */
-    msg?: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports op for this contract. */
+op: string;
+/** Value that configures or reports ts for this contract. */
+ts: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Value that configures or reports msg for this contract. */
+msg?: string;
 }
 /** One item-centric summary of every matching immutable event for that item. */
 export interface ActivityDigestEntry {
-    /** Stable item identifier. */
-    id: string;
-    /** Current item type from the light metadata join. */
-    type: string;
-    /** Current lifecycle status from the light metadata join. */
-    status: string;
-    /** Current item title, bounded for predictable context cost. */
-    title: string;
-    /** Matching immutable events folded into this row. */
-    event_count: number;
-    /** Oldest matching event timestamp. */
-    first_ts: string;
-    /** Newest matching event timestamp. */
-    last_ts: string;
-    /** Bounded operation histogram encoded as comma-separated op:count pairs. */
-    operations: string;
+/** Stable item identifier. */
+id: string;
+/** Current item type from the light metadata join. */
+type: string;
+/** Current lifecycle status from the light metadata join. */
+status: string;
+/** Current item title, bounded for predictable context cost. */
+title: string;
+/** Matching immutable events folded into this row. */
+event_count: number;
+/** Oldest matching event timestamp. */
+first_ts: string;
+/** Newest matching event timestamp. */
+last_ts: string;
+/** Bounded operation histogram encoded as comma-separated op:count pairs. */
+operations: string;
 }
 /** Documents the activity result payload exchanged by command, SDK, and package integrations. */
 export interface ActivityResult {
-    /** Default item-centric workspace activity rows. */
-    activity_digest?: ActivityDigestEntry[];
-    /** Value that configures or reports activity for this contract. */
-    activity?: ActivityEntry[];
-    /** Value that configures or reports compact activity for this contract. */
-    compact_activity?: CompactActivityEntry[];
-    /** Patch-free immutable provenance rows. */
-    provenance_activity?: HistoryProvenanceRow[];
-    /** Value that configures or reports compact for this contract. */
-    compact: boolean;
-    /** Explicit active row projection. */
-    projection: {
-        /** Stable projection mode. */
-        mode: "digest" | "compact" | "provenance" | "full";
-        /** Active row collection key. */
-        row_key: "activity_digest" | "compact_activity" | "provenance_activity" | "activity";
-    };
-    /** Constant-size disclosure of field groups withheld by the active mode. */
-    omission_receipt: OutputOmissionReceipt;
-    /** Value that configures or reports count for this contract. */
-    count: number;
-    /** Total matching rows before the applied bound. */
-    total_count: number;
-    /** Value that configures or reports limit for this contract. */
-    limit: number | null;
-    /** Number of matching rows withheld by the applied bound. */
-    omitted_count: number;
-    /** Whether matching rows remain available through a larger or unbounded request. */
-    has_more: boolean;
-    /** Describes whether the effective bound came from a default, caller input, or an explicit opt-out. */
-    applied_bound: {
-        kind: "limit" | "unbounded";
-        source: "default" | "explicit";
-        value: number | null;
-    };
-    /** Constant-size description of the selected time window and matching corpus. */
-    activity_summary?: {
-        window: {
-            from: string | null;
-            to: string | null;
-        };
-        event_count: number;
-        item_count: number;
-        author_count: number;
-        operation_counts: Record<string, number>;
-    };
-    /** Constant-size provenance completeness metrics. */
-    provenance_summary?: HistoryProvenanceSummary;
+/** Default item-centric workspace activity rows. */
+activity_digest?: ActivityDigestEntry[];
+/** Value that configures or reports activity for this contract. */
+activity?: ActivityEntry[];
+/** Value that configures or reports compact activity for this contract. */
+compact_activity?: CompactActivityEntry[];
+/** Patch-free immutable provenance rows. */
+provenance_activity?: HistoryProvenanceRow[];
+/** Value that configures or reports compact for this contract. */
+compact: boolean;
+/** Explicit active row projection. */
+projection: {
+/** Stable projection mode. */
+mode: "digest" | "compact" | "provenance" | "full";
+/** Active row collection key. */
+row_key: "activity_digest" | "compact_activity" | "provenance_activity" | "activity";
+};
+/** Constant-size disclosure of field groups withheld by the active mode. */
+omission_receipt: OutputOmissionReceipt;
+/** Value that configures or reports count for this contract. */
+count: number;
+/** Total matching rows before the applied bound. */
+total_count: number;
+/** Value that configures or reports limit for this contract. */
+limit: number | null;
+/** Number of matching rows withheld by the applied bound. */
+omitted_count: number;
+/** Whether matching rows remain available through a larger or unbounded request. */
+has_more: boolean;
+/** Describes whether the effective bound came from a default, caller input, or an explicit opt-out. */
+applied_bound: {
+kind: "limit" | "unbounded";
+source: "default" | "explicit";
+value: number | null;
+};
+/** Constant-size description of the selected time window and matching corpus. */
+activity_summary?: {
+window: {
+from: string | null;
+to: string | null;
+};
+event_count: number;
+item_count: number;
+author_count: number;
+operation_counts: Record<string, number>;
+};
+/** Constant-size provenance completeness metrics. */
+provenance_summary?: HistoryProvenanceSummary;
 }
 interface ActivityItemMetadata {
-    title: string;
-    type: string;
-    status: string;
+title: string;
+type: string;
+status: string;
 }
 declare function parseNonEmptyFilter(raw: string | undefined, flagLabel: string): string | undefined;
 declare function parseRangeBound(raw: string | undefined, nowValue: string, fieldLabel: string): string | undefined;
@@ -142,16 +142,16 @@ declare function buildActivityDigest(activity: readonly ActivityEntry[], itemsBy
 declare function activityOperationCounts(activity: readonly Pick<ActivityEntry, "op">[]): Record<string, number>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    parseNonEmptyFilter: typeof parseNonEmptyFilter;
-    parseRangeBound: typeof parseRangeBound;
-    includeByTimeWindow: typeof includeByTimeWindow;
-    limitEntries: typeof limitEntries;
-    readActivityString: typeof readActivityString;
-    normalizeActivityEntry: typeof normalizeActivityEntry;
-    sortActivity: typeof sortActivity;
-    listHistoryFiles: typeof listHistoryFiles;
-    buildActivityDigest: typeof buildActivityDigest;
-    activityOperationCounts: typeof activityOperationCounts;
+parseNonEmptyFilter: typeof parseNonEmptyFilter;
+parseRangeBound: typeof parseRangeBound;
+includeByTimeWindow: typeof includeByTimeWindow;
+limitEntries: typeof limitEntries;
+readActivityString: typeof readActivityString;
+normalizeActivityEntry: typeof normalizeActivityEntry;
+sortActivity: typeof sortActivity;
+listHistoryFiles: typeof listHistoryFiles;
+buildActivityDigest: typeof buildActivityDigest;
+activityOperationCounts: typeof activityOperationCounts;
 };
 /** Implements run activity for the public runtime surface of this module. */
 export declare function runActivity(options: ActivityCommandOptions, global: GlobalOptions): Promise<ActivityResult>;

package/dist/sdk/query/aggregate.d.ts

@@ -9,138 +9,138 @@ type AggregateGroupField = "parent" | "type" | "priority" | "status" | "assignee
 type AggregateGroupValue = string | number | null;
 type AggregateGroupRecord = Partial<Record<AggregateGroupField, AggregateGroupValue>>;
 type AggregateListedItem = {
-    type: string;
-    status: ItemStatus;
-    priority: number;
-    parent?: string;
-    assignee?: string;
-    tags: string[];
-    sprint?: string;
-    release?: string;
+type: string;
+status: ItemStatus;
+priority: number;
+parent?: string;
+assignee?: string;
+tags: string[];
+sprint?: string;
+release?: string;
 };
 /** Documents the aggregate options payload exchanged by command, SDK, and package integrations. */
 export interface AggregateOptions {
-    /** Value that configures or reports group by for this contract. */
-    groupBy?: string;
-    /** Group array fields by distinct element (default), or by their entire normalized tuple. */
-    setMode?: string;
-    /** Maximum emitted groups, defaulting to 50 independently of input item count. */
-    limit?: string | number;
-    /** Resume after the exact group cursor returned by the preceding page. */
-    after?: string;
-    /** Value that configures or reports count for this contract. */
-    count?: boolean;
-    /** Value that configures or reports completion for this contract. */
-    completion?: boolean;
-    /** Value that configures or reports sum for this contract. */
-    sum?: string;
-    /** Value that configures or reports avg for this contract. */
-    avg?: string;
-    /** Value that configures or reports include unparented for this contract. */
-    includeUnparented?: boolean;
-    /** Lifecycle state reported for status. */
-    status?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: string;
-    /** Value that configures or reports tag for this contract. */
-    tag?: string;
-    /** Value that configures or reports priority for this contract. */
-    priority?: string;
-    /** Value that configures or reports deadline before for this contract. */
-    deadlineBefore?: string;
-    /** Value that configures or reports deadline after for this contract. */
-    deadlineAfter?: string;
-    /** Value that configures or reports assignee for this contract. */
-    assignee?: string;
-    /** Value that configures or reports assignee filter for this contract. */
-    assigneeFilter?: string;
-    /** Value that configures or reports parent for this contract. */
-    parent?: 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 group by for this contract. */
+groupBy?: string;
+/** Group array fields by distinct element (default), or by their entire normalized tuple. */
+setMode?: string;
+/** Maximum emitted groups, defaulting to 50 independently of input item count. */
+limit?: string | number;
+/** Resume after the exact group cursor returned by the preceding page. */
+after?: string;
+/** Value that configures or reports count for this contract. */
+count?: boolean;
+/** Value that configures or reports completion for this contract. */
+completion?: boolean;
+/** Value that configures or reports sum for this contract. */
+sum?: string;
+/** Value that configures or reports avg for this contract. */
+avg?: string;
+/** Value that configures or reports include unparented for this contract. */
+includeUnparented?: boolean;
+/** Lifecycle state reported for status. */
+status?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: string;
+/** Value that configures or reports tag for this contract. */
+tag?: string;
+/** Value that configures or reports priority for this contract. */
+priority?: string;
+/** Value that configures or reports deadline before for this contract. */
+deadlineBefore?: string;
+/** Value that configures or reports deadline after for this contract. */
+deadlineAfter?: string;
+/** Value that configures or reports assignee for this contract. */
+assignee?: string;
+/** Value that configures or reports assignee filter for this contract. */
+assigneeFilter?: string;
+/** Value that configures or reports parent for this contract. */
+parent?: string;
+/** Value that configures or reports sprint for this contract. */
+sprint?: string;
+/** Value that configures or reports release for this contract. */
+release?: string;
 }
 /** Documents the aggregate row payload exchanged by command, SDK, and package integrations. */
 export interface AggregateRow {
-    /** Value that configures or reports group for this contract. */
-    group: AggregateGroupRecord;
-    /** Human-readable display label for this group. Blank/null group values render with an explicit "(unassigned)"-style label (per dimension) so terminal and grep-based consumers are never faced with an ambiguous empty key. The structured `group` record keeps the raw null for machine consumers. */
-    group_label: string;
-    /** Value that configures or reports count for this contract. */
-    count: number;
-    /** Value that configures or reports open for this contract. */
-    open?: number;
-    /** Value that configures or reports in progress for this contract. */
-    in_progress?: number;
-    /** Value that configures or reports closed for this contract. */
-    closed?: number;
-    /** Value that configures or reports other for this contract. */
-    other?: number;
-    /** Value that configures or reports completion pct for this contract. */
-    completion_pct?: number;
-    /** Number of null entries represented by this result. */
-    null_count?: number;
-    /** Value that configures or reports sum for this contract. */
-    sum?: number | null;
-    /** Value that configures or reports avg for this contract. */
-    avg?: number | null;
+/** Value that configures or reports group for this contract. */
+group: AggregateGroupRecord;
+/** Human-readable display label for this group. Blank/null group values render with an explicit "(unassigned)"-style label (per dimension) so terminal and grep-based consumers are never faced with an ambiguous empty key. The structured `group` record keeps the raw null for machine consumers. */
+group_label: string;
+/** Value that configures or reports count for this contract. */
+count: number;
+/** Value that configures or reports open for this contract. */
+open?: number;
+/** Value that configures or reports in progress for this contract. */
+in_progress?: number;
+/** Value that configures or reports closed for this contract. */
+closed?: number;
+/** Value that configures or reports other for this contract. */
+other?: number;
+/** Value that configures or reports completion pct for this contract. */
+completion_pct?: number;
+/** Number of null entries represented by this result. */
+null_count?: number;
+/** Value that configures or reports sum for this contract. */
+sum?: number | null;
+/** Value that configures or reports avg for this contract. */
+avg?: number | null;
 }
 /** Documents the aggregate result payload exchanged by command, SDK, and package integrations. */
 export interface AggregateResult {
-    /** Value that configures or reports groups for this contract. */
-    groups: AggregateRow[];
-    /** Value that configures or reports count for this contract. */
-    count: number;
-    /** Number of groups in this page. */
-    returned_count: number;
-    /** Whether additional groups remain after this page. */
-    truncated: boolean;
-    /** Exact group-key cursor for the next page, or null when complete. */
-    next_after: string | null;
-    /** Value that configures or reports totals for this contract. */
-    totals: {
-        items_considered: number;
-        items_grouped: number;
-        items_skipped_unparented: number;
-        /** Membership contributions; may exceed items_grouped when an item belongs to several groups. */
-        group_memberships: number;
-    };
-    /** Value that configures or reports filters for this contract. */
-    filters: {
-        group_by: AggregateGroupField[];
-        /** Declared interpretation of every set-valued grouping dimension. */
-        set_mode: "element" | "tuple";
-        count: boolean;
-        completion: boolean;
-        sum?: string | null;
-        avg?: string | null;
-        numeric_field?: string | null;
-        include_unparented: boolean;
-        status: ItemStatus | null;
-        /** Concrete validated statuses supplied through the OR-composed selector. */
-        status_values?: ItemStatus[];
-        type: string | null;
-        tag: string | null;
-        priority: string | null;
-        deadline_before: string | null;
-        deadline_after: string | null;
-        assignee: string | null;
-        assignee_filter: string | null;
-        parent: string | null;
-        sprint: string | null;
-        release: string | null;
-    };
-    /** Value that configures or reports now for this contract. */
-    now: string;
-    /** Value that configures or reports warnings for this contract. */
-    warnings?: string[];
+/** Value that configures or reports groups for this contract. */
+groups: AggregateRow[];
+/** Value that configures or reports count for this contract. */
+count: number;
+/** Number of groups in this page. */
+returned_count: number;
+/** Whether additional groups remain after this page. */
+truncated: boolean;
+/** Exact group-key cursor for the next page, or null when complete. */
+next_after: string | null;
+/** Value that configures or reports totals for this contract. */
+totals: {
+items_considered: number;
+items_grouped: number;
+items_skipped_unparented: number;
+/** Membership contributions; may exceed items_grouped when an item belongs to several groups. */
+group_memberships: number;
+};
+/** Value that configures or reports filters for this contract. */
+filters: {
+group_by: AggregateGroupField[];
+/** Declared interpretation of every set-valued grouping dimension. */
+set_mode: "element" | "tuple";
+count: boolean;
+completion: boolean;
+sum?: string | null;
+avg?: string | null;
+numeric_field?: string | null;
+include_unparented: boolean;
+status: ItemStatus | null;
+/** Concrete validated statuses supplied through the OR-composed selector. */
+status_values?: ItemStatus[];
+type: string | null;
+tag: string | null;
+priority: string | null;
+deadline_before: string | null;
+deadline_after: string | null;
+assignee: string | null;
+assignee_filter: string | null;
+parent: string | null;
+sprint: string | null;
+release: string | null;
+};
+/** Value that configures or reports now for this contract. */
+now: string;
+/** Value that configures or reports warnings for this contract. */
+warnings?: string[];
 }
 declare function parseStatus(raw: string | undefined, statusRegistry: RuntimeStatusRegistry): ItemStatus[] | undefined;
 interface NumericAggregation {
-    field: string;
-    sum: boolean;
-    avg: boolean;
+field: string;
+sum: boolean;
+avg: boolean;
 }
 declare function parseNumericAggregation(options: AggregateOptions, allowedFields?: readonly string[]): NumericAggregation | null;
 declare function parseGroupBy(raw: string | undefined): AggregateGroupField[];
@@ -151,15 +151,15 @@ declare function buildGroupKey(groupBy: AggregateGroupField[], group: AggregateG
 declare function compareAggregateRows(left: AggregateRow, right: AggregateRow, groupBy: AggregateGroupField[]): number;
 declare function readNumericAggregateValue(item: AggregateListedItem, field: string): number | null;
 interface AggregateAccumulator {
-    /** group_label is derived once at finalization, so the accumulator omits it. */
-    row: Omit<AggregateRow, "group_label">;
-    numeric_count: number;
-    numeric_sum: number;
-    null_count: number;
-    open_count: number;
-    in_progress_count: number;
-    closed_count: number;
-    other_count: number;
+/** group_label is derived once at finalization, so the accumulator omits it. */
+row: Omit<AggregateRow, "group_label">;
+numeric_count: number;
+numeric_sum: number;
+null_count: number;
+open_count: number;
+in_progress_count: number;
+closed_count: number;
+other_count: number;
 }
 declare function completionPct(closed: number, total: number): number;
 declare function updateCompletionCounts(accumulator: AggregateAccumulator, status: ItemStatus, statusRegistry: RuntimeStatusRegistry): void;
@@ -167,16 +167,16 @@ declare function updateCompletionCounts(accumulator: AggregateAccumulator, statu
 export declare function runAggregate(options: AggregateOptions, global: GlobalOptions): Promise<AggregateResult>;
 /** Public contract for test only aggregate command, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyAggregateCommand: {
-    buildGroupKey: typeof buildGroupKey;
-    compareAggregateRows: typeof compareAggregateRows;
-    compareNullableGroupValue: typeof compareNullableGroupValue;
-    completionPct: typeof completionPct;
-    normalizeTagGroupValue: typeof normalizeTagGroupValue;
-    parseGroupBy: typeof parseGroupBy;
-    parseNumericAggregation: typeof parseNumericAggregation;
-    parseStatus: typeof parseStatus;
-    readNumericAggregateValue: typeof readNumericAggregateValue;
-    resolveGroupValue: typeof resolveGroupValue;
-    updateCompletionCounts: typeof updateCompletionCounts;
+buildGroupKey: typeof buildGroupKey;
+compareAggregateRows: typeof compareAggregateRows;
+compareNullableGroupValue: typeof compareNullableGroupValue;
+completionPct: typeof completionPct;
+normalizeTagGroupValue: typeof normalizeTagGroupValue;
+parseGroupBy: typeof parseGroupBy;
+parseNumericAggregation: typeof parseNumericAggregation;
+parseStatus: typeof parseStatus;
+readNumericAggregateValue: typeof readNumericAggregateValue;
+resolveGroupValue: typeof resolveGroupValue;
+updateCompletionCounts: typeof updateCompletionCounts;
 };
 export {};