aria-code 0.82.0__tar.gz → 0.83.0__tar.gz

{aria_code-0.82.0/src/aria_code.egg-info → aria_code-0.83.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aria-code
-Version: 0.82.0
+Version: 0.83.0
 Summary: Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/artheras/aria-code

{aria_code-0.82.0 → aria_code-0.83.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aria-code"
-version = "0.82.0"
+version = "0.83.0"
 description = "Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves"
 readme = "README.md"
 license = { text = "Apache-2.0" }

{aria_code-0.82.0 → aria_code-0.83.0}/src/aria_code/_version.py

@@ -17,4 +17,4 @@ from __future__ import annotations
 
 __all__ = ["__version__"]
 
-__version__ = "0.82.0"
+__version__ = "0.83.0"

aria_code-0.83.0/src/aria_code/apps/cli/commands/catalog.py

@@ -0,0 +1,160 @@
+"""Shared CLI command metadata.
+
+This module is intentionally UI-free so future channel adapters such as Feishu
+or a local gateway can reuse the same command categories without importing the
+large terminal implementation.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import FrozenSet, Tuple
+
+
+@dataclass(frozen=True)
+class DirectCommandSpec:
+    name: str
+    method_name: str
+    async_method: bool = False
+    watchable: bool = False
+    aliases: Tuple[str, ...] = ()
+
+    @property
+    def names(self) -> Tuple[str, ...]:
+        return (self.name, *self.aliases)
+
+
+DIRECT_COMMANDS: Tuple[DirectCommandSpec, ...] = (
+    DirectCommandSpec("quote", "cmd_quote", async_method=True, watchable=True),
+    DirectCommandSpec("backtest", "cmd_backtest", async_method=True),
+    DirectCommandSpec("health", "cmd_health", async_method=True, watchable=True),
+    DirectCommandSpec("doctor", "cmd_doctor"),
+    DirectCommandSpec("tools", "cmd_tools"),
+    DirectCommandSpec("skills", "cmd_skills"),
+    DirectCommandSpec("sessions", "cmd_sessions"),
+    DirectCommandSpec("watch", "cmd_watch", aliases=("watchlist",)),
+    DirectCommandSpec("export", "cmd_export", async_method=True),
+    DirectCommandSpec("tv", "cmd_tv", async_method=True),
+    DirectCommandSpec("ashare", "cmd_ashare", async_method=True, aliases=("a-share",)),
+    DirectCommandSpec("markets", "cmd_markets"),
+    DirectCommandSpec("orchestrate", "cmd_orchestrate"),
+)
+
+
+DIRECT_COMMAND_MAP = {
+    alias: spec
+    for spec in DIRECT_COMMANDS
+    for alias in spec.names
+}
+
+
+WATCHABLE_DIRECT_COMMANDS: FrozenSet[str] = frozenset(
+    alias
+    for spec in DIRECT_COMMANDS
+    if spec.watchable
+    for alias in spec.names
+)
+
+
+# Commands shown by default in /help. Other slash commands remain executable but
+# are hidden to keep the startup surface compact.
+VISIBLE_SLASH_COMMANDS: FrozenSet[str] = frozenset({
+    # Session
+    "/help", "/clear", "/compact", "/cost", "/status", "/health",
+    "/regen", "/undo", "/rewind", "/copy", "/recap", "/btw",
+    # Sessions
+    "/save", "/load", "/sessions", "/recall", "/export",
+    # Config
+    "/model", "/thinking", "/config", "/permissions", "/privacy",
+    # Setup & discovery
+    "/setup", "/apikey", "/doctor", "/architecture", "/mcp", "/skills", "/tools", "/packages", "/markets",
+    # Auth
+    "/login", "/logout", "/whoami",
+    # Persistent data (direct writes)
+    "/alert", "/journal", "/watch", "/note", "/todo", "/memory",
+    # Broker
+    "/broker", "/account", "/positions", "/orders", "/paper", "/trade",
+    # Code & project
+    "/project", "/init", "/review", "/code", "/plan", "/orchestrate", "/run", "/tasks", "/delegate", "/canva", "/completions", "/lsp",
+    # Research
+    "/team", "/warehouse", "/deep",
+    # Quant
+    "/backtest", "/wf", "/tv", "/ashare",
+    # UI generation
+    "/ui",
+    # Other
+    "/artifacts", "/vision", "/upload-image", "/file", "/strategy", "/accuracy",
+})
+
+
+# ── What "/" shows ────────────────────────────────────────────────────────────
+# The "/" popup listed every command — 167 of them plus 14 skills, 92 without
+# a category — and /help printed about 90 lines. Codex lists only session
+# controls under "/", shows eight rows, and takes tasks in plain language.
+# Aria keeps every command runnable by name; the popup opens on these two
+# tiers, and typing narrows it over everything.
+
+# Session and setup controls, in popup order.
+CORE_SLASH_COMMANDS: Tuple[str, ...] = (
+    "/help", "/model", "/review", "/plan", "/init", "/status", "/sessions", "/clear",
+    "/compact", "/copy", "/rewind", "/permissions", "/config", "/doctor", "/login",
+)
+
+# One way into each capability: building code, financial analysis, logistics.
+ENTRY_SLASH_COMMANDS: Tuple[str, ...] = (
+    "/code", "/ta", "/backtest", "/team", "/report", "/portfolio", "/inventory", "/carriers",
+)
+
+# Second names for a command; the popup lists the command once.
+COMMAND_ALIASES = {"/upload-image": "/vision"}
+
+
+@dataclass(frozen=True)
+class HelpTopic:
+    key: str
+    title_en: str
+    title_zh: str
+    commands: Tuple[str, ...]
+
+
+HELP_TOPICS: Tuple[HelpTopic, ...] = (
+    HelpTopic("code", "Code and projects", "代码与项目", (
+        "/code", "/project", "/init", "/review", "/plan", "/run", "/read", "/write", "/edit", "/ls",
+        "/search", "/verify", "/scaffold", "/apply", "/changes", "/git")),
+    HelpTopic("market", "Market research", "市场研究", (
+        "/quote", "/analyze", "/ta", "/chart", "/tv", "/deep", "/team", "/report", "/news", "/markets",
+        "/watch", "/alert")),
+    HelpTopic("quant", "Quant and portfolios", "量化与组合", (
+        "/backtest", "/wf", "/compare", "/auto-strategy", "/execution", "/portfolio", "/risk",
+        "/optimize", "/stress", "/factors")),
+    HelpTopic("logistics", "Logistics", "物流", ("/inventory", "/carriers", "/warehouse")),
+    HelpTopic("data", "Notes, files and artifacts", "笔记、文件与产物", (
+        "/journal", "/note", "/todo", "/memory", "/artifacts", "/strategy", "/accuracy", "/file",
+        "/vision", "/ui")),
+    HelpTopic("broker", "Broker and trading", "券商与交易", (
+        "/broker", "/paper", "/trade", "/account", "/positions", "/orders")),
+    HelpTopic("session", "Session", "会话", (
+        "/clear", "/compact", "/cost", "/status", "/health", "/regen", "/undo", "/rewind", "/copy",
+        "/recap", "/btw", "/save", "/load", "/sessions", "/export", "/export-pdf")),
+    HelpTopic("config", "Setup", "设置", (
+        "/model", "/thinking", "/config", "/permissions", "/privacy", "/local", "/update", "/setup",
+        "/apikey", "/doctor", "/mcp", "/login", "/logout", "/skills", "/tools", "/packages")),
+)
+
+HELP_TOPIC_MAP = {topic.key: topic for topic in HELP_TOPICS}
+
+
+def popup_rank(name: str) -> int:
+    """0 for a core command, 1 for an entry point, 2 for everything else."""
+    if name in CORE_SLASH_COMMANDS:
+        return 0
+    if name in ENTRY_SLASH_COMMANDS:
+        return 1
+    return 2
+
+
+def short_description(description: str) -> str:
+    """The description without its usage tail: "Technical indicators: /ta AAPL …" → "Technical indicators"."""
+    text = str(description or "")
+    cut = text.find(": /")
+    return (text[:cut] if cut > 0 else text).strip()

{aria_code-0.82.0 → aria_code-0.83.0}/src/aria_code/apps/cli/commands/core_cmds.py

@@ -117,7 +117,11 @@ class CoreCommandsMixin:
         # Contextual help: /help <command>
         from aria_code.apps.cli.skills_catalog import SKILLS
         target = args.strip().lower()
-        if target:
+        if target and target != "all":
+            from aria_code.apps.cli.commands.catalog import HELP_TOPIC_MAP
+            if target in HELP_TOPIC_MAP:
+                self._print_help_topic(HELP_TOPIC_MAP[target])
+                return
             cmd_key = target if target.startswith("/") else f"/{target}"
             if cmd_key in self.commands:
                 _, desc = self.commands[cmd_key]
@@ -149,7 +153,11 @@ class CoreCommandsMixin:
             self.context.console.print(f"[dim]No help for: {target}. Try /help[/dim]" if self.context.has_rich else f"No help for: {target}")
             return
 
-        # Full help listing
+        if not target:
+            self._print_help_overview()
+            return
+
+        # /help all: every command, grouped
         if self.context.has_rich:
             self.context.console.print()
 
@@ -248,6 +256,105 @@ class CoreCommandsMixin:
             print("\nSkills:")
             for s in SKILLS:
                 print(f"  {s['command']:20s} {s['description']}")
+    def _print_help_overview(self) -> None:
+        """One screen: what to type, the core commands, a way into each capability.
+
+        /help printed about 90 lines — every group, every skill — so the
+        commands that matter scrolled out of view. The rest is a topic away.
+        """
+        from aria_code.apps.cli.commands.catalog import (
+            CORE_SLASH_COMMANDS, ENTRY_SLASH_COMMANDS, HELP_TOPICS, short_description,
+        )
+        zh = str(self.terminal.config.get("ui_lang", "en")).lower().startswith("zh")
+        T = (lambda a, b: a) if zh else (lambda a, b: b)
+        core = [(n, short_description(self.commands[n][1])) for n in CORE_SLASH_COMMANDS if n in self.commands]
+        entry = [(n, short_description(self.commands[n][1])) for n in ENTRY_SLASH_COMMANDS if n in self.commands]
+        examples = (
+            T("给 utils.py 补上测试并运行", "Add tests for utils.py and run them"),
+            T("NVDA 这周走势怎么样？", "How's NVDA this week?"),
+            T("看看 skus.csv 哪些 SKU 该补货", "Which SKUs in skus.csv need reordering?"),
+        )
+        topics = " · ".join(t.key for t in HELP_TOPICS)
+        if not self.context.has_rich:
+            print("\n" + T("直接描述要做的事，Aria 会选择工具：", "Describe what you want; Aria picks the tools:"))
+            for example in examples:
+                print(f"  {example}")
+            print("\n" + T("常用命令", "Commands"))
+            for name, desc in core + entry:
+                print(f"  {name:13s} {desc}")
+            print("\n" + T(f"更多：/help {topics} · all · <命令>", f"More: /help {topics} · all · <command>"))
+            return
+
+        from rich.text import Text
+
+        console = self.context.console
+        console.print()
+        console.print(f"[bold]{T('直接描述要做的事', 'Describe what you want')}[/bold]  "
+                      f"[dim]{T('Aria 会选择工具', 'Aria picks the tools')}[/dim]")
+        for example in examples:
+            console.print(f"  [#C08050]{example}[/#C08050]")
+        console.print()
+
+        name_width = max(len(name) for name, _ in core + entry)
+        # indent 2, name, gap 2, description, gap 3, name, gap 2, description
+        desc_width = max(12, (console.width - 2 - 2 * name_width - 2 - 3 - 2) // 2)
+
+        def cell(text: str) -> str:
+            return text if len(text) <= desc_width else text[:desc_width - 1] + "…"
+
+        two_columns = console.width >= 96
+        if not two_columns:
+            desc_width = max(12, console.width - 2 - name_width - 2)
+
+        def grid(rows):
+            if two_columns:
+                half = (len(rows) + 1) // 2
+                pairs = zip(rows[:half], rows[half:] + [("", "")])
+            else:
+                pairs = ((row, ("", "")) for row in rows)
+            lines = Text()
+            for left, right in pairs:
+                lines.append("  " + left[0].ljust(name_width + 2), style="bold #C08050")
+                lines.append(cell(left[1]).ljust(desc_width + 3) if right[0] else cell(left[1]), style="dim")
+                if right[0]:
+                    lines.append(right[0].ljust(name_width + 2), style="bold #C08050")
+                    lines.append(cell(right[1]), style="dim")
+                lines.append("\n")
+            lines.rstrip()
+            return lines
+
+        console.print(f"[bold]{T('命令', 'Commands')}[/bold]")
+        console.print(grid(core))
+        console.print()
+        console.print(f"[bold]{T('开始一项任务', 'Start a task')}[/bold]  "
+                      f"[dim]{T('代码 · 金融分析 · 物流', 'code · financial analysis · logistics')}[/dim]")
+        console.print(grid(entry))
+        console.print()
+        console.print(f"[dim]{T('更多', 'More')}: /help {topics} · all · <{T('命令', 'command')}>[/dim]")
+        console.print(f"[dim]@ {T('附加上下文', 'attaches context')} · ! {T('运行 shell 命令', 'runs a shell command')}"
+                      f" · Esc {T('中断', 'interrupts')}[/dim]")
+        console.print()
+
+    def _print_help_topic(self, topic) -> None:
+        from aria_code.apps.cli.commands.catalog import short_description
+
+        zh = str(self.terminal.config.get("ui_lang", "en")).lower().startswith("zh")
+        rows = [(n, self.commands[n][1]) for n in topic.commands if n in self.commands]
+        title = topic.title_zh if zh else topic.title_en
+        if not self.context.has_rich:
+            print(f"\n{title}")
+            for name, desc in rows:
+                print(f"  {name:16s} {desc}")
+            return
+        from rich.markup import escape
+
+        console = self.context.console
+        console.print()
+        console.print(f"[bold]{title}[/bold]")
+        for name, desc in rows:
+            console.print(f"  [bold #C08050]{name:16s}[/bold #C08050][dim]{escape(desc)}[/dim]", highlight=False)
+        console.print()
+
     async def cmd_artifacts(self, args: str):
         from aria_code.ui.render.output import display_path as _display_path
         from aria_code.apps.cli.helpers import _copy_text_to_clipboard, _open_path_or_url, _reveal_path_in_finder

{aria_code-0.82.0 → aria_code-0.83.0}/src/aria_code/ui/completer.py

@@ -17,6 +17,13 @@ from pathlib import Path
 from typing import Iterator, List, Tuple
 
 from aria_code.ui.console import HAS_PT
+from aria_code.apps.cli.commands.catalog import (
+    COMMAND_ALIASES,
+    CORE_SLASH_COMMANDS,
+    ENTRY_SLASH_COMMANDS,
+    popup_rank,
+    short_description,
+)
 from aria_code.packages.aria_services.references import REFERENCE_KINDS, reference_search_roots
 
 _REFERENCE_KIND_NAMES = frozenset(item.name for item in REFERENCE_KINDS)
@@ -233,8 +240,19 @@ if HAS_PT:
             pattern = ltext  # includes leading "/"
 
             # --- Build candidate list with scores ---
-            candidates: list[tuple[int, str, list[int], str, str]] = []
-            # (score, name, matched_indices, desc, category)
+            candidates: list[tuple[int, int, str, list[int], str, str]] = []
+            # (score, tier, name, matched_indices, desc, category)
+
+            # A bare "/" opens on the core commands and the entry points, in
+            # their set order — not on all 181 commands and skills. Every other
+            # command is one or two letters away.
+            if pattern == "/":
+                for name in (*CORE_SLASH_COMMANDS, *ENTRY_SLASH_COMMANDS):
+                    if name in self.commands:
+                        candidates.append((0, popup_rank(name), name, [], self.commands[name][1],
+                                           self._cmd_cat.get(name, "")))
+                yield from self._emit(candidates, pattern)
+                return
 
             all_cmds = list(self.commands.items())
             for name, (_, desc) in all_cmds:
@@ -247,8 +265,11 @@ if HAS_PT:
                         continue
                     indices = indices2
                 score = _score(cmd_part, pattern, indices)
+                # An alias shows only when it is what was typed.
+                if name in COMMAND_ALIASES and score > 1:
+                    continue
                 cat   = self._cmd_cat.get(name, "")
-                candidates.append((score, name, indices, desc, cat))
+                candidates.append((score, popup_rank(name), name, indices, desc, cat))
 
             for s in self.skills:
                 cmd  = s["command"]
@@ -258,20 +279,23 @@ if HAS_PT:
                     continue
                 score = _score(cmd, pattern, indices)
                 cat   = self._cmd_cat.get(cmd, "")
-                candidates.append((score, cmd, indices, desc, cat))
-
-            # Sort: primary = score, secondary = name
-            candidates.sort(key=lambda x: (x[0], x[1]))
-
-            # Emit Completions
-            for score, name, indices, desc, cat in candidates:
+                candidates.append((score, popup_rank(cmd), cmd, indices, desc, cat))
+
+            # Best match first; among equals, core commands, then entry points.
+            candidates.sort(key=lambda x: (x[0], x[1], x[2]))
+            # Letters scattered through a name ("/re" in "/providers") are noise
+            # once there is a popup's worth of closer matches.
+            if sum(1 for c in candidates if c[0] < 30) >= 8:
+                candidates = [c for c in candidates if c[0] < 30]
+            yield from self._emit(candidates, pattern)
+
+        def _emit(self, candidates, pattern: str) -> Iterator[Completion]:
+            for score, _tier, name, indices, desc, cat in candidates:
                 # Build highlighted display (amber on matched chars)
                 display_parts = _highlighted(name, indices if pattern != "/" else [])
 
-                # Category badge as short suffix in display
-                badge = _CAT_BADGE.get(cat, "")
-                if badge:
-                    display_parts += [("class:fz-cat", f"  {badge}")]
+                # No badge after the name: "/help  sys" next to "Session · …"
+                # said the category twice.
 
                 # Truncate description to ~45 chars for meta column
                 cat_label = {
@@ -283,7 +307,8 @@ if HAS_PT:
                     "设置": "运行设置" if self.lang == "zh" else "Runtime",
                     "系统": "会话" if self.lang == "zh" else "Session",
                 }.get(cat, "")
-                meta_body = desc[:38] + ("…" if len(desc) > 38 else "")
+                desc = short_description(desc)
+                meta_body = desc[:44] + ("…" if len(desc) > 44 else "")
                 meta_str = f"{cat_label} · {meta_body}" if cat_label else meta_body
 
                 # start_position: replace the entire typed prefix

{aria_code-0.82.0 → aria_code-0.83.0}/src/aria_code/ui/input_box.py

@@ -24,7 +24,8 @@ try:
     from prompt_toolkit.buffer import Buffer
     from prompt_toolkit.key_binding import KeyBindings
     from prompt_toolkit.layout.dimension import Dimension
-    from prompt_toolkit.layout import Float, FloatContainer, HSplit, Layout, VSplit, Window
+    from prompt_toolkit.filters import is_done
+    from prompt_toolkit.layout import ConditionalContainer, Float, FloatContainer, HSplit, Layout, VSplit, Window
     from prompt_toolkit.layout.controls import FormattedTextControl
     from prompt_toolkit.layout.menus import CompletionsMenu
     from prompt_toolkit.layout.processors import Processor, Transformation
@@ -51,6 +52,7 @@ except ImportError:
     Application = Buffer = KeyBindings = Dimension = None  # type: ignore
     Float = FloatContainer = HSplit = Layout = VSplit = Window = None  # type: ignore
     FormattedTextControl = CompletionsMenu = TextArea = None  # type: ignore
+    ConditionalContainer = is_done = None  # type: ignore
 
 
 # ── Theme detection ────────────────────────────────────────────────────────────
@@ -202,6 +204,7 @@ PlaceholderProcessor = PromptAndPlaceholderProcessor
 
 
 INPUT_MAX_HEIGHT = 6
+MENU_ROWS = 8           # completion rows shown at once, as Codex shows
 
 
 # ── Style ──────────────────────────────────────────────────────────────────────
@@ -399,17 +402,31 @@ def _build_panel_input_application(
                 text_area,
                 Window(width=1, content=FormattedTextControl(_input_pad, focusable=False)),
             ]),
-            Window(height=1,
-                   content=FormattedTextControl(lambda: _input_rule(cfg), focusable=False)),
-            # Status bar: transparent bg, dim model · cwd
-            Window(height=1,
-                   content=FormattedTextControl(lambda: _status_bar(cfg), focusable=False)),
+            # Below the input: shown while typing, dropped once the prompt is
+            # submitted. The panel is not erased when done, so the rule and the
+            # status line used to stay behind in the scrollback after every
+            # question — "• model · cwd · rw · ctx" once per turn.
+            ConditionalContainer(
+                HSplit([
+                    Window(height=1,
+                           content=FormattedTextControl(lambda: _input_rule(cfg), focusable=False)),
+                    # Status bar: transparent bg, dim model · cwd
+                    Window(height=1,
+                           content=FormattedTextControl(lambda: _status_bar(cfg), focusable=False)),
+                    # Room for the completion menu. An inline application is as
+                    # tall as its layout, so the menu was clipped to the two
+                    # rows under the input — "/" showed /account and /accuracy.
+                    Window(height=lambda: Dimension.exact(
+                        MENU_ROWS if text_area.buffer.complete_state is not None else 0)),
+                ]),
+                filter=~is_done,
+            ),
         ]),
         floats=[
             Float(
                 xcursor=True,
                 ycursor=True,
-                content=CompletionsMenu(max_height=12, scroll_offset=2),
+                content=CompletionsMenu(max_height=MENU_ROWS, scroll_offset=2),
             )
         ],
     )

{aria_code-0.82.0 → aria_code-0.83.0/src/aria_code.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aria-code
-Version: 0.82.0
+Version: 0.83.0
 Summary: Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/artheras/aria-code

{aria_code-0.82.0 → aria_code-0.83.0}/src/aria_code.egg-info/SOURCES.txt

@@ -693,6 +693,7 @@ tests/test_single_import_root.py
 tests/test_skill_agent_binding.py
 tests/test_skill_catalog.py
 tests/test_skill_loader.py
+tests/test_slash_popup.py
 tests/test_spreadsheet_tools.py
 tests/test_sse_stream_contract.py
 tests/test_startup_dashboard.py

aria_code-0.83.0/tests/test_slash_popup.py

@@ -0,0 +1,162 @@
+""""/" opens on what a session needs; /help fits on one screen.
+
+The popup listed 181 entries — 167 commands and 14 skills — and /help ran to
+about 90 lines. Codex lists only session controls under "/" and shows eight
+rows. Every command still runs when typed; this only changes what is offered.
+"""
+
+from __future__ import annotations
+
+import io
+
+import pytest
+
+pytest.importorskip("prompt_toolkit")
+from prompt_toolkit.document import Document
+from rich.console import Console
+
+from aria_code.apps.cli.commands.catalog import (
+    COMMAND_ALIASES,
+    CORE_SLASH_COMMANDS,
+    ENTRY_SLASH_COMMANDS,
+    HELP_TOPICS,
+    popup_rank,
+    short_description,
+)
+from aria_code.ui.completer import AriaPTCompleter
+
+
+def _noop(_args):
+    return None
+
+
+COMMANDS = {name: (_noop, f"{name[1:]} things: {name} ARG") for name in (
+    *CORE_SLASH_COMMANDS, *ENTRY_SLASH_COMMANDS, "/realty", "/read", "/risk", "/providers", "/services",
+    "/vision", "/upload-image", "/stat-arb", "/regen", "/recap", "/recall", "/rename", "/reject-change")}
+
+
+def _popup(text, commands=COMMANDS, skills=()):
+    completer = AriaPTCompleter(commands, list(skills), [], lang="en")
+    return [item.text for item in completer.get_completions(Document(text), None)]
+
+
+def test_a_bare_slash_offers_the_core_then_the_entry_points():
+    assert _popup("/") == [*CORE_SLASH_COMMANDS, *ENTRY_SLASH_COMMANDS]
+    assert len(_popup("/")) <= 24
+
+
+def test_typing_reaches_every_command_and_ranks_the_tiers_first():
+    assert _popup("/ris")[0] == "/risk"
+    assert _popup("/stat")[:2] == ["/status", "/stat-arb"]
+    re = _popup("/re")
+    assert re[0] == "/review" and re.index("/report") < re.index("/realty")
+
+
+def test_an_alias_shows_only_when_typed():
+    assert "/upload-image" not in _popup("/")
+    assert "/upload-image" not in _popup("/i")
+    assert _popup("/upl") == ["/upload-image"]
+    assert COMMAND_ALIASES["/upload-image"] == "/vision"
+
+
+def test_scattered_matches_drop_out_once_there_are_enough_close_ones():
+    assert "/providers" not in _popup("/re")
+
+
+def test_descriptions_lose_their_usage_tail():
+    assert short_description("Technical indicators: /ta AAPL [days=120]") == "Technical indicators"
+    assert short_description("Runtime: engine · model · tools · context") == "Runtime: engine · model · tools · context"
+    completer = AriaPTCompleter(COMMANDS, [], [], lang="en")
+    meta = str(next(completer.get_completions(Document("/ta"), None)).display_meta_text)
+    assert "/ta ARG" not in meta
+
+
+def test_tiers_and_topics_are_consistent():
+    assert not set(CORE_SLASH_COMMANDS) & set(ENTRY_SLASH_COMMANDS)
+    assert popup_rank("/help") == 0 and popup_rank("/ta") == 1 and popup_rank("/realty") == 2
+    assert len({topic.key for topic in HELP_TOPICS}) == len(HELP_TOPICS)
+
+
+def test_every_tiered_command_exists():
+    import sys
+
+    sys.argv = ["aria-code"]
+    import aria_code.aria_cli as cli
+
+    terminal = cli.ArtheraTerminal(dict(cli.DEFAULT_CONFIG))
+    table = terminal.commands.commands
+    missing = [name for name in (*CORE_SLASH_COMMANDS, *ENTRY_SLASH_COMMANDS) if name not in table]
+    missing += [name for topic in HELP_TOPICS for name in topic.commands if name not in table]
+    assert not missing, missing
+
+
+@pytest.mark.parametrize("width, lang", [(100, "en"), (80, "en"), (100, "zh")])
+def test_help_fits_on_one_screen(width, lang, monkeypatch):
+    import sys
+
+    sys.argv = ["aria-code"]
+    import aria_code.aria_cli as cli
+
+    terminal = cli.ArtheraTerminal(dict(cli.DEFAULT_CONFIG, ui_lang=lang))
+    console = Console(file=io.StringIO(), width=width, color_system=None)
+    monkeypatch.setattr(terminal.commands.context, "console", console)
+    monkeypatch.setattr(terminal.commands.context, "has_rich", True)
+    terminal.commands.cmd_help("")
+    lines = console.file.getvalue().splitlines()
+    assert len(lines) <= 40
+    assert all(len(line.rstrip()) <= width for line in lines)
+    text = "\n".join(lines)
+    assert "/help" in text and "/inventory" in text and "/ta" in text
+    assert "/gen-bot" not in text            # skills and the long tail are a topic away
+
+
+def test_help_topics_and_all_still_list_everything(monkeypatch):
+    import sys
+
+    sys.argv = ["aria-code"]
+    import aria_code.aria_cli as cli
+
+    terminal = cli.ArtheraTerminal(dict(cli.DEFAULT_CONFIG))
+    console = Console(file=io.StringIO(), width=120, color_system=None)
+    monkeypatch.setattr(terminal.commands.context, "console", console)
+    monkeypatch.setattr(terminal.commands.context, "has_rich", True)
+    terminal.commands.cmd_help("market")
+    market = console.file.getvalue()
+    assert "/quote" in market and "/ta AAPL [days=120]" in market
+    console.file = io.StringIO()
+    terminal.commands.cmd_help("all")
+    assert len(console.file.getvalue().splitlines()) > 60
+
+
+def _containers(container):
+    yield container
+    for child in container.get_children():
+        yield from _containers(child)
+
+
+def test_the_menu_has_room_and_the_footer_leaves_with_the_prompt():
+    """The inline panel is as tall as its layout: the menu was clipped to two
+    rows under the input, and the rule and status line stayed in the
+    scrollback after every question."""
+    import asyncio
+
+    from prompt_toolkit.application.current import set_app
+    from prompt_toolkit.buffer import CompletionState
+    from prompt_toolkit.completion import Completion
+    from prompt_toolkit.layout import ConditionalContainer, Window
+
+    from aria_code.ui.input_box import MENU_ROWS, PanelInputConfig, _build_panel_input_application
+
+    app = _build_panel_input_application(config=PanelInputConfig())
+    footer = next(c for c in _containers(app.layout.container) if isinstance(c, ConditionalContainer))
+    spacer = [c for c in _containers(footer.content) if isinstance(c, Window)][-1]
+    buffer = app.layout.current_buffer
+    assert spacer.preferred_height(80, 40).preferred == 0
+    buffer.complete_state = CompletionState(buffer.document, [Completion("/help")])
+    assert spacer.preferred_height(80, 40).preferred == MENU_ROWS
+
+    with set_app(app):
+        assert footer.filter()                  # typing: rule, status line, menu room
+        app.future = asyncio.get_event_loop_policy().new_event_loop().create_future()
+        app.future.set_result("")
+        assert not footer.filter()              # submitted: only "› prompt" remains