@urmzd/github-insights 2.1.0 → 2.3.0

package/.githooks/.sr-hooks-hash

@@ -0,0 +1 @@
+12a4e345c52d1fc0

package/.githooks/commit-msg

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# Generated by sr — edit the hooks section in sr.yaml to modify.
+exec sr hook run commit-msg -- "$@"

package/.githooks/pre-commit

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# Generated by sr — edit the hooks section in sr.yaml to modify.
+exec sr hook run pre-commit -- "$@"

package/AGENTS.md

@@ -2,24 +2,37 @@
 
 ## Identity
 
-You are an agent working on **github-insights** — a GitHub Action that generates beautiful SVG metrics visualizations for GitHub profile READMEs. It produces language breakdowns, AI expertise analysis, contribution pulse, social badges, and signature projects.
+You are an agent working on **github-insights** — a GitHub Action that generates beautiful SVG metrics visualizations for GitHub profile READMEs. It produces language velocity streamgraphs, contribution rhythm radar charts, project constellation maps, and open source impact trails.
 
 ## Architecture
 
-TypeScript/Node.js GitHub Action using React JSX for SVG rendering.
+TypeScript/Node.js GitHub Action using JSX for SVG string rendering (no React — custom `h()` factory).
 
 | File | Role |
 |------|------|
 | `src/index.ts` | Main action entry point |
-| `src/api.ts` | GitHub API interactions |
-| `src/metrics.ts` | Metric calculation logic |
-| `src/templates.ts` | SVG template generation |
+| `src/api.ts` | GitHub API interactions + AI (preamble, project classification) |
+| `src/metrics.ts` | Metric calculation (velocity, rhythm, constellation, sections) |
+| `src/templates.ts` | README template generation (classic, modern, minimal, ecosystem) |
 | `src/config.ts` | Configuration parsing (`github-insights.yml`) |
 | `src/readme.ts` | README generation |
-| `src/types.ts` | Type definitions (`UserConfig`, etc.) |
-| `src/components/` | 22+ component subdirectories for different metric types |
+| `src/types.ts` | Type definitions (`UserConfig`, `TemplateContext`, etc.) |
+| `src/theme.ts` | Theme colors (dark + light), layout constants |
+| `src/components/` | SVG rendering components |
 | `action.yml` | GitHub Action definition |
 
+### SVG Components
+
+| Component | File | Output |
+|-----------|------|--------|
+| Language Velocity | `language-velocity.tsx` | Stacked area streamgraph of language usage over 12 months |
+| Contribution Rhythm | `contribution-rhythm.tsx` | 7-spoke radar chart + summary stats |
+| Project Constellation | `project-constellation.tsx` | Node-link map by language ecosystem and complexity |
+| Impact Trail | `impact-trail.tsx` | External contributions with logarithmic star bars |
+| Section Header | `section.tsx` | Reusable section headers and dividers |
+| Style Defs | `style-defs.tsx` | CSS styles, animations, light/dark theme media query |
+| Full SVG | `full-svg.tsx` | Combines sections into index.svg |
+
 ## Key Dependencies
 
 - `@actions/core`, `@actions/exec`, `@actions/github` — GitHub Action SDK
@@ -46,24 +59,24 @@ TypeScript/Node.js GitHub Action using React JSX for SVG rendering.
 - TypeScript with strict mode, ES modules (`"type": "module"`)
 - Biome for formatting and linting (not ESLint/Prettier)
 - Node.js 22+ (`.nvmrc`)
-- Tests colocated as `*.test.ts` alongside source files
-- Components are React JSX returning SVG elements
+- Tests colocated as `*.test.ts` / `*.test.tsx` alongside source files
+- Components use JSX that compiles to SVG strings via custom `h()` factory
 
 ## Output Files
 
 | File | Description |
 |------|-------------|
 | `assets/insights/index.svg` | Combined visualization |
-| `assets/insights/metrics-pulse.svg` | Contribution activity |
-| `assets/insights/metrics-languages.svg` | Language donut chart |
-| `assets/insights/metrics-expertise.svg` | AI expertise bars |
-| `assets/insights/metrics-complexity.svg` | Top projects by stars |
-| `assets/insights/metrics-contributions.svg` | External contributions |
+| `assets/insights/metrics-velocity.svg` | Language Velocity streamgraph |
+| `assets/insights/metrics-rhythm.svg` | Contribution Rhythm radar + stats |
+| `assets/insights/metrics-constellation.svg` | Project Constellation map |
+| `assets/insights/metrics-impact.svg` | Open Source Impact trail |
 
 ## Adding a New Component
 
