@unbrained/pm-cli 2026.10.13 → 2026.10.15

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

@@ -1,158 +1,158 @@
 import { type GlobalOptions } from "../runtime-primitives.js";
 import type { HistoryEntry } from "../../types/index.js";
 import { type OutputOmissionReceipt } from "../output-projection.js";
-import { type HistoryProvenanceRow, type HistoryProvenanceSummary } from "../history-provenance.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;
+id?:string;
 /** Value that configures or reports op for this contract. */
-op?: string;
+op?:string;
 /** Value that configures or reports author for this contract. */
-author?: string;
+author?:string;
 /** Value that configures or reports from for this contract. */
-from?: string;
+from?:string;
 /** Value that configures or reports to for this contract. */
-to?: string;
+to?:string;
 /** Value that configures or reports limit for this contract. */
-limit?: string;
+limit?:string;
 /** Value that configures or reports compact for this contract. */
-compact?: boolean;
+compact?:boolean;
 /** Return the legacy per-event stream instead of the item-centric digest. */
-raw?: boolean;
+raw?:boolean;
 /** Explicitly disables the default activity bound. */
-unbounded?: boolean;
+unbounded?:boolean;
 /** Return patch-free provenance rows. */
-provenance?: boolean;
+provenance?:boolean;
 /** Include constant-size provenance completeness metrics. */
-provenanceSummary?: boolean;
+provenanceSummary?:boolean;
 /** Filter by canonical recorded or vocabulary-resolved harness. */
-harness?: string | readonly string[];
+harness?:string | readonly string[];
 /** Filter by privacy-safe invocation fingerprint. */
-agentInstance?: string | readonly string[];
+agentInstance?:string | readonly string[];
 /** Exact provenance dimension predicates (`dimension=value`). */
-provenanceFilter?: string | readonly string[];
+provenanceFilter?:string | readonly string[];
 }
 /** Normalize raw and full aliases into one explicit activity row projection. */
