@unbrained/pm-cli 2026.7.14 → 2026.7.15

package/dist/cli-bundle/chunks/{chunk-ILLUE5DI.js → chunk-HYB5AZ63.js}

@@ -1,6 +1,6 @@
 import {
   collectStaleVectorizationIds
-} from "./chunk-LWTIRS3Y.js";
+} from "./chunk-E2OJMKML.js";
 import {
   buildListQueryFilters
 } from "./chunk-KWYX6ZIR.js";
@@ -9,33 +9,38 @@ import {
   buildContentFilterEcho,
   buildGovernanceMissingFilterEcho,
   collectRuntimeFilterValues,
-  createQueryFingerprint,
   hasContentFieldFilter,
   itemMatchesContentFilters,
   matchesRuntimeFilters,
-  paginateQueryRows,
+  parseIntegerLimit,
+  parsePriority,
   parseStatusFilterCsv,
+  parseType,
   resolveContentFieldFilters,
   resolveMissingMetadataFilters,
   runList
-} from "./chunk-6MHSBDGD.js";
+} from "./chunk-XXXF6PAQ.js";
+import {
+  createQueryFingerprint,
+  paginateQueryRows
+} from "./chunk-4223PVZT.js";
+import {
+  getItemAt
+} from "./chunk-3U7ZR6M4.js";
 import {
   hasMissingMetadataFilter,
   itemMatchesMissingMetadata,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-W6HZ55JO.js";
+} from "./chunk-IJIICKVW.js";
 import {
-  parseIntegerLimit,
-  parsePriority,
-  parseType,
   readHistoryEntries
-} from "./chunk-4WREH7RT.js";
+} from "./chunk-TD3LVC7D.js";
 import {
   parseLimit
-} from "./chunk-YQYG2V23.js";
+} from "./chunk-NU3IMIEA.js";
 import {
   recordContextUsageTouches
-} from "./chunk-Y72FV7RM.js";
+} from "./chunk-YCQET3OT.js";
 import {
   resolveRegisteredSearchProvider,
   resolveRegisteredVectorStoreAdapter
@@ -52,7 +57,7 @@ import {
   resolveSearchCorpusFields,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-ZUKSZVBW.js";
+} from "./chunk-7B67ZL4N.js";
 import {
   splitCommaList
 } from "./chunk-D6HZN36B.js";
@@ -74,11 +79,12 @@ import {
   resolveIsoOrRelative,
   runActiveOnReadHooks,
   toItemRecord
-} from "./chunk-T4BRCB6Z.js";
+} from "./chunk-XSJUSQAE.js";
 import {
   EXIT_CODE,
   ITEM_METADATA_KEY_ORDER,
   PmCliError,
+  TYPE_TO_FOLDER,
   coerceNumberInRange,
   coercePositiveInteger,
   collectRegisteredItemFieldNames,
@@ -94,7 +100,7 @@ import {
   resolveRuntimeStatusRegistry,
   toNonEmptyString,
   toNonEmptyStringOrUndefined
-} from "./chunk-AFWZRL7M.js";
+} from "./chunk-BSEQUTQP.js";
 
 // dist/cli/commands/aggregate.js
 !(function() {
@@ -3010,16 +3016,115 @@ async function runEval(options, global2) {
   };
 }
 
+// dist/sdk/item-children.js
+!(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] = "f87417b5-010c-5fed-9b38-782ac4bd7b3b");
+  } catch (e2) {
+  }
+})();
+var MAX_CHILD_PROJECTION_ITEMS = 1e6;
+var DEFAULT_CHILD_SAMPLE_LIMIT = 20;
+function buildItemChildrenRollup(parentId, corpus, statusRegistry, sampleLimit = DEFAULT_CHILD_SAMPLE_LIMIT) {
+  if (!Number.isSafeInteger(sampleLimit) || sampleLimit < 0) {
+    throw new PmCliError("Child projection sample limit must be a non-negative integer.", EXIT_CODE.USAGE);
+  }
+  const normalizedParentId = parentId.trim().toLowerCase();
+  const byStatus = {};
+  const children = [];
+  let active = 0;
+  let scanned = 0;
+  for (const candidate of corpus) {
+    scanned += 1;
+    if (scanned > MAX_CHILD_PROJECTION_ITEMS) {
+      throw new PmCliError(`Child projection exceeded the ${MAX_CHILD_PROJECTION_ITEMS.toLocaleString("en-US")} item safety bound.`, EXIT_CODE.GENERIC_FAILURE, {
+        code: "child_projection_item_bound_exceeded",
+        required: "Use an indexed or parent-filtered metadata source.",
+        why: "Unbounded graph scans can exhaust memory in universal project stores.",
+        nextSteps: ["Build the derived item index, then retry the parent read."]
+      });
+    }
+    if (candidate.parent?.trim().toLowerCase() !== normalizedParentId) {
+      continue;
+    }
+    children.push(candidate);
+    const status = candidate.status.trim().toLowerCase();
+    byStatus[status] = (byStatus[status] ?? 0) + 1;
+    if (!isTerminalStatus(status, statusRegistry)) {
+      active += 1;
+    }
+  }
+  children.sort((left, right) => left.id.localeCompare(right.id));
+  const sample = children.slice(0, sampleLimit).map((child) => ({
+    id: child.id,
+    title: child.title,
+    type: child.type,
+    status: child.status,
+    priority: child.priority
+  }));
+  const truncated = children.length > sample.length;
+  return {
+    count: children.length,
+    active,
+    by_status: Object.fromEntries(Object.entries(byStatus).sort(([left], [right]) => left.localeCompare(right))),
+    sample,
+    sample_limit: sampleLimit,
+    truncated,
+    next_offset: truncated ? sample.length : null,
+    continuation: truncated ? `pm list --status all --parent ${parentId} --offset ${sample.length} --limit ${sampleLimit}` : null,
+    scanned
+  };
+}
+
+// dist/sdk/item-schedule.js
+!(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] = "35561e52-7bf5-5bb2-b899-c0b0dbe88c8a");
+  } catch (e2) {
+  }
+})();
+var BUILTIN_SCHEDULE_TYPES = /* @__PURE__ */ new Set(["event", "meeting", "reminder"]);
+function itemHasSchedule(item) {
+  return BUILTIN_SCHEDULE_TYPES.has(item.type.trim().toLowerCase()) || item.deadline !== void 0 || (item.reminders?.length ?? 0) > 0 || (item.events?.length ?? 0) > 0;
+}
+function buildItemSchedule(item) {
+  if (!itemHasSchedule(item)) {
+    return void 0;
+  }
+  const events = [...item.events ?? []].sort((left, right) => left.start_at.localeCompare(right.start_at));
+  const primary = events[0];
+  return {
+    deadline: item.deadline ?? null,
+    start_at: primary?.start_at ?? null,
+    end_at: primary?.end_at ?? null,
+    location: primary?.location ?? null,
+    reminders: [...item.reminders ?? []],
+    events
+  };
+}
+
 // dist/cli/commands/get.js
 !(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] = "233ec299-06cd-50e0-8ff5-bfbd40fe8bb2");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "423ea45e-3b11-5fdb-9b46-1c1ebf27a6c9");
   } catch (e2) {
   }
 })();
