@stati/core 1.16.2 → 1.17.0

package/dist/metrics/noop.js

@@ -0,0 +1,88 @@
+/**
+ * Noop MetricRecorder implementation.
+ * Used when metrics collection is disabled - has zero overhead.
+ * (Null Object Pattern)
+ */
+/**
+ * Empty function that does nothing.
+ */
+const noop = () => {
+    /* intentionally empty */
+};
+/**
+ * Noop implementation of MetricRecorder.
+ * All methods are no-ops with minimal overhead.
+ */
+class NoopMetricRecorder {
+    enabled = false;
+    detailed = false;
+    startSpan(_name) {
+        return noop;
+    }
+    recordPhase(_name, _durationMs) {
+        /* noop */
+    }
+    addToPhase(_name, _durationMs) {
+        /* noop */
+    }
+    increment(_name, _amount) {
+        /* noop */
+    }
+    setGauge(_name, _value) {
+        /* noop */
+    }
+    recordPageTiming(_url, _durationMs, _cached, _templatesLoaded) {
+        /* noop */
+    }
+    snapshotMemory() {
+        /* noop */
+    }
+    setISGMetrics(_metrics) {
+        /* noop */
+    }
+    setIncrementalMetrics(_metrics) {
+        /* noop */
+    }
+    finalize() {
+        // Return minimal valid metrics object
+        return {
+            schemaVersion: '1',
+            meta: {
+                timestamp: new Date().toISOString(),
+                ci: false,
+                nodeVersion: process.version.replace(/^v/, ''),
+                platform: process.platform,
+                arch: process.arch,
+                cpuCount: 1,
+                statiVersion: 'unknown',
+                command: 'build',
+                flags: {},
+            },
+            totals: {
+                durationMs: 0,
+                peakRssBytes: 0,
+                heapUsedBytes: 0,
+            },
+            phases: {},
+            counts: {
+                totalPages: 0,
+                renderedPages: 0,
+                cachedPages: 0,
+                assetsCopied: 0,
+                templatesLoaded: 0,
+                markdownFilesProcessed: 0,
+            },
+            isg: {
+                enabled: false,
+                cacheHitRate: 0,
+                manifestEntries: 0,
+                invalidatedEntries: 0,
+            },
+        };
+    }
+}
+/**
+ * Singleton noop recorder instance.
+ * Use this when metrics are disabled for zero-overhead operation.
+ */
+export const noopMetricRecorder = new NoopMetricRecorder();

package/dist/metrics/recorder.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Active MetricRecorder implementation.
+ * Uses performance.now() from node:perf_hooks for high-resolution timing.
+ */
+import type { MetricRecorder, MetricRecorderOptions } from './types.js';
+/**
+ * Create a MetricRecorder instance.
+ * Returns a noop recorder when disabled for zero overhead.
+ *
+ * @param options - Recorder configuration
+ * @returns MetricRecorder instance
+ *
+ * @example
+ * ```typescript
+ * // Create an enabled recorder
+ * const recorder = createMetricRecorder({ enabled: true });
+ *
+ * // Start a span
+ * const endSpan = recorder.startSpan('configLoadMs');
+ * await loadConfig();
+ * endSpan(); // Records duration
+ *
+ * // Increment counters
+ * recorder.increment('renderedPages');
+ *
+ * // Finalize and get metrics
+ * const metrics = recorder.finalize();
+ * ```
+ */
+export declare function createMetricRecorder(options?: MetricRecorderOptions): MetricRecorder;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/metrics/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/metrics/recorder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EAQtB,MAAM,YAAY,CAAC;AAiNpB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAaxF"}

package/dist/metrics/recorder.js

