@unbrained/pm-cli 2026.8.29 → 2026.8.31

package/dist/sdk/governance/status-role-diagnostics.js

@@ -0,0 +1,36 @@
+
+!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]="cd7acf28-cb93-516e-9058-54c32625ec26")}catch(e){}}();
+import { normalizeStatusInputWithRegistry, } from "../../core/schema/runtime-schema.js";
+/** Inspect role registration and affected items without mutating the tracker. */
+export function inspectStatusRoleAssignments(statusRegistry, items, itemLimit = 25) {
+    const rolelessStatuses = statusRegistry.definitions
+        .filter((definition) => definition.roles.length === 0)
+        .map((definition) => definition.id)
+        .sort((left, right) => left.localeCompare(right));
+    const rolelessSet = new Set(rolelessStatuses);
+    const affectedItemIds = items
+        .filter((item) => {
+        const resolved = normalizeStatusInputWithRegistry(item.status, statusRegistry);
+        return resolved !== undefined && rolelessSet.has(resolved);
+    })
+        .map((item) => item.id)
+        .sort((left, right) => left.localeCompare(right));
+    return {
+        roleless_status_count: rolelessStatuses.length,
+        roleless_statuses: rolelessStatuses.slice(0, itemLimit),
+        roleless_statuses_truncated: rolelessStatuses.length > itemLimit,
+        affected_item_count: affectedItemIds.length,
+        affected_item_ids: affectedItemIds.slice(0, itemLimit),
+        affected_item_ids_truncated: affectedItemIds.length > itemLimit,
+    };
+}
+/** Convert role diagnostics into the stable health/validate warning token. */
+export function buildStatusRoleWarnings(diagnostics) {
+    return diagnostics.roleless_status_count === 0
+        ? []
+        : [
+            `schema_status_missing_lifecycle_role:${diagnostics.roleless_status_count}`,
+        ];
+}
+//# sourceMappingURL=status-role-diagnostics.js.map
+//# debugId=cd7acf28-cb93-516e-9058-54c32625ec26

package/dist/sdk/governance/validate-normalization.d.ts

@@ -0,0 +1,6 @@
+/** Normalize a repository-relative path to stable forward-slash form. */
+export declare function normalizeRelativePath(value: string): string;
+/** Normalize a repository-relative directory without trailing separators. */
+export declare function normalizeRelativeDirectoryPath(value: string): string;
+/** Treat blank and legacy null-like metadata tokens as absent values. */
+export declare function toMeaningfulString(value: unknown): string | undefined;

package/dist/sdk/governance/validate-normalization.js

@@ -0,0 +1,37 @@
+/**
+ * @module sdk/governance/validate-normalization
+ *
+ * Provides shared path and meaningful-value normalization for validation
+ * diagnostics without coupling the helpers to the command orchestration.
+ */
+
+!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]="de2cc648-965a-59c9-b688-0fe12edeec82")}catch(e){}}();
+import { toNonEmptyStringOrUndefined } from "../../core/shared/primitives.js";
+/** Normalize a repository-relative path to stable forward-slash form. */
+export function normalizeRelativePath(value) {
+    return value
+        .replaceAll("\\", "/")
+        .replace(/^\.\/+/, "")
+        .replace(/^\/+/, "");
+}
+/** Normalize a repository-relative directory without trailing separators. */
+export function normalizeRelativeDirectoryPath(value) {
+    return normalizeRelativePath(value).replace(/\/+$/, "");
+}
+/** Treat blank and legacy null-like metadata tokens as absent values. */
+export function toMeaningfulString(value) {
+    const normalized = toNonEmptyStringOrUndefined(value);
+    if (!normalized) {
+        return undefined;
+    }
+    const lowered = normalized.toLowerCase();
+    if (lowered === "none" ||
+        lowered === "null" ||
+        lowered === "n/a" ||
+        lowered === "na") {
+        return undefined;
+    }
+    return normalized;
+}
+//# sourceMappingURL=validate-normalization.js.map
+//# debugId=de2cc648-965a-59c9-b688-0fe12edeec82

package/dist/sdk/governance/validate.d.ts

@@ -8,6 +8,7 @@ import { type OutputProjectionDeclaration } from "../output-projection.js";
 import { type RelationshipKindRegistry } from "../relationships.js";
 import { type ValidateItem } from "./validate-item-reader.js";
 import { buildLifecycleParentGraph, detectLifecycleParentCycles, resolveLifecycleDependencyCycleSamplePath } from "./hierarchy-validation.js";
+import { toMeaningfulString } from "./validate-normalization.js";
 type ValidateCheckName = "metadata" | "resolution" | "lifecycle" | "dependency_references" | "files" | "command_references" | "history_drift" | "format_version" | "storage_integrity";
 type ValidateStatus = "ok" | "warn" | "error";
 type ValidateDependencyCycleSeverity = "off" | "warn" | "error";
