@unbrained/pm-cli 2026.6.9 → 2026.6.11

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

@@ -35,6 +35,10 @@ export interface ContextFocusItem {
     assignee: string | null;
     tags: string[];
     updated_at: string;
+    parent: string | null;
+    children_total?: number;
+    children_closed?: number;
+    completion_pct?: number;
 }
 export interface HierarchyChild {
     id: string;
@@ -94,6 +98,9 @@ export interface StaleEntry {
     updated_at: string;
     stale_days: number;
 }
+export interface RecentContextItem extends ContextFocusItem {
+    created_at?: string;
+}
 export interface TestHealthSummary {
     items_with_tests: number;
     items_with_recent_runs: number;
@@ -160,6 +167,8 @@ export interface ContextResult {
     activity?: CompactActivityEntry[];
     progress?: ProgressEntry[];
     blockers?: BlockerEntry[];
+    recently_created?: RecentContextItem[];
+    unparented?: ContextFocusItem[];
     files?: HotFile[];
     workload?: WorkloadEntry[];
     staleness?: StaleEntry[];

package/dist/cli/commands/context.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]="d5f50a52-85aa-5e3d-b803-9c1500b4320c")}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]="6714cb01-5f6a-50da-9cf6-8d60a33a390a")}catch(e){}}();
 import { SETTINGS_DEFAULTS, EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { compareTimestampStrings } from "../../core/shared/time.js";
@@ -21,7 +21,7 @@ export const CONTEXT_OUTPUT_VALUES = ["markdown", "toon", "json"];
 // ---------------------------------------------------------------------------
 const HIGH_LEVEL_TYPES = new Set(["Epic", "Feature"]);
 const DEFAULT_CONTEXT_LIMIT = 10;
-const STANDARD_SECTIONS = ["hierarchy", "activity", "progress", "workload"];
+const STANDARD_SECTIONS = ["hierarchy", "activity", "progress", "recently_created", "unparented", "workload"];
 const DEEP_SECTIONS = [
     ...STANDARD_SECTIONS,
     "blockers",
@@ -29,6 +29,10 @@ const DEEP_SECTIONS = [
     "staleness",
     "tests",
 ];
+const LEADING_HYPHEN_DATE = /^(\d{4})-(\d{2})-(\d{2})/;
+const LEADING_COMPACT_DATE = /^(\d{4})(\d{2})(\d{2})(?:[T ]?\d{2}|$)/;
+const COMPACT_DATE = /^(\d{4})(\d{2})(\d{2})$/;
+const COMPACT_DATETIME = /^(\d{4})(\d{2})(\d{2})(?:[T\s]?)(\d{2})(\d{2})(\d{2})?(Z|[+-]\d{2}:?\d{2})?$/i;
 // ---------------------------------------------------------------------------
 // Parsers
 // ---------------------------------------------------------------------------
@@ -176,6 +180,59 @@ function compareOptionalDeadline(left, right) {
         return -1;
     return compareTimestampStrings(leftValue, rightValue);
 }
+function daysInUtcMonth(year, monthIndex) {
+    return new Date(Date.UTC(year, monthIndex + 1, 0)).getUTCDate();
+}
+function hasNoInvalidDatePrefix(value) {
+    const match = LEADING_HYPHEN_DATE.exec(value) ?? LEADING_COMPACT_DATE.exec(value);
+    if (!match) {
+        return true;
+    }
+    const year = Number.parseInt(match[1], 10);
+    const month = Number.parseInt(match[2], 10);
+    const day = Number.parseInt(match[3], 10);
+    return month >= 1 && month <= 12 && day >= 1 && day <= daysInUtcMonth(year, month - 1);
+}
+function normalizeTimestampCandidate(value) {
+    const compactDate = COMPACT_DATE.exec(value);
+    if (compactDate) {
+        return `${compactDate[1]}-${compactDate[2]}-${compactDate[3]}`;
+    }
+    const compactDateTime = COMPACT_DATETIME.exec(value);
+    if (compactDateTime) {
+        const [, year, month, day, hour, minute, secondRaw, offsetRaw] = compactDateTime;
+        const second = secondRaw ? `:${secondRaw}` : "";
+        const offset = offsetRaw && offsetRaw.length === 5 && offsetRaw !== "Z" ? `${offsetRaw.slice(0, 3)}:${offsetRaw.slice(3)}` : offsetRaw ?? "";
+        return `${year}-${month}-${day}T${hour}:${minute}${second}${offset}`;
+    }
+    return value;
+}
+function parseContextTimestampMs(value) {
+    if (typeof value !== "string") {
+        return Number.NaN;
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0 || !hasNoInvalidDatePrefix(trimmed)) {
+        return Number.NaN;
+    }
+    const parsed = Date.parse(normalizeTimestampCandidate(trimmed));
+    return Number.isFinite(parsed) ? parsed : Number.NaN;
+}
+function sortableTimestamp(value) {
+    const parsed = parseContextTimestampMs(value);
+    return Number.isFinite(parsed) ? new Date(parsed).toISOString() : "";
+}
+function dateTokenForTimestamp(value) {
+    const parsed = parseContextTimestampMs(value);
+    return Number.isFinite(parsed) ? new Date(parsed).toISOString().slice(0, 10) : "unknown";
+}
+function normalizedParentId(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
 function compareCriticalItems(left, right, statusRegistry) {
     const byStatus = statusRank(left.status, statusRegistry) - statusRank(right.status, statusRegistry);
     if (byStatus !== 0)
@@ -189,12 +246,27 @@ function compareCriticalItems(left, right, statusRegistry) {
     const byDeadline = compareOptionalDeadline(left.deadline, right.deadline);
     if (byDeadline !== 0)
         return byDeadline;
-    const byUpdated = compareTimestampStrings(right.updated_at, left.updated_at);
+    const byUpdated = compareTimestampStrings(sortableTimestamp(right.updated_at), sortableTimestamp(left.updated_at));
     const byId = left.id.localeCompare(right.id);
     return byUpdated !== 0 ? byUpdated : byId;
 }
-function toContextFocusItem(item) {
-    return {
+function completionPct(closed, total) {
+    return total > 0 ? Math.round((closed / total) * 100) : 0;
+}
+function buildChildrenByParent(allItems) {
+    const childrenByParent = new Map();
+    for (const item of allItems) {
+        const parent = normalizedParentId(item.parent);
+        if (!parent)
+            continue;
+        const children = childrenByParent.get(parent) ?? [];
+        children.push(item);
+        childrenByParent.set(parent, children);
+    }
+    return childrenByParent;
+}
+function toContextFocusItem(item, statusRegistry, childrenByParent) {
+    const focus = {
         id: item.id,
         title: item.title,
         type: item.type,
@@ -205,7 +277,19 @@ function toContextFocusItem(item) {
         assignee: item.assignee ?? null,
         tags: Array.isArray(item.tags) ? [...item.tags] : [],
         updated_at: item.updated_at,
+        parent: normalizedParentId(item.parent),
     };
+    if (statusRegistry && childrenByParent) {
+        const descendants = collectDescendants(item.id, childrenByParent);
+        const total = descendants.length;
+        if (total > 0) {
+            const closed = descendants.filter((desc) => isClosedStatus(desc.status, statusRegistry)).length;
+            focus.children_total = total;
+            focus.children_closed = closed;
+            focus.completion_pct = completionPct(closed, total);
+        }
+    }
+    return focus;
 }
 function summarizeAgenda(events) {
     let deadlines = 0;
@@ -243,14 +327,7 @@ function buildHierarchy(allItems, activeItems, statusRegistry, limit) {
     for (const item of allItems) {
         itemMap.set(item.id, item);
     }
-    const childrenByParent = new Map();
-    for (const item of allItems) {
-        if (!item.parent)
-            continue;
-        const children = childrenByParent.get(item.parent) ?? [];
-        children.push(item);
-        childrenByParent.set(item.parent, children);
-    }
+    const childrenByParent = buildChildrenByParent(allItems);
     const activeHighLevelIds = new Set(activeItems.filter((item) => HIGH_LEVEL_TYPES.has(item.type)).map((item) => item.id));
     const nodes = [];
     for (const parentId of activeHighLevelIds) {
@@ -369,7 +446,7 @@ function buildProgress(allItems, activeItems, statusRegistry, limit) {
             open,
             in_progress: inProgress,
             blocked,
-            completion_pct: total > 0 ? Math.round((closed / total) * 100) : 0,
+            completion_pct: completionPct(closed, total),
         });
     }
     return entries
@@ -440,6 +517,26 @@ function buildStaleness(allNonTerminal, staleThresholdDays, now, limit) {
         .sort((a, b) => b.stale_days - a.stale_days)
         .slice(0, limit);
 }
+function buildRecentlyCreated(allNonTerminal, statusRegistry, childrenByParent, limit) {
+    return allNonTerminal
+        .map((item) => ({ item, sortKey: sortableTimestamp(item.created_at) }))
+        .sort((left, right) => {
+        const byCreated = compareTimestampStrings(right.sortKey, left.sortKey);
+        return byCreated !== 0 ? byCreated : left.item.id.localeCompare(right.item.id);
+    })
+        .slice(0, limit)
+        .map(({ item }) => ({
+        ...toContextFocusItem(item, statusRegistry, childrenByParent),
+        created_at: item.created_at,
+    }));
+}
+function buildUnparented(allNonTerminal, statusRegistry, childrenByParent, limit) {
+    return allNonTerminal
+        .filter((item) => !normalizedParentId(item.parent) && !HIGH_LEVEL_TYPES.has(item.type))
+        .sort((left, right) => compareCriticalItems(left, right, statusRegistry))
+        .slice(0, limit)
+        .map((item) => toContextFocusItem(item, statusRegistry, childrenByParent));
+}
 function buildTestHealth(activeItems) {
     let itemsWithTests = 0;
     let itemsWithRecentRuns = 0;
@@ -484,7 +581,11 @@ function formatClock(timestamp) {
 function formatFocusLine(item) {
     const orderToken = item.order === null ? "-" : String(item.order);
     const deadlineToken = item.deadline ?? "-";
-    return `${item.id} p${item.priority} ${item.status} ${item.type} order:${orderToken} deadline:${deadlineToken} ${item.title}`;
+    const parentToken = item.parent ? ` parent:${item.parent}` : "";
+    const progressToken = item.children_total !== undefined && item.children_closed !== undefined && item.completion_pct !== undefined
+        ? ` children:${item.children_closed}/${item.children_total} done:${item.completion_pct}%`
+        : "";
+    return `${item.id} p${item.priority} ${item.status} ${item.type} order:${orderToken} deadline:${deadlineToken}${parentToken}${progressToken} ${item.title}`;
 }
 function formatAgendaLine(event) {
     const base = `${formatClock(event.at)} [${event.kind}] ${event.item_id} p${event.item_priority} ${event.item_status} ${event.item_title}`;
@@ -571,6 +672,20 @@ export function renderContextMarkdown(result) {
         }
         lines.push("");
     }
+    if (result.recently_created && result.recently_created.length > 0) {
+        lines.push("## Recently created");
+        for (const item of result.recently_created) {
+            lines.push(`- ${dateTokenForTimestamp(item.created_at)} ${formatFocusLine(item)}`);
+        }
+        lines.push("");
+    }
+    if (result.unparented && result.unparented.length > 0) {
+        lines.push("## Unparented");
+        for (const item of result.unparented) {
+            lines.push(`- ${formatFocusLine(item)}`);
+        }
+        lines.push("");
+    }
     if (result.activity && result.activity.length > 0) {
         lines.push("## Recent activity");
         for (const entry of result.activity) {
@@ -647,7 +762,7 @@ export async function runContext(options, global) {
     const sectionsIncluded = parseContextSections(options.section, depth, contextSettings);
     const activityLimit = parseActivityLimit(options.activityLimit, contextSettings);
     const staleThresholdDays = parseStaleThresholdDays(options.staleThreshold, contextSettings);
-    const needsAllItems = sectionsIncluded.some((s) => ["hierarchy", "progress", "blockers", "staleness"].includes(s));
+    const needsAllItems = sectionsIncluded.some((s) => ["hierarchy", "progress", "blockers", "staleness", "recently_created", "unparented"].includes(s));
     const baseListOptions = stripListProjectionFlags(options);
     const listOptions = { ...baseListOptions, excludeTerminal: true };
     const listed = await runList(undefined, listOptions, global);
@@ -665,16 +780,20 @@ export async function runContext(options, global) {
     const blockedStatuses = statusRegistry.blocked_statuses;
     const activeItems = ranked.filter((item) => activeStatuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
     const blockedItems = ranked.filter((item) => blockedStatuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
+    const childrenByParent = buildChildrenByParent(allItems);
+    const focusChildrenByParent = needsAllItems ? childrenByParent : undefined;
     const highLevel = activeItems
         .filter((item) => HIGH_LEVEL_TYPES.has(item.type))
         .slice(0, limit)
-        .map(toContextFocusItem);
+        .map((item) => toContextFocusItem(item, statusRegistry, focusChildrenByParent));
     const lowLevel = activeItems
         .filter((item) => !HIGH_LEVEL_TYPES.has(item.type))
         .slice(0, limit)
-        .map(toContextFocusItem);
+        .map((item) => toContextFocusItem(item, statusRegistry, focusChildrenByParent));
     const blockedFallbackUsed = activeItems.length === 0;
-    const blockedFallback = blockedFallbackUsed ? blockedItems.slice(0, limit).map(toContextFocusItem) : [];
+    const blockedFallback = blockedFallbackUsed
+        ? blockedItems.slice(0, limit).map((item) => toContextFocusItem(item, statusRegistry, focusChildrenByParent))
+        : [];
     const calendarOptions = {
         ...baseListOptions,
         view: "agenda",
@@ -702,6 +821,12 @@ export async function runContext(options, global) {
     const activity = has("activity") ? await buildActivity(activityLimit, global) : undefined;
     const progress = has("progress") ? buildProgress(allItems, activeItems, statusRegistry, limit) : undefined;
     const blockersSection = has("blockers") ? buildBlockers(blockedItems, itemMap, limit) : undefined;
+    const recentlyCreated = has("recently_created")
+        ? buildRecentlyCreated(allNonTerminal, statusRegistry, childrenByParent, limit)
+        : undefined;
+    const unparented = has("unparented")
+        ? buildUnparented(allNonTerminal, statusRegistry, childrenByParent, limit)
+        : undefined;
     const filesSection = has("files") ? buildHotFiles(activeItems, limit) : undefined;
     const workload = has("workload") ? buildWorkload(activeItems, statusRegistry, limit) : undefined;
     const staleness = has("staleness") ? buildStaleness(allNonTerminal, staleThresholdDays, now, limit) : undefined;
@@ -767,6 +892,10 @@ export async function runContext(options, global) {
         result.progress = progress;
     if (blockersSection)
         result.blockers = blockersSection;
+    if (recentlyCreated)
+        result.recently_created = recentlyCreated;
+    if (unparented)
+        result.unparented = unparented;
     if (filesSection)
         result.files = filesSection;
     if (workload)
@@ -788,4 +917,4 @@ export async function runContext(options, global) {
     return result;
 }
 //# sourceMappingURL=context.js.map
-//# debugId=d5f50a52-85aa-5e3d-b803-9c1500b4320c
+//# debugId=6714cb01-5f6a-50da-9cf6-8d60a33a390a