query: クエリグラフ取得サブコマンドを追加 (#28)

GET /api/v1/query/graph/{query_code} を呼び出してクエリに設定された
グラフ画像 (PNG/JPEG) をダウンロードする `xpoint query graph` サブ
コマンドを追加。--format で PNG/JPEG を選択、--output で保存先
(ファイル/ディレクトリ/- で stdout) を指定できる。

refs #25

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Author: buty4649

cmd/query.go

@@ -18,6 +18,9 @@ var (
 	queryExecRows   int
 	queryExecOffset int
 	queryExecJQ     string
+
+	queryGraphFormat string
+	queryGraphOutput string
 )
 
 var queryCmd = &cobra.Command{
@@ -44,10 +47,26 @@ only. --rows (default 500) and --offset control pagination for list queries.`,
 	RunE: runQueryExec,
 }
 
+var queryGraphCmd = &cobra.Command{
+	Use:   "graph <query_code>",
+	Short: "Download the graph image of a query",
+	Long: `Download the graph image configured on a query via
+GET /api/v1/query/graph/{query_code}.
+
+The format defaults to PNG; pass --format jpeg for JPEG. Output destination:
+  --output FILE    save to FILE
+  --output DIR/    save into DIR/ using the server-provided filename
+  --output -       write the image bytes to stdout
+  (default)        use the server-provided filename in the current directory`,
+	Args: cobra.ExactArgs(1),
+	RunE: runQueryGraph,
+}
+
 func init() {
 	rootCmd.AddCommand(queryCmd)
 	queryCmd.AddCommand(queryListCmd)
 	queryCmd.AddCommand(queryExecCmd)
+	queryCmd.AddCommand(queryGraphCmd)
 
 	lf := queryListCmd.Flags()
 	lf.StringVarP(&queryListOutput, "output", "o", "", "output format: table|json (default: table on TTY, json otherwise)")
@@ -58,6 +77,10 @@ func init() {
 	ef.IntVar(&queryExecRows, "rows", 0, "max rows returned by list queries (0 = omit; server default 500; range 1-10000)")
 	ef.IntVar(&queryExecOffset, "offset", 0, "offset for list queries (0 = omit)")
 	ef.StringVar(&queryExecJQ, "jq", "", "apply a gojq filter to the JSON response")
+
+	gf := queryGraphCmd.Flags()
+	gf.StringVar(&queryGraphFormat, "format", "", "image format: png | jpeg (default: png)")
+	gf.StringVarP(&queryGraphOutput, "output", "o", "", "output path: FILE, DIR/, or - for stdout (default: server-provided filename in current directory)")
 }
 
 func runQueryList(cmd *cobra.Command, args []string) error {
@@ -128,3 +151,43 @@ func runQueryExec(cmd *cobra.Command, args []string) error {
 	}
 	return writeJSON(os.Stdout, raw)
 }
+
+func runQueryGraph(cmd *cobra.Command, args []string) error {
+	queryCode := strings.TrimSpace(args[0])
+	if queryCode == "" {
+		return fmt.Errorf("query_code is required")
+	}
+	format := strings.ToLower(strings.TrimSpace(queryGraphFormat))
+	switch format {
+	case "", "png", "jpeg":
+	default:
+		return fmt.Errorf("unknown --format %q (must be png or jpeg)", queryGraphFormat)
+	}
+
+	client, err := newClientFromFlags(cmd.Context())
+	if err != nil {
+		return err
+	}
+	filename, data, err := client.GetQueryGraph(cmd.Context(), queryCode, format)
+	if err != nil {
+		return err
+	}
+
+	if queryGraphOutput == "-" {
+		_, werr := os.Stdout.Write(data)
+		return werr
+	}
+	if filename == "" {
+		ext := "png"
+		if format == "jpeg" {
+			ext = "jpg"
+		}
+		filename = fmt.Sprintf("%s.%s", queryCode, ext)
+	}
+	dst := resolveDownloadPath(queryGraphOutput, filename, 0)
+	if err := os.WriteFile(dst, data, 0o600); err != nil {
+		return fmt.Errorf("write image: %w", err)
+	}
+	fmt.Fprintf(os.Stderr, "saved: %s (%d bytes)\n", dst, len(data))
+	return nil
+}

internal/schema/query.graph.json

@@ -0,0 +1,25 @@
+{
+  "method": "GET",
+  "path": "/api/v1/query/graph/{query_code}",
+  "summary": "クエリグラフ表示",
+  "description": "認証ユーザが閲覧できるクエリに設定されているグラフ画像を取得する。PNG か JPEG を指定可能 (デフォルト PNG)。",
+  "parameters": [
+    {
+      "name": "query_code",
+      "in": "path",
+      "type": "string",
+      "required": true,
+      "description": "クエリコード"
+    },
+    {
+      "name": "outFormat",
+      "in": "query",
+      "type": "string",
+      "description": "フォーマット: png / jpeg (デフォルト: png)"
+    }
+  ],
+  "response": {
+    "contentType": "image/png | image/jpeg",
+    "description": "グラフ画像 (Content-Disposition でファイル名が返される)"
+  }
+}

internal/schema/schema_test.go

@@ -34,6 +34,7 @@ func TestAliases_Sorted(t *testing.T) {
 		"form.list",
 		"form.show",
 		"query.exec",
+		"query.graph",
 		"query.list",
 	}
 	if len(got) != len(want) {

internal/xpoint/client.go

@@ -530,6 +530,24 @@ func (c *Client) GetQuery(ctx context.Context, queryCode string, p GetQueryParam
 	return out, nil
 }
 
+// GetQueryGraph calls GET /api/v1/query/graph/{query_code} and returns the
+// image bytes and the server-provided filename (from Content-Disposition).
+// outFormat must be "png" or "jpeg" (empty string defaults to png on the
+// server).
+func (c *Client) GetQueryGraph(ctx context.Context, queryCode, outFormat string) (string, []byte, error) {
+	path := fmt.Sprintf("/api/v1/query/graph/%s", url.PathEscape(queryCode))
+	var q url.Values
+	if outFormat != "" {
+		q = url.Values{}
+		q.Set("outFormat", outFormat)
+	}
+	accept := "image/png"
+	if outFormat == "jpeg" {
+		accept = "image/jpeg"
+	}
+	return c.downloadBytes(ctx, http.MethodGet, path, q, nil, "", accept)
+}
+
 type AddCommentRequest struct {
 	Content      string `json:"content"`
 	AttentionFlg int    `json:"attentionflg"`