@@ -0,0 +1,176 @@
+/**
+ * Active MetricRecorder implementation.
+ * Uses performance.now() from node:perf_hooks for high-resolution timing.
+ */
+import { performance } from 'node:perf_hooks';
+import { isCI, getGitCommit, getGitBranch, getCpuCount, getPlatform, getArch, getNodeVersion, getMemoryUsage, } from './utils/index.js';
+import { noopMetricRecorder } from './noop.js';
+/**
+ * Active metric recorder that collects build performance data.
+ */
+class ActiveMetricRecorder {
+    enabled = true;
+    detailed;
+    startTime;
+    command;
+    flags;
+    statiVersion;
+    phases = {};
+    counts = {
+        totalPages: 0,
+        renderedPages: 0,
+        cachedPages: 0,
+        assetsCopied: 0,
+        templatesLoaded: 0,
+        markdownFilesProcessed: 0,
+    };
+    isgMetrics = {
+        enabled: false,
+        cacheHitRate: 0,
+        manifestEntries: 0,
+        invalidatedEntries: 0,
+    };
+    incrementalMetrics;
+    pageTimings = [];
+    gauges = new Map();
+    constructor(options = {}) {
+        this.startTime = performance.now();
+        this.detailed = options.detailed ?? false;
+        this.command = options.command ?? 'build';
+        this.flags = options.flags ?? {};
+        this.statiVersion = options.statiVersion ?? 'unknown';
+        // Take initial memory snapshot
+        this.snapshotMemory();
+    }
+    startSpan(name) {
+        const spanStart = performance.now();
+        return () => {
+            const duration = performance.now() - spanStart;
+            this.recordPhase(name, duration);
+        };
+    }
+    recordPhase(name, durationMs) {
+        // Record phase timing using the phase name directly (replaces)
+        this.phases[name] = durationMs;
+    }
+    addToPhase(name, durationMs) {
+        // Add to existing phase timing (accumulates)
+        const current = this.phases[name] ?? 0;
+        this.phases[name] = current + durationMs;
+    }
+    increment(name, amount = 1) {
+        const current = this.counts[name] ?? 0;
+        this.counts[name] = current + amount;
+    }
+    setGauge(name, value) {
+        // Gauges track the maximum value observed for a given name
+        const current = this.gauges.get(name) ?? 0;
+        this.gauges.set(name, Math.max(current, value));
+    }
+    recordPageTiming(url, durationMs, cached, templatesLoaded) {
+        if (this.detailed) {
+            const timing = { url, durationMs, cached };
+            if (templatesLoaded !== undefined) {
+                this.pageTimings.push({ ...timing, templatesLoaded });
+            }
+            else {
+                this.pageTimings.push(timing);
+            }
+        }
+    }
+    snapshotMemory() {
+        const usage = getMemoryUsage();
+        this.setGauge('peakRss', usage.rss);
+    }
+    setISGMetrics(metrics) {
+        this.isgMetrics = { ...this.isgMetrics, ...metrics };
+    }
+    setIncrementalMetrics(metrics) {
+        this.incrementalMetrics = metrics;
+    }
+    finalize() {
+        // Take final memory snapshot
+        this.snapshotMemory();
+        const finalMemory = getMemoryUsage();
+        const totalDuration = performance.now() - this.startTime;
+        // Build the meta object, excluding undefined git values
+        const gitCommit = getGitCommit();
+        const gitBranch = getGitBranch();
+        const meta = {
+            timestamp: new Date().toISOString(),
+            ci: isCI(),
+            nodeVersion: getNodeVersion(),
+            platform: getPlatform(),
+            arch: getArch(),
+            cpuCount: getCpuCount(),
+            statiVersion: this.statiVersion,
+            command: this.command,
+            flags: this.flags,
+            ...(gitCommit !== undefined && { gitCommit }),
+            ...(gitBranch !== undefined && { gitBranch }),
+        };
+        // Build the base metrics object
+        const baseMetrics = {
+            schemaVersion: '1',
+            meta,
+            totals: {
+                durationMs: totalDuration,
+                peakRssBytes: this.peakRss,
+                heapUsedBytes: finalMemory.heapUsed,
+            },
+            phases: this.phases,
+            counts: this.counts,
+            isg: this.isgMetrics,
+        };
+        // Add optional fields conditionally
+        const optionalFields = {};
+        if (this.detailed && this.pageTimings.length > 0) {
+            optionalFields.pageTimings = this.pageTimings;
+        }
+        if (this.incrementalMetrics) {
+            optionalFields.incremental = this.incrementalMetrics;
+        }
+        return { ...baseMetrics, ...optionalFields };
+    }
+    /**
+     * Get the peak RSS value from gauges.
+     */
+    get peakRss() {
+        return this.gauges.get('peakRss') ?? 0;
+    }
+}
+/**
+ * Create a MetricRecorder instance.
+ * Returns a noop recorder when disabled for zero overhead.
+ *
+ * @param options - Recorder configuration
+ * @returns MetricRecorder instance
+ *
+ * @example
+ * ```typescript
+ * // Create an enabled recorder
+ * const recorder = createMetricRecorder({ enabled: true });
+ *
+ * // Start a span
+ * const endSpan = recorder.startSpan('configLoadMs');
+ * await loadConfig();
+ * endSpan(); // Records duration
+ *
+ * // Increment counters
+ * recorder.increment('renderedPages');
+ *
+ * // Finalize and get metrics
+ * const metrics = recorder.finalize();
+ * ```
+ */
+export function createMetricRecorder(options = {}) {
+    if (options.enabled === false) {
+        return noopMetricRecorder;
+    }
+    // Check environment variable for CI metrics
+    const envEnabled = process.env.STATI_METRICS === '1' || process.env.STATI_METRICS === 'true';
+    if (!options.enabled && !envEnabled) {
+        return noopMetricRecorder;
+    }
+    return new ActiveMetricRecorder(options);
+}

