diff --git a/AGENTS.md b/AGENTS.md index 844c89f..e0aaed7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,10 +11,11 @@ It is deliberately concrete: follow it rather than rediscovering the project. Phoebus OS is a **modern, stable, Gentoo-based workstation operating system**: systemd, Wayland-first, PipeWire, UEFI/GPT, LUKS2, Btrfs with snapshots, a fast dwl-style desktop, Flatpak, and a built-in AI administration assistant. The AI -assistant and Nix are **defining, always-present subsystems**: the assistant -ships with a **local model** so it works offline and in recovery, and Nix is a -second package lane shipped and updated through Portage. Installation requires -the network; the installed system must boot, run and recover without it. The +assistant and Nix are **defining, always-present subsystems**: the assistant is +built in and *model-optional* (the user may download a local model or configure +a remote provider; no model is shipped), and Nix is a second package lane +shipped and updated through Portage. Installation requires the network; the +installed system must boot, run and recover without it. The LLM never holds privilege (see ยง2.4). Fastest start: run `make context` (prints repository state, the roadmap's diff --git a/docs/OBJECTIVES.md b/docs/OBJECTIVES.md index 381fa06..48777fc 100644 --- a/docs/OBJECTIVES.md +++ b/docs/OBJECTIVES.md @@ -34,9 +34,10 @@ Modern architecture + mature implementations browsers) where legally distributable. No moralising warnings; respect licences. - **AI-first, built in.** The assistant and Nix are defining, always-present - subsystems, not optional add-ons. The assistant ships with a **local model** - so it works offline; remote providers are an optional upgrade. A Phoebus - system must boot, run and recover without the network. + subsystems, not optional add-ons. The assistant is **model-optional**: Phoebus + ships no model, but the user can download a local one or configure a remote + provider. With no model it still explains, plans and applies validated, + deterministic changes. A Phoebus system must boot, run and recover offline. - **Nix as a second, built-in package lane.** Portage stays authoritative for the system (kernel, drivers, systemd, Mesa, PipeWire, core libraries, boot, services); Nix provides developer tools, alternate versions and reproducible @@ -58,10 +59,12 @@ The model never receives the user's sudo password (authentication happens through sudo/polkit/PAM outside model context), and it has no code path to read private files: system access is not home-directory access. -The default brain is a **local model**, so the assistant works without a network -and inside recovery. Remote providers (DeepSeek/OpenAI) are optional and only -ever receive approved, bounded system facts. Installation requires the network -(stage3, Portage, packages); the installed system must not. +Phoebus ships **no model**. The assistant is *model-optional*: the user may +download a local model or configure a remote provider (DeepSeek/OpenAI), and a +configured provider only ever receives approved, bounded system facts. With no +model, the assistant still offers offline explainers, planning and validated +deterministic actions, and the CLI is always available. Installation requires +the network (stage3, Portage, packages); the installed system must not. The assistant is the **preferred front-end, never a gate**. The deterministic command line is always available with no model, and a user who wants the