chore: pre-publish cleanup — normalize env vars + package.json metadata

Env var renames (all now under ARGUS_ prefix, consistent with ARGUS_SLOW_QUERY_*):
  DIAGNOSTIC_AGENT_ENABLED  → ARGUS_ENABLED
  DIAGNOSTIC_DEBUG          → ARGUS_DEBUG
  DIAGNOSTIC_LICENSE_KEY    → ARGUS_LICENSE_KEY
  RUNTIME_MONITOR_EVENT_LOOP_THRESHOLD_MS   → ARGUS_EVENT_LOOP_THRESHOLD_MS
  RUNTIME_MONITOR_MEMORY_GROWTH_BYTES       → ARGUS_MEMORY_GROWTH_BYTES
  RUNTIME_MONITOR_CPU_PROFILE_COOLDOWN_MS   → ARGUS_CPU_PROFILE_COOLDOWN_MS
  RUNTIME_MONITOR_CHECK_INTERVAL_MS         → ARGUS_MONITOR_CHECK_INTERVAL_MS
  RUNTIME_MONITOR_CPU_PROFILE_DURATION_MS   → ARGUS_CPU_PROFILE_DURATION_MS
  RUNTIME_MONITOR_HEAP_USAGE_PCT_THRESHOLD  → ARGUS_HEAP_USAGE_PCT_THRESHOLD

package.json:
  - Add repository, homepage, bugs fields
  - Add "argus", "monitoring", "tracing" keywords
  - Set author: Sharon Alhazov

Rebuild dist with renamed env vars baked in.
508/508 tests pass, 0 TS errors, 0 ESLint warnings.

Author: sharon77242

CHANGELOG.md

@@ -46,9 +46,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 #### Core agent
 - `ArgusAgent` fluent builder with two entry points: `create()` (manual) and
   `createProfile()` (preset-based).
-- Zero-overhead global kill-switch via `DIAGNOSTIC_AGENT_ENABLED=false` — `.start()` becomes
+- Zero-overhead global kill-switch via `ARGUS_ENABLED=false` — `.start()` becomes
   a no-op with no timer, subscription, or memory overhead.
-- `DIAGNOSTIC_DEBUG=true` built-in console logger for all agent events.
+- `ARGUS_DEBUG=true` built-in console logger for all agent events.
 
 #### Preset system
 - Three environment presets: `prod`, `dev`, `test`.

README.md

@@ -165,7 +165,7 @@ const agent = await ArgusAgent.createProfile({
 ```
 
 > [!NOTE]
-> **Zero-overhead kill-switch** — set `DIAGNOSTIC_AGENT_ENABLED=false` (or `0`) in any environment and the agent skips all initialisation with no CPU cost. Useful for gradual rollouts, incident response, or staging overrides without a code deploy.
+> **Zero-overhead kill-switch** — set `ARGUS_ENABLED=false` (or `0`) in any environment and the agent skips all initialisation with no CPU cost. Useful for gradual rollouts, incident response, or staging overrides without a code deploy.
 
 ---
 
@@ -198,7 +198,7 @@ See [`quotes-demo-app/README.md`](quotes-demo-app/README.md) for the full setup
 const agent = await ArgusAgent.createProfile({
   environment: 'prod',        // 'dev' | 'test' | 'prod'
   appType: ['web', 'db'],     // single string or array — modules are unioned
-  enabled: true,              // overridden by DIAGNOSTIC_AGENT_ENABLED env-var
+  enabled: true,              // overridden by ARGUS_ENABLED env-var
   workspaceDir: process.cwd(), // dev/test only — enables StaticScanner, AuditScanner, SourceMaps
 }).start();
 ```
@@ -537,14 +537,14 @@ All thresholds can be overridden without code changes, making the agent CI/CD an
 
 | Variable | Default | Controls |
 |---|---|---|
-| `DIAGNOSTIC_AGENT_ENABLED` | `true` | Set to `false` or `0` for a zero-CPU-overhead global kill-switch |
-| `DIAGNOSTIC_DEBUG` | `false` | Set to `true` to enable the built-in console logger for all agent events |
-| `RUNTIME_MONITOR_EVENT_LOOP_THRESHOLD_MS` | `50` | Minimum lag (ms) before an event-loop anomaly fires |
-| `RUNTIME_MONITOR_MEMORY_GROWTH_BYTES` | `10485760` (10 MB) | Minimum heap growth before a memory-leak anomaly fires |
-| `RUNTIME_MONITOR_CPU_PROFILE_COOLDOWN_MS` | `60000` | Minimum ms between back-to-back CPU profiles |
-| `RUNTIME_MONITOR_CHECK_INTERVAL_MS` | `1000` | How often thresholds are polled |
-| `RUNTIME_MONITOR_CPU_PROFILE_DURATION_MS` | `500` | Duration of each CPU profile capture |
-| `RUNTIME_MONITOR_HEAP_USAGE_PCT_THRESHOLD` | `90` | Heap usage % of `heapTotal` before a memory anomaly fires |
+| `ARGUS_ENABLED` | `true` | Set to `false` or `0` for a zero-CPU-overhead global kill-switch |
+| `ARGUS_DEBUG` | `false` | Set to `true` to enable the built-in console logger for all agent events |
+| `ARGUS_EVENT_LOOP_THRESHOLD_MS` | `50` | Minimum lag (ms) before an event-loop anomaly fires |
+| `ARGUS_MEMORY_GROWTH_BYTES` | `10485760` (10 MB) | Minimum heap growth before a memory-leak anomaly fires |
+| `ARGUS_CPU_PROFILE_COOLDOWN_MS` | `60000` | Minimum ms between back-to-back CPU profiles |
+| `ARGUS_MONITOR_CHECK_INTERVAL_MS` | `1000` | How often thresholds are polled |
+| `ARGUS_CPU_PROFILE_DURATION_MS` | `500` | Duration of each CPU profile capture |
+| `ARGUS_HEAP_USAGE_PCT_THRESHOLD` | `90` | Heap usage % of `heapTotal` before a memory anomaly fires |
 | `ARGUS_SLOW_QUERY_THRESHOLD_MS` | `1000` | Global slow query threshold used when no per-driver default applies |
 | `ARGUS_SLOW_QUERY_THRESHOLD_<DRIVER>` | (per-driver) | Per-driver threshold override. Key is the driver name uppercased with non-alphanumeric runs replaced by `_` — e.g. `ARGUS_SLOW_QUERY_THRESHOLD_PG=500`, `ARGUS_SLOW_QUERY_THRESHOLD_REDIS=50`, `ARGUS_SLOW_QUERY_THRESHOLD_ELASTIC_ELASTICSEARCH=300` |
 
@@ -652,7 +652,7 @@ packages/agent/
     internal/
       profile-factory.ts             → buildAgentProfile() — preset resolution for createProfile()
       query-handler.ts               → createQueryHandler() — per-query sampling/analysis/slow-log closure
-      console-logger.ts              → installConsoleLogger() — DIAGNOSTIC_DEBUG event formatting
+      console-logger.ts              → installConsoleLogger() — ARGUS_DEBUG event formatting
 
     profiling/
       app-type-detector.ts           → package.json fingerprint scanner
@@ -769,14 +769,14 @@ runWithContext(agent.createContext('WORKER', '/process-job'), async () => {
 
 > [!IMPORTANT]
 > **OTLP export requires a paid Self-Hosted Pro or Enterprise license.**
-> In free mode the agent emits events locally via `EventEmitter` only — `.withExporter()` has no effect without a valid `DIAGNOSTIC_LICENSE_KEY`.
+> In free mode the agent emits events locally via `EventEmitter` only — `.withExporter()` has no effect without a valid `ARGUS_LICENSE_KEY`.
 > To get notified when Self-Hosted Pro licenses go on sale: open [this GitHub issue](https://github.com/sharon77242/Argus/issues) or email [sharon10vp614@gmail.com](mailto:sharon10vp614@gmail.com).
 
 The Self-Hosted Pro tier exports standard OTLP JSON directly to your own collector — no data ever leaves your infrastructure. Any OTLP-compatible collector works. Below is the quickest local setup using Jaeger's all-in-one image.
 
 ```bash
 # Set your license key (Self-Hosted Pro or Enterprise)
-export DIAGNOSTIC_LICENSE_KEY="your-license-key"
+export ARGUS_LICENSE_KEY="your-license-key"
 ```
 
 ### Jaeger (quickest local setup)

packages/agent/package.json

@@ -41,16 +41,27 @@
     "validate": "pnpm run typecheck && pnpm run lint && pnpm run format:check && pnpm run test:coverage"
   },
   "keywords": [
+    "argus",
     "node",
     "diagnostics",
     "performance",
     "profiling",
     "apm",
     "observability",
-    "privacy"
+    "privacy",
+    "monitoring",
+    "tracing"
   ],
-  "author": "",
+  "author": "Sharon Alhazov (https://github.com/sharon77242)",
   "license": "MIT",
+  "homepage": "https://github.com/sharon77242/Argus#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sharon77242/Argus.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sharon77242/Argus/issues"
+  },
   "devDependencies": {
     "@types/node": "^22.15.29",
     "@types/source-map": "^0.5.7",

packages/agent/src/argus-agent.ts

@@ -189,7 +189,7 @@ export class ArgusAgent extends EventEmitter {
 
     // Globally kill-switch the agent; .start() and .stop() will become 0-overhead.
     // Environment variables take precedence over the config object.
-    const envEnabled = process.env.DIAGNOSTIC_AGENT_ENABLED;
+    const envEnabled = process.env.ARGUS_ENABLED;
     const isGloballyDisabled =
       envEnabled !== undefined
         ? envEnabled === "false" || envEnabled === "0"
@@ -471,7 +471,7 @@ export class ArgusAgent extends EventEmitter {
   public async start(): Promise<this> {
     if (this.globallyDisabled || this.running) return this;
 
-    if (process.env.DIAGNOSTIC_DEBUG === "true") {
+    if (process.env.ARGUS_DEBUG === "true") {
       this.useConsoleLogger();
     }
 
@@ -492,7 +492,7 @@ export class ArgusAgent extends EventEmitter {
 
   /** Step 0 — Validate license; fall back to free mode on any failure (never crash). */
   private validateLicenseKey(): void {
-    const licenseKey = process.env.DIAGNOSTIC_LICENSE_KEY;
+    const licenseKey = process.env.ARGUS_LICENSE_KEY;
     if (!licenseKey) return;
 
     try {
@@ -834,7 +834,7 @@ export class ArgusAgent extends EventEmitter {
   // ── built-in console logger ───────────────────────────────────
 
   /**
-   * Internal only — called automatically when DIAGNOSTIC_DEBUG=true.
+   * Internal only — called automatically when ARGUS_DEBUG=true.
    *
    * @param prefix  Log prefix (default: `[DiagAgent]`)
    * @param level   `'warn'` — anomalies/crashes/errors only (default)

packages/agent/src/internal/console-logger.ts

@@ -2,7 +2,7 @@
  * Console debug logger for ArgusAgent.
  *
  * Extracted from ArgusAgent to keep the main class focused on lifecycle.
- * When DIAGNOSTIC_DEBUG=true the agent calls installConsoleLogger() once during
+ * When ARGUS_DEBUG=true the agent calls installConsoleLogger() once during
  * start() — all registered listeners are returned so the agent can remove them
  * on stop() without leaking event subscriptions.
  */

packages/agent/src/profiling/runtime-monitor.ts

@@ -63,22 +63,22 @@ export class RuntimeMonitor extends EventEmitter {
     this.options = {
       eventLoopThresholdMs:
         options.eventLoopThresholdMs ??
-        safePositiveInt(process.env.RUNTIME_MONITOR_EVENT_LOOP_THRESHOLD_MS, 50),
+        safePositiveInt(process.env.ARGUS_EVENT_LOOP_THRESHOLD_MS, 50),
       memoryGrowthThresholdBytes:
         options.memoryGrowthThresholdBytes ??
-        safePositiveInt(process.env.RUNTIME_MONITOR_MEMORY_GROWTH_BYTES, 10 * 1024 * 1024),
+        safePositiveInt(process.env.ARGUS_MEMORY_GROWTH_BYTES, 10 * 1024 * 1024),
       cpuProfileCooldownMs:
         options.cpuProfileCooldownMs ??
-        safePositiveInt(process.env.RUNTIME_MONITOR_CPU_PROFILE_COOLDOWN_MS, 60000),
+        safePositiveInt(process.env.ARGUS_CPU_PROFILE_COOLDOWN_MS, 60000),
       checkIntervalMs:
         options.checkIntervalMs ??
-        safePositiveInt(process.env.RUNTIME_MONITOR_CHECK_INTERVAL_MS, 1000),
+        safePositiveInt(process.env.ARGUS_MONITOR_CHECK_INTERVAL_MS, 1000),
       cpuProfileDurationMs:
         options.cpuProfileDurationMs ??
-        safePositiveInt(process.env.RUNTIME_MONITOR_CPU_PROFILE_DURATION_MS, 500),
+        safePositiveInt(process.env.ARGUS_CPU_PROFILE_DURATION_MS, 500),
       heapUsagePctThreshold:
         options.heapUsagePctThreshold ??
-        safePositiveInt(process.env.RUNTIME_MONITOR_HEAP_USAGE_PCT_THRESHOLD, 90),
+        safePositiveInt(process.env.ARGUS_HEAP_USAGE_PCT_THRESHOLD, 90),
     };
 
     this.elMonitor = monitorEventLoopDelay({ resolution: 10 });

packages/agent/tests/argus-agent-coverage.test.ts

@@ -14,7 +14,7 @@
  *   - 520:     resolvePosition delegating to resolver
  *
  *   Also:
- *   - DIAGNOSTIC_AGENT_ENABLED='false' / '0' env-var kill-switch
+ *   - ARGUS_ENABLED='false' / '0' env-var kill-switch
  *   - withEntropyThreshold override on logTracingOptions
  */
 import { describe, it, afterEach } from "node:test";
@@ -68,42 +68,42 @@ describe("ArgusAgent (extended coverage)", () => {
     agent = null;
   });
 
-  // ── env-var kill-switch: DIAGNOSTIC_AGENT_ENABLED=false ──────────────────
-  it("should be disabled via DIAGNOSTIC_AGENT_ENABLED=false", async () => {
-    const orig = process.env.DIAGNOSTIC_AGENT_ENABLED;
-    process.env.DIAGNOSTIC_AGENT_ENABLED = "false";
+  // ── env-var kill-switch: ARGUS_ENABLED=false ──────────────────
+  it("should be disabled via ARGUS_ENABLED=false", async () => {
+    const orig = process.env.ARGUS_ENABLED;
+    process.env.ARGUS_ENABLED = "false";
     try {
       agent = ArgusAgent.createProfile({ enabled: true }); // config says enabled but env overrides
       await agent.start();
       assert.strictEqual(agent.isRunning, false);
     } finally {
-      if (orig === undefined) delete process.env.DIAGNOSTIC_AGENT_ENABLED;
-      else process.env.DIAGNOSTIC_AGENT_ENABLED = orig;
+      if (orig === undefined) delete process.env.ARGUS_ENABLED;
+      else process.env.ARGUS_ENABLED = orig;
     }
   });
 
-  it("should be disabled via DIAGNOSTIC_AGENT_ENABLED=0", async () => {
-    const orig = process.env.DIAGNOSTIC_AGENT_ENABLED;
-    process.env.DIAGNOSTIC_AGENT_ENABLED = "0";
+  it("should be disabled via ARGUS_ENABLED=0", async () => {
+    const orig = process.env.ARGUS_ENABLED;
+    process.env.ARGUS_ENABLED = "0";
     try {
       agent = ArgusAgent.createProfile({});
       await agent.start();
       assert.strictEqual(agent.isRunning, false);
     } finally {
-      if (orig === undefined) delete process.env.DIAGNOSTIC_AGENT_ENABLED;
-      else process.env.DIAGNOSTIC_AGENT_ENABLED = orig;
+      if (orig === undefined) delete process.env.ARGUS_ENABLED;
+      else process.env.ARGUS_ENABLED = orig;
     }
   });
 
-  it("should be enabled when DIAGNOSTIC_AGENT_ENABLED=true", async () => {
-    const orig = process.env.DIAGNOSTIC_AGENT_ENABLED;
-    process.env.DIAGNOSTIC_AGENT_ENABLED = "true";
+  it("should be enabled when ARGUS_ENABLED=true", async () => {
+    const orig = process.env.ARGUS_ENABLED;
+    process.env.ARGUS_ENABLED = "true";
     try {
       agent = await ArgusAgent.createProfile({ environment: "prod", appType: "web" }).start();
       assert.strictEqual(agent.isRunning, true);
     } finally {
-      if (orig === undefined) delete process.env.DIAGNOSTIC_AGENT_ENABLED;
-      else process.env.DIAGNOSTIC_AGENT_ENABLED = orig;
+      if (orig === undefined) delete process.env.ARGUS_ENABLED;
+      else process.env.ARGUS_ENABLED = orig;
     }
   });
 
@@ -326,7 +326,7 @@ describe("ArgusAgent (extended coverage)", () => {
   // ── Exporter wired to aggregator flush ────────────────────────────────────
   it("should emit error when exporter fails during aggregator flush", async () => {
     // shouldExport() requires a valid license — use dev-k1 with 'test-metric' allowed
-    process.env.DIAGNOSTIC_LICENSE_KEY = makeDevLicense(["test-metric"]);
+    process.env.ARGUS_LICENSE_KEY = makeDevLicense(["test-metric"]);
     try {
       agent = await ArgusAgent.create()
         .withExporter({
@@ -355,7 +355,7 @@ describe("ArgusAgent (extended coverage)", () => {
       const [err] = await Promise.race([errorPromise, timeout]);
       assert.ok(err instanceof Error, "Should emit an Error");
     } finally {
-      delete process.env.DIAGNOSTIC_LICENSE_KEY;
+      delete process.env.ARGUS_LICENSE_KEY;
     }
   });
 

packages/agent/tests/argus-agent-debug.test.ts

@@ -1,5 +1,5 @@
 /**
- * Coverage tests for ArgusAgent — DIAGNOSTIC_DEBUG, useConsoleLogger,
+ * Coverage tests for ArgusAgent — ARGUS_DEBUG, useConsoleLogger,
  * and remaining uncovered start/stop branches.
  */
 import { describe, it, afterEach } from "node:test";
@@ -14,11 +14,11 @@ describe("ArgusAgent (debug & logger coverage)", () => {
       agent.stop();
       agent = null;
     }
-    delete process.env.DIAGNOSTIC_DEBUG;
+    delete process.env.ARGUS_DEBUG;
   });
 
-  it("DIAGNOSTIC_DEBUG=true should activate console logger and not throw", async () => {
-    process.env.DIAGNOSTIC_DEBUG = "true";
+  it("ARGUS_DEBUG=true should activate console logger and not throw", async () => {
+    process.env.ARGUS_DEBUG = "true";
     agent = await ArgusAgent.create()
       .withInstrumentation()
       .withHttpTracing()
@@ -47,7 +47,7 @@ describe("ArgusAgent (debug & logger coverage)", () => {
   });
 
   it("crash event with no error.message should use the event itself", async () => {
-    process.env.DIAGNOSTIC_DEBUG = "true";
+    process.env.ARGUS_DEBUG = "true";
     agent = await ArgusAgent.create().withCrashGuard().start();
 
     // Emit crash with no error object

packages/agent/tests/argus-agent.test.ts

@@ -36,7 +36,7 @@ describe("ArgusAgent (builder pattern)", () => {
   afterEach(async () => {
     await agent?.stop();
     agent = null;
-    delete process.env.DIAGNOSTIC_LICENSE_KEY;
+    delete process.env.ARGUS_LICENSE_KEY;
   });
 
   it("should start and stop with minimal configuration", async () => {
@@ -112,12 +112,12 @@ describe("ArgusAgent (builder pattern)", () => {
     result.withGracefulShutdown({ timeoutMs: 3000 }); // accepts options
   });
 
-  it("valid DIAGNOSTIC_LICENSE_KEY emits info with tier and exp", async () => {
+  it("valid ARGUS_LICENSE_KEY emits info with tier and exp", async () => {
     const jwt = buildJwt({
       ...BASE_CLAIMS,
       exp: Math.floor(Date.now() / 1000) + 3600,
     });
-    process.env.DIAGNOSTIC_LICENSE_KEY = jwt;
+    process.env.ARGUS_LICENSE_KEY = jwt;
 
     const messages: string[] = [];
     agent = ArgusAgent.create();
@@ -130,12 +130,12 @@ describe("ArgusAgent (builder pattern)", () => {
     );
   });
 
-  it("expired DIAGNOSTIC_LICENSE_KEY emits info about expiry without crashing", async () => {
+  it("expired ARGUS_LICENSE_KEY emits info about expiry without crashing", async () => {
     const jwt = buildJwt({
       ...BASE_CLAIMS,
       exp: Math.floor(Date.now() / 1000) - 3600, // already expired
     });
-    process.env.DIAGNOSTIC_LICENSE_KEY = jwt;
+    process.env.ARGUS_LICENSE_KEY = jwt;
 
     const messages: string[] = [];
     agent = ArgusAgent.create();
@@ -150,8 +150,8 @@ describe("ArgusAgent (builder pattern)", () => {
     assert.strictEqual(agent.isRunning, true, "Agent should still be running in free mode");
   });
 
-  it("invalid DIAGNOSTIC_LICENSE_KEY emits error without crashing", async () => {
-    process.env.DIAGNOSTIC_LICENSE_KEY = "not.a.valid.jwt.atall";
+  it("invalid ARGUS_LICENSE_KEY emits error without crashing", async () => {
+    process.env.ARGUS_LICENSE_KEY = "not.a.valid.jwt.atall";
 
     const errors: unknown[] = [];
     agent = ArgusAgent.create();