Snapshot: MLS sync fixes, image refresh, plugin/theme updates

MLS plugin fixes from this session:
- Fix silent insert failures: location column NOT NULL was rejecting wpdb->insert calls,
  causing ~18k new properties since Dec 2025 to be lost. Inserts now build raw SQL
  with ST_PointFromText so the spatial column is populated atomically.
- Auto-refresh expired media URLs in MLS_Media_Handler::fetch_and_cache(), guarded by
  a property-level GET_LOCK so concurrent fetches share one API refresh.
- Normalize WP_Error to null in mls_get_property_image() so callers can rely on the
  documented string|null contract.
- Support comma-separated property_type filters in MLS_Query and MLS_Cluster so the
  homepage "View All Commercial" link (?property_type=Commercial+Sale,Land,Farm)
  actually filters correctly.
- Incremental sync now looks back 10 minutes past the latest modification timestamp
  as a safety margin against missed records.
- Smart sync exits silently (info-level, not warning) when a full sync is in progress.

Operational:
- New cron: weekly full sync Sundays at 3 AM (/usr/local/bin/mls-full-sync).
- New cron: hourly 2GB cap on mls-thumbnails/ and cache/transformed-images/
  (/usr/local/bin/mls-image-cache-cap).
- Logrotate config for wp-content/debug.log (2-day retention, daily rotation,
  delaycompress).

Repo policy:
- CLAUDE.md updated with explicit "commit everything except build artifacts" policy.
- .gitignore: untrack runtime image caches and debug.log rotations.

Other modifications in this snapshot are pre-existing in-flight theme/plugin/db_content_updates work.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

db_content_updates/2026-01-21_18-15_blog-enhancements.md

@@ -0,0 +1,67 @@
+# Blog Enhancements
+
+**Date**: 2026-01-21
+**Type**: Template Updates + ACF Field Addition
+**Status**: IMPLEMENTED IN DEV
+
+## Summary
+
+Enhanced single blog post pages with additional sections and added Agent author capability.
+
+## Code Changes
+
+### Templates
+- `single.php` - Added three new sections below post content:
+  1. Enhanced Next/Prev navigation with thumbnails
+  2. Related Posts section (always shows, falls back to recent posts)
+  3. Featured Properties section (3 active MLS listings)
+
+- `template-parts/content/content-single.php` - Added agent author display in post meta
+
+- `template-parts/content/content-single.scss` - Added styles for:
+  - Post navigation with thumbnails
+  - Featured properties grid
+  - Author meta styling
+
+### ACF Fields
+- Added "Post Author" field group for blog posts:
+  - Field: `post_agent_author` (post_object linking to Agent CPT)
+  - Location: Sidebar of post edit screen
+  - Only shows active (non-disabled) agents in dropdown
+
+### Functions
+- Added `homeproz_filter_agent_post_object()` filter to exclude disabled agents from author dropdown
+- Removed comments functionality site-wide
+
+## Features
+
+### Agent Author on Blog Posts
+- In post editor sidebar, select an agent as the post author
+- Author name displays in post meta with link to agent profile
+- If agent is later disabled, name still shows but link is removed
+- Only active agents appear in the dropdown selector
+
+### Enhanced Post Navigation
+- Shows Previous/Next post with thumbnail images
+- Falls back to placeholder icon if no featured image
+- Responsive grid layout
+
+### Related Posts
+- Shows 3 posts from same category
+- Falls back to 3 recent posts if no category matches
+- Always displays something (unless only 1 post exists)
+
+### Featured Properties
+- Shows 3 active MLS listings below blog content
+- "View All Properties" button links to /properties/
+- Helps drive traffic from blog to listings
+
+## Agent Disabled Flag Behavior
+
+The existing `agent_disabled` ACF field controls:
+1. **Team Page**: Disabled agents hidden from grid
+2. **Agent Archive**: Disabled agents excluded
+3. **Agent Profile**: Returns 404 for disabled agents
+4. **Property Cards**: Shows office contact instead of disabled agent
+5. **Blog Author Dropdown**: Only active agents shown (NEW)
+6. **Blog Author Display**: Disabled agent names show without link (NEW)