Thank you for your interest in contributing to the PAXECT Polyglot Plugin.
This repository is part of the PAXECT Interface Ecosystem. All contributions must remain:
- Deterministic: no randomization or non-reproducible behavior
- Cross-language: compatible with the Polyglot bridge (Python, Node.js, Go, etc.)
- Platform-agnostic: must run on Linux, macOS, and Windows
- Dependency-free: no cloud calls or AI/ML frameworks allowed
- Secure: respect PAXECT Core’s privacy-by-default policy
Each change must preserve byte-identical behavior and remain consistent across all supported runtimes.
-
Fork this repository on GitHub Create your own fork to contribute safely.
-
Clone your fork locally
git clone https://github.com/<your-username>/paxect-polyglot-plugin.git cd paxect-polyglot-plugin
-
(Optional) Create and activate a virtual environment
python3 -m venv .venv source .venv/bin/activate -
Install dependencies
python3 -m pip install -r requirements.txt
-
Run basic verification
python3 demos/00_env_smoke.py
- Use pytest for all new tests (
tests/directory) - Keep tests deterministic and platform-neutral
- Validate both stdin/stdout and file-based behavior
- Avoid hardcoded paths — use
tempfilefor all test data
Example:
python3 -m pytest -v- Follow the naming pattern:
feature/<short-description>orfix/<issue-id> - Add a clear description and link to related issues
- Ensure all demos still pass (
python3 demos/10_polyglot_ci_verifier.py) - Code must pass static linting (flake8, black)
- Do not add third-party telemetry, analytics, or network dependencies
- Avoid AI-generated randomness, pseudo-learning, or heuristic behavior
- Each PR is automatically reviewed for deterministic compliance
- Issues: Bug reports, feature ideas, reproducibility feedback
- Discussions: Technical proposals or architecture debates
- Security: Please report privately to
security@paxect-team@outlook.com
All contributions fall under the Apache 2.0 License and are subject to PAXECT’s deterministic and audit-compliance policies.