cox-protocol-package 1.0.0 → 1.0.2

package/README.md

@@ -151,7 +151,8 @@ Check the NPM package contents before publishing:
 ```bash
 npm pack --dry-run
 npm pack
-npm install -g ./cox-protocol-package-1.0.0.tgz
+npm install -g ./cox-protocol-package-<version>.tgz
+python3 -m pip install PyYAML jsonschema typer rich
 cox-protocol validate .
 ```
 

package/bin/cox-protocol.js

@@ -14,6 +14,40 @@ const pythonEnv = {
   PYTHONPATH: pythonPath,
 };
 
+const versionCheck = spawnSync(
+  python,
+  [
+    "-c",
+    "import sys; print('.'.join(map(str, sys.version_info[:3]))); raise SystemExit(0 if sys.version_info >= (3, 9) else 1)",
+  ],
+  {
+    cwd: process.cwd(),
+    env: pythonEnv,
+    stdio: "pipe",
+  },
+);
+
+if (versionCheck.error) {
+  console.error(
+    `Unable to run the configured Python interpreter ${python}: ${versionCheck.error.message}`,
+  );
+  console.error(
+    "Install Python 3.9 or newer, or set COX_PYTHON to a working interpreter.",
+  );
+  process.exit(1);
+}
+
+if (versionCheck.status !== 0) {
+  const detectedVersion = versionCheck.stdout.toString().trim() || "unknown";
+  console.error(
+    `COX requires Python 3.9 or newer, but ${python} resolved to ${detectedVersion}.`,
+  );
+  console.error(
+    "Install Python 3.9+ or point COX_PYTHON at a supported interpreter.",
+  );
+  process.exit(versionCheck.status ?? 1);
+}
+
 const dependencyCheck = spawnSync(
   python,
   ["-c", "import typer, yaml, jsonschema, rich"],
@@ -24,6 +58,16 @@ const dependencyCheck = spawnSync(
   },
 );
 
