@unbrained/pm-cli 2026.8.8 → 2026.8.10

package/dist/core/item/actionability.js

@@ -10,10 +10,17 @@
  * `blocked_by` resolution a single source of truth.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="bf429f76-9722-5e34-a5f0-6ced8d1ed667")}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]="de8a82e1-0b02-5d5a-9086-686529a1ccab")}catch(e){}}();
 import { isTerminalStatus, normalizeStatusForRegistry } from "./status.js";
 /** Dependency kind that marks "this item is blocked by the referenced item". */
 const BLOCKED_BY_DEPENDENCY_KIND = "blocked_by";
+/** Reverse dependency kind that marks "this item blocks the referenced item". */
+const BLOCKS_DEPENDENCY_KIND = "blocks";
+/** Built-in ordering kinds that must remain reachable by blocker resolution. */
+export const ACTIONABILITY_ORDERING_KINDS = Object.freeze([
+    BLOCKED_BY_DEPENDENCY_KIND,
+    BLOCKS_DEPENDENCY_KIND,
+]);
 /** Retired placeholder that explicitly means an item has no active blocker. */
 const NO_ACTIVE_BLOCKER_SENTINEL = "no-active-blocker";
 /**
@@ -28,23 +35,66 @@ function normalizeItemId(id) {
 /** Collects the blocker item ids declared by an item: the legacy scalar `blocked_by` field plus every `blocked_by` dependency edge. Ids are trimmed, de-duplicated, and returned in stable lexicographic order. This is the single source of truth for "what must close before this item can proceed", shared by `pm next` readiness classification and the close-time auto-unblock sweep. */
 export function collectBlockedByIds(item) {
     const ids = new Set();
-    const scalar = typeof item.blocked_by === "string" ? item.blocked_by.trim() : "";
-    if (scalar.length > 0 && scalar.toLowerCase() !== NO_ACTIVE_BLOCKER_SENTINEL) {
+    const scalar = typeof item.blocked_by === "string" ? normalizeItemId(item.blocked_by) : "";
+    if (scalar.length > 0 && scalar !== NO_ACTIVE_BLOCKER_SENTINEL) {
         ids.add(scalar);
     }
     for (const dependency of item.dependencies ?? []) {
+        const dependencyId = typeof dependency.id === "string" ? normalizeItemId(dependency.id) : "";
         if (dependency.kind === BLOCKED_BY_DEPENDENCY_KIND &&
-            typeof dependency.id === "string" &&
-            dependency.id.trim().length > 0 &&
-            dependency.id.trim().toLowerCase() !== NO_ACTIVE_BLOCKER_SENTINEL) {
-            ids.add(dependency.id.trim());
+            dependencyId.length > 0 &&
+            dependencyId !== NO_ACTIVE_BLOCKER_SENTINEL) {
+            ids.add(dependencyId);
         }
     }
     return [...ids].sort((left, right) => left.localeCompare(right));
 }
+/** Build every forward and reverse blocker set in one corpus pass. */
+export function indexBlockedByIds(corpus) {
+    const idsByItem = new Map();
+    for (const item of corpus) {
+        const itemId = normalizeItemId(item.id);
+        if (itemId.length === 0)
+            continue;
+        idsByItem.set(itemId, new Set(collectBlockedByIds(item)));
+    }
+    for (const candidate of corpus) {
+        const candidateId = normalizeItemId(candidate.id);
+        if (candidateId.length === 0)
+            continue;
+        for (const dependency of candidate.dependencies ?? []) {
+            const targetId = dependency.kind === BLOCKS_DEPENDENCY_KIND &&
+                typeof dependency.id === "string"
+                ? normalizeItemId(dependency.id)
+                : "";
+            if (targetId.length === 0 || targetId === NO_ACTIVE_BLOCKER_SENTINEL) {
+                continue;
+            }
+            const blockerIds = idsByItem.get(targetId) ?? new Set();
+            blockerIds.add(candidateId);
+            idsByItem.set(targetId, blockerIds);
+        }
+    }
+    return new Map([...idsByItem].map(([itemId, blockerIds]) => [
+        itemId,
+        [...blockerIds].sort((left, right) => left.localeCompare(right)),
+    ]));
+}
+/** Collect blockers from both an item's forward declarations and corpus-level reverse `blocks` edges. */
+export function collectBlockedByIdsFromCorpus(item, corpus) {
+    const itemId = normalizeItemId(item.id);
+    return itemId.length > 0
+        ? (indexBlockedByIds(corpus).get(itemId) ?? collectBlockedByIds(item))
+        : collectBlockedByIds(item);
+}
 /** Resolves an item's declared blockers against a corpus index, annotating each with the blocker's title/status and whether it still gates work. Unknown ids remain unresolved: silently treating a typo as satisfied would dispatch work whose prerequisite was never completed. Terminal referenced items alone are resolved. */
-export function resolveItemBlockers(item, itemsById, statusRegistry) {
-    return collectBlockedByIds(item).map((id) => {
+function resolveItemBlockersWithIndex(item, itemsById, statusRegistry, blockerIdsByItem) {
+    const itemWithId = item;
+    const blockerIds = typeof itemWithId.id === "string"
+        ? (blockerIdsByItem?.get(normalizeItemId(itemWithId.id)) ??
+            collectBlockedByIdsFromCorpus(itemWithId, [...itemsById.values()]))
+        : collectBlockedByIds(item);
+    return blockerIds.map((id) => {
         const blocker = itemsById.get(normalizeItemId(id));
         if (!blocker) {
             return { id, title: null, status: null, resolved: false };
@@ -57,6 +107,10 @@ export function resolveItemBlockers(item, itemsById, statusRegistry) {
         };
     });
 }
+/** Resolves an item's blockers against a corpus index with reverse `blocks` support. */
+export function resolveItemBlockers(item, itemsById, statusRegistry) {
+    return resolveItemBlockersWithIndex(item, itemsById, statusRegistry);
+}
 /**
  * Collects the normalized (trimmed, lowercased) ids of every corpus item that is
  * blocked under the single shared edge-aware definition: a non-terminal item
@@ -70,6 +124,7 @@ export function resolveItemBlockers(item, itemsById, statusRegistry) {
  */
 export function collectDependencyBlockedIds(corpus, statusRegistry) {
     const itemsById = new Map(corpus.map((item) => [normalizeItemId(item.id), item]));
+    const blockerIdsByItem = indexBlockedByIds(corpus);
     // Same candidate gate as computeActionabilityReport: active statuses plus
     // lifecycle-blocked statuses, so the two surfaces classify identically.
     const candidateStatuses = new Set([
@@ -83,7 +138,7 @@ export function collectDependencyBlockedIds(corpus, statusRegistry) {
             continue;
         const lifecycleBlocked = statusRegistry.blocked_statuses.has(normalizedStatus);
         if (lifecycleBlocked ||
-            resolveItemBlockers(item, itemsById, statusRegistry).some((blocker) => !blocker.resolved)) {
+            resolveItemBlockersWithIndex(item, itemsById, statusRegistry, blockerIdsByItem).some((blocker) => !blocker.resolved)) {
             blocked.add(normalizeItemId(item.id));
         }
     }
@@ -122,6 +177,7 @@ function indexCorpus(corpus) {
     const itemsById = new Map();
     const childrenByParent = new Map();
     const blockedByReverse = new Map();
+    const blockerIdsByItem = indexBlockedByIds(corpus);
     for (const item of corpus) {
         // Index keys are normalized (lowercased) for case-insensitive resolution;
         // stored values keep the item's original-case id for display.
@@ -133,14 +189,14 @@ function indexCorpus(corpus) {
             siblings.push(item);
             childrenByParent.set(parentKey, siblings);
         }
-        for (const blockerId of collectBlockedByIds(item)) {
+        for (const blockerId of blockerIdsByItem.get(normalizeItemId(item.id))) {
             const blockerKey = normalizeItemId(blockerId);
             const dependents = blockedByReverse.get(blockerKey) ?? [];
             dependents.push(item.id);
             blockedByReverse.set(blockerKey, dependents);
         }
     }
-    return { itemsById, childrenByParent, blockedByReverse };
+    return { itemsById, childrenByParent, blockedByReverse, blockerIdsByItem };
 }
 /**
  * Partitions a candidate set into ready vs blocked leaf work using the corpus to
@@ -154,7 +210,7 @@ function indexCorpus(corpus) {
  * the candidate order so the caller can apply its own ranking.
  */
 export function computeActionabilityReport(candidates, corpus, statusRegistry) {
-    const { itemsById, childrenByParent, blockedByReverse } = indexCorpus(corpus);
+    const { itemsById, childrenByParent, blockedByReverse, blockerIdsByItem } = indexCorpus(corpus);
     const activeStatuses = new Set([
         ...resolveActiveStatusSet(statusRegistry),
         ...statusRegistry.blocked_statuses,
@@ -176,7 +232,7 @@ export function computeActionabilityReport(candidates, corpus, statusRegistry) {
             containerCount += 1;
             continue;
         }
-        const openBlockers = resolveItemBlockers(item, itemsById, statusRegistry).filter((blocker) => !blocker.resolved);
+        const openBlockers = resolveItemBlockersWithIndex(item, itemsById, statusRegistry, blockerIdsByItem).filter((blocker) => !blocker.resolved);
         const unblocks = (blockedByReverse.get(normalizeItemId(item.id)) ?? [])
             .filter((dependentId) => nonTerminalIds.has(normalizeItemId(dependentId)))
             .sort((left, right) => left.localeCompare(right));
@@ -201,4 +257,4 @@ export function computeActionabilityReport(candidates, corpus, statusRegistry) {
     };
 }
 //# sourceMappingURL=actionability.js.map
-//# debugId=bf429f76-9722-5e34-a5f0-6ced8d1ed667
+//# debugId=de8a82e1-0b02-5d5a-9086-686529a1ccab

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

@@ -4,7 +4,7 @@
  * Defines item parsing, formatting, and lifecycle helpers for Item Format.
  */
 
-!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]="a4c22692-fe27-5178-bba2-190ac3f80628")}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]="eaf0e260-a864-57cf-b23b-aac4f9151d8e")}catch(e){}}();
 import { encode as encodeToon } from "@toon-format/toon";
 import { isDeepStrictEqual } from "node:util";
 import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, PLAN_STEP_STATUS_VALUES, RECURRENCE_FREQUENCY_VALUES, RECURRENCE_WEEKDAY_VALUES, STATUS_VALUES, weekdayOrderIndex, } from "../../types/index.js";
@@ -630,7 +630,7 @@ function normalizeTestRunSummary(value) {
 function sortTests(values) {
     if (!Array.isArray(values) || values.length === 0)
         return undefined;
-    return [...values].map(normalizeLinkedTest).sort(compareLinkedTests);
+    return values.map(normalizeLinkedTest);
 }
 function normalizeTrimmedStringList(value) {
     if (!Array.isArray(value)) {
@@ -709,35 +709,6 @@ function normalizeLinkedTest(value) {
     deleteUndefinedFields(test);
     return test;
 }
-function compareLinkedTests(a, b) {
-    return firstNonZeroComparison([
-        a.scope.localeCompare(b.scope),
-        compareOptionalStrings(a.path, b.path),
-        compareOptionalStrings(a.command, b.command),
-        compareOptionalNumbers(a.timeout_seconds, b.timeout_seconds),
-        compareOptionalStrings(a.pm_context_mode, b.pm_context_mode),
-        Number(Boolean(a.shared_host_safe)) - Number(Boolean(b.shared_host_safe)),
-        compareJsonValues(a.env_clear, b.env_clear, []),
-        compareJsonValues(a.env_set, b.env_set, {}),
-        compareJsonValues(a.assert_stdout_contains, b.assert_stdout_contains, []),
-        compareJsonValues(a.assert_stdout_regex, b.assert_stdout_regex, []),
-        compareJsonValues(a.assert_stderr_contains, b.assert_stderr_contains, []),
-        compareJsonValues(a.assert_stderr_regex, b.assert_stderr_regex, []),
-        compareOptionalNumbers(a.assert_stdout_min_lines, b.assert_stdout_min_lines),
-        compareJsonValues(a.assert_json_field_equals, b.assert_json_field_equals, {}),
-        compareJsonValues(a.assert_json_field_gte, b.assert_json_field_gte, {}),
-        compareOptionalStrings(a.note, b.note),
-    ]);
-}
-function compareOptionalStrings(left, right) {
-    return (left ?? "").localeCompare(right ?? "");
-}
-function compareOptionalNumbers(left, right) {
-    return (left ?? 0) - (right ?? 0);
-}
-function compareJsonValues(left, right, fallback) {
-    return JSON.stringify(left ?? fallback).localeCompare(JSON.stringify(right ?? fallback));
-}
 function sortDocs(values) {
     if (!values || values.length === 0)
         return undefined;
@@ -1422,4 +1393,4 @@ export const _testOnlyItemFormat = {
     sortTests,
 };
 //# sourceMappingURL=item-format.js.map
-//# debugId=a4c22692-fe27-5178-bba2-190ac3f80628
+//# debugId=eaf0e260-a864-57cf-b23b-aac4f9151d8e

package/dist/core/schema/fields-file.d.ts

@@ -1,4 +1,5 @@
 import type { RuntimeFieldCommand, RuntimeFieldDefinition, RuntimeFieldType } from "../../types/index.js";
+export { normalizeStatusToken as normalizeFieldKey } from "./status-token.js";
 export type { RuntimeFieldCommand, RuntimeFieldDefinition, RuntimeFieldType, } from "../../types/index.js";
 /** Built-in item-metadata field names a custom field key must never shadow. A custom key that collides with one of these would let `pm create --<key>` write over reserved metadata, so add-field rejects them up front (symmetric with the built-in-type guard in item-types-file.ts). */
 export declare const BUILTIN_FIELD_KEYS: ReadonlySet<string>;
@@ -71,8 +72,6 @@ export interface RemoveFieldResult {
     /** The removed definition, when one matched the requested key. */
     definition?: RuntimeFieldDefinition;
 }
-/** Normalizes a field key using the same rule as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */
-export declare function normalizeFieldKey(value: unknown): string;
 /** Validates and normalizes raw add-field CLI input. Throws a plain Error with a stable message when the key is missing/empty, collides with a built-in field, or carries an invalid type/command; the CLI layer maps these to PmCliError exit codes. A `string_array` type implies a repeatable field downstream (runtime-schema.ts derives `repeatable`), so no separate repeatable flag is exposed. */
 export declare function normalizeAddFieldInput(raw: RawAddFieldInput): NormalizedAddFieldInput;
 /** Coerces an arbitrary parsed value from fields.json into a FieldsFile. Accepts the canonical `{ fields: [...] }` shape, a bare array, or a `{ definitions: [...] }` form, and tolerates a missing/invalid file by returning an empty fields list. */

package/dist/core/schema/fields-file.js

@@ -4,9 +4,11 @@
  * Resolves configurable schema, fields, statuses, and workflows for Fields 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]="79b35844-ab8e-5b6f-9975-4dd85b210bcb")}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]="575b0c3a-9ce1-504f-a24e-d8854e898f17")}catch(e){}}();
 import { RUNTIME_FIELD_COMMAND_VALUES, RUNTIME_FIELD_TYPE_VALUES, } from "../../types/index.js";
 import { ITEM_METADATA_KEY_ORDER } from "../shared/constants.js";
