practicode 0.1.0 → 0.1.2

package/Cargo.lock

@@ -357,7 +357,7 @@ checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
 
 [[package]]
 name = "practicode"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "anyhow",
  "crossterm 0.29.0",

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "practicode"
-version = "0.1.0"
+version = "0.1.2"
 edition = "2024"
 description = "Local-first coding-test practice in a Rust terminal UI with optional AI help."
 readme = "README.md"

package/README.md

@@ -11,70 +11,55 @@
 Personal coding practice, right in your terminal.
 
 `practicode` is a small Rust TUI for stdin/stdout practice: problem on the left, code on the right, judge loop in the same terminal.
-No browser tab shuffle, no paste dance, just solve and run.
 
-## Why It Exists
+## Start
 
-- Fast local judging for Python, TypeScript, Java, and Rust
-- Gradual problem flow with local history
-- AI-powered `/next <request>` when you want a custom problem
-- Personal problem-generation notes
-- Small stack: Rust, Ratatui, Crossterm, and plain process execution
+### Prerequisites
 
-## Quick Start
+- Node.js 18+ for npm installation.
+- Rust and Cargo. The npm package builds the Rust binary during install, and also on first run if needed.
+- A runtime for the language you practice in: Python, Node.js for TypeScript, JDK for Java, or Rust.
 
-```bash
-git clone https://github.com/baba9811/practicode.git
-cd practicode
-cargo run --
-```
-
-Want a local binary?
-
-```bash
-cargo install practicode
-practicode
-```
-
-Prefer npm from GitHub?
+### npm
 
 ```bash
-npm install -g github:baba9811/practicode
+npm install -g practicode
 practicode
 ```
 
-Working from a local checkout?
+### Cargo
 
 ```bash
-cargo install --path .
+cargo install practicode
 practicode
 ```
 
-Or with npm:
+### Local checkout
 
 ```bash
-npm install -g .
-practicode
+git clone https://github.com/baba9811/practicode.git
+cd practicode
+npm install
+npm start
 ```
 
-The npm wrapper builds the Rust binary with Cargo, so Rust/Cargo is still required.
-
 ## Daily Loop
 
 The code editor starts focused.
 
 ```text
 write code
-Esc, then /run
-Esc, then /next easy string problem
+Esc, then /
+choose /run
+choose /next when it passes
 ```
 
+Typing `/` outside the editor opens the command palette. Use `up/down` to move, `Enter` to run or complete the selected command, and `Esc` to cancel.
+
 Submissions are saved as you type under `submissions/<problem-id>/solution.<ext>`.
 
 ## Commands
 
-Press `Esc`, then `/`, to focus the command bar.
-
 | Command | Action |
 | --- | --- |
 | `/run` | Judge the current submission |
@@ -85,22 +70,22 @@ Press `Esc`, then `/`, to focus the command bar.
 | `/open 2` | Open by number, id, or slug |
 | `/giveup` | Show the reference answer |
 | `/ai hint` | Ask the selected AI about the current problem and submission |
-| `/provider codex` | Set AI provider: `codex` or `claude` |
-| `/model sonnet` | Set the model for `/ai` and AI-backed `/next`; use `auto` for the CLI default |
+| `/provider codex` | Set AI provider and show local CLI/daemon status |
+| `/model auto` | Set the model for `/ai` and AI-backed `/next` |
 | `/note prefer hashmap practice` | Append a standing note for future problem generation |
 | `/notes` | Show your local next-problem notes |
-| `/lang python` | Set language: `python`, `ts`, `java`, `rust` |
-| `/ui ko` | Set UI language: `ko`, `en` |
-| `/theme` | Toggle dark/light theme |
+| `/lang python` | Set code language: `python`, `ts`, `java`, `rust` |
+| `/ui en` | Set UI language: `en`, `ko`, `ja`, `zh`, `es` |
+| `/theme dark` | Set theme: `dark` or `light` |
 | `/source ai` | Prefer AI for next-problem generation |
+| `/update` | Show update instructions when a newer version is available |
 | `/exit` | Quit |
 
-The editor owns normal typing keys.
-Press `Esc`, then `/`, when you want the command bar.
+The default UI language is English. Switch it any time with `/ui ko`, `/ui ja`, `/ui zh`, or `/ui es`.
 
-## Custom Problem Generation
+## AI Problems
 
