@unbrained/pm-cli 2026.8.29 → 2026.8.31

package/dist/core/schema/runtime-schema.d.ts

@@ -75,6 +75,10 @@ export interface RuntimeStatusRegistry {
     draft_statuses: Set<string>;
     /** Configured status id representing the open lifecycle state. */
     open_status: string;
+    /** Configured status id representing the in-progress lifecycle state. */
+    in_progress_status: string;
+    /** Configured status id representing the blocked lifecycle state. */
+    blocked_status: string;
     /** Configured status id representing the closed lifecycle state. */
     close_status: string;
     /** Configured status id representing the canceled lifecycle state. */

package/dist/core/schema/runtime-schema.js

@@ -4,7 +4,7 @@
  * Resolves configurable schema, fields, statuses, and workflows for Runtime Schema.
  */
 
-!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]="88b9179f-569e-5cd6-b67c-c27431961554")}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]="633ef301-42a3-5b73-a4ed-7af0e0e40371")}catch(e){}}();
 import path from "node:path";
 import { pathExists, readFileIfExists, writeFileAtomic, } from "../fs/fs-utils.js";
 import { DEFAULT_STATUS_DEFINITIONS, DEFAULT_WORKFLOW_DEFINITION, } from "../shared/constants.js";
@@ -52,8 +52,7 @@ const RUNTIME_FIELD_VALUE_SCHEMA_SHAPE_VALIDATORS = [
         (Array.isArray(schema.enum) &&
             schema.enum.every((entry) => isStructuredJsonValue(entry))),
     (schema) => schema.min_length === undefined ||
-        (Number.isInteger(schema.min_length) &&
-            schema.min_length >= 0),
+        (Number.isInteger(schema.min_length) && schema.min_length >= 0),
     (schema) => schema.min_items === undefined ||
         (Number.isInteger(schema.min_items) && schema.min_items >= 0),
     (schema) => schema.format === undefined || schema.format === "date-time",
@@ -62,8 +61,7 @@ const RUNTIME_FIELD_VALUE_SCHEMA_SHAPE_VALIDATORS = [
             schema.required.every((entry) => typeof entry === "string" && entry.length > 0)),
     (schema) => schema.additional_properties === undefined ||
         typeof schema.additional_properties === "boolean",
-    (schema) => schema.properties === undefined ||
-        isPlainObject(schema.properties),
+    (schema) => schema.properties === undefined || isPlainObject(schema.properties),
     (schema) => schema.one_of === undefined ||
         (Array.isArray(schema.one_of) && schema.one_of.length > 0),
 ];
