Update AGENTS.md, pyproject extras, and uv.lock.

.git_status_main.tmp

@@ -0,0 +1,13 @@
+ M .vscode/settings.json
+ M AGENTS.md
+ M __pycache__/chat_providers.cpython-314.pyc
+ M ai-projects/chat-cli/src/__pycache__/chat_cli.cpython-314.pyc
+ M ai-projects/chat-cli/src/__pycache__/chat_providers.cpython-314.pyc
+ M ai-projects/cooking-ai/src/agents/__pycache__/recipe_agent.cpython-314.pyc
+ M ai-projects/llm-maker/src/__pycache__/tool_executor.cpython-314.pyc
+ M ai-projects/llm-maker/src/__pycache__/tool_registry.cpython-314.pyc
+ M ai-projects/llm-maker/src/__pycache__/tool_validator.cpython-314.pyc
+ M pyproject.toml
+?? .git_status_main.tmp
+?? .git_status_short.tmp
+?? uv.lock

.git_status_short.tmp

@@ -0,0 +1,11 @@
+ M .vscode/settings.json
+ M __pycache__/chat_providers.cpython-314.pyc
+ M ai-projects/chat-cli/src/__pycache__/chat_cli.cpython-314.pyc
+ M ai-projects/chat-cli/src/__pycache__/chat_providers.cpython-314.pyc
+ M ai-projects/cooking-ai/src/agents/__pycache__/recipe_agent.cpython-314.pyc
+ M ai-projects/llm-maker/src/__pycache__/tool_executor.cpython-314.pyc
+ M ai-projects/llm-maker/src/__pycache__/tool_registry.cpython-314.pyc
+ M ai-projects/llm-maker/src/__pycache__/tool_validator.cpython-314.pyc
+ M pyproject.toml
+?? .git_status_short.tmp
+?? uv.lock

.vscode/settings.json

@@ -195,5 +195,12 @@
     "python-envs.defaultEnvManager": "ms-python.python:venv",
     "editor.formatOnSave": true,
     "editor.wordWrap": "on",
-    "iis.configDir": ""
+    "iis.configDir": "",
+    "cursorpyright.analysis.autoImportCompletions": true,
+    "cursorpyright.analysis.extraPaths": [
+        "./ai-projects/llm-maker/src",
+        "./aria_web",
+        "./tests/test_",
+        "./ai-projects/quantum-ml/src"
+    ]
 }

AGENTS.md

@@ -64,6 +64,19 @@ actions. Tag forms recognised include:
 - `[aria:wait:SECONDS]`
 - `[aria:effect:NAME:...]` (sparkle/hearts/glow map to a wave gesture)
 
+## Local LLM development
+
+- `local.settings.json` Values are auto-injected by `func host start`; standalone entry
+  points call `shared/local_settings.apply_local_settings()` (wired into `apps/aria/server.py`,
+  `ai-projects/chat-cli/src/chat_cli.py`, `shared/chat_providers.py`, `shared/config.py`).
+- Setup/probe helper: `scripts/setup_local_llm.py` — `--dry-run` (probe only, no writes/pulls),
+  `--write` (persist provider/model), `--pull-model <name>`, `--provider auto|ollama|lmstudio`.
+- Key env vars: `DEFAULT_AI_PROVIDER`, `ARIA_LLM_PROVIDER`, `OLLAMA_BASE_URL`, `OLLAMA_MODEL`,
+  `LMSTUDIO_BASE_URL`, `LMSTUDIO_MODEL`.
+- On Windows when `python` is not on PATH, prefer `uv run python …` / `uv run pytest …` from repo root.
+- Broken Linux devcontainer `.venv` on Windows (`.venv\lib64` access denied): remove `.venv`, then
+  `uv sync --extra dev` (requires `[tool.setuptools.packages.find]` scoped to `shared*`).
+
 ## Safety rules for AI agents
 
 - **Never modify `datasets/`** — read-only.
@@ -85,3 +98,17 @@ actions. Tag forms recognised include:
 - Config precedence: YAML base < CLI flags < per-job YAML < env vars
 - Chat dataset format: `[{"messages": [{"role": "...", "content": "..."}]}]`
 - LoRA adapters must include both `adapter_config.json` and `adapter_model.safetensors`
+
+## Learned User Preferences
+
+- Prefer `uv run` from repo root when Python is not on PATH (common on Windows).
+- Do not create new markdown docs for setup; use script `--help`/output or existing docs only.
+- Commit only task-related files; exclude unrelated hook/workflow/deletion changes from feature commits.
+- Do not commit unless explicitly requested.
+
+## Learned Workspace Facts
+
+- `scripts/setup_local_llm.py --dry-run` is the safe probe path (no file writes or model pulls).
+- Gitignore pattern `local_settings.py` also ignores `shared/local_settings.py`; use `git add -f` when committing that module.
+- Docs navigation: `docs/AI_REPO_INDEX.md` (code map) and `docs/QAI_DOCS_INDEX.md` (docs index).
+- Ollama on Windows can be installed non-interactively via `winget install Ollama.Ollama`.

pyproject.toml

@@ -67,6 +67,10 @@ warn_unused_ignores = true
 warn_return_any = false
 exclude = ["data_out/", "mount/", "venv/"]
 
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["shared*"]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 addopts = "-q --tb=short"