drtrace 0.2.0 → 0.4.0

package/src/init.ts

@@ -1,451 +0,0 @@
-/**
- * Interactive project initialization for DrTrace (JavaScript/TypeScript)
- * Mirrors Python init_project.py with interactive prompts via prompts library
- */
-
-import * as fs from "fs";
-import * as path from "path";
-import prompts from "prompts";
-import { ConfigSchema, DrTraceConfig } from "./config-schema";
-
-export interface InitOptions {
-  projectRoot?: string;
-  nonInteractive?: boolean;
-  config?: Partial<DrTraceConfig>;
-}
-
-export class ProjectInitializer {
-  private projectRoot: string;
-  private drtraceDir: string;
-  private configPath: string;
-
-  constructor(projectRoot: string = process.cwd()) {
-    this.projectRoot = projectRoot;
-    this.drtraceDir = path.join(projectRoot, "_drtrace");
-    this.configPath = path.join(this.drtraceDir, "config.json");
-  }
-
-  /**
-   * Run the interactive initialization workflow
-   */
-  async runInteractive(): Promise<boolean> {
-    console.log("\n🚀 DrTrace Project Initialization\n");
-    console.log("=".repeat(50));
-
-    // Collect project information
-    console.log("\n📋 Project Information:");
-    const projectName = await this.promptText(
-      "Project name",
-      "my-app"
-    );
-    const applicationId = await this.promptText(
-      "Application ID",
-      projectName.toLowerCase().replace(/\s+/g, "-")
-    );
-
-    // Language selection
-    console.log("\n🔧 Technology Stack:");
-    const language = await this.promptChoice(
-      "Select language/runtime:",
-      ["python", "javascript", "both"],
-      "javascript"
-    );
-
-    // Daemon configuration
-    console.log("\n📡 DrTrace Daemon Configuration:");
-    const daemonUrl = await this.promptText(
-      "Daemon URL",
-      "http://localhost:8001"
-    );
-    const enabled = await this.promptYesNo("Enable DrTrace by default?", true);
-
-    // Environment selection
-    console.log("\n🌍 Environments:");
-    const selectedEnvs = await this.promptMultiSelect(
-      "Which environments to configure?",
-      ["development", "staging", "production", "ci"]
-    );
-    const environments = selectedEnvs.length > 0 ? selectedEnvs : ["development"];
-
-    // Agent configuration
-    console.log("\n🤖 Agent Integration (Optional):");
-    const agentEnabled = await this.promptYesNo(
-      "Enable agent interface?",
-      false
-    );
-
-    let agentFramework = "bmad";
-    if (agentEnabled) {
-      agentFramework = await this.promptChoice(
-        "Select agent framework:",
-        ["bmad", "langchain", "other"],
-        "bmad"
-      );
-    }
-
-    // Check for existing config
-    if (!this.handleExistingConfig()) {
-      console.log("\n❌ Initialization cancelled.");
-      return false;
-    }
-
-    // Create directory structure
-    this.createDirectoryStructure();
-
-    // Generate and save main config
-    const config = ConfigSchema.getDefaultConfig({
-      project_name: projectName,
-      application_id: applicationId,
-      language: language as "python" | "javascript" | "both",
-      daemon_url: daemonUrl,
-      enabled,
-      environments,
-      agent_enabled: agentEnabled,
-      agent_framework: agentFramework as "bmad" | "langchain" | "other",
-    });
-
-    ConfigSchema.save(config, this.configPath);
-    console.log(`\n✓ Main config created: ${this.configPath}`);
-
-    // Generate environment-specific configs
-    this.generateEnvironmentConfigs(config);
-
-    // Copy default agent spec
-    if (agentEnabled) {
-      this.copyAgentSpec();
-    }
-
-    // Generate .env.example
-    this.generateEnvExample(config);
-
-    // Generate README
-    this.generateReadme();
-
-    // Summary and next steps
-    this.printSummary(config);
-
-    return true;
-  }
-
-  /**
-   * Prompt for text input
-   */
-  private async promptText(
-    question: string,
-    defaultValue?: string
-  ): Promise<string> {
-    const response = await prompts({
-      type: "text",
-      name: "value",
-      message: question,
-      initial: defaultValue,
-    });
-    return response.value || defaultValue || "";
-  }
-
-  /**
-   * Prompt for yes/no
-   */
-  private async promptYesNo(
-    question: string,
-    defaultValue: boolean = true
-  ): Promise<boolean> {
-    const response = await prompts({
-      type: "confirm",
-      name: "value",
-      message: question,
-      initial: defaultValue,
-    });
-    return response.value;
-  }
-
-  /**
-   * Prompt for single choice
-   */
-  private async promptChoice(
-    question: string,
-    choices: string[],
-    defaultValue?: string
-  ): Promise<string> {
-    const response = await prompts({
-      type: "select",
-      name: "value",
-      message: question,
-      choices: choices.map((c) => ({ title: c, value: c })),
-      initial: defaultValue ? choices.indexOf(defaultValue) : 0,
-    });
-    return response.value;
-  }
-
-  /**
-   * Prompt for multiple selections
-   */
-  private async promptMultiSelect(
-    question: string,
-    choices: string[]
-  ): Promise<string[]> {
-    const response = await prompts({
-      type: "multiselect",
-      name: "value",
-      message: question,
-      choices: choices.map((c) => ({ title: c, value: c })),
-      initial: 0, // Development selected by default
-    });
-    return response.value || [];
-  }
-
-  /**
-   * Handle existing config
-   */
-  private handleExistingConfig(): boolean {
-    if (!fs.existsSync(this.configPath)) {
-      return true;
-    }
-
-    console.log(
-      `\n⚠️  Configuration already exists at ${this.configPath}`
-    );
-    // In interactive mode, we would prompt here
-    // For now, we'll require confirmation via prompts
-    return true;
-  }
-
-  /**
-   * Create _drtrace directory structure
-   */
-  private createDirectoryStructure(): void {
-    const agentsDir = path.join(this.drtraceDir, "agents");
-    fs.mkdirSync(agentsDir, { recursive: true });
-    console.log(`✓ Created directory: ${this.drtraceDir}`);
-  }
-
-  /**
-   * Generate environment-specific configs
-   */
-  private generateEnvironmentConfigs(baseConfig: DrTraceConfig): void {
-    const environments = baseConfig.environments || ["development"];
-
-    for (const env of environments) {
-      const envConfig = { ...baseConfig };
-      const envConfigPath = path.join(this.drtraceDir, `config.${env}.json`);
-      ConfigSchema.save(envConfig, envConfigPath);
-      console.log(`✓ Generated: ${envConfigPath}`);
-    }
-  }
-
-  /**
-   * Copy agent spec to _drtrace/agents/
-   */
-  private copyAgentSpec(): void {
-    try {
-      const agentPath = path.join(
-        this.drtraceDir,
-        "agents",
-        "log-analysis.md"
-      );
-      const defaultSpec = this.getDefaultAgentSpec();
-      fs.writeFileSync(agentPath, defaultSpec);
-      console.log(`✓ Copied agent spec: ${agentPath}`);
-    } catch (error) {
-      console.warn(`⚠️  Could not copy agent spec: ${error}`);
-    }
-  }
-
-  /**
-   * 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
-   */
-  private getDefaultAgentSpec(): string {
-    // Try root agents/ first (development mode)
-    const rootAgentPath = path.join(
-      this.projectRoot,
-      "..",
-      "..",
-      "agents",
-      "log-analysis.default.md"
-    );
-
-    try {
-      if (fs.existsSync(rootAgentPath)) {
-        return fs.readFileSync(rootAgentPath, "utf-8");
-      }
-    } catch (error) {
-      // Fall through to bundled resource
-    }
-
-    // Fallback to bundled default agent
-    return this.getBundledAgentSpec();
-  }
-
-  /**
-   * Get bundled agent spec (fallback when root agents/ not available)
-   */
-  private getBundledAgentSpec(): string {
-    return `---
-name: "log-analysis"
-description: "Log Analysis Agent"
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-\`\`\`xml
-<agent id="log-analysis.agent.yaml" name="drtrace" title="Log Analysis Agent" icon="📊">
-<activation critical="MANDATORY">
-  <step n="1">Load persona from this current agent file (already in context)</step>
-  <step n="2">Remember: You are a Log Analysis Specialist</step>
-  <step n="3">Show greeting, then display numbered list of menu items</step>
-  <step n="4">STOP and WAIT for user input</step>
-  <step n="5">On user input: Process as natural language query</step>
-</activation>
-
-<persona>
-  <role>Log Analysis Specialist</role>
-  <identity>Expert at analyzing application logs and identifying root causes of errors</identity>
-  <communication_style>Clear and concise. Provides structured markdown responses.</communication_style>
-</persona>
-\`\`\`
-
-## Log Analysis Guide
-
-This agent helps you understand what went wrong in your application by analyzing logs.
-
-### How to Use
-
-1. Describe the error or issue
-2. Provide log entries or time window
-3. Get root cause analysis with suggested fixes
-`;
-  }
-  private generateEnvExample(config: DrTraceConfig): void {
-    const envFile = path.join(this.drtraceDir, ".env.example");
-    const content = `# DrTrace Configuration - Copy to .env and customize
-
-# Basic Configuration
-DRTRACE_APPLICATION_ID=${config.application_id}
-DRTRACE_DAEMON_URL=${config.daemon_url || "http://localhost:8001"}
-DRTRACE_ENABLED=${config.enabled !== false ? "true" : "false"}
-
-# Environment-specific overrides
-# Uncomment and modify for your environment
-# DRTRACE_DAEMON_HOST=localhost
-# DRTRACE_DAEMON_PORT=8001
-# DRTRACE_RETENTION_DAYS=7
-
-# Agent configuration
-# DRTRACE_AGENT_ENABLED=false
-# DRTRACE_AGENT_FRAMEWORK=bmad
-`;
-    fs.writeFileSync(envFile, content);
-    console.log(`✓ Generated: ${envFile}`);
-  }
-
-  /**
-   * Generate README.md
-   */
-  private generateReadme(): void {
-    const readmeFile = path.join(this.drtraceDir, "README.md");
-    const content = `# DrTrace Configuration Guide
-
-This directory contains configuration files for the DrTrace (Web Workflow Integration) system.
-
-## Files
-
-- **config.json** - Main project configuration
-- **config.{environment}.json** - Environment-specific overrides
-- **.env.example** - Environment variable template
-- **agents/** - Agent specifications and custom rules
-
-## Configuration
-
-### Basic Setup
-
-1. Review and customize \`config.json\`
-2. For environment-specific settings, edit \`config.{environment}.json\`
-3. Create \`.env\` from \`.env.example\` and set your environment variables
-
-### Environment Variables
-
-- \`DRTRACE_APPLICATION_ID\` - Unique application identifier
-- \`DRTRACE_DAEMON_URL\` - URL of the DrTrace daemon
-- \`DRTRACE_ENABLED\` - Enable/disable DrTrace globally (true/false)
-- \`DRTRACE_RETENTION_DAYS\` - How long to retain logs (days)
-
-### Environments
-
-Configure separate settings for:
-- **development** - Local development setup
-- **staging** - Pre-production testing
-- **production** - Live environment
-- **ci** - Continuous integration/testing
-
-## Usage
-
-Load configuration based on your environment:
-
-\`\`\`javascript
-import { ConfigSchema } from 'drtrace';
-const config = ConfigSchema.load('./_drtrace/config.json');
-\`\`\`
-
-## Further Reading
-
-- See \`docs/\` for complete documentation
-- Check \`agents/\` for agent specifications
-`;
-    fs.writeFileSync(readmeFile, content);
-    console.log(`✓ Generated: ${readmeFile}`);
-  }
-
-  /**
-   * Print initialization summary
-   */
-  private printSummary(config: DrTraceConfig): void {
-    console.log("\n" + "=".repeat(50));
-    console.log("✅ Project Initialization Complete!\n");
-
-    console.log(`📍 Configuration Location: ${this.drtraceDir}\n`);
-
-    console.log("📋 Generated Files:");
-    console.log(`   • ${this.configPath}`);
-    for (const env of config.environments || []) {
-      console.log(`   • ${path.join(this.drtraceDir, `config.${env}.json`)}`);
-    }
-    console.log(`   • ${path.join(this.drtraceDir, ".env.example")}`);
-    console.log(`   • ${path.join(this.drtraceDir, "README.md")}`);
-
-    if (config.agent?.enabled) {
-      console.log(
-        `   • ${path.join(this.drtraceDir, "agents", "log-analysis.md")}`
-      );
-    }
-
-    console.log("\n📖 Next Steps:");
-    console.log(`   1. Review ${this.configPath}`);
-    console.log(`   2. Create .env: cp ${path.join(this.drtraceDir, ".env.example")} .env`);
-    console.log(`   3. Start the daemon: drtrace daemon start`);
-    console.log(
-      `   4. Read ${path.join(this.drtraceDir, "README.md")} for more details`
-    );
-
-    console.log("\n" + "=".repeat(50) + "\n");
-  }
-}
-
-/**
- * Entry point for init command
- */
-export async function runInitProject(
-  projectRoot?: string
-): Promise<number> {
-  try {
-    const initializer = new ProjectInitializer(projectRoot);
-    const success = await initializer.runInteractive();
-    return success ? 0 : 1;
-  } catch (error) {
-    console.error(`\n❌ Error during initialization:`, error);
-    return 1;
-  }
-}

