Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

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.py
new file mode 100644
index 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]("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.py
index 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_command
from repowise.cli.commands.claude_md_cmd import claude_md_command
from repowise.cli.commands.costs_cmd import costs_command
from repowise.cli.commands.dead_code_cmd import dead_code_command
+from repowise.cli.commands.delete_cmd import delete_command
from repowise.cli.commands.decision_cmd import decision_group
from repowise.cli.commands.doctor_cmd import doctor_command
from 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__.py
index 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.py
index 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) -> Repo
return 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.py
index 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.py
index 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_key
from repowise.server.job_executor import execute_job
from 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.tsx
index 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.tsx
index 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.tsx
new file mode 100644
index 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.ts
index 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.py
index 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.py
index 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.asyncio
async def test_export_wiki_not_found(client: AsyncClient) -> None: