iatoolkit 2.26.4__tar.gz → 2.26.6__tar.gz

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

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

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

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

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

@@ -629,9 +629,18 @@ ui:
     create_wiki: "Create wiki"
     select_wiki: "Select a wiki"
     workspace_placeholder: "Choose a wiki from the list or create a new one."
+    open_wiki: "Open wiki"
+    back_to_wikis: "Back to wikis"
     configure: "Configuration"
+    configure_action: "Configure"
+    general: "General"
     key: "Key"
     name: "Name"
+    authoring_mode: "Authoring mode"
+    mode_managed: "Managed"
+    mode_external_sync: "External"
+    mode_managed_help: "The wiki is edited from this workspace and pages are saved into storage."
+    mode_external_sync_help: "The wiki stays read-only in IAToolkit and updates from the configured storage root."
     root: "Storage root"
     edit_root: "Edit storage root"
     lock_root: "Lock storage root editing"
@@ -643,26 +652,79 @@ ui:
     pages: "Pages"
     index: "Index"
     mcp: "MCP"
+    content: "Content"
+    tree: "Tree"
+    list: "List"
+    home: "Home"
+    home_short: "Home"
+    home_summary: "Root page exposed to MCP."
+    page: "Page"
+    edit_page: "Edit"
+    back: "Back"
+    link_page: "Link"
+    new_page: "Page"
+    history: "History"
+    page_history: "Page history"
+    no_revisions: "No revisions yet."
+    history_error: "Could not load history."
+    move_page: "Move"
+    create_page: "Create page"
+    delete_page: "Delete page"
+    delete_page_confirmation: "Delete page"
+    delete_page_message: "This removes the page from the managed wiki and deletes its markdown file."
+    page_path: "File path"
+    current_path: "Current path"
+    new_path: "New path"
+    page_title: "Title"
+    source: "Source"
+    pages_summary: "{count} pages available."
+    pages_available_short: "{count} available"
+    page_editing: "Editing {path}"
+    page_local_draft: "Local changes"
+    page_create_ok: "Page created."
+    page_create_error: "Could not create page."
+    page_save_ok: "Page saved."
+    page_save_error: "Could not save page."
+    page_saving: "Saving..."
+    save_page: "Save"
+    page_delete_ok: "Page deleted."
+    page_delete_error: "Could not delete page."
+    page_deleting: "Deleting..."
+    page_move_ok: "Page moved."
+    page_move_error: "Could not move page."
+    page_path_required: "Page path is required."
+    revision_create: "Created"
+    revision_update: "Edited"
+    revision_delete: "Deleted"
+    revision_move: "Moved"
+    root_group: "Root"
+    delete_wiki: "Delete wiki"
     mcp_status: "MCP publication"
     mcp_status_published: "Published"
     mcp_status_unpublished: "Not published"
-    mcp_status_published_help: "This wiki index is already exposed as a resource in the tenant MCP catalog."
-    mcp_status_unpublished_help: "This wiki does not yet expose its index as an MCP resource."
+    mcp_status_published_help: "This wiki is already exposed as a resource in the tenant MCP catalog."
+    mcp_status_unpublished_help: "This wiki is not yet exposed as an MCP resource."
     mcp_wiki_key: "MCP wiki_key"
+    mcp_entrypoint: "MCP home"
     lint: "Validate"
     validate: "Validate"
     validation_results: "Validation results"
-    sync: "Sync"
+    sync: "Update"
     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."
+    workspace_hint_title: "Workspace"
+    workspace_hint_copy: "Open this wiki to browse its pages and switch into editing without the wiki list."
+    overview_structure: "Structure"
+    overview_structure_empty: "No indexed pages yet."
+    overview_structure_more: "{count} more folders"
+    mcp_publish_help: "This action publishes this wiki as an MCP resource."
     mcp_tools_help: "The tools iat_wiki_search and iat_wiki_get_page are enabled separately from the MCP manager."
     mcp_step_publish_title: "1. Publish resource"
