feat(#556): auto-fix architecture

src/main/java/org/eolang/lints/Defect.java

@@ -6,6 +6,7 @@
 
 import com.jcabi.manifests.Manifests;
 import java.util.Objects;
+import org.eolang.lints.fix.Fix;
 
 /**
  * A single defect found.
@@ -102,6 +103,13 @@ public interface Defect {
      */
     boolean experimental();
 
+    /**
+     * Information on how to fix this defect.
+     *
+     * @return Fix info.
+     */
+    Fix fix();
+
     /**
      * Default implementation of {@link Defect}.
      * <p>
@@ -142,6 +150,11 @@ final class Default implements Defect {
          */
         private final boolean experiment;
 
+        /**
+         * How to fix.
+         */
+        private final Fix fix;
+
         /**
          * Ctor.
          * @param rule Rule name
@@ -155,7 +168,7 @@ public Default(
             final String rule, final Severity severity,
             final String object, final int line, final String text
         ) {
-            this(rule, severity, object, line, text, false);
+            this(rule, severity, object, line, text, false, new Fix());
         }
 
         /**
@@ -175,14 +188,15 @@ public Default(
         public Default(
             final String rule, final Severity severity,
             final String object, final int line, final String text,
-            final boolean exprmnt
+            final boolean exprmnt, final Fix fix
         ) {
             this.rle = rule;
             this.sev = severity;
             this.oname = object;
             this.lineno = line;
             this.txt = text;
             this.experiment = exprmnt;
+            this.fix = fix;
         }
 
         @Override
@@ -237,6 +251,11 @@ public boolean experimental() {
             return this.experiment;
         }
 
+        @Override
+        public Fix fix() {
+            return this.fix;
+        }
+
         @Override
         public boolean equals(final Object obj) {
             final boolean result;

src/main/java/org/eolang/lints/DfContext.java

@@ -4,6 +4,8 @@
  */
 package org.eolang.lints;
 
+import org.eolang.lints.fix.Fix;
+
 /**
  * Defect with context.
  * @since 0.0.40
@@ -60,6 +62,11 @@ public String version() {
         return this.origin.version();
     }
 
+    @Override
+    public Fix fix() {
+        return this.origin.fix();
+    }
+
     @Override
     public String context() {
         return this.ctxt.replace("&lt;", "<")

src/main/java/org/eolang/lints/LtByXsl.java

@@ -20,6 +20,9 @@
 import org.cactoos.io.ResourceOf;
 import org.cactoos.text.IoCheckedText;
 import org.cactoos.text.TextOf;
+import org.eolang.lints.fix.Edit;
+import org.eolang.lints.fix.File;
+import org.eolang.lints.fix.Fix;
 import org.eolang.parser.ObjectName;
 
 /**
@@ -98,15 +101,26 @@ public Collection<Defect> defects(final XML xmir) {
                     String.format("No severity reported by %s", this.rule)
                 );
             }
+            final Optional<String> message = xml.element("message").text();
             defects.add(
                 new DfContext(
                     new Defect.Default(
                         this.rule,
                         Severity.parsed(sever.get()),
                         new ObjectName(xmir).get(),
                         this.lineno(xml),
-                        xml.text().get(),
-                        LtByXsl.experimental(xml)
+                        message.orElseGet(() -> xml.text().get()),
+                        LtByXsl.experimental(xml),
+                        message.map(
+                                ignored ->
+                                    new Fix(
+                                        new File(
+                                            xmir.xpath("/@source/text()").get(0),
+                                            new Edit(xml.element("edit"))
+                                        )
+                                    )
+                            )
+                            .orElseGet(Fix::new)
                     ),
                     xml.attribute("context").text().orElse("")
                 )

src/main/java/org/eolang/lints/LtUnlintNonExistingDefect.java

@@ -19,6 +19,10 @@
 import org.cactoos.list.ListOf;
 import org.cactoos.text.IoCheckedText;
 import org.cactoos.text.TextOf;
+import org.eolang.lints.fix.Edit;
+import org.eolang.lints.fix.File;
+import org.eolang.lints.fix.Fix;
+import org.eolang.lints.fix.Position;
 import org.eolang.parser.ObjectName;
 
 /**
@@ -82,18 +86,29 @@ public Collection<Defect> defects(final XML xmir) throws IOException {
                         )
                         )
                         .map(xnav -> xnav.text().get())
-                        .collect(Collectors.toList())
+                        .map(Integer::parseInt)
                         .forEach(
                             line ->
                                 defects.add(
                                     new Defect.Default(
                                         this.name(),
                                         Severity.WARNING,
                                         new ObjectName(xmir).get(),
-                                        Integer.parseInt(line),
+                                        line,
                                         String.format(
                                             "Unlinting rule '%s' doesn't make sense, since there are no defects with it",
                                             unlint
+                                        ),
+                                        false,
+                                        new Fix(
+                                            new File(
+                                                new ObjectSource(xmir).get(),
+                                                new Edit(
+                                                    new Position(line, 0),
+                                                    new Position(line + 1, 0),
+                                                    ""
+                                                )
+                                            )
                                         )
                                     )
                                 )

src/main/java/org/eolang/lints/ObjectSource.java

@@ -0,0 +1,20 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2016-2025 Objectionary.com
+ * SPDX-License-Identifier: MIT
+ */
+package org.eolang.lints;
+
+import com.github.lombrozo.xnav.Xnav;
+import com.jcabi.xml.XML;
+
+final class ObjectSource {
+    private final Xnav xnav;
+
+    ObjectSource(XML xml) {
+        this.xnav = new Xnav(xml.inner());
+    }
+
+    String get() {
+        return xnav.attribute("source").text().orElse("");
+    }
+}

src/main/java/org/eolang/lints/ScopedDefects.java

@@ -31,7 +31,8 @@ final class ScopedDefects extends CollectionEnvelope<Defect> {
                             defect.object(),
                             defect.line(),
                             defect.text(),
-                            defect.experimental()
+                            defect.experimental(),
+                            defect.fix()
                         ),
                         defect.context()
                     ),

