Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Alignment-based suggestions from a major-language model text

Abierto
  • ¿Algo no está bien?
#218 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Nueva funcionalidad
Claridad
Necesita aclaración
Estado de actividad
Activo
Stack tecnológico
typescript
Área
data

Línea de trabajo

Empieza leyendo #148 y resolviendo la decisión de alineación A/B/C; después revisa deriveTokenSuggestion y el flujo de modelProjectId que introduce. Inspecciona manifest.json, projectStorage.updateAnalysis, AlignmentLink y la configuración interlinearizer.useModelSuggestions; se considera terminado cuando las palabras del modelo alineadas producen sugerencias con distintivo de modelo y existe una estrategia de persistencia y una secuencia de dependencias acordadas.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Split out of #148 (2026-08-12). #148 now covers the surface-form tier — a sibling interlinear project whose approved glosses match the source by surface form — which is ready to build. This issue covers the other kind of model source, which is not.

A major-language Scripture project (e.g. an English Bible) whose words are the gloss vocabulary. It is in a different language from the source, so surface-form matching does not apply: suggestions come from source↔model word alignment — source word → aligned model word(s) → suggested gloss.

Required for full PT9 interlinearization support (Options 1 & 3), which is a stated goal, so this is on the PT9 parity path even though #150's import pipeline does not depend on it.

The decision that gates this

#148 left the approach open, and it has not been answered. It should be settled before any code is written, because the three answers have completely different costs and completely different dependencies.

A. Seed from imported PT9 cluster→gloss data. PT9 already recorded which source word maps to which gloss; reuse that as the alignment. No aligner, no binaries, no licensing question.
Cost: low. But it inverts a dependency — the alignment data comes from #150's import, so this route makes this issue depend on #150, rather than the other way round. Note #150 originally listed #148 as one of its dependencies; that edge was removed on 2026-08-12 because #150's pipeline does not need it. Choosing A would mean adding #218 blocked by #150.
Also: only covers text PT9 already aligned. A project with no PT9 import gets nothing.

B. Compute alignment with fast_align. Apache-2.0, so no license conflict. Still needs per-platform binaries built and shipped, and the createProcess elevated privilege.

C. Compute alignment with eflomal. #102 investigated this in depth and its assessment applies only to this branch. Two blockers it identifies are organizational rather than code, and neither is resolved or separately tracked:

  • GPLv3 (eflomal) vs MIT (this extension) — redistribution "needs legal/licensing sign-off from SIL."
  • Per-platform binary build/ship infrastructure — win32/linux/darwin with OpenMP, and the stock Makefile's -march=native must be dropped for a portable baseline or the binary may fault on other CPUs.

Options B and C additionally require adding "createProcess" to the currently-empty elevatedPrivileges array in manifest.json — the extension spawns no subprocesses today, so this would be the first.

Scope once the approach is settled

  • Resolve modelProjectId (added by #148) pointing at a non-interlinear Scripture project to the alignment strategy rather than the pool.
  • The alignment step itself, per the chosen option.
  • Feed aligned model words into deriveTokenSuggestion as candidates, reusing the producer: "model:{id}" marker #148 introduces so SuggestionDropdown badges them "from model".
  • Respect the interlinearizer.useModelSuggestions setting from #148.

Persistence is a separate open question

#148 noted alignments "could be persisted via AlignmentLink". Two things to know before choosing that:

  • projectStorage.updateAnalysis writes only the analysis field, not links — there is no persistence path for alignment links at all today.
  • #129 (Burrito alignment specification) observes that AlignmentLink is currently dead weight, so the cost of adopting or mapping to the Burrito flavor "is near zero today and grows with every feature that touches alignment," and recommends doing that investigation before alignment work is scheduled. If this issue persists via AlignmentLink, #129 should be answered first.

Computing alignment on demand and not persisting it sidesteps both.

Open questions

  • Which approach — A, B, or C? Everything else follows.
  • Persist via AlignmentLink, or recompute? See above; if persisting, sequence #129 first.
  • Alignment granularity and quality. #102 notes an aligner "needs reasonable sentence counts to align well; single-verse alignment in isolation may be weak" — so whole-book or corpus-trained priors may be necessary, which affects whether this is a batch or on-demand operation.

Blocked by: #148 (introduces modelProjectId, the model tier in deriveTokenSuggestion, and the producer marker).
Related: #150, #102, #129, #94.

Size: L
Priority: P2 — prerequisite for full PT9 import parity; not blocking gloss-only use or #150's pipeline.

Lenguaje dominante
TypeScript
Estrellas
2
Forks
0
Merge medio
2 d 5 h
PR fusionados (30 d)
42

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de sillsdev/interlinearizer-extension

Todos los issues de sillsdev/interlinearizer-extension

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.