The Harithsa Notes

CI/CD pipeline

GitHub Actions checks each PR. Pages publishes the curated documentation artifact. Firebase application releases follow the separate staging and promotion runbook.

Read the gates

Foundation runs on PR changes, including PR body edits, and on pushes to main. It checks the repository foundation, local links, the public docs build, foundation tests, and the PR documentation decision.

Website runs on PRs and pushes to main. It installs locked dependencies and runs Astro checks, the site build, site tests, emulator-backed CMS tests, the server build, and a high-severity dependency audit.

Diagnose a failed publication

Open the matching workflow run and compare its commit with the intended release. If Package failed, review the generator’s missing path or anchor message. If Publish failed after a green Package, check the Pages environment and Actions deployment result. Fix the failing step and verify the new Pages revision and links independently.

For a Firebase release, check the preview or live Hosting release and its pinned Function revision individually. Confirm the public article, content schema and anonymous reader gate on the expected domain.

Delivery flow

  1. PR · validate the candidateFoundation and Website must pass. For changes to the public site inputs, Publish product site also builds and uploads a curated preview artifact.
  2. Merge · preserve the checked revisionMerge the reviewed PR into protected main. The workflow builds a new artifact from the merged revision.
  3. Pages · package then publishMatching pushes and authorized manual runs build the static artifact. The publish job needs the package and uses Pages and OIDC permissions only on the default branch when Pages is enabled.
  4. Firebase · stage, preview, promoteFor runtime changes, stage from a full reviewed SHA, test the isolated preview, deploy the managed Function, and publish the Hosting configuration pinned to that revision. A docs-only merge does not run a Firebase deploy.
  5. Verify · record evidenceCheck Pages source-revision, guide and media links, desktop and phone layouts, and demo playback. For a runtime release, also verify the Firebase revision and applicable public, authentication, API and telemetry paths.

Related links