@unbrained/pm-cli 2026.9.3 → 2026.9.5

package/dist/sdk/query/context.d.ts

@@ -267,6 +267,15 @@ interface ContextAgendaSummary {
     scheduled: number;
 }
 interface ContextSummary {
+    /** Population counters honor item filters and parent scope, never output limits. */
+    scope?: "matching_items";
+    /** Counts for the bounded focus selection, separate from the matching population. */
+    returned_focus?: {
+        active_items: number;
+        in_progress: number;
+        open: number;
+        blocked: number;
+    };
     active_items: number;
     in_progress: number;
     open: number;

package/dist/sdk/query/context.js

@@ -4,9 +4,10 @@
  * Implements the pm context command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="56205e5f-fc26-59ab-abdf-45bdcaf1c263")}catch(e){}}();
-import { SETTINGS_DEFAULTS, EXIT_CODE, PmCliError, compareTimestampStrings, nowIso, isTerminalStatus, normalizeStatusForRegistry, normalizeStatusInput, resolveRuntimeStatusRegistry, resolvePmRoot, readSettings, resolveAuthor, discoverExtensions, } from "../runtime-primitives.js";
-import { collectDependencyBlockedIds, resolveItemBlockers, } from "../actionability.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]="4f8e82a2-f4ea-5ecb-8ef5-3ca795cdeda5")}catch(e){}}();
+import { SETTINGS_DEFAULTS, EXIT_CODE, PmCliError, compareTimestampStrings, nowIso, isTerminalStatus, normalizeStatusForRegistry, normalizeStatusInput, resolveRuntimeStatusRegistry, resolvePmRoot, readSettings, resolveAuthor, discoverExtensions, resolveItemTypeRegistry, } from "../runtime-primitives.js";
+import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
+import { collectDependencyBlockedIds, resolveItemBlockers, resolveItemExecutionRole, computeActionabilityReport, } from "../actionability.js";
 import { CONTEXT_DEPTH_VALUES, CONTEXT_SECTION_VALUES, } from "../../types/index.js";
 import { parseIntegerLimit } from "./parsers.js";
 import { runCalendar, } from "./calendar.js";
@@ -1201,7 +1202,6 @@ function buildUnpaginatedContextListOptions(baseListOptions, extra) {
     };
 }
 async function loadContextCorpus(global, runtime) {
-    const needsAllItems = contextNeedsAllItems(runtime.sectionsIncluded);
     // One full-corpus scan serves every consumer: runList always reads all item
     // files before filtering, so deriving the non-terminal subset in memory is
     // free and keeps terminal blocker targets available for the shared
@@ -1211,9 +1211,7 @@ async function loadContextCorpus(global, runtime) {
     }), global);
     const fullCorpus = listed.items;
     let listedItemMetadata = fullCorpus.filter((item) => !isTerminalStatus(item.status, runtime.statusRegistry));
-    let allItems = needsAllItems || runtime.parentScope !== undefined
-        ? fullCorpus
-        : listedItemMetadata;
+    let allItems = fullCorpus;
     const subtreeIds = resolveContextSubtreeIds(runtime.parentScope, fullCorpus);
     if (subtreeIds) {
         listedItemMetadata = listedItemMetadata.filter((item) => subtreeIds.has(item.id.trim().toLowerCase()));
@@ -1231,7 +1229,14 @@ function resolveContextSubtreeIds(parentScope, fullCorpus) {
     }
     return subtree.ids;
 }