+import { normalizeStatusToken as normalizeFieldKey } from "./status-token.js";
+export { normalizeStatusToken as normalizeFieldKey } from "./status-token.js";
 /**
  * Pure logic for the `pm schema add-field` / `pm schema remove-field` commands
  * and the `list-fields` / `show-field` inspectors. The CLI command file
@@ -52,15 +54,6 @@ export const BUILTIN_FIELD_KEYS = new Set([
 ]);
 /** The default commands a field is wired onto when `--commands` is omitted, matching the runtime default in runtime-schema.ts (normalizeRuntimeFieldDefinition). */
 const DEFAULT_FIELD_COMMANDS = ["create", "update"];
-/** Normalizes a field key using the same rule as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */
-export function normalizeFieldKey(value) {
-    return typeof value === "string"
-        ? value
-            .trim()
-            .toLowerCase()
-            .replaceAll(/[\s-]+/g, "_")
-        : "";
-}
 /** Normalizes a CLI flag token: strip a leading `--`, lowercase, and collapse whitespace/underscore runs to a single hyphen (matches normalizeCliToken in runtime-schema.ts). */
 function normalizeCliToken(value) {
     if (typeof value !== "string") {
@@ -293,4 +286,4 @@ function applyBooleanFlag(definition, key, value) {
     }
 }
 //# sourceMappingURL=fields-file.js.map
-//# debugId=79b35844-ab8e-5b6f-9975-4dd85b210bcb
+//# debugId=575b0c3a-9ce1-504f-a24e-d8854e898f17

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

@@ -4,11 +4,12 @@
  * 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]="febba42b-dfd0-549a-a6d9-c30edb321d9d")}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]="a9ff482a-f9f9-5e35-88d0-240db815ec08")}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";
 import { RUNTIME_FIELD_COMMAND_VALUES, RUNTIME_FIELD_TYPE_VALUES, RUNTIME_STATUS_ROLE_VALUES, RUNTIME_UNKNOWN_FIELD_POLICY_VALUES, STATUS_VALUES, } from "../../types/index.js";
