@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/sdk/corpus-shape.d.ts

@@ -10,119 +10,119 @@ export declare const PM_CORPUS_SHAPE_SCHEMA = "https://schema.unbrained.dev/pm/c
 export type BuiltinCorpusShapeName = "scratch" | "representative" | "deep-graph" | "multi-decade" | "disconnected-archive";
 /** One weighted relationship kind in a generated corpus. */
 export interface CorpusShapeEdgeWeight {
-    /** Registered pm relationship kind. */
-    kind: string;
-    /** Relative deterministic selection weight. */
-    weight: number;
+/** Registered pm relationship kind. */
+kind: string;
+/** Relative deterministic selection weight. */
+weight: number;
 }
 /** Portable declaration of the population behind a benchmark or evaluation. */
 export interface CorpusShape {
-    /** Versioned schema identity. */
-    schema: typeof PM_CORPUS_SHAPE_SCHEMA;
-    /** Stable shape name used by CLIs and reports. */
-    name: string;
-    /** Human-readable intent and expected use. */
-    description: string;
-    /** Maximum generated parent-chain depth. */
-    hierarchy_depth: number;
-    /** Target maximum number of children per generated parent. */
-    hierarchy_fanout: number;
-    /** Project time spanned by generated timestamps. */
-    age_span_days: number;
-    /** History entries generated for every item. */
-    history_entries_per_item: number;
-    /** Evidence comments generated per hundred items. */
-    comments_per_100_items: number;
-    /** Private notes generated per hundred items. */
-    notes_per_100_items: number;
-    /** Durable learnings generated per hundred items. */
-    learnings_per_100_items: number;
-    /** Weighted typed relationship population. */
-    edge_kind_mix: readonly CorpusShapeEdgeWeight[];
-    /** Number of distinct mutation authors. */
-    author_cardinality: number;
-    /** Number of disconnected hierarchy/relationship components. */
-    component_count: number;
-    /** Whether deterministic back-edges should exercise cyclic graph handling. */
-    include_cycles: boolean;
-    /** Custom item types registered before generation. */
-    custom_types: readonly string[];
-    /** Custom lifecycle statuses registered before generation. */
-    custom_statuses: readonly string[];
-    /** Custom statuses that should use terminal lifecycle semantics. */
-    terminal_statuses: readonly string[];
-    /** Custom metadata fields registered before generation. */
-    custom_fields: readonly string[];
+/** Versioned schema identity. */
+schema: typeof PM_CORPUS_SHAPE_SCHEMA;
+/** Stable shape name used by CLIs and reports. */
+name: string;
+/** Human-readable intent and expected use. */
+description: string;
+/** Maximum generated parent-chain depth. */
+hierarchy_depth: number;
+/** Target maximum number of children per generated parent. */
+hierarchy_fanout: number;
+/** Project time spanned by generated timestamps. */
+age_span_days: number;
+/** History entries generated for every item. */
+history_entries_per_item: number;
+/** Evidence comments generated per hundred items. */
+comments_per_100_items: number;
+/** Private notes generated per hundred items. */
+notes_per_100_items: number;
+/** Durable learnings generated per hundred items. */
+learnings_per_100_items: number;
+/** Weighted typed relationship population. */
+edge_kind_mix: readonly CorpusShapeEdgeWeight[];
+/** Number of distinct mutation authors. */
+author_cardinality: number;
+/** Number of disconnected hierarchy/relationship components. */
+component_count: number;
+/** Whether deterministic back-edges should exercise cyclic graph handling. */
+include_cycles: boolean;
+/** Custom item types registered before generation. */
+custom_types: readonly string[];
+/** Custom lifecycle statuses registered before generation. */
+custom_statuses: readonly string[];
+/** Custom statuses that should use terminal lifecycle semantics. */
+terminal_statuses: readonly string[];
+/** Custom metadata fields registered before generation. */
+custom_fields: readonly string[];
 }
 /** Deterministic SDK plan for one generated corpus item. */
 export interface CorpusShapeItemPlan {
-    /** Zero-based item position. */
-    index: number;
-    /** Stable generated item identifier. */
-    id: string;
-    /** Optional generated parent identifier. */
-    parent?: string;
-    /** Component assigned by the shape. */
-    component: number;
-    /** Deterministic timestamp across the declared age span. */
-    timestamp: string;
-    /** Deterministic author identity. */
-    author: string;
-    /** Number of history entries to materialize. */
-    history_entry_count: number;
-    /** Relationship kinds selected for this item. */
-    dependency_kinds: readonly string[];
-    /** Whether the item receives an evidence comment. */
-    has_comment: boolean;
-    /** Whether the item receives a private note. */
-    has_note: boolean;
-    /** Whether the item receives a durable learning. */
-    has_learning: boolean;
-    /** Custom type selected for this item, when configured. */
-    custom_type?: string;
-    /** Custom status selected for this item, when configured. */
-    custom_status?: string;
+/** Zero-based item position. */
+index: number;
+/** Stable generated item identifier. */
+id: string;
+/** Optional generated parent identifier. */
+parent?: string;
+/** Component assigned by the shape. */
+component: number;
+/** Deterministic timestamp across the declared age span. */
+timestamp: string;
+/** Deterministic author identity. */
+author: string;
+/** Number of history entries to materialize. */
+history_entry_count: number;
+/** Relationship kinds selected for this item. */
+dependency_kinds: readonly string[];
+/** Whether the item receives an evidence comment. */
+has_comment: boolean;
+/** Whether the item receives a private note. */
+has_note: boolean;
+/** Whether the item receives a durable learning. */
+has_learning: boolean;
+/** Custom type selected for this item, when configured. */
+custom_type?: string;
+/** Custom status selected for this item, when configured. */
+custom_status?: string;
 }
 /** Measured population profile attached to generated-corpus evidence. */
 export interface CorpusShapeProfile {
-    /** Shape declaration identity. */
-    shape: string;
-    /** Generated item count. */
-    item_count: number;
-    /** Observed distinct author count. */
-    author_count: number;
-    /** Observed hierarchy component count. */
-    component_count: number;
-    /** Observed maximum parent-chain depth. */
-    hierarchy_depth: number;
-    /** Observed maximum number of children assigned to one parent. */
-    hierarchy_fanout: number;
-    /** Observed minimum and maximum timestamps. */
-    timestamp_range: {
-        first: string | null;
-        last: string | null;
-    };
-    /** Observed total history entries. */
-    history_entry_count: number;
-    /** Observed annotation totals. */
-    annotations: {
-        comments: number;
-        notes: number;
-        learnings: number;
-    };
-    /** Observed relationship-kind totals. */
-    edge_kinds: Record<string, number>;
-    /** True when every declared invariant represented by the plan matches. */
-    matches_declaration: boolean;
-    /** Actionable mismatches, empty for a conforming plan. */
-    mismatches: readonly string[];
+/** Shape declaration identity. */
+shape: string;
+/** Generated item count. */
+item_count: number;
+/** Observed distinct author count. */
+author_count: number;
+/** Observed hierarchy component count. */
+component_count: number;
+/** Observed maximum parent-chain depth. */
+hierarchy_depth: number;
+/** Observed maximum number of children assigned to one parent. */
+hierarchy_fanout: number;
+/** Observed minimum and maximum timestamps. */
+timestamp_range: {
+first: string | null;
+last: string | null;
+};
+/** Observed total history entries. */
+history_entry_count: number;
+/** Observed annotation totals. */
+annotations: {
+comments: number;
+notes: number;
+learnings: number;
+};
+/** Observed relationship-kind totals. */
+edge_kinds: Record<string, number>;
+/** True when every declared invariant represented by the plan matches. */
+matches_declaration: boolean;
+/** Actionable mismatches, empty for a conforming plan. */
+mismatches: readonly string[];
 }
 /** Incremental corpus-profile measurement without retaining item plans. */
 export interface CorpusShapeMeasurement {
-    /** Add one generated plan in generation order. */
-    add(plan: CorpusShapeItemPlan): void;
-    /** Finish the measurement and return its conformance profile. */
-    finish(): CorpusShapeProfile;
+/** Add one generated plan in generation order. */
+add(plan: CorpusShapeItemPlan): void;
+/** Finish the measurement and return its conformance profile. */
+finish(): CorpusShapeProfile;
 }
 type ExactCorpusShape<Shape extends CorpusShape> = Shape & Record<Exclude<keyof Shape, keyof CorpusShape>, never>;
 /** Validate, detach, and deeply freeze a portable corpus-shape declaration. */

