codexspec 0.4.7__tar.gz → 0.4.8__tar.gz

{codexspec-0.4.7 → codexspec-0.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codexspec
-Version: 0.4.7
+Version: 0.4.8
 Summary: CodexSpec - A Spec-Driven Development (SDD) toolkit for Claude Code
 Project-URL: Homepage, https://github.com/Zts0hg/codexspec
 Project-URL: Repository, https://github.com/Zts0hg/codexspec
@@ -599,6 +599,30 @@ CodexSpec supports multiple languages through **LLM dynamic translation**. Inste
 ### Setting Language
 
 **During initialization:**
+
+When you run `codexspec init` without the `--lang` parameter in an interactive terminal, you'll see a language selection prompt:
+
+```bash
+# Interactive language selection (TTY only)
+codexspec init my-project
+
+# Output:
+# Select output language:
+#   [1] English (en)
+#   [2] Chinese (Simplified) (zh-CN)
+#   [3] Japanese (ja)
+#   [4] Korean (ko)
+#   [5] Spanish (es)
+#   [6] French (fr)
+#   [7] German (de)
+#   [8] Portuguese (Brasil) (pt-BR)
+#   [9] Other... (enter custom code)
+#
+# Enter choice [1]:
+```
+
+You can also specify the language directly:
+
 ```bash
 # Create a project with Chinese output
 codexspec init my-project --lang zh-CN
@@ -607,6 +631,8 @@ codexspec init my-project --lang zh-CN
 codexspec init my-project --lang ja
 ```
 
+> **Note:** In non-interactive environments (CI/CD, scripts), the default language is English. Use `--lang` to specify a different language.
+
 **After initialization:**
 ```bash
 # View current configuration

{codexspec-0.4.7 → codexspec-0.4.8}/README.md

@@ -553,6 +553,30 @@ CodexSpec supports multiple languages through **LLM dynamic translation**. Inste
 ### Setting Language
 
 **During initialization:**
+
+When you run `codexspec init` without the `--lang` parameter in an interactive terminal, you'll see a language selection prompt:
+
+```bash
+# Interactive language selection (TTY only)
+codexspec init my-project
+
+# Output:
+# Select output language:
+#   [1] English (en)
+#   [2] Chinese (Simplified) (zh-CN)
+#   [3] Japanese (ja)
+#   [4] Korean (ko)
+#   [5] Spanish (es)
+#   [6] French (fr)
+#   [7] German (de)
+#   [8] Portuguese (Brasil) (pt-BR)
+#   [9] Other... (enter custom code)
+#
+# Enter choice [1]:
+```
+
+You can also specify the language directly:
+
 ```bash
 # Create a project with Chinese output
 codexspec init my-project --lang zh-CN
@@ -561,6 +585,8 @@ codexspec init my-project --lang zh-CN
 codexspec init my-project --lang ja
 ```
 
+> **Note:** In non-interactive environments (CI/CD, scripts), the default language is English. Use `--lang` to specify a different language.
+
 **After initialization:**
 ```bash
 # View current configuration

{codexspec-0.4.7 → codexspec-0.4.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codexspec"
-version = "0.4.7"
+version = "0.4.8"
 description = "CodexSpec - A Spec-Driven Development (SDD) toolkit for Claude Code"
 readme = "README.md"
 requires-python = ">=3.11"

{codexspec-0.4.7 → codexspec-0.4.8}/scripts/python/notify_telegram.py

@@ -559,7 +559,6 @@ class TelegramNotifier:
             return None
 
         status = data.get("status")
-        session_id = data.get("session_id", "unknown")[:8]
 
         if status == "TASK_COMPLETE" and self.config.NOTIFY_ON_COMPLETE:
             return self.format_task_complete(data)

{codexspec-0.4.7 → codexspec-0.4.8}/src/codexspec/__init__.py

@@ -15,7 +15,7 @@ from typing import Optional
 import typer
 from rich.console import Console
 from rich.panel import Panel
-from rich.prompt import Confirm
+from rich.prompt import Confirm, Prompt
 from rich.table import Table
 
 from .commands.installer import (
@@ -387,11 +387,11 @@ def init(
         "-a",
         help="AI assistant to use (default: claude)",
     ),
-    lang: str = typer.Option(
-        "en",
+    lang: Optional[str] = typer.Option(
+        None,
         "--lang",
         "-l",
-        help="Output language for Claude interactions and generated documents (e.g., en, zh-CN, ja)",
+        help="Output language (e.g., en, zh-CN, ja). Interactive prompt if not specified in TTY.",
     ),
     force: bool = typer.Option(
         False,
@@ -425,6 +425,20 @@ def init(
         codexspec init --here --ai claude
         codexspec init . --force --ai claude
     """
+    # Handle interactive language selection when --lang not specified
+    if lang is None:
+        if sys.stdin.isatty():
+            # TTY environment: show interactive prompt
+            try:
+                lang = prompt_language_selection()
+            except KeyboardInterrupt:
+                console.print()
+                console.print("[yellow]Selection cancelled, using default language (en)[/yellow]")
+                lang = "en"
+        else:
+            # Non-TTY environment: use default
+            lang = "en"
+
     # Normalize language code early for use throughout the function
     normalized_lang = normalize_locale(lang)
 
@@ -1484,6 +1498,83 @@ def prepend_compliance_section(claude_md_path: Path) -> None:
     claude_md_path.write_text(import_statement + existing_content, encoding="utf-8")
 
 
+def prompt_language_selection(default: str = "en") -> str:
+    """Display interactive language selection prompt.
+
+    Shows a numbered list of supported languages and prompts the user to select one.
+    If the user selects "Other...", they can enter a custom language code.
+
+    Args:
+        default: Default language code to use if user cancels or enters empty input
+
+    Returns:
+        The selected language code (normalized)
+
+    Raises:
+        KeyboardInterrupt: If user presses Ctrl+C
+    """
+    from .i18n import get_all_supported_languages, normalize_locale
+
+    # Get all supported languages
+    all_languages = get_all_supported_languages()
+
+    # Build the prompt message
+    console.print()
+    console.print("[bold cyan]Select output language:[/bold cyan]")
+    console.print()
+
+    # Create choices mapping
+    choices = {}
+    for i, (code, name) in enumerate(all_languages, start=1):
+        console.print(f"  [cyan][{i}][/cyan] {name} [dim]({code})[/dim]")
+        choices[str(i)] = code
+
+    # Add "Other..." option
+    other_index = str(len(all_languages) + 1)
+    console.print(f"  [cyan][{other_index}][/cyan] [italic]Other...[/italic] [dim](enter custom code)[/dim]")
+    console.print()
+    choices[other_index] = None  # Marker for custom input
+
+    # Prompt for selection
+    valid_choices = list(choices.keys())
+    selection = Prompt.ask(
+        "Enter choice",
+        default="1",
+        show_choices=False,
+    )
+
+    # Validate input - Prompt.ask doesn't validate when show_choices=False
+    while selection not in valid_choices:
+        console.print(f"[yellow]Invalid choice. Please enter 1-{other_index}.[/yellow]")
+        selection = Prompt.ask(
+            "Enter choice",
+            default="1",
+            show_choices=False,
+        )
+
+    # Handle selection
+    if choices[selection] is None:
+        # "Other..." selected - prompt for custom code
+        custom_code = Prompt.ask(
+            "Enter language code (e.g., ru, ar, hi)",
+            default="",
+            show_default=False,
+        )
+
+        # Edge Case 3: Empty string input -> fallback to default
+        if not custom_code.strip():
+            console.print("[dim]No language code entered, using default (en)[/dim]")
+            return default
+
+        # Normalize the custom code
+        normalized = normalize_locale(custom_code)
+        console.print(f"[dim]Note: Pre-translated content may not be available for '{normalized}'.[/dim]")
+        return normalized
+
+    # Return the selected predefined language
+    return choices[selection]
+
+
 def confirm_add_compliance(language: str = "en") -> bool:
     """Ask user whether to add the Constitution Compliance section.
 

{codexspec-0.4.7 → codexspec-0.4.8}/src/codexspec/i18n.py

@@ -164,6 +164,28 @@ def get_supported_languages() -> list[tuple[str, str]]:
     return [(code, get_language_name(code)) for code in LANGUAGE_ALIASES.keys()]
 
 
+# Lazy-loaded list of all supported languages (en + pre-translated)
+_ALL_LANGUAGES_CACHE: list[str] | None = None
+
+
+def get_all_supported_languages() -> list[tuple[str, str]]:
+    """
+    获取所有支持的语言列表（包括 en 和预翻译语言）。
+
+    Returns:
+        List of (code, name) tuples，en 排在首位，随后是预翻译语言
+    """
+    global _ALL_LANGUAGES_CACHE
+
+    if _ALL_LANGUAGES_CACHE is None:
+        # Lazy import to avoid circular dependency with translator.py
+        from codexspec.translator import SUPPORTED_LANGUAGES
+
+        _ALL_LANGUAGES_CACHE = ["en"] + list(SUPPORTED_LANGUAGES)
+
+    return [(code, get_language_name(code)) for code in _ALL_LANGUAGES_CACHE]
+
+
 # Default config.yml template
 CONFIG_TEMPLATE = """# CodexSpec Configuration
 # This file configures project-level settings for CodexSpec