quantum-framework 0.22.0__tar.gz → 1.0.0__tar.gz

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: quantum-framework
-Version: 0.22.0
-Summary: Full-stack declarative framework for building web, desktop, and mobile applications
+Version: 1.0.0
+Summary: Declarative web applications in XML, with AI and RAG built into the language
 Author-email: Daniel Gregorio <danielgregorio2611@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/danielgregorio/quantum
 Project-URL: Documentation, https://danielgregorio.github.io/quantum/
 Project-URL: Changelog, https://github.com/danielgregorio/quantum/releases
 Project-URL: Repository, https://github.com/danielgregorio/quantum
-Keywords: framework,declarative,xml,web,desktop,mobile
-Classifier: Development Status :: 4 - Beta
+Keywords: framework,declarative,xml,web,llm,rag
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Flask
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -29,8 +29,7 @@ Requires-Dist: pytest>=7.4.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.11.1; extra == "dev"
 Requires-Dist: pytest-xdist>=3.5; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: ruff<0.17,>=0.16; extra == "dev"
 Provides-Extra: db
 Requires-Dist: psycopg2-binary>=2.9.9; extra == "db"
 Requires-Dist: pymysql>=1.1.0; extra == "db"
@@ -64,7 +63,7 @@ forms, LLM calls and retrieval-augmented generation are all tags — not librari
 wire together. It takes its philosophy from ColdFusion and Adobe Flex: the markup *is*
 the app.
 
