zrb 1.17.4__py3-none-any.whl → 1.18.1__py3-none-any.whl

zrb/builtin/llm/chat_session.py

@@ -32,7 +32,7 @@ async def read_user_prompt(ctx: AnyContext) -> str:
     reader: PromptSession[Any] | StreamReader = await _setup_input_reader(is_tty)
     multiline_mode = False
     is_first_time = True
-    current_modes: str = ctx.input.modes
+    current_workflows: str = ctx.input.workflows
     current_yolo_mode: bool | str = ctx.input.yolo
     user_inputs: list[str] = []
     final_result: str = ""
@@ -59,7 +59,7 @@ async def read_user_prompt(ctx: AnyContext) -> str:
             result = await _trigger_ask_and_wait_for_result(
                 ctx=ctx,
                 user_prompt=user_prompt,
-                modes=current_modes,
+                workflows=current_workflows,
                 yolo_mode=current_yolo_mode,
                 previous_session_name=previous_session_name,
                 start_new=start_new,
@@ -77,7 +77,7 @@ async def read_user_prompt(ctx: AnyContext) -> str:
             result = await _trigger_ask_and_wait_for_result(
                 ctx=ctx,
                 user_prompt=user_prompt,
-                modes=current_modes,
+                workflows=current_workflows,
                 yolo_mode=current_yolo_mode,
                 previous_session_name=previous_session_name,
                 start_new=start_new,
@@ -86,18 +86,18 @@ async def read_user_prompt(ctx: AnyContext) -> str:
                 final_result = result
                 if ctx.is_web_mode or not is_tty:
                     return final_result
-        elif user_input.strip().lower().startswith("/mode"):
-            mode_parts = user_input.split(" ", maxsplit=2)
-            if len(mode_parts) > 1:
-                current_modes = mode_parts[1]
-            ctx.print(f"Current mode: {current_modes}", plain=True)
+        elif user_input.strip().lower().startswith("/workflow"):
+            workflow_parts = user_input.split(" ", maxsplit=2)
+            if len(workflow_parts) > 1:
+                current_workflows = workflow_parts[1]
+            ctx.print(f"Current workflows: {current_workflows}", plain=True)
             ctx.print("", plain=True)
             continue
         elif user_input.strip().lower().startswith("/yolo"):
             yolo_mode_parts = user_input.split(" ", maxsplit=2)
             if len(yolo_mode_parts) > 1:
                 current_yolo_mode = to_boolean(yolo_mode_parts[1])
-            ctx.print(f"Current_yolo mode: {current_yolo_mode}", plain=True)
+            ctx.print(f"Current YOLO mode: {current_yolo_mode}", plain=True)
             ctx.print("", plain=True)
             continue
         elif user_input.strip().lower() in ("/help", "/info"):
@@ -112,7 +112,7 @@ async def read_user_prompt(ctx: AnyContext) -> str:
             result = await _trigger_ask_and_wait_for_result(
                 ctx=ctx,
                 user_prompt=user_prompt,
-                modes=current_modes,
+                workflows=current_workflows,
                 yolo_mode=current_yolo_mode,
                 previous_session_name=previous_session_name,
                 start_new=start_new,
@@ -136,8 +136,8 @@ def _show_info(ctx: AnyContext):
                 _show_command("/bye", "Quit from chat session"),
                 _show_command("/multi", "Start multiline input"),
                 _show_command("/end", "End multiline input"),
-                _show_command("/modes", "Show current modes"),
-                _show_subcommand("<mode1,mode2,..>", "Set current modes"),
+                _show_command("/workflows", "Show current workflows"),
+                _show_subcommand("<wf1,wf2,..>", "Set current workflows"),
                 _show_command("/yolo", "Get current YOLO mode"),
                 _show_subcommand("<true|false|list-of-tools>", "Set YOLO mode"),
                 _show_command("/help", "Show this message"),
@@ -179,7 +179,7 @@ async def _setup_input_reader(
 async def _trigger_ask_and_wait_for_result(
     ctx: AnyContext,
     user_prompt: str,
-    modes: str,
+    workflows: str,
     yolo_mode: bool | str,
     previous_session_name: str | None = None,
     start_new: bool = False,
@@ -199,7 +199,7 @@ async def _trigger_ask_and_wait_for_result(
     if user_prompt.strip() == "":
         return None
     await _trigger_ask(
-        ctx, user_prompt, modes, yolo_mode, previous_session_name, start_new
+        ctx, user_prompt, workflows, yolo_mode, previous_session_name, start_new
     )
     result = await _wait_ask_result(ctx)
     md_result = render_markdown(result) if result is not None else ""
@@ -231,7 +231,7 @@ def get_llm_ask_input_mapping(callback_ctx: AnyContext):
         "start-new": data.get("start_new"),
         "previous-session": data.get("previous_session_name"),
         "message": data.get("message"),
-        "modes": data.get("modes"),
+        "workflows": data.get("workflows"),
         "yolo": data.get("yolo"),
     }
 
@@ -239,7 +239,7 @@ def get_llm_ask_input_mapping(callback_ctx: AnyContext):
 async def _trigger_ask(
     ctx: AnyContext,
     user_prompt: str,
-    modes: str,
+    workflows: str,
     yolo_mode: bool | str,
     previous_session_name: str | None = None,
     start_new: bool = False,
@@ -260,7 +260,7 @@ async def _trigger_ask(
             "previous_session_name": previous_session_name,
             "start_new": start_new,
             "message": user_prompt,
-            "modes": modes,
+            "workflows": workflows,
             "yolo": yolo_mode,
         }
     )

zrb/builtin/llm/llm_ask.py

@@ -152,10 +152,10 @@ def _get_inputs(require_message: bool = True) -> list[AnyInput | None]:
             always_prompt=False,
         ),
         TextInput(
-            "modes",
-            description="Modes",
-            prompt="Modes",
-            default=lambda ctx: ",".join(llm_config.default_modes),
+            "workflows",
+            description="Workflows",
+            prompt="Workflows",
+            default=lambda ctx: ",".join(llm_config.default_workflows),
             allow_positional_parsing=False,
             always_prompt=False,
         ),
@@ -210,8 +210,10 @@ llm_ask: LLMTask = llm_group.add_task(
         system_prompt=lambda ctx: (
             None if ctx.input.system_prompt.strip() == "" else ctx.input.system_prompt
         ),
-        modes=lambda ctx: (
-            None if ctx.input.modes.strip() == "" else ctx.input.modes.split(",")
+        workflows=lambda ctx: (
+            None
+            if ctx.input.workflows.strip() == ""
+            else ctx.input.workflows.split(",")
         ),
         message="{ctx.input.message}",
         tools=_get_tool,

zrb/config/config.py

@@ -275,12 +275,26 @@ class Config:
         return None if value == "" else value
 
     @property
-    def LLM_MODES(self) -> list[str]:
-        return [
-            mode.strip()
-            for mode in self._getenv("LLM_MODES", "coding").split(",")
-            if mode.strip() != ""
-        ]
+    def LLM_WORKFLOWS(self) -> list[str]:
+        """Get a list of LLM workflows from environment variables."""
+        workflows = []
+        for workflow in self._getenv("LLM_WORKFLOWS", "coding").split(","):
+            workflow = workflow.strip()
+            if workflow != "":
+                workflows.append(workflow)
+        return workflows
+
+    @property
+    def LLM_BUILTIN_WORKFLOW_PATHS(self) -> list[str]:
+        """Get a list of additional builtin workflow paths from environment variables."""
+        builtin_workflow_paths_str = self._getenv("LLM_BUILTIN_WORKFLOW_PATHS", "")
+        if builtin_workflow_paths_str != "":
+            return [
+                path.strip()
+                for path in builtin_workflow_paths_str.split(":")
+                if path.strip() != ""
+            ]
+        return []
 
     @property
     def LLM_SPECIAL_INSTRUCTION_PROMPT(self) -> str | None:
@@ -479,8 +493,8 @@ class Config:
         return int(self._getenv("SEARXNG_SAFE", "0"))
 
     @property
-    def SEARXNG_LANG(self) -> int:
-        return int(self._getenv("SEARXNG_LANG", "en"))
+    def SEARXNG_LANG(self) -> str:
+        return self._getenv("SEARXNG_LANG", "en")
 
     @property
     def BANNER(self) -> str:

zrb/config/default_prompt/interactive_system_prompt.md

@@ -20,7 +20,7 @@ You are an expert interactive AI agent. You MUST follow this workflow for this i
 
 3. **Execute and Verify (The E+V Loop):**
     * Execute the action.
-    * **CRITICAL:** After each step, you MUST use a tool to verify the outcome (e.g., check command exit codes, read back file contents, list files).
+    * **CRITICAL:** After each step, you MUST use a tool to verify the outcome (e.g., check command exit codes, verify changes has been applied, or new files has been created).
 
 4. **Handle Errors (The Debugging Loop):**
     * If an action fails, you MUST NOT give up. You MUST enter a persistent debugging loop until the error is resolved.

zrb/config/default_prompt/system_prompt.md

@@ -16,7 +16,7 @@ You are an expert AI agent fulfilling a single request. You must provide a compl
 
 3. **Execute and Verify (The E+V Loop):**
     * Execute each step of your plan.
-    * **CRITICAL:** After each step, you MUST use a tool to verify the outcome (e.g., check command exit codes, read back file contents, list files).
+    * **CRITICAL:** After each step, you MUST use a tool to verify the outcome (e.g., check command exit codes, verify changes has been applied, or new files has been created).
 
 4. **Handle Errors (The Debugging Loop):**
     * If an action fails, you MUST NOT give up. You MUST enter a persistent debugging loop until the error is resolved.

zrb/config/llm_config.py

@@ -25,7 +25,7 @@ class LLMConfig:
         default_summarization_prompt: str | None = None,
         default_summarize_history: bool | None = None,
         default_history_summarization_token_threshold: int | None = None,
-        default_modes: list[str] | None = None,
+        default_workflows: list[str] | None = None,
         default_model: "Model | None" = None,
         default_model_settings: "ModelSettings | None" = None,
         default_model_provider: "Provider | None" = None,
@@ -53,7 +53,7 @@ class LLMConfig:
         self._default_history_summarization_token_threshold = (
             default_history_summarization_token_threshold
         )
-        self._default_modes = default_modes
+        self._default_workflows = default_workflows
         self._default_model = default_model
         self._default_model_settings = default_model_settings
         self._default_model_provider = default_model_provider
@@ -191,9 +191,9 @@ class LLMConfig:
         )
 
     @property
-    def default_modes(self) -> list[str]:
+    def default_workflows(self) -> list[str]:
         return self._get_property(
-            self._default_modes, CFG.LLM_MODES, lambda: ["coding"]
+            self._default_workflows, CFG.LLM_WORKFLOWS, lambda: ["coding"]
         )
 
     @property
@@ -279,18 +279,18 @@ class LLMConfig:
     def set_default_special_instruction_prompt(self, special_instruction_prompt: str):
         self._default_special_instruction_prompt = special_instruction_prompt
 
-    def set_default_modes(self, modes: list[str]):
-        self._default_modes = modes
+    def set_default_workflows(self, workflows: list[str]):
+        self._default_workflows = workflows
 
-    def add_default_mode(self, mode: str):
-        if self._default_modes is None:
-            self._default_modes = []
-        self._default_modes.append(mode)
+    def add_default_workflow(self, workflow: str):
+        if self._default_workflows is None:
+            self._default_workflows = []
+        self._default_workflows.append(workflow)
 
-    def remove_default_mode(self, mode: str):
-        if self._default_modes is None:
-            self._default_modes = []
-        self._default_modes.remove(mode)
+    def remove_default_workflow(self, workflow: str):
+        if self._default_workflows is None:
+            self._default_workflows = []
+        self._default_workflows.remove(workflow)
 
     def set_default_summarization_prompt(self, summarization_prompt: str):
         self._default_summarization_prompt = summarization_prompt

zrb/config/llm_context/config.py

@@ -5,6 +5,25 @@ from zrb.config.llm_context.config_parser import markdown_to_dict
 from zrb.util.llm.prompt import demote_markdown_headers
 
 
+class LLMWorkflow:
+    def __init__(self, name: str, path: str, content: str):
+        self._name = name
+        self._path = path
+        self._content = content
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    @property
+    def path(self) -> str:
+        return self._path
+
+    @property
+    def content(self) -> str:
+        return self._content
+
+
 class LLMContextConfig:
     """High-level API for interacting with cascaded configurations."""
 
@@ -75,20 +94,24 @@ class LLMContextConfig:
                     notes[abs_context_path] = value
         return notes
 
-    def get_workflows(self, cwd: str | None = None) -> dict[str, str]:
+    def get_workflows(self, cwd: str | None = None) -> dict[str, LLMWorkflow]:
         """Gathers all relevant workflows for a given path."""
         if cwd is None:
             cwd = os.getcwd()
         all_sections = self._get_all_sections(cwd)
-        workflows: dict[str, str] = {}
+        workflows: dict[str, LLMWorkflow] = {}
         # Iterate from closest to farthest
-        for _, sections in all_sections:
+        for config_dir, sections in all_sections:
             for key, value in sections.items():
                 if key.lower().startswith("workflow:"):
                     workflow_name = key[len("workflow:") :].strip().lower()
                     # First one found wins
                     if workflow_name not in workflows:
-                        workflows[workflow_name] = value
+                        workflows[workflow_name] = LLMWorkflow(
+                            name=workflow_name,
+                            content=value,
+                            path=config_dir,
+                        )
         return workflows
 
     def get_contexts(self, cwd: str | None = None) -> dict[str, str]:

zrb/task/llm/agent.py

@@ -106,7 +106,7 @@ def create_agent_instance(
     return Agent[None, Any](
         model=model,
         output_type=output_type,
-        system_prompt=system_prompt,
+        instructions=system_prompt,
         tools=tool_list,
         toolsets=wrapped_toolsets,
         model_settings=model_settings,

zrb/task/llm/default_workflow/coding/cpp.md

@@ -0,0 +1,33 @@
+# C++ Development Guide
+
+This guide provides the baseline for C++ development. It is superseded by project-specific conventions.
+
+## 1. Project Analysis Checklist
+
+Before coding, inspect the project for these files to determine its conventions:
+
+- **Build System:** `CMakeLists.txt` (CMake), `Makefile` (Make), or a Visual Studio solution file (`*.sln`).
+- **C++ Standard:** Look for flags like `-std=c++11`, `-std=c++14`, `-std=c++17`, or `-std=c++20` in the build files.
+- **Style & Linting Config:** `.clang-format`, `.clang-tidy`. These define the coding standard.
+- **Testing Framework:** Look for a `tests/` directory and check the build files for dependencies like `gtest` or `catch2`.
+
+## 2. Core Principles
+
+- **Style:** Strictly adhere to the project's configured formatter (e.g., clang-format) and linter (e.g., clang-tidy). If none exist, default to the Google C++ Style Guide.
+- **Modern C++:** Use modern C++ features, such as smart pointers, range-based for loops, and auto.
+- **RAII (Resource Acquisition Is Initialization):** Use RAII to manage resources like memory, files, and network connections.
+
+## 3. Implementation Patterns
+
+- **Error Handling:** Replicate existing patterns for error handling. Use exceptions for errors that cannot be handled locally.
+- **Testing:** Use the project's existing test structure. Write unit tests for all new code.
+
+## 4. Common Commands
+
+- **CMake:**
+  - **Configure:** `cmake -B build`
+  - **Build:** `cmake --build build`
+  - **Test:** `cd build && ctest`
+- **Make:**
+  - **Build:** `make`
+  - **Test:** `make test`

zrb/task/llm/default_workflow/coding/csharp.md

@@ -0,0 +1,35 @@
+# C# Development Guide
+
+This guide provides the baseline for C# development. It is superseded by project-specific conventions.
+
+## 1. Project Analysis Checklist
+
+Before coding, inspect the project for these files to determine its conventions:
+
+- **Project File:** `*.csproj`. This defines the project structure, dependencies, and build settings.
+- **Solution File:** `*.sln`. This defines the solution that contains one or more projects.
+- **.NET Version:** Look for a `global.json` file, or check the `*.csproj` file.
+- **Style & Linting Config:** `.editorconfig`, `.stylecop.json`. These define the coding standard.
+- **Testing Framework:** Look for a `*Tests` directory and check the project file for dependencies like `xunit`, `nunit`, or `mstest`.
+
+## 2. Core Principles
+
+- **Style:** Strictly adhere to the project's configured linter (e.g., StyleCop). If none exists, default to the .NET coding conventions.
+- **Idiomatic C#:** Embrace C#'s core features:
+  - Use properties instead of public fields.
+  - Use LINQ for data manipulation.
+  - Use `async/await` for asynchronous programming.
+- **Object-Oriented Design:** Follow SOLID principles and use design patterns where appropriate.
+
+## 3. Implementation Patterns
+
+- **Error Handling:** Replicate existing patterns for exceptions. Use `try-catch-finally` blocks for exception handling.
+- **Testing:** Use the project's existing test structure. Write unit tests for all new code.
+
+## 4. Common Commands
+
+- **Build:** `dotnet build`
+- **Run:** `dotnet run`
+- **Test:** `dotnet test`
+- **Clean:** `dotnet clean`
+- **Publish:** `dotnet publish`

zrb/task/llm/default_workflow/coding/git.md

@@ -0,0 +1,58 @@
+# Git Workflow Guide
+
+This guide governs all version control operations. Adhere to it for safety and consistency.
+
+## 1. Core Principles & Safety
+
+- **Atomic Commits:** One logical change per commit. Use `git add -p` for precision.
+- **Descriptive Messages:** Explain the "why" in the imperative mood (e.g., "Add feature"). Follow the 50/72 format.
+- **Safety First:**
+  - Always run `git status` before operations.
+  - Use `git push --force-with-lease`, not `--force`.
+  - Ensure the working directory is clean before `git rebase`.
+
+## 2. Standard Workflow
+
+This is the primary development cycle.
+
+1. **Branch:** `git checkout -b <branch-name>`
+2. **Code & Verify:** Make changes, then run all tests, linters, and builds.
+3. **Stage:** `git add <file>` or, for more precision, `git add -p`.
+4. **Commit:** `git commit` with a descriptive message.
+    ```
+    feat: Add user authentication endpoint
+
+    Implement the /login endpoint using JWT for token-based auth.
+    This resolves issue #123 by providing a mechanism for users to
+    log in and receive an access token.
+    ```
+5. **Review/Amend:** Use `git log -1` to review. If needed, fix with `git commit --amend`.
+6. **Push:** `git push origin <branch-name>`
+
+## 3. Command Reference
+
+### Status & History
+- `git status`: Check working directory status.
+- `git diff`: See uncommitted changes to tracked files.
+- `git diff --staged`: See staged changes.
+- `git log --oneline --graph -10`: View recent commit history.
+- `git blame <file>`: See who changed what in a file.
+
+### Branching & Merging
+- `git checkout -b <name>`: Create and switch to a new branch.
+- `git switch <name>`: Switch to an existing branch.
+- `git rebase main`: Update the current branch from `main`. **(Use with care)**.
+- `git merge --no-ff <branch>`: Merge a branch without fast-forwarding.
+
+### Stashing
+- `git stash push -m "msg"`: Save uncommitted changes temporarily.
+- `git stash list`: List all stashes.
+- `git stash pop`: Apply and remove the last stash.
+
+### Remote Operations
+- `git fetch origin`: Fetch updates from the remote repository.
+- `git push origin <branch>`: Push a branch to the remote.
+- `git push origin --delete <branch>`: Delete a remote branch.
+
+### Advanced
+- `git cherry-pick <commit-hash>`: Apply a specific commit from another branch. **(Use with caution to avoid duplicate commits)**.

zrb/task/llm/default_workflow/coding/golang.md

@@ -0,0 +1,43 @@
+# Go Development Guide
+
+This guide provides the baseline for Go development. It is superseded by project-specific conventions.
+
+## 1. Project Analysis Checklist
+
+Before coding, inspect the project for these files to determine its conventions:
+
+- **Module Information:** `go.mod` to identify the module path and dependencies. `go.sum` for dependency checksums.
+- **Workspace:** `go.work` to see if the project is part of a multi-module workspace.
+- **Tooling:** A `Makefile` is common for defining build, test, and lint commands.
+- **CI/CD Configuration:** Files like `.github/workflows/go.yml` can reveal the exact commands used for verification.
+- **Linting Config:** `.golangci.yml` defines the linting rules for `golangci-lint`.
+- **Package Structure:** Analyze the `pkg/` and `internal/` directories to understand the project's layout.
+
+## 2. Core Principles
+
+- **Formatting:** `go fmt` is mandatory. All code must be formatted before committing.
+- **Linting:** Adhere to the project's `golangci-lint` configuration. If none exists, use a sensible default.
+- **Package Naming:** Use short, concise, all-lowercase package names.
+- **Simplicity:** Write clear, simple, and readable code. Avoid unnecessary complexity or "clever" tricks.
+
+## 3. Project Structure
+
+- **`cmd/`:** Main applications for the project. Each subdirectory is a separate command.
+- **`pkg/`:** Library code that's okay to be used by external applications.
+- **`internal/`:** Private application and library code. It's not importable by other projects.
+
+## 4. Implementation Patterns
+
+- **Error Handling:** Match the existing error handling strategy. Check if the project uses a library like `pkg/errors` for wrapping or if it relies on the standard library's `fmt.Errorf` with `%w`.
+- **Testing:** Replicate the existing test structure. Use table-driven tests if they are prevalent in the codebase. Place tests in `_test.go` files within the same package.
+- **Concurrency:** Follow existing concurrency patterns. Pay close attention to how goroutines, channels, and mutexes are used.
+- **Debugging:** Use the `delve` debugger for debugging Go applications.
+
+## 5. Common Commands
+
+- **Tidy Dependencies:** `go mod tidy`
+- **Formatting:** `go fmt ./...`
+- **Linting:** `golangci-lint run`
+- **Testing:** `go test ./...`
+- **Building:** `go build ./...`
+- **Run:** `go run ./cmd/my-app`

zrb/task/llm/default_workflow/coding/html-css.md

@@ -0,0 +1,34 @@
+# HTML/CSS Development Guide
+
+This guide provides the baseline for HTML and CSS development. It is superseded by project-specific conventions.
+
+## 1. Project Analysis Checklist
+
+Before coding, inspect the project for these files to determine its conventions:
+
+- **HTML Files:** `*.html`. Look for the overall structure, doctype, and meta tags.
+- **CSS Files:** `*.css`. Look for the CSS architecture (e.g., BEM, SMACSS), preprocessors (e.g., Sass, Less), and frameworks (e.g., Bootstrap, Tailwind CSS).
+- **Style & Linting Config:** `.stylelintrc`, `.prettierrc`. These define the coding standard.
+
+## 2. Core Principles
+
+- **HTML:**
+  - **Semantic HTML:** Use HTML elements for their intended purpose. For example, use `<nav>` for navigation, `<main>` for the main content, and `<article>` for articles.
+  - **Accessibility:** Follow accessibility best practices, such as using `alt` attributes for images and `aria-*` attributes for dynamic content.
+- **CSS:**
+  - **Separation of Concerns:** Keep your CSS separate from your HTML. Use external stylesheets instead of inline styles.
+  - **Responsive Design:** Use media queries to create a responsive design that works on all screen sizes.
+  - **CSS Methodologies:** If the project uses a CSS methodology like BEM or SMACSS, follow it.
+
+## 3. Implementation Patterns
+
+- **HTML:**
+  - **Validation:** Validate your HTML using the W3C Markup Validation Service.
+- **CSS:**
+  - **Prefixing:** Use a tool like Autoprefixer to add vendor prefixes to your CSS.
+  - **Minification:** Use a tool like cssnano to minify your CSS for production.
+
+## 4. Common Commands
+
+- **Linting:** `stylelint "**/*.css"`, `prettier --check "**/*.html"`
+- **Formatting:** `prettier --write "**/*.{html,css}"`

zrb/task/llm/default_workflow/coding/java.md

@@ -0,0 +1,37 @@
+# Java Development Guide
+
+This guide provides the baseline for Java development. It is superseded by project-specific conventions.
+
+## 1. Project Analysis Checklist
+
+Before coding, inspect the project for these files to determine its conventions:
+
+- **Build System:** `pom.xml` (Maven) or `build.gradle` (Gradle). Note the dependencies, plugins, and build lifecycle.
+- **Java Version:** Look for a `.java-version` file, or check the `pom.xml` or `build.gradle` file.
+- **Style & Linting Config:** `.checkstyle.xml`, `.pmd.xml`. These define the coding standard.
+- **Testing Framework:** Look for a `src/test/java` directory and check the build file for dependencies like `junit` or `testng`.
+
+## 2. Core Principles
+
+- **Style:** Strictly adhere to the project's configured linter (e.g., Checkstyle, PMD). If none exist, default to the Google Java Style Guide.
+- **Object-Oriented Design:** Follow SOLID principles and use design patterns where appropriate.
+- **API Design:** Follow the principles of good API design, such as keeping APIs small and focused.
+
+## 3. Implementation Patterns
+
+- **Error Handling:** Replicate existing patterns for exceptions. Use checked exceptions for recoverable errors and unchecked exceptions for programming errors.
+- **Testing:** Use the project's existing test structure. Write unit tests for all new code.
+- **Concurrency:** Follow existing concurrency patterns. Use the `java.util.concurrent` package for high-level concurrency abstractions.
+
+## 4. Common Commands
+
+- **Maven:**
+  - **Clean:** `mvn clean`
+  - **Compile:** `mvn compile`
+  - **Test:** `mvn test`
+  - **Package:** `mvn package`
+  - **Install:** `mvn install`
+- **Gradle:**
+  - **Clean:** `./gradlew clean`
+  - **Build:** `./gradlew build`
+  - **Test:** `./gradlew test`

zrb/task/llm/default_workflow/coding/javascript.md

@@ -0,0 +1,45 @@
+# JavaScript/TypeScript Development Guide
+
+This guide provides the baseline for JS/TS development. It is superseded by project-specific conventions.
+
+## 1. Project Analysis Checklist
+
+Before coding, inspect the project for these files to determine its conventions:
+
+- **Package Manager:** `package.json` (and `package-lock.json`, `yarn.lock`, or `pnpm-lock.yaml`). Note the `scripts` and `dependencies`.
+- **TypeScript/JavaScript Config:** `tsconfig.json` or `jsconfig.json`. This defines module system, strictness, and paths.
+- **Style & Linting Config:** `.eslintrc.js`, `.prettierrc`, `package.json` (for `eslintConfig`, `prettier`). These define the coding standard.
+- **Build/Vite Config:** `webpack.config.js`, `vite.config.ts`, `rollup.config.js`.
+- **Testing Framework:** Look for a `tests/` or `__tests__/` directory, and config files like `jest.config.js` or `vitest.config.ts`.
+
+## 2. Core Principles
+
+- **Style:** Strictly adhere to the project's configured linter (`ESLint`) and formatter (`Prettier`).
+- **TypeScript:** If the project uses TypeScript (`tsconfig.json` exists), you MUST use it for all new code. Adhere to the configured strictness level.
+- **Module System:** Match the project's module system (e.g., ES Modules `import/export` or CommonJS `require/module.exports`). This is usually defined in `package.json` (`"type": "module"`) or `tsconfig.json`.
+
+## 3. Package Management
+
+- **`npm`:** If the project uses `package-lock.json`, add new dependencies using `npm install <package-name>`.
+- **`yarn`:** If the project uses `yarn.lock`, add new dependencies using `yarn add <package-name>`.
+- **`pnpm`:** If the project uses `pnpm-lock.yaml`, add new dependencies using `pnpm add <package-name>`.
+
+## 4. Framework Conventions
+
+- **React:** If the project uses React, follow its component structure (e.g., functional components with hooks), state management (e.g., `useState`, `useReducer`, Redux), and JSX syntax.
+- **Vue:** If the project uses Vue, follow its single-file component structure, `v-` directives, and state management patterns (e.g., Pinia).
+- **Angular:** If the project uses Angular, follow its module and component structure, dependency injection, and RxJS-based patterns.
+
+## 5. Implementation Patterns
+
+- **Error Handling:** Replicate existing patterns for `try/catch`, Promises (`.catch()`), and async/await error handling.
+- **Testing:** Use the project's existing test runner (`Jest`, `Vitest`, `Mocha`), assertion library, and mocking patterns. Add tests for all new code.
+- **Debugging:** Use the browser's developer tools for front-end code and the Node.js debugger (`node --inspect`) for back-end code.
+
+## 6. Common Commands
+
+- **Install Dependencies:** `npm install`, `yarn install`, `pnpm install`
+- **Linting/Formatting:** `npm run lint`, `npm run format`
+- **Type Checking:** `npm run typecheck`, `tsc --noEmit`
+- **Testing:** `npm test`, `npm run test`
+- **Building:** `npm run build`