@gr8ful/spf 0.11.0 → 0.11.1

package/dist/core/issues/bitbucket_provider.d.ts

@@ -1,21 +1,3 @@
-/**
- * Bitbucket Cloud REST API v2.0 implementation of `CodeHostProvider` —
- * `spf watch`'s PR seam, not its tracker seam (see `provider.ts`'s module
- * comment): this class never touches issues/labels, so it's paired with an
- * `IssueProvider` (`github_provider.ts` or `jira_provider.ts`) at the CLI
- * layer.
- *
- * Auth is HTTP Basic with an Atlassian account email + API token
- * (`BITBUCKET_EMAIL` / `BITBUCKET_API_TOKEN`) — verified directly against
- * Atlassian's current docs before writing this, not assumed from training
- * data: Bitbucket Cloud app passwords are being fully removed (brownout
- * window closes July 28, 2026), so this project only supports the
- * replacement — API tokens, same auth shape as `jira_provider.ts`.
- *
- * `repo` is `"workspace/repo_slug"` (Bitbucket's own two-part identifier),
- * the same config field GitHub uses for `"owner/name"` — the shape just
- * means something different per `code_host`.
- */
 import type { CodeHostProvider, PrRef, PrStatus } from "./provider.ts";
 export declare class BitbucketProvider implements CodeHostProvider {
     private readonly email;

package/dist/core/issues/bitbucket_provider.js

@@ -1,3 +1,22 @@
+/**
+ * Bitbucket Cloud REST API v2.0 implementation of `CodeHostProvider` —
+ * `spf watch`'s PR seam, not its tracker seam (see `provider.ts`'s module
+ * comment): this class never touches issues/labels, so it's paired with an
+ * `IssueProvider` (`github_provider.ts` or `jira_provider.ts`) at the CLI
+ * layer.
+ *
+ * Auth is HTTP Basic with an Atlassian account email + API token
+ * (`BITBUCKET_EMAIL` / `BITBUCKET_API_TOKEN`) — verified directly against
+ * Atlassian's current docs before writing this, not assumed from training
+ * data: Bitbucket Cloud app passwords are being fully removed (brownout
+ * window closes July 28, 2026), so this project only supports the
+ * replacement — API tokens, same auth shape as `jira_provider.ts`.
+ *
+ * `repo` is `"workspace/repo_slug"` (Bitbucket's own two-part identifier),
+ * the same config field GitHub uses for `"owner/name"` — the shape just
+ * means something different per `code_host`.
+ */
+import { fetchRetryTransient } from "../utils.js";
 const API = "https://api.bitbucket.org/2.0";
 export class BitbucketProvider {
     email;
@@ -15,7 +34,7 @@ export class BitbucketProvider {
         this.repoSlug = repoSlug;
     }
     async bb(path, init) {
-        const response = await fetch(`${API}${path}`, {
+        const response = await fetchRetryTransient(`${API}${path}`, {
             ...init,
             headers: {
                 Authorization: `Basic ${Buffer.from(`${this.email}:${this.apiToken}`).toString("base64")}`,

package/dist/core/issues/jira_provider.js

@@ -1,3 +1,4 @@
+import { fetchRetryTransient } from "../utils.js";
 const STATES = [
     "ready",
     "working",
@@ -65,7 +66,7 @@ export class JiraProvider {
         const debug = Boolean(process.env["SPF_JIRA_DEBUG"]);
         if (debug)
             console.error(`[jira debug] ${init?.method ?? "GET"} ${this.baseUrl}${path} body=${init?.body ?? "(none)"}`);
-        const response = await fetch(`${this.baseUrl}${path}`, {
+        const response = await fetchRetryTransient(`${this.baseUrl}${path}`, {
             ...init,
             headers: {
                 Authorization: this.authHeader(),
@@ -139,7 +140,7 @@ export class JiraProvider {
      * never discovers it from the issue body itself.
      */
     async getIssue(id) {
-        const response = await fetch(`${this.baseUrl}/rest/api/3/issue/${id}?fields=summary,description,labels`, {
+        const response = await fetchRetryTransient(`${this.baseUrl}/rest/api/3/issue/${id}?fields=summary,description,labels`, {
             headers: { Authorization: this.authHeader(), Accept: "application/json" },
         });
         if (response.status === 404)

package/dist/core/utils.d.ts

@@ -19,6 +19,18 @@ import path from "node:path";
  */
 export declare function operatorEnv(): Record<string, string>;
 export declare function newId(length?: number): string;
+/**
+ * `fetch`, but a transport-level blip on the FIRST attempt gets one silent
+ * retry before it's allowed to throw. Node's global `fetch` (undici) pools
+ * keep-alive connections across calls; Atlassian's Cloud APIs (Jira,
+ * Bitbucket) close idle ones from their end, which surfaces here as
+ * `ECONNRESET` the next time a long-lived poller (`spf watch`) reuses one —
+ * a stale-socket race, not a real problem with the request. Only retries
+ * error codes that mean "the transport failed," never an HTTP error status
+ * (a 4xx/5xx response is not a thrown error here, and must keep surfacing
+ * on the first attempt so callers see it immediately).
+ */
+export declare function fetchRetryTransient(input: string, init?: RequestInit): Promise<Response>;
 /** Matches Python's `datetime.now(timezone.utc).isoformat(timespec="milliseconds")`. */
 export declare function nowIso(): string;
 export declare function ensureDir(dirPath: string): string;

package/dist/core/utils.js

@@ -31,6 +31,30 @@ export function operatorEnv() {
 export function newId(length = 8) {
     return randomBytes(Math.floor(length / 2)).toString("hex");
 }
+/** Transport-level blips worth one silent retry — see `fetchRetryTransient` below. */
+const TRANSIENT_FETCH_CODES = new Set(["ECONNRESET", "ETIMEDOUT", "EPIPE", "ECONNREFUSED", "EAI_AGAIN"]);
+/**
+ * `fetch`, but a transport-level blip on the FIRST attempt gets one silent
+ * retry before it's allowed to throw. Node's global `fetch` (undici) pools
+ * keep-alive connections across calls; Atlassian's Cloud APIs (Jira,
+ * Bitbucket) close idle ones from their end, which surfaces here as
+ * `ECONNRESET` the next time a long-lived poller (`spf watch`) reuses one —
+ * a stale-socket race, not a real problem with the request. Only retries
+ * error codes that mean "the transport failed," never an HTTP error status
+ * (a 4xx/5xx response is not a thrown error here, and must keep surfacing
+ * on the first attempt so callers see it immediately).
+ */
+export async function fetchRetryTransient(input, init) {
+    try {
+        return await fetch(input, init);
+    }
+    catch (error) {
+        const code = error.cause?.code;
+        if (!code || !TRANSIENT_FETCH_CODES.has(code))
+            throw error;
+        return await fetch(input, init);
+    }
+}
 /** Matches Python's `datetime.now(timezone.utc).isoformat(timespec="milliseconds")`. */
 export function nowIso() {
     const iso = new Date().toISOString(); // e.g. 2024-01-01T12:00:00.123Z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gr8ful/spf",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Super Portable Factory — a global CLI for repeatable agents-plus-code workflows (ADWs)",
   "type": "module",
   "license": "MIT",