-    mcp_step_publish_text: "The Publish to MCP button adds or updates `iat://knowledge-wikis/{wiki_key}/index` in the tenant MCP resources."
+    mcp_step_publish_text: "The Publish to MCP button adds or updates `iat://knowledge-wikis/{wiki_key}` in the tenant MCP resources."
     mcp_step_tools_title: "2. Enable tools"
     mcp_step_tools_text: "If you want tool-based search or page reads, enable `iat_wiki_search` and `iat_wiki_get_page` from the MCP manager."
     mcp_step_usage_title: "3. Use wiki_key and path"
@@ -685,11 +747,11 @@ ui:
     delete_message: "This removes the wiki configuration, generated index, and indexed pages. Source markdown files in storage are not deleted."
     delete_ok: "Wiki deleted."
     delete_error: "Could not delete wiki."
-    sync_ok: "Sync completed."
-    sync_partial_ok: "Sync completed with errors."
-    sync_error: "Could not sync wiki."
-    sync_running: "Syncing..."
-    sync_results: "Sync result"
+    sync_ok: "Update completed."
+    sync_partial_ok: "Update completed with errors."
+    sync_error: "Could not update the wiki from storage."
+    sync_running: "Updating..."
+    sync_results: "Update result"
     sync_status_idle: "Not run"
     sync_status_success: "Completed"
     sync_status_partial: "Completed with errors"
@@ -699,9 +761,9 @@ ui:
     sync_failed: "Failed"
     sync_finished_at: "Finished"
     sync_first_error: "First error"
-    sync_summary_success: "Reviewed {seen} markdown files and indexed {indexed} pages."
-    sync_summary_partial: "Reviewed {seen} markdown files, indexed {indexed} pages, and found {failed} failures."
-    sync_summary_error: "Sync failed after reviewing {seen} markdown files. {failed} files could not be indexed."
+    sync_summary_success: "Reviewed {seen} markdown files and updated {indexed} pages."
+    sync_summary_partial: "Reviewed {seen} markdown files, updated {indexed} pages, and found {failed} failures."
+    sync_summary_error: "The update failed after reviewing {seen} markdown files. {failed} files could not be indexed."
     sync_summary_empty: "No markdown files were found under this storage root."
     lint_ok: "Validation completed."
     lint_error: "Could not validate wiki."

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

@@ -629,9 +629,18 @@ ui:
     create_wiki: "Crear wiki"
     select_wiki: "Selecciona una wiki"
     workspace_placeholder: "Elige una wiki del listado o crea una nueva."
+    open_wiki: "Abrir wiki"
+    back_to_wikis: "Volver a wikis"
     configure: "Configuración"
+    configure_action: "Configurar"
+    general: "General"
     key: "Clave"
     name: "Nombre"
+    authoring_mode: "Modo de gestión"
+    mode_managed: "Gestionada"
+    mode_external_sync: "Externa"
+    mode_managed_help: "La wiki se edita desde esta interfaz y guarda sus páginas en storage."
+    mode_external_sync_help: "La wiki queda de solo lectura en IAToolkit y se actualiza desde la raíz storage configurada."
     root: "Raíz storage"
     edit_root: "Editar raíz storage"
     lock_root: "Bloquear edición de raíz storage"
@@ -643,26 +652,79 @@ ui:
     pages: "Páginas"
     index: "Índice"
     mcp: "MCP"
