## Summary
PCH and PCM artifacts are now cached to disk at
`.clice/cache/{pch/,pcm/}` with content-addressed filenames, so they
survive server restarts. Dependency metadata is persisted in
`cache.json` (using eventide serde) with a shared path table for
deduplication.
### Key changes
- **protocol.h**: `output_path` field on `BuildPCHParams` /
`BuildPCMParams` so master specifies where workers write
- **stateless_worker.cpp**: Atomic write via `.tmp` + `fs::rename`;
`CompilationUnit` destroyed before rename to flush the file to disk;
fallback to temp file when `output_path` is empty (unit tests)
- **master_server.h**: `PCMState` struct, `pcm_states` map,
`load_cache()` / `save_cache()` / `cleanup_cache()` methods
- **master_server.cpp**: Cache lifecycle — load from `cache.json` on
startup, save after each PCH/PCM build and on exit; deterministic path
computation (`xxh3` preamble hash for PCH, module name + source path
hash for PCM); stale files (>7 days) cleaned on startup; `cache.json`
uses shared path table to avoid redundant storage of header paths across
entries
- **filesystem.h**: `fs::rename()` helper; `ThreadSafeFS` broadened to
match `.pch` extension instead of `preamble-` prefix
- **tests**: 11 new integration tests covering PCH/PCM persistence,
cross-session reuse, staleness detection, shared preamble dedup, and
restart survival; unit tests updated with `output_path`
### Naming scheme
- **PCH**: `.clice/cache/pch/<016x(xxh3(preamble))>.pch`
- **PCM**:
`.clice/cache/pcm/<module_name>-<016x(xxh3(source_path))>.pcm`
## Test plan
- [x] Unit tests — 448 passed
- [x] Integration tests — 92 passed (including 11 new persistent cache
tests)
- [x] Smoke tests — 1 passed
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
282 lines
7.9 KiB
C++
282 lines
7.9 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";
|
|
params.output_path = tmp.path("test_pch.pch");
|
|
|
|
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";
|
|
params.output_path = tmp.path("test_module.pcm");
|
|
|
|
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
|