hype-launch 0.2.0__tar.gz

hype_launch-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Type check
+        run: uv run mypy hype/
+
+      - name: Test
+        run: uv run pytest

hype_launch-0.2.0/.gitignore

@@ -0,0 +1,12 @@
+*.pyc
+__pycache__/
+.env
+*.sqlite
+.DS_Store
+dist/
+node_modules/
+.coverage
+htmlcov/
+.pytest_cache/
+.claude/
+.superset/

hype_launch-0.2.0/CHANGELOG.md

@@ -0,0 +1,128 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.0] - 2026-04-08
+
+### Added
+
+Anti-AI-slop pipeline (this release's headline change):
+
+- `hype/humanity.py`: pure regex/heuristic scorer (no LLM calls). Scores
+  text 0-100 across five signals. AI phrases (38-pattern banlist
+  including `delve`, `leverage`, `robust`, `tapestry`, `cutting-edge`,
+  `battle-tested`, `next-gen`, `not just X but Y`), vague words (29
+  corporate fillers), passive voice ratio, conversational signals
+  (contractions, questions, first person, parenthetical asides), and
+  specificity signals (percentages, currency, years, version numbers,
+  named sources, quotes). Exposes `WARN_THRESHOLD=70`,
+  `BLOCK_THRESHOLD=50`, `is_warned()`, `is_blocked()`. Em-dash density
+  reported as informational signal.
+- `hype/scrubber.py`: text transformer. Strips invisible unicode
+  watermarks (zero-width space, joiner, BOM, soft hyphen). Rewrites
+  em-dashes to contextual punctuation (semicolon before conjunctive
+  adverbs like "however", period after sentence-ending punctuation,
+  comma otherwise). Normalizes whitespace (collapse multiple spaces,
+  cap blank lines at 2, trim trailing whitespace).
+- `hype.copy._parse_variants()` now scrubs every generated variant
+  through `scrub_text()` and scores it through `humanity.score_text()`
+  before constructing the `CopyVariant`. Score, breakdown, and scrub
+  stats are attached to the variant for the review UI.
+- `CopyVariant` gains `humanity_score`, `humanity_breakdown`,
+  `scrub_stats`, `is_slop_blocked`, `is_slop_warned` fields.
+- `CopyResult.best` now picks the variant with the highest humanity
+  score among scored variants, falling back to `variants[0]` for
+  short content (under 50 words) where no humanity score is computed.
+- `hype.copy.generate_hn_first_comment()`: author's first reply on a
+  Show HN submission, hard-capped at 250 words. Previously users had
+  to write this by hand.
+- `hype.copy.generate_x_thread()`: 3-5 tweet thread variant with
+  per-tweet character cap. Previously users got a single hook and
+  built the thread themselves.
+
+Other features (carried forward from previously-unreleased work):
+
+- `hype launch update`: release announcement command for X, Bluesky,
+  Reddit, and Dev.to with preflight, AI copy generation, and scored
+  review.
+- `hype launch minor`: lightweight feature-drop command for X +
+  Bluesky only; auto-picks best variant without interactive review.
+- `hype launch press`: generates `press-release.md` and
+  `outreach-template.md` via Claude from your project brief.
+- `hype launch resume --execute`: executor engine that dispatches to
+  platform adapters (X, Bluesky, Reddit, Dev.to auto; HN, PH manual
+  with confirm prompt), with timed scheduling and state persistence
+  after each step.
+- `hype launch resume --one`: execute a single step then stop, for
+  step-by-step manual control.
+- `hype config set <key> <value>`: set any config value via dotted
+  key path (e.g. `platforms.x.api_key`); creates section if missing,
+  redacts secrets in output.
+- `launch.toml.example`: fully documented example with all supported
+  fields.
+- `subreddit` field on `LaunchState` for Reddit post targeting during
+  execution.
+- Multi-pass positioning analysis in `signal research` (competitive
+  landscape, audience profile, positioning angles, per-platform
+  messaging hooks, and a draft of `launch.toml` hints).
+
+### Changed
+
+- `_SYSTEM_PROMPT` in `hype.copy` rewritten as a hard-rules block.
+  Lists 35+ banned words and phrases. Prohibits em-dashes outright.
+  Bans hedging phrases (`perhaps`, `might`, `could potentially`).
+  Bans no-information openers (`Great question!`, `Let me explain`).
+  Bans transition words at paragraph starts (`Moreover`, `Furthermore`,
+  `In conclusion`). Bakes slop prevention into generation rather than
+  relying solely on post-hoc detection.
+- All `generate_*` prompts gain explicit hard length caps:
+  Reddit body 100-200 words (was uncapped),
+  Dev.to article 600-900 words (was 1000-1500),
+  PH first comment 150-250 words (was ~300),
+  HN first comment <= 250 words (new function with cap from inception),
+  HN title 50-80 chars,
+  X tweet <= 280 chars / 0-2 hashtags / 0-emoji target,
+  Bluesky <= 300 chars / 0 hashtags.
+- `CopyResult.best` semantics: was "first variant"; now "highest-
+  humanity scored variant, falling back to first if no scores".
+- `hype launch resume` now executes pending steps by default (use
+  `--no-execute` for view-only mode, preserving old behavior).
+- `signal research` now defaults to running the positioning analysis
+  on top of the raw HN/Reddit/X sweep; pass `--no-positioning` for
+  raw-only behavior.
+
+### Tests
+
+- 24 new humanity scorer tests, 18 new scrubber tests, 12 new copy
+  integration tests covering the scrub-on-parse, score-on-parse, and
+  best-by-humanity behaviors.
+- Full suite: **487 tests, 99.28% coverage** (above the 95% gate).
+
+## [0.1.0] - 2026-04-07
+
+### Added
+- `hype launch new` — full launch orchestrator with preflight, AI copy generation, scored review, and timed sequence
+- `--platforms` filter on `hype launch new` for partial/single-platform launches
+- `hype launch resume` — resume interrupted launch sequences from saved state
+- `hype signal research` — concurrent topic research across HN, Reddit, and X via Claude synthesis
+- `hype signal listen` — post-launch brand monitoring with alert callbacks
+- `hype preflight` — credential and timing validation before launch
+- `hype config init` — interactive credential wizard with progressive disclosure
+- `hype config show` / `hype config validate` — config inspection and validation
+- Scoring layer: fast local scorers for HN titles (7 signals) and X hooks (9 signals)
+- Copy review UI: per-variant score badges, signal breakdown, user picker
+- Launch sequencer with 24-hour blitz schedule and JSON state persistence
+- Platform adapters: X (inline OAuth 1.0a), Reddit (PRAW), Bluesky (atproto), Dev.to (httpx)
+- Optional dependency extras: `hype[ai]`, `hype[reddit]`, `hype[bluesky]`, `hype[all]`
+- X preflight: billing cost notice (~$0.01/post since Feb 2026 API change)
+- X platform: HTTP 402 detection with clear billing error message
+- Reddit preflight: OAuth app approval warning (manual review required)
+- GitHub Actions CI: Python 3.12/3.13 matrix, ruff + pytest with 95% coverage floor
+
+[Unreleased]: https://github.com/DjinnFoundry/hype/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/DjinnFoundry/hype/releases/tag/v0.1.0

hype_launch-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DjinnFoundry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hype_launch-0.2.0/PKG-INFO

@@ -0,0 +1,379 @@
+Metadata-Version: 2.4
+Name: hype-launch
+Version: 0.2.0
+Summary: Announce your OSS project like you know what you're doing
+Author: DjinnFoundry
+License: MIT
+License-File: LICENSE
+Keywords: announcements,cli,devtools,launch,opensource
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Software Distribution
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.30; extra == 'ai'
+Provides-Extra: all
+Requires-Dist: anthropic>=0.30; extra == 'all'
+Requires-Dist: atproto>=0.0.50; extra == 'all'
+Requires-Dist: praw<8,>=7.7; extra == 'all'
+Provides-Extra: bluesky
+Requires-Dist: atproto>=0.0.50; extra == 'bluesky'
+Provides-Extra: dev
+Requires-Dist: anthropic>=0.30; extra == 'dev'
+Requires-Dist: atproto>=0.0.50; extra == 'dev'
+Requires-Dist: mypy>=1.9; extra == 'dev'
+Requires-Dist: praw<8,>=7.7; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: reddit
+Requires-Dist: praw<8,>=7.7; extra == 'reddit'
+Description-Content-Type: text/markdown
+
+```
+ ██╗  ██╗██╗   ██╗██████╗ ███████╗
+ ██║  ██║╚██╗ ██╔╝██╔══██╗██╔════╝
+ ███████║ ╚████╔╝ ██████╔╝█████╗
+ ██╔══██║  ╚██╔╝  ██╔═══╝ ██╔══╝
+ ██║  ██║   ██║   ██║     ███████╗
+ ╚═╝  ╚═╝   ╚═╝   ╚═╝     ╚══════╝
+```
+
+### announce your OSS project like you know what you're doing
+
+Launching OSS is a 14-hour day of copy-pasting into HN, Reddit, X, Bluesky, Dev.to, and Product Hunt — half of which you'll get wrong, half of which you'll mistime, and one of which will get you shadowbanned. `hype` is a CLI that runs the coordinated 24-hour blitz from a single `launch.toml`: it generates platform-specific copy with Claude, scores it before posting, runs pre-flight checks against your accounts, and executes the timed sequence so you can sit back and watch the spike. Then it listens for the spike.
+
+[![build](https://img.shields.io/badge/build-passing-success)](https://github.com/djinnfoundry/hype/actions)
+[![coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)](https://github.com/djinnfoundry/hype)
+[![pypi](https://img.shields.io/badge/pypi-v0.2.0-blue)](https://pypi.org/project/hype-launch/)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![python](https://img.shields.io/badge/python-3.12+-yellow)](https://www.python.org/)
+
+---
+
+## Demo
+
+```console
+$ hype launch new --schedule auto
+
+  hype v0.2.0 — coordinated launch sequencer
+  project: hype
+  mode:    new
+  brief:   ./launch.toml
+
+  ▶ pre-flight ───────────────────────────────────────────────
+  [PASS]  X            account active, write scope confirmed
+  [PASS]  Reddit       847d old, 2,341 karma — eligible for all subs
+  [WARN]  Reddit       r/programming karma 2,341 < recommended 5,000
+  [PASS]  HN           account karma 1,204
+  [PASS]  Bluesky      handle resolved
+  [PASS]  Dev.to       API key valid
+  [PASS]  Timing       Sun 11:14 UTC — low-competition HN window
+  [PASS]  Content      HN title 82/100, X hook 87/100
+
+  Continue with 1 warning? [y/N] y
+
+  ▶ copy generation (claude-sonnet-4-6) ─────────────────────
+    18 completions · 3 variants each · 9.2s · $0.31
+
+  ▶ scheduled sequence ──────────────────────────────────────
+    12:01 AM PT  →  Product Hunt    (guided)
+    12:30 AM PT  →  X thread        (auto)
+     1:00 AM PT  →  Show HN         (guided)
+     3:00 AM PT  →  Bluesky         (auto)
+     6:00 AM PT  →  Reddit wave 1   (auto, 60s stagger)
+     2:00 PM PT  →  Reddit wave 2   (auto, 60s stagger)
+     6:00 PM PT  →  Dev.to          (auto)
+
+  Proceed? [y/N] y
+```
+
+---
+
+## Features
+
+- **Coordinated blitz** — one `launch.toml`, six platforms, one tightly-timed sequence. Scatter-posting is strictly worse than the spike.
+- **Pre-flight layer** — account health, karma age, rate-limit windows, timing window, content scoring. Catches the failure before it costs you a launch.
+- **AI copy generation** — Claude turns your project brief into platform-specific copy: HN titles (3 scored variants), Reddit posts (per-subreddit framing, never identical), X threads, Bluesky, Dev.to articles, PH listings.
+- **Content scoring** — HN title scorer (specificity, hype-word penalty, corpus similarity vs top-100 Show HNs). X hook scorer (9 signals: hook strength, link placement, hashtag count, CTA clarity).
+- **Anti-AI-slop pipeline** — every generated variant is scrubbed (em-dashes rewritten to commas/semicolons, invisible unicode watermarks stripped) and scored against a 38-pattern AI banlist (`delve`, `leverage`, `robust`, `tapestry`, `not just X but Y`, etc.) plus passive-voice, vague-word, conversational, and specificity signals. Variants below the WARN threshold (70/100) flag in the review UI; below BLOCK (50/100) the review refuses to ship them. `CopyResult.best` picks the highest-humanity variant instead of trusting the LLM's stated order.
+- **signal listen** — post-launch monitoring across HN Algolia, Reddit PRAW, and X. Alerts on point velocity, comment surges, notable mentions. Terminal bell, desktop notification, JSONL log.
+- **signal research** — pre-launch positioning workflow. Pulls 30/60/90-day corpus from HN, Reddit, X, then runs a multi-pass Claude pipeline that returns a competitive landscape, audience profile, positioning angles, per-platform messaging hooks, and a draft of `launch.toml` hints. Pass `--no-positioning` for raw signal only.
+- **Launch executor** — `hype launch resume` dispatches to platform adapters automatically (X, Bluesky, Reddit, Dev.to) and prompts for manual platforms (HN, Product Hunt). Timed scheduling sleeps until each step is due. `--one` for step-by-step control.
+- **Resumable sequences** — Ctrl-C anytime, `hype launch resume` picks up where you left off. State saved after every step.
+- **Press materials** — `hype launch press` generates a `press-release.md` and `outreach-template.md` from your project brief via Claude.
+- **Config mutation** — `hype config set platforms.x.api_key <value>` sets any config value via dotted key path. Creates sections if missing, redacts secrets in output.
+
+---
+
+## Install
+
+```bash
+pip install hype-launch
+```
+
+Or with `uv` (recommended):
+
+```bash
+uv tool install hype-launch
+```
+
+Then:
+
+```bash
+hype config init        # interactive credential wizard
+hype config validate    # confirm everything works
+hype config set platforms.x.api_key "your-key"  # or set individual values
+```
+
+---
+
+## Quick start
+
+```bash
+# 1. install
+uv tool install hype-launch
+
+# 2. set up credentials (one-time, per machine)
+hype config init
+
+# 3. drop a launch.toml in your project repo
+cd ~/src/myproject
+hype config edit launch.toml      # writes a starter file
+
+# 4. dry run the whole thing
+hype launch new --dry-run
+
+# 5. ship it
+hype launch new --schedule auto
+```
+
+That's the complete loop.
+
+---
+
+## Platform support
+
+| Platform     | Read              | Write                        | Automation     | Notes |
+| ------------ | ----------------- | ---------------------------- | -------------- | ----- |
+| X / Twitter  | x-reader          | OAuth 1.0a                   | full auto      | ~$0.01/post (pay-per-use since Feb 2026) |
+| Reddit       | PRAW              | PRAW                         | full auto      | OAuth app approval required (1-3 days) |
+| Hacker News  | Algolia           | clipboard + browser (manual) | guided         | Bots banned — hype copies title and opens submit page |
+| Bluesky      | AT Protocol       | AT Protocol                  | full auto      | |
+| Dev.to       | REST              | REST                         | full auto      | |
+| Product Hunt | GraphQL           | browser (you fill the form)  | guided         | |
+| Lobste.rs    | none              | none                         | manual + copy  | |
+
+Full automation where the platform allows it. Guided submission where it doesn't — HN bans automated posting, so hype copies your title to clipboard and opens the submit page in your browser.
+
+---
+
+## `hype signal`
+
+### Research a topic before launch
+
+```bash
+hype signal research "rust tui frameworks"
+hype signal research "OSS launch strategy" --days 90 --depth deep
+hype signal research "bun vs node" --platforms hn,reddit --output ./research.md
+hype signal research "rust tui frameworks" --no-positioning   # raw only
+```
+
+`signal research` is now a positioning workflow, not just raw signal collection. After the concurrent HN/Reddit/X sweep, it runs a multi-pass Claude pipeline that produces a structured strategy report:
+
+- **Summary, sentiment, top concerns, opportunities** — Pass 1, the original synthesis.
+- **Competitive landscape** — named alternatives mentioned in the corpus, with strengths/weaknesses and rough mention counts.
+- **Audience profile** — per-platform experience level, stack, motivations, and language style.
+- **Positioning angles** — 2-4 sharp angles that exploit the gaps in the competitive landscape, each with evidence and a risk note.
+- **Per-platform messaging hooks** — concrete one-liner examples for HN, Reddit, X, and Bluesky, plus what to avoid.
+- **Suggested `launch.toml` hints** — tagline options, problem/solution statements, a differentiator, and target subreddits you can paste straight into your `launch.toml`.
+
+Strategy sections render before the raw post lists so you read conclusions first. Pass `--no-positioning` if you only want the raw signal sweep.
+
+### Listen to your launch in real time
+
+```bash
+hype signal listen "hype" --hn-id 43789012 --notify
+hype signal listen "hype" --log ./launch-events.jsonl &
+```
+
+```console
+[HN]      item/43789012  43 pts / 12 comments  rank ~#24  +7 pts  ← SPIKE
+[Reddit]  r/rust          89 pts / 23 comments  +12 pts  ← SPIKE
+          New comment (user_foo): "How does this compare to..."
+[X]       14 mentions since launch  +3 new  ← SPIKE
+          Notable: @importantdev (12k followers): "Just tried hype..."
+```
+
+Alerts on: point velocity, comment surges, controversy ratios (`comments > points` is a death spiral), milestones (100/200/500 points), notable mentions from accounts >5k followers.
+
+---
+
+## `hype launch`
+
+Four modes for four levels of "is this a real launch":
+
+| Mode             | Default platforms                       | Use it for                |
+| ---------------- | --------------------------------------- | ------------------------- |
+| `launch new`     | PH, HN, Reddit (3 subs), X, Bluesky, Dev.to | Initial launch            |
+| `launch update`  | X, Bluesky, Reddit, Dev.to              | v2.0, major release       |
+| `launch minor`   | X, Bluesky                              | Quick feature drop tweet  |
+| `launch press`   | none — file output                      | Press release + outreach template |
+
+```bash
+hype launch new                                      # interactive, optimal-window auto-schedule
+hype launch new --dry-run                            # generate everything, post nothing
+hype launch new --platforms "hn,reddit:rust,x" --media demo.mp4
+hype launch new --variants 5 --no-confirm            # agent / CI mode
+
+hype launch update --version v2.0.0 --changelog CHANGELOG.md
+hype launch update --dry-run
+
+hype launch minor --note "added --json flag to all commands"
+hype launch minor --dry-run
+
+hype launch press                                    # generates press-release.md + outreach-template.md
+hype launch press --output ./press/
+
+hype launch resume                                   # execute all pending steps
+hype launch resume --one                             # execute one step then stop
+hype launch resume --no-execute                      # view status only
+```
+
+---
+
+## Pre-flight output
+
+Pre-flight runs before any post leaves your machine. Three severity levels: `BLOCK` (cannot proceed), `WARN` (confirm to proceed), `INFO` (FYI). Exit code reflects the worst outcome — wire it into CI if you're into that.
+
+```console
+$ hype preflight new
+
+  ▶ pre-flight checks ────────────────────────────────────────
+
+  [PASS]  X            credentials valid, write scope confirmed
+  [PASS]  Reddit       account 847d old, karma 2,341 — eligible
+  [WARN]  Reddit       r/programming karma 2,341 < recommended 5,000
+  [BLOCK] HN           queue has 8 posts in last 15min — wait 12 min
+  [PASS]  Bluesky      handle resolved, app password valid
+  [PASS]  Dev.to       API key valid
+  [PASS]  Timing       Sun 11:14 UTC — optimal HN low-competition window
+  [PASS]  HN title     82/100  (specificity 18/20, hype-words 15/15)
+  [PASS]  X hook       87/100  (hook 18/20, link placement 10/10)
+
+  Result: 1 BLOCK, 1 WARN, 7 PASS — cannot proceed.
+
+  exit 2
+```
+
+Exit codes: `0` all clear · `1` warnings · `2` blocking issues.
+
+---
+
+## Config — the two-file model
+
+`hype` uses two config files. One has secrets and lives on your machine. One has the brief and lives in your repo.
+
+**`~/.config/hype/config.toml`** — credentials. Never committed. One per machine. Written by `hype config init`.
+
+**`./launch.toml`** — the project brief. Committed to your repo. No secrets. Reviewable by collaborators.
+
+```toml
+[project]
+name    = "hype"
+tagline = "announce your OSS project like you know what you're doing"
+repo    = "https://github.com/djinnfoundry/hype"
+version = "0.2.0"
+license = "MIT"
+stack   = ["python", "cli", "devtools"]
+
+[project.brief]
+problem = """
+Launching OSS requires the same announcement across 10+ communities
+with different formats, timing, and norms. Most developers do it manually.
+"""
+solution = """
+hype generates platform-optimized copy from one brief, scores it before posting,
+and executes a coordinated timed sequence.
+"""
+differentiator = """
+Pre-flight layer: account health, karma, timing, content scoring checked
+before any post goes out. One brief → Claude → platform-specific copy.
+"""
+install         = "pip install hype-launch"
+personal_story  = "Built after manually posting a launch to 12 communities in one day."
+
+[launch]
+scheduled_at = "auto"
+subreddit    = "python"
+platforms    = []             # empty = all configured platforms
+```
+
+See [`launch.toml.example`](launch.toml.example) for all fields with documentation.
+
+Environment variable overrides (`HYPE_PLATFORMS__X__API_KEY=...`) for CI and agents.
+
+---
+
+## Why hype?
+
+The coordinated 24-48 hour blitz is the mechanic that makes OSS launches work. HN + GitHub release + X simultaneous, then Reddit waves through the morning — that's what creates the spike that triggers GitHub Trending, which triggers more eyes, which triggers more stars, which is the entire point.
+
+Scatter posting across different days is **strictly worse**. Posting to HN at the wrong hour is strictly worse. Forgetting to check your Reddit karma against the subreddit minimum is strictly worse. Generating identical copy for r/rust and r/programming is strictly worse — it's also a great way to get filtered.
+
+`hype` operationalizes the mechanic. It's not a social media scheduler. It's not a marketing platform. It generates no landing pages, no email sequences, no analytics dashboards. It does one thing: run the launch you would have run manually, except it actually starts on time, the copy is scored, the windows are optimal, the karma is checked, the rate limits are respected, and you get to watch it happen instead of executing it.
+
+Speed is not the goal. Quality is. Every guardrail in `hype` exists to protect you from getting flagged.
+
+---
+
+## Alternatives
+
+| Tool | What it does | What it doesn't |
+|------|-------------|----------------|
+| **Postiz** | 34-platform social scheduler, open-source | No HN, no Product Hunt, no launch orchestration |
+| **Buffer / Hootsuite** | Social media schedulers | No HN, no Reddit, no Dev.to, no developer focus |
+| **Crier** | Cross-posting CLI | No HN, no Reddit, no Product Hunt, no timing/scoring |
+
+hype's edge: launch orchestration (timing, pre-flight, scoring), HN + Product Hunt coverage, CLI-first workflow for developers.
+
+---
+
+## Contributing
+
+PRs welcome. The bar:
+
+1. Fork, branch, test (`pytest`), open PR.
+2. Ruff-clean, mypy-clean, no decrease in coverage.
+3. Behavior changes need a `CHANGELOG.md` entry.
+4. Don't add platforms that require paid APIs unless you've tested the auth flow end-to-end.
+
+Tests run on every PR. Coverage is enforced. We have zero tolerance for red tests.
+
+```bash
+git clone https://github.com/djinnfoundry/hype
+cd hype
+uv sync
+uv run pytest
+```
+
+---
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+Built by [djinnfoundry](https://github.com/djinnfoundry). `hype` launched itself with `hype`. If it couldn't, it would be broken.