Content Publisher - ACT Communications Automation
Empathy Ledger Content Hub (NEW)
Empathy Ledger serves as the central content hub for the ACT ecosystem - photography, videography, writing, and storytelling with intelligent tagging and API-driven syndication.
Content Hub Architecture
┌─────────────────────────────────────────────────────────────────────┐
│ CONTENT SOURCES │
│ • Your photography and videography │
│ • Storyteller contributions │
│ • ACT project milestones │
│ • Ralph-generated content │
└────────────────────────────┬────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────────┐
│ EMPATHY LEDGER CONTENT HUB │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ MEDIA INTELLIGENCE (Consent-Gated) │ │
│ │ • Auto-tag objects/scenes in photos (Claude Vision) │ │
│ │ • Face recognition → link to storyteller profiles │ │
│ │ • Theme extraction → narrative connections │ │
│ │ • ALMA integration (interventions, evidence) │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ THREE-TIER VISIBILITY │ │
│ │ • Private: Storyteller only │ │
│ │ • Community: ACT ecosystem + approved partners │ │
│ │ • Public: Anyone with attribution │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ CONTENT SYNDICATION API │ │
│ │ • GET /api/v1/content-hub/stories │ │
│ │ • GET /api/v1/content-hub/articles │ │
│ │ • GET /api/v1/content-hub/media/library │ │
│ │ • GET /api/v1/content-hub/themes │ │
│ │ • POST /api/v1/content-hub/syndicate │ │
│ └─────────────────────────────────────────────────────────────┘ │
└────────────────────────────┬────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────────┐
│ DISTRIBUTION │
│ │
│ ACT Projects (via API) External Users Social │
│ • JusticeHub • Partner orgs • GHL │
│ • ACT Farm • Researchers • Social │
│ • The Harvest • Media • Posts │
│ • Goods on Country │
│ • ACT Placemat │
└─────────────────────────────────────────────────────────────────────┘
Content Hub Database Tables
| Table |
Purpose |
media_ai_analysis |
Smart photo/video tagging (consent-gated) |
media_person_recognition |
Face recognition with two-party consent |
media_narrative_themes |
Theme extraction and story linking |
articles |
Blog/article content for syndication |
content_syndication |
Track content distribution |
Media Intelligence Pipeline
// Photo analysis with consent gate
import { createPhotoAnalyzer } from './lib/media-intelligence/photo-analyzer';
const analyzer = createPhotoAnalyzer();
// 1. Grant consent (REQUIRED before any AI analysis)
await analyzer.grantConsent(mediaAssetId, storytellerId, grantedBy);
// 2. Analyze photo
const result = await analyzer.analyzePhoto({
mediaAssetId,
storytellerId,
imageUrl,
consentGranted: true
});
// Result includes:
// - detectedObjects: [{label, confidence}]
// - sceneClassification: 'portrait' | 'ceremony' | etc.
// - autoTags: ['community', 'gathering', ...]
// - culturalReviewRequired: boolean
// - emotionalTone: 'hopeful' | 'reflective' | etc.
Face Recognition (Two-Party Consent)
import { createFaceRecognition } from './lib/media-intelligence/face-recognition';
const faces = createFaceRecognition();
// Step 1: Uploader grants consent
await faces.grantUploaderConsent(recognitionId, uploaderId);
// Step 2: Person in photo grants consent
await faces.grantPersonConsent(recognitionId, storytellerId, personId, canBePublic);
// Only after BOTH consents can identity be linked
Content Hub API Reference
| Endpoint |
Method |
Description |
/api/v1/content-hub/stories |
GET |
List published stories |
/api/v1/content-hub/stories/:id |
GET |
Single story with full content |
/api/v1/content-hub/articles |
GET |
List published articles |
/api/v1/content-hub/articles/:slug |
GET |
Single article by slug |
/api/v1/content-hub/media/library |
GET |
Browse media library |
/api/v1/content-hub/themes |
GET |
Discover content by themes |
/api/v1/content-hub/search |
GET |
Full-text search |
/api/v1/content-hub/syndicate |
POST |
Register syndication |
Content Hub File References
| Need |
Reference |
| Database migration |
empathy-ledger-v2/supabase/migrations/20260109000001_content_hub_schema.sql |
| Photo analyzer |
references/photo-analyzer.ts |
| Face recognition |
references/face-recognition.ts |
| Theme extractor |
references/theme-extractor.ts |
| Syndication API |
references/content-syndication-api.ts |
When to Use
- Creating social media content from project milestones
- Generating posts from Ralph PRD completions
- Publishing approved content to social platforms
- Checking content sync status
- Generating content ideas from ecosystem activity
Quick Commands
| Command |
Description |
generate <topic> |
Create draft post from ecosystem knowledge |
sync |
Sync all sources (Notion + Empathy Ledger) to GHL |
sync --notion-only |
Sync only Notion content to GHL |
sync --empathy-only |
Sync only Empathy Ledger content to GHL |
status |
Check publishing pipeline status |
schedule <date> |
Schedule content for specific date |
ideas |
Generate post ideas from recent activity |
Content Flow
┌─────────────────────────────────────────────────────┐
│ 1. CONTENT SOURCES │
│ • Ralph PRD completions → auto-generate posts │
│ • Sprint milestones → project updates │
│ • Codebase commits → technical insights │
│ • Brand alignment skill → voice/tone check │
│ • Empathy Ledger articles & stories (NEW) │
└─────────────────────┬───────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ 2A. NOTION CONTENT HUB │
│ Database: e400e93e-fd9d-4a21-810c-58d67ed9fe97 │
│ │
│ Status Flow: │
│ Story in Development → Ready to Connect → │
│ Conversation Scheduled → Connected & Delighted │
└─────────────────────┬───────────────────────────────┘
│
┌─────────────────────┴───────────────────────────────┐
│ 2B. EMPATHY LEDGER CONTENT HUB │
│ URL: EMPATHY_LEDGER_URL (default: localhost:3000) │
│ │
│ Status Flow: │
│ Draft → In Review → Elder Review → Published │
│ │
│ Article Types: │
│ • story_feature, program_spotlight │
│ • research_summary, community_news │
│ • editorial, impact_report │
│ │
│ Stories with syndication_enabled = true │
└─────────────────────┬───────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ 3. GHL PUBLISHING │
│ Script: scripts/sync-content-to-ghl.mjs │
│ │
│ Syncs from BOTH sources automatically: │
│ • Notion "Ready to Connect" items │
│ • Empathy Ledger published articles/stories │
│ │
│ Connected Accounts: │
│ • LinkedIn (Company) - A Curious Tractor │
│ • LinkedIn (Personal) - Benjamin Knight │
│ • YouTube - A Curious Tractor │
│ • Google Business Profile │
│ • Bluesky - A Curious Tractor │
│ │
│ View engagement: GHL Dashboard → Social Planner │
└─────────────────────────────────────────────────────┘
Target Accounts
| Account |
Env Variable |
Best For |
| LinkedIn (Company) |
GHL_LINKEDIN_ACCOUNT_ID |
Professional updates, milestones |
| LinkedIn (Personal) |
GHL_LINKEDIN_PERSONAL_ID |
Personal stories, reflections |
| YouTube |
GHL_YOUTUBE_ACCOUNT_ID |
Video announcements |
| Google Business |
GHL_GBP_ACCOUNT_ID |
Local updates, events |
| Bluesky |
GHL_BLUESKY_ACCOUNT_ID |
Tech community, open source |
Content Generation
From Ralph Completions
When Ralph completes a PRD feature, auto-generate announcement:
// Read ralph/progress.txt for recent completions
// Generate post using act-brand-alignment voice
// Create in Notion with "Story in Development" status
From Sprint Milestones
Query sprint tracking for completed items, generate weekly digest.
From Ecosystem Activity
Scan all 7 project codebases for:
- New releases/tags
- Significant commits
- Documentation updates
- Test coverage improvements
Publishing Commands
Sync All Sources (Notion + Empathy Ledger)
node scripts/sync-content-to-ghl.mjs
Sync Only Notion
node scripts/sync-content-to-ghl.mjs --notion-only
Sync Only Empathy Ledger
node scripts/sync-content-to-ghl.mjs --empathy-only
Dry Run (Preview)
node scripts/sync-content-to-ghl.mjs --dry-run
Check Status
node scripts/sync-content-to-ghl.mjs --status
Check GHL Posts
node scripts/check-ghl-engagement.mjs
Brand Alignment Integration
Always invoke act-brand-alignment skill before publishing to ensure:
- Farm metaphors (seeds, harvest, cultivating)
- Community ownership language
- No savior framing
- Proper voice/tone
Notion API Notes
- API Version: 2025-09-03
- Endpoint:
/data_sources/{id}/query (not /databases/)
- Create pages: Use database ID
7005d0d1-41d3-436c-9f86-526d275c2f10
- Query content: Use data source ID
e400e93e-fd9d-4a21-810c-58d67ed9fe97
Automated Content Pipeline
Full Workflow
┌─────────────────────────────────────────────────────────────┐
│ 1. AGGREGATE ECOSYSTEM KNOWLEDGE │
│ node scripts/aggregate-ecosystem-knowledge.mjs │
│ │
│ Scans: Git activity, Ralph progress, Notion sprints, │
│ Documentation updates, Deployments │
└─────────────────────┬───────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 2. GENERATE CONTENT │
│ node scripts/generate-content-from-knowledge.mjs │
│ │
│ Types: weekly-activity, feature-shipped, sprint-milestone, │
│ technical-insight, project-spotlight │
│ │
│ Output: Drafts in Notion with "Story in Development" │
└─────────────────────┬───────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 3. HUMAN REVIEW (Notion) │
│ Edit content, add images, approve │
│ Change status to "Ready to Connect" │
└─────────────────────┬───────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 4. PUBLISH │
│ node scripts/sync-content-to-ghl.mjs │
│ │
│ Auto-syncs approved content to social platforms │
└─────────────────────────────────────────────────────────────┘
Quick Commands
# Generate content drafts from ecosystem knowledge
node scripts/generate-content-from-knowledge.mjs
# Preview without creating (dry run)
node scripts/generate-content-from-knowledge.mjs --dry-run
# Generate specific type
node scripts/generate-content-from-knowledge.mjs --type weekly-activity
# Sync approved content to social
node scripts/sync-content-to-ghl.mjs
# Check status
node scripts/sync-content-to-ghl.mjs --status
# Ralph content runner (combines all)
./ralph/ralph-content.sh
Content Types
| Type |
Description |
Best Accounts |
weekly-activity |
Ecosystem commit summary |
LinkedIn (Company) |
feature-shipped |
Ralph completion announcement |
Both LinkedIn |
sprint-milestone |
Sprint progress update |
LinkedIn (Company) |
technical-insight |
Technical learnings |
LinkedIn (Personal) |
project-spotlight |
Project deep dive |
Both LinkedIn |
Automated Schedule (GitHub Actions)
| Schedule |
Action |
| Sunday 10pm UTC (Monday 8am AEST) |
Generate weekly content |
| Every 4 hours |
Sync approved content to GHL |
Trigger manually: Actions → Content Pipeline → Run workflow
Media Handling
Media Service
import { createMediaService } from './scripts/lib/media-service.mjs';
const media = createMediaService();
// Get brand asset
const logoUrl = media.getBrandAsset('logo');
// Get project hero image
const heroUrl = media.getProjectAsset('JusticeHub');
// Upload local file
const result = await media.uploadFile('./image.png');
// Suggest image from content
const suggestion = media.suggestImage('Building ecosystem together');
Media Storage
- Supabase:
tednluwflfhxyucgwigh.supabase.co/storage/v1/object/public/content-media/
- Brand assets:
brand/ folder
- Project assets:
projects/ folder
- Uploads:
uploads/ folder
Image Recommendations
Content generation auto-suggests images:
- Project mentions → Project hero image
- Growth/seeds keywords → Pattern asset
- Community keywords → Cockatoo asset
- Default → ACT logo
For custom images:
- Upload to Supabase storage
- Add URL to Notion "Image" field or "Notes"
- GHL will use the URL when publishing
File References
| Need |
Reference |
| Content generation |
scripts/generate-content-from-knowledge.mjs |
| Knowledge aggregator |
scripts/aggregate-ecosystem-knowledge.mjs |
| Media service |
scripts/lib/media-service.mjs |
| Sync script |
scripts/sync-content-to-ghl.mjs |
| GHL social service |
scripts/lib/ghl-social-service.mjs |
| Empathy Ledger service |
scripts/lib/empathy-ledger-content.mjs |
| Content PRD template |
ralph/content-prd-template.json |
| Ralph content runner |
ralph/ralph-content.sh |
| GitHub Action |
.github/workflows/content-pipeline.yml |
| Notion database IDs |
config/notion-database-ids.json |
| Post creation template |
references/post-template.mjs |
| Content ideas generator |
references/content-ideas.md |
Empathy Ledger Environment Variables
| Variable |
Description |
Default |
EMPATHY_LEDGER_URL |
Empathy Ledger API base URL |
http://localhost:3000 |
CONTENT_HUB_API_KEY |
API key for Content Hub access |
Auto-generated |
Empathy Ledger Content Fetcher API
import { createEmpathyLedgerService } from './lib/empathy-ledger-content.mjs';
const el = createEmpathyLedgerService({
baseUrl: 'https://empathyledger.com',
apiKey: process.env.CONTENT_HUB_API_KEY
});
// Get published articles
const articles = await el.getArticles({ type: 'story_feature', limit: 10 });
// Get public stories
const stories = await el.getStories({ visibility: 'public', limit: 20 });
// Get content ready for GHL sync
const content = await el.getContentForGHLSync();
// Returns: { articles: [...], stories: [...], total: N }
// Transform to GHL post format
const ghlPost = el.articleToGHLPost(article, { accountIds: [...] });
// Register syndication
await el.registerSyndication({
contentType: 'article',
contentId: article.id,
destinationType: 'ghl_social',
ghlPostId: 'xxx'
});
// Health check
const health = await el.healthCheck();
// Returns: { healthy: true, baseUrl, articlesAvailable }
diegosouzapw