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

scripts/agent_wiki/cache.py

View on GitHub
"""Cache management for incremental processing."""

from __future__ import annotations

import copy
import hashlib
import json
import stat
import sys
from datetime import UTC, datetime
from pathlib import Path
from typing import Any

from . import boundary, config

SCHEMA_VERSION = 1
_SCHEMA = {"version": SCHEMA_VERSION, "sources": {}}


class CacheWriteError(OSError):
    pass


class CacheNotWritableError(CacheWriteError):
    pass


class CacheConflictError(CacheWriteError):
    pass


class CacheReplaceError(CacheWriteError):
    pass


def empty_schema() -> dict[str, Any]:
    return copy.deepcopy(_SCHEMA)


def file_signature(path: str | Path) -> tuple[int, int] | None:
    path = Path(path)
    # A BoundaryError is deliberately not swallowed: it means the path is outside
    # every authorized vault, and reporting "no signature" would make the caller's
    # conflict check look like "cache absent" and skip the guard entirely.
    st = boundary.stat(path)
    if st is None:
        return None
    return st.st_mtime_ns, st.st_size


def load(vault: str | Path) -> dict[str, Any]:
    boundary.bind(vault)
    return load_with_signature(vault)[0]


def load_with_signature(vault: str | Path) -> tuple[dict[str, Any], tuple[int, int] | None]:
    boundary.bind(vault)
    path = config.cache_path(vault)
    if not path.exists():
        return empty_schema(), None
    signature = file_signature(path)
    try:
        text = boundary.read_text(path, encoding="utf-8")
        data = json.loads(text)
    except (json.JSONDecodeError, UnicodeDecodeError, boundary.BoundaryError) as exc:
        if isinstance(exc, boundary.BoundaryError):
            print(
                json.dumps(
                    {"warning": "cache_outside_vault", "path": str(path)}, ensure_ascii=False
                ),
                file=sys.stderr,
            )
            return empty_schema(), None
        print(json.dumps({"warning": "cache_parse_failed", "path": str(path)}, ensure_ascii=False), file=sys.stderr)
        return empty_schema(), signature
    if not isinstance(data, dict):
        return empty_schema(), signature
    data.setdefault("version", SCHEMA_VERSION)
    data.setdefault("sources", {})
    return data, signature


def is_cache_writable(path: str | Path) -> bool:
    path = Path(path)
    parent = path.parent
    try:
        parent_st = boundary.stat(parent)
    except boundary.BoundaryError:
        return False
    if parent_st is None or not (parent_st.st_mode & stat.S_IWRITE):
        return False
    st = boundary.stat(path)
    return st is None or bool(st.st_mode & stat.S_IWRITE)


def save(vault: str | Path, data: dict[str, Any], expected_signature: tuple[int, int] | None = None) -> None:
    """Persist the cache, refusing to clobber a concurrent writer's version.

    ``expected_signature`` is the (mtime_ns, size) pair returned by
    ``load_with_signature``; a mismatch raises ``CacheConflictError`` before anything is
    written. The check runs twice - once lexically, once inside the verified directory
    handle immediately before the exclusive-temp publish - to close as much of the
    check/use window as the platform allows; the publish itself is atomic, so the
    worst residual outcome of two writers that both pass is "last complete write
    wins", never a torn file. ``expected_signature=None`` means the caller explicitly
    opts out of conflict detection and accepts that contract.
    """
    boundary.bind(vault)
    path = config.cache_path(vault)
    boundary.ensure_directory(path.parent)
    if not is_cache_writable(path):
        raise CacheNotWritableError("cache_not_writable")
    if expected_signature is not None and file_signature(path) != expected_signature:
        raise CacheConflictError("cache_conflict")

    payload = json.dumps(data, ensure_ascii=False, indent=2, sort_keys=True) + "\n"
    # Publish through the verified cache directory so the conflict re-check and the
    # replacement happen relative to one opened directory, never through a link.
    with boundary.fs_for(path).open_directory(path.parent) as handle:
        if expected_signature is not None and file_signature(path) != expected_signature:
            raise CacheConflictError("cache_conflict")
        try:
            handle.write_atomic(path.name, payload)
        except OSError as exc:
            raise CacheReplaceError(str(exc)) from exc


def sha256_file(path: str | Path) -> str:
    """Hash the bytes of a verified regular file below the authorized root."""
    h = hashlib.sha256()
    with boundary.open_read(path) as handle:
        for chunk in iter(lambda: handle.read(1024 * 1024), b""):
            h.update(chunk)
    return h.hexdigest()


def stat_signature(path: str | Path) -> tuple[int, int]:
    stat_result = boundary.stat(path)
    if stat_result is None:
        raise FileNotFoundError(2, "No such file or directory", str(path))
    return stat_result.st_mtime_ns, stat_result.st_size


def upsert(data: dict[str, Any], relpath: str, sha: str, mtime_ns: int, size: int, derived_topics: list[str]) -> None:
    data.setdefault("version", SCHEMA_VERSION)
    data.setdefault("sources", {})
    data["sources"][config.normalize_relpath(relpath)] = {
        "sha256": sha,
        "mtime_ns": mtime_ns,
        "size": size,
        "last_ingest_at": datetime.now(UTC).isoformat(),
        "derived_topics": [config.normalize_relpath(topic) for topic in derived_topics],
    }


def remove(data: dict[str, Any], relpath: str) -> None:
    data.setdefault("sources", {}).pop(config.normalize_relpath(relpath), None)
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