@m8i-51/shoal 0.1.10 → 0.1.12

package/.env.example

@@ -62,12 +62,37 @@ TARGET=none             # example | none | カスタムターゲット名
 BASE_URL=http://localhost:3000
 
 # ================================================================
-# GitHub Issues (optional)
+# Issue Tracker (optional)
 # ================================================================
+# カンマ区切りで複数のトラッカーを同時に有効化できます。
+# ISSUE_TRACKERS が未設定で GITHUB_TOKEN/GITHUB_REPO がある場合は github が自動で有効になります。
 
+# ISSUE_TRACKERS=github,backlog
+
+# --- GitHub Issues ---
 GITHUB_TOKEN=
 GITHUB_REPO=owner/repo
 
+# --- Jira ---
+# JIRA_BASE_URL=https://yourcompany.atlassian.net
+# JIRA_EMAIL=user@example.com
+# JIRA_API_TOKEN=
+# JIRA_PROJECT_KEY=PROJ
+
+# --- Notion ---
+# NOTION_API_KEY=
+# NOTION_DATABASE_ID=
+# ※ Notion のデータベースには Name (title) / Labels (multi_select) / Status (select) プロパティが必要です
+
+# --- Backlog ---
+# BACKLOG_SPACE=yourspace
+# BACKLOG_API_KEY=
+# BACKLOG_PROJECT_ID=12345
+
+# --- Asana ---
+# ASANA_ACCESS_TOKEN=
+# ASANA_PROJECT_ID=
+
 # ================================================================
 # Run config
 # ================================================================

package/README.md

@@ -39,7 +39,7 @@ Target App (any URL)
   explore via API                  browse the real UI
         │                                  │
         └──────────────┬───────────────────┘
-                       ▼  deduplicates and files GitHub Issues
+                       ▼  deduplicates and files issue tickets
                  Triage Agent
 ```
 
@@ -56,7 +56,7 @@ At the end of each run:
 - **Feature suggestions** — things that would add real value
 - **Goal gaps** — where the app falls short of what it's trying to achieve
 
-Findings are filed as GitHub Issues or saved as a self-contained HTML report. A **web dashboard** lets you start runs, watch live progress, review findings by category, and track estimated LLM cost per run.
+Findings are filed as issue tickets (GitHub Issues, Jira, Notion, Backlog, or Asana) or saved as a self-contained HTML report. A **web dashboard** lets you start runs, watch live progress, review findings by category, and track estimated LLM cost per run.
 
 ---
 
@@ -88,6 +88,7 @@ Then run:
 ```bash
 shoal serve    # open web dashboard at http://localhost:4000
 shoal          # or run agents directly from the terminal
+shoal config   # update settings in existing .env (e.g. issue trackers)
 ```
 
 **Or clone and develop locally:**
@@ -128,10 +129,23 @@ Opens at `http://localhost:4000`. From there you can:
 | `MAX_EXPLORERS` | `4` | API explorer agent count (0 to disable) |
 | `MAX_BROWSERS` | `2` | Browser agent count |
 | `ANTHROPIC_API_KEY` | — | Required |
-| `GITHUB_TOKEN` | — | Optional — enables Issue creation |
-| `GITHUB_REPO` | — | `owner/repo` format |
+| `ISSUE_TRACKERS` | — | Comma-separated list of active trackers: `github`, `jira`, `notion`, `backlog`, `asana` |
 | `REFRESH_SPEC` | — | Set to `1` to re-run product discovery |
 
+**Issue tracker variables** (set only what you need):
+
+| Tracker | Variables |
+|---|---|
+| GitHub Issues | `GITHUB_TOKEN`, `GITHUB_REPO` (`owner/repo`) |
+| Jira | `JIRA_BASE_URL`, `JIRA_EMAIL`, `JIRA_API_TOKEN`, `JIRA_PROJECT_KEY` |
+| Notion | `NOTION_API_KEY`, `NOTION_DATABASE_ID` ¹ |
+| Backlog | `BACKLOG_SPACE`, `BACKLOG_API_KEY`, `BACKLOG_PROJECT_ID` |
+| Asana | `ASANA_ACCESS_TOKEN`, `ASANA_PROJECT_ID` |
+
+¹ The Notion database must have `Name` (title), `Labels` (multi_select), and `Status` (select) properties.
+
+Multiple trackers can be active at the same time — findings are posted to all of them. If `ISSUE_TRACKERS` is not set but `GITHUB_TOKEN` and `GITHUB_REPO` are present, GitHub is used automatically (backward compatible).
+
 ---
 
 ## Adding a target

package/bin/init.js

@@ -1,5 +1,5 @@
-import { intro, outro, select, text, confirm, isCancel, cancel } from "@clack/prompts";
-import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { intro, outro, select, multiselect, text, confirm, isCancel, cancel } from "@clack/prompts";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { join } from "path";
 
 const PROVIDERS = [
@@ -101,19 +101,9 @@ export async function runInit(cwd) {
     defaultValue: "http://localhost:3000",
   }));
 
-  // ── GitHub (optional) ─────────────────────────────────────────────
-  const githubToken = guard(await text({
-    message: "GitHub token  (optional — for Issue creation)",
-    placeholder: "ghp_...  leave blank to skip",
-  }));
-  if (githubToken.trim()) {
-    env.GITHUB_TOKEN = githubToken.trim();
-    const githubRepo = guard(await text({
-      message: "GitHub repo",
-      placeholder: "owner/repo",
-    }));
-    if (githubRepo.trim()) env.GITHUB_REPO = githubRepo.trim();
-  }
+  // ── Issue trackers (optional) ─────────────────────────────────────
+  const trackerEnv = await promptTrackers();
+  Object.assign(env, trackerEnv);
 
   // ── Write .env ────────────────────────────────────────────────────
   const lines = Object.entries(env).map(([k, v]) => `${k}=${v}`);
@@ -184,3 +174,174 @@ jobs:
 
   outro("Created .env\n\n  shoal serve   — open the dashboard at http://localhost:4000\n  shoal         — run agents from the terminal");
 }
