@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/lifecycle/close-many.js

@@ -1,439 +1,2 @@
-/**
- * @module cli/commands/close-many
- *
- * Implements the pm close many 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]="a97a3cf0-beef-5967-8f5b-2372a6c9f2f7")}catch(e){}}();
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, getActiveExtensionRegistrations, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, toErrorMessage, resolveAuthor, nowIso, listAllItemMetadataLight, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
-import { runClose } from "./close.js";
-import { hasListFilters } from "../query/list-filter-shared.js";
-import { runList } from "../query/list.js";
-import { runRestore } from "./restore.js";
-import { derivePmBulkMutationEffect, } from "../cli-contracts/command-exit-contracts.js";
-const CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
-const CLOSE_MANY_CHECKPOINT_SUBDIR = "close-many";
-const CLOSE_MANY_FILTER_GUIDANCE = [
-    "--filter-status",
-    "--filter-type",
-    "--filter-tag",
-    "--filter-priority",
-    "--filter-sprint",
-    "--filter-release",
-    "--filter-parent",
-    "--filter-assignee",
-    "--filter-updated-before",
-    "--ids",
-].join(", ");
-function hasCloseManyFilters(list, status) {
-    return hasListFilters(list, status, { includePagination: false });
-}
-function hasCloseManyRollbackConflicts(list, status) {
-    return hasListFilters(list, status);
-}
-function rejectBlankIdsFilter(list) {
-    if (list?.ids != null && String(list.ids).trim().length === 0) {
-        throw new PmCliError("--ids requires at least one non-empty item ID", EXIT_CODE.USAGE);
-    }
-}
-function activeListOptions(list) {
-    const active = {};
-    if (!list) {
-        return active;
-    }
-    for (const [key, value] of Object.entries(list)) {
-        if (value == null ||
-            (typeof value === "string" &&
-                !value.split(",").some((entry) => entry.trim().length > 0))) {
-            continue;
-        }
-        active[key] = value;
-    }
-    return active;
-}
-function resolveReason(reason, required) {
-    const trimmed = String(reason ?? "").trim();
-    if (trimmed.length > 0) {
-        return trimmed;
-    }
-    if (required) {
-        throw new PmCliError("pm close-many requires a shared close reason via --reason because governance.require_close_reason is enabled.", EXIT_CODE.USAGE, {
-            code: "close_reason_required",
-            required: "Provide a shared closing summary via --reason for the whole batch.",
-            why: "governance.require_close_reason is enabled, so every close must record why the items are done.",
-            examples: [
-                'pm close-many --filter-sprint S-12 --reason "Sprint S-12 acceptance criteria met"',
-                'pm close-many --ids pm-a,pm-b --reason "Superseded by redesign"',
-            ],
-            nextSteps: [
-                "Re-run with --reason describing the shared outcome.",
-                "To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled",
-            ],
-        });
-    }
-    return undefined;
-}
-// Build a parent -> non-terminal child id map in a single light scan so each
-// matched parent can be annotated with the active children that closing it
-// would orphan (the same signal runClose surfaces per item on apply).
-async function buildActiveChildrenByParent(pmRoot, settings) {
-    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    const items = await listAllItemMetadataLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);
-    const childrenByParent = new Map();
-    const parentByChild = new Map();
-    for (const item of items) {
-        if (typeof item.parent !== "string" || item.parent.length === 0) {
-            continue;
-        }
-        parentByChild.set(item.id, item.parent);
-        if (isTerminalStatus(item.status, statusRegistry)) {
-            continue;
-        }
-        const existing = childrenByParent.get(item.parent);
-        if (existing) {
-            existing.push(item.id);
-        }
-        else {
-            childrenByParent.set(item.parent, [item.id]);
-        }
-    }
-    for (const ids of childrenByParent.values()) {
-        ids.sort((left, right) => left.localeCompare(right));
-    }
-    return { childrenByParent, parentByChild };
-}
-function hierarchyDepth(id, parentByChild, cache) {
-    const cached = cache?.get(id);
-    if (cached !== undefined) {
-        return cached;
-    }
-    let depth = 0;
-    let current = parentByChild.get(id);
-    const path = [];
-    const visited = new Set();
-    let hasCycle = false;
-    while (current !== undefined && !visited.has(current)) {
-        const cachedCurrent = cache?.get(current);
-        if (cachedCurrent !== undefined) {
-            depth += cachedCurrent + 1;
-            break;
-        }
-        visited.add(current);
-        path.push(current);
-        depth += 1;
-        current = parentByChild.get(current);
-    }
-    if (current !== undefined && visited.has(current)) {
-        hasCycle = true;
-    }
-    if (!hasCycle) {
-        cache?.set(id, depth);
-        for (const [index, ancestorId] of path.entries()) {
-            cache?.set(ancestorId, depth - index - 1);
-        }
-    }
-    return depth;
-}
-async function runCloseManyRollback(params) {
-    const checkpoint = await loadMutationCheckpoint(params.pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, params.rollbackId, CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION);
-    const restoreMessage = params.options.message ?? `Rollback close-many checkpoint ${checkpoint.id}`;
-    const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) => runRestore(id, targetUpdatedAt, { author: params.options.author, message: restoreMessage, force: true }, params.global));
-    return {
-        ...derivePmBulkMutationEffect({
-            applied: rollback.restored_ids.length,
-            skipped: 0,
-            failed: rollback.failed_count,
-            unmatched: 0,
-        }),
-        mode: "rollback",
-        matched_count: checkpoint.items.length,
-        dry_run: false,
-        rollback_checkpoint_id: checkpoint.id,
-        checkpoint: {
-            id: checkpoint.id,
-            created_at: checkpoint.created_at,
-            path: checkpoint.path,
-            rollback_command: `pm close-many --rollback ${checkpoint.id}`,
-        },
-        restored_count: rollback.restored_ids.length,
-        failed_count: rollback.failed_count,
-        rows: rollback.rows,
-        ids: rollback.restored_ids,
-    };
-}
-function planCloseManyRows(matched, childrenByParent, closePlannedIds, statusRegistry, force) {
-    return matched.map((item) => {
-        const activeChildIds = (childrenByParent.get(item.id) ?? []).filter((childId) => !closePlannedIds.has(childId));
-        const willSkip = !canCloseManyItem(item, statusRegistry, force);
-        return {
-            id: item.id,
-            title: typeof item.title === "string" ? item.title : "",
-            status: item.status,
-            action: willSkip ? "skip" : "close",
-            ...(willSkip ? { skip_reason: "already_terminal" } : {}),
-            ...(activeChildIds.length > 0
-                ? { active_child_ids: activeChildIds }
-                : {}),
-        };
-    });
-}
-async function writeCloseManyCheckpoint(params) {
-    const checkpointPath = await writeMutationCheckpoint(params.pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, params.checkpointId, {
-        schema_version: CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,
-        id: params.checkpointId,
-        created_at: params.nowValue,
-        author: resolveAuthor(params.options.author, "unknown"),
-        ...(params.reason !== undefined ? { reason: params.reason } : {}),
-        filters: params.filters,
-        items: params.checkpointItems,
-    });
-    return {
-        id: params.checkpointId,
-        created_at: params.nowValue,
-        path: checkpointPath,
-        rollback_command: `pm close-many --rollback ${params.checkpointId}`,
-    };
-}
-async function applyCloseManyRows(params) {
-    const rows = [];
-    const closedIds = [];
-    for (const item of params.matched) {
-        if (!params.closableIds.has(item.id)) {
-            rows.push({
-                id: item.id,
-                status: "skipped",
-                skip_reason: "already_terminal",
-            });
-            continue;
-        }
-        try {
-            const result = await runClose(item.id, params.reason, params.closeOptions, params.global);
-            rows.push({
-                id: item.id,
-                status: "closed",
-                changed_fields: result.changed_fields,
-                ...(result.warnings && result.warnings.length > 0
-                    ? { warnings: result.warnings }
-                    : {}),
-            });
-            closedIds.push(item.id);
-        }
-        catch (error) {
-            rows.push({
-                id: item.id,
-                status: "failed",
-                error: toErrorMessage(error),
-            });
-        }
-    }
-    return { rows, closedIds };
-}
-function resolveCloseManyRollbackId(options) {
-    return typeof options.rollback === "string" ? options.rollback : undefined;
-}
-function validateCloseManyRollbackOptions(options, rollbackId) {
-    if (rollbackId.trim().length === 0) {
-        throw new PmCliError("--rollback requires a checkpoint id", EXIT_CODE.USAGE);
-    }
-    if (options.dryRun === true) {
-        throw new PmCliError("--dry-run cannot be combined with --rollback", EXIT_CODE.USAGE);
-    }
-    if (hasCloseManyRollbackConflicts(options.list, options.status)) {
-        throw new PmCliError("Rollback mode does not accept filter options", EXIT_CODE.USAGE);
-    }
-}
-function assertCloseManyHasFilters(options) {
-    if (hasCloseManyFilters(options.list, options.status)) {
-        return;
-    }
-    throw new PmCliError(`close-many requires at least one filter to scope the close (for example: ${CLOSE_MANY_FILTER_GUIDANCE}). Refusing to match every item.`, EXIT_CODE.USAGE);
-}
-function sortCloseManyMatchedItems(matched, parentByChild) {
-    const depthCache = new Map();
-    return [...matched].sort((left, right) => {
-        const depthDelta = hierarchyDepth(right.id, parentByChild, depthCache) -
-            hierarchyDepth(left.id, parentByChild, depthCache);
-        return depthDelta !== 0 ? depthDelta : left.id.localeCompare(right.id);
-    });
-}
-function canCloseManyItem(item, statusRegistry, force) {
-    return force || !isTerminalStatus(item.status, statusRegistry);
-}
-function resolveCloseManyPlannedIds(matched, statusRegistry, force) {
-    return new Set(matched
-        .filter((item) => canCloseManyItem(item, statusRegistry, force))
-        .map((item) => item.id));
-}
-async function buildCloseManyPlanContext(params) {
-    assertCloseManyHasFilters(params.options);
-    const statusRegistry = resolveRuntimeStatusRegistry(params.settings.schema);
-    const reason = resolveReason(params.options.reason, params.settings.governance.require_close_reason);
-    const force = params.options.force === true;
-    const listed = await runList(params.options.status, activeListOptions(params.options.list), params.global);
-    const { childrenByParent, parentByChild } = await buildActiveChildrenByParent(params.pmRoot, params.settings);
-    const matched = sortCloseManyMatchedItems(listed.items, parentByChild);
-    const requestedIds = [
-        ...new Set(String(params.options.list?.ids ?? "")
-            .split(",")
-            .map((entry) => entry.trim())
-            .filter((entry) => entry.length > 0)),
-    ];
-    const existenceItems = requestedIds.length === 0
-        ? []
-        : (await runList(undefined, {
-            ids: requestedIds.join(","),
-            noTruncate: true,
-            full: true,
-        }, params.global)).items;
-    const existingIds = new Set(existenceItems.map((item) => item.id));
-    const closePlannedIds = resolveCloseManyPlannedIds(matched, statusRegistry, force);
-    return {
-        pmRoot: params.pmRoot,
-        settings: params.settings,
-        statusRegistry,
-        reason,
-        validateCloseMode: params.options.validateClose,
-        force,
-        listed,
-        matched,
-        unmatchedIds: requestedIds.length === 0
-            ? undefined
-            : requestedIds.filter((id) => !existingIds.has(id)),
-        planRows: planCloseManyRows(matched, childrenByParent, closePlannedIds, statusRegistry, force),
-    };
-}
-function buildCloseManyDryRunResult(context) {
-    return {
-        outcome: "effect",
-        exit_code: EXIT_CODE.SUCCESS,
-        mode: "dry_run",
-        matched_count: context.matched.length,
-        dry_run: true,
-        ...(context.reason !== undefined ? { reason: context.reason } : {}),
-        filters: context.listed.filters,
-        ...(context.validateCloseMode
-            ? { validate_close: context.validateCloseMode }
-            : {}),
-        item_plans: context.planRows,
-        ids: [],
-        ...(context.unmatchedIds !== undefined
-            ? {
-                unmatched_ids: context.unmatchedIds,
-                unmatched_count: context.unmatchedIds.length,
-            }
-            : {}),
-    };
-}
-async function resolveCloseManyCheckpointInfo(params) {
-    if (params.options.checkpoint === false || params.closableIds.size === 0) {
-        return undefined;
-    }
-    const checkpointItems = params.context.matched
-        .filter((item) => params.closableIds.has(item.id))
-        .map((item) => ({ id: item.id, target_updated_at: item.updated_at }));
-    return writeCloseManyCheckpoint({
-        pmRoot: params.context.pmRoot,
-        checkpointId: params.checkpointId,
-        nowValue: params.nowValue,
-        options: params.options,
-        reason: params.context.reason,
-        filters: params.context.listed.filters,
-        checkpointItems,
-    });
-}
-/** Implements run close many for the public runtime surface of this module. */
-export async function runCloseMany(options, global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    const dryRun = options.dryRun === true;
-    const rollbackId = resolveCloseManyRollbackId(options);
-    rejectBlankIdsFilter(options.list);
-    if (rollbackId !== undefined) {
-        validateCloseManyRollbackOptions(options, rollbackId);
-        return runCloseManyRollback({ pmRoot, rollbackId, options, global });
-    }
-    const context = await buildCloseManyPlanContext({
-        pmRoot,
-        settings,
-        options,
-        global,
-    });
-    if (dryRun) {
-        return buildCloseManyDryRunResult(context);
-    }
-    const closableIds = new Set(context.planRows
-        .filter((row) => row.action === "close")
-        .map((row) => row.id));
-    const nowValue = nowIso();
-    const checkpointId = createCheckpointId(CLOSE_MANY_CHECKPOINT_SUBDIR, nowValue);
-    const checkpointInfo = await resolveCloseManyCheckpointInfo({
-        context,
-        options,
-        closableIds,
-        checkpointId,
-        nowValue,
-    });
-    const closeOptions = {
-        author: options.author,
-        message: options.message ?? `close-many apply ${checkpointId}`,
-        completedAt: options.completedAt,
-        validateClose: context.validateCloseMode,
-        force: context.force,
-        resolution: options.resolution,
-        expectedResult: options.expectedResult,
-        actualResult: options.actualResult,
-    };
-    const { rows, closedIds } = await applyCloseManyRows({
-        matched: context.matched,
-        closableIds,
-        reason: context.reason,
-        closeOptions,
-        global,
-    });
-    const closedCount = rows.filter((row) => row.status === "closed").length;
-    const skippedCount = rows.filter((row) => row.status === "skipped").length;
-    const failedCount = rows.filter((row) => row.status === "failed").length;
-    return {
-        ...derivePmBulkMutationEffect({
-            applied: closedCount,
-            skipped: skippedCount,
-            failed: failedCount,
-            unmatched: context.unmatchedIds?.length ?? 0,
-        }),
-        mode: "apply",
-        matched_count: context.matched.length,
-        dry_run: false,
-        ...(context.reason !== undefined ? { reason: context.reason } : {}),
-        filters: context.listed.filters,
-        ...(context.validateCloseMode
-            ? { validate_close: context.validateCloseMode }
-            : {}),
-        ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),
-        closed_count: closedCount,
-        skipped_count: skippedCount,
-        failed_count: failedCount,
-        rows,
-        ids: closedIds,
-        ...(context.unmatchedIds !== undefined
-            ? {
-                unmatched_ids: context.unmatchedIds,
-                unmatched_count: context.unmatchedIds.length,
-            }
-            : {}),
-    };
-}
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    activeListOptions,
-    buildActiveChildrenByParent,
-    hasCloseManyFilters,
-    hasCloseManyRollbackConflicts,
-    hierarchyDepth,
-    rejectBlankIdsFilter,
-    resolveReason,
-};
+!(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]="aec6f8e2-5fd0-53f3-8262-c6b49741ff96")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{createCheckpointId,loadMutationCheckpoint,restoreCheckpointItems,writeMutationCheckpoint,getActiveExtensionRegistrations,isTerminalStatus,resolveItemTypeRegistry,resolveRuntimeStatusRegistry,EXIT_CODE,PmCliError,toErrorMessage,resolveAuthor,nowIso,listAllItemMetadataLight,resolvePmRoot,readSettings}from"../runtime-primitives.js";import{runClose}from"./close.js";import{hasListFilters}from"../query/list-filter-shared.js";import{runList}from"../query/list.js";import{runRestore}from"./restore.js";import{derivePmBulkMutationEffect}from"../cli-contracts/command-exit-contracts.js";const CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION=1;const CLOSE_MANY_CHECKPOINT_SUBDIR="close-many";const CLOSE_MANY_FILTER_GUIDANCE=["--filter-status","--filter-type","--filter-tag","--filter-priority","--filter-sprint","--filter-release","--filter-parent","--filter-assignee","--filter-updated-before","--ids"].join(", ");function hasCloseManyFilters(list,status){return hasListFilters(list,status,{includePagination:false})}function hasCloseManyRollbackConflicts(list,status){return hasListFilters(list,status)}function rejectBlankIdsFilter(list){if(list?.ids!=null&&String(list.ids).trim().length===0){throw new PmCliError("--ids requires at least one non-empty item ID",EXIT_CODE.USAGE)}}function activeListOptions(list){const active={};if(!list){return active}for(const[key,value]of Object.entries(list)){if(value==null||typeof value==="string"&&!value.split(",").some(entry=>entry.trim().length>0)){continue}active[key]=value}return active}function resolveReason(reason,required){const trimmed=String(reason??"").trim();if(trimmed.length>0){return trimmed}if(required){throw new PmCliError("pm close-many requires a shared close reason via --reason because governance.require_close_reason is enabled.",EXIT_CODE.USAGE,{code:"close_reason_required",required:"Provide a shared closing summary via --reason for the whole batch.",why:"governance.require_close_reason is enabled, so every close must record why the items are done.",examples:['pm close-many --filter-sprint S-12 --reason "Sprint S-12 acceptance criteria met"','pm close-many --ids pm-a,pm-b --reason "Superseded by redesign"'],nextSteps:["Re-run with --reason describing the shared outcome.","To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled"]})}return void 0}async function buildActiveChildrenByParent(pmRoot,settings){const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const items=await listAllItemMetadataLight(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema);const childrenByParent=new Map;const parentByChild=new Map;for(const item of items){if(typeof item.parent!=="string"||item.parent.length===0){continue}parentByChild.set(item.id,item.parent);if(isTerminalStatus(item.status,statusRegistry)){continue}const existing=childrenByParent.get(item.parent);if(existing){existing.push(item.id)}else{childrenByParent.set(item.parent,[item.id])}}for(const ids of childrenByParent.values()){ids.sort((left,right)=>left.localeCompare(right))}return{childrenByParent,parentByChild}}function hierarchyDepth(id,parentByChild,cache){const cached=cache?.get(id);if(cached!==void 0){return cached}let depth=0;let current=parentByChild.get(id);const path=[];const visited=new Set;let hasCycle=false;while(current!==void 0&&!visited.has(current)){const cachedCurrent=cache?.get(current);if(cachedCurrent!==void 0){depth+=cachedCurrent+1;break}visited.add(current);path.push(current);depth+=1;current=parentByChild.get(current)}if(current!==void 0&&visited.has(current)){hasCycle=true}if(!hasCycle){cache?.set(id,depth);for(const[index,ancestorId]of path.entries()){cache?.set(ancestorId,depth-index-1)}}return depth}async function runCloseManyRollback(params){const checkpoint=await loadMutationCheckpoint(params.pmRoot,CLOSE_MANY_CHECKPOINT_SUBDIR,params.rollbackId,CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION);const restoreMessage=params.options.message??`Rollback close-many checkpoint ${checkpoint.id}`;const rollback=await restoreCheckpointItems(checkpoint.items,(id,targetUpdatedAt)=>runRestore(id,targetUpdatedAt,{author:params.options.author,message:restoreMessage,force:true},params.global));return{...derivePmBulkMutationEffect({applied:rollback.restored_ids.length,skipped:0,failed:rollback.failed_count,unmatched:0}),mode:"rollback",matched_count:checkpoint.items.length,dry_run:false,rollback_checkpoint_id:checkpoint.id,checkpoint:{id:checkpoint.id,created_at:checkpoint.created_at,path:checkpoint.path,rollback_command:`pm close-many --rollback ${checkpoint.id}`},restored_count:rollback.restored_ids.length,failed_count:rollback.failed_count,rows:rollback.rows,ids:rollback.restored_ids}}function planCloseManyRows(matched,childrenByParent,closePlannedIds,statusRegistry,force){return matched.map(item=>{const activeChildIds=(childrenByParent.get(item.id)??[]).filter(childId=>!closePlannedIds.has(childId));const willSkip=!canCloseManyItem(item,statusRegistry,force);return{id:item.id,title:typeof item.title==="string"?item.title:"",status:item.status,action:willSkip?"skip":"close",...willSkip?{skip_reason:"already_terminal"}:{},...activeChildIds.length>0?{active_child_ids:activeChildIds}:{}}})}async function writeCloseManyCheckpoint(params){const checkpointPath=await writeMutationCheckpoint(params.pmRoot,CLOSE_MANY_CHECKPOINT_SUBDIR,params.checkpointId,{schema_version:CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,id:params.checkpointId,created_at:params.nowValue,author:resolveAuthor(params.options.author,"unknown"),...params.reason!==void 0?{reason:params.reason}:{},filters:params.filters,items:params.checkpointItems});return{id:params.checkpointId,created_at:params.nowValue,path:checkpointPath,rollback_command:`pm close-many --rollback ${params.checkpointId}`}}async function applyCloseManyRows(params){const rows=[];const closedIds=[];for(const item of params.matched){if(!params.closableIds.has(item.id)){rows.push({id:item.id,status:"skipped",skip_reason:"already_terminal"});continue}try{const result=await runClose(item.id,params.reason,params.closeOptions,params.global);rows.push({id:item.id,status:"closed",changed_fields:result.changed_fields,...result.warnings&&result.warnings.length>0?{warnings:result.warnings}:{}});closedIds.push(item.id)}catch(error){rows.push({id:item.id,status:"failed",error:toErrorMessage(error)})}}return{rows,closedIds}}function resolveCloseManyRollbackId(options){return typeof options.rollback==="string"?options.rollback:void 0}function validateCloseManyRollbackOptions(options,rollbackId){if(rollbackId.trim().length===0){throw new PmCliError("--rollback requires a checkpoint id",EXIT_CODE.USAGE)}if(options.dryRun===true){throw new PmCliError("--dry-run cannot be combined with --rollback",EXIT_CODE.USAGE)}if(hasCloseManyRollbackConflicts(options.list,options.status)){throw new PmCliError("Rollback mode does not accept filter options",EXIT_CODE.USAGE)}}function assertCloseManyHasFilters(options){if(hasCloseManyFilters(options.list,options.status)){return}throw new PmCliError(`close-many requires at least one filter to scope the close (for example: ${CLOSE_MANY_FILTER_GUIDANCE}). Refusing to match every item.`,EXIT_CODE.USAGE)}function sortCloseManyMatchedItems(matched,parentByChild){const depthCache=new Map;return[...matched].sort((left,right)=>{const depthDelta=hierarchyDepth(right.id,parentByChild,depthCache)-hierarchyDepth(left.id,parentByChild,depthCache);return depthDelta!==0?depthDelta:left.id.localeCompare(right.id)})}function canCloseManyItem(item,statusRegistry,force){return force||!isTerminalStatus(item.status,statusRegistry)}function resolveCloseManyPlannedIds(matched,statusRegistry,force){return new Set(matched.filter(item=>canCloseManyItem(item,statusRegistry,force)).map(item=>item.id))}async function buildCloseManyPlanContext(params){assertCloseManyHasFilters(params.options);const statusRegistry=resolveRuntimeStatusRegistry(params.settings.schema);const reason=resolveReason(params.options.reason,params.settings.governance.require_close_reason);const force=params.options.force===true;const listed=await runList(params.options.status,activeListOptions(params.options.list),params.global);const{childrenByParent,parentByChild}=await buildActiveChildrenByParent(params.pmRoot,params.settings);const matched=sortCloseManyMatchedItems(listed.items,parentByChild);const requestedIds=[...new Set(String(params.options.list?.ids??"").split(",").map(entry=>entry.trim()).filter(entry=>entry.length>0))];const existenceItems=requestedIds.length===0?[]:(await runList(void 0,{ids:requestedIds.join(","),noTruncate:true,full:true},params.global)).items;const existingIds=new Set(existenceItems.map(item=>item.id));const closePlannedIds=resolveCloseManyPlannedIds(matched,statusRegistry,force);return{pmRoot:params.pmRoot,settings:params.settings,statusRegistry,reason,validateCloseMode:params.options.validateClose,force,listed,matched,unmatchedIds:requestedIds.length===0?void 0:requestedIds.filter(id=>!existingIds.has(id)),planRows:planCloseManyRows(matched,childrenByParent,closePlannedIds,statusRegistry,force)}}function buildCloseManyDryRunResult(context){return{outcome:"effect",exit_code:EXIT_CODE.SUCCESS,mode:"dry_run",matched_count:context.matched.length,dry_run:true,...context.reason!==void 0?{reason:context.reason}:{},filters:context.listed.filters,...context.validateCloseMode?{validate_close:context.validateCloseMode}:{},item_plans:context.planRows,ids:[],...context.unmatchedIds!==void 0?{unmatched_ids:context.unmatchedIds,unmatched_count:context.unmatchedIds.length}:{}}}async function resolveCloseManyCheckpointInfo(params){if(params.options.checkpoint===false||params.closableIds.size===0){return void 0}const checkpointItems=params.context.matched.filter(item=>params.closableIds.has(item.id)).map(item=>({id:item.id,target_updated_at:item.updated_at}));return writeCloseManyCheckpoint({pmRoot:params.context.pmRoot,checkpointId:params.checkpointId,nowValue:params.nowValue,options:params.options,reason:params.context.reason,filters:params.context.listed.filters,checkpointItems})}async function runCloseMany(options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const dryRun=options.dryRun===true;const rollbackId=resolveCloseManyRollbackId(options);rejectBlankIdsFilter(options.list);if(rollbackId!==void 0){validateCloseManyRollbackOptions(options,rollbackId);return runCloseManyRollback({pmRoot,rollbackId,options,global:global2})}const context=await buildCloseManyPlanContext({pmRoot,settings,options,global:global2});if(dryRun){return buildCloseManyDryRunResult(context)}const closableIds=new Set(context.planRows.filter(row=>row.action==="close").map(row=>row.id));const nowValue=nowIso();const checkpointId=createCheckpointId(CLOSE_MANY_CHECKPOINT_SUBDIR,nowValue);const checkpointInfo=await resolveCloseManyCheckpointInfo({context,options,closableIds,checkpointId,nowValue});const closeOptions={author:options.author,message:options.message??`close-many apply ${checkpointId}`,completedAt:options.completedAt,validateClose:context.validateCloseMode,force:context.force,resolution:options.resolution,expectedResult:options.expectedResult,actualResult:options.actualResult};const{rows,closedIds}=await applyCloseManyRows({matched:context.matched,closableIds,reason:context.reason,closeOptions,global:global2});const closedCount=rows.filter(row=>row.status==="closed").length;const skippedCount=rows.filter(row=>row.status==="skipped").length;const failedCount=rows.filter(row=>row.status==="failed").length;return{...derivePmBulkMutationEffect({applied:closedCount,skipped:skippedCount,failed:failedCount,unmatched:context.unmatchedIds?.length??0}),mode:"apply",matched_count:context.matched.length,dry_run:false,...context.reason!==void 0?{reason:context.reason}:{},filters:context.listed.filters,...context.validateCloseMode?{validate_close:context.validateCloseMode}:{},...checkpointInfo?{checkpoint:checkpointInfo}:{},closed_count:closedCount,skipped_count:skippedCount,failed_count:failedCount,rows,ids:closedIds,...context.unmatchedIds!==void 0?{unmatched_ids:context.unmatchedIds,unmatched_count:context.unmatchedIds.length}:{}}}const _testOnly={activeListOptions,buildActiveChildrenByParent,hasCloseManyFilters,hasCloseManyRollbackConflicts,hierarchyDepth,rejectBlankIdsFilter,resolveReason};export{_testOnly,runCloseMany};
 //# sourceMappingURL=close-many.js.map
-//# debugId=a97a3cf0-beef-5967-8f5b-2372a6c9f2f7