@tea-agent/loop-agent 0.13.0-beta.0 → 0.13.0

package/dist/worker/observe/static/kpi.js

@@ -1,94 +1,94 @@
-/** KPI cards, repo banner, projection fault, artifact/inbox links. */
-import { UI_TEXT } from "./constants.js";
-import { clearNode, el } from "./dom.js";
-import { repoBaseName } from "./format.js";
-import { navigate } from "./router.js";
-
-export function failuresInboxLink(count) {
-	const wrap = el("span");
-	wrap.appendChild(document.createTextNode(`${count} `));
-	const a = el("a", "inbox-link", `${UI_TEXT.failureInbox} →`);
-	a.href = "#/failures";
-	a.addEventListener("click", (e) => {
-		e.preventDefault();
-		navigate("/failures");
-	});
-	wrap.appendChild(a);
-	return wrap;
-}
-
-export function artifactLink(label, refPath) {
-	if (!refPath) return el("span", "muted", "—");
-	const a = el("a", "artifact-link", label);
-	a.href = `/api/artifacts?path=${encodeURIComponent(refPath)}&tail=200`;
-	a.target = "_blank";
-	return a;
-}
-
-let kpiHelpSeed = 0;
-export function kpiCard(label, value, extraClass, helpText) {
-	const card = el("div", `kpi-card${extraClass ? ` ${extraClass}` : ""}`);
-	card.appendChild(el("div", "kpi-label", label));
-	const valueWrap = el("div", "kpi-value-row");
-	const valueEl = el("div", "kpi-value");
-	if (value instanceof Node) valueEl.appendChild(value);
-	else valueEl.textContent = String(value);
-	valueWrap.appendChild(valueEl);
-	if (helpText) {
-		kpiHelpSeed += 1;
-		const tipId = `kpi-tip-${kpiHelpSeed}`;
-		const helpBtn = el("button", "kpi-help");
-		helpBtn.type = "button";
-		helpBtn.setAttribute("aria-describedby", tipId);
-		helpBtn.setAttribute("aria-label", `${label} 指标说明`);
-		const icon = el("i", "ri-question-line");
-		icon.setAttribute("aria-hidden", "true");
-		helpBtn.appendChild(icon);
-		const tip = el("span", "kpi-tip");
-		tip.id = tipId;
-		tip.setAttribute("role", "tooltip");
-		tip.textContent = helpText;
-		valueWrap.appendChild(helpBtn);
-		valueWrap.appendChild(tip);
-	}
-	card.appendChild(valueWrap);
-	return card;
-}
-
-export function renderRepoBanner(repoEl, snapshot) {
-	if (!repoEl) return;
-	clearNode(repoEl);
-	const repoRoot = snapshot.repoRoot ?? "";
-	const icon = el("i", "ri-git-repository-line");
-	icon.setAttribute("aria-hidden", "true");
-	repoEl.appendChild(icon);
-	const text = el("div", "repo-banner-text");
-	text.appendChild(el("span", "repo-banner-name", repoBaseName(repoRoot)));
-	const pathLine = el("span", "repo-banner-path", repoRoot || "路径未知");
-	pathLine.title = repoRoot || "";
-	text.appendChild(pathLine);
-	repoEl.appendChild(text);
-}
-
-export function renderProjectionFault(error) {
-	const banner = el("div", "projection-fault");
-	banner.setAttribute("role", "alert");
-	const icon = el("i", "ri-error-warning-line");
-	icon.setAttribute("aria-hidden", "true");
-	banner.appendChild(icon);
-	const body = el("div", "projection-fault-body");
-	body.appendChild(
-		el("p", "projection-fault-title", "指标暂不可用：数据投影失败。"),
-	);
-	body.appendChild(
-		el(
-			"p",
-			"projection-fault-message",
-			error.message ?? "投影失败 (projection failed)",
-		),
-	);
-	if (error.at)
-		body.appendChild(el("p", "projection-fault-at", `发生时间：${error.at}`));
-	banner.appendChild(body);
-	return banner;
-}
+/** KPI cards, repo banner, projection fault, artifact/inbox links. */
+import { UI_TEXT } from "./constants.js";
+import { clearNode, el } from "./dom.js";
+import { repoBaseName } from "./format.js";
+import { navigate } from "./router.js";
+
+export function failuresInboxLink(count) {
+	const wrap = el("span");
+	wrap.appendChild(document.createTextNode(`${count} `));
+	const a = el("a", "inbox-link", `${UI_TEXT.failureInbox} →`);
+	a.href = "#/failures";
+	a.addEventListener("click", (e) => {
+		e.preventDefault();
+		navigate("/failures");
+	});
+	wrap.appendChild(a);
+	return wrap;
+}
+
+export function artifactLink(label, refPath) {
+	if (!refPath) return el("span", "muted", "—");
+	const a = el("a", "artifact-link", label);
+	a.href = `/api/artifacts?path=${encodeURIComponent(refPath)}&tail=200`;
+	a.target = "_blank";
+	return a;
+}
+
+let kpiHelpSeed = 0;
+export function kpiCard(label, value, extraClass, helpText) {
+	const card = el("div", `kpi-card${extraClass ? ` ${extraClass}` : ""}`);
+	card.appendChild(el("div", "kpi-label", label));
+	const valueWrap = el("div", "kpi-value-row");
+	const valueEl = el("div", "kpi-value");
+	if (value instanceof Node) valueEl.appendChild(value);
+	else valueEl.textContent = String(value);
+	valueWrap.appendChild(valueEl);
+	if (helpText) {
+		kpiHelpSeed += 1;
+		const tipId = `kpi-tip-${kpiHelpSeed}`;
+		const helpBtn = el("button", "kpi-help");
+		helpBtn.type = "button";
+		helpBtn.setAttribute("aria-describedby", tipId);
+		helpBtn.setAttribute("aria-label", `${label} 指标说明`);
+		const icon = el("i", "ri-question-line");
+		icon.setAttribute("aria-hidden", "true");
+		helpBtn.appendChild(icon);
+		const tip = el("span", "kpi-tip");
+		tip.id = tipId;
+		tip.setAttribute("role", "tooltip");
+		tip.textContent = helpText;
+		valueWrap.appendChild(helpBtn);
+		valueWrap.appendChild(tip);
+	}
+	card.appendChild(valueWrap);
+	return card;
+}
+
+export function renderRepoBanner(repoEl, snapshot) {
+	if (!repoEl) return;
+	clearNode(repoEl);
+	const repoRoot = snapshot.repoRoot ?? "";
+	const icon = el("i", "ri-git-repository-line");
+	icon.setAttribute("aria-hidden", "true");
+	repoEl.appendChild(icon);
+	const text = el("div", "repo-banner-text");
+	text.appendChild(el("span", "repo-banner-name", repoBaseName(repoRoot)));
+	const pathLine = el("span", "repo-banner-path", repoRoot || "路径未知");
+	pathLine.title = repoRoot || "";
+	text.appendChild(pathLine);
+	repoEl.appendChild(text);
+}
+
+export function renderProjectionFault(error) {
+	const banner = el("div", "projection-fault");
+	banner.setAttribute("role", "alert");
+	const icon = el("i", "ri-error-warning-line");
+	icon.setAttribute("aria-hidden", "true");
+	banner.appendChild(icon);
+	const body = el("div", "projection-fault-body");
+	body.appendChild(
+		el("p", "projection-fault-title", "指标暂不可用：数据投影失败。"),
+	);
+	body.appendChild(
+		el(
+			"p",
+			"projection-fault-message",
+			error.message ?? "投影失败 (projection failed)",
+		),
+	);
+	if (error.at)
+		body.appendChild(el("p", "projection-fault-at", `发生时间：${error.at}`));
+	banner.appendChild(body);
+	return banner;
+}

