@unbrained/pm-cli 2026.8.16 → 2026.8.18

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

@@ -19,6 +19,8 @@ interface ClaimStateContext {
     last_release: ClaimHistoryContext | null;
 }
 type GetItemProjection = Partial<ItemMetadata> & {
+    /** Canonical item identity retained by every depth and field projection. */
+    id: string;
     body?: string;
     /** Number of notes omitted by a token-bounded projection. */
     notes_count?: number;

package/dist/sdk/query/get.js

@@ -4,7 +4,7 @@
  * Implements the SDK-owned item query shared by every surface.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="89176e36-40ea-5ec2-b291-d1cf042c4140")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c35e787c-a9a1-5ffa-9dcf-62780fceed4c")}catch(e){}}();
 import { pathExists, getActiveExtensionRegistrations, toItemRecord, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, TYPE_TO_FOLDER, PmCliError, buildItemNotFoundError, listAllItemMetadataLight, locateItem, readLocatedItem, getHistoryPath, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { readHistoryEntries } from "../history-read.js";
 import { recordContextUsageTouches } from "../context-usage.js";
@@ -44,7 +44,10 @@ function itemMaterialFieldGroups(item, body) {
     return [
         ...(body.length > 0 ? ["body"] : []),
         ...Object.entries(collectionCounts).flatMap(([name, count]) => count > 0 ? [name] : []),
-        ...(collectionCounts.files + collectionCounts.tests + collectionCounts.docs > 0
+        ...(collectionCounts.files +
+            collectionCounts.tests +
+            collectionCounts.docs >
+            0
             ? ["linked"]
             : []),
         "children",
@@ -195,6 +198,30 @@ function validateGetFields(fields, runtimeMetadataKeys) {
         });
     }
 }
+const EMPTY_PROJECTED_COLLECTION_FIELDS = new Set([
+    "comments",
+    "notes",
+    "learnings",
+    "files",
+    "tests",
+    "test_runs",
+    "docs",
+    "reminders",
+    "events",
+    "dependencies",
+    "plan_steps",
+    "plan_decisions",
+    "plan_discoveries",
+    "plan_validation",
+]);
+/** Resolve one projected metadata value while distinguishing an empty requested collection from an omitted field. */
+function projectedMetadataValue(source, counts, field) {
+    if (Object.hasOwn(counts, field))
+        return counts[field];
+    if (source[field] !== undefined)
+        return source[field];
+    return EMPTY_PROJECTED_COLLECTION_FIELDS.has(field) ? [] : undefined;
+}
 function projectItemForFields(item, fields) {
     const source = toItemRecord(item);
     const omittedCounts = {
@@ -202,7 +229,7 @@ function projectItemForFields(item, fields) {
         tests_count: item.tests?.length ?? 0,
         collection_counts: itemCollectionCounts(item),
     };
-    const projected = {};
+    const projected = { id: item.id };
     for (const field of fields) {
         const normalized = normalizeGetField(field);
         if (normalized === "body" ||
@@ -216,9 +243,7 @@ function projectItemForFields(item, fields) {
             normalized.startsWith("schedule.")) {
             continue;
         }
-        projected[normalized] = Object.hasOwn(omittedCounts, normalized)
-            ? omittedCounts[normalized]
-            : source[normalized];
+        projected[normalized] = projectedMetadataValue(source, omittedCounts, normalized);
     }
     return projected;
 }
@@ -438,4 +463,4 @@ export const _testOnlyGetCommand = {
     shouldAutoIncludeGetChildren,
 };
 //# sourceMappingURL=get.js.map
-//# debugId=89176e36-40ea-5ec2-b291-d1cf042c4140
+//# debugId=c35e787c-a9a1-5ffa-9dcf-62780fceed4c

package/dist/sdk/query/list.js

@@ -4,7 +4,7 @@
  * Implements the pm list command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ec0c4c57-e3c2-54b3-bcf4-b4ab3b1d964e")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="41f54a9b-b7ba-52c1-bd84-76aa57021827")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations, hasActiveOnReadHooks, } from "../../core/extensions/index.js";
 import { toItemRecord } from "../../core/item/item-record.js";
@@ -1106,6 +1106,9 @@ function buildVerboseListFilters(params) {
     if (noTruncate) {
         filters.no_truncate = true;
     }
+    if (options.strictRead === true) {
+        filters.strict_read = true;
+    }
     if (treeEnabled) {
         filters.tree = true;
         if (treeDepth !== undefined) {
@@ -1240,4 +1243,4 @@ export const _testOnly = {
     withTreeMetadata,
 };
 //# sourceMappingURL=list.js.map
-//# debugId=ec0c4c57-e3c2-54b3-bcf4-b4ab3b1d964e
+//# debugId=41f54a9b-b7ba-52c1-bd84-76aa57021827

package/dist/sdk/query.d.ts

@@ -4,6 +4,7 @@
  * Provides focused read, search, pagination, and context-ranking primitives.
  */
 export * from "./query/list.js";
+export * from "./query/complete-list.js";
 export * from "./query/search.js";
 export { runActivity, type ActivityCommandOptions, type ActivityEntry, type ActivityResult, type CompactActivityEntry, } from "./query/activity.js";
 export * from "./query/aggregate.js";

package/dist/sdk/query.js

@@ -4,8 +4,9 @@
  * Provides focused read, search, pagination, and context-ranking primitives.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5e04dc9d-8e2d-5ef2-bf8b-6b18bd87c3bc")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="036baf5a-3ba9-55ea-a11b-d9e94a848b92")}catch(e){}}();
 export * from "./query/list.js";
+export * from "./query/complete-list.js";
 export * from "./query/search.js";
 export { runActivity, } from "./query/activity.js";
 export * from "./query/aggregate.js";
@@ -29,4 +30,4 @@ export * from "./context-usage.js";
 export * from "./workspace-memory.js";
 export * from "./duplicates.js";
 //# sourceMappingURL=query.js.map
-//# debugId=5e04dc9d-8e2d-5ef2-bf8b-6b18bd87c3bc
+//# debugId=036baf5a-3ba9-55ea-a11b-d9e94a848b92

package/dist/sdk/read-output-contracts.d.ts

@@ -5,7 +5,7 @@ export declare const PM_READ_OUTPUT_DIMENSIONS: readonly ["include", "amount", "
 /** One member of the universal read-output dimension set. */
 export type PmReadOutputDimension = (typeof PM_READ_OUTPUT_DIMENSIONS)[number];
 /** Built-in command roots whose primary operation is a read. */
-export declare const PM_READ_OUTPUT_SURFACES: readonly ["list", "context", "search", "get", "next", "health", "deps", "graph", "history", "activity", "validate", "events", "contracts", "comments", "notes", "files", "docs", "stats", "aggregate", "package-manage", "comments-audit", "assurance"];
+export declare const PM_READ_OUTPUT_SURFACES: readonly ["list", "context", "search", "get", "next", "health", "deps", "graph", "history", "activity", "validate", "events", "contracts", "comments", "notes", "files", "docs", "stats", "aggregate", "package-catalog", "package-manage", "comments-audit", "assurance"];
 /** Built-in read command supported by the universal output contract. */
 export type PmReadOutputSurface = (typeof PM_READ_OUTPUT_SURFACES)[number];
 /** Canonical output controls accepted by every built-in read action. */
@@ -226,7 +226,7 @@ export declare const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS: readonly ["--outpu
 /** Universal output contract for every built-in read surface. */
 export declare const PM_READ_OUTPUT_SURFACE_CONTRACTS: readonly PmReadOutputSurfaceContract[];
 /** Resolve a command or list/context alias to its canonical read-output surface. */
-export declare function resolveReadOutputSurface(command: string): PmReadOutputSurface | undefined;
+export declare function resolveReadOutputSurface(command: string, options?: Record<string, unknown>): PmReadOutputSurface | undefined;
 /** Reject malformed or mutation-scoped universal output controls before command execution. */
 export declare function validateReadOutputOptions(command: string, options: Record<string, unknown>): void;
 /**

package/dist/sdk/read-output-contracts.js

@@ -5,7 +5,7 @@
  * surface without coupling package authors to command-specific option names.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e9621264-0180-53cf-862f-b59640b971da")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="db1d54b0-ff27-51f5-a179-14556ced24eb")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { compactReadOutputToBudget, estimateReadOutputTokens, updateReadOutputReceiptEstimate, } from "./read-output-budget.js";
@@ -43,6 +43,7 @@ export const PM_READ_OUTPUT_SURFACES = [
     "docs",
     "stats",
     "aggregate",
+    "package-catalog",
     "package-manage",
     "comments-audit",
     "assurance",
@@ -135,6 +136,7 @@ const LEGACY_FLAGS_BY_COMMAND = {
     docs: {},
     stats: {},
     aggregate: {},
+    "package-catalog": {},
     "package-manage": {},
     "comments-audit": {},
     assurance: {},
@@ -208,15 +210,26 @@ const SURFACE_CONTRACT_BY_COMMAND = new Map(PM_READ_OUTPUT_SURFACE_CONTRACTS.map
     contract,
 ]));
 /** Resolve a command or list/context alias to its canonical read-output surface. */
-export function resolveReadOutputSurface(command) {
+export function resolveReadOutputSurface(command, options = {}) {
     const normalizedCommand = command
         .trim()
         .toLowerCase()
         .replaceAll(/\s+/gu, " ");
-    const root = normalizedCommand === "package manage" ||
-        normalizedCommand === "package-manage"
-        ? "package-manage"
-        : normalizedCommand.split(" ")[0];
+    const packageMode = normalizedCommand === "package catalog" ||
+        normalizedCommand === "packages catalog" ||
+        normalizedCommand === "package-catalog" ||
+        ((normalizedCommand === "package" ||
+            normalizedCommand === "packages" ||
+            normalizedCommand === "extension") &&
+            (options.catalog === true ||
+                options.target === "catalog" ||
+                options.action === "catalog"));
+    const root = packageMode
+        ? "package-catalog"
+        : normalizedCommand === "package manage" ||
+            normalizedCommand === "package-manage"
+            ? "package-manage"
+            : normalizedCommand.split(" ")[0];
     const normalized = root.startsWith("list-")
         ? "list"
         : root === "ctx"
@@ -247,6 +260,20 @@ const HYBRID_READ_MUTATION_KEYS = {
     notes: ["add", "addJson", "stdin", "file", "edit", "delete"],
     files: ["add", "addGlob", "remove", "migrate", "apply", "note"],
     docs: ["add", "addGlob", "remove", "migrate", "note"],
+    "package-catalog": [
+        "activate",
+        "adopt",
+        "adoptAll",
+        "deactivate",
+        "doctor",
+        "init",
+        "install",
+        "manage",
+        "migrate",
+        "reload",
+        "scaffold",
+        "uninstall",
+    ],
 };
 function hasCanonicalReadOutputOptions(options) {
     return CANONICAL_OPTION_KEYS.some((key) => options[key] !== undefined);
@@ -290,7 +317,7 @@ const READ_OUTPUT_VALUE_VALIDATORS = [
 export function validateReadOutputOptions(command, options) {
     if (!hasCanonicalReadOutputOptions(options))
         return;
-    const normalizedCommand = resolveReadOutputSurface(command);
+    const normalizedCommand = resolveReadOutputSurface(command, options);
     if (!normalizedCommand) {
         throw new PmCliError(`Universal output controls apply only to read commands; ${command || "this command"} is not a read surface.`, EXIT_CODE.USAGE);
     }
@@ -471,7 +498,7 @@ function resolveEncodingValue(canonical, legacy) {
 }
 /** Resolve canonical and compatibility controls into the universal dimension set. */
 export function resolveReadOutputDimensions(command, options) {
-    const normalizedCommand = resolveReadOutputSurface(command);
+    const normalizedCommand = resolveReadOutputSurface(command, options);
     if (!normalizedCommand)
         return undefined;
     const contract = SURFACE_CONTRACT_BY_COMMAND.get(normalizedCommand);
@@ -1058,4 +1085,4 @@ export function resolveReadOutputEncoding(command, options) {
         : undefined;
 }
 //# sourceMappingURL=read-output-contracts.js.map
-//# debugId=e9621264-0180-53cf-862f-b59640b971da
+//# debugId=db1d54b0-ff27-51f5-a179-14556ced24eb

package/dist/sdk/relationship-analytics.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3a33af50-3d2c-57bb-884a-4d5394599ba2")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3167c288-0bcc-5a66-8aa0-ca5876ed7d36")}catch(e){}}();
 import { createQueryFingerprint, decodeQueryCursor, encodeQueryCursor, } from "./pagination.js";
 import { createRelationshipKindRegistry, } from "./relationships.js";
 function visitImpactNeighbor(state, id, parent, root, after, limit) {
@@ -216,12 +216,80 @@ export function analyzeRelationshipExecution(graph, options = {}) {
         provenance: { algorithm: "kahn-longest-path", edgeFamily: "ordering" },
     };
 }
-/** Compute bounded impact rows and exact shortest explanation paths. */
-export function analyzeGraphImpact(graph, root, options = {}) {
-    const direction = options.direction ?? "outgoing";
+/** Build impact-only adjacency from stored source-to-target orientation. */
+function buildImpactAdjacency(graph, direction, kinds) {
+    const adjacency = createAdjacency(graph.nodes());
+    const selectedKinds = kinds === undefined
+        ? undefined
+        : new Set(kinds.map((kind) => graph.registry().require(kind).kind));
+    const edges = graph.edges();
+    for (const edge of edges) {
+        const definition = graph.registry().require(edge.kind);
+        if (selectedKinds !== undefined &&
+            !selectedKinds.has(edge.kind) &&
+            (definition.inverse === undefined ||
+                !selectedKinds.has(definition.inverse))) {
+            continue;
+        }
+        appendNeighbor(adjacency, direction === "incoming" ? edge.target : edge.source, direction === "incoming" ? edge.source : edge.target);
+    }
+    return { adjacency, inspectedEdges: edges.length };
+}
+/** Combine complete direction-locked incoming and outgoing impact traversals. */
+function analyzeBidirectionalGraphImpact(graph, root, options, after, limit, cursorFingerprint) {
+    const incoming = analyzeGraphImpact(graph, root, {
+        ...options,
+        after: undefined,
+        direction: "incoming",
+        limit: undefined,
+    });
+    const outgoing = analyzeGraphImpact(graph, root, {
+        ...options,
+        after: undefined,
+        direction: "outgoing",
+        limit: undefined,
+    });
+    const rows = new Map();
+    const candidates = [...incoming.affected, ...outgoing.affected].sort((left, right) => left.distance - right.distance ||
+        left.id.localeCompare(right.id) ||
+        left.path.join("\u0000").localeCompare(right.path.join("\u0000")));
+    for (const row of candidates) {
+        if (!rows.has(row.id)) {
+            rows.set(row.id, row);
+        }
+    }
+    const ordered = [...rows.values()].sort((left, right) => left.distance - right.distance || left.id.localeCompare(right.id));
+    const afterIndex = after === undefined || after === root
+        ? -1
+        : ordered.findIndex((row) => row.id === after);
+    if (after !== undefined && after !== root && afterIndex < 0) {
+        throw new TypeError(`Unknown impact cursor item: ${after}`);
+    }
+    const affected = ordered.slice(afterIndex + 1, afterIndex + 1 + limit);
+    const rowLimitTruncated = afterIndex + 1 + affected.length < ordered.length;
+    return {
+        root,
+        affected,
+        exact: true,
+        truncated: incoming.truncated || outgoing.truncated || rowLimitTruncated,
+        ...(rowLimitTruncated
+            ? {
+                nextCursor: encodeQueryCursor(cursorFingerprint, affected.at(-1)?.id ?? root),
+            }
+            : {}),
+        cost: {
+            visitedNodes: incoming.cost.visitedNodes + outgoing.cost.visitedNodes,
+            inspectedEdges: incoming.cost.inspectedEdges + outgoing.cost.inspectedEdges,
+        },
+    };
+}
+/** Compute one stored-direction impact traversal and exact shortest explanation paths. */
+function analyzeUnidirectionalGraphImpact(graph, root, options) {
+    const direction = options.direction;
     const maxDepth = options.maxDepth ?? Number.POSITIVE_INFINITY;
     const limit = options.limit ?? Number.POSITIVE_INFINITY;
     const { fingerprint: cursorFingerprint, after } = resolveImpactCursor(root, options, direction, maxDepth);
+    const { adjacency, inspectedEdges } = buildImpactAdjacency(graph, direction, options.kinds);
     const state = {
         queue: [{ id: root, depth: 0 }],
         seen: new Set([root]),
@@ -230,25 +298,19 @@ export function analyzeGraphImpact(graph, root, options = {}) {
         cursorFound: after === undefined || after === root,
     };
     let visitedNodes = 0;
-    let inspectedEdges = 0;
     let truncated = false;
     let rowLimitTruncated = false;
     traversal: for (let index = 0; index < state.queue.length; index += 1) {
         options.signal?.throwIfAborted();
         const current = state.queue[index];
         visitedNodes += 1;
-        const adjacent = graph.adjacency(current.id, {
-            direction,
-            kinds: options.kinds,
-            signal: options.signal,
-        });
-        inspectedEdges += adjacent.meta.inspectedEdges;
+        const adjacent = [...adjacency.get(current.id)].sort();
         if (current.depth >= maxDepth) {
-            if (adjacent.value.some((id) => !state.seen.has(id)))
+            if (adjacent.some((id) => !state.seen.has(id)))
                 truncated = true;
             continue;
         }
-        for (const id of adjacent.value) {
+        for (const id of adjacent) {
             const outcome = visitImpactNeighbor(state, id, current, root, after, limit);
             if (outcome === "truncate") {
                 truncated = true;
@@ -273,6 +335,20 @@ export function analyzeGraphImpact(graph, root, options = {}) {
         cost: { visitedNodes, inspectedEdges },
     };
 }
+/** Compute bounded impact rows and exact shortest explanation paths. */
+export function analyzeGraphImpact(graph, root, options = {}) {
+    const direction = options.direction ?? "outgoing";
+    if (direction !== "both") {
+        return analyzeUnidirectionalGraphImpact(graph, root, {
+            ...options,
+            direction,
+        });
+    }
+    const maxDepth = options.maxDepth ?? Number.POSITIVE_INFINITY;
+    const limit = options.limit ?? Number.POSITIVE_INFINITY;
+    const { fingerprint, after } = resolveImpactCursor(root, options, direction, maxDepth);
+    return analyzeBidirectionalGraphImpact(graph, root, options, after, limit, fingerprint);
+}
 /** Analyze weak/strong components, isolates, and exact unique-neighbor hubs. */
 export function analyzeKnowledgeGraph(graph) {
     const nodes = [...graph.nodes()];
@@ -332,4 +408,4 @@ export function compareRelationshipSnapshots(before, after) {
     };
 }
 //# sourceMappingURL=relationship-analytics.js.map
-//# debugId=3a33af50-3d2c-57bb-884a-4d5394599ba2
+//# debugId=3167c288-0bcc-5a66-8aa0-ca5876ed7d36

package/dist/sdk/relationship-kinds/contract.d.ts

@@ -9,6 +9,8 @@ export type RelationshipDirection = "directed" | "undirected";
 export type RelationshipCardinality = "one" | "many";
 /** Lifecycle policy for a relationship kind. */
 export type RelationshipLifecycle = "persistent" | "supersedable" | "ephemeral";
+/** Temporal meaning carried by a directed relationship independently of execution precedence. */
+export type RelationshipTemporalOrder = "source_after_target";
 /** Direction in which an ordering edge contributes to execution precedence. */
 export type RelationshipPrecedence = "source_before_target" | "target_before_source";
 /** Endpoint that represents the structural parent for hierarchy kinds. */
@@ -23,6 +25,8 @@ export interface RelationshipKindDefinition {
     inverse?: string;
     /** Whether the kind participates in execution-order cycle checks. */
     ordering: boolean;
+    /** Optional chronological constraint; recurrence uses source-after-target without becoming scheduling precedence. */
+    temporalOrder?: RelationshipTemporalOrder;
     /** Execution direction for ordering kinds; defaults to source before target. */
     precedence?: RelationshipPrecedence;
     /** Whether the kind contributes to structural ancestry. */

package/dist/sdk/relationship-kinds/contract.js

@@ -5,7 +5,7 @@
  */
 /** Stable built-in relationship ontology without graph or storage dependencies. */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="49a83ce3-4c55-5b3f-b061-bc21b716d498")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="825e1dd9-4168-56f6-9183-b8cf75314b73")}catch(e){}}();
 export const BUILTIN_RELATIONSHIP_KINDS = [
     { kind: "blocked_by", direction: "directed", inverse: "blocks", ordering: true, precedence: "target_before_source", hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "persistent", aliases: ["depends_on"], compatibilityVersion: 1, allowSelf: false },
     { kind: "blocks", direction: "directed", inverse: "blocked_by", ordering: true, precedence: "source_before_target", hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "persistent", compatibilityVersion: 1, allowSelf: false },
@@ -15,8 +15,9 @@ export const BUILTIN_RELATIONSHIP_KINDS = [
     { kind: "discovered_from", direction: "directed", ordering: false, hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "persistent", compatibilityVersion: 1, allowSelf: false },
     { kind: "incident_from", direction: "directed", ordering: false, hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "persistent", compatibilityVersion: 1, allowSelf: false },
     { kind: "implements", direction: "directed", ordering: false, hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "persistent", compatibilityVersion: 1, allowSelf: false },
+    { kind: "recurs_from", direction: "directed", ordering: false, temporalOrder: "source_after_target", hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "persistent", compatibilityVersion: 1, allowSelf: false },
     { kind: "verifies", direction: "directed", ordering: false, hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "persistent", compatibilityVersion: 1, allowSelf: false },
     { kind: "supersedes", direction: "directed", ordering: false, hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "supersedable", compatibilityVersion: 1, allowSelf: false },
 ];
 //# sourceMappingURL=contract.js.map
-//# debugId=49a83ce3-4c55-5b3f-b061-bc21b716d498
+//# debugId=825e1dd9-4168-56f6-9183-b8cf75314b73

package/dist/sdk/relationships.d.ts

@@ -6,7 +6,7 @@
  */
 import type { Dependency, ItemMetadata } from "../types/index.js";
 import { type RelationshipKindDefinition } from "./relationship-kinds/contract.js";
-export { BUILTIN_RELATIONSHIP_KINDS, type RelationshipCardinality, type RelationshipDirection, type RelationshipHierarchyDirection, type RelationshipKindDefinition, type RelationshipLifecycle, type RelationshipPrecedence, } from "./relationship-kinds/contract.js";
+export { BUILTIN_RELATIONSHIP_KINDS, type RelationshipCardinality, type RelationshipDirection, type RelationshipHierarchyDirection, type RelationshipKindDefinition, type RelationshipLifecycle, type RelationshipPrecedence, type RelationshipTemporalOrder, } from "./relationship-kinds/contract.js";
 /** One normalized relationship edge indexed by the graph kernel. */
 export interface RelationshipEdge {
     /** Source node identifier. */

package/dist/sdk/relationships.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="05e01593-acb6-5e28-a5ac-8c8f74359c62")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7f733de4-104b-50a9-9c0a-cd9850bfcd78")}catch(e){}}();
 import { BUILTIN_RELATIONSHIP_KINDS, } from "./relationship-kinds/contract.js";
 export { BUILTIN_RELATIONSHIP_KINDS, } from "./relationship-kinds/contract.js";
 function normalizeKind(kind) {
@@ -36,6 +36,14 @@ function assertRelationshipPrecedence(definition, kind) {
     if (!definition.ordering && definition.precedence !== undefined)
         throw new TypeError(`Non-ordering relationship kind cannot declare precedence: ${kind}`);
 }
+function assertRelationshipTemporalOrder(definition, kind) {
+    if (definition.temporalOrder !== undefined &&
+        definition.temporalOrder !== "source_after_target")
+        throw new TypeError(`Invalid relationship temporal order for ${kind}`);
+    if (definition.direction !== "directed" &&
+        definition.temporalOrder !== undefined)
+        throw new TypeError(`Undirected relationship kind cannot declare temporal order: ${kind}`);
+}
 function assertRelationshipHierarchyDirection(definition, kind) {
     if (definition.hierarchyDirection !== undefined &&
         definition.hierarchyDirection !== "source_parent" &&
@@ -102,6 +110,7 @@ export class RelationshipKindRegistry {
         assertRelationshipKindSemantics(definition, kind);
         assertRelationshipKindPayload(definition, kind);
         assertRelationshipPrecedence(definition, kind);
+        assertRelationshipTemporalOrder(definition, kind);
         assertRelationshipHierarchyDirection(definition, kind);
         if (this.#definitions.has(kind) || this.#aliases.has(kind))
             throw new TypeError(`Relationship kind already registered: ${kind}`);
@@ -543,4 +552,4 @@ export function dependencyToRelationship(source, dependency, registry = defaultR
     };
 }
 //# sourceMappingURL=relationships.js.map
-//# debugId=05e01593-acb6-5e28-a5ac-8c8f74359c62
+//# debugId=7f733de4-104b-50a9-9c0a-cd9850bfcd78

package/dist/sdk/runtime-extended-actions.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="37ac2a74-f150-5b9d-96d6-d9cc441215be")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0492d773-2af2-5072-8164-9f8aab536191")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { createUnknownSubcommandError } from "./agent/subcommand-recovery.js";
@@ -32,6 +32,13 @@ export function runRuntimeEvalAction(context) {
 /** Dispatch one bounded mutation-event page through the public SDK runner. */
 export function runRuntimeEventsAction(context) {
     const input = mergedInput(context);
+    const rawCursorMode = input.cursorMode;
+    if (rawCursorMode !== undefined &&
+        rawCursorMode !== "batch" &&
+        rawCursorMode !== "row") {
+        throw new PmCliError("Mutation event cursor mode must be batch or row.", EXIT_CODE.USAGE, { code: "invalid_event_cursor_mode" });
+    }
+    const cursorMode = rawCursorMode;
     return listMutationEvents({
         cwd: readRuntimeString(input, "cwd"),
         pmRoot: readRuntimeString(input, "path"),
@@ -43,6 +50,7 @@ export function runRuntimeEventsAction(context) {
             ? undefined
             : parseRuntimeInteger(input.limit, "limit"),
         full: input.full === true,
+        cursorMode,
         ...(input.provenance === undefined
             ? {}
             : { provenance: input.provenance === true }),
@@ -161,4 +169,4 @@ export function runRuntimeSchedulingAction(context) {
     return runRemind(title, input, context.global);
 }
 //# sourceMappingURL=runtime-extended-actions.js.map
-//# debugId=37ac2a74-f150-5b9d-96d6-d9cc441215be
+//# debugId=0492d773-2af2-5072-8164-9f8aab536191

package/dist/sdk/runtime.d.ts

@@ -8,6 +8,8 @@ export { SEARCH_EXTENSION_FLAG_DEFINITIONS } from "./extension-contracts.js";
 export type { FlagDefinition } from "../core/extensions/loader.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import type { ItemMetadata } from "../types/index.js";
+import { type PmCompleteListOptions, type PmCompleteListResult } from "./query/complete-list.js";
+export { PmCompleteListValidationError, assertCompleteListResult, certifyCompleteListResult, createCompleteListOptions, inspectCompleteListResult, type PmCompleteListCertificate, type PmCompleteListFailureReceipt, type PmCompleteListFinding, type PmCompleteListFindingCode, type PmCompleteListInspection, type PmCompleteListOptions, type PmCompleteListResult } from "./query/complete-list.js";
 export type { WorkspaceExtensionCommandContract, WorkspaceFieldContract, } from "./workspace-contracts.js";
 import { type PmReadOutputOptions, type PmReadOutputResultFor } from "./read-output-contracts.js";
 export type { PmReadOutputBudgetExceeded, PmReadOutputOptions, PmReadOutputResult, PmReadOutputResultFor, PmReadOutputSurfaceContract, } from "./read-output-contracts.js";
@@ -138,6 +140,8 @@ export declare class PmClient {
     listAllItemMetadataLight(): Promise<ItemMetadata[]>;
     /** List items with the MCP/agent compact defaults. */
     list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>;
+    /** Return every status and full item row only after fail-closed corpus certification. */
+    listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>;
     /** Search items with the MCP/agent compact defaults. */
     search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>;
     /** Read one item by id. */
@@ -336,7 +340,7 @@ export declare class PmClient {
     /** Reload installed package extensions using the same action as `pm package reload`. */
     packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>;
     /** Read bundled package catalog metadata using the same action as `pm package catalog`. */
-    packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>;
     /** Enable an installed package using the same action as `pm package activate`. */
     packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
     /** Disable an installed package using the same action as `pm package deactivate`. */
@@ -350,6 +354,8 @@ export declare class PmClient {
 export declare function context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options, clientOptions?: PmClientOptions): ReadPromise<ContextResult, Options>;
 /** List items with the MCP/agent compact defaults without constructing a reusable client. */
 export declare function list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options, clientOptions?: PmClientOptions): ReadPromise<ListResult, Options>;
+/** Return every status and full item row with fail-closed corpus proof. */
+export declare function listAllComplete(options?: PmCompleteListOptions, clientOptions?: PmClientOptions): Promise<PmCompleteListResult>;
 /** Search items with the MCP/agent compact defaults without constructing a reusable client. */
 export declare function search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options, clientOptions?: PmClientOptions): ReadPromise<SearchResult, Options>;
 /** Read one item by id without constructing a reusable client. */
@@ -510,7 +516,7 @@ export declare function packageDescribe(target?: string, options?: PackageComman
 /** Reload package extensions without constructing a reusable client. */
 export declare function packageReload(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
 /** Read bundled package catalog metadata without constructing a reusable client. */
-export declare function packageCatalog(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+export declare function packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options, clientOptions?: PmClientOptions): ReadPromise<PackageCommandResult, Options>;
 /** Enable a package without constructing a reusable client. */
 export declare function packageActivate(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
 /** Disable a package without constructing a reusable client. */