@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/core/extensions/registration-contracts.d.ts

@@ -3,25 +3,25 @@
  * Validates contributed command, flag, schema and profile definitions before registration.
  */
 import type { ProjectProfileDefinition } from "../profile/profile-presets.js";
-import { type ExtensionCommandArgumentDefinition, type FlagDefinition } from "./extension-types.js";
+import { type ExtensionCommandArgumentDefinition,type FlagDefinition } from "./extension-types.js";
 /** Normalize registration records and expand the repeatable alias into the canonical list flag property. */
-declare function normalizeFlagDefinitions(name: string, value: unknown): FlagDefinition[];
+declare function normalizeFlagDefinitions(name:string,value:unknown):FlagDefinition[];
 /** Derive an action from the command path or reject an invalid explicit action before registration. */
-declare function resolveCommandDefinitionAction(commandPath: string, action: unknown): string;
+declare function resolveCommandDefinitionAction(commandPath:string,action:unknown):string;
 /** Validate positional argument records and enforce that at most one variadic argument appears last. */
-declare function normalizeCommandDefinitionArguments(value: unknown): ExtensionCommandArgumentDefinition[];
+declare function normalizeCommandDefinitionArguments(value:unknown):ExtensionCommandArgumentDefinition[];
 /** Reject unknown flag properties, invalid tokens, inconsistent repeatability and defaults incompatible with the declared value type. */
-declare function validateFlagDefinitions(flags: unknown): void;
+declare function validateFlagDefinitions(flags:unknown):void;
 /** Reject a declared `value_type`/`type` that is not a known flag value kind, and a `default` whose value(s) would not cleanly coerce under that kind — so the typed-flag contract is enforced at registration instead of silently leaving an untyped value to surface at use time. */
-declare function assertFlagValueTypeAndDefault(label: string, record: Record<string, unknown>): void;
+declare function assertFlagValueTypeAndDefault(label:string,record:Record<string,unknown>):void;
 /** Validate custom field names and types, including typo guidance, before fields enter the runtime schema. */
-declare function validateItemFieldDefinitions(fields: unknown): void;
+declare function validateItemFieldDefinitions(fields:unknown):void;
 /** Check custom item type metadata, creation requirements and command option policies before registration. */
-declare function validateItemTypeDefinitions(types: unknown): void;
+declare function validateItemTypeDefinitions(types:unknown):void;
 /** Validate optional migration metadata and ensure a supplied migration runner is callable. */
-declare function validateMigrationDefinition(definition: unknown): void;
+declare function validateMigrationDefinition(definition:unknown):void;
 /** Reject malformed profile dimensions and entries before downstream planners dereference their schema properties. */
-declare function validateProjectProfileDefinition(profile: unknown): void;
+declare function validateProjectProfileDefinition(profile:unknown):void;
 /**
  * Fills an already-validated profile snapshot's optional surfaces — an absent
  * `summary` becomes an empty string and every omitted dimension an empty array —
@@ -30,5 +30,5 @@ declare function validateProjectProfileDefinition(profile: unknown): void;
  * validation on the cloned snapshot, so it only ever supplies missing defaults
  * and never has to coerce an invalid type (those are already rejected).
  */
-declare function applyProjectProfileDefaults(profile: Record<string, unknown>): ProjectProfileDefinition;
-export { applyProjectProfileDefaults, assertFlagValueTypeAndDefault, normalizeCommandDefinitionArguments, normalizeFlagDefinitions, resolveCommandDefinitionAction, validateFlagDefinitions, validateItemFieldDefinitions, validateItemTypeDefinitions, validateMigrationDefinition, validateProjectProfileDefinition };
+declare function applyProjectProfileDefaults(profile:Record<string,unknown>):ProjectProfileDefinition;
+export { applyProjectProfileDefaults,assertFlagValueTypeAndDefault,normalizeCommandDefinitionArguments,normalizeFlagDefinitions,resolveCommandDefinitionAction,validateFlagDefinitions,validateItemFieldDefinitions,validateItemTypeDefinitions,validateMigrationDefinition,validateProjectProfileDefinition };

