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
/**
* Shape of `serve.lock.json`, written by the running server after it binds a
* port. `url` is always a loopback address even when the server binds a
* wildcard host, so it is safe to probe directly.
*/
export interface ServeLock {
pid: number;
host: string;
port: number;
url: string;
ui_port: number | null;
server_version: string;
started_at: string;
}
/** Validates parsed lockfile JSON. Pure, so it runs without file or process access. */
export function isServeLock(value: unknown): value is ServeLock {
if (typeof value !== "object" || value === null) return false;
const v = value as Record<string, unknown>;
return (
typeof v.pid === "number" &&
typeof v.host === "string" &&
typeof v.port === "number" &&
typeof v.url === "string" &&
(typeof v.ui_port === "number" || v.ui_port === null) &&
typeof v.server_version === "string" &&
typeof v.started_at === "string"
);
}
const LOOPBACK_V4 = /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/;
/**
* Whether a URL is plain http(s) on this machine: `localhost`, 127.0.0.0/8 or
* `::1`. The lockfile sits in the repo, so a cloned repo can carry one naming
* any host; consumers check this before probing or talking to `url`.
*/
export function isLoopbackUrl(url: string): boolean {
try {
const u = new URL(url);
if (u.protocol !== "http:" && u.protocol !== "https:") return false;
return u.hostname === "localhost" || u.hostname === "[::1]" || LOOPBACK_V4.test(u.hostname);
} catch {
return false;
}
}