wetwire

wetwire-github-go

Declarative GitHub YAML configurations using native Go constructs.

Overview

wetwire-github-go generates GitHub Actions workflows, Dependabot configs, and Issue Templates from typed Go declarations. No YAML required.

package ci

import (
    "github.com/lex00/wetwire-github-go/workflow"
    "github.com/lex00/wetwire-github-go/actions/checkout"
    "github.com/lex00/wetwire-github-go/actions/setup_go"
)

// Workflow declaration
var CI = workflow.Workflow{
    Name: "CI",
    On:   CITriggers,
}

// Triggers as flat variable
var CITriggers = workflow.Triggers{
    Push:        &CIPush,
    PullRequest: &CIPullRequest,
}

var CIPush = workflow.PushTrigger{Branches: []string{"main"}}
var CIPullRequest = workflow.PullRequestTrigger{Branches: []string{"main"}}

// Job declaration
var Build = workflow.Job{
    Name:   "build",
    RunsOn: "ubuntu-latest",
    Steps:  BuildSteps,
}

var BuildSteps = []any{
    checkout.Checkout{},
    setup_go.SetupGo{GoVersion: "1.23"},
    workflow.Step{Run: "go build ./..."},
    workflow.Step{Run: "go test ./..."},
}

Build to YAML:

wetwire-github build ./ci
# Outputs .github/workflows/ci.yml

The "No Parens" Pattern

Resources are declared as Go variables using struct literals — no function calls needed:

// Declare variables
var MyWorkflow = workflow.Workflow{...}
var BuildJob = workflow.Job{...}
var TestJob = workflow.Job{...}

// Cross-references via direct field access
var DeployJob = workflow.Job{
    Needs: []any{BuildJob, TestJob},  // Automatic dependency resolution
}

// Type-safe action wrappers
var CheckoutStep = checkout.Checkout{
    FetchDepth: 0,
    Submodules: "recursive",
}

// Expression contexts
var ConditionalStep = workflow.Step{
    If:  workflow.Branch("main").And(workflow.Push()),
    Run: "deploy.sh",
    Env: workflow.Env{
        "TOKEN": workflow.Secrets.Get("DEPLOY_TOKEN"),
    },
}

// Matrix configuration
var BuildMatrix = workflow.Matrix{
    Values: map[string][]any{"go": {"1.22", "1.23"}},
}

var BuildStrategy = workflow.Strategy{
    Matrix: &BuildMatrix,
}

var MatrixJob = workflow.Job{
    RunsOn:   "ubuntu-latest",
    Strategy: &BuildStrategy,
}

The CLI discovers declarations via AST parsing — no registration required.

Helpers

// []string{} for typed slices
Branches: []string{"main", "develop"}

// []any{} for mixed-type slices
Needs: []any{BuildJob, TestJob}

// Env type alias
Env: workflow.Env{"TOKEN": workflow.Secrets.Get("TOKEN")}

Generated Package Structure

Import existing workflows or init a new project:

wetwire-github import .github/workflows/ci.yml -o my-ci/
# OR
wetwire-github init my-ci/

Generated structure:

my-ci/
├── go.mod                    # Module with wetwire-github-go dependency
├── README.md                 # Generated docs
├── cmd/main.go               # Usage instructions
└── workflows/
    ├── workflows.go          # Workflow declarations
    ├── jobs.go               # Job declarations
    ├── triggers.go           # Trigger configurations
    └── steps.go              # Step declarations

All nested structs become flat variables.

Scope

AI-Assisted Design with Kiro

wetwire-github integrates with Kiro CLI for AI-assisted workflow design:

# Install and authenticate with Kiro
curl -fsSL https://cli.kiro.dev/install | bash
kiro-cli login

# Start AI-assisted design session
wetwire-github design --provider kiro "Create a CI workflow for a Go project"

The MCP server (wetwire-github mcp) exposes tools for AI assistants:

• wetwire_init - Initialize new workflow projects
• wetwire_lint - Validate code against WAG001-WAG008 rules
• wetwire_build - Generate .github/workflows/*.yml from Go code
• wetwire_validate - Validate YAML with actionlint

See docs/GITHUB-KIRO-CLI.md for complete integration guide.

Status

Under development. See Roadmap for implementation plan and feature matrix.

For the wetwire pattern, see the Wetwire Specification.

License

MIT