Use action when Writerside project is in a sub directory?

[tlf30]

How do I configure the action when the writerside project is a sub-folder? I cannot find a way to properly point it to the folder where the project is located.

[barsia]

Hi Trevor Flynn (@tlf30)
Try to keep it as is by default.
As far as I remember, it searches the specified instance recursively, so you can leave it unchanged in your action:

env:
  INSTANCE: 'Writerside/hi' # replace `hi` with your instance ID

[tlf30]

I'm not having much luck.

[command]/usr/bin/docker run --rm -v /mnt/c/workspace/Spyglass/Spyglass:/github/workspace registry.jetbrains.team/p/writerside/builder/writerside-builder:latest /bin/bash -c 
            export DISPLAY=:99
            Xvfb :99 &
            git config --global --add safe.directory /github/workspace
            /opt/builder/bin/idea.sh helpbuilderinspect -source-dir /github/workspace/ -product Writerside/spyglass  --runner github -output-dir /github/workspace/artifacts/ || true
            echo "Test existing artifacts"
            test -e /github/workspace/artifacts/webHelpSPYGLASS2-all.zip && echo webHelpSPYGLASS2-all.zip exists
            if [ -z "$(ls -A /github/workspace/artifacts/ 2>/dev/null)" ]; then
               echo "Artifacts not found" && false
            else
               chmod 777 /github/workspace/artifacts/
               ls -la /github/workspace/artifacts/
            fi
        
