@m8i-51/shoal 0.1.11 → 0.1.12

package/framework/trackers/asana.ts

@@ -2,6 +2,7 @@ import type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
 
 export class AsanaTracker implements IssueTracker {
   readonly name = "asana";
+  readonly isEmpty = false;
   private token: string;
   private projectId: string;
 
@@ -30,15 +31,19 @@ export class AsanaTracker implements IssueTracker {
         },
       }),
     });
+    if (!res.ok) {
+      const msg = await res.text().catch(() => "");
+      console.error(`[asana] failed to create task (${res.status}): ${msg.slice(0, 200)}`);
+      return null;
+    }
     const data = await res.json() as {
       data?: { gid: string; permalink_url?: string };
-      errors?: { message: string }[];
     };
-    if (!res.ok) {
-      console.error(`[asana] failed to create task (${res.status}): ${JSON.stringify(data.errors)}`);
+    if (!data.data?.gid) {
+      console.error("[asana] create task response missing gid");
       return null;
     }
-    const url = data.data?.permalink_url ?? `https://app.asana.com/0/${this.projectId}/${data.data?.gid}`;
+    const url = data.data.permalink_url ?? `https://app.asana.com/0/${this.projectId}/${data.data.gid}`;
     console.log(`[asana] task created: ${url}`);
     return url;
   }

package/framework/trackers/backlog.ts

@@ -2,6 +2,7 @@ import type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
 
 export class BacklogTracker implements IssueTracker {
   readonly name = "backlog";
+  readonly isEmpty = false;
   private baseUrl: string;
   private apiKey: string;
   private projectId: number;
@@ -30,9 +31,14 @@ export class BacklogTracker implements IssueTracker {
       headers: { "Content-Type": "application/x-www-form-urlencoded" },
       body: form,
     });
-    const data = await res.json() as { issueKey?: string; message?: string };
     if (!res.ok) {
-      console.error(`[backlog] failed to create issue (${res.status}): ${data.message}`);
+      const msg = await res.text().catch(() => "");
+      console.error(`[backlog] failed to create issue (${res.status}): ${msg.slice(0, 200)}`);
+      return null;
+    }
+    const data = await res.json() as { issueKey?: string };
+    if (!data.issueKey) {
+      console.error("[backlog] create issue response missing issueKey");
       return null;
     }
     const url = `${this.baseUrl}/view/${data.issueKey}`;

package/framework/trackers/github.ts

@@ -3,6 +3,7 @@ import { postGitHubIssue, fetchOpenIssues as ghFetchOpen, fetchClosedIssues as g
 
 export class GitHubTracker implements IssueTracker {
   readonly name = "github";
+  readonly isEmpty = false;
   private opts: { token: string; repo: string };
 
   constructor(token: string, repo: string) {

package/framework/trackers/index.ts

@@ -21,18 +21,28 @@ export class AggregatedTracker implements IssueTracker {
 
   async createIssue(title: string, body: string, labels: string[]): Promise<string | null> {
     if (this.trackers.length === 0) return null;
-    const urls = await Promise.all(this.trackers.map((t) => t.createIssue(title, body, labels)));
-    return urls.find((u) => u !== null) ?? null;
+    const results = await Promise.allSettled(this.trackers.map((t) => t.createIssue(title, body, labels)));
+    for (const r of results) {
+      if (r.status === "rejected") console.error("[trackers] createIssue error:", r.reason);
+    }
+    const urls = results.filter((r): r is PromiseFulfilledResult<string | null> => r.status === "fulfilled");
+    return urls.map((r) => r.value).find((u) => u !== null) ?? null;
   }
 
   async fetchOpenIssues(): Promise<OpenIssue[]> {
-    const results = await Promise.all(this.trackers.map((t) => t.fetchOpenIssues()));
-    return results.flat();
+    const results = await Promise.allSettled(this.trackers.map((t) => t.fetchOpenIssues()));
+    return results.flatMap((r) => {
+      if (r.status === "rejected") { console.error("[trackers] fetchOpenIssues error:", r.reason); return []; }
+      return r.value;
+    });
   }
 
   async fetchClosedIssues(): Promise<ClosedIssue[]> {
-    const results = await Promise.all(this.trackers.map((t) => t.fetchClosedIssues()));
-    return results.flat();
+    const results = await Promise.allSettled(this.trackers.map((t) => t.fetchClosedIssues()));
+    return results.flatMap((r) => {
+      if (r.status === "rejected") { console.error("[trackers] fetchClosedIssues error:", r.reason); return []; }
+      return r.value;
+    });
   }
 }
 
@@ -87,8 +97,8 @@ export function buildTrackers(): AggregatedTracker {
       case "backlog": {
         const space = process.env.BACKLOG_SPACE ?? "";
         const apiKey = process.env.BACKLOG_API_KEY ?? "";
-        const projectId = parseInt(process.env.BACKLOG_PROJECT_ID ?? "0", 10);
-        if (space && apiKey && projectId) {
+        const projectId = parseInt(process.env.BACKLOG_PROJECT_ID ?? "", 10);
+        if (space && apiKey && !isNaN(projectId)) {
           trackers.push(new BacklogTracker(space, apiKey, projectId));
         } else {
           console.warn("[trackers] backlog: BACKLOG_SPACE / BACKLOG_API_KEY / BACKLOG_PROJECT_ID required, skipping");

package/framework/trackers/jira.ts

@@ -2,6 +2,7 @@ import type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
 
 export class JiraTracker implements IssueTracker {
   readonly name = "jira";
+  readonly isEmpty = false;
   private baseUrl: string;
   private authHeader: string;
   private projectKey: string;
@@ -38,9 +39,14 @@ export class JiraTracker implements IssueTracker {
         },
       }),
     });
-    const data = await res.json() as { key?: string; errors?: Record<string, string> };
     if (!res.ok) {
-      console.error(`[jira] failed to create issue (${res.status}): ${JSON.stringify(data.errors ?? data)}`);
+      const msg = await res.text().catch(() => "");
+      console.error(`[jira] failed to create issue (${res.status}): ${msg.slice(0, 200)}`);
+      return null;
+    }
+    const data = await res.json() as { key?: string };
+    if (!data.key) {
+      console.error("[jira] create issue response missing key");
       return null;
     }
     const url = `${this.baseUrl}/browse/${data.key}`;

package/framework/trackers/notion.ts

@@ -2,6 +2,7 @@ import type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
 
 export class NotionTracker implements IssueTracker {
   readonly name = "notion";
+  readonly isEmpty = false;
   private token: string;
   private databaseId: string;
 
@@ -38,13 +39,15 @@ export class NotionTracker implements IssueTracker {
         ],
       }),
     });
-    const data = await res.json() as { id?: string; url?: string; message?: string };
     if (!res.ok) {
-      console.error(`[notion] failed to create page (${res.status}): ${data.message}`);
+      const msg = await res.text().catch(() => "");
+      console.error(`[notion] failed to create page (${res.status}): ${msg.slice(0, 200)}`);
       return null;
     }
-    console.log(`[notion] page created: ${data.url}`);
-    return data.url ?? null;
+    const data = await res.json() as { url?: string };
+    const url = data.url ?? null;
+    console.log(`[notion] page created: ${url}`);
+    return url;
   }
 
   async fetchOpenIssues(): Promise<OpenIssue[]> {

package/framework/trackers/types.ts

@@ -13,6 +13,7 @@ export interface ClosedIssue {
 
 export interface IssueTracker {
   readonly name: string;
+  readonly isEmpty: boolean;
   createIssue(title: string, body: string, labels: string[]): Promise<string | null>;
   fetchOpenIssues(): Promise<OpenIssue[]>;
   fetchClosedIssues(): Promise<ClosedIssue[]>;

package/framework/triage.ts

@@ -165,10 +165,14 @@ Organize feedback collected by multiple agents and post it as issue tickets.
         const fullBody = `**Category:** ${category}\n\n${body}${screenshotSection}\n\n---\n**Reported by:** ${mergedAgents.join(", ")}\n*This Issue was auto-generated by an AI triage agent*`;
         const cleanTitle = title.replace(/^\[[^\]]+\]\s*/i, "");
         const url = await tracker.createIssue(`[${category}] ${cleanTitle}`, fullBody, [category, "feedback-agent"]);
-        mergedIds.forEach((id) => { pendingIds.delete(id); issuedIds.push(id); });
-        issuesCreated++;
-        result = { created: true, url, mergedCount: mergedIds.length };
-        console.log(`  [triage] issue created: "[${category}] ${cleanTitle}" (merged ${mergedIds.length})`);
+        if (url === null && !tracker.isEmpty) {
+          result = { created: false, error: "tracker returned null — check logs" };
+        } else {
+          mergedIds.forEach((id) => { pendingIds.delete(id); issuedIds.push(id); });
+          issuesCreated++;
+          result = { created: true, url, mergedCount: mergedIds.length };
+          console.log(`  [triage] issue created: "[${category}] ${cleanTitle}" (merged ${mergedIds.length})`);
+        }
 
       } else if (toolUse.name === "skip_finding") {
         const { finding_id, reason } = toolUse.input as { finding_id: string; reason: string };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m8i-51/shoal",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "type": "module",
   "description": "Multi-agent web exploration framework — finds bugs, UX issues, and missing features by running AI agents against your app",
   "repository": {
@@ -51,7 +51,7 @@
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^4.7.0",
     "@vitest/coverage-v8": "^4.1.6",
-    "concurrently": "^9.2.1",
+    "concurrently": "^10.0.3",
     "i18next": "^26.0.6",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",