-1. Create `src/components/<name>/` directory
-2. Add the component as a React JSX function returning SVG elements
-3. Add a corresponding `*.test.ts` file
-4. Wire it into `src/templates.ts` and `src/metrics.ts`
-5. Update `action.yml` if new inputs are needed
+1. Create `src/components/<name>.tsx`
+2. Export a render function: `(data, y) => RenderResult`
+3. Add a corresponding `*.test.tsx` file
+4. Wire it into `src/metrics.ts` (add to `buildSections()`)
+5. Update `SECTION_KEYS` in `metrics.ts`
+6. Update templates in `src/templates.ts` if it needs template-specific placement

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## 2.3.0 (2026-03-23)
+
+### Features
+
+- add visualization components and centralized types ([b770442](https://github.com/urmzd/github-insights/commit/b77044202eb1e366f4d0b84902de8bfa3854a135))
+
+### Documentation
+
+- add example visualization assets for metrics documentation ([9870e5c](https://github.com/urmzd/github-insights/commit/9870e5c76894511e73a0c2984185436f8f09555b))
+
+### Miscellaneous
+
+- **ci**: update githooks configuration ([683e0e2](https://github.com/urmzd/github-insights/commit/683e0e208f15b6431fc51d35781fb0694ae1f405))
+
+[Full Changelog](https://github.com/urmzd/github-insights/compare/v2.2.0...v2.3.0)
+
+
+## 2.2.0 (2026-03-22)
+
+### Features
+
+- **components**: add new metrics visualization components ([ffd507f](https://github.com/urmzd/github-insights/commit/ffd507f323026bc7221f87be717dc25512e7a0b7))
+- **theme**: add light mode support and update layout metrics ([6f3d029](https://github.com/urmzd/github-insights/commit/6f3d0291e21596268e3cb99e206838b17cd7f0b4))
+
+### Documentation
+
+- **skill**: update GitHub Insights branding and section definitions ([e4d16aa](https://github.com/urmzd/github-insights/commit/e4d16aab59906e8a49d1ba2cf11a90dbf9d4528b))
+- **contributing**: clarify file descriptions and remove brittle line references ([acf814b](https://github.com/urmzd/github-insights/commit/acf814b8a3b1fa9e9755037bc67c67e43be9e7e1))
+- update documentation for new metrics visualization system ([ae4bd64](https://github.com/urmzd/github-insights/commit/ae4bd6470ce53105a857da612b891d14026e0f2f))
+- **examples**: update example outputs with new metrics visualizations ([e20b83e](https://github.com/urmzd/github-insights/commit/e20b83eed00cc828fda4ca39dff68103df8bdf53))
+
+### Refactoring
+
+- **components**: remove language group labels from constellation ([fdc10e5](https://github.com/urmzd/github-insights/commit/fdc10e507cf4be3576eb76e45c542a58b59172c3))
+- **components**: remove unused parameter from map function in language-velocity ([7c0e10f](https://github.com/urmzd/github-insights/commit/7c0e10f0931499c9416e785d25a5c99b252ab1df))
+- **metrics**: remove unused projects parameter from buildSections ([c377064](https://github.com/urmzd/github-insights/commit/c377064e830e6daf0d6975f6860f74f6cb6b4f79))
+- **contribution-rhythm**: remove most active day display ([bca985a](https://github.com/urmzd/github-insights/commit/bca985ab0281646f1c2451eda7417888cad42935))
+- **core**: migrate to new metrics and visualization pipeline ([dd8e668](https://github.com/urmzd/github-insights/commit/dd8e668c4e42477bd655dd17eeeacdbf80d59003))
+- **templates**: update readme generation for new metrics ([4dbc556](https://github.com/urmzd/github-insights/commit/4dbc5562f385fe9626796b04926400a796763265))
+- **rendering**: simplify section rendering with new component system ([719e884](https://github.com/urmzd/github-insights/commit/719e884f26fb13b29f8202a9065b06271c409259))
+- **api**: remove deprecated expertise analysis fetching ([9d98640](https://github.com/urmzd/github-insights/commit/9d98640d72877284ded5c9d9498f1c9ac8f824c3))
+- **metrics**: implement new metric computation functions ([5026fa8](https://github.com/urmzd/github-insights/commit/5026fa8c19ca8b08dc1b6f35cc0749843d68086a))
+- **types**: update types for new metrics visualization system ([6f195bb](https://github.com/urmzd/github-insights/commit/6f195bbf5aa165b4c26b07fb732beab4bb98a87c))
+
+### Miscellaneous
+
+- regenerate compiled artifacts ([c3222b2](https://github.com/urmzd/github-insights/commit/c3222b2433ba2122517ac2696eb37c7187759abe))
+- **contribution-rhythm**: remove trailing whitespace ([c8c53f9](https://github.com/urmzd/github-insights/commit/c8c53f9c9b4f5de360e7e7186152281f692ebf7f))
+- **hooks**: configure git hooks for code validation ([ed97a29](https://github.com/urmzd/github-insights/commit/ed97a29c56e9f7f0d8018c66e804cc70ab5e266d))
+- rebuild distribution with calendar-weighted monthly distributions ([2334ed1](https://github.com/urmzd/github-insights/commit/2334ed1fb9f58c8bfaf2222ed1c8e8e80f623df7))
+- **test**: consolidate test assertion to single line ([75b18a5](https://github.com/urmzd/github-insights/commit/75b18a5e1e7199e3692963e448fa7f537673f39c))
+- **metrics**: reformat totalWeight calculation for readability ([13547a3](https://github.com/urmzd/github-insights/commit/13547a3447ea1589859390d001751be2f310963f))
+- remove outdated metrics example files ([f5bf142](https://github.com/urmzd/github-insights/commit/f5bf14238372750eb712bcc9144c0a20cdfbef42))
+- **full-svg**: update test expectations for new rendering pattern ([a692e6c](https://github.com/urmzd/github-insights/commit/a692e6c33c3a68ef6d8491d87ba9a070455a355e))
+- remove teasr demo configuration ([6c64e56](https://github.com/urmzd/github-insights/commit/6c64e56cada6ca59e98a1963e6c799ebdaa600c3))
+- rebuild distribution for new visualization system ([a543b8f](https://github.com/urmzd/github-insights/commit/a543b8f7386c49552f840d1b5d4129a87ffdced4))
+- update test expectations for new metrics system ([b421284](https://github.com/urmzd/github-insights/commit/b4212845cce3e2e3f8791c43c22af9f5e212ec41))
+- **components**: remove deprecated visualization components ([1a8c9b4](https://github.com/urmzd/github-insights/commit/1a8c9b46c275cc96552efdf818e69657bc6c6c0d))
+
+[Full Changelog](https://github.com/urmzd/github-insights/compare/v2.1.0...v2.2.0)
+
+
 ## 2.1.0 (2026-03-18)
 
 ### Features

package/CONTRIBUTING.md

@@ -6,34 +6,32 @@
 src/
   index.ts          # Entry point — orchestrates fetch, transform, render, write
   api.ts            # GitHub GraphQL/REST API calls + AI model calls
-  metrics.ts        # Data aggregation and section definitions
-  config.ts         # TOML config parsing (UserConfig)
+  metrics.ts        # Data aggregation, velocity/rhythm/constellation, section definitions
+  config.ts         # YAML/TOML config parsing (UserConfig)
   readme.ts         # Profile README generation
   parsers.ts        # Dependency manifest parsers
   types.ts          # Shared type definitions
   jsx-factory.ts    # Custom JSX factory for SVG rendering
   jsx.d.ts          # JSX type declarations
-  theme.ts          # Theme constants (colors, fonts, spacing)
+  theme.ts          # Theme constants (dark + light), fonts, spacing
   svg-utils.ts      # SVG utility functions
   __fixtures__/
     repos.ts        # Test fixture data
   components/       # SVG rendering components
     full-svg.tsx    # Combines sections into a single SVG
     section.tsx     # Individual section renderer
-    donut-chart.tsx # Language donut chart
-    bar-chart.tsx   # Horizontal bar chart
-    tech-highlights.tsx  # Expertise bars
-    stat-cards.tsx  # Contribution stat cards
-    project-cards.tsx    # Project cards
-    contribution-cards.tsx # External contribution cards
-    style-defs.tsx  # Shared SVG style definitions
+    language-velocity.tsx    # Streamgraph of language usage over time
+    contribution-rhythm.tsx  # Radar chart + contribution stats
+    project-constellation.tsx # Node-link project map
+    impact-trail.tsx         # External contribution impact bars
+    style-defs.tsx  # Shared SVG style definitions + light/dark theme + animations
 ```
 
 ## Adding a New Metric Section
 
 1. If your section needs a new render component, create it in `src/components/`. It should export a function that takes data + a `y` offset and returns `{ svg: string, height: number }`.
 
-2. Add your section to `buildSections` in `src/metrics.ts` (line ~91). Each section is a `SectionDef` (`src/types.ts:54`):
+2. Add your section to `buildSections` in `src/metrics.ts`. Each section is a `SectionDef` (`src/types.ts`):
 
 ```typescript
 sections.push({
@@ -44,13 +42,14 @@ sections.push({
 });
 ```
 
-3. The section is automatically included in the combined `index.svg` and written as a standalone SVG.
+3. Add the section key to `SECTION_KEYS` in `src/metrics.ts`.
+4. The section is automatically included in the combined `index.svg` and written as a standalone SVG.
 
 ## Adding a Package Parser
 
-Package parsers extract dependency names from manifest files so the AI expertise analysis can see what libraries you use.
+Package parsers extract dependency names from manifest files.
 
-1. Create a `PackageParser` implementation (`src/types.ts:113`):
+1. Create a `PackageParser` implementation (`src/types.ts`):
 
 ```typescript
 export const MyParser: PackageParser = {
@@ -62,13 +61,13 @@ export const MyParser: PackageParser = {
 };
 ```
 
-2. Add it to the `PARSERS` array in `src/parsers.ts` (line ~129).
+2. Add it to the `PARSERS` array in `src/parsers.ts`.
 
-3. Add the manifest filename to `MANIFEST_FILES` in `src/api.ts` (line ~13) so the API fetches it from repos.
+3. Add the manifest filename to `MANIFEST_FILES` in `src/api.ts` so the API fetches it from repos.
 
 ## Adding Config Fields
 
-1. Add the field to the `UserConfig` interface in `src/types.ts` (line ~126).
+1. Add the field to the `UserConfig` interface in `src/types.ts`.
 
 2. Add parsing logic in `parseUserConfig` in `src/config.ts` — follow the existing pattern of type-checking and trimming.
 
@@ -77,9 +76,9 @@ export const MyParser: PackageParser = {
 ## Testing
 
 - Tests use [Vitest](https://vitest.dev/) with `*.test.ts` and `*.test.tsx` naming conventions
-- Use `.test.tsx` for tests that exercise JSX components (e.g., `src/components/section.test.tsx`)
+- Use `.test.tsx` for tests that exercise JSX components
 - Run tests: `npm test`
-- Tests live alongside source files (e.g., `src/config.test.ts`, `src/components/donut-chart.test.tsx`)
+- Tests live alongside source files
 
 ## Code Style
 

package/README.md

@@ -24,13 +24,15 @@
 
 ## Features
 
-- **Language breakdown** — donut chart of languages by bytes across all public repos
-- **AI expertise analysis** — categorized skill bars with proficiency scores, powered by GitHub Models
+- **Language Velocity** — streamgraph showing how your language usage has evolved over the past year
+- **Contribution Rhythm** — radar chart revealing day-of-week commit patterns, plus stats (commits, PRs, reviews, streak)
+- **Project Constellation** — visual map of projects positioned by language ecosystem and complexity, with connections between related repos
+- **Open Source Impact** — external contributions sorted by repo star count with logarithmic impact bars
 - **AI preamble generation** — auto-generated profile introduction (or supply your own `PREAMBLE.md`)
+- **AI project classification** — repos classified by status (active/maintained/inactive) and purpose (Developer Tools/SDKs/Applications/Research)
 - **Social badges** — auto-detected from your GitHub profile (website, Twitter, LinkedIn, etc.)
-- **Contribution pulse** — commits, PRs, reviews, and active repos at a glance
-- **Signature projects** — top repos by stars with descriptions
-- **Open source contributions** — external repos you've contributed to
+- **Dual theme** — SVGs automatically adapt to GitHub's light and dark mode via `prefers-color-scheme`
+- **CSS animations** — subtle fade-in and scale animations on load
 - **Configuration** — customize name, title, bio, and more via `github-insights.yml`
 
 ## Quick Start
@@ -73,7 +75,7 @@ The action commits updated SVGs and a generated `README.md` to your repo automat
 | `commit-email` | Git user email for commits | `41898282+github-actions[bot]@users.noreply.github.com` |
 | `config-file` | Path to config file | `github-insights.yml` |
 | `readme-path` | Output path for the generated profile README (set to `none` to skip) | `README.md` (CI) / `_README.md` (local) |
-| `index-only` | When `true`, embeds only the combined `index.svg` in the generated README; when `false`, embeds each section SVG as a separate image (e.g., `metrics-languages.svg`, `metrics-expertise.svg`, etc.) | `true` |
+| `index-only` | When `true`, embeds only the combined `index.svg` in the generated README; when `false`, embeds each section SVG as a separate image | `true` |
 
 ## Configuration
 
@@ -92,18 +94,16 @@ All fields are optional. The `UserConfig` type in `src/types.ts` defines the ful
 
 ## AI Features
 
-### Expertise Analysis
-
-The action uses GitHub Models to analyze your languages, dependencies, topics, and repo READMEs, then produces categorized skill bars with proficiency scores. Requires the `models:read` permission on your token.
-
 ### Preamble Generation
 
-When no custom preamble is provided, the action uses AI to generate a profile introduction. The generated preamble consists of 2-4 short paragraphs drawn from your profile bio, title, expertise areas, top languages, and notable projects. It uses a professional but friendly tone and does not include a heading.
-
-The preamble ends with a row of shields.io social badges for any detected links — website, Twitter/X, LinkedIn, and other social accounts from your GitHub profile. A GitHub badge is not included since the README is already on GitHub.
+When no custom preamble is provided, the action uses AI to generate a profile introduction. The generated preamble consists of 1-2 sentences drawn from your profile bio, title, top languages, and notable projects. It uses a professional but friendly tone.
 
 To use your own text instead, create a `PREAMBLE.md` file in the repo root, or point to a custom file via the `preamble` field in `github-insights.yml`.
 
+### Project Classification
+
+The action uses GitHub Models to classify repositories by maintenance status (active/maintained/inactive) and purpose category (Developer Tools, SDKs, Applications, Research & Experiments), with AI-generated summaries for each project.
+
 ### Token Permissions
 
 For AI features, your workflow needs:
@@ -111,7 +111,7 @@ For AI features, your workflow needs:
 ```yaml
 permissions:
   contents: write  # to commit generated files
-  models: read     # for AI expertise analysis and preamble generation
+  models: read     # for AI project classification and preamble generation
 ```
 
 ## Templates
@@ -121,20 +121,18 @@ Four built-in templates control the generated README layout:
 | Template | Description |
 |----------|-------------|
 | `classic` | Name heading, title blockquote, preamble, SVG metrics, bio footer |
-| `modern` | Wave greeting, social badges, projects by activity (Active/Maintained/Inactive), GitHub Stats, expertise |
+| `modern` | Wave greeting, projects by activity (Active/Maintained/Inactive), Project Map, GitHub Stats, Impact |
 | `minimal` | First name heading, preamble, social badges, SVG metrics |
-| `ecosystem` | Wave greeting, social badges, projects by purpose (Developer Tools/SDKs/Applications/Research), GitHub Stats, expertise |
+| `ecosystem` | Wave greeting, projects by purpose (Developer Tools/SDKs/Applications/Research), Project Map, GitHub Stats, Impact |
 
 Set via the `template` input (default: `classic`) or `github-insights.yml`:
 
 ```yaml
-- uses: urmzd/github-insights@v1
+- uses: urmzd/github-insights@main
   with:
     template: ecosystem
 ```
 
-The **ecosystem** template groups projects into purpose-based tables using AI classification, matching the layout used by [urmzd's profile README](https://github.com/urmzd).
-
 ## Local Development
 
 ### Prerequisites
@@ -162,11 +160,10 @@ npm run fmt:fix     # format fix
 | File | Description |
 |------|-------------|
 | `assets/insights/index.svg` | Combined visualization with all sections |
-| `assets/insights/metrics-pulse.svg` | Contribution activity stats |
-| `assets/insights/metrics-languages.svg` | Language breakdown donut chart |
-| `assets/insights/metrics-expertise.svg` | AI-generated expertise bars |
-| `assets/insights/metrics-complexity.svg` | Top projects by stars |
-| `assets/insights/metrics-contributions.svg` | External open source contributions |
+| `assets/insights/metrics-velocity.svg` | Language Velocity streamgraph |
+| `assets/insights/metrics-rhythm.svg` | Contribution Rhythm radar + stats |
+| `assets/insights/metrics-constellation.svg` | Project Constellation map |
+| `assets/insights/metrics-impact.svg` | Open Source Impact trail |
 | `README.md` | Generated profile README (CI); `_README.md` locally |
 
 ## Agent Skill

package/action.yml

@@ -38,7 +38,7 @@ inputs:
     description: "README template to use: classic, modern, minimal, or ecosystem"
     default: "classic"
   sections:
-    description: "Comma-separated list of sections to generate (e.g. pulse,languages,expertise,projects,contributions,calendar). Empty = all."
+    description: "Comma-separated list of sections to generate (e.g. velocity,rhythm,constellation,impact). Empty = all."
     default: ""
 runs:
   using: "node24"