+import { normalizeStatusToken } from "./status-token.js";
 /** Fallback runtime schema file paths used when callers do not provide an override. */
 export const DEFAULT_RUNTIME_SCHEMA_FILE_PATHS = Object.freeze({
     types: "schema/types.json",
@@ -39,14 +40,6 @@ function normalizeStringList(values) {
             .filter((value) => value.length > 0)),
     ].sort((left, right) => left.localeCompare(right));
 }
-function normalizeStatusToken(value) {
-    return typeof value === "string"
-        ? value
-            .trim()
-            .toLowerCase()
-            .replaceAll(/[\s-]+/g, "_")
-        : "";
-}
 function normalizeStatusId(value) {
     if (typeof value !== "string" || value.length === 0) {
         return undefined;
@@ -698,4 +691,4 @@ export function statusIsTerminal(status, registry) {
     return registry.terminal_statuses.has(normalized);
 }
 //# sourceMappingURL=runtime-schema.js.map
-//# debugId=febba42b-dfd0-549a-a6d9-c30edb321d9d
+//# debugId=a9ff482a-f9f9-5e35-88d0-240db815ec08

package/dist/core/schema/status-defs-file.d.ts

@@ -1,4 +1,5 @@
 import type { RuntimeStatusDefinition, RuntimeStatusRole } from "../../types/index.js";
+export { normalizeStatusToken } from "./status-token.js";
 export type { RuntimeStatusDefinition, RuntimeStatusRole, } from "../../types/index.js";
 /** The 5 lifecycle status ids that ship as built-in defaults and may never be removed (their normalized ids match DEFAULT_RUNTIME_STATUS_DEFINITIONS: open/in_progress/blocked/closed/canceled). `draft` is also a default but the acceptance criteria enumerate the 5 terminal/active ids explicitly, so the guard derives the full set from the canonical defaults to stay in sync. */
 export declare const BUILTIN_STATUS_IDS: ReadonlySet<string>;
@@ -51,8 +52,6 @@ export interface RemoveStatusDefResult {
     /** The removed definition, when one matched the requested id. */
     definition?: RuntimeStatusDefinition;
 }
-/** Normalizes a status token using the same rules as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */
-export declare function normalizeStatusToken(value: unknown): string;
 /**
  * Validates and normalizes raw add-status CLI input. Throws a plain Error with a
  * stable message when the id is missing/empty or a role is not one of

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

@@ -4,10 +4,11 @@
  * 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]="f81297bd-06ac-5aa4-9e1b-802fb50c9cd0")}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]="3eac0218-43c9-5bd2-8eaf-589d02d2c8ad")}catch(e){}}();
 import { RUNTIME_STATUS_ROLE_VALUES } from "../../types/index.js";
 import { DEFAULT_RUNTIME_STATUS_DEFINITIONS } from "./runtime-schema.js";
-import { evictOldestMemoEntries } from "../shared/memo.js";
+import { normalizeStatusToken } from "./status-token.js";
+export { normalizeStatusToken } from "./status-token.js";
 /**
  * Pure logic for the `pm schema add-status` / `pm schema remove-status`
  * commands. The CLI command file (schema.ts) owns IO/governance; everything
@@ -20,37 +21,8 @@ import { evictOldestMemoEntries } from "../shared/memo.js";
  * into the persisted file.
  */
 const RUNTIME_STATUS_ROLE_SET = new Set(RUNTIME_STATUS_ROLE_VALUES);
-/**
- * Memo for {@link normalizeStatusToken}. Status ranking inside sort comparators
- * normalizes the same handful of status strings O(n log n) times per corpus scan, and
- * the trim/lowercase/regex pipeline shows up in list/next/context profiles. The cap
- * bounds memory in long-lived hosts against unbounded arbitrary inputs; half-eviction keeps the
- * newest-inserted half when the cap is hit. Declared before
- * BUILTIN_STATUS_IDS, whose module-level initializer already normalizes tokens.
- */
-const STATUS_TOKEN_MEMO_MAX_ENTRIES = 2_000;
-const statusTokenMemo = new Map();
 /** The 5 lifecycle status ids that ship as built-in defaults and may never be removed (their normalized ids match DEFAULT_RUNTIME_STATUS_DEFINITIONS: open/in_progress/blocked/closed/canceled). `draft` is also a default but the acceptance criteria enumerate the 5 terminal/active ids explicitly, so the guard derives the full set from the canonical defaults to stay in sync. */
 export const BUILTIN_STATUS_IDS = new Set(DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition) => normalizeStatusToken(definition.id)).filter((id) => id.length > 0));
