github-agent 2.4.4__py3-none-any.whl → 2.4.6__py3-none-any.whl

github_agent/__init__.py

@@ -1 +1 @@
-__version__ = "2.4.4"
+__version__ = "2.4.6"

github_agent/mcp_server.py

@@ -39,7 +39,7 @@ from github_agent.auth import (
 )
 from github_agent.github_response_models import PagesAlreadyEnabled, PagesNotEnabled
 
-__version__ = "2.4.4"
+__version__ = "2.4.6"
 logger = get_logger("GithubMCPServer")
 logger.setLevel(logging.INFO)
 

github_agent/ontology/github.ttl

@@ -18,6 +18,7 @@
     rdfs:comment "A GitHub organization that owns repositories and members (github_orgs)." .
 
 :Repository a owl:Class ;
+    rdfs:subClassOf :SoftwareProject ;
     rdfs:label "Repository" ;
     rdfs:comment "A GitHub repository / codebase (github_repos)." .
 
@@ -26,6 +27,7 @@
     rdfs:comment "A proposed change under review, from a head to a base branch (github_pulls)." .
 
 :Issue a owl:Class ;
+    rdfs:subClassOf :WorkItem ;
     rdfs:label "Issue" ;
     rdfs:comment "A tracked work item, bug, or discussion in a repository (github_issues)." .
 
@@ -46,6 +48,7 @@
     rdfs:comment "A GitHub Actions CI/CD workflow definition (github_actions)." .
 
 :WorkflowRun a owl:Class ;
+    rdfs:subClassOf :PipelineRun ;
     rdfs:label "Workflow Run" ;
     rdfs:comment "A single execution of a GitHub Actions workflow for a ref/commit (github_actions)." .
 

{github_agent-2.4.4.dist-info → github_agent-2.4.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-agent
-Version: 2.4.4
+Version: 2.4.6
 Summary: GitHub Agent for MCP
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -13,7 +13,7 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.34.2
-Requires-Dist: agent-connector-sdk[graphql,mcp]<1.0.0,>=0.3.13
+Requires-Dist: agent-connector-sdk[graphql,mcp]<1.0.0,>=0.3.18
 Provides-Extra: mcp
 Provides-Extra: all
 Provides-Extra: test
@@ -44,7 +44,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/github-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/github-agent)
 
-*Version: 2.4.4*
+*Version: 2.4.6*
 
 > **Documentation** — Installation, deployment, and usage across the MCP, API, and
 > [official documentation](https://knuckles-team.github.io/github-agent/).

{github_agent-2.4.4.dist-info → github_agent-2.4.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-github_agent/__init__.py,sha256=zUyWRJ2idk3EkNSUQlyMfzQtAlpD5CCHF2ifejOcf-w,22
+github_agent/__init__.py,sha256=jbv3GfuSUTWNtlhuY3Dgm_vD4Uuj9i1AVwV8tthwnik,22
 github_agent/__main__.py,sha256=O4Xg__fMvKfUsA6m61pLV56jlYY6EORiLhgDLlp0vJ8,92
 github_agent/api_client.py,sha256=O69YfkXBKyVd59EC8szaMlw3_ZxwEEvsLSvhWlfYnvk,1581
 github_agent/auth.py,sha256=isNd6DYbl_syB_wIbC399d_-157jqH1jqJfDmBn8h-0,4671
@@ -8,7 +8,7 @@ github_agent/github_input_models.py,sha256=yqqPGHb206th736MZvbnxq9F1JRsBUBODNeNV
 github_agent/github_response_models.py,sha256=mllSt0frBgzklUtfuHywJ2Ald3m99So948Xikt3H2Tc,8859
 github_agent/kg_ingest.py,sha256=iH_NKpd8a6GtNxfZTp8Oah8VZkcXjI74KDf8P9NbtjA,17978
 github_agent/mcp_config.json,sha256=2OOXrwO1sDLyHQqpZwhvDHizPIe3by6YmK4KFE333gI,23
-github_agent/mcp_server.py,sha256=33fgoJXLclmFKHyGzFJDv78JhvYZ-bcQ3rKVEQ_JB_8,126620
+github_agent/mcp_server.py,sha256=pG0hdoXFshlO0my4VxfQiJf0j-ZY098UJX515L5x09k,126620
 github_agent/api/__init__.py,sha256=ntaEPqk-dsAV3HyyDLc2hYpc9nTTyG5CKI-SVDDjc24,27
 github_agent/api/api_client_base.py,sha256=tMXKrZIXg6aQ6OK4kNKBDcNc8BrM0Vml_66SwA5ZgEw,7485
 github_agent/api/api_client_branches.py,sha256=bCmqGUWQ27GFTGxcFkQ7D-ZEltKp6APVsk_Fw9wzdjY,3940
@@ -42,7 +42,7 @@ github_agent/mcp/mcp_repo.py,sha256=ny5GdawCFZxlbjpOc3ttnn-NIs9QDQLAxRdAWEWLUdc,
 github_agent/mcp/mcp_search.py,sha256=3ZBGNKkVu5oBXgN9MBWd-ve4NDCzcwP9sY22bp4hqKs,2963
 github_agent/ontology/__init__.py,sha256=-qc7ZPSgdaCLrD1AH_7TFXWikEpSH9rVmBciCC9gtCY,552
 github_agent/ontology/certification.json,sha256=nUT_C-AtTjtb4bDAs3cDT2vlk7kK_8RPFfbyIWXCMw0,1664
-github_agent/ontology/github.ttl,sha256=socWm6ST7jnTqZFxurxYdNIY1Ivx6JaW7MiJiX3-onk,9154
+github_agent/ontology/github.ttl,sha256=U2jeFMGCqhsyu9G4AzTXaw1xmSWrqLlbSXTWduWxccw,9260
 github_agent/ontology/fixtures/records.json,sha256=EvW1Swrph3DyefmeE2eI0GM0AEKp1v9LrAwiqIbS3Hs,543
 github_agent/ontology/mappings/source.yaml,sha256=f_ejdVD4JaYf5tD5UpIG9O_icnQx4yuKuVo5oyvc7UM,533
 github_agent/ontology/migrations/manifest.json,sha256=rfFgIlAt0DHdMDpSq656Bnfs4RNeHgXCHbokya5Rk1w,118
@@ -92,7 +92,7 @@ github_agent/skills/github-triage-resolver/WORKFLOW.md,sha256=orvcRmaV-qb_JKoGSw
 github_agent/skills/github-triage-resolver/references/resolution-rules.md,sha256=lGPvfLCSHpNIeh2rKWcH2k_2lla3ovgBxzwvtMmyQ-0,4133
 github_agent/skills/github-triage-resolver/scripts/classify_safe.py,sha256=8BhcDF9Q8rjJIEVOmdyO-dO-eHBjW7T-bzaYC16uY5I,9556
 github_agent/skills/github-triage-resolver/scripts/gh_write.py,sha256=SL5oA1A3lFRLepNri4CzEcuEsg9D5WKJ1000fCRKBEM,4125
-github_agent-2.4.4.dist-info/licenses/LICENSE,sha256=5ALbh4fIALWVsUhO7q1nFT1bQb-CL9sWKf7p3GgLEG8,1070
+github_agent-2.4.6.dist-info/licenses/LICENSE,sha256=5ALbh4fIALWVsUhO7q1nFT1bQb-CL9sWKf7p3GgLEG8,1070
 scripts/security_sanitizer.py,sha256=gE65xtYMGx43oYUnK0kozBm73Hx97mCdrQUM7GGzIbk,9449
 scripts/verify_api_integration.py,sha256=3AK8HKW52o1yxCDaEUtXngnh7CjYw6NiG9Eb3EIoXNE,10256
 tests/conftest.py,sha256=kgpOLUp_q8IZaI6Xd7F1tbFuio81-_l5Gd4jaGiMrnY,3636
@@ -101,6 +101,7 @@ tests/test_api_client_endpoints.py,sha256=Hbw0vssQU5Up-KvJmUDLDCP4t2u8pU-xPfWAhF
 tests/test_api_validation.py,sha256=CRZq7kfc1U8CLZJRTGusBhTN2Tlfc1FIeDqIm895XoI,3301
 tests/test_auth_client_edge_cases.py,sha256=QjQAtjd7vDDsSSvIZuUXbd9Z58te8Xp9giPFmwJTBsA,6470
 tests/test_comment_crud.py,sha256=mHA0scds_0W0oND-VI0QMvNaYarYkHjiXd4H9-9d5kE,27341
+tests/test_default_content_surfaces.py,sha256=UQdDIHHd-X4lvsj2ti2QnNwtsQAayL7b003dQ8UXqMo,1403
 tests/test_fleet_name.py,sha256=qCLzYTPuiaS3y0I0NLuMRloXlf_o0sue0aVH-Sn-tYQ,1893
 tests/test_github_agent_api_brute_force_coverage.py,sha256=5jWW6oVU7cmXL2sS3OZ-3gbYGhyjlYPIWqH2rsdF2fw,7347
 tests/test_github_agent_brute_force_coverage.py,sha256=Z_voXtChOYRqaNEmNzMfzvwQMj2xFBn1m8mXx5ubUe8,4849
@@ -112,6 +113,7 @@ tests/test_kg_ingest.py,sha256=TeHjWz74LiuSxpI7N6HHrdj0H1mRsJHceQDNYvre4To,9462
 tests/test_mcp_coverage.py,sha256=W_7fbCWoFd4mDwKvah2DmQRcy0fD7tI4ykFTne69tNM,43550
 tests/test_mcp_package_dispatch.py,sha256=mzrC-jGl3DlrQx9z5uIxy1m0x9qsxfMo6eJImx844WY,22993
 tests/test_model_fields.py,sha256=GvVFFedjdL0KBl328-NZ0SM6olv7muiglsMh0Vd59As,3388
+tests/test_ontology_parent_link.py,sha256=gMdFdrsjYVnKii3f93hBufvfMES4we3ffH1xsH2Rnok,4352
 tests/test_org_crud.py,sha256=7WMb8eCWSsl_rCILBmsJ4OFnmwtb_GXmebf51O8xsxI,19938
 tests/test_pages.py,sha256=CGlxgPVrhvPnnXuFZwzF4VqsV4ygBDY8w8Cqr6KqJmI,18726
 tests/test_repo_secrets_characterization.py,sha256=-9NkJlROsKIYKcNEZpVYy7tkJg-lB0_8We1RvOW1EaY,6043
@@ -123,8 +125,8 @@ tests/test_skill_org_remediation_classify_fix_risk.py,sha256=0Y8289lhxtJ3pxYUHzO
 tests/test_skill_pr_review_sweep_summarize_prs.py,sha256=NrNaucQvM7K-k1WBcOBKtTGjxJbW16VgTHbC7dSsjm4,3821
 tests/test_skill_triage_resolver_classify_safe.py,sha256=B-aDeVmsKTsxYO8TwMEx-cmpVSmZdlKXw5993Da2ubc,9489
 tests/test_startup.py,sha256=Ix_g69k0tsZbY0-Vkeh8ADWojUdbYwTwwmnM4_hVuCc,1245
-github_agent-2.4.4.dist-info/METADATA,sha256=Fvbp3Urv5vaeNmDqM2HZ1JaOxcEsRmAhQk7qUH09EFI,34508
-github_agent-2.4.4.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
-github_agent-2.4.4.dist-info/entry_points.txt,sha256=Wi6GhziOqmJl-22qTYkjfVuIHEHKRrBvyyloc7NqV80,367
-github_agent-2.4.4.dist-info/top_level.txt,sha256=53Ecr8n7o_EMIqZClc11PBU07uQIggYZOk5WnvBbeOQ,50
-github_agent-2.4.4.dist-info/RECORD,,
+github_agent-2.4.6.dist-info/METADATA,sha256=BOOnSktEQdzcve5WQ4RhGYGqwGI7tldjOI5F2pg2wUc,34508
+github_agent-2.4.6.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+github_agent-2.4.6.dist-info/entry_points.txt,sha256=Wi6GhziOqmJl-22qTYkjfVuIHEHKRrBvyyloc7NqV80,367
+github_agent-2.4.6.dist-info/top_level.txt,sha256=53Ecr8n7o_EMIqZClc11PBU07uQIggYZOk5WnvBbeOQ,50
+github_agent-2.4.6.dist-info/RECORD,,

tests/test_default_content_surfaces.py

@@ -0,0 +1,43 @@
+"""CONN-GITHUB-AGENT-CONNECTOR-CONTENT-R001: the server lists its packaged skills, ontology and prompts by default."""
+
+from __future__ import annotations
+
+import asyncio
+import importlib
+from pathlib import Path
+
+import pytest
+from fastmcp import Client
+
+PACKAGE = "github_agent"
+ROOT = Path(list(importlib.import_module(PACKAGE).__path__)[0])
+
+pytestmark = pytest.mark.spec("CONN-GITHUB-AGENT-CONNECTOR-CONTENT-R001")
+
+
+def _server():
+    namespace = {"__name__": PACKAGE + ".mcp_server"}
+    exec(
+        "from agent_connector_sdk.mcp.server import create_mcp_server\n"
+        "result = create_mcp_server('github-mcp', version='0', command_args=[])",
+        namespace,
+    )
+    return namespace["result"][1]
+
+
+async def _listings():
+    async with Client(_server()) as client:
+        resources = {str(r.uri) for r in await client.list_resources()}
+        prompts = {p.name for p in await client.list_prompts()}
+    return resources, prompts
+
+
+def test_default_content_surfaces() -> None:
+    resources, prompts = asyncio.run(_listings())
+    if list(ROOT.glob("skills/*/SKILL.md")):
+        assert any(u.startswith("skill://") for u in resources)
+    if list(ROOT.glob("ontology/*.ttl")):
+        assert any(u.startswith("ontology://github-mcp/") for u in resources)
+    for path in ROOT.glob("prompts/*.json"):
+        if not path.name.startswith("_"):
+            assert path.stem in prompts

tests/test_ontology_parent_link.py

@@ -0,0 +1,114 @@
+"""Every class of the packaged ontology reaches an epistemic-graph parent class (CONN-GITHUB-AGENT-CONNECTOR-CONTENT-R002)."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.spec("CONN-GITHUB-AGENT-CONNECTOR-CONTENT-R002")
+
+PARENT_IRI = "http://knuckles.team/kg"
+ONTOLOGIES = sorted(
+    (Path(__file__).resolve().parents[1] / "github_agent" / "ontology").glob("*.ttl")
+)
+OWL = "http://www.w3.org/2002/07/owl#"
+RDF_TYPE = "http://www.w3.org/1999/02/22-rdf-syntax-ns#type"
+SUBCLASS = "http://www.w3.org/2000/01/rdf-schema#subClassOf"
+# Parent classes of the epistemic-graph ontology that this connector links to or redeclares.
+PARENT_CLASSES = frozenset(
+    (
+        "http://knuckles.team/kg#Commit",
+        "http://knuckles.team/kg#Document",
+        "http://knuckles.team/kg#Organization",
+        "http://knuckles.team/kg#Person",
+        "http://knuckles.team/kg#PipelineRun",
+        "http://knuckles.team/kg#PullRequest",
+        "http://knuckles.team/kg#SoftwareProject",
+        "http://knuckles.team/kg#WorkItem",
+        "http://knuckles.team/kg#Workflow",
+    )
+)
+# Classes for which the parent ontology has no fitting class yet. Each is a candidate for a new
+# parent class (see the orphan mapping report); a class leaves this set when it gains a parent.
+PENDING_NEW_PARENT: frozenset[str] = frozenset(
+    (
+        "http://knuckles.team/kg#Branch",
+        "http://knuckles.team/kg#CheckRun",
+        "http://knuckles.team/kg#Release",
+    )
+)
+
+_STRING = re.compile(r'"""(?:.|\n)*?"""|"(?:[^"\\\n]|\\.)*"')
+_IRI = re.compile(r"<([^<>\s]*)>")
+_PREFIX = re.compile(r"(?im)^\s*@?prefix\s+([A-Za-z][\w.-]*)?:\s+\x00(\d+)\s*\.?")
+_END = re.compile(r"\s\.(?=\s|$)|(?<=[\]>)\w\"'])\.(?=\s|$)")
+
+
+def _triples(text: str) -> list[tuple[str, str, str]]:
+    """Subject, predicate and object of a Turtle file; names are expanded, literals dropped."""
+    iris: list[str] = []
+
+    def keep(match: re.Match[str]) -> str:
+        iris.append(match.group(1))
+        return f" \x00{len(iris)} "
+
+    body = re.sub(r"(?m)#[^\n]*$", "", _IRI.sub(keep, _STRING.sub(' "" ', text)))
+    prefixes = {
+        m.group(1) or "": iris[int(m.group(2)) - 1] for m in _PREFIX.finditer(body)
+    }
+    body = re.sub(r"\[[^\[\]]*\]", " _:b ", _PREFIX.sub("", body))
+
+    def expand(token: str) -> str:
+        if token.startswith("\x00"):
+            return iris[int(token[1:]) - 1]
+        prefix, sep, local = token.partition(":")
+        return (
+            prefixes[prefix] + local
+            if sep and prefix in prefixes
+            else RDF_TYPE
+            if token == "a"
+            else token
+        )
+
+    triples: list[tuple[str, str, str]] = []
+    for statement in _END.split(body):
+        tokens = statement.replace(";", " ; ").replace(",", " , ").split()
+        subject, predicate, fresh = "", "", True
+        for index, token in enumerate(tokens):
+            if index == 0:
+                subject = expand(token)
+            elif token == ";":
+                fresh = True
+            elif token != ",":
+                if fresh:
+                    predicate, fresh = expand(token), False
+                else:
+                    triples.append((subject, predicate, expand(token)))
+    return triples
+
+
+def _orphans(triples: list[tuple[str, str, str]]) -> set[str]:
+    declared = {s for s, p, o in triples if p == RDF_TYPE and o == OWL + "Class"}
+    linked: set[str] = set()
+    changed = True
+    while changed:
+        changed = False
+        for cls in declared - linked - PARENT_CLASSES:
+            ups = {o for s, p, o in triples if s == cls and p == SUBCLASS}
+            if ups & (PARENT_CLASSES | linked):
+                linked.add(cls)
+                changed = True
+    return declared - linked - PARENT_CLASSES
+
+
+@pytest.mark.parametrize("path", ONTOLOGIES, ids=lambda p: p.name)
+def test_ontology_joins_the_parent_graph(path: Path) -> None:
+    triples = _triples(path.read_text(encoding="utf-8"))
+    declared = {s for s, p, o in triples if p == RDF_TYPE and o == OWL + "Class"}
+    if not declared:
+        pytest.skip("declares no classes")
+    imports = {o for s, p, o in triples if p == OWL + "imports"}
+    assert any(i == PARENT_IRI or i.startswith(PARENT_IRI + "/") for i in imports)
+    assert _orphans(triples) == PENDING_NEW_PARENT & declared