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/site.py

View on GitHub
"""Deterministic static HTML site export (optional) — Editorial Atlas design.

Renders a self-contained static site under ``wiki/site/`` from the retrieval
index and topic bodies. Requires the optional ``markdown`` package; degrades
gracefully to escaped plaintext when absent. All styling and interactivity are
inline static literals so each page is self-contained and byte-deterministic.
"""

from __future__ import annotations

import html
import re
from contextlib import suppress
from html.parser import HTMLParser
from pathlib import Path
from typing import Any
from urllib.parse import quote, urlsplit

from . import boundary, config, frontmatter, links, wiki_index
from .config import nfc as _nfc

# Optional markdown import - strictly gated inside this module
try:
    import markdown as markdown_lib
    MARKDOWN_AVAILABLE = True
except ImportError:
    MARKDOWN_AVAILABLE = False

# Per-type accent cycle (D4/D10), assigned deterministically by sorted type.
_TYPE_ACCENTS = ["--cinnabar", "--night", "--jade", "--amber", "--violet", "--green"]

_HEADING_RE = re.compile(r"<h([23])>(.*?)</h\1>", re.DOTALL)
_TAG_RE = re.compile(r"<[^>]+>")


def _esc(text: Any) -> str:
    return html.escape(str(text), quote=True)


def _sanitize_filename(stem: str) -> str:
    """Sanitize stem for filesystem: replace unsafe chars with underscore, preserve CJK."""
    unsafe_pattern = r'[/\\:*?"<>|\x00-\x1f\x7f]|\s+'
    return re.sub(unsafe_pattern, '_', stem)


def _build_slug_map(topic_keys: list[str]) -> dict[str, str]:
    """Build key->filename map with numeric disambiguation on collision.

    Keys are sorted by NFC, then each gets sanitize(stem).html. On collision,
    append -2, -3, ... until free. First key in NFC order keeps bare name.
    """
    sorted_keys = sorted(topic_keys, key=_nfc)
    slug_map = {}
    base_counts: dict[str, int] = {}

    for key in sorted_keys:
        stem = key[:-3] if key.endswith(".md") else key
        base = _sanitize_filename(stem)

        if base not in base_counts:
            # First occurrence gets bare name
            slug_map[key] = f"{base}.html"
            base_counts[base] = 1
        else:
            # Collision: append -2, -3, etc.
            base_counts[base] += 1
            slug_map[key] = f"{base}-{base_counts[base]}.html"

    return slug_map


# --- SVG Icons (inline, self-contained) ------------------------------------------

_SVG_SEAL = '''<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/><path d="M2 12h20"/></svg>'''

_SVG_THEME_TOGGLE = '''<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="5"/><path d="M12 1v2m0 18v2M4.22 4.22l1.42 1.42m12.72 12.72 1.42 1.42M1 12h2m18 0h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg>'''

# --- Inline design system (D4) -------------------------------------------------

