[devbox] Allow for custom install/build/start commands (#43)

## Summary
Allow for custom install/build/start commands by customizing them in `devbox.json`. This makes it possible for users to build docker images in the cases when they need to do some customization, or when we have not yet written a language planner for that language.

## How was it tested?
Built, and ran `devbox plan` and `devbox generate` against a few examples.

Author: loreto

.github/workflows/release.yml

@@ -45,7 +45,7 @@ jobs:
         with:
           distribution: goreleaser
           version: latest
-          args: release --rm-dist --skip-publish --snapshot
+          args: release --rm-dist --skip-publish --skip-announce --snapshot
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           TELEMETRY_KEY: ${{ secrets.TELEMETRY_KEY }}

boxcli/add.go

@@ -11,9 +11,10 @@ import (
 
 func AddCmd() *cobra.Command {
 	command := &cobra.Command{
-		Use:  "add <pkg>...",
-		Args: cobra.MinimumNArgs(1),
-		RunE: runAddCmd,
+		Use:   "add <pkg>...",
+		Short: "Add a new package to your devbox",
+		Args:  cobra.MinimumNArgs(1),
+		RunE:  runAddCmd,
 	}
 	return command
 }

boxcli/build.go

@@ -14,10 +14,10 @@ func BuildCmd() *cobra.Command {
 	flags := &docker.BuildFlags{}
 
 	command := &cobra.Command{
-		Use:    "build [<dir>]",
-		Args:   cobra.MaximumNArgs(1),
-		Hidden: true, // Hide until ready for release.
-		RunE:   buildCmdFunc(flags),
+		Use:   "build [<dir>]",
+		Short: "Build an OCI image that can run as a container",
+		Args:  cobra.MaximumNArgs(1),
+		RunE:  buildCmdFunc(flags),
 	}
 
 	command.Flags().BoolVar(

boxcli/init.go

@@ -11,9 +11,10 @@ import (
 
 func InitCmd() *cobra.Command {
 	command := &cobra.Command{
-		Use:  "init [<dir>]",
-		Args: cobra.MaximumNArgs(1),
-		RunE: runInitCmd,
+		Use:   "init [<dir>]",
+		Short: "Initialize a directory as a devbox project",
+		Args:  cobra.MaximumNArgs(1),
+		RunE:  runInitCmd,
 	}
 	return command
 }

boxcli/plan.go

@@ -13,9 +13,10 @@ import (
 
 func PlanCmd() *cobra.Command {
 	command := &cobra.Command{
-		Use:  "plan [<dir>]",
-		Args: cobra.MaximumNArgs(1),
-		RunE: runPlanCmd,
+		Use:   "plan [<dir>]",
+		Short: "Preview the plan used to build your environment",
+		Args:  cobra.MaximumNArgs(1),
+		RunE:  runPlanCmd,
 	}
 	return command
 }

boxcli/rm.go

@@ -11,9 +11,10 @@ import (
 
 func RemoveCmd() *cobra.Command {
 	command := &cobra.Command{
-		Use:  "rm <pkg>...",
-		Args: cobra.MinimumNArgs(1),
-		RunE: runRemoveCmd,
+		Use:   "rm <pkg>...",
+		Short: "Remove a package from your devbox",
+		Args:  cobra.MinimumNArgs(1),
+		RunE:  runRemoveCmd,
 	}
 	return command
 }

boxcli/root.go

@@ -16,7 +16,8 @@ import (
 
 func RootCmd() *cobra.Command {
 	command := &cobra.Command{
-		Use: "devbox",
+		Use:   "devbox",
+		Short: "Instant, easy, predictable shells and containers",
 		PersistentPreRun: func(cmd *cobra.Command, args []string) {
 			// Don't display 'usage' on application errors.
 			cmd.SilenceUsage = true

boxcli/shell.go

@@ -15,9 +15,10 @@ import (
 
 func ShellCmd() *cobra.Command {
 	command := &cobra.Command{
-		Use:  "shell [<dir>]",
-		Args: cobra.MaximumNArgs(1),
-		RunE: runShellCmd,
+		Use:   "shell [<dir>]",
+		Short: "Start a new shell with access to your packages",
+		Args:  cobra.MaximumNArgs(1),
+		RunE:  runShellCmd,
 	}
 	return command
 }

boxcli/version.go

@@ -14,9 +14,10 @@ import (
 func VersionCmd() *cobra.Command {
 	flags := &versionFlags{}
 	command := &cobra.Command{
-		Use:  "version",
-		Args: cobra.NoArgs,
-		RunE: versionCmdFunc(flags),
+		Use:   "version",
+		Short: "Print version information",
+		Args:  cobra.NoArgs,
+		RunE:  versionCmdFunc(flags),
 	}
 
 	command.Flags().BoolVarP(&flags.verbose, "verbose", "v", false, // value

config.go

@@ -6,13 +6,12 @@ package devbox
 import (
 	"github.com/pkg/errors"
 	"go.jetpack.io/devbox/cuecfg"
+	"go.jetpack.io/devbox/planner"
 )
 
 // Config defines a devbox environment as JSON.
 type Config struct {
-	// Packages is the slice of Nix packages that devbox makes available in
-	// its environment.
-	Packages []string `cue:"[...string]" json:"packages,omitempty"`
+	planner.Plan
 }
 
 // ReadConfig reads a devbox config file.