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 (which turns those issues into developer sessions) and alissa-tools-github-reviewloop (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 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 lane map). The reserved runtime env prefix is ALISSA_ORC_*.

Install

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