@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/core/shared/split-comma-list.d.ts

@@ -5,12 +5,12 @@
  */
 /** Configures comma-list parsing for command flags that support escaped separators. */
 export interface SplitCommaListOptions {
-    /** Separator pattern. Defaults to `/,/`. */
-    separators?: RegExp | string;
-    /** De-duplicate entries while preserving first-seen order. Defaults to `true`. */
-    unique?: boolean;
-    /** Sort entries lexicographically (default JS string sort). Defaults to `false`. */
-    sort?: boolean;
+/** Separator pattern. Defaults to `/,/`. */
+separators?: RegExp | string;
+/** De-duplicate entries while preserving first-seen order. Defaults to `true`. */
+unique?: boolean;
+/** Sort entries lexicographically (default JS string sort). Defaults to `false`. */
+sort?: boolean;
 }
 /**
  * Split a comma-separated (or custom-separator) string into trimmed, non-empty entries.

package/dist/core/shared/time.d.ts

@@ -10,27 +10,27 @@ export declare function isMillisecondPrecisionRfc3339DateTime(input: string): bo
 export declare function compareTimestampStrings(left: string, right: string): number;
 /** Timestamp-bearing record accepted by shared inclusive bound filtering. */
 export interface TimestampedRecord {
-    /** Optional deadline timestamp. */
-    deadline?: string;
-    /** Last-update timestamp. */
-    updated_at: string;
-    /** Creation timestamp. */
-    created_at: string;
+/** Optional deadline timestamp. */
+deadline?: string;
+/** Last-update timestamp. */
+updated_at: string;
+/** Creation timestamp. */
+created_at: string;
 }
 /** Inclusive timestamp bounds shared by list and search filtering. */
 export interface TimestampFilterBounds {
-    /** Inclusive upper deadline bound. */
-    deadlineBefore?: string;
-    /** Inclusive lower deadline bound. */
-    deadlineAfter?: string;
-    /** Inclusive lower update-time bound. */
-    updatedAfter?: string;
-    /** Inclusive upper update-time bound. */
-    updatedBefore?: string;
-    /** Inclusive lower creation-time bound. */
-    createdAfter?: string;
-    /** Inclusive upper creation-time bound. */
-    createdBefore?: string;
+/** Inclusive upper deadline bound. */
+deadlineBefore?: string;
+/** Inclusive lower deadline bound. */
+deadlineAfter?: string;
+/** Inclusive lower update-time bound. */
+updatedAfter?: string;
+/** Inclusive upper update-time bound. */
+updatedBefore?: string;
+/** Inclusive lower creation-time bound. */
+createdAfter?: string;
+/** Inclusive upper creation-time bound. */
+createdBefore?: string;
 }
 /** Return whether a timestamp-bearing record satisfies every configured bound. */
 export declare function matchesTimestampFilters(item: TimestampedRecord, filters: TimestampFilterBounds): boolean;
@@ -43,10 +43,10 @@ declare function isWhitespaceCharacter(character: string | undefined): boolean;
 export declare function resolveIsoOrRelative(input: string, now?: Date, fieldLabel?: string): string;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    normalizeOffset: typeof normalizeOffset;
-    pushTimestampCandidate: typeof pushTimestampCandidate;
-    normalizeTimestampCandidates: typeof normalizeTimestampCandidates;
-    parseTimestampWithFallbacks: typeof parseTimestampWithFallbacks;
-    isWhitespaceCharacter: typeof isWhitespaceCharacter;
+normalizeOffset: typeof normalizeOffset;
+pushTimestampCandidate: typeof pushTimestampCandidate;
+normalizeTimestampCandidates: typeof normalizeTimestampCandidates;
+parseTimestampWithFallbacks: typeof parseTimestampWithFallbacks;
+isWhitespaceCharacter: typeof isWhitespaceCharacter;
 };
 export {};

package/dist/core/store/item-format-migration.d.ts

