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

github_agent/__init__.py

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

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.6"
+__version__ = "2.4.8"
 logger = get_logger("GithubMCPServer")
 logger.setLevel(logging.INFO)
 

github_agent/ontology/github.ttl

@@ -13,36 +13,18 @@
 # github_branches / github_commits / github_actions / github_orgs). The shared
 # :Person / :Document classes (users, release notes) are REUSED, never redefined.
 
+# Shared concepts owned by the epistemic-graph ontology and referenced here, never redeclared:
+# Repository, PullRequest, Release, Branch, Commit, PipelineRun. Only the GitHub-specific subclasses and properties are declared in this pack.
+
 :Organization a owl:Class ;
     rdfs:label "Organization" ;
     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)." .
-
-:PullRequest a owl:Class ;
-    rdfs:label "Pull Request" ;
-    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)." .
 
-:Release a owl:Class ;
-    rdfs:label "Release" ;
-    rdfs:comment "A tagged, published repository release with release notes (github_releases)." .
-
-:Branch a owl:Class ;
-    rdfs:label "Branch" ;
-    rdfs:comment "A named git branch within a repository (github_branches)." .
-
-:Commit a owl:Class ;
-    rdfs:label "Commit" ;
-    rdfs:comment "A git commit recorded in a repository (github_commits)." .
-
 :Workflow a owl:Class ;
     rdfs:label "Workflow" ;
     rdfs:comment "A GitHub Actions CI/CD workflow definition (github_actions)." .
@@ -52,13 +34,8 @@
     rdfs:label "Workflow Run" ;
     rdfs:comment "A single execution of a GitHub Actions workflow for a ref/commit (github_actions)." .
 
-:PipelineRun a owl:Class ;
-    rdfs:label "Pipeline Run" ;
-    rdfs:comment """A single CI/CD execution for a ref/commit (github_actions workflow run).
-    Shares its class name with the twin gitlab-api producer so GitHub Actions and GitLab
-    CI/CD unify under one node shape in the knowledge graph.""" .
-
 :CheckRun a owl:Class ;
+    rdfs:subClassOf :PipelineRun ;
     rdfs:label "Check Run" ;
     rdfs:comment """A single job/check within a PipelineRun (github_actions workflow-run job or
     GitHub Checks-API check run). Shares its class name with the twin gitlab-api producer.""" .
@@ -140,6 +117,7 @@
 :state a owl:DatatypeProperty ;
     rdfs:label "state" ;
     rdfs:comment "Lifecycle state (open, closed, merged)." ;
+    rdfs:domain [ a owl:Class ; owl:unionOf ( :Issue :PullRequest ) ] ;
     rdfs:range xsd:string .
 
 :number a owl:DatatypeProperty ;

github_agent/ontology/ingest_sources.json

