@unbrained/pm-cli 2026.10.14 → 2026.10.17

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

@@ -1,133 +1,133 @@
-import type { ItemTypeDefinition, RuntimeFieldCommand, RuntimeFieldValueSchema, RuntimeFieldType, RuntimeSchemaSettings, RuntimeStatusDefinition, RuntimeStatusRole, RuntimeWorkflowDefinition } from "../../types/index.js";
+import type { ItemTypeDefinition,RuntimeFieldCommand,RuntimeFieldValueSchema,RuntimeFieldType,RuntimeSchemaSettings,RuntimeStatusDefinition,RuntimeStatusRole,RuntimeWorkflowDefinition } from "../../types/index.js";
 export type { RuntimeFieldCommand } from "../../types/index.js";
 /** Fallback runtime schema file paths used when callers do not provide an override. */
-export declare const DEFAULT_RUNTIME_SCHEMA_FILE_PATHS: Readonly<{
-types: "schema/types.json";
-statuses: "schema/statuses.json";
-fields: "schema/fields.json";
-workflows: "schema/workflows.json";
+export declare const DEFAULT_RUNTIME_SCHEMA_FILE_PATHS:Readonly<{
+types:"schema/types.json";
+statuses:"schema/statuses.json";
+fields:"schema/fields.json";
+workflows:"schema/workflows.json";
 }>;
 /** Fallback runtime workflow used when callers do not provide an override. */
-export declare const DEFAULT_RUNTIME_WORKFLOW: RuntimeWorkflowDefinition;
+export declare const DEFAULT_RUNTIME_WORKFLOW:RuntimeWorkflowDefinition;
 /** Fallback runtime status definitions used when callers do not provide an override. */
-export declare const DEFAULT_RUNTIME_STATUS_DEFINITIONS: ReadonlyArray<RuntimeStatusDefinition>;
+export declare const DEFAULT_RUNTIME_STATUS_DEFINITIONS:ReadonlyArray<RuntimeStatusDefinition>;
 /** Documents the runtime status definition resolved payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeStatusDefinitionResolved {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports aliases for this contract. */
-aliases: string[];
+aliases:string[];
 /** Value that configures or reports roles for this contract. */
-roles: RuntimeStatusRole[];
+roles:RuntimeStatusRole[];
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Value that configures or reports order for this contract. */
-order: number;
+order:number;
 }
 /** Documents the runtime field definition resolved payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeFieldDefinitionResolved {
 /** Value that configures or reports key for this contract. */
-key: string;
+key:string;
 /** Value that configures or reports metadata key for this contract. */
-metadata_key: string;
+metadata_key:string;
 /** Value that configures or reports cli flag for this contract. */
-cli_flag: string;
+cli_flag:string;
 /** Value that configures or reports cli aliases for this contract. */
-cli_aliases: string[];
+cli_aliases:string[];
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type: RuntimeFieldType;
+type:RuntimeFieldType;
 /** Value that configures or reports commands for this contract. */
-commands: RuntimeFieldCommand[];
+commands:RuntimeFieldCommand[];
 /** Value that configures or reports repeatable for this contract. */
-repeatable: boolean;
+repeatable:boolean;
 /** Value that configures or reports required for this contract. */
-required: boolean;
+required:boolean;
 /** Value that configures or reports required on create for this contract. */
-required_on_create: boolean;
+required_on_create:boolean;
 /** Value that configures or reports required types for this contract. */
-required_types: string[];
+required_types:string[];
 /** Value that configures or reports allow unset for this contract. */
-allow_unset: boolean;
+allow_unset:boolean;
 /** Optional semantic JSON-value constraints enforced on create and update. */
-value_schema?: RuntimeFieldValueSchema;
+value_schema?:RuntimeFieldValueSchema;
 }
 /** Documents the runtime status registry payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeStatusRegistry {
 /** Value that configures or reports definitions for this contract. */
-definitions: RuntimeStatusDefinitionResolved[];
+definitions:RuntimeStatusDefinitionResolved[];
 /** Value that configures or reports by id for this contract. */
-by_id: Map<string, RuntimeStatusDefinitionResolved>;
+by_id:Map<string,RuntimeStatusDefinitionResolved>;
 /** Value that configures or reports alias to id for this contract. */
-alias_to_id: Map<string, string>;
+alias_to_id:Map<string,string>;
 /** Value that configures or reports terminal statuses for this contract. */
-terminal_statuses: Set<string>;
+terminal_statuses:Set<string>;
 /** Value that configures or reports terminal done statuses for this contract. */
-terminal_done_statuses: Set<string>;
+terminal_done_statuses:Set<string>;
 /** Value that configures or reports terminal canceled statuses for this contract. */
