aria-code 0.56.0__tar.gz → 0.57.0__tar.gz

{aria_code-0.56.0 → aria_code-0.57.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: aria-code
-Version: 0.56.0
+Version: 0.57.0
 Summary: AI coding and research workspace with optional finance and connected-domain tools
 License: Apache-2.0
-Project-URL: Homepage, https://github.com/artherahq/aria-code
-Project-URL: Repository, https://github.com/artherahq/aria-code
-Project-URL: Issues, https://github.com/artherahq/aria-code/issues
+Project-URL: Homepage, https://github.com/artheras/aria-code
+Project-URL: Repository, https://github.com/artheras/aria-code
+Project-URL: Issues, https://github.com/artheras/aria-code/issues
 Keywords: ai,llm,coding-agent,research,finance,terminal,cli
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -23,6 +23,7 @@ Requires-Python: <3.14,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
+Requires-Dist: google-genai>=1.0.0
 Requires-Dist: aiohttp>=3.9.0
 Requires-Dist: rich>=13.7.0
 Requires-Dist: prompt_toolkit>=3.0.43
@@ -167,7 +168,7 @@ Work in your project, use local or cloud models, and connect domain tools when y
 <p align="center">
   <a href="https://www.npmjs.com/package/@artheras/aria-code"><img src="https://img.shields.io/npm/v/@artheras/aria-code?style=flat-square&logo=npm&label=npm" alt="npm version"></a>
   <a href="https://pypi.org/project/aria-code/"><img src="https://img.shields.io/pypi/v/aria-code?style=flat-square&logo=pypi&label=PyPI" alt="PyPI version"></a>
-  <a href="https://github.com/artherahq/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artherahq/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
+  <a href="https://github.com/artheras/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artheras/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-64748b?style=flat-square" alt="Apache License 2.0"></a>
 </p>
 
@@ -185,18 +186,18 @@ The same core runtime is used by the CLI and other Aria surfaces. Model choice a
 Install the standalone CLI on macOS or Linux without Python, Node.js, or npm:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/artherahq/aria-code/main/scripts/install.sh | sh
+curl -fsSL https://raw.githubusercontent.com/artheras/aria-code/main/scripts/install.sh | sh
 ~/.local/bin/aria-code --help
 ```
 
 On Windows x64, run this in PowerShell:
 
 ```powershell
-irm https://raw.githubusercontent.com/artherahq/aria-code/main/scripts/install.ps1 | iex
+irm https://raw.githubusercontent.com/artheras/aria-code/main/scripts/install.ps1 | iex
 aria-code --help
 ```
 
-The installer downloads the binary for your OS from the latest [GitHub release](https://github.com/artherahq/aria-code/releases/latest), checks its SHA-256 digest, and installs it in your user account. Open a new terminal to use `aria-code` by name on macOS or Linux. Set `ARIA_CODE_VERSION=v0.55.0` to pin a release.
+The installer downloads the binary for your OS from the latest [GitHub release](https://github.com/artheras/aria-code/releases/latest), checks its SHA-256 digest, and installs it in your user account. Open a new terminal to use `aria-code` by name on macOS or Linux. Set `ARIA_CODE_VERSION=v0.55.0` to pin a release.
 
 Alternative package-manager installs: `npm install -g @artheras/aria-code` (requires npm) or `python3 -m pip install --upgrade aria-code` (requires Python 3.10+). For development from source, see [CONTRIBUTING.md](CONTRIBUTING.md).
 

{aria_code-0.56.0 → aria_code-0.57.0}/README.md

@@ -15,7 +15,7 @@ Work in your project, use local or cloud models, and connect domain tools when y
 <p align="center">
   <a href="https://www.npmjs.com/package/@artheras/aria-code"><img src="https://img.shields.io/npm/v/@artheras/aria-code?style=flat-square&logo=npm&label=npm" alt="npm version"></a>
   <a href="https://pypi.org/project/aria-code/"><img src="https://img.shields.io/pypi/v/aria-code?style=flat-square&logo=pypi&label=PyPI" alt="PyPI version"></a>
-  <a href="https://github.com/artherahq/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artherahq/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
+  <a href="https://github.com/artheras/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artheras/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-64748b?style=flat-square" alt="Apache License 2.0"></a>
 </p>
 
@@ -33,18 +33,18 @@ The same core runtime is used by the CLI and other Aria surfaces. Model choice a
 Install the standalone CLI on macOS or Linux without Python, Node.js, or npm:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/artherahq/aria-code/main/scripts/install.sh | sh
+curl -fsSL https://raw.githubusercontent.com/artheras/aria-code/main/scripts/install.sh | sh
 ~/.local/bin/aria-code --help
 ```
 
 On Windows x64, run this in PowerShell:
 
 ```powershell
-irm https://raw.githubusercontent.com/artherahq/aria-code/main/scripts/install.ps1 | iex
+irm https://raw.githubusercontent.com/artheras/aria-code/main/scripts/install.ps1 | iex
 aria-code --help
 ```
 
-The installer downloads the binary for your OS from the latest [GitHub release](https://github.com/artherahq/aria-code/releases/latest), checks its SHA-256 digest, and installs it in your user account. Open a new terminal to use `aria-code` by name on macOS or Linux. Set `ARIA_CODE_VERSION=v0.55.0` to pin a release.
+The installer downloads the binary for your OS from the latest [GitHub release](https://github.com/artheras/aria-code/releases/latest), checks its SHA-256 digest, and installs it in your user account. Open a new terminal to use `aria-code` by name on macOS or Linux. Set `ARIA_CODE_VERSION=v0.55.0` to pin a release.
 
 Alternative package-manager installs: `npm install -g @artheras/aria-code` (requires npm) or `python3 -m pip install --upgrade aria-code` (requires Python 3.10+). For development from source, see [CONTRIBUTING.md](CONTRIBUTING.md).
 

{aria_code-0.56.0 → aria_code-0.57.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aria-code"
-version = "0.56.0"
+version = "0.57.0"
 description = "AI coding and research workspace with optional finance and connected-domain tools"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -45,6 +45,14 @@ classifiers = [
 # parsers, the SQL engine and chart renderer are optional extras below — the
 # code already lazy-imports them and degrades gracefully when absent.
 dependencies = [
+    # The default model's client. DEFAULT_MODEL is google/gemini-2.5-pro, and
+    # this used to be the optional `google` extra — so a plain
+    # `pip install aria-code` failed on the very first prompt with "Gemini/Vertex
+    # AI 需要 google-genai，当前未安装". The comment above that extra said as
+    # much ("a default install that cannot import this has no working model at
+    # all") while it stayed optional. tests/test_first_run_works.py now fails if
+    # the default model's client is not a core dependency.
+    "google-genai>=1.0.0",
     # CLI runtime
     "aiohttp>=3.9.0",
     "rich>=13.7.0",
@@ -79,9 +87,9 @@ crypto = ["ccxt>=4.4.0"]           # crypto exchanges (large dep tree)
 # ── Feature add-ons ────────────────────────────────────────────────────────────
 charts = ["mplfinance>=0.12.10b0"]    # candlestick charts in /report /chart
 
-# Gemini / Vertex AI. Needed by the Google sign-in path, where the gateway
-# serves the model and the user configures no API key of their own — so a
-# default install that cannot import this has no working model at all.
+# Gemini / Vertex AI. Now a core dependency (see the top of `dependencies`);
+# the extra is kept so `pip install 'aria-code[google]'` in existing scripts
+# and docs keeps working.
 google = ["google-genai>=1.0.0"]
 data = ["duckdb>=0.10.3"]          # in-process SQL: /data sql "SELECT …"
 files = [                          # /file load + /file analyze document parsing
@@ -204,9 +212,9 @@ aria-code = "aria_code.apps.cli.main:main"
 aria-code-mcp = "aria_code.aria_mcp_server:main"
 
 [project.urls]
-Homepage = "https://github.com/artherahq/aria-code"
-Repository = "https://github.com/artherahq/aria-code"
-Issues = "https://github.com/artherahq/aria-code/issues"
+Homepage = "https://github.com/artheras/aria-code"
+Repository = "https://github.com/artheras/aria-code"
+Issues = "https://github.com/artheras/aria-code/issues"
 
 # ── Package discovery ──────────────────────────────────────────────────────────
 [tool.setuptools]

{aria_code-0.56.0 → aria_code-0.57.0}/src/aria_code/_version.py

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

{aria_code-0.56.0 → aria_code-0.57.0}/src/aria_code/apps/cli/commands/core_cmds.py

@@ -1050,7 +1050,7 @@ class CoreCommandsMixin:
             return
 
         if sub == "policy":
-            url = "https://github.com/artherahq/aria-code/blob/aria-code/PRIVACY.md"
+            url = "https://github.com/artheras/aria-code/blob/main/PRIVACY.md"
             local = pathlib.Path(__file__).resolve().parent / "PRIVACY.md"
             lines = [
                 "Aria Code is local-first: by default nothing is collected or uploaded.",

{aria_code-0.56.0 → aria_code-0.57.0}/src/aria_code/apps/cli/commands/diagnostic_ops_cmds.py

@@ -152,7 +152,7 @@ class DiagnosticOpsCommandsMixin:
         env = (f"v{_get___version__()} · {_pf.system()} · py{_pf.python_version()} · "
                f"model={self.terminal.config.get('model','')}")
         self.terminal._record_feedback("bug", ctx, comment=f"{desc}\n\n[env] {env}")
-        gh = "https://github.com/artherahq/aria-code/issues"
+        gh = "https://github.com/artheras/aria-code/issues"
         if self.context.has_rich:
             self.context.console.print("  [#C08050]✓ 已记录问题（本地）[/#C08050]")
             self.context.console.print(f"  [dim]上传需 /privacy opt-in · 或直接提 issue: {gh}[/dim]")

aria_code-0.57.0/src/aria_code/apps/cli/commands/warehouse_cmds.py

@@ -0,0 +1,208 @@
+"""Warehouse ERP command; globals are rebound by the legacy CLI bridge."""
+
+from __future__ import annotations
+
+import json
+
+
+import json
+import asyncio
+import datetime
+import time
+import shlex
+from typing import Dict, Any, Optional
+
+
+import json
+import asyncio
+import datetime
+import time
+import shlex
+import sys
+import os
+from typing import Dict, Any, Optional
+
+
+import json
+import asyncio
+import datetime
+import time
+import shlex
+import sys
+import os
+from typing import Dict, Any, Optional
+
+
+class WarehouseCommandsMixin:
+    """Read-only warehouse ERP analysis commands."""
+
+    async def cmd_warehouse(self, args: str):
+        """Run `/warehouse <warehouse_id> [--json]` against the configured ERP."""
+        parts = args.strip().split()
+        as_json = "--json" in parts
+        identifiers = [part for part in parts if not part.startswith("--")]
+        if len(identifiers) != 1:
+            message = "用法: /warehouse <仓库编号> [--json]，例如 /warehouse WH-CN-01"
+            self.context.console.print(f"[yellow]{message}[/yellow]") if self.context.has_rich else print(message)
+            return
+
+        from agents.warehouse.workflow import run_warehouse_analysis
+        from clients.warehouse_erp_client import WarehouseERPConfigurationError, WarehouseERPRequestError
+
+        try:
+            result, snapshot = await run_warehouse_analysis(identifiers[0])
+        except (WarehouseERPConfigurationError, WarehouseERPRequestError) as exc:
+            message = str(exc)
+            self.context.console.print(f"[red]{message}[/red]") if self.context.has_rich else print(message)
+            return
+
+        payload = {
+            "warehouse_id": identifiers[0],
+            "signal": result.final_signal,
+            "confidence": result.confidence,
+            "agents": [item.to_dict() for item in result.results],
+            "snapshot_counts": {key: len(snapshot.get(key, [])) for key in ("connectors", "inbounds", "skus", "locations")},
+        }
+        if as_json:
+            print(json.dumps(payload, ensure_ascii=False, indent=2))
+            return
+
+        lines = [
+            f"仓库 {identifiers[0]} · {result.final_signal} · 置信度 {result.confidence:.0%}",
+            f"货代 {payload['snapshot_counts']['connectors']} · 入库单 {payload['snapshot_counts']['inbounds']} · "
+            f"SKU {payload['snapshot_counts']['skus']} · 库位 {payload['snapshot_counts']['locations']}",
+        ]
+        for item in result.results:
+            summary = item.key_points[0] if item.key_points else item.analysis
+            lines.append(f"- {item.agent}: {item.signal} — {summary}")
+        output = "\n".join(lines)
+        self.context.console.print(output) if self.context.has_rich else print(output)
+
+
+def _parse_logistics_args(args: str, usage: str) -> dict | None:
+    """`<file> [--owner ID | --all-owners] [--json] [--key value]` → params, or None on misuse.
+
+    shlex, so a path with spaces can be quoted. The shipper flags map straight
+    onto the tools' owner_id / all_owners: a command never decides on its own
+    to mix two shippers' data.
+    """
+    try:
+        tokens = shlex.split(args)
+    except ValueError:
+        return None
+    params: dict = {"_json": False}
+    positional = []
+    index = 0
+    while index < len(tokens):
+        token = tokens[index]
+        if token == "--json":
+            params["_json"] = True
+        elif token == "--all-owners":
+            params["all_owners"] = True
+        elif token in ("--owner", "--service-level", "--review-days", "--min-shipments"):
+            if index + 1 >= len(tokens):
+                return None
+            value = tokens[index + 1]
+            key = {"--owner": "owner_id", "--service-level": "service_level",
+                   "--review-days": "review_period_days", "--min-shipments": "min_shipments"}[token]
+            params[key] = value
+            index += 1
+        elif token.startswith("--"):
+            return None
+        else:
+            positional.append(token)
+        index += 1
+    if len(positional) != 1:
+        return None
+    params["file_path"] = positional[0]
+    return params
+
+
+def _emit(self, text: str, style: str = "") -> None:
+    if self.context.has_rich and style:
+        self.context.console.print(f"[{style}]{text}[/{style}]")
+    elif self.context.has_rich:
+        self.context.console.print(text)
+    else:
+        print(text)
+
+
+class LogisticsCommandsMixin:
+    """3PL inventory and carrier analyses, run directly on a CSV/JSON file.
+
+    These are direct commands rather than only model tools because the
+    logistics pack, by design, activates only on verifiable identifiers (a
+    waybill or container number with a valid check digit). "Work out my
+    reorder points" carries neither, so the model would not be offered the
+    tool; a 3PL operator needs a way in that does not depend on that.
+    """
+
+    _INVENTORY_USAGE = ("用法: /inventory <skus.csv|json> [--owner 货主ID | --all-owners] "
+                        "[--service-level 0.95] [--review-days 7] [--json]")
+    _CARRIERS_USAGE = ("用法: /carriers <waybills.csv|json> [--owner 货主ID | --all-owners] "
+                       "[--min-shipments 20] [--json]")
+
+    async def cmd_inventory(self, args: str):
+        """Reorder points, safety stock, ABC/XYZ and dead stock for one shipper."""
+        params = _parse_logistics_args(args, self._INVENTORY_USAGE)
+        if params is None:
+            _emit(self, self._INVENTORY_USAGE, "yellow")
+            return
+        from aria_code.tools.logistics_inventory import tool_plan_inventory_policy
+
+        as_json = params.pop("_json")
+        result = tool_plan_inventory_policy(params)
+        if as_json:
+            print(json.dumps(result, ensure_ascii=False, indent=2))
+            return
+        if not result["success"]:
+            _emit(self, result["error"], "red")
+            return
+        data = result["data"]
+        if not data["scope"]["client_facing"]:
+            _emit(self, data["scope"]["marker"], "bold red")
+        _emit(self, result["summary"], "bold")
+        for item in data["items"]:
+            if item["action"] != "reorder":
+                continue
+            _emit(self, f"  补货 {item['sku']}: 建议 {item['suggested_order_qty']} 件 · "
+                        f"补货点 {item['reorder_point']} · 安全库存 {item['safety_stock']} · "
+                        f"可用 {item['days_of_cover']} 天 · {item['abc'] or '-'}{item['xyz'] or ''}")
+        for item in data["items"]:
+            if item["movement"] in ("dead", "slow"):
+                label = "呆滞" if item["movement"] == "dead" else "慢动"
+                _emit(self, f"  {label} {item['sku']}: 在库 {item['on_hand']:g}", "yellow")
+        _emit(self, "依据: " + "；".join(data["assumptions"]), "dim")
+
+    async def cmd_carriers(self, args: str):
+        """Carrier scorecard by lane, cost anomalies and like-for-like savings."""
+        params = _parse_logistics_args(args, self._CARRIERS_USAGE)
+        if params is None:
+            _emit(self, self._CARRIERS_USAGE, "yellow")
+            return
+        from aria_code.tools.logistics_carriers import tool_score_carriers
+
+        as_json = params.pop("_json")
+        result = tool_score_carriers(params)
+        if as_json:
+            print(json.dumps(result, ensure_ascii=False, indent=2))
+            return
+        if not result["success"]:
+            _emit(self, result["error"], "red")
+            return
+        data = result["data"]
+        if not data["scope"]["client_facing"]:
+            _emit(self, data["scope"]["marker"], "bold red")
+        _emit(self, result["summary"], "bold")
+        for entry in data["scorecard"]:
+            rank = f"#{entry['rank_in_lane']}" if entry["rank_in_lane"] else "样本不足"
+            on_time = (f"{entry['on_time_rate']:.0%}（下界 {entry['on_time_lower_bound']:.0%}）"
+                       if entry["on_time_rate"] is not None else "无准时记录")
+            cost = f"{entry['median_cost_per_kg']:.2f}/kg" if entry["median_cost_per_kg"] is not None else "-"
+            _emit(self, f"  {entry['lane']} {rank} {entry['carrier']}: {entry['shipments']} 单 · 准时 {on_time} · {cost}")
+        for saving in data["savings"]:
+            _emit(self, f"  可节省 {saving['estimated_saving']:,.2f}: {saving['lane']} 由 {saving['from_carrier']} "
+                        f"转 {saving['to_carrier']}（每 kg 低 {saving['rate_difference_per_kg']:.2f}）", "green")
+        for anomaly in data["anomalies"]:
+            _emit(self, f"  核实 {anomaly['waybill_no']} ({anomaly['carrier']}): {anomaly['detail']}", "yellow")
+        _emit(self, "依据: " + "；".join(data["assumptions"]), "dim")

{aria_code-0.56.0 → aria_code-0.57.0}/src/aria_code/apps/cli/github_app_auth.py

@@ -4,7 +4,7 @@ Usage:
     from apps.cli.github_app_auth import get_installation_token, get_aria_git_url
 
     token = get_installation_token()          # raises if not configured
-    url   = get_aria_git_url("artherahq/aria-code", token)
+    url   = get_aria_git_url("artheras/aria-code", token)
     # git push with url as remote
 """
 
@@ -92,7 +92,7 @@ def _gh_api(path: str, token: str, *, method: str = "GET") -> dict:
         return json.loads(resp.read())
 
 
-def get_installation_token(owner: str = "artherahq") -> str:
+def get_installation_token(owner: str = "artheras") -> str:
     """Return a short-lived installation token (valid ~1 hour)."""
     pem   = _find_pem()
     jwt   = _make_jwt(pem, ARIA_APP_ID)

{aria_code-0.56.0 → aria_code-0.57.0}/src/aria_code/apps/cli/tools/system_tools.py

@@ -603,7 +603,7 @@ def tool_github(
         message   = params.get("message", "")
         branch    = params.get("branch", "")
         add_files = params.get("files", [])
-        repo      = params.get("repo", "")    # e.g. "artherahq/aria-code"
+        repo      = params.get("repo", "")    # e.g. "artheras/aria-code"
         coauthor  = params.get("coauthor", "")
 
         if not message:
@@ -615,7 +615,7 @@ def tool_github(
                 get_installation_token, get_aria_git_url,
                 aria_bot_env, ARIA_BOT_NAME, ARIA_BOT_EMAIL,
             )
-            owner = (repo.split("/")[0] if repo else None) or "artherahq"
+            owner = (repo.split("/")[0] if repo else None) or "artheras"
             token = get_installation_token(owner)
             bot_env = aria_bot_env()
             auth_available = True

{aria_code-0.56.0 → aria_code-0.57.0}/src/aria_code/aria_cli.py

@@ -311,7 +311,7 @@ from aria_code.apps.cli.commands.finance_service_cmds import FinanceServiceComma
 from aria_code.apps.cli.commands.orchestrator_cmds import OrchestratorCommandsMixin
 from aria_code.apps.cli.commands.workflow_cmds import WorkflowCommandsMixin
 from aria_code.apps.cli.commands.business_workflow_cmds import BusinessWorkflowCommandsMixin
-from aria_code.apps.cli.commands.warehouse_cmds import WarehouseCommandsMixin
+from aria_code.apps.cli.commands.warehouse_cmds import LogisticsCommandsMixin, WarehouseCommandsMixin
 from aria_code.apps.cli.commands.session_cmds import SessionCommandsMixin
 from aria_code.apps.cli.session_export import build_session_export_payload  # 同上
 from aria_code.apps.cli.commands.workspace_cmds import WorkspaceCommandsMixin
@@ -3363,7 +3363,7 @@ import apps.cli.broker_render as _broker_render_module
 _rebind_module_function_globals(_broker_render_module, _broker_render_module.__all__)
 
 class SlashCommands(
-    CoreCommandsMixin,BrokerCommandsMixin, CanvasCommandsMixin, BacktestCommandsMixin, AnalysisCommandsMixin, ASharePredictionCommandsMixin, DataCommandsMixin, OpsCommandsMixin, DiagnosticCommandsMixin, DiagnosticOpsCommandsMixin, UiCommandsMixin, SessionUxCommandsMixin, AuthCommandsMixin, FileCommandsMixin, FxCommodityCommandsMixin, FinanceServiceCommandsMixin, OrchestratorCommandsMixin, WorkflowCommandsMixin, BusinessWorkflowCommandsMixin, WarehouseCommandsMixin, SessionCommandsMixin, WorkspaceCommandsMixin, ModelCommandsMixin, MarketCommandsMixin, PortfolioCommandsMixin, PdfExportCommandsMixin):
+    CoreCommandsMixin,BrokerCommandsMixin, CanvasCommandsMixin, BacktestCommandsMixin, AnalysisCommandsMixin, ASharePredictionCommandsMixin, DataCommandsMixin, OpsCommandsMixin, DiagnosticCommandsMixin, DiagnosticOpsCommandsMixin, UiCommandsMixin, SessionUxCommandsMixin, AuthCommandsMixin, FileCommandsMixin, FxCommodityCommandsMixin, FinanceServiceCommandsMixin, OrchestratorCommandsMixin, WorkflowCommandsMixin, BusinessWorkflowCommandsMixin, WarehouseCommandsMixin, LogisticsCommandsMixin, SessionCommandsMixin, WorkspaceCommandsMixin, ModelCommandsMixin, MarketCommandsMixin, PortfolioCommandsMixin, PdfExportCommandsMixin):
     """Claude Code-style slash command system."""
 
 
@@ -3491,6 +3491,8 @@ class SlashCommands(
             "/analyze":   (self.cmd_analyze,  "Deep market analysis: /analyze AAPL"),
             "/team":      (self.cmd_team,     "Multi-agent research team: /team AAPL [--full]"),
             "/warehouse": (self.cmd_warehouse, "Read-only warehouse ERP analysis: /warehouse WH-CN-01 [--json]"),
+            "/inventory": (self.cmd_inventory, "3PL inventory policy: reorder points, safety stock, ABC/XYZ, dead stock: /inventory skus.csv --owner ACME"),
+            "/carriers": (self.cmd_carriers, "3PL carrier scorecard by lane, cost anomalies and savings: /carriers waybills.csv --owner ACME"),
             "/deep":      (self.cmd_deep,     "Deep layered research (P0–P3): /deep AAPL [--deep|--brief]"),
             "/ta":        (self.cmd_ta,       "Technical indicators: /ta AAPL [days=120]"),
             "/market":    (self.cmd_market,   "Market overview: /market [indices|sectors]"),
@@ -3618,6 +3620,10 @@ class SlashCommands(
         # ── Financial analysis ──────────────────────────────────────────────
         "/team":      ("Usage: /team [SYMBOL] [--agents a,b] [--full]", ["/team NVDA", "/team AAPL --agents technical,risk", "/team watchlist", "/team SPY --full"]),
         "/warehouse": ("Usage: /warehouse <warehouse_id> [--json]", ["/warehouse WH-CN-01", "/warehouse WH-CN-01 --json"]),
+        "/inventory": ("Usage: /inventory <skus.csv|json> [--owner ID | --all-owners] [--service-level 0.95] [--review-days 7] [--json]",
+                       ["/inventory skus.csv --owner ACME", "/inventory skus.json --owner ACME --service-level 0.98"]),
+        "/carriers": ("Usage: /carriers <waybills.csv|json> [--owner ID | --all-owners] [--min-shipments 20] [--json]",
+                      ["/carriers waybills.csv --owner ACME", "/carriers waybills.csv --all-owners"]),
         "/deep":      ("Usage: /deep [SYMBOL] [--brief|--deep] [--agents a,b]", ["/deep NVDA", "/deep AAPL --deep", "/deep 000333 --brief", "/deep TSLA --agents technical,risk,macro", "/deep calibrate"]),
         "/architecture": ("Usage: /architecture [--gaps]", ["/architecture", "/architecture --gaps"]),
         "/ta":        ("Usage: /ta [SYMBOL] [days=N]", ["/ta AAPL", "/ta NVDA days=60"]),
@@ -6506,7 +6512,11 @@ class ArtheraTerminal:
 async def main():
     parser = argparse.ArgumentParser(
         prog="aria-code",
-        description="Aria Code — Quantitative Investment Terminal",
+        # Same sentence as pyproject's description, so `--help`, PyPI and npm
+        # describe one product. It used to say "Quantitative Investment
+        # Terminal" here while the package metadata had been repositioned;
+        # tests/test_first_run_works.py keeps the two in step.
+        description="Aria Code — AI coding and research workspace with optional finance and connected-domain tools",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:

{aria_code-0.56.0 → aria_code-0.57.0}/src/aria_code/doctor.py

@@ -150,7 +150,13 @@ def _format_age(seconds: float | int | None) -> str:
 
 
 def _has_module(name: str) -> bool:
-    return importlib.util.find_spec(name) is not None
+    # find_spec on a dotted name imports the parent package first, and raises
+    # rather than returning None when that parent is absent ("google.genai"
+    # with no "google" installed). Absent is the answer either way.
+    try:
+        return importlib.util.find_spec(name) is not None
+    except (ImportError, ValueError):
+        return False
 
 
 def _is_writable(path: Path) -> tuple[bool, str]:
@@ -662,6 +668,11 @@ def provider_health_summary(snapshot: Optional[List[Dict[str, Any]]] = None) ->
 
 
 def _iter_required_modules() -> Iterable[tuple[str, str]]:
+    """Core dependencies: a plain `pip install aria-code` must provide these.
+
+    Kept in step with [project].dependencies in pyproject.toml;
+    tests/test_first_run_works.py fails if one is listed here but not there.
+    """
     yield "aiohttp", "async HTTP"
     yield "rich", "terminal UI"
     yield "prompt_toolkit", "interactive input"
@@ -669,7 +680,20 @@ def _iter_required_modules() -> Iterable[tuple[str, str]]:
     yield "pandas", "dataframes"
     yield "numpy", "numeric processing"
     yield "yfinance", "US/HK/global market data"
-    yield "akshare", "China market data"
+    # The default model is google/gemini-2.5-pro, so without this a fresh
+    # install cannot answer a single prompt.
+    yield "google.genai", "Gemini / Vertex AI (the default model)"
+
+
+def _iter_optional_modules() -> Iterable[tuple[str, str, str]]:
+    """Optional extras: (module, purpose, extra that installs it).
+
+    These used to sit in the required list, so a clean install of aria-code
+    always ended doctor with "1 errors" — for akshare, which pyproject has
+    always declared as the optional `cn` extra. Missing an optional extra is a
+    choice the user made, not a fault.
+    """
+    yield "akshare", "China A-share market data", "cn"
 
 
 def run_doctor(
@@ -711,7 +735,15 @@ def run_doctor(
         if _has_module(module):
             checks.append(_check(f"package:{module}", "ok", purpose))
         else:
-            checks.append(_check(f"package:{module}", "err", f"{purpose} missing", f"pip install {module}"))
+            checks.append(_check(f"package:{module}", "err", f"{purpose} missing",
+                                 "Reinstall: pip install -U aria-code"))
+
+    for module, purpose, extra in _iter_optional_modules():
+        if _has_module(module):
+            checks.append(_check(f"package:{module}", "ok", purpose))
+        else:
+            checks.append(_check(f"package:{module}", "skip", f"{purpose} not installed (optional)",
+                                 f"pip install 'aria-code[{extra}]'"))
 
     for module in ("data_service", "artifacts", "report_generator", "backtest_report"):
         checks.append(

{aria_code-0.56.0 → aria_code-0.57.0}/src/aria_code/packs/logistics/__init__.py

@@ -25,6 +25,8 @@ PACK_NAME = "logistics"
 
 LOGISTICS_TOOLS = (
     "analyze_logistics_data",
+    "plan_inventory_policy",
+    "score_carriers",
 )
 
 _VERIFIED = 0.95