@hydranium/core 1.0.0-next.270 → 1.0.0-next.271

package/src/node/profile-capture.ts

@@ -17,17 +17,10 @@
  * `ProfileSession` (aggregate self-time spans).
  */
 
-import { Format, type ProfileCaptureOptions } from '@hydranium/protocol';
+import { type Clock, Format, type ProfileCaptureOptions, type Stopwatch, SystemClock } from '@hydranium/protocol';
 import * as fs from 'node:fs';
 import { Session } from 'node:inspector';
-import {
-   constants,
-   monitorEventLoopDelay,
-   PerformanceObserver,
-   performance,
-   type IntervalHistogram,
-   type PerformanceEntry
-} from 'node:perf_hooks';
+import { constants, monitorEventLoopDelay, PerformanceObserver, type IntervalHistogram, type PerformanceEntry } from 'node:perf_hooks';
 import { snapshotFilePath, writeHeapSnapshotToDir } from '@hydranium/protocol/node';
 
 export const DEFAULT_CPU_INTERVAL_MICROS = 1000;
@@ -181,7 +174,9 @@ let active: ProfileCapture | undefined;
  * session at a time); prefer {@link profileWorkload} for the common wrap-a-block case.
  */
 export class ProfileCapture {
-   protected startedAt = 0;
+   /** Times the window: real time, since what it frames is real CPU and memory. */
+   protected readonly clock: Clock = new SystemClock();
+   protected sinceStart: Stopwatch = this.clock.stopwatch();
    protected startCpu: NodeJS.CpuUsage = { user: 0, system: 0 };
    protected startMem: NodeJS.MemoryUsage = process.memoryUsage();
    protected session?: InspectorSessionLike;
@@ -214,7 +209,7 @@ export class ProfileCapture {
    }
 
    protected async begin(): Promise<void> {
-      this.startedAt = performance.now();
+      this.sinceStart = this.clock.stopwatch();
       this.startCpu = process.cpuUsage();
       this.startMem = process.memoryUsage();
       if (this.options.cpu || this.options.allocation) {
@@ -254,7 +249,7 @@ export class ProfileCapture {
       if (active !== this) {
          throw new Error('ProfileCapture.stop called on an inactive capture.');
       }
-      const durationMs = performance.now() - this.startedAt;
+      const durationMs = this.sinceStart.elapsedMs;
       // Sample cpu + memory at the workload boundary (alongside durationMs), NOT
       // after teardown: the synchronous profile write inflates RSS and the heap
       // snapshot forces a full GC, so a post-teardown read would fold the

package/src/node/server-state-snapshot.ts

@@ -7,7 +7,7 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 
-import { Format } from '@hydranium/protocol';
+import { Format, type Stopwatch, SystemClock } from '@hydranium/protocol';
 import { DocumentState, type LangiumDocuments } from '@hydranium/langium';
 import { isCstShed } from '../langium/residency/cst-residency-service.js';
 import { performance } from 'node:perf_hooks';
@@ -15,7 +15,7 @@ import * as v8 from 'node:v8';
 
 /** Cumulative samples kept across calls so each snapshot can report deltas. */
 interface DeltaState {
-   atMs: number;
+   sinceSample: Stopwatch;
    cpu: NodeJS.CpuUsage;
    elu: { idle: number; active: number };
 }
@@ -62,7 +62,7 @@ export interface ServerStateSnapshotOptions {
  * requested via `options` ({@link ServerStateSnapshotOptions}).
  */
 export function formatServerState(documents?: LangiumDocuments, label?: string, options?: ServerStateSnapshotOptions): string {
-   const now = performance.now();
+   const sinceSample = new SystemClock().stopwatch();
    const mem = process.memoryUsage();
    const heap = v8.getHeapStatistics();
    const cpu = process.cpuUsage();
@@ -87,7 +87,7 @@ export function formatServerState(documents?: LangiumDocuments, label?: string,
          `native contexts ${heap.number_of_native_contexts}, detached contexts ${heap.number_of_detached_contexts}`
    );
    if (lastSample) {
-      const wallMs = now - lastSample.atMs;
+      const wallMs = lastSample.sinceSample.elapsedMs;
       const userMs = (cpu.user - lastSample.cpu.user) / 1000;
       const systemMs = (cpu.system - lastSample.cpu.system) / 1000;
       const cpuPct = wallMs > 0 ? Math.round(((userMs + systemMs) / wallMs) * 100) : 0;
@@ -138,7 +138,7 @@ export function formatServerState(documents?: LangiumDocuments, label?: string,
       }
    }
 
-   lastSample = { atMs: now, cpu, elu };
+   lastSample = { sinceSample, cpu, elu };
    return lines.join('\n');
 }
 

package/src/testing/stub-writable-file-system.ts

@@ -8,6 +8,7 @@
  ********************************************************************************/
 
 import type { URI } from '@hydranium/langium';
+import { SystemClock } from '@hydranium/protocol';
 import type { WritableFileSystemProvider } from '../langium/workspace/file-system-provider.js';
 import type { StubSelfSaveRegistry } from './stub-self-save-registry.js';
 
@@ -49,7 +50,7 @@ export function makeStubWritableFileSystem(selfSaveRegistry?: StubSelfSaveRegist
       readDirectory: async () => [],
       async writeFile(uri: URI, content: string) {
          writes.push({ uri: uri.toString(), content });
-         selfSaveRegistry?.register(uri.fsPath, Date.now());
+         selfSaveRegistry?.register(uri.fsPath, new SystemClock().now());
       },
       reset() {
          writes.length = 0;