Skip to content

Pipeline smoke test: first hosted Almanac run #15

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rohans0509 wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Pipeline smoke test: first hosted Almanac run #15

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
16a02fd
test: trigger first hosted Almanac run
rohans0509 Jun 10, 2026
880bf41
Update Almanac from PR #15
almanac-bot[bot] Jun 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .almanac/pages/github-native-wiki-maintenance.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
Expand Down Expand Up @@ -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.
Expand Down
2 changes: 2 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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).

<!-- pipeline smoke test: first real Almanac run through the hosted GitHub App -->
Loading