_STYLE = """
:root{
--radius-sm:6px;--radius:12px;--radius-lg:18px;--pill:999px;
--s1:4px;--s2:8px;--s3:16px;--s4:24px;--s5:36px;
--font-serif:"Noto Serif SC","Songti SC","STSong",Georgia,serif;
--font-ui:"Noto Sans SC",-apple-system,BlinkMacSystemFont,"PingFang SC","Microsoft YaHei",sans-serif;
--font-mono:"SFMono-Regular",ui-monospace,Menlo,Consolas,monospace;
--bg:#F4EFE4;--surface:#FFFDF7;--surface-2:#F8F1E4;--vellum:#E9DDC9;--mist:#ECE5D8;
--ink:#241F1A;--muted:#6F6559;--faint:#9B8F7E;--rule:#D8CDBB;--line:#CFC4B1;
--cinnabar:#8B2E24;--cinnabar-2:#A23B2A;--jade:#4B7564;--green:#3E6B4B;--night:#315F72;--amber:#B7791F;--violet:#6F557F;
--shadow:0 18px 36px rgba(36,31,26,.11);
}
[data-theme="mo-ye"]{
--bg:#0D0F0E;--surface:#181A18;--surface-2:#21231F;--vellum:#2C2D28;--mist:#20241F;
--ink:#F5F0E6;--muted:#C6BBAB;--faint:#8F8677;--rule:#3B3932;--line:#8E8778;
--cinnabar:#E45D4A;--cinnabar-2:#FF8066;--jade:#8AB6A2;--green:#8BAE78;--night:#A9BFCB;--amber:#E0B35E;--violet:#C1A8D5;
--shadow:0 22px 44px rgba(0,0,0,.48);
}
[data-theme="hu-yan"]{
--bg:#EFE6D2;--surface:#F7EFDD;--surface-2:#EDE2C9;--vellum:#E2D4B8;--mist:#E8DCC4;
--ink:#3B3024;--muted:#6B5D45;--faint:#8A7B60;--rule:#D8C7A4;--line:#CDBB95;
--cinnabar:#9C3B2E;--cinnabar-2:#B0473A;--jade:#436B54;--green:#3C6447;--night:#2E5868;--amber:#9A6A1C;--violet:#645074;
--shadow:0 14px 30px rgba(59,48,36,.10);
}
*{box-sizing:border-box;}
html{scroll-behavior:smooth;}
body{
margin:0;font-family:var(--font-ui);font-size:16px;line-height:1.75;color:var(--ink);
background-color:var(--bg);
background-image:radial-gradient(120% 70% at 50% -10%,rgba(255,255,255,.16),rgba(255,255,255,0) 60%),repeating-linear-gradient(0deg,rgba(120,100,70,.01) 0 1px,rgba(120,100,70,0) 1px 4px);
background-attachment:fixed;
}
a{color:var(--cinnabar);text-decoration:underline;text-underline-offset:2px;}
h1,h2,h3,h4{font-family:var(--font-serif);line-height:1.3;color:var(--ink);}
:focus-visible{outline:2px solid var(--cinnabar);outline-offset:2px;border-radius:var(--radius-sm);}
.muted{color:var(--muted);}
.star{color:var(--amber);}
.skip-link{position:absolute;left:-9999px;top:0;z-index:20;display:inline-flex;align-items:center;min-height:44px;padding:0 16px;background:var(--cinnabar);color:#fff;border-radius:var(--radius-sm);text-decoration:none;}
.skip-link:focus{left:var(--s2);top:var(--s2);}
.band{display:flex;align-items:center;gap:var(--s3);flex-wrap:wrap;max-width:1320px;margin:0 auto;padding:var(--s4);border-bottom:1px solid var(--rule);background:var(--surface);}
.seal{display:inline-flex;align-items:center;justify-content:center;width:40px;height:40px;border-radius:var(--radius-sm);background:var(--cinnabar);color:var(--surface);box-shadow:var(--shadow);}
.seal svg{display:block;}
.band__title{font-size:22px;font-weight:700;margin:0;flex:0 1 auto;}
.search{flex:1 1 200px;min-width:160px;min-height:44px;padding:8px 14px;border:1px solid var(--line);border-radius:var(--radius-sm);background:var(--surface-2);color:var(--ink);font-family:var(--font-ui);font-size:16px;}
.search::placeholder{color:var(--muted);}
.theme-toggle{min-height:44px;min-width:44px;padding:0 16px;border:1px solid var(--line);border-radius:var(--pill);background:var(--surface-2);color:var(--ink);font-family:var(--font-ui);font-size:13px;cursor:pointer;}
.theme-toggle:hover{border-color:var(--cinnabar);}
.layout{display:grid;gap:var(--s4);max-width:1320px;margin:0 auto;padding:var(--s4);}
.zone{min-width:0;}
.collapse>summary{min-height:44px;display:flex;align-items:center;cursor:pointer;font-family:var(--font-serif);font-weight:700;color:var(--ink);list-style:none;padding:var(--s1) 0;border-bottom:1px solid var(--rule);}
.collapse>summary::-webkit-details-marker{display:none;}
.article{max-width:72ch;margin:0 auto;}
.article h1{font-size:28px;margin:.2em 0 .6em;}
.article h2{font-size:20px;margin:1.4em 0 .5em;padding-bottom:.2em;border-bottom:1px solid var(--rule);}
.article h3{font-size:16px;margin:1.2em 0 .4em;}
.article img{max-width:100%;height:auto;display:block;margin:1.5em auto;border-radius:var(--radius-sm);}
.article pre,.article table{overflow-x:auto;max-width:100%;}
.article table{display:block;white-space:nowrap;}
.article__nav{display:flex;justify-content:space-between;gap:var(--s3);margin-bottom:var(--s3);font-size:13px;}
.article-provenance{margin:0 0 var(--s4);padding:var(--s3);background:var(--surface-2);border:1px solid var(--rule);border-radius:var(--radius-sm);font-size:14px;}
.article-provenance a{margin-right:var(--s2);}
.article code{font-family:var(--font-mono);font-size:.92em;background:var(--surface-2);border:1px solid var(--rule);border-radius:var(--radius-sm);padding:1px 5px;}
.article pre{background:var(--surface-2);border:1px solid var(--rule);border-radius:var(--radius);padding:var(--s3);}
.article pre code{background:none;border:0;padding:0;}
.article table{border-collapse:collapse;width:100%;}
.article th,.article td{border:1px solid var(--rule);padding:6px 10px;text-align:left;}
.article th{background:var(--surface-2);}
.article tbody tr:nth-child(even){background:var(--mist);}
.article blockquote{margin:1em 0;padding:var(--s2) var(--s3);background:var(--surface-2);border-left:3px solid var(--cinnabar);border-radius:0 var(--radius-sm) var(--radius-sm) 0;color:var(--ink);}
.wikilink{color:var(--cinnabar);text-underline-offset:2px;}
.wikilink--missing{color:var(--muted);text-decoration:underline dashed;cursor:help;}
.wikilink--missing::after{content:" ?";opacity:0.6;}
.toc{list-style:none;margin:var(--s2) 0 0;padding:0;font-size:13px;}
.toc__item{margin:2px 0;}
.toc__item--h3{padding-left:var(--s3);}
.toc__link{display:block;padding:3px var(--s2);color:var(--muted);text-decoration:none;border-left:2px solid transparent;}
.toc__link:hover{color:var(--ink);}
.toc__link--active{color:var(--cinnabar);border-left-color:var(--cinnabar);background:var(--surface-2);}
.infobox{font-size:13px;margin-top:var(--s2);}
.info-row{display:grid;grid-template-columns:84px 1fr;gap:var(--s2);padding:6px 0;border-bottom:1px solid var(--rule);}
.info-label{color:var(--muted);}
.info-value{color:var(--ink);word-break:break-word;}
.badge{display:inline-block;padding:1px 10px;border-radius:var(--pill);font-size:12px;font-weight:600;color:#14110D;}
.badge--premium{background:var(--cinnabar);color:#FFFDF7;}
.badge--rich{background:var(--green);color:#FFFDF7;}
.badge--standard{background:var(--night);color:#FFFDF7;}
.badge--basic{background:var(--amber);}
.badge--stub{background:var(--faint);}
[data-theme="mo-ye"] .badge--premium,[data-theme="mo-ye"] .badge--rich,[data-theme="mo-ye"] .badge--standard{color:#14110D;}
[data-theme="hu-yan"] .badge--basic{color:#FFFDF7;}
.kw{display:inline-block;margin:0 4px 4px 0;padding:0 8px;border-radius:var(--pill);background:var(--mist);color:var(--ink);border:1px solid var(--rule);font-size:12px;}
mark{background:var(--jade);color:var(--surface);padding:0 .2em;border-radius:2px;font-weight:500;}
.index-main{max-width:1320px;margin:0 auto;padding:var(--s4);}
.section__title{display:flex;align-items:center;gap:var(--s2);font-size:18px;margin:var(--s5) 0 var(--s3);}
.type-dot{width:10px;height:10px;border-radius:50%;background:var(--dot,var(--faint));}
.featured .section__title{color:var(--cinnabar);}
.card-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:var(--s3);}
.card{display:flex;flex-direction:column;gap:var(--s2);padding:var(--s3);background:var(--surface);border:1px solid var(--rule);border-radius:var(--radius);color:inherit;text-decoration:none;transition:all .25s cubic-bezier(0.4, 0, 0.2, 1);}
.card:hover{transform:translateY(-4px);border-color:var(--cinnabar);box-shadow:0 12px 24px rgba(0,0,0,.08);}
.card__meta{display:flex;align-items:center;gap:var(--s2);flex-wrap:wrap;}
.card__title{font-size:16px;margin:0;}
.card__summary{margin:0;color:var(--muted);display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;overflow:hidden;}
.card__backlinks{font-size:12px;color:var(--muted);margin-top:auto;}
.is-hidden{display:none!important;}
.search-empty{padding:var(--s5) 0;text-align:center;color:var(--muted);}
.foot{display:flex;align-items:center;justify-content:space-between;gap:var(--s3);flex-wrap:wrap;max-width:1320px;margin:0 auto;padding:var(--s4);border-top:1px solid var(--rule);color:var(--muted);font-size:12px;}
.legend{display:flex;gap:var(--s2);flex-wrap:wrap;align-items:center;}
@media(min-width:1280px){
.layout{grid-template-columns:minmax(220px,260px) minmax(0,1fr) minmax(260px,320px);align-items:start;}
.zone--nav,.zone--aside{position:sticky;top:var(--s4);max-height:calc(100vh - 2*var(--s4));overflow:auto;}
}
@media(min-width:768px) and (max-width:1279px){
.layout{grid-template-columns:minmax(0,1fr) minmax(240px,300px);}
.zone--nav{grid-column:1 / -1;}
}
@media(max-width:767px){.layout{grid-template-columns:1fr;}}
@media(prefers-reduced-motion:reduce){
html{scroll-behavior:auto;}
*{transition:none!important;animation:none!important;}
.card:hover{transform:none;}
}
""".strip()

