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¶
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