{
  "schema": "leumas.docs.page/1",
  "id": "adapter:domain/social-scheduler",
  "slug": "adapters/domain/social-scheduler",
  "kind": "capabilities",
  "bucket": "package",
  "title": "social-scheduler",
  "name": "Social Scheduler",
  "eyebrow": null,
  "chip": null,
  "summary": "Social-media posting-schedule & content-calendar intelligence microservice: return platform-specific best-time-to-post slots (Instagram, Facebook, X/Twitter, LinkedIn, TikTok, YouTube, Pinterest...",
  "keywords": [
    "social-scheduler",
    "content-calendar",
    "best-time-to-post",
    "dated",
    "datetimes",
    "under-posting",
    "awareness",
    "posting-cadence"
  ],
  "audience": "both",
  "funnel": {
    "product": null,
    "cta": null
  },
  "body": "# social-scheduler\n\nA social-media posting-cadence & content-calendar intelligence microservice. **Pure deterministic\nheuristics** driven by platform best-practice tables — no network, no model, fully offline and\nreproducible. Every result is a plain JSON object.\n\n## Tools\n\n| Tool | Args | What it does |\n|---|---|---|\n| `bestTimes` | `{ platform, count?, timezone? }` | Ranked best-time-to-post slots + best weekdays for a platform (instagram, facebook, twitter/x, linkedin, tiktok, youtube, pinterest, threads), each with a strength weight and daypart. |\n| `buildCalendar` | `{ posts, cadence?, start?, postsPerWeek?, timezone? }` | Lays a list of posts onto dated calendar entries by cadence (`daily`, `weekdays`, `everyOtherDay`, `weekly`, `3xWeek`, `2xWeek`, or a number/week). |\n| `cadencePlan` | `{ platform, goal?, count?, postsPerWeek? }` | Recommends a weekly posting cadence for a platform + goal, spread over N weeks across the platform's best days. |\n| `spacingCheck` | `{ datetimes, platform? }` | Analyzes an array of planned post datetimes for clustering (too close), over/under-posting vs the platform's healthy rate, and evenness (coefficient of variation). |\n| `frequencyByGoal` | `{ goal, platform? }` | Maps a marketing goal (awareness, engagement, growth, sales, community) to a recommended posts-per-week per platform, with a healthy range. |\n\n## Example\n\n```js\nimport pack from './index.js';\npack.adapters.bestTimes({ platform: 'linkedin', count: 3 });\npack.adapters.buildCalendar({ posts: ['Launch teaser', 'Feature deep-dive', 'Customer story'], cadence: '3xWeek', start: '2026-08-03' });\npack.adapters.frequencyByGoal({ goal: 'growth', platform: 'tiktok' });\npack.adapters.spacingCheck({ datetimes: ['2026-08-03T09:00Z', '2026-08-03T10:30Z', '2026-08-05T12:00Z'], platform: 'instagram' });\n```\n\n## DRY boundaries\n\n- Low-level date parsing / interval math / recurrence (`'5m'`-style parsing) → `datetime` / `ical` /\n  `cron`. This pack owns social posting-cadence **strategy** (best-time tables, calendar layout,\n  spacing analysis, goal→frequency mapping).\n- No cross-pack imports. No LLM — schedules must be exact and reproducible.\n",
  "source": {
    "path": "shared/engines/adapters/domain/social-scheduler/README.md",
    "blobSha": "",
    "commit": "",
    "committedAt": "",
    "provenance": "no-git",
    "bytes": 2377,
    "hash": "4fd4fb46398b286d01b47084030682cffcab35b8"
  },
  "urls": {
    "html": "/p/adapters/domain/social-scheduler",
    "json": "/docs/adapters/domain/social-scheduler.json",
    "md": "/docs/adapters/domain/social-scheduler.md"
  },
  "links": {
    "composes": [],
    "usedBy": [],
    "product": [],
    "howTo": [],
    "skills": []
  }
}