portacode 1.3.25__tar.gz → 1.3.26__tar.gz

{portacode-1.3.25 → portacode-1.3.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portacode
-Version: 1.3.25
+Version: 1.3.26
 Summary: Portacode CLI client and SDK
 Home-page: https://github.com/portacode/portacode
 Author: Meena Erian
@@ -43,7 +43,7 @@ Dynamic: summary
 
 **An AI-first, mobile-first IDE and admin tool, made with love and passion by software engineers, for software engineers.**
 
-Portacode transforms any computer into a remotely accessible development environment. Access your home lab from your phone, code on your desktop from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.
+Portacode transforms any device with python into a remotely accessible development environment. Access your home lab, server or even embedded system chip from your phone, code on your desktop or your smartphone from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.
 
 ## ✨ Why Portacode?
 
@@ -86,40 +86,9 @@ Once connected, you can:
 
 ## 💡 Use Cases
 
-### Remote Development
-```bash
-# Connect your development machine
-portacode connect
-
-# Now code, build, and debug from anywhere - even your phone
-```
-
-### Server Administration
-```bash
-# For a persistent connection, install system-wide first
-sudo pip install portacode --system
-
-# Then install as a service
-sudo portacode service install
-
-# Your server is now accessible 24/7 from the web dashboard
-```
-
-### Mobile Development
-```bash
-# Connect your desktop/laptop
-portacode connect
-
-# Code on-the-go from your mobile device with a full IDE experience
-```
-
-### Team Collaboration
-```bash
-# Connect shared development environments
-portacode connect
-
-# Enable team members to access shared resources securely
-```
+- **Remote Development**: Code, build, and debug from anywhere - even your phone
+- **Server Administration**: 24/7 server access with persistent service installation
+- **Mobile Development**: Full IDE experience on mobile devices
 
 ## 🔧 Essential Commands
 
@@ -140,19 +109,21 @@ portacode --help
 
 ### Service Management
 ```bash
-# For system services, install package system-wide first
+# First, authenticate your device
+portacode connect
+
+# For system services, install package system-wide
 sudo pip install portacode --system
 
 # Install persistent service (auto-start on boot)
 sudo portacode service install
 
-# Check service status
+# Check service status (use -v for verbose debugging)
 sudo portacode service status
+sudo portacode service status -v
 
-# Stop the service
+# Stop/remove the service
 sudo portacode service stop
-
-# Remove the service
 sudo portacode service uninstall
 ```
 
@@ -194,11 +165,17 @@ sudo portacode service status --verbose
 
 ### Service Installation Issues
 ```bash
+# First authenticate your device
+portacode connect
+
 # If service commands fail, ensure system-wide installation
 sudo pip install portacode --system
 
 # Then try service installation again
 sudo portacode service install
+
+# Use verbose status to debug connection issues
+sudo portacode service status -v
 ```
 
 ### Clipboard Issues (Linux)

{portacode-1.3.25 → portacode-1.3.26}/README.md

@@ -2,7 +2,7 @@
 
 **An AI-first, mobile-first IDE and admin tool, made with love and passion by software engineers, for software engineers.**
 
-Portacode transforms any computer into a remotely accessible development environment. Access your home lab from your phone, code on your desktop from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.
+Portacode transforms any device with python into a remotely accessible development environment. Access your home lab, server or even embedded system chip from your phone, code on your desktop or your smartphone from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.
 
 ## ✨ Why Portacode?
 
@@ -45,40 +45,9 @@ Once connected, you can:
 
 ## 💡 Use Cases
 
-### Remote Development
-```bash
-# Connect your development machine
-portacode connect
-
-# Now code, build, and debug from anywhere - even your phone
-```
-
-### Server Administration
-```bash
-# For a persistent connection, install system-wide first
-sudo pip install portacode --system
-
-# Then install as a service
-sudo portacode service install
-
-# Your server is now accessible 24/7 from the web dashboard
-```
-
-### Mobile Development
-```bash
-# Connect your desktop/laptop
-portacode connect
-
-# Code on-the-go from your mobile device with a full IDE experience
-```
-
-### Team Collaboration
-```bash
-# Connect shared development environments
-portacode connect
-
-# Enable team members to access shared resources securely
-```
+- **Remote Development**: Code, build, and debug from anywhere - even your phone
+- **Server Administration**: 24/7 server access with persistent service installation
+- **Mobile Development**: Full IDE experience on mobile devices
 
 ## 🔧 Essential Commands
 
@@ -99,19 +68,21 @@ portacode --help
 
 ### Service Management
 ```bash
-# For system services, install package system-wide first
+# First, authenticate your device
+portacode connect
+
+# For system services, install package system-wide
 sudo pip install portacode --system
 
 # Install persistent service (auto-start on boot)
 sudo portacode service install
 
-# Check service status
+# Check service status (use -v for verbose debugging)
 sudo portacode service status
+sudo portacode service status -v
 
-# Stop the service
+# Stop/remove the service
 sudo portacode service stop
-
-# Remove the service
 sudo portacode service uninstall
 ```
 
@@ -153,11 +124,17 @@ sudo portacode service status --verbose
 
 ### Service Installation Issues
 ```bash
+# First authenticate your device
+portacode connect
+
 # If service commands fail, ensure system-wide installation
 sudo pip install portacode --system
 
 # Then try service installation again
 sudo portacode service install
+
+# Use verbose status to debug connection issues
+sudo portacode service status -v
 ```
 
 ### Clipboard Issues (Linux)

{portacode-1.3.25 → portacode-1.3.26}/docker-compose.yaml

@@ -21,11 +21,9 @@ services:
       dockerfile: Dockerfile
     container_name: portacode-django
     restart: unless-stopped
-    command: ["bash", "-c", "python manage.py migrate && python manage.py collectstatic --noinput && python manage.py runserver 0.0.0.0:8001"]
+    command: ["bash", "-c", "python manage.py migrate && python manage.py collectstatic --noinput && daphne portacode_django.asgi:application -b 0.0.0.0 -p 8001"]
     env_file:
       - main.env
-    environment:
-      - DJANGO_DEBUG=${DJANGO_DEBUG:-false}
     depends_on:
       db:
         condition: service_healthy

{portacode-1.3.25 → portacode-1.3.26}/portacode/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.3.25'
-__version_tuple__ = version_tuple = (1, 3, 25)
+__version__ = version = '1.3.26'
+__version_tuple__ = version_tuple = (1, 3, 26)
 
 __commit_id__ = commit_id = None

{portacode-1.3.25 → portacode-1.3.26}/portacode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portacode
-Version: 1.3.25
+Version: 1.3.26
 Summary: Portacode CLI client and SDK
 Home-page: https://github.com/portacode/portacode
 Author: Meena Erian
@@ -43,7 +43,7 @@ Dynamic: summary
 
 **An AI-first, mobile-first IDE and admin tool, made with love and passion by software engineers, for software engineers.**
 
-Portacode transforms any computer into a remotely accessible development environment. Access your home lab from your phone, code on your desktop from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.
+Portacode transforms any device with python into a remotely accessible development environment. Access your home lab, server or even embedded system chip from your phone, code on your desktop or your smartphone from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.
 
 ## ✨ Why Portacode?
 
@@ -86,40 +86,9 @@ Once connected, you can:
 
 ## 💡 Use Cases
 
-### Remote Development
-```bash
-# Connect your development machine
-portacode connect
-
-# Now code, build, and debug from anywhere - even your phone
-```
-
-### Server Administration
-```bash
-# For a persistent connection, install system-wide first
-sudo pip install portacode --system
-
-# Then install as a service
-sudo portacode service install
-
-# Your server is now accessible 24/7 from the web dashboard
-```
-
-### Mobile Development
-```bash
-# Connect your desktop/laptop
-portacode connect
-
-# Code on-the-go from your mobile device with a full IDE experience
-```
-
-### Team Collaboration
-```bash
-# Connect shared development environments
-portacode connect
-
-# Enable team members to access shared resources securely
-```
+- **Remote Development**: Code, build, and debug from anywhere - even your phone
+- **Server Administration**: 24/7 server access with persistent service installation
+- **Mobile Development**: Full IDE experience on mobile devices
 
 ## 🔧 Essential Commands
 
@@ -140,19 +109,21 @@ portacode --help
 
 ### Service Management
 ```bash
-# For system services, install package system-wide first
+# First, authenticate your device
+portacode connect
+
+# For system services, install package system-wide
 sudo pip install portacode --system
 
 # Install persistent service (auto-start on boot)
 sudo portacode service install
 
-# Check service status
+# Check service status (use -v for verbose debugging)
 sudo portacode service status
+sudo portacode service status -v
 
-# Stop the service
+# Stop/remove the service
 sudo portacode service stop
-
-# Remove the service
 sudo portacode service uninstall
 ```
 
@@ -194,11 +165,17 @@ sudo portacode service status --verbose
 
 ### Service Installation Issues
 ```bash
+# First authenticate your device
+portacode connect
+
 # If service commands fail, ensure system-wide installation
 sudo pip install portacode --system
 
 # Then try service installation again
 sudo portacode service install
+
+# Use verbose status to debug connection issues
+sudo portacode service status -v
 ```
 
 ### Clipboard Issues (Linux)

{portacode-1.3.25 → portacode-1.3.26}/portacode.egg-info/SOURCES.txt

@@ -79,4 +79,6 @@ testing_framework/core/hierarchical_runner.py
 testing_framework/core/playwright_manager.py
 testing_framework/core/runner.py
 testing_framework/core/shared_cli_manager.py
-testing_framework/core/test_discovery.py
+testing_framework/core/test_discovery.py
+todo/issues/indefinite_resource_loading.md
+todo/issues/premature_terminal_exit.md

portacode-1.3.26/todo/issues/indefinite_resource_loading.md

@@ -0,0 +1,5 @@
+# Issue
+Sometimes on initial page load, while the device sends the websocket message "event": "system_info" apparently the loading sequence goes incorrectly and the even is not handled correctly in the page and the device-card hides the device-resources under the loading overlay indefinitely until next system_info websocket message which wouldn't happen spontanously.
+
+# Suggested solution
+Edit the client side code to ensure such the handlers for such system_info messages are ready before establishing the websocket connection plus, since typically the resources are already available from cache, the loading overlay should not be active unless there is abolutely no info for resource usage, which is not the case in this scenario and we can even see the blurred numbers under the loading overlay, and in that scenario the loading overlay should not be visible to begine with

portacode-1.3.26/todo/issues/premature_terminal_exit.md

@@ -0,0 +1,66 @@
+# Issue: Terminal session exits immediately after start (intermittent; device-sticky until service restart)
+
+## What’s happening (facts)
+
+* **Symptom:** Adevice would be working fine until suddenly it gets locked in a state where starting any new terminal session results in the terminal exiting immediately after.
+* **Intermittency:** The issue **doesn’t always happen**; usually things work.
+* **Device stickiness:** When a **device** experiences the issue, **every attempt on that device** behaves the same (immediate exit) **even if starting in a different project folder or even in the dashboard**.
+* **Persistence & workaround:** The problem **persists until the Portacode service on the device is restarted**; restarting clears it (until it recurs).
+
+## Command used
+
+* To view logs: `portacode service status -v`
+
+## Log evidence (exact lines, in order)
+
+```
+Aug 28 08:52:17 portacode-streamer python3[109754]: [INFO] registry: Dispatching command 'terminal_start' with reply_channel=None
+Aug 28 08:52:17 portacode-streamer python3[109754]: [INFO] handler: Processing command terminal_start with reply_channel=None
+Aug 28 08:52:17 portacode-streamer python3[109754]: [INFO] Launching terminal 34ac592951c84a7b823ccd0432527d75 using shell=bash on channel=34ac592951c84a7b823ccd0432527d75
+Aug 28 08:52:17 portacode-streamer python3[109754]: [INFO] handler: Command terminal_start executed successfully
+Aug 28 08:52:17 portacode-streamer python3[109754]: [INFO] handler: terminal_start response project_id=1556b16d-a4a7-440e-b872-5ba82d756848, response={'event': 'terminal_started', 'terminal_id': '34ac592951c84a7b823ccd0432527d75', 'channel': '34ac592951c84a7b823ccd0432527d75', 'pid': 4001561, 'shell': 'bash', 'cwd': '/home/menas/portacode', 'project_id': '1556b16d-a4a7-440e-b872-5ba82d756848'}
+Aug 28 08:52:17 portacode-streamer python3[109754]: [INFO] registry: Successfully dispatched command 'terminal_start'
+Aug 28 08:52:20 portacode-streamer python3[109754]: [INFO] session_manager: Removed session 34ac592951c84a7b823ccd0432527d75 (PID: 4001561) from session manager
+Aug 28 08:52:21 portacode-streamer python3[109754]: [ERROR] Task was destroyed but it is pending!
+Aug 28 08:52:21 portacode-streamer python3[109754]: task: <Task pending name='Task-23986288' coro=<TerminalSession.start_io_forwarding.<locals>._pump() running at /home/menas/.local/lib/python3.11/site-packages/portacode/connection/handlers/session.py:70> wait_for=<Future pending cb=[Task.task_wakeup()]>> 
+Aug 28 08:52:22 portacode-streamer python3[109754]: [ERROR] [DEBUG] Error loading directory /home/menas/portacode: [Errno 9] Bad file descriptor: '/home/menas/portacode'
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] terminal_manager: Processing command 'client_sessions_update' with reply_channel=None
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] terminal_manager: 🔔 RECEIVED client_sessions_update with 1 sessions
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] Updated client sessions: 1 sessions, 0 newly added, 1 disconnected
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] Disconnected sessions: ['specific..inmemory!VfoFkZPqGxjL']
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] Project states preserved for potential reconnection of these sessions
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] terminal_manager: ✅ Updated client sessions (1 sessions)
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] terminal_manager: ℹ️ No new sessions to send data to
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] [DEBUG] get_or_create_project_state_manager called
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] [DEBUG] Context debug flag: False
+Aug 28 08:52:55 portacode-streamer python3[109754]: [INFO] [DEBUG] Returning existing GLOBAL project state manager (PID: 109754)
+```
+
+## Concrete facts derivable from the logs
+
+* **Terminal launch reported as successful** at `08:52:17` with:
+
+  * `terminal_id`: `34ac592951c84a7b823ccd0432527d75`
+  * `channel`: `34ac592951c84a7b823ccd0432527d75`
+  * `pid`: `4001561`
+  * `shell`: `bash`
+  * `cwd`: `/home/menas/portacode`
+  * `project_id`: `1556b16d-a4a7-440e-b872-5ba82d756848`
+* **Session removal** occurred **3 seconds later** at `08:52:20` for the same terminal ID and PID.
+* After removal, logs show:
+
+  * An **async task** message: “Task was destroyed but it is pending!” referencing `TerminalSession.start_io_forwarding.<locals>._pump()` at `session.py:70`.
+  * A **directory error**: “Error loading directory /home/menas/portacode: \[Errno 9] Bad file descriptor”.
+* A subsequent **client sessions update** indicates **1 disconnected session** and that **project states were preserved**.
+* The system indicates it is **using an existing GLOBAL project state manager** (process PID shown as `109754`).
+
+## What is **not** present in the provided data
+
+* No **exit code** or **signal** for PID `4001561` is printed.
+* No explicit **permission denied** messages.
+* No explicit **resource limit** or **out-of-file-descriptor** message.
+* No timezone information in the timestamps (only date and time as logged).
+
+---
+
+If you want me to go further, I can keep it factual and transform this into a minimal repro checklist or collect-only diagnostics (no hypotheses)—but I’ll stop here unless you say otherwise.