tauri-plugin-debug-tools 0.1.0 → 0.1.2

package/AGENTS.md

@@ -50,7 +50,7 @@ tauri-plugin-debug-tools/
 - **Stack Trace Normalization**: Filters internal frames
 - **Zero Dependencies**: No Safari DevTools required
 
-**Key Design Decision**: Logs are collected in-memory on the frontend and periodically flushed to the system temp directory (for example, `/tmp/tauri_console_logs.jsonl`) via Tauri IPC. This avoids blocking the main thread and provides resilience against IPC failures.
+**Key Design Decision**: Logs are collected in-memory on the frontend and periodically flushed to `/tmp` directory (for example, `/tmp/tauri_console_logs_app_name_12345.jsonl`) via Tauri IPC. This avoids blocking the main thread and provides resilience against IPC failures.
 
 ### 2. Event-Based Debug Commands
 
@@ -212,7 +212,7 @@ For cross-platform support:
 ```rust
 // Use this instead of "/tmp/"
 let temp_dir = std::env::temp_dir();
-let log_path = temp_dir.join("tauri_console_logs.jsonl");
+let log_path = temp_dir.join(format!("tauri_console_logs_{}_{}.jsonl", app_name, pid));
 ```
 
 ### Performance Considerations
@@ -266,7 +266,7 @@ When making changes, verify:
 - [ ] Plugin registers in host app without errors
 - [ ] IPC commands return expected results
 - [ ] Console logger captures logs correctly
-- [ ] Logs flush to system temp dir (for example, `/tmp/tauri_console_logs.jsonl`)
+- [ ] Logs flush to `/tmp` (for example, `/tmp/tauri_console_logs_app_name_12345.jsonl`)
 - [ ] Agent skill can be invoked (`/debug-tauri`)
 - [ ] Screenshot capture works (macOS)
 
@@ -342,5 +342,5 @@ For questions or issues:
 ---
 
 **Last Updated**: 2025-12-31
-**Version**: 0.1.0
+**Version**: 0.1.1
 **Maintainer**: (your name/team)

package/README.md

@@ -19,7 +19,7 @@ Add to your Tauri project's `Cargo.toml`:
 
 ```toml
 [dependencies]
-tauri-plugin-debug-tools = "0.1.0"
+tauri-plugin-debug-tools = "0.1.1"
 ```
 
 Install the frontend package:
@@ -139,9 +139,32 @@ All commands are available through the Tauri IPC system:
 | `capture_webview_state` | Capture WebView state | `WebViewState` JSON |
 | `get_console_logs` | Legacy console logs | Empty array (use frontend logger) |
 | `send_debug_command` | Send event to frontend | Success message |
