@unbrained/pm-cli 2026.8.11 → 2026.8.12

package/dist/sdk/merge/driver.js

@@ -9,7 +9,7 @@
  * merge never corrupts tracker storage the way raw conflict markers do.
  */
 
-!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]="e739a603-35c5-5df9-8d4b-3bbc0fe3e4fd")}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]="8d79e3a4-6104-5855-837f-69a041b87b27")}catch(e){}}();
 import { readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
@@ -179,7 +179,7 @@ export async function runMergeDriver(options, global) {
         ok: conflicts.length === 0,
         artifact,
         output_path: outputPath,
-        preferred,
+        requested_preference: preferred,
         conflicts,
         ...result,
         guidance,
@@ -187,4 +187,4 @@ export async function runMergeDriver(options, global) {
     };
 }
 //# sourceMappingURL=driver.js.map
-//# debugId=e739a603-35c5-5df9-8d4b-3bbc0fe3e4fd
+//# debugId=8d79e3a4-6104-5855-837f-69a041b87b27

package/dist/sdk/merge/receipts.d.ts

@@ -9,8 +9,10 @@ export interface MergeDecisionReceipt {
     item_path: string;
     /** Item id derived from the merged document path. */
     item_id: string;
-    /** Preferred side used for scalar conflicts. */
-    preferred: MergePreferredSide;
+    /** Side requested by the caller; stable-value decisions can retain either side. */
+    requested_preference?: MergePreferredSide;
+    /** Legacy schema-v1 key accepted while reading older clone-local receipts. */
+    preferred?: MergePreferredSide;
     /** Scalar-conflict selection contract used by the item driver. */
     conflict_resolution: "preferred_side" | "stable_value_order";
     /** Fields selected cleanly from the other branch. */
@@ -42,8 +44,8 @@ export interface MergeDecisionReceiptSummary {
     fields_from_theirs: string[];
     /** Collections combined from both branches. */
     union_fields: string[];
-    /** Preferred side used for scalar conflicts. */
-    preferred: MergePreferredSide;
+    /** Side requested by the caller; decision hashes prove the actual retained values. */
+    requested_preference: MergePreferredSide;
     /** Scalar-conflict selection contract used by the item driver. */
     conflict_resolution: "preferred_side" | "stable_value_order";
     /** Hashes proving the retained and discarded values without publishing them. */

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>;