Metadata-Version: 2.4
Name: codecraftai-interop-ext-tasker
Version: 1.3.2
Summary: Code Craft AI - Tasker Interop Extensions
License-Expression: LicenseRef-CodeCraftAI-Source-Available
License-File: LICENSE.md
Keywords: python
Author: Myron Walker
Author-email: myron.walker@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: POSIX
Requires-Dist: codecraftai-foundations (>=1.0.0,<2.0.0)
Requires-Dist: codecraftai-interop (>=1.0.0,<2.0.0)
Requires-Dist: codecraftai-landscaping (>=1.0.0,<2.0.0)
Requires-Dist: codecraftai-testbase (>=1.0.0,<2.0.0)
Requires-Dist: codecraftai-testplus (>=1.0.0,<2.0.0)
Requires-Dist: psutil (>=7.2.1,<8.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: rpyc (>=6.0.1,<7.0.0)
Project-URL: Issues, https://github.com/code-craft-ai-company/codecraftai-interop-ext-tasker/issues
Project-URL: Repository, https://github.com/code-craft-ai-company/codecraftai-interop-ext-tasker
Description-Content-Type: text/x-rst

===========================================
Code Craft AI Interop Extension: Tasker
===========================================

The ``codecraftai-interop-ext-tasker`` package is a tasker extension for the ``codecraftai-interop`` and ``codecraftai-landscaping`` frameworks. It adds the protocol, server, and client plumbing required to run distributed "tasking" work on remote nodes coordinated through a tasker daemon, and plugs into the host packages through the extension mechanism in ``codecraftai-extension``.

Highlights
==========

- Core tasking abstractions under ``interop/protocols/tasker/``: ``ITaskingSequencer``, ``TaskerController``, ``TaskerServer``, ``TaskerServerManager``, ``TaskerService``, ``TaskerDaemon``, ``TaskerSession``, ``TaskerNode``, and related event/scope/promise types.
- ``TaskerAspects`` object for behaviour control (retry, timeout, action pattern).
- Linux-specific subpackage for host-level integration.
- Tasker-aware client coordinator under ``landscaping/clients/taskers/`` so tasker nodes appear as first-class landscape resources.
- ``examples/`` hello-world tasking reference.

Repository Structure
====================

- ``development/`` - Runtime environment scripts.
- ``repository-setup/`` - Repository homing and setup scripts.
- ``source/packages/`` - Package source code.
- ``source/testroots/testbase/`` - TestBase test roots.
- ``source/examples/`` - Example tasking usage.
- ``userguide/`` - Standards, conventions, and documentation.

Environment Setup
=================

When working in a Codex container:

.. code-block:: bash

   ./development/setup-agent-container

For local development:

.. code-block:: bash

   ./repository-setup/rehome-repository
   ./development/setup-envrionment

Running Tests
=============

Activate the virtual environment:

.. code-block:: bash

   source .venv/bin/activate

Run the single-host test suite:

.. code-block:: bash

   testbase testing run --root source/testroots/testbase --includes=ccai.tests.singlehost --output=./.output

Standards and Conventions
=========================

- Naming conventions: ``userguide/10-02-naming-conventions.rst``
- Code organization: ``userguide/10-01-code-organization.rst``
- Coding standards: ``userguide/10-00-coding-standards.rst``

Additional Resources
====================

- User guide entry point: ``userguide/userguide.rst``