@@ -137,9 +135,7 @@ function normalizeRuntimeFieldValueSchema(value, depth = 0, ancestors = new Set(
         min_items: minItems,
         format: format,
         properties: normalizedProperties,
-        required: required === undefined
-            ? undefined
-            : [...new Set(required)],
+        required: required === undefined ? undefined : [...new Set(required)],
         additional_properties: additionalProperties,
         items: normalizedItems,
         one_of: normalizedOneOf,
@@ -329,7 +325,10 @@ function normalizeRuntimeFieldDefinition(definition) {
         description: description && description.length > 0 ? description : undefined,
         type,
         commands,
-        repeatable: [definition.repeatable === true, type === "string_array"].includes(true),
+        repeatable: [
+            definition.repeatable === true,
+            type === "string_array",
+        ].includes(true),
         required: definition.required === true,
         required_on_create: definition.required_on_create === true,
         required_types: requiredTypes,
@@ -658,27 +657,22 @@ export async function loadRuntimeSchemaFromOptionalFiles(pmRoot, schema) {
         created_paths: [],
     };
 }
-function preferredStatusForRole(definitions, role, fallbackValues) {
-    const withRole = definitions.filter((definition) => definition.roles.includes(role));
-    if (withRole.length > 0) {
-        return withRole[0].id;
-    }
+function preferredStatusForRole(definitions, role, fallbackValues, fallbackFirst = false) {
     const normalizedFallbacks = fallbackValues
         .map((value) => normalizeStatusId(value))
         .filter((value) => typeof value === "string");
-    for (const normalized of normalizedFallbacks) {
-        if (definitions.some((definition) => definition.id === normalized)) {
-            return normalized;
-        }
+    const fallbackMatch = normalizedFallbacks.find((normalized) => definitions.some((definition) => definition.id === normalized));
+    if (fallbackFirst && fallbackMatch !== undefined) {
+        return fallbackMatch;
     }
-    return definitions[0]?.id;
+    const withRole = definitions.find((definition) => definition.roles.includes(role));
+    if (withRole !== undefined) {
+        return withRole.id;
+    }
+    return fallbackMatch ?? definitions[0]?.id;
 }
-/** Implements resolve runtime status registry for the public runtime surface of this module. */
-export function resolveRuntimeStatusRegistry(schema) {
-    const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
-    const definitions = normalizedSchema.statuses
-        .map((definition, index) => normalizeRuntimeStatusDefinition(definition, index))
-        .filter((definition) => definition !== null);
+/** Build normalized identifier and alias indexes for runtime status lookup. */
+function buildRuntimeStatusIndexes(definitions) {
     const aliasToId = new Map();
     const byId = new Map();
     for (const definition of definitions) {
@@ -692,42 +686,58 @@ export function resolveRuntimeStatusRegistry(schema) {
             aliasToId.set(alias.replaceAll("_", " "), definition.id);
         }
     }
-    const terminalStatuses = new Set();
-    const terminalDoneStatuses = new Set();
-    const terminalCanceledStatuses = new Set();
-    const activeStatuses = new Set();
-    const blockedStatuses = new Set();
-    const draftStatuses = new Set();
+    return { aliasToId, byId };
+}
+/** Classify runtime statuses into lifecycle role sets used by all consumers. */
+function buildRuntimeStatusRoleSets(definitions) {
+    const result = {
+        activeStatuses: new Set(),
+        blockedStatuses: new Set(),
+        draftStatuses: new Set(),
+        terminalCanceledStatuses: new Set(),
+        terminalDoneStatuses: new Set(),
+        terminalStatuses: new Set(),
+    };
     for (const definition of definitions) {
         const roles = new Set(definition.roles);
         if (roles.has("terminal") ||
             roles.has("terminal_done") ||
             roles.has("terminal_canceled")) {
-            terminalStatuses.add(definition.id);
-        }
-        if (roles.has("terminal_done")) {
-            terminalDoneStatuses.add(definition.id);
+            result.terminalStatuses.add(definition.id);
         }
+        if (roles.has("terminal_done"))
+            result.terminalDoneStatuses.add(definition.id);
         if (roles.has("terminal_canceled")) {
-            terminalCanceledStatuses.add(definition.id);
-        }
-        if (roles.has("active")) {
-            activeStatuses.add(definition.id);
-        }
-        if (roles.has("blocked")) {
-            blockedStatuses.add(definition.id);
-        }
-        if (roles.has("draft")) {
-            draftStatuses.add(definition.id);
+            result.terminalCanceledStatuses.add(definition.id);
         }
+        if (roles.has("active"))
+            result.activeStatuses.add(definition.id);
+        if (roles.has("blocked"))
+            result.blockedStatuses.add(definition.id);
+        if (roles.has("draft"))
+            result.draftStatuses.add(definition.id);
     }
+    return result;
+}
+/** Implements resolve runtime status registry for the public runtime surface of this module. */
+export function resolveRuntimeStatusRegistry(schema) {
+    const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
+    const definitions = normalizedSchema.statuses
+        .map((definition, index) => normalizeRuntimeStatusDefinition(definition, index))
+        .filter((definition) => definition !== null);
+    const { aliasToId, byId } = buildRuntimeStatusIndexes(definitions);
+    const { activeStatuses, blockedStatuses, draftStatuses, terminalCanceledStatuses, terminalDoneStatuses, terminalStatuses, } = buildRuntimeStatusRoleSets(definitions);
     const workflow = normalizedSchema.workflow;
-    const openStatus = normalizeStatusId(workflow.open_status) ??
+    const openStatus = (normalizeStatusId(workflow.open_status) ??
         preferredStatusForRole(definitions, "default_open", [
             "open",
             "in_progress",
             STATUS_VALUES[0],
-        ]);
+        ]));
+    const inProgressStatus = normalizeStatusId(workflow.in_progress_status) ??
+        preferredStatusForRole(definitions, "active", ["in_progress", "in-progress", openStatus], true);
+    const blockedStatus = normalizeStatusId(workflow.blocked_status) ??
+        preferredStatusForRole(definitions, "blocked", ["blocked"]);
     const closeStatus = normalizeStatusId(workflow.close_status) ??
         preferredStatusForRole(definitions, "default_close", [
             "closed",
@@ -750,6 +760,8 @@ export function resolveRuntimeStatusRegistry(schema) {
         blocked_statuses: blockedStatuses,
         draft_statuses: draftStatuses,
         open_status: openStatus,
+        in_progress_status: inProgressStatus,
+        blocked_status: blockedStatus,
         close_status: closeStatus,
         canceled_status: canceledStatus,
     };
@@ -812,4 +824,4 @@ export function statusIsTerminal(status, registry) {
     return registry.terminal_statuses.has(normalized);
 }
 //# sourceMappingURL=runtime-schema.js.map
-//# debugId=88b9179f-569e-5cd6-b67c-c27431961554
+//# debugId=633ef301-42a3-5b73-a4ed-7af0e0e40371

package/dist/core/schema/status-defs-file.js

@@ -4,7 +4,7 @@
  * Resolves configurable schema, fields, statuses, and workflows for Status Defs File.
  */
 
-!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]="3eac0218-43c9-5bd2-8eaf-589d02d2c8ad")}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]="ec456832-5120-5171-93fd-861ea4125acb")}catch(e){}}();
 import { RUNTIME_STATUS_ROLE_VALUES } from "../../types/index.js";
 import { DEFAULT_RUNTIME_STATUS_DEFINITIONS } from "./runtime-schema.js";
 import { normalizeStatusToken } from "./status-token.js";
