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
/**
* REST client for the C4 endpoints.
* Backend: packages/server/src/repowise/server/routers/c4.py
*/
import { apiGet, BASE_URL, buildHeaders, doFetch } from "./client";
import type { C4L1, C4L2, C4L3, ArchitectureView } from "@repowise-dev/ui/c4";
export async function getC4L1(repoId: string): Promise<C4L1> {
return apiGet<C4L1>(`/api/graph/${repoId}/c4/l1`);
}
export async function getC4L2(repoId: string): Promise<C4L2> {
return apiGet<C4L2>(`/api/graph/${repoId}/c4/l2`);
}
export async function getC4L3(repoId: string, containerId: string): Promise<C4L3> {
return apiGet<C4L3>(`/api/graph/${repoId}/c4/l3`, { container_id: containerId });
}
/**
* Fetch the Mermaid C4 source for the current view. Backend is the source
* of truth so the exported diagram matches what the API serves.
*/
export async function getC4Mermaid(
repoId: string,
level: 1 | 2 | 3,
containerId?: string | null,
): Promise<string> {
const params = new URLSearchParams({ level: String(level) });
if (level === 3 && containerId) params.set("container_id", containerId);
const res = await doFetch(`${BASE_URL}/api/graph/${repoId}/c4/mermaid?${params.toString()}`, {
headers: buildHeaders(),
});
if (!res.ok) {
throw new Error(`Failed to fetch Mermaid C4 source (${res.status})`);
}
return res.text();
}
export interface StructurizrOptions {
/** Emit a complete runnable workspace instead of a model fragment. */
standalone?: boolean;
/** Include the component (L3) level — one box per directory. */
components?: boolean;
/** Include third-party dependencies. Defaults to true server-side. */
externals?: boolean;
}
/**
* Fetch the Structurizr DSL for this repository.
*
* Text rather than JSON, like `getC4Mermaid` — the DSL is the artefact people
* commit and read, so the backend returns it verbatim.
*/
export async function getStructurizrDsl(
repoId: string,
options: StructurizrOptions = {},
): Promise<string> {
const params = new URLSearchParams();
if (options.standalone) params.set("standalone", "true");
if (options.components) params.set("components", "true");
if (options.externals === false) params.set("externals", "false");
const query = params.toString();
const res = await doFetch(
`${BASE_URL}/api/graph/${repoId}/c4/structurizr${query ? `?${query}` : ""}`,
{ headers: buildHeaders() },
);
if (!res.ok) {
throw new Error(`Failed to fetch Structurizr DSL (${res.status})`);
}
return res.text();
}
export async function getArchitectureView(
repoId: string,
includeSymbols: boolean = false,
): Promise<ArchitectureView> {
return apiGet<ArchitectureView>(`/api/graph/${repoId}/architecture-view`, {
include_symbols: includeSymbols,
});
}