elastro-client 1.3.44__tar.gz → 1.3.46__tar.gz

{elastro_client-1.3.44/elastro_client.egg-info → elastro_client-1.3.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elastro-client
-Version: 1.3.44
+Version: 1.3.46
 Summary: A comprehensive Python library for Elasticsearch management with both programmatic and CLI interfaces
 Author: Austin Jorgensen
 License-Expression: MIT

{elastro_client-1.3.44 → elastro_client-1.3.46}/elastro/__init__.py

@@ -4,7 +4,7 @@ Elasticsearch Management Module.
 A module for managing Elasticsearch operations within a pipeline process.
 """
 
-__version__ = "1.3.44"
+__version__ = "1.3.46"
 
 # Core component imports
 from elastro.core.client import ElasticsearchClient

{elastro_client-1.3.44 → elastro_client-1.3.46}/elastro/cli/cli.py

@@ -109,6 +109,8 @@ from elastro.cli.commands.ml import ml_group
 from elastro.cli.commands.script import script_group
 from elastro.cli.commands.painless_commands import painless_group
 from elastro.cli.commands.telemetry import telemetry_group
+from elastro.cli.commands.memory import memory_group
+from elastro.cli.commands.tools import tools_group
 
 # Register Top-Level Groups
 
@@ -287,6 +289,8 @@ cli.add_command(ml_group)
 cli.add_command(script_group)
 cli.add_command(painless_group)
 cli.add_command(telemetry_group)
+cli.add_command(memory_group)
+cli.add_command(tools_group)
 cli.add_command(gui)
 cli.add_command(rag_group)
 cli.add_command(daemon_group)

{elastro_client-1.3.44 → elastro_client-1.3.46}/elastro/cli/commands/__init__.py

@@ -41,6 +41,8 @@ from elastro.cli.commands.config import (
 from elastro.cli.commands.utils import health, templates, aliases
 from elastro.cli.commands.painless_commands import painless_group
 from elastro.cli.commands.telemetry import telemetry_group
+from elastro.cli.commands.memory import memory_group
+from elastro.cli.commands.tools import tools_group
 
 __all__ = [
     # Index commands
@@ -81,4 +83,8 @@ __all__ = [
     "painless_group",
     # Telemetry
     "telemetry_group",
+    # Agentic Memory
+    "memory_group",
+    # Tools Registry
+    "tools_group",
 ]

elastro_client-1.3.46/elastro/cli/commands/memory.py

@@ -0,0 +1,163 @@
+"""
+Memory command group for Elastro CLI.
+"""
+
+import rich_click as click
+from datetime import datetime, timezone
+
+from elastro.core.client import ElasticsearchClient
+
+
+@click.group(name="memory")
+def memory_group() -> None:
+    """Manage semantic memory for agents."""
+    pass
+
+
+@memory_group.command("ingest")
+@click.argument("note_type", type=click.Choice(["strategic", "tactical"]))
+@click.argument("subject")
+@click.argument("content")
+@click.option("--tags", default="", help="Comma-separated tags")
+@click.pass_obj
+def ingest_memory(
+    client: ElasticsearchClient,
+    note_type: str,
+    subject: str,
+    content: str,
+    tags: str,
+) -> None:
+    """
+    Ingest a semantic memory note for agent knowledge sharing.
+
+    NOTE_TYPE must be 'strategic' (telemetry/heuristics) or 'tactical' (handoffs).
+    """
+    index_name = "agent_semantic_memory"
+    timestamp = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    payload = {
+        "timestamp": timestamp,
+        "note_type": note_type,
+        "subject": subject,
+        "content": content,
+        "tags": [t.strip() for t in tags.split(",")] if tags else [],
+    }
+
+    try:
+        response = client.client.index(index=index_name, document=payload)
+        click.secho(
+            f">> Memory ingested successfully. ID: {response.get('_id', 'unknown')}",
+            fg="green",
+        )
+    except Exception as e:
+        click.secho(f"Failed to ingest memory payload: {e}", fg="red", err=True)
+        import sys
+
+        sys.exit(1)
+
+
+@memory_group.command("search")
+@click.argument("query")
+@click.option(
+    "--type",
+    "note_type",
+    type=click.Choice(["strategic", "tactical"]),
+    help="Filter by note type",
+)
+@click.option("--size", default=10, help="Number of results to return")
+@click.pass_obj
+def search_memory(
+    client: ElasticsearchClient,
+    query: str,
+    note_type: str,
+    size: int,
+) -> None:
+    """
+    Search semantic memory notes via vector/BM25 retrieval.
+    """
+    index_name = "agent_semantic_memory"
+
+    from typing import Dict, Any, List
+
+    bool_clause: Dict[str, List[Any]] = {
+        "must": [
+            {
+                "multi_match": {
+                    "query": query,
+                    "fields": ["subject^2", "content", "tags"],
+                }
+            }
+        ]
+    }
+
+    if note_type:
+        bool_clause["filter"] = [{"term": {"note_type": note_type}}]
+
+    search_body: Dict[str, Any] = {
+        "size": size,
+        "query": {"bool": bool_clause},
+    }
+
+    try:
+        response = client.client.search(index=index_name, body=search_body)
+        hits = response.get("hits", {}).get("hits", [])
+
+        click.secho(f"Found {len(hits)} memory notes:", fg="blue")
+        for hit in hits:
+            if not isinstance(hit, dict):
+                continue
+            source = hit.get("_source", {})
+            click.echo(
+                f"\n[{source.get('note_type', 'unknown').upper()}] {source.get('subject', 'Untitled')} ({hit.get('_id', '')})"
+            )
+            click.echo(f"  {source.get('content', '')}")
+            if source.get("tags"):
+                click.echo(f"  Tags: {', '.join(source['tags'])}")
+
+    except Exception as e:
+        click.secho(f"Search failed: {e}", fg="red", err=True)
+        import sys
+
+        sys.exit(1)
+
+
+@memory_group.command("prune")
+@click.option("--days", default=7, help="Number of days to retain tactical notes")
+@click.pass_obj
+def prune_memory(
+    client: ElasticsearchClient,
+    days: int,
+) -> None:
+    """
+    Prune 'tactical' memory notes older than the specified threshold.
+    """
+    index_name = "agent_semantic_memory"
+
+    from datetime import datetime, timezone, timedelta
+
+    cutoff = datetime.now(timezone.utc) - timedelta(days=days)
+    cutoff_str = cutoff.strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    delete_query = {
+        "query": {
+            "bool": {
+                "must": [
+                    {"term": {"note_type": "tactical"}},
+                    {"range": {"timestamp": {"lt": cutoff_str}}},
+                ]
+            }
+        }
+    }
+
+    try:
+        response = client.client.delete_by_query(index=index_name, body=delete_query)
+        deleted = response.get("deleted", 0)
+        click.secho(
+            f">> Pruned {deleted} tactical memory notes older than {days} days.",
+            fg="green",
+        )
+    except Exception as e:
+        click.secho(f"Failed to prune memory notes: {e}", fg="red", err=True)
+        import sys
+
+        sys.exit(1)

{elastro_client-1.3.44 → elastro_client-1.3.46}/elastro/cli/commands/telemetry.py

@@ -45,6 +45,11 @@ def telemetry_group() -> None:
     help="Comma-separated list of executed tools",
 )
 @click.option("--rollback-count", type=int, default=0, help="Explicit undo rate")
+@click.option("--diff-drift", type=float, default=0.0, help="Diff Drift Ratio")
+@click.option(
+    "--fallback-rate", type=float, default=0.0, help="Deterministic Fallback Rate"
+)
+@click.option("--complexity", type=float, default=0.0, help="Complexity Score")
 @click.pass_obj
 def ingest_telemetry(
     client: ElasticsearchClient,
@@ -68,6 +73,9 @@ def ingest_telemetry(
     llm_model: str,
     tools_invoked: str,
     rollback_count: int,
+    diff_drift: float,
+    fallback_rate: float,
+    complexity: float,
 ) -> None:
     """
     Ingest standardized session telemetry into the deep analytics index.
@@ -103,6 +111,9 @@ def ingest_telemetry(
             [t.strip() for t in tools_invoked.split(",")] if tools_invoked else []
         ),
         "rollback_undo_count": rollback_count,
+        "diff_drift_ratio": diff_drift,
+        "deterministic_fallback_rate": fallback_rate,
+        "complexity_score": complexity,
     }
 
     try:

