marcoramilli/SynthScan

Detect AI-generated / synthetic code patterns and open a GitHub Issue with the findings.

Trust Signals

name	description	required	default
scan_path	Path to the directory to scan (relative to repo root).	no	.
patterns_file	Path to the Markdown file containing detection patterns.	no	patterns/synthetic_patterns.md
score_threshold	Fail the action when the Synthetic Code Score (per 1k LOC) meets or exceeds this value. Set to 0 to never fail.	no	0
create_issue	Whether to create a GitHub Issue with the results (true/false).	no	true
issue_label	Label to attach to the created issue.	no	synthscan
report_path	File path for the JSON report.	no	synthscan-report.json
diff_file	Path to a unified diff file. When set, only added lines in the diff are scored (PR mode).	no	""
sarif_output	Emit a SARIF 2.1.0 report for GitHub Code Scanning inline annotations (true/false).	no	false
ignore_file	Path to a .synthscanignore file with gitignore-style path patterns to exclude.	no	.synthscanignore

name	description
score	The Synthetic Code Score (normalised per 1k LOC).
raw_score	The raw (un-normalised) total score.
match_count	Number of pattern matches found.
lines_scanned	Total lines of code scanned.
issue_body	Full Markdown body of the report (also used in the issue).
high_critical_hit_rate	Number of HIGH or CRITICAL matches per file scanned.
by_directory	JSON object mapping directory paths to their score.
sarif_path	Path of the emitted SARIF report (only set when sarif_output is true).