Metadata-Version: 2.4
Name: lia-platform
Version: 0.0.1
Summary: Lia sentinel-family umbrella (the Lia Python platform). v0.0.1: a micro-audit CLI that scans a repo's git history for committed secrets. (Bare 'lia' is PyPI similarity-blocked and 'lia-cli' is taken; this is the umbrella package.)
Requires-Python: >=3.12
Requires-Dist: lia-core>=0.0.1
Description-Content-Type: text/markdown

# lia-platform

Umbrella package for the **Lia sentinel family** — AI auditors that propose
repo changes a human approves (`lia-core`, `lia-gro`, `lia-code`, …). Lia never
auto-acts: every outward action is a proposal awaiting human review.

## v0.0.1 — micro-audit preview

This first release ships ONE real tool: **`lia-scan`** — scan a git repository's
history for committed secrets / `.env` material and print a one-line severity
score. A preview of the Lia auto-engineer, not the full auditor (which arrives
in later releases on the Lia platform).

## Install

```bash
uv pip install lia-platform
# or: pip install lia-platform
```

> The bare name `lia` is blocked by PyPI's project-name similarity filter, and
> `lia-cli` is already taken — so the umbrella publishes as `lia-platform`. The
> Python import package is still `lia`.

Requires Python ≥ 3.12. Pulls in `lia-core` — the family's constitutional core
(6 invariants: never-auto-act, capability-confinement, immutable audit-log,
delivery-contract, manifest-conformance, semver; guarded executor; registry).

## Use

```bash
lia-scan                  # scan the current repo
lia-scan /path/to/repo    # scan a specific repo
python -m lia --version
```

Exit codes: `0` = clean, `1` = potential secrets found, `2` = not a git repo /
git error.

## Status

`0.0.1` pre-freeze. The Lia platform is under active development; the full
auditor + sentinel family arrive in later releases.