npm - @cryptiklemur/lattice - Versions diffs - 0.0.0 - Mend

@cryptiklemur/lattice 0.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (162) hide show

package/.editorconfig +12 -0
package/.github/workflows/release.yml +44 -0
package/.impeccable.md +66 -0
package/.releaserc.json +32 -0
package/.serena/project.yml +138 -0
package/CLAUDE.md +35 -0
package/CONTRIBUTING.md +93 -0
package/LICENSE +21 -0
package/README.md +83 -0
package/bun.lock +1459 -0
package/bunfig.toml +2 -0
package/client/index.html +32 -0
package/client/package.json +37 -0
package/client/public/icons/icon-192.svg +11 -0
package/client/public/icons/icon-512.svg +11 -0
package/client/public/manifest.json +24 -0
package/client/public/sw.js +61 -0
package/client/src/App.tsx +28 -0
package/client/src/components/auth/PassphrasePrompt.tsx +70 -0
package/client/src/components/chat/ChatInput.tsx +241 -0
package/client/src/components/chat/ChatView.tsx +727 -0
package/client/src/components/chat/Message.tsx +362 -0
package/client/src/components/chat/ModelSelector.tsx +87 -0
package/client/src/components/chat/PermissionModeSelector.tsx +41 -0
package/client/src/components/chat/StatusBar.tsx +50 -0
package/client/src/components/chat/ToolGroup.tsx +129 -0
package/client/src/components/chat/ToolResultRenderer.tsx +343 -0
package/client/src/components/chat/toolSummary.ts +41 -0
package/client/src/components/dashboard/DashboardView.tsx +219 -0
package/client/src/components/dashboard/ProjectDashboardView.tsx +168 -0
package/client/src/components/mesh/NodeBadge.tsx +24 -0
package/client/src/components/mesh/PairingDialog.tsx +281 -0
package/client/src/components/panels/FileBrowser.tsx +241 -0
package/client/src/components/panels/StickyNotes.tsx +187 -0
package/client/src/components/panels/Terminal.tsx +128 -0
package/client/src/components/project-settings/ProjectClaude.tsx +304 -0
package/client/src/components/project-settings/ProjectEnvironment.tsx +235 -0
package/client/src/components/project-settings/ProjectGeneral.tsx +76 -0
package/client/src/components/project-settings/ProjectMcp.tsx +232 -0
package/client/src/components/project-settings/ProjectPermissions.tsx +209 -0
package/client/src/components/project-settings/ProjectRules.tsx +277 -0
package/client/src/components/project-settings/ProjectSettingsView.tsx +99 -0
package/client/src/components/project-settings/ProjectSkills.tsx +91 -0
package/client/src/components/settings/Appearance.tsx +151 -0
package/client/src/components/settings/ClaudeSettings.tsx +151 -0
package/client/src/components/settings/Environment.tsx +185 -0
package/client/src/components/settings/GlobalMcp.tsx +207 -0
package/client/src/components/settings/GlobalSkills.tsx +125 -0
package/client/src/components/settings/MeshStatus.tsx +145 -0
package/client/src/components/settings/SettingsView.tsx +57 -0
package/client/src/components/settings/SkillMarketplace.tsx +175 -0
package/client/src/components/settings/mcp-shared.tsx +194 -0
package/client/src/components/settings/skill-shared.tsx +177 -0
package/client/src/components/setup/SetupWizard.tsx +750 -0
package/client/src/components/sidebar/NodeSettingsModal.tsx +180 -0
package/client/src/components/sidebar/ProjectDropdown.tsx +43 -0
package/client/src/components/sidebar/ProjectRail.tsx +291 -0
package/client/src/components/sidebar/SearchFilter.tsx +52 -0
package/client/src/components/sidebar/SessionList.tsx +384 -0
package/client/src/components/sidebar/SettingsSidebar.tsx +128 -0
package/client/src/components/sidebar/Sidebar.tsx +209 -0
package/client/src/components/sidebar/UserIsland.tsx +59 -0
package/client/src/components/sidebar/UserMenu.tsx +101 -0
package/client/src/components/ui/CommandPalette.tsx +321 -0
package/client/src/components/ui/ErrorBoundary.tsx +56 -0
package/client/src/components/ui/IconPicker.tsx +209 -0
package/client/src/components/ui/LatticeLogomark.tsx +19 -0
package/client/src/components/ui/PopupMenu.tsx +98 -0
package/client/src/components/ui/SaveFooter.tsx +38 -0
package/client/src/components/ui/Toast.tsx +112 -0
package/client/src/hooks/useMesh.ts +89 -0
package/client/src/hooks/useProjectSettings.ts +56 -0
package/client/src/hooks/useProjects.ts +66 -0
package/client/src/hooks/useSaveState.ts +59 -0
package/client/src/hooks/useSession.ts +317 -0
package/client/src/hooks/useSidebar.ts +74 -0
package/client/src/hooks/useSkills.ts +30 -0
package/client/src/hooks/useTheme.ts +114 -0
package/client/src/hooks/useWebSocket.ts +26 -0
package/client/src/main.tsx +10 -0
package/client/src/providers/WebSocketProvider.tsx +146 -0
package/client/src/router.tsx +391 -0
package/client/src/stores/mesh.ts +78 -0
package/client/src/stores/session.ts +322 -0
package/client/src/stores/sidebar.ts +336 -0
package/client/src/stores/theme.ts +44 -0
package/client/src/styles/global.css +167 -0
package/client/src/styles/theme-vars.css +18 -0
package/client/src/themes/index.ts +79 -0
package/client/src/utils/findDuplicateKeys.ts +12 -0
package/client/tsconfig.json +14 -0
package/client/vite.config.ts +20 -0
package/package.json +46 -0
package/server/package.json +22 -0
package/server/src/auth/passphrase.ts +48 -0
package/server/src/config.ts +55 -0
package/server/src/daemon.ts +338 -0
package/server/src/features/ralph-loop.ts +173 -0
package/server/src/features/scheduler.ts +281 -0
package/server/src/features/sticky-notes.ts +102 -0
package/server/src/handlers/chat.ts +194 -0
package/server/src/handlers/fs.ts +84 -0
package/server/src/handlers/loop.ts +37 -0
package/server/src/handlers/mesh.ts +125 -0
package/server/src/handlers/notes.ts +45 -0
package/server/src/handlers/project-settings.ts +174 -0
package/server/src/handlers/scheduler.ts +47 -0
package/server/src/handlers/session.ts +159 -0
package/server/src/handlers/settings.ts +109 -0
package/server/src/handlers/skills.ts +380 -0
package/server/src/handlers/terminal.ts +70 -0
package/server/src/identity.ts +26 -0
package/server/src/index.ts +190 -0
package/server/src/mesh/connector.ts +209 -0
package/server/src/mesh/discovery.ts +123 -0
package/server/src/mesh/pairing.ts +94 -0
package/server/src/mesh/peers.ts +52 -0
package/server/src/mesh/proxy.ts +103 -0
package/server/src/mesh/session-sync.ts +107 -0
package/server/src/project/context-breakdown.ts +289 -0
package/server/src/project/file-browser.ts +106 -0
package/server/src/project/project-files.ts +267 -0
package/server/src/project/registry.ts +57 -0
package/server/src/project/sdk-bridge.ts +566 -0
package/server/src/project/session.ts +432 -0
package/server/src/project/terminal.ts +69 -0
package/server/src/tls.ts +51 -0
package/server/src/ws/broadcast.ts +31 -0
package/server/src/ws/router.ts +104 -0
package/server/src/ws/server.ts +2 -0
package/server/tsconfig.json +16 -0
package/shared/package.json +11 -0
package/shared/src/constants.ts +7 -0
package/shared/src/index.ts +4 -0
package/shared/src/messages.ts +638 -0
package/shared/src/models.ts +136 -0
package/shared/src/project-settings.ts +45 -0
package/shared/tsconfig.json +11 -0
package/themes/amoled.json +20 -0
package/themes/ayu-light.json +9 -0
package/themes/catppuccin-latte.json +9 -0
package/themes/catppuccin-mocha.json +9 -0
package/themes/clay-light.json +10 -0
package/themes/clay.json +10 -0
package/themes/dracula.json +9 -0
package/themes/everforest-light.json +9 -0
package/themes/everforest.json +9 -0
package/themes/github-light.json +9 -0
package/themes/gruvbox-dark.json +9 -0
package/themes/gruvbox-light.json +9 -0
package/themes/monokai.json +9 -0
package/themes/nord-light.json +9 -0
package/themes/nord.json +9 -0
package/themes/one-dark.json +9 -0
package/themes/one-light.json +9 -0
package/themes/rose-pine-dawn.json +9 -0
package/themes/rose-pine.json +9 -0
package/themes/solarized-dark.json +9 -0
package/themes/solarized-light.json +9 -0
package/themes/tokyo-night-light.json +9 -0
package/themes/tokyo-night.json +9 -0
package/tsconfig.json +26 -0