package/dist/metrics/types.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Build metrics type definitions for Stati performance measurement system.
+ *
+ * Schema version: 1
+ * This schema is versioned for backward compatibility.
+ */
+/**
+ * Complete build metrics output format.
+ * Written to JSON files and used for CI regression detection.
+ */
+export interface BuildMetrics {
+    /** Schema version for backward compatibility */
+    readonly schemaVersion: '1';
+    /** Run metadata */
+    readonly meta: MetricsMeta;
+    /** Total timings and memory */
+    readonly totals: MetricsTotals;
+    /** Phase breakdown (all times in milliseconds) */
+    readonly phases: MetricsPhases;
+    /** Counts */
+    readonly counts: MetricsCounts;
+    /** ISG cache metrics */
+    readonly isg: MetricsISG;
+    /** Per-page timing (optional, only when detailed tracing enabled) */
+    readonly pageTimings?: readonly PageTiming[];
+    /** Incremental rebuild metrics (dev mode only) */
+    readonly incremental?: IncrementalMetrics;
+}
+/**
+ * Run metadata for a build metrics report.
+ */
+export interface MetricsMeta {
+    /** ISO timestamp of build start */
+    readonly timestamp: string;
+    /** Git commit SHA (if available) */
+    readonly gitCommit?: string;
+    /** Git branch (if available) */
+    readonly gitBranch?: string;
+    /** Whether running in CI environment */
+    readonly ci: boolean;
+    /** Node.js version */
+    readonly nodeVersion: string;
+    /** Platform (darwin, linux, win32) */
+    readonly platform: 'aix' | 'darwin' | 'freebsd' | 'linux' | 'openbsd' | 'sunos' | 'win32';
+    /** CPU architecture */
+    readonly arch: string;
+    /** Number of CPU cores */
+    readonly cpuCount: number;
+    /** Stati version */
+    readonly statiVersion: string;
+    /** Command executed */
+    readonly command: 'build' | 'dev';
+    /** CLI flags used */
+    readonly flags: MetricsFlags;
+}
+/**
+ * CLI flags captured in metrics.
+ */
+export interface MetricsFlags {
+    readonly force?: boolean | undefined;
+    readonly clean?: boolean | undefined;
+    readonly includeDrafts?: boolean | undefined;
+}
+/**
+ * Total timings and memory measurements.
+ */
+export interface MetricsTotals {
+    /** Total build duration in milliseconds */
+    readonly durationMs: number;
+    /** Peak RSS in bytes */
+    readonly peakRssBytes: number;
+    /** Heap used at end of build in bytes */
+    readonly heapUsedBytes: number;
+}
+/**
+ * Phase breakdown timings in milliseconds.
+ * All fields are optional as not all phases run in every build.
+ */
+export interface MetricsPhases {
+    readonly configLoadMs?: number;
+    readonly contentDiscoveryMs?: number;
+    readonly navigationBuildMs?: number;
+    readonly cacheManifestLoadMs?: number;
+    readonly typescriptCompileMs?: number;
+    readonly pageRenderingMs?: number;
+    readonly assetCopyMs?: number;
+    readonly cacheManifestSaveMs?: number;
+    readonly sitemapGenerationMs?: number;
+    readonly rssGenerationMs?: number;
+    /** Build hooks - only recorded when hooks are configured */
+    readonly hookBeforeAllMs?: number;
+    readonly hookAfterAllMs?: number;
+    /** Aggregate time spent in beforeRender hooks across all pages */
+    readonly hookBeforeRenderTotalMs?: number;
+    /** Aggregate time spent in afterRender hooks across all pages */
+    readonly hookAfterRenderTotalMs?: number;
+}
+/**
+ * Phase names as a union type for type safety.
+ */
+export type PhaseName = keyof MetricsPhases;
+/**
+ * Counts of various build artifacts.
+ */
+export interface MetricsCounts {
+    readonly totalPages: number;
+    readonly renderedPages: number;
+    readonly cachedPages: number;
+    readonly assetsCopied: number;
+    readonly templatesLoaded: number;
+    readonly markdownFilesProcessed: number;
+}
+/**
+ * Counter names as a union type for type safety.
+ */
+export type CounterName = keyof MetricsCounts;
+/**
+ * Known gauge names as a union type for type safety.
+ * Gauges are point-in-time values that can go up or down (unlike counters).
+ */
+export type GaugeName = 'peakRss';
+/**
+ * ISG cache metrics.
+ */
+export interface MetricsISG {
+    /** Whether ISG caching is enabled */
+    readonly enabled: boolean;
+    /** Cache hit rate (0..1) */
+    readonly cacheHitRate: number;
+    /** Number of entries in manifest */
+    readonly manifestEntries: number;
+    /** Number of entries invalidated this build */
+    readonly invalidatedEntries: number;
+}
+/**
+ * Per-page timing information.
+ * Only collected when detailed metrics are enabled.
+ */
+export interface PageTiming {
+    /** Page URL */
+    readonly url: string;
+    /** Render duration in milliseconds */
+    readonly durationMs: number;
+    /** Whether page was served from cache */
+    readonly cached: boolean;
+    /** Number of templates loaded for this page (undefined for cached pages) */
+    readonly templatesLoaded?: number;
+}
+/**
+ * Incremental rebuild metrics for dev server.
+ */
+export interface IncrementalMetrics {
+    /** File that triggered the rebuild */
+    readonly triggerFile: string;
+    /** Type of file that changed */
+    readonly triggerType: 'markdown' | 'template' | 'static' | 'config';
+    /** Number of pages rendered */
+    readonly renderedPages: number;
+    /** Number of pages served from cache */
+    readonly cachedPages: number;
+    /** Total rebuild duration in milliseconds */
+    readonly durationMs: number;
+}
+/**
+ * Options for creating a MetricRecorder.
+ */
+export interface MetricRecorderOptions {
+    /** Whether metrics collection is enabled */
+    enabled?: boolean | undefined;
+    /** Whether to collect per-page timings */
+    detailed?: boolean | undefined;
+    /** Command being executed */
+    command?: 'build' | 'dev' | undefined;
+    /** CLI flags used */
+    flags?: MetricsFlags | undefined;
+    /** Stati version string */
+    statiVersion?: string | undefined;
+}
+/**
+ * Interface for metrics collection.
+ * The noop implementation has zero overhead when disabled.
+ */
+export interface MetricRecorder {
+    /**
+     * Start a named span, returns a function to end it.
+     * The returned function records the duration when called.
+     */
+    startSpan(name: PhaseName): () => void;
+    /**
+     * Record a phase duration directly (replaces existing value).
+     */
+    recordPhase(name: PhaseName, durationMs: number): void;
+    /**
+     * Add to an existing phase duration (for accumulating per-page hook times).
+     */
+    addToPhase(name: PhaseName, durationMs: number): void;
+    /**
+     * Increment a counter.
+     */
+    increment(name: CounterName, amount?: number): void;
+    /**
+     * Set a gauge value (for point-in-time metrics like peak memory).
+     * Gauges track the maximum value observed for a given name.
+     */
+    setGauge(name: GaugeName, value: number): void;
+    /**
+     * Record page timing (only when detailed mode enabled).
+     * @param templatesLoaded - Number of templates loaded (optional, typically undefined for cached pages)
+     */
+    recordPageTiming(url: string, durationMs: number, cached: boolean, templatesLoaded?: number): void;
+    /**
+     * Take memory snapshot to track peak RSS.
+     */
+    snapshotMemory(): void;
+    /**
+     * Set ISG metrics.
+     */
+    setISGMetrics(metrics: Partial<MetricsISG>): void;
+    /**
+     * Set incremental rebuild metrics (dev mode).
+     */
+    setIncrementalMetrics(metrics: IncrementalMetrics): void;
+    /**
+     * Finalize and return metrics object.
+     */
+    finalize(): BuildMetrics;
+    /**
+     * Whether metrics collection is enabled.
+     */
+    readonly enabled: boolean;
+    /**
+     * Whether detailed (per-page) metrics are enabled.
+     */
+    readonly detailed: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/metrics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"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"}

