Metadata-Version: 2.4
Name: cueapril
Version: 1.1.0
Summary: Launch the CueApril CLI from Python package managers; requires installed Node.js 20 or later.
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://app.cueapril.com/agents
Keywords: cueapril,testing,mcp,coding-agents,cli
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Environment :: Console
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# CueApril for Python package managers

This package runs the same CueApril CLI as the npm package. **Python 3.10 or later and an installed Node.js 20 or later are required.** It bundles the CLI's JavaScript and skill; it installs no Python runtime dependencies, runs no npm install and downloads no runtime when launched.

Install with your usual Python package manager:

```sh
pipx install cueapril
cueapril init

# Or run in an isolated environment:
uvx cueapril init

# A regular Python environment also works:
python -m pip install cueapril
python -m cueapril --help
```

Have `node` on PATH before running these commands. The launcher checks its version and replaces itself with the bundled CLI, preserving arguments, environment, standard input/output and exit status. It reports a missing or old Node.js installation with exit code 5. It does not install Node.js for you. Choose either the Python or npm installation for your normal `cueapril` command; both expose that command name.

`cueapril init` connects a coding agent through one browser approval. It then checks project setup and can configure Claude Code, Codex, Gemini CLI and Cursor. A scoped agent key can also come from the `CUEAPRIL_API_KEY` environment variable. Use `CUEAPRIL_URL` to select another API origin. The Python launcher never reads, prints or passes a key as a command-line argument; it preserves the existing CLI environment and credential-store behavior.

```sh
cueapril projects
cueapril setup --project PROJECT_ID
cueapril assess --pr https://github.com/OWNER/REPO/pull/42 --wait --json
cueapril status ASSESSMENT_ID --json
cueapril wait ASSESSMENT_ID --timeout 4 --json
cueapril results ASSESSMENT_ID --all --json
cueapril mcp-config --client codex
```

Assessment exit codes are unchanged: 0 passed; 1 failed; 2 incomplete or cancelled; 3 blocked; 4 still running; 5 usage, authentication, API or launcher error. A CLI wait timeout leaves the assessment running. Each server wait call lasts at most 50 seconds.

The complete CLI reference is bundled in `cueapril/_cli/README.md`; public setup documentation is at https://app.cueapril.com/agents. The Python package contains the same Node modules, package metadata and `cueapril-qa` skill as the unscoped npm package.

## Source maintenance

From the CueApril repository, synchronize the bundled CLI after a change:

```sh
node packages/quality-python/scripts/sync-cli.mjs --sync --repository-root .
node packages/quality-python/scripts/sync-cli.mjs --check --repository-root .
python -m unittest discover -s packages/quality-python/tests
```

The sync script uses the repository's canonical npm package builder in a temporary directory with packing disabled. It compares every bundled file and records deterministic hashes in `bundled-cli.json`; `--check` fails if a file, version or manifest differs. It performs no npm command or network request. The initial release additionally compares the source with the independently reviewed npm staging directory. A distribution build includes those already reviewed bytes and does not fetch or rewrite the bundled CLI.