# Early synchronous theme bootstrap (before first paint, no FOUC) — static literal.
_HEAD_SCRIPT = (
    "<script>(function(){try{var t=localStorage.getItem('agentwiki-theme');"
    "if(!t){t=matchMedia('(prefers-color-scheme: dark)').matches?'mo-ye':'shan-shui';}"
    "document.documentElement.setAttribute('data-theme',t);}catch(e){}})();</script>"
)

# Body interactivity (theme cycle / scroll-spy / search / collapse) — static literal.
_BODY_SCRIPT = (
    "(function(){"
    "var root=document.documentElement;var ORDER=['shan-shui','hu-yan','mo-ye'];"
    "var btn=document.querySelector('[data-theme-toggle]');"
    "if(btn){btn.addEventListener('click',function(){"
    "var cur=root.getAttribute('data-theme')||'shan-shui';"
    "var next=ORDER[(ORDER.indexOf(cur)+1)%ORDER.length];"
    "root.setAttribute('data-theme',next);"
    "try{localStorage.setItem('agentwiki-theme',next);}catch(e){}});}"
    "var reduce=matchMedia('(prefers-reduced-motion: reduce)').matches;"
    "var search=document.getElementById('search');"
    "if(search){document.addEventListener('keydown',function(e){"
    "if(e.key==='/'&&document.activeElement.tagName!=='INPUT'&&document.activeElement.tagName!=='TEXTAREA'){"
    "e.preventDefault();search.focus();}});"
    "var cards=[].slice.call(document.querySelectorAll('[data-search]'));"
    "var sections=[].slice.call(document.querySelectorAll('.type-section,.featured'));"
    "var empty=document.getElementById('search-empty');"
    "search.addEventListener('input',function(){var q=search.value.toLowerCase().trim(),ws=q?q.split(/\\s+/):[];var any=false;"
    "cards.forEach(function(c){var s=c.getAttribute('data-search')||'',hit=ws.every(function(w){return s.indexOf(w)>=0;});"
    "c.classList.toggle('is-hidden',!hit);if(hit)any=true;});"
    "sections.forEach(function(s){var on=s.querySelectorAll('[data-search]:not(.is-hidden)').length>0;"
    "s.classList.toggle('is-hidden',!on);});if(empty){empty.hidden=any;}});}"
    "var toc=document.querySelector('[data-toc]');"
    "if(toc){var links=[].slice.call(toc.querySelectorAll('a[href^=\"#\"]'));var map={};"
    "links.forEach(function(a){var id=a.getAttribute('href').slice(1);map[id]=a;"
    "a.addEventListener('click',function(e){var el=document.getElementById(id);"
    "if(el){e.preventDefault();el.scrollIntoView({behavior:reduce?'auto':'smooth'});"
    "history.replaceState(null,'','#'+id);}});});"
    "var heads=[].slice.call(document.querySelectorAll('#main-article h2[id],#main-article h3[id]'));"
    "if(window.IntersectionObserver&&heads.length){var vis={};"
    "var obs=new IntersectionObserver(function(es){"
    "es.forEach(function(en){vis[en.target.id]=en.isIntersecting;});"
    "var top='';for(var i=0;i<heads.length;i++){if(vis[heads[i].id]){top=heads[i].id;break;}}"
    "links.forEach(function(a){a.classList.remove('toc__link--active');a.removeAttribute('aria-current');});"
    "if(top&&map[top]){map[top].classList.add('toc__link--active');map[top].setAttribute('aria-current','true');}},"
    "{rootMargin:'0px 0px -70% 0px'});heads.forEach(function(h){obs.observe(h);});}}"
    "function sync(){var w=window.innerWidth;"
    "[].slice.call(document.querySelectorAll('details[data-collapse]')).forEach(function(d){"
    "var bp=parseInt(d.getAttribute('data-collapse'),10);d.open=w>=bp;});}"
    "sync();window.addEventListener('resize',sync);"
    "})();"
)

