@defend-tech/opencode-optima 0.1.36 → 0.1.37

package/dist/index.js

@@ -9616,6 +9616,45 @@ function formatClickUpWebhookPrompt({ eventType, taskId, payload, branch = "", w
     deliveryEvidencePath ? `Final merge-trackable evidence must be written under ${deliveryEvidencePath}; use .optima only as local mirror/staging.` : null
   ].filter((part) => part !== null).join("\n");
 }
+function clickUpNoAbandonmentRuleText() {
+  return "No-abandonment rule: PM must keep working, or before stopping must post a ClickUp comment, hand off, remove PM as assignee, and assign the next owner.";
+}
+function buildClickUpStartupResumeComment({ taskId, result = {} } = {}) {
+  const contextParts = [
+    result.branch ? `- Branch: ${result.branch}` : null,
+    result.worktree ? `- Worktree: ${result.worktree}` : null,
+    result.deliveryEvidencePath ? `- Delivery evidence path: ${result.deliveryEvidencePath}` : null,
+    result.evidencePath ? `- Local evidence path: ${result.evidencePath}` : null
+  ].filter(Boolean);
+  return [
+    `Startup reconciliation resumed ClickUp task ${taskId}.`,
+    `Route result: ${result.action || "unknown"}${result.ok === false ? " (failed)" : ""}.`,
+    result.sessionId ? `Session id: ${result.sessionId}.` : "Session id: unavailable.",
+    contextParts.length ? contextParts.join("\n") : "Worktree/branch/delivery evidence path: unavailable.",
+    clickUpNoAbandonmentRuleText()
+  ].join("\n");
+}
+function buildClickUpStartupBlockerComment({ taskId, error } = {}) {
+  const summary = error?.message || String(error || "unknown error");
+  return [
+    `Startup reconciliation blocker for ClickUp task ${taskId}: ${summary}`,
+    "Optima skipped this task for this startup pass and continued with the next PM-assigned task.",
+    clickUpNoAbandonmentRuleText()
+  ].join("\n");
+}
+async function postClickUpStartupComment({ clickupClient, worktree, taskId, comment, type } = {}) {
+  if (typeof clickupClient?.postTaskComment !== "function") {
+    appendClickUpWebhookLocalLog(worktree, { type: "startup_reconciliation_comment_unavailable", taskId, commentType: type });
+    return { ok: false, skipped: true, reason: "post_task_comment_unavailable" };
+  }
+  try {
+    await clickupClient.postTaskComment({ taskId, comment });
+    return { ok: true };
+  } catch (error) {
+    appendClickUpWebhookLocalLog(worktree, { type: "startup_reconciliation_comment_failed", taskId, commentType: type, message: error.message });
+    return { ok: false, error: error.message };
+  }
+}
 function appendClickUpWebhookLocalLog(worktree, entry) {
   const logPath = clickUpWebhookLogPath(worktree);
   fs2.mkdirSync(path2.dirname(logPath), { recursive: true });
@@ -9887,19 +9926,19 @@ async function routeClickUpWebhookEventUnlocked({ payload, config, state = {}, w
     await clickupClient.updateTaskMetadata({ taskId, fieldId: config.routing.metadataFieldId, value: nextMetadata });
     const { [taskId]: _completedPending, ...remainingPending } = stateToPersist.pendingSessions || {};
     stateToPersist = { ...stateToPersist, pendingSessions: remainingPending };
-    return finish({ ok: true, action: "created_session", taskId, sessionId: pendingSessionId, eventKey });
+    return finish({ ok: true, action: "created_session", taskId, sessionId: pendingSessionId, eventKey, branch: taskRoute.branch, worktree: taskRoute.worktree, deliveryEvidencePath, evidencePath: routingMetadata.evidence_path });
   }
   const sessionId = String(existingSessionId);
   if (await sessionExists(openCodeClient, sessionId)) {
     if (typeof clickupClient?.updateTaskMetadata === "function") await clickupClient.updateTaskMetadata({ taskId, fieldId: config.routing.metadataFieldId, value: metadataWithRouting });
     await sendSessionEvent(openCodeClient, { sessionId, agent: config.routing.targetAgent, text: prompt, directory: taskRoute.worktree, opencodeBaseUrl: config.opencode?.baseUrl });
-    return finish({ ok: true, action: "sent_to_existing_session", taskId, sessionId, eventKey });
+    return finish({ ok: true, action: "sent_to_existing_session", taskId, sessionId, eventKey, branch: taskRoute.branch, worktree: taskRoute.worktree, deliveryEvidencePath, evidencePath: routingMetadata.evidence_path });
   }
   const at = now().toISOString();
   const incidentComment = `Optima webhook could not route this ClickUp event because OpenCode session ${sessionId} is missing on host ${host} at ${at}. No replacement session was created automatically.`;
   appendClickUpWebhookLocalLog(worktree, { type: "missing_session", taskId, sessionId, host, at });
   await clickupClient.postTaskComment({ taskId, comment: incidentComment });
-  return finish({ ok: true, action: "missing_session_reported", taskId, sessionId, eventKey });
+  return finish({ ok: true, action: "missing_session_reported", taskId, sessionId, eventKey, branch: taskRoute.branch, worktree: taskRoute.worktree, deliveryEvidencePath, evidencePath: routingMetadata.evidence_path });
 }
 async function routeClickUpWebhookEvent(options = {}) {
   const taskId = clickUpTaskIdFromPayload(options.payload || {});
@@ -9955,10 +9994,26 @@ async function reconcileClickUpStartup({ config, state = {}, worktree = process.
         saveState: persistState,
         now
       });
-      if (result?.ok && result.action !== "ignored") routed.assigned += 1;
+      if (result?.ok && result.action !== "ignored") {
+        routed.assigned += 1;
+        await postClickUpStartupComment({
+          clickupClient,
+          worktree,
+          taskId,
+          type: "resume",
+          comment: buildClickUpStartupResumeComment({ taskId, result })
+        });
+      }
     } catch (error) {
       routed.errors += 1;
       appendClickUpWebhookLocalLog(worktree, { type: "startup_reconciliation_task_failed", taskId, message: error.message });
+      await postClickUpStartupComment({
+        clickupClient,
+        worktree,
+        taskId,
+        type: "blocker",
+        comment: buildClickUpStartupBlockerComment({ taskId, error })
+      });
     }
     if (!lastWebhookMs || !clickupClient?.getTaskComments) continue;
     try {

package/dist/sanitize_cli.js

@@ -9623,6 +9623,45 @@ function formatClickUpWebhookPrompt({ eventType, taskId, payload, branch = "", w
     deliveryEvidencePath ? `Final merge-trackable evidence must be written under ${deliveryEvidencePath}; use .optima only as local mirror/staging.` : null
   ].filter((part) => part !== null).join("\n");
 }
+function clickUpNoAbandonmentRuleText() {
+  return "No-abandonment rule: PM must keep working, or before stopping must post a ClickUp comment, hand off, remove PM as assignee, and assign the next owner.";
+}
+function buildClickUpStartupResumeComment({ taskId, result = {} } = {}) {
+  const contextParts = [
+    result.branch ? `- Branch: ${result.branch}` : null,
+    result.worktree ? `- Worktree: ${result.worktree}` : null,
+    result.deliveryEvidencePath ? `- Delivery evidence path: ${result.deliveryEvidencePath}` : null,
+    result.evidencePath ? `- Local evidence path: ${result.evidencePath}` : null
+  ].filter(Boolean);
+  return [
+    `Startup reconciliation resumed ClickUp task ${taskId}.`,
+    `Route result: ${result.action || "unknown"}${result.ok === false ? " (failed)" : ""}.`,
+    result.sessionId ? `Session id: ${result.sessionId}.` : "Session id: unavailable.",
+    contextParts.length ? contextParts.join("\n") : "Worktree/branch/delivery evidence path: unavailable.",
+    clickUpNoAbandonmentRuleText()
+  ].join("\n");
+}
+function buildClickUpStartupBlockerComment({ taskId, error } = {}) {
+  const summary = error?.message || String(error || "unknown error");
+  return [
+    `Startup reconciliation blocker for ClickUp task ${taskId}: ${summary}`,
+    "Optima skipped this task for this startup pass and continued with the next PM-assigned task.",
+    clickUpNoAbandonmentRuleText()
+  ].join("\n");
+}
+async function postClickUpStartupComment({ clickupClient, worktree, taskId, comment, type } = {}) {
+  if (typeof clickupClient?.postTaskComment !== "function") {
+    appendClickUpWebhookLocalLog(worktree, { type: "startup_reconciliation_comment_unavailable", taskId, commentType: type });
+    return { ok: false, skipped: true, reason: "post_task_comment_unavailable" };
+  }
+  try {
+    await clickupClient.postTaskComment({ taskId, comment });
+    return { ok: true };
+  } catch (error) {
+    appendClickUpWebhookLocalLog(worktree, { type: "startup_reconciliation_comment_failed", taskId, commentType: type, message: error.message });
+    return { ok: false, error: error.message };
+  }
+}
 function appendClickUpWebhookLocalLog(worktree, entry) {
   const logPath = clickUpWebhookLogPath(worktree);
   fs2.mkdirSync(path2.dirname(logPath), { recursive: true });
@@ -9894,19 +9933,19 @@ async function routeClickUpWebhookEventUnlocked({ payload, config, state = {}, w
     await clickupClient.updateTaskMetadata({ taskId, fieldId: config.routing.metadataFieldId, value: nextMetadata });
     const { [taskId]: _completedPending, ...remainingPending } = stateToPersist.pendingSessions || {};
     stateToPersist = { ...stateToPersist, pendingSessions: remainingPending };
-    return finish({ ok: true, action: "created_session", taskId, sessionId: pendingSessionId, eventKey });
+    return finish({ ok: true, action: "created_session", taskId, sessionId: pendingSessionId, eventKey, branch: taskRoute.branch, worktree: taskRoute.worktree, deliveryEvidencePath, evidencePath: routingMetadata.evidence_path });
   }
   const sessionId = String(existingSessionId);
   if (await sessionExists(openCodeClient, sessionId)) {
     if (typeof clickupClient?.updateTaskMetadata === "function") await clickupClient.updateTaskMetadata({ taskId, fieldId: config.routing.metadataFieldId, value: metadataWithRouting });
     await sendSessionEvent(openCodeClient, { sessionId, agent: config.routing.targetAgent, text: prompt, directory: taskRoute.worktree, opencodeBaseUrl: config.opencode?.baseUrl });
-    return finish({ ok: true, action: "sent_to_existing_session", taskId, sessionId, eventKey });
+    return finish({ ok: true, action: "sent_to_existing_session", taskId, sessionId, eventKey, branch: taskRoute.branch, worktree: taskRoute.worktree, deliveryEvidencePath, evidencePath: routingMetadata.evidence_path });
   }
   const at = now().toISOString();
   const incidentComment = `Optima webhook could not route this ClickUp event because OpenCode session ${sessionId} is missing on host ${host} at ${at}. No replacement session was created automatically.`;
   appendClickUpWebhookLocalLog(worktree, { type: "missing_session", taskId, sessionId, host, at });
   await clickupClient.postTaskComment({ taskId, comment: incidentComment });
-  return finish({ ok: true, action: "missing_session_reported", taskId, sessionId, eventKey });
+  return finish({ ok: true, action: "missing_session_reported", taskId, sessionId, eventKey, branch: taskRoute.branch, worktree: taskRoute.worktree, deliveryEvidencePath, evidencePath: routingMetadata.evidence_path });
 }
 async function routeClickUpWebhookEvent(options = {}) {
   const taskId = clickUpTaskIdFromPayload(options.payload || {});
@@ -9962,10 +10001,26 @@ async function reconcileClickUpStartup({ config, state = {}, worktree = process.
         saveState: persistState,
         now
       });
-      if (result?.ok && result.action !== "ignored") routed.assigned += 1;
+      if (result?.ok && result.action !== "ignored") {
+        routed.assigned += 1;
+        await postClickUpStartupComment({
+          clickupClient,
+          worktree,
+          taskId,
+          type: "resume",
+          comment: buildClickUpStartupResumeComment({ taskId, result })
+        });
+      }
     } catch (error) {
       routed.errors += 1;
       appendClickUpWebhookLocalLog(worktree, { type: "startup_reconciliation_task_failed", taskId, message: error.message });
+      await postClickUpStartupComment({
+        clickupClient,
+        worktree,
+        taskId,
+        type: "blocker",
+        comment: buildClickUpStartupBlockerComment({ taskId, error })
+      });
     }
     if (!lastWebhookMs || !clickupClient?.getTaskComments) continue;
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defend-tech/opencode-optima",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "repository": {
     "type": "git",
     "url": "git+ssh://git@github.com/defend-tech/opencode-optima.git"