@kirrosh/zond 0.20.0 → 0.22.0

package/src/core/workspace/root.ts

@@ -0,0 +1,94 @@
+import { existsSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+
+/**
+ * Files / directories that mark a workspace root. Order matters — earlier
+ * markers win when more than one is present in the same directory.
+ *
+ *   zond.config.yml — explicit project config (T12)
+ *   .zond/          — `zond init --here` subdir convention (T19)
+ *   zond.db         — flat layout from `zond init`
+ *   apis/           — flat layout (collections directory)
+ */
+export const WORKSPACE_MARKERS = ["zond.config.yml", ".zond", "zond.db", "apis"] as const;
+export type WorkspaceMarker = (typeof WORKSPACE_MARKERS)[number];
+
+export interface WorkspaceInfo {
+  /** Absolute path to the workspace root. */
+  root: string;
+  /** Marker that triggered detection, or "" when fallback (cwd) was used. */
+  marker: WorkspaceMarker | "";
+  /** True when no marker was found and we fell back to `cwd`. */
+  fromFallback: boolean;
+}
+
+let warned = false;
+
+function hasMarker(dir: string): WorkspaceMarker | null {
+  for (const m of WORKSPACE_MARKERS) {
+    const p = join(dir, m);
+    if (!existsSync(p)) continue;
+    // .zond and apis must be directories; zond.config.yml and zond.db must be files
+    try {
+      const st = statSync(p);
+      if (m === ".zond" || m === "apis") {
+        if (st.isDirectory()) return m;
+      } else if (st.isFile()) {
+        return m;
+      }
+    } catch {
+      /* race / permissions — treat as no marker */
+    }
+  }
+  return null;
+}
+
+/**
+ * Walk-up from `cwd` (default `process.cwd()`) to the nearest workspace
+ * marker. The walk stops at `os.homedir()` to avoid accidentally picking up
+ * `~/apis` or `~/zond.db` when the user runs zond from somewhere unrelated.
+ *
+ * When no marker is found, returns `{ root: cwd, fromFallback: true }` and
+ * prints a one-time stderr warning so the user knows zond is operating in
+ * cwd-mode.
+ */
+export function findWorkspaceRoot(cwd?: string): WorkspaceInfo {
+  const start = resolve(cwd ?? process.cwd());
+  const stop = resolve(homedir());
+
+  let dir = start;
+  // Walk strictly while above (or equal to) HOME's length, but include HOME
+  // itself as a candidate only when start is inside HOME. If start is outside
+  // HOME (e.g. /tmp), walk all the way to "/".
+  const insideHome = start === stop || start.startsWith(stop + "/") || start.startsWith(stop + "\\");
+
+  while (true) {
+    const marker = hasMarker(dir);
+    if (marker) return { root: dir, marker, fromFallback: false };
+
+    const parent = dirname(dir);
+    if (parent === dir) break;                 // filesystem root
+    if (insideHome && dir === stop) break;     // do not climb past HOME
+    dir = parent;
+  }
+
+  if (!warned) {
+    warned = true;
+    process.stderr.write(
+      `[zond] no workspace marker found from ${start}; using cwd. ` +
+      `Run 'zond init' or create zond.config.yml to anchor the workspace.\n`,
+    );
+  }
+  return { root: start, marker: "", fromFallback: true };
+}
+
+/** Resolve `relative` against the workspace root (auto-detected from `cwd`). */
+export function resolveWorkspacePath(relative: string, cwd?: string): string {
+  return resolve(findWorkspaceRoot(cwd).root, relative);
+}
+
+/** Test helper: reset the one-shot warning latch. */
+export function _resetWorkspaceWarning(): void {
+  warned = false;
+}

package/src/db/schema.ts

@@ -1,12 +1,15 @@
 import { Database } from "bun:sqlite";
 import { resolve } from "path";
 import { existsSync } from "fs";
+import { findWorkspaceRoot } from "../core/workspace/root.ts";
 
 let _db: Database | null = null;
 let _dbPath: string | null = null;
 
 export function getDb(dbPath?: string): Database {
-  const path = dbPath ? resolve(dbPath) : (_dbPath ?? resolve(process.cwd(), "zond.db"));
+  const path = dbPath
+    ? resolve(dbPath)
+    : (_dbPath ?? resolve(findWorkspaceRoot().root, "zond.db"));
 
   // If cached connection exists, verify the file still exists
   if (_db && _dbPath === path && existsSync(path)) return _db;

package/src/web/routes/api.ts

@@ -12,6 +12,7 @@ import {
   RunDetailSchema,
   RunIdParam,
 } from "../schemas.ts";
+import { renderProxyResponse, renderProxyError } from "../views/explorer-tab.ts";
 
 const api = new OpenAPIHono();
 
@@ -114,6 +115,85 @@ api.openapi(runRoute, async (c) => {
   }
 });
 
+// ──────────────────────────────────────────────
+// POST /api/proxy — Explorer proxy for HTTP requests
+// ──────────────────────────────────────────────
+
+api.post("/api/proxy", async (c) => {
+  const form = await c.req.parseBody();
+  const baseUrl = (form["base_url"] as string) ?? "";
+  const method = ((form["method"] as string) ?? "GET").toUpperCase();
+  let path = (form["path"] as string) ?? "/";
+  const body = (form["body"] as string) || undefined;
+  const contentType = (form["content_type"] as string) || undefined;
+
+  if (!baseUrl) {
+    return c.html(renderProxyError("Base URL is required", 0));
+  }
+
+  // Substitute path parameters
+  for (const [key, value] of Object.entries(form)) {
+    if (typeof key === "string" && key.startsWith("param_path_") && value) {
+      const paramName = key.slice("param_path_".length);
+      path = path.replace(`{${paramName}}`, encodeURIComponent(value as string));
+    }
+  }
+
+  // Build query string
+  const queryParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(form)) {
+    if (typeof key === "string" && key.startsWith("param_query_") && value) {
+      queryParams.set(key.slice("param_query_".length), value as string);
+    }
+  }
+
+  // Build headers
+  const headers: Record<string, string> = {};
+  for (const [key, value] of Object.entries(form)) {
+    if (typeof key === "string" && key.startsWith("param_header_") && value) {
+      headers[key.slice("param_header_".length)] = value as string;
+    }
+  }
+  // Custom headers
+  for (let i = 0; i < 50; i++) {
+    const k = form[`custom_header_key_${i}`] as string | undefined;
+    const v = form[`custom_header_value_${i}`] as string | undefined;
+    if (!k && !v) break;
+    if (k && v) headers[k] = v;
+  }
+
+  if (contentType && body) {
+    headers["Content-Type"] = contentType;
+  }
+
+  // Build URL
+  let url: URL;
+  try {
+    url = new URL(path, baseUrl.endsWith("/") ? baseUrl : baseUrl + "/");
+    queryParams.forEach((v, k) => url.searchParams.set(k, v));
+  } catch (err) {
+    return c.html(renderProxyError(`Invalid URL: ${baseUrl}${path} — ${(err as Error).message}`, 0));
+  }
+
+  const startTime = performance.now();
+  try {
+    const resp = await fetch(url.toString(), {
+      method,
+      headers,
+      body: ["GET", "HEAD"].includes(method) ? undefined : (body || undefined),
+    });
+    const elapsed = Math.round(performance.now() - startTime);
+    const respBody = await resp.text();
+    const respHeaders: Record<string, string> = {};
+    resp.headers.forEach((v, k) => { respHeaders[k] = v; });
+
+    return c.html(renderProxyResponse(resp.status, respHeaders, respBody, elapsed));
+  } catch (err) {
+    const elapsed = Math.round(performance.now() - startTime);
+    return c.html(renderProxyError((err as Error).message, elapsed));
+  }
+});
+
 // ──────────────────────────────────────────────
 // Export helpers
 // ──────────────────────────────────────────────

