JITRBeats

Last updated Sep 27, 2026

Posting engines
Auto-posting across five platforms
  • Posts to Facebook Reels, Instagram Reels, YouTube Shorts, TikTok, and X.
  • One central clip selector feeds all five — priorities set once, propagate everywhere.
  • Each platform tuned to its own cadence; X auto-announces after every YouTube upload.
Human-feeling post variety
  • Captions drawn from two pools: branded lyric lines and a 161-line commentary set.
  • Hashtag counts vary 0–15 per post; timing jitters up to 45 minutes off schedule.
  • No two posts share the same shape — the feed reads human because it isn't uniform.
Slot-filling supply management
  • Each platform keeps a rolling buffer of pre-scored clips so posters never stall.
  • Refillers pick the next clip and stage it the moment a slot is consumed.
  • Slots live on Google Drive with checksum verification against partial moves.
TikTok manual-post queue
  • Six clips staged daily in Google Drive slots until TikTok's API approves auto-posting.
  • Same selector, scoring, and caption logic as every other platform.
  • A human taps Post in the TikTok app; everything upstream is automated.
Platform token refresh
  • Meta and Dropbox tokens refresh themselves before expiry.
  • Old credentials swap out only after the new ones are validated live.
  • All secrets live in macOS Keychain — never in logs or environment dumps.
Posting integrity reporting
  • - Daily per-platform reports: posts shipped, failures, posting volume vs. configured targets. - Color-coded GREEN / YELLOW / RED with explicit intervention flags. - Compares observed posting against per-platform daily targets. ---
Video / creatives library management
Canonical clip naming
  • Every filename encodes pool, content hash, and current effectiveness score.
  • Hash is permanent; score updates nightly from engagement deltas.
  • Every downstream program reads meaning from the filename — no database needed.
Age-aware clip rotation
  • +30% boost at 30 days; -10% decay at 1 year.
  • Stateless milestone pass — missed runs catch themselves up automatically.
  • Library never calcifies around a handful of perennial posts.
Library hygiene
  • SHA-256 deduper quarantines true content duplicates.
  • Durationer splits long clips into platform-native chunks with inherited names.
  • Canonical-naming enforcer + 90-day log trim keep the library structurally clean.
Video pipeline runway
  • Inventory Runway: days of max-posting the ready-to-post folder can sustain.
  • Pipeline Runway: days of future capacity the raw-footage feeder can generate.
  • Conversion Ratio: whether editing velocity is outpacing consumption or falling behind.
Video transcription + content classification
  • - Speech-to-text on raw and posted videos for downstream caption + tagging. - Rock-vs-talk classification routes interview-style clips to their own pool. - Output drives content-mix decisions in the selector. ---
Engagement scoring & weighted selection
Engagement-based re-ranking
  • Platform scorers (Facebook, Instagram, YouTube, TikTok) read live likes, comments, and views.
  • Each post compared to the account's own 30-day rolling average — ratio-based, not fixed thresholds.
  • Re-scored clips automatically promote or demote in the rotation.
Queue-backed weighted pool selection
  • Posters pull from a pre-filled queue stocked to honor active pool weights.
  • One weight change in config flows through every platform on the next fill.
  • Daily ledger audits actual picks vs. configured weights to catch drift.
Underperformer detection
  • - Old posts whose engagement has decayed below the rolling average get flagged. - Manual cleanup workflow: review the flagged list, retire or refresh. - Surfaces opportunities to re-test creatives that may have aged out. ---
Marketing & advertisement
Meta paid-ads tracking
  • Daily report on spend, impressions, clicks, and CTR across the active Meta ad set.
  • Cost-per-follower calculation against the configured target band.
  • Surfaces underperforming creatives so the operator can pause or rotate.
Email-list build-out (Brevo)
  • Daily snapshot of fan-signup list growth and welcome-sequence engagement.
  • Industry-prospecting list tracked separately with contacts + send-credit balance.
  • Email-list-verification credit watchdog flags low balances before sends fail.
