audiagentic 0.2.1__tar.gz

audiagentic-0.2.1/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: audiagentic
+Version: 0.2.1
+Summary: AUDiaGentic: Agentic workflow orchestration and execution platform
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: babel>=2.15
+Requires-Dist: dulwich<0.26,>=0.24
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rapidfuzz>=3.0
+Requires-Dist: jsonschema>=4.18
+Requires-Dist: mcp==1.27.0
+Requires-Dist: pydantic<3,>=2.11
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: rich>=15.0.0
+Provides-Extra: acp
+Requires-Dist: agent-client-protocol==0.11.0; extra == "acp"
+Provides-Extra: a2a
+Requires-Dist: a2a-sdk==1.1.2; extra == "a2a"
+Provides-Extra: mcp
+Requires-Dist: mcp==1.27.0; extra == "mcp"
+Requires-Dist: tomli-w>=1.0; extra == "mcp"
+Provides-Extra: gpt-auto
+Requires-Dist: websockets>=13.0; extra == "gpt-auto"
+Provides-Extra: test
+Requires-Dist: pytest>=9.0; extra == "test"
+Requires-Dist: pytest-asyncio>=1.3; extra == "test"
+Requires-Dist: pytest-cov>=5.0; extra == "test"
+Requires-Dist: pytest-timeout>=2.3; extra == "test"
+Requires-Dist: pytest-xdist>=3.0; extra == "test"
+Requires-Dist: psutil>=5.9; extra == "test"
+Requires-Dist: mcp==1.27.0; extra == "test"
+Requires-Dist: tomli-w>=1.0; extra == "test"
+Requires-Dist: pyright>=1.1; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.3; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: pytest-timeout>=2.3; extra == "dev"
+Requires-Dist: pytest-xdist>=3.0; extra == "dev"
+Requires-Dist: psutil>=5.9; extra == "dev"
+Requires-Dist: mcp==1.27.0; extra == "dev"
+Requires-Dist: tomli-w>=1.0; extra == "dev"
+Requires-Dist: pyright>=1.1; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+
+# AUDiaGentic
+
+Multi-agent workflow orchestration system for AI coding agents. Provides the infrastructure to plan, execute, and track software engineering work across coordinated agent sessions.
+
+## Quick links
+
+- **[docs/layout.md](docs/layout.md)** — directory layout and config hierarchy
+- **[docs/planning/](docs/planning/)** — planning system (requests, specs, tasks, plans, work packages)
+- **[docs/releases/](docs/releases/)** — current release and audit docs
+- **[docs/testing/](docs/testing/)** — test environment and architecture
+- **[docs/knowledge/](docs/knowledge/)** — knowledge vault
+- **[docs/examples/](docs/examples/)** — example project scaffold
+- **[docs/archive/](docs/archive/)** — superseded references
+
+## Source code
+
+| Layer | Path | Contents |
+|-------|------|----------|
+| Foundation | `src/audiagentic/foundation/` | Contracts, config, events, workflow primitives |
+| Runtime | `src/audiagentic/runtime/` | Lifecycle management, state |
+| Components | `src/audiagentic/components/optional/` | Providers, coding LSP, ledger, agent jobs, release, source control |
+
+## Installation
+
+For a released build, install the package from PyPI:
+
+```bash
+python3 -m venv ~/.venvs/audiagentic
+source ~/.venvs/audiagentic/bin/activate
+python -m pip install --upgrade audiagentic
+```
+
+The GitHub Release workflow builds and attaches the wheel and source archive
+to each release and publishes them to PyPI using GitHub Trusted Publishing.
+See
+[`docs/releases/PYPI_PUBLISHING.md`](docs/releases/PYPI_PUBLISHING.md).
+
+## Docker test path
+
+Use the existing Docker base image as the normal test path. Do not rebuild test images for routine validation unless the image inputs changed.
+
+Normal path:
+
+```bash
+docker run --rm \
+  -v "${PWD}:/app" \
+  -w /app \
+  -e AUDIAGENTIC_DOCKER_TESTS=1 \
+  -e AUDIAGENTIC_REPO_ROOT=/app \
+  audia-test-base:latest \
+  bash -lc "python3 -m pip install --no-cache-dir --break-system-packages -e . pytest pytest-asyncio mcp==1.27.0 && pytest tests/integration/release tests/e2e/release -q"
+```
+
+Rebuild only when one of these changed:
+
+- `tests/docker/Dockerfile.test-base`
+- `tests/docker/Dockerfile.test`
+- `tests/docker/Dockerfile.release-test`
+- image-level package/tool bootstrap requirements
+- the local image is missing or known-bad
+
+Use `tests/docker/Dockerfile.release-test` only when validating the wheel-installed release path or package-data bundling. It is not the default recheck path.
+
+## Testing
+
+- **[docs/testing/TEST_ENVIRONMENT.md](docs/testing/TEST_ENVIRONMENT.md)** — primary test environment guide
+- **[docs/testing/TEST_ARCHITECTURE.md](docs/testing/TEST_ARCHITECTURE.md)** — test architecture overview

