mcp-workstate-orchestrator 0.4.7__tar.gz

mcp_workstate_orchestrator-0.4.7/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: mcp-workstate-orchestrator
+Version: 0.4.7
+Summary: MCP server for orchestration, lane management, worker daemons, and turn metrics.
+Project-URL: Homepage, https://github.com/darce/workstate
+Project-URL: Source, https://github.com/darce/workstate/tree/main/packages/mcp-workstate-orchestrator
+Project-URL: Changelog, https://github.com/darce/workstate/blob/main/packages/mcp-workstate-orchestrator/CHANGELOG.md
+Project-URL: Issues, https://github.com/darce/workstate/issues
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp
+Requires-Dist: mcp-workstate-handoff<0.12.0,>=0.11.4
+Requires-Dist: workstate-protocol<0.2.0,>=0.1.4
+Provides-Extra: test
+Requires-Dist: hypothesis>=6.0.0; extra == "test"
+Requires-Dist: pytest>=8.0.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: hypothesis>=6.0.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: ruff<1.0.0,>=0.11.0; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.13.0; extra == "dev"
+
+# Workstate Orchestrator MCP
+
+MCP server for orchestration, lane management, worker daemons, review dispatch, and ACE metrics.
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install mcp-workstate-orchestrator
+# or, as an isolated tool:
+uv tool install mcp-workstate-orchestrator
+# or, ad-hoc without installing:
+uvx mcp-workstate-orchestrator --help
+```
+
+`mcp-workstate-orchestrator` declares `mcp-workstate-handoff>=0.5.0,<0.6.0` as a
+required dependency; pip resolves it from PyPI automatically.
+`workstate-codex-bridge` remains optional unless you want the local
+bridge backend.
+
+### From the monorepo source tree (development)
+
+From this package root inside `workstate`:
+
+```bash
+cd packages/mcp-workstate-orchestrator
+python -m pip install -e ".[dev]"
+```
+
+When developing both MCP servers in lockstep, install the sibling
+handoff package as an editable first so the orchestrator picks it up:
+
+```bash
+pip install -e ../mcp-workstate-handoff
+pip install -e ".[dev]"
+```
+
+## Development
+
+Run package-local commands from the package root:
+
+```bash
+make lint-orchestrator
+make fix-lint-orchestrator
+make format-orchestrator
+make mypy-orchestrator
+make test-orchestrator
+make check-orchestrator
+```
+
+The package Makefile keeps `workstate-codex-bridge` as an optional sibling source path for local bridge-backend development, but it expects `mcp-workstate-handoff` to be installed as a normal package dependency.
+
+Direct commands also work:
+
+```bash
+PYTHONPATH=src python -m ruff check src tests
+PYTHONPATH=src python -m mypy src
+PYTHONPATH=src python -m pytest tests -q
+```
+
+## Token-Efficient Usage
+
+For bounded reads and compact caller patterns, follow the shared guide in [`packages/mcp-workstate-handoff/docs/guides/token-efficient-usage.md`](../mcp-workstate-handoff/docs/guides/token-efficient-usage.md). The orchestrator package reuses that guidance instead of maintaining a separate copy of the same parameter semantics.
+
+## Runtime Notes
+
+This package orchestrates work against a target workspace. The workspace you point it at still needs the expected task state and orchestration inputs, such as:
+
+- `.task-state/`
+- lane manifests
+- task plans or other orchestration docs the lane logic references
+
+Those assets belong to the workspace being orchestrated, not to the package checkout itself.
+
+## Backends
+
+The orchestration layer supports multiple execution backends, including:
+
+- `codex-cli`
+- `codex-subagent`
+- `claude-code`
+- `local-model-openai`
+
+Some backends are optional and require host-specific tooling to be installed separately.
+
+## Source Checkout Usage
+
+For local source execution without installation:
+
+```bash
+PYTHONPATH=src python -m workstate_orchestrator_mcp --help
+```
+
+If you are testing against a sibling `workstate-codex-bridge` checkout instead of an installed bridge dependency, extend `PYTHONPATH` with that sibling `src` directory as needed.

mcp_workstate_orchestrator-0.4.7/README.md

@@ -0,0 +1,95 @@
+# Workstate Orchestrator MCP
+
+MCP server for orchestration, lane management, worker daemons, review dispatch, and ACE metrics.
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install mcp-workstate-orchestrator
+# or, as an isolated tool:
+uv tool install mcp-workstate-orchestrator
+# or, ad-hoc without installing:
+uvx mcp-workstate-orchestrator --help
+```
+
+`mcp-workstate-orchestrator` declares `mcp-workstate-handoff>=0.5.0,<0.6.0` as a
+required dependency; pip resolves it from PyPI automatically.
+`workstate-codex-bridge` remains optional unless you want the local
+bridge backend.
+
+### From the monorepo source tree (development)
+
+From this package root inside `workstate`:
+
+```bash
+cd packages/mcp-workstate-orchestrator
+python -m pip install -e ".[dev]"
+```
+
+When developing both MCP servers in lockstep, install the sibling
+handoff package as an editable first so the orchestrator picks it up:
+
+```bash
+pip install -e ../mcp-workstate-handoff
+pip install -e ".[dev]"
+```
+
+## Development
+
+Run package-local commands from the package root:
+
+```bash
+make lint-orchestrator
+make fix-lint-orchestrator
+make format-orchestrator
+make mypy-orchestrator
+make test-orchestrator
+make check-orchestrator
+```
+
+The package Makefile keeps `workstate-codex-bridge` as an optional sibling source path for local bridge-backend development, but it expects `mcp-workstate-handoff` to be installed as a normal package dependency.
+
+Direct commands also work:
+
+```bash
+PYTHONPATH=src python -m ruff check src tests
+PYTHONPATH=src python -m mypy src
+PYTHONPATH=src python -m pytest tests -q
+```
+
+## Token-Efficient Usage
+
+For bounded reads and compact caller patterns, follow the shared guide in [`packages/mcp-workstate-handoff/docs/guides/token-efficient-usage.md`](../mcp-workstate-handoff/docs/guides/token-efficient-usage.md). The orchestrator package reuses that guidance instead of maintaining a separate copy of the same parameter semantics.
+
+## Runtime Notes
+
+This package orchestrates work against a target workspace. The workspace you point it at still needs the expected task state and orchestration inputs, such as:
+
+- `.task-state/`
+- lane manifests
+- task plans or other orchestration docs the lane logic references
+
+Those assets belong to the workspace being orchestrated, not to the package checkout itself.
+
+## Backends
+
+The orchestration layer supports multiple execution backends, including:
+
+- `codex-cli`
+- `codex-subagent`
+- `claude-code`
+- `local-model-openai`
+
+Some backends are optional and require host-specific tooling to be installed separately.
+
+## Source Checkout Usage
+
+For local source execution without installation:
+
+```bash
+PYTHONPATH=src python -m workstate_orchestrator_mcp --help
+```
+
+If you are testing against a sibling `workstate-codex-bridge` checkout instead of an installed bridge dependency, extend `PYTHONPATH` with that sibling `src` directory as needed.

