@pi-archimedes/core 1.7.1 → 1.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-archimedes/core",
-  "version": "1.7.1",
+  "version": "1.8.1",
   "type": "module",
   "keywords": [
     "pi-package"
@@ -17,7 +17,8 @@
     "./text": "./src/text.ts",
     "./color": "./src/color.ts",
     "./config": "./src/config.ts",
-    "./settings-io": "./src/settings-io.ts"
+    "./settings-io": "./src/settings-io.ts",
+    "./profiler": "./src/profiler.ts"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.1.0",

package/src/profiler.ts

@@ -0,0 +1,49 @@
+/** Lightweight startup profiler — prints per-package timings when PI_TIMING=1. */
+
+const ENABLED = process.env.PI_TIMING === "1";
+
+interface TimingState {
+  baseline: number;
+  entries: Array<{ label: string; ms: number }>;
+}
+
+// Module-level accumulator (survives hot-reloads via Symbol key)
+const TIMINGS_KEY = Symbol.for("archimedes:timings");
+declare const globalThis: typeof global & Record<typeof TIMINGS_KEY, TimingState>;
+
+function getState(): TimingState {
+  if (!globalThis[TIMINGS_KEY]) {
+    globalThis[TIMINGS_KEY] = { baseline: Date.now(), entries: [] };
+  }
+  return globalThis[TIMINGS_KEY];
+}
+
+// ── Public API — zero-cost when disabled (early-return when PI_TIMING unset) ──
+
+export function time(label: string): void {
+  if (!ENABLED) return;
+  const state = getState();
+  state.entries.push({ label, ms: Date.now() - state.baseline });
+}
+
+/** Reset timings for a fresh session (call on reload). */
+export function reset(): void {
+  if (!ENABLED) return;
+  globalThis[TIMINGS_KEY] = { baseline: Date.now(), entries: [] };
+}
+
+/** Print accumulated timings to stderr. Call once at session_shutdown or on demand. */
+export function print(): void {
+  if (!ENABLED) return;
+  const state = getState();
+  if (state.entries.length === 0) return;
+
+  let prevMs = 0;
+  console.error("");
+  for (const entry of state.entries) {
+    const delta = entry.ms - prevMs;
+    prevMs = entry.ms;
+    console.error(`  archimedes: ${entry.label}: +${delta}ms (${entry.ms}ms cumulative)`);
+  }
+  console.error("".padEnd(60, "-"));
+}