package/dist/metrics/types.js

@@ -0,0 +1,7 @@
+/**
+ * Build metrics type definitions for Stati performance measurement system.
+ *
+ * Schema version: 1
+ * This schema is versioned for backward compatibility.
+ */
+export {};

package/dist/metrics/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Metrics utility functions barrel export.
+ *
+ * @packageDocumentation
+ */
+export { isCI, getGitCommit, getGitBranch, getCpuCount, getPlatform, getArch, getMemoryUsage, getNodeVersion, } from './system.utils.js';
+export { DEFAULT_METRICS_DIR, generateMetricsFilename, writeMetrics, formatMetricsSummary, } from './writer.utils.js';
+export type { WriteMetricsOptions, WriteMetricsResult } from './writer.utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,OAAO,EACP,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/metrics/utils/index.js

@@ -0,0 +1,9 @@
+/**
+ * Metrics utility functions barrel export.
+ *
+ * @packageDocumentation
+ */
+// System utilities
+export { isCI, getGitCommit, getGitBranch, getCpuCount, getPlatform, getArch, getMemoryUsage, getNodeVersion, } from './system.utils.js';
+// Writer utilities
+export { DEFAULT_METRICS_DIR, generateMetricsFilename, writeMetrics, formatMetricsSummary, } from './writer.utils.js';