@@ -72,6 +72,9 @@ export function normalizeAddStatusInput(raw) {
                 roles.push(role);
             }
         }
+        if (roles.length === 0) {
+            throw new Error(`Status role must include at least one lifecycle role. Allowed roles: ${RUNTIME_STATUS_ROLE_VALUES.join(", ")}.`);
+        }
     }
     const aliases = raw.aliases === undefined
         ? undefined
@@ -222,4 +225,4 @@ export function assertStatusTokensAvailable(input, resolvedAliasToId) {
     }
 }
 //# sourceMappingURL=status-defs-file.js.map
-//# debugId=3eac0218-43c9-5bd2-8eaf-589d02d2c8ad
+//# debugId=ec456832-5120-5171-93fd-861ea4125acb

package/dist/mcp/legacy-adapter.d.ts

@@ -1,11 +1,11 @@
 /**
  * @module mcp/legacy-adapter
  *
- * Isolates the bounded MCP 2025-06-18 stdio compatibility surface from the
+ * Isolates the bounded initialize-era stdio compatibility surface from the
  * canonical stateless dispatcher. No modern transport imports policy from it.
  */
 import { type AgentClientInfo } from "../sdk/runtime-primitives.js";
-import { type PmMcpImplementation, type PmMcpServerCapabilities } from "../sdk/mcp/protocol.js";
+import { PM_MCP_LEGACY_PROTOCOL_VERSIONS, type PmMcpImplementation, type PmMcpServerCapabilities } from "../sdk/mcp/protocol.js";
 /** Minimal request shape consumed by the compatibility adapter. */
 export interface LegacyMcpRequest {
     /** Legacy method name. */
@@ -36,6 +36,15 @@ export interface LegacyMcpAdapterOptions {
     /** Render one legacy prompt. */
     getPrompt: (params: Record<string, unknown> | undefined) => Record<string, unknown>;
 }
+/**
+ * Resolve the legacy revision a handshake negotiates, or refuse with the full
+ * supported set.
+ *
+ * A legacy client has no fall-forward mechanism, so the refusal names every
+ * accepted legacy revision alongside the canonical modern one: the error text
+ * is the only diagnostic such a client can surface.
+ */
+export declare function resolveLegacyProtocolVersion(requestedVersion: unknown): (typeof PM_MCP_LEGACY_PROTOCOL_VERSIONS)[number];
 /** Explicit compatibility adapter with no cross-process or modern-session role. */
 export declare class LegacyMcpAdapter {
     #private;

package/dist/mcp/legacy-adapter.js

@@ -1,13 +1,34 @@
 /**
  * @module mcp/legacy-adapter
  *
- * Isolates the bounded MCP 2025-06-18 stdio compatibility surface from the
+ * Isolates the bounded initialize-era stdio compatibility surface from the
  * canonical stateless dispatcher. No modern transport imports policy from it.
  */
 
-!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]="6a1d9bca-7dac-5537-9930-a12d8049c8b8")}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]="75228af6-d015-596d-ac32-4f5e78cb3916")}catch(e){}}();
 import { PmCliError } from "../sdk/runtime-primitives.js";
 import { PM_MCP_ERROR_CODES, PM_MCP_LEGACY_PROTOCOL_VERSIONS, PM_MCP_PROTOCOL_VERSION, PmMcpProtocolError, } from "../sdk/mcp/protocol.js";
