---

name: Go CI

on:

push:

branches: [main]

pull_request:

branches: [main]

jobs:

build:

name: Build & Test

runs-on: ubuntu-latest

steps:

- name: Check out code

uses: actions/checkout@v4

- name: Set up Go

uses: actions/setup-go@v5

with:

go-version: '1.21' # Or your desired Go version

- name: Setup tools

run: make setup

- name: Tidy modules

run: make tidy

- name: Check formatting

run: |

- name: Lint code

run: make lint

- name: Run tests

run: make test

- name: Build application

run: make build

---

# MegaLinter GitHub Action configuration file

# More info at https://megalinter.io

name: MegaLinter

on:

push:

branches: [main]

pull_request:

branches: [main]

permissions: read-all

env: # Comment env block if you don't want to apply fixes

# Apply linter fixes configuration

APPLY_FIXES: all # When active, APPLY_FIXES must also be defined as environment variable (in github/workflows/mega-linter.yml or other CI tool)

APPLY_FIXES_EVENT: none # Decide which event triggers application of fixes in a commit or a PR (pull_request, push, all)

APPLY_FIXES_MODE: commit # If APPLY_FIXES is used, defines if the fixes are directly committed (commit) or posted in a PR (pull_request)

concurrency:

group: ${{ github.ref }}-${{ github.workflow }}

cancel-in-progress: true

jobs:

megalinter:

name: MegaLinter

runs-on: ubuntu-latest

permissions:

contents: read

issues: write

pull-requests: write

steps:

# Git Checkout

- name: Checkout Code

uses: actions/checkout@v4

with:

token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}

fetch-depth: 0 # If you use VALIDATE_ALL_CODEBASE = true, you can remove this line to improve performances

# MegaLinter

- name: MegaLinter

id: ml

# deployed v8.3.0, https://github.com/oxsecurity/megalinter/releases/tag/v8.3.0

uses: oxsecurity/megalinter@1fc052d03c7a43c78fe0fee19c9d648b749e0c01

env:

# All available variables are described in documentation

# https://megalinter.io/configuration/

VALIDATE_ALL_CODEBASE: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }} # Validates all source when push on main, else just the git diff with main. Override with true if you always want to lint all sources

GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

# Upload MegaLinter artifacts

- name: Archive production artifacts

if: success() || failure()

uses: actions/upload-artifact@v4

with:

name: MegaLinter reports

path: |

---

name: Tag and Release

on:

push:

branches:

- main

jobs:

release:

runs-on: ubuntu-latest

steps:

- name: Checkout code

uses: actions/checkout@v4

- name: Use Node.js

uses: actions/setup-node@v4

with:

node-version: 18

- name: Install dependencies

run: npm ci

- name: Run semantic-release

env:

GITHUB_TOKEN: ${{ secrets.SEMANTIC_RELEASE }}

run: npx semantic-release --branches main

---

DISABLE_LINTERS:

- SPELL_CSPELL

- SPELL_LYCHEE

DISABLE_ERRORS_LINTERS:

- COPYPASTE_JSCPD

- REPOSITORY_DEVSKIM

- REPOSITORY_KICS

EMAIL_REPORTER: false

FILEIO_REPORTER: false

MARKDOWN_SUMMARY_REPORTER: true

SHOW_ELAPSED_TIME: true

.PHONY: help build run test fmt lint generate tidy setup

@echo " setup Install required tools (templ, golangci-lint)."

@echo " lint Run golangci-lint (requires installation)."

setup:

@echo "Running setup script..."

@./scripts/setup.sh

@golangci-lint run

This project uses Go modules and follows a standard Go project layout:

* `/cmd`: Main application entry points.

* `/internal`: Private application code (not intended for import by other projects).

* `/app`: Core application setup and Fx module wiring.

* `/config`: Configuration loading and management.

* `/log`: Logging setup and utilities.

* `/mcp`: MCP abstraction and utilities.

* `/services`: Core business logic implementations.

* `/sync`: Sync daemon. (PLACEHOLDER)

* `/updater`: Software update logic. (PLACEHOLDER)

* `/web`: Web server related code.

* `/handlers`: HTTP request handlers.

* `/templates`: HTML templates (using `templ`).

* `/pkg`: Library code intended for external use (currently N/A).

* `/scripts`: Scripts in Bash, Python, etc., for complex actions in this repository.

* `/out`: Compiled binaries (ignored by git).

