agentic-coding-harness 0.7.1__tar.gz

agentic_coding_harness-0.7.1/.gitignore

@@ -0,0 +1,6 @@
+dist/
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+uv.lock

agentic_coding_harness-0.7.1/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.5
+Name: agentic-coding-harness
+Version: 0.7.1
+Summary: Run, watch, and meter Claude Code, Codex CLI, Gemini CLI, OpenCode, and Kiro from one CLI — verified cost tracking, token usage, budget caps, OTel gen_ai spans, Langfuse traces, and a live dashboard + MCP server.
+Project-URL: Homepage, https://github.com/sblattj/agentic-coding-harness
+Project-URL: Repository, https://github.com/sblattj/agentic-coding-harness
+Project-URL: Issues, https://github.com/sblattj/agentic-coding-harness/issues
+Author: Stephen Blatt
+License: MIT
+Keywords: agent-observability,ai-agents,claude-code,cli,codex-cli,coding-agent,cost-tracking,gemini-cli,kiro,langfuse,llm,mcp-server,opencode,opentelemetry,token-usage
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# agentic-coding-harness (Python wrapper)
+
+[![PyPI](https://img.shields.io/pypi/v/agentic-coding-harness)](https://pypi.org/project/agentic-coding-harness/)
+
+Run, watch, and meter coding agents from the command line. This Python
+package wraps the compiled `ach` CLI (vendored inside the wheel) and launches
+it with whatever JavaScript runtime you have installed — Bun if available,
+otherwise Node.js >= 18.19. No Python runtime dependencies; stdlib only.
+
+```sh
+# run without installing (the alias name matters for uvx)
+uvx agentic-coding-harness --help
+
+# or install
+uv tool install agentic-coding-harness
+ach --help
+```
+
+## Requirements
+
+- Python 3.9+
+- Bun or Node.js >= 18.19 on your PATH (or in the usual install dirs), or set
+  `AGENTIC_CODING_HARNESS_RUNTIME=/path/to/runtime` to force one.
+
+## What it does
+
+The console scripts `ach` and `agentic-coding-harness` both locate a JS
+runtime, then `exec` the vendored `ach.mjs` bundle with full argument, stdio,
+signal, and exit-code passthrough. If no runtime is found they print install
+instructions and exit 127.
+
+See the [project README](https://github.com/sblattj/agentic-coding-harness)
+for the full `ach` CLI documentation.

agentic_coding_harness-0.7.1/README.md

@@ -0,0 +1,33 @@
+# agentic-coding-harness (Python wrapper)
+
+[![PyPI](https://img.shields.io/pypi/v/agentic-coding-harness)](https://pypi.org/project/agentic-coding-harness/)
+
+Run, watch, and meter coding agents from the command line. This Python
+package wraps the compiled `ach` CLI (vendored inside the wheel) and launches
+it with whatever JavaScript runtime you have installed — Bun if available,
+otherwise Node.js >= 18.19. No Python runtime dependencies; stdlib only.
+
+```sh
+# run without installing (the alias name matters for uvx)
+uvx agentic-coding-harness --help
+
+# or install
+uv tool install agentic-coding-harness
+ach --help
+```
+
+## Requirements
+
+- Python 3.9+
+- Bun or Node.js >= 18.19 on your PATH (or in the usual install dirs), or set
+  `AGENTIC_CODING_HARNESS_RUNTIME=/path/to/runtime` to force one.
+
+## What it does
+
+The console scripts `ach` and `agentic-coding-harness` both locate a JS
+runtime, then `exec` the vendored `ach.mjs` bundle with full argument, stdio,
+signal, and exit-code passthrough. If no runtime is found they print install
+instructions and exit 127.
+
+See the [project README](https://github.com/sblattj/agentic-coding-harness)
+for the full `ach` CLI documentation.

agentic_coding_harness-0.7.1/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentic-coding-harness"
+version = "0.7.1"
+description = "Run, watch, and meter Claude Code, Codex CLI, Gemini CLI, OpenCode, and Kiro from one CLI — verified cost tracking, token usage, budget caps, OTel gen_ai spans, Langfuse traces, and a live dashboard + MCP server."
+keywords = ["claude-code", "codex-cli", "gemini-cli", "opencode", "kiro", "coding-agent", "agent-observability", "cost-tracking", "token-usage", "opentelemetry", "langfuse", "mcp-server", "llm", "ai-agents", "cli"]
+authors = [{ name = "Stephen Blatt" }]
+license = { text = "MIT" }
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = []
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/sblattj/agentic-coding-harness"
+Repository = "https://github.com/sblattj/agentic-coding-harness"
+Issues = "https://github.com/sblattj/agentic-coding-harness/issues"
+
+[project.scripts]
+ach = "agentic_coding_harness._cli:main"
+agentic-coding-harness = "agentic_coding_harness._cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentic_coding_harness"]
+artifacts = ["src/agentic_coding_harness/_vendor/ach.mjs"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/agentic_coding_harness",
+    "tests",
+    "README.md",
+    "pyproject.toml",
+]
+artifacts = ["src/agentic_coding_harness/_vendor/ach.mjs"]

agentic_coding_harness-0.7.1/src/agentic_coding_harness/__init__.py

@@ -0,0 +1,10 @@
+"""agentic-coding-harness: run/watch/meter coding agents.
+
+Python wrapper that locates a JavaScript runtime (Bun preferred, then
+Node.js >= 18.19) and execs the vendored ach.mjs CLI bundle with full
+argument passthrough.
+"""
+
+__version__ = "0.7.1"
+
+__all__ = ["__version__"]

agentic_coding_harness-0.7.1/src/agentic_coding_harness/_cli.py

@@ -0,0 +1,126 @@
+"""Console-script entry point: locate a JS runtime and exec the vendored ach.mjs.
+
+Stdlib only. Prefers Bun, then Node >= 18.19. The runtime may be forced via
+the AGENTIC_CODING_HARNESS_RUNTIME environment variable. On POSIX we execv so
+stdio, signals, and exit codes pass through untouched; on Windows we fall back
+to subprocess.call.
+"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+
+_PACKAGE_DIR = os.path.dirname(os.path.abspath(__file__))
+_BUNDLE = os.path.join(_PACKAGE_DIR, "_vendor", "ach.mjs")
+_RUNTIME_ENV = "AGENTIC_CODING_HARNESS_RUNTIME"
+
+_COMMON_DIRS = (
+    "/opt/homebrew/bin",
+    "/usr/local/bin",
+    os.path.expanduser("~/.bun/bin"),
+    os.path.expanduser("~/.volta/bin"),
+)
+
+_MISSING_RUNTIME_MESSAGE = """ach: no JavaScript runtime found.
+
+agentic-coding-harness needs Bun or Node.js (>= 18.19) to run.
+
+Install one of:
+  curl -fsSL https://bun.sh/install | bash      # Bun (recommended)
+  https://nodejs.org/en/download                 # Node.js >= 18.19
+
+Or point {env} at an existing runtime binary, e.g.:
+  export {env}=/usr/local/bin/node
+""".format(env=_RUNTIME_ENV)
+
+
+def _candidate_paths(name: str):
+    found = shutil.which(name)
+    if found:
+        yield found
+    seen = {found} if found else set()
+    for directory in _COMMON_DIRS:
+        candidate = os.path.join(directory, name)
+        if candidate not in seen and os.path.isfile(candidate) and os.access(candidate, os.X_OK):
+            seen.add(candidate)
+            yield candidate
+
+
+def _node_major_minor(path: str):
+    """Return (major, minor) for a node binary, or None if it can't be probed."""
+    try:
+        out = subprocess.run(
+            [path, "--version"],
+            capture_output=True,
+            text=True,
+            timeout=10,
+            check=False,
+        )
+    except (OSError, subprocess.SubprocessError):
+        return None
+    version = (out.stdout or "").strip().lstrip("v")
+    if not version:
+        return None
+    parts = version.split(".")
+    try:
+        return int(parts[0]), int(parts[1])
+    except (ValueError, IndexError):
+        return None
+
+
+def find_runtime(env=None):
+    """Return the path to a usable JS runtime, or None.
+
+    Honors AGENTIC_CODING_HARNESS_RUNTIME when set.
+    """
+    environ = env if env is not None else os.environ
+    override = environ.get(_RUNTIME_ENV)
+    if override:
+        if os.path.isfile(override) and os.access(override, os.X_OK):
+            return override
+        resolved = shutil.which(override)
+        if resolved:
+            return resolved
+        return None
+
+    for bun in _candidate_paths("bun"):
+        return bun
+
+    for node in _candidate_paths("node"):
+        version = _node_major_minor(node)
+        if version is None:
+            # Unprobeable (e.g. broken install) - skip rather than fail hard.
+            continue
+        major, minor = version
+        if (major, minor) >= (18, 19):
+            return node
+
+    return None
+
+
+def main(argv=None):
+    runtime = find_runtime()
+    if runtime is None:
+        sys.stderr.write(_MISSING_RUNTIME_MESSAGE)
+        return 127
+    if not os.path.isfile(_BUNDLE):
+        sys.stderr.write(
+            "ach: vendored bundle missing ({}). The install is broken; "
+            "reinstall agentic-coding-harness.\n".format(_BUNDLE)
+        )
+        return 127
+
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    if os.name == "posix":
+        os.execv(runtime, [runtime, _BUNDLE] + args)  # never returns
+        return 127  # pragma: no cover - execv failed to replace us
+
+    return subprocess.call([runtime, _BUNDLE] + args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())