@unbrained/pm-cli 2026.8.11 → 2026.8.13

package/dist/sdk/merge/receipts.js

@@ -7,7 +7,7 @@
  * value for the coordinator that performed the merge.
  */
 
-!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]="59863597-bf57-5d96-9cba-983443e5b209")}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]="7b87b458-164a-5332-8803-6b0695481644")}catch(e){}}();
 import { execFile } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { readdir, readFile } from "node:fs/promises";
@@ -58,7 +58,7 @@ export function summarizeMergeReceipt(receipt) {
         conflict_fields: receipt.decisions.map((decision) => decision.field),
         fields_from_theirs: receipt.fields_from_theirs,
         union_fields: receipt.union_fields,
-        preferred: receipt.preferred,
+        requested_preference: receipt.requested_preference ?? receipt.preferred ?? "ours",
         conflict_resolution: receipt.conflict_resolution,
         decisions: receipt.decisions.map((decision) => ({
             field: decision.field,
@@ -99,7 +99,7 @@ export async function writeMergeReceipt(params) {
         id: randomUUID(),
         item_path: itemPath.replaceAll("\\", "/"),
         item_id: itemId,
-        preferred: params.preferred,
+        requested_preference: params.preferred,
         conflict_resolution: params.conflictResolution ?? "preferred_side",
         fields_from_theirs: [...params.fieldsFromTheirs],
         union_fields: [...params.unionFields],
@@ -147,8 +147,10 @@ async function readReceiptsFromDirectory(directory, options) {
             continue;
         try {
             const parsed = JSON.parse(await readFile(path.join(directory, name), "utf8"));
+            const { preferred: legacyPreference, ...receiptWithoutLegacyKey } = parsed;
             const normalizedReceipt = {
-                ...parsed,
+                ...receiptWithoutLegacyKey,
+                requested_preference: parsed.requested_preference ?? legacyPreference ?? "ours",
                 conflict_resolution: parsed.conflict_resolution ?? "preferred_side",
             };
             if (normalizedReceipt.version === 1 &&
@@ -218,4 +220,4 @@ export async function runMergeReceiptReport(options) {
     };
 }
 //# sourceMappingURL=receipts.js.map
-//# debugId=59863597-bf57-5d96-9cba-983443e5b209
+//# debugId=7b87b458-164a-5332-8803-6b0695481644

package/dist/sdk/merge/three-way.d.ts

@@ -98,8 +98,8 @@ export interface ItemDocumentMergeResult {
     union_fields: string[];
     /** Scalar conflict decisions; callers choose a privacy-appropriate persistence boundary. */
     conflict_decisions: ItemMergeConflictDecision[];
-    /** Which side unresolvable conflicts were resolved toward. */
-    preferred: MergePreferredSide;
+    /** Side requested by the caller; stable-value decisions can retain either side. */
+    requested_preference: MergePreferredSide;
     /** Scalar-conflict selection contract used for this merge. */
     conflict_resolution: "preferred_side" | "stable_value_order";
 }

package/dist/sdk/merge/three-way.js

@@ -9,7 +9,7 @@
  * definition for multi-branch agent workflows.
  */
 
-!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]="f6f04eec-0698-5e5b-a40e-de3a4be89f95")}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]="3c9d6924-ae7c-57c3-a346-1e2189c532fa")}catch(e){}}();
 import { historyEntriesToRaw, reanchorHistoryEntries, } from "../../core/history/replay.js";
 import { canonicalDocument, parseItemDocument, serializeItemDocument, } from "../../core/item/item-format.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -468,7 +468,7 @@ export function mergeItemDocuments(baseRaw, oursRaw, theirsRaw, options = {}) {
         fields_from_theirs: fieldsFromTheirs,
         union_fields: unionFields,
         conflict_decisions: conflictDecisions,
-        preferred,
+        requested_preference: preferred,
         conflict_resolution: conflictResolution,
     };
 }
@@ -625,4 +625,4 @@ export function mergeJsonDocuments(baseRaw, oursRaw, theirsRaw, options = {}) {
     };
 }
 //# sourceMappingURL=three-way.js.map
-//# debugId=f6f04eec-0698-5e5b-a40e-de3a4be89f95
+//# debugId=3c9d6924-ae7c-57c3-a346-1e2189c532fa

package/dist/sdk/output-projection.d.ts

@@ -23,6 +23,8 @@ export interface OutputProjectionDeclaration {
     /** Names of declared groups present in this result. */
     included_field_groups: string[];
 }
+/** Register non-serialized materiality evidence used to keep omission receipts token-proportional. */
+export declare function registerOutputMaterialFieldGroups(result: object, fieldGroups: readonly string[]): void;
 /** Machine-readable location and field-projection support for read-result rows. */
 export interface ReadRowContract {
     /** Canonical read command that owns the result. */
@@ -35,6 +37,8 @@ export interface ReadRowContract {
     fields: "supported" | "unsupported";
     /** Universal jq expression that iterates every declared collection path. */
     jq_selector?: string;
+    /** TOON row encoding selected whenever every row is a flat object with one shared key set. */
+    toon_encoding?: "tabular_when_uniform";
 }
 /** Universal selector for results carrying a {@link ReadRowContract}. */
 export declare const PM_READ_ROW_JQ_SELECTOR = ".row_contract.row_keys[] as $key | getpath($key | split(\".\")) | if type == \"array\" then .[] else if type == \"object\" then to_entries[] else empty end end";
@@ -61,7 +65,7 @@ export declare const PM_READ_ROW_CONTRACTS: {
         readonly fields: "supported";
     };
     readonly activity: {
-        readonly row_keys: readonly ["compact_activity", "provenance_activity", "activity"];
+        readonly row_keys: readonly ["activity_digest", "compact_activity", "provenance_activity", "activity"];
         readonly fields: "unsupported";
     };
     readonly history: {
@@ -131,6 +135,10 @@ export declare const PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS: readonly [{
     readonly command: "activity";
     readonly complete_mode: "full";
     readonly omissions_by_mode: {
+        readonly digest: readonly [{
+            readonly name: "event_rows";
+            readonly restore_with: "--raw";
+        }];
         readonly compact: readonly [{
             readonly name: "provenance";
             readonly restore_with: "--full";

package/dist/sdk/output-projection.js

@@ -4,9 +4,14 @@
  * Declares machine-readable field-group omissions for bounded command results.
  */
 
-!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]="630b48a7-aa38-529c-a272-14b7c748101c")}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]="d059aa19-3822-5ff4-b4be-e2be8f537d1e")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
+const MATERIAL_FIELD_GROUPS_BY_RESULT = new WeakMap();
+/** Register non-serialized materiality evidence used to keep omission receipts token-proportional. */
+export function registerOutputMaterialFieldGroups(result, fieldGroups) {
+    MATERIAL_FIELD_GROUPS_BY_RESULT.set(result, new Set(fieldGroups));
+}
 /** Universal selector for results carrying a {@link ReadRowContract}. */
 export const PM_READ_ROW_JQ_SELECTOR = '.row_contract.row_keys[] as $key | getpath($key | split(".")) | if type == "array" then .[] else if type == "object" then to_entries[] else empty end end';
 /** Static row declarations shared by CLI, SDK, MCP, and package consumers. */
@@ -26,7 +31,12 @@ export const PM_READ_ROW_CONTRACTS = {
     },
     search: { row_keys: ["items"], fields: "supported" },
     activity: {
-        row_keys: ["compact_activity", "provenance_activity", "activity"],
+        row_keys: [
+            "activity_digest",
+            "compact_activity",
+            "provenance_activity",
+            "activity",
+        ],
         fields: "unsupported",
     },
     history: {
@@ -58,6 +68,12 @@ export const PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS = [
         command: "activity",
         complete_mode: "full",
         omissions_by_mode: {
+            digest: [
+                {
+                    name: "event_rows",
+                    restore_with: "--raw",
+                },
+            ],
             compact: [
                 {
                     name: "provenance",
@@ -139,16 +155,23 @@ const CONTEXT_FIELD_GROUPS = [
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+const READ_ROW_TOON_ENCODINGS = new Set([
+    undefined,
+    "tabular_when_uniform",
+]);
+const READ_ROW_KINDS = new Set(["collection", "none"]);
+const READ_ROW_FIELD_MODES = new Set(["supported", "unsupported"]);
 /** Return whether an unknown value is a structurally valid row declaration. */
 export function isReadRowContract(value) {
     return (isRecord(value) &&
         typeof value.command === "string" &&
         value.command.trim().length > 0 &&
-        (value.row_kind === "collection" || value.row_kind === "none") &&
+        READ_ROW_KINDS.has(value.row_kind) &&
         Array.isArray(value.row_keys) &&
         value.row_keys.every((key) => typeof key === "string" && key.length > 0) &&
         new Set(value.row_keys).size === value.row_keys.length &&
-        (value.fields === "supported" || value.fields === "unsupported") &&
+        READ_ROW_FIELD_MODES.has(value.fields) &&
+        READ_ROW_TOON_ENCODINGS.has(value.toon_encoding) &&
         (value.row_kind === "collection"
             ? value.row_keys.length > 0 &&
                 typeof value.jq_selector === "string" &&
@@ -183,7 +206,12 @@ const READ_RESULT_SENTINEL_KEYS = {
         "held_by_others",
     ],
     search: ["items", "projection"],
-    activity: ["compact_activity", "provenance_activity", "activity"],
+    activity: [
+        "activity_digest",
+        "compact_activity",
+        "provenance_activity",
+        "activity",
+    ],
     history: ["compact_history", "provenance_history", "history"],
     deps: ["tree", "graph", "projection"],
     health: ["checks"],
@@ -220,6 +248,7 @@ export function resolveReadRowContract(command, result) {
             ...(activeRowKeys.length > 0
                 ? { jq_selector: PM_READ_ROW_JQ_SELECTOR }
                 : {}),
+            toon_encoding: "tabular_when_uniform",
         };
     }
     const declaration = PM_READ_ROW_CONTRACTS[rootCommand];
@@ -243,6 +272,7 @@ export function resolveReadRowContract(command, result) {
                 ...(rowKeys.length > 0
                     ? { jq_selector: PM_READ_ROW_JQ_SELECTOR }
                     : {}),
+                toon_encoding: "tabular_when_uniform",
             };
         })();
 }
@@ -301,11 +331,17 @@ function resolveGetReceipt(result) {
         "linked",
         "schedule",
     ];
-    const groups = ["body", ...itemGroups, ...resultGroups.slice(1)].map((name) => ({
+    const materialGroups = MATERIAL_FIELD_GROUPS_BY_RESULT.get(result);
+    const ownerFor = (name) => itemGroups.includes(name) || name === "body" ? item : result;
+    const groups = ["body", ...itemGroups, ...resultGroups.slice(1)]
+        .filter((name) => materialGroups === undefined ||
+        materialGroups.has(name) ||
+        Object.hasOwn(ownerFor(name), name))
+        .map((name) => ({
         name,
         restore_with: `--fields ${name}`,
     }));
-    return createOutputOmissionReceipt(groups, new Set(groups.flatMap(({ name }) => !Object.hasOwn(itemGroups.includes(name) ? item : result, name)
+    return createOutputOmissionReceipt(groups, new Set(groups.flatMap(({ name }) => !Object.hasOwn(ownerFor(name), name)
         ? []
         : [name])));
 }
@@ -361,6 +397,7 @@ export function attachOutputOmissionReceipt(command, result) {
     if (command === undefined || !isRecord(result)) {
         return result;
     }
+    const receipt = resolveOutputOmissionReceipt(command, result);
     const declaredRowContract = result.row_contract;
     const rowContract = isReadRowContract(declaredRowContract)
         ? declaredRowContract
@@ -372,10 +409,9 @@ export function attachOutputOmissionReceipt(command, result) {
             : result;
     if (isRecord(disclosedResult.omission_receipt))
         return disclosedResult;
-    const receipt = resolveOutputOmissionReceipt(command, disclosedResult);
     return receipt === undefined
         ? disclosedResult
         : { ...disclosedResult, omission_receipt: receipt };
 }
 //# sourceMappingURL=output-projection.js.map
-//# debugId=630b48a7-aa38-529c-a272-14b7c748101c
+//# debugId=d059aa19-3822-5ff4-b4be-e2be8f537d1e

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

@@ -18,6 +18,8 @@ export interface ActivityCommandOptions {
     limit?: string;
     /** Value that configures or reports compact for this contract. */
     compact?: boolean;
+    /** Return the legacy per-event stream instead of the item-centric digest. */
+    raw?: boolean;
     /** Explicitly disables the default activity bound. */
     unbounded?: boolean;
     /** Return patch-free provenance rows. */
@@ -31,6 +33,10 @@ export interface ActivityCommandOptions {
     /** Exact provenance dimension predicates (`dimension=value`). */
     provenanceFilter?: string | readonly string[];
 }
+/** Normalize raw and full aliases into one explicit activity row projection. */
+export declare function normalizeActivityProjectionOptions(options: ActivityCommandOptions & {
+    full?: unknown;
+}): ActivityCommandOptions;
 /** Documents the activity entry payload exchanged by command, SDK, and package integrations. */
 export interface ActivityEntry extends HistoryEntry {
     /** Stable identifier used to reference this record across commands and storage. */
@@ -49,8 +55,29 @@ export interface CompactActivityEntry {
     /** Value that configures or reports msg for this contract. */
     msg?: string;
 }
+/** One item-centric summary of every matching immutable event for that item. */
+export interface ActivityDigestEntry {
+    /** Stable item identifier. */
+    id: string;
+    /** Current item type from the light metadata join. */
+    type: string;
+    /** Current lifecycle status from the light metadata join. */
+    status: string;
+    /** Current item title, bounded for predictable context cost. */
+    title: string;
+    /** Matching immutable events folded into this row. */
+    event_count: number;
+    /** Oldest matching event timestamp. */
+    first_ts: string;
+    /** Newest matching event timestamp. */
+    last_ts: string;
+    /** Bounded operation histogram encoded as comma-separated op:count pairs. */
+    operations: string;
+}
 /** Documents the activity result payload exchanged by command, SDK, and package integrations. */
 export interface ActivityResult {
+    /** Default item-centric workspace activity rows. */
+    activity_digest?: ActivityDigestEntry[];
     /** Value that configures or reports activity for this contract. */
     activity?: ActivityEntry[];
     /** Value that configures or reports compact activity for this contract. */
@@ -62,9 +89,9 @@ export interface ActivityResult {
     /** Explicit active row projection. */
     projection: {
         /** Stable projection mode. */
-        mode: "compact" | "provenance" | "full";
+        mode: "digest" | "compact" | "provenance" | "full";
         /** Active row collection key. */
-        row_key: "compact_activity" | "provenance_activity" | "activity";
+        row_key: "activity_digest" | "compact_activity" | "provenance_activity" | "activity";
     };
     /** Constant-size disclosure of field groups withheld by the active mode. */
     omission_receipt: OutputOmissionReceipt;
@@ -84,9 +111,25 @@ export interface ActivityResult {
         source: "default" | "explicit";
         value: number | null;
     };
+    /** Constant-size description of the selected time window and matching corpus. */
+    activity_summary?: {
+        window: {
+            from: string | null;
+            to: string | null;
+        };
+        event_count: number;
+        item_count: number;
+        author_count: number;
+        operation_counts: Record<string, number>;
+    };
     /** Constant-size provenance completeness metrics. */
     provenance_summary?: HistoryProvenanceSummary;
 }
+interface ActivityItemMetadata {
+    title: string;
+    type: string;
+    status: string;
+}
 declare function parseNonEmptyFilter(raw: string | undefined, flagLabel: string): string | undefined;
 declare function parseRangeBound(raw: string | undefined, nowValue: string, fieldLabel: string): string | undefined;
 declare function includeByTimeWindow(entry: ActivityEntry, from: string | undefined, to: string | undefined): boolean;
@@ -95,6 +138,8 @@ declare function readActivityString(value: unknown, fallback?: string): string;
 declare function normalizeActivityEntry(id: string, entry: HistoryEntry): ActivityEntry;
 declare function sortActivity(entries: ActivityEntry[]): ActivityEntry[];
 declare function listHistoryFiles(historyDir: string): Promise<string[]>;
+declare function buildActivityDigest(activity: readonly ActivityEntry[], itemsById: ReadonlyMap<string, ActivityItemMetadata>): ActivityDigestEntry[];
+declare function activityOperationCounts(activity: readonly Pick<ActivityEntry, "op">[]): Record<string, number>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
     parseNonEmptyFilter: typeof parseNonEmptyFilter;
@@ -105,6 +150,8 @@ export declare const _testOnly: {
     normalizeActivityEntry: typeof normalizeActivityEntry;
     sortActivity: typeof sortActivity;
     listHistoryFiles: typeof listHistoryFiles;
+    buildActivityDigest: typeof buildActivityDigest;
+    activityOperationCounts: typeof activityOperationCounts;
 };
 /** Implements run activity for the public runtime surface of this module. */
 export declare function runActivity(options: ActivityCommandOptions, global: GlobalOptions): Promise<ActivityResult>;

package/dist/sdk/query/activity.js

@@ -4,7 +4,8 @@
  * 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]="49304d18-d722-5413-8e4d-4f2c3df4a1ca")}catch(e){}}();
+import { isFileMissingError } from "../../core/fs/fs-utils.js";
 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 +15,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;
@@ -86,16 +108,42 @@ async function listHistoryFiles(historyDir) {
     }
     catch (error) {
         // Activity should degrade gracefully when optional history storage is absent.
-        if (error.code === "ENOENT") {
+        if (isFileMissingError(error)) {
             return [];
         }
         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 +157,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 +190,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 +235,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 +344,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 +360,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 +400,4 @@ export async function runActivity(options, global) {
     };
 }
 //# sourceMappingURL=activity.js.map
-//# debugId=a7efa5e0-5610-51ca-8288-4f5410dbcf51
+//# debugId=49304d18-d722-5413-8e4d-4f2c3df4a1ca