@cotal-ai/core 0.136.3 → 0.136.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +8 -4
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -37,10 +37,14 @@ the parent received a line, not the exact collection time. Native trace fields d
37
37
  broker's Go version. No memory cap or GC policy changes. Omit `--ram` to observe collections
38
38
  without the profiler forcing them, and keep traced runs separate from performance comparisons.
39
39
 
40
- To name what the broker allocates, add `--broker-prof <file>`. After the window's counters
41
- are read, the harness writes the broker's pprof allocation profile (`/debug/pprof/allocs`) to
42
- that file without forcing a collection; the Go runtime samples allocations at its default rate
43
- regardless. Read it with `go tool pprof -top -sample_index=alloc_space <nats-server> <file>`.
40
+ To name what the broker allocates, add `--broker-prof <dir>`. The harness writes the broker's
41
+ pprof allocation profile (`/debug/pprof/allocs`) into that directory twice without forcing a
42
+ collection: `window-start.pb.gz` before the window's first counter is read and `window-end.pb.gz`
43
+ after its last; the Go runtime samples allocations at its default rate regardless. Read the window
44
+ alone with `go tool pprof -top -sample_index=alloc_space -diff_base <dir>/window-start.pb.gz
45
+ <nats-server> <dir>/window-end.pb.gz`. The runtime publishes allocation records at the end of a
46
+ collection, so each file is as of the last broker GC cycle before its read; a window without a
47
+ cycle yields two equal profiles, and the difference is sharp only over several cycles.
44
48
 
45
49
  `pnpm smoke:seat-idle-go-trace` runs native default and opt-in controls. It requires Linux
46
50
  and NATS Server 2.15.1. Other platforms or broker versions emit an explicit skipped sentinel
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@cotal-ai/core",
3
3
  "description": "The Cotal protocol: endpoint, subjects, message types, the NATS client layer, and the extension contracts.",
4
- "version": "0.136.3",
4
+ "version": "0.136.4",
5
5
  "license": "Apache-2.0",
6
6
  "keywords": [
7
7
  "cotal",