@unbrained/pm-cli 2026.8.11 → 2026.8.12

package/dist/sdk/query/activity.js

@@ -4,7 +4,7 @@
  * Implements the pm activity command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a7efa5e0-5610-51ca-8288-4f5410dbcf51")}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]="27a71d4d-f496-5d0a-9771-caa43b81e1f7")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { getActiveExtensionRegistrations, runActiveOnReadHooks, pathExists, enforceHistoryStreamPolicyForItems, resolveItemTypeRegistry, EXIT_CODE, PmCliError, compareTimestampStrings, nowIso, resolveIsoOrRelative, listAllItemMetadataLight, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
@@ -14,6 +14,27 @@ import { resolveModePairedOutputOmissionReceipt, } from "../output-projection.js
 import { compileHistoryProvenanceMatcher, projectHistoryProvenance, resolveHistoryProvenanceDimensions, summarizeHistoryProvenance, } from "../history-provenance.js";
 const DEFAULT_COMPACT_ACTIVITY_LIMIT = 20;
 const DEFAULT_FULL_ACTIVITY_LIMIT = 5;
+const DEFAULT_DIGEST_ACTIVITY_LIMIT = 15;
+const DEFAULT_DIGEST_WINDOW = "-24h";
+/** Normalize raw and full aliases into one explicit activity row projection. */
+export function normalizeActivityProjectionOptions(options) {
+    const normalized = { ...options };
+    if (normalized.full === true) {
+        normalized.raw = true;
+        normalized.compact = false;
+    }
+    else if (normalized.raw === true && normalized.compact === undefined) {
+        normalized.compact = true;
+    }
+    delete normalized.full;
+    return normalized;
+}
+const ACTIVITY_ROW_KEY_BY_MODE = {
+    digest: "activity_digest",
+    compact: "compact_activity",
+    provenance: "provenance_activity",
+    full: "activity",
+};
 function parseNonEmptyFilter(raw, flagLabel) {
     if (raw === undefined)
         return undefined;
@@ -92,10 +113,36 @@ async function listHistoryFiles(historyDir) {
         throw error;
     }
 }
-function resolveActivityFilters(options) {
+function resolveActivityProjectionMode(options) {
+    if (options.raw !== true &&
+        options.compact !== true &&
+        options.provenance !== true) {
+        return "digest";
+    }
+    if (options.provenance === true)
+        return "provenance";
+    if (options.compact === true ||
+        (options.raw === true && options.compact !== false)) {
+        return "compact";
+    }
+    return "full";
+}
+function resolveActivityLimit(options, explicitLimit, projectionMode) {
+    if (options.unbounded === true)
+        return undefined;
+    if (explicitLimit !== undefined)
+        return explicitLimit;
+    if (projectionMode === "digest")
+        return DEFAULT_DIGEST_ACTIVITY_LIMIT;
+    if (projectionMode === "compact")
+        return DEFAULT_COMPACT_ACTIVITY_LIMIT;
+    return DEFAULT_FULL_ACTIVITY_LIMIT;
+}
+function resolveActivityFilters(options, projectionMode) {
     const nowValue = nowIso();
-    const from = parseRangeBound(options.from, nowValue, "--from");
-    const to = parseRangeBound(options.to, nowValue, "--to");
+    const digest = projectionMode === "digest";
+    const to = parseRangeBound(options.to ?? (digest ? nowValue : undefined), nowValue, "--to");
+    const from = parseRangeBound(options.from ?? (digest ? DEFAULT_DIGEST_WINDOW : undefined), options.from === undefined && digest ? to : nowValue, "--from");
     if (from && to && compareTimestampStrings(from, to) >= 0) {
         throw new PmCliError("Activity --from must be before --to", EXIT_CODE.USAGE);
     }
@@ -109,12 +156,7 @@ function resolveActivityFilters(options) {
         author: parseNonEmptyFilter(options.author, "Activity --author"),
         from,
         to,
-        limit: options.unbounded === true
-            ? undefined
-            : (explicitLimit ??
-                (options.compact === true
-                    ? DEFAULT_COMPACT_ACTIVITY_LIMIT
-                    : DEFAULT_FULL_ACTIVITY_LIMIT)),
+        limit: resolveActivityLimit(options, explicitLimit, projectionMode),
         limitSource: options.unbounded === true || explicitLimit !== undefined
             ? "explicit"
             : "default",
@@ -147,7 +189,13 @@ async function prepareActivityHistoryRead(context) {
         path: historyDir,
         scope: "project",
     });
-    return historyDir;
+    return {
+        historyDir,
+        itemsById: new Map(items.map((item) => [
+            item.id,
+            { title: item.title, type: item.type, status: item.status },
+        ])),
+    };
 }
 function includeActivityEntry(entry, candidate, filters) {
     // Preserve legacy filter semantics: op/author filters compare the raw
@@ -186,6 +234,105 @@ function formatCompactActivity(activity) {
         ...(entry.message ? { msg: entry.message } : {}),
     }));
 }