-terminal_canceled_statuses: Set<string>;
+terminal_canceled_statuses:Set<string>;
 /** Value that configures or reports active statuses for this contract. */
-active_statuses: Set<string>;
+active_statuses:Set<string>;
 /** Value that configures or reports blocked statuses for this contract. */
-blocked_statuses: Set<string>;
+blocked_statuses:Set<string>;
 /** Value that configures or reports draft statuses for this contract. */
-draft_statuses: Set<string>;
+draft_statuses:Set<string>;
 /** Configured status id representing the open lifecycle state. */
-open_status: string;
+open_status:string;
 /** Configured status id representing the in-progress lifecycle state. */
-in_progress_status: string;
+in_progress_status:string;
 /** Configured status id representing the blocked lifecycle state. */
-blocked_status: string;
+blocked_status:string;
 /** Configured status id representing the closed lifecycle state. */
-close_status: string;
+close_status:string;
 /** Configured status id representing the canceled lifecycle state. */
-canceled_status: string;
+canceled_status:string;
 }
 /** Documents the runtime field registry payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeFieldRegistry {
 /** Value that configures or reports definitions for this contract. */
-definitions: RuntimeFieldDefinitionResolved[];
+definitions:RuntimeFieldDefinitionResolved[];
 /** Value that configures or reports by key for this contract. */
-by_key: Map<string, RuntimeFieldDefinitionResolved>;
+by_key:Map<string,RuntimeFieldDefinitionResolved>;
 /** Value that configures or reports by cli token for this contract. */
-by_cli_token: Map<string, RuntimeFieldDefinitionResolved>;
+by_cli_token:Map<string,RuntimeFieldDefinitionResolved>;
 /** Value that configures or reports command to fields for this contract. */
-command_to_fields: Map<RuntimeFieldCommand, RuntimeFieldDefinitionResolved[]>;
+command_to_fields:Map<RuntimeFieldCommand,RuntimeFieldDefinitionResolved[]>;
 }
 /** Documents the runtime schema file bootstrap result payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeSchemaFileBootstrapResult {
 /** Value that configures or reports created paths for this contract. */
-created_paths: string[];
+created_paths:string[];
 }
 /** Documents the loaded runtime schema sections payload exchanged by command, SDK, and package integrations. */
 export interface LoadedRuntimeSchemaSections {
 /** Value that configures or reports schema for this contract. */
-schema: RuntimeSchemaSettings;
+schema:RuntimeSchemaSettings;
 /** Value that configures or reports type definitions from file for this contract. */
-type_definitions_from_file: ItemTypeDefinition[] | undefined;
+type_definitions_from_file:ItemTypeDefinition[] | undefined;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports created paths for this contract. */
-created_paths: string[];
+created_paths:string[];
 }
 /** Implements normalize runtime schema settings for the public runtime surface of this module. */
-export declare function normalizeRuntimeSchemaSettings(schema: Partial<RuntimeSchemaSettings> | undefined): RuntimeSchemaSettings;
+export declare function normalizeRuntimeSchemaSettings(schema:Partial<RuntimeSchemaSettings> | undefined):RuntimeSchemaSettings;
 /** Implements file path for schema section for the public runtime surface of this module. */
-export declare function filePathForSchemaSection(pmRoot: string, configuredPath: string | undefined, fallbackPath: string): string;
+export declare function filePathForSchemaSection(pmRoot:string,configuredPath:string | undefined,fallbackPath:string):string;
 /** Resolves the active tracker's `schema/types.json` path so user-facing hints (e.g. the invalid-type error) point at the real `--pm-path` location instead of the hardcoded `.agents/pm` default. Mirrors how `pm schema add/remove-type` report their target path. */
-export declare function resolveItemTypesFilePath(pmRoot: string, schema: RuntimeSchemaSettings): string;
+export declare function resolveItemTypesFilePath(pmRoot:string,schema:RuntimeSchemaSettings):string;
 /** Publish missing schema seeds without overwriting definitions created by a concurrent reader or schema mutation. */
-export declare function ensureRuntimeSchemaFileScaffold(pmRoot: string, schema: RuntimeSchemaSettings): Promise<RuntimeSchemaFileBootstrapResult>;
+export declare function ensureRuntimeSchemaFileScaffold(pmRoot:string,schema:RuntimeSchemaSettings):Promise<RuntimeSchemaFileBootstrapResult>;
 /** Implements load runtime schema from optional files for the public runtime surface of this module. */
-export declare function loadRuntimeSchemaFromOptionalFiles(pmRoot: string, schema: RuntimeSchemaSettings): Promise<LoadedRuntimeSchemaSections>;
+export declare function loadRuntimeSchemaFromOptionalFiles(pmRoot:string,schema:RuntimeSchemaSettings):Promise<LoadedRuntimeSchemaSections>;
 /** Implements resolve runtime status registry for the public runtime surface of this module. */