package/src/web/routes/dashboard.ts

@@ -5,6 +5,7 @@ import { renderHealthStrip } from "../views/health-strip.ts";
 import { renderEndpointsTab } from "../views/endpoints-tab.ts";
 import { renderSuitesTab } from "../views/suites-tab.ts";
 import { renderRunsTab, renderRunDetail } from "../views/runs-tab.ts";
+import { renderExplorerTab } from "../views/explorer-tab.ts";
 import { buildCollectionState, invalidateCollectionCache } from "../data/collection-state.ts";
 import {
   listCollections,
@@ -81,6 +82,16 @@ dashboard.get("/panels/endpoints", async (c) => {
   return c.html(renderEndpointsTab(state, filters));
 });
 
+dashboard.get("/panels/explorer", async (c) => {
+  const collectionId = parseInt(c.req.query("collection_id") ?? "", 10);
+  if (isNaN(collectionId)) return c.html("");
+
+  const collection = getCollectionById(collectionId);
+  if (!collection) return c.html("");
+
+  return c.html(await renderExplorerTab(collection));
+});
+
 dashboard.get("/panels/suites", async (c) => {
   const collectionId = parseInt(c.req.query("collection_id") ?? "", 10);
   if (isNaN(collectionId)) return c.html("");
@@ -243,6 +254,10 @@ async function renderCollectionContent(collection: CollectionRecord): Promise<st
         hx-get="/panels/runs-tab?collection_id=${collection.id}"
         hx-target="#tab-content" hx-swap="innerHTML"
         onclick="activateTab(this)">Runs <span class="tab-count">${runCount}</span></button>
+      <button class="tab-btn" data-tab="explorer"
+        hx-get="/panels/explorer?collection_id=${collection.id}"
+        hx-target="#tab-content" hx-swap="innerHTML"
+        onclick="activateTab(this)">Explorer</button>
     </div>`;
 
   // Default tab content (endpoints)

package/src/web/static/style.css

@@ -847,6 +847,294 @@ h3 { font-size: 1.05rem; margin: 1rem 0 0.25rem; }
   100% { background: transparent; }
 }
 
+/* ═══════════════════════════════════════════════════
+   Explorer Tab
+   ═══════════════════════════════════════════════════ */
+
+.explorer-base-url {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.75rem 1rem;
+  background: var(--bg-secondary);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  margin-bottom: 1rem;
+}
+.explorer-base-url .explorer-label {
+  font-size: 0.8rem;
+  font-weight: 600;
+  color: var(--text-dim);
+  white-space: nowrap;
+}
+.explorer-input {
+  background: var(--bg-inset);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  color: var(--text);
+  font-family: var(--font-mono);
+  font-size: 0.85rem;
+  padding: 0.4rem 0.6rem;
+  flex: 1;
+  min-width: 0;
+}
+.explorer-input:focus {
+  outline: none;
+  border-color: var(--accent);
+}
+.explorer-input-sm { flex: unset; width: auto; }
+
+/* Groups */
+.explorer-list { display: flex; flex-direction: column; gap: 0.5rem; }
+.explorer-group {
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  overflow: hidden;
+}
+.explorer-group-title {
+  font-size: 0.85rem;
+  font-weight: 600;
+  padding: 0.6rem 1rem;
+  background: var(--bg-secondary);
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+.explorer-group-title .tab-count {
+  font-size: 0.75rem;
+  background: var(--bg-hover);
+  padding: 0.1rem 0.5rem;
+  border-radius: var(--radius-pill);
+  color: var(--text-dim);
+}
+
+/* Endpoint row */
+.explorer-endpoint {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.5rem 1rem;
+  cursor: pointer;
+  border-top: 1px solid var(--border-subtle);
+  transition: background 0.15s;
+}
+.explorer-endpoint:hover { background: var(--bg-hover); }
+.explorer-endpoint-path {
+  font-family: var(--font-mono);
+  font-size: 0.85rem;
+  font-weight: 500;
+}
+.explorer-endpoint-summary {
+  color: var(--text-dim);
+  font-size: 0.8rem;
+  margin-left: auto;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.explorer-auth-hint {
+  font-size: 0.65rem;
+  font-weight: 600;
+  padding: 0.1rem 0.35rem;
+  border-radius: var(--radius-sm);
+  background: var(--warn-dim);
+  color: var(--warn);
+}
+
+/* Detail / form */
+.explorer-detail {
+  padding: 1rem;
+  background: var(--bg-raised);
+  border-top: 1px solid var(--border);
+}
+.explorer-section {
+  margin-bottom: 1rem;
+}
+.explorer-section-title {
+  font-size: 0.8rem;
+  font-weight: 600;
+  color: var(--text-dim);
+  margin-bottom: 0.5rem;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+/* Parameters */
+.explorer-param-row {
+  display: grid;
+  grid-template-columns: 140px 50px 90px 1fr;
+  gap: 0.5rem;
+  align-items: center;
+  margin-bottom: 0.35rem;
+  font-size: 0.85rem;
+}
+.explorer-param-name {
+  font-family: var(--font-mono);
+  font-weight: 500;
+  font-size: 0.8rem;
+}
+.explorer-param-location {
+  font-size: 0.7rem;
+  color: var(--text-muted);
+  background: var(--bg-inset);
+  padding: 0.1rem 0.3rem;
+  border-radius: var(--radius-sm);
+  text-align: center;
+}
+.explorer-param-type {
+  font-size: 0.75rem;
+  color: var(--text-dim);
+  font-family: var(--font-mono);
+}
+.explorer-required {
+  color: var(--fail);
+  font-weight: 700;
+  margin-left: 0.15rem;
+}
+
+/* Body editor */
+.explorer-body-editor {
+  width: 100%;
+  min-height: 120px;
+  background: var(--bg-inset);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  color: var(--text);
+  font-family: var(--font-mono);
+  font-size: 0.85rem;
+  padding: 0.5rem;
+  resize: vertical;
+  tab-size: 2;
+}
+.explorer-body-editor:focus { outline: none; border-color: var(--accent); }
+.explorer-content-type {
+  font-size: 0.75rem;
+  padding: 0.15rem 0.35rem;
+}
+
+/* Custom headers */
+.explorer-headers-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.35rem;
+}
+.explorer-header-pair {
+  display: flex;
+  gap: 0.35rem;
+  align-items: center;
+}
+.explorer-header-pair input { flex: 1; }
+.explorer-remove-btn {
+  background: none;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  color: var(--text-dim);
+  cursor: pointer;
+  font-size: 0.75rem;
+  padding: 0.25rem 0.5rem;
+  line-height: 1;
+}
+.explorer-remove-btn:hover { color: var(--fail); border-color: var(--fail); }
+.explorer-add-header-btn {
+  background: none;
+  border: none;
+  color: var(--accent);
+  cursor: pointer;
+  font-size: 0.8rem;
+  padding: 0.25rem 0;
+  margin-top: 0.25rem;
+}
+.explorer-add-header-btn:hover { text-decoration: underline; }
+
+/* Actions */
+.explorer-actions {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-top: 0.5rem;
+}
+.explorer-send-btn {
+  background: var(--accent);
+  color: #fff;
+  border: none;
+  border-radius: var(--radius);
+  padding: 0.5rem 1.5rem;
+  font-weight: 600;
+  font-size: 0.85rem;
+  cursor: pointer;
+  transition: background 0.15s;
+}
+.explorer-send-btn:hover { background: var(--accent-hover); }
+.explorer-send-btn:disabled { opacity: 0.5; cursor: not-allowed; }
+.explorer-spinner { color: var(--text-dim); font-size: 0.85rem; }
+
+/* Response */
+.explorer-response-container { margin-top: 1rem; }
+.explorer-response {
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  overflow: hidden;
+}
+.explorer-response-error { border-color: var(--fail); }
+.response-meta {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  padding: 0.5rem 0.75rem;
+  background: var(--bg-secondary);
+  border-bottom: 1px solid var(--border);
+  font-size: 0.85rem;
+}
+.response-status {
+  font-weight: 700;
+  font-family: var(--font-mono);
+}
+.response-status.status-2xx { color: var(--pass); }
+.response-status.status-3xx { color: var(--info); }
+.response-status.status-4xx { color: var(--warn); }
+.response-status.status-5xx { color: var(--fail); }
+.response-time { color: var(--text-dim); font-size: 0.8rem; }
+.response-size { color: var(--text-muted); font-size: 0.8rem; }
+.response-headers { padding: 0.5rem 0.75rem; }
+.response-headers summary {
+  font-size: 0.8rem;
+  color: var(--text-dim);
+  cursor: pointer;
+}
+.response-headers-pre {
+  font-size: 0.8rem;
+  margin-top: 0.25rem;
+  white-space: pre-wrap;
+  word-break: break-all;
+}
+.response-body {
+  padding: 0.75rem;
+  background: var(--bg-inset);
+}
+.response-body pre {
+  font-family: var(--font-mono);
+  font-size: 0.8rem;
+  white-space: pre-wrap;
+  word-break: break-all;
+  max-height: 500px;
+  overflow-y: auto;
+  margin: 0;
+}
+.response-error-msg {
+  padding: 0.75rem;
+  color: var(--fail);
+  font-size: 0.85rem;
+}
+
+/* JSON syntax highlighting */
+.json-key { color: var(--accent); }
+.json-string { color: var(--pass); }
+.json-number { color: var(--warn); }
+.json-boolean { color: var(--method-patch); }
+.json-null { color: var(--text-dim); font-style: italic; }
+
 /* ── Responsive ── */
 @media (max-width: 768px) {
   .health-strip { grid-template-columns: 1fr; gap: 1rem; }
@@ -855,4 +1143,6 @@ h3 { font-size: 1.05rem; margin: 1rem 0 0.25rem; }
   .run-row { grid-template-columns: 48px 1fr 60px; }
   .run-time, .run-duration { display: none; }
   .runs-header { display: none; }
+  .explorer-param-row { grid-template-columns: 1fr; }
+  .explorer-endpoint-summary { display: none; }
 }