@@ -1,16 +1,16 @@
 import type { ItemFormat, RuntimeSchemaSettings } from "../../types/index.js";
 /** Documents the item format migration result payload exchanged by command, SDK, and package integrations. */
 export interface ItemFormatMigrationResult {
-    /** Value that configures or reports target format for this contract. */
-    target_format: ItemFormat;
-    /** Value that configures or reports scanned for this contract. */
-    scanned: number;
-    /** Value that configures or reports migrated for this contract. */
-    migrated: string[];
-    /** Value that configures or reports removed for this contract. */
-    removed: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports target format for this contract. */
+target_format: ItemFormat;
+/** Value that configures or reports scanned for this contract. */
+scanned: number;
+/** Value that configures or reports migrated for this contract. */
+migrated: string[];
+/** Value that configures or reports removed for this contract. */
+removed: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Implements migrate item files to format for the public runtime surface of this module. */
 export declare function migrateItemFilesToFormat(pmRoot: string, targetFormat: ItemFormat, op?: string, typeToFolder?: Record<string, string>, schema?: RuntimeSchemaSettings): Promise<ItemFormatMigrationResult>;

package/dist/core/store/item-metadata-cache.d.ts

@@ -5,19 +5,19 @@ export declare const DEFAULT_DERIVED_INDEX_MINIMUM_ITEMS = 500;
 export declare const HEAVY_METADATA_KEYS: readonly ["comments", "notes", "learnings", "files", "tests", "test_runs", "docs"];
 /** Controls whether derived-index writers may skip the cross-process lock below the scale threshold. */
 export interface ItemMetadataDerivedIndexLockOptions {
-    /** Require serialization even when the derived index is absent or contains fewer than the normal locking threshold. */
-    required?: boolean;
+/** Require serialization even when the derived index is absent or contains fewer than the normal locking threshold. */
+required?: boolean;
 }
 /** Documents the cached document candidate payload exchanged by command, SDK, and package integrations. */
 export interface CachedDocumentCandidate {
-    /** Value that configures or reports metadata for this contract. */
-    metadata: ItemMetadata;
-    /** Value that configures or reports body for this contract. */
-    body?: string;
-    /** Value that configures or reports item format for this contract. */
-    item_format: ItemFormat;
-    /** Filesystem path used for item resolution. */
-    item_path: string;
+/** Value that configures or reports metadata for this contract. */
+metadata: ItemMetadata;
+/** Value that configures or reports body for this contract. */
+body?: string;
+/** Value that configures or reports item format for this contract. */
+item_format: ItemFormat;
+/** Filesystem path used for item resolution. */
+item_path: string;
 }
 /**
  * Drop memoized envelopes. Exposed for tests; production invalidation is stat-driven
@@ -43,27 +43,27 @@ export declare function shouldRecordCachedDocumentCandidate(existingFormat: Item
 export declare function acquireItemMetadataDerivedIndexLock(pmRoot: string, author: string, options?: ItemMetadataDerivedIndexLockOptions): Promise<() => Promise<void>>;
 /** One authoritative item commit projected into the rebuildable index. */
 export interface ItemMetadataDerivedIndexMutation {
-    /** Tracker root containing the derived cache. */
-    pmRoot: string;
-    /** Preferred item format folded into the cache schema fingerprint. */
-    preferredFormat: ItemFormat | undefined;
-    /** Runtime item-type folder mapping. */
-    typeToFolder: Record<string, string>;
-    /** Runtime schema folded into the cache schema fingerprint. */
-    schema: RuntimeSchemaSettings | undefined;
-    /** Committed item path, or deleted item path when document is null. */
-    itemPath: string;
-    /** Previous path removed by a format or type migration. */
-    previousItemPath?: string;
-    /** Committed document, or null for deletion. */
-    document: ItemDocument | null;
+/** Tracker root containing the derived cache. */
+pmRoot: string;
+/** Preferred item format folded into the cache schema fingerprint. */
+preferredFormat: ItemFormat | undefined;
+/** Runtime item-type folder mapping. */
+typeToFolder: Record<string, string>;
+/** Runtime schema folded into the cache schema fingerprint. */
+schema: RuntimeSchemaSettings | undefined;
+/** Committed item path, or deleted item path when document is null. */
+itemPath: string;
+/** Previous path removed by a format or type migration. */
+previousItemPath?: string;
+/** Committed document, or null for deletion. */
+document: ItemDocument | null;
 }
 /** Read-only identity of the effective rebuildable metadata projection. */
 export interface ItemMetadataDerivedIndexState {
-    /** Cursor shared by the base manifest and its collapsed mutation delta. */
-    source_cursor: string;
-    /** Number of authoritative rows recorded when the base manifest was built. */
-    entry_count: number;
+/** Cursor shared by the base manifest and its collapsed mutation delta. */
+source_cursor: string;
+/** Number of authoritative rows recorded when the base manifest was built. */
+entry_count: number;
 }
 /** Read the effective derived-index cursor without exposing cache file layout. */
 export declare function readItemMetadataDerivedIndexState(pmRoot: string, folders?: readonly string[]): Promise<ItemMetadataDerivedIndexState | null>;
@@ -79,16 +79,16 @@ export declare function readItemMetadataDerivedIndexState(pmRoot: string, folder
 export declare function refreshItemMetadataDerivedIndex(mutation: ItemMetadataDerivedIndexMutation): Promise<string[]>;
 /** Documents the list cache options payload exchanged by command, SDK, and package integrations. */
 export interface ListCacheOptions {
-    /** When false, item bodies are neither loaded from nor written to the separate body cache. Metadata-only callers (`pm list`, stats, deps, activity, …) skip the large body cache entirely; only body consumers (search/reindex) pay for it. */
-    includeBody?: boolean;
-    /** When false, heavy collection fields (comments/notes/learnings/files/tests/ test_runs/docs) are neither loaded from nor written to the separate collections cache, and are absent from the returned metadata. Light-only callers (`pm list` compact, stats, deps, activity, calendar, close) skip the large collections cache entirely. Defaults to true so any caller that does read those fields stays correct. */
-    includeCollections?: boolean;
-    /** Force canonical item enumeration and authoritative file reads even when stat-matched cache tiers or a fresh derived index are available. Validation, repair, migration, and equivalence tests use this correctness path. */
-    forceSourceScan?: boolean;
-    /** Minimum item count required before the directory-signature derived-index fast path is used. Defaults to 500 so small workspaces preserve per-file external-edit detection; tests and specialized SDK hosts may lower it explicitly. */
-    derivedIndexMinimumItems?: number;
-    /** Optional cache-rebuild diagnostics kept separate from item-read warnings. */
-    cacheDiagnostics?: string[];
+/** When false, item bodies are neither loaded from nor written to the separate body cache. Metadata-only callers (`pm list`, stats, deps, activity, …) skip the large body cache entirely; only body consumers (search/reindex) pay for it. */
+includeBody?: boolean;
+/** When false, heavy collection fields (comments/notes/learnings/files/tests/ test_runs/docs) are neither loaded from nor written to the separate collections cache, and are absent from the returned metadata. Light-only callers (`pm list` compact, stats, deps, activity, calendar, close) skip the large collections cache entirely. Defaults to true so any caller that does read those fields stays correct. */
+includeCollections?: boolean;
+/** Force canonical item enumeration and authoritative file reads even when stat-matched cache tiers or a fresh derived index are available. Validation, repair, migration, and equivalence tests use this correctness path. */
+forceSourceScan?: boolean;
+/** Minimum item count required before the directory-signature derived-index fast path is used. Defaults to 500 so small workspaces preserve per-file external-edit detection; tests and specialized SDK hosts may lower it explicitly. */
+derivedIndexMinimumItems?: number;
+/** Optional cache-rebuild diagnostics kept separate from item-read warnings. */
+cacheDiagnostics?: string[];
 }
 /**
  * List all item documents using a persistent on-disk metadata cache.

package/dist/core/store/item-metadata-query-index.d.ts

@@ -4,80 +4,80 @@ import { loadDatabaseSync, loadStableDatabaseSync } from "./sqlite-runtime.js";
 type DatabaseSyncConstructor = typeof DatabaseSync;
 /** One light-metadata row projected into the persistent query index. */
 export interface ItemMetadataQueryIndexRow {
-    /** Tracker-relative authoritative item path. */
-    relativePath: string;
-    /** Light item metadata serialized into the row store. */
-    metadata: ItemMetadata;
-    /** Heavy linked-file records projected separately for reverse traceability. */
-    linkedFiles?: readonly LinkedFile[];
+/** Tracker-relative authoritative item path. */
+relativePath: string;
+/** Light item metadata serialized into the row store. */
+metadata: ItemMetadata;
+/** Heavy linked-file records projected separately for reverse traceability. */
+linkedFiles?: readonly LinkedFile[];
 }
 /** Selection supported directly by the persistent metadata query index. */
 export interface ItemMetadataIndexQuery {
-    /** Include only these lifecycle statuses. */
-    statuses?: readonly string[];
-    /** Exclude these lifecycle statuses. */
-    excludeStatuses?: readonly string[];
-    /** Statuses sorted after active rows by the default list ordering contract. */
-    terminalStatuses?: readonly string[];
-    /** Include only these item types. */
-    types?: readonly string[];
-    /** Include only these exact item identifiers. */
-    ids?: readonly string[];
-    /** Include only rows that define every requested metadata key. */
-    metadataKeys?: readonly string[];
-    /** Include only direct children of this item. */
-    parent?: string;
-    /** Include only this assignee value. */
-    assignee?: string;
-    /** Include only this sprint value. */
-    sprint?: string;
-    /** Include only this release value. */
-    release?: string;
-    /** Include only this numeric priority. */
-    priority?: number;
-    /** Maximum rows returned after deterministic default ordering. */
-    limit?: number;
-    /** Number of ordered rows skipped before returning results. */
-    offset?: number;
+/** Include only these lifecycle statuses. */
+statuses?: readonly string[];
+/** Exclude these lifecycle statuses. */
+excludeStatuses?: readonly string[];
+/** Statuses sorted after active rows by the default list ordering contract. */
+terminalStatuses?: readonly string[];
+/** Include only these item types. */
+types?: readonly string[];
+/** Include only these exact item identifiers. */
+ids?: readonly string[];
+/** Include only rows that define every requested metadata key. */
+metadataKeys?: readonly string[];
+/** Include only direct children of this item. */
+parent?: string;
+/** Include only this assignee value. */
+assignee?: string;
+/** Include only this sprint value. */
+sprint?: string;
+/** Include only this release value. */
+release?: string;
+/** Include only this numeric priority. */
+priority?: number;
+/** Maximum rows returned after deterministic default ordering. */
+limit?: number;
+/** Number of ordered rows skipped before returning results. */
+offset?: number;
 }
 /** Bounded query result carrying total match count and index provenance. */
 export interface ItemMetadataIndexQueryResult {
-    /** Effective index source cursor. */
-    source_cursor: string;
-    /** Total matching rows before offset and limit. */
-    total: number;
-    /** Ordered light metadata rows in the requested window. */
-    items: ItemMetadata[];
+/** Effective index source cursor. */
+source_cursor: string;
+/** Total matching rows before offset and limit. */
+total: number;
+/** Ordered light metadata rows in the requested window. */
+items: ItemMetadata[];
 }
 /** Bounded lexical candidate result from the persistent metadata projection. */
 export interface SimilarItemMetadataIndexResult {
-    /** Effective index source cursor. */
-    source_cursor: string;
-    /** FTS-ranked light metadata candidates. */
-    items: ItemMetadata[];
+/** Effective index source cursor. */
+source_cursor: string;
+/** FTS-ranked light metadata candidates. */
+items: ItemMetadata[];
 }
 /** One indexed item and the requested linked-file records that reference it. */
 export interface IndexedLinkedFileMatch {
-    /** Light metadata for the referencing item. */
-    item: ItemMetadata;
-    /** Exact linked-file records matching the requested paths and optional scope. */
-    files: LinkedFile[];
+/** Light metadata for the referencing item. */
+item: ItemMetadata;
+/** Exact linked-file records matching the requested paths and optional scope. */
+files: LinkedFile[];
 }
 /** Bounded reverse linked-file query result from the persistent projection. */
 export interface LinkedFileMetadataIndexResult {
-    /** Effective index source cursor. */
-    source_cursor: string;
-    /** Total matching items before offset and limit. */
-    total: number;
-    /** Deterministically ordered referencing items in the requested window. */
-    matches: IndexedLinkedFileMatch[];
+/** Effective index source cursor. */
+source_cursor: string;
+/** Total matching items before offset and limit. */
+total: number;
+/** Deterministically ordered referencing items in the requested window. */
+matches: IndexedLinkedFileMatch[];
 }
 /** Atomically rebuild the complete query projection from authoritative cache rows. */
 export declare function rebuildItemMetadataQueryIndex(options: {
-    pmRoot: string;
-    contextFingerprint: string;
-    sourceCursor: string;
-    rows: readonly ItemMetadataQueryIndexRow[];
+pmRoot: string;
+contextFingerprint: string;
+sourceCursor: string;
+rows: readonly ItemMetadataQueryIndexRow[];
 }): Promise<void>;
 /**
  * Apply one authoritative metadata mutation in the same writer critical
@@ -85,12 +85,12 @@ export declare function rebuildItemMetadataQueryIndex(options: {
  * callers can remove and lazily rebuild this optional projection.
  */
 export declare function updateItemMetadataQueryIndex(options: {
-    pmRoot: string;
-    contextFingerprint: string;
-    expectedSourceCursor: string;
-    sourceCursor: string;
-    row: ItemMetadataQueryIndexRow | null;
-    deletedRelativePaths?: readonly string[];
+pmRoot: string;
+contextFingerprint: string;
+expectedSourceCursor: string;
+sourceCursor: string;
+row: ItemMetadataQueryIndexRow | null;
+deletedRelativePaths?: readonly string[];
 }): Promise<boolean>;
 /**
  * Query the persistent projection without materializing the full metadata
@@ -98,9 +98,9 @@ export declare function updateItemMetadataQueryIndex(options: {
  * extension read hooks require canonical per-document dispatch.
  */
 export declare function queryItemMetadataIndex(options: {
-    pmRoot: string;
-    expectedSourceCursor: string;
-    query?: ItemMetadataIndexQuery;
+pmRoot: string;
+expectedSourceCursor: string;
+query?: ItemMetadataIndexQuery;
 }): Promise<ItemMetadataIndexQueryResult | null>;
 /**
  * Resolve items that link any requested project-relative path without loading
@@ -108,30 +108,30 @@ export declare function queryItemMetadataIndex(options: {
  * stale, or corrupt so callers can fall back to authoritative item reads.
  */
 export declare function queryLinkedFileMetadataIndex(options: {
-    pmRoot: string;
-    expectedSourceCursor: string;
-    paths: readonly string[];
-    scope?: LinkScope;
-    limit?: number;
-    offset?: number;
+pmRoot: string;
+expectedSourceCursor: string;
+paths: readonly string[];
+scope?: LinkScope;
+limit?: number;
+offset?: number;
 }): Promise<LinkedFileMetadataIndexResult | null>;
 /**
  * Query FTS-ranked item candidates without materializing the workspace. The
  * caller owns final similarity scoring and threshold semantics.
  */
 export declare function querySimilarItemMetadataIndex(options: {
-    pmRoot: string;
-    expectedSourceCursor: string;
-    query: string;
-    limit: number;
+pmRoot: string;
+expectedSourceCursor: string;
+query: string;
+limit: number;
 }): Promise<SimilarItemMetadataIndexResult | null>;
 /** Remove only the optional SQLite query projection. */
 export declare function removeItemMetadataQueryIndex(pmRoot: string): Promise<void>;
 /** Test-only dependency seam for runtimes that do not implement node:sqlite. */
 export declare const _testOnly: {
-    loadDatabaseSync: typeof loadDatabaseSync;
-    loadStableDatabaseSync: typeof loadStableDatabaseSync;
-    /** Replace the optional constructor and return a restoration callback. */
-    setDatabaseSync(databaseSync: DatabaseSyncConstructor | null): () => void;
+loadDatabaseSync: typeof loadDatabaseSync;
+loadStableDatabaseSync: typeof loadStableDatabaseSync;
+/** Replace the optional constructor and return a restoration callback. */
+setDatabaseSync(databaseSync: DatabaseSyncConstructor | null): () => void;
 };
 export {};

package/dist/core/store/item-metadata-read-work.d.ts

@@ -1,9 +1,9 @@
 /** Logical metadata work, independent of output projection and cache hit rate. */
 export interface ItemMetadataReadWork {
-    /** Completed full, light, or body-bearing item-store enumeration calls. */
-    enumeration_calls: number;
-    /** Metadata rows returned by those calls, counting repeated enumeration. */
-    metadata_rows: number;
+/** Completed full, light, or body-bearing item-store enumeration calls. */
+enumeration_calls: number;
+/** Metadata rows returned by those calls, counting repeated enumeration. */
+metadata_rows: number;
 }
 /** Record completed enumeration in each enclosing measurement, without retaining item data. */
 export declare function recordItemMetadataEnumeration(rowCount: number): void;
@@ -14,6 +14,6 @@ export declare function recordItemMetadataEnumeration(rowCount: number): void;
  * Counters cover filesystem item-store enumeration APIs, not arbitrary host I/O.
  */
 export declare function measureItemMetadataReadWork<T>(operation: () => T | Promise<T>): Promise<{
-    result: T;
-    work: Readonly<ItemMetadataReadWork>;
+result: T;
+work: Readonly<ItemMetadataReadWork>;
 }>;