@unbrained/pm-cli 2026.8.28 → 2026.8.30

package/dist/sdk/history-repair.js

@@ -4,7 +4,7 @@
  * Implements the pm history repair 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]="7a21ee76-ed53-57a0-9776-c787297ed7b6")}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]="04dbdc08-ad98-543f-96dc-fde635bae92e")}catch(e){}}();
 import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import { realpath } from "node:fs/promises";
 import path from "node:path";
@@ -27,7 +27,7 @@ import { listAllItemMetadataWithBody, readLocatedItem, } from "../core/store/ite
 import { resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { resolveHistorySubject } from "./history-redact.js";
-import { summarizeMergeReceipt, } from "./merge/receipts.js";
+import { inspectMergeReceiptEvidence, summarizeMergeReceipt, } from "./merge/receipts.js";
 import { listInvalidProvenanceHistoryStreamIds, normalizeInvalidHistoryProvenance, } from "./governance/provenance-health.js";
 function replayFieldValue(document, field) {
     return field === "body"
@@ -148,8 +148,6 @@ async function canonicalRealPath(value) {
     }
 }
 async function verifyReceiptAgainstSnapshot(params) {
-    if (params.receipt.evidence_source !== "clone_local")
-        return null;
     const receiptPath = await canonicalRealPath(path.resolve(params.gitWorkspaceRoot, params.receipt.item_path));
     if (receiptPath !== params.currentPath)
         return null;
@@ -159,11 +157,11 @@ async function verifyReceiptAgainstSnapshot(params) {
             ...params.receipt.union_fields,
             ...params.receipt.decisions.map((decision) => decision.field),
         ]),
-    ].sort((left, right) => left.localeCompare(right));
+    ].sort();
     const hashes = params.receipt.merged_field_hashes;
     if (!hashes || declaredFields.length === 0)
         return null;
-    const hashFields = Object.keys(hashes).sort((left, right) => left.localeCompare(right));
+    const hashFields = Object.keys(hashes).sort();
     if (declaredFields.length !== hashFields.length ||
         declaredFields.some((field, index) => field !== hashFields[index])) {
         return null;
@@ -214,7 +212,7 @@ async function verifyMergeReceiptProof(params) {
                 reconciliationFields.every((field) => trustedFields.has(field))))) {
         return {
             trusted: true,
-            reason: "trusted_clone_local_driver_evidence",
+            reason: "trusted_merge_driver_hash_evidence",
             receipt_ids: trustedReceipts.map(({ receipt }) => receipt.id),
         };
     }
