docs: fix documentation inaccuracies

Fixed 6 documentation issues identified in accuracy audit:

Critical:
- Fixed detectPackageManager() signature (now sync, no params, returns 'npm' | 'pnpm' | 'yarn' | 'bun' | null)
- Removed non-existent constants: LINUX, MIN_SUPPORTED_NODE_VERSION, MAIN_REGISTRY_URL

High:
- Removed non-existent env functions: getUserProfile(), getColorTerm()

Low:
- Added missing safeStats import in examples.md

All examples updated to use correct APIs and patterns.

Author: jdalton

docs/constants.md

@@ -12,64 +12,31 @@ Pre-defined constant values for Node.js versions, npm registry URLs, platform de
 ## Quick Start
 
 ```typescript
-import { MIN_SUPPORTED_NODE_VERSION } from '@socketsecurity/lib/constants/node'
-import { MAIN_REGISTRY_URL } from '@socketsecurity/lib/constants/npm'
+import { WIN32, DARWIN } from '@socketsecurity/lib/constants/platform'
 
-if (process.version < `v${MIN_SUPPORTED_NODE_VERSION}`) {
-  console.error(`Node.js ${MIN_SUPPORTED_NODE_VERSION}+ required`)
-  process.exit(1)
+if (WIN32) {
+  console.log('Running on Windows')
+} else if (DARWIN) {
+  console.log('Running on macOS')
+} else {
+  console.log('Running on Linux or other Unix-like OS')
 }
-
-console.log(`Registry: ${MAIN_REGISTRY_URL}`)
 ```
 
 ## Node.js Constants
 
-### MIN_SUPPORTED_NODE_VERSION
-
-Minimum supported Node.js version for Socket.dev tools.
-
-```typescript
-import { MIN_SUPPORTED_NODE_VERSION } from '@socketsecurity/lib/constants/node'
-
-console.log(MIN_SUPPORTED_NODE_VERSION) // "22.0.0"
-```
-
-### Version Checking
-
-```typescript
-import { MIN_SUPPORTED_NODE_VERSION } from '@socketsecurity/lib/constants/node'
-
-const currentVersion = process.version.slice(1) // Remove 'v' prefix
-
-if (currentVersion < MIN_SUPPORTED_NODE_VERSION) {
-  throw new Error(
-    `Node.js ${MIN_SUPPORTED_NODE_VERSION}+ required. Current: ${currentVersion}`
-  )
-}
-```
+See `@socketsecurity/lib/constants/node` for Node.js-related constants.
 
 ## npm Registry Constants
 
-### MAIN_REGISTRY_URL
-
-The main npm registry URL.
+For building npm registry URLs, use string literals directly:
 
 ```typescript
-import { MAIN_REGISTRY_URL } from '@socketsecurity/lib/constants/npm'
-
-console.log(MAIN_REGISTRY_URL) // "https://registry.npmjs.org"
-```
-
-### Building Registry URLs
-
-```typescript
-import { MAIN_REGISTRY_URL } from '@socketsecurity/lib/constants/npm'
 import { httpJson } from '@socketsecurity/lib/http-request'
 
-// Get package metadata
+// Get package metadata from npm registry
 const packageName = 'lodash'
-const url = `${MAIN_REGISTRY_URL}/${packageName}`
+const url = `https://registry.npmjs.org/${packageName}`
 const metadata = await httpJson(url)
 
 console.log(metadata.name, metadata['dist-tags'].latest)
@@ -78,10 +45,8 @@ console.log(metadata.name, metadata['dist-tags'].latest)
 ### Package Tarball URLs
 
 ```typescript
-import { MAIN_REGISTRY_URL } from '@socketsecurity/lib/constants/npm'
-
 function getTarballUrl(name: string, version: string): string {
-  return `${MAIN_REGISTRY_URL}/${name}/-/${name}-${version}.tgz`
+  return `https://registry.npmjs.org/${name}/-/${name}-${version}.tgz`
 }
 
 const url = getTarballUrl('lodash', '4.17.21')
@@ -116,28 +81,29 @@ if (DARWIN) {
 }
 ```
 
-### LINUX
+### Detecting Linux
 
-Checks if platform is Linux.
+There is no `LINUX` constant. To detect Linux or other Unix-like systems, check if the platform is neither Windows nor macOS:
 
 ```typescript