+function boundedOperationSummary(counts) {
+    const ordered = [...counts.entries()].sort(([leftOp, leftCount], [rightOp, rightCount]) => rightCount - leftCount || leftOp.localeCompare(rightOp));
+    const visible = ordered.slice(0, 4).map(([op, count]) => `${op}:${count}`);
+    if (ordered.length > visible.length) {
+        visible.push(`+${ordered.length - visible.length}`);
+    }
+    return visible.join(",");
+}
+function buildActivityDigest(activity, itemsById) {
+    const grouped = new Map();
+    for (const entry of activity) {
+        const current = grouped.get(entry.id);
+        if (current === undefined) {
+            grouped.set(entry.id, {
+                firstTs: entry.ts,
+                lastTs: entry.ts,
+                eventCount: 1,
+                operations: new Map([[entry.op, 1]]),
+            });
+            continue;
+        }
+        current.eventCount += 1;
+        if (compareTimestampStrings(entry.ts, current.firstTs) < 0) {
+            current.firstTs = entry.ts;
+        }
+        if (compareTimestampStrings(entry.ts, current.lastTs) > 0) {
+            current.lastTs = entry.ts;
+        }
+        current.operations.set(entry.op, (current.operations.get(entry.op) ?? 0) + 1);
+    }
+    return [...grouped.entries()]
+        .map(([id, summary]) => {
+        const item = itemsById.get(id);
+        return {
+            id,
+            type: item?.type ?? "unknown",
+            status: item?.status ?? "unknown",
+            title: (item?.title ?? "(item metadata unavailable)").slice(0, 160),
+            event_count: summary.eventCount,
+            first_ts: summary.firstTs,
+            last_ts: summary.lastTs,
+            operations: boundedOperationSummary(summary.operations),
+        };
+    })
+        .sort((left, right) => compareTimestampStrings(right.last_ts, left.last_ts) ||
+        left.id.localeCompare(right.id));
+}
+function activityOperationCounts(activity) {
+    const counts = new Map();
+    for (const entry of activity) {
+        counts.set(entry.op, (counts.get(entry.op) ?? 0) + 1);
+    }
+    const ordered = [...counts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]));
+    const visible = ordered.slice(0, 8);
+    if (visible.length < ordered.length) {
+        visible.push([
+            `+${String(ordered.length - visible.length)}`,
+            ordered
+                .slice(visible.length)
+                .reduce((total, [, count]) => total + count, 0),
+        ]);
+    }
+    return Object.fromEntries(visible);
+}
+function projectActivityRows(projectionMode, matchingActivity, limit, itemsById, projectProvenance) {
+    if (projectionMode === "digest") {
+        const matchingDigest = buildActivityDigest(matchingActivity, itemsById);
+        const activityDigest = limitEntries(matchingDigest, limit);
+        return {
+            rows: { activity_digest: activityDigest },
+            compact: false,
+            totalRows: matchingDigest.length,
+            returnedRows: activityDigest.length,
+        };
+    }
+    const activity = limitEntries(matchingActivity, limit);
+    if (projectionMode === "compact") {
+        return {
+            rows: { compact_activity: formatCompactActivity(activity) },
+            compact: true,
+            totalRows: matchingActivity.length,
+            returnedRows: activity.length,
+        };
+    }
+    if (projectionMode === "provenance") {
+        return {
+            rows: { provenance_activity: activity.map(projectProvenance) },
+            compact: false,
+            totalRows: matchingActivity.length,
+            returnedRows: activity.length,
+        };
+    }
+    return {
+        rows: { activity },
+        compact: false,
+        totalRows: matchingActivity.length,
+        returnedRows: activity.length,
+    };
+}
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export const _testOnly = {
     parseNonEmptyFilter,
@@ -196,12 +343,15 @@ export const _testOnly = {
     normalizeActivityEntry,
     sortActivity,
     listHistoryFiles,
+    buildActivityDigest,
+    activityOperationCounts,
 };
 /** Implements run activity for the public runtime surface of this module. */
 export async function runActivity(options, global) {
     const context = await resolveActivityRuntimeContext(global);
-    const filters = resolveActivityFilters(options);
-    const historyDir = await prepareActivityHistoryRead(context);
+    const projectionMode = resolveActivityProjectionMode(options);
+    const filters = resolveActivityFilters(options, projectionMode);
+    const prepared = await prepareActivityHistoryRead(context);
     const provenanceDimensions = resolveHistoryProvenanceDimensions(context.settings.agent_identity.harness_signals);
     const vocabulary = context.settings.agent_identity.identity_vocabulary;
     const matchesProvenance = compileHistoryProvenanceMatcher({
@@ -209,37 +359,33 @@ export async function runActivity(options, global) {
         agentInstance: filters.agentInstance,
         provenance: filters.provenance,
     }, vocabulary, provenanceDimensions);
-    const matchingActivity = sortActivity(await collectActivityEntries(historyDir, filters)).filter(matchesProvenance);
-    const activity = limitEntries(matchingActivity, filters.limit);
-    const compact = options.compact === true;
-    const compactActivity = compact ? formatCompactActivity(activity) : undefined;
-    const provenanceActivity = options.provenance === true
-        ? activity.map((entry) => projectHistoryProvenance(entry, vocabulary, { itemId: entry.id }))
-        : undefined;
-    const omittedCount = matchingActivity.length - activity.length;
-    const projectionMode = options.provenance === true ? "provenance" : compact ? "compact" : "full";
-    const rowProjection = {
-        compact: { compact_activity: compactActivity },
-        provenance: { provenance_activity: provenanceActivity },
-        full: { activity },
-    }[projectionMode];
+    const matchingActivity = sortActivity(await collectActivityEntries(prepared.historyDir, filters)).filter(matchesProvenance);
+    const projected = projectActivityRows(projectionMode, matchingActivity, filters.limit, prepared.itemsById, (entry) => projectHistoryProvenance(entry, vocabulary, { itemId: entry.id }));
+    const omittedCount = projected.totalRows - projected.returnedRows;
     return {
-        ...rowProjection,
-        compact,
+        ...projected.rows,
+        compact: projected.compact,
         projection: {
             mode: projectionMode,
-            row_key: projectionMode === "compact"
-                ? "compact_activity"
-                : projectionMode === "provenance"
-                    ? "provenance_activity"
-                    : "activity",
+            row_key: ACTIVITY_ROW_KEY_BY_MODE[projectionMode],
         },
         omission_receipt: resolveModePairedOutputOmissionReceipt("activity", projectionMode),
-        count: activity.length,
-        total_count: matchingActivity.length,
+        count: projected.returnedRows,
+        total_count: projected.totalRows,
         limit: filters.limit ?? null,
         omitted_count: omittedCount,
         has_more: omittedCount > 0,
+        ...(projectionMode === "digest"
+            ? {
+                activity_summary: {
+                    window: { from: filters.from, to: filters.to },
+                    event_count: matchingActivity.length,
+                    item_count: projected.totalRows,
+                    author_count: new Set(matchingActivity.map((entry) => entry.author)).size,
+                    operation_counts: activityOperationCounts(matchingActivity),
+                },
+            }
+            : {}),
         ...(options.provenanceSummary === true
             ? {
                 provenance_summary: summarizeHistoryProvenance(matchingActivity, vocabulary, provenanceDimensions),
@@ -253,4 +399,4 @@ export async function runActivity(options, global) {
     };
 }
 //# sourceMappingURL=activity.js.map
-//# debugId=a7efa5e0-5610-51ca-8288-4f5410dbcf51
+//# debugId=27a71d4d-f496-5d0a-9771-caa43b81e1f7

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]="f68f4074-51ba-5065-8cca-fe16acd48927")}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]="89176e36-40ea-5ec2-b291-d1cf042c4140")}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";
@@ -13,6 +13,7 @@ import { buildItemSchedule, } from "../item-schedule.js";
 import { getItemAt } from "../history-read.js";
 import { parseIntegerLimit } from "./parsers.js";
 import { runList } from "./list.js";
