Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
"""Unit tests for file-page provenance + layer metadata attachment."""
from __future__ import annotations
from types import SimpleNamespace
from repowise.core.generation.models import GeneratedPage
from repowise.core.generation.page_generator.core import _attach_file_provenance
def _page() -> GeneratedPage:
return GeneratedPage(
page_id="file_page:pkg/foo.py",
page_type="file_page",
title="File: pkg/foo.py",
content="",
source_hash="x",
model_name="mock",
provider_name="mock",
input_tokens=0,
output_tokens=0,
cached_tokens=0,
generation_level=2,
target_path="pkg/foo.py",
created_at="2026-01-01T00:00:00+00:00",
updated_at="2026-01-01T00:00:00+00:00",
)
def _ctx(**over):
base = dict(
file_path="pkg/foo.py",
kg_layer_name="",
kg_layer_id="",
kg_layer_role="",
dependencies=[],
decision_records=[],
)
base.update(over)
return SimpleNamespace(**base)
def test_layer_metadata_attached():
page = _page()
_attach_file_provenance(
page,
_ctx(
kg_layer_name="Domain",
kg_layer_id="layer:domain",
kg_layer_role="entry_point",
),
)
assert page.metadata["layer_name"] == "Domain"
# Stable slug id is attached so the UI joins file -> layer page by id.
assert page.metadata["layer_id"] == "layer:domain"
assert page.metadata["layer_role"] == "entry_point"
def test_curated_layer_without_an_id_still_gets_one():
"""A curated layer_name with no id used to leave the page unjoinable.
Consumers group on layer_id, so a page carrying only the display name
dropped out of the architecture ordering entirely.
"""
page = _page()
_attach_file_provenance(page, _ctx(kg_layer_name="Shared UI Components"))
assert page.metadata["layer_id"] == "layer:shared-ui-components"
def test_every_file_page_carries_a_layer_id():
for ctx in (
_ctx(),
_ctx(kg_layer_name="Domain", kg_layer_id="layer:domain"),
_ctx(kg_layer_name="Ingestion and Reasoning"),
_ctx(file_path="src/api/users.py"),
):
page = _page()
_attach_file_provenance(page, ctx)
assert page.metadata.get("layer_id", "").startswith("layer:")
def test_no_kg_layer_falls_back_to_inferred_layer():
# Every file page must carry a layer_name so the Architecture tree can
# group it; with no KG layer it is inferred from the path, and the
# layer_id is the slug of that inferred name.
page = _page()
_attach_file_provenance(page, _ctx(file_path="src/api/users.py"))
assert page.metadata["layer_name"] == "API"
assert page.metadata["layer_id"] == "layer:api"
# No KG role is invented for the fallback path.
assert "layer_role" not in page.metadata
def test_sources_from_dependencies_and_decisions():
page = _page()
ctx = _ctx(
dependencies=["pkg/bar.py", "pkg/baz.py"],
decision_records=[{"evidence_file": "docs/adr-1.md"}, {"source": "pkg/bar.py"}],
)
_attach_file_provenance(page, ctx)
sources = page.metadata["sources"]
paths = [s["path"] for s in sources]
assert "pkg/bar.py" in paths
assert "pkg/baz.py" in paths
assert "docs/adr-1.md" in paths
# bar.py already recorded as a dependency — not duplicated by the decision.
assert paths.count("pkg/bar.py") == 1
assert {s["kind"] for s in sources} == {"dependency", "decision"}
def test_no_sources_means_no_key():
page = _page()
_attach_file_provenance(page, _ctx())
assert "sources" not in page.metadata
def test_dependencies_capped_at_ten():
page = _page()
_attach_file_provenance(page, _ctx(dependencies=[f"d{i}.py" for i in range(20)]))
assert len(page.metadata["sources"]) == 10
def test_fallback_layer_id_matches_the_id_curation_would_mint():
"""A near-miss id points a file page at a layer page that does not exist."""
from repowise.core.analysis.knowledge_graph import _slugify
from repowise.core.generation.layers import DEFAULT_LAYER, DOCS_TOOLING_LAYER
for name in ("UI", "CLI", "API", "Service", "Data", "Types", "Config",
"Utility", "Test", "Middleware", DEFAULT_LAYER, DOCS_TOOLING_LAYER):
page = _page()
_attach_file_provenance(page, _ctx(kg_layer_name=name))
assert page.metadata["layer_id"] == f"layer:{_slugify(name)}"