@@ -153,7 +154,6 @@ export interface ValidateCountsResult extends Omit<ValidateResult, "fixes"> {
  * totals, statuses, and truncation markers are preserved.
  */
 export declare function projectValidateCounts(result: ValidateResult): ValidateCountsResult;
-declare function toMeaningfulString(value: unknown): string | undefined;
 interface ValidateMetadataPolicy {
     profile: ValidateMetadataProfile;
     profile_source: "default" | "settings" | "option";

package/dist/sdk/governance/validate.js

@@ -4,7 +4,7 @@
  * Implements the pm validate 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]="e7a231e7-0546-5d5f-b0c8-59629ad4d731")}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]="cde10e58-cfeb-5718-a471-3e4acf46cfe7")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
 import fs from "node:fs/promises";
 import { realpathSync } from "node:fs";
@@ -46,6 +46,8 @@ import { resolveLinkedTestSourceRef, resolveLinkedTestSourceWorkspaceRoot, resol
 import { readValidateItems, } from "./validate-item-reader.js";
 import { buildValidateHistoryDriftCheck } from "./validate-history-drift.js";
 import { buildLifecycleParentGraph, detectLifecycleParentCycles, resolveLifecycleDependencyCycleSamplePath, } from "./hierarchy-validation.js";
+import { buildStatusRoleWarnings, inspectStatusRoleAssignments, } from "./status-role-diagnostics.js";
+import { normalizeRelativeDirectoryPath, normalizeRelativePath, toMeaningfulString, } from "./validate-normalization.js";
 const FILE_SCAN_DIRECTORIES = ["src", "tests", "docs"];
 const FILE_SCAN_ROOT_FILES = [
     "README.md",
@@ -205,30 +207,6 @@ export function projectValidateCounts(result) {
             : {}),
     };
 }