-`/next <request>` passes your request into the selected AI problem generator. Examples:
+`/next <request>` passes your request into the selected AI problem generator.
 
 ```text
 /next a slightly harder string problem
@@ -108,19 +93,7 @@ Press `Esc`, then `/`, when you want the command bar.
 /next sorting problem, no graph yet
 ```
 
-AI generation reads [docs/problem-authoring-notes.md](docs/problem-authoring-notes.md) every time it creates a problem. Add personal preferences from inside the TUI:
-
-```text
-/note Prefer concise statements.
-/note I want more string and hashmap practice.
-/note Avoid DP until I ask for it.
-```
-
-Those notes are stored in `.practicode/problem_notes.md`, so they stay local.
-
-## AI Providers
-
-Codex is the default:
+Codex is the default provider:
 
 ```text
 /provider codex
@@ -135,14 +108,11 @@ Claude Code is also supported:
 /source ai
 ```
 
-`/ai <prompt>` uses the current provider for coaching. AI-backed `/next` uses the same provider and model.
-If you want a custom daemon or wrapper script, set `/ai-next-command <shell command>`; practicode passes `PRACTICODE_NEXT_REQUEST`, `PRACTICODE_AI_PROVIDER`, and `PRACTICODE_AI_MODEL`.
-
-Generated problem banks stay local:
+Generated problems and submissions stay local:
 
 | Path | Purpose |
 | --- | --- |
-| `.practicode/problem_bank.json` | Local/custom/generated problem bank |
+| `.practicode/problem_bank.json` | Local/custom/generated problems |
 | `.practicode/problem_notes.md` | Optional personal problem-generation notes |
 | `.practicode/problem-state.json` | Current problem, history, settings |
 | `problems/` | Generated problem markdown/index files |
@@ -150,51 +120,23 @@ Generated problem banks stay local:
 
 Those paths are ignored by git, so your practice history stays yours.
 
-## Safety
-
-`/run` executes your local submission as a normal process. practicode runs it from `.practicode/build/<problem-id>/run`, but this is not an OS sandbox. Only run code you trust.
+## Update
 
-## Debug Prints
+The app checks for newer npm releases in the background and shows `/update` in the status line when one is available. Disable that check with `PRACTICODE_NO_UPDATE_CHECK=1`.
 
-`/run` shows raw stdout when a case fails. If you want debug output without changing the judged answer, print to stderr:
+```bash
+npm update -g practicode
+cargo install --force practicode
+```
 
-```python
-import sys
+## Safety
 
-print("debug", value, file=sys.stderr)
-```
+`/run` executes your local submission as a normal process. practicode runs it from `.practicode/build/<problem-id>/run`, but this is not an OS sandbox. Only run code you trust.
 
-## Development
+## Contributors
 
-```bash
-cargo test
-cargo run -- --smoke
-cargo run --
-```
+Development, release, problem-authoring, and design references live in [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md).
 
-The source is split by boring responsibility:
+## License
 
-| Path | Role |
-| --- | --- |
-| `src/core.rs` | Problem bank, state, rendering, judging |
-| `src/tui.rs` | Ratatui app, editor, command parser |
-| `src/ai.rs` | Codex/Claude command integration and notes |
-| `src/text.rs` | UTF-8 cursor math and Hangul composition |
-| `src/process.rs` | Process execution helpers |
-| `tests/` | Integration tests split by module |
-
-## Discovery Notes
-
-Recommended GitHub topics for this repo:
-`coding-practice`, `competitive-programming`, `algorithms`, `ratatui`, `tui`, `rust`, `codex`, `claude-code`, `local-first`.
-
-## References
-
-- Ratatui terminal UI library: https://ratatui.rs/
-- Crossterm terminal backend/events: https://github.com/crossterm-rs/crossterm
-- Codex CLI open-source repo: https://github.com/openai/codex
-- Claude Code CLI reference: https://docs.anthropic.com/en/docs/claude-code/cli-reference
-- Kattis problem package format: https://www.kattis.com/problem-package-format/
-- ICPC judging guidelines: https://icpc.global/regionals/regional-contest-cookbook-judging-guidelines
-- GitHub README image guidance: https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes
-- GitHub repository topics: https://docs.github.com/articles/classifying-your-repository-with-topics
+practicode is MIT licensed. Third-party dependency license notes are in [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md).

package/THIRD_PARTY_LICENSES.md

@@ -0,0 +1,58 @@
+# Third-Party Licenses
+
+This file summarizes third-party dependency license metadata for practicode
+0.1.0, checked from Cargo.lock and Cargo metadata.
+
+This is not legal advice.
+
+## Project License
+
+practicode is licensed under MIT. The current dependency set is compatible with
+that choice: all Rust dependencies use permissive licenses, and the npm package
+has no npm dependencies.
+
+## npm Dependencies
+
+None.
+
+## Direct Rust Dependencies
+
+| Crate | Version | License |
+| --- | --- | --- |
+| anyhow | 1.0.103 | MIT OR Apache-2.0 |
+| crossterm | 0.29.0 | MIT |
+| ratatui | 0.29.0 | MIT |
+| serde | 1.0.228 | MIT OR Apache-2.0 |
+| serde_json | 1.0.150 | MIT OR Apache-2.0 |
+| unicode-width | 0.2.0 | MIT OR Apache-2.0 |
+| wait-timeout | 0.2.1 | MIT/Apache-2.0 |
+
+## Transitive Rust Dependency License Groups
+
+The locked Rust dependency graph contains 87 third-party packages.
+
+| License expression | Packages |
+| --- | ---: |
+| MIT OR Apache-2.0 | 50 |
+| MIT | 20 |
+| MIT/Apache-2.0 | 5 |
+| Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT | 5 |
+| Apache-2.0 OR MIT | 1 |
+| Apache-2.0/MIT | 1 |
+| MIT / Apache-2.0 | 1 |
+| Unlicense OR MIT | 1 |
+| Zlib | 1 |
+| Apache-2.0 OR BSL-1.0 | 1 |
+| (MIT OR Apache-2.0) AND Unicode-3.0 | 1 |
+
+No GPL, LGPL, AGPL, or MPL dependencies were detected in the locked Rust
+dependency graph.
+
+## Release Notes
+
+The crates.io and npm packages distribute practicode source, not vendored
+third-party source or prebuilt third-party binaries. The npm installer builds
+the Rust binary locally with Cargo.
+
+If practicode later ships prebuilt binaries, include full third-party notices
+and license texts with those binary artifacts.

package/assets/i18n/en.json

@@ -0,0 +1,50 @@
+{
+  "problem": "Problem",
+  "output": "Output",
+  "command": "Command",
+  "commands": "Commands",
+  "difficulty": "Difficulty",
+  "topics": "Topics",
+  "input": "Input",
+  "examples": "Examples",
+  "example": "Example",
+  "answer": "Answer",
+  "source": "source",
+  "update": "update",
+  "command_placeholder": "Type /, move with up/down, Enter runs",
+  "palette_hint": "up/down select | Enter run | Esc cancel",
+  "hint_command": "Enter submit | Esc cancel",
+  "hint_list": "up/down move | Enter open | Esc close",
+  "hint_output": "Esc code | / command | ? help",
+  "hint_code": "Esc then / command",
+  "hint_idle": "/ command | ? help",
+  "help_title": "Help",
+  "daily_loop": "Daily loop",
+  "keys": "Keys",
+  "debug_prints": "Debug prints",
+  "cmd_run": "Judge the current submission",
+  "cmd_edit": "Return to the code editor",
+  "cmd_next": "Open the next problem",
+  "cmd_prev": "Open the previous problem",
+  "cmd_list": "Browse problems",
+  "cmd_open": "Open by number, id, or slug",
+  "cmd_giveup": "Show the reference answer",
+  "cmd_ai": "Ask AI about the current problem and code",
+  "cmd_provider": "Set AI provider",
+  "cmd_model": "Set AI model",
+  "cmd_note": "Add a next-problem note",
+  "cmd_notes": "Show saved notes",
+  "cmd_lang": "Set code language",
+  "cmd_ui": "Set UI language",
+  "cmd_theme": "Set theme",
+  "cmd_source": "Set next-problem source",
+  "cmd_update": "Show update instructions",
+  "cmd_help": "Open help",
+  "cmd_exit": "Quit",
+  "update_available": "Update available",
+  "update_none": "practicode is up to date.",
+  "update_check_disabled": "Update check is disabled.",
+  "update_check_failed": "Could not check for updates.",
+  "generating_next": "Generating next problem",
+  "already_busy": "Already busy."
+}

package/assets/i18n/es.json

