agent-wiki-cli 0.6.1__tar.gz → 0.6.2__tar.gz

{agent_wiki_cli-0.6.1/src/agent_wiki_cli.egg-info → agent_wiki_cli-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 0.6.1
+Version: 0.6.2
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License: MIT

{agent_wiki_cli-0.6.1 → agent_wiki_cli-0.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-wiki-cli"
-version = "0.6.1"
+version = "0.6.2"
 description = "CLI tool to maintain hybrid LLM Wikis for multi-language projects."
 readme = "README.md"
 license = {text = "MIT"}

{agent_wiki_cli-0.6.1 → agent_wiki_cli-0.6.2/src/agent_wiki_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 0.6.1
+Version: 0.6.2
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License: MIT

{agent_wiki_cli-0.6.1 → agent_wiki_cli-0.6.2}/src/llm_wiki_cli/commands/sync_cmd.py

@@ -1430,6 +1430,7 @@ def _apply_sync_changes(
         options.src_dir,
         entity_page_cache=page_maps.entity_page_cache,
         module_page_map=page_maps.module_page_map,
+        preserve_semantic=options.preserve_semantic,
     )
 
     _append_log(options.wiki_dir, options.src_dir, diff, result)
@@ -1502,6 +1503,105 @@ def run(args) -> None:
 # ── Index + log helpers ───────────────────────────────────────────────────────
 
 
+_INDEX_GENERATED_HEADINGS = frozenset(
+    heading.casefold()
+    for heading in (
+        "Entities",
+        "Modules",
+        "Workflows",
+        "Infrastructure",
+    )
+)
+_INDEX_GENERATED_INTROS = {
+    ("Catalog of project modules and entities.",),
+}
+
+
+def _heading_title(line: str) -> str | None:
+    match = _HEADING_RE.match(line.strip())
+    if not match:
+        return None
+    return match.group(2).strip()
+
+
+def _iter_level_two_sections(lines: list[str]) -> list[tuple[str, list[str]]]:
+    sections: list[tuple[str, list[str]]] = []
+    for i, line in enumerate(lines):
+        match = _HEADING_RE.match(line.strip())
+        if not match or len(match.group(1)) != 2:
+            continue
+        end = len(lines)
+        for j in range(i + 1, len(lines)):
+            next_match = _HEADING_RE.match(lines[j].strip())
+            if next_match and len(next_match.group(1)) <= 2:
+                end = j
+                break
+        sections.append((line.strip(), _trim_blank_lines(lines[i + 1 : end])))
+    return sections
+
+
+def _index_intro_lines(lines: list[str]) -> list[str]:
+    start = 0
+    if lines and lines[0].startswith("# "):
+        start = 1
+    first_section = len(lines)
+    for i, line in enumerate(lines[start:], start=start):
+        match = _HEADING_RE.match(line.strip())
+        if match and len(match.group(1)) == 2:
+            first_section = i
+            break
+    return _trim_blank_lines(lines[start:first_section])
+
+
+def _merge_intro_into_notes(
+    sections: list[tuple[str, list[str]]], intro: list[str]
+) -> list[tuple[str, list[str]]]:
+    if not intro:
+        return sections
+    merged: list[tuple[str, list[str]]] = []
+    inserted = False
+    for heading, body in sections:
+        title = _heading_title(heading)
+        if title and title.casefold() == "notes" and not inserted:
+            new_body = intro + ([""] if body else []) + body
+            merged.append((heading, new_body))
+            inserted = True
+        else:
+            merged.append((heading, body))
+    if not inserted:
+        merged.insert(0, ("## Notes", intro))
+    return merged
+
+
+def _preserved_index_sections(old_md: str) -> list[tuple[str, list[str]]]:
+    lines = _normalize_md(old_md).splitlines()
+    custom_sections = [
+        (heading, body)
+        for heading, body in _iter_level_two_sections(lines)
+        if (_heading_title(heading) or "").casefold() not in _INDEX_GENERATED_HEADINGS
+    ]
+    intro = _index_intro_lines(lines)
+    if tuple(intro) in _INDEX_GENERATED_INTROS:
+        intro = []
+    return _merge_intro_into_notes(custom_sections, intro)
+
+
+def _preserve_index_custom_sections(old_md: str, new_md: str) -> str:
+    preserved = _preserved_index_sections(old_md)
+    if not preserved:
+        return new_md
+    lines = _normalize_md(new_md).splitlines()
+    while lines and lines[-1].strip() == "":
+        lines.pop()
+    lines.append("")
+    for heading, body in preserved:
+        lines.append(heading)
+        lines.append("")
+        lines.extend(body)
+        lines.append("")
+    return "\n".join(lines)
+
+
 def _rebuild_index(
     wiki_dir: Path,
     inventory: dict,
@@ -1509,6 +1609,7 @@ def _rebuild_index(
     *,
     entity_page_cache: dict[tuple[str, str], str] | None = None,
     module_page_map: dict[str, str] | None = None,
+    preserve_semantic: bool = True,
 ) -> None:
     """Regenerate index.md from the live inventory."""
     if entity_page_cache is None:
@@ -1539,14 +1640,17 @@ def _rebuild_index(
     infra_entries = _list_existing_pages(wiki_dir / "infrastructure", "type")
 
     index_path = wiki_dir / "index.md"
+    new_index = _generate_index_md(
+        all_entity_names,
+        module_entries,
+        workflow_entries or None,
+        infra_entries or None,
+    )
+    if preserve_semantic and index_path.exists():
+        new_index = _preserve_index_custom_sections(read_md(index_path), new_index)
     write_state = _write_md_if_changed(
         index_path,
-        _generate_index_md(
-            all_entity_names,
-            module_entries,
-            workflow_entries or None,
-            infra_entries or None,
-        ),
+        new_index,
     )
     if write_state == "unchanged":
         print("  SKIP index.md (unchanged)")

{agent_wiki_cli-0.6.1 → agent_wiki_cli-0.6.2}/tests/test_sync.py

@@ -1240,6 +1240,83 @@ class TestSemanticPreservation:
         assert "Human-curated display name." not in entity_content
 
 
+class TestSyncIndexCustomSections:
+    def _inventory(self):
+        return {
+            "api.py": {
+                "language": "python",
+                "classes": [],
+                "functions": [{"name": "run", "line": 1}],
+            }
+        }
+
+    def test_rebuild_index_preserves_custom_section_links_for_strict_lint(
+        self, tmp_path
+    ):
+        wiki = tmp_path / "wiki"
+        config_docs = wiki / "config_docs"
+        config_docs.mkdir(parents=True)
+        (config_docs / "recording_rules_yml.md").write_text(
+            "# Recording rules\n", encoding="utf-8"
+        )
+        (config_docs / "grafana_dashboards.md").write_text(
+            "# Grafana dashboards\n", encoding="utf-8"
+        )
+        (wiki / "index.md").write_text(
+            textwrap.dedent("""\
+                # Old Index
+
+                ## Configuration Docs
+
+                - [Recording rules](config_docs/recording_rules_yml.md)
+                - [Grafana dashboards](config_docs/grafana_dashboards.md)
+            """),
+            encoding="utf-8",
+        )
+
+        sync_cmd._rebuild_index(
+            wiki, self._inventory(), str(tmp_path), preserve_semantic=True
+        )
+
+        index = (wiki / "index.md").read_text(encoding="utf-8")
+        assert "## Configuration Docs" in index
+        assert "config_docs/recording_rules_yml.md" in index
+        assert "config_docs/grafana_dashboards.md" in index
+
+        page_index = lint_cmd._build_page_index(wiki)
+        report = lint_cmd.LintReport(wiki_dir=str(wiki), src_dir=str(tmp_path))
+        lint_cmd._check_orphan_pages(report, wiki, page_index)
+        assert report.count("orphan_pages") == 0
+
+    def test_rebuild_index_no_preserve_semantic_drops_custom_section_links(
+        self, tmp_path
+    ):
+        wiki = tmp_path / "wiki"
+        config_docs = wiki / "config_docs"
+        config_docs.mkdir(parents=True)
+        (config_docs / "recording_rules_yml.md").write_text(
+            "# Recording rules\n", encoding="utf-8"
+        )
+        (wiki / "index.md").write_text(
+            textwrap.dedent("""\
+                # Old Index
+
+                ## Configuration Docs
+
+                - [Recording rules](config_docs/recording_rules_yml.md)
+            """),
+            encoding="utf-8",
+        )
+
+        sync_cmd._rebuild_index(
+            wiki, self._inventory(), str(tmp_path), preserve_semantic=False
+        )
+
+        index = (wiki / "index.md").read_text(encoding="utf-8")
+        assert "## Configuration Docs" not in index
+        assert "config_docs/recording_rules_yml.md" not in index
+
+
 class TestNewFile:
     """When a new source file is added, new pages are created and manifest updated."""