CxLLM-Kernel/README.md
CxLLM Buildout f96859068e chore(scaffold): full repo build-out
Adds README, LICENSE (MIT), .gitignore, Makefile, CONTRIBUTING, CHANGELOG,
SECURITY, CODEOWNERS, .editorconfig, .github/workflows/ci.yml, and
docs/ARCHITECTURE.md + docs/adr/0001 to bring this repository up to the
CxLLM family baseline.
2026-05-17 11:05:49 -05:00

54 lines
1.8 KiB
Markdown

# CxLLM-Kernel
> CxLLM-Kernel — kernel module
`CxLLM-Kernel` is part of the CxLLM family. This repository hosts the kernel surface and is intentionally narrow so it can compose with sibling modules without dragging in unrelated dependencies.
[![ci](https://cxai-studio.com/git/CxAI-Projects/CxLLM-Kernel/actions/workflows/ci.yml/badge.svg)](https://cxai-studio.com/git/CxAI-Projects/CxLLM-Kernel/actions)
[![license](https://img.shields.io/badge/license-MIT-7C3AED)](LICENSE)
[![category](https://img.shields.io/badge/category-kernel-1F6FEB)](#)
## Overview
`CxLLM-Kernel` is part of the **CxLLM** product family — a layered runtime that
spans Apple kernel extensions, user-space frameworks, host applications, and
spatial / web surfaces. This module focuses on **kernel** concerns and is
intentionally narrow so that the CxLLM monorepo can compose targets without
pulling in unrelated dependencies.
## Repository layout
- `CxLLM-Kernel/` — primary source folder (matches the Xcode group / SwiftPM root).
- `CxLLM-Kernel.xcodeproj` — Xcode project (where applicable).
- `Makefile` — common entry points (`build`, `test`, `lint`, `clean`).
- `.github/workflows/ci.yml` — CI pipeline (Xcode build + lint).
- `docs/` — architecture notes and ADRs.
## Quick start
```bash
# Build (defaults to Debug for the host platform):
make build
# Run the full test suite (unit + UI where applicable):
make test
# Static analysis + format check:
make lint
```
## Versioning
This module follows [Semantic Versioning 2.0](https://semver.org/) and is
released in lock-step with the umbrella **CxLLM** product line. See
[`CHANGELOG.md`](CHANGELOG.md) for the user-facing change log.
## Security
Please report security issues per [`SECURITY.md`](SECURITY.md). Do **not**
open public issues for vulnerabilities.
## License
Released under the [MIT License](LICENSE) © 2026 CxAI-LLM.