+if (dependencyCheck.error) {
+  console.error(
+    `Unable to run the configured Python interpreter ${python}: ${dependencyCheck.error.message}`,
+  );
+  console.error(
+    "Install Python 3.9+ or point COX_PYTHON at a working interpreter.",
+  );
+  process.exit(1);
+}
+
 if (dependencyCheck.status !== 0) {
   console.error(
     `Python dependencies for COX are missing in ${python}.`,

package/guides/npm-installation.md

@@ -4,7 +4,7 @@ This package ships an NPM command named `cox-protocol`. The command delegates to
 
 If the target machine has multiple Python installations, set `COX_PYTHON` to the interpreter that has the COX dependencies installed.
 
-> Note: This NPM package installs the `cox-protocol` command wrapper and the COX package files. The target machine must also have Python 3.10+ and the required Python packages:
+> Note: This NPM package installs the `cox-protocol` command wrapper and the COX package files. The target machine must also have Python 3.9+ and the required Python packages:
 >
 > ```bash
 > python3 -m pip install PyYAML jsonschema typer rich
@@ -19,7 +19,7 @@ If the target machine has multiple Python installations, set `COX_PYTHON` to the
 ## Prerequisites
 
 - Node.js 18 or newer
-- Python 3.10 or newer
+- Python 3.9 or newer
 - `pip` available for the Python interpreter you want COX to use
 - An npm account with two-factor authentication or an appropriate granular publishing token
 
@@ -32,11 +32,11 @@ The publish metadata should include:
 ```json
 {
   "name": "cox-protocol-package",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "NPM wrapper and distribution package for the COX protocol CLI.",
   "license": "MIT",
   "bin": {
-    "cox-protocol": "./bin/cox-protocol.js"
+    "cox-protocol": "bin/cox-protocol.js"
   },
   "files": [
     "bin",
@@ -79,7 +79,7 @@ npm view cox-protocol-package
 
 If npm returns package info, the name is already taken. If it returns a 404, the name can be used.
 
-As of the last local check for this package, both `cox-protocol-package` and `cox-protocol` returned no package version from `npm view`, so either name appeared available. Recheck immediately before publishing because npm names can be claimed at any time.
+For this repository, `cox-protocol-package` is already in use. That is expected once the package has been published. For updates, keep the name and publish a new version.
 
 A shorter public name may be better if it is available:
 
@@ -124,7 +124,7 @@ Then create and inspect the actual tarball:
 
 ```bash
 npm pack
-tar -tzf cox-protocol-package-1.0.0.tgz
+tar -tzf cox-protocol-package-<version>.tgz
 ```
 
 Confirm the tarball includes:
@@ -150,7 +150,7 @@ Confirm it does not include:
 From another temporary folder:
 
 ```bash
-npm install -g /path/to/cox-protocol-package-1.0.0.tgz
+npm install -g /path/to/cox-protocol-package-<version>.tgz
 python3 -m pip install PyYAML jsonschema typer rich
 cox-protocol --help
 ```
@@ -223,10 +223,10 @@ On the development machine, create the tarball:
 npm pack
 ```
 
-Copy `cox-protocol-package-1.0.0.tgz` to the other device, then install it there:
+Copy `cox-protocol-package-<version>.tgz` to the other device, then install it there:
 
 ```bash
-npm install -g ./cox-protocol-package-1.0.0.tgz
+npm install -g ./cox-protocol-package-<version>.tgz
 python3 -m pip install PyYAML jsonschema typer rich
 ```
 
@@ -284,7 +284,7 @@ npm login
 npm whoami
 npm pack --dry-run
 npm pack
-npm install -g ./cox-protocol-package-1.0.0.tgz
+npm install -g ./cox-protocol-package-<version>.tgz
 python3 -m pip install PyYAML jsonschema typer rich
 cox-protocol --help
 npm publish

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "cox-protocol-package",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "NPM wrapper and distribution package for the COX protocol CLI.",
   "license": "MIT",
   "type": "module",
   "bin": {
-    "cox-protocol": "./bin/cox-protocol.js"
+    "cox-protocol": "bin/cox-protocol.js"
   },
   "files": [
     "bin",

package/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cox-protocol-package"
-version = "1.0.0"
+version = "1.0.1"
 description = "Validator and compiler for COX design-spec documents"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.9"
 license = { file = "LICENSE" }
 authors = [
   { name = "Charbel Malo" },
@@ -26,6 +26,7 @@ classifiers = [
   "Intended Audience :: Developers",
   "License :: OSI Approved :: MIT License",
   "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",

package/tools/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "1.0.0"
+__version__ = "1.0.1"

package/tools/cox_lib.py

@@ -10,6 +10,8 @@ from typing import Any, Sequence
 import yaml  # type: ignore[import-untyped]
 from jsonschema import Draft202012Validator  # type: ignore[import-untyped]
 
+from . import __version__
+
 
 SCHEMA_FILENAMES = {
     "cox.manifest.v1": "cox.manifest.v1.schema.json",
@@ -26,7 +28,7 @@ class CoxError(RuntimeError):
     """Raised when COX validation or compilation fails."""
 
 
-@dataclass(slots=True)
+@dataclass
 class ValidationSummary:
     project_root: Path
     manifest_path: Path
@@ -516,7 +518,7 @@ def compile_project(
         )
 
     manifest_payload = {
-        "compiledWith": "cox 1.0.0",
+        "compiledWith": f"cox {__version__}",
         "mimeType": "application/vnd.cox+yaml",
         "targets": compile_targets,
         "manifest": summary.documents[summary.manifest_path],

package/tools/package_target.py

@@ -6,6 +6,7 @@ import zipfile
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Iterable
 
+from . import __version__
 from .cox_lib import relative_path
 
 
@@ -162,7 +163,7 @@ def emit_package_archive(
         )
 
     package_manifest = {
-        "generatedWith": "cox 1.0.0",
+        "generatedWith": f"cox {__version__}",
         "deterministic": True,
         "archiveRoot": archive_root,
         "projectName": summary.documents[summary.manifest_path].get(

package/tools/react_target.py

@@ -5,6 +5,7 @@ import os
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
+from . import __version__
 
 if TYPE_CHECKING:
     from .cox_lib import ValidationSummary
@@ -257,7 +258,7 @@ def emit_react_stubs(
     write_text(react_root / "index.ts", "\n".join(barrel_lines) + "\n")
 
     manifest_payload = {
-        "generatedWith": "cox 1.0.0",
+        "generatedWith": f"cox {__version__}",
         "target": "react",
         "components": sorted(
             component_records.values(),