@forgeax/engine-profiler 0.1.27 → 0.1.29
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.
- package/README.md +5 -5
- package/package.json +1 -6
- package/bin/forgeax-engine-profiler.mjs +0 -5
package/README.md
CHANGED
|
@@ -37,7 +37,7 @@ Pass the same `profiler` to `createApp({ renderer, world, profiler })` or to the
|
|
|
37
37
|
| Finish and retain the artifact | `session.finish()` | `Result<ProfileCapture, ProfilerError>` |
|
|
38
38
|
| Validate persisted JSON | `validateProfileCapture(value)` | schema and semantic validation |
|
|
39
39
|
| Build an offline summary | `buildProfileModel(capture)` | frame and phase projections |
|
|
40
|
-
| Query from a shell | `
|
|
40
|
+
| Query from a shell | `forgeax debug profile summary --artifact artifact.json --json` | structured JSON on stdout |
|
|
41
41
|
|
|
42
42
|
`ProfileCapture` is the portable boundary. It carries the fixed version, time unit, bounded frame and event evidence, owner phase catalog, and `completeness` status. `complete`, `partial`, and `overflow` are explicit outcomes; an overflow artifact remains useful and records its affected frame range.
|
|
43
43
|
|
|
@@ -86,10 +86,10 @@ const started = profiler.startCapture({
|
|
|
86
86
|
## Offline and CLI workflow
|
|
87
87
|
|
|
88
88
|
```sh
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
89
|
+
forgeax debug profile summary --artifact profile-capture.json --json
|
|
90
|
+
forgeax debug profile frame --artifact profile-capture.json --frame-id 12 --json
|
|
91
|
+
forgeax debug profile phase --artifact profile-capture.json --source render --phase record --json
|
|
92
|
+
forgeax debug profile compare --left-file before.json --right-file after.json --json
|
|
93
93
|
```
|
|
94
94
|
|
|
95
95
|
The CLI reads one `ProfileCapture` JSON object from `--file` or two objects from
|
package/package.json
CHANGED
|
@@ -1,14 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@forgeax/engine-profiler",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.29",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|
|
7
7
|
"sideEffects": false,
|
|
8
8
|
"description": "CPU profile capture, bounded recording, and deterministic offline analysis for forgeax-engine.",
|
|
9
|
-
"bin": {
|
|
10
|
-
"forgeax-engine-profiler": "./bin/forgeax-engine-profiler.mjs"
|
|
11
|
-
},
|
|
12
9
|
"exports": {
|
|
13
10
|
".": {
|
|
14
11
|
"types": "./dist/index.d.ts",
|
|
@@ -27,7 +24,6 @@
|
|
|
27
24
|
"main": "./dist/index.mjs",
|
|
28
25
|
"types": "./dist/index.d.ts",
|
|
29
26
|
"files": [
|
|
30
|
-
"bin",
|
|
31
27
|
"dist",
|
|
32
28
|
"schema",
|
|
33
29
|
"src",
|
|
@@ -68,7 +64,6 @@
|
|
|
68
64
|
},
|
|
69
65
|
"scripts": {
|
|
70
66
|
"build": "tsup",
|
|
71
|
-
"cli": "node bin/forgeax-engine-profiler.mjs",
|
|
72
67
|
"test": "vitest run",
|
|
73
68
|
"smoke:consumer": "node scripts/consume-smoke.mjs",
|
|
74
69
|
"test:perf": "node ../../scripts/bench/profiler-overhead.mjs"
|