chore(terminology): address review findings from #1256

Four user-facing error strings in adapter.py still said "intrinsic" as prose,
directly violating issue #1192 criterion #4 ("Done when: no 'intrinsic' prose
remains in the five Phase 0 files"). Sweep the four f-strings:
  - "Intrinsic '{name}' not available as an adapter of type …"
  - "io.yaml for intrinsic '{name}' …"
  - "No adapter found for intrinsic '{name}' in {path}" (×2)

Sweep remaining user-visible prose in two other files:
  - openai.py:582 — "has no adapter for processing intrinsic: …"
  - rag.py:206   — "Citation generation intrinsic failed: …"

Fix openai.md section heading ("## Intrinsics with Granite Switch" →
"## Adapter functions with Granite Switch") — body was swept in prior
commit but heading was missed, leaving the section self-contradictory.

Sweep intrinsics.md page title and body prose (title, opening paragraph,
backend-note callout, reuse-note, Direct-usage heading, catalog reference)
to use "adapter functions" throughout. File slug rename is deferred to
Phase 4 (#1144); the page content is swept here to keep it consistent
with the cross-references that now point to it as "Adapter functions".

Fix three remaining safety-guardrails links without .md suffix in
common-errors.md and the lora-and-alora-adapters link in
prefix-caching-and-kv-blocks.md.

Assisted-by: Claude Code
Signed-off-by: Nigel Jones <jonesn@uk.ibm.com>

Author: planetf1

docs/docs/advanced/intrinsics.md

@@ -1,5 +1,5 @@
 ---
-title: "Intrinsics"
+title: "Adapter functions"
 description: "Adapter-accelerated RAG quality checks using LoRA/aLoRA adapters with Granite models."
 # diataxis: how-to
 ---
@@ -8,22 +8,22 @@ description: "Adapter-accelerated RAG quality checks using LoRA/aLoRA adapters w
 Silicon Mac recommended), or `pip install mellea` for OpenAIBackend with a
 [Granite Switch](/reference/glossary#granite-switch) model served via vLLM.
 
-Intrinsics are adapter-accelerated operations for RAG quality checks. They use
+Adapter functions are adapter-accelerated operations for RAG quality checks. They use
 LoRA/aLoRA adapters loaded directly into the HuggingFace backend — faster and more
 reliable than prompting a general-purpose model for these specialized micro-tasks.
 
-> **Backend note:** Intrinsics work with two backends:
+> **Backend note:** Adapter functions work with two backends:
 >
 > - **LocalHFBackend** — loads LoRA/aLoRA adapters from the catalog at runtime.
->   All intrinsics are available. Requires a GPU or Apple Silicon Mac.
+>   All adapter functions are available. Requires a GPU or Apple Silicon Mac.
 > - **OpenAIBackend** — uses a Granite Switch model served via vLLM with
->   `load_embedded_adapters=True`. Only intrinsics embedded in the model are
+>   `load_embedded_adapters=True`. Only adapter functions embedded in the model are
 >   available — check the model's `adapter_index.json` for the list.
 >   See `docs/docs/examples/granite-switch/README.md`
 >
-> Intrinsics do not work with Ollama or other remote backends.
+> Adapter functions do not work with Ollama or other remote backends.
 
-Set up the backend once and reuse it across intrinsic calls:
+Set up the backend once and reuse it across adapter function calls:
 
 ```python
 # Requires: mellea[hf]
@@ -209,7 +209,7 @@ print(result)
 # Maps each response sentence to supporting document sentences
 ```
 
-## Direct intrinsic usage
+## Direct adapter function usage
 
 > **Advanced:** For custom adapter tasks, use the `Intrinsic` component and
 > `CustomIntrinsicAdapter` directly.
@@ -249,7 +249,7 @@ print(out)  # {"requirement_likelihood": 1.0}
 
 The `Intrinsic` component loads aLoRA adapters (falling back to LoRA) by task name.
 For OpenAI backends with Granite Switch, adapters are loaded from the model's
-HuggingFace repository configuration instead of the intrinsic catalog.
+HuggingFace repository configuration instead of the adapter function catalog.
 Output format is task-specific — `requirement-check` returns a likelihood score.
 
 ---

docs/docs/advanced/prefix-caching-and-kv-blocks.md

@@ -133,4 +133,4 @@ reused.
 
 **See also:** [HuggingFace Transformers](../integrations/huggingface) |
 [Adapter functions](./intrinsics.md) |
-[LoRA and aLoRA Adapters](./lora-and-alora-adapters)
+[LoRA and aLoRA Adapters](./lora-and-alora-adapters.md)

docs/docs/integrations/openai.md

@@ -258,7 +258,7 @@ m = MelleaSession(
 > LiteLLM provides a verified integration — see
 > [Backends and Configuration](../how-to/backends-and-configuration).
 
-## Intrinsics with Granite Switch
+## Adapter functions with Granite Switch
 
 Granite Switch models embed LoRA/aLoRA adapters directly in the model weights.
 When served via vLLM, these adapters enable adapter functions (RAG quality

docs/docs/troubleshooting/common-errors.md

@@ -215,7 +215,7 @@ nest_asyncio.apply()
 Guardian adapter functions (`guardian_check()`, `policy_guardrails()`,
 `factuality_detection()`, `factuality_correction()`) require `LocalHFBackend`
 with an IBM Granite model.
-See [Safety Guardrails](../how-to/safety-guardrails) for full usage.
+See [Safety Guardrails](../how-to/safety-guardrails.md) for full usage.
 
 ### `guardian_check()` returns unexpected scores
 
@@ -234,7 +234,7 @@ Use the Guardian adapter functions instead
 ```
 
 Replace `GuardianCheck` / `GuardianRisk` imports with the Guardian adapter functions API.
-See [Safety Guardrails](../how-to/safety-guardrails) for migration guidance.
+See [Safety Guardrails](../how-to/safety-guardrails.md) for migration guidance.
 
 ---
 
@@ -250,4 +250,4 @@ See [Safety Guardrails](../how-to/safety-guardrails) for migration guidance.
 **See also:**
 [Quick Start](../getting-started/quickstart) |
 [Inference-Time Scaling](../advanced/inference-time-scaling) |
-[Safety Guardrails](../how-to/safety-guardrails)
+[Safety Guardrails](../how-to/safety-guardrails.md)

mellea/backends/adapters/adapter.py

@@ -126,7 +126,7 @@ def __init__(
 
         if adapter_type not in self.intrinsic_metadata.adapter_types:
             raise ValueError(
-                f"Intrinsic '{intrinsic_name}' not available as an adapter of type "
+                f"Adapter function '{intrinsic_name}' not available as an adapter of type "
                 f"'{adapter_type}. Available types are "
                 f"{self.intrinsic_metadata.adapter_types}."
             )
@@ -390,7 +390,7 @@ def from_model_directory(
             io_config_path = model_path / io_config_rel
             if not io_config_path.exists():
                 raise ValueError(
-                    f"io.yaml for intrinsic '{entry_name}' "
+                    f"io.yaml for adapter function '{entry_name}' "
                     f"not found at {io_config_path}"
                 )
 
@@ -408,7 +408,7 @@ def from_model_directory(
         if not adapters:
             if intrinsic_name is not None:
                 raise ValueError(
-                    f"No adapter found for intrinsic '{intrinsic_name}' in {model_path}"
+                    f"No adapter found for adapter function '{intrinsic_name}' in {model_path}"
                 )
             raise ValueError(f"No adapters found in {model_path}")
 
@@ -465,7 +465,7 @@ def from_hub(
         except ValueError as e:
             if intrinsic_name is not None:
                 raise ValueError(
-                    f"No adapter found for intrinsic '{intrinsic_name}' in {repo_id}"
+                    f"No adapter found for adapter function '{intrinsic_name}' in {repo_id}"
                 ) from e
             raise ValueError(f"No adapters found in {repo_id}") from e
 

mellea/backends/openai.py

@@ -579,7 +579,7 @@ async def _generate_from_intrinsic(
         )
         if adapter is None:
             raise ValueError(
-                f"backend ({self}) has no adapter for processing intrinsic: "
+                f"backend ({self}) has no adapter for processing adapter function: "
                 f"{action.intrinsic_name}"
             )
 

mellea/stdlib/requirements/rag.py

@@ -203,7 +203,7 @@ async def validate(
                 )
         except Exception as e:
             return ValidationResult(
-                False, reason=f"Citation generation intrinsic failed: {e!s}"
+                False, reason=f"Citation generation adapter function failed: {e!s}"
             )
 
         # Step 2: Citation Necessity