feat: add openboot init for project environment setup

Adds .openboot.yml support for declaring project dependencies in repos.
Teams can commit .openboot.yml to their project root, and new developers
run 'openboot init' to install brew packages, npm globals, and run setup scripts.

- Add ProjectConfig YAML parser (internal/config/project.go)
- Add init command CLI (internal/cli/init.go)
- Add initializer orchestrator (internal/initializer/)
- Support brew taps/packages/casks, npm packages
- Support env vars, init scripts, verify scripts
- Add unit tests and example config

Author: fullstackjam

.openboot.yml.example

@@ -0,0 +1,34 @@
+version: "1.0"
+
+brew:
+  taps:
+    - homebrew/cask-fonts
+  packages:
+    - git
+    - node@20
+    - go
+    - jq
+    - ripgrep
+  casks:
+    - visual-studio-code
+    - docker
+
+npm:
+  - typescript
+  - eslint
+  - prettier
+
+env:
+  NODE_ENV: development
+  API_URL: http://localhost:3000
+
+init:
+  - npm install
+  - cp .env.example .env
+  - npm run db:migrate
+
+verify:
+  - node --version
+  - npm --version
+  - git --version
+  - docker --version

internal/cli/init.go

@@ -0,0 +1,68 @@
+package cli
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"github.com/openbootdotdev/openboot/internal/config"
+	"github.com/openbootdotdev/openboot/internal/initializer"
+	"github.com/openbootdotdev/openboot/internal/updater"
+	"github.com/spf13/cobra"
+)
+
+var initCmd = &cobra.Command{
+	Use:   "init [directory]",
+	Short: "Set up project environment from .openboot.yml",
+	Long: `Read .openboot.yml from the project directory and install declared dependencies,
+run init scripts, and verify the environment is ready.`,
+	Example: `  # Initialize from current directory
+  openboot init
+
+  # Initialize from specific directory
+  openboot init /path/to/project
+
+  # Preview changes without installing
+  openboot init --dry-run`,
+	Args: cobra.MaximumNArgs(1),
+	RunE: func(cmd *cobra.Command, args []string) error {
+		updater.AutoUpgrade(version)
+
+		dir := "."
+		if len(args) > 0 {
+			dir = args[0]
+		}
+
+		absDir, err := filepath.Abs(dir)
+		if err != nil {
+			return fmt.Errorf("failed to resolve directory: %w", err)
+		}
+
+		if _, err := os.Stat(absDir); os.IsNotExist(err) {
+			return fmt.Errorf("directory does not exist: %s", absDir)
+		}
+
+		projectCfg, err := config.LoadProjectConfig(absDir)
+		if err != nil {
+			return err
+		}
+
+		initCfg := &initializer.Config{
+			ProjectDir:    absDir,
+			ProjectConfig: projectCfg,
+			DryRun:        cfg.DryRun,
+			Silent:        cfg.Silent,
+			Update:        cfg.Update,
+			Version:       version,
+		}
+
+		return initializer.Run(initCfg)
+	},
+}
+
+func init() {
+	initCmd.Flags().SortFlags = false
+	initCmd.Flags().BoolVar(&cfg.DryRun, "dry-run", false, "preview changes without installing")
+	initCmd.Flags().BoolVarP(&cfg.Silent, "silent", "s", false, "non-interactive mode (for CI/CD)")
+	initCmd.Flags().BoolVar(&cfg.Update, "update", false, "update Homebrew before installing")
+}

internal/cli/root.go

@@ -96,6 +96,7 @@ func init() {
 	rootCmd.Flags().BoolVar(&cfg.Update, "update", false, "update Homebrew before installing")
 
 	rootCmd.AddCommand(installCmd)
+	rootCmd.AddCommand(initCmd)
 	rootCmd.AddCommand(versionCmd)
 	rootCmd.AddCommand(updateCmd)
 	rootCmd.AddCommand(doctorCmd)

internal/config/project.go

@@ -0,0 +1,90 @@
+package config
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"gopkg.in/yaml.v3"
+)
+
+const ProjectConfigFileName = ".openboot.yml"
+
+// ProjectConfig represents the .openboot.yml file in a project repository
+type ProjectConfig struct {
+	Version string            `yaml:"version"`
+	Brew    *BrewConfig       `yaml:"brew,omitempty"`
+	Npm     []string          `yaml:"npm,omitempty"`
+	Env     map[string]string `yaml:"env,omitempty"`
+	Init    []string          `yaml:"init,omitempty"`
+	Verify  []string          `yaml:"verify,omitempty"`
+}
+
+// BrewConfig represents Homebrew package configuration
+type BrewConfig struct {
+	Taps     []string `yaml:"taps,omitempty"`
+	Packages []string `yaml:"packages,omitempty"`
+	Casks    []string `yaml:"casks,omitempty"`
+}
+
+// LoadProjectConfig reads and parses .openboot.yml from the specified directory
+func LoadProjectConfig(dir string) (*ProjectConfig, error) {
+	configPath := filepath.Join(dir, ProjectConfigFileName)
+
+	data, err := os.ReadFile(configPath)
+	if err != nil {
+		if os.IsNotExist(err) {
+			return nil, fmt.Errorf("%s not found in %s", ProjectConfigFileName, dir)
+		}
+		return nil, fmt.Errorf("failed to read %s: %w", ProjectConfigFileName, err)
+	}
+
+	var pc ProjectConfig
+	if err := yaml.Unmarshal(data, &pc); err != nil {
+		return nil, fmt.Errorf("failed to parse %s: %w", ProjectConfigFileName, err)
+	}
+
+	if err := pc.Validate(); err != nil {
+		return nil, fmt.Errorf("invalid config: %w", err)
+	}
+
+	return &pc, nil
+}
+
+// Validate checks if the project config is valid
+func (pc *ProjectConfig) Validate() error {
+	if pc.Version == "" {
+		return fmt.Errorf("version field is required")
+	}
+
+	if pc.Version != "1.0" {
+		return fmt.Errorf("unsupported version: %s (supported: 1.0)", pc.Version)
+	}
+
+	return nil
+}
+
+// HasPackages returns true if the config has any packages to install
+func (pc *ProjectConfig) HasPackages() bool {
+	if pc.Brew != nil {
+		if len(pc.Brew.Packages) > 0 || len(pc.Brew.Casks) > 0 || len(pc.Brew.Taps) > 0 {
+			return true
+		}
+	}
+	return len(pc.Npm) > 0
+}
+
+// HasInit returns true if the config has init scripts
+func (pc *ProjectConfig) HasInit() bool {
+	return len(pc.Init) > 0
+}
+
+// HasVerify returns true if the config has verify scripts
+func (pc *ProjectConfig) HasVerify() bool {
+	return len(pc.Verify) > 0
+}
+
+// HasEnv returns true if the config has environment variables
+func (pc *ProjectConfig) HasEnv() bool {
+	return len(pc.Env) > 0
+}