@mestreyoda/fabrica 0.2.36 → 0.2.37

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.37") {
+    return "0.2.37";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -148951,6 +148951,103 @@ async function checkProjects(dataDir) {
   return results;
 }
 
+// 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/observability/metrics.ts
 init_constants();
 import { readFile as readFile3 } from "node:fs/promises";
@@ -149533,6 +149630,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 });

package/package.json

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