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

alissa/tools/github/devloop/state.py

@@ -0,0 +1,113 @@
+"""Local spawn ledger.
+
+Deliberately thin: GitHub is the source of truth for whether an issue is in
+flight (the daemon self-assigns before spawning). This table exists only to
+count developer attempts per issue, to age the newest spawn so a stale one
+can be retried, and to remember which escalations were already raised.
+
+Escalations are keyed per KIND ("cap", "assignment", "stalled", ...): each
+condition has its own operator remedy (raise attempt_cap; grant push access;
+check the developer session / close its PR), so each kind's comment must
+never silence another's -- each kind dedupes independently. Kind is
+free-form TEXT: a caller can narrow a kind's dedupe scope by folding more
+key into the string (the stalled ping is keyed per deferral episode,
+"stalled:a<attempt>" -- see loop.stalled_kind).
+
+Keying: every `repo_slug` is the full `owner/repo` slug (`Issue.full_name`),
+never the bare repo name. Two owners can host repos with the same bare name,
+and a bare-name key would collide their ledgers into one row.
+"""
+
+from __future__ import annotations
+
+import sqlite3
+import time
+from pathlib import Path
+
+SCHEMA = """
+CREATE TABLE IF NOT EXISTS spawns (
+    repo_slug  TEXT    NOT NULL,
+    issue      INTEGER NOT NULL,
+    attempt    INTEGER NOT NULL,
+    session    TEXT    NOT NULL,
+    spawned_at INTEGER NOT NULL,
+    PRIMARY KEY (repo_slug, issue, attempt)
+);
+
+CREATE TABLE IF NOT EXISTS escalations (
+    repo_slug    TEXT    NOT NULL,
+    issue        INTEGER NOT NULL,
+    kind         TEXT    NOT NULL,
+    escalated_at INTEGER NOT NULL,
+    PRIMARY KEY (repo_slug, issue, kind)
+);
+"""
+
+
+class State:
+    def __init__(self, path: Path):
+        path = Path(path).expanduser()
+        path.parent.mkdir(parents=True, exist_ok=True)
+        self._db = sqlite3.connect(str(path))
+        self._db.row_factory = sqlite3.Row
+        self._db.executescript(SCHEMA)
+        self._db.commit()
+
+    def close(self) -> None:
+        self._db.close()
+
+    def __enter__(self) -> "State":
+        return self
+
+    def __exit__(self, *exc) -> None:
+        self.close()
+
+    def record_spawn(self, *, repo_slug: str, issue: int, attempt: int, session: str) -> None:
+        """Record a developer spawn. `repo_slug` is `owner/repo`."""
+        self._db.execute(
+            "INSERT OR REPLACE INTO spawns "
+            "(repo_slug, issue, attempt, session, spawned_at) VALUES (?,?,?,?,?)",
+            (repo_slug, issue, attempt, session, int(time.time())),
+        )
+        self._db.commit()
+
+    def attempt_count(self, repo_slug: str, issue: int) -> int:
+        row = self._db.execute(
+            "SELECT COUNT(*) AS n FROM spawns WHERE repo_slug=? AND issue=?",
+            (repo_slug, issue),
+        ).fetchone()
+        return int(row["n"])
+
+    def spawn_age(self, repo_slug: str, issue: int) -> float | None:
+        """Seconds since the NEWEST spawn for this issue, or None if never
+        spawned. Newest, not first: a retry resets the staleness clock.
+
+        Clamped at 0.0: `spawned_at` is wall-clock, so an NTP or manual clock
+        correction can put it in the future. A negative age is treated as
+        "just spawned / unknown", never propagated."""
+        row = self._db.execute(
+            "SELECT MAX(spawned_at) AS ts FROM spawns WHERE repo_slug=? AND issue=?",
+            (repo_slug, issue),
+        ).fetchone()
+        return None if row["ts"] is None else max(0.0, time.time() - row["ts"])
+
+    def escalated(self, repo_slug: str, issue: int, kind: str) -> bool:
+        """Whether an escalation of this KIND was already raised. Kinds
+        dedupe independently -- a cap-out row never silences an
+        assignment-rejection comment, and vice versa."""
+        row = self._db.execute(
+            "SELECT 1 FROM escalations WHERE repo_slug=? AND issue=? AND kind=?",
+            (repo_slug, issue, kind),
+        ).fetchone()
+        return row is not None
+
+    def record_escalation(self, repo_slug: str, issue: int, kind: str) -> None:
+        """Idempotent per kind: OR IGNORE keeps the FIRST escalation's
+        timestamp, so `escalated_at` is an audit field for when this kind of
+        escalation was first raised, not the most recent re-raise."""
+        self._db.execute(
+            "INSERT OR IGNORE INTO escalations "
+            "(repo_slug, issue, kind, escalated_at) VALUES (?,?,?,?)",
+            (repo_slug, issue, kind, int(time.time())),
+        )
+        self._db.commit()

alissa/tools/github/devloop/version

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

alissa/tools/github/devloop/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-devloop", dirpath=os.path.dirname(__file__))
+except Exception:
+    print("Version file not found for package name: alissa-tools-github-devloop, using 0.0.0")
+    version = Version(name="alissa-tools-github-devloop", value="0.0.0")

alissa_tools_github_devloop-0.1.0.dist-info/METADATA

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: alissa-tools-github-devloop
+Version: 0.1.0
+Summary: ALISSA-TOOLS-GITHUB-DEVLOOP
+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-devloop
+
+The `alissa.tools.github.devloop` module: a GitHub watcher that turns
+`alissa:develop`-labeled issues into fresh developer sessions — the
+developer-side counterpart of
+[`alissa-tools-github-reviewloop`](https://github.com/fahera-mx/alissa-github-review-daemon).
+
+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
+        ├── devloop/      __init__.py    ← THIS distribution
+        └── 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.
+
+## Install
+
+```sh
+pip install -e ./alissa-tools-github-devloop
+```
+
+## Console scripts
+
+| Command | Entry point |
+| --- | --- |
+| `alissa-devloop` | `alissa.tools.github.devloop.__main__:main` |
+
+## Layout
+
+`src/main` holds the package tree, `src/test` mirrors it as `test_*`. The
+distribution version lives in the plain-text `version` file next to the module
+it versions (`src/main/alissa/tools/github/devloop/version`), read by both
+`setup.py` and `version.py`.

alissa_tools_github_devloop-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+alissa/tools/github/devloop/__init__.py,sha256=PQXfVmykwq6E1S3g0c49wW6v8jB3y8svslqXUWd2NRI,506
+alissa/tools/github/devloop/__main__.py,sha256=qXxJxWSRfRNa6EvctidvvdAMy0HuPtZpO8sn-tdzGHo,7772
+alissa/tools/github/devloop/alissa.py,sha256=b2Wbpi7_K-BCOz608UTU98R960BeFRbjLaCpHf5Qh-8,2660
+alissa/tools/github/devloop/config.py,sha256=TMtdq5Zt9nWOdRWuKmZAPqT1nJuzbYqezCfQqQ_DOfY,13678
+alissa/tools/github/devloop/ghclient.py,sha256=nhx4bupNvbyhGrQTUyJ2BA8HCmROa2sYx5YFFtEs1J4,17870
+alissa/tools/github/devloop/loop.py,sha256=6TD3mmmuiHDK6XzNn-3-V3HeuxNLJvoYRkfs1LL1HTQ,27657
+alissa/tools/github/devloop/proc.py,sha256=_dDr3g76WEf2DRyLUz1Dzl4KvLVptJant_UZOrRixNk,1649
+alissa/tools/github/devloop/state.py,sha256=nUR5v5CzM7jnx5g32tLEYgQmLiYEXcIxaRLu2YeUPg0,4443
+alissa/tools/github/devloop/version,sha256=6d2FB_S_DG9CRY5BrqgzrQvT9hJycjNe7pv01YVB7Wc,6
+alissa/tools/github/devloop/version.py,sha256=znuuOaitXGrBpbskNy78_rlVpFdtmKmk_3k1ACxZrl0,1418
+alissa_tools_github_devloop-0.1.0.dist-info/METADATA,sha256=44ZvqeNYyHQre4kHPs6S8x34mahJQcHHuiQALPaEsUs,2093
+alissa_tools_github_devloop-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+alissa_tools_github_devloop-0.1.0.dist-info/entry_points.txt,sha256=yrExoFJZtWoSycWqsEoYYz-lvsCtXj4-TCGaebQSmbY,77
+alissa_tools_github_devloop-0.1.0.dist-info/top_level.txt,sha256=DodjDg-l-TWQnlxG-Vuc3G5sB4O7cWGQwe6XrVx3u-A,7
+alissa_tools_github_devloop-0.1.0.dist-info/RECORD,,

alissa_tools_github_devloop-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_devloop-0.1.0.dist-info/entry_points.txt

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

alissa_tools_github_devloop-0.1.0.dist-info/top_level.txt

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