@unbrained/pm-cli 2026.5.18 → 2026.5.27

package/dist/core/store/front-matter-cache.js

@@ -1,13 +1,15 @@
 
-!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]="8c69e068-2ecc-546f-8dd8-4e88460f5069")}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]="10d5600e-92e0-5342-a6a7-6bb48f44a92f")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { createHash } from "node:crypto";
-import { runActiveOnReadHooks } from "../extensions/index.js";
+import { hasActiveOnReadHooks, runActiveOnReadHooks } from "../extensions/index.js";
 import { parseItemDocument } from "../item/item-format.js";
+import { writeFileAtomic } from "../fs/fs-utils.js";
 import { ITEM_FILE_EXTENSIONS, getItemFormatFromPath } from "./paths.js";
-const CACHE_VERSION = 4;
+const CACHE_VERSION = 5;
 const CACHE_FILENAME = "metadata-cache.json";
+const BODY_CACHE_FILENAME = "metadata-cache-bodies.json";
 function computeContextFingerprint(preferredFormat, typeToFolder, schema) {
     const hash = createHash("sha256");
     hash.update(`format:${preferredFormat ?? "default"}`);
@@ -24,11 +26,27 @@ function computeContextFingerprint(preferredFormat, typeToFolder, schema) {
 function getCachePath(pmRoot) {
     return path.join(pmRoot, "runtime", CACHE_FILENAME);
 }
+function getBodyCachePath(pmRoot) {
+    return path.join(pmRoot, "runtime", BODY_CACHE_FILENAME);
+}
 async function loadCache(pmRoot) {
     try {
         const raw = await fs.readFile(getCachePath(pmRoot), "utf8");
         const parsed = JSON.parse(raw);
-        if (parsed.version !== CACHE_VERSION || typeof parsed.entries !== "object") {
+        if (parsed.version !== CACHE_VERSION || typeof parsed.entries !== "object" || parsed.entries === null) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+async function loadBodyCache(pmRoot) {
+    try {
+        const raw = await fs.readFile(getBodyCachePath(pmRoot), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== CACHE_VERSION || typeof parsed.bodies !== "object" || parsed.bodies === null) {
             return null;
         }
         return parsed;
@@ -37,26 +55,35 @@ async function loadCache(pmRoot) {
         return null;
     }
 }
-async function persistCache(pmRoot, envelope) {
-    const cachePath = getCachePath(pmRoot);
+async function persistCache(cachePath, envelope) {
     await fs.mkdir(path.dirname(cachePath), { recursive: true });
-    await fs.writeFile(cachePath, JSON.stringify(envelope), "utf8");
+    await writeFileAtomic(cachePath, JSON.stringify(envelope));
 }
 function appendWarning(warnings, warning) {
     if (warnings && !warnings.includes(warning)) {
         warnings.push(warning);
     }
 }
+function statMatches(signature, mtimeMs, ctimeMs, size) {
+    return signature.mtime_ms === mtimeMs && signature.ctime_ms === ctimeMs && signature.size === size;
+}
 /**
  * List all item documents using a persistent on-disk metadata cache.
- * Only parses files whose mtime/size have changed since the last cached run.
+ *
+ * Metadata and bodies are stored in two separate cache files so the hot path
+ * (`pm list` and friends, which discard bodies) never loads or rewrites the much
+ * larger body payload. Each file is rewritten only when its contents actually
+ * change, and per-file onRead hooks are dispatched only when an extension
+ * registers one. Only files whose mtime/ctime/size changed since the last run are
+ * re-parsed.
  */
-export async function listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema) {
+export async function listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema, options = {}) {
+    const includeBody = options.includeBody !== false;
     const contextFingerprint = computeContextFingerprint(preferredFormat, typeToFolder, schema);
     const existingCache = await loadCache(pmRoot);
-    const previousEntries = existingCache && existingCache.context_fingerprint === contextFingerprint
-        ? existingCache.entries
-        : {};
+    const previousEntries = existingCache && existingCache.context_fingerprint === contextFingerprint ? existingCache.entries : {};
+    const existingBodyCache = includeBody ? await loadBodyCache(pmRoot) : null;
+    const previousBodies = existingBodyCache && existingBodyCache.context_fingerprint === contextFingerprint ? existingBodyCache.bodies : {};
     const entries = Object.entries(typeToFolder);
     const dirResults = await Promise.all(entries.map(async ([, folder]) => {
         const dirPath = path.join(pmRoot, folder);
@@ -71,8 +98,12 @@ export async function listAllDocumentCandidatesCached(pmRoot, preferredFormat, t
             return { folder, dirPath, files: [] };
         }
     }));
+    const dispatchReadHooks = hasActiveOnReadHooks();
     const newEntries = {};
+    const newBodies = {};
     const documentsById = new Map();
+    let metadataMiss = false;
+    let bodyMiss = false;
     const parseTasks = [];
     for (const { folder, dirPath, files } of dirResults) {
         for (const file of files) {
@@ -87,28 +118,44 @@ export async function listAllDocumentCandidatesCached(pmRoot, preferredFormat, t
                     const mtimeMs = stat.mtimeMs;
                     const ctimeMs = stat.ctimeMs;
                     const { size } = stat;
-                    const cached = previousEntries[relativePath];
+                    const itemFormat = getItemFormatFromPath(filePath);
+                    // Preserve onRead hook semantics even when served from cache, but only
+                    // when an extension actually observes reads. Surface hook warnings so
+                    // read-hook failures are not silently hidden.
+                    if (dispatchReadHooks) {
+                        for (const warning of await runActiveOnReadHooks({ path: filePath, scope: "project" })) {
+                            appendWarning(warnings, warning);
+                        }
+                    }
+                    const cachedEntry = previousEntries[relativePath];
+                    const metadataCached = cachedEntry !== undefined && statMatches(cachedEntry, mtimeMs, ctimeMs, size);
+                    const cachedBody = previousBodies[relativePath];
+                    const bodyCached = cachedBody !== undefined && statMatches(cachedBody, mtimeMs, ctimeMs, size);
+                    const needRead = !metadataCached || (includeBody && !bodyCached);
                     let metadata;
                     let bodyLength;
                     let body;
-                    const itemFormat = getItemFormatFromPath(filePath);
-                    // Preserve onRead hook semantics even when metadata is served from cache.
-                    await runActiveOnReadHooks({ path: filePath, scope: "project" });
-                    if (cached && cached.mtime_ms === mtimeMs && cached.ctime_ms === ctimeMs && cached.size === size) {
-                        metadata = cached.metadata;
-                        bodyLength = cached.body_length;
-                        body = cached.body;
-                    }
-                    else {
+                    if (needRead) {
                         const raw = await fs.readFile(filePath, "utf8");
                         const parsed = parseItemDocument(raw, {
                             format: itemFormat,
                             schema,
                             onWarning: (w) => appendWarning(warnings, w),
                         });
-                        metadata = parsed.metadata;
-                        bodyLength = parsed.body.length;
-                        body = parsed.body;
+                        metadata = metadataCached ? cachedEntry.metadata : parsed.metadata;
+                        bodyLength = metadataCached ? cachedEntry.body_length : parsed.body.length;
+                        body = includeBody ? parsed.body : undefined;
+                        if (!metadataCached) {
+                            metadataMiss = true;
+                        }
+                        if (includeBody && !bodyCached) {
+                            bodyMiss = true;
+                        }
+                    }
+                    else {
+                        metadata = cachedEntry.metadata;
+                        bodyLength = cachedEntry.body_length;
+                        body = includeBody ? cachedBody.body : undefined;
                     }
                     newEntries[relativePath] = {
                         mtime_ms: mtimeMs,
@@ -116,8 +163,10 @@ export async function listAllDocumentCandidatesCached(pmRoot, preferredFormat, t
                         size,
                         metadata,
                         body_length: bodyLength,
-                        body,
                     };
+                    if (includeBody && body !== undefined) {
+                        newBodies[relativePath] = { mtime_ms: mtimeMs, ctime_ms: ctimeMs, size, body };
+                    }
                     const existing = documentsById.get(metadata.id);
                     const candidate = {
                         metadata,
@@ -144,21 +193,38 @@ export async function listAllDocumentCandidatesCached(pmRoot, preferredFormat, t
         }
     }
     await Promise.all(parseTasks);
-    await persistCache(pmRoot, {
-        version: CACHE_VERSION,
-        context_fingerprint: contextFingerprint,
-        entries: newEntries,
-    }).catch(() => { });
+    // Rewrite a cache file only when its contents changed: any re-parsed (missing or
+    // stale) entry, or a different set of keys (additions/deletions).
+    const metadataDirty = metadataMiss || Object.keys(previousEntries).length !== Object.keys(newEntries).length;
+    if (metadataDirty || existingCache === null || existingCache.context_fingerprint !== contextFingerprint) {
+        await persistCache(getCachePath(pmRoot), {
+            version: CACHE_VERSION,
+            context_fingerprint: contextFingerprint,
+            entries: newEntries,
+        }).catch(() => { });
+    }
+    if (includeBody) {
+        const bodyDirty = bodyMiss || Object.keys(previousBodies).length !== Object.keys(newBodies).length;
+        if (bodyDirty || existingBodyCache === null || existingBodyCache.context_fingerprint !== contextFingerprint) {
+            await persistCache(getBodyCachePath(pmRoot), {
+                version: CACHE_VERSION,
+                context_fingerprint: contextFingerprint,
+                bodies: newBodies,
+            }).catch(() => { });
+        }
+    }
     return [...documentsById.values()]
         .sort((left, right) => left.candidate.metadata.id.localeCompare(right.candidate.metadata.id))
         .map((entry) => entry.candidate);
 }
 export async function listAllDocumentsCached(pmRoot, preferredFormat, typeToFolder, warnings, schema) {
-    const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema);
+    const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema, {
+        includeBody: false,
+    });
     return candidates.map((candidate) => ({
         metadata: candidate.metadata,
         body: candidate.body ?? "",
     }));
 }
 //# sourceMappingURL=front-matter-cache.js.map
-//# debugId=8c69e068-2ecc-546f-8dd8-4e88460f5069
+//# debugId=10d5600e-92e0-5342-a6a7-6bb48f44a92f

package/dist/core/store/front-matter-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"front-matter-cache.js","sources":["core/store/front-matter-cache.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { createHash } from \"node:crypto\";\nimport { runActiveOnReadHooks } from \"../extensions/index.js\";\nimport { parseItemDocument } from \"../item/item-format.js\";\nimport { ITEM_FILE_EXTENSIONS, getItemFormatFromPath } from \"./paths.js\";\nimport type { ItemDocument, ItemFormat, ItemMetadata, ItemType, RuntimeSchemaSettings } from \"../../types/index.js\";\n\nconst CACHE_VERSION = 4;\nconst CACHE_FILENAME = \"metadata-cache.json\";\n\ninterface CachedEntry {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n  metadata: ItemMetadata;\n  body_length: number;\n  body?: string;\n}\n\ninterface CacheEnvelope {\n  version: number;\n  context_fingerprint: string;\n  entries: Record<string, CachedEntry>;\n}\n\nexport interface CachedDocumentCandidate {\n  metadata: ItemMetadata;\n  body?: string;\n  item_format: ItemFormat;\n  item_path: string;\n}\n\nfunction computeContextFingerprint(\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  schema: RuntimeSchemaSettings | undefined,\n): string {\n  const hash = createHash(\"sha256\");\n  hash.update(`format:${preferredFormat ?? \"default\"}`);\n  const sortedTypes = Object.entries(typeToFolder)\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([type, folder]) => `${type}=${folder}`)\n    .join(\",\");\n  hash.update(`|types:${sortedTypes}`);\n  if (schema) {\n    hash.update(`|schema:${JSON.stringify(schema)}`);\n  }\n  return hash.digest(\"hex\").slice(0, 16);\n}\n\nfunction getCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", CACHE_FILENAME);\n}\n\nasync function loadCache(pmRoot: string): Promise<CacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as CacheEnvelope;\n    if (parsed.version !== CACHE_VERSION || typeof parsed.entries !== \"object\") {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nasync function persistCache(pmRoot: string, envelope: CacheEnvelope): Promise<void> {\n  const cachePath = getCachePath(pmRoot);\n  await fs.mkdir(path.dirname(cachePath), { recursive: true });\n  await fs.writeFile(cachePath, JSON.stringify(envelope), \"utf8\");\n}\n\nfunction appendWarning(warnings: string[] | undefined, warning: string): void {\n  if (warnings && !warnings.includes(warning)) {\n    warnings.push(warning);\n  }\n}\n\n/**\n * List all item documents using a persistent on-disk metadata cache.\n * Only parses files whose mtime/size have changed since the last cached run.\n */\nexport async function listAllDocumentCandidatesCached(\n  pmRoot: string,\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  warnings: string[] | undefined,\n  schema: RuntimeSchemaSettings | undefined,\n): Promise<CachedDocumentCandidate[]> {\n  const contextFingerprint = computeContextFingerprint(preferredFormat, typeToFolder, schema);\n  const existingCache = await loadCache(pmRoot);\n\n  const previousEntries: Record<string, CachedEntry> =\n    existingCache && existingCache.context_fingerprint === contextFingerprint\n      ? existingCache.entries\n      : {};\n\n  const entries = Object.entries(typeToFolder) as Array<[ItemType, string]>;\n\n  const dirResults = await Promise.all(\n    entries.map(async ([, folder]) => {\n      const dirPath = path.join(pmRoot, folder);\n      try {\n        const files = await fs.readdir(dirPath);\n        return { folder, dirPath, files };\n      } catch (error: unknown) {\n        if (typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code !== \"ENOENT\") {\n          appendWarning(warnings, `item_list_directory_read_failed:${folder}`);\n        }\n        return { folder, dirPath, files: [] as string[] };\n      }\n    }),\n  );\n\n  const newEntries: Record<string, CachedEntry> = {};\n  const documentsById = new Map<string, { candidate: CachedDocumentCandidate; itemFormat: ItemFormat }>();\n\n  const parseTasks: Array<Promise<void>> = [];\n\n  for (const { folder, dirPath, files } of dirResults) {\n    for (const file of files) {\n      if (!ITEM_FILE_EXTENSIONS.some((ext) => file.toLowerCase().endsWith(ext))) {\n        continue;\n      }\n      const filePath = path.join(dirPath, file);\n      const relativePath = path.relative(pmRoot, filePath);\n\n      parseTasks.push(\n        (async () => {\n          try {\n            const stat = await fs.stat(filePath);\n            const mtimeMs = stat.mtimeMs;\n            const ctimeMs = stat.ctimeMs;\n            const { size } = stat;\n            const cached = previousEntries[relativePath];\n\n            let metadata: ItemMetadata;\n            let bodyLength: number;\n            let body: string | undefined;\n            const itemFormat = getItemFormatFromPath(filePath) as ItemFormat;\n\n            // Preserve onRead hook semantics even when metadata is served from cache.\n            await runActiveOnReadHooks({ path: filePath, scope: \"project\" });\n\n            if (cached && cached.mtime_ms === mtimeMs && cached.ctime_ms === ctimeMs && cached.size === size) {\n              metadata = cached.metadata;\n              bodyLength = cached.body_length;\n              body = cached.body;\n            } else {\n              const raw = await fs.readFile(filePath, \"utf8\");\n              const parsed = parseItemDocument(raw, {\n                format: itemFormat,\n                schema,\n                onWarning: (w) => appendWarning(warnings, w),\n              });\n              metadata = parsed.metadata;\n              bodyLength = parsed.body.length;\n              body = parsed.body;\n            }\n\n            newEntries[relativePath] = {\n              mtime_ms: mtimeMs,\n              ctime_ms: ctimeMs,\n              size,\n              metadata,\n              body_length: bodyLength,\n              body,\n            };\n\n            const existing = documentsById.get(metadata.id);\n            const candidate: CachedDocumentCandidate = {\n              metadata,\n              body,\n              item_format: itemFormat,\n              item_path: filePath,\n            };\n            if (!existing) {\n              documentsById.set(metadata.id, { candidate, itemFormat });\n            } else {\n              const shouldReplace = preferredFormat\n                ? itemFormat === preferredFormat && existing.itemFormat !== preferredFormat\n                : itemFormat === \"toon\" && existing.itemFormat !== \"toon\";\n              if (shouldReplace) {\n                documentsById.set(metadata.id, { candidate, itemFormat });\n              }\n            }\n          } catch {\n            appendWarning(warnings, `item_list_item_read_failed:${folder}/${file}`);\n          }\n        })(),\n      );\n    }\n  }\n\n  await Promise.all(parseTasks);\n\n  await persistCache(pmRoot, {\n    version: CACHE_VERSION,\n    context_fingerprint: contextFingerprint,\n    entries: newEntries,\n  }).catch(() => {});\n\n  return [...documentsById.values()]\n    .sort((left, right) => left.candidate.metadata.id.localeCompare(right.candidate.metadata.id))\n    .map((entry) => entry.candidate);\n}\n\nexport async function listAllDocumentsCached(\n  pmRoot: string,\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  warnings: string[] | undefined,\n  schema: RuntimeSchemaSettings | undefined,\n): Promise<ItemDocument[]> {\n  const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema);\n  return candidates.map((candidate) => ({\n    metadata: candidate.metadata,\n    body: candidate.body ?? \"\",\n  }));\n}\n"],"names":[],"mappings":"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","debugId":"8c69e068-2ecc-546f-8dd8-4e88460f5069"}
+{"version":3,"file":"front-matter-cache.js","sources":["core/store/front-matter-cache.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { createHash } from \"node:crypto\";\nimport { hasActiveOnReadHooks, runActiveOnReadHooks } from \"../extensions/index.js\";\nimport { parseItemDocument } from \"../item/item-format.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { ITEM_FILE_EXTENSIONS, getItemFormatFromPath } from \"./paths.js\";\nimport type { ItemDocument, ItemFormat, ItemMetadata, ItemType, RuntimeSchemaSettings } from \"../../types/index.js\";\n\nconst CACHE_VERSION = 5;\nconst CACHE_FILENAME = \"metadata-cache.json\";\nconst BODY_CACHE_FILENAME = \"metadata-cache-bodies.json\";\n\ninterface StatSignature {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n}\n\ninterface CachedEntry extends StatSignature {\n  metadata: ItemMetadata;\n  body_length: number;\n}\n\ninterface CachedBody extends StatSignature {\n  body: string;\n}\n\ninterface CacheEnvelope {\n  version: number;\n  context_fingerprint: string;\n  entries: Record<string, CachedEntry>;\n}\n\ninterface BodyCacheEnvelope {\n  version: number;\n  context_fingerprint: string;\n  bodies: Record<string, CachedBody>;\n}\n\nexport interface CachedDocumentCandidate {\n  metadata: ItemMetadata;\n  body?: string;\n  item_format: ItemFormat;\n  item_path: string;\n}\n\nfunction computeContextFingerprint(\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  schema: RuntimeSchemaSettings | undefined,\n): string {\n  const hash = createHash(\"sha256\");\n  hash.update(`format:${preferredFormat ?? \"default\"}`);\n  const sortedTypes = Object.entries(typeToFolder)\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([type, folder]) => `${type}=${folder}`)\n    .join(\",\");\n  hash.update(`|types:${sortedTypes}`);\n  if (schema) {\n    hash.update(`|schema:${JSON.stringify(schema)}`);\n  }\n  return hash.digest(\"hex\").slice(0, 16);\n}\n\nfunction getCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", CACHE_FILENAME);\n}\n\nfunction getBodyCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", BODY_CACHE_FILENAME);\n}\n\nasync function loadCache(pmRoot: string): Promise<CacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as CacheEnvelope;\n    if (parsed.version !== CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nasync function loadBodyCache(pmRoot: string): Promise<BodyCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getBodyCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as BodyCacheEnvelope;\n    if (parsed.version !== CACHE_VERSION || typeof parsed.bodies !== \"object\" || parsed.bodies === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nasync function persistCache(cachePath: string, envelope: CacheEnvelope | BodyCacheEnvelope): Promise<void> {\n  await fs.mkdir(path.dirname(cachePath), { recursive: true });\n  await writeFileAtomic(cachePath, JSON.stringify(envelope));\n}\n\nfunction appendWarning(warnings: string[] | undefined, warning: string): void {\n  if (warnings && !warnings.includes(warning)) {\n    warnings.push(warning);\n  }\n}\n\nfunction statMatches(signature: StatSignature, mtimeMs: number, ctimeMs: number, size: number): boolean {\n  return signature.mtime_ms === mtimeMs && signature.ctime_ms === ctimeMs && signature.size === size;\n}\n\nexport interface ListCacheOptions {\n  /**\n   * When false, item bodies are neither loaded from nor written to the separate\n   * body cache. Metadata-only callers (`pm list`, stats, deps, activity, …) skip\n   * the large body cache entirely; only body consumers (search/reindex) pay for it.\n   */\n  includeBody?: boolean;\n}\n\n/**\n * List all item documents using a persistent on-disk metadata cache.\n *\n * Metadata and bodies are stored in two separate cache files so the hot path\n * (`pm list` and friends, which discard bodies) never loads or rewrites the much\n * larger body payload. Each file is rewritten only when its contents actually\n * change, and per-file onRead hooks are dispatched only when an extension\n * registers one. Only files whose mtime/ctime/size changed since the last run are\n * re-parsed.\n */\nexport async function listAllDocumentCandidatesCached(\n  pmRoot: string,\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  warnings: string[] | undefined,\n  schema: RuntimeSchemaSettings | undefined,\n  options: ListCacheOptions = {},\n): Promise<CachedDocumentCandidate[]> {\n  const includeBody = options.includeBody !== false;\n  const contextFingerprint = computeContextFingerprint(preferredFormat, typeToFolder, schema);\n\n  const existingCache = await loadCache(pmRoot);\n  const previousEntries: Record<string, CachedEntry> =\n    existingCache && existingCache.context_fingerprint === contextFingerprint ? existingCache.entries : {};\n\n  const existingBodyCache = includeBody ? await loadBodyCache(pmRoot) : null;\n  const previousBodies: Record<string, CachedBody> =\n    existingBodyCache && existingBodyCache.context_fingerprint === contextFingerprint ? existingBodyCache.bodies : {};\n\n  const entries = Object.entries(typeToFolder) as Array<[ItemType, string]>;\n  const dirResults = await Promise.all(\n    entries.map(async ([, folder]) => {\n      const dirPath = path.join(pmRoot, folder);\n      try {\n        const files = await fs.readdir(dirPath);\n        return { folder, dirPath, files };\n      } catch (error: unknown) {\n        if (typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code !== \"ENOENT\") {\n          appendWarning(warnings, `item_list_directory_read_failed:${folder}`);\n        }\n        return { folder, dirPath, files: [] as string[] };\n      }\n    }),\n  );\n\n  const dispatchReadHooks = hasActiveOnReadHooks();\n  const newEntries: Record<string, CachedEntry> = {};\n  const newBodies: Record<string, CachedBody> = {};\n  const documentsById = new Map<string, { candidate: CachedDocumentCandidate; itemFormat: ItemFormat }>();\n  let metadataMiss = false;\n  let bodyMiss = false;\n\n  const parseTasks: Array<Promise<void>> = [];\n\n  for (const { folder, dirPath, files } of dirResults) {\n    for (const file of files) {\n      if (!ITEM_FILE_EXTENSIONS.some((ext) => file.toLowerCase().endsWith(ext))) {\n        continue;\n      }\n      const filePath = path.join(dirPath, file);\n      const relativePath = path.relative(pmRoot, filePath);\n\n      parseTasks.push(\n        (async () => {\n          try {\n            const stat = await fs.stat(filePath);\n            const mtimeMs = stat.mtimeMs;\n            const ctimeMs = stat.ctimeMs;\n            const { size } = stat;\n            const itemFormat = getItemFormatFromPath(filePath) as ItemFormat;\n\n            // Preserve onRead hook semantics even when served from cache, but only\n            // when an extension actually observes reads. Surface hook warnings so\n            // read-hook failures are not silently hidden.\n            if (dispatchReadHooks) {\n              for (const warning of await runActiveOnReadHooks({ path: filePath, scope: \"project\" })) {\n                appendWarning(warnings, warning);\n              }\n            }\n\n            const cachedEntry = previousEntries[relativePath];\n            const metadataCached = cachedEntry !== undefined && statMatches(cachedEntry, mtimeMs, ctimeMs, size);\n            const cachedBody = previousBodies[relativePath];\n            const bodyCached = cachedBody !== undefined && statMatches(cachedBody, mtimeMs, ctimeMs, size);\n\n            const needRead = !metadataCached || (includeBody && !bodyCached);\n            let metadata: ItemMetadata;\n            let bodyLength: number;\n            let body: string | undefined;\n\n            if (needRead) {\n              const raw = await fs.readFile(filePath, \"utf8\");\n              const parsed = parseItemDocument(raw, {\n                format: itemFormat,\n                schema,\n                onWarning: (w) => appendWarning(warnings, w),\n              });\n              metadata = metadataCached ? cachedEntry.metadata : parsed.metadata;\n              bodyLength = metadataCached ? cachedEntry.body_length : parsed.body.length;\n              body = includeBody ? parsed.body : undefined;\n              if (!metadataCached) {\n                metadataMiss = true;\n              }\n              if (includeBody && !bodyCached) {\n                bodyMiss = true;\n              }\n            } else {\n              metadata = cachedEntry.metadata;\n              bodyLength = cachedEntry.body_length;\n              body = includeBody ? cachedBody.body : undefined;\n            }\n\n            newEntries[relativePath] = {\n              mtime_ms: mtimeMs,\n              ctime_ms: ctimeMs,\n              size,\n              metadata,\n              body_length: bodyLength,\n            };\n            if (includeBody && body !== undefined) {\n              newBodies[relativePath] = { mtime_ms: mtimeMs, ctime_ms: ctimeMs, size, body };\n            }\n\n            const existing = documentsById.get(metadata.id);\n            const candidate: CachedDocumentCandidate = {\n              metadata,\n              body,\n              item_format: itemFormat,\n              item_path: filePath,\n            };\n            if (!existing) {\n              documentsById.set(metadata.id, { candidate, itemFormat });\n            } else {\n              const shouldReplace = preferredFormat\n                ? itemFormat === preferredFormat && existing.itemFormat !== preferredFormat\n                : itemFormat === \"toon\" && existing.itemFormat !== \"toon\";\n              if (shouldReplace) {\n                documentsById.set(metadata.id, { candidate, itemFormat });\n              }\n            }\n          } catch {\n            appendWarning(warnings, `item_list_item_read_failed:${folder}/${file}`);\n          }\n        })(),\n      );\n    }\n  }\n\n  await Promise.all(parseTasks);\n\n  // Rewrite a cache file only when its contents changed: any re-parsed (missing or\n  // stale) entry, or a different set of keys (additions/deletions).\n  const metadataDirty = metadataMiss || Object.keys(previousEntries).length !== Object.keys(newEntries).length;\n  if (metadataDirty || existingCache === null || existingCache.context_fingerprint !== contextFingerprint) {\n    await persistCache(getCachePath(pmRoot), {\n      version: CACHE_VERSION,\n      context_fingerprint: contextFingerprint,\n      entries: newEntries,\n    }).catch(() => {});\n  }\n\n  if (includeBody) {\n    const bodyDirty = bodyMiss || Object.keys(previousBodies).length !== Object.keys(newBodies).length;\n    if (bodyDirty || existingBodyCache === null || existingBodyCache.context_fingerprint !== contextFingerprint) {\n      await persistCache(getBodyCachePath(pmRoot), {\n        version: CACHE_VERSION,\n        context_fingerprint: contextFingerprint,\n        bodies: newBodies,\n      }).catch(() => {});\n    }\n  }\n\n  return [...documentsById.values()]\n    .sort((left, right) => left.candidate.metadata.id.localeCompare(right.candidate.metadata.id))\n    .map((entry) => entry.candidate);\n}\n\nexport async function listAllDocumentsCached(\n  pmRoot: string,\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  warnings: string[] | undefined,\n  schema: RuntimeSchemaSettings | undefined,\n): Promise<ItemDocument[]> {\n  const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema, {\n    includeBody: false,\n  });\n  return candidates.map((candidate) => ({\n    metadata: candidate.metadata,\n    body: candidate.body ?? \"\",\n  }));\n}\n"],"names":[],"mappings":"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","debugId":"10d5600e-92e0-5342-a6a7-6bb48f44a92f"}

package/dist/core/store/item-store.d.ts

@@ -46,8 +46,10 @@ export declare function deleteItem(params: {
     author: string;
     message?: string;
     force?: boolean;
+    dryRun?: boolean;
 }): Promise<{
     item: ItemFrontMatter;
     changedFields: string[];
     warnings: string[];
+    targetPath?: string;
 }>;

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

@@ -1,5 +1,5 @@
 
-!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]="9faa72aa-63a0-5ae8-b9c8-62376ee34108")}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]="5024934d-4f09-54bd-a990-2ea2b2a03a1a")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, runActiveServiceOverride, } from "../extensions/index.js";
@@ -12,8 +12,8 @@ import { resolveItemTypeRegistry } from "../item/type-registry.js";
 import { acquireLock } from "../lock/lock.js";
 import { writeFileAtomic } from "../fs/fs-utils.js";
 import { normalizeItemId, normalizeRawItemId } from "../item/id.js";
