[rickisba]

Purpose

Post-merge documentation cleanup after PR #154 / Issue #140. This keeps the repository homepage unchanged while making the module-level READMEs reflect the v0.1.10 runtime, domain-contract, and Gateway structure now present on main.

Changes

• Update core/README.md:
  • add __init__.py and runtime_compat.py to the module map;
  • explain the stable core.runtime_compat import boundary and the dependency-light cacheroute_compat implementation;
  • link to the KDN Runtime Profile vocabulary and the existing v1 runtime compatibility guide.
• Update kdn_server/README.md:
  • preserve all existing operational KDN documentation;
  • expand only the directory map to include domain/, contracts/, gateway/, and util/;
  • link the new packages to their detailed nested READMEs and CPU-only workflow documentation.

Scope

Documentation only.

• Root README.md is unchanged.
• No source code, contract, validation rule, wire value, Gateway behavior, test, or runtime configuration is modified.
• Existing KDN HTTP, CLI, KV construction, injection, screenshots, examples, and Legacy documentation remain in place.

Validation

• Branch comparison against main is limited to core/README.md and kdn_server/README.md.
• The branch is two documentation commits ahead of the PR feat(kdn): define versioned cache service and LMCache gateway contracts #154 merge commit and zero commits behind.
• Relative links point to existing module-level documentation under docs/, kdn_server/, and test/kdn/.

Related to #140 and prepares documentation navigation for research on #141.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1564b55752

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Point the runtime guide link at doc/

The newly added link resolves to docs/runtime_compatibility_v1.md, which does not exist, so readers following the migration/startup documentation receive a 404. A repo-wide path search at this commit finds the guide at doc/runtime_compatibility_v1.md; update the relative target to ../doc/runtime_compatibility_v1.md.

AGENTS.md reference: AGENTS.md:L273-L277

Useful? React with 👍 / 👎.