Metadata-Version: 2.4
Name: codecraftai-integration-runtime
Version: 1.3.1
Summary: Code Craft AI - Integration Runtime
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
Provides-Extra: websocket
Requires-Dist: codecraftai-extension (>=1.0.0,<2.0.0)
Requires-Dist: codecraftai-foundations (>=1.0.0,<2.0.0)
Requires-Dist: codecraftai-testbase (>=1.0.0,<2.0.0)
Requires-Dist: codecraftai-this-app (>=1.0.0,<2.0.0)
Requires-Dist: codecraftai-xmodules (>=1.0.0,<2.0.0)
Requires-Dist: requests (>=2.32.4,<3.0.0)
Requires-Dist: websocket-client (>=1.8.0,<2.0.0) ; extra == "websocket"
Project-URL: Issues, https://github.com/code-craft-ai-company/codecraftai-integration-runtime/issues
Project-URL: Repository, https://github.com/code-craft-ai-company/codecraftai-integration-runtime
Description-Content-Type: text/x-rst

===============================
codecraftai-integration-runtime
===============================

The ``codecraftai-integration-runtime`` package is the *integration test-job layer*
of the Code Craft AI suite.  It builds on the near-standalone ``codecraftai-testbase``
single-host test framework and, using the ``codecraftai-extension`` extensibility
mechanism, supplies the ``IntegratedTestJob`` that adds the heavyweight reporting
and integration behaviour that plain ``testbase`` deliberately leaves out:

* JSOS / JSON streaming result recording to a well-known results directory
* HTML-rendered test summaries (templates, static resources)
* build / pipeline / job metadata sourced from ``ccai.thisapp`` runtime variables
* the result server, progress concentrators, and streaming infrastructure
* the integration / activation-driven CLI commands

``codecraftai-testbase`` records to **stdout** (and optional JSOS/JSON files) and has no
dependency on this package.  Packages that need persistent, rendered, CI-grade results
(``codecraftai-interop``, ``codecraftai-testplus`` and their downstreams) build their TestJob
hierarchy on ``IntegratedTestJob`` from this package.

This package was formed by **renaming and repurposing** the former ``codecraftai-runtime``
package.  The general runtime foundation (runtime variables, well-known paths, profile/job
enumerations, activation) moved *down* into ``codecraftai-this-app``; what remains here is the
integration test-job machinery migrated out of ``codecraftai-testbase``.

See ``AGENTS.md`` for the project overview and ``REFACTOR-TESTBASE-INTEGRATION-RUNTIME-ROADMAP.md``
in the monorepo root for the migration plan.

Build / Test / Run
==================

This repository follows the shared ``codecraftai-*`` skeleton.

1. Re-home the repository (regenerates ``.env``)::

    ./repository-setup/rehome-repository

2. Set up the virtual environment::

    ./development/setup-environment
    poetry install --all-extras

3. Run the tests::

    source ./.venv/bin/activate
    testbase testing run --root ./source/testroots/ccai --includes=ccai.tests --output=./.output
    deactivate

