@markmdev/pebble 0.1.6 → 0.1.8

package/dist/cli/index.js

@@ -12,7 +12,7 @@ import { Command } from "commander";
 // src/shared/types.ts
 var ISSUE_TYPES = ["task", "bug", "epic", "verification"];
 var PRIORITIES = [0, 1, 2, 3, 4];
-var STATUSES = ["open", "in_progress", "blocked", "closed"];
+var STATUSES = ["open", "in_progress", "blocked", "pending_verification", "closed"];
 var EVENT_TYPES = ["create", "update", "close", "reopen", "comment"];
 var PRIORITY_LABELS = {
   0: "critical",
@@ -25,6 +25,7 @@ var STATUS_LABELS = {
   open: "Open",
   in_progress: "In Progress",
   blocked: "Blocked",
+  pending_verification: "Pending Verification",
   closed: "Closed"
 };
 var TYPE_LABELS = {
@@ -183,6 +184,7 @@ function computeState(events) {
           description: createEvent.data.description,
           parent: createEvent.data.parent,
           blockedBy: [],
+          relatedTo: [],
           verifies: createEvent.data.verifies,
           comments: [],
           createdAt: event.timestamp,
@@ -216,6 +218,9 @@ function computeState(events) {
           if (updateEvent.data.blockedBy !== void 0) {
             issue.blockedBy = updateEvent.data.blockedBy;
           }
+          if (updateEvent.data.relatedTo !== void 0) {
+            issue.relatedTo = updateEvent.data.relatedTo;
+          }
           issue.updatedAt = event.timestamp;
         }
         break;
@@ -315,7 +320,7 @@ function getReady() {
   const state = computeState(events);
   const issues = Array.from(state.values());
   return issues.filter((issue) => {
-    if (issue.status === "closed") {
+    if (issue.status === "closed" || issue.status === "pending_verification") {
       return false;
     }
     for (const blockerId of issue.blockedBy) {
@@ -456,6 +461,36 @@ function getNewlyUnblocked(closedIssueId) {
   }
   return result;
 }
+function getRelated(issueId) {
+  const issue = getIssue(issueId);
+  if (!issue) {
+    return [];
+  }
+  const events = readEvents();
+  const state = computeState(events);
+  return issue.relatedTo.map((id) => state.get(id)).filter((i) => i !== void 0);
+}
+function hasOpenBlockersById(issueId) {
+  const issue = getIssue(issueId);
+  if (!issue) {
+    return false;
+  }
+  const events = readEvents();
+  const state = computeState(events);
+  return issue.blockedBy.some((blockerId) => {
+    const blocker = state.get(blockerId);
+    return blocker && blocker.status !== "closed";
+  });
+}
+function getOpenBlockers(issueId) {
+  const issue = getIssue(issueId);
+  if (!issue) {
+    return [];
+  }
+  const events = readEvents();
+  const state = computeState(events);
+  return issue.blockedBy.map((id) => state.get(id)).filter((i) => i !== void 0 && i.status !== "closed");
+}
 
 // src/cli/lib/output.ts
 function formatJson(data) {
@@ -547,7 +582,7 @@ function formatIssueListPretty(issues) {
   lines.push(`Total: ${issues.length} issue(s)`);
   return lines.join("\n");
 }
-function formatDepsPretty(issueId, blockedBy, blocking) {
+function formatDepsPretty(issueId, blockedBy, blocking, related = []) {
   const lines = [];
   lines.push(`Dependencies for ${issueId}`);
   lines.push("\u2500".repeat(40));
@@ -570,6 +605,16 @@ function formatDepsPretty(issueId, blockedBy, blocking) {
       lines.push(`  \u25CB ${issue.id} - ${truncate(issue.title, 30)}`);
     }
   }
+  lines.push("");
+  lines.push("Related:");
+  if (related.length === 0) {
+    lines.push("  (none)");
+  } else {
+    for (const issue of related) {
+      const status = issue.status === "closed" ? "\u2713" : "\u25CB";
+      lines.push(`  ${status} ${issue.id} - ${truncate(issue.title, 30)}`);
+    }
+  }
   return lines.join("\n");
 }
 function formatError(error) {
@@ -832,6 +877,12 @@ function updateCommand(program2) {
             results.push({ id, success: false, error: `Issue not found: ${id}` });
             continue;
           }
+          if (data.status === "in_progress" && hasOpenBlockersById(resolvedId)) {
+            const blockers = getOpenBlockers(resolvedId);
+            const blockerIds = blockers.map((b) => b.id).join(", ");
+            results.push({ id: resolvedId, success: false, error: `Cannot set to in_progress - blocked by: ${blockerIds}` });
+            continue;
+          }
           const event = {
             type: "update",
             issueId: resolvedId,
@@ -914,6 +965,25 @@ function closeCommand(program2) {
             };
             appendEvent(commentEvent, pebbleDir);
           }
+          const pendingVerifications = getVerifications(resolvedId).filter((v) => v.status !== "closed");
+          if (pendingVerifications.length > 0) {
+            const updateEvent = {
+              type: "update",
+              issueId: resolvedId,
+              timestamp,
+              data: {
+                status: "pending_verification"
+              }
+            };
+            appendEvent(updateEvent, pebbleDir);
+            results.push({
+              id: resolvedId,
+              success: true,
+              status: "pending_verification",
+              pendingVerifications: pendingVerifications.map((v) => ({ id: v.id, title: v.title }))
+            });
+            continue;
+          }
           const closeEvent = {
             type: "close",
             issueId: resolvedId,
@@ -927,6 +997,7 @@ function closeCommand(program2) {
           results.push({
             id: resolvedId,
             success: true,
+            status: "closed",
             unblocked: unblocked.length > 0 ? unblocked.map((i) => ({ id: i.id, title: i.title })) : void 0
           });
         } catch (error) {
@@ -937,18 +1008,29 @@ function closeCommand(program2) {
         const result = results[0];
         if (result.success) {
           if (pretty) {
-            console.log(`\u2713 ${result.id}`);
-            if (result.unblocked && result.unblocked.length > 0) {
+            if (result.status === "pending_verification") {
+              console.log(`\u23F3 ${result.id} \u2192 pending_verification`);
               console.log(`
+Pending verifications:`);
+              for (const v of result.pendingVerifications || []) {
+                console.log(`  \u2022 ${v.id} - ${v.title}`);
+              }
+            } else {
+              console.log(`\u2713 ${result.id}`);
+              if (result.unblocked && result.unblocked.length > 0) {
+                console.log(`
 Unblocked:`);
-              for (const u of result.unblocked) {
-                console.log(`  \u2192 ${u.id} - ${u.title}`);
+                for (const u of result.unblocked) {
+                  console.log(`  \u2192 ${u.id} - ${u.title}`);
+                }
               }
             }
           } else {
             console.log(formatJson({
               id: result.id,
               success: true,
+              status: result.status,
+              ...result.pendingVerifications && { pendingVerifications: result.pendingVerifications },
               ...result.unblocked && { unblocked: result.unblocked }
             }));
           }
@@ -959,10 +1041,17 @@ Unblocked:`);
         if (pretty) {
           for (const result of results) {
             if (result.success) {
-              console.log(`\u2713 ${result.id}`);
-              if (result.unblocked && result.unblocked.length > 0) {
-                for (const u of result.unblocked) {
-                  console.log(`  \u2192 ${u.id} - ${u.title}`);
+              if (result.status === "pending_verification") {
+                console.log(`\u23F3 ${result.id} \u2192 pending_verification`);
+                for (const v of result.pendingVerifications || []) {
+                  console.log(`  \u2022 ${v.id} - ${v.title}`);
+                }
+              } else {
+                console.log(`\u2713 ${result.id}`);
+                if (result.unblocked && result.unblocked.length > 0) {
+                  for (const u of result.unblocked) {
+                    console.log(`  \u2192 ${u.id} - ${u.title}`);
+                  }
                 }
               }
             } else {
@@ -973,7 +1062,9 @@ Unblocked:`);
           console.log(formatJson(results.map((r) => ({
             id: r.id,
             success: r.success,
+            status: r.status,
             ...r.error && { error: r.error },
+            ...r.pendingVerifications && { pendingVerifications: r.pendingVerifications },
             ...r.unblocked && { unblocked: r.unblocked }
           }))));
         }
@@ -1041,6 +1132,12 @@ function claimCommand(program2) {
             results.push({ id: resolvedId, success: false, error: `Cannot claim closed issue: ${resolvedId}` });
             continue;
           }
+          if (hasOpenBlockersById(resolvedId)) {
+            const blockers = getOpenBlockers(resolvedId);
+            const blockerIds = blockers.map((b) => b.id).join(", ");
+            results.push({ id: resolvedId, success: false, error: `Cannot claim blocked issue. Blocked by: ${blockerIds}` });
+            continue;
+          }
           const event = {
             type: "update",
             issueId: resolvedId,
@@ -1264,6 +1361,99 @@ function depCommand(program2) {
       outputError(error, pretty);
     }
   });
+  dep.command("relate <id1> <id2>").description("Add a bidirectional related link between two issues").action(async (id1, id2) => {
+    const pretty = program2.opts().pretty ?? false;
+    try {
+      const pebbleDir = getOrCreatePebbleDir();
+      const resolvedId1 = resolveId(id1);
+      const resolvedId2 = resolveId(id2);
+      const issue1 = getIssue(resolvedId1);
+      if (!issue1) {
+        throw new Error(`Issue not found: ${id1}`);
+      }
+      const issue2 = getIssue(resolvedId2);
+      if (!issue2) {
+        throw new Error(`Issue not found: ${id2}`);
+      }
+      if (resolvedId1 === resolvedId2) {
+        throw new Error("Cannot relate issue to itself");
+      }
+      if (issue1.relatedTo.includes(resolvedId2)) {
+        throw new Error(`Issues are already related: ${resolvedId1} \u2194 ${resolvedId2}`);
+      }
+      const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+      const event1 = {
+        type: "update",
+        issueId: resolvedId1,
+        timestamp,
+        data: {
+          relatedTo: [...issue1.relatedTo, resolvedId2]
+        }
+      };
+      const event2 = {
+        type: "update",
+        issueId: resolvedId2,
+        timestamp,
+        data: {
+          relatedTo: [...issue2.relatedTo, resolvedId1]
+        }
+      };
+      appendEvent(event1, pebbleDir);
+      appendEvent(event2, pebbleDir);
+      if (pretty) {
+        console.log(`\u2713 ${resolvedId1} \u2194 ${resolvedId2}`);
+      } else {
+        console.log(formatJson({ id1: resolvedId1, id2: resolvedId2, related: true }));
+      }
+    } catch (error) {
+      outputError(error, pretty);
+    }
+  });
+  dep.command("unrelate <id1> <id2>").description("Remove a bidirectional related link between two issues").action(async (id1, id2) => {
+    const pretty = program2.opts().pretty ?? false;
+    try {
+      const pebbleDir = getOrCreatePebbleDir();
+      const resolvedId1 = resolveId(id1);
+      const resolvedId2 = resolveId(id2);
+      const issue1 = getIssue(resolvedId1);
+      if (!issue1) {
+        throw new Error(`Issue not found: ${id1}`);
+      }
+      const issue2 = getIssue(resolvedId2);
+      if (!issue2) {
+        throw new Error(`Issue not found: ${id2}`);
+      }
+      if (!issue1.relatedTo.includes(resolvedId2)) {
+        throw new Error(`Issues are not related: ${resolvedId1} \u2194 ${resolvedId2}`);
+      }
+      const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+      const event1 = {
+        type: "update",
+        issueId: resolvedId1,
+        timestamp,
+        data: {
+          relatedTo: issue1.relatedTo.filter((id) => id !== resolvedId2)
+        }
+      };
+      const event2 = {
+        type: "update",
+        issueId: resolvedId2,
+        timestamp,
+        data: {
+          relatedTo: issue2.relatedTo.filter((id) => id !== resolvedId1)
+        }
+      };
+      appendEvent(event1, pebbleDir);
+      appendEvent(event2, pebbleDir);
+      if (pretty) {
+        console.log(`\u2713 ${resolvedId1} \u21AE ${resolvedId2}`);
+      } else {
+        console.log(formatJson({ id1: resolvedId1, id2: resolvedId2, related: false }));
+      }
+    } catch (error) {
+      outputError(error, pretty);
+    }
+  });
   dep.command("list <id>").description("List dependencies for an issue").action(async (id) => {
     const pretty = program2.opts().pretty ?? false;
     try {
@@ -1274,13 +1464,15 @@ function depCommand(program2) {
       }
       const blockedBy = getBlockers(resolvedId);
       const blocking = getBlocking(resolvedId);
+      const related = getRelated(resolvedId);
       if (pretty) {
-        console.log(formatDepsPretty(resolvedId, blockedBy, blocking));
+        console.log(formatDepsPretty(resolvedId, blockedBy, blocking, related));
       } else {
         console.log(formatJson({
           issueId: resolvedId,
           blockedBy: blockedBy.map((i) => ({ id: i.id, title: i.title, status: i.status })),
-          blocking: blocking.map((i) => ({ id: i.id, title: i.title, status: i.status }))
+          blocking: blocking.map((i) => ({ id: i.id, title: i.title, status: i.status })),
+          related: related.map((i) => ({ id: i.id, title: i.title, status: i.status }))
         }));
       }
     } catch (error) {
@@ -1880,9 +2072,26 @@ data: ${message}
                 results.push({ id: issueId, success: false, error: "Cannot close epic with open children" });
                 continue;
               }
+              const pendingVerifications = getVerifications(issueId).filter((v) => v.status !== "closed");
+              const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+              if (pendingVerifications.length > 0) {
+                const updateEvent = {
+                  type: "update",
+                  issueId,
+                  timestamp,
+                  data: { status: "pending_verification" }
+                };
+                appendEvent(updateEvent, pebbleDir);
+                results.push({
+                  id: issueId,
+                  success: true,
+                  error: `Moved to pending_verification (${pendingVerifications.length} verification(s) pending)`
+                });
+                continue;
+              }
               const event = {
                 issueId,
-                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                timestamp,
                 type: "close",
                 data: { reason: "Bulk close" }
               };
@@ -1910,7 +2119,7 @@ data: ${message}
             return;
           }
           if (updates.status) {
-            const validStatuses = ["open", "in_progress", "blocked"];
+            const validStatuses = ["open", "in_progress", "blocked", "pending_verification"];
             if (!validStatuses.includes(updates.status)) {
               res.status(400).json({
                 error: `Invalid status: ${updates.status}. Use close endpoint to close issues.`
@@ -1978,7 +2187,7 @@ data: ${message}
             issue = localIssue;
             targetFile = path2.join(pebbleDir, "issues.jsonl");
           }
-          const { title, type, priority, status, description, parent } = req.body;
+          const { title, type, priority, status, description, parent, relatedTo } = req.body;
           const updates = {};
           if (title !== void 0) {
             if (typeof title !== "string" || title.trim() === "") {
@@ -2037,6 +2246,28 @@ data: ${message}
             }
             updates.parent = parent;
           }
+          if (relatedTo !== void 0) {
+            if (!Array.isArray(relatedTo)) {
+              res.status(400).json({ error: "relatedTo must be an array" });
+              return;
+            }
+            for (const relatedId of relatedTo) {
+              if (isMultiWorktree()) {
+                const found = findIssueInSources(relatedId, issueFiles);
+                if (!found) {
+                  res.status(400).json({ error: `Related issue not found: ${relatedId}` });
+                  return;
+                }
+              } else {
+                const relatedIssue = getIssue(relatedId);
+                if (!relatedIssue) {
+                  res.status(400).json({ error: `Related issue not found: ${relatedId}` });
+                  return;
+                }
+              }
+            }
+            updates.relatedTo = relatedTo;
+          }
           if (Object.keys(updates).length === 0) {
             res.status(400).json({ error: "No valid updates provided" });
             return;
@@ -2094,6 +2325,30 @@ data: ${message}
           }
           const { reason } = req.body;
           const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+          let pendingVerifications = [];
+          if (isMultiWorktree()) {
+            const allIssues = mergeIssuesFromFiles(issueFiles);
+            pendingVerifications = allIssues.filter(
+              (i) => i.verifies === issueId && i.status !== "closed"
+            );
+          } else {
+            pendingVerifications = getVerifications(issueId).filter((v) => v.status !== "closed");
+          }
+          if (pendingVerifications.length > 0) {
+            const updateEvent = {
+              type: "update",
+              issueId,
+              timestamp,
+              data: { status: "pending_verification" }
+            };
+            appendEventToFile(updateEvent, targetFile);
+            const updatedIssue = { ...issue, status: "pending_verification", updatedAt: timestamp };
+            res.json({
+              ...updatedIssue,
+              _pendingVerifications: pendingVerifications.map((v) => ({ id: v.id, title: v.title }))
+            });
+            return;
+          }
           const event = {
             type: "close",
             issueId,