@unbrained/pm-cli 2026.10.14 → 2026.10.15

package/dist/sdk/dependencies.d.ts

@@ -1,116 +1,116 @@
 import type { GlobalOptions } from "../core/shared/command-types.js";
-import type { ItemMetadata, ItemStatus, ItemType } from "../types/index.js";
+import type { ItemMetadata,ItemStatus,ItemType } from "../types/index.js";
 import { type OutputProjectionDeclaration } from "./output-projection.js";
 import { type DanglingDependencyReference } from "./graph/assembly.js";
 import { type RelationshipContextResult } from "./relationship-context.js";
 import { type RelationshipKindRegistry } from "./relationships.js";
 /** Supported values accepted by the deps format contract. */
-export declare const DEPS_FORMAT_VALUES: readonly ["tree", "graph", "context"];
+export declare const DEPS_FORMAT_VALUES:readonly ["tree","graph","context"];
 /** Restricts deps format values accepted by command, SDK, and storage contracts. */
 export type DepsFormat = (typeof DEPS_FORMAT_VALUES)[number];
 /** Supported values accepted by the deps collapse contract. */
-export declare const DEPS_COLLAPSE_VALUES: readonly ["none", "repeated"];
+export declare const DEPS_COLLAPSE_VALUES:readonly ["none","repeated"];
 /** Restricts deps collapse mode values accepted by command, SDK, and storage contracts. */
 export type DepsCollapseMode = (typeof DEPS_COLLAPSE_VALUES)[number];
 /** Supported values accepted by the deps graph-context direction contract. */