+import { registerOutputMaterialFieldGroups } from "../output-projection.js";
 const GET_DEPTH_VALUES = ["brief", "standard", "deep"];
 const AUTOMATIC_CHILD_ROLLUP_TYPES = new Set([
     "epic",
@@ -38,6 +39,21 @@ function itemCollectionCounts(item) {
     ]));
     return lengths;
 }
+function itemMaterialFieldGroups(item, body) {
+    const collectionCounts = itemCollectionCounts(item);
+    return [
+        ...(body.length > 0 ? ["body"] : []),
+        ...Object.entries(collectionCounts).flatMap(([name, count]) => count > 0 ? [name] : []),
+        ...(collectionCounts.files + collectionCounts.tests + collectionCounts.docs > 0
+            ? ["linked"]
+            : []),
+        "children",
+        ...(typeof item.assignee === "string" && item.assignee.trim().length > 0
+            ? ["claim_state"]
+            : []),
+        ...(buildItemSchedule(item) ? ["schedule"] : []),
+    ];
+}
 /** Decide whether a normal read should pay for a workspace-wide child projection. */
 function shouldAutoIncludeGetChildren(itemType) {
     const normalizedType = itemType.trim().toLowerCase();
@@ -414,6 +430,7 @@ export async function runGet(id, global, options = {}) {
             // Derived usage feedback must never make the source-of-truth read fail.
         }
     }