-function normalizeRelativePath(value) {
-    return value
-        .replaceAll("\\", "/")
-        .replace(/^\.\/+/, "")
-        .replace(/^\/+/, "");
-}
-function normalizeRelativeDirectoryPath(value) {
-    const normalized = normalizeRelativePath(value);
-    return normalized.replace(/\/+$/, "");
-}
-function toMeaningfulString(value) {
-    const normalized = toNonEmptyStringOrUndefined(value);
-    if (!normalized) {
-        return undefined;
-    }
-    const lowered = normalized.toLowerCase();
-    if (lowered === "none" ||
-        lowered === "null" ||
-        lowered === "n/a" ||
-        lowered === "na") {
-        return undefined;
-    }
-    return normalized;
-}
 /* c8 ignore start -- runtime-status alias normalization is covered by status-registry integration tests */
 function normalizeStatusForRegistry(status, statusRegistry) {
     return normalizeStatusInput(status, statusRegistry) ?? status;
@@ -1484,15 +1462,21 @@ function buildLifecycleCheck(items, includeStaleBlockers, dependencyCycleSeverit
     sortLifecycleScanRows(rows);
     const dependencyCycleDiagnostics = detectLifecycleDependencyCycles(rows.activeItems, idPrefix);
     const parentCycleDiagnostics = detectLifecycleParentCycles(items, statusRegistry);
-    const warnings = buildLifecycleWarnings(rows, includeStaleBlockers, dependencyCycleSeverity, parentCycleSeverity, {
-        dependencyCycles: dependencyCycleDiagnostics.cycle_count,
-        activeHierarchyCycles: parentCycleDiagnostics.active_cycle_count,
-        activeHierarchyCardinality: parentCycleDiagnostics.active_cardinality_violation_count,
-        activeHierarchyDivergence: parentCycleDiagnostics.active_parent_divergence_count,
-        legacyHierarchyCycles: parentCycleDiagnostics.legacy_cycle_count,
-        legacyHierarchyCardinality: parentCycleDiagnostics.legacy_cardinality_violation_count,
-        legacyHierarchyDivergence: parentCycleDiagnostics.legacy_parent_divergence_count,
-    });
+    const statusRoleDiagnostics = inspectStatusRoleAssignments(statusRegistry, items, verboseDiagnostics
+        ? Number.POSITIVE_INFINITY
+        : DIAGNOSTIC_LIST_SUMMARY_LIMIT);
+    const warnings = [
+        ...buildLifecycleWarnings(rows, includeStaleBlockers, dependencyCycleSeverity, parentCycleSeverity, {
+            dependencyCycles: dependencyCycleDiagnostics.cycle_count,
+            activeHierarchyCycles: parentCycleDiagnostics.active_cycle_count,
+            activeHierarchyCardinality: parentCycleDiagnostics.active_cardinality_violation_count,
+            activeHierarchyDivergence: parentCycleDiagnostics.active_parent_divergence_count,
+            legacyHierarchyCycles: parentCycleDiagnostics.legacy_cycle_count,
+            legacyHierarchyCardinality: parentCycleDiagnostics.legacy_cardinality_violation_count,
+            legacyHierarchyDivergence: parentCycleDiagnostics.legacy_parent_divergence_count,
+        }),
+        ...buildStatusRoleWarnings(statusRoleDiagnostics),
+    ];
     const diagnosticLimit = verboseDiagnostics
         ? Number.POSITIVE_INFINITY
         : DIAGNOSTIC_LIST_SUMMARY_LIMIT;
@@ -1522,6 +1506,7 @@ function buildLifecycleCheck(items, includeStaleBlockers, dependencyCycleSeverit
             ok: !hasErrorSeverityCycle && warnings.length === 0,
             details: {
                 checked_active_items: rows.activeItems.length,
+                lifecycle_status_roles: statusRoleDiagnostics,
                 active_closure_like_metadata_items: rows.closureLikeRows.length,
                 active_closure_like_metadata_rows: summarizedClosureLikeRows.values,
                 active_closure_like_metadata_rows_truncated: summarizedClosureLikeRows.truncated,
@@ -2288,4 +2273,4 @@ export async function runValidate(options, global, services = {}) {
 }
 /* c8 ignore stop */
 //# sourceMappingURL=validate.js.map
-//# debugId=e7a231e7-0546-5d5f-b0c8-59629ad4d731
+//# debugId=cde10e58-cfeb-5718-a471-3e4acf46cfe7

package/dist/sdk/governance/workspace-position.d.ts

@@ -0,0 +1,69 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import { type MergeDriverConfigurationAuditResult, type MergeFenceAuditResult } from "../merge/install.js";
+/** Stable readiness classifications returned by the workspace-position read. */
+export type WorkspacePositionState = "ready" | "merge_evidence_invalid" | "history_evidence_invalid" | "merge_reconciliation_required" | "history_repair_required" | "merge_fence_unprepared";
+/** One deterministic recovery action selected from aggregate workspace evidence. */
+export interface WorkspacePositionNextAction {
+    /** Executable pm command, or null when the workspace is ready. */
+    command: string | null;
+    /** Stable reason code explaining why this action takes precedence. */
+    reason: WorkspacePositionState;
+}
+/** Bounded SDK result shared by CLI, MCP, and package consumers. */
+export interface WorkspacePositionResult {
+    /** Whether all readiness evidence is clean. */
+    ok: boolean;
+    /** Highest-priority workspace readiness classification. */
+    state: WorkspacePositionState;
+    /** Committed merge-fence and clone-local driver evidence. */
+    merge_fence: {
+        committed: MergeFenceAuditResult;
+        clone_local_drivers: MergeDriverConfigurationAuditResult | null;
+    };
+    /** Bounded pending receipt evidence without private merge values. */
+    merge_receipts: {
+        pending_decision_count: number;
+        pending_item_ids: string[];
+        pending_item_ids_truncated: boolean;
+        lossless_count: number;
+        invalid_evidence_count: number;
+    };
+    /** Bounded append-only history drift evidence. */
+    history_drift: {
+        /** Whether the required history-drift evidence has its expected shape. */
+        evidence_valid: boolean;
+        drifted_item_count: number;
+        drifted_item_ids: string[];
+        drifted_item_ids_truncated: boolean;
+        counts: Record<string, unknown>;
+    };
+    /** One deterministic next action, avoiding multi-command guesswork. */
+    next_action: WorkspacePositionNextAction;
+    /** Non-fatal read warnings retained from the authoritative item scan. */
+    warnings: string[];
+    /** ISO timestamp for this aggregate read. */
+    generated_at: string;
+}
+declare function selectWorkspacePositionState(params: {
+    invalidEvidenceCount: number;
+    pendingDecisionCount: number;
+    losslessCount: number;
+    historyEvidenceValid: boolean;
+    driftedItemCount: number;
+    fence: MergeFenceAuditResult;
+    drivers: MergeDriverConfigurationAuditResult | null;
+}): WorkspacePositionState;
+declare function commandForWorkspacePositionState(state: WorkspacePositionState, pmRoot: string, platform?: NodeJS.Platform): string | null;
+/** Normalize defensive history-check evidence into the bounded position shape. */
+declare function normalizeWorkspaceHistoryDrift(details: Record<string, unknown>): WorkspacePositionResult["history_drift"];
+/** Read aggregate workspace position without flags, session state, or mutation. */
+export declare function readWorkspacePosition(global: GlobalOptions): Promise<WorkspacePositionResult>;
+/** Render the bounded workspace position for human CLI output. */
+export declare function formatWorkspacePositionHuman(result: WorkspacePositionResult): string;
+/** Public contract for focused unit verification. */
+export declare const _testOnlyWorkspacePosition: {
+    commandForWorkspacePositionState: typeof commandForWorkspacePositionState;
+    normalizeWorkspaceHistoryDrift: typeof normalizeWorkspaceHistoryDrift;
+    selectWorkspacePositionState: typeof selectWorkspacePositionState;
+};
+export {};

package/dist/sdk/governance/workspace-position.js

@@ -0,0 +1,164 @@
+/**
+ * @module sdk/governance/workspace-position
+ *
+ * Produces one bounded, read-only workspace readiness answer from merge-fence,
+ * merge-receipt, and append-only history evidence.
+ */
+
+!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]="e900c117-6d8d-55d3-86df-f543dc499930")}catch(e){}}();
+import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
+import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
+import { nowIso } from "../../core/shared/time.js";
+import { resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+import { renderPmCommand } from "../command-line.js";
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { auditMergeAttributeFence, auditMergeDriverConfiguration, findGitWorkspaceRoot, resolveProjectMergeTypeFolders, } from "../merge/install.js";
+import { inspectMergeReceiptEvidence, partitionMergeReceipts, } from "../merge/receipts.js";
+import { buildValidateHistoryDriftCheck } from "./validate-history-drift.js";
+import { readValidateItems } from "./validate-item-reader.js";
+function selectWorkspacePositionState(params) {
+    if (params.invalidEvidenceCount > 0)
+        return "merge_evidence_invalid";
+    if (!params.historyEvidenceValid)
+        return "history_evidence_invalid";
+    if (params.pendingDecisionCount > 0 || params.losslessCount > 0) {
+        return "merge_reconciliation_required";
+    }
+    if (params.driftedItemCount > 0)
+        return "history_repair_required";
+    if (params.fence.status !== "ok" ||
+        params.drivers === null ||
+        params.drivers.status !== "ok") {
+        return "merge_fence_unprepared";
+    }
+    return "ready";
+}
+function commandForWorkspacePositionState(state, pmRoot, platform = process.platform) {
+    const commandArgs = ["--pm-path", pmRoot];
+    if (state === "merge_evidence_invalid")
+        return renderPmCommand([...commandArgs, "merge", "report"], platform);
+    if (state === "history_evidence_invalid") {
+        return renderPmCommand([...commandArgs, "validate", "--check-history-drift", "--full"], platform);
+    }
+    if (state === "merge_reconciliation_required") {
+        return renderPmCommand([...commandArgs, "merge", "reconcile"], platform);
+    }
+    if (state === "history_repair_required") {
+        return renderPmCommand([...commandArgs, "history-repair", "--all"], platform);
+    }
+    if (state === "merge_fence_unprepared") {
+        return renderPmCommand([...commandArgs, "merge", "install"], platform);
+    }
+    return null;
+}
+/** Normalize defensive history-check evidence into the bounded position shape. */
+function normalizeWorkspaceHistoryDrift(details) {
+    const driftedItemIds = Array.isArray(details.drifted_items)
+        ? details.drifted_items.filter((entry) => typeof entry === "string")
+        : [];
+    const evidenceValid = Array.isArray(details.drifted_items) &&
+        details.drifted_items.every((entry) => typeof entry === "string") &&
+        typeof details.drifted_items_count === "number" &&
+        Number.isInteger(details.drifted_items_count) &&
+        details.drifted_items_count >= 0 &&
+        typeof details.drifted_items_truncated === "boolean" &&
+        typeof details.counts === "object" &&
+        details.counts !== null &&
+        !Array.isArray(details.counts);
+    return {
+        evidence_valid: evidenceValid,
+        drifted_item_count: typeof details.drifted_items_count === "number"
+            ? details.drifted_items_count
+            : driftedItemIds.length,
+        drifted_item_ids: driftedItemIds,
+        drifted_item_ids_truncated: details.drifted_items_truncated === true,
+        counts: typeof details.counts === "object" && details.counts !== null
+            ? details.counts
+            : {},
+    };
+}
+/** Read aggregate workspace position without flags, session state, or mutation. */
+export async function readWorkspacePosition(global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    await assertInitializedTracker(pmRoot);
+    const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+    const itemReadWarnings = [];
+    const items = await readValidateItems({
+        includeBody: true,
+        pmRoot,
+        settings,
+        typeToFolder: typeRegistry.type_to_folder,
+        warnings: itemReadWarnings,
+    });
+    const gitWorkspaceRoot = await findGitWorkspaceRoot(pmRoot);
+    const [fence, drivers, receiptEvidence, drift] = await Promise.all([
+        auditMergeAttributeFence(pmRoot, resolveProjectMergeTypeFolders(settings)),
+        gitWorkspaceRoot === null
+            ? Promise.resolve(null)
+            : auditMergeDriverConfiguration(gitWorkspaceRoot),
+        inspectMergeReceiptEvidence(gitWorkspaceRoot ?? pmRoot, {
+            includeLossless: true,
+            pmRoot,
+        }),
+        buildValidateHistoryDriftCheck(pmRoot, items, false),
+    ]);
+    const { pendingDecisions, lossless } = partitionMergeReceipts(receiptEvidence.receipts);
+    const pendingItemIds = [
+        ...new Set(pendingDecisions.map((receipt) => receipt.item_id)),
+    ].sort((left, right) => left.localeCompare(right));
+    const driftDetails = drift.check.details;
+    const historyDrift = normalizeWorkspaceHistoryDrift(driftDetails);
+    const state = selectWorkspacePositionState({
+        invalidEvidenceCount: receiptEvidence.invalid_evidence_count,
+        pendingDecisionCount: pendingDecisions.length,
+        losslessCount: lossless.length,
+        historyEvidenceValid: historyDrift.evidence_valid,
+        driftedItemCount: historyDrift.drifted_item_count,
+        fence,
+        drivers,
+    });
+    return {
+        ok: state === "ready",
+        state,
+        merge_fence: {
+            committed: fence,
+            clone_local_drivers: drivers,
+        },
+        merge_receipts: {
+            pending_decision_count: pendingDecisions.length,
+            pending_item_ids: pendingItemIds.slice(0, 25),
+            pending_item_ids_truncated: pendingItemIds.length > 25,
+            lossless_count: lossless.length,
+            invalid_evidence_count: receiptEvidence.invalid_evidence_count,
+        },
+        history_drift: historyDrift,
+        next_action: {
+            command: commandForWorkspacePositionState(state, pmRoot),
+            reason: state,
+        },
+        warnings: [...new Set(itemReadWarnings)].sort((left, right) => left.localeCompare(right)),
+        generated_at: nowIso(),
+    };
+}
+/** Render the bounded workspace position for human CLI output. */
+export function formatWorkspacePositionHuman(result) {
+    const action = result.next_action.command ?? "none";
+    return [
+        `workspace_position: ${result.state}`,
+        `merge_fence: ${result.merge_fence.committed.status}`,
+        `clone_local_drivers: ${result.merge_fence.clone_local_drivers?.status ?? "unavailable"}`,
+        `pending_merge_decisions: ${result.merge_receipts.pending_decision_count}`,
+        `history_drifted_items: ${result.history_drift.drifted_item_count}`,
+        `next_action: ${action}`,
+    ].join("\n");
+}
+/** Public contract for focused unit verification. */
+export const _testOnlyWorkspacePosition = {
+    commandForWorkspacePositionState,
+    normalizeWorkspaceHistoryDrift,
+    selectWorkspacePositionState,
+};
+//# sourceMappingURL=workspace-position.js.map
+//# debugId=e900c117-6d8d-55d3-86df-f543dc499930

package/dist/sdk/governance.d.ts

@@ -16,6 +16,8 @@ export * from "./governance/defect-recurrence.js";
 export { runReindex, type ReindexOptions, type ReindexResult, } from "./governance/reindex.js";
 export * from "./governance/stale-work.js";
 export * from "./governance/storage-integrity.js";
+export * from "./governance/status-role-diagnostics.js";
+export * from "./governance/workspace-position.js";
 export { runUpgrade, type UpgradeCliResult, type UpgradeCommandOptions, type UpgradeCommandRunner, type UpgradeCommandRunnerResult, type UpgradePackageResult, type UpgradeResult, } from "./governance/upgrade.js";
 export * from "./governance/validate.js";
 export * from "./author-attribution.js";

package/dist/sdk/governance.js

@@ -4,7 +4,7 @@
  * Provides validation, health, integrity, and mutation-policy 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]="c2063b82-58b6-54c9-baff-ca252cadf463")}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]="ff251826-36f0-5b92-bee8-ca71d265986c")}catch(e){}}();
 export * from "./governance/gc.js";
 export * from "./governance/health.js";
 export * from "./governance/extension-host-version.js";
