feat: improved ae_journal_search + AE integration docs

Search improvements:
- Switched from LIKE on default_qry_str to query_string path (fulltext
  MATCH/AGAINST IN BOOLEAN MODE — uses the index, supports +/- boolean ops)
- Added tag filter (icontains on tags field)
- Added date_from / date_to filters (created_on gte/lte)
- Added type_code / topic_code exact-match filters
- Added sort_by / sort_order control (updated, created, name, priority)
- Added status / priority filters
- Added page parameter for pagination
- Richer output: updated date, tags, pagination hint
- Updated Gemini tool declaration with all new params

Docs:
- documentation/ARCH__AE_INTEGRATION.md — journal_entry full schema,
  search operator reference, current tool inventory, planned phases
  (broader AE integration: tasks, people, calendar, knowledge import)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

cortex/tools/__init__.py

@@ -94,8 +94,9 @@ _ae_journal_list_declaration = types.FunctionDeclaration(
 _ae_journal_search_declaration = types.FunctionDeclaration(
     name="ae_journal_search",
     description=(
-        "Search the Aether Journals knowledge base by keyword. "
-        "Use this to look up notes, documentation, meeting summaries, or any saved knowledge. "
+        "Search Aether Journal entries. All parameters are optional — combine freely. "
+        "Use 'query' for fulltext keyword search (supports boolean: +required -excluded \"phrase\"). "
+        "Use 'tags' to filter by tag substring. Use 'date_from'/'date_to' for date ranges (YYYY-MM-DD). "
         "Always search before creating a new entry to avoid duplicates."
     ),
     parameters=types.Schema(
@@ -103,21 +104,58 @@ _ae_journal_search_declaration = types.FunctionDeclaration(
         properties={
             "query": types.Schema(
                 type=types.Type.STRING,
-                description="Keyword or phrase to search for",
+                description="Fulltext keyword search. Supports boolean mode: +required -excluded \"exact phrase\".",
             ),
             "journal_id": types.Schema(
                 type=types.Type.STRING,
-                description=(
-                    "Optional: scope search to a specific journal by its id_random. "
-                    "Omit to search all journals."
-                ),
+                description="Scope results to a specific journal by its id_random. Omit to search all journals.",
+            ),
+            "tags": types.Schema(
+                type=types.Type.STRING,
+                description="Filter by tag substring (e.g. 'networking' matches entries tagged 'networking' or 'home-networking').",
+            ),
+            "type_code": types.Schema(
+                type=types.Type.STRING,
+                description="Filter by exact type_code (e.g. 'note', 'meeting', 'log').",
+            ),
+            "topic_code": types.Schema(
+                type=types.Type.STRING,
+                description="Filter by exact topic_code.",
+            ),
+            "date_from": types.Schema(
+                type=types.Type.STRING,
+                description="Return entries created on or after this date (YYYY-MM-DD).",
+            ),
+            "date_to": types.Schema(
+                type=types.Type.STRING,
+                description="Return entries created on or before this date (YYYY-MM-DD).",
+            ),
+            "sort_by": types.Schema(
+                type=types.Type.STRING,
+                description="Sort field: 'updated' (default), 'created', 'name', or 'priority'.",
+            ),
+            "sort_order": types.Schema(
+                type=types.Type.STRING,
+                description="Sort direction: 'desc' (default, newest first) or 'asc'.",
+            ),
+            "status": types.Schema(
+                type=types.Type.INTEGER,
+                description="Filter by exact status code.",
+            ),
+            "priority": types.Schema(
+                type=types.Type.INTEGER,
+                description="Filter by exact priority (1=low, 5=high).",
             ),
             "max_results": types.Schema(
                 type=types.Type.INTEGER,
-                description="Maximum number of entries to return (default 10)",
+                description="Number of results per page (default 10).",
+            ),
+            "page": types.Schema(
+                type=types.Type.INTEGER,
+                description="Page number for pagination (default 1).",
             ),
         },
-        required=["query"],
+        required=[],
     ),
 )