@unbrained/pm-cli 2026.8.8 → 2026.8.9

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

@@ -24,6 +24,17 @@ type GetItemProjection = Partial<ItemMetadata> & {
     notes_count?: number;
     /** Number of linked tests omitted by a token-bounded projection. */
     tests_count?: number;
+    /** Stable cardinalities for every collection mutation surface. */
+    collection_counts?: Readonly<{
+        comments: number;
+        notes: number;
+        learnings: number;
+        files: number;
+        tests: number;
+        docs: number;
+        reminders: number;
+        events: number;
+    }>;
 };
 /** Documents the get result payload exchanged by command, SDK, and package integrations. */
 export interface GetResult {

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]="5536c6eb-5d51-5b67-879d-c1d0bfa5b692")}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]="f68f4074-51ba-5065-8cca-fe16acd48927")}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";
@@ -21,6 +21,23 @@ const AUTOMATIC_CHILD_ROLLUP_TYPES = new Set([
     "plan",
 ]);
 const BUILTIN_ITEM_TYPES = new Set(Object.keys(TYPE_TO_FOLDER).map((type) => type.toLowerCase()));
+function itemCollectionCounts(item) {
+    const lengths = Object.fromEntries([
+        "comments",
+        "notes",
+        "learnings",
+        "files",
+        "tests",
+        "docs",
+        "reminders",
+        "events",
+    ].map((key) => [
+        key,
+        item[key]
+            ?.length ?? 0,
+    ]));
+    return lengths;
+}
 /** Decide whether a normal read should pay for a workspace-wide child projection. */
 function shouldAutoIncludeGetChildren(itemType) {
     const normalizedType = itemType.trim().toLowerCase();
@@ -65,14 +82,29 @@ function parseGetDepth(raw) {
     throw new PmCliError("Get --depth must be one of brief|standard|deep|full", EXIT_CODE.USAGE);
 }
 function projectItemForDepth(item, depth) {
+    const collectionCounts = itemCollectionCounts(item);
     if (depth === "deep") {
-        return item;
+        return {
+            ...item,
+            comments: item.comments ?? [],
+            notes: item.notes ?? [],
+            learnings: item.learnings ?? [],
+            files: item.files ?? [],
+            tests: item.tests ?? [],
+            docs: item.docs ?? [],
+            reminders: item.reminders ?? [],
+            events: item.events ?? [],
+            notes_count: collectionCounts.notes,
+            tests_count: collectionCounts.tests,
+            collection_counts: collectionCounts,
+        };
     }
     const { comments: _comments, notes: _notes, learnings: _learnings, files: _files, tests: _tests, docs: _docs, reminders: _reminders, events: _events, ...projected } = item;
     return {
         ...projected,
         notes_count: item.notes?.length ?? 0,
         tests_count: item.tests?.length ?? 0,
+        collection_counts: collectionCounts,
     };
 }
 function parseGetFields(raw) {
@@ -100,6 +132,7 @@ function validateGetFields(fields, runtimeMetadataKeys) {
         ...runtimeMetadataKeys,
         "notes_count",
         "tests_count",
+        "collection_counts",
     ]);
     const allowedRootFields = new Set([
         "body",
@@ -151,6 +184,7 @@ function projectItemForFields(item, fields) {
     const omittedCounts = {
         notes_count: item.notes?.length ?? 0,
         tests_count: item.tests?.length ?? 0,
+        collection_counts: itemCollectionCounts(item),
     };
     const projected = {};
     for (const field of fields) {
@@ -387,4 +421,4 @@ export const _testOnlyGetCommand = {
     shouldAutoIncludeGetChildren,
 };
 //# sourceMappingURL=get.js.map
-//# debugId=5536c6eb-5d51-5b67-879d-c1d0bfa5b692
+//# debugId=f68f4074-51ba-5065-8cca-fe16acd48927

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

@@ -4,7 +4,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"];
+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"];
 /** 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. */

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]="27f3a09b-9b90-5c85-9e41-21cfed5dc0ce")}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]="819ac44d-0add-581c-90e8-ac6e8247b04b")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { compactReadOutputToBudget, updateReadOutputReceiptEstimate, } from "./read-output-budget.js";
@@ -39,6 +39,7 @@ export const PM_READ_OUTPUT_SURFACES = [
     "docs",
     "stats",
     "aggregate",
+    "package-manage",
 ];
 const READ_OUTPUT_PRECEDENCE = [
     "canonical",
@@ -126,6 +127,7 @@ const LEGACY_FLAGS_BY_COMMAND = {
     docs: {},
     stats: {},
     aggregate: {},
+    "package-manage": {},
 };
 const VALUE_BEARING_INCLUDE_ALIASES = new Set(["--fields", "--section"]);
 const BEHAVIOR_PRESERVING_MIGRATION_HINTS = Object.freeze({
@@ -186,7 +188,14 @@ const SURFACE_CONTRACT_BY_COMMAND = new Map(PM_READ_OUTPUT_SURFACE_CONTRACTS.map
 ]));
 /** Resolve a command or list/context alias to its canonical read-output surface. */
 export function resolveReadOutputSurface(command) {
-    const root = command.trim().toLowerCase().split(/\s+/u)[0];
+    const normalizedCommand = command
+        .trim()
+        .toLowerCase()
+        .replaceAll(/\s+/gu, " ");
+    const root = normalizedCommand === "package manage" ||
+        normalizedCommand === "package-manage"
+        ? "package-manage"
+        : normalizedCommand.split(" ")[0];
     const normalized = root.startsWith("list-")
         ? "list"
         : root === "ctx"
@@ -423,13 +432,23 @@ const ENVELOPE_KEYS = new Set([
     "total",
     "truncated",
 ]);
+const GET_STABLE_DERIVED_ITEM_SELECTORS = [
+    "collection_counts",
+    "notes_count",
+    "tests_count",
+];
 function projectRecordFields(value, selectors) {
     const selected = new Set(selectors.map((selector) => selector.split(".")[0]));
     return Object.fromEntries(Object.entries(value).filter(([key]) => selected.has(key)));
 }
 function getProjectionVocabulary(result) {
     const item = isRecord(result.item) ? result.item : {};
-    const itemFields = Object.keys(item).sort((left, right) => left.localeCompare(right));
+    const itemFields = [
+        ...new Set([
+            ...Object.keys(item),
+            ...GET_STABLE_DERIVED_ITEM_SELECTORS.filter((key) => Object.hasOwn(item, key)),
+        ]),
+    ].sort((left, right) => left.localeCompare(right));
     const sections = Object.keys(result)
         .filter((key) => key !== "item" && key !== "read_output" && !ENVELOPE_KEYS.has(key))
         .sort((left, right) => left.localeCompare(right));
@@ -676,4 +695,4 @@ export function resolveReadOutputEncoding(command, options) {
         : undefined;
 }
 //# sourceMappingURL=read-output-contracts.js.map
-//# debugId=27f3a09b-9b90-5c85-9e41-21cfed5dc0ce
+//# debugId=819ac44d-0add-581c-90e8-ac6e8247b04b

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

@@ -0,0 +1,48 @@
+/**
+ * @module sdk/relationship-kinds/contract
+ *
+ * Dependency-free relationship ontology shared by contracts and graph runtime.
+ */
+/** Direction exposed by a relationship kind. */
+export type RelationshipDirection = "directed" | "undirected";
+/** Cardinality constraint applied independently to outgoing and incoming edges. */
+export type RelationshipCardinality = "one" | "many";
+/** Lifecycle policy for a relationship kind. */
+export type RelationshipLifecycle = "persistent" | "supersedable" | "ephemeral";
+/** 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. */
+export type RelationshipHierarchyDirection = "source_parent" | "target_parent";
+/** Versioned semantic definition for a built-in or application-defined edge kind. */
+export interface RelationshipKindDefinition {
+    /** Canonical, case-insensitive kind identifier. */
+    kind: string;
+    /** Whether traversing source to target has distinct meaning from the reverse. */
+    direction: RelationshipDirection;
+    /** Optional canonical kind used when traversing a directed edge in reverse. */
+    inverse?: string;
+    /** Whether the kind participates in execution-order cycle checks. */
+    ordering: boolean;
+    /** Execution direction for ordering kinds; defaults to source before target. */
+    precedence?: RelationshipPrecedence;
+    /** Whether the kind contributes to structural ancestry. */
+    hierarchy: boolean;
+    /** Endpoint that represents the parent; defaults to source for custom kinds. */
+    hierarchyDirection?: RelationshipHierarchyDirection;
+    /** Maximum logical outgoing edges of this kind from one node. */
+    outgoing: RelationshipCardinality;
+    /** Maximum logical incoming edges of this kind to one node. */
+    incoming: RelationshipCardinality;
+    /** Edge replacement and retention behavior. */
+    lifecycle: RelationshipLifecycle;
+    /** JSON Schema for optional application-owned payloads. */
+    payloadSchema?: Readonly<Record<string, unknown>>;
+    /** Legacy spellings normalized to this definition. */
+    aliases?: readonly string[];
+    /** Compatibility version of this semantic contract. */
+    compatibilityVersion: number;
+    /** Whether source and target may be the same node. */
+    allowSelf: boolean;
+}
+/** Stable built-in relationship ontology without graph or storage dependencies. */
+export declare const BUILTIN_RELATIONSHIP_KINDS: readonly RelationshipKindDefinition[];

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

@@ -0,0 +1,22 @@
+/**
+ * @module sdk/relationship-kinds/contract
+ *
+ * Dependency-free relationship ontology shared by contracts and graph runtime.
+ */
+/** 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){}}();
+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 },
+    { kind: "parent", direction: "directed", inverse: "child", ordering: false, hierarchy: true, hierarchyDirection: "target_parent", outgoing: "one", incoming: "many", lifecycle: "supersedable", aliases: ["child_of", "epic"], compatibilityVersion: 1, allowSelf: false },
+    { kind: "child", direction: "directed", inverse: "parent", ordering: false, hierarchy: true, hierarchyDirection: "source_parent", outgoing: "many", incoming: "one", lifecycle: "supersedable", aliases: ["parent_child", "task"], compatibilityVersion: 1, allowSelf: false },
+    { kind: "related", direction: "undirected", ordering: false, hierarchy: false, outgoing: "many", incoming: "many", lifecycle: "persistent", aliases: ["related_to"], compatibilityVersion: 1, allowSelf: false },
+    { 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: "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

package/dist/sdk/relationships.d.ts

@@ -5,47 +5,8 @@
  * kernel shared by the SDK, CLI, MCP adapters, extensions, and non-PM apps.
  */
 import type { Dependency, ItemMetadata } from "../types/index.js";
-/** Direction exposed by a relationship kind. */
-export type RelationshipDirection = "directed" | "undirected";
-/** Cardinality constraint applied independently to outgoing and incoming edges. */
-export type RelationshipCardinality = "one" | "many";
-/** Lifecycle policy for a relationship kind. */
-export type RelationshipLifecycle = "persistent" | "supersedable" | "ephemeral";
-/** 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. */
-export type RelationshipHierarchyDirection = "source_parent" | "target_parent";
-/** Versioned semantic definition for a built-in or application-defined edge kind. */
-export interface RelationshipKindDefinition {
-    /** Canonical, case-insensitive kind identifier. */
-    kind: string;
-    /** Whether traversing source to target has distinct meaning from the reverse. */
-    direction: RelationshipDirection;
-    /** Optional canonical kind used when traversing a directed edge in reverse. */
-    inverse?: string;
-    /** Whether the kind participates in execution-order cycle checks. */
-    ordering: boolean;
-    /** Execution direction for ordering kinds; defaults to source before target. */
-    precedence?: RelationshipPrecedence;
-    /** Whether the kind contributes to structural ancestry. */
-    hierarchy: boolean;
-    /** Endpoint that represents the parent; defaults to source for custom kinds. */
-    hierarchyDirection?: RelationshipHierarchyDirection;
-    /** Maximum logical outgoing edges of this kind from one node. */
-    outgoing: RelationshipCardinality;
-    /** Maximum logical incoming edges of this kind to one node. */
-    incoming: RelationshipCardinality;
-    /** Edge replacement and retention behavior. */
-    lifecycle: RelationshipLifecycle;
-    /** JSON Schema for optional application-owned payloads. */
-    payloadSchema?: Readonly<Record<string, unknown>>;
-    /** Legacy spellings normalized to this definition. */
-    aliases?: readonly string[];
-    /** Compatibility version of this semantic contract. */
-    compatibilityVersion: number;
-    /** Whether source and target may be the same node. */
-    allowSelf: boolean;
-}
+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";
 /** One normalized relationship edge indexed by the graph kernel. */
 export interface RelationshipEdge {
     /** Source node identifier. */
@@ -124,6 +85,10 @@ export declare class RelationshipKindRegistry {
 }
 /** Create a registry containing the built-in relationship ontology. */
 export declare function createRelationshipKindRegistry(): RelationshipKindRegistry;
+/** Resolve an accepted built-in relationship spelling to its canonical stored kind. */
+export declare function canonicalizeRelationshipKind(kind: string): string;
+/** Resolve an accepted built-in relationship spelling, returning undefined for unknown kinds. */
+export declare function resolveCanonicalRelationshipKind(kind: unknown): string | undefined;
 /** Report whether a kind participates in execution-order cycle detection. */
 export declare function isOrderingRelationshipKind(kind: string, registry?: RelationshipKindRegistry): boolean;
 /**

package/dist/sdk/relationships.js

@@ -1,129 +1,7 @@
 
-!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]="a89f0df7-e280-5ce4-8515-1f107a4aeaab")}catch(e){}}();
-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,
-    },
-    {
-        kind: "parent",
-        direction: "directed",
-        inverse: "child",
-        ordering: false,
-        hierarchy: true,
-        hierarchyDirection: "target_parent",
-        outgoing: "one",
-        incoming: "many",
-        lifecycle: "supersedable",
-        aliases: ["child_of", "epic"],
-        compatibilityVersion: 1,
-        allowSelf: false,
-    },
-    {
-        kind: "child",
-        direction: "directed",
-        inverse: "parent",
-        ordering: false,
-        hierarchy: true,
-        hierarchyDirection: "source_parent",
-        outgoing: "many",
-        incoming: "one",
-        lifecycle: "supersedable",
-        aliases: ["parent_child", "task"],
-        compatibilityVersion: 1,
-        allowSelf: false,
-    },
-    {
-        kind: "related",
-        direction: "undirected",
-        ordering: false,
-        hierarchy: false,
-        outgoing: "many",
-        incoming: "many",
-        lifecycle: "persistent",
-        aliases: ["related_to"],
-        compatibilityVersion: 1,
-        allowSelf: false,
-    },
-    {
-        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: "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,
-    },
-];
+!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){}}();
+import { BUILTIN_RELATIONSHIP_KINDS, } from "./relationship-kinds/contract.js";
+export { BUILTIN_RELATIONSHIP_KINDS, } from "./relationship-kinds/contract.js";
 function normalizeKind(kind) {
     return kind.trim().toLowerCase().replaceAll("-", "_");
 }
@@ -278,6 +156,14 @@ export function createRelationshipKindRegistry() {
     return new RelationshipKindRegistry();
 }
 const defaultRegistry = createRelationshipKindRegistry();
+/** Resolve an accepted built-in relationship spelling to its canonical stored kind. */
+export function canonicalizeRelationshipKind(kind) {
+    return defaultRegistry.require(kind).kind;
+}
+/** Resolve an accepted built-in relationship spelling, returning undefined for unknown kinds. */
+export function resolveCanonicalRelationshipKind(kind) {
+    return defaultRegistry.resolve(kind)?.kind;
+}
 /** Report whether a kind participates in execution-order cycle detection. */
 export function isOrderingRelationshipKind(kind, registry = defaultRegistry) {
     return registry.resolve(kind)?.ordering === true;
@@ -657,4 +543,4 @@ export function dependencyToRelationship(source, dependency, registry = defaultR
     };
 }
 //# sourceMappingURL=relationships.js.map
-//# debugId=a89f0df7-e280-5ce4-8515-1f107a4aeaab
+//# debugId=05e01593-acb6-5e28-a5ac-8c8f74359c62

package/dist/sdk/runtime-primitives.d.ts

@@ -51,7 +51,7 @@ export { type VectorizationEmbeddingIdentity, type VectorizationEmbeddingMetadat
 export { sentryCaptureCliError, sentryFinishCommandSpan, sentryFlush, sentryLogCliUsageError, sentrySetCommandContext, sentryStartCommandSpan, } from "../core/sentry/helpers.js";
 export { ensureSentryInit } from "../core/sentry/instrument.js";
 export { clearFocusedItem, getFocusedItem, setFocusedItem, } from "../core/session/session-state.js";
-export { readAuthorEnvironment, resolveAuthor, resolveClaimPrincipal, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, type AgentClientInfo, writeAuthorEnvironment, } from "../core/shared/author.js";
+export { readAuthorEnvironment, diagnoseAgentIdentity, resolveAuthor, resolveClaimPrincipal, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, type AgentClientInfo, writeAuthorEnvironment, } from "../core/shared/author.js";
 export { agentSessionEnvironment, boundAgentEpisodeIdentity, runWithAgentSessionContext, resolveAgentSessionContextFromSignals, type AgentEpisodeIdentity, type AgentSessionContext, } from "../core/shared/agent-session-context.js";
 export { evaluateMutationGuard, isMutationAction, listMutationActions, scanMutationSecrets, type EvaluateMutationGuardOptions, type MutationGuardResult, type MutationGuardSettings, type SecretGuardFinding, type SecretGuardMode, } from "./mutation-guard.js";
 export { jaccardSimilarity, normalizeSimilarityText, scoreItemSimilarity, tokenizeSimilarityText, type ItemSimilarityScore, } from "./similarity-scoring.js";

package/dist/sdk/runtime-primitives.js

@@ -7,7 +7,7 @@
  * prefer the typed operations exported by the main SDK barrel.
  */
 
-!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]="febc7f96-1757-5c07-8d99-ed5fce742afa")}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]="17358714-bb54-58e5-bba0-61bfd1323ec2")}catch(e){}}();
 export { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, } from "../core/checkpoint/mutation-checkpoint.js";
 export { flattenFlagListValue, resolveFlagValueKind, } from "../core/extensions/flag-value-types.js";
 export { activateExtensions, clearActiveExtensionHooks, consumeAfterCommandAffectedItems, createCoreCommandHookContext, createEmptyExtensionRegistrationRegistry, discoverExtensions, getActiveCommandResult, getActiveExtensionRegistrations, loadExtensions, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, resetActiveExtensionRuntimeState, runActiveCommandHandler, runActiveBeforeMutationHooks, runActiveOnIndexHooks, runActiveOnReadHooks, runActiveOnWriteHooks, runActiveParserOverride, runActivePreflightOverride, runActiveServiceOverride, runAfterCommandHooks, runBeforeCommandHooks, setActiveCommandContext, setActiveCommandResult, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, } from "../core/extensions/index.js";