-export declare const DEPS_DIRECTION_VALUES: readonly ["outgoing", "incoming", "both"];
+export declare const DEPS_DIRECTION_VALUES:readonly ["outgoing","incoming","both"];
 /** Restricts deps traversal-direction values accepted by command, SDK, and storage contracts. */
 export type DepsDirection = (typeof DEPS_DIRECTION_VALUES)[number];
 /** Documents the deps command options payload exchanged by command, SDK, and package integrations. */
 export interface DepsCommandOptions {
 /** Value that configures or reports format for this contract. */
-format?: string;
+format?:string;
 /** Value that configures or reports max depth for this contract. */
-maxDepth?: string | number;
+maxDepth?:string | number;
 /** Value that configures or reports collapse for this contract. */
-collapse?: string;
+collapse?:string;
 /** Value that configures or reports summary for this contract. */
-summary?: boolean;
+summary?:boolean;
 /** Explicitly restore the complete row projection after a summary read. */
-full?: boolean;
+full?:boolean;
 /** Maximum graph-context nodes returned. */
-nodeLimit?: string | number;
+nodeLimit?:string | number;
 /** Maximum graph-context edges and enumerated missing-reference rows returned. */
-edgeLimit?: string | number;
+edgeLimit?:string | number;
 /** Maximum estimated graph-context output tokens. */
-tokenBudget?: string | number;
+tokenBudget?:string | number;
 /** Opaque continuation cursor for graph-context output. */
-cursor?: string;
+cursor?:string;
 /** Graph-context traversal direction relative to each visited node. */
-direction?: string;
+direction?:string;
 /** Registered relationship kinds narrowing graph-context traversal. */
-kind?: string | string[];
+kind?:string | string[];
 }
 /** Documents the deps tree node payload exchanged by command, SDK, and package integrations. */
 export interface DepsTreeNode {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports title for this contract. */
-title?: string;
+title?:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type?: ItemType;
+type?:ItemType;
 /** Lifecycle state reported for status. */
-status?: ItemStatus;
+status?:ItemStatus;
 /** Value that configures or reports via for this contract. */
-via?: string;
+via?:string;
 /** Value that configures or reports missing for this contract. */
-missing: boolean;
+missing:boolean;
 /** Value that configures or reports cycle for this contract. */
-cycle: boolean;
+cycle:boolean;
 /** Value that configures or reports truncated for this contract. */
-truncated?: boolean;
+truncated?:boolean;
 /** Value that configures or reports collapsed for this contract. */
-collapsed?: boolean;
+collapsed?:boolean;
 /** Value that configures or reports dependencies for this contract. */
-dependencies: DepsTreeNode[];
+dependencies:DepsTreeNode[];
 }
 /** Documents the deps graph node payload exchanged by command, SDK, and package integrations. */
 export interface DepsGraphNode {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports title for this contract. */
-title?: string;
+title?:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type?: ItemType;
+type?:ItemType;
 /** Lifecycle state reported for status. */
-status?: ItemStatus;
+status?:ItemStatus;
 /** Value that configures or reports missing for this contract. */
-missing: boolean;
+missing:boolean;
 }
 /** Documents the deps graph edge payload exchanged by command, SDK, and package integrations. */
 export interface DepsGraphEdge {
 /** 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 kind for this contract. */
-kind: string;
+kind:string;
 }
 /** Documents the deps graph result payload exchanged by command, SDK, and package integrations. */
 export interface DepsGraphResult {
 /** Value that configures or reports root id for this contract. */
-root_id: string;
+root_id:string;
 /** Value that configures or reports nodes for this contract. */
-nodes: DepsGraphNode[];
+nodes:DepsGraphNode[];
 /** Value that configures or reports edges for this contract. */
-edges: DepsGraphEdge[];
+edges:DepsGraphEdge[];
 /** Value that configures or reports missing ids for this contract. */
-missing_ids: string[];
+missing_ids:string[];
 }
 /** Documents the deps result payload exchanged by command, SDK, and package integrations. */
 export interface DepsResult {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports format for this contract. */
-format: DepsFormat;
+format:DepsFormat;
 /** Number of node entries represented by this result. */
-node_count: number;
+node_count:number;
 /** Number of edge entries represented by this result. */
-edge_count: number;
+edge_count:number;
 /** Counting convention used by edge_count. */
-edge_basis: "deduplicated_directed";
+edge_basis:"deduplicated_directed";
 /** Stored legacy relationship aliases grouped by spelling across the workspace. */
-legacy_alias_counts?: Record<string, number>;
+legacy_alias_counts?:Record<string,number>;
 /**
      * Number of missing entries represented by this result.
      *
@@ -120,60 +120,60 @@ legacy_alias_counts?: Record<string, number>;
      * packet, independent of node or token pagination, so the two formats agree
      * for equal traversal parameters over the dependency edge family.
      */
-missing_count: number;
+missing_count:number;
 /** Traversal scope documenting the missing_count semantics for context format. */
-missing_scope?: "traversal";
+missing_scope?:"traversal";
 /** Total dangling references declared into the traversed missing nodes. */
-missing_reference_count?: number;
+missing_reference_count?:number;
 /** Bounded enumeration of dangling references, capped by the context edge limit. */
-missing_references?: DanglingDependencyReference[];
+missing_references?:DanglingDependencyReference[];
 /** Explicit bounded-projection metadata when tree or graph rows were omitted. */
-truncation?: {
+truncation?:{
 /** Stable reasons explaining which bounds stopped expansion. */
-reasons: Array<"max_depth" | "node_limit" | "edge_limit" | "token_budget">;
+reasons:Array<"max_depth" | "node_limit" | "edge_limit" | "token_budget">;
 /** Effective bounds applied to this projection. */
-limits: {
-max_depth: number;
-node_limit: number;
-edge_limit: number;
-token_budget: number;
+limits:{
+max_depth:number;
+node_limit:number;
+edge_limit:number;
+token_budget:number;
 };
 /** Conservative token estimate consumed by emitted tree rows and edges. */
-estimated_tokens: number;
+estimated_tokens:number;
 /** Full unique-node census reachable without projection bounds. */
-total_node_count: number;
+total_node_count:number;
 /** Full unique-edge census reachable without projection bounds. */
-total_edge_count: number;
+total_edge_count:number;
 /** Unique nodes omitted from the returned projection. */
-omitted_node_count: number;
+omitted_node_count:number;
 /** Unique edges omitted from the returned projection. */
-omitted_edge_count: number;
+omitted_edge_count:number;
 };
 /** Value that configures or reports tree for this contract. */
-tree?: DepsTreeNode;
+tree?:DepsTreeNode;
 /** Value that configures or reports graph for this contract. */
-graph?: DepsGraphResult;
+graph?:DepsGraphResult;
 /** Explainable bounded graph-context projection. */
-context?: RelationshipContextResult;
+context?:RelationshipContextResult;
 /** Self-describing row projection used to derive a bounded omission receipt. */
-projection: OutputProjectionDeclaration;
+projection:OutputProjectionDeclaration;
 }
 /** Parse one positive-integer graph bound, failing fast with the offending flag name. */
-export declare function parsePositiveInteger(raw: string | number | undefined, flag: string): number | undefined;
+export declare function parsePositiveInteger(raw:string | number | undefined,flag:string):number | undefined;
 /** Parse the shared non-negative --max-depth traversal bound. */
-export declare function parseMaxDepth(raw: string | number | undefined): number | undefined;
+export declare function parseMaxDepth(raw:string | number | undefined):number | undefined;
 /** Parse the shared graph traversal --direction value, defaulting to "both". */
-export declare function parseDirection(raw: string | undefined): DepsDirection;
+export declare function parseDirection(raw:string | undefined):DepsDirection;
 /**
  * Normalize repeatable and comma-separated --kind values against one
  * relationship ontology, failing fast on unknown kinds instead of silently
  * matching nothing (the multi-value filter-grammar trap tracked by pm-gknu).
  */
-export declare function parseKinds(raw: string | string[] | undefined, registry?: RelationshipKindRegistry): string[] | undefined;
+export declare function parseKinds(raw:string | string[] | undefined,registry?:RelationshipKindRegistry):string[] | undefined;
 /** Options subset consumed by the deps graph-context projection. */
-type DepsContextOptions = Pick<DepsCommandOptions, "maxDepth" | "nodeLimit" | "edgeLimit" | "tokenBudget" | "cursor" | "direction" | "kind">;
+type DepsContextOptions = Pick<DepsCommandOptions,"maxDepth" | "nodeLimit" | "edgeLimit" | "tokenBudget" | "cursor" | "direction" | "kind">;
 /** Build the SDK-backed bounded relationship-context projection for deps. */
-export declare function buildDepsRelationshipContext(rootId: string, items: readonly ItemMetadata[], options: DepsContextOptions, rootEvidence?: readonly string[]): RelationshipContextResult;
+export declare function buildDepsRelationshipContext(rootId:string,items:readonly ItemMetadata[],options:DepsContextOptions,rootEvidence?:readonly string[]):RelationshipContextResult;
 /** Implements run deps for the public runtime surface of this module. */
-export declare function runDeps(id: string, options: DepsCommandOptions, global: GlobalOptions): Promise<DepsResult>;
+export declare function runDeps(id:string,options:DepsCommandOptions,global:GlobalOptions):Promise<DepsResult>;
 export {};

package/dist/sdk/dependency-flag-validation.d.ts

@@ -1,14 +1,14 @@
-import type { Dependency, ItemFormat, RuntimeSchemaSettings } from "../types/index.js";
+import type { Dependency,ItemFormat,RuntimeSchemaSettings } from "../types/index.js";
 import { type RelationshipKindRegistry } from "./relationships.js";
 /** Resolve mutation spellings through the active ontology and advertise its vocabulary on refusal. */
-export declare function requireDependencyKind(value: string, registry?: RelationshipKindRegistry): string;
+export declare function requireDependencyKind(value:string,registry?:RelationshipKindRegistry):string;
 /** Reject malformed shorthand before item-id prefix normalization can create a dangling graph node. */
-export declare function assertValidBareDependencyFlagValue(value: string, structured: boolean, flag?: string): void;
+export declare function assertValidBareDependencyFlagValue(value:string,structured:boolean,flag?:string):void;
 /**
  * Validate prospective stored dependencies against the active relationship
  * ontology before a create or update mutation writes item or history state.
  */
-export declare function assertDependencyEdgesAllowed(holderId: string, dependencies: readonly Dependency[] | undefined, registry?: RelationshipKindRegistry): void;
+export declare function assertDependencyEdgesAllowed(holderId:string,dependencies:readonly Dependency[] | undefined,registry?:RelationshipKindRegistry):void;
 /**
  * Resolve every newly supplied local dependency and enforce declared endpoint
  * chronology before a mutation commits.
@@ -16,17 +16,17 @@ export declare function assertDependencyEdgesAllowed(holderId: string, dependenc
  * unresolved mode returns durable warning tokens instead of pretending that
  * the graph edge resolved successfully.
  */
-export declare function assertDependencyTargetsResolvable(params: {
-pmRoot: string;
-dependencies: readonly Dependency[] | undefined;
-idPrefix: string;
-itemFormat: ItemFormat;
-typeToFolder: Record<string, string>;
-allowUnresolved?: boolean;
-holders?: readonly {
-id: string;
-createdAt?: string;
+export declare function assertDependencyTargetsResolvable(params:{
+pmRoot:string;
+dependencies:readonly Dependency[] | undefined;
+idPrefix:string;
+itemFormat:ItemFormat;
+typeToFolder:Record<string,string>;
+allowUnresolved?:boolean;
+holders?:readonly {
+id:string;
+createdAt?:string;
 }[];
-schema?: RuntimeSchemaSettings;
-registry?: RelationshipKindRegistry;
-}): Promise<string[]>;
+schema?:RuntimeSchemaSettings;
+registry?:RelationshipKindRegistry;
+}):Promise<string[]>;

package/dist/sdk/dependency-provenance.d.ts

@@ -1,70 +1,70 @@
-export { isExternalDependencyReference, isExternalDependencySourceKind, } from "../core/item/dependency-reference.js";
+export { isExternalDependencyReference,isExternalDependencySourceKind,} from "../core/item/dependency-reference.js";
 /** Provenance value declaring that a dependency id belongs to another workspace. */
 export declare const EXTERNAL_DEPENDENCY_SOURCE_KIND = "global";
 /** Human-facing alias accepted wherever external dependency provenance is parsed. */
 export declare const EXTERNAL_DEPENDENCY_SOURCE_KIND_ALIAS = "external";
 /** Stable external lifecycle values understood without coupling core to a provider. */
-export declare const EXTERNAL_DEPENDENCY_RESOLUTION_STATUSES: readonly ["open", "closed", "unknown"];
+export declare const EXTERNAL_DEPENDENCY_RESOLUTION_STATUSES:readonly ["open","closed","unknown"];
 /** External lifecycle value returned by a registered dependency resolver. */
 export type ExternalDependencyResolutionStatus = (typeof EXTERNAL_DEPENDENCY_RESOLUTION_STATUSES)[number];
 /** Provider-owned external dependency data before the SDK applies output bounds. */
 export interface ExternalDependencyResolverResult {
 /** Provider lifecycle state normalized to the universal external status vocabulary. */
-status: ExternalDependencyResolutionStatus;
+status:ExternalDependencyResolutionStatus;
 /** Optional bounded human context for the remote dependency. */
-title?: string;
+title?:string;
 /** Optional canonical provider URL or locator used as evidence. */
-source?: string;
+source?:string;
 /** Optional provider observation timestamp; invalid timestamps are replaced by SDK time. */
-checkedAt?: string;
+checkedAt?:string;
 }
 /** Package-provided resolver contract for one or more external dependency locator families. */
 export interface ExternalDependencyResolver {
 /** Stable resolver identity surfaced in agent-facing evidence. */
-name: string;
+name:string;
 /** Return whether this resolver owns the supplied external locator. */
-supports(reference: string): boolean;
+supports(reference:string):boolean;
 /** Resolve the locator without exposing provider credentials or unbounded response data. */
-resolve(reference: string): Promise<ExternalDependencyResolverResult | null>;
+resolve(reference:string):Promise<ExternalDependencyResolverResult | null>;
 }
 /** Bounded provider-neutral evidence returned by the public resolver registry. */
 export interface ExternalDependencyResolution {
 /** Original normalized dependency locator. */
-id: string;
+id:string;
 /** Provider lifecycle state. */
-status: ExternalDependencyResolutionStatus;
+status:ExternalDependencyResolutionStatus;
 /** Whether trusted provider evidence proves the blocker terminal. */
-resolved: boolean;
+resolved:boolean;
 /** Bounded remote title, or null when the provider did not supply one. */
-title: string | null;
+title:string | null;
 /** Bounded evidence locator. */
-source: string;
+source:string;
 /** Observation timestamp supplied by the provider or SDK clock. */
-checked_at: string;
+checked_at:string;
 /** Registered resolver identity that produced this evidence. */
-resolver: string;
+resolver:string;
 }
 /** Deterministic clock override for external resolver acceptance and tests. */
 export interface ExternalDependencyResolutionOptions {
 /** Return the timestamp used when provider evidence omits or corrupts checkedAt. */
-now?: () => string;
+now?:() => string;
 }
 /** Register a package-owned external dependency resolver and return its idempotent disposer. */
-export declare function registerExternalDependencyResolver(resolver: ExternalDependencyResolver): () => void;
+export declare function registerExternalDependencyResolver(resolver:ExternalDependencyResolver):() => void;
 /** Resolve one external locator through registered package providers with bounded provider-neutral evidence. */
-export declare function resolveExternalDependencyReference(reference: string, options?: ExternalDependencyResolutionOptions): Promise<ExternalDependencyResolution | null>;
+export declare function resolveExternalDependencyReference(reference:string,options?:ExternalDependencyResolutionOptions):Promise<ExternalDependencyResolution | null>;
 /** Canonicalize external provenance while preserving other named source kinds. */
-export declare function normalizeDependencySourceKind(sourceKind: string | undefined): string | undefined;
+export declare function normalizeDependencySourceKind(sourceKind:string | undefined):string | undefined;
 /**
  * Normalize a dependency seed id without corrupting cross-workspace identity.
  * Local and legacy seeds retain normal workspace-prefix behavior; explicitly
  * global seeds preserve the caller-provided id verbatim (apart from trimming).
  */
-export declare function normalizeDependencySeedId(id: string, prefix: string, sourceKind: string | undefined): string;
+export declare function normalizeDependencySeedId(id:string,prefix:string,sourceKind:string | undefined):string;
 /**
  * Canonicalize a local relationship target using the workspace prefix. Explicit
  * provider locators and externally sourced identities retain case and spelling;
  * only surrounding whitespace is removed. Resolution and parent policy remain
  * the caller's responsibility, so dangling local ids are never guessed remote.
  */
-export declare function normalizeItemReference(reference: string, prefix: string, sourceKind?: string): string;
+export declare function normalizeItemReference(reference:string,prefix:string,sourceKind?:string):string;

package/dist/sdk/docs.d.ts

@@ -9,40 +9,40 @@ import { type LinkedPathValidation } from "./linked-artifacts.js";
 /** Documents the docs command options payload exchanged by command, SDK, and package integrations. */
 export interface DocsCommandOptions {
 /** Value that configures or reports add for this contract. */
-add?: string[];
+add?:string[];
 /** Value that configures or reports add glob for this contract. */
-addGlob?: string[];
+addGlob?:string[];
 /** Value that configures or reports remove for this contract. */
-remove?: string[];
+remove?:string[];
 /** Value that configures or reports migrate for this contract. */
-migrate?: string[];
+migrate?:string[];
 /** GH-170 (pm-pfnx): standalone note applied to every --add/--add-glob link in this invocation. */
-note?: string;
+note?:string;
 /** Value that configures or reports list for this contract. */
-list?: boolean;
+list?:boolean;
 /** Value that configures or reports validate paths for this contract. */
-validatePaths?: boolean;
+validatePaths?:boolean;
 /** Value that configures or reports author for this contract. */
-author?: string;
+author?:string;
 /** Human-readable explanation suitable for logs and agent-facing output. */
-message?: string;
+message?:string;
 /** Value that configures or reports force for this contract. */
-force?: boolean;
+force?:boolean;
 }
 /** Documents the docs result payload exchanged by command, SDK, and package integrations. */
 export interface DocsResult {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports docs for this contract. */
-docs: LinkedDoc[];
+docs:LinkedDoc[];
 /** Value that configures or reports changed for this contract. */
-changed: boolean;
+changed:boolean;
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Value that configures or reports migrations applied for this contract. */
-migrations_applied?: number;
+migrations_applied?:number;
 /** Value that configures or reports validation for this contract. */
-validation?: LinkedPathValidation;
+validation?:LinkedPathValidation;
 }
 /** Implements run docs for the public runtime surface of this module. */
-export declare function runDocs(id: string, options: DocsCommandOptions, global: GlobalOptions): Promise<DocsResult>;
+export declare function runDocs(id:string,options:DocsCommandOptions,global:GlobalOptions):Promise<DocsResult>;

package/dist/sdk/duplicates.d.ts

@@ -5,36 +5,36 @@
  * canonical-item guidance for CLI, MCP, and embedded SDK consumers.
  */
 import type { GlobalOptions } from "../core/shared/command-types.js";
-import { type DuplicateCluster, type DuplicateClustersResult } from "./similarity.js";
+import { type DuplicateCluster,type DuplicateClustersResult } from "./similarity.js";
 /** Options shared by the `pm duplicates` command and SDK action. */
 export interface DuplicatesCommandOptions {
 /** Compare all pairs instead of using lossless prefix filtering. */
-exhaustive?: boolean;
+exhaustive?:boolean;
 /** Lifecycle statuses to include; omitted means every status. */
-status?: readonly string[];
+status?:readonly string[];
 /** Inclusive creation timestamp lower bound. */
-since?: string;
+since?:string;
 /** Minimum similarity score from zero through one. */
-threshold?: number;
+threshold?:number;
 /** Maximum connected clusters to return. */
-limit?: number;
+limit?:number;
 }
 /** Duplicate cluster enriched with deterministic close/merge guidance. */
 export interface ActionableDuplicateCluster extends DuplicateCluster {
 /** Lexically first item id, used as the stable default canonical candidate. */
-canonical_id: string;
+canonical_id:string;
 /** Exact remediation command template for non-canonical members. */
-close_command: string;
+close_command:string;
 }
 /** Agent-facing duplicate discovery result. */
-export interface DuplicatesResult extends Omit<DuplicateClustersResult, "clusters"> {
+export interface DuplicatesResult extends Omit<DuplicateClustersResult,"clusters"> {
 /** Bounded, deterministic duplicate clusters. */
-clusters: ActionableDuplicateCluster[];
+clusters:ActionableDuplicateCluster[];
 /** Concise remediation policy shared by every presentation surface. */
-guidance: {
-strategy: "review_then_close_duplicate";
-command: "pm close <duplicate-id> --duplicate-of <canonical-id>";
+guidance:{
+strategy:"review_then_close_duplicate";
+command:"pm close <duplicate-id> --duplicate-of <canonical-id>";
 };
 }
 /** Discover existing duplicate clusters without creating or mutating an item. */
-export declare function runDuplicates(global: GlobalOptions, options?: DuplicatesCommandOptions): Promise<DuplicatesResult>;
+export declare function runDuplicates(global:GlobalOptions,options?:DuplicatesCommandOptions):Promise<DuplicatesResult>;