tractatus/docs/outreach/QUICK-REFERENCE-SOCIAL-MEDIA.md

# Social Media & HF Space - Quick Reference

**Quick commands for common maintenance tasks**

---

## 🚀 Update Hugging Face Space (Weekly)

```bash
# 1. Export fresh audit data
cd /home/theflow/projects/tractatus
node scripts/export-hf-audit-data.js

# 2. Check statistics
python3 -c "
import json
with open('./audit-decisions.json') as f:
    data = json.load(f)
coordinated = sum(1 for d in data if len(d.get('coordination', [])) > 0)
print(f'Total: {len(data)}, Coordinated: {coordinated}, Rate: {coordinated/len(data)*100:.1f}%')
"

# 3. Deploy to HF Space
cp ./audit-decisions.json ~/audit-log-viewer/
cd ~/audit-log-viewer
git add audit-decisions.json
git commit -m "chore: weekly audit data update ($(date +%Y-%m-%d))"
git push
```

---

## 📱 Reddit - Daily Engagement

**Target:** Comment on 1-2 posts per day in r/AI_Agents

**Look for:**
- Questions about AI governance
- Agent architecture discussions
- Production deployment challenges

**Comment Template:**
```
[Helpful answer to their question]

[If relevant: The Tractatus Framework handles this through [specific feature].
Documentation: https://agenticgovernance.digital/architecture.html#[section]]

[Optional: Would be interested in your thoughts on [related topic].]
```

---

## 📘 Facebook - Weekly Posts

**Post Schedule:** Every Monday

**Template:**
```
🤖 Tractatus Framework Update - [Date]

[1-2 paragraph summary of recent work]

Key improvements:
• [Feature 1]
• [Feature 2]
• [Feature 3]

🔗 Learn more: https://agenticgovernance.digital
📊 Live dashboard: https://huggingface.co/spaces/tractatus-framework/audit-log-viewer

#AIGovernance #AgenticSystems #OpenSource
```

---

## 🔍 Check Coordination Tracking

```bash
# Quick check - last 5 decisions
mongosh tractatus_dev --eval '
  db.auditLogs.find(
    {},
    {_id:0, timestamp:1, service:1, "metadata.services_involved":1}
  ).sort({timestamp: -1}).limit(5)
'

# Coordination rate - today
mongosh tractatus_dev --eval '
  var today = new Date();
  today.setHours(0,0,0,0);
  var total = db.auditLogs.countDocuments({timestamp: {$gte: today}});
  var coordinated = db.auditLogs.countDocuments({
    timestamp: {$gte: today},
    "metadata.services_involved.1": {$exists: true}
  });
  print("Today: " + coordinated + "/" + total + " = " + (coordinated/total*100).toFixed(1) + "%");
'
```

---

## 🐛 Troubleshooting

**Reddit post removed?**
```bash
# Build karma first - comment on 3-5 posts
# Wait 24-48 hours between link posts
# Message r/AI_Agents mods if persistent
```

**HF Space not updating?**
```bash
# Check if commit pushed
cd ~/audit-log-viewer && git log -1

# View HF build logs
open https://huggingface.co/spaces/tractatus-framework/audit-log-viewer/logs

# Force browser cache refresh: Ctrl+Shift+R
```

**Coordination tracking stopped?**
```bash
# Verify hook configured
cat .claude/settings.local.json | grep -A 3 "framework-audit-hook"

# Test hook manually
echo '{"session_id":"test","tool_name":"Edit","tool_input":{"file_path":"test.txt"}}' | \
  .claude/hooks/framework-audit-hook.js

# Check for recent coordinated decisions
mongosh tractatus_dev --eval '
  db.auditLogs.findOne(
    {"metadata.services_involved": {$ne: []}},
    {timestamp:1, "metadata.services_involved":1}
  )
'
```

---

## 📊 Performance Metrics

**Check Reddit engagement:**
- Account: https://reddit.com/u/tractatus-framework
- Target: 10+ comment karma before major posts
- Goal: 1 helpful comment per day

**Check HF Space views:**
- Dashboard: https://huggingface.co/spaces/tractatus-framework/audit-log-viewer
- Goal: Consistent weekly updates

**Check coordination rate:**
- Current: 1.7% (66/3942 decisions)
- Target: 10-20% (as usage grows)
- Trend: Monitor monthly

---

## 📞 Quick Contacts

- **HF Token:** [Secure - not in repos]
- **Reddit:** u/tractatus-framework
- **Facebook:** Agentic Governance NZ
- **Substack:** ridingthetiger.substack.com/chat
- **GitHub:** github.com/tractatus-framework

---

**Full Documentation:** `docs/outreach/SOCIAL-MEDIA-AND-HF-MAINTENANCE.md`