@mestreyoda/fabrica 0.2.36 → 0.2.38

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.36") {
-    return "0.2.36";
+  if ("0.2.38") {
+    return "0.2.38";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -130477,6 +130477,135 @@ function createProjectStatusTool(ctx) {
   });
 }
 
+// lib/setup/doctor-run.ts
+async function runIssueDoctor(opts) {
+  const data = await readProjects(opts.workspacePath);
+  const project = data.projects[opts.projectSlug];
+  if (!project) throw new Error(`Project not found: ${opts.projectSlug}`);
+  const issueRuntime = getIssueRuntime(project, opts.issueId) ?? null;
+  const hasArtifact = Boolean(
+    issueRuntime?.currentPrUrl || issueRuntime?.currentPrNumber || issueRuntime?.artifactOfRecord
+  );
+  const { provider } = await createProvider({
+    repo: project.repo,
+    provider: project.provider,
+    providerProfile: project.providerProfile,
+    runCommand: opts.runCommand,
+    pluginConfig: opts.pluginConfig
+  });
+  let prStatus = null;
+  try {
+    const pr = await provider.getPrStatus(opts.issueId);
+    if (pr.url || pr.number) prStatus = pr;
+  } catch {
+    prStatus = null;
+  }
+  let issue2 = null;
+  try {
+    issue2 = await provider.getIssue(opts.issueId);
+  } catch {
+    issue2 = null;
+  }
+  const convergenceCause = issueRuntime?.lastConvergenceCause ?? null;
+  const convergenceAction = issueRuntime?.lastConvergenceAction ?? null;
+  const retryCount = issueRuntime?.lastConvergenceRetryCount ?? 0;
+  const convergenceReason = issueRuntime?.lastConvergenceReason ?? issueRuntime?.inconclusiveCompletionReason ?? null;
+  const summaryParts = [
+    hasArtifact ? "artifact_present" : "artifact_missing",
+    convergenceCause ? `cause=${convergenceCause}` : "cause=none",
+    convergenceAction ? `action=${convergenceAction}` : "action=none",
+    retryCount ? `retries=${retryCount}` : "retries=0",
+    prStatus?.state ? `pr=${prStatus.state}` : "pr=unknown"
+  ];
+  const likelyNextAction = (() => {
+    if (convergenceAction === "escalate_human") return "human_intervention";
+    if (convergenceCause === "invalid_qa_evidence") return "repair_qa_evidence";
+    if (convergenceCause === "merge_conflict") return "repair_merge_conflict";
+    if (convergenceCause === "stalled_with_artifact") return "force_convergence_review";
+    if (hasArtifact) return "post_pr_convergence";
+    return "redispatch_or_investigate";
+  })();
+  return {
+    projectSlug: project.slug,
+    projectName: project.name,
+    issueId: opts.issueId,
+    issueRuntime,
+    hasArtifact,
+    convergence: {
+      cause: convergenceCause,
+      action: convergenceAction,
+      retryCount,
+      reason: convergenceReason,
+      at: issueRuntime?.lastConvergenceAt ?? null
+    },
+    pr: prStatus ? {
+      url: prStatus.url ?? null,
+      state: prStatus.state ?? null,
+      number: prStatus.number ?? null,
+      mergeable: prStatus.mergeable ?? null,
+      currentIssueMatch: prStatus.currentIssueMatch ?? null,
+      sourceBranch: prStatus.sourceBranch ?? null
+    } : null,
+    issue: issue2 ? {
+      url: issue2.web_url ?? null,
+      state: issue2.state ?? null,
+      labels: issue2.labels ?? [],
+      title: issue2.title ?? null
+    } : null,
+    recommendation: {
+      summary: summaryParts.join(" | "),
+      likelyNextAction
+    }
+  };
+}
+function formatIssueDoctor(result) {
+  const lines = [
+    `Issue run doctor \u2014 ${result.projectSlug}#${result.issueId}`,
+    `  Artifact: ${result.hasArtifact ? "yes" : "no"}`,
+    `  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"}`,
+    `  Convergence cause: ${result.convergence.cause ?? "none"}`,
+    `  Convergence action: ${result.convergence.action ?? "none"}`,
+    `  Retry count: ${result.convergence.retryCount}`,
+    `  Last reason: ${result.convergence.reason ?? "n/a"}`,
+    `  Suggested next action: ${result.recommendation.likelyNextAction}`
+  ];
+  return lines.join("\n");
+}
+
+// lib/tools/admin/doctor-issue.ts
+function createDoctorIssueTool(ctx) {
+  return (toolCtx) => ({
+    name: "doctor_issue",
+    label: "Doctor Issue",
+    description: "Inspect one Fabrica issue/run with convergence metadata, PR context, issue labels, and a recommended next action.",
+    parameters: {
+      type: "object",
+      required: ["projectSlug", "issueId"],
+      properties: {
+        projectSlug: { type: "string", description: "Project slug (for example: fabrica or my-project)." },
+        issueId: { type: "number", description: "Issue number to inspect." }
+      }
+    },
+    async execute(_id, params) {
+      const workspaceDir = requireWorkspaceDir(toolCtx);
+      const projectSlug = String(params.projectSlug ?? "").trim();
+      const issueId = Number(params.issueId);
+      if (!projectSlug) throw new Error("projectSlug is required");
+      if (!Number.isFinite(issueId)) throw new Error("issueId must be a number");
+      const result = await runIssueDoctor({
+        workspacePath: workspaceDir,
+        projectSlug,
+        issueId,
+        runCommand: ctx.runCommand,
+        pluginConfig: ctx.pluginConfig
+      });
+      return jsonResult(result);
+    }
+  });
+}
+
 // lib/tools/admin/project-register.ts
 import fs24 from "node:fs/promises";
 import path24 from "node:path";
