mirror of
https://github.com/multica-ai/multica.git
synced 2026-06-17 03:38:32 +02:00
* feat(cli): add central error translation layer (PR1) Introduce server/internal/cli/errors.go, a single user-facing error translation layer that collapses raw transport errors, HTTP status errors, and internal verb-wrapped chains into clear, localized messages. - ErrorKind classification (network timeout/DNS/refused/TLS/offline, 401/403/404/409/400+422/429/5xx, unknown) - NetworkError wraps transport errors and strips the raw URL from the user-facing message; classifyNetworkError categorizes via errors.As/Is with string fallbacks - HTTPError.Kind() maps status codes onto ErrorKind - FormatError: bilingual output (English default, auto-switch to Chinese on a zh LC_ALL/LC_MESSAGES/LANG locale), validation errors surface the server message; --debug / MULTICA_DEBUG appends the full raw chain - ExitCodeFor: tiered exit codes (network=2, auth=3, 404=4, validation=5, other=1) - client.go: default HTTP timeout 15s -> 30s, overridable via MULTICA_HTTP_TIMEOUT; wrap every transport Do() error as *NetworkError - main.go: route errors through FormatError + ExitCodeFor, add persistent --debug flag Unit tests cover every ErrorKind, classification, language detection, exit codes, server-message extraction, and timeout parsing. Refs MUL-3104. PR1 of 3; PR2/PR3 (status-code copy refinement and per-command customization) follow separately. Co-authored-by: multica-agent <github@multica.ai> * fix(cli): address review — unify command timeouts and classify all helper errors Must-fix 1: command-level contexts no longer truncate MULTICA_HTTP_TIMEOUT. Added cli.APITimeout/AtLeastAPITimeout/APIContext (budget = transport timeout + small grace, honoring MULTICA_HTTP_TIMEOUT) and replaced the hardcoded 15s context.WithTimeout in every API command (14 files, 92 sites) with cli.APIContext. The issue-create/comment path now uses APITimeout() with a 60s floor for attachment uploads. Must-fix 2: all API helpers now return *HTTPError on status >= 400. Added a shared newHTTPError(method, path, resp) and routed GetJSON, GetJSONWithHeaders, PostJSON, PutJSON, PatchJSON, DeleteJSON, DeleteJSONWithBody, UploadFile, UploadFileWithURL, DownloadFile (and HealthCheck) through it, so issue update/status/metadata (PUT), comment list (GetJSONWithHeaders), project/label/ comment delete (DELETE) and agent/workspace/autopilot update (PUT/PATCH) all get HTTPError.Kind() classification, friendly copy, and the tiered exit code instead of the raw string + exit 1. Tests: new errors_integration_test.go drives the real helpers against a fake server and asserts FormatError copy + ExitCodeFor for 401/403/404/422/500 across all 10 helpers, plus a slow-server test proving the command context does not cancel before the transport timeout. Updated the UploadFileWithURL assertion to check for *HTTPError. Refs MUL-3104, PR #3892. Co-authored-by: multica-agent <github@multica.ai> * fix(cli): make remaining fixed-timeout API commands honor MULTICA_HTTP_TIMEOUT Closes out the timeout work: the last API command paths still used a hardcoded context deadline that capped MULTICA_HTTP_TIMEOUT. Converted them to cli.AtLeastAPITimeout(<original floor>) so the env override scales them up while preserving each original lower bound: - cmd_autopilot.go autopilot trigger 30s -> AtLeastAPITimeout(30s) - cmd_attachment.go attachment download 60s -> AtLeastAPITimeout(60s) - cmd_agent.go avatar upload 60s -> AtLeastAPITimeout(60s) - cmd_skill.go skill import / search 60s -> AtLeastAPITimeout(60s) - cmd_runtime.go runtime update 150s -> AtLeastAPITimeout(150s) - cmd_login.go workspace-creation poll 10s -> AtLeastAPITimeout(10s) The login poll keeps a short 10s floor to stay responsive within its 5-minute loop, but it is NOT a silent exception: AtLeastAPITimeout means it still scales with MULTICA_HTTP_TIMEOUT. Documented in code and covered by a new subtest in TestAPITimeoutRespectsEnv. Refs MUL-3104, PR #3892. Co-authored-by: multica-agent <github@multica.ai> * style(cli): gofmt cmd_attachment.go to unblock backend CI Co-authored-by: multica-agent <github@multica.ai> --------- Co-authored-by: multica-agent <github@multica.ai>
385 lines
12 KiB
Go
385 lines
12 KiB
Go
package cli
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"errors"
|
|
"io"
|
|
"net/http"
|
|
"net/http/httptest"
|
|
"strings"
|
|
"testing"
|
|
)
|
|
|
|
func TestPostJSON(t *testing.T) {
|
|
type reqBody struct {
|
|
Name string `json:"name"`
|
|
Age int `json:"age"`
|
|
}
|
|
type respBody struct {
|
|
ID string `json:"id"`
|
|
}
|
|
|
|
t.Run("success", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
if r.Method != http.MethodPost {
|
|
t.Errorf("expected POST, got %s", r.Method)
|
|
}
|
|
if ct := r.Header.Get("Content-Type"); ct != "application/json" {
|
|
t.Errorf("expected Content-Type application/json, got %s", ct)
|
|
}
|
|
if auth := r.Header.Get("Authorization"); auth != "Bearer test-token" {
|
|
t.Errorf("expected Authorization Bearer test-token, got %s", auth)
|
|
}
|
|
|
|
var body reqBody
|
|
if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
|
|
t.Fatalf("failed to decode request body: %v", err)
|
|
}
|
|
if body.Name != "alice" || body.Age != 30 {
|
|
t.Errorf("unexpected body: %+v", body)
|
|
}
|
|
|
|
w.Header().Set("Content-Type", "application/json")
|
|
json.NewEncoder(w).Encode(respBody{ID: "123"})
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "test-token")
|
|
var out respBody
|
|
err := client.PostJSON(context.Background(), "/test", reqBody{Name: "alice", Age: 30}, &out)
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
if out.ID != "123" {
|
|
t.Errorf("expected ID 123, got %s", out.ID)
|
|
}
|
|
})
|
|
|
|
t.Run("error status", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
w.WriteHeader(http.StatusBadRequest)
|
|
io.WriteString(w, "bad request")
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "test-token")
|
|
err := client.PostJSON(context.Background(), "/test", reqBody{Name: "bob"}, nil)
|
|
if err == nil {
|
|
t.Fatal("expected error, got nil")
|
|
}
|
|
if got := err.Error(); got != "POST /test returned 400: bad request" {
|
|
t.Errorf("unexpected error message: %s", got)
|
|
}
|
|
})
|
|
|
|
t.Run("nil output", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
w.WriteHeader(http.StatusCreated)
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "test-token")
|
|
err := client.PostJSON(context.Background(), "/test", reqBody{Name: "charlie"}, nil)
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
})
|
|
|
|
t.Run("workspace and agent context headers", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
if ws := r.Header.Get("X-Workspace-ID"); ws != "ws-abc" {
|
|
t.Errorf("expected X-Workspace-ID ws-abc, got %s", ws)
|
|
}
|
|
if agent := r.Header.Get("X-Agent-ID"); agent != "agent-123" {
|
|
t.Errorf("expected X-Agent-ID agent-123, got %s", agent)
|
|
}
|
|
if task := r.Header.Get("X-Task-ID"); task != "task-456" {
|
|
t.Errorf("expected X-Task-ID task-456, got %s", task)
|
|
}
|
|
w.Header().Set("Content-Type", "application/json")
|
|
json.NewEncoder(w).Encode(respBody{ID: "456"})
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "ws-abc", "test-token")
|
|
client.AgentID = "agent-123"
|
|
client.TaskID = "task-456"
|
|
var out respBody
|
|
err := client.PostJSON(context.Background(), "/test", reqBody{}, &out)
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
})
|
|
|
|
t.Run("client identity headers", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
if got := r.Header.Get("X-Client-Platform"); got != "cli-test" {
|
|
t.Errorf("expected X-Client-Platform cli-test, got %s", got)
|
|
}
|
|
if got := r.Header.Get("X-Client-Version"); got != "9.9.9" {
|
|
t.Errorf("expected X-Client-Version 9.9.9, got %s", got)
|
|
}
|
|
if got := r.Header.Get("X-Client-OS"); got != "linux" {
|
|
t.Errorf("expected X-Client-OS linux, got %s", got)
|
|
}
|
|
w.WriteHeader(http.StatusNoContent)
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "")
|
|
client.Platform = "cli-test"
|
|
client.Version = "9.9.9"
|
|
client.OS = "linux"
|
|
if err := client.PostJSON(context.Background(), "/test", reqBody{}, nil); err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
})
|
|
|
|
t.Run("client identity headers fall back to package defaults", func(t *testing.T) {
|
|
origPlatform, origVersion, origOS := ClientPlatform, ClientVersion, ClientOS
|
|
ClientPlatform = "cli"
|
|
ClientVersion = "1.2.3-test"
|
|
ClientOS = "macos"
|
|
t.Cleanup(func() {
|
|
ClientPlatform, ClientVersion, ClientOS = origPlatform, origVersion, origOS
|
|
})
|
|
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
if got := r.Header.Get("X-Client-Platform"); got != "cli" {
|
|
t.Errorf("expected X-Client-Platform cli, got %s", got)
|
|
}
|
|
if got := r.Header.Get("X-Client-Version"); got != "1.2.3-test" {
|
|
t.Errorf("expected X-Client-Version 1.2.3-test, got %s", got)
|
|
}
|
|
if got := r.Header.Get("X-Client-OS"); got != "macos" {
|
|
t.Errorf("expected X-Client-OS macos, got %s", got)
|
|
}
|
|
w.WriteHeader(http.StatusNoContent)
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "")
|
|
if err := client.PostJSON(context.Background(), "/test", reqBody{}, nil); err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
})
|
|
}
|
|
|
|
func TestDownloadFile(t *testing.T) {
|
|
t.Run("relative URL is resolved against BaseURL and sent with auth", func(t *testing.T) {
|
|
var gotPath, gotAuth string
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
gotPath = r.URL.Path
|
|
gotAuth = r.Header.Get("Authorization")
|
|
w.Write([]byte("hello"))
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "test-token")
|
|
data, err := client.DownloadFile(context.Background(), "/uploads/workspaces/abc/file.md")
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
if string(data) != "hello" {
|
|
t.Errorf("unexpected body: %q", string(data))
|
|
}
|
|
if gotPath != "/uploads/workspaces/abc/file.md" {
|
|
t.Errorf("unexpected path: %q", gotPath)
|
|
}
|
|
if gotAuth != "Bearer test-token" {
|
|
t.Errorf("expected Authorization Bearer test-token, got %q", gotAuth)
|
|
}
|
|
})
|
|
|
|
t.Run("absolute URL is used as-is without auth headers", func(t *testing.T) {
|
|
var gotAuth string
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
gotAuth = r.Header.Get("Authorization")
|
|
w.Write([]byte("signed-payload"))
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient("https://api.example.test", "", "test-token")
|
|
data, err := client.DownloadFile(context.Background(), srv.URL+"/signed?sig=abc")
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
if string(data) != "signed-payload" {
|
|
t.Errorf("unexpected body: %q", string(data))
|
|
}
|
|
if gotAuth != "" {
|
|
t.Errorf("expected no Authorization header on signed URL, got %q", gotAuth)
|
|
}
|
|
})
|
|
|
|
t.Run("relative URL with empty BaseURL returns a helpful error", func(t *testing.T) {
|
|
client := NewAPIClient("", "", "test-token")
|
|
_, err := client.DownloadFile(context.Background(), "/uploads/x.md")
|
|
if err == nil {
|
|
t.Fatal("expected error, got nil")
|
|
}
|
|
})
|
|
|
|
t.Run("non-2xx status returns an error with the response body", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
w.WriteHeader(http.StatusNotFound)
|
|
io.WriteString(w, "not found")
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "test-token")
|
|
_, err := client.DownloadFile(context.Background(), "/uploads/missing")
|
|
if err == nil {
|
|
t.Fatal("expected error, got nil")
|
|
}
|
|
})
|
|
}
|
|
|
|
func TestUploadFileWithURL(t *testing.T) {
|
|
t.Run("success", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
if r.Method != http.MethodPost {
|
|
t.Errorf("expected POST, got %s", r.Method)
|
|
}
|
|
if ct := r.Header.Get("Content-Type"); !strings.Contains(ct, "multipart/form-data") {
|
|
t.Errorf("expected multipart content-type, got %s", ct)
|
|
}
|
|
|
|
file, header, err := r.FormFile("file")
|
|
if err != nil {
|
|
t.Fatalf("missing file field: %v", err)
|
|
}
|
|
defer file.Close()
|
|
|
|
data, _ := io.ReadAll(file)
|
|
if string(data) != "hello" {
|
|
t.Errorf("unexpected file data: %q", string(data))
|
|
}
|
|
if header.Filename != "test.txt" {
|
|
t.Errorf("unexpected filename: %q", header.Filename)
|
|
}
|
|
|
|
// Verify no issue_id or comment_id fields are sent.
|
|
if r.FormValue("issue_id") != "" {
|
|
t.Errorf("unexpected issue_id field")
|
|
}
|
|
if r.FormValue("comment_id") != "" {
|
|
t.Errorf("unexpected comment_id field")
|
|
}
|
|
|
|
w.Header().Set("Content-Type", "application/json")
|
|
json.NewEncoder(w).Encode(AttachmentResponse{
|
|
ID: "att-123",
|
|
URL: "https://cdn.example.com/file.txt",
|
|
Filename: "test.txt",
|
|
SizeBytes: 5,
|
|
})
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "ws-1", "test-token")
|
|
id, url, err := client.UploadFileWithURL(context.Background(), []byte("hello"), "test.txt")
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
if id != "att-123" {
|
|
t.Errorf("expected id att-123, got %s", id)
|
|
}
|
|
if url != "https://cdn.example.com/file.txt" {
|
|
t.Errorf("expected url https://cdn.example.com/file.txt, got %s", url)
|
|
}
|
|
})
|
|
|
|
t.Run("error status", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
w.WriteHeader(http.StatusBadRequest)
|
|
io.WriteString(w, "bad request")
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "")
|
|
_, _, err := client.UploadFileWithURL(context.Background(), []byte("x"), "x.txt")
|
|
if err == nil {
|
|
t.Fatal("expected error, got nil")
|
|
}
|
|
var httpErr *HTTPError
|
|
if !errors.As(err, &httpErr) {
|
|
t.Fatalf("expected *HTTPError, got %T: %v", err, err)
|
|
}
|
|
if httpErr.StatusCode != 400 {
|
|
t.Errorf("expected status 400, got %d", httpErr.StatusCode)
|
|
}
|
|
})
|
|
|
|
t.Run("missing id in response succeeds (fallback path)", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
w.Header().Set("Content-Type", "application/json")
|
|
json.NewEncoder(w).Encode(map[string]string{"url": "https://example.com"})
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "")
|
|
id, url, err := client.UploadFileWithURL(context.Background(), []byte("x"), "x.txt")
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
if id != "" {
|
|
t.Errorf("expected empty id, got %s", id)
|
|
}
|
|
if url != "https://example.com" {
|
|
t.Errorf("expected url https://example.com, got %s", url)
|
|
}
|
|
})
|
|
|
|
t.Run("workspace header sent", func(t *testing.T) {
|
|
var gotWorkspace string
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
gotWorkspace = r.Header.Get("X-Workspace-ID")
|
|
w.Header().Set("Content-Type", "application/json")
|
|
json.NewEncoder(w).Encode(AttachmentResponse{ID: "att-1", URL: "https://example.com"})
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "ws-abc", "test-token")
|
|
_, _, err := client.UploadFileWithURL(context.Background(), []byte("x"), "x.txt")
|
|
if err != nil {
|
|
t.Fatalf("unexpected error: %v", err)
|
|
}
|
|
if gotWorkspace != "ws-abc" {
|
|
t.Errorf("expected X-Workspace-ID ws-abc, got %s", gotWorkspace)
|
|
}
|
|
})
|
|
|
|
t.Run("missing url in response", func(t *testing.T) {
|
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
w.Header().Set("Content-Type", "application/json")
|
|
json.NewEncoder(w).Encode(AttachmentResponse{ID: "att-123"})
|
|
}))
|
|
defer srv.Close()
|
|
|
|
client := NewAPIClient(srv.URL, "", "")
|
|
_, _, err := client.UploadFileWithURL(context.Background(), []byte("x"), "x.txt")
|
|
if err == nil {
|
|
t.Fatal("expected error, got nil")
|
|
}
|
|
if !strings.Contains(err.Error(), "missing attachment url") {
|
|
t.Errorf("unexpected error message: %s", err.Error())
|
|
}
|
|
})
|
|
}
|
|
|
|
func TestNormalizeGOOS(t *testing.T) {
|
|
cases := map[string]string{
|
|
"darwin": "macos",
|
|
"windows": "windows",
|
|
"linux": "linux",
|
|
"freebsd": "freebsd",
|
|
}
|
|
for in, want := range cases {
|
|
if got := normalizeGOOS(in); got != want {
|
|
t.Errorf("normalizeGOOS(%q) = %q, want %q", in, got, want)
|
|
}
|
|
}
|
|
}
|