sase-github 0.2.1__tar.gz → 0.2.3__tar.gz

sase_github-0.2.3/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.2.3"
+}

{sase_github-0.2.1 → sase_github-0.2.3}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.2.3](https://github.com/sase-org/sase-github/compare/v0.2.2...v0.2.3) (2026-08-09)
+
+
+### Documentation
+
+* mark github plugin patch compatibility boundaries ([e79c33b](https://github.com/sase-org/sase-github/commit/e79c33b231d72605957f793fb6a338c910913af0))
+
+## [0.2.2](https://github.com/sase-org/sase-github/compare/v0.2.1...v0.2.2) (2026-08-08)
+
+
+### Features
+
+* adopt Patch terminology in GitHub integration ([bc4fec5](https://github.com/sase-org/sase-github/commit/bc4fec5d436853eb9b839339d855093d13ce83aa))
+
 ## [0.2.1](https://github.com/sase-org/sase-github/compare/v0.2.0...v0.2.1) (2026-07-25)
 
 

{sase_github-0.2.1 → sase_github-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sase-github
-Version: 0.2.1
+Version: 0.2.3
 Summary: GitHub VCS plugin for sase
 License-Expression: MIT
 License-File: LICENSE

{sase_github-0.2.1 → sase_github-0.2.3}/README.md

@@ -59,7 +59,7 @@ Requires `sase>=0.11.0` as a dependency. For GitHub Enterprise Server or self-ho
 ### Workspace Provider
 
 - **GitHubWorkspacePlugin** — Workspace provider that handles GitHub-specific workflow orchestration: reference
-  resolution (repo paths, project names, changespec names), PR submission via `gh pr merge`, branch management, and
+  resolution (repo paths, project names, Patch names), PR submission via `gh pr merge`, branch management, and
   commit description formatting. It also owns GitHub SDD policy: every GitHub project requires a labeled sidecar
   repository, materialized before `#gh` work starts.
 - **Repo completion for `#gh:<owner>/` refs** — Supplies repository candidates to SASE prompt completion by calling

{sase_github-0.2.1 → sase_github-0.2.3}/docs/architecture.md

@@ -51,7 +51,7 @@ Handles higher-level workflow orchestration. Implements workspace hooks for GitH
 | `ws_create_sdd_remote()`               | Verifies or creates `--sdd`, `--plans`, or `--research` and returns its metadata  |
 | `ws_prepare_mail()`                    | Displays branch/description and prompts user before pushing                       |
 | `ws_format_commit_description()`       | Prepends `[project]` prefix to commit messages                                    |
-| `ws_submit()`                          | Submits a ChangeSpec by merging its PR via `gh pr merge --merge --delete-branch`  |
+| `ws_submit()`                          | Submits a Patch by merging its PR via `gh pr merge --merge --delete-branch`       |
 
 The provider declares `separate_repo` SDD policy. Core supplies a unique staging path; the plugin finds or creates the
 selected sidecar, ensures its `sase--sdd` label, and clones with the normal SSH/HTTPS fallback. It returns only a
@@ -98,13 +98,13 @@ When the ref matches an existing project directory, `PROJECT_NAME`, or project a
 - Reads `WORKSPACE_DIR` from the project file
 - Checks out the default branch
 
-### Mode 3: ChangeSpec Name
+### Mode 3: Patch Name
 
-When the ref matches an existing ChangeSpec:
+When the ref matches an existing Patch:
 
-- Searches all changespecs for a matching name
-- Reads `WORKSPACE_DIR` from the changespec's project file
-- Checks out `origin/<name>` (the ChangeSpec's branch)
+- Searches all Patches for a matching name
+- Reads `WORKSPACE_DIR` from the Patch's project file
+- Checks out `origin/<name>` (the Patch's branch)
 
 ## Ref Namespace Completion
 
@@ -119,14 +119,14 @@ deduplicated case-insensitively, with record-derived spellings preferred when bo
 
 ## Submission Flow
 
-When submitting a GitHub ChangeSpec (`ws_submit`):
+When submitting a GitHub Patch (`ws_submit`):
 
-1. Kill and persist all running processes on the ChangeSpec
-2. Verify no active child ChangeSpecs exist
-3. Claim a workspace and checkout the ChangeSpec branch
+1. Kill and persist all running processes on the Patch
+2. Verify no active child Patches exist
+3. Claim a workspace and checkout the Patch branch
 4. Check for an existing PR on the branch
 5. Merge via `gh pr merge --merge --delete-branch`
-6. Finalize submission (update ChangeSpec status)
+6. Finalize submission (update Patch status)
 7. Release the workspace
 
 ## Config Helper

{sase_github-0.2.1 → sase_github-0.2.3}/docs/xprompts.md

@@ -14,7 +14,7 @@ the target branch, and captures diffs.
 
 | Parameter | Type | Default | Description |
 |---|---|---|---|
-| `gh_ref` | word | (required) | Repo path (`user/project`), project name, or ChangeSpec name |
+| `gh_ref` | word | (required) | Repo path (`user/project`), project name, or Patch name |
 | `n` | int | `null` | Workspace number override (auto-assigned if null) |
 | `release` | bool | `true` | Whether to release the workspace when done |
 | `workflow_label` | word | `null` | Optional label for the workflow |
@@ -41,7 +41,7 @@ the target branch, and captures diffs.
 # Work on a project by shorthand name
 #gh(sase) Add a new CLI command for status checking
 
-# Resume work on an existing ChangeSpec
+# Resume work on an existing Patch
 #gh(fix-auth-bug) Continue implementing the OAuth flow
 
 # Work without releasing the workspace
@@ -58,12 +58,12 @@ Generates an AI-written PR title and body from the diff and commits on a branch,
 
 | Parameter | Type | Description |
 |---|---|---|
-| `name` | word | ChangeSpec name to generate the description for |
+| `name` | word | Patch name to generate the description for |
 
 ### Steps
 
 1. **get_context** — Runs a Python script that retrieves the diff, commit history, workspace directory, default branch,
-   and current branch name for the ChangeSpec.
+   and current branch name for the Patch.
 2. **generate** — Launches a sub-agent with the diff and commits, instructing it to produce a title (conventional
    commits format, under 72 chars) and a body (markdown with `## Summary` and bullet points).
 3. **apply** — Looks up the PR for the branch via `gh pr view` and updates it with `gh pr edit` using the generated

{sase_github-0.2.1 → sase_github-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sase-github"
-version = "0.2.1"
+version = "0.2.3"
 description = "GitHub VCS plugin for sase"
 requires-python = ">=3.12"
 license = "MIT"

{sase_github-0.2.1 → sase_github-0.2.3}/src/sase_github/scripts/new_pr_desc_get_context.py

@@ -5,9 +5,13 @@ import subprocess
 import tempfile
 from pathlib import Path
 
-from sase.ace.changespec import find_all_changespecs
 from sase.workspace_provider.utils import get_default_branch, parse_workspace_dir
 
+try:
+    from sase.ace.patch import find_all_patches
+except ImportError:  # Older supported SASE releases expose only ChangeSpec names.
+    from sase.ace.changespec import find_all_changespecs as find_all_patches
+
 try:
     from sase.core.paths import (  # type: ignore[attr-defined]
         get_sase_managed_tmpdir,
@@ -30,19 +34,18 @@ except ImportError:  # sase < 0.11.2 does not ship the helper yet
 
 
 def main(*, name: str) -> None:
-    """Find changespec, get diff and commit info for PR description generation.
+    """Find a Patch, then get diff and commit subjects for PR description generation.
 
     Prints key=value output for the workflow executor.
     """
-    # Find the ChangeSpec
-    changespec = None
-    for cs in find_all_changespecs():
-        if cs.name == name:
-            changespec = cs
+    patch = None
+    for candidate in find_all_patches():
+        if candidate.name == name:
+            patch = candidate
             break
 
-    if changespec is None:
-        print(f"error=ChangeSpec '{name}' not found")
+    if patch is None:
+        print(f"error=Patch '{name}' not found")
         print("description=")
         print("diff=")
         print("workspace_dir=")
@@ -50,7 +53,7 @@ def main(*, name: str) -> None:
         print("branch_name=")
         return
 
-    project_file = changespec.file_path
+    project_file = patch.file_path
     workspace_dir = parse_workspace_dir(project_file)
     if not workspace_dir:
         print("error=WORKSPACE_DIR is not set for this project")
@@ -65,7 +68,7 @@ def main(*, name: str) -> None:
     default_branch = default_branch_ref.rsplit("/", 1)[-1]
 
     # Get description
-    desc = changespec.description or "No description"
+    desc = patch.description or "No description"
 
     # Get diff against default branch
     try:

{sase_github-0.2.1 → sase_github-0.2.3}/src/sase_github/workspace_plugin.py

@@ -17,7 +17,19 @@ from collections.abc import Mapping, Sequence
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Literal
 
-from sase.ace.changespec.project_spec_path import preferred_project_spec_path
+try:
+    from sase.ace.patch import Patch, find_all_patches
+    from sase.ace.patch.project_spec_path import preferred_project_spec_path
+except ImportError:  # Older supported SASE releases expose only ChangeSpec names.
+    from sase.ace.changespec import (  # type: ignore[no-redef]
+        # Legacy import names are adapted to canonical Patch locals.
+        ChangeSpec as Patch,
+        # Legacy import names are adapted to canonical Patch locals.
+        find_all_changespecs as find_all_patches,
+    )
+    from sase.ace.changespec.project_spec_path import (  # type: ignore[no-redef]
+        preferred_project_spec_path,
+    )
 from sase.workspace_provider import (
     ExternalRepoCloneResult,
     ResolvedRef,
@@ -420,7 +432,9 @@ class GitHubWorkspacePlugin:
     @hookimpl
     def ws_prepare_mail(
         self,
+        # Legacy hook argument name retained for compatibility.
         changespec_name: str,
+        # Legacy hook argument name retained for compatibility.
         changespec_parent: str | None,
         project_basename: str,
         project_file: str,
@@ -451,22 +465,24 @@ class GitHubWorkspacePlugin:
     @hookimpl
     def ws_submit(
         self,
+        # Legacy hook argument name retained for compatibility.
         changespec_file: str,
         changespec_name: str,
         project_basename: str,
         console: object | None = None,
     ) -> tuple[bool, str | None] | None:
-        """Submit a GitHub ChangeSpec by merging its PR."""
+        """Submit a GitHub Patch by merging its PR."""
         from sase.workspace_provider import detect_workflow_type
 
-        vcs_type = detect_workflow_type(changespec_file)
+        patch_file = changespec_file  # legacy hook argument name
+        patch_name = changespec_name
+        vcs_type = detect_workflow_type(patch_file)
         if vcs_type != "gh":
             return None
 
         from rich.console import Console as RichConsole
         from rich.markup import escape as escape_markup
 
-        from sase.ace.changespec import ChangeSpec, find_all_changespecs
         from sase.ace.hooks.processes import (
             kill_and_persist_all_running_processes,
         )
@@ -483,14 +499,13 @@ class GitHubWorkspacePlugin:
             console if isinstance(console, RichConsole) else None
         )
 
-        # Find the ChangeSpec object
-        changespec: ChangeSpec | None = None
-        for cs in find_all_changespecs():
-            if cs.name == changespec_name:
-                changespec = cs
+        patch: Patch | None = None
+        for candidate in find_all_patches():
+            if candidate.name == patch_name:
+                patch = candidate
                 break
-        if changespec is None:
-            return (False, f"ChangeSpec '{changespec_name}' not found")
+        if patch is None:
+            return (False, f"Patch '{patch_name}' not found")
 
         log_fn = (
             (lambda msg: rich_console.print(f"[cyan]{escape_markup(msg)}[/cyan]"))
@@ -498,31 +513,31 @@ class GitHubWorkspacePlugin:
             else None
         )
         kill_and_persist_all_running_processes(
-            changespec,
-            changespec_file,
-            changespec_name,
+            patch,
+            patch_file,
+            patch_name,
             "Killed hook running on submitted PR.",
             log_fn=log_fn,
         )
 
-        all_changespecs = find_all_changespecs()
+        all_patches = find_all_patches()
         if has_active_children(
-            changespec,
-            all_changespecs,
+            patch,
+            all_patches,
             terminal_statuses=("Submitted", "Reverted", "Archived"),
         ):
             return (
                 False,
-                "Cannot submit: other ChangeSpecs have this one as their "
+                "Cannot submit: other Patches have this one as their "
                 "parent and are not Submitted, Reverted, or Archived",
             )
 
-        workspace_dir = parse_workspace_dir(changespec_file)
+        workspace_dir = parse_workspace_dir(patch_file)
         if not workspace_dir:
             return (False, "WORKSPACE_DIR is not set for this project")
 
-        workspace_num = get_first_available_axe_workspace(changespec_file)
-        workflow_name = f"submit-{changespec_name}"
+        workspace_num = get_first_available_axe_workspace(patch_file)
+        workflow_name = f"submit-{patch_name}"
         pid = os.getpid()
 
         try:
@@ -534,11 +549,11 @@ class GitHubWorkspacePlugin:
             rich_console.print(f"[cyan]Claiming workspace #{workspace_num}[/cyan]")
 
         if not claim_workspace(
-            changespec_file,
+            patch_file,
             workspace_num,
             workflow_name,
             pid,
-            changespec_name,
+            patch_name,
         ):
             return (
                 False,
@@ -548,12 +563,12 @@ class GitHubWorkspacePlugin:
         try:
             if rich_console:
                 rich_console.print(
-                    f"[cyan]Checking out {escape_markup(changespec_name)}...[/cyan]"
+                    f"[cyan]Checking out {escape_markup(patch_name)}...[/cyan]"
                 )
 
             provider = get_vcs_provider(ws_dir)
             branch_name = provider.resolve_revision(
-                changespec_name, project_basename, ws_dir
+                patch_name, project_basename, ws_dir
             )
             success, error = provider.checkout(branch_name, ws_dir)
             if not success:
@@ -564,47 +579,46 @@ class GitHubWorkspacePlugin:
 
             if rich_console:
                 rich_console.print(
-                    f"[cyan]Merging {escape_markup(changespec_name)} into "
+                    f"[cyan]Merging {escape_markup(patch_name)} into "
                     f"{escape_markup(default_branch)}...[/cyan]"
                 )
 
             # Prefer the recorded PR URL/number when available — this is
             # resilient to branch renames (e.g. suffix strip/append).
-            pr_number = _extract_pr_number(changespec.pr_url)
+            pr_number = _extract_pr_number(patch.pr_url)
             if pr_number:
                 pr_state = _check_pr_state(pr_number, ws_dir)
                 if pr_state == "OPEN":
                     return _submit_via_pr_merge(
-                        changespec, ws_dir, rich_console, pr_number=pr_number
+                        patch, ws_dir, rich_console, pr_number=pr_number
                     )
                 elif pr_state == "CLOSED":
                     return (
                         False,
-                        f"PR #{pr_number} (from ChangeSpec PR field) is closed "
+                        f"PR #{pr_number} (from Patch PR field) is closed "
                         "and unmerged. Reopen it or create a new PR with #pr.",
                     )
                 elif pr_state == "MERGED":
                     return (
                         False,
-                        f"PR #{pr_number} (from ChangeSpec PR field) is already "
-                        "merged.",
+                        f"PR #{pr_number} (from Patch PR field) is already merged.",
                     )
                 # pr_state is None — fall through to branch-based check
 
             # Fallback: check for a PR on the current branch
             has_pr = _check_existing_pr(ws_dir)
             if has_pr:
-                return _submit_via_pr_merge(changespec, ws_dir, rich_console)
+                return _submit_via_pr_merge(patch, ws_dir, rich_console)
             return (
                 False,
                 "GitHub project has no PR for this branch. Create a PR first with #pr.",
             )
         finally:
             release_workspace(
-                changespec_file,
+                patch_file,
                 workspace_num,
                 workflow_name,
-                changespec_name,
+                patch_name,
             )
             if rich_console:
                 rich_console.print(f"[cyan]Released workspace #{workspace_num}[/cyan]")
@@ -1650,8 +1664,6 @@ def _resolve_existing_named_ref(
     read_only: bool,
     strict: bool,
 ) -> ResolvedRef | None:
-    from sase.ace.changespec import find_all_changespecs
-
     projects_base = _projects_base()
     alias_record = _find_project_record_for_alias(
         _list_project_records(projects_base),
@@ -1675,20 +1687,20 @@ def _resolve_existing_named_ref(
                 checkout_target=checkout_target,
             )
 
-    for cs in find_all_changespecs():
-        if cs.name != gh_ref:
+    for patch in find_all_patches():
+        if patch.name != gh_ref:
             continue
-        workspace_dir = parse_workspace_dir(cs.file_path)
+        workspace_dir = parse_workspace_dir(patch.file_path)
         if not workspace_dir:
             if strict:
                 raise ValueError(
-                    f"ChangeSpec '{gh_ref}' found in {cs.file_path} "
+                    f"Patch '{gh_ref}' found in {patch.file_path} "
                     "but WORKSPACE_DIR is not set"
                 )
             return None
         return ResolvedRef(
-            project_file=cs.file_path,
-            project_name=cs.project_basename,
+            project_file=patch.file_path,
+            project_name=patch.project_basename,
             primary_workspace_dir=workspace_dir,
             checkout_target=f"origin/{gh_ref}",
         )
@@ -1717,7 +1729,7 @@ def resolve_gh_ref(gh_ref: str) -> ResolvedRef:
     2. **Project shorthand** (no ``/``, matching project dir): look up
        WORKSPACE_DIR from ``~/.sase/projects/<name>/<name>.sase``
        (with legacy ``.gp`` fallback).
-    3. **ChangeSpec name**: search all changespecs for a matching name,
+    3. **Patch name**: search all Patches for a matching name,
        read WORKSPACE_DIR from its project file.
 
     Raises:
@@ -1782,7 +1794,7 @@ def _check_existing_pr(cwd: str) -> bool:
 
 
 def _submit_via_pr_merge(
-    changespec: object,
+    patch: object,
     ws_dir: str,
     console: object | None,
     *,
@@ -1838,7 +1850,7 @@ def _submit_via_pr_merge(
 
     from sase.workspace_provider.submission_utils import finalize_submission
 
-    return finalize_submission(changespec.file_path, changespec.name, console)  # type: ignore[attr-defined, arg-type]
+    return finalize_submission(patch.file_path, patch.name, console)  # type: ignore[attr-defined, arg-type]
 
 
 def _non_interactive_gh_env(base: Mapping[str, str] | None = None) -> dict[str, str]:

{sase_github-0.2.1 → sase_github-0.2.3}/src/sase_github/xprompts/gh.yml

@@ -5,7 +5,7 @@ tags: vcs, rollover
 input:
   - name: gh_ref
     type: word
-    description: GitHub repo, PR, branch, or ChangeSpec reference to check out.
+    description: GitHub repo, PR, branch, or Patch reference to check out.
   - name: n
     type: int
     default: null
@@ -68,14 +68,14 @@ steps:
       provider = get_vcs_provider(os.getcwd())
 
       # Checkout the PR branch so that subsequent diffs are relative to the
-      # PR tip rather than the default branch.  Try checkout_target first
+      # PR tip rather than the default branch. Try checkout_target first
       # (works for default-branch refs like origin/main), then fall back to
-      # ChangeSpec name -> branch name conversion.
-      is_changespec = checkout_target == f"origin/{gh_ref}"
+      # Patch name -> branch name conversion.
+      is_patch = checkout_target == f"origin/{gh_ref}"
       ok, err = provider.checkout(checkout_target, os.getcwd())
       if not ok:
-          if is_changespec:
-              # ChangeSpec ref — resolve name to branch name
+          if is_patch:
+              # Patch ref — resolve name to branch name
               resolved = provider.resolve_revision(
                   gh_ref, project_name, os.getcwd()
               )

{sase_github-0.2.1 → sase_github-0.2.3}/src/sase_github/xprompts/new_pr_desc.yml

@@ -1,9 +1,9 @@
-description: Generate and apply a GitHub pull request title and body from a ChangeSpec.
+description: Generate and apply a GitHub pull request title and body from a Patch.
 
 input:
   - name: name
     type: word
-    description: ChangeSpec name whose branch and diff should drive the PR description.
+    description: Patch name whose branch and diff should drive the PR description.
 
 steps:
   - name: get_context
@@ -24,7 +24,7 @@ steps:
     agent: |
       Generate a PR title and body for the following changes.
 
-      ## ChangeSpec Description
+      ## Patch Description
       {{ get_context.description }}
 
       ## Commits

{sase_github-0.2.1 → sase_github-0.2.3}/tests/test_submit_with_recorded_pr.py

@@ -1,4 +1,4 @@
-"""Tests for ws_submit using the recorded PR URL from ChangeSpec.pr_url.
+"""Tests for ws_submit using the recorded PR URL from Patch.pr_url.
 
 Covers:
 - _extract_pr_number extracts from GitHub PR URLs

{sase_github-0.2.1 → sase_github-0.2.3}/tests/test_workspace_plugin.py

@@ -1914,8 +1914,8 @@ class TestResolveGhRef:
     @patch(
         "sase_github.workspace_plugin.get_default_branch", return_value="origin/main"
     )
-    @patch("sase.ace.changespec.find_all_changespecs")
-    def test_changespec_name(
+    @patch("sase_github.workspace_plugin.find_all_patches")
+    def test_patch_name(
         self,
         mock_find: MagicMock,
         mock_branch: MagicMock,
@@ -1941,8 +1941,8 @@ class TestResolveGhRef:
                 assert result.project_name == "proj"
                 assert result.canonical_ref is None
 
-    @patch("sase.ace.changespec.find_all_changespecs")
-    def test_changespec_no_workspace_dir(self, mock_find: MagicMock) -> None:
+    @patch("sase_github.workspace_plugin.find_all_patches")
+    def test_patch_no_workspace_dir(self, mock_find: MagicMock) -> None:
         with tempfile.NamedTemporaryFile(mode="w", suffix=".sase", delete=False) as f:
             f.write("NAME: my-feature\n")
             f.flush()
@@ -1961,7 +1961,7 @@ class TestResolveGhRef:
                     resolve_gh_ref("my-feature")
             os.unlink(f.name)
 
-    @patch("sase.ace.changespec.find_all_changespecs", return_value=[])
+    @patch("sase_github.workspace_plugin.find_all_patches", return_value=[])
     def test_not_found(self, mock_find: MagicMock) -> None:
         with patch(
             "sase_github.workspace_plugin.Path.home",

sase_github-0.2.1/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.2.1"
-}