[0.050s][warning][cds] Archived non-system classes are disabled because the java.system.class.loader property is specified (value = "com.intellij.util.lang.PathClassLoader"). To use archived non-system classes, this property must not be set
Dec 19, 2025 6:35:09 PM java.util.prefs.FileSystemPreferences$1 run
INFO: Created user preferences directory.
2025-12-19 18:35:11,993 [   2435]   WARN - #c.i.u.Alarm - Do not create alarm without coroutineScope: com.intellij.ui.jcef.JBCefOsrComponent.<init>(JBCefOsrComponent.java:52)
2025-12-19 18:35:12,063 [   2505]   WARN - #c.i.i.s.p.i.BundledSharedIndexProvider - Bundled shared index is not found at: /opt/builder/jdk-shared-indexes
Preparing "/github/workspace/" for build.
2025-12-19 18:35:17,817 [   8259]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.users.BackendUserManager, plugin=com.jetbrains.codeWithMe)
2025-12-19 18:35:17,817 [   8259]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.ports.CwmPortForwardingToolWindowManager, plugin=com.jetbrains.codeWithMe)
2025-12-19 18:35:17,818 [   8260]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.following.FollowMeManagerService, plugin=com.jetbrains.codeWithMe)
Open solution: "workspace", 0 modules: .
java.lang.Throwable: Cannot find module "Writerside" in solution "workspace".
	at supernova.core.SupernovaStarter$1.lambda$projectOpened$3(SupernovaStarter.java:181)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:109)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:103)
	at com.intellij.util.concurrency.ContextRunnable.run(ContextRunnable.java:27)
	at com.intellij.openapi.project.SmartModeScheduler.addLast$lambda$1(SmartModeScheduler.kt:81)
	at com.intellij.openapi.project.SmartModeScheduler.addLast$lambda$2(SmartModeScheduler.kt:81)
	at com.intellij.openapi.project.SmartModeScheduler$RunnableDelegate.run(SmartModeScheduler.kt:42)
	at com.intellij.openapi.project.SmartModeScheduler.doRun(SmartModeScheduler.kt:124)
	at com.intellij.openapi.project.SmartModeScheduler.runAllWhileSmart(SmartModeScheduler.kt:116)
	at com.intellij.openapi.application.TransactionGuardImpl.runWithWritingAllowed(TransactionGuardImpl.java:236)
	at com.intellij.openapi.application.TransactionGuardImpl.access$100(TransactionGuardImpl.java:25)
	at com.intellij.openapi.application.TransactionGuardImpl$1.run(TransactionGuardImpl.java:198)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runIntendedWriteActionOnCurrentThread$lambda$2(AnyThreadWriteThreadingSupport.kt:217)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runWriteIntentReadAction(AnyThreadWriteThreadingSupport.kt:128)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runIntendedWriteActionOnCurrentThread(AnyThreadWriteThreadingSupport.kt:216)
	at com.intellij.openapi.application.impl.ApplicationImpl.runIntendedWriteActionOnCurrentThread(ApplicationImpl.java:843)
	at com.intellij.openapi.application.impl.ApplicationImpl$2.run(ApplicationImpl.java:421)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:109)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:103)
	at com.intellij.util.concurrency.ContextRunnable.run(ContextRunnable.java:27)
	at com.intellij.openapi.application.impl.FlushQueue.runNextEvent(FlushQueue.java:117)
	at com.intellij.openapi.application.impl.FlushQueue.flushNow(FlushQueue.java:43)
	at java.desktop/java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:318)
	at java.desktop/java.awt.EventQueue.dispatchEventImpl(EventQueue.java:781)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:728)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:722)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:400)
	at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:87)
	at java.desktop/java.awt.EventQueue.dispatchEvent(EventQueue.java:750)
	at com.intellij.ide.IdeEventQueue.defaultDispatchEvent(IdeEventQueue.kt:675)
	at com.intellij.ide.IdeEventQueue._dispatchEvent(IdeEventQueue.kt:573)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18$lambda$17$lambda$16$lambda$15(IdeEventQueue.kt:355)
	at com.intellij.openapi.progress.impl.CoreProgressManager.computePrioritized(CoreProgressManager.java:857)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18$lambda$17$lambda$16(IdeEventQueue.kt:354)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$2$lambda$1(IdeEventQueue.kt:1045)
	at com.intellij.openapi.application.WriteIntentReadAction.lambda$run$0(WriteIntentReadAction.java:24)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runWriteIntentReadAction(AnyThreadWriteThreadingSupport.kt:128)
	at com.intellij.openapi.application.impl.ApplicationImpl.runWriteIntentReadAction(ApplicationImpl.java:917)
	at com.intellij.openapi.application.WriteIntentReadAction.compute(WriteIntentReadAction.java:55)
	at com.intellij.openapi.application.WriteIntentReadAction.run(WriteIntentReadAction.java:23)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$2(IdeEventQueue.kt:1045)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$3(IdeEventQueue.kt:1054)
	at com.intellij.openapi.application.TransactionGuardImpl.performActivity(TransactionGuardImpl.java:109)
	at com.intellij.ide.IdeEventQueueKt.performActivity(IdeEventQueue.kt:1054)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18(IdeEventQueue.kt:349)
	at com.intellij.ide.IdeEventQueue.dispatchEvent(IdeEventQueue.kt:395)
	at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThread.java:207)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.java:128)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:117)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:113)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:105)
	at java.desktop/java.awt.EventDispatchThread.run(EventDispatchThread.java:92)
Test existing artifacts
Artifacts not found
::error::The process '/usr/bin/docker' failed with exit code 1

# Workflow for building Spyglass Writerside documentation using the official JetBrains Writerside action.
# Triggers on push events.
name: Spyglass Writerside Build
run-name: ${{ gitea.actor }} is building Spyglass Writerside docs
on: [push]

# Environment variables for reusability across jobs/steps.
env:
  INSTANCE: 'Writerside/spyglass'  # Module name and instance ID.
  LOCATION: 'docs/Writerside'  # Path to the module directory (source dir).
  DOCKER_VERSION: 'latest'  # Use 'latest' for the most recent Writerside builder Docker image.

jobs:
  Writerside-build:
    runs-on: ubuntu-latest  # Standard runner; no need for custom Writerside builder.
    steps:
      - name: Check out repository code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # Ensures full history for any potential doc versioning.

      - name: Build docs using Writerside Docker builder
        uses: JetBrains/writerside-github-action@v4
        with:
          instance: ${{ env.INSTANCE }}
          location: ${{ env.LOCATION }}
          docker-version: ${{ env.DOCKER_VERSION }}
          artifact: webHelpSPYGLASS2-all.zip  # Default ZIP artifact name based on instance.

      - name: Save artifact with build results
        uses: actions/upload-artifact@v4
        with:
          name: writerside-docs
          path: artifacts/webHelpSPYGLASS2-all.zip  # Upload the generated ZIP.

