@unbrained/pm-cli 2026.6.12 → 2026.6.16

package/dist/cli-bundle/chunks/{chunk-A6LXQFO7.js → chunk-KTVETP66.js}

@@ -1,6 +1,6 @@
 // dist/core/fs/fs-utils.js
 
-!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]="3d81dd28-0239-582e-84cb-25d9dea99250")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="62f87b11-f1bc-5f90-bc91-0e81dfdebb55")}catch(e){}}();
 import * as fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -269,6 +269,7 @@ var DEFAULT_WORKFLOW_DEFINITION = Object.freeze({
 });
 var PM_DIRNAME = ".agents/pm";
 var SETTINGS_FILENAME = "settings.json";
+var CREATE_DIRECT_CLOSE_REASON_DEFAULT = "Closed at creation via pm create";
 var PM_CORE_REQUIRED_SUBDIRS = [
   "",
   "epics",
@@ -444,7 +445,8 @@ var SETTINGS_DEFAULTS = {
     lifecycle_closure_like_resolution_patterns: [...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.resolution],
     lifecycle_closure_like_actual_result_patterns: [
       ...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.actual_result
-    ]
+    ],
+    estimate_defaults_by_type: {}
   },
   governance: {
     preset: "minimal",
@@ -811,155 +813,6 @@ function asRecordLoose(value) {
   return value;
 }
 
-// dist/core/extensions/extension-capability-aliases.js
-function normalizeNames(values) {
-  return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((a, b) => a.localeCompare(b));
-}
-function isKnownExtensionCapability(value) {
-  return KNOWN_EXTENSION_CAPABILITIES.includes(value);
-}
-function collectUnknownExtensionCapabilities(capabilities) {
-  return capabilities.filter((capability) => !isKnownExtensionCapability(capability));
-}
-function resolveLegacyExtensionCapabilityAlias(capability) {
-  const normalized = capability.trim().toLowerCase();
-  if (normalized.length === 0) {
-    return null;
-  }
-  return EXTENSION_CAPABILITY_LEGACY_ALIASES[normalized] ?? null;
-}
-function normalizeManifestCapabilities(rawCapabilities) {
-  const normalizedCapabilities = normalizeNames([...rawCapabilities].map((value) => value.toLowerCase()));
-  const remappedCapabilities = [];
-  const legacyAliases = [];
-  for (const capability of normalizedCapabilities) {
-    const legacyAliasTarget = resolveLegacyExtensionCapabilityAlias(capability);
-    if (legacyAliasTarget) {
-      remappedCapabilities.push(legacyAliasTarget);
-      legacyAliases.push({
-        alias: capability,
-        target: legacyAliasTarget
-      });
-      continue;
-    }
-    remappedCapabilities.push(capability);
-  }
-  const dedupedLegacyAliases = [...new Map(legacyAliases.map((entry) => [`${entry.alias}>${entry.target}`, entry])).values()].sort((left, right) => left.alias.localeCompare(right.alias));
-  return {
-    capabilities: normalizeNames(remappedCapabilities),
-    legacy_aliases: dedupedLegacyAliases
-  };
-}
-function levenshteinDistance(left, right) {
-  if (left === right) {
-    return 0;
-  }
-  if (left.length === 0) {
-    return right.length;
-  }
-  if (right.length === 0) {
-    return left.length;
-  }
-  const previous = new Array(right.length + 1);
-  const current = new Array(right.length + 1);
-  for (let j = 0; j <= right.length; j += 1) {
-    previous[j] = j;
-  }
-  for (let i = 1; i <= left.length; i += 1) {
-    current[0] = i;
-    for (let j = 1; j <= right.length; j += 1) {
-      const substitutionCost = left[i - 1] === right[j - 1] ? 0 : 1;
-      current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + substitutionCost);
-    }
-    for (let j = 0; j <= right.length; j += 1) {
-      previous[j] = current[j];
-    }
-  }
-  return previous[right.length] ?? left.length;
-}
-function suggestKnownExtensionCapability(capability) {
-  const normalized = capability.trim().toLowerCase();
-  if (normalized.length === 0) {
-    return null;
-  }
-  const legacyAlias = resolveLegacyExtensionCapabilityAlias(normalized);
-  if (legacyAlias) {
-    return legacyAlias;
-  }
-  let bestMatch = null;
-  let bestDistance = Number.POSITIVE_INFINITY;
-  for (const candidate of KNOWN_EXTENSION_CAPABILITIES) {
-    const distance = levenshteinDistance(normalized, candidate);
-    if (distance < bestDistance) {
-      bestDistance = distance;
-      bestMatch = candidate;
-    }
-  }
-  const maxDistance = Math.max(1, Math.floor(normalized.length * 0.34));
-  return bestMatch !== null && bestDistance <= maxDistance ? bestMatch : null;
-}
-function formatUnknownExtensionCapabilityWarning(layer, name, capability) {
-  const allowed = KNOWN_EXTENSION_CAPABILITIES.join(",");
-  const suggested = suggestKnownExtensionCapability(capability) ?? "none";
-  return `extension_capability_unknown:${layer}:${name}:${capability}:allowed=${allowed}:suggested=${suggested}`;
-}
-function formatLegacyExtensionCapabilityAliasWarning(layer, name, aliases) {
-  const aliasesToken = aliases.map((entry) => `${entry.alias}>${entry.target}`).join(",");
-  return `extension_capability_legacy_alias:${layer}:${name}:aliases=${aliasesToken}`;
-}
-function parseUnknownExtensionCapabilityWarning(warning) {
-  const match = /^extension_capability_unknown:(global|project):([^:]+):([^:]+):allowed=([^:]+):suggested=([^:]+)$/.exec(warning.trim());
-  if (!match) {
-    return null;
-  }
-  const [, layerRaw, name, capability, allowedRaw, suggestedRaw] = match;
-  const layer = layerRaw;
-  const allowed_capabilities = allowedRaw.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
-  const legacyAlias = resolveLegacyExtensionCapabilityAlias(capability);
-  const suggestedFromWarning = suggestedRaw === "none" ? void 0 : suggestedRaw;
-  const suggested_capability = suggestedFromWarning ?? legacyAlias ?? void 0;
-  const suggestion_source = suggested_capability ? legacyAlias === suggested_capability ? "legacy_alias" : "nearest_match" : void 0;
-  return {
-    layer,
-    name,
-    capability,
-    allowed_capabilities,
-    capability_contract_version: EXTENSION_CAPABILITY_CONTRACT_VERSION,
-    suggested_capability,
-    suggestion_source,
-    legacy_alias_target: legacyAlias ?? void 0
-  };
-}
-function parseLegacyExtensionCapabilityAliasWarning(warning) {
-  const match = /^extension_capability_legacy_alias:(global|project):([^:]+):aliases=(.+)$/.exec(warning.trim());
-  if (!match) {
-    return [];
-  }
-  const [, layerRaw, name, aliasesRaw] = match;
-  const layer = layerRaw;
-  const allowedCapabilities = [...KNOWN_EXTENSION_CAPABILITIES];
-  const parsed = [];
-  for (const token of aliasesRaw.split(",")) {
-    const [rawAlias, rawTarget] = token.split(">");
-    const alias = rawAlias?.trim();
-    const target = rawTarget?.trim().toLowerCase();
-    if (!alias || !target || !isKnownExtensionCapability(target)) {
-      continue;
-    }
-    parsed.push({
-      layer,
-      name,
-      capability: alias,
-      allowed_capabilities: allowedCapabilities,
-      capability_contract_version: EXTENSION_CAPABILITY_CONTRACT_VERSION,
-      suggested_capability: target,
-      suggestion_source: "legacy_alias",
-      legacy_alias_target: target
-    });
-  }
-  return parsed;
-}
-
 // dist/core/extensions/extension-registries.js
 function createEmptyExtensionHookRegistry() {
   return {
@@ -1548,6 +1401,128 @@ function suggestKnownItemFieldType(value) {
   return null;
 }
 
+// dist/core/extensions/extension-capability-aliases.js
+function normalizeNames(values) {
+  return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((a, b) => a.localeCompare(b));
+}
+function isKnownExtensionCapability(value) {
+  return KNOWN_EXTENSION_CAPABILITIES.includes(value);
+}
+function collectUnknownExtensionCapabilities(capabilities) {
+  return capabilities.filter((capability) => !isKnownExtensionCapability(capability));
+}
+function resolveLegacyExtensionCapabilityAlias(capability) {
+  const normalized = capability.trim().toLowerCase();
+  if (normalized.length === 0) {
+    return null;
+  }
+  return EXTENSION_CAPABILITY_LEGACY_ALIASES[normalized] ?? null;
+}
+function normalizeManifestCapabilities(rawCapabilities) {
+  const normalizedCapabilities = normalizeNames([...rawCapabilities].map((value) => value.toLowerCase()));
+  const remappedCapabilities = [];
+  const legacyAliases = [];
+  for (const capability of normalizedCapabilities) {
+    const legacyAliasTarget = resolveLegacyExtensionCapabilityAlias(capability);
+    if (legacyAliasTarget) {
+      remappedCapabilities.push(legacyAliasTarget);
+      legacyAliases.push({
+        alias: capability,
+        target: legacyAliasTarget
+      });
+      continue;
+    }
+    remappedCapabilities.push(capability);
+  }
+  const dedupedLegacyAliases = [...new Map(legacyAliases.map((entry) => [`${entry.alias}>${entry.target}`, entry])).values()].sort((left, right) => left.alias.localeCompare(right.alias));
+  return {
+    capabilities: normalizeNames(remappedCapabilities),
+    legacy_aliases: dedupedLegacyAliases
+  };
+}
+function suggestKnownExtensionCapability(capability) {
+  const normalized = capability.trim().toLowerCase();
+  if (normalized.length === 0) {
+    return null;
+  }
+  const legacyAlias = resolveLegacyExtensionCapabilityAlias(normalized);
+  if (legacyAlias) {
+    return legacyAlias;
+  }
+  const maxDistance = Math.max(1, Math.floor(normalized.length * 0.34));
+  let bestMatch = null;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const candidate of KNOWN_EXTENSION_CAPABILITIES) {
+    const distance = levenshteinDistanceWithinLimit(normalized, candidate, maxDistance);
+    if (distance !== null && distance < bestDistance) {
+      bestDistance = distance;
+      bestMatch = candidate;
+    }
+  }
+  return bestMatch;
+}
+function formatUnknownExtensionCapabilityWarning(layer, name, capability) {
+  const allowed = KNOWN_EXTENSION_CAPABILITIES.join(",");
+  const suggested = suggestKnownExtensionCapability(capability) ?? "none";
+  return `extension_capability_unknown:${layer}:${name}:${capability}:allowed=${allowed}:suggested=${suggested}`;
+}
+function formatLegacyExtensionCapabilityAliasWarning(layer, name, aliases) {
+  const aliasesToken = aliases.map((entry) => `${entry.alias}>${entry.target}`).join(",");
+  return `extension_capability_legacy_alias:${layer}:${name}:aliases=${aliasesToken}`;
+}
+function parseUnknownExtensionCapabilityWarning(warning) {
+  const match = /^extension_capability_unknown:(global|project):([^:]+):([^:]+):allowed=([^:]+):suggested=([^:]+)$/.exec(warning.trim());
+  if (!match) {
+    return null;
+  }
+  const [, layerRaw, name, capability, allowedRaw, suggestedRaw] = match;
+  const layer = layerRaw;
+  const allowed_capabilities = allowedRaw.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
+  const legacyAlias = resolveLegacyExtensionCapabilityAlias(capability);
+  const suggestedFromWarning = suggestedRaw === "none" ? void 0 : suggestedRaw;
+  const suggested_capability = suggestedFromWarning ?? legacyAlias ?? void 0;
+  const suggestion_source = suggested_capability ? legacyAlias === suggested_capability ? "legacy_alias" : "nearest_match" : void 0;
+  return {
+    layer,
+    name,
+    capability,
+    allowed_capabilities,
+    capability_contract_version: EXTENSION_CAPABILITY_CONTRACT_VERSION,
+    suggested_capability,
+    suggestion_source,
+    legacy_alias_target: legacyAlias ?? void 0
+  };
+}
+function parseLegacyExtensionCapabilityAliasWarning(warning) {
+  const match = /^extension_capability_legacy_alias:(global|project):([^:]+):aliases=(.+)$/.exec(warning.trim());
+  if (!match) {
+    return [];
+  }
+  const [, layerRaw, name, aliasesRaw] = match;
+  const layer = layerRaw;
+  const allowedCapabilities = [...KNOWN_EXTENSION_CAPABILITIES];
+  const parsed = [];
+  for (const token of aliasesRaw.split(",")) {
+    const [rawAlias, rawTarget] = token.split(">");
+    const alias = rawAlias?.trim();
+    const target = rawTarget?.trim().toLowerCase();
+    if (!alias || !target || !isKnownExtensionCapability(target)) {
+      continue;
+    }
+    parsed.push({
+      layer,
+      name,
+      capability: alias,
+      allowed_capabilities: allowedCapabilities,
+      capability_contract_version: EXTENSION_CAPABILITY_CONTRACT_VERSION,
+      suggested_capability: target,
+      suggestion_source: "legacy_alias",
+      legacy_alias_target: target
+    });
+  }
+  return parsed;
+}
+
 // dist/core/extensions/extension-policy.js
 function normalizePolicyName(value) {
   if (typeof value !== "string") {
@@ -1913,19 +1888,17 @@ function resolvePolicySandboxReason(policy, extension) {
     }
     return null;
   }
-  if (profile === "strict") {
-    if (hasPermission("process_spawn")) {
-      return "sandbox_strict_disallows_process_spawn";
-    }
-    if (hasPermission("network")) {
-      return "sandbox_strict_disallows_network";
-    }
-    if (hasPermission("fs_write")) {
-      return "sandbox_strict_disallows_fs_write";
-    }
-    if (hasPermission("env_write")) {
-      return "sandbox_strict_disallows_env_write";
-    }
+  if (hasPermission("process_spawn")) {
+    return "sandbox_strict_disallows_process_spawn";
+  }
+  if (hasPermission("network")) {
+    return "sandbox_strict_disallows_network";
+  }
+  if (hasPermission("fs_write")) {
+    return "sandbox_strict_disallows_fs_write";
+  }
+  if (hasPermission("env_write")) {
+    return "sandbox_strict_disallows_env_write";
   }
   return null;
 }
@@ -2284,7 +2257,7 @@ function summarizeCandidate(candidate) {
     permissions: candidate.manifest.permissions,
     capabilities: [...candidate.manifest.capabilities],
     activation: candidate.manifest.activation ? {
-      commands: [...candidate.manifest.activation.commands ?? []]
+      commands: [...candidate.manifest.activation.commands]
     } : void 0
   };
   if (candidate.source_package) {
@@ -2535,7 +2508,7 @@ function formatUnknownError(error) {
 }
 function parseComparableVersion(value) {
   const normalized = value.trim().replace(/^>=\s*/, "").replace(/^v/i, "");
-  const release = normalized.split(/[+-]/, 1)[0] ?? "";
+  const release = normalized.split(/[+-]/, 1)[0];
   if (!/^\d+(?:[.-]\d+)*$/.test(release)) {
     return null;
   }
@@ -2952,25 +2925,16 @@ function normalizeCommandDefinitionArguments(value) {
       definition.variadic = true;
     }
     if (typeof record.description === "string") {
-      const trimmedDescription = record.description.trim();
-      if (trimmedDescription.length > 0) {
-        definition.description = trimmedDescription;
-      }
+      definition.description = record.description.trim();
     }
     normalized.push(definition);
   }
-  let variadicCount = 0;
-  for (const [index, argument] of normalized.entries()) {
-    if (!argument.variadic) {
-      continue;
-    }
-    variadicCount += 1;
-    if (variadicCount > 1) {
-      throw new TypeError("registerCommand definition.arguments supports at most one variadic argument");
-    }
-    if (index !== normalized.length - 1) {
-      throw new TypeError("registerCommand definition.arguments variadic argument must be the final argument");
-    }
+  const variadicIndexes = normalized.map((argument, index) => argument.variadic ? index : -1).filter((index) => index >= 0);
+  if (variadicIndexes.length > 1) {
+    throw new TypeError("registerCommand definition.arguments supports at most one variadic argument");
+  }
+  if (variadicIndexes.length === 1 && variadicIndexes[0] !== normalized.length - 1) {
+    throw new TypeError("registerCommand definition.arguments variadic argument must be the final argument");
   }
   return normalized;
 }
@@ -3124,7 +3088,7 @@ function assertExtensionCapability(extension, capability, method) {
       capability,
       missing_capability: capability,
       expected_schema: `"capabilities": [..., "${capability}"]`,
-      received: extension.capabilities ?? [],
+      received: extension.capabilities,
       hint: `Add "${capability}" to ${extension.name} manifest capabilities, or remove the ${method} registration call.`
     });
   }
@@ -3255,7 +3219,7 @@ function createExtensionApi(extension, hooks, commands, parsers, preflight, serv
       }
       registrations.commands.push(registration);
     } catch (error) {
-      const reason = error instanceof Error ? error.message : "registerCommand definition validation failed";
+      const reason = formatUnknownError(error);
       const trace = registerCommandTrace("definition", normalizedCommand, "{ name: string; run: (context) => unknown; action?: string; arguments?: object[]; flags?: object[]; }", commandOrDefinition, "Use schema-style metadata (action/arguments/flags/examples/intent) with valid values.");
       throw createRegistrationValidationError(`registerCommand definition metadata invalid (command="${normalizedCommand}", registration_index=${trace.registration_index}): ${reason}`, trace);
     }
