Metadata-Version: 2.4
Name: brainfactory
Version: 0.1.0
Summary: The executable onboarding engine for Brain Factory — provision, adopt, and upgrade project 'brain' repositories.
Author: Izak Laubscher
License: MIT
Project-URL: Homepage, https://github.com/izakl/brainforge
Project-URL: Documentation, https://izakl.github.io/brainforge/
Project-URL: Source, https://github.com/izakl/brainforge
Keywords: brain-factory,onboarding,agents,automation,scaffolding
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: schema
Requires-Dist: jsonschema>=4; extra == "schema"

# brainfactory

The executable onboarding engine for [Brain Factory](https://github.com/izakl/brainforge)
— a single, standard-library-only Python package that provisions, adopts, and
upgrades project "brain" repositories, and backs the cross-platform adapter seam
(`bash`/`powershell` wrappers shell out to this).

## Install

```bash
# Isolated CLI (recommended) — installs the `brainfactory` command:
pipx install brainfactory

# Or with pip:
pip install brainfactory

# Stricter manifest validation (optional): pulls in jsonschema
pipx install "brainfactory[schema]"
```

Until the package is published to PyPI, install straight from the repo:

```bash
pipx install "git+https://github.com/izakl/brainforge#subdirectory=brain-factory/adapters/python"
```

## Use

```bash
brainfactory --help
brainfactory inspect --repo .            # read-only gap report
brainfactory provision --dest ./brain --name "Acme" --slug acme \
    --brain-repo acme/acme-autonomy-system --prefix ac
brainfactory upgrade --brain ./brain     # down-sync (dry-run; --apply to write)
```

`brainfactory <cmd>` is identical to `python -m brainfactory <cmd>`; the
`bash`/`powershell` adapters and the `run.sh`/`run.ps1` dispatchers call the same
CLI, so behaviour matches across runtimes.

Requires Python 3.10+. Licensed MIT.
