@unbrained/pm-cli 2026.8.11 → 2026.8.12

package/dist/sdk/context-intent-contracts.js

@@ -5,11 +5,11 @@
  * workspace configuration, and packages.
  */
 
-!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]="e48a306e-debb-5e66-ae9b-68bf17fa405f")}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]="fa03d543-ff0d-5556-8558-9bed82838a58")}catch(e){}}();
 import { AsyncLocalStorage } from "node:async_hooks";
 import { attachOutputOmissionReceipt } from "./output-projection.js";
 import { encodeQueryCursor } from "./pagination.js";
-import { applyReadOutputDimensions } from "./read-output-contracts.js";
+import { applyReadOutputDimensions, stabilizeReadOutputReceiptEstimates, } from "./read-output-contracts.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 /** Built-in intent projections shared by CLI, SDK, MCP, and package authors. */
@@ -590,14 +590,55 @@ function collapseContinuationMetadata(options, result) {
     };
     return projected;
 }
+/** Return whether one projected value is a mutable output record. */
+function isOutputRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Read one numeric fixed-point estimate from an optional receipt. */
+function receiptEstimate(value, field) {
+    if (!isOutputRecord(value))
+        return undefined;
+    return typeof value[field] === "number" ? value[field] : undefined;
+}
+/** Stabilize every token receipt after suppressing discovery-only metadata. */
+function stabilizeSuppressedRowContractReceipts(result, options) {
+    let finalized = result;
+    for (let iteration = 0; iteration < 8; iteration += 1) {
+        const previousContextEstimate = receiptEstimate(finalized.context_intent, "estimated_tokens");
+        const previousReadEstimate = receiptEstimate(finalized.read_output, "estimated_tokens");
+        const previousSessionEstimate = receiptEstimate(finalized.read_session, "spent_this_call_tokens");
+        if (isOutputRecord(finalized.context_intent)) {
+            updateContextIntentEstimate(finalized, finalized.context_intent);
+        }
+        finalized = stabilizeReadOutputReceiptEstimates(finalized, options);
+        if (receiptEstimate(finalized.context_intent, "estimated_tokens") ===
+            previousContextEstimate &&
+            receiptEstimate(finalized.read_output, "estimated_tokens") ===
+                previousReadEstimate &&
+            receiptEstimate(finalized.read_session, "spent_this_call_tokens") ===
+                previousSessionEstimate) {
+            break;
+        }
+    }
+    return finalized;
+}
 /** Attach universal row, omission, and optional intent-budget contracts in rendering order. */
 export function attachReadOutputContracts(command, options, result) {
     const disclosedResult = attachOutputOmissionReceipt(command, result);
-    return typeof disclosedResult === "object" &&
+    const projected = typeof disclosedResult === "object" &&
         disclosedResult !== null &&
         !Array.isArray(disclosedResult)
         ? applyReadOutputDimensions(command ?? "", options, collapseContinuationMetadata(options, attachContextIntentReceipt(command ?? "", options, disclosedResult)))
         : disclosedResult;
+    if (options.outputRowContract === true ||
+        options.output_row_contract === true ||
+        typeof projected !== "object" ||
+        projected === null ||
+        Array.isArray(projected) ||
+        !Object.hasOwn(projected, "row_contract")) {
+        return projected;
+    }
+    return stabilizeSuppressedRowContractReceipts(Object.fromEntries(Object.entries(projected).filter(([key]) => key !== "row_contract")), options);
 }
 //# sourceMappingURL=context-intent-contracts.js.map
-//# debugId=e48a306e-debb-5e66-ae9b-68bf17fa405f
+//# debugId=fa03d543-ff0d-5556-8558-9bed82838a58

package/dist/sdk/core.d.ts

@@ -6,6 +6,7 @@
 export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, canonicalDocument, classifyItemFormatVersion, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, isPmCliExpectedError, normalizeItemFormatVersion, normalizeItemId, normalizeStatusInput, nowIso, runAction, serializeItemDocument, aggregate, append, claim, claimNext, close, comments, context, copy, create, deleteItem, deps, docs, files, filesDiscover, focus, get, graph, learnings, list, next, notes, release, restore, search, update, type AggregateOptions, type AggregateResult, type AggregateRow, type AssuranceActionInput, type AssuranceActionResult, type AppendCommandOptions, type AppendResult, type ClaimNextOptions, type ClaimResult, type CloseResult, type CommentsCommandOptions, type CommentsResult, type ContextOptions, type ContextResult, type CopyResult, type CreateResult, type Dependency, type DeleteResult, type DepsCommandOptions, type DepsResult, type DocsCommandOptions, type DocsResult, type FilesCommandOptions, type FilesDiscoverOptions, type FilesDiscoverResult, type FilesResult, type FocusResult, type GetOptions, type GetResult, type ItemFormatVersionScanEntry, type ItemFormatVersionScanResult, type ItemFormatVersionStatus, type LearningsCommandOptions, type LearningsResult, type ListOptions, type ListResult, type NextOptions, type NextResult, type NotesCommandOptions, type NotesResult, type PmActionInput, type PmActionName, type PmActionOptions, type PmClientOptions, type ReleaseResult, type RestoreResult, type SearchOptions, type SearchResult, type UpdateResult, } from "./runtime.js";
 export * from "./core-governance.js";
 export * from "./agent-session-context.js";
+export { isAlreadyClaimedError } from "./lifecycle/claim.js";
 export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
 export { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
 export type { PmReadOutputBudgetExceeded, PmReadOutputDimension, PmReadOutputLegacyAlias, PmReadOutputOptions, PmReadOutputReceipt, PmReadOutputResult, PmReadOutputResultFor, PmReadOutputSurface, PmReadOutputSurfaceContract, } from "./read-output-contracts.js";

package/dist/sdk/core.js

@@ -4,11 +4,12 @@
  * Provides the stable item lifecycle client and universal project data types.
  */
 
-!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]="c2f56389-6238-5b5c-add8-00296fe401b6")}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]="2e0a2422-64c7-5ad3-867c-04479171fa27")}catch(e){}}();
 export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, canonicalDocument, classifyItemFormatVersion, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, isPmCliExpectedError, normalizeItemFormatVersion, normalizeItemId, normalizeStatusInput, nowIso, runAction, serializeItemDocument, aggregate, append, claim, claimNext, close, comments, context, copy, create, deleteItem, deps, docs, files, filesDiscover, focus, get, graph, learnings, list, next, notes, release, restore, search, update, } from "./runtime.js";
 export * from "./core-governance.js";
 export * from "./agent-session-context.js";
+export { isAlreadyClaimedError } from "./lifecycle/claim.js";
 export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
 export { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
 //# sourceMappingURL=core.js.map
-//# debugId=c2f56389-6238-5b5c-add8-00296fe401b6
+//# debugId=2e0a2422-64c7-5ad3-867c-04479171fa27

package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module sdk/generated-error-code-catalog-part-1
+ *
+ * Generated by scripts/generate-error-code-catalog.mjs. Do not edit manually.
+ */
+import type { PmErrorCodeContract } from "../error-code-catalog.js";
+/** Generated partition 1 of the exhaustive error-code catalog. */
+export declare const PM_ERROR_CODE_CATALOG_PART_1: PmErrorCodeContract[];