-export declare function resolveRuntimeStatusRegistry(schema: RuntimeSchemaSettings): RuntimeStatusRegistry;
+export declare function resolveRuntimeStatusRegistry(schema:RuntimeSchemaSettings):RuntimeStatusRegistry;
 /** Implements normalize status input with registry for the public runtime surface of this module. */
-export declare function normalizeStatusInputWithRegistry(value: unknown, registry: RuntimeStatusRegistry): string | undefined;
+export declare function normalizeStatusInputWithRegistry(value:unknown,registry:RuntimeStatusRegistry):string | undefined;
 /** Implements resolve runtime field registry for the public runtime surface of this module. */
-export declare function resolveRuntimeFieldRegistry(schema: RuntimeSchemaSettings): RuntimeFieldRegistry;
+export declare function resolveRuntimeFieldRegistry(schema:RuntimeSchemaSettings):RuntimeFieldRegistry;
 /** Implements runtime field option target for the public runtime surface of this module. */
-export declare function runtimeFieldOptionTarget(field: RuntimeFieldDefinitionResolved): string;
+export declare function runtimeFieldOptionTarget(field:RuntimeFieldDefinitionResolved):string;
 /** Implements status is terminal for the public runtime surface of this module. */
-export declare function statusIsTerminal(status: string, registry: RuntimeStatusRegistry): boolean;
+export declare function statusIsTerminal(status:string,registry:RuntimeStatusRegistry):boolean;

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

@@ -1,56 +1,56 @@
-import type { RuntimeStatusDefinition, RuntimeStatusRole } from "../../types/index.js";
+import type { RuntimeStatusDefinition,RuntimeStatusRole } from "../../types/index.js";
 export { normalizeStatusToken } from "./status-token.js";
-export type { RuntimeStatusDefinition, RuntimeStatusRole, } from "../../types/index.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>;
+export declare const BUILTIN_STATUS_IDS:ReadonlySet<string>;
 /** The shape persisted at `.agents/pm/schema/statuses.json`. */
 export interface StatusDefsFile {
 /** Value that configures or reports statuses for this contract. */
-statuses: RuntimeStatusDefinition[];
+statuses:RuntimeStatusDefinition[];
 }
 /** Documents the raw add status input payload exchanged by command, SDK, and package integrations. */
 export interface RawAddStatusInput {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string | undefined;
+id:string | undefined;
 /** Value that configures or reports roles for this contract. */
-roles?: string[];
+roles?:string[];
 /** Value that configures or reports aliases for this contract. */
-aliases?: string[];
+aliases?:string[];
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Value that configures or reports order for this contract. */
-order?: number;
+order?:number;
 }
 /** Documents the normalized add status input payload exchanged by command, SDK, and package integrations. */
 export interface NormalizedAddStatusInput {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Normalized roles, or `undefined` when the raw input did not supply a roles field at all. `undefined` means "leave existing roles untouched" on upsert; an explicit empty array means "clear roles". This distinction is what keeps `add-status review --description x` from wiping a previously-set role. */
-roles?: RuntimeStatusRole[];
+roles?:RuntimeStatusRole[];
 /** Same omitted-vs-explicit-empty semantics as `roles`. */
-aliases?: string[];
+aliases?:string[];
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Value that configures or reports order for this contract. */
-order?: number;
+order?:number;
 }
 /** Documents the upsert status def result payload exchanged by command, SDK, and package integrations. */
 export interface UpsertStatusDefResult {
 /** Value that configures or reports file for this contract. */
-file: StatusDefsFile;
+file:StatusDefsFile;
 /** The definition as stored after the upsert (existing fields preserved). */
-definition: RuntimeStatusDefinition;
+definition:RuntimeStatusDefinition;
 /** True when an existing definition with the same (normalized) id was replaced. */
-replaced: boolean;
+replaced:boolean;
 }
 /** Documents the remove status def result payload exchanged by command, SDK, and package integrations. */
 export interface RemoveStatusDefResult {
 /** Value that configures or reports file for this contract. */
-file: StatusDefsFile;
+file:StatusDefsFile;
 /** True when a matching definition existed and was dropped from the file. */
-removed: boolean;
+removed:boolean;
 /** The removed definition, when one matched the requested id. */
-definition?: RuntimeStatusDefinition;
+definition?:RuntimeStatusDefinition;
 }
 /**
  * Validates and normalizes raw add-status CLI input. Throws a plain Error with a
@@ -62,17 +62,17 @@ definition?: RuntimeStatusDefinition;
  * upsert leaves the existing value untouched; when supplied (even an empty array)
  * the field is normalized to an array so the upsert can apply an explicit clear.
  */
