A Terraform provider for Dokploy

Plugin-framework provider covering projects, environments, applications,
Compose stacks, managed databases, domains, mounts, ports, redirects,
basic auth, registries, SSH keys, certificates and backup destinations,
over Dokploy's tRPC-over-REST API.

The shim package exposes the provider to other Go modules, which is how
pulumi-dokploy bridges it.

.agents/skills/terraform-search-import/references/MANUAL-IMPORT.md

@@ -0,0 +1,113 @@
+# Manual Terraform Import Reference
+
+Use this workflow when your target resource type isn't supported by Terraform Search.
+
+## 1. Discover Resources Using Provider CLI
+
+AWS CLI examples:
+
+```bash
+# RDS instances (not yet supported by Terraform Search)
+aws rds describe-db-instances --query 'DBInstances[].DBInstanceIdentifier'
+
+# DynamoDB tables (not yet supported by Terraform Search)
+aws dynamodb list-tables --query 'TableNames[]'
+
+# API Gateway REST APIs (not yet supported by Terraform Search)
+aws apigateway get-rest-apis --query 'items[].id'
+
+# SNS topics (not yet supported by Terraform Search)
+aws sns list-topics --query 'Topics[].TopicArn'
+```
+
+## 2. Create Resource Blocks Manually
+
+```hcl
+# Example for RDS instance
+resource "aws_db_instance" "existing_db" {
+  identifier = "my-existing-db"
+  # Add other required attributes
+}
+
+# Example for DynamoDB table
+resource "aws_dynamodb_table" "existing_table" {
+  name = "my-existing-table"
+  # Add other required attributes
+}
+
+# Example for SNS topic
+resource "aws_sns_topic" "existing_topic" {
+  name = "my-existing-topic"
+}
+```
+
+## 3. Create Import Blocks (Config-Driven Import)
+
+```hcl
+# Example for RDS instance
+resource "aws_db_instance" "existing_db" {
+  identifier = "my-existing-db"
+  # Add other required attributes
+}
+
+import {
+  to = aws_db_instance.existing_db
+  id = "my-existing-db"
+}
+
+# Example for DynamoDB table
+resource "aws_dynamodb_table" "existing_table" {
+  name = "my-existing-table"
+  # Add other required attributes
+}
+
+import {
+  to = aws_dynamodb_table.existing_table
+  id = "my-existing-table"
+}
+```
+
+## 4. Run Import Plan
+
+```bash
+# Plan the import to see what will happen
+terraform plan
+
+# Apply to import the resources
+terraform apply
+```
+
+## Bulk Import Script Example
+
+For multiple resources of the same type:
+
+```bash
+#!/bin/bash
+# bulk-import-dynamodb.sh
+
+# Get all table names
+tables=$(aws dynamodb list-tables --query 'TableNames[]' --output text)
+
+# Generate import configuration
+cat > dynamodb-imports.tf << 'EOF'
+# DynamoDB Table Resources and Imports
+EOF
+
+for table in $tables; do
+  # Create resource and import blocks
+  cat >> dynamodb-imports.tf << EOF
+resource "aws_dynamodb_table" "table_${table//[-.]/_}" {
+  name = "$table"
+}
+
+import {
+  to = aws_dynamodb_table.table_${table//[-.]/_}
+  id = "$table"
+}
+
+EOF
+done
+
+echo "Generated dynamodb-imports.tf with import blocks"
+echo "Run 'terraform plan' to review, then 'terraform apply' to import"
+```