diff --git a/openwiki/.last-update.json b/openwiki/.last-update.json
index 1af0858..545ffb5 100644
--- a/openwiki/.last-update.json
+++ b/openwiki/.last-update.json
@@ -1,7 +1,7 @@
 {
-  "updatedAt": "2026-08-08T05:14:38.711Z",
+  "updatedAt": "2026-08-22T05:02:48.949Z",
   "command": "update",
-  "gitHead": "0d29c3191ed9eb02197a92a6e51032faa634434c",
+  "gitHead": "ab598c51719af0ac6658af4720a345ebf6622792",
   "model": "xiaomi/mimo-v2.5-pro",
   "status": "complete",
   "language": "en"
diff --git a/openwiki/architecture/overview.md b/openwiki/architecture/overview.md
index fdfbabb..356a6c1 100644
--- a/openwiki/architecture/overview.md
+++ b/openwiki/architecture/overview.md
@@ -101,6 +101,20 @@ The orchestration layer that coordinates all components. Responsibilities:
 - **Configuration Management**: Delegates to ConfigManager
 - **Lifecycle Management**: Handles startup, shutdown, and cleanup
 
+**Key Methods**:
+- `install(version, force)`: Delegates to Installer
+- `build(mvnParams, skipTests)`: Delegates to Builder
+- `deploy()`: Delegates to Builder.deploy()
+- `run(restheartOptions)`: Delegates to ProcessManager
+- `watchFiles(restheartOptions)`: Delegates to Watcher
+- `kill()`: Delegates to ProcessManager.kill()
+- `status()`: Delegates to ProcessManager.status()
+- `isRunning()`: Delegates to ProcessManager.isRunning()
+- `checkAndKill()`: Delegates to ProcessManager.checkAndKill()
+- `onlyPrintConfig(restheartOptions)`: Checks if options are config-print-only flags (`-t`, `-c`, `-v`)
+- `printConfiguration()`: Logs all current config values
+- `setHttpPort(port)`, `setDebugMode(debug)`, `setBuildSystem(buildSystem)`: Config setters
+
 **Key Design Decisions**:
 - Single responsibility: each component handles one domain
 - Dependency injection: components receive ConfigManager in constructor
@@ -134,34 +148,39 @@ Manages all configuration settings. Responsibilities:
 
 Handles building and deploying RESTHeart plugins. Responsibilities:
 
-- **Build Execution**: Runs Maven or Gradle build commands
+- **Build Execution**: Runs Maven or Gradle build commands (prefers wrapper scripts `mvnw`/`gradlew`)
 - **Artifact Deployment**: Copies built JARs to RESTHeart plugins directory
-- **Build System Resolution**: Determines which build system to use
-- **Error Handling**: Deduplicates and formats build output
+- **Build System Resolution**: Determines which build system to use via `resolveBuildSystem`
+- **Error Handling**: Deduplicates consecutive error output lines
 
 **Key Design Decisions**:
 - Delegates build system specifics to `build-systems/` module
 - Cleans target directory before building
 - Returns to original directory after build (even on failure)
 - Uses silent shell execution with deduplicated error output
+- Build params use Maven conventions (`clean package`); Gradle maps these via `mapBuildParams`
 
 #### Installer (`lib/installer.js`)
 
 Manages RESTHeart installation. Responsibilities:
 
 - **Version Resolution**: Handles "latest", specific versions, and local paths
-- **Download Management**: Downloads RESTHeart from GitHub releases
-- **Local Installation**: Installs from local RESTHeart builds
-- **Version Verification**: Checks existing installations
+- **Download Management**: Downloads RESTHeart from GitHub releases using native Node.js HTTPS
+- **Local Installation**: Installs from local RESTHeart build directories
+- **Version Verification**: Checks existing installations, verifies via `java -jar ... -v`
 
 **Installation Strategies**:
 1. **Remote**: Downloads from GitHub releases (latest or specific version)
-2. **Local**: Copies from local RESTHeart build directory
+2. **Local**: Copies from local RESTHeart build directory (detected by `/` or `\` in the argument)
+
+**Constructor Dependencies**:
+- `ConfigManager`: For directory paths and settings
+- `Builder`: Used for post-install build if needed
 
 **Key Design Decisions**:
-- Checks for Java installation before proceeding
+- Checks for Java installation before proceeding (via `commandExists`)
 - Verifies existing installations to avoid redundant downloads
-- Supports force reinstallation with `--force` flag
+- Supports force reinstallation with `--force` flag (cleans cache directory)
 - Uses native Node.js HTTPS for downloads (no external dependencies)
 
 #### ProcessManager (`lib/process-manager.js`)
@@ -169,16 +188,25 @@ Manages RESTHeart installation. Responsibilities:
 Manages RESTHeart process lifecycle. Responsibilities:
 
 - **Process Execution**: Starts RESTHeart with configured options
-- **Process Termination**: Kills running RESTHeart instances
-- **Port Management**: Checks port availability and finds free ports
+- **Process Termination**: Kills running RESTHeart instances with SIGTERM/SIGKILL fallback
+- **Port Management**: Checks port availability on both IPv4 (`127.0.0.1`) and IPv6 (`::1`)
 - **Status Monitoring**: Checks if RESTHeart is running
+- **Config Detection**: Parses `-o` flag from RESTHeart options to find YAML config for host/port
+
+**Key Methods**:
+- `run(restheartOptions)`: Starts RESTHeart as a background process
+- `kill()`: Uses `lsof` for port-specific detection, falls back to `ps-list`; SIGTERM then SIGKILL after 15s timeout
+- `isRunning()`: Checks both `httpPort` and `httpPort + 1000` (RESTHeart's MongoDB wire protocol port)
+- `status()`: Logs whether RESTHeart is running at the configured port
+- `checkAndKill()`: Conditionally kills if already running
+- `onlyPrintConfig(restheartOptions)`: Returns `true` when options contain `-t`, `-c`, or `-v` (RESTHeart print/config flags)
 
 **Key Design Decisions**:
 - Prefers `lsof` for port-specific process detection
 - Falls back to `ps-list` for process discovery
 - Parses RESTHeart YAML config for host/port settings
-- Captures and manages RHO environment variable
-- Implements graceful shutdown with timeout
+- Captures RHO environment variable at startup (`originalRHO`) to prevent duplication on restart
+- Implements graceful shutdown with SIGTERM, escalating to SIGKILL after 15s timeout
 
 #### Watcher (`lib/watcher.js`)
 
@@ -237,12 +265,23 @@ Shared utility functions. Responsibilities:
 Abstracts build system differences. Responsibilities:
 
 - **Build System Resolution**: Determines Maven vs Gradle based on project files
-- **Command Generation**: Generates appropriate build commands
-- **Output Directory**: Returns correct target directory for each build system
+- **Command Generation**: Generates appropriate build commands, preferring wrapper scripts
+- **Output Directory**: Returns correct target directory for each build system (`target` for Maven, `build` for Gradle)
 
 **Supported Build Systems**:
-- **Maven**: `mvn clean package` with configurable parameters
-- **Gradle**: `gradle build` with wrapper support
+- **Maven** (`maven.js`): Prefers `./mvnw -f pom.xml ...`, falls back to `mvn`; uses `-DskipTests={true|false}`
+- **Gradle** (`gradle.js`): Prefers `./gradlew ...`, falls back to `gradle`; uses `-x test` to skip tests
+
+**Gradle Parameter Mapping** (`mapBuildParams`):
+- `'package'` → `'build'`
+- `'clean package'` → `'clean build'`
+- Other values passed through unchanged
+
+**Auto-Detection Logic** (`resolveBuildSystem` in `index.js`):
+1. Check for explicit `--build-system` option → use that system
+2. Check for `pom.xml` or `mvnw` → Maven
+3. Check for `gradlew`, `build.gradle`, `build.gradle.kts`, `settings.gradle`, `settings.gradle.kts` → Gradle
+4. Default to Maven when neither detected
 
 ## Data Flow
 
@@ -274,12 +313,15 @@ sequenceDiagram
     participant PM as ProcessManager
     participant CH as chokidar
 
-    CLI->>RH: watchFiles(restheartOptions, watchOptions)
-    RH->>W: watchFiles(restheartOptions, watchOptions)
+    CLI->>RH: watch(restheartOptions)
+    RH->>PM: checkAndKill()
+    Note over RH: If --build: build('clean package', true), deploy()
+    RH->>PM: run(restheartOptions)
+    RH->>W: watchFiles(restheartOptions)
     W->>CH: watch(paths, options)
     CH-->>W: change event (filePath)
     W->>W: debounce timeout
-    W->>B: build()
+    W->>B: build('clean package', true)
     B->>B: resolveBuildCommand()
     B->>B: shell.exec(buildCommand)
     B->>B: deploy()
diff --git a/openwiki/architecture/source-map.md b/openwiki/architecture/source-map.md
index 884f9ef..e60c093 100644
--- a/openwiki/architecture/source-map.md
+++ b/openwiki/architecture/source-map.md
@@ -47,6 +47,9 @@ restheart-cli/
 ├── .github/workflows/      # CI/CD configuration
 │   ├── ci.yml              # CI pipeline (test, lint, format)
 │   └── openwiki-update.yml # Scheduled OpenWiki documentation refresh
+├── .github/copilot-instructions.md # Agent instruction context
+├── AGENTS.md               # Repository agent guidance (OpenWiki section)
+├── CLAUDE.md               # Claude Code agent brief
 ├── rh.js                   # Executable entry point
 ├── package.json            # Project configuration
 ├── README.md               # Main documentation
@@ -75,8 +78,16 @@ initCLI()
 The main CLI setup and command routing.
 
 **Key Functions**:
-- `initCLI()`: Sets up yargs, registers commands, handles global options
-- `runCommand()`: Routes commands to appropriate RESTHeartManager methods
+- `initCLI()`: Sets up yargs, registers commands, handles global options, prints welcome banner
+- `runCommand(command, argv, rh)`: (exported) Routes commands to RESTHeartManager methods
+
+**Command Routing** (`runCommand`):
+- `install` → `rh.install(version, force)`
+- `build` → `rh.build('clean package')` + `rh.deploy()` (tests enabled)
+- `run` → `rh.checkAndKill()` → optionally `rh.build('clean package', true)` + `rh.deploy()` → `rh.run(options)`
+- `kill` → `rh.checkAndKill()`
+- `watch` → `rh.checkAndKill()` → optionally build/deploy → `rh.run()` → `rh.watchFiles()`
+- `status` → `rh.status()`
 
 **Command Registration Pattern**:
 ```javascript
@@ -154,15 +165,22 @@ yargs(hideBin(process.argv))
 
 **Key Responsibilities**:
 - Starts RESTHeart process
-- Kills running instances
-- Checks port availability
-- Monitors process status
+- Kills running instances (SIGTERM with SIGKILL fallback after 15s)
+- Checks port availability on both IPv4 and IPv6
+- Monitors process status (checks both httpPort and httpPort+1000)
+- Detects RESTHeart config-print flags (`-t`, `-c`, `-v`) via `onlyPrintConfig`
+
+**Constructor**: Receives `ConfigManager`; captures `originalRHO` environment variable at startup
 
 **Key Methods**:
 - `run(restheartOptions)`: Starts RESTHeart
 - `kill()`: Terminates RESTHeart processes
-- `isRunning()`: Checks if RESTHeart is active
-- `checkPortAvailability(port)`: Verifies port is free
+- `isRunning()`: Checks if RESTHeart is active (ports httpPort and httpPort+1000)
+- `status()`: Logs running status
+- `checkAndKill()`: Conditionally kills if already running
+- `onlyPrintConfig(restheartOptions)`: Checks for config-print flags
+- `parseConfigPath(restheartOptions)`: Extracts `-o` config file path
+- `getHostAndPortFromConfig(configPath)`: Parses RESTHeart YAML config for host/port
 
 **When to modify**: When changing process lifecycle, adding health checks, or modifying port management.
 
@@ -193,6 +211,8 @@ yargs(hideBin(process.argv))
 
 **Class**: `RESTHeartManager`
 
+**Constructor**: `(httpPort, debugMode)` - creates ConfigManager, then Builder, ProcessManager, Installer, Watcher
+
 **Key Responsibilities**:
 - Coordinates all components
 - Provides public API for CLI commands
@@ -201,15 +221,33 @@ yargs(hideBin(process.argv))
 **Key Methods**:
 - `install(version, force)`: Delegates to Installer
 - `build(mvnParams, skipTests)`: Delegates to Builder
+- `deploy()`: Delegates to Builder.deploy()
 - `run(restheartOptions)`: Delegates to ProcessManager
-- `watchFiles(restheartOptions, watchOptions)`: Delegates to Watcher
-- `kill()`: Delegates to ProcessManager
-- `status()`: Delegates to ProcessManager
+- `watchFiles(restheartOptions)`: Delegates to Watcher
+- `kill()`: Delegates to ProcessManager.kill()
+- `status()`: Delegates to ProcessManager.status()
+- `isRunning()`: Delegates to ProcessManager.isRunning()
+- `checkAndKill()`: Delegates to ProcessManager.checkAndKill()
+- `onlyPrintConfig(restheartOptions)`: Checks for config-print flags
+- `printConfiguration()`: Logs all config values
+- `setHttpPort(port)`, `setDebugMode(debug)`, `setBuildSystem(buildSystem)`: Config setters
 
 **When to modify**: When adding new top-level features or changing component coordination.
 
 ## Infrastructure Components
 
+### CLI Help: `lib/help.js`
+
+**Exported**: `getVersion`, `commandDescriptions`, `addCommandExamples`
+
+**Key Responsibilities**:
+- Reads version from `package.json` via `getVersion()`
+- Provides command descriptions and usage examples for all CLI commands
+- `commandDescriptions`: Object with keys for each command (`install`, `build`, `run`, `kill`, `watch`, `status`)
+- `addCommandExamples(yargs, commandName)`: Attaches examples to yargs command definitions
+
+**When to modify**: When adding new commands, updating help text, or changing examples.
+
 ### Logging: `lib/logger.js`
 
 **Exported**: `logger`, `LogLevel`
@@ -237,10 +275,10 @@ yargs(hideBin(process.argv))
 ### Utilities: `lib/utils.js`
 
 **Key Functions**:
-- `checkPort(port)`: Checks port availability
-- `commandExists(command)`: Verifies system command exists
+- `checkPort(port)`: Checks port availability on IPv4 (`127.0.0.1`) and IPv6 (`::1`) via TCP connection
+- `commandExists(command)`: Verifies system command exists; exits process if not found
 - `ensureDir(dir)`: Creates directory recursively
-- `createSpinner(text)`: Creates progress spinner
+- `createSpinner(text)`: Creates progress spinner (via `ora`)
 
 **When to modify**: When adding new utility functions or changing existing behavior.
 
@@ -256,8 +294,19 @@ build-systems/
 
 **Resolution Logic** (`index.js`):
 1. Check for explicit `--build-system` option
-2. Auto-detect based on project files
-3. Default to Maven if no detection
+2. Auto-detect: `pom.xml` or `mvnw` → Maven; `gradlew`, `build.gradle`, `build.gradle.kts`, `settings.gradle`, `settings.gradle.kts` → Gradle
+3. Default to Maven if neither detected
+
+**MavenBuildSystem** (`maven.js`):
+- Prefers `./mvnw -f pom.xml` wrapper, falls back to `mvn`
+- Uses `-DskipTests={true|false}` for test control
+- Output directory: `target`
+
+**GradleBuildSystem** (`gradle.js`):
+- Prefers `./gradlew` wrapper, falls back to `gradle`
+- Uses `-x test` to skip tests
+- Maps Maven-style params: `'package'` → `'build'`, `'clean package'` → `'clean build'`
+- Output directory: `build`
 
 **When to modify**: When adding new build systems or changing detection logic.
 
@@ -340,6 +389,12 @@ npx vitest run --coverage
 
 **When to modify**: When changing the documentation update schedule or OpenWiki configuration.
 
+### `.github/copilot-instructions.md`
+
+Context file for AI coding assistants. Contains repository conventions and patterns.
+
+**When to modify**: When updating agent guidance for the repository.
+
 ## Key Code Patterns
 
 ### Command Registration Pattern
diff --git a/openwiki/domain/concepts.md b/openwiki/domain/concepts.md
index 190b95e..b5fc028 100644
--- a/openwiki/domain/concepts.md
+++ b/openwiki/domain/concepts.md
@@ -78,6 +78,7 @@ my-restheart-plugin/
 - **Dependencies**: Managed in `pom.xml`
 - **Plugins**: Extend build functionality
 - **Repositories**: Download dependencies from Maven Central
+- **Wrapper**: `mvnw` for consistent builds (preferred over bare `mvn`)
 
 **RESTHeart CLI Usage**:
 ```bash
@@ -85,8 +86,8 @@ my-restheart-plugin/
 rh build --build-system maven
 
 # Maven commands executed:
-# mvn clean package (default)
-# mvn clean package -DskipTests (skip tests)
+# ./mvnw -f pom.xml clean package (default, prefers wrapper)
+# ./mvnw -f pom.xml clean package -DskipTests=true (skip tests)
 ```
 
 **Maven Files**:
@@ -103,7 +104,7 @@ rh build --build-system maven
 - **Tasks**: Units of work (build, test, deploy)
 - **Plugins**: Extend build functionality
 - **Dependencies**: Managed in build script
-- **Wrapper**: `gradlew` for consistent builds
+- **Wrapper**: `gradlew` for consistent builds (preferred over bare `gradle`)
 
 **RESTHeart CLI Usage**:
 ```bash
@@ -111,8 +112,12 @@ rh build --build-system maven
 rh build --build-system gradle
 
 # Gradle commands executed:
-# gradle clean build (default)
-# gradle clean build -x test (skip tests)
+# ./gradlew clean build (default, prefers wrapper)
+# ./gradlew clean build -x test (skip tests)
+
+# Note: Maven-style params are mapped:
+# 'package' → 'build'
+# 'clean package' → 'clean build'
 ```
 
 **Gradle Files**:
@@ -124,8 +129,8 @@ rh build --build-system gradle
 ### Build System Auto-Detection
 
 **Detection Logic**:
-1. Check for `pom.xml` → Use Maven
-2. Check for `build.gradle` or `build.gradle.kts` → Use Gradle
+1. Check for `pom.xml` or `mvnw` → Use Maven
+2. Check for `gradlew`, `build.gradle`, `build.gradle.kts`, `settings.gradle`, `settings.gradle.kts` → Use Gradle
 3. Default to Maven if no detection
 
 **Priority**: Maven takes precedence over Gradle when both exist
@@ -174,14 +179,16 @@ rh status --port 9090
 ### Process Detection
 
 **Detection Methods**:
-1. **lsof**: Check processes bound to specific port
-2. **ps-list**: List all processes and filter by name
+1. **lsof**: Check processes bound to specific port (preferred for port-specific kill)
+2. **ps-list**: List all processes and filter by name (fallback)
 
 **Process Identification**:
 - Process name: `java`
 - Command line contains: `restheart`
 - Port binding matches configured port
 
+**Running Check**: RESTHeart is considered running if either the HTTP port (`httpPort`) or the MongoDB wire protocol port (`httpPort + 1000`) has an active listener. The `checkPort` utility probes both `127.0.0.1` and `::1` for each port.
+
 ## Configuration
 
 ### Configuration Hierarchy
@@ -274,6 +281,10 @@ RHO='/mclient/connection-string->"mongodb://host:port" /http-listener/port->9090
 
 **Default Debounce Time**: 1000ms (1 second)
 
+**Write Stability**: The watcher also uses `awaitWriteFinish` with `stabilityThreshold: 1000ms` and `pollInterval: 200ms` to ensure files are fully written before triggering a rebuild.
+
+**Concurrency Guard**: An `isProcessing` flag prevents overlapping rebuilds. If a file change arrives while a build/restart is in progress, it is skipped.
+
 **Purpose**:
 - Prevents multiple rebuilds during rapid file saves
 - Reduces system load
@@ -317,6 +328,10 @@ rh watch --debounce-time 2000  # 2 seconds
 
 **Priority**: Environment variable > File > Command line
 
+### Config-Print Flags
+
+When RESTHeart options contain `-t`, `-c`, or `-v`, the CLI detects this via `onlyPrintConfig()` and skips the `checkAndKill`/`run` sequence, instead passing the options directly to `java -jar restheart.jar`. This allows using `rh run -- -v` to print RESTHeart version info without starting the server.
+
 ## Plugin Development Concepts
 
 ### Plugin Interface
diff --git a/openwiki/operations/runbook.md b/openwiki/operations/runbook.md
index d66b2fc..dc6e93c 100644
--- a/openwiki/operations/runbook.md
+++ b/openwiki/operations/runbook.md
@@ -457,8 +457,8 @@ rh --debug watch
 
 **Slow builds**:
 ```bash
-# Skip tests
-rh build --skip-tests
+# Skip tests with run --build (uses skipTests=true internally)
+rh run --build
 
 # Use faster build system
 rh build --build-system gradle
diff --git a/openwiki/quickstart.md b/openwiki/quickstart.md
index 1fcf097..c60bb63 100644
--- a/openwiki/quickstart.md
+++ b/openwiki/quickstart.md
@@ -82,14 +82,14 @@ rh watch
 
 ## Essential Commands
 
-| Command | Description |
-|---------|-------------|
-| `rh install [version\|path]` | Install or update RESTHeart |
-| `rh build` | Build and deploy plugins |
-| `rh run [options]` | Start RESTHeart |
-| `rh watch [options]` | Watch for changes and auto-rebuild |
-| `rh kill` | Stop running RESTHeart instances |
-| `rh status` | Check if RESTHeart is running |
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `rh install [version\|path]` | `rh i` | Install or update RESTHeart |
+| `rh build` | `rh b` | Build and deploy plugins |
+| `rh run [options]` | `rh r` | Start RESTHeart |
+| `rh watch [options]` | `rh w` | Watch for changes and auto-rebuild |
+| `rh kill` | `rh k` | Stop running RESTHeart instances |
+| `rh status` | `rh s` | Check if RESTHeart is running |
 
 ## Common Options
 
@@ -98,6 +98,7 @@ rh watch
 - `--debug` - Enable debug mode
 - `--verbose` - Show verbose output
 - `--quiet` - Suppress non-error output
+- `--timestamps` - Add timestamps to log messages
 
 ## Documentation Structure
 
@@ -120,7 +121,7 @@ This documentation is organized into focused sections:
 ### Build System Selection
 
 ```bash
-# Auto-detect (default)
+# Auto-detect (default) — runs tests
 rh build
 
 # Force Maven
@@ -128,6 +129,9 @@ rh build --build-system maven
 
 # Force Gradle
 rh build --build-system gradle
+
+# Note: rh run --build and rh watch --build automatically skip tests
+# for faster iteration during development
 ```
 
 ### Development with MongoDB
@@ -172,11 +176,11 @@ Use this table to find the right starting point for common change types.
 
 | Change Area | Wiki Page | Source Entry Points | Key Symbols / Types | Focused Tests | Validation Command |
 |---|---|---|---|---|---|
-| Add or modify a CLI command | [Architecture](architecture/overview.md), [Source Map](architecture/source-map.md) | `lib/cli.js`, `lib/restheart.js` | `initCLI`, `runCommand`, `RESTHeartManager` | `test/cli.test.js` | `npx vitest run test/cli.test.js` |
+| Add or modify a CLI command | [Architecture](architecture/overview.md), [Source Map](architecture/source-map.md) | `lib/cli.js`, `lib/restheart.js`, `lib/help.js` | `initCLI`, `runCommand`, `RESTHeartManager`, `commandDescriptions` | `test/cli.test.js` | `npx vitest run test/cli.test.js` |
 | Change build/deploy behavior | [Architecture](architecture/overview.md), [Source Map](architecture/source-map.md) | `lib/builder.js`, `lib/build-systems/index.js` | `Builder`, `resolveBuildSystem` | `test/builder.test.js`, `test/build-system-resolver.test.js` | `npx vitest run test/builder.test.js` |
-| Add a new build system | [Architecture](architecture/overview.md) | `lib/build-systems/` | `MavenBuildSystem`, `GradleBuildSystem` | `test/build-system-resolver.test.js` | `npx vitest run test/build-system-resolver.test.js` |
+| Add a new build system | [Architecture](architecture/overview.md), [Source Map](architecture/source-map.md) | `lib/build-systems/` | `MavenBuildSystem`, `GradleBuildSystem`, `resolveBuildSystem` | `test/build-system-resolver.test.js` | `npx vitest run test/build-system-resolver.test.js` |
 | Modify installer logic | [Source Map](architecture/source-map.md) | `lib/installer.js` | `Installer` | (no dedicated test) | `npm test` |
-| Change process/port management | [Operations Runbook](operations/runbook.md), [Source Map](architecture/source-map.md) | `lib/process-manager.js` | `ProcessManager` | `test/process-manager.test.js` | `npx vitest run test/process-manager.test.js` |
+| Change process/port management | [Operations Runbook](operations/runbook.md), [Source Map](architecture/source-map.md) | `lib/process-manager.js` | `ProcessManager`, `isRestheartProcess` | `test/process-manager.test.js` | `npx vitest run test/process-manager.test.js` |
 | Modify file watcher behavior | [Development Workflows](workflows/development-workflow.md), [Source Map](architecture/source-map.md) | `lib/watcher.js` | `Watcher` | `test/watcher.test.js` | `npx vitest run test/watcher.test.js` |
 | Update configuration defaults | [Domain Concepts](domain/concepts.md), [Source Map](architecture/source-map.md) | `lib/config.js` | `ConfigManager` | `test/config.test.js` | `npx vitest run test/config.test.js` |
 | Change logging or error handling | [Architecture](architecture/overview.md) | `lib/logger.js`, `lib/error-handler.js` | `Logger`, `ErrorHandler` | `test/logger.test.js`, `test/error-handler.test.js` | `npx vitest run test/logger.test.js test/error-handler.test.js` |
diff --git a/openwiki/testing/guidance.md b/openwiki/testing/guidance.md
index a1a8584..980bc1b 100644
--- a/openwiki/testing/guidance.md
+++ b/openwiki/testing/guidance.md
@@ -216,6 +216,11 @@ function createRh() {
         kill: vi.fn().mockResolvedValue(undefined),
         watchFiles: vi.fn(),
         status: vi.fn().mockResolvedValue(undefined),
+        checkAndKill: vi.fn().mockResolvedValue(undefined),
+        onlyPrintConfig: vi.fn().mockReturnValue(false),
+        setHttpPort: vi.fn(),
+        setBuildSystem: vi.fn(),
+        printConfiguration: vi.fn(),
     }
 }
 
diff --git a/openwiki/workflows/development-workflow.md b/openwiki/workflows/development-workflow.md
index 1c44d15..3846c28 100644
--- a/openwiki/workflows/development-workflow.md
+++ b/openwiki/workflows/development-workflow.md
@@ -103,8 +103,8 @@ RESTHeart CLI supports Maven and Gradle projects with automatic detection.
 rh build
 
 # Detection logic:
-# 1. Check for pom.xml → Use Maven
-# 2. Check for build.gradle → Use Gradle
+# 1. Check for pom.xml or mvnw → Use Maven
+# 2. Check for gradlew, build.gradle, build.gradle.kts, settings.gradle, settings.gradle.kts → Use Gradle
 # 3. Default to Maven
 ```
 
@@ -335,17 +335,20 @@ rh build
 # Build with tests (default)
 rh build
 
-# Skip tests
-rh build --skip-tests
+# Skip tests by using run/watch with --build flag
+rh run --build   # internally passes skipTests=true
+rh watch --build # internally passes skipTests=true
 ```
 
 #### Build with Parameters
 
 ```bash
-# Maven-specific parameters
-rh build --mvn-params "-DskipTests -Pproduction"
+# Maven build system uses: mvn -f pom.xml clean package -DskipTests=false
+# Gradle build system maps: clean package → clean build
 
-# Note: --mvn-params is for advanced Maven usage
+# Force specific build system
+rh build --build-system maven
+rh build --build-system gradle
 ```
 
 ### 9. Installation Scenarios