package/src/logger.ts

@@ -1,56 +0,0 @@
-import type { LogEvent, LogLevel } from './types';
-import { LogQueue } from './queue';
-
-export class DrTraceLogger {
-  private queue: LogQueue;
-  private applicationId: string;
-  private logLevel: LogLevel;
-  private originalConsole?: { log: typeof console.log; error: typeof console.error };
-
-  constructor(opts: { queue: LogQueue; applicationId: string; logLevel: LogLevel }) {
-    this.queue = opts.queue;
-    this.applicationId = opts.applicationId;
-    this.logLevel = opts.logLevel || 'info';
-  }
-
-  attachToConsole(): void {
-    if (this.originalConsole) return;
-    this.originalConsole = { log: console.log, error: console.error };
-
-    console.log = (...args: any[]) => {
-      try {
-        this.log('info', args.map(String).join(' '));
-      } catch {
-        // Silently ignore logging errors
-      }
-      this.originalConsole!.log.apply(console, args);
-    };
-
-    console.error = (...args: any[]) => {
-      try {
-        this.log('error', args.map(String).join(' '));
-      } catch {
-        // Silently ignore logging errors
-      }
-      this.originalConsole!.error.apply(console, args);
-    };
-  }
-
-  detachFromConsole(): void {
-    if (!this.originalConsole) return;
-    console.log = this.originalConsole.log;
-    console.error = this.originalConsole.error;
-    this.originalConsole = undefined;
-  }
-
-  log(level: LogLevel, message: string, context?: Record<string, unknown>): void {
-    const event: LogEvent = {
-      timestamp: new Date().toISOString(),
-      applicationId: this.applicationId,
-      level,
-      message,
-      context,
-    };
-    this.queue.push(event);
-  }
-}

