github-agent-cli 1.2.2__py3-none-any.whl → 1.3.0__py3-none-any.whl

ghagent.py

@@ -27,16 +27,16 @@ HERE = Path(__file__).resolve().parent
 if str(HERE) not in sys.path:
     sys.path.insert(0, str(HERE))
 
-from ghalib import assets as assets_module        # noqa: E402
-from ghalib import audit as audit_module           # noqa: E402
-from ghalib import changelog as changelog_module   # noqa: E402
-from ghalib import config as cfg                   # noqa: E402
-from ghalib import install as install_module       # noqa: E402
-from ghalib import mdcheck                         # noqa: E402
-from ghalib import meta as meta_module             # noqa: E402
-from ghalib import report as report_module         # noqa: E402
-from ghalib import wiki as wiki_module             # noqa: E402
-from ghalib.util import (                          # noqa: E402
+from ghalib import assets as assets_module  # noqa: E402
+from ghalib import audit as audit_module  # noqa: E402
+from ghalib import changelog as changelog_module  # noqa: E402
+from ghalib import config as cfg  # noqa: E402
+from ghalib import install as install_module  # noqa: E402
+from ghalib import mdcheck  # noqa: E402
+from ghalib import meta as meta_module  # noqa: E402
+from ghalib import report as report_module  # noqa: E402
+from ghalib import wiki as wiki_module  # noqa: E402
+from ghalib.util import (  # noqa: E402
     EXIT_FAIL,
     EXIT_OK,
     EXIT_USAGE,
@@ -46,7 +46,6 @@ from ghalib.util import (                          # noqa: E402
     emit,
     fail,
     force_utf8_stdio,
-    read_text,
     rel,
     write_text,
 )
@@ -138,22 +137,33 @@ def cmd_audit(args: argparse.Namespace) -> int:
 
 def cmd_doc(args: argparse.Namespace) -> int:
     root = Path(args.root)
+    config = cfg.load(root)
+    # `.ghagent.json` carries `ignore_rules` for the whole pack; `audit` applied them and
+    # `doc` did not, so the two commands disagreed about the same tree.
+    ignore = {item.strip() for item in args.ignore.split(",") if item.strip()}
+    ignore |= {item.strip() for item in config.ignore_rules if item.strip()}
     options = mdcheck.DocCheckOptions(
-        ignore={item.strip() for item in args.ignore.split(",") if item.strip()},
+        ignore=ignore,
         privacy=not args.no_privacy,
         toc=not args.no_toc,
+        safe_email_domains=set(config.safe_email_domains),
+        wiki_dirs={config.wiki_dir} if config.wiki_dir else set(),
     )
     report = Report(title="ghagent doc", root=str(root))
     checker = mdcheck.DocChecker(root, report, options)
-    # Wiki sources use wiki-namespace links (page names without .md); they are checked by
-    # `wiki build`/`wiki verify`, not as repository links. Opt in with --include-wiki.
-    skip_dirs = {".git", "node_modules", "vendor", ".ghagent", ".venv", "__pycache__"}
-    if not args.include_wiki:
-        skip_dirs.add("wiki")
-    targets = [Path(item) for item in args.paths] if args.paths else sorted(
-        path for path in root.rglob("*.md")
-        if not (set(path.parts) & skip_dirs)
-    )
+    if args.paths:
+        targets = [Path(item) for item in args.paths]
+    else:
+        # One walker for the whole pack: it knows which directories are build output or
+        # tool state (`.git`, `.swarm`, `node_modules`), so `doc` and `privacy` see the
+        # same tree. The wiki sources keep their own contract (`wiki build`/`wiki verify`).
+        targets = []
+        exclude = set(config.exclude_dirs)
+        for path in mdcheck.iter_text_files(root, suffix_set=set(mdcheck.MARKDOWN_SUFFIXES), exclude=exclude):
+            if not args.include_wiki and config.wiki_dir in path.relative_to(root).parts:
+                continue
+            targets.append(path)
+        targets.sort()
     if not targets:
         return fail("no markdown files found to check")
     for path in targets:
@@ -171,7 +181,7 @@ def cmd_privacy(args: argparse.Namespace) -> int:
                       "agents.md-length"}
     report = Report(title="ghagent privacy", root=str(root))
     checker = mdcheck.DocChecker(root, report, options)
-    for path in mdcheck.iter_text_files(root):
+    for path in mdcheck.iter_text_files(root, exclude=set(cfg.load(root).exclude_dirs)):
         checker.check_file(path)
     checker._report_coverage()
     return emit(report, args.json)
@@ -180,19 +190,23 @@ def cmd_privacy(args: argparse.Namespace) -> int:
 def cmd_wiki(args: argparse.Namespace) -> int:
     root = Path(args.root)
     config = cfg.load(root)
+    # None means "not given"; the default is applied here so that `verify` can tell an
+    # explicit `--wiki-dir <clone>` from the default `wiki/`.
+    wiki_dir_given = args.wiki_dir is not None
+    wiki_dir = args.wiki_dir or "wiki"
     if args.action == "init":
         report = wiki_module.scaffold(root, slug=args.repo or config.owner_repo, title=args.title,
-                                      wiki_dir=args.wiki_dir, from_docs=not args.no_docs)
+                                      wiki_dir=wiki_dir, from_docs=not args.no_docs)
         return emit(report, args.json)
     if args.action == "build":