@@ -225,7 +223,18 @@ async function verifyMergeReceiptProof(params) {
     };
 }
 async function resolveHistoryRepairMergeEvidence(params) {
-    const subjectMergeReceipts = params.options.mergeReceiptProof?.receipts.filter((receipt) => receipt.item_id === params.subjectId) ?? [];
+    const requestedReceiptIds = new Set(params.options.mergeReceiptProof?.receipts
+        .filter((receipt) => receipt.item_id === params.subjectId)
+        .map((receipt) => receipt.id) ?? []);
+    const authoritativeReceiptEvidence = params.options.mergeReceiptProof
+        ? await inspectMergeReceiptEvidence(params.options.mergeReceiptProof.gitWorkspaceRoot ?? process.cwd(), {
+            includeReconciled: true,
+            includeLossless: true,
+            pmRoot: params.pmRoot,
+        })
+        : undefined;
+    const subjectMergeReceipts = authoritativeReceiptEvidence?.receipts.filter((receipt) => receipt.item_id === params.subjectId &&
+        requestedReceiptIds.has(receipt.id)) ?? [];
     const mergeReceiptProof = params.options.mergeReceiptProof
         ? await verifyMergeReceiptProof({
             proof: {
@@ -244,7 +253,7 @@ async function resolveHistoryRepairMergeEvidence(params) {
         params.options.force !== true) {
         throw new PmCliError(`Merge receipt evidence for ${params.subjectId} does not prove the exact item snapshot (${mergeReceiptProof.reason}).`, EXIT_CODE.CONFLICT, {
             code: "merge_reconcile_receipt_evidence_untrusted",
-            required: "Use clone-local driver evidence whose canonical path, declared fields, and merged-value hashes match the current item, or review the mismatch and rerun with --force.",
+            required: "Use authoritative clone-local or durable receipt evidence whose canonical path, declared fields, and merged-value hashes match the current item, or review the mismatch and rerun with --force.",
             recovery: { suggested_retry: "pm merge reconcile --dry-run" },
         });
     }
@@ -405,6 +414,7 @@ export async function runHistoryRepair(id, options, global) {
         : undefined;
     const { mergeReceiptProof, effectiveAuditContext } = await resolveHistoryRepairMergeEvidence({
         options,
+        pmRoot,
         subjectId: subject.id,
         itemReplayContext,
         reconciliation,
@@ -581,4 +591,4 @@ export async function runHistoryRepairAll(options, global) {
     };
 }
 //# sourceMappingURL=history-repair.js.map
-//# debugId=7a21ee76-ed53-57a0-9776-c787297ed7b6
+//# debugId=04dbdc08-ad98-543f-96dc-fde635bae92e

package/dist/sdk/lifecycle/create.js

@@ -4,9 +4,9 @@
  * Implements the pm create 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]="02c41ea1-8d4e-5239-b95a-a07210b63d7f")}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]="c9bfbfd4-3d34-5fa7-b264-6bf9ed5f7f81")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { resolveMutationStdinTokenFields } from "../../core/item/parse.js";
+import { assertNoAmbiguousBareCommaEntry, looksLikeStructuredKeyValueEntry, resolveMutationStdinTokenFields, } from "../../core/item/parse.js";
 import { removeFileIfExists, writeFileAtomic, appendHistoryEntry, createHistoryEntry, generateItemId, normalizeItemId, canonicalDocument, normalizeItemMetadata, serializeItemDocument, assertParentReferenceIsNotSelf, isPlaceholderReferenceToken, normalizeParentReferenceValue, validateMissingParentReference, validateSprintOrReleaseValue, assertNoUnknownCsvKeys, looksLikeGenericKeyValueEntry, mergeAdditiveTags, parseCsvKv, parseOptionalNonNegativeInteger, parseOptionalNumber, parseTags, shouldResolveMutationStdinTokens, transferMutationStdinTokenPolicy, resolvePriority, getFocusedItem, normalizeStatusInput, isTerminalStatus, canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, acquireLock, printError, buildInvalidTypeError, resolveTypeSynonym, collectRuntimeCreateFieldValues, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, PmCliError, nowIso, resolveIsoOrRelative, getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveCommandHandler, runActiveBeforeMutationHooks, runActiveOnWriteHooks, collectRegisteredItemFieldNames, applyRegisteredItemFieldDefaultsAndValidation, parseRegisteredItemFieldAssignments, listAllItemMetadataLight, locateItem, createMutationGuardSdk, getHistoryPath, getItemPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { requireTerminalReasonWithRecovery } from "../lifecycle-policy.js";
 import { evaluateSimilarityGovernance, similarityAdvisoryWarnings, } from "../similarity.js";
@@ -19,7 +19,7 @@ import { normalizeRiskInput, normalizeSeverityInput, parseConfidenceInput, parse
 import { applyLegacyNoneCollectionNormalizers, createLegacyNoneCollectionNormalizers, assertNoLegacyNoneToken, assertNoLegacyNoneTokens, isLegacyNoneToken, } from "./legacy-none-tokens.js";
 import { suggestNextLifecycleTransition, } from "./lifecycle-transitions.js";
 import { parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, parseLinkedTestWorkspaceContextMode, } from "../test/parsers.js";
-import { looksLikeStructuredLinkedTestEntry, normalizeStructuredLinkedTestEntry, } from "../test/entry.js";
+import { STRUCTURED_LINKED_TEST_KEYS, normalizeStructuredLinkedTestEntry, } from "../test/entry.js";
 import { attachLinkedTestMutationProvenance } from "../test/trust.js";
 import { COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR, COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR, parseCommandUnsetTargets, resolveRuntimeUnsetFieldDefinition, } from "./shared-unset-fields.js";
 import { ensureEnumValue } from "./recurrence-parsers.js";
@@ -202,13 +202,7 @@ function normalizeDependencyKindInput(raw) {
         : raw;
 }
 function looksLikeStructuredEntry(raw, keys) {
-    if (raw.startsWith("```") || raw.includes("\n")) {
-        return true;
-    }
-    const keyPattern = keys
-        .map((key) => key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
-        .join("|");
-    if (new RegExp(`^(?:[-*+]\\s+)?(?:${keyPattern})\\s*[:=]`, "i").test(raw)) {
+    if (looksLikeStructuredKeyValueEntry(raw, keys)) {
         return true;
     }
     // A first-key typo (e.g. `bogus=v,id=pm-2`) must still be parsed so the unknown
@@ -281,6 +275,7 @@ export function parseFiles(raw) {
     const values = raw.map((entry) => {
         const trimmedEntry = entry.trim();
         const isStructured = looksLikeStructuredEntry(trimmedEntry, LINKED_ARTIFACT_SEED_KEYS);
+        assertNoAmbiguousBareCommaEntry(trimmedEntry, "--file", "file path", isStructured);
         const kv = isStructured
             ? parseCsvKv(entry, "--file")
             : { path: trimmedEntry };
@@ -305,7 +300,9 @@ export function parseTests(raw) {
     assertNoLegacyNoneTokens(raw, "--test", "Use --clear-tests to clear linked tests.");
     const values = raw.map((entry) => {
         const trimmedEntry = entry.trim();
-        const kv = looksLikeStructuredLinkedTestEntry(trimmedEntry)
+        const isStructured = looksLikeStructuredEntry(trimmedEntry, STRUCTURED_LINKED_TEST_KEYS);
+        assertNoAmbiguousBareCommaEntry(trimmedEntry, "--test", "test command", isStructured);
+        const kv = isStructured
             ? normalizeStructuredLinkedTestEntry(parseCsvKv(entry, "--test"), "--test")
             : { command: trimmedEntry };
         const command = parseOptionalString(kv.command);
@@ -1331,6 +1328,19 @@ function assertNoCreateFieldUnsetConflicts(registeredItemFieldValues, runtimeCre
     }
 }
 /** Throw the aggregated `missing_required_option` error when a type's required create options and/or required type-option keys were not all supplied in one invocation. Builds a type-aware valid example and staged-onboarding next steps (a strict-mode invocation also carries a compact recovery envelope). A no-op when nothing is missing. */
+/** Truthful empty-collection alternatives for strict required create fields. */
+const CLEAR_FLAG_BY_REQUIRED_CREATE_FLAG = {
+    "--comment": "--clear-comments",
+    "--dep": "--clear-deps",
+    "--doc": "--clear-docs",
+    "--event": "--clear-events",
+    "--file": "--clear-files",
+    "--learning": "--clear-learnings",
+    "--note": "--clear-notes",
+    "--reminder": "--clear-reminders",
+    "--test": "--clear-tests",
+    "--type-option": "--clear-type-options",
+};
 function assertNoMissingRequiredCreateOptions(params) {
     const { combinedMissingFlags, typeDefinition, missingRequiredCreateFlags, missingRequiredTypeOptionKeys, openStatus, type, createMode, missingRequiredRuntimeFields, } = params;
     if (combinedMissingFlags.length === 0) {
@@ -1359,12 +1369,12 @@ function assertNoMissingRequiredCreateOptions(params) {
     ].join(" ");
     const nextSteps = [
         `Run "pm create --help --type ${type}" for type-aware required option guidance.`,
-    ];
-    if (combinedMissingFlags.includes("--title")) {
-        nextSteps.push('Title can also be passed as the first positional argument (example: pm create "Your title" --type ' +
+        ...combinedMissingFlags
+            .filter((flag) => flag === "--title")
+            .map(() => 'Title can also be passed as the first positional argument (example: pm create "Your title" --type ' +
             type +
-            ").");
-    }
+            ")."),
+    ];
     if (createMode === "strict") {
         nextSteps.push('For staged onboarding, retry with "--create-mode progressive".');
         if (SCHEDULE_CREATE_PRESET_TYPES.has(type)) {
@@ -1374,21 +1384,35 @@ function assertNoMissingRequiredCreateOptions(params) {
     if (runtimeFieldSyntax.length > 0) {
         nextSteps.push(`Required custom field formats: ${runtimeFieldSyntax.map((field) => field.description).join("; ")}.`);
     }
+    const collectionClearFlags = [
+        ...new Set(combinedMissingFlags.flatMap((flag) => {
+            const normalizedFlag = flag.split(" ", 1)[0];
+            const clearFlag = CLEAR_FLAG_BY_REQUIRED_CREATE_FLAG[normalizedFlag];
+            return clearFlag ? [clearFlag] : [];
+        })),
+    ];
+    if (collectionClearFlags.length > 0) {
+        nextSteps.push(`If the truthful value is an empty collection, use ${collectionClearFlags.join(", ")} instead of inventing metadata.`);
+    }
     const errorMessage = combinedMissingFlags.length === 1
         ? `Missing required option ${combinedMissingFlags[0]} for type "${type}"`
         : `Missing required options ${combinedMissingFlags.join(", ")} for type "${type}"`;
     throw new PmCliError(errorMessage, EXIT_CODE.USAGE, {
         code: "missing_required_option",
         required: `Provide all required create options and type options for type "${type}" in one invocation.`,
-        examples: [nextValidExample],
+        examples: [
+            ...collectionClearFlags.map((flag) => `pm create --type ${type} ${flag} ...`),
+            nextValidExample,
+        ],
         nextSteps,
         recovery: createMode === "strict"
             ? {
                 recovery_mode: "compact",
                 missing_required_fields: combinedMissingFlags,
                 suggested_flags: [
-                    "--create-mode progressive",
+                    ...collectionClearFlags,
                     ...combinedMissingFlags,
+                    "--create-mode progressive",
                 ],
             }
             : undefined,
@@ -1926,4 +1950,4 @@ export const _testOnlyCreateCommand = {
     typeOptionExampleValue,
 };
 //# sourceMappingURL=create.js.map
-//# debugId=02c41ea1-8d4e-5239-b95a-a07210b63d7f
+//# debugId=c9bfbfd4-3d34-5fa7-b264-6bf9ed5f7f81

package/dist/sdk/linked-artifacts.js

@@ -4,22 +4,21 @@
  * Implements the pm linked artifacts 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]="1832e2b3-0ece-523d-8f38-598303d3f590")}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]="accd0229-6974-5950-8cea-74f517706878")}catch(e){}}();
 import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import fg from "fast-glob";
 import { isFileAbsentError } from "../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
-import { assertNoUnknownCsvKeys, createStdinTokenResolver, looksLikeGenericKeyValueEntry, parseCsvKv, } from "../core/item/parse.js";
+import { assertNoAmbiguousBareCommaEntry, assertNoUnknownCsvKeys, createStdinTokenResolver, looksLikeGenericKeyValueEntry, parseCsvKv, } from "../core/item/parse.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
 import { isRemoteLinkedArtifactReference } from "../core/validate/linked-artifact-reference.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
-import { splitCommaList } from "../core/shared/split-comma-list.js";
 import { stableValueEquals } from "../core/shared/serialization.js";
 import { locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
-import { resolvePmRoot, resolveWorkspaceRoot, } from "../core/store/paths.js";
+import { resolvePmRoot, resolveWorkspaceRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { SCOPE_VALUES } from "../types/index.js";
 import { resolveAuthor } from "../core/shared/author.js";
@@ -63,7 +62,9 @@ export function looksLikeStructuredPathEntry(raw) {
     // leading assignment syntax through the structured-key allowlist so typos
     // and malformed URL-plus-note input remain atomic failures (GH-258,
     // GH-1000).
-    const equalsIndex = raw.indexOf("=");
+    const firstCommaIndex = raw.indexOf(",");
+    const leadingSegment = raw.slice(0, firstCommaIndex >= 0 ? firstCommaIndex : raw.length);
+    const equalsIndex = leadingSegment.indexOf("=");
     if (equalsIndex >= 0 &&
         !/\s/u.test(raw) &&
         (/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(raw) ||
@@ -71,18 +72,7 @@ export function looksLikeStructuredPathEntry(raw) {
             [raw.indexOf("/"), raw.indexOf("\\")].some((separatorIndex) => separatorIndex >= 0 && separatorIndex < equalsIndex))) {
         return false;
     }
-    return raw.includes("=") || looksLikeGenericKeyValueEntry(raw);
-}
-function expandBareCommaSeparatedAddEntries(raw) {
-    return raw.flatMap((entry) => {
-        const trimmed = entry.trim();
-        if (trimmed.length === 0 ||
-            looksLikeStructuredPathEntry(trimmed) ||
-            !trimmed.includes(",")) {
-            return [entry];
-        }
-        return splitCommaList(trimmed);
-    });
+    return leadingSegment.includes("=") || looksLikeGenericKeyValueEntry(raw);
 }
 /** Whether a Markdown destination contains only balanced parentheses. */
 function hasBalancedParentheses(value) {
@@ -136,21 +126,21 @@ export function parseAddEntries(raw, bareNoun) {
             if (reference !== undefined)
                 return [reference];
         }
-        return expandBareCommaSeparatedAddEntries([entry]).map((expanded) => {
-            const expandedTrimmed = expanded.trim();
-            const kv = looksLikeStructuredPathEntry(expandedTrimmed)
-                ? parseCsvKv(expanded, "--add")
-                : { path: expandedTrimmed };
-            assertNoUnknownCsvKeys(kv, "--add", LINKED_ARTIFACT_ADD_KEYS);
-            if (!kv.path) {
-                throw new PmCliError(`--add requires path=<value> or a bare ${bareNoun} path`, EXIT_CODE.USAGE);
-            }
-            return {
+        assertNoAmbiguousBareCommaEntry(trimmed, "--add", `${bareNoun} path`, looksLikeStructuredPathEntry(trimmed));
+        const kv = looksLikeStructuredPathEntry(trimmed)
+            ? parseCsvKv(entry, "--add")
+            : { path: trimmed };
+        assertNoUnknownCsvKeys(kv, "--add", LINKED_ARTIFACT_ADD_KEYS);
+        if (!kv.path) {
+            throw new PmCliError(`--add requires path=<value> or a bare ${bareNoun} path`, EXIT_CODE.USAGE);
+        }
+        return [
+            {
                 path: kv.path,
                 scope: ensureScope(kv.scope),
                 note: kv.note?.trim() || undefined,
-            };
-        });
+            },
+        ];
     });
 }
 /** Implements parse add glob entries for the public runtime surface of this module. */
@@ -439,7 +429,7 @@ async function buildLinkedArtifactResult(params) {
         migrations_applied: params.migrationsApplied && params.migrationsApplied > 0
             ? params.migrationsApplied
             : undefined,
-        validation: params.options.validatePaths
+        validation: params.options.validatePaths || params.changed
             ? await validateLinkedPaths(paths, params.workspaceRoot)
             : undefined,
     };
@@ -538,4 +528,4 @@ export function renameArtifactsResultKey(result, key) {
     return out;
 }
 //# sourceMappingURL=linked-artifacts.js.map
-//# debugId=1832e2b3-0ece-523d-8f38-598303d3f590
+//# debugId=accd0229-6974-5950-8cea-74f517706878

package/dist/sdk/merge/reconcile.js

@@ -1,11 +1,11 @@
 
-!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]="c3ec7d9d-f276-5e97-8e97-507925e5d33a")}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]="8d85d220-dad2-5234-8819-65632275eb47")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { resolvePmRoot } from "../../core/store/paths.js";
 import { runHistoryRepair, runHistoryRepairAll, } from "../history-repair.js";
 import { runValidate } from "../governance/validate.js";
-import { inspectMergeReceiptEvidence, markMergeReceiptReconciled, partitionMergeReceipts, summarizeMergeReceipt, } from "./receipts.js";
+import { inspectMergeReceiptEvidence, markMergeReceiptReconciled, summarizeMergeReceipt, } from "./receipts.js";
 import { findGitWorkspaceRoot } from "./install.js";
 import { mapWithFixedConcurrency } from "../extension/concurrency.js";
 const RECEIPT_ONLY_REPAIR_CONCURRENCY = 4;
@@ -95,19 +95,6 @@ export async function runMergeReconcile(options, global) {
         });
     }
     const pendingReceipts = receiptEvidence.receipts;
-    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 = new Map();
     for (const receipt of pendingReceipts) {
         const receipts = receiptsByItem.get(receipt.item_id) ?? [];
@@ -193,4 +180,4 @@ export async function runMergeReconcile(options, global) {
     };
 }
 //# sourceMappingURL=reconcile.js.map
-//# debugId=c3ec7d9d-f276-5e97-8e97-507925e5d33a
+//# debugId=8d85d220-dad2-5234-8819-65632275eb47

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

@@ -60,6 +60,12 @@ export interface NextBlockerRef {
     title: string | null;
     /** Lifecycle state reported for status. */
     status: ItemStatus | null;
+    /** Whether this reference must be checked outside the local tracker. */
+    external?: boolean;
+    /** Conservative timestamp from which the unresolved external block may be stale. */
+    blocked_since?: string;
+    /** External resolver identity, or null when no integration verified the reference. */
+    resolver?: string | null;
 }
 /**
  * A classified actionable item on the `pm next` output: a {@link ContextFocusItem}

package/dist/sdk/query/next.js

@@ -9,7 +9,7 @@
  * re-deriving readiness from a full `pm context` snapshot every turn.
  */
 
-!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]="3431d4d4-e053-5416-b3d1-6dbfbed0142d")}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]="9b788e0a-f4ac-5c6e-bf52-0ef0519d6925")}catch(e){}}();
 import { collectBlockedByIds, computeActionabilityReport, } from "../actionability.js";
 import { resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, nowIso, normalizeStatusInput, normalizeStatusForRegistry, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { parseIntegerLimit } from "./parsers.js";
@@ -60,6 +60,11 @@ function toNextActionableItem(entry, statusRegistry, childrenByParent, rank) {
             id: blocker.id,
             title: blocker.title,
             status: blocker.status,
+            ...(blocker.external ? { external: true } : {}),
+            ...(blocker.blocked_since
+                ? { blocked_since: blocker.blocked_since }
+                : {}),
+            ...(blocker.external ? { resolver: blocker.resolver ?? null } : {}),
         })),
         unblocks: entry.unblocks,
         rank,
