timespan

Author: KSemenenko

README.md

@@ -222,6 +222,7 @@ If the graph is sparse, the pipeline falls back to connected components to ensur
 ## Integration Testing Strategy
 
 - **Real services only.** All graph operations run against containerised Neo4j and Apache AGE/PostgreSQL instances provisioned by Testcontainers.
+- **Extended startup window.** The integration fixture raises `TestcontainersSettings.WaitStrategyTimeout` to 10 minutes so first-time Docker pulls have enough time to complete before readiness checks fail.
 - **Deterministic heuristics.** `StubEmbeddingGenerator` guarantees stable embeddings so semantic-dedup and token-budget assertions remain reliable.
 - **Cross-store validation.** Shared integration fixtures verify that workflows succeed against each adapter (Cosmos tests activate when the emulator connection string is present).
 - **Prompt precedence.** Tests validate that manual prompt overrides win over auto-tuned variants while still cascading correctly to the default templates.

tests/ManagedCode.GraphRag.Tests/GraphRagApplicationFixture.cs

@@ -1,5 +1,6 @@
 using System.Runtime.InteropServices;
 using DotNet.Testcontainers.Builders;
+using DotNet.Testcontainers.Configurations;
 using GraphRag;
 using GraphRag.Storage.Cosmos;
 using GraphRag.Storage.JanusGraph;
@@ -20,6 +21,7 @@ public sealed class GraphRagApplicationFixture : IAsyncLifetime
     private const string Neo4jPassword = "test1234";
     private const string PostgresPassword = "postgres";
     private const string PostgresDatabase = "graphragdb";
+    private static readonly TimeSpan ContainerStartupTimeout = TimeSpan.FromMinutes(10);
 
     private ServiceProvider _serviceProvider = null!;
     private AsyncServiceScope? _scope;
@@ -31,6 +33,15 @@ public sealed class GraphRagApplicationFixture : IAsyncLifetime
     public IServiceProvider Services => _scope?.ServiceProvider ?? throw new InvalidOperationException("The fixture has not been initialized.");
     public string PostgresConnectionString => _postgresContainer?.GetConnectionString() ?? throw new InvalidOperationException("PostgreSQL container is not available.");
 
+    static GraphRagApplicationFixture()
+    {
+        if (TestcontainersSettings.WaitStrategyTimeout is null || TestcontainersSettings.WaitStrategyTimeout < ContainerStartupTimeout)
+        {
+            // Pulling these images can easily exceed the default timeout on fresh machines, so relax it globally.
+            TestcontainersSettings.WaitStrategyTimeout = ContainerStartupTimeout;
+        }
+    }
+
     public async Task InitializeAsync()
     {
         Uri? boltEndpoint = null;