plane-agent 2.3.4__tar.gz → 2.3.6__tar.gz

{plane_agent-2.3.4/plane_agent.egg-info → plane_agent-2.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plane-agent
-Version: 2.3.4
+Version: 2.3.6
 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.4*
+*Version: 2.3.6*
 
 > **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.4 → plane_agent-2.3.6}/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.4*
+*Version: 2.3.6*
 
 > **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.6/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.4 → plane_agent-2.3.6}/plane_agent/ontology/plane.ttl

@@ -13,6 +13,7 @@
 # plane_modules / plane_states / …). The shared :Person class is REUSED, never redefined.
 
 :Workspace a owl:Class ;
+    rdfs:subClassOf :Namespace ;
     rdfs:label "Workspace" ;
     rdfs:comment "A Plane workspace — the top-level tenant that owns projects and members (plane_workspaces)." .
 
@@ -26,14 +27,17 @@
     rdfs:comment "A Plane work item / issue — the unit of tracked work with a state, priority and assignees (plane_work_items)." .
 
 :Cycle a owl:Class ;
+    rdfs:subClassOf :Iteration ;
     rdfs:label "Cycle" ;
     rdfs:comment "A time-boxed cycle (sprint) grouping work items over a start/end window (plane_cycles)." .
 
-:Module a owl:Class ;
+:PlaneModule a owl:Class ;
+    rdfs:subClassOf :Collection ;
     rdfs:label "Module" ;
     rdfs:comment "A feature grouping of work items within a project (plane_modules)." .
 
 :ProjectState a owl:Class ;
+    rdfs:subClassOf :Concept ;
     rdfs:label "Project State" ;
     rdfs:comment "A workflow state a work item can occupy (e.g. Backlog, Todo, In Progress, Done) within a project (plane_states)." .
 
@@ -65,7 +69,7 @@
     rdfs:label "in module" ;
     rdfs:comment "Links an Issue to the Module it is grouped under." ;
     rdfs:domain :Issue ;
-    rdfs:range :Module .
+    rdfs:range :PlaneModule .
 
 :hasState a owl:ObjectProperty ;
     rdfs:label "has state" ;
@@ -93,6 +97,12 @@
     rdfs:domain :Issue ;
     rdfs:range xsd:integer .
 
+:state a owl:DatatypeProperty ;
+    rdfs:label "state" ;
+    rdfs:comment "Workflow state name of a work item (Backlog, Todo, In Progress, Done, Cancelled)." ;
+    rdfs:domain :Issue ;
+    rdfs:range xsd:string .
+
 :priority a owl:DatatypeProperty ;
     rdfs:label "priority" ;
     rdfs:comment "Priority of a work item (urgent, high, medium, low, none)." ;

{plane_agent-2.3.4 → plane_agent-2.3.6}/plane_agent/ontology/shapes/connector.shacl.ttl

@@ -63,8 +63,8 @@ shape:LabelGovernanceShape a sh:NodeShape ;
         sh:minCount 1 ; sh:maxCount 1 ; sh:datatype xsd:string
     ] .
 
-shape:ModuleGovernanceShape a sh:NodeShape ;
-    sh:targetClass :Module ;
+shape:PlaneModuleGovernanceShape a sh:NodeShape ;
+    sh:targetClass :PlaneModule ;
     sh:closed false ;
     sh:property [
         sh:path :sourceRecordRef ;

{plane_agent-2.3.4 → plane_agent-2.3.6/plane_agent.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plane-agent
-Version: 2.3.4
+Version: 2.3.6
 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.4*
+*Version: 2.3.6*
 
 > **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.4 → plane_agent-2.3.6}/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
@@ -62,7 +63,9 @@ scripts/verify_api_integration.py
 tests/conftest.py
 tests/test_action_discovery.py
 tests/test_coverage_gap_fillers.py
+tests/test_cq_paths.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

{plane_agent-2.3.4 → plane_agent-2.3.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "plane-agent"
-version = "2.3.4"
+version = "2.3.6"
 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.6/tests/test_cq_paths.py

@@ -0,0 +1,53 @@
+"""Competency-question paths of the Plane pack (CONN-PLANE-AGENT-CONNECTOR-CONTENT-R004)."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import pytest
+import yaml
+
+import plane_agent
+
+pytestmark = pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R004")
+
+PACKAGE = Path(plane_agent.__file__).parent
+TTL = (PACKAGE / "ontology" / "plane.ttl").read_text("utf-8")
+
+
+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)
+
+
+def test_issue_carries_state_and_priority() -> None:
+    for prop in ("state", "priority"):
+        assert "rdfs:domain :Issue" in _block(prop), prop
+
+
+@pytest.mark.parametrize(
+    ("name", "parent"),
+    (
+        ("Workspace", "Namespace"),
+        ("Cycle", "Iteration"),
+        ("PlaneModule", "Collection"),
+        ("ProjectState", "Concept"),
+    ),
+)
+def test_classes_extend_a_shared_parent(name: str, parent: str) -> None:
+    assert f"rdfs:subClassOf :{parent}" in _block(name)
+
+
+
+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 == []

plane_agent-2.3.6/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.4 → plane_agent-2.3.6}/tests/test_ontology_parent_link.py

@@ -19,6 +19,10 @@ 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#Namespace",
+        "http://knuckles.team/kg#Iteration",
+        "http://knuckles.team/kg#Collection",
+        "http://knuckles.team/kg#Concept",
         "http://knuckles.team/kg#Module",
         "http://knuckles.team/kg#Person",
         "http://knuckles.team/kg#SoftwareProject",
@@ -28,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#Cycle",
-        "http://knuckles.team/kg#ProjectState",
-        "http://knuckles.team/kg#Workspace",
-    )
-)
+PENDING_NEW_PARENT: frozenset[str] = frozenset()
 
 _STRING = re.compile(r'"""(?:.|\n)*?"""|"(?:[^"\\\n]|\\.)*"')
 _IRI = re.compile(r"<([^<>\s]*)>")