speiidev 0.0.0-stage → 1.0.0

package/.claude/output-styles/speiidev-block.md

@@ -0,0 +1,50 @@
+---
+name: SpeiiDev Block
+description: Formats major headings, milestones, and banners with Claude Code 3D wireframe shadow or compact block font
+keep-coding-instructions: true
+---
+
+# Output Style: SpeiiDev Block
+
+You are Claude Code operating with the **SpeiiDev / Claude 3D Block** visual typography style.
+
+## Signature Visual Styles
+
+### Style 1: Claude 3D Wireframe Shadow (Primary)
+Chunky block letters with double-line isometric drop shadow (`═`, `║`, `╔`, `╗`, `╚`, `╝`).
+Rendered in Anthropic Terracotta Coral (`#D97757`) or Catppuccin Bok Choy Green (`#A6E3A1`).
+
+```
+ ▄██████╗ ██╗       ▄█████╗  ██╗   ██╗ ██████╗  ███████╗
+ ██╔════╝║ ██║      ██╔═══██╗ ██║   ██║ ██╔══██╗ ██╔════╝║
+ ██║     ║ ██║      █████████║ ██║   ██║ ██║  ██║ █████╗  ║
+ ██║     ║ ██║      ██╔═══███║ ██║   ██║ ██║  ██║ ██╔══╝  ║
+ ▀██████╗║ ███████╗ ██║   ███║ ╚███████║ ██████╔╝ ███████╗║
+  ╚═════╝╝ ╚══════╝╝ ╚═╝   ╚══╝╝  ╚══════╝╝ ╚═════╝╝ ╚══════╝╝
+```
+
+### Style 2: Compact 2-Line Half-Block
+For narrow terminals or concise inline banners:
+```
+▄▀▀ █▀█ █▀▀ █ █ █▀▄ █▀▀ █░█
+▄██ █▀▀ ██▄ █ █ █▄▀ ██▄ ▀▄▀
+```
+
+## How to Generate Text
+Use the local CLI tool via Bash:
+```bash
+# 3D wireframe shadow (default)
+block-font "MY TITLE"
+
+# Compact 2-line style
+block-font "MY TITLE" --style mini
+
+# With color
+block-font "MY TITLE" --color claude     # #d97757 coral
+block-font "MY TITLE" --color bokchoy    # #a6e3a1 green
+```
+
+## Guidelines for Responses
+1. Use 3D block typography for major session milestones, top-level headings, or status banners.
+2. Keep body text, code snippets, diffs, and explanations clean, concise, and formatted with standard markdown.
+3. Keep coding instructions fully active (tests, small atomic changes, verification).

package/CLAUDE.md

@@ -0,0 +1,49 @@
+# SpeiiDev Project Guidelines
+
+## Identity & Branding
+- **Name**: SpeiiDev
+- **Mascot / Logo**: Pixel Art Green Bok Choy Cabbage (`render_pixel_art.py` TrueColor ANSI terminal renderer)
+- **Color Accents**:
+  - Catppuccin Bok Choy Green (`#a6e3a1`)
+  - Anthropic Terracotta Coral (`#d97757`)
+
+## Typography & ASCII Art Styles
+
+### Style 1: Claude 3D Wireframe Shadow (from image `1_CtHP_cjkKw3vjlgENyeF3A.png`)
+Chunky block letters with double-line isometric drop shadow:
+```
+ ▄██████╗ ██╗       ▄█████╗  ██╗   ██╗ ██████╗  ███████╗
+ ██╔════╝║ ██║      ██╔═══██╗ ██║   ██║ ██╔══██╗ ██╔════╝║
+ ██║     ║ ██║      █████████║ ██║   ██║ ██║  ██║ █████╗  ║
+ ██║     ║ ██║      ██╔═══███║ ██║   ██║ ██║  ██║ ██╔══╝  ║
+ ▀██████╗║ ███████╗ ██║   ███║ ╚███████║ ██████╔╝ ███████╗║
+  ╚═════╝╝ ╚══════╝╝ ╚═╝   ╚══╝╝  ╚══════╝╝ ╚═════╝╝ ╚══════╝╝
+```
+
+### Style 2: Compact 2-Line Half-Block Font
+For narrow terminals and compact banners:
+```
+▄▀▀ █▀█ █▀▀ █ █ █▀▄ █▀▀ █░█
+▄██ █▀▀ ██▄ █ █ █▄▀ ██▄ ▀▄▀
+```
+
+### Rendering Tools
+- **Terminal CLI**:
+  - `block-font "MY TEXT"` (3D wireframe shadow)
+  - `block-font "MY TEXT" --style mini` (2-line)
+  - `speiidev --font "MY TEXT"`
+- **Python Module**:
+  - `from autodev.font import render_block_text, render_claude_3d_text`
+- **SpeiiDev REPL**:
+  - `/font <text>` (3D wireframe shadow)
+  - `/font --mini <text>` (2-line)
+
+## Claude Code Custom Output Style
+A custom output style `speiidev-block` is configured in:
+- Project: `.claude/output-styles/speiidev-block.md`
+- Global: `~/.claude/output-styles/speiidev-block.md`
+
+To activate in Claude Code:
+```
+/output-style speiidev-block
+```