@@ -18,6 +18,8 @@ export * from "./governance/defect-recurrence.js";
 export { runReindex, } from "./governance/reindex.js";
 export * from "./governance/stale-work.js";
 export * from "./governance/storage-integrity.js";
+export * from "./governance/status-role-diagnostics.js";
+export * from "./governance/workspace-position.js";
 export { runUpgrade, } from "./governance/upgrade.js";
 export * from "./governance/validate.js";
 export * from "./author-attribution.js";
@@ -25,4 +27,4 @@ export * from "./mutation-guard.js";
 export * from "./governance/provenance-health.js";
 export * from "./similarity.js";
 //# sourceMappingURL=governance.js.map
-//# debugId=c2063b82-58b6-54c9-baff-ca252cadf463
+//# debugId=ff251826-36f0-5b92-bee8-ca71d265986c

package/dist/sdk/index.d.ts

@@ -170,7 +170,7 @@ export { readImprovementLedger, recordImprovementObservation, type ImprovementDi
 export { evaluateProvenanceCoverage, projectFleetAttributionAnalytics, projectProvenanceCoverageAnalytics, readHistoryAnalyticsWindow, runFleetAttributionAnalytics, runProvenanceCoverageAnalytics, type FleetAttributionAnalytics, type FleetAttributionDimension, type FleetAttributionRow, type HistoryAnalyticsWindowOptions, type HistoryAnalyticsWindowReceipt, type HistoryAnalyticsEvent, type HistoryAnalyticsWindow, type ProvenanceCoverageAnalytics, } from "./history-analytics.js";
 export { DEFAULT_EVAL_QUERIES_RELATIVE_PATH, EVAL_QUERY_SET_CONTRACT, EVAL_QUERY_SET_EXAMPLE, EVAL_QUERY_SET_SCHEMA_ID, parseEvalQuerySet, runEval, type EvalOptions, type EvalQueryReport, type EvalResult, } from "./eval.js";
 export { runTelemetry, TELEMETRY_SUBCOMMANDS, type TelemetryCommandOptions, type TelemetryFlushResult, type TelemetryStatusSummary, type TelemetrySubcommand, } from "./telemetry.js";
-export { classifyLinkedTestFailure, countFailureCategories, extractReferencedPmItemIdsFromCommand, resolveLinkedTestFailureExitCode, runLinkedTests, runTest, summarizeContextPreflight, type LinkedTestFailureCategory, type TestCommandOptions, type TestResult, type TestRunResult, } from "./test/execution.js";
+export { classifyLinkedTestCommandSafety, classifyLinkedTestFailure, countFailureCategories, extractReferencedPmItemIdsFromCommand, resolveLinkedTestFailureExitCode, runLinkedTests, runTest, summarizeContextPreflight, type LinkedTestFailureCategory, type LinkedTestCommandSafetyClassification, type TestCommandOptions, type TestResult, type TestRunResult, } from "./test/execution.js";
 export { TEST_RUN_MEASUREMENT_LIMIT, diffTestRunMeasurements, parseTestRunMeasurements, queryTestRunMeasurementsBelow, type TestRunMeasurementDiff, } from "./test/measurements.js";
 export { runTestAll, type TestAllCommandOptions, type TestAllItemResult, type TestAllResult, } from "./test/batch.js";
 export { LINKED_TEST_ENV_NAME_PATTERN, LINKED_TEST_PM_CONTEXT_MODE_VALUES, LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES, LINKED_TEST_PROTECTED_ENV_KEYS, parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestJsonEntries, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, parseLinkedTestWorkspaceContextMode, type LinkedTestPmContextMode, type LinkedTestWorkspaceContextMode, } from "./test/parsers.js";

package/dist/sdk/index.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Index.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ea1845ab-34f5-5a1c-ad49-ac81495c1840")}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]="a903cbbb-e8b7-57d2-8f60-48885c6261a1")}catch(e){}}();
 export { PM_COMMAND_CAPABILITY_CONTRACTS, PM_COMMAND_VISIBILITY_CONTRACTS, PM_MCP_PROMPT_CONTRACTS, PM_MCP_RESOURCE_CONTRACTS, PM_MCP_TOOL_COMMAND_CONTRACTS, listPmCommandsForFamily, listPmCommandsForTier, listPmMcpToolsForProfile, renderPmCommandVisibilityMarkdown, resolvePmCommandCapabilityFamily, resolvePmCommandVisibilityTier, } from "./agent-capability-contracts.js";
 export * from "./mcp/protocol.js";
 export * from "./mcp/interactions.js";
@@ -161,7 +161,7 @@ export { readImprovementLedger, recordImprovementObservation, } from "./improvem
 export { evaluateProvenanceCoverage, projectFleetAttributionAnalytics, projectProvenanceCoverageAnalytics, readHistoryAnalyticsWindow, runFleetAttributionAnalytics, runProvenanceCoverageAnalytics, } from "./history-analytics.js";
 export { DEFAULT_EVAL_QUERIES_RELATIVE_PATH, EVAL_QUERY_SET_CONTRACT, EVAL_QUERY_SET_EXAMPLE, EVAL_QUERY_SET_SCHEMA_ID, parseEvalQuerySet, runEval, } from "./eval.js";
 export { runTelemetry, TELEMETRY_SUBCOMMANDS, } from "./telemetry.js";
-export { classifyLinkedTestFailure, countFailureCategories, extractReferencedPmItemIdsFromCommand, resolveLinkedTestFailureExitCode, runLinkedTests, runTest, summarizeContextPreflight, } from "./test/execution.js";
+export { classifyLinkedTestCommandSafety, classifyLinkedTestFailure, countFailureCategories, extractReferencedPmItemIdsFromCommand, resolveLinkedTestFailureExitCode, runLinkedTests, runTest, summarizeContextPreflight, } from "./test/execution.js";
 export { TEST_RUN_MEASUREMENT_LIMIT, diffTestRunMeasurements, parseTestRunMeasurements, queryTestRunMeasurementsBelow, } from "./test/measurements.js";
 export { runTestAll, } from "./test/batch.js";
 export { LINKED_TEST_ENV_NAME_PATTERN, LINKED_TEST_PM_CONTEXT_MODE_VALUES, LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES, LINKED_TEST_PROTECTED_ENV_KEYS, parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestJsonEntries, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, parseLinkedTestWorkspaceContextMode, } from "./test/parsers.js";
@@ -176,4 +176,4 @@ export * from "./governance.js";
 export * from "./query.js";
 export * from "./testing.js";
 //# sourceMappingURL=index.js.map
-//# debugId=ea1845ab-34f5-5a1c-ad49-ac81495c1840
+//# debugId=a903cbbb-e8b7-57d2-8f60-48885c6261a1

package/dist/sdk/mcp/protocol.d.ts

@@ -6,8 +6,16 @@
  */
 /** Canonical stateless MCP revision implemented by pm. */
 export declare const PM_MCP_PROTOCOL_VERSION: "2026-07-28";
-/** Legacy initialize-era revisions accepted only by the bounded stdio adapter. */
-export declare const PM_MCP_LEGACY_PROTOCOL_VERSIONS: readonly ["2025-06-18"];
+/**
+ * Legacy initialize-era revisions accepted only by the bounded stdio adapter.
+ *
+ * The canonical revision defines legacy as every version that establishes a
+ * session with the handshake method, which is `2025-11-25` and earlier, so this
+ * set tracks that boundary rather than a single historical revision.
+ * Ordered newest first: element zero is the revision offered to a client that
+ * omits `protocolVersion`.
+ */
+export declare const PM_MCP_LEGACY_PROTOCOL_VERSIONS: readonly ["2025-11-25", "2025-06-18"];
 /** Modern per-request protocol versions accepted by the stateless core. */
 export declare const PM_MCP_SUPPORTED_PROTOCOL_VERSIONS: readonly ["2026-07-28"];
 /** Allocated MCP 2026-07-28 protocol error codes. */

package/dist/sdk/mcp/protocol.js

@@ -6,10 +6,21 @@
  */
 /** Canonical stateless MCP revision implemented by pm. */
 
-!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]="9cb05a78-f95d-5211-a35a-03756f66c812")}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]="0ec82581-c626-544c-9deb-ec5e810fd7e9")}catch(e){}}();
 export const PM_MCP_PROTOCOL_VERSION = "2026-07-28";
