Skip to content

chore(env): add Cloud Agent development environment for FinWiki - #319

Draft
jasonhnd wants to merge 1 commit into
mainfrom
cursor/setup-cloud-env-55c2
Draft

jasonhnd wants to merge 1 commit into
mainfrom
cursor/setup-cloud-env-55c2

Conversation

@jasonhnd

@jasonhnd jasonhnd commented Sep 1, 2026

Copy link
Copy Markdown
Owner

Summary

Sets up a repo-managed Cursor Cloud Agent development environment for FinWiki so future agents boot into a ready-to-work state that mirrors CI.

日本語

  • .cursor/install.sh: .bun-version(1.3.14)に固定した Bun をインストールし、bun install --frozen-lockfilesite/ の依存を復元します。再実行しても安全(冪等)です。
  • .cursor/environment.json: 上記 install を実行し、Astro dev server(astro-dev terminal、http://localhost:4321/、port 4321)を起動します。

English

  • .cursor/install.sh: installs the pinned Bun toolchain (from .bun-version = 1.3.14) and restores site/ dependencies via bun install --frozen-lockfile. Idempotent and safe to re-run.
  • .cursor/environment.json: runs the install script and starts the Astro dev server (astro-dev terminal, http://localhost:4321/, port 4321).

Why

CI (.github/workflows/required-verification.yml) uses oven-sh/setup-bun with .bun-version, then bun run verify. The default Cloud Agent image ships Node but not Bun, so a fresh agent could not run the toolchain. This environment installs the exact pinned Bun and site dependencies, matching CI.

Validation

Local (setup VM):

  • ./.cursor/install.sh runs to completion and is idempotent (Checked 281 installs across 377 packages (no changes) on re-run).
  • bun run verify passes the full canonical pipeline (install, all audits, i18n check, typecheck, all tests, Astro build, Pagefind index, static assembly, route/HTML audits, whitespace check): FinWiki required verification: PASS.
  • Astro dev server serves real content: /, /ja/, /en/, entry pages (e.g. /ja/banking/sony-bank/), domain listings, and /ja/browse/ all return HTTP 200 with rendered titles.

Prebuilt environment build:

  • Draft build bld-20260901-84817bba-5820-47d8-9548-e5196d1de3b7 (built off this branch) SUCCEEDED — fresh checkout ran .cursor/install.sh (Using bun 1.3.14 (pinned 1.3.14), 280 packages installed), produced a ready snapshot.
  • A fresh Cloud Agent booted from that build passed: toolchain match (Bun 1.3.14), populated site/node_modules, frozen install idempotent, index:counts / i18n:check / bun test tools/verify.test.ts / release:check all PASS, and the dev server returned HTTP 200 for /ja/ and /en/.

Notes

  • Repo-managed environment: the committed .cursor/environment.json is the authoritative config once merged to main; no competing dashboard configuration is created.
  • Build outputs (site/dist/, _vercel_public/, etc.) remain gitignored; no corpus, docs/, or generated public surfaces are touched, so no README.md / CHANGELOG.md / AI-discovery regeneration is required for this environment-only change.
Open in Web Open in Cursor 

Set up a repo-managed Cloud Agent environment:
- .cursor/install.sh installs the pinned Bun toolchain (.bun-version=1.3.14)
  and refreshes site deps via 'bun install --frozen-lockfile' (idempotent).
- .cursor/environment.json runs the install script and starts the Astro dev
  server (astro-dev terminal on port 4321).

Validated on the VM: install is idempotent, 'bun run verify' passes the full
CI pipeline, and the dev server serves /ja, /en, entry, and browse routes.

Co-authored-by: mildreins <mildreins@gmail.com>
@vercel

vercel Bot commented Sep 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
finwiki Ready Ready Preview Sep 1, 2026 4:50am UTC

Request Review

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.

2 participants