xone-cli 0.1.1__tar.gz → 0.1.2__tar.gz

{xone_cli-0.1.1 → xone_cli-0.1.2}/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.2
+
+- Pin `xone doctor --install-plan` to the current recommended X-One tool versions.
+- Add scenario-specific `when` and `next` guidance so first-run users know the next command to try.
+- Keep the unified entrypoint small while making the install plan more actionable.
+
 ## 0.1.1
 
 - Add scenario-based `xone doctor --install-plan` guidance.

{xone_cli-0.1.1/src/xone_cli.egg-info → xone_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xone-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: Unified CLI entry point for X-One Agent Evidence Loop workflows.
 Author: X-One-AI
 License-Expression: MIT
@@ -57,6 +57,8 @@ xone doctor --install-plan
 xone runbook --head HEAD --dry-run
 ```
 
+`xone doctor --install-plan` prints scenario-specific install commands with recommended X-One package versions, when to use each scenario, and the next command to try.
+
 `xone runbook` auto-detects the local repository default branch. Remote GitHub URLs are not accepted yet; clone the repository first, then pass the local path with `--repo`.
 
 `xone-cli` orchestrates these X-One tools:
@@ -66,6 +68,13 @@ xone runbook --head HEAD --dry-run
 - `mcp-risk-index`
 - `ai-incident-lab`
 
+Current recommended tool versions:
+
+- `agent-pr-evidence 0.4.2`
+- `agent-failure-packet 0.4.2`
+- `mcp-risk-index 0.3.1`
+- `ai-incident-lab 0.2.2`
+
 ## Boundary
 
 - It does not replace the underlying tools.

{xone_cli-0.1.1 → xone_cli-0.1.2}/README.md

@@ -30,6 +30,8 @@ xone doctor --install-plan
 xone runbook --head HEAD --dry-run
 ```
 
+`xone doctor --install-plan` prints scenario-specific install commands with recommended X-One package versions, when to use each scenario, and the next command to try.
+
 `xone runbook` auto-detects the local repository default branch. Remote GitHub URLs are not accepted yet; clone the repository first, then pass the local path with `--repo`.
 
 `xone-cli` orchestrates these X-One tools:
@@ -39,6 +41,13 @@ xone runbook --head HEAD --dry-run
 - `mcp-risk-index`
 - `ai-incident-lab`
 
+Current recommended tool versions:
+
+- `agent-pr-evidence 0.4.2`
+- `agent-failure-packet 0.4.2`
+- `mcp-risk-index 0.3.1`
+- `ai-incident-lab 0.2.2`
+
 ## Boundary
 
 - It does not replace the underlying tools.

{xone_cli-0.1.1 → xone_cli-0.1.2}/README.zh-CN.md

@@ -30,6 +30,8 @@ xone doctor --install-plan
 xone runbook --head HEAD --dry-run
 ```
 
+`xone doctor --install-plan` 会输出按场景分组的安装命令、推荐的 X-One package 版本、适用时机和下一条可尝试的命令。
+
 `xone runbook` 会自动探测本地仓库默认分支。当前还不直接接收远程 GitHub URL；请先 clone 仓库，再用 `--repo` 传本地路径。
 
 `xone-cli` 编排这些 X-One 工具：
@@ -39,6 +41,13 @@ xone runbook --head HEAD --dry-run
 - `mcp-risk-index`
 - `ai-incident-lab`
 
+当前推荐工具版本：
+
+- `agent-pr-evidence 0.4.2`
+- `agent-failure-packet 0.4.2`
+- `mcp-risk-index 0.3.1`
+- `ai-incident-lab 0.2.2`
+
 ## 边界
 
 - 不替代底层工具。

xone_cli-0.1.2/docs/install.md

@@ -0,0 +1,37 @@
+# Install
+
+## Local Development
+
+```bash
+python -m pip install -e '.[dev]'
+xone --version
+xone doctor
+xone doctor --install-plan
+xone runbook --head HEAD --dry-run
+```
+
+## User Install
+
+```bash
+python -m pip install xone-cli
+xone doctor
+xone doctor --install-plan
+xone runbook --head HEAD --dry-run
+```
+
+`xone doctor` reports missing X-One tools and shows install guidance.
+
+If `xone doctor` reports missing tools, run `xone doctor --install-plan`. The install plan pins the current recommended X-One package versions and shows the first next command for each scenario.
+
+Current scenario groups:
+
+- `evidence-loop`: install `agent-pr-evidence 0.4.2`, `agent-failure-packet 0.4.2`, `mcp-risk-index 0.3.1`, and `ai-incident-lab 0.2.2`, then run `xone runbook --head HEAD --dry-run`.
+- `mcp-review`: install `mcp-risk-index 0.3.1`, then run `xone risk context --catalog mcp-risk-index.catalog.yml --output mcp-risk-context.md`.
+- `incident-lab`: install `ai-incident-lab 0.2.2`, then run `xone lab evidence-loop --output agent-evidence-loop.md`.
+
+`xone runbook` expects a local git repository. To inspect a public repository, clone it first:
+
+```bash
+git clone --depth 1 https://github.com/owner/repo
+xone runbook --repo repo --head HEAD --dry-run
+```

{xone_cli-0.1.1 → xone_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xone-cli"
-version = "0.1.1"
+version = "0.1.2"
 description = "Unified CLI entry point for X-One Agent Evidence Loop workflows."
 readme = "README.md"
 requires-python = ">=3.11"

{xone_cli-0.1.1 → xone_cli-0.1.2}/src/xone_cli/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"

{xone_cli-0.1.1 → xone_cli-0.1.2}/src/xone_cli/cli.py

@@ -193,8 +193,10 @@ def _print_doctor(report) -> None:
 
 def _print_install_plan(profile: str) -> None:
     print("X-One install plan")
-    for name, command in install_plan(profile):
-        print(f"- {name}: {command}")
+    for item in install_plan(profile):
+        print(f"- {item['name']}: {item['command']}")
+        print(f"  when: {item['when']}")
+        print(f"  next: {item['next']}")
 
 
 def _add_evidence_collection_args(parser: argparse.ArgumentParser, *, require_base: bool = True) -> None:

{xone_cli-0.1.1 → xone_cli-0.1.2}/src/xone_cli/tooling.py

@@ -24,6 +24,13 @@ PACKAGE_BY_TOOL = {
     "ai-incident-lab": "xone-ai-incident-lab",
 }
 
+RECOMMENDED_VERSION_BY_TOOL = {
+    "agent-pr-evidence": "0.4.2",
+    "agent-failure-packet": "0.4.2",
+    "mcp-risk-index": "0.3.1",
+    "ai-incident-lab": "0.2.2",
+}
+
 INSTALL_PLAN_GROUPS = {
     "evidence-loop": (
         "agent-pr-evidence",
@@ -36,6 +43,21 @@ INSTALL_PLAN_GROUPS = {
     "all": REQUIRED_TOOLS,
 }
 
+INSTALL_PLAN_GUIDANCE = {
+    "evidence-loop": {
+        "when": "review an agent PR, create a redacted failure packet, attach MCP risk context, or run a safe local lab",
+        "next": "xone runbook --head HEAD --dry-run",
+    },
+    "mcp-review": {
+        "when": "attach evidence-backed MCP risk context without making an allow/deny decision",
+        "next": "xone risk context --catalog mcp-risk-index.catalog.yml --output mcp-risk-context.md",
+    },
+    "incident-lab": {
+        "when": "practice the Agent Evidence Loop with safe-local scenarios",
+        "next": "xone lab evidence-loop --output agent-evidence-loop.md",
+    },
+}
+
 
 def find_tool(name: str) -> str | None:
     return shutil.which(name)
@@ -43,18 +65,31 @@ def find_tool(name: str) -> str | None:
 
 def install_hint(name: str) -> str:
     package = PACKAGE_BY_TOOL.get(name, name)
-    return f"python -m pip install {package}"
+    version = RECOMMENDED_VERSION_BY_TOOL.get(name)
+    pinned = f"{package}=={version}" if version else package
+    return f"python -m pip install {pinned}"
 
 
-def install_plan(profile: str = "all") -> list[tuple[str, str]]:
+def install_plan(profile: str = "all") -> list[dict[str, str]]:
     if profile == "all":
         groups = ("evidence-loop", "mcp-review", "incident-lab")
     else:
         groups = (profile,)
     plan = []
     for group in groups:
-        packages = [PACKAGE_BY_TOOL[name] for name in INSTALL_PLAN_GROUPS[group]]
-        plan.append((group, f"python -m pip install {' '.join(packages)}"))
+        packages = [
+            f"{PACKAGE_BY_TOOL[name]}=={RECOMMENDED_VERSION_BY_TOOL[name]}"
+            for name in INSTALL_PLAN_GROUPS[group]
+        ]
+        guidance = INSTALL_PLAN_GUIDANCE[group]
+        plan.append(
+            {
+                "name": group,
+                "command": f"python -m pip install {' '.join(packages)}",
+                "when": guidance["when"],
+                "next": guidance["next"],
+            }
+        )
     return plan
 
 

{xone_cli-0.1.1 → xone_cli-0.1.2/src/xone_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xone-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: Unified CLI entry point for X-One Agent Evidence Loop workflows.
 Author: X-One-AI
 License-Expression: MIT
@@ -57,6 +57,8 @@ xone doctor --install-plan
 xone runbook --head HEAD --dry-run
 ```
 
+`xone doctor --install-plan` prints scenario-specific install commands with recommended X-One package versions, when to use each scenario, and the next command to try.
+
 `xone runbook` auto-detects the local repository default branch. Remote GitHub URLs are not accepted yet; clone the repository first, then pass the local path with `--repo`.
 
 `xone-cli` orchestrates these X-One tools:
@@ -66,6 +68,13 @@ xone runbook --head HEAD --dry-run
 - `mcp-risk-index`
 - `ai-incident-lab`
 
+Current recommended tool versions:
+
+- `agent-pr-evidence 0.4.2`
+- `agent-failure-packet 0.4.2`
+- `mcp-risk-index 0.3.1`
+- `ai-incident-lab 0.2.2`
+
 ## Boundary
 
 - It does not replace the underlying tools.

{xone_cli-0.1.1 → xone_cli-0.1.2}/tests/test_cli.py

@@ -12,7 +12,7 @@ def _fake_tool(bin_dir: Path, name: str, body: str = "echo tool") -> None:
 
 def test_version_outputs_package_version(capsys):
     assert main(["--version"]) == 0
-    assert capsys.readouterr().out.strip() == "xone 0.1.1"
+    assert capsys.readouterr().out.strip() == "xone 0.1.2"
 
 
 def test_doctor_json_reports_required_tools(tmp_path, monkeypatch, capsys):
@@ -35,9 +35,13 @@ def test_doctor_install_plan_outputs_scenario_commands(capsys):
     output = capsys.readouterr().out
     assert "X-One install plan" in output
     assert "evidence-loop" in output
-    assert "python -m pip install xone-agent-pr-evidence xone-agent-failure-packet xone-mcp-risk-index xone-ai-incident-lab" in output
+    assert "python -m pip install xone-agent-pr-evidence==0.4.2 xone-agent-failure-packet==0.4.2 xone-mcp-risk-index==0.3.1 xone-ai-incident-lab==0.2.2" in output
+    assert "when: review an agent PR, create a redacted failure packet, attach MCP risk context, or run a safe local lab" in output
+    assert "next: xone runbook --head HEAD --dry-run" in output
     assert "mcp-review" in output
+    assert "next: xone risk context --catalog mcp-risk-index.catalog.yml --output mcp-risk-context.md" in output
     assert "incident-lab" in output
+    assert "next: xone lab evidence-loop --output agent-evidence-loop.md" in output
 
 
 def test_runbook_dry_run_is_available(capsys):

{xone_cli-0.1.1 → xone_cli-0.1.2}/tests/test_docs.py

@@ -27,15 +27,16 @@ def test_docs_and_package_metadata_stay_aligned():
     assert "git clone --depth 1 https://github.com/owner/repo" in Path("docs/install.md").read_text(encoding="utf-8")
     assert "xone release verify --build --install --smoke" in Path("docs/release.md").read_text(encoding="utf-8")
     assert 'name = "xone-cli"' in pyproject
-    assert 'version = "0.1.1"' in pyproject
-    assert __version__ == "0.1.1"
-    assert "## 0.1.1" in changelog
+    assert 'version = "0.1.2"' in pyproject
+    assert __version__ == "0.1.2"
+    assert "## 0.1.2" in changelog
     assert 'xone = "xone_cli.cli:entrypoint"' in pyproject
     assert "python -m pytest -q" in ci
     assert "xone runbook --base HEAD~1 --head HEAD --dry-run" in ci
     assert "environment: testpypi" in publish
     assert "startsWith(github.ref, 'refs/tags/v')" in publish
     assert "doctor --install-plan" in changelog
+    assert "recommended X-One tool versions" in changelog
     assert "auto-detect the local repository default branch" in changelog
     assert "Do not make hidden network calls" in production
     assert "Keep top-level commands small" in main_entry

xone_cli-0.1.1/docs/install.md

@@ -1,31 +0,0 @@
-# Install
-
-## Local Development
-
-```bash
-python -m pip install -e '.[dev]'
-xone --version
-xone doctor
-xone doctor --install-plan
-xone runbook --head HEAD --dry-run
-```
-
-## User Install
-
-```bash
-python -m pip install xone-cli
-xone doctor
-xone doctor --install-plan
-xone runbook --head HEAD --dry-run
-```
-
-`xone doctor` reports missing X-One tools and shows install guidance.
-
-If `xone doctor` reports missing tools, install the suggested X-One packages and run it again before using `evidence`, `risk`, or `lab` commands.
-
-`xone runbook` expects a local git repository. To inspect a public repository, clone it first:
-
-```bash
-git clone --depth 1 https://github.com/owner/repo
-xone runbook --repo repo --head HEAD --dry-run
-```