tabularis-plugin-driver

Tabularis Plugin Driver

Use this skill when building or updating a database plugin for Tabularis.

The skill is optimized for this repository. Follow AGENTS.md, the files in .rules/, and the current plugin-system behavior in src-tauri/src/plugins/ and src/types/plugins.ts.

Goals

• Build a Rust plugin that speaks Tabularis JSON-RPC over stdin/stdout
• Use the modern plugin manifest, not the old minimal format
• Aim for broad feature coverage comparable to the built-in MySQL driver where the target database supports it
• Keep the plugin modular instead of concentrating logic in a single main.rs
• Add unit tests for pure utilities and SQL generation

Default Repo Layout

Prefer this structure for a new plugin repository:

plugin-root/
├── Cargo.toml
├── manifest.json
├── README.md
├── src/
│   ├── main.rs
│   ├── rpc.rs
│   ├── client.rs
│   ├── error.rs
│   ├── models.rs
│   ├── handlers/
│   │   ├── mod.rs
│   │   ├── metadata.rs
│   │   ├── query.rs
│   │   ├── crud.rs
│   │   └── ddl.rs
│   └── utils/
│       ├── mod.rs
│       ├── identifiers.rs
│       ├── values.rs
│       ├── types.rs
│       └── pagination.rs
├── src/bin/
│   └── test_plugin.rs
└── tests/                # only if integration tests are worth the overhead

Keep src/main.rs thin. It should mostly parse requests, dispatch methods, and serialize responses.

Required Research Before Coding

1. Read the current plugin manifest shape in:
   • plugins/manifest.schema.json
   • src/types/plugins.ts
   • src-tauri/src/plugins/manager.rs
2. Read the JSON-RPC expectations in:
   • plugins/PLUGIN_GUIDE.md
   • src-tauri/src/plugins/driver.rs
   • src-tauri/src/plugins/rpc.rs
3. Read a built-in driver with broad coverage to understand expected behaviors:
   • src-tauri/src/drivers/mysql/mod.rs
4. Read plugin-loading behavior and modern feature flags in:
   • src/hooks/useDrivers.ts
   • src/utils/connectionStringParser.ts
   • src/utils/driverCapabilities.ts