@@ -474,4 +479,4 @@ function formatNextLine(item) {
     return `${rankToken}${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;
 }
 //# sourceMappingURL=next.js.map
-//# debugId=3431d4d4-e053-5416-b3d1-6dbfbed0142d
+//# debugId=9b788e0a-f4ac-5c6e-bf52-0ef0519d6925

package/dist/sdk/test/entry.d.ts

@@ -1,6 +1,6 @@
 /** Public contract for structured linked test keys, shared by SDK and presentation-layer consumers. */
 export declare const STRUCTURED_LINKED_TEST_KEYS: readonly ["command", "cmd", "path", "scope", "timeout", "timeout_seconds", "pm_context_mode", "workspace_context_mode", "env_set", "env_clear", "shared_host_safe", "assert_stdout_contains", "assert_stdout_regex", "assert_stderr_contains", "assert_stderr_regex", "assert_stdout_min_lines", "assert_json_field_equals", "assert_json_field_gte", "note"];
-/** Implements looks like structured linked test entry for the public runtime surface of this module. */
+/** Classify linked-test plaintext through the shared structured-entry grammar. */
 export declare function looksLikeStructuredLinkedTestEntry(raw: string): boolean;
 /** Implements normalize structured linked test entry for the public runtime surface of this module. */
 export declare function normalizeStructuredLinkedTestEntry(kv: Record<string, string>, optionName: "--add" | "--test"): Record<string, string>;

package/dist/sdk/test/entry.js

@@ -4,9 +4,10 @@
  * Implements the pm linked test entry 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]="44e6a87d-0ca5-53af-b199-b66bb2b98fb5")}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]="b29e4416-82ab-585c-9456-718e4699566d")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
+import { looksLikeStructuredKeyValueEntry } from "../../core/item/parse.js";
 // Keys accepted inside a structured linked-test entry. `cmd` is an alias for
 // `command`; everything else maps 1:1 to a LinkedTest field.
 /** Public contract for structured linked test keys, shared by SDK and presentation-layer consumers. */
@@ -32,14 +33,9 @@ export const STRUCTURED_LINKED_TEST_KEYS = [
     "note",
 ];
 const STRUCTURED_LINKED_TEST_KEY_SET = new Set(STRUCTURED_LINKED_TEST_KEYS);
-const STRUCTURED_LINKED_TEST_KEY_PATTERN = STRUCTURED_LINKED_TEST_KEYS.map((key) => key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
-const STRUCTURED_LINKED_TEST_ENTRY_PATTERN = new RegExp(`^(?:[-*+]\\s+)?(?:${STRUCTURED_LINKED_TEST_KEY_PATTERN})\\s*[:=]`, "i");
-/** Implements looks like structured linked test entry for the public runtime surface of this module. */
+/** Classify linked-test plaintext through the shared structured-entry grammar. */
 export function looksLikeStructuredLinkedTestEntry(raw) {
-    if (raw.startsWith("```") || raw.includes("\n")) {
-        return true;
-    }
-    return STRUCTURED_LINKED_TEST_ENTRY_PATTERN.test(raw);
+    return looksLikeStructuredKeyValueEntry(raw, STRUCTURED_LINKED_TEST_KEYS);
 }
 /** Implements normalize structured linked test entry for the public runtime surface of this module. */
 export function normalizeStructuredLinkedTestEntry(kv, optionName) {
@@ -72,4 +68,4 @@ export function normalizeStructuredLinkedTestEntry(kv, optionName) {
     return normalizedKv;
 }
 //# sourceMappingURL=entry.js.map
-//# debugId=44e6a87d-0ca5-53af-b199-b66bb2b98fb5
+//# debugId=b29e4416-82ab-585c-9456-718e4699566d

package/dist/sdk/test/execution.d.ts

@@ -234,6 +234,8 @@ declare function readJsonPathValue(root: unknown, fieldPath: string): {
     value: unknown;
 };
 declare function evaluateLinkedTestAssertions(linkedTest: LinkedTest, stdout: string, stderr: string): string[];
+/** Return whether a linked command applies a runner-level test-name filter that must match at least one test. */
+declare function commandUsesTestNameFilter(command: string): boolean;
 interface RunLinkedTestsOptions {
     progress?: boolean;
     sourceRoots?: LinkedTestSandboxSourceRoots;
@@ -303,6 +305,7 @@ export declare const _testOnlyTestCommand: {
     buildPmContextMismatchHint: typeof buildPmContextMismatchHint;
     commandInvokesPmCli: typeof commandInvokesPmCli;
     commandInvokesPmTrackerReadCommand: typeof commandInvokesPmTrackerReadCommand;
+    commandUsesTestNameFilter: typeof commandUsesTestNameFilter;
     copyIntoSandboxIfPresent: typeof copyIntoSandboxIfPresent;
     countLinkedTestItemFiles: typeof countLinkedTestItemFiles;
     ensureScope: typeof ensureScope;

package/dist/sdk/test/execution.js

@@ -4,7 +4,7 @@
  * Implements the pm test 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]="99ce92bb-ed45-5327-b148-b5bb26a0bf05")}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]="de5bc6bf-fe31-5643-a809-ee9ca52aac48")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
 import { spawn } from "node:child_process";
 import { cp, mkdir, mkdtemp, open, readdir, rm, symlink, } from "node:fs/promises";
