Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

README.md

ShadowHunter Scripts

quick_test.sh

Smoke test: health check + NL-to-Cypher. Use after starting the API to confirm backend and Ask the graph work.

# From repo root (API must be running on port 8000)
./scripts/quick_test.sh

Exit 0 = pass. See RUNBOOK §1.1 (Simple testing guide) for the full checklist.

neo4j_schema_phase3.cypher

Neo4j 5.x constraints and indexes for the multi-agent hunter system. Defines:

  • Node labels from all hunter specs (01–10): Supply chain (MaliciousPackage, LegitimatePackage, SuspiciousPackage), AI threat (LeakedAPIKey, JailbreakTechnique, WeaponizedAIModel, AIMalware, LLMServiceAbuse), Insider (InsiderRecruitment, DataExfiltrationOffer, DisgruntledEmployee), Synthetic ID (DeepfakeService, VoiceCloningService, KYCBypassTool), PhysicalSecThreat, ExploitMarketListing, SocialCorrelation, GitHubSecretLeak, APTAttribution, ThreatScore, plus core/IOC types (IOC, WalletAddress, Identity, Indicator, ThreatActor, DAO, Account, File, DivergenceAlert, SuspectedFaP).
  • Relationship types documented in the script header (e.g. TYPOSQUATS, DISTRIBUTES, SELLS, SAME_OPERATOR) with range indexes on key relationship properties (e.g. TYPOSQUATS.distance, TYPOSQUATS.confidence, SAME_OPERATOR.confidence) for query performance.
  • Idempotent use of IF NOT EXISTS for migrations and re-runs.
  • Design alignment with NEW ADDITIONS/Research/Deep Dive into Cypher Script.md: specific relationship types for index-free adjacency, explicit constraint/index names, composite index property order for common filters, optional Enterprise-only constraints in comments.

How to run

# From repo root (Neo4j 5.x, Bolt)
cypher-shell -u neo4j -p <password> < scripts/neo4j_schema_phase3.cypher

Or paste sections into Neo4j Browser and execute.

References

  • Specs: NEW ADDITIONS/01_SupplyChainHunter_Spec.md, 02_AIThreatHunter_Spec.md, 03-10_Remaining_Hunters_Spec.md
  • Research: NEW ADDITIONS/Research/Deep Dive into Cypher Script.md
  • Ops: RUNBOOK §8 (hunters and schema usage)