@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/graph/governance.d.ts

@@ -22,124 +22,124 @@ export type { RelationshipAuditFindingCode } from "./governance-contracts.js";
 export type RelationshipAuditSeverity = "error" | "warning" | "info";
 /** One policy-aware relationship audit finding with bounded evidence. */
 export interface RelationshipAuditFinding {
-    /** Machine-readable finding family identifier. */
-    code: RelationshipAuditFindingCode;
-    /** Severity of the violated policy. */
-    severity: RelationshipAuditSeverity;
-    /** Policy statement this finding violates. */
-    policy: string;
-    /** Human-readable summary including the affected count. */
-    message: string;
-    /** Total number of affected subjects, independent of sample bounding. */
-    count: number;
-    /** Deterministic bounded sample of affected subjects. */
-    sample: string[];
-    /** Optional exact evidence that explains why the sampled subjects were selected. */
-    evidence?: string[];
-    /** Whether {@link sample} was truncated by the configured sample bound. */
-    sample_truncated: boolean;
-    /** Safe machine-actionable next step; audits never invent or auto-apply edges. */
-    remediation: string;
+/** Machine-readable finding family identifier. */
+code: RelationshipAuditFindingCode;
+/** Severity of the violated policy. */
+severity: RelationshipAuditSeverity;
+/** Policy statement this finding violates. */
+policy: string;
+/** Human-readable summary including the affected count. */
+message: string;
+/** Total number of affected subjects, independent of sample bounding. */
+count: number;
+/** Deterministic bounded sample of affected subjects. */
+sample: string[];
+/** Optional exact evidence that explains why the sampled subjects were selected. */
+evidence?: string[];
+/** Whether {@link sample} was truncated by the configured sample bound. */
+sample_truncated: boolean;
+/** Safe machine-actionable next step; audits never invent or auto-apply edges. */
+remediation: string;
 }
 /** Per-item-type connectivity coverage inside a coverage profile. */
 export interface RelationshipCoverageTypeProfile {
-    /** Active nodes declaring this item type. */
-    active: number;
-    /** Active nodes of this type with no incident edges. */
-    isolated: number;
-    /** Active nodes of this type with at most one incident edge, isolates included. */
-    degree_leq_one: number;
+/** Active nodes declaring this item type. */
+active: number;
+/** Active nodes of this type with no incident edges. */
+isolated: number;
+/** Active nodes of this type with at most one incident edge, isolates included. */
+degree_leq_one: number;
 }
 /** Aggregate structural coverage metrics for one assembled workspace graph. */
 export interface RelationshipCoverageProfile extends RelationshipLifecycleCoverage {
-    /** Structural ordering acyclicity across all lifecycle states, independent of finding severity. */
-    ordering_acyclic: boolean;
-    /** Whether every ordering cycle is confined to terminal items. */
-    active_ordering_acyclic: boolean;
-    /** Total indexed nodes including materialized missing placeholders. */
-    nodes: number;
-    /** Tracker-recorded nodes, excluding synthesized missing and external placeholders. */
-    recorded_nodes?: number;
-    /** Total deduplicated indexed edges. */
-    edges: number;
-    /** Edges that remain after excluding redundant and contradictory storage rows. */
-    informative_edges?: number;
-    /** Stored edges implied by a bounded longer path in the same semantic family. */
-    redundant_edges?: number;
-    /** Structured ordering edges that contradict a same-target scalar blocker. */
-    ordering_contradiction_edges?: number;
-    /** Counting convention used by edges and edges_by_kind. */
-    edge_basis: "deduplicated_directed";
-    /** Deterministic per-kind edge counts. */
-    edges_by_kind: Record<string, number>;
-    /** Per-kind share of all deduplicated directed edges. */
-    edge_share_by_kind: Record<string, number>;
-    /** Edges carrying discovery, provenance, incident, or verification semantics. */
-    semantic_edges: number;
-    /** Share of all edges carrying discovery, provenance, incident, or verification semantics. */
-    semantic_edge_share: number;
-    /** Nodes whose lifecycle status is active (non-terminal, non-missing). */
-    active_nodes: number;
-    /** Materialized placeholder nodes for referenced-but-absent items. */
-    missing_nodes: number;
-    /** Active nodes with no incident edges at all. */
-    isolated_active_nodes: number;
-    /** Active nodes with at most one incident edge, isolates included. */
-    degree_leq_one_active_nodes: number;
-    /** Deterministic per-type connectivity coverage; untyped nodes bucket under `(untyped)`. */
-    coverage_by_type: Record<string, RelationshipCoverageTypeProfile>;
-    /** Undirected cut vertices whose removal increases the component count. */
-    articulation_points: number;
-    /** Undirected cut edges whose removal disconnects their endpoints. */
-    bridge_edges: number;
-    /** Milestone nodes whose title explicitly declares an outcome. */
-    outcome_nodes: number;
-    /** Declared edge kinds and directions admitted by typed outcome reachability. */
-    outcome_reachability_basis: Record<RelationshipOutcomeTraversal, string>;
-    /** Active non-outcome nodes with a path admitted by outcome_reachability_basis. */
-    active_outcome_reachable_nodes: number;
-    /** Active non-outcome nodes without a path admitted by outcome_reachability_basis. */
-    active_outcome_unreachable_nodes: number;
-    /** Active typed-outcome reachability expressed as integer basis points. */
-    active_outcome_reachability_basis_points: number;
-    /** Terminal non-placeholder, non-outcome nodes included in the all-status census. */
-    terminal_nodes: number;
-    /** Terminal non-outcome nodes with a path admitted by outcome_reachability_basis. */
-    terminal_outcome_reachable_nodes: number;
-    /** Terminal non-outcome nodes without a path admitted by outcome_reachability_basis. */
-    terminal_outcome_unreachable_nodes: number;
-    /** Terminal typed-outcome reachability expressed as integer basis points. */
-    terminal_outcome_reachability_basis_points: number;
-    /** All active and terminal non-outcome nodes with a typed path to an outcome. */
-    outcome_reachable_nodes: number;
-    /** All active and terminal non-outcome nodes without a typed path to an outcome. */
-    outcome_unreachable_nodes: number;
-    /** All-status typed-outcome reachability expressed as integer basis points. */
-    outcome_reachability_basis_points: number;
-    /** Affected-subject census containing every known finding code, including zero populations. */
-    finding_subjects_by_code: Record<RelationshipAuditFindingCode, number>;
+/** Structural ordering acyclicity across all lifecycle states, independent of finding severity. */
+ordering_acyclic: boolean;
+/** Whether every ordering cycle is confined to terminal items. */
+active_ordering_acyclic: boolean;
+/** Total indexed nodes including materialized missing placeholders. */
+nodes: number;
+/** Tracker-recorded nodes, excluding synthesized missing and external placeholders. */
+recorded_nodes?: number;
+/** Total deduplicated indexed edges. */
+edges: number;
+/** Edges that remain after excluding redundant and contradictory storage rows. */
+informative_edges?: number;
+/** Stored edges implied by a bounded longer path in the same semantic family. */
+redundant_edges?: number;
+/** Structured ordering edges that contradict a same-target scalar blocker. */
+ordering_contradiction_edges?: number;
+/** Counting convention used by edges and edges_by_kind. */
+edge_basis: "deduplicated_directed";
+/** Deterministic per-kind edge counts. */
+edges_by_kind: Record<string, number>;
+/** Per-kind share of all deduplicated directed edges. */
+edge_share_by_kind: Record<string, number>;
+/** Edges carrying discovery, provenance, incident, or verification semantics. */
+semantic_edges: number;
+/** Share of all edges carrying discovery, provenance, incident, or verification semantics. */
+semantic_edge_share: number;
+/** Nodes whose lifecycle status is active (non-terminal, non-missing). */
+active_nodes: number;
+/** Materialized placeholder nodes for referenced-but-absent items. */
+missing_nodes: number;
+/** Active nodes with no incident edges at all. */
+isolated_active_nodes: number;
+/** Active nodes with at most one incident edge, isolates included. */
+degree_leq_one_active_nodes: number;
+/** Deterministic per-type connectivity coverage; untyped nodes bucket under `(untyped)`. */
+coverage_by_type: Record<string, RelationshipCoverageTypeProfile>;
+/** Undirected cut vertices whose removal increases the component count. */
+articulation_points: number;
+/** Undirected cut edges whose removal disconnects their endpoints. */
+bridge_edges: number;
+/** Milestone nodes whose title explicitly declares an outcome. */
+outcome_nodes: number;
+/** Declared edge kinds and directions admitted by typed outcome reachability. */
+outcome_reachability_basis: Record<RelationshipOutcomeTraversal, string>;
+/** Active non-outcome nodes with a path admitted by outcome_reachability_basis. */
+active_outcome_reachable_nodes: number;
+/** Active non-outcome nodes without a path admitted by outcome_reachability_basis. */
+active_outcome_unreachable_nodes: number;
+/** Active typed-outcome reachability expressed as integer basis points. */
+active_outcome_reachability_basis_points: number;
+/** Terminal non-placeholder, non-outcome nodes included in the all-status census. */
+terminal_nodes: number;
+/** Terminal non-outcome nodes with a path admitted by outcome_reachability_basis. */
+terminal_outcome_reachable_nodes: number;
+/** Terminal non-outcome nodes without a path admitted by outcome_reachability_basis. */
+terminal_outcome_unreachable_nodes: number;
+/** Terminal typed-outcome reachability expressed as integer basis points. */
+terminal_outcome_reachability_basis_points: number;
+/** All active and terminal non-outcome nodes with a typed path to an outcome. */
+outcome_reachable_nodes: number;
+/** All active and terminal non-outcome nodes without a typed path to an outcome. */
+outcome_unreachable_nodes: number;
+/** All-status typed-outcome reachability expressed as integer basis points. */
+outcome_reachability_basis_points: number;
+/** Affected-subject census containing every known finding code, including zero populations. */
+finding_subjects_by_code: Record<RelationshipAuditFindingCode, number>;
 }
 /** Tuning and policy inputs accepted by the relationship audit. */
 export interface RelationshipAuditOptions {
-    /** Terminal-lifecycle predicate; defaults to the built-in closed/canceled statuses. */
-    isTerminal?: (status: string) => boolean;
-    /** Blocked-lifecycle predicate for stale-block detection; defaults to `status === "blocked"`. */
-    isBlocked?: (status: string) => boolean;
-    /** Node identifiers that are explicitly valid isolates (roots, archives, scratch work). */
-    exemptIsolates?: readonly string[];
-    /** Item types whose active nodes are policy-valid isolates or sparse nodes (case-insensitive); they stay in the coverage profile but raise no coverage finding. */
-    isolateExemptTypes?: readonly string[];
-    /** Maximum sample entries retained per finding; defaults to 25. */
-    maxSampleSize?: number;
-    /** Abort signal checked between finding families. */
-    signal?: AbortSignal;
+/** Terminal-lifecycle predicate; defaults to the built-in closed/canceled statuses. */
+isTerminal?: (status: string) => boolean;
+/** Blocked-lifecycle predicate for stale-block detection; defaults to `status === "blocked"`. */
+isBlocked?: (status: string) => boolean;
+/** Node identifiers that are explicitly valid isolates (roots, archives, scratch work). */
+exemptIsolates?: readonly string[];
+/** Item types whose active nodes are policy-valid isolates or sparse nodes (case-insensitive); they stay in the coverage profile but raise no coverage finding. */
+isolateExemptTypes?: readonly string[];
+/** Maximum sample entries retained per finding; defaults to 25. */
+maxSampleSize?: number;
+/** Abort signal checked between finding families. */
+signal?: AbortSignal;
 }
 /** Complete deterministic result of one relationship-graph audit. */
 export interface RelationshipAuditReport {
-    /** Findings ordered by severity, then code, then first sample subject. */
-    findings: RelationshipAuditFinding[];
-    /** Structural coverage metrics computed during the audit. */
-    profile: RelationshipCoverageProfile;
+/** Findings ordered by severity, then code, then first sample subject. */
+findings: RelationshipAuditFinding[];
+/** Structural coverage metrics computed during the audit. */
+profile: RelationshipCoverageProfile;
 }
 /** Return whether a relationship kind carries provenance or verification context. */
 export declare function isSemanticContextKind(kind: string): boolean;
