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

xone_cli-0.1.2/CHANGELOG.md

@@ -0,0 +1,18 @@
+# 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.
+- Let `xone runbook` auto-detect the local repository default branch when `--base` is omitted.
+- Reject remote repository URLs in `xone runbook` with a clone-first message instead of producing a misleading dry run.
+- Expand open-source feedback classifications for adoption evaluation.
+
+## 0.1.0
+
+- Add the first X-One unified CLI foundation.

{xone_cli-0.1.0/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.0
+Version: 0.1.2
 Summary: Unified CLI entry point for X-One Agent Evidence Loop workflows.
 Author: X-One-AI
 License-Expression: MIT
@@ -53,9 +53,14 @@ xone doctor
 
 ```bash
 xone doctor
-xone runbook --base main --head HEAD --dry-run
+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:
 
 - `agent-pr-evidence`
@@ -63,6 +68,13 @@ xone runbook --base main --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.0 → xone_cli-0.1.2}/README.md

@@ -26,9 +26,14 @@ xone doctor
 
 ```bash
 xone doctor
-xone runbook --base main --head HEAD --dry-run
+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:
 
 - `agent-pr-evidence`
@@ -36,6 +41,13 @@ xone runbook --base main --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.0 → xone_cli-0.1.2}/README.zh-CN.md

