praisonai-code 0.0.2__tar.gz → 0.0.4__tar.gz

{praisonai_code-0.0.2 → praisonai_code-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: praisonai-code
-Version: 0.0.2
+Version: 0.0.4
 Summary: Agentic terminal CLI for PraisonAI — the terminal-native agent (run, chat, code, runtime, cli backends) extracted from the praisonai wrapper.
 Author: Mervin Praison
 License: MIT
@@ -30,19 +30,18 @@ Agentic terminal CLI for PraisonAI — the terminal-native agent product
 
 ## Status
 
-Migration in progress. `runtime/` and `cli_backends/` have moved into
-`praisonai_code` (step C1); the remaining terminal-agent modules follow
-incrementally in steps C2–C6 (see issue #2512):
+**C0–C5 complete.** C6 integration gate verified — see
+`src/praisonai/tests/C6_VERIFICATION.md`.
 
-| Step | Scope |
-|------|-------|
-| C0 | Scaffold |
-| C1 | `runtime/` + `cli_backends/` |
-| C2 | `interactive/`, `execution/`, `ui/`, `output/`, `state/` |
-| C3 | Agentic commands |
-| C4 | Agentic features |
-| C5 | `main.py`, `app.py`, config/session/utils + shims |
-| C6 | Integration gate |
+| Step | Scope | Status |
+|------|-------|--------|
+| C0 | Scaffold | Done |
+| C1 | `runtime/` + `cli_backends/` | Done |
+| C2 | `interactive/`, `execution/`, `ui/`, `output/`, `state/` | Done |
+| C3 | Agentic commands | Done |
+| C4 | Agentic features | Done |
+| C5 | `main.py`, `app.py`, config/session/utils + shims | Done |
+| C6 | Integration gate + sign-off | Done |
 
 - `praisonai_code.runtime` — warm local runtime (daemon + thin client).
 - `praisonai_code.cli_backends` — CLI backend implementations (e.g. Claude Code).
@@ -58,24 +57,32 @@ praisonai-code    →  depends on  praisonaiagents (core SDK)
 click, textual, PyYAML, python-dotenv, litellm, mcp, pydantic — see
 `pyproject.toml`). The rules above govern the **inter-package** direction.
 
-> **Migration note (C1):** `cli_backends/registry.py` still imports
-> `PluginRegistry` from the `praisonai` main package (same "keep main-package
-> import" pattern as `runtime/descriptor.py`'s `from praisonai.version`).
-> `praisonai-code` is wired via an editable path dependency and `praisonai` is
-> always present at runtime during migration, so this residual back-import is a
-> deliberate C1 tradeoff to be removed in a later step — not a standalone-publish
-> guarantee yet.
+> **C7 note:** Some modules still import the `praisonai` wrapper at runtime
+> (~170 files). **Standalone `pip install praisonai-code` without `praisonai`
+> is not fully supported yet.** Use `pip install praisonai` for production.
+> Residual C1 back-imports: `runtime/descriptor.py` → `praisonai.version`;
+> `cli_backends/registry.py` → `praisonai._registry`.
 
 Backward compatibility is preserved via PEP 562 shims at the old
 `praisonai.*` import paths, so `pip install praisonai` and
 `from praisonai.cli.main import PraisonAI` keep working unchanged.
 
-## Install (development)
+## Install
+
+**Recommended (includes wrapper + bots/gateway):**
+
+```bash
+pip install praisonai
+```
+
+**Development / monorepo:**
 
 ```bash
+pip install -e src/praisonai-agents
 pip install -e src/praisonai-code
+pip install -e src/praisonai
 python -c "import praisonai_code; print(praisonai_code.__version__)"
 ```
 
-`praisonai-code` is **not** published standalone to PyPI during migration;
-`praisonai` remains the user-facing install.
+**PyPI:** Published as `praisonai-code` after `praisonaiagents` in the
+three-package release order (see `pypi-release.yml`).

{praisonai_code-0.0.2 → praisonai_code-0.0.4}/README.md

@@ -8,19 +8,18 @@ Agentic terminal CLI for PraisonAI — the terminal-native agent product
 
 ## Status
 
-Migration in progress. `runtime/` and `cli_backends/` have moved into
-`praisonai_code` (step C1); the remaining terminal-agent modules follow
-incrementally in steps C2–C6 (see issue #2512):
-
-| Step | Scope |
-|------|-------|
-| C0 | Scaffold |
-| C1 | `runtime/` + `cli_backends/` |
-| C2 | `interactive/`, `execution/`, `ui/`, `output/`, `state/` |
-| C3 | Agentic commands |
-| C4 | Agentic features |
-| C5 | `main.py`, `app.py`, config/session/utils + shims |
-| C6 | Integration gate |
+**C0–C5 complete.** C6 integration gate verified — see
+`src/praisonai/tests/C6_VERIFICATION.md`.
+
+| Step | Scope | Status |
+|------|-------|--------|
+| C0 | Scaffold | Done |
+| C1 | `runtime/` + `cli_backends/` | Done |
+| C2 | `interactive/`, `execution/`, `ui/`, `output/`, `state/` | Done |
+| C3 | Agentic commands | Done |
+| C4 | Agentic features | Done |
+| C5 | `main.py`, `app.py`, config/session/utils + shims | Done |
+| C6 | Integration gate + sign-off | Done |
 
 - `praisonai_code.runtime` — warm local runtime (daemon + thin client).
 - `praisonai_code.cli_backends` — CLI backend implementations (e.g. Claude Code).
@@ -36,24 +35,32 @@ praisonai-code    →  depends on  praisonaiagents (core SDK)
 click, textual, PyYAML, python-dotenv, litellm, mcp, pydantic — see
 `pyproject.toml`). The rules above govern the **inter-package** direction.
 
-> **Migration note (C1):** `cli_backends/registry.py` still imports
-> `PluginRegistry` from the `praisonai` main package (same "keep main-package
-> import" pattern as `runtime/descriptor.py`'s `from praisonai.version`).
-> `praisonai-code` is wired via an editable path dependency and `praisonai` is
-> always present at runtime during migration, so this residual back-import is a
-> deliberate C1 tradeoff to be removed in a later step — not a standalone-publish
-> guarantee yet.
+> **C7 note:** Some modules still import the `praisonai` wrapper at runtime
+> (~170 files). **Standalone `pip install praisonai-code` without `praisonai`
+> is not fully supported yet.** Use `pip install praisonai` for production.
+> Residual C1 back-imports: `runtime/descriptor.py` → `praisonai.version`;
+> `cli_backends/registry.py` → `praisonai._registry`.
 
 Backward compatibility is preserved via PEP 562 shims at the old
 `praisonai.*` import paths, so `pip install praisonai` and
 `from praisonai.cli.main import PraisonAI` keep working unchanged.
 
-## Install (development)
+## Install
+
+**Recommended (includes wrapper + bots/gateway):**
+
+```bash
+pip install praisonai
+```
+
+**Development / monorepo:**
 
 ```bash
+pip install -e src/praisonai-agents
 pip install -e src/praisonai-code
+pip install -e src/praisonai
 python -c "import praisonai_code; print(praisonai_code.__version__)"
 ```
 
-`praisonai-code` is **not** published standalone to PyPI during migration;
-`praisonai` remains the user-facing install.
+**PyPI:** Published as `praisonai-code` after `praisonaiagents` in the
+three-package release order (see `pypi-release.yml`).

{praisonai_code-0.0.2 → praisonai_code-0.0.4}/praisonai_code/cli/app.py

@@ -135,7 +135,6 @@ _LAZY_COMMANDS: Dict[str, Tuple[str, str, str]] = {
     "daemon": (".commands.daemon", "app", "Warm local runtime (keeps MCP/provider clients hot)"),
     "attach": (".commands.attach", "app", "Attach to a live session on the warm runtime"),
     "schedule": (".commands.schedule", "app", "Scheduler management"),
-    "kanban": (".commands.kanban", "app", "Kanban task management"),
     "run": (".commands.run", "app", "Run agents"),
     "checkpoint": (".commands.checkpoint", "app", "File-level checkpoint management (save/restore/diff)"),
     "profile": (".commands.profile", "app", "Performance profiling and diagnostics"),
@@ -184,24 +183,48 @@ _LAZY_COMMANDS: Dict[str, Tuple[str, str, str]] = {
     "github": (".commands.github", "app", "GitHub native context tracking and Issue triage"),
     "managed": (".commands.managed", "app", "Managed Agents (Anthropic cloud-hosted backend)"),
     "models": (".commands.models", "app", "List and describe available models"),
-    
-    # Moltbot-inspired commands
+
+    # Bot/channel commands — see ``_WRAPPER_COMMANDS`` below. These entries keep
+    # relative ``.commands.*`` paths so they are advertised in ``--help``, but
+    # ``get_command()`` re-routes them to the absolute ``praisonai.cli.commands.*``
+    # path at invocation time (the modules live in the main wrapper).
     "bot": (".commands.bot", "app", "Messaging bots with full agent capabilities"),
     "gateway": (".commands.gateway", "app", "Multi-bot WebSocket gateway server"),
     "pairing": (".commands.pairing", "app", "Manage bot user pairing"),
     "identity": (".commands.identity", "app", "Manage cross-platform user identity links"),
+    "kanban": (".commands.kanban", "app", "Kanban task management"),
+    "claw": (".commands.claw", "app", "🦞 PraisonAI Dashboard (full UI)"),
+    "dashboard": (".commands.dashboard", "app", "🌟 Unified Dashboard (Flow + Claw + UI)"),
+
     "browser": (".commands.browser", "app", "Browser control for agent automation"),
     "plugins": (".commands.plugins", "app", "Plugin management and inspection"),
     "sandbox": (".commands.sandbox", "app", "Sandbox container management"),
-    "claw": (".commands.claw", "app", "🦞 PraisonAI Dashboard (full UI)"),
     "flow": (".commands.flow", "app", "Visual workflow builder (Langflow)"),
-    "dashboard": (".commands.dashboard", "app", "🌟 Unified Dashboard (Flow + Claw + UI)"),
     "langfuse": (".commands.langfuse", "app", "🔍 Langfuse observability platform"),
     "langextract": (".commands.langextract", "app", "🧠 Langextract visual trace layer"),
     "port": (".commands.port", "app", "🔌 Manage port usage and resolve conflicts"),
     "up": (".commands.up", "app", "🚀 Start unified PraisonAI stack (Langfuse + Langflow)"),
 }
 
+# Bot/channel commands that intentionally stay in the main ``praisonai``
+# wrapper (they import ``praisonai.bots`` / ``praisonai.gateway``). Their
+# entries remain in ``_LAZY_COMMANDS`` above (so ``--help`` and command
+# discovery advertise them), but ``get_command()`` intercepts these names and
+# imports them via the *absolute* ``praisonai.cli.commands.*`` path — the
+# relative ``.commands.*`` path would resolve to ``praisonai_code`` where the
+# modules do not live. The import happens lazily at invocation time only, so
+# ``praisonai_code`` keeps no static dependency on ``praisonai``.
+_WRAPPER_COMMANDS = frozenset({
+    "bot",
+    "gateway",
+    "pairing",
+    "identity",
+    "onboard",
+    "kanban",
+    "dashboard",
+    "claw",
+})
+
 # Special commands that need custom handling
 _SPECIAL_COMMANDS = {
     "tui": (".features.tui.debug", "create_debug_app", "Interactive TUI and simulation"),
@@ -209,6 +232,12 @@ _SPECIAL_COMMANDS = {
 }
 
 
+def _wrapper_available() -> bool:
+    """Return True when the ``praisonai`` wrapper package is importable."""
+    import importlib.util as _importlib_util
+    return _importlib_util.find_spec("praisonai") is not None
+
+
 class LazyCommandGroup(TyperGroup):
     """Click Group that lazily loads subcommands from registry."""
     
@@ -217,8 +246,14 @@ class LazyCommandGroup(TyperGroup):
         # Start with commands from parent (already registered commands)
         commands = set(super().list_commands(ctx))
         
-        # Add lazy-loaded commands
-        commands.update(_LAZY_COMMANDS.keys())
+        # Add lazy-loaded commands. Wrapper-only commands are advertised only when
+        # the ``praisonai`` wrapper is installed, so a standalone ``praisonai-code``
+        # install does not surface commands it cannot resolve.
+        wrapper_ok = _wrapper_available()
+        commands.update(
+            name for name in _LAZY_COMMANDS
+            if wrapper_ok or name not in _WRAPPER_COMMANDS
+        )
         commands.update(_SPECIAL_COMMANDS.keys())
         
         # Add special inline commands
@@ -243,7 +278,12 @@ class LazyCommandGroup(TyperGroup):
         if name in _LAZY_COMMANDS:
             module_path, attr_name, _ = _LAZY_COMMANDS[name]
             try:
-                module = importlib.import_module(module_path, __package__)
+                if name in _WRAPPER_COMMANDS:
+                    if not _wrapper_available():
+                        return None
+                    module = importlib.import_module(f"praisonai.cli.commands.{name}")
+                else:
+                    module = importlib.import_module(module_path, __package__)
                 sub_app = getattr(module, attr_name)
                 if isinstance(sub_app, click.Command):
                     return sub_app
@@ -251,7 +291,7 @@ class LazyCommandGroup(TyperGroup):
             except (ImportError, AttributeError) as e:
                 typer.echo(f"Error loading command '{name}': {e}", err=True)
                 return None
-        
+
         # Check special commands
         if name in _SPECIAL_COMMANDS:
             module_path, func_name, _ = _SPECIAL_COMMANDS[name]
@@ -723,6 +763,8 @@ def get_command_names():
     commands that are not in ``_LAZY_COMMANDS`` are added explicitly.
     """
     names = set(_LAZY_COMMANDS.keys())
+    # Bot/channel commands are already part of ``_LAZY_COMMANDS`` (re-routed to
+    # the main wrapper at invocation time via ``_WRAPPER_COMMANDS``).
     # Special commands with custom handling (tui, queue)
     names.update(_SPECIAL_COMMANDS.keys())
     # Inline special commands handled outside the registries

{praisonai_code-0.0.2 → praisonai_code-0.0.4}/praisonai_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: praisonai-code
-Version: 0.0.2
+Version: 0.0.4
 Summary: Agentic terminal CLI for PraisonAI — the terminal-native agent (run, chat, code, runtime, cli backends) extracted from the praisonai wrapper.
 Author: Mervin Praison
 License: MIT
@@ -30,19 +30,18 @@ Agentic terminal CLI for PraisonAI — the terminal-native agent product
 
 ## Status
 
-Migration in progress. `runtime/` and `cli_backends/` have moved into
-`praisonai_code` (step C1); the remaining terminal-agent modules follow
-incrementally in steps C2–C6 (see issue #2512):
+**C0–C5 complete.** C6 integration gate verified — see
+`src/praisonai/tests/C6_VERIFICATION.md`.
 
-| Step | Scope |
-|------|-------|
-| C0 | Scaffold |
-| C1 | `runtime/` + `cli_backends/` |
-| C2 | `interactive/`, `execution/`, `ui/`, `output/`, `state/` |
-| C3 | Agentic commands |
-| C4 | Agentic features |
-| C5 | `main.py`, `app.py`, config/session/utils + shims |
-| C6 | Integration gate |
+| Step | Scope | Status |
+|------|-------|--------|
+| C0 | Scaffold | Done |
+| C1 | `runtime/` + `cli_backends/` | Done |
+| C2 | `interactive/`, `execution/`, `ui/`, `output/`, `state/` | Done |
+| C3 | Agentic commands | Done |
+| C4 | Agentic features | Done |
+| C5 | `main.py`, `app.py`, config/session/utils + shims | Done |
+| C6 | Integration gate + sign-off | Done |
 
 - `praisonai_code.runtime` — warm local runtime (daemon + thin client).
 - `praisonai_code.cli_backends` — CLI backend implementations (e.g. Claude Code).
@@ -58,24 +57,32 @@ praisonai-code    →  depends on  praisonaiagents (core SDK)
 click, textual, PyYAML, python-dotenv, litellm, mcp, pydantic — see
 `pyproject.toml`). The rules above govern the **inter-package** direction.
 
-> **Migration note (C1):** `cli_backends/registry.py` still imports
-> `PluginRegistry` from the `praisonai` main package (same "keep main-package
-> import" pattern as `runtime/descriptor.py`'s `from praisonai.version`).
-> `praisonai-code` is wired via an editable path dependency and `praisonai` is
-> always present at runtime during migration, so this residual back-import is a
-> deliberate C1 tradeoff to be removed in a later step — not a standalone-publish
-> guarantee yet.
+> **C7 note:** Some modules still import the `praisonai` wrapper at runtime
+> (~170 files). **Standalone `pip install praisonai-code` without `praisonai`
+> is not fully supported yet.** Use `pip install praisonai` for production.
+> Residual C1 back-imports: `runtime/descriptor.py` → `praisonai.version`;
+> `cli_backends/registry.py` → `praisonai._registry`.
 
 Backward compatibility is preserved via PEP 562 shims at the old
 `praisonai.*` import paths, so `pip install praisonai` and
 `from praisonai.cli.main import PraisonAI` keep working unchanged.
 
-## Install (development)
+## Install
+
+**Recommended (includes wrapper + bots/gateway):**
+
+```bash
+pip install praisonai
+```
+
+**Development / monorepo:**
 
 ```bash
+pip install -e src/praisonai-agents
 pip install -e src/praisonai-code
+pip install -e src/praisonai
 python -c "import praisonai_code; print(praisonai_code.__version__)"
 ```
 
-`praisonai-code` is **not** published standalone to PyPI during migration;
-`praisonai` remains the user-facing install.
+**PyPI:** Published as `praisonai-code` after `praisonaiagents` in the
+three-package release order (see `pypi-release.yml`).

{praisonai_code-0.0.2 → praisonai_code-0.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "praisonai-code"
-version = "0.0.2"
+version = "0.0.4"
 description = "Agentic terminal CLI for PraisonAI — the terminal-native agent (run, chat, code, runtime, cli backends) extracted from the praisonai wrapper."
 readme = "README.md"
 license = {text = "MIT"}