@unbrained/pm-cli 2026.8.8 → 2026.8.10

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]="c4721ede-e557-5720-a9c2-4b2b344cc6cc")}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]="59863597-bf57-5d96-9cba-983443e5b209")}catch(e){}}();
 import { execFile } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { readdir, readFile } from "node:fs/promises";
@@ -19,13 +19,33 @@ import { nowIso } from "../../core/shared/time.js";
 const execFileAsync = promisify(execFile);
 async function resolveReceiptDirectory(cwd) {
     try {
-        const { stdout } = await execFileAsync("git", ["rev-parse", "--path-format=absolute", "--git-path", "pm-merge-receipts"], { cwd, encoding: "utf8", windowsHide: true, timeout: 10_000 });
+        const { stdout } = await execFileAsync("git", [
+            "rev-parse",
+            "--path-format=absolute",
+            "--git-path",
+            "pm-merge-receipts",
+        ], { cwd, encoding: "utf8", windowsHide: true, timeout: 10_000 });
         return stdout.trim();
     }
     catch {
         return null;
     }
 }
+async function resolveTrackerRootFromItemPath(cwd, itemPath) {
+    let directory = path.dirname(path.resolve(cwd, itemPath));
+    for (let depth = 0; depth < 12; depth += 1) {
+        if (await pathExists(path.join(directory, "settings.json")))
+            return directory;
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            break;
+        directory = parent;
+    }
+    return null;
+}
+function durableReceiptDirectory(pmRoot) {
+    return path.join(pmRoot, "merge-receipts");
+}
 function receiptFileName(id) {
     return `${id}.json`;
 }
@@ -39,13 +59,28 @@ export function summarizeMergeReceipt(receipt) {
         fields_from_theirs: receipt.fields_from_theirs,
         union_fields: receipt.union_fields,
         preferred: receipt.preferred,
+        conflict_resolution: receipt.conflict_resolution,
         decisions: receipt.decisions.map((decision) => ({
             field: decision.field,
-            retained_hash: sha256Hex(stableStringify(decision.retained)),
-            discarded_hash: sha256Hex(stableStringify(decision.discarded)),
+            retained_hash: isPrehashedValue(decision.retained) ??
+                sha256Hex(stableStringify(decision.retained)),
+            discarded_hash: isPrehashedValue(decision.discarded) ??
+                sha256Hex(stableStringify(decision.discarded)),
         })),
     };
 }
+function isPrehashedValue(value) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value) ||
+        !("pm_value_hash" in value)) {
+        return undefined;
+    }
+    const hash = value.pm_value_hash;
+    return typeof hash === "string" && /^[a-f0-9]{64}$/u.test(hash)
+        ? hash
+        : undefined;
+}
 /** Persist one item-driver outcome in the clone-local Git directory. */
 export async function writeMergeReceipt(params) {
     const directory = await resolveReceiptDirectory(params.cwd);
@@ -65,23 +100,40 @@ export async function writeMergeReceipt(params) {
         item_path: itemPath.replaceAll("\\", "/"),
         item_id: itemId,
         preferred: params.preferred,
+        conflict_resolution: params.conflictResolution ?? "preferred_side",
         fields_from_theirs: [...params.fieldsFromTheirs],
         union_fields: [...params.unionFields],
         decisions: structuredClone(params.decisions),
         state: "pending",
         created_at: nowIso(),
+        value_availability: "clone_local",
     };
     await ensureDir(directory);
     await writeFileAtomic(path.join(directory, receiptFileName(receipt.id)), `${JSON.stringify(receipt, null, 2)}\n`);
+    const trackerRoot = await resolveTrackerRootFromItemPath(params.cwd, receipt.item_path);
+    if (trackerRoot !== null) {
+        const durableDirectory = durableReceiptDirectory(trackerRoot);
+        const summary = summarizeMergeReceipt(receipt);
+        const durableReceipt = {
+            ...receipt,
+            decisions: summary.decisions.map((decision) => ({
+                field: decision.field,
+                base: null,
+                ours: null,
+                theirs: null,
+                retained: { pm_value_hash: decision.retained_hash },
+                discarded: { pm_value_hash: decision.discarded_hash },
+            })),
+            value_availability: "hash_only",
+        };
+        await ensureDir(durableDirectory);
+        await writeFileAtomic(path.join(durableDirectory, receiptFileName(receipt.id)), `${JSON.stringify(durableReceipt, null, 2)}\n`);
+    }
     return receipt;
 }