+    content: "Contenido"
+    tree: "Árbol"
+    list: "Lista"
+    home: "Portada"
+    home_short: "Inicio"
+    home_summary: "Página raíz expuesta al MCP."
+    page: "Página"
+    edit_page: "Editar"
+    back: "Volver"
+    link_page: "Vincular"
+    new_page: "Página"
+    history: "Historial"
+    page_history: "Historial de página"
+    no_revisions: "Aún no hay revisiones."
+    history_error: "No se pudo cargar el historial."
+    move_page: "Mover"
+    create_page: "Crear página"
+    delete_page: "Borrar página"
+    delete_page_confirmation: "Eliminar página"
+    delete_page_message: "Se borrará esta página del wiki gestionado y su archivo markdown asociado."
+    page_path: "Ruta de archivo"
+    current_path: "Ruta actual"
+    new_path: "Nueva ruta"
+    page_title: "Título"
+    source: "Origen"
+    pages_summary: "{count} páginas disponibles."
+    pages_available_short: "{count} disponibles"
+    page_editing: "Editando {path}"
+    page_local_draft: "Cambios locales"
+    page_create_ok: "Página creada."
+    page_create_error: "No se pudo crear la página."
+    page_save_ok: "Página guardada."
+    page_save_error: "No se pudo guardar la página."
+    page_saving: "Guardando..."
+    save_page: "Guardar"
+    page_delete_ok: "Página eliminada."
+    page_delete_error: "No se pudo eliminar la página."
+    page_deleting: "Eliminando..."
+    page_move_ok: "Página movida."
+    page_move_error: "No se pudo mover la página."
+    page_path_required: "Debes ingresar la ruta del archivo."
+    revision_create: "Creada"
+    revision_update: "Editada"
+    revision_delete: "Eliminada"
+    revision_move: "Movida"
+    root_group: "Raíz"
+    delete_wiki: "Borrar wiki"
     mcp_status: "Publicación MCP"
     mcp_status_published: "Publicado"
     mcp_status_unpublished: "No publicado"
-    mcp_status_published_help: "El índice de esta wiki ya está expuesto como resource en el catálogo MCP del tenant."
-    mcp_status_unpublished_help: "Esta wiki todavía no expone su índice como resource MCP."
+    mcp_status_published_help: "Esta wiki ya está expuesta como resource en el catálogo MCP del tenant."
+    mcp_status_unpublished_help: "Esta wiki todavía no está expuesta como resource MCP."
     mcp_wiki_key: "wiki_key MCP"
+    mcp_entrypoint: "Portada MCP"
     lint: "Validar"
     validate: "Validar"
     validation_results: "Resultados de validación"
-    sync: "Sincronizar"
+    sync: "Actualizar"
     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."
+    workspace_hint_title: "Workspace"
+    workspace_hint_copy: "Abre esta wiki para explorar sus páginas y pasar a modo edición sin la lista de wikis."
+    overview_structure: "Estructura"
+    overview_structure_empty: "Aún no hay páginas indexadas."
+    overview_structure_more: "{count} carpetas más"
+    mcp_publish_help: "Esta acción publica esta wiki como resource MCP."
     mcp_tools_help: "Las tools iat_wiki_search e iat_wiki_get_page se habilitan por separado desde el gestor MCP."
     mcp_step_publish_title: "1. Publicar resource"
-    mcp_step_publish_text: "El botón Publicar en MCP agrega o actualiza `iat://knowledge-wikis/{wiki_key}/index` dentro de los resources MCP del tenant."
+    mcp_step_publish_text: "El botón Publicar en MCP agrega o actualiza `iat://knowledge-wikis/{wiki_key}` dentro de los resources MCP del tenant."
     mcp_step_tools_title: "2. Habilitar tools"
     mcp_step_tools_text: "Si quieres búsqueda o lectura por tool, habilita `iat_wiki_search` e `iat_wiki_get_page` desde el gestor MCP."
     mcp_step_usage_title: "3. Usar wiki_key y path"
@@ -685,11 +747,11 @@ ui:
     delete_message: "Se borrará la configuración de la wiki, el índice generado y las páginas indexadas. Los archivos markdown fuente del storage no se borran."
     delete_ok: "Wiki eliminada."
     delete_error: "No se pudo eliminar la wiki."
