Rules

Category


1	`dir_absent`	Existence	alint dir_absent rule (existence): Directory counterpart of file_absent.
2	`dir_exists`	Existence	alint dir_exists rule (existence): Directory counterpart of file_exists.
3	`file_absent`	Existence	alint file_absent rule (existence): No file matching paths may exist in the walked tree.
4	`file_exists`	Existence	alint file_exists rule (existence): Every glob match in paths must correspond to a real file.
5	`editorconfig_conforms`	Content, Text hygiene	alint editorconfig_conforms rule (content): Enforce selected formatting properties from the repository's own .editorconfig files without repeating those...
6	`file_content_forbidden`	Content, Security / Unicode sanity	alint file_content_forbidden rule (content): File contents must NOT match a regex.
7	`file_content_matches`	Content	alint file_content_matches rule (content): File contents must contain at least one match for a regex.
8	`file_ends_with`	Content	alint file_ends_with rule (content): Byte-level prefix / suffix check.
9	`file_footer`	Content	alint file_footer rule (content): The configured number of final lines in each file in scope must match a regex.
10	`file_hash`	Content, Security / Unicode sanity	alint file_hash rule (content): Content SHA-256 must equal the expected digest.
11	`file_header`	Content	alint file_header rule (content): The first N lines must match a regex (line-oriented).
12	`file_is_ascii`	Content, Encoding, Security / Unicode sanity	alint file_is_ascii rule (content): Every byte in the file must be < 0x80 (pure ASCII), except codepoints listed in allow.
13	`file_is_text`	Content, Encoding	alint file_is_text rule (content): Content is detected as text (magic bytes + UTF-8 validity check), fails on binary files matched by paths.
14	`file_max_lines`	Content, Structure	alint file_max_lines rule (content): File must have at most max_lines lines, using the same accounting as file_min_lines.
15	`file_max_size`	Content, Structure	alint file_max_size rule (content): File must be at most max_bytes in size.
16	`file_min_lines`	Content, Structure	alint file_min_lines rule (content): File must have at least min_lines lines...
17	`file_min_size`	Content, Structure	alint file_min_size rule (content): File must be at least min_bytes in size.
18	`file_shebang`	Content, Unix metadata	alint file_shebang rule (content): First line of each file in scope must match the shebang regex.
19	`file_starts_with`	Content	alint file_starts_with rule (content): Byte-level prefix / suffix check.
20	`markdown_images_have_alt`	Content	alint markdown_images_have_alt rule (content): Require every live CommonMark image to have non-empty rendered alt text.
21	`markdown_no_duplicate_headings`	Content	alint markdown_no_duplicate_headings rule (content): Reject a later Markdown heading whose generated base anchor collides with an earlier heading.
22	`markdown_required_headings`	Content	alint markdown_required_headings rule (content): Require the complete rendered heading sequence to match an ordered headings template.
23	`pinned_references`	Content, Security / Unicode sanity	alint pinned_references rule (content): Require executable references in supported CI and container files to identify immutable artifacts rather...
24	`spdx_identifier_valid`	Content, Security / Unicode sanity	alint spdx_identifier_valid rule (content): Validate every SPDX-License-Identifier: value as a strict SPDX license expression.
25	`dotenv_path_absent`	Structured query	alint dotenv_path_absent rule (structured query): Query a dotenv document with JSONPath and require it to match nothing.
26	`dotenv_path_equals`	Structured query	alint dotenv_path_equals rule (structured query): Query a dotenv document with JSONPath and require every selected value to equal the expected value.
27	`dotenv_path_matches`	Structured query	alint dotenv_path_matches rule (structured query): Query a dotenv document with JSONPath and require every selected string to match a regular expression.
28	`hcl_path_absent`	Structured query	alint hcl_path_absent rule (structured query): Query an HCL document with JSONPath and require it to match nothing.
29	`hcl_path_equals`	Structured query	alint hcl_path_equals rule (structured query): Query an HCL document with JSONPath and require every selected value to equal the expected value.
30	`hcl_path_matches`	Structured query	alint hcl_path_matches rule (structured query): Query an HCL document with JSONPath and require every selected string to match a regular expression.
31	`ini_path_absent`	Structured query	alint ini_path_absent rule (structured query): Query an INI document with JSONPath and require it to match nothing.
32	`ini_path_equals`	Structured query	alint ini_path_equals rule (structured query): Query an INI document with JSONPath and require every selected value to equal the expected value.
33	`ini_path_matches`	Structured query	alint ini_path_matches rule (structured query): Query an INI document with JSONPath and require every selected string to match a regular expression.
34	`json_path_absent`	Structured query	alint json_path_absent rule (structured query): Query a JSON document with JSONPath and require it to match nothing.
35	`json_path_equals`	Structured query	alint json_path_equals rule (structured query): Query a JSON document with JSONPath and require every selected value to equal the expected value.
36	`json_path_matches`	Structured query	alint json_path_matches rule (structured query): Query a JSON document with JSONPath and require every selected string to match a regular expression.
37	`json_schema_passes`	Structured query	alint json_schema_passes rule (structured query): Validate every JSON / YAML / TOML / XML / dotenv / properties / INI / HCL file in paths against a JSON...
38	`properties_path_absent`	Structured query	alint properties_path_absent rule (structured query): Query a Java properties document with JSONPath and require it to match nothing.
39	`properties_path_equals`	Structured query	alint properties_path_equals rule (structured query): Query a Java properties document with JSONPath and require every selected value to equal...
40	`properties_path_matches`	Structured query	alint properties_path_matches rule (structured query): Query a Java properties document with JSONPath and require every selected string to match...
41	`toml_path_absent`	Structured query	alint toml_path_absent rule (structured query): Query a TOML document with JSONPath and require it to match nothing.
42	`toml_path_equals`	Structured query	alint toml_path_equals rule (structured query): Query a TOML document with JSONPath and require every selected value to equal the expected value.
43	`toml_path_matches`	Structured query	alint toml_path_matches rule (structured query): Query a TOML document with JSONPath and require every selected string to match a regular expression.
44	`xml_path_absent`	Structured query	alint xml_path_absent rule (structured query): Query an XML document with JSONPath and require it to match nothing.
45	`xml_path_equals`	Structured query	alint xml_path_equals rule (structured query): Query an XML document with JSONPath and require every selected value to equal the expected value.
46	`xml_path_matches`	Structured query	alint xml_path_matches rule (structured query): Query an XML document with JSONPath and require every selected string to match a regular expression.
47	`yaml_path_absent`	Structured query	alint yaml_path_absent rule (structured query): Query a YAML document with JSONPath and require it to match nothing.
48	`yaml_path_equals`	Structured query	alint yaml_path_equals rule (structured query): Query a YAML document with JSONPath and require every selected value to equal the expected value.
49	`yaml_path_matches`	Structured query	alint yaml_path_matches rule (structured query): Query a YAML document with JSONPath and require every selected string to match a regular expression.
50	`filename_case`	Naming	alint filename_case rule (naming): Basename (stem only or full) matches a case convention: snake, kebab, pascal, camel, screaming-snake, flat, lower, upper.
51	`filename_regex`	Naming	alint filename_regex rule (naming): Basename matches a regex.
52	`final_newline`	Text hygiene	alint final_newline rule (text hygiene): File must end with a single \n.
53	`indent_style`	Text hygiene	alint indent_style rule (text hygiene): Every non-blank line indents with the configured style (tabs or spaces).
54	`line_endings`	Text hygiene, Portable metadata	alint line_endings rule (text hygiene): Every line ending matches target: lf or crlf.
55	`line_max_width`	Text hygiene	alint line_max_width rule (text hygiene): Cap line length in characters (not bytes, code points).
56	`max_consecutive_blank_lines`	Text hygiene	alint max_consecutive_blank_lines rule (text hygiene): Cap runs of blank lines to max.
57	`no_trailing_whitespace`	Text hygiene	alint no_trailing_whitespace rule (text hygiene): No line may end with space or tab.
58	`no_bidi_controls`	Security / Unicode sanity, Encoding	alint no_bidi_controls rule (security / unicode sanity): Flag Trojan-Source bidi override characters (U+202A to U+202E, U+2066 to U+2069).
59	`no_merge_conflict_markers`	Security / Unicode sanity, Text hygiene	alint no_merge_conflict_markers rule (security / unicode sanity): Flag <<<<<<<, =======, >>>>>>>, \|\|\|\|\|\|\| markers at the start of a line, almost always...
60	`no_zero_width_chars`	Security / Unicode sanity, Encoding	alint no_zero_width_chars rule (security / unicode sanity): Flag body-internal zero-width characters (U+200B, U+200C, U+200D, and non-leading U+FEFF).
61	`no_bom`	Encoding, Text hygiene	alint no_bom rule (encoding): Flag a leading UTF-8 / UTF-16 LE/BE / UTF-32 LE/BE byte-order mark.
62	`max_directory_depth`	Structure	alint max_directory_depth rule (structure): Tree depth from repo root may not exceed max_depth.
63	`max_files_per_directory`	Structure	alint max_files_per_directory rule (structure): Per-directory fanout may not exceed max_files.
64	`no_empty_files`	Structure	alint no_empty_files rule (structure).
65	`no_case_conflicts`	Portable metadata, Naming	alint no_case_conflicts rule (portable metadata): Flag paths that differ only by case (e.g. README.md + readme.md).
66	`no_illegal_windows_names`	Portable metadata, Naming	alint no_illegal_windows_names rule (portable metadata): Reject path components that Windows cannot represent.
67	`executable_bit`	Unix metadata	alint executable_bit rule (unix metadata): Assert every file in scope either has the +x bit set (require: true) or does not (require: false).
68	`executable_has_shebang`	Unix metadata, Content	alint executable_has_shebang rule (unix metadata): Every file with +x set must begin with #!.
69	`no_symlinks`	Unix metadata, Portable metadata, Security / Unicode sanity	alint no_symlinks rule (unix metadata): Flag tracked paths that are symbolic links.
70	`shebang_has_executable`	Unix metadata, Content	alint shebang_has_executable rule (unix metadata): Every file starting with #! must have +x set.
71	`changeset_requires_path`	Git hygiene, Cross-file	alint changeset_requires_path rule (git hygiene): The <since>...HEAD diff must add (git status A) at least one path matching add_glob...
72	`commented_out_code`	Git hygiene, Content	alint commented_out_code rule (git hygiene): Heuristic detector for blocks of commented-out source code...
73	`git_blame_age`	Git hygiene	alint git_blame_age rule (git hygiene): Fire on lines matching a regex whose git blame author-time is older than max_age_days.
74	`git_commit_author_allowlist`	Git hygiene, Security / Unicode sanity	alint git_commit_author_allowlist rule (git hygiene): Assert every commit author in scope matches an allowed email and/or name pattern.
75	`git_commit_gpg_signed`	Git hygiene, Security / Unicode sanity	alint git_commit_gpg_signed rule (git hygiene): Assert every commit in scope has a verifying signature (git verify-commit exits 0).
76	`git_commit_message`	Git hygiene	alint git_commit_message rule (git hygiene): Validate commit-message shape via regex, max-subject-length, or required-body.
77	`git_commit_no_fixup`	Git hygiene	alint git_commit_no_fixup rule (git hygiene): Fail on residual fixup! / squash! / amend! commits left in scope, the ones git commit --fixup / --squash...
78	`git_commit_signed_off`	Git hygiene	alint git_commit_signed_off rule (git hygiene): Assert every commit in scope carries a DCO (Developer Certificate of Origin) Signed-off-by: trailer...
79	`git_commit_subject_matches`	Git hygiene	alint git_commit_subject_matches rule (git hygiene): Each commit's subject line (the first line of its message) must match the matches: regex...
80	`git_no_denied_paths`	Git hygiene, Security / Unicode sanity	alint git_no_denied_paths rule (git hygiene): Fire when any tracked file matches a configured glob denylist.
81	`markdown_paths_resolve`	Git hygiene, Cross-file	alint markdown_paths_resolve rule (git hygiene): Validate that backticked workspace paths in markdown files resolve to real files or directories in the repo.
82	`no_submodules`	Git hygiene	alint no_submodules rule (git hygiene): Flag the presence of .gitmodules at the repo root, always, regardless of paths.
83	`pair_changed_together`	Git hygiene, Cross-file	alint pair_changed_together rule (git hygiene): If the <since>...HEAD diff changes any path matching if_changed:, at least one path matching...
84	`command_idempotent`	Cross-file	alint command_idempotent rule (cross-file): Run a user-declared formatter/checker in its --check (idempotence) mode once: exit 0 => the tree is...
85	`cross_file`	Cross-file	alint cross_file rule (cross-file): A source must hold a relation to one or more targets (or, for resolves, the filesystem).
86	`dir_contains`	Cross-file, Structure	alint dir_contains rule (cross-file): Every directory matching select: must contain files matching every glob in require.
87	`dir_only_contains`	Cross-file, Structure	alint dir_only_contains rule (cross-file): Every direct-child file of a directory matching select: must match at least one glob in allow.
88	`every_matching_has`	Cross-file	alint every_matching_has rule (cross-file): For every file or directory matching select:, every nested rule under require: must be satisfied.
89	`file_graph`	Cross-file	alint file_graph rule (cross-file): Assemble the repo's file -> file reference graph and assert a global structural property the 1-level cross-file kinds...
90	`for_each_dir`	Cross-file	alint for_each_dir rule (cross-file): For every matching directory / file, evaluate a nested require: block with the entry as context.
91	`for_each_file`	Cross-file	alint for_each_file rule (cross-file): For every matching directory / file, evaluate a nested require: block with the entry as context.
92	`for_each_match`	Cross-file	alint for_each_match rule (cross-file): For each line matching select (a regex), the line must satisfy the nested require: predicates.
93	`generated_file_fresh`	Cross-file, Security / Unicode sanity	alint generated_file_fresh rule (cross-file): A committed artefact must equal what a declared command generator produces, in one of two modes...
94	`import_gate`	Cross-file, Security / Unicode sanity	alint import_gate rule (cross-file): Forbid imports whose extracted target matches a forbid regex, within the paths scope, an architectural import...
95	`key_parity`	Cross-file	alint key_parity rule (cross-file): One reference file and a glob of peers must declare the same key set.
96	`markdown_fragments_resolve`	Cross-file, Content	alint markdown_fragments_resolve rule (cross-file): Require every live local Markdown link fragment to name a heading anchor in its resolved target document.
97	`markdown_links_resolve`	Cross-file, Content	alint markdown_links_resolve rule (cross-file): Validate live Markdown link, image, and reference-definition destinations against the repository tree.
98	`ordered_block`	Cross-file, Text hygiene	alint ordered_block rule (cross-file): The lines between a start / end marker pair must stay sorted (and, with unique: true, free of duplicates) under...
99	`pair`	Cross-file	alint pair rule (cross-file): For every file matching primary, a file matching the partner template must exist.
100	`pair_hash`	Cross-file, Security / Unicode sanity	alint pair_hash rule (cross-file): The algorithm digest (sha256 default / sha512) of every file matching source must appear in the single target file...
101	`registry_paths_resolve`	Cross-file	alint registry_paths_resolve rule (cross-file): A manifest file enumerates path entries; each must resolve to an on-disk artefact.
102	`unique_by`	Cross-file	alint unique_by rule (cross-file): No two files matching select may share the value of key...
103	`command`	Plugin (tier 1)	alint command rule (plugin (tier 1)): Shell out to an external CLI per matched file.