sase-github 0.1.0__py3-none-any.whl

sase_github/__init__.py

@@ -0,0 +1,5 @@
+"""sase-github: GitHub VCS plugin for sase."""
+
+from sase_github.plugin import GitHubPlugin
+
+__all__ = ["GitHubPlugin"]

sase_github/plugin.py

@@ -0,0 +1,44 @@
+"""GitHub VCS plugin implementation.
+
+Handles git repositories hosted on GitHub (or similar hosted services).
+Inherits shared git operations from :class:`GitCommon` and adds
+GitHub-specific methods (``mail`` with PR creation, ``get_cl_number``
+and ``get_change_url`` via ``gh`` CLI).
+"""
+
+from sase.vcs_provider._hookspec import hookimpl
+from sase.vcs_provider.plugins._git_common import GitCommon
+
+
+class GitHubPlugin(GitCommon):
+    """Pluggy plugin for GitHub-hosted git repositories."""
+
+    @hookimpl
+    def vcs_get_change_url(self, cwd: str) -> tuple[bool, str | None]:
+        out = self._run(["gh", "pr", "view", "--json", "url", "-q", ".url"], cwd)
+        if out.success:
+            url = out.stdout.strip()
+            return (True, url) if url else (True, None)
+        return (True, None)
+
+    @hookimpl
+    def vcs_get_cl_number(self, cwd: str) -> tuple[bool, str | None]:
+        out = self._run(["gh", "pr", "view", "--json", "number", "-q", ".number"], cwd)
+        if out.success:
+            number = out.stdout.strip()
+            return (True, number) if number else (True, None)
+        return (True, None)
+
+    @hookimpl
+    def vcs_mail(self, revision: str, cwd: str) -> tuple[bool, str | None]:
+        out = self._run(["git", "push", "-u", "origin", revision], cwd)
+        if not out.success:
+            return self._to_result(out, "git push")
+        pr_check = self._run(
+            ["gh", "pr", "view", "--json", "number", "-q", ".number"], cwd
+        )
+        if not pr_check.success:
+            pr_create = self._run(["gh", "pr", "create", "--fill"], cwd)
+            if not pr_create.success:
+                return self._to_result(pr_create, "gh pr create")
+        return (True, None)

sase_github/xprompts/gh.yml

@@ -0,0 +1,87 @@
+wraps_all: true
+
+input:
+  - name: gh_ref
+    type: word
+  - name: n
+    type: int
+    default: null
+  - name: release
+    type: bool
+    default: true
+
+steps:
+  - name: setup
+    python: |
+      from sase.scripts.gh_setup import main
+      main(
+          gh_ref={{ gh_ref | tojson }},
+          n={{ n | tojson }},
+          release={{ release | tojson }},
+      )
+    output:
+      project_name: word
+      project_file: path
+      workspace_dir: path
+      workspace_num: int
+      checkout_target: word
+      primary_workspace_dir: path
+      should_release: bool
+
+  - name: prepare
+    bash: |
+      # Save diff backup if workspace is dirty
+      if ! git diff --quiet HEAD 2>/dev/null; then
+        git diff HEAD > "/tmp/gh-workspace-backup-$(date +%s).patch"
+      fi
+      git checkout . && git clean -fd
+      git fetch --quiet
+      git pull --rebase --quiet 2>&1 || true
+      echo "head_before=$(git rev-parse HEAD)"
+      echo "success=true"
+    output: { success: bool, head_before: word }
+
+  - name: inject
+    prompt_part: ""
+
+  - name: release
+    if: "{{ setup.should_release }}"
+    python: |
+      from sase.running_field import release_workspace
+
+      release_workspace(
+          {{ setup.project_file | tojson }},
+          {{ setup.workspace_num }},
+          f"gh-{{ gh_ref }}",
+          {{ gh_ref | tojson }} if "/" not in {{ gh_ref | tojson }} else None,
+      )
+      print("released=true")
+    output: { released: bool }
+
+  - name: diff
+    bash: |
+      head_before="{{ prepare.head_before }}"
+      if [ -z "$head_before" ]; then
+        exit 0
+      fi
+      head_now=$(git rev-parse HEAD)
+      diff_file=$(mktemp /tmp/sase-gh-XXXXXX.diff)
+      if [ "$head_now" != "$head_before" ]; then
+        # Commits were made — show only the last commit's diff
+        git diff HEAD~1 HEAD > "$diff_file" 2>/dev/null
+        commit_msg=$(git log -1 --format='%s' HEAD)
+        echo "meta_commit_message=$commit_msg"
+      else
+        # No commits — show uncommitted changes
+        git diff HEAD > "$diff_file" 2>/dev/null
+        git ls-files --others --exclude-standard -z 2>/dev/null \
+          | while IFS= read -r -d '' f; do
+              git diff --no-index /dev/null "$f" 2>/dev/null
+            done >> "$diff_file"
+      fi
+      if [ -s "$diff_file" ]; then
+        echo "diff_path=$diff_file"
+      else
+        rm -f "$diff_file"
+      fi
+    output: { diff_path: path, meta_commit_message: line }

