@unbrained/pm-cli 2026.8.7 → 2026.8.9

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]="0bccb953-bd78-5eee-a78d-8af3e250fa55")}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,11 +432,100 @@ 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 applyIncludeProjection(result, selectors) {
+function getProjectionVocabulary(result) {
+    const item = isRecord(result.item) ? result.item : {};
+    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));
+    return {
+        item,
+        itemFields,
+        sections,
+        valid: [
+            ...itemFields,
+            "item",
+            ...itemFields.map((field) => `item.${field}`),
+            ...sections,
+        ],
+    };
+}
+function applyGetIncludeProjection(result, selectors) {
+    const vocabulary = getProjectionVocabulary(result);
+    const unknown = selectors.filter((selector) => !vocabulary.valid.includes(selector));
+    if (unknown.length > 0) {
+        throw new PmCliError(`Unknown --output-include selector(s) for get: ${unknown.join(", ")}. Valid selectors: ${vocabulary.valid.join(", ")}.`, EXIT_CODE.USAGE);
+    }
+    const fullItem = selectors.includes("item");
+    const itemSelectors = selectors
+        .flatMap((selector) => selector.startsWith("item.")
+        ? [selector.slice("item.".length)]
+        : vocabulary.itemFields.includes(selector)
+            ? [selector]
+            : [])
+        .filter((selector, index, values) => values.indexOf(selector) === index);
+    if (fullItem && itemSelectors.length > 0) {
+        throw new PmCliError("--output-include cannot mix a full item with projected item fields; use item or item.<field>, not both.", EXIT_CODE.USAGE);
+    }
+    const selectedSections = new Set(selectors.filter((selector) => vocabulary.sections.includes(selector)));
+    const projected = Object.fromEntries(Object.entries(result).filter(([key]) => ENVELOPE_KEYS.has(key) || selectedSections.has(key)));
+    if (fullItem) {
+        projected.item = vocabulary.item;
+    }
+    else if (itemSelectors.length > 0) {
+        projected.item = projectRecordFields(vocabulary.item, itemSelectors);
+    }
+    const omittedFieldGroups = [
+        ...(fullItem
+            ? []
+            : itemSelectors.length > 0
+                ? vocabulary.itemFields
+                    .filter((field) => !itemSelectors.includes(field))
+                    .map((field) => ({
+                    name: `item.${field}`,
+                    restore_with: `--output-include item.${field}`,
+                }))
+                : [{ name: "item", restore_with: "--output-include item" }]),
+        ...vocabulary.sections
+            .filter((section) => !selectedSections.has(section))
+            .map((section) => ({
+            name: section,
+            restore_with: `--output-include ${section}`,
+        })),
+    ];
+    const inheritedOmittedFieldGroups = isRecord(projected.omission_receipt) &&
+        Array.isArray(projected.omission_receipt.omitted_field_groups)
+        ? projected.omission_receipt.omitted_field_groups
+        : [];
+    const combinedOmittedFieldGroups = [
+        ...inheritedOmittedFieldGroups,
+        ...omittedFieldGroups,
+    ];
+    projected.omission_receipt = {
+        has_omissions: combinedOmittedFieldGroups.length > 0,
+        omitted_field_group_count: combinedOmittedFieldGroups.length,
+        omitted_field_groups: combinedOmittedFieldGroups,
+    };
+    return projected;
+}
+function applyIncludeProjection(command, result, selectors) {
+    if (command === "get") {
+        return applyGetIncludeProjection(result, selectors);
+    }
     const rows = readOutputRowPaths(result);
     const qualifiedRowSelectors = selectors.flatMap((selector) => rows.flatMap((rowPath) => selector.startsWith(`${rowPath}.`)
         ? [selector.slice(rowPath.length + 1)]
@@ -486,7 +584,7 @@ function attachReadOutputSessionContracts(result, state, receipt) {
 function projectReadOutputRows(result, resolved, session) {
     let projected = { ...result };
     if (resolved.include?.source === "canonical") {
-        projected = applyIncludeProjection(projected, resolved.include.value);
+        projected = applyIncludeProjection(resolved.command, projected, resolved.include.value);
     }
     if (resolved.amount?.source === "canonical") {
         projected = applyAmountBound(projected, resolved.amount.value);
@@ -597,4 +695,4 @@ export function resolveReadOutputEncoding(command, options) {
         : undefined;
 }
 //# sourceMappingURL=read-output-contracts.js.map
-//# debugId=0bccb953-bd78-5eee-a78d-8af3e250fa55
+//# 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

@@ -10,7 +10,7 @@ import { EXIT_CODE } from "../core/shared/constants.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";
-export type { PmReadOutputSessionReceipt, PmReadOutputSessionState } from "./read-output-session.js";
+export type { PmReadOutputSessionReceipt, PmReadOutputSessionState, } from "./read-output-session.js";
 export type { PmContextIntentContract } from "./context-intent-contracts.js";
 export type { PmErrorCodeContract } from "./error-code-catalog.js";
 export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";

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]="42339e0d-ca3c-505f-8b98-acec81158b6e")}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]="c8f2b88e-1883-5744-868b-3a16f3814813")}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";
@@ -36,6 +36,7 @@ import { runAggregate, } from "./query/aggregate.js";
 import { runAppend } from "./lifecycle/append.js";
 import { runClaim, runClaimNext, runRelease } from "./lifecycle/claim.js";
 import { runCloseMany } from "./lifecycle/close-many.js";
