kaizen-cli 0.1.45

Distributable agent observability: real-time-tailable sessions, agile-style retros, and repo-level improvement (Cursor, Claude Code, Codex). SQLite, redact before any sync you enable.
Documentation
import { chooseProject, decodeOutput, projectPaths } from "./kaizen-state.js";
import { bindRawReport, setRawReport } from "./kaizen-raw.js";
import { createTransport } from "./kaizen-transport.js";
import {
  renderProjects,
  renderReport,
  setBusy,
  setConnection,
  setJourney,
  showManual,
} from "./kaizen-render.js";
const $ = selector => document.querySelector(selector);
const params = new URLSearchParams(location.search);
const token = params.get("token") || localStorage.kaizenToken || "";
const requestedWorkspace = params.get("workspace") || "";
const state = {
  seq: 0,
  pending: new Map(),
  projects: [],
  workspace: "",
  selected: "",
  snapshotPending: "",
  refreshQueued: false,
};
const transport = createTransport({
  url: socketUrl,
  onOpen: connected,
  onDisconnect: disconnected,
  onAuthFailure: () => showAuth("Authorization failed. Reopen Kaizen from daemon output."),
  onMessage: receive,
});
document.addEventListener("DOMContentLoaded", start);
function start() {
  bindControls();
  $("#manual-path").value = requestedWorkspace;
  if (!token) return showAuth("Authorization required. Reopen Kaizen from daemon output.");
  localStorage.kaizenToken = token;
  setConnection("Connecting", "neutral");
  setJourney("neutral", "Connecting", "Opening a secure local connection.");
  transport.connect();
}
function bindControls() {
  bindRawReport();
  $("#refresh-report").addEventListener("click", () => requestSnapshot(true));
  $("#project-select").addEventListener("change", event => activateProject(event.target.value));
  $("#session-rows").addEventListener("click", selectSession);
  $("#manual-form").addEventListener("submit", openManualPath);
  document.addEventListener("visibilitychange", flushQueued);
}
function socketUrl() {
  const scheme = location.protocol === "https:" ? "wss" : "ws";
  return `${scheme}://${location.host}/ws?token=${encodeURIComponent(token)}`;
}
function connected() {
  setConnection("Connected", "ready");
  discoverProjects();
}
function disconnected() {
  state.snapshotPending = "";
  setBusy(false);
  setConnection("Reconnecting", "danger");
  setJourney("error", "Connection lost", "Trying the secure local connection again.");
}
function discoverProjects() {
  setBusy(true);
  setJourney("neutral", "Finding project", "Checking current and recently observed projects.");
  sendCall("kaizen_sessions_list", {
    all_workspaces: true,
    json: true,
    limit: 50,
  }, "projects");
}
function sendCall(tool, args, purpose) {
  const id = `call-${++state.seq}`;
  state.pending.set(id, purpose);
  if (!transport.send({ type: "call", id, tool, args })) fail("Local connection is not ready.");
}
function receive(raw) {
  let message;
  try {
    message = JSON.parse(raw);
  } catch {
    return fail("Unreadable response from local Kaizen server.");
  }
  if (message.type === "result") return receiveResult(message);
  if (message.type === "visualization_snapshot") return receiveSnapshot(message);
  if (message.type === "changed") return receiveChanged(message);
  if (message.type === "error") return receiveError(message);
}
function receiveResult(message) {
  const purpose = state.pending.get(message.id);
  state.pending.delete(message.id);
  if (purpose === "projects") receiveProjects(decodeOutput(message.output));
}
function receiveProjects(value) {
  const fallback = requestedWorkspace || (!value?.count ? localStorage.kaizenWorkspace || "" : "");
  state.projects = projectPaths(value, fallback);
  const selected = chooseProject(value, state.projects, requestedWorkspace);
  if (!selected) return noProjects();
  renderProjects(state.projects, selected);
  activateProject(selected);
}
function noProjects() {
  setBusy(false);
  renderProjects([], "");
  showManual();
  setJourney("neutral", "No project found", "Use a project path to begin observing local sessions.");
}
function activateProject(workspace) {
  if (!workspace) return;
  state.workspace = workspace;
  state.selected = "";
  state.snapshotPending = "";
  state.refreshQueued = false;
  localStorage.kaizenWorkspace = workspace;
  $("#manual-path").value = workspace;
  renderProjects(state.projects.includes(workspace) ? state.projects : [workspace, ...state.projects], workspace);
  transport.send({ type: "subscribe", workspace });
  requestSnapshot(true);
}
function requestSnapshot(announce) {
  if (!state.workspace || state.snapshotPending) return;
  if (!transport.isOpen()) return fail("Local connection is not ready.");
  const request = snapshotRequest();
  state.snapshotPending = request.id;
  setBusy(true);
  if (announce) setJourney("neutral", "Loading observations", "Reading recent local telemetry.");
  if (!transport.send(request)) fail("Local connection is not ready.");
}
function snapshotRequest() {
  return {
    type: "visualization_snapshot",
    id: `snapshot-${++state.seq}`,
    workspace: state.workspace,
    selected_session_id: state.selected || null,
  };
}
function receiveSnapshot(message) {
  if (message.id !== state.snapshotPending) return;
  const report = message.report || {};
  state.snapshotPending = "";
  state.selected = report.selected?.session?.id || report.sessions?.[0]?.id || "";
  setBusy(false);
  setRawReport(report);
  renderReport(report);
  report.sessions?.length ? ready(report) : empty(report);
  if (state.refreshQueued) return refreshQueued();
}
function receiveError(message) {
  if (String(message.id || "").startsWith("snapshot-") && message.id !== state.snapshotPending) return;
  fail(message.error || "Request failed.");
}
function receiveChanged(message) {
  if (message.workspace !== state.workspace) return;
  if (document.hidden || state.snapshotPending) state.refreshQueued = true;
  else requestSnapshot(false);
}

function refreshQueued() {
  state.refreshQueued = false;
  requestSnapshot(false);
}

function flushQueued() {
  if (!document.hidden && state.refreshQueued && !state.snapshotPending) refreshQueued();
}
function ready(report) {
  const at = new Date(report.generated_at_ms || Date.now()).toLocaleTimeString();
  const visible = report.sessions?.length || 0;
  const total = report.totals?.session_count || visible;
  const scope = visible === total ? `${total}` : `${visible} of ${total}`;
  setJourney("ready", "Observations current", `Showing ${scope} recent sessions. Updated ${at}.`);
}
function empty(report) {
  const project = report.workspace?.split("/").filter(Boolean).at(-1) || "this project";
  setJourney("neutral", "No sessions yet", `No captured agent work for ${project}.`);
}
function selectSession(event) {
  const button = event.target.closest("button[data-session-id]");
  if (!button) return;
  state.selected = button.dataset.sessionId;
  requestSnapshot(true);
}
function openManualPath(event) {
  event.preventDefault();
  const path = $("#manual-path").value.trim();
  if (!path) return fail("Project path is required.");
  activateProject(path);
}
function fail(message) {
  state.snapshotPending = "";
  setBusy(false);
  setJourney("error", "Could not load observations", message);
  showManual(state.workspace);
}
function showAuth(message) {
  setBusy(false);
  setConnection("Authorization required", "danger");
  setJourney("auth", "Authorization required", message);
}