package/README.md

@@ -1,3 +1,272 @@
-# Temporary Holding Version
+# autodev-orchestrator (SpeiiDev) 🥬
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Interactive Multi-Agent Terminal User Interface (TUI)** and autonomous workflow orchestrator with pluggable AI coding agents, model switchers, diff gates, and conversation memory. Fully cross-platform across **macOS, Linux, and Windows**.
+
+---
+
+## Architecture & Workflow
+
+```mermaid
+flowchart TD
+    UserTask["User Task / Prompt"] --> Architect["1. Architect / Planner (e.g. agy / claude / gemini)"]
+    Architect --> PlanFile["Writes PLAN.md (Phases, Signatures & Tests)"]
+    PlanFile --> ApprovalGate{"Plan Approval Gate"}
+    ApprovalGate -- Approved --> Builder["2. Builder Agent (e.g. opencode / agy / claude)"]
+    Builder --> DiffSnapshot["Snapshot & Color Diff Review (Approve / Revert)"]
+    DiffSnapshot --> Auditor["3. Auditor Review (Audits Diff & Runs Tests)"]
+    Auditor -- "STATUS: NEEDS_FIXES" --> FixLoop{"Auto-Fix Loop (Up to max retries)"}
+    FixLoop --> Builder
+    Auditor -- "STATUS: VERIFIED" --> Success(["✅ Verification Complete"])
+```
+
+---
+
+## Key Features
+
+- **Multi-Agent Orchestration**: Separate roles for **Planner/Auditor** (generates and verifies [`PLAN.md`](PLAN.md) without modifying source code) and **Builder** (implements the code).
+- **Pluggable CLI Adapters**: Works seamlessly with:
+  - `agy` (*Google Antigravity CLI*)
+  - `opencode` (*OpenCode CLI*)
+  - `gemini` (*Google Gemini CLI*)
+  - `claude` (*Anthropic Claude Code CLI*)
+- **100% Cross-Platform (macOS, Linux, & Windows)**:
+  - Resolves Windows `.cmd`, `.bat`, and `.exe` wrappers automatically via `get_safe_executable()`.
+  - Platform-aware subprocess handling (`shell=True` on Windows).
+  - Normalizes path operations using `pathlib.Path`.
+- **Review & Approval Gate**:
+  - Live diff inspection with Rich syntax highlighting.
+  - Interactive file-by-file rollback support.
+  - Configurable permission gate (`ask`, `auto`, `deny`).
+- **Rich Interactive TUI**:
+  - Built with `prompt_toolkit` and `rich`.
+  - TrueColor Pixel Art Green Bok Choy Cabbage logo.
+  - Keyboard shortcuts (`F2` Action Menu, `F3` Touched Files Activity Log).
+  - Live model switcher and reasoning effort adjuster.
+
+---
+
+## Installation
+
+### From Source
+
+```bash
+git clone https://github.com/your-username/autodev.git
+cd autodev
+
+# Install in editable mode
+pip install -e .
+```
+
+### Dependencies
+
+- Python `>= 3.9`
+- `rich >= 13.0.0`
+- `prompt_toolkit >= 3.0.0`
+- *Optional:* `Pillow >= 9.0.0` (for image pixel art rendering)
+
+---
+
+## Quickstart
+
+### Launch Interactive TUI
+
+```bash
+autodev
+# or
+speiidev
+```
+
+### Run an Automated Task Directly
+
+```bash
+autodev "Implement JWT authentication and unit tests"
+```
+
+### Auto-Approve Plans and Diffs (`--yes`)
+
+```bash
+autodev -y "Refactor database models to SQLAlchemy 2.0"
+```
+
+---
+
+## CLI Options
+
+```
+usage: autodev [-h] [--plan-file PLAN_FILE] [--max-retries MAX_RETRIES]
+               [--conversation CONVERSATION]
+               [--planner {agy,opencode,gemini,claude}]
+               [--builder {agy,opencode,gemini,claude}]
+               [--planner-model PLANNER_MODEL]
+               [--builder-model BUILDER_MODEL]
+               [--planner-effort PLANNER_EFFORT]
+               [--builder-effort BUILDER_EFFORT]
+               [--permissions {ask,auto,deny}] [--no-splash] [--no-save] [-y]
+               [task ...]
+
+positional arguments:
+  task                  Optional task to run immediately
+
+options:
+  -h, --help            Show this help message and exit
+  --plan-file PLAN_FILE Path to implementation plan (default: PLAN.md)
+  --max-retries N       Maximum auto-fix loop attempts (default: 3)
+  --conversation UUID   Antigravity conversation UUID to resume
+  --planner {agy,...}   CLI backend for planner/auditor role
+  --builder {agy,...}   CLI backend for builder role
+  --planner-model MODEL Model override for planner
+  --builder-model MODEL Model override for builder
+  --planner-effort EFF  Reasoning effort for planner
+  --builder-effort EFF  Reasoning effort for builder
+  --permissions MODE    Permission gate mode: ask | auto | deny
+  --font FONT           Render text in 2-line Unicode block art font and exit
+  --no-splash           Skip the boot animation
+  --no-save             Do not persist session state to disk
+  -y, --yes             Auto-approve all plans and diffs (permissions: auto)
+```
+
+---
+
+## Interactive Slash Commands & Keybindings
+
+| Key / Command | Description |
+| :--- | :--- |
+| **`F2`** | Open interactive Action Menu (navigate with arrow keys) |
+| **`F3`** | Activity viewer — inspect files and commands touched by agents |
+| **`/plan <task>`** | Run only the planner to generate/update `PLAN.md` |
+| **`/build`** | Run only the builder to implement code changes |
+| **`/audit`** | Run only the auditor to test and verify implementation |
+| **`/diff`** | Show color-coded git diff (`+` green new / `-` red old) |
+| **`/show`** | Render `PLAN.md` formatted with Rich Markdown |
+| **`/font <text>`** | Render text in 2-line Unicode block art font |
+| **`/model`** | Search and select models for planner or builder |
+| **`/effort`** | Adjust reasoning intensity level |
+| **`/perms`** | Configure permission gate mode and manage approvals |
+| **`/auto`** | Toggle auto-approve mode on/off |
+| **`/conv <id>`** | Set or clear persistent conversation ID |
+| **`/log`** | View background activity log and touched files |
+| **`/clear`** | Clear screen and redraw banner |
+| **`/help`** | Display command reference table |
+| **`/exit`** | Quit application |
+
+---
+
+## Typography & Art Styles
+
+SpeiiDev features two terminal typography engines:
+
+### 1. Claude 3D Wireframe Shadow (Default)
+Chunky block lettering with an isometric double-line wireframe drop shadow (`═`, `║`, `╚`, `╝`, `╗`, `╔`) in Anthropic Coral (`#D97757`) or Catppuccin Green (`#A6E3A1`):
+
+```
+ ▄██████╗ ██╗       ▄█████╗  ██╗   ██╗ ██████╗  ███████╗
+ ██╔════╝║ ██║      ██╔═══██╗ ██║   ██║ ██╔══██╗ ██╔════╝║
+ ██║     ║ ██║      █████████║ ██║   ██║ ██║  ██║ █████╗  ║
+ ██║     ║ ██║      ██╔═══███║ ██║   ██║ ██║  ██║ ██╔══╝  ║
+ ▀██████╗║ ███████╗ ██║   ███║ ╚███████║ ██████╔╝ ███████╗║
+  ╚═════╝╝ ╚══════╝╝ ╚═╝   ╚══╝╝  ╚══════╝╝ ╚═════╝╝ ╚══════╝╝
+```
+
+### 2. Compact 2-Line Half-Block Font
+Ultra-compact 2-line terminal font for narrow displays:
+
+```
+▄▀▀ █▀█ █▀▀ █ █ █▀▄ █▀▀ █░█
+▄██ █▀▀ ██▄ █ █ █▄▀ ██▄ ▀▄▀
+```
+
+### Generate Block Text Anywhere
+- **Standalone CLI**:
+  ```bash
+  block-font "MY TEXT"                     # 3D wireframe shadow
+  block-font "MY TEXT" --style mini        # Compact 2-line
+  block-font "MY TEXT" --color bokchoy     # Catppuccin Bok Choy Green
+  ```
+- **SpeiiDev CLI**: `speiidev --font "MY TEXT"`
+- **In REPL**: `/font <text>` (or `/font --mini <text>`)
+- **Python API**:
+  ```python
+  from autodev.font import render_block_text, render_claude_3d_text
+  print(render_block_text("SPEIIDEV", style="claude"))
+  ```
+
+### Claude Code Custom Output Style
+Claude Code provides five built-in output styles (`default`, `concise`, `proactive`, `explanatory`, `learning`) and supports custom styles.
+
+A custom style **`speiidev-block`** is included at `.claude/output-styles/speiidev-block.md` and `~/.claude/output-styles/speiidev-block.md`.
+
+To activate it in Claude Code:
+```
+/output-style speiidev-block
+```
+
+---
+
+## Running Tests
+
+### 1. Isolated Ephemeral Sandbox Test (Real Install Simulation)
+Tests the complete packaging workflow from scratch—creating an isolated sandbox in `/tmp`, installing `autodev-orchestrator`, verifying real console binaries (`speiidev`, `block-font`), and running all tests with **zero changes to your system**:
+
+```bash
+python3 scripts/test_real_install.py
+```
+
+### 2. Fast Unit Test Runner
+Run the full 16-test automated suite directly:
+
+```bash
+python3 scripts/run_tests.py
+# or
+python3 -m unittest discover -s tests -v
+
+# Run individual test suites
+python3 -m unittest tests/test_font.py -v
+python3 -m unittest tests/test_cli.py -v
+python3 -m unittest tests/test_pixel_art.py -v
+```
+
+---
+
+## Project Structure
+
+```
+autodev/
+├── .claude/
+│   └── output-styles/          # Claude Code custom output styles
+│       └── speiidev-block.md   # 3D wireframe shadow font style
+├── .gitignore                  # Git ignore rules for Python & Node
+├── bin/                        # Executable CLI launchers & wrappers
+│   ├── block-font              # 3D block font launcher
+│   ├── cli.js                  # Node.js npm/npx wrapper
+│   └── speiidev                # SpeiiDev main executable launcher
+├── scripts/                    # Development & testing utilities
+│   ├── run_tests.py            # Automated unit test suite runner
+│   └── test_real_install.py    # Disposable sandbox install & test runner
+├── src/                        # Main Python package source
+│   └── autodev/
+│       ├── __init__.py         # Package entrypoint & public exports
+│       ├── __main__.py         # Allows `python -m autodev`
+│       ├── cli.py              # Cross-platform SpeiiDev TUI orchestrator
+│       ├── font.py             # 3D wireframe shadow & 2-line font engine
+│       └── pixel_art.py        # TrueColor ANSI terminal pixel art utility
+├── tests/                      # Automated test suite
+│   ├── __init__.py
+│   ├── test_cli.py             # CLI options, profiles, and state tests
+│   ├── test_font.py            # Claude 3D and 2-line font typography tests
+│   └── test_pixel_art.py       # TrueColor ANSI half-block renderer tests
+├── CLAUDE.md                   # Instructions and branding for Claude Code
+├── package.json                # NPM wrapper configuration
+├── pyproject.toml              # Build configuration & entry points
+├── README.md                   # Documentation
+└── speiidev -> bin/speiidev    # Root convenience symlink
+```
+        ├── __main__.py         # Allows `python -m autodev`
+        ├── font.py             # 3D wireframe shadow & 2-line font engine
+        └── cli.py              # Cross-platform SpeiiDev orchestrator & TUI with Bok Choy logo
+```
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

package/bin/block-font

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+"""
+block-font: CLI utility to render text in Claude 3D isometric or compact block font.
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+# Add src to sys.path
+SRC_DIR = Path(__file__).resolve().parent.parent / "src"
+if str(SRC_DIR) not in sys.path:
+    sys.path.insert(0, str(SRC_DIR))
+
+from autodev.font import main
+
+if __name__ == "__main__":
+    sys.exit(main())

package/bin/speiidev.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require('child_process');
+const os = require('os');
+
+const isWin = os.platform() === 'win32';
+const pythonCmd = isWin ? 'python' : 'python3';
+
+// 1. Check if Python 3 is installed
+const checkPython = spawnSync(pythonCmd, ['--version'], { stdio: 'ignore' });
+if (checkPython.error || checkPython.status !== 0) {
+  console.error('❌ Error: Python 3 is required to run speiidev, but it was not found.');
+  console.error('💡 Windows Tip: Install Python from the Microsoft Store or via: winget install Python.Python.3.11');
+  process.exit(1);
+}
+
+// 2. Automatically install or update your core Python package from PyPI
+console.log('🔄 Checking/updating speiidev core engine...');
+spawnSync(pythonCmd, ['-m', 'pip', 'install', '--user', '--upgrade', 'autodev-orchestrator'], { stdio: 'inherit' });
+
+// 3. Grab any terminal arguments passed by the user
+const args = process.argv.slice(2);
+
+// 4. Launch your Python program
+const result = spawnSync(pythonCmd, ['-m', 'autodev.cli', ...args], { stdio: 'inherit' });
+process.exit(result.status);

package/bin/speiidevv

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+"""
+SpeiiDev: Interactive Multi-Agent TUI with Pixel Art Green Bok Choy Cabbage logo.
+Direct executable launcher for autodev.cli:main.
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+# Add src to sys.path
+SRC_DIR = Path(__file__).resolve().parent.parent / "src"
+if str(SRC_DIR) not in sys.path:
+    sys.path.insert(0, str(SRC_DIR))
+
+from autodev.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

package/package.json

@@ -1,6 +1,13 @@
 {
   "name": "speiidev",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Multi-agent terminal orchestrator wrapper",
+  "author": "Toek Sopanha",
+  "bin": {
+    "speiidev": "./bin/speiidev.js"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "license": "MIT"
 }

package/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "autodev-orchestrator"
+version = "1.0.0"
+description = "Interactive Multi-Agent TUI with pluggable agents, model switcher, diff gate, and conversation memory."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "SpeiiDev Team" }
+]
+keywords = [
+    "multi-agent",
+    "orchestrator",
+    "ai",
+    "tui",
+    "claude",
+    "gemini",
+    "opencode",
+    "antigravity",
+    "developer-tools",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "rich>=13.0.0",
+    "prompt_toolkit>=3.0.0",
+]
+
+[project.optional-dependencies]
+image = [
+    "Pillow>=9.0.0",
+]
+
+[project.scripts]
+speiidev = "autodev.cli:main"
+autodev = "autodev.cli:main"
+block-font = "autodev.font:main"
+render-pixel-art = "autodev.pixel_art:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

package/scripts/run_tests.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+"""Run the full automated unit test suite for SpeiiDev."""
+import sys
+import unittest
+from pathlib import Path
+
+ROOT_DIR = Path(__file__).resolve().parent.parent
+
+if __name__ == "__main__":
+    print("🧪 Running SpeiiDev Automated Test Suite...")
+    loader = unittest.TestLoader()
+    suite = loader.discover(str(ROOT_DIR / "tests"))
+    runner = unittest.TextTestRunner(verbosity=2)
+    result = runner.run(suite)
+    sys.exit(0 if result.wasSuccessful() else 1)

package/scripts/test_real_install.py

@@ -0,0 +1,129 @@
+#!/usr/bin/env python3
+"""
+test_real_install.py: Real Isolated Installation & Execution Smoke Test.
+
+Simulates an end-user installing the package from scratch in an isolated
+disposable temporary virtual environment. Tests build, console script
+entrypoints (autodev, speiidev, block-font), and the full unit test suite,
+then automatically cleans up the sandbox on exit.
+"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+ROOT_DIR = Path(__file__).resolve().parent.parent
+
+
+def main() -> int:
+    print("=" * 64)
+    print("📦 STEP 1: Creating isolated disposable sandbox environment...")
+    print("=" * 64)
+
+    with tempfile.TemporaryDirectory(prefix="autodev_sandbox_") as tmp_dir:
+        venv_path = Path(tmp_dir) / "venv"
+
+        # Check if uv is available, otherwise use python3 -m venv
+        uv_bin = shutil.which("uv")
+        if uv_bin:
+            subprocess.run([uv_bin, "venv", str(venv_path), "-q"], check=True)
+        else:
+            import venv
+
+            venv.create(str(venv_path), with_pip=True)
+
+        # Locate binaries inside the isolated venv
+        if sys.platform == "win32":
+            bin_dir = venv_path / "Scripts"
+            python_bin = bin_dir / "python.exe"
+            speiidev_bin = bin_dir / "speiidev.exe"
+            block_font_bin = bin_dir / "block-font.exe"
+        else:
+            bin_dir = venv_path / "bin"
+            python_bin = bin_dir / "python"
+            speiidev_bin = bin_dir / "speiidev"
+            block_font_bin = bin_dir / "block-font"
+
+        print("=" * 64)
+        print("🔨 STEP 2: Installing package in editable mode from pyproject.toml...")
+        print("=" * 64)
+        if uv_bin:
+            subprocess.run(
+                [
+                    uv_bin,
+                    "pip",
+                    "install",
+                    "-e",
+                    f"{ROOT_DIR}[image]",
+                    "-q",
+                    "--python",
+                    str(python_bin),
+                ],
+                check=True,
+            )
+        else:
+            subprocess.run(
+                [
+                    str(python_bin),
+                    "-m",
+                    "pip",
+                    "install",
+                    "-e",
+                    f"{ROOT_DIR}[image]",
+                    "-q",
+                ],
+                check=True,
+            )
+
+        print("=" * 64)
+        print("🔍 STEP 3: Verifying installed console script binaries...")
+        print("=" * 64)
+        print(f"✓ speiidev binary:   {speiidev_bin}")
+        print(f"✓ block-font binary: {block_font_bin}")
+
+        print("")
+        print("=" * 64)
+        print("🚀 STEP 4: Executing real installed entrypoints...")
+        print("=" * 64)
+        print("Testing 'speiidev --font \"SPEIIDEV\"'...")
+        subprocess.run([str(speiidev_bin), "--font", "SPEIIDEV"], check=True)
+
+        print("")
+        print("Testing 'block-font \"REAL INSTALL OK\"'...")
+        subprocess.run([str(block_font_bin), "REAL INSTALL OK"], check=True)
+
+        print("")
+        print("=" * 64)
+        print("🧪 STEP 5: Running full automated unit test suite inside sandbox...")
+        print("=" * 64)
+        test_proc = subprocess.run(
+            [
+                str(python_bin),
+                "-m",
+                "unittest",
+                "discover",
+                "-s",
+                str(ROOT_DIR / "tests"),
+                "-v",
+            ]
+        )
+        if test_proc.returncode != 0:
+            return test_proc.returncode
+
+        print("")
+        print("=" * 64)
+        print("✅ ALL REAL-INSTALL CHECKS PASSED SUCCESSFULLY!")
+        print("=" * 64)
+        print(f"🧹 Automatically cleaning up sandbox: {tmp_dir}...")
+
+    print("✨ Done! Zero changes made to your system environment.")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())