Nisaba · the study plan

Purpose#

A seven-week study arc with a prerequisite chain — what rests on what — paced by weeks. The fixture is "On the ruling part" — week 4 of 7, 18 of 31 readings.

Entry points#

• Nisaba sub-nav — verify a "plan" entry on nisaba.md
• Notebook — link from nisaba-notebook.md
• Direct URL / bookmark — yes

Layout regions#

page.tsx is a thin server component: await getNisabaPlan() → <NisabaPlan data={data} />.

Inside NisabaPlan (nisaba.tsx, line 2048):

• Web shell top — LCustomerNav active="library"
• Header strip — eyebrow row "Nisaba · study plan" / "'On the ruling part' · 7 weeks" / "week 4 of 7 · 18 of 31 readings"; LDisplay (size 72) headline "The arc, paced by weeks."
• Progress row (gridTemplateColumns: '1fr auto'):
  • Progress label + bar — 6 px ruler with accent fill at (3.4 / 7) * 100% and a 14 px accent dot positioned at the current marker
  • Week labels — w. 1 … w. 7 with w. 4 · today highlighted in accent
• Weekly arc body (verify exact layout further in nisaba.tsx) — one card per week, listing readings, prerequisites, and links to the reading desk

States#

• Loaded — getNisabaPlan() resolves before render
• Current week — highlighted "w. · today"; progress bar fills to (<fraction>/7) * 100%
• Reading completed — verify per-reading completion indicator
• Prerequisite locked — verify lock state for prerequisites that haven't been satisfied
• Plan paused / abandoned — verify whether the surface handles a paused state
• Reduced motion — composes static Lilith primitives

Interactions#

Header#

• LDisplay — non-interactive headline

Progress row#

• Progress bar — non-interactive
• Week label (w. 1 … w. 7) — verify whether labels link to that week's section anchor

Weekly arc body#

• Week card — opens the week's reading list (verify scroll-spy or route push)
• Reading row — opens the passage in the reading desk (/nisaba/...)
• Mark complete — verify whether the plan supports checking off readings in V1
• Prerequisite hint — verify hover/focus tooltip on locked items

Data & contracts#

• Reads: getNisabaPlan() from @/lib/lilith-data/nisaba-depth — returns NisabaPlanData (verify shape: weeks, readings, prerequisites, current progress)
• Writes: verify whether the plan supports a "mark complete" write path
• Realtime: None.
• Caching: server fetch
• Auth/role check: shell middleware

Cross-references#

• Sibling Nisaba routes:
  • nisaba.md, nisaba-compare.md, nisaba-daily.md, nisaba-graph.md, nisaba-lexicon.md, nisaba-manuscript.md, nisaba-notebook.md, nisaba-scholar.md
• Component sources:
  • apps/oshun/web/src/components/lilith/nisaba.tsx (NisabaPlan line 2048)
• Feature spec: V1/features.md#nisaba

Open questions / known gaps#

• Confirm whether reading completion is wired to a BFF write path
• Document the prerequisite-locked behavior (visual only? prevents navigation?)
• Confirm whether the plan should integrate with Metis course progression or remain Nisaba-internal
• Document how week labels behave on mobile (they sit in a horizontal row; narrow viewports may overflow)