Centralize Rich markup styles across the codebase

Extended styles.py to provide semantic style definitions and helper
functions for consistent formatting throughout jgo. This eliminates
~100+ hardcoded style occurrences across 18 files and enables users
to customize all UI elements via configuration.

Changes:
- Added 9 semantic style keys to DEFAULT_STYLES: error, critical,
  warning, filename, header, syntax, action, secondary, domain
- Created 9 helper functions: error(), critical(), warning(),
  filepath(), header(), syntax(), action(), secondary(), domain(), tip()
- Added pre-formatted string constants for common patterns:
  JGO_TOML, JGO_LOCK_TOML, JGO_CONF_GLOBAL, PLUS_OPERATOR,
  AT_MAINCLASS, DOUBLE_DASH, MAVEN_COORDINATES, MAVEN_REPOSITORIES,
  TIP_DRY_RUN
- Refactored 15 command files and 3 core modules to use centralized
  styles instead of inline markup
- Standardized section headers to "bold cyan" style for consistency
- Fixed malformed close tag [/cyan] → [/] in config.py
- Updated test expectations in wrap.t for new header style

Benefits:
- Single source of truth for all UI styling
- Consistent appearance across all commands and output
- All styles now customizable via [styles] section in config
- Easier maintenance and future style updates
- More readable code with semantic helper functions

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

Author: ctrueden

src/jgo/cli/commands/add.py

@@ -9,7 +9,7 @@
 
 from ...config import GlobalSettings
 from ...env.spec import EnvironmentSpec
-from ...styles import COORD_HELP_FULL
+from ...styles import COORD_HELP_FULL, JGO_TOML, syntax
 from ..args import build_parsed_args
 from ..output import handle_dry_run
 from . import sync as sync_cmd
@@ -20,7 +20,7 @@
 _log = logging.getLogger(__name__)
 
 
-@click.command(help="Add dependencies to [cyan]jgo.toml[/].")
+@click.command(help=f"Add dependencies to {JGO_TOML}.")
 @click.argument(
     "coordinates",
     nargs=-1,
@@ -31,7 +31,7 @@
 @click.option(
     "--no-sync",
     is_flag=True,
-    help="Don't automatically [yellow]sync[/] after adding dependencies",
+    help=f"Don't automatically {syntax('sync')} after adding dependencies",
 )
 @click.pass_context
 def add(ctx, coordinates, no_sync):

src/jgo/cli/commands/config.py

@@ -12,6 +12,7 @@
 from ...config import GlobalSettings
 from ...config.manager import get_settings_path
 from ...config.settings import parse_config_key
+from ...styles import JGO_CONF_GLOBAL, JGO_TOML, error, filepath
 from ...util.toml import load_toml_file
 from ..args import build_parsed_args
 from ..console import console_print
@@ -188,7 +189,7 @@ def _get_config(config_file: Path, config_type: str, key: str, args: ParsedArgs)
 
     if not config_file.exists():
         console_print(
-            f"[red]Error:[/] No {config_type} configuration file found at {config_file}",
+            error(f"No {config_type} configuration file found at {config_file}"),
             stderr=True,
         )
         return 1
@@ -322,7 +323,7 @@ def _set_toml(
     data = load_toml_file(config_file)
     if data is None:
         console_print(
-            f"[red]Error:[/] No local configuration file found at {config_file}",
+            error(f"No local configuration file found at {config_file}"),
             stderr=True,
         )
         console_print(
@@ -360,7 +361,7 @@ def _unset_config(
 
     if not config_file.exists():
         console_print(
-            f"[red]Error:[/] No {config_type} configuration file found at {config_file}",
+            error(f"No {config_type} configuration file found at {config_file}"),
             stderr=True,
         )
         return 1
@@ -380,7 +381,7 @@ def _unset_jgorc(config_file: Path, section: str, key: str, args: ParsedArgs) ->
 
     if not config_file.exists():
         console_print(
-            f"[red]Error:[/] No configuration file found at {config_file}",
+            error(f"No configuration file found at {config_file}"),
             stderr=True,
         )
         return 1
@@ -494,13 +495,13 @@ def _parse_value(value: str) -> str | int | float | bool:
     "--global",
     "global_config",
     is_flag=True,
-    help="Use global configuration ([cyan]~/.config/jgo.conf[/]).",
+    help=f"Use global configuration ({JGO_CONF_GLOBAL}).",
 )
 @click.option(
     "--local",
     "local_config",
     is_flag=True,
-    help="Use local configuration ([cyan]jgo.toml[/]).",
+    help=f"Use local configuration ({JGO_TOML}).",
 )
 @click.pass_context
 def list_cmd(ctx, global_config, local_config):
@@ -527,19 +528,19 @@ def list_cmd(ctx, global_config, local_config):
 @click.argument(
     "key",
     cls=click.RichArgument,
-    help="Configuration key in dot notation (e.g., [cyan]repositories.scijava[/])",
+    help=f"Configuration key in dot notation (e.g., {filepath('repositories.scijava')})",
 )
 @click.option(
     "--global",
     "global_config",
     is_flag=True,
-    help="Use global configuration ([cyan]~/.config/jgo.conf[/])",
+    help=f"Use global configuration ({JGO_CONF_GLOBAL})",
 )
 @click.option(
     "--local",
     "local_config",
     is_flag=True,
-    help="Use local configuration ([cyan]jgo.toml[/])",
+    help=f"Use local configuration ({JGO_TOML})",
 )
 @click.pass_context
 def get_cmd(ctx, key, global_config, local_config):
@@ -566,20 +567,20 @@ def get_cmd(ctx, key, global_config, local_config):
 @click.argument(
     "key",
     cls=click.RichArgument,
-    help="Configuration key in dot notation (e.g., [cyan]repositories.scijava[/])",
+    help=f"Configuration key in dot notation (e.g., {filepath('repositories.scijava')})",
 )
 @click.argument("value", cls=click.RichArgument, help="Configuration value to set")
 @click.option(
     "--global",
     "global_config",
     is_flag=True,
-    help="Use global configuration ([cyan]~/.config/jgo.conf[/])",
+    help=f"Use global configuration ({JGO_CONF_GLOBAL})",
 )
 @click.option(
     "--local",
     "local_config",
     is_flag=True,
-    help="Use local configuration ([cyan]jgo.toml[/cyan])",
+    help=f"Use local configuration ({JGO_TOML})",
 )
 @click.pass_context
 def set_cmd(ctx, key, value, global_config, local_config):
@@ -606,19 +607,19 @@ def set_cmd(ctx, key, value, global_config, local_config):
 @click.argument(
     "key",
     cls=click.RichArgument,
-    help="Configuration key in dot notation (e.g., [cyan]repositories.scijava[/])",
+    help=f"Configuration key in dot notation (e.g., {filepath('repositories.scijava')})",
 )
 @click.option(
     "--global",
     "global_config",
     is_flag=True,
-    help="Use global configuration ([cyan]~/.config/jgo.conf[/]).",
+    help=f"Use global configuration ({JGO_CONF_GLOBAL}).",
 )
 @click.option(
     "--local",
     "local_config",
     is_flag=True,
-    help="Use local configuration ([cyan]jgo.toml[/]).",
+    help=f"Use local configuration ({JGO_TOML}).",
 )
 @click.pass_context
 def unset_cmd(ctx, key, global_config, local_config):

src/jgo/cli/commands/info.py

@@ -14,7 +14,7 @@
 from ...env.jar import parse_manifest, read_raw_manifest
 from ...parse.coordinate import Coordinate
 from ...parse.endpoint import Endpoint
-from ...styles import COORD_HELP_FULL
+from ...styles import AT_MAINCLASS, COORD_HELP_FULL, JGO_TOML, PLUS_OPERATOR
 from ..args import build_parsed_args
 from ..console import console_print
 from ..context import create_environment_builder, create_maven_context
@@ -35,8 +35,8 @@
     "endpoint",
     required=False,
     cls=click.RichArgument,
-    help="Maven coordinates (single or combined with [yellow]+[/]) "
-    "optionally followed by [yellow]@MainClass[/]",
+    help=f"Maven coordinates (single or combined with {PLUS_OPERATOR}) "
+    f"optionally followed by {AT_MAINCLASS}",
 )
 @click.pass_context
 def classpath(ctx, endpoint):
@@ -72,8 +72,8 @@ def classpath(ctx, endpoint):
     "endpoint",
     required=False,
     cls=click.RichArgument,
-    help="Maven coordinates (single or combined with [yellow]+[/]) "
-    "optionally followed by [yellow]@MainClass[/]",
+    help=f"Maven coordinates (single or combined with {PLUS_OPERATOR}) "
+    f"optionally followed by {AT_MAINCLASS}",
 )
 @click.pass_context
 def envdir(ctx, endpoint):
@@ -109,8 +109,8 @@ def envdir(ctx, endpoint):
     "endpoint",
     required=False,
     cls=click.RichArgument,
-    help="Maven coordinates (single or combined with [yellow]+[/]) "
-    "optionally followed by [yellow]@MainClass[/]",
+    help=f"Maven coordinates (single or combined with {PLUS_OPERATOR}) "
+    f"optionally followed by {AT_MAINCLASS}",
 )
 @click.pass_context
 def jars(ctx, endpoint):
