package cmd import ( "encoding/json" "fmt" "os" "os/exec" "path/filepath" "strings" "time" "github.com/spf13/cobra" "github.com/steveyegge/gastown/internal/config" "github.com/steveyegge/gastown/internal/deps" "github.com/steveyegge/gastown/internal/style" "github.com/steveyegge/gastown/internal/templates" "github.com/steveyegge/gastown/internal/workspace" ) var ( installForce bool installName string installOwner string installPublicName string installNoBeads bool installGit bool installGitHub string installPublic bool ) var installCmd = &cobra.Command{ Use: "install [path]", GroupID: GroupWorkspace, Short: "Create a new Gas Town HQ (workspace)", Long: `Create a new Gas Town HQ at the specified path. The HQ (headquarters) is the top-level directory where Gas Town is installed - the root of your workspace where all rigs and agents live. It contains: - CLAUDE.md Mayor role context (Mayor runs from HQ root) - mayor/ Mayor config, state, and rig registry - rigs/ Managed rig containers (created by 'gt rig add') - .beads/ Town-level beads DB (hq-* prefix for mayor mail) If path is omitted, uses the current directory. See docs/hq.md for advanced HQ configurations including beads redirects, multi-system setups, and HQ templates. Examples: gt install ~/gt # Create HQ at ~/gt gt install . --name my-workspace # Initialize current dir gt install ~/gt --no-beads # Skip .beads/ initialization gt install ~/gt --git # Also init git with .gitignore gt install ~/gt --github=user/repo # Create private GitHub repo (default) gt install ~/gt --github=user/repo --public # Create public GitHub repo`, Args: cobra.MaximumNArgs(1), RunE: runInstall, } func init() { installCmd.Flags().BoolVarP(&installForce, "force", "f", false, "Overwrite existing HQ") installCmd.Flags().StringVarP(&installName, "name", "n", "", "Town name (defaults to directory name)") installCmd.Flags().StringVar(&installOwner, "owner", "", "Owner email for entity identity (defaults to git config user.email)") installCmd.Flags().StringVar(&installPublicName, "public-name", "", "Public display name (defaults to town name)") installCmd.Flags().BoolVar(&installNoBeads, "no-beads", false, "Skip town beads initialization") installCmd.Flags().BoolVar(&installGit, "git", false, "Initialize git with .gitignore") installCmd.Flags().StringVar(&installGitHub, "github", "", "Create GitHub repo (format: owner/repo, private by default)") installCmd.Flags().BoolVar(&installPublic, "public", false, "Make GitHub repo public (use with --github)") rootCmd.AddCommand(installCmd) } func runInstall(cmd *cobra.Command, args []string) error { // Determine target path targetPath := "." if len(args) > 0 { targetPath = args[0] } // Expand ~ and resolve to absolute path if targetPath[0] == '~' { home, err := os.UserHomeDir() if err != nil { return fmt.Errorf("getting home directory: %w", err) } targetPath = filepath.Join(home, targetPath[1:]) } absPath, err := filepath.Abs(targetPath) if err != nil { return fmt.Errorf("resolving path: %w", err) } // Determine town name townName := installName if townName == "" { townName = filepath.Base(absPath) } // Check if already a workspace if isWS, _ := workspace.IsWorkspace(absPath); isWS && !installForce { return fmt.Errorf("directory is already a Gas Town HQ (use --force to reinitialize)") } // Check if inside an existing workspace if existingRoot, _ := workspace.Find(absPath); existingRoot != "" && existingRoot != absPath { style.PrintWarning("Creating HQ inside existing workspace at %s", existingRoot) } // Ensure beads (bd) is available before proceeding if !installNoBeads { if err := deps.EnsureBeads(true); err != nil { return fmt.Errorf("beads dependency check failed: %w", err) } } fmt.Printf("%s Creating Gas Town HQ at %s\n\n", style.Bold.Render("🏭"), style.Dim.Render(absPath)) // Create directory structure if err := os.MkdirAll(absPath, 0755); err != nil { return fmt.Errorf("creating directory: %w", err) } // Create mayor directory (holds config, state, and mail) mayorDir := filepath.Join(absPath, "mayor") if err := os.MkdirAll(mayorDir, 0755); err != nil { return fmt.Errorf("creating mayor directory: %w", err) } fmt.Printf(" ✓ Created mayor/\n") // Determine owner (defaults to git user.email) owner := installOwner if owner == "" { out, err := exec.Command("git", "config", "user.email").Output() if err == nil { owner = strings.TrimSpace(string(out)) } } // Determine public name (defaults to town name) publicName := installPublicName if publicName == "" { publicName = townName } // Create town.json in mayor/ townConfig := &config.TownConfig{ Type: "town", Version: config.CurrentTownVersion, Name: townName, Owner: owner, PublicName: publicName, CreatedAt: time.Now(), } townPath := filepath.Join(mayorDir, "town.json") if err := config.SaveTownConfig(townPath, townConfig); err != nil { return fmt.Errorf("writing town.json: %w", err) } fmt.Printf(" ✓ Created mayor/town.json\n") // Create rigs.json in mayor/ rigsConfig := &config.RigsConfig{ Version: config.CurrentRigsVersion, Rigs: make(map[string]config.RigEntry), } rigsPath := filepath.Join(mayorDir, "rigs.json") if err := config.SaveRigsConfig(rigsPath, rigsConfig); err != nil { return fmt.Errorf("writing rigs.json: %w", err) } fmt.Printf(" ✓ Created mayor/rigs.json\n") // Create rigs directory (for managed rig clones) rigsDir := filepath.Join(absPath, "rigs") if err := os.MkdirAll(rigsDir, 0755); err != nil { return fmt.Errorf("creating rigs directory: %w", err) } fmt.Printf(" ✓ Created rigs/\n") // Create mayor state.json mayorState := &config.AgentState{ Role: "mayor", LastActive: time.Now(), } statePath := filepath.Join(mayorDir, "state.json") if err := config.SaveAgentState(statePath, mayorState); err != nil { return fmt.Errorf("writing mayor state: %w", err) } fmt.Printf(" ✓ Created mayor/state.json\n") // Create Mayor CLAUDE.md at HQ root (Mayor runs from there) if err := createMayorCLAUDEmd(absPath, absPath); err != nil { fmt.Printf(" %s Could not create CLAUDE.md: %v\n", style.Dim.Render("⚠"), err) } else { fmt.Printf(" ✓ Created CLAUDE.md\n") } // Initialize town-level beads database (optional) // Town beads (hq- prefix) stores mayor mail, cross-rig coordination, and handoffs. // Rig beads are separate and have their own prefixes. if !installNoBeads { if err := initTownBeads(absPath); err != nil { fmt.Printf(" %s Could not initialize town beads: %v\n", style.Dim.Render("⚠"), err) } else { fmt.Printf(" ✓ Initialized .beads/ (town-level beads with hq- prefix)\n") } // NOTE: Agent beads (gt-deacon, gt-mayor) are created by gt rig add, // not here. This is because the daemon looks up beads by prefix routing, // and no rig exists yet at install time. The first rig added will get // these global agent beads in its beads database. } // Detect and save overseer identity overseer, err := config.DetectOverseer(absPath) if err != nil { fmt.Printf(" %s Could not detect overseer identity: %v\n", style.Dim.Render("⚠"), err) } else { overseerPath := config.OverseerConfigPath(absPath) if err := config.SaveOverseerConfig(overseerPath, overseer); err != nil { fmt.Printf(" %s Could not save overseer config: %v\n", style.Dim.Render("⚠"), err) } else { fmt.Printf(" ✓ Detected overseer: %s (via %s)\n", overseer.FormatOverseerIdentity(), overseer.Source) } } // Initialize git if requested (--git or --github implies --git) if installGit || installGitHub != "" { fmt.Println() if err := InitGitForHarness(absPath, installGitHub, !installPublic); err != nil { return fmt.Errorf("git initialization failed: %w", err) } } fmt.Printf("\n%s HQ created successfully!\n", style.Bold.Render("✓")) fmt.Println() fmt.Println("Next steps:") step := 1 if !installGit && installGitHub == "" { fmt.Printf(" %d. Initialize git: %s\n", step, style.Dim.Render("gt git-init")) step++ } fmt.Printf(" %d. Add a rig: %s\n", step, style.Dim.Render("gt rig add ")) step++ fmt.Printf(" %d. Start the Mayor: %s\n", step, style.Dim.Render("cd "+absPath+" && gt prime")) return nil } func createMayorCLAUDEmd(hqRoot, townRoot string) error { tmpl, err := templates.New() if err != nil { return err } data := templates.RoleData{ Role: "mayor", TownRoot: townRoot, WorkDir: hqRoot, } content, err := tmpl.RenderRole("mayor", data) if err != nil { return err } claudePath := filepath.Join(hqRoot, "CLAUDE.md") return os.WriteFile(claudePath, []byte(content), 0644) } func writeJSON(path string, data interface{}) error { content, err := json.MarshalIndent(data, "", " ") if err != nil { return err } return os.WriteFile(path, content, 0644) } // initTownBeads initializes town-level beads database using bd init. // Town beads use the "hq-" prefix for mayor mail and cross-rig coordination. func initTownBeads(townPath string) error { // Run: bd init --prefix hq cmd := exec.Command("bd", "init", "--prefix", "hq") cmd.Dir = townPath output, err := cmd.CombinedOutput() if err != nil { // Check if beads is already initialized if strings.Contains(string(output), "already initialized") { // Already initialized - still need to ensure fingerprint exists } else { return fmt.Errorf("bd init failed: %s", strings.TrimSpace(string(output))) } } // Ensure database has repository fingerprint (GH #25). // This is idempotent - safe on both new and legacy (pre-0.17.5) databases. // Without fingerprint, the bd daemon fails to start silently. if err := ensureRepoFingerprint(townPath); err != nil { // Non-fatal: fingerprint is optional for functionality, just daemon optimization fmt.Printf(" %s Could not verify repo fingerprint: %v\n", style.Dim.Render("⚠"), err) } return nil } // ensureRepoFingerprint runs bd migrate --update-repo-id to ensure the database // has a repository fingerprint. Legacy databases (pre-0.17.5) lack this, which // prevents the daemon from starting properly. func ensureRepoFingerprint(beadsPath string) error { cmd := exec.Command("bd", "migrate", "--update-repo-id") cmd.Dir = beadsPath output, err := cmd.CombinedOutput() if err != nil { return fmt.Errorf("bd migrate --update-repo-id: %s", strings.TrimSpace(string(output))) } return nil }