ghapi 2.0.5__tar.gz → 2.0.6__tar.gz

{ghapi-2.0.5/ghapi.egg-info → ghapi-2.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.0.5
+Version: 2.0.6
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
 License: Apache-2.0
@@ -16,7 +16,8 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: fastcore>=2.1.16
-Requires-Dist: fastspec>=0.1.2
+Requires-Dist: fastspec>=0.1.5
+Requires-Dist: tomli; python_version < "3.11"
 Provides-Extra: dev
 Requires-Dist: fastgit; extra == "dev"
 Requires-Dist: matplotlib; extra == "dev"

{ghapi-2.0.5 → ghapi-2.0.6}/ghapi/__init__.py

@@ -4,4 +4,4 @@ Modules:
 
 - `ghapi.skill`: GitHub REST API access via `GhApi`, plus local git operations via `fastgit.Git`. Use this for day-to-day GitHub work: reading/creating issues and PRs, checking CI status, managing releases/branches/gists, and repo-local git operations -- all from Python, no shelling out to `gh`/`git` needed."""
 
-__version__ = "2.0.5"
+__version__ = "2.0.6"

{ghapi-2.0.5 → ghapi-2.0.6}/ghapi/_modidx.py

@@ -42,7 +42,11 @@ d = { 'settings': { 'branch': 'main',
                            'ghapi.cli.ghapi': ('cli.html#ghapi', 'ghapi/cli.py'),
                            'ghapi.cli.ghpath': ('cli.html#ghpath', 'ghapi/cli.py'),
                            'ghapi.cli.ghraw': ('cli.html#ghraw', 'ghapi/cli.py')},
-            'ghapi.core': { 'ghapi.core.GhApi': ('core.html#ghapi', 'ghapi/core.py'),
+            'ghapi.core': { 'ghapi.core.CheckRun': ('core.html#checkrun', 'ghapi/core.py'),
+                            'ghapi.core.CheckRun.__repr__': ('core.html#checkrun.__repr__', 'ghapi/core.py'),
+                            'ghapi.core.CommitStatus': ('core.html#commitstatus', 'ghapi/core.py'),
+                            'ghapi.core.CommitStatus.__repr__': ('core.html#commitstatus.__repr__', 'ghapi/core.py'),
+                            'ghapi.core.GhApi': ('core.html#ghapi', 'ghapi/core.py'),
                             'ghapi.core.GhApi.__call__': ('core.html#ghapi.__call__', 'ghapi/core.py'),
                             'ghapi.core.GhApi.__getitem__': ('core.html#ghapi.__getitem__', 'ghapi/core.py'),
                             'ghapi.core.GhApi.__init__': ('core.html#ghapi.__init__', 'ghapi/core.py'),
@@ -59,6 +63,8 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core.GhApi.recv_hdrs': ('core.html#ghapi.recv_hdrs', 'ghapi/core.py'),
                             'ghapi.core.GhApi.update_gist': ('core.html#ghapi.update_gist', 'ghapi/core.py'),
                             'ghapi.core.GhApi.upload_file': ('core.html#ghapi.upload_file', 'ghapi/core.py'),
+                            'ghapi.core.GhRows': ('core.html#ghrows', 'ghapi/core.py'),
+                            'ghapi.core.GhRows.__repr__': ('core.html#ghrows.__repr__', 'ghapi/core.py'),
                             'ghapi.core.GhSyncTransport': ('core.html#ghsynctransport', 'ghapi/core.py'),
                             'ghapi.core.GhSyncTransport.request': ('core.html#ghsynctransport.request', 'ghapi/core.py'),
                             'ghapi.core.GhTransport': ('core.html#ghtransport', 'ghapi/core.py'),
@@ -72,14 +78,19 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core._IssueInfo': ('core.html#_issueinfo', 'ghapi/core.py'),
                             'ghapi.core._IssueInfo._repr_markdown_': ('core.html#_issueinfo._repr_markdown_', 'ghapi/core.py'),
                             'ghapi.core._LiveDefaults': ('core.html#_livedefaults', 'ghapi/core.py'),
+                            'ghapi.core._LiveDefaults.__contains__': ('core.html#_livedefaults.__contains__', 'ghapi/core.py'),
+                            'ghapi.core._LiveDefaults.get': ('core.html#_livedefaults.get', 'ghapi/core.py'),
                             'ghapi.core._LiveDefaults.items': ('core.html#_livedefaults.items', 'ghapi/core.py'),
+                            'ghapi.core._dur': ('core.html#_dur', 'ghapi/core.py'),
                             'ghapi.core._filter_diff': ('core.html#_filter_diff', 'ghapi/core.py'),
                             'ghapi.core._find_matches': ('core.html#_find_matches', 'ghapi/core.py'),
                             'ghapi.core._fmt_replies': ('core.html#_fmt_replies', 'ghapi/core.py'),
                             'ghapi.core._include': ('core.html#_include', 'ghapi/core.py'),
+                            'ghapi.core._listed': ('core.html#_listed', 'ghapi/core.py'),
                             'ghapi.core._parse_tmpl': ('core.html#_parse_tmpl', 'ghapi/core.py'),
                             'ghapi.core._reduce_ctx': ('core.html#_reduce_ctx', 'ghapi/core.py'),
                             'ghapi.core._run_subp': ('core.html#_run_subp', 'ghapi/core.py'),
+                            'ghapi.core._transdeps': ('core.html#_transdeps', 'ghapi/core.py'),
                             'ghapi.core.call_gh': ('core.html#call_gh', 'ghapi/core.py'),
                             'ghapi.core.check_status': ('core.html#check_status', 'ghapi/core.py'),
                             'ghapi.core.commit_tree': ('core.html#commit_tree', 'ghapi/core.py'),
@@ -92,7 +103,13 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core.delete_file': ('core.html#delete_file', 'ghapi/core.py'),
                             'ghapi.core.delete_release': ('core.html#delete_release', 'ghapi/core.py'),
                             'ghapi.core.delete_tag': ('core.html#delete_tag', 'ghapi/core.py'),
+                            'ghapi.core.dep_closure': ('core.html#dep_closure', 'ghapi/core.py'),
+                            'ghapi.core.dep_dependents': ('core.html#dep_dependents', 'ghapi/core.py'),
+                            'ghapi.core.dep_graph': ('core.html#dep_graph', 'ghapi/core.py'),
+                            'ghapi.core.dep_key': ('core.html#dep_key', 'ghapi/core.py'),
+                            'ghapi.core.dep_order': ('core.html#dep_order', 'ghapi/core.py'),
                             'ghapi.core.enable_pages': ('core.html#enable_pages', 'ghapi/core.py'),
+                            'ghapi.core.failed_step_log': ('core.html#failed_step_log', 'ghapi/core.py'),
                             'ghapi.core.get_branch': ('core.html#get_branch', 'ghapi/core.py'),
                             'ghapi.core.get_content': ('core.html#get_content', 'ghapi/core.py'),
                             'ghapi.core.gh2date': ('core.html#gh2date', 'ghapi/core.py'),
@@ -102,6 +119,7 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core.list_branches': ('core.html#list_branches', 'ghapi/core.py'),
                             'ghapi.core.list_files': ('core.html#list_files', 'ghapi/core.py'),
                             'ghapi.core.list_tags': ('core.html#list_tags', 'ghapi/core.py'),
+                            'ghapi.core.local_dep_graph': ('core.html#local_dep_graph', 'ghapi/core.py'),
                             'ghapi.core.pr_file_diff': ('core.html#pr_file_diff', 'ghapi/core.py'),
                             'ghapi.core.pr_status': ('core.html#pr_status', 'ghapi/core.py'),
                             'ghapi.core.print_summary': ('core.html#print_summary', 'ghapi/core.py'),

{ghapi-2.0.5 → ghapi-2.0.6}/ghapi/core.py

@@ -9,8 +9,9 @@ __all__ = ['GH_HOST', 'pspec', 'img_md_pat', 'EMPTY_TREE_SHA', 'GhTransport', 'G
            'GhApi', 'call_gh', 'date2gh', 'gh2date', 'delete_release', 'create_release', 'list_tags', 'list_branches',
            'create_branch_empty', 'delete_tag', 'delete_branch', 'get_branch', 'commit_tree', 'list_files',
            'get_content', 'create_or_update_file', 'create_file', 'delete_file', 'update_contents', 'enable_pages',
-           'read_issue', 'read_pr', 'pr_file_diff', 'issue_template', 'issue_body', 'check_status', 'pr_status',
-           'APIError']
+           'read_issue', 'read_pr', 'pr_file_diff', 'issue_template', 'issue_body', 'CheckRun', 'CommitStatus',
+           'GhRows', 'check_status', 'pr_status', 'failed_step_log', 'dep_key', 'local_dep_graph', 'dep_closure',
+           'dep_order', 'dep_dependents', 'dep_graph', 'APIError']
 
 # %% ../nbs/00_core.ipynb #5b5cba7b
 from contextvars import ContextVar
@@ -27,6 +28,10 @@ from collections import Counter
 from urllib.parse import quote
 from datetime import datetime
 import os, shutil, tempfile, subprocess, fnmatch, html
+import asyncio
+
+try: import tomllib
+except ModuleNotFoundError: import tomli as tomllib
 
 # %% ../nbs/00_core.ipynb #ed04302a
 _all_ = ['APIError']
@@ -97,6 +102,8 @@ _gh_override = ContextVar('_gh_override', default={})
 class _LiveDefaults(dict):
     "Endpoint defaults, superseded at call time by any active `gh_patch` override"
     def items(self): return {**self, **_gh_override.get()}.items()
+    def __contains__(self, k): return dict.__contains__(self, k) or k in _gh_override.get()
+    def get(self, k, default=None): return _gh_override.get().get(k, dict.get(self, k, default))
 
 def gh_patch(fn):
     "`patch` `fn` into `GhApi`, adding `owner`/`repo` params that override the client defaults for this call and its internal calls"
@@ -532,6 +539,22 @@ def issue_body(tmpl, sections):
     return '\n\n'.join(res)
 
 # %% ../nbs/00_core.ipynb #97730eae
+def _dur(r):
+    if not (r.get('started_at') and r.get('completed_at')): return ''
+    t = lambda s: datetime.fromisoformat(s.replace('Z', '+00:00'))
+    secs = int((t(r.completed_at) - t(r.started_at)).total_seconds())
+    return f' ({secs//60}m{secs%60:02d}s)' if secs >= 60 else f' ({secs}s)'
+
+class CheckRun(AttrDict):
+    def __repr__(self): return f'{self.id}  {self.name}: {self.conclusion or self.status}{_dur(self)}'
+
+class CommitStatus(AttrDict):
+    def __repr__(self): return f'{self.context}: {self.state}'
+
+class GhRows(L):
+    "Result rows whose bare display is one actionable line each"
+    def __repr__(self): return '\n'.join(map(repr, self))
+
 class _CheckStatus(AttrDict):
     def _repr_markdown_(self):
         runs = self.check_runs
@@ -539,7 +562,7 @@ class _CheckStatus(AttrDict):
         if any(r.status!='completed' for r in runs): verdict = 'pending'
         elif all(r.conclusion in ('success','neutral','skipped') for r in runs): verdict = 'success'
         else: verdict = 'failure'
-        return '\n'.join([f'**{verdict}**', ''] + [f"- {r.name}: {r.conclusion or r.status}" for r in runs])
+        return '\n'.join([f'**{verdict}**', ''] + [f'- {r!r}' for r in runs+self.statuses])
     __repr__ = _repr_markdown_
 
 @gh_patch
@@ -547,9 +570,115 @@ async def check_status(self:GhApi, ref:str):
     "Combined commit status and check-run results for `ref` (a SHA, branch, or tag)"
     combined = await self.repos.get_combined_status_for_ref(ref)
     checks = await self.checks.list_for_ref(ref)
-    return _CheckStatus(dict2obj(dict(state=combined.state, statuses=combined.statuses, check_runs=checks.check_runs)))
+    return _CheckStatus(dict(state=combined.state, statuses=GhRows(CommitStatus(o) for o in combined.statuses),
+        check_runs=GhRows(CheckRun(o) for o in checks.check_runs)))
 
 @gh_patch
 async def pr_status(self:GhApi, pull_number:int):
     "Combined status and check-run results for a PR's head commit"
     return await self.check_status((await self.pulls.get(pull_number)).head.sha)
+
+# %% ../nbs/00_core.ipynb #569864f5
+@gh_patch
+async def failed_step_log(self:GhApi, job_id:int):
+    "Log sections of `job_id`'s failed steps, each headed by its step name"
+    job = await self.actions.get_job_for_workflow_run(job_id=job_id)
+    log = await self.actions.download_job_logs_for_workflow_run(job_id=job_id)
+    res = []
+    for s in job.steps:
+        if s.conclusion!='failure': continue
+        seg = [l[29:] for l in log.splitlines() if s.started_at[:-1] <= l[:19] <= s.completed_at[:-1]]
+        errs = [i for i,l in enumerate(seg) if l.startswith(r'##[error]')]
+        if errs: seg = seg[:errs[-1]+1]
+        res.append(f'# {s.name}\n' + '\n'.join(seg))
+    return '\n\n'.join(res)
+
+# %% ../nbs/00_core.ipynb #751c4e54
+def dep_key(dep):
+    "Package key for PEP 508 dependency spec `dep`"
+    dep = dep.split(";", 1)[0].strip()
+    dep = re.split(r"[\s<>=!~]", dep, maxsplit=1)[0]
+    return dep.split("[", 1)[0].casefold()
+
+# %% ../nbs/00_core.ipynb #16db589f
+def local_dep_graph(root):
+    "Dependency graph `{package: (repo dir, [dep packages])}` for checkouts under `root`"
+    res = {}
+    for p in sorted(Path(root).expanduser().glob("*/pyproject.toml")):
+        proj = tomllib.loads(p.read_text(encoding="utf-8")).get("project", {})
+        if not (name := proj.get("name")): continue
+        res[name.casefold()] = (p.parent.name, [dep_key(d) for d in proj.get("dependencies", [])])
+    return res
+
+# %% ../nbs/00_core.ipynb #a7c0113f
+def dep_closure(name, graph):
+    "Repo names for `name` and its transitive dependencies within `graph`"
+    seen, todo = set(), [name.casefold()]
+    while todo:
+        if (n := todo.pop()) in seen or n not in graph: continue
+        seen.add(n)
+        todo += graph[n][1]
+    return {graph[n][0] for n in seen}
+
+# %% ../nbs/00_core.ipynb #03e6a85e
+def _transdeps(pkg, graph):
+    seen, todo = set(), list(graph.get(pkg, ('', []))[1])
+    while todo:
+        if (n := todo.pop()) in seen or n not in graph: continue
+        seen.add(n)
+        todo += graph[n][1]
+    return seen
+
+def _listed(graph, names):
+    r2p = {r.casefold(): p for p, (r, _) in graph.items()}
+    if names is None: names = sorted(graph[p][0] for p in graph)
+    pkgs = {n: r2p.get(k := n.rpartition("/")[2].casefold(), k) for n in names}
+    td = {n: _transdeps(p, graph) & set(pkgs.values()) for n, p in pkgs.items()}
+    return names, pkgs, td
+
+def dep_order(graph, names=None):
+    "Order `names` (repo, package, or `owner/name` specs; default all of `graph`) dependency-first, ties most-depended-on first"
+    names, pkgs, td = _listed(graph, names)
+    ndeps = {n: sum(pkgs[n] in d for d in td.values()) for n in names}
+    order, done = [], set()
+    while len(order) < len(names):
+        ready = sorted((n for n in names if n not in order and td[n] <= done), key=lambda n: -ndeps[n])
+        if not ready: raise ValueError(f"dependency cycle among {sorted(set(names) - set(order))}")
+        order += ready
+        done |= {pkgs[n] for n in ready}
+    return order
+
+# %% ../nbs/00_core.ipynb #cf2ccf6d
+def dep_dependents(graph, names=None):
+    "For each of `names` (default all of `graph`), the listed names that transitively depend on it, most-depended-on first"
+    names, pkgs, td = _listed(graph, names)
+    res = {n: [m for m in names if pkgs[n] in td[m]] for n in names}
+    return dict(sorted(res.items(), key=lambda kv: -len(kv[1])))
+
+# %% ../nbs/00_core.ipynb #64709ee0
+@gh_patch
+async def dep_graph(self:GhApi, *repos, graph=None):
+    "Dependency graph for `repos` and their transitive same-owner deps, fetched from GitHub pyprojects; seed with `graph` to skip fetching known members"
+    graph = dict(graph or {})
+    seen = {r.casefold() for r, _ in graph.values()}
+    async def _fetch(spec):
+        owner, _, name = spec.rpartition("/")
+        try: res = await self.repos.get_content(repo=name, path="pyproject.toml", **(dict(owner=owner) if owner else {}))
+        except APIError: return spec, None
+        return spec, tomllib.loads(base64.b64decode(res.content).decode()).get("project", {})
+    todo, listed = [r for r in repos if r.rpartition("/")[2].casefold() not in seen], True
+    while todo:
+        todo = list(dict.fromkeys(todo))
+        seen |= {t.rpartition("/")[2].casefold() for t in todo}
+        results = await asyncio.gather(*map(_fetch, todo))
+        todo = []
+        for spec, proj in results:
+            owner, _, name = spec.rpartition("/")
+            if proj is None:
+                if listed: graph[name.casefold()] = (name, [])
+                continue
+            deps = [dep_key(d) for d in proj.get("dependencies", [])]
+            graph[(proj.get("name") or name).casefold()] = (name, deps)
+            todo += [f"{owner}/{d}" if owner else d for d in deps if d not in graph and d not in seen]
+        listed = False
+    return graph

{ghapi-2.0.5 → ghapi-2.0.6}/ghapi/gh_spec.py

@@ -67,15 +67,16 @@ spec = {'base_url': 'https://api.github.com',
           'verb': 'POST',
           'summary': 'Start a task',
           'route_params': ['owner', 'repo'],
-          'body_params': ['prompt', 'model', 'create_pull_request', 'base_ref', 'head_ref'],
+          'body_params': ['prompt', 'model', 'custom_agent', 'create_pull_request', 'base_ref', 'head_ref'],
           'request_content_type': 'application/json',
           'required_params': ['owner', 'prompt', 'repo'],
-          'param_types': {'owner': 'str', 'repo': 'str', 'prompt': 'str', 'model': 'str', 'create_pull_request': 'bool', 'base_ref': 'str', 'head_ref': 'str'},
+          'param_types': {'owner': 'str', 'repo': 'str', 'prompt': 'str', 'model': 'str', 'custom_agent': 'str', 'create_pull_request': 'bool', 'base_ref': 'str', 'head_ref': 'str'},
           'param_defaults': {'create_pull_request': False},
           'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
                          'repo': 'The name of the repository. The name is not case sensitive.',
                          'prompt': "The user's prompt for the agent",
                          'model': "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`",
+                         'custom_agent': "Optional identifier for a custom agent to use for this task. Use the custom agent's filename without the extension - for example, for a `.github/agents/performance-optimizer.agent.md` custom agent, use `performance-optimizer`.",
                          'create_pull_request': 'Whether to create a PR.',
                          'base_ref': 'Base ref for new branch/PR',
                          'head_ref': 'Head ref for existing branch/PR. If provided with `base_ref`, the agent looks up open PR context for `head_ref` targeting `base_ref` and commits to `head_ref` instead of creating a new branch.'},
@@ -216,7 +217,7 @@ spec = {'base_url': 'https://api.github.com',
           'request_content_type': 'application/json',
           'required_params': ['installation_id'],
           'param_types': {'installation_id': 'int', 'repositories': 'list', 'repository_ids': 'list', 'permissions': 'dict'},
-          'param_docs': {'installation_id': 'The unique identifier of the installation.', 'repositories': 'List of repository names that the token should have access to', 'repository_ids': 'List of repository IDs that the token should have access to', 'permissions': 'The permissions granted to the user access token.'},
+          'param_docs': {'installation_id': 'The unique identifier of the installation.', 'repositories': 'List of repository names that the token should have access to', 'repository_ids': 'List of repository IDs that the token should have access to', 'permissions': 'The permissions granted to the fine-grained access token.'},
           'docs_url': 'https://docs.github.com/rest/apps/apps#create-an-installation-access-token-for-an-app'},
          {'group': 'apps',
           'name': 'suspend_installation',
@@ -302,24 +303,24 @@ spec = {'base_url': 'https://api.github.com',
                          'target_id': 'The ID of the user or organization to scope the user access token to. **Required** unless `target` is specified.',
                          'repositories': 'The list of repository names to scope the user access token to. `repositories` may not be specified if `repository_ids` is specified.',
                          'repository_ids': 'The list of repository IDs to scope the user access token to. `repository_ids` may not be specified if `repositories` is specified.',
-                         'permissions': 'The permissions granted to the user access token.'},
+                         'permissions': 'The permissions granted to the fine-grained access token.'},
           'docs_url': 'https://docs.github.com/rest/apps/apps#create-a-scoped-access-token'},
          {'group': 'apps', 'name': 'get_by_slug', 'path': '/apps/{app_slug}', 'verb': 'GET', 'summary': 'Get an app', 'route_params': ['app_slug'], 'required_params': ['app_slug'], 'param_types': {'app_slug': 'str'}, 'docs_url': 'https://docs.github.com/rest/apps/apps#get-an-app'},
          {'group': 'classroom',
           'name': 'get_an_assignment',
           'path': '/assignments/{assignment_id}',
           'verb': 'GET',
-          'summary': 'Get an assignment',
+          'summary': 'Closing down - Get an assignment',
           'route_params': ['assignment_id'],
           'required_params': ['assignment_id'],
           'param_types': {'assignment_id': 'int'},
           'param_docs': {'assignment_id': 'The unique identifier of the classroom assignment.'},
-          'docs_url': 'https://docs.github.com/rest/classroom/classroom#get-an-assignment'},
+          'docs_url': 'https://docs.github.com/rest/classroom/classroom#closing-down---get-an-assignment'},
          {'group': 'classroom',
           'name': 'list_accepted_assignments_for_an_assignment',
           'path': '/assignments/{assignment_id}/accepted_assignments',
           'verb': 'GET',
-          'summary': 'List accepted assignments for an assignment',
+          'summary': 'Closing down - List accepted assignments for an assignment',
           'route_params': ['assignment_id'],
           'query_params': ['page', 'per_page'],
           'required_params': ['assignment_id'],
@@ -328,43 +329,43 @@ spec = {'base_url': 'https://api.github.com',
           'param_docs': {'assignment_id': 'The unique identifier of the classroom assignment.',
                          'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
                          'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
-          'docs_url': 'https://docs.github.com/rest/classroom/classroom#list-accepted-assignments-for-an-assignment'},
+          'docs_url': 'https://docs.github.com/rest/classroom/classroom#closing-down---list-accepted-assignments-for-an-assignment'},
          {'group': 'classroom',
           'name': 'get_assignment_grades',
           'path': '/assignments/{assignment_id}/grades',
           'verb': 'GET',
-          'summary': 'Get assignment grades',
+          'summary': 'Closing down - Get assignment grades',
           'route_params': ['assignment_id'],
           'required_params': ['assignment_id'],
           'param_types': {'assignment_id': 'int'},
           'param_docs': {'assignment_id': 'The unique identifier of the classroom assignment.'},
-          'docs_url': 'https://docs.github.com/rest/classroom/classroom#get-assignment-grades'},
+          'docs_url': 'https://docs.github.com/rest/classroom/classroom#closing-down---get-assignment-grades'},
          {'group': 'classroom',
           'name': 'list_classrooms',
           'path': '/classrooms',
           'verb': 'GET',
-          'summary': 'List classrooms',
+          'summary': 'Closing down - List classrooms',
           'query_params': ['page', 'per_page'],
           'param_types': {'page': 'int', 'per_page': 'int'},
           'param_defaults': {'page': 1, 'per_page': 30},
           'param_docs': {'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
                          'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
-          'docs_url': 'https://docs.github.com/rest/classroom/classroom#list-classrooms'},
+          'docs_url': 'https://docs.github.com/rest/classroom/classroom#closing-down---list-classrooms'},
          {'group': 'classroom',
           'name': 'get_a_classroom',
           'path': '/classrooms/{classroom_id}',
           'verb': 'GET',
-          'summary': 'Get a classroom',
+          'summary': 'Closing down - Get a classroom',
           'route_params': ['classroom_id'],
           'required_params': ['classroom_id'],
           'param_types': {'classroom_id': 'int'},
           'param_docs': {'classroom_id': 'The unique identifier of the classroom.'},
-          'docs_url': 'https://docs.github.com/rest/classroom/classroom#get-a-classroom'},
+          'docs_url': 'https://docs.github.com/rest/classroom/classroom#closing-down---get-a-classroom'},
          {'group': 'classroom',
           'name': 'list_assignments_for_a_classroom',
           'path': '/classrooms/{classroom_id}/assignments',
           'verb': 'GET',
-          'summary': 'List assignments for a classroom',
+          'summary': 'Closing down - List assignments for a classroom',
           'route_params': ['classroom_id'],
           'query_params': ['page', 'per_page'],
           'required_params': ['classroom_id'],
@@ -373,7 +374,7 @@ spec = {'base_url': 'https://api.github.com',
           'param_docs': {'classroom_id': 'The unique identifier of the classroom.',
                          'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
                          'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
-          'docs_url': 'https://docs.github.com/rest/classroom/classroom#list-assignments-for-a-classroom'},
+          'docs_url': 'https://docs.github.com/rest/classroom/classroom#closing-down---list-assignments-for-a-classroom'},
          {'group': 'codes_of_conduct', 'name': 'get_all_codes_of_conduct', 'path': '/codes_of_conduct', 'verb': 'GET', 'summary': 'Get all codes of conduct', 'docs_url': 'https://docs.github.com/rest/codes-of-conduct/codes-of-conduct#get-all-codes-of-conduct'},
          {'group': 'codes_of_conduct', 'name': 'get_conduct_code', 'path': '/codes_of_conduct/{key}', 'verb': 'GET', 'summary': 'Get a code of conduct', 'route_params': ['key'], 'required_params': ['key'], 'param_types': {'key': 'str'}, 'docs_url': 'https://docs.github.com/rest/codes-of-conduct/codes-of-conduct#get-a-code-of-conduct'},
          {'group': 'credentials',
@@ -756,6 +757,17 @@ spec = {'base_url': 'https://api.github.com',
           'param_types': {'enterprise': 'str'},
           'param_docs': {'enterprise': 'The slug version of the enterprise name.'},
           'docs_url': 'https://docs.github.com/rest/copilot/copilot-usage-metrics#get-copilot-enterprise-usage-metrics'},
+         {'group': 'copilot',
+          'name': 'copilot_enterprise_repos_one_day_report',
+          'path': '/enterprises/{enterprise}/copilot/metrics/reports/repos-1-day',
+          'verb': 'GET',
+          'summary': 'Get Copilot enterprise repository report for a specific day',
+          'route_params': ['enterprise'],
+          'query_params': ['day'],
+          'required_params': ['day', 'enterprise'],
+          'param_types': {'enterprise': 'str', 'day': 'str'},
+          'param_docs': {'enterprise': 'The slug version of the enterprise name.', 'day': 'The day to request data for, in `YYYY-MM-DD` format.'},
+          'docs_url': 'https://docs.github.com/rest/copilot/copilot-usage-metrics#get-copilot-enterprise-repository-report-for-a-specific-day'},
          {'group': 'copilot',
           'name': 'copilot_enterprise_user_teams_one_day_report',
           'path': '/enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day',
@@ -3185,18 +3197,42 @@ spec = {'base_url': 'https://api.github.com',
           'verb': 'POST',
           'summary': 'Set cluster deployment records',
           'route_params': ['org', 'cluster'],
-          'body_params': ['logical_environment', 'physical_environment', 'deployments', 'return_records'],
+          'body_params': ['logical_environment', 'physical_environment', 'deployments', 'partial_success', 'return_records'],
           'request_content_type': 'application/json',
           'required_params': ['cluster', 'deployments', 'logical_environment', 'org'],
-          'param_types': {'org': 'str', 'cluster': 'str', 'logical_environment': 'str', 'physical_environment': 'str', 'deployments': 'list', 'return_records': 'bool'},
-          'param_defaults': {'return_records': True},
+          'param_types': {'org': 'str', 'cluster': 'str', 'logical_environment': 'str', 'physical_environment': 'str', 'deployments': 'list', 'partial_success': 'bool', 'return_records': 'bool'},
+          'param_defaults': {'partial_success': False, 'return_records': True},
           'param_docs': {'org': 'The organization name. The name is not case sensitive.',
                          'cluster': 'The cluster name.',
                          'logical_environment': 'The stage of the deployment.',
                          'physical_environment': 'The physical region of the deployment.',
                          'deployments': 'The list of deployments to record.',
+                         'partial_success': 'When enabled, deployments associated with repositories the actor can write to are processed while deployments associated with repositories that cannot be resolved or written to by the actor are skipped and reported in the `errors` array. When false (the default), the endpoint returns an error if any targeted '
+                                            'repository cannot be resolved, the actor lacks write access, or no matching attestation can be found.',
                          'return_records': 'If true, the endpoint will return the set records in the response body'},
           'docs_url': 'https://docs.github.com/rest/orgs/artifact-metadata#set-cluster-deployment-records'},
+         {'group': 'orgs',
+          'name': 'create_cluster_deployment_records_job',
+          'path': '/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}/jobs',
+          'verb': 'POST',
+          'summary': 'Create a cluster deployment records job',
+          'route_params': ['org', 'cluster'],
+          'body_params': ['logical_environment', 'physical_environment', 'deployments'],
+          'request_content_type': 'application/json',
+          'required_params': ['cluster', 'deployments', 'logical_environment', 'org'],
+          'param_types': {'org': 'str', 'cluster': 'str', 'logical_environment': 'str', 'physical_environment': 'str', 'deployments': 'list'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'cluster': 'The cluster name.', 'logical_environment': 'The stage of the deployment.', 'physical_environment': 'The physical region of the deployment.', 'deployments': 'The list of deployments to record.'},
+          'docs_url': 'https://docs.github.com/rest/orgs/artifact-metadata#create-a-cluster-deployment-records-job'},
+         {'group': 'orgs',
+          'name': 'get_cluster_deployment_records_job',
+          'path': '/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}/jobs/{job_id}',
+          'verb': 'GET',
+          'summary': 'Get cluster deployment records job status',
+          'route_params': ['org', 'cluster', 'job_id'],
+          'required_params': ['cluster', 'job_id', 'org'],
+          'param_types': {'org': 'str', 'cluster': 'str', 'job_id': 'int'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'cluster': 'The cluster name.', 'job_id': 'The ID of the job.'},
+          'docs_url': 'https://docs.github.com/rest/orgs/artifact-metadata#get-cluster-deployment-records-job-status'},
          {'group': 'orgs',
           'name': 'create_artifact_storage_record',
           'path': '/orgs/{org}/artifacts/metadata/storage-record',
@@ -4309,6 +4345,17 @@ spec = {'base_url': 'https://api.github.com',
           'param_types': {'org': 'str'},
           'param_docs': {'org': 'The organization name. The name is not case sensitive.'},
           'docs_url': 'https://docs.github.com/rest/copilot/copilot-usage-metrics#get-copilot-organization-usage-metrics'},
+         {'group': 'copilot',
+          'name': 'copilot_organization_repos_one_day_report',
+          'path': '/orgs/{org}/copilot/metrics/reports/repos-1-day',
+          'verb': 'GET',
+          'summary': 'Get Copilot organization repository report for a specific day',
+          'route_params': ['org'],
+          'query_params': ['day'],
+          'required_params': ['day', 'org'],
+          'param_types': {'org': 'str', 'day': 'str'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'day': 'The day to request data for, in `YYYY-MM-DD` format.'},
+          'docs_url': 'https://docs.github.com/rest/copilot/copilot-usage-metrics#get-copilot-organization-repository-report-for-a-specific-day'},
          {'group': 'copilot',
           'name': 'copilot_organization_user_teams_one_day_report',
           'path': '/orgs/{org}/copilot/metrics/reports/user-teams-1-day',
@@ -4921,6 +4968,28 @@ spec = {'base_url': 'https://api.github.com',
           'param_types': {'org': 'str'},
           'param_docs': {'org': 'The organization name. The name is not case sensitive.'},
           'docs_url': 'https://docs.github.com/rest/interactions/orgs#remove-interaction-restrictions-for-an-organization'},
+         {'group': 'interactions',
+          'name': 'get_pull_request_creation_cap_for_org',
+          'path': '/orgs/{org}/interaction-limits/pulls/creation-cap',
+          'verb': 'GET',
+          'summary': 'Get pull request creation cap for an org',
+          'route_params': ['org'],
+          'required_params': ['org'],
+          'param_types': {'org': 'str'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.'},
+          'docs_url': 'https://docs.github.com/rest/interactions/orgs#get-pull-request-creation-cap-for-an-org'},
+         {'group': 'interactions',
+          'name': 'update_pull_request_creation_cap_for_org',
+          'path': '/orgs/{org}/interaction-limits/pulls/creation-cap',
+          'verb': 'PATCH',
+          'summary': 'Update pull request creation cap for an org',
+          'route_params': ['org'],
+          'body_params': ['enabled', 'max_open_pull_requests'],
+          'request_content_type': 'application/json',
+          'required_params': ['enabled', 'org'],
+          'param_types': {'org': 'str', 'enabled': 'bool', 'max_open_pull_requests': 'int'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'enabled': 'Whether the pull request creation cap is enabled', 'max_open_pull_requests': 'The maximum number of open pull requests a user can have at one time'},
+          'docs_url': 'https://docs.github.com/rest/interactions/orgs#update-pull-request-creation-cap-for-an-org'},
          {'group': 'orgs',
           'name': 'list_pending_invitations',
           'path': '/orgs/{org}/invitations',
@@ -6546,6 +6615,70 @@ spec = {'base_url': 'https://api.github.com',
                          'owner_email_hash': 'Filters alerts to only those whose attached `owner_email` metadata field matches the provided value. The value must be the lowercase hex-encoded SHA-256 hash of the email address to match (for example, the SHA-256 of `user@example.com`). Only alerts that have an `owner_email` metadata value whose SHA-256 hash '
                                              'equals this parameter are returned.'},
           'docs_url': 'https://docs.github.com/rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-organization'},
+         {'group': 'secret_scanning',
+          'name': 'list_org_custom_patterns',
+          'path': '/orgs/{org}/secret-scanning/custom-patterns',
+          'verb': 'GET',
+          'summary': 'List organization custom patterns',
+          'route_params': ['org'],
+          'query_params': ['state', 'push_protection', 'sort', 'direction', 'page', 'per_page'],
+          'required_params': ['org'],
+          'param_types': {'org': 'str', 'state': 'str', 'push_protection': 'str', 'sort': 'str', 'direction': 'str', 'page': 'int', 'per_page': 'int'},
+          'param_defaults': {'sort': 'created', 'direction': 'desc', 'page': 1, 'per_page': 30},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.',
+                         'state': 'Filter custom patterns by state. When absent, returns patterns in all states.',
+                         'push_protection': 'Filter custom patterns by whether push protection is enabled. When absent, returns patterns regardless of push protection status.',
+                         'sort': 'The property to sort the results by.',
+                         'direction': 'The direction to sort the results by.',
+                         'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
+          'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#list-organization-custom-patterns'},
+         {'group': 'secret_scanning',
+          'name': 'bulk_create_org_custom_patterns',
+          'path': '/orgs/{org}/secret-scanning/custom-patterns',
+          'verb': 'POST',
+          'summary': 'Bulk create organization custom patterns',
+          'route_params': ['org'],
+          'body_params': ['patterns'],
+          'request_content_type': 'application/json',
+          'required_params': ['org', 'patterns'],
+          'param_types': {'org': 'str', 'patterns': 'list'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'patterns': 'The list of custom patterns to create.'},
+          'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#bulk-create-organization-custom-patterns'},
+         {'group': 'secret_scanning',
+          'name': 'bulk_delete_org_custom_patterns',
+          'path': '/orgs/{org}/secret-scanning/custom-patterns',
+          'verb': 'DELETE',
+          'summary': 'Bulk delete organization custom patterns',
+          'route_params': ['org'],
+          'body_params': ['patterns', 'post_delete_action'],
+          'request_content_type': 'application/json',
+          'required_params': ['org', 'patterns'],
+          'param_types': {'org': 'str', 'patterns': 'list', 'post_delete_action': 'str'},
+          'param_defaults': {'post_delete_action': 'delete_alerts'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.',
+                         'patterns': 'The list of custom patterns to delete.',
+                         'post_delete_action': 'What to do with alerts associated with the deleted patterns. `delete_alerts` permanently removes the alerts. `resolve_alerts` resolves the alerts as "pattern deleted". Defaults to `delete_alerts` when not specified.'},
+          'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#bulk-delete-organization-custom-patterns'},
+         {'group': 'secret_scanning',
+          'name': 'update_org_custom_pattern',
+          'path': '/orgs/{org}/secret-scanning/custom-patterns/{pattern_id}',
+          'verb': 'PATCH',
+          'summary': 'Update an organization custom pattern',
+          'route_params': ['org', 'pattern_id'],
+          'body_params': ['pattern', 'start_delimiter', 'end_delimiter', 'must_match', 'must_not_match', 'custom_pattern_version'],
+          'request_content_type': 'application/json',
+          'required_params': ['custom_pattern_version', 'org', 'pattern_id'],
+          'param_types': {'org': 'str', 'pattern_id': 'int', 'pattern': 'str', 'start_delimiter': 'str', 'end_delimiter': 'str', 'must_match': 'list', 'must_not_match': 'list', 'custom_pattern_version': 'str'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.',
+                         'pattern_id': 'The ID of the custom pattern.',
+                         'pattern': 'The updated regular expression of the custom pattern.',
+                         'start_delimiter': 'The updated start delimiter regex for the custom pattern.',
+                         'end_delimiter': 'The updated end delimiter regex for the custom pattern.',
+                         'must_match': 'Updated list of regexes that the secret must match.',
+                         'must_not_match': 'Updated list of regexes that the secret must not match.',
+                         'custom_pattern_version': "The version of the entity. This is used to confirm you're updating the current version of the entity and mitigate unintentionally overriding someone else's update."},
+          'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#update-an-organization-custom-pattern'},
          {'group': 'secret_scanning',
           'name': 'list_org_pattern_configs',
           'path': '/orgs/{org}/secret-scanning/pattern-configurations',
@@ -6796,10 +6929,10 @@ spec = {'base_url': 'https://api.github.com',
           'verb': 'POST',
           'summary': 'Create a team',
           'route_params': ['org'],
-          'body_params': ['name', 'description', 'maintainers', 'repo_names', 'privacy', 'notification_setting', 'permission', 'parent_team_id'],
+          'body_params': ['name', 'description', 'maintainers', 'repo_names', 'privacy', 'notification_setting', 'permission', 'parent_team_id', 'parent_team_slug'],
           'request_content_type': 'application/json',
           'required_params': ['name', 'org'],
-          'param_types': {'org': 'str', 'name': 'str', 'description': 'str', 'maintainers': 'list', 'repo_names': 'list', 'privacy': 'str', 'notification_setting': 'str', 'permission': 'str', 'parent_team_id': 'int'},
+          'param_types': {'org': 'str', 'name': 'str', 'description': 'str', 'maintainers': 'list', 'repo_names': 'list', 'privacy': 'str', 'notification_setting': 'str', 'permission': 'str', 'parent_team_id': 'int', 'parent_team_slug': 'str'},
           'param_defaults': {'permission': 'pull'},
           'param_docs': {'org': 'The organization name. The name is not case sensitive.',
                          'name': 'The name of the team.',
@@ -6810,7 +6943,8 @@ spec = {'base_url': 'https://api.github.com',
                                     'organization. Default for child team: `closed`',
                          'notification_setting': 'The notification setting the team has chosen. The options are: * `notifications_enabled` - team members receive notifications when the team is @mentioned. * `notifications_disabled` - no one receives notifications. Default: `notifications_enabled`',
                          'permission': '**Closing down notice**. The permission that new repositories will be added to the team with when none is specified.',
-                         'parent_team_id': 'The ID of a team to set as the parent team.'},
+                         'parent_team_id': 'The ID of a team to set as the parent team.',
+                         'parent_team_slug': 'The slug of a team to set as the parent team. Ignored when `parent_team_id` is also provided.'},
           'docs_url': 'https://docs.github.com/rest/teams/teams#create-a-team'},
          {'group': 'teams',
           'name': 'get_by_name',
@@ -6828,10 +6962,10 @@ spec = {'base_url': 'https://api.github.com',
           'verb': 'PATCH',
           'summary': 'Update a team',
           'route_params': ['org', 'team_slug'],
-          'body_params': ['name', 'description', 'privacy', 'notification_setting', 'permission', 'parent_team_id'],
+          'body_params': ['name', 'description', 'privacy', 'notification_setting', 'permission', 'parent_team_id', 'parent_team_slug'],
           'request_content_type': 'application/json',
           'required_params': ['org', 'team_slug'],
-          'param_types': {'org': 'str', 'team_slug': 'str', 'name': 'str', 'description': 'str', 'privacy': 'str', 'notification_setting': 'str', 'permission': 'str', 'parent_team_id': 'int'},
+          'param_types': {'org': 'str', 'team_slug': 'str', 'name': 'str', 'description': 'str', 'privacy': 'str', 'notification_setting': 'str', 'permission': 'str', 'parent_team_id': 'int', 'parent_team_slug': 'str'},
           'param_defaults': {'permission': 'pull'},
           'param_docs': {'org': 'The organization name. The name is not case sensitive.',
                          'team_slug': 'The slug of the team name.',
@@ -6841,7 +6975,8 @@ spec = {'base_url': 'https://api.github.com',
                                     '- visible to all members of this organization. **For a parent or child team:** * `closed` - visible to all members of this organization.',
                          'notification_setting': 'The notification setting the team has chosen. Editing teams without specifying this parameter leaves `notification_setting` intact. The options are: * `notifications_enabled` - team members receive notifications when the team is @mentioned. * `notifications_disabled` - no one receives notifications.',
                          'permission': '**Closing down notice**. The permission that new repositories will be added to the team with when none is specified.',
-                         'parent_team_id': 'The ID of a team to set as the parent team.'},
+                         'parent_team_id': 'The ID of a team to set as the parent team.',
+                         'parent_team_slug': 'The slug of a team to set as the parent team. Ignored when `parent_team_id` is also provided.'},
           'docs_url': 'https://docs.github.com/rest/teams/teams#update-a-team'},
          {'group': 'teams',
           'name': 'delete_in_org',
@@ -9233,16 +9368,17 @@ spec = {'base_url': 'https://api.github.com',
           'verb': 'PATCH',
           'summary': 'Update a code quality setup configuration',
           'route_params': ['owner', 'repo'],
-          'body_params': ['state', 'runner_type', 'runner_label', 'languages'],
+          'body_params': ['state', 'runner_type', 'runner_label', 'languages', 'ai_findings_option'],
           'request_content_type': 'application/json',
           'required_params': ['owner', 'repo'],
-          'param_types': {'owner': 'str', 'repo': 'str', 'state': 'str', 'runner_type': 'str', 'runner_label': 'str', 'languages': 'list'},
+          'param_types': {'owner': 'str', 'repo': 'str', 'state': 'str', 'runner_type': 'str', 'runner_label': 'str', 'languages': 'list', 'ai_findings_option': 'str'},
           'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
                          'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
                          'state': 'The desired state of code quality setup.',
                          'runner_type': 'Runner type to be used.',
                          'runner_label': 'Runner label to be used if the runner type is labeled.',
-                         'languages': 'Languages to be analyzed.'},
+                         'languages': 'Languages to be analyzed.',
+                         'ai_findings_option': 'Whether AI findings run for Code Quality on this repository.'},
           'docs_url': 'https://docs.github.com/rest/code-quality/code-quality#update-a-code-quality-setup-configuration'},
          {'group': 'code_scanning',
           'name': 'list_alerts_for_repo',
@@ -11681,7 +11817,7 @@ spec = {'base_url': 'https://api.github.com',
           'body_params': ['title', 'body', 'assignee', 'state', 'state_reason', 'duplicate_issue_id', 'milestone', 'labels', 'assignees', 'issue_field_values', 'type'],
           'request_content_type': 'application/json',
           'required_params': ['issue_number', 'owner', 'repo'],
-          'param_types': {'owner': 'str', 'repo': 'str', 'issue_number': 'int', 'body': 'str', 'assignee': 'str', 'state': 'str', 'state_reason': 'str', 'duplicate_issue_id': 'int', 'labels': 'list', 'assignees': 'list', 'issue_field_values': 'list', 'type': 'str'},
+          'param_types': {'owner': 'str', 'repo': 'str', 'issue_number': 'int', 'body': 'str', 'assignee': 'str', 'state': 'str', 'state_reason': 'str', 'duplicate_issue_id': 'int', 'labels': 'list', 'assignees': 'list', 'issue_field_values': 'list'},
           'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
                          'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
                          'issue_number': 'The number that identifies the issue.',
@@ -11695,7 +11831,7 @@ spec = {'base_url': 'https://api.github.com',
                          'labels': 'Labels to associate with this issue. Pass one or more labels to _replace_ the set of labels on this issue. Send an empty array (`[]`) to clear all labels from the issue. Only users with push access can set labels for issues. Without push access to the repository, label changes are silently dropped.',
                          'assignees': 'Usernames to assign to this issue. Pass one or more user logins to _replace_ the set of assignees on this issue. Send an empty array (`[]`) to clear all assignees from the issue. Only users with push access can set assignees for new issues. Without push access to the repository, assignee changes are silently dropped.',
                          'issue_field_values': 'An array of issue field values to set on this issue. Each field value must include the field ID and the value to set. Only users with push access can set field values for issues',
-                         'type': 'The name of the issue type to associate with this issue or use `null` to remove the current issue type. Only users with push access can set the type for issues. Without push access to the repository, type changes are silently dropped.'},
+                         'type': 'The issue type to associate with this issue. Only users with push access can set the type for issues. Without push access to the repository, type changes are silently dropped.'},
           'docs_url': 'https://docs.github.com/rest/issues/issues#update-an-issue'},
          {'group': 'issues',
           'name': 'add_assignees',
@@ -11921,7 +12057,7 @@ spec = {'base_url': 'https://api.github.com',
           'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
                          'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
                          'issue_number': 'The number that identifies the issue.',
-                         'labels': 'The names of the labels to add to the issue\'s existing labels. You can also pass an `array` of labels directly, but GitHub recommends passing an object with the `labels` key. To replace all of the labels for an issue, use "[Set labels for an issue](https://docs.github.com/rest/issues/labels#set-labels-for-an-issue)."'},
+                         'labels': 'The labels to add to the issue\'s existing labels. You can also pass an `array` of labels directly, but GitHub recommends passing an object with the `labels` key. To replace all of the labels for an issue, use "[Set labels for an issue](https://docs.github.com/rest/issues/labels#set-labels-for-an-issue)."'},
           'docs_url': 'https://docs.github.com/rest/issues/labels#add-labels-to-an-issue'},
          {'group': 'issues',
           'name': 'set_labels',
@@ -12093,21 +12229,60 @@ spec = {'base_url': 'https://api.github.com',
                          'after_id': 'The id of the sub-issue to be prioritized after (either positional argument after OR before should be specified).',
                          'before_id': 'The id of the sub-issue to be prioritized before (either positional argument after OR before should be specified).'},
           'docs_url': 'https://docs.github.com/rest/issues/sub-issues#reprioritize-sub-issue'},
+         {'group': 'issues',
+          'name': 'list_suggestions',
+          'path': '/repos/{owner}/{repo}/issues/{issue_number}/suggestions',
+          'verb': 'GET',
+          'summary': 'List issue suggestions',
+          'route_params': ['owner', 'repo', 'issue_number'],
+          'query_params': ['state', 'action', 'per_page', 'page'],
+          'required_params': ['issue_number', 'owner', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'issue_number': 'int', 'state': 'str', 'action': 'str', 'per_page': 'int', 'page': 'int'},
+          'param_defaults': {'state': 'pending', 'per_page': 30, 'page': 1},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'issue_number': 'The number that identifies the issue.',
+                         'state': 'Filter suggestions by their state.',
+                         'action': 'Filter suggestions by the change they propose.',
+                         'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
+          'docs_url': 'https://docs.github.com/rest/issues/issues#list-issue-suggestions'},
+         {'group': 'issues',
+          'name': 'approve_suggestion',
+          'path': '/repos/{owner}/{repo}/issues/{issue_number}/suggestions/{suggestion_id}/approve',
+          'verb': 'POST',
+          'summary': 'Approve an issue suggestion',
+          'route_params': ['owner', 'repo', 'issue_number', 'suggestion_id'],
+          'required_params': ['issue_number', 'owner', 'repo', 'suggestion_id'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'issue_number': 'int', 'suggestion_id': 'int'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'issue_number': 'The number that identifies the issue.', 'suggestion_id': 'The unique identifier of the suggestion.'},
+          'docs_url': 'https://docs.github.com/rest/issues/issues#approve-an-issue-suggestion'},
+         {'group': 'issues',
+          'name': 'dismiss_suggestion',
+          'path': '/repos/{owner}/{repo}/issues/{issue_number}/suggestions/{suggestion_id}/dismiss',
+          'verb': 'POST',
+          'summary': 'Dismiss an issue suggestion',
+          'route_params': ['owner', 'repo', 'issue_number', 'suggestion_id'],
+          'required_params': ['issue_number', 'owner', 'repo', 'suggestion_id'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'issue_number': 'int', 'suggestion_id': 'int'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'issue_number': 'The number that identifies the issue.', 'suggestion_id': 'The unique identifier of the suggestion.'},
+          'docs_url': 'https://docs.github.com/rest/issues/issues#dismiss-an-issue-suggestion'},
          {'group': 'issues',
           'name': 'list_events_for_timeline',
           'path': '/repos/{owner}/{repo}/issues/{issue_number}/timeline',
           'verb': 'GET',
           'summary': 'List timeline events for an issue',
           'route_params': ['owner', 'repo', 'issue_number'],
-          'query_params': ['per_page', 'page'],
+          'query_params': ['per_page', 'page', 'exclude'],
           'required_params': ['issue_number', 'owner', 'repo'],
-          'param_types': {'owner': 'str', 'repo': 'str', 'issue_number': 'int', 'per_page': 'int', 'page': 'int'},
+          'param_types': {'owner': 'str', 'repo': 'str', 'issue_number': 'int', 'per_page': 'int', 'page': 'int', 'exclude': 'str'},
           'param_defaults': {'per_page': 30, 'page': 1},
           'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
                          'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
                          'issue_number': 'The number that identifies the issue.',
                          'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
-                         'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
+                         'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'exclude': 'A comma-separated list of timeline event names to exclude from the response.'},
           'docs_url': 'https://docs.github.com/rest/issues/timeline#list-timeline-events-for-an-issue'},
          {'group': 'repos',
           'name': 'list_deploy_keys',
@@ -12912,6 +13087,38 @@ spec = {'base_url': 'https://api.github.com',
                          'sha': 'SHA that pull request head must match to allow merge.',
                          'merge_method': 'The merge method to use.'},
           'docs_url': 'https://docs.github.com/rest/pulls/pulls#merge-a-pull-request'},
+         {'group': 'pulls',
+          'name': 'merge_async',
+          'path': '/repos/{owner}/{repo}/pulls/{pull_number}/merge-async',
+          'verb': 'PUT',
+          'summary': 'Merge a pull request asynchronously',
+          'route_params': ['owner', 'repo', 'pull_number'],
+          'body_params': ['commit_title', 'commit_message', 'sha', 'merge_method', 'merge_action'],
+          'request_content_type': 'application/json',
+          'required_params': ['owner', 'pull_number', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'pull_number': 'int', 'commit_title': 'str', 'commit_message': 'str', 'sha': 'str', 'merge_method': 'str', 'merge_action': 'str'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'pull_number': 'The number that identifies the pull request.',
+                         'commit_title': 'Title for the automatic commit message.',
+                         'commit_message': 'Extra detail to append to automatic commit message.',
+                         'sha': 'SHA that pull request head must match to allow merge. If not provided, the current head of the PR at the time of the request will be used; if the PR is pushed in between the merge being requested and being executed, the merge will be cancelled.',
+                         'merge_method': 'The merge method to use.',
+                         'merge_action': 'The action that will be taken to merge the pull request. `direct_merge` merges the pull request directly without using a merge queue; `merge_queue` adds the pull request to a merge queue; `default` selects the most appropriate option.'},
+          'docs_url': 'https://docs.github.com/rest/pulls/pulls#merge-a-pull-request-asynchronously'},
+         {'group': 'pulls',
+          'name': 'get_merge_async_result',
+          'path': '/repos/{owner}/{repo}/pulls/{pull_number}/merge-async/{uuid}',
+          'verb': 'GET',
+          'summary': 'Get the result of an asynchronous merge',
+          'route_params': ['owner', 'repo', 'pull_number', 'uuid'],
+          'required_params': ['owner', 'pull_number', 'repo', 'uuid'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'pull_number': 'int', 'uuid': 'str'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'pull_number': 'The number that identifies the pull request.',
+                         'uuid': 'The UUID of the asynchronous merge request, as returned when the merge was requested.'},
+          'docs_url': 'https://docs.github.com/rest/pulls/pulls#get-the-result-of-an-asynchronous-merge'},
          {'group': 'pulls',
           'name': 'list_requested_reviewers',
           'path': '/repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers',
@@ -13603,6 +13810,73 @@ spec = {'base_url': 'https://api.github.com',
                          'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
                          'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
           'docs_url': 'https://docs.github.com/rest/secret-scanning/secret-scanning#list-locations-for-a-secret-scanning-alert'},
+         {'group': 'secret_scanning',
+          'name': 'list_repo_custom_patterns',
+          'path': '/repos/{owner}/{repo}/secret-scanning/custom-patterns',
+          'verb': 'GET',
+          'summary': 'List repository custom patterns',
+          'route_params': ['owner', 'repo'],
+          'query_params': ['state', 'push_protection', 'sort', 'direction', 'page', 'per_page'],
+          'required_params': ['owner', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'state': 'str', 'push_protection': 'str', 'sort': 'str', 'direction': 'str', 'page': 'int', 'per_page': 'int'},
+          'param_defaults': {'sort': 'created', 'direction': 'desc', 'page': 1, 'per_page': 30},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'state': 'Filter custom patterns by state. When absent, returns patterns in all states.',
+                         'push_protection': 'Filter custom patterns by whether push protection is enabled. When absent, returns patterns regardless of push protection status.',
+                         'sort': 'The property to sort the results by.',
+                         'direction': 'The direction to sort the results by.',
+                         'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
+          'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#list-repository-custom-patterns'},
+         {'group': 'secret_scanning',
+          'name': 'bulk_create_repo_custom_patterns',
+          'path': '/repos/{owner}/{repo}/secret-scanning/custom-patterns',
+          'verb': 'POST',
+          'summary': 'Bulk create repository custom patterns',
+          'route_params': ['owner', 'repo'],
+          'body_params': ['patterns'],
+          'request_content_type': 'application/json',
+          'required_params': ['owner', 'patterns', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'patterns': 'list'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'patterns': 'The list of custom patterns to create.'},
+          'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#bulk-create-repository-custom-patterns'},
+         {'group': 'secret_scanning',
+          'name': 'bulk_delete_repo_custom_patterns',
+          'path': '/repos/{owner}/{repo}/secret-scanning/custom-patterns',
+          'verb': 'DELETE',
+          'summary': 'Bulk delete repository custom patterns',
+          'route_params': ['owner', 'repo'],
+          'body_params': ['patterns', 'post_delete_action'],
+          'request_content_type': 'application/json',
+          'required_params': ['owner', 'patterns', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'patterns': 'list', 'post_delete_action': 'str'},
+          'param_defaults': {'post_delete_action': 'delete_alerts'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'patterns': 'The list of custom patterns to delete.',
+                         'post_delete_action': 'What to do with alerts associated with the deleted patterns. `delete_alerts` permanently removes the alerts. `resolve_alerts` resolves the alerts as "pattern deleted". Defaults to `delete_alerts` when not specified.'},
+          'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#bulk-delete-repository-custom-patterns'},
+         {'group': 'secret_scanning',
+          'name': 'update_repo_custom_pattern',
+          'path': '/repos/{owner}/{repo}/secret-scanning/custom-patterns/{pattern_id}',
+          'verb': 'PATCH',
+          'summary': 'Update a repository custom pattern',
+          'route_params': ['owner', 'repo', 'pattern_id'],
+          'body_params': ['pattern', 'start_delimiter', 'end_delimiter', 'must_match', 'must_not_match', 'custom_pattern_version'],
+          'request_content_type': 'application/json',
+          'required_params': ['custom_pattern_version', 'owner', 'pattern_id', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'pattern_id': 'int', 'pattern': 'str', 'start_delimiter': 'str', 'end_delimiter': 'str', 'must_match': 'list', 'must_not_match': 'list', 'custom_pattern_version': 'str'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'pattern_id': 'The ID of the custom pattern.',
+                         'pattern': 'The updated regular expression of the custom pattern.',
+                         'start_delimiter': 'The updated start delimiter regex for the custom pattern.',
+                         'end_delimiter': 'The updated end delimiter regex for the custom pattern.',
+                         'must_match': 'Updated list of regexes that the secret must match.',
+                         'must_not_match': 'Updated list of regexes that the secret must not match.',
+                         'custom_pattern_version': "The version of the entity. This is used to confirm you're updating the current version of the entity and mitigate unintentionally overriding someone else's update."},
+          'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#update-a-repository-custom-pattern'},
          {'group': 'secret_scanning',
           'name': 'create_push_protection_bypass',
           'path': '/repos/{owner}/{repo}/secret-scanning/push-protection-bypasses',
@@ -13748,6 +14022,69 @@ spec = {'base_url': 'https://api.github.com',
           'param_types': {'owner': 'str', 'repo': 'str', 'ghsa_id': 'str'},
           'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'ghsa_id': 'The GHSA (GitHub Security Advisory) identifier of the advisory.'},
           'docs_url': 'https://docs.github.com/rest/security-advisories/repository-advisories#create-a-temporary-private-fork'},
+         {'group': 'pull_request_stacks',
+          'name': 'list',
+          'path': '/repos/{owner}/{repo}/stacks',
+          'verb': 'GET',
+          'summary': 'List pull request stacks',
+          'route_params': ['owner', 'repo'],
+          'query_params': ['pull_request', 'per_page', 'page'],
+          'required_params': ['owner', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'pull_request': 'int', 'per_page': 'int', 'page': 'int'},
+          'param_defaults': {'per_page': 30, 'page': 1},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'pull_request': 'Filter to the stack containing this repository pull request number.',
+                         'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."'},
+          'docs_url': 'https://docs.github.com/rest/pulls/stacks#list-pull-request-stacks'},
+         {'group': 'pull_request_stacks',
+          'name': 'create',
+          'path': '/repos/{owner}/{repo}/stacks',
+          'verb': 'POST',
+          'summary': 'Create a pull request stack',
+          'route_params': ['owner', 'repo'],
+          'body_params': ['pull_requests'],
+          'request_content_type': 'application/json',
+          'required_params': ['owner', 'pull_requests', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'pull_requests': 'list'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'pull_requests': 'An ordered list of pull request numbers forming the stack from bottom to top.'},
+          'docs_url': 'https://docs.github.com/rest/pulls/stacks#create-a-pull-request-stack'},
+         {'group': 'pull_request_stacks',
+          'name': 'get',
+          'path': '/repos/{owner}/{repo}/stacks/{stack_number}',
+          'verb': 'GET',
+          'summary': 'Get a pull request stack',
+          'route_params': ['owner', 'repo', 'stack_number'],
+          'required_params': ['owner', 'repo', 'stack_number'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'stack_number': 'int'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'stack_number': 'The number that identifies the pull request stack.'},
+          'docs_url': 'https://docs.github.com/rest/pulls/stacks#get-a-pull-request-stack'},
+         {'group': 'pull_request_stacks',
+          'name': 'add',
+          'path': '/repos/{owner}/{repo}/stacks/{stack_number}/add',
+          'verb': 'POST',
+          'summary': 'Add pull requests to a pull request stack',
+          'route_params': ['owner', 'repo', 'stack_number'],
+          'body_params': ['pull_requests'],
+          'request_content_type': 'application/json',
+          'required_params': ['owner', 'pull_requests', 'repo', 'stack_number'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'stack_number': 'int', 'pull_requests': 'list'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'stack_number': 'The number that identifies the pull request stack.',
+                         'pull_requests': 'An ordered list of pull request numbers to append to the stack, from the current top upward.'},
+          'docs_url': 'https://docs.github.com/rest/pulls/stacks#add-pull-requests-to-a-pull-request-stack'},
+         {'group': 'pull_request_stacks',
+          'name': 'unstack',
+          'path': '/repos/{owner}/{repo}/stacks/{stack_number}/unstack',
+          'verb': 'POST',
+          'summary': 'Remove pull requests from a pull request stack',
+          'route_params': ['owner', 'repo', 'stack_number'],
+          'required_params': ['owner', 'repo', 'stack_number'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'stack_number': 'int'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'stack_number': 'The number that identifies the pull request stack.'},
+          'docs_url': 'https://docs.github.com/rest/pulls/stacks#remove-pull-requests-from-a-pull-request-stack'},
          {'group': 'activity',
           'name': 'list_stargazers_for_repo',
           'path': '/repos/{owner}/{repo}/stargazers',
@@ -14209,10 +14546,10 @@ spec = {'base_url': 'https://api.github.com',
           'verb': 'PATCH',
           'summary': 'Update a team (Legacy)',
           'route_params': ['team_id'],
-          'body_params': ['name', 'description', 'privacy', 'notification_setting', 'permission', 'parent_team_id'],
+          'body_params': ['name', 'description', 'privacy', 'notification_setting', 'permission', 'parent_team_id', 'parent_team_slug'],
           'request_content_type': 'application/json',
           'required_params': ['name', 'team_id'],
-          'param_types': {'team_id': 'int', 'name': 'str', 'description': 'str', 'privacy': 'str', 'notification_setting': 'str', 'permission': 'str', 'parent_team_id': 'int'},
+          'param_types': {'team_id': 'int', 'name': 'str', 'description': 'str', 'privacy': 'str', 'notification_setting': 'str', 'permission': 'str', 'parent_team_id': 'int', 'parent_team_slug': 'str'},
           'param_defaults': {'permission': 'pull'},
           'param_docs': {'team_id': 'The unique identifier of the team.',
                          'name': 'The name of the team.',
@@ -14221,7 +14558,8 @@ spec = {'base_url': 'https://api.github.com',
                                     'team:** * `closed` - visible to all members of this organization.',
                          'notification_setting': 'The notification setting the team has chosen. Editing teams without specifying this parameter leaves `notification_setting` intact. The options are: * `notifications_enabled` - team members receive notifications when the team is @mentioned. * `notifications_disabled` - no one receives notifications.',
                          'permission': '**Closing down notice**. The permission that new repositories will be added to the team with when none is specified.',
-                         'parent_team_id': 'The ID of a team to set as the parent team.'},
+                         'parent_team_id': 'The ID of a team to set as the parent team.',
+                         'parent_team_slug': 'The slug of a team to set as the parent team. Ignored when `parent_team_id` is also provided.'},
           'docs_url': 'https://docs.github.com/rest/teams/teams#update-a-team-legacy'},
          {'group': 'teams',
           'name': 'delete_legacy',

{ghapi-2.0.5 → ghapi-2.0.6}/ghapi/skill.py

@@ -36,7 +36,14 @@ When you want the whole thing as one LLM-ready markdown string rather than struc
 
 `await api.check_status(ref)` merges the two ways CI results get reported -- the modern Checks API (`checks.list_for_ref`, what GitHub Actions uses) and the legacy Commit Status API (`repos.get_combined_status_for_ref`, used by some external CI) -- into one call, given a SHA/branch/tag. `api.pr_status(pull_number)` is the same, resolved from a PR's head commit.
 
-The result's repr is a one-line-per-check summary with a verdict computed from the check runs (the raw `state` field only reflects legacy statuses, so it reads `pending` on repos that only use Actions). Display it bare; drop to `.check_runs`/`.statuses` only when the summary isn't enough.
+The result's repr is the triage step: a verdict line (computed from the check runs -- the raw `state` field only reflects legacy statuses, so it reads `pending` on repos that only use Actions), then the run list as concise one-line rows, `id  name: conclusion (duration)`, plus any legacy statuses. Display it bare; drop to the `.check_runs`/`.statuses` fields only when the rows aren't enough.
+
+The recommended process for working through a set of possibly-red repos:
+
+    api = GhApi(owner='AnswerDotAI')
+    sts = dict(zip(repos, await asyncio.gather(*(api.check_status('main', repo=r) for r in repos))))
+
+One `gather` gives every repo's verdict at once. For each red repo, display its full status -- every run, not just the failures, since a failed run beside a similar green one is itself diagnostic -- then feed the failing row's id to `await api.failed_step_log(id, repo=r)`: a check run and its Actions job share an id, so the row leads straight to its log, returned cut down to just the failed steps' sections. Job logs expire after about 90 days, so grab them while the run is fresh.
 
 # Day-to-day work
 

{ghapi-2.0.5 → ghapi-2.0.6/ghapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.0.5
+Version: 2.0.6
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
 License: Apache-2.0
@@ -16,7 +16,8 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: fastcore>=2.1.16
-Requires-Dist: fastspec>=0.1.2
+Requires-Dist: fastspec>=0.1.5
+Requires-Dist: tomli; python_version < "3.11"
 Provides-Extra: dev
 Requires-Dist: fastgit; extra == "dev"
 Requires-Dist: matplotlib; extra == "dev"

{ghapi-2.0.5 → ghapi-2.0.6}/ghapi.egg-info/requires.txt

@@ -1,5 +1,8 @@
 fastcore>=2.1.16
-fastspec>=0.1.2
+fastspec>=0.1.5
+
+[:python_version < "3.11"]
+tomli
 
 [dev]
 fastgit

{ghapi-2.0.5 → ghapi-2.0.6}/pyproject.toml

@@ -12,7 +12,7 @@ license = {text = "Apache-2.0"}
 authors = [{name = "Jeremy Howard", email = "info@fast.ai"}]
 keywords = ['github', 'api']
 classifiers = ["Natural Language :: English", "Intended Audience :: Developers", "Development Status :: 5 - Production/Stable", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only"]
-dependencies = ['fastcore>=2.1.16', 'fastspec>=0.1.2']
+dependencies = ['fastcore>=2.1.16', 'fastspec>=0.1.5', 'tomli; python_version < "3.11"']
 
 [project.urls]
 Repository = "https://github.com/fastai/ghapi"