package/dist/core/extensions/registration-contracts.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]="bc1e888a-4274-5d8d-9077-89ca5341172c")}catch{}})();import{describeExtensionLongFlagFailure,findExtensionFlagTokenFailure}from"./flag-definition-validation.js";import{flattenFlagListValue,isFlagDefaultValueCoercible,resolveFlagValueKind}from"./flag-value-types.js";import{KNOWN_ITEM_FIELD_TYPES,normalizeItemFieldType,suggestKnownItemFieldType}from"./item-field-types.js";import{asRegistrationRecord,assertOptionalBooleanField,assertOptionalFlagDefaultField,assertOptionalStringArrayField,assertOptionalStringField}from"./registration-validation.js";import{assertNonEmptyRegistrationString,normalizeRegistrationRecordList}from"./registration-values.js";const FLAG_DEFINITION_KEYS=new Set(["default","description","enabled","list","long","repeatable","required","short","type","value_name","value_type","visible"]);function normalizeFlagDefinitions(name,value){return normalizeRegistrationRecordList(name,value).map(record=>(record.repeatable===!0&&(record.list=!0),record))}function normalizeCommandActionName(value){return value.trim().toLowerCase().replace(/[\s_]+/g,"-").replace(/[^a-z0-9-]/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function resolveCommandDefinitionAction(commandPath,action){if(action===void 0)return commandPath.replace(/\s+/g,"-");if(typeof action!="string"||action.trim().length===0)throw new TypeError("registerCommand definition.action must be a non-empty string when provided");const normalized=normalizeCommandActionName(action);if(normalized.length===0)throw new TypeError("registerCommand definition.action must contain alphanumeric characters");return normalized}function normalizeCommandDefinitionArguments(value){if(value===void 0)return[];if(!Array.isArray(value))throw new TypeError("registerCommand definition.arguments must be an array when provided");const normalized=[];for(const[index,entry]of value.entries()){const record=asRegistrationRecord(`registerCommand definition.arguments[${index}]`,entry),name=assertNonEmptyRegistrationString(`registerCommand definition.arguments[${index}].name`,record.name);if(assertOptionalBooleanField(`registerCommand definition.arguments[${index}].required`,record.required),assertOptionalBooleanField(`registerCommand definition.arguments[${index}].variadic`,record.variadic),assertOptionalStringField(`registerCommand definition.arguments[${index}].description`,record.description),name.includes(" "))throw new TypeError(`registerCommand definition.arguments[${index}].name must not contain spaces`);const definition={name};record.required===!0&&(definition.required=!0),record.variadic===!0&&(definition.variadic=!0),typeof record.description=="string"&&(definition.description=record.description.trim()),normalized.push(definition)}const variadicIndexes=normalized.map((argument,index)=>argument.variadic?index:-1).filter(index=>index>=0);if(variadicIndexes.length>1)throw new TypeError("registerCommand definition.arguments supports at most one variadic argument");if(variadicIndexes.length===1&&variadicIndexes[0]!==normalized.length-1)throw new TypeError("registerCommand definition.arguments variadic argument must be the final argument");return normalized}function validateFlagDefinitions(flags){if(!Array.isArray(flags))throw new TypeError("registerFlags flags requires an array of object definitions");for(const[index,raw]of flags.entries()){const record=asRegistrationRecord(`registerFlags flags[${index}]`,raw),unknownKeys=Object.keys(record).filter(key=>!FLAG_DEFINITION_KEYS.has(key)).sort((left,right)=>left.localeCompare(right));if(unknownKeys.length>0)throw new TypeError(`registerFlags flags[${index}] contains unknown field(s): ${unknownKeys.join(", ")}`);const long=record.long,short=record.short;if(long===void 0&&short===void 0)throw new TypeError(`registerFlags flags[${index}] requires at least one of long or short`);assertOptionalStringField(`registerFlags flags[${index}].long`,long),assertOptionalStringField(`registerFlags flags[${index}].short`,short);const tokenFinding=findExtensionFlagTokenFailure(long,short);if(tokenFinding!==null)throw new TypeError(`registerFlags flags[${index}] ${describeExtensionLongFlagFailure(tokenFinding.token,tokenFinding.failure)}`);if(assertOptionalStringField(`registerFlags flags[${index}].value_name`,record.value_name),assertOptionalStringField(`registerFlags flags[${index}].description`,record.description),assertOptionalBooleanField(`registerFlags flags[${index}].required`,record.required),assertOptionalBooleanField(`registerFlags flags[${index}].enabled`,record.enabled),assertOptionalBooleanField(`registerFlags flags[${index}].visible`,record.visible),assertOptionalBooleanField(`registerFlags flags[${index}].list`,record.list),assertOptionalBooleanField(`registerFlags flags[${index}].repeatable`,record.repeatable),record.list!==void 0&&record.repeatable!==void 0&&record.list!==record.repeatable)throw new TypeError(`registerFlags flags[${index}].list and repeatable must match when both are provided`);if(assertOptionalFlagDefaultField(`registerFlags flags[${index}].default`,record.default),Array.isArray(record.default)&&record.list!==!0&&record.repeatable!==!0)throw new TypeError(`registerFlags flags[${index}].default cannot be an array unless list is true.`);assertFlagValueTypeAndDefault(`registerFlags flags[${index}]`,record)}}function assertFlagValueTypeAndDefault(label,record){const declaredType=(typeof record.value_type=="string"?record.value_type:void 0)??(typeof record.type=="string"?record.type:void 0);if(declaredType===void 0)return;const kind=resolveFlagValueKind(declaredType);if(kind===null)throw new TypeError(`${label} value_type "${declaredType}" is not a known flag value type (expected one of: string, number, boolean).`);if(record.default===void 0)return;const defaults=record.list===!0||record.repeatable===!0?flattenFlagListValue(record.default):[record.default];for(const[defaultIndex,defaultValue]of defaults.entries())if(!isFlagDefaultValueCoercible(defaultValue,kind)){const suffix=defaults.length>1?`default[${defaultIndex}]`:"default";throw new TypeError(`${label}.${suffix} (${JSON.stringify(defaultValue)}) is not coercible to ${kind}.`)}}function validateItemFieldDefinitions(fields){if(!Array.isArray(fields))throw new TypeError("registerItemFields fields requires an array of object definitions");for(const[index,raw]of fields.entries()){const record=asRegistrationRecord(`registerItemFields fields[${index}]`,raw);assertNonEmptyRegistrationString(`registerItemFields fields[${index}].name`,record.name);const fieldType=assertNonEmptyRegistrationString(`registerItemFields fields[${index}].type`,record.type);if(normalizeItemFieldType(fieldType)===null){const suggestion=suggestKnownItemFieldType(fieldType),hint=suggestion?` Did you mean "${suggestion}"?`:"";throw new TypeError(`registerItemFields fields[${index}].type "${fieldType}" is not a known field type (expected one of: ${KNOWN_ITEM_FIELD_TYPES.join(", ")}).${hint}`)}assertOptionalBooleanField(`registerItemFields fields[${index}].optional`,record.optional)}}function validateItemTypeCommandOptionPolicies(typeIndex,value){if(value===void 0)return;const label=`registerItemTypes types[${typeIndex}].command_option_policies`;if(!Array.isArray(value))throw new TypeError(`${label} must be an array when provided`);for(const[policyIndex,rawPolicy]of value.entries()){const at=`${label}[${policyIndex}]`,policy=asRegistrationRecord(at,rawPolicy);assertNonEmptyRegistrationString(`${at}.command`,policy.command),assertNonEmptyRegistrationString(`${at}.option`,policy.option),assertOptionalBooleanField(`${at}.enabled`,policy.enabled),assertOptionalBooleanField(`${at}.required`,policy.required),assertOptionalBooleanField(`${at}.visible`,policy.visible)}}function validateItemTypeOptions(typeIndex,value){if(value===void 0)return;const label=`registerItemTypes types[${typeIndex}].options`;if(!Array.isArray(value))throw new TypeError(`${label} must be an array when provided`);for(const[optionIndex,rawOption]of value.entries()){const at=`${label}[${optionIndex}]`,option=asRegistrationRecord(at,rawOption);assertNonEmptyRegistrationString(`${at}.key`,option.key),assertOptionalStringArrayField(`${at}.values`,option.values),assertOptionalBooleanField(`${at}.required`,option.required),assertOptionalStringArrayField(`${at}.aliases`,option.aliases)}}function validateItemTypeDefinitions(types){if(!Array.isArray(types))throw new TypeError("registerItemTypes types requires an array of object definitions");for(const[typeIndex,raw]of types.entries()){const at=`registerItemTypes types[${typeIndex}]`,record=asRegistrationRecord(at,raw);assertNonEmptyRegistrationString(`${at}.name`,record.name),assertOptionalStringField(`${at}.folder`,record.folder),assertOptionalStringArrayField(`${at}.aliases`,record.aliases),assertOptionalStringArrayField(`${at}.required_create_fields`,record.required_create_fields),assertOptionalStringArrayField(`${at}.required_create_repeatables`,record.required_create_repeatables),validateItemTypeCommandOptionPolicies(typeIndex,record.command_option_policies),validateItemTypeOptions(typeIndex,record.options)}}function validateMigrationDefinition(definition){const record=asRegistrationRecord("registerMigration definition",definition);if(record.id!==void 0&&typeof record.id!="string")throw new TypeError("registerMigration definition.id must be a string when provided");if(record.description!==void 0&&typeof record.description!="string")throw new TypeError("registerMigration definition.description must be a string when provided");if(record.status!==void 0&&typeof record.status!="string")throw new TypeError("registerMigration definition.status must be a string when provided");if(assertOptionalBooleanField("registerMigration definition.mandatory",record.mandatory),record.run!==void 0&&typeof record.run!="function")throw new TypeError("registerMigration definition.run must be a function when provided")}const PROJECT_PROFILE_DIMENSIONS=["types","statuses","fields","workflows","config","templates","packages"],PROJECT_PROFILE_ENTRY_VALIDATORS={types:(at,entry)=>{if(entry.name!==void 0&&typeof entry.name!="string")throw new TypeError(`${at}.name must be a string when provided`)},workflows:(at,entry)=>{if(typeof entry.type!="string")throw new TypeError(`${at}.type must be a string`);if(!Array.isArray(entry.allowed_transitions))throw new TypeError(`${at}.allowed_transitions must be an array`);for(const[pairIndex,pair]of entry.allowed_transitions.entries())if(!Array.isArray(pair))throw new TypeError(`${at}.allowed_transitions[${pairIndex}] must be a [from, to] array`)},templates:(at,entry)=>{if(typeof entry.name!="string")throw new TypeError(`${at}.name must be a string`);if(typeof entry.options!="object"||entry.options===null||Array.isArray(entry.options))throw new TypeError(`${at}.options must be an object`)},packages:(at,entry)=>{if(typeof entry.spec!="string")throw new TypeError(`${at}.spec must be a string`)}};function validateProjectProfileDefinition(profile){const record=asRegistrationRecord("registerProfile profile",profile);if(assertNonEmptyRegistrationString("registerProfile profile.name",record.name),assertNonEmptyRegistrationString("registerProfile profile.title",record.title),record.summary!==void 0&&typeof record.summary!="string")throw new TypeError("registerProfile profile.summary must be a string when provided");for(const dimension of PROJECT_PROFILE_DIMENSIONS){const value=record[dimension];if(value!==void 0){if(!Array.isArray(value))throw new TypeError(`registerProfile profile.${dimension} must be an array when provided`);for(const[index,entry]of value.entries()){if(typeof entry!="object"||entry===null||Array.isArray(entry))throw new TypeError(`registerProfile profile.${dimension}[${index}] must be an object`);PROJECT_PROFILE_ENTRY_VALIDATORS[dimension]?.(`registerProfile profile.${dimension}[${index}]`,entry)}}}}function applyProjectProfileDefaults(profile){profile.summary===void 0&&(profile.summary="");for(const dimension of PROJECT_PROFILE_DIMENSIONS)profile[dimension]===void 0&&(profile[dimension]=[]);return profile}export{applyProjectProfileDefaults,assertFlagValueTypeAndDefault,normalizeCommandDefinitionArguments,normalizeFlagDefinitions,resolveCommandDefinitionAction,validateFlagDefinitions,validateItemFieldDefinitions,validateItemTypeDefinitions,validateMigrationDefinition,validateProjectProfileDefinition};
+(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]="4abca948-e9ba-52b5-b63c-a20fc344980a")}catch{}})();import{describeExtensionLongFlagFailure,findExtensionFlagTokenFailure}from"./flag-definition-validation.js";import{flattenFlagListValue,isFlagDefaultValueCoercible,resolveFlagValueKind}from"./flag-value-types.js";import{KNOWN_ITEM_FIELD_TYPES,normalizeItemFieldType,suggestKnownItemFieldType}from"./item-field-types.js";import{asRegistrationRecord,assertOptionalBooleanField,assertOptionalFlagDefaultField,assertOptionalStringArrayField,assertOptionalStringField}from"./registration-validation.js";import{assertNonEmptyRegistrationString,normalizeRegistrationRecordList}from"./registration-values.js";const FLAG_DEFINITION_KEYS=new Set(["default","description","enabled","list","long","repeatable","required","short","type","value_name","value_type","value_validation","visible"]);function normalizeFlagDefinitions(name,value){return normalizeRegistrationRecordList(name,value).map(record=>(record.repeatable===!0&&(record.list=!0),record))}function normalizeCommandActionName(value){return value.trim().toLowerCase().replace(/[\s_]+/g,"-").replace(/[^a-z0-9-]/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function resolveCommandDefinitionAction(commandPath,action){if(action===void 0)return commandPath.replace(/\s+/g,"-");if(typeof action!="string"||action.trim().length===0)throw new TypeError("registerCommand definition.action must be a non-empty string when provided");const normalized=normalizeCommandActionName(action);if(normalized.length===0)throw new TypeError("registerCommand definition.action must contain alphanumeric characters");return normalized}function normalizeCommandDefinitionArguments(value){if(value===void 0)return[];if(!Array.isArray(value))throw new TypeError("registerCommand definition.arguments must be an array when provided");const normalized=[];for(const[index,entry]of value.entries()){const record=asRegistrationRecord(`registerCommand definition.arguments[${index}]`,entry),name=assertNonEmptyRegistrationString(`registerCommand definition.arguments[${index}].name`,record.name);if(assertOptionalBooleanField(`registerCommand definition.arguments[${index}].required`,record.required),assertOptionalBooleanField(`registerCommand definition.arguments[${index}].variadic`,record.variadic),assertOptionalStringField(`registerCommand definition.arguments[${index}].description`,record.description),name.includes(" "))throw new TypeError(`registerCommand definition.arguments[${index}].name must not contain spaces`);const definition={name};record.required===!0&&(definition.required=!0),record.variadic===!0&&(definition.variadic=!0),typeof record.description=="string"&&(definition.description=record.description.trim()),normalized.push(definition)}const variadicIndexes=normalized.map((argument,index)=>argument.variadic?index:-1).filter(index=>index>=0);if(variadicIndexes.length>1)throw new TypeError("registerCommand definition.arguments supports at most one variadic argument");if(variadicIndexes.length===1&&variadicIndexes[0]!==normalized.length-1)throw new TypeError("registerCommand definition.arguments variadic argument must be the final argument");return normalized}function validateFlagDefinitions(flags){if(!Array.isArray(flags))throw new TypeError("registerFlags flags requires an array of object definitions");for(const[index,raw]of flags.entries()){const record=asRegistrationRecord(`registerFlags flags[${index}]`,raw),unknownKeys=Object.keys(record).filter(key=>!FLAG_DEFINITION_KEYS.has(key)).sort((left,right)=>left.localeCompare(right));if(unknownKeys.length>0)throw new TypeError(`registerFlags flags[${index}] contains unknown field(s): ${unknownKeys.join(", ")}`);const long=record.long,short=record.short;if(long===void 0&&short===void 0)throw new TypeError(`registerFlags flags[${index}] requires at least one of long or short`);assertOptionalStringField(`registerFlags flags[${index}].long`,long),assertOptionalStringField(`registerFlags flags[${index}].short`,short);const tokenFinding=findExtensionFlagTokenFailure(long,short);if(tokenFinding!==null)throw new TypeError(`registerFlags flags[${index}] ${describeExtensionLongFlagFailure(tokenFinding.token,tokenFinding.failure)}`);if(assertOptionalStringField(`registerFlags flags[${index}].value_name`,record.value_name),assertOptionalStringField(`registerFlags flags[${index}].description`,record.description),assertOptionalBooleanField(`registerFlags flags[${index}].required`,record.required),assertOptionalBooleanField(`registerFlags flags[${index}].enabled`,record.enabled),assertOptionalBooleanField(`registerFlags flags[${index}].visible`,record.visible),assertOptionalBooleanField(`registerFlags flags[${index}].list`,record.list),assertOptionalBooleanField(`registerFlags flags[${index}].repeatable`,record.repeatable),record.list!==void 0&&record.repeatable!==void 0&&record.list!==record.repeatable)throw new TypeError(`registerFlags flags[${index}].list and repeatable must match when both are provided`);if(assertOptionalFlagDefaultField(`registerFlags flags[${index}].default`,record.default),Array.isArray(record.default)&&record.list!==!0&&record.repeatable!==!0)throw new TypeError(`registerFlags flags[${index}].default cannot be an array unless list is true.`);assertFlagValueTypeAndDefault(`registerFlags flags[${index}]`,record),assertFlagValueValidation(`registerFlags flags[${index}]`,record)}}function assertFlagValueValidation(label,record){if(record.value_validation===void 0)return;if(record.value_validation!=="coerce"&&record.value_validation!=="strict")throw new TypeError(`${label}.value_validation must be "coerce" or "strict" (received ${JSON.stringify(record.value_validation)}).`);if(record.value_validation!=="strict")return;const declaredType=(typeof record.value_type=="string"?record.value_type:void 0)??(typeof record.type=="string"?record.type:void 0),kind=declaredType===void 0?null:resolveFlagValueKind(declaredType);if(kind!=="number"&&kind!=="boolean")throw new TypeError(`${label}.value_validation "strict" requires value_type "number" or "boolean" (string values are never malformed).`)}function assertFlagValueTypeAndDefault(label,record){const declaredType=(typeof record.value_type=="string"?record.value_type:void 0)??(typeof record.type=="string"?record.type:void 0);if(declaredType===void 0)return;const kind=resolveFlagValueKind(declaredType);if(kind===null)throw new TypeError(`${label} value_type "${declaredType}" is not a known flag value type (expected one of: string, number, boolean).`);if(record.default===void 0)return;const defaults=record.list===!0||record.repeatable===!0?flattenFlagListValue(record.default):[record.default];for(const[defaultIndex,defaultValue]of defaults.entries())if(!isFlagDefaultValueCoercible(defaultValue,kind)){const suffix=defaults.length>1?`default[${defaultIndex}]`:"default";throw new TypeError(`${label}.${suffix} (${JSON.stringify(defaultValue)}) is not coercible to ${kind}.`)}}function validateItemFieldDefinitions(fields){if(!Array.isArray(fields))throw new TypeError("registerItemFields fields requires an array of object definitions");for(const[index,raw]of fields.entries()){const record=asRegistrationRecord(`registerItemFields fields[${index}]`,raw);assertNonEmptyRegistrationString(`registerItemFields fields[${index}].name`,record.name);const fieldType=assertNonEmptyRegistrationString(`registerItemFields fields[${index}].type`,record.type);if(normalizeItemFieldType(fieldType)===null){const suggestion=suggestKnownItemFieldType(fieldType),hint=suggestion?` Did you mean "${suggestion}"?`:"";throw new TypeError(`registerItemFields fields[${index}].type "${fieldType}" is not a known field type (expected one of: ${KNOWN_ITEM_FIELD_TYPES.join(", ")}).${hint}`)}assertOptionalBooleanField(`registerItemFields fields[${index}].optional`,record.optional)}}function validateItemTypeCommandOptionPolicies(typeIndex,value){if(value===void 0)return;const label=`registerItemTypes types[${typeIndex}].command_option_policies`;if(!Array.isArray(value))throw new TypeError(`${label} must be an array when provided`);for(const[policyIndex,rawPolicy]of value.entries()){const at=`${label}[${policyIndex}]`,policy=asRegistrationRecord(at,rawPolicy);assertNonEmptyRegistrationString(`${at}.command`,policy.command),assertNonEmptyRegistrationString(`${at}.option`,policy.option),assertOptionalBooleanField(`${at}.enabled`,policy.enabled),assertOptionalBooleanField(`${at}.required`,policy.required),assertOptionalBooleanField(`${at}.visible`,policy.visible)}}function validateItemTypeOptions(typeIndex,value){if(value===void 0)return;const label=`registerItemTypes types[${typeIndex}].options`;if(!Array.isArray(value))throw new TypeError(`${label} must be an array when provided`);for(const[optionIndex,rawOption]of value.entries()){const at=`${label}[${optionIndex}]`,option=asRegistrationRecord(at,rawOption);assertNonEmptyRegistrationString(`${at}.key`,option.key),assertOptionalStringArrayField(`${at}.values`,option.values),assertOptionalBooleanField(`${at}.required`,option.required),assertOptionalStringArrayField(`${at}.aliases`,option.aliases)}}function validateItemTypeDefinitions(types){if(!Array.isArray(types))throw new TypeError("registerItemTypes types requires an array of object definitions");for(const[typeIndex,raw]of types.entries()){const at=`registerItemTypes types[${typeIndex}]`,record=asRegistrationRecord(at,raw);assertNonEmptyRegistrationString(`${at}.name`,record.name),assertOptionalStringField(`${at}.folder`,record.folder),assertOptionalStringArrayField(`${at}.aliases`,record.aliases),assertOptionalStringArrayField(`${at}.required_create_fields`,record.required_create_fields),assertOptionalStringArrayField(`${at}.required_create_repeatables`,record.required_create_repeatables),validateItemTypeCommandOptionPolicies(typeIndex,record.command_option_policies),validateItemTypeOptions(typeIndex,record.options)}}function validateMigrationDefinition(definition){const record=asRegistrationRecord("registerMigration definition",definition);if(record.id!==void 0&&typeof record.id!="string")throw new TypeError("registerMigration definition.id must be a string when provided");if(record.description!==void 0&&typeof record.description!="string")throw new TypeError("registerMigration definition.description must be a string when provided");if(record.status!==void 0&&typeof record.status!="string")throw new TypeError("registerMigration definition.status must be a string when provided");if(assertOptionalBooleanField("registerMigration definition.mandatory",record.mandatory),record.run!==void 0&&typeof record.run!="function")throw new TypeError("registerMigration definition.run must be a function when provided")}const PROJECT_PROFILE_DIMENSIONS=["types","statuses","fields","workflows","config","templates","packages"],PROJECT_PROFILE_ENTRY_VALIDATORS={types:(at,entry)=>{if(entry.name!==void 0&&typeof entry.name!="string")throw new TypeError(`${at}.name must be a string when provided`)},workflows:(at,entry)=>{if(typeof entry.type!="string")throw new TypeError(`${at}.type must be a string`);if(!Array.isArray(entry.allowed_transitions))throw new TypeError(`${at}.allowed_transitions must be an array`);for(const[pairIndex,pair]of entry.allowed_transitions.entries())if(!Array.isArray(pair))throw new TypeError(`${at}.allowed_transitions[${pairIndex}] must be a [from, to] array`)},templates:(at,entry)=>{if(typeof entry.name!="string")throw new TypeError(`${at}.name must be a string`);if(typeof entry.options!="object"||entry.options===null||Array.isArray(entry.options))throw new TypeError(`${at}.options must be an object`)},packages:(at,entry)=>{if(typeof entry.spec!="string")throw new TypeError(`${at}.spec must be a string`)}};function validateProjectProfileDefinition(profile){const record=asRegistrationRecord("registerProfile profile",profile);if(assertNonEmptyRegistrationString("registerProfile profile.name",record.name),assertNonEmptyRegistrationString("registerProfile profile.title",record.title),record.summary!==void 0&&typeof record.summary!="string")throw new TypeError("registerProfile profile.summary must be a string when provided");for(const dimension of PROJECT_PROFILE_DIMENSIONS){const value=record[dimension];if(value!==void 0){if(!Array.isArray(value))throw new TypeError(`registerProfile profile.${dimension} must be an array when provided`);for(const[index,entry]of value.entries()){if(typeof entry!="object"||entry===null||Array.isArray(entry))throw new TypeError(`registerProfile profile.${dimension}[${index}] must be an object`);PROJECT_PROFILE_ENTRY_VALIDATORS[dimension]?.(`registerProfile profile.${dimension}[${index}]`,entry)}}}}function applyProjectProfileDefaults(profile){profile.summary===void 0&&(profile.summary="");for(const dimension of PROJECT_PROFILE_DIMENSIONS)profile[dimension]===void 0&&(profile[dimension]=[]);return profile}export{applyProjectProfileDefaults,assertFlagValueTypeAndDefault,normalizeCommandDefinitionArguments,normalizeFlagDefinitions,resolveCommandDefinitionAction,validateFlagDefinitions,validateItemFieldDefinitions,validateItemTypeDefinitions,validateMigrationDefinition,validateProjectProfileDefinition};
 //# sourceMappingURL=registration-contracts.js.map

package/dist/core/extensions/registration-validation.d.ts

@@ -4,14 +4,14 @@
  * Provides shared validation helpers for extension registration records.
  */
 /** Require an extension registration value to be a plain object record. */
-export declare function asRegistrationRecord(name: string, value: unknown): Record<string, unknown>;
+export declare function asRegistrationRecord(name:string,value:unknown):Record<string,unknown>;
 /** Validate an optional boolean registration field. */
-export declare function assertOptionalBooleanField(name: string, value: unknown): void;
+export declare function assertOptionalBooleanField(name:string,value:unknown):void;
 /** Validate an optional non-empty string registration field. */
-export declare function assertOptionalStringField(name: string, value: unknown): void;
+export declare function assertOptionalStringField(name:string,value:unknown):void;
 /** Validate a scalar or scalar-array default accepted by extension flags. */
-export declare function assertOptionalFlagDefaultField(name: string, value: unknown): void;
+export declare function assertOptionalFlagDefaultField(name:string,value:unknown):void;
 /** Validate an optional array containing only non-empty strings. */
-export declare function assertOptionalStringArrayField(name: string, value: unknown): void;
+export declare function assertOptionalStringArrayField(name:string,value:unknown):void;
 /** Normalize an optional string array by trimming and preserving first occurrence order. */
-export declare function normalizeOptionalStringArrayField(name: string, value: unknown): string[];
+export declare function normalizeOptionalStringArrayField(name:string,value:unknown):string[];

package/dist/core/extensions/registration-values.d.ts

@@ -4,40 +4,40 @@
  * Preserves executable extension registrations while producing deterministic,
  * serializable public inventory snapshots and validates assurance providers.
  */
-import { type AssuranceMeasurementProviderDefinition, type ExtensionActivationFailureTrace, type ExtensionServiceName, type OutputRendererFormat } from "./extension-types.js";
+import { type AssuranceMeasurementProviderDefinition,type ExtensionActivationFailureTrace,type ExtensionServiceName,type OutputRendererFormat } from "./extension-types.js";
 /** Narrow a string to a renderer format accepted by the extension host. */
-export declare function isOutputRendererFormat(value: string): value is OutputRendererFormat;
+export declare function isOutputRendererFormat(value:string):value is OutputRendererFormat;
 /** Narrow a string to a service name accepted by the extension host. */
-export declare function isExtensionServiceName(value: string): value is ExtensionServiceName;
+export declare function isExtensionServiceName(value:string):value is ExtensionServiceName;
 /** Require a callable lifecycle hook before registry mutation. */
-export declare function assertHookHandler(hookName: string, hook: unknown): void;
+export declare function assertHookHandler(hookName:string,hook:unknown):void;
 /** Create a validation error carrying a hidden structured activation trace. */
-export declare function createRegistrationValidationError(message: string, trace: ExtensionActivationFailureTrace): TypeError;
+export declare function createRegistrationValidationError(message:string,trace:ExtensionActivationFailureTrace):TypeError;
 /** Recover a hidden structured activation trace from a validation error. */
-export declare function extractRegistrationValidationTrace(error: unknown): ExtensionActivationFailureTrace | undefined;
+export declare function extractRegistrationValidationTrace(error:unknown):ExtensionActivationFailureTrace | undefined;
 /** Recursively project an arbitrary registration value into serializable data. */
-export declare function sanitizeRegistrationValue(value: unknown): unknown;
+export declare function sanitizeRegistrationValue(value:unknown):unknown;
 /** Recursively clone registration containers while preserving function identities. */
-export declare function cloneRuntimeRegistrationValue(value: unknown): unknown;
+export declare function cloneRuntimeRegistrationValue(value:unknown):unknown;
 /** Create a deterministic serializable registration snapshot with functions redacted. */
-export declare function normalizeRegistrationRecord(name: string, value: unknown): Record<string, unknown>;
+export declare function normalizeRegistrationRecord(name:string,value:unknown):Record<string,unknown>;
 /** Clone a registration record without stripping executable function values. */
-export declare function normalizeRuntimeRegistrationRecord(name: string, value: unknown): Record<string, unknown>;
+export declare function normalizeRuntimeRegistrationRecord(name:string,value:unknown):Record<string,unknown>;
 /** Normalize every object in an array into deterministic serializable snapshots. */
-export declare function normalizeRegistrationRecordList<T extends object>(name: string, value: readonly T[]): T[];
+export declare function normalizeRegistrationRecordList<T extends object>(name:string,value:readonly T[]):T[];
 /** Normalize an untyped array crossing a JavaScript or JSON boundary. */
-export declare function normalizeRegistrationRecordList(name: string, value: unknown): Array<Record<string, unknown>>;
+export declare function normalizeRegistrationRecordList(name:string,value:unknown):Array<Record<string,unknown>>;
 /** Require a trimmed non-empty string at an extension authoring boundary. */
-export declare function assertNonEmptyRegistrationString(name: string, value: unknown): string;
+export declare function assertNonEmptyRegistrationString(name:string,value:unknown):string;
 /** Require an executable handler at an extension authoring boundary. */
-export declare function assertRegistrationFunction(name: string, value: unknown): void;
+export declare function assertRegistrationFunction(name:string,value:unknown):void;
 /** Canonicalize a user-facing registration name for stable routing. */
-export declare function normalizeRegistrationName(name: string): string;
+export declare function normalizeRegistrationName(name:string):string;
 /** Build the canonical command path synthesized for an importer or exporter. */
-export declare function toRegistrationCommandPath(name: string, action: "import" | "export"): string;
+export declare function toRegistrationCommandPath(name:string,action:"import" | "export"):string;
 /** Attach an executable definition as hidden immutable runtime-only state. */
 export declare function attachRuntimeDefinition<TEntry extends {
-definition: Record<string, unknown>;
-}>(entry: TEntry, runtimeDefinition: Record<string, unknown>): TEntry;
+definition:Record<string,unknown>;
+}>(entry:TEntry,runtimeDefinition:Record<string,unknown>):TEntry;
 /** Validate the closed provider schema before any activation registry mutation. */
-export declare function validateAssuranceMeasurementProviderDefinition(provider: unknown): asserts provider is AssuranceMeasurementProviderDefinition;
+export declare function validateAssuranceMeasurementProviderDefinition(provider:unknown):asserts provider is AssuranceMeasurementProviderDefinition;

package/dist/core/extensions/reserved-host-flags.d.ts

@@ -6,13 +6,13 @@
 /** Describes one host-owned flag spelling reserved from extension registration. */
 export interface ReservedExtensionHostFlag {
 /** Canonical long flag owned by the pm host. */
-flag: string;
+flag:string;
 /** Compatibility aliases that are equally host-owned. */
-aliases?: readonly string[];
+aliases?:readonly string[];
 /** Optional value label retained by the public CLI contract projection. */
-value_name?: string;
+value_name?:string;
 }
 /** Host-owned flags inherited by every subcommand, including extension commands. */
-export declare const RESERVED_EXTENSION_HOST_FLAGS: readonly ReservedExtensionHostFlag[];
+export declare const RESERVED_EXTENSION_HOST_FLAGS:readonly ReservedExtensionHostFlag[];
 /** Every canonical and aliased host flag spelling reserved from extensions. */
-export declare const RESERVED_EXTENSION_HOST_FLAG_NAMES: ReadonlySet<string>;
+export declare const RESERVED_EXTENSION_HOST_FLAG_NAMES:ReadonlySet<string>;

package/dist/core/extensions/runtime-registrations.d.ts

@@ -3,14 +3,14 @@
  *
  * Implements extension runtime contracts and governance for Runtime Registrations.
  */
-import type { ExtensionRegistrationRegistry, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionVectorStoreAdapter, RegisteredExtensionAssuranceMeasurementProvider, SchemaFieldDefinition } from "./loader.js";
+import type { ExtensionRegistrationRegistry,RegisteredExtensionSchemaMigrationDefinition,RegisteredExtensionSearchProvider,RegisteredExtensionVectorStoreAdapter,RegisteredExtensionAssuranceMeasurementProvider,SchemaFieldDefinition } from "./loader.js";
 /** Resolve the last-activated assurance provider with the requested stable id. */
-export declare function resolveRegisteredAssuranceMeasurementProvider(registrations: ExtensionRegistrationRegistry | null, providerId: string | undefined): RegisteredExtensionAssuranceMeasurementProvider | null;
+export declare function resolveRegisteredAssuranceMeasurementProvider(registrations:ExtensionRegistrationRegistry | null,providerId:string | undefined):RegisteredExtensionAssuranceMeasurementProvider | null;
 /** Implements collect registered item fields for the public runtime surface of this module. */
-export declare function collectRegisteredItemFields(registrations: ExtensionRegistrationRegistry | null): SchemaFieldDefinition[];
+export declare function collectRegisteredItemFields(registrations:ExtensionRegistrationRegistry | null):SchemaFieldDefinition[];
 /** Implements resolve registered search provider for the public runtime surface of this module. */
-export declare function resolveRegisteredSearchProvider(registrations: ExtensionRegistrationRegistry | null, configuredProvider: string | undefined): RegisteredExtensionSearchProvider | null;
+export declare function resolveRegisteredSearchProvider(registrations:ExtensionRegistrationRegistry | null,configuredProvider:string | undefined):RegisteredExtensionSearchProvider | null;
 /** Implements resolve registered vector store adapter for the public runtime surface of this module. */
-export declare function resolveRegisteredVectorStoreAdapter(registrations: ExtensionRegistrationRegistry | null, configuredAdapter: string | undefined): RegisteredExtensionVectorStoreAdapter | null;
+export declare function resolveRegisteredVectorStoreAdapter(registrations:ExtensionRegistrationRegistry | null,configuredAdapter:string | undefined):RegisteredExtensionVectorStoreAdapter | null;
 /** Implements get migration runtime definition for the public runtime surface of this module. */
-export declare function getMigrationRuntimeDefinition(migration: RegisteredExtensionSchemaMigrationDefinition): Record<string, unknown>;
+export declare function getMigrationRuntimeDefinition(migration:RegisteredExtensionSchemaMigrationDefinition):Record<string,unknown>;

package/dist/core/extensions/service-ownership.d.ts

@@ -5,4 +5,4 @@
  */
 import type { ServiceOverrideOwnership } from "./extension-types.js";
 /** Validate one service ownership declaration and return its normalized pass-through flag. */
-export declare function normalizeServiceOverrideOwnership(ownership: ServiceOverrideOwnership): boolean;
+export declare function normalizeServiceOverrideOwnership(ownership:ServiceOverrideOwnership):boolean;

package/dist/core/extensions/version-compat.d.ts

@@ -46,15 +46,15 @@ export type PmVersionBoundStatus = "absent" | "ok" | "invalid" | "unchecked" | "
 /** The structured result of evaluating one manifest version bound, consumed by the loader (to format its `extension_pm_*_version_*` warning strings) and the SDK (to build author-time compatibility findings). */
 export interface PmVersionBoundEvaluation {
 /** Which bound this evaluation describes. */
-kind: PmVersionBoundKind;
+kind:PmVersionBoundKind;
 /** The classified outcome of comparing the bound against the current version. */
-status: PmVersionBoundStatus;
+status:PmVersionBoundStatus;
 /** Whether the bound permits the extension to load (`false` only for `invalid`/`unmet`/`exceeded`). */
-allowed: boolean;
+allowed:boolean;
 /** The declared bound value, verbatim; the empty string when the bound is absent. */
-required: string;
+required:string;
 /** The current version compared against, or `null` when it could not be resolved. */
-current: string | null;
+current:string | null;
 }
 /**
  * Parse a comparable release string into numeric segments, or `null` when it is
@@ -64,7 +64,7 @@ current: string | null;
  * (so `engines.pm`-style `">=2026.5.31"` and `"v1.2.3"` both parse), then drops
  * any build/pre-release suffix and keeps the leading dotted-numeric release.
  */
-export declare function parseComparableVersion(value: string): number[] | null;
+export declare function parseComparableVersion(value:string):number[] | null;
 /**
  * Compare two comparable version strings segment by segment.
  *
@@ -73,7 +73,7 @@ export declare function parseComparableVersion(value: string): number[] | null;
  * can classify the comparison as `unchecked`). Missing trailing segments are
  * treated as `0`, so `1.2` and `1.2.0` compare equal.
  */
-export declare function compareComparableVersions(currentVersion: string, otherVersion: string): number | null;
+export declare function compareComparableVersions(currentVersion:string,otherVersion:string):number | null;
 /**
  * Evaluate a manifest `pm_min_version` inclusive lower bound against the current
  * pm version.
@@ -84,7 +84,7 @@ export declare function compareComparableVersions(currentVersion: string, otherV
  * `currentVersion` is `null` when the loader could not resolve the running CLI
  * version.
  */
-export declare function evaluatePmMinVersionBound(required: unknown, currentVersion: string | null): PmVersionBoundEvaluation;
+export declare function evaluatePmMinVersionBound(required:unknown,currentVersion:string | null):PmVersionBoundEvaluation;
 /**
  * Evaluate a manifest `pm_max_version` inclusive upper bound against the current
  * pm version.
@@ -100,4 +100,4 @@ export declare function evaluatePmMinVersionBound(required: unknown, currentVers
  * `exceeded_warn` when `exceededMode` is `warn`, so the extension still loads
  * during a controlled upgrade window); otherwise the bound is satisfied (`ok`).
  */
-export declare function evaluatePmMaxVersionBound(required: unknown, currentVersion: string | null, exceededMode: PmMaxVersionExceededMode): PmVersionBoundEvaluation;
+export declare function evaluatePmMaxVersionBound(required:unknown,currentVersion:string | null,exceededMode:PmMaxVersionExceededMode):PmVersionBoundEvaluation;

package/dist/core/fs/atomic-create.d.ts

@@ -4,4 +4,4 @@
  * failures other than EEXIST propagate; no unsafe overwrite fallback is used.
  * Publication provides atomic visibility, not fsync-backed power-loss durability.
  */
-export declare function createFileAtomic(targetPath: string, contents: string): Promise<boolean>;
+export declare function createFileAtomic(targetPath:string,contents:string):Promise<boolean>;

package/dist/core/fs/fs-utils.d.ts

@@ -1,8 +1,8 @@
 import { PmCliError } from "../shared/errors.js";
 /** Implements ensure dir for the public runtime surface of this module. */
-export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function ensureDir(dirPath:string):Promise<void>;
 /** Implements path exists for the public runtime surface of this module. */
-export declare function pathExists(targetPath: string): Promise<boolean>;
+export declare function pathExists(targetPath:string):Promise<boolean>;
 /**
  * Report whether an error means "this file is not there".
  *
@@ -12,11 +12,11 @@ export declare function pathExists(targetPath: string): Promise<boolean>;
  * otherwise a misdirected root turns a graceful default into an unclassified
  * runtime fault instead of reaching the caller's own root validation.
  */
-export declare function isFileAbsentError(error: unknown): boolean;
+export declare function isFileAbsentError(error:unknown):boolean;
 /** Report an exact missing-entry race while preserving ENOTDIR as structural corruption. */
-export declare function isFileMissingError(error: unknown): boolean;
+export declare function isFileMissingError(error:unknown):boolean;
 /** Implements read file if exists for the public runtime surface of this module. */
-export declare function readFileIfExists(targetPath: string): Promise<string | null>;
+export declare function readFileIfExists(targetPath:string):Promise<string | null>;
 /**
  * Read UTF-8 bytes after checking that the opened descriptor is a regular file.
  * Callers validate entries, ancestors and optional-file absence before opening.
@@ -27,23 +27,23 @@ export declare function readFileIfExists(targetPath: string): Promise<string | n
  * @param targetPath Contained file whose ancestors the caller already validated.
  * @param rejectionError Declared refusal when the opened entry is not a regular file.
  */
-export declare function readRegularFile(targetPath: string, rejectionError: Error): Promise<string>;
+export declare function readRegularFile(targetPath:string,rejectionError:Error):Promise<string>;
 /**
  * Refuse unsafe preview storage without exposing filesystem paths. Entry and
  * opened-descriptor checks share this usage error so SDK callers can repair
  * tracker configuration rather than treating a preserved safety boundary as
  * an unexpected runtime fault. Native filesystem failures retain their codes.
  */
-export declare function transactionPreviewNonRegularFileError(): PmCliError;
+export declare function transactionPreviewNonRegularFileError():PmCliError;
 /**
  * Replace a UTF-8 file through a sibling temporary file and atomic rename.
  * Parent directories are created by default. Background consumers can disable
  * that behavior to respect removal of their storage while work is in flight;
  * missing parents then produce the native filesystem error without recreation.
  */
-export declare function writeFileAtomic(targetPath: string, contents: string, options?: {
-createParentDirectories?: boolean;
-}): Promise<void>;
+export declare function writeFileAtomic(targetPath:string,contents:string,options?:{
+createParentDirectories?:boolean;
+}):Promise<void>;
 /**
  * Append a single newline-terminated line to a file, opened with `O_APPEND`.
  *
@@ -63,6 +63,6 @@ createParentDirectories?: boolean;
  * serialized regardless. Callers writing large records concurrently from
  * multiple processes must hold an equivalent lock.
  */
-export declare function appendLineAtomic(targetPath: string, line: string): Promise<void>;
+export declare function appendLineAtomic(targetPath:string,line:string):Promise<void>;
 /** Implements remove file if exists for the public runtime surface of this module. */
-export declare function removeFileIfExists(targetPath: string): Promise<void>;
+export declare function removeFileIfExists(targetPath:string):Promise<void>;

package/dist/core/fs/host-environment-errors.d.ts

@@ -2,26 +2,26 @@ import { PmCliError } from "../shared/errors.js";
 /** Optional stable codes used by an existing SDK surface for each fault class. */
 export interface HostEnvironmentFaultCodeOverrides {
 /** Code used for quota and storage exhaustion. */
-capacity?: string;
+capacity?:string;
 /** Code used for access policy and read-only filesystems. */
-permission?: string;
+permission?:string;
 /** Code used for file-descriptor and memory exhaustion. */
-resource?: string;
+resource?:string;
 }
 /** Context and compatibility controls for a host-environment boundary. */
 export interface HostEnvironmentBoundaryOptions {
 /** Existing surface-specific codes that must remain compatible. */
-codes?: HostEnvironmentFaultCodeOverrides;
+codes?:HostEnvironmentFaultCodeOverrides;
 /** Human explanation of why the operation needs host resources. */
-why?: string;
+why?:string;
 /** Additional ordered recovery guidance. */
-nextSteps?: readonly string[];
+nextSteps?:readonly string[];
 /** Copyable retry command when one is safe. */
-suggestedRetry?: string;
+suggestedRetry?:string;
 }
 /** Return a declared host errno only when it represents recoverable environment state. */
-export declare function classifyHostEnvironmentFault(error: unknown): string | null;
+export declare function classifyHostEnvironmentFault(error:unknown):string | null;
 /** Translate one known host fault into a stable path-redacted SDK refusal. */
-export declare function translateHostEnvironmentFault(error: unknown, operation: string, options?: HostEnvironmentBoundaryOptions): PmCliError | null;
+export declare function translateHostEnvironmentFault(error:unknown,operation:string,options?:HostEnvironmentBoundaryOptions):PmCliError | null;
 /** Run one SDK filesystem stage and translate only declared host faults. */
-export declare function withHostEnvironmentBoundary<T>(operation: string, run: () => Promise<T>, options?: HostEnvironmentBoundaryOptions): Promise<T>;
+export declare function withHostEnvironmentBoundary<T>(operation:string,run:() => Promise<T>,options?:HostEnvironmentBoundaryOptions):Promise<T>;

package/dist/core/fs/path-utils.d.ts

@@ -1,2 +1,2 @@
 /** Implements check whether path within directory for the public runtime surface of this module. */
-export declare function isPathWithinDirectory(directory: string, targetPath: string): boolean;
+export declare function isPathWithinDirectory(directory:string,targetPath:string):boolean;

package/dist/core/governance/content-fields.d.ts

@@ -14,67 +14,67 @@
 /** The content fields an item can carry context in. */
 export type ContentField = "notes" | "learnings" | "files" | "docs" | "tests" | "comments" | "deps" | "body" | "linked_command";
 /** Stable rendering / iteration order for content fields. */
-export declare const CONTENT_FIELD_ORDER: readonly ContentField[];
+export declare const CONTENT_FIELD_ORDER:readonly ContentField[];
 /** Minimal structural shape needed: the collection arrays + optional body. */
 export interface ContentFieldItem {
 /** Value that configures or reports notes for this contract. */
-notes?: unknown[];
+notes?:unknown[];
 /** Value that configures or reports learnings for this contract. */
-learnings?: unknown[];
+learnings?:unknown[];
 /** Value that configures or reports files for this contract. */
-files?: unknown[];
+files?:unknown[];
 /** Value that configures or reports docs for this contract. */
-docs?: unknown[];
+docs?:unknown[];
 /** Value that configures or reports tests for this contract. */
-tests?: unknown[];
+tests?:unknown[];
 /** Value that configures or reports comments for this contract. */
-comments?: unknown[];
+comments?:unknown[];
 /** Value that configures or reports dependencies for this contract. */
-dependencies?: unknown[];
+dependencies?:unknown[];
 /** Value that configures or reports body for this contract. */
-body?: string;
-[key: string]: unknown;
+body?:string;
+[key:string]:unknown;
 }
 /** True when the given content field carries context on this item. - collection fields: `Array.isArray && length > 0` - "deps": maps to the `dependencies` array - "body": `typeof body === "string" && body.trim().length > 0` - "linked_command": `tests` array has at least one entry with a non-empty string `command` */
-export declare function isContentFieldPresent(item: ContentFieldItem, field: ContentField): boolean;
+export declare function isContentFieldPresent(item:ContentFieldItem,field:ContentField):boolean;
 /** Per-field selection: 'present' requires the field populated, 'absent' requires it empty. */
 export type ContentFieldSelection = "present" | "absent";
 /** Map of content fields to a present/absent requirement. */
-export type ContentFieldFilters = Partial<Record<ContentField, ContentFieldSelection>>;
+export type ContentFieldFilters = Partial<Record<ContentField,ContentFieldSelection>>;
 /** True when at least one content-field selection is requested. */
-export declare function hasContentFieldFilter(filters: ContentFieldFilters): boolean;
+export declare function hasContentFieldFilter(filters:ContentFieldFilters):boolean;
 /**
  * Does a single item satisfy the requested content-field filters?
  *
  * AND semantics across all requested fields: each requested field must match
  * its present/absent requirement. When no filter is requested the item passes.
  */
-export declare function itemMatchesContentFilters(item: ContentFieldItem, filters: ContentFieldFilters): boolean;
+export declare function itemMatchesContentFilters(item:ContentFieldItem,filters:ContentFieldFilters):boolean;
 /** Filter a list of items by the requested content-field selections. */
-export declare function filterByContentFields<T extends ContentFieldItem>(items: readonly T[], filters: ContentFieldFilters): T[];
+export declare function filterByContentFields<T extends ContentFieldItem>(items:readonly T[],filters:ContentFieldFilters):T[];
 /** Whether a content-field filter set requires the heavy collections to be loaded. True when any non-body field is requested (collections + tests' linked command all live in the heavy item-metadata arrays). */
-export declare function contentFiltersNeedCollections(filters: ContentFieldFilters): boolean;
+export declare function contentFiltersNeedCollections(filters:ContentFieldFilters):boolean;
 /** Whether a content-field filter set requires the item body to be loaded. */
-export declare function contentFiltersNeedBody(filters: ContentFieldFilters): boolean;
+export declare function contentFiltersNeedBody(filters:ContentFieldFilters):boolean;
 /** Utilization of a single content field: present vs total, with a rounded percent. */
 export interface ContentFieldUtilization {
 /** Value that configures or reports present for this contract. */
-present: number;
+present:number;
 /** Value that configures or reports total for this contract. */
-total: number;
+total:number;
 /** present/total * 100, rounded to one decimal; 100 when total is 0. */
-percent: number;
+percent:number;
 }
 /** Per-field utilization report for pm stats --field-utilization. */
 export interface ContentFieldUtilizationReport {
 /** Value that configures or reports total items for this contract. */
-total_items: number;
+total_items:number;
 /** Utilization keyed by content field (includes body and linked_command). */
-fields: Record<ContentField, ContentFieldUtilization>;
+fields:Record<ContentField,ContentFieldUtilization>;
 /** Convenience alias mirroring GH-241: identical to `fields.body`. */
-body_populated: ContentFieldUtilization;
+body_populated:ContentFieldUtilization;
 /** Items with an empty body; `present` counts the empty-bodied items. */
-empty_body: ContentFieldUtilization;
+empty_body:ContentFieldUtilization;
 }
 /** Compute content-field utilization across a list of items. For each field we report how many items populate it out of the total, plus a rounded percentage. Convenience `body_populated`/`empty_body` aliases mirror GH-241. */
-export declare function computeContentFieldUtilization(items: readonly ContentFieldItem[]): ContentFieldUtilizationReport;
+export declare function computeContentFieldUtilization(items:readonly ContentFieldItem[]):ContentFieldUtilizationReport;

package/dist/core/governance/issue-codes.d.ts

@@ -14,38 +14,38 @@
 /** Minimal structural shape needed to detect duplicate issue codes. */
 export interface IssueCodeItem {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports title for this contract. */
-title?: string | null;
+title?:string | null;
 /** The id of this item's parent, when it is a child in a hierarchy. Used to suppress false positives where a child intentionally reuses its parent's code prefix (the `PARENT` + `PARENT-T0n` task-breakdown convention, GH-275): when an item's parent is another item in the same code group, the shared code is by design and the child does not constitute a collision. */
-parent?: string | null;
+parent?:string | null;
 /** The id of the canonical item this one was closed as a duplicate of, when set. A closed-as-duplicate item has already been adjudicated, so it is excluded from collision detection entirely (GH-278) — re-flagging a resolved duplicate is permanent noise that erodes trust in `validate`. */
-duplicate_of?: string | null;
+duplicate_of?:string | null;
 /** Optional body evidence used to disambiguate mixed-case prose compounds. */
-body?: string | null;
+body?:string | null;
 /** Typed provenance links; only derivations targeting this same code group exempt a follow-up. */
-dependencies?: readonly {
-id: string;
-kind: string;
+dependencies?:readonly {
+id:string;
+kind:string;
 }[] | null;
 }
 /** Explicit classifier inputs for repository-specific issue-code formats. */
 export interface IssueCodeDetectionOptions {
 /** Prefixes configured by the repository, compared case-insensitively. */
-configuredPrefixes?: readonly string[];
+configuredPrefixes?:readonly string[];
 /** Item body used only for explicit code markers or backtick references. */
-evidenceText?: string | null;
+evidenceText?:string | null;
 }
 /** A logical issue code shared by two or more items. */
 export interface DuplicateIssueCode {
 /** The canonical (normalized, upper-case) issue code, e.g. `ISSUE-004`. */
-code: string;
+code:string;
 /** How many items carry this code. */
-count: number;
+count:number;
 /** The ids of the items carrying this code, sorted ascending. */
-ids: string[];
+ids:string[];
 /** The titles of the items carrying this code, in the same order as `ids`. */
-titles: string[];
+titles:string[];
 }
 /**
  * Extract the leading logical issue code from a title, or `null` when the title
@@ -56,7 +56,7 @@ titles: string[];
  * Accepts unknown-ish input defensively (exported helper SDK consumers may call
  * from untyped JS): a non-string or empty title resolves to `null`.
  */
-export declare function extractIssueCode(title: string | null | undefined, options?: IssueCodeDetectionOptions): string | null;
+export declare function extractIssueCode(title:string | null | undefined,options?:IssueCodeDetectionOptions):string | null;
 /**
  * Find logical issue codes used by 2+ items. Any item whose title begins with a
  * conventional issue code contributes; codes used by a single item are not
@@ -85,4 +85,4 @@ export declare function extractIssueCode(title: string | null | undefined, optio
  * given (id) is used; duplicate ids (should not occur for a valid corpus) are
  * de-duplicated so an item never inflates its own code's count.
  */
-export declare function findDuplicateIssueCodes(items: readonly IssueCodeItem[], options?: Omit<IssueCodeDetectionOptions, "evidenceText">): DuplicateIssueCode[];
+export declare function findDuplicateIssueCodes(items:readonly IssueCodeItem[],options?:Omit<IssueCodeDetectionOptions,"evidenceText">):DuplicateIssueCode[];