Struct AprSettings 

pub struct AprSettings {
    pub model: Option<String>,
    pub max_turns: Option<u32>,
    pub extra_system_prompt: Option<String>,
    pub project: Option<PathBuf>,
    pub permission_mode: Option<String>,
    pub allowed_hosts: Option<Vec<String>>,
}

Claude-Code-parity settings layer (apr code).

Every field is Option<_> so we can tell “explicitly set” apart from “use the next layer’s default” during merge. After merge, unset fields fall back to super::manifest::ModelConfig::default() / build_default_manifest values.

Fields

model: Option<String>

Path to local model file OR HuggingFace repo (e.g. qwen3:1.7b-q4k). Mirrors Claude Code’s model: "claude-3-5-sonnet-20241022".

max_turns: Option<u32>

Maximum REPL/agent turns before stopping. Claude Code uses no equivalent (it caps via budget); this is an apr-code-specific knob.

extra_system_prompt: Option<String>

Extra text appended to the agent’s system prompt. Mirrors Claude Code’s customApiKeyResponses / extraSystemPrompt.

project: Option<PathBuf>

Default working-directory project root override. Resolved relative to the settings file’s directory; absolute paths pass through.

permission_mode: Option<String>

Permission mode for the agent’s tool dispatch (PMAT-CODE-CONFIG-LADDER-FIELDS-001). Mirrors Claude Code’s permissionMode field. Accepts the camelCase / kebab-case / snake_case aliases that crate::agent::permission::PermissionMode::parse honors: "default" | "plan" | "acceptEdits" | "bypassPermissions" (and case-insensitive equivalents). Unknown strings produce a settings-load error from apply_settings_to_manifest (Poka-Yoke).

Stored as Option<String> rather than Option<PermissionMode> so the settings type stays JSON-trivial and so unknown values surface a clear apr code error message at apply time rather than a generic serde error at parse time.

allowed_hosts: Option<Vec<String>>

Hostnames the agent’s NetworkTool / BrowserTool may reach (PMAT-CODE-CONFIG-LADDER-FIELDS-001). Mirrors AgentManifest.allowed_hosts. Sovereign privacy tier always blocks network tools regardless of this list (Poka-Yoke; tier wins over config). Empty list = no network tools registered.

Implementations

impl AprSettings

pub fn merge(&mut self, other: &AprSettings)

Field-by-field merge: other wins over self for any Some(_) field. Used to fold project-local over user-global, then CLI over that.

pub fn from_json_str(buf: &str) -> Result<Self>

Parse JSON text into a settings layer. Empty/whitespace-only text is treated as “no settings here” (returns Default), matching the missing-file convention. Malformed JSON returns a hard error so the operator notices instead of silently running on partial config.

pub fn read_from_path(path: &Path) -> Result<Self>

Read a settings file. Missing files return Default (non-error). Malformed JSON or non-readable files are hard errors.

pub fn user_global_path() -> Option<PathBuf>

User-global settings path: $APR_CONFIG/settings.json if set, else ~/.config/apr/settings.json (XDG-style).

pub fn project_local_path(project_root: &Path) -> PathBuf

Project-local settings path: <project_root>/.apr/settings.json.

pub fn load_layered(project_root: &Path) -> Result<Self>

Load and merge the user-global → project-local layers. CLI overrides happen at the call site (after this returns).

Field precedence: project-local > user-global > defaults.

Trait Implementations

impl Clone for AprSettings

fn clone(&self) -> AprSettings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AprSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AprSettings

fn default() -> AprSettings

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AprSettings

where AprSettings: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AprSettings

fn eq(&self, other: &AprSettings) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AprSettings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AprSettings