Initial libmcp 1.0.0

1 files changed, 34 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0a857e9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# libmcp
+
+Industrial MCP hardening spine.
+
+`libmcp` is the shared operational substrate extracted from long-lived MCP
+servers. It owns:
+
+- typed replay and fault contracts
+- JSON-RPC frame and request identity helpers
+- model-facing rendering doctrine, especially porcelain-by-default output
+- normalization utilities for model input friction
+- standard health and telemetry payloads
+- JSONL operational telemetry
+- hardening test support
+
+This repository is also the canonical owner of the `$mcp-bootstrap` Codex
+skill. The installed skill should be a symlink into this repository so the skill
+version tracks the library version and doctrine.
+
+## Status
+
+`libmcp` `1.0.0` is locked against a clean integration with
+`adequate_rust_mcp`.
+
+`fidget_spinner` is intentionally not part of `1.0.0`; it will be revisited
+later once its transport shape is settled.
+
+## Layout
+
+- `docs/spec.md`: normative design and versioning contract
+- `crates/libmcp`: public library crate
+- `crates/libmcp-testkit`: shared hardening fixtures and assertions
+- `assets/codex-skills/mcp-bootstrap`: canonical skill source
+- `scripts/link-codex-skills`: installs the repo-owned skill into `~/.codex`