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
feat: add delete repository functionality (#42)
Selene29ea56532634e5
diff --git a/packages/cli/src/repowise/cli/commands/delete_cmd.py b/packages/cli/src/repowise/cli/commands/delete_cmd.pynew file mode 100644index 000000000..048d6f0fa--- /dev/null+++ b/packages/cli/src/repowise/cli/commands/delete_cmd.py@@ -0,0 +1,139 @@+"""``repowise delete`` — remove a repository and all its generated data."""++from __future__ import annotations++import click+from rich.table import Table++from repowise.cli.helpers import (+ console,+ get_db_url_for_repo,+ get_repowise_dir,+ resolve_repo_path,+ run_async,+)++[email protected]("delete")[email protected]("repo_id", required=False, default=None)[email protected]("--force", "-f", is_flag=True, default=False, help="Skip confirmation prompt.")[email protected]("--path", "-p", default=None, help="Path to the repository directory.")+def delete_command(repo_id: str | None, force: bool, path: str | None) -> None:+ """Delete a repository and all its generated data."""+ repo_path = resolve_repo_path(path)+ repowise_dir = get_repowise_dir(repo_path)++ if not repowise_dir.exists():+ console.print("[yellow]No .repowise/ directory found. Run 'repowise init' first.[/yellow]")+ return++ db_path = repowise_dir / "wiki.db"+ if not db_path.exists():+ console.print("[yellow]Database not found.[/yellow]")+ return++ async def _run() -> None:+ from sqlalchemy import func, select++ from repowise.core.persistence import (+ Repository,+ create_engine,+ create_session_factory,+ delete_repository,+ get_session,+ list_page_ids,+ )+ from repowise.core.persistence.models import Page+ from repowise.core.persistence.search import FullTextSearch++ url = get_db_url_for_repo(repo_path)+ engine = create_engine(url)+ sf = create_session_factory(engine)++ # List all repos with page counts+ async with get_session(sf) as session:+ result = await session.execute(+ select(+ Repository.id,+ Repository.name,+ Repository.local_path,+ func.count(Page.id).label("page_count"),+ )+ .outerjoin(Page, Page.repository_id == Repository.id)+ .group_by(Repository.id)+ .order_by(Repository.updated_at.desc())+ )+ repos = list(result.all())++ if not repos:+ console.print("[yellow]No repositories found in the database.[/yellow]")+ await engine.dispose()+ return++ # If no repo_id given, let the user pick+ target_id = repo_id+ if target_id is None:+ table = Table(title="Repositories")+ table.add_column("#", style="cyan", justify="right")+ table.add_column("Name", style="bold")+ table.add_column("Path")+ table.add_column("Pages", justify="right")+ table.add_column("ID", style="dim")++ for i, (rid, name, lpath, pcount) in enumerate(repos, 1):+ table.add_row(str(i), name, lpath, str(pcount), rid[:12])++ console.print(table)+ choice = click.prompt(+ "Enter number to delete (or 'q' to quit)",+ default="q",+ )+ if choice.lower() == "q":+ await engine.dispose()+ return+ try:+ idx = int(choice) - 1+ if idx < 0 or idx >= len(repos):+ raise ValueError+ target_id = repos[idx][0]+ except (ValueError, IndexError):+ console.print("[red]Invalid selection.[/red]")+ await engine.dispose()+ return++ # Find the target repo info+ target = next((r for r in repos if r[0] == target_id), None)+ if target is None:+ console.print(f"[red]Repository {target_id} not found.[/red]")+ await engine.dispose()+ return++ rid, name, lpath, pcount = target+ console.print(+ f"\nAbout to delete [bold]{name}[/bold] ({lpath}) — "+ f"[yellow]{pcount} pages[/yellow] will be removed."+ )++ if not force:+ if not click.confirm("Are you sure?", default=False):+ console.print("Cancelled.")+ await engine.dispose()+ return++ # Collect page IDs, clean FTS, delete repo+ async with get_session(sf) as session:+ page_ids = await list_page_ids(session, rid)++ fts = FullTextSearch(engine)+ await fts.delete_many(page_ids)++ await delete_repository(session, rid)++ console.print(+ f"[bold green]Deleted[/bold green] {name} — "+ f"{len(page_ids)} pages removed."+ )++ await engine.dispose()++ run_async(_run())diff --git a/packages/cli/src/repowise/cli/main.py b/packages/cli/src/repowise/cli/main.pyindex 2925eae89..3641c1266 100644--- a/packages/cli/src/repowise/cli/main.py+++ b/packages/cli/src/repowise/cli/main.py@@ -9,6 +9,7 @@ from repowise.cli.commands.augment_cmd import augment_commandfrom repowise.cli.commands.claude_md_cmd import claude_md_commandfrom repowise.cli.commands.costs_cmd import costs_commandfrom repowise.cli.commands.dead_code_cmd import dead_code_command+from repowise.cli.commands.delete_cmd import delete_commandfrom repowise.cli.commands.decision_cmd import decision_groupfrom repowise.cli.commands.doctor_cmd import doctor_commandfrom repowise.cli.commands.export_cmd import export_command@@ -45,6 +46,7 @@ def cli(ctx: click.Context) -> None:cli.add_command(augment_command)cli.add_command(init_command)+cli.add_command(delete_command)cli.add_command(claude_md_command)cli.add_command(costs_command)cli.add_command(update_command)diff --git a/packages/core/src/repowise/core/persistence/__init__.py b/packages/core/src/repowise/core/persistence/__init__.pyindex 16505ed2b..95607d7b5 100644--- a/packages/core/src/repowise/core/persistence/__init__.py+++ b/packages/core/src/repowise/core/persistence/__init__.py@@ -26,6 +26,7 @@ from .crud import (create_conversation,delete_conversation,delete_decision,+ delete_repository,get_all_file_metrics,get_all_git_metadata,get_community_members,@@ -52,6 +53,7 @@ from .crud import (list_chat_messages,list_conversations,list_decisions,+ list_page_ids,list_pages,mark_webhook_processed,recompute_decision_staleness,@@ -161,6 +163,7 @@ __all__ = ["create_session_factory","delete_conversation","delete_decision",+ "delete_repository",# git metadata crud"get_all_git_metadata","get_configured_db_url",@@ -186,6 +189,7 @@ __all__ = ["list_chat_messages","list_conversations","list_decisions",+ "list_page_ids","list_pages","mark_webhook_processed","recompute_decision_staleness",diff --git a/packages/core/src/repowise/core/persistence/crud.py b/packages/core/src/repowise/core/persistence/crud.pyindex 2624b67be..fbba7fe34 100644--- a/packages/core/src/repowise/core/persistence/crud.py+++ b/packages/core/src/repowise/core/persistence/crud.py@@ -111,6 +111,30 @@ async def get_repository_by_path(session: AsyncSession, local_path: str) -> Reporeturn result.scalar_one_or_none()+async def delete_repository(session: AsyncSession, repo_id: str) -> bool:+ """Delete a repository and all cascaded children.++ Returns True if deleted, False if not found.++ NOTE: The caller should clean up the FTS index *before* calling this,+ since the CASCADE will delete Page rows and we lose the page IDs.+ """+ repo = await session.get(Repository, repo_id)+ if repo is None:+ return False+ await session.delete(repo)+ await session.flush()+ return True+++async def list_page_ids(session: AsyncSession, repository_id: str) -> list[str]:+ """Return all page IDs for a repository (lightweight, ID-only query)."""+ result = await session.execute(+ select(Page.id).where(Page.repository_id == repository_id)+ )+ return list(result.scalars().all())++# ---------------------------------------------------------------------------# GenerationJob CRUD# ---------------------------------------------------------------------------diff --git a/packages/core/src/repowise/core/persistence/search.py b/packages/core/src/repowise/core/persistence/search.pyindex cc2023c7d..0f35358c3 100644--- a/packages/core/src/repowise/core/persistence/search.py+++ b/packages/core/src/repowise/core/persistence/search.py@@ -217,6 +217,24 @@ class FullTextSearch:{"pid": page_id},)+ async def delete_many(self, page_ids: list[str]) -> None:+ """Remove multiple pages from the FTS index in a single transaction."""+ if not page_ids:+ return+ if self._dialect == "sqlite":+ # Chunk to stay under SQLite's default 999-parameter limit per statement.+ chunk_size = 500+ async with self._engine.begin() as conn:+ for start in range(0, len(page_ids), chunk_size):+ chunk = page_ids[start : start + chunk_size]+ placeholders = ", ".join(f":p{i}" for i in range(len(chunk)))+ params = {f"p{i}": pid for i, pid in enumerate(chunk)}+ await conn.execute(+ text(f"DELETE FROM page_fts WHERE page_id IN ({placeholders})"),+ params,+ )+ # PostgreSQL: rows deleted via CASCADE automatically remove from GIN index.+async def list_indexed_ids(self) -> set[str]:"""Return the set of page IDs currently in the FTS index.diff --git a/packages/server/src/repowise/server/routers/repos.py b/packages/server/src/repowise/server/routers/repos.pyindex 3bf4728a6..ba5b359dd 100644--- a/packages/server/src/repowise/server/routers/repos.py+++ b/packages/server/src/repowise/server/routers/repos.py@@ -22,7 +22,7 @@ from repowise.core.persistence.models import (Page,Repository,)-from repowise.server.deps import get_db_session, verify_api_key+from repowise.server.deps import get_db_session, get_fts, verify_api_keyfrom repowise.server.job_executor import execute_jobfrom repowise.server.schemas import RepoCreate, RepoResponse, RepoStatsResponse, RepoUpdate@@ -204,6 +204,32 @@ async def update_repo(return RepoResponse.from_orm(repo)[email protected]("/{repo_id}")+async def delete_repo(+ repo_id: str,+ session: AsyncSession = Depends(get_db_session), # noqa: B008+ fts=Depends(get_fts), # noqa: B008+) -> dict:+ """Delete a repository and all its data."""+ repo = await crud.get_repository(session, repo_id)+ if repo is None:+ raise HTTPException(status_code=404, detail="Repository not found")++ # Collect page IDs before CASCADE deletes the Page rows+ page_ids = await crud.list_page_ids(session, repo_id)++ # Clean up FTS index (FTS5 virtual table has no FK cascade).+ # fts is always initialized in the lifespan before the server accepts+ # requests, so this guard is purely defensive.+ if fts is not None:+ await fts.delete_many(page_ids)++ # Delete repository — CASCADE handles all child ORM tables+ await crud.delete_repository(session, repo_id)++ return {"ok": True, "deleted_pages": len(page_ids)}++@router.get("/{repo_id}/stats", response_model=RepoStatsResponse)async def get_repo_stats(repo_id: str,diff --git a/packages/web/src/app/page.tsx b/packages/web/src/app/page.tsxindex 9bf4105da..91dd01cf9 100644--- a/packages/web/src/app/page.tsx+++ b/packages/web/src/app/page.tsx@@ -22,6 +22,7 @@ import { ConfidenceBadge } from "@repowise-dev/ui/wiki/confidence-badge";import { EmptyState } from "@repowise-dev/ui/shared/empty-state";import { formatRelativeTime, formatNumber } from "@repowise-dev/ui/lib/format";import { scoreToStatus } from "@repowise-dev/ui/lib/confidence";+import { DeleteRepoButton } from "@/components/repos/delete-repo-button";export const metadata: Metadata = { title: "Dashboard" };@@ -132,48 +133,51 @@ export default async function DashboardPage() {) : (<ul className="divide-y divide-[var(--color-border-default)]">{repoList.map((repo) => (- <li key={repo.id}>- <Link- href={`/repos/${repo.id}`}- className="flex items-start gap-3 px-6 py-3.5 transition-colors hover:bg-[var(--color-bg-elevated)] group"- >- <div className="mt-0.5 h-2 w-2 rounded-full bg-[var(--color-accent-primary)] shrink-0" />- <div className="flex-1 min-w-0">- <div className="flex items-center gap-2">- <p className="text-sm font-medium text-[var(--color-text-primary)] truncate group-hover:text-[var(--color-accent-primary)] transition-colors">- {repo.name}- </p>- </div>- <div className="flex items-center gap-2 mt-0.5">- <p className="text-xs text-[var(--color-text-tertiary)] font-mono truncate" title={repo.local_path}>- {repo.local_path}- </p>- </div>- <div className="flex items-center gap-2 mt-1 flex-wrap">- {repo.head_commit && (- <span className="text-xs font-mono text-[var(--color-text-tertiary)]">- {repo.head_commit.slice(0, 7)}+ <li key={repo.id} className="group">+ <div className="flex items-start gap-3 px-6 py-3.5 transition-colors hover:bg-[var(--color-bg-elevated)]">+ <Link+ href={`/repos/${repo.id}`}+ className="flex items-start gap-3 flex-1 min-w-0"+ >+ <div className="mt-0.5 h-2 w-2 rounded-full bg-[var(--color-accent-primary)] shrink-0" />+ <div className="flex-1 min-w-0">+ <div className="flex items-center gap-2">+ <p className="text-sm font-medium text-[var(--color-text-primary)] truncate group-hover:text-[var(--color-accent-primary)] transition-colors">+ {repo.name}+ </p>+ </div>+ <div className="flex items-center gap-2 mt-0.5">+ <p className="text-xs text-[var(--color-text-tertiary)] font-mono truncate" title={repo.local_path}>+ {repo.local_path}+ </p>+ </div>+ <div className="flex items-center gap-2 mt-1 flex-wrap">+ {repo.head_commit && (+ <span className="text-xs font-mono text-[var(--color-text-tertiary)]">+ {repo.head_commit.slice(0, 7)}+ </span>+ )}+ <span className="text-xs text-[var(--color-text-tertiary)]">+ Updated {formatRelativeTime(repo.updated_at)}</span>- )}- <span className="text-xs text-[var(--color-text-tertiary)]">- Updated {formatRelativeTime(repo.updated_at)}- </span>- {gitMap.has(repo.id) && (() => {- const g = gitMap.get(repo.id)!;- return (- <>- {g.hotspot_count > 0 && (- <Badge variant="outdated">{g.hotspot_count} hotspot{g.hotspot_count !== 1 ? "s" : ""}</Badge>- )}- {g.stable_count > 0 && (- <Badge variant="fresh">{g.stable_count} stable</Badge>- )}- </>- );- })()}+ {gitMap.has(repo.id) && (() => {+ const g = gitMap.get(repo.id)!;+ return (+ <>+ {g.hotspot_count > 0 && (+ <Badge variant="outdated">{g.hotspot_count} hotspot{g.hotspot_count !== 1 ? "s" : ""}</Badge>+ )}+ {g.stable_count > 0 && (+ <Badge variant="fresh">{g.stable_count} stable</Badge>+ )}+ </>+ );+ })()}+ </div></div>- </div>- </Link>+ </Link>+ <DeleteRepoButton repoId={repo.id} repoName={repo.name} />+ </div></li>))}</ul>diff --git a/packages/web/src/app/repos/[id]/settings/page.tsx b/packages/web/src/app/repos/[id]/settings/page.tsxindex c7904159a..8676b42df 100644--- a/packages/web/src/app/repos/[id]/settings/page.tsx+++ b/packages/web/src/app/repos/[id]/settings/page.tsx@@ -5,6 +5,7 @@ import { getRepo } from "@/lib/api/repos";import { getCoordinatorHealth } from "@/lib/api/health";import { RepoSettingsFormWrapper as RepoSettingsForm } from "@/components/repos/repo-settings-form-wrapper";import { CoordinatorHealthPanel } from "@/components/repos/coordinator-health-panel";+import { DeleteRepoButton } from "@/components/repos/delete-repo-button";import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@repowise-dev/ui/ui/card";import { Separator } from "@repowise-dev/ui/ui/separator";import { OperationsPanel } from "@/components/repos/operations-panel";@@ -97,6 +98,20 @@ export default async function RepoSettingsPage({ params }: Props) {))}</div></div>++ <Separator />++ <Card className="border-red-900/30">+ <CardHeader>+ <CardTitle className="text-sm font-medium text-red-400">Danger Zone</CardTitle>+ <CardDescription>+ Permanently delete this repository and all its generated pages, symbols, and history.+ </CardDescription>+ </CardHeader>+ <CardContent>+ <DeleteRepoButton repoId={id} repoName={repo.name} variant="button" redirectTo="/" />+ </CardContent>+ </Card></div>);}diff --git a/packages/web/src/components/repos/delete-repo-button.tsx b/packages/web/src/components/repos/delete-repo-button.tsxnew file mode 100644index 000000000..fc1c7ea76--- /dev/null+++ b/packages/web/src/components/repos/delete-repo-button.tsx@@ -0,0 +1,102 @@+"use client";++import { useState } from "react";+import { useRouter } from "next/navigation";+import { toast } from "sonner";+import { Trash2, AlertTriangle } from "lucide-react";+import { deleteRepo } from "@/lib/api/repos";+import { Button } from "@repowise-dev/ui/ui/button";+import {+ Dialog,+ DialogContent,+ DialogHeader,+ DialogTitle,+ DialogFooter,+} from "@repowise-dev/ui/ui/dialog";++interface DeleteRepoButtonProps {+ repoId: string;+ repoName: string;+ variant?: "icon" | "button";+ redirectTo?: string;+}++export function DeleteRepoButton({+ repoId,+ repoName,+ variant = "icon",+ redirectTo,+}: DeleteRepoButtonProps) {+ const [open, setOpen] = useState(false);+ const [deleting, setDeleting] = useState(false);+ const router = useRouter();++ async function handleDelete() {+ setDeleting(true);+ try {+ const result = await deleteRepo(repoId);+ toast.success(`Deleted ${repoName} — ${result.deleted_pages} pages removed`);+ setOpen(false);+ if (redirectTo) {+ router.push(redirectTo);+ } else {+ router.refresh();+ }+ } catch (err) {+ toast.error(`Failed to delete: ${err instanceof Error ? err.message : "Unknown error"}`);+ } finally {+ setDeleting(false);+ }+ }++ return (+ <>+ {variant === "button" ? (+ <Button+ variant="destructive"+ size="sm"+ onClick={() => setOpen(true)}+ >+ <Trash2 className="h-3.5 w-3.5 mr-1.5" />+ Delete Repository+ </Button>+ ) : (+ <button+ onClick={(e) => {+ e.preventDefault();+ e.stopPropagation();+ setOpen(true);+ }}+ className="opacity-0 group-hover:opacity-100 p-1 text-[var(--color-text-tertiary)] hover:text-red-400 transition-all"+ title="Delete repository"+ >+ <Trash2 className="h-3.5 w-3.5" />+ </button>+ )}++ <Dialog open={open} onOpenChange={setOpen}>+ <DialogContent className="sm:max-w-sm">+ <DialogHeader>+ <DialogTitle className="flex items-center gap-2">+ <AlertTriangle className="h-4 w-4 text-[var(--color-stale)]" />+ Delete Repository+ </DialogTitle>+ </DialogHeader>+ <p className="text-sm text-[var(--color-text-secondary)]">+ This will permanently delete{" "}+ <span className="font-medium text-[var(--color-text-primary)]">{repoName}</span>{" "}+ and all its generated pages, symbols, and history.+ </p>+ <DialogFooter>+ <Button variant="ghost" onClick={() => setOpen(false)}>+ Cancel+ </Button>+ <Button variant="destructive" onClick={handleDelete} disabled={deleting}>+ {deleting ? "Deleting..." : "Delete Repository"}+ </Button>+ </DialogFooter>+ </DialogContent>+ </Dialog>+ </>+ );+}diff --git a/packages/web/src/lib/api/repos.ts b/packages/web/src/lib/api/repos.tsindex d9b8b047e..a0d3c0382 100644--- a/packages/web/src/lib/api/repos.ts+++ b/packages/web/src/lib/api/repos.ts@@ -1,4 +1,4 @@-import { apiGet, apiPost, apiPatch } from "./client";+import { apiGet, apiPost, apiPatch, apiDelete } from "./client";import type { RepoCreate, RepoUpdate, RepoResponse, JobResponse, RepoStatsResponse } from "./types";export async function listRepos(): Promise<RepoResponse[]> {@@ -25,6 +25,10 @@ export async function fullResyncRepo(repoId: string): Promise<JobResponse> {return apiPost<JobResponse>(`/api/repos/${repoId}/full-resync`);}+export async function deleteRepo(repoId: string): Promise<{ ok: boolean; deleted_pages: number }> {+ return apiDelete<{ ok: boolean; deleted_pages: number }>(`/api/repos/${repoId}`);+}+export async function getRepoStats(repoId: string): Promise<RepoStatsResponse> {return apiGet<RepoStatsResponse>(`/api/repos/${repoId}/stats`);}diff --git a/tests/unit/persistence/test_crud.py b/tests/unit/persistence/test_crud.pyindex 981c34d2f..07bd23b2f 100644--- a/tests/unit/persistence/test_crud.py+++ b/tests/unit/persistence/test_crud.py@@ -15,12 +15,14 @@ from repowise.core.persistence.crud import (batch_upsert_graph_edges,batch_upsert_graph_nodes,batch_upsert_symbols,+ delete_repository,get_generation_job,get_page,get_page_versions,get_repository,get_repository_by_path,get_stale_pages,+ list_page_ids,list_pages,mark_webhook_processed,store_webhook_event,@@ -72,6 +74,32 @@ async def test_get_repository_returns_inserted(async_session):assert found.id == repo.id+async def test_delete_repository_success(async_session):+ repo = await insert_repo(async_session, name="doomed", local_path="/tmp/doomed")+ repo_id = repo.id+ await async_session.commit()++ deleted = await delete_repository(async_session, repo_id)+ await async_session.commit()+ assert deleted is True+ assert await get_repository(async_session, repo_id) is None+++async def test_delete_repository_not_found(async_session):+ deleted = await delete_repository(async_session, "nonexistent")+ assert deleted is False+++async def test_list_page_ids(async_session):+ repo = await insert_repo(async_session)+ kwargs = make_page_kwargs(repo.id)+ page = await upsert_page(async_session, **kwargs)+ await async_session.commit()++ ids = await list_page_ids(async_session, repo.id)+ assert page.id in ids++# ---------------------------------------------------------------------------# GenerationJob CRUD# ---------------------------------------------------------------------------diff --git a/tests/unit/server/test_repos.py b/tests/unit/server/test_repos.pyindex 8c861291a..02867e7ba 100644--- a/tests/unit/server/test_repos.py+++ b/tests/unit/server/test_repos.py@@ -132,6 +132,24 @@ async def test_full_resync_duplicate_returns_409(client: AsyncClient) -> None:assert resp2.status_code == 409+async def test_delete_repo_success(client: AsyncClient) -> None:+ repo = await create_test_repo(client)+ resp = await client.delete(f"/api/repos/{repo['id']}")+ assert resp.status_code == 200+ data = resp.json()+ assert data["ok"] is True++ # Verify repo is gone+ resp = await client.get(f"/api/repos/{repo['id']}")+ assert resp.status_code == 404+++async def test_delete_repo_not_found(client: AsyncClient) -> None:+ resp = await client.delete("/api/repos/nonexistent")+ assert resp.status_code == 404+@pytest.mark.asyncioasync def test_export_wiki_not_found(client: AsyncClient) -> None: