Add Go CLI to improve developer experience

.dev/scripts/uv-sync.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Setup Python environment using uv
+set -euo pipefail
+
+if ! command -v uv &>/dev/null; then
+    echo "error: uv is required to manage Python dependencies" >&2
+    echo "       install it from https://docs.astral.sh/uv/" >&2
+    exit 1
+fi
+
+uv sync --extra dev --quiet

.envrc

@@ -1,37 +1,19 @@
-# Use the Nix flake in this directory
+# Nix flake + direnv integration
 use flake
 
-# Watch for changes in these files to trigger environment reload
+# Watch for changes to trigger environment reload
 watch_file pyproject.toml
 watch_file flake.nix
+watch_file flake.lock
 watch_file uv.lock
 
-echo ""
-echo "ETH Library Zurich - Data Archive Pipeline (DAP) - Orchestrator"
-echo "───────────────────────────────────────────────────────────────"
+# Environment variables
+export DAGSTER_HOME="$PWD/.dagster"
+export VIRTUAL_ENV="$PWD/.venv"
 
-export DAGSTER_HOME="$PWD"
+# Setup Python dependencies
+.dev/scripts/uv-sync.sh || log_error "Python setup failed"
+PATH_add "$PWD/.venv/bin"
 
-# Auto-create venv and sync dependencies
-if [ ! -d .venv ]; then
-    echo "○ creating venv..."
-    uv venv --quiet
-fi
-
-source .venv/bin/activate
-uv sync --extra dev --frozen --quiet
-
-echo ""
-echo "  Environment"
-echo "  ─────────────────────────────────────────────────────────────"
-echo "  nix flake       $(nix flake metadata --json 2>/dev/null | jq -r '.resolved.url' | sed 's|^file://||')"
-echo "  python venv     $VIRTUAL_ENV"
-echo "  python version  $(python --version 2>&1 | cut -d' ' -f2)"
-echo "  DAGSTER_HOME    $DAGSTER_HOME"
-echo ""
-echo "  Commands"
-echo "  ─────────────────────────────────────────────────────────────"
-echo "  just            show available commands"
-echo "  just info       show tool versions"
-echo "  just dev        start Dagster dev server"
-echo ""
+# Show welcome message
+dap welcome

.github/workflows/ci.yml

@@ -5,7 +5,9 @@ name: CI
 on:
   push:
     branches: [ main ]
+    paths-ignore: ['cli/**']
   pull_request:
+    paths-ignore: ['cli/**']
 
 permissions:
   contents: read

.github/workflows/cli.yml

@@ -0,0 +1,28 @@
+name: CLI
+
+on:
+  push:
+    branches: [main]
+    paths: ['cli/**']
+  pull_request:
+    paths: ['cli/**']
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: cachix/install-nix-action@v31
+      - name: Run tests
+        run: nix develop .#cli-dev --command dap cli test
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: cachix/install-nix-action@v31
+      - name: Lint and check formatting
+        run: nix develop .#cli-dev --command dap cli lint

.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release CLI
+
+on:
+  push:
+    tags: ['cli/v*']
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: cachix/install-nix-action@v31
+      - name: Run tests
+        run: nix develop .#cli-dev --command dap cli test
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: cli/go.mod
+      - uses: goreleaser/goreleaser-action@v6
+        with:
+          version: '~> v2'
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,6 +1,13 @@
 # Python virtual environment
 .venv/
 
+# Go vendor (using gomod2nix instead)
+cli/vendor/
+vendor/
+
+# Go build output
+cli/bin/
+
 # Devbox environment
 .devbox/
 

.goreleaser.yaml

@@ -0,0 +1,19 @@
+version: 2
+project_name: dap
+builds:
+  - dir: cli
+    binary: dap
+    env: [CGO_ENABLED=0]
+    goos: [linux, darwin]
+    goarch: [amd64, arm64]
+    ldflags:
+      - -s -w
+      - -X github.com/eth-library/dap/cli/cmd.version={{ .Version }}
+      - -X github.com/eth-library/dap/cli/cmd.commit={{ .Commit }}
+      - -X github.com/eth-library/dap/cli/cmd.date={{ .Date }}
+archives:
+  - name_template: "dap_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+checksum:
+  name_template: checksums.txt
+release:
+  name_template: "CLI {{ .Tag }}"

.pre-commit-config.yaml

@@ -0,0 +1,26 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  # Go CLI hooks
+  - repo: local
+    hooks:
+      - id: cli-gomod2nix
+        name: "cli: Update gomod2nix.toml"
+        entry: bash -c 'cd cli && gomod2nix && git add gomod2nix.toml'
+        language: system
+        files: ^cli/go\.(mod|sum)$
+        pass_filenames: false