-/** Read all clone-local receipts, optionally including reconciled history. */
-export async function listMergeReceipts(cwd, options = {}) {
-    const directory = await resolveReceiptDirectory(cwd);
-    if (directory === null || !(await pathExists(directory))) {
+async function readReceiptsFromDirectory(directory, options) {
+    if (!(await pathExists(directory)))
         return [];
-    }
-    const receipts = [];
     let names;
     try {
         names = await readdir(directory);
@@ -89,23 +141,52 @@ export async function listMergeReceipts(cwd, options = {}) {
     catch {
         return [];
     }
+    const receipts = [];
     for (const name of names.sort((left, right) => left.localeCompare(right))) {
-        if (!name.endsWith(".json")) {
+        if (!name.endsWith(".json"))
             continue;
-        }
         try {
             const parsed = JSON.parse(await readFile(path.join(directory, name), "utf8"));
-            if (parsed.version === 1 &&
-                (options.includeReconciled || parsed.state === "pending")) {
-                receipts.push(parsed);
+            const normalizedReceipt = {
+                ...parsed,
+                conflict_resolution: parsed.conflict_resolution ?? "preferred_side",
+            };
+            if (normalizedReceipt.version === 1 &&
+                (options.includeReconciled || normalizedReceipt.state === "pending") &&
+                (options.includeLossless !== false ||
+                    normalizedReceipt.decisions.length > 0)) {
+                receipts.push(normalizedReceipt);
             }
         }
         catch {
-            // A damaged clone-local receipt is reported by merge report through the
-            // omitted count once a future schema version adds richer diagnostics.
+            // Malformed evidence remains an integrity concern for a future schema.
         }
     }
-    return receipts.sort((left, right) => left.created_at.localeCompare(right.created_at));
+    return receipts;
+}
+/** Read clone-local receipts with explicit reconciled/lossless classification controls. */
+export async function listMergeReceipts(cwd, options = {}) {
+    const directory = await resolveReceiptDirectory(cwd);
+    const local = directory === null
+        ? []
+        : await readReceiptsFromDirectory(directory, options);
+    const trackerRoot = options.pmRoot ?? path.join(cwd, ".agents", "pm");
+    const durable = await readReceiptsFromDirectory(durableReceiptDirectory(trackerRoot), options);
+    const receipts = new Map(durable.map((receipt) => [receipt.id, receipt]));
+    for (const receipt of local)
+        receipts.set(receipt.id, receipt);
+    return [...receipts.values()].sort((left, right) => left.created_at.localeCompare(right.created_at));
+}
+/** Split merge provenance into receipts with discarded values and receipts whose composition was lossless. */
+export function partitionMergeReceipts(receipts) {
+    const pendingDecisions = [];
+    const lossless = [];
+    for (const receipt of receipts) {
+        (Array.isArray(receipt.decisions) && receipt.decisions.length > 0
+            ? pendingDecisions
+            : lossless).push(receipt);
+    }
+    return { pendingDecisions, lossless };
 }
 /** Mark a receipt as represented by a committed merge history event. */
 export async function markMergeReceiptReconciled(cwd, receipt) {
@@ -114,10 +195,21 @@ export async function markMergeReceiptReconciled(cwd, receipt) {
         return;
     }
     await writeFileAtomic(path.join(directory, receiptFileName(receipt.id)), `${JSON.stringify({ ...receipt, state: "reconciled", reconciled_at: nowIso() }, null, 2)}\n`);
+    const trackerRoot = await resolveTrackerRootFromItemPath(cwd, receipt.item_path);
+    if (trackerRoot !== null) {
+        const durablePath = path.join(durableReceiptDirectory(trackerRoot), receiptFileName(receipt.id));
+        if (await pathExists(durablePath)) {
+            const durable = JSON.parse(await readFile(durablePath, "utf8"));
+            await writeFileAtomic(durablePath, `${JSON.stringify({ ...durable, state: "reconciled", reconciled_at: nowIso() }, null, 2)}\n`);
+        }
+    }
 }
 /** Report pending or historical clone-local merge decisions. */
 export async function runMergeReceiptReport(options) {
-    const receipts = await listMergeReceipts(options.cwd ?? process.cwd(), options);
+    const receipts = await listMergeReceipts(options.cwd ?? process.cwd(), {
+        ...options,
+        includeLossless: true,
+    });
     return {
         ok: true,
         count: receipts.length,
@@ -126,4 +218,4 @@ export async function runMergeReceiptReport(options) {
     };
 }
 //# sourceMappingURL=receipts.js.map
-//# debugId=c4721ede-e557-5720-a9c2-4b2b344cc6cc
+//# debugId=59863597-bf57-5d96-9cba-983443e5b209

package/dist/sdk/merge/reconcile.js

@@ -1,8 +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]="b2f34565-7664-5612-815d-949b8b1d4f90")}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]="c5620467-6c8c-5702-b742-57fba9e302c5")}catch(e){}}();
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
 import { runHistoryRepair, runHistoryRepairAll, } from "../history-repair.js";
 import { runValidate } from "../governance/validate.js";
-import { listMergeReceipts, markMergeReceiptReconciled, summarizeMergeReceipt, } from "./receipts.js";
+import { listMergeReceipts, markMergeReceiptReconciled, partitionMergeReceipts, summarizeMergeReceipt, } from "./receipts.js";
 /**
  * Preview or apply post-merge history reconciliation and immediately validate
  * the two merge-critical invariants. The default remains explicit and safe:
@@ -11,7 +13,22 @@ import { listMergeReceipts, markMergeReceiptReconciled, summarizeMergeReceipt, }
  */
 export async function runMergeReconcile(options, global) {
     const dryRun = options.dryRun === true;
-    const pendingReceipts = await listMergeReceipts(process.cwd());
+    const pendingReceipts = await listMergeReceipts(process.cwd(), {
+        includeLossless: true,
+    });
+    const { pendingDecisions: discardedReceipts } = partitionMergeReceipts(pendingReceipts);
+    if (!dryRun && options.force !== true && discardedReceipts.length > 0) {
+        throw new PmCliError(`Merge reconciliation would accept ${discardedReceipts.length} receipt(s) containing discarded scalar values. Review pm merge report and rerun with --force only after deciding which values to retain or re-apply.`, EXIT_CODE.CONFLICT, {
+            code: "merge_reconcile_discards_require_acceptance",
+            required: "Explicitly review every discarded field before accepting reconciliation.",
+            nextSteps: discardedReceipts.map((receipt) => `Review receipt ${receipt.id} for ${receipt.item_id}: ${receipt.decisions
+                .map((decision) => decision.field)
+                .join(", ")}.`),
+            recovery: {
+                suggested_retry: "pm merge reconcile --dry-run",
+            },
+        });
+    }
     const receiptsByItem = pendingReceipts.reduce((groups, receipt) => {
         (groups[receipt.item_id] ??= []).push(receipt);
         return groups;
@@ -106,4 +123,4 @@ export async function runMergeReconcile(options, global) {
     };
 }
 //# sourceMappingURL=reconcile.js.map
-//# debugId=b2f34565-7664-5612-815d-949b8b1d4f90
+//# debugId=c5620467-6c8c-5702-b742-57fba9e302c5

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

@@ -100,6 +100,8 @@ export interface ItemDocumentMergeResult {
     conflict_decisions: ItemMergeConflictDecision[];
     /** Which side unresolvable conflicts were resolved toward. */
     preferred: MergePreferredSide;
+    /** Scalar-conflict selection contract used for this merge. */
+    conflict_resolution: "preferred_side" | "stable_value_order";
 }
 /**
  * Field-aware three-way merge of one tracker item document. Commutative
@@ -107,8 +109,8 @@ export interface ItemDocumentMergeResult {
  * concurrent appends never conflict; `updated_at` resolves to the latest
  * timestamp so disjoint-field edits never collide on the shared freshness
  * scalar; every other metadata field and the body use classic three-way
- * resolution. Unresolvable both-sides-changed conflicts are resolved toward
- * the preferred side but reported in `conflict_fields`, and the merged output
+ * resolution. Unresolvable both-sides-changed conflicts use the configured
+ * scalar policy but remain reported in `conflict_fields`, and the merged output
  * is always canonically serialized — count-prefixed TOON array headers are
  * recomputed, so the hand-resolution corruption class (stale `notes[N]`
  * headers) cannot be produced by this merge.
@@ -116,6 +118,8 @@ export interface ItemDocumentMergeResult {
 export declare function mergeItemDocuments(baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & {
     /** Side that wins unresolvable conflicts (default "ours"). */
     preferred?: MergePreferredSide;
+    /** Direction-independent scalar selection used by the Git driver. */
+    conflictResolution?: "preferred_side" | "stable_value_order";
 }): ItemDocumentMergeResult;
 /** Documents the JSON document merge result payload exchanged by command, SDK, and package integrations. */
 export interface JsonDocumentMergeResult {

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]="582576df-8dbe-5f93-890b-5d872669dfe8")}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]="f6f04eec-0698-5e5b-a40e-de3a4be89f95")}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";
@@ -339,6 +339,18 @@ function mergeScalarThreeWay(base, ours, theirs, preferred) {
         conflict: true,
     };
 }
+function mergeItemScalarThreeWay(base, ours, theirs, preferred, conflictResolution) {
+    const outcome = mergeScalarThreeWay(base, ours, theirs, preferred);
+    if (!outcome.conflict || conflictResolution === "preferred_side") {
+        return outcome;
+    }
+    const retainTheirs = stableStringify(theirs).localeCompare(stableStringify(ours)) < 0;
+    return {
+        value: retainTheirs ? theirs : ours,
+        from_theirs: retainTheirs,
+        conflict: true,
+    };
+}
 function toMetadataRecord(document) {
     return { ...document.metadata };
 }
@@ -350,7 +362,7 @@ function parseItemMergeSide(raw, label, options) {
         throw new PmCliError(`Item merge input (${label}) is not a readable item document: ${String(error)}`, EXIT_CODE.GENERIC_FAILURE);
     }
 }
-function mergeItemMetadataRecords(baseRecord, oursRecord, theirsRecord, preferred) {
+function mergeItemMetadataRecords(baseRecord, oursRecord, theirsRecord, preferred, conflictResolution) {
     const unionFieldSet = new Set(ITEM_UNION_COLLECTION_FIELDS);
     const latestFieldSet = new Set(ITEM_LATEST_TIMESTAMP_FIELDS);
     const fieldNames = [
@@ -382,7 +394,7 @@ function mergeItemMetadataRecords(baseRecord, oursRecord, theirsRecord, preferre
             accumulator.merged[field] = latestTimestamp(oursValue, theirsValue);
             continue;
         }
-        const outcome = mergeScalarThreeWay(baseValue, oursValue, theirsValue, preferred);
+        const outcome = mergeItemScalarThreeWay(baseValue, oursValue, theirsValue, preferred, conflictResolution);
         if (outcome.value !== undefined) {
             accumulator.merged[field] = outcome.value;
         }
@@ -394,7 +406,7 @@ function mergeItemMetadataRecords(baseRecord, oursRecord, theirsRecord, preferre
                 ours: oursValue,
                 theirs: theirsValue,
                 retained: outcome.value,
-                discarded: preferred === "theirs" ? oursValue : theirsValue,
+                discarded: outcome.from_theirs ? oursValue : theirsValue,
             });
         }
         else if (outcome.from_theirs) {
@@ -409,14 +421,15 @@ function mergeItemMetadataRecords(baseRecord, oursRecord, theirsRecord, preferre
  * concurrent appends never conflict; `updated_at` resolves to the latest
  * timestamp so disjoint-field edits never collide on the shared freshness
  * scalar; every other metadata field and the body use classic three-way
- * resolution. Unresolvable both-sides-changed conflicts are resolved toward
- * the preferred side but reported in `conflict_fields`, and the merged output
+ * resolution. Unresolvable both-sides-changed conflicts use the configured
+ * scalar policy but remain reported in `conflict_fields`, and the merged output
  * is always canonically serialized — count-prefixed TOON array headers are
  * recomputed, so the hand-resolution corruption class (stale `notes[N]`
  * headers) cannot be produced by this merge.
  */
 export function mergeItemDocuments(baseRaw, oursRaw, theirsRaw, options = {}) {
     const preferred = options.preferred ?? "ours";
+    const conflictResolution = options.conflictResolution ?? "preferred_side";
     // An empty base means both branches created the file independently
     // (add/add); three-way falls back to treating every differing field as an
     // ours/theirs decision, which the scalar resolver already models.
@@ -429,8 +442,8 @@ export function mergeItemDocuments(baseRaw, oursRaw, theirsRaw, options = {}) {
         : {};
     const oursRecord = toMetadataRecord(ours);
     const theirsRecord = toMetadataRecord(theirs);
-    const { merged, conflictFields, fieldsFromTheirs, unionFields, conflictDecisions, } = mergeItemMetadataRecords(baseRecord, oursRecord, theirsRecord, preferred);
-    const bodyOutcome = mergeScalarThreeWay(hasBase ? base.body : "", ours.body, theirs.body, preferred);
+    const { merged, conflictFields, fieldsFromTheirs, unionFields, conflictDecisions, } = mergeItemMetadataRecords(baseRecord, oursRecord, theirsRecord, preferred, conflictResolution);
+    const bodyOutcome = mergeItemScalarThreeWay(hasBase ? base.body : "", ours.body, theirs.body, preferred, conflictResolution);
     if (bodyOutcome.conflict) {
         conflictFields.push("body");
         conflictDecisions.push({
@@ -439,7 +452,7 @@ export function mergeItemDocuments(baseRaw, oursRaw, theirsRaw, options = {}) {
             ours: ours.body,
             theirs: theirs.body,
             retained: bodyOutcome.value,
-            discarded: preferred === "theirs" ? ours.body : theirs.body,
+            discarded: bodyOutcome.from_theirs ? ours.body : theirs.body,
         });
     }
     else if (bodyOutcome.from_theirs) {
@@ -456,6 +469,7 @@ export function mergeItemDocuments(baseRaw, oursRaw, theirsRaw, options = {}) {
         union_fields: unionFields,
         conflict_decisions: conflictDecisions,
         preferred,
+        conflict_resolution: conflictResolution,
     };
 }
 function isPlainObject(value) {
@@ -611,4 +625,4 @@ export function mergeJsonDocuments(baseRaw, oursRaw, theirsRaw, options = {}) {
     };
 }
 //# sourceMappingURL=three-way.js.map
-//# debugId=582576df-8dbe-5f93-890b-5d872669dfe8
+//# debugId=f6f04eec-0698-5e5b-a40e-de3a4be89f95

package/dist/sdk/output-projection.js

@@ -4,7 +4,7 @@
  * 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]="4a108e0e-0dfc-55c4-9f14-7395cfbac456")}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]="630b48a7-aa38-529c-a272-14b7c748101c")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 /** Universal selector for results carrying a {@link ReadRowContract}. */
@@ -283,11 +283,31 @@ function resolveContextReceipt(result) {
 function resolveGetReceipt(result) {
     if (!isRecord(result.item))
         return undefined;
-    const groups = ["children", "claim_state", "linked"].map((name) => ({
+    const item = result.item;
+    const itemGroups = [
+        "comments",
+        "notes",
+        "learnings",
+        "files",
+        "tests",
+        "docs",
+        "reminders",
+        "events",
+    ];
+    const resultGroups = [
+        "body",
+        "children",
+        "claim_state",
+        "linked",
+        "schedule",
+    ];
+    const groups = ["body", ...itemGroups, ...resultGroups.slice(1)].map((name) => ({
         name,
         restore_with: `--fields ${name}`,
     }));
-    return createOutputOmissionReceipt(groups, new Set(groups.flatMap(({ name }) => (result[name] === undefined ? [] : [name]))));
+    return createOutputOmissionReceipt(groups, new Set(groups.flatMap(({ name }) => !Object.hasOwn(itemGroups.includes(name) ? item : result, name)
+        ? []
+        : [name])));
 }
 function resolveListOrSearchReceipt(result) {
     if (!isRecord(result.projection))
@@ -358,4 +378,4 @@ export function attachOutputOmissionReceipt(command, result) {
         : { ...disclosedResult, omission_receipt: receipt };
 }
 //# sourceMappingURL=output-projection.js.map
-//# debugId=4a108e0e-0dfc-55c4-9f14-7395cfbac456
+//# debugId=630b48a7-aa38-529c-a272-14b7c748101c

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

@@ -362,6 +362,8 @@ export interface ContextResult {
     focus_fields?: string[];
     /** Value that configures or reports warnings for this contract. */
     warnings?: string[];
+    /** Actionable recovery contracts for context signal-store warnings. */
+    warning_details?: ContextSignalStoreReadResult["warning_details"];
     /** Value that configures or reports ranking for this contract. */
     ranking?: ContextRankingSummary;
     /** Token-budget selection and projection accounting for ranked focus rows. */

package/dist/sdk/query/context.js

@@ -4,7 +4,7 @@
  * Implements the pm context 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]="dbcd4e0e-3fa0-5ce9-8bbc-6de05779d729")}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]="161507f0-b1a7-59a6-9a60-d8f09806ed3f")}catch(e){}}();
 import { SETTINGS_DEFAULTS, EXIT_CODE, PmCliError, compareTimestampStrings, nowIso, isTerminalStatus, normalizeStatusForRegistry, normalizeStatusInput, resolveRuntimeStatusRegistry, resolvePmRoot, readSettings, resolveAuthor, discoverExtensions, } from "../runtime-primitives.js";
 import { collectDependencyBlockedIds, resolveItemBlockers, } from "../actionability.js";
 import { CONTEXT_DEPTH_VALUES, CONTEXT_SECTION_VALUES, } from "../../types/index.js";
