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

View on GitHub
"""Tests for quality CLI subcommand."""

import json
from pathlib import Path

import pytest
from agent_wiki import commands, config, frontmatter


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)


class Args:
    """Mock argparse args."""
    def __init__(self, **kwargs):
        for key, value in kwargs.items():
            setattr(self, key, value)


# --- 1.4 quality subcommand tests ---


def test_quality_subcommand_emits_tiers_and_metrics(tmp_path, capsys):
    """quality subcommand outputs tiers dict, distribution, and errors."""
    _init(tmp_path)

    # Create topics with different quality levels
    _topic(tmp_path, "stub.md", {"title": "Stub"}, "Just a line.")
    _topic(tmp_path, "basic.md", {"title": "Basic"}, "## Section\n\nSome content here.")
    _topic(tmp_path, "standard.md", {"title": "Standard"},
           "## S1\n## S2\n\n" + ("Prose content. " * 50))

    args = Args(vault=str(tmp_path))
    commands.cmd_quality(args)

    captured = capsys.readouterr()
    result = json.loads(captured.out)

    assert result["ok"] is True
    assert "tiers" in result
    assert "distribution" in result
    assert "errors" in result

    # Check tiers structure
    assert "stub.md" in result["tiers"]
    assert result["tiers"]["stub.md"]["tier"] == "stub"
    assert "metrics" in result["tiers"]["stub.md"]

    assert "basic.md" in result["tiers"]
    assert result["tiers"]["basic.md"]["tier"] == "basic"

    assert "standard.md" in result["tiers"]
    assert result["tiers"]["standard.md"]["tier"] == "standard"

    # Check distribution
    dist = result["distribution"]
    assert all(tier in dist for tier in ["stub", "basic", "standard", "rich", "premium"])
    assert dist["stub"] == 1
    assert dist["basic"] == 1
    assert dist["standard"] == 1
    assert dist["rich"] == 0
    assert dist["premium"] == 0


def test_quality_includes_has_lead_in_metrics(tmp_path, capsys):
    """quality subcommand includes has_lead metric."""
    _init(tmp_path)

    _topic(tmp_path, "with_lead.md", {"title": "With Lead"},
           "This is a lead sentence.\n\n## Section\n\nContent.")
    _topic(tmp_path, "no_lead.md", {"title": "No Lead"},
           "## Section\n\nStarts with heading.")

    args = Args(vault=str(tmp_path))
    commands.cmd_quality(args)

    captured = capsys.readouterr()
    result = json.loads(captured.out)

    assert result["tiers"]["with_lead.md"]["metrics"]["has_lead"] is True
    assert result["tiers"]["no_lead.md"]["metrics"]["has_lead"] is False


def test_quality_requires_initialized_wiki(tmp_path, capsys):
    """quality fails when wiki/ does not exist."""
    # Don't initialize - no wiki/ directory
    args = Args(vault=str(tmp_path))

    with pytest.raises(SystemExit) as exc_info:
        commands.cmd_quality(args)

    assert exc_info.value.code == 1

    captured = capsys.readouterr()
    result = json.loads(captured.err)

    assert result["error"] == "wiki_not_initialized"
    assert "hint" in result


def test_quality_reports_malformed_topics_in_errors(tmp_path, capsys):
    """Malformed topics excluded from tiers/distribution, reported in errors."""
    _init(tmp_path)

    # Valid topic
    _topic(tmp_path, "valid.md", {"title": "Valid"}, "Content here.")

    # Malformed frontmatter
    bad = config.topics_dir(tmp_path) / "bad.md"
    bad.write_text("---\ntitle: [\n---\nBody", encoding="utf-8")

    # Non-UTF8
    binary = config.topics_dir(tmp_path) / "binary.md"
    binary.write_bytes(b"\xff\xfe Invalid UTF-8")

    args = Args(vault=str(tmp_path))
    commands.cmd_quality(args)

    captured = capsys.readouterr()
    result = json.loads(captured.out)

    # Valid topic scored
    assert "valid.md" in result["tiers"]

    # Malformed topics not scored
    assert "bad.md" not in result["tiers"]
    assert "binary.md" not in result["tiers"]

    # Errors reported
    assert len(result["errors"]) == 2
    error_paths = {e["path"] for e in result["errors"]}
    assert "bad.md" in error_paths
    assert "binary.md" in error_paths


def test_quality_is_read_only(tmp_path, capsys):
    """quality subcommand does not modify any files."""
    _init(tmp_path)

    _topic(tmp_path, "topic.md", {"title": "Topic"}, "## Section\n\nContent.")

    # Capture file states before
    topics_dir = config.topics_dir(tmp_path)
    before_files = {f.name: (f.stat().st_mtime_ns, f.read_bytes())
                    for f in topics_dir.glob("*.md")}

    args = Args(vault=str(tmp_path))
    commands.cmd_quality(args)

    # Check file states after
    after_files = {f.name: (f.stat().st_mtime_ns, f.read_bytes())
                   for f in topics_dir.glob("*.md")}

    assert before_files == after_files  # No files modified


def test_quality_handles_empty_topics_directory(tmp_path, capsys):
    """quality works with zero topics."""
    _init(tmp_path)
    # No topics created

    args = Args(vault=str(tmp_path))
    commands.cmd_quality(args)

    captured = capsys.readouterr()
    result = json.loads(captured.out)

    assert result["ok"] is True
    assert result["tiers"] == {}
    assert all(count == 0 for count in result["distribution"].values())
    assert result["errors"] == []
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