-var CHILD_ROLLUP_TYPES = /* @__PURE__ */ new Set(["milestone", "epic"]);
 var GET_DEPTH_VALUES = ["brief", "standard", "deep"];
+var AUTOMATIC_CHILD_ROLLUP_TYPES = /* @__PURE__ */ new Set([
+  "epic",
+  "feature",
+  "milestone",
+  "plan"
+]);
+var BUILTIN_ITEM_TYPES = new Set(Object.keys(TYPE_TO_FOLDER).map((type) => type.toLowerCase()));
+function shouldAutoIncludeGetChildren(itemType) {
+  const normalizedType = itemType.trim().toLowerCase();
+  return normalizedType.length > 0 && (AUTOMATIC_CHILD_ROLLUP_TYPES.has(normalizedType) || !BUILTIN_ITEM_TYPES.has(normalizedType));
+}
 function toClaimHistoryContext(entry) {
   return {
     ts: entry.ts,
@@ -3084,7 +3189,8 @@ function validateGetFields(fields, runtimeMetadataKeys) {
     "body",
     "linked",
     "claim_state",
-    "children"
+    "children",
+    "schedule"
   ]);
   const allowedLinkedFields = /* @__PURE__ */ new Set([
     "linked.files",
@@ -3097,9 +3203,17 @@ function validateGetFields(fields, runtimeMetadataKeys) {
     "claim_state.last_claim",
     "claim_state.last_release"
   ]);
+  const allowedScheduleFields = /* @__PURE__ */ new Set([
+    "schedule.deadline",
+    "schedule.start_at",
+    "schedule.end_at",
+    "schedule.location",
+    "schedule.reminders",
+    "schedule.events"
+  ]);
   const unknown = fields.filter((field) => {
     const normalized = normalizeGetField(field);
-    return !itemFields.has(normalized) && !allowedRootFields.has(normalized) && !allowedLinkedFields.has(normalized) && !allowedClaimStateFields.has(normalized);
+    return !itemFields.has(normalized) && !allowedRootFields.has(normalized) && !allowedLinkedFields.has(normalized) && !allowedClaimStateFields.has(normalized) && !allowedScheduleFields.has(normalized);
   });
   if (unknown.length > 0) {
     throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(", ")}`, EXIT_CODE.USAGE, {
@@ -3116,8 +3230,8 @@ function projectItemForFields(item, fields) {
   const source = toItemRecord(item);
   const projected = {};
   for (const field of fields) {
-    const normalized = field.startsWith("item.") ? field.slice("item.".length) : field;
-    if (normalized === "body" || normalized === "linked" || normalized.startsWith("linked.")) {
+    const normalized = normalizeGetField(field);
+    if (normalized === "body" || normalized === "linked" || normalized.startsWith("linked.") || normalized === "claim_state" || normalized.startsWith("claim_state.") || normalized === "children" || normalized.startsWith("children.") || normalized === "schedule" || normalized.startsWith("schedule.")) {
       continue;
     }
     projected[normalized] = source[normalized];
@@ -3128,7 +3242,10 @@ function fieldsInclude(fields, name) {
   return fields?.some((field) => field === name || field === `item.${name}`) ?? false;
 }
 function fieldsIncludeRoot(fields, name) {
-  return fields.some((field) => field === name || field.startsWith(`${name}.`));
+  return fields.some((field) => {
+    const normalized = normalizeGetField(field);
+    return normalized === name || normalized.startsWith(`${name}.`);
+  });
 }
 function resolveGetProjection(options) {
   if (options.full && (options.fields !== void 0 || options.depth !== void 0)) {
@@ -3137,6 +3254,9 @@ function resolveGetProjection(options) {
   if (options.tree !== true && options.treeDepth !== void 0) {
     throw new PmCliError("Get --tree-depth requires --tree", EXIT_CODE.USAGE);
   }
+  if (options.at !== void 0 && options.tree === true) {
+    throw new PmCliError("Get --at cannot be combined with --tree because workspace-level historical projections are not yet indexed.", EXIT_CODE.USAGE);
+  }
   return {
     depth: options.full ? "deep" : parseGetDepth(options.depth),
     treeDepth: options.tree === true ? parseIntegerLimit(options.treeDepth, "--tree-depth") : void 0,
@@ -3144,13 +3264,25 @@ function resolveGetProjection(options) {
     fieldProjection: options.fields !== void 0
   };
 }
-async function loadGetItemContext(id, global2) {
+async function loadGetItemContext(id, global2, at) {
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
     throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
   }
   const settings = await readSettings(pmRoot);
   const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+  if (at !== void 0) {
+    const historical = await getItemAt(id, at, { pmRoot: global2.path });
+    return {
+      pmRoot,
+      settings,
+      typeToFolder: typeRegistry.type_to_folder,
+      locatedId: historical.document.metadata.id,
+      metadata: historical.document.metadata,
+      body: historical.document.body,
+      historical
+    };
+  }
   const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
   if (!located) {
     throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeRegistry.type_to_folder);
@@ -3165,21 +3297,21 @@ async function loadGetItemContext(id, global2) {
     body: loaded.document.body
   };
 }
-function validateGetProjectionFields(fields, settings) {
+function validateGetProjectionFields(fields, settings, historical) {
   const runtimeMetadataKeys = resolveRuntimeFieldRegistry(settings.schema).definitions.map((field) => field.metadata_key);
   validateGetFields(fields, runtimeMetadataKeys);
+  if (historical && fieldsIncludeRoot(fields ?? [], "children")) {
+    throw new PmCliError("Get --at cannot project children because workspace-level historical relationships are not yet indexed.", EXIT_CODE.USAGE);
+  }
 }
 function shouldIncludeGetField(params) {
-  const { fieldProjection, depth, fields, field, itemType } = params;
+  const { fieldProjection, depth, fields, field } = params;
   if (fieldProjection) {
     if (field === "body" || field === "linked") {
       return fieldsInclude(fields, field);
     }
     return fieldsIncludeRoot(fields, field);
   }
-  if (field === "children") {
-    return depth !== "brief" && CHILD_ROLLUP_TYPES.has(itemType);
-  }
   return depth !== "brief";
 }
 async function resolveGetClaimState(context, includeClaimState) {
@@ -3188,7 +3320,7 @@ async function resolveGetClaimState(context, includeClaimState) {
   }
   const historyPath = getHistoryPath(context.pmRoot, context.locatedId);
   const history = await readHistoryEntries(historyPath, context.locatedId);
-  return resolveClaimStateContext(context.metadata.assignee, history);
+  return resolveClaimStateContext(context.metadata.assignee, context.historical ? history.slice(0, context.historical.as_of_version) : history);
 }
 function attachGetLinked(result, context, fields, includeLinked) {
   const includeLinkedFiles = includeLinked || fieldsInclude(fields, "linked.files");
@@ -3203,28 +3335,28 @@ function attachGetLinked(result, context, fields, includeLinked) {
     docs: includeLinkedDocs ? context.metadata.docs ?? [] : []
   };
 }
-async function buildGetChildrenRollup(context, includeChildren) {
+async function buildGetChildrenRollup(context, includeChildren, includeEmpty) {
   if (!includeChildren) {
     return void 0;
   }
   const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);
   const corpus = await listAllItemMetadataLight(context.pmRoot, context.settings.item_format, context.typeToFolder, void 0, context.settings.schema);
-  const byStatus = {};
-  let active = 0;
-  let count = 0;
-  const locatedId = context.locatedId.trim().toLowerCase();
-  for (const candidate of corpus) {
-    const parentId = typeof candidate.parent === "string" ? candidate.parent.trim().toLowerCase() : "";
-    if (parentId !== locatedId)
-      continue;
-    const candidateStatus = candidate.status.trim().toLowerCase();
-    count += 1;
-    byStatus[candidateStatus] = (byStatus[candidateStatus] ?? 0) + 1;
-    if (!isTerminalStatus(candidateStatus, statusRegistry)) {
-      active += 1;
-    }
+  const rollup = buildItemChildrenRollup(context.locatedId, corpus, statusRegistry);
+  return rollup.count > 0 || includeEmpty ? rollup : void 0;
+}
+function attachGetSchedule(result, context, fields, includeSchedule) {
+  if (!includeSchedule) {
+    return;
+  }
+  const schedule = buildItemSchedule(context.metadata);
+  if (!schedule) {
+    return;
+  }
+  if (fields === null || fieldsInclude(fields, "schedule")) {
+    result.schedule = schedule;
+    return;
   }
-  return { count, active, by_status: byStatus };
+  result.schedule = Object.fromEntries(Object.entries(schedule).filter(([key]) => fields.some((field) => normalizeGetField(field) === `schedule.${key}`)));
 }
 async function buildGetTree(context, options, treeDepth, global2) {
   if (options.tree !== true) {
@@ -3246,8 +3378,8 @@ async function buildGetTree(context, options, treeDepth, global2) {
 }
 async function runGet(id, global2, options = {}) {
   const projection = resolveGetProjection(options);
-  const context = await loadGetItemContext(id, global2);
-  validateGetProjectionFields(projection.fields, context.settings);
+  const context = await loadGetItemContext(id, global2, options.at);
+  validateGetProjectionFields(projection.fields, context.settings, context.historical !== void 0);
   const includeBody = shouldIncludeGetField({ ...projection, field: "body" });
   const includeLinked = shouldIncludeGetField({
     ...projection,
@@ -3257,12 +3389,8 @@ async function runGet(id, global2, options = {}) {
     ...projection,
     field: "claim_state"
   });
-  const itemType = context.metadata.type.trim().toLowerCase();
-  const includeChildren = shouldIncludeGetField({
-    ...projection,
-    field: "children",
-    itemType
-  });
+  const includeChildren = context.historical === void 0 && (projection.fieldProjection ? fieldsIncludeRoot(projection.fields, "children") : projection.depth !== "brief" && shouldAutoIncludeGetChildren(context.metadata.type));
+  const includeSchedule = projection.fieldProjection ? fieldsIncludeRoot(projection.fields, "schedule") : projection.depth !== "brief";
   const claimState = await resolveGetClaimState(context, includeClaimState);
   const result = {
     item: projection.fieldProjection ? projectItemForFields(context.metadata, projection.fields) : projectItemForDepth(context.metadata, projection.depth)
@@ -3274,16 +3402,24 @@ async function runGet(id, global2, options = {}) {
   if (claimState) {
     result.claim_state = claimState;
   }
-  result.children = await buildGetChildrenRollup(context, includeChildren);
+  attachGetSchedule(result, context, projection.fields, includeSchedule);
+  result.children = await buildGetChildrenRollup(context, includeChildren, projection.fieldProjection);
   result.tree = await buildGetTree(context, options, projection.treeDepth, global2);
-  try {
-    await recordContextUsageTouches({
-      pmRoot: context.pmRoot,
-      author: (process.env.PM_AUTHOR ?? context.settings.author_default).trim() || "unknown",
-      itemIds: [context.locatedId],
-      intent: "get"
-    });
-  } catch {
+  if (context.historical) {
+    result.reconstructed = true;
+    result.as_of_version = context.historical.as_of_version;
+    result.as_of_timestamp = context.historical.as_of_timestamp;
+  }
+  if (context.historical === void 0) {
+    try {
+      await recordContextUsageTouches({
+        pmRoot: context.pmRoot,
+        author: (process.env.PM_AUTHOR ?? context.settings.author_default).trim() || "unknown",
+        itemIds: [context.locatedId],
+        intent: "get"
+      });
+    } catch {
+    }
   }
   return result;
 }
@@ -3292,6 +3428,11 @@ export {
   runAggregate,
   runSearch,
   runEval,
+  MAX_CHILD_PROJECTION_ITEMS,
+  DEFAULT_CHILD_SAMPLE_LIMIT,
+  buildItemChildrenRollup,
+  itemHasSchedule,
+  buildItemSchedule,
   runGet
 };
-//# sourceMappingURL=chunk-ILLUE5DI.js.map
+//# sourceMappingURL=chunk-HYB5AZ63.js.map