audiagentic-0.2.1/README.md

@@ -0,0 +1,67 @@
+# AUDiaGentic
+
+Multi-agent workflow orchestration system for AI coding agents. Provides the infrastructure to plan, execute, and track software engineering work across coordinated agent sessions.
+
+## Quick links
+
+- **[docs/layout.md](docs/layout.md)** — directory layout and config hierarchy
+- **[docs/planning/](docs/planning/)** — planning system (requests, specs, tasks, plans, work packages)
+- **[docs/releases/](docs/releases/)** — current release and audit docs
+- **[docs/testing/](docs/testing/)** — test environment and architecture
+- **[docs/knowledge/](docs/knowledge/)** — knowledge vault
+- **[docs/examples/](docs/examples/)** — example project scaffold
+- **[docs/archive/](docs/archive/)** — superseded references
+
+## Source code
+
+| Layer | Path | Contents |
+|-------|------|----------|
+| Foundation | `src/audiagentic/foundation/` | Contracts, config, events, workflow primitives |
+| Runtime | `src/audiagentic/runtime/` | Lifecycle management, state |
+| Components | `src/audiagentic/components/optional/` | Providers, coding LSP, ledger, agent jobs, release, source control |
+
+## Installation
+
+For a released build, install the package from PyPI:
+
+```bash
+python3 -m venv ~/.venvs/audiagentic
+source ~/.venvs/audiagentic/bin/activate
+python -m pip install --upgrade audiagentic
+```
+
+The GitHub Release workflow builds and attaches the wheel and source archive
+to each release and publishes them to PyPI using GitHub Trusted Publishing.
+See
+[`docs/releases/PYPI_PUBLISHING.md`](docs/releases/PYPI_PUBLISHING.md).
+
+## Docker test path
+
+Use the existing Docker base image as the normal test path. Do not rebuild test images for routine validation unless the image inputs changed.
+
+Normal path:
+
+```bash
+docker run --rm \
+  -v "${PWD}:/app" \
+  -w /app \
+  -e AUDIAGENTIC_DOCKER_TESTS=1 \
+  -e AUDIAGENTIC_REPO_ROOT=/app \
+  audia-test-base:latest \
+  bash -lc "python3 -m pip install --no-cache-dir --break-system-packages -e . pytest pytest-asyncio mcp==1.27.0 && pytest tests/integration/release tests/e2e/release -q"
+```
+
+Rebuild only when one of these changed:
+
+- `tests/docker/Dockerfile.test-base`
+- `tests/docker/Dockerfile.test`
+- `tests/docker/Dockerfile.release-test`
+- image-level package/tool bootstrap requirements
+- the local image is missing or known-bad
+
+Use `tests/docker/Dockerfile.release-test` only when validating the wheel-installed release path or package-data bundling. It is not the default recheck path.
+
+## Testing
+
+- **[docs/testing/TEST_ENVIRONMENT.md](docs/testing/TEST_ENVIRONMENT.md)** — primary test environment guide
+- **[docs/testing/TEST_ARCHITECTURE.md](docs/testing/TEST_ARCHITECTURE.md)** — test architecture overview

audiagentic-0.2.1/pyproject.toml

@@ -0,0 +1,175 @@
+[build-system]
+requires = ["setuptools>=67", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "audiagentic"
+version = "0.2.1"
+description = "AUDiaGentic: Agentic workflow orchestration and execution platform"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+
+dependencies = [
+  "babel>=2.15",
+  "dulwich>=0.24,<0.26",
+  "pyyaml>=6.0",
+  "rapidfuzz>=3.0",
+  "jsonschema>=4.18",
+  "mcp==1.27.0",
+  "pydantic>=2.11,<3",
+  "tomli-w>=1.0",
+  "rich>=15.0.0",
+]
+
+[project.optional-dependencies]
+# Standards-based streaming agent transport. Kept optional because CLI-stream
+# providers remain supported without ACP.
+acp = ["agent-client-protocol==0.11.0"]
+a2a = ["a2a-sdk==1.1.2"]
+# MCP server support for the planning tool surface
+mcp = ["mcp==1.27.0", "tomli-w>=1.0"]
+# Browser automation for gpt-auto provider
+gpt-auto = ["websockets>=13.0"]
+# Test dependencies
+test = [
+  "pytest>=9.0",
+  "pytest-asyncio>=1.3",
+  "pytest-cov>=5.0",
+  "pytest-timeout>=2.3",
+  "pytest-xdist>=3.0",
+  "psutil>=5.9",
+  "mcp==1.27.0",
+  "tomli-w>=1.0",
+  "pyright>=1.1",
+]
+# Full development environment
+dev = [
+  "pytest>=9.0",
+  "pytest-asyncio>=1.3",
+  "pytest-cov>=5.0",
+  "pytest-timeout>=2.3",
+  "pytest-xdist>=3.0",
+  "psutil>=5.9",
+  "mcp==1.27.0",
+  "tomli-w>=1.0",
+  "pyright>=1.1",
+  "ruff",
+  "mypy",
+]
+
+[project.scripts]
+# Only the user-facing CLI is a public entry point.
+# MCP servers are internal modules invoked via `python -m` within the Pi
+# harness session only. They must not appear on PATH or be discoverable
+# by other tools.
+audiagentic = "audiagentic.launcher:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"audiagentic" = [
+  "components/agents/gateway/service/client_icons/*.png",
+  # Component descriptors and embedded markdown assets
+  "config/components/**/*.yaml",
+  "config/components/**/*.md",
+  "config/components/**/*.yml",
+  "config/components/**/*.json",
+  "config/components/release/.github/workflows/*.yml",
+  "config/providers/*.yaml",
+  "config/recipes/*.yaml",
+  # Package-default configs
+  "config/provisioning/harness/*.yaml",
+  "config/provisioning/rig/*.yaml",
+  "config/provisioning/foundation/*.yaml",
+  "components/providers/contracts/*.json",
+  # Toolchain action table (read at import time by descriptors)
+  "foundation/toolchains/*.yaml",
+  # JSON Schemas used for runtime payload validation (ledger, providers, planning)
+  "foundation/contracts/schemas/**/*.json",
+  "components/providers/contracts/*.json",
+  # Knowledge component runtime data
+  "components/optional/knowledge/runtime_data/*.yml",
+  # Provider instruction / prompt-tag templates materialized onto surfaces
+  "components/providers/adapters/**/*.md",
+  "components/providers/services/execution/templates/agents/*.md",
+  "components/providers/surfaces/templates/*.md",
+  # Misc runtime data
+  "runtime/build/*.yaml",
+  "runtime/rig/external/*.yaml",
+  "runtime/harness/opencode/templates/**/*.md",
+  # Pi harness home templates
+  "runtime/harness/pi/templates/home/agent/**/*.ts",
+  "runtime/harness/pi/templates/home/agent/**/*.json",
+  "runtime/harness/pi/templates/home/agent/**/*.md",
+  # Embedded rig model profiles registry (machine-only, not user config)
+  "runtime/rig/embedded/models.json",
+  # Release-please provisioning templates
+  "components/release/release_please/templates/*.json",
+  "components/release/release_please/templates/*.yml",
+  "components/providers/workflow/*.yaml",
+  # Component-local state workflow definitions (states + transitions)
+  "components/agent_jobs/*.yaml",
+  "components/planning/*.yaml",
+  # Agent LLM Gateway workflow definition (loaded at module load time)
+  "components/agents/*.yaml",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "strict"
+testpaths = ["tests/unit", "tests/integration", "tests/e2e"]
+pythonpath = ["src"]
+addopts = "-ra -q --tb=short --strict-markers --strict-config --import-mode=importlib -p no:randomly"
+timeout = 30
+# Parallel execution: -n auto uses all available CPUs.
+# Run with: pytest -n auto  (or pytest -n <N> for N workers)
+# Safe for e2e because all e2e tests use tmp_path isolation.
+# xdist auto-detects CPU count; override with -n 4 etc.
+markers = [
+  # Tier markers — auto-applied by tests/conftest.py based on directory path
+  "unit: pure in-process test; no real I/O, subprocess, or network",
+  "integration: real filesystem (tmp_path) or subprocess; no Docker required",
+  "e2e: full user-facing path; real CLI, network, or Docker",
+  # Speed
+  "slow: single test takes >10s; excluded from quick runs (pytest -m 'not slow')",
+  # Resource / environment dependencies
+    "requires_container: must run inside the disposable Docker test environment",
+  "requires_network: needs outbound internet access",
+  "requires_uv: needs uv on PATH",
+  "requires_npm: needs npm on PATH",
+  "requires_cargo: needs cargo on PATH",
+  "requires_gh: needs gh CLI on PATH",
+  # Behaviour / intent
+  "smoke: minimal sanity check; should pass in every environment",
+  "opt_in: destructive or expensive; never run by default",
+    "mutates_host: installs/removes packages on the test host; implies disposable-container execution",
+  # Legacy / extended markers (kept for backward compatibility)
+  "docker: legacy alias for requires_container",
+  "dev: exercises local filesystem state; not collected in CI (run: pytest tests/dev/)",
+  "mutates_project_fs: writes/deletes project files beyond ephemeral temp paths",
+  "long_running: expected runtime >60s; pair with @pytest.mark.timeout(N)",
+  "flaky_external: depends on unstable external systems or services",
+  # Parallel execution
+  "no_parallel: test shares a subprocess connection; must run serially",
+]
+
+[tool.coverage.run]
+source = ["src"]
+branch = true
+omit = ["*/tests/*", "*/__pycache__/*"]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = false
+fail_under = 60
+
+[tool.ruff]
+src = ["src"]
+target-version = "py310"
+line-length = 100
+extend-exclude = ["archive"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+ignore = ["E501"]

audiagentic-0.2.1/setup.cfg

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

audiagentic-0.2.1/src/audiagentic/__init__.py

@@ -0,0 +1,11 @@
+"""AUDiaGentic: Agentic workflow orchestration and execution platform.
+
+Top-level package for the AUDiaGentic system. Domain layout:
+
+  foundation/   — shared contracts, event bus, and the component framework (base layer)
+  components/   — core and optional components (project, session, providers, ledger, ...)
+  runtime/      — lifecycle management, harness, and durable state persistence
+  config/       — component descriptors and provisioning configuration
+"""
+
+__version__ = "0.2.1"

audiagentic-0.2.1/src/audiagentic/commands/__init__.py

@@ -0,0 +1,4 @@
+from audiagentic.commands.component import _cmd_component
+from audiagentic.commands.launch import _cmd_launch
+
+__all__ = ["_cmd_component", "_cmd_launch"]

audiagentic-0.2.1/src/audiagentic/commands/bootstrap.py

@@ -0,0 +1,199 @@
+"""Bootstrap and repair commands for AUDiaGentic-owned state."""
+from __future__ import annotations
+
+import argparse
+import logging
+from pathlib import Path
+
+from audiagentic.foundation.cli_io import print_error, print_json, print_message
+from audiagentic.foundation.paths.home import global_harness_runtime
+from audiagentic.runtime.harness import (
+    cleanup_runtime,
+    install_to,
+    refresh_materialized_agent_config,
+    request_runtime_reload,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _install_core_components(project_root: Path) -> list[str]:
+    """Materialize every mandatory project component; return failed ids.
+
+    These components own project scaffold (configuration, prompts and event-bus
+    state).  They are deliberately independent of MCP collection.
+    """
+    from audiagentic.foundation.components.loader import register_all_components
+    from audiagentic.foundation.components.registry import all_descriptors
+    from audiagentic.foundation.lifecycle.components import install_component
+
+    register_all_components()
+    failed: list[str] = []
+    for component_id, descriptor in all_descriptors().items():
+        if not descriptor.core:
+            continue
+        try:
+            result = install_component(component_id, project_root)
+            if not result.get("ok"):
+                failed.append(component_id)
+        except Exception:
+            logger.error("Failed to bootstrap core component %s", component_id, exc_info=True)
+            failed.append(component_id)
+    return failed
+
+
+def _cmd_bootstrap(target: Path, project_root: Path) -> int:
+    print_message(f"Bootstrapping AUDiaGentic into {target}")
+    rc = install_to(target, project_root=project_root)
+    if rc:
+        return rc
+
+    failed = _install_core_components(project_root)
+    if failed:
+        print_error(f"Failed to bootstrap core components: {', '.join(sorted(failed))}")
+        return 1
+
+    print_message("\nBootstrap complete. Run 'audiagentic' from any project directory.")
+    if target != global_harness_runtime():
+        print_message(f"Set AUDIAGENTIC_HOME={target.parent} to use this location.")
+    return 0
+
+
+def cmd_bootstrap(args: argparse.Namespace, project_root: Path) -> int:
+    target = Path(args.target).resolve() if args.target else global_harness_runtime()
+    return _cmd_bootstrap(target, project_root)
+
+
+def cmd_cleanup(args: argparse.Namespace, project_root: Path) -> int:
+    del project_root
+    target = Path(args.target).resolve() if args.target else global_harness_runtime()
+    print_message(f"Removing AUDiaGentic-generated runtime files from {target}")
+    return cleanup_runtime(target)
+
+
+def _omit_empty_values(value: object) -> object:
+    """Return CLI-safe data without null or empty optional fields."""
+    if isinstance(value, dict):
+        return {
+            key: cleaned
+            for key, item in value.items()
+            if (cleaned := _omit_empty_values(item)) is not None
+            and cleaned != ""
+            and cleaned != []
+            and cleaned != {}
+        }
+    if isinstance(value, list):
+        return [_omit_empty_values(item) for item in value]
+    return value
+
+
+def _surface_results_to_json(results: object) -> list[dict[str, object]]:
+    """Serialize generated-surface API results for CLI output."""
+    values = results if isinstance(results, list) else [results]
+    serialized: list[dict[str, object]] = []
+    for value in values:
+        converter = getattr(value, "to_mapping", None)
+        if callable(converter):
+            value = converter()
+        mapping = dict(value) if isinstance(value, dict) else {"result": str(value)}
+        cleaned = _omit_empty_values(mapping)
+        serialized.append(cleaned if isinstance(cleaned, dict) else {})
+    return serialized
+
+
+def _config_summary(
+    *,
+    mode: str,
+    project_root: Path,
+    surface_results: list[dict[str, object]],
+    provider_errors: list[dict[str, object]],
+) -> dict[str, object]:
+    written = sorted({
+        path
+        for result in surface_results
+        for path in result.get("written_paths", [])
+        if isinstance(path, str)
+    })
+    removed = sorted({
+        path
+        for result in surface_results
+        for path in result.get("removed_paths", [])
+        if isinstance(path, str)
+    })
+    surface_errors = [
+        result
+        for result in surface_results
+        if not result.get("ok", False) and result.get("supported", True)
+    ]
+    errors = [*surface_errors, *provider_errors]
+    changed = bool(written or removed or any(result.get("changed") for result in surface_results))
+    summary: dict[str, object] = {
+        "ok": not errors,
+        "mode": mode,
+        "project_root": str(project_root),
+        "changed": changed,
+        "message": (
+            "Configuration refreshed."
+            if changed and mode == "apply"
+            else "Configuration is already synchronized."
+            if mode == "apply"
+            else "Configuration is already clean."
+            if not changed
+            else "Configuration cleaned."
+        ),
+    }
+    if written:
+        summary["written_paths"] = written
+    if removed:
+        summary["removed_paths"] = removed
+    if errors:
+        summary["errors"] = errors
+    return summary
+
+
+def _config_operation(project_root: Path, *, mode: str, clean_runtime: bool) -> int:
+    """Run an ownership-aware config operation and report partial failures."""
+    target = global_harness_runtime()
+    from audiagentic.components.providers import providers_api
+    from audiagentic.components.providers.services.mcp.mcp_sync import (
+        sync_all_provider_mcp_servers,
+    )
+
+    output: dict[str, object] = {"ok": True, "mode": mode, "project_root": str(project_root)}
+    try:
+        surface_results = _surface_results_to_json(
+            providers_api.operate_provider_surfaces(project_root, mode=mode)
+        )
+        provider_errors = sync_all_provider_mcp_servers(project_root)
+        if clean_runtime:
+            cleanup_runtime(target)
+        else:
+            refresh_materialized_agent_config(target, project_root=project_root)
+        request_runtime_reload(project_root, reason=f"config-{mode}")
+    except Exception as exc:  # noqa: BLE001
+        output["ok"] = False
+        output["errors"] = [str(exc)]
+        print_json(_omit_empty_values(output))
+        return 1
+
+    output = _config_summary(
+        mode=mode,
+        project_root=project_root,
+        surface_results=surface_results,
+        provider_errors=provider_errors,
+    )
+    print_json(_omit_empty_values(output))
+    return 0 if output["ok"] else 1
+
+
+def cmd_config_sync(args: argparse.Namespace, project_root: Path) -> int:
+    """Refresh all generated surfaces and configured provider configs."""
+    if args.config_cmd == "clean":
+        return cmd_config_clean(args, project_root)
+    return _config_operation(project_root, mode="apply", clean_runtime=False)
+
+
+def cmd_config_clean(args: argparse.Namespace, project_root: Path) -> int:
+    """Prune owned surfaces, synchronize stale provider entries, and clean runtime."""
+    del args
+    return _config_operation(project_root, mode="prune", clean_runtime=True)