vurnix 0.1.0__tar.gz

vurnix-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+dist/
+build/
+*.egg-info/
+.venv/
+node_modules/
+*.tgz
+.DS_Store

vurnix-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shiersa
+
+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.

vurnix-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: vurnix
+Version: 0.1.0
+Summary: Local-first software factory: deterministic multi-agent orchestration for small local models. Early development.
+Project-URL: Homepage, https://github.com/shiersa/vurnix
+Project-URL: Repository, https://github.com/shiersa/vurnix
+Author: shiersa
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,deterministic,local-llm,orchestration,software-factory
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Vurnix
+
+**A local-first software factory.** Deterministic multi-agent orchestration that turns
+small local models (12B-class, on your own hardware) into working software — end to end,
+from PRD to a clone-and-run repository.
+
+> **Status: early development (alpha).** This release reserves the `vurnix` CLI entry
+> point and ships an environment preflight. The pipeline lands in a later release.
+
+## Why Vurnix
+
+- **Weak-local-model first** — designed around small open-weight models running locally,
+  not frontier APIs. The orchestration layer, not model size, does the heavy lifting.
+- **Deterministic orchestration** — scheduling, gating, and verification are plain code:
+  same input, same build plan. LLMs write code; they don't run the factory.
+- **Self-evolving** — lessons and skills accumulate from every build and graduate into
+  deterministic checks over time.
+- **Fully autonomous** — PRD in, pushed clone-and-run repository out.
+
+## Install
+
+```sh
+pip install vurnix     # or: uv tool install vurnix
+```
+
+```sh
+vurnix info      # what this is
+vurnix doctor    # preflight your environment
+vurnix version
+```
+
+An `npm i -g vurnix` stub is also published to hold the name; the Python package is primary.
+
+## Roadmap
+
+- [ ] Pipeline release (build orchestration + verification gates)
+- [ ] Hub (observability)
+- [ ] Docs
+
+## License
+
+MIT — see [LICENSE](LICENSE). This covers the placeholder CLI; future components may
+ship under their own terms.

vurnix-0.1.0/README.md

@@ -0,0 +1,43 @@
+# Vurnix
+
+**A local-first software factory.** Deterministic multi-agent orchestration that turns
+small local models (12B-class, on your own hardware) into working software — end to end,
+from PRD to a clone-and-run repository.
+
+> **Status: early development (alpha).** This release reserves the `vurnix` CLI entry
+> point and ships an environment preflight. The pipeline lands in a later release.
+
+## Why Vurnix
+
+- **Weak-local-model first** — designed around small open-weight models running locally,
+  not frontier APIs. The orchestration layer, not model size, does the heavy lifting.
+- **Deterministic orchestration** — scheduling, gating, and verification are plain code:
+  same input, same build plan. LLMs write code; they don't run the factory.
+- **Self-evolving** — lessons and skills accumulate from every build and graduate into
+  deterministic checks over time.
+- **Fully autonomous** — PRD in, pushed clone-and-run repository out.
+
+## Install
+
+```sh
+pip install vurnix     # or: uv tool install vurnix
+```
+
+```sh
+vurnix info      # what this is
+vurnix doctor    # preflight your environment
+vurnix version
+```
+
+An `npm i -g vurnix` stub is also published to hold the name; the Python package is primary.
+
+## Roadmap
+
+- [ ] Pipeline release (build orchestration + verification gates)
+- [ ] Hub (observability)
+- [ ] Docs
+
+## License
+
+MIT — see [LICENSE](LICENSE). This covers the placeholder CLI; future components may
+ship under their own terms.

vurnix-0.1.0/npm/README.md

@@ -0,0 +1,8 @@
+# vurnix
+
+Name-holding stub for **Vurnix** — a local-first software factory: deterministic
+multi-agent orchestration for small local models. Early development.
+
+The Python package is the primary distribution: `pip install vurnix`.
+
+Home: https://github.com/shiersa/vurnix

vurnix-0.1.0/npm/bin/vurnix.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+const VERSION = "0.1.0";
+const HOME = "https://github.com/shiersa/vurnix";
+
+const cmd = process.argv[2];
+if (cmd === "version" || cmd === "--version" || cmd === "-v") {
+  console.log(`vurnix ${VERSION}`);
+} else {
+  console.log(
+    `Vurnix v${VERSION} (alpha) — local-first software factory.\n` +
+      `Deterministic multi-agent orchestration for small local models.\n\n` +
+      `The Python package is the primary distribution: pip install vurnix\n` +
+      `Home: ${HOME}`
+  );
+}

