Skip to content

Spoke Plus System Contract

Generated at: 2026-04-10T07:27:38.595Z

Services

  • spokeplus: script=server.js, cwd=., instances=1, mode=fork
  • spokeplus-web: script=npm, cwd=./web, instances=1, mode=fork

Workers and Queues

  • Queues: tts, word-enrichment.

Database

  • Public tables inferred from migrations/sql + backend references: 214.
  • Canonical schema snapshot: docs/system/schema-current.json.

Runtime Architecture

  • API and admin endpoints are mounted from app.js + routes/.
  • Runtime diagnostics are exposed under /admin/system/*.
  • Documentation retrieval is backed by docs_index.

Source of truth for Copilot

  • Copilot must use this file + docs/system/system-map.json + docs/system/schema-current.json before making architecture assumptions.

Lemma curriculum-introduction metadata contract (authoring/runtime)

  • introduced_unit_id and introduced_step are optional at lemma creation and manual authoring time.
  • Blank/omitted values must remain NULL; creation must not coerce missing values to unit/step 1.
  • introduced_step, when explicitly provided, must be a positive integer.
  • Runtime/list summary should display blank (—) until values are manually set or auto-populated by first real curriculum use.
  • Automatic first-use registration policy is first-write-wins: if both fields are NULL, first real curriculum use sets them; later automatic flows must not overwrite them without explicit editorial action.