Conversation
Co-authored-by: Tim Jones <DevSecTim@users.noreply.github.com>
Co-authored-by: Tim Jones <DevSecTim@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a Cloud Agent development environment so agents can run, build, and preview the Hugo site end to end. This mirrors the setup already used by the Azure Static Web Apps CI workflow (Hugo extended
0.147.1, PaperMod theme submodule).Changes
.cursor/environment.json— declares the environment: runs the reconciler script as both theinstallandstarthooks, exposes port1313, and starts a live-reloadhugo serverin a persistent terminal..cursor/install.sh— idempotent reconciler that installs Hugo extended0.147.1(pinned to match CI) and initialises the PaperMod theme git submodule. Works from any working directory.Why the reconciler runs as both
installandstartOn a prebuilt-snapshot boot the
installhook is skipped, and a freshdefault_checkoutre-clones/workspacewithout submodules — which would leavethemes/PaperMod/empty. Running the same idempotent script as the per-bootstarthook restores the submodule (and Hugo, if absent) on every boot. Hugo is pinned to the version CI uses (HUGO_VERSION: 0.147.1) to keep local and deployed builds consistent.Validation
./.cursor/install.shis idempotent and runs correctly from any working directory.hugo v0.147.1 +extended, a populatedthemes/PaperMod/submodule, a successfulhugo --gc --minifybuild (25 pages, 29 processed images), and a dev server returning HTTP 200 for the home, writings, search, and search-index (/index.json) routes.hugo-site-end-to-end-demo.mp4
To show artifacts inline, enable in settings.