+
+// ── Tracker config helpers ─────────────────────────────────────────
+
+const TRACKER_KEYS = [
+  "ISSUE_TRACKERS",
+  "GITHUB_TOKEN", "GITHUB_REPO",
+  "JIRA_BASE_URL", "JIRA_EMAIL", "JIRA_API_TOKEN", "JIRA_PROJECT_KEY",
+  "NOTION_API_KEY", "NOTION_DATABASE_ID",
+  "BACKLOG_SPACE", "BACKLOG_API_KEY", "BACKLOG_PROJECT_ID",
+  "ASANA_ACCESS_TOKEN", "ASANA_PROJECT_ID",
+];
+
+function parseEnv(content) {
+  const result = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const idx = trimmed.indexOf("=");
+    if (idx === -1) continue;
+    result[trimmed.slice(0, idx)] = trimmed.slice(idx + 1);
+  }
+  return result;
+}
+
+function updateEnvFile(envPath, newKeys, removeKeys) {
+  const content = existsSync(envPath) ? readFileSync(envPath, "utf-8") : "";
+  const lines = content.split("\n").filter((line) => {
+    const key = line.split("=")[0].trim();
+    return !removeKeys.includes(key);
+  });
+  while (lines.length > 0 && lines[lines.length - 1].trim() === "") lines.pop();
+  const newLines = Object.entries(newKeys).map(([k, v]) => `${k}=${v}`);
+  writeFileSync(envPath, [...lines, "", ...newLines, ""].join("\n"), "utf-8");
+}
+
+async function promptTrackers(existing = {}) {
+  const currentTrackers = (existing.ISSUE_TRACKERS ?? "")
+    .split(",").map((s) => s.trim()).filter(Boolean);
+
+  const selectedTrackers = guard(await multiselect({
+    message: "Issue trackers  (select all that apply; leave empty to save locally only)",
+    options: [
+      { value: "github",  label: "GitHub Issues", selected: currentTrackers.includes("github") },
+      { value: "jira",    label: "Jira",           selected: currentTrackers.includes("jira") },
+      { value: "notion",  label: "Notion",          selected: currentTrackers.includes("notion") },
+      { value: "backlog", label: "Backlog",         selected: currentTrackers.includes("backlog") },
+      { value: "asana",   label: "Asana",           selected: currentTrackers.includes("asana") },
+    ],
+    required: false,
+  }));
+
+  const env = {};
+
+  if (selectedTrackers.length > 0) {
+    env.ISSUE_TRACKERS = selectedTrackers.join(",");
+  }
+
+  if (selectedTrackers.includes("github")) {
+    env.GITHUB_TOKEN = guard(await text({
+      message: "GitHub token",
+      placeholder: "ghp_...",
+      initialValue: existing.GITHUB_TOKEN ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+    env.GITHUB_REPO = guard(await text({
+      message: "GitHub repo",
+      placeholder: "owner/repo",
+      initialValue: existing.GITHUB_REPO ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+  }
+
+  if (selectedTrackers.includes("jira")) {
+    env.JIRA_BASE_URL = guard(await text({
+      message: "Jira base URL",
+      placeholder: "https://yourcompany.atlassian.net",
+      initialValue: existing.JIRA_BASE_URL ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+    env.JIRA_EMAIL = guard(await text({
+      message: "Jira account email",
+      initialValue: existing.JIRA_EMAIL ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+    env.JIRA_API_TOKEN = guard(await text({
+      message: "Jira API token",
+      initialValue: existing.JIRA_API_TOKEN ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+    env.JIRA_PROJECT_KEY = guard(await text({
+      message: "Jira project key",
+      placeholder: "PROJ",
+      initialValue: existing.JIRA_PROJECT_KEY ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+  }
+
+  if (selectedTrackers.includes("notion")) {
+    env.NOTION_API_KEY = guard(await text({
+      message: "Notion API key",
+      placeholder: "secret_...",
+      initialValue: existing.NOTION_API_KEY ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+    env.NOTION_DATABASE_ID = guard(await text({
+      message: "Notion database ID",
+      hint: "DB must have Name (title), Labels (multi_select), Status (select) properties",
+      initialValue: existing.NOTION_DATABASE_ID ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+  }
+
+  if (selectedTrackers.includes("backlog")) {
+    env.BACKLOG_SPACE = guard(await text({
+      message: "Backlog space name",
+      placeholder: "yourspace  (from yourspace.backlog.com)",
+      initialValue: existing.BACKLOG_SPACE ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+    env.BACKLOG_API_KEY = guard(await text({
+      message: "Backlog API key",
+      initialValue: existing.BACKLOG_API_KEY ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+    env.BACKLOG_PROJECT_ID = guard(await text({
+      message: "Backlog project ID  (numeric)",
+      initialValue: existing.BACKLOG_PROJECT_ID ?? "",
+      validate: (v) => /^\d+$/.test(v?.trim()) ? undefined : "Must be a number",
+    }));
+  }
+
+  if (selectedTrackers.includes("asana")) {
+    env.ASANA_ACCESS_TOKEN = guard(await text({
+      message: "Asana personal access token",
+      initialValue: existing.ASANA_ACCESS_TOKEN ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+    env.ASANA_PROJECT_ID = guard(await text({
+      message: "Asana project ID",
+      initialValue: existing.ASANA_PROJECT_ID ?? "",
+      validate: (v) => v?.trim() ? undefined : "Required",
+    }));
+  }
+
+  return env;
+}
+
+export async function runConfig(cwd) {
+  const envPath = join(cwd, ".env");
+
+  if (!existsSync(envPath)) {
+    console.log(".env not found. Run shoal init first.");
+    process.exit(1);
+  }
+
+  intro("shoal config");
+
+  const section = guard(await select({
+    message: "What do you want to configure?",
+    options: [
+      { value: "trackers", label: "Issue trackers" },
+    ],
+  }));
+
+  if (section === "trackers") {
+    const existing = parseEnv(readFileSync(envPath, "utf-8"));
+    const newTrackerEnv = await promptTrackers(existing);
+    updateEnvFile(envPath, newTrackerEnv, TRACKER_KEYS);
+    outro("Updated .env — run shoal to apply changes");
+  }
+}

package/bin/shoal.js

@@ -4,6 +4,7 @@
  *
  * Usage:
  *   shoal init     # interactive setup — creates .env in current directory
+ *   shoal config   # update settings in existing .env (e.g. issue trackers)
  *   shoal serve    # web dashboard at http://localhost:4000
  *   shoal          # run agents from the terminal
  *   shoal triage   # triage-only mode
@@ -25,6 +26,13 @@ async function main() {
     process.exit(0);
   }
 
+  // config — 既存の .env を対話形式で更新する
+  if (subcommand === "config") {
+    const { runConfig } = await import("./init.js");
+    await runConfig(process.cwd());
+    process.exit(0);
+  }
+
   // serve の場合、web/dist が存在しなければ自動ビルドする
   if (subcommand === "serve") {
     const distIndex = join(packageRoot, "web", "dist", "index.html");

package/framework/scenario-designer.ts

@@ -59,7 +59,7 @@ const OUTPUT_SCENARIOS_TOOL: Anthropic.Tool = {
 
 export async function designScenarios(
   spec: ProductSpec,
-  openIssues: { number: number; title: string; labels: string[] }[],
+  openIssues: { number: number | string; title: string; labels: string[] }[],
   client: LLMClient,
   model: string,
   count: number = 5,

package/framework/trackers/asana.ts

@@ -0,0 +1,75 @@
+import type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
+
+export class AsanaTracker implements IssueTracker {
+  readonly name = "asana";
+  readonly isEmpty = false;
+  private token: string;
+  private projectId: string;
+
+  constructor(token: string, projectId: string) {
+    this.token = token;
+    this.projectId = projectId;
+  }
+
+  private get headers() {
+    return {
+      Authorization: `Bearer ${this.token}`,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+    };
+  }
+
+  async createIssue(title: string, body: string, labels: string[]): Promise<string | null> {
+    const res = await fetch("https://app.asana.com/api/1.0/tasks", {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        data: {
+          name: title,
+          notes: `${body}\n\nLabels: ${labels.join(", ")}`,
+          projects: [this.projectId],
+        },
+      }),
+    });
+    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 };
+    };
+    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}`;
+    console.log(`[asana] task created: ${url}`);
+    return url;
+  }
+
+  async fetchOpenIssues(): Promise<OpenIssue[]> {
+    const res = await fetch(
+      `https://app.asana.com/api/1.0/tasks?project=${this.projectId}&completed_since=now&opt_fields=gid,name&limit=50`,
+      { headers: this.headers }
+    );
+    if (!res.ok) return [];
+    const data = await res.json() as { data?: { gid: string; name: string }[] };
+    return (data.data ?? []).map((t) => ({ number: t.gid, title: t.name, labels: [] }));
+  }
+
+  async fetchClosedIssues(): Promise<ClosedIssue[]> {
+    const res = await fetch(
+      `https://app.asana.com/api/1.0/tasks?project=${this.projectId}&completed=true&opt_fields=gid,name,notes&limit=20`,
+      { headers: this.headers }
+    );
+    if (!res.ok) return [];
+    const data = await res.json() as { data?: { gid: string; name: string; notes: string }[] };
+    return (data.data ?? []).map((t) => ({
+      number: t.gid,
+      title: t.name,
+      body: t.notes ?? "",
+      labels: [],
+    }));
+  }
+}

package/framework/trackers/backlog.ts

@@ -0,0 +1,76 @@
+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;
+
+  constructor(space: string, apiKey: string, projectId: number) {
+    this.baseUrl = `https://${space}.backlog.com`;
+    this.apiKey = apiKey;
+    this.projectId = projectId;
+  }
+
+  private endpoint(path: string, params?: Record<string, string>): string {
+    const q = new URLSearchParams({ apiKey: this.apiKey, ...params });
+    return `${this.baseUrl}/api/v2${path}?${q}`;
+  }
+
+  async createIssue(title: string, body: string, labels: string[]): Promise<string | null> {
+    const form = new URLSearchParams({
+      projectId: String(this.projectId),
+      summary: title,
+      description: `${body}\n\nLabels: ${labels.join(", ")}`,
+      issueTypeId: "1",
+      priorityId: "3",
+    });
+    const res = await fetch(this.endpoint("/issues"), {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body: form,
+    });
+    if (!res.ok) {
+      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}`;
+    console.log(`[backlog] issue created: ${url}`);
+    return url;
+  }
+
+  async fetchOpenIssues(): Promise<OpenIssue[]> {
+    const res = await fetch(this.endpoint("/issues", {
+      "projectId[]": String(this.projectId),
+      "statusId[]": "1",
+      count: "50",
+      keyword: "feedback-agent",
+    }));
+    if (!res.ok) return [];
+    const data = await res.json() as { issueKey: string; summary: string }[];
+    return Array.isArray(data)
+      ? data.map((i) => ({ number: i.issueKey, title: i.summary, labels: [] }))
+      : [];
+  }
+
+  async fetchClosedIssues(): Promise<ClosedIssue[]> {
+    const res = await fetch(this.endpoint("/issues", {
+      "projectId[]": String(this.projectId),
+      "statusId[]": "4",
+      count: "20",
+      keyword: "feedback-agent",
+    }));
+    if (!res.ok) return [];
+    const data = await res.json() as { issueKey: string; summary: string; description: string }[];
+    return Array.isArray(data)
+      ? data.map((i) => ({ number: i.issueKey, title: i.summary, body: i.description ?? "", labels: [] }))
+      : [];
+  }
+}

package/framework/trackers/github.ts

@@ -0,0 +1,24 @@
+import type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
+import { postGitHubIssue, fetchOpenIssues as ghFetchOpen, fetchClosedIssues as ghFetchClosed } from "../github";
+
+export class GitHubTracker implements IssueTracker {
+  readonly name = "github";
+  readonly isEmpty = false;
+  private opts: { token: string; repo: string };
+
+  constructor(token: string, repo: string) {
+    this.opts = { token, repo };
+  }
+
+  createIssue(title: string, body: string, labels: string[]): Promise<string | null> {
+    return postGitHubIssue(title, body, labels, this.opts);
+  }
+
+  async fetchOpenIssues(): Promise<OpenIssue[]> {
+    return ghFetchOpen(this.opts);
+  }
+
+  async fetchClosedIssues(): Promise<ClosedIssue[]> {
+    return ghFetchClosed(this.opts);
+  }
+}

package/framework/trackers/index.ts

@@ -0,0 +1,130 @@
+import type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
+import { GitHubTracker } from "./github";
+import { JiraTracker } from "./jira";
+import { NotionTracker } from "./notion";
+import { BacklogTracker } from "./backlog";
+import { AsanaTracker } from "./asana";
+
+export type { IssueTracker, OpenIssue, ClosedIssue } from "./types";
+
+export class AggregatedTracker implements IssueTracker {
+  readonly name = "aggregated";
+  private trackers: IssueTracker[];
+
+  constructor(trackers: IssueTracker[]) {
+    this.trackers = trackers;
+  }
+
+  get isEmpty(): boolean {
+    return this.trackers.length === 0;
+  }
+
+  async createIssue(title: string, body: string, labels: string[]): Promise<string | null> {
+    if (this.trackers.length === 0) return 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.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.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;
+    });
+  }
+}
+
+export function buildTrackers(): AggregatedTracker {
+  const raw = process.env.ISSUE_TRACKERS ?? "";
+  const enabled = raw
+    .split(",")
+    .map((s) => s.trim().toLowerCase())
+    .filter(Boolean);
+
+  // Backward compat: if ISSUE_TRACKERS not set but GITHUB_TOKEN/GITHUB_REPO are present, default to github
+  if (enabled.length === 0 && process.env.GITHUB_TOKEN && process.env.GITHUB_REPO) {
+    enabled.push("github");
+  }
+
+  const trackers: IssueTracker[] = [];
+
+  for (const name of enabled) {
+    switch (name) {
+      case "github": {
+        const token = process.env.GITHUB_TOKEN ?? "";
+        const repo = process.env.GITHUB_REPO ?? "";
+        if (token && repo) {
+          trackers.push(new GitHubTracker(token, repo));
+        } else {
+          console.warn("[trackers] github: GITHUB_TOKEN or GITHUB_REPO not set, skipping");
+        }
+        break;
+      }
+      case "jira": {
+        const baseUrl = process.env.JIRA_BASE_URL ?? "";
+        const email = process.env.JIRA_EMAIL ?? "";
+        const apiToken = process.env.JIRA_API_TOKEN ?? "";
+        const projectKey = process.env.JIRA_PROJECT_KEY ?? "";
+        if (baseUrl && email && apiToken && projectKey) {
+          trackers.push(new JiraTracker(baseUrl, email, apiToken, projectKey));
+        } else {
+          console.warn("[trackers] jira: JIRA_BASE_URL / JIRA_EMAIL / JIRA_API_TOKEN / JIRA_PROJECT_KEY required, skipping");
+        }
+        break;
+      }
+      case "notion": {
+        const token = process.env.NOTION_API_KEY ?? "";
+        const databaseId = process.env.NOTION_DATABASE_ID ?? "";
+        if (token && databaseId) {
+          trackers.push(new NotionTracker(token, databaseId));
+        } else {
+          console.warn("[trackers] notion: NOTION_API_KEY or NOTION_DATABASE_ID not set, skipping");
+        }
+        break;
+      }
+      case "backlog": {
+        const space = process.env.BACKLOG_SPACE ?? "";
+        const apiKey = process.env.BACKLOG_API_KEY ?? "";
+        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");
+        }
+        break;
+      }
+      case "asana": {
+        const token = process.env.ASANA_ACCESS_TOKEN ?? "";
+        const projectId = process.env.ASANA_PROJECT_ID ?? "";
+        if (token && projectId) {
+          trackers.push(new AsanaTracker(token, projectId));
+        } else {
+          console.warn("[trackers] asana: ASANA_ACCESS_TOKEN or ASANA_PROJECT_ID not set, skipping");
+        }
+        break;
+      }
+      default:
+        console.warn(`[trackers] unknown tracker: "${name}"`);
+    }
+  }
+
+  if (trackers.length > 0) {
+    console.log(`[trackers] enabled: ${trackers.map((t) => t.name).join(", ")}`);
+  } else {
+    console.log("[trackers] no issue trackers configured — findings saved locally only");
+  }
+
+  return new AggregatedTracker(trackers);
+}