@plexor-dev/claude-code-plugin-staging 0.1.0-beta.2 → 0.1.0-beta.20

package/README.md

@@ -32,14 +32,11 @@ This installs slash commands to `~/.claude/commands/`.
 
 | Command | Description |
 |---------|-------------|
-| `/plexor-login` | Authenticate with Plexor |
-| `/plexor-status` | View usage stats and savings |
-| `/plexor-mode` | Set optimization mode (eco/balanced/quality/passthrough) |
-| `/plexor-provider` | Force specific provider (auto/claude/deepseek/mistral/gemini) |
-| `/plexor-config` | Quick config (enable/disable/cache/reset) |
-| `/plexor-settings` | Advanced settings (API URL, mode, provider) |
-| `/plexor-enabled` | Enable/disable the proxy |
+| `/plexor-setup` | First-time setup wizard |
+| `/plexor-login` | Authenticate with Plexor API key |
 | `/plexor-logout` | Sign out and clear credentials |
+| `/plexor-status` | View usage stats and savings |
+| `/plexor-enabled` | Enable/disable Plexor routing |
 
 ## How It Works
 

package/commands/plexor-agent.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+/**
+ * Plexor Agent — set agent autonomy level.
+ *
+ * Agent modes control how the AI agent behaves:
+ *   supervised:         Agent describes actions, waits for your confirmation
+ *   autonomous:         Agent acts independently within safe bounds (default)
+ *   danger-full-auto:   Full autonomy, no guardrails — forces tool execution
+ *
+ * Usage:
+ *   /plexor-agent                      Show current agent mode
+ *   /plexor-agent supervised           Confirm before every action
+ *   /plexor-agent autonomous           Smart autonomy (default)
+ *   /plexor-agent danger-full-auto     No guardrails
+ */
+
+const { loadConfig, saveConfig, readSetting } = require('../lib/config-utils');
+
+const VALID = ['supervised', 'autonomous', 'danger-full-auto'];
+const DESC = {
+  supervised:         'Confirm before acting',
+  autonomous:         'Acts within safe bounds (default)',
+  'danger-full-auto': 'Full autonomy, no guardrails'
+};
+const ALIASES = {
+  auto: 'autonomous',
+  fullauto: 'danger-full-auto',
+  'full-auto': 'danger-full-auto',
+  full_auto: 'danger-full-auto',
+  danger: 'danger-full-auto'
+};
+
+function main() {
+  const args = process.argv.slice(2);
+  const config = loadConfig();
+  const current = readSetting(config, 'orchestrationMode', 'orchestration_mode', 'PLEXOR_ORCHESTRATION_MODE', VALID, 'autonomous');
+
+  if (args.length === 0) {
+    console.log(`Agent Mode: ${current.value} (${current.source})`);
+    console.log(`  ${DESC[current.value]}`);
+    console.log('');
+    console.log('Options:');
+    for (const v of VALID) {
+      const marker = v === current.value ? '>>' : '  ';
+      console.log(`  ${marker} ${v.padEnd(20)} ${DESC[v]}`);
+    }
+    console.log('');
+    console.log('Set: /plexor-agent <mode>');
+    return;
+  }
+
+  let requested = args[0].toLowerCase().trim();
+  if (ALIASES[requested]) requested = ALIASES[requested];
+
+  if (!VALID.includes(requested)) {
+    console.error(`Invalid agent mode: "${args[0]}"`);
+    console.error(`Valid: ${VALID.join(', ')}`);
+    process.exit(1);
+  }
+
+  if (current.source === 'environment' && requested !== current.value) {
+    console.log(`Warning: PLEXOR_ORCHESTRATION_MODE env var is set to "${current.value}". Config updated but env var takes priority.`);
+  }
+
+  if (requested === current.value && current.source === 'config') {
+    console.log(`Already set to "${requested}".`);
+    return;
+  }
+
+  config.settings = config.settings || {};
+  config.settings.orchestrationMode = requested;
+  if (config.settings.orchestration_mode) delete config.settings.orchestration_mode;
+  if (!saveConfig(config)) { process.exit(1); }
+
+  console.log(`Agent mode: ${current.value} → ${requested}`);
+  console.log(`  ${DESC[requested]}`);
+  if (requested === 'danger-full-auto') {
+    console.log('  Warning: This forces tool execution on every turn with tools.');
+  }
+  console.log('  Takes effect on next request.');
+}
+
+main();

package/commands/plexor-agent.md