_TIERS = ("premium", "rich", "standard", "basic", "stub")


# --- Content rendering --------------------------------------------------------

_IMAGE_EXTENSIONS = (".apng", ".avif", ".bmp", ".gif", ".jpeg", ".jpg", ".png", ".svg", ".webp")


def _resolve_target(target: str, topic_keys: set[str], alias_index: dict[str, Any], slug_map: dict[str, str]) -> str | None:
    """Compatibility wrapper around the shared resolver for topic-only callers."""
    resolution = links.resolve(target, topic_keys, set(), alias_index)
    if resolution.status == "resolved" and resolution.key is not None:
        return slug_map.get(resolution.key)
    return None


def _is_image_target(target: str) -> bool:
    return urlsplit(target).path.lower().endswith(_IMAGE_EXTENSIONS)


def _asset_href(target: str, asset_prefix: str) -> str:
    if target.lower().startswith(("http://", "https://", "mailto:")):
        return target
    if target.startswith(("/", "//")) or ".." in target.replace("\\", "/").split("/"):
        return "#"
    return asset_prefix + quote(target, safe="/:@-._~")


def _fragment_href(fragment: str) -> str:
    return "#" + links.fragment_id(fragment) if fragment else ""


def _raw_fragment_href(fragment: str) -> str:
    return "#" + fragment if fragment else ""


def _render_embed(ref: links.LinkRef, href: str) -> str:
    if _is_image_target(ref.target):
        label = ref.label if ref.label and not ref.label.isdigit() else Path(ref.target).stem
        width = f' width="{ref.label}"' if ref.label.isdigit() else ""
        return f'<img loading="lazy" src="{_esc(href)}" alt="{_esc(label)}"{width}>'
    return f'<a class="wikilink wikilink--embed" href="{_esc(href)}">{_esc(ref.label)}</a>'


def _render_link_ref(
    ref: links.LinkRef,
    topic_keys: set[str],
    query_keys: set[str],
    alias_index: dict[str, Any],
    slug_map: dict[str, str],
    asset_prefix: str,
) -> str:
    resolution = links.resolve(ref.target, topic_keys, query_keys, alias_index)
    if resolution.status == "resolved" and resolution.key is not None:
        href = slug_map[resolution.key] + _fragment_href(ref.fragment)
        if ref.embed:
            return _render_embed(ref, href)
        return f'<a class="wikilink" href="{_esc(href)}">{_esc(ref.label)}</a>'
    if resolution.status == "external":
        href = ref.target + _raw_fragment_href(ref.fragment)
        if ref.embed:
            return _render_embed(ref, href)
        return f'<a class="external-link" href="{_esc(href)}">{_esc(ref.label)}</a>'
    if resolution.status == "unsafe":
        return f'<span class="wikilink wikilink--missing" title="不允许的链接协议">{_esc(ref.label)}</span>'
    if ref.embed and _is_image_target(ref.target):
        return _render_embed(ref, _asset_href(ref.target, asset_prefix))
    if ref.syntax == "markdown":
        href = _asset_href(ref.target, asset_prefix) + _raw_fragment_href(ref.fragment)
        return f'<a class="external-link" href="{_esc(href)}">{_esc(ref.label)}</a>'
    missing_class = "wikilink wikilink--missing"
    title = "歧义链接" if resolution.status == "ambiguous" else "未找到主题页"
    return f'<span class="{missing_class}" title="{title}">{_esc(ref.label)}</span>'


