speiidev 1.0.1 → 1.2.0

package/PLAN.md

@@ -0,0 +1,292 @@
+# Implementation Plan: Say Hi Feature for SpeiiDev
+
+Phased implementation plan for adding the `say hi` feature to `autodev-orchestrator` (SpeiiDev).
+
+## Goal Description
+Implement an interactive and CLI greeting feature (`say hi` / `hi`) for SpeiiDev (`autodev`).
+This feature enables users to say hi both in non-interactive batch/scripting mode and interactively in the REPL:
+1. A dedicated greeting utility module (`/Users/mac/Documents/AI/autodev/src/autodev/hi.py`) with Catppuccin Bok Choy styling and ASCII / 3D block typography.
+2. A CLI flag `--hi [NAME]` allowing users to print a greeting banner and exit cleanly.
+3. An interactive REPL slash command `/hi [NAME]` providing friendly greeting banners and mascot artwork within the TUI.
+4. Comprehensive unit and integration test coverage and updated documentation.
+
+```mermaid
+flowchart TD
+    User([User / Shell]) --> ModeCheck{Invocation Mode}
+    ModeCheck -->|CLI flag: --hi [NAME]| CLIRunner["/Users/mac/Documents/AI/autodev/src/autodev/cli.py:main()"]
+    ModeCheck -->|REPL command: /hi [NAME]| REPLRunner["/Users/mac/Documents/AI/autodev/src/autodev/cli.py:interactive_repl()"]
+    
+    CLIRunner --> HiHandler["/Users/mac/Documents/AI/autodev/src/autodev/cli.py:handle_hi()"]
+    REPLRunner --> HiHandler
+    
+    HiHandler --> CorePrint["/Users/mac/Documents/AI/autodev/src/autodev/hi.py:print_hi()"]
+    CorePrint --> CoreFormat["/Users/mac/Documents/AI/autodev/src/autodev/hi.py:get_hi_greeting()"]
+    CoreFormat --> BlockFont["/Users/mac/Documents/AI/autodev/src/autodev/font.py:render_block_text()"]
+    CorePrint --> ConsoleOutput([Rich Console Rendered Banner])
+```
+
+---
+
+## User Review Required
+> [!NOTE]
+> No breaking changes are introduced. All existing CLI flags, slash commands, configurations, and test suites will remain fully backwards-compatible.
+
+---
+
+## Open Questions
+*None* — Requirements are well-defined and integrate cleanly into the existing modular CLI architecture.
+
+---
+
+## Proposed Changes
+
+### Core Greeting Component
+
+#### [NEW] `/Users/mac/Documents/AI/autodev/src/autodev/hi.py`
+Exact Path: `/Users/mac/Documents/AI/autodev/src/autodev/hi.py`
+Provides formatting and rendering routines for stylized "say hi" greetings.
+- **Interface Signatures**:
+  ```python
+  from __future__ import annotations
+  from typing import Optional
+  from rich.console import Console
+
+  def get_hi_greeting(name: str = "World", style: str = "claude") -> str:
+      """Generate a stylized 'HI' greeting string with block font art.
+
+      Args:
+          name: The recipient name to greet (default: 'World').
+          style: The typography style ('claude' for 3D shadow or 'mini' for 2-line).
+
+      Returns:
+          Formatted greeting text containing block art typography.
+      """
+      ...
+
+  def print_hi(
+      name: str = "World",
+      style: str = "claude",
+      console: Optional[Console] = None,
+  ) -> None:
+      """Render the 'HI' greeting inside a Rich Panel with Bok Choy Green accent.
+
+      Args:
+          name: The recipient name to greet (default: 'World').
+          style: The typography style ('claude' or 'mini').
+          console: Optional Rich Console instance (defaults to global Console()).
+      """
+      ...
+
+  def say_hi(name: str = "World", style: str = "claude") -> None:
+      """Top-level convenience entry point to say hi.
+
+      Args:
+          name: The recipient name to greet (default: 'World').
+          style: The typography style ('claude' or 'mini').
+      """
+      ...
+  ```
+
+#### [MODIFY] `/Users/mac/Documents/AI/autodev/src/autodev/__init__.py`
+Exact Path: `/Users/mac/Documents/AI/autodev/src/autodev/__init__.py`
+Export public symbols `get_hi_greeting`, `print_hi`, and `say_hi`.
+- **Interface Signatures**:
+  ```python
+  from autodev.hi import get_hi_greeting, print_hi, say_hi
+
+  __all__ = [
+      ...,
+      "get_hi_greeting",
+      "print_hi",
+      "say_hi",
+  ]
+  ```
+
+---
+
+### CLI & TUI Integration
+
+#### [MODIFY] `/Users/mac/Documents/AI/autodev/src/autodev/cli.py`
+Exact Path: `/Users/mac/Documents/AI/autodev/src/autodev/cli.py`
+- **Interface Signatures & Additions**:
+  ```python
+  # 1. Update SLASH_COMMANDS list:
+  SLASH_COMMANDS: list[str] = [
+      ...,
+      "/hi",
+      "/font",
+      "/clear",
+      "/help",
+      "/exit",
+  ]
+
+  # 2. Add handler function:
+  def handle_hi(state: AgentState, arg: str = "") -> None:
+      """Handle the /hi slash command in the interactive REPL.
+
+      Args:
+          state: Current AgentState instance.
+          arg: Optional argument containing recipient name (defaults to 'World').
+      """
+      ...
+
+  # 3. Add argument in main() -> int:
+  parser.add_argument(
+      "--hi",
+      nargs="?",
+      const="World",
+      default=None,
+      metavar="NAME",
+      help="Say hi with a stylized greeting banner and exit",
+  )
+
+  # 4. Add slash command dispatch in interactive_repl(state: AgentState) -> int:
+  elif user_input.startswith("/hi"):
+      parts = user_input.split(maxsplit=1)
+      name_arg = parts[1].strip() if len(parts) > 1 else "World"
+      handle_hi(state, name_arg)
+
+  # 5. Add /hi row in show_help() -> None:
+  table.add_row("/hi [name]", "Say hi with a stylized greeting banner")
+  ```
+
+---
+
+### Test Suite
+
+#### [NEW] `/Users/mac/Documents/AI/autodev/tests/test_hi.py`
+Exact Path: `/Users/mac/Documents/AI/autodev/tests/test_hi.py`
+Unit tests for `autodev.hi`.
+- **Interface Signatures**:
+  ```python
+  import unittest
+
+  class TestHi(unittest.TestCase):
+      def test_default_greeting(self) -> None:
+          """Test get_hi_greeting() returns default greeting for 'World'."""
+          ...
+
+      def test_custom_name_greeting(self) -> None:
+          """Test get_hi_greeting('SpeiiDev') includes the target name."""
+          ...
+
+      def test_mini_font_style(self) -> None:
+          """Test get_hi_greeting with style='mini'."""
+          ...
+
+      def test_print_hi_panel(self) -> None:
+          """Test print_hi renders without exception to a captured Console."""
+          ...
+
+      def test_say_hi_convenience(self) -> None:
+          """Test say_hi convenience wrapper executes cleanly."""
+          ...
+  ```
+
+#### [MODIFY] `/Users/mac/Documents/AI/autodev/tests/test_cli.py`
+Exact Path: `/Users/mac/Documents/AI/autodev/tests/test_cli.py`
+Integration test cases added to `TestCLIHelpers`:
+- **Interface Signatures**:
+  ```python
+  class TestCLIHelpers(unittest.TestCase):
+      ...
+      def test_cli_hi_flag(self) -> None:
+          """Invoking --hi must exit 0 and print greeting."""
+          ...
+
+      def test_cli_hi_custom_name(self) -> None:
+          """Invoking --hi 'Developer' must include 'Developer' in stdout."""
+          ...
+
+      def test_slash_command_hi_registered(self) -> None:
+          """Ensure '/hi' is present in SLASH_COMMANDS."""
+          ...
+  ```
+
+---
+
+### Documentation
+
+#### [MODIFY] `/Users/mac/Documents/AI/autodev/README.md`
+Exact Path: `/Users/mac/Documents/AI/autodev/README.md`
+- Document `/hi [name]` in the Interactive Slash Commands table.
+- Document `--hi [NAME]` in the CLI Options section.
+
+---
+
+## Phased Implementation Plan
+
+### Phase 1: Core Greeting Module
+- [ ] 1.1 Create `/Users/mac/Documents/AI/autodev/src/autodev/hi.py` implementing `get_hi_greeting(name: str = "World", style: str = "claude") -> str`, `print_hi(name: str = "World", style: str = "claude", console: Optional[Console] = None) -> None`, and `say_hi(name: str = "World", style: str = "claude") -> None`.
+- [ ] 1.2 Export `get_hi_greeting`, `print_hi`, and `say_hi` in `/Users/mac/Documents/AI/autodev/src/autodev/__init__.py` and include them in `__all__`.
+
+**Verification Command**:
+```bash
+PYTHONPATH=src ./venv/bin/python3 -c "from autodev import get_hi_greeting, print_hi, say_hi; print(get_hi_greeting('World'))"
+```
+
+---
+
+### Phase 2: CLI & Slash Command Dispatch
+- [ ] 2.1 Add `"/hi"` to `SLASH_COMMANDS` list in `/Users/mac/Documents/AI/autodev/src/autodev/cli.py`.
+- [ ] 2.2 Add `handle_hi(state: AgentState, arg: str = "") -> None` handler function in `/Users/mac/Documents/AI/autodev/src/autodev/cli.py`.
+- [ ] 2.3 Add `--hi` flag (`nargs="?", const="World", default=None, metavar="NAME"`) in `parser.add_argument` within `main()` in `/Users/mac/Documents/AI/autodev/src/autodev/cli.py`.
+- [ ] 2.4 Add execution handler in `main()` for `args.hi is not None` to call `print_hi(args.hi, style=args.font_style)` and return 0.
+- [ ] 2.5 Add `/hi` handling in the REPL command loop in `interactive_repl()` in `/Users/mac/Documents/AI/autodev/src/autodev/cli.py`.
+- [ ] 2.6 Add `/hi [name]` entry to `show_help()` table in `/Users/mac/Documents/AI/autodev/src/autodev/cli.py`.
+
+**Verification Commands**:
+```bash
+PYTHONPATH=src ./venv/bin/python3 -m autodev.cli --help | grep -E "(--hi|hi)"
+PYTHONPATH=src ./venv/bin/python3 -m autodev.cli --hi "SpeiiDev"
+```
+
+---
+
+### Phase 3: Unit and Integration Tests
+- [ ] 3.1 Implement unit tests in `/Users/mac/Documents/AI/autodev/tests/test_hi.py` testing `get_hi_greeting` (default name, custom name, styles), `print_hi`, and `say_hi`.
+- [ ] 3.2 Add test cases `test_cli_hi_flag`, `test_cli_hi_custom_name`, and `test_slash_command_hi_registered` to `TestCLIHelpers` in `/Users/mac/Documents/AI/autodev/tests/test_cli.py`.
+- [ ] 3.3 Execute unit and integration tests to confirm zero regressions.
+
+**Verification Commands**:
+```bash
+PYTHONPATH=src ./venv/bin/pytest tests/test_hi.py -v
+PYTHONPATH=src ./venv/bin/pytest tests/test_cli.py -k "hi" -v
+PYTHONPATH=src ./venv/bin/pytest
+```
+
+---
+
+### Phase 4: Documentation & Final Verification
+- [ ] 4.1 Update `/Users/mac/Documents/AI/autodev/README.md` with `/hi` slash command description and `--hi` CLI flag documentation.
+- [ ] 4.2 Run end-to-end regression testing and git status verification.
+
+**Verification Commands**:
+```bash
+PYTHONPATH=src ./venv/bin/pytest
+git diff --stat
+```
+
+---
+
+## Verification Plan
+
+### Automated Tests
+Run full test suite via pytest:
+```bash
+PYTHONPATH=src ./venv/bin/pytest -v
+```
+
+### Manual Verification
+1. Test CLI execution:
+   ```bash
+   PYTHONPATH=src ./venv/bin/python3 -m autodev.cli --hi "Pair Programmer"
+   ```
+2. Verify output displays:
+   - TrueColor Bok Choy banner
+   - Styled block font greeting "HI"
+   - Friendly greeting message: "Hi, Pair Programmer! Welcome to SpeiiDev."
+3. Test interactive REPL slash command:
+   ```bash
+   echo -e "/hi Alice\n/exit" | PYTHONPATH=src ./venv/bin/python3 -m autodev.cli --no-splash
+   ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speiidev",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Multi-agent terminal orchestrator wrapper",
   "author": "Toek Sopanha",
   "bin": {

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "autodev-orchestrator"
-version = "1.0.1"
+dynamic = ["version"]
 description = "Interactive Multi-Agent TUI with pluggable agents, model switcher, diff gate, and conversation memory."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -60,3 +60,6 @@ render-pixel-art = "autodev.pixel_art:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
+
+[tool.setuptools.dynamic]
+version = { attr = "autodev._version.__version__" }

package/scripts/bump_version.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+"""Bump the SpeiiDev version from ONE place.
+
+Usage:
+    python scripts/bump_version.py 1.2.3
+
+What it updates:
+  - src/autodev/_version.py  (the single source of truth)
+  - package.json             (npm wrapper; Node can't read the Python file)
+
+Not needed (they read the version dynamically):
+  - pyproject.toml  -> [tool.setuptools.dynamic] attr = autodev._version.__version__
+  - src/autodev/cli.py -> APP_VERSION = autodev._version.__version__
+
+Pass --check to verify all files agree without changing anything (used by tests).
+"""
+
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+VERSION_FILE = ROOT / "src" / "autodev" / "_version.py"
+PACKAGE_JSON = ROOT / "package.json"
+
+SEMVER_RE = re.compile(r"^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.\-]+)?$")
+
+
+def read_source_version() -> str:
+    text = VERSION_FILE.read_text(encoding="utf-8")
+    m = re.search(r'^__version__\s*=\s*["\']([^"\']+)["\']', text, re.MULTILINE)
+    if not m:
+        raise SystemExit(f"❌ Could not find __version__ in {VERSION_FILE}")
+    return m.group(1)
+
+
+def read_package_version() -> str:
+    data = json.loads(PACKAGE_JSON.read_text(encoding="utf-8"))
+    return str(data.get("version", ""))
+
+
+def write_source_version(version: str) -> None:
+    text = VERSION_FILE.read_text(encoding="utf-8")
+    text = re.sub(
+        r'^(__version__\s*=\s*)["\'][^"\']+["\']',
+        rf'\1"{version}"',
+        text,
+        count=1,
+        flags=re.MULTILINE,
+    )
+    VERSION_FILE.write_text(text, encoding="utf-8")
+
+
+def write_package_version(version: str) -> None:
+    text = PACKAGE_JSON.read_text(encoding="utf-8")
+    text = re.sub(
+        r'("version"\s*:\s*)["\'][^"\']+["\']',
+        rf'\1"{version}"',
+        text,
+        count=1,
+    )
+    PACKAGE_JSON.write_text(text, encoding="utf-8")
+
+
+def check() -> int:
+    src = read_source_version()
+    pkg = read_package_version()
+    ok = src == pkg
+    print(f"  src/autodev/_version.py : {src}")
+    print(f"  package.json            : {pkg}")
+    if ok:
+        print(f"✓ Versions agree ({src})")
+        return 0
+    print("❌ Versions differ — run: python scripts/bump_version.py <version>")
+    return 1
+
+
+def main(argv: list[str]) -> int:
+    if len(argv) == 2 and argv[1] in ("--check", "-c"):
+        return check()
+    if len(argv) != 2:
+        print(__doc__)
+        return 2
+
+    version = argv[1].strip().lstrip("v")
+    if not SEMVER_RE.match(version):
+        print(f"❌ Invalid version '{version}'. Expected something like 1.2.3")
+        return 2
+
+    old = read_source_version()
+    write_source_version(version)
+    write_package_version(version)
+
+    print(f"✅ SpeiiDev version: {old} → {version}")
+    print("   updated: src/autodev/_version.py, package.json")
+    print("   pyproject.toml & cli.py read it dynamically.")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv))

package/src/autodev/__init__.py

@@ -3,13 +3,8 @@ autodev: Interactive Multi-Agent TUI with pluggable agents, model switcher,
 diff gate, and conversation memory.
 """
 
-from autodev.cli import (
-    AgentProfile,
-    AgentState,
-    FileChange,
-    PROFILES,
-    main,
-)
+from typing import TYPE_CHECKING
+from autodev._version import __version__
 from autodev.font import (
     BLOCK_FONT,
     CLAUDE_3D_FONT,
@@ -22,7 +17,22 @@ from autodev.pixel_art import (
     render_pixel_art,
 )
 
-__version__ = "1.0.1"
+if TYPE_CHECKING:
+    from autodev.cli import (
+        AgentProfile,
+        AgentState,
+        FileChange,
+        PROFILES,
+        main,
+    )
+
+
+def __getattr__(name: str):
+    if name in ("AgentProfile", "AgentState", "FileChange", "PROFILES", "main"):
+        import autodev.cli as cli
+        return getattr(cli, name)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
 __all__ = [
     "AgentProfile",
     "AgentState",

package/src/autodev/_version.py

@@ -0,0 +1,14 @@
+"""Single source of truth for the SpeiiDev version.
+
+Everything else reads from here:
+  - ``autodev.__version__`` and ``autodev.cli.APP_VERSION`` import it.
+  - ``pyproject.toml`` reads it dynamically (``attr = "autodev._version.__version__"``).
+  - ``package.json`` (npm wrapper) is kept in sync by ``scripts/bump_version.py``.
+
+To release a new version, change it in ONE place:
+
+    python scripts/bump_version.py 1.2.3
+
+"""
+
+__version__ = "1.2.0"