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

View on GitHub
import json
import math
import subprocess
import sys
from itertools import combinations
from pathlib import Path

import pytest
from agent_wiki import boundary, canvas, config, frontmatter

ROOT = Path(__file__).resolve().parents[1]
CLI = ROOT / "scripts" / "agent_wiki_cli.py"


def run_cli(*args):
    return subprocess.run([sys.executable, str(CLI), *args], text=True, encoding="utf-8", capture_output=True)


def _entry(sources=None, links=None, title="", summary=""):
    return {"sources": sources or [], "links": links or [], "title": title, "summary": summary}


def _index(topics):
    return {"version": 1, "topics": topics, "queries": {}}


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


# --- schema validity -------------------------------------------------------

def test_canvas_schema_validity_and_edge_closure():
    data = _index({"T.md": _entry(["a.md", "https://x.io"], ["N"], "T", "Summary"), "N.md": _entry(title="N")})
    graph = canvas.build_canvas("T.md", data)
    ids = [n["id"] for n in graph["nodes"]]
    assert len(ids) == len(set(ids))  # unique ids
    for node in graph["nodes"]:
        assert {"id", "type", "x", "y", "width", "height"} <= node.keys()
        assert isinstance(node["x"], int) and isinstance(node["y"], int)
        assert isinstance(node["width"], int) and node["width"] > 0
        assert isinstance(node["height"], int) and node["height"] > 0
        assert (node["type"] == "text") == ("text" in node)
        assert (node["type"] == "link") == ("url" in node)
    node_ids = set(ids)
    for edge in graph["edges"]:
        assert {"id", "fromNode", "toNode"} <= edge.keys()
        assert edge["fromNode"] in node_ids and edge["toNode"] in node_ids
        assert edge["toEnd"] == "arrow"


def test_url_source_is_link_file_source_is_text_node():
    data = _index({"T.md": _entry(["notes/a.md", "https://example.com/p"], title="Topic")})
    graph = canvas.build_canvas("T.md", data, prefix="vault")
    by_id = {n["id"]: n for n in graph["nodes"]}
    assert by_id["source:notes/a.md"]["type"] == "text"
    assert "[[vault/notes/a" in by_id["source:notes/a.md"]["text"]
    assert by_id["source:https://example.com/p"]["type"] == "link"
    assert by_id["source:https://example.com/p"]["url"] == "https://example.com/p"
    assert by_id["topic:T.md"]["type"] == "text"
    assert "# Topic" in by_id["topic:T.md"]["text"]


def test_color_mapping():
    data = _index({"T.md": _entry(["a.md"], ["N"], "T"), "N.md": _entry(title="N")})
    by_id = {n["id"]: n for n in canvas.build_canvas("T.md", data)["nodes"]}
    assert by_id["topic:T.md"]["color"] == "#2563EB"
    assert by_id["source:a.md"]["color"] == "#D97706"
    assert by_id["neighbor:N.md"]["color"] == "#0D9488"


# --- coordinates -----------------------------------------------------------

def test_target_centered_top_left():
    data = _index({"T.md": _entry(title="T")})
    topic = canvas.build_canvas("T.md", data)["nodes"][0]
    assert (topic["x"], topic["y"]) == (-240, -130)


def test_single_source_on_inner_ring_theta_zero():
    data = _index({"T.md": _entry(["a.md"], title="T")})
    src = next(n for n in canvas.build_canvas("T.md", data)["nodes"] if n["id"] == "source:a.md")
    assert (src["x"], src["y"]) == (canvas.R1_BASE - 210, -95)


def test_scaled_radius_non_overlap():
    sources = [f"s{i}.md" for i in range(8)]
    graph = canvas.build_canvas("T.md", _index({"T.md": _entry(sources, title="T")}))
    centers = [(n["x"] + canvas.RING_WIDTH / 2, n["y"] + canvas.RING_HEIGHT / 2)
               for n in graph["nodes"] if n["id"].startswith("source:")]
    for (ax, ay), (bx, by) in combinations(centers, 2):
        assert math.hypot(ax - bx, ay - by) >= canvas._RING_DIAG


# --- neighbor derivation ---------------------------------------------------

def test_neighbor_by_shared_source():
    data = _index({"T.md": _entry(["s1.md"]), "N.md": _entry(["s1.md", "s2.md"]), "X.md": _entry(["s3.md"])})
    assert canvas.neighbors("T.md", data) == {"N.md"}


def test_neighbor_by_outbound_and_inbound_links():
    data = _index({"T.md": _entry(links=["A"]), "A.md": _entry(), "B.md": _entry(links=["T"]), "C.md": _entry()})
    assert canvas.neighbors("T.md", data) == {"A.md", "B.md"}


