Add provider config layer (Phase 7)

ProfRandom92 · ProfRandom92 · commit c74f44ae024a · 2026-06-04T16:53:15.000+02:00
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -14,3 +14,5 @@ path = "src/main.rs"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
 ureq = "2.9"
+toml = "0.8"
+
diff --git a/PROJEKT.md b/PROJEKT.md
@@ -19,9 +19,9 @@ CompText CLI is an experimental terminal context client for building determinist
 
 ### Current State
 ```text
-CURRENT_PHASE: 7
-CURRENT_TASK: Provider Config Layer
-LAST_GREEN_PHASE: 6
+CURRENT_PHASE: 8
+CURRENT_TASK: OpenAI-Compatible Adapter
+LAST_GREEN_PHASE: 7
 STATUS: active
 ```
 
@@ -81,8 +81,8 @@ git push
 | **Phase 4C** | Long-Run Autonomy Hardening | Harden state machine progression rules and git safety boundaries | **COMPLETE** |
 | **Phase 5** | Proposal Mode | Implement `ctxt propose` to output changes as structured proposals | **COMPLETE** |
 | **Phase 6** | Apply Gate | Implement `ctxt apply` to confirm/apply changes and run verification | **COMPLETE** |
-| **Phase 7** | Provider Config Layer | Support dynamic provider profile switching and configurations | **ACTIVE** |
-| **Phase 8** | OpenAI-Compatible Adapter | Implement OpenAI adapter skeleton | *QUEUED* |
+| **Phase 7** | Provider Config Layer | Support dynamic provider profile switching and configurations | **COMPLETE** |
+| **Phase 8** | OpenAI-Compatible Adapter | Implement OpenAI adapter skeleton | **ACTIVE** |
 | **Phase 9** | Validate and Benchmark | Local validation, dry-runs, and deterministic benchmark flows | *QUEUED* |
 
 ---
diff --git a/comptext.example.toml b/comptext.example.toml
@@ -7,27 +7,29 @@ proposal_required = true
 kind = "dummy"
 network = false
 
-[providers.ollama_local]
+[providers.ollama-local]
 kind = "ollama"
 base_url = "http://localhost:11434"
 auth = "none"
 
-[providers.ollama_cloud_via_local]
+[providers.ollama-cloud-via-local]
 kind = "ollama"
 base_url = "http://localhost:11434"
 auth = "ollama_signin"
 model_suffix = "-cloud"
 
-[providers.ollama_cloud_direct]
+[providers.ollama-cloud-direct]
 kind = "ollama"
 base_url = "https://ollama.com"
 auth_env = "OLLAMA_API_KEY"
 
-[providers.openai_compatible]
+
+[providers.openai-compatible]
 kind = "openai-compatible"
 base_url = "http://localhost:11434/v1"
 auth_env = "OPTIONAL_API_KEY"
 
+
 [policy]
 network_default = "deny"
 allow_provider_network = false
