fix: linter and docs

backend/internal/handlers/scripts.go

@@ -22,9 +22,9 @@ func NewScriptHandlers(svc *service.ScriptService, cmder *commander.Commander) S
 }
 
 type RunScriptIn struct {
-	AgentID       string  `json:"agent_id" binding:"required"`
+	AgentID       string  `json:"agent_id"       binding:"required"`
 	InterpreterID int64   `json:"interpreter_id" binding:"required"`
-	ScriptText    string  `json:"script_text" binding:"required"`
+	ScriptText    string  `json:"script_text"    binding:"required"`
 	Stdin         *string `json:"stdin"`
 }
 
@@ -45,6 +45,7 @@ type RunScriptOut struct {
 // @Produce json
 // @Param body body RunScriptIn true "Script request"
 // @Success 201 {object} RunScriptOut
+// @Security Bearer
 // @Router /scripts/run [post]
 func (self *ScriptHandlers) RunScript(c *gin.Context) {
 	err := func() error {
@@ -53,7 +54,11 @@ func (self *ScriptHandlers) RunScript(c *gin.Context) {
 			return err
 		}
 
-		command, err := self.svc.ResolveCommand(c.Request.Context(), in.InterpreterID, in.ScriptText)
+		command, err := self.svc.ResolveCommand(
+			c.Request.Context(),
+			in.InterpreterID,
+			in.ScriptText,
+		)
 		if err != nil {
 			return err
 		}
@@ -98,6 +103,7 @@ func (self *ScriptHandlers) RunScript(c *gin.Context) {
 // @Tags scripts
 // @Produce json
 // @Success 200 {array} repository.ScriptInterpreter
+// @Security Bearer
 // @Router /scripts/interpreters [get]
 func (self *ScriptHandlers) ListInterpreters(c *gin.Context) {
 	interpreters, err := self.svc.List(c.Request.Context())
@@ -116,6 +122,7 @@ func (self *ScriptHandlers) ListInterpreters(c *gin.Context) {
 // @Produce json
 // @Param body body repository.ScriptInterpreterCreate true "Interpreter definition"
 // @Success 201 {object} repository.ScriptInterpreter
+// @Security Bearer
 // @Router /scripts/interpreters [post]
 func (self *ScriptHandlers) CreateInterpreter(c *gin.Context) {
 	var in repository.ScriptInterpreterCreate
@@ -139,6 +146,7 @@ func (self *ScriptHandlers) CreateInterpreter(c *gin.Context) {
 // @Produce json
 // @Param id path int true "Interpreter ID"
 // @Success 200 {object} repository.ScriptInterpreter
+// @Security Bearer
 // @Router /scripts/interpreters/:id [get]
 func (self *ScriptHandlers) GetInterpreter(c *gin.Context) {
 	id, err := strconv.ParseInt(c.Param("id"), 10, 64)
@@ -164,6 +172,7 @@ func (self *ScriptHandlers) GetInterpreter(c *gin.Context) {
 // @Param id path int true "Interpreter ID"
 // @Param body body repository.ScriptInterpreterUpdate true "Interpreter fields"
 // @Success 200 {object} repository.ScriptInterpreter
+// @Security Bearer
 // @Router /scripts/interpreters/:id [put]
 func (self *ScriptHandlers) UpdateInterpreter(c *gin.Context) {
 	id, err := strconv.ParseInt(c.Param("id"), 10, 64)
@@ -192,6 +201,7 @@ func (self *ScriptHandlers) UpdateInterpreter(c *gin.Context) {
 // @Tags scripts
 // @Param id path int true "Interpreter ID"
 // @Success 204
+// @Security Bearer
 // @Router /scripts/interpreters/:id [delete]
 func (self *ScriptHandlers) DeleteInterpreter(c *gin.Context) {
 	id, err := strconv.ParseInt(c.Param("id"), 10, 64)