@unbrained/pm-cli 2026.9.6 → 2026.9.8

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

@@ -1,1475 +1,7 @@
-/**
- * @module core/item/item-format
- *
- * Defines item parsing, formatting, and lifecycle helpers for Item Format.
- */
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="48df511d-df81-56f7-bb1d-f10230b43cfa")}catch(e2){}})();import{encode as encodeToon}from"@toon-format/toon";import{isDeepStrictEqual}from"node:util";import{CONFIDENCE_TEXT_VALUES,ISSUE_SEVERITY_VALUES,PLAN_STEP_STATUS_VALUES,RECURRENCE_FREQUENCY_VALUES,RECURRENCE_WEEKDAY_VALUES,STATUS_VALUES,weekdayOrderIndex}from"../../types/index.js";import{coerceRuntimeFieldValue}from"../schema/runtime-field-values.js";import{resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry}from"../schema/runtime-schema.js";import{BASELINE_ITEM_FORMAT_VERSION,normalizeItemFormatVersion}from"./item-format-version.js";import{normalizeStatusInput}from"./status.js";import{decodeToonItemContent}from"./toon-decode.js";import{EXIT_CODE,ITEM_METADATA_KEY_ORDER}from"../shared/constants.js";import{findFirstMergeConflictMarker}from"../shared/conflict-markers.js";import{PmCliError}from"../shared/errors.js";import{orderObject}from"../shared/serialization.js";import{compareTimestampStrings,isTimestampLiteral}from"../shared/time.js";import{coerceFiniteNumber}from"../shared/primitives.js";const LINKED_TEST_PM_CONTEXT_MODE_VALUES=new Set(["schema","tracker","auto"]);const LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES=new Set(["source","isolated","snapshot"]);const LINKED_TEST_TRUST_REASON_VALUES=new Set(["legacy","local_mutation","local_source_ref","acknowledged","invalid_provenance","foreign_source_ref"]);const ITEM_TEST_RUN_STATUS_VALUES=new Set(["passed","failed","stopped","canceled"]);const PLAN_STEP_STATUS_SET=new Set(PLAN_STEP_STATUS_VALUES);function normalizePathValue(value){return value.replaceAll("\\","/")}function firstNonZeroComparison(comparisons){for(const comparison of comparisons){if(comparison!==0){return comparison}}return 0}function deleteUndefinedFields(record){for(const[key,value]of Object.entries(record)){if(value===void 0){delete record[key]}}}const REQUIRED_STRING_FIELDS=["id","title","description","created_at","updated_at"];const STATIC_ITEM_METADATA_FIELD_SET=new Set(ITEM_METADATA_KEY_ORDER);function resolveRuntimeSchemaValidationContext(options){if(!options?.schema){return void 0}return{statusRegistry:resolveRuntimeStatusRegistry(options.schema),fieldRegistry:resolveRuntimeFieldRegistry(options.schema),unknownFieldPolicy:options.schema.unknown_field_policy??"allow",extensionFieldNames:new Set(options.extensionFieldNames??[]),onWarning:options.onWarning}}function runtimeFieldRequiredForType(definition,typeName){if(!definition.required){return false}if(definition.required_types.length===0){return true}return definition.required_types.map(value=>value.toLowerCase()).includes(typeName.trim().toLowerCase())}function validationError(message){const field=message.match(/^([a-z_][\w.]*)\s/u)?.[1];throw new PmCliError(`Invalid item metadata: ${message}`,EXIT_CODE.GENERIC_FAILURE,{code:"item_document_invalid",reason:message.includes("required")?"missing_required_field":"schema_validation_error",...field?{field}:{},required:"Provide an item document whose metadata satisfies the active runtime schema.",why:message})}function documentSyntaxError(format,message){throw new PmCliError(message,EXIT_CODE.GENERIC_FAILURE,{code:"item_document_invalid",reason:"syntax_error",format,required:`Provide a syntactically valid ${format==="toon"?"TOON":"JSON Markdown"} item document.`,why:"The document could not be decoded far enough to validate item metadata."})}function buildKnownItemMetadataKeys(runtimeContext){const knownKeys=new Set(STATIC_ITEM_METADATA_FIELD_SET);for(const definition of runtimeContext.fieldRegistry?.definitions??[]){knownKeys.add(definition.metadata_key)}for(const fieldName of runtimeContext.extensionFieldNames){knownKeys.add(fieldName)}return knownKeys}function assertItemMetadataCondition(condition,message){if(!condition){validationError(message)}}function requireItemMetadataRecord(value,message){if(typeof value!=="object"||value===null||Array.isArray(value)){validationError(message)}return value}function assertTimestampField(record,fieldName){const rawValue=record[fieldName];assertItemMetadataCondition(typeof rawValue==="string",`${fieldName} must be a string`);const timestamp=rawValue;assertItemMetadataCondition(isTimestampLiteral(timestamp),`${fieldName} must be a valid ISO timestamp`)}function assertPositiveIntegerField(record,fieldName,messagePrefix){const value=record[fieldName];if(value===void 0){return}assertItemMetadataCondition(typeof value==="number"&&Number.isInteger(value)&&value>=1,`${messagePrefix} must be an integer >= 1`)}function assertOptionalTimestampString(record,fieldName,messagePrefix){const value=record[fieldName];if(value===void 0){return}assertItemMetadataCondition(typeof value==="string",`${messagePrefix} must be a string`);assertItemMetadataCondition(isTimestampLiteral(value),`${messagePrefix} must be a valid ISO timestamp`)}function assertRecurrenceWeekdays(value){if(value===void 0){return}assertItemMetadataCondition(Array.isArray(value),"event.recurrence.by_weekday must be an array");for(const weekday of value){assertItemMetadataCondition(typeof weekday==="string","event.recurrence.by_weekday entries must be strings");const normalizedWeekday=weekday.trim().toLowerCase();assertItemMetadataCondition(RECURRENCE_WEEKDAY_VALUES.includes(normalizedWeekday),`event.recurrence.by_weekday entries must be one of: ${RECURRENCE_WEEKDAY_VALUES.join(", ")}`)}}function assertRecurrenceMonthDays(value){if(value===void 0){return}assertItemMetadataCondition(Array.isArray(value),"event.recurrence.by_month_day must be an array");for(const day of value){assertItemMetadataCondition(typeof day==="number"&&Number.isInteger(day)&&day>=1&&day<=31,"event.recurrence.by_month_day entries must be integers 1..31")}}function assertRecurrenceExdates(value){if(value===void 0){return}assertItemMetadataCondition(Array.isArray(value),"event.recurrence.exdates must be an array");for(const exdate of value){assertItemMetadataCondition(typeof exdate==="string","event.recurrence.exdates entries must be strings");assertItemMetadataCondition(isTimestampLiteral(exdate),"event.recurrence.exdates entries must be valid ISO timestamps")}}function assertValidRecurrenceRule(recurrence){const recurrenceRecord=requireItemMetadataRecord(recurrence,"event.recurrence must be an object");assertItemMetadataCondition(typeof recurrenceRecord.freq==="string","event.recurrence.freq must be a string");const frequency=recurrenceRecord.freq.trim().toLowerCase();assertItemMetadataCondition(RECURRENCE_FREQUENCY_VALUES.includes(frequency),`event.recurrence.freq must be one of: ${RECURRENCE_FREQUENCY_VALUES.join(", ")}`);assertPositiveIntegerField(recurrenceRecord,"interval","event.recurrence.interval");assertPositiveIntegerField(recurrenceRecord,"count","event.recurrence.count");assertOptionalTimestampString(recurrenceRecord,"until","event.recurrence.until");assertRecurrenceWeekdays(recurrenceRecord.by_weekday);assertRecurrenceMonthDays(recurrenceRecord.by_month_day);assertRecurrenceExdates(recurrenceRecord.exdates)}function assertRequiredItemMetadataFields(record){for(const fieldName of REQUIRED_STRING_FIELDS){assertItemMetadataCondition(typeof record[fieldName]==="string",`${fieldName} is required and must be a string`)}const itemType=record.type;assertItemMetadataCondition(typeof itemType==="string"&&itemType.trim().length>0,"type must be a non-empty string");const formatVersion=record.pm_format_version;if(formatVersion!==void 0){assertItemMetadataCondition(typeof formatVersion==="number"&&Number.isInteger(formatVersion)&&formatVersion>=BASELINE_ITEM_FORMAT_VERSION,`pm_format_version must be an integer >= ${BASELINE_ITEM_FORMAT_VERSION}`)}return itemType}function assertStatusItemMetadataField(record,runtimeContext){const status=record.status;assertItemMetadataCondition(typeof status==="string"&&status.trim().length>0,"status must be a non-empty string");const statusRegistry=runtimeContext?.statusRegistry;const normalizedStatus=normalizeStatusInput(status,statusRegistry);const statusDomain=statusRegistry?statusRegistry.definitions.map(definition=>definition.id):[...STATUS_VALUES];assertItemMetadataCondition(normalizedStatus!==void 0,`status must be one of: ${statusDomain.join(", ")}`)}function assertPriorityAndTags(record){const priority=record.priority;assertItemMetadataCondition(typeof priority==="number"&&Number.isInteger(priority)&&[0,1,2,3,4].includes(priority),"priority must be an integer 0..4");const tags=record.tags;assertItemMetadataCondition(Array.isArray(tags),"tags must be an array");for(const tag of tags){assertItemMetadataCondition(typeof tag==="string","tags entries must be strings")}}function assertConfidenceItemMetadataField(record){const confidence=record.confidence;if(confidence===void 0){return}if(typeof confidence==="number"){assertItemMetadataCondition(Number.isInteger(confidence)&&confidence>=0&&confidence<=100,"confidence number value must be an integer 0..100");return}if(typeof confidence==="string"){const normalizedConfidence=confidence.trim().toLowerCase();const isKnownTextConfidence=normalizedConfidence==="med"||CONFIDENCE_TEXT_VALUES.includes(normalizedConfidence);assertItemMetadataCondition(isKnownTextConfidence,`confidence string value must be one of: ${[...CONFIDENCE_TEXT_VALUES,"med"].join(", ")}`);return}assertItemMetadataCondition(false,"confidence must be a number or string")}function assertSeverityItemMetadataField(record){const severity=record.severity;if(severity===void 0){return}if(typeof severity!=="string"){validationError("severity must be a string")}const normalizedSeverity=severity.trim().toLowerCase();const isKnownSeverity=normalizedSeverity==="med"||ISSUE_SEVERITY_VALUES.includes(normalizedSeverity);assertItemMetadataCondition(isKnownSeverity,`severity value must be one of: ${[...ISSUE_SEVERITY_VALUES,"med"].join(", ")}`)}function assertRegressionItemMetadataField(record){if(record.regression!==void 0&&typeof record.regression!=="boolean"){validationError("regression must be a boolean")}}function assertReminderEntries(record){const reminders=record.reminders;if(reminders===void 0){return}assertItemMetadataCondition(Array.isArray(reminders),"reminders must be an array");for(const reminder of reminders){const reminderRecord=requireItemMetadataRecord(reminder,"reminders entries must be objects");assertItemMetadataCondition(typeof reminderRecord.at==="string","reminder.at must be a string");assertItemMetadataCondition(isTimestampLiteral(reminderRecord.at),"reminder.at must be a valid ISO timestamp");assertItemMetadataCondition(typeof reminderRecord.text==="string","reminder.text must be a string");assertItemMetadataCondition(reminderRecord.text.trim().length>0,"reminder.text must not be empty")}}function assertEventStringFields(eventRecord){for(const stringField of["title","description","location","timezone"]){if(eventRecord[stringField]!==void 0){assertItemMetadataCondition(typeof eventRecord[stringField]==="string",`event.${stringField} must be a string`);assertItemMetadataCondition(eventRecord[stringField].trim().length>0,`event.${stringField} must not be empty`)}}}function assertEventRecurrence(eventRecord){if(eventRecord.recurrence===void 0){return}assertValidRecurrenceRule(eventRecord.recurrence);if(eventRecord.recurrence.until!==void 0){assertItemMetadataCondition(compareTimestampStrings(eventRecord.recurrence.until,eventRecord.start_at)>=0,"event.recurrence.until must be at or after event.start_at")}}function assertCalendarEventEntry(event){const eventRecord=requireItemMetadataRecord(event,"events entries must be objects");assertItemMetadataCondition(typeof eventRecord.start_at==="string","event.start_at must be a string");assertItemMetadataCondition(isTimestampLiteral(eventRecord.start_at),"event.start_at must be a valid ISO timestamp");if(eventRecord.end_at!==void 0){assertItemMetadataCondition(typeof eventRecord.end_at==="string","event.end_at must be a string");assertItemMetadataCondition(isTimestampLiteral(eventRecord.end_at),"event.end_at must be a valid ISO timestamp");assertItemMetadataCondition(compareTimestampStrings(eventRecord.end_at,eventRecord.start_at)>0,"event.end_at must be after event.start_at")}assertEventStringFields(eventRecord);if(eventRecord.all_day!==void 0){assertItemMetadataCondition(typeof eventRecord.all_day==="boolean","event.all_day must be a boolean")}assertEventRecurrence(eventRecord)}function assertCalendarEvents(record){const events=record.events;if(events===void 0){return}assertItemMetadataCondition(Array.isArray(events),"events must be an array");for(const event of events){assertCalendarEventEntry(event)}}function assertOptionalStringFields(record){for(const fieldName of["source_type","source_owner","design","external_ref"]){const value=record[fieldName];if(value!==void 0){assertItemMetadataCondition(typeof value==="string",`${fieldName} must be a string`)}}}function assertTypeOptionsField(record){const typeOptions=record.type_options;if(typeOptions===void 0){return}const typeOptionsRecord=requireItemMetadataRecord(typeOptions,"type_options must be an object");for(const[optionKey,optionValue]of Object.entries(typeOptionsRecord)){assertItemMetadataCondition(optionKey.trim().length>0,"type_options keys must be non-empty");assertItemMetadataCondition(typeof optionValue==="string","type_options values must be strings");const optionText=optionValue;assertItemMetadataCondition(optionText.trim().length>0,"type_options values must be non-empty strings")}}function coerceRuntimeItemMetadataFields(record,itemType,runtimeContext){if(!runtimeContext?.fieldRegistry){return}for(const definition of runtimeContext.fieldRegistry.definitions){const fieldValue=record[definition.metadata_key];if(fieldValue===void 0){if(runtimeFieldRequiredForType(definition,itemType)){validationError(`missing required schema field: ${definition.metadata_key}`)}continue}try{record[definition.metadata_key]=coerceRuntimeFieldValue(definition,fieldValue,`metadata field "${definition.metadata_key}"`)}catch(error){validationError(String(error?.message).replace(/^Invalid\s+/u,""))}}}function assertRuntimeUnknownItemMetadataFields(record,runtimeContext){if(!runtimeContext||runtimeContext.unknownFieldPolicy==="allow"){return}const knownKeys=buildKnownItemMetadataKeys(runtimeContext);const unknownKeys=Object.keys(record).filter(key=>!knownKeys.has(key)).sort((left,right)=>left.localeCompare(right));if(unknownKeys.length===0){return}if(runtimeContext.unknownFieldPolicy==="reject"){validationError(`unknown schema fields are not allowed: ${unknownKeys.join(", ")}`)}else{runtimeContext.onWarning?.(`item_unknown_schema_fields:${unknownKeys.join(",")}`)}}function assertValidItemMetadata(itemMetadata,runtimeContext){const record=requireItemMetadataRecord(itemMetadata,"item metadata must be an object");const itemType=assertRequiredItemMetadataFields(record);assertStatusItemMetadataField(record,runtimeContext);assertPriorityAndTags(record);assertConfidenceItemMetadataField(record);assertSeverityItemMetadataField(record);assertRegressionItemMetadataField(record);assertTimestampField(record,"created_at");assertTimestampField(record,"updated_at");if(record.deadline!==void 0){assertTimestampField(record,"deadline")}assertReminderEntries(record);assertCalendarEvents(record);assertOptionalTimestampString(record,"closed_at","closed_at");assertOptionalTimestampString(record,"completed_at","completed_at");assertOptionalStringFields(record);assertTypeOptionsField(record);coerceRuntimeItemMetadataFields(record,itemType,runtimeContext);assertRuntimeUnknownItemMetadataFields(record,runtimeContext)}function sortDependencies(values){if(!values||values.length===0)return void 0;return[...values].map(value=>({id:value.id.trim(),kind:value.kind,created_at:value.created_at,author:value.author?.trim()||void 0,source_kind:value.source_kind?.trim()||void 0,author_source:value.author_source})).sort((a,b)=>{const byCreated=compareTimestampStrings(a.created_at,b.created_at);if(byCreated!==0)return byCreated;const byId=a.id.localeCompare(b.id);if(byId!==0)return byId;const byKind=a.kind.localeCompare(b.kind);if(byKind!==0)return byKind;return(a.source_kind??"").localeCompare(b.source_kind??"")})}function sortLogValues(values){if(!values||values.length===0)return void 0;return[...values].sort((a,b)=>{const byCreated=compareTimestampStrings(a.created_at,b.created_at);if(byCreated!==0)return byCreated;const byText=a.text.localeCompare(b.text);if(byText!==0)return byText;return a.author.localeCompare(b.author)})}function sortReminders(values){if(!values||values.length===0)return void 0;const normalized=[...values].map(value=>({at:value.at,text:value.text.trim()})).filter(value=>value.text.length>0).sort((a,b)=>{const byAt=compareTimestampStrings(a.at,b.at);if(byAt!==0)return byAt;return a.text.localeCompare(b.text)});return normalized.length===0?void 0:normalized}function normalizeRecurrenceRule(value){if(!value){return void 0}const normalizedFrequency=value.freq.trim().toLowerCase();if(!RECURRENCE_FREQUENCY_VALUES.includes(normalizedFrequency)){return void 0}const byWeekday=Array.from(new Set((value.by_weekday??[]).map(weekday=>weekday.trim().toLowerCase()).filter(weekday=>RECURRENCE_WEEKDAY_VALUES.includes(weekday)))).sort((a,b)=>weekdayOrderIndex(a)-weekdayOrderIndex(b));const byMonthDay=Array.from(new Set((value.by_month_day??[]).filter(day=>Number.isInteger(day)&&day>=1&&day<=31).map(day=>day))).sort((a,b)=>a-b);const exdates=Array.from(new Set((value.exdates??[]).map(timestamp=>timestamp.trim()).filter(timestamp=>isTimestampLiteral(timestamp)))).sort((a,b)=>compareTimestampStrings(a,b));const normalized={freq:normalizedFrequency,interval:value.interval!==void 0&&value.interval>1?value.interval:void 0,count:value.count,until:value.until?.trim()||void 0,by_weekday:byWeekday.length>0?byWeekday:void 0,by_month_day:byMonthDay.length>0?byMonthDay:void 0,exdates:exdates.length>0?exdates:void 0};for(const[key,fieldValue]of Object.entries(normalized)){if(fieldValue===void 0){delete normalized[key]}}return normalized}function sortEvents(values){if(!Array.isArray(values)||values.length===0){return void 0}const normalized=[...values].map(normalizeCalendarEvent).sort(compareCalendarEvents);return normalized}function normalizeCalendarEvent(value){const event={start_at:value.start_at,end_at:value.end_at||void 0,title:value.title?.trim()||void 0,description:value.description?.trim()||void 0,location:value.location?.trim()||void 0,all_day:value.all_day,timezone:value.timezone?.trim()||void 0,recurrence:normalizeRecurrenceRule(value.recurrence)};deleteUndefinedFields(event);return event}function compareCalendarEvents(a,b){return firstNonZeroComparison([compareTimestampStrings(a.start_at,b.start_at),(a.end_at??"").localeCompare(b.end_at??""),(a.title??"").localeCompare(b.title??""),Number(Boolean(a.all_day))-Number(Boolean(b.all_day)),(a.timezone??"").localeCompare(b.timezone??""),(a.location??"").localeCompare(b.location??""),(a.description??"").localeCompare(b.description??""),JSON.stringify(a.recurrence??{}).localeCompare(JSON.stringify(b.recurrence??{}))])}function normalizeFiles(values){if(!values||values.length===0)return void 0;return values.map(value=>({path:normalizePathValue(value.path),scope:value.scope,note:value.note?.trim()||void 0}))}function normalizeTestRunSummaries(values){if(!values||values.length===0)return void 0;const normalized=values.map(normalizeTestRunSummary).filter(value=>value.run_id.length>0&&value.started_at.length>0&&value.finished_at.length>0&&value.recorded_at.length>0).sort((a,b)=>firstNonZeroComparison([compareTimestampStrings(a.recorded_at,b.recorded_at),a.run_id.localeCompare(b.run_id),a.kind.localeCompare(b.kind)]));return normalized.length>0?normalized:void 0}function normalizeNonNegativeInteger(value){return typeof value==="number"&&Number.isFinite(value)&&value>=0?Math.floor(value):void 0}function normalizePositiveInteger(value){return typeof value==="number"&&Number.isFinite(value)&&value>=1?Math.floor(value):void 0}function stringOrEmpty(value){return typeof value==="string"?value:""}function normalizeTestRunMeasurements(value){if(!Array.isArray(value))return void 0;const normalized=value.filter(measurement=>measurement!==null&&typeof measurement==="object"&&typeof measurement.name==="string"&&measurement.name.trim().length>0&&typeof measurement.value==="number"&&Number.isFinite(measurement.value)&&typeof measurement.recorded_at==="string"&&measurement.recorded_at.trim().length>0).map(measurement=>({name:measurement.name.trim(),value:measurement.value,unit:typeof measurement.unit==="string"?measurement.unit.trim()||void 0:void 0,threshold:typeof measurement.threshold==="number"&&Number.isFinite(measurement.threshold)?measurement.threshold:void 0,recorded_at:measurement.recorded_at.trim()}));const deduplicated=[...new Map(normalized.map(measurement=>[measurement.name,measurement])).values()].sort((left,right)=>left.name.localeCompare(right.name)).slice(0,32);return deduplicated.length>0?deduplicated:void 0}function normalizeTestRunEnum(value,allowedValues){return typeof value==="string"&&allowedValues.has(value)?value:void 0}function normalizeTestRunExecutions(values){if(!Array.isArray(values))return void 0;const executions=values.filter(execution=>execution&&typeof execution.command==="string"&&execution.command.trim().length>0).slice(0,32).map(execution=>({command:execution.command.trim(),requested_pm_context_mode:normalizeTestRunEnum(execution.requested_pm_context_mode,LINKED_TEST_PM_CONTEXT_MODE_VALUES),pm_context_mode:normalizeTestRunEnum(execution.pm_context_mode,LINKED_TEST_PM_CONTEXT_MODE_VALUES),workspace_context_mode:normalizeTestRunEnum(execution.workspace_context_mode,LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES),trust_reason:normalizeTestRunEnum(execution.trust_reason,LINKED_TEST_TRUST_REASON_VALUES)}));return executions.length>0?executions:void 0}function normalizeTestRunSummary(value){const runId=typeof value.run_id==="string"?value.run_id.trim():"";const kind=value.kind==="test"||value.kind==="test-all"?value.kind:"test";const status=ITEM_TEST_RUN_STATUS_VALUES.has(value.status)?value.status:"failed";const summary={run_id:runId,kind,status,started_at:stringOrEmpty(value.started_at),finished_at:stringOrEmpty(value.finished_at),recorded_at:stringOrEmpty(value.recorded_at),attempt:normalizePositiveInteger(value.attempt),resumed_from:value.resumed_from?.trim()||void 0,passed:normalizeNonNegativeInteger(value.passed)??0,failed:normalizeNonNegativeInteger(value.failed)??0,skipped:normalizeNonNegativeInteger(value.skipped)??0,items:normalizeNonNegativeInteger(value.items),linked_tests:normalizeNonNegativeInteger(value.linked_tests),fail_on_skipped_triggered:value.fail_on_skipped_triggered===true?true:void 0,measurements:normalizeTestRunMeasurements(value.measurements),executions:normalizeTestRunExecutions(value.executions)};deleteUndefinedFields(summary);return summary}function sortTests(values){if(!Array.isArray(values)||values.length===0)return void 0;return values.map(normalizeLinkedTest)}function normalizeTrimmedStringList(value){if(!Array.isArray(value)){return void 0}const normalized=[...new Set(value.filter(entry=>typeof entry==="string").map(entry=>entry.trim()).filter(entry=>entry.length>0))].sort((a,b)=>a.localeCompare(b));return normalized.length>0?normalized:void 0}function isPlainObjectRecord(value){if(!value||typeof value!=="object"||Array.isArray(value)){return false}const prototype=Object.getPrototypeOf(value);return prototype===Object.prototype||prototype===null}function isUnsafeObjectKey(key){return key==="__proto__"||key==="constructor"||key==="prototype"}function normalizeStringRecord(value){if(!isPlainObjectRecord(value)){return void 0}const entries=Object.entries(value).map(([key,recordValue])=>[key.trim(),String(recordValue).trim()]).filter(([key,recordValue])=>key.length>0&&!isUnsafeObjectKey(key)&&recordValue.length>0).sort(([left],[right])=>left.localeCompare(right));return entries.length>0?Object.fromEntries(entries):void 0}function normalizeNumericRecord(value){if(!isPlainObjectRecord(value)){return void 0}const entries=Object.entries(value).map(([key,recordValue])=>[key.trim(),Number(recordValue)]).filter(([key,recordValue])=>key.length>0&&!isUnsafeObjectKey(key)&&Number.isFinite(recordValue)).sort(([left],[right])=>left.localeCompare(right));return entries.length>0?Object.fromEntries(entries):void 0}function normalizeLinkedTestContextMode(value){const normalized=value?.trim().toLowerCase();if(!normalized||!LINKED_TEST_PM_CONTEXT_MODE_VALUES.has(normalized)){return void 0}return normalized}function normalizeLinkedTestWorkspaceContextMode(value){const normalized=value?.trim().toLowerCase();if(!normalized||!LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES.has(normalized)){return void 0}return normalized}function normalizeLinkedTestProvenance(value,invalid){if(invalid===true){return{provenance_invalid:true}}if(value===void 0){return{}}if(!isPlainObjectRecord(value)){return{provenance_invalid:true}}const author=trimStringOrUndefined(value.author);const createdAt=trimStringOrUndefined(value.created_at);const sourceKind=value.source_kind;if(!author||!createdAt||!isTimestampLiteral(createdAt)||sourceKind!=="local_mutation"&&sourceKind!=="merge_union"){return{provenance_invalid:true}}return{provenance:{author,created_at:createdAt,source_kind:sourceKind,source_ref:trimStringOrUndefined(value.source_ref)}}}function normalizeLinkedTest(value){const test={command:value.command?.trim()||void 0,path:value.path?normalizePathValue(value.path):void 0,scope:value.scope,timeout_seconds:typeof value.timeout_seconds==="number"&&Number.isFinite(value.timeout_seconds)&&value.timeout_seconds>0?value.timeout_seconds:void 0,pm_context_mode:normalizeLinkedTestContextMode(value.pm_context_mode),workspace_context_mode:normalizeLinkedTestWorkspaceContextMode(value.workspace_context_mode),...normalizeLinkedTestProvenance(value.provenance,value.provenance_invalid),env_set:normalizeStringRecord(value.env_set),env_clear:normalizeTrimmedStringList(value.env_clear),shared_host_safe:value.shared_host_safe===true?true:void 0,assert_stdout_contains:normalizeTrimmedStringList(value.assert_stdout_contains),assert_stdout_regex:normalizeTrimmedStringList(value.assert_stdout_regex),assert_stderr_contains:normalizeTrimmedStringList(value.assert_stderr_contains),assert_stderr_regex:normalizeTrimmedStringList(value.assert_stderr_regex),assert_stdout_min_lines:normalizeNonNegativeInteger(value.assert_stdout_min_lines),assert_json_field_equals:normalizeStringRecord(value.assert_json_field_equals),assert_json_field_gte:normalizeNumericRecord(value.assert_json_field_gte),note:value.note?.trim()||void 0};deleteUndefinedFields(test);return test}function sortDocs(values){if(!values||values.length===0)return void 0;return[...values].map(value=>({path:normalizePathValue(value.path),scope:value.scope,note:value.note?.trim()||void 0})).sort((a,b)=>{const byScope=a.scope.localeCompare(b.scope);if(byScope!==0)return byScope;const byPath=a.path.localeCompare(b.path);if(byPath!==0)return byPath;return(a.note??"").localeCompare(b.note??"")})}function trimStringOrUndefined(value){if(typeof value!=="string")return void 0;const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}function normalizePlanStepLinks(value){if(!Array.isArray(value))return void 0;const out=[];for(const entry of value){if(entry===null||typeof entry!=="object")continue;const record=entry;const id=trimStringOrUndefined(record.id);const kind=trimStringOrUndefined(record.kind);if(!id||!kind)continue;const link={id,kind};const note=trimStringOrUndefined(record.note);if(note)link.note=note;if(record.required_before_step===true)link.required_before_step=true;out.push(link)}return out.length>0?out:void 0}function normalizePlanStepFiles(value){if(!Array.isArray(value))return void 0;const out=[];for(const entry of value){if(entry===null||typeof entry!=="object")continue;const record=entry;const path=trimStringOrUndefined(record.path);if(!path)continue;const file={path:normalizePathValue(path)};if(record.scope==="project"||record.scope==="global")file.scope=record.scope;const note=trimStringOrUndefined(record.note);if(note)file.note=note;out.push(file)}return out.length>0?out:void 0}function normalizePlanStepTests(value){if(!Array.isArray(value))return void 0;const out=[];for(const entry of value){if(entry===null||typeof entry!=="object")continue;const record=entry;const command=trimStringOrUndefined(record.command);const path=trimStringOrUndefined(record.path);if(!command&&!path)continue;const test={};if(command)test.command=command;if(path)test.path=normalizePathValue(path);const note=trimStringOrUndefined(record.note);if(note)test.note=note;out.push(test)}return out.length>0?out:void 0}function normalizePlanStepDocs(value){if(!Array.isArray(value))return void 0;const out=[];for(const entry of value){if(entry===null||typeof entry!=="object")continue;const record=entry;const path=trimStringOrUndefined(record.path);if(!path)continue;const doc={path:normalizePathValue(path)};if(record.scope==="project"||record.scope==="global")doc.scope=record.scope;const note=trimStringOrUndefined(record.note);if(note)doc.note=note;out.push(doc)}return out.length>0?out:void 0}function normalizePlanStepEntry(entry){if(entry===null||typeof entry!=="object"){return void 0}const record=entry;const id=trimStringOrUndefined(record.id);const title=trimStringOrUndefined(record.title);const statusRaw=trimStringOrUndefined(record.status);const status=statusRaw&&PLAN_STEP_STATUS_SET.has(statusRaw)?statusRaw:void 0;const order=coerceFiniteNumber(record.order)??Number.NaN;const created_at=typeof record.created_at==="string"?record.created_at:"";const updated_at=typeof record.updated_at==="string"?record.updated_at:"";if(!id||!title||!status||!Number.isFinite(order)||!created_at||!updated_at){return void 0}const step={id,order,title,status,created_at,updated_at};applyPlanStepOptionalFields(step,record);return step}function applyPlanStepOptionalFields(step,record){const stringFields=[["body","body"],["owner","owner"],["evidence","evidence"],["blocked_reason","blocked_reason"],["superseded_by","superseded_by"]];for(const[target,source]of stringFields){const value=trimStringOrUndefined(record[source]);if(value){step[target]=value}}const completedAt=typeof record.completed_at==="string"?record.completed_at:void 0;if(completedAt&&completedAt.length>0){step.completed_at=completedAt}const collectionFields=[["linked_items","linked_items",normalizePlanStepLinks],["files","files",normalizePlanStepFiles],["tests","tests",normalizePlanStepTests],["docs","docs",normalizePlanStepDocs]];for(const[target,source,normalize]of collectionFields){const value=normalize(record[source]);if(value){step[target]=value}}}function normalizePlanSteps(value){if(!Array.isArray(value))return void 0;const out=value.flatMap(entry=>{const step=normalizePlanStepEntry(entry);return step?[step]:[]});out.sort((left,right)=>left.order-right.order);return out.length>0?out:void 0}function normalizePlanDecisions(value){if(!Array.isArray(value))return void 0;const out=[];for(const entry of value){if(entry===null||typeof entry!=="object")continue;const record=entry;const ts=typeof record.ts==="string"?record.ts:"";const author=typeof record.author==="string"?record.author:"";const decision=trimStringOrUndefined(record.decision);if(!ts||!author||!decision)continue;const item={ts,author,decision};const rationale=trimStringOrUndefined(record.rationale);if(rationale)item.rationale=rationale;const evidence=trimStringOrUndefined(record.evidence);if(evidence)item.evidence=evidence;const stepId=trimStringOrUndefined(record.step_id);if(stepId)item.step_id=stepId;out.push(item)}return out.length>0?out:void 0}function normalizePlanDiscoveries(value){if(!Array.isArray(value))return void 0;const out=[];for(const entry of value){if(entry===null||typeof entry!=="object")continue;const record=entry;const ts=typeof record.ts==="string"?record.ts:"";const author=typeof record.author==="string"?record.author:"";const text=trimStringOrUndefined(record.text);if(!ts||!author||!text)continue;const item={ts,author,text};const stepId=trimStringOrUndefined(record.step_id);if(stepId)item.step_id=stepId;out.push(item)}return out.length>0?out:void 0}function normalizePlanValidation(value){if(!Array.isArray(value))return void 0;const out=[];for(const entry of value){if(entry===null||typeof entry!=="object")continue;const record=entry;const text=trimStringOrUndefined(record.text);if(!text)continue;const item={text};const command=trimStringOrUndefined(record.command);if(command)item.command=command;const expected=trimStringOrUndefined(record.expected);if(expected)item.expected=expected;out.push(item)}return out.length>0?out:void 0}function normalizeTypeOptions(values){if(!values){return void 0}const normalizedEntries=Object.entries(values).map(([key,value])=>[key.trim(),value.trim()]).filter(([key,value])=>key.length>0&&value.length>0).sort((left,right)=>left[0].localeCompare(right[0]));if(normalizedEntries.length===0){return void 0}return Object.fromEntries(normalizedEntries)}function normalizeBody(body){let start=0;while(start<body.length&&body[start]==="\n"){start+=1}return body.slice(start).trimEnd()}function normalizeConfidenceValue(value){if(value===void 0){return void 0}if(typeof value==="number"){return value}const normalized=value.trim().toLowerCase();if(normalized==="med"){return"medium"}if(CONFIDENCE_TEXT_VALUES.includes(normalized)){return normalized}return void 0}function normalizeSeverityValue(value){if(value===void 0){return void 0}const normalized=value.trim().toLowerCase();if(normalized==="med"){return"medium"}if(ISSUE_SEVERITY_VALUES.includes(normalized)){return normalized}return void 0}function emptyStringToUndefined(value){return value||void 0}function copyExtensionItemMetadataFields(normalized,source){const targetRecord=normalized;const sourceRecord=source;for(const[key,value]of Object.entries(sourceRecord)){if(isUnsafeObjectKey(key)||Object.prototype.hasOwnProperty.call(targetRecord,key)||value===void 0){continue}targetRecord[key]=value}}function coerceNormalizedRuntimeFields(normalized,runtimeContext){if(!runtimeContext?.fieldRegistry){return}const record=normalized;for(const definition of runtimeContext.fieldRegistry.definitions){const currentValue=record[definition.metadata_key];if(currentValue===void 0){continue}record[definition.metadata_key]=coerceRuntimeFieldValue(definition,currentValue,`metadata field "${definition.metadata_key}"`)}}function assertNormalizedUnknownFields(normalized,runtimeContext){if(!runtimeContext||runtimeContext.unknownFieldPolicy==="allow"){return}const knownKeys=buildKnownItemMetadataKeys(runtimeContext);const record=normalized;const unknownKeys=Object.keys(record).filter(key=>!knownKeys.has(key)).sort((left,right)=>left.localeCompare(right));if(unknownKeys.length>0&&runtimeContext.unknownFieldPolicy==="reject"){validationError(`unknown schema fields are not allowed: ${unknownKeys.join(", ")}`)}if(unknownKeys.length>0){runtimeContext.onWarning?.(`item_unknown_schema_fields:${unknownKeys.join(",")}`)}}function normalizeItemMetadata(itemMetadata,options={}){const runtimeContext=resolveRuntimeSchemaValidationContext(options);const normalizedStatus=normalizeStatusInput(itemMetadata.status,runtimeContext?.statusRegistry)??itemMetadata.status;const tags=Array.from(new Set((Array.isArray(itemMetadata.tags)?itemMetadata.tags:[]).filter(tag=>typeof tag==="string").map(tag=>tag.trim().toLowerCase()).filter(Boolean))).sort((a,b)=>a.localeCompare(b));const normalized={id:itemMetadata.id,title:itemMetadata.title,description:itemMetadata.description,type:itemMetadata.type,pm_format_version:normalizeItemFormatVersion(itemMetadata.pm_format_version),source_type:trimStringOrUndefined(itemMetadata.source_type),type_options:normalizeTypeOptions(itemMetadata.type_options),status:normalizedStatus,priority:itemMetadata.priority,tags,created_at:itemMetadata.created_at,updated_at:itemMetadata.updated_at,dependencies:sortDependencies(itemMetadata.dependencies),comments:sortLogValues(itemMetadata.comments),notes:sortLogValues(itemMetadata.notes),learnings:sortLogValues(itemMetadata.learnings),files:normalizeFiles(itemMetadata.files),tests:sortTests(itemMetadata.tests),test_runs:normalizeTestRunSummaries(itemMetadata.test_runs),docs:sortDocs(itemMetadata.docs),deadline:emptyStringToUndefined(itemMetadata.deadline),reminders:sortReminders(itemMetadata.reminders),events:sortEvents(itemMetadata.events),closed_at:emptyStringToUndefined(itemMetadata.closed_at),completed_at:emptyStringToUndefined(itemMetadata.completed_at),assignee:trimStringOrUndefined(itemMetadata.assignee),claim_principal:trimStringOrUndefined(itemMetadata.claim_principal),source_owner:trimStringOrUndefined(itemMetadata.source_owner),author:emptyStringToUndefined(itemMetadata.author),estimated_minutes:itemMetadata.estimated_minutes,acceptance_criteria:itemMetadata.acceptance_criteria??void 0,design:itemMetadata.design??void 0,external_ref:itemMetadata.external_ref??void 0,definition_of_ready:trimStringOrUndefined(itemMetadata.definition_of_ready),order:itemMetadata.order,goal:trimStringOrUndefined(itemMetadata.goal),objective:trimStringOrUndefined(itemMetadata.objective),value:trimStringOrUndefined(itemMetadata.value),impact:trimStringOrUndefined(itemMetadata.impact),outcome:trimStringOrUndefined(itemMetadata.outcome),why_now:trimStringOrUndefined(itemMetadata.why_now),parent:trimStringOrUndefined(itemMetadata.parent),reviewer:trimStringOrUndefined(itemMetadata.reviewer),risk:itemMetadata.risk??void 0,confidence:normalizeConfidenceValue(itemMetadata.confidence),sprint:trimStringOrUndefined(itemMetadata.sprint),release:trimStringOrUndefined(itemMetadata.release),blocked_by:trimStringOrUndefined(itemMetadata.blocked_by),blocked_reason:trimStringOrUndefined(itemMetadata.blocked_reason),unblock_note:trimStringOrUndefined(itemMetadata.unblock_note),reporter:trimStringOrUndefined(itemMetadata.reporter),severity:normalizeSeverityValue(itemMetadata.severity),environment:trimStringOrUndefined(itemMetadata.environment),repro_steps:trimStringOrUndefined(itemMetadata.repro_steps),resolution:trimStringOrUndefined(itemMetadata.resolution),expected_result:trimStringOrUndefined(itemMetadata.expected_result),actual_result:trimStringOrUndefined(itemMetadata.actual_result),affected_version:trimStringOrUndefined(itemMetadata.affected_version),fixed_version:trimStringOrUndefined(itemMetadata.fixed_version),component:trimStringOrUndefined(itemMetadata.component),regression:itemMetadata.regression,customer_impact:trimStringOrUndefined(itemMetadata.customer_impact),close_reason:emptyStringToUndefined(itemMetadata.close_reason),plan_mode:trimStringOrUndefined(itemMetadata.plan_mode),plan_scope:trimStringOrUndefined(itemMetadata.plan_scope),plan_harness:trimStringOrUndefined(itemMetadata.plan_harness),plan_resume_context:trimStringOrUndefined(itemMetadata.plan_resume_context),plan_steps:normalizePlanSteps(itemMetadata.plan_steps),plan_decisions:normalizePlanDecisions(itemMetadata.plan_decisions),plan_discoveries:normalizePlanDiscoveries(itemMetadata.plan_discoveries),plan_validation:normalizePlanValidation(itemMetadata.plan_validation)};copyExtensionItemMetadataFields(normalized,itemMetadata);coerceNormalizedRuntimeFields(normalized,runtimeContext);assertNormalizedUnknownFields(normalized,runtimeContext);deleteUndefinedFields(normalized);return normalized}function orderItemMetadata(itemMetadata){return orderObject(itemMetadata,ITEM_METADATA_KEY_ORDER)}function findJsonObjectEnd(content){let depth=0;let inString=false;let escaped=false;for(let i=0;i<content.length;i+=1){const char=content[i];if(inString){if(escaped){escaped=false;continue}if(char==="\\"){escaped=true;continue}if(char==='"'){inString=false}continue}if(char==='"'){inString=true;continue}if(char==="{"){depth+=1;continue}if(char==="}"){depth-=1;if(depth===0){return i}}}return-1}function splitFrontMatter(content){if(!content.startsWith("{")){return{frontMatter:"",body:content}}const end=findJsonObjectEnd(content);if(end<0){return{frontMatter:"",body:content}}const frontMatter=content.slice(0,end+1);const body=content.slice(end+1).replace(/^\r?\n+/,"");return{frontMatter,body}}function stripLeadingYamlDocument(content){const normalizedContent=content.charCodeAt(0)===65279?content.slice(1):content;const opener=normalizedContent.match(/^[ \t]*---[ \t]*(?:\r?\n|$)/);if(!opener){return{content:normalizedContent,stripped:false}}let cursor=opener[0].length;while(cursor<normalizedContent.length){const nextNewline=normalizedContent.indexOf("\n",cursor);const lineEnd=nextNewline===-1?normalizedContent.length:nextNewline;const line=normalizedContent.slice(cursor,lineEnd).replace(/\r$/,"");const afterLine=nextNewline===-1?lineEnd:lineEnd+1;if(line.trim()==="---"){return{content:normalizedContent.slice(afterLine).replace(/^\s+/,""),stripped:true}}cursor=afterLine}return{content:normalizedContent,stripped:false}}function normalizeParsedItemMetadata(itemMetadata,options){return normalizeItemMetadata(itemMetadata,{...options,onWarning:void 0})}function parseJsonMarkdownItemDocument(content,runtimeContext,options={}){const normalized=stripLeadingYamlDocument(content);if(normalized.stripped){options.onWarning?.("json_markdown_leading_yaml_frontmatter_ignored")}const{frontMatter,body}=splitFrontMatter(normalized.content);if(!frontMatter){const trimmed=content.trimStart();if(trimmed.startsWith("{")){documentSyntaxError("json_markdown","JSON front matter is not valid JSON")}documentSyntaxError("json_markdown","JSON Markdown item document is missing JSON front matter")}let parsed;try{parsed=JSON.parse(frontMatter)}catch{documentSyntaxError("json_markdown","JSON front matter is not valid JSON")}assertValidItemMetadata(parsed,runtimeContext);return{metadata:normalizeParsedItemMetadata(parsed,options),body:normalizeBody(body)}}function parseToonItemDocument(content,runtimeContext,options={}){let parsed;try{parsed=decodeToonItemContent(content).value}catch{documentSyntaxError("toon","TOON item document is not valid TOON")}assertItemMetadataCondition(typeof parsed==="object"&&parsed!==null&&!Array.isArray(parsed),"TOON item document must be an object");const record=parsed;if(!REQUIRED_STRING_FIELDS.some(fieldName=>Object.prototype.hasOwnProperty.call(record,fieldName))&&!Object.prototype.hasOwnProperty.call(record,"front_matter")){documentSyntaxError("toon","TOON input does not have the shape of an item document")}if(Object.prototype.hasOwnProperty.call(record,"front_matter")){assertValidItemMetadata(record.front_matter,runtimeContext);assertItemMetadataCondition(record.body===void 0||typeof record.body==="string","TOON item document body must be a string");return{metadata:normalizeParsedItemMetadata(record.front_matter,options),body:normalizeBody(typeof record.body==="string"?record.body:"")}}const{body,...itemMetadataRecord}=record;assertItemMetadataCondition(body===void 0||typeof body==="string","TOON item document body must be a string");assertValidItemMetadata(itemMetadataRecord,runtimeContext);return{metadata:normalizeParsedItemMetadata(itemMetadataRecord,options),body:normalizeBody(typeof body==="string"?body:"")}}function serializeJsonMarkdownItemDocument(document,options={}){const normalizedMetadata=normalizeItemMetadata(document.metadata,options);const orderedMetadata=orderItemMetadata(normalizedMetadata);const serializedMetadata=JSON.stringify(orderedMetadata,null,2);const normalizedBody=normalizeBody(document.body??"");if(!normalizedBody){return`${serializedMetadata}
+`}return`${serializedMetadata}
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="051655a4-8ba7-5118-9758-d9ca377fa7e4")}catch(e){}}();
-import { encode as encodeToon } from "@toon-format/toon";
-import { isDeepStrictEqual } from "node:util";
-import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, PLAN_STEP_STATUS_VALUES, RECURRENCE_FREQUENCY_VALUES, RECURRENCE_WEEKDAY_VALUES, STATUS_VALUES, weekdayOrderIndex, } from "../../types/index.js";
-import { coerceRuntimeFieldValue } from "../schema/runtime-field-values.js";
-import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../schema/runtime-schema.js";
-import { BASELINE_ITEM_FORMAT_VERSION, normalizeItemFormatVersion, } from "./item-format-version.js";
-import { normalizeStatusInput } from "./status.js";
-import { decodeToonItemContent } from "./toon-decode.js";
-import { EXIT_CODE, ITEM_METADATA_KEY_ORDER } from "../shared/constants.js";
-import { findFirstMergeConflictMarker } from "../shared/conflict-markers.js";
-import { PmCliError } from "../shared/errors.js";
-import { orderObject } from "../shared/serialization.js";
-import { compareTimestampStrings, isTimestampLiteral } from "../shared/time.js";
-import { coerceFiniteNumber } from "../shared/primitives.js";
-const LINKED_TEST_PM_CONTEXT_MODE_VALUES = new Set([
-    "schema",
-    "tracker",
-    "auto",
-]);
-const LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES = new Set([
-    "source",
-    "isolated",
-    "snapshot",
-]);
-const LINKED_TEST_TRUST_REASON_VALUES = new Set([
-    "legacy",
-    "local_mutation",
-    "local_source_ref",
-    "acknowledged",
-    "invalid_provenance",
-    "foreign_source_ref",
-]);
-const ITEM_TEST_RUN_STATUS_VALUES = new Set([
-    "passed",
-    "failed",
-    "stopped",
-    "canceled",
-]);
-const PLAN_STEP_STATUS_SET = new Set(PLAN_STEP_STATUS_VALUES);
-function normalizePathValue(value) {
-    return value.replaceAll("\\", "/");
-}
-function firstNonZeroComparison(comparisons) {
-    for (const comparison of comparisons) {
-        if (comparison !== 0) {
-            return comparison;
-        }
-    }
-    return 0;
-}
-function deleteUndefinedFields(record) {
-    for (const [key, value] of Object.entries(record)) {
-        if (value === undefined) {
-            delete record[key];
-        }
-    }
-}
-const REQUIRED_STRING_FIELDS = [
-    "id",
-    "title",
-    "description",
-    "created_at",
-    "updated_at",
-];
-const STATIC_ITEM_METADATA_FIELD_SET = new Set(ITEM_METADATA_KEY_ORDER);
-function resolveRuntimeSchemaValidationContext(options) {
-    if (!options?.schema) {
-        return undefined;
-    }
-    return {
-        statusRegistry: resolveRuntimeStatusRegistry(options.schema),
-        fieldRegistry: resolveRuntimeFieldRegistry(options.schema),
-        unknownFieldPolicy: options.schema.unknown_field_policy ?? "allow",
-        extensionFieldNames: new Set(options.extensionFieldNames ?? []),
-        onWarning: options.onWarning,
-    };
-}
-function runtimeFieldRequiredForType(definition, typeName) {
-    if (!definition.required) {
-        return false;
-    }
-    if (definition.required_types.length === 0) {
-        return true;
-    }
-    return definition.required_types
-        .map((value) => value.toLowerCase())
-        .includes(typeName.trim().toLowerCase());
-}
-function validationError(message) {
-    const field = message.match(/^([a-z_][\w.]*)\s/u)?.[1];
-    throw new PmCliError(`Invalid item metadata: ${message}`, EXIT_CODE.GENERIC_FAILURE, {
-        code: "item_document_invalid",
-        reason: message.includes("required")
-            ? "missing_required_field"
-            : "schema_validation_error",
-        ...(field ? { field } : {}),
-        required: "Provide an item document whose metadata satisfies the active runtime schema.",
-        why: message,
-    });
-}
-function documentSyntaxError(format, message) {
-    throw new PmCliError(message, EXIT_CODE.GENERIC_FAILURE, {
-        code: "item_document_invalid",
-        reason: "syntax_error",
-        format,
-        required: `Provide a syntactically valid ${format === "toon" ? "TOON" : "JSON Markdown"} item document.`,
-        why: "The document could not be decoded far enough to validate item metadata.",
-    });
-}
-function buildKnownItemMetadataKeys(runtimeContext) {
-    const knownKeys = new Set(STATIC_ITEM_METADATA_FIELD_SET);
-    for (const definition of runtimeContext.fieldRegistry?.definitions ?? []) {
-        knownKeys.add(definition.metadata_key);
-    }
-    for (const fieldName of runtimeContext.extensionFieldNames) {
-        knownKeys.add(fieldName);
-    }
-    return knownKeys;
-}
-function assertItemMetadataCondition(condition, message) {
-    if (!condition) {
-        validationError(message);
-    }
-}
-function requireItemMetadataRecord(value, message) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        validationError(message);
-    }
-    return value;
-}
-function assertTimestampField(record, fieldName) {
-    const rawValue = record[fieldName];
-    assertItemMetadataCondition(typeof rawValue === "string", `${fieldName} must be a string`);
-    const timestamp = rawValue;
-    assertItemMetadataCondition(isTimestampLiteral(timestamp), `${fieldName} must be a valid ISO timestamp`);
-}
-function assertPositiveIntegerField(record, fieldName, messagePrefix) {
-    const value = record[fieldName];
-    if (value === undefined) {
-        return;
-    }
-    assertItemMetadataCondition(typeof value === "number" && Number.isInteger(value) && value >= 1, `${messagePrefix} must be an integer >= 1`);
-}
-function assertOptionalTimestampString(record, fieldName, messagePrefix) {
-    const value = record[fieldName];
-    if (value === undefined) {
-        return;
-    }
-    assertItemMetadataCondition(typeof value === "string", `${messagePrefix} must be a string`);
-    assertItemMetadataCondition(isTimestampLiteral(value), `${messagePrefix} must be a valid ISO timestamp`);
-}
-function assertRecurrenceWeekdays(value) {
-    if (value === undefined) {
-        return;
-    }
-    assertItemMetadataCondition(Array.isArray(value), "event.recurrence.by_weekday must be an array");
-    for (const weekday of value) {
-        assertItemMetadataCondition(typeof weekday === "string", "event.recurrence.by_weekday entries must be strings");
-        const normalizedWeekday = weekday.trim().toLowerCase();
-        assertItemMetadataCondition(RECURRENCE_WEEKDAY_VALUES.includes(normalizedWeekday), `event.recurrence.by_weekday entries must be one of: ${RECURRENCE_WEEKDAY_VALUES.join(", ")}`);
-    }
-}
-function assertRecurrenceMonthDays(value) {
-    if (value === undefined) {
-        return;
-    }
-    assertItemMetadataCondition(Array.isArray(value), "event.recurrence.by_month_day must be an array");
-    for (const day of value) {
-        assertItemMetadataCondition(typeof day === "number" && Number.isInteger(day) && day >= 1 && day <= 31, "event.recurrence.by_month_day entries must be integers 1..31");
-    }
-}
-function assertRecurrenceExdates(value) {
-    if (value === undefined) {
-        return;
-    }
-    assertItemMetadataCondition(Array.isArray(value), "event.recurrence.exdates must be an array");
-    for (const exdate of value) {
-        assertItemMetadataCondition(typeof exdate === "string", "event.recurrence.exdates entries must be strings");
-        assertItemMetadataCondition(isTimestampLiteral(exdate), "event.recurrence.exdates entries must be valid ISO timestamps");
-    }
-}
-function assertValidRecurrenceRule(recurrence) {
-    const recurrenceRecord = requireItemMetadataRecord(recurrence, "event.recurrence must be an object");
-    assertItemMetadataCondition(typeof recurrenceRecord.freq === "string", "event.recurrence.freq must be a string");
-    const frequency = recurrenceRecord.freq.trim().toLowerCase();
-    assertItemMetadataCondition(RECURRENCE_FREQUENCY_VALUES.includes(frequency), `event.recurrence.freq must be one of: ${RECURRENCE_FREQUENCY_VALUES.join(", ")}`);
-    assertPositiveIntegerField(recurrenceRecord, "interval", "event.recurrence.interval");
-    assertPositiveIntegerField(recurrenceRecord, "count", "event.recurrence.count");
-    assertOptionalTimestampString(recurrenceRecord, "until", "event.recurrence.until");
-    assertRecurrenceWeekdays(recurrenceRecord.by_weekday);
-    assertRecurrenceMonthDays(recurrenceRecord.by_month_day);
-    assertRecurrenceExdates(recurrenceRecord.exdates);
-}
-function assertRequiredItemMetadataFields(record) {
-    for (const fieldName of REQUIRED_STRING_FIELDS) {
-        assertItemMetadataCondition(typeof record[fieldName] === "string", `${fieldName} is required and must be a string`);
-    }
-    const itemType = record.type;
-    assertItemMetadataCondition(typeof itemType === "string" && itemType.trim().length > 0, "type must be a non-empty string");
-    const formatVersion = record.pm_format_version;
-    if (formatVersion !== undefined) {
-        assertItemMetadataCondition(typeof formatVersion === "number" &&
-            Number.isInteger(formatVersion) &&
-            formatVersion >= BASELINE_ITEM_FORMAT_VERSION, `pm_format_version must be an integer >= ${BASELINE_ITEM_FORMAT_VERSION}`);
-    }
-    return itemType;
-}
-function assertStatusItemMetadataField(record, runtimeContext) {
-    const status = record.status;
-    assertItemMetadataCondition(typeof status === "string" && status.trim().length > 0, "status must be a non-empty string");
-    const statusRegistry = runtimeContext?.statusRegistry;
-    const normalizedStatus = normalizeStatusInput(status, statusRegistry);
-    const statusDomain = statusRegistry
-        ? statusRegistry.definitions.map((definition) => definition.id)
-        : [...STATUS_VALUES];
-    assertItemMetadataCondition(normalizedStatus !== undefined, `status must be one of: ${statusDomain.join(", ")}`);
-}
-function assertPriorityAndTags(record) {
-    const priority = record.priority;
-    assertItemMetadataCondition(typeof priority === "number" &&
-        Number.isInteger(priority) &&
-        [0, 1, 2, 3, 4].includes(priority), "priority must be an integer 0..4");
-    const tags = record.tags;
-    assertItemMetadataCondition(Array.isArray(tags), "tags must be an array");
-    for (const tag of tags) {
-        assertItemMetadataCondition(typeof tag === "string", "tags entries must be strings");
-    }
-}
-function assertConfidenceItemMetadataField(record) {
-    const confidence = record.confidence;
-    if (confidence === undefined) {
-        return;
-    }
-    if (typeof confidence === "number") {
-        assertItemMetadataCondition(Number.isInteger(confidence) && confidence >= 0 && confidence <= 100, "confidence number value must be an integer 0..100");
-        return;
-    }
-    if (typeof confidence === "string") {
-        const normalizedConfidence = confidence.trim().toLowerCase();
-        const isKnownTextConfidence = normalizedConfidence === "med" ||
-            CONFIDENCE_TEXT_VALUES.includes(normalizedConfidence);
-        assertItemMetadataCondition(isKnownTextConfidence, `confidence string value must be one of: ${[...CONFIDENCE_TEXT_VALUES, "med"].join(", ")}`);
-        return;
-    }
-    assertItemMetadataCondition(false, "confidence must be a number or string");
-}
-function assertSeverityItemMetadataField(record) {
-    const severity = record.severity;
-    if (severity === undefined) {
-        return;
-    }
-    if (typeof severity !== "string") {
-        validationError("severity must be a string");
-    }
-    const normalizedSeverity = severity.trim().toLowerCase();
-    const isKnownSeverity = normalizedSeverity === "med" ||
-        ISSUE_SEVERITY_VALUES.includes(normalizedSeverity);
-    assertItemMetadataCondition(isKnownSeverity, `severity value must be one of: ${[...ISSUE_SEVERITY_VALUES, "med"].join(", ")}`);
-}
-function assertRegressionItemMetadataField(record) {
-    if (record.regression !== undefined &&
-        typeof record.regression !== "boolean") {
-        validationError("regression must be a boolean");
-    }
-}
-function assertReminderEntries(record) {
-    const reminders = record.reminders;
-    if (reminders === undefined) {
-        return;
-    }
-    assertItemMetadataCondition(Array.isArray(reminders), "reminders must be an array");
-    for (const reminder of reminders) {
-        const reminderRecord = requireItemMetadataRecord(reminder, "reminders entries must be objects");
-        assertItemMetadataCondition(typeof reminderRecord.at === "string", "reminder.at must be a string");
-        assertItemMetadataCondition(isTimestampLiteral(reminderRecord.at), "reminder.at must be a valid ISO timestamp");
-        assertItemMetadataCondition(typeof reminderRecord.text === "string", "reminder.text must be a string");
-        assertItemMetadataCondition(reminderRecord.text.trim().length > 0, "reminder.text must not be empty");
-    }
-}
-function assertEventStringFields(eventRecord) {
-    for (const stringField of [
-        "title",
-        "description",
-        "location",
-        "timezone",
-    ]) {
-        if (eventRecord[stringField] !== undefined) {
-            assertItemMetadataCondition(typeof eventRecord[stringField] === "string", `event.${stringField} must be a string`);
-            assertItemMetadataCondition(eventRecord[stringField].trim().length > 0, `event.${stringField} must not be empty`);
-        }
-    }
-}
-function assertEventRecurrence(eventRecord) {
-    if (eventRecord.recurrence === undefined) {
-        return;
-    }
-    assertValidRecurrenceRule(eventRecord.recurrence);
-    if (eventRecord.recurrence.until !== undefined) {
-        assertItemMetadataCondition(compareTimestampStrings(eventRecord.recurrence.until, eventRecord.start_at) >= 0, "event.recurrence.until must be at or after event.start_at");
-    }
-}
-function assertCalendarEventEntry(event) {
-    const eventRecord = requireItemMetadataRecord(event, "events entries must be objects");
-    assertItemMetadataCondition(typeof eventRecord.start_at === "string", "event.start_at must be a string");
-    assertItemMetadataCondition(isTimestampLiteral(eventRecord.start_at), "event.start_at must be a valid ISO timestamp");
-    if (eventRecord.end_at !== undefined) {
-        assertItemMetadataCondition(typeof eventRecord.end_at === "string", "event.end_at must be a string");
-        assertItemMetadataCondition(isTimestampLiteral(eventRecord.end_at), "event.end_at must be a valid ISO timestamp");
-        assertItemMetadataCondition(compareTimestampStrings(eventRecord.end_at, eventRecord.start_at) > 0, "event.end_at must be after event.start_at");
-    }
-    assertEventStringFields(eventRecord);
-    if (eventRecord.all_day !== undefined) {
-        assertItemMetadataCondition(typeof eventRecord.all_day === "boolean", "event.all_day must be a boolean");
-    }
-    assertEventRecurrence(eventRecord);
-}
-function assertCalendarEvents(record) {
-    const events = record.events;
-    if (events === undefined) {
-        return;
-    }
-    assertItemMetadataCondition(Array.isArray(events), "events must be an array");
-    for (const event of events) {
-        assertCalendarEventEntry(event);
-    }
-}
-function assertOptionalStringFields(record) {
-    for (const fieldName of [
-        "source_type",
-        "source_owner",
-        "design",
-        "external_ref",
-    ]) {
-        const value = record[fieldName];
-        if (value !== undefined) {
-            assertItemMetadataCondition(typeof value === "string", `${fieldName} must be a string`);
-        }
-    }
-}
-function assertTypeOptionsField(record) {
-    const typeOptions = record.type_options;
-    if (typeOptions === undefined) {
-        return;
-    }
-    const typeOptionsRecord = requireItemMetadataRecord(typeOptions, "type_options must be an object");
-    for (const [optionKey, optionValue] of Object.entries(typeOptionsRecord)) {
-        assertItemMetadataCondition(optionKey.trim().length > 0, "type_options keys must be non-empty");
-        assertItemMetadataCondition(typeof optionValue === "string", "type_options values must be strings");
-        const optionText = optionValue;
-        assertItemMetadataCondition(optionText.trim().length > 0, "type_options values must be non-empty strings");
-    }
-}
-function coerceRuntimeItemMetadataFields(record, itemType, runtimeContext) {
-    if (!runtimeContext?.fieldRegistry) {
-        return;
-    }
-    for (const definition of runtimeContext.fieldRegistry.definitions) {
-        const fieldValue = record[definition.metadata_key];
-        if (fieldValue === undefined) {
-            if (runtimeFieldRequiredForType(definition, itemType)) {
-                validationError(`missing required schema field: ${definition.metadata_key}`);
-            }
-            continue;
-        }
-        try {
-            record[definition.metadata_key] = coerceRuntimeFieldValue(definition, fieldValue, `metadata field "${definition.metadata_key}"`);
-        }
-        catch (error) {
-            validationError(String(error?.message).replace(/^Invalid\s+/u, ""));
-        }
-    }
-}
-function assertRuntimeUnknownItemMetadataFields(record, runtimeContext) {
-    if (!runtimeContext || runtimeContext.unknownFieldPolicy === "allow") {
-        return;
-    }
-    const knownKeys = buildKnownItemMetadataKeys(runtimeContext);
-    const unknownKeys = Object.keys(record)
-        .filter((key) => !knownKeys.has(key))
-        .sort((left, right) => left.localeCompare(right));
-    if (unknownKeys.length === 0) {
-        return;
-    }
-    if (runtimeContext.unknownFieldPolicy === "reject") {
-        validationError(`unknown schema fields are not allowed: ${unknownKeys.join(", ")}`);
-    }
-    else {
-        runtimeContext.onWarning?.(`item_unknown_schema_fields:${unknownKeys.join(",")}`);
-    }
-}
-function assertValidItemMetadata(itemMetadata, runtimeContext) {
-    const record = requireItemMetadataRecord(itemMetadata, "item metadata must be an object");
-    const itemType = assertRequiredItemMetadataFields(record);
-    assertStatusItemMetadataField(record, runtimeContext);
-    assertPriorityAndTags(record);
-    assertConfidenceItemMetadataField(record);
-    assertSeverityItemMetadataField(record);
-    assertRegressionItemMetadataField(record);
-    assertTimestampField(record, "created_at");
-    assertTimestampField(record, "updated_at");
-    if (record.deadline !== undefined) {
-        assertTimestampField(record, "deadline");
-    }
-    assertReminderEntries(record);
-    assertCalendarEvents(record);
-    assertOptionalTimestampString(record, "closed_at", "closed_at");
-    assertOptionalTimestampString(record, "completed_at", "completed_at");
-    assertOptionalStringFields(record);
-    assertTypeOptionsField(record);
-    coerceRuntimeItemMetadataFields(record, itemType, runtimeContext);
-    assertRuntimeUnknownItemMetadataFields(record, runtimeContext);
-}
-function sortDependencies(values) {
-    if (!values || values.length === 0)
-        return undefined;
-    return [...values]
-        .map((value) => ({
-        id: value.id.trim(),
-        kind: value.kind,
-        created_at: value.created_at,
-        author: value.author?.trim() || undefined,
-        source_kind: value.source_kind?.trim() || undefined,
-        author_source: value.author_source,
-    }))
-        .sort((a, b) => {
-        const byCreated = compareTimestampStrings(a.created_at, b.created_at);
-        if (byCreated !== 0)
-            return byCreated;
-        const byId = a.id.localeCompare(b.id);
-        if (byId !== 0)
-            return byId;
-        const byKind = a.kind.localeCompare(b.kind);
-        if (byKind !== 0)
-            return byKind;
-        return (a.source_kind ?? "").localeCompare(b.source_kind ?? "");
-    });
-}
-function sortLogValues(values) {
-    if (!values || values.length === 0)
-        return undefined;
-    return [...values].sort((a, b) => {
-        const byCreated = compareTimestampStrings(a.created_at, b.created_at);
-        if (byCreated !== 0)
-            return byCreated;
-        const byText = a.text.localeCompare(b.text);
-        if (byText !== 0)
-            return byText;
-        return a.author.localeCompare(b.author);
-    });
-}
-function sortReminders(values) {
-    if (!values || values.length === 0)
-        return undefined;
-    const normalized = [...values]
-        .map((value) => ({
-        at: value.at,
-        text: value.text.trim(),
-    }))
-        .filter((value) => value.text.length > 0)
-        .sort((a, b) => {
-        const byAt = compareTimestampStrings(a.at, b.at);
-        if (byAt !== 0)
-            return byAt;
-        return a.text.localeCompare(b.text);
-    });
-    return normalized.length === 0 ? undefined : normalized;
-}
-function normalizeRecurrenceRule(value) {
-    if (!value) {
-        return undefined;
-    }
-    const normalizedFrequency = value.freq.trim().toLowerCase();
-    if (!RECURRENCE_FREQUENCY_VALUES.includes(normalizedFrequency)) {
-        return undefined;
-    }
-    const byWeekday = Array.from(new Set((value.by_weekday ?? [])
-        .map((weekday) => weekday.trim().toLowerCase())
-        .filter((weekday) => RECURRENCE_WEEKDAY_VALUES.includes(weekday)))).sort((a, b) => weekdayOrderIndex(a) -
-        weekdayOrderIndex(b));
-    const byMonthDay = Array.from(new Set((value.by_month_day ?? [])
-        .filter((day) => Number.isInteger(day) && day >= 1 && day <= 31)
-        .map((day) => day))).sort((a, b) => a - b);
-    const exdates = Array.from(new Set((value.exdates ?? [])
-        .map((timestamp) => timestamp.trim())
-        .filter((timestamp) => isTimestampLiteral(timestamp)))).sort((a, b) => compareTimestampStrings(a, b));
-    const normalized = {
-        freq: normalizedFrequency,
-        interval: value.interval !== undefined && value.interval > 1
-            ? value.interval
-            : undefined,
-        count: value.count,
-        until: value.until?.trim() || undefined,
-        by_weekday: byWeekday.length > 0
-            ? byWeekday
-            : undefined,
-        by_month_day: byMonthDay.length > 0 ? byMonthDay : undefined,
-        exdates: exdates.length > 0 ? exdates : undefined,
-    };
-    for (const [key, fieldValue] of Object.entries(normalized)) {
-        if (fieldValue === undefined) {
-            delete normalized[key];
-        }
-    }
-    return normalized;
-}
-function sortEvents(values) {
-    if (!Array.isArray(values) || values.length === 0) {
-        return undefined;
-    }
-    const normalized = [...values]
-        .map(normalizeCalendarEvent)
-        .sort(compareCalendarEvents);
-    return normalized;
-}
-function normalizeCalendarEvent(value) {
-    const event = {
-        start_at: value.start_at,
-        end_at: value.end_at || undefined,
-        title: value.title?.trim() || undefined,
-        description: value.description?.trim() || undefined,
-        location: value.location?.trim() || undefined,
-        all_day: value.all_day,
-        timezone: value.timezone?.trim() || undefined,
-        recurrence: normalizeRecurrenceRule(value.recurrence),
-    };
-    deleteUndefinedFields(event);
-    return event;
-}
-function compareCalendarEvents(a, b) {
-    return firstNonZeroComparison([
-        compareTimestampStrings(a.start_at, b.start_at),
-        (a.end_at ?? "").localeCompare(b.end_at ?? ""),
-        (a.title ?? "").localeCompare(b.title ?? ""),
-        Number(Boolean(a.all_day)) - Number(Boolean(b.all_day)),
-        (a.timezone ?? "").localeCompare(b.timezone ?? ""),
-        (a.location ?? "").localeCompare(b.location ?? ""),
-        (a.description ?? "").localeCompare(b.description ?? ""),
-        JSON.stringify(a.recurrence ?? {}).localeCompare(JSON.stringify(b.recurrence ?? {})),
-    ]);
-}
-function normalizeFiles(values) {
-    if (!values || values.length === 0)
-        return undefined;
-    return values.map((value) => ({
-        path: normalizePathValue(value.path),
-        scope: value.scope,
-        note: value.note?.trim() || undefined,
-    }));
-}
-function normalizeTestRunSummaries(values) {
-    if (!values || values.length === 0)
-        return undefined;
-    const normalized = values
-        .map(normalizeTestRunSummary)
-        .filter((value) => value.run_id.length > 0 &&
-        value.started_at.length > 0 &&
-        value.finished_at.length > 0 &&
-        value.recorded_at.length > 0)
-        .sort((a, b) => firstNonZeroComparison([
-        compareTimestampStrings(a.recorded_at, b.recorded_at),
-        a.run_id.localeCompare(b.run_id),
-        a.kind.localeCompare(b.kind),
-    ]));
-    return normalized.length > 0 ? normalized : undefined;
-}
-function normalizeNonNegativeInteger(value) {
-    return typeof value === "number" && Number.isFinite(value) && value >= 0
-        ? Math.floor(value)
-        : undefined;
-}
-function normalizePositiveInteger(value) {
-    return typeof value === "number" && Number.isFinite(value) && value >= 1
-        ? Math.floor(value)
-        : undefined;
-}
-function stringOrEmpty(value) {
-    return typeof value === "string" ? value : "";
-}
-function normalizeTestRunMeasurements(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const normalized = value
-        .filter((measurement) => measurement !== null &&
-        typeof measurement === "object" &&
-        typeof measurement.name === "string" &&
-        measurement.name.trim().length > 0 &&
-        typeof measurement.value === "number" &&
-        Number.isFinite(measurement.value) &&
-        typeof measurement.recorded_at === "string" &&
-        measurement.recorded_at.trim().length > 0)
-        .map((measurement) => ({
-        name: measurement.name.trim(),
-        value: measurement.value,
-        unit: typeof measurement.unit === "string"
-            ? measurement.unit.trim() || undefined
-            : undefined,
-        threshold: typeof measurement.threshold === "number" &&
-            Number.isFinite(measurement.threshold)
-            ? measurement.threshold
-            : undefined,
-        recorded_at: measurement.recorded_at.trim(),
-    }));
-    const deduplicated = [
-        ...new Map(normalized.map((measurement) => [measurement.name, measurement])).values(),
-    ]
-        .sort((left, right) => left.name.localeCompare(right.name))
-        .slice(0, 32);
-    return deduplicated.length > 0 ? deduplicated : undefined;
-}
-/** Normalize and bound command/context provenance retained for a test run. */
-function normalizeTestRunEnum(value, allowedValues) {
-    return typeof value === "string" && allowedValues.has(value)
-        ? value
-        : undefined;
-}
-/** Normalize and bound command/context provenance retained for a test run. */
-function normalizeTestRunExecutions(values) {
-    if (!Array.isArray(values))
-        return undefined;
-    const executions = values
-        .filter((execution) => execution &&
-        typeof execution.command === "string" &&
-        execution.command.trim().length > 0)
-        .slice(0, 32)
-        .map((execution) => ({
-        command: execution.command.trim(),
-        requested_pm_context_mode: normalizeTestRunEnum(execution.requested_pm_context_mode, LINKED_TEST_PM_CONTEXT_MODE_VALUES),
-        pm_context_mode: normalizeTestRunEnum(execution.pm_context_mode, LINKED_TEST_PM_CONTEXT_MODE_VALUES),
-        workspace_context_mode: normalizeTestRunEnum(execution.workspace_context_mode, LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES),
-        trust_reason: normalizeTestRunEnum(execution.trust_reason, LINKED_TEST_TRUST_REASON_VALUES),
-    }));
-    return executions.length > 0 ? executions : undefined;
-}
-function normalizeTestRunSummary(value) {
-    const runId = typeof value.run_id === "string" ? value.run_id.trim() : "";
-    const kind = value.kind === "test" || value.kind === "test-all" ? value.kind : "test";
-    const status = ITEM_TEST_RUN_STATUS_VALUES.has(value.status)
-        ? value.status
-        : "failed";
-    const summary = {
-        run_id: runId,
-        kind,
-        status,
-        started_at: stringOrEmpty(value.started_at),
-        finished_at: stringOrEmpty(value.finished_at),
-        recorded_at: stringOrEmpty(value.recorded_at),
-        attempt: normalizePositiveInteger(value.attempt),
-        resumed_from: value.resumed_from?.trim() || undefined,
-        passed: normalizeNonNegativeInteger(value.passed) ?? 0,
-        failed: normalizeNonNegativeInteger(value.failed) ?? 0,
-        skipped: normalizeNonNegativeInteger(value.skipped) ?? 0,
-        items: normalizeNonNegativeInteger(value.items),
-        linked_tests: normalizeNonNegativeInteger(value.linked_tests),
-        fail_on_skipped_triggered: value.fail_on_skipped_triggered === true ? true : undefined,
-        measurements: normalizeTestRunMeasurements(value.measurements),
-        executions: normalizeTestRunExecutions(value.executions),
-    };
-    deleteUndefinedFields(summary);
-    return summary;
-}
-function sortTests(values) {
-    if (!Array.isArray(values) || values.length === 0)
-        return undefined;
-    return values.map(normalizeLinkedTest);
-}
-function normalizeTrimmedStringList(value) {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    const normalized = [
-        ...new Set(value
-            .filter((entry) => typeof entry === "string")
-            .map((entry) => entry.trim())
-            .filter((entry) => entry.length > 0)),
-    ].sort((a, b) => a.localeCompare(b));
-    return normalized.length > 0 ? normalized : undefined;
-}
-function isPlainObjectRecord(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return false;
-    }
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
-}
-function isUnsafeObjectKey(key) {
-    return key === "__proto__" || key === "constructor" || key === "prototype";
-}
-function normalizeStringRecord(value) {
-    if (!isPlainObjectRecord(value)) {
-        return undefined;
-    }
-    const entries = Object.entries(value)
-        .map(([key, recordValue]) => [key.trim(), String(recordValue).trim()])
-        .filter(([key, recordValue]) => key.length > 0 && !isUnsafeObjectKey(key) && recordValue.length > 0)
-        .sort(([left], [right]) => left.localeCompare(right));
-    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
-}
-function normalizeNumericRecord(value) {
-    if (!isPlainObjectRecord(value)) {
-        return undefined;
-    }
-    const entries = Object.entries(value)
-        .map(([key, recordValue]) => [key.trim(), Number(recordValue)])
-        .filter(([key, recordValue]) => key.length > 0 &&
-        !isUnsafeObjectKey(key) &&
-        Number.isFinite(recordValue))
-        .sort(([left], [right]) => left.localeCompare(right));
-    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
-}
-function normalizeLinkedTestContextMode(value) {
-    const normalized = value?.trim().toLowerCase();
-    if (!normalized || !LINKED_TEST_PM_CONTEXT_MODE_VALUES.has(normalized)) {
-        return undefined;
-    }
-    return normalized;
-}
-function normalizeLinkedTestWorkspaceContextMode(value) {
-    const normalized = value?.trim().toLowerCase();
-    if (!normalized ||
-        !LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES.has(normalized)) {
-        return undefined;
-    }
-    return normalized;
-}
-function normalizeLinkedTestProvenance(value, invalid) {
-    if (invalid === true) {
-        return { provenance_invalid: true };
-    }
-    if (value === undefined) {
-        return {};
-    }
-    if (!isPlainObjectRecord(value)) {
-        return { provenance_invalid: true };
-    }
-    const author = trimStringOrUndefined(value.author);
-    const createdAt = trimStringOrUndefined(value.created_at);
-    const sourceKind = value.source_kind;
-    if (!author ||
-        !createdAt ||
-        !isTimestampLiteral(createdAt) ||
-        (sourceKind !== "local_mutation" && sourceKind !== "merge_union")) {
-        // Preserve malformed provenance as an explicit runtime sentinel. Dropping
-        // it would make a tampered entry indistinguishable from a trusted legacy
-        // command in the clone-local trust resolver.
-        return { provenance_invalid: true };
-    }
-    return {
-        provenance: {
-            author,
-            created_at: createdAt,
-            source_kind: sourceKind,
-            source_ref: trimStringOrUndefined(value.source_ref),
-        },
-    };
-}
-function normalizeLinkedTest(value) {
-    const test = {
-        command: value.command?.trim() || undefined,
-        path: value.path ? normalizePathValue(value.path) : undefined,
-        scope: value.scope,
-        timeout_seconds: typeof value.timeout_seconds === "number" &&
-            Number.isFinite(value.timeout_seconds) &&
-            value.timeout_seconds > 0
-            ? value.timeout_seconds
-            : undefined,
-        pm_context_mode: normalizeLinkedTestContextMode(value.pm_context_mode),
-        workspace_context_mode: normalizeLinkedTestWorkspaceContextMode(value.workspace_context_mode),
-        ...normalizeLinkedTestProvenance(value.provenance, value.provenance_invalid),
-        env_set: normalizeStringRecord(value.env_set),
-        env_clear: normalizeTrimmedStringList(value.env_clear),
-        shared_host_safe: value.shared_host_safe === true ? true : undefined,
-        assert_stdout_contains: normalizeTrimmedStringList(value.assert_stdout_contains),
-        assert_stdout_regex: normalizeTrimmedStringList(value.assert_stdout_regex),
-        assert_stderr_contains: normalizeTrimmedStringList(value.assert_stderr_contains),
-        assert_stderr_regex: normalizeTrimmedStringList(value.assert_stderr_regex),
-        assert_stdout_min_lines: normalizeNonNegativeInteger(value.assert_stdout_min_lines),
-        assert_json_field_equals: normalizeStringRecord(value.assert_json_field_equals),
-        assert_json_field_gte: normalizeNumericRecord(value.assert_json_field_gte),
-        note: value.note?.trim() || undefined,
-    };
-    deleteUndefinedFields(test);
-    return test;
-}
-function sortDocs(values) {
-    if (!values || values.length === 0)
-        return undefined;
-    return [...values]
-        .map((value) => ({
-        path: normalizePathValue(value.path),
-        scope: value.scope,
-        note: value.note?.trim() || undefined,
-    }))
-        .sort((a, b) => {
-        const byScope = a.scope.localeCompare(b.scope);
-        if (byScope !== 0)
-            return byScope;
-        const byPath = a.path.localeCompare(b.path);
-        if (byPath !== 0)
-            return byPath;
-        return (a.note ?? "").localeCompare(b.note ?? "");
-    });
-}
-function trimStringOrUndefined(value) {
-    if (typeof value !== "string")
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-function normalizePlanStepLinks(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const entry of value) {
-        if (entry === null || typeof entry !== "object")
-            continue;
-        const record = entry;
-        const id = trimStringOrUndefined(record.id);
-        const kind = trimStringOrUndefined(record.kind);
-        if (!id || !kind)
-            continue;
-        const link = { id, kind: kind };
-        const note = trimStringOrUndefined(record.note);
-        if (note)
-            link.note = note;
-        if (record.required_before_step === true)
-            link.required_before_step = true;
-        out.push(link);
-    }
-    return out.length > 0 ? out : undefined;
-}
-function normalizePlanStepFiles(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const entry of value) {
-        if (entry === null || typeof entry !== "object")
-            continue;
-        const record = entry;
-        const path = trimStringOrUndefined(record.path);
-        if (!path)
-            continue;
-        const file = { path: normalizePathValue(path) };
-        if (record.scope === "project" || record.scope === "global")
-            file.scope = record.scope;
-        const note = trimStringOrUndefined(record.note);
-        if (note)
-            file.note = note;
-        out.push(file);
-    }
-    return out.length > 0 ? out : undefined;
-}
-function normalizePlanStepTests(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const entry of value) {
-        if (entry === null || typeof entry !== "object")
-            continue;
-        const record = entry;
-        const command = trimStringOrUndefined(record.command);
-        const path = trimStringOrUndefined(record.path);
-        if (!command && !path)
-            continue;
-        const test = {};
-        if (command)
-            test.command = command;
-        if (path)
-            test.path = normalizePathValue(path);
-        const note = trimStringOrUndefined(record.note);
-        if (note)
-            test.note = note;
-        out.push(test);
-    }
-    return out.length > 0 ? out : undefined;
-}
-function normalizePlanStepDocs(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const entry of value) {
-        if (entry === null || typeof entry !== "object")
-            continue;
-        const record = entry;
-        const path = trimStringOrUndefined(record.path);
-        if (!path)
-            continue;
-        const doc = { path: normalizePathValue(path) };
-        if (record.scope === "project" || record.scope === "global")
-            doc.scope = record.scope;
-        const note = trimStringOrUndefined(record.note);
-        if (note)
-            doc.note = note;
-        out.push(doc);
-    }
-    return out.length > 0 ? out : undefined;
-}
-function normalizePlanStepEntry(entry) {
-    if (entry === null || typeof entry !== "object") {
-        return undefined;
-    }
-    const record = entry;
-    const id = trimStringOrUndefined(record.id);
-    const title = trimStringOrUndefined(record.title);
-    const statusRaw = trimStringOrUndefined(record.status);
-    const status = statusRaw && PLAN_STEP_STATUS_SET.has(statusRaw)
-        ? statusRaw
-        : undefined;
-    const order = coerceFiniteNumber(record.order) ?? Number.NaN;
-    const created_at = typeof record.created_at === "string" ? record.created_at : "";
-    const updated_at = typeof record.updated_at === "string" ? record.updated_at : "";
-    if (!id ||
-        !title ||
-        !status ||
-        !Number.isFinite(order) ||
-        !created_at ||
-        !updated_at) {
-        return undefined;
-    }
-    const step = {
-        id,
-        order,
-        title,
-        status,
-        created_at,
-        updated_at,
-    };
-    applyPlanStepOptionalFields(step, record);
-    return step;
-}
-function applyPlanStepOptionalFields(step, record) {
-    const stringFields = [
-        ["body", "body"],
-        ["owner", "owner"],
-        ["evidence", "evidence"],
-        ["blocked_reason", "blocked_reason"],
-        ["superseded_by", "superseded_by"],
-    ];
-    for (const [target, source] of stringFields) {
-        const value = trimStringOrUndefined(record[source]);
-        if (value) {
-            step[target] = value;
-        }
-    }
-    const completedAt = typeof record.completed_at === "string" ? record.completed_at : undefined;
-    if (completedAt && completedAt.length > 0) {
-        step.completed_at = completedAt;
-    }
-    const collectionFields = [
-        ["linked_items", "linked_items", normalizePlanStepLinks],
-        ["files", "files", normalizePlanStepFiles],
-        ["tests", "tests", normalizePlanStepTests],
-        ["docs", "docs", normalizePlanStepDocs],
-    ];
-    for (const [target, source, normalize] of collectionFields) {
-        const value = normalize(record[source]);
-        if (value) {
-            step[target] = value;
-        }
-    }
-}
-function normalizePlanSteps(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = value.flatMap((entry) => {
-        const step = normalizePlanStepEntry(entry);
-        return step ? [step] : [];
-    });
-    out.sort((left, right) => left.order - right.order);
-    return out.length > 0 ? out : undefined;
-}
-function normalizePlanDecisions(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const entry of value) {
-        if (entry === null || typeof entry !== "object")
-            continue;
-        const record = entry;
-        const ts = typeof record.ts === "string" ? record.ts : "";
-        const author = typeof record.author === "string" ? record.author : "";
-        const decision = trimStringOrUndefined(record.decision);
-        if (!ts || !author || !decision)
-            continue;
-        const item = { ts, author, decision };
-        const rationale = trimStringOrUndefined(record.rationale);
-        if (rationale)
-            item.rationale = rationale;
-        const evidence = trimStringOrUndefined(record.evidence);
-        if (evidence)
-            item.evidence = evidence;
-        const stepId = trimStringOrUndefined(record.step_id);
-        if (stepId)
-            item.step_id = stepId;
-        out.push(item);
-    }
-    return out.length > 0 ? out : undefined;
-}
-function normalizePlanDiscoveries(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const entry of value) {
-        if (entry === null || typeof entry !== "object")
-            continue;
-        const record = entry;
-        const ts = typeof record.ts === "string" ? record.ts : "";
-        const author = typeof record.author === "string" ? record.author : "";
-        const text = trimStringOrUndefined(record.text);
-        if (!ts || !author || !text)
-            continue;
-        const item = { ts, author, text };
-        const stepId = trimStringOrUndefined(record.step_id);
-        if (stepId)
-            item.step_id = stepId;
-        out.push(item);
-    }
-    return out.length > 0 ? out : undefined;
-}
-function normalizePlanValidation(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const entry of value) {
-        if (entry === null || typeof entry !== "object")
-            continue;
-        const record = entry;
-        const text = trimStringOrUndefined(record.text);
-        if (!text)
-            continue;
-        const item = { text };
-        const command = trimStringOrUndefined(record.command);
-        if (command)
-            item.command = command;
-        const expected = trimStringOrUndefined(record.expected);
-        if (expected)
-            item.expected = expected;
-        out.push(item);
-    }
-    return out.length > 0 ? out : undefined;
-}
-function normalizeTypeOptions(values) {
-    if (!values) {
-        return undefined;
-    }
-    const normalizedEntries = Object.entries(values)
-        .map(([key, value]) => [key.trim(), value.trim()])
-        .filter(([key, value]) => key.length > 0 && value.length > 0)
-        .sort((left, right) => left[0].localeCompare(right[0]));
-    if (normalizedEntries.length === 0) {
-        return undefined;
-    }
-    return Object.fromEntries(normalizedEntries);
-}
-function normalizeBody(body) {
-    let start = 0;
-    while (start < body.length && body[start] === "\n") {
-        start += 1;
-    }
-    return body.slice(start).trimEnd();
-}
-function normalizeConfidenceValue(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value === "number") {
-        return value;
-    }
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "med") {
-        return "medium";
-    }
-    if (CONFIDENCE_TEXT_VALUES.includes(normalized)) {
-        return normalized;
-    }
-    return undefined;
-}
-function normalizeSeverityValue(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "med") {
-        return "medium";
-    }
-    if (ISSUE_SEVERITY_VALUES.includes(normalized)) {
-        return normalized;
-    }
-    return undefined;
-}
-function emptyStringToUndefined(value) {
-    return value || undefined;
-}
-function copyExtensionItemMetadataFields(normalized, source) {
-    const targetRecord = normalized;
-    const sourceRecord = source;
-    for (const [key, value] of Object.entries(sourceRecord)) {
-        if (isUnsafeObjectKey(key) ||
-            Object.prototype.hasOwnProperty.call(targetRecord, key) ||
-            value === undefined) {
-            continue;
-        }
-        targetRecord[key] = value;
-    }
-}
-function coerceNormalizedRuntimeFields(normalized, runtimeContext) {
-    if (!runtimeContext?.fieldRegistry) {
-        return;
-    }
-    const record = normalized;
-    for (const definition of runtimeContext.fieldRegistry.definitions) {
-        const currentValue = record[definition.metadata_key];
-        if (currentValue === undefined) {
-            continue;
-        }
-        record[definition.metadata_key] = coerceRuntimeFieldValue(definition, currentValue, `metadata field "${definition.metadata_key}"`);
-    }
-}
-function assertNormalizedUnknownFields(normalized, runtimeContext) {
-    if (!runtimeContext || runtimeContext.unknownFieldPolicy === "allow") {
-        return;
-    }
-    const knownKeys = buildKnownItemMetadataKeys(runtimeContext);
-    const record = normalized;
-    const unknownKeys = Object.keys(record)
-        .filter((key) => !knownKeys.has(key))
-        .sort((left, right) => left.localeCompare(right));
-    if (unknownKeys.length > 0 &&
-        runtimeContext.unknownFieldPolicy === "reject") {
-        validationError(`unknown schema fields are not allowed: ${unknownKeys.join(", ")}`);
-    }
-    if (unknownKeys.length > 0) {
-        runtimeContext.onWarning?.(`item_unknown_schema_fields:${unknownKeys.join(",")}`);
-    }
-}
-/** Implements normalize item metadata for the public runtime surface of this module. */
-export function normalizeItemMetadata(itemMetadata, options = {}) {
-    const runtimeContext = resolveRuntimeSchemaValidationContext(options);
-    const normalizedStatus = normalizeStatusInput(itemMetadata.status, runtimeContext?.statusRegistry) ??
-        itemMetadata.status;
-    const tags = Array.from(new Set((Array.isArray(itemMetadata.tags) ? itemMetadata.tags : [])
-        .filter((tag) => typeof tag === "string")
-        .map((tag) => tag.trim().toLowerCase())
-        .filter(Boolean))).sort((a, b) => a.localeCompare(b));
-    const normalized = {
-        id: itemMetadata.id,
-        title: itemMetadata.title,
-        description: itemMetadata.description,
-        type: itemMetadata.type,
-        pm_format_version: normalizeItemFormatVersion(itemMetadata.pm_format_version),
-        source_type: trimStringOrUndefined(itemMetadata.source_type),
-        type_options: normalizeTypeOptions(itemMetadata.type_options),
-        status: normalizedStatus,
-        priority: itemMetadata.priority,
-        tags,
-        created_at: itemMetadata.created_at,
-        updated_at: itemMetadata.updated_at,
-        dependencies: sortDependencies(itemMetadata.dependencies),
-        comments: sortLogValues(itemMetadata.comments),
-        notes: sortLogValues(itemMetadata.notes),
-        learnings: sortLogValues(itemMetadata.learnings),
-        files: normalizeFiles(itemMetadata.files),
-        tests: sortTests(itemMetadata.tests),
-        test_runs: normalizeTestRunSummaries(itemMetadata.test_runs),
-        docs: sortDocs(itemMetadata.docs),
-        deadline: emptyStringToUndefined(itemMetadata.deadline),
-        reminders: sortReminders(itemMetadata.reminders),
-        events: sortEvents(itemMetadata.events),
-        closed_at: emptyStringToUndefined(itemMetadata.closed_at),
-        completed_at: emptyStringToUndefined(itemMetadata.completed_at),
-        assignee: trimStringOrUndefined(itemMetadata.assignee),
-        claim_principal: trimStringOrUndefined(itemMetadata.claim_principal),
-        source_owner: trimStringOrUndefined(itemMetadata.source_owner),
-        author: emptyStringToUndefined(itemMetadata.author),
-        estimated_minutes: itemMetadata.estimated_minutes,
-        acceptance_criteria: itemMetadata.acceptance_criteria ?? undefined,
-        design: itemMetadata.design ?? undefined,
-        external_ref: itemMetadata.external_ref ?? undefined,
-        definition_of_ready: trimStringOrUndefined(itemMetadata.definition_of_ready),
-        order: itemMetadata.order,
-        goal: trimStringOrUndefined(itemMetadata.goal),
-        objective: trimStringOrUndefined(itemMetadata.objective),
-        value: trimStringOrUndefined(itemMetadata.value),
-        impact: trimStringOrUndefined(itemMetadata.impact),
-        outcome: trimStringOrUndefined(itemMetadata.outcome),
-        why_now: trimStringOrUndefined(itemMetadata.why_now),
-        parent: trimStringOrUndefined(itemMetadata.parent),
-        reviewer: trimStringOrUndefined(itemMetadata.reviewer),
-        risk: itemMetadata.risk ?? undefined,
-        confidence: normalizeConfidenceValue(itemMetadata.confidence),
-        sprint: trimStringOrUndefined(itemMetadata.sprint),
-        release: trimStringOrUndefined(itemMetadata.release),
-        blocked_by: trimStringOrUndefined(itemMetadata.blocked_by),
-        blocked_reason: trimStringOrUndefined(itemMetadata.blocked_reason),
-        unblock_note: trimStringOrUndefined(itemMetadata.unblock_note),
-        reporter: trimStringOrUndefined(itemMetadata.reporter),
-        severity: normalizeSeverityValue(itemMetadata.severity),
-        environment: trimStringOrUndefined(itemMetadata.environment),
-        repro_steps: trimStringOrUndefined(itemMetadata.repro_steps),
-        resolution: trimStringOrUndefined(itemMetadata.resolution),
-        expected_result: trimStringOrUndefined(itemMetadata.expected_result),
-        actual_result: trimStringOrUndefined(itemMetadata.actual_result),
-        affected_version: trimStringOrUndefined(itemMetadata.affected_version),
-        fixed_version: trimStringOrUndefined(itemMetadata.fixed_version),
-        component: trimStringOrUndefined(itemMetadata.component),
-        regression: itemMetadata.regression,
-        customer_impact: trimStringOrUndefined(itemMetadata.customer_impact),
-        close_reason: emptyStringToUndefined(itemMetadata.close_reason),
-        plan_mode: trimStringOrUndefined(itemMetadata.plan_mode),
-        plan_scope: trimStringOrUndefined(itemMetadata.plan_scope),
-        plan_harness: trimStringOrUndefined(itemMetadata.plan_harness),
-        plan_resume_context: trimStringOrUndefined(itemMetadata.plan_resume_context),
-        plan_steps: normalizePlanSteps(itemMetadata.plan_steps),
-        plan_decisions: normalizePlanDecisions(itemMetadata.plan_decisions),
-        plan_discoveries: normalizePlanDiscoveries(itemMetadata.plan_discoveries),
-        plan_validation: normalizePlanValidation(itemMetadata.plan_validation),
-    };
-    copyExtensionItemMetadataFields(normalized, itemMetadata);
-    coerceNormalizedRuntimeFields(normalized, runtimeContext);
-    assertNormalizedUnknownFields(normalized, runtimeContext);
-    deleteUndefinedFields(normalized);
-    return normalized;
-}
-function orderItemMetadata(itemMetadata) {
-    return orderObject(itemMetadata, ITEM_METADATA_KEY_ORDER);
-}
-function findJsonObjectEnd(content) {
-    let depth = 0;
-    let inString = false;
-    let escaped = false;
-    for (let i = 0; i < content.length; i += 1) {
-        const char = content[i];
-        if (inString) {
-            if (escaped) {
-                escaped = false;
-                continue;
-            }
-            if (char === "\\") {
-                escaped = true;
-                continue;
-            }
-            if (char === '"') {
-                inString = false;
-            }
-            continue;
-        }
-        if (char === '"') {
-            inString = true;
-            continue;
-        }
-        if (char === "{") {
-            depth += 1;
-            continue;
-        }
-        if (char === "}") {
-            depth -= 1;
-            if (depth === 0) {
-                return i;
-            }
-        }
-    }
-    return -1;
-}
-/** Implements split front matter for the public runtime surface of this module. */
-export function splitFrontMatter(content) {
-    if (!content.startsWith("{")) {
-        return { frontMatter: "", body: content };
-    }
-    const end = findJsonObjectEnd(content);
-    if (end < 0) {
-        return { frontMatter: "", body: content };
-    }
-    const frontMatter = content.slice(0, end + 1);
-    const body = content.slice(end + 1).replace(/^\r?\n+/, "");
-    return { frontMatter, body };
-}
-function stripLeadingYamlDocument(content) {
-    const normalizedContent = content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;
-    const opener = normalizedContent.match(/^[ \t]*---[ \t]*(?:\r?\n|$)/);
-    if (!opener) {
-        return { content: normalizedContent, stripped: false };
-    }
-    let cursor = opener[0].length;
-    while (cursor < normalizedContent.length) {
-        const nextNewline = normalizedContent.indexOf("\n", cursor);
-        const lineEnd = nextNewline === -1 ? normalizedContent.length : nextNewline;
-        const line = normalizedContent.slice(cursor, lineEnd).replace(/\r$/, "");
-        const afterLine = nextNewline === -1 ? lineEnd : lineEnd + 1;
-        if (line.trim() === "---") {
-            return {
-                content: normalizedContent.slice(afterLine).replace(/^\s+/, ""),
-                stripped: true,
-            };
-        }
-        cursor = afterLine;
-    }
-    return { content: normalizedContent, stripped: false };
-}
-function normalizeParsedItemMetadata(itemMetadata, options) {
-    return normalizeItemMetadata(itemMetadata, {
-        ...options,
-        onWarning: undefined,
-    });
-}
-function parseJsonMarkdownItemDocument(content, runtimeContext, options = {}) {
-    const normalized = stripLeadingYamlDocument(content);
-    if (normalized.stripped) {
-        options.onWarning?.("json_markdown_leading_yaml_frontmatter_ignored");
-    }
-    const { frontMatter, body } = splitFrontMatter(normalized.content);
-    if (!frontMatter) {
-        const trimmed = content.trimStart();
-        if (trimmed.startsWith("{")) {
-            documentSyntaxError("json_markdown", "JSON front matter is not valid JSON");
-        }
-        documentSyntaxError("json_markdown", "JSON Markdown item document is missing JSON front matter");
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(frontMatter);
-    }
-    catch {
-        documentSyntaxError("json_markdown", "JSON front matter is not valid JSON");
-    }
-    assertValidItemMetadata(parsed, runtimeContext);
-    return {
-        metadata: normalizeParsedItemMetadata(parsed, options),
-        body: normalizeBody(body),
-    };
-}
-function parseToonItemDocument(content, runtimeContext, options = {}) {
-    let parsed;
-    try {
-        // decodeToonItemContent transparently recovers documents that the upstream
-        // strict decoder rejects (bracketed-token-then-colon inside a quoted value;
-        // see toon-decode.ts). The recovery is lossless, so it stays silent rather
-        // than emitting a per-read warning that would perpetually flip pm health
-        // red for legacy files. The behavior is pinned by toon-decode.spec.ts.
-        parsed = decodeToonItemContent(content).value;
-    }
-    catch {
-        documentSyntaxError("toon", "TOON item document is not valid TOON");
-    }
-    assertItemMetadataCondition(typeof parsed === "object" && parsed !== null && !Array.isArray(parsed), "TOON item document must be an object");
-    const record = parsed;
-    if (!REQUIRED_STRING_FIELDS.some((fieldName) => Object.prototype.hasOwnProperty.call(record, fieldName)) &&
-        !Object.prototype.hasOwnProperty.call(record, "front_matter")) {
-        documentSyntaxError("toon", "TOON input does not have the shape of an item document");
-    }
-    if (Object.prototype.hasOwnProperty.call(record, "front_matter")) {
-        assertValidItemMetadata(record.front_matter, runtimeContext);
-        assertItemMetadataCondition(record.body === undefined || typeof record.body === "string", "TOON item document body must be a string");
-        return {
-            metadata: normalizeParsedItemMetadata(record.front_matter, options),
-            body: normalizeBody(typeof record.body === "string" ? record.body : ""),
-        };
-    }
-    const { body, ...itemMetadataRecord } = record;
-    assertItemMetadataCondition(body === undefined || typeof body === "string", "TOON item document body must be a string");
-    assertValidItemMetadata(itemMetadataRecord, runtimeContext);
-    return {
-        metadata: normalizeParsedItemMetadata(itemMetadataRecord, options),
-        body: normalizeBody(typeof body === "string" ? body : ""),
-    };
-}
-function serializeJsonMarkdownItemDocument(document, options = {}) {
-    const normalizedMetadata = normalizeItemMetadata(document.metadata, options);
-    const orderedMetadata = orderItemMetadata(normalizedMetadata);
-    const serializedMetadata = JSON.stringify(orderedMetadata, null, 2);
-    const normalizedBody = normalizeBody(document.body ?? "");
-    if (!normalizedBody) {
-        return `${serializedMetadata}\n`;
-    }
-    return `${serializedMetadata}\n\n${normalizedBody}\n`;
-}
-function serializeToonItemDocument(document, options = {}) {
-    const normalizedMetadata = normalizeItemMetadata(document.metadata, options);
-    const orderedMetadata = orderItemMetadata(normalizedMetadata);
-    const normalizedBody = normalizeBody(document.body ?? "");
-    const payload = {
-        ...orderedMetadata,
-        body: normalizedBody,
-    };
-    const encodablePayload = JSON.parse(JSON.stringify(payload));
-    const serialized = encodeToon(encodablePayload);
-    let decoded;
-    try {
-        decoded = decodeToonItemContent(serialized).value;
-    }
-    catch (error) {
-        throw new PmCliError("Refusing to persist a TOON item document that the configured decoder cannot read back.", EXIT_CODE.GENERIC_FAILURE, {
-            code: "item_document_roundtrip_failed",
-            reason: "encode_decode_error",
-            format: "toon",
-            required: "Upgrade or repair the TOON codec before retrying the mutation; no item bytes were written.",
-            why: error instanceof Error ? error.message : String(error),
-        });
-    }
-    if (!isDeepStrictEqual(decoded, encodablePayload)) {
-        const decodedRecord = typeof decoded === "object" && decoded !== null && !Array.isArray(decoded)
-            ? decoded
-            : {};
-        const field = Object.keys(encodablePayload).find((key) => !isDeepStrictEqual(encodablePayload[key], decodedRecord[key])) ?? "document";
-        throw new PmCliError(`Refusing to persist a lossy TOON item document; round-trip mismatch at field "${field}".`, EXIT_CODE.GENERIC_FAILURE, {
-            code: "item_document_roundtrip_failed",
-            reason: "encode_decode_mismatch",
-            format: "toon",
-            field,
-            required: "Upgrade or repair the TOON codec before retrying the mutation; no item bytes were written.",
-            why: "The encoded document decoded to a value different from the canonical item payload.",
-        });
-    }
-    return `${serialized}\n`;
-}
-/** Implements parse item document for the public runtime surface of this module. */
-export function parseItemDocument(content, options = {}) {
-    const conflictMarker = findFirstMergeConflictMarker(content);
-    if (conflictMarker) {
-        throw new PmCliError(`Merge conflict markers detected in item document at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`, EXIT_CODE.GENERIC_FAILURE, {
-            code: "merge_conflict_markers_detected",
-            reason: "merge_conflict",
-            required: "Resolve merge-conflict markers in the item file before parsing or mutation commands.",
-            why: "Partially merged documents can corrupt item metadata and history integrity.",
-            examples: ["git status", "git add <resolved-file> && git commit"],
-            nextSteps: [
-                "Resolve conflicts, save the file, then rerun the pm command.",
-            ],
-        });
-    }
-    const format = options.format ?? "toon";
-    const runtimeContext = resolveRuntimeSchemaValidationContext(options);
-    return format === "toon"
-        ? parseToonItemDocument(content, runtimeContext, options)
-        : parseJsonMarkdownItemDocument(content, runtimeContext, options);
-}
-/** Implements serialize item document for the public runtime surface of this module. */
-export function serializeItemDocument(document, options = {}) {
-    const format = options.format ?? "toon";
-    return format === "toon"
-        ? serializeToonItemDocument(document, options)
-        : serializeJsonMarkdownItemDocument(document, options);
-}
-/** Implements canonical document for the public runtime surface of this module. */
-export function canonicalDocument(document, options = {}) {
-    return {
-        metadata: normalizeItemMetadata(document.metadata, options),
-        body: normalizeBody(document.body ?? ""),
-    };
-}
-/** Public contract for test only item format, shared by SDK and presentation-layer consumers. */
-export const _testOnlyItemFormat = {
-    buildKnownItemMetadataKeys,
-    firstNonZeroComparison,
-    normalizeBody,
-    normalizePlanDecisions,
-    normalizePlanDiscoveries,
-    normalizePlanStepDocs,
-    normalizePlanStepFiles,
-    normalizePlanStepLinks,
-    normalizePlanSteps,
-    normalizePlanStepTests,
-    normalizePlanValidation,
-    normalizeTestRunSummaries,
-    normalizeTypeOptions,
-    runtimeFieldRequiredForType,
-    sortTests,
-};
+${normalizedBody}
+`}function serializeToonItemDocument(document,options={}){const normalizedMetadata=normalizeItemMetadata(document.metadata,options);const orderedMetadata=orderItemMetadata(normalizedMetadata);const normalizedBody=normalizeBody(document.body??"");const payload={...orderedMetadata,body:normalizedBody};const encodablePayload=JSON.parse(JSON.stringify(payload));const serialized=encodeToon(encodablePayload);let decoded;try{decoded=decodeToonItemContent(serialized).value}catch(error){throw new PmCliError("Refusing to persist a TOON item document that the configured decoder cannot read back.",EXIT_CODE.GENERIC_FAILURE,{code:"item_document_roundtrip_failed",reason:"encode_decode_error",format:"toon",required:"Upgrade or repair the TOON codec before retrying the mutation; no item bytes were written.",why:error instanceof Error?error.message:String(error)})}if(!isDeepStrictEqual(decoded,encodablePayload)){const decodedRecord=typeof decoded==="object"&&decoded!==null&&!Array.isArray(decoded)?decoded:{};const field=Object.keys(encodablePayload).find(key=>!isDeepStrictEqual(encodablePayload[key],decodedRecord[key]))??"document";throw new PmCliError(`Refusing to persist a lossy TOON item document; round-trip mismatch at field "${field}".`,EXIT_CODE.GENERIC_FAILURE,{code:"item_document_roundtrip_failed",reason:"encode_decode_mismatch",format:"toon",field,required:"Upgrade or repair the TOON codec before retrying the mutation; no item bytes were written.",why:"The encoded document decoded to a value different from the canonical item payload."})}return`${serialized}
+`}function parseItemDocument(content,options={}){const conflictMarker=findFirstMergeConflictMarker(content);if(conflictMarker){throw new PmCliError(`Merge conflict markers detected in item document at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`,EXIT_CODE.GENERIC_FAILURE,{code:"merge_conflict_markers_detected",reason:"merge_conflict",required:"Resolve merge-conflict markers in the item file before parsing or mutation commands.",why:"Partially merged documents can corrupt item metadata and history integrity.",examples:["git status","git add <resolved-file> && git commit"],nextSteps:["Resolve conflicts, save the file, then rerun the pm command."]})}const format=options.format??"toon";const runtimeContext=resolveRuntimeSchemaValidationContext(options);return format==="toon"?parseToonItemDocument(content,runtimeContext,options):parseJsonMarkdownItemDocument(content,runtimeContext,options)}function serializeItemDocument(document,options={}){const format=options.format??"toon";return format==="toon"?serializeToonItemDocument(document,options):serializeJsonMarkdownItemDocument(document,options)}function canonicalDocument(document,options={}){return{metadata:normalizeItemMetadata(document.metadata,options),body:normalizeBody(document.body??"")}}const _testOnlyItemFormat={buildKnownItemMetadataKeys,firstNonZeroComparison,normalizeBody,normalizePlanDecisions,normalizePlanDiscoveries,normalizePlanStepDocs,normalizePlanStepFiles,normalizePlanStepLinks,normalizePlanSteps,normalizePlanStepTests,normalizePlanValidation,normalizeTestRunSummaries,normalizeTypeOptions,runtimeFieldRequiredForType,sortTests};export{_testOnlyItemFormat,canonicalDocument,normalizeItemMetadata,parseItemDocument,serializeItemDocument,splitFrontMatter};
 //# sourceMappingURL=item-format.js.map
-//# debugId=051655a4-8ba7-5118-9758-d9ca377fa7e4