Metadata-Version: 2.4
Name: aios-cli
Version: 0.1.0
Summary: Developer SDK and CLI for AIOS BIZ modules
Author: whatznot
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1.7
Requires-Dist: jinja2>=3.1.3
Requires-Dist: requests>=2.31.0
Requires-Dist: jsonschema>=4.21.1

# AIOS BIZ SDK & CLI Tool

The AIOS BIZ Developer SDK and CLI is a Click-based tool that automates the creation, validation, packaging, and installation of modular AIOS BIZ modules.

## Installation

### Recommended — from PyPI

```bash
pip install aios-cli
```

Verify the installation:

```bash
aios --help
```

### Alternative — from the platform's Developer Portal

Download the SDK ZIP from your AIOS BIZ instance's Developer Portal and install it in an isolated Python environment:

```bash
pip install -e /path/to/extracted/aios-sdk
```

### Development (within the backend repo)

```bash
cd backend
uv pip install -e ../sdk
uv run aios --help
```

## Quickstart

```bash
# 1. Scaffold a new module
aios init invoice --name "Invoice Manager" --vendor "MyCompany" --resource "invoice"

# 2. Validate the module structure
aios validate ./invoice

# 3. Build a deployable .aios package
aios build ./invoice

# 4. Install on your AIOS BIZ Core instance
aios install ./invoice.aios --url http://your-core-url --token <your_jwt_token>
```

## CLI Commands

### 1. Initialize a Module
Scaffold a new module skeleton (interactively, or via flags):

```bash
aios init invoice --name "Invoice Manager" --vendor "MyCompany" --resource "invoice" --ui-mode "schema"
```

Options:
- `-n, --name TEXT`: Display name of the module.
- `-v, --vendor TEXT`: Vendor/Author namespace.
- `-r, --resource TEXT`: Lowercase singular initial resource name.
- `-u, --ui-mode [schema|custom]`: Frontend rendering mode.
- `--sample-tool/--no-sample-tool`: Include standard AI-callable tool stub.

### 2. Validate a Module
Run checks against the manifest.json schema and verify python code syntax rules:

```bash
aios validate ./invoice
```

### 3. Build a Package
Package the module source files into a `.aios` archive:

```bash
aios build ./invoice
```

This runs validation first automatically, refusing to build if validation fails.

### 4. Install a Package
Install the built package on a running Core backend:

```bash
aios install ./invoice.aios --url http://127.0.0.1:8000 --token <your_auth_jwt_token>
```

## Resources

- SDK Download also available from your AIOS BIZ Core instance's Developer Portal
