@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/core/item/actionability.js

@@ -1,328 +1,2 @@
-/**
- * @module core/item/actionability
- *
- * Pure, dependency-aware actionability model shared by the `pm next` command and
- * the close-time auto-unblock sweep. It answers "what is ready to work on now?"
- * without any I/O: given a candidate set and the surrounding corpus it partitions
- * work into READY items (active, leaf, no open blockers) and BLOCKED items (active
- * leaf waiting on at least one open blocker). Keeping the logic here — rather than
- * inside a CLI command — makes it trivially testable and reusable, and gives the
- * `blocked_by` resolution a single source of truth.
- */
-
-!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]="7d98ca40-57e8-5afe-8e9d-b694da0130d1")}catch(e){}}();
-import { isTerminalStatus, normalizeStatusForRegistry } from "./status.js";
-import { BUILTIN_ITEM_EXECUTION_ROLES, resolveTypeDefinition } from "./type-registry.js";
-import { isExternalDependencyReference, isExternalDependencySourceKind, } from "./dependency-reference.js";
-/** Resolve dispatch semantics once for SDK callers, honoring custom and extension type aliases before built-in defaults. */
-export function resolveItemExecutionRole(type, registry) {
-    const definition = registry === undefined ? undefined : resolveTypeDefinition(type, registry);
-    return definition?.execution_role ?? BUILTIN_ITEM_EXECUTION_ROLES[type.trim().toLowerCase()] ?? "agent";
-}
-/** Dependency kind that marks "this item is blocked by the referenced item". */
-const BLOCKED_BY_DEPENDENCY_KIND = "blocked_by";
-/** Reverse dependency kind that marks "this item blocks the referenced item". */
-const BLOCKS_DEPENDENCY_KIND = "blocks";
-/** Built-in ordering kinds that must remain reachable by blocker resolution. */
-export const ACTIONABILITY_ORDERING_KINDS = Object.freeze([
-    BLOCKED_BY_DEPENDENCY_KIND,
-    BLOCKS_DEPENDENCY_KIND,
-]);
-/** Retired placeholder that explicitly means an item has no active blocker. */
-const NO_ACTIVE_BLOCKER_SENTINEL = "no-active-blocker";
-/**
- * Normalizes an item id / parent reference / blocker id to its canonical
- * comparison key (trimmed, lowercased). pm ids are canonically lowercase, but
- * resolving case-insensitively — as {@link collectSubtreeIds} does — keeps a
- * hand-edited mixed-case reference from being silently treated as missing.
- */
-function normalizeItemId(id) {
-    return id.trim().toLowerCase();
-}
-/** Build a collision-safe blocker key without normalizing external identity. */
-function blockerReferenceKey(id, external) {
-    return external ? `external:${id}` : `local:${normalizeItemId(id)}`;
-}
-/** Collects the blocker item ids declared by an item: the legacy scalar `blocked_by` field plus every `blocked_by` dependency edge. Ids are trimmed, de-duplicated, and returned in stable lexicographic order. This is the single source of truth for "what must close before this item can proceed", shared by `pm next` readiness classification and the close-time auto-unblock sweep. */
-export function collectBlockedByIds(item) {
-    const ids = new Map();
-    const scalar = typeof item.blocked_by === "string" ? item.blocked_by.trim() : "";
-    if (scalar.length > 0 &&
-        normalizeItemId(scalar) !== NO_ACTIVE_BLOCKER_SENTINEL) {
-        const external = isExternalDependencyReference(scalar);
-        ids.set(blockerReferenceKey(scalar, external), external ? scalar : normalizeItemId(scalar));
-    }
-    for (const dependency of item.dependencies ?? []) {
-        const dependencyId = typeof dependency.id === "string" ? dependency.id.trim() : "";
-        if (dependency.kind === BLOCKED_BY_DEPENDENCY_KIND &&
-            dependencyId.length > 0 &&
-            normalizeItemId(dependencyId) !== NO_ACTIVE_BLOCKER_SENTINEL) {
-            const external = isExternalDependencyReference(dependencyId) ||
-                isExternalDependencySourceKind(dependency.source_kind);
-            ids.set(blockerReferenceKey(dependencyId, external), external
-                ? dependencyId
-                : normalizeItemId(dependencyId));
-        }
-    }
-    return [...ids.values()].sort((left, right) => left.localeCompare(right));
-}
-/** Build every forward and reverse blocker set in one corpus pass. */
-export function indexBlockedByIds(corpus) {
-    const idsByItem = new Map();
-    for (const item of corpus) {
-        const itemId = normalizeItemId(item.id);
-        if (itemId.length === 0)
-            continue;
-        idsByItem.set(itemId, new Set(collectBlockedByIds(item)));
-    }
-    for (const candidate of corpus) {
-        const candidateId = normalizeItemId(candidate.id);
-        if (candidateId.length === 0)
-            continue;
-        for (const dependency of candidate.dependencies ?? []) {
-            const targetId = dependency.kind === BLOCKS_DEPENDENCY_KIND &&
-                typeof dependency.id === "string"
-                ? normalizeItemId(dependency.id)
-                : "";
-            if (targetId.length === 0 || targetId === NO_ACTIVE_BLOCKER_SENTINEL) {
-                continue;
-            }
-            const blockerIds = idsByItem.get(targetId) ?? new Set();
-            blockerIds.add(candidateId);
-            idsByItem.set(targetId, blockerIds);
-        }
-    }
-    return new Map([...idsByItem].map(([itemId, blockerIds]) => [
-        itemId,
-        [...blockerIds].sort((left, right) => left.localeCompare(right)),
-    ]));
-}
-/** Collect blockers from both an item's forward declarations and corpus-level reverse `blocks` edges. */
-export function collectBlockedByIdsFromCorpus(item, corpus) {
-    const itemId = normalizeItemId(item.id);
-    return itemId.length > 0
-        ? (indexBlockedByIds(corpus).get(itemId) ?? collectBlockedByIds(item))
-        : collectBlockedByIds(item);
-}
-/** Resolves an item's declared blockers against a corpus index, annotating each with the blocker's title/status and whether it still gates work. Unknown ids remain unresolved: silently treating a typo as satisfied would dispatch work whose prerequisite was never completed. Terminal referenced items alone are resolved. */
-function resolveItemBlockersWithIndex(item, itemsById, statusRegistry, blockerIdsByItem) {
-    const itemWithId = item;
-    const blockerIds = typeof itemWithId.id === "string"
-        ? (blockerIdsByItem?.get(normalizeItemId(itemWithId.id)) ??
-            collectBlockedByIdsFromCorpus(itemWithId, [
-                ...itemsById.values(),
-            ]))
-        : collectBlockedByIds(item);
-    const structuredExternalBlockerIds = new Set((item.dependencies ?? [])
-        .filter((dependency) => dependency.kind === BLOCKED_BY_DEPENDENCY_KIND &&
-        isExternalDependencySourceKind(dependency.source_kind) &&
-        typeof dependency.id === "string" &&
-        dependency.id.trim().length > 0)
-        .map((dependency) => blockerReferenceKey(dependency.id.trim(), true)));
-    return blockerIds.map((id) => {
-        if (isExternalDependencyReference(id) ||
-            structuredExternalBlockerIds.has(blockerReferenceKey(id, true))) {
-            return {
-                id,
-                title: null,
-                status: null,
-                resolved: false,
-                external: true,
-                ...(typeof item.updated_at === "string"
-                    ? { blocked_since: item.updated_at }
-                    : {}),
-                resolver: null,
-            };
-        }
-        const blocker = itemsById.get(normalizeItemId(id));
-        if (!blocker) {
-            return { id, title: null, status: null, resolved: false };
-        }
-        return {
-            id,
-            title: blocker.title,
-            status: blocker.status,
-            resolved: isTerminalStatus(blocker.status, statusRegistry),
-        };
-    });
-}
-/** Resolves an item's blockers against a corpus index with reverse `blocks` support. */
-export function resolveItemBlockers(item, itemsById, statusRegistry) {
-    return resolveItemBlockersWithIndex(item, itemsById, statusRegistry);
-}
-/**
- * Collects the normalized (trimmed, lowercased) ids of every corpus item that is
- * blocked under the single shared edge-aware definition: a non-terminal item
- * whose lifecycle status is a blocked status OR that has at least one open
- * blocker (a `blocked_by` reference whose target is non-terminal or unknown).
- *
- * This is the one source of truth GH-578 mandates across read surfaces —
- * `pm next`'s blocked companion, `pm context` summary counters, and
- * `pm list-blocked` all derive blocked-ness from this set so they can never
- * silently disagree while auto-unblock keeps status-blocked items rare.
- */
-export function collectDependencyBlockedIds(corpus, statusRegistry) {
-    const itemsById = new Map(corpus.map((item) => [normalizeItemId(item.id), item]));
-    const blockerIdsByItem = indexBlockedByIds(corpus);
-    // Same candidate gate as computeActionabilityReport: active statuses plus
-    // lifecycle-blocked statuses, so the two surfaces classify identically.
-    const candidateStatuses = new Set([
-        ...resolveActiveStatusSet(statusRegistry),
-        ...statusRegistry.blocked_statuses,
-    ]);
-    const blocked = new Set();
-    for (const item of corpus) {
-        const normalizedStatus = normalizeStatusForRegistry(item.status, statusRegistry);
-        if (!candidateStatuses.has(normalizedStatus))
-            continue;
-        const lifecycleBlocked = statusRegistry.blocked_statuses.has(normalizedStatus);
-        if (lifecycleBlocked ||
-            resolveItemBlockersWithIndex(item, itemsById, statusRegistry, blockerIdsByItem).some((blocker) => !blocker.resolved)) {
-            blocked.add(normalizeItemId(item.id));
-        }
-    }
-    return blocked;
-}
-/** Select dispatch candidates from a classified report while retaining held-out worklists. Ownership and ranking remain caller responsibilities. */
-export function selectActionableEntries(report, statusRegistry, options = {}, typeRegistry) {
-    const candidates = [...report.ready, ...report.decisions, ...report.gates];
-    if (options.includeContainers === true) {
-        candidates.push(...report.containers.filter((entry) => entry.open_blockers.length === 0 && !statusRegistry.blocked_statuses.has(normalizeStatusForRegistry(entry.item.status, statusRegistry))));
-    }
-    const selected = { ready: [], decisions: [], gates: [] };
-    for (const entry of candidates) {
-        const role = resolveItemExecutionRole(entry.item.type, typeRegistry);
-        if (role === "human" && options.includeDecisions !== true)
-            selected.decisions.push(entry);
-        else if (role === "gate" && options.includeGates !== true)
-            selected.gates.push(entry);
-        else
-            selected.ready.push(entry);
-    }
-    return selected;
-}
-/** Resolves the registry's active status set, falling back to just the canonical open status when a custom schema declares none — the same safety net `pm context` applies so the report never misclassifies every item as inactive. */
-function resolveActiveStatusSet(statusRegistry) {
-    /* c8 ignore start -- fallback applies only to custom schemas that intentionally define zero active statuses */
-    return statusRegistry.active_statuses.size > 0
-        ? statusRegistry.active_statuses
-        : new Set([statusRegistry.open_status]);
-    /* c8 ignore stop */
-}
-/** Returns whether an item has any non-terminal descendant by walking the parent→children index depth-first, short-circuiting on the first one found. Such an item is a container (its real work lives in its children), so `pm next` skips it and recommends a leaf instead. Cycle-safe via a visited set. */
-function hasOpenDescendant(rootId, childrenByParent, statusRegistry) {
-    const stack = [normalizeItemId(rootId)];
-    const visited = new Set();
-    while (stack.length > 0) {
-        const current = stack.pop();
-        /* c8 ignore start -- defensive cycle-guard: unreachable for active roots (an open child returns before any node is revisited, and single-parent graphs cannot form a root-reachable cycle excluding the root), retained for safety */
-        if (visited.has(current))
-            continue;
-        /* c8 ignore stop */
-        visited.add(current);
-        for (const child of childrenByParent.get(current) ?? []) {
-            if (!isTerminalStatus(child.status, statusRegistry)) {
-                return true;
-            }
-            stack.push(normalizeItemId(child.id));
-        }
-    }
-    return false;
-}
-/** Indexes the corpus into a by-id map, a parent→children map, and a reverse blocker map (blocker id → ids of items it blocks). Built once per report so blocker resolution, descendant counting, and downstream "unblocks" lookups share the same passes over the corpus. */
-function indexCorpus(corpus) {
-    const itemsById = new Map();
-    const childrenByParent = new Map();
-    const blockedByReverse = new Map();
-    const blockerIdsByItem = indexBlockedByIds(corpus);
-    for (const item of corpus) {
-        // Index keys are normalized (lowercased) for case-insensitive resolution;
-        // stored values keep the item's original-case id for display.
-        itemsById.set(normalizeItemId(item.id), item);
-        const parent = typeof item.parent === "string" ? item.parent.trim() : "";
-        if (parent.length > 0) {
-            const parentKey = normalizeItemId(parent);
-            const siblings = childrenByParent.get(parentKey) ?? [];
-            siblings.push(item);
-            childrenByParent.set(parentKey, siblings);
-        }
-        for (const blockerId of blockerIdsByItem.get(normalizeItemId(item.id))) {
-            const blockerKey = normalizeItemId(blockerId);
-            const dependents = blockedByReverse.get(blockerKey) ?? [];
-            dependents.push(item.id);
-            blockedByReverse.set(blockerKey, dependents);
-        }
-    }
-    return { itemsById, childrenByParent, blockedByReverse, blockerIdsByItem };
-}
-/**
- * Partitions a candidate set into ready vs blocked leaf work using the corpus to
- * resolve blockers, descendants, and downstream dependents.
- *
- * An item qualifies when its status is active. Containers — items with at least
- * one non-terminal descendant — are excluded from both lists because the real
- * work is the leaf beneath them. A leaf with no open blockers is READY; a leaf
- * with one or more open blockers is BLOCKED, annotated with the unresolved
- * blockers and the non-terminal items it would unblock. Returned lists preserve
- * the candidate order so the caller can apply its own ranking.
- */
-export function computeActionabilityReport(candidates, corpus, statusRegistry, typeRegistry) {
-    const { itemsById, childrenByParent, blockedByReverse, blockerIdsByItem } = indexCorpus(corpus);
-    const activeStatuses = new Set([
-        ...resolveActiveStatusSet(statusRegistry),
-        ...statusRegistry.blocked_statuses,
-    ]);
-    // Ids of corpus items still in flight, used to keep only the non-terminal
-    // dependents in each item's downstream "unblocks" list.
-    const nonTerminalIds = new Set(corpus
-        .filter((entry) => !isTerminalStatus(entry.status, statusRegistry))
-        .map((entry) => normalizeItemId(entry.id)));
-    const ready = [];
-    const blocked = [];
-    const containers = [];
-    const decisions = [];
-    const gates = [];
-    let activeCount = 0;
-    for (const item of candidates) {
-        if (!activeStatuses.has(normalizeStatusForRegistry(item.status, statusRegistry)))
-            continue;
-        activeCount += 1;
-        const openBlockers = resolveItemBlockersWithIndex(item, itemsById, statusRegistry, blockerIdsByItem).filter((blocker) => !blocker.resolved);
-        const unblocks = (blockedByReverse.get(normalizeItemId(item.id)) ?? [])
-            .filter((dependentId) => nonTerminalIds.has(normalizeItemId(dependentId)))
-            .sort((left, right) => left.localeCompare(right));
-        const entry = {
-            item,
-            open_blockers: openBlockers,
-            unblocks,
-        };
-        if (hasOpenDescendant(item.id, childrenByParent, statusRegistry)) {
-            containers.push(entry);
-            continue;
-        }
-        const lifecycleBlocked = statusRegistry.blocked_statuses.has(normalizeStatusForRegistry(item.status, statusRegistry));
-        if (openBlockers.length === 0 && !lifecycleBlocked) {
-            const role = resolveItemExecutionRole(item.type, typeRegistry);
-            if (role === "human")
-                decisions.push(entry);
-            else if (role === "gate")
-                gates.push(entry);
-            else
-                ready.push(entry);
-        }
-        else {
-            blocked.push(entry);
-        }
-    }
-    return {
-        ready,
-        blocked,
-        containers,
-        decisions,
-        gates,
-        active_count: activeCount,
-        container_count: containers.length,
-    };
-}
+!(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]="59b12366-2f29-5acb-8196-91e9ab183666")}catch(e2){}})();import{isTerminalStatus,normalizeStatusForRegistry}from"./status.js";import{BUILTIN_ITEM_EXECUTION_ROLES,resolveTypeDefinition}from"./type-registry.js";import{isExternalDependencyReference,isExternalDependencySourceKind}from"./dependency-reference.js";function resolveItemExecutionRole(type,registry){const definition=registry===void 0?void 0:resolveTypeDefinition(type,registry);return definition?.execution_role??BUILTIN_ITEM_EXECUTION_ROLES[type.trim().toLowerCase()]??"agent"}const BLOCKED_BY_DEPENDENCY_KIND="blocked_by";const BLOCKS_DEPENDENCY_KIND="blocks";const ACTIONABILITY_ORDERING_KINDS=Object.freeze([BLOCKED_BY_DEPENDENCY_KIND,BLOCKS_DEPENDENCY_KIND]);const NO_ACTIVE_BLOCKER_SENTINEL="no-active-blocker";function normalizeItemId(id){return id.trim().toLowerCase()}function blockerReferenceKey(id,external){return external?`external:${id}`:`local:${normalizeItemId(id)}`}function collectBlockedByIds(item){const ids=new Map;const scalar=typeof item.blocked_by==="string"?item.blocked_by.trim():"";if(scalar.length>0&&normalizeItemId(scalar)!==NO_ACTIVE_BLOCKER_SENTINEL){const external=isExternalDependencyReference(scalar);ids.set(blockerReferenceKey(scalar,external),external?scalar:normalizeItemId(scalar))}for(const dependency of item.dependencies??[]){const dependencyId=typeof dependency.id==="string"?dependency.id.trim():"";if(dependency.kind===BLOCKED_BY_DEPENDENCY_KIND&&dependencyId.length>0&&normalizeItemId(dependencyId)!==NO_ACTIVE_BLOCKER_SENTINEL){const external=isExternalDependencyReference(dependencyId)||isExternalDependencySourceKind(dependency.source_kind);ids.set(blockerReferenceKey(dependencyId,external),external?dependencyId:normalizeItemId(dependencyId))}}return[...ids.values()].sort((left,right)=>left.localeCompare(right))}function indexBlockedByIds(corpus){const idsByItem=new Map;for(const item of corpus){const itemId=normalizeItemId(item.id);if(itemId.length===0)continue;idsByItem.set(itemId,new Set(collectBlockedByIds(item)))}for(const candidate of corpus){const candidateId=normalizeItemId(candidate.id);if(candidateId.length===0)continue;for(const dependency of candidate.dependencies??[]){const targetId=dependency.kind===BLOCKS_DEPENDENCY_KIND&&typeof dependency.id==="string"?normalizeItemId(dependency.id):"";if(targetId.length===0||targetId===NO_ACTIVE_BLOCKER_SENTINEL){continue}const blockerIds=idsByItem.get(targetId)??new Set;blockerIds.add(candidateId);idsByItem.set(targetId,blockerIds)}}return new Map([...idsByItem].map(([itemId,blockerIds])=>[itemId,[...blockerIds].sort((left,right)=>left.localeCompare(right))]))}function collectBlockedByIdsFromCorpus(item,corpus){const itemId=normalizeItemId(item.id);return itemId.length>0?indexBlockedByIds(corpus).get(itemId)??collectBlockedByIds(item):collectBlockedByIds(item)}function resolveItemBlockersWithIndex(item,itemsById,statusRegistry,blockerIdsByItem){const itemWithId=item;const blockerIds=typeof itemWithId.id==="string"?blockerIdsByItem?.get(normalizeItemId(itemWithId.id))??collectBlockedByIdsFromCorpus(itemWithId,[...itemsById.values()]):collectBlockedByIds(item);const structuredExternalBlockerIds=new Set((item.dependencies??[]).filter(dependency=>dependency.kind===BLOCKED_BY_DEPENDENCY_KIND&&isExternalDependencySourceKind(dependency.source_kind)&&typeof dependency.id==="string"&&dependency.id.trim().length>0).map(dependency=>blockerReferenceKey(dependency.id.trim(),true)));return blockerIds.map(id=>{if(isExternalDependencyReference(id)||structuredExternalBlockerIds.has(blockerReferenceKey(id,true))){return{id,title:null,status:null,resolved:false,external:true,...typeof item.updated_at==="string"?{blocked_since:item.updated_at}:{},resolver:null}}const blocker=itemsById.get(normalizeItemId(id));if(!blocker){return{id,title:null,status:null,resolved:false}}return{id,title:blocker.title,status:blocker.status,resolved:isTerminalStatus(blocker.status,statusRegistry)}})}function resolveItemBlockers(item,itemsById,statusRegistry){return resolveItemBlockersWithIndex(item,itemsById,statusRegistry)}function collectDependencyBlockedIds(corpus,statusRegistry){const itemsById=new Map(corpus.map(item=>[normalizeItemId(item.id),item]));const blockerIdsByItem=indexBlockedByIds(corpus);const candidateStatuses=new Set([...resolveActiveStatusSet(statusRegistry),...statusRegistry.blocked_statuses]);const blocked=new Set;for(const item of corpus){const normalizedStatus=normalizeStatusForRegistry(item.status,statusRegistry);if(!candidateStatuses.has(normalizedStatus))continue;const lifecycleBlocked=statusRegistry.blocked_statuses.has(normalizedStatus);if(lifecycleBlocked||resolveItemBlockersWithIndex(item,itemsById,statusRegistry,blockerIdsByItem).some(blocker=>!blocker.resolved)){blocked.add(normalizeItemId(item.id))}}return blocked}function selectActionableEntries(report,statusRegistry,options={},typeRegistry){const candidates=[...report.ready,...report.decisions,...report.gates];if(options.includeContainers===true){candidates.push(...report.containers.filter(entry=>entry.open_blockers.length===0&&!statusRegistry.blocked_statuses.has(normalizeStatusForRegistry(entry.item.status,statusRegistry))))}const selected={ready:[],decisions:[],gates:[]};for(const entry of candidates){const role=resolveItemExecutionRole(entry.item.type,typeRegistry);if(role==="human"&&options.includeDecisions!==true)selected.decisions.push(entry);else if(role==="gate"&&options.includeGates!==true)selected.gates.push(entry);else selected.ready.push(entry)}return selected}function resolveActiveStatusSet(statusRegistry){return statusRegistry.active_statuses.size>0?statusRegistry.active_statuses:new Set([statusRegistry.open_status])}function hasOpenDescendant(rootId,childrenByParent,statusRegistry){const stack=[normalizeItemId(rootId)];const visited=new Set;while(stack.length>0){const current=stack.pop();if(visited.has(current))continue;visited.add(current);for(const child of childrenByParent.get(current)??[]){if(!isTerminalStatus(child.status,statusRegistry)){return true}stack.push(normalizeItemId(child.id))}}return false}function indexCorpus(corpus){const itemsById=new Map;const childrenByParent=new Map;const blockedByReverse=new Map;const blockerIdsByItem=indexBlockedByIds(corpus);for(const item of corpus){itemsById.set(normalizeItemId(item.id),item);const parent=typeof item.parent==="string"?item.parent.trim():"";if(parent.length>0){const parentKey=normalizeItemId(parent);const siblings=childrenByParent.get(parentKey)??[];siblings.push(item);childrenByParent.set(parentKey,siblings)}for(const blockerId of blockerIdsByItem.get(normalizeItemId(item.id))){const blockerKey=normalizeItemId(blockerId);const dependents=blockedByReverse.get(blockerKey)??[];dependents.push(item.id);blockedByReverse.set(blockerKey,dependents)}}return{itemsById,childrenByParent,blockedByReverse,blockerIdsByItem}}function computeActionabilityReport(candidates,corpus,statusRegistry,typeRegistry){const{itemsById,childrenByParent,blockedByReverse,blockerIdsByItem}=indexCorpus(corpus);const activeStatuses=new Set([...resolveActiveStatusSet(statusRegistry),...statusRegistry.blocked_statuses]);const nonTerminalIds=new Set(corpus.filter(entry=>!isTerminalStatus(entry.status,statusRegistry)).map(entry=>normalizeItemId(entry.id)));const ready=[];const blocked=[];const containers=[];const decisions=[];const gates=[];let activeCount=0;for(const item of candidates){if(!activeStatuses.has(normalizeStatusForRegistry(item.status,statusRegistry)))continue;activeCount+=1;const openBlockers=resolveItemBlockersWithIndex(item,itemsById,statusRegistry,blockerIdsByItem).filter(blocker=>!blocker.resolved);const unblocks=(blockedByReverse.get(normalizeItemId(item.id))??[]).filter(dependentId=>nonTerminalIds.has(normalizeItemId(dependentId))).sort((left,right)=>left.localeCompare(right));const entry={item,open_blockers:openBlockers,unblocks};if(hasOpenDescendant(item.id,childrenByParent,statusRegistry)){containers.push(entry);continue}const lifecycleBlocked=statusRegistry.blocked_statuses.has(normalizeStatusForRegistry(item.status,statusRegistry));if(openBlockers.length===0&&!lifecycleBlocked){const role=resolveItemExecutionRole(item.type,typeRegistry);if(role==="human")decisions.push(entry);else if(role==="gate")gates.push(entry);else ready.push(entry)}else{blocked.push(entry)}}return{ready,blocked,containers,decisions,gates,active_count:activeCount,container_count:containers.length}}export{ACTIONABILITY_ORDERING_KINDS,collectBlockedByIds,collectBlockedByIdsFromCorpus,collectDependencyBlockedIds,computeActionabilityReport,indexBlockedByIds,resolveItemBlockers,resolveItemExecutionRole,selectActionableEntries};
 //# sourceMappingURL=actionability.js.map