-| `append_debug_logs` | Append logs to file | System temp dir (e.g., `/tmp/tauri_console_logs.jsonl`) |
-| `reset_debug_logs` | Clear log file | File path |
-| `write_debug_snapshot` | Save debug snapshot | System temp dir (e.g., `/tmp/tauri_debug_snapshot_*.json`) |
+| `append_debug_logs` | Append logs to file | Returns actual file path string |
+| `reset_debug_logs` | Clear log file | Returns actual file path string |
+| `write_debug_snapshot` | Save debug snapshot | Returns actual file path string |
+
+#### Finding Log File Locations
+
+Both `reset_debug_logs` and `append_debug_logs` commands return the actual file path where logs are stored:
+
+```typescript
+import { invoke } from '@tauri-apps/api/core';
+
+// Get log file path
+const logPath = await invoke('plugin:debug-tools|reset_debug_logs');
+console.log('Logs are stored at:', logPath);
+// Example output: "/tmp/tauri_console_logs_hoge_12345.jsonl"
+```
+
+**Platform-specific locations:**
+
+- **macOS**: `/tmp/tauri_console_logs_[app_name]_[pid].jsonl`
+- **Linux**: `/tmp/tauri_console_logs_[app_name]_[pid].jsonl`
+- **Windows**: `%TEMP%\tauri_console_logs_[app_name]_[pid].jsonl` (e.g., `C:\Users\...\AppData\Local\Temp\`)
+
+Where `[app_name]` is the application name from `package_info` and `[pid]` is the process ID.
+
+The exact path is determined by Rust's `std::env::temp_dir()` and may vary between systems.
 
 ## AI Agent Skill
 
@@ -233,7 +256,7 @@ flowchart TB
             CL -->|"Batch flush"| Plugin
         end
 
-        FS["File System<br/>Temp dir (logs & snapshots)<br/>e.g., /tmp/tauri_console_logs.jsonl"]
+        FS["File System<br/>Temp dir (logs & snapshots)<br/>e.g., /tmp/tauri_console_logs_app_12345.jsonl"]
 
         Plugin -->|"Write logs & snapshots"| FS
     end

package/examples/src-tauri/Cargo.lock

@@ -1004,7 +1004,7 @@ dependencies = [
 
 [[package]]
 name = "examples-demo-app"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "serde",
  "serde_json",
@@ -3961,7 +3961,7 @@ dependencies = [
 
 [[package]]
 name = "tauri-plugin-debug-tools"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "serde",
  "serde_json",

package/examples/src-tauri/Cargo.toml

@@ -1,8 +1,10 @@
 [package]
 name = "examples-demo-app"
-version = "0.1.0"
+version = "0.1.2"
 description = "A Tauri App"
-authors = ["you"]
+authors = ["8beeeaaat <8beeeaaat@gmail.com>"]
+license = "MIT OR Apache-2.0"
+repository = "https://github.com/8beeeaaat/tauri-plugin-debug-tools"
 edition = "2021"
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

package/examples/tests/e2e.mac.test.ts

@@ -175,7 +175,7 @@ suite("Tauri E2E (Appium Mac2)", () => {
         throw new Error("debug-reset-logs not found");
       }
       await resetLogs.click();
-      await waitForSourceIncludes("tauri_console_logs.jsonl", 20_000);
+      await waitForSourceIncludes("tauri_console_logs_", 20_000);
 
       const appendLogs = await waitForLocator(
         "debug-append-logs",
@@ -185,7 +185,7 @@ suite("Tauri E2E (Appium Mac2)", () => {
         throw new Error("debug-append-logs not found");
       }
       await appendLogs.click();
-      await waitForSourceIncludes("tauri_console_logs.jsonl", 20_000);
+      await waitForSourceIncludes("tauri_console_logs_", 20_000);
 
       const snapshot = await waitForLocator(
         "debug-write-snapshot",

package/examples/tests/e2e.test.ts

@@ -107,14 +107,14 @@ suite("Tauri E2E (tauri-driver)", () => {
     const resetLogs = await driver.findElement(By.id("debug-reset-logs"));
     await resetLogs.click();
     await driver.wait(
-      until.elementTextContains(logsOutput, "tauri_console_logs.jsonl"),
+      until.elementTextContains(logsOutput, "tauri_console_logs_"),
       10_000,
     );
 
     const appendLogs = await driver.findElement(By.id("debug-append-logs"));
     await appendLogs.click();
     await driver.wait(
-      until.elementTextContains(logsOutput, "tauri_console_logs.jsonl"),
+      until.elementTextContains(logsOutput, "tauri_console_logs_"),
       10_000,
     );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tauri-plugin-debug-tools",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Comprehensive debug utilities for Tauri WebView applications with AI-powered automated debugging workflows",
   "license": "MIT OR Apache-2.0",
   "author": "8beeeaaat <8beeeaaat@gmail.com>",
@@ -80,5 +80,10 @@
     "npm-run-all": "^4.1.5",
     "typescript": "^5.9.3",
     "vitest": "^4.0.16"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org"
   }
 }

package/skills/debug-tauri/SKILL.md

@@ -55,7 +55,39 @@ const imagePath = await captureMainWindow();
 
 ### Step 3: Collect Console Logs
 
-**Automatic Collection (Recommended)**:
+**Console Logger (Frontend - Recommended)**:
+
+The `consoleLogger` automatically collects frontend logs and errors in a ring buffer and flushes them to a temp file.
+
+```typescript
+// Import at app entry point to initialize automatic collection
+import "tauri-plugin-debug-tools/consoleLogger";
+
+// Use debugTools for explicit logging
+import { debugTools } from "tauri-plugin-debug-tools/consoleLogger";
+debugTools.log("App started");
+debugTools.error("Something went wrong");
+```
+
+**Finding consoleLogger Log Files**:
+
+```typescript
+import { invoke } from '@tauri-apps/api/core';
+
+// Get actual log file path
+const logPath = await invoke('plugin:debug-tools|reset_debug_logs');
+console.log('Console logs stored at:', logPath);
+```
+
+**Platform-specific consoleLogger locations**:
+
+- **macOS**: `/tmp/tauri_console_logs_[app_name]_[pid].jsonl`
+- **Linux**: `/tmp/tauri_console_logs_[app_name]_[pid].jsonl`
+- **Windows**: `%TEMP%\tauri_console_logs_[app_name]_[pid].jsonl`
+
+Where `[app_name]` is the application name and `[pid]` is the process ID.
+
+**Backend Logs (tauri-plugin-log)**:
 
 ```typescript
 import { logger } from "tauri-plugin-debug-tools/logAdapter";
@@ -68,7 +100,7 @@ logger.info("App started");
 logger.error("Something went wrong");
 ```
 
-**Log Locations**:
+**Backend log locations**:
 
 - **macOS**: `~/Library/Logs/{bundle_id}/debug.log`
 - **Linux**: `~/.local/share/{bundle_id}/logs/debug.log`

package/skills/debug-tauri/references/TROUBLESHOOTING.md

@@ -66,7 +66,7 @@ initConsoleLogger();
 **Option 2**: Check log file exists
 
 ```bash
-ls -lh /tmp/tauri_console_logs.jsonl
+ls -lh /tmp/tauri_console_logs_*.jsonl
 ```
 
 **Option 3**: Use IPC method
@@ -140,5 +140,5 @@ If issues persist:
 
 **Log output:**
 
-- `/tmp/tauri_console_logs.jsonl` (default)
+- `/tmp/tauri_console_logs_[app_name]_[pid].jsonl`
 - `/tmp/tauri_debug_*.png` (screenshots)

package/skills/debug-tauri/scripts/validate_setup.sh

@@ -98,8 +98,9 @@ fi
 # Check for legacy log file
 echo ""
 echo "📝 Legacy Logs (consoleLogger):"
-if [ -f "/tmp/tauri_console_logs.jsonl" ]; then
-  log_size=$(wc -l < /tmp/tauri_console_logs.jsonl | tr -d ' ')
+if compgen -G "/tmp/tauri_console_logs_*.jsonl" > /dev/null; then
+  log_file=$(ls -t /tmp/tauri_console_logs_*.jsonl 2>/dev/null | head -1)
+  log_size=$(wc -l < "$log_file" | tr -d ' ')
   echo "  ⚠️  Legacy log file exists ($log_size lines)"
   echo "  💡 Migrate to tauri-plugin-log for better persistence"
 else

package/src/commands.rs

@@ -32,9 +32,18 @@ pub struct ConsoleLogEntryPayload {
     pub stack_trace: Option<String>,
 }
 
-fn console_log_path() -> PathBuf {
-    // Use platform temp directory to avoid hardcoded /tmp paths.
-    std::env::temp_dir().join("tauri_console_logs.jsonl")
+fn console_log_path<R: Runtime>(app: &AppHandle<R>) -> PathBuf {
+    // Get application name from AppHandle
+    let app_name = app.package_info().name.replace(" ", "_");
+    // Get current process ID
+    let pid = std::process::id();
+    // Use /tmp on Unix-like systems, temp_dir() on Windows
+    #[cfg(unix)]
+    let base_dir = PathBuf::from("/tmp");
+    #[cfg(not(unix))]
+    let base_dir = std::env::temp_dir();
+
+    base_dir.join(format!("tauri_console_logs_{}_{}.jsonl", app_name, pid))
 }
 
 /// Get WebView state.
@@ -97,12 +106,15 @@ pub async fn send_debug_command<R: Runtime>(
 
 /// Append console logs to /tmp.
 #[tauri::command]
-pub async fn append_debug_logs(logs: Vec<ConsoleLogEntryPayload>) -> Result<String, String> {
+pub async fn append_debug_logs<R: Runtime>(
+    app: AppHandle<R>,
+    logs: Vec<ConsoleLogEntryPayload>,
+) -> Result<String, String> {
     if logs.is_empty() {
         return Ok("no logs".to_string());
     }
 
-    let path = console_log_path();
+    let path = console_log_path(&app);
     let mut file = std::fs::OpenOptions::new()
         .create(true)
         .append(true)
@@ -121,8 +133,8 @@ pub async fn append_debug_logs(logs: Vec<ConsoleLogEntryPayload>) -> Result<Stri
 
 /// Reset the console log file.
 #[tauri::command]
-pub async fn reset_debug_logs() -> Result<String, String> {
-    let path = console_log_path();
+pub async fn reset_debug_logs<R: Runtime>(app: AppHandle<R>) -> Result<String, String> {
+    let path = console_log_path(&app);
     std::fs::OpenOptions::new()
         .create(true)
         .write(true)