@unbrained/pm-cli 2026.5.14 → 2026.5.24

package/dist/cli/commands/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"/","sources":["cli/commands/get.ts"],"names":[],"mappings":"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","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter, LinkedDoc, LinkedFile, LinkedTest } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\ninterface ClaimHistoryContext {\n  ts: string;\n  author: string;\n  message: string | null;\n}\n\ninterface ClaimHistoryEntry {\n  op: string;\n  ts: string;\n  author: string;\n  message?: string;\n}\n\ninterface ClaimStateContext {\n  claimed: boolean;\n  assignee: string | null;\n  last_claim: ClaimHistoryContext | null;\n  last_release: ClaimHistoryContext | null;\n}\n\nexport interface GetResult {\n  item: ItemFrontMatter;\n  body: string;\n  linked: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  claim_state: ClaimStateContext;\n}\n\nfunction toClaimHistoryContext(\n  entry: ClaimHistoryEntry,\n): ClaimHistoryContext {\n  return {\n    ts: entry.ts,\n    author: entry.author,\n    message: entry.message ?? null,\n  };\n}\n\nfunction resolveClaimStateContext(\n  assigneeValue: string | undefined,\n  history: ClaimHistoryEntry[],\n): ClaimStateContext {\n  const assignee = assigneeValue?.trim();\n  const normalizedAssignee = assignee && assignee.length > 0 ? assignee : null;\n  const lastClaim = [...history].reverse().find((entry) => entry.op === \"claim\");\n  const lastRelease = [...history].reverse().find((entry) => entry.op === \"release\");\n  return {\n    claimed: normalizedAssignee !== null,\n    assignee: normalizedAssignee,\n    last_claim: lastClaim ? toClaimHistoryContext(lastClaim) : null,\n    last_release: lastRelease ? toClaimHistoryContext(lastRelease) : null,\n  };\n}\n\nexport async function runGet(id: string, global: GlobalOptions): Promise<GetResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n  if (!located) {\n    throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n  }\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  const historyPath = getHistoryPath(pmRoot, located.id);\n  let history: ClaimHistoryEntry[] = [];\n  try {\n    history = await readHistoryEntries(historyPath, located.id);\n  } catch {\n    history = [];\n  }\n  return {\n    item: loaded.document.metadata,\n    body: loaded.document.body,\n    linked: {\n      files: loaded.document.metadata.files ?? [],\n      tests: loaded.document.metadata.tests ?? [],\n      docs: loaded.document.metadata.docs ?? [],\n    },\n    claim_state: resolveClaimStateContext(loaded.document.metadata.assignee, history),\n  };\n}\n"]}
+{"version":3,"file":"get.js","sources":["cli/commands/get.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeFieldRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { buildItemNotFoundError, locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter, LinkedDoc, LinkedFile, LinkedTest } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\ninterface ClaimHistoryContext {\n  ts: string;\n  author: string;\n  message: string | null;\n}\n\ninterface ClaimHistoryEntry {\n  op: string;\n  ts: string;\n  author: string;\n  message?: string;\n}\n\ninterface ClaimStateContext {\n  claimed: boolean;\n  assignee: string | null;\n  last_claim: ClaimHistoryContext | null;\n  last_release: ClaimHistoryContext | null;\n}\n\nexport interface GetResult {\n  item: Partial<ItemFrontMatter>;\n  body?: string;\n  linked?: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  claim_state?: ClaimStateContext;\n}\n\nconst GET_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\n\ntype GetDepth = (typeof GET_DEPTH_VALUES)[number];\n\nexport interface GetOptions {\n  depth?: string;\n  fields?: string;\n  full?: boolean;\n}\n\nfunction toClaimHistoryContext(\n  entry: ClaimHistoryEntry,\n): ClaimHistoryContext {\n  return {\n    ts: entry.ts,\n    author: entry.author,\n    message: entry.message ?? null,\n  };\n}\n\nfunction resolveClaimStateContext(\n  assigneeValue: string | undefined,\n  history: ClaimHistoryEntry[],\n): ClaimStateContext {\n  const assignee = assigneeValue?.trim();\n  const normalizedAssignee = assignee && assignee.length > 0 ? assignee : null;\n  const lastClaim = [...history].reverse().find((entry) => entry.op === \"claim\");\n  const lastRelease = [...history].reverse().find((entry) => entry.op === \"release\");\n  return {\n    claimed: normalizedAssignee !== null,\n    assignee: normalizedAssignee,\n    last_claim: lastClaim ? toClaimHistoryContext(lastClaim) : null,\n    last_release: lastRelease ? toClaimHistoryContext(lastRelease) : null,\n  };\n}\n\nfunction parseGetDepth(raw: string | undefined): GetDepth {\n  if (raw === undefined || raw.trim().length === 0) {\n    return \"deep\";\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (GET_DEPTH_VALUES.includes(normalized as GetDepth)) {\n    return normalized as GetDepth;\n  }\n  throw new PmCliError(\"Get --depth must be one of brief|standard|deep\", EXIT_CODE.USAGE);\n}\n\nfunction projectItemForDepth(item: ItemFrontMatter, depth: GetDepth): Partial<ItemFrontMatter> {\n  if (depth === \"deep\") {\n    return item;\n  }\n  const {\n    comments: _comments,\n    notes: _notes,\n    learnings: _learnings,\n    files: _files,\n    tests: _tests,\n    docs: _docs,\n    reminders: _reminders,\n    events: _events,\n    ...projected\n  } = item;\n  return projected;\n}\n\nfunction parseGetFields(raw: string | undefined): string[] | null {\n  if (raw === undefined) {\n    return null;\n  }\n  const fields = raw\n    .split(\",\")\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  if (fields.length === 0) {\n    throw new PmCliError(\"Get --fields requires a comma-separated list of field names\", EXIT_CODE.USAGE);\n  }\n  return fields;\n}\n\nfunction normalizeGetField(field: string): string {\n  return field.startsWith(\"item.\") ? field.slice(\"item.\".length) : field;\n}\n\nfunction validateGetFields(fields: string[] | null, runtimeMetadataKeys: Iterable<string>): void {\n  if (fields === null) {\n    return;\n  }\n  const itemFields = new Set([...FRONT_MATTER_KEY_ORDER, ...runtimeMetadataKeys]);\n  const allowedRootFields = new Set([\"body\", \"linked\", \"claim_state\"]);\n  const allowedLinkedFields = new Set([\"linked.files\", \"linked.tests\", \"linked.docs\"]);\n  const allowedClaimStateFields = new Set([\"claim_state.claimed\", \"claim_state.assignee\", \"claim_state.last_claim\", \"claim_state.last_release\"]);\n  const unknown = fields.filter((field) => {\n    const normalized = normalizeGetField(field);\n    return (\n      !itemFields.has(normalized) &&\n      !allowedRootFields.has(normalized) &&\n      !allowedLinkedFields.has(normalized) &&\n      !allowedClaimStateFields.has(normalized)\n    );\n  });\n  if (unknown.length > 0) {\n    throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(\", \")}`, EXIT_CODE.USAGE, {\n      code: \"unknown_field_projection\",\n      examples: [\n        \"pm get <id> --fields id,title,status,type,updated_at\",\n        \"pm get <id> --fields id,title,claim_state\",\n        \"pm get <id> --fields id,title,body,linked.files\",\n      ],\n    });\n  }\n}\n\nfunction projectItemForFields(item: ItemFrontMatter, fields: string[]): Partial<ItemFrontMatter> {\n  const source = item as unknown as Record<string, unknown>;\n  const projected: Record<string, unknown> = {};\n  for (const field of fields) {\n    const normalized = field.startsWith(\"item.\") ? field.slice(\"item.\".length) : field;\n    if (normalized === \"body\" || normalized === \"linked\" || normalized.startsWith(\"linked.\")) {\n      continue;\n    }\n    projected[normalized] = source[normalized];\n  }\n  return projected as Partial<ItemFrontMatter>;\n}\n\nfunction fieldsInclude(fields: string[] | null, name: string): boolean {\n  return fields?.some((field) => field === name || field === `item.${name}`) ?? false;\n}\n\nfunction fieldsIncludeRoot(fields: string[], name: string): boolean {\n  return fields.some((field) => field === name || field.startsWith(`${name}.`));\n}\n\nexport async function runGet(id: string, global: GlobalOptions, options: GetOptions = {}): Promise<GetResult> {\n  if (options.full && (options.fields !== undefined || options.depth !== undefined)) {\n    throw new PmCliError(\"Get projection options are mutually exclusive; remove the extra projection flag and retry.\", EXIT_CODE.USAGE);\n  }\n  const depth = options.full ? \"deep\" : parseGetDepth(options.depth);\n  const fields = parseGetFields(options.fields);\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n  if (!located) {\n    throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeRegistry.type_to_folder);\n  }\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  const runtimeMetadataKeys: string[] = [];\n  for (const field of resolveRuntimeFieldRegistry(settings.schema).definitions) {\n    runtimeMetadataKeys.push(field.metadata_key);\n  }\n  validateGetFields(fields, runtimeMetadataKeys);\n  const files = loaded.document.metadata.files ?? [];\n  const tests = loaded.document.metadata.tests ?? [];\n  const docs = loaded.document.metadata.docs ?? [];\n  const fieldProjection = fields !== null;\n  const includeBody = !fieldProjection ? depth !== \"brief\" : fieldsInclude(fields, \"body\");\n  const includeLinked = !fieldProjection ? depth !== \"brief\" : fieldsInclude(fields, \"linked\");\n  const includeLinkedFiles = includeLinked || fieldsInclude(fields, \"linked.files\");\n  const includeLinkedTests = includeLinked || fieldsInclude(fields, \"linked.tests\");\n  const includeLinkedDocs = includeLinked || fieldsInclude(fields, \"linked.docs\");\n  const includeClaimState = !fieldProjection || fieldsIncludeRoot(fields, \"claim_state\");\n  let claimState: ClaimStateContext | undefined;\n  if (includeClaimState) {\n    const historyPath = getHistoryPath(pmRoot, located.id);\n    let history: ClaimHistoryEntry[] = [];\n    try {\n      history = await readHistoryEntries(historyPath, located.id);\n    } catch {\n      history = [];\n    }\n    claimState = resolveClaimStateContext(loaded.document.metadata.assignee, history);\n  }\n  const result: GetResult = {\n    item: fieldProjection\n      ? projectItemForFields(loaded.document.metadata, fields)\n      : projectItemForDepth(loaded.document.metadata, depth),\n  };\n  if (!fieldProjection || includeBody) {\n    result.body = includeBody ? loaded.document.body : \"\";\n  }\n  if (!fieldProjection || includeLinked || includeLinkedFiles || includeLinkedTests || includeLinkedDocs) {\n    result.linked = {\n      files: includeLinkedFiles ? files : [],\n      tests: includeLinkedTests ? tests : [],\n      docs: includeLinkedDocs ? docs : [],\n    };\n  }\n  if (claimState) {\n    result.claim_state = claimState;\n  }\n  return result;\n}\n"],"names":[],"mappings":"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","debugId":"09364085-fc2b-5c0f-95cb-0dafd66220d4"}

package/dist/cli/commands/guide.js

@@ -1,12 +1,13 @@
+
+!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]="8d06806e-bba1-5626-9ff4-b7fda8387582")}catch(e){}}();
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
+import { resolveConfiguredPmPackageRoot } from "../../core/packages/root.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { listGuideTopicIds, listGuideTopics, resolveGuideTopic, } from "../guide-topics.js";
 export const GUIDE_OUTPUT_VALUES = ["markdown", "toon", "json"];
 export const GUIDE_DEPTH_VALUES = ["brief", "standard", "deep"];
-const PACKAGE_ROOT_FROM_SOURCE = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
 function parseGuideOutputFormat(raw) {
     if (!raw) {
         return undefined;
@@ -38,11 +39,7 @@ function parseGuideDepth(raw) {
     return normalized;
 }
 function resolvePackageRoot() {
-    const envRoot = process.env.PM_CLI_PACKAGE_ROOT;
-    if (typeof envRoot === "string" && envRoot.trim().length > 0) {
-        return path.resolve(envRoot.trim());
-    }
-    return PACKAGE_ROOT_FROM_SOURCE;
+    return resolveConfiguredPmPackageRoot(process.env, "PM_CLI_PACKAGE_ROOT", import.meta.url, ["..", "..", ".."]);
 }
 function normalizeLineEndings(value) {
     return value.replaceAll("\r\n", "\n");
@@ -257,4 +254,5 @@ export function renderGuideMarkdown(result) {
     }
     return lines.join("\n");
 }
-//# sourceMappingURL=guide.js.map
+//# sourceMappingURL=guide.js.map
+//# debugId=8d06806e-bba1-5626-9ff4-b7fda8387582

package/dist/cli/commands/guide.js.map

@@ -1 +1 @@
-{"version":3,"file":"guide.js","sourceRoot":"/","sources":["cli/commands/guide.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  listGuideTopicIds,\n  listGuideTopics,\n  resolveGuideTopic,\n  type GuideTopicDefinition,\n} from \"../guide-topics.js\";\n\nexport const GUIDE_OUTPUT_VALUES = [\"markdown\", \"toon\", \"json\"] as const;\nexport type GuideOutputFormat = (typeof GUIDE_OUTPUT_VALUES)[number];\n\nexport const GUIDE_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\nexport type GuideDepth = (typeof GUIDE_DEPTH_VALUES)[number];\n\nexport interface GuideOptions {\n  topic?: string;\n  list?: boolean;\n  format?: string;\n  depth?: string;\n  [key: string]: unknown;\n}\n\nexport interface GuideDocRender {\n  path: string;\n  purpose: string;\n  optional: boolean;\n  exists: boolean;\n  line_count: number | null;\n  content_mode: \"none\" | \"excerpt\" | \"full\";\n  content: string | null;\n  truncated: boolean;\n}\n\nexport interface GuideIndexResult {\n  output_default: \"toon\";\n  mode: \"index\";\n  depth: GuideDepth;\n  topics: Array<{\n    id: string;\n    aliases: string[];\n    title: string;\n    summary: string;\n    intent: string;\n    quick_commands: string[];\n    docs: Array<{ path: string; purpose: string }>;\n    related: string[];\n  }>;\n  suggested_next_steps: string[];\n}\n\nexport interface GuideTopicResult {\n  output_default: \"toon\";\n  mode: \"topic\";\n  depth: GuideDepth;\n  requested_topic: string;\n  topic: GuideTopicDefinition;\n  docs: GuideDocRender[];\n  warnings: string[];\n}\n\nexport type GuideResult = GuideIndexResult | GuideTopicResult;\n\nconst PACKAGE_ROOT_FROM_SOURCE = path.resolve(path.dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"..\");\n\nfunction parseGuideOutputFormat(raw: string | undefined): GuideOutputFormat | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (!GUIDE_OUTPUT_VALUES.includes(normalized as GuideOutputFormat)) {\n    throw new PmCliError(\"Guide format must be one of markdown|toon|json\", EXIT_CODE.USAGE);\n  }\n  return normalized as GuideOutputFormat;\n}\n\nexport function resolveGuideOutputFormat(options: GuideOptions, global: GlobalOptions): GuideOutputFormat {\n  const commandFormat = parseGuideOutputFormat(options.format);\n  if (global.json && commandFormat && commandFormat !== \"json\") {\n    throw new PmCliError(\"Cannot combine --json with --format markdown|toon\", EXIT_CODE.USAGE);\n  }\n  if (global.json) {\n    return \"json\";\n  }\n  return commandFormat ?? \"toon\";\n}\n\nfunction parseGuideDepth(raw: string | undefined): GuideDepth {\n  if (!raw) {\n    return \"brief\";\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (!GUIDE_DEPTH_VALUES.includes(normalized as GuideDepth)) {\n    throw new PmCliError(\"Guide depth must be one of brief|standard|deep\", EXIT_CODE.USAGE);\n  }\n  return normalized as GuideDepth;\n}\n\nfunction resolvePackageRoot(): string {\n  const envRoot = process.env.PM_CLI_PACKAGE_ROOT;\n  if (typeof envRoot === \"string\" && envRoot.trim().length > 0) {\n    return path.resolve(envRoot.trim());\n  }\n  return PACKAGE_ROOT_FROM_SOURCE;\n}\n\nfunction normalizeLineEndings(value: string): string {\n  return value.replaceAll(\"\\r\\n\", \"\\n\");\n}\n\nfunction toExcerpt(content: string, maxLines: number, maxCharacters: number): { excerpt: string; truncated: boolean; lineCount: number } {\n  const normalized = normalizeLineEndings(content);\n  const lines = normalized.split(\"\\n\");\n  const lineSlice = lines.slice(0, maxLines);\n  let excerpt = lineSlice.join(\"\\n\");\n  let truncated = lines.length > maxLines;\n  if (excerpt.length > maxCharacters) {\n    excerpt = excerpt.slice(0, maxCharacters);\n    truncated = true;\n  }\n  return {\n    excerpt: excerpt.trimEnd(),\n    truncated,\n    lineCount: lines.length,\n  };\n}\n\nasync function renderGuideDocs(topic: GuideTopicDefinition, depth: GuideDepth, packageRoot: string): Promise<GuideDocRender[]> {\n  const includeContent = depth !== \"brief\";\n  const contentMode: GuideDocRender[\"content_mode\"] = includeContent ? (depth === \"deep\" ? \"full\" : \"excerpt\") : \"none\";\n  const docs: GuideDocRender[] = [];\n  for (const doc of topic.docs) {\n    const absolutePath = path.resolve(packageRoot, doc.path);\n    if (!includeContent) {\n      docs.push({\n        path: doc.path,\n        purpose: doc.purpose,\n        optional: doc.optional === true,\n        exists: true,\n        line_count: null,\n        content_mode: \"none\",\n        content: null,\n        truncated: false,\n      });\n      continue;\n    }\n    try {\n      const rawContent = await readFile(absolutePath, \"utf8\");\n      if (depth === \"deep\") {\n        const normalized = normalizeLineEndings(rawContent).trimEnd();\n        docs.push({\n          path: doc.path,\n          purpose: doc.purpose,\n          optional: doc.optional === true,\n          exists: true,\n          line_count: normalized.length === 0 ? 0 : normalized.split(\"\\n\").length,\n          content_mode: \"full\",\n          content: normalized,\n          truncated: false,\n        });\n      } else {\n        const excerpt = toExcerpt(rawContent, 120, 12_000);\n        docs.push({\n          path: doc.path,\n          purpose: doc.purpose,\n          optional: doc.optional === true,\n          exists: true,\n          line_count: excerpt.lineCount,\n          content_mode: contentMode,\n          content: excerpt.excerpt,\n          truncated: excerpt.truncated,\n        });\n      }\n    } catch (error) {\n      const code = (error as { code?: string } | null)?.code;\n      const missing = code === \"ENOENT\";\n      docs.push({\n        path: doc.path,\n        purpose: doc.purpose,\n        optional: doc.optional === true,\n        exists: false,\n        line_count: null,\n        content_mode: \"none\",\n        content: null,\n        truncated: false,\n      });\n      if (!missing) {\n        throw new PmCliError(`Failed to read guide document \"${doc.path}\".`, EXIT_CODE.GENERIC_FAILURE);\n      }\n    }\n  }\n  return docs;\n}\n\nfunction buildGuideIndex(depth: GuideDepth): GuideIndexResult {\n  const topics = listGuideTopics().map((topic) => ({\n    id: topic.id,\n    aliases: topic.aliases,\n    title: topic.title,\n    summary: topic.summary,\n    intent: topic.intent,\n    quick_commands: depth === \"brief\" ? topic.commands.slice(0, 3) : topic.commands.slice(0, 6),\n    docs: topic.docs.map((doc) => ({ path: doc.path, purpose: doc.purpose })),\n    related: topic.related,\n  }));\n  return {\n    output_default: \"toon\",\n    mode: \"index\",\n    depth,\n    topics,\n    suggested_next_steps: [\n      \"pm guide <topic>\",\n      \"pm guide <topic> --depth standard\",\n      \"pm guide <topic> --depth deep --format markdown\",\n      \"pm guide <topic> --json\",\n    ],\n  };\n}\n\nfunction ensureGuideTopic(topic: string | undefined): GuideTopicDefinition {\n  const resolved = resolveGuideTopic(topic);\n  if (resolved) {\n    return resolved;\n  }\n  const available = listGuideTopicIds().join(\", \");\n  throw new PmCliError(\n    `Unknown guide topic \"${topic ?? \"\"}\". Available topics: ${available}. Use \"pm guide --list\" to browse.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nexport async function runGuide(options: GuideOptions, global: GlobalOptions): Promise<GuideResult> {\n  const depth = parseGuideDepth(typeof options.depth === \"string\" ? options.depth : undefined);\n  const listRequested = options.list === true;\n  const topicRaw = typeof options.topic === \"string\" ? options.topic : undefined;\n  if (listRequested || !topicRaw) {\n    return buildGuideIndex(depth);\n  }\n\n  const topic = ensureGuideTopic(topicRaw);\n  const packageRoot = resolvePackageRoot();\n  const docs = await renderGuideDocs(topic, depth, packageRoot);\n  const warnings = docs\n    .filter((doc) => !doc.exists && !doc.optional)\n    .map((doc) => `Missing required guide document: ${doc.path}`);\n\n  return {\n    output_default: \"toon\",\n    mode: \"topic\",\n    depth,\n    requested_topic: topicRaw,\n    topic,\n    docs,\n    warnings,\n  };\n}\n\nfunction markdownCodeFence(content: string): string {\n  return content.replaceAll(\"```\", \"``\\\\`\");\n}\n\nexport function renderGuideMarkdown(result: GuideResult): string {\n  if (result.mode === \"index\") {\n    const lines: string[] = [\n      \"# pm guide\",\n      \"\",\n      \"Token-efficient local documentation index for agent and maintainer workflows.\",\n      \"\",\n      \"## Topics\",\n    ];\n    for (const topic of result.topics) {\n      lines.push(`- \\`${topic.id}\\` - ${topic.summary}`);\n      if (result.depth !== \"brief\") {\n        lines.push(`  - intent: ${topic.intent}`);\n        lines.push(`  - docs: ${topic.docs.map((doc) => `\\`${doc.path}\\``).join(\", \")}`);\n      }\n    }\n    lines.push(\"\", \"## Next steps\");\n    for (const step of result.suggested_next_steps) {\n      lines.push(`- \\`${step}\\``);\n    }\n    return lines.join(\"\\n\");\n  }\n\n  const lines: string[] = [\n    `# pm guide ${result.topic.id}`,\n    \"\",\n    result.topic.summary,\n    \"\",\n    \"## Intent\",\n    result.topic.intent,\n    \"\",\n    \"## Key commands\",\n    ...result.topic.commands.map((command) => `- \\`${command}\\``),\n    \"\",\n    \"## Workflow prompts\",\n  ];\n  for (const workflow of result.topic.workflows) {\n    lines.push(`### ${workflow.name}`);\n    lines.push(`goal: ${workflow.goal}`);\n    lines.push(`prompt: ${workflow.prompt}`);\n    lines.push(\"commands:\");\n    lines.push(...workflow.commands.map((command) => `- \\`${command}\\``));\n    lines.push(\"\");\n  }\n  lines.push(\"## Documents\");\n  for (const doc of result.docs) {\n    const status = doc.exists ? \"available\" : doc.optional ? \"missing (optional)\" : \"missing (required)\";\n    lines.push(`- \\`${doc.path}\\` - ${doc.purpose} (${status})`);\n    if (doc.exists && doc.content_mode !== \"none\" && doc.content) {\n      lines.push(\"\");\n      lines.push(`### Excerpt: \\`${doc.path}\\``);\n      if (doc.truncated) {\n        lines.push(\"_truncated for context efficiency_\");\n      }\n      lines.push(\"```markdown\");\n      lines.push(markdownCodeFence(doc.content));\n      lines.push(\"```\");\n    }\n  }\n  if (result.topic.related.length > 0) {\n    lines.push(\"\", \"## Related topics\");\n    lines.push(...result.topic.related.map((topic) => `- \\`${topic}\\``));\n  }\n  if (result.warnings.length > 0) {\n    lines.push(\"\", \"## Warnings\");\n    lines.push(...result.warnings.map((warning) => `- ${warning}`));\n  }\n  return lines.join(\"\\n\");\n}\n\n"]}
+{"version":3,"file":"guide.js","sources":["cli/commands/guide.ts"],"sourceRoot":"/","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { resolveConfiguredPmPackageRoot } from \"../../core/packages/root.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  listGuideTopicIds,\n  listGuideTopics,\n  resolveGuideTopic,\n  type GuideTopicDefinition,\n} from \"../guide-topics.js\";\n\nexport const GUIDE_OUTPUT_VALUES = [\"markdown\", \"toon\", \"json\"] as const;\nexport type GuideOutputFormat = (typeof GUIDE_OUTPUT_VALUES)[number];\n\nexport const GUIDE_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\nexport type GuideDepth = (typeof GUIDE_DEPTH_VALUES)[number];\n\nexport interface GuideOptions {\n  topic?: string;\n  list?: boolean;\n  format?: string;\n  depth?: string;\n  [key: string]: unknown;\n}\n\nexport interface GuideDocRender {\n  path: string;\n  purpose: string;\n  optional: boolean;\n  exists: boolean;\n  line_count: number | null;\n  content_mode: \"none\" | \"excerpt\" | \"full\";\n  content: string | null;\n  truncated: boolean;\n}\n\nexport interface GuideIndexResult {\n  output_default: \"toon\";\n  mode: \"index\";\n  depth: GuideDepth;\n  topics: Array<{\n    id: string;\n    aliases: string[];\n    title: string;\n    summary: string;\n    intent: string;\n    quick_commands: string[];\n    docs: Array<{ path: string; purpose: string }>;\n    related: string[];\n  }>;\n  suggested_next_steps: string[];\n}\n\nexport interface GuideTopicResult {\n  output_default: \"toon\";\n  mode: \"topic\";\n  depth: GuideDepth;\n  requested_topic: string;\n  topic: GuideTopicDefinition;\n  docs: GuideDocRender[];\n  warnings: string[];\n}\n\nexport type GuideResult = GuideIndexResult | GuideTopicResult;\n\nfunction parseGuideOutputFormat(raw: string | undefined): GuideOutputFormat | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (!GUIDE_OUTPUT_VALUES.includes(normalized as GuideOutputFormat)) {\n    throw new PmCliError(\"Guide format must be one of markdown|toon|json\", EXIT_CODE.USAGE);\n  }\n  return normalized as GuideOutputFormat;\n}\n\nexport function resolveGuideOutputFormat(options: GuideOptions, global: GlobalOptions): GuideOutputFormat {\n  const commandFormat = parseGuideOutputFormat(options.format);\n  if (global.json && commandFormat && commandFormat !== \"json\") {\n    throw new PmCliError(\"Cannot combine --json with --format markdown|toon\", EXIT_CODE.USAGE);\n  }\n  if (global.json) {\n    return \"json\";\n  }\n  return commandFormat ?? \"toon\";\n}\n\nfunction parseGuideDepth(raw: string | undefined): GuideDepth {\n  if (!raw) {\n    return \"brief\";\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (!GUIDE_DEPTH_VALUES.includes(normalized as GuideDepth)) {\n    throw new PmCliError(\"Guide depth must be one of brief|standard|deep\", EXIT_CODE.USAGE);\n  }\n  return normalized as GuideDepth;\n}\n\nfunction resolvePackageRoot(): string {\n  return resolveConfiguredPmPackageRoot(process.env, \"PM_CLI_PACKAGE_ROOT\", import.meta.url, [\"..\", \"..\", \"..\"]);\n}\n\nfunction normalizeLineEndings(value: string): string {\n  return value.replaceAll(\"\\r\\n\", \"\\n\");\n}\n\nfunction toExcerpt(content: string, maxLines: number, maxCharacters: number): { excerpt: string; truncated: boolean; lineCount: number } {\n  const normalized = normalizeLineEndings(content);\n  const lines = normalized.split(\"\\n\");\n  const lineSlice = lines.slice(0, maxLines);\n  let excerpt = lineSlice.join(\"\\n\");\n  let truncated = lines.length > maxLines;\n  if (excerpt.length > maxCharacters) {\n    excerpt = excerpt.slice(0, maxCharacters);\n    truncated = true;\n  }\n  return {\n    excerpt: excerpt.trimEnd(),\n    truncated,\n    lineCount: lines.length,\n  };\n}\n\nasync function renderGuideDocs(topic: GuideTopicDefinition, depth: GuideDepth, packageRoot: string): Promise<GuideDocRender[]> {\n  const includeContent = depth !== \"brief\";\n  const contentMode: GuideDocRender[\"content_mode\"] = includeContent ? (depth === \"deep\" ? \"full\" : \"excerpt\") : \"none\";\n  const docs: GuideDocRender[] = [];\n  for (const doc of topic.docs) {\n    const absolutePath = path.resolve(packageRoot, doc.path);\n    if (!includeContent) {\n      docs.push({\n        path: doc.path,\n        purpose: doc.purpose,\n        optional: doc.optional === true,\n        exists: true,\n        line_count: null,\n        content_mode: \"none\",\n        content: null,\n        truncated: false,\n      });\n      continue;\n    }\n    try {\n      const rawContent = await readFile(absolutePath, \"utf8\");\n      if (depth === \"deep\") {\n        const normalized = normalizeLineEndings(rawContent).trimEnd();\n        docs.push({\n          path: doc.path,\n          purpose: doc.purpose,\n          optional: doc.optional === true,\n          exists: true,\n          line_count: normalized.length === 0 ? 0 : normalized.split(\"\\n\").length,\n          content_mode: \"full\",\n          content: normalized,\n          truncated: false,\n        });\n      } else {\n        const excerpt = toExcerpt(rawContent, 120, 12_000);\n        docs.push({\n          path: doc.path,\n          purpose: doc.purpose,\n          optional: doc.optional === true,\n          exists: true,\n          line_count: excerpt.lineCount,\n          content_mode: contentMode,\n          content: excerpt.excerpt,\n          truncated: excerpt.truncated,\n        });\n      }\n    } catch (error) {\n      const code = (error as { code?: string } | null)?.code;\n      const missing = code === \"ENOENT\";\n      docs.push({\n        path: doc.path,\n        purpose: doc.purpose,\n        optional: doc.optional === true,\n        exists: false,\n        line_count: null,\n        content_mode: \"none\",\n        content: null,\n        truncated: false,\n      });\n      if (!missing) {\n        throw new PmCliError(`Failed to read guide document \"${doc.path}\".`, EXIT_CODE.GENERIC_FAILURE);\n      }\n    }\n  }\n  return docs;\n}\n\nfunction buildGuideIndex(depth: GuideDepth): GuideIndexResult {\n  const topics = listGuideTopics().map((topic) => ({\n    id: topic.id,\n    aliases: topic.aliases,\n    title: topic.title,\n    summary: topic.summary,\n    intent: topic.intent,\n    quick_commands: depth === \"brief\" ? topic.commands.slice(0, 3) : topic.commands.slice(0, 6),\n    docs: topic.docs.map((doc) => ({ path: doc.path, purpose: doc.purpose })),\n    related: topic.related,\n  }));\n  return {\n    output_default: \"toon\",\n    mode: \"index\",\n    depth,\n    topics,\n    suggested_next_steps: [\n      \"pm guide <topic>\",\n      \"pm guide <topic> --depth standard\",\n      \"pm guide <topic> --depth deep --format markdown\",\n      \"pm guide <topic> --json\",\n    ],\n  };\n}\n\nfunction ensureGuideTopic(topic: string | undefined): GuideTopicDefinition {\n  const resolved = resolveGuideTopic(topic);\n  if (resolved) {\n    return resolved;\n  }\n  const available = listGuideTopicIds().join(\", \");\n  throw new PmCliError(\n    `Unknown guide topic \"${topic ?? \"\"}\". Available topics: ${available}. Use \"pm guide --list\" to browse.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nexport async function runGuide(options: GuideOptions, global: GlobalOptions): Promise<GuideResult> {\n  const depth = parseGuideDepth(typeof options.depth === \"string\" ? options.depth : undefined);\n  const listRequested = options.list === true;\n  const topicRaw = typeof options.topic === \"string\" ? options.topic : undefined;\n  if (listRequested || !topicRaw) {\n    return buildGuideIndex(depth);\n  }\n\n  const topic = ensureGuideTopic(topicRaw);\n  const packageRoot = resolvePackageRoot();\n  const docs = await renderGuideDocs(topic, depth, packageRoot);\n  const warnings = docs\n    .filter((doc) => !doc.exists && !doc.optional)\n    .map((doc) => `Missing required guide document: ${doc.path}`);\n\n  return {\n    output_default: \"toon\",\n    mode: \"topic\",\n    depth,\n    requested_topic: topicRaw,\n    topic,\n    docs,\n    warnings,\n  };\n}\n\nfunction markdownCodeFence(content: string): string {\n  return content.replaceAll(\"```\", \"``\\\\`\");\n}\n\nexport function renderGuideMarkdown(result: GuideResult): string {\n  if (result.mode === \"index\") {\n    const lines: string[] = [\n      \"# pm guide\",\n      \"\",\n      \"Token-efficient local documentation index for agent and maintainer workflows.\",\n      \"\",\n      \"## Topics\",\n    ];\n    for (const topic of result.topics) {\n      lines.push(`- \\`${topic.id}\\` - ${topic.summary}`);\n      if (result.depth !== \"brief\") {\n        lines.push(`  - intent: ${topic.intent}`);\n        lines.push(`  - docs: ${topic.docs.map((doc) => `\\`${doc.path}\\``).join(\", \")}`);\n      }\n    }\n    lines.push(\"\", \"## Next steps\");\n    for (const step of result.suggested_next_steps) {\n      lines.push(`- \\`${step}\\``);\n    }\n    return lines.join(\"\\n\");\n  }\n\n  const lines: string[] = [\n    `# pm guide ${result.topic.id}`,\n    \"\",\n    result.topic.summary,\n    \"\",\n    \"## Intent\",\n    result.topic.intent,\n    \"\",\n    \"## Key commands\",\n    ...result.topic.commands.map((command) => `- \\`${command}\\``),\n    \"\",\n    \"## Workflow prompts\",\n  ];\n  for (const workflow of result.topic.workflows) {\n    lines.push(`### ${workflow.name}`);\n    lines.push(`goal: ${workflow.goal}`);\n    lines.push(`prompt: ${workflow.prompt}`);\n    lines.push(\"commands:\");\n    lines.push(...workflow.commands.map((command) => `- \\`${command}\\``));\n    lines.push(\"\");\n  }\n  lines.push(\"## Documents\");\n  for (const doc of result.docs) {\n    const status = doc.exists ? \"available\" : doc.optional ? \"missing (optional)\" : \"missing (required)\";\n    lines.push(`- \\`${doc.path}\\` - ${doc.purpose} (${status})`);\n    if (doc.exists && doc.content_mode !== \"none\" && doc.content) {\n      lines.push(\"\");\n      lines.push(`### Excerpt: \\`${doc.path}\\``);\n      if (doc.truncated) {\n        lines.push(\"_truncated for context efficiency_\");\n      }\n      lines.push(\"```markdown\");\n      lines.push(markdownCodeFence(doc.content));\n      lines.push(\"```\");\n    }\n  }\n  if (result.topic.related.length > 0) {\n    lines.push(\"\", \"## Related topics\");\n    lines.push(...result.topic.related.map((topic) => `- \\`${topic}\\``));\n  }\n  if (result.warnings.length > 0) {\n    lines.push(\"\", \"## Warnings\");\n    lines.push(...result.warnings.map((warning) => `- ${warning}`));\n  }\n  return lines.join(\"\\n\");\n}\n"],"names":[],"mappings":"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","debugId":"8d06806e-bba1-5626-9ff4-b7fda8387582"}

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

@@ -8,7 +8,15 @@ export interface HealthCheck {
 export interface HealthResult {
     ok: boolean;
     checks: HealthCheck[];
+    warning_count?: number;
     warnings: string[];
+    projection?: {
+        mode: "brief" | "summary" | "full";
+        warning_count: number;
+        warnings_truncated: boolean;
+        detail_limit: number;
+        omitted_checks?: HealthCheck["name"][];
+    };
     generated_at: string;
 }
 export interface RunHealthOptions {
@@ -18,6 +26,12 @@ export interface RunHealthOptions {
     noRefresh?: boolean;
     refreshVectors?: boolean;
     verboseStaleItems?: boolean;
+    skipVectors?: boolean;
+    skipIntegrity?: boolean;
+    skipDrift?: boolean;
+    full?: boolean;
+    brief?: boolean;
+    summary?: boolean;
 }
 export declare function runHealth(global: GlobalOptions, options?: RunHealthOptions): Promise<HealthResult>;
 export {};

package/dist/cli/commands/health.js

@@ -1,11 +1,13 @@
+
+!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]="c5b24e35-02f9-5f45-9ef2-e5c850396686")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { pathExists, readFileIfExists } from "../../core/fs/fs-utils.js";
 import { activateExtensions, getActiveExtensionRegistrations, loadExtensions, runActiveOnReadHooks } from "../../core/extensions/index.js";
 import { EXTENSION_CAPABILITY_CONTRACT, KNOWN_EXTENSION_CAPABILITIES, parseLegacyExtensionCapabilityAliasWarning, parseUnknownExtensionCapabilityWarning, } from "../../core/extensions/loader.js";
-import { hashDocument } from "../../core/history/history.js";
 import { enforceHistoryStreamPolicyForItems } from "../../core/history/history-stream-policy.js";
+import { scanHistoryDrift } from "../../core/history/drift-scan.js";
 import { readVectorizationStatusLedger, refreshSemanticEmbeddingsForMutatedItems, } from "../../core/search/cache.js";
 import { resolveEmbeddingProviders } from "../../core/search/providers.js";
 import { resolveSettingsWithSemanticRuntimeDefaults } from "../../core/search/semantic-defaults.js";
@@ -16,11 +18,12 @@ import { PmCliError } from "../../core/shared/errors.js";
 import { toNonEmptyStringOrUndefined } from "../../core/shared/primitives.js";
 import { nowIso } from "../../core/shared/time.js";
 import { parseItemDocument } from "../../core/item/item-format.js";
-import { listAllFrontMatterWithBody } from "../../core/store/item-store.js";
-import { getHistoryPath, getItemFormatFromPath, getSettingsPath, ITEM_FILE_EXTENSIONS, resolveGlobalPmRoot, resolvePmRoot, } from "../../core/store/paths.js";
+import { listAllFrontMatter, listAllFrontMatterWithBody } from "../../core/store/item-store.js";
+import { getItemFormatFromPath, getSettingsPath, ITEM_FILE_EXTENSIONS, resolveGlobalPmRoot, resolvePmRoot, } from "../../core/store/paths.js";
 import { readSettingsWithMetadata } from "../../core/store/settings.js";
 import { readManagedExtensionState } from "./extension.js";
 const STALE_VECTORIZATION_SUMMARY_LIMIT = 25;
+const BRIEF_HEALTH_DETAIL_LIMIT = 8;
 const TELEMETRY_QUEUE_RELATIVE_PATH = path.join("runtime", "telemetry", "events.jsonl");
 const TELEMETRY_STATE_RELATIVE_PATH = path.join("runtime", "telemetry", "state.json");
 const TELEMETRY_ENDPOINT_PROBE_TIMEOUT_MS = 2_500;
@@ -298,15 +301,15 @@ function resolveMigrationFailureReason(definition) {
     return toNonEmptyStringOrUndefined(definition.reason) ?? toNonEmptyStringOrUndefined(definition.error) ?? toNonEmptyStringOrUndefined(definition.message);
 }
 function compareMigrationEntries(left, right) {
-    const byLayer = left.layer.localeCompare(right.layer);
+    const byLayer = (left.layer ?? "").localeCompare(right.layer ?? "");
     if (byLayer !== 0) {
         return byLayer;
     }
-    const byName = left.name.localeCompare(right.name);
+    const byName = (left.name ?? "").localeCompare(right.name ?? "");
     if (byName !== 0) {
         return byName;
     }
-    return left.id.localeCompare(right.id);
+    return (left.id ?? "").localeCompare(right.id ?? "");
 }
 function summarizeMigrationStatuses(migrations) {
     const applied = [];
@@ -547,6 +550,227 @@ function summarizeList(values, limit) {
         truncated: true,
     };
 }
+function summarizeRecordList(value, limit) {
+    if (!Array.isArray(value)) {
+        return {
+            count: 0,
+            sample: [],
+            truncated: false,
+        };
+    }
+    return {
+        count: value.length,
+        sample: value.slice(0, limit),
+        truncated: value.length > limit,
+    };
+}
+function summarizeExtensionRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return {};
+    }
+    const record = value;
+    return {
+        layer: record.layer,
+        directory: record.directory,
+        name: record.name,
+        version: record.version,
+        enabled: record.enabled,
+        status: record.status,
+        has_activate: record.has_activate,
+        capabilities: record.capabilities,
+    };
+}
+function summarizeExtensionList(value, limit) {
+    const summary = summarizeRecordList(value, limit);
+    return {
+        ...summary,
+        sample: summary.sample.map((entry) => summarizeExtensionRecord(entry)),
+    };
+}
+function summarizeStringList(value, limit) {
+    if (!Array.isArray(value)) {
+        return {
+            count: 0,
+            sample: [],
+            truncated: false,
+        };
+    }
+    const strings = value.filter((entry) => typeof entry === "string");
+    return {
+        count: strings.length,
+        sample: strings.slice(0, limit),
+        truncated: strings.length > limit,
+    };
+}
+function summarizeHealthCheckDetails(check, limit) {
+    const details = check.details;
+    if (check.name === "settings") {
+        return {
+            version: details.version,
+            id_prefix: details.id_prefix,
+            locks_ttl_seconds: details.locks_ttl_seconds,
+            warnings: summarizeStringList(details.warnings, limit),
+        };
+    }
+    if (check.name === "directories") {
+        return {
+            required_count: Array.isArray(details.required) ? details.required.length : 0,
+            optional_count: Array.isArray(details.optional) ? details.optional.length : 0,
+            missing_required: summarizeStringList(details.missing_required, limit),
+            missing_optional: summarizeStringList(details.missing_optional, limit),
+            missing: summarizeStringList(details.missing, limit),
+            strict_directories: details.strict_directories,
+        };
+    }
+    if (check.name === "settings_values") {
+        return {
+            warnings: summarizeStringList(details.warnings, limit),
+        };
+    }
+    if (check.name === "telemetry") {
+        return {
+            enabled: details.enabled,
+            capture_level: details.capture_level,
+            endpoint: details.endpoint,
+            queue_exists: details.queue_exists,
+            queue_entries: details.queue_entries,
+            queue_draining: details.queue_draining,
+            queue_invalid_rows: details.queue_invalid_rows,
+            queue_rows_total: details.queue_rows_total,
+            last_successful_flush_at: details.last_successful_flush_at,
+            last_failed_flush_at: details.last_failed_flush_at,
+            endpoint_probe: details.endpoint_probe,
+            env_overrides: details.env_overrides,
+        };
+    }
+    if (check.name === "extensions") {
+        const activation = typeof details.activation === "object" && details.activation !== null ? details.activation : {};
+        return {
+            disabled_by_flag: details.disabled_by_flag,
+            discovered: summarizeExtensionList(details.discovered, limit),
+            effective: summarizeExtensionList(details.effective, limit),
+            loaded: summarizeExtensionList(details.loaded, limit),
+            failed: summarizeRecordList(details.failed, limit),
+            warnings: summarizeStringList(details.warnings, limit),
+            activation: {
+                failed: summarizeRecordList(activation.failed, limit),
+                warnings: summarizeStringList(activation.warnings, limit),
+                hook_counts: activation.hook_counts,
+                command_handler_count: activation.command_handler_count,
+                service_override_count: activation.service_override_count,
+                renderer_override_count: activation.renderer_override_count,
+                registration_counts: activation.registration_counts,
+                migration_status: typeof activation.migration_status === "object" && activation.migration_status !== null
+                    ? {
+                        applied_count: activation.migration_status.applied_count,
+                        pending_count: activation.migration_status.pending_count,
+                        failed_count: activation.migration_status.failed_count,
+                    }
+                    : null,
+            },
+            triage: details.triage,
+            capability_contract: details.capability_contract,
+            capability_guidance: summarizeRecordList(details.capability_guidance, limit),
+        };
+    }
+    if (check.name === "storage") {
+        return details;
+    }
+    if (check.name === "integrity") {
+        return {
+            checked_item_files: details.checked_item_files,
+            checked_history_streams: details.checked_history_streams,
+            counts: details.counts,
+            item_unreadable: summarizeStringList(details.item_unreadable, limit),
+            item_conflict_markers: summarizeRecordList(details.item_conflict_markers, limit),
+            item_parse_failures: summarizeStringList(details.item_parse_failures, limit),
+            history_unreadable: summarizeStringList(details.history_unreadable, limit),
+            history_conflict_markers: summarizeRecordList(details.history_conflict_markers, limit),
+            history_invalid_json: summarizeRecordList(details.history_invalid_json, limit),
+            skipped: details.skipped,
+        };
+    }
+    if (check.name === "history_drift") {
+        return {
+            checked_items: details.checked_items,
+            counts: details.counts,
+            drifted_items: summarizeStringList(details.drifted_items, limit),
+            missing_streams: summarizeStringList(details.missing_streams, limit),
+            unreadable_streams: summarizeStringList(details.unreadable_streams, limit),
+            hash_mismatches: summarizeStringList(details.hash_mismatches, limit),
+            chain_mismatches: summarizeStringList(details.chain_mismatches, limit),
+            skipped: details.skipped,
+        };
+    }
+    if (check.name === "vectorization") {
+        return {
+            semantic_runtime_available: details.semantic_runtime_available,
+            compatibility_mode_auto_defaults: details.compatibility_mode_auto_defaults,
+            auto_ollama_defaults_applied: details.auto_ollama_defaults_applied,
+            refresh_policy: details.refresh_policy,
+            provider_active: details.provider_active,
+            vector_store_active: details.vector_store_active,
+            items: details.items,
+            ledger_entries_before: details.ledger_entries_before,
+            stale_items_before_total: details.stale_items_before_total,
+            stale_items_before: summarizeStringList(details.stale_items_before, limit),
+            refresh_attempted: details.refresh_attempted,
+            refresh_skipped_reason: details.refresh_skipped_reason,
+            refresh_result: details.refresh_result,
+            ledger_entries_after: details.ledger_entries_after,
+            stale_items_after_total: details.stale_items_after_total,
+            stale_items_after: summarizeStringList(details.stale_items_after, limit),
+            skipped: details.skipped,
+        };
+    }
+    return details;
+}
+function applyBriefHealthProjection(result) {
+    const warningsSummary = summarizeStringList(result.warnings, BRIEF_HEALTH_DETAIL_LIMIT);
+    return {
+        ok: result.ok,
+        checks: result.checks.map((check) => ({
+            name: check.name,
+            status: check.status,
+            details: summarizeHealthCheckDetails(check, BRIEF_HEALTH_DETAIL_LIMIT),
+        })),
+        warnings: warningsSummary.sample,
+        projection: {
+            mode: "brief",
+            warning_count: warningsSummary.count,
+            warnings_truncated: warningsSummary.truncated,
+            detail_limit: BRIEF_HEALTH_DETAIL_LIMIT,
+        },
+        generated_at: result.generated_at,
+    };
+}
+function isSkippedHealthCheck(check) {
+    return check.details.skipped === true;
+}
+function applySummaryHealthProjection(result) {
+    const warningsSummary = summarizeStringList(result.warnings, BRIEF_HEALTH_DETAIL_LIMIT);
+    const omittedChecks = result.checks.filter(isSkippedHealthCheck).map((check) => check.name);
+    return {
+        ok: result.ok,
+        checks: result.checks
+            .filter((check) => !isSkippedHealthCheck(check))
+            .map((check) => ({
+            name: check.name,
+            status: check.status,
+            details: {},
+        })),
+        warning_count: warningsSummary.count,
+        warnings: warningsSummary.sample,
+        projection: {
+            mode: "summary",
+            warning_count: warningsSummary.count,
+            warnings_truncated: warningsSummary.truncated,
+            detail_limit: BRIEF_HEALTH_DETAIL_LIMIT,
+            omitted_checks: omittedChecks,
+        },
+        generated_at: result.generated_at,
+    };
+}
 function selectStaleItemDetail(values, verboseStaleItems) {
     if (verboseStaleItems) {
         return {
@@ -729,7 +953,8 @@ async function buildTelemetryCheck(settings, options) {
                     attempted: false,
                 },
                 env_overrides: {
-                    telemetry_disabled: telemetryEnvFlagEnabled("PM_TELEMETRY_DISABLED"),
+                    telemetry_disabled: telemetryEnvFlagEnabled("PM_TELEMETRY_DISABLED") || telemetryEnvFlagEnabled("PM_NO_TELEMETRY"),
+                    pm_no_telemetry: telemetryEnvFlagEnabled("PM_NO_TELEMETRY"),
                     telemetry_otel_disabled: telemetryEnvFlagEnabled("PM_TELEMETRY_OTEL_DISABLED"),
                 },
             },
@@ -738,58 +963,12 @@ async function buildTelemetryCheck(settings, options) {
     };
 }
 async function buildHistoryDriftCheck(pmRoot, items) {
-    const missingStreams = [];
-    const unreadableStreams = [];
-    const hashMismatches = [];
-    for (const item of items) {
-        const historyPath = getHistoryPath(pmRoot, item.id);
-        let latestAfterHash = null;
-        try {
-            const raw = await fs.readFile(historyPath, "utf8");
-            if (raw.trim().length === 0) {
-                missingStreams.push(item.id);
-                continue;
-            }
-            const lines = raw.split(/\r?\n/);
-            for (const line of lines) {
-                const trimmed = line.trim();
-                if (trimmed.length === 0) {
-                    continue;
-                }
-                const parsed = JSON.parse(trimmed);
-                if (typeof parsed.after_hash !== "string" || parsed.after_hash.trim().length === 0) {
-                    throw new Error("missing after_hash");
-                }
-                latestAfterHash = parsed.after_hash;
-            }
-        }
-        catch (error) {
-            if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
-                missingStreams.push(item.id);
-            }
-            else {
-                unreadableStreams.push(item.id);
-            }
-            continue;
-        }
-        if (!latestAfterHash) {
-            missingStreams.push(item.id);
-            continue;
-        }
-        const { body, ...frontMatter } = item;
-        const currentHash = hashDocument({
-            metadata: frontMatter,
-            body,
-        });
-        if (latestAfterHash !== currentHash) {
-            hashMismatches.push(item.id);
-        }
-    }
-    const driftedItems = [...new Set([...missingStreams, ...unreadableStreams, ...hashMismatches])].sort((a, b) => a.localeCompare(b));
+    const { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems } = await scanHistoryDrift(pmRoot, items);
     const warnings = [
         ...missingStreams.map((id) => `history_drift_missing_stream:${id}`),
         ...unreadableStreams.map((id) => `history_drift_unreadable_stream:${id}`),
         ...hashMismatches.map((id) => `history_drift_hash_mismatch:${id}`),
+        ...chainMismatches.map((id) => `history_drift_chain_mismatch:${id}`),
     ];
     return {
         check: {
@@ -803,10 +982,12 @@ async function buildHistoryDriftCheck(pmRoot, items) {
                     missing_streams: missingStreams.length,
                     unreadable_streams: unreadableStreams.length,
                     hash_mismatches: hashMismatches.length,
+                    chain_mismatches: chainMismatches.length,
                 },
                 missing_streams: missingStreams,
                 unreadable_streams: unreadableStreams,
                 hash_mismatches: hashMismatches,
+                chain_mismatches: chainMismatches,
             },
         },
         warnings,
@@ -960,19 +1141,35 @@ export async function runHealth(global, options = {}) {
         checkTelemetry: options.checkTelemetry === true,
     });
     const extensionCheck = await buildExtensionCheck(pmRoot, settings, Boolean(global.noExtensions));