@@ -26,9 +26,14 @@ xone doctor
 
 ```bash
 xone doctor
-xone runbook --base main --head HEAD --dry-run
+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 工具：
 
 - `agent-pr-evidence`
@@ -36,6 +41,13 @@ xone runbook --base main --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.0 → xone_cli-0.1.2}/docs/feedback/open-source-feedback-ledger.md

@@ -6,7 +6,7 @@ Rules:
 
 - Record source URL and observation, not raw sensitive configuration.
 - Do not label third-party projects as safe or unsafe.
-- Classify observations as false-positive, false-negative, adapter-request, scenario-request, or catalog-update.
+- Classify observations as false-positive, false-negative, adapter-request, scenario-request, catalog-update, config-discovery, default-branch, install-friction, agent-instruction-signal, runtime-capability-risk, or cli-ux-improvement.
 
 ## Samples
 

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.0 → xone_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xone-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "Unified CLI entry point for X-One Agent Evidence Loop workflows."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -49,4 +49,3 @@ where = ["src"]
 [tool.pytest.ini_options]
 pythonpath = ["src"]
 testpaths = ["tests"]
-

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

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

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

@@ -12,7 +12,7 @@ from xone_cli.lab import render_evidence_loop_lab
 from xone_cli.risk import render_risk_context
 from xone_cli.runbook import write_runbook
 from xone_cli.release import print_release_report, verify_release
-from xone_cli.tooling import doctor_status
+from xone_cli.tooling import doctor_status, install_plan
 
 
 def build_parser() -> argparse.ArgumentParser:
@@ -23,6 +23,13 @@ def build_parser() -> argparse.ArgumentParser:
     doctor = subparsers.add_parser("doctor", help="check local X-One tool availability")
     doctor.add_argument("--json", action="store_true", help="write machine-readable status")
     doctor.add_argument("--dry-run", action="store_true", help="show checks without running them")
+    doctor.add_argument(
+        "--install-plan",
+        nargs="?",
+        const="all",
+        choices=("all", "evidence-loop", "mcp-review", "incident-lab"),
+        help="show scenario-based install commands",
+    )
 
     evidence = subparsers.add_parser("evidence", help="work with PR evidence and failure packets")
     evidence_subparsers = evidence.add_subparsers(dest="evidence_command")
@@ -65,7 +72,7 @@ def build_parser() -> argparse.ArgumentParser:
     verify.add_argument("--json", action="store_true")
 
     runbook = subparsers.add_parser("runbook", help="assemble a local X-One evidence runbook")
-    _add_evidence_collection_args(runbook)
+    _add_evidence_collection_args(runbook, require_base=False)
     runbook.add_argument("--output", type=Path)
     runbook.add_argument("--dry-run", action="store_true", help="show underlying commands without running them")
     runbook.add_argument("--json", action="store_true", help="write machine-readable summary")
@@ -82,6 +89,9 @@ def main(argv: Sequence[str] | None = None) -> int:
         return 0
 
     if args.command == "doctor":
+        if args.install_plan:
+            _print_install_plan(args.install_plan)
+            return 0
         report = doctor_status()
         payload = report.to_dict()
         payload["dry_run"] = args.dry_run
@@ -181,9 +191,17 @@ def _print_doctor(report) -> None:
             print(f"  install: {tool.install_hint}")
 
 
-def _add_evidence_collection_args(parser: argparse.ArgumentParser) -> None:
+def _print_install_plan(profile: str) -> None:
+    print("X-One install plan")
+    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:
     parser.add_argument("--repo", default=".", help="git repository path")
-    parser.add_argument("--base", required=True, help="base git ref")
+    parser.add_argument("--base", required=require_base, help="base git ref; runbook can auto-detect when omitted")
     parser.add_argument("--head", required=True, help="head git ref")
     parser.add_argument("--test-log", action="append", default=[], help="test log path; repeatable")
     parser.add_argument("--profile", choices=("default", "strict"), default="strict")

{xone_cli-0.1.0 → xone_cli-0.1.2}/src/xone_cli/evidence.py

@@ -4,6 +4,7 @@ import json
 import tempfile
 from pathlib import Path
 
+from xone_cli.repo_context import detect_default_base, validate_local_repo
 from xone_cli.tooling import run_command
 
 
@@ -104,19 +105,23 @@ def build_failure_packet(*, input_path: Path, output: Path, profile: str, dry_ru
 def collect_for_runbook(
     *,
     repo: str,
-    base: str,
+    base: str | None,
     head: str,
     test_logs: list[str],
     profile: str,
     dry_run: bool,
 ) -> tuple[int, dict | None, str]:
+    valid, validation_message = validate_local_repo(repo)
+    if not valid:
+        return 2, None, validation_message
+    resolved_base = base or detect_default_base(repo)
     command = [
         "agent-pr-evidence",
         "collect",
         "--repo",
         repo,
         "--base",
-        base,
+        resolved_base,
         "--head",
         head,
         "--profile",
@@ -135,4 +140,3 @@ def collect_for_runbook(
         if result.returncode != 0:
             return result.returncode, None, result.stderr or result.stdout
         return 0, json.loads(output.read_text(encoding="utf-8")), ""
-

xone_cli-0.1.2/src/xone_cli/repo_context.py

@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+import re
+import subprocess
+from pathlib import Path
+from urllib.parse import urlparse
+
+
+def is_remote_repo_url(repo: str) -> bool:
+    parsed = urlparse(repo)
+    return parsed.scheme in {"http", "https", "ssh", "git"} or bool(re.match(r"^[^/@\s]+@[^:\s]+:.+", repo))
+
+
+def validate_local_repo(repo: str) -> tuple[bool, str]:
+    if is_remote_repo_url(repo):
+        return (
+            False,
+            "Remote repository URLs are not supported by runbook yet. "
+            f"Clone first, then pass the local path: git clone --depth 1 {repo}",
+        )
+    path = Path(repo)
+    if not (path / ".git").exists():
+        return False, f"{repo} is not a local git repository. Run xone runbook from a git repo or pass --repo /path/to/repo."
+    return True, ""
+
+
+def detect_default_base(repo: str) -> str:
+    remote_default = _git_symbolic_ref(repo, "refs/remotes/origin/HEAD")
+    if remote_default and remote_default.startswith("origin/"):
+        return remote_default.removeprefix("origin/")
+    local_default = _git_symbolic_ref(repo, "HEAD")
+    if local_default:
+        return local_default
+    git_dir = Path(repo) / ".git"
+    origin_head = _read_ref_name(git_dir / "refs" / "remotes" / "origin" / "HEAD", "refs/remotes/origin/")
+    if origin_head:
+        return origin_head
+    local_head = _read_ref_name(git_dir / "HEAD", "refs/heads/")
+    return local_head or "main"
+
+
+def _git_symbolic_ref(repo: str, ref: str) -> str | None:
+    try:
+        completed = subprocess.run(
+            ["git", "-C", repo, "symbolic-ref", "--quiet", "--short", ref],
+            check=False,
+            text=True,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+        )
+    except FileNotFoundError:
+        return None
+    if completed.returncode != 0:
+        return None
+    return completed.stdout.strip() or None
+
+
+def _read_ref_name(path: Path, prefix: str) -> str | None:
+    if not path.exists():
+        return None
+    content = path.read_text(encoding="utf-8").strip()
+    if not content.startswith("ref: "):
+        return None
+    ref = content.removeprefix("ref: ").strip()
+    if ref.startswith(prefix):
+        return ref.removeprefix(prefix)
+    return None

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

@@ -24,6 +24,40 @@ 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",
+        "agent-failure-packet",
+        "mcp-risk-index",
+        "ai-incident-lab",
+    ),
+    "mcp-review": ("mcp-risk-index",),
+    "incident-lab": ("ai-incident-lab",),
+    "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)
@@ -31,7 +65,32 @@ 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[dict[str, str]]:
+    if profile == "all":
+        groups = ("evidence-loop", "mcp-review", "incident-lab")
+    else:
+        groups = (profile,)
+    plan = []
+    for group in groups:
+        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
 
 
 def run_command(

{xone_cli-0.1.0 → 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.0
+Version: 0.1.2
 Summary: Unified CLI entry point for X-One Agent Evidence Loop workflows.
 Author: X-One-AI
 License-Expression: MIT
@@ -53,9 +53,14 @@ xone doctor
 
 ```bash
 xone doctor