elastro_client-1.3.46/elastro/cli/commands/tools.py

@@ -0,0 +1,146 @@
+"""
+Tools registry command group for Elastro CLI.
+"""
+
+import rich_click as click
+from datetime import datetime, timezone
+
+from elastro.core.client import ElasticsearchClient
+
+
+@click.group(name="tools")
+def tools_group() -> None:
+    """Manage the Custom Agentic Toolchain registry."""
+    pass
+
+
+@tools_group.command("register")
+@click.argument("tool_name")
+@click.argument("file_path")
+@click.argument("purpose")
+@click.option(
+    "--parameters", default="", help="JSON string or comma-separated list of params"
+)
+@click.pass_obj
+def register_tool(
+    client: ElasticsearchClient,
+    tool_name: str,
+    file_path: str,
+    purpose: str,
+    parameters: str,
+) -> None:
+    """
+    Register a custom pipeline script or CLI into the tools registry.
+    """
+    index_name = "flow_tools"
+    timestamp = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    import os
+    import hashlib
+
+    file_hash = "unknown"
+    if os.path.isfile(file_path):
+        with open(file_path, "rb") as f:
+            file_hash = hashlib.sha256(f.read()).hexdigest()
+    else:
+        click.secho(
+            f"Warning: File '{file_path}' not found at registration time.", fg="yellow"
+        )
+
+    payload = {
+        "timestamp": timestamp,
+        "tool_name": tool_name,
+        "file_path": file_path,
+        "purpose": purpose,
+        "parameters": parameters,
+        "file_hash": file_hash,
+    }
+
+    try:
+        response = client.client.index(index=index_name, id=tool_name, document=payload)
+        click.secho(
+            f">> Tool '{tool_name}' registered successfully.",
+            fg="green",
+        )
+    except Exception as e:
+        click.secho(f"Failed to register tool payload: {e}", fg="red", err=True)
+        import sys
+
+        sys.exit(1)
+
+
+@tools_group.command("search")
+@click.argument("query")
+@click.option("--size", default=10, help="Number of results to return")
+@click.pass_obj
+def search_tools(
+    client: ElasticsearchClient,
+    query: str,
+    size: int,
+) -> None:
+    """
+    Search the flow_tools custom tool registry.
+    """
+    index_name = "flow_tools"
+
+    search_body = {
+        "size": size,
+        "query": {
+            "multi_match": {
+                "query": query,
+                "fields": ["tool_name^3", "purpose^2", "parameters"],
+            }
+        },
+    }
+
+    try:
+        response = client.client.search(index=index_name, body=search_body)
+        hits = response.get("hits", {}).get("hits", [])
+
+        click.secho(f"Found {len(hits)} registered tools:", fg="blue")
+        for hit in hits:
+            if not isinstance(hit, dict):
+                continue
+            source = hit.get("_source", {})
+            tool_name = source.get("tool_name", "Unknown")
+            file_path = source.get("file_path", "unknown")
+            indexed_hash = source.get("file_hash", "unknown")
+
+            click.echo(f"\n[TOOL] {tool_name}")
+            click.echo(f"  Path: {file_path}")
+            click.echo(f"  Purpose: {source.get('purpose', '')}")
+            click.echo(f"  Parameters: {source.get('parameters', '')}")
+
+            import os
+            import hashlib
+
+            if file_path != "unknown" and os.path.isfile(file_path):
+                with open(file_path, "rb") as f:
+                    current_hash = hashlib.sha256(f.read()).hexdigest()
+
+                if indexed_hash == "unknown":
+                    click.secho(
+                        "  Hash Status: [UNTRACKED] No index hash recorded.",
+                        fg="yellow",
+                    )
+                elif current_hash != indexed_hash:
+                    click.secho(
+                        "  Hash Status: [STALE] Local file modified since registration!",
+                        fg="red",
+                        bold=True,
+                    )
+                else:
+                    click.secho(
+                        "  Hash Status: [VERIFIED] Local file matches index exact.",
+                        fg="green",
+                    )
+            else:
+                click.secho(
+                    "  Hash Status: [MISSING] File not found on disk.", fg="red"
+                )
+
+    except Exception as e:
+        click.secho(f"Search failed: {e}", fg="red", err=True)
+        import sys
+
+        sys.exit(1)