-    sync_ok: "Sincronización completada."
-    sync_partial_ok: "Sincronización completada con errores."
-    sync_error: "No se pudo sincronizar la wiki."
-    sync_running: "Sincronizando..."
-    sync_results: "Resultado de sincronización"
+    sync_ok: "Actualización completada."
+    sync_partial_ok: "Actualización completada con errores."
+    sync_error: "No se pudo actualizar la wiki desde storage."
+    sync_running: "Actualizando..."
+    sync_results: "Resultado de actualización"
     sync_status_idle: "Sin ejecutar"
     sync_status_success: "Completada"
     sync_status_partial: "Con errores"
@@ -699,9 +761,9 @@ ui:
     sync_failed: "Fallidas"
     sync_finished_at: "Finalizó"
     sync_first_error: "Primer error"
-    sync_summary_success: "Se revisaron {seen} archivos markdown y se indexaron {indexed} páginas."
-    sync_summary_partial: "Se revisaron {seen} archivos markdown, se indexaron {indexed} páginas y {failed} fallaron."
-    sync_summary_error: "La sincronización falló después de revisar {seen} archivos markdown. {failed} archivos no pudieron indexarse."
+    sync_summary_success: "Se revisaron {seen} archivos markdown y se actualizaron {indexed} páginas."
+    sync_summary_partial: "Se revisaron {seen} archivos markdown, se actualizaron {indexed} páginas y {failed} fallaron."
+    sync_summary_error: "La actualización falló después de revisar {seen} archivos markdown. {failed} archivos no pudieron indexarse."
     sync_summary_empty: "No se encontraron archivos markdown bajo esta raíz de storage."
     lint_ok: "Validación completada."
     lint_error: "No se pudo validar la wiki."

{iatoolkit-2.26.4 → iatoolkit-2.26.6}/src/iatoolkit/repositories/knowledge_wiki_repo.py

@@ -8,11 +8,13 @@ from __future__ import annotations
 from datetime import datetime
 
 from injector import inject
+from sqlalchemy import or_
 
 from iatoolkit.repositories.database_manager import DatabaseManager
 from iatoolkit.repositories.models import (
     KnowledgeWiki,
     KnowledgeWikiPage,
+    KnowledgeWikiPageRevision,
     KnowledgeWikiPageStatus,
     KnowledgeWikiStatus,
     KnowledgeWikiSyncRun,
@@ -187,6 +189,82 @@ class KnowledgeWikiRepo:
         self.session.commit()
         return page
 
+    def save_page(self, page: KnowledgeWikiPage) -> KnowledgeWikiPage:
+        self.session.add(page)
+        self.session.commit()
+        return page
+
+    def delete_page(self, wiki_id: int, path: str) -> KnowledgeWikiPage | None:
+        page = self.get_page_by_path(wiki_id, path)
+        if page is None:
+            return None
+        self.session.delete(page)
+        self.session.commit()
+        return page
+
+    def create_page_revision(
+        self,
+        *,
+        company_id: int,
+        wiki_id: int,
+        page_id: int | None,
+        action: str,
+        path: str,
+        previous_path: str | None = None,
+        title: str | None = None,
+        markdown: str | None = None,
+        checksum: str | None = None,
+        edited_by: str | None = None,
+        change_summary: str | None = None,
+        metadata_json: dict | None = None,
+    ) -> KnowledgeWikiPageRevision:
+        revision = KnowledgeWikiPageRevision(
+            company_id=company_id,
+            wiki_id=wiki_id,
+            page_id=page_id,
+            action=action,
+            path=path,
+            previous_path=previous_path,
+            title=title,
+            markdown=markdown,
+            checksum=checksum,
+            edited_by=edited_by,
+            change_summary=change_summary,
+            metadata_json=metadata_json or {},
+        )
+        self.session.add(revision)
+        self.session.commit()
+        return revision
+
+    def list_page_revisions(
+        self,
+        wiki_id: int,
+        *,
+        path: str | None = None,
+        page_id: int | None = None,
+        limit: int = 50,
+    ) -> list[KnowledgeWikiPageRevision]:
+        if not wiki_id:
+            return []
+        query = self.session.query(KnowledgeWikiPageRevision).filter_by(wiki_id=wiki_id)
+        filters = []
+        if page_id:
+            filters.append(KnowledgeWikiPageRevision.page_id == page_id)
+        if path:
+            filters.extend([
+                KnowledgeWikiPageRevision.path == path,
+                KnowledgeWikiPageRevision.previous_path == path,
+            ])
+        if filters:
+            query = query.filter(or_(*filters))
+        bounded_limit = min(max(int(limit or 50), 1), 200)
+        return (
+            query
+            .order_by(KnowledgeWikiPageRevision.created_at.desc(), KnowledgeWikiPageRevision.id.desc())
+            .limit(bounded_limit)
+            .all()
+        )
+
     def archive_pages_not_in_paths(self, wiki_id: int, paths: set[str]) -> int:
         if not wiki_id:
             return 0

{iatoolkit-2.26.4 → iatoolkit-2.26.6}/src/iatoolkit/repositories/models.py

@@ -209,6 +209,11 @@ class Company(Base):
         back_populates="company",
         cascade="all, delete-orphan",
     )