def test_neighbor_dangling_link_excluded():
    data = _index({"T.md": _entry(links=["Ghost"]), "N.md": _entry()})
    assert canvas.neighbors("T.md", data) == set()


def test_source_stem_equal_topic_stem_keeps_ids_unique():
    data = _index({"T.md": _entry(["N.md"], title="T"), "N.md": _entry(["N.md"], title="N")})
    graph = canvas.build_canvas("T.md", data)
    ids = [n["id"] for n in graph["nodes"]]
    assert "source:N.md" in ids and "neighbor:N.md" in ids
    assert len(ids) == len(set(ids))


def test_topic_links_remain_visible_before_long_summary():
    long_summary = "x " * 600
    data = _index({"T.md": _entry(["a.md"], ["N"], "T", long_summary), "N.md": _entry(title="N", summary=long_summary)})
    by_id = {n["id"]: n for n in canvas.build_canvas("T.md", data)["nodes"]}
    assert by_id["topic:T.md"]["text"].split("\n\n", 2)[:2] == ["# T", "[[wiki/topics/T|阅读全文 →]]"]
    assert by_id["neighbor:N.md"]["text"].split("\n\n", 2)[:2] == ["## N", "[[wiki/topics/N|查看主题 →]]"]


# --- determinism -----------------------------------------------------------

def test_canvas_byte_identical():
    data = _index({"T.md": _entry(["b.md", "a.md", "a.md"], ["N"], "T", "Sum"), "N.md": _entry(title="N")})
    first = canvas.serialize(canvas.build_canvas("T.md", data))
    second = canvas.serialize(canvas.build_canvas("T.md", data))
    assert first == second
    assert first.endswith("\n")
    assert json.loads(first)["nodes"]  # valid JSON


# --- atomic write ----------------------------------------------------------

def test_write_canvas_atomic_no_tmp(tmp_path):
    boundary.bind(tmp_path)
    path = tmp_path / "g" / "T.canvas"
    canvas.write_canvas(path, {"nodes": [], "edges": []})
    assert path.exists()
    assert not path.with_name(path.name + ".tmp").exists()


def test_write_canvas_preserves_old_bytes_on_failure(tmp_path, monkeypatch):
    boundary.bind(tmp_path)
    path = tmp_path / "T.canvas"
    path.write_text("OLD", encoding="utf-8")

    def boom(dir_fd, tmp_name, destination, fd):
        raise PermissionError("locked")

    monkeypatch.setattr(boundary, "_publish_tmp", boom)
    with pytest.raises(canvas.CanvasWriteError):
        canvas.write_canvas(path, {"nodes": [], "edges": []})
    assert path.read_text(encoding="utf-8") == "OLD"
    assert not path.with_name(path.name + ".tmp").exists()


# --- CLI -------------------------------------------------------------------

def test_gen_canvas_topic_writes_file(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    _topic(tmp_path, "T.md", {"title": "T", "sources": ["a.md"]}, body="见 [[N]]\n")
    _topic(tmp_path, "N.md", {"title": "N", "sources": []})
    payload = json.loads(run_cli("gen-canvas", "--topic", "T", "--vault", str(tmp_path)).stdout)
    assert payload["path"] == "wiki/graphs/T.canvas"
    assert payload["nodes"] == 3 and payload["edges"] == 2
    written = json.loads((config.graphs_dir(tmp_path) / "T.canvas").read_text(encoding="utf-8"))
    assert {n["id"] for n in written["nodes"]} == {"topic:T.md", "source:a.md", "neighbor:N.md"}


def test_gen_canvas_all_writes_one_per_topic(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    _topic(tmp_path, "T.md", {"title": "T", "sources": []})
    _topic(tmp_path, "N.md", {"title": "N", "sources": []})
    payload = json.loads(run_cli("gen-canvas", "--all", "--vault", str(tmp_path)).stdout)
    assert payload["count"] == 2
    assert (config.graphs_dir(tmp_path) / "T.canvas").exists()
    assert (config.graphs_dir(tmp_path) / "N.canvas").exists()


def test_gen_canvas_requires_init(tmp_path):
    result = run_cli("gen-canvas", "--topic", "T", "--vault", str(tmp_path))
    assert result.returncode == 1
    assert json.loads(result.stderr) == {"error": "wiki_not_initialized", "hint": "run init first"}


def test_gen_canvas_unknown_topic_errors(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    result = run_cli("gen-canvas", "--topic", "ghost", "--vault", str(tmp_path))
    assert result.returncode == 1
    assert json.loads(result.stderr) == {"error": "topic_not_found", "topic": "ghost.md"}
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