feat: bootstrap Go module, storage interface, and markdown adapter

Pitch 01-01: initialize the brain Go module with storage interface,
conformance test suite, markdown adapter, build scaffolding, and CI.

Author: luuuc

.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-go@v6
+        with:
+          go-version-file: go.mod
+
+      - name: Build
+        run: go build -v ./...
+
+      - name: Test
+        run: go test -v ./...
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-go@v6
+        with:
+          go-version-file: go.mod
+
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v9
+        with:
+          version: latest

.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-go@v6
+        with:
+          go-version-file: go.mod
+
+      - uses: goreleaser/goreleaser-action@v7
+        with:
+          version: '~> v2'
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -37,6 +37,7 @@ Thumbs.db
 # Build artifacts
 /brain
 /bin/
+/dist/
 /cmd/brain/brain
 *.exe
 *.test

.golangci.yml

@@ -0,0 +1,6 @@
+version: "2"
+
+linters:
+  enable:
+    - errcheck
+    - staticcheck

.goreleaser.yml

@@ -0,0 +1,46 @@
+version: 2
+
+builds:
+  - id: brain
+    main: ./cmd/brain
+    binary: brain
+    flags:
+      - -trimpath
+    env:
+      - CGO_ENABLED=0
+    ldflags:
+      - -s -w
+      - -X github.com/luuuc/brain/internal/version.Version={{.Version}}
+    goos:
+      - darwin
+      - linux
+    goarch:
+      - amd64
+      - arm64
+
+archives:
+  - id: brain
+    ids: [brain]
+    formats: [tar.gz]
+    name_template: "brain_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+
+checksum:
+  name_template: "brain_{{ .Version }}_checksums.txt"
+
+changelog:
+  use: github
+  sort: asc
+  filters:
+    exclude:
+      - "^docs:"
+      - "^chore:"
+      - "^ci:"
+      - "^test:"
+      - "^refactor:"
+
+release:
+  github:
+    owner: luuuc
+    name: brain
+  prerelease: auto
+  make_latest: true

Makefile

@@ -0,0 +1,28 @@
+.PHONY: build test clean install lint ci run
+
+VERSION ?= dev
+COMMIT := $(shell git rev-parse --short HEAD 2>/dev/null || echo "none")
+LDFLAGS := -ldflags="-s -w -X 'github.com/luuuc/brain/internal/version.Version=$(VERSION)'"
+
+build:
+	go build $(LDFLAGS) -trimpath -o bin/brain ./cmd/brain
+
+test:
+	go test -v ./...
+
+clean:
+	rm -rf bin/ dist/
+
+install: build
+	cp bin/brain /usr/local/bin/brain
+
+lint:
+	@command -v golangci-lint >/dev/null 2>&1 || \
+		(echo "Installing golangci-lint..." && go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@latest)
+	@PATH="$$PATH:$$(go env GOPATH)/bin" golangci-lint run
+
+ci: build test lint
+	@echo "All CI checks passed!"
+
+run:
+	go run ./cmd/brain $(ARGS)

cmd/brain/main.go

@@ -0,0 +1,11 @@
+package main
+
+import (
+	"fmt"
+
+	"github.com/luuuc/brain/internal/version"
+)
+
+func main() {
+	fmt.Printf("brain %s\n", version.Version)
+}

go.mod

@@ -0,0 +1,5 @@
+module github.com/luuuc/brain
+
+go 1.25.5
+
+require gopkg.in/yaml.v3 v3.0.1 // indirect

go.sum

@@ -0,0 +1,3 @@
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=