algovoi-keystone-control 0.4.0__tar.gz

algovoi_keystone_control-0.4.0/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 AlgoVoi Ltd
+
+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.

algovoi_keystone_control-0.4.0/NOTICE

@@ -0,0 +1,6 @@
+AlgoVoi Keystone Control
+Copyright 2026 AlgoVoi Ltd
+
+This product is distributed under the Apache License, Version 2.0.
+You may obtain a copy of the License at:
+    http://www.apache.org/licenses/LICENSE-2.0

algovoi_keystone_control-0.4.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: algovoi-keystone-control
+Version: 0.4.0
+Summary: Open keystone settings control panel — discovers installed keystone steps via their algovoi.keystone.steps entry points, binds each to its canonical ref, and tunes policy without changing the hash
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://www.algovoi.co.uk
+Project-URL: Repository, https://github.com/chopmob-cloud/algovoi-keystone
+Project-URL: Documentation, https://docs.algovoi.co.uk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn[standard]>=0.29
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: cryptography>=42.0
+Requires-Dist: algovoi-substrate>=0.4.0
+Dynamic: license-file
+
+# AlgoVoi Keystone Control
+
+Browser panel for installed AlgoVoi keystone packages. Auto-detects which keystone steps are present in the environment, shows their current settings, and lets operators edit them with a pin-gated editor.
+
+Runs over HTTPS out of the box. A self-signed TLS certificate is generated on first start and reused on subsequent runs. Bring your own cert by setting `ALGV_TLS_CERT` and `ALGV_TLS_KEY`.
+
+## Requirements
+
+- Python 3.11+, Linux x86_64
+- At least one AlgoVoi keystone package installed in the same environment
+
+## Install
+
+```bash
+pip install algovoi-keystone-control
+```
+
+## Run
+
+```bash
+ALGV_ADMIN_TOKEN=<your-token> algv-keystone
+```
+
+The panel starts on `https://0.0.0.0:8077`. Open it in a browser and accept the self-signed certificate, or point your browser at a trusted cert with `ALGV_TLS_CERT`.
+
+### Environment variables
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `ALGV_ADMIN_TOKEN` | (required) | Bearer token for panel access |
+| `ALGV_PORT` | `8077` | Listening port |
+| `ALGV_HOST` | `0.0.0.0` | Listening address |
+| `ALGV_DATA_DIR` | `~/.algv/keystone` | TLS cert and settings storage |
+| `ALGV_TLS_CERT` | (auto) | Path to a BYO TLS certificate |
+| `ALGV_TLS_KEY` | (auto) | Path to a BYO TLS private key |
+
+### Systemd example
+
+```ini
+[Unit]
+Description=AlgoVoi Keystone Control
+After=network.target
+
+[Service]
+User=algv
+EnvironmentFile=/etc/algv/keystone.env
+ExecStart=/opt/algv/.venv/bin/algv-keystone
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+`/etc/algv/keystone.env` (mode 0600):
+
+```
+ALGV_ADMIN_TOKEN=<your-token>
+ALGV_DATA_DIR=/var/lib/algv/keystone
+```
+
+## API
+
+All endpoints require `Authorization: Bearer <token>`.
+
+| Method | Path | Description |
+|---|---|---|
+| `GET` | `/v1/steps` | Installed keystone steps and their current settings |
+| `GET` | `/v1/all-known` | All known keystone steps, installed and uninstalled |
+| `PUT` | `/v1/settings/{step}` | Update settings for a step (pin-gated) |
+| `POST` | `/v1/reset/{step}` | Reset a step to defaults (pin-gated) |
+
+## License
+
+Apache-2.0. See [NOTICE](NOTICE).

algovoi_keystone_control-0.4.0/README.md

@@ -0,0 +1,74 @@
+# AlgoVoi Keystone Control
+
+Browser panel for installed AlgoVoi keystone packages. Auto-detects which keystone steps are present in the environment, shows their current settings, and lets operators edit them with a pin-gated editor.
+
+Runs over HTTPS out of the box. A self-signed TLS certificate is generated on first start and reused on subsequent runs. Bring your own cert by setting `ALGV_TLS_CERT` and `ALGV_TLS_KEY`.
+
+## Requirements
+
+- Python 3.11+, Linux x86_64
+- At least one AlgoVoi keystone package installed in the same environment
+
+## Install
+
+```bash
+pip install algovoi-keystone-control
+```
+
+## Run
+
+```bash
+ALGV_ADMIN_TOKEN=<your-token> algv-keystone
+```
+
+The panel starts on `https://0.0.0.0:8077`. Open it in a browser and accept the self-signed certificate, or point your browser at a trusted cert with `ALGV_TLS_CERT`.
+
+### Environment variables
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `ALGV_ADMIN_TOKEN` | (required) | Bearer token for panel access |
+| `ALGV_PORT` | `8077` | Listening port |
+| `ALGV_HOST` | `0.0.0.0` | Listening address |
+| `ALGV_DATA_DIR` | `~/.algv/keystone` | TLS cert and settings storage |
+| `ALGV_TLS_CERT` | (auto) | Path to a BYO TLS certificate |
+| `ALGV_TLS_KEY` | (auto) | Path to a BYO TLS private key |
+
+### Systemd example
+
+```ini
+[Unit]
+Description=AlgoVoi Keystone Control
+After=network.target
+
+[Service]
+User=algv
+EnvironmentFile=/etc/algv/keystone.env
+ExecStart=/opt/algv/.venv/bin/algv-keystone
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+`/etc/algv/keystone.env` (mode 0600):
+
+```
+ALGV_ADMIN_TOKEN=<your-token>
+ALGV_DATA_DIR=/var/lib/algv/keystone
+```
+
+## API
+
+All endpoints require `Authorization: Bearer <token>`.
+
+| Method | Path | Description |
+|---|---|---|
+| `GET` | `/v1/steps` | Installed keystone steps and their current settings |
+| `GET` | `/v1/all-known` | All known keystone steps, installed and uninstalled |
+| `PUT` | `/v1/settings/{step}` | Update settings for a step (pin-gated) |
+| `POST` | `/v1/reset/{step}` | Reset a step to defaults (pin-gated) |
+
+## License
+
+Apache-2.0. See [NOTICE](NOTICE).

algovoi_keystone_control-0.4.0/algovoi_keystone_control/__init__.py

@@ -0,0 +1,2 @@
+"""algovoi-keystone-control — open keystone settings panel (Apache-2.0)."""
+__version__ = "0.1.1"