+/**
+ * Resolve the legacy revision a handshake negotiates, or refuse with the full
+ * supported set.
+ *
+ * A legacy client has no fall-forward mechanism, so the refusal names every
+ * accepted legacy revision alongside the canonical modern one: the error text
+ * is the only diagnostic such a client can surface.
+ */
+export function resolveLegacyProtocolVersion(requestedVersion) {
+    if (requestedVersion === undefined || requestedVersion === null) {
+        return PM_MCP_LEGACY_PROTOCOL_VERSIONS[0];
+    }
+    const accepted = PM_MCP_LEGACY_PROTOCOL_VERSIONS.find((candidate) => candidate === requestedVersion);
+    if (accepted)
+        return accepted;
+    throw new PmMcpProtocolError("Unsupported legacy MCP protocol version", PM_MCP_ERROR_CODES.unsupportedProtocolVersion, {
+        supported: [...PM_MCP_LEGACY_PROTOCOL_VERSIONS],
+        requested: requestedVersion,
+        modern: PM_MCP_PROTOCOL_VERSION,
+    });
+}
 /** Explicit compatibility adapter with no cross-process or modern-session role. */
 export class LegacyMcpAdapter {
     #options;
@@ -23,17 +44,10 @@ export class LegacyMcpAdapter {
     /** Validate and answer the historical initialize handshake. */
     initialize(params) {
         const requestedVersion = params?.protocolVersion;
-        if (typeof requestedVersion === "string" &&
-            !PM_MCP_LEGACY_PROTOCOL_VERSIONS.includes(requestedVersion)) {
-            throw new PmMcpProtocolError("Unsupported legacy MCP protocol version", PM_MCP_ERROR_CODES.unsupportedProtocolVersion, {
-                supported: [...PM_MCP_LEGACY_PROTOCOL_VERSIONS],
-                requested: requestedVersion,
-                modern: PM_MCP_PROTOCOL_VERSION,
-            });
-        }
+        const negotiatedVersion = resolveLegacyProtocolVersion(requestedVersion);
         this.#clientInfo = this.#options.parseClientInfo(params?.clientInfo);
         return {
-            protocolVersion: PM_MCP_LEGACY_PROTOCOL_VERSIONS[0],
+            protocolVersion: negotiatedVersion,
             capabilities: structuredClone(this.#options.capabilities),
             serverInfo: { ...this.#options.serverInfo },
             instructions: this.#options.instructions,
@@ -61,4 +75,4 @@ export class LegacyMcpAdapter {
     }
 }
 //# sourceMappingURL=legacy-adapter.js.map
-//# debugId=6a1d9bca-7dac-5537-9930-a12d8049c8b8
+//# debugId=75228af6-d015-596d-ac32-4f5e78cb3916

package/dist/sdk/cli-contracts/flag-contracts.d.ts

@@ -207,6 +207,8 @@ export declare const GRAPH_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EVAL_FLAG_CONTRACTS: CliFlagContract[];
 /** Public contract for guarded portable workspace snapshot command paths. */
 export declare const WORKSPACE_FLAG_CONTRACTS: CliFlagContract[];
+/** Flagless bounded workspace position read. */
+export declare const WORKSPACE_POSITION_FLAG_CONTRACTS: CliFlagContract[];
 /** Public contract for next flag contracts, shared by SDK and presentation-layer consumers. */
 export declare const NEXT_FLAG_CONTRACTS: CliFlagContract[];
 /** Public contract for search flag contracts, shared by SDK and presentation-layer consumers. */

package/dist/sdk/cli-contracts/flag-contracts.js

@@ -7,7 +7,7 @@
  * flag surface stays single-sourced across the CLI, SDK, and MCP boundaries.
  */
 
-!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]="bd6c497f-9fb0-5c47-a677-9dd6636dba02")}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]="789faf62-dfbf-56ff-9412-55adc5c12d3d")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { RESERVED_EXTENSION_HOST_FLAGS } from "../../core/extensions/reserved-host-flags.js";
 import { PM_POSITIONAL_ACTION_CONTRACTS, } from "./grammar-contracts.js";
