alfridus1/lovagentic runbook
Run a lovagentic YAML runbook (snapshot → diff → verify → publish) and optionally post the diff summary back to the triggering PR. Default flow is read-only: snapshot the current Lovable project state and compute the diff against the last edit so reviewers can see what the AI agent changed before they merge.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit May 17, 2026
- License
- MIT
Pinned Snippet
uses: alfridus1/lovagentic@0b91d926e044e9b9509351c7ed2294466895a67a # v0.3.8tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| project-url | Lovable project URL or project id. Overrides `projectUrl` from the runbook file. Falls back to the `LOVABLE_PROJECT_URL` env var. | no | — |
| bearer-token | Firebase Bearer token for the Lovable API (from `lovagentic auth bootstrap` -> ~/.lovagentic/auth.json). Stored as a repository secret. Either this or `api-key` is required. | no | — |
| api-key | `lov_...`-prefixed Lovable API key. Alternative to `bearer-token`. | no | — |
| runbook | Path to the YAML/JSON runbook to execute, relative to the workspace root. Defaults to `.lovagentic/runbook.yaml`. If the file does not exist a built-in `snapshot + diff` runbook is used. | no | .lovagentic/runbook.yaml |
| output-dir | Directory where snapshot/diff artifacts are written. Defaults to `./lovagentic-output`. | no | ./lovagentic-output |
| comment-on-pr | Post the runbook summary as a PR comment. Set to `false` to skip the comment. Requires the workflow to provide `pull-requests: write`. | no | true |
| upload-artifact | Upload the runbook output directory as a workflow artifact. Set to `false` to skip. | no | true |
| artifact-name | Name of the uploaded artifact. | no | lovagentic-runbook |
| lovagentic-version | npm version spec for `lovagentic` (e.g. `latest`, `^0.3`, `0.3.7`). Pin in production. | no | ^0.3 |
| fail-on-warnings | Fail the action if the runbook reports any warnings (truncation, partial network failures, etc.). Default is to keep warnings advisory. | no | false |
| github-token | Token used to post the PR comment. Defaults to `${{ github.token }}`. | no | ${{ github.token }} |
Outputs
| name | description |
|---|---|
| output-dir | Absolute path to the runbook output directory. |
| summary | Path to the human-readable runbook summary (Markdown). |
| status | `success` if the runbook completed cleanly, `warnings` if it ran with non-fatal warnings, `failure` otherwise. |