package/dist/sdk/define.d.ts

@@ -157,8 +157,8 @@ export declare function definePreflightOverride<TDefinition extends ScopedPrefli
 export declare function defineServiceOverride(override: ServiceOverride): ServiceOverride;
 /** Explicitly claim a service payload and publish its replacement result. */
 export declare function handleServiceOverride<const TResult>(result: TResult): {
-    handled: true;
-    result: TResult;
+handled: true;
+result: TResult;
 };
 /** Explicitly decline a service payload so the next override or host handles it. */
 export declare function declineServiceOverride(): ServiceOverrideDecision;

package/dist/sdk/dependencies.d.ts

@@ -18,100 +18,100 @@ export declare const DEPS_DIRECTION_VALUES: readonly ["outgoing", "incoming", "b
 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;
-    /** Value that configures or reports max depth for this contract. */
-    maxDepth?: string | number;
-    /** Value that configures or reports collapse for this contract. */
-    collapse?: string;
-    /** Value that configures or reports summary for this contract. */
-    summary?: boolean;
-    /** Explicitly restore the complete row projection after a summary read. */
-    full?: boolean;
-    /** Maximum graph-context nodes returned. */
-    nodeLimit?: string | number;
-    /** Maximum graph-context edges and enumerated missing-reference rows returned. */
-    edgeLimit?: string | number;
-    /** Maximum estimated graph-context output tokens. */
-    tokenBudget?: string | number;
-    /** Opaque continuation cursor for graph-context output. */
-    cursor?: string;
-    /** Graph-context traversal direction relative to each visited node. */
-    direction?: string;
-    /** Registered relationship kinds narrowing graph-context traversal. */
-    kind?: string | string[];
+/** Value that configures or reports format for this contract. */
+format?: string;
+/** Value that configures or reports max depth for this contract. */
+maxDepth?: string | number;
+/** Value that configures or reports collapse for this contract. */
+collapse?: string;
+/** Value that configures or reports summary for this contract. */
+summary?: boolean;
+/** Explicitly restore the complete row projection after a summary read. */
+full?: boolean;
+/** Maximum graph-context nodes returned. */
+nodeLimit?: string | number;
+/** Maximum graph-context edges and enumerated missing-reference rows returned. */
+edgeLimit?: string | number;
+/** Maximum estimated graph-context output tokens. */
+tokenBudget?: string | number;
+/** Opaque continuation cursor for graph-context output. */
+cursor?: string;
+/** Graph-context traversal direction relative to each visited node. */
+direction?: string;
+/** Registered relationship kinds narrowing graph-context traversal. */
+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;
-    /** Value that configures or reports title for this contract. */
-    title?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: ItemType;
-    /** Lifecycle state reported for status. */
-    status?: ItemStatus;
-    /** Value that configures or reports via for this contract. */
-    via?: string;
-    /** Value that configures or reports missing for this contract. */
-    missing: boolean;
-    /** Value that configures or reports cycle for this contract. */
-    cycle: boolean;
-    /** Value that configures or reports truncated for this contract. */
-    truncated?: boolean;
-    /** Value that configures or reports collapsed for this contract. */
-    collapsed?: boolean;
-    /** Value that configures or reports dependencies for this contract. */
-    dependencies: DepsTreeNode[];
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: ItemType;
+/** Lifecycle state reported for status. */
+status?: ItemStatus;
+/** Value that configures or reports via for this contract. */
+via?: string;
+/** Value that configures or reports missing for this contract. */
+missing: boolean;
+/** Value that configures or reports cycle for this contract. */
+cycle: boolean;
+/** Value that configures or reports truncated for this contract. */
+truncated?: boolean;
+/** Value that configures or reports collapsed for this contract. */
+collapsed?: boolean;
+/** Value that configures or reports dependencies for this contract. */
+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;
-    /** Value that configures or reports title for this contract. */
-    title?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: ItemType;
-    /** Lifecycle state reported for status. */
-    status?: ItemStatus;
-    /** Value that configures or reports missing for this contract. */
-    missing: boolean;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: ItemType;
+/** Lifecycle state reported for status. */
+status?: ItemStatus;
+/** Value that configures or reports missing for this contract. */
+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;
-    /** Value that configures or reports to for this contract. */
-    to: string;
-    /** Value that configures or reports kind for this contract. */
-    kind: 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 kind for this contract. */
+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;
-    /** Value that configures or reports nodes for this contract. */
-    nodes: DepsGraphNode[];
-    /** Value that configures or reports edges for this contract. */
-    edges: DepsGraphEdge[];
-    /** Value that configures or reports missing ids for this contract. */
-    missing_ids: string[];
+/** Value that configures or reports root id for this contract. */
+root_id: string;
+/** Value that configures or reports nodes for this contract. */
+nodes: DepsGraphNode[];
+/** Value that configures or reports edges for this contract. */
+edges: DepsGraphEdge[];
+/** Value that configures or reports missing ids for this contract. */
+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;
-    /** Value that configures or reports format for this contract. */
-    format: DepsFormat;
-    /** Number of node entries represented by this result. */
-    node_count: number;
-    /** Number of edge entries represented by this result. */
-    edge_count: number;
-    /** Counting convention used by edge_count. */
-    edge_basis: "deduplicated_directed";
-    /** Stored legacy relationship aliases grouped by spelling across the workspace. */
-    legacy_alias_counts?: Record<string, number>;
-    /**
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports format for this contract. */
+format: DepsFormat;
+/** Number of node entries represented by this result. */
+node_count: number;
+/** Number of edge entries represented by this result. */
+edge_count: number;
+/** Counting convention used by edge_count. */
+edge_basis: "deduplicated_directed";
+/** Stored legacy relationship aliases grouped by spelling across the workspace. */
+legacy_alias_counts?: Record<string, number>;
+/**
      * Number of missing entries represented by this result.
      *
      * Tree and graph formats count missing nodes encountered while walking
@@ -120,43 +120,43 @@ export interface DepsResult {
      * packet, independent of node or token pagination, so the two formats agree
      * for equal traversal parameters over the dependency edge family.
      */
-    missing_count: number;
-    /** Traversal scope documenting the missing_count semantics for context format. */
-    missing_scope?: "traversal";
-    /** Total dangling references declared into the traversed missing nodes. */
-    missing_reference_count?: number;
-    /** Bounded enumeration of dangling references, capped by the context edge limit. */
-    missing_references?: DanglingDependencyReference[];
-    /** Explicit bounded-projection metadata when tree or graph rows were omitted. */
-    truncation?: {
-        /** Stable reasons explaining which bounds stopped expansion. */
-        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;
-        };
-        /** Conservative token estimate consumed by emitted tree rows and edges. */
-        estimated_tokens: number;
-        /** Full unique-node census reachable without projection bounds. */
-        total_node_count: number;
-        /** Full unique-edge census reachable without projection bounds. */
-        total_edge_count: number;
-        /** Unique nodes omitted from the returned projection. */
-        omitted_node_count: number;
-        /** Unique edges omitted from the returned projection. */
-        omitted_edge_count: number;
-    };
-    /** Value that configures or reports tree for this contract. */
-    tree?: DepsTreeNode;
-    /** Value that configures or reports graph for this contract. */
-    graph?: DepsGraphResult;
-    /** Explainable bounded graph-context projection. */
-    context?: RelationshipContextResult;
-    /** Self-describing row projection used to derive a bounded omission receipt. */
-    projection: OutputProjectionDeclaration;
+missing_count: number;
+/** Traversal scope documenting the missing_count semantics for context format. */
+missing_scope?: "traversal";
+/** Total dangling references declared into the traversed missing nodes. */
+missing_reference_count?: number;
+/** Bounded enumeration of dangling references, capped by the context edge limit. */
+missing_references?: DanglingDependencyReference[];
+/** Explicit bounded-projection metadata when tree or graph rows were omitted. */
+truncation?: {
+/** Stable reasons explaining which bounds stopped expansion. */
+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;
+};
+/** Conservative token estimate consumed by emitted tree rows and edges. */
+estimated_tokens: number;
+/** Full unique-node census reachable without projection bounds. */
+total_node_count: number;
+/** Full unique-edge census reachable without projection bounds. */
+total_edge_count: number;
+/** Unique nodes omitted from the returned projection. */
+omitted_node_count: number;
+/** Unique edges omitted from the returned projection. */
+omitted_edge_count: number;
+};
+/** Value that configures or reports tree for this contract. */
+tree?: DepsTreeNode;
+/** Value that configures or reports graph for this contract. */
+graph?: DepsGraphResult;
+/** Explainable bounded graph-context projection. */
+context?: RelationshipContextResult;
+/** Self-describing row projection used to derive a bounded omission receipt. */
+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;

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