@@ -1555,6 +1555,8 @@ export const WORKSPACE_FLAG_CONTRACTS = [
     { flag: "--author" },
     { flag: "--message" },
 ];
+/** Flagless bounded workspace position read. */
+export const WORKSPACE_POSITION_FLAG_CONTRACTS = [];
 /** Public contract for next flag contracts, shared by SDK and presentation-layer consumers. */
 export const NEXT_FLAG_CONTRACTS = [
     { flag: "--for", value_name: "intent" },
@@ -1709,6 +1711,7 @@ const ASSURANCE_FLAG_CONTRACT_INDEX = indexCliFlagContracts(ASSURANCE_FLAG_CONTR
 const POSITIONAL_ACTION_FLAG_INDEX_BY_PARENT = new Map([
     ["assurance", ASSURANCE_FLAG_CONTRACT_INDEX],
     ["plan", PLAN_FLAG_CONTRACT_INDEX],
+    ["workspace", indexCliFlagContracts(WORKSPACE_POSITION_FLAG_CONTRACTS)],
     ["workspace snapshot", indexCliFlagContracts(WORKSPACE_FLAG_CONTRACTS)],
 ]);
 /** Resolve every positional action's accepted flags against one parent contract. */
@@ -1770,6 +1773,7 @@ const SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
     ["next", NEXT_FLAG_CONTRACTS],
     ["eval", EVAL_FLAG_CONTRACTS],
     ["workspace", WORKSPACE_FLAG_CONTRACTS],
+    ["workspace position", WORKSPACE_POSITION_FLAG_CONTRACTS],
     ["workspace snapshot", WORKSPACE_FLAG_CONTRACTS],
     ["workspace snapshot create", WORKSPACE_FLAG_CONTRACTS],
     ["workspace snapshot list", WORKSPACE_FLAG_CONTRACTS],
@@ -1915,4 +1919,4 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     return normalizeUniqueStringList(all).join(" ");
 }
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=bd6c497f-9fb0-5c47-a677-9dd6636dba02
+//# debugId=789faf62-dfbf-56ff-9412-55adc5c12d3d

package/dist/sdk/cli-contracts/grammar-contracts.d.ts

@@ -53,7 +53,7 @@ export interface PmCommandPositionalContract {
 /** Discoverable positional action projected through help, contracts, and completion. */
 export interface PmPositionalActionContract extends PmCommandPositionalContract {
     /** Commander command that dispatches the action positionally. */
-    parent: "assurance" | "plan" | "workspace snapshot";
+    parent: "assurance" | "plan" | "workspace" | "workspace snapshot";
     /** Literal action token accepted in the parent's first positional slot. */
     action: string;
     /** Canonical flags applicable to this action-specific view. */

package/dist/sdk/cli-contracts/grammar-contracts.js

@@ -7,7 +7,7 @@
  * cannot silently bypass the architecture decision.
  */
 
-!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]="d0f4c030-0028-5acb-a438-210666118074")}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]="4efc5934-7d1b-517b-8b5e-eb2fe14379f2")}catch(e){}}();
 import { resolvePmCommandAlias, } from "./command-aliases.js";
 /** Canonical top-level domains an agent must retain to route pm operations. */
 export const PM_CLI_GRAMMAR_NOUNS = [
@@ -314,6 +314,15 @@ export const PM_POSITIONAL_ACTION_CONTRACTS = [
         description: "Analyze bounded defect-recurrence risk for a proposed change.",
         example: 'pm assurance risk --definition \'{"change":{"files":[]}}\'',
     },
+    {
+        command: "workspace position",
+        parent: "workspace",
+        action: "position",
+        slots: [],
+        accepted_flags: [],
+        description: "Read bounded merge-fence, receipt, history-drift, and next-action readiness.",
+        example: "pm workspace position",
+    },
     {
         command: "workspace snapshot create",
         parent: "workspace snapshot",
@@ -638,6 +647,7 @@ export const PM_COMMAND_DESTINATION_CONTRACTS = [
     ]),
     ...destinationRows("workspace", "workspace", "target_noun", "pm-pbyu", [
         "workspace",
+        "workspace position",
         "workspace snapshot",
         "workspace snapshot create",
         "workspace snapshot delete",
@@ -965,4 +975,4 @@ export function verifyPmCliGrammar(commands, aliases = [], destinations = PM_COM
     };
 }
 //# sourceMappingURL=grammar-contracts.js.map
-//# debugId=d0f4c030-0028-5acb-a438-210666118074
+//# debugId=4efc5934-7d1b-517b-8b5e-eb2fe14379f2

package/dist/sdk/cli-contracts/runtime-contracts.js

@@ -4,7 +4,7 @@
  * Implements the pm contracts 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]="a4c43fa6-9f2e-515c-ab47-d21ef5d7878e")}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]="1506e8bc-3350-5ef5-a40a-44509eb59317")}catch(e){}}();
 import { EXIT_CODE, SETTINGS_DEFAULTS, PmCliError, activateExtensions, getActiveExtensionRegistrations, loadExtensions, pathExists, commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 import { buildMcpToolContracts, } from "../../mcp/tool-definitions.js";
 import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_DEPRECATED_TOOL_ACTIONS, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, PM_COMMAND_ALIAS_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
@@ -367,6 +367,7 @@ const CORE_COMMAND_FLAG_CONTRACT_ENTRIES = [
     ["search", SEARCH_FLAG_CONTRACTS],
     ["eval", EVAL_FLAG_CONTRACTS],
     ["workspace", WORKSPACE_FLAG_CONTRACTS],
+    ["workspace position", []],
     ["workspace snapshot", WORKSPACE_FLAG_CONTRACTS],
     ["workspace snapshot create", WORKSPACE_FLAG_CONTRACTS],
     ["workspace snapshot list", WORKSPACE_FLAG_CONTRACTS],
@@ -2084,4 +2085,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=a4c43fa6-9f2e-515c-ab47-d21ef5d7878e
+//# debugId=1506e8bc-3350-5ef5-a40a-44509eb59317

package/dist/sdk/cli-contracts/tool-schema.js

@@ -7,7 +7,7 @@
  * consumers from a single source of truth.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="91de08b8-ad0b-5c61-a272-3c18cd3f083b")}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]="b81a68c1-565d-56f6-a0eb-35d2c737bdb7")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
 import { TOOL_CREATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, } from "./tool-option-contracts.js";
@@ -567,8 +567,9 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
         ],
     },
     workspace: {
-        required: ["subcommand", "snapshotAction"],
+        required: ["subcommand"],
         optional: [
+            "snapshotAction",
             "name",
             "target",
             "dryRun",
@@ -578,6 +579,13 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "lockTtlSeconds",
             "lockWaitMs",
         ],
+        conditionalRequired: [
+            {
+                property: "subcommand",
+                value: "snapshot",
+                required: ["snapshotAction"],
+            },
+        ],
     },
     meet: SCHEDULING_ACTION_SCHEMA_CONTRACT,
     event: SCHEDULING_ACTION_SCHEMA_CONTRACT,
@@ -1629,4 +1637,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=91de08b8-ad0b-5c61-a272-3c18cd3f083b
+//# debugId=b81a68c1-565d-56f6-a0eb-35d2c737bdb7

package/dist/sdk/generated/generated-error-code-catalog-part-2.js

@@ -1,6 +1,6 @@
 /** Generated partition 2 of the exhaustive error-code catalog. */
 
-!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]="015f826a-6490-56d1-8e26-131e5503d8f1")}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]="41e6f81d-ccb5-546c-9b26-3b78027528b5")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_2 = [
     {
         code: "missing_destination",
@@ -919,6 +919,18 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         canonical_code: "status_invalid",
         aliases: [],
     },
+    {
+        code: "status_lifecycle_role_required",
+        meaning: "Status lifecycle role required condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/schema.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "status_lifecycle_role_required",
+        aliases: [],
+    },
     {
         code: "stdin_json_invalid",
         meaning: "Stdin json invalid condition.",
@@ -2162,4 +2174,4 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-2.js.map
-//# debugId=015f826a-6490-56d1-8e26-131e5503d8f1
+//# debugId=41e6f81d-ccb5-546c-9b26-3b78027528b5

package/dist/sdk/governance/health.js

@@ -4,7 +4,7 @@
  * Implements the pm health 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]="3c68e4be-fd09-560c-9654-f270e5d7ba73")}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]="76693c03-9395-5bbf-bcc8-fa15e408f30f")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