-/** Legacy initialize-era revisions accepted only by the bounded stdio adapter. */
-export const PM_MCP_LEGACY_PROTOCOL_VERSIONS = ["2025-06-18"];
+/**
+ * Legacy initialize-era revisions accepted only by the bounded stdio adapter.
+ *
+ * The canonical revision defines legacy as every version that establishes a
+ * session with the handshake method, which is `2025-11-25` and earlier, so this
+ * set tracks that boundary rather than a single historical revision.
+ * Ordered newest first: element zero is the revision offered to a client that
+ * omits `protocolVersion`.
+ */
+export const PM_MCP_LEGACY_PROTOCOL_VERSIONS = [
+    "2025-11-25",
+    "2025-06-18",
+];
 /** Modern per-request protocol versions accepted by the stateless core. */
 export const PM_MCP_SUPPORTED_PROTOCOL_VERSIONS = [
     PM_MCP_PROTOCOL_VERSION,
@@ -171,4 +182,4 @@ export function interpretMcpResultType(result, era) {
     throw new PmMcpProtocolError("Modern MCP result is missing resultType", PM_MCP_ERROR_CODES.invalidParams, { required: "resultType" });
 }
 //# sourceMappingURL=protocol.js.map
-//# debugId=9cb05a78-f95d-5211-a35a-03756f66c812
+//# debugId=0ec82581-c626-544c-9deb-ec5e810fd7e9

package/dist/sdk/query/context.js

@@ -4,7 +4,7 @@
  * 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]="ee5279f2-7489-59fb-8f96-f2e035434cce")}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]="a870e3ac-f731-5cbf-a66e-38d1d5b1d0aa")}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";
 import { CONTEXT_DEPTH_VALUES, CONTEXT_SECTION_VALUES, } from "../../types/index.js";
