iatoolkit 2.26.2__tar.gz → 2.26.4__tar.gz

{iatoolkit-2.26.2/src/iatoolkit.egg-info → iatoolkit-2.26.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.26.2
+Version: 2.26.4
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT

{iatoolkit-2.26.2 → iatoolkit-2.26.4}/src/iatoolkit/__init__.py

@@ -3,7 +3,7 @@
 #
 # IAToolkit is open source software.
 
-__version__ = "2.26.2"
+__version__ = "2.26.4"
 
 # Expose main classes and functions at the top level of the package
 

{iatoolkit-2.26.2 → iatoolkit-2.26.4}/src/iatoolkit/locales/en.yaml

@@ -654,6 +654,10 @@ ui:
     validation_results: "Validation results"
     sync: "Sync"
     issues: "issues"
+    index_path: "Path"
+    index_source: "Source"
+    index_view_generated: "Generated"
+    index_view_mcp: "MCP"
     index_resource: "Resource URI"
     mcp_publish_help: "This action publishes only this wiki's markdown index resource into MCP."
     mcp_tools_help: "The tools iat_wiki_search and iat_wiki_get_page are enabled separately from the MCP manager."
@@ -664,8 +668,8 @@ ui:
     mcp_step_usage_title: "3. Use wiki_key and path"
     mcp_step_usage_text: "MCP clients can read this index first to discover pages, then use `wiki_key` and `path` with the tools."
     copy_uri: "Copy URI"
-    publish_mcp: "Publish to MCP"
-    republish_mcp: "Update publication"
+    publish_mcp: "Publish"
+    republish_mcp: "Update"
     open_mcp: "Open MCP manager"
     filter_pages: "Filter pages"
     loading: "Loading..."

{iatoolkit-2.26.2 → iatoolkit-2.26.4}/src/iatoolkit/locales/es.yaml

@@ -654,6 +654,10 @@ ui:
     validation_results: "Resultados de validación"
     sync: "Sincronizar"
     issues: "hallazgos"
+    index_path: "Ruta"
+    index_source: "Fuente"
+    index_view_generated: "Generado"
+    index_view_mcp: "MCP"
     index_resource: "URI del resource"
     mcp_publish_help: "Esta acción publica en MCP solo el resource del índice markdown de esta wiki."
     mcp_tools_help: "Las tools iat_wiki_search e iat_wiki_get_page se habilitan por separado desde el gestor MCP."
@@ -664,8 +668,8 @@ ui:
     mcp_step_usage_title: "3. Usar wiki_key y path"
     mcp_step_usage_text: "Los clientes MCP pueden leer primero este índice para descubrir páginas y luego usar `wiki_key` y `path` en las tools."
     copy_uri: "Copiar URI"
-    publish_mcp: "Publicar en MCP"
-    republish_mcp: "Actualizar publicación"
+    publish_mcp: "Publicar"
+    republish_mcp: "Actualizar"
     open_mcp: "Abrir gestor MCP"
     filter_pages: "Filtrar páginas"
     loading: "Cargando..."

{iatoolkit-2.26.2 → iatoolkit-2.26.4}/src/iatoolkit/services/tenant_wiki_service.py

@@ -225,17 +225,28 @@ class TenantWikiService:
         if not wiki:
             return {"status": "error", "error_message": "wiki not found"}
         pages = self.knowledge_wiki_repo.list_pages(wiki.id, include_archived=False, limit=1000)
-        entries = [self.serialize_page(page, include_body=False) for page in pages]
-        markdown, _source_storage_key = self._resolve_index_markdown(
+        page_entries = [self.serialize_page(page, include_body=False) for page in pages]
+        generated_markdown = self.markdown_wiki_service.render_generic_index(page_entries, title=wiki.name)
+        markdown, source_storage_key = self._resolve_index_markdown(
             company_short_name,
             wiki,
-            entries,
+            page_entries,
         )
+        index_entry = self._build_authored_index_entry(company_short_name, wiki)
+        entries = [index_entry, *page_entries] if index_entry else page_entries
         return {
             "status": "success",
             "wiki": self.serialize_wiki(wiki),
             "entries": entries,
             "markdown": markdown,
+            "generated_markdown": generated_markdown,
+            "generated_index_path": self.markdown_wiki_service.join_storage_path(self.GENERATED_FOLDER, self.INDEX_FILENAME),
+            "generated_index_source_path": self.markdown_wiki_service.join_storage_path(self.GENERATED_FOLDER, self.INDEX_FILENAME),
+            "mcp_markdown": markdown,
+            "mcp_index_path": "/",
+            "mcp_index_source_path": self._index_source_display_path(wiki, source_storage_key),
+            "index_path": "/",
+            "index_source_path": self._index_source_display_path(wiki, source_storage_key),
         }
 
     def get_page(
@@ -268,29 +279,36 @@ class TenantWikiService:
                 wiki,
                 entries,
             )
-            parsed = self.markdown_wiki_service.parse_frontmatter_document(markdown)
-            frontmatter = parsed.get("frontmatter") if isinstance(parsed.get("frontmatter"), dict) else {}
-            body = str(parsed.get("body") or "").strip()
             return {
                 "status": "success",
                 "wiki": self.serialize_wiki(wiki),
-                "page": {
-                    "id": None,
-                    "wiki_id": wiki.id,
-                    "path": "/",
-                    "slug": "index",
-                    "title": str(frontmatter.get("title") or wiki.name or wiki.wiki_key).strip(),
-                    "summary": str(frontmatter.get("summary") or wiki.description or "").strip(),
-                    "source_storage_key": source_storage_key,
-                    "status": str(frontmatter.get("status") or "active").strip() or "active",
-                    "tags": self._normalize_tags(frontmatter.get("tags")),
-                    "owner": str(frontmatter.get("owner") or "").strip() or None,
-                    "last_synced_at": wiki.last_synced_at.isoformat() if wiki.last_synced_at else None,
-                    "updated_at": wiki.updated_at.isoformat() if wiki.updated_at else None,
-                    "body_text": body,
-                    "frontmatter": frontmatter,
-                    "markdown": markdown,
-                },
+                "page": self._build_virtual_index_page(
+                    wiki,
+                    markdown=markdown,
+                    source_storage_key=source_storage_key,
+                    path="/",
+                ),
+            }
+        if normalized_path == self.INDEX_FILENAME:
+            authored_index_storage_key = self.markdown_wiki_service.join_storage_path(
+                wiki.root_storage_key,
+                self.INDEX_FILENAME,
+            )
+            authored_index_markdown = self.markdown_wiki_service.read_optional_markdown(
+                company_short_name,
+                authored_index_storage_key,
+            )
+            if not authored_index_markdown:
+                return {"status": "error", "error_message": "page not found"}
+            return {
+                "status": "success",
+                "wiki": self.serialize_wiki(wiki),
+                "page": self._build_virtual_index_page(
+                    wiki,
+                    markdown=authored_index_markdown,
+                    source_storage_key=authored_index_storage_key,
+                    path=self.INDEX_FILENAME,
+                ),
             }
         page = self.knowledge_wiki_repo.get_page_by_path(wiki.id, normalized_path)
         if page is None:
@@ -515,14 +533,7 @@ class TenantWikiService:
             authored_index_storage_key,
         )
         if authored_index_markdown:
-            return (
-                self.markdown_wiki_service.render_curated_index(
-                    authored_index_markdown,
-                    entries,
-                    title=wiki.name,
-                ),
-                authored_index_storage_key,
-            )
+            return authored_index_markdown, authored_index_storage_key
 
         generated_index_storage_key = self.markdown_wiki_service.join_storage_path(
             wiki.root_storage_key,
@@ -534,6 +545,60 @@ class TenantWikiService:
             generated_index_storage_key,
         )
 
+    def _build_authored_index_entry(self, company_short_name: str, wiki: KnowledgeWiki) -> dict | None:
+        authored_index_storage_key = self.markdown_wiki_service.join_storage_path(
+            wiki.root_storage_key,
+            self.INDEX_FILENAME,
+        )
+        authored_index_markdown = self.markdown_wiki_service.read_optional_markdown(
+            company_short_name,
+            authored_index_storage_key,
+        )
+        if not authored_index_markdown:
+            return None
+        page = self._build_virtual_index_page(
+            wiki,
+            markdown=authored_index_markdown,
+            source_storage_key=authored_index_storage_key,
+            path=self.INDEX_FILENAME,
+        )
+        return {
+            key: value
+            for key, value in page.items()
+            if key not in {"body_text", "frontmatter", "markdown"}
+        }
+
+    def _build_virtual_index_page(
+        self,
+        wiki: KnowledgeWiki,
+        *,
+        markdown: str,
+        source_storage_key: str,
+        path: str,
+    ) -> dict:
+        parsed = self.markdown_wiki_service.parse_frontmatter_document(markdown)
+        frontmatter = parsed.get("frontmatter") if isinstance(parsed.get("frontmatter"), dict) else {}
+        body = str(parsed.get("body") or "").strip()
+        summary_fallback = wiki.description or ""
+        return {
+            "id": None,
+            "wiki_id": wiki.id,
+            "path": path,
+            "slug": "index",
+            "title": str(frontmatter.get("title") or wiki.name or wiki.wiki_key).strip(),
+            "summary": str(frontmatter.get("summary") or summary_fallback or "").strip(),
+            "source_storage_key": source_storage_key,
+            "status": str(frontmatter.get("status") or "active").strip() or "active",
+            "tags": self._normalize_tags(frontmatter.get("tags")),
+            "owner": str(frontmatter.get("owner") or "").strip() or None,
+            "last_synced_at": wiki.last_synced_at.isoformat() if wiki.last_synced_at else None,
+            "updated_at": wiki.updated_at.isoformat() if wiki.updated_at else None,
+            "body_text": body,
+            "frontmatter": frontmatter,
+            "markdown": markdown,
+            "is_root_index": True,
+        }
+
     def _resolve_unique_slug(self, wiki_id: int, slug: str, path: str) -> str:
         candidate = self.markdown_wiki_service.slugify(slug)
         existing = self.knowledge_wiki_repo.get_page_by_slug(wiki_id, candidate)
@@ -546,6 +611,15 @@ class TenantWikiService:
         suffix = hashlib.sha1(path.encode("utf-8")).hexdigest()[:8]
         return f"{path_slug[:70]}-{suffix}"
 
+    def _index_source_display_path(self, wiki: KnowledgeWiki, source_storage_key: str) -> str:
+        authored_index_storage_key = self.markdown_wiki_service.join_storage_path(
+            wiki.root_storage_key,
+            self.INDEX_FILENAME,
+        )
+        if source_storage_key == authored_index_storage_key:
+            return self.INDEX_FILENAME
+        return self.markdown_wiki_service.join_storage_path(self.GENERATED_FOLDER, self.INDEX_FILENAME)
+
     def _lint_wiki_pages(self, wiki: KnowledgeWiki, pages: list[KnowledgeWikiPage]) -> list[dict]:
         issues = []
         title_map: dict[str, list[KnowledgeWikiPage]] = {}

{iatoolkit-2.26.2 → iatoolkit-2.26.4/src/iatoolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.26.2
+Version: 2.26.4
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT