Add bidirectional conversion between SQL files and @Sql annotations

CLAUDE.md

@@ -117,6 +117,28 @@ Action functionality for navigating between DAO files and SQL files
 Class names should have `Action` as a suffix.
 Classes should not have properties; necessary information should be obtained within functions.
 
+#### Intention Actions for SQL/Annotation Conversion
+
+**ConvertSqlFileToAnnotationAction**: Converts SQL file content to @Sql annotation
+- Extends `PsiElementBaseIntentionAction` for context-sensitive availability
+- Available when:
+  - Current file is a SQL file with corresponding DAO method
+  - DAO method doesn't have @Sql annotation
+  - DAO method has supported annotation (@Select, @Insert, @Update, @Delete, etc.) with sqlFile=true
+- Uses `SqlAnnotationConverter` to perform the conversion
+- Invoked via Alt+Enter on SQL file
+
+**ConvertSqlAnnotationToFileAction**: Converts @Sql annotation to SQL file
+- Extends `PsiElementBaseIntentionAction` for context-sensitive availability
+- Available when:
+  - Cursor is on a DAO method with @Sql annotation
+  - Method has supported annotation (@Select, @Insert, @Update, @Delete, etc.)
+- Uses `SqlAnnotationConverter` to perform the conversion
+- Creates SQL file in appropriate directory structure (META-INF/...)
+- Invoked via Alt+Enter on DAO method with @Sql annotation
+
+Both actions use `WriteCommandAction` to ensure changes are undoable and properly tracked by IntelliJ's local history.
+
 ### LineMarker
 Line marker functionality for DAO methods and DOMA directives in SQL
 

README.md

@@ -15,6 +15,19 @@ such as generating SQL template files, navigating between files, and inspecting
 
 # Features
 
+## Intention Action
+
+Provides Intention Action features for automatically generating SQL templates between SQL annotations and SQL files bidirectionally.
+
+- **Generate corresponding SQL file from SQL annotation on DAO method**
+  - When a DAO method has an `@Sql` annotation but the corresponding SQL template file does not exist, you can automatically generate it from the intention action (Alt+Enter).
+- **Generate corresponding SQL annotation from SQL file**
+  - When a SQL file exists but the corresponding DAO method doesn't have an `@Sql` annotation, you can automatically add the annotation from the intention action (Alt+Enter) on the SQL file.
+
+![IntentionAction](images/gif/IntentionAction.gif)
+
+This streamlines the association between DAOs and SQL files and makes template creation more efficient.
+
 ## Actions
 The plugin adds several actions and gutter icons.
 Shortcut keys can be used for these actions.

src/main/kotlin/org/domaframework/doma/intellij/action/dao/ConvertSqlAnnotationToFileAction.kt

@@ -0,0 +1,99 @@
+/*
+ * Copyright Doma Tools Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.domaframework.doma.intellij.action.dao
+
+import com.intellij.codeInsight.intention.PsiElementBaseIntentionAction
+import com.intellij.codeInsight.intention.preview.IntentionPreviewInfo
+import com.intellij.codeInsight.intention.preview.IntentionPreviewUtils
+import com.intellij.openapi.command.WriteCommandAction
+import com.intellij.openapi.editor.Editor
+import com.intellij.openapi.project.Project
+import com.intellij.psi.PsiElement
+import com.intellij.psi.PsiFile
+import com.intellij.psi.PsiMethod
+import com.intellij.psi.util.PsiTreeUtil
+import org.domaframework.doma.intellij.bundle.MessageBundle
+import org.domaframework.doma.intellij.common.psi.PsiDaoMethod
+import org.domaframework.doma.intellij.common.util.PluginLoggerUtil
+import org.domaframework.doma.intellij.extension.psi.DomaAnnotationType
+
+/**
+ * Intention action to convert @Sql annotation to SQL file
+ */
+class ConvertSqlAnnotationToFileAction : PsiElementBaseIntentionAction() {
+    override fun getFamilyName(): String = MessageBundle.message("convert.sql.annotation.to.file.family")
+
+    override fun getText(): String = MessageBundle.message("convert.sql.annotation.to.file.text")
+
+    override fun isAvailable(
+        project: Project,
+        editor: Editor?,
+        element: PsiElement,
+    ): Boolean {
+        val method = PsiTreeUtil.getParentOfType(element, PsiMethod::class.java) ?: return false
+        val psiDaoMethod = PsiDaoMethod(project, method)
+
+        // Check if method has @Sql annotation
+        if (!psiDaoMethod.useSqlAnnotation()) {
+            return false
+        }
+
+        // Check if method has @Insert, @Update, or @Delete annotation
+        val supportedTypes =
+            listOf(
+                DomaAnnotationType.Select,
+                DomaAnnotationType.Script,
+                DomaAnnotationType.SqlProcessor,
+                DomaAnnotationType.Insert,
+                DomaAnnotationType.Update,
+                DomaAnnotationType.Delete,
+                DomaAnnotationType.BatchInsert,
+                DomaAnnotationType.BatchUpdate,
+                DomaAnnotationType.BatchDelete,
+            )
+
+        return supportedTypes.any { it.getPsiAnnotation(method) != null }
+    }
+
+    override fun generatePreview(
+        project: Project,
+        editor: Editor,
+        file: PsiFile,
+    ): IntentionPreviewInfo = IntentionPreviewInfo.EMPTY
+
+    override fun invoke(
+        project: Project,
+        editor: Editor?,
+        element: PsiElement,
+    ) {
+        // Do nothing when previewing
+        if (IntentionPreviewUtils.isIntentionPreviewActive()) return
+        val method = PsiTreeUtil.getParentOfType(element, PsiMethod::class.java) ?: return
+
+        val startTime = System.nanoTime()
+        val converter = SqlAnnotationConverter(project, method)
+        WriteCommandAction.runWriteCommandAction(project) {
+            converter.convertToSqlFile()
+        }
+
+        PluginLoggerUtil.countLogging(
+            className = this::class.java.simpleName,
+            actionName = "convertSqlAnnotationToFile",
+            inputName = "IntentionAction",
+            start = startTime,
+        )
+    }
+}

