feat(ui): polish TUI output for ask, knowledge, and doctor commands

- Add styled category badges with per-type colors to knowledge table
- Replace bullet list with proper table layout and alternating row styles
- Improve ask output: boxed query header, compact citation lines with
  score bars, styled answer panel with border
- Add animated terminal spinner (braille frames) during LLM/search calls
- Restyle doctor checks with PASS/WARN/FAIL badges and italic hints
- Add shared Lipgloss style tokens: table rows, check statuses, citations
- Add unit tests for styles, badges, and spinner lifecycle

Author: josephgoksu

cmd/ask.go

@@ -90,7 +90,20 @@ func runAsk(cmd *cobra.Command, args []string) error {
 		opts.StreamWriter = os.Stdout
 	}
 
+	// Show spinner during LLM query (non-JSON mode only)
+	var spin *ui.Spinner
+	if !isJSON() && generateAnswer {
+		spin = ui.NewSpinner("Generating answer...")
+		spin.Start()
+	} else if !isJSON() {
+		spin = ui.NewSpinner("Searching knowledge...")
+		spin.Start()
+	}
+
 	result, err := askApp.Query(cmd.Context(), query, opts)
+	if spin != nil {
+		spin.Stop()
+	}
 	if err != nil {
 		return fmt.Errorf("query failed: %w", err)
 	}

cmd/doctor.go

@@ -171,41 +171,43 @@ func runDoctor(cmd *cobra.Command) error {
 	}
 
 	// Human-readable output
-	fmt.Println("🩺 TaskWing Doctor")
-	fmt.Println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
+	headerStyle := ui.StyleHeader.Bold(true)
+	divider := ui.StyleSubtle.Render(strings.Repeat("━", 55))
+
+	fmt.Println()
+	fmt.Println(headerStyle.Render("TaskWing Doctor"))
+	fmt.Println(divider)
 	fmt.Println()
 
-	// Print all checks
+	// Print all checks with styled output
 	for _, c := range checks {
-		printCheck(c)
+		printStyledCheck(c)
 	}
 
 	if opts.Fix {
 		fmt.Println()
-		fmt.Println("🔧 Repair Summary")
-		fmt.Printf("   Planned: %d\n", len(repairPlan))
-		fmt.Printf("   Applied: %d\n", len(appliedRepairs))
-		fmt.Printf("   Skipped: %d\n", len(skippedRepairs))
-		fmt.Printf("   Blocked: %d\n", len(blockedRepairs))
+		fmt.Println(headerStyle.Render("Repair Summary"))
+		fmt.Printf("  Planned: %d  Applied: %d  Skipped: %d  Blocked: %d\n",
+			len(repairPlan), len(appliedRepairs), len(skippedRepairs), len(blockedRepairs))
 		for _, action := range blockedRepairs {
-			fmt.Printf("   ⊘ %s/%s: %s\n", action.AI, action.Component, action.Reason)
+			fmt.Printf("  %s %s/%s: %s\n", ui.StyleCheckFail.Render("BLOCKED"), action.AI, action.Component, action.Reason)
 		}
 		for _, action := range skippedRepairs {
-			fmt.Printf("   ⊘ %s/%s: %s\n", action.AI, action.Component, action.Reason)
+			fmt.Printf("  %s %s/%s: %s\n", ui.StyleCheckWarn.Render("SKIPPED"), action.AI, action.Component, action.Reason)
 		}
 	}
 
 	fmt.Println()
-	fmt.Println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
+	fmt.Println(divider)
 
-	// Summary and next steps
+	// Summary with styled status
 	if hasErrors {
-		fmt.Println("❌ Issues found. Fix the errors above before continuing.")
+		fmt.Println(ui.StyleCheckFail.Render("  FAIL") + "  Issues found. Fix the errors above before continuing.")
 	} else if hasWarnings {
-		fmt.Println("⚠️  Warnings found. Review the warnings above.")
+		fmt.Println(ui.StyleCheckWarn.Render("  WARN") + "  Warnings found. Review the warnings above.")
 		printNextSteps(checks)
 	} else {
-		fmt.Println("✅ Everything looks good!")
+		fmt.Println(ui.StyleCheckOK.Render("  PASS") + "  Everything looks good!")
 		printNextSteps(checks)
 	}
 