@@ -0,0 +1,36 @@
+---
+description: Set Plexor agent autonomy — supervised, autonomous, or danger-full-auto (user)
+---
+
+**Step 1: Check if arguments were provided.**
+
+If `$ARGUMENTS` contains a value (e.g., `/plexor-agent autonomous`), apply it directly:
+
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-agent.js $ARGUMENTS
+```
+
+Present the output to the user and STOP. Do NOT call any other tools.
+
+**Step 2: If NO arguments were provided** (just `/plexor-agent`), first show the current state:
+
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-agent.js
+```
+
+Then immediately use **AskUserQuestion** to let the user pick a mode:
+
+- **Question**: "Which agent autonomy mode?"
+- **Header**: "Agent mode"
+- **Options** (exactly 3):
+  1. **supervised** — "Confirm before every action"
+  2. **autonomous (Recommended)** — "Acts within safe bounds, default mode"
+  3. **danger-full-auto** — "Full autonomy, no guardrails"
+
+**Step 3: After the user selects**, apply their choice:
+
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-agent.js <selected_value>
+```
+
+Present the output and STOP. Do NOT re-execute commands or call other tools.

package/commands/plexor-enabled.js

@@ -14,26 +14,108 @@
 const fs = require('fs');
 const path = require('path');
 
-// Import settings manager for automatic Claude Code configuration
-const { settingsManager, PLEXOR_STAGING_URL, PLEXOR_PROD_URL } = require('../lib/settings-manager');
+// Import centralized constants with HOME directory validation
+const { PLEXOR_DIR, CONFIG_PATH } = require('../lib/constants');
 
-const CONFIG_PATH = path.join(process.env.HOME, '.plexor', 'config.json');
-const PLEXOR_DIR = path.join(process.env.HOME, '.plexor');
+// Import settings manager with error handling for missing lib
+let settingsManager, PLEXOR_STAGING_URL, PLEXOR_PROD_URL;
+try {
+  const lib = require('../lib/settings-manager');
+  settingsManager = lib.settingsManager;
+  PLEXOR_STAGING_URL = lib.PLEXOR_STAGING_URL;
+  PLEXOR_PROD_URL = lib.PLEXOR_PROD_URL;
+} catch (err) {
+  if (err.code === 'MODULE_NOT_FOUND') {
+    console.error('Error: Plexor plugin files are missing or corrupted.');
+    console.error('       Please reinstall: npm install @plexor-dev/claude-code-plugin-staging');
+    process.exit(1);
+  }
+  throw err;
+}
 
 function loadConfig() {
   try {
+    if (!fs.existsSync(CONFIG_PATH)) {
+      return { version: 1, auth: {}, settings: {} };
+    }
     const data = fs.readFileSync(CONFIG_PATH, 'utf8');
-    return JSON.parse(data);
-  } catch {
+    if (!data || data.trim() === '') {
+      return { version: 1, auth: {}, settings: {} };
+    }
+    const config = JSON.parse(data);
+    if (typeof config !== 'object' || config === null) {
+      console.warn('Warning: Config file has invalid format, using defaults');
+      return { version: 1, auth: {}, settings: {} };
+    }
+    return config;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      console.warn('Warning: Config file is corrupted, using defaults');
+      // Backup corrupted file
+      try {
+        fs.copyFileSync(CONFIG_PATH, CONFIG_PATH + '.corrupted');
+      } catch { /* ignore */ }
+    }
     return { version: 1, auth: {}, settings: {} };
   }
 }
 
 function saveConfig(config) {
-  if (!fs.existsSync(PLEXOR_DIR)) {
-    fs.mkdirSync(PLEXOR_DIR, { recursive: true, mode: 0o700 });
+  try {
+    if (!fs.existsSync(PLEXOR_DIR)) {
+      fs.mkdirSync(PLEXOR_DIR, { recursive: true, mode: 0o700 });
+    }
+
+    // Atomic write: write to temp file, then rename
+    const crypto = require('crypto');
+    const tempId = crypto.randomBytes(8).toString('hex');
+    const tempPath = path.join(PLEXOR_DIR, `.config.${tempId}.tmp`);
+
+    fs.writeFileSync(tempPath, JSON.stringify(config, null, 2), { mode: 0o600 });
+    fs.renameSync(tempPath, CONFIG_PATH);
+    return true;
+  } catch (err) {
+    if (err.code === 'EACCES' || err.code === 'EPERM') {
+      console.error(`Error: Cannot write to ~/.plexor/config.json`);
+      console.error('       Check file permissions or run with appropriate access.');
+    } else {
+      console.error('Failed to save config:', err.message);
+    }
+    return false;
   }
-  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+
+/**
+ * Validate API key format
+ * @param {string} key - API key to validate
+ * @returns {boolean} true if valid format
+ */
+function isValidApiKeyFormat(key) {
+  return key && typeof key === 'string' && key.startsWith('plx_') && key.length >= 20;
+}
+
+/**
+ * Check for state mismatch between config.json enabled flag and settings.json routing
+ * @param {boolean} configEnabled - enabled flag from config.json
+ * @param {boolean} routingActive - whether settings.json has Plexor routing configured
+ * @returns {Object|null} mismatch details or null if states are consistent
+ */
+function checkStateMismatch(configEnabled, routingActive) {
+  if (configEnabled && !routingActive) {
+    return {
+      type: 'config-enabled-routing-inactive',
+      message: 'Config shows enabled but Claude routing is not configured',
+      suggestion: 'Run /plexor-enabled true to sync and configure routing'
+    };
+  }
+  if (!configEnabled && routingActive) {
+    return {
+      type: 'config-disabled-routing-active',
+      message: 'Config shows disabled but Claude routing is active',
+      suggestion: 'Run /plexor-enabled false to sync and disable routing'
+    };
+  }
+  return null;
 }
 
 function main() {
@@ -49,6 +131,10 @@ function main() {
   if (args.length === 0) {
     const status = currentEnabled ? '● Enabled' : '○ Disabled';
     const routingStr = routingStatus.enabled ? '● Active' : '○ Inactive';
+
+    // Check for state mismatch between config enabled flag and routing status
+    const stateMismatch = checkStateMismatch(currentEnabled, routingStatus.enabled);
+
     console.log(`┌─────────────────────────────────────────────┐`);
     console.log(`│  Plexor Proxy Status                        │`);
     console.log(`├─────────────────────────────────────────────┤`);
@@ -57,6 +143,12 @@ function main() {
     if (routingStatus.enabled) {
     console.log(`│  Endpoint: ${(routingStatus.isStaging ? 'Staging' : 'Production').padEnd(32)}│`);
     }
+    if (stateMismatch) {
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  ⚠ State mismatch detected:                 │`);
+    console.log(`│  ${stateMismatch.message.padEnd(42)}│`);
+    console.log(`│  ${stateMismatch.suggestion.padEnd(42)}│`);
+    }
     console.log(`├─────────────────────────────────────────────┤`);
     console.log(`│  Usage:                                     │`);
     console.log(`│    /plexor-enabled true   - Enable proxy    │`);
