Add AppManager framework

Author: ThomasFarstrike

docs/apps/creating-apps.md

@@ -107,7 +107,7 @@ If the app is installed into the /apps/ folder, it should show up in the launche
 You can also launch it manually by typing this in the MicroPython REPL:
 
 ```
-import mpos.apps; mpos.apps.start_app('apps/com.micropythonos.helloworld/')
+from mpos import AppManager ; AppManager.start_app('apps/com.micropythonos.helloworld/')
 ```
 
 

docs/architecture/frameworks.md

@@ -56,6 +56,26 @@ class MyFramework:
 
 ## Available Frameworks
 
+### AppManager
+Manages app discovery, installation, launching, and version management.
+
+```python
+from mpos.content.app_manager import AppManager
+
+# Get all installed apps
+apps = AppManager.get_app_list()
+
+# Start an app
+AppManager.start_app("com.example.myapp")
+
+# Install from .mpk file
+AppManager.install_mpk("/tmp/app.mpk", "apps/com.example.newapp")
+
+# Check for updates
+if AppManager.is_update_available("com.example.myapp", "2.0.0"):
+    print("Update available")
+```
+
 ### AppearanceManager
 Manages visual appearance: light/dark mode, theme colors, UI dimensions, and LVGL styling.
 
@@ -180,9 +200,11 @@ from mpos import (
     SensorManager,
     TaskManager
 )
+from mpos.content.app_manager import AppManager
 
 def init_frameworks():
     """Initialize all frameworks."""
+    AppManager.refresh_apps()  # Discover all installed apps
     AppearanceManager.init(prefs)  # Requires SharedPreferences
     AudioFlinger.init()
     DownloadManager.init()
@@ -192,6 +214,8 @@ def init_frameworks():
     TaskManager.init()
 ```
 
+**Note:** AppManager doesn't require explicit initialization - call `refresh_apps()` to discover apps at startup.
+
 ## Creating New Frameworks
 
 When creating a new framework, follow this template:
@@ -278,10 +302,12 @@ from mpos import (
     SharedPreferences,
     TaskManager,
     WifiService,
-    PackageManager,
 )
+from mpos.content.app_manager import AppManager
 ```
 
+**Note:** AppManager is imported from `mpos.content.app_manager` rather than the main `mpos` module.
+
 ## Benefits of Harmonization
 
 | Aspect | Before | After |
@@ -357,6 +383,7 @@ class TestMyFramework(unittest.TestCase):
 
 ## See Also
 
+- [AppManager](../frameworks/app-manager.md): App discovery, installation, and launching
 - [System Components](system-components.md): Overview of all system components
 - [Architecture Overview](overview.md): High-level design principles
 - [App Development Guide](../apps/index.md): How to use frameworks in apps