@m8i-51/shoal 0.1.10 → 0.1.12

package/framework/trackers/jira.ts

@@ -0,0 +1,95 @@
+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;
+
+  constructor(baseUrl: string, email: string, apiToken: string, projectKey: string) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.authHeader = `Basic ${Buffer.from(`${email}:${apiToken}`).toString("base64")}`;
+    this.projectKey = projectKey;
+  }
+
+  private get headers() {
+    return {
+      Authorization: this.authHeader,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+    };
+  }
+
+  async createIssue(title: string, body: string, labels: string[]): Promise<string | null> {
+    const res = await fetch(`${this.baseUrl}/rest/api/3/issue`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        fields: {
+          project: { key: this.projectKey },
+          summary: title,
+          description: {
+            type: "doc",
+            version: 1,
+            content: [{ type: "paragraph", content: [{ type: "text", text: body }] }],
+          },
+          issuetype: { name: "Task" },
+          labels,
+        },
+      }),
+    });
+    if (!res.ok) {
+      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}`;
+    console.log(`[jira] issue created: ${url}`);
+    return url;
+  }
+
+  async fetchOpenIssues(): Promise<OpenIssue[]> {
+    const jql = encodeURIComponent(
+      `project = ${this.projectKey} AND statusCategory != Done AND labels = "feedback-agent" ORDER BY created DESC`
+    );
+    const res = await fetch(
+      `${this.baseUrl}/rest/api/3/search?jql=${jql}&maxResults=50&fields=summary,labels`,
+      { headers: this.headers }
+    );
+    if (!res.ok) return [];
+    const data = await res.json() as {
+      issues?: { key: string; fields: { summary: string; labels: string[] } }[];
+    };
+    return (data.issues ?? []).map((i) => ({
+      number: i.key,
+      title: i.fields.summary,
+      labels: i.fields.labels,
+    }));
+  }
+
+  async fetchClosedIssues(): Promise<ClosedIssue[]> {
+    const jql = encodeURIComponent(
+      `project = ${this.projectKey} AND statusCategory = Done AND labels = "feedback-agent" ORDER BY updated DESC`
+    );
+    const res = await fetch(
+      `${this.baseUrl}/rest/api/3/search?jql=${jql}&maxResults=20&fields=summary,labels,description`,
+      { headers: this.headers }
+    );
+    if (!res.ok) return [];
+    const data = await res.json() as {
+      issues?: { key: string; fields: { summary: string; labels: string[]; description: unknown } }[];
+    };
+    return (data.issues ?? []).map((i) => ({
+      number: i.key,
+      title: i.fields.summary,
+      body: typeof i.fields.description === "string" ? i.fields.description : "",
+      labels: i.fields.labels,
+    }));
+  }
+}

package/framework/trackers/notion.ts

@@ -0,0 +1,87 @@
+import type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
+
+export class NotionTracker implements IssueTracker {
+  readonly name = "notion";
+  readonly isEmpty = false;
+  private token: string;
+  private databaseId: string;
+
+  constructor(token: string, databaseId: string) {
+    this.token = token;
+    this.databaseId = databaseId;
+  }
+
+  private get headers() {
+    return {
+      Authorization: `Bearer ${this.token}`,
+      "Content-Type": "application/json",
+      "Notion-Version": "2022-06-28",
+    };
+  }
+
+  async createIssue(title: string, body: string, labels: string[]): Promise<string | null> {
+    const res = await fetch("https://api.notion.com/v1/pages", {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        parent: { database_id: this.databaseId },
+        properties: {
+          Name: { title: [{ text: { content: title } }] },
+          Labels: { multi_select: labels.map((l) => ({ name: l })) },
+          Status: { select: { name: "Open" } },
+        },
+        children: [
+          {
+            object: "block",
+            type: "paragraph",
+            paragraph: { rich_text: [{ type: "text", text: { content: body } }] },
+          },
+        ],
+      }),
+    });
+    if (!res.ok) {
+      const msg = await res.text().catch(() => "");
+      console.error(`[notion] failed to create page (${res.status}): ${msg.slice(0, 200)}`);
+      return 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[]> {
+    return this._queryPages("Open");
+  }
+
+  async fetchClosedIssues(): Promise<ClosedIssue[]> {
+    const pages = await this._queryPages("Closed");
+    return pages.map((p) => ({ ...p, body: "" }));
+  }
+
+  private async _queryPages(status: string): Promise<{ number: string; title: string; labels: string[] }[]> {
+    const res = await fetch(`https://api.notion.com/v1/databases/${this.databaseId}/query`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        filter: { property: "Status", select: { equals: status } },
+        page_size: 50,
+      }),
+    });
+    if (!res.ok) return [];
+    const data = await res.json() as {
+      results?: {
+        id: string;
+        properties: {
+          Name?: { title: { plain_text: string }[] };
+          Labels?: { multi_select: { name: string }[] };
+        };
+      }[];
+    };
+    return (data.results ?? []).map((p) => ({
+      number: p.id,
+      title: p.properties.Name?.title[0]?.plain_text ?? "(no title)",
+      labels: p.properties.Labels?.multi_select.map((l) => l.name) ?? [],
+    }));
+  }
+}

