Metadata-Version: 2.4
Name: alissa-tools-github-orcloop
Version: 0.1.0
Summary: ALISSA-TOOLS-GITHUB-ORCLOOP
Home-page: https://alissa.app
Author: Fahera
Author-email: support@alissa.app
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-python
Dynamic: summary

# alissa-tools-github-orcloop

The `alissa.tools.github.orcloop` module: the **orchestrator** daemon of the
Alissa GitHub daemon family. It walks the Alissa task graph, releases tasks
marked ready as `alissa:develop` issues, and closes the loop when the resulting
PR merges — sitting one level above
[`alissa-tools-github-devloop`](https://github.com/fahera-mx/alissa-github-develop-daemon)
(which turns those issues into developer sessions) and
[`alissa-tools-github-reviewloop`](https://github.com/fahera-mx/alissa-github-review-daemon)
(which reacts to the review requests those developers fire).

This distribution ships **only** that module. Everything above it —
`alissa`, `alissa.tools`, `alissa.tools.github` — is a
[PEP 420](https://peps.python.org/pep-0420/) namespace package with no
`__init__.py`, so other distributions in other repositories can contribute
their own packages under the same namespace:

```
alissa/                                  ← namespace (no __init__.py)
└── tools/                               ← namespace
    └── github/                          ← namespace
        ├── orcloop/     __init__.py    ← THIS distribution
        ├── devloop/     __init__.py    ← ships from alissa-github-develop-daemon
        └── reviewloop/  __init__.py    ← ships from alissa-github-review-daemon
```

The rule: a distribution owns a leaf package and declares only that subtree
(`find_namespace_packages(include=[PACKAGE, f"{PACKAGE}.*"])`). Adding an
`__init__.py` at any namespace level would claim it for one distribution and
shadow the others.

## Status — O0 scaffold

This is the **O0 scaffold** only: the distribution skeleton, repo tooling, and
a CLI stub (`alissa-orcloop --version`). No daemon logic yet — config surface,
Alissa/GitHub clients, the decision loop, and the Docker image land across
O1–O5 (see the repo [README](../README.md) lane map). The reserved runtime env
prefix is `ALISSA_ORC_*`.

## Install

```sh
pip install -e ./alissa-tools-github-orcloop
alissa-orcloop --version
```