1. **Go:** Ensure you have Go installed (version 1.21 or later recommended). You can download it from [https://go.dev/dl/](https://go.dev/dl/).

2. **Bash:** The setup script uses `bash` specific features.

3. **Environment Setup:** The setup script (`make setup`) will check if your `$GOPATH/bin` directory is in your `PATH` and provide instructions if it isn't. This directory is needed to run Go tools installed via `go install`.

You can manually verify by running `go env GOPATH` and checking your shell's configuration (e.g., `.zshrc`, `.bashrc`). Example:

```bash

export GOPATH="$(go env GOPATH)" # Or explicitly set, e.g., export GOPATH="$HOME/go"

export PATH="$PATH:$GOPATH/bin"

```

1. **Clone the repository:**

```bash

2. **Install Tools & Dependencies:** Run the setup command. This executes `scripts/setup.sh` which installs required Go tools (`templ`, `golangci-lint`) and checks your `PATH`.

```bash

3. **Download Go Modules:**

```bash

1. **Build and Run:**

```bash

This will compile the application into the `out/` directory and start the server (defaulting to `localhost:8080`).

2. **Access the UI (Placeholder):** Open your browser to `https://localhost:8080/ui`.

* `make setup`: Runs `scripts/setup.sh` to install/update necessary development tools (`templ`, `golangci-lint`) and check `PATH`.

* `make build`: Compile the application binary into `out/agent-browser`.

* `make run`: Build and run the application.

* `make generate`: Generate Go code from `.templ` files.

* `make test`: Run Go tests.

* `make fmt`: Format Go code (`gofmt`) and `.templ` files (`templ fmt`).

* `make tidy`: Tidy `go.mod` and `go.sum` files.

* `make lint`: Run the Go linter (`golangci-lint`).

* `make help`: Show all available targets.

This project uses GitHub Actions for Continuous Integration (CI) and release automation. The workflows are defined in the `.github/workflows/` directory.

* **Go CI (`go.yaml`):** This workflow runs on pushes and pull requests to the `main` and `develop` branches. It checks out the code, sets up Go, runs `make setup`, `make tidy`, formatting checks (`make fmt`), linting (`make lint`), tests (`make test`) and builds the project (`make build`) to ensure Go code quality and stability.

* **MegaLinter (`mega-linter.yaml`):** This workflow runs on pushes and pull requests to the `main` branch. It utilizes [MegaLinter](https://megalinter.io/) to analyze the entire codebase using a wide range of linters for various languages and formats (including Go, YAML, Markdown, Shell scripts, etc.). This helps maintain consistent coding standards and identify potential issues across the whole project. Reports are uploaded as artifacts.

* **Release (`release.yaml`):** This workflow runs only on pushes to the `main` branch. It uses [semantic-release](https://github.com/semantic-release/semantic-release) to automate version management and package publishing. Based on conventional commit messages, it determines the next version number, generates release notes, and creates a Git tag and GitHub release.

package app_test

import (

"testing"

)

func TestAppDummy(t *testing.T) {

// Keep t parameter used

_ = t

// This test doesn't do anything yet, but confirms tests can be discovered and run.

// t.Log("Dummy application test executed successfully.")

}

package services

}

set -e

SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" &>/dev/null && pwd)

cd "$SCRIPT_DIR"

log() {

echo "$(date '+%Y-%m-%d %H:%M:%S') - $1"

}

echo_success() {

printf "\033[0;32m✓ %s\033[0m\n" "$1"

}

echo_warn() {

printf "\033[0;33mWARN: %s\033[0m\n" "$1"

}

log "Starting setup..."

log "Installing templ..."

go install github.com/a-h/templ/cmd/templ@latest

log "Installing golangci-lint..."

go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

log "Checking PATH environment variable..."

GOPATH_BIN=$(go env GOPATH)/bin

if [ -z "$GOPATH_BIN" ] || [ "$GOPATH_BIN" = "/bin" ]; then

echo_warn "Could not determine GOPATH/bin. Please ensure GOPATH is set correctly."

# Use awk to check if GOPATH_BIN is a distinct component in PATH

if echo "$PATH" | awk -v path_to_check="$GOPATH_BIN" 'BEGIN { FS=":"; found=0 } { for(i=1; i<=NF; i++) if ($i == path_to_check) { found=1; exit 0 } } END { exit !found }'; then

echo_success "$GOPATH_BIN appears to be in your PATH."

else

echo_warn "$GOPATH_BIN does not appear to be in your PATH."

echo " Please add it to your shell configuration (e.g., .zshrc, .bashrc):"

echo " export PATH=\"$PATH:$GOPATH_BIN\""

fi

printf "\033[0;32m✓ %s\033[0m\n" "Setup complete."