Update dependencies and improve health check functionality

- Updated `github.com/xraph/vessel` and `github.com/xraph/go-utils` to version 1.0.0 across multiple modules.
- Enhanced health check aggregation to use the map key as the canonical name, ensuring accurate reporting.
- Added validation to ensure health check names are not empty during registration.
- Improved metric value retrieval to include type metadata for better exporter handling.

Author: juicycleff

.gitignore

@@ -126,5 +126,8 @@ METRICS_DEADLOCK_FIX.md
 extensions/dashboard/forgeui
 *.blob
 
+# Node modules (for Tailwind CSS builds)
+extensions/**/node_modules/
+
 # Worktrees
 .worktrees/

cmd/forge/go.mod

@@ -89,8 +89,8 @@ require (
 	github.com/xdg-go/scram v1.1.2 // indirect
 	github.com/xdg-go/stringprep v1.0.4 // indirect
 	github.com/xraph/confy v0.1.0 // indirect
-	github.com/xraph/go-utils v0.0.11 // indirect
-	github.com/xraph/vessel v0.0.5 // indirect
+	github.com/xraph/go-utils v1.0.0 // indirect
+	github.com/xraph/vessel v1.0.0 // indirect
 	github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 // indirect
 	go.mongodb.org/mongo-driver v1.17.4 // indirect
 	go.uber.org/multierr v1.11.0 // indirect

cmd/forge/go.sum

@@ -306,10 +306,10 @@ github.com/xdg-go/stringprep v1.0.4 h1:XLI/Ng3O1Atzq0oBs3TWm+5ZVgkq2aqdlvP9JtoZ6
 github.com/xdg-go/stringprep v1.0.4/go.mod h1:mPGuuIYwz7CmR2bT9j4GbQqutWS1zV24gijq1dTyGkM=
 github.com/xraph/confy v0.1.0 h1:dAdI/ShnkU5PEXVsfR86swoWj6XjJ37BdPQpBIUmg9M=
 github.com/xraph/confy v0.1.0/go.mod h1:/uhVfKibPR+kn7MI9LkVVekk84NP0sxsKZ9sFQoQ5Kc=
-github.com/xraph/go-utils v0.0.11 h1:9CT0l4yQ8RWIQJmFQcxjA1cb8Re2fHxJPDNmdmG8Vz8=
-github.com/xraph/go-utils v0.0.11/go.mod h1:yp+PD9dXSA7tA9Pxmuveg5E7Ht1iHIVov8yMvanMG7U=
-github.com/xraph/vessel v0.0.5 h1:vA/H+lB6MzBkvesysBVHRaBFtHxgVLTExCfuwWMJbjs=
-github.com/xraph/vessel v0.0.5/go.mod h1:t7UbkGensTnqpvda2gOnH2/lnAwnUpa5oEDFHwIqQ+k=
+github.com/xraph/go-utils v1.0.0 h1:P1jOvtDlC5xZyGtnIhypFfPUBgpfyrwESY4TK4P2I5g=
+github.com/xraph/go-utils v1.0.0/go.mod h1:yp+PD9dXSA7tA9Pxmuveg5E7Ht1iHIVov8yMvanMG7U=
+github.com/xraph/vessel v1.0.0 h1:n2q30d0OGPENpFfmOUgEuS99Y+X6b6WTfzdOHiE4Ds0=
+github.com/xraph/vessel v1.0.0/go.mod h1:quT3UWDXZF0RLL34H3ijXP9kVnh2pdfnn0f2s3ezChA=
 github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 h1:ilQV1hzziu+LLM3zUTJ0trRztfwgjqKnBWNtSRkbmwM=
 github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78/go.mod h1:aL8wCCfTfSfmXjznFBSZNN13rSJjlIOI1fUNAtF7rmI=
 github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=

cmd/forge/plugins/contributor.go

@@ -44,8 +44,8 @@ func (p *ContributorPlugin) Commands() []cli.Command {
 		"new",
 		"Scaffold a new dashboard contributor",
 		p.newContributor,
-		cli.WithFlag(cli.NewStringFlag("framework", "f", "UI framework (astro, nextjs)", "")),
-		cli.WithFlag(cli.NewStringFlag("mode", "m", "Build mode (static, ssr)", "static")),
+		cli.WithFlag(cli.NewStringFlag("framework", "f", "UI framework (templ, astro, nextjs)", "")),
+		cli.WithFlag(cli.NewStringFlag("mode", "m", "Build mode (static, ssr, local)", "static")),
 		cli.WithFlag(cli.NewBoolFlag("in-extension", "e", "Scaffold inside an existing extension directory", false)),
 	))
 
