Release v0.1.9 — Google Sheets, managed .venv, Quack, notify & schedule

[db-tycoon-stephen]

v0.1.9

Headline: a first-class Google Sheets source, plus tycoon managing a project-local .venv so Python setup stops blocking new users. Folded in alongside: the live multi-client warehouse (Quack), pipeline notifications, and scheduled runs.

Shipped

• Google Sheets source (Add Google Sheets as a data source #52, headline) — tycoon data sources add google_sheets; service-account JSON auth (defaults to $GOOGLE_APPLICATION_CREDENTIALS, blank falls back to dlt OAuth/ADC), --no-prompt support, full-refresh first cut. Verified source pulled on demand via dlt init (not bundled).
• Managed project-local .venv (feat(onboarding): managed project-local .venv via uv with a correct Python interpreter #57) — tycoon doctor's first check verifies the interpreter is in >=3.12,<3.14; tycoon setup builds the .venv via uv venv --python (auto-downloads CPython), pins .python-version, installs the stack; tycoon doctor --fix runs the same flow. Closes the Python-version trap behind requires-python has no upper bound → Python 3.14 gets selected, dbt breaks #55.
• DuckDB Quack — live multi-client warehouse (Integrate DuckDB Quack protocol for multi-client local DuckDB access #42) — folded into tycoon start (no new commands): serves the warehouse over Quack's local RPC on :9494 when the core_nightly extension is available; tycoon data query attaches to the live warehouse instead of the file lock. Token in gitignored .tycoon/secrets.yml.
• Pipeline notifications (feat(notify): slack/webhook notifications on pipeline completion #46) — tycoon notify <severity> <message> + tycoon data run-all --notify; Slack/generic webhook from $TYCOON_NOTIFY_WEBHOOK_URL; best-effort.
• Scheduled runs (feat(schedule): local cron/launchd wrapper for scheduled pipeline runs #48) — tycoon schedule add/list/remove/status wrapping launchd (macOS) / systemd --user (Linux); logs per schedule; doctor reports the count.

Deferred

• Layer-granular backup (v0.1.8+: layer-granular backup config (backup.layers replaces skip_raw) #31) — no cloud-bucket backup track ever shipped (it depended on the deferred DuckLake path), so there's nothing to make layer-aware yet. Revisit once a backup mechanism lands.

Verification

Local preflight all green: pytest (721 passed, 2 skipped), ruff check src tests, mkdocs build --strict, uv build (wheel + sdist), tycoon --version → 0.1.9. Version coherent across pyproject.toml ↔ src/tycoon/__init__.py ↔ CHANGELOG (2026-06-07) ↔ docs/releases/v0.1.9.md.

Full narrative: docs/releases/v0.1.9.md · CHANGELOG.md.

🤖 Generated with Claude Code

[gemini-code-assist]

Code Review

This pull request introduces several major features for v0.1.9, including a first-class Google Sheets data source, a managed project-local virtual environment setup (tycoon setup and tycoon doctor --fix), a live multi-client warehouse via DuckDB Quack, platform-native scheduled runs (tycoon schedule), and pipeline-completion notifications (tycoon notify). The review feedback is highly constructive, highlighting opportunities to improve virtual environment recreation robustness, handle redundant command prefixes in schedules, optimize DuckDB Quack loading for offline environments, prevent unhandled exceptions in webhook requests, ensure UTF-8 encoding compatibility on Windows, and validate command-line notification fields.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

When force=True is passed, the existing .venv directory is not actually removed before running uv venv. This can leave stale packages or files in the environment, violating the clean slate promise. Deleting the directory using shutil.rmtree ensures a clean recreation.

    target = venv_path(project_root)
    if target.exists():
        if not force:
            return VenvResult(
                ok=False,
                venv_path=target,
                message=(
                    f"{target} already exists. Re-run with --force to recreate it "
                    "(this removes the existing environment)."
                ),
            )
        import shutil
        try:
            shutil.rmtree(target)
        except OSError as exc:
            return VenvResult(
                ok=False,
                venv_path=target,
                message=f"Failed to remove existing environment at {target}: {exc}",
            )

[gemini-code-assist]

If a user accidentally prefixes the scheduled command with tycoon (e.g., --command "tycoon data run-all"), the scheduler will attempt to run tycoon tycoon data run-all, which will fail. Stripping the leading tycoon argument prevents this common configuration mistake.

    args = shlex.split(command)
    if args and args[0] == "tycoon":
        args = args[1:]
    if notify and "--notify" not in args:
        args.append("--notify")

[gemini-code-assist]

Running INSTALL quack FROM core_nightly; requires internet access to check the remote repository, even if the extension is already installed locally. Attempting to LOAD quack; first avoids unnecessary network calls and supports offline usage when the extension is already cached.

    try:
        # Try loading first (offline-friendly)
        result = subprocess.run(
            ["duckdb", "-c", "LOAD quack;"],
            capture_output=True,
            text=True,
            timeout=10,
        )
        if result.returncode == 0:
            return True
    except (subprocess.TimeoutExpired, OSError):
        pass

    try:
        result = subprocess.run(
            ["duckdb", "-c", _LOAD_QUACK],
            capture_output=True,
            text=True,
            timeout=60,
        )
    except (subprocess.TimeoutExpired, OSError):
        return False
    return result.returncode == 0

[gemini-code-assist]

The send function is documented as never raising exceptions. However, httpx.post can raise non-HTTPError exceptions (such as ValueError or InvalidURL if the resolved URL is malformed). Catching Exception ensures that notification failures never crash the calling CLI process.

Suggested change

	try:
	response = httpx.post(resolved, json=payload, timeout=timeout)
	except httpx.HTTPError:
	return False
	return response.is_success
	try:
	response = httpx.post(resolved, json=payload, timeout=timeout)
	except Exception:
	return False
	return response.is_success

[gemini-code-assist]

Specifying encoding="utf-8" when reading the service account JSON file prevents potential encoding errors on platforms where the default system encoding is not UTF-8 (such as Windows).

Suggested change

	kwargs["credentials"] = json.loads(key_file.read_text())
	kwargs["credentials"] = json.loads(key_file.read_text(encoding="utf-8"))

[gemini-code-assist]

If the user passes an empty key (e.g., --field =value), the current implementation will accept it with an empty string key. Validating that the key is not empty prevents malformed payloads.

        key, value = pair.split("=", 1)
        key = key.strip()
        if not key:
            error(f"Invalid --field '{pair}' — key cannot be empty.")
            raise typer.Exit(2)
        out[key] = value.strip()