@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 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 | `pnpm --filter @forgeax/engine-profiler run cli summary --file artifact.json` | structured JSON on stdout |
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
- pnpm --filter @forgeax/engine-profiler run cli summary --file profile-capture.json
90
- pnpm --filter @forgeax/engine-profiler run cli frame --file profile-capture.json --frame-id 12
91
- pnpm --filter @forgeax/engine-profiler run cli phase --file profile-capture.json --source render --phase record
92
- pnpm --filter @forgeax/engine-profiler run cli compare --left-file before.json --right-file after.json
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.27",
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"
@@ -1,5 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- import { main } from '../dist/cli.mjs';
4
-
5
- main();