fix(ci): move example tests to GitHub Actions to avoid Dagger symlink loop

The examples reference the root package via "../../" which creates
symlinks that point back to the project root. When Dagger snapshots
the directory, this causes infinite recursion and a "file name too long"
panic.

This change:
- Excludes the examples directory from Dagger entirely
- Removes example-related functions from the Dagger module
- Adds a new test-examples job in GitHub Actions that runs examples
  in parallel using a matrix strategy

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

Author: shepherdjerred

.dagger/src/index.ts

@@ -2,10 +2,8 @@ import { argument, dag, Directory, func, object, Secret } from "@dagger.io/dagge
 import type { Container } from "@dagger.io/dagger";
 import {
   withTiming,
-  runNamedParallel,
   releasePr as sharedReleasePr,
   githubRelease as sharedGithubRelease,
-  type NamedResult,
 } from "@shepherdjerred/dagger-utils";
 
 const WORKDIR = "/workspace";
@@ -56,55 +54,6 @@ export class AstroOpengraphImages {
     });
   }
 
-  /**
-   * Test a specific example
-   */
-  @func()
-  async testExample(
-    @argument({ defaultPath: "." })
-    source: Directory,
-    @argument()
-    example: string,
-  ): Promise<string> {
-    return withTiming(`test-example:${example}`, async () => {
-      const build = this.buildRoot(source);
-      await build.stdout();
-      await this.runExampleWithBase(example, build);
-      return `Example ${example} built successfully.`;
-    });
-  }
-
-  /**
-   * Test all examples in parallel
-   */
-  @func()
-  async testAll(
-    @argument({ defaultPath: "." })
-    source: Directory,
-  ): Promise<string> {
-    return withTiming("test-all-examples", async () => {
-      const examples = await this.exampleNames(source);
-      const build = this.buildRoot(source);
-      await build.stdout();
-
-      const results = await runNamedParallel(
-        examples.map((example) => ({
-          name: example,
-          operation: () => this.runExampleWithBase(example, build),
-        })),
-      );
-
-      const failed = results.filter((r: NamedResult<void>) => !r.success);
-      if (failed.length > 0) {
-        const failedNames = failed.map((r: NamedResult<void>) => r.name).join(", ");
-        throw new Error(`Examples failed: ${failedNames}`);
-      }
-
-      const exampleList = examples.join(", ");
-      return `All ${examples.length.toString()} examples built successfully: ${exampleList}`;
-    });
-  }
-
   /**
    * Run the complete CI pipeline
    */
@@ -118,30 +67,11 @@ export class AstroOpengraphImages {
 
       await withTiming("lint", () => deps.withExec(["bun", "run", "lint"]).stdout());
 
-      const build = deps.withExec(["bun", "run", "build"]);
-      await withTiming("build", () => build.stdout());
+      await withTiming("build", () => deps.withExec(["bun", "run", "build"]).stdout());
 
       await withTiming("test", () => deps.withExec(["bun", "run", "test"]).stdout());
 
-      const examples = await this.exampleNames(source);
-
-      await withTiming("test-examples", async () => {
-        const results = await runNamedParallel(
-          examples.map((example) => ({
-            name: example,
-            operation: () => this.runExampleWithBase(example, build),
-          })),
-        );
-
-        const failed = results.filter((r: NamedResult<void>) => !r.success);
-        if (failed.length > 0) {
-          const failedNames = failed.map((r: NamedResult<void>) => r.name).join(", ");
-          throw new Error(`Examples failed: ${failedNames}`);
-        }
-      });
-
-      const exampleList = examples.join(", ");
-      return `CI pipeline completed successfully. Tested ${examples.length.toString()} examples: ${exampleList}`;
+      return "CI pipeline completed successfully.";
     });
   }
 
@@ -282,7 +212,10 @@ export class AstroOpengraphImages {
       .withWorkdir(WORKDIR)
       .withEnvVariable("CI", "true")
       .withDirectory(WORKDIR, source, {
-        exclude: ["node_modules", "examples/*/node_modules", "**/.astro", "**/.dagger"],
+        // Examples are excluded because they reference the root package via "../../" which
+        // creates symlinks that point back to the project root, causing infinite recursion
+        // when Dagger snapshots the directory. Example tests run in GitHub Actions instead.
+        exclude: ["node_modules", "examples", "**/.astro", "**/.dagger"],
       });
   }
 
@@ -296,24 +229,4 @@ export class AstroOpengraphImages {
   private buildRoot(source: Directory): Container {
     return this.installDependencies(source).withExec(["bun", "run", "build"]);
   }
-
-  private async exampleNames(source: Directory): Promise<string[]> {
-    const examplesDir = source.directory("examples");
-    const entries = await examplesDir.entries();
-    return entries
-      .map((entry) => entry.replace(/\/+$/, "")) // Strip trailing slashes from directory names
-      .filter((entry) => entry.trim().length > 0)
-      .sort();
-  }
-
-  private async runExampleWithBase(example: string, base: Container): Promise<void> {
-    const exampleWorkdir = `${WORKDIR}/examples/${example}`;
-    // Don't use node_modules cache for examples - local file references (../../) cause stale
-    // cache entries that fail with ENOENT or module resolution errors.
-    let container = base.withWorkdir(exampleWorkdir).withExec(["bun", "install", "--frozen-lockfile"]);
-
-    container = container.withExec(["bun", "run", "build"]);
-
-    await container.stdout();
-  }
 }

.github/workflows/ci.yml

@@ -118,6 +118,36 @@ jobs:
             exit $EXIT_CODE
           fi
 
+  # Example tests run in GHA instead of Dagger because the examples reference
+  # the root package via "../../" which creates symlinks that cause infinite
+  # recursion when Dagger snapshots the directory.
+  test-examples:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        example: [custom, preset]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install root dependencies and build
+        run: |
+          bun install --frozen-lockfile
+          bun run build
+
+      - name: Install example dependencies
+        working-directory: examples/${{ matrix.example }}
+        run: bun install --frozen-lockfile
+
+      - name: Build example
+        working-directory: examples/${{ matrix.example }}
+        run: bun run build
+
 permissions:
   contents: write
   pull-requests: write