@@ -1412,7 +1412,7 @@ function buildContextSummaryExtras(needsAllItems, allItems, statusRegistry) {
             canceledStatus).length,
     };
 }
-function attachOptionalContextSections(result, sections) {
+function attachOptionalContextSections(result, sections, warningDetails) {
     if (sections.hierarchy)
         result.hierarchy = sections.hierarchy;
     if (sections.activity)
@@ -1433,6 +1433,9 @@ function attachOptionalContextSections(result, sections) {
         result.staleness = sections.staleness;
     if (sections.tests)
         result.tests = sections.tests;
+    if (warningDetails !== undefined && warningDetails.length > 0) {
+        result.warning_details = warningDetails;
+    }
 }
 function applyContextFocusProjection(result, focusFields) {
     if (!focusFields) {
@@ -1642,7 +1645,7 @@ export async function runContext(options, global) {
     };
     result.workspace_memory = selectWorkspaceMemory(workspaceMemory, Math.min(800, Math.floor(runtime.tokenBudget * 0.2)));
     Object.assign(result, await extensionHealthPromise);
-    attachOptionalContextSections(result, sections);
+    attachOptionalContextSections(result, sections, focusGroups.featureStore.warning_details);
     applyContextTagProjection(result, options.noTags === true);
     if (options.explainRanking === true) {
         result.ranking = toContextRankingSummary(focusGroups.ranking, focusGroups.featureStore);
@@ -1656,4 +1659,4 @@ export async function runContext(options, global) {
     return result;
 }
 //# sourceMappingURL=context.js.map
-//# debugId=dbcd4e0e-3fa0-5ce9-8bbc-6de05779d729
+//# debugId=161507f0-b1a7-59a6-9a60-d8f09806ed3f

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

@@ -24,6 +24,17 @@ type GetItemProjection = Partial<ItemMetadata> & {
     notes_count?: number;
     /** Number of linked tests omitted by a token-bounded projection. */
     tests_count?: number;
+    /** Stable cardinalities for every collection mutation surface. */
+    collection_counts?: Readonly<{
+        comments: number;
+        notes: number;
+        learnings: number;
+        files: number;
+        tests: number;
+        docs: number;
+        reminders: number;
+        events: number;
+    }>;
 };
 /** Documents the get result payload exchanged by command, SDK, and package integrations. */
 export interface GetResult {

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]="5536c6eb-5d51-5b67-879d-c1d0bfa5b692")}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]="f68f4074-51ba-5065-8cca-fe16acd48927")}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";
@@ -21,6 +21,23 @@ const AUTOMATIC_CHILD_ROLLUP_TYPES = new Set([
     "plan",
 ]);
 const BUILTIN_ITEM_TYPES = new Set(Object.keys(TYPE_TO_FOLDER).map((type) => type.toLowerCase()));
