Release Notes - v0.5.0¶

Release Date: 2026-07-19

Overview¶

This release adds the omnidevx/ package, a GitHub developer-experience (DevX) collector that normalizes GitHub contribution data into canonical events for the OmniDevX domain.

Installation¶

go get github.com/plexusone/omni-github@v0.5.0

Requires Go 1.26+ and github.com/plexusone/omnidevx-core v0.1.0+.

Highlights¶

New omnidevx/ package - GitHub DevX collector for contribution events
Canonical devx.* events - profile, per-repository, and daily contribution snapshots
REST + GraphQL - built on go-github and githubv4 via gogithub/profile

What's New¶

GitHub DevX Collector (`omnidevx/`)¶

A new collector package that fetches GitHub contribution data and maps it into canonical devx.* events for the OmniDevX domain (github.com/plexusone/omnidevx-core):

import "github.com/plexusone/omni-github/omnidevx"

collector, err := omnidevx.New(omnidevx.Config{
    Token:    os.Getenv("GITHUB_TOKEN"),
    Username: "octocat",
})

result, err := collector.Collect(ctx, core.CollectRequest{
    Subject: core.SubjectRef{PersonID: "person:octocat"},
    Period: core.Period{Start: periodStart, End: periodEnd},
})

Event Types¶

Event	Description
`devx.profile.snapshot`	Whole-profile period totals (commits, PRs, issues, reviews, insertions, deletions)
`devx.contribution.snapshot`	Per-repository period totals
`devx.contribution.recorded`	Daily contribution-calendar counts

Contribution data is sourced from github.com/grokify/gogithub/profile (GraphQL contribution calendar plus per-repository commit statistics). Because GitHub-reported contributions can overlap with locally-collected git commits from other providers, events carry API-mode provenance so the aggregation layer can keep sources separate rather than double-counting.

The collector requires a bounded period (Start and End both set) — GitHub's contribution query needs an explicit range, and unbounded scans of account history are rarely intended.

Package Structure¶

omni-github/
├── omnistorage/         # Storage provider (existing)
├── omniskill/           # Skills for AI agents (existing)
│   └── github/
└── omnidevx/            # NEW: GitHub DevX collector
    ├── doc.go
    ├── github.go
    └── mapping.go

Dependencies¶

Upgrade github.com/grokify/gogithub to v0.14.0 (was v0.13.0)
Add github.com/plexusone/omnidevx-core v0.1.0
Add github.com/shurcooL/githubv4 for GraphQL queries

Migration¶

No breaking changes from v0.4.0. The new omnidevx/ package is additive.

Contributors¶

John Wang
Claude Haiku 4.5