Skip to main content

M07: JST Interlinear

Phase: P2: Scholar Features Target: Weeks 23–27 Sprints: S11, S12, S13 (start) Release Tags: web/v0.7.0-alpha

Phase Context​

Goal: The three paid pillars that justify $79.99/year — interlinear Hebrew/Greek + JST, constellation view, and constrained AI. Ref: MVP.md § Paid Tier.

Key constraint: Founding users enter during this phase (~Week 22). Ship incrementally; don't wait for "complete."

ZenHub Configuration​

FieldValue
MilestoneM07: JST Interlinear
Due Date2026-09-13
Default PipelineProduct Backlog
Primary Epic(s)JST Interlinear

Prerequisites​

PrerequisiteSource MilestoneWhat Must Be Complete
Interlinear display mode + WordToken componentM06: Interlinear & LexiconInterlinear rendering infrastructure, study mode, lexicon bubble — JST builds on this foundation
JST corpus data ingestedM01: Data PipelineJST corpus files (OT + NT) ingested; :Witness nodes with JST variants created
Reader with study modeM06: Interlinear & LexiconStudy mode activation and verse long-press interaction pattern

Epics​

Epic: JST Interlinear​

Story AreaScopeSpec Reference
JST data verificationValidate JST corpus files against schemasGOSPELIB-SCHEMAS.md
JST APIEndpoint or passage enrichment returning JST variants for a verseMVP.md § Priority #1b
Inline diff viewKJV ↔ JST word-level diff highlightingMVP.md § Priority #1b
Manuscript attributionTap variant → source manuscript + context from JSPPMVP.md § Priority #1b
Witness layer UIPull-down or panel for manuscript variant accessDESIGN-SYSTEM.md § Witness Layer

Document References​

DocContainsUse When Writing Stories For
MVP.mdFeature scope, tier breakdown, success criteria, budgetAcceptance criteria, scope boundaries
TECH-SPEC.mdArchitecture, service boundaries, data stores, API catalogTechnical implementation details
GOSPELIB-SCHEMAS.mdAll 7 schema families, node/edge types, validation rulesData models, Pydantic models, graph schema
GOSPELIB-INGEST-SPEC.md7-stage pipeline, Cypher templates, batch strategy, CLIIngest pipeline stories
DESIGN-SYSTEM.mdVisual identity, component catalog, reader modes, tokensUI component stories
DESIGN-SYSTEM.md §§ 13, 21–23Footnotes (§13), subscription boundaries (§21), sharing (§22), onboarding (§23)UX flow stories
Deployment & OperationsEnvironments, K8s, CI/CD, migrations, secrets, DRInfrastructure and deployment stories
REPO-MAP.mdDirectory structure, naming conventions, dependency rulesAll stories (coding standards)
BusinessLEGAL.md, POLICY-TERMS.md, executive summary, market research, GTMLaunch readiness, legal/compliance stories

Additional Spec References for This Milestone​

Doc SectionRelevance
MVP.md § Priority #1bJST feature spec — inline diff, manuscript attribution
DESIGN-SYSTEM.md § Witness LayerWitness layer UI pattern for manuscript variant access
GOSPELIB-SCHEMAS.md § WitnessWitness node schema — JST variants, manuscript sources

Sprint Mapping​

SprintWeeksPrimary Focus for M07
S1123–24Founding users enter. JST data verification, JST API, inline diff view
S1225–26Manuscript attribution, witness layer UI

S11 overlaps M06 tail (founding users are seeing interlinear for the first time). S13 (Weeks 27–28) begins M08 constellation work.

Sprint Load Warnings​

  • S11 (Weeks 23–24) coincides with founding user entry. Balance JST development with responding to early user feedback on interlinear features from M06.

Release Info​

ReleaseTagContains
v0.7.0-alphaweb/v0.7.0-alphaJST interlinear (Scholar)

Tags follow <component>/v<semver> per release-please-config.json.

Relevant Risks​

RiskImpactMitigation
Ingest pipeline data quality issuesJST corpus data may have gaps or schema mismatchesCorpus validation epic in P0; JST data verification story in this milestone
Interlinear Hebrew RTL renderingRTL issues from M06 may persist into JST displayPrototype RTL layout early in P2; test with real corpus data
Solo founder velocity38-week plan too aggressiveFounding users at Week 22 provide feedback before full scope; cut P3 scope if needed

Cross-Cutting Concerns​

Testing​

LayerFrameworkWhenSpec Reference
Python unit/integration (JST API)pytest + testcontainersEvery PRTECH-SPEC.md § Testing
TypeScript unit (inline diff, witness layer)VitestEvery PRTECH-SPEC.md § Testing
Component visualStorybook or playgroundP1+DESIGN-SYSTEM.md § Governance
Visual regressionPlaywright + pixelmatchP1+ (any packages/ui/ or apps/*/src/ change)DESIGN-SYSTEM.md § Visual Regression CI

Documentation​

DocUpdate Trigger
API OpenAPI specsContent service JST enrichment endpoint
ADRsJST diff algorithm, witness layer interaction pattern

CI/CD​

AdditionPhaseDetail
Visual regression screenshotsP2JST diff and witness layer components added to playground; pixelmatch baseline updated

Dependencies​

Upstream (what M07 needs)​

DependencySourceStatus
Interlinear display mode + study modeM06: Interlinear & LexiconMust be complete (JST extends interlinear infrastructure)
WordToken component + lexicon bubbleM06: Interlinear & LexiconMust be complete (JST words reuse the same interaction pattern)
JST corpus data ingested (:Witness nodes)M01: Data PipelineMust be complete (Stage 3 scripture text pipeline handles JST)
Content API (passage routes)M02: Content APIMust be complete (JST API enriches passage response)
Staging environmentM05: Search & StagingMust be live (founding users testing during this milestone)

Downstream (what depends on M07)​

DependentMilestoneWhat It Needs From M07
Constellation viewM08: Knowledge GraphWitness layer patterns may inform graph node detail views
AI study assistantM09: AI Study AssistantJST variant data available for AI-powered original-language analysis prompts
MonetizationM10: MonetizationJST is a Scholar-tier feature; entitlement gating wraps it in M10

Issues​

IssueTitleStatusNotes
M07-001JST Data Verification — Validate JST Corpus Files (OT + NT) Against Schemas❌ To Docorpus files missing
M07-002JST API — Passage Enrichment Returning JST Variants for a Verse🔶 Partialinclude_witnesses param and Cypher query exist but no JST corpus data
M07-003Inline Diff View — KJV ↔ JST Word-Level Diff Highlighting❌ To Donot implemented
M07-004Manuscript Attribution — Tap Variant → Source Manuscript + Context from JSPP❌ To Donot implemented
M07-005Witness Layer UI — Pull-Down Panel for Manuscript Variant Access❌ To Donot implemented

Progress: 0 Done · 1 Partial · 4 To Do (10%)

Epic: JST Interlinear​

Issue Dependency Graph​

M07-001 ──► M07-002 ──► M07-003 ──► M07-004 ──► M07-005
                   │           │                    ▲
                   │           └────────────────────┘
                   └──► M07-004

Cross-milestone:
  M02 (Content API) ──► M07-002
  M06 (Interlinear)  ──► M07-003
  M06 (Interlinear)  ──► M07-005

Legend: A ──► B means A blocks B (B is blocked by A)

Summary​

MetricCount
Total Issues5
Sub-Issues0
Total Estimate (pts)34
SprintsS11–S12
Dependencies (blocking)6
Dependencies (blocked by)9