@urmzd/github-insights 2.0.1 → 2.2.0

package/src/index.ts

@@ -6,10 +6,7 @@ import {
   fetchAIPreamble,
   fetchAllRepoData,
   fetchContributionData,
-  fetchExpertiseAnalysis,
-  fetchManifestsForRepos,
   fetchProjectClassifications,
-  fetchReadmeForRepos,
   fetchUserProfile,
   makeGraphql,
 } from "./api.js";
@@ -20,8 +17,9 @@ import {
   aggregateLanguages,
   buildClassificationInputs,
   buildSections,
-  collectAllDependencies,
-  collectAllTopics,
+  computeConstellationLayout,
+  computeContributionRhythm,
+  computeLanguageVelocity,
   getTopProjectsByComplexity,
   SECTION_KEYS,
   splitProjectsByRecency,
@@ -87,74 +85,55 @@ async function run(): Promise<void> {
     const repos = await fetchAllRepoData(graphql, username);
     core.info(`Found ${repos.length} public repos`);
 
-    core.info("Fetching dependency manifests...");
     core.info("Fetching contribution data...");
-    core.info("Fetching READMEs...");
     core.info("Fetching user profile...");
-    const [manifests, contributionData, readmeMap, userProfile] =
-      await Promise.all([
-        fetchManifestsForRepos(graphql, username, repos),
-        fetchContributionData(graphql, username),
-        fetchReadmeForRepos(graphql, username, repos),
-        fetchUserProfile(graphql, username),
-      ]);
-    core.info(`Fetched manifests for ${manifests.size} repos`);
+    const [contributionData, userProfile] = await Promise.all([
+      fetchContributionData(graphql, username),
+      fetchUserProfile(graphql, username),
+    ]);
     core.info(
       `Contributions: ${contributionData.contributions.totalCommitContributions} commits, ${contributionData.contributions.totalPullRequestContributions} PRs`,
     );
-    core.info(`Fetched READMEs for ${readmeMap.size} repos`);
     core.info(`User profile: ${userProfile.name || username}`);
 
     // ── Transform ─────────────────────────────────────────────────────────
     const languages = aggregateLanguages(repos);
     const complexProjects = getTopProjectsByComplexity(repos);
-    const projects = complexProjects.slice(0, 5);
-
-    const allDeps = collectAllDependencies(repos, manifests);
-    const allTopics = collectAllTopics(repos);
 
     core.info("Fetching project classifications from GitHub Models...");
     const classificationInputs = buildClassificationInputs(
       repos,
       contributionData,
     );
-    const [aiClassifications, techHighlights] = await Promise.all([
-      fetchProjectClassifications(token, classificationInputs),
-      (async () => {
-        core.info("Fetching expertise analysis from GitHub Models...");
-        return fetchExpertiseAnalysis(
-          token,
-          languages,
-          allDeps,
-          allTopics,
-          repos,
-          readmeMap,
-          userConfig,
-        );
-      })(),
-    ]);
+    const aiClassifications = await fetchProjectClassifications(
+      token,
+      classificationInputs,
+    );
     core.info(
       `Project classifications: ${aiClassifications.length} AI-classified (${repos.length - aiClassifications.length} heuristic fallback)`,
     );
-    core.info(`Expertise analysis: ${techHighlights.length} categories`);
 
     const {
       active: activeProjects,
       maintained: maintainedProjects,
       inactive: inactiveProjects,
+      archived: archivedProjects,
     } = splitProjectsByRecency(repos, contributionData, aiClassifications);
 
+    // ── Compute new visualization data ───────────────────────────────────
+    const velocity = computeLanguageVelocity(contributionData, repos);
+    const rhythm = computeContributionRhythm(contributionData);
+    const constellation = computeConstellationLayout(complexProjects, repos);
+
     const sectionDefs = buildSections({
-      languages,
-      techHighlights,
-      projects,
+      velocity,
+      rhythm,
+      constellation,
       contributionData,
     });
 
     // Filter sections by requested keys if specified
-    let activeSections = sectionDefs.filter(
-      (s) => s.renderBody || (s.items && s.items.length > 0),
-    );
+    let activeSections = sectionDefs.filter((s) => s.renderBody);
     if (requestedSections.length > 0) {
       const allowedFilenames = new Set(
         requestedSections.map((key) => SECTION_KEYS[key]).filter(Boolean),
@@ -168,11 +147,11 @@ async function run(): Promise<void> {
     mkdirSync(outputDir, { recursive: true });
 
     for (const section of activeSections) {
+      if (!section.renderBody) continue;
       const { svg, height } = renderSection(
         section.title,
         section.subtitle,
-        section.renderBody || section.items || [],
-        section.options || {},
+        section.renderBody,
       );
       writeFileSync(
         `${outputDir}/${section.filename}`,
@@ -198,7 +177,6 @@ async function run(): Promise<void> {
           profile: userProfile,
           userConfig,
           languages,
-          techHighlights,
           activeProjects,
           complexProjects,
         });
@@ -227,6 +205,7 @@ async function run(): Promise<void> {
         ...activeProjects,
         ...maintainedProjects,
         ...inactiveProjects,
+        ...archivedProjects,
       ];
       const categorizedProjects: Record<string, typeof allProjectItems> = {};
       for (const project of allProjectItems) {
@@ -245,16 +224,20 @@ async function run(): Promise<void> {
           title: userConfig.title,
           bio: userConfig.bio,
           preamble,
+          templateName,
           svgs,
           sectionSvgs,
           profile: userProfile,
           activeProjects,
           maintainedProjects,
           inactiveProjects,
+          archivedProjects,
           allProjects: complexProjects,
           categorizedProjects,
           languages,
-          techHighlights,
+          velocity,
+          rhythm,
+          constellation,
           contributionData,
           socialBadges,
           svgDir,
@@ -308,16 +291,20 @@ async function run(): Promise<void> {
             title: userConfig.title,
             bio: userConfig.bio,
             preamble,
+            templateName: tplName,
             svgs: previewSvgs,
             sectionSvgs: previewSectionSvgs,
             profile: userProfile,
             activeProjects,
             maintainedProjects,
             inactiveProjects,
+            archivedProjects,
             allProjects: complexProjects,
             categorizedProjects,
             languages,
-            techHighlights,
+            velocity,
+            rhythm,
+            constellation,
             contributionData,
             socialBadges,
             svgDir: ".",

package/src/metrics.test.ts

@@ -13,7 +13,11 @@ import {
   SECTION_KEYS,
   splitProjectsByRecency,
 } from "./metrics.js";
-import type { ManifestMap, TechHighlight } from "./types.js";
+import type {
+  ContributionRhythm,
+  ManifestMap,
+  MonthlyLanguageBucket,
+} from "./types.js";
 
 // ── aggregateLanguages ──────────────────────────────────────────────────────
 
@@ -534,37 +538,48 @@ describe("splitProjectsByRecency", () => {
 
 describe("SECTION_KEYS", () => {
   it("maps all known section names to filenames", () => {
-    expect(SECTION_KEYS.pulse).toBe("metrics-pulse.svg");
-    expect(SECTION_KEYS.languages).toBe("metrics-languages.svg");
-    expect(SECTION_KEYS.expertise).toBe("metrics-expertise.svg");
-    expect(SECTION_KEYS.projects).toBe("metrics-complexity.svg");
-    expect(SECTION_KEYS.contributions).toBe("metrics-contributions.svg");
-    expect(SECTION_KEYS.calendar).toBe("metrics-calendar.svg");
+    expect(SECTION_KEYS.velocity).toBe("metrics-velocity.svg");
+    expect(SECTION_KEYS.rhythm).toBe("metrics-rhythm.svg");
+    expect(SECTION_KEYS.constellation).toBe("metrics-constellation.svg");
+    expect(SECTION_KEYS.impact).toBe("metrics-impact.svg");
   });
 });
 
 // ── buildSections ───────────────────────────────────────────────────────────
 
 describe("buildSections", () => {
-  const baseSectionsInput = () => ({
-    languages: [
-      { name: "TypeScript", value: 100, percent: "80.0", color: "#3178c6" },
-      { name: "JavaScript", value: 25, percent: "20.0", color: "#f1e05a" },
+  const makeRhythm = (): ContributionRhythm => ({
+    dayTotals: [10, 20, 15, 25, 18, 12, 5],
+    longestStreak: 7,
+    stats: [
+      { label: "COMMITS", value: "100" },
+      { label: "PRS", value: "10" },
     ],
-    techHighlights: [
-      {
-        category: "Frontend",
-        items: ["React", "TypeScript", "Next.js"],
-        score: 90,
-      },
-      { category: "Backend", items: ["Express", "PostgreSQL"], score: 75 },
-    ] as TechHighlight[],
-    projects: [
+  });
+
+  const makeVelocity = (): MonthlyLanguageBucket[] => [
+    {
+      month: "2025-01",
+      languages: [{ name: "TypeScript", commits: 50, color: "#3178c6" }],
+    },
+    {
+      month: "2025-02",
+      languages: [{ name: "TypeScript", commits: 60, color: "#3178c6" }],
+    },
+  ];
+
+  const baseSectionsInput = () => ({
+    velocity: makeVelocity(),
+    rhythm: makeRhythm(),
+    constellation: [
       {
         name: "big-project",
         url: "https://github.com/user/big-project",
-        description: "A complex project",
-        stars: 85,
+        x: 100,
+        y: 100,
+        radius: 10,
+        color: "#3178c6",
+        connections: [],
       },
     ],
     contributionData: makeContributionData(),
@@ -573,22 +588,21 @@ describe("buildSections", () => {
   it("returns correct filenames", () => {
     const sections = buildSections(baseSectionsInput());
     const filenames = sections.map((s) => s.filename);
-    expect(filenames).toContain("metrics-languages.svg");
-    expect(filenames).toContain("metrics-expertise.svg");
-    expect(filenames).toContain("metrics-complexity.svg");
-    expect(filenames).toContain("metrics-pulse.svg");
+    expect(filenames).toContain("metrics-velocity.svg");
+    expect(filenames).toContain("metrics-rhythm.svg");
+    expect(filenames).toContain("metrics-constellation.svg");
   });
 
-  it("expertise section is conditional on non-empty techHighlights", () => {
+  it("velocity section is conditional on non-empty velocity data", () => {
     const input = baseSectionsInput();
-    input.techHighlights = [];
+    input.velocity = [];
     const sections = buildSections(input);
     expect(sections.map((s) => s.filename)).not.toContain(
-      "metrics-expertise.svg",
+      "metrics-velocity.svg",
     );
   });
 
-  it("contributions section conditional on externalRepos", () => {
+  it("impact section conditional on externalRepos", () => {
     const input = baseSectionsInput();
     input.contributionData = makeContributionData({
       externalRepos: {
@@ -605,41 +619,20 @@ describe("buildSections", () => {
       },
     });
     const sections = buildSections(input);
-    expect(sections.map((s) => s.filename)).toContain(
-      "metrics-contributions.svg",
-    );
+    expect(sections.map((s) => s.filename)).toContain("metrics-impact.svg");
   });
 
-  it("contributions section omitted when no external repos", () => {
+  it("impact section omitted when no external repos", () => {
     const sections = buildSections(baseSectionsInput());
-    expect(sections.map((s) => s.filename)).not.toContain(
-      "metrics-contributions.svg",
-    );
+    expect(sections.map((s) => s.filename)).not.toContain("metrics-impact.svg");
   });
 
-  it("calendar section included when contributionCalendar exists", () => {
+  it("constellation section conditional on non-empty nodes", () => {
     const input = baseSectionsInput();
-    input.contributionData = makeContributionData({
-      contributionCalendar: makeContributionCalendar(),
-    });
+    input.constellation = [];
     const sections = buildSections(input);
-    expect(sections.map((s) => s.filename)).toContain("metrics-calendar.svg");
-  });
-
-  it("calendar section omitted when no contributionCalendar", () => {
-    const sections = buildSections(baseSectionsInput());
     expect(sections.map((s) => s.filename)).not.toContain(
-      "metrics-calendar.svg",
-    );
-  });
-
-  it("uses complexity-based subtitle for signature projects", () => {
-    const sections = buildSections(baseSectionsInput());
-    const projectSection = sections.find(
-      (s) => s.filename === "metrics-complexity.svg",
-    );
-    expect(projectSection?.subtitle).toBe(
-      "Top projects by technical complexity",
+      "metrics-constellation.svg",
     );
   });