Meta lead-form → email list
  • - Captures Meta lead-form submissions and imports them into the Brevo fan-signup list. - One automated path from paid social to addressable email audience. ---
Accounting & billing
Internal expense generation
  • Monthly pass estimates labor hours across IT, sound, video, artist support, marketing.
  • Sessionization rules + per-category hourly rates produce a canonical CSV ledger.
  • Automated CSV ledgers — no third-party platform — fully auditable.
Monthly client billing (in development)
  • Outcome-based rules build itemized monthly invoices.
  • Single billing-face model: contractors bill the operator, the operator re-bills the client as pass-through.
  • DEV until rules validate against historical data; then promotes to PROD.
Historical billing reconstruction (in development)
  • Reconstructs month-by-month client charges under current rules.
  • Useful for audit, reconciliation, and catching old-vs-new pricing differences.
  • Reads the same monthly data as the live billing pipeline.
Monthly narrative builder (in development)
  • Plain-text and Word output chronicling each month's creative output.
  • Organized by song project and media type (audio, video, images, documents).
  • DEV; client-facing framing under refinement ahead of PROD.
Activity collector
  • - Detects filesystem activity for a target month and writes one neutral monthly CSV. - Upstream of billing and monthly narratives — neither owns its own collection. ---
Reporting, dashboards, alerting
Live ops dashboard
  • Single-screen view of posting counts, engagement activity, and reporter status.
  • Mobile-first HTML, regenerated every two hours, redeployed to Cloudflare.
  • One tap from the iPhone home screen; rich link-preview card when shared.
Artist dashboard
  • Same underlying data as the ops dashboard, articulated for the artist.
  • Leads with engagement standouts and 24h / 7d posting totals.
  • Drops the operator noise — no reporter-staleness alerts, no token warnings.
Daily email push
  • Short plain-text emails twice daily (6 AM and 4 PM ops; morning-only artist).
  • Each email is the push; the hosted dashboard is the content.
  • Replaces a 42 KB legacy text-dump with a tappable link to the live page.
Spotlight — production-flow visibility
  • Watches the music-production pipeline (idea → demo → mix → premaster → master → release).
  • Reports the bottleneck stage in plain English with a clear take-away.
  • Daily song-journey ledger captures each milestone date for lead-time analysis.
Product and roadmap site
  • Public, always-current feature list and forward roadmap for the software.
  • Features curated in a manifest; roadmap auto-extracted from per-program files.
  • "New" / "Updated" badges flag tiles whose programs moved in the last 30 days.
Self-healing responder
  • First-pass automated response to known outage classes.
  • Opens durable tickets that survive until worked or auto-resolved.
  • Reduces the number of overnight alerts that need a human at all.
Push alerts
  • - Posting failures and silent-reporter events trigger immediate notifications. - Routes to the operator (system alerts) or to the artist team (engagement standouts). ---
Multi-client framework
Per-client configuration
  • Each client's variables (API tokens, IDs, file paths) live in their own config file.
  • Adding a new client is a config change, not a code change.
  • Shared programs read whichever client config they're invoked against.
Roadmap

Where the system is going next.

Selected open items, opted in by their authoring chat.

Each chat that owns a JITRBeats program also owns a roadmap file. Items opt in to this public list with a **Public:** yes flag. Everything else stays internal.

No publicly-opted-in roadmap items yet.
By the numbers

JITRBeats — Stats

Program count and lines of code, refreshed weekly.

The categories below count programs by their function (selectors, posters, reporters, etc.). Development and Production layers are tracked separately so the dev-to-prod ratio is visible.

DEV programs
Selectors8
Posters11
Reporters51
Scoring16
Grooming11
Resizing5
Refillers1
Analytics33
Billing55
Plumbing20
Other169
PROD programs
Selectors8
Posters7
Reporters44
Scoring11
Grooming11
Resizing4
Analytics24
Billing29
Plumbing10
Other134
LayerProgramsLOCAvg LOC / program
Development380163,311430
Production282134,680478
Total662297,991450
As of Sep 27, 2026
JITRBeats · generated automatically from the codebase · 30 active capabilities, 793 roadmap items.