build: fix test cli config (#1483)

* build: fix test cli config

* build: fix e2e test failures by adding missing test data and fixing port conflict

Add untracked test data files (config.json, sample.py, utils.js) needed by
allExternalDeps test. Fix mermaidLinks port collision with httpTracking
(both used 3461) and add missing server cleanup scenario.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* build: rename doc-artifacts to test-doc-artifacts to avoid gitignore

The root .gitignore excludes doc-artifacts, preventing test data files
(app.config, schema.graphql) from being committed. Rename to
test-doc-artifacts and update lookup-paths and test expectations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: MykolaGolubyev

znai-cli/src/test/groovy/org/testingisdocumenting/znai/cli/ZnaiCliConfigTest.groovy

@@ -94,6 +94,7 @@ class ZnaiCliConfigTest {
                 OptionKey.MARKUP_TYPE,
                 OptionKey.HELP,
                 OptionKey.VERSION,
+                OptionKey.ALL_EXTERNAL_DEPS_FILE_PATH,
                 OptionKey.VALIDATE_EXTERNAL_LINKS,
                 OptionKey.ACTOR,
                 OptionKey.MODIFIED_TIME,

znai-tests/src/test/groovy/sampledoc/chapter-one/config.json

@@ -0,0 +1,6 @@
+{
+  "key": "value",
+  "nested": {
+    "enabled": true
+  }
+}

znai-tests/src/test/groovy/sampledoc/chapter-two/sample.py

@@ -0,0 +1,2 @@
+def hello():
+    print("hello world")

znai-tests/src/test/groovy/sampledoc/lookup-paths

@@ -1,2 +1,2 @@
 ../doxygen.zip
-../doc-artifacts
+../test-doc-artifacts

znai-tests/src/test/groovy/sampledoc/utils.js

@@ -0,0 +1,3 @@
+function formatDate(d) {
+    return d.toISOString();
+}

znai-tests/src/test/groovy/scenarios/allExternalDeps.groovy

@@ -27,8 +27,8 @@ scenario('build sampledoc with all external dependencies file') {
             "--source=${cfg.fullPath('sampledoc')} " +
             "--all-external-dependencies-file-path $depsFilePath")
 
-    fs.textContent(depsFilePath).should == '../doc-artifacts/app.config\n' +
-            '../doc-artifacts/schema.graphql\n' +
+    fs.textContent(depsFilePath).should == '../test-doc-artifacts/app.config\n' +
+            '../test-doc-artifacts/schema.graphql\n' +
             'chapter-one/config.json\n' +
             'chapter-two/sample.py\n' +
             'utils.js'

znai-tests/src/test/groovy/scenarios/mermaidLinks.groovy

@@ -20,10 +20,12 @@ import static clicommands.CliCommands.getZnai
 import static org.testingisdocumenting.webtau.WebTauGroovyDsl.*
 import static pages.Pages.*
 
-def port = 3461
+def port = 3462
+
+def znaiPreview
 
 scenario("run znai preview for mermaid links") {
-    def znaiPreview = znai.runInBackground(
+    znaiPreview = znai.runInBackground(
             "--source=${cfg.fullPath("sampledoc")} --port=$port --preview")
     znaiPreview.output.waitTo(contain("server started"), 20_000)
 }
@@ -50,3 +52,9 @@ scenario("click mermaid link and browser back restores scroll position") {
     docContent.title.waitTo == "Mermaid Diagrams"
     docContent.mainPanelScrollTop.waitTo == scrollTopBeforeClick
 }
+
+scenario("stop mermaid preview server") {
+    if (znaiPreview) {
+        znaiPreview.stop()
+    }
+}

znai-tests/src/test/groovy/test-doc-artifacts/app.config

@@ -0,0 +1,2 @@
+server.port=8080
+server.host=localhost

znai-tests/src/test/groovy/test-doc-artifacts/external-code-snippets.json

@@ -0,0 +1,4 @@
+{
+  "shapes" : [ ],
+  "pixelRatio" : 2
+}