@@ -131291,9 +131420,12 @@ function decidePostPrConvergence(params) {
   const { workflow, issueRuntime, reason, feedbackQueueLabel } = params;
   const cause = classifyConvergenceCause(reason);
   const hasArtifact = hasReviewableArtifact(issueRuntime);
+  const progressHeadSha = issueRuntime?.currentPrHeadSha ?? issueRuntime?.lastHeadSha ?? issueRuntime?.artifactOfRecord?.headSha ?? null;
   const previousCause = issueRuntime?.lastConvergenceCause ?? null;
   const previousCount = issueRuntime?.lastConvergenceRetryCount ?? 0;
-  const retryCount = previousCause === cause ? previousCount + 1 : 1;
+  const previousHeadSha = issueRuntime?.lastConvergenceHeadSha ?? null;
+  const sameHeadSha = !progressHeadSha || !previousHeadSha ? true : progressHeadSha === previousHeadSha;
+  const retryCount = previousCause === cause && sameHeadSha ? previousCount + 1 : 1;
   const maxRetries = getConvergenceRetryBudget(cause);
   const holdLabel = getPreferredHoldLabel(workflow);
   const shouldEscalate = hasArtifact && retryCount > maxRetries && Boolean(holdLabel);
@@ -131303,7 +131435,8 @@ function decidePostPrConvergence(params) {
     targetLabel: shouldEscalate ? holdLabel ?? feedbackQueueLabel : feedbackQueueLabel,
     retryCount,
     maxRetries,
-    hasArtifact
+    hasArtifact,
+    progressHeadSha
   };
 }
 
@@ -131895,7 +132028,8 @@ ${validationReason}`;
         lastConvergenceAction: convergence.action,
         lastConvergenceRetryCount: convergence.retryCount,
         lastConvergenceReason: validationReason,
-        lastConvergenceAt: (/* @__PURE__ */ new Date()).toISOString()
+        lastConvergenceAt: (/* @__PURE__ */ new Date()).toISOString(),
+        lastConvergenceHeadSha: convergence.progressHeadSha
       }).catch(() => {
       });
       await executeCompletion({
@@ -132021,7 +132155,8 @@ ${validationReason}`;
       lastConvergenceAction: null,
       lastConvergenceRetryCount: 0,
       lastConvergenceReason: null,
