lingo-loop 0.1.0__tar.gz

lingo_loop-0.1.0/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "language-tutor",
+  "version": "0.1.0",
+  "description": "Local-first language tutor for Claude Code",
+  "author": {
+    "name": "language-tutor contributors"
+  },
+  "license": "MIT"
+}

lingo_loop-0.1.0/.codex-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": "1.0",
+  "name": "language-tutor",
+  "version": "0.1.0",
+  "description": "Local-first language tutor packaged as a Codex plugin (reuses root skills/).",
+  "author": "language-tutor contributors",
+  "license": "MIT",
+  "skills": "./skills/",
+  "features": {
+    "plugin_hooks": false
+  }
+}

lingo_loop-0.1.0/.gitignore

@@ -0,0 +1,74 @@
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environments
+venv/
+.venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.env*
+
+# SQLite Database Files
+*.db
+*.sqlite
+*.sqlite3
+*.db-journal
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Logs
+*.log
+*.tmp
+
+.agents
+.claude
+.codex
+claude.manifest.json

lingo_loop-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artem Veduta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lingo_loop-0.1.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: lingo-loop
+Version: 0.1.0
+Summary: Local-first Claude Code language tutor
+Project-URL: Homepage, https://github.com/artemVeduta/lingo-loop
+Project-URL: Source, https://github.com/artemVeduta/lingo-loop
+Project-URL: Issues, https://github.com/artemVeduta/lingo-loop/issues
+Project-URL: Changelog, https://github.com/artemVeduta/lingo-loop/blob/main/CHANGELOG.md
+Author-email: Artem Veduta <veduta.artem20@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: claude-code,cli,codex,language-learning,lingo-loop,local-first,tutor
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Education :: Computer Aided Instruction (CAI)
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1
+Requires-Dist: platformdirs>=4.2
+Requires-Dist: pydantic>=2.7
+Requires-Dist: ruamel-yaml>=0.18
+Provides-Extra: dev
+Requires-Dist: freezegun>=1.5; extra == 'dev'
+Requires-Dist: pyright>=1.1; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: syrupy>=4.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# lingo-loop
+
+> Learn languages inside your AI coding assistant — local-first, no telemetry.
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/artemVeduta/lingo-loop/actions/workflows/ci.yml/badge.svg)](https://github.com/artemVeduta/lingo-loop/actions/workflows/ci.yml)
+
+<!-- TODO(oss-baseline-assets): record top-level demo cast and render gif via agg, then restore the image + cast links below.
+     Until the assets land, omit them to avoid broken-image rendering on GitHub. Tracked in docs/internal/launch-checklist.md. -->
+*(Demo recording pending — see [`docs/internal/launch-checklist.md`](docs/internal/launch-checklist.md).)*
+
+## Why
+
+- **Local-first.** Your profile, vocabulary, and progress live in plain files on your machine.
+- **No telemetry.** Nothing is sent anywhere except the LLM API call your host already makes.
+- **Works inside your IDE.** Practice reading, writing, and vocabulary without leaving Claude Code, Codex, Hermes, or OpenClaw.
+
+## Features
+
+- Reading practice with adaptive vocabulary surfacing.
+- Short writing prompts with corrections from your assistant.
+- Spaced-repetition vocabulary loop, scheduled across sessions.
+- Lesson and transcript flows tailored to your native and target languages.
+- Progress tracking you can inspect with a single command.
+- Editable YAML profile — language pair, level, and preferences in one place.
+- Works across four AI coding hosts with the same CLI underneath.
+
+## Quick start (Claude Code)
+
+> PyPI publish is coming. Until then, install from source with [`uv`](https://docs.astral.sh/uv/) (or clone and run `uv pip install -e ".[dev]"` for a dev setup — see [CONTRIBUTING.md](CONTRIBUTING.md)).
+
+```bash
+# 1. Install the CLI from source (pip install lingo-loop coming soon)
+uv tool install git+https://github.com/artemVeduta/lingo-loop
+
+# 2. Detect AI hosts and install plugin wiring for the ones you use
+tutor init
+
+# 3. Write your learner profile (native + target language)
+tutor setup write --json '{"profile":{"native_language":"en","target_language":"uk"},"preferences":{}}'
+
+# 4. Inside Claude, run /reload-plugins, then ask: "start a reading session"
+```
+
+`tutor init` detects Claude, Codex, Hermes, and OpenClaw and shows a keyboard
+menu: arrow keys move, Space toggles providers, and Enter continues/applies.
+Rerun any time to repair drift — it never touches your learner profile, history,
+or secrets.
+Non-interactive form: `tutor init --provider claude --yes` (also `--dry-run`,
+`--json`).
+
+Full Claude install doc: [`docs/install/claude.md`](docs/install/claude.md)
+
+## Other hosts
+
+- Codex — [`docs/install/codex.md`](docs/install/codex.md)
+- Hermes — [`docs/install/hermes.md`](docs/install/hermes.md)
+- OpenClaw — [`docs/install/openclaw.md`](docs/install/openclaw.md)
+
+## How it works
+
+```
+┌──────────────┐       ┌────────────────┐       ┌─────────────────┐
+│  AI Host     │──────▶│  Tutor skill   │──────▶│  tutor CLI      │
+│  (Claude/    │       │  (markdown +   │       │  (Python)       │
+│  Codex/...)  │       │  prompts)      │       │                 │
+└──────────────┘       └────────────────┘       └─────────────────┘
+                                                          │
+                                          ┌───────────────┼────────────────┐
+                                          ▼               ▼                ▼
+                                   ┌──────────┐   ┌──────────────┐   ┌─────────┐
+                                   │ profile  │   │  learning    │   │  data/  │
+                                   │  YAML    │   │   SQLite     │   │ defaults│
+                                   └──────────┘   └──────────────┘   └─────────┘
+
+       All state local. No network calls except the host's own LLM API.
+```
+
+## Privacy
+
+Your learner profile and preferences live in editable YAML files. Transactional learning state (vocabulary intervals, session history, progress) stays in a local SQLite database under your user data directory. There is no telemetry, no account, no cloud sync, and no remote storage. The only network traffic is the LLM API call your AI host already makes on your behalf.
+
+## Roadmap
+
+Tracked publicly on GitHub:
+
+- [Milestones](https://github.com/artemVeduta/lingo-loop/milestones) — versioned scope.
+- [Projects](https://github.com/artemVeduta/lingo-loop/projects) — in-flight work.
+- [Discussions](https://github.com/artemVeduta/lingo-loop/discussions) — propose ideas before they become issues.
+
+## Contributing
+
+Pull requests welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for dev setup, branch naming, commit conventions, and the DCO sign-off policy.
+
+## License
+
+[MIT](LICENSE) © 2026 Artem Veduta

lingo_loop-0.1.0/README.md

@@ -0,0 +1,98 @@
+# lingo-loop
+
+> Learn languages inside your AI coding assistant — local-first, no telemetry.
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/artemVeduta/lingo-loop/actions/workflows/ci.yml/badge.svg)](https://github.com/artemVeduta/lingo-loop/actions/workflows/ci.yml)
+
+<!-- TODO(oss-baseline-assets): record top-level demo cast and render gif via agg, then restore the image + cast links below.
+     Until the assets land, omit them to avoid broken-image rendering on GitHub. Tracked in docs/internal/launch-checklist.md. -->
+*(Demo recording pending — see [`docs/internal/launch-checklist.md`](docs/internal/launch-checklist.md).)*
+
+## Why
+
+- **Local-first.** Your profile, vocabulary, and progress live in plain files on your machine.
+- **No telemetry.** Nothing is sent anywhere except the LLM API call your host already makes.
+- **Works inside your IDE.** Practice reading, writing, and vocabulary without leaving Claude Code, Codex, Hermes, or OpenClaw.
+
+## Features
+
+- Reading practice with adaptive vocabulary surfacing.
+- Short writing prompts with corrections from your assistant.
+- Spaced-repetition vocabulary loop, scheduled across sessions.
+- Lesson and transcript flows tailored to your native and target languages.
+- Progress tracking you can inspect with a single command.
+- Editable YAML profile — language pair, level, and preferences in one place.
+- Works across four AI coding hosts with the same CLI underneath.
+
+## Quick start (Claude Code)
+
+> PyPI publish is coming. Until then, install from source with [`uv`](https://docs.astral.sh/uv/) (or clone and run `uv pip install -e ".[dev]"` for a dev setup — see [CONTRIBUTING.md](CONTRIBUTING.md)).
+
+```bash
+# 1. Install the CLI from source (pip install lingo-loop coming soon)
+uv tool install git+https://github.com/artemVeduta/lingo-loop
+
+# 2. Detect AI hosts and install plugin wiring for the ones you use
+tutor init
+
+# 3. Write your learner profile (native + target language)
+tutor setup write --json '{"profile":{"native_language":"en","target_language":"uk"},"preferences":{}}'
+
+# 4. Inside Claude, run /reload-plugins, then ask: "start a reading session"
+```
+
+`tutor init` detects Claude, Codex, Hermes, and OpenClaw and shows a keyboard
+menu: arrow keys move, Space toggles providers, and Enter continues/applies.
+Rerun any time to repair drift — it never touches your learner profile, history,
+or secrets.
+Non-interactive form: `tutor init --provider claude --yes` (also `--dry-run`,
+`--json`).
+
+Full Claude install doc: [`docs/install/claude.md`](docs/install/claude.md)
+
+## Other hosts
+
+- Codex — [`docs/install/codex.md`](docs/install/codex.md)
+- Hermes — [`docs/install/hermes.md`](docs/install/hermes.md)
+- OpenClaw — [`docs/install/openclaw.md`](docs/install/openclaw.md)
+
+## How it works
+
+```
+┌──────────────┐       ┌────────────────┐       ┌─────────────────┐
+│  AI Host     │──────▶│  Tutor skill   │──────▶│  tutor CLI      │
+│  (Claude/    │       │  (markdown +   │       │  (Python)       │
+│  Codex/...)  │       │  prompts)      │       │                 │
+└──────────────┘       └────────────────┘       └─────────────────┘
+                                                          │
+                                          ┌───────────────┼────────────────┐
+                                          ▼               ▼                ▼
+                                   ┌──────────┐   ┌──────────────┐   ┌─────────┐
+                                   │ profile  │   │  learning    │   │  data/  │
+                                   │  YAML    │   │   SQLite     │   │ defaults│
+                                   └──────────┘   └──────────────┘   └─────────┘
+
+       All state local. No network calls except the host's own LLM API.
+```
+
+## Privacy
+
+Your learner profile and preferences live in editable YAML files. Transactional learning state (vocabulary intervals, session history, progress) stays in a local SQLite database under your user data directory. There is no telemetry, no account, no cloud sync, and no remote storage. The only network traffic is the LLM API call your AI host already makes on your behalf.
+
+## Roadmap
+
+Tracked publicly on GitHub:
+
+- [Milestones](https://github.com/artemVeduta/lingo-loop/milestones) — versioned scope.
+- [Projects](https://github.com/artemVeduta/lingo-loop/projects) — in-flight work.
+- [Discussions](https://github.com/artemVeduta/lingo-loop/discussions) — propose ideas before they become issues.
+
+## Contributing
+
+Pull requests welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for dev setup, branch naming, commit conventions, and the DCO sign-off policy.
+
+## License
+
+[MIT](LICENSE) © 2026 Artem Veduta

lingo_loop-0.1.0/agents/tutor-judge.md

@@ -0,0 +1,10 @@
+---
+name: tutor-judge
+description: Grades a learner answer and returns only a FeedbackEnvelope JSON object using the supplied allowed_error_tags.
+---
+
+# tutor-judge
+
+Return only a `FeedbackEnvelope` JSON object. No prose outside JSON.
+
+Use the `allowed_error_tags` supplied in input. Do not invent tags. Keep `confidence` one of `high`, `medium`, or `low`. Low confidence cannot be definitive high-severity correction. Include `next_drill_hint`.

lingo_loop-0.1.0/bin/claude-language-tutor

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "${ROOT}"
+
+if ! command -v claude &>/dev/null; then
+  echo "error: claude CLI not found. Install Claude Code first." >&2
+  exit 1
+fi
+
+if ! command -v uv &>/dev/null; then
+  echo "error: uv not found. Install uv first: https://docs.astral.sh/uv/" >&2
+  exit 1
+fi
+
+if [[ ! -x .venv/bin/python ]]; then
+  echo "==> Creating virtual environment and installing dependencies..."
+  uv venv .venv
+  uv pip install -e ".[dev]"
+fi
+
+echo "==> Validating plugin..."
+claude plugin validate . ## --strict
+
+echo "==> Launching Claude Code with language-tutor plugin..."
+exec claude --plugin-dir "${ROOT}" "$@"

lingo_loop-0.1.0/bin/tutor

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PYTHON="${ROOT}/.venv/bin/python"
+
+if [[ -x "${PYTHON}" ]]; then
+  exec "${PYTHON}" -m language_tutor.cli "$@"
+fi
+
+export PYTHONPATH="${ROOT}/src${PYTHONPATH:+:${PYTHONPATH}}"
+exec python -m language_tutor.cli "$@"

lingo_loop-0.1.0/data/defaults/preferences.yaml

@@ -0,0 +1,8 @@
+schema_version: 1
+session_length: 10
+review_intensity: normal
+feedback_verbosity: concise
+transliteration_tolerance: false
+ascii_fallback: false
+streak_grace_days: 1
+updated_at: null

lingo_loop-0.1.0/data/defaults/profile.yaml

@@ -0,0 +1,8 @@
+schema_version: 1
+native_language: en
+target_language: uk
+level_target: A1
+interests: []
+constraints: []
+created_at: null
+updated_at: null

lingo_loop-0.1.0/hermes-profile/SOUL.md

@@ -0,0 +1,30 @@
+# Language Tutor (Hermes Profile Prompt)
+
+You are a patient, source-backed language tutor running inside the Hermes
+host. You operate text-only: reading, lessons, transcripts, vocabulary,
+writing, and progress reporting. You do not produce or consume audio or
+images.
+
+## Lifecycle
+
+Hermes does not provide SessionStart/SessionEnd hooks for this profile.
+Boot context is built on demand via an explicit tutor command (the
+operator runs the tutor's boot command after `hermes profile install`).
+There is no automatic session-end hook; end-of-session work is invoked
+explicitly when requested.
+
+## Boot context
+
+When the explicit tutor boot command runs, load the learner profile and
+preferences through the tutor core and render the boot context sections.
+Never invent learner state; rely on the core's persisted data, which lives
+outside this distribution.
+
+## Behavior contract
+
+- Keep all interaction text-only and terminal-readable.
+- Defer pedagogy, feedback, progress, and persistence to the tutor core.
+- Never echo, package, or export learner secrets, memories, sessions,
+  database state, logs, or local overrides.
+- Stay within the declared capability profile: no audio, no images, no
+  host-specific side effects beyond the documented text flows.

lingo_loop-0.1.0/hermes-profile/config.yaml

@@ -0,0 +1,37 @@
+# Hermes profile configuration defaults for the language-tutor agent.
+# Defaults only. No learner data, no secrets, no machine-local state.
+schema_version: 1
+
+# Capability declaration mirrors src/language_tutor/adapters/registry.py
+# (HostId.HERMES). Source of truth stays in the registry; this is a
+# documentation echo for operators inspecting the distribution.
+capabilities:
+  text_support: supported
+  audio_support: unsupported
+  image_support: unsupported
+  lifecycle_start: explicit_command
+  lifecycle_end: not_available
+  boot_context_trigger: explicit_tutor_command
+
+# Tutor flows exposed by this profile. All text-only.
+flows:
+  - reading
+  - lesson
+  - transcript
+  - vocab
+  - writing
+  - progress
+
+# Hermes profile lifecycle commands (documentation for operators).
+commands:
+  install: hermes profile install
+  update: hermes profile update
+  inspect: hermes profile info language-tutor
+  list: hermes profile list
+  remove: hermes profile delete language-tutor
+
+# Operator-supplied environment is read from the operator's own untracked
+# .env at runtime. This distribution ships no values.
+env:
+  source: operator_local_env
+  bundled_values: false

lingo_loop-0.1.0/hermes-profile/distribution.yaml

@@ -0,0 +1,49 @@
+# Hermes profile distribution manifest for the language-tutor agent.
+# Distribution metadata and defaults only. Contains NO learner-owned data.
+# Installed/updated via `hermes profile install` / `hermes profile update`.
+schema_version: 1
+name: language-tutor
+display_name: Language Tutor
+version: 0.1.0
+description: >-
+  Source-backed language-learning tutor profile for Hermes. Provides
+  text-only reading, lesson, transcript, vocab, writing, and progress
+  flows backed by the host-independent tutor core. No audio or image
+  capabilities.
+license: MIT
+source_url: https://github.com/artemVeduta/lingo-loop
+
+# Whole-agent package contents (git-backed distribution).
+profile:
+  prompt: SOUL.md
+  config: config.yaml
+  # Tutor skills are reused from the repository root `skills/` surface; this
+  # distribution does not ship its own skills/ tree.
+  skills: ../skills
+
+# Environment variables the operator must supply locally before launch.
+# Declared here for documentation only; values are never bundled. The actual
+# secrets live in the operator's own untracked .env (NOT shipped).
+env_requires:
+  - name: ANTHROPIC_API_KEY
+    required: true
+    description: API key for the tutor model provider. Operator-supplied; never bundled.
+
+# Hard exclusions: data that must never be packaged, copied, or published.
+exclude:
+  - ".env"
+  - "*.env"
+  - secrets
+  - memories
+  - sessions
+  - "*.sqlite"
+  - "*.sqlite3"
+  - "*.db"
+  - "*.db-wal"
+  - "*.db-shm"
+  - logs
+  - "*.log"
+  - caches
+  - "*.cache"
+  - local
+  - local_overrides

lingo_loop-0.1.0/migrations/001_initial.sql

@@ -0,0 +1,111 @@
+CREATE TABLE IF NOT EXISTS migration_records (
+  version INTEGER PRIMARY KEY,
+  name TEXT NOT NULL,
+  checksum TEXT NOT NULL,
+  applied_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS lifecycle_events (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  payload_json TEXT NOT NULL,
+  occurred_at TEXT NOT NULL,
+  source TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS vocabulary_items (
+  id TEXT PRIMARY KEY,
+  target_language TEXT NOT NULL,
+  prompt TEXT NOT NULL,
+  lemma TEXT,
+  accepted_answers_json TEXT NOT NULL,
+  hint TEXT,
+  tags_json TEXT NOT NULL,
+  state TEXT NOT NULL,
+  ease_factor REAL NOT NULL CHECK (ease_factor >= 1.3),
+  repetition_count INTEGER NOT NULL CHECK (repetition_count >= 0),
+  interval_days INTEGER NOT NULL CHECK (interval_days >= 0),
+  due_at TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  dedupe_key TEXT NOT NULL UNIQUE
+);
+
+CREATE TABLE IF NOT EXISTS answer_events (
+  id TEXT PRIMARY KEY,
+  idempotency_key TEXT UNIQUE,
+  session_id TEXT NOT NULL,
+  skill TEXT NOT NULL,
+  prompt_ref TEXT NOT NULL,
+  learner_answer TEXT NOT NULL,
+  outcome TEXT NOT NULL,
+  feedback_envelope_json TEXT,
+  recorded_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS vocabulary_reviews (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  vocabulary_item_id TEXT NOT NULL REFERENCES vocabulary_items(id),
+  answer_event_id TEXT NOT NULL UNIQUE REFERENCES answer_events(id),
+  verdict TEXT NOT NULL,
+  quality INTEGER NOT NULL CHECK (quality BETWEEN 0 AND 5),
+  previous_state_json TEXT NOT NULL,
+  next_state_json TEXT NOT NULL,
+  reviewed_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS mistake_events (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  answer_event_id TEXT REFERENCES answer_events(id),
+  skill TEXT NOT NULL,
+  span_start INTEGER,
+  span_end INTEGER,
+  span_text TEXT,
+  severity TEXT NOT NULL,
+  tag TEXT NOT NULL,
+  explanation TEXT NOT NULL,
+  confidence TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS session_summaries (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL UNIQUE,
+  summary_for_user TEXT NOT NULL,
+  summary_for_next_boot TEXT NOT NULL,
+  weak_tags_json TEXT NOT NULL,
+  next_focus TEXT NOT NULL,
+  cost_snapshot_json TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS skill_metrics (
+  id TEXT PRIMARY KEY,
+  metric_date TEXT NOT NULL,
+  metric_name TEXT NOT NULL,
+  metric_value REAL NOT NULL,
+  dimensions_json TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS cost_events (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  operation TEXT NOT NULL,
+  model TEXT NOT NULL,
+  input_tokens INTEGER NOT NULL CHECK (input_tokens >= 0),
+  output_tokens INTEGER NOT NULL CHECK (output_tokens >= 0),
+  cache_read_tokens INTEGER NOT NULL CHECK (cache_read_tokens >= 0),
+  estimated_cost_usd REAL CHECK (estimated_cost_usd IS NULL OR estimated_cost_usd >= 0),
+  pricing_source TEXT NOT NULL,
+  source_event_id TEXT,
+  created_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_vocabulary_due ON vocabulary_items(due_at, state);
+CREATE INDEX IF NOT EXISTS idx_answers_session ON answer_events(session_id, recorded_at);
+CREATE INDEX IF NOT EXISTS idx_mistakes_tag ON mistake_events(tag, created_at);
+CREATE INDEX IF NOT EXISTS idx_cost_month ON cost_events(created_at);

lingo_loop-0.1.0/migrations/002_vocab_depth.sql

@@ -0,0 +1,12 @@
+ALTER TABLE vocabulary_items
+  ADD COLUMN card_type TEXT NOT NULL DEFAULT 'standard'
+  CHECK (card_type IN ('standard', 'cloze'));
+
+ALTER TABLE vocabulary_items
+  ADD COLUMN notes_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE vocabulary_items
+  ADD COLUMN sources_json TEXT NOT NULL DEFAULT '[]';
+
+UPDATE vocabulary_items
+SET dedupe_key = 'standard:' || lower(trim(coalesce(lemma, prompt))) || ':' || lower(trim(prompt));

lingo_loop-0.1.0/migrations/003_progress_indexes.sql

@@ -0,0 +1,14 @@
+CREATE INDEX IF NOT EXISTS idx_progress_sessions_created
+  ON session_summaries(created_at DESC, session_id);
+
+CREATE INDEX IF NOT EXISTS idx_progress_reviews_session_time
+  ON vocabulary_reviews(session_id, reviewed_at);
+
+CREATE INDEX IF NOT EXISTS idx_progress_mistakes_session_time
+  ON mistake_events(session_id, created_at);
+
+CREATE INDEX IF NOT EXISTS idx_progress_answers_session_skill_time
+  ON answer_events(session_id, skill, recorded_at);
+
+CREATE INDEX IF NOT EXISTS idx_progress_vocab_due_state
+  ON vocabulary_items(due_at, state);