feat(cli)!: rename 'beans query' to 'beans graphql'

hmans · hmans · commit ddb17549a452 · 2025-12-13T00:32:48.000+01:00
- Rename cmd/query.go to cmd/graphql.go
- Update command name from 'query' to 'graphql'
- Keep 'query' as an alias for backwards compatibility
- Update help text and examples

BREAKING CHANGE: The primary command name is now 'graphql' instead of
'query'. The old 'query' name still works as an alias.
diff --git a/.beans/beans-b4yj--rename-beans-query-to-beans-graphql.md b/.beans/beans-b4yj--rename-beans-query-to-beans-graphql.md
@@ -1,10 +1,10 @@
 ---
 title: Rename 'beans query' to 'beans graphql'
-status: todo
+status: completed
 type: feature
 priority: normal
 created_at: 2025-12-12T22:38:27Z
-updated_at: 2025-12-12T23:04:42Z
+updated_at: 2025-12-12T23:32:32Z
 parent: beans-xnp8
 ---
 
diff --git a/cmd/graphql.go b/cmd/graphql.go
@@ -25,35 +25,36 @@ var (
 	querySchemaOnly bool
 )
 
-var queryCmd = &cobra.Command{
-	Use:   "query <graphql>",
-	Short: "Execute a GraphQL query",
-	Long: `Execute a GraphQL query against the beans data.
+var graphqlCmd = &cobra.Command{
+	Use:     "graphql <query>",
+	Aliases: []string{"query"},
+	Short:   "Execute a GraphQL query or mutation",
+	Long: `Execute a GraphQL query or mutation against the beans data.
 
-The query argument should be a valid GraphQL query string.
+The argument should be a valid GraphQL query or mutation string.
 
 Examples:
   # List all beans
-  beans query '{ beans { id title status } }'
+  beans graphql '{ beans { id title status } }'
 
   # Get a specific bean
-  beans query '{ bean(id: "abc") { title status body } }'
+  beans graphql '{ bean(id: "abc") { title status body } }'
 
   # Filter beans by status
-  beans query '{ beans(filter: { status: ["todo", "in-progress"] }) { id title } }'
+  beans graphql '{ beans(filter: { status: ["todo", "in-progress"] }) { id title } }'
 
   # Get beans with relationships
-  beans query '{ beans { id title blockedBy { id title } children { id title } } }'
+  beans graphql '{ beans { id title blockedBy { id title } children { id title } } }'
 
   # Use variables
-  beans query -v '{"id": "abc"}' 'query GetBean($id: ID!) { bean(id: $id) { title } }'
+  beans graphql -v '{"id": "abc"}' 'query GetBean($id: ID!) { bean(id: $id) { title } }'
 
-  # Read query from stdin (useful for complex queries or escaping issues)
-  echo '{ beans { id title } }' | beans query
-  cat query.graphql | beans query
+  # Read from stdin (useful for complex queries or escaping issues)
+  echo '{ beans { id title } }' | beans graphql
+  cat query.graphql | beans graphql
 
   # Print the schema
-  beans query --schema`,
+  beans graphql --schema`,
 	Args: func(cmd *cobra.Command, args []string) error {
 		if querySchemaOnly {
 			return nil
@@ -206,9 +207,9 @@ func GetGraphQLSchema() string {
 }
 
 func init() {
-	queryCmd.Flags().BoolVar(&queryJSON, "json", false, "Output raw JSON (no formatting)")
-	queryCmd.Flags().StringVarP(&queryVariables, "variables", "v", "", "Query variables as JSON string")
-	queryCmd.Flags().StringVarP(&queryOperation, "operation", "o", "", "Operation name (for multi-operation documents)")
-	queryCmd.Flags().BoolVar(&querySchemaOnly, "schema", false, "Print the GraphQL schema and exit")
-	rootCmd.AddCommand(queryCmd)
+	graphqlCmd.Flags().BoolVar(&queryJSON, "json", false, "Output raw JSON (no formatting)")
+	graphqlCmd.Flags().StringVarP(&queryVariables, "variables", "v", "", "Query variables as JSON string")
+	graphqlCmd.Flags().StringVarP(&queryOperation, "operation", "o", "", "Operation name (for multi-operation documents)")
+	graphqlCmd.Flags().BoolVar(&querySchemaOnly, "schema", false, "Print the GraphQL schema and exit")
+	rootCmd.AddCommand(graphqlCmd)
 }
