@markmdev/pebble 0.1.9 → 0.1.11

package/dist/cli/index.js

@@ -492,7 +492,24 @@ function getOpenBlockers(issueId) {
   return issue.blockedBy.map((id) => state.get(id)).filter((i) => i !== void 0 && i.status !== "closed");
 }
 
+// src/shared/time.ts
+import { formatDistanceToNow, parseISO } from "date-fns";
+function formatRelativeTime(isoString) {
+  try {
+    const date = parseISO(isoString);
+    return formatDistanceToNow(date, { addSuffix: true });
+  } catch {
+    return isoString;
+  }
+}
+
 // src/cli/lib/output.ts
+function formatLimitMessage(info) {
+  if (!info.limited) return "";
+  return `
+---
+Showing ${info.shown} of ${info.total} issues. Use --all or --limit <n> to see more.`;
+}
 function formatJson(data) {
   return JSON.stringify(data, null, 2);
 }
@@ -529,8 +546,10 @@ function formatIssueDetailPretty(issue, ctx) {
   }
   if (ctx.children.length > 0) {
     const closedChildren = ctx.children.filter((c) => c.status === "closed");
+    const pendingChildren = ctx.children.filter((c) => c.status === "pending_verification");
+    const pendingStr = pendingChildren.length > 0 ? ` (${pendingChildren.length} pending verification)` : "";
     lines.push("");
-    lines.push(`Children (${closedChildren.length}/${ctx.children.length} done):`);
+    lines.push(`Children (${closedChildren.length}/${ctx.children.length} done${pendingStr}):`);
     for (const child of ctx.children) {
       const statusIcon = child.status === "closed" ? "\u2713" : child.status === "in_progress" ? "\u25B6" : "\u25CB";
       lines.push(`  ${statusIcon} ${child.id} - ${child.title} [${child.status}]`);
@@ -671,11 +690,94 @@ function outputMutationSuccess(id, pretty) {
     console.log(JSON.stringify({ id, success: true }));
   }
 }
-function outputIssueList(issues, pretty) {
+function outputIssueList(issues, pretty, limitInfo) {
   if (pretty) {
     console.log(formatIssueListPretty(issues));
+    if (limitInfo?.limited) {
+      console.log(formatLimitMessage(limitInfo));
+    }
+  } else {
+    if (limitInfo?.limited) {
+      console.log(formatJson({ issues, _meta: limitInfo }));
+    } else {
+      console.log(formatJson(issues));
+    }
+  }
+}
+function buildIssueTree(issues) {
+  const issueMap = /* @__PURE__ */ new Map();
+  for (const issue of issues) {
+    issueMap.set(issue.id, issue);
+  }
+  const childIds = /* @__PURE__ */ new Set();
+  for (const issue of issues) {
+    if (issue.parent && issueMap.has(issue.parent)) {
+      childIds.add(issue.id);
+    }
+  }
+  const buildNode = (issue) => {
+    const children = issues.filter((i) => i.parent === issue.id).map(buildNode);
+    return {
+      id: issue.id,
+      title: issue.title,
+      type: issue.type,
+      priority: issue.priority,
+      status: issue.status,
+      createdAt: issue.createdAt,
+      childrenCount: children.length,
+      ...children.length > 0 && { children }
+    };
+  };
+  const roots = issues.filter((i) => !childIds.has(i.id));
+  return roots.map(buildNode);
+}
+function formatIssueTreePretty(nodes, sectionHeader) {
+  if (nodes.length === 0) {
+    return "No issues found.";
+  }
+  const lines = [];
+  if (sectionHeader) {
+    lines.push(`## ${sectionHeader}`);
+    lines.push("");
+  }
+  const countAll = (node) => {
+    const children = node.children ?? [];
+    return 1 + children.reduce((sum, child) => sum + countAll(child), 0);
+  };
+  const totalCount = nodes.reduce((sum, node) => sum + countAll(node), 0);
+  const formatNode = (node, prefix, isLast, isRoot) => {
+    const connector = isRoot ? "" : isLast ? "\u2514\u2500 " : "\u251C\u2500 ";
+    const statusIcon = node.status === "closed" ? "\u2713" : node.status === "in_progress" ? "\u25B6" : node.status === "pending_verification" ? "\u23F3" : "\u25CB";
+    const statusText = STATUS_LABELS[node.status].toLowerCase();
+    const relativeTime = formatRelativeTime(node.createdAt);
+    lines.push(`${prefix}${connector}${statusIcon} ${node.id}: ${node.title} [${node.type}] P${node.priority} ${statusText} ${relativeTime}`);
+    const children = node.children ?? [];
+    const childPrefix = isRoot ? "" : prefix + (isLast ? "   " : "\u2502  ");
+    children.forEach((child, index) => {
+      const childIsLast = index === children.length - 1;
+      formatNode(child, childPrefix, childIsLast, false);
+    });
+  };
+  nodes.forEach((node, index) => {
+    formatNode(node, "", index === nodes.length - 1, true);
+  });
+  lines.push("");
+  lines.push(`Total: ${totalCount} issue(s)`);
+  return lines.join("\n");
+}
+function outputIssueTree(issues, pretty, sectionHeader, limitInfo) {
+  const tree = buildIssueTree(issues);
+  if (pretty) {
+    console.log(formatIssueTreePretty(tree, sectionHeader));
+    if (limitInfo?.limited) {
+      console.log(formatLimitMessage(limitInfo));
+    }
   } else {
-    console.log(formatJson(issues));
+    if (limitInfo?.limited) {
+      console.log(formatJson({ issues: tree, _meta: limitInfo }));
+    } else {
+      console.log(formatJson(tree));
+    }
   }
 }
 function outputError(error, pretty) {
@@ -686,42 +788,55 @@ function outputError(error, pretty) {
   }
   process.exit(1);
 }
-function formatIssueListVerbose(issues) {
+function formatIssueListVerbose(issues, sectionHeader) {
   if (issues.length === 0) {
     return "No issues found.";
   }
   const lines = [];
+  if (sectionHeader) {
+    lines.push(`## ${sectionHeader} (${issues.length})`);
+    lines.push("");
+  }
   for (const info of issues) {
-    const { issue, blocking, children, verifications, blockers } = info;
-    lines.push(`${issue.id} - ${issue.title}`);
-    lines.push("\u2500".repeat(60));
-    lines.push(`  Type:          ${formatType(issue.type)}`);
-    lines.push(`  Priority:      P${issue.priority}`);
-    lines.push(`  Status:        ${issue.status}`);
-    lines.push(`  Parent:        ${issue.parent || "-"}`);
-    lines.push(`  Children:      ${issue.type === "epic" ? children : "-"}`);
-    lines.push(`  Blocking:      ${blocking.length > 0 ? blocking.join(", ") : "[]"}`);
-    lines.push(`  Verifications: ${verifications}`);
+    const { issue, blocking, children, verifications, blockers, parent } = info;
+    lines.push(`${issue.id}: ${issue.title}`);
+    lines.push(`  Type: ${formatType(issue.type)} | Priority: P${issue.priority} | Created: ${formatRelativeTime(issue.createdAt)}`);
+    if (parent) {
+      lines.push(`  Epic: ${parent.id} (${parent.title})`);
+    }
+    if (blocking.length > 0) {
+      lines.push(`  Blocking: ${blocking.join(", ")}`);
+    }
     if (blockers && blockers.length > 0) {
-      lines.push(`  Blocked by:    ${blockers.join(", ")}`);
+      lines.push(`  Blocked by: ${blockers.join(", ")}`);
+    }
+    if (issue.type === "epic" && children > 0) {
+      lines.push(`  Children: ${children} | Verifications: ${verifications}`);
     }
     lines.push("");
   }
-  lines.push(`Total: ${issues.length} issue(s)`);
   return lines.join("\n");
 }
-function outputIssueListVerbose(issues, pretty) {
+function outputIssueListVerbose(issues, pretty, sectionHeader, limitInfo) {
   if (pretty) {
-    console.log(formatIssueListVerbose(issues));
+    console.log(formatIssueListVerbose(issues, sectionHeader));
+    if (limitInfo?.limited) {
+      console.log(formatLimitMessage(limitInfo));
+    }
   } else {
-    const output = issues.map(({ issue, blocking, children, verifications, blockers }) => ({
+    const output = issues.map(({ issue, blocking, children, verifications, blockers, parent }) => ({
       ...issue,
       blocking,
       childrenCount: issue.type === "epic" ? children : void 0,
       verificationsCount: verifications,
-      ...blockers && { openBlockers: blockers }
+      ...blockers && { openBlockers: blockers },
+      ...parent && { parentInfo: parent }
     }));
-    console.log(formatJson(output));
+    if (limitInfo?.limited) {
+      console.log(formatJson({ issues: output, _meta: limitInfo }));
+    } else {
+      console.log(formatJson(output));
+    }
   }
 }
 
@@ -1043,6 +1158,8 @@ Pending verifications:`);
               for (const v of result.pendingVerifications || []) {
                 console.log(`  \u2022 ${v.id} - ${v.title}`);
               }
+              console.log(`
+Run: pb verifications ${result.id}`);
             } else {
               console.log(`\u2713 ${result.id}`);
               if (result.unblocked && result.unblocked.length > 0) {
@@ -1059,6 +1176,7 @@ Unblocked:`);
               success: true,
               status: result.status,
               ...result.pendingVerifications && { pendingVerifications: result.pendingVerifications },
+              ...result.pendingVerifications && { hint: `pb verifications ${result.id}` },
               ...result.unblocked && { unblocked: result.unblocked }
             }));
           }
@@ -1074,6 +1192,7 @@ Unblocked:`);
                 for (const v of result.pendingVerifications || []) {
                   console.log(`  \u2022 ${v.id} - ${v.title}`);
                 }
+                console.log(`  Run: pb verifications ${result.id}`);
               } else {
                 console.log(`\u2713 ${result.id}`);
                 if (result.unblocked && result.unblocked.length > 0) {
@@ -1093,6 +1212,7 @@ Unblocked:`);
             status: r.status,
             ...r.error && { error: r.error },
             ...r.pendingVerifications && { pendingVerifications: r.pendingVerifications },
+            ...r.pendingVerifications && { hint: `pb verifications ${r.id}` },
             ...r.unblocked && { unblocked: r.unblocked }
           }))));
         }
