{
  "checker": {
    "details": {
      "argv": [
        "/usr/local/bin/hugo",
        "server",
        "--renderToMemory",
        "--buildDrafts",
        "--buildFuture",
        "--enableGitInfo=false",
        "--port",
        "1313",
        "--bind",
        "127.0.0.1",
        "--baseURL",
        "http://127.0.0.1:1313/"
      ],
      "bytes": 701743,
      "kind": "http",
      "scope": "product operation",
      "status": 200,
      "url": "http://127.0.0.1:1313/docs/",
      "working": true
    },
    "status": "PASS"
  },
  "deviations": [
    "`make build` failed at 'yarn --cwd ./theme run build' with Cannot find module '@pulumi/design-tokens/...' -> ran `yarn install` in theme/ (README does not mention this subproject install).",
    "theme build then failed: 'stencil: not found' -> ran `yarn install` in theme/stencil/.",
    "theme webpack/stencil build died with 'JavaScript heap out of memory' at default heap -> re-ran make build with NODE_OPTIONS=--max-old-space-size=4096 (VM has ~2GB RAM).",
    "`make build` then failed with 'Killed' (exit 137) in scripts/generate-meta-images.mjs; it still OOMs with OG_WORKERS=1 and NODE_OPTIONS heap cap -> added a 4G /swapfile on the guest (guest-only; cannot be verified as sufficient); still killed, so OG card generation was not completed.",
    "Because the meta-image step never finished, build-site.sh (make build) was not completed. Ran the Hugo steps directly instead: `hugo --minify --enableGitInfo=false -e production`.",
    "`hugo` failed: 'failed to load Git data: fatal: not a git repository' (workspace has no .git) -> added --enableGitInfo=false on the CLI (no source change).",
    "`hugo` failed on the header icon partial ('icon not in sprite manifest' / fingerprint nil) -> ran `make sync-icons` (a documented Makefile target from make ensure) to generate assets/icons/sprite.svg.",
    "data/openapi-spec.json was not downloaded (`make ensure` / scripts/fetch-openapi-spec.sh not run); Hugo only warns and skips the generated API schema pages.",
    "`make serve` (scripts/serve.sh) was not run verbatim: it calls hugo server without --enableGitInfo=false and would hit the same git error. The probe runs hugo server with serve.sh's flags plus --enableGitInfo=false.",
    "Generated/overwritten files in the workspace from these steps: node_modules/ (root and theme/, theme/stencil/), theme/src/generated/tailwind-v4/_theme.scss, theme/ and static/ bundles, assets/icons/sprite.svg and sprite-manifest.json, public/. Product source was not edited by hand."
  ],
  "main_blocker": null,
  "operation": "Ran the Hugo dev server (the README's `make serve` path, hugo server with the serve.sh flags) and fetched the rendered documentation landing page at http://127.0.0.1:1313/docs/ (HTTP 200, title 'Documentation | Pulumi Docs'). Also ran the production `hugo --minify -e production` build (4917 pages, exit 0) to public/.",
  "operation_scope": "Covers the site build and the local docs server. Not covered: SDK/CLI reference generation (needs the openapi spec from make ensure and pulumi/go tooling), Go-based example program tests, lint, and the meta-image OG card step (see deviations). No credentials or browser were needed.",
  "outcome": "working",
  "steps": [
    "Read README.md: 'Easy path: use mise' and 'Without mise' sections; Makefile targets build, serve.",
    "Installed Hugo 0.157.0 extended from the GitHub release tarball to /usr/local/bin/hugo (pinned in mise.toml).",
    "Installed Node 24 (nodejs.org linux-x64 tarball, v24.22.0 reported) to /tmp/node24 and linked node/npm/npx into /usr/local/bin.",
    "npm i -g yarn@1.22.22 (Yarn 1.x per README).",
    "apt-get install make (make not present in the guest).",
    "yarn install --frozen-lockfile in repo root (ok).",
    "yarn install in theme/ and theme/stencil/ (needed before make build-assets).",
    "make build (ran with NODE_OPTIONS=--max-old-space-size=4096, then with OG_WORKERS=1 and a 4G swapfile); build-assets succeeded; build stopped at meta-image generation (OOM kill) - see deviations.",
    "make sync-icons (generates assets/icons/sprite.svg, needed by the header icon partial).",
    "hugo --minify --enableGitInfo=false -e production (exit 0, 4917 pages).",
    "hugo server --renderToMemory --buildDrafts --buildFuture --enableGitInfo=false --port 1313 --bind 127.0.0.1; curl http://127.0.0.1:1313/docs/ returned 200 with the Pulumi Docs title; server then stopped."
  ],
  "stuck_step": null,
  "suggested_fix": "For a fully clean `make build`: give the VM more memory (generate-meta-images.mjs is OOM-killed on ~2GB RAM), run `make ensure` (fetches the openapi spec and icon sync), and add a .git directory or run hugo with --enableGitInfo=false. The README should also document the theme/ and theme/stencil/ yarn installs and the Node heap size."
}