Generate and deliver a Hacker News daily report (Top-N) with article summaries and multi-view comment synthesis, in user-selected language, with optional file persistence and index update.
- v0.8.2: Refresh publication for latest HN Daily Brief packaging and worker-oriented execution workflow.
v0.8.1: Tighten anti-padding controls for final write-up (ban repeated boilerplate tails, enforce anti-template validation before send).
v0.8.0: Run scheduled HN jobs in isolated cron sessions (sessionTarget=isolated, payload.kind=agentTurn) to avoid blocking main chat; keep 3-job retry ladder idempotent.
v0.7.0: Add concurrent retry profile for schedule reliability (primary run + immediate retry + delayed retry) with idempotent completion checks to avoid timeout-caused misses.
v0.6.0: Brand rename for distribution as "HN Daily Brief" + full copy cleanup to English-only wording.
v0.5.1: Language cleanup for public distribution (English-first docs; localized markers still supported).
v0.5.0: First public release.
Parameters
- language: output language (default: current user conversation language)
INLINECODE8 : whether to save file + update index (default: true)
INLINECODE9 : cron time in user timezone, or INLINECODE10
First-load behavior
- On first load (or when user changes params), show effective params once and confirm.
Otherwise, reuse last confirmed params.
Mandatory execution order
1. Retry preflight check (required for retry jobs):
- If this run is a retry/compensation run, first check whether today's report already exists and is complete (at minimum includes ## Top 10).
- If already complete, return NO_REPLY and stop (idempotent exit).
2. Always fetch fresh inputs for this run (required):
- Re-pull current HN Top-N items, article snippets, and comments at run time.
- Do not reuse previous report body as source input.
3. Collect materials via script (data collection only, never user-facing):
- scripts/generate_hn_daily.py --style <style> --top <topN> --language <language> --outdir /tmp/hn-daily-draft --materials /tmp/hn-daily-draft/HN-materials.json
- Script must only output HN-materials.json (no user-facing report body).
- Use HN-materials.json as the only source for final writing.
- Use a single strict prompt template to generate final report in selected language.
- All content quality constraints (summary depth, comment synthesis style, anti-template wording) must be enforced by prompt, not by script templates.
- No “summarize then translate”; generate directly in target language.
5. Re-check completion before send (required for retry jobs):
- If another concurrent run has already persisted a complete report, do not send duplicate content; return NO_REPLY.
6. Send full final report body to current chat.
If persist=true, write final report to <outputDir>/HN-daily-YYYY-MM-DD.md and update <outputDir>/HN_DAILY_INDEX.md.
Success criteria (strict)
- persist=false: success = full report body delivered in chat.
Under concurrent retry profile: success can be achieved by primary run or any retry run; retries must skip if the report is already complete.
If any required condition fails, treat run as failed (do not claim completion).
Output rules
- Send only report body to user (no receipts/status metadata).
Never send script draft markdown directly; user-facing report must come from LLM rewrite over materials JSON.
Output must use one language only: the selected language for the run (no bilingual/mixed-language output).
Real markdown newlines only; never output literal \n in user-visible content.
Strict source/comment separation (mandatory):
- Source summary must summarize only the original article/source content (title/url/snippet and source facts).
- Comment viewpoint synthesis must summarize only HN comments (comments_raw).
- Do not put community reactions, usernames, or comment conclusions into Source summary.
- Do not use source-only facts as a substitute for missing comment viewpoints.
- If source content is missing/blocked/too short, mark explicitly: source is short / info limited; do not fill the gap with comments.
- Top-N structure per item:
- Title
- Link
- HN link
- Heat
- Source summary
- Comment viewpoint synthesis
Length rules (by selected language)
- Default hard rule: source summary must be >=300 chars in zh (>=200 words in en; equivalent depth for others).
Elastic exception: only when source content is genuinely short/information-limited, summary may be shorter than default target.
Comment viewpoint summary target: zh>=80 chars (equivalent depth for others), with the same short-source exception.
When exception is used, explicitly mark "source is short / info limited" (or equivalent in selected language), prioritize verifiable facts + discussion context + actionable implications, and keep concise but information-dense output.
Never inflate length with generic filler text.
Hard anti-padding rule: do not append reusable stock tails (e.g., identical “this reflects ...” sentence) across viewpoints/items.
If the same tail sentence appears in 3+ comment viewpoints, the report is invalid and must be rewritten.
Platform/channel constraints must NOT reduce content quality: if a single message exceeds platform limits (e.g., Telegram 4096 chars), split into multiple sequential messages rather than compressing or shortening summaries/viewpoints to fit.
Comment synthesis rules
- Must be in selected language.
Multi-perspective (not binary pro/con).
Per item, output 5 comment viewpoints when available.
If username exists in source comment, it must be preserved in output.
Only use "insufficient comments" when no usable comments are available.
Summarize viewpoints; do not paste long raw quotes.
Scheduling rules (concurrent retry profile)
- If reminderTime != off, create/update a 3-job retry ladder automatically (no duplicates):
1) Primary run at reminderTime (e.g. HN Daily 06:50)
2) Immediate retry at reminderTime + 1m (e.g. HN Daily 06:51 Retry)
3) Delayed retry at reminderTime + 15m (e.g. HN Daily 07:05 Retry)
- All HN cron jobs must run in isolated sessions:
- sessionTarget="isolated"
- payload.kind="agentTurn"
- Never schedule HN generation on sessionTarget="main".
- Keep cron payload execution-oriented (not passive reminder), including idempotent checks and send/persist requirements.
All retry jobs must be idempotent via completion checks (see Mandatory execution order step 1 and step 5).
Keep job names aligned with schedule and retry role.
Rationale: cron has no built-in on-failure callback; this retry ladder is the required equivalent for timeout/failure recovery, and isolated execution avoids blocking normal user chat.
Prompt template requirements (must include)
- Generate directly in selected language.
Source summary length must meet selected-language threshold.
Each comment viewpoint summary must meet selected-language threshold.
Summaries must be article-specific and fact-based; avoid reusable boilerplate.
Enforce source/comment boundary explicitly in prompt:
- Source summary uses only article/source material.
- Comment viewpoints use only HN comments.
- Never mix the two sections.
- Forbid repeated generic closers in comment viewpoints; every viewpoint must end with item-specific substance, not a shared stock sentence.
Comment section must synthesize viewpoints (not raw quote dumping), with usernames when available.
Pre-send quality gate (mandatory)
- Validate final report before sending:
- zh summary default >=300 chars per item;
- zh comment viewpoint default >=80 chars per viewpoint.
- If an item/viewpoint is below default threshold, it must explicitly include a short-source marker (e.g. source is short / info limited).
If anti-padding checks fail (banned phrase repetition or repeated tail sentence), rewrite and re-check.
If gate fails, rewrite and re-check; do not send failing report.
Guardrail
- If prompt-driven LLM generation path is not available/validated, keep cron disabled until fixed.
If primary + both retries all fail on the same day, send a concise failure alert to the current chat with the first actionable error cause (do not silently drop the run).
