From 0c2a6bb9d63e42a8a5379013c3d367b8f3b5bed5 Mon Sep 17 00:00:00 2001 From: Phoebus Date: Sun, 20 Sep 2026 14:33:19 -0700 Subject: [PATCH] docs: require an AI at install; AI-first system, legacy fallback Installing Phoebus now requires a connected model (remote provider or a user-downloaded local model; none is shipped). The installed system is AI-first and uses a connected model proactively. It is never required to boot, run or recover: the deterministic CLI (sys, emerge, nix, flatpak) remains as a break-glass fallback, and no model ever holds privilege. --- AGENTS.md | 11 ++++++----- docs/OBJECTIVES.md | 27 ++++++++++++++++----------- 2 files changed, 22 insertions(+), 16 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index e0aaed7..45541e4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,11 +11,12 @@ 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 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 +assistant and Nix are **defining, always-present subsystems**: installing +Phoebus **requires a connected model** (a remote provider or a downloaded local +model; none is shipped), the installed system is AI-first and uses a connected +model proactively, 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, with legacy commands as the fallback. 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 48777fc..ba0d801 100644 --- a/docs/OBJECTIVES.md +++ b/docs/OBJECTIVES.md @@ -33,11 +33,14 @@ Modern architecture + mature implementations - **Friendly to proprietary software** (drivers, firmware, codecs, Steam, 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 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. +- **AI-first, by design.** The assistant and Nix are defining, always-present + subsystems, not optional add-ons. **Installing Phoebus requires an AI**: the + installer will not complete without a connected model (a remote provider, or a + local model the user downloads; Phoebus ships none). The installed system is + AI-first — the assistant is the primary interface, and while a model is + connected the system uses it proactively. Legacy commands (`sys`, `emerge`, + `nix`, `flatpak`) always remain so the system can be operated and repaired by + hand if the AI is unavailable; nothing bricks. - **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 @@ -59,12 +62,14 @@ 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. -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. +Phoebus ships **no model**: the user connects a remote provider +(DeepSeek/OpenAI) or downloads a local model, and a configured provider only +ever receives approved, bounded system facts. **A connected model is required +to install**, and it is the primary way to operate the system: when one is +present, the assistant is used proactively. It is never required to boot, run +or recover — the deterministic command line (`sys`, `emerge`, `nix`, `flatpak`) +is always available as a break-glass fallback. 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