+    const summaryMode = options.summary === true && options.full !== true;
+    const fastProjectionCheckOnly = options.checkOnly === true && (options.brief === true || options.summary === true) && options.full !== true;
+    const skipIntegrity = (options.skipIntegrity === true || fastProjectionCheckOnly) && options.full !== true;
+    const skipDrift = (options.skipDrift === true || fastProjectionCheckOnly) && options.full !== true;
+    const skipVectors = (options.skipVectors === true || fastProjectionCheckOnly) && options.full !== true;
     const itemReadWarnings = [];
-    const items = await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, itemReadWarnings, settings.schema);
+    const items = skipDrift && skipVectors
+        ? await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, itemReadWarnings, settings.schema)
+        : await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, itemReadWarnings, settings.schema);
+    const itemsWithBody = items;
     const normalizedItemReadWarnings = [...new Set(itemReadWarnings)];
-    const historyPolicy = await enforceHistoryStreamPolicyForItems({
-        pmRoot,
-        settings,
-        itemIds: items.map((item) => item.id),
-        commandLabel: "health",
-    });
+    const historyPolicy = skipDrift
+        ? { warnings: [] }
+        : await enforceHistoryStreamPolicyForItems({
+            pmRoot,
+            settings,
+            itemIds: items.map((item) => item.id),
+            commandLabel: "health",
+        });
     const historySummary = await countHistoryStreams(pmRoot);
