rejox 0.1.0__tar.gz

rejox-0.1.0/.gitignore

@@ -0,0 +1,74 @@
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Python
+venv/
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+
+# Builds
+dist/
+build/
+*.tsbuildinfo
+# esbuild bundles of the Node workers (backend/scripts/bundle_workers.py)
+backend/src/rejox/_workers/
+
+# Playwright (E2E) — artifacts and generated fixtures
+test-results/
+playwright-report/
+playwright/.cache/
+frontend/e2e/fixtures/
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Editor / OS
+.DS_Store
+.idea/
+.vscode/
+*.swp
+
+# Claude Code local settings
+.claude
+
+# Uploads / working data
+uploads/
+tmp/
+
+# Rejox emission working directory
+.rejox-out/
+
+# Run workspaces (ingested uploads + emitted output, one dir per run)
+.rejox-workspaces/
+
+# AI resolution cache (local SQLite)
+*.sqlite3
+
+
+CLAUDE.md
+vibe.md
+reactjs-principles.md
+
+rejox-docs.md
+rejox-package-plan.md
+
+# Hardening diagnosis clones (throwaway)
+hardening-projects/
+
+# graphify knowledge graph (local)
+graphify-out/
+
+.gitattributes

rejox-0.1.0/LICENSE

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 Ashraf Jarabeah
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

