Skip to content

docs: document the shared CMS GitHub App - #261

Merged
onmax merged 6 commits into
mainfrom
fix/personal-project-cms
Oct 29, 2026
Merged

onmax merged 6 commits into
mainfrom
fix/personal-project-cms

Conversation

@onmax

@onmax onmax commented Oct 28, 2026 •

Copy link
Copy Markdown
Owner

Document the reusable Personal Project CMS GitHub App, exact comark-ui callback, private runtime bindings, selected-repository installation, and reuse by other personal projects. The guide keeps OAuth sign-in separate from the Content Store token and preserves the existing team policy.

This PR retains the current /sign-in route and documents it accurately. Companion #262 upgrades ViteHub and switches the guide and route to built-in Console sign-in in the same revision, so each deployed revision has a working OAuth entry point.

The final diff against main only changes docs/CMS.md. The combined stack passes production docs build, docs typecheck, the real Better Auth OAuth smoke check, GitHub Store cache integration test, and Wrangler's worker deployment dry run.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor
Session Status Started Duration
Pending Completed Not started —

Latest result

Pull request merged.

Final answers

Session

Pull request merged.

Session

GitHub is still calculating mergeability for this PR head.

Session

GitHub is still calculating mergeability for this PR head.

Session

GitHub is still calculating mergeability for this PR head.

Session

GitHub is still calculating mergeability for this PR head.

Session

GitHub is still calculating mergeability for this PR head.

Session

GitHub is still calculating mergeability for this PR head.

Session

Fixed Codex P1 and Pullfrog P1 sign-in outage by restoring `/sign-in` until the compatible ViteHub upgrade. Updated migration documentation and PR metadata, pushed 35be44b, and resolved the thread. OAuth runtime assertions, Nuxt preparation, focused lint, formatting, and diff checks passed. The pnpm wrapper aborted an automatic reinstall; direct Nuxt preparation succeeded. Awaiting hosted checks.

Session

Fixed Codex P1 and Pullfrog P1 sign-in outage by restoring `/sign-in` until the compatible ViteHub upgrade. Updated migration documentation and PR metadata, pushed 35be44b, and resolved the thread. OAuth runtime assertions, Nuxt preparation, focused lint, formatting, and diff checks passed. The pnpm wrapper aborted an automatic reinstall; direct Nuxt preparation succeeded. Awaiting hosted checks.

Session

Fixed Codex P1 and Pullfrog P1 sign-in outage by restoring `/sign-in` until the compatible ViteHub upgrade. Updated migration documentation and PR metadata, pushed 35be44b, and resolved the thread. OAuth runtime assertions, Nuxt preparation, focused lint, formatting, and diff checks passed. The pnpm wrapper aborted an automatic reinstall; direct Nuxt preparation succeeded. Awaiting hosted checks.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

The draft prerequisite is still reproducible at cb22285: the pinned ViteHub preview 3726291 has no signInPage in its Console types, Nuxt integration, or implementation. Calling its Console page handler returns HTTP 200 without the sign-in configuration. Please update the pilot preview with the support from vite-hub/vitehub#2977 and #2975, then comment here; dependency updates remain outside this PR's stated scope.

The required check / e2e failure also remains undiagnosed. readCheckLogs({ runId: 40690050491 }) returns truncated: true at 200,000 characters, ending during Docs at 12:48, before the failing End to end step at 12:50–12:53. Please attach that step's failing test name and stack trace so the next repair pass can target the actual failure. The exact base's e2e check succeeded, so I am not claiming a base regression.

Local verification: docs/node_modules/.bin/nuxi prepare docs succeeded; node_modules/.bin/vp test run test/sign-in.test.ts passed all 8 tests; focused vp lint on the three changed TypeScript files and git diff --check passed. No repair commit was made because the available evidence does not identify a repository fix for the e2e failure.

