refactor: split AI desktop runtime profile #121
No reviewers
Labels
No labels
host:electra
host:fleet
host:lyra
host:vega
host:vega
phase:cutover
phase:deploy
phase:mcp
phase:module
phase:packaging
phase:prep
phase:validation
project:attic-postgres-lyra-rollout
project:auto-update-reliability
project:declarative-purity-cleanup
project:external-review
project:host-facts-refactor
project:lyra-nixos-deploy
project:lyra-service-stack-migration
project:nebula-mesh-network
project:security-hardening
project:service-stack-migration
project:vega-sillytavern-cutover
service:auto-update
service:mem0
service:sillytavern
No milestone
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set
Reference
nimmo/nixos-config!121
Loading…
Reference in a new issue
No description provided.
Delete branch "feat/decompose-ai-desktop"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Closes #115
Make ai-desktop.nix a focused composition point. Extract the coupled OpenCode/Paseo runtime into ai-runtime.nix, including the OpenCode system service, client/MCP configuration, SOPS-backed credentials, Tea setup, Paseo wrapper, and Home Manager integration. Keep shared AI client integration in ai-agents.nix and document the resulting ownership.
Validation:
Automated code review
Reviewed commit:
7914f202bd5676ba0d5d3f52f594b74072196dbeVerdict: Ready to merge
No blocking or important findings were retained, and deterministic checks passed. Suggestions remain advisory.
Overall assessment
Refactors the AI desktop profile by extracting the coupled OpenCode/Paseo runtime, SOPS-backed credentials, systemd services, and Home Manager wiring into a new
ai-runtime.nixmodule.ai-desktop.nixis reduced to a focused composition point that importsai-agents.nixandai-runtime.nix, while documentation and architecture rules are updated to reflect the new ownership boundaries.Blocking findings
None.
Important findings
None.
Suggestions
The new file contains 431 lines combining OpenCode daemon/client configuration, Paseo runtime packaging, SOPS-backed credentials, systemd service definitions, and Home Manager activation scripts.
Impact: High coupling increases maintenance overhead and makes isolated testing or independent updates for components like Paseo or OpenCode more difficult.
Suggested fix: Consider splitting
ai-runtime.nixinto smaller, focused modules (e.g., separating the Paseo desktop runtime from the OpenCode service/client) if future changes require independent versioning or configuration.Tests and validation
Questions
ai-runtime.nixcontains 431 lines of configuration, is there an intention to further split it into smaller modules (e.g., separating Paseo runtime from OpenCode service/client), or is it intended to remain the single authoritative owner for this coupled runtime contract?Review limitations
Diff coverage
README.md: reviewed — included in a context-limited batchmodules/profiles/ai-desktop.nix: reviewed — included in a context-limited batchmodules/profiles/ai-runtime.nix: reviewed — included in a context-limited batchReview metadata