The code and data behind xeiaso.net
docs(agents): update repository guidelines
- Add missing directories to project structure (dhall, docker, fly, manifest, pb, scripts, var, .devcontainer, .github)
- Document all binaries in cmd/ (7 applications)
- Correct npm scripts table to reflect actual commands
- Remove incorrect format script reference
Add reviewbot GitHub workflow for PR review automation.
Assisted-by: GLM 4.7 via Claude Code
+46
-4
+30
.github/workflows/reviewbot.yml
+30
.github/workflows/reviewbot.yml
···
1
+
name: Reviewbot
2
+
3
+
on:
4
+
pull_request_review_comment:
5
+
types: [created]
6
+
issue_comment:
7
+
types: [created]
8
+
9
+
jobs:
10
+
manual_invocation:
11
+
if: |
12
+
startsWith(github.event.comment.body, '/reviewbot')
13
+
14
+
runs-on: ubuntu-latest
15
+
permissions:
16
+
id-token: write
17
+
contents: read
18
+
pull-requests: write
19
+
issues: write
20
+
steps:
21
+
- name: Run reviewbot
22
+
uses: docker://ghcr.io/xe/x/reviewbot:latest
23
+
env:
24
+
GITHUB_REPO: ${{ github.repository }}
25
+
GITHUB_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
26
+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
27
+
OPENAI_API_BASE: https://zohar.automuse.art/v1
28
+
OPENAI_API_KEY: ${{ secrets.ZOHAR_API_KEY }}
29
+
OPENAI_MODEL: gpt-oss-120b
30
+
PR_NUMBER: ${{ github.event.issue.number || github.event.pull_request.number }}
+16
-4
AGENTS.md
+16
-4
AGENTS.md
···
4
4
5
5
```text
6
6
├─ cmd/ # Main applications (each sub‑directory is a binary)
7
+
├─ dhall/ # Configuration files using Dhall language
7
8
├─ docs/ # Documentation assets
9
+
├─ docker/ # Docker-related files
10
+
├─ fly/ # Fly.io deployment configuration
8
11
├─ internal/ # Private packages used by the repo
9
12
├─ lume/ # Static site generator configuration
10
13
├─ lume/src # Static site pages
14
+
├─ manifest/ # Kubernetes manifests
15
+
├─ pb/ # Protocol buffer files
16
+
├─ scripts/ # Node.js and shell scripts for automation
17
+
├─ var/ # Variable data/runtime files
18
+
├─ .devcontainer/ # VS Code dev container configuration
19
+
├─ .github/ # GitHub workflows and configuration
11
20
├─ test files # Go test files live alongside source (`*_test.go`)
12
21
├─ go.mod # Go module definition
13
22
└─ package.json # npm scripts and JS tooling
14
23
```
15
24
25
+
**Binaries in cmd/**: `fabricate-generation`, `github-sponsor-webhook`, `hydrate`, `no-way-to-prevent-this`, `patreon-saasproxy`, `xesite` (main site binary), `xesitectl`.
26
+
16
27
Source code is primarily Go; JavaScript tooling lives under `node_modules` and the root `package.json`.
17
28
18
29
## Development Workflow
···
21
32
22
33
| Command | Description |
23
34
| ---------------------------- | --------------------------------------------------- |
24
-
| `npm run generate` | Regenerates protobuf, Go code, and runs formatters. |
25
-
| `npm test` or `npm run test` | Runs `generate` then executes `go test ./...`. |
35
+
| `npm test` | Executes `go test ./...`. |
36
+
| `npm run dev` | Runs the site in development mode. |
37
+
| `npm run deploy` | Deploys to Kubernetes via kubectl. |
38
+
| `npm run extract-meta` | Extracts metadata from content files. |
39
+
| `npm run validate-content-dates` | Validates blog post dates. |
26
40
| `go build ./...` | Compiles all Go packages. |
27
41
| `go run ./cmd/<app>` | Runs a specific binary from `cmd/`. |
28
-
| `npm run format` | Formats Go (`goimports`) and JS/HTML (`prettier`). |
29
42
30
43
### Code Formatting & Style
31
44
32
45
- **Go** – use `go fmt`/`goimports`; tabs for indentation, `camelCase` for variables, `PascalCase` for exported identifiers.
33
46
- **JavaScript/HTML/CSS** – formatted with Prettier (2‑space tabs, trailing commas, double quotes).
34
47
- Files are snake_case; packages use lower‑case module names.
35
-
- Run `npm run format` before committing.
36
48
37
49
### Testing
38
50