+    knowledge_wiki_page_revisions = relationship(
+        "KnowledgeWikiPageRevision",
+        back_populates="company",
+        cascade="all, delete-orphan",
+    )
 
 
     def to_dict(self):
@@ -579,6 +584,11 @@ class KnowledgeWiki(Base):
         back_populates="wiki",
         cascade="all, delete-orphan",
     )
+    page_revisions = relationship(
+        "KnowledgeWikiPageRevision",
+        back_populates="wiki",
+        cascade="all, delete-orphan",
+    )
 
     def to_dict(self):
         return {column.key: getattr(self, column.key) for column in class_mapper(self.__class__).columns}
@@ -617,6 +627,32 @@ class KnowledgeWikiPage(Base):
         return {column.key: getattr(self, column.key) for column in class_mapper(self.__class__).columns}
 
 
+class KnowledgeWikiPageRevision(Base):
+    """Immutable audit snapshot for a manual tenant wiki page change."""
+    __tablename__ = "iat_knowledge_wiki_page_revisions"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    company_id = Column(Integer, ForeignKey(f"{ORM_SCHEMA}.iat_companies.id", ondelete="CASCADE"), nullable=False)
+    wiki_id = Column(Integer, ForeignKey(f"{ORM_SCHEMA}.iat_knowledge_wikis.id", ondelete="CASCADE"), nullable=False)
+    page_id = Column(Integer, ForeignKey(f"{ORM_SCHEMA}.iat_knowledge_wiki_pages.id", ondelete="SET NULL"), nullable=True)
+    action = Column(String, nullable=False)
+    path = Column(String, nullable=False)
+    previous_path = Column(String, nullable=True)
+    title = Column(String, nullable=True)
+    markdown = Column(Text, nullable=True)
+    checksum = Column(String, nullable=True)
+    edited_by = Column(String, nullable=True)
+    change_summary = Column(Text, nullable=True)
+    metadata_json = Column(JSON_NATIVE, nullable=False, default=dict)
+    created_at = Column(DateTime, default=datetime.now, nullable=False)
+
+    company = relationship("Company", back_populates="knowledge_wiki_page_revisions")
+    wiki = relationship("KnowledgeWiki", back_populates="page_revisions")
+
+    def to_dict(self):
+        return {column.key: getattr(self, column.key) for column in class_mapper(self.__class__).columns}
+
+
 class KnowledgeWikiSyncRun(Base):
     """Tracks one import/reindex pass for a tenant knowledge wiki."""
     __tablename__ = "iat_knowledge_wiki_sync_runs"