@@ -0,0 +1,50 @@
+{
+  "problem": "Problema",
+  "output": "Salida",
+  "command": "Comando",
+  "commands": "Comandos",
+  "difficulty": "Dificultad",
+  "topics": "Temas",
+  "input": "Entrada",
+  "examples": "Ejemplos",
+  "example": "Ejemplo",
+  "answer": "Respuesta",
+  "source": "fuente",
+  "update": "actualizacion",
+  "command_placeholder": "Escribe /, elige con arriba/abajo, Enter ejecuta",
+  "palette_hint": "arriba/abajo elegir | Enter ejecutar | Esc cancelar",
+  "hint_command": "Enter ejecutar | Esc cancelar",
+  "hint_list": "arriba/abajo mover | Enter abrir | Esc cerrar",
+  "hint_output": "Esc codigo | / comando | ? ayuda",
+  "hint_code": "Esc y luego / comando",
+  "hint_idle": "/ comando | ? ayuda",
+  "help_title": "Ayuda",
+  "daily_loop": "Flujo diario",
+  "keys": "Teclas",
+  "debug_prints": "Salida de depuracion",
+  "cmd_run": "Evalua la solucion actual",
+  "cmd_edit": "Volver al editor de codigo",
+  "cmd_next": "Abrir el siguiente problema",
+  "cmd_prev": "Abrir el problema anterior",
+  "cmd_list": "Abrir la lista de problemas",
+  "cmd_open": "Abrir por numero, id o slug",
+  "cmd_giveup": "Mostrar la respuesta de referencia",
+  "cmd_ai": "Preguntar a AI sobre el problema y codigo actuales",
+  "cmd_provider": "Configurar AI provider",
+  "cmd_model": "Configurar AI model",
+  "cmd_note": "Agregar nota para generar problemas",
+  "cmd_notes": "Ver notas guardadas",
+  "cmd_lang": "Configurar lenguaje de codigo",
+  "cmd_ui": "Configurar idioma de UI",
+  "cmd_theme": "Configurar tema",
+  "cmd_source": "Configurar fuente del siguiente problema",
+  "cmd_update": "Mostrar instrucciones de actualizacion",
+  "cmd_help": "Abrir ayuda",
+  "cmd_exit": "Salir",
+  "update_available": "Hay una nueva version",
+  "update_none": "practicode esta actualizado.",
+  "update_check_disabled": "La comprobacion de actualizaciones esta desactivada.",
+  "update_check_failed": "No se pudo comprobar actualizaciones.",
+  "generating_next": "Generando el siguiente problema",
+  "already_busy": "Ya hay una tarea en curso."
+}

package/assets/i18n/ja.json

@@ -0,0 +1,50 @@
+{
+  "problem": "問題",
+  "output": "出力",
+  "command": "コマンド",
+  "commands": "コマンド",
+  "difficulty": "難易度",
+  "topics": "トピック",
+  "input": "入力",
+  "examples": "例",
+  "example": "例",
+  "answer": "解答",
+  "source": "source",
+  "update": "update",
+  "command_placeholder": "/ を入力し上下で選択、Enter で実行",
+  "palette_hint": "上下 選択 | Enter 実行 | Esc キャンセル",
+  "hint_command": "Enter 実行 | Esc キャンセル",
+  "hint_list": "上下 移動 | Enter 開く | Esc 閉じる",
+  "hint_output": "Esc コード | / コマンド | ? ヘルプ",
+  "hint_code": "Esc の後 / コマンド",
+  "hint_idle": "/ コマンド | ? ヘルプ",
+  "help_title": "ヘルプ",
+  "daily_loop": "基本フロー",
+  "keys": "キー",
+  "debug_prints": "デバッグ出力",
+  "cmd_run": "現在の提出を判定",
+  "cmd_edit": "コードエディタに戻る",
+  "cmd_next": "次の問題を開く",
+  "cmd_prev": "前の問題を開く",
+  "cmd_list": "問題一覧を開く",
+  "cmd_open": "番号、id、slug で問題を開く",
+  "cmd_giveup": "解答を見る",
+  "cmd_ai": "現在の問題とコードについて AI に質問",
+  "cmd_provider": "AI provider を設定",
+  "cmd_model": "AI model を設定",
+  "cmd_note": "次の問題生成メモを追加",
+  "cmd_notes": "保存済みメモを見る",
+  "cmd_lang": "コード言語を設定",
+  "cmd_ui": "UI 言語を設定",
+  "cmd_theme": "テーマを設定",
+  "cmd_source": "次の問題の取得元を設定",
+  "cmd_update": "更新手順を表示",
+  "cmd_help": "ヘルプを開く",
+  "cmd_exit": "終了",
+  "update_available": "新しいバージョンがあります",
+  "update_none": "practicode は最新です。",
+  "update_check_disabled": "更新確認は無効です。",
+  "update_check_failed": "更新を確認できませんでした。",
+  "generating_next": "次の問題を生成中",
+  "already_busy": "すでに処理中です。"
+}

package/assets/i18n/ko.json

@@ -0,0 +1,50 @@
+{
+  "problem": "문제",
+  "output": "출력",
+  "command": "명령",
+  "commands": "명령",
+  "difficulty": "난이도",
+  "topics": "주제",
+  "input": "입력",
+  "examples": "예시",
+  "example": "예시",
+  "answer": "정답",
+  "source": "출처",
+  "update": "업데이트",
+  "command_placeholder": "/ 입력 후 위/아래로 선택, Enter 실행",
+  "palette_hint": "위/아래 선택 | Enter 실행 | Esc 취소",
+  "hint_command": "Enter 실행 | Esc 취소",
+  "hint_list": "위/아래 이동 | Enter 열기 | Esc 닫기",
+  "hint_output": "Esc 코드 | / 명령 | ? 도움말",
+  "hint_code": "Esc 후 / 명령",
+  "hint_idle": "/ 명령 | ? 도움말",
+  "help_title": "도움말",
+  "daily_loop": "기본 흐름",
+  "keys": "키",
+  "debug_prints": "디버그 출력",
+  "cmd_run": "현재 제출을 채점",
+  "cmd_edit": "코드 편집기로 돌아가기",
+  "cmd_next": "다음 문제 열기",
+  "cmd_prev": "이전 문제 열기",
+  "cmd_list": "문제 목록 열기",
+  "cmd_open": "번호, id, slug로 문제 열기",
+  "cmd_giveup": "정답 보기",
+  "cmd_ai": "현재 문제와 코드에 대해 AI에게 질문",
+  "cmd_provider": "AI provider 설정",
+  "cmd_model": "AI model 설정",
+  "cmd_note": "다음 문제 생성 메모 추가",
+  "cmd_notes": "저장된 메모 보기",
+  "cmd_lang": "코드 언어 설정",
+  "cmd_ui": "UI 언어 설정",
+  "cmd_theme": "테마 설정",
+  "cmd_source": "다음 문제 출처 설정",
+  "cmd_update": "업데이트 안내 보기",
+  "cmd_help": "도움말 열기",
+  "cmd_exit": "종료",
+  "update_available": "새 버전 사용 가능",
+  "update_none": "practicode가 최신 버전입니다.",
+  "update_check_disabled": "업데이트 확인이 꺼져 있습니다.",
+  "update_check_failed": "업데이트를 확인할 수 없습니다.",
+  "generating_next": "다음 문제 생성 중",
+  "already_busy": "이미 작업 중입니다."
+}

package/assets/i18n/zh.json

@@ -0,0 +1,50 @@
+{
+  "problem": "题目",
+  "output": "输出",
+  "command": "命令",
+  "commands": "命令",
+  "difficulty": "难度",
+  "topics": "主题",
+  "input": "输入",
+  "examples": "示例",
+  "example": "示例",
+  "answer": "答案",
+  "source": "来源",
+  "update": "更新",
+  "command_placeholder": "输入 / 后用上下键选择，Enter 执行",
+  "palette_hint": "上下 选择 | Enter 执行 | Esc 取消",
+  "hint_command": "Enter 执行 | Esc 取消",
+  "hint_list": "上下 移动 | Enter 打开 | Esc 关闭",
+  "hint_output": "Esc 代码 | / 命令 | ? 帮助",
+  "hint_code": "Esc 后输入 / 命令",
+  "hint_idle": "/ 命令 | ? 帮助",
+  "help_title": "帮助",
+  "daily_loop": "日常流程",
+  "keys": "按键",
+  "debug_prints": "调试输出",
+  "cmd_run": "评测当前提交",
+  "cmd_edit": "回到代码编辑器",
+  "cmd_next": "打开下一题",
+  "cmd_prev": "打开上一题",
+  "cmd_list": "打开题目列表",
+  "cmd_open": "按编号、id 或 slug 打开题目",
+  "cmd_giveup": "显示参考答案",
+  "cmd_ai": "向 AI 询问当前题目和代码",
+  "cmd_provider": "设置 AI provider",
+  "cmd_model": "设置 AI model",
+  "cmd_note": "添加下次出题备注",
+  "cmd_notes": "查看保存的备注",
+  "cmd_lang": "设置代码语言",
+  "cmd_ui": "设置 UI 语言",
+  "cmd_theme": "设置主题",
+  "cmd_source": "设置下一题来源",
+  "cmd_update": "显示更新说明",
+  "cmd_help": "打开帮助",
+  "cmd_exit": "退出",
+  "update_available": "有新版本可用",
+  "update_none": "practicode 已是最新版本。",
+  "update_check_disabled": "更新检查已禁用。",
+  "update_check_failed": "无法检查更新。",
+  "generating_next": "正在生成下一题",
+  "already_busy": "已有任务正在运行。"
+}

