Auto: Content & Presence Updates (June-July 2026)#1
Open
ppradyoth wants to merge 17 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
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-09 run
reference-link-lint.js— validates Markdown reference-style links ([text][ref]with a separate[ref]: urldefinition), the syntaxlink-check.jsdoesn't touch. Confirmed the gap first:link-check.jsreports "0 links" on a file whose[missing][nope]reference is broken and whose[unused]definition is dead — reference links slip through entirely. Three rules: undefined reference (markdownlint MD052, error — the link renders as literal brackets on GitHub), unused definition (MD053, warning), and duplicate definition (warning — CommonMark keeps the first and silently ignores the rest). Fence-aware and inline-code-aware. Deliberately does not flag a bare[shortcut]with no definition as undefined — that's literal text in Markdown, not a broken link — so only the self-declaring[t][ref]/[ref][]forms can error (no false positives on[just brackets]). Flags--strict/--json/--quiet; exit0/1/2. Verified: crafted test caught all 3 undefined refs (full, collapsed, image[alt][x]), the unused def, and the dupe, while correctly ignoring literal brackets, inline links, fenced blocks, and inline code; clean/--strict/--json/--quiet/bad-flag/missing-file paths all checked; dogfooded clean on the repo README (node -cclean). Wired intoexamples/check-docs.shas a default-ON, defect-only check (only the undefined-reference error fails the suite; unused/dupe stay advisory unless--strict);bash -nclean and the suite re-run confirms it participates. Added README section 17 + ToC entry (anchor resolves vialink-check.js, 26 links).2026-06-23 → 2026-07-08 runs
secret-scan.js(zero-dep hardcoded-secret scanner, gitleaks-shaped prefix rules + 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
reference-link-lint.jsexercised against crafted positives (every rule) and negatives (literal brackets, inline links, fences, inline code), all exit codes,--strict/--json/--quiet; wired intocheck-docs.sh(bash -nclean, suite re-run passes); README section 17 + ToC anchor resolve vialink-check.js.🤖 Generated with Claude Code