-/** Normalizes a status token using the same rules as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */
-export function normalizeStatusToken(value) {
-    if (typeof value !== "string") {
-        return "";
-    }
-    const memoized = statusTokenMemo.get(value);
-    if (memoized !== undefined) {
-        return memoized;
-    }
-    const normalized = value
-        .trim()
-        .toLowerCase()
-        .replaceAll(/[\s-]+/g, "_");
-    if (statusTokenMemo.size >= STATUS_TOKEN_MEMO_MAX_ENTRIES) {
-        evictOldestMemoEntries(statusTokenMemo);
-    }
-    statusTokenMemo.set(value, normalized);
-    return normalized;
-}
 function dedupeTokens(values) {
     const seen = new Set();
     for (const value of values) {
@@ -250,4 +222,4 @@ export function assertStatusTokensAvailable(input, resolvedAliasToId) {
     }
 }
 //# sourceMappingURL=status-defs-file.js.map
-//# debugId=f81297bd-06ac-5aa4-9e1b-802fb50c9cd0
+//# debugId=3eac0218-43c9-5bd2-8eaf-589d02d2c8ad

package/dist/core/schema/status-token.d.ts

@@ -0,0 +1,2 @@
+/** Lowercase a status token and collapse whitespace or hyphen runs to one underscore. */
+export declare function normalizeStatusToken(value: unknown): string;

package/dist/core/schema/status-token.js

@@ -0,0 +1,32 @@
+/**
+ * @module core/schema/status-token
+ *
+ * Owns the canonical bounded status-token normalization primitive used by
+ * schema files, runtime registries, workflows, and package-facing SDK helpers.
+ */
+
+!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]="d6056922-237d-525a-b354-687493a4e123")}catch(e){}}();
+import { evictOldestMemoEntries } from "../shared/memo.js";
+const STATUS_TOKEN_MEMO_MAX_ENTRIES = 2_000;
+const statusTokenMemo = new Map();
+/** Lowercase a status token and collapse whitespace or hyphen runs to one underscore. */
+export function normalizeStatusToken(value) {
+    if (typeof value !== "string") {
+        return "";
+    }
+    const memoized = statusTokenMemo.get(value);
+    if (memoized !== undefined) {
+        return memoized;
+    }
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replaceAll(/[\s-]+/g, "_");
+    if (statusTokenMemo.size >= STATUS_TOKEN_MEMO_MAX_ENTRIES) {
+        evictOldestMemoEntries(statusTokenMemo);
+    }
+    statusTokenMemo.set(value, normalized);
+    return normalized;
+}
+//# sourceMappingURL=status-token.js.map
+//# debugId=d6056922-237d-525a-b354-687493a4e123

