Skip to content

CHANGELOG.md

Latest commit

 

History

History
157 lines (103 loc) · 12.9 KB

CHANGELOG.md

File metadata and controls

157 lines (103 loc) · 12.9 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, this project adheres to Semantic Versioning, commits follow Conventional Commits, and this changelog is generated by Structured Changelog.

Unreleased

v0.4.0 - 2026-08-17

Highlights

  • devfolio devx dashboard --period weekly|monthly|quarterly: calendar-aligned period reports (Monday-Sunday weeks) with weekly/monthly per-model breakdowns, written by default to ~/.plexusone/omnidevx/reports/{type}/{label}.json — the path VisionStudio's /api/devx/periods and /api/devx/reports/{periodType}/{label} endpoints read from
  • Weekly period labels changed from ISO week numbers ("W28") to the week's Monday date ("Mon Jul 6, 2026") for human readability, with the underlying weekly buckets fixed to align to real calendar weeks
  • Bump github.com/plexusone/uiforge to v0.5.0 (static viewer light/dark theme toggle and 2-decimal numeric formatting)

Added

  • --period and --for flags on devfolio devx dashboard: generate weekly/monthly/quarterly calendar reports instead of a rolling --days window, with weekly/monthly model breakdowns feeding the quarterly report's donut and stacked-bar widgets (dbfcf99)

Fixed

  • output/devxdashboard.buildStackedBarData ignored its metrics argument, so the weekly/monthly cost and token stacked-bar charts silently returned identical values; ModelPeriodPoint.Models now carries a metric map per model so each chart pulls its own numbers (dbfcf99)
  • Resolve 4 pre-existing "error discard without comment" findings in cmd/devfolio and datasource/prism via proper return/panic handling instead of silent discard (2dceb0f)

Dependencies

  • Bump github.com/grokify/mogo from v0.74.6 to v0.74.7 (f81f4e3)
  • Bump github.com/plexusone/uiforge from v0.4.0 to v0.5.0 (8fa6ec6)
  • Routine transitive dependency updates via go mod tidy (b1b9994)

Documentation

  • Document devx dashboard --period/--for across README.md, docs/commands/devx.md, docs/index.md, and docs/getting-started.md; note VisionStudio's period endpoints and uiforge v0.5.0's viewer theme toggle (f32d76d)

Internal

  • Fix gofmt drift across 9 files (struct-literal alignment), surfaced by the v0.4.0 release validation gate (e39300b)

v0.3.0 - 2026-08-02

Highlights

  • devfolio quarterly report: self-contained HTML reports joining GitHub stats, git commit analytics, changelog highlights, and OmniDevX token spend — inline SVG or interactive ECharts, with --format dashboard/--format json exports
  • devx dashboard gains period reports: weekly/monthly/quarterly dashboards with model-breakdown donut charts and stacked bar charts by model
  • Contributor profile: per-model AI stats (AIModelStat, MostUsedModel) bridged from gogit.AIStats, plus a new PRISM Control JSONL datasource
  • contributor/client.go migrated off go-github onto gogithub's version-isolated clientv1.Client; github.com/google/go-github is now only a transitive dependency

Added

  • quarterly package: Report type composing GitHub stats, git commit stats, changelog highlights, and a token-spend summary (976f3f8)
  • quarterly.SDLCFlow and Sankey diagram export (tokens → LOC/releases/repos → conventional-commit categories) via uiforge (1f54b6a)
  • contributor.AICollabStatsFromGogit() bridges gogit.AIStats into contributor profile stats; datasource/prism loads PRISM Control JSONL exports (675ca80)
  • output/devxdashboard: PeriodReport/ExportPeriod for weekly/monthly/quarterly dashboards with model-breakdown donut and stacked-bar charts (6421f9d)
  • quarterly.TokenSpendFromReport(): token/cost metrics from a DeveloperPeriodReport, with per-model (ByModel) and per-source (BySource) breakdowns; Builder gains an OmniDevXDir option (72b2567)
  • ModelTokens gains CacheReadTokens/CacheCreationTokens for Anthropic prompt-caching metrics (b32c465)
  • devfolio quarterly report command: self-contained HTML report generation with SVG and ECharts chart engines, --format html/json/dashboard (cc3acf9)
  • quarterly.ExportDashboard(): uiforge Dashboard IR (JSON) export with metric tiles, category-breakdown charts, AI model stats, and token spend visualization (4b63441)

Changed

  • Rename dashforge imports/references to uiforge across the codebase (pure import-path swap, no functional change) (8ad4b31)
  • contributor/client.go migrated from a raw *github.Client to gogithub's clientv1.Client and stable gogithub.* types, including a new ListUserEvents wrapper for the contribution activity heatmap — internal only, no exported API change (3a1db72)

Fixed

  • Resolve golangci-lint findings in quarterly_report.go, output/devxdashboard/period.go, and quarterly/dashboard.go (390f4f9)

