@markmdev/pebble 0.1.17 → 0.1.20

package/README.md

@@ -84,7 +84,7 @@ pb ui
 - `-t, --type <type>` — Issue type: task, bug, epic (default: task)
 - `-p, --priority <n>` — Priority: 0=critical, 4=backlog (default: 2)
 - `-d, --description <text>` — Description
-- `--parent <id>` — Parent epic ID
+- `--parent <id>` — Parent issue ID
 
 ### List
 
@@ -112,7 +112,7 @@ pb ui
   priority: 0-4;        // 0=critical, 4=backlog
   status: 'open' | 'in_progress' | 'blocked' | 'closed';
   description?: string;
-  parent?: string;      // Parent epic ID
+  parent?: string;      // Parent issue ID
   blockedBy: string[];  // IDs of blocking issues
   comments: Comment[];
   createdAt: string;

package/dist/cli/index.js

@@ -294,6 +294,8 @@ function computeState(events) {
           comments: [],
           createdAt: event.timestamp,
           updatedAt: event.timestamp,
+          statusChangedAt: event.timestamp,
+          // Initial status is 'open'
           lastSource: event.source
         };
         issues.set(event.issueId, issue);
@@ -313,6 +315,9 @@ function computeState(events) {
             issue.priority = updateEvent.data.priority;
           }
           if (updateEvent.data.status !== void 0) {
+            if (issue.status !== updateEvent.data.status) {
+              issue.statusChangedAt = event.timestamp;
+            }
             issue.status = updateEvent.data.status;
           }
           if (updateEvent.data.description !== void 0) {
@@ -336,6 +341,7 @@ function computeState(events) {
         const issue = issues.get(event.issueId);
         if (issue) {
           issue.status = "closed";
+          issue.statusChangedAt = event.timestamp;
           issue.updatedAt = event.timestamp;
           if (event.source) issue.lastSource = event.source;
         }
@@ -345,6 +351,7 @@ function computeState(events) {
         const issue = issues.get(event.issueId);
         if (issue) {
           issue.status = "open";
+          issue.statusChangedAt = event.timestamp;
           issue.updatedAt = event.timestamp;
           if (event.source) issue.lastSource = event.source;
         }
@@ -707,7 +714,8 @@ function formatIssueDetailPretty(issue, ctx) {
   lines.push("\u2500".repeat(60));
   lines.push(`Type:     ${formatType(issue.type)}`);
   lines.push(`Priority: ${formatPriority(issue.priority)}`);
-  lines.push(`Status:   ${formatStatus(issue.status)}`);
+  const statusTime = issue.statusChangedAt ? ` (${formatRelativeTime(issue.statusChangedAt)})` : "";
+  lines.push(`Status:   ${formatStatus(issue.status)}${statusTime}`);
   if (ctx.ancestry && ctx.ancestry.length > 0) {
     const chain = [...ctx.ancestry].reverse().map((a) => a.id).join(" > ");
     lines.push(`Ancestry: ${chain}`);
@@ -764,8 +772,8 @@ function formatIssueDetailPretty(issue, ctx) {
     }
   }
   lines.push("");
-  lines.push(`Created: ${new Date(issue.createdAt).toLocaleString()}`);
-  lines.push(`Updated: ${new Date(issue.updatedAt).toLocaleString()}`);
+  lines.push(`Created: ${formatRelativeTime(issue.createdAt)}`);
+  lines.push(`Updated: ${formatRelativeTime(issue.updatedAt)}`);
   return lines.join("\n");
 }
 function outputIssueDetail(issue, ctx, pretty) {
@@ -859,11 +867,30 @@ function formatErrorPretty(error) {
   const message = error instanceof Error ? error.message : error;
   return `Error: ${message}`;
 }
-function outputMutationSuccess(id, pretty) {
+function outputMutationSuccess(id, pretty, extra) {
   if (pretty) {
-    console.log(`\u2713 ${id}`);
+    const notes = [];
+    if (extra?.parentReopened) {
+      notes.push(`parent ${extra.parentReopened.id} reopened`);
+    }
+    if (extra?.blockersReopened?.length) {
+      const ids = extra.blockersReopened.map((b) => b.id).join(", ");
+      notes.push(`blocker${extra.blockersReopened.length > 1 ? "s" : ""} ${ids} reopened`);
+    }
+    if (notes.length > 0) {
+      console.log(`\u2713 ${id} (${notes.join(", ")})`);
+    } else {
+      console.log(`\u2713 ${id}`);
+    }
   } else {
-    console.log(JSON.stringify({ id, success: true }));
+    const result = { id, success: true };
+    if (extra?.parentReopened) {
+      result._parentReopened = extra.parentReopened;
+    }
+    if (extra?.blockersReopened?.length) {
+      result._blockersReopened = extra.blockersReopened;
+    }
+    console.log(JSON.stringify(result));
   }
 }
 function outputIssueList(issues, pretty, limitInfo) {
@@ -900,6 +927,7 @@ function buildIssueTree(issues) {
       priority: issue.priority,
       status: issue.status,
       createdAt: issue.createdAt,
+      statusChangedAt: issue.statusChangedAt,
       childrenCount: children.length,
       ...children.length > 0 && { children }
     };
@@ -925,7 +953,7 @@ function formatIssueTreePretty(nodes, sectionHeader) {
     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);
+    const relativeTime = node.statusChangedAt ? formatRelativeTime(node.statusChangedAt) : 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  ");
@@ -975,8 +1003,9 @@ function formatIssueListVerbose(issues, sectionHeader) {
   }
   for (const info of issues) {
     const { issue, blocking, children, verifications, blockers, ancestry } = info;
+    const statusTime = issue.statusChangedAt ? formatRelativeTime(issue.statusChangedAt) : formatRelativeTime(issue.createdAt);
     lines.push(`${issue.id}: ${issue.title}`);
-    lines.push(`  Type: ${formatType(issue.type)} | Priority: P${issue.priority} | Created: ${formatRelativeTime(issue.createdAt)}`);
+    lines.push(`  Type: ${formatType(issue.type)} | Priority: P${issue.priority} | Status: ${formatStatus(issue.status)} (${statusTime})`);
     if (ancestry.length > 0) {
       const chain = [...ancestry].reverse().map((a) => a.title).join(" \u2192 ");
       lines.push(`  Ancestry: ${chain}`);
@@ -1019,7 +1048,7 @@ function outputIssueListVerbose(issues, pretty, sectionHeader, limitInfo) {
 
 // src/cli/commands/create.ts
 function createCommand(program2) {
-  program2.command("create <title>").description("Create a new issue").option("-t, --type <type>", "Issue type (task, bug, epic, verification)", "task").option("-p, --priority <priority>", "Priority (0-4)", "2").option("-d, --description <desc>", "Description").option("--parent <id>", "Parent epic ID").option("--verifies <id>", "ID of issue this verifies (sets type to verification)").option("--blocked-by <ids>", "Comma-separated IDs of issues that block this one").option("--blocks <ids>", "Comma-separated IDs of issues this one will block").action(async (title, options) => {
+  program2.command("create <title>").description("Create a new issue").option("-t, --type <type>", "Issue type (task, bug, epic, verification)", "task").option("-p, --priority <priority>", "Priority (0-4)", "2").option("-d, --description <desc>", "Description").option("--parent <id>", "Parent issue ID").option("--verifies <id>", "ID of issue this verifies (sets type to verification)").option("--blocked-by <ids>", "Comma-separated IDs of issues that block this one").option("--blocks <ids>", "Comma-separated IDs of issues this one will block").action(async (title, options) => {
     const pretty = program2.opts().pretty ?? false;
     try {
       let type = options.type;
@@ -1039,17 +1068,25 @@ function createCommand(program2) {
       const pebbleDir = getOrCreatePebbleDir();
       const config = getConfig(pebbleDir);
       let parentId;
+      let parentReopened;
       if (options.parent) {
         parentId = resolveId(options.parent);
         const parent = getIssue(parentId);
         if (!parent) {
           throw new Error(`Parent issue not found: ${options.parent}`);
         }
-        if (parent.type !== "epic") {
-          throw new Error(`Parent must be an epic, got: ${parent.type}`);
+        if (parent.type === "verification") {
+          throw new Error(`Verification issues cannot be parents`);
         }
         if (parent.status === "closed") {
-          throw new Error(`Cannot add children to closed epic: ${parentId}`);
+          const reopenEvent = {
+            type: "reopen",
+            issueId: parentId,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+            data: { reason: "Reopened to add child" }
+          };
+          appendEvent(reopenEvent, pebbleDir);
+          parentReopened = { id: parentId, title: parent.title };
         }
       }
       let verifiesId;
@@ -1061,6 +1098,7 @@ function createCommand(program2) {
         }
       }
       const blockedByIds = [];
+      const blockersReopened = [];
       if (options.blockedBy) {
         const ids = options.blockedBy.split(",").map((s) => s.trim()).filter(Boolean);
         for (const rawId of ids) {
@@ -1070,7 +1108,14 @@ function createCommand(program2) {
             throw new Error(`Blocker issue not found: ${rawId}`);
           }
           if (blocker.status === "closed") {
-            throw new Error(`Cannot be blocked by closed issue: ${resolvedId}`);
+            const reopenEvent = {
+              type: "reopen",
+              issueId: resolvedId,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              data: { reason: "Reopened to block new issue" }
+            };
+            appendEvent(reopenEvent, pebbleDir);
+            blockersReopened.push({ id: resolvedId, title: blocker.title });
           }
           blockedByIds.push(resolvedId);
         }
@@ -1123,7 +1168,8 @@ function createCommand(program2) {
         };
         appendEvent(depEvent, pebbleDir);
       }
-      outputMutationSuccess(id, pretty);
+      const extra = parentReopened || blockersReopened.length > 0 ? { parentReopened, blockersReopened: blockersReopened.length > 0 ? blockersReopened : void 0 } : void 0;
+      outputMutationSuccess(id, pretty, extra);
     } catch (error) {
       outputError(error, pretty);
     }
@@ -1132,7 +1178,7 @@ function createCommand(program2) {
 
 // src/cli/commands/update.ts
 function updateCommand(program2) {
-  program2.command("update <ids...>").description("Update issues. Supports multiple IDs.").option("--status <status>", "Status (open, in_progress, blocked, closed)").option("--priority <priority>", "Priority (0-4)").option("--title <title>", "Title").option("--description <desc>", "Description").option("--parent <id>", 'Parent epic ID (use "null" to remove parent)').action(async (ids, options) => {
+  program2.command("update <ids...>").description("Update issues. Supports multiple IDs.").option("--status <status>", "Status (open, in_progress, blocked, closed)").option("--priority <priority>", "Priority (0-4)").option("--title <title>", "Title").option("--description <desc>", "Description").option("--parent <id>", 'Parent issue ID (use "null" to remove parent)').action(async (ids, options) => {
     const pretty = program2.opts().pretty ?? false;
     try {
       const pebbleDir = getOrCreatePebbleDir();
@@ -1166,6 +1212,7 @@ function updateCommand(program2) {
         data.description = options.description;
         hasChanges = true;
       }
+      let parentReopened;
       if (options.parent !== void 0) {
         if (options.parent.toLowerCase() === "null") {
           data.parent = "";
@@ -1175,11 +1222,18 @@ function updateCommand(program2) {
           if (!parentIssue) {
             throw new Error(`Parent issue not found: ${options.parent}`);
           }
-          if (parentIssue.type !== "epic") {
-            throw new Error(`Parent must be an epic. ${parentId} is a ${parentIssue.type}`);
+          if (parentIssue.type === "verification") {
+            throw new Error(`Verification issues cannot be parents`);
           }
           if (parentIssue.status === "closed") {
-            throw new Error(`Cannot set parent to closed epic: ${parentId}`);
+            const reopenEvent = {
+              type: "reopen",
+              issueId: parentId,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              data: { reason: "Reopened to add child" }
+            };
+            appendEvent(reopenEvent, pebbleDir);
+            parentReopened = { id: parentId, title: parentIssue.title };
           }
           data.parent = parentId;
         }
@@ -1218,7 +1272,7 @@ function updateCommand(program2) {
       if (allIds.length === 1) {
         const result = results[0];
         if (result.success) {
-          outputMutationSuccess(result.id, pretty);
+          outputMutationSuccess(result.id, pretty, parentReopened ? { parentReopened } : void 0);
         } else {
           throw new Error(result.error || "Unknown error");
         }
@@ -2714,19 +2768,26 @@ data: ${message}
             res.status(400).json({ error: "Priority must be 0-4" });
             return;
           }
+          let parentReopened;
           if (parent) {
             const parentIssue = getIssue(parent);
             if (!parentIssue) {
               res.status(400).json({ error: `Parent issue not found: ${parent}` });
               return;
             }
-            if (parentIssue.type !== "epic") {
-              res.status(400).json({ error: "Parent must be an epic" });
+            if (parentIssue.type === "verification") {
+              res.status(400).json({ error: "Verification issues cannot be parents" });
               return;
             }
             if (parentIssue.status === "closed") {
-              res.status(400).json({ error: "Cannot add children to a closed epic" });
-              return;
+              const reopenEvent = {
+                type: "reopen",
+                issueId: parent,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                data: { reason: "Reopened to add child" }
+              };
+              appendEvent(reopenEvent, pebbleDir);
+              parentReopened = { id: parent, title: parentIssue.title };
             }
           }
           const issueId = generateId(config.prefix);
@@ -2745,7 +2806,8 @@ data: ${message}
           };
           appendEvent(event, pebbleDir);
           const issue = getIssue(issueId);
-          res.status(201).json(issue);
+          const result = parentReopened ? { ...issue, _parentReopened: parentReopened } : issue;
+          res.status(201).json(result);
         } catch (error) {
           res.status(500).json({ error: error.message });
         }
@@ -2931,8 +2993,8 @@ data: ${message}
                   res.status(400).json({ error: `Parent issue not found: ${parent}` });
                   return;
                 }
-                if (parentFound.issue.type !== "epic") {
-                  res.status(400).json({ error: "Parent must be an epic" });
+                if (parentFound.issue.type === "verification") {
+                  res.status(400).json({ error: "Verification issues cannot be parents" });
                   return;
                 }
               } else {
@@ -2941,8 +3003,8 @@ data: ${message}
                   res.status(400).json({ error: `Parent issue not found: ${parent}` });
                   return;
                 }
-                if (parentIssue.type !== "epic") {
-                  res.status(400).json({ error: "Parent must be an epic" });
+                if (parentIssue.type === "verification") {
+                  res.status(400).json({ error: "Verification issues cannot be parents" });
                   return;
                 }
               }