@unbrained/pm-cli 2026.5.30 → 2026.6.5

package/dist/cli-bundle/chunks/health-IT5DBPRJ.js

@@ -0,0 +1,1261 @@
+import {
+  buildRemediationMap,
+  scanHistoryDrift
+} from "./chunk-TBQVUNVH.js";
+import {
+  collectStaleVectorizationIds
+} from "./chunk-QAJBIGRA.js";
+import "./chunk-S3CV7JGJ.js";
+import {
+  buildRegistrationCollisionRemediation,
+  readManagedExtensionState
+} from "./chunk-OIQIXTNB.js";
+import {
+  readVectorizationStatusLedger,
+  refreshSemanticEmbeddingsForMutatedItems,
+  resolveEmbeddingProviders,
+  resolveSettingsWithSemanticRuntimeDefaults,
+  resolveVectorStores
+} from "./chunk-5IRA6IYD.js";
+import "./chunk-3HUE7XOF.js";
+import {
+  collectRegisteredItemFieldNames,
+  enforceHistoryStreamPolicyForItems,
+  listAllFrontMatter,
+  listAllFrontMatterWithBody
+} from "./chunk-XG7RJYHV.js";
+import "./chunk-KA24HME7.js";
+import {
+  findFirstMergeConflictMarker,
+  parseItemDocument
+} from "./chunk-HPH6X4ZZ.js";
+import {
+  resolveItemTypeRegistry
+} from "./chunk-4PJQSECJ.js";
+import {
+  nowIso
+} from "./chunk-RANZIID5.js";
+import {
+  EXIT_CODE,
+  EXTENSION_CAPABILITY_CONTRACT,
+  ITEM_FILE_EXTENSIONS,
+  KNOWN_EXTENSION_CAPABILITIES,
+  PM_CORE_REQUIRED_SUBDIRS,
+  PM_OPTIONAL_TYPE_SUBDIRS,
+  PmCliError,
+  activateExtensions,
+  getActiveExtensionRegistrations,
+  getItemFormatFromPath,
+  getSettingsPath,
+  loadExtensions,
+  parseLegacyExtensionCapabilityAliasWarning,
+  parseUnknownExtensionCapabilityWarning,
+  pathExists,
+  readFileIfExists,
+  readSettingsWithMetadata,
+  resolveGlobalPmRoot,
+  resolvePmRoot,
+  runActiveOnReadHooks,
+  toNonEmptyStringOrUndefined
+} from "./chunk-SRVKTWPR.js";
+
+// dist/cli/commands/health.js
+import fs from "node:fs/promises";
+import path from "node:path";
+!(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] = "b3e623d5-2959-599f-8790-cf31386eee4e");
+  } catch (e2) {
+  }
+})();
+var STALE_VECTORIZATION_SUMMARY_LIMIT = 25;
+var BRIEF_HEALTH_DETAIL_LIMIT = 8;
+var TELEMETRY_QUEUE_RELATIVE_PATH = path.join("runtime", "telemetry", "events.jsonl");
+var TELEMETRY_STATE_RELATIVE_PATH = path.join("runtime", "telemetry", "state.json");
+var TELEMETRY_ENDPOINT_PROBE_TIMEOUT_MS = 2500;
+var TELEMETRY_QUEUE_HIGH_WATER_MARK = 500;
+function isAdvisoryHealthWarning(warning) {
+  return warning.startsWith("telemetry_");
+}
+function warningCode(value) {
+  const normalized = value.trim();
+  const separator = normalized.indexOf(":");
+  if (separator === -1) {
+    return normalized;
+  }
+  return normalized.slice(0, separator);
+}
+function collectUnknownCapabilityGuidance(warnings) {
+  const seen = /* @__PURE__ */ new Set();
+  const guidance = [];
+  for (const warning of warnings) {
+    const parsedDetails = (() => {
+      const unknownWarning = parseUnknownExtensionCapabilityWarning(warning);
+      if (unknownWarning) {
+        return [unknownWarning];
+      }
+      return parseLegacyExtensionCapabilityAliasWarning(warning);
+    })();
+    for (const parsed of parsedDetails) {
+      const key = `${parsed.layer}:${parsed.name}:${parsed.capability}`;
+      if (seen.has(key)) {
+        continue;
+      }
+      seen.add(key);
+      guidance.push(parsed);
+    }
+  }
+  return guidance;
+}
+function buildCapabilityContractMetadata() {
+  return {
+    version: EXTENSION_CAPABILITY_CONTRACT.version,
+    capabilities: [...EXTENSION_CAPABILITY_CONTRACT.capabilities],
+    legacy_aliases: { ...EXTENSION_CAPABILITY_CONTRACT.legacy_aliases }
+  };
+}
+function normalizeExtensionNameForMatch(value) {
+  return value.trim().toLowerCase();
+}
+function isExpectedUnmanagedExtension(name, directory) {
+  const normalizedName = normalizeExtensionNameForMatch(name);
+  const normalizedDirectory = normalizeExtensionNameForMatch(directory);
+  if (normalizedName.startsWith("builtin-")) {
+    return true;
+  }
+  return normalizedDirectory === "beads" || normalizedDirectory === "todos";
+}
+async function isDirectory(targetPath) {
+  try {
+    const stats = await fs.stat(targetPath);
+    return stats.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function countHistoryStreams(pmRoot) {
+  const historyDir = path.join(pmRoot, "history");
+  if (!await isDirectory(historyDir)) {
+    return {
+      count: 0,
+      warnings: []
+    };
+  }
+  const historyFiles = (await fs.readdir(historyDir)).filter((entry) => entry.endsWith(".jsonl")).sort((left, right) => left.localeCompare(right));
+  const warnings = [];
+  for (const fileName of historyFiles) {
+    warnings.push(...await runActiveOnReadHooks({
+      path: path.join(historyDir, fileName),
+      scope: "project"
+    }));
+  }
+  return {
+    count: historyFiles.length,
+    warnings
+  };
+}
+function normalizeRelativePath(pmRoot, targetPath) {
+  return path.relative(pmRoot, targetPath).replaceAll("\\", "/");
+}
+async function listItemDocumentPaths(pmRoot, typeToFolder) {
+  const folders = [...new Set(Object.values(typeToFolder))].sort((left, right) => left.localeCompare(right));
+  const itemPaths = [];
+  for (const folder of folders) {
+    const directoryPath = path.join(pmRoot, folder);
+    let entries = [];
+    try {
+      entries = await fs.readdir(directoryPath);
+    } catch (error) {
+      if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+        continue;
+      }
+      continue;
+    }
+    for (const entry of entries) {
+      if (!ITEM_FILE_EXTENSIONS.some((extension) => entry.toLowerCase().endsWith(extension))) {
+        continue;
+      }
+      itemPaths.push(path.join(directoryPath, entry));
+    }
+  }
+  itemPaths.sort((left, right) => normalizeRelativePath(pmRoot, left).localeCompare(normalizeRelativePath(pmRoot, right)));
+  return itemPaths;
+}
+async function buildIntegrityCheck(pmRoot, typeToFolder, schema) {
+  const itemPaths = await listItemDocumentPaths(pmRoot, typeToFolder);
+  const itemUnreadable = [];
+  const itemConflictMarkers = [];
+  const itemParseFailures = [];
+  const extensionFieldNames = collectRegisteredItemFieldNames(getActiveExtensionRegistrations());
+  for (const itemPath of itemPaths) {
+    const relativePath = normalizeRelativePath(pmRoot, itemPath);
+    let raw = "";
+    try {
+      raw = await fs.readFile(itemPath, "utf8");
+    } catch {
+      itemUnreadable.push(relativePath);
+      continue;
+    }
+    const conflictMarker = findFirstMergeConflictMarker(raw);
+    if (conflictMarker) {
+      itemConflictMarkers.push({
+        path: relativePath,
+        line: conflictMarker.line,
+        marker: conflictMarker.marker
+      });
+      continue;
+    }
+    try {
+      parseItemDocument(raw, { format: getItemFormatFromPath(itemPath), schema, extensionFieldNames });
+    } catch {
+      itemParseFailures.push(relativePath);
+    }
+  }
+  const historyDir = path.join(pmRoot, "history");
+  const historyUnreadable = [];
+  const historyConflictMarkers = [];
+  const historyInvalidJson = [];
+  let historyFiles = [];
+  try {
+    historyFiles = (await fs.readdir(historyDir)).filter((entry) => entry.endsWith(".jsonl")).sort((left, right) => left.localeCompare(right));
+  } catch (error) {
+    if (!(typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT")) {
+      historyUnreadable.push("history");
+    }
+  }
+  for (const fileName of historyFiles) {
+    const itemId = fileName.slice(0, -".jsonl".length);
+    const historyPath = path.join(historyDir, fileName);
+    let raw = "";
+    try {
+      raw = await fs.readFile(historyPath, "utf8");
+    } catch {
+      historyUnreadable.push(itemId);
+      continue;
+    }
+    const conflictMarker = findFirstMergeConflictMarker(raw);
+    if (conflictMarker) {
+      historyConflictMarkers.push({
+        id: itemId,
+        line: conflictMarker.line,
+        marker: conflictMarker.marker
+      });
+      continue;
+    }
+    const lines = raw.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+      const line = lines[index]?.trim();
+      if (!line) {
+        continue;
+      }
+      try {
+        JSON.parse(line);
+      } catch {
+        historyInvalidJson.push({
+          id: itemId,
+          line: index + 1
+        });
+      }
+    }
+  }
+  const warnings = [
+    ...itemUnreadable.map((entry) => `integrity_item_unreadable:${entry}`),
+    ...itemConflictMarkers.map((entry) => `integrity_item_conflict_marker:${entry.path}:L${entry.line}`),
+    ...itemParseFailures.map((entry) => `integrity_item_parse_failed:${entry}`),
+    ...historyUnreadable.map((entry) => `integrity_history_unreadable:${entry}`),
+    ...historyConflictMarkers.map((entry) => `integrity_history_conflict_marker:${entry.id}:L${entry.line}`),
+    ...historyInvalidJson.map((entry) => `integrity_history_invalid_json:${entry.id}:L${entry.line}`)
+  ];
+  const normalizedWarnings = [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
+  return {
+    check: {
+      name: "integrity",
+      status: normalizedWarnings.length === 0 ? "ok" : "warn",
+      details: {
+        checked_item_files: itemPaths.length,
+        checked_history_streams: historyFiles.length,
+        counts: {
+          item_unreadable: itemUnreadable.length,
+          item_conflict_markers: itemConflictMarkers.length,
+          item_parse_failures: itemParseFailures.length,
+          history_unreadable: historyUnreadable.length,
+          history_conflict_markers: historyConflictMarkers.length,
+          history_invalid_json: historyInvalidJson.length
+        },
+        item_unreadable: itemUnreadable,
+        item_conflict_markers: itemConflictMarkers,
+        item_parse_failures: itemParseFailures,
+        history_unreadable: historyUnreadable,
+        history_conflict_markers: historyConflictMarkers,
+        history_invalid_json: historyInvalidJson
+      }
+    },
+    warnings: normalizedWarnings
+  };
+}
+function hasActivateExport(moduleRecord) {
+  if (typeof moduleRecord.activate === "function") {
+    return true;
+  }
+  const defaultExport = moduleRecord.default;
+  if (typeof defaultExport !== "object" || defaultExport === null) {
+    return false;
+  }
+  return typeof defaultExport.activate === "function";
+}
+function summarizeLoadedExtension(extension) {
+  const summary = {
+    layer: extension.layer,
+    directory: extension.directory,
+    manifest_path: extension.manifest_path,
+    name: extension.name,
+    version: extension.version,
+    entry: extension.entry,
+    priority: extension.priority,
+    entry_path: extension.entry_path,
+    has_activate: hasActivateExport(extension.module)
+  };
+  if (Array.isArray(extension.capabilities)) {
+    summary.capabilities = [...extension.capabilities];
+  }
+  return summary;
+}
+function resolveMigrationId(definition, fallbackIndex) {
+  const explicitId = toNonEmptyStringOrUndefined(definition.id);
+  if (explicitId) {
+    return explicitId;
+  }
+  return `migration-${String(fallbackIndex + 1).padStart(3, "0")}`;
+}
+function resolveMigrationStatus(definition) {
+  const rawStatus = toNonEmptyStringOrUndefined(definition.status);
+  const normalized = rawStatus?.toLowerCase();
+  if (normalized === "failed") {
+    return "failed";
+  }
+  if (normalized === "applied") {
+    return "applied";
+  }
+  return "pending";
+}
+function resolveMigrationFailureReason(definition) {
+  return toNonEmptyStringOrUndefined(definition.reason) ?? toNonEmptyStringOrUndefined(definition.error) ?? toNonEmptyStringOrUndefined(definition.message);
+}
+function compareMigrationEntries(left, right) {
+  const byLayer = (left.layer ?? "").localeCompare(right.layer ?? "");
+  if (byLayer !== 0) {
+    return byLayer;
+  }
+  const byName = (left.name ?? "").localeCompare(right.name ?? "");
+  if (byName !== 0) {
+    return byName;
+  }
+  return (left.id ?? "").localeCompare(right.id ?? "");
+}
+function summarizeMigrationStatuses(migrations) {
+  const applied = [];
+  const pending = [];
+  const failed = [];
+  migrations.forEach((migration, index) => {
+    const id = resolveMigrationId(migration.definition, index);
+    const status = resolveMigrationStatus(migration.definition);
+    if (status === "applied") {
+      applied.push({
+        layer: migration.layer,
+        name: migration.name,
+        id,
+        status
+      });
+      return;
+    }
+    if (status === "failed") {
+      failed.push({
+        layer: migration.layer,
+        name: migration.name,
+        id,
+        status,
+        reason: resolveMigrationFailureReason(migration.definition)
+      });
+      return;
+    }
+    pending.push({
+      layer: migration.layer,
+      name: migration.name,
+      id,
+      status
+    });
+  });
+  applied.sort(compareMigrationEntries);
+  pending.sort(compareMigrationEntries);
+  failed.sort(compareMigrationEntries);
+  const warnings = [
+    ...failed.map((entry) => `extension_migration_failed:${entry.layer}:${entry.name}:${entry.id}`),
+    ...pending.map((entry) => `extension_migration_pending:${entry.layer}:${entry.name}:${entry.id}`)
+  ];
+  return {
+    summary: {
+      applied,
+      pending,
+      failed,
+      applied_count: applied.length,
+      pending_count: pending.length,
+      failed_count: failed.length
+    },
+    warnings
+  };
+}
+function buildExtensionHealthTriageSummary(warnings, loadFailureCount, activationFailureCount, migrationStatus, managedStateWarningCount, managedExtensionEntriesCount, unmanagedLoadedExtensions, unmanagedExpectedExtensions, unmanagedActionRequiredExtensions) {
+  const normalizedWarnings = [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
+  const warningCodes = [...new Set(normalizedWarnings.map((value) => warningCode(value)))].sort((left, right) => left.localeCompare(right));
+  const unknownCapabilityCount = normalizedWarnings.filter((warning) => warning.startsWith("extension_capability_unknown:")).length;
+  const updateHealthPartial = unmanagedActionRequiredExtensions.length > 0;
+  const updateHealthCoverage = updateHealthPartial ? "partial" : "full";
+  const remediation = [];
+  const registrationCollisionRemediation = buildRegistrationCollisionRemediation(normalizedWarnings, {
+    deactivate: "pm extension --deactivate <name> --project/--global",
+    doctor: "pm extension --doctor --project/--global --detail deep --trace"
+  });
+  if (registrationCollisionRemediation) {
+    remediation.push(registrationCollisionRemediation);
+  }
+  if (loadFailureCount > 0) {
+    remediation.push("Run pm extension --explore --project and pm extension --explore --global to inspect load failures.");
+  }
+  if (activationFailureCount > 0) {
+    remediation.push("Review checks[name=extensions].details.activation.failed in pm health --json for activation error details.");
+  }
+  if (migrationStatus.failed_count > 0 || migrationStatus.pending_count > 0) {
+    remediation.push("Resolve pending/failed extension migrations before write commands; use --force only when policy allows.");
+  }
+  if (managedStateWarningCount > 0) {
+    remediation.push("Run pm extension --manage --project and pm extension --manage --global to refresh managed-state diagnostics.");
+  }
+  if (unknownCapabilityCount > 0) {
+    remediation.push(`Unknown extension capabilities detected. Allowed capabilities: ${KNOWN_EXTENSION_CAPABILITIES.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`);
+  }
+  if (normalizedWarnings.some((warning) => warning.startsWith("extension_capability_legacy_alias:"))) {
+    remediation.push("Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema).");
+  }
+  if (normalizedWarnings.some((warning) => warning.startsWith("extension_command_definition_legacy_handler_alias:"))) {
+    remediation.push("Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility.");
+  }
+  if (updateHealthPartial) {
+    remediation.push("Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via pm extension --manage --project/--global --fix-managed-state, pm extension --adopt-all --project/--global, or pm extension --adopt <name>.");
+  } else if (unmanagedLoadedExtensions.length > 0) {
+    remediation.push("Loaded unmanaged extensions are currently treated as informational. Use pm extension --manage --project/--global --fix-managed-state to adopt them for update checks.");
+  }
+  if (remediation.length === 0) {
+    remediation.push("No immediate action required. Re-run pm health after extension configuration changes.");
+  }
+  return {
+    status: normalizedWarnings.length === 0 ? "ok" : "warn",
+    warning_count: normalizedWarnings.length,
+    warning_codes: warningCodes,
+    load_failure_count: loadFailureCount,
+    activation_failure_count: activationFailureCount,
+    migration_failed_count: migrationStatus.failed_count,
+    migration_pending_count: migrationStatus.pending_count,
+    managed_state_warning_count: managedStateWarningCount,
+    managed_extension_entries_count: managedExtensionEntriesCount,
+    unmanaged_loaded_extension_count: unmanagedLoadedExtensions.length,
+    unmanaged_loaded_extensions: unmanagedLoadedExtensions,
+    unmanaged_expected_extension_count: unmanagedExpectedExtensions.length,
+    unmanaged_expected_extensions: unmanagedExpectedExtensions,
+    unmanaged_action_required_extension_count: unmanagedActionRequiredExtensions.length,
+    unmanaged_action_required_extensions: unmanagedActionRequiredExtensions,
+    update_health_coverage: updateHealthCoverage,
+    update_health_partial: updateHealthPartial,
+    unknown_capability_count: unknownCapabilityCount,
+    top_warnings: normalizedWarnings.slice(0, 8),
+    remediation
+  };
+}
+async function buildExtensionCheck(pmRoot, settings, noExtensionsFlag) {
+  const loadResult = await loadExtensions({
+    pmRoot,
+    settings,
+    cwd: process.cwd(),
+    noExtensions: noExtensionsFlag
+  });
+  const loadedSummaries = loadResult.loaded.map((extension) => summarizeLoadedExtension(extension));
+  const activationResult = await activateExtensions({
+    ...loadResult,
+    loaded: loadResult.loaded
+  });
+  const [projectManagedState, globalManagedState] = await Promise.all([
+    readManagedExtensionState(loadResult.roots.project),
+    readManagedExtensionState(loadResult.roots.global)
+  ]);
+  const migrationStatus = summarizeMigrationStatuses(activationResult.registrations.migrations);
+  const activationDetails = {
+    failed: activationResult.failed,
+    warnings: activationResult.warnings,
+    hook_counts: activationResult.hook_counts,
+    command_override_count: activationResult.command_override_count,
+    command_handler_count: activationResult.command_handler_count,
+    parser_override_count: activationResult.parser_override_count,
+    preflight_override_count: activationResult.preflight_override_count,
+    service_override_count: activationResult.service_override_count,
+    renderer_override_count: activationResult.renderer_override_count,
+    registration_counts: activationResult.registration_counts,
+    registrations: activationResult.registrations,
+    migration_status: migrationStatus.summary,
+    managed_extensions: {
+      project: {
+        path: projectManagedState.path,
+        count: projectManagedState.state.entries.length,
+        entries: projectManagedState.state.entries
+      },
+      global: {
+        path: globalManagedState.path,
+        count: globalManagedState.state.entries.length,
+        entries: globalManagedState.state.entries
+      }
+    }
+  };
+  const managedProjectNames = new Set(projectManagedState.state.entries.map((entry) => normalizeExtensionNameForMatch(entry.name)));
+  const managedGlobalNames = new Set(globalManagedState.state.entries.map((entry) => normalizeExtensionNameForMatch(entry.name)));
+  const unmanagedLoadedEntries = [
+    ...new Map(loadResult.loaded.filter((entry) => {
+      const managedNames = entry.layer === "project" ? managedProjectNames : managedGlobalNames;
+      return !managedNames.has(normalizeExtensionNameForMatch(entry.name));
+    }).map((entry) => [
+      `${entry.layer}:${entry.name}`,
+      {
+        layer: entry.layer,
+        name: entry.name,
+        directory: entry.directory
+      }
+    ])).values()
+  ].sort((left, right) => {
+    const leftKey = `${left.layer}:${left.name}`;
+    const rightKey = `${right.layer}:${right.name}`;
+    return leftKey.localeCompare(rightKey);
+  });
+  const unmanagedLoadedExtensions = unmanagedLoadedEntries.map((entry) => `${entry.layer}:${entry.name}`).sort((left, right) => left.localeCompare(right));
+  const unmanagedExpectedExtensions = unmanagedLoadedEntries.filter((entry) => isExpectedUnmanagedExtension(entry.name, entry.directory)).map((entry) => `${entry.layer}:${entry.name}`).sort((left, right) => left.localeCompare(right));
+  const unmanagedActionRequiredExtensions = unmanagedLoadedEntries.filter((entry) => !isExpectedUnmanagedExtension(entry.name, entry.directory)).map((entry) => `${entry.layer}:${entry.name}`).sort((left, right) => left.localeCompare(right));
+  const updateCoverageWarnings = unmanagedActionRequiredExtensions.length > 0 ? [`extension_update_health_partial_coverage:skipped_unmanaged:${unmanagedActionRequiredExtensions.length}`] : [];
+  const extensionWarnings = [
+    ...loadResult.warnings,
+    ...activationDetails.warnings,
+    ...migrationStatus.warnings,
+    ...projectManagedState.warnings,
+    ...globalManagedState.warnings,
+    ...updateCoverageWarnings
+  ];
+  const capabilityGuidance = collectUnknownCapabilityGuidance(extensionWarnings);
+  const capabilityContract = buildCapabilityContractMetadata();
+  const extensionTriage = buildExtensionHealthTriageSummary(extensionWarnings, loadResult.failed.length, activationResult.failed.length, migrationStatus.summary, projectManagedState.warnings.length + globalManagedState.warnings.length, projectManagedState.state.entries.length + globalManagedState.state.entries.length, unmanagedLoadedExtensions, unmanagedExpectedExtensions, unmanagedActionRequiredExtensions);
+  return {
+    check: {
+      name: "extensions",
+      status: extensionWarnings.length === 0 ? "ok" : "warn",
+      details: {
+        ...loadResult,
+        loaded: loadedSummaries,
+        warnings: extensionWarnings,
+        activation: activationDetails,
+        triage: extensionTriage,
+        capability_contract: capabilityContract,
+        capability_guidance: capabilityGuidance
+      }
+    },
+    warnings: extensionWarnings
+  };
+}
+function summarizeList(values, limit) {
+  if (values.length <= limit) {
+    return { values, truncated: false };
+  }
+  return {
+    values: values.slice(0, limit),
+    truncated: true
+  };
+}
+function summarizeRecordList(value, limit) {
+  if (!Array.isArray(value)) {
+    return {
+      count: 0,
+      sample: [],
+      truncated: false
+    };
+  }
+  return {
+    count: value.length,
+    sample: value.slice(0, limit),
+    truncated: value.length > limit
+  };
+}
+function summarizeExtensionRecord(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return {};
+  }
+  const record = value;
+  return {
+    layer: record.layer,
+    directory: record.directory,
+    name: record.name,
+    version: record.version,
+    enabled: record.enabled,
+    status: record.status,
+    has_activate: record.has_activate,
+    capabilities: record.capabilities
+  };
+}
+function summarizeExtensionList(value, limit) {
+  const summary = summarizeRecordList(value, limit);
+  return {
+    ...summary,
+    sample: summary.sample.map((entry) => summarizeExtensionRecord(entry))
+  };
+}
+function summarizeStringList(value, limit) {
+  if (!Array.isArray(value)) {
+    return {
+      count: 0,
+      sample: [],
+      truncated: false
+    };
+  }
+  const strings = value.filter((entry) => typeof entry === "string");
+  return {
+    count: strings.length,
+    sample: strings.slice(0, limit),
+    truncated: strings.length > limit
+  };
+}
+function summarizeHealthCheckDetails(check, limit) {
+  const details = check.details;
+  if (check.name === "settings") {
+    return {
+      version: details.version,
+      id_prefix: details.id_prefix,
+      locks_ttl_seconds: details.locks_ttl_seconds,
+      warnings: summarizeStringList(details.warnings, limit)
+    };
+  }
+  if (check.name === "directories") {
+    return {
+      required_count: Array.isArray(details.required) ? details.required.length : 0,
+      optional_count: Array.isArray(details.optional) ? details.optional.length : 0,
+      missing_required: summarizeStringList(details.missing_required, limit),
+      missing_optional: summarizeStringList(details.missing_optional, limit),
+      missing: summarizeStringList(details.missing, limit),
+      strict_directories: details.strict_directories
+    };
+  }
+  if (check.name === "settings_values") {
+    return {
+      warnings: summarizeStringList(details.warnings, limit)
+    };
+  }
+  if (check.name === "telemetry") {
+    return {
+      enabled: details.enabled,
+      capture_level: details.capture_level,
+      endpoint: details.endpoint,
+      queue_exists: details.queue_exists,
+      queue_entries: details.queue_entries,
+      queue_draining: details.queue_draining,
+      queue_invalid_rows: details.queue_invalid_rows,
+      queue_rows_total: details.queue_rows_total,
+      last_successful_flush_at: details.last_successful_flush_at,
+      last_failed_flush_at: details.last_failed_flush_at,
+      endpoint_probe: details.endpoint_probe,
+      env_overrides: details.env_overrides
+    };
+  }
+  if (check.name === "extensions") {
+    const activation = typeof details.activation === "object" && details.activation !== null ? details.activation : {};
+    return {
+      disabled_by_flag: details.disabled_by_flag,
+      discovered: summarizeExtensionList(details.discovered, limit),
+      effective: summarizeExtensionList(details.effective, limit),
+      loaded: summarizeExtensionList(details.loaded, limit),
+      failed: summarizeRecordList(details.failed, limit),
+      warnings: summarizeStringList(details.warnings, limit),
+      activation: {
+        failed: summarizeRecordList(activation.failed, limit),
+        warnings: summarizeStringList(activation.warnings, limit),
+        hook_counts: activation.hook_counts,
+        command_handler_count: activation.command_handler_count,
+        service_override_count: activation.service_override_count,
+        renderer_override_count: activation.renderer_override_count,
+        registration_counts: activation.registration_counts,
+        migration_status: typeof activation.migration_status === "object" && activation.migration_status !== null ? {
+          applied_count: activation.migration_status.applied_count,
+          pending_count: activation.migration_status.pending_count,
+          failed_count: activation.migration_status.failed_count
+        } : null
+      },
+      triage: details.triage,
+      capability_contract: details.capability_contract,
+      capability_guidance: summarizeRecordList(details.capability_guidance, limit)
+    };
+  }
+  if (check.name === "storage") {
+    return details;
+  }
+  if (check.name === "integrity") {
+    return {
+      checked_item_files: details.checked_item_files,
+      checked_history_streams: details.checked_history_streams,
+      counts: details.counts,
+      item_unreadable: summarizeStringList(details.item_unreadable, limit),
+      item_conflict_markers: summarizeRecordList(details.item_conflict_markers, limit),
+      item_parse_failures: summarizeStringList(details.item_parse_failures, limit),
+      history_unreadable: summarizeStringList(details.history_unreadable, limit),
+      history_conflict_markers: summarizeRecordList(details.history_conflict_markers, limit),
+      history_invalid_json: summarizeRecordList(details.history_invalid_json, limit),
+      skipped: details.skipped
+    };
+  }
+  if (check.name === "history_drift") {
+    return {
+      checked_items: details.checked_items,
+      counts: details.counts,
+      drifted_items: summarizeStringList(details.drifted_items, limit),
+      missing_streams: summarizeStringList(details.missing_streams, limit),
+      unreadable_streams: summarizeStringList(details.unreadable_streams, limit),
+      hash_mismatches: summarizeStringList(details.hash_mismatches, limit),
+      chain_mismatches: summarizeStringList(details.chain_mismatches, limit),
+      skipped: details.skipped
+    };
+  }
+  if (check.name === "vectorization") {
+    return {
+      semantic_runtime_available: details.semantic_runtime_available,
+      compatibility_mode_auto_defaults: details.compatibility_mode_auto_defaults,
+      auto_ollama_defaults_applied: details.auto_ollama_defaults_applied,
+      refresh_policy: details.refresh_policy,
+      provider_active: details.provider_active,
+      vector_store_active: details.vector_store_active,
+      items: details.items,
+      ledger_entries_before: details.ledger_entries_before,
+      stale_items_before_total: details.stale_items_before_total,
+      stale_items_before: summarizeStringList(details.stale_items_before, limit),
+      refresh_attempted: details.refresh_attempted,
+      refresh_skipped_reason: details.refresh_skipped_reason,
+      refresh_result: details.refresh_result,
+      ledger_entries_after: details.ledger_entries_after,
+      stale_items_after_total: details.stale_items_after_total,
+      stale_items_after: summarizeStringList(details.stale_items_after, limit),
+      skipped: details.skipped
+    };
+  }
+  return details;
+}
+function applyBriefHealthProjection(result) {
+  const warningsSummary = summarizeStringList(result.warnings, BRIEF_HEALTH_DETAIL_LIMIT);
+  return {
+    ok: result.ok,
+    checks: result.checks.map((check) => ({
+      name: check.name,
+      status: check.status,
+      details: summarizeHealthCheckDetails(check, BRIEF_HEALTH_DETAIL_LIMIT)
+    })),
+    warnings: warningsSummary.sample,
+    projection: {
+      mode: "brief",
+      warning_count: warningsSummary.count,
+      warnings_truncated: warningsSummary.truncated,
+      detail_limit: BRIEF_HEALTH_DETAIL_LIMIT
+    },
+    generated_at: result.generated_at
+  };
+}
+function isSkippedHealthCheck(check) {
+  return check.details.skipped === true;
+}
+function applySummaryHealthProjection(result) {
+  const warningsSummary = summarizeStringList(result.warnings, BRIEF_HEALTH_DETAIL_LIMIT);
+  const omittedChecks = result.checks.filter(isSkippedHealthCheck).map((check) => check.name);
+  return {
+    ok: result.ok,
+    checks: result.checks.filter((check) => !isSkippedHealthCheck(check)).map((check) => ({
+      name: check.name,
+      status: check.status,
+      details: {}
+    })),
+    warning_count: warningsSummary.count,
+    warnings: warningsSummary.sample,
+    projection: {
+      mode: "summary",
+      warning_count: warningsSummary.count,
+      warnings_truncated: warningsSummary.truncated,
+      detail_limit: BRIEF_HEALTH_DETAIL_LIMIT,
+      omitted_checks: omittedChecks
+    },
+    generated_at: result.generated_at
+  };
+}
+function selectStaleItemDetail(values, verboseStaleItems) {
+  if (verboseStaleItems) {
+    return {
+      values,
+      truncated: false,
+      total: values.length
+    };
+  }
+  const summary = summarizeList(values, STALE_VECTORIZATION_SUMMARY_LIMIT);
+  return {
+    values: summary.values,
+    truncated: summary.truncated,
+    total: values.length
+  };
+}
+function telemetryEnvFlagEnabled(envKey) {
+  const value = (process.env[envKey] ?? "").trim().toLowerCase();
+  return value === "1" || value === "true" || value === "yes" || value === "on";
+}
+function normalizeEndpointForDisplay(rawEndpoint) {
+  const trimmed = rawEndpoint.trim();
+  if (trimmed.length === 0) {
+    return "";
+  }
+  try {
+    const parsed = new URL(trimmed);
+    parsed.username = "";
+    parsed.password = "";
+    parsed.search = "";
+    parsed.hash = "";
+    return parsed.toString();
+  } catch {
+    return trimmed;
+  }
+}
+function parseTelemetryQueue(raw) {
+  let validEntries = 0;
+  let invalidRows = 0;
+  let totalRows = 0;
+  for (const line of raw.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) {
+      continue;
+    }
+    totalRows += 1;
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (typeof parsed === "object" && parsed !== null && typeof parsed.attempts === "number") {
+        validEntries += 1;
+      } else {
+        invalidRows += 1;
+      }
+    } catch {
+      invalidRows += 1;
+    }
+  }
+  return {
+    validEntries,
+    invalidRows,
+    totalRows
+  };
+}
+async function probeTelemetryEndpointHealth(endpoint) {
+  let probeUrl = endpoint;
+  try {
+    const parsed = new URL(endpoint);
+    parsed.pathname = "/healthz";
+    parsed.search = "";
+    parsed.hash = "";
+    probeUrl = parsed.toString();
+  } catch {
+  }
+  try {
+    const response = await fetch(probeUrl, {
+      method: "GET",
+      signal: AbortSignal.timeout(TELEMETRY_ENDPOINT_PROBE_TIMEOUT_MS)
+    });
+    return {
+      probe_url: normalizeEndpointForDisplay(probeUrl),
+      ok: response.ok,
+      status: response.status
+    };
+  } catch (error) {
+    return {
+      probe_url: normalizeEndpointForDisplay(probeUrl),
+      ok: false,
+      error: error instanceof Error ? error.message : "probe_failed"
+    };
+  }
+}
+async function buildTelemetryCheck(settings, options) {
+  const globalPmRoot = resolveGlobalPmRoot(process.cwd());
+  const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);
+  const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);
+  const queueRaw = await readFileIfExists(queuePath);
+  const queueExists = queueRaw !== null;
+  const queueSizeBytes = queueRaw ? Buffer.byteLength(queueRaw, "utf8") : 0;
+  const queueSummary = queueRaw ? parseTelemetryQueue(queueRaw) : { validEntries: 0, invalidRows: 0, totalRows: 0 };
+  const stateRaw = await readFileIfExists(statePath);
+  let runtimeState = {};
+  let stateParseFailed = false;
+  if (stateRaw && stateRaw.trim().length > 0) {
+    try {
+      const parsed = JSON.parse(stateRaw);
+      if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+        runtimeState = parsed;
+      } else {
+        stateParseFailed = true;
+      }
+    } catch {
+      stateParseFailed = true;
+    }
+  }
+  const endpoint = settings.telemetry.endpoint.trim();
+  const endpointDisplay = normalizeEndpointForDisplay(endpoint);
+  let endpointProbe;
+  if (options.checkTelemetry && settings.telemetry.enabled && endpoint.length > 0) {
+    const probe = await probeTelemetryEndpointHealth(endpoint);
+    endpointProbe = {
+      attempted: true,
+      ...probe
+    };
+  }
+  const warnings = [];
+  if (stateParseFailed) {
+    warnings.push("telemetry_state_invalid_json");
+  }
+  if (queueSummary.invalidRows > 0) {
+    warnings.push(`telemetry_queue_invalid_rows:${queueSummary.invalidRows}`);
+  }
+  const queueHasEntries = settings.telemetry.enabled && queueSummary.validEntries > 0;
+  if (queueHasEntries) {
+    const lastSuccess = runtimeState.last_successful_flush_at;
+    const lastFailure = runtimeState.last_failed_flush_at;
+    const activeFailure = lastFailure && (!lastSuccess || lastFailure > lastSuccess);
+    const neverFlushed = !lastSuccess;
+    const highWater = queueSummary.validEntries >= TELEMETRY_QUEUE_HIGH_WATER_MARK;
+    if (activeFailure || neverFlushed || highWater) {
+      warnings.push(`telemetry_queue_pending:${queueSummary.validEntries}`);
+    }
+  }
+  if (endpointProbe && !endpointProbe.ok) {
+    if (typeof endpointProbe.status === "number") {
+      warnings.push(`telemetry_endpoint_probe_http_status:${endpointProbe.status}`);
+    } else {
+      warnings.push("telemetry_endpoint_probe_failed");
+    }
+  }
+  return {
+    check: {
+      name: "telemetry",
+      status: warnings.length === 0 ? "ok" : "warn",
+      details: {
+        enabled: settings.telemetry.enabled,
+        capture_level: settings.telemetry.capture_level,
+        endpoint: endpointDisplay,
+        global_pm_root: globalPmRoot,
+        queue_path: queuePath,
+        queue_exists: queueExists,
+        queue_entries: queueSummary.validEntries,
+        queue_draining: queueHasEntries && warnings.every((w) => !w.startsWith("telemetry_queue_pending:")),
+        queue_invalid_rows: queueSummary.invalidRows,
+        queue_rows_total: queueSummary.totalRows,
+        queue_size_bytes: queueSizeBytes,
+        runtime_state_path: statePath,
+        last_attempted_flush_at: runtimeState.last_attempted_flush_at ?? null,
+        last_successful_flush_at: runtimeState.last_successful_flush_at ?? null,
+        last_failed_flush_at: runtimeState.last_failed_flush_at ?? null,
+        last_failed_flush_error: runtimeState.last_failed_flush_error ?? null,
+        endpoint_probe: endpointProbe ?? {
+          attempted: false
+        },
+        env_overrides: {
+          telemetry_disabled: telemetryEnvFlagEnabled("PM_TELEMETRY_DISABLED") || telemetryEnvFlagEnabled("PM_NO_TELEMETRY"),
+          pm_no_telemetry: telemetryEnvFlagEnabled("PM_NO_TELEMETRY"),
+          telemetry_otel_disabled: telemetryEnvFlagEnabled("PM_TELEMETRY_OTEL_DISABLED")
+        }
+      }
+    },
+    warnings
+  };
+}
+async function buildHistoryDriftCheck(pmRoot, items) {
+  const { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems } = await scanHistoryDrift(pmRoot, items);
+  const warnings = [
+    ...missingStreams.map((id) => `history_drift_missing_stream:${id}`),
+    ...unreadableStreams.map((id) => `history_drift_unreadable_stream:${id}`),
+    ...hashMismatches.map((id) => `history_drift_hash_mismatch:${id}`),
+    ...chainMismatches.map((id) => `history_drift_chain_mismatch:${id}`)
+  ];
+  return {
+    check: {
+      name: "history_drift",
+      status: warnings.length === 0 ? "ok" : "warn",
+      details: {
+        checked_items: items.length,
+        drifted_items: driftedItems,
+        counts: {
+          drifted: driftedItems.length,
+          missing_streams: missingStreams.length,
+          unreadable_streams: unreadableStreams.length,
+          hash_mismatches: hashMismatches.length,
+          chain_mismatches: chainMismatches.length
+        },
+        missing_streams: missingStreams,
+        unreadable_streams: unreadableStreams,
+        hash_mismatches: hashMismatches,
+        chain_mismatches: chainMismatches
+      }
+    },
+    warnings
+  };
+}
+async function buildVectorizationCheck(pmRoot, settings, items, refreshPolicy, verboseStaleItems) {
+  const runtimeDefaults = resolveSettingsWithSemanticRuntimeDefaults(settings);
+  const providerResolution = resolveEmbeddingProviders(runtimeDefaults.settings);
+  const vectorStoreResolution = resolveVectorStores(runtimeDefaults.settings);
+  const semanticRuntimeAvailable = Boolean(providerResolution.active && vectorStoreResolution.active);
+  const ledgerBefore = await readVectorizationStatusLedger(pmRoot);
+  const staleBefore = semanticRuntimeAvailable ? collectStaleVectorizationIds(items, ledgerBefore.entries) : [];
+  let refreshResult = {
+    refreshed: [],
+    skipped: [],
+    warnings: []
+  };
+  if (refreshPolicy.enabled && semanticRuntimeAvailable && staleBefore.length > 0) {
+    refreshResult = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, staleBefore, {
+      settings: runtimeDefaults.settings,
+      apply_runtime_defaults: false
+    });
+  }
+  const ledgerAfter = await readVectorizationStatusLedger(pmRoot);
+  const staleAfter = semanticRuntimeAvailable ? collectStaleVectorizationIds(items, ledgerAfter.entries) : [];
+  const strictVectorizationWarnings = !runtimeDefaults.auto_ollama_defaults_applied;
+  const warningSet = /* @__PURE__ */ new Set([...ledgerBefore.warnings, ...ledgerAfter.warnings]);
+  if (strictVectorizationWarnings) {
+    for (const warning of refreshResult.warnings) {
+      warningSet.add(warning);
+    }
+  }
+  if (strictVectorizationWarnings && semanticRuntimeAvailable && staleAfter.length > 0) {
+    warningSet.add(`vectorization_stale_items_remaining:${staleAfter.length}`);
+  }
+  const warnings = [...warningSet].sort((left, right) => left.localeCompare(right));
+  const staleBeforeDetail = selectStaleItemDetail(staleBefore, verboseStaleItems);
+  const staleAfterDetail = selectStaleItemDetail(staleAfter, verboseStaleItems);
+  return {
+    check: {
+      name: "vectorization",
+      status: warnings.length === 0 ? "ok" : "warn",
+      details: {
+        semantic_runtime_available: semanticRuntimeAvailable,
+        compatibility_mode_auto_defaults: runtimeDefaults.auto_ollama_defaults_applied,
+        auto_ollama_defaults_applied: runtimeDefaults.auto_ollama_defaults_applied,
+        refresh_policy: {
+          enabled: refreshPolicy.enabled,
+          check_only: refreshPolicy.checkOnly,
+          no_refresh: refreshPolicy.noRefresh,
+          refresh_vectors: refreshPolicy.refreshVectors
+        },
+        provider_active: providerResolution.active?.name ?? null,
+        vector_store_active: vectorStoreResolution.active?.name ?? null,
+        items: items.length,
+        ledger_entries_before: Object.keys(ledgerBefore.entries).length,
+        stale_items_detail_mode: verboseStaleItems ? "full" : "summary",
+        stale_items_summary_limit: STALE_VECTORIZATION_SUMMARY_LIMIT,
+        stale_items_before_total: staleBeforeDetail.total,
+        stale_items_before: staleBeforeDetail.values,
+        stale_items_before_truncated: staleBeforeDetail.truncated,
+        refresh_attempted: refreshPolicy.enabled && staleBefore.length > 0 && semanticRuntimeAvailable,
+        refresh_skipped_reason: refreshPolicy.enabled && semanticRuntimeAvailable && staleBefore.length > 0 ? null : !refreshPolicy.enabled ? "refresh_disabled" : !semanticRuntimeAvailable ? "semantic_runtime_unavailable" : "no_stale_items",
+        refresh_result: refreshResult,
+        ledger_entries_after: Object.keys(ledgerAfter.entries).length,
+        stale_items_after_total: staleAfterDetail.total,
+        stale_items_after: staleAfterDetail.values,
+        stale_items_after_truncated: staleAfterDetail.truncated
+      }
+    },
+    warnings
+  };
+}
+function validateSettingsValues(settings) {
+  const warnings = [];
+  if (settings.id_prefix.trim().length === 0) {
+    warnings.push("settings:id_prefix_empty");
+  }
+  if (settings.locks.ttl_seconds <= 0) {
+    warnings.push("settings:locks_ttl_non_positive");
+  }
+  return warnings;
+}
+function resolveVectorRefreshPolicy(options) {
+  const checkOnly = options.checkOnly === true;
+  const noRefresh = options.noRefresh === true || checkOnly;
+  const refreshVectors = options.refreshVectors === true;
+  if (refreshVectors && checkOnly) {
+    throw new PmCliError("--check-only cannot be combined with --refresh-vectors", EXIT_CODE.USAGE);
+  }
+  if (refreshVectors && options.noRefresh === true) {
+    throw new PmCliError("--no-refresh cannot be combined with --refresh-vectors", EXIT_CODE.USAGE);
+  }
+  return {
+    enabled: refreshVectors || !noRefresh,
+    checkOnly,
+    noRefresh,
+    refreshVectors
+  };
+}
+async function runHealth(global2, options = {}) {
+  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  const settingsPath = getSettingsPath(pmRoot);
+  if (!await pathExists(settingsPath)) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const { settings, warnings: settingsReadWarnings } = await readSettingsWithMetadata(pmRoot);
+  const normalizedSettingsReadWarnings = [...new Set(settingsReadWarnings)];
+  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+  const strictDirectories = options.strictDirectories === true;
+  const refreshPolicy = resolveVectorRefreshPolicy(options);
+  const optionalBuiltinDirs = new Set(PM_OPTIONAL_TYPE_SUBDIRS.filter((entry) => entry.length > 0));
+  const requiredDirSet = new Set(PM_CORE_REQUIRED_SUBDIRS.filter((entry) => entry.length > 0));
+  const optionalDirSet = /* @__PURE__ */ new Set();
+  for (const folder of typeRegistry.folders) {
+    if (optionalBuiltinDirs.has(folder)) {
+      optionalDirSet.add(folder);
+      continue;
+    }
+    requiredDirSet.add(folder);
+  }
+  const requiredDirs = [...requiredDirSet].sort((left, right) => left.localeCompare(right));
+  const optionalDirs = [...optionalDirSet].sort((left, right) => left.localeCompare(right));
+  const missingRequiredDirs = [];
+  const missingOptionalDirs = [];
+  const hookWarnings = [];
+  for (const relativeDir of [...requiredDirs, ...optionalDirs]) {
+    const directoryPath = path.join(pmRoot, relativeDir);
+    hookWarnings.push(...await runActiveOnReadHooks({
+      path: directoryPath,
+      scope: "project"
+    }));
+    if (!await isDirectory(directoryPath)) {
+      if (optionalDirSet.has(relativeDir)) {
+        missingOptionalDirs.push(relativeDir);
+      } else {
+        missingRequiredDirs.push(relativeDir);
+      }
+    }
+  }
+  const missingDirs = strictDirectories ? [...missingRequiredDirs, ...missingOptionalDirs] : [...missingRequiredDirs];
+  const settingWarnings = validateSettingsValues(settings);
+  const telemetryCheck = await buildTelemetryCheck(settings, {
+    checkTelemetry: options.checkTelemetry === true
+  });
+  const extensionCheck = await buildExtensionCheck(pmRoot, settings, Boolean(global2.noExtensions));
+  const summaryMode = options.summary === true && options.full !== true;
+  const fastProjectionCheckOnly = options.checkOnly === true && (options.brief === true || options.summary === true) && options.full !== true;
+  const skipIntegrity = (options.skipIntegrity === true || fastProjectionCheckOnly) && options.full !== true;
+  const skipDrift = (options.skipDrift === true || fastProjectionCheckOnly) && options.full !== true;
+  const skipVectors = (options.skipVectors === true || fastProjectionCheckOnly) && options.full !== true;
+  const itemReadWarnings = [];
+  const items = skipDrift && skipVectors ? await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, itemReadWarnings, settings.schema) : await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, itemReadWarnings, settings.schema);
+  const itemsWithBody = items;
+  const normalizedItemReadWarnings = [...new Set(itemReadWarnings)];
+  const historyPolicy = skipDrift ? { warnings: [] } : await enforceHistoryStreamPolicyForItems({
+    pmRoot,
+    settings,
+    itemIds: items.map((item) => item.id),
+    commandLabel: "health"
+  });
+  const historySummary = await countHistoryStreams(pmRoot);
+  const integrityCheck = skipIntegrity ? { check: { name: "integrity", status: "ok", details: { skipped: true } }, warnings: [] } : await buildIntegrityCheck(pmRoot, typeRegistry.type_to_folder, settings.schema);
+  const historyDriftCheck = skipDrift ? { check: { name: "history_drift", status: "ok", details: { skipped: true } }, warnings: [] } : await buildHistoryDriftCheck(pmRoot, itemsWithBody);
+  const vectorizationCheck = skipVectors ? { check: { name: "vectorization", status: "ok", details: { skipped: true } }, warnings: [] } : await buildVectorizationCheck(pmRoot, settings, itemsWithBody, refreshPolicy, options.verboseStaleItems === true);
+  const checks = [
+    {
+      name: "settings",
+      status: normalizedSettingsReadWarnings.length === 0 ? "ok" : "warn",
+      details: {
+        path: settingsPath,
+        version: settings.version,
+        id_prefix: settings.id_prefix,
+        locks_ttl_seconds: settings.locks.ttl_seconds,
+        warnings: normalizedSettingsReadWarnings
+      }
+    },
+    {
+      name: "directories",
+      status: missingDirs.length === 0 ? "ok" : "warn",
+      details: {
+        required: requiredDirs,
+        optional: optionalDirs,
+        missing_required: missingRequiredDirs,
+        missing_optional: missingOptionalDirs,
+        missing: missingDirs,
+        strict_directories: strictDirectories
+      }
+    },
+    {
+      name: "settings_values",
+      status: settingWarnings.length === 0 ? "ok" : "warn",
+      details: {
+        warnings: settingWarnings
+      }
+    },
+    telemetryCheck.check,
+    extensionCheck.check,
+    {
+      name: "storage",
+      status: "ok",
+      details: {
+        items: items.length,
+        history_streams: historySummary.count
+      }
+    },
+    integrityCheck.check,
+    historyDriftCheck.check,
+    vectorizationCheck.check
+  ];
+  const warnings = [
+    ...missingDirs.map((dir) => `missing_directory:${dir}`),
+    ...normalizedSettingsReadWarnings,
+    ...settingWarnings,
+    ...normalizedItemReadWarnings,
+    ...telemetryCheck.warnings,
+    ...extensionCheck.warnings,
+    ...historyPolicy.warnings,
+    ...historySummary.warnings,
+    ...integrityCheck.warnings,
+    ...historyDriftCheck.warnings,
+    ...vectorizationCheck.warnings,
+    ...hookWarnings
+  ];
+  const normalizedWarnings = [...new Set(warnings)];
+  const checkRemediationSources = {
+    settings: normalizedSettingsReadWarnings,
+    directories: missingDirs.map((dir) => `missing_directory:${dir}`),
+    settings_values: settingWarnings,
+    telemetry: telemetryCheck.warnings,
+    integrity: integrityCheck.warnings,
+    history_drift: historyDriftCheck.warnings,
+    vectorization: vectorizationCheck.warnings
+  };
+  for (const check of checks) {
+    const sources = checkRemediationSources[check.name];
+    if (sources === void 0) {
+      continue;
+    }
+    const remediationMap = buildRemediationMap(sources);
+    if (Object.keys(remediationMap).length > 0) {
+      check.details = { ...check.details, remediation_map: remediationMap };
+    }
+  }
+  const blockingWarnings = normalizedWarnings.filter((warning) => !isAdvisoryHealthWarning(warning));
+  const result = {
+    ok: blockingWarnings.length === 0,
+    checks,
+    warnings: normalizedWarnings,
+    generated_at: nowIso()
+  };
+  if (summaryMode) {
+    return applySummaryHealthProjection(result);
+  }
+  return options.brief === true ? applyBriefHealthProjection(result) : result;
+}
+export {
+  runHealth
+};
+//# sourceMappingURL=health-IT5DBPRJ.js.map