@cotal-ai/core 0.136.5 → 0.136.6

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 +14 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -40,11 +40,20 @@ without the profiler forcing them, and keep traced runs separate from performanc
40
40
  To name what the broker allocates, add `--broker-prof <dir>`. The harness writes the broker's
41
41
  pprof allocation profile (`/debug/pprof/allocs`) into that directory twice without forcing a
42
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.
43
+ after its last. The Go runtime samples allocations at its default rate regardless. Compare the
44
+ profiles with:
45
+
46
+ ```sh
47
+ go tool pprof -top -sample_index=alloc_space -unit=bytes \
48
+ -base <dir>/window-start.pb.gz <nats-server> <dir>/window-end.pb.gz
49
+ ```
50
+
51
+ `-base` reports shares of the allocation difference; `-diff_base` instead uses the base profile's
52
+ total for percentages. The [runtime profile](https://pkg.go.dev/runtime#MemProfile) can lag by up
53
+ to two GC cycles, so the difference covers delayed snapshots, not the exact wall-clock window.
54
+ A short window can produce equal allocation totals. Retain the collection trace and use a window
55
+ covering several cycles. These are sampled allocation counts, not a live-memory census or an
56
+ exact reconciliation with the trace's rounded heap figures.
48
57
 
49
58
  `pnpm smoke:seat-idle-go-trace` runs native default and opt-in controls. It requires Linux
50
59
  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.5",
4
+ "version": "0.136.6",
5
5
  "license": "Apache-2.0",
6
6
  "keywords": [
7
7
  "cotal",