-xone runbook --base main --head HEAD --dry-run
+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:
 
 - `agent-pr-evidence`
@@ -63,6 +68,13 @@ xone runbook --base main --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.0 → xone_cli-0.1.2}/src/xone_cli.egg-info/SOURCES.txt

@@ -31,6 +31,7 @@ src/xone_cli/evidence.py
 src/xone_cli/lab.py
 src/xone_cli/model.py
 src/xone_cli/release.py
+src/xone_cli/repo_context.py
 src/xone_cli/risk.py
 src/xone_cli/runbook.py
 src/xone_cli/tooling.py
@@ -44,5 +45,6 @@ tests/test_cli.py
 tests/test_docs.py
 tests/test_evidence.py
 tests/test_release.py
+tests/test_repo_context.py
 tests/test_risk_lab.py
 tests/test_tooling.py

xone_cli-0.1.2/tests/test_cli.py

@@ -0,0 +1,57 @@
+import json
+from pathlib import Path
+
+from xone_cli.cli import main
+
+
+def _fake_tool(bin_dir: Path, name: str, body: str = "echo tool") -> None:
+    path = bin_dir / name
+    path.write_text(f"#!/bin/sh\n{body}\n", encoding="utf-8")
+    path.chmod(0o755)
+
+
+def test_version_outputs_package_version(capsys):
+    assert main(["--version"]) == 0
+    assert capsys.readouterr().out.strip() == "xone 0.1.2"
+
+
+def test_doctor_json_reports_required_tools(tmp_path, monkeypatch, capsys):
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir()
+    _fake_tool(bin_dir, "agent-pr-evidence", "echo agent-pr-evidence 0.4.1")
+    monkeypatch.setenv("PATH", str(bin_dir))
+
+    assert main(["doctor", "--json"]) == 0
+    payload = json.loads(capsys.readouterr().out)
+    assert payload["schema_version"] == "xone.doctor.v1"
+    assert payload["tools"][0]["name"] == "agent-pr-evidence"
+    assert payload["tools"][0]["available"] is True
+    assert payload["tools"][1]["available"] is False
+
+
+def test_doctor_install_plan_outputs_scenario_commands(capsys):
+    assert main(["doctor", "--install-plan"]) == 0
+
+    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==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):
+    assert main(["runbook", "--base", "main", "--head", "HEAD", "--dry-run"]) == 0
+    assert "agent-pr-evidence collect" in capsys.readouterr().out
+
+
+def test_runbook_rejects_remote_repo_url_instead_of_dry_run_false_positive(capsys):
+    assert main(["runbook", "--repo", "https://github.com/openai/codex", "--head", "HEAD", "--dry-run"]) == 2
+
+    output = capsys.readouterr().out
+    assert "Remote repository URLs are not supported by runbook yet" in output
+    assert "git clone --depth 1 https://github.com/openai/codex" in output

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

