docs: revamp README with hardware benchmarks and fix release packaging

- Rewrote README.md to highlight the sub-millisecond C-dispatcher, "God Mode" GPU IPC, and Rust FFI atomic swaps, stripping out outdated bloat.
- Added `_help.py` and `_help.h` to `MANIFEST.in` and `pyproject.toml` to ensure the static help text ships properly in the PyPI source distribution.
- Fixed a missing `is_interactive_session` import in `package_meta_builder.py`.
- Updated the `8pkg demo` CLI boundaries to correctly accept Option 11 (Daemon IPC Showcase).
- Updated Dependabot config to correctly exclude `licenses/` and `docker/` directories to prevent false-positive syntax crashes.

Modified:
  • src/omnipkg/cli.py (+1/-1 lines)
  • src/omnipkg/package_meta_builder.py (+1/-1 lines)
  • .github/dependabot.yml (+2/-7 lines)
  • .gitignore (+3/-0 lines)
  • MANIFEST.in (+4/-0 lines)
  • pyproject.toml (+3/-0 lines)
  • src/omnipkg/conda-recipes/meta-platforms.yaml (+11/-15 lines)
  • README.md (+311/-1547 lines)

[gitship-generated]

Author: 1minds3t

.github/dependabot.yml

@@ -6,11 +6,6 @@ updates:
       interval: "monthly"
     ignore:
       - dependency-name: "*"
-  - package-ecosystem: "pip"
-    directory: "/docker"
-    schedule:
-      interval: "monthly"
-    ignore:
-      - dependency-name: "*"
     exclude-paths:
-          - "licenses/**"
+      - "licenses/**"
+      - "docker/**"

.gitignore

@@ -210,6 +210,9 @@ src/omnipkg/_vendor/wheels/
 ci-wheel-cache/
 build/
 
+# help text artifact
+/home/minds3t/omnipkg/src/omnipkg/help.toml
+
 # Python cache
 __pycache__/
 *.pyc

MANIFEST.in

@@ -20,4 +20,8 @@ recursive-include src/tests *.py
 
 # Top-level module list
 include top_level.txt
-include build_hooks.py
+include build_hooks.py
+
+# help text
+include src/omnipkg/_help.py
+include src/omnipkg/_help.h

README.md

@@ -159,8 +159,11 @@ omnipkg = [
     "locales/**/*.mo",
     "locales/**/*.pot",
     "dispatcher.c",
+    "_help.h",
+    "_help.py",
 ]
 
+
 [tool.setuptools]
 # Old setuptools format (compatible with setuptools 50.x)
 license-files = ["LICENSE", "COMMERCIAL_LICENSE.md"]

pyproject.toml

@@ -1,5 +1,5 @@
 /* DO NOT EDIT — generated by dev_tools/gen_help.py from src/omnipkg/help.toml */
-/* source hash: af9d47a97c8d7a49  version: 3.3.5 */
+/* source hash: af9d47a97c8d7a49  version: 3.4.0 */
 #ifndef OMNIPKG_HELP_H
 #define OMNIPKG_HELP_H
 
@@ -53,7 +53,7 @@ static const char OMNIPKG_HELP_TEXT[] =
     "  daemon start|stop|status   manage background worker\n"
     "  run <script|cmd>           auto-healing script runner\n"
     "\n"
-    "Version: 3.3.5\n"
+    "Version: 3.4.0\n"
     "";
 
 static const char OMNIPKG_HELP_CONFIG[] =
@@ -349,6 +349,6 @@ static const char OMNIPKG_HELP_WEB[] =
     "\n"
     "";
 
-#define OMNIPKG_VERSION "3.3.5"
+#define OMNIPKG_VERSION "3.4.0"
 
 #endif /* OMNIPKG_HELP_H */

src/omnipkg/_help.h

@@ -1,5 +1,5 @@
 # DO NOT EDIT — generated by dev_tools/gen_help.py from src/omnipkg/help.toml
-# source hash: af9d47a97c8d7a49  version: 3.3.5
+# source hash: af9d47a97c8d7a49  version: 3.4.0
 """Help text for omnipkg/8pkg, generated from help.toml at build time.
 
 Import this module to get the pre-rendered help string without running
@@ -9,7 +9,7 @@
     print(HELP_TEXT)
 """
 
