gemiterm 2.0.0 → 2.1.0

package/examples/sample_markdown_export.md

@@ -1,221 +0,0 @@
-<!-- conversation_id: sample_conversation_123 -->
----
-title: "Python Code Review Session"
-export_date: "2026-03-21 14:30:00"
-message_count: 6
----
-
-# Python Code Review Session
-
-**User:**
-
-Can you review this Python function for best practices?
-
-```python
-def get_data(url, params={}):
-    response = requests.get(url, params)
-    return response.json()
-```
-
-**Gemini:**
-
-<small>2026-03-21 14:30:15</small>
-
-I'll review your function for best practices. Here are some suggestions:
-
-## 1. Add Type Hints
-
-```python
-import requests
-from typing import Any
-
-def get_data(url: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
-    if params is None:
-        params = {}
-    response = requests.get(url, params=params)
-    response.raise_for_status()
-    return response.json()
-```
-
-## 2. Handle Errors Gracefully
-
-Consider catching potential exceptions:
-
-```python
-def get_data(url: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
-    try:
-        response = requests.get(url, params=params or {})
-        response.raise_for_status()
-        return response.json()
-    except requests.RequestException as e:
-        raise RuntimeError(f"Failed to fetch data: {e}") from e
-```
-
-## 3. Add Docstring
-
-```python
-def get_data(url: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
-    """Fetch JSON data from a URL.
-
-    Args:
-        url: The endpoint URL to request.
-        params: Optional query parameters.
-
-    Returns:
-        The JSON response as a dictionary.
-
-    Raises:
-        RuntimeError: If the request fails.
-    """
-    ...
-```
-
-## Key Improvements Summary
-
-| Issue | Original | Improved |
-|-------|----------|----------|
-| Mutable default | `params={}` | `params=None` |
-| Type hints | Missing | Full type annotations |
-| Error handling | None | raise_for_status() + try/except |
-| Docstring | None | Google-style docstring |
-
-**User:**
-
-Thanks! What about adding a timeout parameter?
-
-**Gemini:**
-
-<small>2026-03-21 14:31:00</small>
-
-Good idea! Here's the updated version with timeout:
-
-```python
-import requests
-from typing import Any
-
-def get_data(
-    url: str,
-    params: dict[str, Any] | None = None,
-    timeout: float | tuple[float, float] = 5.0
-) -> dict[str, Any]:
-    """Fetch JSON data from a URL with timeout support.
-
-    Args:
-        url: The endpoint URL to request.
-        params: Optional query parameters.
-        timeout: Request timeout in seconds. Can be a single value
-                 or tuple (connect_timeout, read_timeout).
-
-    Returns:
-        The JSON response as a dictionary.
-
-    Raises:
-        RuntimeError: If the request fails or times out.
-    """
-    try:
-        response = requests.get(url, params=params or {}, timeout=timeout)
-        response.raise_for_status()
-        return response.json()
-    except requests.Timeout:
-        raise RuntimeError(f"Request timed out after {timeout}s") from None
-    except requests.RequestException as e:
-        raise RuntimeError(f"Failed to fetch data: {e}") from e
-```
-
-**Usage Examples:**
-
-```python
-# Basic usage
-data = get_data("https://api.example.com/users")
-
-# With query params
-data = get_data("https://api.example.com/search", {"q": "python"})
-
-# With custom timeout (10 seconds)
-data = get_data("https://api.example.com/slow", timeout=10.0)
-
-# With separate connect/read timeouts
-data = get_data("https://api.example.com/", timeout=(2.0, 10.0))
-```
-
-The timeout parameter prevents your application from hanging indefinitely on slow or unresponsive endpoints.
-
-**User:**
-
-Perfect! One more question - how would you add retry logic with exponential backoff?
-
-**Gemini:**
-
-<small>2026-03-21 14:32:30</small>
-
-Here's an implementation with retry logic using exponential backoff:
-
-```python
-import requests
-import time
-from typing import Any
-
-def get_data_with_retry(
-    url: str,
-    params: dict[str, Any] | None = None,
-    max_retries: int = 3,
-    base_delay: float = 1.0,
-    max_delay: float = 30.0
-) -> dict[str, Any]:
-    """Fetch JSON data with automatic retry on failure.
-
-    Args:
-        url: The endpoint URL to request.
-        params: Optional query parameters.
-        max_retries: Maximum number of retry attempts.
-        base_delay: Initial delay between retries in seconds.
-        max_delay: Maximum delay cap between retries.
-
-    Returns:
-        The JSON response as a dictionary.
-
-    Raises:
-        RuntimeError: If all retry attempts fail.
-    """
-    last_exception: Exception | None = None
-
-    for attempt in range(max_retries + 1):
-        try:
-            response = requests.get(url, params=params or {}, timeout=5.0)
-            response.raise_for_status()
-            return response.json()
-        except (requests.Timeout, requests.ConnectionError) as e:
-            last_exception = e
-            if attempt < max_retries:
-                delay = min(base_delay * (2 ** attempt), max_delay)
-                time.sleep(delay)
-        except requests.RequestException as e:
-            raise RuntimeError(f"Request failed: {e}") from e
-
-    raise RuntimeError(f"All {max_retries} retries exhausted") from last_exception
-```
-
-## Retry Strategy Visualization
-
-```
-Attempt 1: Immediate
-Attempt 2: Wait 1s
-Attempt 3: Wait 2s
-Attempt 4: Wait 4s
-... (capped at max_delay)
-```
-
-## When to Use Retries
-
-| Scenario | Retry? | Reason |
-|----------|--------|--------|
-| Connection error | Yes | Temporary network issue |
-| Timeout | Yes | Server may be temporarily busy |
-| 404 Not Found | No | Resource doesn't exist |
-| 500 Server Error | Yes | Temporary server issue |
-| 401 Unauthorized | No | Credentials are invalid |
-
-This pattern is especially useful for:
-- Production APIs with reliability requirements
-- Batch operations processing many requests
-- Microservices communicating over networks

package/examples/usage_examples.sh

@@ -1,222 +0,0 @@
-#!/bin/bash
-# Usage Examples for gemiterm
-# This script demonstrates common workflows and commands
-
-set -e
-
-echo "========================================"
-echo "gemiterm Usage Examples"
-echo "========================================"
-
-#------------------------------------------
-# SECTION 1: First-Time Setup
-#------------------------------------------
-section1() {
-    echo ""
-    echo "=== Section 1: First-Time Setup ==="
-    echo ""
-
-    # Install the CLI
-    echo "1. Install gemiterm:"
-    echo "   pip install -e ."
-    echo ""
-
-    # Install browser dependencies
-    echo "2. Install Chromium for Playwright:"
-    echo "   playwright install chromium"
-    echo ""
-
-    # Authenticate
-    echo "3. Authenticate with Google:"
-    echo "   gemiterm auth"
-    echo "   # Opens browser window for login"
-    echo ""
-
-    # Verify authentication
-    echo "4. Verify authentication status:"
-    echo "   gemiterm status"
-    echo "   # Shows: Authenticated: True"
-    echo ""
-}
-
-#------------------------------------------
-# SECTION 2: Daily Usage Workflows
-#------------------------------------------
-section2() {
-    echo ""
-    echo "=== Section 2: Daily Usage ==="
-    echo ""
-
-    # Check status
-    echo "1. Check authentication status:"
-    echo "   gemiterm status"
-    echo ""
-
-    # List recent chats
-    echo "2. List your recent chats:"
-    echo "   gemiterm list"
-    echo "   # Shows table of conversations"
-    echo ""
-
-    # List with limit
-    echo "3. List specific number of chats:"
-    echo "   gemiterm list -n 5"
-    echo "   # Shows 5 most recent chats"
-    echo ""
-
-    # Fetch a specific chat
-    echo "4. View a conversation's history:"
-    echo "   gemiterm fetch <conversation_id>"
-    echo "   # Example:"
-    echo "   gemiterm fetch abc123xyz"
-    echo ""
-
-    # Continue a conversation
-    echo "5. Send a message to existing chat:"
-    echo "   gemiterm continue <conversation_id> <message>"
-    echo "   # Example:"
-    echo "   gemiterm continue abc123xyz \"Continue my previous thought\""
-    echo ""
-}
-
-#------------------------------------------
-# SECTION 3: Export for Backup
-#------------------------------------------
-section3() {
-    echo ""
-    echo "=== Section 3: Export for Backup ==="
-    echo ""
-
-    # Export single chat
-    echo "1. Export a single conversation to Markdown:"
-    echo "   gemiterm export <conversation_id>"
-    echo "   # Creates: gemini-chat-{id}-{date}.md"
-    echo ""
-
-    # Export with custom output
-    echo "2. Export with custom output path:"
-    echo "   gemiterm export <conversation_id> -o my-chat.md"
-    echo ""
-
-    # Export as JSON
-    echo "3. Export as JSON format:"
-    echo "   gemiterm export <conversation_id> -f json"
-    echo ""
-
-    # Export with metadata
-    echo "4. Export with full metadata:"
-    echo "   gemiterm export <conversation_id> --include-metadata"
-    echo ""
-
-    # Batch export all
-    echo "5. Export all conversations:"
-    echo "   gemiterm export-all"
-    echo "   # Creates ./exports/ with all chats"
-    echo ""
-
-    # Export to specific directory
-    echo "6. Export to custom directory:"
-    echo "   gemiterm export-all -o ./my-backups/"
-    echo ""
-
-    # Export recent only
-    echo "7. Export only recent conversations:"
-    echo "   gemiterm export-all --since 2026-03-01"
-    echo ""
-}
-
-#------------------------------------------
-# SECTION 4: Error Scenarios
-#------------------------------------------
-section4() {
-    echo ""
-    echo "=== Section 4: Error Handling ==="
-    echo ""
-
-    # Not authenticated
-    echo "1. If not authenticated:"
-    echo "   $ gemiterm list"
-    echo "   Error: Not authenticated. Run 'gemiterm auth' first."
-    echo "   $ gemiterm auth"
-    echo ""
-
-    # Session expired
-    echo "2. If session expired:"
-    echo "   $ gemiterm status"
-    echo "   Error: Session expired. Please re-authenticate."
-    echo "   $ gemiterm auth"
-    echo ""
-
-    # Conversation not found
-    echo "3. If conversation doesn't exist:"
-    echo "   $ gemiterm fetch nonexistent-id"
-    echo "   Error: Conversation 'nonexistent-id' not found."
-    echo "   Run 'gemiterm list' to see available conversations."
-    echo ""
-
-    # Verbose debugging
-    echo "4. Debug with verbose output:"
-    echo "   gemiterm -v status"
-    echo "   # Shows detailed logs"
-    echo ""
-}
-
-#------------------------------------------
-# SECTION 5: Configuration
-#------------------------------------------
-section5() {
-    echo ""
-    echo "=== Section 5: Configuration ==="
-    echo ""
-
-    # Custom config directory
-    echo "1. Use custom config directory:"
-    echo "   export GEMITERM_CONFIG_DIR=/path/to/config"
-    echo "   gemiterm auth"
-    echo ""
-
-    # Verbose mode
-    echo "2. Enable verbose logging:"
-    echo "   export GEMITERM_VERBOSE=true"
-    echo "   gemiterm list"
-    echo ""
-
-    # View config location
-    echo "3. Default config location:"
-    echo "   ~/gemiterm/"
-    echo "   Contains:"
-    echo "   - storage_state.json (cookies)"
-    echo "   - config (future use)"
-    echo ""
-}
-
-#------------------------------------------
-# SECTION 6: Demo Script
-#------------------------------------------
-section6() {
-    echo ""
-    echo "=== Section 6: Using the Demo Script ==="
-    echo ""
-
-    echo "Run the demo script to see a complete workflow:"
-    echo "   python scripts/demo.py"
-    echo ""
-    echo "Demo script:"
-    echo "1. Loads cookies"
-    echo "2. Fetches chat list"
-    echo "3. Shows 5 most recent chats"
-    echo "4. Appends message to most recent chat"
-    echo ""
-}
-
-# Run all sections
-section1
-section2
-section3
-section4
-section5
-section6
-
-echo "========================================"
-echo "For more help: gemiterm --help"
-echo "========================================"