src/main/kotlin/org/domaframework/doma/intellij/action/dao/ConvertSqlFileToAnnotationAction.kt

@@ -0,0 +1,102 @@
+/*
+ * Copyright Doma Tools Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.domaframework.doma.intellij.action.dao
+
+import com.intellij.codeInsight.intention.PsiElementBaseIntentionAction
+import com.intellij.codeInsight.intention.preview.IntentionPreviewUtils
+import com.intellij.openapi.command.WriteCommandAction
+import com.intellij.openapi.editor.Editor
+import com.intellij.openapi.project.Project
+import com.intellij.psi.PsiElement
+import org.domaframework.doma.intellij.bundle.MessageBundle
+import org.domaframework.doma.intellij.common.dao.findDaoMethod
+import org.domaframework.doma.intellij.common.isSupportFileType
+import org.domaframework.doma.intellij.common.psi.PsiDaoMethod
+import org.domaframework.doma.intellij.common.util.PluginLoggerUtil
+import org.domaframework.doma.intellij.extension.psi.DomaAnnotationType
+
+/**
+ * Intention action to convert SQL file to @Sql annotation
+ */
+class ConvertSqlFileToAnnotationAction : PsiElementBaseIntentionAction() {
+    override fun getFamilyName(): String = MessageBundle.message("convert.sql.file.to.annotation.family")
+
+    override fun getText(): String = MessageBundle.message("convert.sql.file.to.annotation.text")
+
+    override fun isAvailable(
+        project: Project,
+        editor: Editor?,
+        element: PsiElement,
+    ): Boolean {
+        if (!isSupportFileType(element.containingFile)) return false
+
+        val daoMethod = findDaoMethod(element.containingFile) ?: return false
+        val psiDaoMethod = PsiDaoMethod(project, daoMethod)
+
+        // Check if method doesn't have @Sql annotation
+        if (psiDaoMethod.useSqlAnnotation()) {
+            return false
+        }
+
+        // Check if method has @Insert, @Update, or @Delete annotation with sqlFile=true
+        val supportedTypes =
+            listOf(
+                DomaAnnotationType.Select,
+                DomaAnnotationType.Script,
+                DomaAnnotationType.SqlProcessor,
+                DomaAnnotationType.Insert,
+                DomaAnnotationType.Update,
+                DomaAnnotationType.Delete,
+                DomaAnnotationType.BatchInsert,
+                DomaAnnotationType.BatchUpdate,
+                DomaAnnotationType.BatchDelete,
+            )
+
+        val hasAnnotation =
+            supportedTypes.any { type ->
+                val annotation = type.getPsiAnnotation(daoMethod)
+                annotation != null
+            }
+
+        // Must have annotation with sqlFile=true and SQL file must exist
+        return hasAnnotation && psiDaoMethod.sqlFile != null
+    }
+
+    override fun invoke(
+        project: Project,
+        editor: Editor?,
+        element: PsiElement,
+    ) {
+        // Do nothing when previewing
+        if (IntentionPreviewUtils.isIntentionPreviewActive()) return
+        if (!isSupportFileType(element.containingFile)) return
+
+        val daoMethod = findDaoMethod(element.containingFile) ?: return
+
+        val startTime = System.nanoTime()
+        val converter = SqlAnnotationConverter(project, daoMethod)
+        WriteCommandAction.runWriteCommandAction(project) {
+            converter.convertToSqlAnnotation()
+        }
+
+        PluginLoggerUtil.countLogging(
+            className = this::class.java.simpleName,
+            actionName = "convertSqlFileToAnnotation",
+            inputName = "IntentionAction",
+            start = startTime,
+        )
+    }
+}