{elastro_client-1.3.44 → elastro_client-1.3.46}/elastro/core/rag/ast_parser.py

@@ -56,6 +56,8 @@ class ASTParser:
             return "typescript"
         elif ext == ".vue":
             return "vue"
+        elif ext == ".md":
+            return "markdown"
         return "unsupported"
 
     def parse_file(self, file_path: str, content: str) -> List[Dict[str, Any]]:
@@ -65,6 +67,24 @@ class ASTParser:
         ext = os.path.splitext(file_path)[1]
         lang = self._determine_language(ext)
 
+        if lang == "markdown":
+            import re
+
+            # Extract declarative Node-IDs like `repo:path/to/file.py::0` or `path/to/file.py`
+            node_refs = re.findall(
+                r"`([a-zA-Z0-9_\-\.]+:[a-zA-Z0-9_\-\.\/]+::\d+)`", content
+            )
+            file_refs = re.findall(r"`([a-zA-Z0-9_\-\.\/]+\.[a-zA-Z]{2,4})`", content)
+            return [
+                {
+                    "chunk_type": "knowledge_item",
+                    "name": os.path.basename(file_path),
+                    "content": content,
+                    "functions_defined": list(set(node_refs)),
+                    "functions_called": list(set(file_refs)),
+                }
+            ]
+
         if lang not in self.parsers:
             return [
                 {

{elastro_client-1.3.44 → elastro_client-1.3.46}/elastro/core/rag/ingestor.py

@@ -23,8 +23,17 @@ class GraphRAGManager:
         self.index_name = index_name
         self.ast_parser = ASTParser()
 
-        # We explicitly target the agent's core polyglot languages
-        self.supported_extensions = {".py", ".go", ".vue", ".js", ".ts", ".jsx", ".tsx"}
+        # We explicitly target the agent's core polyglot languages + Markdown for KI Bridging
+        self.supported_extensions = {
+            ".py",
+            ".go",
+            ".vue",
+            ".js",
+            ".ts",
+            ".jsx",
+            ".tsx",
+            ".md",
+        }
 
         # Prevent indexing binary data, large dependency folders, or generated outputs
         self.ignore_dirs = {

{elastro_client-1.3.44 → elastro_client-1.3.46/elastro_client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elastro-client
-Version: 1.3.44
+Version: 1.3.46
 Summary: A comprehensive Python library for Elasticsearch management with both programmatic and CLI interfaces
 Author: Austin Jorgensen
 License-Expression: MIT

{elastro_client-1.3.44 → elastro_client-1.3.46}/elastro_client.egg-info/SOURCES.txt

@@ -36,6 +36,7 @@ elastro/cli/commands/ilm.py
 elastro/cli/commands/index.py
 elastro/cli/commands/index_recipes.py
 elastro/cli/commands/ingest.py
+elastro/cli/commands/memory.py
 elastro/cli/commands/ml.py
 elastro/cli/commands/painless_commands.py
 elastro/cli/commands/rag.py
@@ -45,6 +46,7 @@ elastro/cli/commands/snapshot.py
 elastro/cli/commands/tasks.py
 elastro/cli/commands/telemetry.py
 elastro/cli/commands/template.py
+elastro/cli/commands/tools.py
 elastro/cli/commands/utils.py
 elastro/config/__init__.py
 elastro/config/defaults.py

{elastro_client-1.3.44 → elastro_client-1.3.46}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "elastro-client"
-version = "1.3.44"
+version = "1.3.46"
 description = "A comprehensive Python library for Elasticsearch management with both programmatic and CLI interfaces"
 readme = "README.md"
 requires-python = ">=3.9,<3.14"