@unbrained/pm-cli 2026.7.1 → 2026.7.2

package/dist/core/history/drift-scan.js

@@ -4,7 +4,7 @@
  * Implements append-only history and replay behavior for Drift Scan.
  */
 
-!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]="a928aad0-855f-5c7f-aa00-77d698ddca80")}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]="91c6995a-7219-5402-b2d4-e50227bf0149")}catch(e){}}();
 import fs from "fs/promises";
 import { createHash } from "node:crypto";
 import path from "node:path";
@@ -75,6 +75,62 @@ async function verifyHistoryStream(historyPath) {
         contentHash,
     };
 }
+function cacheMetadataMatches(cached, stat) {
+    return cached !== undefined && cached.mtime_ms === stat.mtimeMs && cached.ctime_ms === stat.ctimeMs && cached.size === stat.size;
+}
+async function loadFreshStreamVerification(itemId, historyPath, accumulator) {
+    try {
+        const loaded = await verifyHistoryStream(historyPath);
+        if (!loaded) {
+            accumulator.missingStreams.push(itemId);
+            return null;
+        }
+        return loaded;
+    }
+    catch {
+        accumulator.unreadableStreams.push(itemId);
+        return null;
+    }
+}
+async function resolveStreamVerification(params) {
+    const cachedContentHash = typeof params.cached?.content_hash === "string" && params.cached.content_hash.length > 0
+        ? params.cached.content_hash
+        : undefined;
+    const canUseCache = cacheMetadataMatches(params.cached, params.stat) && cachedContentHash !== undefined && params.cached !== undefined;
+    if (!canUseCache || !params.cached) {
+        return {
+            verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),
+            cacheDirty: true,
+        };
+    }
+    let currentContentHash;
+    if (params.verifyCacheHitByContent) {
+        try {
+            currentContentHash = await readHistoryContentHash(params.historyPath);
+        }
+        catch {
+            params.accumulator.unreadableStreams.push(params.itemId);
+            return { verification: null, cacheDirty: false };
+        }
+    }
+    else {
+        currentContentHash = cachedContentHash;
+    }
+    if (!params.verifyCacheHitByContent || currentContentHash === cachedContentHash) {
+        return {
+            verification: {
+                latestAfterHash: params.cached.latest_after_hash,
+                chainOk: params.cached.chain_ok,
+                contentHash: currentContentHash,
+            },
+            cacheDirty: false,
+        };
+    }
+    return {
+        verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),
+        cacheDirty: true,
+    };
+}
 /**
  * Scan every item's history stream for drift (missing/unreadable streams, broken
  * hash chains, and item/history hash mismatches).
@@ -86,10 +142,12 @@ async function verifyHistoryStream(historyPath) {
  * trusting the stat tuple and skip rereading unchanged streams.
  */
 export async function scanHistoryDrift(pmRoot, items, options = {}) {
-    const missingStreams = [];
-    const unreadableStreams = [];
-    const hashMismatches = [];
-    const chainMismatches = [];
+    const accumulator = {
+        missingStreams: [],
+        unreadableStreams: [],
+        hashMismatches: [],
+        chainMismatches: [],
+    };
     const cache = await loadDriftCache(pmRoot);
     const previousEntries = cache?.entries ?? {};
     const nextEntries = {};
@@ -105,97 +163,44 @@ export async function scanHistoryDrift(pmRoot, items, options = {}) {
         }
         catch (error) {
             if (isErrno(error, "ENOENT")) {
-                missingStreams.push(item.id);
+                accumulator.missingStreams.push(item.id);
             }
             else {
-                unreadableStreams.push(item.id);
+                accumulator.unreadableStreams.push(item.id);
             }
             continue;
         }
-        const loadStreamVerification = async () => {
-            try {
-                return await verifyHistoryStream(historyPath);
-            }
-            catch {
-                return "unreadable";
-            }
-        };
-        const loadFreshVerification = async () => {
-            const loaded = await loadStreamVerification();
-            if (loaded === "unreadable") {
-                unreadableStreams.push(item.id);
-                return null;
-            }
-            if (!loaded) {
-                missingStreams.push(item.id);
-                return null;
-            }
-            return loaded;
-        };
         const cached = previousEntries[item.id];
-        let verification;
-        const metadataMatchesCache = cached !== undefined &&
-            cached.mtime_ms === stat.mtimeMs &&
-            cached.ctime_ms === stat.ctimeMs &&
-            cached.size === stat.size;
-        const cachedContentHash = typeof cached?.content_hash === "string" && cached.content_hash.length > 0 ? cached.content_hash : undefined;
-        const canUseCache = metadataMatchesCache && cachedContentHash !== undefined;
-        if (canUseCache && cached) {
-            let currentContentHash;
-            if (verifyCacheHitByContent) {
-                try {
-                    currentContentHash = await readHistoryContentHash(historyPath);
-                }
-                catch {
-                    unreadableStreams.push(item.id);
-                    continue;
-                }
-            }
-            else {
-                currentContentHash = cachedContentHash;
-            }
-            if (!verifyCacheHitByContent || currentContentHash === cachedContentHash) {
-                verification = {
-                    latestAfterHash: cached.latest_after_hash,
-                    chainOk: cached.chain_ok,
-                    contentHash: currentContentHash,
-                };
-            }
-            else {
-                cacheDirty = true;
-                const refreshed = await loadFreshVerification();
-                if (!refreshed) {
-                    continue;
-                }
-                verification = refreshed;
-            }
-        }
-        else {
-            cacheDirty = true;
-            const refreshed = await loadFreshVerification();
-            if (!refreshed) {
-                continue;
-            }
-            verification = refreshed;
+        const resolved = await resolveStreamVerification({
+            itemId: item.id,
+            historyPath,
+            stat,
+            cached,
+            verifyCacheHitByContent,
+            accumulator,
+        });
+        cacheDirty ||= resolved.cacheDirty;
+        if (!resolved.verification) {
+            continue;
         }
-        if (!verification.chainOk) {
-            chainMismatches.push(item.id);
+        if (!resolved.verification.chainOk) {
+            accumulator.chainMismatches.push(item.id);
         }
         nextEntries[item.id] = {
             mtime_ms: stat.mtimeMs,
             ctime_ms: stat.ctimeMs,
             size: stat.size,
-            content_hash: verification.contentHash,
-            latest_after_hash: verification.latestAfterHash,
-            chain_ok: verification.chainOk,
+            content_hash: resolved.verification.contentHash,
+            latest_after_hash: resolved.verification.latestAfterHash,
+            chain_ok: resolved.verification.chainOk,
         };
         const { body, ...frontMatter } = item;
         const currentHash = hashDocument({
             metadata: frontMatter,
             body,
         });
-        if (currentHash !== verification.latestAfterHash) {
-            hashMismatches.push(item.id);
+        if (currentHash !== resolved.verification.latestAfterHash) {
+            accumulator.hashMismatches.push(item.id);
         }
     }
     if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {
@@ -208,8 +213,15 @@ export async function scanHistoryDrift(pmRoot, items, options = {}) {
             // Best-effort cache write: a failed persist must never fail a health scan.
         }
     }
-    const driftedItems = [...new Set([...missingStreams, ...unreadableStreams, ...hashMismatches, ...chainMismatches])].sort((a, b) => a.localeCompare(b));
-    return { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems };
+    const driftedItems = [
+        ...new Set([
+            ...accumulator.missingStreams,
+            ...accumulator.unreadableStreams,
+            ...accumulator.hashMismatches,
+            ...accumulator.chainMismatches,
+        ]),
+    ].sort((a, b) => a.localeCompare(b));
+    return { ...accumulator, driftedItems };
 }
 //# sourceMappingURL=drift-scan.js.map
-//# debugId=a928aad0-855f-5c7f-aa00-77d698ddca80
+//# debugId=91c6995a-7219-5402-b2d4-e50227bf0149

package/dist/core/history/drift-scan.js.map

@@ -1 +1 @@
-{"version":3,"file":"drift-scan.js","sources":["core/history/drift-scan.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/history/drift-scan\n *\n * Implements append-only history and replay behavior for Drift Scan.\n */\nimport fs from \"fs/promises\";\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { getHistoryPath } from \"../store/paths.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { hashDocument } from \"./history.js\";\nimport { verifyHistoryChain } from \"./replay.js\";\nimport type { HistoryEntry, ItemMetadata } from \"../../types/index.js\";\n\n/**\n * Documents the drift scan result payload exchanged by command, SDK, and package integrations.\n */\nexport interface DriftScanResult {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n  driftedItems: string[];\n}\n\nconst DRIFT_CACHE_VERSION = 3;\nconst DRIFT_CACHE_FILENAME = \"history-drift-cache.json\";\n\n/**\n * Controls how cached history stream verification is trusted when the file stat\n * tuple still matches a previous scan.\n */\nexport type DriftCacheHitVerification = \"content_hash\" | \"metadata\";\n\n/**\n * Documents the history drift scan options shared by health, validate, and\n * repair callers.\n */\nexport interface DriftScanOptions {\n  cacheHitVerification?: DriftCacheHitVerification;\n}\n\ninterface DriftCacheEntry {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n  content_hash: string;\n  latest_after_hash: string;\n  chain_ok: boolean;\n}\n\ninterface DriftCacheEnvelope {\n  version: number;\n  entries: Record<string, DriftCacheEntry>;\n}\n\nfunction getDriftCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", DRIFT_CACHE_FILENAME);\n}\n\nasync function loadDriftCache(pmRoot: string): Promise<DriftCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getDriftCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as DriftCacheEnvelope;\n    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\ninterface StreamVerification {\n  latestAfterHash: string;\n  chainOk: boolean;\n  contentHash: string;\n}\n\nfunction hashContent(raw: string): string {\n  return createHash(\"sha256\").update(raw).digest(\"hex\");\n}\n\nasync function readHistoryContentHash(historyPath: string): Promise<string> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  return hashContent(raw);\n}\n\n/**\n * Read and fully verify one history stream's hash chain. Returns null for an\n * empty/missing stream (caller records it as a missing stream).\n */\nasync function verifyHistoryStream(historyPath: string): Promise<StreamVerification | null> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  const contentHash = hashContent(raw);\n  if (raw.trim().length === 0) {\n    return null;\n  }\n  const entries: HistoryEntry[] = [];\n  let latestAfterHash: string | null = null;\n  for (const line of raw.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const parsed = JSON.parse(trimmed) as HistoryEntry;\n    if (typeof parsed.after_hash !== \"string\" || parsed.after_hash.trim().length === 0) {\n      throw new Error(\"missing after_hash\");\n    }\n    entries.push(parsed);\n    latestAfterHash = parsed.after_hash;\n  }\n  /* c8 ignore start -- defensive guard for future history schema changes. */\n  if (!latestAfterHash) {\n    return null;\n  }\n  /* c8 ignore stop */\n  return {\n    latestAfterHash,\n    chainOk: verifyHistoryChain(entries).ok,\n    contentHash,\n  };\n}\n\n/**\n * Scan every item's history stream for drift (missing/unreadable streams, broken\n * hash chains, and item/history hash mismatches).\n *\n * Full chain re-verification of a large history tree is the dominant cost of\n * `pm health`. We cache the per-stream verification keyed by the history file's\n * mtime/ctime/size plus content hash. Strict callers keep recomputing the\n * content hash on metadata hits; latency-sensitive health checks can opt into\n * trusting the stat tuple and skip rereading unchanged streams.\n */\nexport async function scanHistoryDrift(\n  pmRoot: string,\n  items: Array<ItemMetadata & { body: string }>,\n  options: DriftScanOptions = {},\n): Promise<DriftScanResult> {\n  const missingStreams: string[] = [];\n  const unreadableStreams: string[] = [];\n  const hashMismatches: string[] = [];\n  const chainMismatches: string[] = [];\n\n  const cache = await loadDriftCache(pmRoot);\n  const previousEntries: Record<string, DriftCacheEntry> = cache?.entries ?? {};\n  const nextEntries: Record<string, DriftCacheEntry> = {};\n  let cacheDirty = false;\n  // Metadata mode does not open a stat-matched stream, so unreadable-after-stat\n  // failures are intentionally deferred to strict validate/history-repair scans.\n  const verifyCacheHitByContent = options.cacheHitVerification !== \"metadata\";\n\n  for (const item of items) {\n    const historyPath = getHistoryPath(pmRoot, item.id);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(historyPath);\n    } catch (error: unknown) {\n      if (isErrno(error, \"ENOENT\")) {\n        missingStreams.push(item.id);\n      } else {\n        unreadableStreams.push(item.id);\n      }\n      continue;\n    }\n\n    const loadStreamVerification = async (): Promise<StreamVerification | null | \"unreadable\"> => {\n      try {\n        return await verifyHistoryStream(historyPath);\n      } catch {\n        return \"unreadable\";\n      }\n    };\n\n    const loadFreshVerification = async (): Promise<StreamVerification | null> => {\n      const loaded = await loadStreamVerification();\n      if (loaded === \"unreadable\") {\n        unreadableStreams.push(item.id);\n        return null;\n      }\n      if (!loaded) {\n        missingStreams.push(item.id);\n        return null;\n      }\n      return loaded;\n    };\n\n    const cached = previousEntries[item.id];\n    let verification: StreamVerification;\n    const metadataMatchesCache =\n      cached !== undefined &&\n      cached.mtime_ms === stat.mtimeMs &&\n      cached.ctime_ms === stat.ctimeMs &&\n      cached.size === stat.size;\n    const cachedContentHash =\n      typeof cached?.content_hash === \"string\" && cached.content_hash.length > 0 ? cached.content_hash : undefined;\n    const canUseCache = metadataMatchesCache && cachedContentHash !== undefined;\n    if (canUseCache && cached) {\n      let currentContentHash: string;\n      if (verifyCacheHitByContent) {\n        try {\n          currentContentHash = await readHistoryContentHash(historyPath);\n        } catch {\n          unreadableStreams.push(item.id);\n          continue;\n        }\n      } else {\n        currentContentHash = cachedContentHash;\n      }\n      if (!verifyCacheHitByContent || currentContentHash === cachedContentHash) {\n        verification = {\n          latestAfterHash: cached.latest_after_hash,\n          chainOk: cached.chain_ok,\n          contentHash: currentContentHash,\n        };\n      } else {\n        cacheDirty = true;\n        const refreshed = await loadFreshVerification();\n        if (!refreshed) {\n          continue;\n        }\n        verification = refreshed;\n      }\n    } else {\n      cacheDirty = true;\n      const refreshed = await loadFreshVerification();\n      if (!refreshed) {\n        continue;\n      }\n      verification = refreshed;\n    }\n\n    if (!verification.chainOk) {\n      chainMismatches.push(item.id);\n    }\n    nextEntries[item.id] = {\n      mtime_ms: stat.mtimeMs,\n      ctime_ms: stat.ctimeMs,\n      size: stat.size,\n      content_hash: verification.contentHash,\n      latest_after_hash: verification.latestAfterHash,\n      chain_ok: verification.chainOk,\n    };\n\n    const { body, ...frontMatter } = item;\n    const currentHash = hashDocument({\n      metadata: frontMatter as ItemMetadata,\n      body,\n    });\n    if (currentHash !== verification.latestAfterHash) {\n      hashMismatches.push(item.id);\n    }\n  }\n\n  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {\n    const cachePath = getDriftCachePath(pmRoot);\n    try {\n      await fs.mkdir(path.dirname(cachePath), { recursive: true });\n      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));\n    } catch {\n      // Best-effort cache write: a failed persist must never fail a health scan.\n    }\n  }\n\n  const driftedItems = [...new Set([...missingStreams, ...unreadableStreams, ...hashMismatches, ...chainMismatches])].sort((a, b) =>\n    a.localeCompare(b),\n  );\n  return { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems };\n}\n"],"names":[],"mappings":"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","debugId":"a928aad0-855f-5c7f-aa00-77d698ddca80"}
+{"version":3,"file":"drift-scan.js","sources":["core/history/drift-scan.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/history/drift-scan\n *\n * Implements append-only history and replay behavior for Drift Scan.\n */\nimport fs from \"fs/promises\";\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { getHistoryPath } from \"../store/paths.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { hashDocument } from \"./history.js\";\nimport { verifyHistoryChain } from \"./replay.js\";\nimport type { HistoryEntry, ItemMetadata } from \"../../types/index.js\";\n\n/**\n * Documents the drift scan result payload exchanged by command, SDK, and package integrations.\n */\nexport interface DriftScanResult {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n  driftedItems: string[];\n}\n\nconst DRIFT_CACHE_VERSION = 3;\nconst DRIFT_CACHE_FILENAME = \"history-drift-cache.json\";\n\n/**\n * Controls how cached history stream verification is trusted when the file stat\n * tuple still matches a previous scan.\n */\nexport type DriftCacheHitVerification = \"content_hash\" | \"metadata\";\n\n/**\n * Documents the history drift scan options shared by health, validate, and\n * repair callers.\n */\nexport interface DriftScanOptions {\n  cacheHitVerification?: DriftCacheHitVerification;\n}\n\ninterface DriftCacheEntry {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n  content_hash: string;\n  latest_after_hash: string;\n  chain_ok: boolean;\n}\n\ninterface DriftCacheEnvelope {\n  version: number;\n  entries: Record<string, DriftCacheEntry>;\n}\n\nfunction getDriftCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", DRIFT_CACHE_FILENAME);\n}\n\nasync function loadDriftCache(pmRoot: string): Promise<DriftCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getDriftCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as DriftCacheEnvelope;\n    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\ninterface StreamVerification {\n  latestAfterHash: string;\n  chainOk: boolean;\n  contentHash: string;\n}\n\ninterface DriftScanAccumulator {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n}\n\nfunction hashContent(raw: string): string {\n  return createHash(\"sha256\").update(raw).digest(\"hex\");\n}\n\nasync function readHistoryContentHash(historyPath: string): Promise<string> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  return hashContent(raw);\n}\n\n/**\n * Read and fully verify one history stream's hash chain. Returns null for an\n * empty/missing stream (caller records it as a missing stream).\n */\nasync function verifyHistoryStream(historyPath: string): Promise<StreamVerification | null> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  const contentHash = hashContent(raw);\n  if (raw.trim().length === 0) {\n    return null;\n  }\n  const entries: HistoryEntry[] = [];\n  let latestAfterHash: string | null = null;\n  for (const line of raw.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const parsed = JSON.parse(trimmed) as HistoryEntry;\n    if (typeof parsed.after_hash !== \"string\" || parsed.after_hash.trim().length === 0) {\n      throw new Error(\"missing after_hash\");\n    }\n    entries.push(parsed);\n    latestAfterHash = parsed.after_hash;\n  }\n  /* c8 ignore start -- defensive guard for future history schema changes. */\n  if (!latestAfterHash) {\n    return null;\n  }\n  /* c8 ignore stop */\n  return {\n    latestAfterHash,\n    chainOk: verifyHistoryChain(entries).ok,\n    contentHash,\n  };\n}\n\nfunction cacheMetadataMatches(cached: DriftCacheEntry | undefined, stat: Awaited<ReturnType<typeof fs.stat>>): boolean {\n  return cached !== undefined && cached.mtime_ms === stat.mtimeMs && cached.ctime_ms === stat.ctimeMs && cached.size === stat.size;\n}\n\nasync function loadFreshStreamVerification(\n  itemId: string,\n  historyPath: string,\n  accumulator: DriftScanAccumulator,\n): Promise<StreamVerification | null> {\n  try {\n    const loaded = await verifyHistoryStream(historyPath);\n    if (!loaded) {\n      accumulator.missingStreams.push(itemId);\n      return null;\n    }\n    return loaded;\n  } catch {\n    accumulator.unreadableStreams.push(itemId);\n    return null;\n  }\n}\n\nasync function resolveStreamVerification(params: {\n  itemId: string;\n  historyPath: string;\n  stat: Awaited<ReturnType<typeof fs.stat>>;\n  cached: DriftCacheEntry | undefined;\n  verifyCacheHitByContent: boolean;\n  accumulator: DriftScanAccumulator;\n}): Promise<{ verification: StreamVerification | null; cacheDirty: boolean }> {\n  const cachedContentHash =\n    typeof params.cached?.content_hash === \"string\" && params.cached.content_hash.length > 0\n      ? params.cached.content_hash\n      : undefined;\n  const canUseCache = cacheMetadataMatches(params.cached, params.stat) && cachedContentHash !== undefined && params.cached !== undefined;\n  if (!canUseCache || !params.cached) {\n    return {\n      verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),\n      cacheDirty: true,\n    };\n  }\n  let currentContentHash: string;\n  if (params.verifyCacheHitByContent) {\n    try {\n      currentContentHash = await readHistoryContentHash(params.historyPath);\n    } catch {\n      params.accumulator.unreadableStreams.push(params.itemId);\n      return { verification: null, cacheDirty: false };\n    }\n  } else {\n    currentContentHash = cachedContentHash;\n  }\n  if (!params.verifyCacheHitByContent || currentContentHash === cachedContentHash) {\n    return {\n      verification: {\n        latestAfterHash: params.cached.latest_after_hash,\n        chainOk: params.cached.chain_ok,\n        contentHash: currentContentHash,\n      },\n      cacheDirty: false,\n    };\n  }\n  return {\n    verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),\n    cacheDirty: true,\n  };\n}\n\n/**\n * Scan every item's history stream for drift (missing/unreadable streams, broken\n * hash chains, and item/history hash mismatches).\n *\n * Full chain re-verification of a large history tree is the dominant cost of\n * `pm health`. We cache the per-stream verification keyed by the history file's\n * mtime/ctime/size plus content hash. Strict callers keep recomputing the\n * content hash on metadata hits; latency-sensitive health checks can opt into\n * trusting the stat tuple and skip rereading unchanged streams.\n */\nexport async function scanHistoryDrift(\n  pmRoot: string,\n  items: Array<ItemMetadata & { body: string }>,\n  options: DriftScanOptions = {},\n): Promise<DriftScanResult> {\n  const accumulator: DriftScanAccumulator = {\n    missingStreams: [],\n    unreadableStreams: [],\n    hashMismatches: [],\n    chainMismatches: [],\n  };\n\n  const cache = await loadDriftCache(pmRoot);\n  const previousEntries: Record<string, DriftCacheEntry> = cache?.entries ?? {};\n  const nextEntries: Record<string, DriftCacheEntry> = {};\n  let cacheDirty = false;\n  // Metadata mode does not open a stat-matched stream, so unreadable-after-stat\n  // failures are intentionally deferred to strict validate/history-repair scans.\n  const verifyCacheHitByContent = options.cacheHitVerification !== \"metadata\";\n\n  for (const item of items) {\n    const historyPath = getHistoryPath(pmRoot, item.id);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(historyPath);\n    } catch (error: unknown) {\n      if (isErrno(error, \"ENOENT\")) {\n        accumulator.missingStreams.push(item.id);\n      } else {\n        accumulator.unreadableStreams.push(item.id);\n      }\n      continue;\n    }\n\n    const cached = previousEntries[item.id];\n    const resolved = await resolveStreamVerification({\n      itemId: item.id,\n      historyPath,\n      stat,\n      cached,\n      verifyCacheHitByContent,\n      accumulator,\n    });\n    cacheDirty ||= resolved.cacheDirty;\n    if (!resolved.verification) {\n      continue;\n    }\n\n    if (!resolved.verification.chainOk) {\n      accumulator.chainMismatches.push(item.id);\n    }\n    nextEntries[item.id] = {\n      mtime_ms: stat.mtimeMs,\n      ctime_ms: stat.ctimeMs,\n      size: stat.size,\n      content_hash: resolved.verification.contentHash,\n      latest_after_hash: resolved.verification.latestAfterHash,\n      chain_ok: resolved.verification.chainOk,\n    };\n\n    const { body, ...frontMatter } = item;\n    const currentHash = hashDocument({\n      metadata: frontMatter as ItemMetadata,\n      body,\n    });\n    if (currentHash !== resolved.verification.latestAfterHash) {\n      accumulator.hashMismatches.push(item.id);\n    }\n  }\n\n  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {\n    const cachePath = getDriftCachePath(pmRoot);\n    try {\n      await fs.mkdir(path.dirname(cachePath), { recursive: true });\n      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));\n    } catch {\n      // Best-effort cache write: a failed persist must never fail a health scan.\n    }\n  }\n\n  const driftedItems = [\n    ...new Set([\n      ...accumulator.missingStreams,\n      ...accumulator.unreadableStreams,\n      ...accumulator.hashMismatches,\n      ...accumulator.chainMismatches,\n    ]),\n  ].sort((a, b) => a.localeCompare(b));\n  return { ...accumulator, driftedItems };\n}\n"],"names":[],"mappings":"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","debugId":"91c6995a-7219-5402-b2d4-e50227bf0149"}

package/dist/core/item/item-type-definition.js

@@ -15,7 +15,7 @@
  */
 /** Dedupe + sort a string list: trim, drop blanks, unique, locale-sorted. */
 
-!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]="257435ee-2ef3-5736-a403-57d6265cf280")}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]="a5621ca3-a40f-59d1-9bce-02c10afcc247")}catch(e){}}();
 export function normalizeItemTypeStringList(values) {
     return [...new Set((values ?? []).map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
 }
@@ -80,6 +80,13 @@ export function normalizeItemTypeCommandOptionPolicies(policies, resolvePolicyCo
         ? left.option.localeCompare(right.option)
         : left.command.localeCompare(right.command));
 }
+function normalizeOptionalStringList(values, preservePresence) {
+    return preservePresence ? normalizeItemTypeStringList(values) : undefined;
+}
+function optionalNonEmptyString(value) {
+    const normalized = value?.trim();
+    return normalized && normalized.length > 0 ? normalized : undefined;
+}
 /**
  * Normalize a full {@link ItemTypeDefinition}, returning null when the name is blank.
  *
@@ -98,9 +105,6 @@ export function normalizeItemTypeDefinition(definition, options = {}) {
     const hasRequiredCreateRepeatables = definition.required_create_repeatables !== undefined;
     const hasOptions = definition.options !== undefined;
     const hasCommandOptionPolicies = definition.command_option_policies !== undefined;
-    const folder = definition.folder?.trim();
-    const description = definition.description?.trim();
-    const defaultStatus = definition.default_status?.trim();
     const aliases = normalizeItemTypeStringList(definition.aliases);
     const normalizedOptions = (definition.options ?? [])
         .map((option) => normalizeItemTypeOption(option))
@@ -109,19 +113,15 @@ export function normalizeItemTypeDefinition(definition, options = {}) {
     const commandOptionPolicies = normalizeItemTypeCommandOptionPolicies(definition.command_option_policies, resolvePolicyCommand);
     return {
         name,
-        description: description && description.length > 0 ? description : undefined,
-        default_status: defaultStatus && defaultStatus.length > 0 ? defaultStatus : undefined,
-        folder: folder && folder.length > 0 ? folder : undefined,
+        description: optionalNonEmptyString(definition.description),
+        default_status: optionalNonEmptyString(definition.default_status),
+        folder: optionalNonEmptyString(definition.folder),
         aliases: aliases.length > 0 ? aliases : undefined,
-        required_create_fields: hasRequiredCreateFields
-            ? normalizeItemTypeStringList(definition.required_create_fields)
-            : undefined,
-        required_create_repeatables: hasRequiredCreateRepeatables
-            ? normalizeItemTypeStringList(definition.required_create_repeatables)
-            : undefined,
+        required_create_fields: normalizeOptionalStringList(definition.required_create_fields, hasRequiredCreateFields),
+        required_create_repeatables: normalizeOptionalStringList(definition.required_create_repeatables, hasRequiredCreateRepeatables),
         options: hasOptions ? normalizedOptions : undefined,
         command_option_policies: hasCommandOptionPolicies ? commandOptionPolicies : undefined,
     };
 }
 //# sourceMappingURL=item-type-definition.js.map
-//# debugId=257435ee-2ef3-5736-a403-57d6265cf280
+//# debugId=a5621ca3-a40f-59d1-9bce-02c10afcc247

package/dist/core/item/item-type-definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-type-definition.js","sources":["core/item/item-type-definition.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/item/item-type-definition\n *\n * Defines item parsing, formatting, and lifecycle helpers for Item Type Definition.\n */\nimport type {\n  ItemTypeCommandOptionPolicy,\n  ItemTypeDefinition,\n  ItemTypeOptionDefinition,\n} from \"../../types/index.js\";\n\n/**\n * Shared, pure normalization for {@link ItemTypeDefinition} objects, single-sourced\n * across the runtime item-type registry and settings persistence (pm-v798).\n *\n * The only genuine difference between the two callers is how a command-option\n * policy's `command` field is resolved:\n *  - the runtime registry consumes untrusted extension/file definitions, so it\n *    must trim+lowercase and reject anything that is not \"create\"/\"update\";\n *  - settings persistence operates on already-validated definitions, so it keeps\n *    the typed `command` value verbatim.\n *\n * That single difference is injected via {@link NormalizeItemTypeDefinitionOptions.resolvePolicyCommand};\n * everything else (name trim, optional folder, aliases, required_create_* fields,\n * options normalization, policy dedupe key + stable sort) is shared.\n */\n\n/** Dedupe + sort a string list: trim, drop blanks, unique, locale-sorted. */\nexport function normalizeItemTypeStringList(values: string[] | undefined): string[] {\n  return [...new Set((values ?? []).map((value) => value.trim()).filter((value) => value.length > 0))].sort(\n    (left, right) => left.localeCompare(right),\n  );\n}\n\n/** Normalize one type-option definition, or null when its key is blank. */\nexport function normalizeItemTypeOption(option: ItemTypeOptionDefinition): ItemTypeOptionDefinition | null {\n  const key = option.key.trim();\n  if (key.length === 0) {\n    return null;\n  }\n  const aliases = normalizeItemTypeStringList(option.aliases);\n  const description = option.description?.trim();\n  return {\n    key,\n    values: normalizeItemTypeStringList(option.values),\n    required: option.required === true ? true : undefined,\n    aliases: aliases.length > 0 ? aliases : undefined,\n    description: description && description.length > 0 ? description : undefined,\n  };\n}\n\n/**\n * Resolves a raw policy `command` value to the canonical \"create\"/\"update\" type,\n * or null to drop the policy. Lets each layer plug in its own strictness.\n */\nexport type ResolvePolicyCommand = (command: string) => ItemTypeCommandOptionPolicy[\"command\"] | null;\n\n/**\n * Pass-through resolver used by settings persistence: the value is already typed\n * \"create\" | \"update\" by the settings validator, so it is kept verbatim.\n */\nexport const keepPolicyCommand: ResolvePolicyCommand = (command) =>\n  command as ItemTypeCommandOptionPolicy[\"command\"];\n\n/**\n * Strict resolver used by the runtime registry: trims + lowercases and rejects\n * anything other than \"create\"/\"update\".\n */\nexport const strictPolicyCommand: ResolvePolicyCommand = (command) => {\n  const normalized = command.trim().toLowerCase();\n  return normalized === \"create\" || normalized === \"update\" ? normalized : null;\n};\n\n/** Normalize one command-option policy, or null when invalid (blank option / rejected command). */\nexport function normalizeItemTypeCommandOptionPolicy(\n  policy: ItemTypeCommandOptionPolicy,\n  resolvePolicyCommand: ResolvePolicyCommand,\n): ItemTypeCommandOptionPolicy | null {\n  const command = resolvePolicyCommand(policy.command);\n  if (command === null) {\n    return null;\n  }\n  const option = policy.option.trim();\n  if (option.length === 0) {\n    return null;\n  }\n  return {\n    command,\n    option,\n    required: policy.required,\n    visible: policy.visible,\n    enabled: policy.enabled,\n  };\n}\n\n/** Dedupe by `${command}:${option-lowercased}` and stable-sort by command then option. */\nexport function normalizeItemTypeCommandOptionPolicies(\n  policies: ItemTypeCommandOptionPolicy[] | undefined,\n  resolvePolicyCommand: ResolvePolicyCommand,\n): ItemTypeCommandOptionPolicy[] {\n  const dedupedByKey = new Map<string, ItemTypeCommandOptionPolicy>();\n  for (const policy of policies ?? []) {\n    const normalized = normalizeItemTypeCommandOptionPolicy(policy, resolvePolicyCommand);\n    if (!normalized) {\n      continue;\n    }\n    dedupedByKey.set(`${normalized.command}:${normalized.option.toLowerCase()}`, normalized);\n  }\n  return [...dedupedByKey.values()].sort((left, right) =>\n    left.command === right.command\n      ? left.option.localeCompare(right.option)\n      : left.command.localeCompare(right.command),\n  );\n}\n\n/**\n * Documents the normalize item type definition options payload exchanged by command, SDK, and package integrations.\n */\nexport interface NormalizeItemTypeDefinitionOptions {\n  /** How to resolve a raw policy `command` value (defaults to {@link keepPolicyCommand}). */\n  resolvePolicyCommand?: ResolvePolicyCommand;\n}\n\n/**\n * Normalize a full {@link ItemTypeDefinition}, returning null when the name is blank.\n *\n * Optional collection fields (`folder`, `aliases`, `required_create_fields`,\n * `required_create_repeatables`, `options`, `command_option_policies`) are only\n * emitted when present on the input (presence-preserving) so the distinction\n * between \"unset\" and \"set-but-empty\" survives the round-trip.\n */\nexport function normalizeItemTypeDefinition(\n  definition: ItemTypeDefinition,\n  options: NormalizeItemTypeDefinitionOptions = {},\n): ItemTypeDefinition | null {\n  const resolvePolicyCommand = options.resolvePolicyCommand ?? keepPolicyCommand;\n  const name = definition.name.trim();\n  if (name.length === 0) {\n    return null;\n  }\n\n  const hasRequiredCreateFields = definition.required_create_fields !== undefined;\n  const hasRequiredCreateRepeatables = definition.required_create_repeatables !== undefined;\n  const hasOptions = definition.options !== undefined;\n  const hasCommandOptionPolicies = definition.command_option_policies !== undefined;\n\n  const folder = definition.folder?.trim();\n  const description = definition.description?.trim();\n  const defaultStatus = definition.default_status?.trim();\n  const aliases = normalizeItemTypeStringList(definition.aliases);\n  const normalizedOptions = (definition.options ?? [])\n    .map((option) => normalizeItemTypeOption(option))\n    .filter((option): option is ItemTypeOptionDefinition => option !== null)\n    .sort((left, right) => left.key.localeCompare(right.key));\n  const commandOptionPolicies = normalizeItemTypeCommandOptionPolicies(\n    definition.command_option_policies,\n    resolvePolicyCommand,\n  );\n\n  return {\n    name,\n    description: description && description.length > 0 ? description : undefined,\n    default_status: defaultStatus && defaultStatus.length > 0 ? defaultStatus : undefined,\n    folder: folder && folder.length > 0 ? folder : undefined,\n    aliases: aliases.length > 0 ? aliases : undefined,\n    required_create_fields: hasRequiredCreateFields\n      ? normalizeItemTypeStringList(definition.required_create_fields)\n      : undefined,\n    required_create_repeatables: hasRequiredCreateRepeatables\n      ? normalizeItemTypeStringList(definition.required_create_repeatables)\n      : undefined,\n    options: hasOptions ? normalizedOptions : undefined,\n    command_option_policies: hasCommandOptionPolicies ? commandOptionPolicies : undefined,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"257435ee-2ef3-5736-a403-57d6265cf280"}
+{"version":3,"file":"item-type-definition.js","sources":["core/item/item-type-definition.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/item/item-type-definition\n *\n * Defines item parsing, formatting, and lifecycle helpers for Item Type Definition.\n */\nimport type {\n  ItemTypeCommandOptionPolicy,\n  ItemTypeDefinition,\n  ItemTypeOptionDefinition,\n} from \"../../types/index.js\";\n\n/**\n * Shared, pure normalization for {@link ItemTypeDefinition} objects, single-sourced\n * across the runtime item-type registry and settings persistence (pm-v798).\n *\n * The only genuine difference between the two callers is how a command-option\n * policy's `command` field is resolved:\n *  - the runtime registry consumes untrusted extension/file definitions, so it\n *    must trim+lowercase and reject anything that is not \"create\"/\"update\";\n *  - settings persistence operates on already-validated definitions, so it keeps\n *    the typed `command` value verbatim.\n *\n * That single difference is injected via {@link NormalizeItemTypeDefinitionOptions.resolvePolicyCommand};\n * everything else (name trim, optional folder, aliases, required_create_* fields,\n * options normalization, policy dedupe key + stable sort) is shared.\n */\n\n/** Dedupe + sort a string list: trim, drop blanks, unique, locale-sorted. */\nexport function normalizeItemTypeStringList(values: string[] | undefined): string[] {\n  return [...new Set((values ?? []).map((value) => value.trim()).filter((value) => value.length > 0))].sort(\n    (left, right) => left.localeCompare(right),\n  );\n}\n\n/** Normalize one type-option definition, or null when its key is blank. */\nexport function normalizeItemTypeOption(option: ItemTypeOptionDefinition): ItemTypeOptionDefinition | null {\n  const key = option.key.trim();\n  if (key.length === 0) {\n    return null;\n  }\n  const aliases = normalizeItemTypeStringList(option.aliases);\n  const description = option.description?.trim();\n  return {\n    key,\n    values: normalizeItemTypeStringList(option.values),\n    required: option.required === true ? true : undefined,\n    aliases: aliases.length > 0 ? aliases : undefined,\n    description: description && description.length > 0 ? description : undefined,\n  };\n}\n\n/**\n * Resolves a raw policy `command` value to the canonical \"create\"/\"update\" type,\n * or null to drop the policy. Lets each layer plug in its own strictness.\n */\nexport type ResolvePolicyCommand = (command: string) => ItemTypeCommandOptionPolicy[\"command\"] | null;\n\n/**\n * Pass-through resolver used by settings persistence: the value is already typed\n * \"create\" | \"update\" by the settings validator, so it is kept verbatim.\n */\nexport const keepPolicyCommand: ResolvePolicyCommand = (command) =>\n  command as ItemTypeCommandOptionPolicy[\"command\"];\n\n/**\n * Strict resolver used by the runtime registry: trims + lowercases and rejects\n * anything other than \"create\"/\"update\".\n */\nexport const strictPolicyCommand: ResolvePolicyCommand = (command) => {\n  const normalized = command.trim().toLowerCase();\n  return normalized === \"create\" || normalized === \"update\" ? normalized : null;\n};\n\n/** Normalize one command-option policy, or null when invalid (blank option / rejected command). */\nexport function normalizeItemTypeCommandOptionPolicy(\n  policy: ItemTypeCommandOptionPolicy,\n  resolvePolicyCommand: ResolvePolicyCommand,\n): ItemTypeCommandOptionPolicy | null {\n  const command = resolvePolicyCommand(policy.command);\n  if (command === null) {\n    return null;\n  }\n  const option = policy.option.trim();\n  if (option.length === 0) {\n    return null;\n  }\n  return {\n    command,\n    option,\n    required: policy.required,\n    visible: policy.visible,\n    enabled: policy.enabled,\n  };\n}\n\n/** Dedupe by `${command}:${option-lowercased}` and stable-sort by command then option. */\nexport function normalizeItemTypeCommandOptionPolicies(\n  policies: ItemTypeCommandOptionPolicy[] | undefined,\n  resolvePolicyCommand: ResolvePolicyCommand,\n): ItemTypeCommandOptionPolicy[] {\n  const dedupedByKey = new Map<string, ItemTypeCommandOptionPolicy>();\n  for (const policy of policies ?? []) {\n    const normalized = normalizeItemTypeCommandOptionPolicy(policy, resolvePolicyCommand);\n    if (!normalized) {\n      continue;\n    }\n    dedupedByKey.set(`${normalized.command}:${normalized.option.toLowerCase()}`, normalized);\n  }\n  return [...dedupedByKey.values()].sort((left, right) =>\n    left.command === right.command\n      ? left.option.localeCompare(right.option)\n      : left.command.localeCompare(right.command),\n  );\n}\n\n/**\n * Documents the normalize item type definition options payload exchanged by command, SDK, and package integrations.\n */\nexport interface NormalizeItemTypeDefinitionOptions {\n  /** How to resolve a raw policy `command` value (defaults to {@link keepPolicyCommand}). */\n  resolvePolicyCommand?: ResolvePolicyCommand;\n}\n\nfunction normalizeOptionalStringList(\n  values: string[] | undefined,\n  preservePresence: boolean,\n): string[] | undefined {\n  return preservePresence ? normalizeItemTypeStringList(values) : undefined;\n}\n\nfunction optionalNonEmptyString(value: string | undefined): string | undefined {\n  const normalized = value?.trim();\n  return normalized && normalized.length > 0 ? normalized : undefined;\n}\n\n/**\n * Normalize a full {@link ItemTypeDefinition}, returning null when the name is blank.\n *\n * Optional collection fields (`folder`, `aliases`, `required_create_fields`,\n * `required_create_repeatables`, `options`, `command_option_policies`) are only\n * emitted when present on the input (presence-preserving) so the distinction\n * between \"unset\" and \"set-but-empty\" survives the round-trip.\n */\nexport function normalizeItemTypeDefinition(\n  definition: ItemTypeDefinition,\n  options: NormalizeItemTypeDefinitionOptions = {},\n): ItemTypeDefinition | null {\n  const resolvePolicyCommand = options.resolvePolicyCommand ?? keepPolicyCommand;\n  const name = definition.name.trim();\n  if (name.length === 0) {\n    return null;\n  }\n\n  const hasRequiredCreateFields = definition.required_create_fields !== undefined;\n  const hasRequiredCreateRepeatables = definition.required_create_repeatables !== undefined;\n  const hasOptions = definition.options !== undefined;\n  const hasCommandOptionPolicies = definition.command_option_policies !== undefined;\n\n  const aliases = normalizeItemTypeStringList(definition.aliases);\n  const normalizedOptions = (definition.options ?? [])\n    .map((option) => normalizeItemTypeOption(option))\n    .filter((option): option is ItemTypeOptionDefinition => option !== null)\n    .sort((left, right) => left.key.localeCompare(right.key));\n  const commandOptionPolicies = normalizeItemTypeCommandOptionPolicies(\n    definition.command_option_policies,\n    resolvePolicyCommand,\n  );\n\n  return {\n    name,\n    description: optionalNonEmptyString(definition.description),\n    default_status: optionalNonEmptyString(definition.default_status),\n    folder: optionalNonEmptyString(definition.folder),\n    aliases: aliases.length > 0 ? aliases : undefined,\n    required_create_fields: normalizeOptionalStringList(definition.required_create_fields, hasRequiredCreateFields),\n    required_create_repeatables: normalizeOptionalStringList(\n      definition.required_create_repeatables,\n      hasRequiredCreateRepeatables,\n    ),\n    options: hasOptions ? normalizedOptions : undefined,\n    command_option_policies: hasCommandOptionPolicies ? commandOptionPolicies : undefined,\n  };\n}\n"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;GAcG;AAEH,6EAA6E;;;AAC7E,MAAM,UAAU,2BAA2B,CAAC,MAA4B;IACtE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CACvG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB,CAAC,MAAgC;IACtE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,2BAA2B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/C,OAAO;QACL,GAAG;QACH,MAAM,EAAE,2BAA2B,CAAC,MAAM,CAAC,MAAM,CAAC;QAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACrD,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACjD,WAAW,EAAE,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC7E,CAAC;AACJ,CAAC;AAQD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAyB,CAAC,OAAO,EAAE,EAAE,CACjE,OAAiD,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAyB,CAAC,OAAO,EAAE,EAAE;IACnE,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AAChF,CAAC,CAAC;AAEF,mGAAmG;AACnG,MAAM,UAAU,oCAAoC,CAClD,MAAmC,EACnC,oBAA0C;IAE1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,OAAO;QACP,MAAM;QACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,sCAAsC,CACpD,QAAmD,EACnD,oBAA0C;IAE1C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAuC,CAAC;IACpE,KAAK,MAAM,MAAM,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,oCAAoC,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QACtF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACrD,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;QAC5B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAC9C,CAAC;AACJ,CAAC;AAUD,SAAS,2BAA2B,CAClC,MAA4B,EAC5B,gBAAyB;IAEzB,OAAO,gBAAgB,CAAC,CAAC,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAyB;IACvD,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAA8B,EAC9B,UAA8C,EAAE;IAEhD,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,iBAAiB,CAAC;IAC/E,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,uBAAuB,GAAG,UAAU,CAAC,sBAAsB,KAAK,SAAS,CAAC;IAChF,MAAM,4BAA4B,GAAG,UAAU,CAAC,2BAA2B,KAAK,SAAS,CAAC;IAC1F,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC;IACpD,MAAM,wBAAwB,GAAG,UAAU,CAAC,uBAAuB,KAAK,SAAS,CAAC;IAElF,MAAM,OAAO,GAAG,2BAA2B,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,iBAAiB,GAAG,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;SACjD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,MAAM,EAAsC,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC;SACvE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,qBAAqB,GAAG,sCAAsC,CAClE,UAAU,CAAC,uBAAuB,EAClC,oBAAoB,CACrB,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,sBAAsB,CAAC,UAAU,CAAC,WAAW,CAAC;QAC3D,cAAc,EAAE,sBAAsB,CAAC,UAAU,CAAC,cAAc,CAAC;QACjE,MAAM,EAAE,sBAAsB,CAAC,UAAU,CAAC,MAAM,CAAC;QACjD,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACjD,sBAAsB,EAAE,2BAA2B,CAAC,UAAU,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;QAC/G,2BAA2B,EAAE,2BAA2B,CACtD,UAAU,CAAC,2BAA2B,EACtC,4BAA4B,CAC7B;QACD,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;QACnD,uBAAuB,EAAE,wBAAwB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS;KACtF,CAAC;AACJ,CAAC","debugId":"a5621ca3-a40f-59d1-9bce-02c10afcc247"}

package/dist/core/item/type-registry.js

@@ -4,7 +4,7 @@
  * Defines item parsing, formatting, and lifecycle helpers for Type Registry.
  */
 
-!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]="aca609de-d881-5f34-804f-ed3daa6aab2a")}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]="5d1396d8-5493-51c2-9b51-4b57073f85da")}catch(e){}}();
 import { TYPE_TO_FOLDER } from "../shared/constants.js";
 import { ITEM_TYPE_VALUES } from "../../types/index.js";
 import { normalizeItemTypeDefinition as normalizeSharedItemTypeDefinition, normalizeItemTypeStringList, strictPolicyCommand, } from "./item-type-definition.js";