@@ -156,12 +156,12 @@ export declare function collectOrderingCycles(successors: Map<string, string[]>)
 export declare function formatOrderingStorageContradiction(contradiction: Pick<OrderingStorageContradiction, "holder_id" | "target_id" | "dependency_kind">): string;
 /** One duplicate-edge group in semantic orientation with its stored spellings. */
 export interface DuplicateRelationshipEdgeGroup {
-    /** Semantic tail node shared by every stored spelling. */
-    from: string;
-    /** Semantic head node shared by every stored spelling. */
-    to: string;
-    /** Stored parallel edges sorted by kind. */
-    edges: RelationshipEdge[];
+/** Semantic tail node shared by every stored spelling. */
+from: string;
+/** Semantic head node shared by every stored spelling. */
+to: string;
+/** Stored parallel edges sorted by kind. */
+edges: RelationshipEdge[];
 }
 /** Format one duplicate-edge group as a compact deterministic evidence string. */
 export declare function formatDuplicateEdgeGroup(group: DuplicateRelationshipEdgeGroup): string;
@@ -188,62 +188,62 @@ export declare function collectDuplicateRelationshipEdgeGroups(assembly: Workspa
 export declare function auditWorkspaceRelationshipGraph(assembly: WorkspaceRelationshipAssembly, options?: RelationshipAuditOptions): RelationshipAuditReport;
 /** One persisted point-in-time audit census used for temporal comparison. */
 export interface RelationshipAuditSnapshot {
-    /** ISO timestamp the snapshot was taken at. */
-    saved_at: string;
-    /** Workspace graph fingerprint of the audited item snapshot. */
-    fingerprint: string;
-    /** Affected-subject counts keyed by finding code at snapshot time. */
-    affected_subjects_by_code: Record<string, number>;
-    /** Structural coverage profile at snapshot time. */
-    profile: RelationshipCoverageProfile;
+/** ISO timestamp the snapshot was taken at. */
+saved_at: string;
+/** Workspace graph fingerprint of the audited item snapshot. */
+fingerprint: string;
+/** Affected-subject counts keyed by finding code at snapshot time. */
+affected_subjects_by_code: Record<string, number>;
+/** Structural coverage profile at snapshot time. */
+profile: RelationshipCoverageProfile;
 }
 /** Signed change between two audit snapshots; zero-change keys are dropped. */
 export interface RelationshipAuditDelta {
-    /** ISO timestamp of the baseline snapshot the delta is measured against. */
-    baseline_saved_at: string;
-    /** Whether both snapshots audited the identical workspace fingerprint. */
-    same_snapshot: boolean;
-    /** Signed affected-subject deltas keyed by finding code. */
-    affected_subjects_by_code: Record<string, number>;
-    /** Signed structural profile deltas. */
-    profile: {
-        /** Whether both snapshots measured lifecycle census fields. */
-        lifecycle_comparable?: boolean;
-        /** Signed population deltas, absent for legacy baselines lacking this census. */
-        coverage_by_lifecycle?: RelationshipLifecycleCoverage["coverage_by_lifecycle"];
-        /** Signed raw-status population deltas, absent for legacy baselines. */
-        coverage_by_status?: RelationshipLifecycleCoverage["coverage_by_status"];
-        /** Node-count change including missing placeholders. */
-        nodes: number;
-        /** Tracker-recorded node-count change excluding synthesized placeholders. */
-        recorded_nodes?: number;
-        /** Deduplicated edge-count change. */
-        edges: number;
-        /** Informative edge-count change after non-information deductions. */
-        informative_edges?: number;
-        /** Redundant edge-count change. */
-        redundant_edges?: number;
-        /** Ordering contradiction edge-count change. */
-        ordering_contradiction_edges?: number;
-        /** Active-node-count change. */
-        active_nodes: number;
-        /** Missing-placeholder-count change. */
-        missing_nodes: number;
-        /** Isolated-active-node-count change. */
-        isolated_active_nodes: number;
-        /** Degree-at-most-one active-node-count change. */
-        degree_leq_one_active_nodes: number;
-        /** Signed per-kind edge-count deltas; unchanged kinds are dropped. */
-        edges_by_kind: Record<string, number>;
-        /** Signed per-kind edge-share deltas; unchanged kinds are dropped. */
-        edge_share_by_kind: Record<string, number>;
-        /** Change in semantic-context edge count. */
-        semantic_edges: number;
-        /** Change in semantic-context edge share. */
-        semantic_edge_share: number;
-        /** Signed per-type coverage deltas; unchanged types are dropped. */
-        coverage_by_type: Record<string, RelationshipCoverageTypeProfile>;
-    };
+/** ISO timestamp of the baseline snapshot the delta is measured against. */
+baseline_saved_at: string;
+/** Whether both snapshots audited the identical workspace fingerprint. */
+same_snapshot: boolean;
+/** Signed affected-subject deltas keyed by finding code. */
+affected_subjects_by_code: Record<string, number>;
+/** Signed structural profile deltas. */
+profile: {
+/** Whether both snapshots measured lifecycle census fields. */
+lifecycle_comparable?: boolean;
+/** Signed population deltas, absent for legacy baselines lacking this census. */
+coverage_by_lifecycle?: RelationshipLifecycleCoverage["coverage_by_lifecycle"];
+/** Signed raw-status population deltas, absent for legacy baselines. */
+coverage_by_status?: RelationshipLifecycleCoverage["coverage_by_status"];
+/** Node-count change including missing placeholders. */
+nodes: number;
+/** Tracker-recorded node-count change excluding synthesized placeholders. */
+recorded_nodes?: number;
+/** Deduplicated edge-count change. */
+edges: number;
+/** Informative edge-count change after non-information deductions. */
+informative_edges?: number;
+/** Redundant edge-count change. */
+redundant_edges?: number;
+/** Ordering contradiction edge-count change. */
+ordering_contradiction_edges?: number;
+/** Active-node-count change. */
+active_nodes: number;
+/** Missing-placeholder-count change. */
+missing_nodes: number;
+/** Isolated-active-node-count change. */
+isolated_active_nodes: number;
+/** Degree-at-most-one active-node-count change. */
+degree_leq_one_active_nodes: number;
+/** Signed per-kind edge-count deltas; unchanged kinds are dropped. */
+edges_by_kind: Record<string, number>;
+/** Signed per-kind edge-share deltas; unchanged kinds are dropped. */
+edge_share_by_kind: Record<string, number>;
+/** Change in semantic-context edge count. */
+semantic_edges: number;
+/** Change in semantic-context edge share. */
+semantic_edge_share: number;
+/** Signed per-type coverage deltas; unchanged types are dropped. */
+coverage_by_type: Record<string, RelationshipCoverageTypeProfile>;
+};
 }
 /**
  * Compare two point-in-time audit snapshots and return the signed change in

package/dist/sdk/graph/hierarchy-integrity.d.ts

@@ -4,76 +4,76 @@ import type { RelationshipKindRegistry } from "../relationships.js";
 export type HierarchyRelationSource = "scalar_parent" | "dependency";
 /** Minimal workspace item shape required by hierarchy-integrity analysis. */
 export interface HierarchyIntegrityItem {
-    /** Stable item identifier. */
-    id: string;
-    /** Lifecycle status used to classify historical-only defects. */
-    status: ItemStatus;
-    /** Optional scalar structural parent. */
-    parent?: string;
-    /** Structured relationship rows that may carry hierarchy semantics. */
-    dependencies?: Dependency[];
+/** Stable item identifier. */
+id: string;
+/** Lifecycle status used to classify historical-only defects. */
+status: ItemStatus;
+/** Optional scalar structural parent. */
+parent?: string;
+/** Structured relationship rows that may carry hierarchy semantics. */
+dependencies?: Dependency[];
 }
 /** One canonical parent-to-child relation with exact stored-row provenance. */
 export interface HierarchyRelation {
-    /** Canonical structural parent identifier. */
-    parent_id: string;
-    /** Canonical structural child identifier. */
-    child_id: string;
-    /** Storage surface that asserted the relation. */
-    source: HierarchyRelationSource;
-    /** Canonical relationship kind, or `parent` for the scalar field. */
-    kind: string;
-    /** Item document that stores the relation. */
-    holder_id: string;
-    /** Referenced endpoint for dependency-backed relations. */
-    target_id?: string;
-    /** Registry cardinality at the child endpoint of this relation. */
-    child_cardinality: "one" | "many";
+/** Canonical structural parent identifier. */
+parent_id: string;
+/** Canonical structural child identifier. */
+child_id: string;
+/** Storage surface that asserted the relation. */
+source: HierarchyRelationSource;
+/** Canonical relationship kind, or `parent` for the scalar field. */
+kind: string;
+/** Item document that stores the relation. */
+holder_id: string;
+/** Referenced endpoint for dependency-backed relations. */
+target_id?: string;
+/** Registry cardinality at the child endpoint of this relation. */
+child_cardinality: "one" | "many";
 }
 /** One strongly connected hierarchy component. */
 export interface HierarchyCycle {
-    /** Deterministically sorted item identifiers in the cycle. */
-    item_ids: string[];
-    /** Whether every member is in a terminal lifecycle state. */
-    legacy_terminal: boolean;
+/** Deterministically sorted item identifiers in the cycle. */
+item_ids: string[];
+/** Whether every member is in a terminal lifecycle state. */
+legacy_terminal: boolean;
 }
 /** One child assigned to more than one logical parent. */
 export interface HierarchyCardinalityViolation {
-    /** Child whose parent cardinality was exceeded. */
-    child_id: string;
-    /** Deterministically sorted unique parent identifiers. */
-    parent_ids: string[];
-    /** Whether the child and every asserted parent are terminal. */
-    legacy_terminal: boolean;
+/** Child whose parent cardinality was exceeded. */
+child_id: string;
+/** Deterministically sorted unique parent identifiers. */
+parent_ids: string[];
+/** Whether the child and every asserted parent are terminal. */
+legacy_terminal: boolean;
 }
 /** One scalar parent that disagrees with dependency-backed hierarchy evidence. */
 export interface HierarchyParentDivergence {
-    /** Child whose hierarchy storage surfaces disagree. */
-    child_id: string;
-    /** Parent declared by the scalar metadata field. */
-    scalar_parent_id: string;
-    /** Different dependency-backed parent identifiers. */
-    dependency_parent_ids: string[];
-    /** Whether the child and every asserted parent are terminal. */
-    legacy_terminal: boolean;
+/** Child whose hierarchy storage surfaces disagree. */
+child_id: string;
+/** Parent declared by the scalar metadata field. */
+scalar_parent_id: string;
+/** Different dependency-backed parent identifiers. */
+dependency_parent_ids: string[];
+/** Whether the child and every asserted parent are terminal. */
+legacy_terminal: boolean;
 }
 /** Complete deterministic hierarchy-integrity projection for a workspace. */
 export interface HierarchyIntegrityAnalysis {
-    /** Normalized evidence rows retained for exact diagnostics and repair. */
-    relations: HierarchyRelation[];
-    /** Cyclic structural components. */
-    cycles: HierarchyCycle[];
-    /** Logical one-parent cardinality violations. */
-    cardinality_violations: HierarchyCardinalityViolation[];
-    /** Scalar and dependency-backed parent disagreements. */
-    divergences: HierarchyParentDivergence[];
+/** Normalized evidence rows retained for exact diagnostics and repair. */
+relations: HierarchyRelation[];
+/** Cyclic structural components. */
+cycles: HierarchyCycle[];
+/** Logical one-parent cardinality violations. */
+cardinality_violations: HierarchyCardinalityViolation[];
+/** Scalar and dependency-backed parent disagreements. */
+divergences: HierarchyParentDivergence[];
 }
 /** Deterministic adjacency indexes derived from normalized hierarchy evidence. */
 export interface HierarchyRelationIndexes {
-    /** Unique logical parents keyed by child id. */
-    parents_by_child: ReadonlyMap<string, readonly string[]>;
-    /** Unique logical children keyed by parent id. */
-    children_by_parent: ReadonlyMap<string, readonly string[]>;
+/** Unique logical parents keyed by child id. */
+parents_by_child: ReadonlyMap<string, readonly string[]>;
+/** Unique logical children keyed by parent id. */
+children_by_parent: ReadonlyMap<string, readonly string[]>;
 }
 /** Collect normalized hierarchy evidence without running defect analysis. */
 export declare function collectHierarchyRelations(items: readonly HierarchyIntegrityItem[], registry?: RelationshipKindRegistry): HierarchyRelation[];

package/dist/sdk/graph/index.d.ts

@@ -22,4 +22,5 @@ export { enumerateRelationshipPaths, hierarchyAncestors, hierarchyDescendants, o
 export { computeWorkspaceGraphFingerprint, resetWorkspaceGraphCache, workspaceGraphCache, WorkspaceGraphCache, type GraphCacheMetadata, type WorkspaceGraphCacheLookup, } from "./cache.js";
 export { planRelationshipRemediation, type RelationshipRemediationCode, type RelationshipRemediationConfidence, type RelationshipRemediationOperation, type RelationshipRemediationPlan, type RelationshipRemediationPlanOptions, type RelationshipRemediationStep, } from "./remediation.js";
 export { collectNewOrderingCycleWarnings } from "./mutation-advisory.js";
+export { assertNonHierarchyCardinalityMutationAllowed, type RelationshipCardinalityItem } from "./cardinality-integrity.js";
 export { GRAPH_SUBCOMMAND_VALUES, parseGraphSubcommand, runGraph, type GraphAnalyzeResult, type GraphArticulationResult, type GraphAuditResult, type GraphAuditSummaryResult, type GraphBridgeRow, type GraphCentralityResult, type GraphCentralityRow, type GraphCommandOptions, type GraphCommunitiesResult, type GraphCommunityRow, type GraphDominatorRow, type GraphDominatorsResult, type GraphExecutionSummary, type GraphImpactResult, type GraphImpactRow, type GraphHierarchySummary, type GraphIndexResult, type GraphKnowledgeSummary, type GraphPathRow, type GraphPathsResult, type GraphPlanResult, type GraphQueryCost, type GraphRedundancyResult, type GraphRedundancyRow, type GraphResult, type GraphScheduleRow, type GraphSlackResult, type GraphSubcommand, type GraphTraversalResult, } from "./run.js";

package/dist/sdk/graph/index.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]="df28925a-72d8-5d39-accf-e295ee01d3f9")}catch{}})();export*from"./query-contracts.js";import{computeRelationshipDominators,detectRelationshipCommunities,findRedundantRelationshipEdges,forEachMatchedRelationshipEdge}from"./analytics.js";import{computeRelationshipCentrality,findRelationshipCutStructure}from"./centrality.js";import{createRelationshipGraphSnapshot,federateRelationshipGraphSnapshots,loadRelationshipGraphAdapter,MemoryRelationshipGraphAdapter,parseRelationshipGraphSnapshot,RELATIONSHIP_GRAPH_SNAPSHOT_VERSION,syncRelationshipGraphAdapter}from"./adapter.js";import{assertMemoryRelationshipGraphAdapterConformance,assertRelationshipGraphAdapterConformance,createRelationshipGraphScaleFixture}from"./conformance.js";import{analyzeRelationshipSchedule}from"./scheduling.js";import{deriveRelationshipDeadlines}from"./deadline-scheduling.js";import{assembleWorkspaceRelationshipGraph,collectDanglingDependencyReferences,collectDuplicateDependencyRows,collectMissingDependencyTargetIds,collectOrderingStorageContradictions,normalizeDependencyGraphTarget,resolveWorkspaceRelationshipKindRegistry}from"./assembly.js";import{auditWorkspaceRelationshipGraph,collectDuplicateRelationshipEdgeGroups,collectOrderingCycles,diffRelationshipAuditSnapshots,formatDuplicateEdgeGroup,formatOrderingStorageContradiction}from"./governance.js";import{analyzeHierarchyIntegrity,assertHierarchyMutationAllowed,collectHierarchyRelations,formatHierarchyRelation,indexHierarchyRelations}from"./hierarchy-integrity.js";import{clearDurableGraphCache,durableGraphCachePath,durableGraphCacheStatus,GRAPH_DURABLE_CACHE_MIN_ITEMS,GRAPH_DURABLE_CACHE_VERSION,graphAuditBaselinePath,loadGraphAuditBaseline,openDurableGraphCache,persistDurableGraphResult,saveGraphAuditBaseline,shouldPersistDurableGraphCache}from"./durable-cache.js";import{enumerateRelationshipPaths,hierarchyAncestors,hierarchyDescendants,orderingPredecessors,orderingSuccessors}from"./traversal.js";import{computeWorkspaceGraphFingerprint,resetWorkspaceGraphCache,workspaceGraphCache,WorkspaceGraphCache}from"./cache.js";import{planRelationshipRemediation}from"./remediation.js";import{collectNewOrderingCycleWarnings}from"./mutation-advisory.js";import{GRAPH_SUBCOMMAND_VALUES,parseGraphSubcommand,runGraph}from"./run.js";export{GRAPH_DURABLE_CACHE_MIN_ITEMS,GRAPH_DURABLE_CACHE_VERSION,GRAPH_SUBCOMMAND_VALUES,MemoryRelationshipGraphAdapter,RELATIONSHIP_GRAPH_SNAPSHOT_VERSION,WorkspaceGraphCache,analyzeHierarchyIntegrity,analyzeRelationshipSchedule,assembleWorkspaceRelationshipGraph,assertHierarchyMutationAllowed,assertMemoryRelationshipGraphAdapterConformance,assertRelationshipGraphAdapterConformance,auditWorkspaceRelationshipGraph,clearDurableGraphCache,collectDanglingDependencyReferences,collectDuplicateDependencyRows,collectDuplicateRelationshipEdgeGroups,collectHierarchyRelations,collectMissingDependencyTargetIds,collectNewOrderingCycleWarnings,collectOrderingCycles,collectOrderingStorageContradictions,computeRelationshipCentrality,computeRelationshipDominators,computeWorkspaceGraphFingerprint,createRelationshipGraphScaleFixture,createRelationshipGraphSnapshot,deriveRelationshipDeadlines,detectRelationshipCommunities,diffRelationshipAuditSnapshots,durableGraphCachePath,durableGraphCacheStatus,enumerateRelationshipPaths,federateRelationshipGraphSnapshots,findRedundantRelationshipEdges,findRelationshipCutStructure,forEachMatchedRelationshipEdge,formatDuplicateEdgeGroup,formatHierarchyRelation,formatOrderingStorageContradiction,graphAuditBaselinePath,hierarchyAncestors,hierarchyDescendants,indexHierarchyRelations,loadGraphAuditBaseline,loadRelationshipGraphAdapter,normalizeDependencyGraphTarget,openDurableGraphCache,orderingPredecessors,orderingSuccessors,parseGraphSubcommand,parseRelationshipGraphSnapshot,persistDurableGraphResult,planRelationshipRemediation,resetWorkspaceGraphCache,resolveWorkspaceRelationshipKindRegistry,runGraph,saveGraphAuditBaseline,shouldPersistDurableGraphCache,syncRelationshipGraphAdapter,workspaceGraphCache};
+(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]="58736688-35d0-545d-892e-e0ede7fedc1a")}catch{}})();export*from"./query-contracts.js";import{computeRelationshipDominators,detectRelationshipCommunities,findRedundantRelationshipEdges,forEachMatchedRelationshipEdge}from"./analytics.js";import{computeRelationshipCentrality,findRelationshipCutStructure}from"./centrality.js";import{createRelationshipGraphSnapshot,federateRelationshipGraphSnapshots,loadRelationshipGraphAdapter,MemoryRelationshipGraphAdapter,parseRelationshipGraphSnapshot,RELATIONSHIP_GRAPH_SNAPSHOT_VERSION,syncRelationshipGraphAdapter}from"./adapter.js";import{assertMemoryRelationshipGraphAdapterConformance,assertRelationshipGraphAdapterConformance,createRelationshipGraphScaleFixture}from"./conformance.js";import{analyzeRelationshipSchedule}from"./scheduling.js";import{deriveRelationshipDeadlines}from"./deadline-scheduling.js";import{assembleWorkspaceRelationshipGraph,collectDanglingDependencyReferences,collectDuplicateDependencyRows,collectMissingDependencyTargetIds,collectOrderingStorageContradictions,normalizeDependencyGraphTarget,resolveWorkspaceRelationshipKindRegistry}from"./assembly.js";import{auditWorkspaceRelationshipGraph,collectDuplicateRelationshipEdgeGroups,collectOrderingCycles,diffRelationshipAuditSnapshots,formatDuplicateEdgeGroup,formatOrderingStorageContradiction}from"./governance.js";import{analyzeHierarchyIntegrity,assertHierarchyMutationAllowed,collectHierarchyRelations,formatHierarchyRelation,indexHierarchyRelations}from"./hierarchy-integrity.js";import{clearDurableGraphCache,durableGraphCachePath,durableGraphCacheStatus,GRAPH_DURABLE_CACHE_MIN_ITEMS,GRAPH_DURABLE_CACHE_VERSION,graphAuditBaselinePath,loadGraphAuditBaseline,openDurableGraphCache,persistDurableGraphResult,saveGraphAuditBaseline,shouldPersistDurableGraphCache}from"./durable-cache.js";import{enumerateRelationshipPaths,hierarchyAncestors,hierarchyDescendants,orderingPredecessors,orderingSuccessors}from"./traversal.js";import{computeWorkspaceGraphFingerprint,resetWorkspaceGraphCache,workspaceGraphCache,WorkspaceGraphCache}from"./cache.js";import{planRelationshipRemediation}from"./remediation.js";import{collectNewOrderingCycleWarnings}from"./mutation-advisory.js";import{assertNonHierarchyCardinalityMutationAllowed}from"./cardinality-integrity.js";import{GRAPH_SUBCOMMAND_VALUES,parseGraphSubcommand,runGraph}from"./run.js";export{GRAPH_DURABLE_CACHE_MIN_ITEMS,GRAPH_DURABLE_CACHE_VERSION,GRAPH_SUBCOMMAND_VALUES,MemoryRelationshipGraphAdapter,RELATIONSHIP_GRAPH_SNAPSHOT_VERSION,WorkspaceGraphCache,analyzeHierarchyIntegrity,analyzeRelationshipSchedule,assembleWorkspaceRelationshipGraph,assertHierarchyMutationAllowed,assertMemoryRelationshipGraphAdapterConformance,assertNonHierarchyCardinalityMutationAllowed,assertRelationshipGraphAdapterConformance,auditWorkspaceRelationshipGraph,clearDurableGraphCache,collectDanglingDependencyReferences,collectDuplicateDependencyRows,collectDuplicateRelationshipEdgeGroups,collectHierarchyRelations,collectMissingDependencyTargetIds,collectNewOrderingCycleWarnings,collectOrderingCycles,collectOrderingStorageContradictions,computeRelationshipCentrality,computeRelationshipDominators,computeWorkspaceGraphFingerprint,createRelationshipGraphScaleFixture,createRelationshipGraphSnapshot,deriveRelationshipDeadlines,detectRelationshipCommunities,diffRelationshipAuditSnapshots,durableGraphCachePath,durableGraphCacheStatus,enumerateRelationshipPaths,federateRelationshipGraphSnapshots,findRedundantRelationshipEdges,findRelationshipCutStructure,forEachMatchedRelationshipEdge,formatDuplicateEdgeGroup,formatHierarchyRelation,formatOrderingStorageContradiction,graphAuditBaselinePath,hierarchyAncestors,hierarchyDescendants,indexHierarchyRelations,loadGraphAuditBaseline,loadRelationshipGraphAdapter,normalizeDependencyGraphTarget,openDurableGraphCache,orderingPredecessors,orderingSuccessors,parseGraphSubcommand,parseRelationshipGraphSnapshot,persistDurableGraphResult,planRelationshipRemediation,resetWorkspaceGraphCache,resolveWorkspaceRelationshipKindRegistry,runGraph,saveGraphAuditBaseline,shouldPersistDurableGraphCache,syncRelationshipGraphAdapter,workspaceGraphCache};
 //# sourceMappingURL=index.js.map

