Proxy: restructure repo as Go project with proxy as first module (#4652)

Reorganize the SRS (Simple Realtime Server) repository to
follow a conventional Go project structure, setting the stage for a
progressive transition from a C++ project to a Go project. The proxy,
which was once contained within its own `proxy/` subdirectory, will now
be converted into the initial Go module located at the root of the
repository, serving as a template for subsequent Go modules.

- **Go module at repo root:** `go.mod` moved to repo root, module
renamed from `proxy` to `srsx`. The repo is now a proper Go project with
`cmd/` and `internal/` at the top level.
- **Elevation of Proxy Code:** Move the proxy code from
`proxy/cmd/proxy-go/` to `cmd/proxy/`, and from `proxy/internal/` to
`internal/`. The proxy serves as the inaugural application; subsequent
modules (for instance, `cmd/origin`) will mimic this arrangement.
- **Documentation Restructured:** Transfer the documentation from
`proxy/docs/` to `docs/proxy/`, revise the main README to endorse
OpenClaw as the preferred AI tool, and update `proxy/README.md` to point
to the new documentation locations.
- **Build and config:** `Makefile` moved to root, `PROXY_STATIC_FILES`
default path corrected for the new layout, `.gitignore` consolidated.
- **Cleanup:** removed standalone `proxy/LICENSE` (repo-level license
applies), all internal imports updated to `srsx/internal/...`.
- **OpenClaw workspace:** added community bot info, git workflow
conventions, and support group behavior guidance.

This restructuring was performed by OpenClaw orchestrating Claude Code
and Codex via ACP.

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>
Signed-off-by: winlin <winlinvip@gmail.com>

Author: 3 people

.gitignore

@@ -39,3 +39,8 @@ cmake-build-debug
 /build
 /cmake/build
 /trunk/cmake/build
+
+# proxy (Go)
+srs-proxy
+.go-formarted
+.env

.kiro/skills

@@ -0,0 +1 @@
+../openclaw/skills

.vscode/launch.json

@@ -62,8 +62,8 @@
           "type": "go",
           "request": "launch",
           "mode": "auto",
-          "cwd": "${workspaceFolder}/proxy",
-          "program": "${workspaceFolder}/proxy"        
+          "cwd": "${workspaceFolder}/cmd/proxy",
+          "program": "${workspaceFolder}/cmd/proxy"        
         },
         {
           "name": "Debug SRS (macOS, CodeLLDB) console.conf",

proxy/Makefile Makefileproxy/Makefile renamed to Makefile

@@ -4,20 +4,20 @@ all: build
 
 build: fmt ./srs-proxy
 
-./srs-proxy: cmd/proxy-go/*.go internal/**/*.go
-	go build -o srs-proxy ./cmd/proxy-go
+./srs-proxy: cmd/proxy/*.go internal/**/*.go
+	go build -o srs-proxy ./cmd/proxy
 
 test:
 	go test ./...
 
 fmt: ./.go-formarted
 
-./.go-formarted: cmd/proxy-go/*.go internal/**/*.go
+./.go-formarted: cmd/proxy/*.go internal/**/*.go
 	touch .go-formarted
-	go fmt ./...
+	go fmt ./cmd/... ./internal/...
 
 clean:
 	rm -f srs-proxy .go-formarted
 
 run: fmt
-	go run ./cmd/proxy-go
+	go run ./cmd/proxy

proxy/cmd/proxy-go/main.go cmd/proxy/main.goproxy/cmd/proxy-go/main.go renamed to cmd/proxy/main.go

@@ -7,7 +7,7 @@ import (
 	"context"
 	"os"
 
-	"proxy/internal/bootstrap"
+	"srsx/internal/bootstrap"
 )
 
 func main() {

docs/proxy/README.md

@@ -0,0 +1,23 @@
+# Proxy
+
+Proxy is a common proxy server (`cmd/proxy`) for any media servers with RTMP/SRT/HLS/HTTP-FLV and WebRTC/WHIP/WHEP protocols support. More programs like `cmd/origin` will be added in the future.
+
+## Usage
+
+This project is managed by AI. We recommend OpenClaw by default, but you can use any AI agent that supports skills, such as Claude Code, OpenAI Codex, Kiro CLI, or similar tools that can read code and docs as context. Setup your AI code tool and ask questions like:
+
+- How to use this project?
+- How to run the proxy server?
+- How to build an Origin Cluster for production?
+
+You can not only use AI to show you the usage of this project, but also use AI to guide you to learn the details of this project, to understand the design and protocols, to learn each documents in docs directory.
+
+## AI Guidelines
+
+- AI assistants should ignore [ignore-worklog.md](ignore-worklog.md) as it's a personal work log that may contain misleading information, hallucinations, or falsehoods. Never rely on this file as a reference.
+- For usage of proxy server and end to end test it, you should load [proxy-usage.md](proxy-usage.md). This is the first step for new users to learn how to use this project. It provides a general and overall view of the proxy server, including practical usage examples and end-to-end testing procedures.
+- For proxy full usage to build an Origin Cluster for SRS media server, please load [proxy-origin-cluster.md](proxy-origin-cluster.md). This is an advanced topic about how to use the proxy server to build the SRS Origin Cluster. Users should read this document to learn more details and architectures about proxy and Origin Cluster.
+- For proxy server: To understand proxy system design, you should load the [proxy-design.md](proxy-design.md). To understand the proxy protocol details, you should load the [proxy-protocol.md](proxy-protocol.md). To understand how load balance works, you should load [proxy-load-balancer.md](proxy-load-balancer.md). To understand the code structure and packages, you should load [proxy-files.md](proxy-files.md).
+
+William Yang<br/>
+June 23, 2025

docs/proxy/ignore-worklog.md

@@ -0,0 +1,7 @@
+# Work Log
+
+> Important notes for AI assistants: This file might includes misleading information, hallucinations, or even falsehoods, since it's just a personal work log. So AI should never rely on this file as a reference.
+
+SRSX is not only the next generation of SRS (Simple Realtime Server), and it's also an approach to leverage AI to manage the project as a whole. So it's not just a useful open source project, but also a demostration of how AI can help develop, manage, and maintain a complex project.
+
+Since AI is relatively a new tool for open source project development, I use this work log to record my thoughts, ideas, experiments, and even failures along the way, while integrating AI into this open source project.

proxy/docs/proxy-design.md docs/proxy/proxy-design.mdproxy/docs/proxy-design.md renamed to docs/proxy/proxy-design.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-**proxy-go** is a stateless media streaming proxy with built-in load balancing that enables building scalable origin clusters. The proxy itself acts as the load balancer, routing streams from clients to backend origin servers.
+**proxy** is a stateless media streaming proxy with built-in load balancing that enables building scalable origin clusters. The proxy itself acts as the load balancer, routing streams from clients to backend origin servers.
 
 ```
 Client → Proxy (with Load Balancer) → Backend Origin Servers

proxy/docs/proxy-files.md docs/proxy/proxy-files.mdproxy/docs/proxy-files.md renamed to docs/proxy/proxy-files.md

@@ -6,7 +6,7 @@ This document provides an overview of the Go codebase organization.
 
 ```
 /
-├── cmd/proxy-go/
+├── cmd/proxy/
 │   └── main.go                 # Application entry point
 └── internal/
     ├── debug/                  # Go profiling support

proxy/docs/proxy-load-balancer.md docs/proxy/proxy-load-balancer.mdproxy/docs/proxy-load-balancer.md renamed to docs/proxy/proxy-load-balancer.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-The proxy-go load balancer distributes client streams across multiple backend origin servers. It provides a pluggable interface with two implementations:
+The proxy load balancer distributes client streams across multiple backend origin servers. It provides a pluggable interface with two implementations:
 
 1. **Memory Load Balancer** - For single proxy deployments
 2. **Redis Load Balancer** - For multi-proxy deployments with shared state
@@ -159,4 +159,3 @@ PROXY_REDIS_DB=0
 | **Complexity** | Simple | Moderate |
 | **Fault Tolerance** | Single point of failure | Multiple proxies |
 | **Best For** | Moderate traffic | High traffic, high availability |
-