diff --git a/docs/PROVIDER_CONFIG.md b/docs/PROVIDER_CONFIG.md
@@ -0,0 +1,52 @@
+# Provider Configuration Layer (Phase 7)
+
+`ctxt` supports repository-local and user-supplied configuration files formatted in TOML to define default execution flags, provider profiles, and network policies.
+
+## Config File Resolution
+
+When executing commands, the configuration path is resolved in the following priority order:
+1. Custom path specified via the global `--config <path>` command-line option.
+2. Default repository-local configuration `comptext.toml` in the working directory.
+3. Fallback repository-local configuration `comptext.example.toml` in the working directory.
+
+## TOML Schema Structure
+
+The configuration file supports three main tables:
+
+### 1. `[defaults]`
+* **`provider`** (string): The default provider profile name to use when no `--provider` parameter is specified in commands.
+* **`dry_run_default`** (boolean): Default dry-run behavior for actions.
+* **`proposal_required`** (boolean): Enforces checking proposal artifacts prior to executing code mutations.
+
+### 2. `[providers.<profile-name>]`
+* **`kind`** (string): The adapter kind (e.g. `"dummy"`, `"ollama"`, or `"openai-compatible"`).
+* **`network`** (boolean, optional): Determines if the provider profile requires active network sockets.
+* **`base_url`** (string, optional): Base endpoint for local or direct cloud providers.
+* **`auth`** (string, optional): Auth mode metadata description (e.g., `"none"` or `"ollama_signin"`).
+* **`auth_env`** (string, optional): The name of the environment variable containing the API credential (never the key itself).
+* **`model_suffix`** (string, optional): A suffix to append to requested models.
+
+### 3. `[policy]`
+* **`network_default`** (string): Default network gate behavior (e.g. `"deny"`).
+* **`allow_provider_network`** (boolean): Restricts provider execution from initializing network connections.
+* **`secrets_redaction`** (boolean): Enforces secret redaction on Context Pack artifacts.
+* **`apply_requires_confirmation`** (boolean): Forces manual human-in-the-loop confirmation before applying proposals.
+
+---
+
+## Example Usage
+
+### View Available Profiles
+```bash
+ctxt providers list
+```
+
+### View Config Diagnostics
+```bash
+ctxt doctor
+```
+
+### Override Config Path
+```bash
+ctxt --config path/to/my_config.toml ask "How do I build this project?"
+```
diff --git a/proposals/proposal.latest.json b/proposals/proposal.latest.json
@@ -12,7 +12,7 @@
     {
       "op": "patch",
       "path": "src/cli.rs",
-      "detail": "Mock patch generated by dummy provider: \"Mock LLM response from CompText Dummy Provider. Received prompt: \"Add context inspect\" Workspace context analyzed successfully: 55 files included. Dummy status: offline-test-provider ok.\""
+      "detail": "Mock patch generated by dummy provider: \"Mock LLM response from CompText Dummy Provider. Received prompt: \"Add context inspect\" Workspace context analyzed successfully: 56 files included. Dummy status: offline-test-provider ok.\""
     }
   ],
   "validation_commands": [
diff --git a/proposals/proposal_add_context_inspect.json b/proposals/proposal_add_context_inspect.json
@@ -12,7 +12,7 @@
     {
       "op": "patch",
       "path": "src/cli.rs",
-      "detail": "Mock patch generated by dummy provider: \"Mock LLM response from CompText Dummy Provider. Received prompt: \"Add context inspect\" Workspace context analyzed successfully: 55 files included. Dummy status: offline-test-provider ok.\""
+      "detail": "Mock patch generated by dummy provider: \"Mock LLM response from CompText Dummy Provider. Received prompt: \"Add context inspect\" Workspace context analyzed successfully: 56 files included. Dummy status: offline-test-provider ok.\""
     }
   ],
   "validation_commands": [
diff --git a/reports/phase_7_status.md b/reports/phase_7_status.md
@@ -0,0 +1,70 @@
+# CompText CLI — Phase 7 Status Report
+
+## Standard Return Schema
+PHASE: Phase 7: Provider Config Layer
+STATUS: success
+FILES_CHANGED:
+- Cargo.toml
+- comptext.example.toml
+- src/cli.rs
+- docs/PROVIDER_CONFIG.md
+- reports/phase_7_status.md
+- PROJEKT.md
+COMMANDS_RUN:
+- `cargo fmt --all --check`
+- `cargo check`
+- `cargo test`
+- `cargo clippy -- -D warnings`
+- `cargo run --bin ctxt -- providers list`
+- `cargo run --bin ctxt -- doctor`
+VALIDATION:
+- Verified formatting, lint checks, compilation and testing cleanly.
+- Added unit tests for parsing valid configuration files, throwing parse errors on malformed structures, and redacting secret keys in summary outputs. All 19 tests pass.
+- Added integration test verification mapping hyphenated adapter names.
+ARTIFACTS:
+- None
+GIT:
+- Stage, commit, and push pending.
+NETWORK:
+- offline-only (validations performed entirely offline).
+SECRETS:
+- verified-redacted (Secret metadata keys/tokens found in loaded provider configurations are redacted before formatting to terminal summaries).
+POLICY_DECISIONS:
+- Enforce fail-closed verification: malformed configuration files immediately throw errors and abort command execution.
+RISKS:
+- Handled profile name alignment (hyphen vs underscore keys) in `comptext.example.toml` to guarantee compatibility with pre-existing integration checks.
+SKILLS_USED:
+- `.agents/skills/ctxt-long-run-autonomy/SKILL.md`
+- `.agents/skills/ctxt-security/SKILL.md`
+- `.agents/skills/ctxt-provider-boundary/SKILL.md`
+- `.agents/skills/ctxt-context-pack/SKILL.md`
+- `.agent/skills/03_provider_adapter.md`
+- `.agent/skills/04_ollama_adapter.md`
+NEXT:
+- Phase 8: OpenAI-Compatible Adapter
+
+---
+
+## Detailed Notes & Output Samples
+
+### Configuration-based Command Execution
+`run` extracts `--config <path>` globally and loads configuration defaults (`default provider`, `dry_run_default`, `proposal_required`) and provider profile definitions.
+
+Sample of `ctxt providers list`:
+```text
+dummy	kind=dummy	network=false
+ollama-cloud-direct	kind=ollama	network=true	base_url=https://ollama.com	auth_env=OLLAMA_API_KEY
+ollama-cloud-via-local	kind=ollama	network=true	base_url=http://localhost:11434	auth=ollama_signin
+ollama-local	kind=ollama	network=true	base_url=http://localhost:11434	auth=none
+openai-compatible	kind=openai-compatible	network=true	base_url=http://localhost:11434/v1	auth_env=OPTIONAL_API_KEY
+```
+
+Sample of `ctxt doctor`:
+```text
+CompText doctor
+status: ok
+network_default: deny
+provider_default: dummy
+proposal_required: true
+secrets_policy: redact-before-artifact
+```
diff --git a/src/cli.rs b/src/cli.rs

Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`	`{`
`13`	`13`	`"op": "patch",`
`14`	`14`	`"path": "src/cli.rs",`
`15`		`- "detail": "Mock patch generated by dummy provider: \"Mock LLM response from CompText Dummy Provider. Received prompt: \"Add context inspect\" Workspace context analyzed successfully: 55 files included. Dummy status: offline-test-provider ok.\""`
	`15`	`+ "detail": "Mock patch generated by dummy provider: \"Mock LLM response from CompText Dummy Provider. Received prompt: \"Add context inspect\" Workspace context analyzed successfully: 56 files included. Dummy status: offline-test-provider ok.\""`
`16`	`16`	`}`
`17`	`17`	`],`
`18`	`18`	`"validation_commands": [`