-      lastConvergenceAt: null
+      lastConvergenceAt: null,
+      lastConvergenceHeadSha: null
     }).catch(() => {
     });
   } else {
@@ -132032,7 +132167,8 @@ ${validationReason}`;
       lastConvergenceAction: null,
       lastConvergenceRetryCount: 0,
       lastConvergenceReason: null,
-      lastConvergenceAt: null
+      lastConvergenceAt: null,
+      lastConvergenceHeadSha: null
     }).catch(() => {
     });
   }
@@ -132555,7 +132691,8 @@ async function checkWorkerHealth(opts) {
               lastConvergenceAction: convergence.action,
               lastConvergenceRetryCount: convergence.retryCount,
               lastConvergenceReason: inconclusiveReason,
-              lastConvergenceAt: (/* @__PURE__ */ new Date()).toISOString()
+              lastConvergenceAt: (/* @__PURE__ */ new Date()).toISOString(),
+              lastConvergenceHeadSha: convergence.progressHeadSha
             }).catch(() => {
             });
             fix.fixed = true;
@@ -132938,7 +133075,8 @@ async function checkWorkerHealth(opts) {
                 lastConvergenceAction: convergence.action,
                 lastConvergenceRetryCount: convergence.retryCount,
                 lastConvergenceReason: "stalled_with_artifact",
-                lastConvergenceAt: (/* @__PURE__ */ new Date()).toISOString()
+                lastConvergenceAt: (/* @__PURE__ */ new Date()).toISOString(),
+                lastConvergenceHeadSha: convergence.progressHeadSha
               }).catch(() => {
               });
               fix.fixed = true;
@@ -149533,6 +149671,26 @@ function registerCli(program, ctx) {
   ${result.checks.length} checks: ${result.errors} errors, ${result.warnings} warnings`);
     process.exit(result.errors > 0 ? 1 : 0);
   });
+  doctor.command("issue").description("Inspect one Fabrica issue/run with convergence and PR context").requiredOption("-p, --project <slug>", "Project slug").requiredOption("-i, --issue <id>", "Issue number").option("-w, --workspace <path>", "Workspace directory").option("--json", "Emit machine-readable JSON").action(async (opts) => {
+    const workspaceDir = requireWorkspaceDir2(ctx.runtime, opts.workspace);
+    const issueId = Number.parseInt(String(opts.issue), 10);
+    if (!Number.isFinite(issueId)) {
+      console.error(`Invalid issue id: ${opts.issue}`);
+      process.exit(1);
+    }
+    const result = await runIssueDoctor({
+      workspacePath: workspaceDir,
+      projectSlug: String(opts.project),
+      issueId,
+      runCommand: ctx.runCommand,
+      pluginConfig: ctx.pluginConfig
+    });
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(formatIssueDoctor(result));
+  });
   doctor.option("-w, --workspace <path>", "Workspace directory").option("--fix", "Apply fixes for detected issues").action(async (opts) => {
     const workspaceDir = requireWorkspaceDir2(ctx.runtime, opts.workspace);
     const result = await runDoctor({ workspacePath: workspaceDir, fix: opts.fix ?? false, pluginConfig: ctx.pluginConfig });
@@ -150903,6 +151061,7 @@ var plugin = {
     api.registerTool(createTaskListTool(ctx), { names: ["task_list"] });
     api.registerTool(createTasksStatusTool(ctx), { names: ["tasks_status"] });
     api.registerTool(createProjectStatusTool(ctx), { names: ["project_status"] });
+    api.registerTool(createDoctorIssueTool(ctx), { names: ["doctor_issue"] });
     api.registerTool(createProjectRegisterTool(ctx), { names: ["project_register"] });
     api.registerTool(createHealthTool(ctx), { names: ["health"] });
     api.registerTool(createSyncLabelsTool(ctx), { names: ["sync_labels"] });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mestreyoda/fabrica",
-  "version": "0.2.36",
+  "version": "0.2.38",
   "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",