package/dist/worker/observe/static/relations.js

@@ -1,133 +1,133 @@
-/** Object relation navigation (Observe UI R5). */
-import { el } from "./dom.js";
-import { navigate } from "./router.js";
-
-export function objectExistsInSnapshot(kind, id, snapshot, featureId) {
-	if (!id) return false;
-	if (kind === "feature") {
-		return (snapshot?.features ?? []).some((f) => f.featureId === id);
-	}
-	if (kind === "task") {
-		return (snapshot?.tasks ?? []).some(
-			(t) => t.taskId === id && (!featureId || t.featureId === featureId),
-		);
-	}
-	if (kind === "batch") {
-		return (snapshot?.batches ?? []).some((b) => b.batchRunId === id);
-	}
-	if (kind === "run") {
-		return (
-			(snapshot?.tasks ?? []).some((t) => t.workerRunId === id) ||
-			(snapshot?.batches ?? []).some((b) =>
-				(b.tasks ?? []).some((t) => t.workerRunId === id),
-			)
-		);
-	}
-	if (kind === "dag") {
-		return (snapshot?.dagRuns ?? []).some((d) => d.dagRunId === id);
-	}
-	return false;
-}
-
-export function objectRoutePath(kind, id, featureId) {
-	if (kind === "feature") return `/feature/${encodeURIComponent(id)}`;
-	if (kind === "task" && featureId) {
-		return `/feature/${encodeURIComponent(featureId)}/task/${encodeURIComponent(id)}`;
-	}
-	if (kind === "task") return `/task/${encodeURIComponent(id)}`;
-	if (kind === "batch") return `/batch/${encodeURIComponent(id)}`;
-	if (kind === "run") return `/run/${encodeURIComponent(id)}`;
-	if (kind === "dag") return `/dag/${encodeURIComponent(id)}`;
-	return "/";
-}
-
-/** Hash-route link only when id is present and snapshot contains the object. */
-export function objectRouteLink(kind, id, snapshot, featureId) {
-	if (!id) return el("span", "muted", "缺失");
-	const exists = objectExistsInSnapshot(kind, id, snapshot, featureId);
-	if (!exists) return el("span", "muted", id);
-	const path = objectRoutePath(kind, id, featureId);
-	const a = el("a", "object-link", id);
-	a.href = `#${path}`;
-	a.addEventListener("click", (e) => {
-		e.preventDefault();
-		e.stopPropagation();
-		navigate(path);
-	});
-	return a;
-}
-
-export function findFeatureInSnapshot(snapshot, featureId) {
-	if (!featureId) return undefined;
-	return (snapshot?.features ?? []).find((f) => f.featureId === featureId);
-}
-
-export function featureLookupState(snapshot, featureId) {
-	if (!snapshot) return { kind: "unavailable" };
-	const feature = findFeatureInSnapshot(snapshot, featureId);
-	return feature ? { kind: "found", feature } : { kind: "missing" };
-}
-
-export const RELATION_KIND_ORDER = ["feature", "task", "batch", "run", "dag"];
-export const RELATION_LABELS = {
-	feature: "Feature",
-	task: "Task",
-	batch: "Batch",
-	run: "Run",
-	dag: "DAG",
-};
-
-/**
- * Build proven relation descriptors only (id present AND object in snapshot).
- * Never infers links from identifier naming.
- */
-export function buildObjectRelations(ids, snapshot) {
-	const input = ids ?? {};
-	const candidates = [
-		{ kind: "feature", id: input.featureId },
-		{ kind: "task", id: input.taskId, featureId: input.featureId },
-		{ kind: "batch", id: input.batchRunId },
-		{ kind: "run", id: input.workerRunId },
-		{ kind: "dag", id: input.dagRunId },
-	];
-	const out = [];
-	for (const kind of RELATION_KIND_ORDER) {
-		const entry = candidates.find((c) => c.kind === kind);
-		if (!entry?.id) continue;
-		if (!objectExistsInSnapshot(kind, entry.id, snapshot, entry.featureId)) continue;
-		out.push({
-			kind,
-			id: entry.id,
-			label: RELATION_LABELS[kind] ?? kind,
-			featureId: entry.featureId,
-			href: `#${objectRoutePath(kind, entry.id, entry.featureId)}`,
-			path: objectRoutePath(kind, entry.id, entry.featureId),
-		});
-	}
-	return out;
-}
-
-export function renderObjectRelationBar(relations, snapshot) {
-	const bar = el("div", "object-relation-bar");
-	bar.setAttribute("aria-label", "对象关联");
-	const list = Array.isArray(relations)
-		? relations
-		: buildObjectRelations(relations, snapshot);
-	if (list.length === 0) {
-		bar.appendChild(el("span", "muted", "暂无已证明的对象关联"));
-		return bar;
-	}
-	list.forEach((rel, i) => {
-		if (i > 0) bar.appendChild(el("span", "object-relation-sep", "→"));
-		const item = el("span", "object-relation-item");
-		item.appendChild(el("span", "object-relation-label", rel.label));
-		item.appendChild(document.createTextNode(" "));
-		if (rel.href && rel.id) {
-			item.appendChild(objectRouteLink(rel.kind, rel.id, snapshot, rel.featureId));
-		} else {
-			item.appendChild(el("span", "muted", rel.id ?? "缺失"));
-		}
-		bar.appendChild(item);
-	});
-	return bar;
-}
+/** Object relation navigation (Observe UI R5). */
+import { el } from "./dom.js";
+import { navigate } from "./router.js";
+
+export function objectExistsInSnapshot(kind, id, snapshot, featureId) {
+	if (!id) return false;
+	if (kind === "feature") {
+		return (snapshot?.features ?? []).some((f) => f.featureId === id);
+	}
+	if (kind === "task") {
+		return (snapshot?.tasks ?? []).some(
+			(t) => t.taskId === id && (!featureId || t.featureId === featureId),
+		);
+	}
+	if (kind === "batch") {
+		return (snapshot?.batches ?? []).some((b) => b.batchRunId === id);
+	}
+	if (kind === "run") {
+		return (
+			(snapshot?.tasks ?? []).some((t) => t.workerRunId === id) ||
+			(snapshot?.batches ?? []).some((b) =>
+				(b.tasks ?? []).some((t) => t.workerRunId === id),
+			)
+		);
+	}
+	if (kind === "dag") {
+		return (snapshot?.dagRuns ?? []).some((d) => d.dagRunId === id);
+	}
+	return false;
+}
+
+export function objectRoutePath(kind, id, featureId) {
+	if (kind === "feature") return `/feature/${encodeURIComponent(id)}`;
+	if (kind === "task" && featureId) {
+		return `/feature/${encodeURIComponent(featureId)}/task/${encodeURIComponent(id)}`;
+	}
+	if (kind === "task") return `/task/${encodeURIComponent(id)}`;
+	if (kind === "batch") return `/batch/${encodeURIComponent(id)}`;
+	if (kind === "run") return `/run/${encodeURIComponent(id)}`;
+	if (kind === "dag") return `/dag/${encodeURIComponent(id)}`;
+	return "/";
+}
+
+/** Hash-route link only when id is present and snapshot contains the object. */
+export function objectRouteLink(kind, id, snapshot, featureId) {
+	if (!id) return el("span", "muted", "缺失");
+	const exists = objectExistsInSnapshot(kind, id, snapshot, featureId);
+	if (!exists) return el("span", "muted", id);
+	const path = objectRoutePath(kind, id, featureId);
+	const a = el("a", "object-link", id);
+	a.href = `#${path}`;
+	a.addEventListener("click", (e) => {
+		e.preventDefault();
+		e.stopPropagation();
+		navigate(path);
+	});
+	return a;
+}
+
+export function findFeatureInSnapshot(snapshot, featureId) {
+	if (!featureId) return undefined;
+	return (snapshot?.features ?? []).find((f) => f.featureId === featureId);
+}
+
+export function featureLookupState(snapshot, featureId) {
+	if (!snapshot) return { kind: "unavailable" };
+	const feature = findFeatureInSnapshot(snapshot, featureId);
+	return feature ? { kind: "found", feature } : { kind: "missing" };
+}
+
+export const RELATION_KIND_ORDER = ["feature", "task", "batch", "run", "dag"];
+export const RELATION_LABELS = {
+	feature: "Feature",
+	task: "Task",
+	batch: "Batch",
+	run: "Run",
+	dag: "DAG",
+};
+
+/**
+ * Build proven relation descriptors only (id present AND object in snapshot).
+ * Never infers links from identifier naming.
+ */
+export function buildObjectRelations(ids, snapshot) {
+	const input = ids ?? {};
+	const candidates = [
+		{ kind: "feature", id: input.featureId },
+		{ kind: "task", id: input.taskId, featureId: input.featureId },
+		{ kind: "batch", id: input.batchRunId },
+		{ kind: "run", id: input.workerRunId },
+		{ kind: "dag", id: input.dagRunId },
+	];
+	const out = [];
+	for (const kind of RELATION_KIND_ORDER) {
+		const entry = candidates.find((c) => c.kind === kind);
+		if (!entry?.id) continue;
+		if (!objectExistsInSnapshot(kind, entry.id, snapshot, entry.featureId)) continue;
+		out.push({
+			kind,
+			id: entry.id,
+			label: RELATION_LABELS[kind] ?? kind,
+			featureId: entry.featureId,
+			href: `#${objectRoutePath(kind, entry.id, entry.featureId)}`,
+			path: objectRoutePath(kind, entry.id, entry.featureId),
+		});
+	}
+	return out;
+}
+
+export function renderObjectRelationBar(relations, snapshot) {
+	const bar = el("div", "object-relation-bar");
+	bar.setAttribute("aria-label", "对象关联");
+	const list = Array.isArray(relations)
+		? relations
+		: buildObjectRelations(relations, snapshot);
+	if (list.length === 0) {
+		bar.appendChild(el("span", "muted", "暂无已证明的对象关联"));
+		return bar;
+	}
+	list.forEach((rel, i) => {
+		if (i > 0) bar.appendChild(el("span", "object-relation-sep", "→"));
+		const item = el("span", "object-relation-item");
+		item.appendChild(el("span", "object-relation-label", rel.label));
+		item.appendChild(document.createTextNode(" "));
+		if (rel.href && rel.id) {
+			item.appendChild(objectRouteLink(rel.kind, rel.id, snapshot, rel.featureId));
+		} else {
+			item.appendChild(el("span", "muted", rel.id ?? "缺失"));
+		}
+		bar.appendChild(item);
+	});
+	return bar;
+}

