Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
"""Tests for ``repowise doctor --workspace`` (Phase C2).
Covers workspace-level validation: drift detection between
``WorkspaceConfig.last_commit_at_index`` and per-repo ``state.json``,
missing directory entries, and ``--repair`` behavior (drift sync + dead
entry removal).
"""
from __future__ import annotations
import json
import subprocess
from pathlib import Path
from click.testing import CliRunner
from repowise.cli.commands.doctor_cmd import (
_check_mcp_registered,
_run_workspace_checks,
doctor_command,
)
from repowise.core.workspace.config import RepoEntry, WorkspaceConfig
def _git_init(p: Path) -> None:
p.mkdir(parents=True, exist_ok=True)
subprocess.run(["git", "init"], cwd=str(p), capture_output=True)
def _write_state(repo: Path, commit: str) -> None:
rdir = repo / ".repowise"
rdir.mkdir(exist_ok=True)
(rdir / "state.json").write_text(
json.dumps({"last_sync_commit": commit}), encoding="utf-8"
)
def test_workspace_checks_detects_state_drift(tmp_path: Path) -> None:
backend = tmp_path / "backend"
_git_init(backend)
_write_state(backend, "real-sha-from-state")
cfg = WorkspaceConfig(
repos=[RepoEntry(
path="backend",
alias="backend",
last_commit_at_index="stale-sha-in-config",
)],
)
cfg.save(tmp_path)
issues = _run_workspace_checks(tmp_path, cfg, repair=False)
assert any("drift" in i for i in issues), issues
def test_workspace_checks_detects_missing_dir(tmp_path: Path) -> None:
cfg = WorkspaceConfig(
repos=[RepoEntry(path="ghost", alias="ghost")],
)
cfg.save(tmp_path)
issues = _run_workspace_checks(tmp_path, cfg, repair=False)
assert any("missing directory" in i for i in issues)
def test_workspace_checks_repair_syncs_drift(tmp_path: Path) -> None:
backend = tmp_path / "backend"
_git_init(backend)
real_sha = "abc" * 14 # 42 chars (close enough)
_write_state(backend, real_sha)
cfg = WorkspaceConfig(
repos=[RepoEntry(
path="backend",
alias="backend",
last_commit_at_index="OLD",
)],
)
cfg.save(tmp_path)
_run_workspace_checks(tmp_path, cfg, repair=True)
assert cfg.get_repo("backend").last_commit_at_index == real_sha
def test_workspace_checks_repair_drops_dead_entries(tmp_path: Path) -> None:
backend = tmp_path / "backend"
_git_init(backend)
_write_state(backend, "deadbeef")
cfg = WorkspaceConfig(
repos=[
RepoEntry(
path="backend", alias="backend", last_commit_at_index="deadbeef",
),
RepoEntry(path="ghost", alias="ghost"),
],
default_repo="backend",
)
cfg.save(tmp_path)
_run_workspace_checks(tmp_path, cfg, repair=True)
aliases = cfg.repo_aliases()
assert "backend" in aliases
assert "ghost" not in aliases
def test_workspace_checks_clean_workspace_has_no_issues(tmp_path: Path) -> None:
backend = tmp_path / "backend"
_git_init(backend)
sha = "f" * 40
_write_state(backend, sha)
cfg = WorkspaceConfig(
repos=[RepoEntry(
path="backend", alias="backend", last_commit_at_index=sha,
)],
)
cfg.save(tmp_path)
issues = _run_workspace_checks(tmp_path, cfg, repair=False)
assert issues == []
def test_doctor_command_workspace_flag_runs(tmp_path: Path) -> None:
"""CliRunner smoke test — `repowise doctor --workspace` should not
crash on a workspace with one indexed repo."""
backend = tmp_path / "backend"
_git_init(backend)
sha = "0" * 40
_write_state(backend, sha)
# Create empty wiki.db so the per-repo db check has something to bite on.
(backend / ".repowise" / "wiki.db").write_bytes(b"")
cfg = WorkspaceConfig(
repos=[RepoEntry(
path="backend", alias="backend",
is_primary=True, last_commit_at_index=sha,
)],
default_repo="backend",
)
cfg.save(tmp_path)
runner = CliRunner()
result = runner.invoke(
doctor_command, [str(tmp_path), "--workspace"],
)
# The per-repo db check may fail because wiki.db is an empty file,
# but the workspace doctor wiring must not crash.
assert result.exit_code == 0, result.output
assert "backend" in result.output
def test_check_mcp_registered_does_not_crash(tmp_path: Path) -> None:
"""Advisory check — never throws even when no claude_desktop_config exists."""
_check_mcp_registered(tmp_path)