@@ -1,5 +1,7 @@
 from pathlib import Path
 
+from xone_cli import __version__
+
 
 def test_docs_and_package_metadata_stay_aligned():
     english = Path("README.md").read_text(encoding="utf-8")
@@ -7,6 +9,7 @@ def test_docs_and_package_metadata_stay_aligned():
     pyproject = Path("pyproject.toml").read_text(encoding="utf-8")
     ci = Path(".github/workflows/ci.yml").read_text(encoding="utf-8")
     publish = Path(".github/workflows/publish.yml").read_text(encoding="utf-8")
+    changelog = Path("CHANGELOG.md").read_text(encoding="utf-8")
     production = Path("ops/constraints/production.md").read_text(encoding="utf-8")
     main_entry = Path("ops/constraints/main-entry.md").read_text(encoding="utf-8")
     evolution = Path("ops/skills/evolution.md").read_text(encoding="utf-8")
@@ -14,16 +17,27 @@ def test_docs_and_package_metadata_stay_aligned():
     assert "README.zh-CN.md" in english
     assert "README.md" in chinese
     assert "xone doctor" in english
-    assert "xone runbook --base main --head HEAD --dry-run" in english
+    assert "xone doctor --install-plan" in english
+    assert "xone runbook --head HEAD --dry-run" in english
+    assert "Remote GitHub URLs are not accepted yet" in english
     assert "xone doctor" in chinese
-    assert "xone runbook --base main --head HEAD --dry-run" in chinese
+    assert "xone doctor --install-plan" in chinese
+    assert "xone runbook --head HEAD --dry-run" in chinese
+    assert "远程 GitHub URL" in chinese
+    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.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
     assert "Delete or weaken" in evolution

{xone_cli-0.1.0 → xone_cli-0.1.2}/tests/test_evidence.py

@@ -51,3 +51,16 @@ def test_runbook_dry_run_lists_underlying_command(capsys):
     output = capsys.readouterr().out
     assert "agent-pr-evidence collect" in output
     assert "--base main" in output
+
+
+def test_runbook_auto_detects_default_branch_for_local_repo(tmp_path, capsys):
+    repo = tmp_path / "repo"
+    repo.mkdir()
+    (repo / ".git").mkdir()
+    (repo / ".git" / "HEAD").write_text("ref: refs/heads/master\n", encoding="utf-8")
+
+    assert main(["runbook", "--repo", str(repo), "--head", "HEAD", "--dry-run"]) == 0
+
+    output = capsys.readouterr().out
+    assert f"--repo {repo}" in output
+    assert "--base master" in output

xone_cli-0.1.2/tests/test_repo_context.py