I think I have everything configured correctly (there is not much to configure.)

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE instance-profile
        SYSTEM "https://resources.jetbrains.com/writerside/1.0/product-profile.dtd">

<instance-profile id="spyglass"
                 name="Spyglass"
                 start-page="Spyglass.md">

    <toc-element topic="Spyglass.md">
        <toc-element topic="Building.md">
            <toc-element topic="Versions.md"/>
        </toc-element>
        <toc-element topic="Bootstrap.md">
            <toc-element topic="Windows-Launcher.md"/>
            <toc-element topic="Environment-Variables.md"/>
        </toc-element>

        <toc-element topic="Core.md">
            <toc-element topic="Plugins.md"/>
            <toc-element topic="Groovy-Scripts.md"/>
            <toc-element topic="Py4J.md"/>
            <toc-element topic="SDP.md"/>
            <toc-element topic="SRP.md"/>
        </toc-element>
        <toc-element topic="UI.md"/>
        <toc-element topic="HCC2.md"/>
    </toc-element>
</instance-profile>

But the action is not finding the Writerside project directory.

[tlf30]

I used to build it before the action by setting the source dir on the command line:

name: Spyglass Writerside Build
run-name: ${{ gitea.actor }} is building Spyglass Writerside docs
on: [push]

jobs:
  Writerside-build:
    runs-on: writerside-builder-242.21870
    steps:
      - name: Check out repository code
        uses: actions/checkout@v4
      - run: pwd
      - run: ls -a
      - run: export DISPLAY=:99 && Xvfb :99 & /opt/builder/bin/idea.sh helpbuilderinspect --source-dir `pwd`/docs/Writerside --product Writerside/spyglass --runner other --output-dir `pwd`/build/docs/Writerside/spyglass
      - uses: actions/upload-artifact@v3
        with:
          name: writerside-docs
          path: ./build/docs/Writerside/spyglass

[barsia]

Try not specifying LOCATION: 'docs/Writerside' at all.
I’ve tested a similar nested structure, and it works without it.

[tlf30]

# Workflow for building Spyglass Writerside documentation using the official JetBrains Writerside action.
# Triggers on push events.
name: Spyglass Writerside Build
run-name: ${{ gitea.actor }} is building Spyglass Writerside docs
on: [push]

# Environment variables for reusability across jobs/steps.
env:
  INSTANCE: 'Writerside/spyglass'  # Module name and instance ID.
  DOCKER_VERSION: 'latest'  # Use 'latest' for the most recent Writerside builder Docker image.

jobs:
  Writerside-build:
    runs-on: ubuntu-latest  # Standard runner; no need for custom Writerside builder.
    steps:
      - name: Check out repository code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # Ensures full history for any potential doc versioning.

      - name: Build docs using Writerside Docker builder
        uses: JetBrains/writerside-github-action@v4
        with:
          instance: ${{ env.INSTANCE }}
          docker-version: ${{ env.DOCKER_VERSION }}
          artifact: webHelpSPYGLASS2-all.zip  # Default ZIP artifact name based on instance.

      - name: Save artifact with build results
        uses: actions/upload-artifact@v4
        with:
          name: writerside-docs
          path: artifacts/webHelpSPYGLASS2-all.zip  # Upload the generated ZIP.

This also is not working.

[command]/usr/bin/docker run --rm -v /mnt/c/workspace/Spyglass/Spyglass:/github/workspace registry.jetbrains.team/p/writerside/builder/writerside-builder:latest /bin/bash -c 
            export DISPLAY=:99
            Xvfb :99 &
            git config --global --add safe.directory /github/workspace
            /opt/builder/bin/idea.sh helpbuilderinspect -source-dir /github/workspace/ -product Writerside/spyglass  --runner github -output-dir /github/workspace/artifacts/ || true
            echo "Test existing artifacts"
            test -e /github/workspace/artifacts/webHelpSPYGLASS2-all.zip && echo webHelpSPYGLASS2-all.zip exists
            if [ -z "$(ls -A /github/workspace/artifacts/ 2>/dev/null)" ]; then
               echo "Artifacts not found" && false
            else
               chmod 777 /github/workspace/artifacts/
               ls -la /github/workspace/artifacts/
            fi
        
