Skip to content

CLAUDE.md

Latest commit

 

History

History
52 lines (36 loc) · 2.17 KB

CLAUDE.md

File metadata and controls

52 lines (36 loc) · 2.17 KB
Raw

cli Development Guidelines

Auto-generated from all feature plans. Last updated: 2026-02-16

Active Technologies

  • Go 1.24.2 (go.mod declares 1.26.0) + cobra, charmbracelet/bubbletea v1.3.4, charmbracelet/huh, charmbracelet/lipgloss v1.1.1, charmbracelet/bubbles v0.21.0; pkg/catalog (existing internal package) (020-pre-release)

  • //go:embed for profiles.yaml (new) and existing services.yaml (unchanged); no new DB (020-pre-release)

  • Go 1.24.2 (016-ui-layout-fix)

  • N/A (UI-only feature, no persistence required) (016-ui-layout-fix)

  • Go 1.24.0 + charmbracelet/bubbletea v1.3.4, charmbracelet/bubbles v0.21.0, charmbracelet/lipgloss v1.1.1, charmbracelet/glamour v0.10.0, charmbracelet/harmonica v0.2.0, charmbracelet/x/ansi v0.8.0, charmbracelet/x/term v0.2.1, spf13/cobra, charmbracelet/huh (NEW — RECOMMENDED for interactive forms) (015-ui-refactor)

Project Structure

src/
tests/

Commands

Add commands for Go 1.24.0

Code Style

Go 1.24.0: Follow standard conventions

Recent Changes

  • 020-pre-release: Added Go 1.24.2 (go.mod declares 1.26.0) + cobra, charmbracelet/bubbletea v1.3.4, charmbracelet/huh, charmbracelet/lipgloss v1.1.1, charmbracelet/bubbles v0.21.0; pkg/catalog (existing internal package)

  • 017-ui-engine: Added UI engine (pkg/ui/engine/), views (pkg/ui/views/), ARC_USE_LEGACY_UI env var for rollback

  • 016-ui-layout-fix: Added Go 1.24.2

    charmbracelet/lipgloss v1.1.1, charmbracelet/glamour v0.10.0, charmbracelet/harmonica v0.2.0, charmbracelet/x/ansi v0.8.0, charmbracelet/x/term v0.2.1, spf13/cobra, charmbracelet/huh (NEW — RECOMMENDED for interactive forms)

Commit Conventions

  • NEVER add Co-Authored-By trailers to commit messages or PR descriptions
  • Commit messages use Conventional Commits: type(scope): description
  • No AI attribution lines of any kind in commits or PRs

UI Engine Architecture (017)

  • New views: pkg/ui/views/ (dashboardview.go, serviceslistview.go, etc.)
  • Engine: pkg/ui/engine/ (Render, TUIMode, JSONMode, ViewContext)
  • Legacy rollback: ARC_USE_LEGACY_UI=1
  • Components: pkg/ui/components/ (hero/, sidebar/, table/, search/, status/)