chore: initial commit (Phase 3 scaffold)
Some checks are pending
ci / validate (push) Waiting to run

This commit is contained in:
CxAI Ops 2026-05-16 10:52:05 -05:00
commit a37afee2fe
24 changed files with 1210 additions and 0 deletions

15
.editorconfig Normal file
View File

@ -0,0 +1,15 @@
root = true
[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
indent_style = space
indent_size = 4
[*.{yml,yaml,json,md}]
indent_size = 2
[Makefile]
indent_style = tab

36
.gitea/workflows/ci.yml Normal file
View File

@ -0,0 +1,36 @@
name: ci
on:
push:
branches: [main, master]
pull_request: {}
workflow_dispatch: {}
# We run a Linux runner; macOS xcodebuild is not available here.
# This workflow validates structure (yaml, file presence) and basic Swift.
jobs:
validate:
runs-on: cxai-hostinger
container: debian:bookworm
steps:
- name: Install deps
run: |
apt-get update -qq
apt-get install -y --no-install-recommends git ca-certificates curl python3-yaml >/dev/null
- uses: actions/checkout@v4
- name: Lint workflow YAML
run: |
python3 - <<'PY'
import sys, yaml, glob
for f in glob.glob('.gitea/workflows/*.yml') + glob.glob('.github/workflows/*.yml'):
try:
yaml.safe_load(open(f))
except Exception as e:
print(f'YAML ERROR {f}: {e}'); sys.exit(1)
print('workflows ok')
PY
- name: Project sanity
run: |
test -f README.md || (echo "missing README" && exit 1)
test -f Makefile || (echo "missing Makefile" && exit 1)
ls *.xcodeproj >/dev/null 2>&1 && echo "xcodeproj: $(ls -d *.xcodeproj)" || true
[ -f Package.swift ] && echo "Package.swift present" || true

27
.github/workflows/ci.yml vendored Normal file
View File

@ -0,0 +1,27 @@
name: ci
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
build:
name: build (${{ matrix.os }})
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
os: [macos-14]
steps:
- uses: actions/checkout@v4
- name: Show toolchain
run: |
xcodebuild -version || true
swift --version || true
- name: Build
run: make build
- name: Test
run: make test
- name: Lint
run: make lint

54
.gitignore vendored Normal file
View File

@ -0,0 +1,54 @@
# macOS
.DS_Store
.AppleDouble
.LSOverride
Icon?
# Xcode
build/
DerivedData/
*.xcworkspace/xcuserdata/
*.xcodeproj/xcuserdata/
*.xcodeproj/project.xcworkspace/xcuserdata/
*.xcuserstate
*.moved-aside
*.pbxuser
!default.pbxuser
*.mode1v3
!default.mode1v3
*.mode2v3
!default.mode2v3
*.perspectivev3
!default.perspectivev3
# SwiftPM
.build/
.swiftpm/xcode/
.swiftpm/configuration/
Package.resolved
# CocoaPods / Carthage
Pods/
Carthage/Build/
# fastlane
fastlane/report.xml
fastlane/Preview.html
fastlane/screenshots/**/*.png
fastlane/test_output/
# Coverage
*.gcno
*.gcda
*.profdata
*.profraw
coverage/
# Editors
.vscode/
.idea/
*.swp
# Local
*.local
secrets.env

16
CHANGELOG.md Normal file
View File

@ -0,0 +1,16 @@
# Changelog
All notable changes to this project will be documented here.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
and this project adheres to [Semantic Versioning](https://semver.org/).
## [Unreleased]
### Added
- Repository scaffolding: README, LICENSE (MIT), .gitignore, Makefile,
CONTRIBUTING, SECURITY, CODEOWNERS, .editorconfig, CI workflow.
## [0.1.0] - 2026-04-22
### Added
- Initial app-macos scaffold for CxLLM-OS-APP.

6
CODEOWNERS Normal file
View File

@ -0,0 +1,6 @@
# Default owners for everything in this repo.
* @CxAI-LLM/maintainers
# Build & CI
/.github/ @CxAI-LLM/devops
/Makefile @CxAI-LLM/devops

23
CONTRIBUTING.md Normal file
View File

@ -0,0 +1,23 @@
# Contributing to CxLLM-OS-APP
Thanks for taking the time to contribute!
## Workflow
1. Open an issue describing the change before sending a PR for non-trivial work.
2. Fork / branch off `main`. Use a descriptive branch name (`feat/...`, `fix/...`).
3. Keep commits scoped and use **Conventional Commits** (`feat:`, `fix:`,
`docs:`, `refactor:`, `test:`, `chore:`).
4. Run `make lint` and `make test` before pushing.
5. Open a PR — CI must pass before review.
## Coding style
- Swift: `swiftformat` defaults + `swiftlint` rules from the umbrella repo.
- Objective-C / C / C++: clang-format `-style=Google`.
- No tabs in Swift; 4-space indent in C/C++.
## Code of conduct
By contributing you agree to abide by the project's Code of Conduct
(see the umbrella `cxllm-code` repo).

View File

@ -0,0 +1,578 @@
// !$*UTF8*$!
{
archiveVersion = 1;
classes = {
};
objectVersion = 77;
objects = {
/* Begin PBXContainerItemProxy section */
20F2AFE72F99720200E7D2D9 /* PBXContainerItemProxy */ = {
isa = PBXContainerItemProxy;
containerPortal = 20F2AFCF2F99720000E7D2D9 /* Project object */;
proxyType = 1;
remoteGlobalIDString = 20F2AFD62F99720000E7D2D9;
remoteInfo = "CxLLM-OS-APP";
};
20F2AFF12F99720200E7D2D9 /* PBXContainerItemProxy */ = {
isa = PBXContainerItemProxy;
containerPortal = 20F2AFCF2F99720000E7D2D9 /* Project object */;
proxyType = 1;
remoteGlobalIDString = 20F2AFD62F99720000E7D2D9;
remoteInfo = "CxLLM-OS-APP";
};
/* End PBXContainerItemProxy section */
/* Begin PBXFileReference section */
20F2AFD72F99720000E7D2D9 /* CxLLM-OS-APP.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "CxLLM-OS-APP.app"; sourceTree = BUILT_PRODUCTS_DIR; };
20F2AFE62F99720200E7D2D9 /* CxLLM-OS-APPTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "CxLLM-OS-APPTests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; };
20F2AFF02F99720200E7D2D9 /* CxLLM-OS-APPUITests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "CxLLM-OS-APPUITests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; };
/* End PBXFileReference section */
/* Begin PBXFileSystemSynchronizedRootGroup section */
20F2AFD92F99720000E7D2D9 /* CxLLM-OS-APP */ = {
isa = PBXFileSystemSynchronizedRootGroup;
path = "CxLLM-OS-APP";
sourceTree = "<group>";
};
20F2AFE92F99720200E7D2D9 /* CxLLM-OS-APPTests */ = {
isa = PBXFileSystemSynchronizedRootGroup;
path = "CxLLM-OS-APPTests";
sourceTree = "<group>";
};
20F2AFF32F99720200E7D2D9 /* CxLLM-OS-APPUITests */ = {
isa = PBXFileSystemSynchronizedRootGroup;
path = "CxLLM-OS-APPUITests";
sourceTree = "<group>";
};
/* End PBXFileSystemSynchronizedRootGroup section */
/* Begin PBXFrameworksBuildPhase section */
20F2AFD42F99720000E7D2D9 /* Frameworks */ = {
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
20F2AFE32F99720200E7D2D9 /* Frameworks */ = {
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
20F2AFED2F99720200E7D2D9 /* Frameworks */ = {
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXFrameworksBuildPhase section */
/* Begin PBXGroup section */
20F2AFCE2F99720000E7D2D9 = {
isa = PBXGroup;
children = (
20F2AFD92F99720000E7D2D9 /* CxLLM-OS-APP */,
20F2AFE92F99720200E7D2D9 /* CxLLM-OS-APPTests */,
20F2AFF32F99720200E7D2D9 /* CxLLM-OS-APPUITests */,
20F2AFD82F99720000E7D2D9 /* Products */,
);
sourceTree = "<group>";
};
20F2AFD82F99720000E7D2D9 /* Products */ = {
isa = PBXGroup;
children = (
20F2AFD72F99720000E7D2D9 /* CxLLM-OS-APP.app */,
20F2AFE62F99720200E7D2D9 /* CxLLM-OS-APPTests.xctest */,
20F2AFF02F99720200E7D2D9 /* CxLLM-OS-APPUITests.xctest */,
);
name = Products;
sourceTree = "<group>";
};
/* End PBXGroup section */
/* Begin PBXNativeTarget section */
20F2AFD62F99720000E7D2D9 /* CxLLM-OS-APP */ = {
isa = PBXNativeTarget;
buildConfigurationList = 20F2AFFA2F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APP" */;
buildPhases = (
20F2AFD32F99720000E7D2D9 /* Sources */,
20F2AFD42F99720000E7D2D9 /* Frameworks */,
20F2AFD52F99720000E7D2D9 /* Resources */,
);
buildRules = (
);
dependencies = (
);
fileSystemSynchronizedGroups = (
20F2AFD92F99720000E7D2D9 /* CxLLM-OS-APP */,
);
name = "CxLLM-OS-APP";
packageProductDependencies = (
);
productName = "CxLLM-OS-APP";
productReference = 20F2AFD72F99720000E7D2D9 /* CxLLM-OS-APP.app */;
productType = "com.apple.product-type.application";
};
20F2AFE52F99720200E7D2D9 /* CxLLM-OS-APPTests */ = {
isa = PBXNativeTarget;
buildConfigurationList = 20F2AFFD2F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APPTests" */;
buildPhases = (
20F2AFE22F99720200E7D2D9 /* Sources */,
20F2AFE32F99720200E7D2D9 /* Frameworks */,
20F2AFE42F99720200E7D2D9 /* Resources */,
);
buildRules = (
);
dependencies = (
20F2AFE82F99720200E7D2D9 /* PBXTargetDependency */,
);
fileSystemSynchronizedGroups = (
20F2AFE92F99720200E7D2D9 /* CxLLM-OS-APPTests */,
);
name = "CxLLM-OS-APPTests";
packageProductDependencies = (
);
productName = "CxLLM-OS-APPTests";
productReference = 20F2AFE62F99720200E7D2D9 /* CxLLM-OS-APPTests.xctest */;
productType = "com.apple.product-type.bundle.unit-test";
};
20F2AFEF2F99720200E7D2D9 /* CxLLM-OS-APPUITests */ = {
isa = PBXNativeTarget;
buildConfigurationList = 20F2B0002F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APPUITests" */;
buildPhases = (
20F2AFEC2F99720200E7D2D9 /* Sources */,
20F2AFED2F99720200E7D2D9 /* Frameworks */,
20F2AFEE2F99720200E7D2D9 /* Resources */,
);
buildRules = (
);
dependencies = (
20F2AFF22F99720200E7D2D9 /* PBXTargetDependency */,
);
fileSystemSynchronizedGroups = (
20F2AFF32F99720200E7D2D9 /* CxLLM-OS-APPUITests */,
);
name = "CxLLM-OS-APPUITests";
packageProductDependencies = (
);
productName = "CxLLM-OS-APPUITests";
productReference = 20F2AFF02F99720200E7D2D9 /* CxLLM-OS-APPUITests.xctest */;
productType = "com.apple.product-type.bundle.ui-testing";
};
/* End PBXNativeTarget section */
/* Begin PBXProject section */
20F2AFCF2F99720000E7D2D9 /* Project object */ = {
isa = PBXProject;
attributes = {
BuildIndependentTargetsInParallel = 1;
LastSwiftUpdateCheck = 2630;
LastUpgradeCheck = 2630;
TargetAttributes = {
20F2AFD62F99720000E7D2D9 = {
CreatedOnToolsVersion = 26.3;
};
20F2AFE52F99720200E7D2D9 = {
CreatedOnToolsVersion = 26.3;
TestTargetID = 20F2AFD62F99720000E7D2D9;
};
20F2AFEF2F99720200E7D2D9 = {
CreatedOnToolsVersion = 26.3;
TestTargetID = 20F2AFD62F99720000E7D2D9;
};
};
};
buildConfigurationList = 20F2AFD22F99720000E7D2D9 /* Build configuration list for PBXProject "CxLLM-OS-APP" */;
developmentRegion = en;
hasScannedForEncodings = 0;
knownRegions = (
en,
Base,
);
mainGroup = 20F2AFCE2F99720000E7D2D9;
minimizedProjectReferenceProxies = 1;
preferredProjectObjectVersion = 77;
productRefGroup = 20F2AFD82F99720000E7D2D9 /* Products */;
projectDirPath = "";
projectRoot = "";
targets = (
20F2AFD62F99720000E7D2D9 /* CxLLM-OS-APP */,
20F2AFE52F99720200E7D2D9 /* CxLLM-OS-APPTests */,
20F2AFEF2F99720200E7D2D9 /* CxLLM-OS-APPUITests */,
);
};
/* End PBXProject section */
/* Begin PBXResourcesBuildPhase section */
20F2AFD52F99720000E7D2D9 /* Resources */ = {
isa = PBXResourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
20F2AFE42F99720200E7D2D9 /* Resources */ = {
isa = PBXResourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
20F2AFEE2F99720200E7D2D9 /* Resources */ = {
isa = PBXResourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXResourcesBuildPhase section */
/* Begin PBXSourcesBuildPhase section */
20F2AFD32F99720000E7D2D9 /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
20F2AFE22F99720200E7D2D9 /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
20F2AFEC2F99720200E7D2D9 /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXSourcesBuildPhase section */
/* Begin PBXTargetDependency section */
20F2AFE82F99720200E7D2D9 /* PBXTargetDependency */ = {
isa = PBXTargetDependency;
target = 20F2AFD62F99720000E7D2D9 /* CxLLM-OS-APP */;
targetProxy = 20F2AFE72F99720200E7D2D9 /* PBXContainerItemProxy */;
};
20F2AFF22F99720200E7D2D9 /* PBXTargetDependency */ = {
isa = PBXTargetDependency;
target = 20F2AFD62F99720000E7D2D9 /* CxLLM-OS-APP */;
targetProxy = 20F2AFF12F99720200E7D2D9 /* PBXContainerItemProxy */;
};
/* End PBXTargetDependency section */
/* Begin XCBuildConfiguration section */
20F2AFF82F99720200E7D2D9 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
ALWAYS_SEARCH_USER_PATHS = NO;
ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
CLANG_ANALYZER_NONNULL = YES;
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
CLANG_ENABLE_OBJC_WEAK = YES;
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
CLANG_WARN_BOOL_CONVERSION = YES;
CLANG_WARN_COMMA = YES;
CLANG_WARN_CONSTANT_CONVERSION = YES;
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
CLANG_WARN_EMPTY_BODY = YES;
CLANG_WARN_ENUM_CONVERSION = YES;
CLANG_WARN_INFINITE_RECURSION = YES;
CLANG_WARN_INT_CONVERSION = YES;
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
CLANG_WARN_STRICT_PROTOTYPES = YES;
CLANG_WARN_SUSPICIOUS_MOVE = YES;
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
CLANG_WARN_UNREACHABLE_CODE = YES;
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
COPY_PHASE_STRIP = NO;
DEBUG_INFORMATION_FORMAT = dwarf;
DEVELOPMENT_TEAM = DKWVC9FQJY;
ENABLE_STRICT_OBJC_MSGSEND = YES;
ENABLE_TESTABILITY = YES;
ENABLE_USER_SCRIPT_SANDBOXING = YES;
GCC_C_LANGUAGE_STANDARD = gnu17;
GCC_DYNAMIC_NO_PIC = NO;
GCC_NO_COMMON_BLOCKS = YES;
GCC_OPTIMIZATION_LEVEL = 0;
GCC_PREPROCESSOR_DEFINITIONS = (
"DEBUG=1",
"$(inherited)",
);
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
GCC_WARN_UNDECLARED_SELECTOR = YES;
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
MACOSX_DEPLOYMENT_TARGET = 26.2;
MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
MTL_FAST_MATH = YES;
ONLY_ACTIVE_ARCH = YES;
SDKROOT = macosx;
SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG $(inherited)";
SWIFT_OPTIMIZATION_LEVEL = "-Onone";
};
name = Debug;
};
20F2AFF92F99720200E7D2D9 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ALWAYS_SEARCH_USER_PATHS = NO;
ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
CLANG_ANALYZER_NONNULL = YES;
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
CLANG_ENABLE_OBJC_WEAK = YES;
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
CLANG_WARN_BOOL_CONVERSION = YES;
CLANG_WARN_COMMA = YES;
CLANG_WARN_CONSTANT_CONVERSION = YES;
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
CLANG_WARN_EMPTY_BODY = YES;
CLANG_WARN_ENUM_CONVERSION = YES;
CLANG_WARN_INFINITE_RECURSION = YES;
CLANG_WARN_INT_CONVERSION = YES;
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
CLANG_WARN_STRICT_PROTOTYPES = YES;
CLANG_WARN_SUSPICIOUS_MOVE = YES;
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
CLANG_WARN_UNREACHABLE_CODE = YES;
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
COPY_PHASE_STRIP = NO;
DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
DEVELOPMENT_TEAM = DKWVC9FQJY;
ENABLE_NS_ASSERTIONS = NO;
ENABLE_STRICT_OBJC_MSGSEND = YES;
ENABLE_USER_SCRIPT_SANDBOXING = YES;
GCC_C_LANGUAGE_STANDARD = gnu17;
GCC_NO_COMMON_BLOCKS = YES;
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
GCC_WARN_UNDECLARED_SELECTOR = YES;
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
MACOSX_DEPLOYMENT_TARGET = 26.2;
MTL_ENABLE_DEBUG_INFO = NO;
MTL_FAST_MATH = YES;
SDKROOT = macosx;
SWIFT_COMPILATION_MODE = wholemodule;
};
name = Release;
};
20F2AFFB2F99720200E7D2D9 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
CODE_SIGN_STYLE = Automatic;
COMBINE_HIDPI_IMAGES = YES;
CURRENT_PROJECT_VERSION = 1;
DEVELOPMENT_TEAM = DKWVC9FQJY;
ENABLE_APP_SANDBOX = YES;
ENABLE_HARDENED_RUNTIME = YES;
ENABLE_PREVIEWS = YES;
ENABLE_USER_SELECTED_FILES = readonly;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_KEY_NSHumanReadableCopyright = "";
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
);
MARKETING_VERSION = 1.0;
PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APP";
PRODUCT_NAME = "$(TARGET_NAME)";
REGISTER_APP_GROUPS = YES;
STRING_CATALOG_GENERATE_SYMBOLS = YES;
SWIFT_APPROACHABLE_CONCURRENCY = YES;
SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor;
SWIFT_EMIT_LOC_STRINGS = YES;
SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
SWIFT_VERSION = 5.0;
};
name = Debug;
};
20F2AFFC2F99720200E7D2D9 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
CODE_SIGN_STYLE = Automatic;
COMBINE_HIDPI_IMAGES = YES;
CURRENT_PROJECT_VERSION = 1;
DEVELOPMENT_TEAM = DKWVC9FQJY;
ENABLE_APP_SANDBOX = YES;
ENABLE_HARDENED_RUNTIME = YES;
ENABLE_PREVIEWS = YES;
ENABLE_USER_SELECTED_FILES = readonly;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_KEY_NSHumanReadableCopyright = "";
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
);
MARKETING_VERSION = 1.0;
PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APP";
PRODUCT_NAME = "$(TARGET_NAME)";
REGISTER_APP_GROUPS = YES;
STRING_CATALOG_GENERATE_SYMBOLS = YES;
SWIFT_APPROACHABLE_CONCURRENCY = YES;
SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor;
SWIFT_EMIT_LOC_STRINGS = YES;
SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
SWIFT_VERSION = 5.0;
};
name = Release;
};
20F2AFFE2F99720200E7D2D9 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
BUNDLE_LOADER = "$(TEST_HOST)";
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 1;
DEVELOPMENT_TEAM = DKWVC9FQJY;
GENERATE_INFOPLIST_FILE = YES;
MACOSX_DEPLOYMENT_TARGET = 26.2;
MARKETING_VERSION = 1.0;
PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APPTests";
PRODUCT_NAME = "$(TARGET_NAME)";
STRING_CATALOG_GENERATE_SYMBOLS = NO;
SWIFT_APPROACHABLE_CONCURRENCY = YES;
SWIFT_EMIT_LOC_STRINGS = NO;
SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
SWIFT_VERSION = 5.0;
TEST_HOST = "$(BUILT_PRODUCTS_DIR)/CxLLM-OS-APP.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/CxLLM-OS-APP";
};
name = Debug;
};
20F2AFFF2F99720200E7D2D9 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
BUNDLE_LOADER = "$(TEST_HOST)";
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 1;
DEVELOPMENT_TEAM = DKWVC9FQJY;
GENERATE_INFOPLIST_FILE = YES;
MACOSX_DEPLOYMENT_TARGET = 26.2;
MARKETING_VERSION = 1.0;
PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APPTests";
PRODUCT_NAME = "$(TARGET_NAME)";
STRING_CATALOG_GENERATE_SYMBOLS = NO;
SWIFT_APPROACHABLE_CONCURRENCY = YES;
SWIFT_EMIT_LOC_STRINGS = NO;
SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
SWIFT_VERSION = 5.0;
TEST_HOST = "$(BUILT_PRODUCTS_DIR)/CxLLM-OS-APP.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/CxLLM-OS-APP";
};
name = Release;
};
20F2B0012F99720200E7D2D9 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 1;
DEVELOPMENT_TEAM = DKWVC9FQJY;
GENERATE_INFOPLIST_FILE = YES;
MARKETING_VERSION = 1.0;
PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APPUITests";
PRODUCT_NAME = "$(TARGET_NAME)";
STRING_CATALOG_GENERATE_SYMBOLS = NO;
SWIFT_APPROACHABLE_CONCURRENCY = YES;
SWIFT_EMIT_LOC_STRINGS = NO;
SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
SWIFT_VERSION = 5.0;
TEST_TARGET_NAME = "CxLLM-OS-APP";
};
name = Debug;
};
20F2B0022F99720200E7D2D9 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 1;
DEVELOPMENT_TEAM = DKWVC9FQJY;
GENERATE_INFOPLIST_FILE = YES;
MARKETING_VERSION = 1.0;
PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APPUITests";
PRODUCT_NAME = "$(TARGET_NAME)";
STRING_CATALOG_GENERATE_SYMBOLS = NO;
SWIFT_APPROACHABLE_CONCURRENCY = YES;
SWIFT_EMIT_LOC_STRINGS = NO;
SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
SWIFT_VERSION = 5.0;
TEST_TARGET_NAME = "CxLLM-OS-APP";
};
name = Release;
};
/* End XCBuildConfiguration section */
/* Begin XCConfigurationList section */
20F2AFD22F99720000E7D2D9 /* Build configuration list for PBXProject "CxLLM-OS-APP" */ = {
isa = XCConfigurationList;
buildConfigurations = (
20F2AFF82F99720200E7D2D9 /* Debug */,
20F2AFF92F99720200E7D2D9 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
20F2AFFA2F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APP" */ = {
isa = XCConfigurationList;
buildConfigurations = (
20F2AFFB2F99720200E7D2D9 /* Debug */,
20F2AFFC2F99720200E7D2D9 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
20F2AFFD2F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APPTests" */ = {
isa = XCConfigurationList;
buildConfigurations = (
20F2AFFE2F99720200E7D2D9 /* Debug */,
20F2AFFF2F99720200E7D2D9 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
20F2B0002F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APPUITests" */ = {
isa = XCConfigurationList;
buildConfigurations = (
20F2B0012F99720200E7D2D9 /* Debug */,
20F2B0022F99720200E7D2D9 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
/* End XCConfigurationList section */
};
rootObject = 20F2AFCF2F99720000E7D2D9 /* Project object */;
}

View File

@ -0,0 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<Workspace
version = "1.0">
<FileRef
location = "self:">
</FileRef>
</Workspace>

View File

@ -0,0 +1,11 @@
{
"colors" : [
{
"idiom" : "universal"
}
],
"info" : {
"author" : "xcode",
"version" : 1
}
}

View File

@ -0,0 +1,58 @@
{
"images" : [
{
"idiom" : "mac",
"scale" : "1x",
"size" : "16x16"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "16x16"
},
{
"idiom" : "mac",
"scale" : "1x",
"size" : "32x32"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "32x32"
},
{
"idiom" : "mac",
"scale" : "1x",
"size" : "128x128"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "128x128"
},
{
"idiom" : "mac",
"scale" : "1x",
"size" : "256x256"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "256x256"
},
{
"idiom" : "mac",
"scale" : "1x",
"size" : "512x512"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "512x512"
}
],
"info" : {
"author" : "xcode",
"version" : 1
}
}

View File

@ -0,0 +1,6 @@
{
"info" : {
"author" : "xcode",
"version" : 1
}
}

View File

@ -0,0 +1,59 @@
//
// ContentView.swift
// CxLLM-OS-APP
//
// Created by Stephen Carter on 4/22/26.
//
import SwiftUI
import SwiftData
struct ContentView: View {
@Environment(\.modelContext) private var modelContext
@Query private var items: [Item]
var body: some View {
NavigationSplitView {
List {
ForEach(items) { item in
NavigationLink {
Text("Item at \(item.timestamp, format: Date.FormatStyle(date: .numeric, time: .standard))")
} label: {
Text(item.timestamp, format: Date.FormatStyle(date: .numeric, time: .standard))
}
}
.onDelete(perform: deleteItems)
}
.navigationSplitViewColumnWidth(min: 180, ideal: 200)
.toolbar {
ToolbarItem {
Button(action: addItem) {
Label("Add Item", systemImage: "plus")
}
}
}
} detail: {
Text("Select an item")
}
}
private func addItem() {
withAnimation {
let newItem = Item(timestamp: Date())
modelContext.insert(newItem)
}
}
private func deleteItems(offsets: IndexSet) {
withAnimation {
for index in offsets {
modelContext.delete(items[index])
}
}
}
}
#Preview {
ContentView()
.modelContainer(for: Item.self, inMemory: true)
}

View File

@ -0,0 +1,32 @@
//
// CxLLM_OS_APPApp.swift
// CxLLM-OS-APP
//
// Created by Stephen Carter on 4/22/26.
//
import SwiftUI
import SwiftData
@main
struct CxLLM_OS_APPApp: App {
var sharedModelContainer: ModelContainer = {
let schema = Schema([
Item.self,
])
let modelConfiguration = ModelConfiguration(schema: schema, isStoredInMemoryOnly: false)
do {
return try ModelContainer(for: schema, configurations: [modelConfiguration])
} catch {
fatalError("Could not create ModelContainer: \(error)")
}
}()
var body: some Scene {
WindowGroup {
ContentView()
}
.modelContainer(sharedModelContainer)
}
}

18
CxLLM-OS-APP/Item.swift Normal file
View File

@ -0,0 +1,18 @@
//
// Item.swift
// CxLLM-OS-APP
//
// Created by Stephen Carter on 4/22/26.
//
import Foundation
import SwiftData
@Model
final class Item {
var timestamp: Date
init(timestamp: Date) {
self.timestamp = timestamp
}
}

View File

@ -0,0 +1,17 @@
//
// CxLLM_OS_APPTests.swift
// CxLLM-OS-APPTests
//
// Created by Stephen Carter on 4/22/26.
//
import Testing
@testable import CxLLM_OS_APP
struct CxLLM_OS_APPTests {
@Test func example() async throws {
// Write your test here and use APIs like `#expect(...)` to check expected conditions.
}
}

View File

@ -0,0 +1,41 @@
//
// CxLLM_OS_APPUITests.swift
// CxLLM-OS-APPUITests
//
// Created by Stephen Carter on 4/22/26.
//
import XCTest
final class CxLLM_OS_APPUITests: XCTestCase {
override func setUpWithError() throws {
// Put setup code here. This method is called before the invocation of each test method in the class.
// In UI tests it is usually best to stop immediately when a failure occurs.
continueAfterFailure = false
// In UI tests its important to set the initial state - such as interface orientation - required for your tests before they run. The setUp method is a good place to do this.
}
override func tearDownWithError() throws {
// Put teardown code here. This method is called after the invocation of each test method in the class.
}
@MainActor
func testExample() throws {
// UI tests must launch the application that they test.
let app = XCUIApplication()
app.launch()
// Use XCTAssert and related functions to verify your tests produce the correct results.
}
@MainActor
func testLaunchPerformance() throws {
// This measures how long it takes to launch your application.
measure(metrics: [XCTApplicationLaunchMetric()]) {
XCUIApplication().launch()
}
}
}

View File

@ -0,0 +1,33 @@
//
// CxLLM_OS_APPUITestsLaunchTests.swift
// CxLLM-OS-APPUITests
//
// Created by Stephen Carter on 4/22/26.
//
import XCTest
final class CxLLM_OS_APPUITestsLaunchTests: XCTestCase {
override class var runsForEachTargetApplicationUIConfiguration: Bool {
true
}
override func setUpWithError() throws {
continueAfterFailure = false
}
@MainActor
func testLaunch() throws {
let app = XCUIApplication()
app.launch()
// Insert steps here to perform after app launch but before taking a screenshot,
// such as logging into a test account or navigating somewhere in the app
let attachment = XCTAttachment(screenshot: app.screenshot())
attachment.name = "Launch Screen"
attachment.lifetime = .keepAlways
add(attachment)
}
}

21
LICENSE Normal file
View File

@ -0,0 +1,21 @@
MIT License
Copyright (c) 2026 CxAI-LLM
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

43
Makefile Normal file
View File

@ -0,0 +1,43 @@
# Makefile — common entry points for CxLLM-OS-APP
SHELL := /bin/bash
.DEFAULT_GOAL := help
PROJECT := CxLLM-OS-APP
SCHEME ?= $(PROJECT)
CONFIG ?= Debug
DERIVED ?= build
.PHONY: help build test lint clean fmt info
help: ## show this help
@grep -E '^[a-zA-Z_-]+:.*## ' $(MAKEFILE_LIST) | awk -F':.*## ' '{printf " %-12s %s\n", $$1, $$2}'
info: ## show project info
@echo "project : $(PROJECT)"
@echo "scheme : $(SCHEME)"
@echo "config : $(CONFIG)"
@echo "derived : $(DERIVED)"
build: ## xcodebuild build (skip if no .xcodeproj)
@if ls *.xcodeproj 1>/dev/null 2>&1; then \
xcodebuild -project "$(PROJECT).xcodeproj" -scheme "$(SCHEME)" -configuration "$(CONFIG)" -derivedDataPath "$(DERIVED)" build | xcbeautify || true ; \
elif [ -f Package.swift ]; then \
swift build -c $(shell echo "$(CONFIG)" | tr '[:upper:]' '[:lower:]') ; \
else echo "no buildable target" ; fi
test: ## xcodebuild test
@if ls *.xcodeproj 1>/dev/null 2>&1; then \
xcodebuild -project "$(PROJECT).xcodeproj" -scheme "$(SCHEME)" -configuration "$(CONFIG)" -derivedDataPath "$(DERIVED)" test | xcbeautify || true ; \
elif [ -f Package.swift ]; then \
swift test ; \
else echo "no testable target" ; fi
lint: ## swiftlint + swiftformat (no-op if missing)
@command -v swiftlint >/dev/null && swiftlint --quiet || echo "swiftlint not installed"
@command -v swiftformat >/dev/null && swiftformat --lint . || echo "swiftformat not installed"
fmt: ## swiftformat in-place
@command -v swiftformat >/dev/null && swiftformat . || echo "swiftformat not installed"
clean: ## remove build artifacts
rm -rf "$(DERIVED)" .build DerivedData

53
README.md Normal file
View File

@ -0,0 +1,53 @@
# CxLLM-OS-APP
> CxLLM OS shell application
SwiftUI/SwiftData macOS shell that exposes CxLLM as a top-level OS application (status item + window scene + URL handler).
[![ci](https://git.cxllm-studio.com/CxAI-LLM/CxLLM-OS-APP/actions/workflows/ci.yml/badge.svg)](https://git.cxllm-studio.com/CxAI-LLM/CxLLM-OS-APP/actions)
[![license](https://img.shields.io/badge/license-MIT-7C3AED)](LICENSE)
[![category](https://img.shields.io/badge/category-app-macos-1F6FEB)](#)
## Overview
`CxLLM-OS-APP` 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-OS-APP/` — primary source folder (matches the Xcode group / SwiftPM root).
- `CxLLM-OS-APP.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.

19
SECURITY.md Normal file
View File

@ -0,0 +1,19 @@
# Security policy for CxLLM-OS-APP
## Reporting a vulnerability
Please email **security@cxllm-studio.com** with:
- A description of the vulnerability and its impact.
- Steps to reproduce, ideally with a minimal proof-of-concept.
- The affected version(s) / commit SHAs.
We aim to acknowledge within **2 business days** and to publish a fix or
mitigation within **30 days** for high-severity issues.
Do **not** open a public Gitea / GitHub issue for vulnerabilities.
## Supported versions
Only the `main` branch and the most recent tagged release receive security
updates.

24
docs/ARCHITECTURE.md Normal file
View File

@ -0,0 +1,24 @@
# Architecture — CxLLM-OS-APP
> CxLLM OS shell application
## Goals
- Provide a focused, well-tested app-macos surface for the CxLLM family.
- Stay deployable on its own (no monorepo coupling).
- Keep the public ABI small and explicitly versioned.
## Boundaries
```text
+----------------------+
client --> | CxLLM-OS-APP |
+----------+-----------+
|
v
CxLLM runtime / kernel
```
## Decisions
- See `docs/adr/` for Architecture Decision Records.

View File

@ -0,0 +1,13 @@
# 1. Record architecture decisions
## Status
Accepted
## Context
We need a lightweight, append-only log of architectural choices.
## Decision
Use Markdown ADRs in `docs/adr/`, numbered sequentially.
## Consequences
Future maintainers can read the chain of decisions without spelunking PR history.