[0.052s][warning][cds] Archived non-system classes are disabled because the java.system.class.loader property is specified (value = "com.intellij.util.lang.PathClassLoader"). To use archived non-system classes, this property must not be set
Dec 19, 2025 8:24:25 PM java.util.prefs.FileSystemPreferences$1 run
INFO: Created user preferences directory.
2025-12-19 20:24:27,025 [   1544]   WARN - #c.i.u.Alarm - Do not create alarm without coroutineScope: com.intellij.ui.jcef.JBCefOsrComponent.<init>(JBCefOsrComponent.java:52)
2025-12-19 20:24:27,078 [   1597]   WARN - #c.i.i.s.p.i.BundledSharedIndexProvider - Bundled shared index is not found at: /opt/builder/jdk-shared-indexes
Preparing "/github/workspace/" for build.
2025-12-19 20:24:32,063 [   6582]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.users.BackendUserManager, plugin=com.jetbrains.codeWithMe)
2025-12-19 20:24:32,064 [   6583]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.ports.CwmPortForwardingToolWindowManager, plugin=com.jetbrains.codeWithMe)
2025-12-19 20:24:32,064 [   6583]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.following.FollowMeManagerService, plugin=com.jetbrains.codeWithMe)
2025-12-19 20:22:06,836 [-138645]   WARN - #c.i.i.IdeEventQueue - System clock's jumped back by ~147 sec
Open solution: "workspace", 0 modules: .
java.lang.Throwable: Cannot find module "Writerside" in solution "workspace".
	at supernova.core.SupernovaStarter$1.lambda$projectOpened$3(SupernovaStarter.java:181)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:109)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:103)
	at com.intellij.util.concurrency.ContextRunnable.run(ContextRunnable.java:27)
	at com.intellij.openapi.project.SmartModeScheduler.addLast$lambda$1(SmartModeScheduler.kt:81)
	at com.intellij.openapi.project.SmartModeScheduler.addLast$lambda$2(SmartModeScheduler.kt:81)
	at com.intellij.openapi.project.SmartModeScheduler$RunnableDelegate.run(SmartModeScheduler.kt:42)
	at com.intellij.openapi.project.SmartModeScheduler.doRun(SmartModeScheduler.kt:124)
	at com.intellij.openapi.project.SmartModeScheduler.runAllWhileSmart(SmartModeScheduler.kt:116)
	at com.intellij.openapi.application.TransactionGuardImpl.runWithWritingAllowed(TransactionGuardImpl.java:236)
	at com.intellij.openapi.application.TransactionGuardImpl.access$100(TransactionGuardImpl.java:25)
	at com.intellij.openapi.application.TransactionGuardImpl$1.run(TransactionGuardImpl.java:198)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runIntendedWriteActionOnCurrentThread$lambda$2(AnyThreadWriteThreadingSupport.kt:217)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runWriteIntentReadAction(AnyThreadWriteThreadingSupport.kt:128)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runIntendedWriteActionOnCurrentThread(AnyThreadWriteThreadingSupport.kt:216)
	at com.intellij.openapi.application.impl.ApplicationImpl.runIntendedWriteActionOnCurrentThread(ApplicationImpl.java:843)
	at com.intellij.openapi.application.impl.ApplicationImpl$2.run(ApplicationImpl.java:421)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:109)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:103)
	at com.intellij.util.concurrency.ContextRunnable.run(ContextRunnable.java:27)
	at com.intellij.openapi.application.impl.FlushQueue.runNextEvent(FlushQueue.java:117)
	at com.intellij.openapi.application.impl.FlushQueue.flushNow(FlushQueue.java:43)
	at java.desktop/java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:318)
	at java.desktop/java.awt.EventQueue.dispatchEventImpl(EventQueue.java:781)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:728)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:722)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:400)
	at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:87)
	at java.desktop/java.awt.EventQueue.dispatchEvent(EventQueue.java:750)
	at com.intellij.ide.IdeEventQueue.defaultDispatchEvent(IdeEventQueue.kt:675)
	at com.intellij.ide.IdeEventQueue._dispatchEvent(IdeEventQueue.kt:573)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18$lambda$17$lambda$16$lambda$15(IdeEventQueue.kt:355)
	at com.intellij.openapi.progress.impl.CoreProgressManager.computePrioritized(CoreProgressManager.java:857)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18$lambda$17$lambda$16(IdeEventQueue.kt:354)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$2$lambda$1(IdeEventQueue.kt:1045)
	at com.intellij.openapi.application.WriteIntentReadAction.lambda$run$0(WriteIntentReadAction.java:24)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runWriteIntentReadAction(AnyThreadWriteThreadingSupport.kt:128)
	at com.intellij.openapi.application.impl.ApplicationImpl.runWriteIntentReadAction(ApplicationImpl.java:917)
	at com.intellij.openapi.application.WriteIntentReadAction.compute(WriteIntentReadAction.java:55)
	at com.intellij.openapi.application.WriteIntentReadAction.run(WriteIntentReadAction.java:23)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$2(IdeEventQueue.kt:1045)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$3(IdeEventQueue.kt:1054)
	at com.intellij.openapi.application.TransactionGuardImpl.performActivity(TransactionGuardImpl.java:109)
	at com.intellij.ide.IdeEventQueueKt.performActivity(IdeEventQueue.kt:1054)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18(IdeEventQueue.kt:349)
	at com.intellij.ide.IdeEventQueue.dispatchEvent(IdeEventQueue.kt:395)
	at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThread.java:207)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.java:128)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:117)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:113)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:105)
	at java.desktop/java.awt.EventDispatchThread.run(EventDispatchThread.java:92)