-//# debugId=7d98ca40-57e8-5afe-8e9d-b694da0130d1

package/dist/core/item/dependency-reference.js

@@ -1,21 +1,2 @@
-/**
- * @module core/item/dependency-reference
- *
- * Classifies dependency locators that intentionally resolve outside the local
- * tracker so scheduling and graph governance do not confuse them with typos.
- */
-/** Return whether a dependency target is an explicit cross-system locator rather than a local pm item id. */
-
-!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]="971d929f-12be-5648-93c9-8a9878b40dde")}catch(e){}}();
-export function isExternalDependencyReference(target) {
-    const normalized = target?.trim() ?? "";
-    return (/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(normalized) ||
-        /^(?:github|gitlab|jira|linear):/iu.test(normalized));
-}
-/** Return whether dependency provenance explicitly places a target outside the local workspace. */
-export function isExternalDependencySourceKind(sourceKind) {
-    const normalized = sourceKind?.trim().toLowerCase();
-    return normalized === "global" || normalized === "external";
-}
+!(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]="e216fd39-09ee-5a04-b0b5-44f518db4f93")}catch(e2){}})();function isExternalDependencyReference(target){const normalized=target?.trim()??"";return/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(normalized)||/^(?:github|gitlab|jira|linear):/iu.test(normalized)}function isExternalDependencySourceKind(sourceKind){const normalized=sourceKind?.trim().toLowerCase();return normalized==="global"||normalized==="external"}export{isExternalDependencyReference,isExternalDependencySourceKind};
 //# sourceMappingURL=dependency-reference.js.map
