"""Tests for analyst bootstrap flow.""" import json import os from datetime import datetime, timedelta, timezone from pathlib import Path from unittest.mock import MagicMock, patch import pytest from typer.testing import CliRunner from cli.main import app runner = CliRunner() @pytest.fixture(autouse=True) def tmp_workspace(tmp_path, monkeypatch): monkeypatch.setenv("DATA_DIR", str(tmp_path / "data")) monkeypatch.setenv("DA_CONFIG_DIR", str(tmp_path / "config")) monkeypatch.setenv("DA_LOCAL_DIR", str(tmp_path / "local")) monkeypatch.setenv("JWT_SECRET_KEY", "test-secret") (tmp_path / "data").mkdir() (tmp_path / "config").mkdir() (tmp_path / "local").mkdir() ws = tmp_path / "workspace" ws.mkdir() monkeypatch.chdir(ws) yield ws # --------------------------------------------------------------------------- # TestDetectExistingProject # --------------------------------------------------------------------------- class TestDetectExistingProject: def test_no_settings_json_returns_false(self, tmp_workspace): from cli.commands.analyst import _detect_existing_project assert _detect_existing_project(tmp_workspace) is False def test_settings_json_with_da_sync_returns_true(self, tmp_workspace): from cli.commands.analyst import _detect_existing_project import json as _json claude_dir = tmp_workspace / ".claude" claude_dir.mkdir(parents=True, exist_ok=True) settings = { "hooks": { "SessionStart": [{"hooks": [{"type": "command", "command": "da sync --quiet 2>/dev/null || true"}]}], } } (claude_dir / "settings.json").write_text(_json.dumps(settings), encoding="utf-8") assert _detect_existing_project(tmp_workspace) is True def test_settings_json_without_da_sync_returns_false(self, tmp_workspace): from cli.commands.analyst import _detect_existing_project import json as _json claude_dir = tmp_workspace / ".claude" claude_dir.mkdir(parents=True, exist_ok=True) (claude_dir / "settings.json").write_text( _json.dumps({"model": "sonnet"}), encoding="utf-8" ) assert _detect_existing_project(tmp_workspace) is False def test_setup_blocked_when_existing_without_force(self, tmp_workspace): """Setup must exit(1) when workspace exists and --force not supplied.""" import json as _json claude_dir = tmp_workspace / ".claude" claude_dir.mkdir(parents=True, exist_ok=True) settings = { "hooks": { "SessionStart": [{"hooks": [{"type": "command", "command": "da sync --quiet 2>/dev/null || true"}]}], } } (claude_dir / "settings.json").write_text(_json.dumps(settings), encoding="utf-8") result = runner.invoke(app, ["analyst", "setup", "--server-url", "http://localhost:8000"]) assert result.exit_code == 1 assert "force" in result.output.lower() or "force" in (result.stderr or "").lower() def test_setup_proceeds_with_force(self, tmp_workspace): """--force bypasses existing-project detection.""" import json as _json claude_dir = tmp_workspace / ".claude" claude_dir.mkdir(parents=True, exist_ok=True) settings = { "hooks": { "SessionStart": [{"hooks": [{"type": "command", "command": "da sync --quiet 2>/dev/null || true"}]}], } } (claude_dir / "settings.json").write_text(_json.dumps(settings), encoding="utf-8") with patch("cli.commands.analyst._connect_to_instance", return_value="tok"), \ patch("cli.commands.analyst._download_metadata"), \ patch("cli.commands.analyst._download_data", return_value=0), \ patch("cli.commands.analyst._initialize_duckdb", return_value=0), \ patch("cli.commands.analyst._init_claude_workspace"): result = runner.invoke( app, ["analyst", "setup", "--server-url", "http://localhost:8000", "--force"], ) assert result.exit_code == 0 # --------------------------------------------------------------------------- # TestCreateWorkspace # --------------------------------------------------------------------------- class TestCreateWorkspace: def test_creates_all_directories(self, tmp_workspace): from cli.commands.analyst import _create_workspace _create_workspace(tmp_workspace) expected = [ tmp_workspace / "data" / "parquet", tmp_workspace / "data" / "duckdb", tmp_workspace / "data" / "metadata", tmp_workspace / "user" / "artifacts", tmp_workspace / "user" / "sessions", tmp_workspace / ".claude", ] for d in expected: assert d.is_dir(), f"Expected directory missing: {d}" def test_idempotent(self, tmp_workspace): """Calling _create_workspace twice should not raise.""" from cli.commands.analyst import _create_workspace _create_workspace(tmp_workspace) _create_workspace(tmp_workspace) # should not raise # --------------------------------------------------------------------------- # TestInitClaudeWorkspace # --------------------------------------------------------------------------- class TestInitClaudeWorkspace: """Tests for _init_claude_workspace: no CLAUDE.md written, but .claude/CLAUDE.local.md placeholder and settings.json hooks are created. """ def test_does_not_write_claude_md(self, tmp_workspace): from cli.commands.analyst import _create_workspace, _init_claude_workspace _create_workspace(tmp_workspace) _init_claude_workspace(tmp_workspace) assert not (tmp_workspace / "CLAUDE.md").exists(), ( "CLAUDE.md must NOT be written by _init_claude_workspace" ) def test_creates_claude_local_md_when_absent(self, tmp_workspace): from cli.commands.analyst import _create_workspace, _init_claude_workspace _create_workspace(tmp_workspace) _init_claude_workspace(tmp_workspace) local_md = tmp_workspace / ".claude" / "CLAUDE.local.md" assert local_md.exists() assert local_md.read_text(encoding="utf-8").strip() != "" def test_does_not_overwrite_existing_local_md(self, tmp_workspace): from cli.commands.analyst import _create_workspace, _init_claude_workspace _create_workspace(tmp_workspace) local_md = tmp_workspace / ".claude" / "CLAUDE.local.md" original_content = "# My custom notes\n\nDo not overwrite me.\n" local_md.write_text(original_content, encoding="utf-8") _init_claude_workspace(tmp_workspace) assert local_md.read_text(encoding="utf-8") == original_content def test_writes_settings_json(self, tmp_workspace): from cli.commands.analyst import _create_workspace, _init_claude_workspace import json as _json _create_workspace(tmp_workspace) _init_claude_workspace(tmp_workspace) settings = _json.loads( (tmp_workspace / ".claude" / "settings.json").read_text(encoding="utf-8") ) assert settings["model"] == "sonnet" assert "Read" in settings["permissions"]["allow"] def test_installs_session_hooks(self, tmp_workspace): """SessionStart and SessionEnd hooks must be present in settings.json.""" from cli.commands.analyst import _create_workspace, _init_claude_workspace import json as _json _create_workspace(tmp_workspace) _init_claude_workspace(tmp_workspace) settings = _json.loads( (tmp_workspace / ".claude" / "settings.json").read_text(encoding="utf-8") ) hooks = settings.get("hooks", {}) assert "SessionStart" in hooks assert "SessionEnd" in hooks # --------------------------------------------------------------------------- # TestReturningSession # --------------------------------------------------------------------------- class TestReturningSession: def test_missing_when_no_last_sync_file(self, tmp_workspace): from cli.commands.analyst import _check_data_freshness assert _check_data_freshness(tmp_workspace) == "missing" def test_fresh_when_recent_sync(self, tmp_workspace): from cli.commands.analyst import _create_workspace, _check_data_freshness _create_workspace(tmp_workspace) synced_at = datetime.now(timezone.utc).isoformat() (tmp_workspace / "data" / "metadata" / "last_sync.json").write_text( json.dumps({"synced_at": synced_at}), encoding="utf-8" ) assert _check_data_freshness(tmp_workspace) == "fresh" def test_stale_when_old_sync(self, tmp_workspace): from cli.commands.analyst import _create_workspace, _check_data_freshness _create_workspace(tmp_workspace) old_time = (datetime.now(timezone.utc) - timedelta(hours=25)).isoformat() (tmp_workspace / "data" / "metadata" / "last_sync.json").write_text( json.dumps({"synced_at": old_time}), encoding="utf-8" ) assert _check_data_freshness(tmp_workspace) == "stale" def test_status_command_output(self, tmp_workspace): result = runner.invoke(app, ["analyst", "status"]) assert result.exit_code == 0 assert "freshness" in result.output.lower() or "Data freshness" in result.output def test_status_command_json(self, tmp_workspace): result = runner.invoke(app, ["analyst", "status", "--json"]) assert result.exit_code == 0 data = json.loads(result.output) assert "freshness" in data assert data["freshness"] == "missing" assert "parquet_tables" in data def test_status_fresh_after_setup_metadata(self, tmp_workspace): from cli.commands.analyst import _create_workspace _create_workspace(tmp_workspace) synced_at = datetime.now(timezone.utc).isoformat() (tmp_workspace / "data" / "metadata" / "last_sync.json").write_text( json.dumps({"synced_at": synced_at}), encoding="utf-8" ) result = runner.invoke(app, ["analyst", "status", "--json"]) assert result.exit_code == 0 data = json.loads(result.output) assert data["freshness"] == "fresh"