-async function resolveContextFocusGroups(listedItemMetadata, allItems, fullCorpus, blockedIds, statusRegistry, sectionsIncluded, limit, now, author, cursor, cursorFingerprint, useBoundedPage, pmRoot, tokenBudget, claimFocus) {
+/** Classify strategic and human-directed context through the shared execution rules. */
+function collectHighLevelContextIds(activeItems, fullCorpus, statusRegistry, typeRegistry) {
+    const containers = new Set(computeActionabilityReport(activeItems, fullCorpus, statusRegistry, typeRegistry)
+        .containers.map((entry) => entry.item.id));
+    return new Set(activeItems.filter((item) => HIGH_LEVEL_TYPES.has(item.type) || containers.has(item.id) ||
+        resolveItemExecutionRole(item.type, typeRegistry) !== "agent").map((item) => item.id));
+}
+async function resolveContextFocusGroups(listedItemMetadata, allItems, fullCorpus, blockedIds, statusRegistry, sectionsIncluded, limit, now, author, cursor, cursorFingerprint, useBoundedPage, pmRoot, tokenBudget, claimFocus, typeRegistry) {
     const structural = [...listedItemMetadata].sort((left, right) => compareCriticalItems(left, right, statusRegistry));
     const usage = await readContextUsageAffinity({
         pmRoot,
@@ -1293,12 +1298,13 @@ async function resolveContextFocusGroups(listedItemMetadata, allItems, fullCorpu
             .map((blocker) => blocker.id);
         return focus;
     };
+    const highLevelIds = collectHighLevelContextIds(activeItems, fullCorpus, statusRegistry, typeRegistry);
     const highLevel = activeItems
-        .filter((item) => HIGH_LEVEL_TYPES.has(item.type))
+        .filter((item) => highLevelIds.has(item.id))
         .slice(0, useBoundedPage ? focusPage.length : limit)
         .map(projectFocusItem);
     const lowLevel = activeItems
-        .filter((item) => !HIGH_LEVEL_TYPES.has(item.type))
+        .filter((item) => !highLevelIds.has(item.id))
         .slice(0, useBoundedPage ? focusPage.length : limit)
         .map(projectFocusItem);
     const blockedFallbackUsed = rankedActiveItems.length === 0;
@@ -1409,12 +1415,16 @@ async function buildOptionalContextSections(params) {
         tests: has("tests") ? buildTestHealth(focusGroups.activeItems) : undefined,
     };
 }
-function buildContextSummaryExtras(needsAllItems, allItems, statusRegistry) {
-    if (!needsAllItems) {
-        return {};
-    }
+function buildContextSummaryExtras(allItems, statusRegistry, blockedIds) {
     const canceledStatus = normalizeStatusInput("canceled", statusRegistry);
+    const activeItems = allItems.filter((item) => statusRegistry.active_statuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
+    const inProgress = countContextStatus(activeItems, statusRegistry.in_progress_status, statusRegistry);
     return {
+        scope: "matching_items",
+        active_items: activeItems.length,
+        open: activeItems.length - inProgress,
+        in_progress: inProgress,
+        blocked: allItems.filter((item) => blockedIds.has(item.id.trim().toLowerCase())).length,
         total_items: allItems.length,
         closed: allItems.filter((item) => isClosedStatus(item.status, statusRegistry)).length,
         canceled: allItems.filter((item) => normalizeStatusForRegistry(item.status, statusRegistry) ===
@@ -1595,7 +1605,7 @@ export async function runContext(options, global) {
     // Single shared edge-aware blocked classification (GH-578): resolved against
     // the full corpus so terminal blocker targets count as satisfied at every depth.
     const blockedIds = collectDependencyBlockedIds(corpus.fullCorpus, runtime.statusRegistry);
-    const focusGroups = await resolveContextFocusGroups(corpus.listedItemMetadata, corpus.allItems, corpus.fullCorpus, blockedIds, runtime.statusRegistry, runtime.sectionsIncluded, runtime.limit, nowIso(), author, options.after, buildContextCursorFingerprint(options), shouldPageContextFocus(options, corpus.fullCorpus.length), pmRoot, runtime.tokenBudget, claimFocus);
+    const focusGroups = await resolveContextFocusGroups(corpus.listedItemMetadata, corpus.allItems, corpus.fullCorpus, blockedIds, runtime.statusRegistry, runtime.sectionsIncluded, runtime.limit, nowIso(), author, options.after, buildContextCursorFingerprint(options), shouldPageContextFocus(options, corpus.fullCorpus.length), pmRoot, runtime.tokenBudget, claimFocus, resolveItemTypeRegistry(runtime.settings, getActiveExtensionRegistrations()));
     const agendaContext = await buildContextAgenda(global, runtime, corpus.subtreeIds, new Set([
         ...focusGroups.highLevel,
         ...focusGroups.lowLevel,
@@ -1618,7 +1628,7 @@ export async function runContext(options, global) {
         now: agendaContext.agenda.now,
         global,
     });
-    const summaryExtras = buildContextSummaryExtras(contextNeedsAllItems(runtime.sectionsIncluded), corpus.allItems, runtime.statusRegistry);
+    const summaryExtras = buildContextSummaryExtras(corpus.allItems, runtime.statusRegistry, blockedIds);
     const result = {
         output_default: "toon",
         now: agendaContext.agenda.now,
@@ -1649,10 +1659,12 @@ export async function runContext(options, global) {
                 {}),
         },
         summary: {
-            active_items: focusGroups.activeItems.length,
-            in_progress: inProgressCount,
-            open: openCount,
-            blocked: focusGroups.blockedItems.length,
+            returned_focus: {
+                active_items: focusGroups.activeItems.length,
+                in_progress: inProgressCount,
+                open: openCount,
+                blocked: focusGroups.blockedItems.length,
+            },
             blocked_fallback_used: focusGroups.blockedFallbackUsed,
             high_level: focusGroups.highLevel.length,
             low_level: focusGroups.lowLevel.length,
@@ -1688,4 +1700,4 @@ export async function runContext(options, global) {
     return result;
 }
 //# sourceMappingURL=context.js.map
-//# debugId=56205e5f-fc26-59ab-abdf-45bdcaf1c263
+//# debugId=4f8e82a2-f4ea-5ecb-8ef5-3ca795cdeda5

package/dist/sdk/query/get.d.ts

@@ -52,8 +52,8 @@ export interface GetResult {
     schedule?: Partial<ItemScheduleContext>;
     /** True when the item was reconstructed from immutable history. */
     reconstructed?: true;
-    /** One-based history version represented by a reconstructed read. */
-    as_of_version?: number;
+    /** Durable version, or null when legacy compaction lost the numeric mapping. */
+    as_of_version?: number | null;
     /** Timestamp of the last history entry included in a reconstructed read. */
     as_of_timestamp?: string;
     /** Value that configures or reports tree for this contract. */

package/dist/sdk/query/get.js

@@ -4,7 +4,7 @@
  * Implements the SDK-owned item query shared by every surface.
  */
 
-!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]="ff82974e-a48d-5d18-893f-fb618e378795")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="16112e3d-b640-5114-a2c2-5effc655fe50")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
 import { getActiveExtensionRegistrations, toItemRecord, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, TYPE_TO_FOLDER, PmCliError, buildItemNotFoundError, listAllItemMetadataLight, locateItem, readLocatedItem, getHistoryPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { readHistoryEntries } from "../history-read.js";
@@ -310,6 +310,7 @@ function shouldIncludeGetField(params) {
     }
     return depth !== "brief";
 }
+/** Derive claim evidence from the selected physical history prefix, excluding future claims. */
 async function resolveGetClaimState(context, includeClaimState) {
     if (!includeClaimState) {
         return undefined;
@@ -317,7 +318,7 @@ async function resolveGetClaimState(context, includeClaimState) {
     const historyPath = getHistoryPath(context.pmRoot, context.locatedId);
     const history = await readHistoryEntries(historyPath, context.locatedId);
     return resolveClaimStateContext(context.metadata.assignee, context.historical
-        ? history.slice(0, context.historical.as_of_version)
+        ? history.slice(0, context.historical.target.historyIndex + 1)
         : history);
 }
 function attachGetLinked(result, context, fields, includeLinked) {
@@ -447,4 +448,4 @@ export const _testOnlyGetCommand = {
     shouldAutoIncludeGetChildren,
 };
 //# sourceMappingURL=get.js.map
-//# debugId=ff82974e-a48d-5d18-893f-fb618e378795
+//# debugId=16112e3d-b640-5114-a2c2-5effc655fe50

package/dist/sdk/query/history.d.ts

@@ -32,6 +32,8 @@ export interface HistoryCommandOptions {
 export interface HistoryDiffEntry {
     /** Value that configures or reports index for this contract. */
     index: number;
+    /** Durable version address after compaction; null for unmapped legacy checkpoints. */
+    version?: number | null;
     /** Value that configures or reports ts for this contract. */
     ts: string;
     /** Value that configures or reports op for this contract. */
@@ -74,6 +76,15 @@ export interface HistoryResult {
     verification?: HistoryVerificationResult;
     /** Constant-size provenance completeness metrics. */
     provenance_summary?: HistoryProvenanceSummary;
+    /** Present after compaction; row indices remain physical stream positions. */
+    version_addressing?: {
+        /** Add to a physical one-based index; null when the original mapping is lost. */
+        offset: number | null;
+        /** Earliest reconstructable original version, or null for legacy checkpoints. */
+        first_version: number | null;
+        /** Latest addressable version, including maintenance audit events. */
+        last_version: number | null;
+    };
 }
 /** Implements run history for the public runtime surface of this module. */
 export declare function runHistory(id: string, options: HistoryCommandOptions, global: GlobalOptions): Promise<HistoryResult>;

package/dist/sdk/query/history.js

@@ -4,8 +4,9 @@
  * Implements the pm history command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="314adea1-6837-5eeb-abc3-57337a495221")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="13e944b0-f049-55e5-8ff8-6335ce888b65")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { historyVersionOffset } from "../../core/history/version-address.js";
 import { pathExists, computeHistoryDiff, patchPathToChangedField, normalizeReplayPatchOps, verifyHistoryChain, enforceHistoryStreamPolicyForItem, EXIT_CODE, PmCliError, getActiveExtensionRegistrations, normalizeItemId, resolveItemTypeRegistry, locateItem, readLocatedItem, getHistoryPath, getWorkspaceHistoryPath, inspectWorkspaceHistoryState, resolvePmRoot, readSettings, WORKSPACE_HISTORY_ID, } from "../runtime-primitives.js";
 import { readHistoryEntries, verifyHistoryEntries, } from "../history-read.js";
 export { readHistoryEntries } from "../history-read.js";
@@ -18,8 +19,9 @@ function limitEntries(values, limit) {
         return values;
     return values.slice(Math.max(0, values.length - limit));
 }
-function buildDiffEntries(entries, startIndex) {
-    return entries.map((entry, index) => {
+/** Summarize patch fields with physical indices and separately mapped durable versions. */
+function buildDiffEntries(entries, addressing) {
+    return entries.map(({ entry, version }) => {
         const changedFields = new Set();
         const patch = normalizeReplayPatchOps(entry.patch);
         for (const op of patch) {
@@ -29,7 +31,8 @@ function buildDiffEntries(entries, startIndex) {
             }
         }
         return {
-            index: startIndex + index + 1,
+            index: version,
+            ...(addressing ? { version: addressing.offset === null ? null : addressing.offset + version } : {}),
             ts: entry.ts,
             op: entry.op,
             author: entry.author,
@@ -38,6 +41,17 @@ function buildDiffEntries(entries, startIndex) {
         };
     });
 }
+/** Describe the checkpoint mapping without changing physical diagnostic indices. */
+function buildVersionAddressing(history) {
+    if (history[0]?.op !== "history_compact_baseline")
+        return undefined;
+    const offset = historyVersionOffset(history, true);
+    return {
+        offset,
+        first_version: offset === null ? null : offset + 1,
+        last_version: offset === null ? null : offset + history.length,
+    };
+}
 async function resolveHistoryReadTarget(id, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     await assertInitializedTracker(pmRoot);
@@ -71,6 +85,7 @@ export async function runHistory(id, options, global) {
     const limit = parseLimit(options.limit);
     const { historyPath, located, resolvedId, settings } = await resolveHistoryReadTarget(id, global);
     const fullHistory = await readHistoryEntries(historyPath, resolvedId);
+    const addressing = buildVersionAddressing(fullHistory);
     const vocabulary = settings.agent_identity.identity_vocabulary;
     const provenanceDimensions = resolveHistoryProvenanceDimensions(settings.agent_identity.harness_signals);
     const matchesProvenance = compileHistoryProvenanceMatcher({
@@ -78,19 +93,18 @@ export async function runHistory(id, options, global) {
         agentInstance: options.agentInstance,
         provenance: options.provenanceFilter,
     }, vocabulary, provenanceDimensions);
-    const filteredHistory = fullHistory
-        .map((entry, index) => ({ entry, version: index + 1 }))
+    const filteredHistory = indexHistoryEntries(fullHistory)
         .filter(({ entry }) => matchesProvenance(entry));
     const selectedHistory = limitEntries(filteredHistory, limit);
     const history = selectedHistory.map(({ entry }) => entry);
     const compact = options.compact === true;
     const compactHistory = compact
-        ? buildDiffEntries(history, Math.max(0, fullHistory.length - history.length))
+        ? buildDiffEntries(selectedHistory, addressing)
         : undefined;
     const provenanceHistory = options.provenance === true
-        ? selectedHistory.map(({ entry, version }) => projectHistoryProvenance(entry, vocabulary, {
+        ? selectedHistory.map(({ entry, durableVersion }) => projectHistoryProvenance(entry, vocabulary, {
             itemId: resolvedId,
-            version,
+            version: durableVersion,
         }))
         : undefined;
     const projectionMode = options.provenance === true ? "provenance" : compact ? "compact" : "full";
@@ -115,6 +129,7 @@ export async function runHistory(id, options, global) {
         omission_receipt: resolveModePairedOutputOmissionReceipt("history", projectionMode),
         count: history.length,
         limit: limit ?? null,
+        version_addressing: addressing,
         ...(options.provenanceSummary === true
             ? {
                 provenance_summary: summarizeHistoryProvenance(filteredHistory.map(({ entry }) => entry), vocabulary, provenanceDimensions),
@@ -159,5 +174,14 @@ export async function runHistory(id, options, global) {
     }
     return result;
 }
+/** Attach physical and durable coordinates before filtering or limiting the stream. */
+function indexHistoryEntries(history) {
+    const offset = historyVersionOffset(history, true);
+    return history.map((entry, index) => ({
+        entry,
+        version: index + 1,
+        durableVersion: offset === null ? undefined : offset + index + 1,
+    }));
+}
 //# sourceMappingURL=history.js.map
-//# debugId=314adea1-6837-5eeb-abc3-57337a495221
+//# debugId=13e944b0-f049-55e5-8ff8-6335ce888b65

package/dist/sdk/query/next.d.ts

@@ -10,6 +10,7 @@
  */
 import { type ActionableEntry } from "../actionability.js";
 import { type GlobalOptions } from "../runtime-primitives.js";
+import type { ItemTypeRegistry } from "../../core/item/type-registry.js";
 import type { ItemStatus } from "../../types/index.js";
 import { type ContextFocusItem, type ContextRankingSummary, type ContextPackingSummary } from "./context.js";
 /** Supported values accepted by the next output contract. */
@@ -48,6 +49,10 @@ export interface NextOptions {
     tokenBudget?: string | number;
     /** Include human-gated Decision items in the claimable ready queue. */
     includeDecisions?: boolean;
+    /** Opt into gate-shaped leaf work; blockers and ownership restrictions still apply. */
+    includeGates?: boolean;
+    /** Opt into containers with unfinished descendants; blockers and ownership restrictions still apply. */
+    includeContainers?: boolean;
     /** Internal caller override used to align claim-next ranking with --author. */
     callerAuthor?: string;
     [key: string]: unknown;
@@ -95,6 +100,7 @@ interface NextSummary {
     candidates: number;
     containers: number;
     decision_needed: number;
+    gate_needed?: number;
     held_by_others: number;
 }
 /** Documents the `pm next` result payload exchanged by command, SDK, and package integrations. */
@@ -109,6 +115,10 @@ export interface NextResult {
     ready: NextActionableItem[];
     /** Human-gated decisions kept visible without dispatching them to agents. */
     decision_needed: NextActionableItem[];
+    /** Outcome gates held out of autonomous dispatch. */
+    gate_needed?: NextActionableItem[];
+    /** Containers with unfinished descendants, retained as readable worklists. */
+    containers?: NextActionableItem[];
     /** Value that configures or reports blocked for this contract. */
     blocked: NextActionableItem[];
     /** Value that configures or reports held by others for this contract. */
@@ -132,6 +142,8 @@ export interface NextResult {
         blocked_limit: number;
         ready_only: boolean;
         include_decisions: boolean;
+        include_gates?: boolean;
+        include_containers?: boolean;
         token_budget: number;
     };
     /** Value that configures or reports suggestions for this contract. */
@@ -146,6 +158,8 @@ export interface NextResult {
     truncation?: {
         decision_needed_total?: number;
         held_by_others_total?: number;
+        gate_needed_total?: number;
+        containers_total?: number;
     };
 }
 /** 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`. */
@@ -163,7 +177,7 @@ export declare const _testOnlyNextCommand: {
     resolveNextCallerAuthor: (options: NextOptions, settingsAuthor: string) => string;
 };
 /** Separates human-gated decisions from autonomous agent work unless the caller explicitly opts into decision claims. */
-export declare function partitionDecisionEntries(ready: ActionableEntry[], includeDecisions: boolean): {
+export declare function partitionDecisionEntries(ready: ActionableEntry[], includeDecisions: boolean, typeRegistry?: ItemTypeRegistry): {
     agent: ActionableEntry[];
     decisions: ActionableEntry[];
 };

package/dist/sdk/query/next.js

@@ -9,9 +9,10 @@
  * 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]="b0f3d72c-ff0b-59bb-a6bc-8476eb9fb6c1")}catch(e){}}();
-import { collectBlockedByIds, computeActionabilityReport, } from "../actionability.js";
-import { resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, nowIso, normalizeStatusInput, normalizeStatusForRegistry, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.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]="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";
@@ -94,7 +95,7 @@ function buildRecommendationReasons(entry, statusRegistry, now, completedContain
         reasons.push(`advances ${item.parent.trim()}`);
     }
     if (entry.unblocks.length > 0) {
-        reasons.push(`unblocks ${entry.unblocks.length} item(s): ${entry.unblocks.join(", ")}`);
+        reasons.push(`unblocks ${entry.unblocks.length} item(s)`);
     }
     return reasons;
 }
@@ -118,12 +119,12 @@ export const _testOnlyNextCommand = {
     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) {
-    const decisions = ready.filter((entry) => entry.item.type.trim().toLowerCase() === "decision");
+export function partitionDecisionEntries(ready, includeDecisions, typeRegistry) {
+    const decisions = ready.filter((entry) => resolveItemExecutionRole(entry.item.type, typeRegistry) === "human");
     return {
         agent: includeDecisions
             ? ready
-            : ready.filter((entry) => entry.item.type.trim().toLowerCase() !== "decision"),
+            : ready.filter((entry) => resolveItemExecutionRole(entry.item.type, typeRegistry) !== "human"),
         decisions: includeDecisions ? [] : decisions,
     };
 }
@@ -195,13 +196,17 @@ function buildNextRecommendation(params) {
         reasons: buildRecommendationReasons(params.projectedReady[0], params.statusRegistry, params.now, params.completedContainer),
     };
 }
-function buildNextSuggestions(recommended, blockedRows) {
+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`,
@@ -210,6 +215,7 @@ function buildNextSuggestions(recommended, blockedRows) {
         ];
     }
     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",
@@ -271,7 +277,7 @@ async function finalizeNextResult(params) {
         params.result.ranking = toContextRankingSummary(params.readyRanking, params.featureStore);
         params.result.packing = toContextPackingSummary(params.packing);
     }
-    params.result.suggestions = buildNextSuggestions(params.recommended, params.blockedRows);
+    params.result.suggestions = buildNextSuggestions(params.recommended, params.blockedRows, params.gateCount);
     await attachNextUsageFeedback({
         result: params.result,
         pmRoot: params.pmRoot,
@@ -291,9 +297,9 @@ function filterCandidatesByParentScope(candidates, corpus, parentScope) {
     }
     return candidates.filter((item) => subtree.ids.has(item.id.trim().toLowerCase()));
 }
-async function rankReadyEntriesWithRelevance(rankedReady, childrenByParent, statusRegistry, now, callerAuthor, pmRoot, tokenBudget) {
+async function rankReadyEntriesWithRelevance(rankedReady, childrenByParent, statusRegistry, now, callerAuthor, pmRoot, tokenBudget, includeContainers) {
     const concreteReady = rankedReady.filter((entry) => !hasCompletedDescendants(entry.item, childrenByParent));
-    const structuralReady = concreteReady.length > 0 ? concreteReady : rankedReady;
+    const structuralReady = includeContainers || concreteReady.length === 0 ? rankedReady : concreteReady;
     const usage = await readContextUsageAffinity({
         pmRoot,
         author: callerAuthor,
@@ -316,7 +322,7 @@ async function rankReadyEntriesWithRelevance(rankedReady, childrenByParent, stat
     return {
         projectedReady,
         ranking,
-        completedContainer: concreteReady.length === 0,
+        completedContainer: concreteReady.length === 0 && !includeContainers,
         packing,
         featureStore,
     };
@@ -335,6 +341,7 @@ export async function runNext(options, global) {
     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));
@@ -350,16 +357,18 @@ export async function runNext(options, 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);
+    const report = computeActionabilityReport(candidates, corpus, statusRegistry, typeRegistry);
     const childrenByParent = buildChildrenByParent(corpus);
-    const partitionedByDecision = partitionDecisionEntries(report.ready, options.includeDecisions === true);
-    const callerPartition = partitionCallerOwnedReady(partitionedByDecision.agent, settings.author_default, callerAuthor);
+    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);
+    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(partitionedByDecision.decisions, childrenByParent, statusRegistry).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,
@@ -367,13 +376,19 @@ export async function runNext(options, global) {
         now,
         completedContainer,
     });
-    const truncation = buildNextTruncation(decisionRows.length, callerPartition.held.length, limit);
+    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: {
@@ -384,6 +399,7 @@ export async function runNext(options, global) {
             candidates: report.active_count,
             containers: report.container_count,
             decision_needed: decisionRows.length,
+            gate_needed: gateRows.length,
             held_by_others: callerPartition.held.length,
         },
         filters: {
@@ -399,14 +415,17 @@ export async function runNext(options, global) {
             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,
+        truncation: Object.keys(truncation).length > 0 ? truncation : undefined,
     };
     return finalizeNextResult({
         result,
         recommended,
         blockedRows,
+        gateCount: gateRows.length,
         candidatesWarnings: candidatesList.warnings,
         corpusWarnings: corpusList.warnings,
         readyRanking,
@@ -424,6 +443,10 @@ export async function runNext(options, global) {
  */
 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
@@ -488,4 +511,4 @@ function formatNextLine(item) {
     return `${rankToken}${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;
 }
 //# sourceMappingURL=next.js.map
-//# debugId=b0f3d72c-ff0b-59bb-a6bc-8476eb9fb6c1
+//# debugId=6035e85b-81ed-512e-b291-b0d86af1848b

package/dist/sdk/query.d.ts

@@ -13,6 +13,7 @@ export { CONTEXT_OUTPUT_VALUES, applyContextTagProjection, buildChildrenByParent
 export * from "./query/get.js";
 export * from "./query/history.js";
 export * from "./query/next.js";
+export * from "./actionability.js";
 export * from "./query/search-pagination.js";
 export * from "./query/search-rendering.js";
 export * from "./query/item-filter-options.js";

package/dist/sdk/query.js

@@ -4,7 +4,7 @@
  * Provides focused read, search, pagination, and context-ranking primitives.
  */
 
-!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]="036baf5a-3ba9-55ea-a11b-d9e94a848b92")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="214c6bc1-313b-53c1-883a-d2d0536f8aea")}catch(e){}}();
 export * from "./query/list.js";
 export * from "./query/complete-list.js";
 export * from "./query/search.js";
@@ -15,6 +15,7 @@ export { CONTEXT_OUTPUT_VALUES, applyContextTagProjection, buildChildrenByParent
 export * from "./query/get.js";
 export * from "./query/history.js";
 export * from "./query/next.js";
+export * from "./actionability.js";
 export * from "./query/search-pagination.js";
 export * from "./query/search-rendering.js";
 export * from "./query/item-filter-options.js";
@@ -30,4 +31,4 @@ export * from "./context-usage.js";
 export * from "./workspace-memory.js";
 export * from "./duplicates.js";
 //# sourceMappingURL=query.js.map
-//# debugId=036baf5a-3ba9-55ea-a11b-d9e94a848b92
+//# debugId=214c6bc1-313b-53c1-883a-d2d0536f8aea

package/dist/sdk/runtime-primitives.d.ts

@@ -17,10 +17,10 @@ export { isFileMissingError, pathExists, readFileIfExists, removeFileIfExists, w
 export { normalizeBulkIdsValue, parseBulkIdsText, resolveCliBulkIdsInput, type BulkIdsFileReader, type BulkIdsInputReaders, type BulkIdsStdinReader, type BulkIdsValue, } from "../core/io/bulk-ids-input.js";
 export { type HistoryDiffValueEntry, computeHistoryDiff, patchPathToChangedField, } from "../core/history/history-diff.js";
 export { enforceHistoryStreamPolicyForItem, enforceHistoryStreamPolicyForItems, } from "../core/history/history-stream-policy.js";
-export { appendHistoryEntry, CURRENT_HISTORY_ITEM_HASH_VERSION, createHistoryEntry, hashDocument, hashDocumentForVersion, hashEmptyDocument, SUPPORTED_HISTORY_ITEM_HASH_VERSIONS, type HistoryItemHashVersion, } from "../core/history/history.js";
+export { appendHistoryEntry, CURRENT_HISTORY_ITEM_HASH_VERSION, CURRENT_HISTORY_RECORD_HASH_VERSION, createHistoryEntry, hashDocument, hashDocumentForVersion, hashEmptyDocument, hashHistoryPatch, hashHistoryRecord, hashHistoryStream, resealHistoryRewrite, sealHistoryRecord, SUPPORTED_HISTORY_ITEM_HASH_VERSIONS, SUPPORTED_HISTORY_RECORD_HASH_VERSIONS, verifyHistoryRecordHash, verifyHistoryRewriteEvidence, type HistoryItemHashVersion, type HistoryRecordHashVersion, } from "../core/history/history.js";
 export { readHistoryEntries } from "../core/history/read.js";
 export { appendWorkspaceAuditEvent, appendWorkspaceHistoryChange, getWorkspaceHistoryPath, inspectWorkspaceHistoryState, mutateWorkspaceJsonWithHistory, reconcileWorkspaceJsonHistory, restoreWorkspaceJsonFromHistory, WORKSPACE_HISTORY_ID, writeWorkspaceJsonWithHistory, type WorkspaceAuditEventOptions, type WorkspaceHistoryChange, type WorkspaceHistoryStateAgreement, type WorkspaceJsonMutation, type WorkspaceJsonMutationOptions, type WorkspaceJsonReconciliationOptions, type WorkspaceJsonRestoreOptions, type WorkspaceJsonRestoreResult, type WorkspaceJsonWriteOptions, } from "../core/history/workspace-history.js";
-export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, verifyHistoryChainWithVersion, } from "../core/history/replay.js";
+export { normalizeReplayPatchOps, reanchorHistoryEntries, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, verifyHistoryChainWithVersion, } from "../core/history/replay.js";
 export { resolveBodyFileContent } from "../core/io/body-file.js";
 export { generateItemId, normalizeItemId, normalizeRawItemId, } from "../core/item/id.js";
 export { canonicalDocument, normalizeItemMetadata, parseItemDocument, serializeItemDocument, } from "../core/item/item-format.js";
@@ -34,7 +34,7 @@ export { isTerminalStatus, normalizeStatusForRegistry, normalizeStatusInput, } f
 export { COMMON_MUTATION_COMMAND_OPTION_KEYS, type ItemTypeRegistry, type ResolvedItemTypeDefinition, canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveItemTypeRegistry, resolveTypeDefinition, resolveTypeName, validateTypeOptions, } from "../core/item/type-registry.js";
 export { resolveTypeSynonym } from "../core/item/type-synonyms.js";
 export { acquireLock } from "../core/lock/lock.js";
-export { printError, printResult, writeStdout } from "../core/output/output.js";
+export { printError, printResult, writeStderr, writeStdout } from "../core/output/output.js";
 export { renderRowsAsCsv, renderRowsAsTable } from "../core/output/tabular.js";
 export { parseLimit } from "../core/shared/numeric-parsers.js";
 export { resolveConfiguredPmPackageRoot, resolvePmCliVersion, resolvePmPackageRootFromModule, } from "../core/packages/root.js";