Test existing artifacts
Artifacts not found
::error::The process '/usr/bin/docker' failed with exit code 1

EDIT: I looked at your example, I'm not sure what would be different between the setups.

[barsia]

Try specifying the location up to the Writerside directory (but not including it) from the repository root:

- name: Build docs using Writerside Docker builder
  uses: JetBrains/writerside-github-action@v4
  with:
    instance: ${{ env.INSTANCE }}
    docker-version: ${{ env.DOCKER_VERSION }}
    artifact: webHelpSPYGLASS2-all.zip
    location: docs  # from the project root, without Writerside

[tlf30]

I did some additional tests, and added a debug section to verify the contents of the mounted directory by running pwd && ls -a

/mnt/c/workspace/Spyglass/Spyglass
.		LICENSE       gradle		 run.gradle
..		README.md     gradle.properties  runtimes
.git		bootstraps    gradlew		 settings.gradle
.gitattributes	build.gradle  gradlew.bat	 upload.gradle
.gitea		deps	      lib		 versions.gradle
.gitignore	dist.gradle   plugins
.idea		docs	      publishing.gradle

[command]/usr/bin/docker run --rm -v /mnt/c/workspace/Spyglass/Spyglass:/github/workspace registry.jetbrains.team/p/writerside/builder/writerside-builder:latest /bin/bash -c 
            export DISPLAY=:99
            Xvfb :99 &
            git config --global --add safe.directory /github/workspace
            /opt/builder/bin/idea.sh helpbuilderinspect -source-dir /github/workspace/docs -product Writerside/spyglass  --runner github -output-dir /github/workspace/artifacts/ || true
            echo "Test existing artifacts"
            test -e /github/workspace/artifacts/webHelpSPYGLASS2-all.zip && echo webHelpSPYGLASS2-all.zip exists
            if [ -z "$(ls -A /github/workspace/artifacts/ 2>/dev/null)" ]; then
               echo "Artifacts not found" && false
            else
               chmod 777 /github/workspace/artifacts/
               ls -la /github/workspace/artifacts/
            fi
        