Dependencies

  • Bump github.com/grokify/gogithub from v0.13.0 to v0.14.0 (a2a42f4)
  • Add embedded pricing support via github.com/plexusone/omnidevx-core (6f142a0)
  • Routine go mod dependency updates (843406d)
  • Update github.com/grokify/gogithub to v0.16.0, dropping github.com/google/go-github to a transitive dependency (3a1db72)
  • Routine go mod dependency updates (8abb58a)

Documentation

  • Add DoltDB analytics store specification (PRD/TRD/PLAN/ROADMAP) for SQL-based event analytics (f215162)
  • Add comprehensive CLAUDE.md for project onboarding: data sources, output formats, metrics, pricing, common tasks, debugging tips (9c590a3)

Tests

  • Period dashboard export tests: monthly/weekly export, data sources, widget generation (972fe8a)
  • datasource/prism tests (a343b58)

v0.2.0 - 2026-07-20

Highlights

  • devfolio devx dashboard: build a DeveloperPeriodReport from the local OmniDevX event store (Claude Code, Codex CLI, git, GitHub) and export it as a dashforge dashboard
  • MkDocs documentation site, matching the rest of the OmniDevX ecosystem
  • Contributor profile: local git clone detection with automatic API fallback, multi-stage progress reporting, and a dashforge dashboard export flag

Added

  • devfolio devx dashboard command: reads the local OmniDevX store, builds a DeveloperPeriodReport, exports a portable dashforge dashboard (8 metric tiles, daily activity/cost charts, source-coverage table) (13ec741)
  • output/devxdashboard package: projects a DeveloperPeriodReport into dashforge's dashboardir.Dashboard type directly (not a local reimplementation), so chart widgets render correctly in dashforge's current viewer (7aae21c)
  • contributor profile --dashboard: export a dashforge-compatible dashboard from a contributor profile (chart widgets use an older shape — see Documentation) (5b59e38)
  • contributor profile --api-only/--local-path: local git clone detection (checks ~/go/src/github.com and configured paths, falls back to the GitHub API) plus multi-stage progress reporting to stderr (78961b7)
  • MkDocs site: landing page, getting-started walkthrough, command reference for contributor/team/devx, PlexusOne nav override — docs/specs/ (internal ecosystem architecture) deliberately excluded from the built site (a6102a8)

Changed

  • README: add the missing docs-mkdoc badge, document devx dashboard, fix stale links (dashforge pointed at the wrong org twice, license badge pointed at a nonexistent master branch, visualization badge pointed at an unrelated repo) and a stale Go-version/GITHUB_TOKEN requirements claim (f300094)

Dependencies

  • Add github.com/plexusone/dashforge v0.3.0 for the dashboardir types (5738257)
  • Add github.com/plexusone/omnidevx-core v0.2.0 for the report/identity/store packages (e5e8dd1)
  • Bump github.com/google/go-github to v88.0.0, github.com/grokify/gogithub to v0.13.0, github.com/grokify/mogo to v0.74.6, github.com/grokify/structured-changelog to v0.14.1 (routine dependabot updates) (23916a2)

Documentation

  • OmniDevX ecosystem spec set (PRD/TRD/PLAN/ROADMAP) distilled from ideation notes into docs/specs/, covering the canonical event IR through team unification (dda5580)
  • TRD §7: dashboard-projection architecture — the two-artifact export (disclosure-safe data + dashforge dashboard definition), why dashforge over a Grafana/OTel stack, and the VisionStudio consumption boundary (40e1b46)

Infrastructure

  • Gitignore .envrc and IDEATION_CHAT*.md scratch notes (55f4f3a)

v0.1.0 - 2026-02-28

Highlights

  • Developer portfolio and team velocity metrics CLI
  • AI collaboration tracking to measure how AI-native developers are

Added

  • CLI with contributor and team command groups (6711408)
  • contributor profile command to generate comprehensive contributor profiles from GitHub activity (bb0c219)
  • Profile types including commits, PRs, issues, reviews, and repository breakdown (ba04549)
  • GitHub API client for fetching user contributions and activity heatmap data (75da28a)
  • AI collaboration tracking via Co-Authored-By trailer parsing in commit messages (ba04549)
  • Known AI tools registry: Claude Code, GitHub Copilot, Gemini CLI, Cursor, Aider (ba04549)
  • AI commit statistics including percentage, most-used tool, first AI commit date, and trend (ba04549)
  • Activity heatmap data for GitHub-style contribution calendars (75da28a)
  • team velocity placeholder command for team metrics (6711408)

Documentation

  • Project README with usage examples and feature overview (25b5cf7)

Infrastructure

  • GitHub Actions workflows for CI, lint, and SAST via reusable workflows (a562858)
  • Dependabot configuration for daily gomod and github-actions updates (a562858)