@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/query/multi-value-filters.js

@@ -1,79 +1,2 @@
-/**
- * @module sdk/query/multi-value-filters
- *
- * Provides reusable, presentation-neutral parsing for OR-composed query filters.
- */
-
-!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]="1035bd62-b012-5249-bd53-31b39f21b2d3")}catch(e){}}();
-import { resolveTypeName } from "../../core/item/type-registry.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { parsePriority } from "./parsers.js";
-/**
- * Parses a comma-separated OR filter while supporting `\,` for a literal comma
- * and `\\` for a literal backslash. Empty values are rejected so scripts fail
- * before loading tracker data instead of silently matching an unintended scope.
- */
-export function parseMultiValueFilter(raw, options) {
-    if (raw === undefined) {
-        return undefined;
-    }
-    const decoded = [];
-    let current = "";
-    for (let index = 0; index < raw.length; index += 1) {
-        const character = raw[index];
-        if (character === "\\") {
-            const next = raw[index + 1];
-            if (next === "," || next === "\\") {
-                current += next;
-                index += 1;
-                continue;
-            }
-            current += character;
-            continue;
-        }
-        if (character === ",") {
-            decoded.push(current);
-            current = "";
-            continue;
-        }
-        current += character;
-    }
-    decoded.push(current);
-    const values = decoded.map((value) => value.trim());
-    if (values.some((value) => value.length === 0)) {
-        throw new PmCliError(`${options.label} requires at least one non-empty value`, EXIT_CODE.USAGE);
-    }
-    const normalized = values.map((value) => options.normalize?.(value) ?? value);
-    return [...new Set(normalized)];
-}
-/** Parses a free-form string OR filter into a membership set. */
-export function parseStringFilterSet(raw, options) {
-    const values = parseMultiValueFilter(raw, options);
-    return values === undefined ? undefined : new Set(values);
-}
-/** Resolves every requested type token through the active runtime type registry. */
-export function parseTypeFilterSet(raw, typeRegistry, label = "--type") {
-    const values = parseMultiValueFilter(raw, { label });
-    if (values === undefined) {
-        return undefined;
-    }
-    const resolved = values.map((value) => {
-        const type = resolveTypeName(value, typeRegistry);
-        if (!type) {
-            throw new PmCliError(`${label} filter token "${value}" must be one of ${typeRegistry.types.join("|")}`, EXIT_CODE.USAGE);
-        }
-        return type;
-    });
-    return new Set(resolved);
-}
-/** Validates every requested priority token and returns its numeric membership set. */
-export function parsePriorityFilterSet(raw, label = "--priority") {
-    const values = parseMultiValueFilter(raw, { label });
-    if (values === undefined) {
-        return undefined;
-    }
-    return new Set(values.map((value) => parsePriority(value, label)));
-}
+!(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]="b03f0596-8c1f-59ec-a20e-8919cf8bbb98")}catch(e2){}})();import{resolveTypeName}from"../../core/item/type-registry.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{parsePriority}from"./parsers.js";function parseMultiValueFilter(raw,options){if(raw===void 0){return void 0}const decoded=[];let current="";for(let index=0;index<raw.length;index+=1){const character=raw[index];if(character==="\\"){const next=raw[index+1];if(next===","||next==="\\"){current+=next;index+=1;continue}current+=character;continue}if(character===","){decoded.push(current);current="";continue}current+=character}decoded.push(current);const values=decoded.map(value=>value.trim());if(values.some(value=>value.length===0)){throw new PmCliError(`${options.label} requires at least one non-empty value`,EXIT_CODE.USAGE)}const normalized=values.map(value=>options.normalize?.(value)??value);return[...new Set(normalized)]}function parseStringFilterSet(raw,options){const values=parseMultiValueFilter(raw,options);return values===void 0?void 0:new Set(values)}function parseTypeFilterSet(raw,typeRegistry,label="--type"){const values=parseMultiValueFilter(raw,{label});if(values===void 0){return void 0}const resolved=values.map(value=>{const type=resolveTypeName(value,typeRegistry);if(!type){throw new PmCliError(`${label} filter token "${value}" must be one of ${typeRegistry.types.join("|")}`,EXIT_CODE.USAGE)}return type});return new Set(resolved)}function parsePriorityFilterSet(raw,label="--priority"){const values=parseMultiValueFilter(raw,{label});if(values===void 0){return void 0}return new Set(values.map(value=>parsePriority(value,label)))}export{parseMultiValueFilter,parsePriorityFilterSet,parseStringFilterSet,parseTypeFilterSet};
 //# sourceMappingURL=multi-value-filters.js.map
-//# debugId=1035bd62-b012-5249-bd53-31b39f21b2d3

package/dist/sdk/query/next.js

