Skip to content

Release Notes: v0.2.0

Release Date: 2026-04-25

Overview

PipelineConductor v0.2.0 introduces workflow compliance checking against reference repositories, local filesystem scanning, a GitHub Action for CI integration, and automated workflow remediation. This release also migrates the project to the PlexusOne organization.

Highlights

  • Workflow compliance checking - Check repositories against reference workflow patterns
  • Local filesystem collector - Scan local repositories without GitHub API
  • GitHub Action - Reusable action for compliance checks in CI pipelines
  • Workflow remediation - Generate missing workflows from templates
  • Dashboard generation - Dashforge integration for visual compliance dashboards
  • HTML/Markdown reports - New report formats for compliance check results

New Features

Compliance Checking

Check repository workflows against a reference repository:

# Check organization repos against reference
pipelineconductor check --orgs myorg --ref-repo plexusone/.github

# Check with strict mode (require exact reusable workflow matches)
pipelineconductor check --orgs myorg --ref-repo plexusone/.github --strict

# Output as HTML report
pipelineconductor check --orgs myorg --ref-repo plexusone/.github -f html -o report.html

Compliance levels:

Level Description
full All required workflows present (exact or equivalent)
partial Some required workflows present
none No required workflows found

Local Filesystem Collector

Scan repositories on local disk without GitHub API:

# Scan local directory
pipelineconductor check --local ~/projects --ref-repo plexusone/.github

# Filter by language
pipelineconductor check --local ~/go/src --languages Go

Supports automatic language detection for Go, TypeScript, JavaScript, Python, Rust, and Crystal projects.

GitHub Action

New composite action for CI integration:

- name: Check Compliance
  uses: plexusone/pipelineconductor@v0.2.0
  with:
    ref-repo: 'plexusone/.github'
    orgs: 'myorg'
    format: 'markdown'

Workflow Remediation

Generate missing workflows from built-in templates:

# Dry-run to preview changes
pipelineconductor remediate --local ./myrepo --ref-repo plexusone/.github --dry-run

# Apply generated workflows
pipelineconductor apply --local ./myrepo

Built-in templates for:

  • Go CI (build, test, coverage)
  • Go Lint (golangci-lint)
  • Go SAST (CodeQL)
  • TypeScript CI
  • TypeScript Lint (ESLint)

New CLI Commands

Command Description
check Check workflow compliance against reference repository
remediate Generate missing workflows from templates
apply Apply remediation changes to repositories

Report Formats

New formats for compliance check results:

  • HTML - Styled report with summary tables and compliance indicators
  • Markdown - GitHub-flavored Markdown for PR comments

JSON Schema

Added JSON Schema validation for check results at schema/check_result.schema.json.

Dashboard Generation

Generate interactive Dashforge dashboards from compliance check results:

import "github.com/plexusone/pipelineconductor/internal/dashboard"

// Generate dashboard from check results
db := dashboard.GenerateComplianceDashboard(result, "https://example.com/data.json")

Dashboard includes:

  • Metric widgets - Total repos, compliant/partial/non-compliant counts, compliance rate
  • Bar chart - Compliance rate by language
  • Pie chart - Repository distribution by language
  • Tables - Non-compliant repos and all repos with pagination

Breaking Changes

Module Path Migration

The module path has changed from github.com/grokify/pipelineconductor to github.com/plexusone/pipelineconductor. Update your imports:

// Before
import "github.com/grokify/pipelineconductor/pkg/model"

// After
import "github.com/plexusone/pipelineconductor/pkg/model"

Dependencies

Module Version Change
github.com/cedar-policy/cedar-go v1.6.0 Updated from v1.4.1
github.com/google/go-github/v84 v84.0.0 Updated from v82.0.0
github.com/grokify/gogithub v0.12.1 Updated from v0.7.0
github.com/grokify/mogo v0.74.2 Updated from v0.72.7
github.com/plexusone/dashforge v0.1.0 New - dashboard generation
golang.org/x/oauth2 v0.36.0 Updated

Installation

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

Or build from source:

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

Documentation

What's Next

See Roadmap for planned features:

  • v0.3.0: GitLab support
  • v0.4.0: Trend analysis and historical tracking
  • v0.5.0: PR-based remediation with auto-merge