refactor(install): improve bootstrap and installer architecture

- Move PostgreSQL repo setup from bootstrap.sh to Python installers
module
- Add odoo_minimal.toml for bootstrap initial setup
- Replace pnpm references with npm for better compatibility
- Improve error handling with graceful degradation for missing tools
- Update .gitignore to exclude .claude/ and .opencode/ directories
- Simplify bootstrap.sh by removing inline PostgreSQL setup logic

Breaking changes:
- NPM packages installed via npm instead of pnpm by default

Author: trisdoan

.gitignore

@@ -219,3 +219,5 @@ __marimo__/
 plans/**/*
 !plans/templates/*
 repomix-output.xml
+.claude/
+.opencode/

assets/odoo_minimal.toml

@@ -0,0 +1,10 @@
+# Minimal config to set up latest Odoo for development
+# Place this file at ~/code/config.toml (or set TLC_CODE_DIR)
+
+versions = ["18.0"]
+
+[tools]
+uv = ["odoo-venv"]
+
+[repos]
+odoo = ["odoo"]

bootstrap.sh

@@ -4,7 +4,8 @@ export DEBIAN_FRONTEND=noninteractive
 export PATH="$HOME/.local/bin:$PATH"
 
 # Bootstrap script for trobz_local (tlc)
-# Installs: uv, git, gh, and the trobz_local package
+# Installs prerequisites: git, gh, uv, and trobz_local CLI
+# Note: Tool installation (Odoo, PostgreSQL, etc.) is done separately via `tlc install-tools`
 
 echo "=== Bootstrap trobz_local ==="
 
@@ -41,33 +42,6 @@ detect_os() {
 OS=$(detect_os)
 echo "Detected OS: $OS"
 
-# Install prerequisite packages (Debian/Ubuntu only)
-install_prerequisites() {
-    if [[ "$OS" != "debian" ]]; then
-        return
-    fi
-    echo "Installing prerequisite packages..."
-    sudo apt-get update
-    sudo apt-get install -y apt-utils apt-transport-https lsb-release
-}
-
-# Add PostgreSQL APT repository (Debian/Ubuntu only)
-setup_postgresql_repo() {
-    if [[ "$OS" != "debian" ]]; then
-        return
-    fi
-    if [ -f /usr/share/keyrings/postgresql-keyring.gpg ]; then
-        echo "PostgreSQL APT repository already configured"
-        return
-    fi
-    echo "Adding PostgreSQL APT repository..."
-    local codename
-    codename=$(lsb_release -cs)
-    curl -fsSL https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo gpg --dearmor -o /usr/share/keyrings/postgresql-keyring.gpg
-    echo "deb [arch=amd64 signed-by=/usr/share/keyrings/postgresql-keyring.gpg] https://apt.postgresql.org/pub/repos/apt ${codename}-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list > /dev/null
-    sudo apt-get update
-}
-
 # Install git
 install_git() {
     if command -v git &>/dev/null; then
@@ -132,9 +106,7 @@ install_trobz_local() {
     echo "trobz_local installed (CLI: tlc)"
 }
 
-# Main
-install_prerequisites
-setup_postgresql_repo
+# Main execution
 install_git
 install_gh
 install_uv
@@ -143,4 +115,23 @@ install_trobz_local
 
 echo ""
 echo "=== Bootstrap complete ==="
-echo "Run 'tlc --help' to get started"
+echo ""
+echo "Prerequisites installed successfully!"
+echo "  ✓ git"
+echo "  ✓ gh (GitHub CLI)"
+echo "  ✓ uv"
+echo "  ✓ trobz_local (tlc command available)"
+echo ""
+echo "Next steps:"
+echo ""
+echo "  1. Install development tools (Odoo, PostgreSQL, etc.):"
+echo "     tlc install-tools"
+echo ""
+echo "  2. Initialize your development environment:"
+echo "     tlc init              # Create directory structure"
+echo "     tlc pull-repos        # Clone repositories"
+echo "     tlc create-venvs      # Create virtual environments"
+echo ""
+echo "  3. Get help:"
+echo "     tlc --help"
+echo ""

docs/code-standards.md

@@ -23,6 +23,7 @@ Four-layer modular design with clear separation of concerns:
 - **Line Length**: Max 120 characters (ruff.toml config)
 - **Import Order**: stdlib → third-party → local (ruff-managed)
 - **Active Rules**: YTT, S (security), B, A, C4, T10, SIM, I, C90, E, W, F, PGH, UP, RUF, TRY
+- **UI Library**: Rich (progress bars, colored output, trees)
 
 ### Type Safety (Mandatory)
 - All function signatures must have type hints
@@ -170,11 +171,11 @@ Follow [Conventional Commits](https://www.conventionalcommits.org/):
 
 ## File Structure
 
-**Max file size**: 500 LOC (split if larger)
-- `main.py`: CLI commands and orchestration (473+ LOC)
-- `installers.py`: Installation strategies (282 LOC)
-- `postgres.py`: PostgreSQL user management (191 LOC)
-- `utils.py`: Config, platform detection, helpers (264 LOC)
+**Target file size**: 500 LOC; main.py at 523 LOC is exception due to command density.
+- `main.py`: CLI commands and orchestration (523 LOC - consolidates 5 command implementations)
+- `installers.py`: Installation strategies (389 LOC - 5 installation strategies)
+- `postgres.py`: PostgreSQL user management (173 LOC)
+- `utils.py`: Config, platform detection, helpers (277 LOC)
 - `concurrency.py`: Task runner with progress (60 LOC)
 - `exceptions.py`: Custom exception classes (38 LOC)
 - `tests/`: pytest unit tests for all modules

docs/codebase-summary.md

@@ -6,8 +6,9 @@ Technical overview of the `trobz_local` codebase structure, implementation patte
 
 | Metric | Value |
 |---|---|
-| **Language** | Python 3.12+ |
-| **Total LOC** | ~1,287 lines (core logic) + tests |
+| **Version** | 0.2.0 |
+| **Language** | Python 3.10+ |
+| **Total LOC** | ~1,460 lines (core logic) + tests |
 | **Core Modules** | 7 files (main, installers, utils, postgres, concurrency, exceptions, \__init\_\_) |
 | **Test Modules** | tests/ directory with pytest unit tests |
 | **Primary Frameworks** | Typer (CLI), Pydantic (validation), Rich (UI), GitPython (git) |
@@ -16,14 +17,15 @@ Technical overview of the `trobz_local` codebase structure, implementation patte
 
 ## Module Breakdown
 
-### `main.py` (473+ LOC)
+### `main.py` (523 LOC)
 **Purpose**: CLI entry point and command orchestration
 
 **Responsibilities**:
 - Define Typer application with 5 main commands
 - Manage "newcomer mode" state (interactive confirmations)
 - Orchestrate calls to installers, git operations, venv creation, and PostgreSQL user management
 - Handle user interaction and progress reporting
+- Coordinate PostgreSQL repo setup before system package installation
 
 **Key Commands**:
 - `init`: Create directory structure
@@ -43,18 +45,20 @@ Technical overview of the `trobz_local` codebase structure, implementation patte
 
 ---
 
-### `installers.py` (282 LOC)
+### `installers.py` (389 LOC)
 **Purpose**: Multi-source tool installation strategies
 
 **Strategies**:
-1. **Scripts**: Download via wget/curl, execute with /bin/sh
-2. **System Packages**: OS-aware (apt-get, pacman, brew) with platform defaults
-3. **NPM Packages**: Global via pnpm install -g
-4. **UV Tools**: Global via uv tool install
+1. **PostgreSQL Repository Setup**: Idempotent APT repo configuration with GPG verification (Debian/Ubuntu)
+2. **Scripts**: Download via wget/curl, execute with /bin/sh
+3. **System Packages**: OS-aware (apt-get, pacman, brew) with platform defaults
+4. **NPM Packages**: Global via pnpm install -g
+5. **UV Tools**: Global via uv tool install
 
 **Key Functions**:
+- `setup_postgresql_repo()` - Configure PGDG repository with GPG verification (idempotent)
 - `install_scripts()` - Download and execute shell scripts with progress
-- `install_system_packages()` - OS detection and package manager invocation
+- `install_system_packages()` - OS detection and package manager invocation (runs after PostgreSQL repo setup)
 - `install_npm_packages()` - Parallel npm package installation
 - `install_uv_tools()` - Parallel UV tool installation
 
@@ -66,7 +70,7 @@ Technical overview of the `trobz_local` codebase structure, implementation patte
 
 ---
 
-### `utils.py` (264 LOC)
+### `utils.py` (277 LOC)
 **Purpose**: Configuration validation, platform detection, utilities
 
 **Pydantic Models**:
@@ -127,7 +131,7 @@ class TaskResult:
 
 ---
 
-### `postgres.py` (191 LOC)
+### `postgres.py` (173 LOC)
 **Purpose**: PostgreSQL user management for Odoo development
 
 **Responsibilities**:
@@ -202,7 +206,9 @@ The `get_code_root()` function (utils.py) resolves the code root directory by:
 | `rich` | Latest | Terminal UI (progress bars, colors, trees) |
 | `gitpython` | Latest | Programmatic git operations |
 | `tomllib` | Built-in (Python 3.11+) | TOML parsing for Python 3.11+ |
-| `tomli` | Latest (optional) | TOML parsing fallback for Python < 3.11 |
+| `tomli` | Latest | TOML parsing fallback for Python < 3.11 |
+
+**Note**: Rich is used extensively throughout for progress bars, colored output, and tree display.
 
 ---
 

docs/project-overview-pdr.md

@@ -22,6 +22,23 @@ The tool uses declarative configuration: developers specify desired environment
 
 ## Core Features
 
+### 0. Bootstrap Script (`bootstrap.sh`)
+Automated installation of prerequisites before using `tlc`:
+- **Dependencies**: Installs git, gh (GitHub CLI), and uv
+- **SSH Setup**: Configures GitHub SSH keys in known_hosts
+- **Installation**: Installs `trobz_local` CLI (tlc) via uv
+- **Idempotent**: Skips already-installed tools
+- **OS-aware**: Supports macOS (brew), Debian/Ubuntu (apt), Fedora (dnf), Arch (pacman)
+
+**Usage**:
+```bash
+curl -fsSL https://raw.githubusercontent.com/trobz/local.py/main/bootstrap.sh | sh
+```
+
+After bootstrap, use `tlc` commands to complete environment setup.
+
+---
+
 ### 1. Environment Initialization (`init`)
 Creates standardized directory structure (default: `~/code/`):
 ```
@@ -46,11 +63,12 @@ Clones or updates Odoo and OCA repositories:
 - **Operations**: Clone new repos, fetch and hard-reset existing ones
 
 ### 3. Tool Installation (`install-tools`)
-Four-stage installation pipeline:
-1. **Shell Scripts**: Download and execute scripts (e.g., uv installer)
-2. **System Packages**: OS-aware installation via apt/pacman/brew
-3. **NPM Packages**: Global packages via pnpm
-4. **UV Tools**: Python tools via uv tool install
+Five-stage installation pipeline:
+1. **PostgreSQL Repository** (Debian/Ubuntu only): Setup PGDG APT repository with GPG verification (idempotent)
+2. **Shell Scripts**: Download and execute scripts (e.g., uv installer)
+3. **System Packages**: OS-aware installation via apt/pacman/brew (runs after PostgreSQL repo setup on Debian/Ubuntu)
+4. **NPM Packages**: Global packages via pnpm
+5. **UV Tools**: Python tools via uv tool install
 
 ### 4. Virtual Environment Management (`create-venvs`)
 Creates Odoo-specific environments:
@@ -278,7 +296,7 @@ Create Python virtual environments for each Odoo version.
 ---
 
 ### `tlc install-tools`
-Install tools from four sources in order: scripts, system packages, npm, uv.
+Install tools from five sources in order: PostgreSQL repo, scripts, system packages, npm, uv.
 
 **Usage**: `tlc install-tools [OPTIONS]`
 
@@ -287,10 +305,11 @@ Install tools from four sources in order: scripts, system packages, npm, uv.
 - `--newcomer / --no-newcomer`: Enable interactive mode (default: True)
 
 **Execution Order**:
-1. **Scripts**: Download and execute via `wget` or `curl`, then `sh`
-2. **System Packages**: OS-aware installation (apt/pacman/brew)
-3. **NPM Packages**: Global installation via `pnpm install -g`
-4. **UV Tools**: Global installation via `uv tool install`
+1. **PostgreSQL Repository** (Debian/Ubuntu): Setup PGDG APT repository with GPG verification
+2. **Scripts**: Download and execute via `wget` or `curl`, then `sh`
+3. **System Packages**: OS-aware installation (apt/pacman/brew) - runs after PostgreSQL repo on Debian/Ubuntu
+4. **NPM Packages**: Global installation via `pnpm install -g`
+5. **UV Tools**: Global installation via `uv tool install`
 
 **Behavior**:
 - Reads `[tools]` section from `{CODE_ROOT}/config.toml` (default: `~/code/config.toml`)