package/dist/metrics/utils/system.utils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * System information utilities for metrics collection.
+ * Uses only Node.js built-ins to avoid external dependencies.
+ */
+import { platform } from 'node:os';
+/**
+ * Detect if running in a CI environment.
+ */
+export declare function isCI(): boolean;
+/**
+ * Get the current Git commit SHA.
+ * Returns undefined if not in a git repository or git is not available.
+ */
+export declare function getGitCommit(): string | undefined;
+/**
+ * Get the current Git branch name.
+ * Returns undefined if not in a git repository or git is not available.
+ */
+export declare function getGitBranch(): string | undefined;
+/**
+ * Get the number of CPU cores.
+ */
+export declare function getCpuCount(): number;
+/**
+ * Get the current platform.
+ */
+export declare function getPlatform(): ReturnType<typeof platform>;
+/**
+ * Get the CPU architecture.
+ */
+export declare function getArch(): string;
+/**
+ * Get Node.js version string (without the 'v' prefix).
+ */
+export declare function getNodeVersion(): string;
+/**
+ * Get current memory usage snapshot.
+ */
+export declare function getMemoryUsage(): {
+    rss: number;
+    heapUsed: number;
+    heapTotal: number;
+};
+//# sourceMappingURL=system.utils.d.ts.map

package/dist/metrics/utils/system.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.utils.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/system.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAQ,QAAQ,EAAQ,MAAM,SAAS,CAAC;AAiB/C;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAWjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAWjD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAOA"}