-import { LINUX } from '@socketsecurity/lib/constants/platform'
+import { WIN32, DARWIN } from '@socketsecurity/lib/constants/platform'
 
-if (LINUX) {
-  console.log('Running on Linux')
+const isLinux = !WIN32 && !DARWIN
+if (isLinux) {
+  console.log('Running on Linux or other Unix-like OS')
   // Use Linux-specific logic
 }
 ```
 
 ### Platform-Specific Logic Example
 
 ```typescript
-import { WIN32, DARWIN, LINUX } from '@socketsecurity/lib/constants/platform'
-import { getHome, getUserProfile } from '@socketsecurity/lib/env'
+import { WIN32, DARWIN } from '@socketsecurity/lib/constants/platform'
+import { getHome } from '@socketsecurity/lib/env/home'
 import path from 'node:path'
 
 function getConfigDir(): string {
-  const home = getHome() || getUserProfile()
+  const home = getHome()
   if (!home) {
     throw new Error('Cannot determine home directory')
   }
@@ -146,7 +112,8 @@ function getConfigDir(): string {
     return path.join(home, 'AppData', 'Local', 'MyApp')
   } else if (DARWIN) {
     return path.join(home, 'Library', 'Application Support', 'MyApp')
-  } else if (LINUX) {
+  } else {
+    // Linux or other Unix-like OS
     return path.join(home, '.config', 'myapp')
   }
 
@@ -211,10 +178,11 @@ checkNodeVersion()
 ### npm Package Downloader
 
 ```typescript
-import { MAIN_REGISTRY_URL } from '@socketsecurity/lib/constants/npm'
 import { httpJson, httpDownload } from '@socketsecurity/lib/http-request'
 import { Spinner } from '@socketsecurity/lib/spinner'
 
+const NPM_REGISTRY = 'https://registry.npmjs.org'
+
 interface PackageMetadata {
   'dist-tags': { latest: string }
   versions: Record<string, {
@@ -232,7 +200,7 @@ async function downloadPackage(
   // Get package metadata
   spinner.start('Fetching package metadata...')
   const metadata = await httpJson<PackageMetadata>(
-    `${MAIN_REGISTRY_URL}/${name}`
+    `${NPM_REGISTRY}/${name}`
   )
   spinner.success('Metadata fetched')
 
@@ -267,7 +235,7 @@ await downloadPackage('lodash', 'latest', '/tmp')
 ### Cross-Platform Path Builder
 
 ```typescript
-import { WIN32, DARWIN, LINUX } from '@socketsecurity/lib/constants/platform'
+import { WIN32, DARWIN } from '@socketsecurity/lib/constants/platform'
 import path from 'node:path'
 
 class PathBuilder {
@@ -321,10 +289,8 @@ console.log(configPath)
 ### Registry URL Builder
 
 ```typescript
-import { MAIN_REGISTRY_URL } from '@socketsecurity/lib/constants/npm'
-
 class RegistryClient {
-  constructor(private baseUrl: string = MAIN_REGISTRY_URL) {}
+  constructor(private baseUrl: string = 'https://registry.npmjs.org') {}
 
   packageUrl(name: string): string {
     return `${this.baseUrl}/${name}`
@@ -386,16 +352,10 @@ await Promise.all([
 
 ## Available Constants
 
-### Node.js
-- `MIN_SUPPORTED_NODE_VERSION` - Minimum Node.js version ("22.0.0")
-
-### npm Registry
-- `MAIN_REGISTRY_URL` - Main npm registry ("https://registry.npmjs.org")
-
 ### Platform
 - `WIN32` - Boolean, true on Windows
 - `DARWIN` - Boolean, true on macOS
-- `LINUX` - Boolean, true on Linux
+- For Linux detection, use `!WIN32 && !DARWIN`
 
 ### Process
 - `getAbortSignal()` - Function returning global AbortSignal
@@ -435,5 +395,5 @@ if (!semver.gte(process.version, MIN_SUPPORTED_NODE_VERSION)) {
 **Solution:**
 Use environment variable or config:
 ```typescript
-const registryUrl = process.env.NPM_REGISTRY || MAIN_REGISTRY_URL
+const registryUrl = process.env.NPM_REGISTRY || 'https://registry.npmjs.org'
 ```

docs/environment.md

@@ -111,33 +111,7 @@ if (home) {
 
 **Environment Variable:** `HOME` (Unix/Linux/macOS)
 
-### getUserProfile()
-
-**What it does:** Gets the Windows user profile path.
-
-**Returns:** `string | undefined`
-
-**Example:**
-```typescript
-import { getUserProfile } from '@socketsecurity/lib/env/userprofile'
-
-const profile = getUserProfile()
-if (profile) {
-  const configPath = `${profile}\\.myapp\\config.json`
-}
-```
-
-**Environment Variable:** `USERPROFILE` (Windows)
-
-### Cross-Platform Home Directory
-
-```typescript
-import { getHome } from '@socketsecurity/lib/env/home'
-import { getUserProfile } from '@socketsecurity/lib/env/userprofile'
-
-// Compose getters for cross-platform fallback
-const homeDir = getHome() || getUserProfile()
-```
+**Cross-platform note:** For Windows, use `process.env.USERPROFILE` if needed
 
 ### getTerm()
 
@@ -157,23 +131,7 @@ if (term === 'dumb') {
 
 **Environment Variable:** `TERM`
 
-### getColorTerm()
-
-**What it does:** Checks if terminal supports color.
-
-**Returns:** `string | undefined`
-
-**Example:**
-```typescript
-import { getColorTerm } from '@socketsecurity/lib/env/colorterm'
-
-if (getColorTerm()) {
-  // Terminal supports color
-  enableColorOutput()
-}
-```
-
-**Environment Variable:** `COLORTERM`
+**Color support note:** For checking terminal color support, use `process.env.COLORTERM` directly or libraries like `supports-color`
 
 ## Testing with Rewiring
 
@@ -243,11 +201,11 @@ const config = {
 
 ```typescript
 import { getHome } from '@socketsecurity/lib/env/home'
-import { getUserProfile } from '@socketsecurity/lib/env/userprofile'
+import { WIN32 } from '@socketsecurity/lib/constants/platform'
 import path from 'node:path'
 
 function getConfigDir() {
-  const home = getHome() || getUserProfile()
+  const home = getHome() || (WIN32 ? process.env.USERPROFILE : undefined)
   if (!home) {
     throw new Error('Cannot determine home directory')
   }
@@ -259,11 +217,12 @@ function getConfigDir() {
 ### Terminal Capability Detection
 
 ```typescript
-import { getTerm, getColorTerm } from '@socketsecurity/lib/env/term'
+import { getTerm } from '@socketsecurity/lib/env/term'
 
 function supportsColor() {
   const term = getTerm()
-  return term !== 'dumb' && getColorTerm() !== undefined
+  const colorTerm = process.env.COLORTERM
+  return term !== 'dumb' && colorTerm !== undefined
 }
 
 function getLogger() {
@@ -288,11 +247,9 @@ All getters follow the pattern `get<VarName>()` and return `string | boolean | u
 
 - **User Directories:**
   - `getHome()` - Returns `HOME` (Unix/Linux/macOS)
-  - `getUserProfile()` - Returns `USERPROFILE` (Windows)
 
 - **Terminal:**
   - `getTerm()` - Returns `TERM`
-  - `getColorTerm()` - Returns `COLORTERM`
 
 - **Path:**
   - `getPath()` - Returns `PATH`
@@ -322,9 +279,10 @@ All getters follow the pattern `get<VarName>()` and return `string | boolean | u
 **Problem:** Path doesn't work on Windows/Unix.
 
 **Solution:**
-Use the fallback pattern:
+Use the fallback pattern with `process.env` for Windows:
 ```typescript
-const home = getHome() || getUserProfile()
+import { WIN32 } from '@socketsecurity/lib/constants/platform'
+const home = getHome() || (WIN32 ? process.env.USERPROFILE : undefined)
 ```
 
 And use `path.join()` for cross-platform path construction:

docs/examples.md

@@ -10,7 +10,7 @@ A complete CLI tool that downloads a file, processes it, and provides visual fee
 import { Spinner } from '@socketsecurity/lib/spinner'
 import { getDefaultLogger } from '@socketsecurity/lib/logger'
 import { httpDownload } from '@socketsecurity/lib/http-request'
-import { readFileBinary, safeDelete, safeMkdir } from '@socketsecurity/lib/fs'
+import { readFileBinary, safeDelete, safeMkdir, safeStats } from '@socketsecurity/lib/fs'
 import { spawn } from '@socketsecurity/lib/spawn'
 
 const logger = getDefaultLogger()