-export declare function normalizeActivityProjectionOptions(options: ActivityCommandOptions & {
-full?: unknown;
-}): ActivityCommandOptions;
+export declare function normalizeActivityProjectionOptions(options:ActivityCommandOptions & {
+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;
+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;
+id:string;
 /** Value that configures or reports op for this contract. */
-op: string;
+op:string;
 /** Value that configures or reports ts for this contract. */
-ts: string;
+ts:string;
 /** Value that configures or reports author for this contract. */
-author: string;
+author:string;
 /** Value that configures or reports msg for this contract. */
-msg?: string;
+msg?:string;
 }
 /** One item-centric summary of every matching immutable event for that item. */
 export interface ActivityDigestEntry {
 /** Stable item identifier. */
-id: string;
+id:string;
 /** Current item type from the light metadata join. */
-type: string;
+type:string;
 /** Current lifecycle status from the light metadata join. */
-status: string;
+status:string;
 /** Current item title, bounded for predictable context cost. */
-title: string;
+title:string;
 /** Matching immutable events folded into this row. */
-event_count: number;
+event_count:number;
 /** Oldest matching event timestamp. */
-first_ts: string;
+first_ts:string;
 /** Newest matching event timestamp. */
-last_ts: string;
+last_ts:string;
 /** Bounded operation histogram encoded as comma-separated op:count pairs. */
-operations: string;
+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[];
+activity_digest?:ActivityDigestEntry[];
 /** Value that configures or reports activity for this contract. */
-activity?: ActivityEntry[];
+activity?:ActivityEntry[];
 /** Value that configures or reports compact activity for this contract. */
-compact_activity?: CompactActivityEntry[];
+compact_activity?:CompactActivityEntry[];
 /** Patch-free immutable provenance rows. */
-provenance_activity?: HistoryProvenanceRow[];
+provenance_activity?:HistoryProvenanceRow[];
 /** Value that configures or reports compact for this contract. */
-compact: boolean;
+compact:boolean;
 /** Explicit active row projection. */
-projection: {
+projection:{
 /** Stable projection mode. */
-mode: "digest" | "compact" | "provenance" | "full";
+mode:"digest" | "compact" | "provenance" | "full";
 /** Active row collection key. */
-row_key: "activity_digest" | "compact_activity" | "provenance_activity" | "activity";
+row_key:"activity_digest" | "compact_activity" | "provenance_activity" | "activity";
 };
 /** Constant-size disclosure of field groups withheld by the active mode. */
-omission_receipt: OutputOmissionReceipt;
+omission_receipt:OutputOmissionReceipt;
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Total matching rows before the applied bound. */
-total_count: number;
+total_count:number;
 /** Value that configures or reports limit for this contract. */
-limit: number | null;
+limit:number | null;
 /** Number of matching rows withheld by the applied bound. */
-omitted_count: number;
+omitted_count:number;
 /** Whether matching rows remain available through a larger or unbounded request. */
-has_more: boolean;
+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;
+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;
+activity_summary?:{
+window:{
+from:string | null;
+to:string | null;
 };
-event_count: number;
-item_count: number;
-author_count: number;
-operation_counts: Record<string, number>;
+event_count:number;
+item_count:number;
+author_count:number;
+operation_counts:Record<string,number>;
 };
 /** Constant-size provenance completeness metrics. */
-provenance_summary?: HistoryProvenanceSummary;
+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;
-declare function includeByTimeWindow(entry: ActivityEntry, from: string | undefined, to: string | undefined): boolean;
-declare function limitEntries<T>(values: T[], limit: number | undefined): T[];
-declare function readActivityString(value: unknown, fallback?: string): string;
-declare function normalizeActivityEntry(id: string, entry: HistoryEntry): ActivityEntry;
-declare function sortActivity(entries: ActivityEntry[]): ActivityEntry[];
-declare function listHistoryFiles(historyDir: string): Promise<string[]>;
-declare function buildActivityDigest(activity: readonly ActivityEntry[], itemsById: ReadonlyMap<string, ActivityItemMetadata>): ActivityDigestEntry[];
-declare function activityOperationCounts(activity: readonly Pick<ActivityEntry, "op">[]): Record<string, number>;
+declare function parseNonEmptyFilter(raw:string | undefined,flagLabel:string):string | undefined;
+declare function parseRangeBound(raw:string | undefined,nowValue:string,fieldLabel:string):string | undefined;
+declare function includeByTimeWindow(entry:ActivityEntry,from:string | undefined,to:string | undefined):boolean;
+declare function limitEntries<T>(values:T[],limit:number | undefined):T[];
+declare function readActivityString(value:unknown,fallback?:string):string;
+declare function normalizeActivityEntry(id:string,entry:HistoryEntry):ActivityEntry;
+declare function sortActivity(entries:ActivityEntry[]):ActivityEntry[];
+declare function listHistoryFiles(historyDir:string):Promise<string[]>;
+declare function buildActivityDigest(activity:readonly ActivityEntry[],itemsById:ReadonlyMap<string,ActivityItemMetadata>):ActivityDigestEntry[];
+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;
+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;
 };
 /** Implements run activity for the public runtime surface of this module. */
-export declare function runActivity(options: ActivityCommandOptions, global: GlobalOptions): Promise<ActivityResult>;
+export declare function runActivity(options:ActivityCommandOptions,global:GlobalOptions):Promise<ActivityResult>;
 export {};

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

@@ -3,180 +3,180 @@
  *
  * Implements the pm aggregate command surface and its agent-facing runtime behavior.
  */
-import { type GlobalOptions, type RuntimeStatusRegistry } from "../runtime-primitives.js";
+import { type GlobalOptions,type RuntimeStatusRegistry } from "../runtime-primitives.js";
 import { type ItemStatus } from "../../types/index.js";
 type AggregateGroupField = "parent" | "type" | "priority" | "status" | "assignee" | "tags" | "sprint" | "release";
 type AggregateGroupValue = string | number | null;
-type AggregateGroupRecord = Partial<Record<AggregateGroupField, AggregateGroupValue>>;
+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;
+groupBy?:string;
 /** Group array fields by distinct element (default), or by their entire normalized tuple. */
-setMode?: string;
+setMode?:string;
 /** Maximum emitted groups, defaulting to 50 independently of input item count. */
-limit?: string | number;
+limit?:string | number;
 /** Resume after the exact group cursor returned by the preceding page. */
-after?: string;
+after?:string;
 /** Value that configures or reports count for this contract. */
-count?: boolean;
+count?:boolean;
 /** Value that configures or reports completion for this contract. */
-completion?: boolean;
+completion?:boolean;
 /** Value that configures or reports sum for this contract. */
-sum?: string;
+sum?:string;
 /** Value that configures or reports avg for this contract. */
-avg?: string;
+avg?:string;
 /** Value that configures or reports include unparented for this contract. */
-includeUnparented?: boolean;
+includeUnparented?:boolean;
 /** Lifecycle state reported for status. */
-status?: string;
+status?:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type?: string;
+type?:string;
 /** Value that configures or reports tag for this contract. */
-tag?: string;
+tag?:string;
 /** Value that configures or reports priority for this contract. */
-priority?: string;
+priority?:string;
 /** Value that configures or reports deadline before for this contract. */
-deadlineBefore?: string;
+deadlineBefore?:string;
 /** Value that configures or reports deadline after for this contract. */
-deadlineAfter?: string;
+deadlineAfter?:string;
 /** Value that configures or reports assignee for this contract. */
-assignee?: string;
+assignee?:string;
 /** Value that configures or reports assignee filter for this contract. */
-assigneeFilter?: string;
+assigneeFilter?:string;
 /** Value that configures or reports parent for this contract. */
-parent?: string;
+parent?: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;
 }
 /** 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;
+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;
+group_label:string;
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Value that configures or reports open for this contract. */
-open?: number;
+open?:number;
 /** Value that configures or reports in progress for this contract. */
-in_progress?: number;
+in_progress?:number;
 /** Value that configures or reports closed for this contract. */
-closed?: number;
+closed?:number;
 /** Value that configures or reports other for this contract. */
-other?: number;
+other?:number;
 /** Value that configures or reports completion pct for this contract. */
-completion_pct?: number;
+completion_pct?:number;
 /** Number of null entries represented by this result. */
-null_count?: number;
+null_count?:number;
 /** Value that configures or reports sum for this contract. */
-sum?: number | null;
+sum?:number | null;
 /** Value that configures or reports avg for this contract. */
-avg?: number | null;
+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[];
+groups:AggregateRow[];
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Number of groups in this page. */
-returned_count: number;
+returned_count:number;
 /** Whether additional groups remain after this page. */
-truncated: boolean;
+truncated:boolean;
 /** Exact group-key cursor for the next page, or null when complete. */
-next_after: string | null;
+next_after:string | null;
 /** Value that configures or reports totals for this contract. */
-totals: {
-items_considered: number;
-items_grouped: number;
-items_skipped_unparented: number;
+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;
+group_memberships:number;
 };
 /** Value that configures or reports filters for this contract. */
-filters: {
-group_by: AggregateGroupField[];
+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;
+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;
+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;
+now:string;
 /** Value that configures or reports warnings for this contract. */
-warnings?: string[];
+warnings?:string[];
 }
-declare function parseStatus(raw: string | undefined, statusRegistry: RuntimeStatusRegistry): ItemStatus[] | undefined;
+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[];
-declare function normalizeTagGroupValue(tags: string[]): string | null;
-declare function resolveGroupValue(field: AggregateGroupField, item: AggregateListedItem): AggregateGroupValue;
-declare function compareNullableGroupValue(left: AggregateGroupValue | undefined, right: AggregateGroupValue | undefined): number;
-declare function buildGroupKey(groupBy: AggregateGroupField[], group: AggregateGroupRecord): string;
-declare function compareAggregateRows(left: AggregateRow, right: AggregateRow, groupBy: AggregateGroupField[]): number;
-declare function readNumericAggregateValue(item: AggregateListedItem, field: string): number | null;
+declare function parseNumericAggregation(options:AggregateOptions,allowedFields?:readonly string[]):NumericAggregation | null;
+declare function parseGroupBy(raw:string | undefined):AggregateGroupField[];
+declare function normalizeTagGroupValue(tags:string[]):string | null;
+declare function resolveGroupValue(field:AggregateGroupField,item:AggregateListedItem):AggregateGroupValue;
+declare function compareNullableGroupValue(left:AggregateGroupValue | undefined,right:AggregateGroupValue | undefined):number;
+declare function buildGroupKey(groupBy:AggregateGroupField[],group:AggregateGroupRecord):string;
+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;
+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;
+declare function completionPct(closed:number,total:number):number;
+declare function updateCompletionCounts(accumulator:AggregateAccumulator,status:ItemStatus,statusRegistry:RuntimeStatusRegistry):void;
 /** Implements run aggregate for the public runtime surface of this module. */
-export declare function runAggregate(options: AggregateOptions, global: GlobalOptions): Promise<AggregateResult>;
+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;
+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;
 };
 export {};