package/server/src/daemon.ts ADDED Viewed

@@ -0,0 +1,338 @@
+import { join, resolve } from "node:path";
+import { readFileSync, existsSync } from "node:fs";
+import type { ServerWebSocket } from "bun";
+import { getLatticeHome, loadConfig } from "./config";
+import { loadOrCreateIdentity } from "./identity";
+import { addClient, removeClient, routeMessage } from "./ws/server";
+import { broadcast, sendTo } from "./ws/broadcast";
+import { buildNodesMessage } from "./handlers/mesh";
+import { startDiscovery } from "./mesh/discovery";
+import { startMeshConnections, onPeerConnected, onPeerDisconnected, onPeerMessage } from "./mesh/connector";
+import { handleProxyRequest, handleProxyResponse } from "./mesh/proxy";
+import { verifyPassphrase, generateSessionToken, addSession, isValidSession } from "./auth/passphrase";
+import { ensureCerts } from "./tls";
+import type { ClientMessage, MeshMessage } from "@lattice/shared";
+import "./handlers/session";
+import "./handlers/chat";
+import { loadInterruptedSessions } from "./project/sdk-bridge";
+import "./handlers/fs";
+import "./handlers/terminal";
+import "./handlers/settings";
+import "./handlers/project-settings";
+import "./handlers/mesh";
+import "./handlers/loop";
+import "./handlers/scheduler";
+import "./handlers/notes";
+import "./handlers/skills";
+import { startScheduler } from "./features/scheduler";
+import { loadNotes } from "./features/sticky-notes";
+import { cleanupClientTerminals } from "./handlers/terminal";
+interface WsData {
+  id: string;
+}
+function parseCookies(cookieHeader: string): Map<string, string> {
+  var map = new Map<string, string>();
+  var parts = cookieHeader.split(";");
+  for (var i = 0; i < parts.length; i++) {
+    var part = parts[i].trim();
+    var eqIdx = part.indexOf("=");
+    if (eqIdx === -1) {
+      continue;
+    }
+    var key = part.slice(0, eqIdx).trim();
+    var value = part.slice(eqIdx + 1).trim();
+    map.set(key, value);
+  }
+  return map;
+}
+function isAuthenticated(req: Request, passphraseHash: string | undefined): boolean {
+  if (!passphraseHash) {
+    return true;
+  }
+  var cookieHeader = req.headers.get("cookie") || "";
+  var cookies = parseCookies(cookieHeader);
+  var token = cookies.get("lattice_auth");
+  if (!token) {
+    return false;
+  }
+  return isValidSession(token);
+}
+function buildLoginPage(): string {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Lattice — Authenticate</title>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: 'Courier New', monospace;
+      background: #0d0d0d;
+      color: #e0e0e0;
+      min-height: 100vh;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+    .card {
+      background: #161616;
+      border: 1px solid #2a2a2a;
+      border-radius: 6px;
+      padding: 2.5rem;
+      width: 100%;
+      max-width: 360px;
+    }
+    h1 {
+      font-size: 1.1rem;
+      font-weight: 600;
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+      color: #a0a0a0;
+      margin-bottom: 1.75rem;
+    }
+    label {
+      display: block;
+      font-size: 0.72rem;
+      text-transform: uppercase;
+      letter-spacing: 0.1em;
+      color: #606060;
+      margin-bottom: 0.4rem;
+    }
+    input[type="password"] {
+      width: 100%;
+      background: #0d0d0d;
+      border: 1px solid #2a2a2a;
+      border-radius: 4px;
+      color: #e0e0e0;
+      font-family: inherit;
+      font-size: 0.9rem;
+      padding: 0.6rem 0.75rem;
+      outline: none;
+      transition: border-color 0.15s;
+    }
+    input[type="password"]:focus { border-color: #4a4a4a; }
+    button {
+      width: 100%;
+      margin-top: 1.25rem;
+      background: #e0e0e0;
+      color: #0d0d0d;
+      border: none;
+      border-radius: 4px;
+      font-family: inherit;
+      font-size: 0.85rem;
+      font-weight: 700;
+      letter-spacing: 0.06em;
+      text-transform: uppercase;
+      padding: 0.65rem;
+      cursor: pointer;
+      transition: background 0.15s;
+    }
+    button:hover { background: #c0c0c0; }
+    .error {
+      margin-top: 0.85rem;
+      font-size: 0.78rem;
+      color: #c07070;
+      text-align: center;
+    }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <h1>Lattice</h1>
+    <form id="form">
+      <label for="passphrase">Passphrase</label>
+      <input type="password" id="passphrase" name="passphrase" autofocus autocomplete="current-password" />
+      <button type="submit">Authenticate</button>
+      <div class="error" id="error"></div>
+    </form>
+  </div>
+  <script>
+    document.getElementById('form').addEventListener('submit', async function(e) {
+      e.preventDefault();
+      var passphrase = document.getElementById('passphrase').value;
+      try {
+        var res = await fetch('/auth', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ passphrase: passphrase })
+        });
+        if (res.ok) {
+          window.location.reload();
+        } else {
+          document.getElementById('error').textContent = 'Invalid passphrase.';
+        }
+      } catch {
+        document.getElementById('error').textContent = 'Connection error.';
+      }
+    });
+  </script>
+</body>
+</html>`;
+}
+export async function startDaemon(portOverride?: number | null): Promise<void> {
+  var config = loadConfig();
+  if (portOverride && !isNaN(portOverride)) {
+    config.port = portOverride;
+  }
+  var identity = loadOrCreateIdentity();
+  console.log(`[lattice] Node: ${config.name} (${identity.id})`);
+  console.log(`[lattice] Home: ${getLatticeHome()}`);
+  var clientDir = join(import.meta.dir, "../../client/dist");
+  var tlsOptions: { cert: Buffer; key: Buffer } | undefined;
+  if (config.tls) {
+    try {
+      var certs = ensureCerts();
+      tlsOptions = {
+        cert: readFileSync(certs.cert),
+        key: readFileSync(certs.key),
+      };
+      console.log("[lattice] TLS enabled");
+    } catch (err) {
+      console.error("[lattice] Failed to load TLS certs, falling back to HTTP:", err);
+    }
+  }
+  var protocol = tlsOptions ? "https" : "http";
+  Bun.serve<WsData>({
+    port: config.port,
+    hostname: "0.0.0.0",
+    ...(tlsOptions ? { tls: tlsOptions } : {}),
+    async fetch(req: Request, server: ReturnType<typeof Bun.serve>) {
+      var url = new URL(req.url);
+      if (url.pathname === "/auth" && req.method === "POST") {
+        try {
+          var body = await req.json() as { passphrase?: string };
+          var passphrase = body.passphrase || "";
+          if (!config.passphraseHash || verifyPassphrase(passphrase, config.passphraseHash)) {
+            var token = generateSessionToken();
+            addSession(token);
+            var headers = new Headers();
+            headers.set("Content-Type", "application/json");
+            headers.set("Set-Cookie", "lattice_auth=" + token + "; HttpOnly; Path=/; SameSite=Strict");
+            return new Response(JSON.stringify({ ok: true }), { status: 200, headers });
+          }
+          return new Response(JSON.stringify({ ok: false }), { status: 401, headers: { "Content-Type": "application/json" } });
+        } catch {
+          return new Response(JSON.stringify({ ok: false }), { status: 400, headers: { "Content-Type": "application/json" } });
+        }
+      }
+      if (!isAuthenticated(req, config.passphraseHash)) {
+        return new Response(buildLoginPage(), {
+          status: 200,
+          headers: { "Content-Type": "text/html; charset=utf-8" },
+        });
+      }
+      if (url.pathname === "/api/file") {
+        var reqFilePath = url.searchParams.get("path");
+        if (!reqFilePath) {
+          return new Response("Missing path parameter", { status: 400 });
+        }
+        var resolved = resolve(reqFilePath);
+        if (!existsSync(resolved)) {
+          for (var pi = 0; pi < config.projects.length; pi++) {
+            var projectResolved = join(config.projects[pi].path, reqFilePath);
+            if (existsSync(projectResolved)) {
+              resolved = projectResolved;
+              break;
+            }
+          }
+        }
+        if (!existsSync(resolved)) {
+          return new Response("File not found", { status: 404 });
+        }
+        var reqFile = Bun.file(resolved);
+        return new Response(reqFile);
+      }
+      if (url.pathname === "/ws") {
+        var upgraded = server.upgrade(req, {
+          data: { id: crypto.randomUUID() },
+        });
+        if (upgraded) {
+          return undefined;
+        }
+        return new Response("WebSocket upgrade failed", { status: 400 });
+      }
+      var staticPath = url.pathname === "/" ? "/index.html" : url.pathname;
+      var file = Bun.file(join(clientDir, staticPath));
+      if (await file.exists()) {
+        return new Response(file);
+      }
+      var index = Bun.file(join(clientDir, "index.html"));
+      if (await index.exists()) {
+        return new Response(index);
+      }
+      return new Response("Not found", { status: 404 });
+    },
+    websocket: {
+      open(ws: ServerWebSocket<WsData>) {
+        addClient(ws);
+        console.log(`[lattice] Client connected: ${ws.data.id}`);
+        sendTo(ws.data.id, { type: "mesh:nodes", nodes: buildNodesMessage() });
+      },
+      message(ws: ServerWebSocket<WsData>, message: string | Buffer) {
+        var text = typeof message === "string" ? message : message.toString();
+        try {
+          var msg = JSON.parse(text) as ClientMessage;
+          routeMessage(ws.data.id, msg);
+        } catch (err) {
+          console.error("[lattice] Invalid JSON message:", err);
+        }
+      },
+      close(ws: ServerWebSocket<WsData>) {
+        removeClient(ws.data.id);
+        cleanupClientTerminals(ws.data.id);
+        console.log(`[lattice] Client disconnected: ${ws.data.id}`);
+      },
+    },
+  });
+  console.log(`[lattice] Listening on ${protocol}://0.0.0.0:${config.port}`);
+  startDiscovery(identity.id, config.name, config.port);
+  startMeshConnections();
+  startScheduler();
+  loadNotes();
+  loadInterruptedSessions();
+  onPeerConnected(function (nodeId: string) {
+    broadcast({ type: "mesh:node_online", nodeId: nodeId });
+  });
+  onPeerDisconnected(function (nodeId: string) {
+    broadcast({ type: "mesh:node_offline", nodeId: nodeId });
+  });
+  onPeerMessage(function (nodeId: string, msg: MeshMessage) {
+    if (msg.type === "mesh:proxy_request") {
+      handleProxyRequest(nodeId, msg);
+      return;
+    }
+    if (msg.type === "mesh:proxy_response") {
+      handleProxyResponse(msg);
+      return;
+    }
+  });
+}

