proompteng/XLSX Cache Doctor

Diagnose stale cached XLSX formula values in CI without Excel, LibreOffice, or browser automation.

Trust Signals

name	description	required	default
workbook	Path to one XLSX workbook to inspect. Use workbooks for repo-scale scans.	no	""
workbooks	Glob, comma list, or newline list of XLSX workbooks to inspect.	no	""
changed-files-only	Only inspect matched XLSX files changed in the pull request or current diff.	no	false
package-version	npm version or dist-tag for @bilig/xlsx-formula-recalc. Pin this for production workflows.	no	0.164.11
inspect-limit	Formula cells to recompute during inspection. Use "all" or a positive integer.	no	all
json-output	Optional path for the JSON report. Defaults to the runner temp directory.	no	""
markdown-output	Optional path for the Markdown report. Defaults to the runner temp directory.	no	""
fail-on-stale	Fail the workflow when stale cached formula values are detected.	no	false

name	description
json	Path to the xlsx-cache-doctor JSON report.
markdown	Path to the xlsx-cache-doctor Markdown report.
workbook-count	Number of XLSX workbooks inspected.
formula-count	Number of formula cells found across inspected workbooks.
stale-count	Number of inspected formula cells with stale cached values across inspected workbooks.
fresh-count	Number of inspected formula cells whose cached values match recalculated values.
missing-cache-count	Number of inspected formula cells that did not store a cached value in the workbook.
unsupported-recalculation-count	Number of inspected formula cells without a comparable recalculated value.
uninspected-count	Number of formula cells skipped because inspect-limit was lower than formula-count across inspected workbooks.
suggested-reads	Comma-separated workbook-qualified formula cells to read in a recalculation proof, capped at 25. The JSON report keeps the full list.