def _resolve_wikilinks(
    body: str,
    topic_keys: set[str],
    alias_index: dict[str, Any],
    slug_map: dict[str, str],
    query_keys: set[str] | None = None,
    asset_prefix: str = "../../",
) -> str:
    """Rewrite supported links outside code using the shared resolver."""
    query_keys = query_keys or set()
    return links.rewrite(
        body,
        lambda ref: _render_link_ref(ref, topic_keys, query_keys, alias_index, slug_map, asset_prefix),
    )


def _add_heading_ids(html_body: str) -> tuple[str, list[tuple[str, str, str]]]:
    """Post-pass: give h2/h3 deterministic collision-suffixed ids; return (html, toc)."""
    seen: dict[str, int] = {}
    toc: list[tuple[str, str, str]] = []

    def repl(m: re.Match[str]) -> str:
        level, inner = m.group(1), m.group(2)
        label = html.unescape(_TAG_RE.sub("", inner)).strip()
        base = links.fragment_id(label)
        n = seen.get(base, 0) + 1
        seen[base] = n
        hid = base if n == 1 else f"{base}-{n}"
        toc.append((level, hid, label))
        return f'<h{level} id="{_esc(hid)}">{inner}</h{level}>'

    return _HEADING_RE.sub(repl, html_body), toc


_SAFE_TAGS = frozenset({
    "a", "blockquote", "br", "code", "del", "details", "div", "em", "h1", "h2", "h3", "h4", "h5", "h6",
    "hr", "img", "kbd", "li", "mark", "ol", "p", "pre", "s", "small", "span", "strong", "sub", "summary",
    "sup", "table", "tbody", "td", "tfoot", "th", "thead", "tr", "u", "ul",
})
_SAFE_GLOBAL_ATTRS = frozenset({"class", "dir", "id", "lang", "role", "title"})
_SAFE_ATTRS = {
    "a": frozenset({"href", "download"}),
    "img": frozenset({"alt", "height", "loading", "src", "width"}),
    "td": frozenset({"colspan", "rowspan"}),
    "th": frozenset({"colspan", "rowspan"}),
}
_VOID_TAGS = frozenset({"br", "hr", "img"})
_RAW_TEXT_TAGS = frozenset({"script", "style", "title", "textarea"})


def _safe_url(value: str) -> str | None:
    value = html.unescape(value).strip()
    if not value or any(ord(char) < 0x20 for char in value) or value.startswith("//"):
        return None
    parsed = urlsplit(value)
    if parsed.scheme.lower() not in {"", "http", "https", "mailto"}:
        return None
    return value


class _SafeHTMLParser(HTMLParser):
    """Allowlist rendered HTML; raw author HTML never reaches the browser."""

    def __init__(self) -> None:
        super().__init__(convert_charrefs=False)
        self.output: list[str] = []
        self._raw_tag: str | None = None

    def _attributes(self, tag: str, attrs: list[tuple[str, str | None]]) -> str:
        allowed = _SAFE_GLOBAL_ATTRS | _SAFE_ATTRS.get(tag, frozenset())
        result: list[str] = []
        for name, value in attrs:
            name = name.lower()
            if name not in allowed or value is None:
                continue
            if name in {"href", "src"}:
                value = _safe_url(value)
                if value is None:
                    continue
            elif name in {"width", "height", "colspan", "rowspan"}:
                if not re.fullmatch(r"[1-9][0-9]{0,3}", value):
                    continue
            elif name == "loading" and value not in {"eager", "lazy"}:
                continue
            result.append(f' {name}="{_esc(value)}"')
        return "".join(result)

    def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
        tag = tag.lower()
        if self._raw_tag is not None:
            return
        if tag in _RAW_TEXT_TAGS:
            self._raw_tag = tag
            return
        if tag in _SAFE_TAGS:
            self.output.append(f"<{tag}{self._attributes(tag, attrs)}>")

    def handle_startendtag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
        tag = tag.lower()
        if self._raw_tag is not None:
            return
        if tag in _RAW_TEXT_TAGS:
            self._raw_tag = tag
            return
        if tag in _SAFE_TAGS:
            self.output.append(f"<{tag}{self._attributes(tag, attrs)} />")

    def handle_endtag(self, tag: str) -> None:
        tag = tag.lower()
        if tag in _RAW_TEXT_TAGS:
            if tag == self._raw_tag:
                self._raw_tag = None
            return
        if tag in _SAFE_TAGS and tag not in _VOID_TAGS:
            self.output.append(f"</{tag}>")

    def handle_data(self, data: str) -> None:
        self.output.append(html.escape(data, quote=False) if self._raw_tag else data)

    def handle_entityref(self, name: str) -> None:
        self.output.append(f"&{name};")

    def handle_charref(self, name: str) -> None:
        self.output.append(f"&#{name};")

    def handle_comment(self, data: str) -> None:
        return

    def handle_decl(self, decl: str) -> None:
        return

    def handle_pi(self, data: str) -> None:
        return


def _sanitize_html(value: str) -> str:
    parser = _SafeHTMLParser()
    parser.feed(value)
    parser.close()
    return "".join(parser.output)