package/server/src/features/ralph-loop.ts ADDED Viewed

@@ -0,0 +1,173 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { randomBytes, randomUUID } from "node:crypto";
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import type { SDKMessage, SDKPartialAssistantMessage, SDKResultMessage } from "@anthropic-ai/claude-agent-sdk";
+import { broadcast } from "../ws/broadcast";
+import { getProjectBySlug } from "../project/registry";
+import type { LoopStatus } from "@lattice/shared";
+var activeLoops = new Map<string, LoopStatus>();
+function readLoopFile(projectPath: string, filename: string): string | null {
+  var loopsDir = join(projectPath, ".claude", "loops");
+  var filePath = join(loopsDir, filename);
+  if (!existsSync(filePath)) {
+    return null;
+  }
+  return readFileSync(filePath, "utf-8");
+}
+async function runIteration(
+  loopId: string,
+  prompt: string,
+  cwd: string,
+  iterationNum: number
+): Promise<string> {
+  var accumulated = "";
+  var stream = query({ prompt, options: { cwd, allowedTools: ["*"], permissionMode: "acceptEdits" } });
+  for await (var msg of stream) {
+    var typedMsg = msg as SDKMessage;
+    if (typedMsg.type === "stream_event") {
+      var partial = typedMsg as SDKPartialAssistantMessage;
+      var evt = partial.event;
+      if (evt.type === "content_block_delta") {
+        var deltaEvt = evt as { delta: { type: string; text?: string } };
+        if (deltaEvt.delta.type === "text_delta" && typeof deltaEvt.delta.text === "string") {
+          accumulated += deltaEvt.delta.text;
+          broadcast({ type: "loop:delta", loopId, iteration: iterationNum, text: deltaEvt.delta.text });
+        }
+      }
+    }
+  }
+  return accumulated;
+}
+async function runJudge(
+  judgePrompt: string,
+  iterationResult: string,
+  cwd: string
+): Promise<{ pass: boolean; reason: string }> {
+  var fullPrompt = `${judgePrompt}\n\n<iteration_result>\n${iterationResult}\n</iteration_result>\n\nRespond with PASS or FAIL on the first line, followed by a brief reason.`;
+  var accumulated = "";
+  var stream = query({ prompt: fullPrompt, options: { cwd, allowedTools: [], permissionMode: "acceptEdits" } });
+  for await (var msg of stream) {
+    var typedMsg = msg as SDKMessage;
+    if (typedMsg.type === "stream_event") {
+      var partial = typedMsg as SDKPartialAssistantMessage;
+      var evt = partial.event;
+      if (evt.type === "content_block_delta") {
+        var deltaEvt = evt as { delta: { type: string; text?: string } };
+        if (deltaEvt.delta.type === "text_delta" && typeof deltaEvt.delta.text === "string") {
+          accumulated += deltaEvt.delta.text;
+        }
+      }
+    }
+  }
+  var firstLine = accumulated.trim().split("\n")[0].toUpperCase();
+  var pass = firstLine.startsWith("PASS");
+  var reason = accumulated.trim().split("\n").slice(1).join("\n").trim() || accumulated.trim();
+  return { pass, reason };
+}
+export function startLoop(projectSlug: string): LoopStatus | null {
+  var project = getProjectBySlug(projectSlug);
+  if (!project) {
+    return null;
+  }
+  var prompt = readLoopFile(project.path, "PROMPT.md");
+  if (!prompt) {
+    return null;
+  }
+  var loopId = "loop_" + Date.now() + "_" + randomBytes(3).toString("hex");
+  var loopStatus: LoopStatus = {
+    id: loopId,
+    projectSlug,
+    status: "running",
+    iteration: 0,
+    maxIterations: 20,
+    judgeReason: null,
+    startedAt: Date.now(),
+    finishedAt: null,
+  };
+  activeLoops.set(loopId, loopStatus);
+  broadcast({ type: "loop:started", loop: loopStatus });
+  void (async function () {
+    var judgePrompt = readLoopFile(project.path, "JUDGE.md");
+    for (var i = 1; i <= loopStatus.maxIterations; i++) {
+      var current = activeLoops.get(loopId);
+      if (!current || current.status === "stopped") {
+        break;
+      }
+      current.iteration = i;
+      activeLoops.set(loopId, current);
+      broadcast({ type: "loop:status_update", loop: { ...current } });
+      try {
+        var result = await runIteration(loopId, prompt, project.path, i);
+        if (judgePrompt) {
+          var judgment = await runJudge(judgePrompt, result, project.path);
+          current.judgeReason = judgment.reason;
+          activeLoops.set(loopId, current);
+          if (judgment.pass) {
+            current.status = "done";
+            current.finishedAt = Date.now();
+            activeLoops.set(loopId, current);
+            broadcast({ type: "loop:status_update", loop: { ...current } });
+            break;
+          }
+        }
+      } catch (err: unknown) {
+        var errMsg = err instanceof Error ? err.message : String(err);
+        console.error(`[ralph-loop] Iteration ${i} error:`, errMsg);
+        current.status = "error";
+        current.judgeReason = errMsg;
+        current.finishedAt = Date.now();
+        activeLoops.set(loopId, current);
+        broadcast({ type: "loop:status_update", loop: { ...current } });
+        return;
+      }
+    }
+    var final = activeLoops.get(loopId);
+    if (final && final.status === "running") {
+      final.status = "done";
+      final.finishedAt = Date.now();
+      activeLoops.set(loopId, final);
+      broadcast({ type: "loop:status_update", loop: { ...final } });
+    }
+  })();
+  return loopStatus;
+}
+export function stopLoop(loopId: string): boolean {
+  var loop = activeLoops.get(loopId);
+  if (!loop || loop.status !== "running") {
+    return false;
+  }
+  loop.status = "stopped";
+  loop.finishedAt = Date.now();
+  activeLoops.set(loopId, loop);
+  broadcast({ type: "loop:status_update", loop: { ...loop } });
+  return true;
+}
+export function getLoopStatus(loopId: string): LoopStatus | null {
+  return activeLoops.get(loopId) ?? null;
+}