rejox-0.1.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.5
+Name: rejox
+Version: 0.1.0
+Summary: Rejox — AI migration engineer: React → React Native. CLI + pipeline.
+Project-URL: Homepage, https://github.com/ashrafjr-n/REJOX
+Project-URL: Repository, https://github.com/ashrafjr-n/REJOX
+Project-URL: Issues, https://github.com/ashrafjr-n/REJOX/issues
+Project-URL: Changelog, https://github.com/ashrafjr-n/REJOX/blob/master/backend/CHANGELOG.md
+Author: Ashraf
+License-Expression: FSL-1.1-ALv2
+License-File: LICENSE
+Keywords: ast,cli,codemod,migration,react,react-native
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Requires-Dist: click<9,>=8.1
+Requires-Dist: google-genai<2,>=1.15.0
+Requires-Dist: pydantic<3,>=2.10
+Requires-Dist: rich<14,>=13.9.4
+Requires-Dist: typer<1,>=0.26.8
+Provides-Extra: dev
+Requires-Dist: httpx<1,>=0.28.1; extra == 'dev'
+Requires-Dist: pytest<9,>=8.3.4; extra == 'dev'
+Provides-Extra: server
+Requires-Dist: fastapi<1,>=0.115.6; extra == 'server'
+Requires-Dist: python-multipart<1,>=0.0.20; extra == 'server'
+Requires-Dist: redis<6,>=5.2.1; extra == 'server'
+Requires-Dist: rq<3,>=2.1.0; extra == 'server'
+Requires-Dist: uvicorn[standard]<1,>=0.34.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# rejox
+
+**AI-assisted migration from React (web) to React Native.** Rejox resolves by
+rules whatever rules can resolve, and invokes AI only where genuine reasoning
+is required — at most **one LLM call** per migration. It builds a knowledge
+graph of a React project, scores its migratability, plans the work, performs
+the migration with deterministic AST transforms, validates the output with the
+real toolchain (`tsc` + Metro), and hands back a working React Native project.
+
+See the [project repository](https://github.com/ashrafjr-n/REJOX) for the full
+docs, architecture notes and the web app. This README covers the `rejox` CLI
+as distributed on PyPI.
+
+## Install
+
+```bash
+uvx rejox migrate ./my-react-app       # try it without installing
+pip install rejox                      # or install the CLI
+```
+
+**Requirements:** Python 3.11+, and Node 20+ on `PATH` (the deterministic
+parser/codemod workers run in Node; `npm` is needed only if you're building
+from an sdist rather than a prebuilt wheel).
+
+`pip install rejox` installs the CLI only. The web service (FastAPI, job
+queue) is a separate extra:
+
+```bash
+pip install "rejox[server]"
+```
+
+## Usage
+
+```bash
+rejox doctor                     # checks Node 20+, npm and the worker bundles
+rejox migrate ./my-react-app
+```
+
+```
+rejox migrate <project-path> [--out <dir>] [--force] [--yes] [--no-validate] [--json]
+```
+
+| Flag | Meaning |
+| --- | --- |
+| `--out <dir>` | Where to write the React Native project (default: `./<project>-native`). |
+| `--force` | Write into `--out` even if it is not empty (files already there are kept). |
+| `--yes`, `-y`, `--no-input` | Accept every recommended answer without prompting. Implied when stdin is not a terminal. |
+| `--no-validate` | Skip the `tsc` + Metro validation stage (fast). |
+| `--json` | Print a machine-readable summary on stdout (progress goes to stderr). Implies `--no-input`. |
+
+`rejox --version` prints the version; `rejox --debug migrate …` shows the full
+traceback if Rejox itself fails.
+
+**Exit codes** — stable, for scripts and CI:
+
+| Code | Meaning |
+| --- | --- |
+| `0` | Migrated; validation passed (or was skipped with `--no-validate`). |
+| `1` | Migrated, but validation (`tsc` / Metro) failed. |
+| `2` | Usage error (bad flag, missing project, non-empty `--out` without `--force`). |
+| `3` | Environment: Node 20+, `npm` or a worker bundle is missing — run `rejox doctor`. |
+| `4` | Input refused: the project has no React components to migrate. |
+| `70` | Internal error in Rejox; re-run with `--debug` for the traceback. |
+
+## AI is optional
+
+Rejox makes **at most one LLM call** per migration — the navigator *shape*
+decision, the one genuine design judgment. Everything else is deterministic.
+
+- `GEMINI_API_KEY=…` → the real provider (Gemini, via `google-genai`) makes
+  that one call.
+- `REJOX_AI_PROVIDER=fake` → an offline provider makes it deterministically
+  (no network), useful for demos and CI.
+- Neither set → **AI disabled**: the navigator defaults to a stack and the
+  rest of the pipeline is unchanged. Rejox is fully usable with zero AI.
+
+If a build fails validation, a **repair loop** may send the offending line and
+its compiler/bundler diagnostic to the LLM (never the whole file), capped at
+two rounds. Your source code is never uploaded anywhere except in that one
+line-level repair prompt, and only when a `GEMINI_API_KEY` is set.
+
+## Where rejox writes
+
+Nothing is written inside the install directory. Run workspaces and the AI
+response cache live in `$XDG_CACHE_HOME/rejox` (`~/.cache/rejox` by default),
+overridable with `REJOX_WORKSPACE_ROOT` and `REJOX_AI_CACHE`.
+
+## Platforms
+
+Linux and macOS. Windows is not supported yet.
+
+## License
+
+[FSL-1.1-ALv2](https://github.com/ashrafjr-n/REJOX/blob/master/LICENSE) —
+free to use; converts to Apache-2.0 two years after each version's release.
+See [`CHANGELOG.md`](CHANGELOG.md) for release history.

rejox-0.1.0/README.md

@@ -0,0 +1,96 @@
+# rejox
+
+**AI-assisted migration from React (web) to React Native.** Rejox resolves by
+rules whatever rules can resolve, and invokes AI only where genuine reasoning
+is required — at most **one LLM call** per migration. It builds a knowledge
+graph of a React project, scores its migratability, plans the work, performs
+the migration with deterministic AST transforms, validates the output with the
+real toolchain (`tsc` + Metro), and hands back a working React Native project.
+
+See the [project repository](https://github.com/ashrafjr-n/REJOX) for the full
+docs, architecture notes and the web app. This README covers the `rejox` CLI
+as distributed on PyPI.
+
+## Install
+
+```bash
+uvx rejox migrate ./my-react-app       # try it without installing
+pip install rejox                      # or install the CLI
+```
+
+**Requirements:** Python 3.11+, and Node 20+ on `PATH` (the deterministic
+parser/codemod workers run in Node; `npm` is needed only if you're building
+from an sdist rather than a prebuilt wheel).
+
+`pip install rejox` installs the CLI only. The web service (FastAPI, job
+queue) is a separate extra:
+
+```bash
+pip install "rejox[server]"
+```
+
+## Usage
+
+```bash
+rejox doctor                     # checks Node 20+, npm and the worker bundles
+rejox migrate ./my-react-app
+```
+
+```
+rejox migrate <project-path> [--out <dir>] [--force] [--yes] [--no-validate] [--json]
+```
+
+| Flag | Meaning |
+| --- | --- |
+| `--out <dir>` | Where to write the React Native project (default: `./<project>-native`). |
+| `--force` | Write into `--out` even if it is not empty (files already there are kept). |
+| `--yes`, `-y`, `--no-input` | Accept every recommended answer without prompting. Implied when stdin is not a terminal. |
+| `--no-validate` | Skip the `tsc` + Metro validation stage (fast). |
+| `--json` | Print a machine-readable summary on stdout (progress goes to stderr). Implies `--no-input`. |
+
+`rejox --version` prints the version; `rejox --debug migrate …` shows the full
+traceback if Rejox itself fails.
+
+**Exit codes** — stable, for scripts and CI:
+
+| Code | Meaning |
+| --- | --- |
+| `0` | Migrated; validation passed (or was skipped with `--no-validate`). |
+| `1` | Migrated, but validation (`tsc` / Metro) failed. |
+| `2` | Usage error (bad flag, missing project, non-empty `--out` without `--force`). |
+| `3` | Environment: Node 20+, `npm` or a worker bundle is missing — run `rejox doctor`. |
+| `4` | Input refused: the project has no React components to migrate. |
+| `70` | Internal error in Rejox; re-run with `--debug` for the traceback. |
+
+## AI is optional
+
+Rejox makes **at most one LLM call** per migration — the navigator *shape*
+decision, the one genuine design judgment. Everything else is deterministic.
+
+- `GEMINI_API_KEY=…` → the real provider (Gemini, via `google-genai`) makes
+  that one call.
+- `REJOX_AI_PROVIDER=fake` → an offline provider makes it deterministically
+  (no network), useful for demos and CI.
+- Neither set → **AI disabled**: the navigator defaults to a stack and the
+  rest of the pipeline is unchanged. Rejox is fully usable with zero AI.
+
+If a build fails validation, a **repair loop** may send the offending line and
+its compiler/bundler diagnostic to the LLM (never the whole file), capped at
+two rounds. Your source code is never uploaded anywhere except in that one
+line-level repair prompt, and only when a `GEMINI_API_KEY` is set.
+
+## Where rejox writes
+
+Nothing is written inside the install directory. Run workspaces and the AI
+response cache live in `$XDG_CACHE_HOME/rejox` (`~/.cache/rejox` by default),
+overridable with `REJOX_WORKSPACE_ROOT` and `REJOX_AI_CACHE`.
+
+## Platforms
+
+Linux and macOS. Windows is not supported yet.
+
+## License
+
+[FSL-1.1-ALv2](https://github.com/ashrafjr-n/REJOX/blob/master/LICENSE) —
+free to use; converts to Apache-2.0 two years after each version's release.
+See [`CHANGELOG.md`](CHANGELOG.md) for release history.