def _render_body_and_toc(
    body: str,
    topic_keys: set[str],
    alias_index: dict[str, Any],
    slug_map: dict[str, str],
    query_keys: set[str] | None = None,
    asset_prefix: str = "../../",
) -> tuple[str, list[tuple[str, str, str]]]:
    """Render Markdown + supported links, or escaped plaintext fallback."""
    if MARKDOWN_AVAILABLE:
        pre = _resolve_wikilinks(body, topic_keys, alias_index, slug_map, query_keys, asset_prefix)
        rendered = markdown_lib.markdown(
            pre, extensions=["fenced_code", "tables", "footnotes"], output_format="html"
        )
        safe_rendered = _sanitize_html(rendered)
        html_with_ids, toc = _add_heading_ids(safe_rendered)
        html_with_lazy = re.sub(r'<img\s+(?!loading=)', '<img loading="lazy" ', html_with_ids)
        return html_with_lazy, toc
    return f"<pre>{html.escape(body)}</pre>", []


def _render_toc(toc: list[tuple[str, str, str]]) -> str:
    if not toc:
        return ""
    items = []
    for level, hid, label in toc:
        cls = "toc__item toc__item--h3" if level == "3" else "toc__item"
        items.append(f'<li class="{cls}"><a class="toc__link" href="#{_esc(hid)}">{_esc(label)}</a></li>')
    return '<ul class="toc" data-toc>' + "".join(items) + "</ul>"


# --- Components ----------------------------------------------------------------

def _render_infobox(entry: dict[str, Any], asset_prefix: str = "../../") -> str:
    rows = []

    def row(label: str, value_html: str) -> None:
        rows.append(f'<div class="info-row"><span class="info-label">{label}</span>'
                    f'<span class="info-value">{value_html}</span></div>')

    row("Title", _esc(entry.get("title", "")))
    tier = entry.get("quality_tier", "")
    if tier:
        row("Quality / 结构完整度", f'<span class="badge badge--{_esc(tier)}">{_esc(tier)}</span>')
    if entry.get("featured"):
        row("Featured", '<span class="star">⭐</span>')
    if "backlinks" in entry:
        row("Backlinks", str(entry.get("backlinks", 0)))
    for key, label in (("citekey", "Citekey"), ("library_id", "Library ID")):
        if entry.get(key):
            row(label, _esc(entry[key]))
    if entry.get("doi"):
        doi = str(entry["doi"])
        doi_href = "https://doi.org/" + quote(doi, safe="/._-()")
        row("DOI", f'<a href="{_esc(doi_href)}">{_esc(doi)}</a>')
    if entry.get("review_status"):
        reviewed_at = f" · {entry['reviewed_at']}" if entry.get("reviewed_at") else ""
        row("Review", _esc(f"{entry['review_status']}{reviewed_at}"))
    sources = entry.get("sources") or []
    if sources:
        source_links = []
        for source in sources:
            source = str(source)
            source_links.append(
                f'<a href="{_esc(_asset_href(source, asset_prefix))}">{_esc(source)}</a>'
            )
        row("Sources", "<br>".join(source_links))
    authors = entry.get("authors") or []
    if authors:
        row("Authors", _esc(", ".join(str(author) for author in authors)))
    ys, ye = entry.get("year_start"), entry.get("year_end")
    if ys or ye:
        yr = f"{ys}–{ye}" if (ys and ye and ys != ye) else str(ys or ye)
        row("Year", _esc(yr))
    keywords = entry.get("keywords") or []
    if keywords:
        row("Keywords", " ".join(f'<span class="kw">{_esc(k)}</span>' for k in keywords))
    return "".join(rows)


def _render_provenance(entry: dict[str, Any], asset_prefix: str = "../../") -> str:
    """Compact source identity shown before the article body."""
    parts: list[str] = []
    authors = entry.get("authors") or []
    if authors:
        parts.append(_esc(", ".join(str(author) for author in authors)))
    ys, ye = entry.get("year_start"), entry.get("year_end")
    if ys or ye:
        parts.append(_esc(f"{ys}–{ye}" if ys and ye and ys != ye else str(ys or ye)))
    if entry.get("citekey"):
        parts.append(f"citekey: {_esc(entry['citekey'])}")
    if entry.get("doi"):
        doi = str(entry["doi"])
        parts.append(f'<a href="{_esc("https://doi.org/" + quote(doi, safe="/._-()"))}">DOI {_esc(doi)}</a>')
    sources = entry.get("sources") or []
    if sources:
        source_links = [
            f'<a href="{_esc(_asset_href(str(source), asset_prefix))}">{_esc(str(source))}</a>'
            for source in sources
        ]
        parts.append("来源:" + " · ".join(source_links))
    if entry.get("review_status"):
        parts.append("复核:" + _esc(str(entry["review_status"])))
    if not parts:
        return ""
    return '<div class="article-provenance" aria-label="出处与文献身份">' + " · ".join(parts) + "</div>"


