feat: add AI coding tool detection with per-tool metrics and VCP display

Detect which AI coding tools (Claude, Copilot, Cursor, Aider, etc.) are
used in commits via Co-Authored-By trailer parsing. Compute per-tool
breakdowns, collaboration rates, and confidence levels. Display in repo
VCPs, unified dashboard, and public profiles with a settings toggle.

- Add AI_TOOL_REGISTRY (11 tools) and identifyAITool() to core engine
- Add AIToolMetrics type, extractAIToolMetrics(), and cross-repo aggregation
- Add ai_tools_json column to vibe_insights via migration
- Store AI tool metrics in Inngest worker pipeline
- Add VCPAIToolsSection component for repo, unified, and public VCPs
- Add show_ai_tools toggle to public profile settings (default: on)
- Add architecture doc, update PRD, methodology page, and pipeline docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: devakone

apps/web/src/app/analysis/[jobId]/AnalysisClient.tsx

@@ -3,7 +3,7 @@
 import Link from "next/link";
 import { useEffect, useMemo, useState } from "react";
 import { computeAnalysisInsights } from "@vibed/core";
-import type { AnalysisInsights, AnalysisMetrics, CommitEvent } from "@vibed/core";
+import type { AnalysisInsights, AnalysisMetrics, CommitEvent, AIToolMetrics } from "@vibed/core";
 import { formatMetricLabel, formatMetricValue } from "@/lib/format-labels";
 import { computeShareCardMetrics } from "@/lib/vcp/metrics";
 import { isVibeAxes } from "@/lib/vcp/validators";
@@ -15,6 +15,7 @@ import {
   RepoMetricsGrid,
   ProfileContributionCard,
 } from "@/components/vcp/repo";
+import { VCPAIToolsSection } from "@/components/vcp/blocks";
 
 type Job = {
   id: string;
@@ -103,6 +104,7 @@ type VibeInsightsRow = {
   persona_tagline: string | null;
   persona_confidence: string;
   persona_score: number | null;
+  ai_tools_json?: unknown;
 };
 
 type InsightHistoryEntry = {
@@ -453,6 +455,33 @@ export default function AnalysisClient({ jobId }: { jobId: string }) {
   const persona = wrapped.persona;
   const shareTemplate = wrapped.share_template;
 
+  // AI tool metrics — prefer vibe_insights data, fall back to analysis_insights signals
+  const aiToolMetrics = useMemo<AIToolMetrics | null>(() => {
+    const vibeAiTools = parsedVibeInsights?.ai_tools_json;
+    if (vibeAiTools && typeof vibeAiTools === "object" && "detected" in (vibeAiTools as Record<string, unknown>)) {
+      return vibeAiTools as unknown as AIToolMetrics;
+    }
+    // Fall back to tool_co_authors from analysis insights
+    const toolCoAuthors = wrapped.multi_agent_signals?.tool_co_authors;
+    if (!toolCoAuthors || toolCoAuthors.length === 0) return null;
+    const totalAiCommits = toolCoAuthors.reduce((s, t) => s + t.commit_count, 0);
+    const totalCommits = wrapped.totals?.commits ?? 0;
+    return {
+      detected: true,
+      ai_assisted_commits: totalAiCommits,
+      ai_collaboration_rate: totalCommits > 0 ? totalAiCommits / totalCommits : 0,
+      primary_tool: { id: toolCoAuthors[0].tool_id, name: toolCoAuthors[0].tool_name },
+      tool_diversity: toolCoAuthors.length,
+      tools: toolCoAuthors.map((t) => ({
+        tool_id: t.tool_id,
+        tool_name: t.tool_name,
+        commit_count: t.commit_count,
+        percentage: totalAiCommits > 0 ? Math.round((t.commit_count / totalAiCommits) * 100) : 0,
+      })),
+      confidence: totalAiCommits >= 10 ? "high" : totalAiCommits >= 3 ? "medium" : "low",
+    } satisfies AIToolMetrics;
+  }, [parsedVibeInsights, wrapped]);
+
   const shareText = useMemo(() => {
     if (!shareTemplate) return "";
     const metricsLine = shareTemplate.metrics
@@ -1063,6 +1092,13 @@ export default function AnalysisClient({ jobId }: { jobId: string }) {
                 )}
               </div>
 
+              {/* AI Coding Tools Section */}
+              {aiToolMetrics?.detected ? (
+                <div className="mt-6 rounded-2xl border border-black/5 bg-white/60 p-5 backdrop-blur">
+                  <VCPAIToolsSection aiTools={aiToolMetrics} />
+                </div>
+              ) : null}
+
               {profileContribution ? (
                 <ProfileContributionCard
                   contribution={profileContribution}

apps/web/src/app/api/analysis/[id]/route.ts

@@ -324,7 +324,7 @@ export async function GET(
     const { data: v } = await (supabase as unknown as SupabaseQueryLike)
       .from("vibe_insights")
       .select(
-        "job_id, axes_json, persona_id, persona_name, persona_tagline, persona_confidence, persona_score, cards_json"
+        "job_id, axes_json, persona_id, persona_name, persona_tagline, persona_confidence, persona_score, cards_json, ai_tools_json"
       )
       .eq("job_id", id)
       .single();
@@ -402,6 +402,7 @@ export async function GET(
           persona_confidence: computed.persona.confidence,
           persona_score: computed.persona.score,
           cards_json: computed.cards,
+          ai_tools_json: computed.ai_tools,
         };
       }
       return null;

apps/web/src/app/api/public/[username]/route.ts

@@ -2,6 +2,7 @@ import { NextResponse } from "next/server";
 import { createSupabaseServiceClient } from "@/lib/supabase/service";
 import type { PublicProfileSettings } from "@/types/public-profile";
 import { DEFAULT_PUBLIC_PROFILE_SETTINGS } from "@/types/public-profile";
+import type { AIToolMetrics } from "@vibed/core";
 
 export const runtime = "nodejs";
 
@@ -41,7 +42,7 @@ export async function GET(
   const { data: profile } = await service
     .from("user_profiles")
     .select(
-      "persona_id, persona_name, persona_tagline, persona_confidence, persona_score, total_repos, total_commits, axes_json, cards_json, repo_personas_json, narrative_json"
+      "persona_id, persona_name, persona_tagline, persona_confidence, persona_score, total_repos, total_commits, axes_json, cards_json, repo_personas_json, narrative_json, job_ids"
     )
     .eq("user_id", user.id)
     .maybeSingle();
@@ -99,6 +100,62 @@ export async function GET(
 
   const narrative = profile.narrative_json as { insight?: string; summary?: string } | null;
 
+  // Aggregate AI tool metrics from vibe_insights
+  let aiTools: AIToolMetrics | null = null;
+  if (settings.show_ai_tools) {
+    const jobIds = Array.isArray(profile.job_ids)
+      ? (profile.job_ids as string[]).filter((id): id is string => typeof id === "string")
+      : [];
+
+    if (jobIds.length > 0) {
+      const { data: vibeRows } = await service
+        .from("vibe_insights")
+        .select("ai_tools_json")
+        .in("job_id", jobIds);
+
+      if (vibeRows && vibeRows.length > 0) {
+        const toolCounts = new Map<string, { name: string; count: number }>();
+        let totalAiCommits = 0;
+
+        for (const row of vibeRows) {
+          const tools = row.ai_tools_json as AIToolMetrics | null;
+          if (!tools || !tools.detected) continue;
+          totalAiCommits += tools.ai_assisted_commits;
+          for (const tool of tools.tools) {
+            const existing = toolCounts.get(tool.tool_id);
+            if (existing) {
+              existing.count += tool.commit_count;
+            } else {
+              toolCounts.set(tool.tool_id, { name: tool.tool_name, count: tool.commit_count });
+            }
+          }
+        }
+
+        if (toolCounts.size > 0) {
+          const totalCommits = profile.total_commits ?? 0;
+          const tools = Array.from(toolCounts.entries())
+            .map(([id, data]) => ({
+              tool_id: id,
+              tool_name: data.name,
+              commit_count: data.count,
+              percentage: totalAiCommits > 0 ? Math.round((data.count / totalAiCommits) * 100) : 0,
+            }))
+            .sort((a, b) => b.commit_count - a.commit_count);
+
+          aiTools = {
+            detected: true,
+            ai_assisted_commits: totalAiCommits,
+            ai_collaboration_rate: totalCommits > 0 ? totalAiCommits / totalCommits : 0,
+            primary_tool: { id: tools[0].tool_id, name: tools[0].tool_name },
+            tool_diversity: tools.length,
+            tools,
+            confidence: totalAiCommits >= 10 ? "high" : totalAiCommits >= 3 ? "medium" : "low",
+          };
+        }
+      }
+    }
+  }
+
   const response = {
     username: user.username,
     avatar_url: settings.show_avatar ? user.avatar_url : null,
@@ -114,6 +171,7 @@ export async function GET(
     narrative: settings.show_narrative ? (narrative?.insight ?? narrative?.summary ?? null) : null,
     insight_cards: settings.show_insight_cards ? (profile.cards_json as unknown[] | null) : null,
     repo_breakdown: repoBreakdown,
+    ai_tools: aiTools,
     settings,
   };
 

apps/web/src/app/methodology/page.tsx

@@ -29,6 +29,7 @@ export default async function MethodologyPage() {
             <li>Commit metadata: timestamps, files changed, additions/deletions.</li>
             <li>Commit message subjects: lightweight patterns like feat/fix/test/docs.</li>
             <li>Changed file paths when available (to infer which subsystems changed together).</li>
+            <li>Commit trailers: Co-Authored-By attribution (used to detect AI tool usage).</li>
             <li>PR metadata when available: changed-files counts, issue linking, checklists.</li>
           </ul>
           <p className="text-sm text-zinc-700">
@@ -140,7 +141,39 @@ export default async function MethodologyPage() {
         </section>
 
         <section className={`${wrappedTheme.card} space-y-4 p-6`}>
-          <h2 className="text-lg font-semibold text-zinc-950">5) Why it can be wrong</h2>
+          <h2 className="text-lg font-semibold text-zinc-950">5) AI tool detection</h2>
+          <p className="text-sm text-zinc-700">
+            We detect which AI coding tools you use by parsing{" "}
+            <code className="rounded bg-zinc-100 px-1 py-0.5 text-xs">Co-Authored-By</code>{" "}
+            trailers in your commit messages. Many AI tools (Claude Code, GitHub Copilot, Cursor,
+            Aider, and others) automatically add these trailers when they help write code.
+          </p>
+          <p className="text-sm text-zinc-700">
+            From these trailers we compute:
+          </p>
+          <ul className="list-disc space-y-2 pl-5 text-sm text-zinc-700">
+            <li>
+              <span className="font-semibold text-zinc-950">AI collaboration rate</span> — the
+              fraction of your commits that have AI co-authorship.
+            </li>
+            <li>
+              <span className="font-semibold text-zinc-950">Primary tool</span> — the AI tool that
+              appears most frequently in your history.
+            </li>
+            <li>
+              <span className="font-semibold text-zinc-950">Tool breakdown</span> — per-tool usage
+              percentages across all detected tools.
+            </li>
+          </ul>
+          <p className="text-sm text-zinc-700">
+            We currently recognize 11 tools: Claude, GitHub Copilot, Cursor, Aider, Cline, Roo Code,
+            Windsurf, Devin, Codegen, SWE-Agent, and Gemini. If a tool doesn&apos;t add
+            Co-Authored-By trailers, we can&apos;t detect it — this is a known limitation.
+          </p>
+        </section>
+
+        <section className={`${wrappedTheme.card} space-y-4 p-6`}>
+          <h2 className="text-lg font-semibold text-zinc-950">6) Why it can be wrong</h2>
           <ul className="list-disc space-y-2 pl-5 text-sm text-zinc-700">
             <li>GitHub only shows what’s pushed; local work and private repos may be missing.</li>
             <li>Some repos have incomplete metadata (e.g., missing file paths).</li>

apps/web/src/app/page.tsx

@@ -9,6 +9,7 @@ import {
   aggregateUserProfile,
   computeVibeFromCommits,
   detectVibePersona,
+  type AIToolMetrics,
   type RepoInsightSummary,
   type VibeAxes,
   type VibeCommitEvent,
@@ -21,6 +22,7 @@ import {
   RepoBreakdownSection,
   UnifiedMethodologySection,
 } from "@/components/vcp/unified";
+import { VCPAIToolsSection } from "@/components/vcp/blocks";
 
 const heroFeatures = [
   "A Vibe Coding Profile (VCP) built from AI-assisted engineering signals in your commit history",
@@ -110,6 +112,7 @@ type AuthStats = {
     } | null;
     llmModel?: string | null;
     llmKeySource?: string | null;
+    aiTools?: AIToolMetrics | null;
   };
 };
 
@@ -675,6 +678,50 @@ export default async function Home({
   const latestInsightRepoName = (latestInsightRepoNameResult?.data ??
     null) as unknown as RepoNameRow | null;
 
+  // Fetch aggregated AI tool metrics from vibe_insights
+  let profileAiTools: AIToolMetrics | null = null;
+  if (userProfileData) {
+    const effectiveJobIds = profileJobIds ?? [];
+    if (effectiveJobIds.length > 0) {
+      const { data: vibeRows } = await supabase
+        .from("vibe_insights")
+        .select("ai_tools_json")
+        .in("job_id", effectiveJobIds);
+
+      const vibeToolRows = (vibeRows ?? []) as Array<{ ai_tools_json: unknown }>;
+      if (vibeToolRows.length > 0) {
+        const toolCounts = new Map<string, { name: string; count: number }>();
+        let totalAiCommits = 0;
+        for (const row of vibeToolRows) {
+          const tools = row.ai_tools_json as AIToolMetrics | null;
+          if (!tools || !tools.detected) continue;
+          totalAiCommits += tools.ai_assisted_commits;
+          for (const tool of tools.tools) {
+            const existing = toolCounts.get(tool.tool_id);
+            if (existing) existing.count += tool.commit_count;
+            else toolCounts.set(tool.tool_id, { name: tool.tool_name, count: tool.commit_count });
+          }
+        }
+        if (toolCounts.size > 0) {
+          const total = userProfileData.total_commits ?? 0;
+          const tools = Array.from(toolCounts.entries())
+            .map(([id, d]) => ({
+              tool_id: id, tool_name: d.name, commit_count: d.count,
+              percentage: totalAiCommits > 0 ? Math.round((d.count / totalAiCommits) * 100) : 0,
+            }))
+            .sort((a, b) => b.commit_count - a.commit_count);
+          profileAiTools = {
+            detected: true, ai_assisted_commits: totalAiCommits,
+            ai_collaboration_rate: total > 0 ? totalAiCommits / total : 0,
+            primary_tool: { id: tools[0].tool_id, name: tools[0].tool_name },
+            tool_diversity: tools.length, tools,
+            confidence: totalAiCommits >= 10 ? "high" : totalAiCommits >= 3 ? "medium" : "low",
+          };
+        }
+      }
+    }
+  }
+
   const debugParam = resolvedSearchParams.debug;
   const debugEnabled =
     debugParam === "1" || (Array.isArray(debugParam) && debugParam.includes("1"));
@@ -719,6 +766,7 @@ export default async function Home({
           narrative: userProfileData.narrative_json ?? null,
           llmModel: userProfileData.llm_model ?? null,
           llmKeySource: userProfileData.llm_key_source ?? null,
+          aiTools: profileAiTools,
         }
       : undefined,
   };
@@ -1211,6 +1259,13 @@ function AuthenticatedDashboard({
             <UnifiedAxesSection axes={stats.userProfile.axes} />
           ) : null}
 
+          {/* Section 3b: AI Coding Tools */}
+          {stats.userProfile?.aiTools?.detected ? (
+            <div className="border-t border-black/5 px-8 py-6 sm:px-10">
+              <VCPAIToolsSection aiTools={stats.userProfile.aiTools} />
+            </div>
+          ) : null}
+
           {/* Section 4: Evolution */}
           <EvolutionSection
             repoVcpCount={stats.completedJobs}