# CxLLM-MAC-BNDL

> CxLLM-MAC-BNDL — app-macos module

`CxLLM-MAC-BNDL` is part of the CxLLM family. This repository hosts the app-macos 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-MAC-BNDL/actions/workflows/ci.yml/badge.svg)](https://cxai-studio.com/git/CxAI-Projects/CxLLM-MAC-BNDL/actions)
[![license](https://img.shields.io/badge/license-MIT-7C3AED)](LICENSE)
[![category](https://img.shields.io/badge/category-app-macos-1F6FEB)](#)

## Overview

`CxLLM-MAC-BNDL` 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 **app-macos** concerns and is
intentionally narrow so that the CxLLM monorepo can compose targets without
pulling in unrelated dependencies.

## Repository layout

- `CxLLM-MAC-BNDL/` — primary source folder (matches the Xcode group / SwiftPM root).
- `CxLLM-MAC-BNDL.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.
