# inspection

URL: /kida/api/inspection/
Section: api
Description: Explicit multi-root template inspection for tools and adapters.

The root inventory is filesystem-backed and namespaced by construction. Runtime
loader precedence remains a separate concern: inspection never infers ownership
from an unprefixed ``ChoiceLoader``.

---

> For a complete page index, fetch /kida/llms.txt.

Open LLM text
(/kida/api/inspection/index.txt)

Share with AI

Ask Claude
(https://claude.ai/new?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fkida%2Fapi%2Finspection%2Findex.txt)

Ask ChatGPT
(https://chatgpt.com/?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fkida%2Fapi%2Finspection%2Findex.txt)

Ask Gemini
(https://gemini.google.com/app?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fkida%2Fapi%2Finspection%2Findex.txt)

Ask Copilot
(https://copilot.microsoft.com/?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fkida%2Fapi%2Finspection%2Findex.txt)

Module

#
`inspection`

Explicit multi-root template inspection for tools and adapters.

The root inventory is filesystem-backed and namespaced by construction. Runtime
loader precedence remains a separate concern: inspection never infers ownership
from an unprefixed`ChoiceLoader`.

3Classes3Functions

## Classes

`TemplateRoot`

3

▼

One explicitly owned filesystem root for directory-wide inspection.

One explicitly owned filesystem root for directory-wide inspection.

#### Attributes

Name
Type
Description

`namespace`

`str`

—

`path`

`Path`

—

#### Methods

Internal Methods
1

▼

`__post_init__`

0

▼

`def __post_init__(self) -> None`

`ComponentRecord`

4

▼

One component definition with stable root ownership and source facts.

One component definition with stable root ownership and source facts.

#### Attributes

Name
Type
Description

`owner`

`str`

—

`template`

`str`

—

`source_path`

`str`

—

`metadata`

`DefMetadata`

—

`ComponentInspection`

3

▼

Policy-neutral result of inspecting components across explicit roots.

Policy-neutral result of inspecting components across explicit roots.

#### Attributes

Name
Type
Description

`components`

`tuple[ComponentRecord, ...]`

—

`diagnostics`

`tuple[Diagnostic, ...]`

—

`partial`

`bool`

—

## Functions

`diagnose_roots`

3

`DiagnosticReport`

▼

Diagnose explicitly namespaced roots with one deterministic inventory.

`def diagnose_roots(roots: Iterable[TemplateRoot], *, environment: Environment | None = None, options: DiagnosticOptions = _DEFAULT_OPTIONS) -> DiagnosticReport`

##### Parameters

Name
Type
Description

`roots`
`Iterable[TemplateRoot]`

`environment`
`Environment | None`

Default:`None`

`options`
`DiagnosticOptions`

Default:`_DEFAULT_OPTIONS`

##### Returns

`DiagnosticReport`

`inspect_components`

3

`ComponentInspection`

▼

Collect component metadata across explicitly namespaced roots.

`def inspect_components(roots: Iterable[TemplateRoot], *, environment: Environment | None = None, filter_name: str | None = None) -> ComponentInspection`

##### Parameters

Name
Type
Description

`roots`
`Iterable[TemplateRoot]`

`environment`
`Environment | None`

Default:`None`

`filter_name`
`str | None`

Default:`None`

##### Returns

`ComponentInspection`

`advise_encapsulation_roots`

3

`DiagnosticReport`

▼

Return opt-in extraction and flattening advice across owned roots.

`def advise_encapsulation_roots(roots: Iterable[TemplateRoot], *, environment: Environment | None = None, context: Iterable[AdviceContext] = _EMPTY_ADVICE_CONTEXT) -> DiagnosticReport`

##### Parameters

Name
Type
Description

`roots`
`Iterable[TemplateRoot]`

`environment`
`Environment | None`

Default:`None`

`context`
`Iterable[AdviceContext]`

Default:`_EMPTY_ADVICE_CONTEXT`

##### Returns

`DiagnosticReport`