@@ -50,6 +50,7 @@ import { inspectMergeReceiptEvidence, partitionMergeReceipts, } from "../merge/r
 import { runHistoryRepair } from "../history-repair.js";
 import { resolveWorkspaceRelationshipKindRegistry } from "../graph/assembly.js";
 import { analyzeHierarchyIntegrity, } from "../graph/hierarchy-integrity.js";
+import { buildStatusRoleWarnings, inspectStatusRoleAssignments, } from "./status-role-diagnostics.js";
 const PM_TELEMETRY_SOURCE_CONTEXT_SET = new Set(PM_TELEMETRY_SOURCE_CONTEXT_VALUES);
 const STALE_VECTORIZATION_SUMMARY_LIMIT = 25;
 const BRIEF_HEALTH_DETAIL_LIMIT = 8;
@@ -1834,12 +1835,17 @@ function buildDirectoriesHealthCheck(directoryState, strictDirectories) {
         },
     };
 }
-function buildSettingsValuesHealthCheck(settingWarnings) {
+function buildSettingsValuesHealthCheck(settingWarnings, statusRoleDiagnostics) {
     return {
         name: "settings_values",
         status: settingWarnings.length === 0 ? "ok" : "warn",
         ok: settingWarnings.length === 0,
-        details: { warnings: settingWarnings },
+        details: {
+            warnings: settingWarnings,
+            ...(statusRoleDiagnostics.roleless_status_count > 0
+                ? { lifecycle_status_roles: statusRoleDiagnostics }
+                : {}),
+        },
     };
 }
 /** Preserve unknown-author totals for current and legacy scan payloads. */
@@ -2129,7 +2135,7 @@ export async function runHealth(global, options = {}) {
     const strictDirectories = options.strictDirectories === true;
     const refreshPolicy = resolveVectorRefreshPolicy(options);
     const directoryState = await scanHealthDirectories(pmRoot, typeRegistry, strictDirectories);
-    const settingWarnings = validateSettingsValues(settings);
+    const settingsValueWarnings = validateSettingsValues(settings);
     const telemetryCheck = await buildTelemetryCheck(settings, {
         checkTelemetry: options.checkTelemetry === true,
     });
@@ -2144,6 +2150,11 @@ export async function runHealth(global, options = {}) {
         itemReadWarnings,
     });
     const itemsWithBody = items;
+    const statusRoleDiagnostics = inspectStatusRoleAssignments(resolveRuntimeStatusRegistry(settings.schema), items);
+    const settingWarnings = [
+        ...settingsValueWarnings,
+        ...buildStatusRoleWarnings(statusRoleDiagnostics),
+    ];
     const historyPolicy = skipPolicy.skipDrift
         ? { warnings: [] }
         : await enforceHistoryStreamPolicyForItems({
@@ -2197,7 +2208,7 @@ export async function runHealth(global, options = {}) {
     const checks = [
         buildSettingsHealthCheck(settingsPath, settings, normalizedSettingsReadWarnings),
         buildDirectoriesHealthCheck(directoryState, strictDirectories),
-        buildSettingsValuesHealthCheck(settingWarnings),
+        buildSettingsValuesHealthCheck(settingWarnings, statusRoleDiagnostics),
         telemetryCheck.check,
         extensionCheck.check,
         buildStorageHealthCheck(items, settings, historySummary, authorAttribution, staleInProgress.scan, provenanceResolverOutcomes, provenanceInvalidValues),
@@ -2298,4 +2309,4 @@ export const _testOnlyHealthCommand = {
     warningCode,
 };
 //# sourceMappingURL=health.js.map
-//# debugId=3c68e4be-fd09-560c-9654-f270e5d7ba73
+//# debugId=76693c03-9395-5bbf-bcc8-fa15e408f30f

package/dist/sdk/governance/status-role-diagnostics.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module sdk/governance/status-role-diagnostics
+ *
+ * Diagnoses lifecycle statuses that cannot participate in role-derived project
+ * management views because they have no registered lifecycle role.
+ */
+import type { ItemMetadata } from "../../types/index.js";
+import { type RuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
+/** Bounded evidence describing roleless status definitions and affected items. */
+export interface StatusRoleDiagnostics {
+    /** Total number of registered status ids that have no lifecycle role. */
+    roleless_status_count: number;
+    /** Registered status ids that have no lifecycle role. */
+    roleless_statuses: string[];
+    /** Whether roleless status ids were omitted from the bounded sample. */
+    roleless_statuses_truncated: boolean;
+    /** Number of items whose status resolves to a roleless definition. */
+    affected_item_count: number;
+    /** Bounded, deterministic sample of affected item ids. */
+    affected_item_ids: string[];
+    /** Whether affected item ids were omitted from the bounded sample. */
+    affected_item_ids_truncated: boolean;
+}
+/** Inspect role registration and affected items without mutating the tracker. */
+export declare function inspectStatusRoleAssignments(statusRegistry: RuntimeStatusRegistry, items: readonly ItemMetadata[], itemLimit?: number): StatusRoleDiagnostics;
+/** Convert role diagnostics into the stable health/validate warning token. */
+export declare function buildStatusRoleWarnings(diagnostics: StatusRoleDiagnostics): string[];