-export declare function normalizeAddStatusInput(raw: RawAddStatusInput): NormalizedAddStatusInput;
+export declare function normalizeAddStatusInput(raw:RawAddStatusInput):NormalizedAddStatusInput;
 /** Coerces an arbitrary parsed value from statuses.json into a StatusDefsFile. Accepts the canonical `{ statuses: [...] }` shape, a bare array of definitions, or a `{ definitions: [...] }` form, and tolerates a missing/invalid file by returning an empty statuses list. */
-export declare function parseStatusDefsFile(raw: string | null | undefined): StatusDefsFile;
+export declare function parseStatusDefsFile(raw:string | null | undefined):StatusDefsFile;
 /** Serializes the status definitions file with a trailing newline (matches the rest of the schema scaffold files written by pm). */
-export declare function serializeStatusDefsFile(file: StatusDefsFile): string;
+export declare function serializeStatusDefsFile(file:StatusDefsFile):string;
 /** Idempotent UPSERT of a status definition into the parsed file. Matching is by normalized id. When a definition already exists, fields supplied in `input` override the previous values (roles/aliases replace when a non-empty array is given, clear when an explicit empty array is given, and are left UNTOUCHED when the field is `undefined` — i.e. the add-status flag was omitted); description/order override when provided. Fields not addressed by add-status flags are preserved untouched, so `add-status <id> --description x` keeps any previously-set roles/aliases. */
-export declare function upsertStatusDef(file: StatusDefsFile, input: NormalizedAddStatusInput, baseDefinition?: RuntimeStatusDefinition): UpsertStatusDefResult;
+export declare function upsertStatusDef(file:StatusDefsFile,input:NormalizedAddStatusInput,baseDefinition?:RuntimeStatusDefinition):UpsertStatusDefResult;
 /** Removes a status definition from the parsed file by id (normalized). Throws a plain Error when `id` is empty or matches a reserved built-in default status (those are never stored in the file and must never be deletable). Returns `removed: false` when no matching definition exists so the CLI layer can treat the call as an idempotent no-op. */
-export declare function removeStatusDef(file: StatusDefsFile, id: string | undefined): RemoveStatusDefResult;
+export declare function removeStatusDef(file:StatusDefsFile,id:string | undefined):RemoveStatusDefResult;
 /** Throws when the new status id or any explicitly-supplied alias collides with a DIFFERENT existing status's id/alias. `resolvedAliasToId` maps a normalized token to its owning status id (the runtime status registry's alias_to_id map, which stores ids and aliases in one namespace). Re-adding the same status (matching id) is allowed — only cross-status collisions throw. This prevents a custom status from shadowing a built-in lifecycle token (for example `add-status review --alias open`, or a custom id `cancelled` that aliases the built-in `canceled`), which would make `pm update --status open` resolve to the wrong status. The CLI layer maps the thrown Error to a USAGE exit code. */
-export declare function assertStatusTokensAvailable(input: {
-id: string;
-aliases?: string[];
-}, resolvedAliasToId: ReadonlyMap<string, string>): void;
+export declare function assertStatusTokensAvailable(input:{
+id:string;
+aliases?:string[];
+},resolvedAliasToId:ReadonlyMap<string,string>):void;

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

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

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

@@ -1,26 +1,26 @@
 /** Documents the inferred type candidate payload exchanged by command, SDK, and package integrations. */
 export interface InferredTypeCandidate {
 /** Suggested PascalCase type name derived from the prefix. */
-name: string;
+name:string;
 /** The normalized prefix token (lowercase) the items share. */
-prefix: string;
+prefix:string;
 /** How many scanned titles carry this prefix. */
-count: number;
+count:number;
 /** A few example titles (capped) for human/agent review. */
-examples: string[];
+examples:string[];
 /** True when `name` already resolves to a reserved built-in type. */
-shadows_builtin: boolean;
+shadows_builtin:boolean;
 }
 /** Documents the infer types options payload exchanged by command, SDK, and package integrations. */
 export interface InferTypesOptions {
 /** Minimum number of titles that must share a prefix to surface it (default 10). */
-minCount?: number;
+minCount?:number;
 /** Maximum example titles retained per candidate (default 3). */
-maxExamples?: number;
+maxExamples?:number;
 }
 /** Extracts the leading prefix token from a title, or undefined when the title has no stable letter-led `PREFIX-`/`PREFIX:` convention. */
-export declare function extractTitlePrefix(title: string): string | undefined;
+export declare function extractTitlePrefix(title:string):string | undefined;
 /** Converts a normalized prefix token into a PascalCase type name. Internal hyphen/underscore runs become word boundaries; each word is capitalized. */
-export declare function prefixToTypeName(prefix: string): string;
+export declare function prefixToTypeName(prefix:string):string;
 /** Scans titles for shared prefix conventions and returns candidate custom types, sorted by descending frequency then name. Only prefixes carried by at least `minCount` titles are returned. */
