@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/output/mutation-projection.js

@@ -1,218 +1,2 @@
-/**
- * Shared projection helper for mutation command results.
- *
- * Mutation commands (create/update/close/append/update-many) return a result
- * envelope that carries a `changed_fields` string array. On create this array simply
- * re-lists every field the command just set, which the item echo above it already
- * shows, so for high-volume agent loops it is ~50% redundant payload. This helper
- * lets the CLI (`--no-changed-fields`) and the MCP agent path trim that array down
- * to a deterministic `changed_field_count` without losing mutation evidence.
- *
- * Compaction is deliberately scoped to the mutation envelope only:
- *   - the envelope's own top-level `changed_fields` (create/update/close/append), and
- *   - `rows[*].changed_fields` (update-many reports its delta per row).
- * It does NOT recurse into arbitrary nested objects, so unrelated payloads that
- * legitimately carry `changed_fields` (for example `pm history --diff` entries, or a
- * custom runtime metadata field) are left untouched.
- *
- * The helper is pure and side-effect free, reused by both the output layer and the
- * MCP server, and returns the original reference unchanged when nothing is compacted.
- */
-
-!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]="d6a389b0-7a14-56e7-ac2c-17fcdecc7b29")}catch(e){}}();
-const CHANGED_FIELDS_KEY = "changed_fields";
-const CHANGED_FIELD_COUNT_KEY = "changed_field_count";
-const ROWS_KEY = "rows";
-const UPDATE_MANY_MUTATION_MODES = new Set(["apply", "rollback"]);
-const DELETE_OUTCOMES = new Set(["deleted", "would_delete"]);
-const COMPACT_RECURRENCE_TEXT_LIMIT = 256;
-function truncateCompactRecurrenceText(value) {
-    if (typeof value !== "string" ||
-        value.length <= COMPACT_RECURRENCE_TEXT_LIMIT) {
-        return value;
-    }
-    return `${value.slice(0, COMPACT_RECURRENCE_TEXT_LIMIT - 1)}…`;
-}
-function projectCompactRecurrence(value) {
-    if (!isPlainObject(value))
-        return null;
-    const recurrence = { ...value };
-    recurrence.reason = truncateCompactRecurrenceText(recurrence.reason);
-    if (isPlainObject(recurrence.previous_terminal)) {
-        recurrence.previous_terminal = Object.fromEntries(Object.entries(recurrence.previous_terminal).map(([key, entry]) => [
-            key,
-            truncateCompactRecurrenceText(entry),
-        ]));
-    }
-    return recurrence;
-}
-function isPlainObject(value) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return false;
-    }
-    const proto = Object.getPrototypeOf(value);
-    return proto === null || proto === Object.prototype;
-}
-/** Replace a single envelope's own top-level `changed_fields` array with a count. */
-function compactOwnChangedFields(envelope) {
-    const changedFields = envelope[CHANGED_FIELDS_KEY];
-    if (!Array.isArray(changedFields)) {
-        return null;
-    }
-    const projected = Object.getPrototypeOf(envelope) === null ? Object.create(null) : {};
-    for (const [key, value] of Object.entries(envelope)) {
-        if (key !== CHANGED_FIELDS_KEY) {
-            projected[key] = value;
-        }
-    }
-    projected[CHANGED_FIELD_COUNT_KEY] = changedFields.length;
-    return projected;
-}
-function isMutationEnvelope(value) {
-    return "item" in value && Array.isArray(value[CHANGED_FIELDS_KEY]);
-}
-function isUpdateManyMutationEnvelope(value) {
-    return (typeof value.mode === "string" &&
-        UPDATE_MANY_MUTATION_MODES.has(value.mode) &&
-        Array.isArray(value[ROWS_KEY]));
-}
-function replaceRows(envelope, rows) {
-    const projected = Object.getPrototypeOf(envelope) === null ? Object.create(null) : {};
-    Object.assign(projected, envelope);
-    projected[ROWS_KEY] = rows;
-    return projected;
-}
-function projectIdOnlyResult(result) {
-    if (!isPlainObject(result)) {
-        return null;
-    }
-    // Plan mutations wrap the mutated subject under "plan" instead of "item";
-    // both shapes honor the root --id-only contract (id + status).
-    const subject = isPlainObject(result.item)
-        ? result.item
-        : isPlainObject(result.plan)
-            ? result.plan
-            : null;
-    if (subject === null) {
-        return null;
-    }
-    const id = typeof subject.id === "string" ? subject.id : undefined;
-    const status = typeof result.outcome === "string" && DELETE_OUTCOMES.has(result.outcome)
-        ? result.outcome
-        : typeof subject.status === "string"
-            ? subject.status
-            : undefined;
-    if (!id) {
-        return null;
-    }
-    return status
-        ? {
-            id,
-            status,
-            ...(typeof result.deleted === "boolean"
-                ? { deleted: result.deleted }
-                : {}),
-        }
-        : { id };
-}
-/** Project a recognized item mutation to identity and change counts while preserving warnings and executable recovery. */
-function projectCompactMutationEnvelope(result) {
-    if (!isPlainObject(result) || !isPlainObject(result.item))
-        return null;
-    if (typeof result.item.id !== "string")
-        return null;
-    const changedFields = result[CHANGED_FIELDS_KEY];
-    if (!Array.isArray(changedFields))
-        return null;
-    const compact = {
-        id: result.item.id,
-        ...(typeof result.outcome === "string" &&
-            DELETE_OUTCOMES.has(result.outcome)
-            ? { status: result.outcome }
-            : typeof result.item.status === "string"
-                ? { status: result.item.status }
-                : {}),
-        ...(typeof result.deleted === "boolean" ? { deleted: result.deleted } : {}),
-        ...(typeof result.previous_status === "string"
-            ? { previous_status: result.previous_status }
-            : {}),
-        changed_field_count: changedFields.length,
-    };
-    appendCompactMutationEvidence(result, result.item, compact);
-    return compact;
-}
-/** Keep lifecycle context, warnings, and executable recovery alongside the compact identity. */
-function appendCompactMutationEvidence(result, item, compact) {
-    const closeReason = typeof result.close_reason === "string"
-        ? result.close_reason
-        : typeof item.close_reason === "string"
-            ? item.close_reason
-            : undefined;
-    if (closeReason !== undefined)
-        compact.close_reason = closeReason;
-    const recurrence = projectCompactRecurrence(result.recurrence);
-    if (recurrence !== null)
-        compact.recurrence = recurrence;
-    if (Array.isArray(result.warnings) && result.warnings.length > 0)
-        compact.warnings = result.warnings;
-    if (isPlainObject(result.recovery))
-        compact.recovery = result.recovery;
-}
-function compactUpdateManyRows(envelope) {
-    const rows = isUpdateManyMutationEnvelope(envelope)
-        ? envelope[ROWS_KEY]
-        : undefined;
-    if (!Array.isArray(rows)) {
-        return { projected: envelope, changed: false };
-    }
-    let rowsChanged = false;
-    const nextRows = rows.map((row) => {
-        if (!isPlainObject(row)) {
-            return row;
-        }
-        const compactedRow = compactOwnChangedFields(row);
-        if (compactedRow) {
-            rowsChanged = true;
-            return compactedRow;
-        }
-        return row;
-    });
-    return rowsChanged
-        ? { projected: replaceRows(envelope, nextRows), changed: true }
-        : { projected: envelope, changed: false };
-}
-/** Returns a copy of a mutation result with the envelope `changed_fields` arrays replaced by `changed_field_count` when compact mode is requested. Inputs that are not a mutation envelope (or full mode) are returned unchanged (same reference). */
-export function projectMutationResult(result, options = {}) {
-    if (options.idOnly === true) {
-        const idOnly = projectIdOnlyResult(result);
-        if (idOnly !== null) {
-            return idOnly;
-        }
-    }
-    if (options.compactEnvelope === true) {
-        const compact = projectCompactMutationEnvelope(result);
-        if (compact !== null)
-            return compact;
-    }
-    const mode = options.changedFields ?? "full";
-    if (mode === "full" || !isPlainObject(result)) {
-        return result;
-    }
-    let changed = false;
-    let projected = result;
-    const compactedTop = isMutationEnvelope(result)
-        ? compactOwnChangedFields(result)
-        : null;
-    if (compactedTop !== null) {
-        projected = compactedTop;
-        changed = true;
-    }
-    const rowProjection = compactUpdateManyRows(projected);
-    if (rowProjection.changed) {
-        projected = rowProjection.projected;
-        changed = true;
-    }
-    return changed ? projected : result;
-}
+!(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]="3d2360c6-41c1-5527-a53c-38d0590e3f04")}catch(e2){}})();const CHANGED_FIELDS_KEY="changed_fields";const CHANGED_FIELD_COUNT_KEY="changed_field_count";const ROWS_KEY="rows";const UPDATE_MANY_MUTATION_MODES=new Set(["apply","rollback"]);const DELETE_OUTCOMES=new Set(["deleted","would_delete"]);const COMPACT_RECURRENCE_TEXT_LIMIT=256;function truncateCompactRecurrenceText(value){if(typeof value!=="string"||value.length<=COMPACT_RECURRENCE_TEXT_LIMIT){return value}return`${value.slice(0,COMPACT_RECURRENCE_TEXT_LIMIT-1)}\u2026`}function projectCompactRecurrence(value){if(!isPlainObject(value))return null;const recurrence={...value};recurrence.reason=truncateCompactRecurrenceText(recurrence.reason);if(isPlainObject(recurrence.previous_terminal)){recurrence.previous_terminal=Object.fromEntries(Object.entries(recurrence.previous_terminal).map(([key,entry])=>[key,truncateCompactRecurrenceText(entry)]))}return recurrence}function isPlainObject(value){if(typeof value!=="object"||value===null||Array.isArray(value)){return false}const proto=Object.getPrototypeOf(value);return proto===null||proto===Object.prototype}function compactOwnChangedFields(envelope){const changedFields=envelope[CHANGED_FIELDS_KEY];if(!Array.isArray(changedFields)){return null}const projected=Object.getPrototypeOf(envelope)===null?Object.create(null):{};for(const[key,value]of Object.entries(envelope)){if(key!==CHANGED_FIELDS_KEY){projected[key]=value}}projected[CHANGED_FIELD_COUNT_KEY]=changedFields.length;return projected}function isMutationEnvelope(value){return"item"in value&&Array.isArray(value[CHANGED_FIELDS_KEY])}function isUpdateManyMutationEnvelope(value){return typeof value.mode==="string"&&UPDATE_MANY_MUTATION_MODES.has(value.mode)&&Array.isArray(value[ROWS_KEY])}function replaceRows(envelope,rows){const projected=Object.getPrototypeOf(envelope)===null?Object.create(null):{};Object.assign(projected,envelope);projected[ROWS_KEY]=rows;return projected}function projectIdOnlyResult(result){if(!isPlainObject(result)){return null}const subject=isPlainObject(result.item)?result.item:isPlainObject(result.plan)?result.plan:null;if(subject===null){return null}const id=typeof subject.id==="string"?subject.id:void 0;const status=typeof result.outcome==="string"&&DELETE_OUTCOMES.has(result.outcome)?result.outcome:typeof subject.status==="string"?subject.status:void 0;if(!id){return null}return status?{id,status,...typeof result.deleted==="boolean"?{deleted:result.deleted}:{}}:{id}}function projectCompactMutationEnvelope(result){if(!isPlainObject(result)||!isPlainObject(result.item))return null;if(typeof result.item.id!=="string")return null;const changedFields=result[CHANGED_FIELDS_KEY];if(!Array.isArray(changedFields))return null;const compact={id:result.item.id,...typeof result.outcome==="string"&&DELETE_OUTCOMES.has(result.outcome)?{status:result.outcome}:typeof result.item.status==="string"?{status:result.item.status}:{},...typeof result.deleted==="boolean"?{deleted:result.deleted}:{},...typeof result.previous_status==="string"?{previous_status:result.previous_status}:{},changed_field_count:changedFields.length};appendCompactMutationEvidence(result,result.item,compact);return compact}function appendCompactMutationEvidence(result,item,compact){const closeReason=typeof result.close_reason==="string"?result.close_reason:typeof item.close_reason==="string"?item.close_reason:void 0;if(closeReason!==void 0)compact.close_reason=closeReason;const recurrence=projectCompactRecurrence(result.recurrence);if(recurrence!==null)compact.recurrence=recurrence;if(Array.isArray(result.warnings)&&result.warnings.length>0)compact.warnings=result.warnings;if(isPlainObject(result.recovery))compact.recovery=result.recovery;if(typeof result.claimed_by==="string"){for(const key of["claimed_by","previous_assignee","forced","skipped","available","attempts"]){if(Object.hasOwn(result,key))compact[key]=result[key]}}}function compactUpdateManyRows(envelope){const rows=isUpdateManyMutationEnvelope(envelope)?envelope[ROWS_KEY]:void 0;if(!Array.isArray(rows)){return{projected:envelope,changed:false}}let rowsChanged=false;const nextRows=rows.map(row=>{if(!isPlainObject(row)){return row}const compactedRow=compactOwnChangedFields(row);if(compactedRow){rowsChanged=true;return compactedRow}return row});return rowsChanged?{projected:replaceRows(envelope,nextRows),changed:true}:{projected:envelope,changed:false}}function projectMutationResult(result,options={}){if(options.idOnly===true){const idOnly=projectIdOnlyResult(result);if(idOnly!==null){return idOnly}}if(options.compactEnvelope===true){const compact=projectCompactMutationEnvelope(result);if(compact!==null)return compact}const mode=options.changedFields??"full";if(mode==="full"||!isPlainObject(result)){return result}let changed=false;let projected=result;const compactedTop=isMutationEnvelope(result)?compactOwnChangedFields(result):null;if(compactedTop!==null){projected=compactedTop;changed=true}const rowProjection=compactUpdateManyRows(projected);if(rowProjection.changed){projected=rowProjection.projected;changed=true}return changed?projected:result}export{projectMutationResult};
 //# sourceMappingURL=mutation-projection.js.map