-VERSION: str = "3.3.5"
+VERSION: str = "3.4.0"
 
 HELP_TEXT: str = """\
 usage: 8pkg [-h] [-v] [--lang CODE] [--py VER] [-V] [-y] [-n] <command> ...
@@ -58,7 +58,7 @@
   daemon start|stop|status   manage background worker
   run <script|cmd>           auto-healing script runner
 
-Version: 3.3.5
+Version: 3.4.0
 """
 
 SUBCOMMAND_HELP: dict[str, str] = {

src/omnipkg/_help.py

@@ -2563,7 +2563,7 @@ def main():
                 non_interactive = not is_interactive_session()
 
                 if args.demo_id is not None:
-                    if not (1 <= args.demo_id <= 10):
+                    if not (1 <= args.demo_id <= 11):
                         safe_print(_("❌ Invalid demo ID {}. Choose 1-11.").format(args.demo_id))
                         return 1
                     response = str(args.demo_id)

src/omnipkg/cli.py

@@ -65,26 +65,22 @@ about:
   license: AGPL-3.0-only
   license_family: AGPL
   license_file: LICENSE
-  summary: 'The Ultimate Python Dependency Resolver. One environment. Infinite packages. Zero conflicts.'
+  summary: 'Zero-overhead Python runtime hypervisor for concurrent, multi-version orchestration.'
   description: |
-    OmniPkg is a distributed Python runtime hypervisor that enables concurrent,
-    zero-copy multi-framework orchestration across multiple Python versions and toolchains.
+    omnipkg is a persistent Python runtime hypervisor that executes conflicting package 
+    and interpreter versions concurrently within a single environment—in milliseconds.
 
-    Platform Support:
-    - Linux: x86_64, aarch64/ARM64, ppc64le
-    - macOS: x86_64 (Intel), arm64 (Apple Silicon)
-    - Windows: x86_64, ARM64
+    By separating the filesystem packaging structure from a persistent, memory-mapped 
+    runtime layer, omnipkg bypasses standard OS process-spawn constraints. 
 
     Key Features:
-    - Reproducible State Engine with deterministic environment lockfiles (export/sync exact states)
-    - Native C-Dispatcher: sub-millisecond command routing that bypasses Python startup overhead
-    - Microsecond package activation via warm daemon workers (~50μs)
-    - Persistent model tagging: keep full models loaded in memory and route commands repeatedly without reloads or 5-minute timeouts
-    - Support for Python 3.7 through 3.15 in a single environment (far beyond Conda’s typical 3.10–3.13/3.14 range)
-    - Concurrent multi-version package and interpreter loading
-    - True zero-copy tensor passing across different Python versions, PyTorch/CUDA versions, and frameworks — no JSON serialization or process boundaries required
+    - Zero-Overhead C-Dispatcher: Replaces the Python startup tax with a compiled C binary, routing commands via uint64_t word-loads in ~230µs.
+    - True Zero-Copy GPU IPC ("God Mode"): Passes raw cudaIpcMemHandle pointers between isolated PyTorch workers. Move tensors across PyTorch 1.x and 2.x instances in ~4.5ms without data ever leaving VRAM.
+    - Atomic Stash-Swaps via Rust FFI: Intercepts the `uv` installer's internal plan callbacks to atomically os.rename() directories in <1ms, creating instantly reversible environments.
+    - Deep ABI Parsing: Natively parses .so ELF sections to extract NPY_FEATURE_VERSION, automatically injecting the correct NumPy ABI bubble before C-extension initialization.
+    - Concurrent Python Interpreters: Hot-swap and execute across Python 3.7 through 3.15 simultaneously without containers or separate virtual environments.
 
-    Perfect for scientific computing, large model serving, and heterogeneous Python/CUDA workflows where maximum flexibility and minimal latency matter.
+    Perfect for scientific computing, heterogeneous PyTorch/CUDA workflows, and AI infrastructure where maximum dependency flexibility and minimal latency matter.
   doc_url: https://omnipkg.readthedocs.io/en/latest/
   dev_url: https://github.com/1minds3t/omnipkg
 

src/omnipkg/conda-recipes/meta-platforms.yaml

@@ -1,6 +1,6 @@
 from __future__ import annotations  # Python 3.6+ compatibility
 
-from omnipkg.common_utils import safe_print, _is_relative_to_win, _relative_to_win
+from omnipkg.common_utils import safe_print, _is_relative_to_win, _relative_to_win, is_interactive_session
 from omnipkg.i18n import _
 
 try: