drtrace 0.2.0 → 0.4.0

package/bin/init.js

@@ -5,9 +5,9 @@
  * Usage: npx drtrace init [--project-root <path>]
  */
 
-import yargs from "yargs";
-import { hideBin } from "yargs/helpers";
-import { runInitProject } from "./init";
+const yargs = require("yargs");
+const { hideBin } = require("yargs/helpers");
+const { runInitProject } = require("../init");
 
 yargs(hideBin(process.argv))
   .command(
@@ -20,7 +20,7 @@ yargs(hideBin(process.argv))
         description: "Project root directory (default: current directory)",
       }),
     async (argv) => {
-      const exitCode = await runInitProject(argv["project-root"] as string);
+      const exitCode = await runInitProject(argv["project-root"]);
       process.exit(exitCode);
     }
   )

package/dist/bin/init.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+/**
+ * CLI entry point for drtrace init command
+ * Usage: npx drtrace init [--project-root <path>]
+ */
+
+const yargs = require("yargs");
+const { hideBin } = require("yargs/helpers");
+const { runInitProject } = require("../init");
+
+yargs(hideBin(process.argv))
+  .command(
+    "init",
+    "Interactive DrTrace project initialization with config and templates",
+    (yargs) =>
+      yargs.option("project-root", {
+        alias: "p",
+        type: "string",
+        description: "Project root directory (default: current directory)",
+      }),
+    async (argv) => {
+      const exitCode = await runInitProject(argv["project-root"]);
+      process.exit(exitCode);
+    }
+  )
+  .demandCommand()
+  .strict()
+  .help()
+  .alias("h", "help")
+  .parse();

package/dist/browser.d.ts

