Skip to content

Release Notes: v0.2.0

Release Date: 2026-04-25

Overview

VersionConductor v0.2.0 adds dependency graph analysis capabilities for understanding and managing module relationships across multiple GitHub organizations. This release also moves the repository to the plexusone organization.

Highlights

  • Dependency Graph Analysis - Build and analyze module dependency relationships across multi-org portfolios
  • Graph Visualization - Export dependency graphs in DOT (Graphviz) and Mermaid formats
  • Organization Move - Repository moved from grokify/versionconductor to plexusone/versionconductor

New Features

Graph Commands

Command Description
graph build Build dependency graph from repositories
graph dependents <module> List modules that depend on the specified module
graph dependencies <module> List dependencies of the specified module
graph order Show upgrade order for managed modules
graph stale <module> Find modules using outdated versions
graph stats Show graph statistics
graph visualize Output graph in DOT or Mermaid format

Dependency Graph Analysis

# Build graph for an organization
versionconductor graph build --orgs myorg

# Find modules that depend on a specific module
versionconductor graph dependents github.com/myorg/mymodule

# Find dependencies of a module
versionconductor graph dependencies github.com/myorg/mymodule

# Show recommended upgrade order
versionconductor graph order

# Find modules using outdated versions
versionconductor graph stale github.com/myorg/mymodule --min-version v1.2.0

Graph Visualization

# Output DOT format for Graphviz
versionconductor graph visualize --orgs myorg > graph.dot
dot -Tpng graph.dot -o graph.png

# Output Mermaid format
versionconductor graph visualize --orgs myorg --viz-format mermaid

# Include external dependencies
versionconductor graph visualize --orgs myorg --show-external

# Cluster by organization
versionconductor graph visualize --orgs myorg --cluster

Caching & Performance

# Enable caching (default)
versionconductor graph build --orgs myorg --cache

# Custom cache directory
versionconductor graph build --orgs myorg --cache-dir /tmp/vc-cache

# Custom TTL
versionconductor graph build --orgs myorg --cache-ttl 2h

# Disable caching
versionconductor graph build --orgs myorg --no-cache

Installation

go install github.com/plexusone/versionconductor/cmd/versionconductor@v0.2.0

Or build from source:

git clone https://github.com/plexusone/versionconductor.git
cd versionconductor
go build -o versionconductor ./cmd/versionconductor

Token Permissions

For full functionality, your GitHub token needs:

Permission Access Purpose
Pull requests Read & Write List, review, merge PRs
Contents Read & Write Merge commits, delete branches
Metadata Read Required baseline
Actions Read Check CI status
Releases Read & Write Create releases/tags

Breaking Changes

  • Module path changed from github.com/grokify/versionconductor to github.com/plexusone/versionconductor

Dependencies

Module Version Change
github.com/google/go-github v84 Upgraded
github.com/grokify/gogithub v0.12.1 Upgraded
github.com/grokify/mogo v0.74.2 Upgraded

What's Next

  • v0.3.0: Slack/Teams notifications for merge actions
  • v0.4.0: Dashboard for dependency update status
  • Multi-language support (TypeScript, Swift, Python)