@unbrained/pm-cli 2026.8.8 → 2026.8.10

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/runtime.d.ts

@@ -7,6 +7,7 @@ export { PM_GITIGNORE_END, PM_GITIGNORE_START, ensurePmGitignore, getPmGitignore
 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";
 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";
@@ -74,7 +75,7 @@ export { EXIT_CODE };
 export { PmCliError } from "../core/shared/errors.js";
 export { isTimestampLiteral, nowIso } from "../core/shared/time.js";
 export { jaccardSimilarity, normalizeSimilarityText, scoreItemSimilarity, tokenizeSimilarityText, type ItemSimilarityScore, } from "./similarity-scoring.js";
-export { listAllItemMetadata, locateItem, readLocatedItem, } from "../core/store/item-store.js";
+export { listAllItemMetadata, listAllItemMetadataLight, locateItem, readLocatedItem, } from "../core/store/item-store.js";
 export { getHistoryPath, getItemPath, getSettingsPath, resolveImplicitPmRoot, resolvePmRoot, } from "../core/store/paths.js";
 export { readSettings } from "../core/store/settings.js";
 export { runAggregate, type AggregateOptions, type AggregateResult, type AggregateRow, } from "./query/aggregate.js";
@@ -131,6 +132,8 @@ export declare class PmClient {
     private runTyped;
     /** Return the same context snapshot produced by `pm context`. */
     context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>;
+    /** Read every item through the scalar-only metadata cache without materializing heavy collections or bodies. */
+    listAllItemMetadataLight(): Promise<ItemMetadata[]>;
     /** List items with the MCP/agent compact defaults. */
     list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>;
     /** Search items with the MCP/agent compact defaults. */

package/dist/sdk/runtime.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Runtime.
  */
 
-!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]="c8f2b88e-1883-5744-868b-3a16f3814813")}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]="70ce3cab-35f0-508b-9348-2f8479495946")}catch(e){}}();
 export { PM_GITIGNORE_END, PM_GITIGNORE_START, ensurePmGitignore, getPmGitignoreBlock, } from "./workspace.js";
 export { SEARCH_EXTENSION_FLAG_DEFINITIONS } from "./extension-contracts.js";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -22,6 +22,7 @@ import { createAsyncReadWriteGate } from "../core/shared/serial-queue.js";
 import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../core/schema/runtime-schema.js";
 import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
+import { listClientItemMetadataLight } from "./query/light-metadata.js";
 import { buildWorkspaceExtensionCommandContracts, buildWorkspaceFieldContracts, } from "./workspace-contracts.js";
 import { PM_TOOL_ACTIONS } from "./cli-contracts/enum-contracts.js";
 import { clearWorkspaceContractsCache, memoizeWorkspaceExtensionRegistrations, } from "./workspace-contracts-cache.js";
@@ -99,7 +100,7 @@ export { EXIT_CODE };
 export { PmCliError } from "../core/shared/errors.js";
 export { isTimestampLiteral, nowIso } from "../core/shared/time.js";
 export { jaccardSimilarity, normalizeSimilarityText, scoreItemSimilarity, tokenizeSimilarityText, } from "./similarity-scoring.js";
-export { listAllItemMetadata, locateItem, readLocatedItem, } from "../core/store/item-store.js";
+export { listAllItemMetadata, listAllItemMetadataLight, locateItem, readLocatedItem, } from "../core/store/item-store.js";
 export { getHistoryPath, getItemPath, getSettingsPath, resolveImplicitPmRoot, resolvePmRoot, } from "../core/store/paths.js";
 export { readSettings } from "../core/store/settings.js";
 export { runAggregate, } from "./query/aggregate.js";
@@ -169,6 +170,10 @@ export class PmClient {
     context(options = {}) {
         return this.runTyped("context", { options });
     }
+    /** Read every item through the scalar-only metadata cache without materializing heavy collections or bodies. */
+    listAllItemMetadataLight() {
+        return listClientItemMetadataLight(this.defaults.path, this.defaults.cwd);
+    }
     /** List items with the MCP/agent compact defaults. */
     list(options = {}) {
         return this.runTyped("list", { options });
@@ -1925,4 +1930,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=c8f2b88e-1883-5744-868b-3a16f3814813
+//# debugId=70ce3cab-35f0-508b-9348-2f8479495946

package/dist/sdk/schema-migration.js

@@ -7,7 +7,7 @@
  * guarantees.
  */
 
-!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]="c4b4af3b-6ce6-56f7-9665-9e6b2f3d9630")}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]="7d175791-016d-59b6-a44d-a70371f36751")}catch(e){}}();
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -18,6 +18,7 @@ import { parseFieldsFile, serializeFieldsFile, } from "../core/schema/fields-fil
 import { parseItemTypesFile, serializeItemTypesFile, } from "../core/schema/item-types-file.js";
 import { DEFAULT_RUNTIME_SCHEMA_FILE_PATHS, filePathForSchemaSection, normalizeRuntimeSchemaSettings, } from "../core/schema/runtime-schema.js";
 import { parseStatusDefsFile, serializeStatusDefsFile, } from "../core/schema/status-defs-file.js";