@@ -221,20 +221,16 @@ function parseStaleThresholdDays(raw, settings) {
 // ---------------------------------------------------------------------------
 function statusRank(status, statusRegistry) {
     const normalizedStatus = normalizeStatusForRegistry(status, statusRegistry);
-    const inProgressStatus = normalizeStatusInput("in_progress", statusRegistry);
-    const openStatus = normalizeStatusInput("open", statusRegistry);
     const blockedStatus = normalizeStatusInput("blocked", statusRegistry);
     const draftStatus = normalizeStatusInput("draft", statusRegistry);
-    if (inProgressStatus && normalizedStatus === inProgressStatus)
+    if (normalizedStatus === statusRegistry.in_progress_status)
         return 0;
-    if (openStatus && normalizedStatus === openStatus)
+    if (statusRegistry.active_statuses.has(normalizedStatus))
         return 1;
     if (blockedStatus && normalizedStatus === blockedStatus)
         return 2;
     if (draftStatus && normalizedStatus === draftStatus)
         return 3;
-    if (statusRegistry.active_statuses.has(normalizedStatus))
-        return 4;
     if (statusRegistry.blocked_statuses.has(normalizedStatus))
         return 5;
     if (statusRegistry.terminal_statuses.has(normalizedStatus))
@@ -246,12 +242,13 @@ function isClosedStatus(status, statusRegistry) {
     return normalizeStatusForRegistry(status, statusRegistry) === closeStatus;
 }
 function isInProgressStatus(status, statusRegistry) {
-    const inProgressStatus = normalizeStatusInput("in_progress", statusRegistry);
-    return (normalizeStatusForRegistry(status, statusRegistry) === inProgressStatus);
+    return (normalizeStatusForRegistry(status, statusRegistry) ===
+        statusRegistry.in_progress_status);
 }
 function isOpenStatus(status, statusRegistry) {
-    const openStatus = normalizeStatusInput("open", statusRegistry);
-    return normalizeStatusForRegistry(status, statusRegistry) === openStatus;
+    const normalizedStatus = normalizeStatusForRegistry(status, statusRegistry);
+    return (normalizedStatus !== statusRegistry.in_progress_status &&
+        statusRegistry.active_statuses.has(normalizedStatus));
 }
 function isBlockedStatus(status, statusRegistry) {
     return statusRegistry.blocked_statuses.has(normalizeStatusForRegistry(status, statusRegistry));
@@ -1598,8 +1595,8 @@ export async function runContext(options, global) {
         now: agendaContext.agenda.now,
     });
     const warnings = mergeSortedWarnings(corpus.listed.warnings, agendaContext.agenda.warnings, focusGroups.ranking.warnings, [...focusGroups.featureStore.warnings], workspaceMemory.warnings);
-    const inProgressCount = countContextStatus(focusGroups.activeItems, normalizeStatusInput("in_progress", runtime.statusRegistry), runtime.statusRegistry);
-    const openCount = countContextStatus(focusGroups.activeItems, normalizeStatusInput("open", runtime.statusRegistry), runtime.statusRegistry);
+    const inProgressCount = countContextStatus(focusGroups.activeItems, runtime.statusRegistry.in_progress_status, runtime.statusRegistry);
+    const openCount = focusGroups.activeItems.length - inProgressCount;
     const sections = await buildOptionalContextSections({
         runtime,
         allItems: corpus.allItems,
@@ -1679,4 +1676,4 @@ export async function runContext(options, global) {
     return result;
 }
 //# sourceMappingURL=context.js.map
-//# debugId=ee5279f2-7489-59fb-8f96-f2e035434cce
+//# debugId=a870e3ac-f731-5cbf-a66e-38d1d5b1d0aa

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

@@ -56,6 +56,8 @@ export interface ListOptions extends SharedItemFilterOptions {
      * lifecycle-status filter.
      */
     dependencyBlocked?: boolean;
+    /** Select a role-derived active lifecycle bucket instead of one literal status id. */
+    lifecycleBucket?: "open" | "in_progress";
     /** Value that configures or reports filter ac missing for this contract. */
     filterAcMissing?: boolean;
     /** Value that configures or reports filter estimates missing for this contract. */