@@ -237,19 +239,26 @@ func makeGlobalMCPMap(ais []string) map[string]bool {
 }
 
 func printCheck(c DoctorCheck) {
-	var icon string
+	printStyledCheck(c)
+}
+
+func printStyledCheck(c DoctorCheck) {
+	var statusBadge string
 	switch c.Status {
 	case "ok":
-		icon = "✅"
+		statusBadge = ui.StyleCheckOK.Render("  ✔ PASS")
 	case "warn":
-		icon = "⚠️ "
+		statusBadge = ui.StyleCheckWarn.Render("  ⚠ WARN")
 	case "fail":
-		icon = "❌"
+		statusBadge = ui.StyleCheckFail.Render("  ✖ FAIL")
 	}
 
-	fmt.Printf("%s %s: %s\n", icon, c.Name, c.Message)
+	name := ui.StyleCheckName.Render(c.Name)
+	msg := ui.StyleText.Render(c.Message)
+
+	fmt.Printf("%s  %s: %s\n", statusBadge, name, msg)
 	if c.Hint != "" && c.Status != "ok" {
-		fmt.Printf("   └─ %s\n", c.Hint)
+		fmt.Printf("         %s\n", ui.StyleCheckHint.Render("└─ "+c.Hint))
 	}
 }
 

internal/ui/context_view.go

@@ -308,42 +308,57 @@ func getContentWithoutSummary(content, summary string) string {
 // RenderAskResult displays a complete AskResult from the ask pipeline.
 // This is the primary rendering function for the `taskwing ask` command.
 func RenderAskResult(result *app.AskResult, verbose bool) {
-	titleStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("205")).Bold(true)
 	sectionStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("141")).Bold(true)
-	metaStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("241"))
 
-	// Title
+	// Header with query in a styled box
+	headerBox := lipgloss.NewStyle().
+		Bold(true).
+		Foreground(ColorPrimary).
+		Padding(0, 1).
+		Border(lipgloss.RoundedBorder()).
+		BorderForeground(ColorSecondary)
+
+	fmt.Println()
 	if result.Answer != "" {
-		fmt.Println()
-		fmt.Println(titleStyle.Render(fmt.Sprintf("📖 %s", result.Query)))
+		fmt.Println(headerBox.Render(fmt.Sprintf("Q: %s", result.Query)))
 	} else {
-		fmt.Println(titleStyle.Render(fmt.Sprintf("🔍 Results for: \"%s\"", result.Query)))
+		fmt.Println(headerBox.Render(fmt.Sprintf("Search: %s", result.Query)))
 	}
 
-	// Pipeline info
-	fmt.Println(metaStyle.Render(fmt.Sprintf("  Pipeline: %s", result.Pipeline)))
+	// Pipeline & rewrite as dim metadata
+	var metaParts []string
+	metaParts = append(metaParts, result.Pipeline)
 	if result.RewrittenQuery != "" {
-		fmt.Println(metaStyle.Render(fmt.Sprintf("  Rewritten: %s", result.RewrittenQuery)))
+		metaParts = append(metaParts, fmt.Sprintf("rewritten: %s", result.RewrittenQuery))
+	}
+	if result.Total > 0 || result.TotalSymbols > 0 {
+		metaParts = append(metaParts, fmt.Sprintf("%d knowledge, %d symbols", result.Total, result.TotalSymbols))
 	}
+	fmt.Println(StyleAskMeta.Render("  " + strings.Join(metaParts, " | ")))
 
 	// Warning
 	if result.Warning != "" {
 		fmt.Println()
 		fmt.Println(RenderWarningPanel("Warning", result.Warning))
 	}
 
-	// Answer (only render if not already streamed — streaming writes directly to stdout)
+	// Answer box with accent border
 	if result.Answer != "" {
 		fmt.Println()
-		fmt.Println(RenderInfoPanel("Answer", result.Answer))
+		answerBox := lipgloss.NewStyle().
+			Border(lipgloss.RoundedBorder()).
+			BorderForeground(ColorBlue).
+			Padding(1, 2).
+			Width(80)
+		fmt.Println(answerBox.Render(result.Answer))
 	}
 