-    const integrityCheck = await buildIntegrityCheck(pmRoot, typeRegistry.type_to_folder, settings.schema);
-    const historyDriftCheck = await buildHistoryDriftCheck(pmRoot, items);
-    const vectorizationCheck = await buildVectorizationCheck(pmRoot, settings, items, refreshPolicy, options.verboseStaleItems === true);
+    const integrityCheck = skipIntegrity
+        ? { check: { name: "integrity", status: "ok", details: { skipped: true } }, warnings: [] }
+        : await buildIntegrityCheck(pmRoot, typeRegistry.type_to_folder, settings.schema);
+    const historyDriftCheck = skipDrift
+        ? { check: { name: "history_drift", status: "ok", details: { skipped: true } }, warnings: [] }
+        : await buildHistoryDriftCheck(pmRoot, itemsWithBody);
+    const vectorizationCheck = skipVectors
+        ? { check: { name: "vectorization", status: "ok", details: { skipped: true } }, warnings: [] }
+        : await buildVectorizationCheck(pmRoot, settings, itemsWithBody, refreshPolicy, options.verboseStaleItems === true);
     const checks = [
         {
             name: "settings",
@@ -1033,11 +1230,16 @@ export async function runHealth(global, options = {}) {
         ...hookWarnings,
     ];
     const normalizedWarnings = [...new Set(warnings)];
-    return {
+    const result = {
         ok: normalizedWarnings.length === 0,
         checks,
         warnings: normalizedWarnings,
         generated_at: nowIso(),
     };
+    if (summaryMode) {
+        return applySummaryHealthProjection(result);
+    }
+    return options.brief === true ? applyBriefHealthProjection(result) : result;
 }
-//# sourceMappingURL=health.js.map
+//# sourceMappingURL=health.js.map
+//# debugId=c5b24e35-02f9-5f45-9ef2-e5c850396686