thatfactory · backslash-f · Jul 21, 2026 · Jul 21, 2026 · Jul 21, 2026 · Jul 21, 2026
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -11,6 +11,11 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
 jobs:
   test:
     name: Test Release
@@ -32,10 +37,54 @@ jobs:
       - name: Run Tests
         run: swift test -v
 
+  build_docs:
+    name: Build DocC
+    runs-on: [self-hosted, macOS]
+    needs: test
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v6
+        with:
+          clean: true
+
+      - name: Generate DocC
+        run: |
+          set -euo pipefail
+          swift package --allow-writing-to-directory ./public generate-documentation \
+            --target AppLogger \
+            --disable-indexing \
+            --output-path ./public \
+            --transform-for-static-hosting \
+            --hosting-base-path applogger
+
+          cat > ./public/index.html <<'INDEX'
+          <!doctype html>
+          <meta http-equiv="refresh" content="0; url=/applogger/documentation/applogger/" />
+          <title>AppLogger Documentation</title>
+          INDEX
+
+      - name: Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: ./public
+          name: github-pages
+
+  deploy_docs:
+    name: Deploy DocC
+    needs: build_docs
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5
+
   notify_package_collection:
     name: Notify Package Collection
     runs-on: ubuntu-latest
-    needs: test
+    needs: deploy_docs
     steps:
       - name: Trigger Swift Package Collection Rebuild
         env:

diff --git a/AGENTS.md b/AGENTS.md
@@ -0,0 +1,22 @@
+# AppLogger
+
+AppLogger is a Swift package wrapping Apple's unified logging APIs and providing reusable logging-formatting helpers.
+
+## Shared guidelines
+
+Read the relevant shared guides before changing the package:
+
+- [Swift](AgentGuidelines/Guidelines/Swift/Swift.md)
+- [Swift style](AgentGuidelines/Guidelines/Swift/SwiftStyle.md)
+- [Unit and integration testing](AgentGuidelines/Guidelines/Testing/UnitTesting.md)
+- [Documentation](AgentGuidelines/Guidelines/Documentation.md)
+- [Packages](AgentGuidelines/Guidelines/Packages.md)
+- [CI/CD](AgentGuidelines/Guidelines/CICD.md)
+
+## Package layout
+
+- Production sources live under `Sources/AppLogger/`.
+- Shared extensions live under `Sources/Extensions/`.
+- Tests live under `Tests/AppLoggerTests/`.
+
+Keep the package UI-agnostic and preserve its public API's minimal scope.
diff --git a/AgentGuidelines/.gitignore b/AgentGuidelines/.gitignore
@@ -0,0 +1,3 @@
+.DS_Store
+__pycache__/
+*.py[cod]
diff --git a/AgentGuidelines/AGENTS.md b/AgentGuidelines/AGENTS.md
@@ -0,0 +1,39 @@
+# Agent Guidelines
+
+## Purpose
+
+This public repository is the versioned source of truth for reusable ThatFactory agent guidance. Keep it generic enough to apply to multiple applications and Swift packages. Product decisions, concrete project paths, and exceptions belong in each consumer repository.
+
+## Sources of truth
+
+- Use official Apple documentation for Apple APIs and Xcode behavior.
+- Distill durable policy from Xcode-provided skills; do not copy exported Apple skills into this repository.
+- Do not include private company information, credentials, personal absolute paths, or consumer-specific implementation details.
+- When shared and consumer guidance differ, the consumer's nearest applicable `AGENTS.md` is the explicit specialization.
+- Before changing this repository, verify that the consumer's checked-in guidelines version is current where applicable.
+
+## Documentation changes
+
+- Keep each rule in the narrowest relevant guide and link to it rather than duplicating it.
+- Use physical folder terminology for Xcode projects. Do not call filesystem folders Xcode groups.
+- Keep examples generic and concise.
+- Use relative Markdown links inside this repository.
+- Update `README.md` when adding, moving, or removing a guide.
+- Update `CHANGELOG.md` and `VERSION` for a release.
+
+## Validation
+
+Run:
+
+```sh
+python3 Scripts/validate_guidelines.py
+```
+
+Fix every validation failure before releasing a version.
+
+## Releases
+
+- Use semantic versioning.
+- Create a Git tag and GitHub release matching `VERSION`.
+- Consumer repositories adopt releases deliberately through Git subtree updates.
+- Follow [the pull-request review workflow](Guidelines/GitHub/PullRequests.md) before merging any release change.
diff --git a/AgentGuidelines/CHANGELOG.md b/AgentGuidelines/CHANGELOG.md
@@ -0,0 +1,50 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [0.0.5] - 2026-07-21
+
+### Added
+
+- Default DocC documentation and GitHub Pages publishing guidance for Swift packages.
+
+## [0.0.4] - 2026-07-21
+
+### Added
+
+- Development guidance for reusability-first design and checking the latest shared-guidelines version before project work.
+
+### Changed
+
+- Require an approved pull request before releasing `agent-guidelines` or any consumer package.
+
+## [0.0.3] - 2026-07-21
+
+### Added
+
+- A Codex review-monitoring workflow covering paginated processing reactions and review threads, clean reviews, inline feedback, replies, thread resolution, and CI checks.
+
+## [0.0.2] - 2026-07-21
+
+### Added
+
+- Standard README badge conventions for ThatFactory projects and packages.
+- Git repository guidance that defaults push-capable clones to SSH remotes.
+- GitHub pull-request review and merge-gate guidance.
+- Updated and Revision badges to the repository README.
+
+### Changed
+
+- Updated GitHub workflows to `actions/checkout@v7` and documented using current stable action versions in new workflows.
+- Clarified the Redux side-effect loop and the canonical view-projection test path.
+- Expanded and tested semantic-version validation to support prerelease plus build metadata and reject invalid numeric identifiers.
+- Removed the redundant README license section while retaining the MIT license badge and root license file.
+
+## [0.0.1] - 2026-07-21
+
+### Added
+
+- Initial shared guidelines for Redux, Swift, SwiftUI, SwiftLint, localization, testing, documentation, package maintenance, CI/CD, Xcode MCP, and Xcode security audits.
+- A consumer `AGENTS.md` template and Git subtree installation workflow.
+- Structural validation for links, the documentation catalog, version metadata, subtree instructions, and public-repository safety.
+- A tag-driven GitHub release workflow that validates the tag against `VERSION` and publishes changelog notes.