package/dist/sdk/graph/lifecycle-coverage.d.ts

@@ -2,25 +2,25 @@
 import type { WorkspaceRelationshipAssembly } from "./assembly.js";
 /** Connectivity counts over an explicitly named recorded-node population. */
 export interface RelationshipPopulationCoverage {
-    /** Recorded items in the population, including outcome anchors. */
-    nodes: number;
-    /** Items with no incident relationship. */
-    isolated: number;
-    /** Items with zero or one incident relationship. */
-    degree_leq_one: number;
-    /** Items with at least one incident provenance or verification edge. */
-    semantic_nodes: number;
-    /** Items without incident provenance or verification edges. */
-    without_semantic_edges: number;
-    /** Incident directed-edge degree distribution, keyed by exact degree. */
-    degree_histogram: Record<string, number>;
+/** Recorded items in the population, including outcome anchors. */
+nodes: number;
+/** Items with no incident relationship. */
+isolated: number;
+/** Items with zero or one incident relationship. */
+degree_leq_one: number;
+/** Items with at least one incident provenance or verification edge. */
+semantic_nodes: number;
+/** Items without incident provenance or verification edges. */
+without_semantic_edges: number;
+/** Incident directed-edge degree distribution, keyed by exact degree. */
+degree_histogram: Record<string, number>;
 }
 /** Named lifecycle slices and raw-status slices share the same counting convention. */
 export interface RelationshipLifecycleCoverage {
-    /** Missing and external placeholders are excluded from every population. */
-    coverage_by_lifecycle: Record<"all" | "active" | "terminal", RelationshipPopulationCoverage>;
-    /** Raw schema statuses are retained, including custom terminal statuses. */
-    coverage_by_status: Record<string, RelationshipPopulationCoverage>;
+/** Missing and external placeholders are excluded from every population. */
+coverage_by_lifecycle: Record<"all" | "active" | "terminal", RelationshipPopulationCoverage>;
+/** Raw schema statuses are retained, including custom terminal statuses. */
+coverage_by_status: Record<string, RelationshipPopulationCoverage>;
 }
 /** Count each recorded item once per slice; edge incidence uses the assembled graph's deduplicated directed basis. */
 export declare function profileRelationshipLifecycles(assembly: WorkspaceRelationshipAssembly, isTerminal: (status: string) => boolean, isSemantic: (kind: string) => boolean, signal?: AbortSignal): RelationshipLifecycleCoverage;