@@ -1,514 +1,2 @@
-/**
- * @module sdk/query/next
- *
- * Implements the `pm next` command: the distilled "what should I work on now?"
- * query. It loads the active corpus, computes dependency-aware actionability
- * (ready vs blocked leaf work), and returns a single ranked recommendation with a
- * deterministic rationale plus the ranked ready/blocked queues — so an agent gets
- * the next action and the reason for it in one token-efficient read instead of
- * re-deriving readiness from a full `pm context` snapshot every turn.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6035e85b-81ed-512e-b291-b0d86af1848b")}catch(e){}}();
-import { collectBlockedByIds, computeActionabilityReport, resolveItemExecutionRole, selectActionableEntries, } from "../actionability.js";
-import { resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, nowIso, normalizeStatusInput, normalizeStatusForRegistry, resolvePmRoot, readSettings, resolveAuthor, resolveItemTypeRegistry, } from "../runtime-primitives.js";
-import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
-import { parseIntegerLimit } from "./parsers.js";
-import { buildChildrenByParent, collectSubtreeIds, compareCriticalItems, mergeSortedWarnings, packRankedContextItems, resolveContextTokenBudget, toContextPackingSummary, toContextRankingSummary, toContextFocusItem, } from "./context.js";
-import { runList } from "./list.js";
-import { scoreContextCandidatesWithActiveExtensions } from "../context-relevance.js";
-import { attachContextUsageServingReceipt, collectContextUsageDeliveredItemIds, readContextUsageAffinity, recordContextUsageServing, } from "../context-usage.js";
-import { readWorkspaceContextSignals, } from "../context-signal-store.js";
-/** Supported values accepted by the next output contract. */
-export const NEXT_OUTPUT_VALUES = ["markdown", "toon", "json"];
-const DEFAULT_NEXT_LIMIT = 5;
-const MS_PER_DAY = 24 * 60 * 60 * 1000;
-function parseNextOutputFormat(raw) {
-    if (!raw)
-        return undefined;
-    const normalized = raw.trim().toLowerCase();
-    if (!NEXT_OUTPUT_VALUES.includes(normalized)) {
-        throw new PmCliError("Next format must be one of markdown|toon|json", EXIT_CODE.USAGE);
-    }
-    return normalized;
-}
-/** Resolves the effective `pm next` output format from the command `--format` flag and the global `--json` switch, rejecting the contradictory `--json --format markdown|toon` combination. Defaults to `toon`. */
-export function resolveNextOutputFormat(options, global) {
-    const commandFormat = parseNextOutputFormat(options.format);
-    if (global.json && commandFormat && commandFormat !== "json") {
-        throw new PmCliError("Cannot combine --json with --format markdown|toon", EXIT_CODE.USAGE);
-    }
-    if (global.json) {
-        return "json";
-    }
-    return commandFormat ?? "toon";
-}
-// Per-section row cap. A non-positive or absent value falls back to the default;
-// invalid (non-integer) values throw via parseIntegerLimit.
-function parseNextLimit(raw, flag, fallback) {
-    const parsed = parseIntegerLimit(raw, flag);
-    if (parsed === undefined || parsed <= 0)
-        return fallback;
-    return parsed;
-}
-// Projects an actionable entry onto its output row. Ready entries carry no
-// blockers; blocked entries surface their unresolved blockers for the agent.
-function toNextActionableItem(entry, statusRegistry, childrenByParent, rank) {
-    return {
-        ...toContextFocusItem(entry.item, statusRegistry, childrenByParent),
-        open_blocker_count: entry.open_blockers.length,
-        blockers: entry.open_blockers.map((blocker) => ({
-            id: blocker.id,
-            title: blocker.title,
-            status: blocker.status,
-            ...(blocker.external ? { external: true } : {}),
-            ...(blocker.blocked_since
-                ? { blocked_since: blocker.blocked_since }
-                : {}),
-            ...(blocker.external ? { resolver: blocker.resolver ?? null } : {}),
-        })),
-        unblocks: entry.unblocks,
-        rank,
-    };
-}
-// Builds the human+agent readable rationale for the recommended item, ordering
-// clauses from most to least decisive (status, priority, deadline, blocker
-// clearance, parent advancement, downstream unblocks).
-function buildRecommendationReasons(entry, statusRegistry, now, completedContainer) {
-    const item = entry.item;
-    const reasons = [];
-    const inProgressStatus = normalizeStatusInput("in_progress", statusRegistry);
-    reasons.push(normalizeStatusForRegistry(item.status, statusRegistry) === inProgressStatus
-        ? "in progress — resume to finish"
-        : "open and ready to start");
-    if (completedContainer) {
-        reasons.push("completed container — governance closeout");
-    }
-    reasons.push(`priority p${item.priority}${item.priority === 0 ? " (highest)" : ""}`);
-    if (typeof item.deadline === "string" && item.deadline.trim().length > 0) {
-        reasons.push(describeDeadline(item.deadline, now));
-    }
-    reasons.push(collectBlockedByIds(item).length > 0
-        ? "all blockers resolved"
-        : "no blockers");
-    if (typeof item.parent === "string" && item.parent.trim().length > 0) {
-        reasons.push(`advances ${item.parent.trim()}`);
-    }
-    if (entry.unblocks.length > 0) {
-        reasons.push(`unblocks ${entry.unblocks.length} item(s)`);
-    }
-    return reasons;
-}
-function partitionCallerOwnedReady(ready, fallbackAuthor, explicitAuthor) {
-    const caller = resolveAuthor(explicitAuthor, fallbackAuthor);
-    const available = [];
-    const held = [];
-    for (const entry of ready) {
-        const assignee = typeof entry.item.assignee === "string" ? entry.item.assignee.trim() : "";
-        const isForeignWork = assignee.length > 0 && assignee !== caller;
-        if (isForeignWork)
-            held.push({ id: entry.item.id, assignee });
-        else
-            available.push(entry);
-    }
-    return { available, held };
-}
-/** Test-only access to deterministic next-work partitioning edge cases. */
-export const _testOnlyNextCommand = {
-    partitionCallerOwnedReady,
-    resolveNextCallerAuthor: (options, settingsAuthor) => resolveNextCallerAuthor(options, settingsAuthor),
-};
-/** Separates human-gated decisions from autonomous agent work unless the caller explicitly opts into decision claims. */
-export function partitionDecisionEntries(ready, includeDecisions, typeRegistry) {
-    const decisions = ready.filter((entry) => resolveItemExecutionRole(entry.item.type, typeRegistry) === "human");
-    return {
-        agent: includeDecisions
-            ? ready
-            : ready.filter((entry) => resolveItemExecutionRole(entry.item.type, typeRegistry) !== "human"),
-        decisions: includeDecisions ? [] : decisions,
-    };
-}
-// Renders a deadline as a date token plus a relative tag (overdue/today/in Nd).
-// The relative delta is computed on UTC calendar dates (both sides normalized to
-// midnight) so a deadline due today never reads as "overdue 1d" just because the
-// wall-clock time of `now` has passed midnight. Unparseable deadlines degrade to
-// the raw token (defensive — stored deadlines are always valid ISO).
-function describeDeadline(deadline, now) {
-    const deadlineMs = Date.parse(deadline);
-    /* c8 ignore start -- defensive: a stored deadline that fails Date.parse still surfaces its raw token */
-    if (!Number.isFinite(deadlineMs)) {
-        return `deadline ${deadline.trim()}`;
-    }
-    /* c8 ignore stop */
-    const dateToken = new Date(deadlineMs).toISOString().slice(0, 10);
-    const nowToken = new Date(Date.parse(now)).toISOString().slice(0, 10);
-    const days = Math.round((Date.parse(dateToken) - Date.parse(nowToken)) / MS_PER_DAY);
-    if (days < 0)
-        return `deadline ${dateToken} (overdue ${-days}d)`;
-    if (days === 0)
-        return `deadline ${dateToken} (due today)`;
-    return `deadline ${dateToken} (in ${days}d)`;
-}
-function inProgressReadyCount(ready, statusRegistry) {
-    const inProgressStatus = normalizeStatusInput("in_progress", statusRegistry);
-    return ready.filter((item) => normalizeStatusForRegistry(item.status, statusRegistry) ===
-        inProgressStatus).length;
-}
-// Returns true when an otherwise-ready item still has terminal descendants. Such
-// rows are useful governance closeout context, but concrete leaf work should rank
-// ahead of them in the default agent loop.
-function hasCompletedDescendants(item, childrenByParent) {
-    return (childrenByParent.get(item.id.trim().toLowerCase()) ?? []).length > 0;
-}
-// Strips projection/pagination flags so the corpus reads stay full: limits are
-// per-section display caps applied after classification, never corpus filters.
-function nextListOptions(options, extra) {
-    return {
-        type: options.type,
-        tag: options.tag,
-        priority: typeof options.priority === "number"
-            ? String(options.priority)
-            : options.priority,
-        assignee: options.assignee,
-        assigneeFilter: options.assigneeFilter,
-        sprint: options.sprint,
-        release: options.release,
-        noTruncate: true,
-        ...extra,
-    };
-}
-function rankNextReadyEntries(ready, childrenByParent, statusRegistry) {
-    return [...ready].sort((left, right) => {
-        const leftCompletedContainer = hasCompletedDescendants(left.item, childrenByParent);
-        const rightCompletedContainer = hasCompletedDescendants(right.item, childrenByParent);
-        if (leftCompletedContainer !== rightCompletedContainer) {
-            return Number(leftCompletedContainer) - Number(rightCompletedContainer);
-        }
-        return compareCriticalItems(left.item, right.item, statusRegistry);
-    });
-}
-function buildNextRecommendation(params) {
-    if (params.projectedReady.length === 0) {
-        return null;
-    }
-    return {
-        ...params.readyRows[0],
-        reasons: buildRecommendationReasons(params.projectedReady[0], params.statusRegistry, params.now, params.completedContainer),
-    };
-}
-function buildNextSuggestions(recommended, blockedRows, gateCount) {
-    if (recommended !== null) {
-        return undefined;
-    }
-    const gateGuidance = gateCount > 0
-        ? ["No executable recommendation: outcome gates require verification. Inspect gate_needed, or use pm next --include-gates to opt in."]
-        : [];
-    if (blockedRows.length > 0) {
-        const blockedWithReferences = blockedRows.find((item) => item.blockers.length > 0);
-        return [
-            ...gateGuidance,
-            blockedWithReferences
-                ? `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedWithReferences.blockers.map((blocker) => blocker.id).join(", ")}`
-                : `${blockedRows.length} item(s) are blocked; add blocker context or move the top item back to an active status`,
-            "pm next --ready-only after a blocker closes to re-check ready work",
-            'pm create --type Task --title "..." to add new ready work',
-        ];
-    }
-    return [
-        ...gateGuidance,
-        'pm create --type Task --title "..." to add a new work item',
-        "pm list --status in_progress to review work already underway",
-        "pm context --depth deep for the full project snapshot",
-    ];
-}
-function buildNextTruncation(decisionCount, heldCount, limit) {
-    const truncation = {};
-    if (decisionCount > limit) {
-        truncation.decision_needed_total = decisionCount;
-    }
-    if (heldCount > limit) {
-        truncation.held_by_others_total = heldCount;
-    }
-    return Object.keys(truncation).length > 0 ? truncation : undefined;
-}
-async function attachNextUsageFeedback(params) {
-    try {
-        const included = new Set(params.packing.included.map((entry) => entry.id));
-        const rows = params.ranking.ranked.map((entry) => ({
-            id: entry.id,
-            rank: entry.rank,
-            included: included.has(entry.id),
-        }));
-        const rankedIds = new Set(rows.map((row) => row.id));
-        for (const id of collectContextUsageDeliveredItemIds(params.result, "next")) {
-            if (!rankedIds.has(id)) {
-                rows.push({ id, rank: rows.length + 1, included: false });
-                rankedIds.add(id);
-            }
-        }
-        const receipt = await recordContextUsageServing({
-            pmRoot: params.pmRoot,
-            author: params.author,
-            surface: "next",
-            profile: params.packing.profile,
-            rows,
-            enabled: process.env.PM_CONTEXT_USAGE_DISABLED !== "1",
-        });
-        attachContextUsageServingReceipt(params.result, receipt);
-    }
-    catch {
-        params.result.warnings = mergeSortedWarnings(params.result.warnings, [
-            "context_usage_feedback_write_failed",
-        ]);
-    }
-}
-async function finalizeNextResult(params) {
-    const warnings = [
-        ...new Set([
-            ...(params.candidatesWarnings ?? []),
-            ...(params.corpusWarnings ?? []),
-            ...(params.readyRanking.warnings ?? []),
-            ...params.featureStore.warnings,
-        ]),
-    ].sort((left, right) => left.localeCompare(right));
-    if (warnings.length > 0)
-        params.result.warnings = warnings;
-    if (params.explainRanking) {
-        params.result.ranking = toContextRankingSummary(params.readyRanking, params.featureStore);
-        params.result.packing = toContextPackingSummary(params.packing);
-    }
-    params.result.suggestions = buildNextSuggestions(params.recommended, params.blockedRows, params.gateCount);
-    await attachNextUsageFeedback({
-        result: params.result,
-        pmRoot: params.pmRoot,
-        author: params.author,
-        packing: params.packing,
-        ranking: params.readyRanking,
-    });
-    return params.result;
-}
-function filterCandidatesByParentScope(candidates, corpus, parentScope) {
-    if (!parentScope) {
-        return candidates;
-    }
-    const subtree = collectSubtreeIds(corpus, parentScope);
-    if (!subtree.found) {
-        throw new PmCliError(`Next --parent item not found: ${parentScope}`, EXIT_CODE.NOT_FOUND);
-    }
-    return candidates.filter((item) => subtree.ids.has(item.id.trim().toLowerCase()));
-}
-async function rankReadyEntriesWithRelevance(rankedReady, childrenByParent, statusRegistry, now, callerAuthor, pmRoot, tokenBudget, includeContainers) {
-    const concreteReady = rankedReady.filter((entry) => !hasCompletedDescendants(entry.item, childrenByParent));
-    const structuralReady = includeContainers || concreteReady.length === 0 ? rankedReady : concreteReady;
-    const usage = await readContextUsageAffinity({
-        pmRoot,
-        author: callerAuthor,
-        enabled: process.env.PM_CONTEXT_USAGE_DISABLED !== "1",
-    });
-    const featureStore = await readWorkspaceContextSignals(structuralReady.map((entry) => entry.item), {
-        pmRoot,
-        storeKey: "next",
-        statusRegistry,
-        now,
-        author: callerAuthor,
-        usageAffinity: usage.affinity,
-    });
-    const ranking = await scoreContextCandidatesWithActiveExtensions("next", featureStore.candidates);
-    const packing = packRankedContextItems(ranking, tokenBudget, new Set(), "next");
-    const readyById = new Map(structuralReady.map((entry) => [entry.item.id, entry]));
-    const projectedReady = ranking.ranked
-        .map((entry) => readyById.get(entry.id))
-        .filter((entry) => entry !== undefined);
-    return {
-        projectedReady,
-        ranking,
-        completedContainer: concreteReady.length === 0 && !includeContainers,
-        packing,
-        featureStore,
-    };
-}
-/** Resolve the ranking perspective through the canonical author precedence contract. */
-function resolveNextCallerAuthor(options, settingsAuthor) {
-    const requestedAssignee = options.assignee?.trim();
-    return resolveAuthor(options.callerAuthor ??
-        (requestedAssignee && requestedAssignee.length > 0
-            ? requestedAssignee
-            : undefined), settingsAuthor);
-}
-/** Implements `pm next`: computes the ranked ready/blocked actionable queues and a single recommended next item with rationale for the public runtime surface. */
-export async function runNext(options, global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    const settings = await readSettings(pmRoot);
-    const callerAuthor = resolveNextCallerAuthor(options, settings.author_default);
-    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    const now = nowIso();
-    const limit = parseNextLimit(options.limit, "--limit", DEFAULT_NEXT_LIMIT);
-    const tokenBudget = resolveContextTokenBudget(options.tokenBudget, Math.max(192, limit * 128));
-    const blockedLimit = parseNextLimit(options.blockedLimit, "--blocked-limit", limit);
-    const readyOnly = options.readyOnly === true;
-    const parentScope = typeof options.parent === "string" ? options.parent.trim() : "";
-    // Active (non-terminal) candidates honor the caller's filters; the corpus is the
-    // FULL, UNFILTERED set (every status, every item) so blocker and descendant
-    // resolution still sees items outside the caller's filters or --parent subtree —
-    // otherwise a real blocker assigned to someone else (or a parent of a different
-    // type) would be missing and the blocked item misread as ready.
-    const candidatesList = await runList(undefined, nextListOptions(options, { excludeTerminal: true }), global);
-    const corpusList = await runList(undefined, { excludeTerminal: false, noTruncate: true }, global);
-    const candidates = filterCandidatesByParentScope(candidatesList.items, corpusList.items, parentScope);
-    const corpus = corpusList.items;
-    const report = computeActionabilityReport(candidates, corpus, statusRegistry, typeRegistry);
-    const childrenByParent = buildChildrenByParent(corpus);
-    const selected = selectActionableEntries(report, statusRegistry, options, typeRegistry);
-    const callerPartition = partitionCallerOwnedReady(selected.ready, settings.author_default, callerAuthor);
-    const rankedReady = rankNextReadyEntries(callerPartition.available, childrenByParent, statusRegistry);
-    const rankedBlocked = [...report.blocked].sort((left, right) => compareCriticalItems(left.item, right.item, statusRegistry));
-    const { projectedReady, ranking: readyRanking, completedContainer, packing: readyPacking, featureStore, } = await rankReadyEntriesWithRelevance(rankedReady, childrenByParent, statusRegistry, now, callerAuthor, pmRoot, tokenBudget, options.includeContainers === true);
-    const readyRows = projectedReady.map((entry, index) => toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1));
-    const blockedRows = rankedBlocked.map((entry, index) => toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1));
-    const decisionRows = rankNextReadyEntries(selected.decisions, childrenByParent, statusRegistry).map((entry, index) => toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1));
-    const gateRows = rankNextReadyEntries(selected.gates, childrenByParent, statusRegistry).map((entry, index) => toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1));
-    const containerRows = rankNextReadyEntries(report.containers, childrenByParent, statusRegistry).map((entry, index) => toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1));
-    const recommended = buildNextRecommendation({
-        projectedReady,
-        readyRows,
-        statusRegistry,
-        now,
-        completedContainer,
-    });
-    const truncation = buildNextTruncation(decisionRows.length, callerPartition.held.length, limit) ?? {};
-    if (gateRows.length > limit)
-        truncation.gate_needed_total = gateRows.length;
-    if (containerRows.length > limit)
-        truncation.containers_total = containerRows.length;
-    const result = {
-        output_default: "toon",
-        now,
-        recommended,
-        ready: readyRows.slice(1, limit + 1),
-        decision_needed: decisionRows.slice(0, limit),
-        gate_needed: gateRows.slice(0, limit),
-        containers: containerRows.slice(0, limit),
-        blocked: readyOnly ? [] : blockedRows.slice(0, blockedLimit),
-        held_by_others: callerPartition.held.slice(0, limit),
-        summary: {
-            recommended: recommended !== null,
-            ready: readyRows.length,
-            blocked: blockedRows.length,
-            in_progress: inProgressReadyCount(readyRows, statusRegistry),
-            candidates: report.active_count,
-            containers: report.container_count,
-            decision_needed: decisionRows.length,
-            gate_needed: gateRows.length,
-            held_by_others: callerPartition.held.length,
-        },
-        filters: {
-            type: options.type ?? null,
-            tag: options.tag ?? null,
-            priority: options.priority ?? null,
-            assignee: options.assignee ?? null,
-            assignee_filter: options.assigneeFilter ?? null,
-            sprint: options.sprint ?? null,
-            release: options.release ?? null,
-            parent: parentScope.length > 0 ? parentScope : null,
-            limit,
-            blocked_limit: blockedLimit,
-            ready_only: readyOnly,
-            include_decisions: options.includeDecisions === true,
-            include_gates: options.includeGates === true,
-            include_containers: options.includeContainers === true,
-            token_budget: tokenBudget,
-        },
-        truncation: Object.keys(truncation).length > 0 ? truncation : undefined,
-    };
-    return finalizeNextResult({
-        result,
-        recommended,
-        blockedRows,
-        gateCount: gateRows.length,
-        candidatesWarnings: candidatesList.warnings,
-        corpusWarnings: corpusList.warnings,
-        readyRanking,
-        explainRanking: options.explainRanking === true,
-        pmRoot,
-        author: callerAuthor,
-        packing: readyPacking,
-        featureStore,
-    });
-}
-/**
- * Renders a {@link NextResult} as compact agent-readable markdown: the
- * recommendation with its rationale, the ranked ready queue, and (unless
- * `--ready-only`) the blocked queue annotated with each item's open blockers.
- */
-export function renderNextMarkdown(result) {
-    const lines = ["# pm next", "", ...renderNextSummaryLines(result)];
-    for (const [title, rows] of [["Gate verification needed", result.gate_needed], ["Containers", result.containers]]) {
-        if (rows && rows.length > 0)
-            lines.push(...renderNextSection(title, rows.map((item) => `- ${formatNextLine(item)}`), ""));
-    }
-    lines.push(...renderNextSection("Recommended", renderNextRecommendedRows(result.recommended), "No ready work."));
-    lines.push(...renderNextSection("Decision needed", 
-    // `?? []` tolerates JSON payloads from pre-decision-queue builds (the
-    // field is newer than the rest of the shape); pinned by a dedicated spec.
-    (result.decision_needed ?? []).map((item) => `- ${formatNextLine(item)}`), "No human-gated decisions."));
-    lines.push(...renderNextSection("Ready", result.ready.map((item) => `- ${formatNextLine(item)}`), "No ready items."));
-    if (!result.filters.ready_only) {
-        lines.push(...renderNextSection("Blocked", result.blocked.map((item) => `- ${formatNextBlockedLine(item)}`), "No blocked items."));
-    }
-    if (result.suggestions && result.suggestions.length > 0) {
-        lines.push("## Suggestions");
-        for (const suggestion of result.suggestions) {
-            lines.push(`- ${suggestion}`);
-        }
-    }
-    return lines.join("\n").trimEnd();
-}
-// Renders the top-of-report summary bullet block (timestamp, queue counts,
-// optional subtree scope) followed by its separating blank line.
-function renderNextSummaryLines(result) {
-    const lines = [
-        `- now: ${result.now}`,
-        `- ready: ${result.summary.ready} (in_progress: ${result.summary.in_progress}), blocked: ${result.summary.blocked}, candidates: ${result.summary.candidates}`,
-    ];
-    if (result.filters.parent) {
-        lines.push(`- scope: subtree of ${result.filters.parent}`);
-    }
-    lines.push("");
-    return lines;
-}
-// Renders the recommendation rows (item line + rationale) or nothing when no
-// candidate is ready, letting the shared section helper supply the empty state.
-function renderNextRecommendedRows(recommended) {
-    if (!recommended) {
-        return [];
-    }
-    return [
-        `- ${formatNextLine(recommended)}`,
-        `  why: ${recommended.reasons.join("; ")}`,
-    ];
-}
-// Renders one markdown queue section: the `##` header, then either the rows or
-// the section's empty-state message, closed by a separating blank line.
-function renderNextSection(header, rows, emptyMessage) {
-    return [`## ${header}`, ...(rows.length === 0 ? [emptyMessage] : rows), ""];
-}
-// Formats a blocked row: the standard actionable line annotated with each open
-// blocker's id and current status.
-function formatNextBlockedLine(item) {
-    const by = item.blockers
-        .map((blocker) => `${blocker.id}(${blocker.status ?? "?"})`)
-        .join(", ");
-    return `${formatNextLine(item)} blocked_by:${by}`;
-}
-// Formats a single actionable row: id, priority, status, type, deadline, parent,
-// downstream-unblock count, and title. Mirrors the context focus-line shape.
-function formatNextLine(item) {
-    const deadlineToken = item.deadline ?? "-";
-    const parentToken = item.parent ? ` parent:${item.parent}` : "";
-    const unblocksToken = item.unblocks.length > 0 ? ` unblocks:${item.unblocks.length}` : "";
-    const rankToken = Number.isInteger(item.rank) ? `#${item.rank} ` : "";
-    return `${rankToken}${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;
-}
+!(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]="045ff474-f6d9-50c5-b554-ebc947a52443")}catch(e2){}})();import{collectBlockedByIds,computeActionabilityReport,resolveItemExecutionRole,selectActionableEntries}from"../actionability.js";import{resolveRuntimeStatusRegistry,EXIT_CODE,PmCliError,nowIso,normalizeStatusInput,normalizeStatusForRegistry,resolvePmRoot,readSettings,resolveAuthor,resolveItemTypeRegistry}from"../runtime-primitives.js";import{getActiveExtensionRegistrations}from"../../core/extensions/index.js";import{parseIntegerLimit}from"./parsers.js";import{buildChildrenByParent,collectSubtreeIds,compareCriticalItems,mergeSortedWarnings,packRankedContextItems,resolveContextTokenBudget,toContextPackingSummary,toContextRankingSummary,toContextFocusItem}from"./context.js";import{runList}from"./list.js";import{scoreContextCandidatesWithActiveExtensions}from"../context-relevance.js";import{attachContextUsageServingReceipt,collectContextUsageDeliveredItemIds,readContextUsageAffinity,recordContextUsageServing}from"../context-usage.js";import{readWorkspaceContextSignals}from"../context-signal-store.js";const NEXT_OUTPUT_VALUES=["markdown","toon","json"];const DEFAULT_NEXT_LIMIT=5;const MS_PER_DAY=24*60*60*1e3;function parseNextOutputFormat(raw){if(!raw)return void 0;const normalized=raw.trim().toLowerCase();if(!NEXT_OUTPUT_VALUES.includes(normalized)){throw new PmCliError("Next format must be one of markdown|toon|json",EXIT_CODE.USAGE)}return normalized}function resolveNextOutputFormat(options,global2){const commandFormat=parseNextOutputFormat(options.format);if(global2.json&&commandFormat&&commandFormat!=="json"){throw new PmCliError("Cannot combine --json with --format markdown|toon",EXIT_CODE.USAGE)}if(global2.json){return"json"}return commandFormat??"toon"}function parseNextLimit(raw,flag,fallback){const parsed=parseIntegerLimit(raw,flag);if(parsed===void 0||parsed<=0)return fallback;return parsed}function toNextActionableItem(entry,statusRegistry,childrenByParent,rank){return{...toContextFocusItem(entry.item,statusRegistry,childrenByParent),open_blocker_count:entry.open_blockers.length,blockers:entry.open_blockers.map(blocker=>({id:blocker.id,title:blocker.title,status:blocker.status,...blocker.external?{external:true}:{},...blocker.blocked_since?{blocked_since:blocker.blocked_since}:{},...blocker.external?{resolver:blocker.resolver??null}:{}})),unblocks:entry.unblocks,rank}}function buildRecommendationReasons(entry,statusRegistry,now,completedContainer){const item=entry.item;const reasons=[];const inProgressStatus=normalizeStatusInput("in_progress",statusRegistry);reasons.push(normalizeStatusForRegistry(item.status,statusRegistry)===inProgressStatus?"in progress \u2014 resume to finish":"open and ready to start");if(completedContainer){reasons.push("completed container \u2014 governance closeout")}reasons.push(`priority p${item.priority}${item.priority===0?" (highest)":""}`);if(typeof item.deadline==="string"&&item.deadline.trim().length>0){reasons.push(describeDeadline(item.deadline,now))}reasons.push(collectBlockedByIds(item).length>0?"all blockers resolved":"no blockers");if(typeof item.parent==="string"&&item.parent.trim().length>0){reasons.push(`advances ${item.parent.trim()}`)}if(entry.unblocks.length>0){reasons.push(`unblocks ${entry.unblocks.length} item(s)`)}return reasons}function partitionCallerOwnedReady(ready,fallbackAuthor,explicitAuthor){const caller=resolveAuthor(explicitAuthor,fallbackAuthor);const available=[];const held=[];for(const entry of ready){const assignee=typeof entry.item.assignee==="string"?entry.item.assignee.trim():"";const isForeignWork=assignee.length>0&&assignee!==caller;if(isForeignWork)held.push({id:entry.item.id,assignee});else available.push(entry)}return{available,held}}const _testOnlyNextCommand={partitionCallerOwnedReady,resolveNextCallerAuthor:(options,settingsAuthor)=>resolveNextCallerAuthor(options,settingsAuthor)};function partitionDecisionEntries(ready,includeDecisions,typeRegistry){const decisions=ready.filter(entry=>resolveItemExecutionRole(entry.item.type,typeRegistry)==="human");return{agent:includeDecisions?ready:ready.filter(entry=>resolveItemExecutionRole(entry.item.type,typeRegistry)!=="human"),decisions:includeDecisions?[]:decisions}}function describeDeadline(deadline,now){const deadlineMs=Date.parse(deadline);if(!Number.isFinite(deadlineMs)){return`deadline ${deadline.trim()}`}const dateToken=new Date(deadlineMs).toISOString().slice(0,10);const nowToken=new Date(Date.parse(now)).toISOString().slice(0,10);const days=Math.round((Date.parse(dateToken)-Date.parse(nowToken))/MS_PER_DAY);if(days<0)return`deadline ${dateToken} (overdue ${-days}d)`;if(days===0)return`deadline ${dateToken} (due today)`;return`deadline ${dateToken} (in ${days}d)`}function inProgressReadyCount(ready,statusRegistry){const inProgressStatus=normalizeStatusInput("in_progress",statusRegistry);return ready.filter(item=>normalizeStatusForRegistry(item.status,statusRegistry)===inProgressStatus).length}function hasCompletedDescendants(item,childrenByParent){return(childrenByParent.get(item.id.trim().toLowerCase())??[]).length>0}function nextListOptions(options,extra){return{type:options.type,tag:options.tag,priority:typeof options.priority==="number"?String(options.priority):options.priority,assignee:options.assignee,assigneeFilter:options.assigneeFilter,sprint:options.sprint,release:options.release,noTruncate:true,...extra}}function rankNextReadyEntries(ready,childrenByParent,statusRegistry){return[...ready].sort((left,right)=>{const leftCompletedContainer=hasCompletedDescendants(left.item,childrenByParent);const rightCompletedContainer=hasCompletedDescendants(right.item,childrenByParent);if(leftCompletedContainer!==rightCompletedContainer){return Number(leftCompletedContainer)-Number(rightCompletedContainer)}return compareCriticalItems(left.item,right.item,statusRegistry)})}function buildNextRecommendation(params){if(params.projectedReady.length===0){return null}return{...params.readyRows[0],reasons:buildRecommendationReasons(params.projectedReady[0],params.statusRegistry,params.now,params.completedContainer)}}function buildNextSuggestions(recommended,blockedRows,gateCount){if(recommended!==null){return void 0}const gateGuidance=gateCount>0?["No executable recommendation: outcome gates require verification. Inspect gate_needed, or use pm next --include-gates to opt in."]:[];if(blockedRows.length>0){const blockedWithReferences=blockedRows.find(item=>item.blockers.length>0);return[...gateGuidance,blockedWithReferences?`${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedWithReferences.blockers.map(blocker=>blocker.id).join(", ")}`:`${blockedRows.length} item(s) are blocked; add blocker context or move the top item back to an active status`,"pm next --ready-only after a blocker closes to re-check ready work",'pm create --type Task --title "..." to add new ready work']}return[...gateGuidance,'pm create --type Task --title "..." to add a new work item',"pm list --status in_progress to review work already underway","pm context --depth deep for the full project snapshot"]}function buildNextTruncation(decisionCount,heldCount,limit){const truncation={};if(decisionCount>limit){truncation.decision_needed_total=decisionCount}if(heldCount>limit){truncation.held_by_others_total=heldCount}return Object.keys(truncation).length>0?truncation:void 0}async function attachNextUsageFeedback(params){try{const included=new Set(params.packing.included.map(entry=>entry.id));const rows=params.ranking.ranked.map(entry=>({id:entry.id,rank:entry.rank,included:included.has(entry.id)}));const rankedIds=new Set(rows.map(row=>row.id));for(const id of collectContextUsageDeliveredItemIds(params.result,"next")){if(!rankedIds.has(id)){rows.push({id,rank:rows.length+1,included:false});rankedIds.add(id)}}const receipt=await recordContextUsageServing({pmRoot:params.pmRoot,author:params.author,surface:"next",profile:params.packing.profile,rows,enabled:process.env.PM_CONTEXT_USAGE_DISABLED!=="1"});attachContextUsageServingReceipt(params.result,receipt)}catch{params.result.warnings=mergeSortedWarnings(params.result.warnings,["context_usage_feedback_write_failed"])}}async function finalizeNextResult(params){const warnings=[...new Set([...params.candidatesWarnings??[],...params.corpusWarnings??[],...params.readyRanking.warnings??[],...params.featureStore.warnings])].sort((left,right)=>left.localeCompare(right));if(warnings.length>0)params.result.warnings=warnings;if(params.explainRanking){params.result.ranking=toContextRankingSummary(params.readyRanking,params.featureStore);params.result.packing=toContextPackingSummary(params.packing)}params.result.suggestions=buildNextSuggestions(params.recommended,params.blockedRows,params.gateCount);await attachNextUsageFeedback({result:params.result,pmRoot:params.pmRoot,author:params.author,packing:params.packing,ranking:params.readyRanking});return params.result}function filterCandidatesByParentScope(candidates,corpus,parentScope){if(!parentScope){return candidates}const subtree=collectSubtreeIds(corpus,parentScope);if(!subtree.found){throw new PmCliError(`Next --parent item not found: ${parentScope}`,EXIT_CODE.NOT_FOUND)}return candidates.filter(item=>subtree.ids.has(item.id.trim().toLowerCase()))}async function rankReadyEntriesWithRelevance(rankedReady,childrenByParent,statusRegistry,now,callerAuthor,pmRoot,tokenBudget,includeContainers){const concreteReady=rankedReady.filter(entry=>!hasCompletedDescendants(entry.item,childrenByParent));const structuralReady=includeContainers||concreteReady.length===0?rankedReady:concreteReady;const usage=await readContextUsageAffinity({pmRoot,author:callerAuthor,enabled:process.env.PM_CONTEXT_USAGE_DISABLED!=="1"});const featureStore=await readWorkspaceContextSignals(structuralReady.map(entry=>entry.item),{pmRoot,storeKey:"next",statusRegistry,now,author:callerAuthor,usageAffinity:usage.affinity});const ranking=await scoreContextCandidatesWithActiveExtensions("next",featureStore.candidates);const packing=packRankedContextItems(ranking,tokenBudget,new Set,"next");const readyById=new Map(structuralReady.map(entry=>[entry.item.id,entry]));const projectedReady=ranking.ranked.map(entry=>readyById.get(entry.id)).filter(entry=>entry!==void 0);return{projectedReady,ranking,completedContainer:concreteReady.length===0&&!includeContainers,packing,featureStore}}function resolveNextCallerAuthor(options,settingsAuthor){const requestedAssignee=options.assignee?.trim();return resolveAuthor(options.callerAuthor??(requestedAssignee&&requestedAssignee.length>0?requestedAssignee:void 0),settingsAuthor)}async function runNext(options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);const settings=await readSettings(pmRoot);const callerAuthor=resolveNextCallerAuthor(options,settings.author_default);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const now=nowIso();const limit=parseNextLimit(options.limit,"--limit",DEFAULT_NEXT_LIMIT);const tokenBudget=resolveContextTokenBudget(options.tokenBudget,Math.max(192,limit*128));const blockedLimit=parseNextLimit(options.blockedLimit,"--blocked-limit",limit);const readyOnly=options.readyOnly===true;const parentScope=typeof options.parent==="string"?options.parent.trim():"";const candidatesList=await runList(void 0,nextListOptions(options,{excludeTerminal:true}),global2);const corpusList=await runList(void 0,{excludeTerminal:false,noTruncate:true},global2);const candidates=filterCandidatesByParentScope(candidatesList.items,corpusList.items,parentScope);const corpus=corpusList.items;const report=computeActionabilityReport(candidates,corpus,statusRegistry,typeRegistry);const childrenByParent=buildChildrenByParent(corpus);const selected=selectActionableEntries(report,statusRegistry,options,typeRegistry);const callerPartition=partitionCallerOwnedReady(selected.ready,settings.author_default,callerAuthor);const rankedReady=rankNextReadyEntries(callerPartition.available,childrenByParent,statusRegistry);const rankedBlocked=[...report.blocked].sort((left,right)=>compareCriticalItems(left.item,right.item,statusRegistry));const{projectedReady,ranking:readyRanking,completedContainer,packing:readyPacking,featureStore}=await rankReadyEntriesWithRelevance(rankedReady,childrenByParent,statusRegistry,now,callerAuthor,pmRoot,tokenBudget,options.includeContainers===true);const readyRows=projectedReady.map((entry,index)=>toNextActionableItem(entry,statusRegistry,childrenByParent,index+1));const blockedRows=rankedBlocked.map((entry,index)=>toNextActionableItem(entry,statusRegistry,childrenByParent,index+1));const decisionRows=rankNextReadyEntries(selected.decisions,childrenByParent,statusRegistry).map((entry,index)=>toNextActionableItem(entry,statusRegistry,childrenByParent,index+1));const gateRows=rankNextReadyEntries(selected.gates,childrenByParent,statusRegistry).map((entry,index)=>toNextActionableItem(entry,statusRegistry,childrenByParent,index+1));const containerRows=rankNextReadyEntries(report.containers,childrenByParent,statusRegistry).map((entry,index)=>toNextActionableItem(entry,statusRegistry,childrenByParent,index+1));const recommended=buildNextRecommendation({projectedReady,readyRows,statusRegistry,now,completedContainer});const truncation=buildNextTruncation(decisionRows.length,callerPartition.held.length,limit)??{};if(gateRows.length>limit)truncation.gate_needed_total=gateRows.length;if(containerRows.length>limit)truncation.containers_total=containerRows.length;const result={output_default:"toon",now,recommended,ready:readyRows.slice(1,limit+1),decision_needed:decisionRows.slice(0,limit),gate_needed:gateRows.slice(0,limit),containers:containerRows.slice(0,limit),blocked:readyOnly?[]:blockedRows.slice(0,blockedLimit),held_by_others:callerPartition.held.slice(0,limit),summary:{recommended:recommended!==null,ready:readyRows.length,blocked:blockedRows.length,in_progress:inProgressReadyCount(readyRows,statusRegistry),candidates:report.active_count,containers:report.container_count,decision_needed:decisionRows.length,gate_needed:gateRows.length,held_by_others:callerPartition.held.length},filters:{type:options.type??null,tag:options.tag??null,priority:options.priority??null,assignee:options.assignee??null,assignee_filter:options.assigneeFilter??null,sprint:options.sprint??null,release:options.release??null,parent:parentScope.length>0?parentScope:null,limit,blocked_limit:blockedLimit,ready_only:readyOnly,include_decisions:options.includeDecisions===true,include_gates:options.includeGates===true,include_containers:options.includeContainers===true,token_budget:tokenBudget},truncation:Object.keys(truncation).length>0?truncation:void 0};return finalizeNextResult({result,recommended,blockedRows,gateCount:gateRows.length,candidatesWarnings:candidatesList.warnings,corpusWarnings:corpusList.warnings,readyRanking,explainRanking:options.explainRanking===true,pmRoot,author:callerAuthor,packing:readyPacking,featureStore})}function renderNextMarkdown(result){const lines=["# pm next","",...renderNextSummaryLines(result)];for(const[title,rows]of[["Gate verification needed",result.gate_needed],["Containers",result.containers]]){if(rows&&rows.length>0)lines.push(...renderNextSection(title,rows.map(item=>`- ${formatNextLine(item)}`),""))}lines.push(...renderNextSection("Recommended",renderNextRecommendedRows(result.recommended),"No ready work."));lines.push(...renderNextSection("Decision needed",(result.decision_needed??[]).map(item=>`- ${formatNextLine(item)}`),"No human-gated decisions."));lines.push(...renderNextSection("Ready",result.ready.map(item=>`- ${formatNextLine(item)}`),"No ready items."));if(!result.filters.ready_only){lines.push(...renderNextSection("Blocked",result.blocked.map(item=>`- ${formatNextBlockedLine(item)}`),"No blocked items."))}if(result.suggestions&&result.suggestions.length>0){lines.push("## Suggestions");for(const suggestion of result.suggestions){lines.push(`- ${suggestion}`)}}return lines.join("\n").trimEnd()}function renderNextSummaryLines(result){const lines=[`- now: ${result.now}`,`- ready: ${result.summary.ready} (in_progress: ${result.summary.in_progress}), blocked: ${result.summary.blocked}, candidates: ${result.summary.candidates}`];if(result.filters.parent){lines.push(`- scope: subtree of ${result.filters.parent}`)}lines.push("");return lines}function renderNextRecommendedRows(recommended){if(!recommended){return[]}return[`- ${formatNextLine(recommended)}`,`  why: ${recommended.reasons.join("; ")}`]}function renderNextSection(header,rows,emptyMessage){return[`## ${header}`,...rows.length===0?[emptyMessage]:rows,""]}function formatNextBlockedLine(item){const by=item.blockers.map(blocker=>`${blocker.id}(${blocker.status??"?"})`).join(", ");return`${formatNextLine(item)} blocked_by:${by}`}function formatNextLine(item){const deadlineToken=item.deadline??"-";const parentToken=item.parent?` parent:${item.parent}`:"";const unblocksToken=item.unblocks.length>0?` unblocks:${item.unblocks.length}`:"";const rankToken=Number.isInteger(item.rank)?`#${item.rank} `:"";return`${rankToken}${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`}export{NEXT_OUTPUT_VALUES,_testOnlyNextCommand,partitionDecisionEntries,renderNextMarkdown,resolveNextOutputFormat,runNext};
 //# sourceMappingURL=next.js.map
-//# debugId=6035e85b-81ed-512e-b291-b0d86af1848b