@@ -53,7 +53,7 @@ export { buildVectorizationEmbeddingIdentity, buildVectorizationEmbeddingMetadat
 export { sentryCaptureCliError, sentryFinishCommandSpan, sentryFlush, sentryLogCliUsageError, sentrySetCommandContext, sentryStartCommandSpan, } from "../core/sentry/helpers.js";
 export { ensureSentryInit } from "../core/sentry/instrument.js";
 export { clearFocusedItem, getFocusedItem, setFocusedItem, } from "../core/session/session-state.js";
-export { readAuthorEnvironment, resolveAuthor, resolveClaimPrincipal, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, } from "../core/shared/author.js";
+export { readAuthorEnvironment, diagnoseAgentIdentity, resolveAuthor, resolveClaimPrincipal, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, } from "../core/shared/author.js";
 export { agentSessionEnvironment, boundAgentEpisodeIdentity, runWithAgentSessionContext, resolveAgentSessionContextFromSignals, } from "../core/shared/agent-session-context.js";
 export { evaluateMutationGuard, isMutationAction, listMutationActions, scanMutationSecrets, } from "./mutation-guard.js";
 export { jaccardSimilarity, normalizeSimilarityText, scoreItemSimilarity, tokenizeSimilarityText, } from "./similarity-scoring.js";
@@ -79,4 +79,4 @@ export { maybeRunFirstUseTelemetryPrompt } from "../core/telemetry/consent.js";
 export { deriveTelemetryCommandResolution, } from "../core/telemetry/observability.js";
 export { emitTelemetryErrorEvent, finishTelemetryCommand, startTelemetryCommand, } from "../core/telemetry/runtime.js";
 //# sourceMappingURL=runtime-primitives.js.map
-//# debugId=febc7f96-1757-5c07-8d99-ed5fce742afa
+//# debugId=17358714-bb54-58e5-bba0-61bfd1323ec2

package/dist/sdk/similarity.d.ts

@@ -88,6 +88,11 @@ export interface DuplicateClustersResult {
     threshold: number;
     /** Retrieval path used for this whole-workspace sweep. */
     source: "metadata_scan";
+    /** Effective lifecycle filter; null means the complete all-status corpus. */
+    filters: {
+        statuses: string[] | null;
+        since: string | null;
+    };
     /** Work performed after the single metadata read. */
     cost: {
         /** Items retained after filters. */

package/dist/sdk/similarity.js

@@ -5,10 +5,12 @@
  * governance and package-owned duplicate analysis.
  */
 
-!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]="078456b8-ed61-5c47-afc7-7553833934e1")}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]="a2fad90a-3575-5f3e-8cbe-ac380ac45591")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
+import { normalizeStatusInput } from "../core/item/status.js";
+import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
 import { listAllItemMetadataLight } from "../core/store/item-store.js";
 import { resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
@@ -62,14 +64,38 @@ async function loadPreparedDuplicateItems(options, since) {
     const pmRoot = resolvePmRoot(options.cwd ?? process.cwd(), options.pmRoot);
     const settings = await readSettings(pmRoot);
     const typeRegistry = resolveItemTypeRegistry(settings);
-    const allowedStatuses = options.statuses
-        ? new Set(options.statuses.map((status) => status.trim()).filter(Boolean))
+    const requestedStatuses = options.statuses
+        ?.map((status) => status.trim().toLowerCase())
+        .filter(Boolean);
+    if (options.statuses !== undefined && requestedStatuses?.length === 0) {
+        throw new PmCliError("Duplicate cluster statuses must include at least one lifecycle status or all.", EXIT_CODE.USAGE);
+    }
+    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+    const normalizedStatuses = requestedStatuses?.map((status) => {
+        if (status === "all")
+            return status;
+        const normalized = normalizeStatusInput(status, statusRegistry);
+        if (!normalized) {
+            throw new PmCliError(`Unknown duplicate-cluster status "${status}". Allowed: all, ${statusRegistry.definitions.map((entry) => entry.id).join(", ")}.`, EXIT_CODE.USAGE);
+        }
+        return normalized;
+    });
+    const hasAll = normalizedStatuses?.includes("all") === true;
+    if (hasAll && normalizedStatuses?.some((status) => status !== "all")) {
+        throw new PmCliError('The "all" status cannot be combined with other statuses.', EXIT_CODE.USAGE);
+    }
+    const effectiveStatuses = hasAll ? undefined : normalizedStatuses;
+    const allowedStatuses = effectiveStatuses
+        ? new Set(effectiveStatuses)
         : undefined;
-    return (await listAllItemMetadataLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema))
-        .filter((item) => (!allowedStatuses || allowedStatuses.has(item.status)) &&
-        (!since || new Date(item.created_at).getTime() >= since.getTime()))
-        .sort((left, right) => left.id.localeCompare(right.id))
-        .map((item) => ({ item, prepared: prepareSimilarityText(item.title) }));
+    return {
+        items: (await listAllItemMetadataLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema))
+            .filter((item) => (!allowedStatuses || allowedStatuses.has(item.status)) &&
+            (!since || new Date(item.created_at).getTime() >= since.getTime()))
+            .sort((left, right) => left.id.localeCompare(right.id))
+            .map((item) => ({ item, prepared: prepareSimilarityText(item.title) })),
+        statuses: effectiveStatuses,
+    };
 }
 function collectDuplicateCandidatePairs(items, maxPairEvaluations = MAX_BATCH_PAIR_EVALUATIONS) {
     const candidates = new Set();
@@ -233,7 +259,7 @@ export async function findDuplicateClusters(options = {}) {
         limit: undefined,
     });
     const { limit, since } = validateDuplicateClusterOptions(options);
