Failure to run dartdoc and generate API docs

[slightfoot]

We published a new version 0.0.15-beta of our package clerk_flutter and pub.dev failed to run dartdoc and generate our documentation.

https://pub.dev/packages/clerk_flutter/versions and it shows the following error:

https://pub.dev/packages/clerk_flutter/versions/0.0.15-beta/score/log.txt

## Running analysis for "clerk_flutter" version "0.0.15-beta"
STARTED: 2026-05-02T05:25:54.137726Z

### Starting processing
2026-05-02 05:25:54.151134 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner dart pub unpack clerk_flutter:0.0.15-beta --output /tmp/pana-clerk_flutterMPOPCK/clerk_flutter --no-resolve`...
2026-05-02 05:25:54.778146 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dart/stable/bin/dart --version`...
2026-05-02 05:25:54.895968 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git rev-parse --show-toplevel`...
2026-05-02 05:25:55.116091 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dart/stable/bin/dart pub get --no-example`...
2026-05-02 05:26:12.457738 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dart/stable/bin/dart pub get --no-example`...
2026-05-02 05:26:13.087411 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dart/stable/bin/dart pub outdated --json --up-to-date --no-dev-dependencies --no-dependency-overrides`...
2026-05-02 05:26:18.879347 INFO: Analyzing package...
2026-05-02 05:26:18.881651 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dart/stable/bin/dart analyze --format machine .`...
2026-05-02 05:26:44.395502 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git init`...
2026-05-02 05:26:44.570258 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git remote add origin https://github.com/clerk/clerk-sdk-flutter`...
2026-05-02 05:26:44.727427 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git remote show origin`...
2026-05-02 05:26:45.212025 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git fetch --depth 1 --no-recurse-submodules origin main`...
2026-05-02 05:26:46.175064 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git ls-tree -r -z --name-only --full-tree origin/main`...
2026-05-02 05:26:46.340759 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git show origin/main:packages/clerk_auth/pubspec.yaml`...
2026-05-02 05:26:46.498027 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git show origin/main:packages/clerk_backend_api/pubspec.yaml`...
2026-05-02 05:26:46.659641 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git show origin/main:packages/clerk_flutter/example/pubspec.yaml`...
2026-05-02 05:26:46.812779 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git show origin/main:packages/clerk_flutter/pubspec.yaml`...
2026-05-02 05:26:46.970084 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner git show origin/main:pubspec.yaml`...
2026-05-02 05:26:48.654955 INFO: Analyzing pub downgrade...
2026-05-02 05:26:48.656293 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dart/stable/bin/dart pub downgrade --no-example`...
2026-05-02 05:27:00.420102 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dart/stable/bin/dart analyze --format machine .`...
2026-05-02 05:27:23.270856 INFO: [pub-downgrade-failed]
2026-05-02 05:27:23.272250 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dart/stable/bin/dart pub upgrade --no-example`...
2026-05-02 05:27:24.774452 INFO: Running `/home/worker/pub-dev/pkg/pub_worker/build/sandbox_runner /home/worker/dartdoc/build/dartdoc --resources-dir /home/worker/dartdoc/lib/resources --output /tmp/pana-clerk_flutterMPOPCK/raw-dartdoc --sanitize-html --max-file-count 10000000 --max-total-size 2147483648 --no-validate-links --sdk-dir /home/worker/flutter/stable/bin/cache/dart-sdk`...
2026-05-02 05:27:48.766220 WARNING: `dartdoc` failed:
2026-05-02 05:27:48.766220 WARNING: Documenting clerk_flutter...
2026-05-02 05:27:48.766220 WARNING: Discovering libraries...
2026-05-02 05:27:48.766220 WARNING: dartdoc 9.0.4 (/home/worker/dartdoc/build/dartdoc) failed: fatal error: unable to locate the input directory at '/tmp/pana_PPYENJ/lib/generated'.
2026-05-02 05:27:48.766220 WARNING: #0      PubPackageMeta.fromDir (package:dartdoc/src/package_meta.dart:218)
2026-05-02 05:27:48.766220 WARNING: #1      PubPackageMeta.fromFilename (package:dartdoc/src/package_meta.dart:205)
2026-05-02 05:27:48.766220 WARNING: #2      PackageMetaProvider.fromFilename (package:dartdoc/src/package_meta.dart:82)
2026-05-02 05:27:48.766220 WARNING: #3      PubPackageBuilder._packageMetasForFiles (package:dartdoc/src/model/package_builder.dart:209)
2026-05-02 05:27:48.766220 WARNING: #4      PubPackageBuilder._discoverLibraries (package:dartdoc/src/model/package_builder.dart:292)
2026-05-02 05:27:48.766220 WARNING: <asynchronous suspension>
2026-05-02 05:27:48.766220 WARNING: #5      PubPackageBuilder._getLibraries (package:dartdoc/src/model/package_builder.dart:437)
2026-05-02 05:27:48.766220 WARNING: <asynchronous suspension>
2026-05-02 05:27:48.766220 WARNING: #6      PubPackageBuilder.buildPackageGraph (package:dartdoc/src/model/package_builder.dart:155)
2026-05-02 05:27:48.766220 WARNING: <asynchronous suspension>
2026-05-02 05:27:48.766220 WARNING: #7      Dartdoc.generateDocsBase (package:dartdoc/src/dartdoc.dart:193)
2026-05-02 05:27:48.766220 WARNING: <asynchronous suspension>
2026-05-02 05:27:48.766220 WARNING: #8      Dartdoc.generateDocs (package:dartdoc/src/dartdoc.dart:237)
2026-05-02 05:27:48.766220 WARNING: <asynchronous suspension>
2026-05-02 05:27:48.766220 WARNING: #9      Dartdoc.executeGuarded.<anonymous closure> (package:dartdoc/src/dartdoc.dart:269)
2026-05-02 05:27:48.766220 WARNING: <asynchronous suspension>
2026-05-02 05:27:48.780639 INFO: Writing summary.json
2026-05-02 05:27:48.781642 INFO: Running dartdoc post-processing
2026-05-02 05:27:48.782071 INFO: Creating .tar.gz archive
2026-05-02 05:27:48.783070 INFO: Finished post-processing
2026-05-02 05:27:48.784156 INFO: Finished .tar.gz archive
### Execution of process exited 0
STOPPED: 2026-05-02T05:27:48.812866Z

[isoos]

Thanks for reporting, this seems to be a bug in dartdoc, we will investigate it.

[isoos]

I couldn't reproduce this by locally running dartdoc, but it can be triggered via the dockerized test. I had excluded the sandboxing as the potential cause for this (by removing the sandbox execution option).

[isoos]

@slightfoot: The uploaded archive does have a lib/generated/ folder, but there are no files in it, while the repository has the files. It is probably unrelated to the bug though, but would be worth checking out the reasons for it.

[MarkOSullivan94]

@isoos what's the difference between running dartdoc locally and the dockerized test?

[isoos]

@MarkOSullivan94: we are running this docker image in production: https://github.com/dart-lang/pub-dev/blob/master/Dockerfile.worker

There are plenty of differences (e.g. precompilation, sandboxing, temp filesystem, setup mechanism), but so far I couldn't really pinpoint one that makes this fail in the docker and pass in the local environment. You are welcome to debug it!

[isoos]

Some findings from debugging this issue:

• maybe with the recent update to the pub_worker code, it can be reproduced outside of the docker container with trypkg.dart
• dartdoc 8.0.0, 8.3.4, 9.0.0 has the same output as 9.0.4
• using the temp PUB_CACHE or a global one doesn't seem to make any difference
• upgrading pana to the latest analyzer didn't change the behavior