arthexis 0.1.17__tar.gz → 0.1.28__tar.gz

{arthexis-0.1.17 → arthexis-0.1.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arthexis
-Version: 0.1.17
+Version: 0.1.28
 Summary: Power & Energy Infrastructure
 Author-email: "Rafael J. Guillén-Osorio" <tecnologia@gelectriic.com>
 License-Expression: GPL-3.0-only
@@ -15,7 +15,7 @@ Requires-Dist: amqp==5.3.1
 Requires-Dist: annotated-types==0.7.0
 Requires-Dist: anyio==4.9.0
 Requires-Dist: asgiref==3.10.0
-Requires-Dist: atproto==0.0.61
+Requires-Dist: atproto<0.1.0,>=0.0.63
 Requires-Dist: attrs==25.3.0
 Requires-Dist: autobahn==24.4.2
 Requires-Dist: Automat==25.4.16
@@ -26,14 +26,14 @@ Requires-Dist: celery==5.5.3
 Requires-Dist: certifi==2025.7.14
 Requires-Dist: cffi==2.0.0
 Requires-Dist: channels==4.1.0
-Requires-Dist: charset-normalizer==3.4.2
+Requires-Dist: charset-normalizer==3.4.4
 Requires-Dist: click==8.2.1
 Requires-Dist: click-didyoumean==0.3.1
 Requires-Dist: click-plugins==1.1.1.2
 Requires-Dist: click-repl==0.3.0
 Requires-Dist: colorama==0.4.6
 Requires-Dist: constantly==23.10.4
-Requires-Dist: cron-descriptor==1.4.5
+Requires-Dist: cron-descriptor==2.0.6
 Requires-Dist: cryptography==45.0.5
 Requires-Dist: daphne==4.2.1
 Requires-Dist: diff-match-patch==20241021
@@ -41,47 +41,48 @@ Requires-Dist: defusedxml==0.7.1
 Requires-Dist: Django==5.2.7
 Requires-Dist: django-celery-beat==2.8.1
 Requires-Dist: django-debug-toolbar==6.0.0
-Requires-Dist: django-import-export==4.3.9
+Requires-Dist: django-import-export==4.3.12
 Requires-Dist: django-object-actions==5.0.0
-Requires-Dist: django-otp==1.5.4
+Requires-Dist: django-otp==1.6.3
 Requires-Dist: django-timezone-field==7.1
 Requires-Dist: dnspython==2.7.0
 Requires-Dist: docutils==0.22.2
 Requires-Dist: gpiozero==2.0.1; sys_platform == "linux"
+Requires-Dist: graphene-django==3.2.2
 Requires-Dist: graphviz==0.21
+Requires-Dist: geckodriver-autoinstaller==0.1.0
 Requires-Dist: h11==0.16.0
 Requires-Dist: httpcore==1.0.9
 Requires-Dist: httpx==0.28.1
 Requires-Dist: hyperlink==21.0.0
-Requires-Dist: idna==3.10
+Requires-Dist: idna==3.11
 Requires-Dist: incremental==24.7.2
 Requires-Dist: kombu==5.5.4
-Requires-Dist: libipld==3.1.1
-Requires-Dist: Markdown==3.8.2
+Requires-Dist: libipld==3.2.0
+Requires-Dist: Markdown==3.9
 Requires-Dist: mdx_truly_sane_lists==1.3
-Requires-Dist: mcp==1.16.0
 Requires-Dist: mfrc522==0.0.7; sys_platform == "linux"
 Requires-Dist: outcome==1.3.0.post0
 Requires-Dist: packaging==25.0
-Requires-Dist: pillow==11.3.0
-Requires-Dist: prompt_toolkit==3.0.51
-Requires-Dist: psutil==5.9.8
+Requires-Dist: pillow==12.0.0
+Requires-Dist: prompt_toolkit==3.0.52
+Requires-Dist: psutil==7.1.3
 Requires-Dist: psycopg==3.2.9
-Requires-Dist: psycopg-binary==3.2.9
+Requires-Dist: psycopg-binary==3.2.12
 Requires-Dist: pyasn1==0.6.1
 Requires-Dist: pyasn1_modules==0.4.2
 Requires-Dist: pycparser==2.22
-Requires-Dist: pydantic==2.11.7
-Requires-Dist: pydantic_core==2.33.2
+Requires-Dist: pydantic==2.12.3
+Requires-Dist: pydantic_core==2.41.4
 Requires-Dist: pyOpenSSL==25.1.0
-Requires-Dist: pyperclip==1.9.0
+Requires-Dist: pyperclip==1.11.0
 Requires-Dist: PySocks==1.7.1
 Requires-Dist: python-crontab==3.3.0
 Requires-Dist: python-dateutil==2.9.0.post0
 Requires-Dist: python-dotenv==1.1.1
 Requires-Dist: qrcode==8.2
-Requires-Dist: redis==5.0.8
-Requires-Dist: reportlab==4.2.2
+Requires-Dist: redis==7.0.1
+Requires-Dist: reportlab==4.4.4
 Requires-Dist: requests==2.32.5
 Requires-Dist: selenium==4.34.2
 Requires-Dist: service-identity==24.2.0
@@ -98,20 +99,20 @@ Requires-Dist: trio==0.30.0
 Requires-Dist: trio-websocket==0.12.2
 Requires-Dist: Twisted==25.5.0
 Requires-Dist: twine==6.1.0
-Requires-Dist: txaio==25.6.1
-Requires-Dist: typing-inspection==0.4.1
+Requires-Dist: txaio==25.9.2
+Requires-Dist: typing-inspection==0.4.2
 Requires-Dist: typing_extensions==4.14.1
 Requires-Dist: tzdata==2025.2
 Requires-Dist: urllib3==2.5.0
 Requires-Dist: vine==5.1.0
-Requires-Dist: wcwidth==0.2.13
+Requires-Dist: wcwidth==0.2.14
 Requires-Dist: webencodings==0.5.1
 Requires-Dist: websocket-client==1.8.0
-Requires-Dist: websockets==13.1
-Requires-Dist: whitenoise==6.9.0
+Requires-Dist: websockets==15.0.1
+Requires-Dist: whitenoise==6.11.0
 Requires-Dist: plyer==2.1.0; sys_platform == "win32"
 Requires-Dist: wsproto==1.2.0
-Requires-Dist: zope.interface==7.2
+Requires-Dist: zope.interface==8.0.1
 Dynamic: license-file
 
 # Arthexis Constellation
@@ -125,19 +126,43 @@ Arthexis Constellation is a [narrative-driven](https://en.wikipedia.org/wiki/Nar
 
 ## Current Features
 
-- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/) central system, handling:
-  - Lifecycle & sessions
-    - `BootNotification`
-    - `Heartbeat`
-    - `StatusNotification`
-    - `StartTransaction`
-    - `StopTransaction`
-  - Access & metering
-    - `Authorize`
-    - `MeterValues`
-  - Maintenance & firmware
-    - `DiagnosticsStatusNotification`
-    - `FirmwareStatusNotification`
+- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/) central system. Supported actions are summarized below.
+
+  **Charge point → CSMS**
+
+  | Action | What we do |
+  | --- | --- |
+  | `Authorize` | Validate RFID or token authorization requests before a session starts. |
+  | `BootNotification` | Register the charge point and update identity, firmware, and status details. |
+  | `DataTransfer` | Accept vendor-specific payloads and record the results. |
+  | `DiagnosticsStatusNotification` | Track the progress of diagnostic uploads kicked off from the back office. |
+  | `FirmwareStatusNotification` | Track firmware update lifecycle events from charge points. |
+  | `Heartbeat` | Keep the websocket session alive and update last-seen timestamps. |
+  | `MeterValues` | Persist periodic energy and power readings while a transaction is active. |
+  | `StartTransaction` | Create charging sessions with initial meter values and identification data. |
+  | `StatusNotification` | Reflect connector availability and fault states in real time. |
+  | `StopTransaction` | Close charging sessions, capturing closing meter values and stop reasons. |
+
+  **CSMS → Charge point**
+
+  | Action | What we do |
+  | --- | --- |
+  | `CancelReservation` | Withdraw pending reservations and release connectors directly from the control center. |
+  | `ChangeAvailability` | Switch connectors or the whole station between operative and inoperative states. |
+  | `DataTransfer` | Send vendor-specific commands and log the charge point response. |
+  | `GetConfiguration` | Poll the device for the current values of tracked configuration keys. |
+  | `GetLocalListVersion` | Retrieve the current RFID whitelist version and synchronize entries reported by the charge point. |
+  | `RemoteStartTransaction` | Initiate a charging session remotely for an identified customer or token. |
+  | `RemoteStopTransaction` | Terminate active charging sessions from the control center. |
+  | `ReserveNow` | Reserve connectors for upcoming sessions with automatic connector selection and confirmation tracking. |
+  | `Reset` | Request a soft or hard reboot to recover from faults. |
+  | `SendLocalList` | Publish released and approved RFIDs as the charge point's local authorization list. |
+  | `TriggerMessage` | Ask the device to send an immediate update (for example status or diagnostics). |
+  | `UpdateFirmware` | Deliver firmware packages to chargers with secure download tokens and track installation responses. |
+
+  **OCPP 1.6 roadmap.** The following catalogue actions are in our backlog: `ChangeConfiguration`, `ClearCache`, `ClearChargingProfile`, `GetCompositeSchedule`, `GetDiagnostics`, `SetChargingProfile`, `UnlockConnector`.
+
+- Charge point reservations with automated connector assignment, energy account and RFID linkage, EVCS confirmation tracking, and control-center cancellation support.
 - [API](https://en.wikipedia.org/wiki/API) integration with [Odoo](https://www.odoo.com/), syncing:
   - Employee credentials via `res.users`
   - Product catalog lookups via `product.product`
@@ -171,7 +196,7 @@ Arthexis Constellation ships in four node roles tailored to different deployment
       <td valign="top"><strong>Multi-Device Edge, Network &amp; Data Acquisition</strong><br />Features: AP Router, Celery Queue, NGINX Server, RFID Scanner</td>
     </tr>
     <tr>
-      <td valign="top"><strong>Constellation</strong></td>
+      <td valign="top"><strong>Watchtower</strong></td>
       <td valign="top"><strong>Multi-User Cloud &amp; Orchestration</strong><br />Features: Celery Queue, NGINX Server</td>
     </tr>
   </tbody>
@@ -184,7 +209,7 @@ Arthexis Constellation ships in four node roles tailored to different deployment
 - **[Windows](https://en.wikipedia.org/wiki/Microsoft_Windows)**: open [PowerShell](https://learn.microsoft.com/powershell/) or [Git Bash](https://gitforwindows.org/) and run the same command.
 
 ### 2. Start and stop
-Terminal nodes can start directly with the scripts below without installing; Control, Satellite, and Constellation roles require installation first. Both approaches listen on [`http://localhost:8000/`](http://localhost:8000/) by default.
+Terminal nodes can start directly with the scripts below without installing; Control, Satellite, and Watchtower roles require installation first. Both approaches listen on [`http://localhost:8888/`](http://localhost:8888/) by default.
 
 - **[VS Code](https://code.visualstudio.com/)**
    - Open the folder and go to the **Run and Debug** panel (`Ctrl+Shift+D`).
@@ -204,18 +229,47 @@ Terminal nodes can start directly with the scripts below without installing; Con
      - `--constellation` – enables the multi-user orchestration stack.
    - Use `./install.sh --help` to list every available flag if you need to customize the node beyond the role defaults.
    - Upgrade with [`./upgrade.sh`](upgrade.sh).
+   - Consult the [Install & Lifecycle Scripts Manual](docs/development/install-lifecycle-scripts-manual.md) for complete flag descriptions and operational notes.
+   - Review the [Upgrade Guide](docs/UPGRADE.md) for manual steps required after releases that stop automating specific migrations.
 
 - **Windows:**
    - Run [`install.bat`](install.bat) to install (Terminal role) and [`upgrade.bat`](upgrade.bat) to upgrade.
    - Installation is not required to start in Terminal mode (the default).
 
 ### 4. Administration
-Visit [`http://localhost:8000/admin/`](http://localhost:8000/admin/) for the [Django admin](https://docs.djangoproject.com/en/stable/ref/contrib/admin/) and [`http://localhost:8000/admindocs/`](http://localhost:8000/admindocs/) for the [admindocs](https://docs.djangoproject.com/en/stable/ref/contrib/admin/admindocs/). Use `--port` with the start scripts or installer when you need to expose a different port.
+Visit [`http://localhost:8888/admin/`](http://localhost:8888/admin/) for the [Django admin](https://docs.djangoproject.com/en/stable/ref/contrib/admin/) and [`http://localhost:8888/admindocs/`](http://localhost:8888/admindocs/) for the [admindocs](https://docs.djangoproject.com/en/stable/ref/contrib/admin/admindocs/). Use `--port` with the start scripts or installer when you need to expose a different port.
+
+## Sigils
+
+Sigils are bracketed tokens such as `[ENV.SMTP_PASSWORD]` that Arthexis expands at runtime. They make it possible to reference configuration secrets, system metadata, or records stored in other apps without duplicating values across the project.
+
+### Syntax at a glance
+
+- `[PREFIX.KEY]` &mdash; returns a field or attribute. Hyphens and casing are normalized automatically.
+- `[PREFIX=IDENTIFIER.FIELD]` &mdash; selects a specific record by primary key or any unique field.
+- `[PREFIX:FIELD=VALUE.ATTRIBUTE]` &mdash; filters by a custom field instead of the primary key.
+- `[PREFIX.FIELD=[OTHER.SIGIL]]` &mdash; nests sigils so the value after `=` resolves before the outer token.
+- `[PREFIX]` &mdash; for entity prefixes, returns the serialized object in JSON; for configuration prefixes, resolves to an empty string when the key is missing.
+
+The platform ships with three configuration prefixes:
+
+- `ENV` reads environment variables.
+- `CONF` reads Django settings.
+- `SYS` exposes computed system information such as build metadata.
+
+Additional prefixes are defined through **Sigil Roots**, which map a short code (for example `ROLE`, `ODOO`, or `USER`) to a Django model. You can review them from **Admin &rarr; Sigil Builder** (`/admin/sigil-builder/`), where a test console is also available.
+
+Unknown prefixes remain in place (e.g. `[UNKNOWN.VALUE]`) and are logged.
 
 ## Support
 
 Contact us at [tecnologia@gelectriic.com](mailto:tecnologia@gelectriic.com) or visit our [web page](https://www.gelectriic.com/) for [professional services](https://en.wikipedia.org/wiki/Professional_services) and [commercial support](https://en.wikipedia.org/wiki/Technical_support).
 
+## Project Guidelines
+
+- [AGENTS](AGENTS.md) – operating handbook for repository workflows, testing, and release management.
+- [DESIGN](DESIGN.md) – visual, UX, and branding guidance that all interfaces must follow.
+
 ## About Me
 
 > "What, you want to know about me too? Well, I enjoy [developing software](https://en.wikipedia.org/wiki/Software_development), [role-playing games](https://en.wikipedia.org/wiki/Role-playing_game), long walks on the [beach](https://en.wikipedia.org/wiki/Beach) and a fourth secret thing."

{arthexis-0.1.17 → arthexis-0.1.28}/README.md

@@ -9,19 +9,43 @@ Arthexis Constellation is a [narrative-driven](https://en.wikipedia.org/wiki/Nar
 
 ## Current Features
 
-- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/) central system, handling:
-  - Lifecycle & sessions
-    - `BootNotification`
-    - `Heartbeat`
-    - `StatusNotification`
-    - `StartTransaction`
-    - `StopTransaction`
-  - Access & metering
-    - `Authorize`
-    - `MeterValues`
-  - Maintenance & firmware
-    - `DiagnosticsStatusNotification`
-    - `FirmwareStatusNotification`
+- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/) central system. Supported actions are summarized below.
+
+  **Charge point → CSMS**
+
+  | Action | What we do |
+  | --- | --- |
+  | `Authorize` | Validate RFID or token authorization requests before a session starts. |
+  | `BootNotification` | Register the charge point and update identity, firmware, and status details. |
+  | `DataTransfer` | Accept vendor-specific payloads and record the results. |
+  | `DiagnosticsStatusNotification` | Track the progress of diagnostic uploads kicked off from the back office. |
+  | `FirmwareStatusNotification` | Track firmware update lifecycle events from charge points. |
+  | `Heartbeat` | Keep the websocket session alive and update last-seen timestamps. |
+  | `MeterValues` | Persist periodic energy and power readings while a transaction is active. |
+  | `StartTransaction` | Create charging sessions with initial meter values and identification data. |
+  | `StatusNotification` | Reflect connector availability and fault states in real time. |
+  | `StopTransaction` | Close charging sessions, capturing closing meter values and stop reasons. |
+
+  **CSMS → Charge point**
+
+  | Action | What we do |
+  | --- | --- |
+  | `CancelReservation` | Withdraw pending reservations and release connectors directly from the control center. |
+  | `ChangeAvailability` | Switch connectors or the whole station between operative and inoperative states. |
+  | `DataTransfer` | Send vendor-specific commands and log the charge point response. |
+  | `GetConfiguration` | Poll the device for the current values of tracked configuration keys. |
+  | `GetLocalListVersion` | Retrieve the current RFID whitelist version and synchronize entries reported by the charge point. |
+  | `RemoteStartTransaction` | Initiate a charging session remotely for an identified customer or token. |
+  | `RemoteStopTransaction` | Terminate active charging sessions from the control center. |
+  | `ReserveNow` | Reserve connectors for upcoming sessions with automatic connector selection and confirmation tracking. |
+  | `Reset` | Request a soft or hard reboot to recover from faults. |
+  | `SendLocalList` | Publish released and approved RFIDs as the charge point's local authorization list. |
+  | `TriggerMessage` | Ask the device to send an immediate update (for example status or diagnostics). |
+  | `UpdateFirmware` | Deliver firmware packages to chargers with secure download tokens and track installation responses. |
+
+  **OCPP 1.6 roadmap.** The following catalogue actions are in our backlog: `ChangeConfiguration`, `ClearCache`, `ClearChargingProfile`, `GetCompositeSchedule`, `GetDiagnostics`, `SetChargingProfile`, `UnlockConnector`.
+
+- Charge point reservations with automated connector assignment, energy account and RFID linkage, EVCS confirmation tracking, and control-center cancellation support.
 - [API](https://en.wikipedia.org/wiki/API) integration with [Odoo](https://www.odoo.com/), syncing:
   - Employee credentials via `res.users`
   - Product catalog lookups via `product.product`
@@ -55,7 +79,7 @@ Arthexis Constellation ships in four node roles tailored to different deployment
       <td valign="top"><strong>Multi-Device Edge, Network &amp; Data Acquisition</strong><br />Features: AP Router, Celery Queue, NGINX Server, RFID Scanner</td>
     </tr>
     <tr>
-      <td valign="top"><strong>Constellation</strong></td>
+      <td valign="top"><strong>Watchtower</strong></td>
       <td valign="top"><strong>Multi-User Cloud &amp; Orchestration</strong><br />Features: Celery Queue, NGINX Server</td>
     </tr>
   </tbody>
@@ -68,7 +92,7 @@ Arthexis Constellation ships in four node roles tailored to different deployment
 - **[Windows](https://en.wikipedia.org/wiki/Microsoft_Windows)**: open [PowerShell](https://learn.microsoft.com/powershell/) or [Git Bash](https://gitforwindows.org/) and run the same command.
 
 ### 2. Start and stop
-Terminal nodes can start directly with the scripts below without installing; Control, Satellite, and Constellation roles require installation first. Both approaches listen on [`http://localhost:8000/`](http://localhost:8000/) by default.
+Terminal nodes can start directly with the scripts below without installing; Control, Satellite, and Watchtower roles require installation first. Both approaches listen on [`http://localhost:8888/`](http://localhost:8888/) by default.
 
 - **[VS Code](https://code.visualstudio.com/)**
    - Open the folder and go to the **Run and Debug** panel (`Ctrl+Shift+D`).
@@ -88,18 +112,47 @@ Terminal nodes can start directly with the scripts below without installing; Con
      - `--constellation` – enables the multi-user orchestration stack.
    - Use `./install.sh --help` to list every available flag if you need to customize the node beyond the role defaults.
    - Upgrade with [`./upgrade.sh`](upgrade.sh).
+   - Consult the [Install & Lifecycle Scripts Manual](docs/development/install-lifecycle-scripts-manual.md) for complete flag descriptions and operational notes.
+   - Review the [Upgrade Guide](docs/UPGRADE.md) for manual steps required after releases that stop automating specific migrations.
 
 - **Windows:**
    - Run [`install.bat`](install.bat) to install (Terminal role) and [`upgrade.bat`](upgrade.bat) to upgrade.
    - Installation is not required to start in Terminal mode (the default).
 
 ### 4. Administration
-Visit [`http://localhost:8000/admin/`](http://localhost:8000/admin/) for the [Django admin](https://docs.djangoproject.com/en/stable/ref/contrib/admin/) and [`http://localhost:8000/admindocs/`](http://localhost:8000/admindocs/) for the [admindocs](https://docs.djangoproject.com/en/stable/ref/contrib/admin/admindocs/). Use `--port` with the start scripts or installer when you need to expose a different port.
+Visit [`http://localhost:8888/admin/`](http://localhost:8888/admin/) for the [Django admin](https://docs.djangoproject.com/en/stable/ref/contrib/admin/) and [`http://localhost:8888/admindocs/`](http://localhost:8888/admindocs/) for the [admindocs](https://docs.djangoproject.com/en/stable/ref/contrib/admin/admindocs/). Use `--port` with the start scripts or installer when you need to expose a different port.
+
+## Sigils
+
+Sigils are bracketed tokens such as `[ENV.SMTP_PASSWORD]` that Arthexis expands at runtime. They make it possible to reference configuration secrets, system metadata, or records stored in other apps without duplicating values across the project.
+
+### Syntax at a glance
+
+- `[PREFIX.KEY]` &mdash; returns a field or attribute. Hyphens and casing are normalized automatically.
+- `[PREFIX=IDENTIFIER.FIELD]` &mdash; selects a specific record by primary key or any unique field.
+- `[PREFIX:FIELD=VALUE.ATTRIBUTE]` &mdash; filters by a custom field instead of the primary key.
+- `[PREFIX.FIELD=[OTHER.SIGIL]]` &mdash; nests sigils so the value after `=` resolves before the outer token.
+- `[PREFIX]` &mdash; for entity prefixes, returns the serialized object in JSON; for configuration prefixes, resolves to an empty string when the key is missing.
+
+The platform ships with three configuration prefixes:
+
+- `ENV` reads environment variables.
+- `CONF` reads Django settings.
+- `SYS` exposes computed system information such as build metadata.
+
+Additional prefixes are defined through **Sigil Roots**, which map a short code (for example `ROLE`, `ODOO`, or `USER`) to a Django model. You can review them from **Admin &rarr; Sigil Builder** (`/admin/sigil-builder/`), where a test console is also available.
+
+Unknown prefixes remain in place (e.g. `[UNKNOWN.VALUE]`) and are logged.
 
 ## Support
 
 Contact us at [tecnologia@gelectriic.com](mailto:tecnologia@gelectriic.com) or visit our [web page](https://www.gelectriic.com/) for [professional services](https://en.wikipedia.org/wiki/Professional_services) and [commercial support](https://en.wikipedia.org/wiki/Technical_support).
 
+## Project Guidelines
+
+- [AGENTS](AGENTS.md) – operating handbook for repository workflows, testing, and release management.
+- [DESIGN](DESIGN.md) – visual, UX, and branding guidance that all interfaces must follow.
+
 ## About Me
 
 > "What, you want to know about me too? Well, I enjoy [developing software](https://en.wikipedia.org/wiki/Software_development), [role-playing games](https://en.wikipedia.org/wiki/Role-playing_game), long walks on the [beach](https://en.wikipedia.org/wiki/Beach) and a fourth secret thing."

{arthexis-0.1.17 → arthexis-0.1.28}/arthexis.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arthexis
-Version: 0.1.17
+Version: 0.1.28
 Summary: Power & Energy Infrastructure
 Author-email: "Rafael J. Guillén-Osorio" <tecnologia@gelectriic.com>
 License-Expression: GPL-3.0-only
@@ -15,7 +15,7 @@ Requires-Dist: amqp==5.3.1
 Requires-Dist: annotated-types==0.7.0
 Requires-Dist: anyio==4.9.0
 Requires-Dist: asgiref==3.10.0
-Requires-Dist: atproto==0.0.61
+Requires-Dist: atproto<0.1.0,>=0.0.63
 Requires-Dist: attrs==25.3.0
 Requires-Dist: autobahn==24.4.2
 Requires-Dist: Automat==25.4.16
@@ -26,14 +26,14 @@ Requires-Dist: celery==5.5.3
 Requires-Dist: certifi==2025.7.14
 Requires-Dist: cffi==2.0.0
 Requires-Dist: channels==4.1.0
-Requires-Dist: charset-normalizer==3.4.2
+Requires-Dist: charset-normalizer==3.4.4
 Requires-Dist: click==8.2.1
 Requires-Dist: click-didyoumean==0.3.1
 Requires-Dist: click-plugins==1.1.1.2
 Requires-Dist: click-repl==0.3.0
 Requires-Dist: colorama==0.4.6
 Requires-Dist: constantly==23.10.4
-Requires-Dist: cron-descriptor==1.4.5
+Requires-Dist: cron-descriptor==2.0.6
 Requires-Dist: cryptography==45.0.5
 Requires-Dist: daphne==4.2.1
 Requires-Dist: diff-match-patch==20241021
@@ -41,47 +41,48 @@ Requires-Dist: defusedxml==0.7.1
 Requires-Dist: Django==5.2.7
 Requires-Dist: django-celery-beat==2.8.1
 Requires-Dist: django-debug-toolbar==6.0.0
-Requires-Dist: django-import-export==4.3.9
+Requires-Dist: django-import-export==4.3.12
 Requires-Dist: django-object-actions==5.0.0
-Requires-Dist: django-otp==1.5.4
+Requires-Dist: django-otp==1.6.3
 Requires-Dist: django-timezone-field==7.1
 Requires-Dist: dnspython==2.7.0
 Requires-Dist: docutils==0.22.2
 Requires-Dist: gpiozero==2.0.1; sys_platform == "linux"
+Requires-Dist: graphene-django==3.2.2
 Requires-Dist: graphviz==0.21
+Requires-Dist: geckodriver-autoinstaller==0.1.0
 Requires-Dist: h11==0.16.0
 Requires-Dist: httpcore==1.0.9
 Requires-Dist: httpx==0.28.1
 Requires-Dist: hyperlink==21.0.0
-Requires-Dist: idna==3.10
+Requires-Dist: idna==3.11
 Requires-Dist: incremental==24.7.2
 Requires-Dist: kombu==5.5.4
-Requires-Dist: libipld==3.1.1
-Requires-Dist: Markdown==3.8.2
+Requires-Dist: libipld==3.2.0
+Requires-Dist: Markdown==3.9
 Requires-Dist: mdx_truly_sane_lists==1.3
-Requires-Dist: mcp==1.16.0
 Requires-Dist: mfrc522==0.0.7; sys_platform == "linux"
 Requires-Dist: outcome==1.3.0.post0
 Requires-Dist: packaging==25.0
-Requires-Dist: pillow==11.3.0
-Requires-Dist: prompt_toolkit==3.0.51
-Requires-Dist: psutil==5.9.8
+Requires-Dist: pillow==12.0.0
+Requires-Dist: prompt_toolkit==3.0.52
+Requires-Dist: psutil==7.1.3
 Requires-Dist: psycopg==3.2.9
-Requires-Dist: psycopg-binary==3.2.9
+Requires-Dist: psycopg-binary==3.2.12
 Requires-Dist: pyasn1==0.6.1
 Requires-Dist: pyasn1_modules==0.4.2
 Requires-Dist: pycparser==2.22
-Requires-Dist: pydantic==2.11.7
-Requires-Dist: pydantic_core==2.33.2
+Requires-Dist: pydantic==2.12.3
+Requires-Dist: pydantic_core==2.41.4
 Requires-Dist: pyOpenSSL==25.1.0
-Requires-Dist: pyperclip==1.9.0
+Requires-Dist: pyperclip==1.11.0
 Requires-Dist: PySocks==1.7.1
 Requires-Dist: python-crontab==3.3.0
 Requires-Dist: python-dateutil==2.9.0.post0
 Requires-Dist: python-dotenv==1.1.1
 Requires-Dist: qrcode==8.2
-Requires-Dist: redis==5.0.8
-Requires-Dist: reportlab==4.2.2
+Requires-Dist: redis==7.0.1
+Requires-Dist: reportlab==4.4.4
 Requires-Dist: requests==2.32.5
 Requires-Dist: selenium==4.34.2
 Requires-Dist: service-identity==24.2.0
@@ -98,20 +99,20 @@ Requires-Dist: trio==0.30.0
 Requires-Dist: trio-websocket==0.12.2
 Requires-Dist: Twisted==25.5.0
 Requires-Dist: twine==6.1.0
-Requires-Dist: txaio==25.6.1
-Requires-Dist: typing-inspection==0.4.1
+Requires-Dist: txaio==25.9.2
+Requires-Dist: typing-inspection==0.4.2
 Requires-Dist: typing_extensions==4.14.1
 Requires-Dist: tzdata==2025.2
 Requires-Dist: urllib3==2.5.0
 Requires-Dist: vine==5.1.0
-Requires-Dist: wcwidth==0.2.13
+Requires-Dist: wcwidth==0.2.14
 Requires-Dist: webencodings==0.5.1
 Requires-Dist: websocket-client==1.8.0
-Requires-Dist: websockets==13.1
-Requires-Dist: whitenoise==6.9.0
+Requires-Dist: websockets==15.0.1
+Requires-Dist: whitenoise==6.11.0
 Requires-Dist: plyer==2.1.0; sys_platform == "win32"
 Requires-Dist: wsproto==1.2.0
-Requires-Dist: zope.interface==7.2
+Requires-Dist: zope.interface==8.0.1
 Dynamic: license-file
 
 # Arthexis Constellation
@@ -125,19 +126,43 @@ Arthexis Constellation is a [narrative-driven](https://en.wikipedia.org/wiki/Nar
 
 ## Current Features
 
-- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/) central system, handling:
-  - Lifecycle & sessions
-    - `BootNotification`
-    - `Heartbeat`
-    - `StatusNotification`
-    - `StartTransaction`
-    - `StopTransaction`
-  - Access & metering
-    - `Authorize`
-    - `MeterValues`
-  - Maintenance & firmware
-    - `DiagnosticsStatusNotification`
-    - `FirmwareStatusNotification`
+- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/) central system. Supported actions are summarized below.
+
+  **Charge point → CSMS**
+
+  | Action | What we do |
+  | --- | --- |
+  | `Authorize` | Validate RFID or token authorization requests before a session starts. |
+  | `BootNotification` | Register the charge point and update identity, firmware, and status details. |
+  | `DataTransfer` | Accept vendor-specific payloads and record the results. |
+  | `DiagnosticsStatusNotification` | Track the progress of diagnostic uploads kicked off from the back office. |
+  | `FirmwareStatusNotification` | Track firmware update lifecycle events from charge points. |
+  | `Heartbeat` | Keep the websocket session alive and update last-seen timestamps. |
+  | `MeterValues` | Persist periodic energy and power readings while a transaction is active. |
+  | `StartTransaction` | Create charging sessions with initial meter values and identification data. |
+  | `StatusNotification` | Reflect connector availability and fault states in real time. |
+  | `StopTransaction` | Close charging sessions, capturing closing meter values and stop reasons. |
+
+  **CSMS → Charge point**
+
+  | Action | What we do |
+  | --- | --- |
+  | `CancelReservation` | Withdraw pending reservations and release connectors directly from the control center. |
+  | `ChangeAvailability` | Switch connectors or the whole station between operative and inoperative states. |
+  | `DataTransfer` | Send vendor-specific commands and log the charge point response. |
+  | `GetConfiguration` | Poll the device for the current values of tracked configuration keys. |
+  | `GetLocalListVersion` | Retrieve the current RFID whitelist version and synchronize entries reported by the charge point. |
+  | `RemoteStartTransaction` | Initiate a charging session remotely for an identified customer or token. |
+  | `RemoteStopTransaction` | Terminate active charging sessions from the control center. |
+  | `ReserveNow` | Reserve connectors for upcoming sessions with automatic connector selection and confirmation tracking. |
+  | `Reset` | Request a soft or hard reboot to recover from faults. |
+  | `SendLocalList` | Publish released and approved RFIDs as the charge point's local authorization list. |
+  | `TriggerMessage` | Ask the device to send an immediate update (for example status or diagnostics). |
+  | `UpdateFirmware` | Deliver firmware packages to chargers with secure download tokens and track installation responses. |
+
+  **OCPP 1.6 roadmap.** The following catalogue actions are in our backlog: `ChangeConfiguration`, `ClearCache`, `ClearChargingProfile`, `GetCompositeSchedule`, `GetDiagnostics`, `SetChargingProfile`, `UnlockConnector`.
+
+- Charge point reservations with automated connector assignment, energy account and RFID linkage, EVCS confirmation tracking, and control-center cancellation support.
 - [API](https://en.wikipedia.org/wiki/API) integration with [Odoo](https://www.odoo.com/), syncing:
   - Employee credentials via `res.users`
   - Product catalog lookups via `product.product`
@@ -171,7 +196,7 @@ Arthexis Constellation ships in four node roles tailored to different deployment
       <td valign="top"><strong>Multi-Device Edge, Network &amp; Data Acquisition</strong><br />Features: AP Router, Celery Queue, NGINX Server, RFID Scanner</td>
     </tr>
     <tr>
-      <td valign="top"><strong>Constellation</strong></td>
+      <td valign="top"><strong>Watchtower</strong></td>
       <td valign="top"><strong>Multi-User Cloud &amp; Orchestration</strong><br />Features: Celery Queue, NGINX Server</td>
     </tr>
   </tbody>
@@ -184,7 +209,7 @@ Arthexis Constellation ships in four node roles tailored to different deployment
 - **[Windows](https://en.wikipedia.org/wiki/Microsoft_Windows)**: open [PowerShell](https://learn.microsoft.com/powershell/) or [Git Bash](https://gitforwindows.org/) and run the same command.
 
 ### 2. Start and stop
-Terminal nodes can start directly with the scripts below without installing; Control, Satellite, and Constellation roles require installation first. Both approaches listen on [`http://localhost:8000/`](http://localhost:8000/) by default.
+Terminal nodes can start directly with the scripts below without installing; Control, Satellite, and Watchtower roles require installation first. Both approaches listen on [`http://localhost:8888/`](http://localhost:8888/) by default.
 
 - **[VS Code](https://code.visualstudio.com/)**
    - Open the folder and go to the **Run and Debug** panel (`Ctrl+Shift+D`).
@@ -204,18 +229,47 @@ Terminal nodes can start directly with the scripts below without installing; Con
      - `--constellation` – enables the multi-user orchestration stack.
    - Use `./install.sh --help` to list every available flag if you need to customize the node beyond the role defaults.
    - Upgrade with [`./upgrade.sh`](upgrade.sh).
+   - Consult the [Install & Lifecycle Scripts Manual](docs/development/install-lifecycle-scripts-manual.md) for complete flag descriptions and operational notes.
+   - Review the [Upgrade Guide](docs/UPGRADE.md) for manual steps required after releases that stop automating specific migrations.
 
 - **Windows:**
    - Run [`install.bat`](install.bat) to install (Terminal role) and [`upgrade.bat`](upgrade.bat) to upgrade.
    - Installation is not required to start in Terminal mode (the default).
 
 ### 4. Administration
-Visit [`http://localhost:8000/admin/`](http://localhost:8000/admin/) for the [Django admin](https://docs.djangoproject.com/en/stable/ref/contrib/admin/) and [`http://localhost:8000/admindocs/`](http://localhost:8000/admindocs/) for the [admindocs](https://docs.djangoproject.com/en/stable/ref/contrib/admin/admindocs/). Use `--port` with the start scripts or installer when you need to expose a different port.
+Visit [`http://localhost:8888/admin/`](http://localhost:8888/admin/) for the [Django admin](https://docs.djangoproject.com/en/stable/ref/contrib/admin/) and [`http://localhost:8888/admindocs/`](http://localhost:8888/admindocs/) for the [admindocs](https://docs.djangoproject.com/en/stable/ref/contrib/admin/admindocs/). Use `--port` with the start scripts or installer when you need to expose a different port.
+
+## Sigils
+
+Sigils are bracketed tokens such as `[ENV.SMTP_PASSWORD]` that Arthexis expands at runtime. They make it possible to reference configuration secrets, system metadata, or records stored in other apps without duplicating values across the project.
+
+### Syntax at a glance
+
+- `[PREFIX.KEY]` &mdash; returns a field or attribute. Hyphens and casing are normalized automatically.
+- `[PREFIX=IDENTIFIER.FIELD]` &mdash; selects a specific record by primary key or any unique field.
+- `[PREFIX:FIELD=VALUE.ATTRIBUTE]` &mdash; filters by a custom field instead of the primary key.
+- `[PREFIX.FIELD=[OTHER.SIGIL]]` &mdash; nests sigils so the value after `=` resolves before the outer token.
+- `[PREFIX]` &mdash; for entity prefixes, returns the serialized object in JSON; for configuration prefixes, resolves to an empty string when the key is missing.
+
+The platform ships with three configuration prefixes:
+
+- `ENV` reads environment variables.
+- `CONF` reads Django settings.
+- `SYS` exposes computed system information such as build metadata.
+
+Additional prefixes are defined through **Sigil Roots**, which map a short code (for example `ROLE`, `ODOO`, or `USER`) to a Django model. You can review them from **Admin &rarr; Sigil Builder** (`/admin/sigil-builder/`), where a test console is also available.
+
+Unknown prefixes remain in place (e.g. `[UNKNOWN.VALUE]`) and are logged.
 
 ## Support
 
 Contact us at [tecnologia@gelectriic.com](mailto:tecnologia@gelectriic.com) or visit our [web page](https://www.gelectriic.com/) for [professional services](https://en.wikipedia.org/wiki/Professional_services) and [commercial support](https://en.wikipedia.org/wiki/Technical_support).
 
+## Project Guidelines
+
+- [AGENTS](AGENTS.md) – operating handbook for repository workflows, testing, and release management.
+- [DESIGN](DESIGN.md) – visual, UX, and branding guidance that all interfaces must follow.
+
 ## About Me
 
 > "What, you want to know about me too? Well, I enjoy [developing software](https://en.wikipedia.org/wiki/Software_development), [role-playing games](https://en.wikipedia.org/wiki/Role-playing_game), long walks on the [beach](https://en.wikipedia.org/wiki/Beach) and a fourth secret thing."