-//# debugId=971d929f-12be-5648-93c9-8a9878b40dde

package/dist/core/item/id.js

@@ -1,113 +1,2 @@
-/**
- * @module core/item/id
- *
- * Defines item parsing, formatting, and lifecycle helpers for Id.
- */
-
-!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]="04f02467-a4ee-5616-9fbf-3df1141efccf")}catch(e){}}();
-import crypto from "node:crypto";
-import path from "node:path";
-import { TYPE_TO_FOLDER } from "../shared/constants.js";
-import { pathExists } from "../fs/fs-utils.js";
-import { nextReproducibleToken } from "../reproducibility/context.js";
-/** Implements normalize prefix for the public runtime surface of this module. */
-export function normalizePrefix(input) {
-    const normalized = [];
-    let separatorPending = false;
-    for (const character of (input ?? "").toLowerCase()) {
-        const codePoint = character.charCodeAt(0);
-        const isAsciiDigit = codePoint >= 48 && codePoint <= 57;
-        const isAsciiLetter = codePoint >= 97 && codePoint <= 122;
-        if (!isAsciiDigit && !isAsciiLetter) {
-            separatorPending = normalized.length > 0;
-            continue;
-        }
-        if (separatorPending) {
-            normalized.push("-");
-            separatorPending = false;
-        }
-        normalized.push(character);
-    }
-    if (normalized.length === 0)
-        return "pm-";
-    return `${normalized.join("")}-`;
-}
-/** Implements normalize raw item id for the public runtime surface of this module. */
-export function normalizeRawItemId(input) {
-    let normalized = input.trim().toLowerCase();
-    if (normalized.startsWith("#")) {
-        normalized = normalized.slice(1);
-    }
-    return normalized;
-}
-/** Implements normalize item id for the public runtime surface of this module. */
-export function normalizeItemId(input, prefix) {
-    const canonicalPrefix = normalizePrefix(prefix);
-    const normalized = normalizeRawItemId(input);
-    if (normalized.startsWith(canonicalPrefix)) {
-        return normalized;
-    }
-    return `${canonicalPrefix}${normalized}`;
-}
-function randomToken(length) {
-    const reproducibleToken = nextReproducibleToken(length);
-    if (reproducibleToken !== undefined) {
-        return reproducibleToken;
-    }
-    let token = "";
-    for (let index = 0; index < length; index += 1) {
-        token += crypto.randomInt(0, 36).toString(36);
-    }
-    return token;
-}
-/** Reserve an identity when either a live item path or its retained history exists. */
-async function idExists(pmRoot, id, typeToFolder) {
-    const checks = [...new Set(Object.values(typeToFolder))].flatMap((folder) => [
-        path.join(pmRoot, folder, `${id}.md`),
-        path.join(pmRoot, folder, `${id}.toon`),
-    ]);
-    checks.push(path.join(pmRoot, "history", `${id}.jsonl`));
-    return (await Promise.all(checks.map((target) => pathExists(target)))).some(Boolean);
-}
-/** Bounds accepted for the configurable random id token length (`ids.token_length`). */
-export const ID_TOKEN_LENGTH_MIN = 4;
-/** Upper bound for `ids.token_length`; longer tokens stop improving ergonomics without meaningfully improving uniqueness. */
-export const ID_TOKEN_LENGTH_MAX = 12;
-/** Clamp a configured id token length into the supported bounds, falling back to the 4-character default for non-finite input. */
-export function clampIdTokenLength(value) {
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        return ID_TOKEN_LENGTH_MIN;
-    }
-    return Math.min(ID_TOKEN_LENGTH_MAX, Math.max(ID_TOKEN_LENGTH_MIN, Math.trunc(value)));
-}
-/**
- * Mint a new item id as `<prefix><random base36 token>`. The starting token
- * length comes from the workspace `ids.token_length` setting (default 4) and
- * escalates automatically when the local uniqueness probe keeps colliding.
- * Uniqueness is only verifiable against the local working tree: concurrent
- * branches can still mint the same id independently, which is why longer
- * configured tokens matter for multi-agent workflows and why
- * `pm validate --check-storage-integrity` detects post-merge duplicate-id
- * collisions (GH-600).
- */
-export async function generateItemId(pmRoot, prefix, options = {}) {
-    let tokenLength = clampIdTokenLength(options.tokenLength);
-    const maxTokenLength = Math.min(tokenLength + 6, ID_TOKEN_LENGTH_MAX);
-    let attempts = 0;
-    while (tokenLength <= maxTokenLength) {
-        for (let i = 0; i < 32; i += 1) {
-            const id = `${normalizePrefix(prefix)}${randomToken(tokenLength)}`;
-            const occupied = await (options.probeExisting === false
-                ? pathExists(path.join(pmRoot, "history", `${id}.jsonl`))
-                : idExists(pmRoot, id, options.typeToFolder ?? TYPE_TO_FOLDER));
-            if (!occupied) {
-                return id;
-            }
-            attempts += 1;
-        }
-        tokenLength += 1;
-    }
-    throw new Error(`Unable to generate unique id after ${attempts} attempts`);
-}
+!(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]="72c5a2e2-4e90-587d-a461-946b4836e447")}catch(e2){}})();import crypto from"node:crypto";import path from"node:path";import{TYPE_TO_FOLDER}from"../shared/constants.js";import{pathExists}from"../fs/fs-utils.js";import{nextReproducibleToken}from"../reproducibility/context.js";function normalizePrefix(input){const normalized=[];let separatorPending=false;for(const character of(input??"").toLowerCase()){const codePoint=character.charCodeAt(0);const isAsciiDigit=codePoint>=48&&codePoint<=57;const isAsciiLetter=codePoint>=97&&codePoint<=122;if(!isAsciiDigit&&!isAsciiLetter){separatorPending=normalized.length>0;continue}if(separatorPending){normalized.push("-");separatorPending=false}normalized.push(character)}if(normalized.length===0)return"pm-";return`${normalized.join("")}-`}function normalizeRawItemId(input){let normalized=input.trim().toLowerCase();if(normalized.startsWith("#")){normalized=normalized.slice(1)}return normalized}function normalizeItemId(input,prefix){const canonicalPrefix=normalizePrefix(prefix);const normalized=normalizeRawItemId(input);if(normalized.startsWith(canonicalPrefix)){return normalized}return`${canonicalPrefix}${normalized}`}function randomToken(length){const reproducibleToken=nextReproducibleToken(length);if(reproducibleToken!==void 0){return reproducibleToken}let token="";for(let index=0;index<length;index+=1){token+=crypto.randomInt(0,36).toString(36)}return token}async function idExists(pmRoot,id,typeToFolder){const checks=[...new Set(Object.values(typeToFolder))].flatMap(folder=>[path.join(pmRoot,folder,`${id}.md`),path.join(pmRoot,folder,`${id}.toon`)]);checks.push(path.join(pmRoot,"history",`${id}.jsonl`));return(await Promise.all(checks.map(target=>pathExists(target)))).some(Boolean)}const ID_TOKEN_LENGTH_MIN=4;const ID_TOKEN_LENGTH_MAX=12;function clampIdTokenLength(value){if(typeof value!=="number"||!Number.isFinite(value)){return ID_TOKEN_LENGTH_MIN}return Math.min(ID_TOKEN_LENGTH_MAX,Math.max(ID_TOKEN_LENGTH_MIN,Math.trunc(value)))}async function generateItemId(pmRoot,prefix,options={}){let tokenLength=clampIdTokenLength(options.tokenLength);const maxTokenLength=Math.min(tokenLength+6,ID_TOKEN_LENGTH_MAX);let attempts=0;while(tokenLength<=maxTokenLength){for(let i=0;i<32;i+=1){const id=`${normalizePrefix(prefix)}${randomToken(tokenLength)}`;const occupied=await(options.probeExisting===false?pathExists(path.join(pmRoot,"history",`${id}.jsonl`)):idExists(pmRoot,id,options.typeToFolder??TYPE_TO_FOLDER));if(!occupied){return id}attempts+=1}tokenLength+=1}throw new Error(`Unable to generate unique id after ${attempts} attempts`)}export{ID_TOKEN_LENGTH_MAX,ID_TOKEN_LENGTH_MIN,clampIdTokenLength,generateItemId,normalizeItemId,normalizePrefix,normalizeRawItemId};
 //# sourceMappingURL=id.js.map