@@ -0,0 +1,45 @@
+from pathlib import Path
+
+from xone_cli.repo_context import detect_default_base, is_remote_repo_url, validate_local_repo
+
+
+def test_detect_default_base_reads_local_git_head(tmp_path):
+    repo = tmp_path / "repo"
+    repo.mkdir()
+    (repo / ".git").mkdir()
+    (repo / ".git" / "HEAD").write_text("ref: refs/heads/master\n", encoding="utf-8")
+
+    assert detect_default_base(str(repo)) == "master"
+
+
+def test_detect_default_base_prefers_origin_head_when_available(tmp_path):
+    repo = tmp_path / "repo"
+    repo.mkdir()
+    git = repo / ".git"
+    git.mkdir()
+    (git / "HEAD").write_text("ref: refs/heads/feature\n", encoding="utf-8")
+    (git / "refs" / "remotes" / "origin").mkdir(parents=True)
+    (git / "refs" / "remotes" / "origin" / "HEAD").write_text("ref: refs/remotes/origin/trunk\n", encoding="utf-8")
+
+    assert detect_default_base(str(repo)) == "trunk"
+
+
+def test_remote_repo_url_detection():
+    assert is_remote_repo_url("https://github.com/openai/codex") is True
+    assert is_remote_repo_url("git@github.com:X-One-AI/xone-cli.git") is True
+    assert is_remote_repo_url("/tmp/repo") is False
+
+
+def test_validate_local_repo_rejects_remote_url():
+    valid, message = validate_local_repo("https://github.com/openai/codex")
+
+    assert valid is False
+    assert "Remote repository URLs are not supported by runbook yet" in message
+    assert "git clone --depth 1 https://github.com/openai/codex" in message
+
+
+def test_validate_local_repo_requires_git_metadata(tmp_path):
+    valid, message = validate_local_repo(str(tmp_path))
+
+    assert valid is False
+    assert "not a local git repository" in message

xone_cli-0.1.0/CHANGELOG.md

@@ -1,6 +0,0 @@
-# Changelog
-
-## 0.1.0
-
-- Add the first X-One unified CLI foundation.
-

xone_cli-0.1.0/docs/install.md

@@ -1,22 +0,0 @@
-# Install
-
-## Local Development
-
-```bash
-python -m pip install -e '.[dev]'
-xone --version
-xone doctor
-xone runbook --base main --head HEAD --dry-run
-```
-
-## User Install
-
-```bash
-python -m pip install xone-cli
-xone doctor
-xone runbook --base main --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_cli-0.1.0/tests/test_cli.py

@@ -1,34 +0,0 @@
-import json
-from pathlib import Path
-
-from xone_cli.cli import main
-
-
-def _fake_tool(bin_dir: Path, name: str, body: str = "echo tool") -> None:
-    path = bin_dir / name
-    path.write_text(f"#!/bin/sh\n{body}\n", encoding="utf-8")
-    path.chmod(0o755)
-
-
-def test_version_outputs_package_version(capsys):
-    assert main(["--version"]) == 0
-    assert capsys.readouterr().out.strip() == "xone 0.1.0"
-
-
-def test_doctor_json_reports_required_tools(tmp_path, monkeypatch, capsys):
-    bin_dir = tmp_path / "bin"
-    bin_dir.mkdir()
-    _fake_tool(bin_dir, "agent-pr-evidence", "echo agent-pr-evidence 0.4.1")
-    monkeypatch.setenv("PATH", str(bin_dir))
-
-    assert main(["doctor", "--json"]) == 0
-    payload = json.loads(capsys.readouterr().out)
-    assert payload["schema_version"] == "xone.doctor.v1"
-    assert payload["tools"][0]["name"] == "agent-pr-evidence"
-    assert payload["tools"][0]["available"] is True
-    assert payload["tools"][1]["available"] is False
-
-
-def test_runbook_dry_run_is_available(capsys):
-    assert main(["runbook", "--base", "main", "--head", "HEAD", "--dry-run"]) == 0
-    assert "agent-pr-evidence collect" in capsys.readouterr().out