plane-agent 2.3.3__tar.gz → 2.3.5__tar.gz

{plane_agent-2.3.3/plane_agent.egg-info → plane_agent-2.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plane-agent
-Version: 2.3.3
+Version: 2.3.5
 Summary: Plane MCP Agent
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -47,7 +47,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
 
-*Version: 2.3.3*
+*Version: 2.3.5*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > interfaces, and guidance for provisioning a self-hosted Plane instance are

{plane_agent-2.3.3 → plane_agent-2.3.5}/README.md

@@ -20,7 +20,7 @@
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
 
-*Version: 2.3.3*
+*Version: 2.3.5*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > interfaces, and guidance for provisioning a self-hosted Plane instance are

plane_agent-2.3.5/plane_agent/ontology/ingest_sources.json

@@ -0,0 +1,16 @@
+{
+  "connector": "plane-mcp",
+  "sources": [
+    {
+      "source_id": "projects",
+      "record_type": "SoftwareProject",
+      "tools": ["plane_list_projects"],
+      "records_path": "data",
+      "id_field": "id",
+      "title_field": "name",
+      "text_field": "description",
+      "incremental": false,
+      "description": "Plane projects in the configured workspace."
+    }
+  ]
+}

{plane_agent-2.3.3 → plane_agent-2.3.5}/plane_agent/ontology/plane.ttl

@@ -21,6 +21,7 @@
     rdfs:comment "A Plane project: a container of work items, cycles and modules within a workspace (plane_projects). Named :SoftwareProject to stay distinct from other sources' generic :Project." .
 
 :Issue a owl:Class ;
+    rdfs:subClassOf :WorkItem ;
     rdfs:label "Issue" ;
     rdfs:comment "A Plane work item / issue — the unit of tracked work with a state, priority and assignees (plane_work_items)." .
 
@@ -37,6 +38,7 @@
     rdfs:comment "A workflow state a work item can occupy (e.g. Backlog, Todo, In Progress, Done) within a project (plane_states)." .
 
 :Label a owl:Class ;
+    rdfs:subClassOf :Tag ;
     rdfs:label "Label" ;
     rdfs:comment "A tag applied to work items for classification within a project (plane_labels)." .
 

{plane_agent-2.3.3 → plane_agent-2.3.5/plane_agent.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plane-agent
-Version: 2.3.3
+Version: 2.3.5
 Summary: Plane MCP Agent
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -47,7 +47,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
 
-*Version: 2.3.3*
+*Version: 2.3.5*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > interfaces, and guidance for provisioning a self-hosted Plane instance are

{plane_agent-2.3.3 → plane_agent-2.3.5}/plane_agent.egg-info/SOURCES.txt

@@ -33,6 +33,7 @@ plane_agent/connectors/mcp_source_presets.json
 plane_agent/connectors/tool_schema_fingerprints.json
 plane_agent/ontology/__init__.py
 plane_agent/ontology/certification.json
+plane_agent/ontology/ingest_sources.json
 plane_agent/ontology/plane.ttl
 plane_agent/ontology/fixtures/records.json
 plane_agent/ontology/mappings/source.yaml
@@ -63,8 +64,10 @@ tests/conftest.py
 tests/test_action_discovery.py
 tests/test_coverage_gap_fillers.py
 tests/test_default_content_surfaces.py
+tests/test_ingest_sources.py
 tests/test_init.py
 tests/test_init_dynamics.py
 tests/test_kg_ingest.py
+tests/test_ontology_parent_link.py
 tests/test_rank_items.py
 tests/test_startup.py

{plane_agent-2.3.3 → plane_agent-2.3.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "plane-agent"
-version = "2.3.3"
+version = "2.3.5"
 description = "Plane MCP Agent"
 readme = "README.md"
 classifiers = [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]

plane_agent-2.3.5/tests/test_ingest_sources.py

@@ -0,0 +1,32 @@
+"""The packaged ingestible-source declaration (CONN-PLANE-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.tool_surface import operation_prefix
+
+import plane_agent
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+
+
+@pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
+def test_declares_ingestible_sources() -> None:
+    declaration = load_ingest_sources(Path(plane_agent.__file__).parent)
+    assert declaration is not None
+    assert declaration.connector == "plane-mcp"
+    source = declaration.source("projects")
+    assert source is not None and source.record_type == "SoftwareProject"
+    prefix = operation_prefix("plane-agent")
+    assert source.tools == (f"{prefix}_list_projects",)
+    # The engine admits a record only under the pack mapping of its type.
+    manifest = yaml.safe_load(
+        (REPO_ROOT / "connector_manifest.yml").read_text("utf-8")
+    )
+    assert source.record_type in manifest["schema_mappings"]
+    # Work items are project-scoped, so only the projects source is declared.
+    assert [s.source_id for s in declaration.sources] == ["projects"]

plane_agent-2.3.5/tests/test_ontology_parent_link.py

@@ -0,0 +1,110 @@
+"""Every class of the packaged ontology reaches an epistemic-graph parent class (CONN-PLANE-AGENT-CONNECTOR-CONTENT-R002)."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R002")
+
+PARENT_IRI = "http://knuckles.team/kg"
+ONTOLOGIES = sorted(
+    (Path(__file__).resolve().parents[1] / "plane_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#Module",
+        "http://knuckles.team/kg#Person",
+        "http://knuckles.team/kg#SoftwareProject",
+        "http://knuckles.team/kg#Tag",
+        "http://knuckles.team/kg#WorkItem",
+    )
+)
+# 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#Cycle",
+        "http://knuckles.team/kg#ProjectState",
+        "http://knuckles.team/kg#Workspace",
+    )
+)
+
+_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