-    const items = await loadPreparedDuplicateItems(options, since);
+    const { items, statuses } = await loadPreparedDuplicateItems(options, since);
     const candidates = collectDuplicateCandidatePairs(items);
     const union = createDuplicateUnionFind(items.length);
     const matches = scoreDuplicateCandidates(items, candidates, threshold, union);
@@ -243,6 +269,10 @@ export async function findDuplicateClusters(options = {}) {
         count: clusters.length,
         threshold,
         source: "metadata_scan",
+        filters: {
+            statuses: statuses ?? null,
+            since: options.since ?? null,
+        },
         cost: {
             item_count: items.length,
             candidate_pairs: candidates.size,
@@ -273,4 +303,4 @@ export async function evaluateSimilarityGovernance(candidate, options) {
     return { mode: options.mode, bypassed, result };
 }
 //# sourceMappingURL=similarity.js.map
-//# debugId=078456b8-ed61-5c47-afc7-7553833934e1
+//# debugId=a2fad90a-3575-5f3e-8cbe-ac380ac45591

package/dist/sdk/structured-mutations.js

@@ -5,7 +5,7 @@
  * transaction contract and normalizes full item documents for CLI round trips.
  */
 
-!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]="91be2c5d-c495-54bc-ac79-b4c645ad2c6e")}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]="07876c03-63a8-5c69-9c6c-c3446076a382")}catch(e){}}();
 import crypto from "node:crypto";
 import { normalizeItemId, normalizePrefix } from "../core/item/id.js";
 import { EXIT_CODE, ITEM_PROJECT_CONTEXT_KEYS, } from "../core/shared/constants.js";
@@ -43,6 +43,9 @@ const READ_ONLY_ITEM_KEYS = new Set([
     "format_version",
     "path",
     "author",
+    "collection_counts",
+    "notes_count",
+    "tests_count",
 ]);
 const UPDATE_READ_ONLY_ITEM_KEYS = new Set([
     ...READ_ONLY_ITEM_KEYS,
@@ -568,4 +571,4 @@ export function validateItemMutationRows(value) {
     return parseItemMutationBatch(JSON.stringify(value));
 }
 //# sourceMappingURL=structured-mutations.js.map
-//# debugId=91be2c5d-c495-54bc-ac79-b4c645ad2c6e
+//# debugId=07876c03-63a8-5c69-9c6c-c3446076a382