@unbrained/pm-cli 2026.6.20 → 2026.6.21

package/dist/cli/commands/validate.d.ts

@@ -4,7 +4,7 @@ import { listAllFrontMatterWithBody } from "../../core/store/item-store.js";
 import { type StaleLinkPruneRow, type TerminalParentFixRow, type ValidateFixRecord } from "../../core/validate/fix-planning.js";
 import { type DuplicateIssueCode } from "../../core/governance/issue-codes.js";
 import type { ValidateMetadataProfile, ValidateMetadataRequiredField } from "../../types/index.js";
-type ValidateCheckName = "metadata" | "resolution" | "lifecycle" | "files" | "command_references" | "history_drift";
+type ValidateCheckName = "metadata" | "resolution" | "lifecycle" | "files" | "command_references" | "history_drift" | "format_version";
 type ValidateStatus = "ok" | "warn" | "error";
 type ValidateDependencyCycleSeverity = "off" | "warn" | "error";
 type ValidateFileScanMode = "default" | "tracked-all" | "tracked-all-strict";

package/dist/cli/commands/validate.js

@@ -4,7 +4,7 @@
  * Implements the pm validate command surface and its agent-facing runtime behavior.
  */
 
-!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]="aa10e4f7-f600-5c38-a16f-2a08c11daab4")}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]="45e0faee-e9a6-5db2-bdf1-f955fd494833")}catch(e){}}();
 import fs from "node:fs/promises";
 import { realpathSync } from "node:fs";
 import { execFile } from "node:child_process";
@@ -21,6 +21,7 @@ import { DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS, DEFAULT_VALIDATE
 import { PmCliError } from "../../core/shared/errors.js";
 import { toNonEmptyStringOrUndefined } from "../../core/shared/primitives.js";
 import { nowIso } from "../../core/shared/time.js";
+import { CURRENT_ITEM_FORMAT_VERSION, effectiveItemFormatVersion, scanItemFormatVersions, } from "../../core/item/item-format-version.js";
 import { listAllFrontMatterWithBody } from "../../core/store/item-store.js";
 import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
@@ -611,6 +612,7 @@ function resolveRequestedChecks(options) {
             requested.add("files");
             requested.add("command_references");
             requested.add("history_drift");
+            requested.add("format_version");
         }
         return requested;
     }
@@ -1530,6 +1532,43 @@ function buildCommandReferencesCheck(items, idPrefix, verboseDiagnostics) {
     };
 }
 /* c8 ignore stop */
+/* c8 ignore start -- format-version diagnostics projection is covered by validate format-version integration fixtures */
+function buildFormatVersionCheck(items, verboseDiagnostics) {
+    const scan = scanItemFormatVersions(items.map((item) => ({ ref: item.id, version: effectiveItemFormatVersion(item) })));
+    const warnings = [];
+    if (scan.outdated.length > 0) {
+        warnings.push(`validate_format_version_outdated_items:${scan.outdated.length}`);
+    }
+    if (scan.ahead.length > 0) {
+        warnings.push(`validate_format_version_ahead_items:${scan.ahead.length}`);
+    }
+    const diagnosticLimit = verboseDiagnostics ? Number.POSITIVE_INFINITY : DIAGNOSTIC_LIST_SUMMARY_LIMIT;
+    const summarizedOutdated = summarizeList(scan.outdated, diagnosticLimit);
+    const summarizedAhead = summarizeList(scan.ahead, diagnosticLimit);
+    // `ahead` items were written by a newer pm than this runtime: validation
+    // cannot vouch for fields it does not understand, so it is an error (upgrade
+    // pm). `outdated` items are a non-fatal warning (a migration would rewrite
+    // them). At the current baseline version neither list is populated.
+    const status = scan.ahead.length > 0 ? "error" : scan.outdated.length > 0 ? "warn" : "ok";
+    return {
+        check: {
+            name: "format_version",
+            status,
+            details: {
+                checked_items: items.length,
+                current_format_version: CURRENT_ITEM_FORMAT_VERSION,
+                outdated_items_count: scan.outdated.length,
+                outdated_items: summarizedOutdated.values,
+                outdated_items_truncated: summarizedOutdated.truncated,
+                ahead_items_count: scan.ahead.length,
+                ahead_items: summarizedAhead.values,
+                ahead_items_truncated: summarizedAhead.truncated,
+            },
+        },
+        warnings,
+    };
+}
+/* c8 ignore stop */
 const VALIDATE_AUTO_FIX_MESSAGE = "pm validate auto-fix";
 /**
  * Apply one planned fix through the SAME audited command paths an operator
@@ -1743,6 +1782,9 @@ export async function runValidate(options, global) {
     if (requestedChecks.has("history_drift")) {
         record(await buildHistoryDriftCheck(pmRoot, items, fullDiagnostics));
     }
+    if (requestedChecks.has("format_version")) {
+        record(buildFormatVersionCheck(items, fullDiagnostics));
+    }
     // Remediation phase (pm-c3sz / pm-8jss / pm-0v2m). Plans are derived from
     // the findings of THIS run; checks above always report the pre-fix state.
     // Safe field backfills apply by default under --auto-fix; gated lifecycle
@@ -1803,4 +1845,4 @@ export async function runValidate(options, global) {
 }
 /* c8 ignore stop */
 //# sourceMappingURL=validate.js.map
-//# debugId=aa10e4f7-f600-5c38-a16f-2a08c11daab4
+//# debugId=45e0faee-e9a6-5db2-bdf1-f955fd494833