hadara 0.2.0rc1__tar.gz

hadara-0.2.0rc1/.gitignore

@@ -0,0 +1,37 @@
+node_modules/
+dist/
+coverage/
+*.log
+dist-release/
+
+# HADARA portable/local state
+data/
+.hadara/local/
+.hadara/tmp/
+.hadara/cache/
+
+# OS/editor
+.DS_Store
+Thumbs.db
+.vscode/*
+!.vscode/extensions.json
+
+# dev only
+.env
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.venv/
+build/
+docs/specs/
+docs/design/mockups/*
+!docs/design/mockups/HADARA_web_ui_v0.1_comfort_dark.html
+.dockerignore
+
+.mockup/
+.agent_alpha_test/
+.mcp.json
+
+# Phase 5.6 dashboard visual baselines (generated)
+.dashboard-visual/

hadara-0.2.0rc1/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: hadara
+Version: 0.2.0rc1
+Summary: Python bridge package for HADARA. The current runtime requires Node.js.
+Project-URL: Homepage, https://github.com/ictseoyoungmin/HADARA-dev
+Project-URL: Source, https://github.com/ictseoyoungmin/HADARA-dev
+Project-URL: Issues, https://github.com/ictseoyoungmin/HADARA-dev/issues
+Author-email: study Y <yeeca0401@gmail.com>
+License-Expression: MIT
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# HADARA for Python
+
+This is a preview Python bridge package for HADARA.
+
+The current implementation delegates to the official Node.js HADARA runtime. It
+requires Node.js 22+ and `npx`.
+
+If you want the primary runtime, use:
+
+```bash
+npm install -g hadara@0.2.0-rc.1
+```
+
+Then run:
+
+```bash
+hadara doctor --json
+```
+
+## Install
+
+```bash
+pip install hadara
+```
+
+The installed `hadara` command is a Python console-script wrapper. It checks
+that Node.js 22+ and `npx` are available, then delegates to the pinned npm
+runtime:
+
+```bash
+npx -y hadara@0.2.0-rc.1 <args>
+```
+
+For example:
+
+```bash
+hadara --help
+hadara --version
+hadara doctor --json
+```
+
+## Missing Node.js
+
+If Node.js or `npx` is missing, the wrapper exits with code `127` and prints a
+clear setup message instead of failing with a Python traceback.
+
+Recommended setup:
+
+```bash
+npm install -g hadara@0.2.0-rc.1
+```
+
+## Scope
+
+This package is intentionally small:
+
+- It is not a Python-native HADARA runtime.
+- It does not publish npm packages, upload to PyPI, create releases, or run
+  installers.
+- It is a bridge package so Python users can discover the official HADARA CLI
+  path and use a familiar `pip install hadara` entry point.
+
+A Python-native runtime or SDK may be added later under modules such as
+`hadara.protocol`, `hadara.evidence`, or `hadara.handoff`.
+
+## Development
+
+Run these commands from the `python/` directory:
+
+```bash
+python -m pip install -U pip build twine pytest
+python -m pip install -e .
+python -m pytest
+python -m build
+python -m twine check dist/*
+```

hadara-0.2.0rc1/README.md

@@ -0,0 +1,76 @@
+# HADARA for Python
+
+This is a preview Python bridge package for HADARA.
+
+The current implementation delegates to the official Node.js HADARA runtime. It
+requires Node.js 22+ and `npx`.
+
+If you want the primary runtime, use:
+
+```bash
+npm install -g hadara@0.2.0-rc.1
+```
+
+Then run:
+
+```bash
+hadara doctor --json
+```
+
+## Install
+
+```bash
+pip install hadara
+```
+
+The installed `hadara` command is a Python console-script wrapper. It checks
+that Node.js 22+ and `npx` are available, then delegates to the pinned npm
+runtime:
+
+```bash
+npx -y hadara@0.2.0-rc.1 <args>
+```
+
+For example:
+
+```bash
+hadara --help
+hadara --version
+hadara doctor --json
+```
+
+## Missing Node.js
+
+If Node.js or `npx` is missing, the wrapper exits with code `127` and prints a
+clear setup message instead of failing with a Python traceback.
+
+Recommended setup:
+
+```bash
+npm install -g hadara@0.2.0-rc.1
+```
+
+## Scope
+
+This package is intentionally small:
+
+- It is not a Python-native HADARA runtime.
+- It does not publish npm packages, upload to PyPI, create releases, or run
+  installers.
+- It is a bridge package so Python users can discover the official HADARA CLI
+  path and use a familiar `pip install hadara` entry point.
+
+A Python-native runtime or SDK may be added later under modules such as
+`hadara.protocol`, `hadara.evidence`, or `hadara.handoff`.
+
+## Development
+
+Run these commands from the `python/` directory:
+
+```bash
+python -m pip install -U pip build twine pytest
+python -m pip install -e .
+python -m pytest
+python -m build
+python -m twine check dist/*
+```

hadara-0.2.0rc1/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hadara"
+version = "0.2.0rc1"
+description = "Python bridge package for HADARA. The current runtime requires Node.js."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  { name = "study Y", email = "yeeca0401@gmail.com" }
+]
+classifiers = [
+  "Development Status :: 2 - Pre-Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Software Development :: Build Tools"
+]
+
+[project.urls]
+Homepage = "https://github.com/ictseoyoungmin/HADARA-dev"
+Source = "https://github.com/ictseoyoungmin/HADARA-dev"
+Issues = "https://github.com/ictseoyoungmin/HADARA-dev/issues"
+
+[project.scripts]
+hadara = "hadara.cli:main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

hadara-0.2.0rc1/src/hadara/__init__.py

@@ -0,0 +1,11 @@
+"""Preview Python bridge package for HADARA.
+
+The package currently delegates command execution to the official Node.js
+HADARA runtime. It exists so Python users have an official package name and a
+clear path to the primary CLI while Python-native modules are still future
+work.
+"""
+
+from .version import NPM_RUNTIME_SPEC, __version__
+
+__all__ = ["NPM_RUNTIME_SPEC", "__version__"]

hadara-0.2.0rc1/src/hadara/bridge.py

@@ -0,0 +1,27 @@
+"""Helpers for bridging Python console entry points to the HADARA npm CLI.
+
+The first PyPI preview intentionally avoids resolving a global ``hadara``
+binary. A Python console-script named ``hadara`` may point back to this package,
+so blindly executing ``shutil.which("hadara")`` can recurse into the wrapper.
+The bridge therefore uses a pinned ``npx`` invocation until a later release can
+implement and test safe self-wrapper exclusion.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+from .version import NPM_RUNTIME_SPEC
+
+
+def build_npx_command(args: Sequence[str]) -> list[str]:
+    """Return the subprocess command used to invoke the Node.js runtime.
+
+    Args:
+        args: CLI arguments that should be forwarded to HADARA.
+
+    Returns:
+        A command list suitable for ``subprocess.call``.
+    """
+
+    return ["npx", "-y", NPM_RUNTIME_SPEC, *args]

hadara-0.2.0rc1/src/hadara/cli.py

@@ -0,0 +1,93 @@
+"""Console entry point for the HADARA Python bridge.
+
+The ``hadara`` command installed by this package is a small, friendly wrapper
+around the official Node.js runtime. It validates that Node.js 22+ and ``npx``
+are available, emits a clear setup message when they are not, and otherwise
+delegates all arguments to the pinned npm release.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+import shutil
+import subprocess
+import sys
+
+from .bridge import build_npx_command
+from .version import MINIMUM_NODE_MAJOR, MINIMUM_NODE_VERSION, NPM_RUNTIME_SPEC
+
+
+MISSING_RUNTIME_MESSAGE = f"""HADARA Python package is currently a bridge to the official Node.js runtime.
+
+Node.js {MINIMUM_NODE_VERSION}+ and npx are required for this preview release.
+
+Recommended install:
+  npm install -g {NPM_RUNTIME_SPEC}
+
+Then run:
+  hadara doctor --json
+
+A Python-native runtime is planned.
+"""
+
+
+def _detect_node_major_version(node_path: str) -> int | None:
+    """Return the Node.js major version for a resolved executable path.
+
+    The bridge intentionally keeps this probe small and side-effect-free:
+    ``node --version`` should only print a version string such as ``v22.16.0``.
+    If the executable cannot run or prints an unexpected value, ``None`` is
+    returned so the caller can fail with the same friendly setup message.
+    """
+
+    try:
+        output = subprocess.check_output(
+            [node_path, "--version"],
+            stderr=subprocess.DEVNULL,
+            text=True,
+            timeout=2,
+        )
+    except (OSError, subprocess.SubprocessError):
+        return None
+
+    version = output.strip()
+    if version.startswith("v"):
+        version = version[1:]
+
+    major_text = version.split(".", 1)[0]
+    if not major_text.isdigit():
+        return None
+
+    return int(major_text)
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """Run HADARA through the official npm runtime.
+
+    Args:
+        argv: Optional argument sequence. When omitted, ``sys.argv[1:]`` is
+            forwarded.
+
+    Returns:
+        The subprocess exit code, or ``127`` when Node.js 22+/npx are
+        unavailable.
+    """
+
+    forwarded_args = list(sys.argv[1:] if argv is None else argv)
+    node = shutil.which("node")
+    npx = shutil.which("npx")
+
+    if node is None or npx is None:
+        print(MISSING_RUNTIME_MESSAGE, file=sys.stderr, end="")
+        return 127
+
+    node_major_version = _detect_node_major_version(node)
+    if node_major_version is None or node_major_version < MINIMUM_NODE_MAJOR:
+        print(MISSING_RUNTIME_MESSAGE, file=sys.stderr, end="")
+        return 127
+
+    return subprocess.call(build_npx_command(forwarded_args))
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

hadara-0.2.0rc1/src/hadara/version.py

@@ -0,0 +1,7 @@
+"""Version constants for the HADARA Python bridge preview."""
+
+__version__ = "0.2.0rc1"
+
+MINIMUM_NODE_MAJOR = 22
+MINIMUM_NODE_VERSION = str(MINIMUM_NODE_MAJOR)
+NPM_RUNTIME_SPEC = "hadara@0.2.0-rc.1"

hadara-0.2.0rc1/tests/test_bridge.py

@@ -0,0 +1,11 @@
+from hadara.bridge import build_npx_command
+
+
+def test_build_npx_command_pins_current_rc_runtime() -> None:
+    assert build_npx_command(["doctor", "--json"]) == [
+        "npx",
+        "-y",
+        "hadara@0.2.0-rc.1",
+        "doctor",
+        "--json",
+    ]

hadara-0.2.0rc1/tests/test_cli.py

@@ -0,0 +1,91 @@
+from __future__ import annotations
+
+import subprocess
+
+import pytest
+
+from hadara import __version__
+from hadara import cli
+
+
+def test_version_is_python_bridge_preview() -> None:
+    assert __version__ == "0.2.0rc1"
+
+
+def test_main_prints_friendly_message_when_node_is_missing(
+    monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixture[str]
+) -> None:
+    monkeypatch.setattr(cli.shutil, "which", lambda name: None)
+
+    result = cli.main(["doctor", "--json"])
+
+    captured = capsys.readouterr()
+    assert result == 127
+    assert captured.out == ""
+    assert "bridge to the official Node.js runtime" in captured.err
+    assert "Node.js 22+ and npx are required" in captured.err
+    assert "npm install -g hadara@0.2.0-rc.1" in captured.err
+    assert "A Python-native runtime is planned." in captured.err
+
+
+def test_main_prints_friendly_message_when_npx_is_missing(
+    monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixture[str]
+) -> None:
+    def fake_which(name: str) -> str | None:
+        return "/usr/bin/node" if name == "node" else None
+
+    monkeypatch.setattr(cli.shutil, "which", fake_which)
+
+    result = cli.main(["--help"])
+
+    captured = capsys.readouterr()
+    assert result == 127
+    assert "Node.js 22+ and npx are required" in captured.err
+
+
+def test_main_prints_friendly_message_when_node_is_too_old(
+    monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixture[str]
+) -> None:
+    def fake_which(name: str) -> str | None:
+        return f"/usr/bin/{name}" if name in {"node", "npx"} else None
+
+    monkeypatch.setattr(cli.shutil, "which", fake_which)
+    monkeypatch.setattr(cli, "_detect_node_major_version", lambda node_path: 20)
+
+    result = cli.main(["doctor", "--json"])
+
+    captured = capsys.readouterr()
+    assert result == 127
+    assert "Node.js 22+ and npx are required" in captured.err
+
+
+def test_main_delegates_to_pinned_npx_runtime(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    calls: list[list[str]] = []
+
+    def fake_which(name: str) -> str | None:
+        return f"/usr/bin/{name}" if name in {"node", "npx"} else None
+
+    def fake_call(command: list[str]) -> int:
+        calls.append(command)
+        return 0
+
+    monkeypatch.setattr(cli.shutil, "which", fake_which)
+    monkeypatch.setattr(cli, "_detect_node_major_version", lambda node_path: 22)
+    monkeypatch.setattr(subprocess, "call", fake_call)
+
+    result = cli.main(["doctor", "--json"])
+
+    assert result == 0
+    assert calls == [["npx", "-y", "hadara@0.2.0-rc.1", "doctor", "--json"]]
+
+
+def test_main_propagates_subprocess_exit_code(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    monkeypatch.setattr(cli.shutil, "which", lambda name: f"/usr/bin/{name}")
+    monkeypatch.setattr(cli, "_detect_node_major_version", lambda node_path: 22)
+    monkeypatch.setattr(subprocess, "call", lambda command: 6)
+
+    assert cli.main(["release", "gate", "--json"]) == 6