[0.010s][warning][cds] Archived non-system classes are disabled because the java.system.class.loader property is specified (value = "com.intellij.util.lang.PathClassLoader"). To use archived non-system classes, this property must not be set
Dec 19, 2025 9:11:01 PM java.util.prefs.FileSystemPreferences$1 run
INFO: Created user preferences directory.
2025-12-19 21:11:02,770 [   1195]   WARN - #c.i.u.Alarm - Do not create alarm without coroutineScope: com.intellij.ui.jcef.JBCefOsrComponent.<init>(JBCefOsrComponent.java:52)
2025-12-19 21:11:02,853 [   1278]   WARN - #c.i.i.s.p.i.BundledSharedIndexProvider - Bundled shared index is not found at: /opt/builder/jdk-shared-indexes
Preparing "/github/workspace/docs" for build.
2025-12-19 21:11:05,178 [   3603]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.users.BackendUserManager, plugin=com.jetbrains.codeWithMe)
2025-12-19 21:11:05,178 [   3603]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.ports.CwmPortForwardingToolWindowManager, plugin=com.jetbrains.codeWithMe)
2025-12-19 21:11:05,178 [   3603]   WARN - #c.i.s.ComponentManagerImpl - `preload=TRUE` must be used only for core services (service=com.intellij.cwm.plugin.following.FollowMeManagerService, plugin=com.jetbrains.codeWithMe)
Open solution: "docs", 0 modules: .
java.lang.Throwable: Cannot find module "Writerside" in solution "docs".
	at supernova.core.SupernovaStarter$1.lambda$projectOpened$3(SupernovaStarter.java:181)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:109)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:103)
	at com.intellij.util.concurrency.ContextRunnable.run(ContextRunnable.java:27)
	at com.intellij.openapi.project.SmartModeScheduler.addLast$lambda$1(SmartModeScheduler.kt:81)
	at com.intellij.openapi.project.SmartModeScheduler.addLast$lambda$2(SmartModeScheduler.kt:81)
	at com.intellij.openapi.project.SmartModeScheduler$RunnableDelegate.run(SmartModeScheduler.kt:42)
	at com.intellij.openapi.project.SmartModeScheduler.doRun(SmartModeScheduler.kt:124)
	at com.intellij.openapi.project.SmartModeScheduler.runAllWhileSmart(SmartModeScheduler.kt:116)
	at com.intellij.openapi.application.TransactionGuardImpl.runWithWritingAllowed(TransactionGuardImpl.java:236)
	at com.intellij.openapi.application.TransactionGuardImpl.access$100(TransactionGuardImpl.java:25)
	at com.intellij.openapi.application.TransactionGuardImpl$1.run(TransactionGuardImpl.java:198)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runIntendedWriteActionOnCurrentThread$lambda$2(AnyThreadWriteThreadingSupport.kt:217)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runWriteIntentReadAction(AnyThreadWriteThreadingSupport.kt:128)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runIntendedWriteActionOnCurrentThread(AnyThreadWriteThreadingSupport.kt:216)
	at com.intellij.openapi.application.impl.ApplicationImpl.runIntendedWriteActionOnCurrentThread(ApplicationImpl.java:843)
	at com.intellij.openapi.application.impl.ApplicationImpl$2.run(ApplicationImpl.java:421)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:103)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:109)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:103)
	at com.intellij.util.concurrency.ContextRunnable.run(ContextRunnable.java:27)
	at com.intellij.openapi.application.impl.FlushQueue.runNextEvent(FlushQueue.java:117)
	at com.intellij.openapi.application.impl.FlushQueue.flushNow(FlushQueue.java:43)
	at java.desktop/java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:318)
	at java.desktop/java.awt.EventQueue.dispatchEventImpl(EventQueue.java:781)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:728)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:722)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:400)
	at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:87)
	at java.desktop/java.awt.EventQueue.dispatchEvent(EventQueue.java:750)
	at com.intellij.ide.IdeEventQueue.defaultDispatchEvent(IdeEventQueue.kt:675)
	at com.intellij.ide.IdeEventQueue._dispatchEvent(IdeEventQueue.kt:573)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18$lambda$17$lambda$16$lambda$15(IdeEventQueue.kt:355)
	at com.intellij.openapi.progress.impl.CoreProgressManager.computePrioritized(CoreProgressManager.java:857)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18$lambda$17$lambda$16(IdeEventQueue.kt:354)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$2$lambda$1(IdeEventQueue.kt:1045)
	at com.intellij.openapi.application.WriteIntentReadAction.lambda$run$0(WriteIntentReadAction.java:24)
	at com.intellij.openapi.application.impl.AnyThreadWriteThreadingSupport.runWriteIntentReadAction(AnyThreadWriteThreadingSupport.kt:128)
	at com.intellij.openapi.application.impl.ApplicationImpl.runWriteIntentReadAction(ApplicationImpl.java:917)
	at com.intellij.openapi.application.WriteIntentReadAction.compute(WriteIntentReadAction.java:55)
	at com.intellij.openapi.application.WriteIntentReadAction.run(WriteIntentReadAction.java:23)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$2(IdeEventQueue.kt:1045)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$3(IdeEventQueue.kt:1054)
	at com.intellij.openapi.application.TransactionGuardImpl.performActivity(TransactionGuardImpl.java:109)
	at com.intellij.ide.IdeEventQueueKt.performActivity(IdeEventQueue.kt:1054)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$18(IdeEventQueue.kt:349)
	at com.intellij.ide.IdeEventQueue.dispatchEvent(IdeEventQueue.kt:395)
	at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThread.java:207)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.java:128)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:117)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:113)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:105)
	at java.desktop/java.awt.EventDispatchThread.run(EventDispatchThread.java:92)