-export declare function inferTypesFromTitles(titles: string[], options?: InferTypesOptions): InferredTypeCandidate[];
+export declare function inferTypesFromTitles(titles:string[],options?:InferTypesOptions):InferredTypeCandidate[];

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

@@ -3,9 +3,9 @@
  *
  * Resolves configurable schema, fields, statuses, and workflows for Type Presets.
  */
-import { type NormalizedAddTypeInput, type RawAddTypeInput } from "./item-types-file.js";
+import { type NormalizedAddTypeInput,type RawAddTypeInput } from "./item-types-file.js";
 /** Shared domain item-type presets. These power both `pm init --type-preset` (registered during initialization) and the standalone `pm schema apply-preset` subcommand (adopting a preset into an already-initialized project). Keeping the raw definitions and the preset-name normalizer in one place guarantees init and schema register byte-identical types. */
-export declare const TYPE_PRESET_NAMES: readonly ["agile", "ops", "research"];
+export declare const TYPE_PRESET_NAMES:readonly ["agile","ops","research"];
 /** Restricts type preset name values accepted by command, SDK, and storage contracts. */
 export type TypePresetName = (typeof TYPE_PRESET_NAMES)[number];
 /**
@@ -14,8 +14,8 @@ export type TypePresetName = (typeof TYPE_PRESET_NAMES)[number];
  * validation/normalization the `pm schema add-type` CLI applies governs preset
  * registration too.
  */
-export declare const TYPE_PRESET_DEFINITIONS: Record<TypePresetName, RawAddTypeInput[]>;
+export declare const TYPE_PRESET_DEFINITIONS:Record<TypePresetName,RawAddTypeInput[]>;
 /** Validates and normalizes a raw preset-name CLI value. Returns `undefined` when the value is omitted (no preset requested). Throws a plain Error with a stable message for an empty or unknown preset; CLI layers map it to a USAGE exit code. Accepts hyphen/underscore-insensitive casing for ergonomics. */
-export declare function normalizeTypePresetName(rawValue: string | undefined): TypePresetName | undefined;
+export declare function normalizeTypePresetName(rawValue:string | undefined):TypePresetName | undefined;
 /** Returns the normalized add-type inputs for a preset, in the order they should be upserted. Each raw definition is run through normalizeAddTypeInput so callers get the same validated shape as an individual `add-type` invocation. */
-export declare function resolveTypePresetDefinitions(preset: TypePresetName): NormalizedAddTypeInput[];
+export declare function resolveTypePresetDefinitions(preset:TypePresetName):NormalizedAddTypeInput[];

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

@@ -17,40 +17,40 @@ export { normalizeStatusToken } from "./status-token.js";
  * - A same-status no-op (from === to) is ALWAYS allowed.
  *
  * This module is intentionally dependency-light and fully unit-testable; the
- * CLI enforcement point (src/cli/commands/lifecycle/update.ts) is the only consumer.
+ * SDK lifecycle writers share enforcement through lifecycle/workflow-transition.
  */
 export interface NormalizedTypeWorkflow {
 /** Lower-cased type name used for case-insensitive matching. */
-type: string;
+type:string;
 /** Allowed [from, to] pairs as normalized status ids. */
-allowed_transitions: [string, string][];
+allowed_transitions:[string,string][];
 }
 /** Minimal status-registry surface needed to resolve a status token to its id. */
 export interface StatusTokenResolver {
 /** Value that configures or reports alias to id for this contract. */
-alias_to_id: Map<string, string>;
+alias_to_id:Map<string,string>;
 }
 /** Documents the evaluate transition input payload exchanged by command, SDK, and package integrations. */
 export interface EvaluateTransitionInput {
 /** Value that configures or reports type name for this contract. */
-typeName: string;
+typeName:string;
 /** Status id the workflow transition starts from. */
-fromStatus: string;
+fromStatus:string;
 /** Status id the workflow transition moves to. */
-toStatus: string;
+toStatus:string;
 /** Value that configures or reports type workflows for this contract. */
-typeWorkflows: NormalizedTypeWorkflow[];
+typeWorkflows:NormalizedTypeWorkflow[];
 /** Value that configures or reports status registry for this contract. */
-statusRegistry?: StatusTokenResolver;
+statusRegistry?:StatusTokenResolver;
 }
 /** Documents the evaluate transition result payload exchanged by command, SDK, and package integrations. */
 export interface EvaluateTransitionResult {
 /** Whether the transition is permitted. */
-allowed: boolean;
+allowed:boolean;
 /** Whether a matching per-type rule constrained the transition. */
-hasRule: boolean;
+hasRule:boolean;
 /** Allowed [from, to] pairs for the matched type (normalized ids). Empty when the type is unrestricted. */
-allowedTransitions: [string, string][];
+allowedTransitions:[string,string][];
 }
 /**
  * Normalize the raw type_workflows from a runtime schema into a deduped,
@@ -63,8 +63,8 @@ allowedTransitions: [string, string][];
  * (which would leave the type unrestricted). Entries with a missing/empty type
  * or a non-array `allowed_transitions` are dropped, as are malformed/short pairs.
  */
