tauri-command

name	tauri-command
description	Scaffold a new Tauri command across Rust backend and TypeScript frontend with proper patterns.

Scaffold a new Tauri command with both Rust and TypeScript sides.

Input: Command name and purpose. Example: /tauri-command check_update "Check if CLI update is available"

Steps

1. Add the Rust command in src-tauri/src/lib.rs:

   • Add a #[tauri::command] function following existing patterns
   • Use proper Tauri state management (State<'_, SharedRunState> if run-related)
   • Return Result<T, String> for fallible commands
   • Register in the invoke_handler in run() function

2. If the command spawns a CLI process:

   • MUST use build_engine_command() from cmd_impl.rs — never bare Command::new()
   • This handles Windows .cmd PATH shim wrapping (cmd /C for .cmd files)
   • Respect the one-run-at-a-time mutex guard via SharedRunState

3. Add TypeScript bridge function in the appropriate location:

   • For engine operations: src/engine-bridge.ts
   • For utility operations: a new or existing file in src/lib/
   • Use import { invoke } from '@tauri-apps/api/core'
   • Type the return value to match the Rust response

4. Add capability permission if needed in src-tauri/capabilities/

5. Add the Tauri bridge mock in src/test/tauri-bridge-mock.ts for unit testing

Rust Pattern

#[tauri::command]
async fn my_command(arg: String) -> Result<MyResponse, String> {
    // For CLI execution, ALWAYS use build_engine_command():
    // let mut cmd = cmd_impl::build_engine_command(&exe, &args);
    Ok(MyResponse { /* ... */ })
}

TypeScript Pattern

import { invoke } from '@tauri-apps/api/core';

export async function myCommand(arg: string): Promise<MyResponse> {
  return invoke<MyResponse>('my_command', { arg });
}

Critical Landmine Windows .cmd PATH resolution: Rust's std::process::Command only resolves .exe files. The endstate.cmd shim requires cmd /C wrapping. All spawn sites MUST use build_engine_command() from cmd_impl.rs. Direct Command::new(exe) will silently fail when the CLI is a .cmd shim on PATH.

Protected Files Warning src/engine-bridge.ts and src-tauri/src/engine_adapter.rs are protected files. Modifications require explicit user instruction. If the new command needs changes there, flag this before proceeding.