@@ -105,22 +105,30 @@ func (p *ContributorPlugin) newContributor(ctx cli.CommandContext) error {
 	framework := ctx.String("framework")
 	if framework == "" {
 		var err error
-		framework, err = ctx.Select("UI framework:", []string{"astro", "nextjs"})
+		framework, err = ctx.Select("UI framework:", []string{"templ (recommended)", "astro", "nextjs"})
 		if err != nil {
 			return err
 		}
+		// Normalize the selection (strip suffix)
+		if framework == "templ (recommended)" {
+			framework = "templ"
+		}
 	}
 	if !contribConfig.ValidFrameworkTypes[framework] {
-		return fmt.Errorf("unsupported framework: %s (use astro, nextjs, or custom)", framework)
+		return fmt.Errorf("unsupported framework: %s (use templ, astro, nextjs, or custom)", framework)
 	}
 
 	// Get build mode
 	mode := ctx.String("mode")
 	if mode == "" {
-		mode = "static"
+		if framework == "templ" {
+			mode = "local"
+		} else {
+			mode = "static"
+		}
 	}
 	if !contribConfig.ValidBuildModes[mode] {
-		return fmt.Errorf("unsupported build mode: %s (use static or ssr)", mode)
+		return fmt.Errorf("unsupported build mode: %s (use static, ssr, or local)", mode)
 	}
 
 	// Determine target directory
@@ -143,10 +151,17 @@ func (p *ContributorPlugin) newContributor(ctx cli.CommandContext) error {
 	spinner := ctx.Spinner(fmt.Sprintf("Scaffolding %s contributor with %s (%s)...", name, framework, mode))
 
 	// Create directory structure
-	uiDir := filepath.Join(targetDir, "ui")
-	if err := os.MkdirAll(uiDir, 0755); err != nil {
-		spinner.Stop(cli.Red("✗ Failed"))
-		return err
+	if framework != "templ" {
+		uiDir := filepath.Join(targetDir, "ui")
+		if err := os.MkdirAll(uiDir, 0755); err != nil {
+			spinner.Stop(cli.Red("✗ Failed"))
+			return err
+		}
+	} else {
+		if err := os.MkdirAll(targetDir, 0755); err != nil {
+			spinner.Stop(cli.Red("✗ Failed"))
+			return err
+		}
 	}
 
 	// Prepare template data
@@ -179,7 +194,13 @@ func (p *ContributorPlugin) newContributor(ctx cli.CommandContext) error {
 	}
 
 	// Framework-specific scaffolding
+	uiDir := filepath.Join(targetDir, "ui")
 	switch framework {
+	case "templ":
+		if err := p.scaffoldTempl(targetDir, data); err != nil {
+			spinner.Stop(cli.Red("✗ Failed"))
+			return err
+		}
 	case "astro":
 		if err := p.scaffoldAstro(uiDir, data); err != nil {
 			spinner.Stop(cli.Red("✗ Failed"))
@@ -196,10 +217,42 @@ func (p *ContributorPlugin) newContributor(ctx cli.CommandContext) error {
 
 	ctx.Println("")
 	ctx.Success("Next steps:")
-	ctx.Println(fmt.Sprintf("  1. cd %s/ui && npm install", relPath(p.config.RootDir, targetDir)))
-	ctx.Println("  2. Edit UI pages in ui/src/pages/ (Astro) or ui/app/ (Next.js)")
-	ctx.Println(fmt.Sprintf("  3. forge contributor build %s", name))
-	ctx.Println(fmt.Sprintf("  4. forge contributor dev %s    # for live development", name))
+	if framework == "templ" {
+		ctx.Println(fmt.Sprintf("  1. cd %s", relPath(p.config.RootDir, targetDir)))
+		ctx.Println("  2. Edit .templ files (pages.templ, widgets.templ, settings.templ)")
+		ctx.Println("  3. templ generate    # generate Go code from .templ files")
+		ctx.Println("  4. Register the contributor in your extension's init()")
+	} else {
+		ctx.Println(fmt.Sprintf("  1. cd %s/ui && npm install", relPath(p.config.RootDir, targetDir)))
+		ctx.Println("  2. Edit UI pages in ui/src/pages/ (Astro) or ui/app/ (Next.js)")
+		ctx.Println(fmt.Sprintf("  3. forge contributor build %s", name))
+		ctx.Println(fmt.Sprintf("  4. forge contributor dev %s    # for live development", name))
+	}
+
+	return nil
+}
+
+// scaffoldTempl creates templ-specific project files directly in the contributor directory.
+func (p *ContributorPlugin) scaffoldTempl(targetDir string, data scaffoldTemplateData) error {
+	// Write contributor.go (main Go file with RenderPage/RenderWidget/RenderSettings)
+	if err := writeTemplate(filepath.Join(targetDir, "contributor.go"), templContributorGoTemplate, data); err != nil {
+		return err
+	}
+
+	// Write pages.templ (sample overview page)
+	if err := writeTemplate(filepath.Join(targetDir, "pages.templ"), templPageTemplate, data); err != nil {
+		return err
+	}
+
+	// Write widgets.templ (sample status widget)
+	if err := writeTemplate(filepath.Join(targetDir, "widgets.templ"), templWidgetTemplate, data); err != nil {
+		return err
+	}
+
+	// Write settings.templ (sample settings panel)
+	if err := writeTemplate(filepath.Join(targetDir, "settings.templ"), templSettingsTemplate, data); err != nil {
+		return err
+	}
 
 	return nil
 }
@@ -331,8 +384,8 @@ func (p *ContributorPlugin) buildSingleContributor(ctx cli.CommandContext, dir s
 
 	ctx.Info(fmt.Sprintf("Building contributor: %s (%s, %s mode)", cfg.DisplayName, cfg.Type, cfg.Build.Mode))
 
-	// Step 1: npm install (if requested and node_modules doesn't exist or flag set)
-	if install {
+	// Step 1: npm install (if requested, not templ, and node_modules doesn't exist)
+	if install && cfg.Type != "templ" {
 		if _, err := os.Stat(filepath.Join(uiDir, "node_modules")); os.IsNotExist(err) {
 			spinner := ctx.Spinner("Installing dependencies...")
 			pm := detectPackageManager(uiDir)
@@ -359,9 +412,15 @@ func (p *ContributorPlugin) buildSingleContributor(ctx cli.CommandContext, dir s
 		buildCmd = adapter.DefaultBuildCmd(cfg.Build.Mode)
 	}
 
+	// For templ, run the build command in the contributor dir; for others, in the ui dir
+	buildDir := uiDir
+	if cfg.Type == "templ" {
+		buildDir = configDir
+	}
+
 	spinner := ctx.Spinner(fmt.Sprintf("Building %s UI...", cfg.Type))
 	cmd := exec.Command("sh", "-c", buildCmd)
-	cmd.Dir = uiDir
+	cmd.Dir = buildDir
 	cmd.Stdout = os.Stdout
 	cmd.Stderr = os.Stderr
 	if err := cmd.Run(); err != nil {
@@ -370,10 +429,12 @@ func (p *ContributorPlugin) buildSingleContributor(ctx cli.CommandContext, dir s
 	}
 	spinner.Stop(cli.Green("✓ UI built"))
 
-	// Step 3: Validate build output
-	distPath := cfg.DistPath(configDir)
-	if err := adapter.ValidateBuild(distPath); err != nil {
-		return fmt.Errorf("build validation failed: %w", err)
+	// Step 3: Validate build output (skip for templ — compiled into Go binary)
+	if cfg.Type != "templ" {
+		distPath := cfg.DistPath(configDir)
+		if err := adapter.ValidateBuild(distPath); err != nil {
+			return fmt.Errorf("build validation failed: %w", err)
+		}
 	}
 
 	// Step 4: Run codegen
@@ -463,19 +524,21 @@ func (p *ContributorPlugin) devContributor(ctx cli.CommandContext) error {
 	cfgDir := filepath.Dir(yamlPath)
 	uiDir := cfg.UIPath(cfgDir)
 
-	// Ensure dependencies are installed
-	if _, err := os.Stat(filepath.Join(uiDir, "node_modules")); os.IsNotExist(err) {
-		spinner := ctx.Spinner("Installing dependencies...")
-		pm := detectPackageManager(uiDir)
-		cmd := exec.Command("sh", "-c", installCmd(pm))
-		cmd.Dir = uiDir
-		cmd.Stdout = os.Stdout
-		cmd.Stderr = os.Stderr
-		if err := cmd.Run(); err != nil {
-			spinner.Stop(cli.Red("✗ Install failed"))
-			return fmt.Errorf("npm install failed: %w", err)
+	// Ensure dependencies are installed (skip for templ)
+	if cfg.Type != "templ" {
+		if _, err := os.Stat(filepath.Join(uiDir, "node_modules")); os.IsNotExist(err) {
+			spinner := ctx.Spinner("Installing dependencies...")
+			pm := detectPackageManager(uiDir)
+			cmd := exec.Command("sh", "-c", installCmd(pm))
+			cmd.Dir = uiDir
+			cmd.Stdout = os.Stdout
+			cmd.Stderr = os.Stderr
+			if err := cmd.Run(); err != nil {
+				spinner.Stop(cli.Red("✗ Install failed"))
+				return fmt.Errorf("npm install failed: %w", err)
+			}
+			spinner.Stop(cli.Green("✓ Dependencies installed"))
 		}
-		spinner.Stop(cli.Green("✓ Dependencies installed"))
 	}
 
 	// Determine dev command
@@ -489,19 +552,25 @@ func (p *ContributorPlugin) devContributor(ctx cli.CommandContext) error {
 		devCmd = adapter.DefaultDevCmd()
 	}
 
-	// Add port if specified
+	// Add port if specified (not applicable for templ)
 	port := ctx.Int("port")
-	if port > 0 {
+	if port > 0 && cfg.Type != "templ" {
 		devCmd = fmt.Sprintf("%s --port %d", devCmd, port)
 	}
 
+	// For templ, run in contributor dir; for others, in ui dir
+	runDir := uiDir
+	if cfg.Type == "templ" {
+		runDir = cfgDir
+	}
+
 	ctx.Info(fmt.Sprintf("Starting %s dev server for %s...", cfg.Type, cfg.DisplayName))
-	ctx.Info(fmt.Sprintf("  UI dir: %s", relPath(p.config.RootDir, uiDir)))
+	ctx.Info(fmt.Sprintf("  Dir: %s", relPath(p.config.RootDir, runDir)))
 	ctx.Println("")
 
 	// Run dev server (blocking — user Ctrl+C to stop)
 	cmd := exec.Command("sh", "-c", devCmd)
-	cmd.Dir = uiDir
+	cmd.Dir = runDir
 	cmd.Stdout = os.Stdout
 	cmd.Stderr = os.Stderr
 	cmd.Stdin = os.Stdin

cmd/forge/plugins/contributor_adapters.go

@@ -31,6 +31,8 @@ type FrameworkAdapter interface {
 // GetFrameworkAdapter returns the adapter for the given framework type.
 func GetFrameworkAdapter(frameworkType string) (FrameworkAdapter, error) {
 	switch frameworkType {
+	case "templ":
+		return &TemplAdapter{}, nil
 	case "astro":
 		return &AstroAdapter{}, nil
 	case "nextjs":
@@ -129,6 +131,33 @@ func (a *CustomAdapter) ValidateBuild(distDir string) error {
 	return nil
 }
 
+// TemplAdapter provides templ-specific build configuration.
+// Templ contributors are Go-native — they compile directly into the Go binary
+// without requiring Node.js, npm, or a separate build output directory.
+type TemplAdapter struct{}
+
+func (a *TemplAdapter) Name() string { return "templ" }
+
+func (a *TemplAdapter) DefaultBuildCmd(_ string) string {
+	return "templ generate"
+}
+
+func (a *TemplAdapter) DefaultDevCmd() string {
+	return "templ generate --watch"
+}
+
+func (a *TemplAdapter) DefaultDistDir(_ string) string {
+	return "" // No dist dir — compiled into Go binary
+}
+
+func (a *TemplAdapter) DefaultSSREntry() string {
+	return "" // No SSR entry — runs in-process via LocalContributor
+}
+
+func (a *TemplAdapter) ValidateBuild(_ string) error {
+	return nil // Templ generates Go code; validation happens at go build time
+}
+
 // detectPackageManager detects the package manager from lockfiles in the given directory.
 func detectPackageManager(dir string) string {
 	if _, err := os.Stat(filepath.Join(dir, "pnpm-lock.yaml")); err == nil {