Packages

The Go packages, the layers they form, and the ports that keep the core independent of YAML, shells, runners and output formats.

Layers

Dependencies point inward. domain imports only the standard library; rules imports only domain; app imports rules and domain; adapters import inward layers; cli wires them together, and cmd only calls cli.

flowchart LR
    cmd["cmd/ci-parity<br/>main"] --> cli
    cli["internal/cli<br/>flags, exit codes, wire.go"] --> adapters
    cli --> app
    adapters["internal/adapters<br/>YAML, shell, runners,<br/>baseline file, reports"] --> app
    adapters --> rules
    adapters --> domain
    app["internal/app<br/>check, baseline, fix"] --> rules
    app --> domain
    rules["internal/rules<br/>P001 to P005, suggestions,<br/>fix edits"] --> domain["internal/domain<br/>findings, workflow model,<br/>config, ratchet"]

Package	Holds
`internal/domain`	Findings and severities, the workflow model and script positions, extracted commands, the config value and its globs, the baseline ratchet, edits
`internal/rules`	The rules, suggestions (with package-runner unwrapping) and the edits `fix` can make
`internal/app`	The `check`, `baseline` and `fix` use cases
`internal/adapters`	Everything that touches a file format or the file system
`internal/cli`	Flag parsing, exit codes, and `wire.go`, which builds the adapters
`cmd/ci-parity`	`main`, which calls `cli.Run` with the process’s arguments

The CLI lives in internal/cli rather than package main so the integration tests can call cli.Run in-process; Go can’t import a main package.

Ports and adapters

Each port is an interface the inner layers own; an adapter implements it.

Port	Defined in	Implemented by
`TaskSource`	`internal/rules/ports.go`	`adapters/runner/taskfile`, `makefile`, `justfile`, `mise`
`CommandExtractor`	`internal/rules/ports.go`	`adapters/shell/posix` (bash and sh, with `mvdan.cc/sh/v3`)
`ConfigSource`	`internal/app/ports.go`	`adapters/config/yamlconfig`
`WorkflowSource`	`internal/app/ports.go`	`adapters/workflow/ghactions`
`WorkflowEditor`	`internal/app/ports.go`	`adapters/workflow/ghactions` (`edit.go`)
`TaskLoader`	`internal/app/ports.go`	`adapters/runner` (`loader.go` picks the runner’s reader)
`BaselineStore`	`internal/app/ports.go`	`adapters/baseline/jsonfile`
`Reporter`	`internal/app/ports.go`	`adapters/report/text`, `github`, `json`, `sarif`

Adding a runner, a shell or an output format means a new adapter; the rules and use cases don’t change.

See also

Last reviewed: 2026-10-28