@@ -3630,7 +3594,7 @@ function collectCommandCollisionWarnings(commands) {
       grouped.set(entry.command, bucket);
     }
     for (const command of [...grouped.keys()].sort((left, right) => left.localeCompare(right))) {
-      const bucket = grouped.get(command) ?? [];
+      const bucket = grouped.get(command);
       if (bucket.length <= 1) {
         continue;
       }
@@ -3643,7 +3607,8 @@ function collectCommandCollisionWarnings(commands) {
   collectByCommand(commands.handlers, "extension_command_handler_collision");
   collectByCommand(commands.overrides, "extension_command_override_collision");
   const handlerCommands = new Set(commands.handlers.map((entry) => entry.command));
-  const overlapCommands = [...new Set(commands.overrides.map((entry) => entry.command))].filter((command) => handlerCommands.has(command)).sort((left, right) => left.localeCompare(right));
+  const overlapCommands = [...new Set(commands.overrides.map((entry) => entry.command))].filter((command) => handlerCommands.has(command));
+  overlapCommands.sort((left, right) => left.localeCompare(right));
   for (const command of overlapCommands) {
     const handlers = commands.handlers.filter((entry) => entry.command === command);
     const overrides = commands.overrides.filter((entry) => entry.command === command);
@@ -3664,7 +3629,7 @@ function collectRendererCollisionWarnings(renderers) {
   }
   const warnings = [];
   for (const format of [...grouped.keys()].sort((left, right) => left.localeCompare(right))) {
-    const bucket = grouped.get(format) ?? [];
+    const bucket = grouped.get(format);
     if (bucket.length <= 1) {
       continue;
     }
@@ -3684,7 +3649,7 @@ function collectParserCollisionWarnings(parsers) {
     grouped.set(entry.command, bucket);
   }
   for (const command of [...grouped.keys()].sort((left, right) => left.localeCompare(right))) {
-    const bucket = grouped.get(command) ?? [];
+    const bucket = grouped.get(command);
     if (bucket.length <= 1) {
       continue;
     }
@@ -3714,7 +3679,7 @@ function collectServiceCollisionWarnings(services) {
     grouped.set(entry.service, bucket);
   }
   for (const service of [...grouped.keys()].sort((left, right) => left.localeCompare(right))) {
-    const bucket = grouped.get(service) ?? [];
+    const bucket = grouped.get(service);
     if (bucket.length <= 1) {
       continue;
     }
@@ -4125,7 +4090,7 @@ var PLAN_STEP_LINK_KIND_VALUES = [
   "verifies",
   "supersedes"
 ];
-var CONTEXT_DEPTH_VALUES = ["brief", "standard", "deep"];
+var CONTEXT_DEPTH_VALUES = ["brief", "standard", "deep", "full"];
 var CONTEXT_SECTION_VALUES = [
   "hierarchy",
   "activity",
@@ -4472,6 +4437,9 @@ function filePathForSchemaSection(pmRoot, configuredPath, fallbackPath) {
   }
   return path6.join(pmRoot, normalized);
 }
+function resolveItemTypesFilePath(pmRoot, schema) {
+  return filePathForSchemaSection(pmRoot, schema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types);
+}
 async function ensureRuntimeSchemaFileScaffold(pmRoot, schema) {
   const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
   const specs = [
@@ -4574,11 +4542,8 @@ function preferredStatusForRole(definitions, role, fallbackValues) {
   if (withRole.length > 0) {
     return withRole[0].id;
   }
-  for (const value of fallbackValues) {
-    const normalized = normalizeStatusId(value);
-    if (!normalized) {
-      continue;
-    }
+  const normalizedFallbacks = fallbackValues.map((value) => normalizeStatusId(value)).filter((value) => typeof value === "string");
+  for (const normalized of normalizedFallbacks) {
     if (definitions.some((definition) => definition.id === normalized)) {
       return normalized;
     }
@@ -4629,7 +4594,7 @@ function resolveRuntimeStatusRegistry(schema) {
     }
   }
   const workflow = normalizedSchema.workflow;
-  const openStatus = normalizeStatusId(workflow.open_status) ?? preferredStatusForRole(definitions, "default_open", ["open", "in_progress", STATUS_VALUES[0] ?? "open"]);
+  const openStatus = normalizeStatusId(workflow.open_status) ?? preferredStatusForRole(definitions, "default_open", ["open", "in_progress", STATUS_VALUES[0]]);
   const closeStatus = normalizeStatusId(workflow.close_status) ?? preferredStatusForRole(definitions, "default_close", ["closed", "done", "complete"]);
   const canceledStatus = normalizeStatusId(workflow.canceled_status) ?? preferredStatusForRole(definitions, "default_cancel", ["canceled", "cancelled"]);
   return {
@@ -4642,9 +4607,9 @@ function resolveRuntimeStatusRegistry(schema) {
     active_statuses: activeStatuses,
     blocked_statuses: blockedStatuses,
     draft_statuses: draftStatuses,
-    open_status: openStatus ?? definitions[0]?.id ?? "open",
-    close_status: closeStatus ?? definitions[0]?.id ?? "closed",
-    canceled_status: canceledStatus ?? definitions[0]?.id ?? "canceled"
+    open_status: openStatus,
+    close_status: closeStatus,
+    canceled_status: canceledStatus
   };
 }
 function normalizeStatusInputWithRegistry(value, registry) {
@@ -4657,11 +4622,8 @@ function normalizeStatusInputWithRegistry(value, registry) {
 function resolveRuntimeFieldRegistry(schema) {
   const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
   const dedupedByKey = /* @__PURE__ */ new Map();
-  for (const definition of normalizedSchema.fields) {
-    const normalized = normalizeRuntimeFieldDefinition(definition);
-    if (!normalized) {
-      continue;
-    }
+  const normalizedFields = normalizedSchema.fields.map((definition) => normalizeRuntimeFieldDefinition(definition)).filter((definition) => definition !== null);
+  for (const normalized of normalizedFields) {
     dedupedByKey.set(normalized.key, normalized);
   }
   const definitions = [...dedupedByKey.values()].sort((left, right) => left.key.localeCompare(right.key));
@@ -4907,6 +4869,22 @@ function vArray(item) {
 function vOptional(inner) {
   return (input) => input === void 0 ? { ok: true, value: void 0 } : inner(input);
 }
+function vRecordOf(valueCheck) {
+  return (input) => {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+      return FAIL;
+    }
+    const value = {};
+    for (const [key, raw] of Object.entries(input)) {
+      const result = valueCheck(raw);
+      if (!result.ok) {
+        return FAIL;
+      }
+      value[key] = result.value;
+    }
+    return { ok: true, value };
+  };
+}
 function vObject(shape) {
   return (input) => {
     if (typeof input !== "object" || input === null || Array.isArray(input)) {
@@ -5081,7 +5059,8 @@ var settingsCheck = vObject({
     lifecycle_stale_blocker_reason_patterns: vOptional(vArray(vString)),
     lifecycle_closure_like_blocked_reason_patterns: vOptional(vArray(vString)),
     lifecycle_closure_like_resolution_patterns: vOptional(vArray(vString)),
-    lifecycle_closure_like_actual_result_patterns: vOptional(vArray(vString))
+    lifecycle_closure_like_actual_result_patterns: vOptional(vArray(vString)),
+    estimate_defaults_by_type: vOptional(vRecordOf(vNumber({ int: true, positive: true })))
   })),
   governance: governanceSettings,
   workflow: vOptional(vObject({ definition_of_done: vArray(vString) })),
@@ -5135,6 +5114,7 @@ var settingsCheck = vObject({
     embedding_timeout_ms: vOptional(vNumber({ int: true })),
     scanner_max_batch_retries: vNumber({ int: true }),
     provider: vOptional(vString),
+    corpus_fields: vOptional(vArray(vString)),
     mutation_refresh_policy: vOptional(vLiteral("cache_only", "semantic_configured", "semantic_auto")),
     query_expansion: vOptional(vObject({
       enabled: vOptional(vBoolean),
@@ -5246,6 +5226,73 @@ function normalizeItemTypeDefinition(definition, options = {}) {
   };
 }
 
+// dist/core/validate/estimate-defaults.js
+var DEFAULT_ESTIMATE_MINUTES_BY_TYPE = {
+  Epic: 2880,
+  Feature: 480,
+  Story: 480,
+  Milestone: 2880,
+  Task: 120,
+  Issue: 60,
+  Bug: 60,
+  Chore: 30,
+  Decision: 15,
+  Plan: 120
+};
+var FALLBACK_ESTIMATE_MINUTES = 120;
+function isHonoredMinutes(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+function toLowercasedLookup(source) {
+  const lookup = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(source)) {
+    lookup.set(key.toLowerCase(), value);
+  }
+  return lookup;
+}
+var BUILTIN_LOWERCASED_LOOKUP = toLowercasedLookup(DEFAULT_ESTIMATE_MINUTES_BY_TYPE);
+var OVERRIDE_LOOKUP_CACHE = /* @__PURE__ */ new WeakMap();
+function lowercasedOverrideLookup(overrides) {
+  const cached = OVERRIDE_LOOKUP_CACHE.get(overrides);
+  if (cached) {
+    return cached;
+  }
+  const lookup = toLowercasedLookup(overrides);
+  OVERRIDE_LOOKUP_CACHE.set(overrides, lookup);
+  return lookup;
+}
+function resolveEstimateDefaultMinutes(type, overrides) {
+  const key = (type ?? "").trim().toLowerCase();
+  if (key.length === 0) {
+    return FALLBACK_ESTIMATE_MINUTES;
+  }
+  if (overrides) {
+    const overrideValue = lowercasedOverrideLookup(overrides).get(key);
+    if (isHonoredMinutes(overrideValue)) {
+      return Math.floor(overrideValue);
+    }
+  }
+  const builtinValue = BUILTIN_LOWERCASED_LOOKUP.get(key);
+  if (isHonoredMinutes(builtinValue)) {
+    return Math.floor(builtinValue);
+  }
+  return FALLBACK_ESTIMATE_MINUTES;
+}
+function normalizeEstimateDefaultOverrides(raw) {
+  const normalized = {};
+  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+    return normalized;
+  }
+  for (const [rawKey, rawValue] of Object.entries(raw)) {
+    const key = rawKey.trim();
+    if (key.length === 0 || !isHonoredMinutes(rawValue)) {
+      continue;
+    }
+    normalized[key] = Math.floor(rawValue);
+  }
+  return normalized;
+}
+
 // dist/core/store/settings-read-cache.js
 import { stat } from "node:fs/promises";
 var settingsReadCacheByRoot = /* @__PURE__ */ new Map();
@@ -5754,6 +5801,15 @@ function normalizeValidationMetadataRequiredFields(values) {
 function normalizeValidationPatternList(values) {
   return [...new Set((values ?? []).map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
 }
+function valueOrDefault(value, fallback) {
+  return value === void 0 ? fallback : value;
+}
+function recordOrEmpty(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function arrayOrEmpty(value) {
+  return Array.isArray(value) ? value : [];
+}
 function normalizeItemTypeDefinitions(definitions) {
   const normalized = (definitions ?? []).map((definition) => normalizeItemTypeDefinition(definition)).filter((definition) => definition !== null);
   const dedupedByName = /* @__PURE__ */ new Map();
@@ -5783,7 +5839,8 @@ function mergeSettings(settings) {
       lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_stale_blocker_reason_patterns ?? defaults.validation.lifecycle_stale_blocker_reason_patterns),
       lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_blocked_reason_patterns ?? defaults.validation.lifecycle_closure_like_blocked_reason_patterns),
       lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_resolution_patterns ?? defaults.validation.lifecycle_closure_like_resolution_patterns),
-      lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_actual_result_patterns ?? defaults.validation.lifecycle_closure_like_actual_result_patterns)
+      lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_actual_result_patterns ?? defaults.validation.lifecycle_closure_like_actual_result_patterns),
+      estimate_defaults_by_type: normalizeEstimateDefaultOverrides(settings.validation?.estimate_defaults_by_type)
     },
     governance,
     workflow: {
@@ -5850,24 +5907,43 @@ function mergeSettings(settings) {
   };
 }
 function serializeSettings(settings, options = {}) {
-  const governance = resolveGovernanceKnobs(settings);
-  const normalizedSchema = normalizeRuntimeSchemaSettings(settings.schema);
-  const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(settings, options.persist_source);
-  const normalizedSettings = {
+  const baseSettings = {
     ...settings,
+    locks: valueOrDefault(settings.locks, SETTINGS_DEFAULTS.locks),
+    output: valueOrDefault(settings.output, SETTINGS_DEFAULTS.output),
+    history: valueOrDefault(settings.history, SETTINGS_DEFAULTS.history),
+    validation: valueOrDefault(settings.validation, SETTINGS_DEFAULTS.validation),
+    workflow: valueOrDefault(settings.workflow, SETTINGS_DEFAULTS.workflow),
+    testing: valueOrDefault(settings.testing, SETTINGS_DEFAULTS.testing),
+    telemetry: valueOrDefault(settings.telemetry, SETTINGS_DEFAULTS.telemetry),
+    agent_guidance: valueOrDefault(settings.agent_guidance, SETTINGS_DEFAULTS.agent_guidance),
+    item_types: valueOrDefault(settings.item_types, SETTINGS_DEFAULTS.item_types),
+    schema: valueOrDefault(settings.schema, SETTINGS_DEFAULTS.schema),
+    context: valueOrDefault(settings.context, SETTINGS_DEFAULTS.context),
+    extensions: valueOrDefault(settings.extensions, SETTINGS_DEFAULTS.extensions),
+    search: valueOrDefault(settings.search, SETTINGS_DEFAULTS.search),
+    providers: valueOrDefault(settings.providers, SETTINGS_DEFAULTS.providers),
+    vector_store: valueOrDefault(settings.vector_store, SETTINGS_DEFAULTS.vector_store)
+  };
+  const governance = resolveGovernanceKnobs(baseSettings);
+  const normalizedSchema = normalizeRuntimeSchemaSettings(baseSettings.schema);
+  const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(baseSettings, options.persist_source);
+  const normalizedSettings = {
+    ...baseSettings,
     item_format: "toon",
     validation: {
-      ...settings.validation,
+      ...baseSettings.validation,
       parent_reference: governance.parent_reference,
       metadata_profile: governance.metadata_profile,
-      metadata_required_fields: normalizeValidationMetadataRequiredFields(settings.validation?.metadata_required_fields),
-      lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_stale_blocker_reason_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_stale_blocker_reason_patterns),
-      lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_blocked_reason_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_blocked_reason_patterns),
-      lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_resolution_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_resolution_patterns),
-      lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_actual_result_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_actual_result_patterns)
+      metadata_required_fields: normalizeValidationMetadataRequiredFields(baseSettings.validation?.metadata_required_fields),
+      lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_stale_blocker_reason_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_stale_blocker_reason_patterns),
+      lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_blocked_reason_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_blocked_reason_patterns),
+      lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_resolution_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_resolution_patterns),
+      lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_actual_result_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_actual_result_patterns),
+      estimate_defaults_by_type: normalizeEstimateDefaultOverrides(baseSettings.validation?.estimate_defaults_by_type)
     },
     governance,
-    agent_guidance: normalizeAgentGuidanceSettings(settings.agent_guidance),
+    agent_guidance: normalizeAgentGuidanceSettings(baseSettings.agent_guidance),
     item_types: {
       definitions: persistedFileBackedSections.item_type_definitions
     },
@@ -5879,42 +5955,42 @@ function serializeSettings(settings, options = {}) {
     },
     search: {
       ...SETTINGS_DEFAULTS.search,
-      ...settings.search,
-      mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy),
+      ...baseSettings.search,
+      mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(baseSettings.search?.mutation_refresh_policy),
       query_expansion: {
         ...SETTINGS_DEFAULTS.search.query_expansion,
-        ...settings.search?.query_expansion ?? {},
-        enabled: normalizeSearchQueryExpansionEnabled(settings.search?.query_expansion?.enabled),
-        provider: normalizeSearchQueryExpansionProvider(settings.search?.query_expansion?.provider)
+        ...baseSettings.search?.query_expansion ?? {},
+        enabled: normalizeSearchQueryExpansionEnabled(baseSettings.search?.query_expansion?.enabled),
+        provider: normalizeSearchQueryExpansionProvider(baseSettings.search?.query_expansion?.provider)
       },
       rerank: {
         ...SETTINGS_DEFAULTS.search.rerank,
-        ...settings.search?.rerank ?? {},
-        enabled: normalizeSearchRerankEnabled(settings.search?.rerank?.enabled),
-        model: normalizeSearchRerankModel(settings.search?.rerank?.model),
-        top_k: normalizeSearchRerankTopK(settings.search?.rerank?.top_k)
+        ...baseSettings.search?.rerank ?? {},
+        enabled: normalizeSearchRerankEnabled(baseSettings.search?.rerank?.enabled),
+        model: normalizeSearchRerankModel(baseSettings.search?.rerank?.model),
+        top_k: normalizeSearchRerankTopK(baseSettings.search?.rerank?.top_k)
       }
     },
     context: {
-      default_depth: settings.context?.default_depth ?? SETTINGS_DEFAULTS.context.default_depth,
-      activity_limit: settings.context?.activity_limit ?? SETTINGS_DEFAULTS.context.activity_limit,
-      stale_threshold_days: settings.context?.stale_threshold_days ?? SETTINGS_DEFAULTS.context.stale_threshold_days,
+      default_depth: baseSettings.context?.default_depth ?? SETTINGS_DEFAULTS.context.default_depth,
+      activity_limit: baseSettings.context?.activity_limit ?? SETTINGS_DEFAULTS.context.activity_limit,
+      stale_threshold_days: baseSettings.context?.stale_threshold_days ?? SETTINGS_DEFAULTS.context.stale_threshold_days,
       sections: {
         ...SETTINGS_DEFAULTS.context.sections,
-        ...settings.context?.sections ?? {}
+        ...baseSettings.context?.sections ?? {}
       }
     },
     extensions: {
-      enabled: normalizeStringList2(settings.extensions?.enabled),
-      disabled: normalizeStringList2(settings.extensions?.disabled),
-      policy: normalizeExtensionPolicySettings(settings.extensions?.policy)
+      enabled: normalizeStringList2(baseSettings.extensions?.enabled),
+      disabled: normalizeStringList2(baseSettings.extensions?.disabled),
+      policy: normalizeExtensionPolicySettings(baseSettings.extensions?.policy)
     },
     vector_store: {
-      ...settings.vector_store ?? {},
-      adapter: settings.vector_store?.adapter ?? SETTINGS_DEFAULTS.vector_store.adapter,
-      collection_name: normalizeVectorStoreCollectionName(settings.vector_store?.collection_name),
-      qdrant: { ...settings.vector_store?.qdrant ?? {} },
-      lancedb: { ...settings.vector_store?.lancedb ?? {} }
+      ...baseSettings.vector_store,
+      adapter: baseSettings.vector_store?.adapter ?? SETTINGS_DEFAULTS.vector_store.adapter,
+      collection_name: normalizeVectorStoreCollectionName(baseSettings.vector_store?.collection_name),
+      qdrant: { ...baseSettings.vector_store?.qdrant ?? {} },
+      lancedb: { ...baseSettings.vector_store?.lancedb ?? {} }
     }
   };
   const ordered = orderObject({
@@ -5953,7 +6029,8 @@ function serializeSettings(settings, options = {}) {
     "lifecycle_stale_blocker_reason_patterns",
     "lifecycle_closure_like_blocked_reason_patterns",
     "lifecycle_closure_like_resolution_patterns",
-    "lifecycle_closure_like_actual_result_patterns"
+    "lifecycle_closure_like_actual_result_patterns",
+    "estimate_defaults_by_type"
   ]);
   ordered.governance = orderObject(ordered.governance, [
     "preset",
@@ -5994,17 +6071,17 @@ function serializeSettings(settings, options = {}) {
     "type_workflows",
     "unknown_field_policy"
   ]);
-  ordered.schema.files = orderObject(ordered.schema.files ?? {}, ["types", "statuses", "fields", "workflows"]);
-  ordered.schema.workflow = orderObject(ordered.schema.workflow ?? {}, ["draft_status", "open_status", "in_progress_status", "blocked_status", "close_status", "canceled_status"]);
+  ordered.schema.files = orderObject(recordOrEmpty(ordered.schema.files), ["types", "statuses", "fields", "workflows"]);
+  ordered.schema.workflow = orderObject(recordOrEmpty(ordered.schema.workflow), ["draft_status", "open_status", "in_progress_status", "blocked_status", "close_status", "canceled_status"]);
   ordered.context = orderObject(ordered.context, [
     "default_depth",
     "activity_limit",
     "stale_threshold_days",
     "sections"
   ]);
-  ordered.context.sections = orderObject(ordered.context.sections ?? {}, ["hierarchy", "activity", "progress", "blockers", "files", "workload", "staleness", "tests"]);
+  ordered.context.sections = orderObject(recordOrEmpty(ordered.context.sections), ["hierarchy", "activity", "progress", "blockers", "files", "workload", "staleness", "tests"]);
   ordered.extensions = orderObject(ordered.extensions, ["enabled", "disabled", "policy"]);
-  ordered.extensions.policy = orderObject(ordered.extensions.policy ?? {}, [
+  ordered.extensions.policy = orderObject(recordOrEmpty(ordered.extensions.policy), [
     "mode",
     "trust_mode",
     "pm_max_version_exceeded_mode",
@@ -6025,7 +6102,7 @@ function serializeSettings(settings, options = {}) {
     "blocked_services",
     "extension_overrides"
   ]);
-  ordered.extensions.policy.extension_overrides = (ordered.extensions.policy.extension_overrides ?? []).map((entry) => orderObject(entry ?? {}, [
+  ordered.extensions.policy.extension_overrides = arrayOrEmpty(ordered.extensions.policy.extension_overrides).map((entry) => orderObject(recordOrEmpty(entry), [
     "name",
     "disabled",
     "require_trusted",
@@ -6056,19 +6133,19 @@ function serializeSettings(settings, options = {}) {
     "query_expansion",
     "rerank"
   ]);
-  ordered.search.query_expansion = orderObject(ordered.search.query_expansion ?? {}, ["enabled", "provider"]);
-  ordered.search.rerank = orderObject(ordered.search.rerank ?? {}, ["enabled", "model", "top_k"]);
+  ordered.search.query_expansion = orderObject(recordOrEmpty(ordered.search.query_expansion), ["enabled", "provider"]);
+  ordered.search.rerank = orderObject(recordOrEmpty(ordered.search.rerank), ["enabled", "model", "top_k"]);
   ordered.providers = orderObject(ordered.providers, ["openai", "ollama"]);
-  ordered.providers.openai = orderObject(ordered.providers.openai ?? {}, ["base_url", "api_key", "model"]);
-  ordered.providers.ollama = orderObject(ordered.providers.ollama ?? {}, ["base_url", "model"]);
+  ordered.providers.openai = orderObject(recordOrEmpty(ordered.providers.openai), ["base_url", "api_key", "model"]);
+  ordered.providers.ollama = orderObject(recordOrEmpty(ordered.providers.ollama), ["base_url", "model"]);
   ordered.vector_store = orderObject(ordered.vector_store, [
     "adapter",
     "collection_name",
     "qdrant",
     "lancedb"
   ]);
-  ordered.vector_store.qdrant = orderObject(ordered.vector_store.qdrant ?? {}, ["url", "api_key"]);
-  ordered.vector_store.lancedb = orderObject(ordered.vector_store.lancedb ?? {}, ["path"]);
+  ordered.vector_store.qdrant = orderObject(recordOrEmpty(ordered.vector_store.qdrant), ["url", "api_key"]);
+  ordered.vector_store.lancedb = orderObject(recordOrEmpty(ordered.vector_store.lancedb), ["path"]);
   return `${JSON.stringify(ordered, null, 2)}
 `;
 }
@@ -6125,7 +6202,7 @@ async function readSettingsWithMetadata(pmRoot) {
       item_types: {
         definitions: normalizeItemTypeDefinitions([
           ...mergedSettings.item_types.definitions,
-          ...loadedSchemaSections.type_definitions_from_file ?? []
+          ...arrayOrEmpty(loadedSchemaSections.type_definitions_from_file)
         ])
       },
       schema: loadedSchemaSections.schema
@@ -6199,6 +6276,7 @@ export {
   KNOWN_EXTENSION_POLICY_SURFACES,
   KNOWN_EXTENSION_SERVICE_NAMES,
   PM_DIRNAME,
+  CREATE_DIRECT_CLOSE_REASON_DEFAULT,
   PM_CORE_REQUIRED_SUBDIRS,
   PM_OPTIONAL_TYPE_SUBDIRS,
   PM_REQUIRED_SUBDIRS,
@@ -6219,6 +6297,7 @@ export {
   getItemFormatFromPath,
   getHistoryPath,
   getLockPath,
+  getRuntimePath,
   getTestRunsPath,
   getTestRunsRecordsPath,
   getTestRunRecordPath,
@@ -6301,6 +6380,7 @@ export {
   DEFAULT_RUNTIME_STATUS_DEFINITIONS,
   normalizeRuntimeSchemaSettings,
   filePathForSchemaSection,
+  resolveItemTypesFilePath,
   ensureRuntimeSchemaFileScaffold,
   resolveRuntimeStatusRegistry,
   normalizeStatusInputWithRegistry,
@@ -6312,11 +6392,12 @@ export {
   stableValueEquals,
   sha256Hex,
   orderObject,
+  resolveEstimateDefaultMinutes,
   resolveGovernanceKnobs,
   readSettingsWithMetadata,
   readSettings,
   writeSettings
 };
-//# sourceMappingURL=chunk-A6LXQFO7.js.map
+//# sourceMappingURL=chunk-KTVETP66.js.map
 
-//# debugId=3d81dd28-0239-582e-84cb-25d9dea99250
+//# debugId=62f87b11-f1bc-5f90-bc91-0e81dfdebb55