@@ -0,0 +1,24 @@
+{
+  "connector": "github-mcp",
+  "sources": [
+    {
+      "source_id": "issues",
+      "record_type": "Issue",
+      "tools": [
+        "github_search_issues"
+      ],
+      "records_path": "data.items",
+      "id_field": "id",
+      "title_field": "title",
+      "text_field": "body",
+      "cursor_field": "updated_at",
+      "incremental": false,
+      "arguments": {
+        "q": "is:issue is:open involves:@me",
+        "per_page": 50,
+        "max_pages": 1
+      },
+      "description": "Open GitHub issues involving the authenticated user (first 50)."
+    }
+  ]
+}

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-agent
-Version: 2.4.6
+Version: 2.4.8
 Summary: GitHub Agent for MCP
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -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.6*
+*Version: 2.4.8*
 
 > **Documentation** — Installation, deployment, and usage across the MCP, API, and
 > [official documentation](https://knuckles-team.github.io/github-agent/).

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

@@ -1,4 +1,4 @@
-github_agent/__init__.py,sha256=jbv3GfuSUTWNtlhuY3Dgm_vD4Uuj9i1AVwV8tthwnik,22
+github_agent/__init__.py,sha256=glMuOQomGqPeJvn8UHzLa83MujqjNX2vpagybeMit4A,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=pG0hdoXFshlO0my4VxfQiJf0j-ZY098UJX515L5x09k,126620
+github_agent/mcp_server.py,sha256=XZEV8zYUZAJk34_rtFHTKnWMGqwbYRHgd3ZMuAM59dI,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,8 @@ 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=U2jeFMGCqhsyu9G4AzTXaw1xmSWrqLlbSXTWduWxccw,9260
+github_agent/ontology/github.ttl,sha256=v5lzPQkPBvjuzXYdg1rMHcsARExIsTdkshebvfnhyp8,8573
+github_agent/ontology/ingest_sources.json,sha256=70glHq2q8MEQCxD22r2VPyz_7mubibf1iygCf-sSdMs,572
 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 +93,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.6.dist-info/licenses/LICENSE,sha256=5ALbh4fIALWVsUhO7q1nFT1bQb-CL9sWKf7p3GgLEG8,1070
+github_agent-2.4.8.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 +102,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_cq_paths.py,sha256=f4pf4NcI_SFL_7EVkK93ZMaF7W-0vQ9CTxGE9FS6Wkk,1524
 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
@@ -108,12 +110,13 @@ tests/test_github_agent_brute_force_coverage.py,sha256=Z_voXtChOYRqaNEmNzMfzvwQM
 tests/test_github_gql.py,sha256=M55X5V2orZ1kVek16s1zaMJIUb6FhlfbC8k0cKkD07Y,2709
 tests/test_github_http.py,sha256=uuSMrot71Kj8WQf-QyazO4rWzpWSucRTQ1tt5wRvC_E,9563
 tests/test_hardening.py,sha256=sdlKmtk7B5yncc-r1LuFgoJfro6wNlCqY0xI73IVC4M,3710
+tests/test_ingest_sources.py,sha256=hzY7vDW5Q1P-Qc_X6PAFAnXik_0BIP1DrNLVPhe_9DQ,1391
 tests/test_init_dynamics.py,sha256=fPE_4M-bONKiqvtWLn12A0q18CUlzQhdx1UoXYkbbPk,1839
 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_ontology_parent_link.py,sha256=-NrJYBVmYF9OswmRXDgvSYDhqGVZcDfQenxKUilUSsw,4210
 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
@@ -125,8 +128,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.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,,
+github_agent-2.4.8.dist-info/METADATA,sha256=uAvn9bQvqFs6_Ma0RpcJHxA-HIq4rvhXUpkDIp61gNk,34508
+github_agent-2.4.8.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+github_agent-2.4.8.dist-info/entry_points.txt,sha256=Wi6GhziOqmJl-22qTYkjfVuIHEHKRrBvyyloc7NqV80,367
+github_agent-2.4.8.dist-info/top_level.txt,sha256=53Ecr8n7o_EMIqZClc11PBU07uQIggYZOk5WnvBbeOQ,50
+github_agent-2.4.8.dist-info/RECORD,,

tests/test_cq_paths.py

@@ -0,0 +1,50 @@
+"""Competency-question paths of the GitHub pack (CONN-GITHUB-AGENT-CONNECTOR-CONTENT-R004)."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import pytest
+import yaml
+
+import github_agent
+
+pytestmark = pytest.mark.spec("CONN-GITHUB-AGENT-CONNECTOR-CONTENT-R004")
+
+PACKAGE = Path(github_agent.__file__).parent
+TTL = (PACKAGE / "ontology" / "github.ttl").read_text("utf-8")
+# Concepts the epistemic-graph ontology owns: referenced, never declared here.
+SHARED = ("Repository", "PullRequest", "Release", "Branch", "Commit", "PipelineRun")
+
+
+def _block(name: str) -> str:
+    match = re.search(rf"^:{name} a [^\n]*\n(?:[^\n]+\n)*", TTL, flags=re.M)
+    assert match, name
+    return match.group(0)
+
+
+@pytest.mark.parametrize("name", SHARED)
+def test_shared_concepts_are_not_redeclared(name: str) -> None:
+    assert not re.search(rf"^:{name} a owl:Class", TTL, flags=re.M), name
+
+
+def test_state_is_declared_on_the_issue_type() -> None:
+    block = _block("state")
+    assert re.search(r"rdfs:domain \[ a owl:Class ; owl:unionOf \( :Issue ", block)
+
+
+def test_check_run_extends_pipeline_run() -> None:
+    assert "rdfs:subClassOf :PipelineRun" in _block("CheckRun")
+
+
+def test_no_mapping_has_a_null_ontology_class() -> None:
+    manifest = yaml.safe_load(
+        (PACKAGE.parent / "connector_manifest.yml").read_text("utf-8")
+    )
+    unmapped = [
+        name
+        for name, mapping in manifest["schema_mappings"].items()
+        if not mapping["ontology_class"]
+    ]
+    assert unmapped == []

tests/test_ingest_sources.py

@@ -0,0 +1,34 @@
+"""The packaged ingestible-source declaration (CONN-GITHUB-AGENT-CONNECTOR-CONTENT-R003)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+import yaml
+from agent_connector_sdk.ingest.sources import load_ingest_sources
+from agent_connector_sdk.mcp.method_tools import operation_annotations, operation_verb
+from agent_connector_sdk.mcp.tool_surface import operation_prefix
+
+import github_agent
+from github_agent.api_client import Api
+
+
+@pytest.mark.spec("CONN-GITHUB-AGENT-CONNECTOR-CONTENT-R003")
+def test_declares_ingestible_sources() -> None:
+    package_root = Path(github_agent.__file__).parent
+    declaration = load_ingest_sources(package_root)
+    assert declaration is not None
+    assert declaration.connector == "github-mcp"
+    source = declaration.source("issues")
+    assert source is not None and source.record_type == "Issue"
+    prefix = operation_prefix("github-agent")
+    assert source.tools == (f"{prefix}_search_issues",)
+    # The engine admits a record only under the pack mapping of its type.
+    manifest = yaml.safe_load(
+        (package_root.parent / "connector_manifest.yml").read_text("utf-8")
+    )
+    assert source.record_type in manifest["schema_mappings"]
+    method = getattr(Api, "search_issues")
+    annotations = operation_annotations("search_issues", operation_verb(method))
+    assert annotations.read_only_hint is True

tests/test_ontology_parent_link.py

@@ -32,13 +32,7 @@ PARENT_CLASSES = frozenset(
 )
 # 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",
-    )
-)
+PENDING_NEW_PARENT: frozenset[str] = frozenset()
 
 _STRING = re.compile(r'"""(?:.|\n)*?"""|"(?:[^"\\\n]|\\.)*"')
 _IRI = re.compile(r"<([^<>\s]*)>")