@@ -28,5 +28,5 @@ export declare function profileRelationshipLifecycles(assembly: WorkspaceRelatio
 export declare function validLifecycleSnapshot(profile: Record<string, unknown>): boolean;
 /** Compare measured lifecycle censuses; legacy baselines remain explicitly incomparable. */
 export declare function diffLifecycleCoverage(before: Partial<RelationshipLifecycleCoverage>, after: Partial<RelationshipLifecycleCoverage>): Partial<RelationshipLifecycleCoverage> & {
-    lifecycle_comparable: boolean;
+lifecycle_comparable: boolean;
 };

package/dist/sdk/graph/mutation-advisory.d.ts

@@ -13,12 +13,12 @@ import type { ItemMetadata } from "../../types/index.js";
 import type { RelationshipKindRegistry } from "../relationships.js";
 /** Lightweight ordering digraph over one immutable item snapshot. */
 interface OrderingDigraph {
-    /** Sorted successor adjacency oriented predecessor -> successor. */
-    successors: Map<string, string[]>;
-    /** Sorted predecessor adjacency, the reverse orientation of successors. */
-    predecessors: Map<string, string[]>;
-    /** Canonical original-case ids keyed by their lowercase spelling. */
-    canonicalIds: Map<string, string>;
+/** Sorted successor adjacency oriented predecessor -> successor. */
+successors: Map<string, string[]>;
+/** Sorted predecessor adjacency, the reverse orientation of successors. */
+predecessors: Map<string, string[]>;
+/** Canonical original-case ids keyed by their lowercase spelling. */
+canonicalIds: Map<string, string>;
 }
 /**
  * Build the ordering-only digraph for one item snapshot without assembling a
@@ -42,10 +42,10 @@ declare function findPathBackToStart(adjacency: ReadonlyMap<string, readonly str
 export declare function collectNewOrderingCycleWarnings(beforeItems: readonly ItemMetadata[], afterItems: readonly ItemMetadata[], changedItemId: string): string[];
 /** White-box graph-path helpers for exhaustive SDK primitive verification. */
 export declare const mutationAdvisoryTestOnly: {
-    buildOrderingDigraph: typeof buildOrderingDigraph;
-    collectWeakComponent: typeof collectWeakComponent;
-    induceSuccessors: typeof induceSuccessors;
-    findCyclePath: typeof findCyclePath;
-    findPathBackToStart: typeof findPathBackToStart;
+buildOrderingDigraph: typeof buildOrderingDigraph;
+collectWeakComponent: typeof collectWeakComponent;
+induceSuccessors: typeof induceSuccessors;
+findCyclePath: typeof findCyclePath;
+findPathBackToStart: typeof findPathBackToStart;
 };
 export {};