-import { listAllDocumentsCached } from "./front-matter-cache.js";
-import { getHistoryPath, getItemFormatFromPath, getItemPath, ITEM_FILE_EXTENSIONS } from "./paths.js";
+import { listAllDocumentCandidatesCached, listAllDocumentsCached } from "./front-matter-cache.js";
+import { getHistoryPath, getItemPath, ITEM_FILE_EXTENSIONS } from "./paths.js";
 import { resolveGovernanceKnobs } from "./settings.js";
 import { nowIso } from "../shared/time.js";
 async function fileExists(targetPath) {
@@ -86,77 +86,12 @@ export async function listAllFrontMatter(pmRoot, preferredFormat, typeToFolder =
     return documents.map((document) => document.metadata);
 }
 export async function listAllFrontMatterWithBody(pmRoot, preferredFormat, typeToFolder = TYPE_TO_FOLDER, warnings, schema) {
-    const documents = await listAllDocuments(pmRoot, preferredFormat, typeToFolder, warnings, schema);
-    return documents.map((document) => ({
-        ...document.metadata,
-        body: document.body,
+    const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema, { includeBody: true });
+    return candidates.map((candidate) => ({
+        ...candidate.metadata,
+        body: candidate.body ?? "",
     }));
 }
-async function listAllDocuments(pmRoot, preferredFormat, typeToFolder = TYPE_TO_FOLDER, warnings, schema) {
-    const entries = Object.entries(typeToFolder);
-    const documentsById = new Map();
-    const dirResults = await Promise.all(entries.map(async ([, folder]) => {
-        const dirPath = path.join(pmRoot, folder);
-        try {
-            return { folder, files: await fs.readdir(dirPath) };
-        }
-        catch (error) {
-            if (!isErrno(error, "ENOENT")) {
-                appendWarning(warnings, `item_list_directory_read_failed:${folder}`);
-            }
-            return { folder, files: [] };
-        }
-    }));
-    const readTasks = [];
-    for (const { folder, files } of dirResults) {
-        const dirPath = path.join(pmRoot, folder);
-        for (const file of files.filter((entry) => ITEM_FILE_EXTENSIONS.some((ext) => entry.toLowerCase().endsWith(ext)))) {
-            readTasks.push((async () => {
-                try {
-                    const itemPath = path.join(dirPath, file);
-                    const itemFormat = getItemFormatFromPath(itemPath);
-                    const raw = await fs.readFile(itemPath, "utf8");
-                    await runActiveOnReadHooks({ path: itemPath, scope: "project" });
-                    const parsed = parseItemDocument(raw, {
-                        format: itemFormat,
-                        schema,
-                        onWarning: (warning) => appendWarning(warnings, warning),
-                    });
-                    return { folder, file, document: parsed, itemFormat };
-                }
-                catch {
-                    appendWarning(warnings, `item_list_item_read_failed:${folder}/${file}`);
-                    return null;
-                }
-            })());
-        }
-    }
-    const results = await Promise.all(readTasks);
-    for (const result of results) {
-        if (!result)
-            continue;
-        const existing = documentsById.get(result.document.metadata.id);
-        if (!existing) {
-            documentsById.set(result.document.metadata.id, {
-                document: result.document,
-                itemFormat: result.itemFormat,
-            });
-            continue;
-        }
-        const shouldReplace = preferredFormat
-            ? result.itemFormat === preferredFormat && existing.itemFormat !== preferredFormat
-            : result.itemFormat === "toon" && existing.itemFormat !== "toon";
-        if (shouldReplace) {
-            documentsById.set(result.document.metadata.id, {
-                document: result.document,
-                itemFormat: result.itemFormat,
-            });
-        }
-    }
-    return [...documentsById.values()]
-        .sort((left, right) => left.document.metadata.id.localeCompare(right.document.metadata.id))
-        .map((entry) => entry.document);
-}
 async function listKnownItemIds(pmRoot, typeToFolder) {
     const folders = new Set(Object.values(typeToFolder));
     const allIds = [];
@@ -217,38 +152,72 @@ export async function buildItemNotFoundError(pmRoot, badId, idPrefix, typeToFold
     }
     return new PmCliError(`Item ${badId} not found`, EXIT_CODE.NOT_FOUND, { nextSteps });
 }
-export async function mutateItem(params) {
-    const typeToFolder = params.typeToFolder ?? resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations()).type_to_folder;
+function bypassesAssigneeConflict(op, bypassAssigneeConflict) {
+    return (op === "claim" ||
+        (bypassAssigneeConflict === true &&
+            (op === "comment_add" ||
+                op === "note_add" ||
+                op === "learning_add" ||
+                op === "release" ||
+                op === "update" ||
+                op === "update_audit")));
+}
+async function prepareLockedItem(params) {
+    const typeToFolder = params.typeToFolder ??
+        resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations())
+            .type_to_folder;
     const located = await locateItem(params.pmRoot, params.id, params.settings.id_prefix, params.settings.item_format, typeToFolder);
     if (!located) {
         throw await buildItemNotFoundError(params.pmRoot, params.id, params.settings.id_prefix, typeToFolder);
     }
     const releaseLock = await acquireLock(params.pmRoot, located.id, params.settings.locks.ttl_seconds, params.author, Boolean(params.force), params.settings.governance.force_required_for_stale_lock);
     try {
-        const parseWarnings = [];
+        const warnings = [];
         const { raw: originalRaw, document } = await readLocatedItem(located, {
             schema: params.settings.schema,
-            warnings: parseWarnings,
+            warnings,
         });
         const assigned = document.metadata.assignee?.trim();
         const governance = resolveGovernanceKnobs(params.settings);
-        const bypassAssigneeConflict = params.op === "claim" ||
-            ((params.op === "comment_add" ||
-                params.op === "note_add" ||
-                params.op === "learning_add" ||
-                params.op === "release" ||
-                params.op === "update" ||
-                params.op === "update_audit") &&
-                params.bypassAssigneeConflict === true);
-        const hasOwnershipConflict = assigned && assigned !== params.author && !params.force && !bypassAssigneeConflict;
+        const hasOwnershipConflict = assigned &&
+            assigned !== params.author &&
+            !params.force &&
+            !bypassesAssigneeConflict(params.op, params.bypassAssigneeConflict);
         if (hasOwnershipConflict) {
             if (governance.ownership_enforcement === "strict") {
                 throw new PmCliError(`Item ${located.id} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
             }
             if (governance.ownership_enforcement === "warn") {
-                parseWarnings.push(`ownership_warning:assignee_conflict:${located.id}:${assigned}`);
+                warnings.push(`ownership_warning:assignee_conflict:${located.id}:${assigned}`);
             }
         }
+        return {
+            typeToFolder,
+            located,
+            originalRaw,
+            document,
+            warnings,
+            releaseLock,
+        };
+    }
+    catch (error) {
+        await releaseLock();
+        throw error;
+    }
+}
+export async function mutateItem(params) {
+    const prepared = await prepareLockedItem({
+        pmRoot: params.pmRoot,
+        settings: params.settings,
+        id: params.id,
+        op: params.op,
+        author: params.author,
+        force: params.force,
+        bypassAssigneeConflict: params.bypassAssigneeConflict,
+        typeToFolder: params.typeToFolder,
+    });
+    const { typeToFolder, located, originalRaw, document, warnings: parseWarnings, releaseLock, } = prepared;
+    try {
         const historyPolicy = await enforceHistoryStreamPolicyForItem({
             pmRoot: params.pmRoot,
             settings: params.settings,
@@ -282,7 +251,9 @@ export async function mutateItem(params) {
         let effectiveTargetItemPath = targetItemPath;
         let effectiveSerializedAfter = serializedAfter;
         let skipItemWrite = false;
-        if (serviceWriteOverride.handled && typeof serviceWriteOverride.result === "object" && serviceWriteOverride.result !== null) {
+        if (serviceWriteOverride.handled &&
+            typeof serviceWriteOverride.result === "object" &&
+            serviceWriteOverride.result !== null) {
             const overrideRecord = serviceWriteOverride.result;
             if (typeof overrideRecord.target_item_path === "string" && overrideRecord.target_item_path.trim().length > 0) {
                 effectiveTargetItemPath = overrideRecord.target_item_path;
@@ -351,29 +322,16 @@ export async function mutateItem(params) {
     }
 }
 export async function deleteItem(params) {
-    const typeToFolder = resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations()).type_to_folder;
-    const located = await locateItem(params.pmRoot, params.id, params.settings.id_prefix, params.settings.item_format, typeToFolder);
-    if (!located) {
-        throw await buildItemNotFoundError(params.pmRoot, params.id, params.settings.id_prefix, typeToFolder);
-    }
-    const releaseLock = await acquireLock(params.pmRoot, located.id, params.settings.locks.ttl_seconds, params.author, Boolean(params.force), params.settings.governance.force_required_for_stale_lock);
+    const prepared = await prepareLockedItem({
+        pmRoot: params.pmRoot,
+        settings: params.settings,
+        id: params.id,
+        op: "delete",
+        author: params.author,
+        force: params.force,
+    });
+    const { located, originalRaw, document, warnings: parseWarnings, releaseLock } = prepared;
     try {
-        const parseWarnings = [];
-        const { raw: originalRaw, document } = await readLocatedItem(located, {
-            schema: params.settings.schema,
-            warnings: parseWarnings,
-        });
-        const assigned = document.metadata.assignee?.trim();
-        const governance = resolveGovernanceKnobs(params.settings);
-        const hasOwnershipConflict = assigned && assigned !== params.author && !params.force;
-        if (hasOwnershipConflict) {
-            if (governance.ownership_enforcement === "strict") {
-                throw new PmCliError(`Item ${located.id} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
-            }
-            if (governance.ownership_enforcement === "warn") {
-                parseWarnings.push(`ownership_warning:assignee_conflict:${located.id}:${assigned}`);
-            }
-        }
         const historyPolicy = await enforceHistoryStreamPolicyForItem({
             pmRoot: params.pmRoot,
             settings: params.settings,
@@ -413,6 +371,14 @@ export async function deleteItem(params) {
                 skipDelete = true;
             }
         }
+        if (params.dryRun === true) {
+            return {
+                item: beforeDocument.metadata,
+                changedFields: ["deleted"],
+                targetPath: effectiveItemPath,
+                warnings: [...parseWarnings, ...historyPolicy.warnings, ...serviceDeleteOverride.warnings],
+            };
+        }
         if (!skipDelete) {
             await fs.rm(effectiveItemPath);
         }
@@ -448,4 +414,4 @@ export async function deleteItem(params) {
     }
 }
 //# sourceMappingURL=item-store.js.map
-//# debugId=9faa72aa-63a0-5ae8-b9c8-62376ee34108
+//# debugId=5024934d-4f09-54bd-a990-2ea2b2a03a1a