Function develop

scripts/develop/main.go:607–713

(ctx context.Context, logger slog.Logger, cfg *devConfig)

}

func develop(ctx context.Context, logger slog.Logger, cfg *devConfig) error {
	sigCtx, stop := signal.NotifyContext(ctx, cli.StopSignals...)
	defer stop()

	if err := preflight(sigCtx, logger, cfg); err != nil {
		return err
	}

	// Check the database before building. The mismatch check is
	// a cheap file read; only starts temp postgres on actual
	// mismatch. This avoids a wasted build cycle when the
	// developer needs to re-run with --db-rollback or --db-reset.
	if err := recoverDB(sigCtx, logger, cfg); err != nil {
		return xerrors.Errorf("database recovery: %w", err)
	}

	if err := buildBinary(sigCtx, logger, cfg); err != nil {
		return xerrors.Errorf("build: %w", err)
	}

	// Wrap in a cancelable context so deferred cleanup can
	// trigger graceful shutdown on early return.
	cancelCtx, cancelAll := context.WithCancel(sigCtx)

	group := newProcGroup(cancelCtx, logger)
	defer func() {
		cancelAll()
		_ = group.Wait()
	}()

	ctx = group.Ctx()

	if err := startServer(cfg, group); err != nil {
		return err
	}

	// The vite dev server proxies to the API and handles the
	// case where the API isn't ready yet, so start it in parallel.
	if err := group.Start("site", pnpmCmd(ctx, cfg)); err != nil {
		return xerrors.Errorf("starting frontend: %w", err)
	}

	apiURL := fmt.Sprintf("http://127.0.0.1:%d", cfg.apiPort)
	if err := waitForHealthy(ctx, logger, apiURL); err != nil {
		return err
	}

	// Update migration tracking after the server has applied
	// any new migrations. This keeps the cache current so the
	// next run detects mismatches correctly.
	if err := updateMigrationTracking(ctx, logger, cfg); err != nil {
		logger.Warn(ctx, "failed to update migration tracking",
			slog.Error(err))
	}

	if !cfg.skipSetup {
		client, err := setupFirstUser(ctx, logger, cfg, apiURL)
		if err != nil {