@@ -1,5 +1,7 @@
 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;
 /** 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;
 /**
@@ -15,16 +17,16 @@ export declare function assertDependencyEdgesAllowed(holderId: string, dependenc
  * 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;
-    }[];
-    schema?: RuntimeSchemaSettings;
-    registry?: RelationshipKindRegistry;
+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[]>;

package/dist/sdk/dependency-flag-validation.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f2c9f586-3e93-5caf-a5c2-38be30c67171")}catch{}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{toErrorMessage}from"../core/shared/primitives.js";import{locateItem,readLocatedItem}from"../core/store/item-store.js";import{isExternalDependencySourceKind}from"./dependency-provenance.js";import{resolveWorkspaceRelationshipKindRegistry}from"./graph/assembly.js";import{assertRelationshipEdgeAllowed}from"./relationships.js";function assertValidBareDependencyFlagValue(value,structured,flag="--dep"){if(!structured&&/[:,=]/.test(value))throw new PmCliError(`Invalid ${flag} value "${value}". Use a bare item id or id=<id>,kind=<kind>.`,EXIT_CODE.USAGE,{code:"dependency_flag_value_invalid",reason:"malformed_dependency_shorthand",flag,value,required:"Use a bare item id or an explicit id=<id>,kind=<kind> entry."})}function assertDependencyEdgesAllowed(holderId,dependencies,registry=resolveWorkspaceRelationshipKindRegistry()){for(const dependency of dependencies??[])try{assertRelationshipEdgeAllowed(holderId,dependency.id,dependency.kind,registry)}catch(error){throw new PmCliError(toErrorMessage(error),EXIT_CODE.USAGE,{code:"dependency_edge_not_allowed",why:`${holderId} -> ${dependency.id} (${dependency.kind}) violates the active relationship-kind policy`})}}async function readDependencyEndpointCreatedAt(located,schema){return(await readLocatedItem(located,{schema})).document.metadata.created_at}async function resolveDependencyHolderCreatedAt(holder,context){if(holder.createdAt!==void 0)return holder.createdAt;const located=await locateItem(context.pmRoot,holder.id,context.idPrefix,context.itemFormat,context.typeToFolder);return located===null?void 0:readDependencyEndpointCreatedAt(located,context.schema)}function dependencyTemporalOrderError(params){const definition=params.registry.require(params.dependency.kind);return new PmCliError(`${definition.kind} requires source ${params.holder.id} to be created after target ${params.dependency.id}`,EXIT_CODE.USAGE,{code:"dependency_temporal_order_invalid",reason:"source_not_after_target",required:`${params.holder.id}.created_at must be later than ${params.dependency.id}.created_at for ${definition.kind}.`,why:"Chronological recurrence direction must be validated before the relationship is persisted.",source_id:params.holder.id,source_created_at:params.sourceCreatedAt,target_id:params.dependency.id,target_created_at:params.targetCreatedAt,temporal_order:definition.temporalOrder})}async function assertTemporalDependencyChronology(params){const temporalDependencies=params.dependencies.filter(dependency=>params.registry.resolve(dependency.kind)?.temporalOrder==="source_after_target"&&!params.missingTargets.includes(dependency.id));if(temporalDependencies.length===0||params.holders.length===0)return;const locatedTargets=new Map(params.resolutions.flatMap(({target,located})=>located===null?[]:[[target,located]])),targetCreatedAt=new Map(await Promise.all([...new Set(temporalDependencies.map(({id})=>id))].map(async target=>[target,await readDependencyEndpointCreatedAt(locatedTargets.get(target),params.context.schema)])));for(const holder of params.holders){const sourceCreatedAt=await resolveDependencyHolderCreatedAt(holder,params.context);if(sourceCreatedAt!==void 0)for(const dependency of temporalDependencies){const targetTimestamp=targetCreatedAt.get(dependency.id),sourceTime=Date.parse(sourceCreatedAt),targetTime=Date.parse(targetTimestamp);if(!(Number.isFinite(sourceTime)&&Number.isFinite(targetTime)&&sourceTime>targetTime))throw dependencyTemporalOrderError({holder,dependency,sourceCreatedAt,targetCreatedAt:targetTimestamp,registry:params.registry})}}}async function assertDependencyTargetsResolvable(params){const registry=params.registry??resolveWorkspaceRelationshipKindRegistry(),localDependencies=(params.dependencies??[]).filter(dependency=>!isExternalDependencySourceKind(dependency.source_kind)),localTargets=[...new Set(localDependencies.map(dependency=>dependency.id))],resolutions=await Promise.all(localTargets.map(async target=>({target,located:await locateItem(params.pmRoot,target,params.idPrefix,params.itemFormat,params.typeToFolder)}))),missingTargets=resolutions.filter(({located})=>located===null).map(({target})=>target).sort((left,right)=>left<right?-1:1);if(missingTargets.length>0&&params.allowUnresolved!==!0)throw new PmCliError(`Dependency target${missingTargets.length===1?"":"s"} not found: ${missingTargets.join(", ")}`,EXIT_CODE.NOT_FOUND,{code:"dependency_target_not_found",reason:"unresolved_local_dependency",required:"Every local dependency target must exist before the edge is committed.",why:"Fail-fast target resolution prevents dangling graph nodes and preserves reliable traversal semantics.",unresolved_targets:missingTargets,examples:["--dep id=<existing-item-id>,kind=related","--dep id=<external-id>,kind=related,source_kind=external","--allow-unresolved-deps --dep id=<future-item-id>,kind=related"],nextSteps:[`Create or correct ${missingTargets.length===1?"the target":"the targets"}, then retry the mutation.`,"Use source_kind=external for a cross-workspace reference.","Use --allow-unresolved-deps only when the dangling local edge is intentional."],recovery:{recovery_mode:"compact",missing:missingTargets,suggested_flags:["--allow-unresolved-deps"],suggested_retry:`pm search "${missingTargets[0]}" --limit 10`}});return await assertTemporalDependencyChronology({dependencies:localDependencies,missingTargets,resolutions,holders:params.holders??[],registry,context:params}),missingTargets.map(target=>`dependency_target_unresolved:${target}`)}export{assertDependencyEdgesAllowed,assertDependencyTargetsResolvable,assertValidBareDependencyFlagValue};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="414326ff-8d4d-577d-b724-ab32b3f311ac")}catch{}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{toErrorMessage}from"../core/shared/primitives.js";import{DEPENDENCY_KIND_VALUES}from"../types/index.js";import{locateItem,readLocatedItem}from"../core/store/item-store.js";import{isExternalDependencySourceKind}from"./dependency-provenance.js";import{resolveWorkspaceRelationshipKindRegistry}from"./graph/assembly.js";import{assertRelationshipEdgeAllowed}from"./relationships.js";function requireDependencyKind(value,registry=resolveWorkspaceRelationshipKindRegistry()){const definition=registry.resolve(value);if(definition)return definition.kind;const builtinKinds=new Set(DEPENDENCY_KIND_VALUES),allowed=[...DEPENDENCY_KIND_VALUES,...registry.list().filter(({kind})=>!builtinKinds.has(kind)).flatMap(({kind,aliases})=>[kind,...aliases])];throw new PmCliError(`Invalid dependency kind value "${value}". Allowed: ${allowed.join(", ")}`,EXIT_CODE.USAGE,{field:"kind",value,recovery:{allowed_values:allowed},required:`dependency kind must be one of: ${allowed.join(", ")}.`,nextSteps:["Choose a registered kind, or install and enable the extension that registers this kind before retrying."]})}function assertValidBareDependencyFlagValue(value,structured,flag="--dep"){if(!structured&&/[:,=]/.test(value))throw new PmCliError(`Invalid ${flag} value "${value}". Use a bare item id or id=<id>,kind=<kind>.`,EXIT_CODE.USAGE,{code:"dependency_flag_value_invalid",reason:"malformed_dependency_shorthand",flag,value,required:"Use a bare item id or an explicit id=<id>,kind=<kind> entry."})}function assertDependencyEdgesAllowed(holderId,dependencies,registry=resolveWorkspaceRelationshipKindRegistry()){for(const dependency of dependencies??[])try{assertRelationshipEdgeAllowed(holderId,dependency.id,dependency.kind,registry)}catch(error){throw new PmCliError(toErrorMessage(error),EXIT_CODE.USAGE,{code:"dependency_edge_not_allowed",why:`${holderId} -> ${dependency.id} (${dependency.kind}) violates the active relationship-kind policy`})}}async function readDependencyEndpointCreatedAt(located,schema){return(await readLocatedItem(located,{schema})).document.metadata.created_at}async function resolveDependencyHolderCreatedAt(holder,context){if(holder.createdAt!==void 0)return holder.createdAt;const located=await locateItem(context.pmRoot,holder.id,context.idPrefix,context.itemFormat,context.typeToFolder);return located===null?void 0:readDependencyEndpointCreatedAt(located,context.schema)}function dependencyTemporalOrderError(params){const definition=params.registry.require(params.dependency.kind);return new PmCliError(`${definition.kind} requires source ${params.holder.id} to be created after target ${params.dependency.id}`,EXIT_CODE.USAGE,{code:"dependency_temporal_order_invalid",reason:"source_not_after_target",required:`${params.holder.id}.created_at must be later than ${params.dependency.id}.created_at for ${definition.kind}.`,why:"Chronological recurrence direction must be validated before the relationship is persisted.",source_id:params.holder.id,source_created_at:params.sourceCreatedAt,target_id:params.dependency.id,target_created_at:params.targetCreatedAt,temporal_order:definition.temporalOrder})}async function assertTemporalDependencyChronology(params){const temporalDependencies=params.dependencies.filter(dependency=>params.registry.resolve(dependency.kind)?.temporalOrder==="source_after_target"&&!params.missingTargets.includes(dependency.id));if(temporalDependencies.length===0||params.holders.length===0)return;const locatedTargets=new Map(params.resolutions.flatMap(({target,located})=>located===null?[]:[[target,located]])),targetCreatedAt=new Map(await Promise.all([...new Set(temporalDependencies.map(({id})=>id))].map(async target=>[target,await readDependencyEndpointCreatedAt(locatedTargets.get(target),params.context.schema)])));for(const holder of params.holders){const sourceCreatedAt=await resolveDependencyHolderCreatedAt(holder,params.context);if(sourceCreatedAt!==void 0)for(const dependency of temporalDependencies){const targetTimestamp=targetCreatedAt.get(dependency.id),sourceTime=Date.parse(sourceCreatedAt),targetTime=Date.parse(targetTimestamp);if(!(Number.isFinite(sourceTime)&&Number.isFinite(targetTime)&&sourceTime>targetTime))throw dependencyTemporalOrderError({holder,dependency,sourceCreatedAt,targetCreatedAt:targetTimestamp,registry:params.registry})}}}async function assertDependencyTargetsResolvable(params){const registry=params.registry??resolveWorkspaceRelationshipKindRegistry(),localDependencies=(params.dependencies??[]).filter(dependency=>!isExternalDependencySourceKind(dependency.source_kind)),localTargets=[...new Set(localDependencies.map(dependency=>dependency.id))],resolutions=await Promise.all(localTargets.map(async target=>({target,located:await locateItem(params.pmRoot,target,params.idPrefix,params.itemFormat,params.typeToFolder)}))),missingTargets=resolutions.filter(({located})=>located===null).map(({target})=>target).sort((left,right)=>left<right?-1:1);if(missingTargets.length>0&&params.allowUnresolved!==!0)throw new PmCliError(`Dependency target${missingTargets.length===1?"":"s"} not found: ${missingTargets.join(", ")}`,EXIT_CODE.NOT_FOUND,{code:"dependency_target_not_found",reason:"unresolved_local_dependency",required:"Every local dependency target must exist before the edge is committed.",why:"Fail-fast target resolution prevents dangling graph nodes and preserves reliable traversal semantics.",unresolved_targets:missingTargets,examples:["--dep id=<existing-item-id>,kind=related","--dep id=<external-id>,kind=related,source_kind=external","--allow-unresolved-deps --dep id=<future-item-id>,kind=related"],nextSteps:[`Create or correct ${missingTargets.length===1?"the target":"the targets"}, then retry the mutation.`,"Use source_kind=external for a cross-workspace reference.","Use --allow-unresolved-deps only when the dangling local edge is intentional."],recovery:{recovery_mode:"compact",missing:missingTargets,suggested_flags:["--allow-unresolved-deps"],suggested_retry:`pm search "${missingTargets[0]}" --limit 10`}});return await assertTemporalDependencyChronology({dependencies:localDependencies,missingTargets,resolutions,holders:params.holders??[],registry,context:params}),missingTargets.map(target=>`dependency_target_unresolved:${target}`)}export{assertDependencyEdgesAllowed,assertDependencyTargetsResolvable,assertValidBareDependencyFlagValue,requireDependencyKind};
 //# sourceMappingURL=dependency-flag-validation.js.map