Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Hints: webhook deliveries mode

オープン
  • 何か問題がありますか？
#37 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
github, typescript, yaml
領域
api, backend, web-dev

調査の方向性

Read ADR 0014 and the referenced CONTEXT.md and ADRs 0001–0019 first; inspect the implementation for polling triggers (#28), board drag and label sync (#33), the existing HTTP server, and runtime store. Define the hint seam and delivery modes against those dependencies, then check each acceptance criterion, including deduplication, cursor persistence, webhook verification, UI status, and the unchanged 60s poll.

索引モデルが issue の本文から書いたものです。

説明

agent-in-progress

Parent

Implementation breakdown of the build-ready spec — map #1; spec = CONTEXT.md + ADRs 0001–0019.

What to build

Latency without touching correctness: a Hint nudges the engine to fetch a repo's or item's state sooner than the next poll. Self-write hints make the board drag feel instant; the two webhook modes bring sub-poll latency for outside changes — all behind one seam, with polling remaining the sole correctness source and the dedup ledger the sole event gate.

Spec: ADR 0014.

Acceptance criteria

  • The hint seam: a droppable (repo, optional item) nudge that only schedules the existing change-detection / slice fetch earlier — never a new event path; a dropped hint costs freshness only, a doubled hint dedups to nothing; the 60s backstop poll runs unchanged
  • Self-write hints always on: after any usine write to GitHub (board-drag label swap, ask comment), the engine hints itself — a board drag reflects in about a second
  • webhooks.mode in usine.yaml, default off
  • deliveries mode: JWT-polls the App's webhook-delivery log on an engine-fixed ~10s cadence, routing repo-level hints from summary fields without payload fetches; cursor persists in the runtime store; ping and unregistered repos ignored
  • endpoint mode: serves an HMAC-SHA256-verified webhook route on the orchestrator's existing HTTP server, taking item-level hints from payloads; webhooks.public_url required; usine PATCHes the App's hook URL on every mode/config change
  • UI: Configuration shows the mode and last-hint-received; the needs-you strip warns when endpoint mode has never received a delivery — display + warn only, engine behavior never consults hint health

Blocked by

  • #28 — Polling triggers: change detection to content-hashed Events
  • #33 — Board: lanes, two-way label sync, drag as a trigger surface

Decisions (2026-10-28)

Self-write hints are built (packages/orchestrator/src/polling/hints.ts, ADR 0014), and the webhooks schema exists (packages/config/src/factory.ts). This issue now covers the deliveries mode only; the endpoint mode is #679.

  • Extend ItemHints with a repository-level hint (item optional) that runs that repository's change detection early. Keep the dropping queue of 128.
  • deliveries mode: poll GET /app/hook/deliveries with the App JWT about every 10 seconds. Persist the cursor beside CursorStore, ignore ping and unregistered repositories, and fetch no payloads.
  • webhooks stays a setting read at startup (current-instance/changes.ts).
  • Settings shows the mode and the last hint time.
  • Tests with a scripted deliveries API: a delivery for a registered repository hints its change detection once; ping and unknown repositories are ignored; the cursor survives a restart.
主要言語
TypeScript
スター
1
フォーク
0
平均マージ
4時間 39分
マージ済み PR（30日）
243

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

basaltbytes/usine のほかの issue

basaltbytes/usine の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。