package/install.ps1

@@ -1,264 +0,0 @@
-#Requires -Version 7.0
-<#
-.SYNOPSIS
-    GemiTerm v2.0.0 installer for Windows.
-
-.DESCRIPTION
-    v1.4.1 → v2.0.0 upgrades replace the binary in place; the config dir at
-    %APPDATA%\gemiterm\ (Windows) is NEVER deleted by this installer.
-
-.PARAMETER Tag
-    GitHub release tag to install (default: "latest").
-
-.PARAMETER Uninstall
-    Remove GemiTerm binary and PATH entry. Preserves config dir at
-    %APPDATA%\gemiterm\.
-
-.PARAMETER WhatIf
-    Show what the installer would do without making any changes.
-
-.PARAMETER InstallDir
-    Override the default install directory (default: $env:LOCALAPPDATA\GemiTerm).
-
-.EXAMPLE
-    irm https://github.com/expert-vision-software/GemiTerm/releases/latest/download/install.ps1 | iex
-    pwsh -File install.ps1 -Tag v2.0.0-rc.1
-    pwsh -File install.ps1 -Uninstall
-    pwsh -File install.ps1 -WhatIf
-#>
-param(
-    [string]$Tag = 'latest',
-    [switch]$Uninstall,
-    [switch]$WhatIf,
-    [string]$InstallDir = "$env:LOCALAPPDATA\GemiTerm"
-)
-
-$ErrorActionPreference = 'Stop'
-
-$Repo = 'expert-vision-software/GemiTerm'
-$ExePath = Join-Path $InstallDir 'GemiTerm.exe'
-
-# --- Detect Python v1.4.1 (task 8.1) ---
-if (Get-Command pip -ErrorAction SilentlyContinue) {
-    try {
-        $null = pip show gemiterm 2>$null
-        if ($LASTEXITCODE -eq 0) {
-            Write-Host "WARNING: Python v1.4.1 detected. Your config data at %APPDATA%\gemiterm\ is safe and will be preserved. Please run 'pip uninstall gemiterm' before re-running this installer to complete the v2.0.0 installation."
-            exit 1
-        }
-    } catch {
-        # pip show returned non-zero — gemiterm not installed via pip
-    }
-}
-
-# --- Uninstall (task 2.2) ---
-if ($Uninstall) {
-    Write-Host "Removing GemiTerm..."
-
-    if (Test-Path $ExePath) {
-        if ($WhatIf) {
-            Write-Host "[WhatIf] Would delete $ExePath"
-        } else {
-            Remove-Item $ExePath -Force
-            Write-Host "  Removed $ExePath"
-        }
-    } else {
-        Write-Host "  $ExePath not found (already removed)"
-    }
-
-    $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
-    if ($userPath -and $userPath.ToLower().Contains($InstallDir.ToLower())) {
-        $newPath = ($userPath -split ';' | Where-Object { $_ -and $_.ToLower() -ne $InstallDir.ToLower() }) -join ';'
-        if ($WhatIf) {
-            Write-Host "[WhatIf] Would remove $InstallDir from user PATH"
-        } else {
-            [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
-            Write-Host "  Removed $InstallDir from PATH"
-        }
-    }
-
-    if ($WhatIf) {
-        Write-Host "[WhatIf] Would update current session PATH"
-    } else {
-        $env:Path = ($env:Path -split ';' | Where-Object { $_ -and $_.ToLower() -ne $InstallDir.ToLower() }) -join ';'
-    }
-
-    Write-Host "GemiTerm uninstall review complete. No changes were made." -ForegroundColor Cyan
-    exit 0
-}
-
-# --- Upgrade detection (task 2.3) ---
-if (Test-Path $ExePath) {
-    Write-Host "Detected existing install at $ExePath; upgrading in place."
-}
-
-# --- v1.4.1 → v2.0.0 config migration (task 11.1) ---
-# v1.4.1 wrote config to $env:USERPROFILE\.config\gemiterm\ on Windows
-# (Python config.py:14 has no Windows branch; Path.home() returns the
-# user profile and the literal ".config/gemiterm" is appended). v2.0.0
-# reads from $env:APPDATA\gemiterm\. If the old path exists and the new
-# one does not, copy the tree forward. The v1.4.1 directory is left in
-# place as a safety net; the user can delete it manually.
-$V14ConfigDir = Join-Path $env:USERPROFILE '.config\gemiterm'
-$V2ConfigDir = Join-Path $env:APPDATA 'gemiterm'
-if ((Test-Path $V14ConfigDir) -and -not (Test-Path $V2ConfigDir)) {
-    Write-Host "Detected v1.4.1 config at $V14ConfigDir; migrating to $V2ConfigDir"
-    if ($WhatIf) {
-        Write-Host "[WhatIf] Would create directory $V2ConfigDir"
-        Write-Host "[WhatIf] Would copy $V14ConfigDir\* to $V2ConfigDir"
-    } else {
-        New-Item -ItemType Directory -Path $V2ConfigDir -Force | Out-Null
-        Copy-Item -Recurse -Force -Path (Join-Path $V14ConfigDir '*') -Destination $V2ConfigDir
-        Write-Host "v1.4.1 config copied to $V2ConfigDir. The original at $V14ConfigDir is left in place as a backup."
-    }
-}
-
-# Determine package-manager executable (prefer bunx over npx)
-$PackageManagerX = if (Get-Command bun -ErrorAction SilentlyContinue) { 'bunx' } elseif (Get-Command npm -ErrorAction SilentlyContinue) { 'npx' } else { 'bunx' }
-
-# --- Package-manager prompt (task 11.2) ---
-# If bun or npm is on PATH, recommend installing via the package manager
-# (npm: `npm i -g gemiterm`; bun: `bun i -g gemiterm`) instead of this
-# binary drop. The prompt is skipped when stdin is not a TTY (e.g. the
-# `irm | iex` one-liner flow runs unattended and must not block).
-if (((Get-Command bun -ErrorAction SilentlyContinue) -or (Get-Command npm -ErrorAction SilentlyContinue)) -and [Console]::IsInputRedirected -eq $false) {
-    Write-Host ""
-    Write-Host "It is recommended to install via bun or npm package manager."
-    Write-Host "Are you sure you want to continue with binary install? [y/N]"
-    $reply = Read-Host
-    if ($reply -notmatch '^[yY]([eE][sS])?$') {
-        $pm = if (Get-Command bun -ErrorAction SilentlyContinue) { 'bun i -g gemiterm' } else { 'npm i -g gemiterm' }
-        Write-Host "Aborted. Install via: $pm"
-        exit 0
-    }
-}
-
-# --- Resolve release (task 2.4 + 2.10) ---
-$ApiUrl = if ($Tag -eq 'latest') {
-    "https://api.github.com/repos/$Repo/releases/latest"
-} else {
-    "https://api.github.com/repos/$Repo/releases/tags/$Tag"
-}
-
-$release = $null
-try {
-    $release = Invoke-RestMethod $ApiUrl -TimeoutSec 30
-} catch {
-    Write-Host "Cannot reach GitHub releases. Check your network connection or use the 'build from source' instructions in docs/INSTALL.md."
-    exit 1
-}
-
-if (-not $release -or -not $release.assets) {
-    Write-Host "No releases found."
-    Write-Host "Build from source: git clone https://github.com/$Repo.git && cd GemiTerm && bun install && bun run build"
-    exit 1
-}
-
-$asset = $release.assets | Where-Object { $_.name -eq 'gemiterm.exe' }
-if (-not $asset) {
-    Write-Host "No gemiterm.exe asset found in release."
-    exit 1
-}
-
-$version = $release.tag_name
-
-# --- Download (task 2.5) ---
-if (-not (Test-Path $InstallDir)) {
-    if ($WhatIf) {
-        Write-Host "[WhatIf] Would create directory $InstallDir"
-    } else {
-        New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null
-    }
-}
-
-$tempPath = Join-Path $InstallDir 'GemiTerm.exe.new'
-if ($WhatIf) {
-    Write-Host "[WhatIf] Would download GemiTerm $version from $($asset.browser_download_url) to $tempPath"
-    Write-Host "[WhatIf] Would move $tempPath to $ExePath"
-} else {
-    try {
-        Write-Host "Downloading GemiTerm $version..."
-        Invoke-WebRequest $asset.browser_download_url -OutFile $tempPath
-        Move-Item -Force $tempPath $ExePath
-    } catch {
-        if (Test-Path $tempPath) { Remove-Item $tempPath -Force -ErrorAction SilentlyContinue }
-        Write-Host "Download failed: $_"
-        exit 1
-    }
-}
-
-# --- Bootstrap package manager if needed (task 9.1 + 9.3) ---
-if ($PackageManagerX -eq 'bunx' -and -not (Get-Command bun -ErrorAction SilentlyContinue)) {
-    if ($WhatIf) {
-        Write-Host "[WhatIf] Would install Bun from https://bun.sh/install.ps1"
-    } else {
-        Write-Host "Installing Bun..."
-        try {
-            irm https://bun.sh/install.ps1 | iex
-        } catch {
-            if (Get-Command npm -ErrorAction SilentlyContinue) {
-                Write-Host "Bun installation failed, falling back to npx."
-                $PackageManagerX = 'npx'
-            } else {
-                Write-Host "Bun installation failed and npm is not available. Install Bun from https://bun.sh or npm from https://nodejs.org and re-run this installer."
-                exit 1
-            }
-        }
-        if ($PackageManagerX -eq 'bunx' -and -not (Get-Command bun -ErrorAction SilentlyContinue)) {
-            if (Get-Command npm -ErrorAction SilentlyContinue) {
-                Write-Host "Bun installation failed, falling back to npx."
-                $PackageManagerX = 'npx'
-            } else {
-                Write-Host "Bun installation failed. Install Bun manually from https://bun.sh and re-run this installer."
-                exit 1
-            }
-        }
-    }
-}
-
-# --- Install Chromium (task 2.6) ---
-if ($WhatIf) {
-    Write-Host "[WhatIf] Would run: $PackageManagerX @playwright/cli install chromium"
-} else {
-    Write-Host "Installing Chromium browser for Playwright..."
-    try {
-        & $PackageManagerX @playwright/cli install chromium
-        if ($LASTEXITCODE -ne 0) {
-            throw "$PackageManagerX exited with code $LASTEXITCODE"
-        }
-    } catch {
-        Write-Host "Chromium installation failed. Re-run the installer after fixing the issue, or run '$PackageManagerX @playwright/cli install chromium' manually."
-        exit 1
-    }
-}
-
-# --- Verify Chromium (task 2.7) ---
-$chromeExe = Get-ChildItem "$env:LOCALAPPDATA\ms-playwright\chromium-*\chrome.exe" -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1
-if ($chromeExe) {
-    Write-Host "Chromium verified at $($chromeExe.FullName)"
-} else {
-    Write-Host "Chromium installation verification failed. Re-run the installer after fixing the network, or run '$PackageManagerX @playwright/cli install chromium' manually."
-    exit 1
-}
-
-# --- PATH augmentation (task 2.8) ---
-$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
-if ($userPath -and -not $userPath.ToLower().Contains($InstallDir.ToLower())) {
-    if ($WhatIf) {
-        Write-Host "[WhatIf] Would add $InstallDir to user PATH"
-    } else {
-        [Environment]::SetEnvironmentVariable('Path', "$userPath;$InstallDir", 'User')
-        $env:Path = "$env:Path;$InstallDir"
-        Write-Host "Added $InstallDir to PATH"
-    }
-}
-
-# --- Success (task 2.9) ---
-if ($WhatIf) {
-    Write-Host ""
-    Write-Host "WhatIf review complete. No changes were made." -ForegroundColor Cyan
-    Write-Host "GemiTerm $version would be installed to $ExePath using $($PackageManagerX).Chromium."
-    Write-Host "Run without -WhatIf to apply."
-} else {
-    Write-Host "GemiTerm $version installed to $ExePath. Run 'gemiterm status' to verify, then 'gemiterm auth' to authenticate."
-}