feat(FN-3870): wire GitHub tracking issue creation

Implements GitHub tracking issue creation (FN-3870) for the dashboard, wiring new routes for planning subtasks and task workflows, adding a dedicated `github-tracking` module with issue creation and auth fallback logic, and updating the main `github.ts` with enhanced capabilities — backed by compreh

Fusion-Task-Id: FN-3870

packages/dashboard/src/__tests__/github-tracking.test.ts

@@ -0,0 +1,137 @@
+import { describe, expect, it, vi } from "vitest";
+import type { Task } from "@fusion/core";
+import { maybeCreateTrackingIssue } from "../github-tracking.js";
+
+function buildTask(overrides: Partial<Task> = {}): Task {
+  return {
+    id: "FN-1",
+    description: "desc",
+    column: "todo",
+    dependencies: [],
+    steps: [],
+    currentStep: 0,
+    log: [],
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+    ...overrides,
+  } as Task;
+}
+
+describe("maybeCreateTrackingIssue", () => {
+  it("returns tracking_disabled when not enabled", async () => {
+    const result = await maybeCreateTrackingIssue(buildTask({ githubTracking: { enabled: false } }), {
+      taskStore: {} as any,
+      githubClient: {} as any,
+      projectSettings: {},
+      globalSettings: {},
+    });
+    expect(result).toEqual({ created: false, reason: "tracking_disabled" });
+  });
+
+  it("returns issue_already_linked when issue already exists", async () => {
+    const result = await maybeCreateTrackingIssue(buildTask({
+      githubTracking: {
+        enabled: true,
+        issue: { owner: "o", repo: "r", number: 1, url: "https://github.com/o/r/issues/1", createdAt: "2026-01-01T00:00:00.000Z" },
+      },
+    }), {
+      taskStore: {} as any,
+      githubClient: {} as any,
+      projectSettings: {},
+      globalSettings: {},
+    });
+    expect(result).toEqual({ created: false, reason: "issue_already_linked" });
+  });
+
+  it("returns github_import_source for imported tasks", async () => {
+    const result = await maybeCreateTrackingIssue(buildTask({
+      githubTracking: { enabled: true },
+      sourceType: "github_import",
+    }), {
+      taskStore: {} as any,
+      githubClient: {} as any,
+      projectSettings: {},
+      globalSettings: {},
+    });
+    expect(result).toEqual({ created: false, reason: "github_import_source" });
+  });
+
+  it("prefers task repo override over project/global defaults", async () => {
+    const createIssue = vi.fn().mockResolvedValue({
+      owner: "task-owner",
+      repo: "task-repo",
+      number: 11,
+      htmlUrl: "https://github.com/task-owner/task-repo/issues/11",
+      createdAt: "2026-01-01T00:00:00.000Z",
+    });
+
+    await maybeCreateTrackingIssue(buildTask({
+      title: "Test",
+      githubTracking: { enabled: true, repoOverride: "task-owner/task-repo" },
+    }), {
+      taskStore: { linkGithubIssue: vi.fn(), recordActivity: vi.fn() } as any,
+      githubClient: { createIssue } as any,
+      projectSettings: { githubTrackingDefaultRepo: "project-owner/project-repo" } as any,
+      globalSettings: { githubTrackingDefaultRepo: "global-owner/global-repo" } as any,
+    });
+
+    expect(createIssue).toHaveBeenCalledWith(expect.objectContaining({ owner: "task-owner", repo: "task-repo" }));
+  });
+
+  it("creates issue, links metadata, and records activity", async () => {
+    const createIssue = vi.fn().mockResolvedValue({
+      owner: "o",
+      repo: "r",
+      number: 12,
+      htmlUrl: "https://github.com/o/r/issues/12",
+      createdAt: "2026-01-01T00:00:00.000Z",
+    });
+    const linkGithubIssue = vi.fn();
+    const recordActivity = vi.fn();
+
+    const result = await maybeCreateTrackingIssue(buildTask({ title: "Test", githubTracking: { enabled: true } }), {
+      taskStore: { linkGithubIssue, recordActivity } as any,
+      githubClient: { createIssue } as any,
+      projectSettings: {},
+      globalSettings: { githubTrackingDefaultRepo: "o/r" } as any,
+      logger: console,
+    });
+
+    expect(result.created).toBe(true);
+    expect(createIssue).toHaveBeenCalledTimes(1);
+    expect(linkGithubIssue).toHaveBeenCalledWith("FN-1", expect.objectContaining({ owner: "o", repo: "r", number: 12 }));
+    expect(recordActivity).toHaveBeenCalledWith(expect.objectContaining({
+      metadata: expect.objectContaining({ type: "github-issue-created", repo: "o/r", number: 12 }),
+    }));
+  });
+
+  it("returns no_repo_configured and records activity", async () => {
+    const recordActivity = vi.fn();
+    const warn = vi.fn();
+    const result = await maybeCreateTrackingIssue(buildTask({ githubTracking: { enabled: true } }), {
+      taskStore: { recordActivity } as any,
+      githubClient: {} as any,
+      projectSettings: {},
+      globalSettings: {},
+      logger: { warn, info: vi.fn() },
+    });
+
+    expect(result).toEqual({ created: false, reason: "no_repo_configured" });
+    expect(recordActivity).toHaveBeenCalledTimes(1);
+    expect(warn).toHaveBeenCalled();
+  });
+
+  it("swallows github errors", async () => {
+    const warn = vi.fn();
+    const result = await maybeCreateTrackingIssue(buildTask({ githubTracking: { enabled: true } }), {
+      taskStore: { recordActivity: vi.fn() } as any,
+      githubClient: { createIssue: vi.fn().mockRejectedValue(new Error("boom")) } as any,
+      projectSettings: { githubTrackingDefaultRepo: "o/r" } as any,
+      globalSettings: {},
+      logger: { warn, info: vi.fn() },
+    });
+
+    expect(result).toEqual({ created: false, reason: "github_error" });
+    expect(warn).toHaveBeenCalled();
+  });
+});