@onmax onmax changed the title fix(docs): connect Console sign-in and preserve return URLs docs: document reusable Personal Project CMS setup Oct 28, 2026
@onmax onmax changed the title docs: document reusable Personal Project CMS setup refactor(docs): use ViteHub's built-in CMS sign-in Oct 28, 2026
@pkg-pr-new

pkg-pr-new Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

comark-annotate

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-annotate@261

comark-badge

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-badge@261

comark-cards

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-cards@261

comark-carousel

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-carousel@261

comark-cast

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-cast@261

comark-charts

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-charts@261

comark-chat

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-chat@261

comark-chips

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-chips@261

comark-cjk

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-cjk@261

comark-code

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-code@261

comark-code-notes

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-code-notes@261

comark-colors

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-colors@261

comark-comments

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-comments@261

comark-critic

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-critic@261

comark-deflist

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-deflist@261

comark-details

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-details@261

comark-diagrams

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-diagrams@261

comark-diff

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-diff@261

comark-embed

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-embed@261

comark-fields

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-fields@261

comark-figure

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-figure@261

comark-file-tree

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-file-tree@261

comark-footnotes

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-footnotes@261

comark-github

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-github@261

comark-icon

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-icon@261

comark-include

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-include@261

comark-keys

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-keys@261

comark-links

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-links@261

comark-linter

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-linter@261

comark-magic-move

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-magic-move@261

comark-mark

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-mark@261

comark-mathml

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-mathml@261

comark-media

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-media@261

comark-metrics

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-metrics@261

comark-outline

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-outline@261

comark-properties

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-properties@261

comark-qr

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-qr@261

comark-quiz

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-quiz@261

comark-reading-time

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-reading-time@261

comark-sources

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-sources@261

comark-steps

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-steps@261

comark-table

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-table@261

comark-tabs

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-tabs@261

comark-tests

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-tests@261

comark-ui

pnpm add https://pkg.pr.new/onmax/comark-ui@261

comark-xref

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-xref@261

comark-zoom

pnpm add https://pkg.pr.new/onmax/comark-ui/comark-zoom@261

commit: 4dd4ce7

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

The draft prerequisite now depends on vite-hub/vitehub#3004, which is still open and draft. At 5a3645d48b988f4c39d9bea0290650a08c0866d2, I reproduced that the installed 3726291 preview has no createConsoleAppAuthPages export, and Nuxt generates an app-Auth Console policy without a sign-in handler. The installed Console page handler returns HTTP 200 with the Console shell for both /_vitehub and /_vitehub/sign-in, without an app GitHub sign-in action. The project /sign-in route has been removed as intended.

Please include #3004 in the compatible pilot preview and complete the consumer pin session's verification, then comment here. Dependency pin updates remain outside this PR's stated scope. The earlier e2e blocker is cleared: the supplied current-head check / e2e and check / check both succeeded. Local docs/node_modules/.bin/nuxi prepare docs, focused vp lint docs/nuxt.config.ts, the runtime assertions above, and git diff --check origin/main...HEAD passed. No source changes or repair commit were needed in this pass.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor
Session Status Started Duration
Pending Waiting 2026-10-28T14:09:49.946Z Paused

Next step

Current CI is green; the historical e2e failure is cleared. pnpm preparation hit an automatic-install guard; direct Nuxt preparation, focused lint, runtime assertions and diff checks passed. Reproduced the external prerequisite: preview 3726291 lacks built-in app Auth sign-in. No source changes were needed.

Final answers

Session

Current CI is green; the historical e2e failure is cleared. pnpm preparation hit an automatic-install guard; direct Nuxt preparation, focused lint, runtime assertions and diff checks passed. Reproduced the external prerequisite: preview 3726291 lacks built-in app Auth sign-in. No source changes were needed.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor
Session Status Started Duration
View session Starting Not started —

Queued

Waiting for a worker slot.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

New pull request evidence is queued.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

14 similar comments
@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@vite-hub

vite-hub Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

This Agent activity was superseded by a newer managed comment.