@@ -253,7 +253,7 @@ def javainfo(ctx, endpoint):
     ctx.exit(0)
 
 
-@click.command(help="Show entrypoints from [cyan]jgo.toml[/].")
+@click.command(help=f"Show entrypoints from {JGO_TOML}.")
 @click.pass_context
 def entrypoints(ctx):
     """Show available entrypoints defined in jgo.toml."""
@@ -439,7 +439,9 @@ def _print_deps(ctx, endpoint, list_mode: bool):
             ctx.exit(1)
         spec = EnvironmentSpec.load(spec_file)
         try:
-            coordinates = [Coordinate.parse(coord_str) for coord_str in spec.coordinates]
+            coordinates = [
+                Coordinate.parse(coord_str) for coord_str in spec.coordinates
+            ]
         except ValueError as e:
             _log.error(f"Invalid coordinate format: {e}")
             ctx.exit(1)

src/jgo/cli/commands/init.py

@@ -11,6 +11,7 @@
 
 from ...config import GlobalSettings
 from ...env import EnvironmentSpec
+from ...styles import AT_MAINCLASS, JGO_TOML, PLUS_OPERATOR
 from ..args import build_parsed_args
 from ..output import handle_dry_run
 
@@ -20,13 +21,13 @@
 _log = logging.getLogger(__name__)
 
 
-@click.command(help="Create a new [cyan]jgo.toml[/] environment file.")
+@click.command(help=f"Create a new {JGO_TOML} environment file.")
 @click.argument(
     "endpoint",
     required=False,
     cls=click.RichArgument,
-    help="Maven coordinates (single or combined with [yellow]+[/]) "
-    "optionally followed by [yellow]@MainClass[/]",
+    help=f"Maven coordinates (single or combined with {PLUS_OPERATOR}) "
+    f"optionally followed by {AT_MAINCLASS}",
 )
 @click.pass_context
 def init(ctx, endpoint):

src/jgo/cli/commands/list.py

@@ -11,6 +11,7 @@
 from ...env import EnvironmentSpec
 from ...parse.coordinate import Coordinate
 from ...parse.endpoint import Endpoint
+from ...styles import AT_MAINCLASS, PLUS_OPERATOR
 from ..args import build_parsed_args
 from ..context import create_environment_builder, create_maven_context
 from ..output import print_dependencies
@@ -26,8 +27,8 @@
     "endpoint",
     required=False,
     cls=click.RichArgument,
-    help="Maven coordinates (single or combined with [yellow]+[/]) "
-    "optionally followed by [yellow]@MainClass[/]",
+    help=f"Maven coordinates (single or combined with {PLUS_OPERATOR}) "
+    f"optionally followed by {AT_MAINCLASS}",
 )
 @click.option(
     "--direct", is_flag=True, help="Show only direct dependencies (non-transitive)"
@@ -66,7 +67,9 @@ def execute(args: ParsedArgs, config: dict) -> int:
             return 1
         spec = EnvironmentSpec.load(spec_file)
         try:
-            coordinates = [Coordinate.parse(coord_str) for coord_str in spec.coordinates]
+            coordinates = [
+                Coordinate.parse(coord_str) for coord_str in spec.coordinates
+            ]
         except ValueError as e:
             _log.error(f"Invalid coordinate format: {e}")
             return 1

src/jgo/cli/commands/lock.py

@@ -10,6 +10,7 @@
 from ...config import GlobalSettings
 from ...env.lockfile import LockFile, compute_spec_hash
 from ...env.spec import EnvironmentSpec
+from ...styles import JGO_LOCK_TOML
 from ...util.logging import log_exception_if_verbose
 from ..args import build_parsed_args
 from ..context import create_environment_builder, create_maven_context
@@ -20,7 +21,7 @@
 _log = logging.getLogger(__name__)
 
 
-@click.command(help="Update [cyan]jgo.lock.toml[/] without building environment.")
+@click.command(help=f"Update {JGO_LOCK_TOML} without building environment.")
 @click.option(
     "--check",
     is_flag=True,

src/jgo/cli/commands/remove.py

@@ -10,7 +10,7 @@
 from ...config import GlobalSettings
 from ...env.spec import EnvironmentSpec
 from ...parse.coordinate import Coordinate
-from ...styles import styled
+from ...styles import JGO_TOML, styled, syntax
 from ..args import build_parsed_args
 from ..output import handle_dry_run
 from . import sync as sync_cmd
@@ -21,7 +21,7 @@
 _log = logging.getLogger(__name__)
 
 
-@click.command(help="Remove dependencies from [cyan]jgo.toml[/].")
+@click.command(help=f"Remove dependencies from {JGO_TOML}.")
 @click.argument(
     "coordinates",
     nargs=-1,
@@ -33,7 +33,7 @@
 @click.option(
     "--no-sync",
     is_flag=True,
-    help="Don't automatically [yellow]sync[/] after removing dependencies",
+    help=f"Don't automatically {syntax('sync')} after removing dependencies",
 )
 @click.pass_context
 def remove(ctx, coordinates, no_sync):

src/jgo/cli/commands/run.py

@@ -10,6 +10,16 @@
 
 from ...config import GlobalSettings
 from ...env import EnvironmentSpec
+from ...styles import (
+    AT_MAINCLASS,
+    DOUBLE_DASH,
+    JGO_TOML,
+    MAVEN_COORDINATES,
+    PLUS_OPERATOR,
+    TIP_DRY_RUN,
+    action,
+    secondary,
+)
 from ...util import is_debug_enabled
 from ..args import build_parsed_args, parse_remaining
 from ..context import (
@@ -25,40 +35,40 @@
 
 
 @click.command(
-    help="Run a Java application from [magenta]Maven coordinates[/] or [cyan]jgo.toml[/].",
-    epilog="[dim]TIP: Use [yellow]jgo --dry-run run[/] to see the command without executing it.[/]",
+    help=f"Run a Java application from {MAVEN_COORDINATES} or {JGO_TOML}.",
+    epilog=TIP_DRY_RUN,
     context_settings=dict(ignore_unknown_options=True, allow_interspersed_args=False),
 )
 @click.option(
     "--main-class",
     metavar="CLASS",
-    help="Main class to run (supports [green]auto-completion[/] for simple names)",
+    help=f"Main class to run (supports {action('auto-completion')} for simple names)",
 )
 @click.option(
     "--entrypoint",
     metavar="NAME",
-    help="Run specific entrypoint from [cyan]jgo.toml[/]",
+    help=f"Run specific entrypoint from {JGO_TOML}",
 )
 @click.option(
     "--add-classpath",
     multiple=True,
     metavar="PATH",
-    help="Append to classpath ([dim]JARs, directories, etc.[/])",
+    help=f"Append to classpath ({secondary('JARs, directories, etc.')})",
 )
 @click.argument(
     "endpoint",
     required=False,
     cls=click.RichArgument,
-    help="Maven coordinates (single or combined with [yellow]+[/]) "
-    "optionally followed by [yellow]@MainClass[/]",
+    help=f"Maven coordinates (single or combined with {PLUS_OPERATOR}) "
+    f"optionally followed by {AT_MAINCLASS}",
 )
 @click.argument(
     "remaining",
     nargs=-1,
     type=click.UNPROCESSED,
     cls=click.RichArgument,
-    help="JVM arguments and program arguments, separated by [yellow]--[/]. "
-    "Example: [dim]-- -Xmx2G -- script.py[/]",
+    help=f"JVM arguments and program arguments, separated by {DOUBLE_DASH}. "
+    f"Example: {secondary('-- -Xmx2G -- script.py')}",
 )
 @click.pass_context
 def run(ctx, main_class, entrypoint, add_classpath, endpoint, remaining):