def _card(key: str, entry: dict[str, Any], type_accent: dict[str, str], slug_map: dict[str, str]) -> str:
    title = str(entry.get("title", ""))
    tier = str(entry.get("quality_tier", ""))
    summary = str(entry.get("summary", ""))
    keywords = [str(value) for value in (entry.get("keywords") or [])]
    category = str(entry.get("topic_category", ""))
    authors = [str(value) for value in (entry.get("authors") or [])]
    aliases = [str(value) for value in (entry.get("aliases") or [])]
    years = [str(value) for value in (entry.get("year_start"), entry.get("year_end")) if value]
    searchable = [title, category, *keywords, *authors, *aliases, *years, summary, str(entry.get("citekey", "")), str(entry.get("doi", ""))]
    search_payload = _esc(" ".join(searchable).lower())
    meta = ""
    if tier:
        meta += f'<span class="badge badge--{_esc(tier)}">{_esc(tier)}</span>'
    if entry.get("featured"):
        meta += '<span class="star" title="精选">⭐</span>'
    summ = f'<p class="card__summary">{_esc(summary)}</p>' if summary else ""
    backlinks = entry.get("backlinks", 0)
    backl = f'<span class="card__backlinks">{backlinks} backlinks</span>' if backlinks else ""
    return (f'<a href="{_esc(slug_map[key])}" class="card" data-search="{search_payload}">'
            f'<span class="card__meta">{meta}</span>'
            f'<h3 class="card__title">{_esc(title)}</h3>{summ}{backl}</a>')


def _footer(generated_at: str) -> str:
    legend = "".join(f'<span class="badge badge--{t}">{t}</span>' for t in _TIERS)
    return (f'<span class="foot__time">生成于 {_esc(generated_at)}</span>'
            f'<span class="legend" aria-label="质量分级">{legend}</span>')


# --- Page templates ------------------------------------------------------------

def _article_page(title: str, generated_at: str, toc_html: str, body_html: str, infobox_html: str, provenance_html: str = "") -> str:
    nav_inner = toc_html or '<p class="muted">(无目录)</p>'
    return f"""<!DOCTYPE html>
<html lang="zh" data-theme="shan-shui">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{_esc(title)}</title>
<style>{_STYLE}</style>
{_HEAD_SCRIPT}
</head>
<body>
<a class="skip-link" href="#main-article">跳到正文</a>
<header class="band">
{_SVG_SEAL}
<h1 class="band__title">{_esc(title)}</h1>
<button class="theme-toggle" data-theme-toggle type="button" aria-label="切换主题">{_SVG_THEME_TOGGLE} 主题</button>
</header>
<div class="layout">
<nav class="zone zone--nav" aria-label="目录">
<details class="collapse" data-collapse="768" open><summary>文献目录</summary>{nav_inner}</details>
</nav>
<main id="main-article" class="zone zone--main">
<article class="article">
<div class="article__nav"><a class="back-link" href="index.html">← 返回知识舆图</a><span class="muted">{_esc(title)}</span></div>
{provenance_html}
{body_html}
</article>
</main>
<aside class="zone zone--aside" aria-label="资料信息">
<details class="collapse" data-collapse="1100" open><summary>资料信息</summary><div class="infobox">{infobox_html}</div></details>
</aside>
</div>
<footer class="foot">{_footer(generated_at)}</footer>
<script>{_BODY_SCRIPT}</script>
</body>
</html>"""


def _group_key(entry: dict[str, Any]) -> str:
    """Index section key: agent-assigned subject, else page genre, else kind."""
    return _nfc(str(
        entry.get("topic_category", "")
        or entry.get("type", "")
        or ("query" if entry.get("kind") == "query" else "")
    ))


def _section(label: str, accent_token: str, cards_html: str, kind: str, extra: str = "") -> str:
    dot = f'<span class="type-dot" style="--dot:var({accent_token})"></span>'
    return (f'<section class="{kind}"{extra}>'
            f'<h2 class="section__title">{dot}{_esc(label)}</h2>'
            f'<div class="card-grid">{cards_html}</div></section>')


def _index_page(data: dict[str, Any], type_accent: dict[str, str], generated_at: str, slug_map: dict[str, str]) -> str:
    topics: dict[str, Any] = data.get("topics", {})
    queries: dict[str, Any] = data.get("queries", {})
    items = list(topics.items()) + list(queries.items())

    def by_title(ke: tuple[str, Any]) -> tuple[str, str]:
        return (_nfc(ke[1].get("title", "")), ke[0])

    sections = []
    featured = sorted((ke for ke in items if ke[1].get("featured")), key=by_title)
    if featured:
        cards = "".join(_card(k, e, type_accent, slug_map) for k, e in featured)
        sections.append(
            '<section class="featured" aria-label="精选">'
            '<h2 class="section__title"><span class="star">⭐</span> 精选</h2>'
            f'<div class="card-grid">{cards}</div></section>'
        )

    groups: dict[str, list[tuple[str, Any]]] = {}
    for k, e in items:
        groups.setdefault(_group_key(e), []).append((k, e))
    for t in sorted(x for x in groups if x):
        cards = "".join(_card(k, e, type_accent, slug_map) for k, e in sorted(groups[t], key=by_title))
        sections.append(_section(t, type_accent.get(t, "--faint"), cards, "type-section"))
    if "" in groups:
        cards = "".join(_card(k, e, type_accent, slug_map) for k, e in sorted(groups[""], key=by_title))
        sections.append(_section("未分类", "--faint", cards, "type-section"))

    body = "".join(sections)
    return f"""<!DOCTYPE html>
<html lang="zh" data-theme="shan-shui">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>知识舆图</title>
<style>{_STYLE}</style>
{_HEAD_SCRIPT}
</head>
<body>
<a class="skip-link" href="#main-index">跳到正文</a>
<header class="band">
{_SVG_SEAL}
<h1 class="band__title">知识舆图</h1>
<input type="search" id="search" class="search" placeholder="搜索标题 / 关键词 / 摘要…(按 / 快速搜索)" aria-label="搜索">
<button class="theme-toggle" data-theme-toggle type="button" aria-label="切换主题">{_SVG_THEME_TOGGLE} 主题</button>
</header>
<main id="main-index" class="index-main">
{body}
<div id="search-empty" class="search-empty" role="status" aria-live="polite" hidden>无匹配结果</div>
</main>
<footer class="foot">{_footer(generated_at)}</footer>
<script>{_BODY_SCRIPT}</script>
</body>
</html>"""


