lv24-opencode-consilium 1.10.0__tar.gz

lv24_opencode_consilium-1.10.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LevapVeeskela
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lv24_opencode_consilium-1.10.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: lv24-opencode-consilium
+Version: 1.10.0
+Summary: Python launcher for the lv24-opencode-consilium (Consilium) Node.js CLI
+Author: LevapVeeskela
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/LevapVeeskela/lv24-opencode-consilium
+Project-URL: Repository, https://github.com/LevapVeeskela/lv24-opencode-consilium
+Project-URL: Issues, https://github.com/LevapVeeskela/lv24-opencode-consilium/issues
+Project-URL: Documentation, https://github.com/LevapVeeskela/lv24-opencode-consilium/tree/master/docs
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# lv24-opencode-consilium (Python launcher)
+
+A thin Python launcher for **Consilium**, the multi-agent review and audit CLI
+for the [OpenCode](https://opencode.ai/) ecosystem. Consilium itself is a
+Node.js command-line tool published on npm as
+[`lv24-opencode-consilium`](https://www.npmjs.com/package/lv24-opencode-consilium).
+This package does not reimplement Consilium and does not bundle Node.js: the
+`consilium` command delegates to the npm package through `npx`.
+
+The npm package remains the canonical distribution. The PyPI package only
+contains this launcher.
+
+## Prerequisites
+
+- **Node.js 18 or newer**, including npm and npx
+  ([nodejs.org](https://nodejs.org/)).
+- The **OpenCode CLI** installed and available on `PATH`
+  ([OpenCode docs](https://opencode.ai/docs/)).
+- Network access on first run, or an npm cache that already contains the
+  requested package, because `npx` may download it.
+- Python 3.9 or newer.
+
+## Installation
+
+```bash
+pip install lv24-opencode-consilium
+```
+
+This installs two equivalent console scripts:
+
+- `consilium`
+- `lv24-opencode-consilium`
+
+## Usage
+
+```bash
+consilium --help
+consilium "review this repository"
+consilium review --model opencode/gpt-5
+```
+
+All arguments are forwarded unchanged to the npm CLI. The child process
+inherits the terminal, environment, and exit code. You can also run:
+
+```bash
+python -m lv24_opencode_consilium --help
+```
+
+If `npx` cannot be found, the launcher exits with code `127` and prints an
+installation hint. An interrupted run exits with code `130`.
+
+## Version pinning
+
+By default the launcher runs the npm package version matching its own version
+(currently `1.10.0`). Override it with `CONSILIUM_NPM_VERSION` to use any npm
+version or tag:
+
+```bash
+CONSILIUM_NPM_VERSION=latest consilium --help
+CONSILIUM_NPM_VERSION=1.9.0 consilium --help
+```
+
+PowerShell:
+
+```powershell
+$env:CONSILIUM_NPM_VERSION = "latest"; consilium --help
+```
+
+## Links
+
+- Main repository and documentation:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium>
+- Documentation:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium/tree/master/docs>
+- Issues:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium/issues>
+- npm package:
+  <https://www.npmjs.com/package/lv24-opencode-consilium>
+
+## License
+
+MIT

lv24_opencode_consilium-1.10.0/README.md

@@ -0,0 +1,82 @@
+# lv24-opencode-consilium (Python launcher)
+
+A thin Python launcher for **Consilium**, the multi-agent review and audit CLI
+for the [OpenCode](https://opencode.ai/) ecosystem. Consilium itself is a
+Node.js command-line tool published on npm as
+[`lv24-opencode-consilium`](https://www.npmjs.com/package/lv24-opencode-consilium).
+This package does not reimplement Consilium and does not bundle Node.js: the
+`consilium` command delegates to the npm package through `npx`.
+
+The npm package remains the canonical distribution. The PyPI package only
+contains this launcher.
+
+## Prerequisites
+
+- **Node.js 18 or newer**, including npm and npx
+  ([nodejs.org](https://nodejs.org/)).
+- The **OpenCode CLI** installed and available on `PATH`
+  ([OpenCode docs](https://opencode.ai/docs/)).
+- Network access on first run, or an npm cache that already contains the
+  requested package, because `npx` may download it.
+- Python 3.9 or newer.
+
+## Installation
+
+```bash
+pip install lv24-opencode-consilium
+```
+
+This installs two equivalent console scripts:
+
+- `consilium`
+- `lv24-opencode-consilium`
+
+## Usage
+
+```bash
+consilium --help
+consilium "review this repository"
+consilium review --model opencode/gpt-5
+```
+
+All arguments are forwarded unchanged to the npm CLI. The child process
+inherits the terminal, environment, and exit code. You can also run:
+
+```bash
+python -m lv24_opencode_consilium --help
+```
+
+If `npx` cannot be found, the launcher exits with code `127` and prints an
+installation hint. An interrupted run exits with code `130`.
+
+## Version pinning
+
+By default the launcher runs the npm package version matching its own version
+(currently `1.10.0`). Override it with `CONSILIUM_NPM_VERSION` to use any npm
+version or tag:
+
+```bash
+CONSILIUM_NPM_VERSION=latest consilium --help
+CONSILIUM_NPM_VERSION=1.9.0 consilium --help
+```
+
+PowerShell:
+
+```powershell
+$env:CONSILIUM_NPM_VERSION = "latest"; consilium --help
+```
+
+## Links
+
+- Main repository and documentation:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium>
+- Documentation:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium/tree/master/docs>
+- Issues:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium/issues>
+- npm package:
+  <https://www.npmjs.com/package/lv24-opencode-consilium>
+
+## License
+
+MIT

lv24_opencode_consilium-1.10.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lv24-opencode-consilium"
+version = "1.10.0"
+description = "Python launcher for the lv24-opencode-consilium (Consilium) Node.js CLI"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "LevapVeeskela" },
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/LevapVeeskela/lv24-opencode-consilium"
+Repository = "https://github.com/LevapVeeskela/lv24-opencode-consilium"
+Issues = "https://github.com/LevapVeeskela/lv24-opencode-consilium/issues"
+Documentation = "https://github.com/LevapVeeskela/lv24-opencode-consilium/tree/master/docs"
+
+[project.scripts]
+consilium = "lv24_opencode_consilium.cli:main"
+lv24-opencode-consilium = "lv24_opencode_consilium.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

lv24_opencode_consilium-1.10.0/setup.cfg

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

lv24_opencode_consilium-1.10.0/src/lv24_opencode_consilium/__init__.py

@@ -0,0 +1,5 @@
+"""Python launcher for the Consilium Node.js CLI."""
+
+__version__ = "1.10.0"
+
+__all__ = ["__version__"]

lv24_opencode_consilium-1.10.0/src/lv24_opencode_consilium/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running the launcher with ``python -m lv24_opencode_consilium``."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

lv24_opencode_consilium-1.10.0/src/lv24_opencode_consilium/cli.py

@@ -0,0 +1,52 @@
+"""Command-line entry point that delegates to the npm Consilium CLI."""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+from typing import Optional, Sequence
+
+from . import __version__
+
+NPM_PACKAGE = "lv24-opencode-consilium"
+NPM_VERSION_ENV = "CONSILIUM_NPM_VERSION"
+
+_NPX_MISSING_MESSAGE = """\
+consilium: npx was not found on PATH.
+
+This package is a Python launcher for the Node.js Consilium CLI; it does not
+bundle Node.js. Install Node.js 18 or newer (npm and npx are included) from
+https://nodejs.org/ and make sure the OpenCode CLI is installed and available:
+https://opencode.ai/docs/
+"""
+
+
+def npm_spec() -> str:
+    """Return the npm package spec, honoring CONSILIUM_NPM_VERSION."""
+    version = os.environ.get(NPM_VERSION_ENV, "").strip() or __version__
+    return "{0}@{1}".format(NPM_PACKAGE, version)
+
+
+def main(argv: Optional[Sequence[str]] = None) -> int:
+    """Run the npm CLI through npx and return its exit code."""
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    npx = shutil.which("npx")
+    if npx is None:
+        sys.stderr.write(_NPX_MISSING_MESSAGE)
+        return 127
+
+    command = [npx, "--yes", npm_spec(), *args]
+
+    try:
+        completed = subprocess.run(command, check=False)
+        return completed.returncode
+    except KeyboardInterrupt:
+        return 130
+    except OSError as exc:
+        sys.stderr.write(
+            "consilium: failed to start {0}: {1}\n".format(npx, exc)
+        )
+        return 127

lv24_opencode_consilium-1.10.0/src/lv24_opencode_consilium.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: lv24-opencode-consilium
+Version: 1.10.0
+Summary: Python launcher for the lv24-opencode-consilium (Consilium) Node.js CLI
+Author: LevapVeeskela
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/LevapVeeskela/lv24-opencode-consilium
+Project-URL: Repository, https://github.com/LevapVeeskela/lv24-opencode-consilium
+Project-URL: Issues, https://github.com/LevapVeeskela/lv24-opencode-consilium/issues
+Project-URL: Documentation, https://github.com/LevapVeeskela/lv24-opencode-consilium/tree/master/docs
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# lv24-opencode-consilium (Python launcher)
+
+A thin Python launcher for **Consilium**, the multi-agent review and audit CLI
+for the [OpenCode](https://opencode.ai/) ecosystem. Consilium itself is a
+Node.js command-line tool published on npm as
+[`lv24-opencode-consilium`](https://www.npmjs.com/package/lv24-opencode-consilium).
+This package does not reimplement Consilium and does not bundle Node.js: the
+`consilium` command delegates to the npm package through `npx`.
+
+The npm package remains the canonical distribution. The PyPI package only
+contains this launcher.
+
+## Prerequisites
+
+- **Node.js 18 or newer**, including npm and npx
+  ([nodejs.org](https://nodejs.org/)).
+- The **OpenCode CLI** installed and available on `PATH`
+  ([OpenCode docs](https://opencode.ai/docs/)).
+- Network access on first run, or an npm cache that already contains the
+  requested package, because `npx` may download it.
+- Python 3.9 or newer.
+
+## Installation
+
+```bash
+pip install lv24-opencode-consilium
+```
+
+This installs two equivalent console scripts:
+
+- `consilium`
+- `lv24-opencode-consilium`
+
+## Usage
+
+```bash
+consilium --help
+consilium "review this repository"
+consilium review --model opencode/gpt-5
+```
+
+All arguments are forwarded unchanged to the npm CLI. The child process
+inherits the terminal, environment, and exit code. You can also run:
+
+```bash
+python -m lv24_opencode_consilium --help
+```
+
+If `npx` cannot be found, the launcher exits with code `127` and prints an
+installation hint. An interrupted run exits with code `130`.
+
+## Version pinning
+
+By default the launcher runs the npm package version matching its own version
+(currently `1.10.0`). Override it with `CONSILIUM_NPM_VERSION` to use any npm
+version or tag:
+
+```bash
+CONSILIUM_NPM_VERSION=latest consilium --help
+CONSILIUM_NPM_VERSION=1.9.0 consilium --help
+```
+
+PowerShell:
+
+```powershell
+$env:CONSILIUM_NPM_VERSION = "latest"; consilium --help
+```
+
+## Links
+
+- Main repository and documentation:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium>
+- Documentation:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium/tree/master/docs>
+- Issues:
+  <https://github.com/LevapVeeskela/lv24-opencode-consilium/issues>
+- npm package:
+  <https://www.npmjs.com/package/lv24-opencode-consilium>
+
+## License
+
+MIT

lv24_opencode_consilium-1.10.0/src/lv24_opencode_consilium.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/lv24_opencode_consilium/__init__.py
+src/lv24_opencode_consilium/__main__.py
+src/lv24_opencode_consilium/cli.py
+src/lv24_opencode_consilium.egg-info/PKG-INFO
+src/lv24_opencode_consilium.egg-info/SOURCES.txt
+src/lv24_opencode_consilium.egg-info/dependency_links.txt
+src/lv24_opencode_consilium.egg-info/entry_points.txt
+src/lv24_opencode_consilium.egg-info/top_level.txt
+tests/test_cli.py

lv24_opencode_consilium-1.10.0/src/lv24_opencode_consilium.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

lv24_opencode_consilium-1.10.0/src/lv24_opencode_consilium.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+consilium = lv24_opencode_consilium.cli:main
+lv24-opencode-consilium = lv24_opencode_consilium.cli:main

lv24_opencode_consilium-1.10.0/src/lv24_opencode_consilium.egg-info/top_level.txt

@@ -0,0 +1 @@
+lv24_opencode_consilium

lv24_opencode_consilium-1.10.0/tests/test_cli.py

@@ -0,0 +1,185 @@
+"""Tests for the Python launcher that delegates to the npm CLI."""
+
+from __future__ import annotations
+
+import contextlib
+import io
+import json
+import os
+import stat
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+from unittest import mock
+
+SRC_DIR = Path(__file__).resolve().parents[1] / "src"
+if str(SRC_DIR) not in sys.path:
+    sys.path.insert(0, str(SRC_DIR))
+
+from lv24_opencode_consilium import __version__
+from lv24_opencode_consilium.cli import NPM_PACKAGE, NPM_VERSION_ENV, main
+
+_FAKE_NPX = '''\
+import json
+import os
+import sys
+
+record = {
+    "argv": sys.argv[1:],
+    "env": {
+        key: value
+        for key, value in os.environ.items()
+        if key.startswith("CONSILIUM_") or key == "PATH"
+    },
+}
+with open(os.environ["CONSILIUM_TEST_LOG"], "a", encoding="utf-8") as handle:
+    handle.write(json.dumps(record, sort_keys=True) + "\\n")
+raise SystemExit(3)
+'''
+
+
+class MainTests(unittest.TestCase):
+    def setUp(self):
+        self._tempdir = tempfile.TemporaryDirectory()
+        self.addCleanup(self._tempdir.cleanup)
+        self.root = Path(self._tempdir.name)
+        self.bin_dir = self.root / "bin"
+        self.bin_dir.mkdir()
+        self.empty_dir = self.root / "empty"
+        self.empty_dir.mkdir()
+        self.log_path = self.root / "calls.jsonl"
+
+        self._saved_env = {
+            key: os.environ.get(key)
+            for key in ("CONSILIUM_NPM_VERSION", "CONSILIUM_TEST_LOG")
+        }
+        self.addCleanup(self._restore_env)
+        os.environ.pop("CONSILIUM_NPM_VERSION", None)
+        os.environ["CONSILIUM_TEST_LOG"] = str(self.log_path)
+
+        self._write_fake_npx()
+
+    def _restore_env(self):
+        for key, value in self._saved_env.items():
+            if value is None:
+                os.environ.pop(key, None)
+            else:
+                os.environ[key] = value
+
+    def _write_fake_npx(self):
+        script = self.bin_dir / "fake_npx.py"
+        script.write_text(_FAKE_NPX, encoding="utf-8")
+
+        if os.name == "nt":
+            launcher = self.bin_dir / "npx.cmd"
+            content = '@echo off\r\n"{0}" "%~dp0fake_npx.py" %*\r\n'.format(
+                sys.executable
+            )
+            with launcher.open("w", encoding="utf-8", newline="") as handle:
+                handle.write(content)
+        else:
+            launcher = self.bin_dir / "npx"
+            content = '#!/bin/sh\nexec "{0}" "$(dirname "$0")/fake_npx.py" "$@"\n'.format(
+                sys.executable
+            )
+            launcher.write_text(content, encoding="utf-8")
+            launcher.chmod(
+                launcher.stat().st_mode
+                | stat.S_IXUSR
+                | stat.S_IXGRP
+                | stat.S_IXOTH
+            )
+
+    def _invoke(self, args, *, env=None, path=None, cwd=None):
+        call_env = {
+            "PATH": str(self.bin_dir if path is None else path),
+            "CONSILIUM_TEST_LOG": str(self.log_path),
+        }
+        if os.name == "nt":
+            call_env["PATHEXT"] = ".COM;.EXE;.BAT;.CMD"
+        if env:
+            call_env.update(env)
+
+        stderr = io.StringIO()
+        previous_cwd = os.getcwd()
+        if cwd is not None:
+            os.chdir(cwd)
+        try:
+            with mock.patch.dict(os.environ, call_env, clear=False):
+                with contextlib.redirect_stderr(stderr):
+                    code = main(list(args))
+        finally:
+            if cwd is not None:
+                os.chdir(previous_cwd)
+        return code, stderr.getvalue()
+
+    def _calls(self):
+        if not self.log_path.exists():
+            return []
+        return [
+            json.loads(line)
+            for line in self.log_path.read_text(encoding="utf-8").splitlines()
+            if line
+        ]
+
+    def test_forwards_arguments_and_returns_child_exit_code(self):
+        code, stderr = self._invoke(["review", "the", "repo"])
+
+        self.assertEqual(code, 3)
+        self.assertEqual(stderr, "")
+        calls = self._calls()
+        self.assertEqual(len(calls), 1)
+        self.assertEqual(
+            calls[0]["argv"],
+            [
+                "--yes",
+                "{0}@{1}".format(NPM_PACKAGE, __version__),
+                "review",
+                "the",
+                "repo",
+            ],
+        )
+
+    def test_version_matches_expected_release(self):
+        self.assertEqual(__version__, "1.10.0")
+
+    def test_uses_env_override_and_inherits_it(self):
+        code, stderr = self._invoke(
+            ["--help"], env={NPM_VERSION_ENV: "latest"}
+        )
+
+        self.assertEqual(code, 3)
+        self.assertEqual(stderr, "")
+        call = self._calls()[0]
+        self.assertEqual(
+            call["argv"],
+            ["--yes", "{0}@latest".format(NPM_PACKAGE), "--help"],
+        )
+        self.assertEqual(call["env"][NPM_VERSION_ENV], "latest")
+
+    def test_missing_npx_returns_127_with_install_hint(self):
+        code, stderr = self._invoke(
+            [], path=self.empty_dir, cwd=self.empty_dir
+        )
+
+        self.assertEqual(code, 127)
+        self.assertIn("npx", stderr)
+        self.assertIn("Node.js", stderr)
+        self.assertIn("npm", stderr)
+        self.assertIn("OpenCode", stderr)
+        self.assertEqual(self._calls(), [])
+
+    def test_keyboard_interrupt_returns_130(self):
+        with mock.patch(
+            "lv24_opencode_consilium.cli.subprocess.run",
+            side_effect=KeyboardInterrupt,
+        ):
+            code, stderr = self._invoke([])
+
+        self.assertEqual(code, 130)
+        self.assertEqual(stderr, "")
+
+
+if __name__ == "__main__":
+    unittest.main()