septum 0.1.3 → 0.1.5

package/src/core/session/session-manager.ts

@@ -1,56 +1,56 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import type { ActiveFeatureSession } from "../../types/index.ts";
-
-export class SessionManager {
-  private static readonly SESSION_FILE = ".septum/session.json";
-
-  /**
-   * Save the active feature session to .septum/session.json
-   */
-  public static saveActiveSession(workspaceRoot: string, session: ActiveFeatureSession): void {
-    const septumDir = join(workspaceRoot, ".septum");
-    if (!existsSync(septumDir)) {
-      mkdirSync(septumDir, { recursive: true });
-    }
-    const sessionPath = join(workspaceRoot, SessionManager.SESSION_FILE);
-    writeFileSync(sessionPath, JSON.stringify(session, null, 2), "utf-8");
-  }
-
-  /**
-   * Get the active feature session, or null if no session exists or file is invalid
-   */
-  public static getActiveSession(workspaceRoot: string): ActiveFeatureSession | null {
-    const sessionPath = join(workspaceRoot, SessionManager.SESSION_FILE);
-    if (!existsSync(sessionPath)) {
-      return null;
-    }
-
-    try {
-      const raw = readFileSync(sessionPath, "utf-8");
-      const parsed = JSON.parse(raw) as ActiveFeatureSession;
-      if (parsed && typeof parsed.feature_key === "string" && Array.isArray(parsed.touchpoints)) {
-        return parsed;
-      }
-      return null;
-    } catch {
-      return null;
-    }
-  }
-
-  /**
-   * Clear the active feature session
-   */
-  public static clearActiveSession(workspaceRoot: string): boolean {
-    const sessionPath = join(workspaceRoot, SessionManager.SESSION_FILE);
-    if (existsSync(sessionPath)) {
-      try {
-        rmSync(sessionPath, { force: true });
-        return true;
-      } catch {
-        return false;
-      }
-    }
-    return false;
-  }
-}
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import type { ActiveFeatureSession } from "../../types/index.ts";
+
+export class SessionManager {
+  private static readonly SESSION_FILE = ".septum/session.json";
+
+  /**
+   * Save the active feature session to .septum/session.json
+   */
+  public static saveActiveSession(workspaceRoot: string, session: ActiveFeatureSession): void {
+    const septumDir = join(workspaceRoot, ".septum");
+    if (!existsSync(septumDir)) {
+      mkdirSync(septumDir, { recursive: true });
+    }
+    const sessionPath = join(workspaceRoot, SessionManager.SESSION_FILE);
+    writeFileSync(sessionPath, JSON.stringify(session, null, 2), "utf-8");
+  }
+
+  /**
+   * Get the active feature session, or null if no session exists or file is invalid
+   */
+  public static getActiveSession(workspaceRoot: string): ActiveFeatureSession | null {
+    const sessionPath = join(workspaceRoot, SessionManager.SESSION_FILE);
+    if (!existsSync(sessionPath)) {
+      return null;
+    }
+
+    try {
+      const raw = readFileSync(sessionPath, "utf-8");
+      const parsed = JSON.parse(raw) as ActiveFeatureSession;
+      if (parsed && typeof parsed.feature_key === "string" && Array.isArray(parsed.touchpoints)) {
+        return parsed;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Clear the active feature session
+   */
+  public static clearActiveSession(workspaceRoot: string): boolean {
+    const sessionPath = join(workspaceRoot, SessionManager.SESSION_FILE);
+    if (existsSync(sessionPath)) {
+      try {
+        rmSync(sessionPath, { force: true });
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    return false;
+  }
+}

package/src/core/telemetry/telemetry.ts

@@ -1,86 +1,86 @@
-import { appendFileSync, existsSync, mkdirSync, renameSync, statSync } from "node:fs";
-import { dirname, join } from "node:path";
-
-export interface SeptumToolCallEvent {
-  timestamp?: string;
-  event: "tool_call_completed" | "tool_call_failed";
-  tool: string;
-  duration_ms: number;
-  input: Record<string, any>;
-  metrics?: {
-    bytes_out?: number;
-    lines_out?: number;
-    nodes_returned?: number;
-  };
-  session?: {
-    feature_key?: string | null;
-    domain?: string | null;
-  } | null;
-  status: "success" | "error";
-  error?: {
-    code?: string;
-    message: string;
-    stack?: string;
-  };
-}
-
-export class SeptumTelemetry {
-  private static readonly MAX_LOG_SIZE_BYTES = 2 * 1024 * 1024; // 2MB
-  private static readonly SLOW_EXECUTION_THRESHOLD_MS = 250;
-
-  /**
-   * Resolves the log file path inside the active workspace's .septum directory.
-   */
-  public static getLogPath(workspaceRoot: string = process.cwd()): string {
-    return join(workspaceRoot, ".septum", "septum.log");
-  }
-
-  /**
-   * Records a tool call event to both stderr (dual-sink) and .septum/septum.log.
-   */
-  public static recordToolCall(
-    event: SeptumToolCallEvent,
-    workspaceRoot: string = process.cwd()
-  ): void {
-    const payload: SeptumToolCallEvent = {
-      timestamp: event.timestamp || new Date().toISOString(),
-      ...event,
-    };
-
-    const jsonLine = JSON.stringify(payload);
-
-    // Sink 1: Live stderr stream for operator monitoring (slow queries & failures)
-    if (payload.status === "error") {
-      console.error(`[Septum Telemetry ERROR] ${jsonLine}`);
-    } else if (payload.duration_ms >= this.SLOW_EXECUTION_THRESHOLD_MS) {
-      console.error(`[Septum Telemetry SLOW_WARN] ${jsonLine}`);
-    }
-
-    // Sink 2: Append-only persistent file recorder in .septum/septum.log
-    try {
-      const logPath = this.getLogPath(workspaceRoot);
-      const logDir = dirname(logPath);
-
-      if (!existsSync(logDir)) {
-        mkdirSync(logDir, { recursive: true });
-      }
-
-      // Check for rotation if file exceeds 2MB
-      if (existsSync(logPath)) {
-        try {
-          const stats = statSync(logPath);
-          if (stats.size >= this.MAX_LOG_SIZE_BYTES) {
-            const rotatedPath = `${logPath}.1`;
-            renameSync(logPath, rotatedPath);
-          }
-        } catch {
-          // If stat/rotation fails, proceed to append without crashing
-        }
-      }
-
-      appendFileSync(logPath, `${jsonLine}\n`, "utf8");
-    } catch {
-      // Telemetry file writes must never crash the main application process
-    }
-  }
-}
+import { appendFileSync, existsSync, mkdirSync, renameSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+export interface SeptumToolCallEvent {
+  timestamp?: string;
+  event: "tool_call_completed" | "tool_call_failed";
+  tool: string;
+  duration_ms: number;
+  input: Record<string, any>;
+  metrics?: {
+    bytes_out?: number;
+    lines_out?: number;
+    nodes_returned?: number;
+  };
+  session?: {
+    feature_key?: string | null;
+    domain?: string | null;
+  } | null;
+  status: "success" | "error";
+  error?: {
+    code?: string;
+    message: string;
+    stack?: string;
+  };
+}
+
+export class SeptumTelemetry {
+  private static readonly MAX_LOG_SIZE_BYTES = 2 * 1024 * 1024; // 2MB
+  private static readonly SLOW_EXECUTION_THRESHOLD_MS = 250;
+
+  /**
+   * Resolves the log file path inside the active workspace's .septum directory.
+   */
+  public static getLogPath(workspaceRoot: string = process.cwd()): string {
+    return join(workspaceRoot, ".septum", "septum.log");
+  }
+
+  /**
+   * Records a tool call event to both stderr (dual-sink) and .septum/septum.log.
+   */
+  public static recordToolCall(
+    event: SeptumToolCallEvent,
+    workspaceRoot: string = process.cwd()
+  ): void {
+    const payload: SeptumToolCallEvent = {
+      timestamp: event.timestamp || new Date().toISOString(),
+      ...event,
+    };
+
+    const jsonLine = JSON.stringify(payload);
+
+    // Sink 1: Live stderr stream for operator monitoring (slow queries & failures)
+    if (payload.status === "error") {
+      console.error(`[Septum Telemetry ERROR] ${jsonLine}`);
+    } else if (payload.duration_ms >= this.SLOW_EXECUTION_THRESHOLD_MS) {
+      console.error(`[Septum Telemetry SLOW_WARN] ${jsonLine}`);
+    }
+
+    // Sink 2: Append-only persistent file recorder in .septum/septum.log
+    try {
+      const logPath = this.getLogPath(workspaceRoot);
+      const logDir = dirname(logPath);
+
+      if (!existsSync(logDir)) {
+        mkdirSync(logDir, { recursive: true });
+      }
+
+      // Check for rotation if file exceeds 2MB
+      if (existsSync(logPath)) {
+        try {
+          const stats = statSync(logPath);
+          if (stats.size >= this.MAX_LOG_SIZE_BYTES) {
+            const rotatedPath = `${logPath}.1`;
+            renameSync(logPath, rotatedPath);
+          }
+        } catch {
+          // If stat/rotation fails, proceed to append without crashing
+        }
+      }
+
+      appendFileSync(logPath, `${jsonLine}\n`, "utf8");
+    } catch {
+      // Telemetry file writes must never crash the main application process
+    }
+  }
+}