@@ -0,0 +1,28 @@
+import type { ClientOptions, LogLevel } from './types';
+/**
+ * DrTrace client for browser environments.
+ *
+ * Unlike the Node.js client, this does NOT load configuration from files.
+ * All options must be passed explicitly to init().
+ */
+export declare class DrTrace {
+    private queue;
+    private logger;
+    private enabled;
+    private constructor();
+    /**
+     * Initialize DrTrace for browser environments.
+     * Unlike Node.js, browser does not load config from files.
+     * All options must be passed explicitly.
+     *
+     * @param opts - Client options (applicationId and daemonUrl are required)
+     * @throws Error if applicationId or daemonUrl are not provided
+     */
+    static init(opts: ClientOptions): DrTrace;
+    attachToConsole(): void;
+    detachFromConsole(): void;
+    log(message: string, level?: LogLevel, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    shutdown(): Promise<void>;
+}
+export * from './types';

package/dist/browser.js

@@ -0,0 +1,91 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrTrace = void 0;
+const transport_1 = require("./transport");
+const queue_1 = require("./queue");
+const logger_1 = require("./logger");
+/**
+ * DrTrace client for browser environments.
+ *
+ * Unlike the Node.js client, this does NOT load configuration from files.
+ * All options must be passed explicitly to init().
+ */
+class DrTrace {
+    constructor(opts) {
+        const transport = new transport_1.Transport({
+            daemonUrl: opts.daemonUrl,
+            maxRetries: opts.maxRetries ?? 3,
+            timeoutMs: 5000,
+        });
+        this.queue = new queue_1.LogQueue({
+            transport,
+            batchSize: opts.batchSize ?? 50,
+            flushIntervalMs: opts.flushIntervalMs ?? 1000,
+            maxQueueSize: opts.maxQueueSize ?? 10000,
+        });
+        this.queue.start();
+        this.enabled = opts.enabled ?? true;
+        this.logger = new logger_1.DrTraceLogger({
+            queue: this.queue,
+            applicationId: opts.applicationId,
+            moduleName: opts.moduleName,
+            logLevel: (opts.logLevel ?? 'info'),
+        });
+    }
+    /**
+     * Initialize DrTrace for browser environments.
+     * Unlike Node.js, browser does not load config from files.
+     * All options must be passed explicitly.
+     *
+     * @param opts - Client options (applicationId and daemonUrl are required)
+     * @throws Error if applicationId or daemonUrl are not provided
+     */
+    static init(opts) {
+        if (!opts.applicationId) {
+            throw new Error('applicationId is required for browser usage');
+        }
+        if (!opts.daemonUrl) {
+            throw new Error('daemonUrl is required for browser usage');
+        }
+        return new DrTrace(opts);
+    }
+    attachToConsole() {
+        if (!this.enabled)
+            return;
+        this.logger.attachToConsole();
+    }
+    detachFromConsole() {
+        this.logger.detachFromConsole();
+    }
+    log(message, level = 'info', context) {
+        if (!this.enabled)
+            return;
+        this.logger.log(level, message, context);
+    }
+    error(message, context) {
+        if (!this.enabled)
+            return;
+        this.logger.log('error', message, context);
+    }
+    async shutdown() {
+        await this.queue.flush();
+        this.queue.stop();
+        this.detachFromConsole();
+    }
+}
+exports.DrTrace = DrTrace;
+__exportStar(require("./types"), exports);

package/dist/config-schema.d.ts

@@ -5,7 +5,7 @@
 export interface DrTraceConfig {
     project_name: string;
     application_id: string;
-    language?: "python" | "javascript" | "both";
+    language?: "python" | "javascript" | "cpp" | "both";
     daemon_url?: string;
     enabled?: boolean;
     environments?: string[];
@@ -23,7 +23,7 @@ export declare class ConfigSchema {
     static getDefaultConfig(options: {
         project_name: string;
         application_id: string;
-        language?: "python" | "javascript" | "both";
+        language?: "python" | "javascript" | "cpp" | "both";
         daemon_url?: string;
         enabled?: boolean;
         environments?: string[];

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { DrTrace } from './client';
+export { DrTrace } from './node';
 export { loadConfig } from './config';
 export * from './types';

package/dist/index.js

@@ -15,8 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadConfig = exports.DrTrace = void 0;
-var client_1 = require("./client");
-Object.defineProperty(exports, "DrTrace", { enumerable: true, get: function () { return client_1.DrTrace; } });
+var node_1 = require("./node");
+Object.defineProperty(exports, "DrTrace", { enumerable: true, get: function () { return node_1.DrTrace; } });
 var config_1 = require("./config");
 Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
 __exportStar(require("./types"), exports);

package/dist/init.d.ts

@@ -12,6 +12,7 @@ export declare class ProjectInitializer {
     private projectRoot;
     private drtraceDir;
     private configPath;
+    private copiedAgentFiles;
     constructor(projectRoot?: string);
     /**
      * Run the interactive initialization workflow
@@ -34,7 +35,9 @@ export declare class ProjectInitializer {
      */
     private promptMultiSelect;
     /**
-     * Handle existing config
+     * Handle existing config - prompt user before overwriting
+     *
+     * Returns true if initialization should proceed, false if user declined.
      */
     private handleExistingConfig;
     /**
@@ -46,19 +49,58 @@ export declare class ProjectInitializer {
      */
     private generateEnvironmentConfigs;
     /**
-     * Copy agent spec to _drtrace/agents/
+     * Copy all agent files from packaged resources to _drtrace/agents/
+     * Copies everything from agents/ directory including:
+     * - Agent spec files (*.md)
+     * - Integration guides (integration-guides/*.md)
+     * - Any other files (README.md, CONTRIBUTING.md, etc.)
      */
     private copyAgentSpec;
+    /**
+     * Recursively copy all files from sourceDir to targetDir
+     * Returns list of relative file paths copied (for summary display)
+     */
+    private copyAgentsRecursive;
+    /**
+     * Copy framework-specific integration guides to _drtrace/agents/integration-guides/
+     * Dynamically discovers all .md files in agents/integration-guides/ directory
+     * Guides are stored in agents folder so agents can access them on client side
+     */
+    private copyFrameworkGuides;
+    /**
+     * Copy C++ header file to third_party/drtrace/ for C++ projects.
+     *
+     * This enables header-only integration:
+     *   - Header is copied to third_party/drtrace/drtrace_sink.hpp
+     *   - Users include it via #include "third_party/drtrace/drtrace_sink.hpp"
+     *   - Note: third_party/drtrace/ should be committed to git (unlike _drtrace/ which is gitignored)
+     */
+    private copyCppHeader;
+    /**
+     * Find drtrace_sink.hpp source file for header-only C++ integration.
+     *
+     * Search order:
+     *   1. npm package location: dist/resources/cpp/drtrace_sink.hpp (production mode)
+     *   2. Monorepo development layout: packages/cpp/drtrace-client/src/drtrace_sink.hpp
+     *   3. pip package location: site-packages/drtrace_service/.../packages/cpp/drtrace-client/src/drtrace_sink.hpp (if Python available)
+     *
+     * @returns Path to header file if found, null otherwise
+     */
+    private findCppHeaderSource;
     /**
      * Get default agent spec from shared agents/ or bundled resources
      *
      * Search order:
      *   1. Root repo agents/ directory (development)
      *   2. Bundled default agent from node_modules
+     *
+     * @param agentName - Name of the agent: "log-analysis", "log-it", "log-init", or "log-help"
      */
     private getDefaultAgentSpec;
     /**
      * Get bundled agent spec (fallback when root agents/ not available)
+     *
+     * @param agentName - Name of the agent: "log-analysis", "log-it", "log-init", or "log-help"
      */
     private getBundledAgentSpec;
     private generateEnvExample;