Files
clice/tests/unit/server/stateless_worker_tests.cpp
ykiko 21a969af27 feat: integrate PCH into MasterServer build drain (#381)
## Summary
- Add `ensure_pch()` helper to MasterServer that builds/reuses
precompiled headers via stateless workers, with preamble hash-based
staleness detection (xxh3_64bits)
- Fix `BuildPCHParams` to carry `preamble_bound` so the stateless worker
truncates content at the preamble boundary (fixes redefinition errors
when PCH included full file)
- Wire PCH into both `run_build_drain` (stateful compile path) and
`forward_stateless` (completion/signatureHelp path)
- Add PCH state cleanup on `didClose` and hash invalidation on `didSave`

## Test plan
- [x] 398 unit tests pass (including 6 new PCH tests: PreambleHash x3,
PCHWorker x2, BuildPCHRequest assertion)
- [x] 5 new integration tests pass (`test_pch.py`: diagnostics on open,
body edit recompile, no-include file, hover with PCH, completion with
PCH)
- [x] 21 existing integration tests pass unchanged
- [x] Build succeeds with 0 errors

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

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Precompiled header (PCH) caching to speed compilations and reduce edit
latency
* Automatic attachment of cached PCH to compile requests, improving
hover and completion responsiveness
* Module-aware completions expanded to include available module
artifacts from other files

* **Bug Fixes**
* PCH cache cleared on file close; saving now triggers broader PCH
invalidation to prevent stale PCH use

* **Tests**
* Added unit and integration tests exercising PCH build, reuse, and
editor interactions
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-01 18:33:33 +08:00

280 lines
7.8 KiB
C++

#include <string>
#include <vector>
#include "test/test.h"
#include "eventide/serde/bincode/bincode.h"
#include "eventide/serde/serde/raw_value.h"
#include "server/protocol.h"
#include "server/worker_test_helpers.h"
namespace clice::testing {
namespace {
namespace et = eventide;
// ============================================================================
// Bincode Serialization Tests
// ============================================================================
TEST_SUITE(BincodeRoundTrip) {
TEST_CASE(CompileParamsRoundTrip) {
namespace bincode = eventide::serde::bincode;
worker::CompileParams params;
params.path = "/tmp/test.cpp";
params.version = 1;
params.text = "int main() { return 0; }";
params.directory = "/tmp";
params.arguments = {"clang++", "-c", "test.cpp"};
params.pch = {"", 0};
params.pcms = {};
auto bytes = bincode::to_bytes(params);
ASSERT_TRUE(bytes.has_value());
worker::CompileParams result;
auto status =
bincode::from_bytes(std::span<const std::byte>(bytes->data(), bytes->size()), result);
ASSERT_TRUE(status.has_value());
EXPECT_EQ(result.path, params.path);
EXPECT_EQ(result.version, params.version);
EXPECT_EQ(result.text, params.text);
EXPECT_EQ(result.directory, params.directory);
EXPECT_EQ(result.arguments.size(), params.arguments.size());
}
TEST_CASE(CompileResultRoundTrip) {
namespace bincode = eventide::serde::bincode;
worker::CompileResult result;
result.version = 1;
result.diagnostics = {}; // empty
result.memory_usage = 0;
auto bytes = bincode::to_bytes(result);
ASSERT_TRUE(bytes.has_value());
worker::CompileResult decoded;
auto status =
bincode::from_bytes(std::span<const std::byte>(bytes->data(), bytes->size()), decoded);
ASSERT_TRUE(status.has_value());
EXPECT_EQ(decoded.version, result.version);
}
}; // TEST_SUITE(BincodeRoundTrip)
// ============================================================================
// StatelessWorker Tests
// ============================================================================
TEST_SUITE(StatelessWorker) {
TEST_CASE(SpawnAndExit) {
WorkerHandle w;
ASSERT_TRUE(w.spawn("stateless-worker"));
// Close stdin pipe to signal worker to exit.
w.peer->close_output();
w.loop.schedule(w.peer->run());
w.loop.run();
}
TEST_CASE(BuildPCHRequest) {
TempDir tmp;
tmp.touch("test_pch.h", "#pragma once\nint pch_global = 42;\n");
auto hdr = tmp.path("test_pch.h");
WorkerHandle w;
ASSERT_TRUE(w.spawn("stateless-worker"));
bool test_done = false;
w.run([&]() -> et::task<> {
worker::BuildPCHParams params;
params.file = hdr;
params.directory = "/tmp";
params.arguments =
{"clang++", "-resource-dir", std::string(resource_dir()), "-x", "c++-header", hdr};
params.content = "#pragma once\nint pch_global = 42;\n";
auto result = co_await w.peer->send_request(params);
EXPECT_TRUE(result.has_value());
if(!result.has_value()) {
w.peer->close_output();
co_return;
}
EXPECT_TRUE(result.value().success);
EXPECT_FALSE(result.value().pch_path.empty());
test_done = true;
w.peer->close_output();
});
ASSERT_TRUE(test_done);
}
TEST_CASE(IndexRequest) {
TempDir tmp;
tmp.touch("test_index.cpp", "int indexed_var = 1;\n");
auto src = tmp.path("test_index.cpp");
WorkerHandle w;
ASSERT_TRUE(w.spawn("stateless-worker"));
bool test_done = false;
w.run([&]() -> et::task<> {
worker::IndexParams params;
params.file = src;
params.directory = "/tmp";
params.arguments = make_args(src);
auto result = co_await w.peer->send_request(params);
EXPECT_TRUE(result.has_value());
test_done = true;
w.peer->close_output();
});
ASSERT_TRUE(test_done);
}
}; // TEST_SUITE(StatelessWorker)
// ============================================================================
// StatelessWorker Extended Tests
// ============================================================================
TEST_SUITE(StatelessWorkerExtended) {
TEST_CASE(BuildPCMRequest) {
TempDir tmp;
tmp.touch("test_module.cppm",
"export module test_module;\nexport int module_func() { return 1; }\n");
auto src = tmp.path("test_module.cppm");
WorkerHandle w;
ASSERT_TRUE(w.spawn("stateless-worker"));
bool test_done = false;
w.run([&]() -> et::task<> {
worker::BuildPCMParams params;
params.file = src;
params.directory = "/tmp";
params.arguments = {"clang++",
"-resource-dir",
std::string(resource_dir()),
"-std=c++20",
"--precompile",
src};
params.module_name = "test_module";
auto result = co_await w.peer->send_request(params);
EXPECT_TRUE(result.has_value());
test_done = true;
w.peer->close_output();
});
ASSERT_TRUE(test_done);
}
TEST_CASE(CompletionRequest) {
std::string text = "int foo = 1;\nint bar = fo";
TempDir tmp;
tmp.touch("completion_test.cpp", text);
auto src = tmp.path("completion_test.cpp");
WorkerHandle w;
ASSERT_TRUE(w.spawn("stateless-worker"));
bool test_done = false;
w.run([&]() -> et::task<> {
worker::CompletionParams params;
params.path = src;
params.version = 1;
params.text = text;
params.directory = "/tmp";
params.arguments = make_args(src);
params.offset = 25; // after "fo" in "int bar = fo" (13 + 12)
auto result = co_await w.peer->send_request(params);
EXPECT_TRUE(result.has_value());
test_done = true;
w.peer->close_output();
});
ASSERT_TRUE(test_done);
}
TEST_CASE(SignatureHelpRequest) {
std::string text = "void foo(int a, int b) {}\nint main() { foo(";
TempDir tmp;
tmp.touch("sighelp_test.cpp", text);
auto src = tmp.path("sighelp_test.cpp");
WorkerHandle w;
ASSERT_TRUE(w.spawn("stateless-worker"));
bool test_done = false;
w.run([&]() -> et::task<> {
worker::SignatureHelpParams params;
params.path = src;
params.version = 1;
params.text = text;
params.directory = "/tmp";
params.arguments = make_args(src);
params.offset = 45; // after "foo(" (26 + 19)
auto result = co_await w.peer->send_request(params);
EXPECT_TRUE(result.has_value());
// Should return signature help for foo(int a, int b).
test_done = true;
w.peer->close_output();
});
ASSERT_TRUE(test_done);
}
TEST_CASE(MultipleStatelessRequests) {
TempDir tmp;
std::vector<std::string> paths;
for(int i = 0; i < 3; i++) {
auto name = "multi_index_" + std::to_string(i) + ".cpp";
auto text = "int idx_var_" + std::to_string(i) + " = " + std::to_string(i) + ";\n";
tmp.touch(name, text);
paths.push_back(tmp.path(name));
}
WorkerHandle w;
ASSERT_TRUE(w.spawn("stateless-worker"));
bool test_done = false;
w.run([&]() -> et::task<> {
// Send multiple index requests to test stateless worker handles them sequentially.
for(int i = 0; i < 3; i++) {
worker::IndexParams params;
params.file = paths[i];
params.directory = "/tmp";
params.arguments = make_args(paths[i]);
auto result = co_await w.peer->send_request(params);
EXPECT_TRUE(result.has_value());
}
test_done = true;
w.peer->close_output();
});
ASSERT_TRUE(test_done);
}
}; // TEST_SUITE(StatelessWorkerExtended)
} // namespace
} // namespace clice::testing