@@ -80,26 +172,93 @@ function main() {
     process.exit(1);
   }
 
-  // Update Plexor plugin config
-  config.settings = config.settings || {};
-  config.settings.enabled = newEnabled;
-  saveConfig(config);
-
   // THE KEY FEATURE: Update Claude Code settings.json routing
   let routingUpdated = false;
+  let missingApiKey = false;
+  let invalidApiKey = false;
+
   if (newEnabled) {
-    // Enable routing - need API key from config
-    if (apiKey) {
+    // Enable routing - need valid API key from config
+    if (!apiKey) {
+      missingApiKey = true;
+    } else if (!isValidApiKeyFormat(apiKey)) {
+      invalidApiKey = true;
+    } else {
+      // Update Plexor plugin config first
+      config.settings = config.settings || {};
+      config.settings.enabled = newEnabled;
+      if (!saveConfig(config)) {
+        process.exit(1);
+      }
+
       // STAGING PACKAGE - uses staging API
       const apiUrl = config.settings?.apiUrl || 'https://staging.api.plexor.dev';
       const useStaging = apiUrl.includes('staging');
       routingUpdated = settingsManager.enablePlexorRouting(apiKey, { useStaging });
-    } else {
-      console.log('⚠ No API key found. Run /plexor-login first.');
+
+      // Check if settings.json update failed
+      if (!routingUpdated) {
+        console.log(`┌─────────────────────────────────────────────┐`);
+        console.log(`│  ✗ Failed to Enable Plexor Routing          │`);
+        console.log(`├─────────────────────────────────────────────┤`);
+        console.log(`│  Could not update ~/.claude/settings.json   │`);
+        console.log(`│  Config.json was updated but routing failed.│`);
+        console.log(`├─────────────────────────────────────────────┤`);
+        console.log(`│  Check file permissions and try again.      │`);
+        console.log(`└─────────────────────────────────────────────┘`);
+        process.exit(1);
+      }
     }
   } else {
+    // Update Plexor plugin config
+    config.settings = config.settings || {};
+    config.settings.enabled = newEnabled;
+    if (!saveConfig(config)) {
+      process.exit(1);
+    }
+
     // Disable routing - remove env vars from settings.json
     routingUpdated = settingsManager.disablePlexorRouting();
+
+    // Check if settings.json update failed
+    if (!routingUpdated) {
+      console.log(`┌─────────────────────────────────────────────┐`);
+      console.log(`│  ✗ Failed to Disable Plexor Routing         │`);
+      console.log(`├─────────────────────────────────────────────┤`);
+      console.log(`│  Could not update ~/.claude/settings.json   │`);
+      console.log(`│  Config.json was updated but routing failed.│`);
+      console.log(`├─────────────────────────────────────────────┤`);
+      console.log(`│  Check file permissions and try again.      │`);
+      console.log(`└─────────────────────────────────────────────┘`);
+      process.exit(1);
+    }
+  }
+
+  // Show error if no API key when enabling
+  if (missingApiKey) {
+    console.log(`┌─────────────────────────────────────────────┐`);
+    console.log(`│  ✗ Cannot Enable Plexor                     │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  No API key configured.                     │`);
+    console.log(`│  Run /plexor-setup first.                   │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  Get your API key at:                       │`);
+    console.log(`│  https://plexor.dev/dashboard/api-keys      │`);
+    console.log(`└─────────────────────────────────────────────┘`);
+    process.exit(1);
+  }
+
+  // Show error if API key format is invalid
+  if (invalidApiKey) {
+    console.log(`┌─────────────────────────────────────────────┐`);
+    console.log(`│  ✗ Cannot Enable Plexor                     │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  Invalid API key format in config.          │`);
+    console.log(`│  Keys must start with "plx_" (20+ chars).   │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  Run /plexor-setup to fix it.               │`);
+    console.log(`└─────────────────────────────────────────────┘`);
+    process.exit(1);
   }
 
   const newStatus = newEnabled ? '● Enabled' : '○ Disabled';

package/commands/plexor-enabled.md

@@ -2,27 +2,45 @@
 description: Enable or disable Plexor proxy (routes all traffic through Plexor API) (user)
 ---
 
-# Plexor Enabled
+**RULE: Execute this workflow EXACTLY ONCE. After completing all steps, STOP. DO NOT restart the workflow. DO NOT re-execute any commands. DO NOT call any other tools.**
 
-Run this command to view or toggle the Plexor proxy:
+## If argument provided (on/off/true/false)
+
+Run the command directly with the argument:
 
 ```bash
-node ~/.claude/plugins/plexor/commands/plexor-enabled.js
+node ~/.claude/plugins/plexor/commands/plexor-enabled.js <argument>
 ```
 
-To enable or disable, pass an argument:
+Then present the output to the user and STOP.
+
+## If NO argument provided
+
+**Step 1**: Get current status by running:
 
 ```bash
-node ~/.claude/plugins/plexor/commands/plexor-enabled.js true
-node ~/.claude/plugins/plexor/commands/plexor-enabled.js false
+node ~/.claude/plugins/plexor/commands/plexor-enabled.js
 ```
 
-Use the Bash tool to execute this command.
+**Step 2**: Based on the output, use AskUserQuestion to present options:
+
+If currently ENABLED (shows "Enabled" or "Active"):
+- Question: "Plexor is currently ON. What would you like to do?"
+- Header: "Plexor"
+- Options:
+  1. **Turn OFF** - Disable Plexor routing (connect directly to Anthropic)
+  2. **Keep ON** - No change
+
+If currently DISABLED (shows "Disabled" or "Inactive"):
+- Question: "Plexor is currently OFF. What would you like to do?"
+- Header: "Plexor"
+- Options:
+  1. **Turn ON** - Enable Plexor routing
+  2. **Keep OFF** - No change
 
-**IMPORTANT**: After running this command and displaying the output, STOP. Do not:
-- Read any files
-- Explore the codebase
-- Run additional commands
-- Ask follow-up questions
+**Step 3**: Based on user selection:
+- If "Turn OFF" selected: Run `node ~/.claude/plugins/plexor/commands/plexor-enabled.js false`
+- If "Turn ON" selected: Run `node ~/.claude/plugins/plexor/commands/plexor-enabled.js true`
+- If "Keep" selected: Do nothing, just confirm current state
 
-The command output is the complete response. Simply show the output and wait for the user's next input.
+After completing all steps, STOP. DO NOT restart the workflow.