+    registerOutputMaterialFieldGroups(result, itemMaterialFieldGroups(context.metadata, context.body));
     return result;
 }
 /** Public contract for test-only get command policy helpers. */
@@ -421,4 +438,4 @@ export const _testOnlyGetCommand = {
     shouldAutoIncludeGetChildren,
 };
 //# sourceMappingURL=get.js.map
-//# debugId=f68f4074-51ba-5065-8cca-fe16acd48927
+//# debugId=89176e36-40ea-5ec2-b291-d1cf042c4140

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

@@ -19,6 +19,8 @@ export interface PmReadOutputOptions {
     outputFormat?: "json" | "toon";
     /** Caller-carried cross-call budget and served-fact state. */
     outputSession?: string | PmReadOutputSessionState;
+    /** Include row selector and encoding discovery metadata. */
+    outputRowContract?: boolean;
 }
 /** Compatibility spelling retained for a command-specific output control. */
 export interface PmReadOutputLegacyAlias {
@@ -130,7 +132,7 @@ export type PmReadOutputResultFor<Result, Options> = "outputBudget" extends keyo
 /** Canonical CLI flags that opt a read invocation into universal output shaping. */
 export declare const PM_READ_OUTPUT_OPTION_FLAGS: readonly string[];
 /** Canonical control that composes the four per-call dimensions across reads. */
-export declare const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS: readonly ["--output-session"];
+export declare const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS: readonly ["--output-session", "--output-row-contract"];
 /** Universal output contract for every built-in read surface. */
 export declare const PM_READ_OUTPUT_SURFACE_CONTRACTS: readonly PmReadOutputSurfaceContract[];
 /** Resolve a command or list/context alias to its canonical read-output surface. */
@@ -139,6 +141,8 @@ export declare function resolveReadOutputSurface(command: string): PmReadOutputS
 export declare function validateReadOutputOptions(command: string, options: Record<string, unknown>): void;
 /** Resolve canonical and compatibility controls into the universal dimension set. */
 export declare function resolveReadOutputDimensions(command: string, options: Record<string, unknown>): PmResolvedReadOutputDimensions | undefined;
+/** Recompute read and optional session receipts after a final envelope projection. */
+export declare function stabilizeReadOutputReceiptEstimates(result: Record<string, unknown>, options: Record<string, unknown>): Record<string, unknown>;
 /** Apply universal field, row, and token bounds and attach an exact receipt. */
 export declare function applyReadOutputDimensions<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result): PmReadOutputResult<Result>;
 /** Narrow a universal read result to its budget-omission branch. */

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]="819ac44d-0add-581c-90e8-ac6e8247b04b")}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]="0ab0c72c-cac0-5670-93d1-7a446f8a2301")}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";
@@ -58,6 +58,7 @@ export const PM_READ_OUTPUT_OPTION_FLAGS = Object.freeze(PM_READ_OUTPUT_DIMENSIO
 /** Canonical control that composes the four per-call dimensions across reads. */
 export const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS = Object.freeze([
     "--output-session",
+    "--output-row-contract",
 ]);
 const LEGACY_FLAGS_BY_COMMAND = {
     list: {
@@ -216,6 +217,8 @@ const CANONICAL_OPTION_KEYS = [
     "output_format",
     "outputSession",
     "output_session",
+    "outputRowContract",
+    "output_row_contract",
 ];
 const HYBRID_READ_MUTATION_KEYS = {
     comments: ["add", "body", "stdin", "file", "edit", "delete"],
@@ -580,6 +583,18 @@ function attachReadOutputSessionContracts(result, state, receipt) {
     }
     return withSession;
 }
+/** Recompute read and optional session receipts after a final envelope projection. */
+export function stabilizeReadOutputReceiptEstimates(result, options) {
+    if (!isRecord(result.read_output))
+        return result;
+    const receipt = result.read_output;
+    const session = parseReadOutputSession(options.outputSession ?? options.output_session);
+    if (session === undefined) {
+        updateReadOutputReceiptEstimate(result, receipt);
+        return result;
+    }
+    return attachReadOutputSessionContracts(result, session, receipt);
+}
 /** Apply field, amount, and repeat projections to every declared row path. */
 function projectReadOutputRows(result, resolved, session) {
     let projected = { ...result };
@@ -695,4 +710,4 @@ export function resolveReadOutputEncoding(command, options) {
         : undefined;
 }
 //# sourceMappingURL=read-output-contracts.js.map
-//# debugId=819ac44d-0add-581c-90e8-ac6e8247b04b
+//# debugId=0ab0c72c-cac0-5670-93d1-7a446f8a2301

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

@@ -46,6 +46,8 @@ export interface PmReadOutputSessionReceipt {
     seen_before_count: number;
     /** Number of newly delivered item facts retained in this envelope. */
     new_item_count: number;
+    /** Newly delivered identities omitted from next_state after its capacity filled. */
+    seen_item_overflow_count?: number;
     /** Number of repeated item rows replaced by references. */
     suppressed_repeat_count: number;
     /** Stable reference syntax used by suppressed rows. */

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

@@ -5,7 +5,7 @@
  * budgets and resolvable references to item facts served by earlier reads.
  */
 
-!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]="04ad0d11-1fb7-5eb4-8ff0-d81a7090c4ff")}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]="642f6dec-c0b2-5377-a401-dfa4f8ef6a2a")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { mapReadOutputRows, readOutputRowCollections, } from "./read-output-rows.js";
@@ -141,9 +141,13 @@ export function applyReadOutputSessionReferences(result, state) {
 /** Attach a fixed-point session receipt and return the exact charged tokens. */
 export function attachReadOutputSessionReceipt(result, state) {
     const { deliveredIds, suppressedRepeatCount } = summarizeReadOutputSessionRows(result);
-    const nextSeen = [
-        ...new Set([...state.seen_item_ids, ...deliveredIds]),
-    ].sort();
+    const alreadySeen = new Set(state.seen_item_ids);
+    const newlySeen = [...deliveredIds]
+        .filter((id) => !alreadySeen.has(id))
+        .sort();
+    const retainedNewIds = newlySeen.slice(0, PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS - state.seen_item_ids.length);
+    const nextSeen = [...state.seen_item_ids, ...retainedNewIds].sort();
+    const seenItemOverflowCount = newlySeen.length - retainedNewIds.length;
     const receipt = {
         contract_version: 1,
         id: state.id,
@@ -158,6 +162,9 @@ export function attachReadOutputSessionReceipt(result, state) {
         exhausted: false,
         seen_before_count: state.seen_item_ids.length,
         new_item_count: deliveredIds.size,
+        ...(seenItemOverflowCount === 0
+            ? {}
+            : { seen_item_overflow_count: seenItemOverflowCount }),
         suppressed_repeat_count: suppressedRepeatCount,
         reference_format: "session:<session-id>:<item-id>",
         restore_reference_with: "pm get <item-id> --brief",
@@ -197,4 +204,4 @@ export function readOutputSessionRemainingTokens(state) {
     return Math.max(0, state.token_budget - state.spent_tokens);
 }
 //# sourceMappingURL=read-output-session.js.map
-//# debugId=04ad0d11-1fb7-5eb4-8ff0-d81a7090c4ff
+//# debugId=642f6dec-c0b2-5377-a401-dfa4f8ef6a2a

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

@@ -16,10 +16,10 @@ export { resolveRegisteredSearchProvider, resolveRegisteredVectorStoreAdapter, }
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
 export { type HistoryDiffValueEntry, computeHistoryDiff, patchPathToChangedField, } from "../core/history/history-diff.js";
 export { enforceHistoryStreamPolicyForItem, enforceHistoryStreamPolicyForItems, } from "../core/history/history-stream-policy.js";
-export { appendHistoryEntry, createHistoryEntry, hashDocument, hashEmptyDocument, } from "../core/history/history.js";
+export { appendHistoryEntry, CURRENT_HISTORY_ITEM_HASH_VERSION, createHistoryEntry, hashDocument, hashDocumentForVersion, hashEmptyDocument, SUPPORTED_HISTORY_ITEM_HASH_VERSIONS, type HistoryItemHashVersion, } from "../core/history/history.js";
 export { readHistoryEntries } from "../core/history/read.js";
 export { appendWorkspaceAuditEvent, appendWorkspaceHistoryChange, getWorkspaceHistoryPath, mutateWorkspaceJsonWithHistory, WORKSPACE_HISTORY_ID, writeWorkspaceJsonWithHistory, type WorkspaceAuditEventOptions, type WorkspaceHistoryChange, type WorkspaceJsonMutation, type WorkspaceJsonMutationOptions, type WorkspaceJsonWriteOptions, } from "../core/history/workspace-history.js";
-export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, } from "../core/history/replay.js";
+export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, verifyHistoryChainWithVersion, } from "../core/history/replay.js";
 export { resolveBodyFileContent } from "../core/io/body-file.js";
 export { generateItemId, normalizeItemId, normalizeRawItemId, } from "../core/item/id.js";
 export { canonicalDocument, normalizeItemMetadata, parseItemDocument, serializeItemDocument, } from "../core/item/item-format.js";
@@ -72,7 +72,7 @@ export { splitCommaList } from "../core/shared/split-comma-list.js";
 export { compareTimestampStrings, nowIso, resolveIsoOrRelative, } from "../core/shared/time.js";
 export { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
 export { type CachedDocumentCandidate, listAllDocumentCandidatesCached, } from "../core/store/item-metadata-cache.js";
-export { buildItemNotFoundError, createMutationGuardSdk, deleteItem, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
+export { buildItemNotFoundError, createMutationGuardSdk, deleteItem, listAllItemMetadata, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
 export { isTerminalPlanMode, shouldCompletePlanOnClose, } from "../core/item/plan-lifecycle.js";
 export { getHistoryPath, getItemPath, getSettingsPath, resolveImplicitPmRoot, resolvePmRoot, } from "../core/store/paths.js";
 export { persistSelectedItemFormat, readSettings, readSettingsWithMetadata, writeSettings, } from "../core/store/settings.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]="16d4bbae-03b7-5316-8e26-77f33affdcf6")}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]="78779372-1987-54d0-9ae4-775b52641a26")}catch(e){}}();
 export { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, } from "../core/checkpoint/mutation-checkpoint.js";
 export { flattenFlagListValue, resolveFlagValueKind, } from "../core/extensions/flag-value-types.js";
 export { createUnknownSubcommandError, } from "./agent/subcommand-recovery.js";
@@ -18,10 +18,10 @@ export { resolveRegisteredSearchProvider, resolveRegisteredVectorStoreAdapter, }
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
 export { computeHistoryDiff, patchPathToChangedField, } from "../core/history/history-diff.js";
 export { enforceHistoryStreamPolicyForItem, enforceHistoryStreamPolicyForItems, } from "../core/history/history-stream-policy.js";
-export { appendHistoryEntry, createHistoryEntry, hashDocument, hashEmptyDocument, } from "../core/history/history.js";
+export { appendHistoryEntry, CURRENT_HISTORY_ITEM_HASH_VERSION, createHistoryEntry, hashDocument, hashDocumentForVersion, hashEmptyDocument, SUPPORTED_HISTORY_ITEM_HASH_VERSIONS, } from "../core/history/history.js";
 export { readHistoryEntries } from "../core/history/read.js";
 export { appendWorkspaceAuditEvent, appendWorkspaceHistoryChange, getWorkspaceHistoryPath, mutateWorkspaceJsonWithHistory, WORKSPACE_HISTORY_ID, writeWorkspaceJsonWithHistory, } from "../core/history/workspace-history.js";
-export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, } from "../core/history/replay.js";
+export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, verifyHistoryChainWithVersion, } from "../core/history/replay.js";
 export { resolveBodyFileContent } from "../core/io/body-file.js";
 export { generateItemId, normalizeItemId, normalizeRawItemId, } from "../core/item/id.js";
 export { canonicalDocument, normalizeItemMetadata, parseItemDocument, serializeItemDocument, } from "../core/item/item-format.js";
@@ -73,7 +73,7 @@ export { splitCommaList } from "../core/shared/split-comma-list.js";
 export { compareTimestampStrings, nowIso, resolveIsoOrRelative, } from "../core/shared/time.js";
 export { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
 export { listAllDocumentCandidatesCached, } from "../core/store/item-metadata-cache.js";
-export { buildItemNotFoundError, createMutationGuardSdk, deleteItem, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
+export { buildItemNotFoundError, createMutationGuardSdk, deleteItem, listAllItemMetadata, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
 export { isTerminalPlanMode, shouldCompletePlanOnClose, } from "../core/item/plan-lifecycle.js";
 export { getHistoryPath, getItemPath, getSettingsPath, resolveImplicitPmRoot, resolvePmRoot, } from "../core/store/paths.js";
 export { persistSelectedItemFormat, readSettings, readSettingsWithMetadata, writeSettings, } from "../core/store/settings.js";
@@ -81,4 +81,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=16d4bbae-03b7-5316-8e26-77f33affdcf6
+//# debugId=78779372-1987-54d0-9ae4-775b52641a26

package/dist/sdk/runtime-stats-options.js

@@ -1,9 +1,10 @@
 
-!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]="dbabff08-1bb7-539b-b1c1-c10584aa0a67")}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]="0e63298a-d2d7-5217-af50-a206348b4cd4")}catch(e){}}();
 import { readRuntimeString, readRuntimeStringArray } from "./runtime-input.js";
 /** Convert a flat runtime option bag into the canonical typed stats payload. */
 export function statsCommandOptionsFromRuntime(options) {
     return {
+        includeEmpty: options.includeEmpty === true,
         storage: options.storage === true,
         metadataCoverage: options.metadataCoverage === true,
         fieldUtilization: options.fieldUtilization === true,
@@ -35,4 +36,4 @@ export function statsCommandOptionsFromRuntime(options) {
     };
 }
 //# sourceMappingURL=runtime-stats-options.js.map
-//# debugId=dbabff08-1bb7-539b-b1c1-c10584aa0a67
+//# debugId=0e63298a-d2d7-5217-af50-a206348b4cd4

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]="a294f940-5bb9-55a4-bf2c-64842a3a177b")}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]="7c27b516-1714-5f2b-8304-98e8372280be")}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";
@@ -33,7 +33,7 @@ import { applyContextIntentProjection, attachReadOutputContracts, } from "./cont
 import { runWithDiscoveredContextIntentContracts, } from "./context-intent-runtime.js";
 import { validateReadOutputOptions, } from "./read-output-contracts.js";
 export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";
