Add release docs and CI for v1.0.0

Author: timazed

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  test-and-build:
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Swift version
+        run: swift --version
+
+      - name: Swift package tests
+        run: swift test
+
+      - name: Build demo app (iOS Simulator)
+        run: |
+          xcodebuild \
+            -project DemoApp/AssistantRuntimeDemoApp.xcodeproj \
+            -scheme AssistantRuntimeDemoApp \
+            -destination 'generic/platform=iOS Simulator' \
+            CODE_SIGNING_ALLOWED=NO \
+            build

CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog and this project follows Semantic Versioning.
+
+## [Unreleased]
+
+## [1.0.0] - 2026-03-20
+
+### Added
+
+- Stable `CodexKit` + `CodexKitUI` runtime surface for iOS agent integration.
+- ChatGPT auth with `.deviceCode` and `.oauth` (localhost loopback callback flow).
+- Threaded runtime state restore, streaming output handling, and approval-gated tool execution.
+- Layered persona model (base instructions, thread persona stack, per-turn override).
+- Text + image user input support and assistant image attachment hydration.
+- Demo iOS app with:
+  - dual auth flows
+  - tool registration and logging
+  - persona demos
+  - Health Coach tab with HealthKit integration and proactive AI-generated coaching feedback
+  - local reminder scheduling
+
+### Changed
+
+- Refactored demo app into smaller Swift files for clearer ownership and readability.
+- Updated README docs with production setup guidance and end-to-end examples.
+
+[Unreleased]: https://github.com/timazed/CodexKit/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/timazed/CodexKit/releases/tag/v1.0.0

CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# Contributing
+
+Thanks for contributing to `CodexKit`.
+
+## Local Setup
+
+```sh
+swift package resolve
+swift test
+```
+
+For demo app validation:
+
+```sh
+xcodebuild -project DemoApp/AssistantRuntimeDemoApp.xcodeproj -scheme AssistantRuntimeDemoApp -destination 'generic/platform=iOS' build
+```
+
+## Pull Requests
+
+- Keep changes focused and scoped.
+- Add or update tests when behavior changes.
+- Update docs (`README.md`, `DemoApp/README.md`, `CHANGELOG.md`) for user-facing changes.
+- Ensure tests pass before opening a PR.
+
+## Commit Messages
+
+Use clear, imperative messages. Example:
+
+- `Add thread-level persona cache invalidation`
+- `Fix OAuth sign-in cancel state reset`
+
+## Releases
+
+- We use Semantic Versioning with tags like `v1.0.0`.
+- Update `CHANGELOG.md` for release notes.
+- Tag from `main` with an annotated tag:
+
+```sh
+git tag -a vX.Y.Z -m "Release vX.Y.Z"
+git push origin vX.Y.Z
+```