Add OAF_PIDFILE environment variable override for ow.server.checkIn

[Copilot]

Adds ability to override the PID file path in ow.server.checkIn() via the OAF_PIDFILE environment variable.

Changes

• js/owrap.server.js: Modified checkIn() to check OAF_PIDFILE environment variable with precedence: env var > parameter > default. Handles whitespace-only values via .trim().

• docs/openaf-flags.md: Added OAF_PIDFILE entry under new "Server Management" section.

• docs/openaf.md: Updated example with environment variable note.

• tests/autoTestAll.Server.js: Added testCheckIn() covering default behavior, explicit parameters, and environment variable override scenarios (when set).

Usage

// Before: PID file path hardcoded or passed as parameter
ow.server.checkIn("server.pid", onAlreadyRunning, onShutdown);

// After: Can be controlled via environment variable
// OAF_PIDFILE=/var/run/myapp.pid openaf myapp.js
ow.server.checkIn("server.pid", onAlreadyRunning, onShutdown);
// Uses /var/run/myapp.pid instead of server.pid

Precedence: OAF_PIDFILE > function parameter > "server.pid" (default)

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.