Auto: Content & Presence Updates (June-July 2026)#1
Open
ppradyoth wants to merge 19 commits into
Open
Conversation
Zero-dependency Node script. Extracts headings (code-fence aware), builds GitHub-compatible anchor slugs with duplicate disambiguation, prints to stdout or injects an idempotent TOC block via --write. Documented in README.
Verifies the TOC is current without writing: exit 0 (up to date), 1 (stale), 2 (no markers). Documented in README. Tested across all three exit states.
- Detects relative file links pointing at missing paths - Validates #anchors (same-file and cross-file) using GitHub's slug algorithm - Ignores links in fenced code blocks and inline code spans - Network-free by default; --external lists URLs without fetching - CI-friendly exit codes (0 ok / 1 broken / 2 usage); --json output - Documented in README with usage and feature list
…hecks Concrete copy-paste artifacts wiring link-check.js (and opt-in markdown-toc.js --check) into CI and git hooks. Tested on this repo. README section + note on the marker false-positive caveat. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YC1umQHkdcQLWnoF5GKE45
Zero-dependency, network-free Node linter for the --- frontmatter block: required-key checks, YYYY-MM-DD date validation, boolean/list type checks, duplicate-key and unterminated-block detection. Supports --dir recursion, --json, --quiet, and CI exit codes (0/1/2). Practical YAML subset parser (scalars, quoted strings, flow + block lists, booleans, numbers). Tested against the blog-drafts repo plus crafted bad-input fixtures. README section 6 + TOC added; all links verified.
…, skipped levels)
…dep, --write/--check
…nguage, mismatched)
…text (a11y + SEO) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EsnAGky7CwiknXv6K84UnU
Was link-check only. Now runs the whole suite: link-check, code-fence-lint, image-alt-lint, and frontmatter-lint (--allow-missing) ON by default (defect-only, CI-safe); heading-lint and table-fmt --check opt-in (they flag deliberate style, not bugs); markdown-toc stays opt-in via TOC_FILES. Each check toggleable via CHECK_* env vars. Tested: default passes on this repo, strict (CHECK_HEADINGS=1 CHECK_TABLES=1) fails on the intentional duplicate sub-headings + unaligned table, toggles work. Updated README + docs-check.yml to match. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NdojMF6h7vP4khiEFhWwB1
Flags mixed bullet markers within one list (MD004), broken ordered numbering that's neither all-1. nor a clean increment (MD029), and odd-space list indentation (MD005/MD007, a non-failing warning). Tracks and skips fenced code; scopes marker checks to a single list block so separate lists using different markers are never cross-flagged. --json, --quiet, per-rule toggles, --strict-indent; CI exit codes; require()able via lintText. Tested on fixtures (each rule), false-positive guards, and the repo's own docs. Wired into examples/check-docs.sh (ON by default, CHECK_LISTS toggle) and documented as README section 11. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013kxtY7Uxk9sJZFdxU7ucAt
Lints commit messages against Conventional Commits: header grammar, type enum, blank-line separator (errors) plus subject/body length and style (warnings). Three input modes (message file, --stdin, --range A..B), hook-ready (strips git cruft, skips merge autos), --json/--quiet, require()-able lintMessage/stripGitCruft. Adds examples/git-commit-msg hook and README section 12 with a dogfood note. Tested across 16 cases incl. FP guards; existing doc suite still clean.
Zero-dep Node linter — version-heading format, SemVer, ISO dates, change-group names, duplicate/ordering/empty checks. Fenced-code aware, --json/--strict/require(). Wired into check-docs.sh as an auto-on per-file check when a CHANGELOG exists. README section 13. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VteDDVmV9aL5p8kSqdCxeC
The hygiene companion to the content lint family. Flags trailing whitespace (MD009), hard tabs in indentation (MD010), CRLF/bare-CR line endings, a missing/duplicated final newline, and over-long blank runs (MD012) — the invisible diff noise the content linters ignore. Every rule is mechanical, so --fix repairs all of them idempotently. Fenced-code aware; allows the 2-space Markdown hard break by default; works on any text file, not just MD. Wired into examples/check-docs.sh as a default-ON, defect-only check and documented as README section 14. Tested against crafted inputs: lint output, exit codes 0/1/2, --fix byte-correctness, idempotency, CRLF, --no-md-breaks; dogfooded clean on the repo's own docs. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017xACmT2TJTBxXtDgx1jpfK
Wired into check-docs.sh as a default-on defect-only check (empty/whitespace link text fail; non-descriptive and raw-URL text warn). README section 15 + ToC. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012fBd8EPMktgYBViLUd7H3s
Scans the working tree for hardcoded credentials using prefix-anchored patterns
(AWS AKIA, GitHub ghp_/github_pat_, Slack tokens+webhooks, Google AIza, Stripe
sk_live, npm_, private-key blocks) reported as errors, plus lower-confidence JWT
and generic high-entropy assignment rules as warnings. Shannon-entropy + placeholder
filtering keeps false positives down (AKIAIOSFODNN7EXAMPLE and ${VAR} don't fire);
findings are redacted so the report never leaks the secret. Flags: --strict/--json/
--quiet; exit 0/1/2. Adds examples/git-pre-commit-secrets hook and README section 16.
Verified: 9 crafted positives flagged, 6 negatives excluded, all exit codes, dogfooded
clean on the repo (23 files). Patterns cross-checked against gitleaks' default ruleset.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015E3hofptrivNd5nE786hcM
…MD052/MD053) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01J8EFkg8nwgpKwbsJbxh9oz
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013jMykKQfZSz6PncZJDE96c
…eading (MD036) Catches the fake headings heading-lint.js can't see — a bold paragraph that renders like a section title but produces no anchor, no TOC entry, no screen-reader stop. Fence-aware; skips list items, blockquotes, table rows, and emphasis ending in sentence punctuation. Wired into check-docs.sh (ON by default) and documented in the README. 21 scripts. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wr9aHqQKdXspWsHxdEtP8j
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Cumulative content & presence work for the June–July 2026 autonomous agent window. Do not merge until review.
Cumulative changelog
2026-07-11 run
emphasis-heading-lint.js— flags a whole line of bold/italic used as a heading (markdownlint MD036), e.g.**Installation**standing alone on its own line. It renders like a section title and is structurally nothing: no#, so it produces no anchor, no TOC entry, and no screen-reader stop — invisible to every tool that reads document outline, including this repo's ownheading-lint.jsandmarkdown-toc.js. This is the fake-heading gapheading-lint.js(which only checks real#headings) can't see. Matches markdownlint's MD036 semantics faithfully: only flags a line that is entirely one emphasis span (**…**,__…__,*…*,_…_) whose text does not end in sentence punctuation (a configurable set via--punctuation, so**Warning!**and*See below:*are correctly left alone as emphasized sentences). Fence-aware like the rest of the suite; skips list items (- **Label:**), blockquotes (> **Note**), and table rows (| **cell** |). Flags--json/--quiet; exit0/1/2; exportslintContent+wholeLineEmphasisforrequire(). Verified: crafted fixture flagged exactly the 3 real fake-headings (**,*,__forms) while correctly protecting 10 negatives (real heading, sentence-ending emphasis, inline bold, list/blockquote/table bold, multi-span line, fenced bold); all exit codes checked; dogfooded clean on the repo README. Wired intoexamples/check-docs.shas a default-ON check (CHECK_EMPHASIS_HEADING) and the full suite re-run green with it in place; added README section 19 + ToC entry.2026-07-10 run
bare-url-lint.js— flags bare URLs sitting naked in prose (markdownlint MD034): a class no existing script covers, distinct fromlink-check.js(reachability) andlink-text-lint.js(link text). Fence/inline-code-aware; protects URLs already inside[text](url), reference definitions, and raw-HTMLhref/src. Wired intocheck-docs.sh(default-ON) + README section 18.2026-06-23 → 2026-07-09 runs
reference-link-lint.js(MD052/MD053),secret-scan.js(zero-dep hardcoded-secret scanner +examples/git-pre-commit-secrets),link-text-lint.js,whitespace-lint.js(--fix),changelog-lint.js(Keep a Changelog),commit-lint.js,list-lint.js, thecheck-docs.shone-command suite,image-alt-lint.js,code-fence-lint.js,table-fmt.js,heading-lint.js,frontmatter-lint.js, theexamples/folder,link-check.js, andmarkdown-toc.js. Each tested before commit and (where a linter) wired intocheck-docs.shwith a README section.Verification
emphasis-heading-lint.jsexercised against crafted positives (**/*/__whole-line spans) and negatives (real#heading, sentence-ending emphasis, inline bold, list/blockquote/table bold, multi-span line, fenced bold), all exit codes,--json/--quiet; wired intocheck-docs.shand the whole suite re-run green (bash examples/check-docs.sh→ all checks passed) with the new linter active; README section 19 + ToC anchor added.🤖 Generated with Claude Code