plane-agent 2.3.9__tar.gz → 2.3.11__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. {plane_agent-2.3.9/plane_agent.egg-info → plane_agent-2.3.11}/PKG-INFO +3 -9
  2. {plane_agent-2.3.9 → plane_agent-2.3.11}/README.md +0 -2
  3. plane_agent-2.3.11/plane_agent/__init__.py +11 -0
  4. plane_agent-2.3.11/plane_agent/__main__.py +4 -0
  5. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/connector_sources.py +20 -78
  6. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/kg_ingest.py +4 -3
  7. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/mcp_server.py +1 -62
  8. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/certification.json +6 -6
  9. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/mappings/source.yaml +1 -1
  10. {plane_agent-2.3.9 → plane_agent-2.3.11/plane_agent.egg-info}/PKG-INFO +3 -9
  11. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent.egg-info/SOURCES.txt +0 -8
  12. plane_agent-2.3.11/plane_agent.egg-info/entry_points.txt +8 -0
  13. plane_agent-2.3.11/plane_agent.egg-info/requires.txt +8 -0
  14. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent.egg-info/top_level.txt +0 -1
  15. {plane_agent-2.3.9 → plane_agent-2.3.11}/pyproject.toml +14 -17
  16. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_coverage_gap_fillers.py +7 -54
  17. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_cq_paths.py +2 -2
  18. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_ingest_sources.py +4 -4
  19. plane_agent-2.3.11/tests/test_init.py +15 -0
  20. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_kg_ingest.py +9 -0
  21. plane_agent-2.3.9/MANIFEST.in +0 -1
  22. plane_agent-2.3.9/plane_agent/__init__.py +0 -1
  23. plane_agent-2.3.9/plane_agent/__main__.py +0 -4
  24. plane_agent-2.3.9/plane_agent/connectors/__init__.py +0 -0
  25. plane_agent-2.3.9/plane_agent/prompts/__init__.py +0 -0
  26. plane_agent-2.3.9/plane_agent/skills/__init__.py +0 -0
  27. plane_agent-2.3.9/plane_agent.egg-info/entry_points.txt +0 -17
  28. plane_agent-2.3.9/plane_agent.egg-info/requires.txt +0 -14
  29. plane_agent-2.3.9/requirements.txt +0 -1
  30. plane_agent-2.3.9/scripts/security_sanitizer.py +0 -318
  31. plane_agent-2.3.9/scripts/verify_api_integration.py +0 -279
  32. plane_agent-2.3.9/tests/test_default_content_surfaces.py +0 -43
  33. plane_agent-2.3.9/tests/test_init.py +0 -26
  34. {plane_agent-2.3.9 → plane_agent-2.3.11}/LICENSE +0 -0
  35. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/__init__.py +0 -0
  36. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_base.py +0 -0
  37. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_cycles.py +0 -0
  38. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_epics.py +0 -0
  39. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_initiatives.py +0 -0
  40. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_intake.py +0 -0
  41. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_milestones.py +0 -0
  42. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_modules_states.py +0 -0
  43. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_projects.py +0 -0
  44. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_work_items.py +0 -0
  45. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_workspace.py +0 -0
  46. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api_client.py +0 -0
  47. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/auth.py +0 -0
  48. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/mcp_config.json +0 -0
  49. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/__init__.py +0 -0
  50. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/fixtures/records.json +0 -0
  51. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/migrations/manifest.json +0 -0
  52. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/plane.ttl +0 -0
  53. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/shapes/connector.shacl.ttl +0 -0
  54. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/plane_models.py +0 -0
  55. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/prompts/project_tracking_specialist.json +0 -0
  56. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-agent-operations/SKILL.md +0 -0
  57. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-agent-operations/agents/openai.yaml +0 -0
  58. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-agent-operations/references/catalog.md +0 -0
  59. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-create-work-item-guided/SKILL.md +0 -0
  60. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-create-work-item-guided/WORKFLOW.md +0 -0
  61. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-create-work-item-guided/references/property-discovery.md +0 -0
  62. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-cycle-planning/SKILL.md +0 -0
  63. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-cycle-planning/WORKFLOW.md +0 -0
  64. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-kg-ingestion/SKILL.md +0 -0
  65. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-kg-ingestion/WORKFLOW.md +0 -0
  66. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-my-priority-queue/SKILL.md +0 -0
  67. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-my-priority-queue/WORKFLOW.md +0 -0
  68. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-my-priority-queue/references/filter-recipes.md +0 -0
  69. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-my-priority-queue/scripts/rank_items.py +0 -0
  70. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-work-item-tracking/SKILL.md +0 -0
  71. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-work-item-tracking/WORKFLOW.md +0 -0
  72. {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent.egg-info/dependency_links.txt +0 -0
  73. {plane_agent-2.3.9 → plane_agent-2.3.11}/setup.cfg +0 -0
  74. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/conftest.py +0 -0
  75. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_action_discovery.py +0 -0
  76. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_init_dynamics.py +0 -0
  77. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_ontology_parent_link.py +0 -0
  78. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_rank_items.py +0 -0
  79. {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_startup.py +0 -0
@@ -1,8 +1,8 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: plane-agent
3
- Version: 2.3.9
3
+ Version: 2.3.11
4
4
  Summary: Plane MCP Agent
5
- Author-email: Project Maintainers <maintainers@users.noreply.github.com>
5
+ Author-email: Repository Maintainers <maintainers@knuckles.team>
6
6
  License: MIT
7
7
  Classifier: Development Status :: 4 - Beta
8
8
  Classifier: License :: OSI Approved :: MIT License
@@ -12,12 +12,8 @@ Classifier: Programming Language :: Python :: 3
12
12
  Requires-Python: <3.15,>=3.12
13
13
  Description-Content-Type: text/markdown
14
14
  License-File: LICENSE
15
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3
15
+ Requires-Dist: agent-connector-sdk[mcp]<0.6.0,>=0.5.2
16
16
  Requires-Dist: requests>=2.34.2
17
- Provides-Extra: mcp
18
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "mcp"
19
- Provides-Extra: all
20
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "all"
21
17
  Provides-Extra: test
22
18
  Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
23
19
  Requires-Dist: pytest>=9.1.1; extra == "test"
@@ -47,8 +43,6 @@ Dynamic: license-file
47
43
  ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
48
44
  ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
49
45
 
50
- *Version: 2.3.9*
51
-
52
46
  > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
53
47
  > interfaces, and guidance for provisioning a self-hosted Plane instance are
54
48
  > maintained in the [official documentation](https://knuckles-team.github.io/plane-agent/).
@@ -20,8 +20,6 @@
20
20
  ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
21
21
  ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
22
22
 
23
- *Version: 2.3.9*
24
-
25
23
  > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
26
24
  > interfaces, and guidance for provisioning a self-hosted Plane instance are
27
25
  > maintained in the [official documentation](https://knuckles-team.github.io/plane-agent/).
@@ -0,0 +1,11 @@
1
+ from agent_connector_sdk.connector import Connector
2
+
3
+ from plane_agent.api_client import Api
4
+ from plane_agent.auth import get_client
5
+
6
+ connector = Connector(
7
+ api=Api,
8
+ get_client=get_client,
9
+ tools="plane_agent.mcp_server",
10
+ instructions="plane-agent MCP Server — Condensed Action-Routed Tools.",
11
+ )
@@ -0,0 +1,4 @@
1
+ from agent_connector_sdk import run
2
+
3
+ if __name__ == "__main__":
4
+ run()
@@ -7,9 +7,6 @@ Served live as ``connector://resources``. Regenerate by editing the declarations
7
7
  from __future__ import annotations
8
8
 
9
9
  from agent_connector_sdk.ingest.live_declaration import source_meta
10
- from agent_connector_sdk.ingest.sources import IngestSourceDeclaration, IngestSourceSpec
11
-
12
- CONNECTOR = "plane-mcp"
13
10
 
14
11
  SOURCES = (
15
12
  source_meta(
@@ -63,82 +60,46 @@ SOURCES = (
63
60
  ),
64
61
  )
65
62
 
63
+ SCHEMA_VERSION = 2
64
+
65
+ FIELD_SETS = {
66
+ "fields_1": {
67
+ "endDate": "xsd:string",
68
+ "identifier": "xsd:string",
69
+ "priority": "xsd:string",
70
+ "sequenceId": "xsd:integer",
71
+ "startDate": "xsd:string",
72
+ "state": "xsd:string",
73
+ },
74
+ }
75
+
66
76
  SCHEMA_MAPPINGS = {
67
77
  "Cycle": {
68
- "fields": {
69
- "endDate": "xsd:string",
70
- "identifier": "xsd:string",
71
- "priority": "xsd:string",
72
- "sequenceId": "xsd:integer",
73
- "startDate": "xsd:string",
74
- "state": "xsd:string",
75
- },
78
+ "field_sets": ["fields_1"],
76
79
  "ontology_class": "Iteration",
77
80
  },
78
81
  "Issue": {
79
- "fields": {
80
- "endDate": "xsd:string",
81
- "identifier": "xsd:string",
82
- "priority": "xsd:string",
83
- "sequenceId": "xsd:integer",
84
- "startDate": "xsd:string",
85
- "state": "xsd:string",
86
- },
82
+ "field_sets": ["fields_1"],
87
83
  "ontology_class": "WorkItem",
88
84
  },
89
85
  "Label": {
90
- "fields": {
91
- "endDate": "xsd:string",
92
- "identifier": "xsd:string",
93
- "priority": "xsd:string",
94
- "sequenceId": "xsd:integer",
95
- "startDate": "xsd:string",
96
- "state": "xsd:string",
97
- },
86
+ "field_sets": ["fields_1"],
98
87
  "ontology_class": "Tag",
99
88
  },
100
89
  "PlaneModule": {
101
- "fields": {
102
- "endDate": "xsd:string",
103
- "identifier": "xsd:string",
104
- "priority": "xsd:string",
105
- "sequenceId": "xsd:integer",
106
- "startDate": "xsd:string",
107
- "state": "xsd:string",
108
- },
90
+ "field_sets": ["fields_1"],
109
91
  "ontology_class": "Collection",
110
92
  },
111
93
  "ProjectState": {
112
- "fields": {
113
- "endDate": "xsd:string",
114
- "identifier": "xsd:string",
115
- "priority": "xsd:string",
116
- "sequenceId": "xsd:integer",
117
- "startDate": "xsd:string",
118
- "state": "xsd:string",
119
- },
94
+ "field_sets": ["fields_1"],
120
95
  "ontology_class": "Concept",
121
96
  },
122
97
  "SoftwareProject": {
123
- "fields": {
124
- "endDate": "xsd:string",
125
- "identifier": "xsd:string",
126
- "priority": "xsd:string",
127
- "sequenceId": "xsd:integer",
128
- "startDate": "xsd:string",
129
- "state": "xsd:string",
130
- },
98
+ "field_sets": ["fields_1"],
131
99
  "ontology_class": "SoftwareProject",
132
100
  },
133
101
  "Workspace": {
134
- "fields": {
135
- "endDate": "xsd:string",
136
- "identifier": "xsd:string",
137
- "priority": "xsd:string",
138
- "sequenceId": "xsd:integer",
139
- "startDate": "xsd:string",
140
- "state": "xsd:string",
141
- },
102
+ "field_sets": ["fields_1"],
142
103
  "ontology_class": "Namespace",
143
104
  },
144
105
  }
@@ -180,22 +141,3 @@ RESOURCES = (
180
141
  "name": "Workspace",
181
142
  },
182
143
  )
183
-
184
-
185
- def declaration() -> IngestSourceDeclaration:
186
- """The declaration the server assembles from this module."""
187
- specs = []
188
- for item in SOURCES:
189
- for entry in item["connector_sources"]:
190
- body = {k: v for k, v in entry.items() if k not in ("tool", "mapping")}
191
- specs.append(
192
- IngestSourceSpec.model_validate({**body, "tools": (entry["tool"],)})
193
- )
194
- return IngestSourceDeclaration.model_validate(
195
- {
196
- "connector": CONNECTOR,
197
- "sources": specs,
198
- "schema_mappings": SCHEMA_MAPPINGS,
199
- "resources": RESOURCES,
200
- }
201
- )
@@ -11,6 +11,7 @@ from __future__ import annotations
11
11
  import logging
12
12
  from typing import Any
13
13
 
14
+ from agent_connector_sdk.connector_identity import connector_name
14
15
  from agent_connector_sdk.ingest import (
15
16
  ChangeSet,
16
17
  Entity,
@@ -23,15 +24,15 @@ from agent_connector_sdk.ingest import (
23
24
 
24
25
  logger = logging.getLogger("plane_agent.kg")
25
26
 
26
- _SOURCE = "plane-agent"
27
+ _SOURCE = connector_name("plane_agent")
27
28
  _DOMAIN = "plane"
28
29
  _BINDING = IngestBinding(connector=_SOURCE, stream=_DOMAIN)
29
30
 
30
31
 
31
32
  def _to_entity(record: dict[str, Any]) -> Entity:
32
33
  return Entity(
33
- id=record.get("id"),
34
- node_type=record.get("node_type"),
34
+ id=record.get("id") or "",
35
+ node_type=record.get("node_type") or "",
35
36
  properties={k: v for k, v in record.items() if k not in ("id", "node_type")},
36
37
  )
37
38
 
@@ -20,22 +20,14 @@ warnings.filterwarnings("ignore", message=".*urllib3.*or chardet.*")
20
20
  warnings.filterwarnings("ignore", message=".*urllib3.*or charset_normalizer.*")
21
21
 
22
22
  import logging
23
- import sys
24
23
  from typing import Any
25
24
 
26
- from agent_connector_sdk.config import load_config, setting
25
+ from agent_connector_sdk.config import setting
27
26
  from agent_connector_sdk.mcp.action_dispatch import resolve_action
28
27
  from agent_connector_sdk.mcp.concurrency import run_blocking
29
- from agent_connector_sdk.mcp.server import create_mcp_server
30
- from agent_connector_sdk.mcp.tool_surface import register_tool_surface
31
- from starlette.requests import Request
32
- from starlette.responses import JSONResponse
33
28
 
34
- from plane_agent.api_client import Api
35
29
  from plane_agent.auth import get_client
36
30
 
37
- __version__ = "0.1.37"
38
-
39
31
  logger = get_logger(name="plane-agent")
40
32
  logger.setLevel(logging.INFO)
41
33
 
@@ -800,56 +792,3 @@ def register_kg_tools(mcp: FastMCP):
800
792
  return {"listed": len(records), "ingested": ingested}
801
793
 
802
794
  return None
803
-
804
-
805
- def get_mcp_instance() -> tuple[Any, ...]:
806
- """Initialize and return the MCP instance.
807
-
808
- Ecosystem Concepts:
809
- (MCP & Universal Skills)
810
- (Guardrail Engine)
811
- """
812
- load_config()
813
- args, mcp, middlewares = create_mcp_server(
814
- name="plane-agent MCP",
815
- version=__version__,
816
- instructions="plane-agent MCP Server — Condensed Action-Routed Tools.",
817
- )
818
-
819
- @mcp.custom_route("/health", methods=["GET"])
820
- async def health_check(request: Request) -> JSONResponse:
821
- return JSONResponse({"status": "OK"})
822
-
823
- register_tool_surface(
824
- mcp,
825
- client_cls=Api,
826
- get_client=get_client,
827
- service="plane-agent",
828
- tools_module=sys.modules[__name__],
829
- )
830
-
831
- for mw in middlewares:
832
- mcp.add_middleware(mw)
833
- return mcp, args, middlewares
834
-
835
-
836
- def mcp_server() -> None:
837
- mcp, args, middlewares = get_mcp_instance()
838
- print(f"plane-agent MCP v{__version__}", file=sys.stderr)
839
- print("\nStarting MCP Server", file=sys.stderr)
840
- print(f" Transport: {args.transport.upper()}", file=sys.stderr)
841
- print(f" Auth: {args.auth_type}", file=sys.stderr)
842
-
843
- if args.transport == "stdio":
844
- mcp.run(transport="stdio")
845
- elif args.transport == "streamable-http":
846
- mcp.run(transport="streamable-http", host=args.host, port=args.port)
847
- elif args.transport == "sse":
848
- mcp.run(transport="sse", host=args.host, port=args.port)
849
- else:
850
- logger.error("Invalid transport", extra={"transport": args.transport})
851
- sys.exit(1)
852
-
853
-
854
- if __name__ == "__main__":
855
- mcp_server()
@@ -1,11 +1,11 @@
1
1
  {
2
- "api_version": "arbora.io/v1",
2
+ "api_version": "graphos.io/v1",
3
3
  "artifacts": {
4
4
  "plane_agent/ontology/fixtures/records.json": "ad212a2725e246aceb1d2ecdf95db690f31b231888f6789f0c8867f0b70ab6e4",
5
- "plane_agent/ontology/mappings/source.yaml": "12d00c04472c85433a0f744bb2f0ca144445b8222ca06f920df292b4ec961f26",
5
+ "plane_agent/ontology/mappings/source.yaml": "dc24762ec60986e3ff2bc0ec29ce585343abebaf9c9548a7d7659c66cef04151",
6
6
  "plane_agent/ontology/migrations/manifest.json": "61b3a180e8fbc6862e59844dffe069ee13c592a4e635b259f6a39b174d30e5aa",
7
- "plane_agent/ontology/plane.ttl": "50ad32251203116b9872bbbf743910e281fd8df761c6b40ad90769b6cc114434",
8
- "plane_agent/ontology/shapes/connector.shacl.ttl": "d86d03b665fc013ec8ce34058175eb038331c5dbd524ea2f1b4f588b647424e5"
7
+ "plane_agent/ontology/plane.ttl": "35829508da04668ba127a880526d808fa6d4be676660bb77df1f7f1acb3f48b4",
8
+ "plane_agent/ontology/shapes/connector.shacl.ttl": "d94b9d57b38df1bacd019d8dd0449419d58e045b7f791de2788a8031bf7a35e8"
9
9
  },
10
10
  "checks": {
11
11
  "declared_tool_schema": "passed",
@@ -15,7 +15,7 @@
15
15
  "synthetic_fixture_contract": "passed"
16
16
  },
17
17
  "compatibility": {
18
- "agent_connector_sdk": ">=2.5.0,<3",
18
+ "agent_utilities": ">=2.5.0,<3",
19
19
  "bundle_schema": "2",
20
20
  "epistemic_graph": ">=2.27.0,<3"
21
21
  },
@@ -29,5 +29,5 @@
29
29
  "signer": "UNSIGNED-PREVIEW",
30
30
  "signing_public_key": "",
31
31
  "status": "source-validated",
32
- "validated_at": "2026-08-26T13:42:55Z"
32
+ "validated_at": "2026-10-24T06:19:45Z"
33
33
  }
@@ -1,5 +1,5 @@
1
1
  schema_version: '1'
2
- connector: plane-agent
2
+ connector: plane-mcp
3
3
  ontology_source: plane
4
4
  sync:
5
5
  - preset: plane-projects
@@ -1,8 +1,8 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: plane-agent
3
- Version: 2.3.9
3
+ Version: 2.3.11
4
4
  Summary: Plane MCP Agent
5
- Author-email: Project Maintainers <maintainers@users.noreply.github.com>
5
+ Author-email: Repository Maintainers <maintainers@knuckles.team>
6
6
  License: MIT
7
7
  Classifier: Development Status :: 4 - Beta
8
8
  Classifier: License :: OSI Approved :: MIT License
@@ -12,12 +12,8 @@ Classifier: Programming Language :: Python :: 3
12
12
  Requires-Python: <3.15,>=3.12
13
13
  Description-Content-Type: text/markdown
14
14
  License-File: LICENSE
15
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3
15
+ Requires-Dist: agent-connector-sdk[mcp]<0.6.0,>=0.5.2
16
16
  Requires-Dist: requests>=2.34.2
17
- Provides-Extra: mcp
18
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "mcp"
19
- Provides-Extra: all
20
- Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "all"
21
17
  Provides-Extra: test
22
18
  Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
23
19
  Requires-Dist: pytest>=9.1.1; extra == "test"
@@ -47,8 +43,6 @@ Dynamic: license-file
47
43
  ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
48
44
  ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
49
45
 
50
- *Version: 2.3.9*
51
-
52
46
  > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
53
47
  > interfaces, and guidance for provisioning a self-hosted Plane instance are
54
48
  > maintained in the [official documentation](https://knuckles-team.github.io/plane-agent/).
@@ -1,8 +1,6 @@
1
1
  LICENSE
2
- MANIFEST.in
3
2
  README.md
4
3
  pyproject.toml
5
- requirements.txt
6
4
  plane_agent/__init__.py
7
5
  plane_agent/__main__.py
8
6
  plane_agent/api_client.py
@@ -29,7 +27,6 @@ plane_agent/api/api_client_modules_states.py
29
27
  plane_agent/api/api_client_projects.py
30
28
  plane_agent/api/api_client_work_items.py
31
29
  plane_agent/api/api_client_workspace.py
32
- plane_agent/connectors/__init__.py
33
30
  plane_agent/ontology/__init__.py
34
31
  plane_agent/ontology/certification.json
35
32
  plane_agent/ontology/plane.ttl
@@ -37,9 +34,7 @@ plane_agent/ontology/fixtures/records.json
37
34
  plane_agent/ontology/mappings/source.yaml
38
35
  plane_agent/ontology/migrations/manifest.json
39
36
  plane_agent/ontology/shapes/connector.shacl.ttl
40
- plane_agent/prompts/__init__.py
41
37
  plane_agent/prompts/project_tracking_specialist.json
42
- plane_agent/skills/__init__.py
43
38
  plane_agent/skills/plane-agent-operations/SKILL.md
44
39
  plane_agent/skills/plane-agent-operations/agents/openai.yaml
45
40
  plane_agent/skills/plane-agent-operations/references/catalog.md
@@ -56,13 +51,10 @@ plane_agent/skills/plane-my-priority-queue/references/filter-recipes.md
56
51
  plane_agent/skills/plane-my-priority-queue/scripts/rank_items.py
57
52
  plane_agent/skills/plane-work-item-tracking/SKILL.md
58
53
  plane_agent/skills/plane-work-item-tracking/WORKFLOW.md
59
- scripts/security_sanitizer.py
60
- scripts/verify_api_integration.py
61
54
  tests/conftest.py
62
55
  tests/test_action_discovery.py
63
56
  tests/test_coverage_gap_fillers.py
64
57
  tests/test_cq_paths.py
65
- tests/test_default_content_surfaces.py
66
58
  tests/test_ingest_sources.py
67
59
  tests/test_init.py
68
60
  tests/test_init_dynamics.py
@@ -0,0 +1,8 @@
1
+ [agent_connector_sdk.connector]
2
+ plane-mcp = plane_agent:connector
3
+
4
+ [agent_connector_sdk.prompt_providers]
5
+ plane-agent = plane_agent.prompts
6
+
7
+ [console_scripts]
8
+ plane-mcp = agent_connector_sdk.cli:serve
@@ -0,0 +1,8 @@
1
+ agent-connector-sdk[mcp]<0.6.0,>=0.5.2
2
+ requests>=2.34.2
3
+
4
+ [test]
5
+ pytest-xdist>=3.8.0
6
+ pytest>=9.1.1
7
+ pytest-asyncio>=1.4.0
8
+ pytest-cov>=7.1.0
@@ -4,6 +4,5 @@ dist-sdist
4
4
  docker
5
5
  docs
6
6
  plane_agent
7
- scripts
8
7
  specs
9
8
  tests
@@ -4,43 +4,32 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "plane-agent"
7
- version = "2.3.9"
7
+ version = "2.3.11"
8
8
  description = "Plane MCP Agent"
9
9
  readme = "README.md"
10
10
  classifiers = [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
11
11
  requires-python = ">=3.12, <3.15"
12
- dependencies = [ "agent-connector-sdk[mcp]>=0.4.3,<1.0.0", "requests>=2.34.2",]
12
+ dependencies = [ "agent-connector-sdk[mcp]>=0.5.2,<0.6.0", "requests>=2.34.2",]
13
13
  [[project.authors]]
14
- name = "Project Maintainers"
15
- email = "maintainers@users.noreply.github.com"
14
+ name = "Repository Maintainers"
15
+ email = "maintainers@knuckles.team"
16
16
 
17
17
  [project.license]
18
18
  text = "MIT"
19
19
 
20
20
  [project.scripts]
21
- plane-mcp = "plane_agent.mcp_server:mcp_server"
21
+ plane-mcp = "agent_connector_sdk.cli:serve"
22
22
 
23
23
  [project.optional-dependencies]
24
- mcp = [ "agent-connector-sdk[mcp]>=0.4.3,<1.0.0",]
25
- all = [ "agent-connector-sdk[mcp]>=0.4.3,<1.0.0",]
26
24
  test = [
27
25
  "pytest-xdist>=3.8.0", "pytest>=9.1.1", "pytest-asyncio>=1.4.0", "pytest-cov>=7.1.0",]
28
26
 
29
- [project.entry-points."agent_connector_sdk.skill_providers"]
30
- plane-agent = "plane_agent.skills"
31
-
32
- [project.entry-points."agent_connector_sdk.ontology_providers"]
33
- plane-agent = "plane_agent.ontology"
34
-
35
- [project.entry-points."agent_connector_sdk.source_connector_providers"]
36
- plane-agent = "plane_agent.connectors"
37
-
38
27
  [project.entry-points."agent_connector_sdk.prompt_providers"]
39
28
  plane-agent = "plane_agent.prompts"
40
29
 
41
30
  # The one declared connector identity: the fleet name (SDK-CONNECTOR-CONTROL-R071).
42
31
  [project.entry-points."agent_connector_sdk.connector"]
43
- plane-mcp = "plane_agent"
32
+ plane-mcp = "plane_agent:connector"
44
33
 
45
34
  [tool.uv.workspace]
46
35
  members = ["."]
@@ -55,6 +44,7 @@ override-dependencies = [
55
44
 
56
45
 
57
46
  [tool.ruff]
47
+ extend-exclude = ["tests", "scripts"]
58
48
  line-length = 88
59
49
  target-version = "py312"
60
50
 
@@ -83,3 +73,10 @@ ignore_names = ["request", "config"]
83
73
 
84
74
  [tool.pipelines_hooks.ste]
85
75
  exempt = ["specs/*", "specs/**/*"]
76
+
77
+ [tool.pipelines.container]
78
+ debug_apt = ["default-jre", "ripgrep", "tree", "fd-find", "curl", "nano", "build-essential", "cmake", "libssl-dev", "libcurl4-openssl-dev", "pkg-config", "cargo", "rustc"]
79
+ limits = {"mcp" = {"memory_limit_env" = "AGENT_CONTAINER_MEMORY_LIMIT", "memory_limit" = "4g", "cpu_limit_env" = "AGENT_CONTAINER_CPU_LIMIT", "cpu_limit" = "2.0"}}
80
+
81
+ [tool.pipelines.api_integration]
82
+ baseline = 54.9
@@ -11,7 +11,7 @@ sys.argv = ["mcp_server.py"]
11
11
  import asyncio
12
12
  import inspect
13
13
  from typing import Any
14
- from unittest.mock import MagicMock, patch
14
+ from unittest.mock import patch
15
15
 
16
16
  import pytest
17
17
  from agent_connector_sdk.exceptions import AuthError
@@ -101,9 +101,9 @@ def get_all_mcp_tool_names():
101
101
  """Every tool the MCP server registers (one per API operation)."""
102
102
  import asyncio
103
103
 
104
- from plane_agent.mcp_server import get_mcp_instance
104
+ from agent_connector_sdk.connector import build_server
105
105
 
106
- mcp, _, _ = get_mcp_instance()
106
+ _, mcp = build_server("plane_agent", command_args=[])
107
107
  return sorted(tool.name for tool in asyncio.run(mcp.list_tools()))
108
108
 
109
109
 
@@ -114,9 +114,9 @@ async def test_all_mcp_tools(tool_name):
114
114
 
115
115
  CONCEPT:AU-ECO.mcp.fastmcp-middleware
116
116
  """
117
- from plane_agent.mcp_server import get_mcp_instance
117
+ from agent_connector_sdk.connector import build_server
118
118
 
119
- mcp, _, _ = get_mcp_instance()
119
+ _, mcp = build_server("plane_agent", command_args=[])
120
120
  tool = next(t for t in await mcp.list_tools() if t.name == tool_name)
121
121
  properties = tool.parameters.get("properties", {})
122
122
  assert "action" not in properties
@@ -125,53 +125,6 @@ async def test_all_mcp_tools(tool_name):
125
125
  assert tool.annotations.read_only_hint is not None
126
126
 
127
127
 
128
- @pytest.mark.concept("AU-ECO.mcp.fastmcp-middleware")
129
- def test_mcp_server_run_options():
130
- """Test MCP server run options.
131
-
132
- CONCEPT:AU-ECO.mcp.fastmcp-middleware
133
- """
134
- from plane_agent.mcp_server import mcp_server
135
-
136
- mock_mcp = MagicMock()
137
- mock_args = MagicMock()
138
-
139
- with patch(
140
- "plane_agent.mcp_server.get_mcp_instance",
141
- return_value=(mock_mcp, mock_args, []),
142
- ):
143
- # Stdio Transport
144
- mock_args.transport = "stdio"
145
- mcp_server()
146
- mock_mcp.run.assert_called_with(transport="stdio")
147
-
148
- # SSE Transport
149
- mock_args.transport = "sse"
150
- mock_args.host = "127.0.0.1"
151
- mock_args.port = 8000
152
- mcp_server()
153
- mock_mcp.run.assert_called_with(transport="sse", host="127.0.0.1", port=8000)
154
-
155
- # Streamable HTTP Transport
156
- mock_args.transport = "streamable-http"
157
- mock_args.host = "127.0.0.1"
158
- mock_args.port = 8000
159
- mcp_server()
160
- mock_mcp.run.assert_called_with(
161
- transport="streamable-http", host="127.0.0.1", port=8000
162
- )
163
-
164
- # Invalid Transport
165
- mock_args.transport = "invalid"
166
- with patch("sys.exit") as mock_exit:
167
- mcp_server()
168
- mock_exit.assert_called_with(1)
169
-
170
-
171
-
172
-
173
-
174
-
175
128
  @pytest.mark.concept("AU-ECO.mcp.fastmcp-middleware")
176
129
  def test_requests_dependency_warning_fallback():
177
130
  """Test requests dependency warning fallback path.
@@ -206,9 +159,9 @@ def test_sse_healthcheck():
206
159
  """
207
160
 
208
161
  async def run_test():
209
- from plane_agent.mcp_server import get_mcp_instance
162
+ from agent_connector_sdk.connector import build_server
210
163
 
211
- mcp, _, _ = get_mcp_instance()
164
+ _, mcp = build_server("plane_agent", command_args=[])
212
165
 
213
166
  # Introspect Starlette routes
214
167
  routes = []
@@ -2,7 +2,7 @@
2
2
 
3
3
  from __future__ import annotations
4
4
 
5
- from plane_agent.connector_sources import declaration as declared_sources
5
+ from agent_connector_sdk.ingest import load_declaration
6
6
  import re
7
7
  from pathlib import Path
8
8
 
@@ -44,7 +44,7 @@ def test_classes_extend_a_shared_parent(name: str, parent: str) -> None:
44
44
  def test_no_mapping_has_a_null_ontology_class() -> None:
45
45
  unmapped = [
46
46
  name
47
- for name, mapping in declared_sources().schema_mappings.items()
47
+ for name, mapping in load_declaration("plane_agent").schema_mappings.items()
48
48
  if not mapping.ontology_class
49
49
  ]
50
50
  assert unmapped == []
@@ -5,7 +5,7 @@ from __future__ import annotations
5
5
  from pathlib import Path
6
6
 
7
7
  import pytest
8
- from plane_agent.connector_sources import declaration as declared_sources
8
+ from agent_connector_sdk.ingest import load_declaration
9
9
  from agent_connector_sdk.mcp.tool_surface import operation_prefix
10
10
 
11
11
 
@@ -14,7 +14,7 @@ REPO_ROOT = Path(__file__).resolve().parent.parent
14
14
 
15
15
  @pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
16
16
  def test_declares_ingestible_sources() -> None:
17
- declaration = declared_sources()
17
+ declaration = load_declaration("plane_agent")
18
18
  assert declaration is not None
19
19
  assert declaration.connector == "plane-mcp"
20
20
  prefix = operation_prefix("plane-agent")
@@ -34,7 +34,7 @@ def test_declares_ingestible_sources() -> None:
34
34
 
35
35
  @pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
36
36
  def test_work_items_fan_out_per_project_and_map_to_issue_state() -> None:
37
- declaration = declared_sources()
37
+ declaration = load_declaration("plane_agent")
38
38
  for source_id in ("work-items", "project-states"):
39
39
  source = declaration.source(source_id)
40
40
  assert source is not None and source.for_each is not None
@@ -57,7 +57,7 @@ def test_work_items_fan_out_per_project_and_map_to_issue_state() -> None:
57
57
  @pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
58
58
  def test_sources_name_read_only_tools() -> None:
59
59
  source_text = (REPO_ROOT / "plane_agent" / "mcp_server.py").read_text()
60
- declaration = declared_sources()
60
+ declaration = load_declaration("plane_agent")
61
61
  for source in declaration.sources:
62
62
  assert not any(
63
63
  verb in tool for tool in source.tools for verb in ("create", "update", "delete")