Auto: Content & Presence Updates (June-July 2026)#1
Open
ppradyoth wants to merge 18 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
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-10 run
bare-url-lint.js— flags bare URLs sitting naked in prose (See https://example.com for details.), the markdownlint MD034 class that no existing script covers. Distinct fromlink-check.js(validates reachability) andlink-text-lint.js(grades link text): this is about how the URL is written. Three real reasons a bare URL is a latent bug, none visible to a link checker: (1) auto-linking isn't universal — GitHub does it, many renderers and every plain-text reader leave it dead; (2) it can't carry descriptive text; (3) trailing punctuation collides —see https://example.com.links toexample.com.(a real 404). Fence- and inline-code-aware like the rest of the suite; correctly protects URLs already inside[text](url)/[alt](url)/<autolink>, reference definitions ([label]: url), and raw-HTMLhref/srcattributes. Flags--json/--quiet; exit0/1/2; exportslintContent+protectedRangesforrequire(). Verified: crafted test flagged exactly the 4 bare URLs (incl. two on one line and the trailing-dot case, with the.correctly stripped from the match) while all 7 correctly-written forms were protected;node --checkclean; dogfooded clean on the repo README and the cross-repo new markdown. Wired intoexamples/check-docs.shas a default-ON check (CHECK_BARE_URL,bash -nclean) and added README section 18 + ToC entry.2026-06-23 → 2026-07-09 runs
reference-link-lint.js(MD052/MD053 reference-style link validation, the syntaxlink-check.jsdoesn't touch; default-ON defect-only in the suite, README §17),secret-scan.js(zero-dep hardcoded-secret scanner + entropy + redaction,examples/git-pre-commit-secrets),link-text-lint.js(a11y link-text),whitespace-lint.js(MD009/010/CRLF/EOF,--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
bare-url-lint.jsexercised against crafted positives (bare, two-per-line, trailing-dot) and negatives (autolink, inline link, image, reference def, inline code, fence, raw-HTML attr), all exit codes,--json/--quiet;node --checkclean; wired intocheck-docs.sh(bash -nclean); README section 18 + ToC anchor added.🤖 Generated with Claude Code