drtrace 0.1.0 → 0.3.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/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/init.d.ts

@@ -34,7 +34,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,16 +48,59 @@ 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;
     /**
-     * Get default agent spec
+     * Recursively copy all files from sourceDir to targetDir
+     */
+    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;
     /**
-     * Generate .env.example file
+     * 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;
     /**
      * Generate README.md