claude-teammate 0.1.13 → 0.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-teammate",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "CLI bootstrapper for Claude Teammate.",
   "license": "MIT",
   "type": "module",

package/src/commands/worker.js

@@ -32,6 +32,7 @@ import {
   listMissingRepoPaths,
   parseGitHubRepoUrl,
   prepareRepoForBranch,
+  RepoCheckoutNotReadyError,
   validateOrEnsureLocalRepo
 } from "../repo.js";
 import {
@@ -206,7 +207,18 @@ export async function runWorkerCommand({ projectRoot }) {
       let trackedIssueCount = 0;
 
       for (const repo of repos) {
-        repo.local_path = await validateOrEnsureLocalRepo(repo.url, runtimePaths.reposDir, repo.local_path);
+        try {
+          repo.local_path = await validateOrEnsureLocalRepo(repo.url, runtimePaths.reposDir, repo.local_path);
+        } catch (error) {
+          if (isRepoCheckoutNotReadyError(error)) {
+            await logger.info("Skipping GitHub repo until checkout is ready", {
+              repo: repo.url,
+              localPath: error.localPath || repo.local_path
+            });
+            continue;
+          }
+          throw error;
+        }
         const issues = await github.listIssues(repo.url);
         const botIssues = issues.filter((issue) => isGitHubBotAuthor(issue.author, githubBotUser));
         trackedIssueCount += botIssues.length;
@@ -258,7 +270,18 @@ export async function runWorkerCommand({ projectRoot }) {
       let trackedPrCount = 0;
 
       for (const repo of repos) {
-        repo.local_path = await validateOrEnsureLocalRepo(repo.url, runtimePaths.reposDir, repo.local_path);
+        try {
+          repo.local_path = await validateOrEnsureLocalRepo(repo.url, runtimePaths.reposDir, repo.local_path);
+        } catch (error) {
+          if (isRepoCheckoutNotReadyError(error)) {
+            await logger.info("Skipping draft PR repo until checkout is ready", {
+              repo: repo.url,
+              localPath: error.localPath || repo.local_path
+            });
+            continue;
+          }
+          throw error;
+        }
 
         const pullRequests = await github.listPullRequests(repo.url);
         const botPullRequests = pullRequests.filter(
@@ -403,7 +426,22 @@ async function processJiraIssue({ issue, jira, github, botUser, config, projectR
 
     let repoCheckoutUpdated = false;
     for (const repo of epicMemory.repos) {
-      const validatedLocalPath = await validateOrEnsureLocalRepo(repo.url, runtimePaths.reposDir, repo.local_path);
+      let validatedLocalPath;
+      try {
+        validatedLocalPath = await validateOrEnsureLocalRepo(repo.url, runtimePaths.reposDir, repo.local_path);
+      } catch (error) {
+        if (isRepoCheckoutNotReadyError(error)) {
+          issueMemory.last_error = `Repository checkout is not ready yet for ${repo.url}. The worker will retry automatically.`;
+          issueMemory = await saveIssueMemory(issueMemoryRecord.filePath, detail, issueMemory);
+          await logger.info("Skipping Jira issue until checkout is ready", {
+            issue: detail.key,
+            repo: repo.url,
+            localPath: error.localPath || repo.local_path
+          });
+          return buildIssueState(detail, epicMemory, issueMemory, null, issueMemory.last_error);
+        }
+        throw error;
+      }
       if (validatedLocalPath !== repo.local_path) {
         repo.local_path = validatedLocalPath;
         repoCheckoutUpdated = true;
@@ -2234,6 +2272,17 @@ function normalizeRepoAlias(value) {
   return String(value || "").trim().toLowerCase();
 }
 
+function isRepoCheckoutNotReadyError(error) {
+  return Boolean(
+    error &&
+    typeof error === "object" &&
+    (
+      error instanceof RepoCheckoutNotReadyError ||
+      error.code === "REPO_CHECKOUT_NOT_READY"
+    )
+  );
+}
+
 function normalizeRepoRelativePath(value) {
   const normalized = String(value || "").trim().replace(/^\/+/u, "").replace(/\/+$/u, "");
   if (!normalized || normalized.startsWith("http://") || normalized.startsWith("https://")) {

package/src/repo.js

@@ -1,4 +1,4 @@
-import { access, mkdir } from "node:fs/promises";
+import { access, mkdir, readdir } from "node:fs/promises";
 import path from "node:path";
 import { execFile } from "node:child_process";
 import process from "node:process";
@@ -6,6 +6,16 @@ import { promisify } from "node:util";
 
 const execFileAsync = promisify(execFile);
 
+export class RepoCheckoutNotReadyError extends Error {
+  constructor(message, details = {}) {
+    super(message);
+    this.name = "RepoCheckoutNotReadyError";
+    this.code = "REPO_CHECKOUT_NOT_READY";
+    this.repoUrl = details.repoUrl || "";
+    this.localPath = details.localPath || "";
+  }
+}
+
 export async function ensureLocalRepo(repoUrl, reposDir) {
   const repo = parseGitHubRepoUrl(repoUrl);
   const checkoutPath = path.join(reposDir, repo.owner, repo.name);
@@ -28,6 +38,19 @@ export async function validateOrEnsureLocalRepo(repoUrl, reposDir, localPath = "
     return candidatePath;
   }
 
+  if (candidatePath && await pathExists(candidatePath)) {
+    const entries = await safeReadDir(candidatePath);
+    if (entries.length > 0) {
+      throw new RepoCheckoutNotReadyError(
+        `Repository checkout is not ready yet at ${candidatePath}.`,
+        {
+          repoUrl,
+          localPath: candidatePath
+        }
+      );
+    }
+  }
+
   return ensureLocalRepo(repoUrl, reposDir);
 }
 
@@ -114,6 +137,14 @@ async function pathExists(targetPath) {
   }
 }
 
+async function safeReadDir(targetPath) {
+  try {
+    return await readdir(targetPath);
+  } catch {
+    return [];
+  }
+}
+
 async function isUsableGitCheckout(repoPath) {
   if (!repoPath) {
     return false;