@urmzd/github-insights 2.0.1 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.1.0 (2026-03-18)
+
+### Features
+
+- separate archived/legacy projects into dedicated sections across all templates ([6327c64](https://github.com/urmzd/github-insights/commit/6327c64e568b5f25affc7a2f2a90a01c49c37ee6))
+
+[Full Changelog](https://github.com/urmzd/github-insights/compare/v2.0.1...v2.1.0)
+
+
 ## 2.0.1 (2026-03-17)
 
 ### Bug Fixes

package/package.json

@@ -31,5 +31,5 @@
     "typecheck": "tsc --noEmit"
   },
   "type": "module",
-  "version": "2.0.1"
+  "version": "2.1.0"
 }

package/src/api.ts

@@ -86,7 +86,7 @@ export const fetchAllRepoData = async (
     { username },
   );
 
-  return data.user.repositories.nodes.filter((r) => !r.isArchived && !r.isFork);
+  return data.user.repositories.nodes.filter((r) => !r.isFork);
 };
 
 export const fetchManifestsForRepos = async (

package/src/index.ts

@@ -142,6 +142,7 @@ async function run(): Promise<void> {
       active: activeProjects,
       maintained: maintainedProjects,
       inactive: inactiveProjects,
+      archived: archivedProjects,
     } = splitProjectsByRecency(repos, contributionData, aiClassifications);
 
     const sectionDefs = buildSections({
@@ -227,6 +228,7 @@ async function run(): Promise<void> {
         ...activeProjects,
         ...maintainedProjects,
         ...inactiveProjects,
+        ...archivedProjects,
       ];
       const categorizedProjects: Record<string, typeof allProjectItems> = {};
       for (const project of allProjectItems) {
@@ -245,12 +247,14 @@ 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,
@@ -308,12 +312,14 @@ 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,

package/src/metrics.ts

@@ -117,6 +117,7 @@ const toProjectItem = (repo: RepoNode): ProjectItem => ({
   languageCount: repo.languages.edges.length,
   codeSize: repo.diskUsage,
   languages: repoLanguages(repo),
+  isArchived: repo.isArchived || undefined,
 });
 
 // ── Top Projects by Stars ───────────────────────────────────────────────────
@@ -190,6 +191,7 @@ export const splitProjectsByRecency = (
   active: ProjectItem[];
   maintained: ProjectItem[];
   inactive: ProjectItem[];
+  archived: ProjectItem[];
 } => {
   const commitMap = new Map<string, number>();
   for (const entry of contributionData.commitContributionsByRepository || []) {
@@ -206,8 +208,17 @@ export const splitProjectsByRecency = (
   const activeRepos: RepoNode[] = [];
   const maintainedRepos: RepoNode[] = [];
   const inactiveRepos: RepoNode[] = [];
+  const archivedRepos: RepoNode[] = [];
 
   for (const repo of repos) {
+    if (repo.isArchived) {
+      archivedRepos.push(repo);
+      console.info(
+        `[archived  ] ${repo.name} (complexity=${complexityScore(repo).toFixed(1)})`,
+      );
+      continue;
+    }
+
     const commits = commitMap.get(repo.name) || 0;
     const aiEntry = aiMap.get(repo.name);
     const status = aiEntry?.status || heuristicStatus(commits, repo.createdAt);
@@ -227,7 +238,7 @@ export const splitProjectsByRecency = (
   }
 
   console.info(
-    `Split: ${activeRepos.length} active, ${maintainedRepos.length} maintained, ${inactiveRepos.length} inactive`,
+    `Split: ${activeRepos.length} active, ${maintainedRepos.length} maintained, ${inactiveRepos.length} inactive, ${archivedRepos.length} archived`,
   );
 
   const sortByComplexity = (a: RepoNode, b: RepoNode) =>
@@ -248,8 +259,11 @@ export const splitProjectsByRecency = (
   const inactive: ProjectItem[] = inactiveRepos
     .sort(sortByComplexity)
     .map(toProjectItemWithSummary);
+  const archived: ProjectItem[] = archivedRepos
+    .sort(sortByComplexity)
+    .map(toProjectItemWithSummary);
 
-  return { active, maintained, inactive };
+  return { active, maintained, inactive, archived };
 };
 
 // ── Section definitions ─────────────────────────────────────────────────────

package/src/templates.test.ts

@@ -44,7 +44,9 @@ const makeContext = (
     },
   ],
   inactiveProjects: [],
+  archivedProjects: [],
   allProjects: [],
+  templateName: "classic",
   categorizedProjects: {
     Applications: [
       {
@@ -241,6 +243,28 @@ describe("classicTemplate", () => {
     expect(output).toContain("/ˈʊrm.zəd/");
   });
 
+  it("includes archived section for archived projects", () => {
+    const output = getTemplate("classic")(
+      makeContext({
+        archivedProjects: [
+          {
+            name: "old-project",
+            url: "https://github.com/urmzd/old-project",
+            description: "An archived project",
+            stars: 2,
+          },
+        ],
+      }),
+    );
+    expect(output).toContain("## Archived");
+    expect(output).toContain("[old-project]");
+  });
+
+  it("omits archived section when no archived projects", () => {
+    const output = getTemplate("classic")(makeContext());
+    expect(output).not.toContain("## Archived");
+  });
+
   it("ends with trailing newline", () => {
     const output = getTemplate("classic")(makeContext());
     expect(output.endsWith("\n")).toBe(true);
@@ -307,6 +331,23 @@ describe("modernTemplate", () => {
     expect(output).toContain("assets/insights/metrics-expertise.svg");
   });
 
+  it("includes archived section separate from active/maintained", () => {
+    const output = getTemplate("modern")(
+      makeContext({
+        archivedProjects: [
+          {
+            name: "legacy-lib",
+            url: "https://github.com/urmzd/legacy-lib",
+            description: "A legacy library",
+            stars: 1,
+          },
+        ],
+      }),
+    );
+    expect(output).toContain("## Archived");
+    expect(output).toContain("[legacy-lib]");
+  });
+
   it("includes social badges", () => {
     const output = getTemplate("modern")(makeContext());
     expect(output).toContain("img.shields.io");
@@ -346,6 +387,23 @@ describe("minimalTemplate", () => {
     expect(output).toContain("@urmzd/github-insights");
   });
 
+  it("includes archived section for archived projects", () => {
+    const output = getTemplate("minimal")(
+      makeContext({
+        archivedProjects: [
+          {
+            name: "old-util",
+            url: "https://github.com/urmzd/old-util",
+            description: "A retired utility",
+            stars: 0,
+          },
+        ],
+      }),
+    );
+    expect(output).toContain("## Archived");
+    expect(output).toContain("[old-util]");
+  });
+
   it("ends with trailing newline", () => {
     const output = getTemplate("minimal")(makeContext());
     expect(output.endsWith("\n")).toBe(true);
@@ -405,6 +463,45 @@ describe("ecosystemTemplate", () => {
     expect(output).toContain("@urmzd/github-insights");
   });
 
+  it("separates archived projects from category tables", () => {
+    const output = getTemplate("ecosystem")(
+      makeContext({
+        archivedProjects: [
+          {
+            name: "old-app",
+            url: "https://github.com/urmzd/old-app",
+            description: "A retired application",
+            stars: 3,
+            category: "Applications",
+          },
+        ],
+        categorizedProjects: {
+          Applications: [
+            {
+              name: "resume-generator",
+              url: "https://github.com/urmzd/resume-generator",
+              description: "CLI tool for professional resumes",
+              stars: 42,
+              category: "Applications",
+            },
+            {
+              name: "old-app",
+              url: "https://github.com/urmzd/old-app",
+              description: "A retired application",
+              stars: 3,
+              category: "Applications",
+            },
+          ],
+        },
+      }),
+    );
+    expect(output).toContain("### Archived");
+    expect(output).toContain("[old-app]");
+    // old-app should NOT appear in the Applications table
+    const appSection = output.split("### Applications")[1].split("###")[0];
+    expect(appSection).not.toContain("old-app");
+  });
+
   it("ends with trailing newline", () => {
     const output = getTemplate("ecosystem")(makeContext());
     expect(output.endsWith("\n")).toBe(true);

package/src/templates.ts

@@ -8,9 +8,9 @@ import type {
 
 // ── Helpers ────────────────────────────────────────────────────────────────
 
-function attribution(): string {
+function attribution(templateName: string): string {
   const now = new Date().toISOString().split("T")[0];
-  return `<sub>Last generated on ${now} using [@urmzd/github-insights](https://github.com/urmzd/github-insights)</sub>`;
+  return `<sub>Last generated on ${now} using [@urmzd/github-insights](https://github.com/urmzd/github-insights) · Template: \`${templateName}\`</sub>`;
 }
 
 export function extractFirstName(fullName: string): string {
@@ -131,11 +131,15 @@ function classicTemplate(ctx: TemplateContext): string {
     parts.push(`![${svg.label}](${svg.path})`);
   }
 
+  if (ctx.archivedProjects.length > 0) {
+    parts.push(renderProjectSection("Archived", ctx.archivedProjects));
+  }
+
   if (ctx.bio) {
     parts.push(`---\n\n<sub>${ctx.bio}</sub>`);
   }
 
-  parts.push(attribution());
+  parts.push(attribution(ctx.templateName));
 
   return `${parts.join("\n\n")}\n`;
 }
@@ -173,6 +177,12 @@ function modernTemplate(ctx: TemplateContext): string {
   );
   if (inactiveSection) parts.push(inactiveSection);
 
+  const archivedSection = renderProjectSection(
+    "Archived",
+    ctx.archivedProjects,
+  );
+  if (archivedSection) parts.push(archivedSection);
+
   // GitHub Stats section: pulse + calendar
   const statsImages: string[] = [];
   if (ctx.sectionSvgs.pulse) {
@@ -192,7 +202,7 @@ function modernTemplate(ctx: TemplateContext): string {
     );
   }
 
-  parts.push(attribution());
+  parts.push(attribution(ctx.templateName));
 
   return `${parts.join("\n\n")}\n`;
 }
@@ -216,7 +226,11 @@ function minimalTemplate(ctx: TemplateContext): string {
     parts.push(`![${svg.label}](${svg.path})`);
   }
 
-  parts.push(attribution());
+  if (ctx.archivedProjects.length > 0) {
+    parts.push(renderProjectSection("Archived", ctx.archivedProjects));
+  }
+
+  parts.push(attribution(ctx.templateName));
 
   return `${parts.join("\n\n")}\n`;
 }
@@ -243,21 +257,34 @@ function ecosystemTemplate(ctx: TemplateContext): string {
     parts.push(ctx.socialBadges);
   }
 
-  // Render project tables grouped by category
+  // Build a set of archived project names to filter them out of category tables
+  const archivedNames = new Set(ctx.archivedProjects.map((p) => p.name));
+
+  // Render project tables grouped by category (excluding archived)
   for (const category of CATEGORY_ORDER) {
-    const projects = ctx.categorizedProjects[category];
+    const projects = ctx.categorizedProjects[category]?.filter(
+      (p) => !archivedNames.has(p.name),
+    );
     if (projects && projects.length > 0) {
       parts.push(renderProjectTable(category, projects));
     }
   }
 
-  // Render any uncategorized projects that don't match known categories
+  // Render any uncategorized projects that don't match known categories (excluding archived)
   for (const [category, projects] of Object.entries(ctx.categorizedProjects)) {
-    if (!CATEGORY_ORDER.includes(category) && projects.length > 0) {
-      parts.push(renderProjectTable(category, projects));
+    if (!CATEGORY_ORDER.includes(category)) {
+      const nonArchived = projects.filter((p) => !archivedNames.has(p.name));
+      if (nonArchived.length > 0) {
+        parts.push(renderProjectTable(category, nonArchived));
+      }
     }
   }
 
+  // Render all archived projects in one consolidated section
+  if (ctx.archivedProjects.length > 0) {
+    parts.push(renderProjectTable("Archived", ctx.archivedProjects));
+  }
+
   // GitHub Stats section: pulse + calendar
   const statsImages: string[] = [];
   if (ctx.sectionSvgs.pulse) {
@@ -277,7 +304,7 @@ function ecosystemTemplate(ctx: TemplateContext): string {
     );
   }
 
-  parts.push(attribution());
+  parts.push(attribution(ctx.templateName));
 
   return `${parts.join("\n\n")}\n`;
 }

package/src/types.ts

@@ -29,6 +29,7 @@ export interface ProjectItem {
   languages?: string[];
   summary?: string;
   category?: string;
+  isArchived?: boolean;
 }
 
 // ── Bar chart generics ──────────────────────────────────────────────────────
@@ -217,12 +218,14 @@ export interface TemplateContext {
   title?: string;
   bio?: string;
   preamble?: string;
+  templateName: TemplateName;
   svgs: SvgEmbed[];
   sectionSvgs: Record<string, string>;
   profile: UserProfile;
   activeProjects: ProjectItem[];
   maintainedProjects: ProjectItem[];
   inactiveProjects: ProjectItem[];
+  archivedProjects: ProjectItem[];
   allProjects: ProjectItem[];
   categorizedProjects: Record<string, ProjectItem[]>;
   languages: LanguageItem[];