Metadata-Version: 2.4
Name: riskdemand-cli
Version: 0.1.0
Summary: Public HTTP/JSON CLI for RiskDemandMgmt
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: click<9,>=8.1
Requires-Dist: httpx==0.28.1
Requires-Dist: pydantic<3,>=2.13
Requires-Dist: platformdirs<5,>=4
Requires-Dist: pywin32>=311; sys_platform == "win32"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"

# RiskDemandMgmt CLI

`riskdemand-cli` is the Windows 10/11 command-line client for RiskDemandMgmt and
requires Python >= 3.12. It is a thin HTTP/JSON client: authentication,
permissions, validation, revisions, workflow state, and every business rule
remain on the server.

## Install and upgrade

After a release is available on official PyPI, install it in an isolated pipx
environment:

```powershell
pipx install riskdemand-cli
pipx upgrade riskdemand-cli
rdm --help
```

## Read-only diagnostics

```powershell
rdm doctor --help
rdm doctor --json
```

Doctor is read-only. It never repairs state, authenticates, logs out, changes a
file, issues or revokes a token, or calls a business write API. Interpret its
overall result as:

- `pass` / exit `0`: the runtime, binding, instance, and authentication checks pass;
- `action_required` / exit `0`: the user still needs to set up or log in, or the token expired;
- `fail` / exit `1`: a real runtime, local-state, network, TLS, server, or protocol failure occurred.

## Manual authentication boundary

The user runs these commands in their own terminal and enters credentials only
into the interactive prompt:

```text
rdm setup <server-url>
rdm auth login
```

Agent must never handle a username, password, or token. Agents may use JSON
commands after the user completes authentication, subject to the canonical
Skill's confirmation and permission rules.

## One bundled Skill, installed manually

The distribution contains one canonical Skill. The user locates it in the pipx
environment and manually copies it to an existing `.agents` or `.claude` Skill
directory; the CLI and the Agent do not modify those directories:

```powershell
$pipxVenvs = pipx environment --value PIPX_LOCAL_VENVS
$skillSource = Join-Path $pipxVenvs "riskdemand-cli\skills\riskdemandmgmt-cli\SKILL.md"
Test-Path -LiteralPath $skillSource
```

## Compatibility and authority

Compatibility is determined by the server-advertised `protocol_version`, not by
matching the CLI package version to a system release Tag. The server remains authoritative
for authentication, scopes, object permissions, validation, revisions, state
transitions, and all high-impact action boundaries.

## Documentation

- [Repository and current user guide](https://github.com/kevinwnk04/AI-DemandMgmtSystem#readme)
- [Phase 1 CLI design](https://github.com/kevinwnk04/AI-DemandMgmtSystem/blob/main/docs/specs/2026-08-02-rdm-cli-ification-design.md)
- [Phase 2 PyPI and doctor design](https://github.com/kevinwnk04/AI-DemandMgmtSystem/blob/main/docs/superpowers/specs/2026-08-14-cli-pypi-doctor-design.md)
