sediment-palace

# SedimentPalace MCP SedimentPalace MCP is a local-first memory engine for AI agents with layered sedimentation, policy controls, journaling, recovery, and telemetry. ## Features - Layered memory model (`01_Shallow`, `02_Sediment`, `03_Bedrock`) - Structured MCP tool responses (`result.data` / `result.error`) - Policy engine (confirm checks, rate limits, budgets) - Operation journal + recovery flow - Per-tool telemetry and metrics snapshot - Healthcheck endpoint for runtime readiness ## Quick Start ```bash python -m pip install -e ".[dev]" pytest -q python -m sediment_palace.main ``` ## Project Bootstrap (Recommended) Initialize a target workspace with local agent configs, memory folders, and instruction files: ```bat start.bat --workspace D:\Projects\MyWork --agents codex,claude,qwen,opencode,kimi ``` What this creates in the workspace: - `memory/` layout (`01_Shallow`, `02_Sediment`, `03_Bedrock`, `_System`, `_Archive`, `PALACE_MAP.md`) - `AGENT_BOOTSTRAP.md` - Agent instruction files (for selected agents): `AGENTS.md`, `CODEX.md`, `CLAUDE.md`, `QWEN.md`, `OPENCODE.md`, `KIMI.md` - Local agent config files (`.codex/config.toml`, `.qwen/settings.json`, `.opencode/opencode.json`, `.kimi/settings.json`, `.mcp.json`) Global config mode is optional: ```bat start.bat --scope global --workspace D:\Projects\MyWork --agents codex,claude ``` ## Runtime Configuration Set via environment variables: - `SEDIMENT_PROJECT_ROOT` (default: `.`) - `SEDIMENT_TIMEOUT_DEFAULT_SECONDS` (default: `2.0`) - `SEDIMENT_TIMEOUT_METABOLIZE_SECONDS` (default: `5.0`) - `SEDIMENT_BUDGET_WRITE_CONTENT` (default: `50000`) - `SEDIMENT_BUDGET_READ_QUERY` (default: `512`) - `SEDIMENT_BUDGET_SEARCH_QUERY` (default: `512`) - `SEDIMENT_BUDGET_SEARCH_ROOM` (default: `1024`) - `SEDIMENT_BUDGET_PURGE_REASON` (default: `1024`) ## Documentation - Language index: `docs/README.md` - English docs: `docs/en/README.md` - Russian docs: `docs/ru/README.md` - Plug-and-play bootstrap prompt: `AGENT_BOOTSTRAP.md` ## Quality Gates - `python -m ruff check src tests` - `python -m mypy src` - `pytest -q` CI runs all gates on push and pull requests. ## Open Source Files - `LICENSE` - `CONTRIBUTING.md` - `CODE_OF_CONDUCT.md` - `SECURITY.md` - `SUPPORT.md` - `.github/ISSUE_TEMPLATE/*` - `.github/PULL_REQUEST_TEMPLATE.md` ## Release - Latest RC tag: `v0.1.0-rc1` - For release process, use Git tags and GitHub Releases.