Re-add mass schema dereference command (#171)

* Re-add  command

* Update docs/helpdocs/schema/dereference.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* doc changes

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: chrisghill

cmd/schema.go

@@ -1,11 +1,16 @@
 package cmd
 
 import (
+	"encoding/json"
 	"fmt"
+	"os"
+	"path/filepath"
 
 	"github.com/massdriver-cloud/mass/docs/helpdocs"
+	"github.com/massdriver-cloud/mass/pkg/bundle"
 	"github.com/massdriver-cloud/mass/pkg/jsonschema"
 	"github.com/massdriver-cloud/mass/pkg/prettylogs"
+	"github.com/massdriver-cloud/massdriver-sdk-go/massdriver/client"
 	"github.com/spf13/cobra"
 )
 
@@ -16,6 +21,15 @@ func NewCmdSchema() *cobra.Command {
 		Long:  helpdocs.MustRender("schema"),
 	}
 
+	schemaDereferenceCmd := &cobra.Command{
+		Use:   "dereference",
+		Short: "Dereferences a JSON Schema",
+		Long:  helpdocs.MustRender("schema/dereference"),
+		RunE:  runSchemaDereference,
+	}
+	schemaDereferenceCmd.Flags().StringP("file", "f", "", "Path to JSON document (use - for stdin)")
+	schemaDereferenceCmd.MarkFlagRequired("file")
+
 	schemaValidateCmd := &cobra.Command{
 		Use:   "validate",
 		Short: "Validates a JSON document against a JSON Schema",
@@ -27,11 +41,59 @@ func NewCmdSchema() *cobra.Command {
 	schemaValidateCmd.MarkFlagRequired("document")
 	schemaValidateCmd.MarkFlagRequired("schema")
 
+	schemaCmd.AddCommand(schemaDereferenceCmd)
 	schemaCmd.AddCommand(schemaValidateCmd)
 
 	return schemaCmd
 }
 
+func runSchemaDereference(cmd *cobra.Command, args []string) error {
+	schemaPath, _ := cmd.Flags().GetString("file")
+	cmd.SilenceUsage = true
+
+	var schemaFile *os.File
+	basePath := "."
+	if schemaPath == "-" {
+		schemaFile = os.Stdin
+	} else {
+		var openErr error
+		schemaFile, openErr = os.Open(schemaPath)
+		basePath = filepath.Dir(schemaPath)
+		if openErr != nil {
+			return fmt.Errorf("failed to open schema file %s: %w", schemaPath, openErr)
+		}
+		defer schemaFile.Close()
+	}
+
+	var rawSchema map[string]any
+	if err := json.NewDecoder(schemaFile).Decode(&rawSchema); err != nil {
+		return fmt.Errorf("failed to decode JSON schema: %w", err)
+	}
+
+	mdClient, mdClientErr := client.New()
+	if mdClientErr != nil {
+		return fmt.Errorf("error initializing massdriver client: %w", mdClientErr)
+	}
+
+	derefOpts := bundle.DereferenceOptions{
+		Client: mdClient,
+		Cwd:    basePath,
+	}
+	dereferencedSchema, derefErr := bundle.DereferenceSchema(rawSchema, derefOpts)
+	if derefErr != nil {
+		return fmt.Errorf("failed to dereference schema: %w", derefErr)
+	}
+
+	dereferencedJSON, jsonErr := json.MarshalIndent(dereferencedSchema, "", "  ")
+	if jsonErr != nil {
+		return fmt.Errorf("failed to marshal dereferenced schema to JSON: %w", jsonErr)
+	}
+
+	fmt.Println(string(dereferencedJSON))
+
+	return nil
+}
+
 func runSchemaValidate(cmd *cobra.Command, args []string) error {
 	schemaPath, _ := cmd.Flags().GetString("schema")
 	documentPath, _ := cmd.Flags().GetString("document")

docs/generated/mass_bundle_new.md

@@ -44,10 +44,10 @@ mass bundle new [flags]
   -c, --connections strings       Connections and names to add to the bundle - example: network=massdriver/vpc
   -d, --description string        Description of the new bundle
   -h, --help                      help for new
-  -n, --name string               Name of the new bundle. Setting this will disable the interactive prompt.
+  -n, --name string               Name of the new bundle. Setting this along with --template-name will disable the interactive prompt.
   -o, --output-directory string   Directory to output the new bundle (default ".")
   -p, --params-directory string   Path with existing params to use - opentofu module directory or helm chart values.yaml
-  -t, --template-name string      Name of the bundle template to use. Setting this will disable the interactive prompt.
+  -t, --template-name string      Name of the bundle template to use. Setting this along with --name will disable the interactive prompt.
 ```
 
 ### SEE ALSO

docs/generated/mass_schema.md

@@ -26,4 +26,5 @@ mass schema validate --schema=my-json-schema.json --document=my-document.json
 ### SEE ALSO
 
 * [mass](/cli/commands/mass)	 - Massdriver Cloud CLI
+* [mass schema dereference](/cli/commands/mass_schema_dereference)	 - Dereferences a JSON Schema
 * [mass schema validate](/cli/commands/mass_schema_validate)	 - Validates a JSON document against a JSON Schema

docs/generated/mass_schema_dereference.md

@@ -0,0 +1,45 @@
+---
+id: mass_schema_dereference.md
+slug: /cli/commands/mass_schema_dereference
+title: Mass Schema Dereference
+sidebar_label: Mass Schema Dereference
+---
+## mass schema dereference
+
+Dereferences a JSON Schema
+
+### Synopsis
+
+# Dereferences a JSON Schema Document
+
+This command will expand all the `$ref` statements in a JSON Schema. This command is useful when managing artifact definition schemas and using `$refs` to keep your definitions "DRY".
+
+## Examples
+
+From an existing file
+
+```shell
+mass schema dereference --file artdef.json
+```
+
+From stdin
+
+```shell
+cat artdef.json | mass schema dereference -f -
+```
+
+
+```
+mass schema dereference [flags]
+```
+
+### Options
+
+```
+  -f, --file string   Path to JSON document (use - for stdin)
+  -h, --help          help for dereference
+```
+
+### SEE ALSO
+
+* [mass schema](/cli/commands/mass_schema)	 - Manage JSON Schemas

docs/helpdocs/schema/dereference.md

@@ -0,0 +1,17 @@
+# Dereferences a JSON Schema Document
+
+This command will expand all the `$ref` statements in a JSON Schema. This command is useful when managing artifact definition schemas and using `$refs` to keep your definitions "DRY".
+
+## Examples
+
+From an existing file
+
+```shell
+mass schema dereference --file artdef.json
+```
+
+From stdin
+
+```shell
+cat artdef.json | mass schema dereference -f -
+```