-//# debugId=04f02467-a4ee-5616-9fbf-3df1141efccf

package/dist/core/item/index.js

@@ -1,13 +1,2 @@
-/**
- * @module core/item/index
- *
- * Defines item parsing, formatting, and lifecycle helpers for Index.
- */
-
-!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]="ca323f6d-ff60-592d-9a43-98102b78736b")}catch(e){}}();
-export * from "./id.js";
-export * from "./item-format.js";
-export * from "./parse.js";
-export * from "./type-registry.js";
+!(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]="af340813-f1da-5d0d-9ad6-f4be63a6c96f")}catch(e2){}})();export*from"./id.js";export*from"./item-format.js";export*from"./parse.js";export*from"./type-registry.js";
 //# sourceMappingURL=index.js.map
-//# debugId=ca323f6d-ff60-592d-9a43-98102b78736b

package/dist/core/item/item-format-version.js

@@ -1,79 +1,2 @@
-/** The original (and implicit) item-metadata format version. Items missing a `pm_format_version` field are always treated as this version, so the baseline is never written to disk and adds no per-item token cost. */
-
-!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]="77d3ebfa-789a-54cf-9d49-dbebab8d32ea")}catch(e){}}();
-export const BASELINE_ITEM_FORMAT_VERSION = 1;
-/**
- * The format version this runtime writes and considers current. When a breaking
- * item-metadata change ships, bump this constant and add a migration that
- * rewrites items whose {@link effectiveItemFormatVersion} is lower; items at or
- * above it need no migration. It stays equal to
- * {@link BASELINE_ITEM_FORMAT_VERSION} until the first such change.
- */
-export const CURRENT_ITEM_FORMAT_VERSION = 1;
-/**
- * Resolve the format version an item is effectively stored at. A present,
- * positive-integer `pm_format_version` is taken verbatim (including versions
- * ahead of this runtime, so they can be flagged rather than silently clamped);
- * an absent, malformed, or sub-baseline value resolves to
- * {@link BASELINE_ITEM_FORMAT_VERSION}.
- */
-export function effectiveItemFormatVersion(metadata) {
-    const raw = metadata.pm_format_version;
-    if (typeof raw === "number" &&
-        Number.isInteger(raw) &&
-        raw >= BASELINE_ITEM_FORMAT_VERSION) {
-        return raw;
-    }
-    return BASELINE_ITEM_FORMAT_VERSION;
-}
-/**
- * Reduce an item's `pm_format_version` to its persisted form: the baseline
- * version (and any malformed or sub-baseline value) is dropped so it is never
- * serialized, while versions at or above {@link BASELINE_ITEM_FORMAT_VERSION}
- * plus one are preserved verbatim. This keeps the field absent for the entire
- * current corpus and only writes it once an item genuinely advances past the
- * implicit baseline.
- */
-export function normalizeItemFormatVersion(value) {
-    if (typeof value !== "number" ||
-        !Number.isInteger(value) ||
-        value <= BASELINE_ITEM_FORMAT_VERSION) {
-        return undefined;
-    }
-    return value;
-}
-/**
- * Classify a single stored format version against the runtime's current
- * version. Defaults to {@link CURRENT_ITEM_FORMAT_VERSION}; the `current`
- * parameter exists so callers (and tests) can evaluate against a hypothetical
- * future version without mutating the module constant.
- */
-export function classifyItemFormatVersion(version, current = CURRENT_ITEM_FORMAT_VERSION) {
-    if (version < current) {
-        return "outdated";
-    }
-    if (version > current) {
-        return "ahead";
-    }
-    return "current";
-}
-/** Partition a set of items by format version into `outdated` (need migration) and `ahead` (written by a newer pm) reference lists, each sorted for stable diagnostics. Pushing all comparison branches into this pure, exhaustively tested helper lets `pm health` and `pm validate` emit findings by iterating the result lists, with no version-comparison branching of their own. */
-export function scanItemFormatVersions(entries, current = CURRENT_ITEM_FORMAT_VERSION) {
-    const outdated = [];
-    const ahead = [];
-    for (const entry of entries) {
-        const status = classifyItemFormatVersion(entry.version, current);
-        if (status === "outdated") {
-            outdated.push(entry.ref);
-        }
-        else if (status === "ahead") {
-            ahead.push(entry.ref);
-        }
-    }
-    return {
-        outdated: outdated.sort((left, right) => left.localeCompare(right)),
-        ahead: ahead.sort((left, right) => left.localeCompare(right)),
-    };
-}
+!(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]="8ee74259-29b1-5795-9253-9fa0869e4585")}catch(e2){}})();const BASELINE_ITEM_FORMAT_VERSION=1;const CURRENT_ITEM_FORMAT_VERSION=1;function effectiveItemFormatVersion(metadata){const raw=metadata.pm_format_version;if(typeof raw==="number"&&Number.isInteger(raw)&&raw>=BASELINE_ITEM_FORMAT_VERSION){return raw}return BASELINE_ITEM_FORMAT_VERSION}function normalizeItemFormatVersion(value){if(typeof value!=="number"||!Number.isInteger(value)||value<=BASELINE_ITEM_FORMAT_VERSION){return void 0}return value}function classifyItemFormatVersion(version,current=CURRENT_ITEM_FORMAT_VERSION){if(version<current){return"outdated"}if(version>current){return"ahead"}return"current"}function scanItemFormatVersions(entries,current=CURRENT_ITEM_FORMAT_VERSION){const outdated=[];const ahead=[];for(const entry of entries){const status=classifyItemFormatVersion(entry.version,current);if(status==="outdated"){outdated.push(entry.ref)}else if(status==="ahead"){ahead.push(entry.ref)}}return{outdated:outdated.sort((left,right)=>left.localeCompare(right)),ahead:ahead.sort((left,right)=>left.localeCompare(right))}}export{BASELINE_ITEM_FORMAT_VERSION,CURRENT_ITEM_FORMAT_VERSION,classifyItemFormatVersion,effectiveItemFormatVersion,normalizeItemFormatVersion,scanItemFormatVersions};
 //# sourceMappingURL=item-format-version.js.map
-//# debugId=77d3ebfa-789a-54cf-9d49-dbebab8d32ea