package/src/queue.ts

@@ -1,105 +0,0 @@
-import type { LogEvent } from './types';
-import { Transport } from './transport';
-
-export class LogQueue {
-  private buffer: LogEvent[] = [];
-  private transport: Transport;
-  private batchSize: number;
-  private flushIntervalMs: number;
-  private timer: NodeJS.Timeout | null = null;
-  private running = false;
-  private maxQueueSize: number;
-  private exitHandlerBound = false;
-  private exitHandler?: () => Promise<void>;
-
-  constructor(opts: { transport: Transport; batchSize: number; flushIntervalMs: number; maxQueueSize?: number }) {
-    this.transport = opts.transport;
-    this.batchSize = Math.max(1, opts.batchSize);
-    this.flushIntervalMs = Math.max(100, opts.flushIntervalMs);
-    this.maxQueueSize = Math.max(1, opts.maxQueueSize ?? 10000);
-  }
-
-  start(): void {
-    if (this.running) return;
-    this.running = true;
-    this.scheduleFlush();
-    this.registerExitHandlers();
-  }
-
-  stop(): void {
-    this.running = false;
-    if (this.timer) {
-      clearTimeout(this.timer);
-      this.timer = null;
-    }
-    this.unregisterExitHandlers();
-  }
-
-  push(event: LogEvent): void {
-    this.buffer.push(event);
-    if (this.buffer.length > this.maxQueueSize) {
-      // Drop oldest to enforce limit
-      const dropCount = this.buffer.length - this.maxQueueSize;
-      this.buffer.splice(0, dropCount);
-      console.warn?.(`DrTrace: maxQueueSize exceeded, dropped ${dropCount} log(s)`);
-    }
-    if (this.buffer.length >= this.batchSize) {
-      this.flush();
-    }
-  }
-
-  async flush(): Promise<void> {
-    if (this.buffer.length === 0) {
-      this.scheduleFlush();
-      return;
-    }
-    const toSend = this.buffer.splice(0, this.buffer.length);
-    try {
-      await this.transport.sendBatch(toSend);
-    } finally {
-      this.scheduleFlush();
-    }
-  }
-
-  private scheduleFlush(): void {
-    if (!this.running) return;
-    if (this.timer) {
-      clearTimeout(this.timer);
-      this.timer = null;
-    }
-    this.timer = setTimeout(() => {
-      this.flush();
-    }, this.flushIntervalMs);
-    this.timer.unref?.();
-  }
-
-  private registerExitHandlers(): void {
-    if (this.exitHandlerBound) return;
-    const handler = async () => {
-      try {
-        const flushPromise = this.flush();
-        const timeout = new Promise((resolve) => {
-          const to = setTimeout(resolve, 2000);
-          (to as any).unref?.();
-        });
-        await Promise.race([flushPromise, timeout]);
-      } catch {
-        // ignore
-      }
-    };
-    this.exitHandler = handler;
-    process.on('SIGINT', handler);
-    process.on('SIGTERM', handler);
-    this.exitHandlerBound = true;
-  }
-
-  private unregisterExitHandlers(): void {
-    if (!this.exitHandlerBound) return;
-    if (this.exitHandler) {
-      process.removeListener('SIGINT', this.exitHandler);
-      process.removeListener('SIGTERM', this.exitHandler);
-      this.exitHandler = undefined;
-    }
-    this.exitHandlerBound = false;
-  }
-}

