sync-ai-insights-readme

To sync markdown content from a JSON metadata file into specific README sections, this script generates deterministic markdown from _meta.json and performs a partial replacement of two bounded sections in README.md, preserving all other custom content.

Partial replacement works by identifying strictly managed boundary markers in the README file, validating that only those two bounded sections change during the sync process, and writing updates without modifying any user-defined content outside those boundaries.

Yes, you can use GITHUB_TOKEN or GH_TOKEN to automatically push README updates. The script supports an optional authenticated push mode and can perform a git pull --ff-only before writing changes to the target branch.

The best way to keep an article list sorted automatically is to render the content from _meta.json in descending time order, ensuring the README's managed sections reflect a deterministic and reproducible sequence without manual intervention.

The script uses deterministic markdown rendering to update the managed sections, meaning the format is strictly controlled to ensure reproducible content lists rather than supporting arbitrary custom markdown rendering formats.

If README content gets overwritten during a metadata sync, it indicates the strict validation failed or the affected content was within the managed boundaries. The tool is designed to only change two specific bounded sections and preserve everything else.