recallnet/Survival Receipts

Run a local git survival scan and publish Markdown and JSON reports.

Trust Signals

workflow.ymlSHA-pinned

uses: recallnet/survival-receipts@33b1e45ea07544e49d4543ed94373ddc1fefa803 # no releases — HEAD as of 2026-07-11

tags can be moved; commit SHAs can't. why a SHA?

name	description	required	default
as-of	Optional report cutoff date or timestamp. Defaults to the current time.	no	""
survival-days	Comma-separated survival checkpoints, such as 30 or 1,7,15,30.	yes	30
window-days	Include this many days of mature changes.	yes	30
limit	Max commits to inspect.	no	250
config	Optional path to survival.config.json, relative to the checked-out repo unless absolute.	no	""
max-files	Skip changes touching more included files than this.	no	25
max-added-lines	Skip changes adding more included lines than this.	no	1500
max-file-added-lines	Skip changes when one included file adds more lines than this.	no	300
blame-timeout-ms	Timeout for each git blame call.	no	15000
copy-detection	Use slower git blame copy detection.	no	false
quiet	Suppress scanner progress logs.	no	false
upload-artifact	Upload the generated reports as a GitHub Actions artifact.	no	true
artifact-name	Name for the uploaded report artifact.	no	survival-receipts
upload-url	Optional backend URL that receives the report envelope with HTTP POST.	no	""
cursor-mode	Use backend cursor state to scan all newly mature commits since the last processed commit.	no	false
cursor-url	Optional backend cursor URL. Defaults to upload-url with /api/runs replaced by /api/cursor.	no	""
api-key	Optional backend API key. If omitted, the action uses GitHub Actions OIDC and the workflow job must grant id-token: write.	no	""
oidc-audience	Audience to request for GitHub Actions OIDC upload tokens. Must match the backend GITHUB_OIDC_AUDIENCE.	no	survival-receipts

name	description
markdown-path	Path to the generated Markdown report on the runner.
json-path	Path to the generated JSON report on the runner.
report-dir	Directory containing generated reports on the runner.
artifact-url	URL for the uploaded report artifact when upload-artifact is true.
skipped	Whether the scan was skipped because no new mature commits were available.