mcp_workstate_orchestrator-0.4.7/pyproject.toml

@@ -0,0 +1,157 @@
+[build-system]
+requires = ["setuptools>=69"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mcp-workstate-orchestrator"
+version = "0.4.7"
+description = "MCP server for orchestration, lane management, worker daemons, and turn metrics."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "fastmcp",
+    "mcp-workstate-handoff>=0.11.4,<0.12.0",
+    "workstate-protocol>=0.1.4,<0.2.0",
+]
+
+[project.scripts]
+mcp-workstate-orchestrator = "workstate_orchestrator_mcp.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/darce/workstate"
+Source = "https://github.com/darce/workstate/tree/main/packages/mcp-workstate-orchestrator"
+Changelog = "https://github.com/darce/workstate/blob/main/packages/mcp-workstate-orchestrator/CHANGELOG.md"
+Issues = "https://github.com/darce/workstate/issues"
+
+[project.optional-dependencies]
+test = [
+    "hypothesis>=6.0.0",
+    "pytest>=8.0.0",
+]
+dev = [
+    "hypothesis>=6.0.0",
+    "pytest>=8.0.0",
+    "ruff>=0.11.0,<1.0.0",
+    "mypy>=1.13.0,<2.0.0",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+py-modules = ["workstate_orchestrator_mcp_launcher"]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"workstate_orchestrator_mcp._assets" = [
+    "scripts/*",
+    "rules/*.md",
+    "templates/*.md",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+exclude = [
+    "build",
+    "src/*.egg-info",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+]
+ignore = [
+    "WORKSTATE-REF-501",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]
+"src/workstate_orchestrator_mcp/api.py" = ["F401"]
+"src/workstate_orchestrator_mcp/orchestration/*.py" = ["WORKSTATE-REF-402"]
+"tests/**/*.py" = ["WORKSTATE-REF-402", "F401", "F811"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.mypy]
+python_version = "3.11"
+files = ["src"]
+exclude = ["build/"]
+warn_return_any = true
+warn_unused_configs = true
+check_untyped_defs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+no_implicit_optional = true
+disallow_untyped_defs = false
+
+[[tool.mypy.overrides]]
+module = [
+    "fastmcp",
+    "fastmcp.*",
+    "textual",
+    "textual.*",
+]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = [
+    "_env",
+    "backend_adapter",
+    "backend_registry",
+    "bootstrap_lane",
+    "dashboard_live",
+    "lane_exec",
+    "lane_manifest",
+    "orchestrator_guidance",
+    "orchestrator_guidance_policy",
+    "orchestrator_helpers",
+    "orchestrator_lanes",
+    "review_runner",
+    "task_plan_parser",
+]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = [
+    "workstate_orchestrator_mcp.api",
+    "workstate_orchestrator_mcp.orchestration.ace_metrics",
+    "workstate_orchestrator_mcp.orchestration.adapters.codex_cli",
+    "workstate_orchestrator_mcp.orchestration.backend_registry",
+    "workstate_orchestrator_mcp.orchestration.bootstrap_lane",
+    "workstate_orchestrator_mcp.orchestration.lane_exec",
+    "workstate_orchestrator_mcp.orchestration.lane_prompt",
+    "workstate_orchestrator_mcp.orchestration.lane_result",
+    "workstate_orchestrator_mcp.orchestration.orchestrator_daemon",
+    "workstate_orchestrator_mcp.orchestration.orchestrator_guidance",
+    "workstate_orchestrator_mcp.orchestration.review_runner",
+    "workstate_orchestrator_mcp.orchestration.worker_daemon",
+]
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = ["tests.*"]
+disallow_untyped_defs = false
+disable_error_code = ["method-assign", "arg-type"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+norecursedirs = [
+    ".pytest_cache",
+    "build",
+    "src/*.egg-info",
+]
+
+[tool.hoisted]
+repository = "darce/workstate"
+install_url = "git+https://github.com/darce/workstate.git@mcp-workstate-orchestrator-v{version}#subdirectory=packages/mcp-workstate-orchestrator"
+changelog = "CHANGELOG.md"

mcp_workstate_orchestrator-0.4.7/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mcp_workstate_orchestrator-0.4.7/src/mcp_workstate_orchestrator.egg-info/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: mcp-workstate-orchestrator
+Version: 0.4.7
+Summary: MCP server for orchestration, lane management, worker daemons, and turn metrics.
+Project-URL: Homepage, https://github.com/darce/workstate
+Project-URL: Source, https://github.com/darce/workstate/tree/main/packages/mcp-workstate-orchestrator
+Project-URL: Changelog, https://github.com/darce/workstate/blob/main/packages/mcp-workstate-orchestrator/CHANGELOG.md
+Project-URL: Issues, https://github.com/darce/workstate/issues
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp
+Requires-Dist: mcp-workstate-handoff<0.12.0,>=0.11.4
+Requires-Dist: workstate-protocol<0.2.0,>=0.1.4
+Provides-Extra: test
+Requires-Dist: hypothesis>=6.0.0; extra == "test"
+Requires-Dist: pytest>=8.0.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: hypothesis>=6.0.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: ruff<1.0.0,>=0.11.0; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.13.0; extra == "dev"
+
+# Workstate Orchestrator MCP
+
+MCP server for orchestration, lane management, worker daemons, review dispatch, and ACE metrics.
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install mcp-workstate-orchestrator
+# or, as an isolated tool:
+uv tool install mcp-workstate-orchestrator
+# or, ad-hoc without installing:
+uvx mcp-workstate-orchestrator --help
+```
+
+`mcp-workstate-orchestrator` declares `mcp-workstate-handoff>=0.5.0,<0.6.0` as a
+required dependency; pip resolves it from PyPI automatically.
+`workstate-codex-bridge` remains optional unless you want the local
+bridge backend.
+
+### From the monorepo source tree (development)
+
+From this package root inside `workstate`:
+
+```bash
+cd packages/mcp-workstate-orchestrator
+python -m pip install -e ".[dev]"
+```
+
+When developing both MCP servers in lockstep, install the sibling
+handoff package as an editable first so the orchestrator picks it up:
+
+```bash
+pip install -e ../mcp-workstate-handoff
+pip install -e ".[dev]"
+```
+
+## Development
+
+Run package-local commands from the package root:
+
+```bash
+make lint-orchestrator
+make fix-lint-orchestrator
+make format-orchestrator
+make mypy-orchestrator
+make test-orchestrator
+make check-orchestrator
+```
+
+The package Makefile keeps `workstate-codex-bridge` as an optional sibling source path for local bridge-backend development, but it expects `mcp-workstate-handoff` to be installed as a normal package dependency.
+
+Direct commands also work:
+
+```bash
+PYTHONPATH=src python -m ruff check src tests
+PYTHONPATH=src python -m mypy src
+PYTHONPATH=src python -m pytest tests -q
+```
+
+## Token-Efficient Usage
+
+For bounded reads and compact caller patterns, follow the shared guide in [`packages/mcp-workstate-handoff/docs/guides/token-efficient-usage.md`](../mcp-workstate-handoff/docs/guides/token-efficient-usage.md). The orchestrator package reuses that guidance instead of maintaining a separate copy of the same parameter semantics.
+
+## Runtime Notes
+
+This package orchestrates work against a target workspace. The workspace you point it at still needs the expected task state and orchestration inputs, such as:
+
+- `.task-state/`
+- lane manifests
+- task plans or other orchestration docs the lane logic references
+
+Those assets belong to the workspace being orchestrated, not to the package checkout itself.
+
+## Backends
+
+The orchestration layer supports multiple execution backends, including:
+
+- `codex-cli`
+- `codex-subagent`
+- `claude-code`
+- `local-model-openai`
+
+Some backends are optional and require host-specific tooling to be installed separately.
+
+## Source Checkout Usage
+
+For local source execution without installation:
+
+```bash
+PYTHONPATH=src python -m workstate_orchestrator_mcp --help
+```
+
+If you are testing against a sibling `workstate-codex-bridge` checkout instead of an installed bridge dependency, extend `PYTHONPATH` with that sibling `src` directory as needed.

mcp_workstate_orchestrator-0.4.7/src/mcp_workstate_orchestrator.egg-info/SOURCES.txt

@@ -0,0 +1,101 @@
+README.md
+pyproject.toml
+src/workstate_orchestrator_mcp_launcher.py
+src/mcp_workstate_orchestrator.egg-info/PKG-INFO
+src/mcp_workstate_orchestrator.egg-info/SOURCES.txt
+src/mcp_workstate_orchestrator.egg-info/dependency_links.txt
+src/mcp_workstate_orchestrator.egg-info/entry_points.txt
+src/mcp_workstate_orchestrator.egg-info/requires.txt
+src/mcp_workstate_orchestrator.egg-info/top_level.txt
+src/workstate_orchestrator_mcp/__init__.py
+src/workstate_orchestrator_mcp/__main__.py
+src/workstate_orchestrator_mcp/api.py
+src/workstate_orchestrator_mcp/cli.py
+src/workstate_orchestrator_mcp/lanes.py
+src/workstate_orchestrator_mcp/_assets/__init__.py
+src/workstate_orchestrator_mcp/_assets/rules/branch-review-guide.md
+src/workstate_orchestrator_mcp/_assets/rules/branch-review-php.md
+src/workstate_orchestrator_mcp/_assets/rules/branch-review-python.md
+src/workstate_orchestrator_mcp/_assets/rules/branch-review-typescript.md
+src/workstate_orchestrator_mcp/_assets/rules/contract-change-checklist.md
+src/workstate_orchestrator_mcp/_assets/rules/planning-review-guide.md
+src/workstate_orchestrator_mcp/_assets/scripts/worktree-lane
+src/workstate_orchestrator_mcp/_assets/templates/WORKTREE_LANE_BRIEF.template.md
+src/workstate_orchestrator_mcp/_assets/templates/WORKTREE_LANE_REPORT.template.md
+src/workstate_orchestrator_mcp/orchestration/__init__.py
+src/workstate_orchestrator_mcp/orchestration/_env.py
+src/workstate_orchestrator_mcp/orchestration/ace_metrics.py
+src/workstate_orchestrator_mcp/orchestration/backend_adapter.py
+src/workstate_orchestrator_mcp/orchestration/backend_registry.py
+src/workstate_orchestrator_mcp/orchestration/bootstrap_lane.py
+src/workstate_orchestrator_mcp/orchestration/daemon_startup.py
+src/workstate_orchestrator_mcp/orchestration/dashboard_extension.py
+src/workstate_orchestrator_mcp/orchestration/dashboard_live.py
+src/workstate_orchestrator_mcp/orchestration/dashboard_tui.py
+src/workstate_orchestrator_mcp/orchestration/generate_agent_config.py
+src/workstate_orchestrator_mcp/orchestration/generate_lane_manifest.py
+src/workstate_orchestrator_mcp/orchestration/handoff_guidance_summary.py
+src/workstate_orchestrator_mcp/orchestration/handoff_integrity_guard.py
+src/workstate_orchestrator_mcp/orchestration/handoff_read_shapes.py
+src/workstate_orchestrator_mcp/orchestration/lane_config.py
+src/workstate_orchestrator_mcp/orchestration/lane_exec.py
+src/workstate_orchestrator_mcp/orchestration/lane_manifest.py
+src/workstate_orchestrator_mcp/orchestration/lane_prompt.py
+src/workstate_orchestrator_mcp/orchestration/lane_result.py
+src/workstate_orchestrator_mcp/orchestration/orchestrator_daemon.py
+src/workstate_orchestrator_mcp/orchestration/orchestrator_guidance.py
+src/workstate_orchestrator_mcp/orchestration/orchestrator_guidance_policy.py
+src/workstate_orchestrator_mcp/orchestration/orchestrator_helpers.py
+src/workstate_orchestrator_mcp/orchestration/orchestrator_lanes.py
+src/workstate_orchestrator_mcp/orchestration/review_dispatch.py
+src/workstate_orchestrator_mcp/orchestration/review_ready.py
+src/workstate_orchestrator_mcp/orchestration/review_runner.py
+src/workstate_orchestrator_mcp/orchestration/slice_review_packet.py
+src/workstate_orchestrator_mcp/orchestration/task_plan_parser.py
+src/workstate_orchestrator_mcp/orchestration/worker_daemon.py
+src/workstate_orchestrator_mcp/orchestration/worker_daemon_ctl.py
+src/workstate_orchestrator_mcp/orchestration/adapters/claude_code.py
+src/workstate_orchestrator_mcp/orchestration/adapters/codex_cli.py
+src/workstate_orchestrator_mcp/orchestration/adapters/codex_subagent.py
+src/workstate_orchestrator_mcp/orchestration/adapters/local_model.py
+src/workstate_orchestrator_mcp/orchestration/adapters/structured_turn.py
+tests/test_ace_metrics.py
+tests/test_ace_reflect.py
+tests/test_backend_registry.py
+tests/test_bootstrap_lane.py
+tests/test_codex_subagent.py
+tests/test_cross_vendor_subagent_equivalence.py
+tests/test_daemon_startup_warning.py
+tests/test_execution_adapters.py
+tests/test_generate_agent_config.py
+tests/test_generate_lane_manifest.py
+tests/test_handoff_integrity_guard.py
+tests/test_hardening.py
+tests/test_lane_config.py
+tests/test_lane_exec.py
+tests/test_lane_manifest.py
+tests/test_lane_prompt.py
+tests/test_lane_prompt_artifacts.py
+tests/test_lane_result.py
+tests/test_lanes_and_handoff_state.py
+tests/test_local_model.py
+tests/test_orchestrator_build.py
+tests/test_orchestrator_daemon.py
+tests/test_orchestrator_guidance.py
+tests/test_orchestrator_lanes.py
+tests/test_orchestrator_tools.py
+tests/test_package_metadata.py
+tests/test_plan_cursor_gate.py
+tests/test_protocol_contract.py
+tests/test_review_dispatch.py
+tests/test_review_fix_cycle.py
+tests/test_review_mode.py
+tests/test_review_ready.py
+tests/test_review_runner.py
+tests/test_review_schema.py
+tests/test_smoke_apps_lane.py
+tests/test_task_plan_parser.py
+tests/test_worker_daemon.py
+tests/test_worker_daemon_ctl.py
+tests/test_workstate_lane_id_propagation.py
+tests/test_worktree_lane.py

mcp_workstate_orchestrator-0.4.7/src/mcp_workstate_orchestrator.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mcp_workstate_orchestrator-0.4.7/src/mcp_workstate_orchestrator.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mcp-workstate-orchestrator = workstate_orchestrator_mcp.cli:main

mcp_workstate_orchestrator-0.4.7/src/mcp_workstate_orchestrator.egg-info/requires.txt

@@ -0,0 +1,13 @@
+fastmcp
+mcp-workstate-handoff<0.12.0,>=0.11.4
+workstate-protocol<0.2.0,>=0.1.4
+
+[dev]
+hypothesis>=6.0.0
+pytest>=8.0.0
+ruff<1.0.0,>=0.11.0
+mypy<2.0.0,>=1.13.0
+
+[test]
+hypothesis>=6.0.0
+pytest>=8.0.0

mcp_workstate_orchestrator-0.4.7/src/mcp_workstate_orchestrator.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+workstate_orchestrator_mcp
+workstate_orchestrator_mcp_launcher

mcp_workstate_orchestrator-0.4.7/src/workstate_orchestrator_mcp/__init__.py

@@ -0,0 +1 @@
+"""Workstate Orchestrator MCP — orchestration, lane management, and worker daemon tools."""

mcp_workstate_orchestrator-0.4.7/src/workstate_orchestrator_mcp/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

mcp_workstate_orchestrator-0.4.7/src/workstate_orchestrator_mcp/_assets/__init__.py

@@ -0,0 +1,48 @@
+"""Bundled runtime assets shipped with the orchestrator package.
+
+These resources (lane management scripts, review prompt guides, the
+contract-change checklist) used to be looked up at consumer-repo paths
+such as ``<orchestrator_root>/scripts/worktree-lane`` or
+``<orchestrator_root>/docs/agentic/rules/branch-review-guide.md``.
+That coupling forced every consumer repo to vendor the package's own
+files, which drifted across consumers and broke installs that did not
+ship the orchestrator from a sibling source checkout.
+
+The fix: the orchestrator now owns these files inside its own package
+tree and resolves them via ``importlib.resources``. Consumers may still
+override the rules directory or the script path explicitly, but the
+default lookup never leaves the package.
+"""
+
+from __future__ import annotations
+
+from importlib import resources
+from importlib.resources.abc import Traversable
+from pathlib import Path
+
+_PACKAGE = "workstate_orchestrator_mcp._assets"
+
+
+def assets_root() -> Traversable:
+    """Return the package-local ``_assets`` Traversable."""
+    return resources.files(_PACKAGE)
+
+
+def bundled_script_path(name: str) -> Path:
+    """Resolve a bundled executable script to a real filesystem path.
+
+    The orchestrator shells out to these scripts (``worktree-lane``), so a
+    Traversable is not enough — subprocess needs an on-disk path. Package
+    data files always live on disk for ``setuptools`` installs, but we go
+    through ``as_file`` so it works under future zip-imports too.
+    """
+    traversable = assets_root() / "scripts" / name
+    with resources.as_file(traversable) as fs_path:
+        return Path(fs_path)
+
+
+def bundled_rules_dir() -> Path:
+    """Resolve the bundled review-rules directory to a filesystem path."""
+    traversable = assets_root() / "rules"
+    with resources.as_file(traversable) as fs_path:
+        return Path(fs_path)