@mestreyoda/fabrica 0.2.38 → 0.2.40

package/dist/index.js

@@ -113905,8 +113905,8 @@ import fsSync from "node:fs";
 import path5 from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function getCurrentVersion() {
-  if ("0.2.38") {
-    return "0.2.38";
+  if ("0.2.40") {
+    return "0.2.40";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -130510,6 +130510,10 @@ async function runIssueDoctor(opts) {
   const convergenceAction = issueRuntime?.lastConvergenceAction ?? null;
   const retryCount = issueRuntime?.lastConvergenceRetryCount ?? 0;
   const convergenceReason = issueRuntime?.lastConvergenceReason ?? issueRuntime?.inconclusiveCompletionReason ?? null;
+  const convergenceHeadSha = issueRuntime?.lastConvergenceHeadSha ?? null;
+  const currentHeadSha = issueRuntime?.currentPrHeadSha ?? issueRuntime?.lastHeadSha ?? prStatus?.sourceBranch ?? null;
+  const headShaChangedSinceLastConvergence = convergenceHeadSha && currentHeadSha ? convergenceHeadSha !== currentHeadSha : null;
+  const progressState = issueRuntime?.sessionCompletedAt ? "completed" : issueRuntime?.firstWorkerActivityAt ? "active" : issueRuntime?.agentAcceptedAt ? "accepted_idle" : "no_dispatch";
   const summaryParts = [
     hasArtifact ? "artifact_present" : "artifact_missing",
     convergenceCause ? `cause=${convergenceCause}` : "cause=none",
@@ -130531,12 +130535,22 @@ async function runIssueDoctor(opts) {
     issueId: opts.issueId,
     issueRuntime,
     hasArtifact,
+    lifecycle: {
+      dispatchCycleId: issueRuntime?.lastDispatchCycleId ?? null,
+      dispatchRunId: issueRuntime?.dispatchRunId ?? null,
+      agentAcceptedAt: issueRuntime?.agentAcceptedAt ?? null,
+      firstWorkerActivityAt: issueRuntime?.firstWorkerActivityAt ?? null,
+      sessionCompletedAt: issueRuntime?.sessionCompletedAt ?? null,
+      progressState
+    },
     convergence: {
       cause: convergenceCause,
       action: convergenceAction,
       retryCount,
       reason: convergenceReason,
-      at: issueRuntime?.lastConvergenceAt ?? null
+      at: issueRuntime?.lastConvergenceAt ?? null,
+      headSha: convergenceHeadSha,
+      headShaChangedSinceLastConvergence
     },
     pr: prStatus ? {
       url: prStatus.url ?? null,
@@ -130565,9 +130579,17 @@ function formatIssueDoctor(result) {
     `  PR: ${result.pr?.url ?? "n/a"} (${result.pr?.state ?? "unknown"})`,
     `  Issue: ${result.issue?.url ?? "n/a"} (${result.issue?.state ?? "unknown"})`,
     `  Labels: ${result.issue?.labels?.join(", ") ?? "n/a"}`,
+    `  Dispatch cycle: ${result.lifecycle.dispatchCycleId ?? "n/a"}`,
+    `  Dispatch run: ${result.lifecycle.dispatchRunId ?? "n/a"}`,
+    `  Progress state: ${result.lifecycle.progressState}`,
+    `  Agent accepted: ${result.lifecycle.agentAcceptedAt ?? "n/a"}`,
+    `  First worker activity: ${result.lifecycle.firstWorkerActivityAt ?? "n/a"}`,
+    `  Session completed: ${result.lifecycle.sessionCompletedAt ?? "n/a"}`,
     `  Convergence cause: ${result.convergence.cause ?? "none"}`,
     `  Convergence action: ${result.convergence.action ?? "none"}`,
     `  Retry count: ${result.convergence.retryCount}`,
+    `  Convergence head SHA: ${result.convergence.headSha ?? "n/a"}`,
+    `  Head SHA changed since last convergence: ${result.convergence.headShaChangedSinceLastConvergence == null ? "unknown" : result.convergence.headShaChangedSinceLastConvergence ? "yes" : "no"}`,
     `  Last reason: ${result.convergence.reason ?? "n/a"}`,
     `  Suggested next action: ${result.recommendation.likelyNextAction}`
   ];
@@ -131368,6 +131390,51 @@ init_workflow();
 init_context3();
 init_labels();
 
+// lib/services/doctor-snapshot.ts
+init_audit();
+async function captureIssueDoctorSnapshot(opts) {
+  try {
+    const result = await runIssueDoctor({
+      workspacePath: opts.workspaceDir,
+      projectSlug: opts.projectSlug,
+      issueId: opts.issueId,
+      runCommand: opts.runCommand,
+      pluginConfig: opts.pluginConfig
+    });
+    await log(opts.workspaceDir, opts.event, {
+      projectSlug: opts.projectSlug,
+      issueId: opts.issueId,
+      trigger: opts.trigger,
+      summary: result.recommendation.summary,
+      likelyNextAction: result.recommendation.likelyNextAction,
+      doctor: {
+        artifact: result.hasArtifact,
+        progressState: result.lifecycle.progressState,
+        dispatchCycleId: result.lifecycle.dispatchCycleId,
+        dispatchRunId: result.lifecycle.dispatchRunId,
+        prUrl: result.pr?.url ?? null,
+        prState: result.pr?.state ?? null,
+        labels: result.issue?.labels ?? [],
+        convergenceCause: result.convergence.cause,
+        convergenceAction: result.convergence.action,
+        convergenceRetryCount: result.convergence.retryCount,
+        convergenceHeadSha: result.convergence.headSha,
+        headShaChangedSinceLastConvergence: result.convergence.headShaChangedSinceLastConvergence
+      },
+      ...opts.extra ?? {}
+    });
+  } catch (error48) {
+    await log(opts.workspaceDir, `${opts.event}_failed`, {
+      projectSlug: opts.projectSlug,
+      issueId: opts.issueId,
+      trigger: opts.trigger,
+      error: error48 instanceof Error ? error48.message : String(error48),
+      ...opts.extra ?? {}
+    }).catch(() => {
+    });
+  }
+}
+
 // lib/services/post-pr-convergence.ts
 init_types3();
 function classifyConvergenceCause(reason) {
@@ -132032,6 +132099,23 @@ ${validationReason}`;
         lastConvergenceHeadSha: convergence.progressHeadSha
       }).catch(() => {
       });
+      if (convergenceIssueRuntime?.currentPrUrl || convergence.action === "escalate_human") {
+        await captureIssueDoctorSnapshot({
+          workspaceDir: opts.workspaceDir,
+          projectSlug: context2.projectSlug,
+          issueId: context2.issueId,
+          runCommand: opts.runCommand,
+          pluginConfig: opts.pluginConfig,
+          event: "doctor_snapshot",
+          trigger: convergence.action === "escalate_human" ? "worker_completion_escalated" : "worker_completion_blocked_with_artifact",
+          extra: {
+            convergenceCause: convergence.cause,
+            convergenceAction: convergence.action,
+            convergenceRetryCount: convergence.retryCount
+          }
+        }).catch(() => {
+        });
+      }
       await executeCompletion({
         workspaceDir: opts.workspaceDir,
         projectSlug: context2.projectSlug,
@@ -132719,6 +132803,22 @@ async function checkWorkerHealth(opts) {
               toLabel: convergence.targetLabel,
               deliveryState
             });
+            if (runCommand) {
+              await captureIssueDoctorSnapshot({
+                workspaceDir,
+                projectSlug,
+                issueId: issueIdNum,
+                runCommand,
+                event: "doctor_snapshot",
+                trigger: convergence.action === "escalate_human" ? "completion_recovery_escalated" : "completion_recovery_requeued",
+                extra: {
+                  convergenceCause: convergence.cause,
+                  convergenceAction: convergence.action,
+                  convergenceRetryCount: convergence.retryCount
+                }
+              }).catch(() => {
+              });
+            }
           }
         }
         fixes.push(fix);
@@ -133087,6 +133187,23 @@ async function checkWorkerHealth(opts) {
                 idleMinutes: Math.round(quietMinutes),
                 deliveryState
               });
+              if (runCommand) {
+                await captureIssueDoctorSnapshot({
+                  workspaceDir,
+                  projectSlug,
+                  issueId: issueIdNum,
+                  runCommand,
+                  event: "doctor_snapshot",
+                  trigger: convergence.action === "escalate_human" ? "stalled_with_artifact_escalated" : "stalled_with_artifact_requeued",
+                  extra: {
+                    convergenceCause: convergence.cause,
+                    convergenceAction: convergence.action,
+                    convergenceRetryCount: convergence.retryCount,
+                    idleMinutes: Math.round(quietMinutes)
+                  }
+                }).catch(() => {
+                });
+              }
             }
           }
           fixes.push(fix);
@@ -149107,12 +149224,29 @@ async function readAuditLines(filePath) {
   }
   return entries;
 }
+function keyFor(entry) {
+  const projectSlug = entry.projectSlug ?? entry.project ?? null;
+  const issueId = entry.issueId ?? entry.issue ?? null;
+  if (!projectSlug || issueId == null) return null;
+  return `${projectSlug}:${issueId}`;
+}
+function normalizeCause(entry) {
+  const cause = entry.convergenceCause ?? entry.reason ?? null;
+  return cause ? String(cause) : null;
+}
 async function computeMetrics(workspaceDir) {
   const auditLogPath = join4(workspaceDir, DATA_DIR, "log", "audit.log");
+  const bakEntries3 = await readAuditLines(`${auditLogPath}.3.bak`);
   const bakEntries2 = await readAuditLines(`${auditLogPath}.2.bak`);
   const bakEntries = await readAuditLines(`${auditLogPath}.bak`);
   const currentEntries = await readAuditLines(auditLogPath);
-  let entries = [...bakEntries2, ...bakEntries, ...currentEntries];
+  const entries = [...bakEntries3, ...bakEntries2, ...bakEntries, ...currentEntries];
+  const projectsData = await readProjects(workspaceDir).catch(() => ({ projects: {} }));
+  const stackByProject = /* @__PURE__ */ new Map();
+  for (const [slug, project] of Object.entries(projectsData.projects ?? {})) {
+    const stack = project.stack ?? project.environment?.stack ?? null;
+    if (stack) stackByProject.set(slug, String(stack));
+  }
   const entriesScanned = entries.length;
   let dispatches = 0;
   let completionsTotal = 0;
@@ -149122,16 +149256,40 @@ async function computeMetrics(workspaceDir) {
   let completionsOther = 0;
   let conflictsDetected = 0;
   let sessionBudgetResets = 0;
+  let humanEscalations = 0;
+  const causeCounts = {};
   const dispatchTimes = /* @__PURE__ */ new Map();
+  const firstPrTimes = /* @__PURE__ */ new Map();
   const completionDeltas = [];
+  const firstPrDeltas = [];
+  const stackMetrics = /* @__PURE__ */ new Map();
+  function stackBucket(entry) {
+    const slug = entry.projectSlug ?? entry.project ?? null;
+    const stack = entry.stack ?? (slug ? stackByProject.get(String(slug)) : null) ?? "unknown";
+    if (!stackMetrics.has(String(stack))) {
+      stackMetrics.set(String(stack), {
+        issues: /* @__PURE__ */ new Set(),
+        dispatches: 0,
+        escalations: 0,
+        causeCounts: {},
+        completionDeltas: [],
+        firstPrDeltas: []
+      });
+    }
+    return String(stack);
+  }
   for (const entry of entries) {
+    const issueKey = keyFor(entry);
+    const stack = stackBucket(entry);
+    const stackBucketState = stackMetrics.get(stack);
+    if (issueKey) stackBucketState.issues.add(issueKey);
     switch (entry.event) {
-      case "dispatch":
+      case "dispatch": {
         dispatches++;
-        if (entry.issue != null && entry.project) {
-          dispatchTimes.set(`${entry.project}:${entry.issue}`, Date.parse(entry.ts));
-        }
+        stackBucketState.dispatches++;
+        if (issueKey) dispatchTimes.set(issueKey, Date.parse(entry.ts));
         break;
+      }
       case "work_finish": {
         completionsTotal++;
         const result = String(entry.result ?? "");
@@ -149139,14 +149297,13 @@ async function computeMetrics(workspaceDir) {
         else if (result === "pass") completionsPass++;
         else if (result === "fail") completionsFail++;
         else completionsOther++;
-        if (entry.issue != null && entry.project) {
-          const key = `${entry.project}:${entry.issue}`;
-          const dispatchTime = dispatchTimes.get(key);
-          if (dispatchTime !== void 0) {
-            const completionTime = Date.parse(entry.ts);
-            if (!isNaN(completionTime) && completionTime > dispatchTime) {
-              completionDeltas.push((completionTime - dispatchTime) / 6e4);
-            }
+        if (issueKey) {
+          const dispatchTime = dispatchTimes.get(issueKey);
+          const completionTime = Date.parse(entry.ts);
+          if (dispatchTime !== void 0 && !Number.isNaN(completionTime) && completionTime > dispatchTime) {
+            const delta = (completionTime - dispatchTime) / 6e4;
+            completionDeltas.push(delta);
+            stackBucketState.completionDeltas.push(delta);
           }
         }
         break;
@@ -149160,9 +149317,47 @@ async function computeMetrics(workspaceDir) {
       case "session_budget_reset":
         sessionBudgetResets++;
         break;
+      case "pr_discovered_via_polling":
+      case "pr_updated_via_polling": {
+        if (issueKey && !firstPrTimes.has(issueKey)) {
+          const prTime = Date.parse(entry.ts);
+          const dispatchTime = dispatchTimes.get(issueKey);
+          firstPrTimes.set(issueKey, prTime);
+          if (dispatchTime !== void 0 && !Number.isNaN(prTime) && prTime > dispatchTime) {
+            const delta = (prTime - dispatchTime) / 6e4;
+            firstPrDeltas.push(delta);
+            stackBucketState.firstPrDeltas.push(delta);
+          }
+        }
+        break;
+      }
+      case "worker_completion_skipped":
+      case "doctor_snapshot":
+      case "health_fix_applied": {
+        const cause = normalizeCause(entry);
+        if (cause) {
+          causeCounts[cause] = (causeCounts[cause] ?? 0) + 1;
+          stackBucketState.causeCounts[cause] = (stackBucketState.causeCounts[cause] ?? 0) + 1;
+        }
+        if (entry.convergenceAction === "escalate_human" || entry.action === "escalate_human") {
+          humanEscalations++;
+          stackBucketState.escalations++;
+        }
+        break;
+      }
     }
   }
-  const avgDispatchToCompletionMinutes = completionDeltas.length > 0 ? completionDeltas.reduce((a, b) => a + b, 0) / completionDeltas.length : null;
+  const avg = (values) => values.length ? values.reduce((a, b) => a + b, 0) / values.length : null;
+  const stackMetricsObject = Object.fromEntries(
+    [...stackMetrics.entries()].map(([stack, data]) => [stack, {
+      issues: data.issues.size,
+      dispatches: data.dispatches,
+      escalations: data.escalations,
+      causeCounts: data.causeCounts,
+      avgDispatchToCompletionMinutes: avg(data.completionDeltas),
+      avgDispatchToFirstPrMinutes: avg(data.firstPrDeltas)
+    }])
+  );
   return {
     entriesScanned,
     dispatches,
@@ -149173,28 +149368,40 @@ async function computeMetrics(workspaceDir) {
       fail: completionsFail,
       other: completionsOther
     },
-    avgDispatchToCompletionMinutes,
+    avgDispatchToCompletionMinutes: avg(completionDeltas),
+    avgDispatchToFirstPrMinutes: avg(firstPrDeltas),
     conflictsDetected,
     sessionBudgetResets,
+    humanEscalations,
+    causeCounts,
+    stackMetrics: stackMetricsObject,
     auditLogPath
   };
 }
 function formatMetrics(metrics2) {
   const lines = [
-    `Fabrica \u2014 Metricas (${metrics2.entriesScanned} entradas do audit.log)`,
+    `Fabrica \u2014 M\xE9tricas (${metrics2.entriesScanned} entradas do audit.log)`,
     `  Dispatches: ${metrics2.dispatches}`
   ];
   const c = metrics2.completions;
-  lines.push(
-    `  Conclusoes: ${c.total} (done: ${c.done}, pass: ${c.pass}, fail: ${c.fail}${c.other > 0 ? `, other: ${c.other}` : ""})`
-  );
-  if (metrics2.avgDispatchToCompletionMinutes !== null) {
-    lines.push(`  Tempo medio dispatch \u2192 completion: ${metrics2.avgDispatchToCompletionMinutes.toFixed(1)} min`);
-  } else {
-    lines.push(`  Tempo medio dispatch \u2192 completion: n/a`);
-  }
+  lines.push(`  Conclus\xF5es: ${c.total} (done: ${c.done}, pass: ${c.pass}, fail: ${c.fail}${c.other > 0 ? `, other: ${c.other}` : ""})`);
+  lines.push(`  Tempo m\xE9dio dispatch \u2192 completion: ${metrics2.avgDispatchToCompletionMinutes?.toFixed(1) ?? "n/a"} min`);
+  lines.push(`  Tempo m\xE9dio dispatch \u2192 primeira PR: ${metrics2.avgDispatchToFirstPrMinutes?.toFixed(1) ?? "n/a"} min`);
   lines.push(`  Conflitos detectados: ${metrics2.conflictsDetected}`);
   lines.push(`  Session budget resets: ${metrics2.sessionBudgetResets}`);
+  lines.push(`  Escalonamentos humanos: ${metrics2.humanEscalations}`);
+  if (Object.keys(metrics2.causeCounts).length > 0) {
+    lines.push("  Causas tipadas:");
+    for (const [cause, count] of Object.entries(metrics2.causeCounts).sort((a, b) => b[1] - a[1])) {
+      lines.push(`    - ${cause}: ${count}`);
+    }
+  }
+  if (Object.keys(metrics2.stackMetrics).length > 0) {
+    lines.push("  Por stack:");
+    for (const [stack, data] of Object.entries(metrics2.stackMetrics)) {
+      lines.push(`    - ${stack}: issues=${data.issues}, dispatches=${data.dispatches}, escalations=${data.escalations}, avgPR=${data.avgDispatchToFirstPrMinutes?.toFixed(1) ?? "n/a"}m, avgDone=${data.avgDispatchToCompletionMinutes?.toFixed(1) ?? "n/a"}m`);
+    }
+  }
   return lines.join("\n");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mestreyoda/fabrica",
-  "version": "0.2.38",
+  "version": "0.2.40",
   "description": "Autonomous software engineering pipeline for OpenClaw. Turns ideas into deployed code via intake, dispatch, review, test, and merge.",
   "type": "module",
   "main": "./dist/index.js",