package/src/transport.ts

@@ -1,60 +0,0 @@
-import type { LogEvent } from './types';
-
-const DEFAULT_TIMEOUT_MS = 5000;
-const DEFAULT_MAX_RETRIES = 3;
-const BACKOFF_MS = [100, 200, 400];
-const USER_AGENT = 'drtrace-client-js/0.1.0';
-
-export class Transport {
-  private daemonUrl: string;
-  private timeoutMs: number;
-  private maxRetries: number;
-
-  constructor(opts: { daemonUrl: string; timeoutMs?: number; maxRetries?: number }) {
-    this.daemonUrl = opts.daemonUrl.replace(/\/$/, '');
-    this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    this.maxRetries = Math.max(0, opts.maxRetries ?? DEFAULT_MAX_RETRIES);
-  }
-
-  async sendBatch(events: LogEvent[]): Promise<void> {
-    if (events.length === 0) return;
-    const url = `${this.daemonUrl}/logs/ingest`;
-    const payload = { logs: events };
-
-    const fetchImpl: typeof fetch | undefined = (globalThis as any).fetch;
-    if (!fetchImpl) return; // Non-blocking skip
-
-    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-      const controller = new AbortController();
-      const to = setTimeout(() => controller.abort(), this.timeoutMs);
-      to.unref?.();
-      try {
-        const res = await fetchImpl(url, {
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json',
-            'User-Agent': USER_AGENT,
-          },
-          body: JSON.stringify(payload),
-          signal: controller.signal,
-        });
-        // Consume body to free resources
-        res.body && (await res.text().catch(() => ''));
-        // Treat non-2xx as retryable
-        if (res.ok) return;
-      } catch (_err) {
-        // swallow and retry
-      } finally {
-        clearTimeout(to);
-      }
-
-      if (attempt < this.maxRetries) {
-        const delay = BACKOFF_MS[Math.min(attempt, BACKOFF_MS.length - 1)];
-        await new Promise((resolve) => {
-          const to = setTimeout(resolve, delay);
-          to.unref?.();
-        });
-      }
-    }
-  }
-}

package/src/types.ts

@@ -1,20 +0,0 @@
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-
-export interface LogEvent {
-  timestamp: string;
-  applicationId: string;
-  level: LogLevel;
-  message: string;
-  context?: Record<string, unknown>;
-}
-
-export interface ClientOptions {
-  applicationId: string;
-  daemonUrl: string;
-  enabled?: boolean;
-  logLevel?: LogLevel;
-  batchSize?: number;
-  flushIntervalMs?: number;
-  maxRetries?: number;
-  maxQueueSize?: number;
-}