-//# debugId=d6a389b0-7a14-56e7-ac2c-17fcdecc7b29

package/dist/core/output/output-control.js

@@ -1,26 +1,2 @@
-/**
- * @module core/output/output-control
- *
- * Defines the structural protocol for commands that own their output stream.
- */
-
-!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]="22af7808-6456-5889-b6e3-1abd73f35738")}catch(e){}}();
-const SUPPRESS_HOST_OUTPUT_KEY = "__pm_suppress_host_output";
-/** Collision-resistant wire marker understood by pm hosts when a package already emitted output. */
-export const SUPPRESS_HOST_OUTPUT_MARKER = "@unbrained/pm-cli:suppress-host-output:v1";
-/** Return from a command/exporter after it has written its own streaming, binary, or pre-rendered output. */
-export function suppressHostOutput(result) {
-    return result === undefined
-        ? { __pm_suppress_host_output: SUPPRESS_HOST_OUTPUT_MARKER }
-        : { __pm_suppress_host_output: SUPPRESS_HOST_OUTPUT_MARKER, result };
-}
-/** Detect the public suppression result without relying on object identity across package boundaries. */
-export function isHostOutputSuppressed(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        !Array.isArray(value) &&
-        value[SUPPRESS_HOST_OUTPUT_KEY] ===
-            SUPPRESS_HOST_OUTPUT_MARKER);
-}
+!(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]="de5f8d66-b9dc-555c-a52f-33b1b5368be3")}catch(e2){}})();const SUPPRESS_HOST_OUTPUT_KEY="__pm_suppress_host_output";const SUPPRESS_HOST_OUTPUT_MARKER="@unbrained/pm-cli:suppress-host-output:v1";function suppressHostOutput(result){return result===void 0?{__pm_suppress_host_output:SUPPRESS_HOST_OUTPUT_MARKER}:{__pm_suppress_host_output:SUPPRESS_HOST_OUTPUT_MARKER,result}}function isHostOutputSuppressed(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)&&value[SUPPRESS_HOST_OUTPUT_KEY]===SUPPRESS_HOST_OUTPUT_MARKER}export{SUPPRESS_HOST_OUTPUT_MARKER,isHostOutputSuppressed,suppressHostOutput};
 //# sourceMappingURL=output-control.js.map
-//# debugId=22af7808-6456-5889-b6e3-1abd73f35738