agentic-threat-hunting-framework 0.2.2__py3-none-any.whl → 0.2.3__py3-none-any.whl

{agentic_threat_hunting_framework-0.2.2.dist-info → agentic_threat_hunting_framework-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-threat-hunting-framework
-Version: 0.2.2
+Version: 0.2.3
 Summary: Agentic Threat Hunting Framework - Memory and AI for threat hunters
 Author-email: Sydney Marrone <athf@nebulock.io>
 Maintainer-email: Sydney Marrone <athf@nebulock.io>

{agentic_threat_hunting_framework-0.2.2.dist-info → agentic_threat_hunting_framework-0.2.3.dist-info}/RECORD

@@ -1,9 +1,9 @@
-agentic_threat_hunting_framework-0.2.2.dist-info/licenses/LICENSE,sha256=_KObErRfiKoolznt-DF0nJnr3U9Rdh7Z4Ba7G5qqckk,1071
+agentic_threat_hunting_framework-0.2.3.dist-info/licenses/LICENSE,sha256=_KObErRfiKoolznt-DF0nJnr3U9Rdh7Z4Ba7G5qqckk,1071
 athf/__init__.py,sha256=OrjZe8P97_BTEkscapnwSsqKSjwXNP9d8-HtGr19Ni0,241
 athf/__version__.py,sha256=p9cAuZ-dTEMpo-qoeYkFo2166r8LvKpa5qHBZihGq3w,59
 athf/cli.py,sha256=XLNRXEs9kHPH6utJ7_SnzLFcldbGAnACPMTe0xMOkhQ,4492
 athf/commands/__init__.py,sha256=uDyr0bz-agpGO8fraXQl24wuQCxqbeCevZsJ2bDK29s,25
-athf/commands/context.py,sha256=XpMtTf9Pq6NxMhawp6f1NYnTKYt1IuGx9CNDIY8K8Do,11956
+athf/commands/context.py,sha256=WvOf0OuttAsEk_h4QDtdfqYI4CulDg2UCtq_5r5iJAA,12686
 athf/commands/env.py,sha256=AisRllJXbyCjK_2ii21qBBmCz9raxhBUemwM7BxqIYg,11859
 athf/commands/hunt.py,sha256=2KORNWAqEvLY-Wc1q-a894g8kOpcqw_iJfnenKJeTDI,23019
 athf/commands/init.py,sha256=L_29fvZF8SZ1BKh2D6NyDuacCC5JXOTezIxdBnnK88E,10941
@@ -11,13 +11,13 @@ athf/commands/investigate.py,sha256=mK_id5vjfN_ukqB_-fyia0FNa0pBmtn0Xv6CKHQI1Qo,
 athf/commands/similar.py,sha256=ROoMs4NP1otCaXwM1XzpLWxmANknoeASlBT7zuMDqas,11793
 athf/core/__init__.py,sha256=yG7C8ljx3UW4QZoYvDjUxsWHlbS8M-GLGB7Je7rRfqo,31
 athf/core/attack_matrix.py,sha256=QZKKmxckQ6-U7lqVdGUJoj2jEAhP3Juvr3sqaNx2oTw,3238
-athf/core/hunt_manager.py,sha256=6DC3wmreJ5IBiC7vi9xB9DP_WDXOetmGceFPTqjYVRU,11366
+athf/core/hunt_manager.py,sha256=PFsg8Ecg94NCpuFZpApo82lyORkgK5IfOIih-7-XsmM,11580
 athf/core/hunt_parser.py,sha256=FUj0yyBIcZnaS9aItMImeBDhegQwpkewIwUMNXW_ZWU,5122
 athf/core/investigation_parser.py,sha256=wbfjnq4gFgIc0a4bHIAnidVNPhbHDpIXWY1SGLk0Xls,6804
 athf/core/template_engine.py,sha256=vNTVhlxIXZpxU7VmQyrqCSt6ORS0IVjAV54TOmUDMTE,5636
 athf/utils/__init__.py,sha256=aEAPI1xnAsowOtc036cCb9ZOek5nrrfevu8PElhbNgk,30
-agentic_threat_hunting_framework-0.2.2.dist-info/METADATA,sha256=zFr9-YmLEz0jqC0rmqEUmOmMhl-yMUr20U9IrqUrfcI,15472
-agentic_threat_hunting_framework-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-agentic_threat_hunting_framework-0.2.2.dist-info/entry_points.txt,sha256=GopR2iTiBs-yNMWiUZ2DaFIFglXxWJx1XPjTa3ePtfE,39
-agentic_threat_hunting_framework-0.2.2.dist-info/top_level.txt,sha256=Cxxg6SMLfawDJWBITsciRzq27XV8fiaAor23o9Byoes,5
-agentic_threat_hunting_framework-0.2.2.dist-info/RECORD,,
+agentic_threat_hunting_framework-0.2.3.dist-info/METADATA,sha256=I3x8s2Rff1A7BjYz-lfy_M6I_qw0-nDBC2Ypc0DcxTA,15472
+agentic_threat_hunting_framework-0.2.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+agentic_threat_hunting_framework-0.2.3.dist-info/entry_points.txt,sha256=GopR2iTiBs-yNMWiUZ2DaFIFglXxWJx1XPjTa3ePtfE,39
+agentic_threat_hunting_framework-0.2.3.dist-info/top_level.txt,sha256=Cxxg6SMLfawDJWBITsciRzq27XV8fiaAor23o9Byoes,5
+agentic_threat_hunting_framework-0.2.3.dist-info/RECORD,,

athf/commands/context.py

@@ -22,6 +22,9 @@ Examples:
   # Export context for macOS platform hunts
   athf context --platform macos
 
+  # Combine filters: persistence hunts on Linux
+  athf context --tactic persistence --platform linux
+
   # Export full repository context (large output)
   athf context --full
 
@@ -86,18 +89,20 @@ def context(
     • With context: 1 command, ~1,000 tokens
     • Savings: ~2,000 tokens per hunt (~$0.03 per hunt)
     """
-    # Validate mutually exclusive options
-    exclusive_options = sum([bool(hunt), bool(tactic), bool(platform), full])
-    if exclusive_options == 0:
-        console.print("[red]Error: Must specify one of: --hunt, --tactic, --platform, or --full[/red]")
+    # Validate that at least one filter is provided
+    has_filter = any([hunt, tactic, platform, full])
+    if not has_filter:
+        console.print("[red]Error: Must specify at least one of: --hunt, --tactic, --platform, or --full[/red]")
         console.print("\n[dim]Examples:[/dim]")
         console.print("  athf context --hunt H-0013")
         console.print("  athf context --tactic credential-access")
         console.print("  athf context --platform macos")
+        console.print("  athf context --tactic persistence --platform linux")
         raise click.Abort()
 
-    if exclusive_options > 1:
-        console.print("[red]Error: Only one filter option allowed at a time[/red]")
+    # --full flag is mutually exclusive with other filters
+    if full and (hunt or tactic or platform):
+        console.print("[red]Error: --full cannot be combined with other filters[/red]")
         raise click.Abort()
 
     # Build context bundle
@@ -158,17 +163,26 @@ def _build_context(
     if index_path.exists():
         context["hunt_index"] = _read_and_optimize(index_path)
 
-    # Load hunts based on filter
-    if hunt:
-        hunt_files = [Path(f"hunts/{hunt}.md")]
-    elif tactic:
-        hunt_files = _find_hunts_by_tactic(tactic)
-    elif platform:
-        hunt_files = _find_hunts_by_platform(platform)
-    elif full:
+    # Load hunts based on filters (can be combined)
+    if full:
+        # Full export: include all hunts
         hunt_files = list(Path("hunts").glob("H-*.md"))
+    elif hunt:
+        # Specific hunt: only load that one
+        hunt_files = [Path(f"hunts/{hunt}.md")]
     else:
-        hunt_files = []
+        # Combine tactic and platform filters
+        if tactic and platform:
+            # Both filters: find hunts matching both criteria
+            tactic_hunts = set(_find_hunts_by_tactic(tactic))
+            platform_hunts = set(_find_hunts_by_platform(platform))
+            hunt_files = list(tactic_hunts & platform_hunts)  # Intersection
+        elif tactic:
+            hunt_files = _find_hunts_by_tactic(tactic)
+        elif platform:
+            hunt_files = _find_hunts_by_platform(platform)
+        else:
+            hunt_files = []
 
     # Load hunt content
     for hunt_file in hunt_files:

athf/core/hunt_manager.py

@@ -154,7 +154,14 @@ class HuntManager:
         results = []
         query_lower = query.lower()
 
+        # Exclude documentation files
+        exclude_files = {"README.md", "FORMAT_GUIDELINES.md"}
+
         for hunt_file in self.hunts_dir.glob("*.md"):
+            # Skip documentation files
+            if hunt_file.name in exclude_files:
+                continue
+
             try:
                 with open(hunt_file, "r", encoding="utf-8") as f:
                     content = f.read()