diff --git a/.almanac/pages/github-native-wiki-maintenance.md b/.almanac/pages/github-native-wiki-maintenance.md index c4291a5e..edb57f5c 100644 --- a/.almanac/pages/github-native-wiki-maintenance.md +++ b/.almanac/pages/github-native-wiki-maintenance.md @@ -18,6 +18,11 @@ sources: - https://www.mintlify.com/docs/organize/settings - https://www.mintlify.com/docs/deploy/github - https://www.mintlify.com/docs/deploy/preview-deployments + - id: pr-15 + type: pr + url: https://github.com/AlmanacCode/codealmanac/pull/15 + number: "15" + note: First live hosted Almanac GitHub App smoke-test PR against this repository. status: active verified: 2026-05-29 --- @@ -63,6 +68,8 @@ The remote product should make local wiki knowledge unavoidable at the moments w The highest-value checks are not generic code review comments. They are docs-drift checks, invariant conflicts, missing decision or flow updates, stale pages, broken file references, and "this change deserves an Almanac update" signals. That keeps the product aligned with [[just-in-time-context-surfacing]]: a few cited constraints at action time, not broad context injection. +PR 15 was the first live smoke test of this hosted path against CodeAlmanac itself. The branch changed only a README comment, but its purpose was to exercise the hosted GitHub App sequence from webhook receipt through check creation, approval, Modal execution, delivery, and metering; the resulting GitHub check run was named `Almanac`, pointed at `https://usealmanac.com`, and reported an action-required "Updating the Almanac" state rather than posting review findings [@pr-15]. Treat this as operational validation of the GitHub-native maintenance loop, not as evidence that README-only smoke diffs deserve durable wiki pages. + ## Canonical State Boundary The default canonical state should stay in the same repository. The current implementation uses `.almanac/` for reviewed wiki source and local machinery, but the product boundary should be a configurable `almanac root` rather than a hard-coded hidden path. Same-repo ownership gives project memory the same branch, review, merge history, CODEOWNERS, blame, rollback, and access boundary as the code it describes. diff --git a/README.md b/README.md index 0d359777..a2ed1fc1 100644 --- a/README.md +++ b/README.md @@ -287,3 +287,5 @@ Almanac is pre-1.0. Breaking changes are possible before 1.0 and will be called ## License Apache License 2.0. See [LICENSE](./LICENSE). + +