-        report = wiki_module.build(root, wiki_dir=args.wiki_dir, manifest_path=args.manifest,
+        report = wiki_module.build(root, wiki_dir=wiki_dir, manifest_path=args.manifest,
                                    out_dir=Path(args.out) if args.out else None)
         if not args.json and report.data.get("out"):
             print(f"built {report.data.get('pages')} page(s) into {report.data['out']}")
         return emit(report, args.json)
     if args.action == "verify":
-        out = Path(args.out) if args.out else root / ".ghagent" / "wiki"
-        report = wiki_module.verify(out)
+        report = wiki_module.verify_target(root, out=Path(args.out) if args.out else None,
+                                           wiki_dir=wiki_dir, wiki_dir_given=wiki_dir_given)
         return emit(report, args.json)
     if args.action == "publish":
         slug = args.repo or config.owner_repo
@@ -272,9 +286,29 @@ def cmd_meta(args: argparse.Namespace) -> int:
         return report.exit_code()
     if args.action == "check":
         report = Report(title="ghagent meta check")
-        for level, rule, message in meta_module.validate_description(args.description):
+        slug = args.repo or ""
+        description = args.description
+        topics = [item.strip() for item in args.topics.split(",") if item.strip()] if args.topics else []
+        if slug:
+            # `--repo` used to be accepted and ignored: the command validated the empty
+            # arguments and reported "description is empty, 0 topics" for a repository that
+            # had both. A remote that cannot be read is an error, not an empty field.
+            current = meta_module.read_remote(slug)
+            if current is None:
+                report.error("meta.remote", f"cannot read {slug} through gh api",
+                             hint="run `gh auth status`; an unread remote is not an empty description")
+                return emit(report, args.json)
+            if description is None:
+                description = (current.get("description") or "").strip()
+            if not topics:
+                topics = list(current.get("topics") or [])
+            report.data["source"] = f"gh api repos/{slug}"
+            report.data["topics"] = topics
+            report.data["description"] = description
+        for level, rule, message in meta_module.validate_description(description):
             report.add(level, rule, message)
-        topics = [item.strip() for item in args.topics.split(",") if item.strip()]
+        if not topics:
+            report.info("meta.source", "topics were not given and no remote was read")
         for level, rule, message in meta_module.check_topics(topics, minimum=config.topic_min,
                                                             maximum=config.topic_max):
             report.add(level, rule, message)
@@ -283,11 +317,12 @@ def cmd_meta(args: argparse.Namespace) -> int:
         slug = args.repo or config.owner_repo
         if not slug:
             return fail("meta apply needs --repo owner/name or owner_repo in .ghagent.json")
-        topics = [item.strip() for item in args.topics.split(",") if item.strip()] if args.topics else None
+        apply_topics: list[str] | None = ([item.strip() for item in args.topics.split(",") if item.strip()]
+                                        if args.topics else None)
         report = meta_module.apply_metadata(
             slug,
             description=args.description,
-            topics=topics,
+            topics=apply_topics,
             homepage=args.homepage,
             merge_topics=not args.replace_topics,
             write=args.write,
@@ -431,7 +466,7 @@ def build_parser() -> argparse.ArgumentParser:
     wiki_parser.add_argument("--root", default=".")
     wiki_parser.add_argument("--repo", default="")
     wiki_parser.add_argument("--title", default="Project")
-    wiki_parser.add_argument("--wiki-dir", default="wiki")
+    wiki_parser.add_argument("--wiki-dir", default=None)
     wiki_parser.add_argument("--manifest", default="wiki/wiki.json")
     wiki_parser.add_argument("--out", default="")
     wiki_parser.add_argument("--push", action="store_true", help="actually push to the wiki remote")

ghalib/assets.py

@@ -16,20 +16,24 @@ nothing at all. A missing Pillow lowers the output format, never the honesty of
 
 from __future__ import annotations
 
-import base64
 import re
 import struct
 import zlib
 from dataclasses import dataclass, field
 from pathlib import Path
 
-from .util import IMAGE_RE, Report, iter_text_files, read_text, rel
+from .util import IMAGE_RE, Report, read_text, rel
 
 SOCIAL_SIZE = (1280, 640)
 SOCIAL_MIN = (640, 320)
 SOCIAL_MAX_BYTES = 1_000_000
 IMAGE_SUFFIXES = {".png", ".jpg", ".jpeg", ".gif", ".svg", ".webp", ".avif"}
 SOCIAL_ACCEPTED = {".png", ".jpg", ".jpeg", ".gif"}
+# An emoji in an H1 is fine on GitHub and unreadable on a rendered card: the font set has
+# no colour glyphs, so it lands as a box or disappears. The banner strips it.
+EMOJI_RE = re.compile(
+    "[\U0001F300-\U0001FAFF\U00002600-\U000027BF\U0001F1E6-\U0001F1FF\u2b00-\u2bff\uFE0F]"
+)
 
 PALETTE = {
     "bg": "#0d1117",
@@ -120,26 +124,29 @@ def _escape(text: str) -> str:
 
 
 def _wrap(text: str, limit: int, max_lines: int) -> list[str]:
+    """Wrap into at most `max_lines` lines of about `limit` characters.
+
+    The last line is filled before anything is dropped: an earlier version stopped at
+    `max_lines - 1` lines and marked the rest as cut, so a 38-character title was reported
+    as truncated although two lines had room for it.
+    """
     words = text.split()
     lines: list[str] = []
     current = ""
     for word in words:
         candidate = f"{current} {word}".strip()
-        if len(candidate) <= limit:
+        if not current or len(candidate) <= limit:
             current = candidate
             continue
-        if current:
-            lines.append(current)
+        lines.append(current)
         current = word
-        if len(lines) == max_lines - 1:
+        if len(lines) == max_lines:
             break
-    if current and len(lines) < max_lines:
-        lines.append(current)
-    if not lines:
-        return []
-    remainder = " ".join(words)[len(" ".join(lines)):].strip()
-    if remainder and lines:
-        lines[-1] = lines[-1].rstrip(" .,;") + "…"
+    else:
+        if current:
+            lines.append(current)
+        return lines[:max_lines]
+    lines[-1] = lines[-1].rstrip(" .,;") + "…"
     return lines
 
 
@@ -261,6 +268,11 @@ def render_png(spec: BannerSpec) -> bytes | None:
     return buffer.getvalue()
 
 
+def _truncated(lines: list[str]) -> bool:
+    """`_wrap` marks a loss of text with an ellipsis; the caller must say so out loud."""
+    return bool(lines) and lines[-1].endswith("…")
+
+
 def spec_from_repository(root: Path, *, title: str = "", tagline: str = "", command: str = "",
                          chips: list[str] | None = None) -> BannerSpec:
     from . import meta as meta_module
@@ -277,12 +289,19 @@ def spec_from_repository(root: Path, *, title: str = "", tagline: str = "", comm
         if not summary:
             summary = facts.get("summary", "")
     languages = [language for language, _count in facts.get("languages", [])[:3]]
+    # Chips describe what the project IS, not what its tooling is written in: a PHP library
+    # whose scripts happen to be Python and shell was advertised as "php python shell".
+    # Declared keywords come first; languages are only the fallback.
+    keywords = [str(word) for word in facts.get("declared_keywords", []) if str(word).strip()][:3]
+    default_chips = keywords or languages
+    resolved_title = title or facts.get("title") or Path(root).name
+    resolved_title = EMOJI_RE.sub("", resolved_title).strip() or Path(root).name
     return BannerSpec(
-        title=title or facts.get("title") or Path(root).name,
+        title=resolved_title,
         tagline=tagline or summary[:180],
         command=command,
-        chips=(chips if chips is not None else languages + ["mit"])[:6],
-        footer=" · ".join(filter(None, ["MIT", ", ".join(languages)])),
+        chips=(chips if chips is not None else default_chips + ["mit"])[:6],
+        footer=" · ".join(filter(None, ["MIT", languages[0] if languages else ""])),
     )
 
 
@@ -308,6 +327,17 @@ def write_assets(root: Path, *, out_dir: str = "assets", spec: BannerSpec | None
         "written": [],
         "png_unavailable": "" if png else "Pillow is not installed: only the SVG was produced",
     })
+    # A silently cut title is a defect of the render, not of the reader's screen: the PNG
+    # is what the social preview shows and it cannot grow.
+    if _truncated(_wrap(spec.title, 26, 2)):
+        report.warn("assets.truncated", f"the title is cut at two lines ({len(spec.title)} characters)",
+                    hint="shorten --title: it renders as two lines of about 26 characters")
+    if _truncated(_wrap(spec.tagline, 62, 3)):
+        report.warn("assets.truncated", f"the tagline is cut at three lines ({len(spec.tagline)} characters)",
+                    hint="shorten --tagline: it renders as three lines of about 62 characters")
+    if not spec.command:
+        report.info("assets.no-command", "the banner carries no command line",
+                    hint="pass --command 'ghagent audit .' to show one")
     if not png:
         report.warn("assets.no-pillow", "Pillow is not available, so no PNG was rendered",
                     hint="a social preview must be PNG/JPG/GIF; install Pillow or supply your own image")

ghalib/audit.py

@@ -27,7 +27,6 @@ from .util import (
     EXIT_FAIL,
     EXIT_OK,
     Report,
-    guess_repo_slug,
     read_text,
     rel,
     run,
@@ -187,8 +186,14 @@ def audit_local(root: Path, *, config: cfg.Config | None = None, doc_report: Rep
             report.warn("wiki.manifest", f"{config.wiki_manifest} is absent",
                         hint="wiki build cannot order pages without a manifest")
     else:
+        # A repository may keep its wiki in its own git repository, or not have one at all;
+        # neither is a defect. Skipping keeps the item out of the score instead of charging
+        # three points for a file the project never intended to publish here.
         result.items.append(Item(ident="wiki-source", title=f"{config.wiki_dir}/", weight=3,
-                                 status="fail", detail="no wiki source directory"))
+                                 status="skipped",
+                                 detail=f"no {config.wiki_dir}/ directory (wiki not maintained in this repository)"))
+        report.info("wiki.source-absent", f"no {config.wiki_dir}/ directory; the wiki item is not scored",
+                    hint="a wiki kept in its own repository is checked in that checkout")
 
     assets_report = assets_module.check(root, report=report)
     reference_item = Item(ident="assets.banner", title="README banner", weight=4)

ghalib/changelog.py

@@ -57,6 +57,11 @@ TYPE_TO_SECTION = {
 NOISE_TYPES = {"chore", "test", "tests", "ci", "wip", "release"}
 SECTION_ORDER = {name.lower(): index for index, name in enumerate(TYPES_EN)}
 SECTION_ORDER.update({name.lower(): index for index, name in enumerate(TYPES_RU)})
+# A group heading may carry a subtitle: `### Added — template language`. The subtitle
+# groups entries inside the type, it does not invent a new type, so it is dropped before
+# the lookup. Measured on a real changelog: 10 false "unknown change type" warnings, one
+# per grouped section, on a document that follows Keep a Changelog.
+SUBTITLE_SPLIT = re.compile(r"\s+[—–-]\s+|\s*:\s+")
 
 
 @dataclass
@@ -66,10 +71,19 @@ class VersionSection:
     line: int
     sections: list[tuple[str, int]]     # (heading text, line)
     items: int = 0
+    prose: int = 0                      # non-blank body lines outside a `###` subsection
 
 
 def section_name(heading: str) -> str | None:
-    return TYPE_ALIASES.get(heading.strip().lower())
+    """Map a `###` heading to a canonical change type, ignoring a grouping subtitle."""
+    text = heading.strip()
+    canonical = TYPE_ALIASES.get(text.lower())
+    if canonical:
+        return canonical
+    base = SUBTITLE_SPLIT.split(text, maxsplit=1)[0].strip()
+    if base != text:
+        return TYPE_ALIASES.get(base.lower())
+    return None
 
 
 def parse(text: str) -> tuple[list[VersionSection], dict[str, str]]:
@@ -91,6 +105,8 @@ def parse(text: str) -> tuple[list[VersionSection], dict[str, str]]:
             if level == 2:
                 if current and current_section_start is not None:
                     current.items += _count_items(lines, current_section_start, index)
+                if current:
+                    current.prose += _count_prose(lines, current.line, index)
                 current_section_start = None
                 if title.strip().strip("[]").lower() in {"unreleased", "не выпущено", "невыпущено"}:
                     current = VersionSection(version="Unreleased", date="", line=index, sections=[])
@@ -109,9 +125,22 @@ def parse(text: str) -> tuple[list[VersionSection], dict[str, str]]:
                 current_section_start = index
     if current and current_section_start is not None:
         current.items += _count_items(lines, current_section_start, len(lines) + 1)
+    if current:
+        current.prose += _count_prose(lines, current.line, len(lines) + 1)
     return versions, references
 
 
+def _count_prose(lines: list[str], start: int, end: int) -> int:
+    """Body lines that are neither a heading, a list item nor blank."""
+    count = 0
+    for raw in lines[start:end - 1]:
+        stripped = raw.strip()
+        if not stripped or stripped.startswith("#") or re.match(r"^[-*]\s+\S", stripped):
+            continue
+        count += 1
+    return count
+
+
 def _count_items(lines: list[str], start: int, end: int) -> int:
     count = 0
     for raw in lines[start:end - 1]:
@@ -207,11 +236,23 @@ def check(path: Path, *, report: Report | None = None, slug: str = "", today: dt
         previous_key = key
 
         if not section.sections:
-            report.error("changelog.empty-version", f"version {section.version} has no change subsections",
-                         path=path.name, line=section.line)
+            if section.prose:
+                report.warn("changelog.prose-version",
+                            f"version {section.version} describes its changes in prose, without `###` subsections",
+                            path=path.name, line=section.line,
+                            hint="Keep a Changelog reads a version by subsection; a paragraph is accepted but not comparable")
+            else:
+                report.error("changelog.empty-version", f"version {section.version} has no change subsections",
+                             path=path.name, line=section.line)
         if section.sections and section.items == 0:
-            report.error("changelog.empty-version", f"version {section.version} has headings but no entries",
-                         path=path.name, line=section.line)
+            if section.prose:
+                report.warn("changelog.prose-version",
+                            f"version {section.version}: the subsections carry no list items",
+                            path=path.name, line=section.line,
+                            hint="list each change as a `- ` item so it can be compared and released")
+            else:
+                report.error("changelog.empty-version", f"version {section.version} has headings but no entries",
+                             path=path.name, line=section.line)
 
         names: list[str] = []
         for heading, line in section.sections:
@@ -229,8 +270,12 @@ def check(path: Path, *, report: Report | None = None, slug: str = "", today: dt
     uses_brackets = any(re.match(r"^##\s+\[", raw) for raw in lines)
     if uses_brackets:
         if not references:
-            report.error("changelog.link-refs", "versions use [x.y.z] but there are no link references at the bottom",
-                         path=path.name, hint="add `[x.y.z]: https://…/compare/…` lines")
+            # Keep a Changelog makes the link references optional: `## [Unreleased]` without
+            # a bottom-of-file `[unreleased]:` line is a legal document. Reporting it as an
+            # error turned a correct changelog into a red gate (measured: exit 1 on a
+            # repository whose only defect was the missing optional block).
+            report.warn("changelog.link-refs", "versions use [x.y.z] but there are no link references at the bottom",
+                        path=path.name, hint="optional in Keep a Changelog; `[x.y.z]: https://…/compare/…` links the versions")
         else:
             for label in ["unreleased", *[v.version.lower() for v in released]]:
                 if label not in references:
@@ -390,7 +435,7 @@ def suggest(root: Path, since: str, *, include_noise: bool = False, limit: int =
     breaking: list[str] = []
     for record in records:
         parts = record.split("\x1f")
-        sha = parts[0].strip()[:7]
+        _sha = parts[0].strip()[:7]      # the record format is `<sha>\x1f<subject>\x1f<body>`
         subject = parts[1].strip() if len(parts) > 1 else ""
         body = parts[2].strip() if len(parts) > 2 else ""
         match = CONVENTIONAL_RE.match(subject)

ghalib/config.py

@@ -27,6 +27,13 @@ class Config:
     ci_workflow: str = ".github/workflows/ci.yml"
     require_files: list[str] = field(default_factory=list)
     ignore_rules: list[str] = field(default_factory=list)
+    # Domains that are role addresses in this repository (`@mycompany.com`). The built-in
+    # list holds only RFC examples and GitHub noreply addresses, so no project's personal
+    # domain is whitelisted by default for everybody else.
+    safe_email_domains: list[str] = field(default_factory=list)
+    # Extra directories the documentation walk must not enter (build output whose name the
+    # pack cannot know: `site`, `_site`, `public`, `out`).
+    exclude_dirs: list[str] = field(default_factory=list)
     topic_min: int = 8
     topic_max: int = 20
     description_max: int = 200

ghalib/mdcheck.py

@@ -10,11 +10,9 @@ from __future__ import annotations
 import re
 from dataclasses import dataclass, field
 from pathlib import Path
-from urllib.parse import unquote, urlparse
+from urllib.parse import unquote
 
 from .util import (
-    FENCE_RE,
-    IMAGE_RE,
     INLINE_LINK_RE,
     MARKDOWN_SUFFIXES,
     Report,
@@ -27,6 +25,11 @@ from .util import (
 )
 
 ALLOWED_ALERTS = {"NOTE", "TIP", "IMPORTANT", "WARNING", "CAUTION"}
+# GitHub wiki furniture: partial pages that carry navigation, not documents. A wiki
+# renders `_Sidebar.md` and `_Footer.md` on every page, so neither the H1 rule nor a
+# page-shaped link contract applies to them (measured: 2 false errors on a 24-page wiki).
+WIKI_FURNITURE = {"_sidebar.md", "_footer.md", "_header.md"}
+WIKI_MODE_MARKERS = ("_Sidebar.md", "_Footer.md")
 # AGENTS.md is the import entry point an agent reads first: a map, not a manual. The
 # canonical root file is the only one this rule measures — translations and nested
 # copies are checked by their own contracts.
@@ -44,9 +47,11 @@ ABS_PATH_PATTERNS = [
     re.compile(r"(?<![\w.])/(?:home|Users)/[a-z0-9._-]+/", re.IGNORECASE),
 ]
 PERSONAL_EMAIL_RE = re.compile(r"\b[A-Za-z0-9._%+-]+@([A-Za-z0-9.-]+\.[A-Za-z]{2,})\b")
+# Role addresses only: a personal domain that happens to belong to the pack's author has
+# no place here, or the whitelist becomes a leak of its own. A repository adds its own
+# domains with `safe_email_domains` in `.ghagent.json`.
 SAFE_EMAIL_DOMAINS = {
-    "users.noreply.github.com", "example.com", "example.org", "example.net",
-    "localhost", "deynekin.com",
+    "users.noreply.github.com", "example.com", "example.org", "example.net", "localhost",
 }
 KEBAB_TOPIC_RE = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
 
@@ -67,6 +72,13 @@ class DocCheckOptions:
     toc: bool = True
     line_length: int = 200
     max_line_rule: bool = True
+    # None means "decide from the tree": a directory that carries `_Sidebar.md` or
+    # `_Footer.md` is a wiki checkout, and a wiki addresses pages by name.
+    wiki_links: bool | None = None
+    # Directory names whose contents are wiki sources even without the generated markers
+    # (`wiki/` holds page-name links; the sidebar is generated into the build).
+    wiki_dirs: set[str] = field(default_factory=set)
+    safe_email_domains: set[str] = field(default_factory=set)
 
 
 class DocChecker:
@@ -76,6 +88,26 @@ class DocChecker:
         self.options = options or DocCheckOptions()
         self.stats: dict[str, RuleStats] = {}
         self.anchor_cache: dict[Path, set[str]] = {}
+        self.wiki_cache: dict[Path, bool] = {}
+
+    def wiki_tree(self, path: Path) -> bool:
+        """True when the document lives in a GitHub wiki checkout.
+
+        A wiki links its own pages by name (`[Architecture](Architecture)`), and GitHub
+        resolves that to `Architecture.md`. In an ordinary repository the same link is a
+        404, so the resolution is enabled only where the context proves it: the directory
+        carries `_Sidebar.md` or `_Footer.md`. Measured on a 24-page wiki before the fix:
+        119 errors, of which 117 were correct links reported as missing files.
+        """
+        if self.options.wiki_links is not None:
+            return self.options.wiki_links
+        directory = path.parent.resolve()
+        if directory not in self.wiki_cache:
+            named = bool(self.options.wiki_dirs) and any(part in self.options.wiki_dirs
+                                                         for part in path.parts[:-1])
+            self.wiki_cache[directory] = named or any((directory / marker).exists()
+                                                      for marker in WIKI_MODE_MARKERS)
+        return self.wiki_cache[directory]
 
     # -- infrastructure ----------------------------------------------------
     def _rule(self, rule: str) -> bool:
@@ -164,10 +196,14 @@ class DocChecker:
             h1 = [h for h in headings if h.level == 1]
             is_template = ".github" in path.parts or "template" in path.name.lower()
             is_template = is_template or "<!-- ghagent: template -->" in text
+            is_furniture = path.name.lower() in WIKI_FURNITURE
             if not h1:
                 if is_template:
                     self.report.info("md.h1", "template without an H1 (expected: the body starts at H2)",
                                      path=relative, line=1)
+                elif is_furniture:
+                    self.report.info("md.h1", "wiki partial without an H1 (navigation is rendered on every page)",
+                                     path=relative, line=1)
                 else:
                     self.report.error("md.h1", "no H1 heading", path=relative, line=1,
                                       hint="a document needs exactly one H1")
@@ -288,6 +324,7 @@ class DocChecker:
 
     def _check_links(self, path: Path, relative: str, links, headings, text: str) -> None:
         local_anchors = {h.anchor for h in headings}
+        wiki = self.wiki_tree(path)
         for link in links:
             if link.kind != "inline":
                 continue
@@ -304,9 +341,23 @@ class DocChecker:
                 continue  # placeholder kept on purpose in templates
             if self._rule("md.link-local"):
                 self._hit("md.link-local")
-                self._resolve_link(path, relative, link, local_anchors)
+                self._resolve_link(path, relative, link, local_anchors, wiki)
 
-    def _resolve_link(self, path: Path, relative: str, link, local_anchors: set[str]) -> None:
+    @staticmethod
+    def wiki_page_target(candidate: Path) -> Path | None:
+        """Resolve a wiki page name to its file: `Architecture` -> `Architecture.md`.
+
+        A wiki page name may contain dots (`Migration-3.x-to-4.0`), so the suffix is
+        appended to the whole name instead of replacing what looks like an extension.
+        """
+        for suffix in (".md", ".markdown", ".mdown"):
+            alternative = candidate.with_name(candidate.name + suffix)
+            if alternative.exists():
+                return alternative
+        return None
+
+    def _resolve_link(self, path: Path, relative: str, link, local_anchors: set[str],
+                      wiki: bool = False) -> None:
         target = link.target.strip()
         anchorless = target.split("#", 1)[0]
         anchor = target.split("#", 1)[1] if "#" in target else ""
@@ -319,10 +370,13 @@ class DocChecker:
                                 hint="a trailing slash is a browsable directory on GitHub; a file link is better for readers")
                 return
             if not candidate.exists():
-                self.report.error("md.link-local", f"target does not exist: {target}",
-                                  path=relative, line=link.line,
-                                  hint="fix the path or drop the link")
-                return
+                resolved = self.wiki_page_target(candidate) if wiki else None
+                if resolved is None:
+                    self.report.error("md.link-local", f"target does not exist: {target}",
+                                      path=relative, line=link.line,
+                                      hint="fix the path or drop the link")
+                    return
+                candidate = resolved
             if anchor and candidate.suffix.lower() in MARKDOWN_SUFFIXES:
                 if anchor.lower() not in {a.lower() for a in self.anchors_of(candidate)}:
                     self.report.error("md.link-anchor",
@@ -391,9 +445,10 @@ class DocChecker:
                                       path=relative, line=line,
                                       hint="use a relative path or a <placeholder>")
         if self._rule("privacy.email"):
+            allowed = SAFE_EMAIL_DOMAINS | {domain.lower() for domain in self.options.safe_email_domains}
             for match in PERSONAL_EMAIL_RE.finditer(text):
                 domain = match.group(1).lower()
-                if domain in SAFE_EMAIL_DOMAINS:
+                if domain in allowed:
                     continue
                 self._hit("privacy.email")
                 line = text.count("\n", 0, match.start()) + 1

ghalib/meta.py

@@ -13,7 +13,6 @@ call erases topics that were not part of the edit.
 from __future__ import annotations
 
 import json
-import os
 import re
 from collections import Counter
 from pathlib import Path

ghalib/report.py

@@ -9,7 +9,7 @@ from . import changelog as changelog_module
 from . import config as cfg
 from . import mdcheck
 from . import wiki as wiki_module
-from .util import EXIT_FAIL, EXIT_OK, Report, rel
+from .util import EXIT_FAIL, EXIT_OK, Report
 
 
 def build(root: Path) -> tuple[str, int]:

ghalib/util.py

@@ -17,7 +17,7 @@ from dataclasses import dataclass, field
 from pathlib import Path
 
 PACK_NAME = "github-agent"
-PACK_VERSION = "1.2.2"
+PACK_VERSION = "1.3.0"
 
 EXIT_OK = 0
 EXIT_FAIL = 1
@@ -121,11 +121,36 @@ def force_utf8_stdio() -> None:
             pass
 
 
-def iter_text_files(root: Path, *, suffix_set: set[str] | None = None):
+# A directory whose name starts with a dot carries tool state, not documentation: `.git`,
+# `.idea`, `.ruff_cache`, and the scratch space of a coding agent (`.swarm`, `.claude`,
+# `.dsh`, `.cursor`). Walking it produced privacy errors for machine paths written in a
+# plan file that is never published — measured on a real repository: 6 errors in `.swarm/`
+# that blocked the gate. The allowlist holds the one dot-directory that IS a published
+# surface: `.github/` (issue forms, PR template) and `.well-known/`.
+HIDDEN_DIR_ALLOWLIST = {".github", ".well-known"}
+
+
+def visible_dirs(names, exclude=()) -> list[str]:
+    """Directories a documentation walk may enter: no build output, no tool state.
+
+    `exclude` carries the names a repository adds itself (`.ghagent.json` → `exclude_dirs`),
+    so a project with a generated `site/` directory does not teach the pack the name of its
+    build tool.
+    """
+    blocked = set(exclude) | EXCLUDED_DIRS
+    return sorted(
+        name for name in names
+        if name not in blocked
+        and not name.startswith(".ghagent-")
+        and (not name.startswith(".") or name in HIDDEN_DIR_ALLOWLIST)
+    )
+
+
+def iter_text_files(root: Path, *, suffix_set: set[str] | None = None, exclude=()):
     root = Path(root)
     suffixes = suffix_set if suffix_set is not None else TEXT_SUFFIXES
     for dirpath, dirnames, filenames in os.walk(root):
-        dirnames[:] = sorted(d for d in dirnames if d not in EXCLUDED_DIRS and not d.startswith(".ghagent-"))
+        dirnames[:] = visible_dirs(dirnames, exclude)
         for name in sorted(filenames):
             path = Path(dirpath) / name
             if path.suffix.lower() in suffixes:

ghalib/wiki.py

@@ -175,7 +175,7 @@ def rewrite_page(text: str, page_path: Path, root: Path, manifest: WikiManifest,
             continue
 
         def replace_image(match: re.Match) -> str:
-            alt, target = match.group(1), match.group(2)
+            target = match.group(2)
             if re.match(r"^(https?:)?//", target) or target.startswith("data:"):
                 return match.group(0)
             report.error("wiki.image-relative", f"relative image in {page_name}: {target}",
@@ -264,15 +264,50 @@ def render_footer(manifest: WikiManifest, report: Report) -> str:
     return "---\n*" + " · ".join(parts) + "*\n"
 
 
+# --------------------------------------------------------------------------
+# verify target selection
+# --------------------------------------------------------------------------
+
+def verify_target(root: Path, *, out: Path | None, wiki_dir: str, wiki_dir_given: bool) -> Report:
+    """Decide what to verify: an explicit --out, a --wiki-dir that is already a wiki, or the build.
+
+    `wiki verify --root <repo> --wiki-dir <clone>` used to ignore the flag and look in
+    `<repo>/.ghagent/wiki`, which made the command useless for the growing number of
+    repositories whose wiki lives in its own checkout: the answer was always
+    `wiki.build-missing`, and the header named a directory the caller never passed.
+    """
+    root = Path(root)
+    if out is not None:
+        return verify(out, root=root, wiki_dir=wiki_dir)
+    candidate = root / wiki_dir
+    if wiki_dir_given and candidate.is_dir():
+        looks_built = any((candidate / f"{name}.md").exists() for name in ("Home", "_Sidebar", "_Footer"))
+        if looks_built:
+            return verify(candidate, root=root, wiki_dir=wiki_dir)
+    return verify(root / ".ghagent" / "wiki", root=root, wiki_dir=wiki_dir)
+
+
 # --------------------------------------------------------------------------
 # verify (built tree)
 # --------------------------------------------------------------------------
 
-def verify(build_dir: Path, *, report: Report | None = None) -> Report:
+def verify(build_dir: Path, *, report: Report | None = None, root: Path | None = None,
+           wiki_dir: str = "wiki") -> Report:
     build_dir = Path(build_dir)
     report = report or Report(title="ghagent wiki verify", root=str(build_dir))
     if not build_dir.is_dir():
-        report.error("wiki.build-missing", f"no built wiki at {build_dir}", hint="run `ghagent wiki build` first")
+        sources = Path(root) / wiki_dir if root is not None else None
+        if sources is not None and sources.is_dir() and any(sources.glob("*.md")):
+            report.error("wiki.build-missing", f"no built wiki at {build_dir}",
+                         hint=f"sources exist at {wiki_dir}/: run `ghagent wiki build` (or `wiki publish --push`, which builds and verifies)")
+        else:
+            # Nothing to verify and nothing missing: a repository may keep its wiki in a
+            # separate git repository, and then there is no build here at all. Reporting
+            # that as an error made the command unusable for those repositories.
+            report.info("wiki.not-applicable",
+                        f"no built wiki at {build_dir} and no sources at {wiki_dir}/; nothing to verify",
+                        hint="a wiki kept in its own repository is checked in that checkout: "
+                             "`ghagent doc --root <clone>` (wiki mode is detected from _Sidebar.md)")
         return report
 
     pages = {p.stem for p in build_dir.glob("*.md") if not p.name.startswith("_")}

{github_agent_cli-1.2.2.dist-info → github_agent_cli-1.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: github-agent-cli
-Version: 1.2.2
+Version: 1.3.0
 Summary: Repository and wiki steward: one command per documentation job, standard library only.
 Project-URL: Homepage, https://github.com/paulmann/github-agent
 Project-URL: Documentation, https://github.com/paulmann/github-agent/tree/main/docs
@@ -42,13 +42,20 @@ the repository — one command per job.
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-3776AB)](https://www.python.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Runtime dependencies](https://img.shields.io/badge/runtime%20dependencies-0-brightgreen)](pyproject.toml)
-[![Self-tests](https://img.shields.io/badge/self--tests-173%20checks-brightgreen)](tests/run_tests.py)
+[![Self-tests](https://img.shields.io/badge/self--tests-194%20checks-brightgreen)](tests/run_tests.py)
 
 <img src="https://github.com/paulmann/github-agent/raw/main/assets/social-preview.png"
      alt="github-agent — repository and wiki steward for AI agents"
      width="100%">
 
-[**Installation**](#installation) · [**Usage**](#usage) · [**Wiki**](https://github.com/paulmann/github-agent/wiki) · [**AGENTS.md**](AGENTS.md) · [**MIGRATION.md**](MIGRATION.md) · [**Packaging**](docs/PACKAGING.md) · [**Changelog**](CHANGELOG.md) · [**Issues**](https://github.com/paulmann/github-agent/issues) · [**Security**](SECURITY.md) · [**Русская версия**](README.ru.md)
+<img src="https://github.com/paulmann/github-agent/raw/main/assets/demo.gif"
+     alt="Three ghagent commands in a terminal: audit scores 100%, doc and changelog check pass"
+     width="100%">
+
+<sub>The animation is produced by `tools/make_demo.py` from the real output of three commands; it
+cannot show anything the tool did not print.</sub>
+
+[**Installation**](#installation) · [**Usage**](#usage) · [**Why this exists**](#why-this-exists) · [**How it compares**](#how-it-compares) · [**Docs site**](https://paulmann.github.io/github-agent/) · [**Wiki**](https://github.com/paulmann/github-agent/wiki) · [**AGENTS.md**](AGENTS.md) · [**Packaging**](docs/PACKAGING.md) · [**Changelog**](CHANGELOG.md) · [**Issues**](https://github.com/paulmann/github-agent/issues) · [**Security**](SECURITY.md) · [**Русская версия**](README.ru.md)
 
 A repository rarely fails on code; it fails on documentation. The README has no installation
 section, the changelog has no dates, the wiki is three pages without navigation, the banner is
@@ -58,8 +65,8 @@ This pack puts a verifiable contract on each of those places and reduces the wor
 command. It does not write marketing copy and does not invent numbers: it checks what a human
 wrote and refuses to publish what is broken.
 
-> **Documentation status.** Every number in this README was measured on 2026-10-30 against
-> version 1.2.0 with the commands named in the table. Long guides live in the
+> **Documentation status.** Every number in this README was measured on 2026-11-01 against
+> version 1.3.0 with the commands named in the table. Long guides live in the
 > [Wiki](https://github.com/paulmann/github-agent/wiki) and [`docs/`](docs/IMPORT.md); the
 > protocol for agents is [`AGENTS.md`](AGENTS.md), the packaging and migration notes are
 > [`docs/PACKAGING.md`](docs/PACKAGING.md) and [`MIGRATION.md`](MIGRATION.md).
@@ -69,9 +76,11 @@ wrote and refuses to publish what is broken.
 
 ## Contents
 
+- [Why this exists](#why-this-exists)
 - [Installation](#installation)
 - [Usage](#usage)
 - [What the pack does](#what-the-pack-does)
+- [How it compares](#how-it-compares)
 - [In numbers](#in-numbers)
 - [Checks that run](#checks-that-run)
 - [Images](#images)
@@ -86,6 +95,24 @@ wrote and refuses to publish what is broken.
 
 ---
 
+## Why this exists
+
+GitHub renders whatever you commit. It does not tell you that the installation section is
+missing, that the changelog has no dates, that the wiki has no navigation, that the banner is a
+broken image or that the description is one word. `git push` succeeds either way, and the defect
+survives for years because nobody is looking at the repository as a product.
+
+Three ideas decide how the pack behaves:
+
+1. **A check you cannot run is not a check.** Every rule is one command with an exit code:
+   `0` clean, `1` findings at error level, `2` usage or environment problem. A rule that examined
+   zero objects reports `coverage.skipped` — a green check over an empty set is a defect.
+2. **A false `PASS` is worse than a false `FAIL`.** The tool would rather stop a correct pull
+   request than wave a broken one through. Where that costs a real repository time, the rule is
+   narrowed until both answers are right — see [Field notes](https://paulmann.github.io/github-agent/FIELD-NOTES/).
+3. **Numbers over adjectives.** The README, the changelog and the metadata are checked against
+   what the repository can prove. Nothing here writes marketing copy.
+
 ## Installation
 
 Python 3.11 or newer is required; CI runs the suite on 3.11 and 3.13. There are no runtime
@@ -99,10 +126,13 @@ the wheel ships only the CLI.
 uv tool install github-agent-cli        # uv, isolated tool environment
 pipx install github-agent-cli           # pipx, isolated virtual environment
 pip install github-agent-cli            # pip into the active environment
+brew install paulmann/homebrew-github-agent-cli/github-agent-cli   # macOS and Linux
+scoop bucket add github-agent-cli https://github.com/paulmann/scoop-github-agent-cli
+scoop install github-agent-cli                                     # Windows
 ghagent --version
 ```
 
-> **Published on PyPI.** `github-agent-cli` 1.2.2 has been available since 2026-10-30:
+> **Published on PyPI.** `github-agent-cli` 1.3.0 has been available since 2026-11-01:
 > <https://pypi.org/project/github-agent-cli/>. The wheel ships the CLI only; the pack
 > (skills, tests, reference, wiki sources) comes from the clone below.
 
@@ -145,7 +175,7 @@ docker run --rm -v "$PWD:/repo" ghagent audit .
 
 On Windows PowerShell the same mount is `-v "${PWD}:/repo"`. The entry point is `ghagent`, so
 the first argument after the image name is the command. No registry image is published as part
-of 1.2.0 and CI does not build the container: the tag is a local convention. See
+of 1.3.0 and CI does not build the container: the tag is a local convention. See
 [examples/docker.md](examples/docker.md).
 
 ### GitHub Action
@@ -155,7 +185,7 @@ release and works as soon as the tag exists:
 
 ```yaml
 - uses: actions/checkout@v7
-- uses: paulmann/github-agent@v1.2.2    # pin the release tag
+- uses: paulmann/github-agent@v1.3.0    # pin the release tag
   with:
     command: audit .
     min-score: "80"
@@ -182,7 +212,7 @@ The repository is also a pre-commit hook source; the hooks are `ghagent-doc`,
 ```yaml
 repos:
   - repo: https://github.com/paulmann/github-agent
-    rev: v1.2.2     # placeholder: pin the release tag you decide to trust
+    rev: v1.3.0     # placeholder: pin the release tag you decide to trust
     hooks:
       - id: ghagent-doc
       - id: ghagent-audit
@@ -200,7 +230,7 @@ tag, because pre-commit builds the tool from the tagged tree.
 After any install, one command answers whether the CLI is the released build:
 
 ```bash
-ghagent --version     # prints the version, for example github-agent 1.2.2
+ghagent --version     # prints the version, for example github-agent 1.3.0
 ghagent audit .       # 0 clean, 1 findings at error level, 2 usage or environment problem
 ```
 
@@ -210,7 +240,7 @@ there exits `2` with a message that points at the clone rather than reporting a
 ```bash
 git clone https://github.com/paulmann/github-agent.git
 cd github-agent
-python tools/ghagent.py selftest    # 173/173 checks passed
+python tools/ghagent.py selftest    # 194/194 checks passed
 ```
 
 ## Usage
@@ -224,7 +254,7 @@ ghagent assets check               # format, dimensions, alt text, referenced fi
 ghagent wiki build                 # rewrite links for the wiki namespace
 ghagent wiki verify                # every internal link resolves
 ghagent changelog check            # Keep a Changelog and SemVer
-ghagent changelog release 1.2.0 --write
+ghagent changelog release 1.3.0 --write
 ghagent meta suggest               # description and topics
 ```
 
@@ -256,7 +286,7 @@ score: 72.5% (22 scored, 1 skipped)
 | Find secrets and machine paths | `ghagent privacy --root .` |
 | Render the banner and social preview | `ghagent assets render --write` |
 | Build, verify and publish the wiki | `ghagent wiki build`, `verify`, `publish --push` |
-| Release a version | `ghagent changelog release 1.2.0 --write` |
+| Release a version | `ghagent changelog release 1.3.0 --write` |
 | Fix description and topics | `ghagent meta apply --repo owner/name --write` |
 | Install the skill into another agent | `ghagent install --profile harness --write` |
 
@@ -265,19 +295,34 @@ The CLI has 13 commands; the table names the ones used every day. The rest (`rep
 `changelog notes`, `meta suggest`, `wiki init`, `wiki publish`) carry their flags in
 `ghagent --help`; the recurring jobs are mapped in [`AGENTS.md`](AGENTS.md).
 
+## How it compares
+
+The pack does not replace the tools below and does not compete with them on their ground: it
+orchestrates the documentation surface of a repository and calls the same ideas from one place,
+with one exit code.
+
+| Tool | Strong at | Where this pack differs |
+|---|---|---|
+| `markdownlint` | markdown style, one rule id per finding | `ghagent doc` adds links, anchors, TOC, tables, privacy and the CHANGELOG contract; it also checks documents that are not markdown |
+| `vale` / `textlint` | prose style with a dictionary you maintain | the pack checks structure a machine can prove and does not judge wording; only the README summary is checked for superlatives |
+| `action-gh-release` | creating a release from a tag | `changelog notes <version>` produces the body from the CHANGELOG, and `changelog check` refuses a release without a dated section |
+| `pre-commit` hooks | running linters before a commit | the pack ships hooks for its own commands; the hooks are the delivery, not the check |
+| `release-please` | version bumps from conventional commits | the CHANGELOG stays hand-written and machine-verified; `changelog suggest` drafts entries but a human writes them |
+| GitHub community health files | a checklist in the UI | `audit` scores the same files from the tree and from the remote, so a missing `SECURITY.md` is a number, not a badge nobody opens |
+
 ## In numbers
 
-Measured in this tree on 2026-10-30 against version 1.2.2:
+Measured in this tree on 2026-11-01 against version 1.3.0:
 
 | Surface | Value | Measurement source |
 |---|---:|---|
-| Self-tests | 173 | `python tests/run_tests.py` |
+| Self-tests | 194 | `python tests/run_tests.py` |
 | CLI commands | 13 | `ghagent --help` |
 | Library modules | 11 | `tools/ghalib/*.py` |
 | Document rules examined on this tree | 17 | `ghagent doc --json`, field `rules_examined` |
 | Runtime dependencies | 0 | `pyproject.toml`, `dependencies = []` |
 | Platform traps recorded | 15 | the traps table in [docs/RULES.md](docs/RULES.md) |
-| Python lines | 4176 | `wc -l tools/ghagent.py tools/ghalib/*.py` |
+| Python lines | 4412 | `wc -l tools/ghagent.py tools/ghalib/*.py` |
 
 ## Checks that run
 
@@ -387,7 +432,7 @@ flowchart LR
 | `tools/ghalib/install.py` | skill installation, sha256 manifest, drift, removal |
 | `tools/ghalib/report.py` | findings, severities, markdown and `--json` output |
 | `tools/ghalib/config.py`, `tools/ghalib/util.py` | `.ghagent.json`, paths, text I/O, anchors |
-| `tests/run_tests.py` | 173 self-tests with fixtures and decoys |
+| `tests/run_tests.py` | 194 self-tests with fixtures and decoys |
 
 Anchors follow GitHub's rules: lowercase, punctuation dropped, spaces to hyphens, a repeated
 heading gets `-1`. The rule was verified against a live table of contents: an em dash in a

github_agent_cli-1.3.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+ghagent.py,sha256=Fa_Ammn3M4yL03EIjdkSPnZ9UAyOTacnBIJoNnm2A-M,25278
+ghalib/__init__.py,sha256=ur7kSxCjbmuv0oq97bo9bwE0a8QEDiDeVxxf7wACOAc,161
+ghalib/assets.py,sha256=RtP0hzZ1f6C8-B5hhkY1QSpb_5y_kA4EMNCzE6d1NnM,23279
+ghalib/audit.py,sha256=89_HSzHTHEUN_rSpv0xBXGUa3eHLWrUJLS1LcyxBJpU,29813
+ghalib/changelog.py,sha256=LXXPX-zDusqm-ZgZCP6ic5wopUsACp7jkj-fainGm8Y,22931
+ghalib/config.py,sha256=WLkY5IM-jfIrSMB2x4Rj4fJKgLEQ9eNmlt8EZMuHkio,1968
+ghalib/install.py,sha256=RWku4z3pzCe76vWlERAzzJIkF-tT-ieZ_EQvIsIg3RI,7410
+ghalib/mdcheck.py,sha256=grUeKev4r-fCDa4mWdkIwYQtpuuFn8UEu22_6QUerLg,24094
+ghalib/meta.py,sha256=uJBEVMz-BqRt8SjgtlWCm1_bRlbNaWXENMb96pVtgCU,12471
+ghalib/report.py,sha256=He-CkxUu0e9JpfPtQtIJcaveaSQ7Mo9G6HmNP2ETvaw,4093
+ghalib/util.py,sha256=-a7UoN7lUVJnti6yCRgxERbbezO8g7sZtdBzWQ9ikiM,19362
+ghalib/wiki.py,sha256=2oN9Iz91gglCGGKb9Zgvq6SOfG7ZmmIw2EmJ47Is5b8,24242
+github_agent_cli-1.3.0.dist-info/METADATA,sha256=75umbhzCD-NS3vEjvKS03zLWJP9pUB-LfKz3ZZucXAA,23600
+github_agent_cli-1.3.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+github_agent_cli-1.3.0.dist-info/entry_points.txt,sha256=ygzVll1rjzq2XexecCuJxEEfijExjJkWFtszftav9ys,41
+github_agent_cli-1.3.0.dist-info/licenses/LICENSE,sha256=tI9-MOZ-IBbjmioMIxKVwx3x727NsJflGKEJV8seQUY,1082
+github_agent_cli-1.3.0.dist-info/RECORD,,

github_agent_cli-1.2.2.dist-info/RECORD

@@ -1,17 +0,0 @@
-ghagent.py,sha256=W_ywmCY89ZUIHA4-siPYswtXh6kX8QCbsJ73f__ODlI,23238
-ghalib/__init__.py,sha256=ur7kSxCjbmuv0oq97bo9bwE0a8QEDiDeVxxf7wACOAc,161
-ghalib/assets.py,sha256=Wak4liTekNdDYHewKZMgZL1FOW11OhmEzoTHc9vPLRQ,21302
-ghalib/audit.py,sha256=gaHcuP_FE_IDK6rAXDHQquoqcoKg1Btaz37U3uQpLDY,29290
-ghalib/changelog.py,sha256=mMAQHZGUA59AXWWRA2qTHeqNfvOBz3oADYvpVX1PiPk,20357
-ghalib/config.py,sha256=r_VoPi1vp8J5OZrd3Jf9Gmi5iCILwukZEx7Hr_Q02sA,1457
-ghalib/install.py,sha256=RWku4z3pzCe76vWlERAzzJIkF-tT-ieZ_EQvIsIg3RI,7410
-ghalib/mdcheck.py,sha256=k1raRBLMWUIZsT5jzy3abnk_EJ_FyheeCjurHKbYoME,20715
-ghalib/meta.py,sha256=mIt6NZVxo6dZhaEHjCqunVZJ3QqA4S2voxiX17cgbGo,12481
-ghalib/report.py,sha256=eljoa6UUnpwcCJ3zTSJSpKdMHiml2hSu4yMWZhQ-uEw,4098
-ghalib/util.py,sha256=hEOUmSJggNKq4-Sy0NeAXhLTbksoT4wuIzfjkzSMQcA,18246
-ghalib/wiki.py,sha256=s0BxCxxU9v6WccjmIJdtPz5HM6uUG3slerDPS68LYJ0,22139
-github_agent_cli-1.2.2.dist-info/METADATA,sha256=6Oz8ZJcK7XS1GtQnPSqzsiz69D44SXBWTTEsbRLB2k8,20260
-github_agent_cli-1.2.2.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-github_agent_cli-1.2.2.dist-info/entry_points.txt,sha256=ygzVll1rjzq2XexecCuJxEEfijExjJkWFtszftav9ys,41
-github_agent_cli-1.2.2.dist-info/licenses/LICENSE,sha256=tI9-MOZ-IBbjmioMIxKVwx3x727NsJflGKEJV8seQUY,1082
-github_agent_cli-1.2.2.dist-info/RECORD,,