@onmax
onmax marked this pull request as ready for review October 29, 2026 19:52
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-29T20:13:22.185646Z ef92758 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4dd4ce7601

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/server/routes/sign-in.get.ts Resolved

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Merging this PR in the documented order removes the production OAuth entry point before the checked-in ViteHub version supplies its replacement.

Reviewed changes in all 3 commits through 4dd4ce76, covering the CMS sign-in route removal and the new operational documentation.

  • Built-in sign-in migration — removes the handwritten /sign-in route in favor of ViteHub's Console app-auth flow.
  • CMS operations guide — documents the shared GitHub App, callback, private bindings, repository installation, and authorization boundaries.

🚨 The merge sequence creates a sign-in outage

This branch still pins ViteHub 3726291, where console.auth: "app" only validates an existing session and does not render the built-in app-auth sign-in flow. Because the docs deploy on every push to main, merging this PR before #262 deletes the only route that starts GitHub OAuth and leaves unauthenticated editors unable to enter the Console until the second PR is merged and deployed.

Technical details
# Keep an OAuth entry point throughout deployment

## Affected sites
- `docs/server/routes/sign-in.get.ts:1-22` — this PR deletes the current GitHub OAuth starter.
- `docs/modules/vitehub-pilot.ts:23-27` — the checked-in integration still removes ViteHub's Auth client because the deleted route was expected to handle sign-in.
- `pnpm-workspace.yaml:65-100` — ViteHub packages remain pinned to preview `3726291`; the built-in app-auth sign-in implementation is only introduced by stacked PR #262's upgrade.

## Required outcome
- No deployed revision may remove `/sign-in` before its checked-in ViteHub dependency and integration expose the replacement Console sign-in flow.

## Suggested approach
- Include #262's dependency/integration upgrade in this PR, or restack the changes so the upgrade lands while `/sign-in` still exists and delete the route only afterward.

## Evidence
- Pinned ViteHub app-auth access implementation: https://github.com/vite-hub/vitehub/blob/372629197024833920d15db2e076db0e86bcfb83/packages/vite-hub/src/console/auth.ts
- Pinned Console route setup: https://github.com/vite-hub/vitehub/blob/372629197024833920d15db2e076db0e86bcfb83/packages/vite-hub/src/console/vite.ts
- New built-in app-auth pages on current ViteHub: https://github.com/vite-hub/vitehub/blob/main/packages/vite-hub/src/console/auth.ts

Pullfrog  | Fix it ➔ | View workflow run | Using gpt-5.6-sol | 𝕏

@vite-hub vite-hub Bot changed the title refactor(docs): use ViteHub's built-in CMS sign-in docs: prepare ViteHub's built-in CMS sign-in migration Oct 29, 2026
@vite-hub

vite-hub Bot commented Oct 29, 2026

Copy link
Copy Markdown
Contributor

For the Codex finding and Pullfrog finding, 35be44b restores the baseline /sign-in route while preview 3726291 remains pinned, preserving production OAuth through each deployment; the guide and PR description now require removing that fallback together with or after #262’s compatible ViteHub upgrade.

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes since the prior Pullfrog review at 4dd4ce76, covering the restored OAuth fallback and its migration guidance.

  • Retained OAuth entry point — restored docs/server/routes/sign-in.get.ts so the currently pinned ViteHub preview still has a production GitHub sign-in path.
  • Clarified upgrade sequencing — updated docs/CMS.md to require keeping /sign-in until #262 supplies built-in Console app-auth sign-in.

Pullfrog  | View workflow run | Using gpt-5.6-sol | 𝕏

@onmax onmax changed the title docs: prepare ViteHub's built-in CMS sign-in migration docs: document the shared CMS GitHub App Oct 29, 2026
@onmax
onmax merged commit cb651ed into main Oct 29, 2026
4 checks passed
@onmax
onmax deleted the fix/personal-project-cms branch October 29, 2026 20:23
@github-actions github-actions Bot mentioned this pull request Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant