codexspec 0.6.1__tar.gz → 0.6.2__tar.gz

{codexspec-0.6.1 → codexspec-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codexspec
-Version: 0.6.1
+Version: 0.6.2
 Summary: CodexSpec - A Requirements-First SDD toolkit for Claude Code
 Project-URL: Homepage, https://github.com/Zts0hg/codexspec
 Project-URL: Repository, https://github.com/Zts0hg/codexspec

{codexspec-0.6.1 → codexspec-0.6.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codexspec"
-version = "0.6.1"
+version = "0.6.2"
 description = "CodexSpec - A Requirements-First SDD toolkit for Claude Code"
 readme = "README.md"
 requires-python = ">=3.11"

{codexspec-0.6.1 → codexspec-0.6.2}/src/codexspec/__init__.py

@@ -30,12 +30,13 @@ from .commands.installer import (
 from .i18n import (
     generate_config_content,
     get_commit_language,
+    get_interaction_language,
     get_language_name,
-    get_project_language,
     get_supported_languages,
     is_supported_language,
     normalize_locale,
     update_config_language,
+    update_language_field,
     update_output_language,
 )
 from .translator import translate
@@ -185,6 +186,16 @@ def config(
         "-c",
         help="Set the commit message language (defaults to output language)",
     ),
+    set_interaction_lang: Optional[str] = typer.Option(
+        None,
+        "--set-interaction-lang",
+        help="Set the interaction language (LLM dialogue + codexspec CLI terminal output)",
+    ),
+    set_document_lang: Optional[str] = typer.Option(
+        None,
+        "--set-document-lang",
+        help="Set the document language (generated requirements/spec/plan/tasks files)",
+    ),
     list_langs: bool = typer.Option(
         False,
         "--list-langs",
@@ -322,6 +333,45 @@ def config(
         console.print(f"[green]Commit message language set to:[/green] {normalized} ({lang_name})")
         return
 
+    # Handle set interaction language
+    if set_interaction_lang:
+        normalized = normalize_locale(set_interaction_lang)
+        if not is_supported_language(normalized):
+            console.print(
+                f"[yellow]Warning: '{set_interaction_lang}' is not in the list of "
+                "commonly supported languages.[/yellow]"
+            )
+            console.print(
+                "It may still work if Claude supports it. "
+                "Run [cyan]codexspec config --list-langs[/cyan] to see supported languages."
+            )
+        if update_language_field(config_file, "interaction", normalized):
+            lang_name = get_language_name(normalized)
+            console.print(f"[green]Interaction language set to:[/green] {normalized} ({lang_name})")
+        else:
+            console.print("[red]Failed to update interaction language setting[/red]")
+            raise typer.Exit(1)
+        return
+
+    # Handle set document language
+    if set_document_lang:
+        normalized = normalize_locale(set_document_lang)
+        if not is_supported_language(normalized):
+            console.print(
+                f"[yellow]Warning: '{set_document_lang}' is not in the list of commonly supported languages.[/yellow]"
+            )
+            console.print(
+                "It may still work if Claude supports it. "
+                "Run [cyan]codexspec config --list-langs[/cyan] to see supported languages."
+            )
+        if update_language_field(config_file, "document", normalized):
+            lang_name = get_language_name(normalized)
+            console.print(f"[green]Document language set to:[/green] {normalized} ({lang_name})")
+        else:
+            console.print("[red]Failed to update document language setting[/red]")
+            raise typer.Exit(1)
+        return
+
     # Display current configuration
     console.print(
         Panel(
@@ -340,8 +390,8 @@ def list_commands() -> None:
     showing their display names and descriptions.
     """
 
-    # Get user's language preference
-    language = get_project_language()
+    # Get user's language preference (CLI terminal output uses the interaction language)
+    language = get_interaction_language()
 
     metadata = get_installed_commands_metadata()
 

{codexspec-0.6.1 → codexspec-0.6.2}/src/codexspec/i18n.py

@@ -8,6 +8,7 @@ at runtime.
 """
 
 import os
+import re
 from pathlib import Path
 from typing import Optional
 
@@ -194,9 +195,18 @@ version: "1.0"
 
 # Language settings for internationalization (i18n)
 language:
-  # Output language - Claude will use this language for interactions
-  # and generated documents. Supports any Claude-supported language.
+  # Interaction language - language for conversing with the user (LLM dialogue
+  # and codexspec CLI terminal output). Supports any Claude-supported language.
   # Common values: en, zh-CN, zh-TW, ja, ko, es, fr, de, pt, ru
+  interaction: "{language}"
+
+  # Document language - language for generated artifact files
+  # (requirements/spec/plan/tasks). Set this differently from interaction to
+  # keep documents in one language while conversing in another.
+  document: "{language}"
+
+  # Output language (legacy) - fallback used when interaction/document are not
+  # set. Kept for backward compatibility; prefer setting interaction/document.
   output: "{language}"
 
   # Commit message language - language for git commit messages
@@ -235,31 +245,91 @@ def generate_config_content(language: str = "en", created: str = None) -> str:
     return CONFIG_TEMPLATE.format(language=normalized_lang, created=created)
 
 
-def get_project_language() -> str:
-    """Get the project language from .codexspec/config.yml.
+def _read_language_key(content: str, key: str) -> Optional[str]:
+    """Read a `key: value` language setting from config content (YAML-like regex).
 
-    Returns:
-        The configured language code, or "en" if not configured or file doesn't exist.
+    Returns the raw value (quotes stripped) or None if the key is absent.
     """
-    import re
-    from pathlib import Path
+    match = re.search(rf"^\s*{re.escape(key)}:\s*['\"]?(\S+?)['\"]?\s*$", content, re.MULTILINE)
+    return match.group(1) if match else None
+
 
-    config_file = Path.cwd() / ".codexspec" / "config.yml"
+def _resolve_language(config_file: Path, primary_key: str) -> str:
+    """Resolve a language setting: primary_key -> output (legacy) -> 'en'.
+
+    Args:
+        config_file: Path to the project's config.yml.
+        primary_key: The primary language key to try first ('interaction' or 'document').
+
+    Returns:
+        The normalized language code, defaulting to 'en'.
+    """
     if not config_file.exists():
         return "en"
-
     try:
         content = config_file.read_text(encoding="utf-8")
-        # Parse the language setting from YAML-like format
-        match = re.search(r"^\s*output:\s*['\"]?(\S+?)['\"]?\s*$", content, re.MULTILINE)
-        if match:
-            return normalize_locale(match.group(1)) or "en"
+        for key in (primary_key, "output"):
+            value = _read_language_key(content, key)
+            if value:
+                return normalize_locale(value) or "en"
     except (OSError, re.error):
         pass
-
     return "en"
 
 
+def _default_config_path() -> Path:
+    return Path.cwd() / ".codexspec" / "config.yml"
+
+
+def get_interaction_language(config_file: Optional[Path] = None) -> str:
+    """Resolve the interaction language (user<->LLM conversation and CLI terminal).
+
+    Resolution order: explicit `language.interaction` -> `language.output`
+    (legacy) -> 'en'. Existing configs that only set `output` behave exactly as
+    before.
+
+    Args:
+        config_file: Optional explicit path to config.yml; defaults to
+            `.codexspec/config.yml` in the current working directory.
+
+    Returns:
+        The normalized interaction language code.
+    """
+    return _resolve_language(config_file or _default_config_path(), "interaction")
+
+
+def get_document_language(config_file: Optional[Path] = None) -> str:
+    """Resolve the document language (generated artifact files).
+
+    Resolution order: explicit `language.document` -> `language.output`
+    (legacy) -> 'en'. Existing configs that only set `output` behave exactly as
+    before.
+
+    Args:
+        config_file: Optional explicit path to config.yml; defaults to
+            `.codexspec/config.yml` in the current working directory.
+
+    Returns:
+        The normalized document language code.
+    """
+    return _resolve_language(config_file or _default_config_path(), "document")
+
+
+def get_project_language(config_file: Optional[Path] = None) -> str:
+    """Get the project language from .codexspec/config.yml.
+
+    Backward-compatibility alias for the interaction language. Historically this
+    returned the `output` language; it now resolves the interaction language,
+    which falls back to `output` then `en` — so output-only configs are
+    unaffected. Prefer :func:`get_interaction_language` / :func:`get_document_language`
+    for new code.
+
+    Returns:
+        The configured language code, or "en" if not configured or file doesn't exist.
+    """
+    return get_interaction_language(config_file)
+
+
 def get_commit_language(config_file: Path) -> Optional[str]:
     """Get the commit language from a config.yml file.
 
@@ -286,6 +356,44 @@ def get_commit_language(config_file: Path) -> Optional[str]:
     return None
 
 
+def update_language_field(config_file: Path, key: str, language: str) -> bool:
+    """Update a single ``language.<key>`` setting in config.yml.
+
+    Updates the value in place when ``key`` already exists; otherwise inserts
+    ``<indent>{key}: "{language}"`` immediately after the ``language:`` line.
+    The value is normalized via :func:`normalize_locale`.
+
+    Args:
+        config_file: Path to the project's config.yml.
+        key: Language sub-key to set (e.g. "interaction", "document").
+        language: New language code (will be normalized).
+
+    Returns:
+        True if updated or inserted; False if there is no ``language:`` section
+        to insert into or the file cannot be written.
+    """
+    normalized = normalize_locale(language)
+    try:
+        content = config_file.read_text(encoding="utf-8")
+        pattern = rf'^(\s*{re.escape(key)}:\s*)["\']?\S+?["\']?\s*$'
+        new_content, count = re.subn(pattern, rf'\g<1>"{normalized}"', content, flags=re.MULTILINE)
+        if count:
+            config_file.write_text(new_content, encoding="utf-8")
+            return True
+
+        # Key absent: insert under the `language:` section.
+        lang_match = re.search(r"^(\s*)language:\s*$", content, re.MULTILINE)
+        if not lang_match:
+            return False
+        indent = lang_match.group(1) + "  "
+        insert_line = f'{indent}{key}: "{normalized}"'
+        end = lang_match.end()
+        config_file.write_text(content[:end] + "\n" + insert_line + content[end:], encoding="utf-8")
+        return True
+    except (OSError, re.error):
+        return False
+
+
 def update_output_language(config_file: Path, language: str) -> bool:
     """Update only the output language setting in config.yml.
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/analyze.md

@@ -7,7 +7,12 @@ argument-hint: "[feature directory]"
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/checklist.md

@@ -20,12 +20,12 @@ scripts:
 
 ## Language Preference
 
-**IMPORTANT**: Before proceeding, read the project's language configuration from `.codexspec/config.yml`.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
 
-- If `language.output` is set to a language other than "en", respond and generate all content in that language
-- If not configured or set to "en", use English as default
-- Technical terms (e.g., API, JWT, OAuth) may remain in English when appropriate
-- All user-facing messages, questions, and generated documents should use the configured language
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## Checklist Purpose: "Unit Tests for Requirements"
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/clarify.md

@@ -7,7 +7,12 @@ argument-hint: "[spec.md, requirements.md, or feature directory]"
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/config.md

@@ -7,12 +7,14 @@ argument-hint: "[--view] View current configuration without modification"
 
 ## Language Preference
 
-**IMPORTANT**: Before proceeding, read the project's language configuration from `.codexspec/config.yml`.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
 
-- If `language.output` is set to a language other than "en", respond and generate all content in that language
-- If not configured or set to "en", use English as default
-- Technical terms (e.g., API, config.yml) may remain in English when appropriate
-- All user-facing messages, questions, and generated documents should use the configured language
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
+
+A fresh or reset config writes only `output`; `interaction` and `document` resolve to it via the fallback above, so an `output`-only config is fully functional (non-blocking). Set `interaction` or `document` individually only to make them differ from `output`. That is why the YAML examples below stay `output`-only.
 
 ## Parameter Check
 
@@ -98,7 +100,9 @@ Display the configuration as in Step 2, then exit.
     "question": "Which setting would you like to modify?",
     "header": "Modify",
     "options": [
-      {"label": "Output language", "description": "Language for generated content (currently: {current value})"},
+      {"label": "Interaction language", "description": "Language for conversing with you (LLM dialogue + codexspec CLI terminal output) (currently: {current value})"},
+      {"label": "Document language", "description": "Language for generated artifact files (requirements/spec/plan/tasks) (currently: {current value})"},
+      {"label": "Output language (legacy)", "description": "Fallback language used when interaction/document are not set (currently: {current value})"},
       {"label": "Commit language", "description": "Language for commit messages (currently: {current value})"},
       {"label": "Back", "description": "Return to main menu"}
     ]
@@ -182,7 +186,7 @@ Let's configure your language preferences.
 ```json
 {
   "questions": [{
-    "question": "Select your preferred output language (for generated content, documentation, etc.):",
+    "question": "Select your project's base language (sets `output`; interaction and document inherit it unless set individually):",
     "header": "Output Lang",
     "options": [
       {"label": "English (en)", "description": "Default, recommended for international projects"},
@@ -280,6 +284,6 @@ project:
 
 ## Output Format
 
-All messages should follow the project's language configuration. If not configured, use English as default.
+Converse in the interaction language and author generated artifacts in the document language. If either is unset, it falls back to `output`, then English.
 
 Technical terms and file paths should remain in English for clarity.

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/constitution.md

@@ -23,11 +23,12 @@ handoffs:
 
 ## Language Preference
 
-**IMPORTANT**: Before proceeding, read the project's language configuration from `.codexspec/config.yml`.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
 
-- If `language.output` is set to a language other than "en", respond and generate all content in that language
-- If not configured or set to "en", use English as default
-- Technical terms (e.g., API, JWT, OAuth) may remain in English when appropriate
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/generate-spec.md

@@ -10,7 +10,12 @@ handoffs:
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output` for all interaction and generated content; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/implement-tasks.md

@@ -10,12 +10,12 @@ handoffs:
 
 ## Language Preference
 
-**IMPORTANT**: Before proceeding, read the project's language configuration from `.codexspec/config.yml`.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
 
-- If `language.output` is set to a language other than "en", respond and generate all content in that language
-- If not configured or set to "en", use English as default
-- Technical terms (e.g., API, JWT, OAuth) may remain in English when appropriate
-- All user-facing messages, questions, and generated documents should use the configured language
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## Feature Resolution
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/plan-to-tasks.md

@@ -10,7 +10,12 @@ handoffs:
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/quick.md

@@ -7,7 +7,12 @@ argument-hint: "Describe a small requirement"
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/review-code.md

@@ -14,12 +14,12 @@ allowed-tools: Read, Grep, Glob, Bash(ruff check:*), Bash(mypy:*), Bash(python -
 
 ## Language Preference
 
-**IMPORTANT**: Before proceeding, read the project's language configuration from `.codexspec/config.yml`.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
 
-- If `language.output` is set to a language other than "en", respond and generate all content in that language
-- If not configured or set to "en", use English as default
-- Technical terms (e.g., API, Type Hints, PEP 8, Hooks, RAII) may remain in English when appropriate
-- All user-facing messages, questions, and generated documents should use the configured language
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/review-plan.md

@@ -10,7 +10,12 @@ handoffs:
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/review-spec.md

@@ -10,7 +10,12 @@ handoffs:
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/review-tasks.md

@@ -10,7 +10,12 @@ handoffs:
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/spec-to-plan.md

@@ -10,7 +10,12 @@ handoffs:
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/specify.md

@@ -10,7 +10,12 @@ scripts:
 
 ## Language Preference
 
-Read `.codexspec/config.yml`. Use `language.output`; default to English.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
+
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input
 

{codexspec-0.6.1 → codexspec-0.6.2}/templates/commands/tasks-to-issues.md

@@ -20,12 +20,12 @@ scripts:
 
 ## Language Preference
 
-**IMPORTANT**: Before proceeding, read the project's language configuration from `.codexspec/config.yml`.
+Read `.codexspec/config.yml`. Two independent language controls apply (each falls back to `language.output`, then English):
 
-- If `language.output` is set to a language other than "en", respond and generate all content in that language
-- If not configured or set to "en", use English as default
-- Technical terms (e.g., API, JWT, OAuth) may remain in English when appropriate
-- All user-facing messages, questions, and generated documents should use the configured language
+- **Interaction language** (`language.interaction`): language for all conversation with the user — questions, explanations, status messages, and `codexspec` CLI terminal output.
+- **Document language** (`language.document`): language for generated artifact files (requirements/spec/plan/tasks).
+
+Converse in the interaction language and author artifacts in the document language. Apply the project's translation standard to both: translate by meaning (not word-for-word), keep English for terms with no good native equivalent, and write as if originally in that language.
 
 ## User Input