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

View on GitHub
"""Final-review regressions: publication must not destroy newer data."""

import json
import os
from pathlib import Path

import pytest
from agent_wiki import boundary, cleanup, config, frontmatter, site


def _vault(tmp_path):
    vault = tmp_path / "vault"
    config.topics_dir(vault).mkdir(parents=True)
    return vault


def test_archive_refuses_even_an_identical_existing_target(tmp_path):
    vault = _vault(tmp_path)
    source = vault / "note.md"
    source.write_bytes(b"same")
    archive = config.archive_dir(vault)
    target = archive / "2026-11-02" / source.name
    target.parent.mkdir(parents=True)
    target.write_bytes(b"same")

    with pytest.raises(cleanup.TopicError, match="archive_target_conflict"):
        cleanup.archive_topic(source, archive, "2026-11-02")

    assert source.read_bytes() == target.read_bytes() == b"same"


def test_archive_does_not_delete_a_source_path_after_copying(tmp_path, monkeypatch):
    vault = _vault(tmp_path)
    source = vault / "note.md"
    source.write_bytes(b"original")

    def unsafe_unlink(path):
        # This is the unsafe check/use window: the path may now name a newer file.
        Path(path).write_bytes(b"new version")
        raise AssertionError("copy then path-unlink is not an identity-safe move")

    monkeypatch.setattr(boundary, "unlink", unsafe_unlink)
    target = cleanup.archive_topic(source, config.archive_dir(vault), "2026-11-02")
    assert target.read_bytes() == b"original"
    assert not source.exists()


def test_move_to_refuses_existing_destination_without_touching_either(tmp_path):
    vault = _vault(tmp_path)
    source = vault / "note.md"
    source.write_bytes(b"mine")
    dest_dir = vault / "archive"
    dest_dir.mkdir()
    target = dest_dir / source.name
    target.write_bytes(b"winner")
    fs = boundary.fs_for(source)

    with (
        fs.open_directory(vault) as src,
        fs.open_directory(dest_dir) as dst,
        pytest.raises(FileExistsError),
    ):
        src.move_to(source.name, dst, target.name)

    assert source.read_bytes() == b"mine"
    assert target.read_bytes() == b"winner"


def test_interrupted_site_generation_invalidates_previous_completion(tmp_path, monkeypatch):
    vault = _vault(tmp_path)
    topic = config.topics_dir(vault) / "note.md"
    topic.write_text(frontmatter.dump({"title": "Note", "sources": []}, "body"), encoding="utf-8")
    assert site.generate_site(vault)["complete"]
    stamp = config.wiki_root(vault) / "site" / "_complete"
    assert stamp.exists()

    def interrupted_write(self, name, data):
        raise OSError("simulated interrupted publication")

    monkeypatch.setattr(boundary.DirectoryHandle, "write_atomic", interrupted_write)
    with pytest.raises(OSError, match="simulated interrupted publication"):
        site.generate_site(vault)
    assert not stamp.exists()


def test_disappearing_page_does_not_get_a_completion_stamp(tmp_path, monkeypatch):
    vault = _vault(tmp_path)
    topic = config.topics_dir(vault) / "note.md"
    topic.write_text(frontmatter.dump({"title": "Note", "sources": []}, "body"), encoding="utf-8")
    real_exists = boundary.exists

    def disappeared(path):
        return False if Path(path) == topic else real_exists(path)

    monkeypatch.setattr(boundary, "exists", disappeared)
    result = site.generate_site(vault)
    assert result["complete"] is False
    assert any(e["error"] == "topic_missing" for e in result["errors"])
    assert not (config.wiki_root(vault) / "site" / "_complete").exists()


def test_alias_warning_does_not_mark_published_site_incomplete(tmp_path):
    vault = _vault(tmp_path)
    (config.topics_dir(vault) / "note.md").write_text(
        frontmatter.dump({"title": "Note", "sources": []}, "body"), encoding="utf-8"
    )
    (config.wiki_root(vault) / ".wiki-aliases.json").write_text(
        json.dumps({"ghost": "missing.md"}), encoding="utf-8"
    )
    result = site.generate_site(vault)
    assert any(error["error"] == "alias_target_missing" for error in result["errors"])
    assert result["complete"] is True
    assert (config.wiki_root(vault) / "site" / "_complete").is_file()


@pytest.mark.skipif(os.name != "nt", reason="Windows canonical path case")
def test_directory_mutation_path_keeps_on_disk_case(tmp_path):
    vault = _vault(tmp_path)
    mixed = vault / "MixedCase"
    mixed.mkdir()
    with boundary.fs_for(mixed).open_directory(mixed) as held:
        assert held.path.name == "MixedCase"
        held.write_atomic("note.md", "preserved")
    assert (mixed / "note.md").read_text(encoding="utf-8") == "preserved"


@pytest.mark.skipif(os.name != "nt", reason="Windows junction alias regression")
@pytest.mark.parametrize("operation", ["write", "append", "unlink", "move"])
def test_held_directory_does_not_reuse_a_retargeted_junction(tmp_path, operation):
    import _winapi

    vault = _vault(tmp_path)
    real = vault / "real"
    (real / "nested").mkdir(parents=True)
    (real / "nested" / "victim.md").write_bytes(b"inside")
    outside = tmp_path / "outside"
    (outside / "nested").mkdir(parents=True)
    victim = outside / "nested" / "victim.md"
    victim.write_bytes(b"OUTSIDE")
    alias = vault / "alias"
    _winapi.CreateJunction(str(real), str(alias))
    fs = boundary.fs_for(vault)
    with fs.open_directory(alias / "nested") as held, fs.open_directory(vault) as dest:
        os.rmdir(alias)
        _winapi.CreateJunction(str(outside), str(alias))
        if operation == "write":
            held.write_atomic("probe.md", b"new")
        elif operation == "append":
            held.append_atomic("victim.md", b"more")
        elif operation == "unlink":
            held.unlink("victim.md")
        else:
            held.move_to("victim.md", dest, "moved.md")
    assert victim.read_bytes() == b"OUTSIDE"
    assert not (outside / "nested" / "probe.md").exists()
    if operation == "write":
        assert (real / "nested" / "probe.md").read_bytes() == b"new"
    elif operation == "append":
        assert (real / "nested" / "victim.md").read_bytes() == b"insidemore"
    elif operation == "move":
        assert (vault / "moved.md").read_bytes() == b"inside"


@pytest.mark.skipif(os.name != "posix", reason="POSIX atomic move availability")
def test_unsupported_atomic_move_never_copies_or_unlinks(tmp_path, monkeypatch):
    vault = _vault(tmp_path)
    source = vault / "note.md"
    source.write_bytes(b"keep")
    monkeypatch.setattr(boundary.ctypes, "CDLL", lambda *args, **kwargs: object())
    with pytest.raises(boundary.BoundaryError, match="unavailable"):
        cleanup.archive_topic(source, config.archive_dir(vault), "2026-11-02")
    assert source.read_bytes() == b"keep"
    assert not (config.archive_dir(vault) / "2026-11-02" / source.name).exists()
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: 472kUpdated 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