-	// Knowledge results
+	// Sources as compact citations
 	if len(result.Results) > 0 {
 		fmt.Println()
-		fmt.Println(sectionStyle.Render("📚 Knowledge"))
+		fmt.Println(sectionStyle.Render("Sources"))
+		fmt.Println()
 
-		// Convert NodeResponse to ScoredNode for the existing panel renderer
 		scored := nodeResponsesToScoredNodes(result.Results)
 
 		var maxScore float32 = 0.01
@@ -354,31 +369,78 @@ func RenderAskResult(result *app.AskResult, verbose bool) {
 		}
 
 		for i, s := range scored {
-			renderScoredNodePanel(i+1, s, maxScore, verbose)
+			renderCitation(i+1, s, maxScore)
 		}
 	}
 
 	// Code symbols
 	if len(result.Symbols) > 0 {
 		fmt.Println()
-		fmt.Println(sectionStyle.Render("💻 Code Symbols"))
+		fmt.Println(sectionStyle.Render("Code Symbols"))
+		fmt.Println()
 
 		for i, sym := range result.Symbols {
-			renderSymbolPanel(i+1, sym, verbose)
+			renderSymbolCitation(i+1, sym)
 		}
 	}
 
 	// No results
 	if len(result.Results) == 0 && len(result.Symbols) == 0 && result.Answer == "" {
 		fmt.Println()
-		fmt.Println(metaStyle.Render("  No results found. Try a different query or run 'taskwing bootstrap' to populate memory."))
+		fmt.Println(StyleAskMeta.Render("  No results found. Try a different query or run 'taskwing bootstrap' to populate memory."))
 	}
 
-	// Summary line
-	if result.Total > 0 || result.TotalSymbols > 0 {
-		fmt.Println()
-		fmt.Println(metaStyle.Render(fmt.Sprintf("  %d knowledge result(s), %d symbol(s)", result.Total, result.TotalSymbols)))
+	fmt.Println()
+}
+
+// renderCitation renders a knowledge source as a compact citation line.
+func renderCitation(index int, s knowledge.ScoredNode, maxScore float32) {
+	summary := s.Node.Summary
+	if summary == "" {
+		runes := []rune(s.Node.Text())
+		if len(runes) > 60 {
+			summary = string(runes[:60]) + "..."
+		} else {
+			summary = string(runes)
+		}
+	}
+
+	badge := CategoryBadge(s.Node.Type)
+	scoreBar := renderMiniBar(s.Score, maxScore)
+
+	id := s.Node.ID
+	if len(id) > 8 {
+		id = id[:8]
+	}
+
+	fmt.Printf("  %s %s  %s  %s\n",
+		StyleCitationBadge.Render(fmt.Sprintf("[%d]", index)),
+		badge,
+		lipgloss.NewStyle().Foreground(ColorText).Render(summary),
+		StyleCitationPath.Render(fmt.Sprintf("(%s %s)", id, scoreBar)),
+	)
+}
+
+// renderSymbolCitation renders a code symbol as a compact citation line.
+func renderSymbolCitation(index int, sym app.SymbolResponse) {
+	icon := symbolKindIcon(sym.Kind)
+	fmt.Printf("  %s %s %s  %s\n",
+		StyleCitationBadge.Render(fmt.Sprintf("[%d]", index)),
+		icon,
+		lipgloss.NewStyle().Foreground(ColorText).Bold(true).Render(sym.Name),
+		StyleCitationPath.Render(sym.Location),
+	)
+}
+
+// renderMiniBar renders a compact score indicator.
+func renderMiniBar(score, maxScore float32) string {
+	rel := score / maxScore
+	filled := int(rel * 5)
+	if filled < 1 && score > 0 {
+		filled = 1
 	}
+	bar := strings.Repeat("█", filled) + strings.Repeat("░", 5-filled)
+	return bar
 }
 
 // nodeResponsesToScoredNodes converts NodeResponse slice to ScoredNode slice