package/docs/CONTRIBUTING.md

@@ -0,0 +1,81 @@
+# Contributing
+
+This repo is a Rust coding-practice workspace with a Ratatui terminal UI.
+
+## Prerequisites
+
+- Rust stable with Cargo, rustfmt, and clippy.
+- Node.js 18+ for the npm wrapper and package checks.
+- Optional local runtimes for judging: Python, Node.js, JDK, and Rust.
+
+## Development
+
+```bash
+cargo run --
+cargo run -- --smoke
+cargo test
+npm run smoke
+```
+
+Full local check:
+
+```bash
+make test
+```
+
+The source is split by boring responsibility:
+
+| Path | Role |
+| --- | --- |
+| `src/core.rs` | Problem storage, state, rendering, judging |
+| `src/i18n.rs` | Loads UI strings from `assets/i18n/*.json` |
+| `src/tui.rs` | Ratatui app, editor, command parser |
+| `src/ai.rs` | Codex/Claude command integration and notes |
+| `src/text.rs` | UTF-8 cursor math and Hangul composition |
+| `src/process.rs` | Process execution helpers |
+| `tests/` | Integration tests split by module |
+
+## Problem Authoring
+
+AI generation reads [problem-authoring-notes.md](problem-authoring-notes.md) every time it creates a problem.
+
+Local generated data stays ignored by git:
+
+| Path | Purpose |
+| --- | --- |
+| `.practicode/problem_bank.json` | Local/custom/generated problems |
+| `.practicode/problem_notes.md` | Personal problem-generation notes |
+| `.practicode/problem-state.json` | Current problem, history, settings |
+| `problems/` | Generated problem markdown/index files |
+| `submissions/` | Local answer files |
+
+## Release
+
+`main` runs CI only. Releases are tag-based and publish to crates.io and npm through GitHub Actions.
+
+```bash
+make release VERSION=0.1.1
+```
+
+The release script checks versions, runs tests, creates the version commit and tag, and pushes `main` plus the tag. Do not print or commit tokens; GitHub Actions uses repository secrets.
+
+## Documentation
+
+Keep the root [README](../README.md) focused on users. Put contributor workflow, implementation notes, release notes, and design references here or in nearby `docs/` files.
+
+Use relative links for repo-local docs and assets. The terminal screenshot is stored at [assets/practicode-terminal.svg](../assets/practicode-terminal.svg).
+
+## Localization
+
+UI strings live in [assets/i18n](../assets/i18n). Keep English complete first; other locales can be partial because the runtime falls back per key to English.
+
+## UX And Documentation References
+
+- WAI-ARIA combobox keyboard interaction: https://www.w3.org/WAI/ARIA/apg/patterns/combobox/
+- Command Line Interface Guidelines: https://clig.dev/
+- GitHub README guidance: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes
+- GitHub relative links and images: https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#relative-links
+- Ratatui terminal UI library: https://ratatui.rs/
+- Crossterm terminal backend/events: https://github.com/crossterm-rs/crossterm
+- Kattis problem package format: https://www.kattis.com/problem-package-format/
+- ICPC judging guidelines: https://icpc.global/regionals/regional-contest-cookbook-judging-guidelines

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "practicode",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local-first coding-test practice in a Rust terminal UI with optional AI help.",
   "license": "MIT",
   "repository": {
@@ -12,6 +12,7 @@
     "practicode": "bin/practicode.js"
   },
   "scripts": {
+    "start": "node bin/practicode.js",
     "build": "cargo build --release --locked",
     "postinstall": "node scripts/npm-postinstall.js",
     "smoke": "node bin/practicode.js --smoke"
@@ -25,7 +26,8 @@
     "Cargo.lock",
     "Cargo.toml",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "THIRD_PARTY_LICENSES.md"
   ],
   "keywords": [
     "algorithms",