package/dist/core/schema/type-workflows.d.ts

@@ -4,6 +4,7 @@
  * Resolves configurable schema, fields, statuses, and workflows for Type Workflows.
  */
 import type { RuntimeSchemaSettings } from "../../types/index.js";
+export { normalizeStatusToken } from "./status-token.js";
 /**
  * Per-type allowed-transition support (governance.workflow_enforcement).
  *
@@ -51,8 +52,6 @@ export interface EvaluateTransitionResult {
     /** Allowed [from, to] pairs for the matched type (normalized ids). Empty when the type is unrestricted. */
     allowedTransitions: [string, string][];
 }
-/** Normalize a status token the same way runtime-schema statuses are normalized. */
-export declare function normalizeStatusToken(value: unknown): string;
 /**
  * Normalize the raw type_workflows from a runtime schema into a deduped,
  * lower-cased-type list with normalized status tokens.

package/dist/core/schema/type-workflows.js

@@ -1,14 +1,7 @@
-/** Normalize a status token the same way runtime-schema statuses are normalized. */
 
-!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]="8370105a-2103-5425-8dd8-b621107f3bd8")}catch(e){}}();
-export function normalizeStatusToken(value) {
-    return typeof value === "string"
-        ? value
-            .trim()
-            .toLowerCase()
-            .replaceAll(/[\s-]+/g, "_")
-        : "";
-}
+!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]="c4e316a0-823d-5722-9e15-6d741ae44f1b")}catch(e){}}();
+import { normalizeStatusToken } from "./status-token.js";
+export { normalizeStatusToken } from "./status-token.js";
 function normalizeTypeName(value) {
     return typeof value === "string" ? value.trim().toLowerCase() : "";
 }
