terrascout 0.1.0__tar.gz

terrascout-0.1.0/.gitignore

@@ -0,0 +1,48 @@
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+venv/
+.venv/
+*.egg-info/
+dist/
+build/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Node (frontend)
+node_modules/
+frontend/dist/
+
+# Docker
+*.log
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Playwright
+frontend/e2e/screenshots/
+frontend/playwright-report/
+frontend/test-results/
+docs/screenshots/
+
+# Distribution
+*.egg
+*.whl

terrascout-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: terrascout
+Version: 0.1.0
+Summary: Terrascout CLI — geospatial data scoping from the terminal
+Project-URL: Homepage, http://130.162.194.71
+Project-URL: Documentation, http://130.162.194.71/integrations
+Project-URL: Release Notes, http://130.162.194.71/integrations
+Project-URL: Support, http://130.162.194.71/integrations
+Author-email: Mazdak Ghasemi Tootkaboni <maz@terrascout.dev>
+License: Proprietary
+Keywords: cli,earth-observation,geospatial,remote-sensing,satellite,terrascout
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# Terrascout CLI
+
+Geospatial data scoping from the terminal. Find the best satellite imagery and spatial datasets for your project — ranked, scored, and assessed for feasibility.
+
+Powered by [Terrascout](http://130.162.194.71).
+
+## Install
+
+```bash
+pip install terrascout
+```
+
+Requires Python 3.11+. No API key needed for free-tier features.
+
+## Quick Start
+
+```bash
+# Check connectivity to Terrascout API
+terrascout health
+
+# Create a scope from a natural language brief
+terrascout scope new "Monitor vegetation on a 500ha mine site near Emerald QLD, monthly for 12 months"
+
+# View results for a scope
+terrascout scope view <scope_id>
+
+# Download a PDF compliance report
+terrascout scope report <scope_id> --output report.pdf
+
+# Compare recommendations side-by-side
+terrascout scope compare <scope_id>
+```
+
+## Search
+
+```bash
+# Browse free satellite data providers
+terrascout search providers --free-only
+
+# Filter by resolution
+terrascout search providers --resolution 10
+
+# Search STAC catalogs for recent scenes
+terrascout search stac --collection sentinel-2-l2a --bbox 144,-38,145,-37
+```
+
+## Projects
+
+```bash
+# List your project workspaces
+terrascout project list
+
+# Create a new project
+terrascout project create "Mine Rehabilitation Monitoring"
+```
+
+## AI Agents
+
+```bash
+# List available AI agents
+terrascout agents list
+
+# Run an agent on a scope
+terrascout agents run methodology_writer --scope <scope_id>
+```
+
+## Configuration
+
+Config is stored at `~/.terrascout/config.yaml`:
+
+```bash
+# View current config
+terrascout config show
+
+# Point to a different API (e.g., local dev server)
+terrascout config set api_url http://localhost:8000
+
+# Point to production (default)
+terrascout config set api_url http://130.162.194.71
+```
+
+## Authentication
+
+```bash
+terrascout auth login --email user@example.com
+terrascout auth status
+terrascout auth logout
+```
+
+Authentication is optional for core scoping features. Required for projects, agents, and alert subscriptions.
+
+## Also Available
+
+- **Web app**: [http://130.162.194.71](http://130.162.194.71)
+- **MCP Server**: Connect Terrascout to Claude, Cursor, Windsurf, and other AI assistants
+- **REST API**: Full OpenAPI docs at [/docs](http://130.162.194.71/docs)

terrascout-0.1.0/README.md

@@ -0,0 +1,96 @@
+# Terrascout CLI
+
+Geospatial data scoping from the terminal. Find the best satellite imagery and spatial datasets for your project — ranked, scored, and assessed for feasibility.
+
+Powered by [Terrascout](http://130.162.194.71).
+
+## Install
+
+```bash
+pip install terrascout
+```
+
+Requires Python 3.11+. No API key needed for free-tier features.
+
+## Quick Start
+
+```bash
+# Check connectivity to Terrascout API
+terrascout health
+
+# Create a scope from a natural language brief
+terrascout scope new "Monitor vegetation on a 500ha mine site near Emerald QLD, monthly for 12 months"
+
+# View results for a scope
+terrascout scope view <scope_id>
+
+# Download a PDF compliance report
+terrascout scope report <scope_id> --output report.pdf
+
+# Compare recommendations side-by-side
+terrascout scope compare <scope_id>
+```
+
+## Search
+
+```bash
+# Browse free satellite data providers
+terrascout search providers --free-only
+
+# Filter by resolution
+terrascout search providers --resolution 10
+
+# Search STAC catalogs for recent scenes
+terrascout search stac --collection sentinel-2-l2a --bbox 144,-38,145,-37
+```
+
+## Projects
+
+```bash
+# List your project workspaces
+terrascout project list
+
+# Create a new project
+terrascout project create "Mine Rehabilitation Monitoring"
+```
+
+## AI Agents
+
+```bash
+# List available AI agents
+terrascout agents list
+
+# Run an agent on a scope
+terrascout agents run methodology_writer --scope <scope_id>
+```
+
+## Configuration
+
+Config is stored at `~/.terrascout/config.yaml`:
+
+```bash
+# View current config
+terrascout config show
+
+# Point to a different API (e.g., local dev server)
+terrascout config set api_url http://localhost:8000
+
+# Point to production (default)
+terrascout config set api_url http://130.162.194.71
+```
+
+## Authentication
+
+```bash
+terrascout auth login --email user@example.com
+terrascout auth status
+terrascout auth logout
+```
+
+Authentication is optional for core scoping features. Required for projects, agents, and alert subscriptions.
+
+## Also Available
+
+- **Web app**: [http://130.162.194.71](http://130.162.194.71)
+- **MCP Server**: Connect Terrascout to Claude, Cursor, Windsurf, and other AI assistants
+- **REST API**: Full OpenAPI docs at [/docs](http://130.162.194.71/docs)

terrascout-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "terrascout"
+version = "0.1.0"
+description = "Terrascout CLI — geospatial data scoping from the terminal"
+readme = "README.md"
+license = {text = "Proprietary"}
+requires-python = ">=3.11"
+authors = [
+    { name = "Mazdak Ghasemi Tootkaboni", email = "maz@terrascout.dev" },
+]
+keywords = ["geospatial", "satellite", "remote-sensing", "cli", "terrascout", "earth-observation"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering :: GIS",
+    "License :: Other/Proprietary License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13.0",
+    "httpx>=0.27",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+terrascout = "terrascout_cli.main:app"
+
+[project.urls]
+Homepage = "http://130.162.194.71"
+Documentation = "http://130.162.194.71/integrations"
+"Release Notes" = "http://130.162.194.71/integrations"
+"Support" = "http://130.162.194.71/integrations"
+
+[tool.hatch.build.targets.wheel]
+packages = ["terrascout_cli"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

terrascout-0.1.0/terrascout_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Terrascout CLI — geospatial data scoping from the terminal."""
+
+__version__ = "0.1.0"

terrascout-0.1.0/terrascout_cli/client.py

@@ -0,0 +1,52 @@
+"""HTTP API client — all backend communication goes through here."""
+
+from typing import Any
+
+import httpx
+
+from terrascout_cli.config import get_api_url, get_token
+
+TIMEOUT = 30.0
+
+
+def _headers() -> dict[str, str]:
+    headers: dict[str, str] = {"Accept": "application/json"}
+    token = get_token()
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    return headers
+
+
+def _base() -> str:
+    return get_api_url().rstrip("/")
+
+
+def _url(path: str) -> str:
+    return f"{_base()}/api/v1{path}"
+
+
+def get(path: str, params: dict[str, Any] | None = None) -> httpx.Response:
+    """GET request to the Terrascout API."""
+    return httpx.get(_url(path), params=params, headers=_headers(), timeout=TIMEOUT)
+
+
+def post(path: str, json: dict[str, Any] | None = None) -> httpx.Response:
+    """POST request to the Terrascout API."""
+    return httpx.post(_url(path), json=json, headers=_headers(), timeout=TIMEOUT)
+
+
+def get_raw(path: str, params: dict[str, Any] | None = None) -> httpx.Response:
+    """GET request returning raw bytes (for PDF downloads etc.)."""
+    return httpx.get(
+        _url(path),
+        params=params,
+        headers={**_headers(), "Accept": "application/pdf"},
+        timeout=60.0,
+    )
+
+
+def health() -> dict[str, Any]:
+    """Check API health."""
+    resp = get("/health")
+    resp.raise_for_status()
+    return resp.json()

terrascout-0.1.0/terrascout_cli/commands/agents.py

@@ -0,0 +1,72 @@
+"""Agents commands — list, run."""
+
+import typer
+from rich.panel import Panel
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from terrascout_cli import client, output
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("list")
+def agents_list() -> None:
+    """List available AI agents."""
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[bold cyan]Loading agents..."),
+        transient=True,
+        console=output.console,
+    ):
+        resp = client.get("/agents")
+
+    if resp.status_code != 200:
+        output.error(f"API error {resp.status_code}: {resp.text[:200]}")
+        raise typer.Exit(1)
+
+    data = resp.json()
+    agents = data if isinstance(data, list) else data.get("agents", [])
+
+    if agents:
+        output.console.print(output.agents_table(agents))
+    else:
+        output.warning("No agents available.")
+
+
+@app.command("run")
+def agents_run(
+    slug: str = typer.Argument(help="Agent slug (e.g. methodology_writer)"),
+    scope_id: str = typer.Option(..., "--scope", "-s", help="Scope UUID for context"),
+    prompt: str = typer.Option("", "--prompt", "-p", help="Additional prompt/instructions"),
+) -> None:
+    """Execute an AI agent with scope context."""
+    body: dict = {"scope_id": scope_id}
+    if prompt:
+        body["prompt"] = prompt
+
+    with Progress(
+        SpinnerColumn(),
+        TextColumn(f"[bold cyan]Running agent '{slug}'..."),
+        transient=True,
+        console=output.console,
+    ):
+        resp = client.post(f"/agents/{slug}/run", json=body)
+
+    if resp.status_code == 401:
+        output.error("Authentication required. Run [bold]terrascout auth login[/].")
+        raise typer.Exit(1)
+    if resp.status_code == 403:
+        output.error("Tier upgrade required for this agent.")
+        raise typer.Exit(1)
+    if resp.status_code != 200:
+        output.error(f"API error {resp.status_code}: {resp.text[:200]}")
+        raise typer.Exit(1)
+
+    data = resp.json()
+    agent_output = data.get("output", data.get("result", ""))
+
+    output.console.print(Panel(
+        str(agent_output),
+        title=f"Agent: {slug}",
+        border_style="green",
+    ))

terrascout-0.1.0/terrascout_cli/commands/auth.py

@@ -0,0 +1,91 @@
+"""Auth commands — login, logout, status."""
+
+import typer
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from terrascout_cli import client, output
+from terrascout_cli.config import get_token, set_token
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("login")
+def auth_login(
+    email: str = typer.Option(..., "--email", "-e", prompt=True, help="Account email"),
+    password: str = typer.Option(..., "--password", "-p", prompt=True, hide_input=True, help="Password"),
+) -> None:
+    """Log in to Terrascout and store JWT token."""
+    import httpx
+
+    from terrascout_cli.config import get_api_url
+
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[bold cyan]Authenticating..."),
+        transient=True,
+        console=output.console,
+    ):
+        # Call Supabase-compatible auth endpoint
+        # The frontend uses Supabase JS SDK, but the CLI can use the REST API
+        try:
+            base = get_api_url().rstrip("/")
+            resp = httpx.post(
+                f"{base}/api/v1/auth/login",
+                json={"email": email, "password": password},
+                timeout=15.0,
+            )
+        except httpx.RequestError as exc:
+            output.error(f"Connection failed: {exc}")
+            raise typer.Exit(1)
+
+    if resp.status_code == 200:
+        data = resp.json()
+        token = data.get("access_token") or data.get("token")
+        if token:
+            set_token(token)
+            output.success(f"Logged in as [bold]{email}[/]")
+        else:
+            output.error("Login succeeded but no token returned.")
+            raise typer.Exit(1)
+    elif resp.status_code == 401:
+        output.error("Invalid email or password.")
+        raise typer.Exit(1)
+    else:
+        output.error(f"Login failed ({resp.status_code}): {resp.text[:200]}")
+        raise typer.Exit(1)
+
+
+@app.command("logout")
+def auth_logout() -> None:
+    """Clear stored authentication token."""
+    set_token(None)
+    output.success("Logged out.")
+
+
+@app.command("status")
+def auth_status() -> None:
+    """Show current authentication status."""
+    token = get_token()
+    if not token:
+        output.warning("Not logged in. Use [bold]terrascout auth login[/] to authenticate.")
+        return
+
+    # Try fetching profile to verify token is valid
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[bold cyan]Checking token..."),
+        transient=True,
+        console=output.console,
+    ):
+        resp = client.get("/profile")
+
+    if resp.status_code == 200:
+        profile = resp.json()
+        email = profile.get("email", "?")
+        tier = profile.get("tier", "free")
+        output.success(f"Authenticated as [bold]{email}[/] (tier: {tier})")
+    elif resp.status_code == 401:
+        output.error("Token expired or invalid. Run [bold]terrascout auth login[/] again.")
+        set_token(None)
+    else:
+        output.warning(f"Could not verify token (status {resp.status_code})")

terrascout-0.1.0/terrascout_cli/commands/config.py

@@ -0,0 +1,45 @@
+"""Config commands — show, set."""
+
+import typer
+from rich.table import Table
+
+from terrascout_cli import output
+from terrascout_cli.config import CONFIG_FILE, load_config, save_config
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("show")
+def config_show() -> None:
+    """Display current configuration."""
+    cfg = load_config()
+
+    table = Table(title=f"Config ({CONFIG_FILE})", border_style="cyan")
+    table.add_column("Key", style="bold white")
+    table.add_column("Value", style="cyan")
+
+    for key, value in cfg.items():
+        display = str(value) if value is not None else "[dim]not set[/]"
+        if key == "token" and value:
+            display = f"{value[:20]}..." if len(value) > 20 else value
+        table.add_row(key, display)
+
+    output.console.print(table)
+
+
+@app.command("set")
+def config_set(
+    key: str = typer.Argument(help="Config key (e.g. api_url)"),
+    value: str = typer.Argument(help="New value"),
+) -> None:
+    """Set a configuration value."""
+    cfg = load_config()
+
+    valid_keys = {"api_url", "token"}
+    if key not in valid_keys:
+        output.error(f"Unknown key '{key}'. Valid keys: {', '.join(sorted(valid_keys))}")
+        raise typer.Exit(1)
+
+    cfg[key] = value
+    save_config(cfg)
+    output.success(f"Set [bold]{key}[/] = {value}")

terrascout-0.1.0/terrascout_cli/commands/project.py

@@ -0,0 +1,109 @@
+"""Project commands — list, create, add-scope."""
+
+from typing import Optional
+
+import typer
+from rich.progress import Progress, SpinnerColumn, TextColumn
+from rich.table import Table
+
+from terrascout_cli import client, output
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("list")
+def project_list() -> None:
+    """List your projects."""
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[bold cyan]Loading projects..."),
+        transient=True,
+        console=output.console,
+    ):
+        resp = client.get("/projects")
+
+    if resp.status_code == 401:
+        output.error("Authentication required. Run [bold]terrascout auth login[/].")
+        raise typer.Exit(1)
+    if resp.status_code != 200:
+        output.error(f"API error {resp.status_code}: {resp.text[:200]}")
+        raise typer.Exit(1)
+
+    projects = resp.json()
+    if isinstance(projects, dict):
+        projects = projects.get("projects", [])
+
+    if not projects:
+        output.warning("No projects yet. Use [bold]terrascout project create[/] to start one.")
+        return
+
+    table = Table(title="Projects", border_style="cyan", show_lines=True)
+    table.add_column("ID", style="dim", max_width=36)
+    table.add_column("Name", style="bold white")
+    table.add_column("Status", style="cyan")
+    table.add_column("Scopes", justify="right")
+    table.add_column("Created", style="dim")
+
+    for p in projects:
+        table.add_row(
+            str(p.get("id", ""))[:36],
+            p.get("name", ""),
+            p.get("status", "active"),
+            str(p.get("scope_count", 0)),
+            str(p.get("created_at", ""))[:10],
+        )
+
+    output.console.print(table)
+
+
+@app.command("create")
+def project_create(
+    name: str = typer.Argument(help="Project name"),
+    description: Optional[str] = typer.Option(None, "--desc", "-d", help="Project description"),
+) -> None:
+    """Create a new project workspace."""
+    body: dict = {"name": name}
+    if description:
+        body["description"] = description
+
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[bold cyan]Creating project..."),
+        transient=True,
+        console=output.console,
+    ):
+        resp = client.post("/projects", json=body)
+
+    if resp.status_code == 401:
+        output.error("Authentication required. Run [bold]terrascout auth login[/].")
+        raise typer.Exit(1)
+    if resp.status_code not in (200, 201):
+        output.error(f"API error {resp.status_code}: {resp.text[:200]}")
+        raise typer.Exit(1)
+
+    data = resp.json()
+    output.success(f"Project created: [bold]{data.get('name', name)}[/] ({data.get('id', '?')})")
+
+
+@app.command("add-scope")
+def project_add_scope(
+    project_id: str = typer.Argument(help="Project UUID"),
+    scope_id: str = typer.Argument(help="Scope UUID to add"),
+) -> None:
+    """Add a scope to an existing project."""
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[bold cyan]Adding scope to project..."),
+        transient=True,
+        console=output.console,
+    ):
+        resp = client.post(f"/projects/{project_id}/scopes", json={"scope_id": scope_id})
+
+    if resp.status_code == 401:
+        output.error("Authentication required.")
+        raise typer.Exit(1)
+    if resp.status_code not in (200, 201):
+        output.error(f"API error {resp.status_code}: {resp.text[:200]}")
+        raise typer.Exit(1)
+
+    output.success(f"Scope [bold]{scope_id}[/] added to project [bold]{project_id}[/]")