-export declare function resolveTypeWorkflows(schema: Pick<RuntimeSchemaSettings, "type_workflows"> | undefined): NormalizedTypeWorkflow[];
+export declare function resolveTypeWorkflows(schema:Pick<RuntimeSchemaSettings,"type_workflows"> | undefined):NormalizedTypeWorkflow[];
 /** Evaluate whether a status transition is allowed for the given item type. Returns hasRule=false (allowed) when the type is unrestricted. */
-export declare function evaluateTransition(input: EvaluateTransitionInput): EvaluateTransitionResult;
+export declare function evaluateTransition(input:EvaluateTransitionInput):EvaluateTransitionResult;
 /** Render the allowed transitions for an error/warning hint. */
-export declare function describeAllowedTransitions(allowedTransitions: [string, string][]): string;
+export declare function describeAllowedTransitions(allowedTransitions:[string,string][]):string;

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

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="be646cfd-4742-5e15-9df1-648f1d250a99")}catch{}})();import{normalizeStatusToken}from"./status-token.js";import{normalizeStatusToken as normalizeStatusToken2}from"./status-token.js";function normalizeTypeName(value){return typeof value=="string"?value.trim().toLowerCase():""}function resolveStatusId(value,statusRegistry){const token=normalizeStatusToken(value);return token.length===0?"":statusRegistry?.alias_to_id?.get(token)??token}function resolveTypeWorkflows(schema){const rawWorkflows=Array.isArray(schema?.type_workflows)?schema.type_workflows:[],byType=new Map;for(const entry of rawWorkflows){const type=normalizeTypeName(entry?.type);if(type.length===0||!Array.isArray(entry?.allowed_transitions))continue;const pairs=entry.allowed_transitions,record=byType.get(type)??{pairs:[],denyAll:!1};pairs.length===0&&(record.denyAll=!0);for(const pair of pairs){if(!Array.isArray(pair)||pair.length!==2)continue;const from=normalizeStatusToken(pair[0]),to=normalizeStatusToken(pair[1]);from.length===0||to.length===0||record.pairs.some(candidate=>candidate[0]===from&&candidate[1]===to)||record.pairs.push([from,to])}byType.set(type,record)}return[...byType.entries()].filter(([,record])=>record.pairs.length>0||record.denyAll).map(([type,record])=>({type,allowed_transitions:record.pairs})).sort((left,right)=>left.type.localeCompare(right.type))}function evaluateTransition(input){const typeName=normalizeTypeName(input.typeName),matched=input.typeWorkflows.find(workflow=>workflow.type===typeName);if(!matched)return{allowed:!0,hasRule:!1,allowedTransitions:[]};const from=resolveStatusId(input.fromStatus,input.statusRegistry),to=resolveStatusId(input.toStatus,input.statusRegistry);return from.length>0&&from===to?{allowed:!0,hasRule:!0,allowedTransitions:matched.allowed_transitions}:{allowed:matched.allowed_transitions.some(pair=>{const ruleFrom=resolveStatusId(pair[0],input.statusRegistry),ruleTo=resolveStatusId(pair[1],input.statusRegistry);return ruleFrom===from&&ruleTo===to}),hasRule:!0,allowedTransitions:matched.allowed_transitions}}function describeAllowedTransitions(allowedTransitions){return allowedTransitions.length===0?"(no transitions allowed)":allowedTransitions.map(pair=>`${pair[0]} -> ${pair[1]}`).join(", ")}export{describeAllowedTransitions,evaluateTransition,normalizeStatusToken2 as normalizeStatusToken,resolveTypeWorkflows};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="77a7b77a-907c-541d-ac55-e06174dbbf11")}catch{}})();import{normalizeStatusToken}from"./status-token.js";import{normalizeStatusToken as normalizeStatusToken2}from"./status-token.js";function normalizeTypeName(value){return typeof value=="string"?value.trim().toLowerCase():""}function resolveStatusId(value,statusRegistry){const token=normalizeStatusToken(value);return token.length===0?"":statusRegistry?.alias_to_id?.get(token)??token}function resolveTypeWorkflows(schema){const rawWorkflows=Array.isArray(schema?.type_workflows)?schema.type_workflows:[],byType=new Map;for(const entry of rawWorkflows){const type=normalizeTypeName(entry?.type);if(type.length===0||!Array.isArray(entry?.allowed_transitions))continue;const pairs=entry.allowed_transitions,record=byType.get(type)??{pairs:[],denyAll:!1};pairs.length===0&&(record.denyAll=!0);for(const pair of pairs){if(!Array.isArray(pair)||pair.length!==2)continue;const from=normalizeStatusToken(pair[0]),to=normalizeStatusToken(pair[1]);from.length===0||to.length===0||record.pairs.some(candidate=>candidate[0]===from&&candidate[1]===to)||record.pairs.push([from,to])}byType.set(type,record)}return[...byType.entries()].filter(([,record])=>record.pairs.length>0||record.denyAll).map(([type,record])=>({type,allowed_transitions:record.pairs})).sort((left,right)=>left.type.localeCompare(right.type))}function evaluateTransition(input){const typeName=normalizeTypeName(input.typeName),matched=input.typeWorkflows.find(workflow=>workflow.type===typeName);if(!matched)return{allowed:!0,hasRule:!1,allowedTransitions:[]};const from=resolveStatusId(input.fromStatus,input.statusRegistry),to=resolveStatusId(input.toStatus,input.statusRegistry);return from.length>0&&from===to?{allowed:!0,hasRule:!0,allowedTransitions:matched.allowed_transitions}:{allowed:matched.allowed_transitions.some(pair=>{const ruleFrom=resolveStatusId(pair[0],input.statusRegistry),ruleTo=resolveStatusId(pair[1],input.statusRegistry);return ruleFrom===from&&ruleTo===to}),hasRule:!0,allowedTransitions:matched.allowed_transitions}}function describeAllowedTransitions(allowedTransitions){return allowedTransitions.length===0?"(no transitions allowed)":allowedTransitions.map(pair=>`${pair[0]} -> ${pair[1]}`).join(", ")}export{describeAllowedTransitions,evaluateTransition,normalizeStatusToken2 as normalizeStatusToken,resolveTypeWorkflows};
 //# sourceMappingURL=type-workflows.js.map

