refactor: update measure readme

Author: BioPhoton

packages/cpu-prof/docs/case-study--nx-graph-time/Readme.md

@@ -1,43 +1,155 @@
 # Case Study — Nx graph time
 
-## Measured graphs
+
+## Tools and Setup
+
+### Setup Detection
+
+We use commands to capture the setup specification:
+- `nx report` - to capture the Nx, Node.js, and OS versions.
+- `nx reset` - to reset the Nx daemon and clear the cache before running measurements.
+
+### Environment
+
+We disable the Nx daemon and the Nx cache to ensure consistent measurements:
+
+- `NX_DAEMON=false` - Disables the Nx daemon, which can cache results and affect performance measurements.
+- `NX_CACHE=false` - Disables the Nx computation cache, ensuring that all computations are performed fresh without cached results.
+- `NX_TUI=false` - Disables the Nx TUI (Text User Interface) to avoid any potential interference with performance measurements.
+
+### CPU Profiling
+
+We use the native Node.js CPU profiling capabilities through the `--cpu-prof` and `--cpu-prof-dir` flags.  
+The tool [@push-based/cpu-prof](https://www.npmjs.com/package/@push-based/cpu-prof) 🚀 provides a convenient CLI to run commands with CPU profiling enabled and to merge multiple CPU profiles into one.
+
+## Measurements
 
 Use native Node.js CPU profiling to analyze where time is spent when calculating Nx graphs.
 
-### Project Graph
+The following commands are executed from the root of a Nx workspace:
+- `npx nx graph --file=nx-project-graph.json` - project graph generation
+  - `npx nx graph --groupByFolder --file=nx-project-graph-grouped.json` - project graph with grouped folders
+  - Remove plugins form nx.json, then run `npx nx graph --file=nx-project-graph-no-plugins.json` - project graph without plugins
+- `npx nx graph --view=tasks --targets=<targets> --file=nx-task-graph-build.json` - task graph for specific target
+- `npx nx graph --affected --base=main --file=/tmp/nx-affected-graph-main.json` - affected graph calculation for specified base
+
+### Project Graph (nx graph)
 
-Save setup specification:
+1. Save setup specification:
 
 ```bash
-nx report > ./profiles/nx-show-projects/nx-report.md
+mkdir -p ./profiles/nx-project-graph && \
+nx reset && nx report > ./profiles/nx-project-graph/nx-report.md
 ```
 
-Measure the project graph creation:
+2. Measure the project graph creation:
 
 ```bash
 # Prerequisite (once): install local deps so ./node_modules/.bin/nx exists
 NX_DAEMON=false NX_CACHE=false \
 npx -y @push-based/cpu-prof \
---cpu-prof-dir ./profiles/nx-show-projects \
-node ./node_modules/nx/bin/nx.js show projects --json
+--cpu-prof-dir ./profiles/nx-project-graph \
+node ./node_modules/nx/bin/nx.js graph --file=nx-project-graph.json
+```
+
+
+### Project Graph (grouped by folder)
+
+1. Save setup specification:
+
+```bash
+mkdir -p ./profiles/nx-project-graph-grouped && \
+nx reset && nx report > ./profiles/nx-project-graph-grouped/nx-report.md
+```
+
+2. Measure the project graph creation with grouped folders:
+
+```bash
+# Prerequisite (once): install local deps so ./node_modules/.bin/nx exists
+NX_DAEMON=false NX_CACHE=false \
+npx -y @push-based/cpu-prof \
+--cpu-prof-dir ./profiles/nx-project-graph-grouped \
+node ./node_modules/nx/bin/nx.js graph --groupByFolder --file=nx-project-graph-grouped.json
+```
+
+
+### Project Graph (no plugins)
+
+1. Save setup specification:
+
+```bash
+mkdir -p ./profiles/nx-project-graph-no-plugins && \
+nx reset && nx report > ./profiles/nx-project-graph-no-plugins/nx-report.md
+```
+
+2. Measure the project graph creation without plugins:
+
+```bash
+# Prerequisite (once): install local deps so ./node_modules/.bin/nx exists
+# Before running, remove plugins from nx.json
+NX_DAEMON=false NX_CACHE=false \
+npx -y @push-based/cpu-prof \
+--cpu-prof-dir ./profiles/nx-project-graph-no-plugins \
+node ./node_modules/nx/bin/nx.js graph --file=nx-project-graph-no-plugins.json
+```
+
+
+### Task Graph for specific target(s)
+
+1. Save setup specification:
+
+```bash
+mkdir -p ./profiles/nx-task-graph-build && \
+nx reset && nx report > ./profiles/nx-task-graph-build/nx-report.md
+```
+
+2. Measure the task graph creation for specific target(s):
+
+```bash
+# Prerequisite (once): install local deps so ./node_modules/.bin/nx exists
+NX_DAEMON=false NX_CACHE=false \
+npx -y @push-based/cpu-prof \
+--cpu-prof-dir ./profiles/nx-task-graph-build \
+node ./node_modules/nx/bin/nx.js graph --view=tasks --targets=<targets> --file=nx-task-graph-build.json
 ```
 
-### Task Graph
 
-Save setup specification:
+### Affected Graph (base=main)
+
+1. Save setup specification:
 
 ```bash
-nx report > ./profiles/nx-show-project/nx-report.md
+mkdir -p ./profiles/nx-affected-graph-main && \
+nx reset && nx report > ./profiles/nx-affected-graph-main/nx-report.md
 ```
 
-Measure the task graph creation:
+2. Measure the affected graph calculation for the specified base:
 
 ```bash
 # Prerequisite (once): install local deps so ./node_modules/.bin/nx exists
 NX_DAEMON=false NX_CACHE=false \
 npx -y @push-based/cpu-prof \
---cpu-prof-dir ./profiles/nx-show-project \
-node ./node_modules/nx/bin/nx.js show project <project-name> --json
+--cpu-prof-dir ./profiles/nx-affected-graph-main \
+node ./node_modules/nx/bin/nx.js graph --affected --base=main --file=/tmp/nx-affected-graph-main.json
+```
+
+--- 
+
+### Project Graph
+
+1. Save setup specification:
+
+```bash
+mkdir -p ./profiles/nx-show-projects && \
+nx reset && nx report > ./profiles/nx-show-projects/nx-report.md
 ```
 
-| 
+2. Measure the project graph creation:
+
+```bash
+# Prerequisite (once): install local deps so ./node_modules/.bin/nx exists
+NX_DAEMON=false NX_CACHE=false \
+npx -y @push-based/cpu-prof \
+--cpu-prof-dir ./profiles/nx-show-projects \
+node ./node_modules/nx/bin/nx.js show projects --json
+```