package/dist/worker/observe/static/router.js

@@ -1,93 +1,93 @@
-/** Hash routing for Observe UI (R5). */
-
-export function parseHashRoute(hashValue) {
-	const hash = (hashValue.replace(/^#/, "") || "/").split("?")[0] || "/";
-	const batchMatch = /^\/batch\/([^/]+)$/.exec(hash);
-	if (batchMatch) {
-		return { view: "batch", batchRunId: decodeURIComponent(batchMatch[1]) };
-	}
-	const runMatch = /^\/run\/([^/]+)$/.exec(hash);
-	if (runMatch) {
-		return { view: "run", workerRunId: decodeURIComponent(runMatch[1]) };
-	}
-	const dagMatch = /^\/dag\/([^/]+)$/.exec(hash);
-	if (dagMatch) {
-		return { view: "dag", dagRunId: decodeURIComponent(dagMatch[1]) };
-	}
-	const featureTaskMatch = /^\/feature\/([^/]+)\/task\/([^/]+)$/.exec(hash);
-	if (featureTaskMatch) {
-		return {
-			view: "task",
-			featureId: decodeURIComponent(featureTaskMatch[1]),
-			taskId: decodeURIComponent(featureTaskMatch[2]),
-		};
-	}
-	const taskMatch = /^\/task\/([^/]+)$/.exec(hash);
-	if (taskMatch) {
-		return { view: "task", taskId: decodeURIComponent(taskMatch[1]) };
-	}
-	const featureMatch = /^\/feature\/([^/]+)$/.exec(hash);
-	if (featureMatch) {
-		return {
-			view: "feature",
-			featureId: decodeURIComponent(featureMatch[1]),
-		};
-	}
-	if (hash === "/pool") {
-		return { view: "pool" };
-	}
-	if (hash === "/failures") {
-		return { view: "failures" };
-	}
-	if (hash === "/dags") {
-		return { view: "dashboard", scrollTo: "dags" };
-	}
-	return { view: "dashboard" };
-}
-
-/** Active (non-terminal) statuses sort first; terminals by updatedAt desc. */
-
-export function parseRoute() {
-	return parseHashRouteWithFilters(location.hash);
-}
-
-export function navigate(path) {
-	location.hash = path.startsWith("#") ? path.slice(1) : path;
-}
-
-/**
- * Parse optional filter query after a hash path: #/pool?status=failed
- * Returns { filters: { status?, q? } } merged into route; unknown keys ignored.
- * Base parseHashRoute shape is preserved for all existing views.
- */
-export function parseHashFilters(hashValue) {
-	const raw = String(hashValue ?? "").replace(/^#/, "");
-	const qIndex = raw.indexOf("?");
-	if (qIndex < 0) return {};
-	const qs = raw.slice(qIndex + 1);
-	const params = new URLSearchParams(qs);
-	const filters = {};
-	const status = params.get("status");
-	const q = params.get("q");
-	if (status) filters.status = status;
-	if (q) filters.q = q;
-	return filters;
-}
-
-export function parseHashRouteWithFilters(hashValue) {
-	const raw = String(hashValue ?? "");
-	const withoutQuery = raw.replace(/^#/, "").split("?")[0];
-	const base = parseHashRoute("#" + (withoutQuery || "/"));
-	const filters = parseHashFilters(raw);
-	if (Object.keys(filters).length === 0) return base;
-	return { ...base, filters };
-}
-
-export function buildHashPath(path, filters = {}) {
-	const base = path.startsWith("#") ? path.slice(1) : path;
-	const params = new URLSearchParams();
-	if (filters.status) params.set("status", filters.status);
-	if (filters.q) params.set("q", filters.q);
-	const qs = params.toString();
-	return qs ? `${base}?${qs}` : base;
-}
+/** Hash routing for Observe UI (R5). */
+
+export function parseHashRoute(hashValue) {
+	const hash = (hashValue.replace(/^#/, "") || "/").split("?")[0] || "/";
+	const batchMatch = /^\/batch\/([^/]+)$/.exec(hash);
+	if (batchMatch) {
+		return { view: "batch", batchRunId: decodeURIComponent(batchMatch[1]) };
+	}
+	const runMatch = /^\/run\/([^/]+)$/.exec(hash);
+	if (runMatch) {
+		return { view: "run", workerRunId: decodeURIComponent(runMatch[1]) };
+	}
+	const dagMatch = /^\/dag\/([^/]+)$/.exec(hash);
+	if (dagMatch) {
+		return { view: "dag", dagRunId: decodeURIComponent(dagMatch[1]) };
+	}
+	const featureTaskMatch = /^\/feature\/([^/]+)\/task\/([^/]+)$/.exec(hash);
+	if (featureTaskMatch) {
+		return {
+			view: "task",
+			featureId: decodeURIComponent(featureTaskMatch[1]),
+			taskId: decodeURIComponent(featureTaskMatch[2]),
+		};
+	}
+	const taskMatch = /^\/task\/([^/]+)$/.exec(hash);
+	if (taskMatch) {
+		return { view: "task", taskId: decodeURIComponent(taskMatch[1]) };
+	}
+	const featureMatch = /^\/feature\/([^/]+)$/.exec(hash);
+	if (featureMatch) {
+		return {
+			view: "feature",
+			featureId: decodeURIComponent(featureMatch[1]),
+		};
+	}
+	if (hash === "/pool") {
+		return { view: "pool" };
+	}
+	if (hash === "/failures") {
+		return { view: "failures" };
+	}
+	if (hash === "/dags") {
+		return { view: "dashboard", scrollTo: "dags" };
+	}
+	return { view: "dashboard" };
+}
+
+/** Active (non-terminal) statuses sort first; terminals by updatedAt desc. */
+
+export function parseRoute() {
+	return parseHashRouteWithFilters(location.hash);
+}
+
+export function navigate(path) {
+	location.hash = path.startsWith("#") ? path.slice(1) : path;
+}
+
+/**
+ * Parse optional filter query after a hash path: #/pool?status=failed
+ * Returns { filters: { status?, q? } } merged into route; unknown keys ignored.
+ * Base parseHashRoute shape is preserved for all existing views.
+ */
+export function parseHashFilters(hashValue) {
+	const raw = String(hashValue ?? "").replace(/^#/, "");
+	const qIndex = raw.indexOf("?");
+	if (qIndex < 0) return {};
+	const qs = raw.slice(qIndex + 1);
+	const params = new URLSearchParams(qs);
+	const filters = {};
+	const status = params.get("status");
+	const q = params.get("q");
+	if (status) filters.status = status;
+	if (q) filters.q = q;
+	return filters;
+}
+
+export function parseHashRouteWithFilters(hashValue) {
+	const raw = String(hashValue ?? "");
+	const withoutQuery = raw.replace(/^#/, "").split("?")[0];
+	const base = parseHashRoute("#" + (withoutQuery || "/"));
+	const filters = parseHashFilters(raw);
+	if (Object.keys(filters).length === 0) return base;
+	return { ...base, filters };
+}
+
+export function buildHashPath(path, filters = {}) {
+	const base = path.startsWith("#") ? path.slice(1) : path;
+	const params = new URLSearchParams();
+	if (filters.status) params.set("status", filters.status);
+	if (filters.q) params.set("q", filters.q);
+	const qs = params.toString();
+	return qs ? `${base}?${qs}` : base;
+}