vurnix-0.1.0/npm/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "vurnix",
+  "version": "0.1.0",
+  "description": "Local-first software factory: deterministic multi-agent orchestration for small local models. Early development — placeholder CLI; the Python package is primary.",
+  "bin": { "vurnix": "bin/vurnix.js" },
+  "files": ["bin"],
+  "engines": { "node": ">=18" },
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/shiersa/vurnix.git" },
+  "homepage": "https://github.com/shiersa/vurnix",
+  "keywords": ["agents", "orchestration", "local-llm", "software-factory", "deterministic"]
+}

vurnix-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vurnix"
+version = "0.1.0"
+description = "Local-first software factory: deterministic multi-agent orchestration for small local models. Early development."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "shiersa" }]
+keywords = ["agents", "orchestration", "local-llm", "software-factory", "deterministic"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Build Tools",
+]
+
+[project.urls]
+Homepage = "https://github.com/shiersa/vurnix"
+Repository = "https://github.com/shiersa/vurnix"
+
+[project.scripts]
+vurnix = "vurnix.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vurnix"]

vurnix-0.1.0/src/vurnix/__init__.py

@@ -0,0 +1,3 @@
+"""Vurnix — local-first software factory (early development)."""
+
+__version__ = "0.1.0"

vurnix-0.1.0/src/vurnix/cli.py

@@ -0,0 +1,71 @@
+"""Vurnix command-line interface.
+
+This 0.1.x release reserves the ``vurnix`` entry point and ships an
+environment preflight; the pipeline lands in a later release.
+"""
+
+import argparse
+import shutil
+import sys
+
+from . import __version__
+
+REPO_URL = "https://github.com/shiersa/vurnix"
+
+INFO = f"""\
+Vurnix v{__version__} (alpha)
+
+A local-first software factory: deterministic multi-agent orchestration
+that turns small local models into working software, end to end.
+
+  - Deterministic pipeline: same input, same build plan, machine-checked gates
+  - Weak-local-model first: built for 12B-class models on your own hardware
+  - Self-evolving: lessons and skills accumulate and graduate into code
+
+Status: early development. This release reserves the CLI entry point;
+the pipeline lands in a later release.
+
+  Home: {REPO_URL}
+"""
+
+
+def doctor() -> int:
+    """Preflight the environment for the upcoming pipeline."""
+    git = shutil.which("git")
+    docker = shutil.which("docker")
+    checks = [
+        ("python >= 3.10", sys.version_info >= (3, 10), sys.version.split()[0]),
+        ("git", git is not None, git or "not found"),
+        ("docker (optional)", True, docker or "not found"),
+    ]
+    failed = False
+    for name, ok, detail in checks:
+        print(f"  [{'ok' if ok else 'MISSING':>7}] {name}: {detail}")
+        failed = failed or not ok
+    return 1 if failed else 0
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="vurnix",
+        description="Vurnix — local-first software factory (alpha).",
+    )
+    parser.add_argument("--version", action="version", version=f"vurnix {__version__}")
+    sub = parser.add_subparsers(dest="command")
+    sub.add_parser("version", help="print the version")
+    sub.add_parser("info", help="what Vurnix is and where it lives")
+    sub.add_parser("doctor", help="preflight checks for the upcoming pipeline")
+    args = parser.parse_args(argv)
+
+    if args.command == "version":
+        print(f"vurnix {__version__}")
+        return 0
+    if args.command == "doctor":
+        print(f"vurnix {__version__} preflight:")
+        return doctor()
+    print(INFO)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

vurnix-0.1.0/tests/test_cli.py

@@ -0,0 +1,23 @@
+from vurnix import __version__
+from vurnix.cli import main
+
+
+def test_version(capsys):
+    assert main(["version"]) == 0
+    assert capsys.readouterr().out.strip() == f"vurnix {__version__}"
+
+
+def test_info_points_home(capsys):
+    assert main(["info"]) == 0
+    assert "github.com/shiersa/vurnix" in capsys.readouterr().out
+
+
+def test_default_is_info(capsys):
+    assert main([]) == 0
+    assert "software factory" in capsys.readouterr().out
+
+
+def test_doctor_passes_where_git_exists(capsys):
+    assert main(["doctor"]) == 0
+    out = capsys.readouterr().out
+    assert "git" in out and "python" in out