package/framework/trackers/types.ts

@@ -0,0 +1,20 @@
+export interface OpenIssue {
+  number: number | string;
+  title: string;
+  labels: string[];
+}
+
+export interface ClosedIssue {
+  number: number | string;
+  title: string;
+  body: string;
+  labels: string[];
+}
+
+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

@@ -4,7 +4,7 @@ import * as path from "path";
 import type { LLMClient } from "./llm-client";
 import type { Finding } from "./types";
 import { createMessageWithRetry } from "./agent-loop";
-import { postGitHubIssue, fetchOpenIssues } from "./github";
+import type { IssueTracker } from "./trackers/index";
 
 const TRIAGE_TOOLS: Anthropic.Tool[] = [
   {
@@ -14,7 +14,7 @@ const TRIAGE_TOOLS: Anthropic.Tool[] = [
   },
   {
     name: "create_issue",
-    description: "Post feedback as a GitHub Issue; multiple related findings can be merged into one / フィードバックをGitHub Issueとして投稿する。類似フィードバックをまとめて1件にできる",
+    description: "Post feedback as an issue ticket; multiple related findings can be merged into one / フィードバックをissueチケットとして投稿する。類似フィードバックをまとめて1件にできる",
     input_schema: {
       type: "object",
       properties: {
@@ -32,7 +32,7 @@ const TRIAGE_TOOLS: Anthropic.Tool[] = [
   },
   {
     name: "skip_finding",
-    description: "Skip a finding that duplicates an existing open GitHub Issue / 既存のOpenなGitHub Issueと重複するためスキップする",
+    description: "Skip a finding that duplicates an existing open issue / 既存のOpenなissueと重複するためスキップする",
     input_schema: {
       type: "object",
       properties: {
@@ -55,7 +55,7 @@ export async function runTriageAgent(
   findings: Finding[],
   client: LLMClient,
   model: string,
-  githubOptions: { token: string; repo: string }
+  tracker: IssueTracker
 ): Promise<TriageResult> {
   if (findings.length === 0) {
     console.log("\n[triage] no findings, skipping");
@@ -64,7 +64,7 @@ export async function runTriageAgent(
 
   console.log(`\n[triage] starting (findings: ${findings.length})`);
 
-  const openIssues = await fetchOpenIssues(githubOptions);
+  const openIssues = await tracker.fetchOpenIssues();
   const pendingIds = new Set(findings.map((f) => f.id));
   const issuedIds: string[] = [];
   const skippedIds: string[] = [];
@@ -72,16 +72,16 @@ export async function runTriageAgent(
   let skipped = 0;
 
   const openIssueList = openIssues.length > 0
-    ? `\n\n[Existing open Issues (for deduplication)]\n${openIssues.map((i) => `- #${i.number}: ${i.title}`).join("\n")}`
+    ? `\n\n[Existing open issues (for deduplication)]\n${openIssues.map((i) => `- ${i.number}: ${i.title}`).join("\n")}`
     : "";
 
   const systemPrompt = `You are a feedback triage AI.
-Organize feedback collected by multiple agents and post it as GitHub Issues.
+Organize feedback collected by multiple agents and post it as issue tickets.
 
 [Steps]
 1. Call get_all_findings to review collected feedback
-2. Merge similar/duplicate feedback into a single Issue
-3. Skip feedback that duplicates an existing open Issue using skip_finding
+2. Merge similar/duplicate feedback into a single issue
+3. Skip feedback that duplicates an existing open issue using skip_finding
 4. Post the rest with create_issue (no duplicates, only valuable findings)
 5. Finish after processing all items${openIssueList}
 
@@ -92,8 +92,8 @@ Organize feedback collected by multiple agents and post it as GitHub Issues.
 - goal-gap: the app fails to meet one of its stated goals — use only when a finding directly undermines a specific app goal
 
 [Merging Guidelines]
-- Multiple reports about the same screen/feature can be merged into one Issue
-- Merge into one Issue even across categories if it's the same underlying problem
+- Multiple reports about the same screen/feature can be merged into one issue
+- Merge into one issue even across categories if it's the same underlying problem
 - Include multiple perspectives in the body when merging
 - Only post clearly valuable findings (skip operation errors or misunderstandings)
 
@@ -164,11 +164,15 @@ Organize feedback collected by multiple agents and post it as GitHub Issues.
           : "";
         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 postGitHubIssue(`[${category}] ${cleanTitle}`, fullBody, [category, "feedback-agent"], githubOptions);
-        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})`);
+        const url = await tracker.createIssue(`[${category}] ${cleanTitle}`, fullBody, [category, "feedback-agent"]);
+        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.10",
+  "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",

package/run.ts

@@ -18,7 +18,7 @@ import { createMessageWithRetry, runAgentLoop, sleep, rateLimitRetries } from ".
 import { collectedFindings, initRunLog, saveRunLog, saveFinding, runLog } from "./framework/findings";
 import { loadAgents, addAgent, retireAgent } from "./framework/agent-store";
 import { updateCoverage, computeWeightedSummary } from "./framework/coverage";
-import { postGitHubIssue, fetchClosedIssues, fetchOpenIssues } from "./framework/github";
+import { buildTrackers } from "./framework/trackers/index";
 import {
   setupObservation,
   getRecentConsoleLogs,
@@ -41,10 +41,8 @@ import { runAccountManager, loadTestAccounts, type TestAccount } from "./framewo
 import { estimateCost, formatCostUSD } from "./framework/cost";
 
 const BASE_URL = process.env.BASE_URL ?? "http://localhost:3000";
-const GITHUB_TOKEN = process.env.GITHUB_TOKEN ?? "";
-const GITHUB_REPO = process.env.GITHUB_REPO ?? "";
 const REFRESH_SPEC = process.env.REFRESH_SPEC === "1";
-const githubOptions = { token: GITHUB_TOKEN, repo: GITHUB_REPO };
+const trackers = buildTrackers();
 
 const TARGET = process.env.TARGET ?? "none";
 let targetConfig = loadTarget(TARGET);
@@ -228,11 +226,10 @@ function makeExecutor(agentLog: AgentLog, scenarioOutcomes: ScenarioOutcome[], s
           const { original_issue_number, original_issue_title, title, body } = input as {
             original_issue_number: number; original_issue_title: string; title: string; body: string;
           };
-          const url = await postGitHubIssue(
+          const url = await trackers.createIssue(
             `[regression] ${title}`,
-            `**Regression:** #${original_issue_number} "${original_issue_title}" has reappeared.\n\n${body}\n\n---\n*This Issue was auto-generated by an AI regression agent*`,
-            ["regression", "feedback-agent"],
-            githubOptions
+            `**Regression:** #${original_issue_number} "${original_issue_title}" has reappeared.\n\n${body}\n\n---\n*This issue was auto-generated by an AI regression agent*`,
+            ["regression", "feedback-agent"]
           );
           const check: RegressionCheck = {
             issueNumber: Number(original_issue_number),
@@ -346,7 +343,7 @@ Take 3–5 actions, then finish.`;
 
 async function runRegressionAgent(
   agent: { id: string; name: string; persona: string; role: string },
-  closedIssues: { number: number; title: string; body: string; labels: string[] }[],
+  closedIssues: { number: number | string; title: string; body: string; labels: string[] }[],
   productSpec: ProductSpec
 ) {
   console.log(`\n[regression] ${agent.name} start (${closedIssues.length} issues to check)`);
@@ -448,7 +445,7 @@ const PERSONA_DESIGNER_TOOLS: Anthropic.Tool[] = [
 async function runPersonaDesigner(
   productSpec: ProductSpec,
   orgGuidance: string,
-  openIssues: { number: number; title: string; labels: string[] }[],
+  openIssues: { number: number | string; title: string; labels: string[] }[],
   scenarios: Scenario[],
   testAccounts: TestAccount[] = [],
 ): Promise<void> {
@@ -1053,7 +1050,7 @@ function pickAssignment(idx: number, scenarios: Scenario[]): { scenario?: Scenar
 async function main() {
   initDirs();
   // run log を最初期化しておくことで、どの段階でエラーが起きても finally で saveRunLog() が動く
-  initRunLog(0, GITHUB_REPO);
+  initRunLog(0, process.env.GITHUB_REPO ?? "");
 
   // 1. product discovery (cache or live)
   const browser = await chromium.launch({ headless: true });
@@ -1082,7 +1079,7 @@ async function main() {
     const orgDesign = await designOrg(productSpec, client, defaultModel, coverageSummary.formatted);
 
     // 3. open issues + scenario design (both feed into HR)
-    const openIssues = await fetchOpenIssues(githubOptions);
+    const openIssues = await trackers.fetchOpenIssues();
     const scenarios = await designScenarios(productSpec, openIssues, client, defaultModel, 5, coverageSummary.formatted);
 
     // 3.5. Account Manager（credentials が設定されている場合のみ）
@@ -1113,7 +1110,7 @@ async function main() {
       console.error("No agents found. Check agents.json.");
       process.exit(1);
     }
-    const closedIssues = await fetchClosedIssues(githubOptions);
+    const closedIssues = await trackers.fetchClosedIssues();
 
     // 5. エージェント数が確定したので totalAgents を更新
     runLog.summary.totalAgents = allAgents.length;
@@ -1191,7 +1188,7 @@ async function main() {
     console.log(`\n[triage] collected findings: ${collectedFindings.length}`);
     let triageResult = { issued: [] as string[], skipped: [] as string[], unprocessed: [] as string[], issuesCreated: 0 };
     try {
-      triageResult = await runTriageAgent(collectedFindings, client, defaultModel, githubOptions);
+      triageResult = await runTriageAgent(collectedFindings, client, defaultModel, trackers);
       runLog.summary.totalIssuesPosted += triageResult.issuesCreated;
     } catch (e) {
       console.error("[triage] error:", e);

package/triage-only.ts

@@ -12,11 +12,9 @@ import * as fs from "fs";
 import * as path from "path";
 import { createLLMClient } from "./framework/llm-client";
 import { runTriageAgent } from "./framework/triage";
+import { buildTrackers } from "./framework/trackers/index";
 import type { Finding } from "./framework/types";
 
-const GITHUB_TOKEN = process.env.GITHUB_TOKEN ?? "";
-const GITHUB_REPO = process.env.GITHUB_REPO ?? "";
-
 function loadFindings(runId: string): Finding[] {
   const dir = path.join(process.cwd(), "findings", runId);
   if (!fs.existsSync(dir)) {
@@ -46,7 +44,8 @@ async function main() {
   findings.forEach((f) => console.log(`  - ${f.agentName}: ${f.title.slice(0, 50)}`));
 
   const { client, defaultModel } = createLLMClient();
-  const result = await runTriageAgent(findings, client, defaultModel, { token: GITHUB_TOKEN, repo: GITHUB_REPO });
+  const trackers = buildTrackers();
+  const result = await runTriageAgent(findings, client, defaultModel, trackers);
 
   console.log("\n=== トリアージ結果 ===");
   console.log(`  Issue作成: ${result.issuesCreated}件`);