@@ -817,9 +817,17 @@ async function runLinkedTestCommand(command, timeoutMs, env, progressContext, pr
         try {
             child = createLinkedTestChild(command, env, stdoutHandle.fd, stderrHandle.fd, cwd);
         }
-        finally {
+        catch (error) {
             await Promise.all([stdoutHandle.close(), stderrHandle.close()]);
+            throw error;
         }
+        const childClose = waitForLinkedTestChildClose(child);
+        let spawnError;
+        /* c8 ignore next 5 -- shell spawn error callbacks are non-deterministic across platforms. */
+        child.on("error", (error) => {
+            spawnError = error.message;
+        });
+        await Promise.all([stdoutHandle.close(), stderrHandle.close()]);
         closeLinkedTestStdin(child);
         const timers = {
             heartbeat: beginLinkedTestProgress(progressContext, progressMode),
@@ -828,18 +836,13 @@ async function runLinkedTestCommand(command, timeoutMs, env, progressContext, pr
         };
         const requestTermination = createLinkedTestTerminationRequester(child, timers);
         let timedOut = false;
-        let spawnError;
-        /* c8 ignore next 5 -- shell spawn error callbacks are non-deterministic across platforms. */
-        child.on("error", (error) => {
-            spawnError = error.message;
-        });
         /* c8 ignore next 4 -- callback scheduling timing is non-deterministic under coverage instrumentation. */
         timers.timedOutTimer = setTimeout(() => {
             timedOut = true;
             void requestTermination();
         }, timeoutMs);
         timers.timedOutTimer.unref?.();
-        const { code, signal } = await waitForLinkedTestChildClose(child);
+        const { code, signal } = await childClose;
         clearLinkedTestTimers(timers);
         const [stdout, stderr] = await Promise.all([
             readLinkedTestCapture(stdoutPath),
@@ -1285,16 +1288,45 @@ const EMPTY_LINKED_TEST_RUN_PATTERNS = [
     { code: "no_tests_found", regex: /\bNo tests found\b/i },
     { code: "no_matching_tests", regex: /\bNo matching tests?\b/i },
     { code: "collected_zero_items", regex: /\bcollected 0 items?\b/i },
+    {
+        code: "reported_zero_passes",
+        regex: /(?:^\s*(?:#|ℹ)?\s*tests\s+0\s*$[\s\S]*^\s*(?:#|ℹ)?\s*pass\s+0\s*$|^\s*(?:#|ℹ)?\s*pass\s+0\s*$[\s\S]*^\s*(?:#|ℹ)?\s*tests\s+0\s*$)/imu,
+    },
+    {
+        code: "reported_zero_tests",
+        regex: /^\s*(?:#|ℹ)?\s*tests\s+0\s*$/imu,
+    },
+];
+const POSITIVE_LINKED_TEST_RUN_PATTERNS = [
+    /^\s*(?:#|ℹ)?\s*tests\s+[1-9]\d*\s*$/imu,
+    /^\s*(?:#|ℹ)?\s*pass\s+[1-9]\d*\s*$/imu,
+    /\bTests?\s+[1-9]\d*\s+passed\b/iu,
+    /\b[1-9]\d*\s+passed\b/iu,
+    /\bTests:\s+(?:.*\b)?[1-9]\d*\s+passed\b/iu,
 ];
 function detectEmptyLinkedTestRun(stdout, stderr) {
     const combined = `${stdout}\n${stderr}`;
     for (const pattern of EMPTY_LINKED_TEST_RUN_PATTERNS) {
         if (pattern.regex.test(combined)) {
-            return pattern.code;
+            return { code: pattern.code };
         }
     }
     return null;
 }
+/** Return whether runner output contains a recognized positive executed-test receipt. */
+function hasPositiveLinkedTestRunReceipt(stdout, stderr) {
+    const combined = `${stdout}\n${stderr}`;
+    return POSITIVE_LINKED_TEST_RUN_PATTERNS.some((pattern) => pattern.test(combined));
+}
+/** Return whether a linked command applies a runner-level test-name filter that must match at least one test. */
+function commandUsesTestNameFilter(command) {
+    const normalized = normalizeCommandForValidation(command);
+    if (/(?:^|\s)(?:--test-name-pattern|--testnamepattern)(?:=|\s)/u.test(normalized)) {
+        return true;
+    }
+    return splitNormalizedCommandSegments(normalized).some((segment) => /(?:^|\s)-t(?:=|\s)/u.test(segment) &&
+        segmentInvokesUnsafeDirectTestRunner(segment));
+}
 function createLinkedTestSandboxLayout(sandboxRoot) {
     return {
         root: sandboxRoot,
@@ -1625,8 +1657,8 @@ function buildLinkedTestEmptyRunResult(params) {
         execution_context: params.executionContext,
         stdout: params.execution.stdout,
         stderr: params.execution.stderr,
-        error: `Linked test reported an empty test run (${params.emptyRunSignal}) while --fail-on-empty-test-run is enabled. ` +
-            "Update test selection or disable --fail-on-empty-test-run for this run.",
+        error: `Linked test reported an empty test run (${params.emptyRunSignal.code}). ` +
+            "Update the test selection so at least one test executes; unfiltered commands may opt out by omitting --fail-on-empty-test-run.",
     };
 }
 function buildLinkedTestCommandFailureResult(params) {
@@ -1643,11 +1675,19 @@ function buildLinkedTestCommandFailureResult(params) {
     };
 }
 function buildLinkedTestPassedExecutionResult(params) {
-    if (params.options?.failOnEmptyTestRun === true) {
+    if (params.options?.failOnEmptyTestRun === true ||
+        commandUsesTestNameFilter(params.linkedTest.command ?? "")) {
         const emptyRunSignal = detectEmptyLinkedTestRun(params.execution.stdout, params.execution.stderr);
         if (emptyRunSignal) {
             return buildLinkedTestEmptyRunResult({ ...params, emptyRunSignal });
         }
+        if (commandUsesTestNameFilter(params.linkedTest.command ?? "") &&
+            !hasPositiveLinkedTestRunReceipt(params.execution.stdout, params.execution.stderr)) {
+            return buildLinkedTestEmptyRunResult({
+                ...params,
+                emptyRunSignal: { code: "missing_positive_execution_receipt" },
+            });
+        }
     }
     const assertionFailures = evaluateLinkedTestAssertions(params.linkedTest, params.execution.stdout, params.execution.stderr);
     if (assertionFailures.length > 0) {
@@ -2129,6 +2169,7 @@ export const _testOnlyTestCommand = {
     buildPmContextMismatchHint,
     commandInvokesPmCli,
     commandInvokesPmTrackerReadCommand,
+    commandUsesTestNameFilter,
     copyIntoSandboxIfPresent,
     countLinkedTestItemFiles,
     ensureScope,
@@ -2160,4 +2201,4 @@ export const _testOnlyTestCommand = {
     summarizeRunResultStatuses,
 };
 //# sourceMappingURL=execution.js.map
-//# debugId=99ce92bb-ed45-5327-b148-b5bb26a0bf05
+//# debugId=de5bc6bf-fe31-5643-a809-ee9ca52aac48