-import { runActivity } from "./query/activity.js";
+import { normalizeActivityProjectionOptions, runActivity, } from "./query/activity.js";
 import { runAssuranceDispatch } from "./governance/assurance-action.js";
 import { runAggregate, } from "./query/aggregate.js";
 import { runAppend } from "./lifecycle/append.js";
@@ -1456,12 +1456,8 @@ function runMcpConfigAction(ctx) {
         "project", configAction, readString(ctx.args, "key") ?? readString(ctx.options, "key"), ctx.options, ctx.global, readString(ctx.args, "value") ?? readString(ctx.options, "value"));
 }
 function runMcpActivityAction(ctx) {
-    const activityOptions = { ...ctx.options };
-    if (activityOptions.compact === undefined) {
-        activityOptions.compact = activityOptions.full === true ? false : true;
-    }
-    delete activityOptions.full;
-    return runActivity(activityOptions, ctx.global);
+    const options = ctx.options;
+    return runActivity(normalizeActivityProjectionOptions(options), ctx.global);
 }
 function parseMcpIntegerPrefix(value, label) {
     if (typeof value === "number") {
@@ -1934,4 +1930,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=a294f940-5bb9-55a4-bf2c-64842a3a177b
+//# debugId=7c27b516-1714-5f2b-8304-98e8372280be