src/main/java/org/eolang/lints/fix/Create.java

@@ -0,0 +1,41 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2016-2025 Objectionary.com
+ * SPDX-License-Identifier: MIT
+ */
+package org.eolang.lints.fix;
+
+import com.github.lombrozo.xnav.Xnav;
+
+public class Create {
+    private final String path;
+
+    private final boolean overwrite;
+
+    private final boolean ignoreIfExists;
+
+    public Create(String path, boolean overwrite, boolean ignoreIfExists) {
+        this.path = path;
+        this.overwrite = overwrite;
+        this.ignoreIfExists = ignoreIfExists;
+    }
+
+    public Create(Xnav xnav) {
+        this(
+            xnav.element("path").text().get(),
+            Boolean.parseBoolean(xnav.element("overwrite").text().orElse("")),
+            Boolean.parseBoolean(xnav.element("ignoreIfExists").text().orElse(""))
+        );
+    }
+
+    public String path() {
+        return this.path;
+    }
+
+    public boolean overwrite() {
+        return this.overwrite;
+    }
+
+    public boolean ignoreIfExists() {
+        return this.ignoreIfExists;
+    }
+}

src/main/java/org/eolang/lints/fix/Delete.java

@@ -0,0 +1,41 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2016-2025 Objectionary.com
+ * SPDX-License-Identifier: MIT
+ */
+package org.eolang.lints.fix;
+
+import com.github.lombrozo.xnav.Xnav;
+
+public class Delete {
+    private final String path;
+
+    private final boolean recursive;
+
+    private final boolean ignoreIfNotExists;
+
+    public Delete(String path, boolean recursive, boolean ignoreIfNotExists) {
+        this.path = path;
+        this.recursive = recursive;
+        this.ignoreIfNotExists = ignoreIfNotExists;
+    }
+
+    public Delete(final Xnav xnav) {
+        this(
+            xnav.element("path").text().get(),
+            Boolean.parseBoolean(xnav.element("recursive").text().orElse("")),
+            Boolean.parseBoolean(xnav.element("ignoreIfNotExists").text().orElse(""))
+        );
+    }
+
+    public String path() {
+        return this.path;
+    }
+
+    public boolean recursive() {
+        return this.recursive;
+    }
+
+    public boolean ignoreIfNotExists() {
+        return this.ignoreIfNotExists;
+    }
+}

src/main/java/org/eolang/lints/fix/Edit.java

@@ -0,0 +1,41 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2016-2025 Objectionary.com
+ * SPDX-License-Identifier: MIT
+ */
+package org.eolang.lints.fix;
+
+import com.github.lombrozo.xnav.Xnav;
+
+public class Edit {
+    private final Position start;
+
+    private final Position end;
+
+    private final String newText;
+
+    public Edit(final Position start, final Position end, final String newText) {
+        this.start = start;
+        this.end = end;
+        this.newText = newText;
+    }
+
+    public Edit(Xnav xnav) {
+        this(
+            new Position(xnav.element("start")),
+            new Position(xnav.element("end")),
+            xnav.element("newText").text().get()
+        );
+    }
+
+    public Position start() {
+        return this.start;
+    }
+
+    public Position end() {
+        return this.end;
+    }
+
+    public String newText() {
+        return this.newText;
+    }
+}

src/main/java/org/eolang/lints/fix/File.java

@@ -0,0 +1,34 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2016-2025 Objectionary.com
+ * SPDX-License-Identifier: MIT
+ */
+package org.eolang.lints.fix;
+
+import com.github.lombrozo.xnav.Xnav;
+import java.util.Arrays;
+import java.util.Collection;
+
+public class File {
+    private final String path;
+    private final Collection<Edit> edits;
+
+    public File(final String path, final Edit... edits) {
+        this.path = path;
+        this.edits = Arrays.asList(edits);
+    }
+
+    public File(final Xnav xnav) {
+        this(
+            xnav.attribute("path").text().get(),
+            xnav.path("edit").map(Edit::new).toArray(Edit[]::new)
+        );
+    }
+
+    public String path() {
+        return this.path;
+    }
+
+    public Collection<Edit> edits() {
+        return this.edits;
+    }
+}