@@ -1212,7 +1332,7 @@ function claimCommand(program2) {
 
 // src/cli/commands/list.ts
 function listCommand(program2) {
-  program2.command("list").description("List issues").option("--status <status>", "Filter by status").option("-t, --type <type>", "Filter by type").option("--priority <priority>", "Filter by priority").option("--parent <id>", "Filter by parent epic").action(async (options) => {
+  program2.command("list").description("List issues").option("--status <status>", "Filter by status").option("-t, --type <type>", "Filter by type").option("--priority <priority>", "Filter by priority").option("--parent <id>", "Filter by parent epic").option("-v, --verbose", "Show expanded details (parent, children, blocking, verifications)").option("--flat", "Show flat list instead of hierarchical tree").option("--limit <n>", "Max issues to return (default: 30)").option("--all", "Show all issues (no limit)").action(async (options) => {
     const pretty = program2.opts().pretty ?? false;
     try {
       getOrCreatePebbleDir();
@@ -1241,8 +1361,48 @@ function listCommand(program2) {
       if (options.parent !== void 0) {
         filters.parent = resolveId(options.parent);
       }
-      const issues = getIssues(filters);
-      outputIssueList(issues, pretty);
+      let issues = getIssues(filters);
+      issues.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+      const total = issues.length;
+      const limit = options.all ? 0 : options.limit ? parseInt(options.limit, 10) : 30;
+      if (limit > 0 && issues.length > limit) {
+        issues = issues.slice(0, limit);
+      }
+      const limitInfo = {
+        total,
+        shown: issues.length,
+        limited: limit > 0 && total > limit
+      };
+      if (options.verbose) {
+        const verboseIssues = issues.map((issue) => {
+          const info = {
+            issue,
+            blocking: getBlocking(issue.id).map((i) => i.id),
+            children: getChildren(issue.id).length,
+            verifications: getVerifications(issue.id).length
+          };
+          if (issue.parent) {
+            const parentIssue = getIssue(issue.parent);
+            if (parentIssue) {
+              info.parent = { id: parentIssue.id, title: parentIssue.title };
+            }
+          }
+          return info;
+        });
+        let sectionHeader = "Issues";
+        if (filters.status) {
+          sectionHeader = `${STATUS_LABELS[filters.status]} Issues`;
+        }
+        outputIssueListVerbose(verboseIssues, pretty, sectionHeader, limitInfo);
+      } else if (options.flat) {
+        outputIssueList(issues, pretty, limitInfo);
+      } else {
+        let sectionHeader = "Issues";
+        if (filters.status) {
+          sectionHeader = `${STATUS_LABELS[filters.status]} Issues`;
+        }
+        outputIssueTree(issues, pretty, sectionHeader, limitInfo);
+      }
     } catch (error) {
       outputError(error, pretty);
     }
@@ -1273,21 +1433,48 @@ function showCommand(program2) {
 
 // src/cli/commands/ready.ts
 function readyCommand(program2) {
-  program2.command("ready").description("Show issues ready for work (no open blockers)").option("-v, --verbose", "Show expanded details (parent, children, blocking, verifications)").action(async (options) => {
+  program2.command("ready").description("Show issues ready for work (no open blockers)").option("-v, --verbose", "Show expanded details (parent, children, blocking, verifications)").option("-t, --type <type>", "Filter by type: task, bug, epic, verification").option("--limit <n>", "Max issues to return (default: 30)").option("--all", "Show all issues (no limit)").action(async (options) => {
     const pretty = program2.opts().pretty ?? false;
     try {
       getOrCreatePebbleDir();
-      const issues = getReady();
+      let issues = getReady();
+      if (options.type) {
+        const typeFilter = options.type.toLowerCase();
+        if (!ISSUE_TYPES.includes(typeFilter)) {
+          throw new Error(`Invalid type: ${options.type}. Must be one of: ${ISSUE_TYPES.join(", ")}`);
+        }
+        issues = issues.filter((i) => i.type === typeFilter);
+      }
+      issues.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+      const total = issues.length;
+      const limit = options.all ? 0 : options.limit ? parseInt(options.limit, 10) : 30;
+      if (limit > 0 && issues.length > limit) {
+        issues = issues.slice(0, limit);
+      }
+      const limitInfo = {
+        total,
+        shown: issues.length,
+        limited: limit > 0 && total > limit
+      };
       if (options.verbose) {
-        const verboseIssues = issues.map((issue) => ({
-          issue,
-          blocking: getBlocking(issue.id).map((i) => i.id),
-          children: getChildren(issue.id).length,
-          verifications: getVerifications(issue.id).length
-        }));
-        outputIssueListVerbose(verboseIssues, pretty);
+        const verboseIssues = issues.map((issue) => {
+          const info = {
+            issue,
+            blocking: getBlocking(issue.id).map((i) => i.id),
+            children: getChildren(issue.id).length,
+            verifications: getVerifications(issue.id).length
+          };
+          if (issue.parent) {
+            const parentIssue = getIssue(issue.parent);
+            if (parentIssue) {
+              info.parent = { id: parentIssue.id, title: parentIssue.title };
+            }
+          }
+          return info;
+        });
+        outputIssueListVerbose(verboseIssues, pretty, "Ready Issues", limitInfo);
       } else {
-        outputIssueList(issues, pretty);
+        outputIssueList(issues, pretty, limitInfo);
       }
     } catch (error) {
       outputError(error, pretty);
@@ -1297,26 +1484,44 @@ function readyCommand(program2) {
 
 // src/cli/commands/blocked.ts
 function blockedCommand(program2) {
-  program2.command("blocked").description("Show blocked issues (have open blockers)").option("-v, --verbose", "Show expanded details including WHY each issue is blocked").action(async (options) => {
+  program2.command("blocked").description("Show blocked issues (have open blockers)").option("-v, --verbose", "Show expanded details including WHY each issue is blocked").option("--limit <n>", "Max issues to return (default: 30)").option("--all", "Show all issues (no limit)").action(async (options) => {
     const pretty = program2.opts().pretty ?? false;
     try {
       getOrCreatePebbleDir();
-      const issues = getBlocked();
+      let issues = getBlocked();
+      issues.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+      const total = issues.length;
+      const limit = options.all ? 0 : options.limit ? parseInt(options.limit, 10) : 30;
+      if (limit > 0 && issues.length > limit) {
+        issues = issues.slice(0, limit);
+      }
+      const limitInfo = {
+        total,
+        shown: issues.length,
+        limited: limit > 0 && total > limit
+      };
       if (options.verbose) {
         const verboseIssues = issues.map((issue) => {
           const allBlockers = getBlockers(issue.id);
           const openBlockers = allBlockers.filter((b) => b.status !== "closed").map((b) => b.id);
-          return {
+          const info = {
             issue,
             blocking: getBlocking(issue.id).map((i) => i.id),
             children: getChildren(issue.id).length,
             verifications: getVerifications(issue.id).length,
             blockers: openBlockers
           };
+          if (issue.parent) {
+            const parentIssue = getIssue(issue.parent);
+            if (parentIssue) {
+              info.parent = { id: parentIssue.id, title: parentIssue.title };
+            }
+          }
+          return info;
         });
-        outputIssueListVerbose(verboseIssues, pretty);
+        outputIssueListVerbose(verboseIssues, pretty, "Blocked Issues", limitInfo);
       } else {
-        outputIssueList(issues, pretty);
+        outputIssueList(issues, pretty, limitInfo);
       }
     } catch (error) {
       outputError(error, pretty);
@@ -1327,39 +1532,55 @@ function blockedCommand(program2) {
 // src/cli/commands/dep.ts
 function depCommand(program2) {
   const dep = program2.command("dep").description("Manage dependencies");
-  dep.command("add <id> <blockerId>").description("Add a blocking dependency").action(async (id, blockerId) => {
+  dep.command("add <id> [blockerId]").description("Add a blocking dependency. Use --needs or --blocks for self-documenting syntax.").option("--needs <id>", "Issue that must be completed first (first arg needs this)").option("--blocks <id>", "Issue that this blocks (first arg blocks this)").action(async (id, blockerId, options) => {
     const pretty = program2.opts().pretty ?? false;
     try {
+      if (options.needs && options.blocks) {
+        throw new Error("Cannot use both --needs and --blocks");
+      }
+      if (blockerId && (options.needs || options.blocks)) {
+        throw new Error("Cannot combine positional blockerId with --needs or --blocks");
+      }
+      if (!blockerId && !options.needs && !options.blocks) {
+        throw new Error("Must provide blockerId, --needs <id>, or --blocks <id>");
+      }
       const pebbleDir = getOrCreatePebbleDir();
-      const resolvedId = resolveId(id);
-      const resolvedBlockerId = resolveId(blockerId);
-      const issue = getIssue(resolvedId);
+      let blockedId;
+      let blockerIdResolved;
+      if (options.blocks) {
+        blockedId = resolveId(options.blocks);
+        blockerIdResolved = resolveId(id);
+      } else {
+        blockedId = resolveId(id);
+        blockerIdResolved = resolveId(options.needs || blockerId);
+      }
+      const issue = getIssue(blockedId);
       if (!issue) {
-        throw new Error(`Issue not found: ${id}`);
+        throw new Error(`Issue not found: ${blockedId}`);
       }
-      const blocker = getIssue(resolvedBlockerId);
+      const blocker = getIssue(blockerIdResolved);
       if (!blocker) {
-        throw new Error(`Blocker issue not found: ${blockerId}`);
+        throw new Error(`Blocker issue not found: ${blockerIdResolved}`);
       }
-      if (resolvedId === resolvedBlockerId) {
+      if (blockedId === blockerIdResolved) {
         throw new Error("Cannot add self as blocker");
       }
-      if (issue.blockedBy.includes(resolvedBlockerId)) {
-        throw new Error(`Dependency already exists: ${resolvedId} is blocked by ${resolvedBlockerId}`);
+      if (issue.blockedBy.includes(blockerIdResolved)) {
+        throw new Error(`Dependency already exists: ${blockedId} is blocked by ${blockerIdResolved}`);
       }
-      if (detectCycle(resolvedId, resolvedBlockerId)) {
+      if (detectCycle(blockedId, blockerIdResolved)) {
         throw new Error(`Adding this dependency would create a cycle`);
       }
       const event = {
         type: "update",
-        issueId: resolvedId,
+        issueId: blockedId,
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         data: {
-          blockedBy: [...issue.blockedBy, resolvedBlockerId]
+          blockedBy: [...issue.blockedBy, blockerIdResolved]
         }
       };
       appendEvent(event, pebbleDir);
-      outputMutationSuccess(resolvedId, pretty);
+      outputMutationSuccess(blockedId, pretty);
     } catch (error) {
       outputError(error, pretty);
     }
@@ -1510,7 +1731,7 @@ function depCommand(program2) {
       outputError(error, pretty);
     }
   });
-  dep.command("tree <id>").description("Show dependency tree").action(async (id) => {
+  dep.command("tree <id>").description("Show issue tree (children, verifications, and full hierarchy)").action(async (id) => {
     const pretty = program2.opts().pretty ?? false;
     try {
       const resolvedId = resolveId(id);
@@ -1520,10 +1741,9 @@ function depCommand(program2) {
       }
       const events = readEvents();
       const state = computeState(events);
-      const visited = /* @__PURE__ */ new Set();
-      const tree = buildDepTree(resolvedId, visited, 0, state);
+      const tree = buildIssueTree2(resolvedId, state);
       if (pretty) {
-        console.log(formatDepTree(tree));
+        console.log(formatIssueTreePretty2(tree));
       } else {
         console.log(formatJson(tree));
       }
@@ -1532,50 +1752,94 @@ function depCommand(program2) {
     }
   });
 }
-function buildDepTree(issueId, visited, depth, state) {
-  if (visited.has(issueId)) {
-    return null;
-  }
-  visited.add(issueId);
+function buildIssueTree2(issueId, state) {
   const issue = state.get(issueId);
   if (!issue) {
     return null;
   }
-  const blockedBy = [];
-  for (const blockerId of issue.blockedBy) {
-    const child = buildDepTree(blockerId, visited, depth + 1, state);
-    if (child) {
-      blockedBy.push(child);
+  const buildChildren = (id, visited2) => {
+    const children = [];
+    for (const [, i] of state) {
+      if ((i.parent === id || i.verifies === id) && !visited2.has(i.id)) {
+        visited2.add(i.id);
+        const nodeChildren = buildChildren(i.id, visited2);
+        children.push({
+          id: i.id,
+          title: i.title,
+          type: i.type,
+          priority: i.priority,
+          status: i.status,
+          isTarget: i.id === issueId,
+          childrenCount: nodeChildren.length,
+          ...nodeChildren.length > 0 && { children: nodeChildren }
+        });
+      }
     }
-  }
-  return {
+    return children;
+  };
+  const visited = /* @__PURE__ */ new Set([issueId]);
+  const targetChildren = buildChildren(issueId, visited);
+  const targetNode = {
     id: issue.id,
     title: issue.title,
+    type: issue.type,
+    priority: issue.priority,
     status: issue.status,
-    depth,
-    blockedBy
+    isTarget: true,
+    childrenCount: targetChildren.length,
+    ...targetChildren.length > 0 && { children: targetChildren }
   };
+  let currentNode = targetNode;
+  let currentIssue = issue;
+  while (currentIssue.parent) {
+    const parentIssue = state.get(currentIssue.parent);
+    if (!parentIssue) break;
+    const siblings = [];
+    for (const [, i] of state) {
+      if ((i.parent === parentIssue.id || i.verifies === parentIssue.id) && i.id !== currentIssue.id) {
+        siblings.push({
+          id: i.id,
+          title: i.title,
+          type: i.type,
+          priority: i.priority,
+          status: i.status,
+          childrenCount: 0
+        });
+      }
+    }
+    const parentNodeChildren = [currentNode, ...siblings];
+    const parentNode = {
+      id: parentIssue.id,
+      title: parentIssue.title,
+      type: parentIssue.type,
+      priority: parentIssue.priority,
+      status: parentIssue.status,
+      childrenCount: parentNodeChildren.length,
+      children: parentNodeChildren
+    };
+    currentNode = parentNode;
+    currentIssue = parentIssue;
+  }
+  return currentNode;
 }
-function formatDepTree(node, prefix = "", isRoot = true) {
+function formatIssueTreePretty2(node) {
   if (!node) {
-    return "";
+    return "Issue not found.";
   }
   const lines = [];
-  const statusIcon = node.status === "closed" ? "\u2713" : "\u25CB";
-  if (isRoot) {
-    lines.push(`${statusIcon} ${node.id} - ${node.title}`);
-  }
-  for (let i = 0; i < node.blockedBy.length; i++) {
-    const child = node.blockedBy[i];
-    const isLast = i === node.blockedBy.length - 1;
-    const connector = isLast ? "\u2514\u2500 " : "\u251C\u2500 ";
-    const childPrefix = prefix + (isLast ? "   " : "\u2502  ");
-    const childStatusIcon = child.status === "closed" ? "\u2713" : "\u25CB";
-    lines.push(`${prefix}${connector}${childStatusIcon} ${child.id} - ${child.title}`);
-    if (child.blockedBy.length > 0) {
-      lines.push(formatDepTree(child, childPrefix, false));
-    }
-  }
+  const formatNode = (n, prefix, isLast, isRoot) => {
+    const connector = isRoot ? "" : isLast ? "\u2514\u2500 " : "\u251C\u2500 ";
+    const statusIcon = n.status === "closed" ? "\u2713" : n.status === "in_progress" ? "\u25B6" : n.status === "pending_verification" ? "\u23F3" : "\u25CB";
+    const marker = n.isTarget ? " \u25C0" : "";
+    lines.push(`${prefix}${connector}${statusIcon} ${n.id}: ${n.title} [${n.type}] P${n.priority}${marker}`);
+    const children = n.children ?? [];
+    const childPrefix = isRoot ? "" : prefix + (isLast ? "   " : "\u2502  ");
+    children.forEach((child, index) => {
+      const childIsLast = index === children.length - 1;
+      formatNode(child, childPrefix, childIsLast, false);
+    });
+  };
+  formatNode(node, "", true, true);
   return lines.join("\n");
 }
 
@@ -2935,61 +3199,67 @@ function countChildren(epicId) {
   return {
     total: children.length,
     done: children.filter((c) => c.status === "closed").length,
+    pending_verification: children.filter((c) => c.status === "pending_verification").length,
     in_progress: children.filter((c) => c.status === "in_progress").length,
     open: children.filter((c) => c.status === "open").length,
     blocked: children.filter((c) => c.status === "blocked").length
   };
 }
-function formatSummaryPretty(summaries) {
+function countVerifications(epicId) {
+  const children = getChildren(epicId);
+  let total = 0;
+  let done = 0;
+  for (const child of children) {
+    const verifications = getVerifications(child.id);
+    total += verifications.length;
+    done += verifications.filter((v) => v.status === "closed").length;
+  }
+  return { total, done };
+}
+function formatSummaryPretty(summaries, sectionHeader) {
   if (summaries.length === 0) {
     return "No epics found.";
   }
   const lines = [];
+  lines.push(`## ${sectionHeader} (${summaries.length})`);
+  lines.push("");
   for (const summary of summaries) {
-    const { children } = summary;
-    const progress = children.total > 0 ? `(${children.done}/${children.total} done)` : "(no children)";
-    lines.push(`${summary.id} ${summary.title} ${progress}`);
+    const { children, verifications } = summary;
+    lines.push(`${summary.id}: ${summary.title}`);
+    lines.push(`  Created: ${formatRelativeTime(summary.createdAt)} | Updated: ${formatRelativeTime(summary.updatedAt)}`);
+    const pendingStr = children.pending_verification > 0 ? ` (${children.pending_verification} pending verification)` : "";
+    const issueCount = `Issues: ${children.done}/${children.total} done${pendingStr}`;
+    const verifCount = `Verifications: ${verifications.done}/${verifications.total} done`;
+    lines.push(`  ${issueCount} | ${verifCount}`);
     if (summary.parent) {
-      lines.push(`    Parent: ${summary.parent.id} "${summary.parent.title}"`);
+      lines.push(`  Parent: ${summary.parent.id} (${summary.parent.title})`);
     }
     if (summary.description) {
-      const desc = summary.description.split("\n")[0];
-      const truncated = desc.length > 60 ? desc.slice(0, 57) + "..." : desc;
-      lines.push(`    ${truncated}`);
+      lines.push("");
+      lines.push(`  ${summary.description}`);
     }
+    lines.push("");
+    lines.push(`  Run \`pb list --parent ${summary.id}\` to see all issues.`);
+    lines.push("");
   }
   return lines.join("\n");
 }
 function summaryCommand(program2) {
-  program2.command("summary").description("Show epic summary with child completion status").option("--status <status>", "Filter epics by status (default: open)").option("--limit <n>", "Max epics to return", "10").option("--include-closed", "Include closed epics").action(async (options) => {
+  program2.command("summary").description("Show epic summary with child completion status").option("--status <status>", "Filter epics by specific status").option("--limit <n>", "Max epics to return per section", "10").action(async (options) => {
     const pretty = program2.opts().pretty ?? false;
     try {
       getOrCreatePebbleDir();
-      let epics = getIssues({ type: "epic" });
-      if (options.includeClosed) {
-      } else if (options.status !== void 0) {
-        const status = options.status;
-        if (!STATUSES.includes(status)) {
-          throw new Error(`Invalid status: ${status}. Must be one of: ${STATUSES.join(", ")}`);
-        }
-        epics = epics.filter((e) => e.status === status);
-      } else {
-        epics = epics.filter((e) => e.status !== "closed");
-      }
-      epics.sort(
-        (a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime()
-      );
-      const limit = parseInt(options.limit, 10);
-      if (limit > 0) {
-        epics = epics.slice(0, limit);
-      }
-      const summaries = epics.map((epic) => {
+      const allEpics = getIssues({ type: "epic" });
+      const buildSummary = (epic) => {
         const summary = {
           id: epic.id,
           title: epic.title,
           description: epic.description,
           status: epic.status,
-          children: countChildren(epic.id)
+          createdAt: epic.createdAt,
+          updatedAt: epic.updatedAt,
+          children: countChildren(epic.id),
+          verifications: countVerifications(epic.id)
         };
         if (epic.parent) {
           const parentIssue = getIssue(epic.parent);
@@ -3001,11 +3271,58 @@ function summaryCommand(program2) {
           }
         }
         return summary;
-      });
+      };
+      const limit = parseInt(options.limit, 10);
+      if (options.status !== void 0) {
+        const status = options.status;
+        if (!STATUSES.includes(status)) {
+          throw new Error(`Invalid status: ${status}. Must be one of: ${STATUSES.join(", ")}`);
+        }
+        let epics = allEpics.filter((e) => e.status === status);
+        epics.sort(
+          (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+        );
+        if (limit > 0) {
+          epics = epics.slice(0, limit);
+        }
+        const summaries = epics.map(buildSummary);
+        if (pretty) {
+          console.log(formatSummaryPretty(summaries, `${STATUS_LABELS[status]} Epics`));
+        } else {
+          console.log(formatJson(summaries));
+        }
+        return;
+      }
+      const openEpics = allEpics.filter((e) => e.status !== "closed");
+      const seventyTwoHoursAgo = Date.now() - 72 * 60 * 60 * 1e3;
+      const closedEpics = allEpics.filter(
+        (e) => e.status === "closed" && new Date(e.updatedAt).getTime() > seventyTwoHoursAgo
+      );
+      openEpics.sort(
+        (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+      );
+      closedEpics.sort(
+        (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+      );
+      const limitedOpen = limit > 0 ? openEpics.slice(0, limit) : openEpics;
+      const limitedClosed = limit > 0 ? closedEpics.slice(0, limit) : closedEpics;
+      const openSummaries = limitedOpen.map(buildSummary);
+      const closedSummaries = limitedClosed.map(buildSummary);
       if (pretty) {
-        console.log(formatSummaryPretty(summaries));
+        const output = [];
+        if (openSummaries.length > 0) {
+          output.push(formatSummaryPretty(openSummaries, "Open Epics"));
+        }
+        if (closedSummaries.length > 0) {
+          if (output.length > 0) output.push("");
+          output.push(formatSummaryPretty(closedSummaries, "Recently Closed Epics (last 72h)"));
+        }
+        if (output.length === 0) {
+          output.push("No epics found.");
+        }
+        console.log(output.join("\n"));
       } else {
-        console.log(formatJson(summaries));
+        console.log(formatJson({ open: openSummaries, closed: closedSummaries }));
       }
     } catch (error) {
       outputError(error, pretty);
@@ -3029,7 +3346,7 @@ function parseDuration(duration) {
   };
   return value * multipliers[unit];
 }
-function formatRelativeTime(timestamp) {
+function formatRelativeTime2(timestamp) {
   const now = Date.now();
   const then = new Date(timestamp).getTime();
   const diff = now - then;
@@ -3048,7 +3365,7 @@ function formatHistoryPretty(entries) {
   }
   const lines = [];
   for (const entry of entries) {
-    const time = formatRelativeTime(entry.timestamp);
+    const time = formatRelativeTime2(entry.timestamp);
     const eventLabel = entry.event.charAt(0).toUpperCase() + entry.event.slice(1);
     let line = `[${time}] ${eventLabel} ${entry.issue.id} "${entry.issue.title}" (${entry.issue.type})`;
     if (entry.parent) {
@@ -3173,7 +3490,7 @@ function searchCommand(program2) {
         const bInTitle = b.title.toLowerCase().includes(lowerQuery);
         if (aInTitle && !bInTitle) return -1;
         if (!aInTitle && bInTitle) return 1;
-        return new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime();
+        return new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime();
       });
       const limit = parseInt(options.limit, 10);
       if (limit > 0) {
@@ -3188,7 +3505,7 @@ function searchCommand(program2) {
 
 // src/cli/commands/verifications.ts
 function verificationsCommand(program2) {
-  program2.command("verifications <id>").description("List verification issues for a given issue").action(async (id) => {
+  program2.command("verifications <id>").description("List verification issues for a given issue").option("--limit <n>", "Max verifications to return (default: 30)").option("--all", "Show all verifications (no limit)").action(async (id, options) => {
     const pretty = program2.opts().pretty ?? false;
     try {
       getOrCreatePebbleDir();
@@ -3197,7 +3514,18 @@ function verificationsCommand(program2) {
       if (!issue) {
         throw new Error(`Issue not found: ${id}`);
       }
-      const verifications = getVerifications(resolvedId);
+      let verifications = getVerifications(resolvedId);
+      verifications.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+      const total = verifications.length;
+      const limit = options.all ? 0 : options.limit ? parseInt(options.limit, 10) : 30;
+      if (limit > 0 && verifications.length > limit) {
+        verifications = verifications.slice(0, limit);
+      }
+      const limitInfo = {
+        total,
+        shown: verifications.length,
+        limited: limit > 0 && total > limit
+      };
       if (pretty) {
         if (verifications.length === 0) {
           console.log(`No verifications for ${resolvedId}`);
@@ -3210,16 +3538,21 @@ function verificationsCommand(program2) {
           }
           console.log("");
           console.log(`Total: ${verifications.length} verification(s)`);
+          if (limitInfo.limited) {
+            console.log(formatLimitMessage(limitInfo));
+          }
         }
       } else {
-        console.log(formatJson({
+        const output = {
           issueId: resolvedId,
           verifications: verifications.map((v) => ({
             id: v.id,
             title: v.title,
             status: v.status
-          }))
-        }));
+          })),
+          ...limitInfo.limited && { _meta: limitInfo }
+        };
+        console.log(formatJson(output));
       }
     } catch (error) {
       outputError(error, pretty);
@@ -3255,13 +3588,6 @@ var program = new Command();
 program.name("pebble").description("A lightweight JSONL-based issue tracker").version("0.1.0");
 program.option("-P, --pretty", "Human-readable output (default: JSON)");
 program.option("--json", "JSON output (this is the default, flag not needed)");
-program.hook("preAction", () => {
-  const opts = program.opts();
-  if (opts.json) {
-    console.error("Note: --json flag is unnecessary. JSON is the default output format.");
-    console.error("Use --pretty (-P) for human-readable output.");
-  }
-});
 createCommand(program);
 updateCommand(program);
 closeCommand(program);