Test existing artifacts
Artifacts not found
::error::The process '/usr/bin/docker' failed with exit code 1

I tested with both 'docs' and 'docs/Writerside' for the location. Both had the same result.

# Workflow for building Spyglass Writerside documentation using the official JetBrains Writerside action.
# Triggers on push events.
name: Spyglass Writerside Build
run-name: ${{ gitea.actor }} is building Spyglass Writerside docs
on: [push]

# Environment variables for reusability across jobs/steps.
env:
  INSTANCE: 'Writerside/spyglass'  # Module name and instance ID.
  DOCKER_VERSION: 'latest'  # Use 'latest' for the most recent Writerside builder Docker image.

jobs:
  Writerside-build:
    runs-on: ubuntu-latest  # Standard runner; no need for custom Writerside builder.
    steps:
      - name: Check out repository code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # Ensures full history for any potential doc versioning.

      - name: Debug Info
        run: pwd && ls -a
      - name: Build docs using Writerside Docker builder
        uses: JetBrains/writerside-github-action@v4
        with:
          instance: ${{ env.INSTANCE }}
          docker-version: ${{ env.DOCKER_VERSION }}
          location: docs  # from the project root, without Writerside
          artifact: webHelpSPYGLASS2-all.zip  # Default ZIP artifact name based on instance.

      - name: Save artifact with build results
        uses: actions/upload-artifact@v4
        with:
          name: writerside-docs
          path: artifacts/webHelpSPYGLASS2-all.zip  # Upload the generated ZIP.

I'm kinda at a loss, as far as I can tell it should be finding the module. Setting the location parameter points it directly to the writerside folder like my old solution did before changing to the action. The old solution still works, but I would like to update to the action.

I really appreciate the help.

[tlf30]

EDIT: Does it have something to do with the project being a module within the larger IDEA project? With the old writerside image I was running, it was a much older version, would that have anything to do with it?

modules.xml

<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="ProjectModuleManager">
    <modules>
      <module fileurl="file://$PROJECT_DIR$/.idea/Writerside.iml" filepath="$PROJECT_DIR$/.idea/Writerside.iml" />
    </modules>
  </component>
</project>

vcs.xml

<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="VcsDirectoryMappings">
    <mapping directory="$PROJECT_DIR$/../.." vcs="Git" />
  </component>
</project>

[barsia]

It looks like the root cause is that the Spyglass directory is duplicated after clonning in the workspace: /mnt/c/workspace/Spyglass/Spyglass

[tlf30]

That is because it exists as part of an organization project.
It looks like the action properly mounted the correct folder though:

[command]/usr/bin/docker run --rm -v /mnt/c/workspace/Spyglass/Spyglass:/github/workspace

EDIT: Both the organization and the project have the name Spyglass.