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

`confidence` means two different things, and its type docs cite fields PT9 never sends

オープン
#309 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
リファクタリング
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript

調査の方向性

src/types/interlinearizer.d.ts:970 と analysisMerger.ts:339 および :406 の PT9 import の使用箇所から始め、#254 の confidence の意味に関するリンク先の議論を確認してください。confidence の意味を 1 つ決定して文書化し、もう一方の意味をどう扱うかを定義し、出荷済みの PT9 フィールドに合わせて型のドキュメントを更新してください。フィールドの意味が変わる場合は、永続化データの移行も考慮してください。

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

説明

Two problems in one field's story — one semantic, one documentation.

1. confidence is claimed twice

PT9 import spends AnalysisLink.confidence on anchor ambiguity: confidence: 'low' marks a record whose token placement was a guess among equal folded forms (analysisMerger.ts:339, :406).

#254 proposes spending it on approval provenance — stamping a bulk-approved link lower than a hand-approved one, so "approved" doesn't collapse "a human read this" with "a human swept a hundred of these" (#254's Confidence bullet, which relates it to #51 and #53, never to PT9). #51 is on hold as of 2026-08-25, so #254 is the live claimant.

Two different meanings for one per-assignment field, and neither issue records the collision. Decide which meaning confidence carries, and what mechanism the loser gets — a separate field, a flag on the link, or nothing.

Note the import use is already shipped and sitting in persisted data, so changing its meaning is a migration question, not only a naming one.

2. The type docs cite fields the format never sends

interlinearizer.d.ts:970 still says Paratext status / confidence are "inferred from InterlinearLexeme.IsGuess and .Score". The PT9 interlinear data we consume has neither — no IsGuess, no Score, only VerseData.Hash — and the shipped code means something else by both: status comes from Hash plus Excluded plus the merger's demotion rules, confidence from anchor ambiguity as above.

The doc points at a source that does not exist, for a field whose real meaning is question 1. Fix it once 1 is decided, rather than twice.

Size: S — a decision plus a doc fix; larger if the decision forces a new field.
Priority: P2 — nothing is broken for a user today, but #254 cannot stamp anything until this is settled.

Drafted by Claude

主要言語
TypeScript
スター
2
フォーク
0
平均マージ
2日 3時間
マージ済み PR(30日)
46

環境構築

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

はじめの一歩

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

sillsdev/interlinearizer-extension のほかの issue

sillsdev/interlinearizer-extension の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

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

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