feat: Claude Code Monitor — lanes, pipelines and a merged workspace

Internal SmartGift build of a Claude Code monitoring dashboard. Lanes: a durable unit of parallel agent work, one per working directory, tracked across session restarts. Managed lanes are git worktrees the dashboard provisions and can reset or remove behind a three-check destroy guard and a counted preflight; adopted lanes are directories you already own and are never destroyable. Pipelines: a lane moves through pipeline stages. A stage the agent declares with evidence renders green; a stage inferred from the tool-event stream renders dashed amber and never counts as done. Detection is forward-only within a 30-minute window, and never writes the declared stage. Workspace: one page at /run with a lane grid, the selected lane's pipeline, and a full Claude console behind a disclosure.
2026-07-29 17:07:45 +07:00
commit 57dc91585d
783 changed files with 221743 additions and 0 deletions
@@ -0,0 +1,66 @@
+/**
+ * @file source-filter.js
+ * @description Shared helper for the "data scope" feature: restricting a query
+ * to sessions collected from a chosen set of machines (see server/db.js
+ * `sessions.source` and server/lib/remote-sync.js).
+ *
+ * The client passes `?sources=local,src_abc,...` on any data endpoint. Absent or
+ * empty means "all sources" (no filter) so every existing caller and the
+ * zero-config default are unaffected. This module turns that query param into a
+ * SQL fragment that is safe to append to any WHERE clause — either directly on
+ * `sessions.source`, or, for tables that only carry a `session_id`, as a
+ * subquery so complex aggregate SQL (stats, analytics) needs only one extra AND.
+ *
+ * @author Nguyễn Ngọc Trí Vĩ <vinnt@smartgift.vn>
+ */
+
+/**
+ * Parse the `sources` query param into a de-duplicated list, or null for
+ * "all sources" (no filtering).
+ * @param {import("express").Request} req
+ * @returns {string[]|null}
+ */
+function parseSources(req) {
+  const raw = req.query ? req.query.sources : undefined;
+  if (typeof raw !== "string") return null;
+  const list = [
+    ...new Set(
+      raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean)
+    ),
+  ];
+  return list.length > 0 ? list : null;
+}
+
+/**
+ * Filter directly on a `source` column (used when `sessions` is in the query).
+ * @param {string[]|null} sources result of parseSources
+ * @param {string} [col] the qualified source column (default "s.source")
+ * @returns {{clause:string, params:string[]}} `clause` is "" when no filter
+ */
+function sourceColumnClause(sources, col = "s.source") {
+  if (!sources || sources.length === 0) return { clause: "", params: [] };
+  const placeholders = sources.map(() => "?").join(",");
+  return { clause: `${col} IN (${placeholders})`, params: sources };
+}
+
+/**
+ * Filter by session origin when only a `session_id` column is available, via a
+ * subquery against `sessions`. Lets stats/analytics/events/agents scope by
+ * source with a single extra AND and no FROM/GROUP BY changes.
+ * @param {string[]|null} sources result of parseSources
+ * @param {string} sessionIdCol the qualified session-id column (e.g. "e.session_id")
+ * @returns {{clause:string, params:string[]}} `clause` is "" when no filter
+ */
+function sessionIdInSourcesClause(sources, sessionIdCol) {
+  if (!sources || sources.length === 0) return { clause: "", params: [] };
+  const placeholders = sources.map(() => "?").join(",");
+  return {
+    clause: `${sessionIdCol} IN (SELECT id FROM sessions WHERE source IN (${placeholders}))`,
+    params: sources,
+  };
+}
+
+module.exports = { parseSources, sourceColumnClause, sessionIdInSourcesClause };