sase_github/xprompts/new_pr_desc.yml

@@ -0,0 +1,64 @@
+input:
+  - name: name
+    type: word
+
+steps:
+  - name: get_context
+    python: |
+      from sase.scripts.new_pr_desc_get_context import main
+      main(name={{ name | tojson }})
+    output:
+      error: line
+      description: line
+      diff_file: path
+      commits: text
+      workspace_dir: path
+      default_branch: word
+      branch_name: word
+
+  - name: generate
+    if: "{{ not get_context.error }}"
+    agent: |
+      Generate a PR title and body for the following changes.
+
+      ## ChangeSpec Description
+      {{ get_context.description }}
+
+      ## Commits
+      {{ get_context.commits }}
+
+      ## Diff
+      @{{ get_context.diff_file }}
+
+      ## Instructions
+      - PR title: Use conventional commit format (e.g., "feat: ...", "fix: ..."), under 72 characters
+      - PR body: Start with "## Summary" followed by 1-3 bullet points
+
+      Output EXACTLY in this format (no extra text):
+      TITLE: <your title here>
+      BODY:
+      <your body here>
+
+  - name: apply
+    if: "{{ not get_context.error }}"
+    bash: |
+      # Check if PR exists for this branch
+      PR_NUMBER=$(gh pr view "{{ get_context.branch_name }}" --json number --jq '.number' 2>/dev/null || echo "")
+      if [ -z "$PR_NUMBER" ]; then
+        echo "applied=false"
+        echo "No existing PR found for branch {{ get_context.branch_name }}"
+        exit 0
+      fi
+
+      # Extract title and body from response
+      RESPONSE="{{ _response }}"
+      TITLE=$(echo "$RESPONSE" | grep -m1 '^TITLE: ' | sed 's/^TITLE: //')
+      BODY=$(echo "$RESPONSE" | sed -n '/^BODY:$/,$ p' | tail -n +2)
+
+      if [ -n "$TITLE" ] && [ -n "$BODY" ]; then
+        gh pr edit "$PR_NUMBER" --title "$TITLE" --body "$BODY" 2>/dev/null && echo "applied=true" || echo "applied=false"
+      else
+        echo "applied=false"
+        echo "Could not parse title/body from response"
+      fi
+    output: { applied: bool }

sase_github/xprompts/pr.yml

