{"record":{"id":"613ad16972189dc0","repo":"gastownhall/beads","slug":"team-server-requires-proxied-server","errorCode":null,"errorMessage":"--team-server requires --proxied-server","messagePattern":"--team-server requires --proxied-server","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/bd/init.go","lineNumber":445,"sourceCode":"\n\t\tinitEvt := metrics.NewCommandEvent(\"init-\" + resolveInitDoltMode(initProxiedServer, sharedServer, initServerMode))\n\t\tdefer func() {\n\t\t\tif c := metrics.Global(); c != nil {\n\t\t\t\tc.CloseEventAndAdd(initEvt)\n\t\t\t}\n\t\t}()\n\n\t\tif initProxiedServer && initServerMode {\n\t\t\treturn fmt.Errorf(\"--server and --proxied-server are mutually exclusive\")\n\t\t}\n\t\tif initProxiedServer {\n\t\t\tif sharedServer || externalServer ||\n\t\t\t\tserverHost != \"\" || serverPort != 0 || serverSocket != \"\" || serverUser != \"\" || cmd.Flags().Changed(\"server-tls\") {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server cannot be combined with --shared-server, --external, or any --server-* flag\")\n\t\t\t}\n\t\t}\n\t\tif initTeamServer && !initProxiedServer {\n\t\t\treturn fmt.Errorf(\"--team-server requires --proxied-server\")\n\t\t}\n\t\tif serverConfigPath != \"\" {\n\t\t\tif !initProxiedServer {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-config-path requires --proxied-server\")\n\t\t\t}\n\t\t\tif !filepath.IsAbs(serverConfigPath) {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-config-path must be an absolute path, got %q\", serverConfigPath)\n\t\t\t}\n\t\t\tif err := validateProxiedServerConfig(serverConfigPath); err != nil {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-config-path %v\", err)\n\t\t\t}\n\t\t}\n\t\tif serverLogPath != \"\" {\n\t\t\tif !initProxiedServer {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-log-path requires --proxied-server\")\n\t\t\t}\n\t\t\tif !filepath.IsAbs(serverLogPath) {\n\t\t\t\treturn fmt.Errorf(\"--proxied-server-log-path must be an absolute path, got %q\", serverLogPath)","sourceCodeStart":427,"sourceCodeEnd":463,"githubUrl":"https://github.com/gastownhall/beads/blob/71377f276968b452ee607177637970a4ff888584/cmd/bd/init.go#L427-L463","documentation":"--team-server is only meaningful in proxied-server mode; enabling it without --proxied-server is rejected at init flag validation.","triggerScenarios":"Running `bd init --team-server` (initTeamServer true) while --proxied-server is absent (initProxiedServer false).","commonSituations":"Adding --team-server to a plain `bd init` to 'enable teams' without realizing it is a modifier of proxied-server mode, not a standalone mode.","solutions":["Add --proxied-server to the same command","Or drop --team-server if proxied-server mode is not wanted"],"exampleFix":"// before\nbd init --team-server\n// after\nbd init --proxied-server --team-server","handlingStrategy":"validation","validationCode":"# --team-server requires --proxied-server\nif [[ \"$FLAGS\" == *--team-server* && \"$FLAGS\" != *--proxied-server* ]]; then\n  echo 'add --proxied-server'; exit 1\nfi","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Treat --team-server as a modifier of proxied-server mode, never a standalone mode","Template team inits as a single canonical command containing both flags"],"tags":["cli","flag-conflict","init","team-server"],"backgroundTag":"missing-required-flag","analyzedSha":"71377f276968b452ee607177637970a4ff888584","analyzedAt":"2026-08-30T18:55:39.744Z","schemaVersion":2},"datasetVersion":"2026-08-30T23:17:21.991Z"}