+function itemCollectionCounts(item) {
+    const lengths = Object.fromEntries([
+        "comments",
+        "notes",
+        "learnings",
+        "files",
+        "tests",
+        "docs",
+        "reminders",
+        "events",
+    ].map((key) => [
+        key,
+        item[key]
+            ?.length ?? 0,
+    ]));
+    return lengths;
+}
 /** Decide whether a normal read should pay for a workspace-wide child projection. */
 function shouldAutoIncludeGetChildren(itemType) {
     const normalizedType = itemType.trim().toLowerCase();
@@ -65,14 +82,29 @@ function parseGetDepth(raw) {
     throw new PmCliError("Get --depth must be one of brief|standard|deep|full", EXIT_CODE.USAGE);
 }
 function projectItemForDepth(item, depth) {
+    const collectionCounts = itemCollectionCounts(item);
     if (depth === "deep") {
-        return item;
+        return {
+            ...item,
+            comments: item.comments ?? [],
+            notes: item.notes ?? [],
+            learnings: item.learnings ?? [],
+            files: item.files ?? [],
+            tests: item.tests ?? [],
+            docs: item.docs ?? [],
+            reminders: item.reminders ?? [],
+            events: item.events ?? [],
+            notes_count: collectionCounts.notes,
+            tests_count: collectionCounts.tests,
+            collection_counts: collectionCounts,
+        };
     }
     const { comments: _comments, notes: _notes, learnings: _learnings, files: _files, tests: _tests, docs: _docs, reminders: _reminders, events: _events, ...projected } = item;
     return {
         ...projected,
         notes_count: item.notes?.length ?? 0,
         tests_count: item.tests?.length ?? 0,
+        collection_counts: collectionCounts,
     };
 }
 function parseGetFields(raw) {
@@ -100,6 +132,7 @@ function validateGetFields(fields, runtimeMetadataKeys) {
         ...runtimeMetadataKeys,
         "notes_count",
         "tests_count",
+        "collection_counts",
     ]);
     const allowedRootFields = new Set([
         "body",
@@ -151,6 +184,7 @@ function projectItemForFields(item, fields) {
     const omittedCounts = {
         notes_count: item.notes?.length ?? 0,
         tests_count: item.tests?.length ?? 0,
+        collection_counts: itemCollectionCounts(item),
     };
     const projected = {};
     for (const field of fields) {
@@ -387,4 +421,4 @@ export const _testOnlyGetCommand = {
     shouldAutoIncludeGetChildren,
 };
 //# sourceMappingURL=get.js.map
-//# debugId=5536c6eb-5d51-5b67-879d-c1d0bfa5b692
+//# debugId=f68f4074-51ba-5065-8cca-fe16acd48927

package/dist/sdk/query/light-metadata.d.ts

@@ -0,0 +1,3 @@
+import type { ItemMetadata } from "../../types/index.js";
+/** Read scalar-only metadata using client workspace defaults and custom type folders. */
+export declare function listClientItemMetadataLight(pmRootOverride: string | undefined, cwdOverride: string | undefined): Promise<ItemMetadata[]>;

package/dist/sdk/query/light-metadata.js

@@ -0,0 +1,19 @@
+/**
+ * @module sdk/query/light-metadata
+ *
+ * Resolves workspace settings for the host-bound lightweight metadata reader.
+ */
+
+!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]="6ede8efb-54ec-5b13-a1bf-216b525acc12")}catch(e){}}();
+import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
+import { listAllItemMetadataLight } from "../../core/store/item-store.js";
+import { resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+/** Read scalar-only metadata using client workspace defaults and custom type folders. */
+export async function listClientItemMetadataLight(pmRootOverride, cwdOverride) {
+    const pmRoot = resolvePmRoot(cwdOverride ?? process.cwd(), pmRootOverride);
+    const settings = await readSettings(pmRoot);
+    return listAllItemMetadataLight(pmRoot, settings.item_format, resolveItemTypeRegistry(settings, null).type_to_folder, undefined, settings.schema);
+}
+//# sourceMappingURL=light-metadata.js.map
+//# debugId=6ede8efb-54ec-5b13-a1bf-216b525acc12

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

@@ -4,7 +4,7 @@ export declare const PM_READ_OUTPUT_DIMENSIONS: readonly ["include", "amount", "
 /** One member of the universal read-output dimension set. */
 export type PmReadOutputDimension = (typeof PM_READ_OUTPUT_DIMENSIONS)[number];
 /** Built-in command roots whose primary operation is a read. */
-export declare const PM_READ_OUTPUT_SURFACES: readonly ["list", "context", "search", "get", "next", "health", "deps", "graph", "history", "activity", "validate", "events", "contracts", "comments", "notes", "files", "docs", "stats", "aggregate"];
+export declare const PM_READ_OUTPUT_SURFACES: readonly ["list", "context", "search", "get", "next", "health", "deps", "graph", "history", "activity", "validate", "events", "contracts", "comments", "notes", "files", "docs", "stats", "aggregate", "package-manage"];
 /** Built-in read command supported by the universal output contract. */
 export type PmReadOutputSurface = (typeof PM_READ_OUTPUT_SURFACES)[number];
 /** Canonical output controls accepted by every built-in read action. */