-> ⚠️ **Pre-1.0, and honest about it.** See [Stability](#stability) — the table there
+> **1.0, and honest about it.** See [Stability](#stability) — the table there
 > reflects what has actually been executed end-to-end, not what is aspirational.
 
 ---
@@ -75,7 +74,7 @@ Retrieval-augmented generation, as a language construct:
 
 ```xml
 <q:component name="DocsBot">
-  <q:knowledge name="docs" model="phi3" embedModel="nomic-embed-text">
+  <q:knowledge name="docs" embedModel="nomic-embed-text">
     <q:source type="directory" path="./docs/" pattern="*.md" />
   </q:knowledge>
 
@@ -200,10 +199,13 @@ datasources:
 
 | Command | What it does |
 |---------|--------------|
-| `run <file.q>` | Execute a component, app, or API |
+| `run <file.q>` | Execute a component, or build a `q:application` (`ui`, `terminal`, `game`) |
 | `start` | Start the web server (port 8080 by default; `--port` to change) |
 | `stop` | Stop the server started by `start` |
-| `deploy [path]` · `apps` | Deploy an application, manage deployed ones |
+| `check` | Check that pages parse, SQL compiles and query fields exist |
+| `test` | Run the app's `*.test.q` tests |
+| `console` · `desktop` | The application's pages in the terminal, or in a desktop window |
+| `admin` | Start the Quantum Admin (`pip install "quantum-framework[admin]"`) |
 | `pkg` · `jobs` · `mq` · `migrate` | Packages, jobs, message queues, migrations |
 
 ### From source
@@ -237,19 +239,22 @@ Releases and their notes are on the [GitHub Releases](https://github.com/danielg
 
 Support levels are defined in **[SUPPORT_TIERS.md](https://github.com/danielgregorio/quantum/blob/main/SUPPORT_TIERS.md)**. Short version:
 
-| Surface | Status |
-|---------|--------|
-| Core language — `q:component`, `q:set`, `q:if`, `q:loop`, `q:function`, `q:query`, `q:action`, `q:invoke`, `q:data` | **Stable** |
-| AI — `q:llm`, `q:knowledge`, `q:agent` | **Beta** — validated end-to-end against a live Ollama server |
-| `q:team` (multi-agent handoff) | Beta, less exercised |
-| Jobs, messaging, websockets, mail, file uploads, `ui:*`, terminal target | **Experimental** — they run, but no API stability promise |
-| Python scripting (`q:python`, `q:pyclass`, `q:pyimport`) | Experimental, and a full-trust escape hatch — see [SECURITY.md](https://github.com/danielgregorio/quantum/blob/main/SECURITY.md) |
+| Tier | Surface |
+|------|---------|
+| **Core** — documented, tested end to end, stable | `q:component`, `q:set`, `q:if`, `q:loop`, `q:function`, `q:query`, `q:transaction`, `q:action`, `q:invoke`, `q:data`, `q:import` / `q:slot`, `q:file`, `q:mail`, the Core set of `ui:*`, `require_auth` / `require_role` |
+| **AI** — the Core contract plus a live test against a real model | `q:llm`, `q:knowledge`, `q:agent` |
+| **Experimental** — they run, but no API stability promise | `q:team`, jobs, messaging, websockets, `q:log` / `q:dump`, `ui:*` outside the Core set, the terminal target |
+| Experimental, and a full-trust escape hatch | Python scripting (`q:python`, `q:pyclass`, `q:pyimport`) — off by default, see [SECURITY.md](https://github.com/danielgregorio/quantum/blob/main/SECURITY.md) |
 
 A functional audit in 2026-09 found that several of these surfaces had never been run
 end-to-end despite being documented as complete. They were fixed or re-labelled, and
 feature status is now verified by execution rather than asserted by hand.
 
-Pre-1.0: APIs may change between minor versions.
+From 1.0, **Core and AI follow semantic versioning**: a 1.x release does not break a
+program that uses only them — their meaning is fixed by the rules in
+[SPEC.md](https://github.com/danielgregorio/quantum/blob/main/SPEC.md), and a break
+waits for 2.0. Experimental and Laboratory surfaces carry no such promise and may
+change in any release.
 
 ---
 

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/README.md

@@ -14,7 +14,7 @@ forms, LLM calls and retrieval-augmented generation are all tags — not librari
 wire together. It takes its philosophy from ColdFusion and Adobe Flex: the markup *is*
 the app.
 
-> ⚠️ **Pre-1.0, and honest about it.** See [Stability](#stability) — the table there
+> **1.0, and honest about it.** See [Stability](#stability) — the table there
 > reflects what has actually been executed end-to-end, not what is aspirational.
 
 ---
@@ -25,7 +25,7 @@ Retrieval-augmented generation, as a language construct:
 
 ```xml
 <q:component name="DocsBot">
-  <q:knowledge name="docs" model="phi3" embedModel="nomic-embed-text">
+  <q:knowledge name="docs" embedModel="nomic-embed-text">
     <q:source type="directory" path="./docs/" pattern="*.md" />
   </q:knowledge>
 
@@ -150,10 +150,13 @@ datasources:
 
 | Command | What it does |
 |---------|--------------|
-| `run <file.q>` | Execute a component, app, or API |
+| `run <file.q>` | Execute a component, or build a `q:application` (`ui`, `terminal`, `game`) |
 | `start` | Start the web server (port 8080 by default; `--port` to change) |
 | `stop` | Stop the server started by `start` |
-| `deploy [path]` · `apps` | Deploy an application, manage deployed ones |
+| `check` | Check that pages parse, SQL compiles and query fields exist |
+| `test` | Run the app's `*.test.q` tests |
+| `console` · `desktop` | The application's pages in the terminal, or in a desktop window |
+| `admin` | Start the Quantum Admin (`pip install "quantum-framework[admin]"`) |
 | `pkg` · `jobs` · `mq` · `migrate` | Packages, jobs, message queues, migrations |
 
 ### From source
@@ -187,19 +190,22 @@ Releases and their notes are on the [GitHub Releases](https://github.com/danielg
 
 Support levels are defined in **[SUPPORT_TIERS.md](https://github.com/danielgregorio/quantum/blob/main/SUPPORT_TIERS.md)**. Short version:
 
-| Surface | Status |
-|---------|--------|
-| Core language — `q:component`, `q:set`, `q:if`, `q:loop`, `q:function`, `q:query`, `q:action`, `q:invoke`, `q:data` | **Stable** |
-| AI — `q:llm`, `q:knowledge`, `q:agent` | **Beta** — validated end-to-end against a live Ollama server |
-| `q:team` (multi-agent handoff) | Beta, less exercised |
-| Jobs, messaging, websockets, mail, file uploads, `ui:*`, terminal target | **Experimental** — they run, but no API stability promise |
-| Python scripting (`q:python`, `q:pyclass`, `q:pyimport`) | Experimental, and a full-trust escape hatch — see [SECURITY.md](https://github.com/danielgregorio/quantum/blob/main/SECURITY.md) |
+| Tier | Surface |
+|------|---------|
+| **Core** — documented, tested end to end, stable | `q:component`, `q:set`, `q:if`, `q:loop`, `q:function`, `q:query`, `q:transaction`, `q:action`, `q:invoke`, `q:data`, `q:import` / `q:slot`, `q:file`, `q:mail`, the Core set of `ui:*`, `require_auth` / `require_role` |
+| **AI** — the Core contract plus a live test against a real model | `q:llm`, `q:knowledge`, `q:agent` |
+| **Experimental** — they run, but no API stability promise | `q:team`, jobs, messaging, websockets, `q:log` / `q:dump`, `ui:*` outside the Core set, the terminal target |
+| Experimental, and a full-trust escape hatch | Python scripting (`q:python`, `q:pyclass`, `q:pyimport`) — off by default, see [SECURITY.md](https://github.com/danielgregorio/quantum/blob/main/SECURITY.md) |
 
 A functional audit in 2026-09 found that several of these surfaces had never been run
 end-to-end despite being documented as complete. They were fixed or re-labelled, and
 feature status is now verified by execution rather than asserted by hand.
 
-Pre-1.0: APIs may change between minor versions.
+From 1.0, **Core and AI follow semantic versioning**: a 1.x release does not break a
+program that uses only them — their meaning is fixed by the rules in
+[SPEC.md](https://github.com/danielgregorio/quantum/blob/main/SPEC.md), and a break
+waits for 2.0. Experimental and Laboratory surfaces carry no such promise and may
+change in any release.
 
 ---
 

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/pyproject.toml

@@ -4,16 +4,16 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quantum-framework"
-version = "0.22.0"
-description = "Full-stack declarative framework for building web, desktop, and mobile applications"
+version = "1.0.0"
+description = "Declarative web applications in XML, with AI and RAG built into the language"
 readme = "README.md"
 license = {text = "MIT"}
 authors = [
     {name = "Daniel Gregorio", email = "danielgregorio2611@gmail.com"}
 ]
-keywords = ["framework", "declarative", "xml", "web", "desktop", "mobile"]
+keywords = ["framework", "declarative", "xml", "web", "llm", "rag"]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Framework :: Flask",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
@@ -36,8 +36,9 @@ dev = [
     "pytest-cov>=4.1.0",
     "pytest-mock>=3.11.1",
     "pytest-xdist>=3.5",
-    "black>=23.0.0",
-    "ruff>=0.1.0",
+    # Pinned to a minor version: `ruff check` blocks CI, and a new release
+    # that adds checks must not turn main red with no change to the code.
+    "ruff>=0.16,<0.17",
 ]
 db = [
     "psycopg2-binary>=2.9.9",
@@ -99,14 +100,34 @@ quantum_admin = ["backend/*", "backend/**/*", "templates/**/*", "static/**/*", "
                  "settings/**/*", "*.db"]
 
 
-[tool.black]
-line-length = 100
-target-version = ['py311', 'py312']
-
 [tool.ruff]
 line-length = 100
-select = ["E", "F", "W", "I"]
-ignore = ["E501"]
+
+# `ruff check quantum tests` is clean and blocking in CI. Each rule left out
+# says why; anything else it finds is a finding to fix.
+[tool.ruff.lint]
+# "I" (import sorting) is not selected: sorting the imports of ~400 files is
+# churn with no bug behind it, and it would conflict with every open branch.
+select = ["E", "F", "W"]
+ignore = [
+    # Line length: templates, SQL and user-facing messages read better whole;
+    # length is left to review.
+    "E501",
+    # Ambiguous names (`l`, `O`, `I`): 13 short-lived loop variables; renaming
+    # them fixes nothing.
+    "E741",
+]
+
+[tool.ruff.lint.per-file-ignores]
+# A package __init__ re-exports names on purpose (and quantum.core re-exports
+# the AST with `*`).
+"**/__init__.py" = ["F401", "F403"]
+# The feature modules import QuantumNode from ast_nodes, so their node classes
+# can only be imported after QuantumNode is defined, mid-module.
+"quantum/core/ast_nodes.py" = ["E402"]
+# A pytest fixture imported into a test module and requested as a parameter
+# reads as a redefinition.
+"tests/**" = ["F811"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/quantum/cli/hot_reload.py

@@ -293,11 +293,13 @@ class HotReloadServer:
 
     def stop(self):
         """Stop the WebSocket server."""
+        # Only clear the flag: main() leaves its loop within 0.1 s and the
+        # `async with serve(...)` closes the server and its sockets. Stopping
+        # the event loop instead abandoned main() mid-`async with`; the loop
+        # was then closed under it, and when the orphaned coroutine was
+        # collected later its cleanup raised "Event loop is closed".
         self._running = False
 
-        if self._loop:
-            self._loop.call_soon_threadsafe(self._loop.stop)
-
         if self._thread:
             self._thread.join(timeout=2)
             self._thread = None
@@ -306,7 +308,11 @@ class HotReloadServer:
         """Run the WebSocket server (in background thread)."""
         try:
             import websockets
-            import websockets.server
+            try:
+                # websockets >= 13; the legacy module warns since 14.
+                from websockets.asyncio.server import serve
+            except ImportError:
+                from websockets.server import serve
         except ImportError:
             print("[Hot Reload] websockets library not found. Using fallback polling.")
             print("[Hot Reload] Install with: pip install websockets")
@@ -338,7 +344,7 @@ class HotReloadServer:
                 self._clients.discard(websocket)
 
         async def main():
-            async with websockets.server.serve(handler, self.host, self.port):
+            async with serve(handler, self.host, self.port):
                 while self._running:
                     await asyncio.sleep(0.1)
 
@@ -350,6 +356,7 @@ class HotReloadServer:
         except Exception:
             pass
         finally:
+            self._loop.run_until_complete(self._loop.shutdown_asyncgens())
             self._loop.close()
 
     def broadcast(self, message: dict):
@@ -505,20 +512,21 @@ class HotReloadManager:
             self._broadcast_error(parse_error)
             return
 
-        # Broadcast reload to clients
-        self._broadcast_reload(changes, reload_type)
-
-        # Call optional callback
+        # The callback runs BEFORE the browsers are told: the server clears
+        # its caches there, and a page reloading right after the message must
+        # not be served from the old ones.
         if self.on_reload:
             try:
                 self.on_reload(changes, reload_type)
             except Exception as e:
                 self._log(f"Error in reload callback: {e}")
 
+        # Broadcast reload to clients
+        self._broadcast_reload(changes, reload_type)
+
     def _check_parse_error(self, path: Path) -> Optional[dict]:
         """Check if a .q file has parse errors."""
         try:
-            import sys
             from quantum.core.parser import QuantumParser, QuantumParseError
 
             parser = QuantumParser()

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/quantum/cli/jobs.py

@@ -6,12 +6,8 @@ Quantum CLI - Job Management Commands
 Commands for managing scheduled jobs, threads, and job queues.
 """
 
-import argparse
-import sys
 import json
-from pathlib import Path
 from datetime import datetime
-from typing import Optional
 
 # Add parent to path for imports
 
@@ -203,7 +199,7 @@ def _handle_jobs_run(executor, args) -> int:
 
     if args.sync:
         if result.get('success'):
-            print(f"Job completed successfully.")
+            print("Job completed successfully.")
             if result.get('result'):
                 print(f"Result: {result['result']}")
         else:
@@ -286,7 +282,7 @@ def _handle_jobs_worker(executor, args) -> int:
 
     if args.worker_action == 'start':
         queues = [q.strip() for q in args.queue.split(',')]
-        print(f"Starting worker...")
+        print("Starting worker...")
         print(f"  Queues: {', '.join(queues)}")
         print(f"  Concurrency: {args.concurrency}")
         print(f"  Poll interval: {args.poll_interval}s")

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/quantum/cli/migrations.py

@@ -2,13 +2,11 @@
 Database migrations: applies migrations/*.sql to a datasource declared in
 quantum.config.yaml (DB-6). `quantum migrate` (cli/runner.py) drives it.
 """
-import os
-import sys
 import hashlib
 import logging
 from pathlib import Path
 from datetime import datetime
-from typing import Optional, List, Dict, Any
+from typing import List, Dict, Any
 
 
 logger = logging.getLogger(__name__)

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/quantum/cli/mq.py

@@ -6,12 +6,7 @@ Quantum CLI - Message Queue Commands
 Commands for managing message queues, publishing messages, and running consumers.
 """
 
-import argparse
-import sys
 import json
-from pathlib import Path
-from datetime import datetime
-from typing import Optional
 
 # Add parent to path for imports
 
@@ -100,15 +95,13 @@ def create_mq_parser(subparsers):
     stats_parser.add_argument('--format', choices=['table', 'json'], default='table')
 
     # Connection info
-    info_parser = mq_sub.add_parser('info', help='Show connection information')
+    mq_sub.add_parser('info', help='Show connection information')
 
     return mq_parser
 
 
 def handle_mq(args) -> int:
     """Handle mq command"""
-    from quantum.runtime.message_broker import MessageBroker, Message
-    from quantum.runtime.adapters.memory_adapter import InMemoryAdapter
 
     if not args.mq_action:
         print("Usage: quantum mq <action>")
@@ -504,7 +497,7 @@ def _handle_mq_worker(broker, args) -> int:
     """Start message worker"""
     queues = [q.strip() for q in args.queues.split(',')]
 
-    print(f"Starting message worker...")
+    print("Starting message worker...")
     print(f"  Queues: {', '.join(queues)}")
     print(f"  Concurrency: {args.concurrency}")
     print(f"  Prefetch: {args.prefetch}")

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/quantum/cli/pkg.py

@@ -12,9 +12,7 @@ CLI commands for package management:
 """
 
 import argparse
-import sys
 from pathlib import Path
-from typing import Optional
 
 
 def create_pkg_parser(subparsers: argparse._SubParsersAction) -> None:
@@ -216,8 +214,8 @@ def _handle_init(pm, args: argparse.Namespace) -> int:
     print("   README.md")
     print()
     print("Next steps:")
-    print(f"   1. Edit src/index.q to create your component")
-    print(f"   2. Update quantum.yaml with description and keywords")
+    print("   1. Edit src/index.q to create your component")
+    print("   2. Update quantum.yaml with description and keywords")
     print(f"   3. Run 'quantum pkg publish {args.path}' to create archive")
 
     return 0
@@ -231,7 +229,7 @@ def _handle_publish(pm, args: argparse.Namespace) -> int:
 
     archive_path = pm.publish(str(path))
 
-    print(f"[SUCCESS] Package archive created!")
+    print("[SUCCESS] Package archive created!")
     print(f"   Archive: {archive_path}")
     print()
     print("Share this archive or upload to a registry.")

{quantum_framework-0.22.0 → quantum_framework-1.0.0}/quantum/cli/runner.py

@@ -16,7 +16,7 @@ if os.name == 'nt':  # Windows
         if hasattr(sys.stdout, 'reconfigure'):
             sys.stdout.reconfigure(encoding='utf-8')
             sys.stderr.reconfigure(encoding='utf-8')
-    except:
+    except Exception:
         pass  # Silent fallback
 
 # Fix imports - use absolute imports
@@ -25,18 +25,6 @@ from quantum.core.parser import QuantumParser, QuantumParseError
 from quantum.core.ast_nodes import ComponentNode, ApplicationNode, JobNode
 from quantum.runtime.component import ComponentRuntime, ComponentExecutionError
 from quantum.runtime.executors.control_flow.redirect_executor import PageRedirect
-from quantum.runtime.web_server import QuantumWebServer
-
-# Import deploy commands (lazy load to avoid import errors if requests not installed)
-def _get_deploy_module():
-    try:
-        from quantum.cli.deploy import (
-            create_deploy_parser, create_apps_parser,
-            handle_deploy, handle_apps
-        )
-        return True, create_deploy_parser, create_apps_parser, handle_deploy, handle_apps
-    except ImportError as e:
-        return False, None, None, None, str(e)
 
 # Import package commands
 def _get_pkg_module():
@@ -98,23 +86,23 @@ class QuantumRunner:
         self.parser = QuantumParser()
         self.config = config if config is not None else load_config()
         self.component_runtime = ComponentRuntime(config=self.config)
-    
+
     def run(self, file_path: str, debug: bool = False) -> int:
         """Execute .q file"""
         try:
             if debug:
                 print(f"[DEBUG] Parsing file: {Path(file_path).name}")
-            
+
             # Store source directory for asset resolution
             self._source_dir = str(Path(file_path).resolve().parent)
 
             # Parse file → AST
             ast_node = self.parser.parse_file(file_path)
-            
+
             if debug:
                 print(f"[DEBUG] AST generated: {type(ast_node).__name__}")
-                print(f"[DEBUG] Validating AST...")
-            
+                print("[DEBUG] Validating AST...")
+
             # Validate AST
             validation_errors = ast_node.validate()
             if validation_errors:
@@ -122,10 +110,10 @@ class QuantumRunner:
                 for error in validation_errors:
                     print(f"  - {error}")
                 return 1
-            
+
             # Execute based on type
             return self._execute_ast(ast_node, debug)
-            
+
         except QuantumParseError as e:
             print(f"[ERROR] Parse error: {e}")
             return 1
@@ -135,7 +123,7 @@ class QuantumRunner:
                 import traceback
                 traceback.print_exc()
             return 1
-    
+
     def _execute_ast(self, ast_node, debug: bool = False) -> int:
         """Execute AST based on type"""
         if isinstance(ast_node, ComponentNode):
@@ -147,7 +135,7 @@ class QuantumRunner:
         else:
             print(f"[ERROR] Unsupported AST type: {type(ast_node)}")
             return 1
-    
+
     def _execute_component(self, component: ComponentNode, debug: bool = False) -> int:
         """Execute q:component"""
         print(f"[EXEC] Executing component: {component.name}")
@@ -155,7 +143,7 @@ class QuantumRunner:
             print(f"   Type: {component.component_type}")
             print(f"   Params: {len(component.params)}")
             print(f"   Returns: {len(component.returns)}")
-        
+
         try:
             result = self.component_runtime.execute_component(component)
             if result is not None:
@@ -163,14 +151,14 @@ class QuantumRunner:
             else:
                 print("[WARN] Component executed without return")
             return 0
-            
+
         except ComponentExecutionError as e:
             print(f"[ERROR] Execution error: {e}")
             return 1
         except PageRedirect as r:
             print(f"[REDIRECT] {r.status} {r.url}")
             return 0
-    
+
     def _execute_application(self, app: ApplicationNode, debug: bool = False) -> int:
         """Execute q:application"""
         print(f"[EXEC] Executing application: {app.app_id}")
@@ -251,7 +239,7 @@ class QuantumRunner:
         print(f"[EXEC] Executing job: {job.job_id}")
         if job.schedule:
             print(f"[INFO] Schedule: {job.schedule}")
-        
+
         # TODO: Implement real job execution
         print("[SUCCESS] Job executed successfully")
         return 0
@@ -260,7 +248,7 @@ class QuantumRunner:
 def main():
     """CLI entry point"""
     parser = argparse.ArgumentParser(
-        description='Quantum CLI - Execute .q files, start servers, and deploy applications',
+        description='Quantum CLI - Execute .q files and start servers',
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -273,9 +261,6 @@ Examples:
   quantum test                     # Run the app's *.test.q tests
   quantum run game.q --engine godot # Build Godot 4 project
   quantum run backup-job.q         # Execute job
-  quantum deploy ./my-app          # Deploy application
-  quantum apps                     # List deployed apps
-  quantum apps logs my-app         # View app logs
   quantum pkg init ./my-component  # Initialize new package
   quantum pkg install ./package    # Install package
   quantum pkg list                 # List installed packages
@@ -317,6 +302,10 @@ Examples:
     start_parser.add_argument('--port', type=int, help='Port (overrides config)')
     start_parser.add_argument('--config', default='quantum.config.yaml', help='Config file')
     start_parser.add_argument('--debug', action='store_true', help='Debug mode')
+    start_parser.add_argument('--hot-reload', action='store_true',
+                              help='Reload the open pages when a component or static file changes')
+    start_parser.add_argument('--hot-reload-port', type=int, default=None,
+                              help='WebSocket port for --hot-reload (default 35729)')
 
     # Stop command
     subparsers.add_parser('stop', help='Stop running web server')
@@ -346,13 +335,6 @@ Examples:
     from quantum.cli.admin import create_admin_parser
     create_admin_parser(subparsers)
 
-    # Deploy commands (if available)
-    deploy_available, create_deploy_parser, create_apps_parser, handle_deploy, handle_apps = _get_deploy_module()
-
-    if deploy_available:
-        create_deploy_parser(subparsers)
-        create_apps_parser(subparsers)
-
     # Package commands (if available)
     pkg_available, create_pkg_parser, handle_pkg = _get_pkg_module()
 
@@ -409,7 +391,9 @@ Examples:
         try:
             # Exit with whatever the server reports: a taken port or a failed
             # bind must not look like a clean start to a supervisor or CI.
-            sys.exit(start_server(args.config, port=getattr(args, 'port', None)) or 0)
+            sys.exit(start_server(args.config, port=getattr(args, 'port', None),
+                                  hot_reload=getattr(args, 'hot_reload', False),
+                                  hot_reload_port=getattr(args, 'hot_reload_port', None)) or 0)
         except Exception as e:
             print(f"[ERROR] Failed to start server: {e}")
             if getattr(args, 'debug', False):
@@ -455,24 +439,6 @@ Examples:
         exit_code = runner.run(args.file, getattr(args, 'debug', False))
         sys.exit(exit_code)
 
-    # Handle 'deploy' command
-    elif args.command == 'deploy':
-        if not deploy_available:
-            print("[ERROR] Deploy functionality not available.")
-            print(f"Missing dependency: {handle_apps}")
-            print("Install with: pip install requests")
-            sys.exit(1)
-        sys.exit(handle_deploy(args))
-
-    # Handle 'apps' command
-    elif args.command == 'apps':
-        if not deploy_available:
-            print("[ERROR] Apps functionality not available.")
-            print(f"Missing dependency: {handle_apps}")
-            print("Install with: pip install requests")
-            sys.exit(1)
-        sys.exit(handle_apps(args))
-
     # Handle 'jobs' command
     elif args.command == 'jobs':
         if not jobs_available:
@@ -510,7 +476,6 @@ Examples:
             runner = MigrationRunner(datasource=getattr(args, 'datasource', None))
 
             if args.migrate_command == 'status':
-                import json
                 status = runner.status()
                 print(f"\nDatabase: {status['database_type']}")
                 print(f"Applied migrations: {status['total_applied']}")