Eve library

@oshun/tara-workbench

Other

Revision 1

On this page

Domain logic for the Tara Content Workbench — the V1 creation/curation workspace for Tara (meditation/mindfulness) content. Design: V1/TARA_CONTENT_WORKBENCH_DESIGN_2026-07-19.md; task ledger: TARA_CONTENT_WORKBENCH_TODOS_2026-07-19.md.

At a glance#

  • Path: libs/oshun/tara-workbench
  • Nx project: @oshun/tara-workbench
  • Pure ESM source library (like @oshun/studio-authoring): injected clocks and ids, no I/O — durability and transport live at the BFF boundary (apps/oshun/bff).

Modules#

Module What it owns
types Entities: Spark, Concept/premise, Source/Claim/CitationLink, Program, CategoryRow, gate results, bundles
state-machine The maturity ladder (spark → … → published) with evidence-based transition guards
script-blocks Duration-typed guidance blocks (spoken, breath-cue, silence, bell) + deterministic timeline compilation
gates Duration-coherence and transcript/captions gates; the honest unavailable audio-QA seam
invitational-language Meditation-adapted directive-language linter (ported from the V3 yoga linter, attributed)
grounding Claim severity floors, clinical-grade support rules, grounding gate, source blast radius
steering-overlay Program overlays composed onto the global CreativeDirection — tighten-only autonomy, raise-only bars
category-registry tara.* category merge over the plane's code floor (V1_AUTONOMY_LAUNCH_CATEGORIES), tighten-only
decision-records ADR-style creative decisions; idea-score blend/display helpers over plane IdeaScoreBreakdown
manifest Publish-manifest builder mirroring apps/tara/content/schemas/meditation.schema.json (golden-tested)
provider TaraWorkbenchModelProvider LLM seam (diverge/extractClaims/assistScript) — fail-loud not_configured

Fail-loud seams#

Every backing dependency (LLM provider, Sophia grounding, TTS, autonomy plane, content tree) refuses with a typed not_configured/unavailable rather than fabricating output. See design §8 and errors.ts.

Commands#

bash
pnpm nx test @oshun/tara-workbench
pnpm nx lint @oshun/tara-workbench
pnpm nx typecheck @oshun/tara-workbench