b6886d222b
## Summary
Implement structured file-based logging with per-component separation
and crash stacktrace capture.
### Log output structure
```
.clice/logs/2026-04-05_10-30-00_<pid>/
master.log
SF-0.log
SF-1.log
SL-0.log
```
### Changes
**Logging infrastructure** (`logging.h`, `logging.cpp`)
- `file_logger()` creates a dual-sink logger (file + stderr), so logs go
to both the file and terminal
- Pre-checks log directory creation and file writability before
constructing spdlog sinks; falls back to existing stderr logger on
failure
- `install_crash_handler()` uses LLVM's `AddSignalHandler` +
`PrintStackTraceOnErrorSignal` to write crash stacktraces into the
component's log file (and also to stderr)
- Fix `LOG_MESSAGE` macro: wrap in `do { } while(0)` to prevent
dangling-else
- Fix typo: `file_loggger` → `file_logger`
**Config** (`config.h`, `config.cpp`)
- Add `logging_dir` field to `CliceConfig`, defaulting to
`<cache_dir>/logs/`
- Apply `${workspace}` variable substitution to `logging_dir`
**Master server** (`master_server.h`, `master_server.cpp`)
- After config loads, create a session directory named
`<timestamp>_<pid>` under `logging_dir` and switch master to file
logging
- Pass session log directory to worker pool
**Worker pool** (`worker_pool.h`, `worker_pool.cpp`)
- Pass `--worker-name` (e.g. `SF-0`, `SL-1`) and `--log-dir` to spawned
worker processes
- Add `log_dir` to `WorkerPoolOptions`
**Workers** (`stateful_worker.h/cpp`, `stateless_worker.h/cpp`)
- Accept `worker_name` and `log_dir` parameters; switch to file logging
when `log_dir` is provided
**CLI cleanup** (`clice.cc`)
- Remove `--stateful-worker-count`, `--stateless-worker-count` from CLI
(config-file only)
- Group internal worker args (`--worker-memory-limit`, `--worker-name`,
`--log-dir`) separately
**Docs** (`docs/clice.toml`)
- Fix `logging_dir` example: `.clice/logging` → `.clice/logs`
## Test plan
- [x] `pixi run cmake-build RelWithDebInfo` compiles successfully
- [ ] Verify log files created under `.clice/logs/<timestamp>_<pid>/`
- [ ] Verify each component writes to its own file
- [ ] Verify crash stacktrace appears in component log file
- [ ] Verify `logging_dir` override in `clice.toml` works
- [ ] Verify graceful fallback when log directory is not writable
🤖 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**
* Session-specific logging directories (timestamped) and per-worker log
files
* CLI options to set worker name and log directory; general log level
control
* Configurable logging directory with default `<cache_dir>/logs/`
* **Bug Fixes**
* Fixed file-logging name/initialization issues; ensures directory
creation and deterministic filenames
* Added crash-handler support to append stack traces to logs
* **Documentation**
* Updated example config to use `${workspace}/.clice/logs`
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
48 lines
2.1 KiB
TOML
48 lines
2.1 KiB
TOML
## # clice configuration
|
|
|
|
# This section outlines the supported built-in variables for clice.
|
|
# These variables can be referenced in strings using the syntax `${var}`.
|
|
|
|
# Supported variables:
|
|
# - `${version}`: The version of clice.
|
|
# - `${llvm_version}`: The LLVM version used by clice.
|
|
# - `${workspace}`: The workspace directory provided by the client.
|
|
|
|
[project]
|
|
# Enable experimental clang-tidy diagnostics.
|
|
# This feature is tracked in https://github.com/clice-project/clice/issues/90.
|
|
clang_tidy = false
|
|
# Maximum number of active files to keep in memory. If the number of active files
|
|
# exceeds this limit, the least recently used files will be removed.
|
|
# The default value is 8. Whatever the number you set, the minimum is 1, the maximum is 512.
|
|
max_active_file = 8
|
|
# Directory for storing PCH and PCM files.
|
|
cache_dir = "${workspace}/.clice/cache"
|
|
# Directory for storing index files.
|
|
index_dir = "${workspace}/.clice/index"
|
|
logging_dir = "${workspace}/.clice/logs"
|
|
# Compile commands files or directories to search for compile_commands.json files.
|
|
compile_commands_paths = ["${workspace}/build"]
|
|
|
|
# Control the behavior for specific files. Note that Clice matches rules
|
|
# in order. If you want to add your own rules, either delete this rule
|
|
# or insert your rule before it.
|
|
[[rules]]
|
|
# Files matching the specified pattern will have this rule applied.
|
|
#
|
|
# Patterns can use the following syntax:
|
|
# - `*`: Matches one or more characters in a path segment.
|
|
# - `?`: Matches a single character in a path segment.
|
|
# - `**`: Matches any number of path segments, including none.
|
|
# - `{}`: Groups conditions (e.g., `**/*.{ts,js}` matches all TypeScript
|
|
# and JavaScript files).
|
|
# - `[]`: Declares a range of characters to match in a path segment
|
|
# (e.g., `example.[0-9]` matches `example.0`, `example.1`, etc.).
|
|
# - `[!...]`: Negates a range of characters to match in a path segment
|
|
# (e.g., `example.[!0-9]` matches `example.a`, `example.b`, but not `example.0`).
|
|
patterns = ["**/*"]
|
|
# Commands to append to the original command list (e.g., ["-std=c++17"]).
|
|
append = []
|
|
# Commands to remove from the original command list.
|
|
remove = []
|