alissa-tools-github-orcloop 0.1.0__py3-none-any.whl

alissa/tools/github/orcloop/__init__.py

@@ -0,0 +1,15 @@
+"""orcloop — the orchestrator daemon of the Alissa GitHub daemon family.
+
+Where devloop watches `alissa:develop`-labeled issues and reviewloop reacts to
+review requests, orcloop sits one level up: it walks the **Alissa task graph**,
+releases tasks marked ready as `alissa:develop` issues, and closes the loop when
+the resulting PR merges. It is the mechanical driver that turns committed work in
+Alissa into GitHub issues the develop/review daemons can pick up.
+
+This is the **O0 scaffold**: the distribution skeleton, repo tooling, and CLI
+stub only — no daemon logic. The moving parts (config surface, Alissa/GitHub
+clients, the decision loop, the Docker image) land across O1–O5; see the repo
+README's lane map. The reserved runtime env prefix is `ALISSA_ORC_*`.
+"""
+
+__all__: list[str] = []

alissa/tools/github/orcloop/__main__.py

@@ -0,0 +1,45 @@
+"""CLI entry point: alissa-orcloop (or python -m alissa.tools.github.orcloop).
+
+O0 scaffold stub. The real daemon — task-graph walk, issue release, and the
+merge close-loop — arrives in O1–O5 (see the repo README's lane map). For now
+this parser only knows `--version` and prints the daemon's role, so the
+distribution, entry point, and version wiring can be exercised end to end
+before any logic exists. The reserved runtime env prefix is `ALISSA_ORC_*`.
+"""
+
+from __future__ import annotations
+
+import argparse
+
+from .version import version
+
+ROLE = (
+    "alissa-orcloop — the orchestrator daemon (O0 scaffold).\n"
+    "Role in the four-daemon pipeline: walk the Alissa task graph, release "
+    "tasks marked ready as alissa:develop issues, and close the loop when the "
+    "resulting PR merges. Daemon logic lands in O1-O5; this is the scaffold "
+    "stub."
+)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="alissa-orcloop",
+        description="Orchestrate the Alissa task graph into alissa:develop "
+        "issues and close the loop on merge — the orchestrator daemon of the "
+        "Alissa GitHub daemon family. (O0 scaffold: --version only.)",
+    )
+    p.add_argument(
+        "--version", action="version", version=f"%(prog)s {version.value}"
+    )
+    return p
+
+
+def main(argv: "list[str] | None" = None) -> int:
+    build_parser().parse_args(argv)
+    print(ROLE)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

alissa/tools/github/orcloop/version

@@ -0,0 +1 @@
+0.1.0

alissa/tools/github/orcloop/version.py

@@ -0,0 +1,46 @@
+import os
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True, slots=True)
+class Version:
+    name: str
+    value: str
+
+    def components(self, as_int: bool = False) -> list:
+        return [int(val) if as_int else val for val in self.value.split(".")]
+
+    @property
+    def major(self) -> int:
+        component, *_ = self.components(as_int=True)
+        return component
+
+    @property
+    def minor(self) -> int:
+        _, component, *_ = self.components(as_int=True)
+        return component
+
+    @property
+    def patch(self) -> int:
+        *_, component = self.components(as_int=True)
+        return component
+
+    @classmethod
+    def from_path(cls, dirpath: str, name: str):
+        for file in os.listdir(dirpath):
+            if file.lower().endswith("version"):
+                filepath = os.path.join(dirpath, file)
+                break
+        else:
+            raise ValueError("Version file not found for package name: " + name)
+
+        with open(filepath, "r") as version_file:
+            version_value = version_file.readline().strip()
+            return cls(name=name, value=version_value)
+
+
+try:
+    version = Version.from_path(name="alissa-tools-github-orcloop", dirpath=os.path.dirname(__file__))
+except Exception:
+    print("Version file not found for package name: alissa-tools-github-orcloop, using 0.0.0")
+    version = Version(name="alissa-tools-github-orcloop", value="0.0.0")

alissa_tools_github_orcloop-0.1.0.dist-info/METADATA

@@ -0,0 +1,62 @@
+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
+```

alissa_tools_github_orcloop-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+alissa/tools/github/orcloop/__init__.py,sha256=-qMxex2s1FfOB8wVxPVU4STEu5dUOF0NBt1MaMHgJuI,801
+alissa/tools/github/orcloop/__main__.py,sha256=OS1PoppI65DWgL8ypgcYG2JgOXNiSqne0EdG-_iO0hI,1511
+alissa/tools/github/orcloop/version,sha256=6d2FB_S_DG9CRY5BrqgzrQvT9hJycjNe7pv01YVB7Wc,6
+alissa/tools/github/orcloop/version.py,sha256=Z2v-AJyJRQLyk2_cpboLzvbNruATyw5FZd64FYUBS1I,1418
+alissa_tools_github_orcloop-0.1.0.dist-info/METADATA,sha256=oyLFLEtQuP7O2jKCltpXJK54bXSqIr4NVfj1VZveVxc,2486
+alissa_tools_github_orcloop-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+alissa_tools_github_orcloop-0.1.0.dist-info/entry_points.txt,sha256=Zf_eu8vtkOsNG1yeMgNWc-Sp4vfsMmoCOM8_WHoeGpk,77
+alissa_tools_github_orcloop-0.1.0.dist-info/top_level.txt,sha256=DodjDg-l-TWQnlxG-Vuc3G5sB4O7cWGQwe6XrVx3u-A,7
+alissa_tools_github_orcloop-0.1.0.dist-info/RECORD,,

alissa_tools_github_orcloop-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

alissa_tools_github_orcloop-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+alissa-orcloop = alissa.tools.github.orcloop.__main__:main

alissa_tools_github_orcloop-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+alissa