feat(cmd): create docs command that starts documentation presentation from embedded fs

Author: ploMP4

cmd/docs.go

@@ -0,0 +1,67 @@
+package cmd
+
+import (
+	"fmt"
+	"log/slog"
+
+	tea "github.com/charmbracelet/bubbletea"
+	"github.com/spf13/cobra"
+
+	"github.com/museslabs/kyma/docs"
+	"github.com/museslabs/kyma/internal/config"
+	"github.com/museslabs/kyma/internal/logger"
+	"github.com/museslabs/kyma/internal/tui"
+)
+
+var docsCmd = &cobra.Command{
+	Use:   "docs",
+	Short: "Start documentation as a presentation",
+	Args:  cobra.NoArgs,
+	RunE: func(cmd *cobra.Command, args []string) error {
+		if err := logger.Load(logPath); err != nil {
+			return fmt.Errorf("failed to initialize slog: %w", err)
+		}
+
+		slog.Info("Starting Kyma Docs")
+
+		if err := config.Load(configPath); err != nil {
+			slog.Error("Failed to load config", "error", err, "config_path", configPath)
+			return err
+		}
+
+		data, err := docs.FS.ReadFile("presentation.md")
+		if err != nil {
+			slog.Error(
+				"Failed to read presentation file",
+				"error",
+				err,
+				"filename",
+				"presentation.md",
+			)
+			return err
+		}
+
+		root, err := parseSlides(string(data))
+		if err != nil {
+			slog.Error("Failed to parse slides", "error", err, "filename", "presentation.md")
+			return err
+		}
+
+		slog.Info("Successfully parsed presentation")
+
+		p := tea.NewProgram(
+			tui.New(root, "presentation.md"),
+			tea.WithAltScreen(),
+			tea.WithMouseAllMotion(),
+		)
+
+		slog.Info("Starting TUI program")
+		if _, err := p.Run(); err != nil {
+			slog.Error("TUI program failed", "error", err)
+			return err
+		}
+
+		slog.Info("Kyma docs session ended")
+		return nil
+	},
+}

cmd/root.go

@@ -33,6 +33,7 @@ func init() {
 		StringVarP(&logPath, "log", "l", "", "Path to log file (default: ~/.config/kyma/logs/<timestamp>.kyma.log)")
 	rootCmd.Flags().BoolVarP(&notes, "notes", "n", false, "Run in speaker notes mode")
 	rootCmd.AddCommand(versionCmd)
+	rootCmd.AddCommand(docsCmd)
 }
 
 var rootCmd = &cobra.Command{

cmd/version.go

@@ -11,9 +11,7 @@ var version = "dev"
 var versionCmd = &cobra.Command{
 	Use:   "version",
 	Short: "Print the version number of kyma",
-	Args: func(cmd *cobra.Command, args []string) error {
-		return cobra.NoArgs(cmd, args)
-	},
+	Args:  cobra.NoArgs,
 	Run: func(cmd *cobra.Command, args []string) {
 		fmt.Printf("Kyma %s\n", version)
 	},

docs/docs.go

@@ -0,0 +1,6 @@
+package docs
+
+import "embed"
+
+//go:embed *
+var FS embed.FS