Syndicate Article

Select the article to syndicate:

• If ${var} is set, use articles/${var} directly.
• Otherwise, find the most recently modified .md file in articles/ (excluding feed.xml and .gitkeep):

  ls -t articles/*.md 2>/dev/null | head -1
  

• If no articles exist, log "SYNDICATE_SKIP: no articles found" and stop.

Check for duplicates — before posting, check if this article was already syndicated:

• Search the last 7 days of memory/logs/ for SYNDICATED: entries containing this filename.
• If found, log "SYNDICATE_SKIP: already syndicated {filename}" and stop.

Parse the article:

• Title: Extract from the first # Heading line. If the article has Jekyll frontmatter with a title: field, use that instead.
• Body: Everything after the first heading (or after frontmatter if present). Clean up any Jekyll-specific liquid tags.
• Date: Extract YYYY-MM-DD from the filename using regex ([0-9]{4}-[0-9]{2}-[0-9]{2}).
• Slug: Everything before the date in the filename, with trailing hyphens removed.

Determine tags from the filename slug (max 4 tags for Dev.to):

• repo-article, article → ai, github, automation, agents
• token-report, token-alert, defi-overview, defi-monitor → crypto, defi, blockchain, trading
• changelog, push-recap, weekly-shiplog → opensource, devops, changelog, github
• digest, rss-digest, hacker-news → news, tech, ai, digest
• deep-research, research-brief, paper-pick → research, ai, machinelearning, papers
• technical-explainer → tutorial, ai, explainer, programming
• Everything else → ai, automation, agents, programming

Build the canonical URL pointing to the GitHub Pages post:

https://aaronjmars.github.io/aeon/articles/YYYY/MM/DD/<slug>/

Where <slug> is derived the same way update-gallery builds Jekyll post filenames: title lowercased, spaces replaced with hyphens, special characters removed, truncated to 50 chars.

Post to Dev.to using WebFetch (not curl, due to sandbox auth limitations):

• Use WebFetch to POST to https://dev.to/api/articles with headers:
  • Content-Type: application/json
  • api-key: <DEVTO_API_KEY>
• Request body:

  {
    "article": {
      "title": "<extracted title>",
      "body_markdown": "<article body>",
      "published": true,
      "tags": ["tag1", "tag2", "tag3", "tag4"],
      "canonical_url": "<github pages URL>",
      "series": "Aeon"
    }
  }
  

• Parse the response for the url field (the Dev.to article URL) and id.
• If WebFetch cannot send POST requests with custom headers, fall back to the post-process pattern (see Sandbox note).

Handle errors:

• If the API returns 422 (title already taken / duplicate), log "SYNDICATE_SKIP: article already exists on Dev.to" and stop gracefully.
• If the API returns 401, log "SYNDICATE_ERROR: DEVTO_API_KEY is invalid" and stop.
• If any other error, log the status code and response body.

Log the result to memory/logs/${today}.md:

SYNDICATED: {filename} → {devto_url}

Send notification via ./notify:

Article syndicated to Dev.to

"{article title}" is now live on Dev.to, reaching 1M+ developers beyond our GitHub Pages audience.

Dev.to: {devto_url}
Original: {canonical_url}