alissa-tools-github-orcloop 0.1.0__tar.gz → 0.3.0__tar.gz

{alissa_tools_github_orcloop-0.1.0/src/main/alissa_tools_github_orcloop.egg-info → alissa_tools_github_orcloop-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alissa-tools-github-orcloop
-Version: 0.1.0
+Version: 0.3.0
 Summary: ALISSA-TOOLS-GITHUB-ORCLOOP
 Home-page: https://alissa.app
 Author: Fahera
@@ -46,13 +46,16 @@ The rule: a distribution owns a leaf package and declares only that subtree
 `__init__.py` at any namespace level would claim it for one distribution and
 shadow the others.
 
-## Status — O0 scaffold
+## Status
 
-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_*`.
+The daemon is live: the config surface (O1), the Alissa/GitHub clients and the
+release ledger (O2), and the decision loop — both the release and close edges
+(O3) — are all in place, driven by the `alissa-orcloop` CLI. See the repo
+[README](../README.md) for the end-to-end documentation: the pipeline role, the
+`Autonomous-Dev` / `Autonomous-Scope` marker contract, both decision matrices,
+the full `ALISSA_ORC_*` configuration surface, and the escalation catalog.
+Packaging the daemon as a container image (O5) is the remaining lane. The
+reserved runtime env prefix is `ALISSA_ORC_*`.
 
 ## Install
 

{alissa_tools_github_orcloop-0.1.0 → alissa_tools_github_orcloop-0.3.0}/README.md

@@ -29,13 +29,16 @@ The rule: a distribution owns a leaf package and declares only that subtree
 `__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_*`.
+## Status
+
+The daemon is live: the config surface (O1), the Alissa/GitHub clients and the
+release ledger (O2), and the decision loop — both the release and close edges
+(O3) — are all in place, driven by the `alissa-orcloop` CLI. See the repo
+[README](../README.md) for the end-to-end documentation: the pipeline role, the
+`Autonomous-Dev` / `Autonomous-Scope` marker contract, both decision matrices,
+the full `ALISSA_ORC_*` configuration surface, and the escalation catalog.
+Packaging the daemon as a container image (O5) is the remaining lane. The
+reserved runtime env prefix is `ALISSA_ORC_*`.
 
 ## Install
 

{alissa_tools_github_orcloop-0.1.0 → alissa_tools_github_orcloop-0.3.0}/src/main/alissa/tools/github/orcloop/__init__.py

@@ -6,9 +6,9 @@ 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
+O1 landed the config surface (`config.py`), the marker contract (`markers.py`),
+and the real `alissa-orcloop` CLI. The remaining moving parts (Alissa/GitHub
+clients, the decision loop, the Docker image) land across O2–O5; see the repo
 README's lane map. The reserved runtime env prefix is `ALISSA_ORC_*`.
 """
 

alissa_tools_github_orcloop-0.3.0/src/main/alissa/tools/github/orcloop/__main__.py

@@ -0,0 +1,269 @@
+"""CLI entry point: alissa-orcloop (or python -m alissa.tools.github.orcloop).
+
+O1 wired the config surface and the argument parser; O3 wires the decision
+loop behind it; O6 adds the release-feed selector (`--release-feed bow` and its
+`--bow-prefix` / `--bow-owner` / `--scan-fallback-interval` knobs).
+
+The CLI resolves and validates the full configuration
+(four-layer precedence, fail-closed `repos` guard), reports the effective
+settings, then runs the orchestrator: `--once` for a single sweep (pair it
+with `--dry-run -v` to print every decision and its reasons without touching
+GitHub or the task graph), otherwise `run_forever`. Config errors still surface
+here, at startup, with a clean exit code.
+"""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import sys
+from pathlib import Path
+
+from .alissa_client import AlissaError
+from .config import (
+    FEED_BOW,
+    RELEASE_FEEDS,
+    Config,
+    load_config_file,
+    resolve_config_path,
+)
+from .ghclient import RateLimited
+from .loop import Orchestrator
+from .proc import CommandError
+from .version import version
+
+log = logging.getLogger(__name__)
+
+
+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.",
+        epilog="Every setting below can also live in the config file; a CLI "
+        "flag wins over the file, and an ALISSA_ORC_* environment variable "
+        "wins over the flag. workspace_root is CLI-only, so one config can "
+        "drive several orchestrators over different workspaces.",
+    )
+
+    p.add_argument(
+        "--version", action="version", version=f"%(prog)s {version.value}"
+    )
+    p.add_argument(
+        "--workspace-root",
+        type=Path,
+        default=None,
+        metavar="PATH",
+        help="the workspace this orchestrator runs against (default: current "
+        "directory); also where the ledger defaults",
+    )
+    p.add_argument(
+        "-c",
+        "--config-path",
+        "--config",
+        dest="config_path",
+        type=Path,
+        default=None,
+        metavar="PATH",
+        help="config file; without it, ./orcloop.config.json then "
+        "<workspace-root>/orcloop.config.json, else defaults only",
+    )
+
+    mode = p.add_argument_group("mode")
+    mode.add_argument(
+        "--once", action="store_true", help="run a single pass and exit"
+    )
+    mode.add_argument("-v", "--verbose", action="store_true")
+
+    over = p.add_argument_group(
+        "config overrides (win over the config file; ALISSA_ORC_* wins over these)"
+    )
+    over.add_argument(
+        "--repo",
+        dest="repos",
+        action="append",
+        metavar="OWNER/REPO",
+        help="watch this repo; repeatable. When given, REPLACES the config "
+        "`repos` list. The allowlist is fail-closed: an empty allowlist is a "
+        "fatal startup error, not a no-op.",
+    )
+    over.add_argument("--label", metavar="LABEL", help="issue label released work carries")
+    over.add_argument("--poll-interval", type=int, metavar="SECONDS")
+    over.add_argument("--repo-parallelism", type=int, metavar="N", help="repos advanced per pass")
+    over.add_argument("--release-blocked-floor-days", type=int, metavar="DAYS")
+    over.add_argument("--marker-key", metavar="KEY", help="Autonomous-Dev trailer key")
+    over.add_argument("--scope-key", metavar="KEY", help="Autonomous-Scope trailer key")
+    over.add_argument("--alissa-endpoint", metavar="URL")
+    over.add_argument("--ledger-path", type=Path, metavar="PATH")
+    over.add_argument(
+        "--release-feed",
+        choices=RELEASE_FEEDS,
+        metavar="{" + ",".join(RELEASE_FEEDS) + "}",
+        help="where release candidates come from: 'scan' (the default) lists "
+        "every committed task and filters it on the release marker; 'bow' "
+        "reads the per-repo Bodies of Work named <bow-prefix><owner>/<repo>, "
+        "where attaching a task is the release trigger AND the repo declaration",
+    )
+    over.add_argument(
+        "--bow-prefix",
+        metavar="PREFIX",
+        help="title prefix that marks a Body of Work as a release feed "
+        "(default 'autodev: '); the rest of the title is the target owner/repo",
+    )
+    over.add_argument(
+        "--bow-owner",
+        dest="bow_owners",
+        action="append",
+        metavar="ACTOR_ID",
+        help="bow feed only: trust bodies of work OWNED by this Alissa actor "
+        "as release feeds; repeatable. When given, REPLACES the config "
+        "`bow_owners` list. Fail-closed like --repo: `--release-feed bow` with "
+        "an empty owner list is a fatal startup error, because being SHARED a "
+        "body of work is not a claim to drive this daemon. An actor id is the "
+        "`ownerActorId` on the container's row in GET /v1/bodies-of-work.",
+    )
+    over.add_argument(
+        "--scan-fallback-interval",
+        type=int,
+        metavar="SECONDS",
+        help="bow feed only: how often to ALSO run the full marker scan and "
+        "log every marked task the feed did not surface (default 3600; 0 "
+        "disables it). The sweep reports, it never releases.",
+    )
+
+    close = over.add_mutually_exclusive_group()
+    close.add_argument(
+        "--close-loop",
+        dest="close_loop_enabled",
+        action="store_true",
+        default=None,
+        help="drive the origin task forward when a released PR merges (the default)",
+    )
+    close.add_argument(
+        "--no-close-loop",
+        dest="close_loop_enabled",
+        action="store_false",
+        help="release-only: never act on merges, even if the config enables it",
+    )
+
+    dry = over.add_mutually_exclusive_group()
+    dry.add_argument(
+        "--dry-run",
+        dest="dry_run",
+        action="store_true",
+        default=None,
+        help="decide and log, but never release an issue or touch task/GitHub state",
+    )
+    dry.add_argument(
+        "--no-dry-run",
+        dest="dry_run",
+        action="store_false",
+        help="act for real even if the config sets dry_run",
+    )
+    return p
+
+
+def overrides_from(args: argparse.Namespace) -> dict:
+    """CLI values, with None meaning 'not specified' so the config file shows
+    through. `repos` becomes a tuple so it matches the file form."""
+    return {
+        "repos": tuple(args.repos) if args.repos else None,
+        "label": args.label,
+        "poll_interval": args.poll_interval,
+        "repo_parallelism": args.repo_parallelism,
+        "release_blocked_floor_days": args.release_blocked_floor_days,
+        "marker_key": args.marker_key,
+        "scope_key": args.scope_key,
+        "alissa_endpoint": args.alissa_endpoint,
+        "ledger_path": args.ledger_path,
+        "close_loop_enabled": args.close_loop_enabled,
+        "dry_run": args.dry_run,
+        "release_feed": args.release_feed,
+        "bow_prefix": args.bow_prefix,
+        "bow_owners": tuple(args.bow_owners) if args.bow_owners else None,
+        "scan_fallback_interval": args.scan_fallback_interval,
+    }
+
+
+def resolve_config(args: argparse.Namespace) -> Config:
+    workspace_root = args.workspace_root or Path.cwd()
+    path = resolve_config_path(args.config_path, workspace_root)
+
+    file_data = load_config_file(path) if path else {}
+    log.info("config: %s", path or "none found — defaults + CLI + env only")
+
+    return Config.build(workspace_root, file_data, overrides_from(args))
+
+
+def log_effective_config(config: Config) -> None:
+    """The resolved settings, defaults and all. INFO carries the decisions an
+    operator needs; -v (DEBUG) shows the full surface."""
+    log.info("watching %s for label %r", ", ".join(config.repos), config.label)
+    log.info(
+        "poll every %ss; repo_parallelism=%s; dry_run=%s; close_loop=%s",
+        config.poll_interval, config.repo_parallelism, config.dry_run,
+        config.close_loop_enabled,
+    )
+    if config.release_feed == FEED_BOW:
+        log.info(
+            "release feed: bow — candidates are the tasks attached to the "
+            "%r bodies of work OWNED by %s; scan fallback sweep %s",
+            config.bow_prefix,
+            ", ".join(config.bow_owners),
+            f"every {config.scan_fallback_interval}s"
+            if config.scan_fallback_interval
+            else "DISABLED",
+        )
+    else:
+        log.info(
+            "release feed: scan — candidates are committed tasks carrying %r, "
+            "targeted by their %s trailer",
+            config.label, config.marker_key,
+        )
+    log.debug("marker_key: %s", config.marker_key)
+    log.debug("scope_key: %s", config.scope_key)
+    log.debug("release_blocked_floor_days: %s", config.release_blocked_floor_days)
+    log.debug("alissa_endpoint: %s", config.alissa_endpoint)
+    log.debug("ledger_db: %s", config.ledger_db)
+
+
+def main(argv: "list[str] | None" = None) -> int:
+    args = build_parser().parse_args(argv)
+
+    logging.basicConfig(
+        level=logging.DEBUG if args.verbose else logging.INFO,
+        format="%(asctime)s %(levelname)-7s %(message)s",
+        datefmt="%H:%M:%S",
+    )
+
+    try:
+        config = resolve_config(args)
+        log.info("workspace: %s", config.workspace_root)
+        log_effective_config(config)
+    except (FileNotFoundError, ValueError) as exc:
+        print(f"config error: {exc}", file=sys.stderr)
+        return 2
+    except KeyboardInterrupt:
+        return 0
+
+    orchestrator = Orchestrator(config)
+    try:
+        if args.once:
+            orchestrator.poll_once()
+        else:
+            log.info("starting orchestrator; polling every %ss", config.poll_interval)
+            orchestrator.run_forever()
+    except KeyboardInterrupt:
+        return 0
+    except (AlissaError, CommandError, RateLimited) as exc:
+        # A single --once pass surfaces a transport/adapter failure as a non-zero
+        # exit for the operator; run_forever swallows and backs off instead of
+        # exiting, so this only fires under --once.
+        print(f"orchestrator error: {exc}", file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())