Skip to content

Dianel555/DSkills / skills/agent-wiki

agent-wiki

Unverified

Incremental LLM-friendly wiki generator for Obsidian note vaults. Use when: (1) Building wiki from notes, (2) Ingesting notes to wiki, (3) Obsidian LLM wiki, (4) Incremental knowledge base management. Triggers: 'build wiki from notes', 'ingest notes to wiki', 'Obsidian LLM wiki', 'incremental knowledge base'.

FileKindSize
.env.exampleother408 B
README.mdmarkdown15.3 KB
SKILL.mdskill md23.3 KB
pyproject.tomlmanifest2.1 KB
references/cli-matrix.mdmarkdown5.9 KB
references/homepage.mdmarkdown6.1 KB
references/index-schema.mdmarkdown6.9 KB
references/site-export.mdmarkdown3.1 KB
references/topic-authoring.mdmarkdown5.1 KB
scripts/agent_wiki/__init__.pyscript103 B
scripts/agent_wiki/authors.pyscript3.9 KB
scripts/agent_wiki/bases.pyscript4.0 KB
scripts/agent_wiki/batch.pyscript3.7 KB
scripts/agent_wiki/boundary.pyscript55.8 KB
scripts/agent_wiki/cache.pyscript5.5 KB
scripts/agent_wiki/canvas.pyscript8.0 KB
scripts/agent_wiki/cleanup.pyscript2.4 KB
scripts/agent_wiki/cli.pyscript97 B
scripts/agent_wiki/commands.pyscript28.3 KB
scripts/agent_wiki/config.pyscript4.2 KB
scripts/agent_wiki/coverage.pyscript2.1 KB
scripts/agent_wiki/frontmatter.pyscript1.6 KB
scripts/agent_wiki/home.pyscript7.9 KB
scripts/agent_wiki/keywords.pyscript2.0 KB
scripts/agent_wiki/links.pyscript14.7 KB
scripts/agent_wiki/plugins.pyscript2.1 KB
scripts/agent_wiki/quality.pyscript7.6 KB
scripts/agent_wiki/scanner.pyscript6.7 KB
scripts/agent_wiki/site.pyscript39.2 KB
scripts/agent_wiki/source_type.pyscript3.2 KB
scripts/agent_wiki/wiki_index.pyscript17.4 KB
scripts/agent_wiki/worklist.pyscript5.7 KB
scripts/agent_wiki_cli.pyscript5.5 KB
templates/home/academic.mdmarkdown2.9 KB
templates/home/dashboard.mdmarkdown2.7 KB
templates/home/magazine.mdmarkdown2.5 KB
templates/query/research.mdmarkdown787 B
tests/conftest.pyscript177 B
tests/fixtures/sample_vault/attachments/image.pngbinary26 B
tests/fixtures/sample_vault/课程/双缝实验.mdmarkdown47 B
tests/fixtures/sample_vault/课程/量子力学.mdmarkdown75 B
tests/test_alias_resolution.pyscript7.5 KB
tests/test_authors.pyscript2.2 KB
tests/test_backlinks.pyscript7.0 KB
tests/test_bases.pyscript4.7 KB
tests/test_batch.pyscript3.0 KB
tests/test_benchmark_index.pyscript2.1 KB
tests/test_boundary_platform.pyscript695 B
tests/test_cache.pyscript2.1 KB
tests/test_cache_strict.pyscript2.1 KB
tests/test_canvas.pyscript8.3 KB
tests/test_capture.pyscript5.5 KB
tests/test_cleanup.pyscript1.2 KB
tests/test_cleanup_init_strict.pyscript2.1 KB
tests/test_cli.pyscript6.2 KB
tests/test_config.pyscript2.0 KB
tests/test_coverage.pyscript7.2 KB
tests/test_e2e.pyscript2.5 KB
tests/test_evaluate_enhancements.pyscript14.7 KB
tests/test_featured_base.pyscript4.3 KB
tests/test_final_security_review.pyscript6.6 KB
tests/test_frontmatter.pyscript1.1 KB
tests/test_gen_home.pyscript4.9 KB
tests/test_gen_site_cli.pyscript3.9 KB
tests/test_home.pyscript7.7 KB
tests/test_immutability.pyscript1.4 KB
tests/test_immutability_capture.pyscript2.4 KB
tests/test_index_capture.pyscript4.5 KB
tests/test_index_cli.pyscript5.4 KB
tests/test_index_extension.pyscript17.0 KB
tests/test_index_source_count.pyscript3.0 KB
tests/test_package_structure.pyscript3.4 KB
tests/test_plugins.pyscript3.1 KB
tests/test_quality.pyscript21.3 KB
tests/test_quality_cli.pyscript5.5 KB
tests/test_quality_prose_weight.pyscript3.8 KB
tests/test_quality_script_fairness.pyscript4.7 KB
tests/test_quality_tier_refactor.pyscript4.0 KB
tests/test_scanner.pyscript2.6 KB
tests/test_scanner_fast_path.pyscript3.5 KB
tests/test_scanner_strict.pyscript2.1 KB
tests/test_secure_temporary_writes.pyscript978 B
tests/test_site.pyscript20.2 KB
tests/test_site_import_isolation.pyscript3.9 KB
tests/test_site_slug_refactor.pyscript3.6 KB
tests/test_source_type.pyscript3.5 KB
tests/test_status_metrics.pyscript4.1 KB
tests/test_status_quality.pyscript5.3 KB
tests/test_status_worklist.pyscript3.0 KB
tests/test_structure.pyscript501 B
tests/test_topic_category.pyscript4.2 KB
tests/test_topic_path_boundary.pyscript2.2 KB
tests/test_vault_boundary.pyscript24.3 KB
tests/test_wiki_index.pyscript13.3 KB
tests/test_worklist.pyscript12.3 KB
tests/test_worklist_cli.pyscript1.9 KB

tests/test_coverage.py

View on GitHub
"""Tests for coverage and gap reporting."""

from pathlib import Path

import pytest
from agent_wiki import config, frontmatter, wiki_index


def _topic(vault: Path, name: str, meta: dict, body: str = "x") -> Path:
    topics = config.topics_dir(vault)
    topics.mkdir(parents=True, exist_ok=True)
    path = topics / name
    path.write_text(frontmatter.dump(meta, body), encoding="utf-8")
    return path


def _source(vault: Path, rel_path: str, content: str = "# Source") -> Path:
    path = vault / rel_path
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content, encoding="utf-8")
    return path


def _init(vault: Path) -> None:
    config.topics_dir(vault).mkdir(parents=True, exist_ok=True)


# --- 2.5 Coverage tests ---


def test_coverage_reports_covered_and_gaps(tmp_path):
    """coverage distinguishes covered sources from gaps."""
    from agent_wiki import coverage

    _init(tmp_path)
    _source(tmp_path, "notes/covered.md", "Covered source.")
    _source(tmp_path, "notes/gap.md", "Uncovered gap.")

    _topic(tmp_path, "topic.md", {"title": "Topic", "sources": ["notes/covered.md"]}, "Content.")

    result = coverage.compute_coverage(tmp_path)

    assert result["ok"] is True
    assert result["covered"] == 1
    assert len(result["gaps"]) == 1
    assert result["gaps"][0]["path"] == "notes/gap.md"


def test_coverage_partition_scan_set(tmp_path):
    """covered + gaps = scan set (disjoint)."""
    from agent_wiki import coverage

    _init(tmp_path)
    _source(tmp_path, "a.md", "A")
    _source(tmp_path, "b.md", "B")
    _source(tmp_path, "c.md", "C")

    _topic(tmp_path, "t1.md", {"title": "T1", "sources": ["a.md"]}, "Content.")
    _topic(tmp_path, "t2.md", {"title": "T2", "sources": ["b.md"]}, "Content.")

    result = coverage.compute_coverage(tmp_path)

    # a.md, b.md covered; c.md gap
    assert result["covered"] == 2
    assert len(result["gaps"]) == 1


def test_coverage_ratio_bounds(tmp_path):
    """coverage_ratio ∈ [0, 1]."""
    from agent_wiki import coverage

    _init(tmp_path)
    _source(tmp_path, "source.md", "Source.")

    # 0% coverage
    result_zero = coverage.compute_coverage(tmp_path)
    assert 0.0 <= result_zero["coverage_ratio"] <= 1.0

    # 100% coverage
    _topic(tmp_path, "topic.md", {"title": "Topic", "sources": ["source.md"]}, "Content.")
    result_full = coverage.compute_coverage(tmp_path)
    assert result_full["coverage_ratio"] == 1.0


def test_coverage_empty_scan_set_is_one(tmp_path):
    """coverage_ratio = 1.0 when scan set empty (vacuously covered)."""
    from agent_wiki import coverage

    _init(tmp_path)
    # No sources

    result = coverage.compute_coverage(tmp_path)

    assert result["coverage_ratio"] == 1.0


def test_coverage_is_read_only(tmp_path):
    """coverage does not modify any files."""
    from agent_wiki import coverage

    _init(tmp_path)
    _source(tmp_path, "source.md", "Source.")

    before_files = {f: f.read_bytes() for f in tmp_path.rglob("*.md")}

    coverage.compute_coverage(tmp_path)

    after_files = {f: f.read_bytes() for f in tmp_path.rglob("*.md")}

    assert before_files == after_files


def test_coverage_requires_initialized_wiki(tmp_path):
    """coverage fails when wiki/ missing."""
    from agent_wiki import coverage

    # No wiki/ directory

    with pytest.raises(Exception) as exc_info:
        coverage.compute_coverage(tmp_path)

    assert "wiki_not_initialized" in str(exc_info.value).lower() or not (tmp_path / "wiki").exists()


def test_coverage_nfc_normalized_matching(tmp_path):
    """coverage matches by NFC-normalized paths."""
    from agent_wiki import coverage

    _init(tmp_path)
    _source(tmp_path, "café.md", "Source.")  # NFC form

    _topic(tmp_path, "topic.md", {"title": "Topic", "sources": ["café.md"]}, "Content.")

    result = coverage.compute_coverage(tmp_path)

    # Should match despite Unicode normalization
    assert result["covered"] == 1
    assert len(result["gaps"]) == 0


def test_coverage_gaps_nfc_sorted(tmp_path):
    """gaps list is NFC-sorted."""
    from agent_wiki import coverage

    _init(tmp_path)
    _source(tmp_path, "z.md", "Z")
    _source(tmp_path, "a.md", "A")
    _source(tmp_path, "m.md", "M")

    result = coverage.compute_coverage(tmp_path)

    gap_paths = [g["path"] for g in result["gaps"]]
    assert gap_paths == sorted(gap_paths)


def test_coverage_deterministic(tmp_path):
    """coverage output identical across runs."""
    from agent_wiki import coverage

    _init(tmp_path)
    _source(tmp_path, "a.md", "A")
    _source(tmp_path, "b.md", "B")

    result1 = coverage.compute_coverage(tmp_path)
    result2 = coverage.compute_coverage(tmp_path)

    assert result1["gaps"] == result2["gaps"]
    assert result1["coverage_ratio"] == result2["coverage_ratio"]


# --- 6.3 Property-based / invariant tests (coverage) ---


def test_coverage_partition_invariant(tmp_path):
    """INVARIANT: covered ∪ gaps == scan_set, covered ∩ gaps == ∅."""
    from agent_wiki import coverage, scanner

    _init(tmp_path)
    _source(tmp_path, "notes/a.md", "A")
    _source(tmp_path, "notes/b.md", "B")
    _source(tmp_path, "notes/c.md", "C")
    _source(tmp_path, "docs/d.md", "D")

    _topic(tmp_path, "t1.md", {"title": "T1", "sources": ["notes/a.md", "docs/d.md"]}, "Content.")
    _topic(tmp_path, "t2.md", {"title": "T2", "sources": ["notes/b.md"]}, "Content.")

    result = coverage.compute_coverage(tmp_path)

    # Get actual scan set (convert Path to string for comparison)
    scan_set = {str(p.relative_to(tmp_path)).replace("\\", "/") for p in scanner.walk_sources(tmp_path)}

    # Build covered set from all topic sources
    data, _ = wiki_index.rebuild(tmp_path)
    covered_set = set()
    for kind in ["topics", "queries"]:
        for entry in data.get(kind, {}).values():
            for src in entry.get("sources", []):
                if src.endswith(".md"):
                    covered_set.add(src)

    # Build gaps set
    gaps_set = {g["path"] for g in result["gaps"]}

    # INVARIANT 1: covered ∪ gaps == scan_set
    union = covered_set | gaps_set
    assert union == scan_set

    # INVARIANT 2: covered ∩ gaps == ∅
    intersection = covered_set & gaps_set
    assert len(intersection) == 0

    # INVARIANT 3: result counts match
    assert result["covered"] == len(covered_set)
    assert len(result["gaps"]) == len(gaps_set)


def test_coverage_ratio_bounds_comprehensive(tmp_path):
    """INVARIANT: coverage_ratio ∈ [0, 1] for all scenarios."""
    from agent_wiki import coverage

    _init(tmp_path)

    # Empty scan set => 1.0
    result_empty = coverage.compute_coverage(tmp_path)
    assert result_empty["coverage_ratio"] == 1.0

    # All gaps => 0.0
    _source(tmp_path, "gap1.md", "Gap 1")
    _source(tmp_path, "gap2.md", "Gap 2")
    result_zero = coverage.compute_coverage(tmp_path)
    assert result_zero["coverage_ratio"] == 0.0

    # Partial coverage => (0, 1)
    _topic(tmp_path, "t1.md", {"title": "T1", "sources": ["gap1.md"]}, "Content.")
    result_partial = coverage.compute_coverage(tmp_path)
    assert 0.0 < result_partial["coverage_ratio"] < 1.0

    # Full coverage => 1.0
    _topic(tmp_path, "t2.md", {"title": "T2", "sources": ["gap2.md"]}, "Content.")
    result_full = coverage.compute_coverage(tmp_path)
    assert result_full["coverage_ratio"] == 1.0
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall