Metadata-Version: 2.4
Name: xone-cli
Version: 0.1.3
Summary: Unified CLI entry point for X-One Agent Evidence Loop workflows.
Author: X-One-AI
License-Expression: MIT
Project-URL: Homepage, https://github.com/X-One-AI/xone-cli
Project-URL: Repository, https://github.com/X-One-AI/xone-cli
Project-URL: Issues, https://github.com/X-One-AI/xone-cli/issues
Keywords: ai,agents,devsecops,mcp,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

# xone-cli

Languages: English | [中文](./README.zh-CN.md)

`xone-cli` is the unified local entry point for X-One Agent Evidence Loop workflows.

It helps developers move from scattered tools to one clear path:

```text
collect PR evidence
-> decide handoff
-> create failure packet when needed
-> attach MCP risk context when useful
-> run safe-local training scenarios
```

## Install

```bash
python -m pip install xone-cli
xone --version
xone doctor
```

## First Run

```bash
xone doctor
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`.

For repeatable open-source adoption checks, use the read-only evaluator:

```bash
xone eval open-source --repos repos.txt --output evaluation.md --format markdown
```

Add `--clone-root .xone-eval-clones` when you want X-One to shallow-clone public repositories and run only X-One dry-run commands against those local clones. It does not run third-party install scripts, tests, containers, or project commands.

`xone-cli` orchestrates these X-One tools:

- `agent-pr-evidence`
- `agent-failure-packet`
- `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.
- It does not post GitHub comments.
- It does not modify repositories automatically.
- It does not make allow/deny runtime enforcement decisions.
- It does not run third-party project scripts.
- `xone eval open-source` makes explicit GitHub API and `git clone --depth 1` calls only when requested by the command.

## Docs

- [Product Foundation](./docs/product-foundation.md)
- [Install](./docs/install.md)
- [Release](./docs/release.md)
- [Open-source Feedback Ledger](./docs/feedback/open-source-feedback-ledger.md)
