@gurupanguji

Scheduled Post Deploy And Social Gating Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Ensure scheduled posts are rebuilt after their publish timestamp, and block social posting until the canonical post URL is confirmed live.

Architecture: Add a dedicated rebuild workflow for scheduled posts, add live-URL verification and retries to the social publisher, and enforce a single scheduled publish timestamp in repository validation. Normalize future post dates to match that policy.

Tech Stack: GitHub Actions, Jekyll, Python 3, Requests, repo-managed markdown content

---

Task 1: Add The Scheduled Rebuild Workflow

Files:

• Create: .github/workflows/rebuild_scheduled_posts.yml

• Step 1: Create the workflow skeleton

Add a daily schedule trigger at 10 12 * * * plus workflow_dispatch.

• Step 2: Build the site in CI

Set up Ruby, cache Bundler if useful, install gems, and run bundle exec jekyll build.

• Step 3: Trigger a deploy-safe commit

Update a small rebuild marker file only inside the workflow, commit it only when changed, and push to main.

• Step 4: Verify workflow YAML syntax by inspection

Run: sed -n '1,240p' .github/workflows/rebuild_scheduled_posts.yml Expected: schedule, build, and guarded commit steps are present

Task 2: Gate Social Publishing On Live URLs

Files:

• Modify: scripts/publish_social.py

• Modify: .github/workflows/publish_social.yml

• Step 1: Add preflight CLI arguments

Add retry configuration flags and a default-on live URL verification path.

• Step 2: Implement canonical URL verification

Use requests to fetch the URL, require 200, and verify title or og:title.

• Step 3: Add retry loop

Retry verification on a bounded interval before any publishing function runs.

• Step 4: Wire workflow env and invocation

Pass retry defaults from publish_social.yml and keep the script in a safe mode that never publishes when verification fails.

• Step 5: Dry-run verification

Run: python3 scripts/publish_social.py --date 2026-03-22 --dry-run Expected: snippet loads and preflight path is visible in output

Task 3: Enforce Scheduled Publish Timing

Files:

• Modify: scripts/validate_posts.py

• Step 1: Add scheduled timestamp policy constants

Encode 2026-03-23 as the enforcement start date and 12:00:00 +0000 as the required timestamp.

• Step 2: Validate future scheduled posts against policy

Fail when a post on or after the enforcement date has a different raw front matter timestamp.

• Step 3: Keep current validation behavior intact

Preserve filename-date matching and future snippet checks.

• Step 4: Run validator

Run: python3 scripts/validate_posts.py --today 2026-03-22 Expected: validation succeeds after timestamp normalization

Task 4: Normalize Future Scheduled Posts

Files:

• Modify: _posts/2026-03-23-*.md
• Modify: _posts/2026-03-24-*.md
• Modify: _posts/2026-03-25-*.md
• Modify: _posts/2026-03-26-*.md
• Modify: _posts/2026-03-27-*.md
• Modify: _posts/2026-03-28-*.md
• Modify: _posts/2026-03-29-*.md
• Modify: _posts/2026-03-30-*.md

• Modify: _posts/2026-03-31-*.md

• Step 1: Update each future post timestamp

Set front matter date to YYYY-MM-DD 12:00:00 +0000.

• Step 2: Spot-check the edited files

Run: rg -n '^date:' _posts/2026-03-2*.md _posts/2026-03-3*.md Expected: all future posts from March 23 onward use 12:00:00 +0000

Task 5: Verify End To End

Files:

• Verify: .github/workflows/rebuild_scheduled_posts.yml
• Verify: .github/workflows/publish_social.yml
• Verify: scripts/publish_social.py

• Verify: scripts/validate_posts.py

• Step 1: Run validator

Run: python3 scripts/validate_posts.py --today 2026-03-22 Expected: Validated ... post(s) successfully.

• Step 2: Run safe dry-run social command

Run: python3 scripts/publish_social.py --date 2026-03-22 --dry-run Expected: no external post is made; the command exits only after the live URL preflight path succeeds or reports the exact failure

• Step 3: Review diff

Run: git diff --stat Expected: workflow, script, docs, and scheduled post timestamps only

• Step 4: Commit

git add .github/workflows/rebuild_scheduled_posts.yml .github/workflows/publish_social.yml scripts/publish_social.py scripts/validate_posts.py docs/superpowers/specs/2026-03-22-scheduled-post-deploy-and-social-gating-design.md docs/superpowers/plans/2026-03-22-scheduled-post-deploy-and-social-gating-implementation-plan.md _posts/2026-03-2*.md _posts/2026-03-3*.md
git commit -m "feat: coordinate scheduled post deploy and social gating"