WP Navigator MCP

import * as fs from 'fs'; import * as path from 'path'; import * as dotenv from 'dotenv'; export type WPConfig = { baseUrl: string; restApi: string; wpnavBase: string; wpnavIntrospect: string; auth: { username: string; password: string; signHeaders?: boolean; // WPNAV_SIGN_HEADERS (default false) - v1.2.0 actor attribution hmacSecret?: string; // WPNAV_HMAC_SECRET (optional) - v1.2.0 actor attribution }; toggles: { enableWrites: boolean; // WPNAV_ENABLE_WRITES (default true - plugin guardrails handle safety) allowInsecureHttp: boolean; // ALLOW_INSECURE_HTTP (default false) toolTimeoutMs: number; // WPNAV_TOOL_TIMEOUT_MS (default 600000) maxResponseKb: number; // WPNAV_MAX_RESPONSE_KB (default 64) caBundlePath?: string; // WPNAV_CA_BUNDLE (optional) }; featureFlags: { // v1.3.0 AI Tools feature flags workflowsEnabled: boolean; // WPNAV_FLAG_WORKFLOWS_ENABLED (default false) bulkValidatorEnabled: boolean; // WPNAV_FLAG_WP_BULK_VALIDATOR_ENABLED (default false) seoAuditEnabled: boolean; // WPNAV_FLAG_WP_SEO_AUDIT_ENABLED (default false) contentReviewerEnabled: boolean; // WPNAV_FLAG_WP_CONTENT_REVIEWER_ENABLED (default false) migrationPlannerEnabled: boolean; // WPNAV_FLAG_WP_MIGRATION_PLANNER_ENABLED (default false) performanceAnalyzerEnabled: boolean; // WPNAV_FLAG_WP_PERFORMANCE_ANALYZER_ENABLED (default false) }; }; /** * Legacy environment variable names (v1.x) * New v2.4.0+ names: WPNAV_SITE_URL, WPNAV_USERNAME, WPNAV_APP_PASSWORD */ export const REQUIRED_ENV_VARS = [ 'WP_BASE_URL', 'WP_REST_API', 'WPNAV_BASE', 'WPNAV_INTROSPECT', 'WP_APP_USER', 'WP_APP_PASS', ] as const; /** * New environment variable names (v2.4.0+) * Maps new names to legacy names for compatibility */ export const NEW_ENV_VAR_MAPPING = { WPNAV_SITE_URL: 'WP_BASE_URL', WPNAV_USERNAME: 'WP_APP_USER', WPNAV_APP_PASSWORD: 'WP_APP_PASS', } as const; /** * Get env var value with new name taking precedence over legacy */ function getEnvWithFallback(newName: string, legacyName: string): string | undefined { return process.env[newName] || process.env[legacyName]; } /** * Load configuration from a JSON file (argv[2]) or from ../../.local-wp.env. * Mirrors the existing behavior and log lines for continuity. */ export function loadEnvFromArgOrDotEnv(argvPath?: string) { const configPath = argvPath ?? process.argv[2]; if (configPath && fs.existsSync(configPath)) { try { const configData = JSON.parse(fs.readFileSync(configPath, 'utf8')) as Record<string, string>; Object.entries(configData).forEach(([key, value]) => { process.env[key] = String(value); }); console.error(`✓ Loaded configuration from: ${configPath}`); return; } catch (e) { console.error(`❌ Failed to parse config file: ${configPath}`); console.error(String(e)); } } // Try .local-wp.env (for local development) const envPath = path.resolve(process.cwd(), '../../.local-wp.env'); if (fs.existsSync(envPath)) { dotenv.config({ path: envPath }); console.error(`✓ Loaded environment from: ${envPath}`); } else { console.error(`⚠ Warning: No config file found`); console.error(' Using environment variables from shell'); } } /** * Validate required env vars and produce a typed configuration object. * Exits the process with code 1 if required env vars are missing (matches prior behavior). * * v2.4.0: Supports new env var names (WPNAV_SITE_URL, WPNAV_USERNAME, WPNAV_APP_PASSWORD) * with fallback to legacy names (WP_BASE_URL, WP_APP_USER, WP_APP_PASS). */ export function getConfigOrExit(): WPConfig { // Get values with new names taking precedence over legacy const baseUrl = getEnvWithFallback('WPNAV_SITE_URL', 'WP_BASE_URL'); const restApi = process.env.WP_REST_API; const wpnavBase = process.env.WPNAV_BASE; const wpnavIntrospect = process.env.WPNAV_INTROSPECT; const username = getEnvWithFallback('WPNAV_USERNAME', 'WP_APP_USER'); const password = getEnvWithFallback('WPNAV_APP_PASSWORD', 'WP_APP_PASS'); // Check for missing required values const missing: string[] = []; if (!baseUrl) missing.push('WPNAV_SITE_URL (or WP_BASE_URL)'); if (!restApi) missing.push('WP_REST_API'); if (!wpnavBase) missing.push('WPNAV_BASE'); if (!wpnavIntrospect) missing.push('WPNAV_INTROSPECT'); if (!username) missing.push('WPNAV_USERNAME (or WP_APP_USER)'); if (!password) missing.push('WPNAV_APP_PASSWORD (or WP_APP_PASS)'); if (missing.length > 0) { console.error(`❌ Missing required environment variables: ${missing.join(', ')}`); console.error(' Please check your configuration file or .local-wp.env'); process.exit(1); } const signHeaders = readBool(process.env.WPNAV_SIGN_HEADERS, false); const hmacSecret = process.env.WPNAV_HMAC_SECRET || ''; // Validate: if signing is enabled, secret is required if (signHeaders && !hmacSecret) { console.error('❌ WPNAV_SIGN_HEADERS=1 requires WPNAV_HMAC_SECRET to be set'); console.error(' Please configure a shared secret in .local-wp.env or config file'); process.exit(1); } return { baseUrl: baseUrl!, restApi: restApi!, wpnavBase: wpnavBase!, wpnavIntrospect: wpnavIntrospect!, auth: { username: username!, password: password!, signHeaders, hmacSecret: signHeaders ? hmacSecret : undefined, }, toggles: { enableWrites: readBool(process.env.WPNAV_ENABLE_WRITES, true), allowInsecureHttp: readBool(process.env.ALLOW_INSECURE_HTTP, false), toolTimeoutMs: readInt(process.env.WPNAV_TOOL_TIMEOUT_MS, 600000), maxResponseKb: readInt(process.env.WPNAV_MAX_RESPONSE_KB, 64), caBundlePath: process.env.WPNAV_CA_BUNDLE || undefined, }, featureFlags: { workflowsEnabled: readBool(process.env.WPNAV_FLAG_WORKFLOWS_ENABLED, false), bulkValidatorEnabled: readBool(process.env.WPNAV_FLAG_WP_BULK_VALIDATOR_ENABLED, false), seoAuditEnabled: readBool(process.env.WPNAV_FLAG_WP_SEO_AUDIT_ENABLED, false), contentReviewerEnabled: readBool(process.env.WPNAV_FLAG_WP_CONTENT_REVIEWER_ENABLED, false), migrationPlannerEnabled: readBool(process.env.WPNAV_FLAG_WP_MIGRATION_PLANNER_ENABLED, false), performanceAnalyzerEnabled: readBool( process.env.WPNAV_FLAG_WP_PERFORMANCE_ANALYZER_ENABLED, false ), }, } satisfies WPConfig; } /** * Redact secrets for logs. */ export function redact(value?: string | null): string { if (!value) return ''; if (value.length <= 4) return '****'; return `${value.slice(0, 2)}****${value.slice(-2)}`; } function readBool(v: string | undefined, defaultVal: boolean): boolean { if (v == null) return defaultVal; const s = String(v).trim().toLowerCase(); return s === '1' || s === 'true' || s === 'yes' || s === 'on'; } function readInt(v: string | undefined, defaultVal: number): number { const n = v != null ? parseInt(String(v), 10) : NaN; return Number.isFinite(n) ? n : defaultVal; }