@@ -109,4 +102,4 @@ export function describeAllowedTransitions(allowedTransitions) {
         .join(", ");
 }
 //# sourceMappingURL=type-workflows.js.map
-//# debugId=8370105a-2103-5425-8dd8-b621107f3bd8
+//# debugId=c4e316a0-823d-5722-9e15-6d741ae44f1b

package/dist/core/shared/author.d.ts

@@ -19,6 +19,19 @@ export interface AgentProvenanceObservation {
  * selected harness declared the dimension but exposed no value this run.
  */
 export type AgentProvenance = Readonly<Record<string, AgentProvenanceObservation | null>>;
+/** Bounded reason explaining why one declared provenance dimension was absent. */
+export type AgentProvenanceAbsenceReason = "harness_unavailable" | "resolver_failed" | "resolver_not_configured" | "probes_disabled" | "invalid_value";
+/** Machine-readable resolution outcome for one provenance dimension. */
+export interface AgentProvenanceOutcome {
+    /** Whether the dimension resolved without retaining private source material. */
+    status: "resolved" | "unavailable" | "not_configured" | "failed";
+    /** Stable bounded reason for absent or rejected values. */
+    reason?: AgentProvenanceAbsenceReason;
+    /** Resolver name when a bounded local resolver was attempted. */
+    resolver?: AgentProvenanceResolver;
+    /** Stable inference contract version used by downstream analytics. */
+    rule_version: "v1";
+}
 /** Privacy-bounded MCP client metadata that can participate in agent detection. */
 export interface AgentClientInfo {
     /** Client or harness name reported during protocol initialization. */
@@ -72,6 +85,11 @@ export interface DetectedAgentIdentity {
     /** Stable declared episode identity when the session supplied one. */
     episode?: AgentEpisodeIdentity;
 }
+/** Agent identity plus explicit outcomes for every built-in provenance dimension. */
+export interface DiagnosedAgentIdentity extends DetectedAgentIdentity {
+    /** Resolution outcomes that distinguish absence from resolver failure. */
+    provenance_outcomes: Readonly<Record<string, AgentProvenanceOutcome>>;
+}
 /** Public, privacy-safe identity resolution result shared by CLI and SDK hosts. */
 export interface ResolvedAuthorIdentity extends DetectedAgentIdentity {
     /** Stable author value written to mutation history. */
@@ -126,6 +144,13 @@ export declare function runWithWorkspaceHarnessSignalDescriptors<T>(descriptors:
  * traversal, or network requests.
  */
 export declare function detectAgentIdentity(signals?: HarnessDetectionSignals): DetectedAgentIdentity;
+/**
+ * Diagnose provenance without exposing environment values, paths, or probe data.
+ *
+ * This additive SDK contract keeps legacy `detectAgentIdentity` projections
+ * stable while giving health checks and history writers explicit absence states.
+ */
+export declare function diagnoseAgentIdentity(signals?: HarnessDetectionSignals): DiagnosedAgentIdentity;
 /** Reads the invocation-wide author override through the canonical environment seam. */
 export declare function readAuthorEnvironment(): string | undefined;
 /** Updates or clears the invocation-wide author override through the canonical environment seam. */