package/dist/core/search/background-refresh.d.ts

@@ -3,27 +3,27 @@ export declare const REINDEX_LOCK_ID = "reindex";
 /** Delay before a settings-failed worker dispatches one replacement child, preventing a tight retry loop while preserving eventual queue recovery. */
 export declare const SEARCH_REFRESH_RETRY_DELAY_MS = 30000;
 /** Mutation search refresh runs inline (blocking) under test runners, inside the background worker child itself, or when explicitly requested. Otherwise the semantic refresh is dispatched to a detached child so mutations return without waiting on embeddings. Mirrors the telemetry-flush inline gate so the full test suite stays deterministic. */
-export declare function shouldRunSearchRefreshInForeground(): boolean;
+export declare function shouldRunSearchRefreshInForeground():boolean;
 /** Merge mutated item ids into the persistent pending-refresh queue. */
-export declare function enqueuePendingRefreshIds(pmRoot: string, itemIds: string[]): Promise<void>;
+export declare function enqueuePendingRefreshIds(pmRoot:string,itemIds:string[]):Promise<void>;
 /** Atomically read and clear the pending-refresh queue, returning drained ids. */
-export declare function drainPendingRefreshIds(pmRoot: string): Promise<string[]>;
+export declare function drainPendingRefreshIds(pmRoot:string):Promise<string[]>;
 /** Enqueue mutated ids and dispatch a detached worker child to refresh semantic embeddings without blocking the mutation. The reindex lock the worker acquires serializes concurrent refreshes, so the spawn itself stays unconditional and cheap; a worker that loses the lock exits and its ids are drained by the holder. */
-export declare function scheduleBackgroundSemanticRefresh(pmRoot: string, itemIds: string[]): Promise<void>;
+export declare function scheduleBackgroundSemanticRefresh(pmRoot:string,itemIds:string[]):Promise<void>;
 /** Documents the semantic refresh worker result payload exchanged by command, SDK, and package integrations. */
 export interface SemanticRefreshWorkerResult {
 /** Value that configures or reports processed for this contract. */
-processed: string[];
+processed:string[];
 /** Value that configures or reports rounds for this contract. */
-rounds: number;
+rounds:number;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
-type SemanticRefreshFn = (pmRoot: string, itemIds: string[]) => Promise<{
-refreshed: string[];
-skipped: string[];
-warnings: string[];
+type SemanticRefreshFn = (pmRoot:string,itemIds:string[]) => Promise<{
+refreshed:string[];
+skipped:string[];
+warnings:string[];
 }>;
 /** Drain the pending queue and refresh semantic vectors under the reindex lock so the local vector store is never rewritten concurrently. If the lock is held by another worker we exit immediately — that holder drains our enqueued ids. After releasing we re-check the queue once and re-dispatch if a sibling enqueued ids during our final window, guaranteeing eventual processing. */
-export declare function runSemanticRefreshWorker(pmRoot: string, refresh: SemanticRefreshFn, scheduleRetry?: (root: string) => void): Promise<SemanticRefreshWorkerResult>;
+export declare function runSemanticRefreshWorker(pmRoot:string,refresh:SemanticRefreshFn,scheduleRetry?:(root:string) => void):Promise<SemanticRefreshWorkerResult>;
 export {};

package/dist/core/search/bm25.d.ts

@@ -24,9 +24,9 @@ export declare const DEFAULT_BM25_B = 0.75;
  */
 export interface Bm25Params {
 /** Term-frequency saturation (`k1`); finite and `>= 0`. */
-k1: number;
+k1:number;
 /** Length normalization (`b`); finite and within `[0, 1]`. */
-b: number;
+b:number;
 }
 /**
  * One corpus document supplied to {@link buildBm25Index}: a stable id and the
@@ -35,9 +35,9 @@ b: number;
  */
 export interface Bm25Document {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports text for this contract. */
-text: string;
+text:string;
 }
 /**
  * Per-document statistics retained in a {@link Bm25Index}: the term-frequency
@@ -45,9 +45,9 @@ text: string;
  * normalization.
  */
 interface Bm25DocumentStats {
-id: string;
-termFrequencies: Map<string, number>;
-length: number;
+id:string;
+termFrequencies:Map<string,number>;
+length:number;
 }
 /**
  * An immutable BM25 index built from a document set. Carries the per-document
@@ -57,13 +57,13 @@ length: number;
  */
 export interface Bm25Index {
 /** Value that configures or reports documents for this contract. */
-documents: Bm25DocumentStats[];
+documents:Bm25DocumentStats[];
 /** Value that configures or reports document frequency for this contract. */
-documentFrequency: Map<string, number>;
+documentFrequency:Map<string,number>;
 /** Number of document entries represented by this result. */
-documentCount: number;
+documentCount:number;
 /** Value that configures or reports average document length for this contract. */
-averageDocumentLength: number;
+averageDocumentLength:number;
 }
 /**
  * Tokenize a document/query string into BM25 terms. Shares
@@ -71,7 +71,7 @@ averageDocumentLength: number;
  * identical to the rest of search: lowercase, alphanumeric runs, no stop-word
  * removal or stemming (kept deliberately simple and language-agnostic).
  */
-export declare function tokenizeBm25(text: string): string[];
+export declare function tokenizeBm25(text:string):string[];
 /**
  * Build a BM25 index from a corpus. Computes each document's term frequencies
  * and length, the per-term document frequency, the corpus size, and the average
@@ -80,16 +80,16 @@ export declare function tokenizeBm25(text: string): string[];
  * corpus yields an index with `averageDocumentLength` `0`, which
  * {@link scoreBm25Query} handles without dividing by zero.
  */
-export declare function buildBm25Index(documents: Bm25Document[]): Bm25Index;
+export declare function buildBm25Index(documents:Bm25Document[]):Bm25Index;
 /** Score every document in the index against a query and return an id → score map containing only documents with a strictly positive score (a document that matches no query term is omitted, mirroring the lexical scorer's "no match → no hit" contract). Query tokens are de-duplicated so a token repeated in the query does not multiply its own contribution. Returns an empty map for an empty index, an empty query, or a query whose terms appear in no document. */
-export declare function scoreBm25Query(index: Bm25Index, queryTokens: string[], params: Bm25Params): Map<string, number>;
+export declare function scoreBm25Query(index:Bm25Index,queryTokens:string[],params:Bm25Params):Map<string,number>;
 /** Flatten a structured search-corpus record (the shape produced by `buildSearchCorpus`) into a single whitespace-joined string of its *values* only — field names/object keys are deliberately excluded so corpus-wide keys (`title`, `description`, …) never enter the BM25 vocabulary and skew IDF. Strings and numbers contribute their text; arrays and nested objects (tags, dependencies, the plan corpus) are walked recursively; everything else is dropped. */
-export declare function flattenSearchCorpusText(corpus: Record<string, unknown>): string;
+export declare function flattenSearchCorpusText(corpus:Record<string,unknown>):string;
 /**
  * Resolve the effective BM25 parameters from `settings.search.bm25`, applying
  * {@link DEFAULT_BM25_K1}/{@link DEFAULT_BM25_B} when unset and clamping `k1` to
  * `[0, 1000]` and `b` to `[0, 1]`. Tolerant of partial/invalid config: each
  * knob is resolved independently so one bad value does not discard the other.
  */
-export declare function resolveBm25Params(settings: Pick<PmSettings, "search"> | undefined): Bm25Params;
+export declare function resolveBm25Params(settings:Pick<PmSettings,"search"> | undefined):Bm25Params;
 export {};