practicode 0.1.5 → 0.1.6

package/Cargo.lock

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

package/Cargo.toml

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

package/README.md

@@ -66,24 +66,30 @@ Submissions are saved as you type under `submissions/<problem-id>/solution.<ext>
 | `/code` | Return to the code editor |
 | `/next` | Open the next local problem, or ask AI to create one |
 | `/next easy string problem` | Ask AI for a custom next problem |
-| `/prev` | Go back through problem history |
-| `/list` | Browse problems with `up/down` or `j/k`, open with `Enter` |
+| `/back` | Go back through problem history |
+| `/problems` | Browse problems with `up/down` or `j/k`, open with `Enter` |
 | `/open 2` | Open by number, id, or slug |
-| `/giveup` | Show the reference answer |
+| `/answer` | Show the reference answer |
 | `/hint` | Ask the selected AI for a concise hint |
 | `/hint explain my bug` | Ask the selected AI about the current problem and submission |
+| `/profile` | Show your current practice profile |
+| `/difficulty auto` | Set difficulty preference: `auto`, `easy`, `medium`, `hard` |
+| `/topics arrays, strings` | Set preferred topics for future problems |
+| `/avoid dp, graph` | Set topics to avoid in future problems |
 | `/provider codex` | Set AI provider and show local CLI/daemon status |
 | `/model auto` | Use the provider default model for `/hint` 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 code language: `python`, `ts`, `java`, `rust` |
+| `/language 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` |
 | `/update` | Show update instructions when a newer version is available |
 | `/exit` | Quit |
 
+Older command names such as `/prev`, `/list`, `/giveup`, and `/lang` still work as aliases.
+
 The default UI language is English. Switch it any time with `/ui ko`, `/ui ja`, `/ui zh`, or `/ui es`.
 
+Your practice profile is saved in `.practicode/problem-state.json`. It keeps UI language, code language, theme, preferred difficulty, preferred topics, and topics to avoid. `auto` difficulty follows gradual progression; a fixed difficulty asks local selection and AI generation to prefer that level.
+
 ## AI Problems
 
 `/next <request>` passes your request into the selected AI problem generator.
@@ -139,6 +145,8 @@ External contributions use the fork and pull request flow in [docs/CONTRIBUTING.
 
 Maintainer-only review and release notes live in [docs/MAINTAINING.md](docs/MAINTAINING.md).
 
+Code layout and extension boundaries live in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
+
 ## License
 
 practicode is MIT licensed. Third-party dependency license notes are in [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md).

package/assets/i18n/en.json

@@ -32,6 +32,10 @@
   "cmd_giveup": "Show the reference answer",
   "cmd_hint": "Ask for a hint about the current problem",
   "cmd_ai": "Ask AI about the current problem and code",
+  "cmd_profile": "Show practice profile",
+  "cmd_difficulty": "Set preferred difficulty",
+  "cmd_topics": "Set preferred topics",
+  "cmd_avoid": "Set topics to avoid",
   "cmd_provider": "Set AI provider",
   "cmd_model": "Set AI model",
   "cmd_model_auto": "Use provider default model",

package/assets/i18n/es.json

@@ -32,6 +32,10 @@
   "cmd_giveup": "Mostrar la respuesta de referencia",
   "cmd_hint": "Pedir una pista para el problema actual",
   "cmd_ai": "Preguntar a AI sobre el problema y codigo actuales",
+  "cmd_profile": "Mostrar perfil de practica",
+  "cmd_difficulty": "Configurar dificultad preferida",
+  "cmd_topics": "Configurar temas preferidos",
+  "cmd_avoid": "Configurar temas a evitar",
   "cmd_provider": "Configurar AI provider",
   "cmd_model": "Configurar AI model",
   "cmd_model_auto": "Usar el modelo predeterminado del provider",

package/assets/i18n/ja.json

@@ -32,6 +32,10 @@
   "cmd_giveup": "解答を見る",
   "cmd_hint": "現在の問題のヒントを依頼",
   "cmd_ai": "現在の問題とコードについて AI に質問",
+  "cmd_profile": "練習プロファイルを表示",
+  "cmd_difficulty": "希望難易度を設定",
+  "cmd_topics": "希望トピックを設定",
+  "cmd_avoid": "避けるトピックを設定",
   "cmd_provider": "AI provider を設定",
   "cmd_model": "AI model を設定",
   "cmd_model_auto": "provider の既定モデルを使用",

package/assets/i18n/ko.json

@@ -32,6 +32,10 @@
   "cmd_giveup": "정답 보기",
   "cmd_hint": "현재 문제 힌트 요청",
   "cmd_ai": "현재 문제와 코드에 대해 AI에게 질문",
+  "cmd_profile": "연습 프로파일 보기",
+  "cmd_difficulty": "선호 난이도 설정",
+  "cmd_topics": "선호 주제 설정",
+  "cmd_avoid": "피할 주제 설정",
   "cmd_provider": "AI provider 설정",
   "cmd_model": "AI model 설정",
   "cmd_model_auto": "provider 기본 모델 사용",

package/assets/i18n/zh.json

@@ -32,6 +32,10 @@
   "cmd_giveup": "显示参考答案",
   "cmd_hint": "请求当前题目的提示",
   "cmd_ai": "向 AI 询问当前题目和代码",
+  "cmd_profile": "显示练习配置",
+  "cmd_difficulty": "设置偏好难度",
+  "cmd_topics": "设置偏好主题",
+  "cmd_avoid": "设置要避开的主题",
   "cmd_provider": "设置 AI provider",
   "cmd_model": "设置 AI model",
   "cmd_model_auto": "使用 provider 默认模型",

package/assets/practicode-terminal.svg

@@ -1,24 +1,36 @@
 <svg width="1200" height="720" viewBox="0 0 1200 720" fill="none" xmlns="http://www.w3.org/2000/svg">
   <rect width="1200" height="720" fill="#070b12"/>
-  <rect x="64" y="52" width="1072" height="616" rx="10" fill="#0b111a" stroke="#1f6f7a" stroke-width="2"/>
-  <rect x="88" y="78" width="594" height="440" rx="4" fill="#0f1720" stroke="#00c2d1" stroke-width="2"/>
-  <rect x="704" y="78" width="408" height="440" rx="4" fill="#0d141c" stroke="#31536b" stroke-width="2"/>
-  <text x="112" y="112" fill="#d7e1ec" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="700">Problem</text>
-  <text x="728" y="112" fill="#d7e1ec" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="700">solution.py</text>
-  <text x="112" y="158" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="22" font-weight="700">001. Hello World</text>
-  <text x="112" y="204" fill="#c8d3f5" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="16">Difficulty: easy</text>
-  <text x="112" y="232" fill="#c8d3f5" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="16">Topics: io</text>
-  <text x="112" y="286" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17">Print exactly Hello, World! to stdout.</text>
-  <text x="112" y="352" fill="#00a8ff" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17" text-decoration="underline">Input</text>
-  <text x="112" y="386" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17">No input.</text>
-  <text x="112" y="442" fill="#00a8ff" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17" text-decoration="underline">Output</text>
-  <text x="112" y="476" fill="#f6c177" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17">Hello, World!</text>
-  <text x="728" y="158" fill="#6b7280" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17">  1</text>
-  <text x="776" y="158" fill="#7dd3fc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17">print</text>
-  <text x="828" y="158" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17">('Hello, World!')</text>
-  <rect x="64" y="536" width="1072" height="28" fill="#152033"/>
-  <text x="84" y="556" fill="#c8d3f5" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="15" font-weight="700">PRACTICODE | 001-hello-world | easy | idle | solved | code:written | python | next:ai | ai:codex/auto</text>
-  <rect x="64" y="586" width="1072" height="58" rx="2" fill="#0b1017" stroke="#008cff" stroke-width="2"/>
-  <text x="84" y="606" fill="#c8d3f5" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="15" font-weight="700">Command</text>
-  <text x="84" y="630" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="18">/ai hint about edge cases</text>
+  <rect x="54" y="42" width="1092" height="636" rx="10" fill="#0b111a" stroke="#214c5c" stroke-width="2"/>
+
+  <rect x="76" y="68" width="560" height="430" rx="4" fill="#0f1720" stroke="#00c2d1" stroke-width="2"/>
+  <rect x="664" y="68" width="458" height="430" rx="4" fill="#0d141c" stroke="#f8e71c" stroke-width="2"/>
+
+  <text x="92" y="91" fill="#16d6e8" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="15" font-weight="700">Problem</text>
+  <text x="680" y="91" fill="#f8e71c" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="15" font-weight="700">&gt; solution.py</text>
+
+  <text x="96" y="128" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="22" font-weight="700">001. Hello World</text>
+  <text x="96" y="164" fill="#c8d3f5" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="16">Difficulty: easy    Topics: io</text>
+  <text x="96" y="206" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17">Print exactly Hello, World! to stdout.</text>
+
+  <text x="96" y="286" fill="#00d2e8" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17" font-weight="700">Input</text>
+  <rect x="96" y="304" width="486" height="44" rx="3" fill="#101d28" stroke="#29495a"/>
+  <text x="112" y="332" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="16">No input.</text>
+
+  <text x="96" y="388" fill="#00d2e8" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="17" font-weight="700">Output</text>
+  <rect x="96" y="406" width="486" height="66" rx="3" fill="#101d28" stroke="#29495a"/>
+  <text x="112" y="446" fill="#f6c177" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="16">Hello, World!</text>
+
+  <text x="690" y="128" fill="#64748b" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="16">  1</text>
+  <text x="738" y="128" fill="#7dd3fc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="16">print</text>
+  <text x="790" y="128" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="16">('Hello, World!')</text>
+
+  <rect x="76" y="512" width="1046" height="30" fill="#152033"/>
+  <text x="94" y="533" fill="#c8d3f5" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="15" font-weight="700">PRACTICODE | 001-hello-world | easy | idle | assigned | code:written | python | Esc then / command</text>
+
+  <rect x="76" y="558" width="1046" height="48" rx="2" fill="#0b1017" stroke="#00c2d1" stroke-width="2"/>
+  <text x="94" y="579" fill="#16d6e8" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="15" font-weight="700">Command</text>
+  <text x="94" y="596" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="18">/</text>
+
+  <rect x="76" y="614" width="1046" height="46" rx="2" fill="#101923" stroke="#214c5c"/>
+  <text x="94" y="641" fill="#f8fafc" font-family="SFMono-Regular, Menlo, Consolas, monospace" font-size="15">/run  /next  /hint &lt;request&gt;  /profile  /difficulty auto  /topics arrays, strings</text>
 </svg>

package/docs/ARCHITECTURE.md

@@ -0,0 +1,25 @@
+# Architecture
+
+Practicode is local-first: user data stays under `.practicode/`, `problems/`, and `submissions/`.
+
+## Source Layout
+
+- `src/core.rs` owns problem data, state loading/saving, judging, and file generation.
+- `src/core/profile.rs` owns practice-profile defaults and normalization.
+- `src/tui.rs` owns Ratatui rendering and interaction flow.
+- `src/tui/commands.rs` owns the command palette catalog.
+- `src/ai.rs` owns provider commands, daemon/model checks, and AI prompts.
+- `src/update.rs` owns update checks.
+- `src/text.rs` owns terminal text editing and markdown/plain rendering helpers.
+
+## Extension Rules
+
+- Add domain logic under the owning module first; keep `tui.rs` as orchestration and rendering.
+- Add user-visible commands in `src/tui/commands.rs`, then route behavior in `PracticodeApp::handle_command`.
+- Add persisted profile settings to `Settings`, normalize them in `normalize_settings`, and cover old-state compatibility with tests.
+- Keep provider-specific behavior in `src/ai.rs`; TUI should ask for status or start tasks, not know provider internals.
+- Keep local user data backwards-compatible. Missing fields should default cleanly.
+
+## Release
+
+See [MAINTAINING.md](MAINTAINING.md) for tag-based releases.

package/docs/CONTRIBUTING.md

@@ -9,6 +9,7 @@ Maintainer-only review and release steps live in [MAINTAINING.md](MAINTAINING.md
 - Search existing issues and pull requests first.
 - Small bug fixes, docs fixes, tests, and localization updates can go straight to a pull request.
 - For larger UI, AI-generation, storage, or packaging changes, open an issue first so the scope is clear.
+- Check [ARCHITECTURE.md](ARCHITECTURE.md) before adding commands, settings, provider behavior, or persisted state.
 - Do not commit local practice data from `.practicode/`, `problems/`, or `submissions/`.
 - Do not include secrets, tokens, private prompts, or generated answer keys in docs or examples.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "practicode",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Local-first coding-test practice in a Rust terminal UI with optional AI help.",
   "license": "MIT",
   "repository": {

package/src/ai.rs

@@ -123,13 +123,22 @@ pub fn available_models(provider: &str) -> ModelCatalog {
 }
 
 pub fn default_ai_next_prompt(request: &str) -> String {
+    default_ai_next_prompt_with_settings(&Settings::default(), request)
+}
+
+pub fn default_ai_next_prompt_with_settings(settings: &Settings, request: &str) -> String {
     format!(
-        "Read AGENTS.md, docs/problem-authoring-notes.md if present, .practicode/problem_notes.md if present, problems/INDEX.md if present, .practicode/problem_bank.json if present, and .practicode/problem-state.json. Create exactly one new non-duplicate coding practice problem. The built-in 001-hello-world already exists, so do not duplicate it. User request: {}. Make the smallest valid edits: update .practicode/problem_bank.json, one problem directory, problems/INDEX.md, and .practicode/problem-state.json. Do not include the answer in the problem statement.",
+        "Read AGENTS.md, docs/problem-authoring-notes.md if present, .practicode/problem_notes.md if present, problems/INDEX.md if present, .practicode/problem_bank.json if present, and .practicode/problem-state.json. Create exactly one new non-duplicate coding practice problem. The built-in 001-hello-world already exists, so do not duplicate it. User request: {}. Practice profile: difficulty preference: {}; preferred topics: {}; avoid topics: {}; code language: {}; UI language: {}. Treat difficulty auto as gradual progression from state; otherwise prefer the requested difficulty unless the direct user request conflicts. Make the smallest valid edits: update .practicode/problem_bank.json, one problem directory, problems/INDEX.md, and .practicode/problem-state.json. Do not include the answer in the problem statement.",
         if request.is_empty() {
             "(none)"
         } else {
             request
-        }
+        },
+        settings.difficulty,
+        list_or_none(&settings.topics),
+        list_or_none(&settings.avoid_topics),
+        settings.language,
+        settings.ui_language
     )
 }
 
@@ -304,7 +313,9 @@ fn default_codex_next_command(root: &Path, settings: &Settings, request: &str) -
         exec.push_str(&format!(" --model {}", sh_quote(model)));
     }
     exec.push(' ');
-    exec.push_str(&sh_quote(&default_ai_next_prompt(request)));
+    exec.push_str(&sh_quote(&default_ai_next_prompt_with_settings(
+        settings, request,
+    )));
     format!("{start}; {exec}")
 }
 
@@ -322,7 +333,9 @@ fn default_claude_next_command(root: &Path, settings: &Settings, request: &str)
         claude.push_str(&format!(" --model {}", sh_quote(model)));
     }
     claude.push_str(" -p ");
-    claude.push_str(&sh_quote(&default_ai_next_prompt(request)));
+    claude.push_str(&sh_quote(&default_ai_next_prompt_with_settings(
+        settings, request,
+    )));
     format!(
         "claude daemon status >/dev/null 2>&1 || true; cd {}; {}",
         sh_quote(&root.display().to_string()),
@@ -338,6 +351,14 @@ fn output_text(stdout: &str, stderr: &str) -> String {
         .join("\n")
 }
 
+fn list_or_none(values: &[String]) -> String {
+    if values.is_empty() {
+        "(none)".to_string()
+    } else {
+        values.join(", ")
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use super::parse_model_list;

package/src/core/profile.rs

@@ -0,0 +1,29 @@
+pub const DIFFICULTIES: &[&str] = &["auto", "easy", "medium", "hard"];
+
+pub fn default_difficulty() -> String {
+    "auto".to_string()
+}
+
+pub fn normalize_difficulty(difficulty: &str) -> String {
+    let difficulty = difficulty.trim().to_lowercase();
+    if DIFFICULTIES.contains(&difficulty.as_str()) {
+        difficulty
+    } else {
+        default_difficulty()
+    }
+}
+
+pub fn parse_topic_list(value: &str) -> Vec<String> {
+    let mut topics = Vec::new();
+    for topic in value.split(',') {
+        let topic = topic.trim().trim_start_matches('#').trim().to_lowercase();
+        if !topic.is_empty() && !topics.contains(&topic) {
+            topics.push(topic);
+        }
+    }
+    topics
+}
+
+pub fn normalize_topic_list(topics: &[String]) -> Vec<String> {
+    parse_topic_list(&topics.join(","))
+}

package/src/core.rs

@@ -9,6 +9,11 @@ use std::{
     time::Duration,
 };
 
+mod profile;
+pub use profile::{
+    DIFFICULTIES, default_difficulty, normalize_difficulty, normalize_topic_list, parse_topic_list,
+};
+
 pub const LANGUAGES: &[&str] = &["python", "ts", "java", "rust"];
 pub use crate::i18n::{UI_LANGUAGES, normalize_ui_language, ui_text};
 pub const THEMES: &[&str] = &["dark", "light"];
@@ -25,6 +30,12 @@ pub struct Settings {
     pub ui_language: String,
     #[serde(default = "default_theme")]
     pub theme: String,
+    #[serde(default = "default_difficulty")]
+    pub difficulty: String,
+    #[serde(default, skip_serializing_if = "Vec::is_empty")]
+    pub topics: Vec<String>,
+    #[serde(default, skip_serializing_if = "Vec::is_empty")]
+    pub avoid_topics: Vec<String>,
     #[serde(default = "default_editor")]
     pub editor: String,
     #[serde(default = "default_next_source")]
@@ -43,6 +54,9 @@ impl Default for Settings {
             language: default_language(),
             ui_language: default_ui_language(),
             theme: default_theme(),
+            difficulty: default_difficulty(),
+            topics: Vec::new(),
+            avoid_topics: Vec::new(),
             editor: default_editor(),
             next_source: default_next_source(),
             ai_provider: default_ai_provider(),
@@ -364,6 +378,9 @@ pub fn normalize_settings(settings: &mut Settings) {
     if !THEMES.contains(&settings.theme.as_str()) {
         settings.theme = "dark".to_string();
     }
+    settings.difficulty = normalize_difficulty(&settings.difficulty);
+    settings.topics = normalize_topic_list(&settings.topics);
+    settings.avoid_topics = normalize_topic_list(&settings.avoid_topics);
     settings.next_source = normalize_next_source(&settings.next_source);
     settings.ai_provider = normalize_ai_provider(&settings.ai_provider);
     if settings.ai_model.trim().is_empty() {
@@ -376,8 +393,9 @@ pub fn problem_by_id<'a>(bank: &'a [Problem], problem_id: &str) -> Option<&'a Pr
 }
 
 pub fn normalize_language(language: &str) -> String {
-    if LANGUAGES.contains(&language) {
-        language.to_string()
+    let language = language.trim().to_lowercase();
+    if LANGUAGES.contains(&language.as_str()) {
+        language
     } else {
         "python".to_string()
     }
@@ -756,7 +774,11 @@ pub fn next_problem(
         .iter()
         .map(|item| item.id.as_str())
         .collect::<Vec<_>>();
-    let preferred = &state.suggested_next_difficulty;
+    let preferred = if state.settings.difficulty == "auto" {
+        &state.suggested_next_difficulty
+    } else {
+        &state.settings.difficulty
+    };
     let problem = bank
         .iter()
         .find(|item| !seen.contains(&item.id.as_str()) && &item.difficulty == preferred)

package/src/tui/commands.rs

@@ -0,0 +1,242 @@
+#[derive(Clone, Copy)]
+pub(super) struct CommandHint {
+    pub(super) insert: &'static str,
+    pub(super) display: &'static str,
+    pub(super) desc_key: &'static str,
+    pub(super) keep_open: bool,
+    pub(super) help: bool,
+}
+
+pub(super) const COMMAND_HINTS: &[CommandHint] = &[
+    CommandHint {
+        insert: "run",
+        display: "/run",
+        desc_key: "cmd_run",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "code",
+        display: "/code",
+        desc_key: "cmd_code",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "next",
+        display: "/next",
+        desc_key: "cmd_next",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "back",
+        display: "/back",
+        desc_key: "cmd_prev",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "problems",
+        display: "/problems",
+        desc_key: "cmd_list",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "open ",
+        display: "/open <id>",
+        desc_key: "cmd_open",
+        keep_open: true,
+        help: true,
+    },
+    CommandHint {
+        insert: "answer",
+        display: "/answer",
+        desc_key: "cmd_giveup",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "hint ",
+        display: "/hint <request>",
+        desc_key: "cmd_hint",
+        keep_open: true,
+        help: true,
+    },
+    CommandHint {
+        insert: "profile",
+        display: "/profile",
+        desc_key: "cmd_profile",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "difficulty auto",
+        display: "/difficulty auto",
+        desc_key: "cmd_difficulty",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "difficulty easy",
+        display: "/difficulty easy",
+        desc_key: "cmd_difficulty",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "difficulty medium",
+        display: "/difficulty medium",
+        desc_key: "cmd_difficulty",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "difficulty hard",
+        display: "/difficulty hard",
+        desc_key: "cmd_difficulty",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "topics ",
+        display: "/topics <list>",
+        desc_key: "cmd_topics",
+        keep_open: true,
+        help: true,
+    },
+    CommandHint {
+        insert: "avoid ",
+        display: "/avoid <list>",
+        desc_key: "cmd_avoid",
+        keep_open: true,
+        help: true,
+    },
+    CommandHint {
+        insert: "provider codex",
+        display: "/provider codex",
+        desc_key: "cmd_provider",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "provider claude",
+        display: "/provider claude",
+        desc_key: "cmd_provider",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "model auto",
+        display: "/model auto",
+        desc_key: "cmd_model_auto",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "model ",
+        display: "/model <name>",
+        desc_key: "cmd_model_custom",
+        keep_open: true,
+        help: false,
+    },
+    CommandHint {
+        insert: "language python",
+        display: "/language python",
+        desc_key: "cmd_lang",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "language ts",
+        display: "/language ts",
+        desc_key: "cmd_lang",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "language java",
+        display: "/language java",
+        desc_key: "cmd_lang",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "language rust",
+        display: "/language rust",
+        desc_key: "cmd_lang",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "ui en",
+        display: "/ui en",
+        desc_key: "cmd_ui",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "ui ko",
+        display: "/ui ko",
+        desc_key: "cmd_ui",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "ui ja",
+        display: "/ui ja",
+        desc_key: "cmd_ui",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "ui zh",
+        display: "/ui zh",
+        desc_key: "cmd_ui",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "ui es",
+        display: "/ui es",
+        desc_key: "cmd_ui",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "theme dark",
+        display: "/theme dark",
+        desc_key: "cmd_theme",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "theme light",
+        display: "/theme light",
+        desc_key: "cmd_theme",
+        keep_open: false,
+        help: false,
+    },
+    CommandHint {
+        insert: "update",
+        display: "/update",
+        desc_key: "cmd_update",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "help",
+        display: "/help",
+        desc_key: "cmd_help",
+        keep_open: false,
+        help: true,
+    },
+    CommandHint {
+        insert: "exit",
+        display: "/exit",
+        desc_key: "cmd_exit",
+        keep_open: false,
+        help: true,
+    },
+];

package/src/tui.rs

@@ -4,11 +4,12 @@ use crate::{
         run_ai_next, run_ai_prompt,
     },
     core::{
-        AI_PROVIDERS, AppState, HistoryItem, LANGUAGES, PROBLEM_NOTES_PATH, Problem, THEMES,
-        UI_LANGUAGES, ensure_problem_files, ensure_submission, ext_for, give_up, judge, load_bank,
-        load_state, localized, next_problem, normalize_ai_provider, normalize_language,
-        normalize_next_source, normalize_ui_language, previous_problem, problem_by_id, record_pass,
-        save_state, template_for, ui_text,
+        AI_PROVIDERS, AppState, DIFFICULTIES, HistoryItem, LANGUAGES, PROBLEM_NOTES_PATH, Problem,
+        THEMES, UI_LANGUAGES, ensure_problem_files, ensure_submission, ext_for, give_up, judge,
+        load_bank, load_state, localized, next_problem, normalize_ai_provider,
+        normalize_difficulty, normalize_language, normalize_next_source, normalize_ui_language,
+        parse_topic_list, previous_problem, problem_by_id, record_pass, save_state, template_for,
+        ui_text,
     },
     text::{
         byte_index, char_len, compose_hangul_jamo, display_width, prefix, render_markdown_plain,
@@ -33,17 +34,13 @@ use std::{
     path::PathBuf,
     sync::mpsc::{self, Receiver},
     thread,
-    time::Duration,
+    time::{Duration, Instant},
 };
 
-#[derive(Clone, Copy)]
-struct CommandHint {
-    insert: &'static str,
-    display: &'static str,
-    desc_key: &'static str,
-    keep_open: bool,
-    help: bool,
-}
+mod commands;
+use self::commands::COMMAND_HINTS;
+
+const UPDATE_CHECK_INTERVAL: Duration = Duration::from_secs(30 * 60);
 
 #[derive(Clone)]
 struct CommandChoice {
@@ -53,205 +50,6 @@ struct CommandChoice {
     keep_open: bool,
 }
 
-const COMMAND_HINTS: &[CommandHint] = &[
-    CommandHint {
-        insert: "run",
-        display: "/run",
-        desc_key: "cmd_run",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "code",
-        display: "/code",
-        desc_key: "cmd_code",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "next",
-        display: "/next",
-        desc_key: "cmd_next",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "prev",
-        display: "/prev",
-        desc_key: "cmd_prev",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "list",
-        display: "/list",
-        desc_key: "cmd_list",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "open ",
-        display: "/open <id>",
-        desc_key: "cmd_open",
-        keep_open: true,
-        help: true,
-    },
-    CommandHint {
-        insert: "giveup",
-        display: "/giveup",
-        desc_key: "cmd_giveup",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "hint ",
-        display: "/hint <request>",
-        desc_key: "cmd_hint",
-        keep_open: true,
-        help: true,
-    },
-    CommandHint {
-        insert: "provider codex",
-        display: "/provider codex",
-        desc_key: "cmd_provider",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "provider claude",
-        display: "/provider claude",
-        desc_key: "cmd_provider",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "model auto",
-        display: "/model auto",
-        desc_key: "cmd_model_auto",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "model ",
-        display: "/model <name>",
-        desc_key: "cmd_model_custom",
-        keep_open: true,
-        help: false,
-    },
-    CommandHint {
-        insert: "note ",
-        display: "/note <text>",
-        desc_key: "cmd_note",
-        keep_open: true,
-        help: true,
-    },
-    CommandHint {
-        insert: "notes",
-        display: "/notes",
-        desc_key: "cmd_notes",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "lang python",
-        display: "/lang python",
-        desc_key: "cmd_lang",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "lang ts",
-        display: "/lang ts",
-        desc_key: "cmd_lang",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "lang java",
-        display: "/lang java",
-        desc_key: "cmd_lang",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "lang rust",
-        display: "/lang rust",
-        desc_key: "cmd_lang",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "ui en",
-        display: "/ui en",
-        desc_key: "cmd_ui",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "ui ko",
-        display: "/ui ko",
-        desc_key: "cmd_ui",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "ui ja",
-        display: "/ui ja",
-        desc_key: "cmd_ui",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "ui zh",
-        display: "/ui zh",
-        desc_key: "cmd_ui",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "ui es",
-        display: "/ui es",
-        desc_key: "cmd_ui",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "theme dark",
-        display: "/theme dark",
-        desc_key: "cmd_theme",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "theme light",
-        display: "/theme light",
-        desc_key: "cmd_theme",
-        keep_open: false,
-        help: false,
-    },
-    CommandHint {
-        insert: "update",
-        display: "/update",
-        desc_key: "cmd_update",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "help",
-        display: "/help",
-        desc_key: "cmd_help",
-        keep_open: false,
-        help: true,
-    },
-    CommandHint {
-        insert: "exit",
-        display: "/exit",
-        desc_key: "cmd_exit",
-        keep_open: false,
-        help: true,
-    },
-];
-
 #[derive(Clone, Copy, Debug, Eq, PartialEq)]
 enum Focus {
     Code,
@@ -286,6 +84,7 @@ pub struct PracticodeApp {
     model_message: Option<String>,
     update_check: Option<UpdateCheck>,
     update_notice: Option<String>,
+    last_update_check: Option<Instant>,
     code_area: Rect,
     output_area: Rect,
     command_area: Rect,
@@ -334,6 +133,7 @@ impl PracticodeApp {
             model_message: None,
             update_check: None,
             update_notice: None,
+            last_update_check: None,
             code_area: Rect::default(),
             output_area: Rect::default(),
             command_area: Rect::default(),
@@ -350,6 +150,7 @@ impl PracticodeApp {
             terminal.draw(|frame| self.draw(frame))?;
             self.check_task();
             self.check_update();
+            self.maybe_start_periodic_update_check();
             self.start_model_check();
             self.check_models();
             if event::poll(Duration::from_millis(100))? {
@@ -360,7 +161,7 @@ impl PracticodeApp {
                 }
             }
             if !self.busy_label.is_empty() {
-                self.busy_frame = (self.busy_frame + 1) % 16;
+                self.busy_frame = (self.busy_frame + 1) % 32;
             }
         }
         self.save_code().ok();
@@ -971,23 +772,31 @@ impl PracticodeApp {
         }
         let (command, arg) = value.split_once(char::is_whitespace).unwrap_or((value, ""));
         let arg = arg.trim();
-        if command != "list" {
+        if !matches!(command, "list" | "problems") {
             self.list_cursor = None;
         }
         match command {
             "run" | "r" => self.action_run()?,
             "code" | "edit" | "e" => self.action_edit()?,
             "next" | "n" => self.action_next(arg)?,
-            "prev" | "previous" | "p" => self.action_previous()?,
-            "giveup" | "give" | "g" => self.action_give_up()?,
-            "list" => self.start_problem_list(),
+            "back" | "prev" | "previous" | "p" => self.action_previous()?,
+            "answer" | "giveup" | "give" | "g" => self.action_give_up()?,
+            "problems" | "list" => self.start_problem_list(),
             "open" | "o" if !arg.is_empty() => self.open_problem(arg)?,
-            "lang" if arg.is_empty() => self.action_cycle_language()?,
-            "lang" if LANGUAGES.contains(&arg) => self.set_language(arg)?,
+            "language" | "lang" if arg.is_empty() => self.action_cycle_language()?,
+            "language" | "lang" if LANGUAGES.contains(&arg) => self.set_language(arg)?,
             "ui" if arg.is_empty() => self.action_toggle_ui_language()?,
             "ui" => self.set_ui_language(&normalize_ui_language(arg))?,
             "theme" if arg.is_empty() => self.action_toggle_theme()?,
             "theme" if THEMES.contains(&arg) => self.set_theme(arg)?,
+            "profile" | "settings" if arg.is_empty() => self.show_profile(),
+            "profile" | "settings" if arg == "reset" => self.reset_profile()?,
+            "difficulty" | "level" if arg.is_empty() => self.show_profile(),
+            "difficulty" | "level" => self.set_difficulty(arg)?,
+            "topics" | "topic" if arg.is_empty() => self.show_profile(),
+            "topics" | "topic" => self.set_topics(arg, false)?,
+            "avoid" | "skip" if arg.is_empty() => self.show_profile(),
+            "avoid" | "skip" => self.set_topics(arg, true)?,
             "source" | "next-source" if arg.is_empty() => {
                 self.write_text_output(&self.next_source_help());
             }
@@ -1044,7 +853,7 @@ impl PracticodeApp {
             "hint" | "ask" | "ai" if !arg.is_empty() => self.start_ai_prompt(arg)?,
             "note" if !arg.is_empty() => self.append_note(arg)?,
             "note" | "notes" => self.show_notes()?,
-            "update" => self.show_update_notice(),
+            "update" => self.refresh_update_notice(),
             "exit" | "quit" | "q" => self.should_quit = true,
             _ => self.write_text_output(&format!("Unknown command: {value}\nTry /help.")),
         }
@@ -1225,6 +1034,68 @@ impl PracticodeApp {
         Ok(())
     }
 
+    fn set_difficulty(&mut self, difficulty: &str) -> Result<()> {
+        let difficulty = difficulty.trim().to_lowercase();
+        if !DIFFICULTIES.contains(&difficulty.as_str()) {
+            self.write_text_output("Difficulty: auto, easy, medium, or hard.");
+            return Ok(());
+        }
+        let normalized = normalize_difficulty(&difficulty);
+        self.state.settings.difficulty = normalized.clone();
+        if normalized != "auto" {
+            self.state.suggested_next_difficulty = normalized;
+        }
+        save_state(&self.root, &self.state)?;
+        self.show_profile();
+        Ok(())
+    }
+
+    fn set_topics(&mut self, topics: &str, avoid: bool) -> Result<()> {
+        let topics = parse_topic_list(topics);
+        if avoid {
+            self.state.settings.avoid_topics = topics;
+        } else {
+            self.state.settings.topics = topics;
+        }
+        save_state(&self.root, &self.state)?;
+        self.show_profile();
+        Ok(())
+    }
+
+    fn reset_profile(&mut self) -> Result<()> {
+        self.state.settings.difficulty = "auto".to_string();
+        self.state.settings.topics.clear();
+        self.state.settings.avoid_topics.clear();
+        save_state(&self.root, &self.state)?;
+        self.show_profile();
+        Ok(())
+    }
+
+    fn show_profile(&mut self) {
+        self.write_text_output(&self.profile_text());
+    }
+
+    fn profile_text(&self) -> String {
+        let settings = &self.state.settings;
+        let topics = list_or_none(&settings.topics);
+        let avoid = list_or_none(&settings.avoid_topics);
+        format!(
+            "Practice profile\n\nUI language: {}\nCode language: {}\nTheme: {}\nDifficulty: {}\nPreferred topics: {}\nAvoid topics: {}\nAI provider: {}\nAI model: {}\n\nCommands\n/profile\n/difficulty auto|easy|medium|hard\n/topics arrays, strings\n/avoid dp, graph\n/language python|ts|java|rust\n/ui en|ko|ja|zh|es\n/theme dark|light",
+            settings.ui_language,
+            settings.language,
+            settings.theme,
+            settings.difficulty,
+            topics,
+            avoid,
+            settings.ai_provider,
+            if settings.ai_model == "auto" {
+                "auto (provider default)"
+            } else {
+                settings.ai_model.as_str()
+            }
+        )
+    }
+
     fn start_ai_prompt(&mut self, prompt: &str) -> Result<()> {
         if self.task_rx.is_some() {
             self.write_text_output(ui_text(&self.state.settings.ui_language, "already_busy"));
@@ -1271,8 +1142,10 @@ impl PracticodeApp {
         if let Some(result) = result {
             self.update_rx = None;
             self.update_check = Some(result.clone());
-            if let UpdateCheck::Available(version) = &result {
-                self.update_notice = Some(version.clone());
+            match &result {
+                UpdateCheck::Available(version) => self.update_notice = Some(version.clone()),
+                UpdateCheck::Current | UpdateCheck::Disabled => self.update_notice = None,
+                UpdateCheck::Failed => {}
             }
         }
     }
@@ -1281,6 +1154,7 @@ impl PracticodeApp {
         if self.update_rx.is_some() {
             return;
         }
+        self.last_update_check = Some(Instant::now());
         let (tx, rx) = mpsc::channel();
         thread::spawn(move || {
             let _ = tx.send(check_latest_version());
@@ -1288,6 +1162,18 @@ impl PracticodeApp {
         self.update_rx = Some(rx);
     }
 
+    fn maybe_start_periodic_update_check(&mut self) {
+        if self.update_rx.is_some() {
+            return;
+        }
+        if self
+            .last_update_check
+            .is_none_or(|last| last.elapsed() >= UPDATE_CHECK_INTERVAL)
+        {
+            self.start_update_check();
+        }
+    }
+
     fn start_model_check(&mut self) {
         let provider = self.state.settings.ai_provider.clone();
         if self.model_rx.is_some() || self.available_models_provider == provider {
@@ -1387,6 +1273,13 @@ impl PracticodeApp {
         self.focus = Focus::Output;
     }
 
+    fn refresh_update_notice(&mut self) {
+        self.update_check = None;
+        self.update_notice = None;
+        self.start_update_check();
+        self.show_update_notice();
+    }
+
     fn show_update_notice(&mut self) {
         let lang = self.state.settings.ui_language.clone();
         if let Some(version) = &self.update_notice {
@@ -1414,7 +1307,7 @@ impl PracticodeApp {
     fn show_notes(&mut self) -> Result<()> {
         let notes = read_problem_notes(&self.root)?;
         if notes.is_empty() {
-            self.write_text_output("No notes yet. Add one with /note <text>.");
+            self.write_text_output("No notes yet. Use /topics or /avoid for standing preferences.");
         } else {
             self.write_text_output(&format!("Problem notes ({PROBLEM_NOTES_PATH})\n\n{notes}"));
         }
@@ -1644,7 +1537,7 @@ impl PracticodeApp {
     fn open_problem(&mut self, query: &str) -> Result<()> {
         self.list_cursor = None;
         let Some(problem) = self.find_problem(query).cloned() else {
-            self.write_text_output(&format!("Problem not found: {query}\nTry /list."));
+            self.write_text_output(&format!("Problem not found: {query}\nTry /problems."));
             return Ok(());
         };
         self.problem = problem;
@@ -1746,14 +1639,14 @@ impl PracticodeApp {
 
     fn next_source_help(&self) -> String {
         if self.state.settings.next_source == "ai" {
-            "Next behavior: plain /next asks AI every time. Use /source local to use local problems first.".to_string()
+            "Next behavior: plain /next asks AI every time. /next <request> also sends that request.".to_string()
         } else {
             "Next behavior: /next uses local problems first and asks AI when it needs a new one. Use /next <request> to ask AI directly.".to_string()
         }
     }
 
     fn busy_dots(&self) -> String {
-        ".".repeat(self.busy_frame / 4)
+        ".".repeat((self.busy_frame / 8) % 4)
     }
 
     fn mode_hint(&self) -> &'static str {
@@ -1787,6 +1680,14 @@ impl PracticodeApp {
     }
 }
 
+fn list_or_none(values: &[String]) -> String {
+    if values.is_empty() {
+        "(none)".to_string()
+    } else {
+        values.join(", ")
+    }
+}
+
 #[derive(Clone, Debug)]
 pub struct TextEditor {
     lines: Vec<String>,