@solongate/proxy 0.82.19 → 0.82.20

package/dist/index.js

@@ -17029,41 +17029,78 @@ function printWelcome() {
   console.log("");
 }
 function printHelp3() {
-  const row = (name, desc) => console.log(`    ${c.cyan}${name.padEnd(13)}${c.reset}${c.dim}${desc}${c.reset}`);
-  console.log("");
-  console.log(`  ${c.bold}${c.blue4}SolonGate${c.reset} ${c.dim}secure gateway for your AI agents${c.reset}`);
-  console.log("");
-  console.log(`  ${c.dim}Usage:${c.reset} ${c.cyan}solongate${c.reset} ${c.dim}[command]${c.reset}`);
-  console.log(`  ${c.dim}With no command, opens the dataroom: accounts, policies, rate limits,${c.reset}`);
-  console.log(`  ${c.dim}DLP, audit and settings in one terminal UI.${c.reset}`);
-  console.log("");
-  console.log(`  ${c.bold}Setup & status${c.reset}`);
-  row("doctor", "health check: login, active policy, guard, local logs");
-  row("create", "scaffold a guarded MCP server in the current folder");
-  row("logs-server", "serve local audit logs to the dashboard");
-  console.log("");
-  console.log(`  ${c.bold}Security config${c.reset}`);
-  row("policy", "view and manage policies");
-  row("ratelimit", "view and manage rate limits");
-  row("dlp", "view and manage DLP (secret) rules");
-  row("alerts", "view and manage alerts");
-  row("webhooks", "view and manage webhooks");
+  const W = 46;
+  const head = (t) => console.log(`
+  ${c.bold}${t}${c.reset}`);
+  const cmd = (syntax, desc = "") => {
+    if (!desc) {
+      console.log(`    ${c.cyan}${syntax}${c.reset}`);
+      return;
+    }
+    if (syntax.length <= W) {
+      console.log(`    ${c.cyan}${syntax}${c.reset}${" ".repeat(W - syntax.length)}${c.dim}${desc}${c.reset}`);
+    } else {
+      console.log(`    ${c.cyan}${syntax}${c.reset}`);
+      console.log(`    ${" ".repeat(W)}${c.dim}${desc}${c.reset}`);
+    }
+  };
   console.log("");
-  console.log(`  ${c.bold}Monitoring${c.reset}`);
-  row("audit", "browse the audit log of tool-call decisions");
-  row("stats", "usage statistics");
-  row("watch", "live-tail tool calls as they happen");
-  row("agents", "list agents and sessions");
+  console.log(`  ${c.bold}${c.blue4}SolonGate${c.reset} ${c.dim}secure gateway for your AI agents${c.reset}  ${c.dim}v${PKG_VERSION}${c.reset}`);
   console.log("");
-  console.log(`  ${c.bold}Advanced${c.reset}`);
-  row("keys", "manage API keys");
-  row("mcp", "manage MCP servers");
-  row("shield", "wrap a command with LLM-path secret redaction: shield -- <cmd>");
-  row("pull", "pull a cloud policy to a local file");
-  row("push", "push a local policy file to the cloud");
-  row("list", "list cloud policies");
+  console.log(`  ${c.dim}Usage:${c.reset} ${c.cyan}solongate${c.reset} ${c.dim}[command]${c.reset}   ${c.dim}(no command opens the dataroom: all of this in a terminal UI)${c.reset}`);
+  head("Setup & status");
+  cmd("solongate", "open the dataroom UI (login, policies, audit, settings)");
+  cmd("doctor [--json]", "health check: login, policy, guard, local logs");
+  cmd("create", "scaffold a guarded MCP server in this folder");
+  cmd("logs-server", "serve local audit logs to the dashboard");
+  head("Policies");
+  cmd("policy list", "list all policies");
+  cmd("policy show <id> [--version N]", "show one policy (rules, mode)");
+  cmd("policy rules <id>", "list a policy's rules");
+  cmd("policy allow <id> --tool <p> [--command|--path|--url <val>]", "add an ALLOW rule");
+  cmd("policy revoke <id> <ruleId>", "remove a rule");
+  cmd("policy activate <id> | --clear", "pin / unpin the active policy");
+  cmd("policy rollback <id> <version>", "roll back to a version");
+  cmd("policy versions <id>", "version history");
+  cmd("policy active", "show the resolved active policy");
+  cmd("policy dry-run <id|file.json> [--mode denylist|whitelist]", "replay recent traffic against rules");
+  head("Rate limits");
+  cmd("ratelimit show", "current limits + change history");
+  cmd("ratelimit set --minute N [--hour N] [--day N] [--mode off|detect|block]", "edit limits (unset fields kept)");
+  cmd("ratelimit history", "recent limit changes");
+  head("DLP (secrets)");
+  cmd("dlp show", "current mode + enabled patterns");
+  cmd("dlp mode <off|detect|block>", "set enforcement mode");
+  cmd("dlp enable <pattern>", "enable a built-in pattern");
+  cmd("dlp disable <pattern>", "disable a built-in pattern");
+  cmd("dlp add-custom --name X --re <regex>", "add a custom pattern");
+  cmd("dlp remove-custom <name>", "remove a custom pattern");
+  head("Monitoring");
+  cmd("audit [--filter ALLOW|DENY] [--tool <s>] [--signal dlp|ratelimit] [--limit N]", "browse the audit log");
+  cmd("audit whitelist <logId> [--scope exact|tool]", "turn a denial into an ALLOW rule");
+  cmd("audit block <logId> [--scope exact|tool]", "turn a call into a DENY rule");
+  cmd("stats [timeseries|drift]", "traffic & security statistics");
+  cmd("watch [--filter DENY] [--tool <s>]", "live-tail tool calls (Ctrl+C to stop)");
+  cmd("agents [--all]", "live agent feed");
+  cmd("agent <agent_id>", "one-agent detail");
+  head("Alerts & webhooks");
+  cmd("alerts list");
+  cmd("alerts add --signal deny|dlp|ratelimit|any --threshold N --window S (--email <a> | --telegram <id> | --slack <url>)", "spike alert");
+  cmd("alerts remove <id>");
+  cmd("webhooks list");
+  cmd("webhooks add --url <https://\u2026> [--events denials|allowed|all]", "event webhook");
+  cmd("webhooks remove <id>");
+  head("Keys, MCP & advanced");
+  cmd("keys list", "list API keys (prefix only)");
+  cmd("keys create --name <name>", "create a key (secret shown once)");
+  cmd("keys revoke <id>", "revoke a key");
+  cmd("mcp", "list protected MCP servers");
+  cmd("shield -- <command>", "wrap a command with LLM-path secret redaction");
+  cmd("pull --policy-id <ID> [--file f]", "pull a cloud policy to a local file");
+  cmd("push --policy-id <ID> [--file f]", "push a local policy file to the cloud");
   console.log("");
-  console.log(`  ${c.dim}Dashboard: ${c.reset}${c.cyan}https://dashboard.solongate.com${c.reset}`);
+  console.log(`  ${c.dim}Add ${c.reset}${c.cyan}--json${c.reset}${c.dim} to most read commands for machine output.${c.reset}`);
+  console.log(`  ${c.dim}Details for a command: ${c.reset}${c.cyan}solongate <command> help${c.reset}${c.dim}  \xB7  Dashboard: ${c.reset}${c.cyan}https://dashboard.solongate.com${c.reset}`);
   console.log("");
 }
 async function main4() {
@@ -17138,6 +17175,17 @@ async function main4() {
     await Promise.resolve().then(() => (init_pull_push(), pull_push_exports));
     return;
   }
+  const hasProxySeparator = process.argv.includes("--");
+  const looksLikeProxyFlag = (subcommand ?? "").startsWith("-");
+  if (subcommand && !hasProxySeparator && !looksLikeProxyFlag) {
+    process.stdout.write(`
+  Unknown command: ${subcommand}
+`);
+    process.stdout.write(`  Run \`solongate --help\` to see every command, or \`solongate\` for the dataroom.
+
+`);
+    process.exit(1);
+  }
   try {
     const config = parseArgs(process.argv);
     const proxy = new SolonGateProxy(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solongate/proxy",
-  "version": "0.82.19",
+  "version": "0.82.20",
   "description": "AI tool security proxy: protect any AI tool server with customizable policies, path/command constraints, rate limiting, and audit logging. No code changes required.",
   "type": "module",
   "bin": {