+import { normalizeStatusToken } from "../core/schema/status-token.js";
 import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
 import { listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
 import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
@@ -55,9 +56,6 @@ export function deriveSchemaEvolutionMigrationId(requestInput, migrationScope) {
         .slice(0, 20)}`;
 }
 function normalizedRequest(request) {
-    const normalizeToken = (value) => requiredText(value, "source or target")
-        .toLowerCase()
-        .replaceAll(/[\s-]+/g, "_");
     const normalized = request.kind === "rename-type"
         ? {
             kind: request.kind,
@@ -67,16 +65,16 @@ function normalizedRequest(request) {
         : request.kind === "rename-field"
             ? {
                 kind: request.kind,
-                from: normalizeToken(request.from),
-                to: normalizeToken(request.to),
+                from: normalizeStatusToken(requiredText(request.from, "source")),
+                to: normalizeStatusToken(requiredText(request.to, "target")),
                 ...(request.type === undefined
                     ? {}
                     : { type: requiredText(request.type, "type") }),
             }
             : {
                 kind: request.kind,
-                from: normalizeToken(request.from),
-                to: normalizeToken(request.to),
+                from: normalizeStatusToken(requiredText(request.from, "source")),
+                to: normalizeStatusToken(requiredText(request.to, "target")),
             };
     if (normalized.from.toLowerCase() === normalized.to.toLowerCase()) {
         throw new TypeError("Schema migration source and target must differ");
@@ -857,4 +855,4 @@ export const schemaMigrationTestOnly = {
     validateAndStoreMigrationPlan,
 };
 //# sourceMappingURL=schema-migration.js.map
-//# debugId=c4b4af3b-6ce6-56f7-9665-9e6b2f3d9630
+//# debugId=7d175791-016d-59b6-a44d-a70371f36751

package/dist/sdk/similarity-scoring.d.ts

@@ -1,3 +1,4 @@
+export { jaccardSimilarity } from "../core/shared/text-normalization.js";
 /** Precomputed title signals reused by bounded batch similarity operations. */
 export interface PreparedSimilarityText {
     /** Canonical title used for exact comparison. */
@@ -20,8 +21,6 @@ export declare function normalizeSimilarityText(value: string): string;
 export declare function tokenizeSimilarityText(value: string): string[];
 /** Precompute every deterministic title signal exactly once for repeated comparisons. */
 export declare function prepareSimilarityText(value: string): PreparedSimilarityText;
-/** Measure set overlap between two token collections. */
-export declare function jaccardSimilarity(leftTokens: readonly string[], rightTokens: readonly string[]): number;
 /** Score two titles through the canonical exact, issue-code, and token signals. */
 export declare function scoreItemSimilarity(leftTitle: string, rightTitle: string): ItemSimilarityScore;
 /** Score two precomputed title representations without repeating normalization or tokenization. */

package/dist/sdk/similarity-scoring.js

@@ -5,7 +5,9 @@
  * extension packages without loading tracker query infrastructure.
  */
 
-!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]="64312ac7-5a99-5a21-b99f-2bdef1b54a06")}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]="dff9b113-2b29-5154-afbf-f191f2f556a6")}catch(e){}}();
+import { jaccardSimilarity } from "../core/shared/text-normalization.js";
+export { jaccardSimilarity } from "../core/shared/text-normalization.js";
 const ISSUE_CODE_PATTERN = /\b[a-z][a-z0-9]*-\d+(?:-[a-z0-9]+)*\b/giu;
 /** Normalize title text for exact comparisons and tokenization. */
 export function normalizeSimilarityText(value) {
@@ -30,20 +32,6 @@ export function prepareSimilarityText(value) {
         ],
     };
 }
-/** Measure set overlap between two token collections. */
-export function jaccardSimilarity(leftTokens, rightTokens) {
-    const left = new Set(leftTokens);
-    const right = new Set(rightTokens);
-    const union = new Set([...left, ...right]);
-    if (union.size === 0)
-        return 1;
-    let intersection = 0;
-    for (const token of left) {
-        if (right.has(token))
-            intersection += 1;
-    }
-    return intersection / union.size;
-}
 /** Score two titles through the canonical exact, issue-code, and token signals. */
 export function scoreItemSimilarity(leftTitle, rightTitle) {
     return scorePreparedItemSimilarity(prepareSimilarityText(leftTitle), prepareSimilarityText(rightTitle));
@@ -63,4 +51,4 @@ export function scorePreparedItemSimilarity(left, right) {
     };
 }
 //# sourceMappingURL=similarity-scoring.js.map
-//# debugId=64312ac7-5a99-5a21-b99f-2bdef1b54a06
+//# debugId=dff9b113-2b29-5154-afbf-f191f2f556a6

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. */