+import { normalizeAnnotationTransportOptions } from "./annotations.js";
 import { runComments } from "./comments.js";
 import { runHistory } from "./query/history.js";
 import { runLearnings } from "./learnings.js";
@@ -60,7 +61,7 @@ import { runExtension, } from "./extension.js";
 import { runConfig } from "./config.js";
 import { runInit } from "./init.js";
 import { runRuntimeEvalAction, runRuntimeEventsAction, runRuntimeMergeAction, runRuntimeSchedulingAction, runRuntimeWorkspaceAction, } from "./runtime-extended-actions.js";
-import { acknowledgeUnknownAuthorHistoryEvents, } from "./author-attribution.js";
+import { acknowledgeUnknownAuthorHistoryEventsFromTransport, } from "./author-attribution.js";
 import { runProfileApply, runProfileLint, runProfileList, runProfileShow, } from "./profile.js";
 import { runHistoryRedact, } from "./history-redact.js";
 import { runMcpHistoryCompactAction, runMcpHistoryRepairAction, } from "./history-mcp.js";
@@ -1387,7 +1388,7 @@ async function runMcpCloseAction(ctx) {
     });
 }
 function runMcpCommentsAction(ctx) {
-    const commentOptions = { ...ctx.options };
+    const commentOptions = normalizeAnnotationTransportOptions(ctx.options);
     const isListing = commentOptions.add === undefined &&
         commentOptions.stdin === undefined &&
         commentOptions.file === undefined &&
@@ -1395,11 +1396,10 @@ function runMcpCommentsAction(ctx) {
         commentOptions.delete === undefined;
     if (isListing) {
         commentOptions.includeMeta = true;
-        if (commentOptions.limit === undefined && commentOptions.full !== true) {
+        if (commentOptions.limit === undefined && commentOptions.fullHistory !== true) {
             commentOptions.limit = "20";
         }
     }
-    delete commentOptions.full;
     return runComments(requireMcpItemId(ctx), commentOptions, ctx.global);
 }
 function runMcpFilesAction(ctx) {
@@ -1752,23 +1752,7 @@ function runMcpGraphAction(ctx) {
     return runGraph(readRequiredString(merged, "subcommand"), readString(merged, "id") ?? ctx.id, readString(merged, "target"), graphOptionsFromFlat(merged), ctx.global);
 }
 function runMcpHistoryAuthorAcknowledgeAction(ctx) {
-    const merged = { ...ctx.args, ...ctx.options };
-    const events = readStringArray(merged.historyEvent).map((value) => {
-        const separator = value.lastIndexOf(":");
-        return {
-            item_id: value.slice(0, separator).trim(),
-            line: Number(value.slice(separator + 1)),
-        };
-    });
-    return acknowledgeUnknownAuthorHistoryEvents(resolvePmRoot(process.cwd(), ctx.global.path), {
-        events,
-        all_actionable: merged.allActionable === true || merged.all_actionable === true,
-        attributed_author: readString(merged, "attributedAuthor") ??
-            readString(merged, "attributed_author") ??
-            "",
-        reviewer: readString(merged, "reviewer") ?? "",
-        reason: readString(merged, "reason") ?? "",
-    });
+    return acknowledgeUnknownAuthorHistoryEventsFromTransport(resolvePmRoot(process.cwd(), ctx.global.path), { ...ctx.args, ...ctx.options });
 }
 const SDK_ACTION_HANDLERS = {
     init: (ctx) => runInit(readString(ctx.args, "prefix"), ctx.global, ctx.options),
@@ -1813,8 +1797,8 @@ const SDK_ACTION_HANDLERS = {
     "close-task": runMcpCloseTaskAction,
     close: runMcpCloseAction,
     comments: runMcpCommentsAction,
-    notes: (ctx) => runNotes(requireMcpItemId(ctx), ctx.options, ctx.global),
-    learnings: (ctx) => runLearnings(requireMcpItemId(ctx), ctx.options, ctx.global),
+    notes: (ctx) => runNotes(requireMcpItemId(ctx), normalizeAnnotationTransportOptions(ctx.options), ctx.global),
+    learnings: (ctx) => runLearnings(requireMcpItemId(ctx), normalizeAnnotationTransportOptions(ctx.options), ctx.global),
     files: runMcpFilesAction,
     docs: (ctx) => runDocs(requireMcpItemId(ctx), withAddNoteOption(ctx.options), ctx.global),
     test: (ctx) => runTest(requireMcpItemId(ctx), ctx.options, ctx.global),
@@ -1941,4 +1925,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=42339e0d-ca3c-505f-8b98-acec81158b6e
+//# debugId=c8f2b88e-1883-5744-868b-3a16f3814813

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