@@ -330,6 +330,62 @@ function toSlugToken(value) {
 function normalizeTypeDefinition(definition) {
     return normalizeSharedItemTypeDefinition(definition, { resolvePolicyCommand: strictPolicyCommand });
 }
+function readStringArray(record, key) {
+    const value = record[key];
+    return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : undefined;
+}
+function coerceOptionDefinitionFromUnknown(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        return null;
+    }
+    const optionRecord = raw;
+    if (typeof optionRecord.key !== "string") {
+        return null;
+    }
+    return {
+        key: optionRecord.key,
+        values: readStringArray(optionRecord, "values") ?? [],
+        required: optionRecord.required === undefined ? undefined : Boolean(optionRecord.required),
+        aliases: readStringArray(optionRecord, "aliases"),
+        description: typeof optionRecord.description === "string" ? optionRecord.description : undefined,
+    };
+}
+function coerceCommandOptionPolicyFromUnknown(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        return null;
+    }
+    const policyRecord = raw;
+    if (typeof policyRecord.command !== "string" || typeof policyRecord.option !== "string") {
+        return null;
+    }
+    const normalizedCommand = policyRecord.command.trim().toLowerCase();
+    if (normalizedCommand !== "create" && normalizedCommand !== "update") {
+        return null;
+    }
+    return {
+        command: normalizedCommand,
+        option: policyRecord.option,
+        required: policyRecord.required === undefined ? undefined : Boolean(policyRecord.required),
+        visible: policyRecord.visible === undefined ? undefined : Boolean(policyRecord.visible),
+        enabled: policyRecord.enabled === undefined ? undefined : Boolean(policyRecord.enabled),
+    };
+}
+function coerceOptionDefinitionsFromRecord(record) {
+    if (!Array.isArray(record.options)) {
+        return undefined;
+    }
+    return record.options
+        .map((entry) => coerceOptionDefinitionFromUnknown(entry))
+        .filter((entry) => entry !== null);
+}
+function coerceCommandOptionPoliciesFromRecord(record) {
+    if (!Array.isArray(record.command_option_policies)) {
+        return undefined;
+    }
+    return record.command_option_policies
+        .map((entry) => coerceCommandOptionPolicyFromUnknown(entry))
+        .filter((entry) => entry !== null);
+}
 function coerceTypeDefinitionFromUnknown(raw) {
     if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
         return null;
@@ -342,73 +398,38 @@ function coerceTypeDefinitionFromUnknown(raw) {
     const folder = typeof record.folder === "string" ? record.folder : undefined;
     const description = typeof record.description === "string" ? record.description : undefined;
     const defaultStatus = typeof record.default_status === "string" ? record.default_status : undefined;
-    const aliases = Array.isArray(record.aliases) ? record.aliases.filter((value) => typeof value === "string") : undefined;
-    const requiredCreateFields = Array.isArray(record.required_create_fields)
-        ? record.required_create_fields.filter((value) => typeof value === "string")
-        : undefined;
-    const requiredCreateRepeatables = Array.isArray(record.required_create_repeatables)
-        ? record.required_create_repeatables.filter((value) => typeof value === "string")
-        : undefined;
-    let options;
-    if (Array.isArray(record.options)) {
-        options = [];
-        for (const entry of record.options) {
-            if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-                continue;
-            }
-            const optionRecord = entry;
-            if (typeof optionRecord.key !== "string") {
-                continue;
-            }
-            options.push({
-                key: optionRecord.key,
-                values: Array.isArray(optionRecord.values)
-                    ? optionRecord.values.filter((value) => typeof value === "string")
-                    : [],
-                required: optionRecord.required === undefined ? undefined : Boolean(optionRecord.required),
-                aliases: Array.isArray(optionRecord.aliases)
-                    ? optionRecord.aliases.filter((value) => typeof value === "string")
-                    : undefined,
-                description: typeof optionRecord.description === "string" ? optionRecord.description : undefined,
-            });
-        }
-    }
-    let commandOptionPolicies;
-    if (Array.isArray(record.command_option_policies)) {
-        commandOptionPolicies = [];
-        for (const entry of record.command_option_policies) {
-            if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-                continue;
-            }
-            const policyRecord = entry;
-            if (typeof policyRecord.command !== "string" || typeof policyRecord.option !== "string") {
-                continue;
-            }
-            const normalizedCommand = policyRecord.command.trim().toLowerCase();
-            if (normalizedCommand !== "create" && normalizedCommand !== "update") {
-                continue;
-            }
-            commandOptionPolicies.push({
-                command: normalizedCommand,
-                option: policyRecord.option,
-                required: policyRecord.required === undefined ? undefined : Boolean(policyRecord.required),
-                visible: policyRecord.visible === undefined ? undefined : Boolean(policyRecord.visible),
-                enabled: policyRecord.enabled === undefined ? undefined : Boolean(policyRecord.enabled),
-            });
-        }
-    }
     return {
         name,
         description,
         default_status: defaultStatus,
         folder,
-        aliases,
-        required_create_fields: requiredCreateFields,
-        required_create_repeatables: requiredCreateRepeatables,
-        options,
-        command_option_policies: commandOptionPolicies,
+        aliases: readStringArray(record, "aliases"),
+        required_create_fields: readStringArray(record, "required_create_fields"),
+        required_create_repeatables: readStringArray(record, "required_create_repeatables"),
+        options: coerceOptionDefinitionsFromRecord(record),
+        command_option_policies: coerceCommandOptionPoliciesFromRecord(record),
     };
 }