@@ -0,0 +1,88 @@
+input:
+  - name: name
+    type: word
+
+steps:
+  - name: create_branch
+    bash: |
+      BRANCH="{{ name }}"
+      git checkout -b "$BRANCH" 2>&1
+      git push -u origin "$BRANCH" 2>&1
+      echo "branch_name=$BRANCH"
+      echo "meta_changespec=$BRANCH"
+    output:
+      branch_name: word
+
+  - name: inject
+    prompt_part: ""
+
+  - name: create_changespec
+    hidden: true
+    python: |
+      from sase.scripts.pr_create_changespec import main
+      main(
+          name={{ name | tojson }},
+          prompt={{ _prompt | tojson }},
+          response={{ _response | tojson }},
+      )
+    output:
+      success: bool
+      cl_name: word
+      project_file: path
+      default_branch: word
+
+  - name: create_pr
+    hidden: true
+    if: "{{ create_changespec.success | default(false) }}"
+    bash: |
+      BRANCH="{{ create_branch.branch_name }}"
+      DEFAULT_BRANCH="{{ create_changespec.default_branch }}"
+
+      # Check for existing PR first
+      EXISTING_URL=$(gh pr view "$BRANCH" --json url --jq '.url' 2>/dev/null || echo "")
+      if [ -n "$EXISTING_URL" ]; then
+        echo "pr_url=$EXISTING_URL"
+        echo "success=true"
+        exit 0
+      fi
+
+      # Get PR title from first commit
+      PR_TITLE=$(git log --format='%s' "origin/$DEFAULT_BRANCH".."$BRANCH" 2>/dev/null | tail -1)
+      if [ -z "$PR_TITLE" ]; then
+        PR_TITLE="Agent changes on branch $BRANCH"
+      fi
+
+      PR_URL=$(gh pr create \
+        --base "$DEFAULT_BRANCH" \
+        --head "$BRANCH" \
+        --title "$PR_TITLE" \
+        --body "Automated PR from sase." 2>&1) || true
+
+      if echo "$PR_URL" | grep -q "^http"; then
+        echo "pr_url=$PR_URL"
+        echo "success=true"
+      else
+        echo "pr_url="
+        echo "success=false"
+        echo "Error: $PR_URL" >&2
+      fi
+    output: { pr_url: line, success: bool }
+
+  - name: update_cl
+    hidden: true
+    if: "{{ create_pr.success | default(false) }}"
+    python: |
+      from sase.status_state_machine import update_changespec_cl_atomic
+
+      project_file = {{ create_changespec.project_file | tojson }}
+      cl_name = {{ create_changespec.cl_name | tojson }}
+      pr_url = {{ create_pr.pr_url | tojson }}
+
+      if pr_url and pr_url.startswith("http"):
+          update_changespec_cl_atomic(project_file, cl_name, pr_url)
+          print("updated=true")
+          print(f"pr_url={pr_url}")
+      else:
+          print("updated=false")
+          print(f"pr_url={pr_url}")
+    output: { updated: bool, pr_url: line }

sase_github-0.1.0.dist-info/METADATA

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: sase-github
+Version: 0.1.0
+Summary: GitHub VCS plugin for sase
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: sase>=0.1.0
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest-mock; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'

sase_github-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+sase_github/__init__.py,sha256=xeuI37R-jN0XKnfVC6KOw0mLOkocjYTYGz-vdC-xshU,120
+sase_github/plugin.py,sha256=rQg042xufx8MzMyAqYnc9kshbYI1nQDI9LoInQbaIwI,1727
+sase_github/xprompts/gh.yml,sha256=xtuTDvox_Py_p9cA6z_VUbgp72IZG2AU4kVV8IXKaXA,2443
+sase_github/xprompts/new_pr_desc.yml,sha256=40wASzusygfOdeIsys_Dg4mL4hpjuaA36zUotuit1DI,1889
+sase_github/xprompts/pr.yml,sha256=ZLWfsqTVwo_g3DVyNQqLHdxE1PHcyyB0M7irCnNS7r0,2485
+sase_github-0.1.0.dist-info/METADATA,sha256=8Ide9MGsYI271C5kunOaHwF9ew1Adyj1o_36t4qACzY,403
+sase_github-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+sase_github-0.1.0.dist-info/entry_points.txt,sha256=78aQwHeD5IhKgyirp9LXuSqwSwpINmK8ksAToIjaQ3Y,95
+sase_github-0.1.0.dist-info/licenses/LICENSE,sha256=KPJBpPDM-x7UoMJM17Ze0qRlTgtDJcRFUcXu6Xrt9zk,1068
+sase_github-0.1.0.dist-info/RECORD,,

sase_github-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

sase_github-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[sase_vcs]
+github = sase_github.plugin:GitHubPlugin
+
+[sase_xprompts]
+sase_github = sase_github

sase_github-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bryan Bugyi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.