Metadata-Version: 2.4
Name: corpai
Version: 0.4.2
Summary: CLI validator and tooling for the CorpAI open standard
Project-URL: Homepage, https://github.com/Arigitshub/CorpAI
Project-URL: Repository, https://github.com/Arigitshub/corpai-cli
Project-URL: Bug Tracker, https://github.com/Arigitshub/corpai-cli/issues
Author-email: Ari <ari532477@gmail.com>
License: MIT
License-File: LICENSE
Keywords: agents,ai,cli,corpai,multi-agent,validator
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.12.0
Description-Content-Type: text/markdown

# corpai-cli

[![PyPI version](https://img.shields.io/pypi/v/corpai?style=flat-square)](https://pypi.org/project/corpai/)
[![Python 3.9+](https://img.shields.io/pypi/pyversions/corpai?style=flat-square)](https://pypi.org/project/corpai/)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
[![CI](https://img.shields.io/github/actions/workflow/status/Arigitshub/corpai-cli/ci.yml?style=flat-square)](https://github.com/Arigitshub/corpai-cli/actions)
[![CorpAI Compatible](https://img.shields.io/badge/CorpAI-Compatible-0a0a0a?style=flat-square)](https://github.com/Arigitshub/CorpAI)

CLI toolkit for the [CorpAI open standard](https://github.com/Arigitshub/CorpAI) — lint, visualize, and simulate AI agent organizations.

---

## Install

```bash
pip install corpai
```

---

## Commands

### `corpai lint` — Validate role files

Checks every `.md` role file against the CorpAI spec: missing sections, invalid ranks, broken reporting chains, empty fields, missing escalation triggers.

```bash
corpai lint                        # validate entire org
corpai lint ./my-corpai-org        # validate a directory
corpai lint --file roles/executive/ceo.md   # single file
corpai lint --strict               # warnings become errors
```

```
✓ ceo.md
✓ cto.md
⚠ engineer.md
    WARN   No optional personality template found
✗ custom-role.md
    ERROR  Missing required section: ## Escalation Triggers
    ERROR  "Reports to" field is empty

──────────────────────────────
42 roles checked — 1 error(s), 3 warning(s)
```

---

### `corpai graph` — Generate org charts

```bash
corpai graph                        # ASCII tree (default)
corpai graph --format mermaid       # Mermaid diagram
corpai graph --dept engineering     # filter to one department
corpai graph --format mermaid --output org.mmd   # save to file
```

```
└── [OWNER] OWNER  (executive)
    └── [L5] CEO  (executive)
        ├── [L5] CFO  (executive)
        │   └── [L4] Finance Director  (finance)
        │       ├── [L2] Financial Analyst  (finance)
        │       └── [L2] Auditor  (finance)
        └── [L5] CTO  (executive)
            └── [L4] Engineering Director  (engineering)
                └── [L3] Engineering Team Lead  (engineering)
```

---

### `corpai simulate` — Trace message flows

Trace exactly how a TASK or ESCALATION travels through your hierarchy.

```bash
corpai simulate --from CEO --to Engineer --subject "Build auth module" --priority P2
corpai simulate --from "Support Agent" --to CEO --priority P1
```

```
╭─ CorpAI Message Simulation ───────────────────────╮
│ Subject:  Build auth module                        │
│ Type:     ↓ TASK                                   │
│ Priority: P2                                       │
│ Hops:     4                                        │
╰────────────────────────────────────────────────────╯

  Step 1  [L5] CEO  ↓ TASK  [L5] CTO
  Step 2  [L5] CTO  ↓ TASK  [L4] Engineering Director
  Step 3  [L4] Engineering Director  ↓ TASK  [L3] Engineering Team Lead
  Step 4  [L3] Engineering Team Lead  ↓ TASK  [L1] Engineer

✓ Message delivered to [L1] Engineer
```

---

### `corpai info` — Org summary

```bash
corpai info
```

Prints role counts, departments, and rank distribution across your org.

---

### `corpai scaffold` — Bootstrap a new role

```bash
corpai scaffold --role "Data Engineer" --dept data-ai --rank L2 --reports-to "ML Lead"
```

Generates a spec-compliant `.md` role file with all required sections pre-filled.

---

### `corpai init` — Bootstrap a full org

```bash
corpai init --name "MyAI Corp" --output ./my-org
```

Generates a complete department hierarchy from the CorpAI spec template.

---

## Quick Start with the CorpAI spec

```bash
git clone https://github.com/Arigitshub/CorpAI
cd CorpAI
pip install corpai

corpai lint
corpai graph
corpai simulate --from CEO --to "QA Tester" --subject "Test the release"
```

---

## Links

- [CorpAI spec repo](https://github.com/Arigitshub/CorpAI) — the open standard
- [corpai-runtime](https://github.com/Arigitshub/corpai-runtime) — execution engine
- [corpai-portal](https://github.com/Arigitshub/corpai-portal) — org chart dashboard
- [PyPI](https://pypi.org/project/corpai/) — package page

---

## Contributing

Issues and PRs welcome at [Arigitshub/corpai-cli](https://github.com/Arigitshub/corpai-cli).