# --- Atomic write + orchestration (D11, contract preserved) --------------------

def generate_site(vault: str | Path) -> dict[str, Any]:
    """Generate a self-contained static HTML site under wiki/site/.

    Returns ``{"ok": True, "pages": int, "out": str, "degraded": bool, "errors": list}``.
    Raises ``ValueError("wiki_not_initialized")`` if the wiki is absent.

    Refuses (``ok: False``) when ``wiki/site`` or an ancestor of it is a link, because
    publishing through it would write outside the vault.
    """
    boundary.bind(vault)
    vault = Path(vault)
    wiki_root = config.wiki_root(vault)
    if not wiki_root.exists():
        raise ValueError("wiki_not_initialized")

    data, index_errors = wiki_index.rebuild(vault)
    topics = data.get("topics", {})
    queries = data.get("queries", {})
    alias_index = data.get("alias_index", {})
    generated_at = data.get("generated_at", wiki_index.EPOCH)
    topic_keys = set(topics)
    query_keys = set(queries)
    page_keys = topic_keys | query_keys

    # Build one slug map for topics and captured reports.
    slug_map = _build_slug_map(list(page_keys))

    # Deterministic accent assignment per index section key.
    all_entries = list(topics.values()) + list(queries.values())
    accent_keys = sorted({_group_key(e) for e in all_entries} - {""})
    type_accent = {t: _TYPE_ACCENTS[i % len(_TYPE_ACCENTS)] for i, t in enumerate(accent_keys)}

    site_dir = wiki_root / "site"
    try:
        boundary.ensure_directory(site_dir)
    except boundary.BoundaryError as exc:
        return {
            "ok": False,
            "pages": 0,
            "out": str(site_dir),
            "degraded": not MARKDOWN_AVAILABLE,
            "errors": list(index_errors) + [{"path": "site", "error": "outside_vault", "detail": str(exc)}],
        }

    pages_written = 0
    errors: list[dict[str, Any]] = list(index_errors)
    # Hold the verified site directory for the whole publication. On POSIX every write
    # and prune below is descriptor-relative, so swapping wiki/site for a link cannot
    # redirect publication or deletion; on Windows the held handle stops the directory
    # from being renamed or removed while we publish into it.
    with boundary.fs_for(site_dir).open_directory(site_dir) as out:
        # Invalidate before the first publication: errors or process interruption
        # must not leave a partial site behind an older successful run's stamp.
        with suppress(FileNotFoundError):
            out.unlink("_complete")
        for key, entry in list(topics.items()) + list(queries.items()):
            page_path = config.topics_dir(vault) / key if entry.get("kind") == "topic" else wiki_root / key
            if not boundary.exists(page_path):
                errors.append({"path": key, "error": "topic_missing"})
                continue
            try:
                text = boundary.read_text(page_path, encoding="utf-8-sig")
            except boundary.BoundaryError:
                errors.append({"path": key, "error": "topic_outside_vault"})
                continue
            except (UnicodeDecodeError, OSError):
                errors.append({"path": key, "error": "topic_decode_failed"})
                continue
            try:
                _meta, body = frontmatter.parse(text)
            except frontmatter.FrontmatterError:
                errors.append({"path": key, "error": "frontmatter_parse_failed"})
                continue
            body_html, toc = _render_body_and_toc(
                body, topic_keys, alias_index, slug_map, query_keys, "../../"
            )
            page = _article_page(
                str(entry.get("title", key)), generated_at,
                _render_toc(toc), body_html, _render_infobox(entry, "../../"),
                _render_provenance(entry, "../../"),
            )
            out.write_atomic(slug_map[key], page)
            pages_written += 1

        # index.html is written LAST so status.site_stale stays correct.
        out.write_atomic(
            "index.html", _index_page(data, type_accent, generated_at, slug_map)
        )

        # Prune orphaned HTML files not in current output set. Unlinking happens through
        # the same verified directory, so a link planted as an HTML name is refused
        # rather than followed to whatever it points at.
        current_files = {"index.html"} | set(slug_map.values())
        for html_file in out.names(".html"):
            if html_file not in current_files:
                out.unlink(html_file)

        # Alias resolution warnings do not mean a page failed to publish.
        # Unknown errors remain blocking rather than being silently downgraded.
        publication_errors = [
            error for error in errors
            if error.get("error") not in {"alias_map_invalid", "alias_target_missing", "alias_conflict"}
        ]
        if not publication_errors:
            out.write_atomic("_complete", b"ok")

    return {
        "ok": True,
        "pages": pages_written,
        "out": str(site_dir),
        "degraded": not MARKDOWN_AVAILABLE,
        "errors": errors,
        "complete": not publication_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