+function resolveDefinitionRequiredCreateFields(normalizedDefinition, existing) {
+    return normalizedDefinition.required_create_fields
+        ? normalizeItemTypeStringList(normalizedDefinition.required_create_fields)
+        : existing?.required_create_fields ?? [];
+}
+function resolveDefinitionRequiredCreateRepeatables(normalizedDefinition, existing) {
+    return normalizedDefinition.required_create_repeatables
+        ? normalizeItemTypeStringList(normalizedDefinition.required_create_repeatables)
+        : existing?.required_create_repeatables ?? [];
+}
+function resolveDefinitionOptions(normalizedDefinition, existing) {
+    return normalizedDefinition.options ? normalizedDefinition.options : existing?.options ? [...existing.options] : [];
+}
+function resolveDefinitionCommandOptionPolicies(normalizedDefinition, existing) {
+    return normalizedDefinition.command_option_policies
+        ? normalizedDefinition.command_option_policies
+        : existing?.command_option_policies
+            ? [...existing.command_option_policies]
+            : [];
+}
 function applyTypeDefinitions(source, target) {
     for (const rawDefinition of source) {
         const normalizedDefinition = normalizeTypeDefinition(rawDefinition);
@@ -423,22 +444,6 @@ function applyTypeDefinitions(source, target) {
             ...(existing?.aliases ?? []),
             ...(normalizedDefinition.aliases ?? []),
         ]);
-        const requiredCreateFields = normalizedDefinition.required_create_fields
-            ? normalizeItemTypeStringList(normalizedDefinition.required_create_fields)
-            : existing?.required_create_fields ?? [];
-        const requiredCreateRepeatables = normalizedDefinition.required_create_repeatables
-            ? normalizeItemTypeStringList(normalizedDefinition.required_create_repeatables)
-            : existing?.required_create_repeatables ?? [];
-        const options = normalizedDefinition.options
-            ? normalizedDefinition.options
-            : existing?.options
-                ? [...existing.options]
-                : [];
-        const commandOptionPolicies = normalizedDefinition.command_option_policies
-            ? normalizedDefinition.command_option_policies
-            : existing?.command_option_policies
-                ? [...existing.command_option_policies]
-                : [];
         const defaultStatus = normalizedDefinition.default_status ?? existing?.default_status;
         const description = normalizedDefinition.description ?? existing?.description;
         target.set(lowerName, {
@@ -447,10 +452,10 @@ function applyTypeDefinitions(source, target) {
             ...(defaultStatus ? { default_status: defaultStatus } : {}),
             folder,
             aliases,
-            required_create_fields: requiredCreateFields,
-            required_create_repeatables: requiredCreateRepeatables,
-            options,
-            command_option_policies: commandOptionPolicies,
+            required_create_fields: resolveDefinitionRequiredCreateFields(normalizedDefinition, existing),
+            required_create_repeatables: resolveDefinitionRequiredCreateRepeatables(normalizedDefinition, existing),
+            options: resolveDefinitionOptions(normalizedDefinition, existing),
+            command_option_policies: resolveDefinitionCommandOptionPolicies(normalizedDefinition, existing),
         });
     }
 }
@@ -663,4 +668,4 @@ export function validateTypeOptions(typeName, rawTypeOptions, registry) {
     };
 }
 //# sourceMappingURL=type-registry.js.map
-//# debugId=aca609de-d881-5f34-804f-ed3daa6aab2a
+//# debugId=5d1396d8-5493-51c2-9b51-4b57073f85da