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_alias_resolution.py

View on GitHub
"""Tests for alias and disambiguation resolution in wiki index."""

import json
from pathlib import Path

from agent_wiki import config, frontmatter, wiki_index


def _topic(vault: Path, name: str, meta: dict, body: str = "x") -> Path:
    """Create a topic with frontmatter and body."""
    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 _init(vault: Path) -> None:
    """Initialize wiki structure."""
    config.topics_dir(vault).mkdir(parents=True, exist_ok=True)


# --- 2.1 Alias resolution tests ---


def test_frontmatter_aliases_populate_alias_index(tmp_path):
    """Frontmatter aliases[] create entries in top-level alias_index."""
    _init(tmp_path)

    _topic(tmp_path, "刘邦.md", {
        "title": "刘邦",
        "aliases": ["沛公", "汉王"]
    }, "Content.")

    data, errors = wiki_index.rebuild(tmp_path)

    assert errors == []
    assert "alias_index" in data
    assert data["alias_index"]["沛公"] == "刘邦.md"
    assert data["alias_index"]["汉王"] == "刘邦.md"


def test_per_topic_aliases_preserve_order(tmp_path):
    """Per-topic aliases[] field preserves authored order."""
    _init(tmp_path)

    _topic(tmp_path, "topic.md", {
        "title": "Topic",
        "aliases": ["Third", "First", "Second"]
    }, "Content.")

    data, errors = wiki_index.rebuild(tmp_path)
    entry = data["topics"]["topic.md"]

    # Order preserved
    assert entry["aliases"] == ["Third", "First", "Second"]


def test_alias_index_keys_are_deduplicated_and_sorted(tmp_path):
    """alias_index keys are deduplicated and NFC-sorted."""
    _init(tmp_path)

    _topic(tmp_path, "A.md", {"title": "A", "aliases": ["Zebra", "Apple"]}, "Content.")
    _topic(tmp_path, "B.md", {"title": "B", "aliases": ["Banana"]}, "Content.")

    data, errors = wiki_index.rebuild(tmp_path)

    alias_keys = list(data["alias_index"].keys())
    assert alias_keys == sorted(alias_keys)  # Sorted
    assert len(alias_keys) == len(set(alias_keys))  # Deduplicated


def test_optional_wiki_aliases_json_merged(tmp_path):
    """Optional wiki/.wiki-aliases.json is merged into alias_index."""
    _init(tmp_path)

    _topic(tmp_path, "target.md", {"title": "Target"}, "Content.")

    # Create disambiguation map
    wiki_aliases = config.wiki_root(tmp_path) / ".wiki-aliases.json"
    wiki_aliases.write_text(json.dumps({"MapAlias": "target.md"}), encoding="utf-8")

    data, errors = wiki_index.rebuild(tmp_path)

    assert errors == []
    assert data["alias_index"]["MapAlias"] == "target.md"


def test_wiki_aliases_json_absent_is_graceful(tmp_path):
    """Missing .wiki-aliases.json is tolerated without error."""
    _init(tmp_path)

    _topic(tmp_path, "topic.md", {"title": "Topic", "aliases": ["Alias1"]}, "Content.")

    data, errors = wiki_index.rebuild(tmp_path)

    assert errors == []
    assert data["alias_index"]["Alias1"] == "topic.md"
    # No error for missing map file


def test_malformed_alias_map_is_reported(tmp_path):
    """Malformed .wiki-aliases.json is reported as alias_map_invalid."""
    _init(tmp_path)

    _topic(tmp_path, "topic.md", {"title": "Topic"}, "Content.")

    # Create malformed JSON
    wiki_aliases = config.wiki_root(tmp_path) / ".wiki-aliases.json"
    wiki_aliases.write_text("not valid json", encoding="utf-8")

    data, errors = wiki_index.rebuild(tmp_path)

    assert any(e["error"] == "alias_map_invalid" for e in errors)


def test_alias_map_non_object_is_reported(tmp_path):
    """Non-object .wiki-aliases.json (array, string) is reported."""
    _init(tmp_path)

    _topic(tmp_path, "topic.md", {"title": "Topic"}, "Content.")

    # Create array instead of object
    wiki_aliases = config.wiki_root(tmp_path) / ".wiki-aliases.json"
    wiki_aliases.write_text(json.dumps(["not", "an", "object"]), encoding="utf-8")

    data, errors = wiki_index.rebuild(tmp_path)

    assert any(e["error"] == "alias_map_invalid" for e in errors)


def test_alias_target_missing_is_reported(tmp_path):
    """Alias pointing to nonexistent topic is reported as alias_target_missing."""
    _init(tmp_path)

    _topic(tmp_path, "exists.md", {"title": "Exists", "aliases": ["GoodAlias"]}, "Content.")

    # Alias pointing to nonexistent target
    wiki_aliases = config.wiki_root(tmp_path) / ".wiki-aliases.json"
    wiki_aliases.write_text(json.dumps({"BadAlias": "nonexistent.md"}), encoding="utf-8")

    data, errors = wiki_index.rebuild(tmp_path)

    # GoodAlias should work
    assert data["alias_index"].get("GoodAlias") == "exists.md"

    # BadAlias should be omitted and reported
    assert "BadAlias" not in data["alias_index"]
    assert any(e["error"] == "alias_target_missing" and e["alias"] == "BadAlias" for e in errors)


def test_alias_conflict_is_reported(tmp_path):
    """Same alias → two targets is reported as alias_conflict with sorted candidates."""
    _init(tmp_path)

    _topic(tmp_path, "A.md", {"title": "A", "aliases": ["Conflict"]}, "Content.")
    _topic(tmp_path, "B.md", {"title": "B", "aliases": ["Conflict"]}, "Content.")

    data, errors = wiki_index.rebuild(tmp_path)

    # Conflicting alias should be omitted
    assert "Conflict" not in data["alias_index"]

    # Error should list both candidates, NFC-sorted
    conflict_error = next((e for e in errors if e["error"] == "alias_conflict" and e["alias"] == "Conflict"), None)
    assert conflict_error is not None
    assert set(conflict_error["candidates"]) == {"A.md", "B.md"}
    assert conflict_error["candidates"] == sorted(conflict_error["candidates"])


def test_alias_equals_real_topic_key_is_conflict(tmp_path):
    """Alias that equals an existing topic's own key is a conflict."""
    _init(tmp_path)

    _topic(tmp_path, "Real.md", {"title": "Real"}, "Content.")
    _topic(tmp_path, "Other.md", {"title": "Other", "aliases": ["Real.md"]}, "Content.")

    data, errors = wiki_index.rebuild(tmp_path)

    # "Real.md" as an alias should conflict
    assert any(e["error"] == "alias_conflict" and e["alias"] == "Real.md" for e in errors)


def test_alias_resolution_is_deterministic(tmp_path):
    """Rebuilding index twice produces identical alias_index."""
    _init(tmp_path)

    _topic(tmp_path, "A.md", {"title": "A", "aliases": ["AliasA"]}, "Content.")
    _topic(tmp_path, "B.md", {"title": "B", "aliases": ["AliasB"]}, "Content.")

    data1, _ = wiki_index.rebuild(tmp_path)
    data2, _ = wiki_index.rebuild(tmp_path)

    # Serialize and compare
    json1 = wiki_index.serialize(data1)
    json2 = wiki_index.serialize(data2)

    assert json1 == json2


def test_frontmatter_alias_and_map_both_contribute(tmp_path):
    """Both frontmatter aliases and .wiki-aliases.json contribute to alias_index."""
    _init(tmp_path)

    _topic(tmp_path, "target.md", {"title": "Target", "aliases": ["FrontmatterAlias"]}, "Content.")

    wiki_aliases = config.wiki_root(tmp_path) / ".wiki-aliases.json"
    wiki_aliases.write_text(json.dumps({"MapAlias": "target.md"}), encoding="utf-8")

    data, errors = wiki_index.rebuild(tmp_path)

    assert data["alias_index"]["FrontmatterAlias"] == "target.md"
    assert data["alias_index"]["MapAlias"] == "target.md"


def test_aliases_nfc_normalized(tmp_path):
    """Alias text is NFC-normalized."""
    _init(tmp_path)

    # NFD (decomposed) form
    _topic(tmp_path, "topic.md", {"title": "Topic", "aliases": ["café"]}, "Content.")

    data, errors = wiki_index.rebuild(tmp_path)

    # Should be normalized to NFC
    alias_keys = list(data["alias_index"].keys())
    assert "café" in alias_keys  # NFC form
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